@monbolc/lowcode-plugin-command 2.0.0

package/es/index.js

@@ -0,0 +1,9 @@
+/**
+ * @monbolc/lowcode-plugin-command — barrel export
+ *
+ * Command pattern + undo/redo history + keyboard shortcuts.
+ * SapuLowcodeEngine L2.
+ */
+export { CommandManager } from './manager';
+export { parseShortcut, bindShortcuts, isMacOS, } from './shortcut';
+//# sourceMappingURL=index.js.map

package/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EACL,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,YAAY,CAAC"}

package/es/manager.js

@@ -0,0 +1,149 @@
+/**
+ * @monbolc/lowcode-plugin-command — CommandManager
+ *
+ * Stores registered commands in a Map, runs them on demand, and maintains
+ * an undo/redo history. Each history entry is `{ name, args, returnValue, command }`
+ * so we can replay or undo without re-fetching the command.
+ *
+ * The manager is the only stateful piece; commands themselves are stateless.
+ */
+import { Emitter } from '@monbolc/lowcode-utils';
+/** Maximum size of the undo stack. Older entries are dropped. */
+const DEFAULT_HISTORY_LIMIT = 200;
+export class CommandManager {
+    constructor(options = {}) {
+        this.events = new Emitter();
+        this.commands = new Map();
+        this.undoStack = [];
+        this.redoStack = [];
+        this.historyLimit = Math.max(0, options.historyLimit ?? DEFAULT_HISTORY_LIMIT);
+        this.autoMerge = options.autoMerge ?? true;
+    }
+    register(command) {
+        if (this.commands.has(command.name)) {
+            throw new Error(`[CommandManager] command "${command.name}" is already registered`);
+        }
+        this.commands.set(command.name, command);
+        this.events.emit('registered', { name: command.name });
+    }
+    unregister(name) {
+        const existed = this.commands.delete(name);
+        if (existed) {
+            this.events.emit('unregistered', { name });
+            // Also drop any in-flight history entries for that command.
+            this.pruneHistoryFor(name);
+        }
+        return existed;
+    }
+    has(name) {
+        return this.commands.has(name);
+    }
+    get(name) {
+        return this.commands.get(name);
+    }
+    list() {
+        return Array.from(this.commands.values());
+    }
+    async execute(name, args) {
+        const command = this.commands.get(name);
+        if (!command) {
+            throw new Error(`[CommandManager] no command registered as "${name}"`);
+        }
+        let returnValue;
+        try {
+            returnValue = await command.execute(args);
+        }
+        catch (err) {
+            // Do NOT push to history on failure. Re-throw so caller can react.
+            throw err;
+        }
+        this.recordHistory(name, args, returnValue, command);
+        this.events.emit('executed', { name, args, result: returnValue });
+        return returnValue;
+    }
+    async undo() {
+        const entry = this.undoStack.pop();
+        if (!entry)
+            return;
+        try {
+            if (entry.command.undo) {
+                await entry.command.undo(entry.args, entry.returnValue);
+            }
+            this.redoStack.push(entry);
+            this.events.emit('undone', { name: entry.name });
+        }
+        catch (err) {
+            // Restore the entry on failure so the user doesn't lose the chance to retry.
+            this.undoStack.push(entry);
+            throw err;
+        }
+    }
+    async redo() {
+        const entry = this.redoStack.pop();
+        if (!entry)
+            return;
+        try {
+            const returnValue = await entry.command.execute(entry.args);
+            // Replace the entry with a fresh one (new timestamp + return value).
+            this.undoStack.push({ ...entry, returnValue, lastTouchedAt: Date.now() });
+            this.events.emit('redone', { name: entry.name });
+        }
+        catch (err) {
+            this.redoStack.push(entry);
+            throw err;
+        }
+    }
+    canUndo() {
+        return this.undoStack.length > 0;
+    }
+    canRedo() {
+        return this.redoStack.length > 0;
+    }
+    undoStackSize() {
+        return this.undoStack.length;
+    }
+    redoStackSize() {
+        return this.redoStack.length;
+    }
+    clearHistory() {
+        this.undoStack.length = 0;
+        this.redoStack.length = 0;
+        this.events.emit('cleared', {});
+    }
+    // --- internals ---
+    recordHistory(name, args, returnValue, command) {
+        // Reset redo stack on any new execute (standard undo/redo semantics).
+        if (this.redoStack.length > 0)
+            this.redoStack.length = 0;
+        if (this.autoMerge && command.mergeable) {
+            const top = this.undoStack[this.undoStack.length - 1];
+            const mergeWindow = command.mergeWindowMs ?? 500;
+            const now = Date.now();
+            if (top &&
+                top.name === name &&
+                now - top.lastTouchedAt <= mergeWindow) {
+                top.args = args;
+                top.returnValue = returnValue;
+                top.lastTouchedAt = now;
+                return;
+            }
+        }
+        this.undoStack.push({
+            name,
+            args,
+            returnValue,
+            command,
+            lastTouchedAt: Date.now(),
+        });
+        // Trim oldest if over the limit.
+        while (this.undoStack.length > this.historyLimit) {
+            this.undoStack.shift();
+        }
+    }
+    pruneHistoryFor(name) {
+        const filter = (entry) => entry.name !== name;
+        this.undoStack.splice(0, this.undoStack.length, ...this.undoStack.filter(filter));
+        this.redoStack.splice(0, this.redoStack.length, ...this.redoStack.filter(filter));
+    }
+}
+//# sourceMappingURL=manager.js.map

