@tabnas/transduce 0.1.0

package/dist/scan.js

@@ -0,0 +1,70 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScanEmit = exports.Transition = void 0;
+// `scan-emit`: declarative state evolution over a stream.
+//
+// A pure step function takes the state and one item and returns the next
+// state with the items to emit; a finish function turns the final state
+// into the closing items. The operator owns the state and the iteration;
+// the functions own nothing. This is what the DSL's `scan-emit` lowers to,
+// and the table transducer is one instance of it.
+const error_1 = require("./error");
+exports.Transition = Object.freeze({
+    of(state, outputs) {
+        return { state, outputs };
+    },
+    // A step that emits nothing.
+    stay(state) {
+        return { state, outputs: [] };
+    },
+    // A step that emits one item.
+    emit(state, output) {
+        return { state, outputs: [output] };
+    },
+});
+// The operator. Feed items with `item`, then call `finish` exactly once
+// when the input completed successfully; never call it after a failure or
+// a cancellation. A step or the finish throws a `Fail` to fail the run; a
+// step that failed leaves the operator without a state, so a later item or
+// `finish` is a `PROTOCOL_ORDER_ERROR`.
+class ScanEmit {
+    constructor(initial, step, finish, out) {
+        this.state = { value: initial };
+        this.step = step;
+        this.finisher = finish;
+        this.out = out;
+    }
+    // One input item. Its outputs go downstream before this returns.
+    item(item) {
+        const state = this.state;
+        if (null === state) {
+            throw error_1.Fail.protocol('scan-emit received an item after it finished');
+        }
+        this.state = null;
+        const transition = this.step(state.value, item);
+        this.state = { value: transition.state };
+        for (const o of transition.outputs) {
+            if ('stop' === this.out(o))
+                return 'stop';
+        }
+        return 'continue';
+    }
+    // The input completed: emit the closing items.
+    finish() {
+        const state = this.state;
+        const finish = this.finisher;
+        if (null === state || null === finish) {
+            throw error_1.Fail.protocol('scan-emit finished twice');
+        }
+        this.state = null;
+        this.finisher = null;
+        for (const o of finish(state.value)) {
+            if ('stop' === this.out(o))
+                return 'stop';
+        }
+        return 'continue';
+    }
+}
+exports.ScanEmit = ScanEmit;
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":";AAAA,4CAA4C;;;AAE5C,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,2EAA2E;AAC3E,kDAAkD;AAElD,mCAA8B;AAMjB,QAAA,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,EAAE,CAAO,KAAQ,EAAE,OAAY;QAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC;IACD,6BAA6B;IAC7B,IAAI,CAAO,KAAQ;QACjB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IAC/B,CAAC;IACD,8BAA8B;IAC9B,IAAI,CAAO,KAAQ,EAAE,MAAS;QAC5B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAA;IACrC,CAAC;CACF,CAAC,CAAA;AAEF,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,wCAAwC;AACxC;IAME,YACE,OAAU,EACV,IAA6C,EAC7C,MAAyB,EACzB,GAAwB;QAExB,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAA;QACtB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,IAAO;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,YAAI,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAA;QACrE,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC/C,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAA;QACxC,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAA;QAC3C,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,+CAA+C;IAC/C,MAAM;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC5B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACtC,MAAM,YAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAA;QACjD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAA;QAC3C,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;CACF"}

package/dist/selector.d.ts

@@ -0,0 +1,40 @@
+export type Segment = string | number;
+export declare function keyText(key: string): string;
+export declare class Path {
+    readonly segments: Segment[];
+    constructor(segments?: Segment[]);
+    static root(): Path;
+    push(seg: Segment): void;
+    pop(): Segment | undefined;
+    depth(): number;
+    clone(): Path;
+    toString(): string;
+}
+export declare function pathText(segments: readonly Segment[]): string;
+export type Step = {
+    readonly type: 'property';
+    readonly name: string;
+} | {
+    readonly type: 'index';
+    readonly index: number;
+} | {
+    readonly type: 'each_index';
+} | {
+    readonly type: 'each_member';
+};
+export declare class Selector {
+    readonly steps: readonly Step[];
+    constructor(steps?: readonly Step[]);
+    static root(): Selector;
+    property(name: string): Selector;
+    index(index: number): Selector;
+    eachIndex(): Selector;
+    eachMember(): Selector;
+    compose(other: Selector): Selector;
+    static fromSegments(segments: readonly Segment[]): Selector;
+    isRoot(): boolean;
+    isMulti(): boolean;
+    mayOverlap(other: Selector): boolean;
+    equals(other: Selector): boolean;
+    toString(): string;
+}

