@pixerate/editor-svelte 0.20.0 → 0.22.0

package/dist/commands/commandShortcuts.svelte.d.ts

@@ -0,0 +1,30 @@
+import type { CommandRegistry, CommandResult, CommandSpec } from "@pixerate/editor/commands";
+type MaybeGetter<T> = T | (() => T);
+export interface CommandShortcutsOptions<TContext = any> {
+    /** Element or window to listen on (default: `window`). */
+    target?: Window | HTMLElement | null;
+    /** Active scopes, most specific first; a getter is read on every keydown. */
+    scopes?: MaybeGetter<string | readonly string[] | undefined>;
+    /** Context for the commands (default: the registry's); a getter is read on every keydown. */
+    context?: MaybeGetter<TContext | undefined>;
+    /** Fire even while typing in inputs / contenteditable (default: per binding). */
+    allowInEditable?: boolean;
+    /** Called after a shortcut ran a command. */
+    onRun?: (result: CommandResult) => void;
+}
+/**
+ * Runs the registry's commands from their keyboard shortcuts (`registry.handleKeyDown`).
+ * Typing in inputs and editors is never hijacked, and disabled commands leave the event
+ * alone. Returns `{ destroy }`.
+ */
+export declare function createCommandShortcuts<TContext = any>(registry: CommandRegistry<TContext>, options?: CommandShortcutsOptions<TContext>): {
+    destroy: () => void;
+};
+/**
+ * Registers commands for the lifetime of the calling component (call it during
+ * component initialisation). Pass a getter to react to changes: when it returns a
+ * different array, the old commands are unregistered.
+ */
+export declare function useRegisterCommands<TContext = any>(registry: MaybeGetter<CommandRegistry<TContext> | null | undefined>, specs: MaybeGetter<readonly CommandSpec<TContext>[] | null | undefined>): void;
+export {};
+//# sourceMappingURL=commandShortcuts.svelte.d.ts.map

package/dist/commands/commandShortcuts.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandShortcuts.svelte.d.ts","sourceRoot":"","sources":["../../src/commands/commandShortcuts.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7F,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAKpC,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,GAAG;IACrD,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAC7D,6FAA6F;IAC7F,OAAO,CAAC,EAAE,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC5C,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,GAAG,GAAG,EACnD,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EACnC,OAAO,GAAE,uBAAuB,CAAC,QAAQ,CAAM,GAC9C;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAczB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,GAAG,EAChD,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EACnE,KAAK,EAAE,WAAW,CAAC,SAAS,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACtE,IAAI,CAON"}

package/dist/commands/commandShortcuts.svelte.js

@@ -0,0 +1,37 @@
+const read = (value) => typeof value === "function" ? value() : value;
+/**
+ * Runs the registry's commands from their keyboard shortcuts (`registry.handleKeyDown`).
+ * Typing in inputs and editors is never hijacked, and disabled commands leave the event
+ * alone. Returns `{ destroy }`.
+ */
+export function createCommandShortcuts(registry, options = {}) {
+    const target = options.target ?? (typeof window !== "undefined" ? window : null);
+    if (!target)
+        return { destroy: () => { } };
+    const onKeyDown = (event) => {
+        const context = options.context === undefined ? undefined : read(options.context);
+        const result = registry.handleKeyDown(event, {
+            scopes: options.scopes === undefined ? undefined : read(options.scopes),
+            ...(options.allowInEditable !== undefined ? { allowInEditable: options.allowInEditable } : {}),
+            ...(context !== undefined ? { context } : {}),
+        });
+        if (result)
+            options.onRun?.(result);
+    };
+    target.addEventListener("keydown", onKeyDown);
+    return { destroy: () => target.removeEventListener("keydown", onKeyDown) };
+}
+/**
+ * Registers commands for the lifetime of the calling component (call it during
+ * component initialisation). Pass a getter to react to changes: when it returns a
+ * different array, the old commands are unregistered.
+ */
+export function useRegisterCommands(registry, specs) {
+    $effect(() => {
+        const currentRegistry = read(registry);
+        const currentSpecs = read(specs);
+        if (!currentRegistry || !currentSpecs || currentSpecs.length === 0)
+            return;
+        return currentRegistry.register(currentSpecs);
+    });
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentProps } from "svelte";
+import type CommandPaletteComponent from "./CommandPalette.svelte";
+export { default as CommandPalette } from "./CommandPalette.svelte";
+export * from "./palette.svelte.js";
+export * from "./commandShortcuts.svelte.js";
+export type CommandPaletteProps = ComponentProps<typeof CommandPaletteComponent>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,uBAAuB,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,3 @@
+export { default as CommandPalette } from "./CommandPalette.svelte";
+export * from "./palette.svelte.js";
+export * from "./commandShortcuts.svelte.js";

