@tabnas/transduce 0.1.1 → 0.2.0

package/dist/sink.d.ts

@@ -1,29 +0,0 @@
-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

@@ -1,184 +0,0 @@
-"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

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

package/dist/table.d.ts

@@ -1,81 +0,0 @@
-import { Datum } from './datum';
-import { Segment, Selector } from './selector';
-import { Flow } from './sink';
-export type Cell = {
-    readonly type: 'null';
-} | {
-    readonly type: 'bool';
-    readonly value: boolean;
-} | {
-    readonly type: 'number';
-    readonly value: number;
-    readonly lexeme: string | null;
-} | {
-    readonly type: 'string';
-    readonly value: string;
-} | {
-    readonly type: 'missing';
-};
-export declare const Cell: Readonly<{
-    null: {
-        readonly type: 'null';
-    };
-    missing: {
-        readonly type: 'missing';
-    };
-    bool(value: boolean): Cell;
-    number(value: number, lexeme?: string | null): Cell;
-    string(value: string): Cell;
-    fromDatum(d: Datum): Cell;
-    byteSize(c: Cell): number;
-    toText(c: Cell): string;
-}>;
-export type PublicColumn = {
-    label: string;
-};
-export type TableEvent = {
-    readonly type: 'schema';
-    readonly columns: readonly PublicColumn[];
-} | {
-    readonly type: 'row';
-    readonly cells: readonly Cell[];
-} | {
-    readonly type: 'end';
-};
-export interface TableSink {
-    tableEvent(ev: TableEvent): Flow;
-}
-export declare class Table implements TableSink {
-    columns: PublicColumn[];
-    rows: Cell[][];
-    ended: boolean;
-    tableEvent(ev: TableEvent): Flow;
-}
-export type MissingPolicy = 'missing' | 'null' | 'error';
-export type BoundColumn = {
-    label: string;
-    source: Segment[];
-    missing: MissingPolicy;
-};
-export declare function boundColumn(label: string, source: Segment[], missing?: MissingPolicy): BoundColumn;
-export type ColumnMapper = (meta: Datum) => BoundColumn;
-export type Schema = {
-    type: 'static';
-    columns: BoundColumn[];
-} | {
-    type: 'metadata';
-    columns: Selector;
-    column: ColumnMapper;
-} | {
-    type: 'infer';
-};
-export declare const Schema: Readonly<{
-    static(columns: BoundColumn[]): Schema;
-    fromMetadata(columns: Selector, column?: ColumnMapper): Schema;
-    infer(): Schema;
-}>;
-export type TableBinding = {
-    schema: Schema;
-    rows: Selector;
-};
-export declare function columnFromMeta(meta: Datum): BoundColumn;

package/dist/table.js

