@ai-react-markdown/engine 2.12.0 → 2.13.0

package/dist/index.d.cts

@@ -156,6 +156,53 @@ declare function buildTransform(ctx: TransformContext): BuildVisitor<Root$1>;
  */
 declare const defaultUrlTransform: UrlTransform;
 
+/** Checkpoint representation and initialization. Only confirmed lines mutate this state. */
+
+interface FreezeBoundaryOptions {
+    /** Whether remark-definition-list is in the active plugin chain (the
+     *  `enginePlugins` selection includes `definitionList`). Enables blockers 3b/4. */
+    defListEnabled: boolean;
+    /**
+     * Whether `$$` flow math is in the grammar (remark-math). Default `true`
+     * (the engine's own profile). The def-label scanner runs a PINNED
+     * remark-parse+gfm subset where `$$` is ordinary paragraph text — under
+     * that grammar the math branch is a MASKING hole: `inMath` returns early
+     * without comment/fence scanning, so `$$\n<!--\n$$` reads as a closed
+     * math block here while the subset grammar sees an OPEN type-2 HTML
+     * comment running to `-->`/EOF (a candidate after it would let a
+     * standalone tail parse invent ghost defs). With `false`, `$$` lines take
+     * the ordinary text path and comments/fences inside are scanned.
+     */
+    mathFlow?: boolean;
+    /**
+     * Whether blocker 5 (reference taint) applies. Default `true`: the
+     * engine must reject candidates past an unresolved `[label]` because a
+     * later definition retargets the reference's PARSE. The def-label
+     * scanner only extracts definition IDENTITIES — a pure block-level fact
+     * unaffected by how inline references resolve — and under taint a
+     * streaming citation footer (defs with no settling blank line yet)
+     * collapses the boundary to the body's first reference, zeroing the
+     * caching this profile exists for. `false` skips ref tracking entirely.
+     */
+    referenceTaint?: boolean;
+}
+interface FreezeScanResult {
+    /** Largest freeze-safe boundary, or 0 when nothing can be frozen. */
+    boundary: number;
+    /** Opaque resume state — pass back on the next APPEND-ONLY call to skip
+     *  re-lexing the confirmed prefix. Single-consumer; see module docs. */
+    checkpoint: FreezeScanCheckpoint;
+}
+/** Opaque resume token. Produced by one `computeFreezeBoundary` call and
+ *  passed back on the next APPEND-ONLY call; the only supported operations
+ *  are storing it and passing it back. The field set is an implementation
+ *  detail of the scanner and changes between minor versions — the brand key
+ *  (a structural string literal, safe across dual d.ts entries) is all that
+ *  ships in the public type. */
+interface FreezeScanCheckpoint {
+    readonly '~freezeScanCheckpoint'?: never;
+}
+
 /**
  * Freeze-boundary detector for incremental (prefix-freeze) parsing.
  *
@@ -275,88 +322,12 @@ declare const defaultUrlTransform: UrlTransform;
  * via injection replay (v2).
  */
 