package/dist/selector.js

@@ -0,0 +1,154 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Selector = exports.Path = void 0;
+exports.keyText = keyText;
+exports.pathText = pathText;
+// Selectors: reusable descriptions of where in a document to look.
+//
+// A selector is data, never code: it is built from constructors or from
+// validated path segments (`Selector.fromSegments`), and a matcher
+// interprets it. A concrete `Path` names one location; a `Selector` may
+// name many (`each_index`, `each_member`). Both print in jq syntax, which
+// is what the rest of the fleet prints and accepts.
+const json_1 = require("./json");
+// One key as jq writes it: bare when it is an ASCII identifier, a JSON
+// string otherwise.
+function keyText(key) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(key) ? '.' + key : '.' + (0, json_1.jsonString)(key);
+}
+// A concrete location in a document.
+class Path {
+    constructor(segments = []) {
+        this.segments = segments;
+    }
+    static root() {
+        return new Path([]);
+    }
+    push(seg) {
+        this.segments.push(seg);
+    }
+    pop() {
+        return this.segments.pop();
+    }
+    depth() {
+        return this.segments.length;
+    }
+    clone() {
+        return new Path(this.segments.slice());
+    }
+    // jq syntax: `.a[0]."b-c"`, and `.` for the root.
+    toString() {
+        return pathText(this.segments);
+    }
+}
+exports.Path = Path;
+// Segments in jq syntax.
+function pathText(segments) {
+    if (0 === segments.length)
+        return '.';
+    let out = '';
+    for (const seg of segments) {
+        out += 'number' === typeof seg ? `[${seg}]` : keyText(seg);
+    }
+    return out;
+}
+const EACH_INDEX = Object.freeze({ type: 'each_index' });
+const EACH_MEMBER = Object.freeze({ type: 'each_member' });
+// A description of locations: the root, narrowed step by step. Immutable:
+// every builder returns a new selector.
+class Selector {
+    constructor(steps = []) {
+        this.steps = Object.freeze(steps.slice());
+    }
+    // The document itself.
+    static root() {
+        return new Selector([]);
+    }
+    property(name) {
+        return new Selector([...this.steps, { type: 'property', name }]);
+    }
+    index(index) {
+        if (!Number.isInteger(index) || index < 0) {
+            throw new TypeError('an index step is a non-negative integer: ' + index);
+        }
+        return new Selector([...this.steps, { type: 'index', index }]);
+    }
+    eachIndex() {
+        return new Selector([...this.steps, EACH_INDEX]);
+    }
+    eachMember() {
+        return new Selector([...this.steps, EACH_MEMBER]);
+    }
+    // `this`, then `other` below every location `this` names.
+    compose(other) {
+        return new Selector([...this.steps, ...other.steps]);
+    }
+    // A selector naming exactly one location: `as-path` over data.
+    static fromSegments(segments) {
+        let s = Selector.root();
+        for (const seg of segments) {
+            s = 'number' === typeof seg ? s.index(seg) : s.property(seg);
+        }
+        return s;
+    }
+    isRoot() {
+        return 0 === this.steps.length;
+    }
+    // Whether the selector can name more than one location.
+    isMulti() {
+        return this.steps.some((s) => 'each_index' === s.type || 'each_member' === s.type);
+    }
+    // Whether this selector names a location strictly inside a location
+    // `other` names, or the same one: the test a router uses to refuse
+    // overlapping captures.
+    mayOverlap(other) {
+        const [short, long] = this.steps.length <= other.steps.length ? [this, other] : [other, this];
+        for (let i = 0; i < short.steps.length; i++) {
+            if (!stepMayMatchSame(short.steps[i], long.steps[i]))
+                return false;
+        }
+        return true;
+    }
+    equals(other) {
+        return this.toString() === other.toString();
+    }
+    // jq syntax: `.response.records[*]`, `."odd key"`, `[3]`, `[]` for
+    // every member, `.` for the root.
+    toString() {
+        if (0 === this.steps.length)
+            return '.';
+        let out = '';
+        for (const step of this.steps) {
+            switch (step.type) {
+                case 'property':
+                    out += keyText(step.name);
+                    break;
+                case 'index':
+                    out += `[${step.index}]`;
+                    break;
+                case 'each_index':
+                    out += '[*]';
+                    break;
+                case 'each_member':
+                    out += '[]';
+                    break;
+            }
+        }
+        return out;
+    }
+}
+exports.Selector = Selector;
+function stepMayMatchSame(a, b) {
+    switch (a.type) {
+        case 'property':
+            return (('property' === b.type && a.name === b.name) || 'each_member' === b.type);
+        case 'each_member':
+            return 'property' === b.type || 'each_member' === b.type;
+        case 'index':
+            return ('index' === b.type && a.index === b.index) || 'each_index' === b.type;
+        case 'each_index':
+            return 'index' === b.type || 'each_index' === b.type;
+    }
+}
+//# sourceMappingURL=selector.js.map

