@unyt/datex 0.0.14 → 0.0.15

package/esm/runtime/runtime.d.ts

@@ -1,15 +1,19 @@
-import { type DecompileOptions, type JSRuntime } from "../datex.js";
+import { type JSRuntime } from "../datex.js";
 import { ComHub } from "../network/com-hub.js";
-import { DIFHandler, type PointerOut } from "../dif/dif-handler.js";
-import type { DIFSharedValueMutability, DIFTypeDefinition } from "../dif/definitions.js";
-import type { Ref } from "../refs/ref.js";
+import { DIFHandler } from "../dif/dif-handler.js";
+import { type AsSharedMaybeOwned, SharedContainerMutability } from "../shared-container/mod.js";
+import type { FlatInstruction, InstructionTree } from "./types";
+import type { DIFTypeDefinition } from "../dif/types/mod.js";
+import { Endpoint } from "../lib/mod.js";
+import type { DisassemblerOptions } from "../datex-web/types/disassembler/options.js";
+import type { DecompileOptions } from "../datex-web/types/decompiler/options.js";
 /** debug flags for the runtime */
 interface DebugConfig {
     log_level?: "error" | "warn" | "info" | "debug" | "trace" | null;
 }
 /** configuration for the runtime  */
 export type RuntimeConfig = {
-    endpoint?: string;
+    endpoint: Endpoint;
     interfaces?: {
         type: string;
         config: unknown;
@@ -33,7 +37,7 @@ export declare class Runtime {
     /**
      * Gets the endpoint of the runtime.
      */
-    get endpoint(): string;
+    get endpoint(): Endpoint;
     /**
      * Gets the version of the runtime.
      */
@@ -86,7 +90,7 @@ export declare class Runtime {
      * console.log(result); // 42
      * ```
      */
-    execute<T = unknown>(templateStrings: TemplateStringsArray, ...values: unknown[]): Promise<T>;
+    execute<T = unknown>(templateStrings: TemplateStringsArray, ...values: unknown[]): Promise<T | undefined>;
     /**
      * Executes a Datex script synchronously and returns the result as a generic type T.
      * Injected values can be passed as an array in `values`.
@@ -108,6 +112,19 @@ export declare class Runtime {
      * ```
      */
     executeSync<T = unknown>(templateStrings: TemplateStringsArray, ...values: unknown[]): T;
+    /**
+     * Compiles a DATEX source code and optional injected values to a DXB body
+     */
+    compile(datexScript: string, values?: unknown[]): Promise<Uint8Array>;
+    /**
+     * Compiles a DATEX source code and optional injected values to a DXB body.
+     * Injected values can be passed to the template string.
+     * Example usage:
+     * ```ts
+     * const dxb = await runtime.compile<number>`1 + ${41}`;
+     * ```
+     */
+    compile(templateStrings: TemplateStringsArray, ...values: unknown[]): Promise<Uint8Array>;
     /**
      * Converts a JavaScript value to a string representation.
      * @param value The value to convert.
@@ -116,7 +133,7 @@ export declare class Runtime {
      */
     valueToString(value: unknown, decompileOptions?: DecompileOptions | null): string;
     /**
-     * Creates a new reference containg the given JS value.
+     * Creates a new reference containing the given JS value.
      * For primitive values, a Ref wrapper is returned.
      * For other values (objects, arrays, maps), the returned value is a proxy object that behaves like the original object.
      *
@@ -125,18 +142,26 @@ export declare class Runtime {
      * @param mutability Optional mutability of the reference (default is Mutable).
      * @returns A proxy object representing the pointer in JS.
      */
-    createTransparentReference<V, M extends DIFSharedValueMutability = typeof DIFSharedValueMutability.Mutable>(value: V & {}, allowedType?: DIFTypeDefinition | null, mutability?: M): PointerOut<V, M>;
+    createSharedValueFromJSValue<V, M extends SharedContainerMutability = SharedContainerMutability.Mutable>(value: V, allowedType?: DIFTypeDefinition | null, mutability?: M): AsSharedMaybeOwned<V, M>;
+    startLSP(callback: (data: string) => void): (data: string) => void;
     /**
-     * Creates or retrieves a wrapped reference for the given value.
-     * If the value is already a reference, it returns the existing reference.
-     *
-     * @param value
-     * @param allowedType
-     * @param mutability
-     * @returns
+     * Returns a disassembled DXB as a list of instructions
+     * @param dxb DATEX binary body
+     * @returns a tuple of the instruction tree and an optional error message if the disassembly (partially) failed
      */
-    createOrGetWrappedReference<V, M extends DIFSharedValueMutability = typeof DIFSharedValueMutability.Mutable>(_value: V, _allowedType?: DIFTypeDefinition | null, _mutability?: M): Ref<V>;
-    startLSP(callback: (data: string) => void): (data: string) => void;
+    disassembleDXBFlat(dxb: Uint8Array): [FlatInstruction[], string | null];
+    /**
+     * Returns a disassembled DXB as a tree structure, where each instruction can have nested child instructions
+     * @param dxb DATEX binary body
+     * @returns a tuple of the instruction tree and an optional error message if the disassembly (partially) failed
+     */
+    disassembleDXBTree(dxb: Uint8Array): [InstructionTree, string | null];
+    /**
+     * Returns a disassembled DXB as a human-readable string, similar to assembly code.
+     * @param dxb
+     * @param options
+     */
+    disassembleDXBToString(dxb: Uint8Array, options?: DisassemblerOptions | null): string;
 }
 export {};
 //# sourceMappingURL=runtime.d.ts.map

package/esm/runtime/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"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"}

package/esm/runtime/runtime.js

@@ -9,14 +9,15 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Runtime_instances, _Runtime_runtime, _Runtime_comHub, _Runtime_difHandler, _Runtime_executeInternal, _Runtime_executeSyncInternal, _Runtime_getScriptAndValues;
-import { create_runtime } from "../datex.js";
+var _Runtime_instances, _Runtime_runtime, _Runtime_comHub, _Runtime_difHandler, _Runtime_executeWithNormalizedArguments, _Runtime_executeSyncWithNormalizedArguments, _Runtime_normalizeArguments;
+import { create_runtime, disassemble_dxb_flat, disassemble_dxb_to_string, disassemble_dxb_tree, } from "../datex.js";
 import { ComHub } from "../network/com-hub.js";
 import { DIFHandler } from "../dif/dif-handler.js";
-import { unimplemented } from "../utils/exceptions.js";
+import { SharedContainerMutability } from "../shared-container/mod.js";
+import { Endpoint } from "../lib/mod.js";
 // TODO: move to global.ts
 /** auto-generated version - do not edit: */
-const VERSION = "0.0.14";
+const VERSION = "0.0.15";
 /**
  * The main Runtime class for executing Datex scripts and managing communication interfaces.
  */
@@ -52,7 +53,7 @@ export class Runtime {
      * Gets the endpoint of the runtime.
      */
     get endpoint() {
-        return __classPrivateFieldGet(this, _Runtime_runtime, "f").endpoint;
+        return Endpoint.get(__classPrivateFieldGet(this, _Runtime_runtime, "f").endpoint);
     }
     /**
      * Gets the version of the runtime.
@@ -99,13 +100,17 @@ export class Runtime {
         return __classPrivateFieldGet(this, _Runtime_runtime, "f").execute_sync_with_string_result(datexScript, __classPrivateFieldGet(this, _Runtime_difHandler, "f").convertToDIFValues(values), decompileOptions);
     }
     execute(datexScriptOrTemplateStrings, ...values) {
-        const { datexScript, valuesArray } = __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_getScriptAndValues).call(this, datexScriptOrTemplateStrings, ...values);
-        return __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_executeInternal).call(this, datexScript, valuesArray);
+        const { datexScript, valuesArray } = __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_normalizeArguments).call(this, datexScriptOrTemplateStrings, ...values);
+        return __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_executeWithNormalizedArguments).call(this, datexScript, valuesArray);
     }
     executeSync(datexScriptOrTemplateStrings, ...values) {
         // determine datexScript and valuesArray based on the type of datexScriptOrTemplateStrings
-        const { datexScript, valuesArray } = __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_getScriptAndValues).call(this, datexScriptOrTemplateStrings, ...values);
-        return __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_executeSyncInternal).call(this, datexScript, valuesArray);
+        const { datexScript, valuesArray } = __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_normalizeArguments).call(this, datexScriptOrTemplateStrings, ...values);
+        return __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_executeSyncWithNormalizedArguments).call(this, datexScript, valuesArray);
+    }
+    compile(datexScriptOrTemplateStrings, ...values) {
+        const { datexScript, valuesArray } = __classPrivateFieldGet(this, _Runtime_instances, "m", _Runtime_normalizeArguments).call(this, datexScriptOrTemplateStrings, ...values);
+        return __classPrivateFieldGet(this, _Runtime_runtime, "f").compile(datexScript, valuesArray);
     }
     /**
      * Converts a JavaScript value to a string representation.
@@ -114,10 +119,10 @@ export class Runtime {
      * @returns The string representation of the value.
      */
     valueToString(value, decompileOptions = null) {
-        return __classPrivateFieldGet(this, _Runtime_runtime, "f").value_to_string(__classPrivateFieldGet(this, _Runtime_difHandler, "f").convertJSValueToDIFValueContainer(value), decompileOptions);
+        return __classPrivateFieldGet(this, _Runtime_runtime, "f").value_to_string(__classPrivateFieldGet(this, _Runtime_difHandler, "f").convertJSValueToDIFValueContainer(value), __classPrivateFieldGet(this, _Runtime_difHandler, "f").convertJSValueToDIFValueContainer(decompileOptions));
     }
     /**
-     * Creates a new reference containg the given JS value.
+     * Creates a new reference containing the given JS value.
      * For primitive values, a Ref wrapper is returned.
      * For other values (objects, arrays, maps), the returned value is a proxy object that behaves like the original object.
      *
@@ -126,22 +131,8 @@ export class Runtime {
      * @param mutability Optional mutability of the reference (default is Mutable).
      * @returns A proxy object representing the pointer in JS.
      */
-    createTransparentReference(
-    // deno-lint-ignore ban-types
-    value, allowedType, mutability) {
-        return __classPrivateFieldGet(this, _Runtime_difHandler, "f").createTransparentReference(value, allowedType, mutability);
-    }
-    /**
-     * Creates or retrieves a wrapped reference for the given value.
-     * If the value is already a reference, it returns the existing reference.
-     *
-     * @param value
-     * @param allowedType
-     * @param mutability
-     * @returns
-     */
-    createOrGetWrappedReference(_value, _allowedType, _mutability) {
-        unimplemented();
+    createSharedValueFromJSValue(value, allowedType = null, mutability = SharedContainerMutability.Mutable) {
+        return __classPrivateFieldGet(this, _Runtime_difHandler, "f").createSharedValueFromJSValue(value, allowedType, mutability);
     }
     startLSP(callback) {
         const decoder = new TextDecoder("utf-8");
@@ -153,16 +144,48 @@ export class Runtime {
             sendToRust(encoder.encode(data));
         };
     }
+    /**
+     * Returns a disassembled DXB as a list of instructions
+     * @param dxb DATEX binary body
+     * @returns a tuple of the instruction tree and an optional error message if the disassembly (partially) failed
+     */
+    disassembleDXBFlat(dxb) {
+        return disassemble_dxb_flat(dxb);
+    }
+    /**
+     * Returns a disassembled DXB as a tree structure, where each instruction can have nested child instructions
+     * @param dxb DATEX binary body
+     * @returns a tuple of the instruction tree and an optional error message if the disassembly (partially) failed
+     */
+    disassembleDXBTree(dxb) {
+        return disassemble_dxb_tree(dxb);
+    }
+    /**
+     * Returns a disassembled DXB as a human-readable string, similar to assembly code.
+     * @param dxb
+     * @param options
+     */
+    disassembleDXBToString(dxb, options) {
+        return disassemble_dxb_to_string(dxb, options);
+    }
 }
-_Runtime_runtime = new WeakMap(), _Runtime_comHub = new WeakMap(), _Runtime_difHandler = new WeakMap(), _Runtime_instances = new WeakSet(), _Runtime_executeInternal = async function _Runtime_executeInternal(datexScript, values = []) {
+_Runtime_runtime = new WeakMap(), _Runtime_comHub = new WeakMap(), _Runtime_difHandler = new WeakMap(), _Runtime_instances = new WeakSet(), _Runtime_executeWithNormalizedArguments = 
+/**
+ * Execute a DATEX script with injected values and return the result as a Promise of type T.
+ * The result is converted to a JS value. If the script returns no value, it will return `undefined`.
+ * @param datexScript The DATEX script to execute.
+ * @param values The values to inject into the script, passed as an array.
+ * @returns A Promise that resolves to the result of the script execution, converted to type T.
+ */
+async function _Runtime_executeWithNormalizedArguments(datexScript, values = []) {
     const difValueContainer = await __classPrivateFieldGet(this, _Runtime_difHandler, "f").executeDIF(datexScript, values);
-    if (difValueContainer === null) {
+    if (difValueContainer === undefined) {
         return undefined;
     }
     return __classPrivateFieldGet(this, _Runtime_difHandler, "f").resolveDIFValueContainer(difValueContainer);
-}, _Runtime_executeSyncInternal = function _Runtime_executeSyncInternal(datexScript, values = []) {
+}, _Runtime_executeSyncWithNormalizedArguments = function _Runtime_executeSyncWithNormalizedArguments(datexScript, values = []) {
     const difValue = __classPrivateFieldGet(this, _Runtime_difHandler, "f").executeSyncDIF(datexScript, values);
-    if (difValue === null) {
+    if (difValue === undefined) {
         return undefined;
     }
     const result = __classPrivateFieldGet(this, _Runtime_difHandler, "f").resolveDIFValueContainer(difValue);
@@ -170,7 +193,7 @@ _Runtime_runtime = new WeakMap(), _Runtime_comHub = new WeakMap(), _Runtime_difH
         throw new Error("executeSync cannot return a Promise. Use execute() instead.");
     }
     return result;
-}, _Runtime_getScriptAndValues = function _Runtime_getScriptAndValues(datexScriptOrTemplateStrings, ...values) {
+}, _Runtime_normalizeArguments = function _Runtime_normalizeArguments(datexScriptOrTemplateStrings, ...values) {
     let datexScript;
     let valuesArray;
     if (typeof datexScriptOrTemplateStrings === "string") {

package/esm/{refs/ref.d.ts → shared-container/base-shared-container.d.ts}

@@ -1,15 +1,21 @@
 import type { DIFHandler } from "../dif/dif-handler.js";
+import { DIFSharedContainerOwnership } from "../dif/types/mod.js";
+import { type PointerAddress, type SharedContainer } from "./mod.js";
+export declare enum SharedContainerMutability {
+    Immutable = 0,
+    Mutable = 1
+}
 /**
  * The Ref class is a wrapper around a value that is stored in a pointer.
  * Primitive values (string, number, boolean, null) are always wrapped in a Ref when stored in a pointer.
  */
-export declare class Ref<T> {
+export declare class BaseSharedContainer<T, Mutability extends SharedContainerMutability> {
     #private;
-    constructor(value: T, pointerAddress: string, difHandler: DIFHandler);
+    constructor(value: T, pointerAddress: PointerAddress, mutability: Mutability, difHandler: DIFHandler);
     /**
      * Gets the address of the pointer storing the reference.
      */
-    get pointerAddress(): string;
+    get pointerAddress(): PointerAddress;
     /**
      * Silently updates the value of the reference without notifying observers.
      * This should only be used internally.
@@ -25,6 +31,8 @@ export declare class Ref<T> {
      * Also notifies all observers of the pointer about the change.
      * @throws If the reference is immutable or the new value is of an incompatible type.
      */
-    set value(newValue: T);
+    set value(newValue: Mutability extends SharedContainerMutability.Mutable ? T : never);
+    isContainerMutable(): this is BaseSharedContainer<T, typeof SharedContainerMutability.Mutable>;
+    withOwnership<Ownership extends DIFSharedContainerOwnership>(ownership: Ownership): SharedContainer<T, Mutability>;
 }
-//# sourceMappingURL=ref.d.ts.map
+//# sourceMappingURL=base-shared-container.d.ts.map

package/esm/shared-container/base-shared-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-shared-container.d.ts","sourceRoot":"","sources":["../../src/shared-container/base-shared-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3F,oBAAY,yBAAyB;IACjC,SAAS,IAAI;IACb,OAAO,IAAI;CACd;AAED;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC,EAAE,UAAU,SAAS,yBAAyB;;gBAMhE,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;IAOpG;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC;IAI/B;;OAEG;IACH,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,QAAQ,EAAE,UAAU,SAAS,yBAAyB,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,EAWnF;IAEM,kBAAkB,IAAI,IAAI,IAAI,mBAAmB,CAAC,CAAC,EAAE,OAAO,yBAAyB,CAAC,OAAO,CAAC;IAI9F,aAAa,CAAC,SAAS,SAAS,2BAA2B,EAC9D,SAAS,EAAE,SAAS,GACrB,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC;CAepC"}

package/esm/shared-container/base-shared-container.js

@@ -0,0 +1,95 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _BaseSharedContainer_value, _BaseSharedContainer_pointerAddress, _BaseSharedContainer_difHandler, _BaseSharedContainer_containerMutability;
+import { DIFSharedContainerOwnership } from "../dif/types/mod.js";
+import { OwnedSharedContainer } from "./mod.js";
+import { ReferencedSharedContainer } from "./reference.js";
+export var SharedContainerMutability;
+(function (SharedContainerMutability) {
+    SharedContainerMutability[SharedContainerMutability["Immutable"] = 0] = "Immutable";
+    SharedContainerMutability[SharedContainerMutability["Mutable"] = 1] = "Mutable";
+})(SharedContainerMutability || (SharedContainerMutability = {}));
+/**
+ * The Ref class is a wrapper around a value that is stored in a pointer.
+ * Primitive values (string, number, boolean, null) are always wrapped in a Ref when stored in a pointer.
+ */
+export class BaseSharedContainer {
+    constructor(value, pointerAddress, mutability, difHandler) {
+        _BaseSharedContainer_value.set(this, void 0);
+        _BaseSharedContainer_pointerAddress.set(this, void 0);
+        _BaseSharedContainer_difHandler.set(this, void 0);
+        _BaseSharedContainer_containerMutability.set(this, void 0);
+        __classPrivateFieldSet(this, _BaseSharedContainer_value, value, "f");
+        __classPrivateFieldSet(this, _BaseSharedContainer_pointerAddress, pointerAddress, "f");
+        __classPrivateFieldSet(this, _BaseSharedContainer_containerMutability, mutability, "f");
+        __classPrivateFieldSet(this, _BaseSharedContainer_difHandler, difHandler, "f");
+    }
+    /**
+     * Gets the address of the pointer storing the reference.
+     */
+    get pointerAddress() {
+        return __classPrivateFieldGet(this, _BaseSharedContainer_pointerAddress, "f");
+    }
+    /**
+     * Silently updates the value of the reference without notifying observers.
+     * This should only be used internally.
+     * @param newValue - The new value to set.
+     */
+    updateValueSilently(newValue) {
+        __classPrivateFieldSet(this, _BaseSharedContainer_value, newValue, "f");
+    }
+    /**
+     * Gets the current value of the reference.
+     */
+    get value() {
+        return __classPrivateFieldGet(this, _BaseSharedContainer_value, "f");
+    }
+    /**
+     * Replaces the current value of the reference with a new value.
+     * Also notifies all observers of the pointer about the change.
+     * @throws If the reference is immutable or the new value is of an incompatible type.
+     */
+    set value(newValue) {
+        if (!this.isContainerMutable()) {
+            throw new Error("Cannot set value of an immutable reference.");
+        }
+        const oldValue = __classPrivateFieldGet(this, _BaseSharedContainer_value, "f");
+        if (oldValue === newValue)
+            return;
+        // Try to update the pointer
+        __classPrivateFieldGet(this, _BaseSharedContainer_difHandler, "f").triggerReplace(__classPrivateFieldGet(this, _BaseSharedContainer_pointerAddress, "f"), newValue);
+        __classPrivateFieldSet(this, _BaseSharedContainer_value, newValue, "f");
+    }
+    isContainerMutable() {
+        return __classPrivateFieldGet(this, _BaseSharedContainer_containerMutability, "f") === SharedContainerMutability.Mutable;
+    }
+    withOwnership(ownership) {
+        if (ownership === DIFSharedContainerOwnership.Immutable) {
+            return new ReferencedSharedContainer(this, ownership);
+        }
+        else if (ownership === DIFSharedContainerOwnership.Mutable) {
+            if (this.isContainerMutable()) {
+                return new ReferencedSharedContainer(this, ownership);
+            }
+            else {
+                throw new Error("Cannot create a mutable reference to an immutable shared container.");
+            }
+        }
+        else if (ownership === DIFSharedContainerOwnership.Owned) {
+            return new OwnedSharedContainer(this);
+        }
+        else {
+            throw new Error(`Invalid ownership type: ${ownership}`);
+        }
+    }
+}
+_BaseSharedContainer_value = new WeakMap(), _BaseSharedContainer_pointerAddress = new WeakMap(), _BaseSharedContainer_difHandler = new WeakMap(), _BaseSharedContainer_containerMutability = new WeakMap();

package/esm/shared-container/mod.d.ts

@@ -0,0 +1,36 @@
+import { DIFSharedContainerOwnership } from "../dif/types/mod.js";
+import type { SharedContainerMutability } from "./base-shared-container.js";
+import type { OwnedSharedContainer } from "./owned.js";
+import type { ReferencedSharedContainer, SharedReferenceMutability } from "./reference.js";
+export * from "./base-shared-container.js";
+export * from "./reference.js";
+export * from "./owned.js";
+declare const PointerAddressBrand: unique symbol;
+declare const PointerAddressWithOwnershipBrand: unique symbol;
+export type PointerAddressWithOwnership = string & {
+    [PointerAddressWithOwnershipBrand]: never;
+};
+export type PointerAddress = string & {
+    [PointerAddressBrand]: never;
+};
+export declare function splitPointerAddressWithOwnership(address: PointerAddressWithOwnership): [DIFSharedContainerOwnership, PointerAddress];
+export declare function combinePointerAddressWithOwnership(address: PointerAddress, ownership: DIFSharedContainerOwnership): PointerAddressWithOwnership;
+/**
+ * Represents a shared container, which can be either an owned container or a referenced container.
+ */
+export type SharedContainer<T, Mutability extends SharedContainerMutability = SharedContainerMutability> = OwnedSharedContainer<T, Mutability> | ReferencedSharedContainer<T, Mutability, typeof SharedReferenceMutability.Immutable> | ReferencedSharedContainer<T, Mutability, typeof SharedReferenceMutability.Mutable>;
+declare const SharedReferencedTag: unique symbol;
+/**
+ * The SharedReferenced type represents a referenced shared value, which is a reference to a shared value that can be either mutable or immutable.
+ * The underlying value can be mutable or not.
+ */
+export type SharedRef<T extends object, Mutability extends SharedContainerMutability = SharedContainerMutability, ReferenceMutability extends SharedReferenceMutability = SharedReferenceMutability> = Mutability extends SharedContainerMutability.Immutable ? ReferenceMutability extends SharedReferenceMutability.Mutable ? never : SharedReferenceInner<T, Mutability, ReferenceMutability> : SharedReferenceInner<T, Mutability, ReferenceMutability>;
+type SharedReferenceInner<T extends object, Mutability extends SharedContainerMutability, ReferenceMutability extends SharedReferenceMutability> = T & {
+    [SharedReferencedTag]: {
+        mutability: Mutability;
+        referenceMutability: ReferenceMutability;
+    };
+};
+export type AsShared<T, Mutability extends SharedContainerMutability> = T extends object ? SharedRef<T, Mutability> | SharedContainer<T, Mutability> : SharedContainer<T, Mutability>;
+export type AsSharedMaybeOwned<T, Mutability extends SharedContainerMutability> = T extends object ? SharedRef<T, Mutability> | OwnedSharedContainer<T, Mutability> : OwnedSharedContainer<T, Mutability>;
+//# sourceMappingURL=mod.d.ts.map

package/esm/shared-container/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/shared-container/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAE3B,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AACjD,OAAO,CAAC,MAAM,gCAAgC,EAAE,OAAO,MAAM,CAAC;AAE9D,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG;IAAE,CAAC,gCAAgC,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACjG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvE,wBAAgB,gCAAgC,CAC5C,OAAO,EAAE,2BAA2B,GACrC,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAW/C;AACD,wBAAgB,kCAAkC,CAC9C,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,2BAA2B,GACvC,2BAA2B,CAQ7B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,UAAU,SAAS,yBAAyB,GAAG,yBAAyB,IACjG,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,GACnC,yBAAyB,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,yBAAyB,CAAC,SAAS,CAAC,GACpF,yBAAyB,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAEzF,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,SAAS,CACjB,CAAC,SAAS,MAAM,EAChB,UAAU,SAAS,yBAAyB,GAAG,yBAAyB,EACxE,mBAAmB,SAAS,yBAAyB,GAAG,yBAAyB,IACjF,UAAU,SAAS,yBAAyB,CAAC,SAAS,GACpD,mBAAmB,SAAS,yBAAyB,CAAC,OAAO,GAAG,KAAK,GACrE,oBAAoB,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAmB,CAAC,GACxD,oBAAoB,CAAC,CAAC,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAE/D,KAAK,oBAAoB,CACrB,CAAC,SAAS,MAAM,EAChB,UAAU,SAAS,yBAAyB,EAC5C,mBAAmB,SAAS,yBAAyB,IACrD,CAAC,GAAG;IACJ,CAAC,mBAAmB,CAAC,EAAE;QACnB,UAAU,EAAE,UAAU,CAAC;QACvB,mBAAmB,EAAE,mBAAmB,CAAC;KAC5C,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,UAAU,SAAS,yBAAyB,IAAI,CAAC,SAAS,MAAM,GAClF,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,GACzD,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAErC,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,UAAU,SAAS,yBAAyB,IAAI,CAAC,SAAS,MAAM,GAC5F,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,GAC9D,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC"}

package/esm/shared-container/mod.js

@@ -0,0 +1,29 @@
+import { DIFSharedContainerOwnership } from "../dif/types/mod.js";
+export * from "./base-shared-container.js";
+export * from "./reference.js";
+export * from "./owned.js";
+export function splitPointerAddressWithOwnership(address) {
+    const [ownershipStr, addressStr] = address.split("$");
+    if (ownershipStr === "") {
+        return [DIFSharedContainerOwnership.Owned, addressStr];
+    }
+    else if (ownershipStr === "'") {
+        return [DIFSharedContainerOwnership.Immutable, addressStr];
+    }
+    else if (ownershipStr === "'mut") {
+        return [DIFSharedContainerOwnership.Mutable, addressStr];
+    }
+    else {
+        throw new Error(`Invalid pointer address with ownership: ${address}`);
+    }
+}
+export function combinePointerAddressWithOwnership(address, ownership) {
+    let ownershipStr = "";
+    if (ownership === DIFSharedContainerOwnership.Immutable) {
+        ownershipStr = "'";
+    }
+    else if (ownership === DIFSharedContainerOwnership.Mutable) {
+        ownershipStr = "'mut";
+    }
+    return `${ownershipStr}$${address}`;
+}

package/esm/shared-container/owned.d.ts

@@ -0,0 +1,33 @@
+import { ReferencedSharedContainer, SharedReferenceMutability } from "./reference.js";
+import type { BaseSharedContainer, SharedContainerMutability } from "./base-shared-container.js";
+import type { PointerAddress } from "./mod.js";
+export declare class OwnedSharedContainer<T, Mutability extends SharedContainerMutability> {
+    #private;
+    constructor(baseSharedContainer: BaseSharedContainer<T, Mutability>);
+    /**
+     * Gets the address of the pointer storing the reference.
+     */
+    get pointerAddress(): PointerAddress;
+    /**
+     * Gets the current value of the reference.
+     */
+    get value(): T;
+    /**
+     * Replaces the current value of the reference with a new value.
+     * Also notifies all observers of the pointer about the change.
+     * @throws If the reference is immutable or the new value is of an incompatible type.
+     */
+    set value(newValue: Mutability extends SharedContainerMutability.Mutable ? T : never);
+    /**
+     * Derives a new mutable reference from the current reference if the current reference is mutable.
+     * Otherwise returns an error
+     * @returns A new mutable reference derived from the current reference if the current reference is mutable, otherwise throws an error.
+     */
+    deriveMutableReference(): Mutability extends SharedContainerMutability.Mutable ? ReferencedSharedContainer<T, Mutability, SharedReferenceMutability.Mutable> : never;
+    /**
+     * Derives a new immutable reference from the current reference. The derived reference will have the same underlying shared container,
+     * @returns A new ReferencedSharedContainer instance with immutable reference mutability.
+     */
+    deriveImmutableReference(): ReferencedSharedContainer<T, Mutability, SharedReferenceMutability.Immutable>;
+}
+//# sourceMappingURL=owned.d.ts.map

package/esm/shared-container/owned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned.d.ts","sourceRoot":"","sources":["../../src/shared-container/owned.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,oBAAoB,CAAC,CAAC,EAAE,UAAU,SAAS,yBAAyB;;gBAG1D,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,UAAU,CAAC;IAI1E;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,QAAQ,EAAE,UAAU,SAAS,yBAAyB,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,EAEnF;IAED;;;;OAIG;IACI,sBAAsB,IAAI,UAAU,SAAS,yBAAyB,CAAC,OAAO,GAAG,yBAAyB,CACzG,CAAC,EACD,UAAU,EACV,yBAAyB,CAAC,OAAO,CACpC,GACC,KAAK;IAgBX;;;OAGG;IACI,wBAAwB,IAAI,yBAAyB,CACxD,CAAC,EACD,UAAU,EACV,yBAAyB,CAAC,SAAS,CACtC;CAOJ"}

package/esm/shared-container/owned.js

@@ -0,0 +1,60 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _OwnedSharedContainer_baseSharedContainer;
+import { ReferencedSharedContainer, SharedReferenceMutability } from "./reference.js";
+export class OwnedSharedContainer {
+    constructor(baseSharedContainer) {
+        _OwnedSharedContainer_baseSharedContainer.set(this, void 0);
+        __classPrivateFieldSet(this, _OwnedSharedContainer_baseSharedContainer, baseSharedContainer, "f");
+    }
+    /**
+     * Gets the address of the pointer storing the reference.
+     */
+    get pointerAddress() {
+        return __classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f").pointerAddress;
+    }
+    /**
+     * Gets the current value of the reference.
+     */
+    get value() {
+        return __classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f").value;
+    }
+    /**
+     * Replaces the current value of the reference with a new value.
+     * Also notifies all observers of the pointer about the change.
+     * @throws If the reference is immutable or the new value is of an incompatible type.
+     */
+    set value(newValue) {
+        __classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f").value = newValue;
+    }
+    /**
+     * Derives a new mutable reference from the current reference if the current reference is mutable.
+     * Otherwise returns an error
+     * @returns A new mutable reference derived from the current reference if the current reference is mutable, otherwise throws an error.
+     */
+    deriveMutableReference() {
+        if (__classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f").isContainerMutable()) {
+            return new ReferencedSharedContainer(__classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f"), SharedReferenceMutability.Mutable);
+        }
+        else {
+            throw new Error("Cannot derive a mutable reference from an immutable reference.");
+        }
+    }
+    /**
+     * Derives a new immutable reference from the current reference. The derived reference will have the same underlying shared container,
+     * @returns A new ReferencedSharedContainer instance with immutable reference mutability.
+     */
+    deriveImmutableReference() {
+        return new ReferencedSharedContainer(__classPrivateFieldGet(this, _OwnedSharedContainer_baseSharedContainer, "f"), SharedReferenceMutability.Immutable);
+    }
+}
+_OwnedSharedContainer_baseSharedContainer = new WeakMap();

package/esm/shared-container/reference.d.ts

@@ -0,0 +1,31 @@
+import type { BaseSharedContainer, SharedContainerMutability } from "./base-shared-container.js";
+import type { PointerAddress } from "./mod.js";
+export declare enum SharedReferenceMutability {
+    Immutable = 0,
+    Mutable = 1
+}
+export declare class ReferencedSharedContainer<T, Mutability extends SharedContainerMutability, ReferenceMutability extends SharedReferenceMutability> {
+    #private;
+    constructor(baseSharedContainer: BaseSharedContainer<T, Mutability>, referenceMutability: ReferenceMutability);
+    /**
+     * Gets the address of the pointer storing the reference.
+     */
+    get pointerAddress(): PointerAddress;
+    /**
+     * Gets the current value of the reference.
+     */
+    get value(): T;
+    /**
+     * Replaces the current value of the reference with a new value.
+     * Also notifies all observers of the pointer about the change.
+     * @throws If the reference is immutable or the new value is of an incompatible type.
+     */
+    set value(newValue: Mutability extends SharedContainerMutability.Mutable ? T : never);
+    isMutable(): boolean;
+    /**
+     * Derives an immutable reference from the current reference. The derived reference will have the same underlying shared container,
+     * @returns A new ReferencedSharedContainer instance with immutable reference mutability.
+     */
+    deriveImmutableReference(): ReferencedSharedContainer<T, Mutability, SharedReferenceMutability.Immutable>;
+}
+//# sourceMappingURL=reference.d.ts.map

package/esm/shared-container/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/shared-container/reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,oBAAY,yBAAyB;IACjC,SAAS,IAAI;IACb,OAAO,IAAI;CACd;AACD,qBAAa,yBAAyB,CAClC,CAAC,EACD,UAAU,SAAS,yBAAyB,EAC5C,mBAAmB,SAAS,yBAAyB;;gBAMjD,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,UAAU,CAAC,EACvD,mBAAmB,EAAE,mBAAmB;IAM5C;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,QAAQ,EAAE,UAAU,SAAS,yBAAyB,CAAC,OAAO,GAAG,CAAC,GAAG,KAAK,EAEnF;IAEM,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACI,wBAAwB,IAAI,yBAAyB,CACxD,CAAC,EACD,UAAU,EACV,yBAAyB,CAAC,SAAS,CACtC;CAMJ"}