package/es/manager.js.map

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

package/es/shortcut.js

@@ -0,0 +1,119 @@
+/**
+ * @monbolc/lowcode-plugin-command — keyboard shortcut binding
+ *
+ * Parses shortcut strings like `"Mod+Z"` / `"Ctrl+Shift+P"` and binds them
+ * to a command manager so users can undo/redo with the keyboard.
+ *
+ * "Mod" maps to Cmd on macOS and Ctrl elsewhere — the conventional behavior
+ * in editor apps (VSCode, Figma, etc.).
+ */
+const MODIFIER_KEYS = new Set([
+    'Mod',
+    'Ctrl',
+    'Meta',
+    'Shift',
+    'Alt',
+]);
+export function isMacOS() {
+    if (typeof navigator === 'undefined')
+        return false;
+    const platform = navigator.userAgentData?.platform ??
+        navigator.platform ??
+        '';
+    return /mac|iphone|ipad|ipod/i.test(platform);
+}
+/**
+ * Parse a shortcut string. Examples:
+ *   "Mod+Z"     -> { modifiers: {Mod}, key: "z" }
+ *   "Ctrl+Shift+P" -> { modifiers: {Ctrl, Shift}, key: "p" }
+ */
+export function parseShortcut(input) {
+    if (!input || typeof input !== 'string') {
+        throw new Error(`[shortcut] invalid shortcut: ${String(input)}`);
+    }
+    const parts = input
+        .split('+')
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (parts.length < 2) {
+        throw new Error(`[shortcut] shortcut must include at least one modifier + a key, got: "${input}"`);
+    }
+    const key = parts[parts.length - 1].toLowerCase();
+    const modifiers = new Set();
+    for (const p of parts.slice(0, -1)) {
+        const token = p;
+        if (!MODIFIER_KEYS.has(token)) {
+            throw new Error(`[shortcut] unknown modifier "${p}" in "${input}"`);
+        }
+        modifiers.add(token);
+    }
+    return { raw: input, modifiers, key };
+}
+function eventModifiersPressed(e) {
+    const set = new Set();
+    const mod = isMacOS() ? 'Meta' : 'Ctrl';
+    if (e.getModifierState(mod))
+        set.add('Mod');
+    if (e.shiftKey)
+        set.add('Shift');
+    if (e.altKey)
+        set.add('Alt');
+    // Direct Meta key on macOS is already counted as Mod; on non-mac the Meta key
+    // (Windows key) is intentionally ignored.
+    return set;
+}
+function sameModifiers(a, b) {
+    if (a.size !== b.size)
+        return false;
+    for (const m of a)
+        if (!b.has(m))
+            return false;
+    return true;
+}
+/**
+ * Walk all registered commands, find any with a `shortcut` field, and wire them
+ * up to a global keydown listener on the chosen target.
+ */
+export function bindShortcuts(manager, options = {}) {
+    if (typeof window === 'undefined') {
+        return { dispose: () => undefined, bindings: () => [] };
+    }
+    const target = options.target ?? window;
+    const preventDefault = options.preventDefault ?? true;
+    const parsed = [];
+    for (const cmd of manager.list()) {
+        const shortcuts = [].concat(cmd.shortcut ?? []);
+        for (const s of shortcuts) {
+            try {
+                parsed.push({ command: cmd, shortcut: parseShortcut(s) });
+            }
+            catch {
+                // Skip malformed shortcuts silently — they shouldn't break the binder.
+            }
+        }
+    }
+    const handler = (e) => {
+        const ke = e;
+        const pressed = eventModifiersPressed(ke);
+        const key = ke.key.toLowerCase();
+        for (const { command, shortcut } of parsed) {
+            if (shortcut.key === key && sameModifiers(pressed, shortcut.modifiers)) {
+                if (preventDefault)
+                    ke.preventDefault();
+                // Fire-and-forget; errors land in console.
+                void manager.execute(command.name).catch((err) => {
+                    if (typeof console !== 'undefined' && console.error) {
+                        console.error(`[shortcut] "${command.name}" failed:`, err);
+                    }
+                });
+                return;
+            }
+        }
+    };
+    target.addEventListener('keydown', handler);
+    return {
+        dispose: () => target.removeEventListener('keydown', handler),
+        bindings: () => parsed.map((p) => p.command),
+    };
+}
+//# sourceMappingURL=shortcut.js.map

