@tabnas/transduce 0.1.0

package/dist/error.js

@@ -0,0 +1,169 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fail = exports.Code = void 0;
+exports.isFail = isFail;
+exports.engineCode = engineCode;
+exports.engineDetail = engineDetail;
+exports.enginePosition = enginePosition;
+// Failures, with stable codes.
+//
+// The code is the contract: scripts and agents branch on it, and every
+// renderer, transducer and host uses the same set. The message, path and
+// limit are informative. A code is never renamed, removed or repurposed;
+// one may be added.
+const CODES = [
+    'DSL_PARSE_ERROR',
+    'DSL_TYPE_ERROR',
+    'STREAM_REUSED',
+    'STREAMABILITY_UNKNOWN',
+    'INPUT_ORDER_VIOLATION',
+    'CAPTURE_OVERLAP_UNSUPPORTED',
+    'MISSING_VALUE',
+    'DUPLICATE_MEMBER',
+    'INVALID_NUMBER',
+    'PROTOCOL_ORDER_ERROR',
+    'TARGET_VALUE_UNREPRESENTABLE',
+    'RESOURCE_LIMIT_EXCEEDED',
+    'INPUT_INVALID',
+    'OUTPUT_FAILED',
+    'ABORTED',
+];
+const table = {};
+for (const c of CODES)
+    table[c] = c;
+table.ALL = Object.freeze([...CODES]);
+table.parse = (text) => CODES.includes(text) ? text : undefined;
+// The codes as constants: `Code.INPUT_INVALID`, and `Code.ALL`.
+exports.Code = Object.freeze(table);
+// A failure: a code, and what is known about where and why.
+//
+// `committedOutput` says whether bytes had already been written when the
+// failure was found: an incremental export cannot take them back, and the
+// caller must be told the output may be partial.
+class Fail extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'Fail';
+        this.code = code;
+        this.committedOutput = false;
+    }
+    // The failure with the source file its position is in.
+    inFile(file) {
+        this.file = file;
+        return this;
+    }
+    atPath(path) {
+        this.path = path;
+        return this;
+    }
+    at(row, col) {
+        this.row = row;
+        this.col = col;
+        return this;
+    }
+    committed() {
+        this.committedOutput = true;
+        return this;
+    }
+    // A limit failure, named after the `Limits` field that was passed.
+    static limit(name, value, message) {
+        const f = new Fail('RESOURCE_LIMIT_EXCEEDED', message);
+        f.limit = { name, value };
+        return f;
+    }
+    static protocol(message) {
+        return new Fail('PROTOCOL_ORDER_ERROR', message);
+    }
+    static input(message) {
+        return new Fail('INPUT_INVALID', message);
+    }
+    static output(message) {
+        return new Fail('OUTPUT_FAILED', message);
+    }
+    static aborted() {
+        return new Fail('ABORTED', 'the run was cancelled');
+    }
+    // The engine's own error, as an input failure carrying its code,
+    // position and report.
+    static fromTabnas(e) {
+        const f = new Fail('INPUT_INVALID', `${engineCode(e)}: ${engineDetail(e)}`);
+        const pos = enginePosition(e);
+        if (pos) {
+            f.row = pos.row;
+            f.col = pos.col;
+        }
+        return f;
+    }
+    // The failure as a plain object: `code`, `message`, and `path`, `limit`
+    // (`{name, value}`), `row`, `col`, `file`, `output` ("partial" or
+    // "none") when they apply. This is the shape hosts print.
+    toJSON() {
+        const out = {
+            code: this.code,
+            message: this.message,
+        };
+        if (null != this.path)
+            out.path = this.path;
+        if (null != this.limit)
+            out.limit = { name: this.limit.name, value: this.limit.value };
+        if (null != this.row)
+            out.row = this.row;
+        if (null != this.col)
+            out.col = this.col;
+        if (null != this.file)
+            out.file = this.file;
+        out.output = this.committedOutput ? 'partial' : 'none';
+        return out;
+    }
+    toString() {
+        let s = `${this.code}: ${this.message}`;
+        if (null != this.path)
+            s += ` at ${this.path}`;
+        if (null != this.file && null != this.row && null != this.col) {
+            s += ` (${this.file}:${this.row}:${this.col})`;
+        }
+        else if (null != this.row && null != this.col) {
+            s += ` (${this.row}:${this.col})`;
+        }
+        else if (null != this.file) {
+            s += ` (in ${this.file})`;
+        }
+        if (null != this.limit)
+            s += ` [${this.limit.name} = ${this.limit.value}]`;
+        return s;
+    }
+}
+exports.Fail = Fail;
+// Whether a thrown value is a `Fail`.
+function isFail(e) {
+    return e instanceof Fail;
+}
+// The engine error's code (`unexpected`, `cancel`, ...).
+function engineCode(e) {
+    return 'string' === typeof e?.code ? e.code : 'unknown';
+}
+// The engine error's one-line description, without the code.
+function engineDetail(e) {
+    let detail = '';
+    try {
+        if ('function' === typeof e?.toJSON)
+            detail = e.toJSON()?.message ?? '';
+    }
+    catch (_err) {
+        detail = '';
+    }
+    if ('' === detail)
+        detail = String(e?.message ?? e);
+    return detail.trimEnd();
+}
+// The engine error's 1-based position, when it has one.
+function enginePosition(e) {
+    const row = e?.lineNumber;
+    const col = e?.columnNumber;
+    if ('number' === typeof row && 0 < row) {
+        return { row, col: 'number' === typeof col ? col : 0 };
+    }
+    return undefined;
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

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

package/dist/event.d.ts

@@ -0,0 +1,56 @@
+export type JsonEvent = {
+    readonly type: 'object_start';
+} | {
+    readonly type: 'object_end';
+} | {
+    readonly type: 'array_start';
+} | {
+    readonly type: 'array_end';
+} | {
+    readonly type: 'key';
+    readonly key: string;
+} | {
+    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: 'end';
+};
+export type JsonEventType = JsonEvent['type'];
+export declare const Ev: Readonly<{
+    objectStart: {
+        readonly type: 'object_start';
+    };
+    objectEnd: {
+        readonly type: 'object_end';
+    };
+    arrayStart: {
+        readonly type: 'array_start';
+    };
+    arrayEnd: {
+        readonly type: 'array_end';
+    };
+    null: {
+        readonly type: 'null';
+    };
+    end: {
+        readonly type: 'end';
+    };
+    key(key: string): JsonEvent;
+    bool(value: boolean): JsonEvent;
+    number(value: number, lexeme?: string | null): JsonEvent;
+    string(value: string): JsonEvent;
+}>;
+export declare function isStart(ev: JsonEvent): boolean;
+export declare function isEnd(ev: JsonEvent): boolean;
+export declare function isScalar(ev: JsonEvent): boolean;
+export declare function eventEquals(a: JsonEvent, b: JsonEvent): boolean;
+export declare function eventText(ev: JsonEvent): string;

package/dist/event.js

@@ -0,0 +1,101 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ev = void 0;
+exports.isStart = isStart;
+exports.isEnd = isEnd;
+exports.isScalar = isScalar;
+exports.eventEquals = eventEquals;
+exports.eventText = eventText;
+// The events without a payload are shared, so emitting one allocates
+// nothing.
+const OBJECT_START = Object.freeze({ type: 'object_start' });
+const OBJECT_END = Object.freeze({ type: 'object_end' });
+const ARRAY_START = Object.freeze({ type: 'array_start' });
+const ARRAY_END = Object.freeze({ type: 'array_end' });
+const NULL = Object.freeze({ type: 'null' });
+const TRUE = Object.freeze({ type: 'bool', value: true });
+const FALSE = Object.freeze({ type: 'bool', value: false });
+const END = Object.freeze({ type: 'end' });
+// Constructors for every event.
+exports.Ev = Object.freeze({
+    objectStart: OBJECT_START,
+    objectEnd: OBJECT_END,
+    arrayStart: ARRAY_START,
+    arrayEnd: ARRAY_END,
+    null: NULL,
+    end: END,
+    key(key) {
+        return { type: 'key', key };
+    },
+    bool(value) {
+        return value ? TRUE : FALSE;
+    },
+    number(value, lexeme) {
+        return { type: 'number', value, lexeme: lexeme ?? null };
+    },
+    string(value) {
+        return { type: 'string', value };
+    },
+});
+// Whether the event opens a container.
+function isStart(ev) {
+    return 'object_start' === ev.type || 'array_start' === ev.type;
+}
+// Whether the event closes a container.
+function isEnd(ev) {
+    return 'object_end' === ev.type || 'array_end' === ev.type;
+}
+// Whether the event is a whole scalar value.
+function isScalar(ev) {
+    return ('null' === ev.type ||
+        'bool' === ev.type ||
+        'number' === ev.type ||
+        'string' === ev.type);
+}
+// Two events are equal: same type and payload. Numbers compare by
+// `Object.is` (so `-0` is not `0`) and lexeme.
+function eventEquals(a, b) {
+    if (a.type !== b.type)
+        return false;
+    switch (a.type) {
+        case 'key':
+            return a.key === b.key;
+        case 'bool':
+        case 'string':
+            return a.value === b.value;
+        case 'number':
+            return ((Object.is(a.value, b.value) ||
+                (Number.isNaN(a.value) && Number.isNaN(b.value))) &&
+                a.lexeme === b.lexeme);
+        default:
+            return true;
+    }
+}
+// The event as short text, for messages: `{`, `}`, `[`, `]`, `key "a"`,
+// a scalar as JSON, `end`.
+function eventText(ev) {
+    switch (ev.type) {
+        case 'object_start':
+            return '{';
+        case 'object_end':
+            return '}';
+        case 'array_start':
+            return '[';
+        case 'array_end':
+            return ']';
+        case 'key':
+            return 'key ' + JSON.stringify(ev.key);
+        case 'null':
+            return 'null';
+        case 'bool':
+            return String(ev.value);
+        case 'number':
+            return null != ev.lexeme ? ev.lexeme : String(ev.value);
+        case 'string':
+            return JSON.stringify(ev.value);
+        case 'end':
+            return 'end';
+    }
+}
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

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

package/dist/guard.d.ts

@@ -0,0 +1,20 @@
+import { JsonEvent } from './event';
+import { AbortFlag, Limits, Metrics } from './limits';
+import { Flow, Sink } from './sink';
+export declare class Guarded<S extends Sink> implements Sink {
+    readonly inner: S;
+    private maxDepth;
+    private maxKeyBytes;
+    private maxScalarBytes;
+    private abort;
+    private metrics;
+    private open;
+    private events;
+    private keys;
+    private scalars;
+    constructor(inner: S, limits: Limits, abort: AbortFlag, metrics: Metrics);
+    flush(): void;
+    depth(): number;
+    private scalar;
+    event(ev: JsonEvent): Flow;
+}

package/dist/guard.js

@@ -0,0 +1,90 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Guarded = void 0;
+// The source-side limits, applied to events as they are produced.
+//
+// Every source emits through a `Guarded` sink, so the three limits a source
+// owns (`max_depth`, `max_key_bytes`, `max_scalar_bytes`) are checked once,
+// in one place, whether the events come from a live parse or from a walk
+// over a parsed value; the abort flag is polled per event so a walk stops
+// as promptly as a parse does; and the source metrics (events, keys,
+// scalars) are counted locally and flushed in one step.
+const error_1 = require("./error");
+const limits_1 = require("./limits");
+// A sink wrapper that enforces the source limits and counts.
+class Guarded {
+    constructor(inner, limits, abort, metrics) {
+        this.open = 0;
+        this.events = 0;
+        this.keys = 0;
+        this.scalars = 0;
+        this.inner = inner;
+        this.maxDepth = limits.max_depth;
+        this.maxKeyBytes = limits.max_key_bytes;
+        this.maxScalarBytes = limits.max_scalar_bytes;
+        this.abort = abort;
+        this.metrics = metrics;
+    }
+    // Add the counts so far to the shared metrics and start again.
+    flush() {
+        this.metrics.events += this.events;
+        this.metrics.keys += this.keys;
+        this.metrics.scalars += this.scalars;
+        this.events = 0;
+        this.keys = 0;
+        this.scalars = 0;
+    }
+    // Open containers right now.
+    depth() {
+        return this.open;
+    }
+    scalar(bytes) {
+        this.scalars++;
+        if (bytes > this.maxScalarBytes) {
+            throw error_1.Fail.limit('max_scalar_bytes', this.maxScalarBytes, `a scalar of ${bytes} bytes is larger than ${this.maxScalarBytes}`);
+        }
+    }
+    event(ev) {
+        if (this.abort.isAborted())
+            throw error_1.Fail.aborted();
+        this.events++;
+        switch (ev.type) {
+            case 'object_start':
+            case 'array_start':
+                this.open++;
+                if (this.open > this.maxDepth) {
+                    throw error_1.Fail.limit('max_depth', this.maxDepth, `a container is nested deeper than ${this.maxDepth}`);
+                }
+                break;
+            case 'object_end':
+            case 'array_end':
+                this.open = Math.max(0, this.open - 1);
+                break;
+            case 'key': {
+                this.keys++;
+                const n = (0, limits_1.utf8Bytes)(ev.key);
+                if (n > this.maxKeyBytes) {
+                    throw error_1.Fail.limit('max_key_bytes', this.maxKeyBytes, `a key of ${n} bytes is longer than ${this.maxKeyBytes}`);
+                }
+                break;
+            }
+            case 'string':
+                this.scalar((0, limits_1.utf8Bytes)(ev.value));
+                break;
+            case 'number':
+                this.scalar(null != ev.lexeme ? (0, limits_1.utf8Bytes)(ev.lexeme) : 0);
+                break;
+            case 'null':
+            case 'bool':
+                this.scalar(0);
+                break;
+            case 'end':
+                this.flush();
+                break;
+        }
+        return this.inner.event(ev);
+    }
+}
+exports.Guarded = Guarded;
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":";AAAA,4CAA4C;;;AAE5C,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE;AACrE,wDAAwD;AAExD,mCAA8B;AAE9B,qCAAgE;AAGhE,6DAA6D;AAC7D;IAYE,YAAY,KAAQ,EAAE,MAAc,EAAE,KAAgB,EAAE,OAAgB;QALhE,SAAI,GAAG,CAAC,CAAA;QACR,WAAM,GAAG,CAAC,CAAA;QACV,SAAI,GAAG,CAAC,CAAA;QACR,YAAO,GAAG,CAAC,CAAA;QAGjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,aAAa,CAAA;QACvC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAA;QAC7C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,+DAA+D;IAC/D,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAA;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACf,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QACb,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;IAClB,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAEO,MAAM,CAAC,KAAa;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,IAAI,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,YAAI,CAAC,KAAK,CACd,kBAAkB,EAClB,IAAI,CAAC,cAAc,EACnB,eAAe,KAAK,yBAAyB,IAAI,CAAC,cAAc,EAAE,CACnE,CAAA;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,EAAa;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YAAE,MAAM,YAAI,CAAC,OAAO,EAAE,CAAA;QAChD,IAAI,CAAC,MAAM,EAAE,CAAA;QACb,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,cAAc,CAAC;YACpB,KAAK,aAAa;gBAChB,IAAI,CAAC,IAAI,EAAE,CAAA;gBACX,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC9B,MAAM,YAAI,CAAC,KAAK,CACd,WAAW,EACX,IAAI,CAAC,QAAQ,EACb,qCAAqC,IAAI,CAAC,QAAQ,EAAE,CACrD,CAAA;gBACH,CAAC;gBACD,MAAK;YACP,KAAK,YAAY,CAAC;YAClB,KAAK,WAAW;gBACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;gBACtC,MAAK;YACP,KAAK,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,IAAI,EAAE,CAAA;gBACX,MAAM,CAAC,GAAG,IAAA,kBAAS,EAAC,EAAE,CAAC,GAAG,CAAC,CAAA;gBAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;oBACzB,MAAM,YAAI,CAAC,KAAK,CACd,eAAe,EACf,IAAI,CAAC,WAAW,EAChB,YAAY,CAAC,yBAAyB,IAAI,CAAC,WAAW,EAAE,CACzD,CAAA;gBACH,CAAC;gBACD,MAAK;YACP,CAAC;YACD,KAAK,QAAQ;gBACX,IAAI,CAAC,MAAM,CAAC,IAAA,kBAAS,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;gBAChC,MAAK;YACP,KAAK,QAAQ;gBACX,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,kBAAS,EAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACzD,MAAK;YACP,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBACd,MAAK;YACP,KAAK,KAAK;gBACR,IAAI,CAAC,KAAK,EAAE,CAAA;gBACZ,MAAK;QACT,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/dist/json.d.ts

@@ -0,0 +1,4 @@
+export declare function jsonString(s: string): string;
+export declare function numberText(value: number): string;
+export declare function jsonNumber(value: number, lexeme: string | null | undefined): string;
+export declare function isJsonNumber(s: string): boolean;

package/dist/json.js

@@ -0,0 +1,92 @@
+"use strict";
+/* Copyright (c) 2026 tabnas, MIT License */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonString = jsonString;
+exports.numberText = numberText;
+exports.jsonNumber = jsonNumber;
+exports.isJsonNumber = isJsonNumber;
+// JSON text: the escaping and number spelling every runtime shares.
+// `s` as a JSON string literal, escaped as RFC 8259 requires: `"` and `\`
+// escaped, the short forms `\b \f \n \r \t`, other control characters as
+// `\u00XX` with lowercase hex, and everything else as itself.
+function jsonString(s) {
+    let out = '"';
+    let from = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c >= 0x20 && c !== 0x22 && c !== 0x5c)
+            continue;
+        if (i > from)
+            out += s.slice(from, i);
+        from = i + 1;
+        switch (c) {
+            case 0x22:
+                out += '\\"';
+                break;
+            case 0x5c:
+                out += '\\\\';
+                break;
+            case 0x08:
+                out += '\\b';
+                break;
+            case 0x0c:
+                out += '\\f';
+                break;
+            case 0x0a:
+                out += '\\n';
+                break;
+            case 0x0d:
+                out += '\\r';
+                break;
+            case 0x09:
+                out += '\\t';
+                break;
+            default:
+                out += '\\u' + c.toString(16).padStart(4, '0');
+        }
+    }
+    if (from < s.length)
+        out += s.slice(from);
+    return out + '"';
+}
+// A number with no lexeme, as text: the shortest digits that read back as
+// the same double, written positionally, never with an exponent (`1e21` is
+// `1000000000000000000000`, `1e-7` is `0.0000001`, `-0` is `-0`). This is
+// the spelling the Rust runtime's `f64` `Display` gives, so a container
+// cell holding such a number reads the same in every runtime;
+// `DIVERGENCE.md` keeps the decision open. A non-finite value has no JSON
+// form and is `null`.
+function numberText(value) {
+    if (!Number.isFinite(value))
+        return 'null';
+    if (Object.is(value, -0))
+        return '-0';
+    if (0 === value)
+        return '0';
+    const neg = value < 0;
+    const exp = Math.abs(value).toExponential();
+    const at = exp.indexOf('e');
+    const digits = exp.slice(0, at).replace('.', '');
+    const e = parseInt(exp.slice(at + 1), 10);
+    let text;
+    if (e >= digits.length - 1) {
+        text = digits + '0'.repeat(e - (digits.length - 1));
+    }
+    else if (e >= 0) {
+        text = digits.slice(0, e + 1) + '.' + digits.slice(e + 1);
+    }
+    else {
+        text = '0.' + '0'.repeat(-e - 1) + digits;
+    }
+    return neg ? '-' + text : text;
+}
+// A number as JSON text: its lexeme when known, else `numberText`.
+function jsonNumber(value, lexeme) {
+    return null != lexeme ? lexeme : numberText(value);
+}
+// RFC 8259's number grammar: `-?(0|[1-9][0-9]*)(\.[0-9]+)?([eE][+-]?[0-9]+)?`.
+// Only such a lexeme is kept, so a renderer can write it as it stands.
+function isJsonNumber(s) {
+    return /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/.test(s);
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/limits.d.ts

@@ -0,0 +1,36 @@
+export type Limits = {
+    max_depth: number;
+    max_key_bytes: number;
+    max_scalar_bytes: number;
+    max_metadata_bytes: number;
+    max_columns: number;
+    max_record_bytes: number;
+    max_capture_bytes: number;
+    max_output_bytes: number | null;
+};
+export declare const LIMIT_NAMES: readonly (keyof Limits)[];
+export declare const Limits: Readonly<{
+    default(): Limits;
+    unlimited(): Limits;
+    with(fields: Partial<Limits>): Limits;
+}>;
+export declare const NODE_BYTES = 16;
+export declare function utf8Bytes(s: string): number;
+export declare class Metrics {
+    events: number;
+    keys: number;
+    scalars: number;
+    rows: number;
+    captured_bytes: number;
+    captured_bytes_high: number;
+    retained_bytes_high: number;
+    output_bytes: number;
+    capture(bytes: number): void;
+    release(bytes: number): void;
+    toJSON(): Record<string, number>;
+}
+export declare class AbortFlag {
+    private aborted;
+    abort(): void;
+    isAborted(): boolean;
+}