-interface FreezeBoundaryOptions {
-    /** Whether remark-definition-list is in the active plugin chain (the
-     *  `enginePlugins` selection includes `definitionList`). Enables blockers 3b/4. */
-    defListEnabled: boolean;
-    /**
-     * Whether `$$` flow math is in the grammar (remark-math). Default `true`
-     * (the engine's own profile). The def-label scanner runs a PINNED
-     * remark-parse+gfm subset where `$$` is ordinary paragraph text — under
-     * that grammar the math branch is a MASKING hole: `inMath` returns early
-     * without comment/fence scanning, so `$$\n<!--\n$$` reads as a closed
-     * math block here while the subset grammar sees an OPEN type-2 HTML
-     * comment running to `-->`/EOF (a candidate after it would let a
-     * standalone tail parse invent ghost defs). With `false`, `$$` lines take
-     * the ordinary text path and comments/fences inside are scanned.
-     */
-    mathFlow?: boolean;
-    /**
-     * Whether blocker 5 (reference taint) applies. Default `true`: the
-     * engine must reject candidates past an unresolved `[label]` because a
-     * later definition retargets the reference's PARSE. The def-label
-     * scanner only extracts definition IDENTITIES — a pure block-level fact
-     * unaffected by how inline references resolve — and under taint a
-     * streaming citation footer (defs with no settling blank line yet)
-     * collapses the boundary to the body's first reference, zeroing the
-     * caching this profile exists for. `false` skips ref tracking entirely.
-     */
-    referenceTaint?: boolean;
-}
-interface FreezeScanResult {
-    /** Largest freeze-safe boundary, or 0 when nothing can be frozen. */
-    boundary: number;
-    /** Opaque resume state — pass back on the next APPEND-ONLY call to skip
-     *  re-lexing the confirmed prefix. Single-consumer; see module docs. */
-    checkpoint: FreezeScanCheckpoint;
-}
-/** Opaque resume token. Produced by one `computeFreezeBoundary` call and
- *  passed back on the next APPEND-ONLY call; the only supported operations
- *  are storing it and passing it back. The field set is an implementation
- *  detail of the scanner and changes between minor versions — the brand key
- *  (a structural string literal, safe across dual d.ts entries) is all that
- *  ships in the public type. */
-interface FreezeScanCheckpoint {
-    readonly '~freezeScanCheckpoint'?: never;
-}
 /**
  * @soak-entry freeze-scanner-resume
  * @soak-entry freeze-direction
  */
 declare function computeFreezeBoundary(text: string, options: FreezeBoundaryOptions, resume?: FreezeScanCheckpoint | null): FreezeScanResult;
 
-/**
- * Pure splice helpers for incremental (prefix-freeze) parsing: cut the
- * frozen prefix out of the previous frame's trees, re-base a tail-only
- * parse into document coordinates, and join the two into fresh roots.
- *
- * Invariant these helpers exist to uphold (enforced by the
- * splice-equivalence arbiter test, NOT asserted at runtime): the spliced
- * `{mdast, hast}` is deep-equal — positions included — to a full pipeline
- * run over the whole content. Defined on UNRENDERED trees; after a render,
- * `renderHastSubtree` mutates hast in place (convergent `data.originalUrls`
- * stash, raw→text rewrite — see Markdown.tsx), so no in-component
- * deep-equal check is possible or attempted.
- *
- * Prefix link/image definitions are PREPENDED to the tail source (not
- * appended: a streaming tail routinely ends inside an unclosed fence or
- * `$$` block that would swallow appended lines, and appended defs would
- * invert CommonMark first-def-wins against a same-label tail def).
- * Definitions emit zero hast (mdast-util-to-hast has no `definition`
- * handler), so their only trace is `definition` mdast nodes inside the
- * injected region, which are dropped before the join. Definition text is
- * sliced verbatim from the previous content via node positions — exact
- * source roundtrip preserves escapes and multi-line titles.
- *
- * Sanitize-STRIPPED prefix nodes (HTML comments, `<?…?>` bogus comments,
- * `<script>`) are modeled explicitly: their wrap separators survive as
- * orphans, and `alignPrefixCut` re-derives the mdast↔hast pairing from
- * separator-run lengths (B0-probe-verified: one orphan '\n' per stripped
- * child's gap slot; separators MERGED into raw trailing literals count via
- * their trailing newlines — `literalCredit`). Layouts outside the model
- * return null → full-parse fallback for the frame.
- */
-
 /** Prefix footnote/definition events in DOCUMENT ORDER. Order is the whole
  *  point: mdast-util-to-hast's footnoteOrder/footnoteCounts are built from
  *  encounter order, and the replay must reproduce it exactly. */
