@unyt/datex 0.0.14 → 0.0.15

package/esm/dif/display.d.ts

@@ -3,15 +3,18 @@
  * @description
  * This module contains helper functions to convert DIF structures to display strings.
  */
-import { type DIFRepresentationValue, type DIFSharedValue, DIFSharedValueMutability, type DIFTypeDefinition, type DIFValueContainer } from "./definitions.js";
+import { SharedContainerMutability } from "../shared-container/mod.js";
+import { CoreLibTypeId } from "./core.js";
+import type { DIFBaseSharedValueContainer, DIFCoreValue, DIFTypeDefinition, DIFValueContainer } from "./types/mod.js";
+import type { PointerAddress } from "../shared-container/mod.js";
 /**
  * Converts a DIF reference mutability to a display string.
  */
-export declare function mutabilityToDisplayString(mut: DIFSharedValueMutability): string;
+export declare function mutabilityToDisplayString(mut: SharedContainerMutability): string;
 /**
  * Converts a DIF reference to a display string.
  */
-export declare function difReferenceToDisplayString(reference: DIFSharedValue): string;
+export declare function difBaseSharedContainerToDisplayString(reference: DIFBaseSharedValueContainer): string;
 /**
  * Converts a DIF value container to a display string.
  */
@@ -19,7 +22,7 @@ export declare function difValueContainerToDisplayString(container: DIFValueCont
 /**
  * Converts a DIF representation value to a display string.
  */
-export declare function difRepresentationValueToDisplayString(difRepValue: DIFRepresentationValue): string;
+export declare function difCoreValueToDisplayString(id: CoreLibTypeId, coreValue: DIFCoreValue): string;
 /**
  * Converts a DIF type definition to a display string.
  */
@@ -27,5 +30,11 @@ export declare function difTypeDefinitionToDisplayString(difType: DIFTypeDefinit
 /**
  * Converts a core type address to a display string.
  */
-export declare function addressToDisplayString(address: string): string;
+export declare function addressToDisplayString(address: PointerAddress): string;
+/**
+ * Converts a core lib type id to a display string.
+ * @param typeId The core lib type id to convert.
+ * @returns The display string for the given core lib type id.
+ */
+export declare function coreLibTypeIdToDisplayString(typeId: CoreLibTypeId): string;
 //# sourceMappingURL=display.d.ts.map

package/esm/dif/display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/dif/display.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACzB,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAO/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,cAAc,GAC1B,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,iBAAiB,GAC7B,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACjD,WAAW,EAAE,sBAAsB,GACpC,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,OAAO,EAAE,iBAAiB,GAC3B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS9D"}
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/dif/display.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACR,2BAA2B,EAC3B,YAAY,EACZ,iBAAiB,EAGjB,iBAAiB,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,CAOhF;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACjD,SAAS,EAAE,2BAA2B,GACvC,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,iBAAiB,GAC7B,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,EAAE,EAAE,aAAa,EACjB,SAAS,EAAE,YAAY,GACxB,MAAM,CA4ER;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,OAAO,EAAE,iBAAiB,GAC3B,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,aAAa,GACtB,MAAM,CAIR"}

package/esm/dif/display.js

@@ -3,16 +3,16 @@
  * @description
  * This module contains helper functions to convert DIF structures to display strings.
  */
-import { DIFSharedValueMutability, } from "./definitions.js";
-import { CoreTypeAddress } from "./core.js";
+import { SharedContainerMutability } from "../shared-container/mod.js";
+import { CoreLibTypeId } from "./core.js";
 /**
  * Converts a DIF reference mutability to a display string.
  */
 export function mutabilityToDisplayString(mut) {
-    if (mut === DIFSharedValueMutability.Mutable) {
+    if (mut === SharedContainerMutability.Mutable) {
         return "&mut ";
     }
-    else if (mut === DIFSharedValueMutability.Immutable) {
+    else if (mut === SharedContainerMutability.Immutable) {
         return "&";
     }
     throw new Error("Unknown mutability: " + mut);
@@ -20,22 +20,23 @@ export function mutabilityToDisplayString(mut) {
 /**
  * Converts a DIF reference to a display string.
  */
-export function difReferenceToDisplayString(reference) {
-    const typeString = difTypeDefinitionToDisplayString(reference.allowed_type);
-    const valueString = difValueContainerToDisplayString(reference.value);
-    const mutString = mutabilityToDisplayString(reference.mut);
+export function difBaseSharedContainerToDisplayString(reference) {
+    const valueString = difValueContainerToDisplayString(reference[0]);
+    const mutString = mutabilityToDisplayString(reference[1]);
+    const typeString = difTypeDefinitionToDisplayString(reference[2]);
     return `${mutString}${valueString} (allowed: ${typeString})`;
 }
 /**
  * Converts a DIF value container to a display string.
  */
 export function difValueContainerToDisplayString(container) {
-    if (typeof container === "string") {
-        return addressToDisplayString(container);
+    if (typeof container === "object" && container !== null && "$" in container) {
+        return container.$;
     }
-    else {
-        const typeString = container.type ? difTypeDefinitionToDisplayString(container.type) : null;
-        const valueString = difRepresentationValueToDisplayString(container.value);
+    else if (Array.isArray(container)) {
+        const [typeId, value, typeDef] = container;
+        const typeString = typeDef ? difTypeDefinitionToDisplayString(typeDef) : null;
+        const valueString = difCoreValueToDisplayString(typeId, value);
         if (typeString) {
             return `{ type: ${typeString}, value: ${valueString} }`;
         }
@@ -43,51 +44,100 @@ export function difValueContainerToDisplayString(container) {
             return valueString;
         }
     }
+    else {
+        return JSON.stringify(container);
+    }
 }
 /**
  * Converts a DIF representation value to a display string.
  */
-export function difRepresentationValueToDisplayString(difRepValue) {
-    if (Array.isArray(difRepValue)) {
-        return `[${difRepValue.map((v) => {
-            if (Array.isArray(v)) {
-                return `[${v.map((vv) => difValueContainerToDisplayString(vv))
-                    .join(", ")}]`;
+export function difCoreValueToDisplayString(id, coreValue) {
+    switch (id) {
+        case CoreLibTypeId.boolean:
+        case CoreLibTypeId.text:
+        case CoreLibTypeId.endpoint:
+        case CoreLibTypeId.integer:
+        case CoreLibTypeId.integer_i8:
+        case CoreLibTypeId.integer_i16:
+        case CoreLibTypeId.integer_i32:
+        case CoreLibTypeId.integer_i64:
+        case CoreLibTypeId.integer_i128:
+        case CoreLibTypeId.integer_u8:
+        case CoreLibTypeId.integer_u16:
+        case CoreLibTypeId.integer_u32:
+        case CoreLibTypeId.integer_u64:
+        case CoreLibTypeId.integer_u128:
+        case CoreLibTypeId.integer_ibig:
+        case CoreLibTypeId.decimal_f32:
+        case CoreLibTypeId.decimal_f64:
+        case CoreLibTypeId.decimal_dbig:
+        case CoreLibTypeId.null:
+        case CoreLibTypeId.decimal:
+            return JSON.stringify(coreValue);
+        case CoreLibTypeId.Unit:
+            return "()";
+        case CoreLibTypeId.Never:
+            return "never";
+        case CoreLibTypeId.Unknown:
+            return "unknown";
+        case CoreLibTypeId.Range:
+            if (Array.isArray(coreValue)) {
+                return `[${difValueContainerToDisplayString(coreValue[0])}, ${difValueContainerToDisplayString(coreValue[1])}]`;
+            }
+            else if (coreValue && typeof coreValue === "object") {
+                return `{ start: ${difValueContainerToDisplayString(coreValue.start)}, end: ${difValueContainerToDisplayString(coreValue.end)} }`;
             }
             else {
-                return difValueContainerToDisplayString(v);
+                throw new Error("Invalid range value: " + JSON.stringify(coreValue));
             }
-        }).join(", ")}]`;
-    }
-    else if (difRepValue && typeof difRepValue === "object") {
-        return `{ ${Object.entries(difRepValue).map(([k, v]) => `${k}: ${difValueContainerToDisplayString(v)}`).join(", ")} }`;
-    }
-    else {
-        return JSON.stringify(difRepValue);
+        case CoreLibTypeId.Type:
+            return difTypeDefinitionToDisplayString(coreValue);
+        case CoreLibTypeId.Map:
+            if (Array.isArray(coreValue)) {
+                return `[${coreValue
+                    .map((value) => {
+                    if (Array.isArray(value)) {
+                        return `[${value
+                            .map((item) => difValueContainerToDisplayString(item))
+                            .join(", ")}]`;
+                    }
+                    return difValueContainerToDisplayString(value);
+                })
+                    .join(", ")}]`;
+            }
+            if (coreValue && typeof coreValue === "object") {
+                return `{ ${Object.entries(coreValue)
+                    .map(([key, value]) => `${key}: ${difValueContainerToDisplayString(value)}`)
+                    .join(", ")} }`;
+            }
+            throw new Error("Invalid map value: " + JSON.stringify(coreValue));
+        default:
+            throw new Error("Unknown core lib type id: " + id);
     }
 }
 /**
  * Converts a DIF type definition to a display string.
  */
 export function difTypeDefinitionToDisplayString(difType) {
-    if (typeof difType === "string") {
-        return addressToDisplayString(difType);
+    if (typeof difType === "number") {
+        return coreLibTypeIdToDisplayString(difType);
     }
     else {
-        return `{ kind: ${difType.kind}, def: ${JSON.stringify(difType.def)} }`;
+        const [key, def] = Object.entries(difType)[0];
+        return `{ ${key}: ${JSON.stringify(def)} }`;
     }
 }
 /**
  * Converts a core type address to a display string.
  */
 export function addressToDisplayString(address) {
-    const found = Object.entries(CoreTypeAddress).find(([_, addr]) => {
-        return addr === address;
-    });
-    if (found) {
-        return found[0];
-    }
-    else {
-        return "$" + address;
-    }
+    return `$${address}`;
+}
+/**
+ * Converts a core lib type id to a display string.
+ * @param typeId The core lib type id to convert.
+ * @returns The display string for the given core lib type id.
+ */
+export function coreLibTypeIdToDisplayString(typeId) {
+    return Object.entries(CoreLibTypeId).find(([, value]) => value === typeId)?.[0] ?? "Unknown";
 }

package/esm/dif/helpers/mod.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @module
+ * This module contains shortcut functions for creating dif values.
+ */
+export * from "./typed-integer.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/dif/helpers/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/dif/helpers/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/esm/dif/helpers/mod.js

@@ -0,0 +1,5 @@
+/**
+ * @module
+ * This module contains shortcut functions for creating dif values.
+ */
+export * from "./typed-integer.js";

package/esm/dif/helpers/typed-integer.d.ts

@@ -0,0 +1,14 @@
+import type { DIFValue } from "../types/value.js";
+export declare function i8(value: number): DIFValue;
+export declare function i16(value: number): DIFValue;
+export declare function i32(value: number): DIFValue;
+export declare function i64(value: number): DIFValue;
+export declare function u8(value: number): DIFValue;
+export declare function u16(value: number): DIFValue;
+export declare function u32(value: number): DIFValue;
+export declare function u64(value: bigint): DIFValue;
+export declare function i128(value: bigint): DIFValue;
+export declare function u128(value: bigint): DIFValue;
+export declare function ibig(value: bigint): DIFValue;
+export declare function integer(value: number | bigint): DIFValue;
+//# sourceMappingURL=typed-integer.d.ts.map

package/esm/dif/helpers/typed-integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-integer.d.ts","sourceRoot":"","sources":["../../../src/dif/helpers/typed-integer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE1C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AACD,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE1C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AACD,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE5C;AACD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAExD"}

package/esm/dif/helpers/typed-integer.js

@@ -0,0 +1,37 @@
+import { CoreLibTypeId } from "../core.js";
+export function i8(value) {
+    return [CoreLibTypeId.integer_i8, value];
+}
+export function i16(value) {
+    return [CoreLibTypeId.integer_i16, value];
+}
+export function i32(value) {
+    return [CoreLibTypeId.integer_i32, value];
+}
+export function i64(value) {
+    return [CoreLibTypeId.integer_i64, value];
+}
+export function u8(value) {
+    return [CoreLibTypeId.integer_u8, value];
+}
+export function u16(value) {
+    return [CoreLibTypeId.integer_u16, value];
+}
+export function u32(value) {
+    return [CoreLibTypeId.integer_u32, value];
+}
+export function u64(value) {
+    return [CoreLibTypeId.integer_u64, value.toString()];
+}
+export function i128(value) {
+    return [CoreLibTypeId.integer_i128, value.toString()];
+}
+export function u128(value) {
+    return [CoreLibTypeId.integer_u128, value.toString()];
+}
+export function ibig(value) {
+    return [CoreLibTypeId.integer_ibig, value.toString()];
+}
+export function integer(value) {
+    return [CoreLibTypeId.integer, value.toString()];
+}

package/esm/dif/js-lib.d.ts

@@ -1,5 +1,18 @@
+import type { PointerAddress } from "../shared-container/mod.js";
+/**
+ * Creates a reserved pointer address for a js lib type with the given id.
+ * The endpoint is the broadcast (reserved) endpoint. This can be used for builtin types.
+ * @param id Id of the js lib type. Must be a non-negative integer that fits into 5 bytes.
+ * @returns The reserved pointer address for the js lib type with the given id.
+ */
+export declare function createReservedPointerAddress(id: number): PointerAddress;
+/**
+ * Mapping of js lib types to their unique reserved internal pointer addresses.
+ * These addresses are used to identify impl types dedicated to special js lib types.
+ */
 export declare const JsLibTypeAddress: {
-    readonly undefined: "111111";
+    readonly undefined: PointerAddress;
+    readonly map: PointerAddress;
 };
 /**
  * Type representing the unique pointer addresses of js lib types.

package/esm/dif/js-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"js-lib.d.ts","sourceRoot":"","sources":["../../src/dif/js-lib.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;CAEnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"js-lib.d.ts","sourceRoot":"","sources":["../../src/dif/js-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAMvE;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/esm/dif/js-lib.js

@@ -1,3 +1,21 @@
+/**
+ * Creates a reserved pointer address for a js lib type with the given id.
+ * The endpoint is the broadcast (reserved) endpoint. This can be used for builtin types.
+ * @param id Id of the js lib type. Must be a non-negative integer that fits into 5 bytes.
+ * @returns The reserved pointer address for the js lib type with the given id.
+ */
+export function createReservedPointerAddress(id) {
+    const idHex = id.toString(16).toLowerCase();
+    if (!Number.isInteger(id) || id < 0 || idHex.length > 10) {
+        throw new Error("invalid id");
+    }
+    return "ff".repeat(21) + idHex.padStart(10, "0");
+}
+/**
+ * Mapping of js lib types to their unique reserved internal pointer addresses.
+ * These addresses are used to identify impl types dedicated to special js lib types.
+ */
 export const JsLibTypeAddress = {
-    undefined: "111111",
+    undefined: createReservedPointerAddress(0),
+    map: createReservedPointerAddress(1),
 };

package/esm/dif/mod.d.ts

@@ -3,7 +3,7 @@
  * @description
  * This namespace contains all modules related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
  */
-export * as Definitions from "./definitions.js";
 export * as Display from "./display.js";
-export { CoreTypeAddress } from "./core.js";
+export { CoreLibTypeId } from "./core.js";
+export * as Definitions from "./types/mod.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/dif/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/dif/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/dif/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC"}

package/esm/dif/mod.js

@@ -3,6 +3,6 @@
  * @description
  * This namespace contains all modules related to the DIF (DATEX Interchange Format) interfaces of the DATEX runtime.
  */
-export * as Definitions from "./definitions.js";
 export * as Display from "./display.js";
-export { CoreTypeAddress } from "./core.js";
+export { CoreLibTypeId } from "./core.js";
+export * as Definitions from "./types/mod.js";

package/esm/dif/type-registry.d.ts

@@ -1,5 +1,10 @@
-import { type DIFTypeDefinition, type DIFUpdateData, DIFUpdateKind } from "./definitions.js";
-import { type CustomReferenceMetadata, type DIFHandler } from "./dif-handler.js";
+/**
+ * This module implements the TypeRegistry and TypeBinding classes which allow registering custom type definitions and bindings to JS implementations.
+ */
+import type { CoreLibTypeId } from "./core.js";
+import { type DIFTypeDefinition, type DIFUpdateData, DIFUpdateKind } from "./types/mod.js";
+import { type CachedSharedContainer, type CustomReferenceMetadata, type DIFHandler } from "./dif-handler.js";
+import type { PointerAddress, SharedContainerMutability, SharedRef } from "../shared-container/mod.js";
 type ImplMethod = {
     name: string;
     implementation: (...args: unknown[]) => unknown;
@@ -26,15 +31,16 @@ export type BindResult<T, M extends CustomReferenceMetadata> = {
     value: T;
     metadata: M;
 };
-export type TypeBindingDefinition<T, M extends CustomReferenceMetadata = CustomReferenceMetadata> = {
-    typeAddress: string;
-    bind(this: TypeBindingContext<M>, value: T, pointerAddress: string): BindResult<T, M>;
-    handleSet?(this: TypeBindingContext<M>, target: T, key: unknown, value: unknown): void;
-    handleAppend?(this: TypeBindingContext<M>, target: T, value: unknown): void;
-    handleReplace?(this: TypeBindingContext<M>, parent: T, newValue: unknown): void;
-    handleDelete?(this: TypeBindingContext<M>, target: T, key: unknown): void;
-    handleClear?(this: TypeBindingContext<M>, target: T): void;
-    handleListSplice?(this: TypeBindingContext<M>, target: T, start: number, deleteCount: number, items: unknown[]): void;
+export type TypeBindingDefinition<T extends object, M extends CustomReferenceMetadata = CustomReferenceMetadata> = {
+    coreLibTypeId?: CoreLibTypeId;
+    pointerAddress?: PointerAddress;
+    bind(this: TypeBindingContext<M>, value: SharedRef<T, SharedContainerMutability>, pointerAddress: PointerAddress): BindResult<T, M>;
+    handleSet?(this: TypeBindingContext<M>, target: SharedRef<T, SharedContainerMutability>, key: unknown, value: unknown): void;
+    handleAppend?(this: TypeBindingContext<M>, target: SharedRef<T, SharedContainerMutability>, value: unknown): void;
+    handleReplace?(this: TypeBindingContext<M>, parent: SharedRef<T, SharedContainerMutability>, newValue: unknown): void;
+    handleDelete?(this: TypeBindingContext<M>, target: SharedRef<T, SharedContainerMutability>, key: unknown): void;
+    handleClear?(this: TypeBindingContext<M>, target: SharedRef<T, SharedContainerMutability>): void;
+    handleListSplice?(this: TypeBindingContext<M>, target: SharedRef<T, SharedContainerMutability>, start: number, deleteCount: number, items: unknown[]): void;
 };
 export declare class TypeRegistry {
     #private;
@@ -48,33 +54,36 @@ export declare class TypeRegistry {
      * Binds an existing nominal type to a JS mirror implementation.
      * @param typePointerAddress The address of the type pointer in the Datex runtime.
      */
-    registerTypeBinding<T>(typeBindingDefinition: TypeBindingDefinition<T>): void;
+    registerTypeBinding<T extends object>(typeBindingDefinition: TypeBindingDefinition<T>): void;
     /**
-     * @private
      * Gets the type binding for a given type pointer address.
+     * @param typePointerAddress The pointer address of the type in the Datex runtime.
+     * @returns The corresponding TypeBinding or null if no binding is found for the given pointer address.
      */
-    _getTypeBinding(typePointerAddress: string): TypeBinding | null;
+    getTypeBinding(typePointerAddress: string): TypeBinding | null;
     /**
-     * Gets the type binding for a given type pointer address.
+     * Gets the type binding for a given core library type id.
+     * @param coreLibTypeId
+     * @returns
      */
-    getTypeBinding(typePointerAddress: string): TypeBinding | null;
+    getTypeBindingByCoreLibTypeId(coreLibTypeId: CoreLibTypeId): TypeBinding | null;
 }
-export declare class TypeBinding<T extends WeakKey = WeakKey, M extends CustomReferenceMetadata = CustomReferenceMetadata> {
+export declare class TypeBinding<T extends object = object, M extends CustomReferenceMetadata = CustomReferenceMetadata> {
     #private;
     get difHandler(): DIFHandler;
-    getCustomReferenceMetadata(value: T): M;
+    getCustomReferenceMetadata(value: CachedSharedContainer): M;
     constructor(definition: TypeBindingDefinition<T, M>, difHandler: DIFHandler);
     /**
      * Binds a new JS value to this type binding.
      * @returns
      */
-    bindValue(value: T, pointerAddress: string): BindResult<T, M>;
+    bindValue(value: T, pointerAddress: PointerAddress): BindResult<T, M>;
     /**
      * Sets up observers for the given value and pointer address if there are update handlers defined for this type binding.
      */
-    handleDifUpdate(value: T, pointerAddress: string, difUpdateData: DIFUpdateData): void;
+    handleDifUpdate(val: T, pointerAddress: string, difUpdateData: DIFUpdateData): void;
     getUpdateHandlerTypes(): Set<DIFUpdateKind>;
-    allowOriginalValueAccess<R>(target: T, callback: () => R): R;
+    allowOriginalValueAccess<R>(target: CachedSharedContainer, callback: () => R): R;
 }
 export {};
 //# sourceMappingURL=type-registry.d.ts.map

package/esm/dif/type-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-registry.d.ts","sourceRoot":"","sources":["../../src/dif/type-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,UAAU,EAAmB,MAAM,kBAAkB,CAAC;AAElG,KAAK,UAAU,GAAG;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACnD,CAAC;AAEF,KAAK,OAAO,GAAG;IACX,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,cAAc,EAAE,aAAa,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,uBAAuB,IAAI;IAChE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,0BAA0B,CACtB,KAAK,EAAE,OAAO,GACf,CAAC,CAAC;IACL,wBAAwB,CAAC,CAAC,EACtB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC,CAAC;CACR,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,uBAAuB,IAAI;IAC3D,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAC7B,CAAC,EACD,CAAC,SAAS,uBAAuB,GAAG,uBAAuB,IAC3D;IACA,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CACA,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,cAAc,EAAE,MAAM,GACvB,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,SAAS,CAAC,CACN,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,OAAO,GACf,IAAI,CAAC;IACR,YAAY,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5E,aAAa,CAAC,CACV,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,OAAO,GAClB,IAAI,CAAC;IACR,YAAY,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1E,WAAW,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CAAC,CACb,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,EAAE,GACjB,IAAI,CAAC;CACX,CAAC;AAwBF,qBAAa,YAAY;;gBAIT,UAAU,EAAE,UAAU;IAIlC;;;OAGG;IACI,sBAAsB,CAAC,WAAW,EAAE,cAAc;IAIzD;;;OAGG;IACI,mBAAmB,CAAC,CAAC,EACxB,qBAAqB,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAcnD;;;OAGG;IACH,eAAe,CACX,kBAAkB,EAAE,MAAM,GAC3B,WAAW,GAAG,IAAI;IAIrB;;OAEG;IACI,cAAc,CACjB,kBAAkB,EAAE,MAAM,GAC3B,WAAW,GAAG,IAAI;CAQxB;AAED,qBAAa,WAAW,CACpB,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,SAAS,uBAAuB,GAAG,uBAAuB;;IAK3D,IAAI,UAAU,IAAI,UAAU,CAE3B;IAEM,0BAA0B,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC;gBAM1C,UAAU,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,EACvC,UAAU,EAAE,UAAU;IAM1B;;;OAGG;IACI,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IASpE;;OAEG;IACI,eAAe,CAClB,KAAK,EAAE,CAAC,EACR,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,aAAa,GAC7B,IAAI;IA+EA,qBAAqB,IAAI,GAAG,CAAC,aAAa,CAAC;IAoB3C,wBAAwB,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,MAAM,CAAC,GAClB,CAAC;CAYP"}
+{"version":3,"file":"type-registry.d.ts","sourceRoot":"","sources":["../../src/dif/type-registry.ts"],"names":[],"mappings":"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"}