Improve API dumping script

* Ensure it runs from the intended directory.
* Clean old API files.
* Invoke implementation-agnostic post-processing script after dumping.

Author: ctrueden

bin/api.sh

@@ -1,4 +1,19 @@
 #!/bin/sh
+
+cd "$(dirname "$0")/.."
+
+# Check for required cross-implementation script.
+postprocessScript="../appose/bin/postprocess-api.py"
+if [ ! -f "$postprocessScript" ]; then
+  echo "Error: $postprocessScript not found" >&2
+  echo "Please ensure appose repository is cloned as a sibling directory." >&2
+  exit 1
+fi
+
+# Clean old API files.
+rm -rf api
+
+# Generate pyi API stubs.
 uv run stubgen --include-private -p appose -o api/
 uv run stubgen --include-private -o api tests/*.py tests/*/*.py
 
@@ -13,5 +28,9 @@ do
     "$pyi" > "${pyi%.pyi}.api"
   rm "$pyi"
 done
+
 # Remove empty files.
 find api -size 0 -exec rm "{}" \;
+
+# Post-process API: normalize | None to ?, expand optional parameters.
+python3 "$postprocessScript" api