@overtone-art/canvas-editor-core 0.4.0 → 0.5.0

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { c as EditorState } from './types-BNzE_X5M.mjs';
+import { c as EditorState } from './types-JP8MZsIs.mjs';
 import 'fabric';
 
 interface PrintPdfOptions {

package/dist/node.d.ts

@@ -1,4 +1,4 @@
-import { c as EditorState } from './types-BNzE_X5M.js';
+import { c as EditorState } from './types-JP8MZsIs.js';
 import 'fabric';
 
 interface PrintPdfOptions {

package/dist/{types-BNzE_X5M.d.mts → types-JP8MZsIs.d.mts}

@@ -21,6 +21,10 @@ interface LayerMeta {
     };
     /** Preset silhouette or texture the layer is clipped to. */
     maskPreset?: MaskPresetId;
+    /** Ordered mask stack clipping this layer (see `LayerMaskManager`). */
+    maskStack?: LayerMaskEntry[];
+    /** Marks the overlay layer that carries the whole-design mask stack. */
+    canvasMask?: boolean;
     /** Baseline curve applied to a text layer. */
     curve?: TextCurveConfig;
     /** Text box width authored before a curve widened it, in px. */
@@ -41,6 +45,36 @@ interface TextCurveConfig {
 type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
 type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
 type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
+/**
+ * How one mask combines with the masks under it in the stack:
+ *  - `add`       — keeps what it covers, on top of what earlier masks kept (union)
+ *  - `subtract`  — punches its shape out of what earlier masks kept
+ *  - `intersect` — keeps only what it and the earlier masks both cover
+ */
+type LayerMaskMode = 'add' | 'subtract' | 'intersect';
+interface LayerMaskEntry {
+    id: string;
+    name: string;
+    mode: LayerMaskMode;
+    /**
+     * A linked mask follows the host layer's transform; an unlinked one is pinned
+     * to the canvas, so moving the layer slides the artwork under a static mask.
+     * Always false on the whole-design stack, which has no host to follow.
+     */
+    linked: boolean;
+    /** A hidden mask keeps its slot and its geometry, contributing nothing. */
+    visible: boolean;
+    /** 0…1 — a partly transparent mask reveals its area partly. */
+    opacity: number;
+    /**
+     * The mask's transform relative to its host, recorded only while the stack is
+     * composed in canvas space (an unlinked sibling forces that), so a linked mask
+     * can be re-derived after the host moves.
+     */
+    rel?: number[];
+    /** Host data describing where the geometry came from (preset id, generator…). */
+    meta?: Record<string, unknown>;
+}
 interface LayerShadowConfig {
     enabled: boolean;
     color: string;
@@ -433,6 +467,13 @@ interface EditorEvents {
     'layers:changed': {
         layers: LayerData[];
     };
+    'masks:changed': {
+        target: string;
+    };
+    'mask:selected': {
+        target: string | null;
+        maskId: string | null;
+    };
     'selection:changed': {
         selected: string[];
     };
@@ -479,4 +520,4 @@ interface EditorEvents {
     };
 }
 
-export { type TextCurveConfig as $, type MockupOverlay as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupPrintArea as G, type PatternLocks as H, type ImageAdjustments as I, type PatternState as J, type PositioningAdapter as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PrintifyPositioning as O, type PatternConfig as P, type ProjectPage as Q, type ProjectState as R, type ResizeOptions as S, type SemanticExportOptions as T, type SerializedBackgroundImageOptions as U, type SerializedLayer as V, type ShapeMaskPresetId as W, type ShapePlugin as X, type SvgExportOptions as Y, type TemplateDefinition as Z, type TemplateParameter as _, type DpiIssue as a, type TextureMaskPresetId as a0, type TileMode as a1, type Unit as a2, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerShadowConfig as l, type LayerType as m, type LicenseConfig as n, type LicensePayload as o, type LicenseStatus as p, type MaskPoint as q, type MaskPresetId as r, type MaskRefinementPrompt as s, type MaskRefinementProvider as t, type MaskRefinementRequest as u, type MaskRefinementResult as v, type MockupBlendMode as w, type MockupConfig as x, type MockupDisplacement as y, type MockupDisplacementChannel as z };
+export { type TemplateDefinition as $, type MockupDisplacement as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupDisplacementChannel as G, type MockupOverlay as H, type ImageAdjustments as I, type MockupPrintArea as J, type PatternLocks as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PatternState as O, type PatternConfig as P, type PositioningAdapter as Q, type PrintifyPositioning as R, type ProjectPage as S, type ProjectState as T, type ResizeOptions as U, type SemanticExportOptions as V, type SerializedBackgroundImageOptions as W, type SerializedLayer as X, type ShapeMaskPresetId as Y, type ShapePlugin as Z, type SvgExportOptions as _, type DpiIssue as a, type TemplateParameter as a0, type TextCurveConfig as a1, type TextureMaskPresetId as a2, type TileMode as a3, type Unit as a4, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMaskEntry as k, type LayerMaskMode as l, type LayerMeta as m, type LayerShadowConfig as n, type LayerType as o, type LicenseConfig as p, type LicensePayload as q, type LicenseStatus as r, type MaskPoint as s, type MaskPresetId as t, type MaskRefinementPrompt as u, type MaskRefinementProvider as v, type MaskRefinementRequest as w, type MaskRefinementResult as x, type MockupBlendMode as y, type MockupConfig as z };

package/dist/{types-BNzE_X5M.d.ts → types-JP8MZsIs.d.ts}

@@ -21,6 +21,10 @@ interface LayerMeta {
     };
     /** Preset silhouette or texture the layer is clipped to. */
     maskPreset?: MaskPresetId;
+    /** Ordered mask stack clipping this layer (see `LayerMaskManager`). */
+    maskStack?: LayerMaskEntry[];
+    /** Marks the overlay layer that carries the whole-design mask stack. */
+    canvasMask?: boolean;
     /** Baseline curve applied to a text layer. */
     curve?: TextCurveConfig;
     /** Text box width authored before a curve widened it, in px. */
@@ -41,6 +45,36 @@ interface TextCurveConfig {
 type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
 type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
 type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
+/**
+ * How one mask combines with the masks under it in the stack:
+ *  - `add`       — keeps what it covers, on top of what earlier masks kept (union)
+ *  - `subtract`  — punches its shape out of what earlier masks kept
+ *  - `intersect` — keeps only what it and the earlier masks both cover
+ */
+type LayerMaskMode = 'add' | 'subtract' | 'intersect';
+interface LayerMaskEntry {
+    id: string;
+    name: string;
+    mode: LayerMaskMode;
+    /**
+     * A linked mask follows the host layer's transform; an unlinked one is pinned
+     * to the canvas, so moving the layer slides the artwork under a static mask.
+     * Always false on the whole-design stack, which has no host to follow.
+     */
+    linked: boolean;
+    /** A hidden mask keeps its slot and its geometry, contributing nothing. */
+    visible: boolean;
+    /** 0…1 — a partly transparent mask reveals its area partly. */
+    opacity: number;
+    /**
+     * The mask's transform relative to its host, recorded only while the stack is
+     * composed in canvas space (an unlinked sibling forces that), so a linked mask
+     * can be re-derived after the host moves.
+     */
+    rel?: number[];
+    /** Host data describing where the geometry came from (preset id, generator…). */
+    meta?: Record<string, unknown>;
+}
 interface LayerShadowConfig {
     enabled: boolean;
     color: string;
@@ -433,6 +467,13 @@ interface EditorEvents {
     'layers:changed': {
         layers: LayerData[];
     };
+    'masks:changed': {
+        target: string;
+    };
+    'mask:selected': {
+        target: string | null;
+        maskId: string | null;
+    };
     'selection:changed': {
         selected: string[];
     };
@@ -479,4 +520,4 @@ interface EditorEvents {
     };
 }
 
-export { type TextCurveConfig as $, type MockupOverlay as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupPrintArea as G, type PatternLocks as H, type ImageAdjustments as I, type PatternState as J, type PositioningAdapter as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PrintifyPositioning as O, type PatternConfig as P, type ProjectPage as Q, type ProjectState as R, type ResizeOptions as S, type SemanticExportOptions as T, type SerializedBackgroundImageOptions as U, type SerializedLayer as V, type ShapeMaskPresetId as W, type ShapePlugin as X, type SvgExportOptions as Y, type TemplateDefinition as Z, type TemplateParameter as _, type DpiIssue as a, type TextureMaskPresetId as a0, type TileMode as a1, type Unit as a2, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerShadowConfig as l, type LayerType as m, type LicenseConfig as n, type LicensePayload as o, type LicenseStatus as p, type MaskPoint as q, type MaskPresetId as r, type MaskRefinementPrompt as s, type MaskRefinementProvider as t, type MaskRefinementRequest as u, type MaskRefinementResult as v, type MockupBlendMode as w, type MockupConfig as x, type MockupDisplacement as y, type MockupDisplacementChannel as z };
+export { type TemplateDefinition as $, type MockupDisplacement as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupDisplacementChannel as G, type MockupOverlay as H, type ImageAdjustments as I, type MockupPrintArea as J, type PatternLocks as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PatternState as O, type PatternConfig as P, type PositioningAdapter as Q, type PrintifyPositioning as R, type ProjectPage as S, type ProjectState as T, type ResizeOptions as U, type SemanticExportOptions as V, type SerializedBackgroundImageOptions as W, type SerializedLayer as X, type ShapeMaskPresetId as Y, type ShapePlugin as Z, type SvgExportOptions as _, type DpiIssue as a, type TemplateParameter as a0, type TextCurveConfig as a1, type TextureMaskPresetId as a2, type TileMode as a3, type Unit as a4, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMaskEntry as k, type LayerMaskMode as l, type LayerMeta as m, type LayerShadowConfig as n, type LayerType as o, type LicenseConfig as p, type LicensePayload as q, type LicenseStatus as r, type MaskPoint as s, type MaskPresetId as t, type MaskRefinementPrompt as u, type MaskRefinementProvider as v, type MaskRefinementRequest as w, type MaskRefinementResult as x, type MockupBlendMode as y, type MockupConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overtone-art/canvas-editor-core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Abstract pluggable canvas editor built on Fabric.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",