cesr-ts 0.2.2 → 0.3.0

package/types/src/annotate/render.d.ts

@@ -1,5 +1,11 @@
-import type { CesrFrame } from "../core/types.js";
+import type { CesrMessage } from "../core/types.js";
 import type { AnnotatedFrame, AnnotateOptions } from "./types.js";
+/**
+ * Render stream-level wrapper groups (GenericGroup/BodyWithAttachmentGroup)
+ * so denot round-trips preserve wrapper counters. Returns null when input does
+ * not start in a wrapper-oriented domain and caller should use frame rendering.
+ */
+export declare function renderWrapperAnnotatedStream(input: Uint8Array, options: Required<AnnotateOptions>): string | null;
 /** Render parsed CESR frames into line-oriented, human-annotated text blocks. */
-export declare function renderAnnotatedFrames(frames: CesrFrame[], options: Required<AnnotateOptions>): AnnotatedFrame[];
+export declare function renderAnnotatedFrames(frames: CesrMessage[], options: Required<AnnotateOptions>): AnnotatedFrame[];
 //# sourceMappingURL=render.d.ts.map

package/types/src/annotate/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/src/annotate/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqWlE,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GACjC,cAAc,EAAE,CAElB"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/src/annotate/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkflE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GACjC,MAAM,GAAG,IAAI,CAaf;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GACjC,cAAc,EAAE,CAElB"}

package/types/src/annotate/types.d.ts

