toon-parser 2.2.1 → 3.0.0

package/dist/core.d.ts

@@ -0,0 +1,73 @@
+export type { JsonPrimitive } from './internal/types.js';
+export { ToonError } from './internal/errors.js';
+export { enforceInputLength } from './internal/security.js';
+export interface SecurityOptions {
+    /**
+     * Maximum nesting depth (objects + arrays). Defaults to 64.
+     */
+    maxDepth?: number;
+    /**
+     * Maximum allowed array length. Defaults to 50_000.
+     */
+    maxArrayLength?: number;
+    /**
+     * Maximum total nodes (object fields + array items) processed.
+     * Defaults to 250_000 to limit resource exhaustion.
+     */
+    maxTotalNodes?: number;
+    /**
+     * Keys that are rejected to avoid prototype pollution.
+     * Defaults to ["__proto__", "constructor", "prototype"].
+     */
+    disallowedKeys?: string[];
+    /**
+     * Maximum allowed length of a raw input string passed to a `*ToToon` /
+     * `*ToJson` decoder. Defaults to 5_000_000 (5 MB).
+     * Set to `Infinity` to disable.
+     */
+    maxInputLength?: number;
+}
+export interface JsonToToonOptions extends SecurityOptions {
+    /**
+     * Number of spaces per indentation level. Defaults to 2.
+     */
+    indent?: number;
+    /**
+     * Delimiter to use for inline arrays and tabular rows.
+     * Defaults to comma.
+     */
+    delimiter?: ',' | '|' | '\t';
+    /**
+     * When true, object keys are sorted alphabetically to keep output deterministic.
+     * Defaults to false (preserve encounter order).
+     */
+    sortKeys?: boolean;
+    /**
+     * TOON v3 §13.4 key folding. When `'safe'`, single-key object chains are folded
+     * into dotted paths (e.g. `{a:{b:{c:1}}}` -> `a.b.c: 1`) provided every segment
+     * matches the IdentifierSegment grammar. Defaults to `'off'`.
+     */
+    keyFolding?: 'off' | 'safe';
+    /**
+     * Maximum number of segments included in a folded path (counting from the
+     * outermost key). Has no practical effect below 2. Defaults to Infinity when
+     * `keyFolding` is `'safe'`.
+     */
+    flattenDepth?: number;
+}
+export interface ToonToJsonOptions extends SecurityOptions {
+    /**
+     * Enforce declared array lengths, field counts, and indentation consistency.
+     * Defaults to true.
+     */
+    strict?: boolean;
+    /**
+     * TOON v3 §13.4 path expansion. When `'safe'`, dotted keys are expanded into
+     * nested objects (e.g. `a.b.c: 1` -> `{a:{b:{c:1}}}`) provided every segment
+     * matches the IdentifierSegment grammar. Defaults to `'off'`.
+     */
+    expandPaths?: 'off' | 'safe';
+}
+export declare function jsonToToon(value: unknown, options?: JsonToToonOptions): string;
+export declare function toonToJson(text: string, options?: ToonToJsonOptions): unknown;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAoCA,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC9B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA0MlF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CA2YjF"}