@grafloria/element 0.3.17 → 0.3.19

package/src/libs/engine/src/dsl/sync/LayoutApplicator.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Layout Applicator - Applies layout presets to diagrams
+ *
+ * Integrates LayoutDetector with LayoutManager to automatically
+ * apply optimal layouts to diagrams after parsing or modification.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutApplicator = void 0;
+const tslib_1 = require("tslib");
+const LayoutDetector_1 = require("../detector/LayoutDetector");
+const layout_presets_1 = require("../../layout/layout-presets");
+const layout_registry_1 = require("../../layout/layout-registry");
+/**
+ * A preset's options, in the shape the Card-0 registry wants.
+ *
+ * The presets are written in each adapter's own dialect (`rankdir`/`nodesep` for
+ * dagre, `elk.direction` for ELK) and `translateOptions()` passes unknown keys
+ * straight through to the adapter, so the dialect keys land exactly where they
+ * are read. `constraints` rides along in the shared LayoutOptions slot, which is
+ * the only reason the presets' pinning config ever reaches an adapter.
+ *
+ * (`preset.incrementalOptions` is NOT applied here. It configures
+ * `adapter.applyIncremental()` — a different entry point, for adding nodes to an
+ * existing layout — and pretending to honour it from a full-layout call would be
+ * the same lie this method was telling before. Card 6 owns incremental layout.)
+ */
+function presetOptions(preset) {
+    return Object.assign(Object.assign({}, preset.options), (preset.constraints ? { constraints: preset.constraints } : {}));
+}
+class LayoutApplicator {
+    constructor(options = {}) {
+        var _a, _b, _c;
+        this.detector = new LayoutDetector_1.LayoutDetector();
+        this.options = {
+            minConfidence: (_a = options.minConfidence) !== null && _a !== void 0 ? _a : 0.7,
+            debug: (_b = options.debug) !== null && _b !== void 0 ? _b : false,
+            customLayouts: (_c = options.customLayouts) !== null && _c !== void 0 ? _c : new Map(),
+        };
+    }
+    /**
+     * Detect and apply optimal layout
+     */
+    applyOptimalLayout(diagram, ast) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const startTime = performance.now();
+            try {
+                // Detect optimal layout
+                const suggestion = this.detector.detect(diagram, ast);
+                if (this.options.debug) {
+                    console.log(`[LayoutApplicator] Detected layout: ${suggestion.presetId}`);
+                    console.log(`[LayoutApplicator] Confidence: ${suggestion.confidence.toFixed(2)}`);
+                    console.log(`[LayoutApplicator] Reasoning: ${suggestion.reasoning}`);
+                }
+                // Check confidence threshold
+                if (suggestion.confidence < this.options.minConfidence) {
+                    if (this.options.debug) {
+                        console.log(`[LayoutApplicator] Confidence too low (${suggestion.confidence.toFixed(2)} < ${this.options.minConfidence}), skipping`);
+                    }
+                    return {
+                        success: false,
+                        presetId: suggestion.presetId,
+                        confidence: suggestion.confidence,
+                        reasoning: suggestion.reasoning,
+                        error: 'Confidence below threshold',
+                    };
+                }
+                // Apply layout
+                yield this.applyLayoutPreset(diagram, suggestion.presetId);
+                const applyTime = performance.now() - startTime;
+                if (this.options.debug) {
+                    console.log(`[LayoutApplicator] Layout applied in ${applyTime.toFixed(2)}ms`);
+                }
+                return {
+                    success: true,
+                    presetId: suggestion.presetId,
+                    confidence: suggestion.confidence,
+                    reasoning: suggestion.reasoning,
+                    applyTime,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error('[LayoutApplicator] Layout application failed:', errorMessage);
+                return {
+                    success: false,
+                    error: errorMessage,
+                    applyTime: performance.now() - startTime,
+                };
+            }
+        });
+    }
+    /**
+     * Apply a specific layout preset.
+     *
+     * ---------------------------------------------------------------------------
+     * WAVE 7 CARD 2 — THIS METHOD DID NOTHING. THE ENTIRE PRESET LIBRARY WAS DEAD.
+     * ---------------------------------------------------------------------------
+     *
+     * It used to build:
+     *
+     *     const config: LayoutConfiguration = {
+     *       algorithm: preset.adapter === 'dagre' ? 'dagre' : 'elk',
+     *       ...preset.options,           // rankdir, nodesep, 'elk.direction', …
+     *     };
+     *     await diagram.reLayout(config);
+     *
+     * and every part of that was inert:
+     *
+     *   • `LayoutConfiguration` has no `algorithm` field at all. It has `type`, and
+     *     the only legal values are 'grid' | 'force-directed' | 'hierarchical' |
+     *     'hybrid' — 'dagre' and 'elk' are not among them.
+     *   • `reLayout()` then OVERWRITES `type` with `this.currentAlgorithm.getType()`,
+     *     the LayoutManager's single-node placement strategy. So the preset's chosen
+     *     adapter was discarded before it was even mistyped.
+     *   • `reLayout()` reads adapter options from `config.options` (nested). The
+     *     preset's options were spread at the TOP level, so `rankdir`, `nodesep`,
+     *     `ranker`, `elk.direction` — every knob the 17 presets exist to set — were
+     *     never read by anything.
+     *
+     * Net effect: "Org Chart (Compact)", "Workflow (Horizontal)" and
+     * "Force-Directed (Tight)" all produced the SAME picture, whatever the
+     * LayoutManager's current placement algorithm happened to be. The presets, the
+     * detector that chooses between them, and the confidence threshold that gates
+     * the choice were an elaborate no-op. This is the "config declared but never
+     * consumed" shape, and it survived six waves because nothing tested it.
+     *
+     * The fix routes presets through the Card-0 registry — the same path
+     * `engine.layout()` takes — so a preset now genuinely selects its adapter and
+     * genuinely passes its options.
+     */
+    applyLayoutPreset(diagram, presetId) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Custom layouts stay on the LayoutManager path: a LayoutConfiguration IS a
+            // LayoutManager config ('grid'/'hierarchical'/…), and that path works.
+            if (this.options.customLayouts.has(presetId)) {
+                const config = this.options.customLayouts.get(presetId);
+                yield diagram.reLayout(config);
+                return;
+            }
+            const preset = this.findPresetById(presetId);
+            if (!preset) {
+                throw new Error(`Layout preset not found: ${presetId}`);
+            }
+            yield (0, layout_registry_1.runLayout)(this.getLayoutRegistry(), diagram, preset.adapter, presetOptions(preset));
+        });
+    }
+    /**
+     * The registry presets are applied through. Injectable, so a host that has
+     * replaced a built-in layout (or registered its own) gets its version here too
+     * rather than a second, private copy of the built-ins.
+     */
+    getLayoutRegistry() {
+        if (!this.registry) {
+            this.registry = (0, layout_registry_1.createDefaultLayoutRegistry)();
+        }
+        return this.registry;
+    }
+    setLayoutRegistry(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Apply layout with custom configuration
+     */
+    applyCustomLayout(diagram, config) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const startTime = performance.now();
+            try {
+                if (this.options.debug) {
+                    console.log(`[LayoutApplicator] Applying custom layout: ${config.type || 'default'}`);
+                }
+                yield diagram.reLayout(config);
+                const applyTime = performance.now() - startTime;
+                if (this.options.debug) {
+                    console.log(`[LayoutApplicator] Custom layout applied in ${applyTime.toFixed(2)}ms`);
+                }
+                return {
+                    success: true,
+                    applyTime,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error('[LayoutApplicator] Custom layout failed:', errorMessage);
+                return {
+                    success: false,
+                    error: errorMessage,
+                    applyTime: performance.now() - startTime,
+                };
+            }
+        });
+    }
+    /**
+     * Get layout suggestion without applying
+     */
+    suggestLayout(diagram, ast) {
+        return this.detector.detect(diagram, ast);
+    }
+    /**
+     * Find preset by ID in all categories
+     */
+    findPresetById(presetId) {
+        const categories = [
+            layout_presets_1.LayoutPresets.HIERARCHICAL,
+            layout_presets_1.LayoutPresets.FLOW,
+            layout_presets_1.LayoutPresets.NETWORK,
+            layout_presets_1.LayoutPresets.ARCHITECTURE,
+            layout_presets_1.LayoutPresets.INTERACTIVE,
+        ];
+        for (const category of categories) {
+            const preset = category.presets.find((p) => p.id === presetId);
+            if (preset) {
+                return preset;
+            }
+        }
+        return null;
+    }
+    /**
+     * List all available presets
+     */
+    listPresets() {
+        const presets = [];
+        const categories = [
+            { name: 'Hierarchical', category: layout_presets_1.LayoutPresets.HIERARCHICAL },
+            { name: 'Flow', category: layout_presets_1.LayoutPresets.FLOW },
+            { name: 'Network', category: layout_presets_1.LayoutPresets.NETWORK },
+            { name: 'Architecture', category: layout_presets_1.LayoutPresets.ARCHITECTURE },
+            { name: 'Interactive', category: layout_presets_1.LayoutPresets.INTERACTIVE },
+        ];
+        for (const { name, category } of categories) {
+            for (const preset of category.presets) {
+                presets.push({
+                    id: preset.id,
+                    name: preset.name,
+                    category: name,
+                });
+            }
+        }
+        return presets;
+    }
+    /**
+     * Set minimum confidence threshold
+     */
+    setMinConfidence(threshold) {
+        this.options.minConfidence = Math.max(0, Math.min(1, threshold));
+        if (this.options.debug) {
+            console.log(`[LayoutApplicator] Min confidence set to ${this.options.minConfidence.toFixed(2)}`);
+        }
+    }
+    /**
+     * Add custom layout preset
+     */
+    addCustomLayout(id, config) {
+        this.options.customLayouts.set(id, config);
+        if (this.options.debug) {
+            console.log(`[LayoutApplicator] Added custom layout: ${id}`);
+        }
+    }
+    /**
+     * Remove custom layout preset
+     */
+    removeCustomLayout(id) {
+        const removed = this.options.customLayouts.delete(id);
+        if (this.options.debug && removed) {
+            console.log(`[LayoutApplicator] Removed custom layout: ${id}`);
+        }
+        return removed;
+    }
+}
+exports.LayoutApplicator = LayoutApplicator;
+//# sourceMappingURL=LayoutApplicator.js.map