package/dist/commands/palette.svelte.d.ts

@@ -0,0 +1,34 @@
+import { type CommandPaletteController, type CommandPaletteItem, type CommandPaletteOptions, type CommandRegistry, type CommandResult } from "@pixerate/editor/commands";
+export interface CreateCommandPaletteOptions<TContext = any> extends CommandPaletteOptions<TContext> {
+    /** Chord that toggles the palette from anywhere, also while typing (e.g. `Mod+K`). */
+    hotkey?: string;
+    /** Element or window the hotkey listens on (default: `window`). */
+    hotkeyTarget?: Window | HTMLElement | null;
+}
+export interface SvelteCommandPalette {
+    readonly open: boolean;
+    readonly query: string;
+    readonly activeIndex: number;
+    readonly items: CommandPaletteItem[];
+    readonly recents: string[];
+    readonly lastResult: CommandResult | null;
+    readonly controller: CommandPaletteController;
+    setOpen(open: boolean): void;
+    toggle(): void;
+    setQuery(query: string): void;
+    setActiveIndex(index: number): void;
+    move(delta: number): void;
+    run(id: string): CommandResult | null;
+    runActive(): CommandResult | null;
+    handleKeyDown(event: KeyboardEvent): boolean;
+    /** Stops following the registry and removes the hotkey listener. */
+    destroy(): void;
+}
+/**
+ * Reactive command palette state over a `CommandRegistry` (Svelte 5 runes): ranked rows
+ * with shortcuts and disabled reasons, active row and recents. Render it with
+ * `<CommandPalette palette={…} />` or your own markup. Call `destroy()` when done
+ * (e.g. in `onDestroy`).
+ */
+export declare function createCommandPalette<TContext = any>(registry: CommandRegistry<TContext>, options?: CreateCommandPaletteOptions<TContext>): SvelteCommandPalette;
+//# sourceMappingURL=palette.svelte.d.ts.map

package/dist/commands/palette.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.svelte.d.ts","sourceRoot":"","sources":["../../src/commands/palette.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE1B,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,2BAA2B,CAAC,QAAQ,GAAG,GAAG,CAAE,SAAQ,qBAAqB,CAAC,QAAQ,CAAC;IAClG,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IACtC,SAAS,IAAI,aAAa,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAC7C,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAG,GAAG,EACjD,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EACnC,OAAO,GAAE,2BAA2B,CAAC,QAAQ,CAAM,GAClD,oBAAoB,CAsDtB"}

package/dist/commands/palette.svelte.js