package/es/shortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut.js","sourceRoot":"","sources":["../src/shortcut.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,aAAa,GAA+B,IAAI,GAAG,CAAC;IACxD,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAWH,MAAM,UAAU,OAAO;IACrB,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,QAAQ,GACX,SAAuD,CAAC,aAAa,EAAE,QAAQ;QAChF,SAAS,CAAC,QAAQ;QAClB,EAAE,CAAC;IACL,OAAO,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,yEAAyE,KAAK,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,CAAkB,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,qBAAqB,CAAC,CAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiB,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,QAAQ;QAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,0CAA0C;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,CAA6B,EAAE,CAA6B;IACjF,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAmBD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAwB,EACxB,UAAiC,EAAE;IAEnC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IAEtD,MAAM,MAAM,GAA2D,EAAE,CAAC;IAC1E,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,SAAS,GAAI,EAAe,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,CAAkB,CAAC;QAC9B,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACjC,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;YAC3C,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvE,IAAI,cAAc;oBAAE,EAAE,CAAC,cAAc,EAAE,CAAC;gBACxC,2CAA2C;gBAC3C,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC/C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;wBACpD,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,IAAI,WAAW,EAAE,GAAG,CAAC,CAAC;oBAC7D,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAwB,CAAC,CAAC;IAC7D,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAwB,CAAC;QAC9E,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/es/types.js

@@ -0,0 +1,9 @@
+/**
+ * @monbolc/lowcode-plugin-command — public types
+ *
+ * The command pattern lets plugins expose "actions" that the user can invoke
+ * by name (from the menu, a button, or a keyboard shortcut). Each command
+ * knows how to do its work, and — if reversible — how to undo it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/es/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @monbolc/lowcode-plugin-command — barrel export
+ *
+ * Command pattern + undo/redo history + keyboard shortcuts.
+ * SapuLowcodeEngine L2.
+ */
+export type { CommandArgs, CommandResult, CommandManagerEvents, ICommand, ICommandManager, } from './types';
+export { CommandManager } from './manager';
+export type { CommandManagerOptions } from './manager';
+export { parseShortcut, bindShortcuts, isMacOS, } from './shortcut';
+export type { ParsedShortcut, ShortcutBinder, ShortcutBinderOptions, ShortcutToken, } from './shortcut';

