@pixerate/editor 0.157.0 → 0.159.0

package/dist/image-editor/layers/panel.d.cts

@@ -79,3 +79,27 @@ export declare const BIT_DEPTH_OPTIONS: readonly {
     label: string;
     title: string;
 }[];
+export interface NewLayerOption {
+    id: string;
+    label: string;
+    icon: string;
+    group?: string;
+    disabled?: boolean;
+    reason?: string;
+}
+/**
+ * Catalogue of layer types and adjustment layers that can be added dynamically to the controller.
+ */
+export declare function newLayerOptions(_controller: ImageEditorController): NewLayerOption[];
+/**
+ * Adds a new layer of the specified catalogue kind to the controller.
+ */
+export declare function addLayerOfKind(controller: ImageEditorController, id: string, init?: Record<string, unknown>): Promise<string>;
+export interface LayerPanelDescriptor {
+    id: string;
+    title: string;
+}
+/**
+ * Returns contextual panels that apply to the currently active layer (or layer-independent panels if null).
+ */
+export declare function layerPanels(layer: ImageLayer | null): LayerPanelDescriptor[];

package/dist/image-editor/layers/panel.d.ts

@@ -79,3 +79,27 @@ export declare const BIT_DEPTH_OPTIONS: readonly {
     label: string;
     title: string;
 }[];
+export interface NewLayerOption {
+    id: string;
+    label: string;
+    icon: string;
+    group?: string;
+    disabled?: boolean;
+    reason?: string;
+}
+/**
+ * Catalogue of layer types and adjustment layers that can be added dynamically to the controller.
+ */
+export declare function newLayerOptions(_controller: ImageEditorController): NewLayerOption[];
+/**
+ * Adds a new layer of the specified catalogue kind to the controller.
+ */
+export declare function addLayerOfKind(controller: ImageEditorController, id: string, init?: Record<string, unknown>): Promise<string>;
+export interface LayerPanelDescriptor {
+    id: string;
+    title: string;
+}
+/**
+ * Returns contextual panels that apply to the currently active layer (or layer-independent panels if null).
+ */
+export declare function layerPanels(layer: ImageLayer | null): LayerPanelDescriptor[];

package/dist/image-editor/layers/smart.d.cts

