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

package/dist/node.d.mts

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

package/dist/node.d.ts

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

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

@@ -11,6 +11,8 @@ interface LayerData {
     opacity: number;
     /** Non-fabric metadata persisted with the layer (pattern config, etc). */
     meta?: LayerMeta;
+    /** Layers nested inside this one. Only a `group` layer has any. */
+    children?: LayerData[];
 }
 interface LayerMeta {
     pattern?: PatternState;
@@ -25,23 +27,51 @@ interface LayerMeta {
     maskStack?: LayerMaskEntry[];
     /** Marks the overlay layer that carries the whole-design mask stack. */
     canvasMask?: boolean;
-    /** Baseline curve applied to a text layer. */
-    curve?: TextCurveConfig;
+    /** Baseline curve applied to a text layer. States saved before the shape
+     *  switch existed carry only `arc`/`wave`; reads normalize them. */
+    curve?: TextCurveInput;
     /** Text box width authored before a curve widened it, in px. */
     curveWidth?: number;
     /** Layer resizes uniformly: single-axis handles are hidden. */
     lockAspect?: boolean;
     [key: string]: unknown;
 }
+/** Shape the baseline follows. The two are alternatives, never combined. */
+type TextCurveShape = 'arc' | 'wave';
 interface TextCurveConfig {
+    /**
+     * Which of the two shapes is live. The parameters of the other one are kept
+     * so switching back and forth does not lose them.
+     */
+    shape: TextCurveShape;
     /**
      * Baseline bend, −100…100. Positive arcs the run upward (a rainbow),
      * negative into a valley; ±100 closes it into a full ring. 0 is straight.
      */
     arc: number;
-    /** Sine-wave amplitude, 0…100, as a share of the font size. Ignored when arced. */
+    /** Sine-wave amplitude, 0…100, as a share of the font size. */
     wave: number;
+    /** Sine-wave period, in font sizes. Lower is a tighter ripple. */
+    waveLength: number;
+    /**
+     * Shift of the run along its baseline, −100…100. On an arc that is a share
+     * of the sweep (±100 walks a closed ring right round); on a wave it is a
+     * share of one wavelength.
+     */
+    offset: number;
+    /**
+     * Pushes the run off the ring it is bent around, −100…100 (±100 halves or
+     * doubles the radius). Arc only: outward flattens the letters, inward curls
+     * them tighter round a smaller circle.
+     */
+    centerOffset: number;
 }
+/**
+ * A curve as authored: every field optional, missing ones fall back to the
+ * defaults. Also the shape older saved states are in — they predate `shape`,
+ * `waveLength` and `offset`.
+ */
+type TextCurveInput = Partial<TextCurveConfig>;
 type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
 type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
 type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
@@ -520,4 +550,4 @@ interface EditorEvents {
     };
 }
 
-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 };
+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 TextCurveInput as a2, type TextCurveShape as a3, type TextureMaskPresetId as a4, type TileMode as a5, type Unit as a6, 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-JP8MZsIs.d.ts → types-LM7pOkkj.d.ts}

@@ -11,6 +11,8 @@ interface LayerData {
     opacity: number;
     /** Non-fabric metadata persisted with the layer (pattern config, etc). */
     meta?: LayerMeta;
+    /** Layers nested inside this one. Only a `group` layer has any. */
+    children?: LayerData[];
 }
 interface LayerMeta {
     pattern?: PatternState;
@@ -25,23 +27,51 @@ interface LayerMeta {
     maskStack?: LayerMaskEntry[];
     /** Marks the overlay layer that carries the whole-design mask stack. */
     canvasMask?: boolean;
-    /** Baseline curve applied to a text layer. */
-    curve?: TextCurveConfig;
+    /** Baseline curve applied to a text layer. States saved before the shape
+     *  switch existed carry only `arc`/`wave`; reads normalize them. */
+    curve?: TextCurveInput;
     /** Text box width authored before a curve widened it, in px. */
     curveWidth?: number;
     /** Layer resizes uniformly: single-axis handles are hidden. */
     lockAspect?: boolean;
     [key: string]: unknown;
 }
+/** Shape the baseline follows. The two are alternatives, never combined. */
+type TextCurveShape = 'arc' | 'wave';
 interface TextCurveConfig {
+    /**
+     * Which of the two shapes is live. The parameters of the other one are kept
+     * so switching back and forth does not lose them.
+     */
+    shape: TextCurveShape;
     /**
      * Baseline bend, −100…100. Positive arcs the run upward (a rainbow),
      * negative into a valley; ±100 closes it into a full ring. 0 is straight.
      */
     arc: number;
-    /** Sine-wave amplitude, 0…100, as a share of the font size. Ignored when arced. */
+    /** Sine-wave amplitude, 0…100, as a share of the font size. */
     wave: number;
+    /** Sine-wave period, in font sizes. Lower is a tighter ripple. */
+    waveLength: number;
+    /**
+     * Shift of the run along its baseline, −100…100. On an arc that is a share
+     * of the sweep (±100 walks a closed ring right round); on a wave it is a
+     * share of one wavelength.
+     */
+    offset: number;
+    /**
+     * Pushes the run off the ring it is bent around, −100…100 (±100 halves or
+     * doubles the radius). Arc only: outward flattens the letters, inward curls
+     * them tighter round a smaller circle.
+     */
+    centerOffset: number;
 }
+/**
+ * A curve as authored: every field optional, missing ones fall back to the
+ * defaults. Also the shape older saved states are in — they predate `shape`,
+ * `waveLength` and `offset`.
+ */
+type TextCurveInput = Partial<TextCurveConfig>;
 type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
 type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
 type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
@@ -520,4 +550,4 @@ interface EditorEvents {
     };
 }
 
-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 };
+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 TextCurveInput as a2, type TextCurveShape as a3, type TextureMaskPresetId as a4, type TileMode as a5, type Unit as a6, 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.5.0",
+  "version": "0.6.0",
   "description": "Abstract pluggable canvas editor built on Fabric.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",