@pixerate/editor-svelte 0.15.2 → 0.16.0

package/dist/canvas/types.d.ts

@@ -0,0 +1,183 @@
+import type { Node, Edge, XYPosition, ColorMode } from '@xyflow/svelte';
+/**
+ * Generic node interface representing an element on the canvas.
+ */
+export type CanvasNode<TData extends Record<string, any> = Record<string, any>, TType extends string | undefined = string | undefined> = Node<TData, TType>;
+/**
+ * Generic edge interface representing a connection on the canvas.
+ */
+export type CanvasEdge<TData extends Record<string, any> = Record<string, any>, TType extends string | undefined = string | undefined> = Edge<TData, TType>;
+/**
+ * Differences computed between two graph states.
+ */
+export interface GraphDifferences<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    changedNodes: TNode[];
+    changedEdges: TEdge[];
+    removedNodes: TNode[];
+    removedEdges: TEdge[];
+}
+/**
+ * Standard serialized clipboard payload for nodes and optional edges.
+ */
+export interface CanvasClipboardPayload<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    version?: number;
+    nodes: TNode[];
+    edges?: TEdge[];
+}
+/**
+ * Options for Dagre graph layout.
+ */
+export interface CanvasLayoutOptions {
+    direction?: 'LR' | 'TB' | 'RL' | 'BT';
+    ranksep?: number;
+    nodesep?: number;
+    defaultNodeWidth?: number;
+    defaultNodeHeight?: number;
+}
+/**
+ * Options for keyboard shortcuts.
+ */
+export interface CanvasShortcutsOptions<TNode extends CanvasNode = CanvasNode> {
+    targetElement?: HTMLElement | Window;
+    onCopy?: () => void;
+    onCut?: () => void;
+    onPaste?: (event: ClipboardEvent) => void;
+    onDelete?: (selectedNodes: TNode[]) => void;
+    onDuplicate?: (selectedNodes: TNode[]) => void;
+    onSelectAll?: () => void;
+    onGroup?: (selectedNodes: TNode[]) => void;
+    onUngroup?: (selectedNodes: TNode[]) => void;
+    onZoomIn?: () => void;
+    onZoomOut?: () => void;
+    onFitView?: () => void;
+    onSearch?: () => void;
+    getSelectedNodes?: () => TNode[];
+}
+/**
+ * Strategy used to resolve the primary dock target when multiple targets intersect a dragged node.
+ * - 'center-point': Chooses the target enclosing or closest to the center coordinate of the dragged node.
+ * - 'max-overlap': Chooses the target with the largest bounding box intersection area.
+ * - 'pointer': Chooses the target enclosing or closest to the mouse/touch cursor coordinates (falls back to 'center-point').
+ * - 'first': Chooses the first intersecting target (legacy behavior).
+ */
+export type DockStrategy = 'center-point' | 'max-overlap' | 'pointer' | 'first';
+/**
+ * Docking and intersection callbacks.
+ */
+export interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
+    onDockHover?: (dockTarget: TNode, draggedNode: TNode) => void;
+    onDockLeave?: (dockTarget: TNode, draggedNode: TNode) => void;
+    onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
+}
+/**
+ * Configuration options for SvelteFlow presets.
+ */
+export interface CanvasInteractionPresetConfig {
+    snapGrid?: [number, number];
+    panOnDrag?: number[] | boolean;
+    panOnScroll?: boolean;
+    selectionOnDrag?: boolean;
+    colorMode?: ColorMode;
+    multiSelectionKey?: string[];
+    minZoom?: number;
+    maxZoom?: number;
+    selectionMode?: 'partial' | 'full';
+}
+/**
+ * Parametric point returned by a trajectory evaluation.
+ */
+export interface TrajectoryPoint {
+    position: XYPosition;
+    scale?: number;
+    opacity?: number;
+}
+/**
+ * Trajectory evaluation function determining path, scale, and opacity over time t in [0, 1].
+ */
+export type TrajectoryFunction = (origin: XYPosition, target: XYPosition, progress: number, index: number, total: number) => TrajectoryPoint;
+/**
+ * Options for fan-out trajectory generator.
+ */
+export interface FanOutTrajectoryOptions {
+    curvature?: number;
+    spreadAngle?: number;
+    startScale?: number;
+    endScale?: number;
+    startOpacity?: number;
+    endOpacity?: number;
+}
+/**
+ * Single node animation transition definition.
+ */
+export interface NodeTransition<TNode extends CanvasNode = CanvasNode> {
+    node: TNode;
+    from: XYPosition;
+    to: XYPosition;
+    trajectory?: TrajectoryFunction;
+    delay?: number;
+    duration?: number;
+    easing?: (t: number) => number;
+    index?: number;
+    total?: number;
+}
+/**
+ * Displacement axis / direction.
+ */
+export type DisplacementDirection = 'right' | 'left' | 'down' | 'up' | 'vertical';
+/**
+ * Options for directional displacement calculation.
+ */
+export interface DirectionalDisplacementOptions {
+    direction?: DisplacementDirection;
+    gap?: number;
+    spreadSiblingLanes?: boolean;
+    siblingTolerance?: number;
+    minY?: number;
+}
+/**
+ * Options for Dagre reflow displacement calculation.
+ */
+export interface ReflowDisplacementOptions extends CanvasLayoutOptions {
+    anchorNodeId: string;
+}
+/**
+ * Snapshot of canvas graph state prior to node explosion, enabling exact reversibility.
+ */
+export interface ExplosionSnapshot<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    parentId: string;
+    childNodeIds: string[];
+    childEdgeIds: string[];
+    displacedNodes: {
+        id: string;
+        originalPosition: XYPosition;
+    }[];
+    timestamp: number;
+}
+/**
+ * Options for exploding a node.
+ */
+export interface ExplodeNodeOptions<TNode extends CanvasNode = CanvasNode, TEdge extends CanvasEdge = CanvasEdge> {
+    childNodes: TNode[];
+    childEdges?: TEdge[];
+    connectParentToChildren?: boolean | 'first' | 'all';
+    connectChildrenToDownstream?: boolean;
+    displacementStrategy?: 'directional' | 'dagre' | 'none';
+    directionalOptions?: DirectionalDisplacementOptions;
+    reflowOptions?: Partial<ReflowDisplacementOptions>;
+    trajectory?: TrajectoryFunction;
+    duration?: number;
+    staggerDelay?: number;
+    easing?: (t: number) => number;
+    onComplete?: () => void;
+}
+/**
+ * Options for collapsing an exploded node.
+ */
+export interface CollapseNodeOptions {
+    duration?: number;
+    staggerDelay?: number;
+    easing?: (t: number) => number;
+    trajectory?: TrajectoryFunction;
+    onComplete?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/canvas/types.d.ts.map

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

package/dist/canvas/types.js

@@ -0,0 +1 @@
+export {};

package/dist/createNavigationGuard.svelte.d.ts

@@ -0,0 +1,24 @@
+export interface CreateNavigationGuardOptions {
+    /** Function or boolean returning whether there are unsaved changes */
+    isDirty: boolean | (() => boolean);
+    /** Whether guarding is enabled (defaults to true) */
+    enabled?: boolean | (() => boolean);
+    /** Optional custom navigation callback (e.g. SvelteKit goto) */
+    onNavigate?: (url: string) => void;
+    /** Optional callback fired when an internal navigation is intercepted */
+    onBlocked?: (url: string) => void;
+}
+export interface NavigationGuardManager {
+    readonly showConfirm: boolean;
+    setShowConfirm(show: boolean): void;
+    readonly pendingUrl: string | null;
+    intercept(url: string): boolean;
+    confirmLeave(): void;
+    cancelLeave(): void;
+    destroy(): void;
+}
+/**
+ * Headless Svelte 5 rune managing navigation guard state and beforeunload interception.
+ */
+export declare function createNavigationGuard(options: CreateNavigationGuardOptions): NavigationGuardManager;
+//# sourceMappingURL=createNavigationGuard.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createNavigationGuard.svelte.d.ts","sourceRoot":"","sources":["../src/createNavigationGuard.svelte.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACnC,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACpC,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,YAAY,IAAI,IAAI,CAAC;IACrB,WAAW,IAAI,IAAI,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,sBAAsB,CAsExB"}

package/dist/createNavigationGuard.svelte.js

@@ -0,0 +1,65 @@
+/**
+ * Headless Svelte 5 rune managing navigation guard state and beforeunload interception.
+ */
+export function createNavigationGuard(options) {
+    let showConfirm = $state(false);
+    let pendingUrl = $state(null);
+    const getIsDirty = () => typeof options.isDirty === "function" ? options.isDirty() : options.isDirty;
+    const getEnabled = () => typeof options.enabled === "function"
+        ? options.enabled()
+        : (options.enabled ?? true);
+    function handleBeforeUnload(e) {
+        if (!getEnabled() || !getIsDirty())
+            return;
+        e.preventDefault();
+        e.returnValue = "";
+    }
+    if (typeof window !== "undefined") {
+        window.addEventListener("beforeunload", handleBeforeUnload);
+    }
+    function intercept(url) {
+        if (getEnabled() && getIsDirty()) {
+            pendingUrl = url;
+            showConfirm = true;
+            options.onBlocked?.(url);
+            return true;
+        }
+        return false;
+    }
+    function confirmLeave() {
+        showConfirm = false;
+        const target = pendingUrl;
+        if (target) {
+            if (options.onNavigate) {
+                options.onNavigate(target);
+            }
+            else if (typeof window !== "undefined") {
+                window.location.href = target;
+            }
+        }
+    }
+    function cancelLeave() {
+        showConfirm = false;
+        pendingUrl = null;
+    }
+    function destroy() {
+        if (typeof window !== "undefined") {
+            window.removeEventListener("beforeunload", handleBeforeUnload);
+        }
+    }
+    return {
+        get showConfirm() {
+            return showConfirm;
+        },
+        setShowConfirm(val) {
+            showConfirm = val;
+        },
+        get pendingUrl() {
+            return pendingUrl;
+        },
+        intercept,
+        confirmLeave,
+        cancelLeave,
+        destroy,
+    };
+}

package/dist/editor.svelte.d.ts

@@ -0,0 +1,23 @@
+import { Editor, type Content, type EditorOptions, type Extensions } from "@tiptap/core";
+import { type RichTextPresetOptions } from "@pixerate/editor";
+export interface SvelteInitiateEditorOptions extends Partial<EditorOptions> {
+    richTextOptions?: RichTextPresetOptions;
+}
+/**
+ * Initializes a TipTap editor instance preconfigured with rich text extensions.
+ */
+export declare const initiateEditor: (element?: HTMLElement, content?: Content, extensions?: Extensions, options?: SvelteInitiateEditorOptions) => Editor;
+export interface ReactiveEditorState {
+    editor: Editor | undefined;
+    content: string;
+    isEditable: boolean;
+}
+/**
+ * Creates a reactive editor state manager for Svelte 5.
+ */
+export declare function createReactiveEditor(initialContent?: string, extensions?: Extensions, options?: Partial<EditorOptions>): {
+    readonly current: Editor | undefined;
+    mount(element: HTMLElement): Editor;
+    destroy(): void;
+};
+//# sourceMappingURL=editor.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor.svelte.d.ts","sourceRoot":"","sources":["../src/editor.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,MAAM,WAAW,2BAA4B,SAAQ,OAAO,CAAC,aAAa,CAAC;IACzE,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,WAAW,EACrB,UAAU,OAAO,EACjB,aAAa,UAAU,EACvB,UAAU,2BAA2B,KACpC,MAgBF,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,GAAE,MAAW,EAC3B,UAAU,GAAE,UAAe,EAC3B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM;;mBAQnB,WAAW;;EAW7B"}

package/dist/editor.svelte.js

@@ -0,0 +1,41 @@
+import { Editor } from "@tiptap/core";
+import { createRichTextPreset } from "@pixerate/editor";
+/**
+ * Initializes a TipTap editor instance preconfigured with rich text extensions.
+ */
+export const initiateEditor = (element, content, extensions, options) => {
+    const { richTextOptions, ...editorOptions } = options || {};
+    const defaultPreset = createRichTextPreset(richTextOptions);
+    const editor = new Editor({
+        element,
+        content,
+        extensions: [
+            ...defaultPreset,
+            ...(extensions ?? []),
+        ],
+        autofocus: false,
+        ...editorOptions,
+    });
+    return editor;
+};
+/**
+ * Creates a reactive editor state manager for Svelte 5.
+ */
+export function createReactiveEditor(initialContent = "", extensions = [], options = {}) {
+    let editorInstance;
+    return {
+        get current() {
+            return editorInstance;
+        },
+        mount(element) {
+            editorInstance = initiateEditor(element, initialContent, extensions, options);
+            return editorInstance;
+        },
+        destroy() {
+            if (editorInstance) {
+                editorInstance.destroy();
+                editorInstance = undefined;
+            }
+        },
+    };
+}

package/dist/history/createHistoryShortcuts.d.ts

@@ -0,0 +1,24 @@
+import { HistoryManager } from "@pixerate/editor";
+export interface HistoryShortcutsOptions {
+    /**
+     * Whether keyboard shortcuts are enabled. Defaults to true.
+     */
+    enabled?: boolean;
+    /**
+     * Target element or window to listen on. Defaults to window.
+     */
+    target?: Window | HTMLElement | null;
+    /**
+     * When true (default), shortcuts will not trigger if an <input>, <textarea>,
+     * or [contenteditable] element is currently active / focused.
+     */
+    ignoreEditableElements?: boolean;
+}
+/**
+ * Attaches keyboard listeners for Undo (Mod+Z) and Redo (Mod+Shift+Z / Mod+Y).
+ * Returns an object with a `destroy()` function for lifecycle cleanup.
+ */
+export declare function createHistoryShortcuts(manager: HistoryManager, options?: HistoryShortcutsOptions): {
+    destroy: () => void;
+};
+//# sourceMappingURL=createHistoryShortcuts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createHistoryShortcuts.d.ts","sourceRoot":"","sources":["../../src/history/createHistoryShortcuts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,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"}

package/dist/history/createHistoryShortcuts.js

@@ -0,0 +1,57 @@
+/**
+ * Attaches keyboard listeners for Undo (Mod+Z) and Redo (Mod+Shift+Z / Mod+Y).
+ * Returns an object with a `destroy()` function for lifecycle cleanup.
+ */
+export function createHistoryShortcuts(manager, options = {}) {
+    const { enabled = true, target, ignoreEditableElements = true, } = options;
+    if (!enabled) {
+        return { destroy: () => { } };
+    }
+    const eventTarget = target ?? (typeof window !== "undefined" ? window : null);
+    if (!eventTarget) {
+        return { destroy: () => { } };
+    }
+    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;
+                }
+            }
+        }
+        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();
+            }
+        }
+    };
+    eventTarget.addEventListener("keydown", handleKeyDown);
+    return {
+        destroy: () => {
+            eventTarget.removeEventListener("keydown", handleKeyDown);
+        },
+    };
+}

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

