docs: inject dartdoc comments into generated public API

.github/workflows/ci.yml

@@ -42,6 +42,9 @@ jobs:
       - name: Ensure generated bindings exist
         run: test -f lib/bdk.dart
 
+      - name: Verify dartdoc injection
+        run: dart scripts/inject_dartdocs.dart --check
+
       - name: Pub get
         run: dart pub get
 

CONTRIBUTING.md

@@ -30,6 +30,10 @@ bindings and the native library:
 bash ./scripts/generate_bindings.sh
 ```
 
+Dart API docs are injected after generation by `scripts/inject_dartdocs.dart`.
+Edit `scripts/dartdoc/entries.yaml` to change documentation, not `lib/bdk.dart`
+directly. Re-run `bash ./scripts/generate_bindings.sh` after changing doc content.
+
 ## Checks
 
 These shortcuts require `just`; `just ci` runs the full local format, analysis,

justfile

@@ -23,6 +23,11 @@ analyze:
 docs:
   dart doc
 
+[group("Dart")]
+[doc("Verify dartdoc comments are present in generated bindings.")]
+verify-docs:
+  dart scripts/inject_dartdocs.dart --check
+
 [group("Dart")]
 [doc("Run all tests, optionally filtering by expression.")]
 test *ARGS: