@bcts/known-values 1.0.0-alpha.17 → 1.0.0-alpha.18

package/src/known-values-registry.ts

@@ -1,4 +1,5 @@
 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
@@ -194,7 +195,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");
@@ -240,9 +241,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*
 
 //
@@ -261,8 +262,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");
@@ -273,7 +274,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");
@@ -294,7 +295,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
@@ -318,108 +321,119 @@ export 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,
+        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

@@ -318,6 +318,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 !== "") {