package/src/libs/engine/src/dsl/sync/LayoutApplicator.js.map

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

package/src/libs/engine/src/dsl/sync/SyncStateManager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Sync State Manager - Tracks sync state and provides UI feedback
+ *
+ * Manages synchronization state for UI components:
+ * - Sync status indicators
+ * - Error tracking
+ * - Performance metrics
+ * - Conflict detection
+ */
+import { SyncDirection } from './BidirectionalSync';
+export interface SyncStatus {
+    /**
+     * Current status
+     */
+    status: 'idle' | 'syncing' | 'error' | 'conflict';
+    /**
+     * Status message
+     */
+    message: string;
+    /**
+     * Last sync timestamp
+     */
+    lastSync?: Date;
+    /**
+     * Last sync duration (ms)
+     */
+    lastSyncDuration?: number;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string;
+}
+export interface SyncMetrics {
+    /**
+     * Total syncs performed
+     */
+    totalSyncs: number;
+    /**
+     * Text → Visual syncs
+     */
+    textToVisual: number;
+    /**
+     * Visual → Text syncs
+     */
+    visualToText: number;
+    /**
+     * Sync errors
+     */
+    errors: number;
+    /**
+     * Conflicts resolved
+     */
+    conflicts: number;
+    /**
+     * Average sync time (ms)
+     */
+    averageSyncTime: number;
+    /**
+     * Session duration (ms)
+     */
+    sessionDuration: number;
+}
+export interface ConflictInfo {
+    /**
+     * Timestamp of conflict
+     */
+    timestamp: Date;
+    /**
+     * Conflicting edit sources
+     */
+    sources: [SyncDirection, SyncDirection];
+    /**
+     * Resolution strategy used
+     */
+    resolution: 'last-write-wins' | 'user-choice' | 'merge';
+    /**
+     * Was conflict resolved
+     */
+    resolved: boolean;
+}
+export type StatusChangeCallback = (status: SyncStatus) => void;
+export declare class SyncStateManager {
+    private status;
+    private metrics;
+    private sessionStart;
+    private syncTimes;
+    private conflicts;
+    private callbacks;
+    /**
+     * Mark sync as started
+     */
+    startSync(direction: SyncDirection): void;
+    /**
+     * Mark sync as completed
+     */
+    completeSync(direction: SyncDirection, duration: number): void;
+    /**
+     * Mark sync as failed
+     */
+    failSync(error: string): void;
+    /**
+     * Record a conflict
+     */
+    recordConflict(sources: [SyncDirection, SyncDirection], resolution: ConflictInfo['resolution']): void;
+    /**
+     * Get current status
+     */
+    getStatus(): Readonly<SyncStatus>;
+    /**
+     * Get metrics
+     */
+    getMetrics(): Readonly<SyncMetrics>;
+    /**
+     * Get recent conflicts
+     */
+    getConflicts(limit?: number): ConflictInfo[];
+    /**
+     * Subscribe to status changes
+     */
+    onStatusChange(callback: StatusChangeCallback): () => void;
+    /**
+     * Notify callbacks
+     */
+    private notifyCallbacks;
+    /**
+     * Get sync message for direction
+     */
+    private getSyncMessage;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    /**
+     * Get formatted status for display
+     */
+    getFormattedStatus(): string;
+    /**
+     * Get status icon
+     */
+    private getStatusIcon;
+    /**
+     * Get metrics summary
+     */
+    getMetricsSummary(): string;
+}