@@ -1,141 +0,0 @@
-"use strict";
-/* Copyright (c) 2026 tabnas, MIT License */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Schema = exports.Table = exports.Cell = void 0;
-exports.boundColumn = boundColumn;
-exports.columnFromMeta = columnFromMeta;
-// `TableRows/1`: one schema, ordered finite rows, completion.
-//
-// The protocol is flat and budgeted: a row is a finite vector of cells,
-// already projected into schema order by the transducer, and a renderer
-// never sees a source path. Public columns carry a label; the source
-// binding (`BoundColumn`) stays on the transducer's side of the boundary.
-const datum_1 = require("./datum");
-const error_1 = require("./error");
-const json_1 = require("./json");
-const limits_1 = require("./limits");
-const NULL = Object.freeze({ type: 'null' });
-const MISSING = Object.freeze({ type: 'missing' });
-exports.Cell = Object.freeze({
-    null: NULL,
-    missing: MISSING,
-    bool(value) {
-        return { type: 'bool', value };
-    },
-    number(value, lexeme) {
-        return { type: 'number', value, lexeme: lexeme ?? null };
-    },
-    string(value) {
-        return { type: 'string', value };
-    },
-    // From a retained value. A container is not a cell; it is serialized as
-    // compact JSON text, the lossy but unambiguous choice the standard
-    // binding makes and documents.
-    fromDatum(d) {
-        switch (d.type) {
-            case 'null':
-                return NULL;
-            case 'bool':
-                return { type: 'bool', value: d.value };
-            case 'number':
-                return { type: 'number', value: d.value, lexeme: d.lexeme };
-            case 'string':
-                return { type: 'string', value: d.value };
-            default:
-                return { type: 'string', value: (0, datum_1.toText)(d) };
-        }
-    },
-    // The bytes this cell retains, on the same basis as a datum's size.
-    byteSize(c) {
-        switch (c.type) {
-            case 'number':
-                return limits_1.NODE_BYTES + (null != c.lexeme ? (0, limits_1.utf8Bytes)(c.lexeme) : 8);
-            case 'string':
-                return limits_1.NODE_BYTES + (0, limits_1.utf8Bytes)(c.value);
-            default:
-                return limits_1.NODE_BYTES;
-        }
-    },
-    // The cell as JSON text; `missing` prints as `missing`.
-    toText(c) {
-        switch (c.type) {
-            case 'null':
-                return 'null';
-            case 'bool':
-                return String(c.value);
-            case 'number':
-                return (0, json_1.jsonNumber)(c.value, c.lexeme);
-            case 'string':
-                return (0, json_1.jsonString)(c.value);
-            case 'missing':
-                return 'missing';
-        }
-    },
-});
-// An owned recording of a table, for tests and small results.
-class Table {
-    constructor() {
-        this.columns = [];
-        this.rows = [];
-        this.ended = false;
-    }
-    tableEvent(ev) {
-        switch (ev.type) {
-            case 'schema':
-                this.columns = ev.columns.slice();
-                break;
-            case 'row':
-                this.rows.push(ev.cells.slice());
-                break;
-            case 'end':
-                this.ended = true;
-                break;
-        }
-        return 'continue';
-    }
-}
-exports.Table = Table;
-function boundColumn(label, source, missing = 'missing') {
-    return { label, source, missing };
-}
-exports.Schema = Object.freeze({
-    static(columns) {
-        return { type: 'static', columns };
-    },
-    fromMetadata(columns, column = columnFromMeta) {
-        return { type: 'metadata', columns, column };
-    },
-    infer() {
-        return { type: 'infer' };
-    },
-});
-// The standard mapping from a metadata descriptor to a column: the spec's
-// `column-from-meta`, reading `title` and a `path` of segments.
-function columnFromMeta(meta) {
-    if ('object' !== meta.type) {
-        throw error_1.Fail.input('a column descriptor is not an object');
-    }
-    const title = meta.members.get('title');
-    if (undefined === title || 'string' !== title.type) {
-        throw error_1.Fail.input('a column descriptor has no string "title"');
-    }
-    const label = title.value;
-    const path = meta.members.get('path');
-    if (undefined === path || 'array' !== path.type) {
-        throw error_1.Fail.input(`column ${JSON.stringify(label)} has no "path" array`);
-    }
-    const source = path.items.map((seg) => {
-        if ('string' === seg.type)
-            return seg.value;
-        if ('number' === seg.type &&
-            seg.value >= 0 &&
-            Number.isInteger(seg.value) &&
-            seg.value <= 0xffffffff) {
-            return seg.value;
-        }
-        throw error_1.Fail.input(`column ${JSON.stringify(label)} has a path segment that is neither a string nor a ` +
-            `non-negative integer: ${(0, datum_1.toText)(seg)}`);
-    });
-    return boundColumn(label, source);
-}
-//# sourceMappingURL=table.js.map

package/dist/table.js.map

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

package/dist/value.d.ts

@@ -1,16 +0,0 @@
-export type EngineScalar = {
-    type: 'null';
-} | {
-    type: 'bool';
-    value: boolean;
-} | {
-    type: 'number';
-    value: number;
-} | {
-    type: 'string';
-    value: string;
-};
-export declare function engineScalar(v: unknown): EngineScalar | undefined;
-export declare function isEngineContainer(v: unknown): boolean;
-export declare function isEngineMap(v: unknown): v is Record<string, unknown>;
-export declare function engineKeys(v: unknown): string[];

package/dist/value.js

