@pixerate/editor 0.243.0 → 0.245.0

package/dist/gradient/index.cjs

@@ -28,7 +28,7 @@
 var _chunkS6OT6CTScjs = require('../chunk-S6OT6CTS.cjs');
 
 
-var _chunkFJ2MSI43cjs = require('../chunk-FJ2MSI43.cjs');
+var _chunkWKPXOGZZcjs = require('../chunk-WKPXOGZZ.cjs');
 require('../chunk-7PT4RJL5.cjs');
 require('../chunk-PPFJHTW5.cjs');
 
@@ -101,7 +101,7 @@ var GradientController = (_class = class {
     } else {
       this._gradient = _chunkS6OT6CTScjs.createGradient.call(void 0, ["#000000", "#ffffff"]);
     }
-    this._history = _nullishCoalesce(options.history, () => ( new (0, _chunkFJ2MSI43cjs.HistoryManager)()));
+    this._history = _nullishCoalesce(options.history, () => ( new (0, _chunkWKPXOGZZcjs.HistoryManager)()));
     this._readOnlyOption = options.readOnly;
     this._onChange = options.onChange;
     if (this._gradient.stops.length > 0) {

package/dist/gradient/index.js

@@ -28,7 +28,7 @@ import {
 } from "../chunk-KMPM5JM5.js";
 import {
   HistoryManager
-} from "../chunk-RNSANXPT.js";
+} from "../chunk-NS62CQ2B.js";
 import "../chunk-BP6KSGVD.js";
 import "../chunk-6ADHGQ73.js";
 import {

package/dist/history/HistoryManager.d.cts

@@ -1,4 +1,4 @@
-import { Command, HistoryEntry, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, SnapshotCommandOptions } from "./types.cjs";
+import { Command, HistoryCommitEvent, HistoryEntry, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, SnapshotCommandOptions } from "./types.cjs";
 /**
  * UI-agnostic History and Undo/Redo manager supporting command closures,
  * snapshot diffs, transaction batching, high-frequency event coalescing,
@@ -14,6 +14,9 @@ export declare class HistoryManager {
     private batchDepth;
     private currentBatch;
     private listeners;
+    private commitListeners;
+    /** Origins set by `withOrigin`, innermost last. */
+    private origins;
     private onStateChange?;
     private cachedState;
     private cachedEntries;
@@ -136,6 +139,22 @@ export declare class HistoryManager {
      * Returns an unsubscribe function.
      */
     subscribe(listener: (state: HistoryState) => void): () => void;
+    /**
+     * Listens to each change as it lands: what happened (`execute`, `merge`, `undo`, `redo`,
+     * `revert`, `clear`), the step and who made it. Unlike `subscribe`, it is not called at once
+     * and it hears every step of a `goTo`. Returns an unsubscribe function.
+     */
+    onCommit(listener: (event: HistoryCommitEvent) => void): () => void;
+    private emit;
+    /** The origin a change is recorded with when its command names none (see `withOrigin`). */
+    getOrigin(): string;
+    /**
+     * Records the changes `fn` makes as made by `origin` (`agent:<id>` for an agent), unless a
+     * command names its own. When `fn` returns a promise, the origin holds until it settles, so
+     * anything else recorded on this history meanwhile (the user's own edits) is stamped with it
+     * too: give those commands an explicit `origin`, or keep agent work synchronous.
+     */
+    withOrigin<T>(origin: string, fn: () => T): T;
     /**
      * Utility helper to create a Command from before/after state snapshots.
      */

package/dist/history/HistoryManager.d.ts

@@ -1,4 +1,4 @@
-import { Command, HistoryEntry, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, SnapshotCommandOptions } from "./types.js";
+import { Command, HistoryCommitEvent, HistoryEntry, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, SnapshotCommandOptions } from "./types.js";
 /**
  * UI-agnostic History and Undo/Redo manager supporting command closures,
  * snapshot diffs, transaction batching, high-frequency event coalescing,
@@ -14,6 +14,9 @@ export declare class HistoryManager {
     private batchDepth;
     private currentBatch;
     private listeners;
+    private commitListeners;
+    /** Origins set by `withOrigin`, innermost last. */
+    private origins;
     private onStateChange?;
     private cachedState;
     private cachedEntries;
@@ -136,6 +139,22 @@ export declare class HistoryManager {
      * Returns an unsubscribe function.
      */
     subscribe(listener: (state: HistoryState) => void): () => void;
+    /**
+     * Listens to each change as it lands: what happened (`execute`, `merge`, `undo`, `redo`,
+     * `revert`, `clear`), the step and who made it. Unlike `subscribe`, it is not called at once
+     * and it hears every step of a `goTo`. Returns an unsubscribe function.
+     */
+    onCommit(listener: (event: HistoryCommitEvent) => void): () => void;
+    private emit;
+    /** The origin a change is recorded with when its command names none (see `withOrigin`). */
+    getOrigin(): string;
+    /**
+     * Records the changes `fn` makes as made by `origin` (`agent:<id>` for an agent), unless a
+     * command names its own. When `fn` returns a promise, the origin holds until it settles, so
+     * anything else recorded on this history meanwhile (the user's own edits) is stamped with it
+     * too: give those commands an explicit `origin`, or keep agent work synchronous.
+     */
+    withOrigin<T>(origin: string, fn: () => T): T;
     /**
      * Utility helper to create a Command from before/after state snapshots.
      */

package/dist/history/index.cjs

@@ -8,13 +8,19 @@ var _chunkWWMWFSXMcjs = require('../chunk-WWMWFSXM.cjs');
 
 
 
-var _chunkFJ2MSI43cjs = require('../chunk-FJ2MSI43.cjs');
 
 
 
+var _chunkWKPXOGZZcjs = require('../chunk-WKPXOGZZ.cjs');
 
 
 
 
 
-exports.DirtyTracker = _chunkWWMWFSXMcjs.DirtyTracker; exports.HistoryManager = _chunkFJ2MSI43cjs.HistoryManager; exports.bindDirtyToHistory = _chunkWWMWFSXMcjs.bindDirtyToHistory; exports.createDirtyTracker = _chunkWWMWFSXMcjs.createDirtyTracker; exports.createHistoryManager = _chunkFJ2MSI43cjs.createHistoryManager; exports.defaultIsEqual = _chunkWWMWFSXMcjs.defaultIsEqual; exports.withoutDirty = _chunkWWMWFSXMcjs.withoutDirty;
+
+
+
+
+
+
+exports.DirtyTracker = _chunkWWMWFSXMcjs.DirtyTracker; exports.HistoryManager = _chunkWKPXOGZZcjs.HistoryManager; exports.USER_ORIGIN = _chunkWKPXOGZZcjs.USER_ORIGIN; exports.agentOrigin = _chunkWKPXOGZZcjs.agentOrigin; exports.bindDirtyToHistory = _chunkWWMWFSXMcjs.bindDirtyToHistory; exports.createDirtyTracker = _chunkWWMWFSXMcjs.createDirtyTracker; exports.createHistoryManager = _chunkWKPXOGZZcjs.createHistoryManager; exports.defaultIsEqual = _chunkWWMWFSXMcjs.defaultIsEqual; exports.originAgentId = _chunkWKPXOGZZcjs.originAgentId; exports.withoutDirty = _chunkWWMWFSXMcjs.withoutDirty;

package/dist/history/index.js

@@ -7,14 +7,20 @@ import {
 } from "../chunk-AFCXRB6O.js";
 import {
   HistoryManager,
-  createHistoryManager
-} from "../chunk-RNSANXPT.js";
+  USER_ORIGIN,
+  agentOrigin,
+  createHistoryManager,
+  originAgentId
+} from "../chunk-NS62CQ2B.js";
 export {
   DirtyTracker,
   HistoryManager,
+  USER_ORIGIN,
+  agentOrigin,
   bindDirtyToHistory,
   createDirtyTracker,
   createHistoryManager,
   defaultIsEqual,
+  originAgentId,
   withoutDirty
 };

package/dist/history/types.d.cts

@@ -10,7 +10,18 @@ export interface Command {
      * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
      */
     byteSize?: number;
+    /**
+     * Who made the change: `user` (the default) or `agent:<id>` for an agent. Falls back to the
+     * origin set with `HistoryManager.withOrigin`, then to `user`.
+     */
+    origin?: string;
 }
+/** The origin of changes no one has claimed: the person at the keyboard. */
+export declare const USER_ORIGIN = "user";
+/** The origin of an agent's changes: `agent:<id>`. */
+export declare function agentOrigin(agentId: string): string;
+/** The agent id of an `agent:<id>` origin, or `null` for any other origin. */
+export declare function originAgentId(origin: string | undefined): string | null;
 export interface HistoryState {
     canUndo: boolean;
     canRedo: boolean;
@@ -71,6 +82,26 @@ export interface HistoryEntry {
     current: boolean;
     /** True for steps on the redo stack (undone, can be redone). */
     undone: boolean;
+    /** Who made the step: `user` or `agent:<id>` (see `Command.origin`). */
+    origin: string;
+}
+/**
+ * What a `HistoryManager.onCommit` listener hears:
+ * - `execute`: a new step was recorded (also a `batch`).
+ * - `merge`: a change folded into the top step (a gesture or a coalesced `executeMerged`).
+ * - `undo` / `redo`: one step was taken back or re-applied (`goTo` reports one per step).
+ * - `revert`: `revertTo` took steps back for good.
+ * - `clear`: the history was emptied.
+ */
+export type HistoryCommitKind = "execute" | "merge" | "undo" | "redo" | "revert" | "clear";
+export interface HistoryCommitEvent {
+    kind: HistoryCommitKind;
+    /** The step recorded, merged into, undone or redone. Absent for `revert` and `clear`. */
+    entry?: HistoryEntry;
+    /** Who made the change: the step's origin for `execute` / `merge`, else the origin in effect. */
+    origin: string;
+    /** `HistoryManager.getRevision()` after the change. */
+    revision: number;
 }
 /**
  * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.

package/dist/history/types.d.ts

@@ -10,7 +10,18 @@ export interface Command {
      * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
      */
     byteSize?: number;
+    /**
+     * Who made the change: `user` (the default) or `agent:<id>` for an agent. Falls back to the
+     * origin set with `HistoryManager.withOrigin`, then to `user`.
+     */
+    origin?: string;
 }
+/** The origin of changes no one has claimed: the person at the keyboard. */
+export declare const USER_ORIGIN = "user";
+/** The origin of an agent's changes: `agent:<id>`. */
+export declare function agentOrigin(agentId: string): string;
+/** The agent id of an `agent:<id>` origin, or `null` for any other origin. */
+export declare function originAgentId(origin: string | undefined): string | null;
 export interface HistoryState {
     canUndo: boolean;
     canRedo: boolean;
@@ -71,6 +82,26 @@ export interface HistoryEntry {
     current: boolean;
     /** True for steps on the redo stack (undone, can be redone). */
     undone: boolean;
+    /** Who made the step: `user` or `agent:<id>` (see `Command.origin`). */
+    origin: string;
+}
+/**
+ * What a `HistoryManager.onCommit` listener hears:
+ * - `execute`: a new step was recorded (also a `batch`).
+ * - `merge`: a change folded into the top step (a gesture or a coalesced `executeMerged`).
+ * - `undo` / `redo`: one step was taken back or re-applied (`goTo` reports one per step).
+ * - `revert`: `revertTo` took steps back for good.
+ * - `clear`: the history was emptied.
+ */
+export type HistoryCommitKind = "execute" | "merge" | "undo" | "redo" | "revert" | "clear";
+export interface HistoryCommitEvent {
+    kind: HistoryCommitKind;
+    /** The step recorded, merged into, undone or redone. Absent for `revert` and `clear`. */
+    entry?: HistoryEntry;
+    /** Who made the change: the step's origin for `execute` / `merge`, else the origin in effect. */
+    origin: string;
+    /** `HistoryManager.getRevision()` after the change. */
+    revision: number;
 }
 /**
  * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.