package/src/libs/engine/src/dsl/sync/SyncStateManager.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Sync State Manager - Tracks sync state and provides UI feedback
+ *
+ * Manages synchronization state for UI components:
+ * - Sync status indicators
+ * - Error tracking
+ * - Performance metrics
+ * - Conflict detection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncStateManager = void 0;
+class SyncStateManager {
+    constructor() {
+        this.status = {
+            status: 'idle',
+            message: 'Ready',
+        };
+        this.metrics = {
+            totalSyncs: 0,
+            textToVisual: 0,
+            visualToText: 0,
+            errors: 0,
+            conflicts: 0,
+            averageSyncTime: 0,
+            sessionDuration: 0,
+        };
+        this.sessionStart = new Date();
+        this.syncTimes = [];
+        this.conflicts = [];
+        this.callbacks = [];
+    }
+    /**
+     * Mark sync as started
+     */
+    startSync(direction) {
+        this.status = {
+            status: 'syncing',
+            message: this.getSyncMessage(direction),
+            lastSync: this.status.lastSync,
+            lastSyncDuration: this.status.lastSyncDuration,
+        };
+        this.notifyCallbacks();
+    }
+    /**
+     * Mark sync as completed
+     */
+    completeSync(direction, duration) {
+        // Update metrics
+        this.metrics.totalSyncs++;
+        if (direction === 'text-to-visual') {
+            this.metrics.textToVisual++;
+        }
+        else if (direction === 'visual-to-text') {
+            this.metrics.visualToText++;
+        }
+        // Track sync time
+        this.syncTimes.push(duration);
+        if (this.syncTimes.length > 100) {
+            this.syncTimes.shift(); // Keep last 100
+        }
+        // Calculate average
+        this.metrics.averageSyncTime =
+            this.syncTimes.reduce((a, b) => a + b, 0) / this.syncTimes.length;
+        // Update session duration
+        this.metrics.sessionDuration = Date.now() - this.sessionStart.getTime();
+        // Update status
+        this.status = {
+            status: 'idle',
+            message: 'Synced',
+            lastSync: new Date(),
+            lastSyncDuration: duration,
+        };
+        this.notifyCallbacks();
+    }
+    /**
+     * Mark sync as failed
+     */
+    failSync(error) {
+        this.metrics.errors++;
+        this.status = {
+            status: 'error',
+            message: 'Sync failed',
+            error,
+            lastSync: this.status.lastSync,
+            lastSyncDuration: this.status.lastSyncDuration,
+        };
+        this.notifyCallbacks();
+    }
+    /**
+     * Record a conflict
+     */
+    recordConflict(sources, resolution) {
+        const conflict = {
+            timestamp: new Date(),
+            sources,
+            resolution,
+            resolved: true,
+        };
+        this.conflicts.push(conflict);
+        this.metrics.conflicts++;
+        this.status = {
+            status: 'conflict',
+            message: 'Conflict resolved',
+            lastSync: new Date(),
+        };
+        this.notifyCallbacks();
+        // Return to idle after brief display
+        setTimeout(() => {
+            if (this.status.status === 'conflict') {
+                this.status = {
+                    status: 'idle',
+                    message: 'Ready',
+                    lastSync: this.status.lastSync,
+                    lastSyncDuration: this.status.lastSyncDuration,
+                };
+                this.notifyCallbacks();
+            }
+        }, 2000);
+    }
+    /**
+     * Get current status
+     */
+    getStatus() {
+        return Object.assign({}, this.status);
+    }
+    /**
+     * Get metrics
+     */
+    getMetrics() {
+        return Object.assign({}, this.metrics);
+    }
+    /**
+     * Get recent conflicts
+     */
+    getConflicts(limit = 10) {
+        return this.conflicts.slice(-limit);
+    }
+    /**
+     * Subscribe to status changes
+     */
+    onStatusChange(callback) {
+        this.callbacks.push(callback);
+        // Return unsubscribe function
+        return () => {
+            const index = this.callbacks.indexOf(callback);
+            if (index > -1) {
+                this.callbacks.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Notify callbacks
+     */
+    notifyCallbacks() {
+        for (const callback of this.callbacks) {
+            try {
+                callback(this.status);
+            }
+            catch (error) {
+                console.error('[SyncStateManager] Callback error:', error);
+            }
+        }
+    }
+    /**
+     * Get sync message for direction
+     */
+    getSyncMessage(direction) {
+        switch (direction) {
+            case 'text-to-visual':
+                return 'Updating diagram...';
+            case 'visual-to-text':
+                return 'Updating text...';
+            default:
+                return 'Syncing...';
+        }
+    }
+    /**
+     * Reset metrics
+     */
+    resetMetrics() {
+        this.metrics = {
+            totalSyncs: 0,
+            textToVisual: 0,
+            visualToText: 0,
+            errors: 0,
+            conflicts: 0,
+            averageSyncTime: 0,
+            sessionDuration: 0,
+        };
+        this.sessionStart = new Date();
+        this.syncTimes = [];
+        this.conflicts = [];
+    }
+    /**
+     * Get formatted status for display
+     */
+    getFormattedStatus() {
+        const { status, message, lastSync, lastSyncDuration } = this.status;
+        let formatted = `${this.getStatusIcon(status)} ${message}`;
+        if (lastSync && status === 'idle') {
+            const ago = Date.now() - lastSync.getTime();
+            if (ago < 1000) {
+                formatted += ' (just now)';
+            }
+            else if (ago < 60000) {
+                formatted += ` (${Math.floor(ago / 1000)}s ago)`;
+            }
+            else {
+                formatted += ` (${Math.floor(ago / 60000)}m ago)`;
+            }
+        }
+        if (lastSyncDuration) {
+            formatted += ` • ${lastSyncDuration.toFixed(0)}ms`;
+        }
+        return formatted;
+    }
+    /**
+     * Get status icon
+     */
+    getStatusIcon(status) {
+        switch (status) {
+            case 'idle':
+                return '✓';
+            case 'syncing':
+                return '⟳';
+            case 'error':
+                return '✗';
+            case 'conflict':
+                return '⚠';
+            default:
+                return '•';
+        }
+    }
+    /**
+     * Get metrics summary
+     */
+    getMetricsSummary() {
+        const m = this.metrics;
+        const lines = [
+            `Total syncs: ${m.totalSyncs}`,
+            `Text → Visual: ${m.textToVisual}`,
+            `Visual → Text: ${m.visualToText}`,
+            `Errors: ${m.errors}`,
+            `Conflicts: ${m.conflicts}`,
+            `Avg sync time: ${m.averageSyncTime.toFixed(2)}ms`,
+            `Session: ${(m.sessionDuration / 1000).toFixed(0)}s`,
+        ];
+        return lines.join('\n');
+    }
+}
+exports.SyncStateManager = SyncStateManager;
+//# sourceMappingURL=SyncStateManager.js.map

package/src/libs/engine/src/dsl/sync/SyncStateManager.js.map

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