@@ -0,0 +1,61 @@
+import { createCommandPaletteController, matchPaletteHotkey, } from "@pixerate/editor/commands";
+/**
+ * Reactive command palette state over a `CommandRegistry` (Svelte 5 runes): ranked rows
+ * with shortcuts and disabled reasons, active row and recents. Render it with
+ * `<CommandPalette palette={…} />` or your own markup. Call `destroy()` when done
+ * (e.g. in `onDestroy`).
+ */
+export function createCommandPalette(registry, options = {}) {
+    const controller = createCommandPaletteController(registry, options);
+    let state = $state.raw(controller.getState());
+    const unsubscribe = controller.subscribe((next) => {
+        state = next;
+    });
+    let removeHotkey = () => { };
+    const { hotkey } = options;
+    const target = options.hotkeyTarget ?? (typeof window !== "undefined" ? window : null);
+    if (hotkey && target) {
+        const onKeyDown = (event) => {
+            const e = event;
+            if (e.defaultPrevented || !matchPaletteHotkey(e, hotkey, options.platform))
+                return;
+            e.preventDefault();
+            controller.toggle();
+        };
+        target.addEventListener("keydown", onKeyDown);
+        removeHotkey = () => target.removeEventListener("keydown", onKeyDown);
+    }
+    return {
+        get open() {
+            return state.open;
+        },
+        get query() {
+            return state.query;
+        },
+        get activeIndex() {
+            return state.activeIndex;
+        },
+        get items() {
+            return state.items;
+        },
+        get recents() {
+            return state.recents;
+        },
+        get lastResult() {
+            return state.lastResult;
+        },
+        controller,
+        setOpen: controller.setOpen,
+        toggle: controller.toggle,
+        setQuery: controller.setQuery,
+        setActiveIndex: controller.setActiveIndex,
+        move: controller.move,
+        run: controller.run,
+        runActive: controller.runActive,
+        handleKeyDown: controller.handleKeyDown,
+        destroy() {
+            unsubscribe();
+            removeHotkey();
+        },
+    };
+}

package/dist/history/createHistoryShortcuts.d.ts