@@ -0,0 +1,18 @@
+import { HistoryManager, HistoryState, Command, HistoryManagerOptions } from "@pixerate/editor";
+export interface SvelteHistory extends HistoryState {
+    readonly manager: HistoryManager;
+    undo(): boolean;
+    redo(): boolean;
+    clear(): void;
+    execute(command: Command): void;
+    executeMerged(command: Command, options?: {
+        windowMs?: number;
+    }): void;
+    batch(name: string, fn: () => void): void;
+    subscribe(run: (value: HistoryState) => void): () => void;
+}
+/**
+ * Creates a reactive Svelte 5 rune-based and Svelte store-compatible history adapter.
+ */
+export declare function createHistory(managerOrOptions?: HistoryManager | HistoryManagerOptions): SvelteHistory;
+//# sourceMappingURL=history.svelte.d.ts.map

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

@@ -0,0 +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,kBAAkB,CAAC;AAE1B,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"}

package/dist/history/history.svelte.js

@@ -0,0 +1,43 @@
+import { HistoryManager, createHistoryManager, } from "@pixerate/editor";
+/**
+ * Creates a reactive Svelte 5 rune-based and Svelte store-compatible history adapter.
+ */
+export function createHistory(managerOrOptions) {
+    const manager = managerOrOptions instanceof HistoryManager
+        ? managerOrOptions
+        : createHistoryManager(managerOrOptions);
+    let state = $state(manager.getState());
+    manager.subscribe((newState) => {
+        state = newState;
+    });
+    return {
+        get canUndo() {
+            return state.canUndo;
+        },
+        get canRedo() {
+            return state.canRedo;
+        },
+        get undoName() {
+            return state.undoName;
+        },
+        get redoName() {
+            return state.redoName;
+        },
+        get undoCount() {
+            return state.undoCount;
+        },
+        get redoCount() {
+            return state.redoCount;
+        },
+        get manager() {
+            return manager;
+        },
+        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),
+        subscribe: (run) => manager.subscribe(run),
+    };
+}