@@ -1,4 +1,4 @@
-import type { CesrFrame } from "../core/types.js";
+import type { CesrMessage } from "../core/types.js";
 export interface AnnotateOptions {
     commentMode?: "inline" | "above";
     indent?: number;
@@ -9,7 +9,7 @@ export interface AnnotateOptions {
 }
 export interface AnnotatedFrame {
     index: number;
-    frame: CesrFrame;
+    frame: CesrMessage;
     lines: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/types/src/annotate/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/annotate/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/annotate/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/types/src/bench/parser-benchmark.d.ts

@@ -0,0 +1,70 @@
+import { type ParserOptions } from "../core/parser-engine.js";
+/**
+ * Benchmark configuration for parser throughput measurements.
+ *
+ * Boundary contract:
+ * - This configuration only controls execution shape (iterations/chunking/parser mode).
+ * - It must not mutate parser behavior beyond explicit `parserOptions`.
+ */
+export interface CesrParserBenchmarkOptions {
+    /** Number of measured parser runs. */
+    iterations?: number;
+    /** Number of warmup runs before measured runs. */
+    warmupIterations?: number;
+    /**
+     * Optional chunk size for simulated streaming.
+     *
+     * When unset or <= 0, the full stream is fed in one chunk.
+     */
+    chunkSize?: number;
+    /** Parser behavior options to benchmark. */
+    parserOptions?: ParserOptions;
+    /**
+     * Whether any parse error frame should fail the benchmark run.
+     * Default: true.
+     */
+    failOnParseError?: boolean;
+}
+export interface CesrParseRunSummary {
+    frameCount: number;
+    errorCount: number;
+}
+/**
+ * Stable benchmark result envelope consumed by CLI and maintainers.
+ *
+ * Invariants:
+ * - `totalBytes === bytesPerIteration * iterations`
+ * - rate metrics are derived from `elapsedMs` and must remain monotonic with work size.
+ */
+export interface CesrParserBenchmarkResult {
+    iterations: number;
+    warmupIterations: number;
+    chunkSize: number;
+    bytesPerIteration: number;
+    totalBytes: number;
+    totalFrames: number;
+    totalErrors: number;
+    elapsedMs: number;
+    avgIterationMs: number;
+    throughputBytesPerSec: number;
+    throughputMiBPerSec: number;
+    framesPerSec: number;
+}
+/**
+ * Execute one complete parser pass over the provided stream.
+ *
+ * Boundary contract:
+ * - Always feeds configured chunks and then flushes once.
+ * - Returns event counts only; callers own timing and aggregation.
+ */
+export declare function parseCesrStreamOnce(input: Uint8Array, options?: Pick<CesrParserBenchmarkOptions, "chunkSize" | "parserOptions">): CesrParseRunSummary;
+/**
+ * Benchmark parser throughput across warmup + measured iterations.
+ *
+ * Invariants:
+ * - warmup runs are excluded from final metrics.
+ * - when `failOnParseError` is true, any parse error fails fast to prevent
+ *   silently benchmarking degraded correctness.
+ */
+export declare function benchmarkCesrParser(input: Uint8Array, options?: CesrParserBenchmarkOptions): CesrParserBenchmarkResult;
+//# sourceMappingURL=parser-benchmark.d.ts.map

package/types/src/bench/parser-benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-benchmark.d.ts","sourceRoot":"","sources":["../../../src/src/bench/parser-benchmark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG5E;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAmED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,GAAG,eAAe,CAAM,GAC5E,mBAAmB,CAcrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA4D3B"}

package/types/src/core/bytes.d.ts

@@ -1,5 +1,11 @@
 export declare const encoder: TextEncoder;
 export declare const decoder: TextDecoder;
+/**
+ * Concatenates Uint8Array byte arrays into one byte array
+ *
+ * @param chunks chunks to concatenate
+ * @returns concatenated bytearray
+ */
 export declare function concatBytes(...chunks: Uint8Array[]): Uint8Array;
 export declare function intToB64(value: number, length?: number): string;
 export declare function b64ToInt(text: string): number;

package/types/src/core/bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/src/core/bytes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,aAAoB,CAAC;AACzC,eAAO,MAAM,OAAO,aAAoB,CAAC;AAIzC,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS/D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAc1D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAQlD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAIpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAEzE"}
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/src/core/bytes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,aAAoB,CAAC;AACzC,eAAO,MAAM,OAAO,aAAoB,CAAC;AAIzC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS/D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAc1D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAQlD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAIpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAEzE"}

package/types/src/core/errors.d.ts

@@ -18,4 +18,14 @@ export declare class GroupSizeError extends ParserError {
 }
 export declare class DeserializeError extends ParserError {
 }
+/** Failure while constructing syntax artifacts from token bytes. */
+export declare class SyntaxParseError extends ParserError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined, offset?: number, context?: string);
+}
+/** Failure while interpreting syntax artifacts into semantic fields. */
+export declare class SemanticInterpretationError extends ParserError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined, offset?: number, context?: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/types/src/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;aAGlB,MAAM,CAAC,EAAE,MAAM;aACf,OAAO,CAAC,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,qBAAa,aAAc,SAAQ,WAAW;aAE1B,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM;gBADjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjC,MAAM,CAAC,EAAE,MAAM;CAIlB;AAED,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAClD,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAChD,qBAAa,gBAAiB,SAAQ,WAAW;CAAG;AACpD,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAClD,qBAAa,gBAAiB,SAAQ,WAAW;CAAG"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;aAGlB,MAAM,CAAC,EAAE,MAAM;aACf,OAAO,CAAC,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,qBAAa,aAAc,SAAQ,WAAW;aAE1B,MAAM,EAAE,MAAM;aACd,SAAS,EAAE,MAAM;gBADjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjC,MAAM,CAAC,EAAE,MAAM;CAIlB;AAED,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAClD,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAChD,qBAAa,gBAAiB,SAAQ,WAAW;CAAG;AACpD,qBAAa,cAAe,SAAQ,WAAW;CAAG;AAClD,qBAAa,gBAAiB,SAAQ,WAAW;CAAG;AACpD,oEAAoE;AACpE,qBAAa,gBAAiB,SAAQ,WAAW;aAGpB,KAAK,CAAC,EAAE,KAAK;gBADtC,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,KAAK,YAAA,EACtC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CAInB;AACD,wEAAwE;AACxE,qBAAa,2BAA4B,SAAQ,WAAW;aAG/B,KAAK,CAAC,EAAE,KAAK;gBADtC,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,KAAK,YAAA,EACtC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CAInB"}

package/types/src/core/parser-attachment-collector.d.ts

