@cbortech/cbor 0.26.6 → 0.26.7

package/dist/ast/CborTextString.d.ts

@@ -10,16 +10,36 @@ export declare class CborTextString extends CborItem {
     readonly ednParts: readonly string[] | undefined;
     /** Original raw-string source text, when parsed from a single backtick literal. */
     readonly ednSource: string | undefined;
+    /**
+     * Original double-quoted source text (including its escape sequences),
+     * when parsed from a single non-concatenated `"..."` literal. Used by
+     * `_toCDN()` to round-trip the literal's exact spelling when
+     * `preserveTextString` is set.
+     */
+    readonly quotedEdnSource: string | undefined;
     /**
      * Original source text per `ednParts` entry, aligned by index; `undefined`
      * for parts that were not raw backtick literals.
      */
     readonly ednPartSources: readonly (string | undefined)[] | undefined;
+    /**
+     * `true` at index `i`, aligned with `ednParts`, when that part came from a
+     * byte-string literal on the right of a text-leading `+` concatenation
+     * (decoded as UTF-8 and merged in per §5.1) rather than a double-quoted
+     * `"..."` literal. Both cases leave `ednPartSources[i]` `undefined` (byte
+     * strings have no preserved raw source here, same as an unpreserved
+     * double-quoted literal), so this is what lets `appSeqSourceFeatures`
+     * attribute the part to `byteString` instead of the unpreservable
+     * `textString`.
+     */
+    readonly ednPartIsByteString: readonly boolean[] | undefined;
     constructor(value: string, options?: {
         encodingWidth?: EncodingWidth;
         ednParts?: readonly string[];
         ednSource?: string;
+        quotedEdnSource?: string;
         ednPartSources?: readonly (string | undefined)[];
+        ednPartIsByteString?: readonly boolean[];
     });
     _encodeTo(writer: CborWriter, _options?: ToCBOROptions): void;
     _toCDN(options: ToCDNOptions | undefined, depth: number): string;

package/dist/ast/CborUint.d.ts

@@ -5,8 +5,16 @@ import { CborWriter, EncodingWidth } from '../cbor/encode';
 export declare class CborUint extends CborItem {
     readonly value: bigint;
     encodingWidth: EncodingWidth | undefined;
+    /**
+     * Original CDN digit spelling (base + digits, without the encoding-
+     * indicator suffix), set by the parser when this value came from CDN
+     * text. Used by `_toCDN()` to round-trip the literal's base (`0xff`,
+     * `0o377`, `0b101`, decimal) when `preserveNumberFormat` is set.
+     */
+    readonly ednSource?: string;
     constructor(value: number | bigint, options?: {
         encodingWidth?: EncodingWidth;
+        ednSource?: string;
     });
     _encodeTo(writer: CborWriter, _options?: ToCBOROptions): void;
     _toCDN(options: ToCDNOptions | undefined, _depth: number): string;

package/dist/ast/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../mapEntries-BhMlCwYo.cjs");exports.CborArray=e.E,exports.CborBigNint=e.v,exports.CborBigUint=e.y,exports.CborByteString=e.k,exports.CborEmbeddedCBOR=e.C,exports.CborFloat=e.j,exports.CborIndefiniteByteString=e.O,exports.CborIndefiniteTextString=e.D,exports.CborItem=e.F,exports.CborMap=e.T,exports.CborNint=e.N,exports.CborSimple=e.w,exports.CborTag=e.A,exports.CborTextString=e.g,exports.CborUint=e.P;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../mapEntries-D2NyeCX3.cjs");exports.CborArray=e.D,exports.CborBigNint=e._,exports.CborBigUint=e.v,exports.CborByteString=e.A,exports.CborEmbeddedCBOR=e.w,exports.CborFloat=e.M,exports.CborIndefiniteByteString=e.k,exports.CborIndefiniteTextString=e.O,exports.CborItem=e.I,exports.CborMap=e.E,exports.CborNint=e.P,exports.CborSimple=e.T,exports.CborTag=e.j,exports.CborTextString=e.h,exports.CborUint=e.F;

package/dist/ast/index.js

@@ -1,2 +1,2 @@
-import { A as e, C as t, D as n, E as r, F as i, N as a, O as o, P as s, T as c, g as l, j as u, k as d, v as f, w as p, y as m } from "../mapEntries-Czxt-cmd.js";
-export { r as CborArray, f as CborBigNint, m as CborBigUint, d as CborByteString, t as CborEmbeddedCBOR, u as CborFloat, o as CborIndefiniteByteString, n as CborIndefiniteTextString, i as CborItem, c as CborMap, a as CborNint, p as CborSimple, e as CborTag, l as CborTextString, s as CborUint };
+import { A as e, D as t, E as n, F as r, I as i, M as a, O as o, P as s, T as c, _ as l, h as u, j as d, k as f, v as p, w as m } from "../mapEntries-DxrDre2P.js";
+export { t as CborArray, l as CborBigNint, p as CborBigUint, e as CborByteString, m as CborEmbeddedCBOR, a as CborFloat, f as CborIndefiniteByteString, o as CborIndefiniteTextString, i as CborItem, n as CborMap, s as CborNint, c as CborSimple, d as CborTag, u as CborTextString, r as CborUint };

package/dist/cddl/index.cjs

@@ -1,3 +1,3 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../schema-BmGsaEaW.cjs");function t(e,t){let n=Math.max(0,Math.min(t,e.length)),r=1,i=0;for(let t=0;t<n;t++)e.charCodeAt(t)===10&&(r++,i=t+1);return{line:r,column:n-i+1}}var n=class{static compile(t,n){return e.n(t,n)}};function r(t){let n=new e.o(t),r=[];for(;;){let e=n.consume();if(e.type===`EOF`)break;r.push(e)}return{tokens:r,comments:n.comments}}function i(t){let n=new e.o(t),r=[];try{for(;;){let e=n.consume();if(e.type===`EOF`)break;r.push(e)}return{tokens:r,comments:n.comments}}catch(i){let a=i instanceof e.l?i:new e.l(i instanceof Error?i.message:String(i)),o=n.lastEndOffset;if(o<t.length){let e=1,n=1;for(let r=0;r<o;r++)t[r]===`
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../schema-t_bdPk8_.cjs");function t(e,t){let n=Math.max(0,Math.min(t,e.length)),r=1,i=0;for(let t=0;t<n;t++)e.charCodeAt(t)===10&&(r++,i=t+1);return{line:r,column:n-i+1}}var n=class{static compile(t,n){return e.n(t,n)}};function r(t){let n=new e.o(t),r=[];for(;;){let e=n.consume();if(e.type===`EOF`)break;r.push(e)}return{tokens:r,comments:n.comments}}function i(t){let n=new e.o(t),r=[];try{for(;;){let e=n.consume();if(e.type===`EOF`)break;r.push(e)}return{tokens:r,comments:n.comments}}catch(i){let a=i instanceof e.l?i:new e.l(i instanceof Error?i.message:String(i)),o=n.lastEndOffset;if(o<t.length){let e=1,n=1;for(let r=0;r<o;r++)t[r]===`
 `?(e++,n=1):n++;r.push({type:`ERROR`,value:t.slice(o),raw:t.slice(o),line:e,col:n,offset:o,endOffset:t.length})}return{tokens:r,comments:n.comments,error:a}}}exports.CDDL=n,exports.default=n,exports.CddlMismatchError=e.s,exports.CddlSchema=e.t,exports.CddlSemanticError=e.c,exports.CddlSyntaxError=e.l,exports.PRELUDE_CDDL=e.r,exports.getPreludeRules=e.i,exports.parseCDDL=e.a,exports.positionAt=t,exports.tokenize=r,exports.tokenizeLenient=i;
 //# sourceMappingURL=index.cjs.map

package/dist/cddl/index.js

@@ -1,4 +1,4 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../schema-BxkgvUY6.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../schema-Bofmsptw.js";
 //#region src/cddl/position.ts
 function l(e, t) {
 	let n = Math.max(0, Math.min(t, e.length)), r = 1, i = 0;

package/dist/cdn/serialize-utils.d.ts

@@ -13,6 +13,7 @@ export declare function indentOf(indentStr: string, depth: number): string;
 export declare function joinConcatParts(literals: readonly string[], indentStr: string | null, depth: number): string;
 export interface Commented {
     comments?: CborComments;
+    blankLineBefore?: boolean;
 }
 export declare function hasPreservedComments(item: Commented): boolean;
 export declare function hasContainerLayoutComments(item: Commented): boolean;
@@ -29,7 +30,24 @@ export declare function hasContainerLayoutComments(item: Commented): boolean;
  * this (e.g. `/**…*\/` → `/ *…/`).
  */
 export declare function convertCommentText(comment: CborComment, style: 'c-style' | 'cdn-style' | undefined): string;
-export declare function formatLeadingComments(item: Commented, indent: string, style?: 'c-style' | 'cdn-style' | undefined): string[];
+/**
+ * Split an item's leading comments into ones that get their own line above
+ * it, and a trailing run of comments the parser found on the same source
+ * line as the item itself (`CborComment.sameLine`) — e.g.
+ * `/ protected / << ... >>,` in an RFC 9052-style annotated array. Since
+ * comments and the item they lead up to appear in strictly increasing
+ * source order, `sameLine` comments always form a contiguous run at the end
+ * of the list (nothing can sit between a same-line comment and the item
+ * without itself being on that same line).
+ *
+ * `ownLines` renders like `formatLeadingComments` used to; `inlinePrefix` is
+ * meant to be prepended directly to the item's own rendered line (already
+ * includes a trailing space per comment, or `''` when there is none).
+ */
+export declare function splitLeadingComments(item: Commented, indent: string, style?: 'c-style' | 'cdn-style' | undefined): {
+    ownLines: string[];
+    inlinePrefix: string;
+};
 export declare function formatTrailingComments(item: Commented, style?: 'c-style' | 'cdn-style' | undefined): string;
 export declare function formatDanglingComments(item: Commented, indent: string, style?: 'c-style' | 'cdn-style' | undefined): string[];
 /**
@@ -59,26 +77,46 @@ export declare function resolveSeparators(options: ToCDNOptions | undefined, com
  * comments — line comments can only be terminated by a newline.
  *
  * Entries are accessed through per-index callbacks (not materialised entry
- * objects) so the common no-comments path allocates nothing per entry.
- * `hasEntryComments`, `entryLeadingNode`, and `entryTrailing` are consulted
- * only when `preserveComments` is set.  `renderEntry` receives the resolved
- * `colSep` (': ' or ':' depending on compact mode) for rendering map pairs.
+ * objects) so the common no-comments/no-blank-line path allocates nothing
+ * per entry. `hasEntryComments` and `entryTrailing` are consulted only when
+ * `preserveComments` is set; `entryLeadingNode` is also consulted when
+ * `preserveBlankLines` is set, independently of `preserveComments`, to read
+ * its `blankLineBefore` flag. `renderEntry` receives the resolved `colSep`
+ * (': ' or ':' depending on compact mode) for rendering map pairs.
  */
 export declare function serializeContainer(p: {
     node: Commented;
     options: ToCDNOptions | undefined;
     depth: number;
-    openChar: '[' | '{' | '(';
-    closeChar: ']' | '}' | ')';
+    openChar: string;
+    closeChar: string;
     count: number;
     indefiniteLength: boolean;
     encodingWidth: EncodingWidth | undefined;
+    /**
+     * Where the resolved encoding-indicator suffix is placed.
+     * - `'open'` (default): right after `openChar`, before the content
+     *   (`[_2 1,2,3]`) — the head this indicator describes encodes entry count.
+     * - `'close'`: right after `closeChar`, with no separating space
+     *   (`<<1,2>>_1`) — for `CborEmbeddedCBOR`, whose byte-string head encodes
+     *   content byte length, not entry count.
+     */
+    eiPosition?: 'open' | 'close';
+    /**
+     * Basis for canonical-encoding-width detection (`encodingIndicators:
+     * 'auto'`/`'always'` with no explicit `encodingWidth`). Defaults to
+     * `count`, matching the CBOR array/map head. `CborEmbeddedCBOR` overrides
+     * this to its encoded content's byte length instead.
+     */
+    canonicalCount?: () => bigint;
     hasEntryComments: () => boolean;
     /** Render entry `i` at child depth (`item` or `key: value`). */
     renderEntry: (i: number, colSep: string) => string;
     /**
      * Whether entry `i` contains no nested array/map, so it may stay on the
-     * container's line under `inlineLeafContainers`. Omitted = always a leaf.
+     * container's line under `inlineLeafContainers`. Omitted = always a leaf
+     * (used by `CborEmbeddedCBOR`, where an entry that is itself a container
+     * still inlines as long as its own rendering fits on one line).
      */
     entryIsLeaf?: (i: number) => boolean;
     /** Node whose leading comments are emitted above entry `i` (item / map key). */
@@ -86,7 +124,63 @@ export declare function serializeContainer(p: {
     /** Pre-formatted trailing comment text for entry `i` (starts with ' ', or ''). */
     entryTrailing: (i: number, style: 'c-style' | 'cdn-style' | undefined) => string;
 }): string;
+/**
+ * Single-child counterpart to `serializeContainer`, for a wrapper that
+ * holds exactly one child inside `openChar`/`closeChar` (currently just
+ * `CborTag`'s `(content)`) rather than a comma-separated list of entries.
+ *
+ * Emits the child's own leading/trailing comments, and the wrapper node's
+ * `dangling` comments (a comment positioned after the child but still
+ * inside the brackets, with nothing following it to attach to as leading —
+ * mirroring how `serializeContainer` handles a container's own dangling
+ * comments). Falls back to the plain single-line `(content)` form — the
+ * common, zero-allocation-beyond-string-concat path — when comments aren't
+ * requested/applicable (no indent, no `preserveComments`, or neither the
+ * child nor the wrapper has any).
+ *
+ * `renderChild` is called with the child's depth exactly once, resolved
+ * *before* calling it: `depth + 1` when comments force multi-line
+ * rendering, `depth` otherwise (matching a plain value's existing
+ * "transparent" nesting — `tag(content)` doesn't indent `content` an extra
+ * level when there's nothing to justify going multi-line for).
+ */
+export declare function renderSingleChildWithComments(child: Commented, wrapper: Commented, options: ToCDNOptions | undefined, depth: number, renderChild: (childDepth: number) => string, openChar: '(', closeChar: ')'): string;
 export declare function serializeBytes(bytes: Uint8Array, encoding?: 'hex' | 'base64' | 'base64url' | 'base32' | 'base32hex', sqstr?: 'printable-string' | 'string' | 'none'): string;
+/**
+ * Which comment syntax a byte-string literal's raw source recognizes —
+ * `undefined` when it has none at all (its content is data, not a comment
+ * host). Set once, at parse time, by whoever actually knows the literal's
+ * real origin (the tokenizer for `h'...'`/`b64'...'`/bare sqstr, or the
+ * parser comparing the resolved extension against the specific built-in
+ * `b32`/`h32` objects by reference — never guessed later from the prefix
+ * string, since a user extension can register under any prefix, including
+ * one a built-in also uses; see `CborByteString.ednCommentSyntax`).
+ *   - `'full'`: `#`, `//`, `/* *\/`, and `/ /` (§5.2.1/§5.3.3) — `h'...'`
+ *     and its backtick form, and the built-in `b32'...'`/`h32'...'`
+ *     extensions, which share hex's comment syntax (`utils/strip-comments.ts`).
+ *   - `'hash-only'`: only `#` line comments — standard base64 (`b64'...'`),
+ *     where `/` is valid data (e.g. `//8=` decodes to 0xFFFF), never a
+ *     comment marker (see Tokenizer._readByteContent, §5.2.2).
+ */
+export type ByteCommentSyntax = 'full' | 'hash-only';
+/**
+ * Strip comments from inside a preserved byte-string literal's raw source,
+ * keeping everything else — case, whitespace, `...` — untouched. Used when
+ * `preserveByteString` is set but `preserveComments` is not: the preserved
+ * spelling should still drop comments, the same as an unpreserved literal
+ * re-derived from its decoded value would. `syntax` selects the comment
+ * rules to apply (see `ByteCommentSyntax`); the caller is responsible for
+ * knowing which one is correct — this function does not guess from `raw`.
+ *
+ * Only scans the quote-delimited content (not the prefix or a trailing
+ * encoding-indicator suffix), and mirrors the tokenizer's own
+ * comment-recognition closely enough for realistic input; a comment
+ * containing a literal copy of the delimiter quote character is not
+ * specially handled (the input is already known-valid, so at worst this
+ * shifts where the content/comment boundary is drawn, never produces
+ * unparseable output).
+ */
+export declare function stripByteLiteralComments(raw: string, syntax: ByteCommentSyntax): string;
 /**
  * Produce a single-quoted EDN app-string content `'...'` from a string value.
  * Exported for use by app-extension `_toCDN` implementations.
@@ -114,3 +208,87 @@ export declare function canonicalEncodingWidth(n: bigint): EncodingWidth;
  * @param getCanonical  - lazily compute the canonical width (only called in 'always' mode)
  */
 export declare function resolveEiSuffix(options: ToCDNOptions | undefined, encodingWidth: EncodingWidth | undefined, getCanonical: () => EncodingWidth): string;
+/** How a node should render under `preserveAppSequence`. */
+export type AppSeqRenderDecision = 'verbatim' | 'adjusted' | 'source' | 'structural' | 'normal';
+interface AppSeqSourceFeatures {
+    byteString?: boolean;
+    textString?: boolean;
+    rawString?: boolean;
+    concatenation?: boolean;
+}
+/**
+ * Decide how an extension result node — from a `prefix'...'` /
+ * `` prefix`...` `` / `prefix<<...>>` source, or (for a tag-wrapper node
+ * that also has a generic `CborTag` fallback to delegate to) a raw tag
+ * literal `N(...)` — should render under `ToCDNOptions.preserveAppSequence`.
+ *
+ * A raw-tag source is recognised by `ednSource !== undefined`: the parser
+ * only ever sets a tag-wrapper's `ednSource` (the tag *number's* digit
+ * spelling) when it was reached via `N(...)`, never via one of the
+ * app-string/-sequence forms. Leaf (non-tag-wrapper) nodes have no raw-tag
+ * form at all — always pass `undefined` for `ednSource` there.
+ *
+ * Returns:
+ * - `'verbatim'`: re-emit `appSeqSource` as-is. Only reachable for a
+ *   raw-tag source: its encoding-indicator suffixes are nested at two
+ *   independent positions (tag number and inner content), so this is only
+ *   safe in `'auto'` mode with no relevant sibling option overridden.
+ * - `'source'`: keep a raw-tag source structurally verbatim, applying
+ *   comment and encoding-indicator changes by their captured source spans.
+ *   This avoids changing unrelated literal spelling or layout.
+ * - `'adjusted'`: for an app-string/-sequence source, strip whatever
+ *   *outer* indicator suffix is already at the end of `appSeqSource` (or,
+ *   under `'never'`, also an *inner* one immediately before `<<...>>`'s
+ *   closing `>>` — the app-sequence's sole item's own indicator) and let
+ *   the caller append one recomputed via `resolveEiSuffix`/`floatSuffix`
+ *   for the current mode via `adjustAppSeqIndicator` — correct in every
+ *   mode, without losing the source's notation family. (An inner indicator
+ *   can only be *stripped*, not *recomputed*: the item's own encoding
+ *   width isn't tracked once resolved to a plain date/address string, so
+ *   `'always'` cannot add a missing one — it is left absent.)
+ * - `'structural'`: keep the raw-tag notation *family* (as opposed to
+ *   upgrading to `prefix'...'`) but re-derive it structurally — via the
+ *   node's own `CborTag` rendering — instead of using `appSeqSource`
+ *   verbatim. Needed whenever verbatim text would ignore a sibling option
+ *   that must apply per nested node: an explicit `preserveNumberFormat` /
+ *   `preserveByteString` / `preserveTextString` / `preserveRawString` /
+ *   `preserveConcatenation` override.
+ *   Verbatim raw-tag text inherently contains the nested literal spelling.
+ * - `'normal'`: fall through to the class's own notation regeneration
+ *   (`prefix'...'`), unaffected by `preserveAppSequence`. For `<<...>>`,
+ *   this is also used when replaying its sole inner item would defeat an
+ *   explicitly disabled, relevant literal-preservation option.
+ *
+ * `editsComplete` (from `CborItem.appSeqEncodingEditsComplete`, raw-tag
+ * sources only) is `false` when the tag's content contains a node type
+ * `collectContentEncodingEdits` doesn't cover (e.g. a `CborMap` nested in an
+ * `ip` array's raw-tag content). `'source'` relies on those edits to apply
+ * `encodingIndicators: 'always'`/`'never'`, so incomplete coverage would
+ * silently leave the uncovered node's own indicator unchanged; `'structural'`
+ * is used instead, since it re-derives every nested indicator recursively.
+ */
+export declare function decideTaggedAppSeqRendering(options: ToCDNOptions | undefined, appSeqSource: string | undefined, ednSource: string | undefined, sourceFeatures?: AppSeqSourceFeatures, editsComplete?: boolean): AppSeqRenderDecision;
+/** Apply comment/EI options directly to a preserved raw-tag source. */
+export declare function adjustRawAppSeqSource(appSeqSource: string, options: ToCDNOptions | undefined, comments: readonly CborComment[] | undefined, encodingEdits: readonly {
+    start: number;
+    end: number;
+    always: string;
+    never: string;
+}[] | undefined): string;
+/**
+ * Adjust an `'adjusted'` app-string/-sequence source: apply requested comment
+ * conversion/removal by captured source span, strip the existing
+ * encoding-indicator suffix(es), then append `newSuffix` (the outer/wrapper
+ * indicator recomputed for the current mode) — see
+ * `decideTaggedAppSeqRendering`.
+ *
+ * Under `encodingIndicators: 'never'`, an inner (item-level) indicator is
+ * also stripped, using
+ * `innerItemEnd` (see `CborItem.appSeqInnerEnd`) to find it by its actual
+ * parsed position rather than by pattern-matching text near the closing
+ * `>>` — whitespace, a trailing comma, and/or a comment can all separate
+ * the two, in any combination, so a position-based cut is the only fully
+ * reliable way to locate it.
+ */
+export declare function adjustAppSeqIndicator(appSeqSource: string, newSuffix: string, options: ToCDNOptions | undefined, innerItemEnd: number | undefined, comments: readonly CborComment[] | undefined): string;
+export {};

package/dist/extensions/dt.d.ts

@@ -30,6 +30,7 @@ export declare const TAG_EPOCH = 1n;
 export declare class CborEpochDtExtUint extends CborUint {
     constructor(value: number | bigint, options?: {
         encodingWidth?: EncodingWidth;
+        ednSource?: string;
     });
     _toCDN(options: ToCDNOptions | undefined, _depth: number): string;
 }
@@ -40,6 +41,7 @@ export declare class CborEpochDtExtUint extends CborUint {
 export declare class CborEpochDtExtNint extends CborNint {
     constructor(value: number | bigint, options?: {
         encodingWidth?: EncodingWidth;
+        ednSource?: string;
     });
     _toCDN(options: ToCDNOptions | undefined, _depth: number): string;
 }
@@ -50,6 +52,7 @@ export declare class CborEpochDtExtNint extends CborNint {
 export declare class CborEpochDtExtFloat extends CborFloat {
     constructor(value: number, options?: {
         precision?: 'half' | 'single' | 'double';
+        literalSource?: string;
     });
     _toCDN(options: ToCDNOptions | undefined, _depth: number): string;
 }

package/dist/extensions/types.d.ts

@@ -52,17 +52,39 @@ export interface CborExtension {
      */
     parseAppSequence?(prefix: string, items: CborItem[], onError?: (msg: string) => void): CborItem;
     /**
-     * When `true`, the CDN parser wraps the result of `parseAppSequence` in a
-     * `CborAppSeqResult` so that `toCDN()` round-trips the original
-     * `prefix<<...>>` notation when `appStrings !== false`. In single-line
-     * output (no `indent`), a source spelling that spans multiple lines falls
-     * back to serializing the resolved item instead.
+     * Controls how the CDN parser preserves the original application-string
+     * / -sequence / raw-tag source text — `prefix'...'`, `` prefix`...` ``,
+     * `prefix<<...>>`, or a raw tag literal `N(...)` resolved via `parseTag`
+     * — for round-tripping through `toCDN()`.
      *
-     * Extensions whose result is already a subclass that handles source
-     * preservation itself (e.g. `CborFloat` via its `ednSource` property) should
-     * leave this unset.
+     * - `true`: the parser wraps the result of `parseAppSequence` (only —
+     *   `parseAppString` and `parseTag` results are unaffected) in a
+     *   `CborAppSeqResult`, which round-trips the original `<<...>>` notation
+     *   unconditionally whenever `appStrings !== false` (no extra option
+     *   needed). Use this when the result has no dedicated subclass whose
+     *   identity callers rely on (e.g. `instanceof` checks) — the wrapper
+     *   changes the returned node's type.
+     * - `'optional'`: for `parseAppString`, `parseAppSequence`, and `parseTag`
+     *   results alike, the parser instead sets `appSeqSource` directly on the
+     *   *same* result node (preserving its class/identity) and leaves it to
+     *   the node's own `_toCDN()` override to decide whether to use it — by
+     *   convention, only when `ToCDNOptions.preserveAppSequence` is set, so
+     *   the default output keeps regenerating `prefix'...'` form from the
+     *   resolved value. This covers a `` prefix`...` `` (backtick) source, a
+     *   non-canonically-spelled `prefix'...'` source, and a raw tag literal
+     *   (e.g. `1(1749772800)`) that would otherwise be upgraded to
+     *   `prefix'...'` notation — not just `<<...>>`. Use this when the result
+     *   is a dedicated subclass whose default behavior is to regenerate its
+     *   notation from the resolved value on every call.
+     * - `undefined` (default): neither happens. Extensions whose result
+     *   already handles source preservation itself (e.g. `CborFloat` via its
+     *   own `ednSource` property) should leave this unset.
+     *
+     * In single-line output (no `indent`), a source spelling that spans
+     * multiple lines always falls back to serializing the resolved item,
+     * regardless of mode.
      */
-    readonly preserveAppSeqSource?: boolean;
+    readonly preserveAppSeqSource?: boolean | 'optional';
     /**
      * Called when a `CborTag` is encountered during CBOR decode (`fromCBOR`)
      * or EDN integer-tag parsing (`fromCDN`).

package/dist/index.cjs

@@ -1,10 +1,10 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./tokenizer-EciPlN0n.cjs"),t=require("./schema-BmGsaEaW.cjs"),n=require("./mapEntries-BhMlCwYo.cjs");var r=`ABCDEFGHIJKLMNOPQRSTUVWXYZ234567`,i=`0123456789ABCDEFGHIJKLMNOPQRSTUV`;function a(e){let t=e.length;for(;t>0&&e.charCodeAt(t-1)===61;)t--;return e.slice(0,t)}function o(e,t,n){let r=a(e).toUpperCase(),i=r.length%8;if(i===1||i===3||i===6)throw SyntaxError(`invalid base32 length: ${r.length} characters`);let o=new Uint8Array(128).fill(255);for(let e=0;e<t.length;e++)o[t.charCodeAt(e)]=e;let s=new Uint8Array(Math.floor(r.length*5/8)),c=0,l=0,u=0;for(let e of r){let t=e.charCodeAt(0),n=t<128?o[t]:255;if(n===255)throw SyntaxError(`invalid character in byte string: ${JSON.stringify(e)}`);c=c<<5|n,l+=5,l>=8&&(l-=8,s[u++]=c>>l&255)}if(l>0&&c&(1<<l)-1){let e=`non-zero trailing bits in base32 input`;if(n)n(e);else throw SyntaxError(e)}return s}var s={appStringPrefixes:[`b32`],parseAppString(e,t,i){return new n.k(o(n.o(t),r,i),{ednEncoding:`base32`})}},c={appStringPrefixes:[`h32`],parseAppString(e,t,r){return new n.k(o(n.o(t),i,r),{ednEncoding:`base32hex`})}};function l(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n++)if(e[n]!==t[n])return!1;return!0}var u={appStringPrefixes:[`same`],preserveAppSeqSource:!0,parseAppSequence(e,t,n){if(t.length===0)throw SyntaxError(`same<<...>> requires at least one item`);let r=t[0],i=r.toCBOR();for(let e=1;e<t.length;e++)if(!l(i,t[e].toCBOR())){let t=`same<<...>>: item ${e} produces different CBOR bytes than item 0`;if(n)n(t);else throw SyntaxError(t)}return r}},d=new Map,f=64;function p(e){if(typeof e!=`string`)return e;let n=d.get(e);return n||(n=t.n(e),d.size>=f&&d.delete(d.keys().next().value),d.set(e,n)),n}function m(e,n,r){if(n){let i=n.validate(e,r);if(!i.valid)throw new t.s(i.errors,i.warnings)}return e}function h(e,t){return m(e,p(t?.cddl),t?.cddlValidationOptions)}var g=class t{static OMIT=n.R;static TAG=n.z;static Tag=n.V;static Simple=n.L;static MapEntries=n.t;static dt_as_Date=n.h;#e;constructor(e){this.#e=e??{}}#t(e){return{...this.#e,...e??{}}}fromCBOR(e,n){let r=t.fromCBOR(e,this.#t(n));return r._defaults=this.#e,r}fromCDN(e,n){let r=t.fromCDN(e,this.#t(n));return r._defaults=this.#e,r}fromEDN(e,t){return this.fromCDN(e,t)}fromJS(e,n){let r=t.fromJS(e,this.#t(n));return r._defaults=this.#e,r}fromHexDump(e,n){let r=t.fromHexDump(e,this.#t(n));return r._defaults=this.#e,r}*fromCBORSeq(e,n){for(let r of t.fromCBORSeq(e,this.#t(n)))r._defaults=this.#e,yield r}*fromCDNSeq(e,n){for(let r of t.fromCDNSeq(e,this.#t(n)))r._defaults=this.#e,yield r}*fromHexDumpSeq(e,n){for(let r of t.fromHexDumpSeq(e,this.#t(n)))r._defaults=this.#e,yield r}decode(e,n){return t.decode(e,this.#t(n))}*decodeSeq(e,n){yield*t.decodeSeq(e,this.#t(n))}*parseSeq(e,n){yield*t.parseSeq(e,this.#t(n))}encode(e,n){return t.encode(e,this.#t(n))}compile(e,n){return t.compile(e,this.#t(n))}decompile(e,n){return t.decompile(e,this.#t(n))}toHex(e,n){return t.toHex(e,this.#t(n))}fromHex(e,n){return t.fromHex(e,this.#t(n))}validate(e,n){return t.validate(e,this.#t(n))}cborToCborEdn(e,t){return this.cborToCdn(e,t)}cborToCdn(e,n){let r=this.#t(n),i=t.fromCBOR(e,r);return i._defaults=this.#e,i.toCDN(r)}cborEdnToCbor(e,t){return this.cdnToCbor(e,t)}cdnToCbor(e,n){let r=this.#t(n);return t.fromCDN(e,r).toCBOR(r)}parse(e,n){if(typeof n==`function`){let r=this.#t({reviver:n});return t.fromCDN(e,r).toJS(r)}let r=this.#t(n);return t.fromCDN(e,r).toJS(r)}stringify(e,n,r){if(typeof n==`function`||Array.isArray(n)||n===null||n===void 0&&r!==void 0){let i={...this.#e};return n===null?i.replacer=void 0:(typeof n==`function`||Array.isArray(n))&&(i.replacer=n),r!==void 0&&(i.indent=C(r)),t.stringify(e,i)}return t.stringify(e,this.#t(n??void 0))}format(e,n){return t.format(e,this.#t(n))}static fromCBOR(e,t){return h(n.d(e,t),t)}static fromCDN(e,t){return h(n._(e,t),t)}static fromEDN(e,n){return t.fromCDN(e,n)}static*fromHexDumpSeq(e,n){let r=[],i=_(e).trim().split(/\s+/).filter(Boolean);for(let e of i)if(/^[0-9A-Fa-f]{2}$/.test(e))r.push(parseInt(e,16));else if(/^[0-9A-Fa-f]+$/.test(e)&&e.length%2==0)for(let t=0;t<e.length;t+=2)r.push(parseInt(e.slice(t,t+2),16));else throw SyntaxError(`Invalid hex token in dump: ${JSON.stringify(e)}`);yield*t.fromCBORSeq(new Uint8Array(r),n)}static*fromCBORSeq(e,t){let r=p(t?.cddl),i=e instanceof ArrayBuffer||typeof SharedArrayBuffer<`u`&&e instanceof SharedArrayBuffer?new Uint8Array(e):new Uint8Array(e.buffer,e.byteOffset,e.byteLength),a=0;for(;a<i.byteLength;){let e=n.d(i,{...t,offset:a,allowTrailing:!0});yield m(e,r,t?.cddlValidationOptions),a=e.end}}static*fromCDNSeq(t,r){let i=p(r?.cddl),a=!!r?.preserveComments,o=0,s=!0;for(;;){let{offset:c,hadSeparator:l,commaOffset:u}=S(t,o,r,a?s?`all`:`after-newline`:`none`);if(s&&u>=0){let e=`leading comma in CDN sequence`;if(r?.strict!==!1)throw SyntaxError(e);b(e,u,r)}if(c>=t.length||a&&x(t,c)&&S(t,c,r).offset>=t.length)break;if(!s&&!l){let e=`CDN sequence items must be separated by whitespace, comma, or comment`;if(r?.strict!==!1)throw SyntaxError(e);b(e,c,r)}o=c;let d;try{d=n._(t,{...r,offset:o,allowTrailing:!0,_skipRS:!0})}catch(t){if(r?.strict!==!1)throw t;b(t instanceof Error?t.message:String(t),o,r,!0,t instanceof e.o?t:void 0);break}yield m(d,i,r?.cddlValidationOptions),o=d.end,s=!1}}static fromJS(e,t){return h(n.r(e,t),t)}static fromHexDump(e,t){let r=[],i=_(e).trim().split(/\s+/).filter(Boolean);for(let e of i)if(/^[0-9A-Fa-f]{2}$/.test(e))r.push(parseInt(e,16));else if(/^[0-9A-Fa-f]+$/.test(e)&&e.length%2==0)for(let t=0;t<e.length;t+=2)r.push(parseInt(e.slice(t,t+2),16));else throw SyntaxError(`Invalid hex token in dump: ${JSON.stringify(e)}`);return h(n.d(new Uint8Array(r),t),t)}static decode(e,n){return t.fromCBOR(e,n).toJS(n)}static*decodeSeq(e,n){for(let r of t.fromCBORSeq(e,n))yield r.toJS(n)}static*parseSeq(e,n){for(let r of t.fromCDNSeq(e,n))yield r.toJS(n)}static encode(e,n){return t.fromJS(e,n).toCBOR(n)}static compile(e,n){let r=[...t.fromCDNSeq(e,n)].map(e=>e.toCBOR(n)),i=r.reduce((e,t)=>e+t.length,0),a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.length;return a}static decompile(e,n){return[...t.fromCBORSeq(e,n)].map(e=>e.toCDN(n)).join(`
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./tokenizer-EciPlN0n.cjs"),t=require("./schema-t_bdPk8_.cjs"),n=require("./mapEntries-D2NyeCX3.cjs");function r(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n++)if(e[n]!==t[n])return!1;return!0}var i={appStringPrefixes:[`same`],preserveAppSeqSource:!0,parseAppSequence(e,t,n){if(t.length===0)throw SyntaxError(`same<<...>> requires at least one item`);let i=t[0],a=i.toCBOR();for(let e=1;e<t.length;e++)if(!r(a,t[e].toCBOR())){let t=`same<<...>>: item ${e} produces different CBOR bytes than item 0`;if(n)n(t);else throw SyntaxError(t)}return i}},a=new Map,o=64;function s(e){if(typeof e!=`string`)return e;let n=a.get(e);return n||(n=t.n(e),a.size>=o&&a.delete(a.keys().next().value),a.set(e,n)),n}function c(e,n,r){if(n){let i=n.validate(e,r);if(!i.valid)throw new t.s(i.errors,i.warnings)}return e}function l(e,t){return c(e,s(t?.cddl),t?.cddlValidationOptions)}var u=class t{static OMIT=n.z;static TAG=n.B;static Tag=n.H;static Simple=n.R;static MapEntries=n.t;static dt_as_Date=n.m;#e;constructor(e){this.#e=e??{}}#t(e){return{...this.#e,...e??{}}}fromCBOR(e,n){let r=t.fromCBOR(e,this.#t(n));return r._defaults=this.#e,r}fromCDN(e,n){let r=t.fromCDN(e,this.#t(n));return r._defaults=this.#e,r}fromEDN(e,t){return this.fromCDN(e,t)}fromJS(e,n){let r=t.fromJS(e,this.#t(n));return r._defaults=this.#e,r}fromHexDump(e,n){let r=t.fromHexDump(e,this.#t(n));return r._defaults=this.#e,r}*fromCBORSeq(e,n){for(let r of t.fromCBORSeq(e,this.#t(n)))r._defaults=this.#e,yield r}*fromCDNSeq(e,n){for(let r of t.fromCDNSeq(e,this.#t(n)))r._defaults=this.#e,yield r}*fromHexDumpSeq(e,n){for(let r of t.fromHexDumpSeq(e,this.#t(n)))r._defaults=this.#e,yield r}decode(e,n){return t.decode(e,this.#t(n))}*decodeSeq(e,n){yield*t.decodeSeq(e,this.#t(n))}*parseSeq(e,n){yield*t.parseSeq(e,this.#t(n))}encode(e,n){return t.encode(e,this.#t(n))}compile(e,n){return t.compile(e,this.#t(n))}decompile(e,n){return t.decompile(e,this.#t(n))}toHex(e,n){return t.toHex(e,this.#t(n))}fromHex(e,n){return t.fromHex(e,this.#t(n))}validate(e,n){return t.validate(e,this.#t(n))}cborToCborEdn(e,t){return this.cborToCdn(e,t)}cborToCdn(e,n){let r=this.#t(n),i=t.fromCBOR(e,r);return i._defaults=this.#e,i.toCDN(r)}cborEdnToCbor(e,t){return this.cdnToCbor(e,t)}cdnToCbor(e,n){let r=this.#t(n);return t.fromCDN(e,r).toCBOR(r)}parse(e,n){if(typeof n==`function`){let r=this.#t({reviver:n});return t.fromCDN(e,r).toJS(r)}let r=this.#t(n);return t.fromCDN(e,r).toJS(r)}stringify(e,n,r){if(typeof n==`function`||Array.isArray(n)||n===null||n===void 0&&r!==void 0){let i={...this.#e};return n===null?i.replacer=void 0:(typeof n==`function`||Array.isArray(n))&&(i.replacer=n),r!==void 0&&(i.indent=_(r)),t.stringify(e,i)}return t.stringify(e,this.#t(n??void 0))}format(e,n){return t.format(e,this.#t(n))}static fromCBOR(e,t){return l(n.u(e,t),t)}static fromCDN(e,t){return l(n.g(e,t),t)}static fromEDN(e,n){return t.fromCDN(e,n)}static*fromHexDumpSeq(e,n){let r=[],i=d(e).trim().split(/\s+/).filter(Boolean);for(let e of i)if(/^[0-9A-Fa-f]{2}$/.test(e))r.push(parseInt(e,16));else if(/^[0-9A-Fa-f]+$/.test(e)&&e.length%2==0)for(let t=0;t<e.length;t+=2)r.push(parseInt(e.slice(t,t+2),16));else throw SyntaxError(`Invalid hex token in dump: ${JSON.stringify(e)}`);yield*t.fromCBORSeq(new Uint8Array(r),n)}static*fromCBORSeq(e,t){let r=s(t?.cddl),i=e instanceof ArrayBuffer||typeof SharedArrayBuffer<`u`&&e instanceof SharedArrayBuffer?new Uint8Array(e):new Uint8Array(e.buffer,e.byteOffset,e.byteLength),a=0;for(;a<i.byteLength;){let e=n.u(i,{...t,offset:a,allowTrailing:!0});yield c(e,r,t?.cddlValidationOptions),a=e.end}}static*fromCDNSeq(t,r){let i=s(r?.cddl),a=!!r?.preserveComments,o=0,l=!0;for(;;){let{offset:s,hadSeparator:u,commaOffset:d}=g(t,o,r,a?l?`all`:`after-newline`:`none`);if(l&&d>=0){let e=`leading comma in CDN sequence`;if(r?.strict!==!1)throw SyntaxError(e);m(e,d,r)}if(s>=t.length||a&&h(t,s)&&g(t,s,r).offset>=t.length)break;if(!l&&!u){let e=`CDN sequence items must be separated by whitespace, comma, or comment`;if(r?.strict!==!1)throw SyntaxError(e);m(e,s,r)}o=s;let f;try{f=n.g(t,{...r,offset:o,allowTrailing:!0,_skipRS:!0})}catch(t){if(r?.strict!==!1)throw t;m(t instanceof Error?t.message:String(t),o,r,!0,t instanceof e.o?t:void 0);break}yield c(f,i,r?.cddlValidationOptions),o=f.end,l=!1}}static fromJS(e,t){return l(n.r(e,t),t)}static fromHexDump(e,t){let r=[],i=d(e).trim().split(/\s+/).filter(Boolean);for(let e of i)if(/^[0-9A-Fa-f]{2}$/.test(e))r.push(parseInt(e,16));else if(/^[0-9A-Fa-f]+$/.test(e)&&e.length%2==0)for(let t=0;t<e.length;t+=2)r.push(parseInt(e.slice(t,t+2),16));else throw SyntaxError(`Invalid hex token in dump: ${JSON.stringify(e)}`);return l(n.u(new Uint8Array(r),t),t)}static decode(e,n){return t.fromCBOR(e,n).toJS(n)}static*decodeSeq(e,n){for(let r of t.fromCBORSeq(e,n))yield r.toJS(n)}static*parseSeq(e,n){for(let r of t.fromCDNSeq(e,n))yield r.toJS(n)}static encode(e,n){return t.fromJS(e,n).toCBOR(n)}static compile(e,n){let r=[...t.fromCDNSeq(e,n)].map(e=>e.toCBOR(n)),i=r.reduce((e,t)=>e+t.length,0),a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.length;return a}static decompile(e,n){return[...t.fromCBORSeq(e,n)].map(e=>e.toCDN(n)).join(`
 `)}static toHex(e,n){return[...t.fromCBORSeq(e,n)].map(e=>e.toHexDump(n)).join(`
-`)}static fromHex(e,n){let r=[...t.fromHexDumpSeq(e,n)].map(e=>e.toCBOR(n)),i=r.reduce((e,t)=>e+t.length,0),a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.length;return a}static validate(n,r){let i=[],a=[],o,s={strict:!1,extensions:r?.extensions,builtinExtensions:r?.builtinExtensions,onWarning:e=>{if(`hint`in e&&e.hint){a.push(e);return}if(`fatal`in e&&e.fatal){o=e;return}i.push(e)}},c=p(r?.cddl),l=[],u=[],d=e=>{if(!c)return;let t=c.validate(e,r?.cddlValidationOptions);l.push(...t.errors),t.warnings&&u.push(...t.warnings)},f=c?{cddlErrors:l,cddlWarnings:u}:{},m=0;try{let e=r?.type??`cbor`;if(e===`cdn`){let e={...s,unresolvedExtension:r?.unresolvedExtension};for(let r of t.fromCDNSeq(n,e))m++,d(r)}else if(e===`hex`)for(let e of t.fromHexDumpSeq(n,s))m++,d(e);else for(let e of t.fromCBORSeq(n,s))m++,d(e)}catch(e){return{valid:!1,count:m,warnings:i,hints:a,error:e instanceof Error?e:Error(String(e)),...f}}if(o){let t=o.cause instanceof Error?o.cause:new e.o(o.message,{offset:o.offset});return{valid:!1,count:m,warnings:i,hints:a,error:t,...f}}return{valid:i.length===0&&l.length===0,count:m,warnings:i,hints:a,...f}}static cborToCdn(e,n){return t.fromCBOR(e,n).toCDN(n)}static cborToCborEdn(e,n){return t.fromCBOR(e,n).toCDN(n)}static cdnToCbor(e,n){return t.fromCDN(e,n).toCBOR(n)}static cborEdnToCbor(e,n){return t.fromCDN(e,n).toCBOR(n)}static parse(e,n){return typeof n==`function`?t.fromCDN(e).toJS({reviver:n}):t.fromCDN(e,n).toJS(n)}static stringify(e,t,r){if(typeof t==`function`||Array.isArray(t)||t===null||t===void 0&&r!==void 0){let i=typeof t==`function`||Array.isArray(t)?t:void 0,a=C(r);if(i){let t=n.n(e,i);return t===void 0||t===n.R?void 0:n.r(t).toCDN(a===void 0?void 0:{indent:a})}return n.r(e).toCDN(a===void 0?void 0:{indent:a})}let i=t;if(i?.replacer){let t=n.n(e,i.replacer,i.extensions,i.undefinedOmits,i.builtinExtensions);if(t===void 0||t===n.R)return;let{replacer:r,...a}=i;return h(n.r(t,Object.keys(a).length>0?a:void 0),i).toCDN(i)}return h(n.r(e,i),i).toCDN(i)}static format(e,n){return t.fromCDN(e,n).toCDN(n)}};function _(e){let t=``,n=0;for(;n<e.length;){let r=e[n],i=e[n+1]??``;if(r===`-`&&i===`-`){n=v(e,n+2),t+=` `;continue}if(r===`—`){n=v(e,n+1),t+=` `;continue}if(r===`#`){n=v(e,n+1),t+=` `;continue}if(r===`/`&&i===`/`){n=v(e,n+2),t+=` `;continue}if(r===`/`&&i===`*`){let r=e.indexOf(`*/`,n+2);if(r<0)throw SyntaxError(`Unterminated comment in hex dump`);t+=y(e.slice(n,r+2)),n=r+2;continue}if(r===`/`){let r=e.indexOf(`/`,n+1);if(r<0)throw SyntaxError(`Unterminated comment in hex dump`);t+=y(e.slice(n,r+1)),n=r+1;continue}t+=r,n++}return t}function v(e,t){let n=e.indexOf(`
-`,t);return n<0?e.length:n}function y(e){return e.replace(/[^\r\n]/g,` `)}function b(e,t,n,r,i){let a=i?.offset??t,o={message:e,offset:a};r&&(o.fatal=!0),i&&(o.cause=i),i?.offset!==void 0&&(o.line=i.line,o.column=i.column,o.endOffset=i.endOffset),n?.onWarning?n.onWarning(o):n?.silent||console.warn(`CDN sequence warning at offset ${a}: ${e}`)}function x(e,t){let n=e[t];return n===`#`||n===`/`}function S(e,t,n,r=`none`){let i=t,a=!1,o=!1,s=!1,c=-1,l=()=>r===`all`||r===`after-newline`&&s;for(;i<e.length;){let t=e[i];if(t===` `||t===`	`||t===`\r`||t===``){a=!0,i++;continue}if(t===`
+`)}static fromHex(e,n){let r=[...t.fromHexDumpSeq(e,n)].map(e=>e.toCBOR(n)),i=r.reduce((e,t)=>e+t.length,0),a=new Uint8Array(i),o=0;for(let e of r)a.set(e,o),o+=e.length;return a}static validate(n,r){let i=[],a=[],o,c={strict:!1,extensions:r?.extensions,builtinExtensions:r?.builtinExtensions,onWarning:e=>{if(`hint`in e&&e.hint){a.push(e);return}if(`fatal`in e&&e.fatal){o=e;return}i.push(e)}},l=s(r?.cddl),u=[],d=[],f=e=>{if(!l)return;let t=l.validate(e,r?.cddlValidationOptions);u.push(...t.errors),t.warnings&&d.push(...t.warnings)},p=l?{cddlErrors:u,cddlWarnings:d}:{},m=0;try{let e=r?.type??`cbor`;if(e===`cdn`){let e={...c,unresolvedExtension:r?.unresolvedExtension};for(let r of t.fromCDNSeq(n,e))m++,f(r)}else if(e===`hex`)for(let e of t.fromHexDumpSeq(n,c))m++,f(e);else for(let e of t.fromCBORSeq(n,c))m++,f(e)}catch(e){return{valid:!1,count:m,warnings:i,hints:a,error:e instanceof Error?e:Error(String(e)),...p}}if(o){let t=o.cause instanceof Error?o.cause:new e.o(o.message,{offset:o.offset});return{valid:!1,count:m,warnings:i,hints:a,error:t,...p}}return{valid:i.length===0&&u.length===0,count:m,warnings:i,hints:a,...p}}static cborToCdn(e,n){return t.fromCBOR(e,n).toCDN(n)}static cborToCborEdn(e,n){return t.fromCBOR(e,n).toCDN(n)}static cdnToCbor(e,n){return t.fromCDN(e,n).toCBOR(n)}static cborEdnToCbor(e,n){return t.fromCDN(e,n).toCBOR(n)}static parse(e,n){return typeof n==`function`?t.fromCDN(e).toJS({reviver:n}):t.fromCDN(e,n).toJS(n)}static stringify(e,t,r){if(typeof t==`function`||Array.isArray(t)||t===null||t===void 0&&r!==void 0){let i=typeof t==`function`||Array.isArray(t)?t:void 0,a=_(r);if(i){let t=n.n(e,i);return t===void 0||t===n.z?void 0:n.r(t).toCDN(a===void 0?void 0:{indent:a})}return n.r(e).toCDN(a===void 0?void 0:{indent:a})}let i=t;if(i?.replacer){let t=n.n(e,i.replacer,i.extensions,i.undefinedOmits,i.builtinExtensions);if(t===void 0||t===n.z)return;let{replacer:r,...a}=i;return l(n.r(t,Object.keys(a).length>0?a:void 0),i).toCDN(i)}return l(n.r(e,i),i).toCDN(i)}static format(e,n){return t.fromCDN(e,n).toCDN(n)}};function d(e){let t=``,n=0;for(;n<e.length;){let r=e[n],i=e[n+1]??``;if(r===`-`&&i===`-`){n=f(e,n+2),t+=` `;continue}if(r===`—`){n=f(e,n+1),t+=` `;continue}if(r===`#`){n=f(e,n+1),t+=` `;continue}if(r===`/`&&i===`/`){n=f(e,n+2),t+=` `;continue}if(r===`/`&&i===`*`){let r=e.indexOf(`*/`,n+2);if(r<0)throw SyntaxError(`Unterminated comment in hex dump`);t+=p(e.slice(n,r+2)),n=r+2;continue}if(r===`/`){let r=e.indexOf(`/`,n+1);if(r<0)throw SyntaxError(`Unterminated comment in hex dump`);t+=p(e.slice(n,r+1)),n=r+1;continue}t+=r,n++}return t}function f(e,t){let n=e.indexOf(`
+`,t);return n<0?e.length:n}function p(e){return e.replace(/[^\r\n]/g,` `)}function m(e,t,n,r,i){let a=i?.offset??t,o={message:e,offset:a};r&&(o.fatal=!0),i&&(o.cause=i),i?.offset!==void 0&&(o.line=i.line,o.column=i.column,o.endOffset=i.endOffset),n?.onWarning?n.onWarning(o):n?.silent||console.warn(`CDN sequence warning at offset ${a}: ${e}`)}function h(e,t){let n=e[t];return n===`#`||n===`/`}function g(e,t,n,r=`none`){let i=t,a=!1,o=!1,s=!1,c=-1,l=()=>r===`all`||r===`after-newline`&&s;for(;i<e.length;){let t=e[i];if(t===` `||t===`	`||t===`\r`||t===``){a=!0,i++;continue}if(t===`
 `){a=!0,s=!0,i++;continue}if(t===`#`){if(a=!0,l())break;let t=e.indexOf(`
 `,i+1);i=t<0?e.length:t+1,s=!0;continue}if(t===`/`&&e[i+1]===`/`){if(a=!0,l())break;let t=e.indexOf(`
-`,i+2);i=t<0?e.length:t+1,s=!0;continue}if(t===`/`&&e[i+1]===`*`){if(a=!0,l())break;let t=e.indexOf(`*/`,i+2);if(t<0){let t=`unterminated /* comment in CDN sequence`;if(n?.strict!==!1)throw SyntaxError(t);b(t,i,n,!0),i=e.length}else e.slice(i,t).includes(`
-`)&&(s=!0),i=t+2;continue}if(t===`/`&&e[i+1]!==`/`){if(a=!0,l())break;let t=e.indexOf(`/`,i+1);if(t<0){let t=`unterminated / comment in CDN sequence`;if(n?.strict!==!1)throw SyntaxError(t);b(t,i,n,!0),i=e.length}else e.slice(i,t).includes(`
-`)&&(s=!0),i=t+1;continue}if(t===`,`&&!o){a=!0,o=!0,c=i,i++;continue}break}return{offset:i,hadSeparator:a,commaOffset:c}}function C(e){if(typeof e==`number`){let t=Math.floor(Math.min(10,Math.max(0,e)));return t===0?void 0:t}if(typeof e==`string`)return e.slice(0,10)||void 0}exports.BUILTIN_EXTENSIONS=n.i,exports.CBOR=g,exports.default=g,exports.CBOR_OMIT=n.R,exports.CBOR_TAG=n.z,exports.CddlMismatchError=t.s,exports.CdnSyntaxError=e.o,exports.MapEntries=n.t,exports.Null=n.B,exports.Simple=n.L,exports.Tag=n.V,exports.Undefined=n.H,exports.b1=n.l,exports.b32=s,exports.cri=n.f,exports.dt=n.m,exports.dt_as_Date=n.h,exports.float=n.a,exports.h32=c,exports.ilbs=n.s,exports.ilts=n.c,exports.ip=n.p,exports.same=u,exports.t1=n.u;
+`,i+2);i=t<0?e.length:t+1,s=!0;continue}if(t===`/`&&e[i+1]===`*`){if(a=!0,l())break;let t=e.indexOf(`*/`,i+2);if(t<0){let t=`unterminated /* comment in CDN sequence`;if(n?.strict!==!1)throw SyntaxError(t);m(t,i,n,!0),i=e.length}else e.slice(i,t).includes(`
+`)&&(s=!0),i=t+2;continue}if(t===`/`&&e[i+1]!==`/`){if(a=!0,l())break;let t=e.indexOf(`/`,i+1);if(t<0){let t=`unterminated / comment in CDN sequence`;if(n?.strict!==!1)throw SyntaxError(t);m(t,i,n,!0),i=e.length}else e.slice(i,t).includes(`
+`)&&(s=!0),i=t+1;continue}if(t===`,`&&!o){a=!0,o=!0,c=i,i++;continue}break}return{offset:i,hadSeparator:a,commaOffset:c}}function _(e){if(typeof e==`number`){let t=Math.floor(Math.min(10,Math.max(0,e)));return t===0?void 0:t}if(typeof e==`string`)return e.slice(0,10)||void 0}exports.BUILTIN_EXTENSIONS=n.i,exports.CBOR=u,exports.default=u,exports.CBOR_OMIT=n.z,exports.CBOR_TAG=n.B,exports.CddlMismatchError=t.s,exports.CdnSyntaxError=e.o,exports.MapEntries=n.t,exports.Null=n.V,exports.Simple=n.R,exports.Tag=n.H,exports.Undefined=n.U,exports.b1=n.c,exports.b32=n.S,exports.cri=n.d,exports.dt=n.p,exports.dt_as_Date=n.m,exports.float=n.a,exports.h32=n.C,exports.ilbs=n.o,exports.ilts=n.s,exports.ip=n.f,exports.same=i,exports.t1=n.l;
 //# sourceMappingURL=index.cjs.map