@grafloria/element 0.3.17 → 0.3.19

package/src/libs/engine/src/state/DiagramStore.js

@@ -0,0 +1,372 @@
+"use strict";
+// DiagramStore - State management for diagram application
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagramStore = void 0;
+class DiagramStore {
+    constructor(initialState) {
+        this.listeners = new Map();
+        this.globalListeners = new Set();
+        this.history = [];
+        this.maxHistorySize = 50;
+        this.computedCache = new Map();
+        this.batching = false;
+        this.batchedChanges = [];
+        this.state = this.createInitialState(initialState);
+    }
+    /**
+     * Get current state (immutable)
+     */
+    getState() {
+        return this.deepFreeze(this.deepClone(this.state));
+    }
+    /**
+     * Set state with change tracking
+     */
+    setState(updater) {
+        const prevState = this.deepClone(this.state);
+        // Apply update
+        updater(this.state);
+        // Find changes
+        const changes = this.diffState(prevState, this.state);
+        if (changes.length > 0) {
+            if (this.batching) {
+                // Accumulate changes during batch
+                this.batchedChanges.push(...changes);
+            }
+            else {
+                // Invalidate computed values
+                this.invalidateComputed(changes);
+                // Notify listeners
+                this.notifyListeners(changes);
+                // Add to history
+                this.addToHistory();
+            }
+        }
+    }
+    /**
+     * Get state value by path
+     */
+    select(path) {
+        const keys = path.split('.');
+        let value = this.state;
+        for (const key of keys) {
+            if (value == null)
+                return undefined;
+            value = value[key];
+        }
+        return value;
+    }
+    /**
+     * Get state value by path
+     */
+    get(path) {
+        const keys = path.split('.');
+        let target = this.state;
+        for (const key of keys) {
+            if (target === undefined || target === null) {
+                return undefined;
+            }
+            target = target[key];
+        }
+        return target;
+    }
+    /**
+     * Set state value by path
+     */
+    set(path, value) {
+        this.setState((state) => {
+            const keys = path.split('.');
+            const lastKey = keys.pop();
+            let target = state;
+            for (const key of keys) {
+                if (!(key in target)) {
+                    target[key] = {};
+                }
+                target = target[key];
+            }
+            target[lastKey] = value;
+        });
+    }
+    /**
+     * Subscribe to all state changes
+     */
+    subscribe(listener) {
+        this.globalListeners.add(listener);
+        return () => this.globalListeners.delete(listener);
+    }
+    /**
+     * Subscribe to path changes
+     */
+    watch(path, listener) {
+        if (!this.listeners.has(path)) {
+            this.listeners.set(path, new Set());
+        }
+        this.listeners.get(path).add(listener);
+        return () => {
+            const pathListeners = this.listeners.get(path);
+            if (pathListeners) {
+                pathListeners.delete(listener);
+                if (pathListeners.size === 0) {
+                    this.listeners.delete(path);
+                }
+            }
+        };
+    }
+    /**
+     * Computed value with memoization
+     */
+    computed(key, compute, deps) {
+        const cached = this.computedCache.get(key);
+        if (cached && cached.valid) {
+            return cached.value;
+        }
+        const value = compute(this.state);
+        this.computedCache.set(key, {
+            value,
+            deps: deps || [],
+            valid: true,
+        });
+        return value;
+    }
+    /**
+     * Batch multiple state updates
+     */
+    batch(fn) {
+        this.batching = true;
+        this.batchedChanges = [];
+        try {
+            fn();
+            // Process accumulated changes
+            if (this.batchedChanges.length > 0) {
+                // Remove duplicates
+                const uniqueChanges = Array.from(new Set(this.batchedChanges));
+                this.invalidateComputed(uniqueChanges);
+                this.notifyListeners(uniqueChanges);
+                this.addToHistory();
+            }
+        }
+        finally {
+            this.batching = false;
+            this.batchedChanges = [];
+        }
+    }
+    /**
+     * Reset to initial state
+     */
+    reset(initialState) {
+        this.state = this.createInitialState(initialState);
+        this.computedCache.clear();
+        this.notifyListeners(['*']);
+        this.history = [];
+    }
+    /**
+     * Time travel to history index
+     */
+    timeTravel(index) {
+        if (index >= 0 && index < this.history.length) {
+            const snapshot = this.history[index];
+            this.state = this.deepClone(snapshot.state);
+            this.computedCache.clear();
+            this.notifyListeners(['*']);
+        }
+    }
+    /**
+     * Get history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Create snapshot
+     */
+    createSnapshot() {
+        return {
+            timestamp: Date.now(),
+            state: this.deepClone(this.state),
+            version: '1.0.0',
+        };
+    }
+    /**
+     * Restore snapshot
+     */
+    restoreSnapshot(snapshot) {
+        this.state = this.deepClone(snapshot.state);
+        this.computedCache.clear();
+        this.notifyListeners(['*']);
+    }
+    /**
+     * Create initial state
+     */
+    createInitialState(partial) {
+        return Object.assign({ diagram: null, selectedNodes: new Set(), selectedLinks: new Set(), hoveredElement: null, focusedElement: null, viewport: { x: 0, y: 0, zoom: 1, rotation: 0 }, zoom: 1, gridEnabled: true, snapEnabled: true, activeTool: 'select', toolOptions: {}, mode: 'design', locked: false, theme: 'light', showMinimap: false, showToolbar: true, showProperties: true, renderStats: {
+                fps: 60,
+                renderTime: 0,
+                nodeCount: 0,
+                linkCount: 0,
+                visibleNodes: 0,
+                visibleLinks: 0,
+            }, errors: [], warnings: [] }, partial);
+    }
+    /**
+     * Diff two states
+     */
+    diffState(prev, current, path = '', depth = 0) {
+        const changes = [];
+        const MAX_DEPTH = 10; // Prevent infinite recursion
+        // Prevent infinite recursion
+        if (depth > MAX_DEPTH) {
+            if (path && prev !== current)
+                changes.push(path);
+            return changes;
+        }
+        // Handle primitives
+        if (prev === current)
+            return changes;
+        if (typeof prev !== 'object' || typeof current !== 'object' || prev === null || current === null) {
+            if (path)
+                changes.push(path);
+            return changes;
+        }
+        // Handle Sets
+        if (prev instanceof Set || current instanceof Set) {
+            const prevSet = prev instanceof Set ? prev : new Set();
+            const currSet = current instanceof Set ? current : new Set();
+            if (prevSet.size !== currSet.size || ![...prevSet].every((v) => currSet.has(v))) {
+                if (path)
+                    changes.push(path);
+            }
+            return changes;
+        }
+        // Handle arrays
+        if (Array.isArray(prev) || Array.isArray(current)) {
+            if (JSON.stringify(prev) !== JSON.stringify(current)) {
+                if (path)
+                    changes.push(path);
+            }
+            return changes;
+        }
+        // Handle objects - skip class instances to avoid circular references
+        if (prev.constructor !== Object || current.constructor !== Object) {
+            if (path && prev !== current)
+                changes.push(path);
+            return changes;
+        }
+        // Handle plain objects only
+        const allKeys = new Set([...Object.keys(prev || {}), ...Object.keys(current || {})]);
+        for (const key of allKeys) {
+            const prevValue = prev === null || prev === void 0 ? void 0 : prev[key];
+            const currentValue = current === null || current === void 0 ? void 0 : current[key];
+            const keyPath = path ? `${path}.${key}` : key;
+            if (prevValue !== currentValue) {
+                if (typeof prevValue === 'object' &&
+                    typeof currentValue === 'object' &&
+                    prevValue !== null &&
+                    currentValue !== null) {
+                    changes.push(...this.diffState(prevValue, currentValue, keyPath, depth + 1));
+                }
+                else {
+                    changes.push(keyPath);
+                }
+            }
+        }
+        return changes;
+    }
+    /**
+     * Notify listeners of changes
+     */
+    notifyListeners(changes) {
+        // Notify path listeners
+        for (const change of changes) {
+            const listeners = this.listeners.get(change);
+            if (listeners) {
+                const value = this.select(change);
+                listeners.forEach((listener) => listener(value, undefined));
+            }
+            // Notify parent path listeners
+            const parts = change.split('.');
+            for (let i = parts.length - 1; i > 0; i--) {
+                const parentPath = parts.slice(0, i).join('.');
+                const parentListeners = this.listeners.get(parentPath);
+                if (parentListeners) {
+                    const value = this.select(parentPath);
+                    parentListeners.forEach((listener) => listener(value, undefined));
+                }
+            }
+        }
+        // Notify global listeners
+        this.globalListeners.forEach((listener) => {
+            listener(this.state, changes);
+        });
+    }
+    /**
+     * Invalidate computed values
+     */
+    invalidateComputed(changes) {
+        for (const [key, cached] of this.computedCache.entries()) {
+            for (const dep of cached.deps) {
+                if (changes.some((change) => change.startsWith(dep))) {
+                    cached.valid = false;
+                    break;
+                }
+            }
+        }
+    }
+    /**
+     * Add to history
+     */
+    addToHistory() {
+        this.history.push(this.createSnapshot());
+        if (this.history.length > this.maxHistorySize) {
+            this.history.shift();
+        }
+    }
+    /**
+     * Deep clone object (handles Sets, Maps, Arrays, Objects)
+     */
+    deepClone(obj) {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        if (obj instanceof Set) {
+            return new Set(Array.from(obj));
+        }
+        if (obj instanceof Map) {
+            return new Map(Array.from(obj));
+        }
+        if (obj instanceof Date) {
+            return new Date(obj);
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.deepClone(item));
+        }
+        // For class instances (has a constructor other than Object), return as-is
+        // This prevents trying to clone DiagramModel, NodeModel, etc.
+        if (obj.constructor && obj.constructor !== Object) {
+            return obj;
+        }
+        const cloned = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                cloned[key] = this.deepClone(obj[key]);
+            }
+        }
+        return cloned;
+    }
+    /**
+     * Deep freeze object
+     */
+    deepFreeze(obj) {
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        Object.freeze(obj);
+        Object.getOwnPropertyNames(obj).forEach((prop) => {
+            if (obj[prop] !== null && typeof obj[prop] === 'object' && !Object.isFrozen(obj[prop])) {
+                this.deepFreeze(obj[prop]);
+            }
+        });
+        return obj;
+    }
+}
+exports.DiagramStore = DiagramStore;
+//# sourceMappingURL=DiagramStore.js.map