@@ -1,96 +0,0 @@
-"use strict";
-/* Copyright (c) 2026 tabnas, MIT License */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.engineScalar = engineScalar;
-exports.isEngineContainer = isEngineContainer;
-exports.isEngineMap = isEngineMap;
-exports.engineKeys = engineKeys;
-// Reading the engine's values: what a tabnas parse returns in TypeScript.
-//
-// The engine builds plain JavaScript values: `null` and `undefined`,
-// booleans, numbers, strings, arrays and objects. A few grammars hand over
-// host types, which read as the scalars they stand for: a boxed `String`
-// (the engine's text annotation), a `BigInt`, and a TOML `Date`, which
-// reads as the source text it carries (`__toml__.src`), as the Rust
-// runtime's date does.
-//
-// An object's member order is its insertion order. A plain object
-// enumerates integer-like keys first whatever order they were written in,
-// so the engine records the order on the node under `map.ordered` (read
-// with `KEY_ORDER`); the sources switch that on, and `engineKeys` reads
-// it, falling back to `Object.keys`.
-// The engine's key-order side channel (`keyOrder` in @tabnas/parser).
-const KEY_ORDER = Symbol.for('tabnas.keyOrder');
-const NULL = { type: 'null' };
-// The value as a scalar, or `undefined` when it is a container.
-function engineScalar(v) {
-    switch (typeof v) {
-        case 'undefined':
-            return NULL;
-        case 'boolean':
-            return { type: 'bool', value: v };
-        case 'number':
-            return { type: 'number', value: v };
-        case 'bigint':
-            return { type: 'number', value: Number(v) };
-        case 'string':
-            return { type: 'string', value: v };
-        case 'object':
-            if (null === v)
-                return NULL;
-            if (Array.isArray(v))
-                return undefined;
-            if (v instanceof String)
-                return { type: 'string', value: v.valueOf() };
-            if (v instanceof Number)
-                return { type: 'number', value: v.valueOf() };
-            if (v instanceof Boolean)
-                return { type: 'bool', value: v.valueOf() };
-            if (v instanceof Date) {
-                const src = v.__toml__?.src;
-                return { type: 'string', value: 'string' === typeof src ? src : v.toJSON() ?? 'null' };
-            }
-            return undefined;
-        default:
-            // A function or a symbol has no JSON form.
-            return NULL;
-    }
-}
-// Whether the value is a container: an array, or an object that is no
-// scalar's host type.
-function isEngineContainer(v) {
-    return null !== v && 'object' === typeof v && undefined === engineScalar(v);
-}
-// Whether the value is a map (a container that is not an array).
-function isEngineMap(v) {
-    return isEngineContainer(v) && !Array.isArray(v);
-}
-// A map's member names, in insertion order: the engine's recorded order
-// where it kept one, each name once and only while the map still holds it,
-// then any member the record missed.
-function engineKeys(v) {
-    if (null === v || 'object' !== typeof v)
-        return [];
-    const own = Object.keys(v);
-    const order = v[KEY_ORDER];
-    if (!Array.isArray(order) || 0 === order.length)
-        return own;
-    const has = Object.prototype.hasOwnProperty;
-    const seen = new Set();
-    const out = [];
-    for (const k of order) {
-        const key = String(k);
-        if (seen.has(key) || !has.call(v, key))
-            continue;
-        seen.add(key);
-        out.push(key);
-    }
-    if (out.length !== own.length) {
-        for (const k of own) {
-            if (!seen.has(k))
-                out.push(k);
-        }
-    }
-    return out;
-}
-//# sourceMappingURL=value.js.map

package/dist/value.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"value.js","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":";AAAA,4CAA4C;;;;;;AAE5C,0EAA0E;AAC1E,EAAE;AACF,qEAAqE;AACrE,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,oEAAoE;AACpE,uBAAuB;AACvB,EAAE;AACF,kEAAkE;AAClE,0EAA0E;AAC1E,wEAAwE;AACxE,wEAAwE;AACxE,qCAAqC;AAErC,sEAAsE;AACtE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AAQ/C,MAAM,IAAI,GAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAE3C,gEAAgE;AAChE,sBAA6B,CAAU;IACrC,QAAQ,OAAO,CAAC,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,IAAI,CAAA;QACb,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACnC,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACrC,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7C,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACrC,KAAK,QAAQ;YACX,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAA;YACtC,IAAI,CAAC,YAAY,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAA;YACtE,IAAI,CAAC,YAAY,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAA;YACtE,IAAI,CAAC,YAAY,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAA;YACrE,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAI,CAAS,CAAC,QAAQ,EAAE,GAAG,CAAA;gBACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,MAAM,EAAE,CAAA;YACxF,CAAC;YACD,OAAO,SAAS,CAAA;QAClB;YACE,2CAA2C;YAC3C,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,sBAAsB;AACtB,2BAAkC,CAAU;IAC1C,OAAO,IAAI,KAAK,CAAC,IAAI,QAAQ,KAAK,OAAO,CAAC,IAAI,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED,iEAAiE;AACjE,qBAA4B,CAAU;IACpC,OAAO,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,wEAAwE;AACxE,2EAA2E;AAC3E,qCAAqC;AACrC,oBAA2B,CAAU;IACnC,IAAI,IAAI,KAAK,CAAC,IAAI,QAAQ,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAA;IACpC,MAAM,KAAK,GAAa,CAAS,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,GAAG,CAAA;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAA;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;YAAE,SAAQ;QAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACf,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}