@bcts/known-values 1.0.0-alpha.9 → 1.0.0-beta.1

package/src/index.ts

@@ -1,6 +1,133 @@
+/**
+ * Copyright © 2023-2026 Blockchain Commons, LLC
+ * Copyright © 2025-2026 Parity Technologies
+ *
+ */
+
 export { KnownValue, TAG_KNOWN_VALUE, KNOWN_VALUE_TAG, type KnownValueInput } from "./known-value";
 export { KnownValuesStore } from "./known-values-store";
+export { loadBundledRegistries, type RegistryEntry, type RegistryFile } from "./bundled-registries";
 export {
+  // =============================================================================
+  // Raw Value Constants (_RAW)
+  // =============================================================================
+  // General
+  UNIT_RAW,
+  IS_A_RAW,
+  ID_RAW,
+  SIGNED_RAW,
+  NOTE_RAW,
+  HAS_RECIPIENT_RAW,
+  SSKR_SHARE_RAW,
+  CONTROLLER_RAW,
+  KEY_RAW,
+  DEREFERENCE_VIA_RAW,
+  ENTITY_RAW,
+  NAME_RAW,
+  LANGUAGE_RAW,
+  ISSUER_RAW,
+  HOLDER_RAW,
+  SALT_RAW,
+  DATE_RAW,
+  UNKNOWN_VALUE_RAW,
+  VERSION_VALUE_RAW,
+  HAS_SECRET_RAW,
+  DIFF_EDITS_RAW,
+  VALID_FROM_RAW,
+  VALID_UNTIL_RAW,
+  POSITION_RAW,
+  NICKNAME_RAW,
+  VALUE_RAW,
+  ATTESTATION_RAW,
+  VERIFIABLE_AT_RAW,
+  // Attachments
+  ATTACHMENT_RAW,
+  VENDOR_RAW,
+  CONFORMS_TO_RAW,
+  // XID Documents
+  ALLOW_RAW,
+  DENY_RAW,
+  ENDPOINT_RAW,
+  DELEGATE_RAW,
+  PROVENANCE_RAW,
+  PRIVATE_KEY_RAW,
+  SERVICE_RAW,
+  CAPABILITY_RAW,
+  PROVENANCE_GENERATOR_RAW,
+  // XID Privileges
+  PRIVILEGE_ALL_RAW,
+  PRIVILEGE_AUTH_RAW,
+  PRIVILEGE_SIGN_RAW,
+  PRIVILEGE_ENCRYPT_RAW,
+  PRIVILEGE_ELIDE_RAW,
+  PRIVILEGE_ISSUE_RAW,
+  PRIVILEGE_ACCESS_RAW,
+  PRIVILEGE_DELEGATE_RAW,
+  PRIVILEGE_VERIFY_RAW,
+  PRIVILEGE_UPDATE_RAW,
+  PRIVILEGE_TRANSFER_RAW,
+  PRIVILEGE_ELECT_RAW,
+  PRIVILEGE_BURN_RAW,
+  PRIVILEGE_REVOKE_RAW,
+  // Expression and Function Calls
+  BODY_RAW,
+  RESULT_RAW,
+  ERROR_RAW,
+  OK_VALUE_RAW,
+  PROCESSING_VALUE_RAW,
+  SENDER_RAW,
+  SENDER_CONTINUATION_RAW,
+  RECIPIENT_CONTINUATION_RAW,
+  CONTENT_RAW,
+  // Cryptography
+  SEED_TYPE_RAW,
+  PRIVATE_KEY_TYPE_RAW,
+  PUBLIC_KEY_TYPE_RAW,
+  MASTER_KEY_TYPE_RAW,
+  // Cryptocurrency Assets
+  ASSET_RAW,
+  BITCOIN_VALUE_RAW,
+  ETHEREUM_VALUE_RAW,
+  TEZOS_VALUE_RAW,
+  // Cryptocurrency Networks
+  NETWORK_RAW,
+  MAIN_NET_VALUE_RAW,
+  TEST_NET_VALUE_RAW,
+  // Bitcoin
+  BIP32_KEY_TYPE_RAW,
+  CHAIN_CODE_RAW,
+  DERIVATION_PATH_TYPE_RAW,
+  PARENT_PATH_RAW,
+  CHILDREN_PATH_RAW,
+  PARENT_FINGERPRINT_RAW,
+  PSBT_TYPE_RAW,
+  OUTPUT_DESCRIPTOR_TYPE_RAW,
+  OUTPUT_DESCRIPTOR_RAW,
+  // Graphs
+  GRAPH_RAW,
+  SOURCE_TARGET_GRAPH_RAW,
+  PARENT_CHILD_GRAPH_RAW,
+  DIGRAPH_RAW,
+  ACYCLIC_GRAPH_RAW,
+  MULTIGRAPH_RAW,
+  PSEUDOGRAPH_RAW,
+  GRAPH_FRAGMENT_RAW,
+  DAG_RAW,
+  TREE_RAW,
+  FOREST_RAW,
+  COMPOUND_GRAPH_RAW,
+  HYPERGRAPH_RAW,
+  DIHYPERGRAPH_RAW,
+  NODE_RAW,
+  EDGE_RAW,
+  SOURCE_RAW,
+  TARGET_RAW,
+  PARENT_RAW,
+  CHILD_RAW,
+  SELF_RAW,
+  // =============================================================================
+  // KnownValue Constants
+  // =============================================================================
   // General
   UNIT,
   IS_A,
@@ -27,6 +154,9 @@ export {
   VALID_UNTIL,
   POSITION,
   NICKNAME,
+  VALUE,
+  ATTESTATION,
+  VERIFIABLE_AT,
   // Attachments
   ATTACHMENT,
   VENDOR,
@@ -111,5 +241,8 @@ export {
   TARGET,
   PARENT,
   CHILD,
+  SELF,
+  // Registry
   KNOWN_VALUES,
+  LazyKnownValues,
 } from "./known-values-registry";

package/src/known-value.ts

@@ -1,4 +1,8 @@
 /**
+ * Copyright © 2023-2026 Blockchain Commons, LLC
+ * Copyright © 2025-2026 Parity Technologies
+ *
+ *
  * A value in a namespace of unsigned integers that represents a stand-alone
  * ontological concept.
  *
@@ -68,7 +72,7 @@ import {
   decodeCbor,
   MajorType,
 } from "@bcts/dcbor";
-import { KNOWN_VALUE } from "@bcts/components";
+import { KNOWN_VALUE, Digest, type DigestProvider } from "@bcts/components";
 
 /**
  * The numeric value for the CBOR tag used for Known Values.
@@ -88,7 +92,9 @@ export const KNOWN_VALUE_TAG: Tag = KNOWN_VALUE;
  */
 export type KnownValueInput = number | bigint;
 
-export class KnownValue implements CborTaggedEncodable, CborTaggedDecodable<KnownValue> {
+export class KnownValue
+  implements CborTaggedEncodable, CborTaggedDecodable<KnownValue>, DigestProvider
+{
   private readonly _value: bigint;
   private readonly _assignedName: string | undefined;
 
@@ -223,6 +229,32 @@ export class KnownValue implements CborTaggedEncodable, CborTaggedDecodable<Know
     return Number(this._value & BigInt(0xffffffff));
   }
 
+  // ===========================================================================
+  // DigestProvider Implementation
+  // ===========================================================================
+
+  /**
+   * Returns the cryptographic digest of this KnownValue.
+   *
+   * The digest is computed from the tagged CBOR encoding of the value,
+   * providing a unique content-addressable identifier.
+   *
+   * This is used for Envelope integration where KnownValues are hashed
+   * for tree construction.
+   *
+   * @returns A Digest of the tagged CBOR encoding
+   *
+   * @example
+   * ```typescript
+   * const kv = new KnownValue(1, "isA");
+   * const digest = kv.digest();
+   * console.log(digest.hex()); // SHA-256 hash of the CBOR encoding
+   * ```
+   */
+  digest(): Digest {
+    return Digest.fromImage(this.toCborData());
+  }
+
   /**
    * String representation of the KnownValue.
    *
@@ -353,7 +385,7 @@ export class KnownValue implements CborTaggedEncodable, CborTaggedDecodable<Know
     if (cborValue.type !== MajorType.Unsigned) {
       throw new Error(`Expected unsigned integer for KnownValue, got major type ${cborValue.type}`);
     }
-    const numValue = cborValue.value as number | bigint;
+    const numValue = cborValue.value;
     return new KnownValue(typeof numValue === "bigint" ? numValue : BigInt(numValue));
   }
 

package/src/known-values-registry.ts

@@ -1,8 +1,149 @@
+/**
+ * Copyright © 2023-2026 Blockchain Commons, LLC
+ * Copyright © 2025-2026 Parity Technologies
+ *
+ */
+
 import { KnownValue } from "./known-value";
+import { loadBundledRegistries } from "./bundled-registries";
 import { KnownValuesStore } from "./known-values-store";
 
 // For definitions see: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2023-002-known-value.md#appendix-a-registry
 
+// =============================================================================
+// Raw Value Constants (_RAW)
+// =============================================================================
+// These constants provide direct access to the raw numeric values for pattern
+// matching scenarios. They mirror the Rust implementation which creates both
+// XXX_RAW and XXX constants for each known value.
+
+// General
+export const UNIT_RAW = 0n;
+export const IS_A_RAW = 1n;
+export const ID_RAW = 2n;
+export const SIGNED_RAW = 3n;
+export const NOTE_RAW = 4n;
+export const HAS_RECIPIENT_RAW = 5n;
+export const SSKR_SHARE_RAW = 6n;
+export const CONTROLLER_RAW = 7n;
+export const KEY_RAW = 8n;
+export const DEREFERENCE_VIA_RAW = 9n;
+export const ENTITY_RAW = 10n;
+export const NAME_RAW = 11n;
+export const LANGUAGE_RAW = 12n;
+export const ISSUER_RAW = 13n;
+export const HOLDER_RAW = 14n;
+export const SALT_RAW = 15n;
+export const DATE_RAW = 16n;
+export const UNKNOWN_VALUE_RAW = 17n;
+export const VERSION_VALUE_RAW = 18n;
+export const HAS_SECRET_RAW = 19n;
+export const DIFF_EDITS_RAW = 20n;
+export const VALID_FROM_RAW = 21n;
+export const VALID_UNTIL_RAW = 22n;
+export const POSITION_RAW = 23n;
+export const NICKNAME_RAW = 24n;
+export const VALUE_RAW = 25n;
+export const ATTESTATION_RAW = 26n;
+export const VERIFIABLE_AT_RAW = 27n;
+
+// Attachments
+export const ATTACHMENT_RAW = 50n;
+export const VENDOR_RAW = 51n;
+export const CONFORMS_TO_RAW = 52n;
+
+// XID Documents
+export const ALLOW_RAW = 60n;
+export const DENY_RAW = 61n;
+export const ENDPOINT_RAW = 62n;
+export const DELEGATE_RAW = 63n;
+export const PROVENANCE_RAW = 64n;
+export const PRIVATE_KEY_RAW = 65n;
+export const SERVICE_RAW = 66n;
+export const CAPABILITY_RAW = 67n;
+export const PROVENANCE_GENERATOR_RAW = 68n;
+
+// XID Privileges
+export const PRIVILEGE_ALL_RAW = 70n;
+export const PRIVILEGE_AUTH_RAW = 71n;
+export const PRIVILEGE_SIGN_RAW = 72n;
+export const PRIVILEGE_ENCRYPT_RAW = 73n;
+export const PRIVILEGE_ELIDE_RAW = 74n;
+export const PRIVILEGE_ISSUE_RAW = 75n;
+export const PRIVILEGE_ACCESS_RAW = 76n;
+export const PRIVILEGE_DELEGATE_RAW = 80n;
+export const PRIVILEGE_VERIFY_RAW = 81n;
+export const PRIVILEGE_UPDATE_RAW = 82n;
+export const PRIVILEGE_TRANSFER_RAW = 83n;
+export const PRIVILEGE_ELECT_RAW = 84n;
+export const PRIVILEGE_BURN_RAW = 85n;
+export const PRIVILEGE_REVOKE_RAW = 86n;
+
+// Expression and Function Calls
+export const BODY_RAW = 100n;
+export const RESULT_RAW = 101n;
+export const ERROR_RAW = 102n;
+export const OK_VALUE_RAW = 103n;
+export const PROCESSING_VALUE_RAW = 104n;
+export const SENDER_RAW = 105n;
+export const SENDER_CONTINUATION_RAW = 106n;
+export const RECIPIENT_CONTINUATION_RAW = 107n;
+export const CONTENT_RAW = 108n;
+
+// Cryptography
+export const SEED_TYPE_RAW = 200n;
+export const PRIVATE_KEY_TYPE_RAW = 201n;
+export const PUBLIC_KEY_TYPE_RAW = 202n;
+export const MASTER_KEY_TYPE_RAW = 203n;
+
+// Cryptocurrency Assets
+export const ASSET_RAW = 300n;
+export const BITCOIN_VALUE_RAW = 301n;
+export const ETHEREUM_VALUE_RAW = 302n;
+export const TEZOS_VALUE_RAW = 303n;
+
+// Cryptocurrency Networks
+export const NETWORK_RAW = 400n;
+export const MAIN_NET_VALUE_RAW = 401n;
+export const TEST_NET_VALUE_RAW = 402n;
+
+// Bitcoin
+export const BIP32_KEY_TYPE_RAW = 500n;
+export const CHAIN_CODE_RAW = 501n;
+export const DERIVATION_PATH_TYPE_RAW = 502n;
+export const PARENT_PATH_RAW = 503n;
+export const CHILDREN_PATH_RAW = 504n;
+export const PARENT_FINGERPRINT_RAW = 505n;
+export const PSBT_TYPE_RAW = 506n;
+export const OUTPUT_DESCRIPTOR_TYPE_RAW = 507n;
+export const OUTPUT_DESCRIPTOR_RAW = 508n;
+
+// Graphs
+export const GRAPH_RAW = 600n;
+export const SOURCE_TARGET_GRAPH_RAW = 601n;
+export const PARENT_CHILD_GRAPH_RAW = 602n;
+export const DIGRAPH_RAW = 603n;
+export const ACYCLIC_GRAPH_RAW = 604n;
+export const MULTIGRAPH_RAW = 605n;
+export const PSEUDOGRAPH_RAW = 606n;
+export const GRAPH_FRAGMENT_RAW = 607n;
+export const DAG_RAW = 608n;
+export const TREE_RAW = 609n;
+export const FOREST_RAW = 610n;
+export const COMPOUND_GRAPH_RAW = 611n;
+export const HYPERGRAPH_RAW = 612n;
+export const DIHYPERGRAPH_RAW = 613n;
+export const NODE_RAW = 700n;
+export const EDGE_RAW = 701n;
+export const SOURCE_RAW = 702n;
+export const TARGET_RAW = 703n;
+export const PARENT_RAW = 704n;
+export const CHILD_RAW = 705n;
+
+// =============================================================================
+// KnownValue Constants
+// =============================================================================
+
 //
 // General
 //
@@ -32,7 +173,10 @@ export const VALID_FROM = new KnownValue(21, "validFrom");
 export const VALID_UNTIL = new KnownValue(22, "validUntil");
 export const POSITION = new KnownValue(23, "position");
 export const NICKNAME = new KnownValue(24, "nickname");
-// 25-49 *unassigned*
+export const VALUE = new KnownValue(25, "value");
+export const ATTESTATION = new KnownValue(26, "attestation");
+export const VERIFIABLE_AT = new KnownValue(27, "verifiableAt");
+// 28-49 *unassigned*
 
 //
 // Attachments
@@ -63,7 +207,7 @@ export const PROVENANCE_GENERATOR = new KnownValue(68, "provenanceGenerator");
 //
 
 export const PRIVILEGE_ALL = new KnownValue(70, "All");
-export const PRIVILEGE_AUTH = new KnownValue(71, "Auth");
+export const PRIVILEGE_AUTH = new KnownValue(71, "Authorize");
 export const PRIVILEGE_SIGN = new KnownValue(72, "Sign");
 export const PRIVILEGE_ENCRYPT = new KnownValue(73, "Encrypt");
 export const PRIVILEGE_ELIDE = new KnownValue(74, "Elide");
@@ -109,9 +253,9 @@ export const MASTER_KEY_TYPE = new KnownValue(203, "MasterKey");
 //
 
 export const ASSET = new KnownValue(300, "asset");
-export const BITCOIN_VALUE = new KnownValue(301, "BTC");
-export const ETHEREUM_VALUE = new KnownValue(302, "ETH");
-export const TEZOS_VALUE = new KnownValue(303, "XTZ");
+export const BITCOIN_VALUE = new KnownValue(301, "Bitcoin");
+export const ETHEREUM_VALUE = new KnownValue(302, "Ethereum");
+export const TEZOS_VALUE = new KnownValue(303, "Tezos");
 // 304-399 *unassigned*
 
 //
@@ -130,8 +274,8 @@ export const TEST_NET_VALUE = new KnownValue(402, "TestNet");
 export const BIP32_KEY_TYPE = new KnownValue(500, "BIP32Key");
 export const CHAIN_CODE = new KnownValue(501, "chainCode");
 export const DERIVATION_PATH_TYPE = new KnownValue(502, "DerivationPath");
-export const PARENT_PATH = new KnownValue(503, "parent");
-export const CHILDREN_PATH = new KnownValue(504, "children");
+export const PARENT_PATH = new KnownValue(503, "parentPath");
+export const CHILDREN_PATH = new KnownValue(504, "childrenPath");
 export const PARENT_FINGERPRINT = new KnownValue(505, "parentFingerprint");
 export const PSBT_TYPE = new KnownValue(506, "PSBT");
 export const OUTPUT_DESCRIPTOR_TYPE = new KnownValue(507, "OutputDescriptor");
@@ -142,7 +286,7 @@ export const OUTPUT_DESCRIPTOR = new KnownValue(508, "outputDescriptor");
 // Graphs
 //
 
-export const GRAPH = new KnownValue(600, "graph");
+export const GRAPH = new KnownValue(600, "Graph");
 export const SOURCE_TARGET_GRAPH = new KnownValue(601, "SourceTargetGraph");
 export const PARENT_CHILD_GRAPH = new KnownValue(602, "ParentChildGraph");
 export const DIGRAPH = new KnownValue(603, "Digraph");
@@ -163,7 +307,9 @@ export const SOURCE = new KnownValue(702, "source");
 export const TARGET = new KnownValue(703, "target");
 export const PARENT = new KnownValue(704, "parent");
 export const CHILD = new KnownValue(705, "child");
-// 706-... *unassigned*
+export const SELF_RAW = 706n;
+export const SELF = new KnownValue(706, "Self");
+// 707-... *unassigned*
 
 /**
  * A lazily initialized singleton that holds the global registry of known
@@ -178,7 +324,7 @@ export const CHILD = new KnownValue(705, "child");
  * users of the API, who should access Known Values through the constants
  * exposed in the `known_values` module.
  */
-class LazyKnownValues {
+export class LazyKnownValues {
   private _data: KnownValuesStore | undefined;
 
   /**
@@ -187,108 +333,122 @@ class LazyKnownValues {
    * This method guarantees that initialization occurs exactly once.
    */
   get(): KnownValuesStore {
-    this._data ??= new KnownValuesStore([
-      UNIT,
-      IS_A,
-      ID,
-      SIGNED,
-      NOTE,
-      HAS_RECIPIENT,
-      SSKR_SHARE,
-      CONTROLLER,
-      KEY,
-      DEREFERENCE_VIA,
-      ENTITY,
-      NAME,
-      LANGUAGE,
-      ISSUER,
-      HOLDER,
-      SALT,
-      DATE,
-      UNKNOWN_VALUE,
-      VERSION_VALUE,
-      HAS_SECRET,
-      DIFF_EDITS,
-      VALID_FROM,
-      VALID_UNTIL,
-      POSITION,
-      NICKNAME,
-      ATTACHMENT,
-      VENDOR,
-      CONFORMS_TO,
-      ALLOW,
-      DENY,
-      ENDPOINT,
-      DELEGATE,
-      PROVENANCE,
-      PRIVATE_KEY,
-      SERVICE,
-      CAPABILITY,
-      PROVENANCE_GENERATOR,
-      PRIVILEGE_ALL,
-      PRIVILEGE_AUTH,
-      PRIVILEGE_SIGN,
-      PRIVILEGE_ENCRYPT,
-      PRIVILEGE_ELIDE,
-      PRIVILEGE_ISSUE,
-      PRIVILEGE_ACCESS,
-      PRIVILEGE_DELEGATE,
-      PRIVILEGE_VERIFY,
-      PRIVILEGE_UPDATE,
-      PRIVILEGE_TRANSFER,
-      PRIVILEGE_ELECT,
-      PRIVILEGE_BURN,
-      PRIVILEGE_REVOKE,
-      BODY,
-      RESULT,
-      ERROR,
-      OK_VALUE,
-      PROCESSING_VALUE,
-      SENDER,
-      SENDER_CONTINUATION,
-      RECIPIENT_CONTINUATION,
-      CONTENT,
-      SEED_TYPE,
-      PRIVATE_KEY_TYPE,
-      PUBLIC_KEY_TYPE,
-      MASTER_KEY_TYPE,
-      ASSET,
-      BITCOIN_VALUE,
-      ETHEREUM_VALUE,
-      TEZOS_VALUE,
-      NETWORK,
-      MAIN_NET_VALUE,
-      TEST_NET_VALUE,
-      BIP32_KEY_TYPE,
-      CHAIN_CODE,
-      DERIVATION_PATH_TYPE,
-      PARENT_PATH,
-      CHILDREN_PATH,
-      PARENT_FINGERPRINT,
-      PSBT_TYPE,
-      OUTPUT_DESCRIPTOR_TYPE,
-      OUTPUT_DESCRIPTOR,
-      GRAPH,
-      SOURCE_TARGET_GRAPH,
-      PARENT_CHILD_GRAPH,
-      DIGRAPH,
-      ACYCLIC_GRAPH,
-      MULTIGRAPH,
-      PSEUDOGRAPH,
-      GRAPH_FRAGMENT,
-      DAG,
-      TREE,
-      FOREST,
-      COMPOUND_GRAPH,
-      HYPERGRAPH,
-      DIHYPERGRAPH,
-      NODE,
-      EDGE,
-      SOURCE,
-      TARGET,
-      PARENT,
-      CHILD,
-    ]);
+    if (this._data === undefined) {
+      const store = new KnownValuesStore([
+        UNIT,
+        IS_A,
+        ID,
+        SIGNED,
+        NOTE,
+        HAS_RECIPIENT,
+        SSKR_SHARE,
+        CONTROLLER,
+        KEY,
+        DEREFERENCE_VIA,
+        ENTITY,
+        NAME,
+        LANGUAGE,
+        ISSUER,
+        HOLDER,
+        SALT,
+        DATE,
+        UNKNOWN_VALUE,
+        VERSION_VALUE,
+        HAS_SECRET,
+        DIFF_EDITS,
+        VALID_FROM,
+        VALID_UNTIL,
+        POSITION,
+        NICKNAME,
+        VALUE,
+        ATTESTATION,
+        VERIFIABLE_AT,
+        ATTACHMENT,
+        VENDOR,
+        CONFORMS_TO,
+        ALLOW,
+        DENY,
+        ENDPOINT,
+        DELEGATE,
+        PROVENANCE,
+        PRIVATE_KEY,
+        SERVICE,
+        CAPABILITY,
+        PROVENANCE_GENERATOR,
+        PRIVILEGE_ALL,
+        PRIVILEGE_AUTH,
+        PRIVILEGE_SIGN,
+        PRIVILEGE_ENCRYPT,
+        PRIVILEGE_ELIDE,
+        PRIVILEGE_ISSUE,
+        PRIVILEGE_ACCESS,
+        PRIVILEGE_DELEGATE,
+        PRIVILEGE_VERIFY,
+        PRIVILEGE_UPDATE,
+        PRIVILEGE_TRANSFER,
+        PRIVILEGE_ELECT,
+        PRIVILEGE_BURN,
+        PRIVILEGE_REVOKE,
+        BODY,
+        RESULT,
+        ERROR,
+        OK_VALUE,
+        PROCESSING_VALUE,
+        SENDER,
+        SENDER_CONTINUATION,
+        RECIPIENT_CONTINUATION,
+        CONTENT,
+        SEED_TYPE,
+        PRIVATE_KEY_TYPE,
+        PUBLIC_KEY_TYPE,
+        MASTER_KEY_TYPE,
+        ASSET,
+        BITCOIN_VALUE,
+        ETHEREUM_VALUE,
+        TEZOS_VALUE,
+        NETWORK,
+        MAIN_NET_VALUE,
+        TEST_NET_VALUE,
+        BIP32_KEY_TYPE,
+        CHAIN_CODE,
+        DERIVATION_PATH_TYPE,
+        PARENT_PATH,
+        CHILDREN_PATH,
+        PARENT_FINGERPRINT,
+        PSBT_TYPE,
+        OUTPUT_DESCRIPTOR_TYPE,
+        OUTPUT_DESCRIPTOR,
+        GRAPH,
+        SOURCE_TARGET_GRAPH,
+        PARENT_CHILD_GRAPH,
+        DIGRAPH,
+        ACYCLIC_GRAPH,
+        MULTIGRAPH,
+        PSEUDOGRAPH,
+        GRAPH_FRAGMENT,
+        DAG,
+        TREE,
+        FOREST,
+        COMPOUND_GRAPH,
+        HYPERGRAPH,
+        DIHYPERGRAPH,
+        NODE,
+        EDGE,
+        SOURCE,
+        TARGET,
+        PARENT,
+        CHILD,
+      ]);
+
+      // Load bundled registry values from JSON data files.
+      // These are embedded at build time and available in all environments.
+      // Matching Rust behavior: later inserts overwrite earlier ones.
+      for (const value of loadBundledRegistries()) {
+        store.insert(value);
+      }
+
+      this._data = store;
+    }
     return this._data;
   }
 }

package/src/known-values-store.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright © 2023-2026 Blockchain Commons, LLC
+ * Copyright © 2025-2026 Parity Technologies
+ *
+ */
+
 import { KnownValue, type KnownValueInput } from "./known-value";
 
 /**
@@ -318,6 +324,16 @@ export class KnownValuesStore {
    * Internal helper method to insert a KnownValue into the store's maps.
    */
   private _insert(knownValue: KnownValue): void {
+    // If there's an existing value with the same codepoint, remove its name
+    // from the name index to avoid stale entries
+    const existing = this.knownValuesByRawValue.get(knownValue.valueBigInt());
+    if (existing !== undefined) {
+      const oldName = existing.assignedName();
+      if (oldName !== undefined && oldName !== "") {
+        this.knownValuesByAssignedName.delete(oldName);
+      }
+    }
+
     this.knownValuesByRawValue.set(knownValue.valueBigInt(), knownValue);
     const assignedName = knownValue.assignedName();
     if (assignedName !== undefined && assignedName !== "") {