@cbortech/cbor 0.24.0 → 0.25.1

package/README.ja.md

@@ -1,6 +1,6 @@
 # @cbortech/cbor
 
-[CBOR](#準拠している仕様)、[CBOR-EDN](#準拠している仕様)、JavaScript 値を相互変換するための TypeScript ライブラリです。
+[CBOR](#準拠している仕様)、[CDN](#準拠している仕様)、JavaScript 値を相互変換するための TypeScript ライブラリです。
 
 このパッケージは `CBOR` ファサードに加えて、extension の実装に必要な CBOR AST ノードクラス用の entrypoint を公開します。
 低レベルのパーサー、エンコーダー内部は、ドキュメント上の公開 API には含めていません。
@@ -52,31 +52,29 @@ console.log(value);
 // { hello: 'world', n: 42 }
 ```
 
-### CBOR バイト列から CBOR-EDN へ
+### CBOR バイト列から CDN へ
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const text = CBOR.fromCBOR(
-  new Uint8Array([0x83, 0x01, 0x02, 0x03])
-).toEDN();
+const text = CBOR.fromCBOR(new Uint8Array([0x83, 0x01, 0x02, 0x03])).toCDN();
 
 console.log(text);
 // [1,2,3]
 ```
 
-### CBOR-EDN から CBOR バイト列へ
+### CDN から CBOR バイト列へ
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const bytes = CBOR.fromEDN('[1, 2, 3]').toCBOR();
+const bytes = CBOR.fromCDN('[1, 2, 3]').toCBOR();
 
 console.log(bytes);
 // Uint8Array([0x83, 0x01, 0x02, 0x03])
 ```
 
-### JavaScript から CBOR-EDN へ
+### JavaScript から CDN へ
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -87,7 +85,7 @@ console.log(text);
 // {"a":1,"b":true,"c":null}
 ```
 
-### 読みやすい CBOR-EDN を出力する
+### 読みやすい CDN を出力する
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -105,7 +103,7 @@ console.log(text);
 // }
 ```
 
-### CBOR-EDN から JavaScript へ
+### CDN から JavaScript へ
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -116,7 +114,7 @@ console.log(value);
 // [1, Uint8Array(...), true, null]
 ```
 
-### CBOR-EDN を正規化する
+### CDN を正規化する
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -135,7 +133,7 @@ console.log(text);
 
 ### テキスト文字列を分割して整形する
 
-`textStringFormat` を使うと、長いテキスト文字列を EDN の文字列連結として分割できます。
+`textStringFormat` を使うと、長いテキスト文字列を CDN の文字列連結として分割できます。
 このオプションは `indent` を指定したときに適用されます。
 
 ```ts
@@ -154,19 +152,19 @@ console.log(text);
 // }
 ```
 
-文字列の中身が CBOR-EDN や JSON 風の内容なら、`cboredn` を使えます。
+文字列の中身が CDN や JSON 風の内容なら、`cdn` を使えます。
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const text = CBOR.format('{"edn": "[1,2,3]"}', {
+const text = CBOR.format('{"cdn": "[1,2,3]"}', {
   indent: 2,
-  textStringFormat: ['cboredn'],
+  textStringFormat: ['cdn'],
 });
 
 console.log(text);
 // {
-//   "edn": "[" +
+//   "cdn": "[" +
 //       "1," +
 //       "2," +
 //       "3" +
@@ -176,7 +174,7 @@ console.log(text);
 
 ## AST を扱う
 
-`CBOR.fromCBOR()`、`CBOR.fromEDN()`、`CBOR.fromJS()` は CBOR item を返します。
+`CBOR.fromCBOR()`、`CBOR.fromCDN()`、`CBOR.fromJS()` は CBOR item を返します。
 `CborTextString`、`CborByteString`、`CborArray`、`CborTag` などの具体的なノードクラスは、
 extension 向けに `@cbortech/cbor/ast` から export されています。すべての item は次のメソッドを持ちます。
 
@@ -184,11 +182,11 @@ extension 向けに `@cbortech/cbor/ast` から export されています。す
 import { CBOR } from '@cbortech/cbor';
 import { CborItem } from '@cbortech/cbor/ast';
 
-const item = CBOR.fromEDN('{ "x": 1 }');
+const item = CBOR.fromCDN('{ "x": 1 }');
 item satisfies CborItem;
 
 const bytes = item.toCBOR();
-const text = item.toEDN();
+const text = item.toCDN();
 const value = item.toJS();
 ```
 
@@ -197,23 +195,23 @@ const value = item.toJS();
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const item = CBOR.fromEDN('[_ 1, 2, 3]');
+const item = CBOR.fromCDN('[_ 1, 2, 3]');
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [_ 1,2,3]
 
 console.log(item.toCBOR());
 // Uint8Array(...)
 ```
 
-### CBOR を AST としてデコードし、EDN として確認する
+### CBOR を AST としてデコードし、CDN として確認する
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
 const item = CBOR.fromCBOR(new Uint8Array([0x83, 0x01, 0x02, 0x03]));
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [1,2,3]
 
 console.log(item.toJS());
@@ -301,7 +299,7 @@ console.log(cbor.stringify({ value }));
 
 ## 日時
 
-CBOR-EDN の `dt'...'` と `DT'...'` リテラルは、デフォルトでパースできます。
+CDN の `dt'...'` と `DT'...'` リテラルは、デフォルトでパースできます。
 JavaScript の `Date` オブジェクトとして扱いたい場合は `CBOR.dt_as_Date` を追加します。
 
 ```ts
@@ -328,37 +326,117 @@ console.log(text);
 
 ## オプション extension
 
+このパッケージには、デフォルト有効ではないものの本体に同梱されている
+extension があります。必要なものを `import` し、
+`extensions` オプションに渡して使います。
+
+### b32 / h32
+
+[RFC 4648](https://www.rfc-editor.org/rfc/rfc4648) の Base32 エンコードによるバイト列リテラルです。
+[RFC 8949](https://www.rfc-editor.org/rfc/rfc8949) §8 に記載があり、[draft-ietf-cbor-edn-literals](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/) でも触れられています。
+
+- `b32` — §6 Base32（`A–Z 2–7` アルファベット）
+- `h32` — §7 Base32Hex（`0–9 A–V` アルファベット）
+
+```ts
+import { CBOR, b32, h32 } from '@cbortech/cbor';
+
+const v1 = CBOR.fromCDN("b32'AEBAGBA'", { extensions: [b32] });
+console.log(v1.toCDN({ appStrings: false }));
+// h'01020304'
+
+const v2 = CBOR.fromCDN("h32'00P00'", { extensions: [h32] });
+console.log(v2.toCDN({ appStrings: false }));
+// h'003200'
+```
+
+### float
+
+16 進数のビットパターンを IEEE 754 浮動小数点値として解釈します。
+[draft-bormann-cbor-edn-app-ext](https://datatracker.ietf.org/doc/draft-bormann-cbor-edn-app-ext/)
+に記載があり、[cbor-test-vectors](https://github.com/cbor-wg/cbor-test-vectors) でも使われています。
+
+```ts
+import { CBOR, float } from '@cbortech/cbor';
+
+const v = CBOR.fromCDN("float'7e00'", { extensions: [float] });
+console.log(v.toCDN({ appStrings: false }));
+// NaN
+
+// バイト列から解釈する場合
+const v2 = CBOR.fromCDN("float<<h'3f800000'>>", { extensions: [float] });
+console.log(v2.toCDN({ appStrings: false }));
+// 1.0_2
+```
+
+### same
+
+`same<<expr, expr, ...>>` は、シーケンス内のすべての要素が同一の CBOR
+バイト列になることを検証し、最初の要素を返す extension です。
+[draft-bormann-cbor-edn-app-ext](https://datatracker.ietf.org/doc/draft-bormann-cbor-edn-app-ext/)
+に記載があります。
+
+```ts
+import { CBOR, same } from '@cbortech/cbor';
+
+// すべての要素が同じバイト列かを検証し、最初の要素を返す
+const v = CBOR.fromCDN("same<<h'0102', h'0102'>>", { extensions: [same] });
+console.log(v.toCDN({ appStrings: false }));
+// h'0102'
+
+// 要素が 1 つでも有効（常にパスする）
+const v2 = CBOR.fromCDN('same<<42>>', { extensions: [same] });
+console.log(v2.toCDN({ appStrings: false }));
+// 42
+```
+
+---
+
 追加の application extension は別パッケージとして公開されています。必要なものを
 インストールし、`extensions` オプションに渡して使います。
 
-`hash` は CBOR-EDN の仕様に含まれる application extension ですが、利用には
-外部パッケージが必要です。そのため、このパッケージ本体には含めず、
-`@cbortech/hash-extension` として提供しています。
+### hash
 
-`uuid` は CBOR-EDN の仕様には定められていない、このライブラリ独自の
-application extension です。仕様上の標準機能と区別するため、
-`@cbortech/uuid-extension` として別パッケージで提供しています。
+`hash` は [draft-ietf-cbor-edn-literals](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/) §3.3 で定義された標準の application extension です。
+ハッシュアルゴリズムと値を `hash'algorithm:value'` の形式で表現します。
+実装には外部の暗号ライブラリが必要なため、[@cbortech/hash-extension](https://www.npmjs.com/package/@cbortech/hash-extension) として
+別パッケージで提供しています。
 
 ```bash
-npm install @cbortech/hash-extension @cbortech/uuid-extension
+npm install @cbortech/hash-extension
 ```
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
-import hashExtension from '@cbortech/hash-extension';
-import uuidExtension from '@cbortech/uuid-extension';
+import { hash } from '@cbortech/hash-extension';
 
-const cbor = new CBOR({
-  extensions: [hashExtension, uuidExtension],
-});
+const cbor = new CBOR({ extensions: [hash] });
+
+const digest = cbor.parse(
+  "hash'sha-256:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU='"
+);
+// Uint8Array(32) [227, 176, 196, 66, 152, 252, 28, 20, 154, 251, 244, 200,
+//                 153, 111, 185, 36, 39, 174, 65, 228, 100, 155, 147, 76,
+//                 164, 149, 153, 27, 120, 82, 184, 85]
+```
+
+### uuid
+
+`uuid` はこのライブラリ独自の application extension です。
+[@cbortech/uuid-extension](https://www.npmjs.com/package/@cbortech/uuid-extension) として別パッケージで提供しています。
+
+```bash
+npm install @cbortech/uuid-extension
+```
+
+```ts
+import { CBOR } from '@cbortech/cbor';
+import { uuid } from '@cbortech/uuid-extension';
 
-const digest = cbor.fromEDN("hash'foo'");
-console.log(digest.toEDN());
-// hash'foo'
+const cbor = new CBOR({ extensions: [uuid] });
 
-const id = cbor.fromEDN("uuid'550e8400-e29b-41d4-a716-446655440000'");
-console.log(id.toEDN());
-// uuid'550e8400-e29b-41d4-a716-446655440000'
+const id = cbor.parse("uuid'550e8400-e29b-41d4-a716-446655440000'");
+// Uint8Array(16) [85, 14, 132, 0, 226, 155, 65, 212, 167, 22, 68, 102, 85, 68, 0, 0]
 ```
 
 ## タグ
@@ -471,7 +549,7 @@ CBOR item は注釈付き hex dump の生成とパースに対応しています
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const item = CBOR.fromEDN('[_ 1, [2, 3]]');
+const item = CBOR.fromCDN('[_ 1, [2, 3]]');
 const dump = item.toHexDump();
 
 console.log(dump);
@@ -489,7 +567,7 @@ const item = CBOR.fromHexDump(`
    03     -- 3
 `);
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [1,2,3]
 ```
 
@@ -512,19 +590,19 @@ console.log(item.toEDN());
 このライブラリは次の仕様を対象にしています。
 
 - [CBOR, RFC 8949](https://www.rfc-editor.org/rfc/rfc8949)
-- [CBOR Extended Diagnostic Notation (CBOR-EDN), draft-ietf-cbor-edn-literals-24](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/24/)
+- [Concise Diagnostic Notation (CDN), draft-ietf-cbor-edn-literals-25](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/)
 
-CBOR-EDN は、CBOR データを人間が読み書きしやすいテキストとして表現するための記法です。
+CDN は、CBOR データを人間が読み書きしやすいテキストとして表現するための記法です。
 サンプル、テストベクター、デバッグ、fixture、設定ファイルに近い用途など、CBOR のバイト列をそのまま扱うと読みにくい場面で役立ちます。
 
 通常の配列、マップ、文字列、数値、真偽値、null は JSON に近い見た目で書けます。
 一方で、CBOR 固有の byte string、tag、simple value、不定長 item、文字列以外の map key、
 `dt'2026-05-06T00:00:00Z'` のような application literal も表現できます。
 
-CBOR-EDN は JSON / JSONC の上位互換なので、通常の JSON データやコメント付きの JSON 風データも、
-特別な変換なしに CBOR-EDN としてパース・整形できます。
+CDN は JSON / JSONC の上位互換なので、通常の JSON データやコメント付きの JSON 風データも、
+特別な変換なしに CDN としてパース・整形できます。
 
-CBOR-EDN はまだ広く普及した RFC ではなく、Internet-Draft として策定中の仕様です。
+CDN はまだ広く普及した RFC ではなく、Internet-Draft として策定中の仕様です。
 
 ## ライセンス
 

package/README.md

@@ -1,7 +1,7 @@
 # @cbortech/cbor
 
 TypeScript library for converting between [CBOR](#specifications),
-[CBOR-EDN](#specifications), and JavaScript values.
+[CDN](#specifications), and JavaScript values.
 
 This package exposes the `CBOR` facade plus a separate AST entrypoint for the
 CBOR node classes needed by extensions. Lower-level parser and encoder internals
@@ -54,31 +54,29 @@ console.log(value);
 // { hello: 'world', n: 42 }
 ```
 
-### CBOR bytes to CBOR-EDN
+### CBOR bytes to CDN
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const text = CBOR.fromCBOR(
-  new Uint8Array([0x83, 0x01, 0x02, 0x03])
-).toEDN();
+const text = CBOR.fromCBOR(new Uint8Array([0x83, 0x01, 0x02, 0x03])).toCDN();
 
 console.log(text);
 // [1,2,3]
 ```
 
-### CBOR-EDN to CBOR bytes
+### CDN to CBOR bytes
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const bytes = CBOR.fromEDN('[1, 2, 3]').toCBOR();
+const bytes = CBOR.fromCDN('[1, 2, 3]').toCBOR();
 
 console.log(bytes);
 // Uint8Array([0x83, 0x01, 0x02, 0x03])
 ```
 
-### JavaScript to CBOR-EDN
+### JavaScript to CDN
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -89,7 +87,7 @@ console.log(text);
 // {"a":1,"b":true,"c":null}
 ```
 
-### Pretty CBOR-EDN
+### Pretty CDN
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -107,7 +105,7 @@ console.log(text);
 // }
 ```
 
-### CBOR-EDN to JavaScript
+### CDN to JavaScript
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -118,7 +116,7 @@ console.log(value);
 // [1, Uint8Array(...), true, null]
 ```
 
-### Normalize CBOR-EDN
+### Normalize CDN
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
@@ -137,7 +135,7 @@ console.log(text);
 
 ### Split text strings while formatting
 
-`textStringFormat` can split long text strings with EDN string concatenation.
+`textStringFormat` can split long text strings with CDN string concatenation.
 It is applied when `indent` is specified.
 
 ```ts
@@ -156,19 +154,19 @@ console.log(text);
 // }
 ```
 
-For strings that contain CBOR-EDN or JSON-like content, use `cboredn`.
+For strings that contain CDN or JSON-like content, use `cdn`.
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const text = CBOR.format('{"edn": "[1,2,3]"}', {
+const text = CBOR.format('{"cdn": "[1,2,3]"}', {
   indent: 2,
-  textStringFormat: ['cboredn'],
+  textStringFormat: ['cdn'],
 });
 
 console.log(text);
 // {
-//   "edn": "[" +
+//   "cdn": "[" +
 //       "1," +
 //       "2," +
 //       "3" +
@@ -178,7 +176,7 @@ console.log(text);
 
 ## Working With The AST
 
-`CBOR.fromCBOR()`, `CBOR.fromEDN()`, and `CBOR.fromJS()` return a CBOR item.
+`CBOR.fromCBOR()`, `CBOR.fromCDN()`, and `CBOR.fromJS()` return a CBOR item.
 Concrete node classes such as `CborTextString`, `CborByteString`, `CborArray`,
 and `CborTag` are exported from `@cbortech/cbor/ast` for extensions. Every item
 supports these methods:
@@ -187,11 +185,11 @@ supports these methods:
 import { CBOR } from '@cbortech/cbor';
 import { CborItem } from '@cbortech/cbor/ast';
 
-const item = CBOR.fromEDN('{ "x": 1 }');
+const item = CBOR.fromCDN('{ "x": 1 }');
 item satisfies CborItem;
 
 const bytes = item.toCBOR();
-const text = item.toEDN();
+const text = item.toCDN();
 const value = item.toJS();
 ```
 
@@ -200,23 +198,23 @@ const value = item.toJS();
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const item = CBOR.fromEDN('[_ 1, 2, 3]');
+const item = CBOR.fromCDN('[_ 1, 2, 3]');
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [_ 1,2,3]
 
 console.log(item.toCBOR());
 // Uint8Array(...)
 ```
 
-### Decode to AST, then inspect as EDN
+### Decode to AST, then inspect as CDN
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
 const item = CBOR.fromCBOR(new Uint8Array([0x83, 0x01, 0x02, 0x03]));
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [1,2,3]
 
 console.log(item.toJS());
@@ -305,7 +303,7 @@ console.log(cbor.stringify({ value }));
 
 ## Dates
 
-CBOR-EDN `dt'...'` and `DT'...'` literals are parsed by default. Add `CBOR.dt_as_Date`
+CDN `dt'...'` and `DT'...'` literals are parsed by default. Add `CBOR.dt_as_Date`
 when you want JavaScript `Date` objects.
 
 ```ts
@@ -332,37 +330,118 @@ console.log(text);
 
 ## Optional Extensions
 
+This package includes several bundled extensions that are not enabled by
+default. Import what you need and pass it through the `extensions` option.
+
+### b32 / h32
+
+Byte-string literals using [RFC 4648](https://www.rfc-editor.org/rfc/rfc4648)
+Base32 encoding. These prefixes are described in §8 of
+[RFC 8949](https://www.rfc-editor.org/rfc/rfc8949) and also mentioned in
+[draft-ietf-cbor-edn-literals](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/).
+
+- `b32` — §6 Base32 (`A–Z 2–7` alphabet)
+- `h32` — §7 Base32Hex (`0–9 A–V` alphabet)
+
+```ts
+import { CBOR, b32, h32 } from '@cbortech/cbor';
+
+const v1 = CBOR.fromCDN("b32'AEBAGBA'", { extensions: [b32] });
+console.log(v1.toCDN({ appStrings: false }));
+// h'01020304'
+
+const v2 = CBOR.fromCDN("h32'00P00'", { extensions: [h32] });
+console.log(v2.toCDN({ appStrings: false }));
+// h'003200'
+```
+
+### float
+
+Interprets a hex bit-pattern as an IEEE 754 floating-point value. This
+extension is described in
+[draft-bormann-cbor-edn-app-ext](https://datatracker.ietf.org/doc/draft-bormann-cbor-edn-app-ext/)
+and also used in [cbor-test-vectors](https://github.com/cbor-wg/cbor-test-vectors).
+
+```ts
+import { CBOR, float } from '@cbortech/cbor';
+
+const v = CBOR.fromCDN("float'7e00'", { extensions: [float] });
+console.log(v.toCDN({ appStrings: false }));
+// NaN
+
+// Interpret bytes as float bits
+const v2 = CBOR.fromCDN("float<<h'3f800000'>>", { extensions: [float] });
+console.log(v2.toCDN({ appStrings: false }));
+// 1.0_2
+```
+
+### same
+
+`same<<expr, expr, ...>>` verifies that every item in the sequence encodes to
+identical CBOR bytes and returns the first item. This extension is described in
+[draft-bormann-cbor-edn-app-ext](https://datatracker.ietf.org/doc/draft-bormann-cbor-edn-app-ext/).
+
+```ts
+import { CBOR, same } from '@cbortech/cbor';
+
+const v = CBOR.fromCDN("same<<h'0102', h'0102'>>", { extensions: [same] });
+console.log(v.toCDN({ appStrings: false }));
+// h'0102'
+
+// A single-item sequence always passes
+const v2 = CBOR.fromCDN('same<<42>>', { extensions: [same] });
+console.log(v2.toCDN({ appStrings: false }));
+// 42
+```
+
+---
+
 Additional application extensions are published as separate packages. Install
 the ones you need and pass them through the `extensions` option.
 
-`hash` is an application extension defined by the CBOR-EDN specification, but
-it requires an external package. For that reason, it is not bundled with this
-package and is provided separately as `@cbortech/hash-extension`.
+### hash
 
-`uuid` is a library-specific application extension that is not defined by the
-CBOR-EDN specification. To keep it distinct from standard CBOR-EDN features, it
-is provided separately as `@cbortech/uuid-extension`.
+`hash` is an application extension defined in §3.3 of
+[draft-ietf-cbor-edn-literals](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/).
+It represents cryptographic hash values in the form `hash'algorithm:value'`.
+Because it requires an external cryptographic library, it is provided separately
+as [@cbortech/hash-extension](https://www.npmjs.com/package/@cbortech/hash-extension).
 
 ```bash
-npm install @cbortech/hash-extension @cbortech/uuid-extension
+npm install @cbortech/hash-extension
 ```
 
 ```ts
 import { CBOR } from '@cbortech/cbor';
-import hashExtension from '@cbortech/hash-extension';
-import uuidExtension from '@cbortech/uuid-extension';
+import { hash } from '@cbortech/hash-extension';
 
-const cbor = new CBOR({
-  extensions: [hashExtension, uuidExtension],
-});
+const cbor = new CBOR({ extensions: [hash] });
+
+const digest = cbor.parse(
+  "hash'sha-256:47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU='"
+);
+// Uint8Array(32) [227, 176, 196, 66, 152, 252, 28, 20, 154, 251, 244, 200,
+//                 153, 111, 185, 36, 39, 174, 65, 228, 100, 155, 147, 76,
+//                 164, 149, 153, 27, 120, 82, 184, 85]
+```
+
+### uuid
+
+`uuid` is a library-specific application extension, provided separately as
+[@cbortech/uuid-extension](https://www.npmjs.com/package/@cbortech/uuid-extension).
+
+```bash
+npm install @cbortech/uuid-extension
+```
+
+```ts
+import { CBOR } from '@cbortech/cbor';
+import { uuid } from '@cbortech/uuid-extension';
 
-const digest = cbor.fromEDN("hash'foo'");
-console.log(digest.toEDN());
-// hash'foo'
+const cbor = new CBOR({ extensions: [uuid] });
 
-const id = cbor.fromEDN("uuid'550e8400-e29b-41d4-a716-446655440000'");
-console.log(id.toEDN());
-// uuid'550e8400-e29b-41d4-a716-446655440000'
+const id = cbor.parse("uuid'550e8400-e29b-41d4-a716-446655440000'");
+// Uint8Array(16) [85, 14, 132, 0, 226, 155, 65, 212, 167, 22, 68, 102, 85, 68, 0, 0]
 ```
 
 ## Tags
@@ -477,7 +556,7 @@ CBOR items can produce and parse annotated hex dumps.
 ```ts
 import { CBOR } from '@cbortech/cbor';
 
-const item = CBOR.fromEDN('[_ 1, [2, 3]]');
+const item = CBOR.fromCDN('[_ 1, [2, 3]]');
 const dump = item.toHexDump();
 
 console.log(dump);
@@ -495,7 +574,7 @@ const item = CBOR.fromHexDump(`
    03     -- 3
 `);
 
-console.log(item.toEDN());
+console.log(item.toCDN());
 // [1,2,3]
 ```
 
@@ -518,9 +597,9 @@ The `CBOR` facade also exposes:
 This library targets:
 
 - [CBOR, RFC 8949](https://www.rfc-editor.org/rfc/rfc8949)
-- [CBOR Extended Diagnostic Notation (CBOR-EDN), draft-ietf-cbor-edn-literals-24](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/24/)
+- [Concise Diagnostic Notation (CDN), draft-ietf-cbor-edn-literals-25](https://datatracker.ietf.org/doc/draft-ietf-cbor-edn-literals/25/)
 
-CBOR-EDN is a human-readable text notation for CBOR data. It is useful for
+CDN is a human-readable text notation for CBOR data. It is useful for
 examples, test vectors, debugging, fixtures, and configuration-like files where
 raw CBOR bytes would be hard to read.
 
@@ -529,11 +608,11 @@ and null values, but it can also represent CBOR-specific features such as byte
 strings, tags, simple values, indefinite-length items, non-string map keys, and
 application literals like `dt'2026-05-06T00:00:00Z'`.
 
-CBOR-EDN is a superset of JSON and JSONC, so ordinary JSON data and
-commented JSON-style data can be parsed and formatted as CBOR-EDN without
+CDN is a superset of JSON and JSONC, so ordinary JSON data and
+commented JSON-style data can be parsed and formatted as CDN without
 special handling.
 
-CBOR-EDN is still an Internet-Draft rather than a widely deployed RFC.
+CDN is still an Internet-Draft rather than a widely deployed RFC.
 
 ## License