@opendaw/lib-box 0.0.19 → 0.0.20

package/README.md

@@ -4,6 +4,12 @@ _This package is part of the openDAW SDK_
 
 Graph-based object modeling system with serialization, transactions, and pointer management for TypeScript projects.
 
+## Wishlist
+
+* Introduce readonly fields (cannot only be written in the constructing phase)
+* Introduce meta-fields (compile time only)
+* Add array with all TypeMap keys
+
 ## Core Architecture
 
 * **box.ts** - Core Box class for graph nodes with field management

package/dist/address.d.ts

@@ -1,10 +1,10 @@
 import { Comparable, Comparator, DataInput, DataOutput, Func, int, Nullable, SortedSet, UUID } from "@opendaw/lib-std";
 import { FieldKey, FieldKeys } from "./field";
-export type AddressLayout = [UUID.Format, FieldKeys];
 export type AddressJSON = {
     uuid: Array<int>;
     fields: Array<int>;
 };
+export type AddressLayout = [UUID.Format, FieldKeys];
 export declare class Address implements Comparable<Address> {
     #private;
     static newSet<T>(keyExtractor: Func<T, Address>): SortedSet<Address, T>;
@@ -25,6 +25,7 @@ export declare class Address implements Comparable<Address> {
     append(key: FieldKey): Address;
     startsWith(other: Address): boolean;
     write(output: DataOutput): void;
+    moveTo(target: UUID.Format): Address;
     decompose(): AddressLayout;
     toJSON(): {
         uuid: number[];
@@ -44,4 +45,9 @@ export declare namespace Addressable {
     const startsWith: <A extends Addressable>(address: Address, sorted: ReadonlyArray<A>) => Array<A>;
     const endsWith: <A extends Addressable>(address: Address, sorted: ReadonlyArray<A>) => Array<A>;
 }
+export declare class AddressIdEncoder {
+    #private;
+    constructor();
+    getOrCreate(address: Address): string;
+}
 //# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

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

package/dist/address.js

@@ -94,6 +94,7 @@ export class Address {
         output.writeByte(this.#fieldKeys.length);
         this.#fieldKeys.forEach(key => output.writeShort(key));
     }
+    moveTo(target) { return new Address(target, this.#fieldKeys); }
     decompose() { return [this.#uuid, this.#fieldKeys]; }
     toJSON() { return { uuid: Array.from(this.#uuid.values()), fields: Array.from(this.#fieldKeys.values()) }; }
     toArrayBuffer() {
@@ -131,3 +132,14 @@ export var Addressable;
             .filter((addressable) => address.startsWith(addressable.address));
     };
 })(Addressable || (Addressable = {}));
+export class AddressIdEncoder {
+    #ids;
+    #idCount;
+    constructor() {
+        this.#ids = Address.newSet(({ address }) => address);
+        this.#idCount = 0;
+    }
+    getOrCreate(address) {
+        return `id${this.#ids.getOrCreate(address, () => ({ address, id: `${++this.#idCount}` })).id}`;
+    }
+}

package/dist/editing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../src/editing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAA;AAChC,OAAO,EAAsB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAiB/E,MAAM,WAAW,mBAAmB;IAChC,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;CACjB;AAED,qBAAa,OAAO;;gBASJ,KAAK,EAAE,QAAQ;IAI3B,IAAI,KAAK,IAAI,QAAQ,CAAqB;IAE1C,OAAO,IAAI,OAAO;IAElB,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,OAAO;IAWf,IAAI,IAAI,OAAO;IAef,SAAS,IAAI,OAAO;IAEpB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM,CAAC,CAAC,CAAC;IAW1E,iBAAiB,IAAI,mBAAmB;IAoCxC,IAAI,IAAI,IAAI;IAOZ,YAAY,IAAI,IAAI;CAKvB"}
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../src/editing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAA;AAChC,OAAO,EAAsB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,kBAAkB,CAAA;AAqB/E,MAAM,WAAW,mBAAmB;IAChC,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;CACjB;AAED,qBAAa,OAAO;;gBASJ,KAAK,EAAE,QAAQ;IAI3B,IAAI,KAAK,IAAI,QAAQ,CAAqB;IAE1C,OAAO,IAAI,OAAO;IAElB,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,OAAO;IASf,IAAI,IAAI,OAAO;IAaf,SAAS,IAAI,OAAO;IAEpB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM,CAAC,CAAC,CAAC;IAW1E,iBAAiB,IAAI,mBAAmB;IAkCxC,IAAI,IAAI,IAAI;IAOZ,YAAY,IAAI,IAAI;CAKvB"}

package/dist/editing.js

@@ -1,35 +1,33 @@
 import { Arrays, assert, Option } from "@opendaw/lib-std";
-class EditingStep {
-    updates;
-    constructor(updates) {
-        this.updates = updates;
+class Modification {
+    #updates;
+    constructor(updates) { this.#updates = updates; }
+    inverse(graph) {
+        graph.beginTransaction();
+        this.#updates.toReversed().forEach(update => update.inverse(graph));
+        graph.endTransaction();
     }
-    undo(graph) {
-        for (const update of this.updates.toReversed()) {
-            update.inverse(graph);
-        }
-    }
-    redo(graph) {
-        for (const update of this.updates) {
-            update.forward(graph);
-        }
+    forward(graph) {
+        graph.beginTransaction();
+        this.#updates.forEach(update => update.forward(graph));
+        graph.endTransaction();
     }
 }
 export class Editing {
     #graph;
     #pending = [];
-    #history = [];
+    #marked = [];
     #modifying = false;
     #historyIndex = 0;
     constructor(graph) {
         this.#graph = graph;
     }
     get graph() { return this.#graph; }
-    isEmpty() { return this.#history.length === 0 && this.#pending.length === 0; }
+    isEmpty() { return this.#marked.length === 0 && this.#pending.length === 0; }
     clear() {
         assert(!this.#modifying, "Already modifying");
         Arrays.clear(this.#pending);
-        Arrays.clear(this.#history);
+        Arrays.clear(this.#marked);
         this.#historyIndex = 0;
     }
     undo() {
@@ -39,24 +37,20 @@ export class Editing {
         if (this.#historyIndex === 0) {
             return false;
         }
-        this.#graph.beginTransaction();
-        const editingStep = this.#history[--this.#historyIndex];
-        editingStep.undo(this.#graph);
-        this.#graph.endTransaction();
+        const modifications = this.#marked[--this.#historyIndex];
+        modifications.toReversed().forEach(step => step.inverse(this.#graph));
         this.#graph.edges().validateRequirements();
         return true;
     }
     redo() {
-        if (this.#historyIndex === this.#history.length) {
+        if (this.#historyIndex === this.#marked.length) {
             return false;
         }
         if (this.#pending.length > 0) {
             console.warn("redo while having pending updates?");
             return false;
         }
-        this.#graph.beginTransaction();
-        this.#history[this.#historyIndex++].redo(this.#graph);
-        this.#graph.endTransaction();
+        this.#marked[this.#historyIndex++].forEach(step => step.forward(this.#graph));
         this.#graph.edges().validateRequirements();
         return true;
     }
@@ -65,7 +59,7 @@ export class Editing {
     canModify() { return !this.#graph.inTransaction(); }
     modify(modifier, mark = true) {
         if (this.#modifying) {
-            // we just keep adding new updates to the running modifier
+            // we just keep adding new pending updates
             return Option.wrap(modifier());
         }
         if (mark && this.#pending.length > 0) {
@@ -80,17 +74,13 @@ export class Editing {
     beginModification() {
         this.#graph.beginTransaction();
         this.#modifying = true;
-        const subscription = this.#graph.subscribeToAllUpdates({
-            onUpdate: (update) => this.#pending.push(update)
-        });
         const complete = () => {
-            this.#graph.endTransaction();
-            subscription.terminate();
             this.#modifying = false;
+            this.#graph.endTransaction();
             this.#graph.edges().validateRequirements();
         };
         return {
-            approve: () => { complete(); },
+            approve: complete,
             revert: () => {
                 this.clearPending();
                 complete();
@@ -100,12 +90,14 @@ export class Editing {
     #modify(modifier) {
         assert(!this.#modifying, "Already modifying");
         this.#modifying = true;
-        const subscription = this.#graph.subscribeToAllUpdates({
-            onUpdate: (update) => this.#pending.push(update)
-        });
+        const updates = [];
+        const subscription = this.#graph.subscribeToAllUpdates({ onUpdate: (update) => { updates.push(update); } });
         this.#graph.beginTransaction();
         const result = modifier();
         this.#graph.endTransaction();
+        if (updates.length > 0) {
+            this.#pending.push(new Modification(updates));
+        }
         subscription.terminate();
         this.#modifying = false;
         this.#graph.edges().validateRequirements();
@@ -115,17 +107,17 @@ export class Editing {
         if (this.#pending.length === 0) {
             return;
         }
-        if (this.#history.length - this.#historyIndex > 0) {
-            this.#history.splice(this.#historyIndex);
+        if (this.#marked.length - this.#historyIndex > 0) {
+            this.#marked.splice(this.#historyIndex);
         }
-        this.#history.push(new EditingStep(this.#pending.splice(0)));
-        this.#historyIndex = this.#history.length;
+        this.#marked.push(this.#pending.splice(0));
+        this.#historyIndex = this.#marked.length;
     }
     clearPending() {
         if (this.#pending.length === 0) {
             return;
         }
-        this.#pending.reverse().forEach(update => update.inverse(this.#graph));
+        this.#pending.reverse().forEach(modification => modification.inverse(this.#graph));
         this.#pending.length = 0;
     }
 }

package/dist/graph-edges.d.ts

@@ -12,6 +12,5 @@ export declare class GraphEdges {
     outgoingEdgesOf(box: Box): ReadonlyArray<[PointerField, Address]>;
     incomingEdgesOf(vertex: Box | Vertex): ReadonlyArray<PointerField>;
     validateRequirements(): void;
-    verifyPointers(): void;
 }
 //# sourceMappingURL=graph-edges.d.ts.map

package/dist/graph-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-edges.d.ts","sourceRoot":"","sources":["../src/graph-edges.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAA;AAEzB,qBAAa,UAAU;;;IAanB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAchD,iBAAiB,CAAC,GAAG,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAoBrD,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAQpD,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOtC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAIjE,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;IASlE,oBAAoB,IAAI,IAAI;IAqB5B,cAAc,IAAI,IAAI;CAgBzB"}
+{"version":3,"file":"graph-edges.d.ts","sourceRoot":"","sources":["../src/graph-edges.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAA;AAEzB,qBAAa,UAAU;;;IAanB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAchD,iBAAiB,CAAC,GAAG,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI;IAoBrD,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAQpD,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOtC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAIjE,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC;IASlE,oBAAoB,IAAI,IAAI;CAgC/B"}

package/dist/graph-edges.js

@@ -72,6 +72,7 @@ export class GraphEdges {
     }
     validateRequirements() {
         this.#requiresTarget.forEach(pointer => {
+            assert(pointer.isAttached(), `Pointer ${pointer.address.toString()} is not attached`);
             if (pointer.isEmpty()) {
                 if (pointer.mandatory) {
                     return panic(`Pointer ${pointer.toString()} requires an edge.`);
@@ -82,6 +83,7 @@ export class GraphEdges {
             }
         });
         this.#requiresPointer.forEach(target => {
+            assert(target.isAttached(), `Target ${target.address.toString()} is not attached`);
             if (target.pointerHub.isEmpty()) {
                 if (target.pointerRules.mandatory) {
                     return panic(`Target ${target.toString()} requires an edge.`);
@@ -92,10 +94,6 @@ export class GraphEdges {
             }
         });
     }
-    verifyPointers() {
-        this.#requiresTarget.forEach(pointer => assert(pointer.isAttached(), `${pointer.address.toString()} is not attached`));
-        this.#requiresPointer.forEach(vertex => assert(vertex.isAttached(), `${vertex.address.toString()} is not attached`));
-    }
     #collectSameBox(set, id, map) {
         const range = Address.boxRange(set, id, map);
         return isDefined(range) ? set.values().slice(range[0], range[1]) : Arrays.empty();

package/dist/graph.d.ts

@@ -26,7 +26,7 @@ export declare class BoxGraph<BoxMap = any> {
     endTransaction(): void;
     inTransaction(): boolean;
     constructingBox(): boolean;
-    createBox(name: keyof BoxMap, uuid: UUID.Format, constructor: Procedure<Box>): void;
+    createBox(name: keyof BoxMap, uuid: UUID.Format, constructor: Procedure<Box>): Box;
     stageBox<B extends Box>(box: B, constructor?: Procedure<B>): B;
     subscribeTransaction(listener: TransactionListener): Subscription;
     subscribeToAllUpdates(listener: UpdateListener): Subscription;

package/dist/graph.d.ts.map

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

package/dist/graph.js

@@ -49,7 +49,7 @@ export class BoxGraph {
     inTransaction() { return this.#inTransaction; }
     constructingBox() { return this.#constructingBox; }
     createBox(name, uuid, constructor) {
-        this.#boxFactory.unwrap("No box-factory installed")(name, this, uuid, constructor);
+        return this.#boxFactory.unwrap("No box-factory installed")(name, this, uuid, constructor);
     }
     stageBox(box, constructor) {
         this.#assertTransaction();
@@ -171,10 +171,7 @@ export class BoxGraph {
         return { boxes: boxes, pointers: Array.from(pointers).reverse() };
     }
     verifyPointers() {
-        console.debug("validate requirements");
         this.#edges.validateRequirements();
-        this.#edges.verifyPointers();
-        console.debug("verify pointers");
         let count = 0 | 0;
         const verify = (vertex) => {
             for (const field of vertex.fields()) {

package/dist/pointer-hub.js

@@ -6,8 +6,8 @@ export class PointerHub {
             return Option.wrap(`PointerField cannot point to itself: ${pointer}`);
         }
         if (!target.pointerRules.accepts.some((type) => type === pointer.pointerType)) {
-            console.warn(target.pointerRules);
-            return Option.wrap(`${pointer.toString()} does not satisfy any of the allowed types (${(target.pointerRules)}).`);
+            const accepting = target.pointerRules.accepts.join(", ");
+            return Option.wrap(`${String(pointer.pointerType)} does not satisfy any of the allowed types (${accepting}).`);
         }
         return Option.None;
     }
@@ -59,8 +59,8 @@ export class PointerHub {
             return panic(issue.unwrap());
         }
         if (this.#inTransaction.isEmpty()) {
-            this.#vertex.graph.subscribeEndTransaction(this.#onEndTransaction);
             this.#inTransaction = Option.wrap([{ type: "add", pointerField }]);
+            this.#vertex.graph.subscribeEndTransaction(this.#onEndTransaction);
         }
         else {
             this.#inTransaction.unwrap().push({ type: "add", pointerField });
@@ -69,8 +69,8 @@ export class PointerHub {
     }
     onRemoved(pointerField) {
         if (this.#inTransaction.isEmpty()) {
-            this.#vertex.graph.subscribeEndTransaction(this.#onEndTransaction);
             this.#inTransaction = Option.wrap([{ type: "remove", pointerField }]);
+            this.#vertex.graph.subscribeEndTransaction(this.#onEndTransaction);
         }
         else {
             this.#inTransaction.unwrap().push({ type: "remove", pointerField });

package/dist/pointer.d.ts

@@ -1,4 +1,4 @@
-import { DataInput, DataOutput, Nullish, Observer, Option, Subscription } from "@opendaw/lib-std";
+import { DataInput, DataOutput, Nullish, Observer, Option, Provider, Subscription } from "@opendaw/lib-std";
 import { Vertex, VertexVisitor } from "./vertex";
 import { Address } from "./address";
 import { PointerHub } from "./pointer-hub";
@@ -6,9 +6,17 @@ import { Field, FieldConstruct } from "./field";
 declare const _Unreferenceable: unique symbol;
 export type UnreferenceableType = typeof _Unreferenceable;
 export type PointerTypes = number | string | UnreferenceableType;
+export interface SpecialEncoder {
+    map(pointer: PointerField): Option<Address>;
+}
+export interface SpecialDecoder {
+    map(pointer: PointerField, newAddress: Option<Address>): Option<Address>;
+}
 export declare class PointerField<P extends PointerTypes = PointerTypes> extends Field<UnreferenceableType, never> {
     #private;
     static create<P extends PointerTypes>(construct: FieldConstruct<UnreferenceableType>, pointerType: P, mandatory: boolean): PointerField<P>;
+    static encodeWith<R>(encoder: SpecialEncoder, exec: Provider<R>): R;
+    static decodeWith<R>(decoder: SpecialDecoder, exec: Provider<R>): R;
     private constructor();
     get pointerHub(): PointerHub;
     get pointerType(): P;

package/dist/pointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAsB,YAAY,EAAC,MAAM,kBAAkB,CAAA;AACnH,OAAO,EAAC,MAAM,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AACxC,OAAO,EAAC,KAAK,EAAE,cAAc,EAAC,MAAM,SAAS,CAAA;AAG7C,QAAA,MAAM,gBAAgB,eAA4B,CAAA;AAElD,MAAM,MAAM,mBAAmB,GAAG,OAAO,gBAAgB,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEhE,qBAAa,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC;;IACtG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC,mBAAmB,CAAC,EAC9C,WAAW,EAAE,CAAC,EACd,SAAS,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;IAU1E,OAAO;IASP,IAAI,UAAU,IAAI,UAAU,CAA+C;IAE3E,IAAI,WAAW,IAAI,CAAC,CAA2B;IAC/C,IAAI,SAAS,IAAI,OAAO,CAAyB;IAEjD,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAIjD,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAM3D,KAAK,CAAC,MAAM,SAAS,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI;IAInG,KAAK,IAAI,IAAI;IAEb,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,CAIjC;IACD,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAQtC;IAED,IAAI,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,CAA6B;IACjE,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EAM1C;IAED,OAAO,IAAI,OAAO;IAClB,QAAQ,IAAI,OAAO;IAEnB,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI;IAE3C,IAAI,CAAC,KAAK,EAAE,SAAS;IAIrB,KAAK,CAAC,MAAM,EAAE,UAAU;CAS3B"}
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,MAAM,EAEN,QAAQ,EAER,YAAY,EAEf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAC,MAAM,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AACxC,OAAO,EAAC,KAAK,EAAE,cAAc,EAAC,MAAM,SAAS,CAAA;AAG7C,QAAA,MAAM,gBAAgB,eAA4B,CAAA;AAElD,MAAM,MAAM,mBAAmB,GAAG,OAAO,gBAAgB,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEhE,MAAM,WAAW,cAAc;IAAE,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;CAAC;AAE7E,MAAM,WAAW,cAAc;IAAE,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;CAAC;AAE1G,qBAAa,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC;;IACtG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,YAAY,EAAE,SAAS,EAAE,cAAc,CAAC,mBAAmB,CAAC,EAC9C,WAAW,EAAE,CAAC,EACd,SAAS,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;IAI1E,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;IAWnE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;IAoBnE,OAAO;IASP,IAAI,UAAU,IAAI,UAAU,CAA+C;IAE3E,IAAI,WAAW,IAAI,CAAC,CAA2B;IAC/C,IAAI,SAAS,IAAI,OAAO,CAAyB;IAEjD,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAIjD,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAM3D,KAAK,CAAC,MAAM,SAAS,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI;IAInG,KAAK,IAAI,IAAI;IAEb,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,CAIjC;IACD,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAQtC;IAED,IAAI,aAAa,IAAI,MAAM,CAAC,OAAO,CAAC,CAA6B;IACjE,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EAM1C;IAED,OAAO,IAAI,OAAO;IAClB,QAAQ,IAAI,OAAO;IAEnB,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI;IAE3C,IAAI,CAAC,KAAK,EAAE,SAAS;IAUrB,KAAK,CAAC,MAAM,EAAE,UAAU;CAY3B"}

package/dist/pointer.js

@@ -1,4 +1,4 @@
-import { Option, panic, safeExecute } from "@opendaw/lib-std";
+import { assert, Option, panic, safeExecute, tryCatch } from "@opendaw/lib-std";
 import { Address } from "./address";
 import { PointerHub } from "./pointer-hub";
 import { Field } from "./field";
@@ -8,6 +8,28 @@ export class PointerField extends Field {
     static create(construct, pointerType, mandatory) {
         return new PointerField(construct, pointerType, mandatory);
     }
+    static encodeWith(encoder, exec) {
+        assert(this.#encoder.isEmpty(), "SerializationEncoder already in use");
+        this.#encoder = Option.wrap(encoder);
+        const result = tryCatch(exec);
+        this.#encoder = Option.None;
+        if (result.status === "failure") {
+            throw result.error;
+        }
+        return result.value;
+    }
+    static decodeWith(decoder, exec) {
+        assert(this.#decoder.isEmpty(), "SerializationDecoder already in use");
+        this.#decoder = Option.wrap(decoder);
+        const result = tryCatch(exec);
+        this.#decoder = Option.None;
+        if (result.status === "failure") {
+            throw result.error;
+        }
+        return result.value;
+    }
+    static #encoder = Option.None;
+    static #decoder = Option.None;
     #pointerType;
     #mandatory;
     #targetVertex = Option.None;
@@ -65,10 +87,19 @@ export class PointerField extends Field {
     nonEmpty() { return this.targetAddress.nonEmpty(); }
     resolvedTo(newTarget) { this.#targetVertex = newTarget; }
     read(input) {
-        this.targetAddress = input.readBoolean() ? Option.wrap(Address.read(input)) : Option.None;
+        const address = input.readBoolean()
+            ? Option.wrap(Address.read(input))
+            : Option.None;
+        this.targetAddress = PointerField.#decoder.match({
+            none: () => address,
+            some: decoder => decoder.map(this, address)
+        });
     }
     write(output) {
-        this.#targetAddress.match({
+        PointerField.#encoder.match({
+            none: () => this.#targetAddress,
+            some: encoder => encoder.map(this)
+        }).match({
             none: () => output.writeBoolean(false),
             some: address => {
                 output.writeBoolean(true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendaw/lib-box",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "license": "LGPL-3.0-or-later",
@@ -22,12 +22,12 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@opendaw/lib-runtime": "^0.0.19",
-    "@opendaw/lib-std": "^0.0.19"
+    "@opendaw/lib-runtime": "^0.0.20",
+    "@opendaw/lib-std": "^0.0.20"
   },
   "devDependencies": {
     "@opendaw/eslint-config": "^0.0.18",
     "@opendaw/typescript-config": "^0.0.19"
   },
-  "gitHead": "8d9e873aad633820cd26f76dc447674728401495"
+  "gitHead": "de891be4fc9e418776b3a6c433748e287abab912"
 }