@@ -0,0 +1,51 @@
+import type { AttachmentVersionFallbackPolicy } from "../parser/group-dispatch.js";
+import type { Versionage } from "../tables/table-types.js";
+import type { FrameBoundaryPolicy } from "./parser-policy.js";
+import type { RecoveryDiagnosticObserver } from "./recovery-diagnostics.js";
+import type { AttachmentGroup, CesrMessage } from "./types.js";
+/** Dependency-injected attachment collection policies and hooks. */
+interface AttachmentCollectorOptions {
+    frameBoundaryPolicy: FrameBoundaryPolicy;
+    attachmentVersionFallbackPolicy: AttachmentVersionFallbackPolicy;
+    recoveryDiagnosticObserver?: RecoveryDiagnosticObserver;
+    isFrameBoundaryAhead: (input: Uint8Array, version: Versionage, cold: "txt" | "bny") => boolean;
+}
+/** Outcome for top-level trailing attachment collection. */
+export interface CollectAttachmentsResult {
+    attachments: AttachmentGroup[];
+    consumed: number;
+    pausedForShortage: boolean;
+}
+/** Outcome for pending-frame continuation parsing. */
+export interface ResumePendingResult {
+    consumed: number;
+    emitPending: boolean;
+    shouldContinue: boolean;
+}
+/**
+ * Parses and appends attachment groups for both:
+ * - normal trailing-attachment collection after frame start parse
+ * - pending-frame continuation after shortage pauses
+ */
+export declare class AttachmentCollector {
+    private readonly frameBoundaryPolicy;
+    private readonly attachmentVersionFallbackPolicy;
+    private readonly recoveryDiagnosticObserver?;
+    private readonly isFrameBoundaryAhead;
+    constructor(options: AttachmentCollectorOptions);
+    /**
+     * Collect attachments from the current stream head until a frame boundary
+     * (including `msg` message-domain frame start) or shortage pause is reached.
+     */
+    collectTrailingAttachments(input: Uint8Array, version: Versionage, streamVersion: Versionage, seed?: AttachmentGroup[]): CollectAttachmentsResult;
+    /**
+     * Resume attachment parsing for a pending top-level frame.
+     *
+     * Emits no events directly; parser orchestration decides when to emit pending.
+     */
+    resumePendingFrame(input: Uint8Array, pendingFrame: CesrMessage, version: Versionage, streamVersion: Versionage): ResumePendingResult;
+    /** Fast-forward consecutive annotation separator bytes from a local offset. */
+    private consumeLeadingAno;
+}
+export {};
+//# sourceMappingURL=parser-attachment-collector.d.ts.map

package/types/src/core/parser-attachment-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-attachment-collector.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-attachment-collector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,oEAAoE;AACpE,UAAU,0BAA0B;IAClC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,+BAA+B,EAAE,+BAA+B,CAAC;IACjE,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;IACxD,oBAAoB,EAAE,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,KAAK,GAAG,KAAK,KAChB,OAAO,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CACd;IAClC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAA6B;IACzE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAIxB;gBAED,OAAO,EAAE,0BAA0B;IAQ/C;;;OAGG;IACH,0BAA0B,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,UAAU,EACzB,IAAI,GAAE,eAAe,EAAO,GAC3B,wBAAwB;IAiE3B;;;;OAIG;IACH,kBAAkB,CAChB,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,WAAW,EACzB,OAAO,EAAE,UAAU,EACnB,aAAa,EAAE,UAAU,GACxB,mBAAmB;IAqEtB,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB;CAO1B"}

package/types/src/core/parser-constants.d.ts

@@ -0,0 +1,30 @@
+import type { Counter } from "../primitives/counter.js";
+import type { Versionage } from "../tables/table-types.js";
+/** Default parser version context when no explicit selector is present. */
+export declare const DEFAULT_VERSION: Versionage;
+/** Native map-body counter codes that permit interleaved label parsing. */
+export declare const MAP_BODY_CODES: Set<string>;
+/** Counter code for stream or nested genus-version selector tokens. */
+export declare const GENUS_VERSION_CODE: string;
+/** True when counter begins a top-level frame boundary domain. */
+export declare function isFrameBoundaryCounter(counter: Counter): boolean;
+/** Counter names supported as frame starts in CESR-native domain. */
+export declare const FRAME_START_GROUP_NAMES: Set<string>;
+/** Wrapper counters whose payload encloses one full body+attachments frame. */
+export declare const BODY_WITH_ATTACHMENT_GROUP_NAMES: Set<string>;
+/** Non-native body counters whose payload is a texter-wrapped message body. */
+export declare const NON_NATIVE_BODY_GROUP_NAMES: Set<string>;
+/** Native body counters (fixed-field or map-body forms). */
+export declare const NATIVE_BODY_GROUP_NAMES: Set<string>;
+/** Generic counters whose payload contains one or more enclosed frames. */
+export declare const GENERIC_GROUP_NAMES: Set<string>;
+/** Domain-sensitive token size helper (qb64 vs qb2). */
+export declare function tokenSize(token: {
+    fullSize: number;
+    fullSizeB2: number;
+}, cold: "txt" | "bny"): number;
+/** Domain-sensitive counter unit (quadlet count for txt, triplet count for bny). */
+export declare function quadletUnit(cold: "txt" | "bny"): number;
+/** Attachment parsing domains supported by the parser. */
+export declare function isAttachmentDomain(cold: string): cold is "txt" | "bny";
+//# sourceMappingURL=parser-constants.d.ts.map

