@pixerate/editor 0.146.0 → 0.147.0

package/dist/extensions/index.js

@@ -95,8 +95,7 @@ import {
   updateImageSrc,
   validateFindPattern,
   writeRichClipboard
-} from "../chunk-WBJ6BG4R.js";
-import "../chunk-V5OOP74P.js";
+} from "../chunk-2AQL4JHM.js";
 import {
   DEFAULT_STYLES,
   NORMAL_STYLE_ID,
@@ -105,7 +104,8 @@ import {
   isValidStyleId,
   safeCSSValue
 } from "../chunk-CXXKJBQZ.js";
-import "../chunk-X65C4DWV.js";
+import "../chunk-EQ4SF4X4.js";
+import "../chunk-V5OOP74P.js";
 import {
   ALLOW_NESTED_TABLES_META,
   AgentCaret,
@@ -171,10 +171,10 @@ import {
   tableNestingPluginKey,
   typeAgentText,
   unnestTables
-} from "../chunk-6GAYGQDC.js";
-import "../chunk-KI2VBONS.js";
-import "../chunk-YM75DN54.js";
-import "../chunk-RN767PO6.js";
+} from "../chunk-O5ML2I6O.js";
+import "../chunk-OET45HIR.js";
+import "../chunk-DSZCDNTM.js";
+import "../chunk-SUVZJ2CP.js";
 import "../chunk-ZLZKGHSZ.js";
 import "../chunk-2INPJDNY.js";
 import "../chunk-RTRQ7XFI.js";
@@ -214,6 +214,8 @@ import "../chunk-WJSD3MAZ.js";
 import "../chunk-CIQIM2IP.js";
 import "../chunk-VDGBHYC7.js";
 import "../chunk-RNSANXPT.js";
+import "../chunk-AA34BA7G.js";
+import "../chunk-6ONMQ6WF.js";
 export {
   ALLOW_NESTED_TABLES_META,
   AgentCaret,

package/dist/gradient/controller.d.cts

@@ -0,0 +1,109 @@
+import { HistoryManager } from '../history/HistoryManager.cjs';
+import type { Gradient, GradientInterpolation, GradientShape, GradientStop, GradientType } from './types.cjs';
+export interface GradientControllerOptions {
+    /** Initial gradient value (parsed or object). */
+    value?: unknown;
+    /** History manager to record undo/redo into (creates own if omitted). */
+    history?: HistoryManager;
+    /** Whether the gradient is read-only or a function returning reason/boolean. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** Callback invoked whenever the gradient or selection changes. */
+    onChange?: (gradient: Readonly<Gradient>) => void;
+}
+export interface GradientState {
+    gradient: Readonly<Gradient>;
+    selectedStopId: string | null;
+    canUndo: boolean;
+    canRedo: boolean;
+    undoLabel: string;
+    redoLabel: string;
+    revision: number;
+}
+export type GradientActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+/** The geometry fields `setGeometry` changes; omitted fields stay as they are. */
+export interface GradientGeometryPatch {
+    type?: GradientType;
+    /** Degrees (linear and conic); any finite number, stored modulo 360. */
+    angle?: number;
+    /** 0–1 of the box (radial and conic). */
+    center?: {
+        x: number;
+        y: number;
+    };
+    shape?: GradientShape;
+    interpolation?: GradientInterpolation;
+    repeating?: boolean;
+}
+export declare const GRADIENT_TYPES: readonly GradientType[];
+export declare const GRADIENT_INTERPOLATIONS: readonly GradientInterpolation[];
+export declare class GradientController {
+    private _gradient;
+    private _selectedStopId;
+    private readonly _history;
+    private readonly _readOnlyOption?;
+    private readonly _onChange?;
+    private readonly _listeners;
+    private _gestureKey;
+    private _gestureCount;
+    private _revision;
+    private _cachedState;
+    constructor(options?: GradientControllerOptions);
+    get state(): GradientState;
+    get readOnlyReason(): string | null;
+    get isReadOnly(): boolean;
+    getGradient(): Readonly<Gradient>;
+    getSelectedStopId(): string | null;
+    getSelectedStop(): GradientStop | null;
+    subscribe(fn: (state: GradientState) => void): () => void;
+    /** `changed` is false for view-only updates (selection), which don't call `onChange`. */
+    private _notify;
+    private _checkReadOnly;
+    /** Selects a stop (view state; not an undo step and no `onChange`). Unknown ids are ignored. */
+    selectStop(stopId: string | null): void;
+    beginGesture(label?: string): void;
+    endGesture(): void;
+    private _apply;
+    /** The selected stop after `next` replaces the gradient: same id if it survives, else same index. */
+    private _selectionAfterReplace;
+    setGradient(value: unknown, label?: string): GradientActionResult;
+    /**
+     * Replaces the gradient without an undo step (e.g. syncing a controlled `value` from the
+     * host). Keeps the selection when the stop survives. Notifies subscribers and `onChange`.
+     */
+    load(value: unknown, options?: {
+        clearHistory?: boolean;
+    }): GradientActionResult;
+    /**
+     * Changes any of type, angle, center, shape, interpolation and repeating as one undo step.
+     * Every field is checked before anything changes; an invalid one fails the whole call.
+     */
+    setGeometry(patch: GradientGeometryPatch, label?: string): GradientActionResult;
+    setType(type: GradientType): GradientActionResult;
+    setAngle(angle: number): GradientActionResult;
+    setCenter(center: {
+        x: number;
+        y: number;
+    }): GradientActionResult;
+    setShape(shape: GradientShape): GradientActionResult;
+    setInterpolation(interpolation: GradientInterpolation): GradientActionResult;
+    setRepeating(repeating: boolean): GradientActionResult;
+    addStop(offset: number, color?: string): {
+        ok: true;
+        stop: GradientStop;
+    } | {
+        ok: false;
+        message: string;
+    };
+    updateStop(id: string, patch: Partial<Omit<GradientStop, 'id'>>): GradientActionResult;
+    removeStop(id: string): GradientActionResult;
+    reverse(): GradientActionResult;
+    distribute(): GradientActionResult;
+    undo(): boolean;
+    redo(): boolean;
+    dispose(): void;
+}

package/dist/gradient/controller.d.ts

@@ -0,0 +1,109 @@
+import { HistoryManager } from '../history/HistoryManager.js';
+import type { Gradient, GradientInterpolation, GradientShape, GradientStop, GradientType } from './types.js';
+export interface GradientControllerOptions {
+    /** Initial gradient value (parsed or object). */
+    value?: unknown;
+    /** History manager to record undo/redo into (creates own if omitted). */
+    history?: HistoryManager;
+    /** Whether the gradient is read-only or a function returning reason/boolean. */
+    readOnly?: boolean | string | (() => boolean | string);
+    /** Callback invoked whenever the gradient or selection changes. */
+    onChange?: (gradient: Readonly<Gradient>) => void;
+}
+export interface GradientState {
+    gradient: Readonly<Gradient>;
+    selectedStopId: string | null;
+    canUndo: boolean;
+    canRedo: boolean;
+    undoLabel: string;
+    redoLabel: string;
+    revision: number;
+}
+export type GradientActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+/** The geometry fields `setGeometry` changes; omitted fields stay as they are. */
+export interface GradientGeometryPatch {
+    type?: GradientType;
+    /** Degrees (linear and conic); any finite number, stored modulo 360. */
+    angle?: number;
+    /** 0–1 of the box (radial and conic). */
+    center?: {
+        x: number;
+        y: number;
+    };
+    shape?: GradientShape;
+    interpolation?: GradientInterpolation;
+    repeating?: boolean;
+}
+export declare const GRADIENT_TYPES: readonly GradientType[];
+export declare const GRADIENT_INTERPOLATIONS: readonly GradientInterpolation[];
+export declare class GradientController {
+    private _gradient;
+    private _selectedStopId;
+    private readonly _history;
+    private readonly _readOnlyOption?;
+    private readonly _onChange?;
+    private readonly _listeners;
+    private _gestureKey;
+    private _gestureCount;
+    private _revision;
+    private _cachedState;
+    constructor(options?: GradientControllerOptions);
+    get state(): GradientState;
+    get readOnlyReason(): string | null;
+    get isReadOnly(): boolean;
+    getGradient(): Readonly<Gradient>;
+    getSelectedStopId(): string | null;
+    getSelectedStop(): GradientStop | null;
+    subscribe(fn: (state: GradientState) => void): () => void;
+    /** `changed` is false for view-only updates (selection), which don't call `onChange`. */
+    private _notify;
+    private _checkReadOnly;
+    /** Selects a stop (view state; not an undo step and no `onChange`). Unknown ids are ignored. */
+    selectStop(stopId: string | null): void;
+    beginGesture(label?: string): void;
+    endGesture(): void;
+    private _apply;
+    /** The selected stop after `next` replaces the gradient: same id if it survives, else same index. */
+    private _selectionAfterReplace;
+    setGradient(value: unknown, label?: string): GradientActionResult;
+    /**
+     * Replaces the gradient without an undo step (e.g. syncing a controlled `value` from the
+     * host). Keeps the selection when the stop survives. Notifies subscribers and `onChange`.
+     */
+    load(value: unknown, options?: {
+        clearHistory?: boolean;
+    }): GradientActionResult;
+    /**
+     * Changes any of type, angle, center, shape, interpolation and repeating as one undo step.
+     * Every field is checked before anything changes; an invalid one fails the whole call.
+     */
+    setGeometry(patch: GradientGeometryPatch, label?: string): GradientActionResult;
+    setType(type: GradientType): GradientActionResult;
+    setAngle(angle: number): GradientActionResult;
+    setCenter(center: {
+        x: number;
+        y: number;
+    }): GradientActionResult;
+    setShape(shape: GradientShape): GradientActionResult;
+    setInterpolation(interpolation: GradientInterpolation): GradientActionResult;
+    setRepeating(repeating: boolean): GradientActionResult;
+    addStop(offset: number, color?: string): {
+        ok: true;
+        stop: GradientStop;
+    } | {
+        ok: false;
+        message: string;
+    };
+    updateStop(id: string, patch: Partial<Omit<GradientStop, 'id'>>): GradientActionResult;
+    removeStop(id: string): GradientActionResult;
+    reverse(): GradientActionResult;
+    distribute(): GradientActionResult;
+    undo(): boolean;
+    redo(): boolean;
+    dispose(): void;
+}

package/dist/gradient/editor.d.cts

@@ -0,0 +1,38 @@
+import type { Gradient, GradientStop } from './types.cjs';
+export interface GradientKeyStepResult {
+    stopId?: string;
+    offset?: number;
+    remove?: boolean;
+}
+/**
+ * Returns the stop offset (0..1) corresponding to a track x position (0..1).
+ */
+export declare function stopFromTrackPosition(g: Gradient, x: number): number;
+/**
+ * Returns the track x position (0..1) corresponding to a stop.
+ */
+export declare function trackPositionFromStop(stop: GradientStop): number;
+/**
+ * Handles keyboard navigation on a stop handle.
+ * ArrowLeft / ArrowRight moves by 0.01 (or 0.1 with shiftKey).
+ * Delete / Backspace requests removal (remove: true).
+ * Returns null if the key is unhandled.
+ */
+export declare function gradientKeyStep(g: Gradient, id: string, key: string, shift?: boolean): GradientKeyStepResult | null;
+/**
+ * Calculates angle in degrees (CSS convention: 0 = up, 90 = right, 180 = down, 270 = left)
+ * from a center coordinate to a pointer coordinate.
+ * Optional snapStep snaps to nearest multiple (e.g. 15 deg).
+ */
+export declare function angleFromPointer(center: {
+    x: number;
+    y: number;
+}, point: {
+    x: number;
+    y: number;
+}, snapStep?: number): number;
+/**
+ * Returns a linear 90deg CSS gradient string suitable for rendering the stop track
+ * across the horizontal slider, regardless of the underlying gradient's type.
+ */
+export declare function gradientTrackBackground(g: Gradient): string;

package/dist/gradient/editor.d.ts

@@ -0,0 +1,38 @@
+import type { Gradient, GradientStop } from './types.js';
+export interface GradientKeyStepResult {
+    stopId?: string;
+    offset?: number;
+    remove?: boolean;
+}
+/**
+ * Returns the stop offset (0..1) corresponding to a track x position (0..1).
+ */
+export declare function stopFromTrackPosition(g: Gradient, x: number): number;
+/**
+ * Returns the track x position (0..1) corresponding to a stop.
+ */
+export declare function trackPositionFromStop(stop: GradientStop): number;
+/**
+ * Handles keyboard navigation on a stop handle.
+ * ArrowLeft / ArrowRight moves by 0.01 (or 0.1 with shiftKey).
+ * Delete / Backspace requests removal (remove: true).
+ * Returns null if the key is unhandled.
+ */
+export declare function gradientKeyStep(g: Gradient, id: string, key: string, shift?: boolean): GradientKeyStepResult | null;
+/**
+ * Calculates angle in degrees (CSS convention: 0 = up, 90 = right, 180 = down, 270 = left)
+ * from a center coordinate to a pointer coordinate.
+ * Optional snapStep snaps to nearest multiple (e.g. 15 deg).
+ */
+export declare function angleFromPointer(center: {
+    x: number;
+    y: number;
+}, point: {
+    x: number;
+    y: number;
+}, snapStep?: number): number;
+/**
+ * Returns a linear 90deg CSS gradient string suitable for rendering the stop track
+ * across the horizontal slider, regardless of the underlying gradient's type.
+ */
+export declare function gradientTrackBackground(g: Gradient): string;