package/dist/selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.js","sourceRoot":"","sources":["../src/selector.ts"],"names":[],"mappings":"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"}

package/dist/sink.d.ts

@@ -0,0 +1,29 @@
+import { JsonEvent } from './event';
+export type Flow = 'continue' | 'stop';
+export interface Sink {
+    event(ev: JsonEvent): Flow;
+}
+export declare class EventRecorder implements Sink {
+    readonly events: JsonEvent[];
+    event(ev: JsonEvent): Flow;
+}
+export declare class FnSink implements Sink {
+    private fn;
+    constructor(fn: (ev: JsonEvent) => Flow | void);
+    event(ev: JsonEvent): Flow;
+}
+export declare class CountSink implements Sink {
+    events: number;
+    event(_ev: JsonEvent): Flow;
+}
+export declare function replay(events: Iterable<JsonEvent>, sink: Sink): Flow;
+export declare class TreeContract<S extends Sink> implements Sink {
+    readonly inner: S;
+    private open;
+    private rootDone;
+    constructor(inner: S);
+    private path;
+    private notATree;
+    private closed;
+    event(ev: JsonEvent): Flow;
+}

package/dist/sink.js

@@ -0,0 +1,184 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TreeContract = exports.CountSink = exports.FnSink = exports.EventRecorder = void 0;
+exports.replay = replay;
+// The push boundary between stages.
+//
+// A pipeline is a chain of sinks. The source calls the first sink once per
+// event, synchronously, inside the parse; each stage does its work and
+// calls the next. Nothing is queued between stages, so a slow writer at the
+// end slows the parser at the start: that is the backpressure, and it
+// costs no buffer. A stage that must stop early (a `take`) answers
+// `'stop'`, which the source turns into a cancelled parse. A stage that
+// fails throws a `Fail`; the source stops the parse and the failure
+// reaches the caller unchanged.
+const error_1 = require("./error");
+const selector_1 = require("./selector");
+// A sink that records every event, for tests and small results.
+class EventRecorder {
+    constructor() {
+        this.events = [];
+    }
+    event(ev) {
+        this.events.push(ev);
+        return 'continue';
+    }
+}
+exports.EventRecorder = EventRecorder;
+// A sink made of a function. A function that returns nothing continues.
+class FnSink {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    event(ev) {
+        return this.fn(ev) || 'continue';
+    }
+}
+exports.FnSink = FnSink;
+// A sink that counts events and drops them: the cheapest consumer, for
+// measuring a source on its own.
+class CountSink {
+    constructor() {
+        this.events = 0;
+    }
+    event(_ev) {
+        this.events++;
+        return 'continue';
+    }
+}
+exports.CountSink = CountSink;
+// Replay a recording into a sink, stopping where the sink stops.
+function replay(events, sink) {
+    for (const ev of events) {
+        if ('stop' === sink.event(ev))
+            return 'stop';
+    }
+    return 'continue';
+}
+// A tree's events, held to their contract in front of a sink that takes
+// them as one (a render that writes a document from them): one root value,
+// and in each object a key and then its value, each key once. A value
+// walked from a parsed tree keeps it by construction. A parse streamed as
+// it proceeds may not: it hands on a member its grammar reads twice
+// (JSON's `{"a":1,"a":2}`, whose value keeps the last) where a tree has
+// one, and the rule-event adapter refuses most shapes it cannot follow but
+// not every one a grammar can produce. A repeated key in one object is
+// refused with `DUPLICATE_MEMBER`, and events no tree has (a value where a
+// key is due, a key outside an object, a close with nothing open, a second
+// root) with `STREAMABILITY_UNKNOWN`, each at the path of the object
+// concerned; the event is not passed on. Each open object keeps the keys
+// it has had, dropped when it closes.
+class TreeContract {
+    constructor(inner) {
+        this.open = [];
+        this.rootDone = false;
+        this.inner = inner;
+    }
+    // The path of the value due next: the open containers, each by the member
+    // or element open in it, and in the innermost object its last key when
+    // that member's value is due.
+    path() {
+        const segments = [];
+        const last = this.open.length - 1;
+        this.open.forEach((open, i) => {
+            if (open.array) {
+                segments.push(open.next);
+            }
+            else if ((i !== last || !open.keyDue) && null != open.last) {
+                // A container open inside this object is its last key's value,
+                // whatever `keyDue` says: the member was counted as taken when its
+                // value opened.
+                segments.push(open.last);
+            }
+        });
+        return new selector_1.Path(segments);
+    }
+    notATree(what) {
+        return new error_1.Fail('STREAMABILITY_UNKNOWN', `the stream holds ${what}, which a tree's events never do, so it is not a tree's`).atPath(this.path().toString());
+    }
+    // A value is complete: the next in its array is due, or the root is.
+    closed() {
+        const top = this.open[this.open.length - 1];
+        if (undefined === top)
+            this.rootDone = true;
+        else if (top.array)
+            top.next++;
+    }
+    event(ev) {
+        const top = this.open[this.open.length - 1];
+        switch (ev.type) {
+            case 'key': {
+                if (undefined !== top && !top.array && top.keyDue) {
+                    if (top.keys.has(ev.key)) {
+                        const path = this.path();
+                        path.push(ev.key);
+                        throw new error_1.Fail('DUPLICATE_MEMBER', `member ${JSON.stringify(ev.key)} appears twice in one object, and a tree's ` +
+                            `events hold each key once`).atPath(path.toString());
+                    }
+                    top.keys.add(ev.key);
+                    top.last = ev.key;
+                    top.keyDue = false;
+                }
+                else if (undefined !== top && !top.array) {
+                    throw this.notATree('a key where a value is due');
+                }
+                else {
+                    throw this.notATree('a key outside an object');
+                }
+                break;
+            }
+            case 'object_end':
+                if (undefined !== top && !top.array && top.keyDue) {
+                    this.open.pop();
+                    this.closed();
+                }
+                else if (undefined !== top && !top.array) {
+                    throw this.notATree("an object's end where a value is due");
+                }
+                else {
+                    throw this.notATree("an object's end where none is due");
+                }
+                break;
+            case 'array_end':
+                if (undefined !== top && top.array) {
+                    this.open.pop();
+                    this.closed();
+                }
+                else {
+                    throw this.notATree("an array's end where none is due");
+                }
+                break;
+            case 'end':
+                if (0 < this.open.length) {
+                    throw this.notATree('its end inside an open container');
+                }
+                break;
+            default: {
+                // A value: in an object, only once its key is in; at the root,
+                // only once.
+                if (undefined === top) {
+                    if (this.rootDone)
+                        throw this.notATree('a second root value');
+                }
+                else if (!top.array) {
+                    if (top.keyDue)
+                        throw this.notATree('a value where a key is due');
+                    top.keyDue = true;
+                }
+                if ('object_start' === ev.type) {
+                    this.open.push({ array: false, keys: new Set(), last: null, keyDue: true });
+                }
+                else if ('array_start' === ev.type) {
+                    this.open.push({ array: true, next: 0 });
+                }
+                else {
+                    this.closed();
+                }
+            }
+        }
+        return this.inner.event(ev);
+    }
+}
+exports.TreeContract = TreeContract;
+//# sourceMappingURL=sink.js.map