@@ -1,4 +1,4 @@
-import { HistoryManager } from "@pixerate/editor/history";
+import type { HistoryManager } from "@pixerate/editor/history";
 export interface HistoryShortcutsOptions {
     /**
      * Whether keyboard shortcuts are enabled. Defaults to true.

package/dist/history/createHistoryShortcuts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createHistoryShortcuts.d.ts","sourceRoot":"","sources":["../../src/history/createHistoryShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,uBAA4B,GACpC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAqEzB"}
+{"version":3,"file":"createHistoryShortcuts.d.ts","sourceRoot":"","sources":["../../src/history/createHistoryShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,uBAA4B,GACpC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAqCzB"}

package/dist/history/createHistoryShortcuts.js

@@ -1,3 +1,4 @@
+import { matchHistoryShortcut } from "@pixerate/editor/commands";
 /**
  * Attaches keyboard listeners for Undo (Mod+Z) and Redo (Mod+Shift+Z / Mod+Y).
  * Returns an object with a `destroy()` function for lifecycle cleanup.
@@ -13,39 +14,16 @@ export function createHistoryShortcuts(manager, options = {}) {
     }
     const handleKeyDown = (event) => {
         const e = event;
-        const isMac = typeof navigator !== "undefined" &&
-            /Mac|iPod|iPhone|iPad/.test(navigator.platform || navigator.userAgent);
-        const modifier = isMac ? e.metaKey : e.ctrlKey;
-        if (!modifier)
-            return;
-        if (ignoreEditableElements && typeof document !== "undefined") {
-            const targetEl = (e.target || document.activeElement);
-            if (targetEl && targetEl.tagName) {
-                const tagName = targetEl.tagName.toLowerCase();
-                const isInput = tagName === "input" || tagName === "textarea";
-                const isContentEditable = targetEl.isContentEditable ||
-                    targetEl.getAttribute?.("contenteditable") === "true";
-                if (isInput || isContentEditable) {
-                    return;
-                }
-            }
+        // Default bindings from the command system: Mod+Z, Mod+Shift+Z and (off macOS) Mod+Y,
+        // matched by `event.code` with `Mod` = ⌘ on macOS and Ctrl elsewhere.
+        const action = matchHistoryShortcut(e, { allowInEditable: !ignoreEditableElements });
+        if (action === "undo" && manager.getState().canUndo) {
+            e.preventDefault();
+            manager.undo();
         }
-        const key = e.key?.toLowerCase();
-        // Undo: Mod+Z (without Shift)
-        if (key === "z" && !e.shiftKey) {
-            if (manager.getState().canUndo) {
-                e.preventDefault();
-                manager.undo();
-            }
-            return;
-        }
-        // Redo: Mod+Shift+Z or (on non-Mac) Mod+Y
-        const isRedoKey = (key === "z" && e.shiftKey) || (!isMac && key === "y" && !e.shiftKey);
-        if (isRedoKey) {
-            if (manager.getState().canRedo) {
-                e.preventDefault();
-                manager.redo();
-            }
+        else if (action === "redo" && manager.getState().canRedo) {
+            e.preventDefault();
+            manager.redo();
         }
     };
     eventTarget.addEventListener("keydown", handleKeyDown);

package/dist/history/history.svelte.d.ts

@@ -1,14 +1,23 @@
-import { HistoryManager, HistoryState, Command, HistoryManagerOptions } from "@pixerate/editor/history";
+import { HistoryManager, HistoryState, HistoryEntry, HistoryMark, MergedExecutionOptions, Command, HistoryManagerOptions } from "@pixerate/editor/history";
 export interface SvelteHistory extends HistoryState {
     readonly manager: HistoryManager;
+    /** History panel rows (undo steps, then redo steps). */
+    readonly entries: HistoryEntry[];
     undo(): boolean;
     redo(): boolean;
     clear(): void;
     execute(command: Command): void;
-    executeMerged(command: Command, options?: {
-        windowMs?: number;
-    }): void;
+    executeMerged(command: Command, options?: MergedExecutionOptions): void;
     batch(name: string, fn: () => void): void;
+    /** Undoes / redoes until the entry at `index` is current (`-1` = before all). */
+    goTo(index: number): number;
+    /** Captures the current point, e.g. when a drag starts. */
+    mark(): HistoryMark;
+    /** Takes back every step since `mark` without leaving redo (Escape-cancel). */
+    revertTo(mark: HistoryMark): number;
+    /** Joins every merged execute into one step until `endGesture`. */
+    beginGesture(key: string): void;
+    endGesture(): void;
     subscribe(run: (value: HistoryState) => void): () => void;
 }
 /**

package/dist/history/history.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.svelte.d.ts","sourceRoot":"","sources":["../../src/history/history.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,OAAO,EAEP,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,IAAI,IAAI,OAAO,CAAC;IAChB,IAAI,IAAI,OAAO,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,gBAAgB,CAAC,EAAE,cAAc,GAAG,qBAAqB,GACxD,aAAa,CA2Cf"}
+{"version":3,"file":"history.svelte.d.ts","sourceRoot":"","sources":["../../src/history/history.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,OAAO,EAEP,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,IAAI,IAAI,OAAO,CAAC;IAChB,IAAI,IAAI,OAAO,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC1C,iFAAiF;IACjF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,IAAI,IAAI,WAAW,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,mEAAmE;IACnE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,gBAAgB,CAAC,EAAE,cAAc,GAAG,qBAAqB,GACxD,aAAa,CAqDf"}

package/dist/history/history.svelte.js

@@ -32,12 +32,22 @@ export function createHistory(managerOrOptions) {
         get manager() {
             return manager;
         },
+        get entries() {
+            // Reading `state` makes the getter reactive; getEntries() is cached per change.
+            void state;
+            return manager.getEntries();
+        },
         undo: () => manager.undo(),
         redo: () => manager.redo(),
         clear: () => manager.clear(),
         execute: (cmd) => manager.execute(cmd),
         executeMerged: (cmd, opts) => manager.executeMerged(cmd, opts),
         batch: (name, fn) => manager.batch(name, fn),
+        goTo: (index) => manager.goTo(index),
+        mark: () => manager.mark(),
+        revertTo: (m) => manager.revertTo(m),
+        beginGesture: (key) => manager.beginGesture(key),
+        endGesture: () => manager.endGesture(),
         subscribe: (run) => manager.subscribe(run),
     };
 }

package/dist/history/historyDirty.svelte.d.ts

@@ -0,0 +1,31 @@
+import { DirtyTracker, type DirtyTrackerOptions, type HistoryManager } from "@pixerate/editor/history";
+export interface CreateHistoryDirtyOptions<T> extends DirtyTrackerOptions<T> {
+    /** The history whose changes re-check the document (a `createHistory().manager`). */
+    history: HistoryManager;
+    /** Reads the current document value. */
+    getValue: () => T;
+    /** Existing tracker to drive. */
+    tracker?: DirtyTracker<T>;
+}
+export interface SvelteHistoryDirty<T> {
+    /** Whether the document differs from the saved state (reactive). */
+    readonly isDirty: boolean;
+    /** Marks the current document as saved. */
+    markClean(): void;
+    /** Runs a load / restore without marking the document dirty (re-entrant). */
+    suppress<R>(fn: () => R): R;
+    /** Re-checks after a change made outside the history. */
+    refresh(): boolean;
+    readonly tracker: DirtyTracker<T>;
+    /** Stops following the history. */
+    destroy(): void;
+}
+/**
+ * Svelte 5 rune: dirty-vs-saved tracking bound to a HistoryManager. Undoing
+ * back to the saved state makes the document clean again, so a navigation
+ * guard fed with `isDirty` stops prompting.
+ *
+ * Usage: `createNavigationGuard({ isDirty: () => dirty.isDirty })`.
+ */
+export declare function createHistoryDirty<T>(options: CreateHistoryDirtyOptions<T>): SvelteHistoryDirty<T>;
+//# sourceMappingURL=historyDirty.svelte.d.ts.map

