@opendaw/lib-box 0.0.62 → 0.0.64

package/dist/editing.d.ts

@@ -1,5 +1,5 @@
 import { BoxGraph } from "./graph";
-import { Editing, Maybe, Option, SyncProvider } from "@opendaw/lib-std";
+import { Editing, Maybe, Observer, Option, Subscription, SyncProvider } from "@opendaw/lib-std";
 export interface ModificationProcess {
     approve(): void;
     revert(): void;
@@ -8,12 +8,15 @@ export declare class BoxEditing implements Editing {
     #private;
     constructor(graph: BoxGraph);
     get graph(): BoxGraph;
+    subscribe(observer: Observer<void>): Subscription;
     markSaved(): void;
     hasUnsavedChanges(): boolean;
     isEmpty(): boolean;
     clear(): void;
     undo(): boolean;
     redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
     mustModify(): boolean;
     modify<R>(modifier: SyncProvider<Maybe<R>>, mark?: boolean): Option<R>;
     beginModification(): ModificationProcess;

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,EAAiB,OAAO,EAAO,KAAK,EAAE,MAAM,EAAY,YAAY,EAAC,MAAM,kBAAkB,CAAA;AAqBpG,MAAM,WAAW,mBAAmB;IAChC,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;CACjB;AAED,qBAAa,UAAW,YAAW,OAAO;;gBAU1B,KAAK,EAAE,QAAQ;IAI3B,IAAI,KAAK,IAAI,QAAQ,CAAqB;IAE1C,SAAS,IAAI,IAAI;IAKjB,iBAAiB,IAAI,OAAO;IAM5B,OAAO,IAAI,OAAO;IAElB,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,OAAO;IAUf,IAAI,IAAI,OAAO;IAcf,UAAU,IAAI,OAAO;IAErB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM,CAAC,CAAC,CAAC;IAW5E,iBAAiB,IAAI,mBAAmB;IAuCxC,IAAI,IAAI,IAAI;IAYZ,YAAY,IAAI,IAAI;IAMpB,OAAO,IAAI,IAAI;CAGlB"}
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../src/editing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAA;AAChC,OAAO,EAGH,OAAO,EAEP,KAAK,EAEL,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,YAAY,EACf,MAAM,kBAAkB,CAAA;AAqBzB,MAAM,WAAW,mBAAmB;IAChC,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;CACjB;AAED,qBAAa,UAAW,YAAW,OAAO;;gBAY1B,KAAK,EAAE,QAAQ;IAM3B,IAAI,KAAK,IAAI,QAAQ,CAAqB;IAE1C,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY;IAIjD,SAAS,IAAI,IAAI;IAKjB,iBAAiB,IAAI,OAAO;IAM5B,OAAO,IAAI,OAAO;IAElB,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,OAAO;IAWf,IAAI,IAAI,OAAO;IASf,OAAO,IAAI,OAAO;IAKlB,OAAO,IAAI,OAAO;IAkBlB,UAAU,IAAI,OAAO;IAErB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM,CAAC,CAAC,CAAC;IA2B5E,iBAAiB,IAAI,mBAAmB;IAmCxC,IAAI,IAAI,IAAI;IAYZ,YAAY,IAAI,IAAI;IAOpB,OAAO,IAAI,IAAI;CAGlB"}

package/dist/editing.js

@@ -1,4 +1,4 @@
-import { Arrays, assert, Option } from "@opendaw/lib-std";
+import { Arrays, assert, Notifier, Option } from "@opendaw/lib-std";
 class Modification {
     #updates;
     constructor(updates) { this.#updates = updates; }
@@ -17,14 +17,20 @@ export class BoxEditing {
     #graph;
     #pending = [];
     #marked = [];
+    #notifier;
     #modifying = false;
+    #inProcess = false;
     #disabled = false;
     #historyIndex = 0;
     #savedHistoryIndex = 0; // -1 = saved state was spliced away, >= 0 = valid saved position
     constructor(graph) {
         this.#graph = graph;
+        this.#notifier = new Notifier();
     }
     get graph() { return this.#graph; }
+    subscribe(observer) {
+        return this.#notifier.subscribe(observer);
+    }
     markSaved() {
         if (this.#pending.length > 0) {
             this.mark();
@@ -47,91 +53,124 @@ export class BoxEditing {
         Arrays.clear(this.#marked);
         this.#historyIndex = 0;
         this.#savedHistoryIndex = 0;
+        this.#notifier.notify();
     }
     undo() {
-        if (this.#disabled) {
+        if (!this.canUndo()) {
             return false;
         }
         if (this.#pending.length > 0) {
             this.mark();
         }
-        if (this.#historyIndex === 0) {
-            return false;
-        }
+        console.debug("undo");
         const modifications = this.#marked[--this.#historyIndex];
         modifications.toReversed().forEach(step => step.inverse(this.#graph));
         this.#graph.edges().validateRequirements();
+        this.#notifier.notify();
         return true;
     }
     redo() {
+        if (!this.canRedo()) {
+            return false;
+        }
+        console.debug("redo");
+        this.#marked[this.#historyIndex++].forEach(step => step.forward(this.#graph));
+        this.#graph.edges().validateRequirements();
+        this.#notifier.notify();
+        return true;
+    }
+    canUndo() {
         if (this.#disabled) {
             return false;
         }
-        if (this.#historyIndex === this.#marked.length) {
+        return this.#historyIndex !== 0 || this.#pending.length > 0;
+    }
+    canRedo() {
+        if (this.#disabled) {
             return false;
         }
-        if (this.#pending.length > 0) {
-            console.warn("redo while having pending updates?");
+        if (this.#historyIndex === this.#marked.length) {
             return false;
         }
-        this.#marked[this.#historyIndex++].forEach(step => step.forward(this.#graph));
-        this.#graph.edges().validateRequirements();
-        return true;
+        return this.#pending.length <= 0;
     }
-    // TODO This is an option to clarify, if user actions meant to be run by a modifier or not.
-    //  See ParameterWrapper. Not the nicest solution. Probably coming back to this sooner or later.
+    // TODO This method exists to handle bidirectional sync between UI state and Box state.
+    //  Problem: When a Box field changes (e.g., during undo/redo), reactive subscriptions may fire
+    //  and attempt to call modify() to sync the UI state back to the Box. But since undo/redo
+    //  already has a transaction open (via Modification.inverse/forward calling beginTransaction
+    //  directly), calling modify() would fail with "Transaction already in progress".
+    //  Current workaround: Callers check mustModify() before calling modify(). If false (transaction
+    //  already open), they either skip the call or call setValue directly without recording history.
+    //  See: EditWrapper.forValue, EditWrapper.forAutomatableParameter, TransportGroup loop sync.
+    //  Better solution: Consider having Modification.inverse/forward use the same #modifying flag
+    //  as modify(), or introduce a unified "modification context" that both undo/redo and user
+    //  actions share. This would allow modify() to detect it's being called reactively during
+    //  undo/redo and handle it internally, rather than requiring all callers to guard with mustModify().
     mustModify() { return !this.#graph.inTransaction(); }
     modify(modifier, mark = true) {
+        assert(!this.#inProcess, "Cannot call modify while a modification process is running");
         if (this.#modifying) {
-            // we just keep adding new pending updates
+            // Nested modify call - just execute without separate recording
+            this.#notifier.notify();
             return Option.wrap(modifier());
         }
         if (mark && this.#pending.length > 0) {
             this.mark();
         }
-        const result = Option.wrap(this.#modify(modifier));
+        this.#modifying = true;
+        const updates = [];
+        const subscription = this.#graph.subscribeToAllUpdates({
+            onUpdate: (update) => updates.push(update)
+        });
+        this.#graph.beginTransaction();
+        const result = modifier();
+        this.#graph.endTransaction();
+        subscription.terminate();
+        if (updates.length > 0) {
+            this.#pending.push(new Modification(updates));
+        }
+        this.#modifying = false;
+        this.#graph.edges().validateRequirements();
         if (mark) {
             this.mark();
         }
-        return result;
+        this.#notifier.notify();
+        return Option.wrap(result);
     }
     beginModification() {
-        const alreadyIntransaction = this.#graph.inTransaction();
-        if (!alreadyIntransaction) {
-            this.#graph.beginTransaction();
-        }
+        assert(!this.#modifying && !this.#inProcess, "Cannot begin modification while another is in progress");
         this.#modifying = true;
-        const complete = () => {
-            this.#modifying = false;
-            if (!alreadyIntransaction) {
+        this.#inProcess = true;
+        const updates = [];
+        const subscription = this.#graph.subscribeToAllUpdates({
+            onUpdate: (update) => updates.push(update)
+        });
+        this.#graph.beginTransaction();
+        return {
+            approve: () => {
                 this.#graph.endTransaction();
+                subscription.terminate();
+                if (updates.length > 0) {
+                    this.#pending.push(new Modification(updates));
+                }
+                this.#modifying = false;
+                this.#inProcess = false;
                 this.#graph.edges().validateRequirements();
-            }
-        };
-        return {
-            approve: complete,
+                this.mark();
+                this.#notifier.notify();
+            },
             revert: () => {
-                this.clearPending();
-                complete();
+                this.#graph.endTransaction();
+                subscription.terminate();
+                this.#modifying = false;
+                this.#inProcess = false;
+                this.#graph.edges().validateRequirements();
+                if (updates.length > 0) {
+                    new Modification(updates).inverse(this.#graph);
+                }
             }
         };
     }
-    #modify(modifier) {
-        assert(!this.#modifying, "Already modifying");
-        this.#modifying = true;
-        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();
-        return result;
-    }
     mark() {
         if (this.#pending.length === 0) {
             return;
@@ -151,6 +190,7 @@ export class BoxEditing {
         }
         this.#pending.reverse().forEach(modification => modification.inverse(this.#graph));
         this.#pending.length = 0;
+        this.#notifier.notify();
     }
     disable() {
         this.#disabled = true;

package/dist/graph.d.ts

@@ -41,6 +41,7 @@ export declare class BoxGraph<BoxMap = any> {
     checksum(): Int8Array;
     onPrimitiveValueUpdate<V extends PrimitiveValues>(field: PrimitiveField<V, any>, oldValue: V, newValue: V): void;
     onPointerAddressUpdated(pointerField: PointerField, oldValue: Option<Address>, newValue: Option<Address>): void;
+    findOrphans(rootBox: Box): ReadonlyArray<Box>;
     dependenciesOf(box: Box, options?: {
         excludeBox?: Predicate<Box>;
         alwaysFollowMandatory?: boolean;

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

@@ -155,6 +155,50 @@ export class BoxGraph {
         this.#dispatchers.dispatch(update);
         this.#updateListeners.proxy.onUpdate(update);
     }
+    findOrphans(rootBox) {
+        const connectedBoxes = this.#collectAllConnectedBoxes(rootBox);
+        return this.boxes().filter(box => !connectedBoxes.has(box));
+    }
+    #collectAllConnectedBoxes(rootBox) {
+        const visited = new Set();
+        const queue = [rootBox];
+        while (queue.length > 0) {
+            const box = queue.pop();
+            if (visited.has(box)) {
+                continue;
+            }
+            visited.add(box);
+            this.#collectPointersFromBox(box).forEach(pointer => {
+                pointer.targetAddress.ifSome(address => {
+                    this.findBox(address.uuid).ifSome(targetBox => {
+                        if (!visited.has(targetBox)) {
+                            queue.push(targetBox);
+                        }
+                    });
+                });
+            });
+            for (const pointer of box.incomingEdges()) {
+                if (!visited.has(pointer.box)) {
+                    queue.push(pointer.box);
+                }
+            }
+        }
+        return visited;
+    }
+    #collectPointersFromBox(box) {
+        const pointers = [];
+        const collectFromFields = (fields) => {
+            for (const field of fields) {
+                field.accept({
+                    visitPointerField: (p) => pointers.push(p),
+                    visitObjectField: (o) => collectFromFields(o.fields()),
+                    visitArrayField: (a) => collectFromFields(a.fields())
+                });
+            }
+        };
+        collectFromFields(box.fields());
+        return pointers;
+    }
     dependenciesOf(box, options = {}) {
         const excludeBox = isDefined(options.excludeBox) ? options.excludeBox : Predicates.alwaysFalse;
         const alwaysFollowMandatory = isDefined(options.alwaysFollowMandatory) ? options.alwaysFollowMandatory : false;
@@ -173,6 +217,8 @@ export class BoxGraph {
                 pointers.add(source);
                 if (targetVertex.pointerRules.mandatory &&
                     (alwaysFollowMandatory || targetVertex.pointerHub.incoming()
+                        // Only check pointers to this specific address, not to other fields in the box
+                        .filter(p => p.targetAddress.mapOr(address => address.equals(targetAddress), false))
                         .every(pointer => pointers.has(pointer)))) {
                     return trace(targetVertex.box);
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@opendaw/lib-box",
-    "version": "0.0.62",
+    "version": "0.0.64",
     "sideEffects": false,
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -23,12 +23,12 @@
         "test": "vitest run"
     },
     "dependencies": {
-        "@opendaw/lib-runtime": "^0.0.61",
-        "@opendaw/lib-std": "^0.0.61"
+        "@opendaw/lib-runtime": "^0.0.63",
+        "@opendaw/lib-std": "^0.0.63"
     },
     "devDependencies": {
         "@opendaw/eslint-config": "^0.0.27",
-        "@opendaw/typescript-config": "^0.0.27"
+        "@opendaw/typescript-config": "^0.0.28"
     },
-    "gitHead": "b33275f0f9dbfc525fe517560b484514bdae3dad"
+    "gitHead": "db2b1bd172607177fef63077c2eed9b7cbec167f"
 }