package/src/libs/engine/src/state/DiagramStore.js.map

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

package/src/libs/engine/src/state/index.d.ts

@@ -0,0 +1,2 @@
+export * from './DiagramStore';
+export * from './ConnectionStateManager';

package/src/libs/engine/src/state/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// State index - exports state management components
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./DiagramStore"), exports);
+tslib_1.__exportStar(require("./ConnectionStateManager"), exports);
+//# sourceMappingURL=index.js.map

package/src/libs/engine/src/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../engine/src/state/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,yDAA+B;AAC/B,mEAAyC"}

package/src/libs/engine/src/sync/awareness.d.ts

@@ -0,0 +1,91 @@
+import type { ActorId } from '../collab/op';
+import type { AwarenessState } from './protocol';
+export type { AwarenessState };
+/** Another peer, as far as we know. */
+export interface PeerPresence {
+    actor: ActorId;
+    state: AwarenessState;
+    /** Wall-clock ms of the last message from them. NOT a Lamport clock — see below. */
+    lastSeen: number;
+    /** Their sequence number for `state`. Guards against a reordered cursor sample. */
+    seq: number;
+}
+export interface AwarenessChange {
+    added: ActorId[];
+    updated: ActorId[];
+    removed: ActorId[];
+}
+export interface AwarenessOptions {
+    actor: ActorId;
+    /** Drop a peer we have not heard from in this long. */
+    timeoutMs?: number;
+    /** Wall clock — injectable so the expiry tests are not a race against real time. */
+    now?: () => number;
+}
+/**
+ * The presence store for one peer: our own state, and everyone else's.
+ *
+ * Deliberately transport-free. `SyncAdapter` wires it to a channel; a test wires it to
+ * nothing and drives it directly. It never sees an Op, a Replica or an OpLog, and that
+ * is not an accident — it is the containment.
+ *
+ * ---------------------------------------------------------------------------
+ * WHY `lastSeen` IS A WALL CLOCK WHEN THE LOG WENT TO SUCH LENGTHS TO AVOID ONE
+ * ---------------------------------------------------------------------------
+ * Because the question is different. The log asks "did A happen before B?", which a wall
+ * clock cannot answer across machines (they disagree, and they run backwards). Expiry
+ * asks "has it been 15 seconds since I last heard from Bob?" — measured entirely on MY
+ * clock, about MY receipts, comparing my own `now()` to my own earlier `now()`. Bob's
+ * clock is never consulted, so its wrongness cannot infect anything. Using a Lamport
+ * clock for a TIMEOUT would be the actual mistake: it has no relationship to seconds.
+ */
+export declare class Awareness {
+    private readonly options;
+    private readonly peers;
+    private local;
+    private seq;
+    private readonly listeners;
+    private readonly timeoutMs;
+    private readonly nowFn;
+    constructor(options: AwarenessOptions);
+    get actor(): ActorId;
+    /** Our own published state, and the sequence a peer will LWW it by. */
+    getLocalState(): AwarenessState;
+    get localSeq(): number;
+    /**
+     * Merge a patch into our own state and bump the sequence.
+     *
+     * Returns false when nothing actually changed — a mouse that has not moved must not
+     * burn a sequence number, wake the throttle, or send a message. (A `mousemove` fires
+     * on sub-pixel jitter and on scroll; without this guard an idle user with a resting
+     * hand is a 60Hz broadcaster.)
+     */
+    setLocalState(patch: Partial<AwarenessState>): boolean;
+    /**
+     * Take a peer's published state.
+     *
+     * `seq` is the whole reason a reordered transport does not make a cursor jump
+     * backwards: a sample older than the one we already hold is REFUSED, exactly as the LWW
+     * gate refuses a superseded op. Same idea, one scope down, and no shared machinery
+     * because the lifecycles have nothing in common.
+     */
+    applyRemote(actor: ActorId, state: AwarenessState | null, seq: number): AwarenessChange | null;
+    /** An explicit `bye`, or a transport that told us the peer is gone. */
+    remove(actor: ActorId): AwarenessChange | null;
+    /**
+     * Drop peers we have not heard from inside the timeout.
+     *
+     * THE GUARANTEE, as opposed to `bye`, which is merely the optimisation. A crashed tab,
+     * a closed laptop, a killed process and a severed cable all send no `bye` whatsoever,
+     * and every one of them must eventually stop showing a cursor.
+     */
+    prune(): AwarenessChange | null;
+    /** Everyone but us. */
+    getPeers(): PeerPresence[];
+    getPeer(actor: ActorId): PeerPresence | undefined;
+    get peerCount(): number;
+    /** Everyone is gone (we disconnected — we can no longer vouch for anyone). */
+    clearPeers(): AwarenessChange | null;
+    onChange(listener: (change: AwarenessChange) => void): () => void;
+    private emit;
+}