package/dist/history/index.d.ts

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

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

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

package/dist/history/index.js

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

package/{src → dist}/image-editor/ImageEditor.svelte

@@ -17,7 +17,7 @@
     calculateCropDrag,
     hitTestAnnotation,
   } from '@pixerate/editor';
-  import { createReactiveImageEditor, type ReactiveImageEditor } from './imageEditorState.svelte';
+  import { createReactiveImageEditor, type ReactiveImageEditor } from './imageEditorState.svelte.js';
 
   interface Props {
     editor?: ReactiveImageEditor;

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

@@ -0,0 +1,17 @@
+import type { ExportOptions, InpaintHook, RemoveBackgroundHook, ImageEditorAIHooks } from '@pixerate/editor';
+import { type ReactiveImageEditor } from './imageEditorState.svelte.js';
+interface Props {
+    editor?: ReactiveImageEditor;
+    src?: string;
+    class?: string;
+    style?: string;
+    onSave?: (dataUrl: string) => void;
+    exportOptions?: ExportOptions;
+    onInpaint?: InpaintHook;
+    onRemoveBackground?: RemoveBackgroundHook;
+    aiHooks?: ImageEditorAIHooks;
+}
+declare const ImageEditor: import("svelte").Component<Props, {}, "">;
+type ImageEditor = ReturnType<typeof ImageEditor>;
+export default ImageEditor;
+//# sourceMappingURL=ImageEditor.svelte.d.ts.map

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

@@ -0,0 +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,kBAAkB,CAAC;AAQ5B,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;AAohCH,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

@@ -0,0 +1,50 @@
+import { ImageEditorController, type ImageEditorOptions, type ImageEditorState, type ImageEditorTool, type CropBox, type AspectRatio, type ImageAdjustments, type DepthMaskOptions, type Annotation, type CreateAnnotationPayload, type ExportOptions, type SerializedImageEditorState, type ImagePoint } from '@pixerate/editor';
+export declare function createReactiveImageEditor(options?: ImageEditorOptions): {
+    readonly controller: ImageEditorController;
+    readonly state: ImageEditorState;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    setTool(tool: ImageEditorTool): void;
+    setCrop(crop: CropBox | null, addToHistory?: boolean): void;
+    applyCropPreset(ratio: AspectRatio): void;
+    resetCrop(): void;
+    rotate(degrees: number): void;
+    setRotation(degrees: number): void;
+    flipHorizontal(): void;
+    flipVertical(): void;
+    setAdjustments(partial: Partial<ImageAdjustments>, commitToHistory?: boolean): void;
+    resetAdjustments(): void;
+    setDepthMask(partial: Partial<DepthMaskOptions>): void;
+    resetDepthMask(): void;
+    addAnnotation(ann: CreateAnnotationPayload): string;
+    updateAnnotation(id: string, partial: Partial<Annotation>, commitToHistory?: boolean): void;
+    removeAnnotation(id: string): void;
+    clearAnnotations(): void;
+    selectAnnotation(id: string | null): void;
+    undo(): boolean;
+    redo(): boolean;
+    reset(): void;
+    zoomIn(factor?: number): void;
+    zoomOut(factor?: number): void;
+    resetZoom(): void;
+    setZoom(zoom: number): void;
+    setPan(pan: ImagePoint): void;
+    setComparing(comparing: boolean): void;
+    loadImage(src: string | HTMLImageElement): Promise<void>;
+    toDataURL(opts?: ExportOptions): Promise<string>;
+    toBlob(opts?: ExportOptions): Promise<Blob>;
+    toJSON(): SerializedImageEditorState;
+    loadJSON(data: SerializedImageEditorState): void;
+    renderMask(opts?: {
+        useAnnotations?: boolean;
+        useCrop?: boolean;
+    }): Promise<HTMLCanvasElement>;
+    toMaskDataURL(opts?: {
+        useAnnotations?: boolean;
+        useCrop?: boolean;
+    }): Promise<string>;
+    applyInpaintedImage(newDataUrl: string): Promise<void>;
+    applyBackgroundRemovedImage(newDataUrl: string): Promise<void>;
+};
+export type ReactiveImageEditor = ReturnType<typeof createReactiveImageEditor>;
+//# sourceMappingURL=imageEditorState.svelte.d.ts.map

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

@@ -0,0 +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,kBAAkB,CAAC;AAE1B,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;oCAGpC,MAAM;4CAGE,MAAM;EAIjD;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}