@cbortech/cbor 0.24.0 → 0.25.0

package/dist/simple.d.ts

@@ -6,12 +6,12 @@
  * Also serves as a namespace for simple-value utilities.
  *
  * @example
- * const v = CBOR.fromEDN('simple(19)').toJS();
+ * const v = CBOR.fromCDN('simple(19)').toJS();
  * Simple.is(v);    // true
  * Simple.get(v);   // 19
  *
  * const node = CBOR.fromJS(new Simple(19));
- * node.toEDN();    // "simple(19)"
+ * node.toCDN();    // "simple(19)"
  */
 export declare class Simple {
     readonly value: number;

package/dist/tag.d.ts

@@ -19,7 +19,7 @@ export declare function getCborTaggedValue(value: unknown): unknown;
  * Namespace for CBOR tag annotation utilities.
  *
  * @example
- * const v = CBOR.fromEDN('42("hello")').toJS();
+ * const v = CBOR.fromCDN('42("hello")').toJS();
  * Tag.get(v);        // 42n
  * Tag.getValue(v);   // "hello"
  *

package/dist/types.d.ts

@@ -40,7 +40,7 @@ export interface ToJSOptions {
      * - `'object'`: always `Record<string, unknown>` — non-string keys are
      *   converted via `String()`. Duplicate keys are overwritten (last wins).
      * - `'entries'`: always `MapEntries` (a typed `Array` subclass) — preserves all
-     *   entries including duplicate keys (§2.6.2 of draft-ietf-cbor-edn-literals-20).
+     *   entries including duplicate keys (§2.6.3 of draft-ietf-cbor-edn-literals-25).
      *   `fromJS()` recognises `MapEntries` instances and converts them back to `CborMap`.
      * @default 'auto'
      */
@@ -122,9 +122,9 @@ export interface FromHexDumpOptions {
      */
     extensions?: CborExtension[];
 }
-export interface FromEDNOptions {
+export interface FromCDNOptions {
     /**
-     * Character offset within the supplied text at which CBOR-EDN parsing starts.
+     * Character offset within the supplied text at which CDN parsing starts.
      * Leading whitespace/comments at or after this offset are skipped as usual.
      *
      * @default 0
@@ -135,22 +135,22 @@ export interface FromEDNOptions {
      *
      * When `false`, parsing still requires the item to consume the remaining
      * input, preserving the historical single-item behaviour. Set this to `true`
-     * when using `CborItem.end` to continue parsing a CBOR-EDN sequence.
-     * Top-level comma separators are not skipped by `fromEDN()` itself; handle
+     * when using `CborItem.end` to continue parsing a CDN sequence.
+     * Top-level comma separators are not skipped by `fromCDN()` itself; handle
      * them in sequence-level code before passing the next `offset`. For example,
      * after parsing `1, 2`, the first item's `end` points just before the comma;
      * advance past that comma before parsing the next item.
      *
      * @example
      * // Read two whitespace-separated items, validating that the second is last.
-     * const first = CBOR.fromEDN(text, { allowTrailing: true });
-     * const second = CBOR.fromEDN(text, { offset: first.end });
+     * const first = CBOR.fromCDN(text, { allowTrailing: true });
+     * const second = CBOR.fromCDN(text, { offset: first.end });
      *
      * @default false
      */
     allowTrailing?: boolean;
     /**
-     * Extension plugins for EDN parsing.
+     * Extension plugins for CDN parsing.
      * Each extension declares which app-string prefixes (and, in future, tag
      * numbers) it handles via `appStringPrefixes` / `tagNumbers`, and provides
      * callback methods that return `CborItem`-subclassed objects controlling
@@ -162,11 +162,11 @@ export interface FromEDNOptions {
     extensions?: CborExtension[];
     /**
      * How to handle unrecognised application-extension identifiers
-     * (§4.1 draft-ietf-cbor-edn-literals-20).
+     * (§4.1 of draft-ietf-cbor-edn-literals-25).
      *
      * - `'cpa999'`: wrap the literal in a `CPA999` tag
      *   (`CborUnresolvedAppExt`) instead of failing. The resulting node
-     *   round-trips through `toEDN()` back to the original notation.
+     *   round-trips through `toCDN()` back to the original notation.
      * - `'error'`: throw `SyntaxError` for unknown prefixes.
      * @default 'cpa999'
      */
@@ -184,16 +184,22 @@ export interface FromEDNOptions {
      */
     allowInvalidUtf8?: boolean;
     /**
-     * Preserve comments found between CBOR-EDN values and attach them to the AST.
+     * Preserve comments found between CDN values and attach them to the AST.
      *
      * Comments are metadata only: they are ignored by CBOR binary encoding and
-     * JavaScript conversion. Use together with `ToEDNOptions.preserveComments`
-     * to include them when formatting back to EDN.
+     * JavaScript conversion. Use together with `ToCDNOptions.preserveComments`
+     * to include them when formatting back to CDN.
      *
      * @default false
      */
     preserveComments?: boolean;
 }
+/**
+ * Options for parsing Concise Diagnostic Notation (CDN).
+ *
+ * @deprecated Use `FromCDNOptions` instead.
+ */
+export type FromEDNOptions = FromCDNOptions;
 export interface FromJSOptions {
     /**
      * Extension plugins applied during `fromJS()`.
@@ -238,7 +244,7 @@ export interface FromJSOptions {
      */
     undefinedOmits?: boolean;
 }
-export interface ToEDNOptions {
+export interface ToCDNOptions {
     /**
      * Indentation for pretty-printing.
      * - `number`: number of spaces
@@ -247,7 +253,7 @@ export interface ToEDNOptions {
      */
     indent?: number | string;
     /**
-     * Emit comments previously captured by `FromEDNOptions.preserveComments`.
+     * Emit comments previously captured by `FromCDNOptions.preserveComments`.
      *
      * When enabled for containers, comment-bearing arrays/maps are emitted in
      * multi-line form even if `indent` is omitted.
@@ -256,7 +262,7 @@ export interface ToEDNOptions {
      */
     preserveComments?: boolean;
     /**
-     * Re-emit byte string literals parsed from EDN using their original source
+     * Re-emit byte string literals parsed from CDN using their original source
      * text when available.
      *
      * This preserves the spelling and interior layout of non-concatenated
@@ -308,7 +314,7 @@ export interface ToEDNOptions {
      */
     appStrings?: boolean;
     /**
-     * Numeric format for integer values in EDN output.
+     * Numeric format for integer values in CDN output.
      * - `'decimal'`: standard decimal notation (e.g. `42`, `-14159024`)
      * - `'hex'`: hexadecimal notation (e.g. `0x2a`, `-0xd83130`)
      * - `'octal'`: octal notation (e.g. `0o52`, `-0o67061560`)
@@ -317,25 +323,35 @@ export interface ToEDNOptions {
      */
     intFormat?: 'decimal' | 'hex' | 'octal' | 'binary';
     /**
-     * Numeric format for floating-point values in EDN output.
+     * Numeric format for floating-point values in CDN output.
      * - `'decimal'`: standard decimal notation (e.g. `1.5`, `145544.0_3`)
      * - `'hex'`: C99-style hex float notation (e.g. `0x1.8p+0`, `0x1.1c54p+17_3`)
      * @default 'decimal'
      */
     floatFormat?: 'decimal' | 'hex';
     /**
-     * Split long text strings using EDN string concatenation syntax (`"a" + "b"`).
+     * Split long text strings using CDN string concatenation syntax (`"a" + "b"`).
      * Only effective when `indent` is specified.
      *
      * - `'newline'`: split at newline characters
-     * - `'cboredn'`: split according to CBOR-EDN structure when the string content
-     *                is parseable as CBOR-EDN (JSON superset)
+     * - `'cdn'`: split according to CDN structure when the string content
+     *                is parseable as CDN (JSON superset)
+     * - `'cboredn'`: deprecated alias for `'cdn'`
      *
-     * When both are specified, CBOR-EDN structure split points are combined with
+     * When both are specified, CDN structure split points are combined with
      * newline split points.
      */
-    textStringFormat?: ('newline' | 'cboredn')[];
+    textStringFormat?: TextStringFormat[];
 }
+export type TextStringFormat = 'newline' | 'cdn' | DeprecatedTextStringFormat;
+/** @deprecated Use `'cdn'` instead. */
+export type DeprecatedTextStringFormat = 'cboredn';
+/**
+ * Options for serializing Concise Diagnostic Notation (CDN).
+ *
+ * @deprecated Use `ToCDNOptions` instead.
+ */
+export type ToEDNOptions = ToCDNOptions;
 export interface CborComment {
     kind: 'line' | 'block';
     marker: '#' | '//' | '/*' | '/';
@@ -359,4 +375,4 @@ export interface CborComments {
  * Note: `encodeIntegerAs` (from {@link FromJSOptions}) and `integerAs` (from
  * {@link ToJSOptions}) are distinct fields and do not conflict.
  */
-export type CBOROptions = FromEDNOptions & FromJSOptions & ToCBOROptions & ToEDNOptions & ToJSOptions & ToHexDumpOptions;
+export type CBOROptions = FromCDNOptions & FromJSOptions & ToCBOROptions & ToCDNOptions & ToJSOptions & ToHexDumpOptions;

package/dist/utils/hexfloat.d.ts

@@ -4,7 +4,7 @@
  * Hex float format:
  *   [-] 0x [hex digits] [. [hex digits]] p [+-] [decimal exponent]
  *
- * This notation appears in CBOR-EDN (draft-ietf-cbor-edn-literals) as an
+ * This notation appears in CDN (draft-ietf-cbor-edn-literals-25) as an
  * alternative representation for floating-point values (major type 7).
  */
 /**
@@ -17,7 +17,7 @@
 export declare function parseHexFloat(s: string): number;
 /**
  * Convert a JS number to a normalized hex float string compatible with
- * CBOR-EDN diagnostic notation.
+ * CDN diagnostic notation.
  *
  * - Normal values: `0x1.[hex fraction]p[+-][exp]`  (e.g. `0x1.8p+0` for 1.5)
  * - Subnormal values: `0x0.[hex fraction]p-1022`

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@cbortech/cbor",
-  "version": "0.24.0",
-  "description": "Convert between CBOR, CBOR-EDN, and JavaScript values",
+  "version": "0.25.0",
+  "description": "Convert between CBOR, CDN, and JavaScript values",
   "keywords": [
     "cbor",
+    "cdn",
     "cbor-edn",
-    "edn",
     "diagnostic-notation",
     "json",
     "jsonc",
@@ -82,16 +82,16 @@
   },
   "devDependencies": {
     "@types/node": "^24.12.4",
-    "@vitest/browser": "^4.1.6",
-    "@vitest/browser-playwright": "^4.1.6",
-    "@vitest/coverage-v8": "^4.1.6",
-    "@vitest/ui": "^4.1.6",
+    "@vitest/browser": "^4.1.7",
+    "@vitest/browser-playwright": "^4.1.7",
+    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/ui": "^4.1.7",
     "cross-env": "^10.1.0",
     "playwright": "^1.60.0",
     "prettier": "^3.8.3",
     "typescript": "^5.9.3",
-    "vite": "^8.0.12",
+    "vite": "^8.0.13",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.7"
   }
 }

package/dist/edn/parser.d.ts

@@ -1,7 +0,0 @@
-import { CborItem } from '../ast/CborItem';
-import { FromEDNOptions } from '../types';
-/**
- * Parse a CBOR-EDN diagnostic notation string into a CborItem AST node.
- * Throws SyntaxError on invalid input.
- */
-export declare function parseEDN(text: string, options?: FromEDNOptions): CborItem;

package/dist/edn/serializer.d.ts

@@ -1,7 +0,0 @@
-import { CborItem } from '../ast/CborItem';
-import { ToEDNOptions } from '../types';
-/**
- * Serialize a CborItem AST node to CBOR-EDN diagnostic notation.
- * Equivalent to calling value.toEDN(options) directly.
- */
-export declare function toEDN(value: CborItem, options?: ToEDNOptions): string;