@@ -726,6 +697,12 @@ interface Registry {
      *  consumers should observe via `subscribe`, not by writing. */
     readonly version: number;
     subscribe(cb: () => void): () => void;
+    /** Observe one normalized label's indexed selectors. Links/images share
+     * the 'link' channel (canonical owner, URL, title). Footnotes observe
+     * canonical owner, numbering, counts and per-chunk occurrence ranges.
+     * Raw chunk payload/body changes still require the global subscription.
+     * Notifications are microtask-coalesced and may skip net-zero changes. */
+    subscribeLabel(kind: 'link' | 'footnote', label: string, cb: () => void): () => void;
     canonicalFootnoteFor(label: string): symbol | null;
     canonicalLinkFor(label: string): symbol | null;
     globalNumber(label: string): number | null;

package/dist/index.d.ts

@@ -156,6 +156,53 @@ declare function buildTransform(ctx: TransformContext): BuildVisitor<Root$1>;
  */
 declare const defaultUrlTransform: UrlTransform;
 
+/** Checkpoint representation and initialization. Only confirmed lines mutate this state. */
+
+interface FreezeBoundaryOptions {
+    /** Whether remark-definition-list is in the active plugin chain (the
+     *  `enginePlugins` selection includes `definitionList`). Enables blockers 3b/4. */
+    defListEnabled: boolean;
+    /**
+     * Whether `$$` flow math is in the grammar (remark-math). Default `true`
+     * (the engine's own profile). The def-label scanner runs a PINNED
+     * remark-parse+gfm subset where `$$` is ordinary paragraph text — under
+     * that grammar the math branch is a MASKING hole: `inMath` returns early
+     * without comment/fence scanning, so `$$\n<!--\n$$` reads as a closed
+     * math block here while the subset grammar sees an OPEN type-2 HTML
+     * comment running to `-->`/EOF (a candidate after it would let a
+     * standalone tail parse invent ghost defs). With `false`, `$$` lines take
+     * the ordinary text path and comments/fences inside are scanned.
+     */
+    mathFlow?: boolean;
+    /**
+     * Whether blocker 5 (reference taint) applies. Default `true`: the
+     * engine must reject candidates past an unresolved `[label]` because a
+     * later definition retargets the reference's PARSE. The def-label
+     * scanner only extracts definition IDENTITIES — a pure block-level fact
+     * unaffected by how inline references resolve — and under taint a
+     * streaming citation footer (defs with no settling blank line yet)
+     * collapses the boundary to the body's first reference, zeroing the
+     * caching this profile exists for. `false` skips ref tracking entirely.
+     */
+    referenceTaint?: boolean;
+}
+interface FreezeScanResult {
+    /** Largest freeze-safe boundary, or 0 when nothing can be frozen. */
+    boundary: number;
+    /** Opaque resume state — pass back on the next APPEND-ONLY call to skip
+     *  re-lexing the confirmed prefix. Single-consumer; see module docs. */
+    checkpoint: FreezeScanCheckpoint;
+}
+/** Opaque resume token. Produced by one `computeFreezeBoundary` call and
+ *  passed back on the next APPEND-ONLY call; the only supported operations
+ *  are storing it and passing it back. The field set is an implementation
+ *  detail of the scanner and changes between minor versions — the brand key
+ *  (a structural string literal, safe across dual d.ts entries) is all that
+ *  ships in the public type. */
+interface FreezeScanCheckpoint {
+    readonly '~freezeScanCheckpoint'?: never;
+}
+
 /**
  * Freeze-boundary detector for incremental (prefix-freeze) parsing.
  *
@@ -275,88 +322,12 @@ declare const defaultUrlTransform: UrlTransform;
  * via injection replay (v2).
  */
 
-interface FreezeBoundaryOptions {
-    /** Whether remark-definition-list is in the active plugin chain (the
-     *  `enginePlugins` selection includes `definitionList`). Enables blockers 3b/4. */
-    defListEnabled: boolean;
-    /**
-     * Whether `$$` flow math is in the grammar (remark-math). Default `true`
-     * (the engine's own profile). The def-label scanner runs a PINNED
-     * remark-parse+gfm subset where `$$` is ordinary paragraph text — under
-     * that grammar the math branch is a MASKING hole: `inMath` returns early
-     * without comment/fence scanning, so `$$\n<!--\n$$` reads as a closed
-     * math block here while the subset grammar sees an OPEN type-2 HTML
-     * comment running to `-->`/EOF (a candidate after it would let a
-     * standalone tail parse invent ghost defs). With `false`, `$$` lines take
-     * the ordinary text path and comments/fences inside are scanned.
-     */
-    mathFlow?: boolean;
-    /**
-     * Whether blocker 5 (reference taint) applies. Default `true`: the
-     * engine must reject candidates past an unresolved `[label]` because a
-     * later definition retargets the reference's PARSE. The def-label
-     * scanner only extracts definition IDENTITIES — a pure block-level fact
-     * unaffected by how inline references resolve — and under taint a
-     * streaming citation footer (defs with no settling blank line yet)
-     * collapses the boundary to the body's first reference, zeroing the
-     * caching this profile exists for. `false` skips ref tracking entirely.
-     */
-    referenceTaint?: boolean;
-}
-interface FreezeScanResult {
-    /** Largest freeze-safe boundary, or 0 when nothing can be frozen. */
-    boundary: number;
-    /** Opaque resume state — pass back on the next APPEND-ONLY call to skip
-     *  re-lexing the confirmed prefix. Single-consumer; see module docs. */
-    checkpoint: FreezeScanCheckpoint;
-}
-/** Opaque resume token. Produced by one `computeFreezeBoundary` call and
- *  passed back on the next APPEND-ONLY call; the only supported operations
- *  are storing it and passing it back. The field set is an implementation
- *  detail of the scanner and changes between minor versions — the brand key
- *  (a structural string literal, safe across dual d.ts entries) is all that
- *  ships in the public type. */
-interface FreezeScanCheckpoint {
-    readonly '~freezeScanCheckpoint'?: never;
-}
 /**
  * @soak-entry freeze-scanner-resume
  * @soak-entry freeze-direction
  */
 declare function computeFreezeBoundary(text: string, options: FreezeBoundaryOptions, resume?: FreezeScanCheckpoint | null): FreezeScanResult;
 
-/**
- * Pure splice helpers for incremental (prefix-freeze) parsing: cut the
- * frozen prefix out of the previous frame's trees, re-base a tail-only
- * parse into document coordinates, and join the two into fresh roots.
- *
- * Invariant these helpers exist to uphold (enforced by the
- * splice-equivalence arbiter test, NOT asserted at runtime): the spliced
- * `{mdast, hast}` is deep-equal — positions included — to a full pipeline
- * run over the whole content. Defined on UNRENDERED trees; after a render,
- * `renderHastSubtree` mutates hast in place (convergent `data.originalUrls`
- * stash, raw→text rewrite — see Markdown.tsx), so no in-component
- * deep-equal check is possible or attempted.
- *
- * Prefix link/image definitions are PREPENDED to the tail source (not
- * appended: a streaming tail routinely ends inside an unclosed fence or
- * `$$` block that would swallow appended lines, and appended defs would
- * invert CommonMark first-def-wins against a same-label tail def).
- * Definitions emit zero hast (mdast-util-to-hast has no `definition`
- * handler), so their only trace is `definition` mdast nodes inside the
- * injected region, which are dropped before the join. Definition text is
- * sliced verbatim from the previous content via node positions — exact
- * source roundtrip preserves escapes and multi-line titles.
- *
- * Sanitize-STRIPPED prefix nodes (HTML comments, `<?…?>` bogus comments,
- * `<script>`) are modeled explicitly: their wrap separators survive as
- * orphans, and `alignPrefixCut` re-derives the mdast↔hast pairing from
- * separator-run lengths (B0-probe-verified: one orphan '\n' per stripped
- * child's gap slot; separators MERGED into raw trailing literals count via
- * their trailing newlines — `literalCredit`). Layouts outside the model
- * return null → full-parse fallback for the frame.
- */
-
 /** Prefix footnote/definition events in DOCUMENT ORDER. Order is the whole
  *  point: mdast-util-to-hast's footnoteOrder/footnoteCounts are built from
  *  encounter order, and the replay must reproduce it exactly. */
@@ -726,6 +697,12 @@ interface Registry {
      *  consumers should observe via `subscribe`, not by writing. */
     readonly version: number;
     subscribe(cb: () => void): () => void;
+    /** Observe one normalized label's indexed selectors. Links/images share
+     * the 'link' channel (canonical owner, URL, title). Footnotes observe
+     * canonical owner, numbering, counts and per-chunk occurrence ranges.
+     * Raw chunk payload/body changes still require the global subscription.
+     * Notifications are microtask-coalesced and may skip net-zero changes. */
+    subscribeLabel(kind: 'link' | 'footnote', label: string, cb: () => void): () => void;
     canonicalFootnoteFor(label: string): symbol | null;
     canonicalLinkFor(label: string): symbol | null;
     globalNumber(label: string): number | null;