@ai-markdown/core 3.0.0-beta.1 → 3.0.0-beta.2

package/dist/index.d.cts

@@ -1,6 +1,4 @@
-import * as hast from 'hast';
 import { Element, RootContent, Root as Root$1, Nodes } from 'hast';
-import * as mdast from 'mdast';
 import { Root } from 'mdast';
 import { Registry, ChunkData, PipelineOptions, AdvanceOptions } from '@ai-markdown/engine';
 export { isFootnoteSection } from '@ai-markdown/engine';
@@ -228,6 +226,7 @@ declare function buildBlocks(mdast: Root, hast: Root$1, source: string, options?
  */
 declare function computeBlockFingerprint(taintLabels: NonNullable<BlockInfo['taintLabels']>, registry: Registry, thisChunkSym: symbol, clobberPrefix: string): string;
 
+type BlockPlanner = (mdast: Root, hast: Root$1, source: string, options?: BuildBlocksOptions) => BuildBlocksResult;
 /** Reuse the engine's retained prefix plans, including reference blocks.
  * Reference prefixes require full-document context when planning the tail.
  * Raw HTML and definition regions retain complete planning: their ownership
@@ -235,7 +234,7 @@ declare function computeBlockFingerprint(taintLabels: NonNullable<BlockInfo['tai
  * guesses, establish which trees the incremental engine actually retained.
  * Top-level traversal remains O(blocks); reference context still visits the
  * full mdast when needed, while per-block HAST planning is tail-only. */
-declare function createBlockPlanner(): (mdast: Root, hast: Root$1, source: string, options?: BuildBlocksOptions) => BuildBlocksResult;
+declare function createBlockPlanner(): BlockPlanner;
 
 /** Minimal write capability; registration and cleanup remain with the adapter. */
 interface ContributionRegistry {
@@ -261,14 +260,15 @@ interface ContributionOptions {
      * validate definition bodies after a plugin or schema change. */
     chain: readonly unknown[];
 }
+interface ContributionSession {
+    commit(options: ContributionOptions): void;
+}
 /** Create one contribution publisher per mounted chunk.
  * Call commit only in the host's commit/effect phase, after registration.
  * Constructing a session does not register or publish anything. A discarded
  * render must never call commit. The host owns registration and cleanup.
  */
-declare function createContributionSession(): {
-    commit({ pipeline, ownLabels, registry, targetPhantoms, sym, clobberPrefix, chain }: ContributionOptions): void;
-};
+declare function createContributionSession(): ContributionSession;
 
 /**
  * Turn-taking coordinator for smooth-streaming chunks that share a
@@ -426,7 +426,7 @@ declare function buildAggregateTree(registry: Registry, clobberPrefix: string, p
  * Copies exactly what the render-time mutators touch — every node object,
  * its `children` array (the allow/disallow filters splice it), and its
  * `properties` object (`urlTransform` overwrites `href`/`src`) — while
- * SHARING `position`, `data`, string values, and individual property values
+ * SHARING `position`, arbitrary nested plugin data, string values, and individual property values
  * by reference. This is both cheaper than a JSON round-trip (no string
  * intermediate; `position` objects, typically over half of a serialized
  * hast, are never materialized) and exact for any tree the pipeline
@@ -438,6 +438,22 @@ declare function buildAggregateTree(registry: Registry, clobberPrefix: string, p
 /** See module docs. Safe for any hast node union member. */
 declare function cloneHastForRender<T extends Nodes>(node: T): T;
 
+/** Per-consumer parse state and full/incremental fallback policy.
+ * The host decides whether a next frame is expected (false for SSR), owns
+ * this session, and resets it when render policy invalidates retained trees.
+ * Parsing does not register chunks or publish document contributions.
+ */
+
+interface PipelineTrees {
+    mdast: Root;
+    hast: Root$1;
+}
+interface PipelineSession {
+    /** Drop retained incremental state. Does not dispose host subscriptions. */
+    reset(): void;
+    /** Read-only borrowed trees: clone before destructive rendering. */
+    parse(options: PipelineFrameOptions): PipelineTrees;
+}
 type RemarkRehypeOptions = NonNullable<PipelineOptions['remarkRehypeOptions']>;
 interface PipelineFrameOptions {
     content: string;
@@ -457,13 +473,7 @@ interface PipelineFrameOptions {
     defListEnabled: boolean;
     measure?: AdvanceOptions['measure'];
 }
-declare function createPipelineSession(): {
-    reset(): void;
-    parse({ content, targetPhantoms, remarkPlugins, rehypePlugins, remarkRehypeOptions, handlers, preserveForBodyHarvest, documentId, provenance, incrementalParse, defListEnabled, measure: measureHere, }: PipelineFrameOptions): {
-        mdast: mdast.Root;
-        hast: hast.Root;
-    };
-};
+declare function createPipelineSession(): PipelineSession;
 
 interface DefinitionLabels {
     footnoteLabels: ReadonlySet<string>;
@@ -494,4 +504,4 @@ type ContributionPolicyInputs = Pick<PipelineFrameOptions, 'remarkPlugins' | 're
  */
 declare function buildContributionChain(inputs: ContributionPolicyInputs): readonly unknown[];
 
-export { type BlockInfo, type BuildBlocksOptions, type BuildBlocksResult, type ContributionOptions, type ContributionPolicyInputs, type ContributionRegistry, type CoordinationPolicy, type DefinitionLabels, type GateWarnVerdict, type PhantomTargets, type PipelineFrameOptions, type RenderItem, type SmoothCoordinator, type TailSignal, buildAggregateTree, buildBlocks, buildContributionChain, cloneHastForRender, computeBlockFingerprint, computeHtmlBlockDigest, computeHtmlBlockDigestWithExtent, createBlockPlanner, createContributionSession, createPipelineSession, createSmoothCoordinator, deriveCoordinationPolicy, derivePhantomTargets, deriveTailSignal, evaluateGateWarn, hasMdastSource };
+export { type BlockInfo, type BlockPlanner, type BuildBlocksOptions, type BuildBlocksResult, type ContributionOptions, type ContributionPolicyInputs, type ContributionRegistry, type ContributionSession, type CoordinationPolicy, type DefinitionLabels, type GateWarnVerdict, type PhantomTargets, type PipelineFrameOptions, type PipelineSession, type PipelineTrees, type RenderItem, type SmoothCoordinator, type TailSignal, buildAggregateTree, buildBlocks, buildContributionChain, cloneHastForRender, computeBlockFingerprint, computeHtmlBlockDigest, computeHtmlBlockDigestWithExtent, createBlockPlanner, createContributionSession, createPipelineSession, createSmoothCoordinator, deriveCoordinationPolicy, derivePhantomTargets, deriveTailSignal, evaluateGateWarn, hasMdastSource };

package/dist/index.d.ts

@@ -1,6 +1,4 @@
-import * as hast from 'hast';
 import { Element, RootContent, Root as Root$1, Nodes } from 'hast';
-import * as mdast from 'mdast';
 import { Root } from 'mdast';
 import { Registry, ChunkData, PipelineOptions, AdvanceOptions } from '@ai-markdown/engine';
 export { isFootnoteSection } from '@ai-markdown/engine';
@@ -228,6 +226,7 @@ declare function buildBlocks(mdast: Root, hast: Root$1, source: string, options?
  */
 declare function computeBlockFingerprint(taintLabels: NonNullable<BlockInfo['taintLabels']>, registry: Registry, thisChunkSym: symbol, clobberPrefix: string): string;
 
+type BlockPlanner = (mdast: Root, hast: Root$1, source: string, options?: BuildBlocksOptions) => BuildBlocksResult;
 /** Reuse the engine's retained prefix plans, including reference blocks.
  * Reference prefixes require full-document context when planning the tail.
  * Raw HTML and definition regions retain complete planning: their ownership
@@ -235,7 +234,7 @@ declare function computeBlockFingerprint(taintLabels: NonNullable<BlockInfo['tai
  * guesses, establish which trees the incremental engine actually retained.
  * Top-level traversal remains O(blocks); reference context still visits the
  * full mdast when needed, while per-block HAST planning is tail-only. */
-declare function createBlockPlanner(): (mdast: Root, hast: Root$1, source: string, options?: BuildBlocksOptions) => BuildBlocksResult;
+declare function createBlockPlanner(): BlockPlanner;
 
 /** Minimal write capability; registration and cleanup remain with the adapter. */
 interface ContributionRegistry {
@@ -261,14 +260,15 @@ interface ContributionOptions {
      * validate definition bodies after a plugin or schema change. */
     chain: readonly unknown[];
 }
+interface ContributionSession {
+    commit(options: ContributionOptions): void;
+}
 /** Create one contribution publisher per mounted chunk.
  * Call commit only in the host's commit/effect phase, after registration.
  * Constructing a session does not register or publish anything. A discarded
  * render must never call commit. The host owns registration and cleanup.
  */
-declare function createContributionSession(): {
-    commit({ pipeline, ownLabels, registry, targetPhantoms, sym, clobberPrefix, chain }: ContributionOptions): void;
-};
+declare function createContributionSession(): ContributionSession;
 
 /**
  * Turn-taking coordinator for smooth-streaming chunks that share a
@@ -426,7 +426,7 @@ declare function buildAggregateTree(registry: Registry, clobberPrefix: string, p
  * Copies exactly what the render-time mutators touch — every node object,
  * its `children` array (the allow/disallow filters splice it), and its
  * `properties` object (`urlTransform` overwrites `href`/`src`) — while
- * SHARING `position`, `data`, string values, and individual property values
+ * SHARING `position`, arbitrary nested plugin data, string values, and individual property values
  * by reference. This is both cheaper than a JSON round-trip (no string
  * intermediate; `position` objects, typically over half of a serialized
  * hast, are never materialized) and exact for any tree the pipeline
@@ -438,6 +438,22 @@ declare function buildAggregateTree(registry: Registry, clobberPrefix: string, p
 /** See module docs. Safe for any hast node union member. */
 declare function cloneHastForRender<T extends Nodes>(node: T): T;
 
+/** Per-consumer parse state and full/incremental fallback policy.
+ * The host decides whether a next frame is expected (false for SSR), owns
+ * this session, and resets it when render policy invalidates retained trees.
+ * Parsing does not register chunks or publish document contributions.
+ */
+
+interface PipelineTrees {
+    mdast: Root;
+    hast: Root$1;
+}
+interface PipelineSession {
+    /** Drop retained incremental state. Does not dispose host subscriptions. */
+    reset(): void;
+    /** Read-only borrowed trees: clone before destructive rendering. */
+    parse(options: PipelineFrameOptions): PipelineTrees;
+}
 type RemarkRehypeOptions = NonNullable<PipelineOptions['remarkRehypeOptions']>;
 interface PipelineFrameOptions {
     content: string;
@@ -457,13 +473,7 @@ interface PipelineFrameOptions {
     defListEnabled: boolean;
     measure?: AdvanceOptions['measure'];
 }
-declare function createPipelineSession(): {
-    reset(): void;
-    parse({ content, targetPhantoms, remarkPlugins, rehypePlugins, remarkRehypeOptions, handlers, preserveForBodyHarvest, documentId, provenance, incrementalParse, defListEnabled, measure: measureHere, }: PipelineFrameOptions): {
-        mdast: mdast.Root;
-        hast: hast.Root;
-    };
-};
+declare function createPipelineSession(): PipelineSession;
 
 interface DefinitionLabels {
     footnoteLabels: ReadonlySet<string>;
@@ -494,4 +504,4 @@ type ContributionPolicyInputs = Pick<PipelineFrameOptions, 'remarkPlugins' | 're
  */
 declare function buildContributionChain(inputs: ContributionPolicyInputs): readonly unknown[];
 
-export { type BlockInfo, type BuildBlocksOptions, type BuildBlocksResult, type ContributionOptions, type ContributionPolicyInputs, type ContributionRegistry, type CoordinationPolicy, type DefinitionLabels, type GateWarnVerdict, type PhantomTargets, type PipelineFrameOptions, type RenderItem, type SmoothCoordinator, type TailSignal, buildAggregateTree, buildBlocks, buildContributionChain, cloneHastForRender, computeBlockFingerprint, computeHtmlBlockDigest, computeHtmlBlockDigestWithExtent, createBlockPlanner, createContributionSession, createPipelineSession, createSmoothCoordinator, deriveCoordinationPolicy, derivePhantomTargets, deriveTailSignal, evaluateGateWarn, hasMdastSource };
+export { type BlockInfo, type BlockPlanner, type BuildBlocksOptions, type BuildBlocksResult, type ContributionOptions, type ContributionPolicyInputs, type ContributionRegistry, type ContributionSession, type CoordinationPolicy, type DefinitionLabels, type GateWarnVerdict, type PhantomTargets, type PipelineFrameOptions, type PipelineSession, type PipelineTrees, type RenderItem, type SmoothCoordinator, type TailSignal, buildAggregateTree, buildBlocks, buildContributionChain, cloneHastForRender, computeBlockFingerprint, computeHtmlBlockDigest, computeHtmlBlockDigestWithExtent, createBlockPlanner, createContributionSession, createPipelineSession, createSmoothCoordinator, deriveCoordinationPolicy, derivePhantomTargets, deriveTailSignal, evaluateGateWarn, hasMdastSource };

package/dist/index.dev.cjs

@@ -633,6 +633,11 @@ function cloneHastForRender(node) {
   if (withProperties.properties) {
     withProperties.properties = { ...withProperties.properties };
   }
+  if (copy.data) {
+    copy.data = { ...copy.data };
+    const data = copy.data;
+    if (data.originalUrls) data.originalUrls = { ...data.originalUrls };
+  }
   return copy;
 }