package/types/src/core/parser-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-constants.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,UAAmC,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,cAAc,aAGzB,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAgBhE,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEhE;AAED,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,aAWlC,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,gCAAgC,aAG3C,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,aAGtC,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,aAKlC,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,aAG9B,CAAC;AAEH,wDAAwD;AACxD,wBAAgB,SAAS,CACvB,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC/C,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,MAAM,CAER;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAEvD;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,KAAK,GAAG,KAAK,CAEtE"}

package/types/src/core/parser-deferred-frames.d.ts

@@ -0,0 +1,38 @@
+import type { Versionage } from "../tables/table-types.js";
+import type { CesrFrame, CesrMessage } from "./types.js";
+/** Pending top-level frame state awaiting continuation parsing. */
+export interface PendingFrameState {
+    frame: CesrMessage;
+    version: Versionage;
+}
+/**
+ * Manages deferred frame emission lifecycle for parser orchestration.
+ *
+ * Contract reminder:
+ * - `pendingFrame` is older than any `queuedFrames`.
+ * - flush order must preserve stream encounter order.
+ */
+export declare class DeferredFrameLifecycle {
+    private pendingFrame;
+    private queuedFrames;
+    /** Current pending top-level frame continuation, if any. */
+    get pending(): PendingFrameState | null;
+    /** Whether enclosed deferred frames are queued for emission. */
+    hasQueued(): boolean;
+    /** Store a pending top-level frame continuation. */
+    setPending(frame: CesrMessage, version: Versionage): void;
+    /** Clear pending top-level frame continuation state. */
+    clearPending(): void;
+    /** Append enclosed frames parsed from one bounded GenericGroup payload. */
+    enqueueQueued(frames: CesrMessage[]): void;
+    /** Emit next queued enclosed frame (FIFO) when no pending frame remains. */
+    shiftQueued(): CesrMessage | undefined;
+    /**
+     * Flush deferred frames in normative order: pending first, queued next.
+     * Buffer-remainder shortage handling is outside this collaborator.
+     */
+    flushDeferred(): CesrFrame[];
+    /** Clear all deferred frame lifecycle state. */
+    reset(): void;
+}
+//# sourceMappingURL=parser-deferred-frames.d.ts.map

package/types/src/core/parser-deferred-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-deferred-frames.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-deferred-frames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAqB;IAEzC,4DAA4D;IAC5D,IAAI,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAEtC;IAED,gEAAgE;IAChE,SAAS,IAAI,OAAO;IAIpB,oDAAoD;IACpD,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAIzD,wDAAwD;IACxD,YAAY,IAAI,IAAI;IAIpB,2EAA2E;IAC3E,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAO1C,4EAA4E;IAC5E,WAAW,IAAI,WAAW,GAAG,SAAS;IAItC;;;OAGG;IACH,aAAa,IAAI,SAAS,EAAE;IAkB5B,gDAAgD;IAChD,KAAK,IAAI,IAAI;CAId"}

package/types/src/core/parser-engine.d.ts