package/dist/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../src/sink.ts"],"names":[],"mappings":"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"}

package/dist/source.d.ts

@@ -0,0 +1,37 @@
+import { Fail } from './error';
+import { AbortFlag } from './limits';
+import { Selector } from './selector';
+import { Flow, Sink } from './sink';
+export type Prune = {
+    type: 'never';
+} | {
+    type: 'under';
+    selector: Selector;
+} | {
+    type: 'all_arrays';
+};
+export declare const Prune: Readonly<{
+    never(): Prune;
+    under(selector: Selector): Prune;
+    allArrays(): Prune;
+}>;
+export type SourceMode = {
+    type: 'materialize';
+} | {
+    type: 'incremental';
+    prune: Prune;
+};
+export declare const SourceMode: Readonly<{
+    materialize(): SourceMode;
+    incremental(prune?: Prune): SourceMode;
+}>;
+export interface Source {
+    run(sink: Sink): Flow;
+}
+export declare function engineFailure(error: unknown, abort: AbortFlag): Fail;
+export declare function walkValue(value: unknown, sink: Sink): Flow;
+export declare class ValueSource implements Source {
+    readonly value: unknown;
+    constructor(value: unknown);
+    run(sink: Sink): Flow;
+}

package/dist/source.js

@@ -0,0 +1,113 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueSource = exports.SourceMode = exports.Prune = void 0;
+exports.engineFailure = engineFailure;
+exports.walkValue = walkValue;
+// Sources: where `JsonEvents/1` come from.
+//
+// - `ValueSource` walks a parsed engine value. Always correct, retains the
+//   whole value: the fallback for every grammar.
+// - `ParserSource` drives a tabnas parse of one text and, in incremental
+//   mode, turns its rule events into source events as they happen, for the
+//   grammars the differential suite has verified (`capability`); in
+//   materialize mode it parses and walks.
+// - `LinesSource` reads JSON Lines or CSV a record (or a chunk of records)
+//   at a time, bounding memory whatever the input's size.
+//
+// Every source emits through `Guarded`, which enforces the source limits,
+// polls the abort flag and counts the source metrics.
+const error_1 = require("./error");
+const event_1 = require("./event");
+const value_1 = require("./value");
+exports.Prune = Object.freeze({
+    never() {
+        return { type: 'never' };
+    },
+    under(selector) {
+        return { type: 'under', selector };
+    },
+    allArrays() {
+        return { type: 'all_arrays' };
+    },
+});
+exports.SourceMode = Object.freeze({
+    materialize() {
+        return { type: 'materialize' };
+    },
+    incremental(prune = exports.Prune.never()) {
+        return { type: 'incremental', prune };
+    },
+});
+// The engine's cancel code: what a cancelled parse reports, whether the
+// canceller is this crate's abort or a guard of the grammar's own.
+const CANCEL = 'cancel';
+// Map an engine error to a failure. A cancel while the caller's flag is set
+// is `ABORTED`. A cancel otherwise is a guard the GRAMMAR installed, so
+// the message says so instead of "parse cancelled", which would read as
+// the caller's doing; it stays `INPUT_INVALID`, because the document is
+// what the grammar refused. Any other error is the input's, with the
+// engine's code and position. A thrown value that is not an engine error
+// (a grammar's plugin threw) is the input's too, without a position.
+function engineFailure(error, abort) {
+    if (error instanceof error_1.Fail)
+        return error;
+    if (CANCEL !== (0, error_1.engineCode)(error))
+        return error_1.Fail.fromTabnas(error);
+    if (abort.isAborted())
+        return error_1.Fail.aborted();
+    const fail = error_1.Fail.fromTabnas(error);
+    fail.message =
+        `the grammar stopped the parse with a guard of its own (${(0, error_1.engineCode)(error)}: ` +
+            `${(0, error_1.engineDetail)(error)}); a grammar may refuse nesting or size below this crate's Limits`;
+    return fail;
+}
+// Emit one engine value's events (without `end`). `undefined` is `null`,
+// as the engine serializes it; an object's members are in insertion order.
+function walkValue(value, sink) {
+    if (Array.isArray(value)) {
+        if ('stop' === sink.event(event_1.Ev.arrayStart))
+            return 'stop';
+        for (const item of value) {
+            if ('stop' === walkValue(item, sink))
+                return 'stop';
+        }
+        return sink.event(event_1.Ev.arrayEnd);
+    }
+    const scalar = (0, value_1.engineScalar)(value);
+    if (undefined !== scalar) {
+        switch (scalar.type) {
+            case 'null':
+                return sink.event(event_1.Ev.null);
+            case 'bool':
+                return sink.event(event_1.Ev.bool(scalar.value));
+            case 'number':
+                return sink.event(event_1.Ev.number(scalar.value));
+            case 'string':
+                return sink.event(event_1.Ev.string(scalar.value));
+        }
+    }
+    if ('stop' === sink.event(event_1.Ev.objectStart))
+        return 'stop';
+    for (const k of (0, value_1.engineKeys)(value)) {
+        if ('stop' === sink.event(event_1.Ev.key(k)))
+            return 'stop';
+        if ('stop' === walkValue(value[k], sink))
+            return 'stop';
+    }
+    return sink.event(event_1.Ev.objectEnd);
+}
+// Emit a parsed engine value as events, ending with `end`. Applies no
+// limits: wrap the sink in `Guarded` for those.
+class ValueSource {
+    constructor(value) {
+        this.value = value;
+    }
+    run(sink) {
+        if ('stop' === walkValue(this.value, sink))
+            return 'stop';
+        return sink.event(event_1.Ev.end);
+    }
+}
+exports.ValueSource = ValueSource;
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}