@@ -102,6 +102,8 @@ export declare function setSmartPlacement(layers: readonly ImageLayer[], id: str
  * move with it. Without spatial smart filters the rendered pixels are shifted, not resampled.
  */
 export declare function offsetSmartObject(layers: readonly ImageLayer[], id: string, dx: number, dy: number, canvas: SmartCanvas): ImageLayer[];
+/** Moves a layer (and everything in it) by whole pixels, for nesting it in contents. */
+export declare function translateLayer(layer: ImageLayer, dx: number, dy: number): ImageLayer;
 export interface ConvertOptions {
     /** The pixels of a pixel layer (resolves the Background's document source). */
     surfaceOf(layer: PixelLayer): PixelSurface;

package/dist/image-editor/layers/smart.d.ts

@@ -102,6 +102,8 @@ export declare function setSmartPlacement(layers: readonly ImageLayer[], id: str
  * move with it. Without spatial smart filters the rendered pixels are shifted, not resampled.
  */
 export declare function offsetSmartObject(layers: readonly ImageLayer[], id: string, dx: number, dy: number, canvas: SmartCanvas): ImageLayer[];
+/** Moves a layer (and everything in it) by whole pixels, for nesting it in contents. */
+export declare function translateLayer(layer: ImageLayer, dx: number, dy: number): ImageLayer;
 export interface ConvertOptions {
     /** The pixels of a pixel layer (resolves the Background's document source). */
     surfaceOf(layer: PixelLayer): PixelSurface;

package/dist/image-editor/layers/transform-ui.d.cts

@@ -23,7 +23,7 @@ import { type FreeTransformMode, type Quad, type TransformAnchor } from '../tran
 import type { WarpMesh, WarpStyle } from '../../geom/types.cjs';
 import type { Vec2 } from '../../geom/types.cjs';
 import type { Interpolation } from '../../raster/transform.cjs';
-import type { ImagePoint } from '../types.cjs';
+import type { CropBox, ImagePoint } from '../types.cjs';
 import type { ShortcutEvent } from './paint-ui.cjs';
 /** What a pointer is over (`mesh:<index>`: a warp mesh control point). */
 export type TransformHandle = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'reference' | 'inside' | 'outside' | `mesh:${number}`;
@@ -131,6 +131,17 @@ export interface FreeTransformToolOptions {
     /** Called whenever the overlay, readout or error changes. */
     onChange?: () => void;
 }
+/**
+ * A Free Transform frame for a box with no transform open (a host's selected-layer frame): the
+ * outline, the eight handles (none with `handles = false`, e.g. for a layer locked in place) and
+ * the centre as the reference point. Same shape and handle order as `FreeTransformTool.overlay`.
+ */
+export declare function boxFrameOverlay(box: CropBox, handles?: boolean): TransformOverlay;
+/**
+ * What a document point is over on a frame from `boxFrameOverlay`: a handle (within `tolerance`),
+ * `inside`, `outside` within `band` of the outline (where a drag rotates), or `null` beyond that.
+ */
+export declare function boxFrameHit(overlay: TransformOverlay, p: ImagePoint, tolerance: number, band: number): TransformHandle | null;
 /**
  * The interactive Free Transform (see the module comment). `begin` opens a session on the
  * controller; pointer and key methods drive it; `commit` / `cancel` close it.
@@ -161,6 +172,8 @@ export declare class FreeTransformTool {
     get session(): FreeTransformSession | null;
     get mode(): FreeTransformMode;
     get interpolation(): Interpolation;
+    /** Whether the open transform has changed anything yet (a commit would add an undo step). */
+    get modified(): boolean;
     private readonly listeners;
     /** Calls `listener` whenever the overlay, readout, mode or error changes. Returns the unsubscribe. */
     subscribe(listener: () => void): () => void;

package/dist/image-editor/layers/transform-ui.d.ts

@@ -23,7 +23,7 @@ import { type FreeTransformMode, type Quad, type TransformAnchor } from '../tran
 import type { WarpMesh, WarpStyle } from '../../geom/types.js';
 import type { Vec2 } from '../../geom/types.js';
 import type { Interpolation } from '../../raster/transform.js';
-import type { ImagePoint } from '../types.js';
+import type { CropBox, ImagePoint } from '../types.js';
 import type { ShortcutEvent } from './paint-ui.js';
 /** What a pointer is over (`mesh:<index>`: a warp mesh control point). */
 export type TransformHandle = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'reference' | 'inside' | 'outside' | `mesh:${number}`;
@@ -131,6 +131,17 @@ export interface FreeTransformToolOptions {
     /** Called whenever the overlay, readout or error changes. */
     onChange?: () => void;
 }
+/**
+ * A Free Transform frame for a box with no transform open (a host's selected-layer frame): the
+ * outline, the eight handles (none with `handles = false`, e.g. for a layer locked in place) and
+ * the centre as the reference point. Same shape and handle order as `FreeTransformTool.overlay`.
+ */
+export declare function boxFrameOverlay(box: CropBox, handles?: boolean): TransformOverlay;
+/**
+ * What a document point is over on a frame from `boxFrameOverlay`: a handle (within `tolerance`),
+ * `inside`, `outside` within `band` of the outline (where a drag rotates), or `null` beyond that.
+ */
+export declare function boxFrameHit(overlay: TransformOverlay, p: ImagePoint, tolerance: number, band: number): TransformHandle | null;
 /**
  * The interactive Free Transform (see the module comment). `begin` opens a session on the
  * controller; pointer and key methods drive it; `commit` / `cancel` close it.
@@ -161,6 +172,8 @@ export declare class FreeTransformTool {
     get session(): FreeTransformSession | null;
     get mode(): FreeTransformMode;
     get interpolation(): Interpolation;
+    /** Whether the open transform has changed anything yet (a commit would add an undo step). */
+    get modified(): boolean;
     private readonly listeners;
     /** Calls `listener` whenever the overlay, readout, mode or error changes. Returns the unsubscribe. */
     subscribe(listener: () => void): () => void;

package/dist/image-editor/transform.d.cts

@@ -21,6 +21,7 @@ export declare const FREE_TRANSFORM_MODES: readonly FreeTransformMode[];
 /** The nine reference-point positions of the options bar's locator, over the transformed box. */
 export type TransformAnchor = 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right';
 export declare const TRANSFORM_ANCHORS: readonly TransformAnchor[];
+export declare const ANCHOR_FRACTION: Record<TransformAnchor, [number, number]>;
 export declare function isTransformAnchor(value: unknown): value is TransformAnchor;
 /** A transform in progress: the frame, where its corners go and an optional warp over the frame. */
 export interface FreeTransformGeometry {

package/dist/image-editor/transform.d.ts

@@ -21,6 +21,7 @@ export declare const FREE_TRANSFORM_MODES: readonly FreeTransformMode[];
 /** The nine reference-point positions of the options bar's locator, over the transformed box. */
 export type TransformAnchor = 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right';
 export declare const TRANSFORM_ANCHORS: readonly TransformAnchor[];
+export declare const ANCHOR_FRACTION: Record<TransformAnchor, [number, number]>;
 export declare function isTransformAnchor(value: unknown): value is TransformAnchor;
 /** A transform in progress: the frame, where its corners go and an optional warp over the frame. */
 export interface FreeTransformGeometry {

package/dist/paint-editor/index.cjs

@@ -7,7 +7,7 @@ var _chunkVKF3PWKRcjs = require('../chunk-VKF3PWKR.cjs');
 
 
 
-var _chunkCD7PLU77cjs = require('../chunk-CD7PLU77.cjs');
+var _chunk3YDQLQH2cjs = require('../chunk-3YDQLQH2.cjs');
 require('../chunk-A2IS7EHE.cjs');
 
 
@@ -1651,11 +1651,11 @@ function header(state, options) {
   return out;
 }
 function serializePaintDocument(state, options = {}) {
-  const { layers, assets } = _chunkCD7PLU77cjs.serializeLayers.call(void 0, state.layers);
+  const { layers, assets } = _chunk3YDQLQH2cjs.serializeLayers.call(void 0, state.layers);
   return { ...header(state, options), layers, assets };
 }
 async function serializePaintDocumentExternal(state, store, options = {}) {
-  const { layers, assets } = await _chunkCD7PLU77cjs.serializeLayersExternal.call(void 0, state.layers, store);
+  const { layers, assets } = await _chunk3YDQLQH2cjs.serializeLayersExternal.call(void 0, state.layers, store);
   return { ...header(state, options), layers, assets };
 }
 function paintLayersOnly(layers, problems) {
@@ -1692,7 +1692,7 @@ function deserializePaintDocument(raw) {
   const canvas = normalizeCanvas({ width: r.width, height: r.height, dpi: _nullishCoalesce(r.dpi, () => ( void 0)) });
   const paper = _chunkJGKCC5OFcjs.normalizePaper.call(void 0, _nullishCoalesce(r.paper, () => ( {})));
   const assets = r.assets && typeof r.assets === "object" ? r.assets : {};
-  const layers = paintLayersOnly(_chunkCD7PLU77cjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
+  const layers = paintLayersOnly(_chunk3YDQLQH2cjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
   const wanted = typeof r.activeLayerId === "string" ? r.activeLayerId : null;
   const activeLayerId = wanted && _chunkHGTDMKNEcjs.findLayer.call(void 0, layers, wanted) ? wanted : _nullishCoalesce(_optionalChain([_chunkHGTDMKNEcjs.flattenLayers.call(void 0, layers), 'access', _70 => _70.filter, 'call', _71 => _71((l) => l.type === "pixel"), 'access', _72 => _72.pop, 'call', _73 => _73(), 'optionalAccess', _74 => _74.id]), () => ( null));
   const wetEvents = Array.isArray(r.wetEvents) ? r.wetEvents.filter((e) => e && typeof e === "object" && Number.isInteger(e.clock) && typeof e.kind === "string") : [];
@@ -1708,7 +1708,7 @@ async function deserializePaintDocumentAsync(raw, store) {
   if (!raw || typeof raw !== "object") throw new Error("Not a paint document: expected a JSON object.");
   const r = raw;
   const problems = [];
-  const assets = await _chunkCD7PLU77cjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
+  const assets = await _chunk3YDQLQH2cjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
   const loaded = deserializePaintDocument({ ...r, assets });
   return { ...loaded, problems: [...problems, ...loaded.problems] };
 }
@@ -5407,7 +5407,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
       return next.type === "group" ? { ...next, children: toStandard(next.children) } : next;
     });
     const layers = toStandard(dried);
-    const result = _chunkCD7PLU77cjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
+    const result = _chunk3YDQLQH2cjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
     for (const [mode, names] of changed) {
       const label = _nullishCoalesce(_optionalChain([_chunkCWM3CUUXcjs.BLEND_MODES, 'access', _271 => _271.find, 'call', _272 => _272((m) => m.id === mode), 'optionalAccess', _273 => _273.label]), () => ( mode));
       const std = _nullishCoalesce(_optionalChain([_chunkCWM3CUUXcjs.BLEND_MODES, 'access', _274 => _274.find, 'call', _275 => _275((m) => m.id === _chunkCWM3CUUXcjs.standardBlendMode.call(void 0, mode)), 'optionalAccess', _276 => _276.label]), () => ( _chunkCWM3CUUXcjs.standardBlendMode.call(void 0, mode)));

package/dist/paint-editor/index.js

@@ -7,7 +7,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-ZQWLWDZI.js";
+} from "../chunk-72BGL3I2.js";
 import "../chunk-3CI7FRMK.js";
 import {
   EffectRendererPool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.157.0",
+  "version": "0.159.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",