package/lib/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * @monbolc/lowcode-plugin-command — barrel export
+ *
+ * Command pattern + undo/redo history + keyboard shortcuts.
+ * SapuLowcodeEngine L2.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMacOS = exports.bindShortcuts = exports.parseShortcut = exports.CommandManager = void 0;
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "CommandManager", { enumerable: true, get: function () { return manager_1.CommandManager; } });
+var shortcut_1 = require("./shortcut");
+Object.defineProperty(exports, "parseShortcut", { enumerable: true, get: function () { return shortcut_1.parseShortcut; } });
+Object.defineProperty(exports, "bindShortcuts", { enumerable: true, get: function () { return shortcut_1.bindShortcuts; } });
+Object.defineProperty(exports, "isMacOS", { enumerable: true, get: function () { return shortcut_1.isMacOS; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAUH,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAGvB,uCAIoB;AAHlB,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AACb,mGAAA,OAAO,OAAA"}

package/lib/manager.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @monbolc/lowcode-plugin-command — CommandManager
+ *
+ * Stores registered commands in a Map, runs them on demand, and maintains
+ * an undo/redo history. Each history entry is `{ name, args, returnValue, command }`
+ * so we can replay or undo without re-fetching the command.
+ *
+ * The manager is the only stateful piece; commands themselves are stateless.
+ */
+import { Emitter } from '@monbolc/lowcode-utils';
+import type { CommandManagerEvents, CommandArgs, CommandResult, ICommand, ICommandManager } from './types';
+export interface CommandManagerOptions {
+    /** Max undo-stack depth. Defaults to 200. */
+    historyLimit?: number;
+    /**
+     * If true, two consecutive execute() calls of the same `mergeable` command
+     * within `mergeWindowMs` are collapsed into one history entry. Defaults to true.
+     */
+    autoMerge?: boolean;
+}
+export declare class CommandManager implements ICommandManager {
+    readonly events: Emitter<CommandManagerEvents>;
+    private readonly commands;
+    private readonly undoStack;
+    private readonly redoStack;
+    private readonly historyLimit;
+    private readonly autoMerge;
+    constructor(options?: CommandManagerOptions);
+    register<TArgs = CommandArgs, TReturn = CommandResult>(command: ICommand<TArgs, TReturn>): void;
+    unregister(name: string): boolean;
+    has(name: string): boolean;
+    get(name: string): ICommand | undefined;
+    list(): ICommand[];
+    execute<TArgs = CommandArgs, TReturn = CommandResult>(name: string, args?: TArgs): Promise<TReturn | undefined>;
+    undo(): Promise<void>;
+    redo(): Promise<void>;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    undoStackSize(): number;
+    redoStackSize(): number;
+    clearHistory(): void;
+    private recordHistory;
+    private pruneHistoryFor;
+}

package/lib/manager.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * @monbolc/lowcode-plugin-command — CommandManager
+ *
+ * Stores registered commands in a Map, runs them on demand, and maintains
+ * an undo/redo history. Each history entry is `{ name, args, returnValue, command }`
+ * so we can replay or undo without re-fetching the command.
+ *
+ * The manager is the only stateful piece; commands themselves are stateless.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandManager = void 0;
+const lowcode_utils_1 = require("@monbolc/lowcode-utils");
+/** Maximum size of the undo stack. Older entries are dropped. */
+const DEFAULT_HISTORY_LIMIT = 200;
+class CommandManager {
+    constructor(options = {}) {
+        this.events = new lowcode_utils_1.Emitter();
+        this.commands = new Map();
+        this.undoStack = [];
+        this.redoStack = [];
+        this.historyLimit = Math.max(0, options.historyLimit ?? DEFAULT_HISTORY_LIMIT);
+        this.autoMerge = options.autoMerge ?? true;
+    }
+    register(command) {
+        if (this.commands.has(command.name)) {
+            throw new Error(`[CommandManager] command "${command.name}" is already registered`);
+        }
+        this.commands.set(command.name, command);
+        this.events.emit('registered', { name: command.name });
+    }
+    unregister(name) {
+        const existed = this.commands.delete(name);
+        if (existed) {
+            this.events.emit('unregistered', { name });
+            // Also drop any in-flight history entries for that command.
+            this.pruneHistoryFor(name);
+        }
+        return existed;
+    }
+    has(name) {
+        return this.commands.has(name);
+    }
+    get(name) {
+        return this.commands.get(name);
+    }
+    list() {
+        return Array.from(this.commands.values());
+    }
+    async execute(name, args) {
+        const command = this.commands.get(name);
+        if (!command) {
+            throw new Error(`[CommandManager] no command registered as "${name}"`);
+        }
+        let returnValue;
+        try {
+            returnValue = await command.execute(args);
+        }
+        catch (err) {
+            // Do NOT push to history on failure. Re-throw so caller can react.
+            throw err;
+        }
+        this.recordHistory(name, args, returnValue, command);
+        this.events.emit('executed', { name, args, result: returnValue });
+        return returnValue;
+    }
+    async undo() {
+        const entry = this.undoStack.pop();
+        if (!entry)
+            return;
+        try {
+            if (entry.command.undo) {
+                await entry.command.undo(entry.args, entry.returnValue);
+            }
+            this.redoStack.push(entry);
+            this.events.emit('undone', { name: entry.name });
+        }
+        catch (err) {
+            // Restore the entry on failure so the user doesn't lose the chance to retry.
+            this.undoStack.push(entry);
+            throw err;
+        }
+    }
+    async redo() {
+        const entry = this.redoStack.pop();
+        if (!entry)
+            return;
+        try {
+            const returnValue = await entry.command.execute(entry.args);
+            // Replace the entry with a fresh one (new timestamp + return value).
+            this.undoStack.push({ ...entry, returnValue, lastTouchedAt: Date.now() });
+            this.events.emit('redone', { name: entry.name });
+        }
+        catch (err) {
+            this.redoStack.push(entry);
+            throw err;
+        }
+    }
+    canUndo() {
+        return this.undoStack.length > 0;
+    }
+    canRedo() {
+        return this.redoStack.length > 0;
+    }
+    undoStackSize() {
+        return this.undoStack.length;
+    }
+    redoStackSize() {
+        return this.redoStack.length;
+    }
+    clearHistory() {
+        this.undoStack.length = 0;
+        this.redoStack.length = 0;
+        this.events.emit('cleared', {});
+    }
+    // --- internals ---
+    recordHistory(name, args, returnValue, command) {
+        // Reset redo stack on any new execute (standard undo/redo semantics).
+        if (this.redoStack.length > 0)
+            this.redoStack.length = 0;
+        if (this.autoMerge && command.mergeable) {
+            const top = this.undoStack[this.undoStack.length - 1];
+            const mergeWindow = command.mergeWindowMs ?? 500;
+            const now = Date.now();
+            if (top &&
+                top.name === name &&
+                now - top.lastTouchedAt <= mergeWindow) {
+                top.args = args;
+                top.returnValue = returnValue;
+                top.lastTouchedAt = now;
+                return;
+            }
+        }
+        this.undoStack.push({
+            name,
+            args,
+            returnValue,
+            command,
+            lastTouchedAt: Date.now(),
+        });
+        // Trim oldest if over the limit.
+        while (this.undoStack.length > this.historyLimit) {
+            this.undoStack.shift();
+        }
+    }
+    pruneHistoryFor(name) {
+        const filter = (entry) => entry.name !== name;
+        this.undoStack.splice(0, this.undoStack.length, ...this.undoStack.filter(filter));
+        this.redoStack.splice(0, this.redoStack.length, ...this.redoStack.filter(filter));
+    }
+}
+exports.CommandManager = CommandManager;
+//# sourceMappingURL=manager.js.map

package/lib/manager.js.map

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

package/lib/shortcut.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @monbolc/lowcode-plugin-command — keyboard shortcut binding
+ *
+ * Parses shortcut strings like `"Mod+Z"` / `"Ctrl+Shift+P"` and binds them
+ * to a command manager so users can undo/redo with the keyboard.
+ *
+ * "Mod" maps to Cmd on macOS and Ctrl elsewhere — the conventional behavior
+ * in editor apps (VSCode, Figma, etc.).
+ */
+import type { ICommand } from './types';
+import type { ICommandManager } from './types';
+export type ShortcutToken = 'Mod' | 'Ctrl' | 'Meta' | 'Shift' | 'Alt';
+export interface ParsedShortcut {
+    /** Original input, normalized. */
+    raw: string;
+    /** Required modifier keys. */
+    modifiers: ReadonlySet<ShortcutToken>;
+    /** Lower-cased key code, e.g. "z", "p", "escape". */
+    key: string;
+}
+export declare function isMacOS(): boolean;
+/**
+ * Parse a shortcut string. Examples:
+ *   "Mod+Z"     -> { modifiers: {Mod}, key: "z" }
+ *   "Ctrl+Shift+P" -> { modifiers: {Ctrl, Shift}, key: "p" }
+ */
+export declare function parseShortcut(input: string): ParsedShortcut;
+export interface ShortcutBinderOptions {
+    /**
+     * The keyboard event target. Defaults to `window` when running in a browser.
+     * Pass a different HTMLElement for scoped bindings (e.g. inside a Shadow DOM).
+     */
+    target?: EventTarget;
+    /** If true (default), `preventDefault()` is called on a matched shortcut. */
+    preventDefault?: boolean;
+}
+export interface ShortcutBinder {
+    /** Stop listening and release references. */
+    dispose(): void;
+    /** Currently bound commands (snapshot). */
+    bindings(): ICommand[];
+}
+/**
+ * Walk all registered commands, find any with a `shortcut` field, and wire them
+ * up to a global keydown listener on the chosen target.
+ */
+export declare function bindShortcuts(manager: ICommandManager, options?: ShortcutBinderOptions): ShortcutBinder;

package/lib/shortcut.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * @monbolc/lowcode-plugin-command — keyboard shortcut binding
+ *
+ * Parses shortcut strings like `"Mod+Z"` / `"Ctrl+Shift+P"` and binds them
+ * to a command manager so users can undo/redo with the keyboard.
+ *
+ * "Mod" maps to Cmd on macOS and Ctrl elsewhere — the conventional behavior
+ * in editor apps (VSCode, Figma, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMacOS = isMacOS;
+exports.parseShortcut = parseShortcut;
+exports.bindShortcuts = bindShortcuts;
+const MODIFIER_KEYS = new Set([
+    'Mod',
+    'Ctrl',
+    'Meta',
+    'Shift',
+    'Alt',
+]);
+function isMacOS() {
+    if (typeof navigator === 'undefined')
+        return false;
+    const platform = navigator.userAgentData?.platform ??
+        navigator.platform ??
+        '';
+    return /mac|iphone|ipad|ipod/i.test(platform);
+}
+/**
+ * Parse a shortcut string. Examples:
+ *   "Mod+Z"     -> { modifiers: {Mod}, key: "z" }
+ *   "Ctrl+Shift+P" -> { modifiers: {Ctrl, Shift}, key: "p" }
+ */
+function parseShortcut(input) {
+    if (!input || typeof input !== 'string') {
+        throw new Error(`[shortcut] invalid shortcut: ${String(input)}`);
+    }
+    const parts = input
+        .split('+')
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (parts.length < 2) {
+        throw new Error(`[shortcut] shortcut must include at least one modifier + a key, got: "${input}"`);
+    }
+    const key = parts[parts.length - 1].toLowerCase();
+    const modifiers = new Set();
+    for (const p of parts.slice(0, -1)) {
+        const token = p;
+        if (!MODIFIER_KEYS.has(token)) {
+            throw new Error(`[shortcut] unknown modifier "${p}" in "${input}"`);
+        }
+        modifiers.add(token);
+    }
+    return { raw: input, modifiers, key };
+}
+function eventModifiersPressed(e) {
+    const set = new Set();
+    const mod = isMacOS() ? 'Meta' : 'Ctrl';
+    if (e.getModifierState(mod))
+        set.add('Mod');
+    if (e.shiftKey)
+        set.add('Shift');
+    if (e.altKey)
+        set.add('Alt');
+    // Direct Meta key on macOS is already counted as Mod; on non-mac the Meta key
+    // (Windows key) is intentionally ignored.
+    return set;
+}
+function sameModifiers(a, b) {
+    if (a.size !== b.size)
+        return false;
+    for (const m of a)
+        if (!b.has(m))
+            return false;
+    return true;
+}
+/**
+ * Walk all registered commands, find any with a `shortcut` field, and wire them
+ * up to a global keydown listener on the chosen target.
+ */
+function bindShortcuts(manager, options = {}) {
+    if (typeof window === 'undefined') {
+        return { dispose: () => undefined, bindings: () => [] };
+    }
+    const target = options.target ?? window;
+    const preventDefault = options.preventDefault ?? true;
+    const parsed = [];
+    for (const cmd of manager.list()) {
+        const shortcuts = [].concat(cmd.shortcut ?? []);
+        for (const s of shortcuts) {
+            try {
+                parsed.push({ command: cmd, shortcut: parseShortcut(s) });
+            }
+            catch {
+                // Skip malformed shortcuts silently — they shouldn't break the binder.
+            }
+        }
+    }
+    const handler = (e) => {
+        const ke = e;
+        const pressed = eventModifiersPressed(ke);
+        const key = ke.key.toLowerCase();
+        for (const { command, shortcut } of parsed) {
+            if (shortcut.key === key && sameModifiers(pressed, shortcut.modifiers)) {
+                if (preventDefault)
+                    ke.preventDefault();
+                // Fire-and-forget; errors land in console.
+                void manager.execute(command.name).catch((err) => {
+                    if (typeof console !== 'undefined' && console.error) {
+                        console.error(`[shortcut] "${command.name}" failed:`, err);
+                    }
+                });
+                return;
+            }
+        }
+    };
+    target.addEventListener('keydown', handler);
+    return {
+        dispose: () => target.removeEventListener('keydown', handler),
+        bindings: () => parsed.map((p) => p.command),
+    };
+}
+//# sourceMappingURL=shortcut.js.map

package/lib/shortcut.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @monbolc/lowcode-plugin-command — public types
+ *
+ * The command pattern lets plugins expose "actions" that the user can invoke
+ * by name (from the menu, a button, or a keyboard shortcut). Each command
+ * knows how to do its work, and — if reversible — how to undo it.
+ */
+import type { Emitter } from '@monbolc/lowcode-utils';
+/** Anything a command can receive when invoked. */
+export type CommandArgs = unknown;
+/** What a command returns after a successful execute. */
+export type CommandResult = void | CommandArgs | Promise<void | CommandArgs>;
+/** A single command. Stateless; all per-instance state lives in the manager. */
+export interface ICommand<TArgs = CommandArgs, TReturn = CommandResult> {
+    /** Globally unique name within a CommandManager (e.g. `"designer.duplicate"`). */
+    readonly name: string;
+    /** Human-readable label, for menus / tooltips. */
+    readonly label?: string;
+    /** Optional grouping key (e.g. `"file"`, `"edit"`). */
+    readonly group?: string;
+    /** Optional keyboard binding (e.g. `"Mod+Z"`, `"Ctrl+Shift+P"`). */
+    readonly shortcut?: string | string[];
+    /** Run the command. If it throws, the manager will not push to history. */
+    execute(args?: TArgs): TReturn;
+    /** Undo a previous execute. If absent, the command is not reversible. */
+    undo?(args?: TArgs, returnValue?: TReturn): TReturn | Promise<TReturn>;
+    /**
+     * Merge with the previous command of the same name if both
+     * `mergeable` and the time delta is below `mergeWindowMs`.
+     * Useful for drag-resize, text typing, etc.
+     */
+    readonly mergeable?: boolean;
+    readonly mergeWindowMs?: number;
+}
+/** Events emitted by CommandManager. */
+export interface CommandManagerEvents extends Record<string, unknown> {
+    /** A command was registered. Payload: the command's name. */
+    registered: {
+        name: string;
+    };
+    /** A command was unregistered. */
+    unregistered: {
+        name: string;
+    };
+    /** A command finished executing. */
+    executed: {
+        name: string;
+        args: unknown;
+        result: unknown;
+    };
+    /** The manager undid the most recent command. */
+    undone: {
+        name: string;
+    };
+    /** The manager redid a previously undone command. */
+    redone: {
+        name: string;
+    };
+    /** History stack was cleared (e.g. on document reset). */
+    cleared: Record<string, never>;
+}
+export interface ICommandManager {
+    /** Underlying event bus. Subscribe to `CommandManagerEvents`. */
+    readonly events: Emitter<CommandManagerEvents>;
+    /** Register a command. Throws if `name` is already taken. */
+    register<TArgs = CommandArgs, TReturn = CommandResult>(command: ICommand<TArgs, TReturn>): void;
+    /** Unregister a command by name. */
+    unregister(name: string): boolean;
+    /** True if a command with this name is registered. */
+    has(name: string): boolean;
+    /** Get a registered command by name, or undefined. */
+    get(name: string): ICommand | undefined;
+    /** All registered commands (snapshot). */
+    list(): ICommand[];
+    /** Execute a command by name. */
+    execute<TArgs = CommandArgs, TReturn = CommandResult>(name: string, args?: TArgs): Promise<TReturn | undefined>;
+    /** Undo the most recent reversible command. No-op if stack is empty. */
+    undo(): Promise<void>;
+    /** Redo the most recent undone command. No-op if redo stack is empty. */
+    redo(): Promise<void>;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    /** Number of commands in the undo stack. */
+    undoStackSize(): number;
+    /** Number of commands in the redo stack. */
+    redoStackSize(): number;
+    /** Clear both stacks (e.g. on document reset). */
+    clearHistory(): void;
+}

package/lib/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @monbolc/lowcode-plugin-command — public types
+ *
+ * The command pattern lets plugins expose "actions" that the user can invoke
+ * by name (from the menu, a button, or a keyboard shortcut). Each command
+ * knows how to do its work, and — if reversible — how to undo it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@monbolc/lowcode-plugin-command",
+  "version": "2.0.0",
+  "description": "Command pattern + undo/redo history for SapuLowcodeEngine (L2)",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "module": "es/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.js"
+    }
+  },
+  "files": ["lib", "es"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:es": "tsc -p tsconfig.esm.json",
+    "clean": "rimraf lib es"
+  },
+  "dependencies": {
+    "@monbolc/lowcode-types": "^2.0.0",
+    "@monbolc/lowcode-utils": "^2.0.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "typescript": "^5.4.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:monbolc/sapu-lowcode-engine.git",
+    "directory": "packages/plugin-command"
+  },
+  "keywords": ["lowcode", "engine", "command", "undo", "redo"]
+}