@@ -1,58 +1,67 @@
-import type { ParseEmission } from "./types.js";
-import type { AttachmentDispatchOptions, VersionFallbackInfo } from "../parser/group-dispatch.js";
+import type { CesrFrame } from "./types.js";
+import { type AttachmentDispatchOptions, type AttachmentVersionFallbackPolicy, type VersionFallbackInfo } from "../parser/group-dispatch.js";
+import { type FrameBoundaryPolicy } from "./parser-policy.js";
+import { type RecoveryDiagnosticObserver } from "./recovery-diagnostics.js";
 export interface ParserOptions {
+    /** Legacy framed toggle; used only when `frameBoundaryPolicy` is not injected. */
     framed?: boolean;
+    /**
+     * Legacy strict/compat selector; used only when
+     * `attachmentVersionFallbackPolicy` is not injected.
+     */
     attachmentDispatchMode?: AttachmentDispatchOptions["mode"];
+    /** Legacy fallback observer; adapted from structured diagnostics events. */
     onAttachmentVersionFallback?: (info: VersionFallbackInfo) => void;
+    /** Structured recovery diagnostics observer (preferred observability path). */
+    onRecoveryDiagnostic?: RecoveryDiagnosticObserver;
+    /** Explicit frame-boundary strategy override (preferred for new integrations). */
+    frameBoundaryPolicy?: FrameBoundaryPolicy;
+    /**
+     * Explicit attachment fallback strategy override.
+     *
+     * When provided, this supersedes `attachmentDispatchMode` and
+     * `onAttachmentVersionFallback`.
+     */
+    attachmentVersionFallbackPolicy?: AttachmentVersionFallbackPolicy;
 }