package/dist/history/historyDirty.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyDirty.svelte.d.ts","sourceRoot":"","sources":["../../src/history/historyDirty.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,yBAAyB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IAC1E,qFAAqF;IACrF,OAAO,EAAE,cAAc,CAAC;IACxB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,IAAI,IAAI,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,yDAAyD;IACzD,OAAO,IAAI,OAAO,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,mCAAmC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACpC,kBAAkB,CAAC,CAAC,CAAC,CAsBvB"}

package/dist/history/historyDirty.svelte.js

@@ -0,0 +1,30 @@
+import { bindDirtyToHistory, } from "@pixerate/editor/history";
+/**
+ * Svelte 5 rune: dirty-vs-saved tracking bound to a HistoryManager. Undoing
+ * back to the saved state makes the document clean again, so a navigation
+ * guard fed with `isDirty` stops prompting.
+ *
+ * Usage: `createNavigationGuard({ isDirty: () => dirty.isDirty })`.
+ */
+export function createHistoryDirty(options) {
+    const binding = bindDirtyToHistory(options);
+    let isDirty = $state(binding.dirty);
+    const unsubscribe = binding.subscribe((dirty) => {
+        isDirty = dirty;
+    });
+    return {
+        get isDirty() {
+            return isDirty;
+        },
+        markClean: () => binding.markClean(),
+        suppress: (fn) => binding.suppress(fn),
+        refresh: () => binding.refresh(),
+        get tracker() {
+            return binding.tracker;
+        },
+        destroy() {
+            unsubscribe();
+            binding.destroy();
+        },
+    };
+}

package/dist/history/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./history.svelte.js";
 export * from "./createHistoryShortcuts.js";
+export * from "./historyDirty.svelte.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}

package/dist/history/index.js

@@ -1,2 +1,3 @@
 export * from "./history.svelte.js";
 export * from "./createHistoryShortcuts.js";
+export * from "./historyDirty.svelte.js";

package/dist/image-editor/ImageEditor.svelte

@@ -16,6 +16,8 @@
     getCropCursor,
     calculateCropDrag,
     hitTestAnnotation,
+    normalizeProcessVersion,
+    LATEST_PROCESS_VERSION,
   } from '@pixerate/editor/image-editor';
   import { onDestroy, untrack } from 'svelte';
   import { createReactiveImageEditor, type ReactiveImageEditor } from './imageEditorState.svelte.js';
@@ -47,6 +49,9 @@
   const internalEditor = createReactiveImageEditor();
   const editor = $derived(propEditor || internalEditor);
   onDestroy(() => internalEditor.destroy());
+  const legacyProcess = $derived(
+    normalizeProcessVersion(editor.state.adjustments.process) < LATEST_PROCESS_VERSION
+  );
 
   let canvasEl = $state<HTMLCanvasElement | null>(null);
   let containerEl = $state<HTMLDivElement | null>(null);
@@ -961,6 +966,40 @@
             />
           </div>
 
+          <!-- Tint (process 2 white balance) -->
+          <div>
+            <div class="flex justify-between text-slate-400 mb-1">
+              <span>Tint</span>
+              <span class="font-mono">{editor.state.adjustments.tint ?? 0}</span>
+            </div>
+            <input
+              type="range"
+              min="-100"
+              max="100"
+              aria-label="Tint"
+              disabled={legacyProcess}
+              value={editor.state.adjustments.tint ?? 0}
+              oninput={(e) => editor.setAdjustments({ tint: Number((e.target as HTMLInputElement).value) })}
+              class="w-full accent-indigo-500 disabled:opacity-40"
+            />
+          </div>
+
+          {#if legacyProcess}
+            <div
+              class="flex items-center justify-between gap-2 rounded border border-amber-500/30 bg-amber-500/10 px-2 py-1.5 text-[10px] text-amber-200"
+              data-testid="image-editor-process-notice"
+            >
+              <span>Legacy rendering (process 1). Tint needs the current process.</span>
+              <button
+                type="button"
+                onclick={() => editor.upgradeProcess()}
+                class="shrink-0 rounded bg-amber-500/20 px-2 py-0.5 hover:bg-amber-500/30"
+              >
+                Update
+              </button>
+            </div>
+          {/if}
+
           <!-- Blur -->
           <div>
             <div class="flex justify-between text-slate-400 mb-1">

package/dist/image-editor/ImageEditor.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageEditor.svelte.d.ts","sourceRoot":"","sources":["../../src/image-editor/ImageEditor.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIR,aAAa,EAGb,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AASzC,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGjG,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AA+hCH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ImageEditor.svelte.d.ts","sourceRoot":"","sources":["../../src/image-editor/ImageEditor.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIR,aAAa,EAGb,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAWzC,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGjG,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAojCH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/image-editor/imageEditorState.svelte.d.ts

@@ -14,6 +14,8 @@ export declare function createReactiveImageEditor(options?: ImageEditorOptions):
     flipVertical(): void;
     setAdjustments(partial: Partial<ImageAdjustments>, commitToHistory?: boolean): void;
     resetAdjustments(): void;
+    /** Update to Current Process: re-render the adjustments with the latest process (one undo step). */
+    upgradeProcess(): boolean;
     setDepthMask(partial: Partial<DepthMaskOptions>): void;
     resetDepthMask(): void;
     addAnnotation(ann: CreateAnnotationPayload): string;

package/dist/image-editor/imageEditorState.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageEditorState.svelte.d.ts","sourceRoot":"","sources":["../../src/image-editor/imageEditorState.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB;;;;;kBA0BxD,eAAe;kBAGf,OAAO,GAAG,IAAI;2BAGL,WAAW;;oBAMlB,MAAM;yBAGD,MAAM;;;4BASH,OAAO,CAAC,gBAAgB,CAAC;;0BAM3B,OAAO,CAAC,gBAAgB,CAAC;;uBAM5B,uBAAuB;yBAGrB,MAAM,WAAW,OAAO,CAAC,UAAU,CAAC;yBAGpC,MAAM;;yBAMN,MAAM,GAAG,IAAI;;;;oBAYlB,MAAM;qBAGL,MAAM;;kBAMT,MAAM;gBAGR,UAAU;4BAGE,OAAO;mBAGhB,MAAM,GAAG,gBAAgB;qBAGvB,aAAa;kBAGhB,aAAa;;mBAMZ,0BAA0B;sBAGvB;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;yBAG5C;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;2BAG7C,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;oCAGhC,MAAM;4CAGE,MAAM;IAG9C,8EAA8E;;EAKjF;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"imageEditorState.svelte.d.ts","sourceRoot":"","sources":["../../src/image-editor/imageEditorState.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB;;;;;kBA0BxD,eAAe;kBAGf,OAAO,GAAG,IAAI;2BAGL,WAAW;;oBAMlB,MAAM;yBAGD,MAAM;;;4BASH,OAAO,CAAC,gBAAgB,CAAC;;IAMjD,oGAAoG;;0BAI9E,OAAO,CAAC,gBAAgB,CAAC;;uBAM5B,uBAAuB;yBAGrB,MAAM,WAAW,OAAO,CAAC,UAAU,CAAC;yBAGpC,MAAM;;yBAMN,MAAM,GAAG,IAAI;;;;oBAYlB,MAAM;qBAGL,MAAM;;kBAMT,MAAM;gBAGR,UAAU;4BAGE,OAAO;mBAGhB,MAAM,GAAG,gBAAgB;qBAGvB,aAAa;kBAGhB,aAAa;;mBAMZ,0BAA0B;sBAGvB;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;yBAG5C;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;2BAG7C,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;oCAGhC,MAAM;4CAGE,MAAM;IAG9C,8EAA8E;;EAKjF;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/image-editor/imageEditorState.svelte.js

@@ -53,6 +53,10 @@ export function createReactiveImageEditor(options = {}) {
         resetAdjustments() {
             controller.resetAdjustments();
         },
+        /** Update to Current Process: re-render the adjustments with the latest process (one undo step). */
+        upgradeProcess() {
+            return controller.upgradeProcess();
+        },
         setDepthMask(partial) {
             controller.setDepthMask(partial);
         },

package/dist/index.d.ts

@@ -11,8 +11,8 @@ export * from "./history/index.js";
 export * from "./fileImport.svelte.js";
 export * from "./agentTools.svelte.js";
 export * from "./outline.svelte.js";
-export { DirtyTracker, createDirtyTracker, defaultIsEqual, HistoryManager, createHistoryManager, } from "@pixerate/editor";
-export type { DirtyTrackerOptions, Command, HistoryState, HistoryManagerOptions, } from "@pixerate/editor";
+export { DirtyTracker, createDirtyTracker, defaultIsEqual, HistoryManager, createHistoryManager, bindDirtyToHistory, withoutDirty, } from "@pixerate/editor";
+export type { DirtyTrackerOptions, Command, HistoryState, HistoryManagerOptions, HistoryEntry, HistoryMark, MergedExecutionOptions, HistoryDirtyBinding, BindDirtyToHistoryOptions, } from "@pixerate/editor";
 export type EditableTextNodeEditorProps = ComponentProps<typeof EditableTextNodeEditorComponent>;
 export type BubbleMenuProps = ComponentProps<typeof BubbleMenuComponent>;
 export type TemplateRendererProps = ComponentProps<typeof TemplateRendererComponent>;
@@ -28,4 +28,5 @@ export type { PromptValues, PromptDiagnostic, VariableFormField, } from "@pixera
 export * from "./spreadsheet/index.js";
 export * from "./image-editor/index.js";
 export * from "./review/index.js";
+export * from "./commands/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,+BAA+B,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,mBAAmB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,yBAAyB,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,qBAAqB,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,qBAAqB,MAAM,uBAAuB,CAAC;AAE/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AAEpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACtD,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAChD,OAAO,yBAAyB,CACjC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7E,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhE,YAAY,EACV,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,+BAA+B,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,mBAAmB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,yBAAyB,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,qBAAqB,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,qBAAqB,MAAM,uBAAuB,CAAC;AAE/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AAEpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACtD,OAAO,+BAA+B,CACvC,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAChD,OAAO,yBAAyB,CACjC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7E,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhE,YAAY,EACV,QAAQ,EACR,eAAe,EACf,KAAK,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@ export * from "./history/index.js";
 export * from "./fileImport.svelte.js";
 export * from "./agentTools.svelte.js";
 export * from "./outline.svelte.js";
-export { DirtyTracker, createDirtyTracker, defaultIsEqual, HistoryManager, createHistoryManager, } from "@pixerate/editor";
+export { DirtyTracker, createDirtyTracker, defaultIsEqual, HistoryManager, createHistoryManager, bindDirtyToHistory, withoutDirty, } from "@pixerate/editor";
 export { default as EditableTextNodeEditor } from "./EditableTextNodeEditor.svelte";
 export { default as BubbleMenu } from "./BubbleMenu.svelte";
 export { default as TemplateRenderer } from "./TemplateRenderer.svelte";
@@ -14,3 +14,4 @@ export { default as OutlinePanel } from "./OutlinePanel.svelte";
 export * from "./spreadsheet/index.js";
 export * from "./image-editor/index.js";
 export * from "./review/index.js";
+export * from "./commands/index.js";

package/dist/review/ReviewToolbar.svelte

@@ -5,11 +5,17 @@
   interface Props {
     editor?: Editor | null;
     class?: string;
+    /** Show the current change's author and description. Defaults to `true`. */
+    showDescription?: boolean;
+    /** Class of the description label. */
+    descriptionClass?: string;
   }
 
   let {
     editor = null,
     class: className = "flex flex-wrap items-center gap-1 rounded-md border border-border bg-background p-1 text-sm",
+    showDescription = true,
+    descriptionClass = "max-w-[16rem] truncate px-1 text-xs text-muted-foreground",
   }: Props = $props();
 
   const buttonClass =
@@ -60,6 +66,15 @@
   >
     ›
   </button>
+  {#if showDescription && current}
+    <span
+      class={descriptionClass}
+      data-change-type={current.type}
+      title={`${current.author.name}: ${current.description}`}
+    >
+      {current.author.name ? `${current.author.name}: ` : ""}{current.description}
+    </span>
+  {/if}
   <span class="mx-1 h-4 w-px bg-border" aria-hidden="true"></span>
   <button
     type="button"

package/dist/review/ReviewToolbar.svelte.d.ts

@@ -2,6 +2,10 @@ import type { Editor } from "@tiptap/core";
 interface Props {
     editor?: Editor | null;
     class?: string;
+    /** Show the current change's author and description. Defaults to `true`. */
+    showDescription?: boolean;
+    /** Class of the description label. */
+    descriptionClass?: string;
 }
 declare const ReviewToolbar: import("svelte").Component<Props, {}, "">;
 type ReviewToolbar = ReturnType<typeof ReviewToolbar>;

package/dist/review/ReviewToolbar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReviewToolbar.svelte.d.ts","sourceRoot":"","sources":["../../src/review/ReviewToolbar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAIzC,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0DH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ReviewToolbar.svelte.d.ts","sourceRoot":"","sources":["../../src/review/ReviewToolbar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAIzC,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAiEH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/spreadsheet/FormulaBar.svelte

@@ -46,6 +46,15 @@
     return value;
   });
 
+  // A spilled cell shows its anchor's formula greyed out (it has no formula of its own).
+  let spillFormula = $derived.by(() => {
+    if (!sheetState || sheetState.editingCell || !sheetState.activeCell || effectiveValue) return '';
+    void sheetState.document;
+    const { row, col } = sheetState.activeCell;
+    const spill = sheetState.controller.getSpillAt(row, col);
+    return spill && (spill.anchor.row !== row || spill.anchor.col !== col) ? spill.formula : '';
+  });
+
   function handleKeyDown(e: KeyboardEvent) {
     // Keys typed here must not reach the grid's navigation handler.
     e.stopPropagation();
@@ -101,7 +110,9 @@
     placeholder="Enter a value or formula (e.g. =SUM(A1:A5))"
     aria-label="Formula bar"
     bind:this={inputEl}
-    value={effectiveValue}
+    data-spill-formula={spillFormula ? 'true' : undefined}
+    style={spillFormula ? 'color: var(--muted-foreground, #94a3b8);' : undefined}
+    value={effectiveValue || spillFormula}
     oninput={handleInput}
     onkeydown={handleKeyDown}
   />