-export declare class CesrParserCore {
-    private state;
-    private readonly framed;
-    private readonly attachmentDispatchMode;
-    private readonly onAttachmentVersionFallback?;
-    private pendingFrame;
+/**
+ * Streaming CESR parser for message-domain and CESR-native body-group streams.
+ * Handles chunk boundaries, pending frames, and attachment continuation.
+ */
+export declare class CesrParser {
+    /**
+     * Parser state contract (normative):
+     * `docs/design-docs/CESR_PARSER_STATE_MACHINE_CONTRACT.md`
+     */
+    private readonly frameBoundaryPolicy;
+    private readonly stream;
+    private readonly deferred;
+    private readonly frameParser;
+    private readonly attachmentCollector;
+    private readonly recoveryDiagnosticObserver?;
+    /**
+     * Compose parser collaborators with injected policy strategies.
+     *
+     * Policy precedence:
+     * 1) explicit policy objects from `ParserOptions`
+     * 2) derived defaults from legacy `framed` and strict/compat options
+     */
     constructor(options?: ParserOptions);
     /** Append bytes and emit any complete parse events. */
-    feed(chunk: Uint8Array): ParseEmission[];
+    feed(chunk: Uint8Array): CesrFrame[];
     /** Flush pending state at end-of-stream, emitting frame/error if needed. */
-    flush(): ParseEmission[];
+    flush(): CesrFrame[];
     reset(): void;
     /**
-     * Core streaming loop.
-     * Keeps state machine behavior explicit: consume separators, parse a base
-     * frame, then greedily collect trailing attachment groups.
+     * Core streaming loop. Emit pending frames, then queued frames, then new base frame with trailing attachments.
+     * Contract invariants:
+     * - `pendingFrame` is always resumed before any queued enclosed frame emits.
+     * - `queuedFrames` are emitted before starting a new parse from `buffer`.
      */
     private drain;
-    private resumePendingFrame;
-    private consume;
-    private consumeLeadingAno;
-    /**
-     * Parse a single top-level frame start from current buffer head.
-     * Supports message-domain serders and CESR-native body groups.
-     */
-    private parseFrame;
-    /** Parse wrapped body+attachments payloads as a complete nested frame. */
-    private parseBodyWithAttachmentGroup;
-    /** Parse a non-native body group; keep opaque fallback when serder reap fails. */
-    private parseNonNativeBodyGroup;
-    /** Parse fixed/map native body groups and extract semantic native fields. */
-    private parseNativeBodyGroup;
-    /** Decode genus-version counter suffix to active CESR version. */
-    private decodeVersionCounter;
-    /**
-     * Best-effort native metadata extraction.
-     * This is intentionally advisory and may recover instead of failing hard.
-     */
-    private extractNativeMetadata;
-    /** Skip consecutive native label tokens (V/W) from an offset. */
-    private skipNativeLabelers;
-    /** Strict native field extraction for annotation and higher-level processing. */
-    private extractNativeFields;
-    /** Counter probe with ordered version fallback; throws on shortage. */
-    private tryParseCounter;
-    /** Parse one complete frame plus optional attachments from a standalone slice. */
-    private parseCompleteFrame;
 }
-export declare function createParser(options?: ParserOptions): CesrParserCore;
-export declare function parseBytes(bytes: Uint8Array, options?: ParserOptions): ParseEmission[];
+/** CESR parser factory function. */
+export declare function createParser(options?: ParserOptions): CesrParser;
+/** Parse a buffer of bytes into a list of frames. */
+export declare function parseBytes(bytes: Uint8Array, options?: ParserOptions): CesrFrame[];
 //# sourceMappingURL=parser-engine.d.ts.map

package/types/src/core/parser-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser-engine.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,aAAa,EAAe,MAAM,YAAY,CAAC;AAIxE,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AAoBrC,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3D,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACnE;AA6CD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAyD;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAC3E,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAEnC;IACV,OAAO,CAAC,YAAY,CAEJ;gBAEJ,OAAO,GAAE,aAAkB;IAMvC,uDAAuD;IACvD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE;IAKxC,4EAA4E;IAC5E,KAAK,IAAI,aAAa,EAAE;IAkBxB,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,OAAO,CAAC,KAAK;IA8Fb,OAAO,CAAC,kBAAkB;IA0E1B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAuFlB,0EAA0E;IAC1E,OAAO,CAAC,4BAA4B;IA2BpC,kFAAkF;IAClF,OAAO,CAAC,uBAAuB;IAkD/B,6EAA6E;IAC7E,OAAO,CAAC,oBAAoB;IA0C5B,kEAAkE;IAClE,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA0D7B,iEAAiE;IACjE,OAAO,CAAC,kBAAkB;IAgB1B,iFAAiF;IACjF,OAAO,CAAC,mBAAmB;IAkE3B,uEAAuE;IACvE,OAAO,CAAC,eAAe;IA6BvB,kFAAkF;IAClF,OAAO,CAAC,kBAAkB;CAgD3B;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,cAAc,CAExE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,aAAkB,GAC1B,aAAa,EAAE,CAGjB"}
+{"version":3,"file":"parser-engine.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EAEpC,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3D,4EAA4E;IAC5E,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClE,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;;;OAKG;IACH,+BAA+B,CAAC,EAAE,+BAA+B,CAAC;CACnE;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAA6B;IAEzE;;;;;;OAMG;gBACS,OAAO,GAAE,aAAkB;IAgCvC,uDAAuD;IACvD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE;IAKpC,4EAA4E;IAC5E,KAAK,IAAI,SAAS,EAAE;IAmBpB,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,OAAO,CAAC,KAAK;CAoHd;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,UAAU,CAEpE;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,aAAkB,GAC1B,SAAS,EAAE,CAGb"}

package/types/src/core/parser-frame-parser.d.ts

@@ -0,0 +1,89 @@
+import type { AttachmentVersionFallbackPolicy } from "../parser/group-dispatch.js";
+import type { Versionage } from "../tables/table-types.js";
+import type { RecoveryDiagnosticObserver } from "./recovery-diagnostics.js";
+import type { FrameBoundaryPolicy } from "./parser-policy.js";
+import type { CesrMessage } from "./types.js";
+/** Dependency-injected options for frame parsing behavior and hooks. */
+interface FrameParserOptions {
+    frameBoundaryPolicy: FrameBoundaryPolicy;
+    attachmentVersionFallbackPolicy: AttachmentVersionFallbackPolicy;
+    onEnclosedFrames: (frames: CesrMessage[]) => void;
+    recoveryDiagnosticObserver?: RecoveryDiagnosticObserver;
+}
+/** Parsed frame-start result consumed by top-level parser orchestration. */
+export interface ParsedFrameStart {
+    frame: CesrMessage;
+    consumed: number;
+    version: Versionage;
+    streamVersion: Versionage;
+}
+/**
+ * Parses frame starts and bounded frame payload structures.
+ *
+ * Responsibilities:
+ * - resolve frame-start forms (`msg`, native/body groups, wrappers)
+ * - preserve version-scope semantics for stream and nested payloads
+ * - emit enclosed GenericGroup siblings through callback for deferred handling
+ */
+export declare class FrameParser {
+    private readonly frameBoundaryPolicy;
+    private readonly attachmentVersionFallbackPolicy;
+    private readonly onEnclosedFrames;
+    private readonly recoveryDiagnosticObserver?;
+    constructor(options: FrameParserOptions);
+    /** Probe whether the next token is a top-level frame boundary counter. */
+    isFrameBoundaryAhead(input: Uint8Array, version: Versionage, cold: "txt" | "bny"): boolean;
+    /**
+     * Parse one frame start from the current head.
+     * Does not parse trailing top-level attachments.
+     */
+    parseFrame(input: Uint8Array, inheritedVersion?: Versionage): ParsedFrameStart;
+    /**
+     * Parse frame-start tokens into a syntax artifact.
+     *
+     * Non-goal: this is not a global two-pass parser rewrite. It only separates
+     * the highest-coupling frame-start syntax extraction from semantic dispatch.
+     */
+    private parseFrameStartSyntax;
+    /** Interpret frame-start syntax artifacts into semantic parse behavior. */
+    private interpretFrameStartSyntax;
+    /** Parse nested `BodyWithAttachmentGroup` payload as one complete enclosed frame. */
+    private parseBodyWithAttachmentGroup;
+    /**
+     * Parse `NonNativeBodyGroup` payload, preserving opaque-body fallback behavior
+     * when Serder decode is not possible.
+     * Returns only a body object (Serder) with no attachments.
+     */
+    private parseNonNativeBodyGroup;
+    /** Parse native fixed/map body group and extract metadata/native fields. */
+    private parseNativeBodyGroup;
+    /**
+     * Parse bounded `GenericGroup` payload into enclosed frames.
+     * Returns first frame and reports remaining siblings via callback.
+     */
+    private parseGenericGroup;
+    /** Parse all enclosed frames inside a bounded payload slice, in order. */
+    private parseFrameSequence;
+    /** Parse one complete frame from a bounded slice, including trailing attachments. */
+    private parseCompleteFrame;
+    /** Decode a genus-version counter token into major/minor Versionage values. */
+    private decodeVersionCounter;
+    /** Build native-body syntax artifacts used by semantic interpretation phase. */
+    private parseNativeBodySyntax;
+    /** Parse advisory native metadata tokens without semantic projection. */
+    private parseNativeMetadataSyntax;
+    /** Interpret advisory metadata syntax into projected body metadata fields. */
+    private interpretNativeMetadataSyntax;
+    /** Parse native field tokens without resolving label/value pairing semantics. */
+    private parseNativeFieldSyntax;
+    /** Interpret native field syntax into semantic fields with label/value pairing. */
+    private interpretNativeFieldSyntax;
+    /** Skip consecutive labeler tokens in native map-body parsing context. */
+    private skipNativeLabelers;
+    /** Probe parseCounter with ordered major-version fallback. */
+    private tryParseCounter;
+    /** Resolve a valid frame-start counter, preferring current stream major version. */
+    private resolveFrameStartCounter;
+}
+export {};
+//# sourceMappingURL=parser-frame-parser.d.ts.map

package/types/src/core/parser-frame-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-frame-parser.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-frame-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAChC,MAAM,6BAA6B,CAAC;AAarC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAuB5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wEAAwE;AACxE,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,+BAA+B,EAAE,+BAA+B,CAAC;IACjE,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAClD,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;CACzD;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,aAAa,EAAE,UAAU,CAAC;CAC3B;AAoED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CACd;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAA6B;gBAE7D,OAAO,EAAE,kBAAkB;IAQvC,0EAA0E;IAC1E,oBAAoB,CAClB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,KAAK,GAAG,KAAK,GAClB,OAAO;IAKV;;;OAGG;IACH,UAAU,CACR,KAAK,EAAE,UAAU,EACjB,gBAAgB,GAAE,UAA4B,GAC7C,gBAAgB;IAKnB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA4G7B,2EAA2E;IAC3E,OAAO,CAAC,yBAAyB;IA+FjC,qFAAqF;IACrF,OAAO,CAAC,4BAA4B;IA6BpC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAkD/B,4EAA4E;IAC5E,OAAO,CAAC,oBAAoB;IAgD5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAoCzB,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB;IAuE1B,qFAAqF;IACrF,OAAO,CAAC,kBAAkB;IAqD1B,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAa5B,gFAAgF;IAChF,OAAO,CAAC,qBAAqB;IAoC7B,yEAAyE;IACzE,OAAO,CAAC,yBAAyB;IAuCjC,8EAA8E;IAC9E,OAAO,CAAC,6BAA6B;IAmBrC,iFAAiF;IACjF,OAAO,CAAC,sBAAsB;IA8D9B,mFAAmF;IACnF,OAAO,CAAC,0BAA0B;IA6ClC,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB;IAgB1B,8DAA8D;IAC9D,OAAO,CAAC,eAAe;IA6BvB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;CA8CjC"}

package/types/src/core/parser-policy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Strategy interface for frame-boundary and emission cadence behavior.
+ *
+ * Implementations encapsulate framed/unframed decisions so parser collaborators
+ * can delegate policy checks without branching on raw booleans.
+ */
+export interface FrameBoundaryPolicy {
+    /** Whether one queued-frame emission should end the current drain cycle. */
+    shouldStopAfterQueuedFrameEmission(): boolean;
+    /** Whether one completed frame emission should end the current drain cycle. */
+    shouldStopAfterCompletedFrameEmission(): boolean;
+    /** Whether one collected attachment group should end local collection loops. */
+    shouldStopAfterAttachmentGroupCollection(): boolean;
+    /** Whether pending continuation should emit after one attachment append. */
+    shouldEmitPendingAfterAttachmentResume(): boolean;
+    /** Whether a body-only frame at end-of-buffer should be deferred as pending. */
+    shouldDeferBodyOnlyFrame(attachmentCount: number, remainingBufferLength: number): boolean;
+}
+/**
+ * Build default frame-boundary strategy from legacy parser options.
+ *
+ * Why:
+ * maintains backward compatibility for `framed` while allowing call sites to
+ * inject explicit `FrameBoundaryPolicy` implementations.
+ */
+export declare function createFrameBoundaryPolicy(framed?: boolean): FrameBoundaryPolicy;
+//# sourceMappingURL=parser-policy.d.ts.map

package/types/src/core/parser-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-policy.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,kCAAkC,IAAI,OAAO,CAAC;IAC9C,+EAA+E;IAC/E,qCAAqC,IAAI,OAAO,CAAC;IACjD,gFAAgF;IAChF,wCAAwC,IAAI,OAAO,CAAC;IACpD,4EAA4E;IAC5E,sCAAsC,IAAI,OAAO,CAAC;IAClD,gFAAgF;IAChF,wBAAwB,CACtB,eAAe,EAAE,MAAM,EACvB,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC;CACZ;AA+ID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,OAAe,GACtB,mBAAmB,CAIrB"}

package/types/src/core/parser-stream-state.d.ts

@@ -0,0 +1,30 @@
+import type { Versionage } from "../tables/table-types.js";
+/**
+ * Owns mutable stream-level parser state (buffer, absolute offset, stream version).
+ *
+ * This class intentionally has no parse policy; it only provides deterministic
+ * state transitions used by parser orchestration.
+ */
+export declare class ParserStreamState {
+    private state;
+    private activeVersion;
+    /** Initialize stream state with the parser's default top-level version. */
+    constructor(initialVersion: Versionage);
+    /** Current unconsumed bytes. */
+    get buffer(): Uint8Array;
+    /** Absolute consumed-byte offset (monotonic). */
+    get offset(): number;
+    /** Active top-level stream version context. */
+    get streamVersion(): Versionage;
+    /** Update active top-level stream version context. */
+    set streamVersion(version: Versionage);
+    /** Append bytes to the buffered stream tail. */
+    append(chunk: Uint8Array): void;
+    /** Consume a prefix from the buffer and advance absolute offset. */
+    consume(length: number): void;
+    /** Consume all leading annotation-domain separator bytes (`ano`). */
+    consumeLeadingAno(): void;
+    /** Reset buffer/offset/version to initial parser state. */
+    reset(initialVersion: Versionage): void;
+}
+//# sourceMappingURL=parser-stream-state.d.ts.map

package/types/src/core/parser-stream-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-stream-state.d.ts","sourceRoot":"","sources":["../../../src/src/core/parser-stream-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAyD;IACtE,OAAO,CAAC,aAAa,CAAa;IAElC,2EAA2E;gBAC/D,cAAc,EAAE,UAAU;IAItC,gCAAgC;IAChC,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,iDAAiD;IACjD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+CAA+C;IAC/C,IAAI,aAAa,IAAI,UAAU,CAE9B;IAED,sDAAsD;IACtD,IAAI,aAAa,CAAC,OAAO,EAAE,UAAU,EAEpC;IAED,gDAAgD;IAChD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI/B,oEAAoE;IACpE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B,qEAAqE;IACrE,iBAAiB,IAAI,IAAI;IAMzB,2DAA2D;IAC3D,KAAK,CAAC,cAAc,EAAE,UAAU,GAAG,IAAI;CAIxC"}