@svgsketch/core 1.4.0 → 1.6.0

package/dist/index.d.mts

@@ -97,12 +97,13 @@ type CycleBehavior = 'restart' | 'alternate';
  * A single keyframe in an animation track.
  *
  * - `time`   — Absolute time in seconds within the track.
- * - `value`  — The property value at this point (number for numeric, string for colors/paths).
+ * - `value`  — The property value at this point (number for numeric, string
+ *   for colors/paths, or a 6-number matrix for `transformMatrix`).
  * - `easing` — The easing curve *leading into* this keyframe (from the previous keyframe).
  */
 interface AnimationKeyframe {
     time: number;
-    value: number | string;
+    value: number | string | number[];
     easing: EasingType;
     /** Custom cubic-bezier control points [x1, y1, x2, y2] when easing is CUSTOM_BEZIER. */
     customBezier?: [number, number, number, number];
@@ -340,7 +341,7 @@ interface SerializedAnimationTimeline {
         calcMode?: 'linear' | 'discrete' | 'paced' | 'spline';
         keyframes: {
             time: number;
-            value: number | string;
+            value: number | string | number[];
             easing: string;
             customBezier?: [number, number, number, number];
             linearPoints?: {
@@ -1532,6 +1533,68 @@ interface Measurement {
     opacity?: number;
 }
 
+/** SVG affine matrix in `[a,b,c,d,e,f]` order. */
+type AffineTransformMatrix = number[];
+/**
+ * Persisted/editor-facing transform state shared by document serialization,
+ * editor shape state, and public plugin geometry types.
+ */
+interface ShapeTransformState {
+    /**
+     * Canonical local affine transform mapping shape-local geometry into the
+     * parent frame. This matrix is the definitive transform state when present.
+     */
+    transformMatrix?: AffineTransformMatrix | null;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    scaleX?: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    scaleY?: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    translateX?: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    translateY?: number;
+    /** @deprecated Legacy text resize anchor; fold into `transformMatrix` on read. */
+    scaleAnchor?: Point | null;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    rotation?: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    skewX?: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    skewY?: number;
+    customPivot?: Point | null;
+    /** @deprecated Use `transformMatrix`; retained only for legacy/source-fidelity imports. */
+    rawTransform?: string;
+    /** @deprecated Legacy v2 import field. Fold into `transformMatrix` on read; never use at runtime. */
+    ancestorTransform?: AffineTransformMatrix;
+}
+declare const SHAPE_TRANSFORM_STATE_KEYS: readonly ["transformMatrix", "scaleX", "scaleY", "translateX", "translateY", "rotation", "skewX", "skewY", "customPivot", "rawTransform"];
+declare const NUMERIC_SHAPE_TRANSFORM_STATE_KEYS: readonly ["transformMatrix", "scaleX", "scaleY", "translateX", "translateY", "rotation", "skewX", "skewY"];
+/**
+ * Runtime scene-node transform state after schema defaults are applied.
+ * Unlike serialized shape state, these properties are always present.
+ */
+interface CommonTransformNodeProps {
+    /**
+     * Canonical local transform matrix in SVG affine order `[a,b,c,d,e,f]`.
+     * This maps shape-local geometry into the parent scene-node frame.
+     */
+    transformMatrix: AffineTransformMatrix | null;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    translateX: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    translateY: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    rotation: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    skewX: number;
+    /** @deprecated Use `transformMatrix`; retained as a decomposed compatibility projection. */
+    skewY: number;
+    customPivot: Point | null;
+    /** @deprecated Use `transformMatrix`; retained only for legacy/source-fidelity imports. */
+    rawTransform: string | null;
+}
+declare const COMMON_TRANSFORM_NODE_DEFAULTS: CommonTransformNodeProps;
+
 /**
  * @svgsketch/core — Serialized document types.
  *
@@ -1540,114 +1603,108 @@ interface Measurement {
  * SVGSketch documents.
  */
 
+type SerializedShapeState = ShapeTransformState & {
+    [key: string]: unknown;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    radius?: number;
+    rx?: number;
+    ry?: number;
+    cornerRadius?: number;
+    cornerShape?: 'round' | 'notch' | 'bevel' | 'scoop';
+    cornerMode?: 'uniform' | 'non-uniform';
+    cornerRadiusTL?: number;
+    cornerRadiusTR?: number;
+    cornerRadiusBL?: number;
+    cornerRadiusBR?: number;
+    cornerShapeTL?: 'round' | 'notch' | 'bevel' | 'scoop';
+    cornerShapeTR?: 'round' | 'notch' | 'bevel' | 'scoop';
+    cornerShapeBL?: 'round' | 'notch' | 'bevel' | 'scoop';
+    cornerShapeBR?: 'round' | 'notch' | 'bevel' | 'scoop';
+    fontSize?: number;
+    text?: string;
+    fontFamily?: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    fontVariant?: string;
+    fontVariantLigatures?: string;
+    fontVariantPosition?: string;
+    fontVariantCaps?: string;
+    fontVariantNumeric?: string;
+    fontVariantEastAsian?: string;
+    textDecoration?: {
+        underline?: boolean;
+        strikethrough?: boolean;
+        overline?: boolean;
+    };
+    textTransform?: string;
+    baselineShift?: string;
+    dominantBaseline?: string;
+    writingMode?: 'horizontal-tb' | 'vertical-rl' | 'vertical-lr';
+    textAnchor?: string;
+    letterSpacing?: number;
+    wordSpacing?: number;
+    lineHeight?: number;
+    inlineSize?: number;
+    overflowWrap?: 'normal' | 'break-word' | 'anywhere';
+    whiteSpace?: 'normal' | 'nowrap' | 'pre' | 'pre-wrap' | 'pre-line' | 'break-spaces';
+    textDirection?: 'ltr' | 'rtl';
+    unicodeBidi?: 'normal' | 'embed' | 'bidi-override' | 'isolate' | 'isolate-override' | 'plaintext';
+    fontVariationSettings?: Record<string, number>;
+    /**
+     * Per-glyph positioning data, mirroring SVG 2 §11.2's five attribute
+     * lists (`x`, `y`, `dx`, `dy`, `rotate`).
+     *
+     *  - `x`/`y` are absolute user coordinates; `null` means "no
+     *    override at this glyph — the cursor advances naturally".
+     *  - `dx`/`dy` are additive shifts on top of natural advance.
+     *  - `rotate` is per-glyph rotation in degrees.
+     *
+     * For backward compatibility, the legacy three-field shape
+     * `{x, y, rotate}` (produced before the spec-aligned model shipped)
+     * is still accepted on read; its `x`/`y` are interpreted as the
+     * additive shifts (`dx`/`dy`).
+     */
+    charOffsets?: ({
+        x: number | null;
+        y: number | null;
+        dx: number;
+        dy: number;
+        rotate: number;
+    } | {
+        x: number;
+        y: number;
+        rotate: number;
+    })[];
+    linePositions?: {
+        x: number;
+        dy: number;
+    }[];
+    textLength?: number;
+    lengthAdjust?: 'spacing' | 'spacingAndGlyphs';
+    /**
+     * Whether this text element uses the rich-text model (styled runs with
+     * per-character formatting) versus the plain-text model. When true,
+     * `richTextData` is the authoritative source for text content and
+     * formatting; when false/absent, `text` is authoritative.
+     */
+    useRichText?: boolean;
+    richTextData?: RichTextData;
+    textX?: number;
+    textY?: number;
+    fillColor?: string;
+    fillOpacity?: number;
+    borderColor?: string;
+    borderWidth?: number | string;
+    strokeOpacity?: number;
+};
 interface SerializedShape {
     id: string;
     /** Shape type identifier. Built-in types: 'circle', 'rectangle', etc. Plugin shapes use custom ids. */
     type: string;
-    state: {
-        x?: number;
-        y?: number;
-        width?: number;
-        height?: number;
-        radius?: number;
-        rx?: number;
-        ry?: number;
-        cornerRadius?: number;
-        cornerShape?: 'round' | 'notch' | 'bevel' | 'scoop';
-        cornerMode?: 'uniform' | 'non-uniform';
-        cornerRadiusTL?: number;
-        cornerRadiusTR?: number;
-        cornerRadiusBL?: number;
-        cornerRadiusBR?: number;
-        cornerShapeTL?: 'round' | 'notch' | 'bevel' | 'scoop';
-        cornerShapeTR?: 'round' | 'notch' | 'bevel' | 'scoop';
-        cornerShapeBL?: 'round' | 'notch' | 'bevel' | 'scoop';
-        cornerShapeBR?: 'round' | 'notch' | 'bevel' | 'scoop';
-        fontSize?: number;
-        text?: string;
-        fontFamily?: string;
-        fontWeight?: string;
-        fontStyle?: string;
-        fontVariant?: string;
-        fontVariantLigatures?: string;
-        fontVariantPosition?: string;
-        fontVariantCaps?: string;
-        fontVariantNumeric?: string;
-        fontVariantEastAsian?: string;
-        textDecoration?: {
-            underline?: boolean;
-            strikethrough?: boolean;
-            overline?: boolean;
-        };
-        textTransform?: string;
-        baselineShift?: string;
-        dominantBaseline?: string;
-        writingMode?: 'horizontal-tb' | 'vertical-rl' | 'vertical-lr';
-        textAnchor?: string;
-        letterSpacing?: number;
-        wordSpacing?: number;
-        lineHeight?: number;
-        inlineSize?: number;
-        overflowWrap?: 'normal' | 'break-word' | 'anywhere';
-        whiteSpace?: 'normal' | 'nowrap' | 'pre' | 'pre-wrap' | 'pre-line' | 'break-spaces';
-        textDirection?: 'ltr' | 'rtl';
-        unicodeBidi?: 'normal' | 'embed' | 'bidi-override' | 'isolate' | 'isolate-override' | 'plaintext';
-        fontVariationSettings?: Record<string, number>;
-        /**
-         * Per-glyph positioning data, mirroring SVG 2 §11.2's five attribute
-         * lists (`x`, `y`, `dx`, `dy`, `rotate`).
-         *
-         *  - `x`/`y` are absolute user coordinates; `null` means "no
-         *    override at this glyph — the cursor advances naturally".
-         *  - `dx`/`dy` are additive shifts on top of natural advance.
-         *  - `rotate` is per-glyph rotation in degrees.
-         *
-         * For backward compatibility, the legacy three-field shape
-         * `{x, y, rotate}` (produced before the spec-aligned model shipped)
-         * is still accepted on read; its `x`/`y` are interpreted as the
-         * additive shifts (`dx`/`dy`).
-         */
-        charOffsets?: ({
-            x: number | null;
-            y: number | null;
-            dx: number;
-            dy: number;
-            rotate: number;
-        } | {
-            x: number;
-            y: number;
-            rotate: number;
-        })[];
-        linePositions?: {
-            x: number;
-            dy: number;
-        }[];
-        textLength?: number;
-        lengthAdjust?: 'spacing' | 'spacingAndGlyphs';
-        /**
-         * Whether this text element uses the rich-text model (styled runs with
-         * per-character formatting) versus the plain-text model. When true,
-         * `richTextData` is the authoritative source for text content and
-         * formatting; when false/absent, `text` is authoritative.
-         */
-        useRichText?: boolean;
-        richTextData?: RichTextData;
-        scaleX?: number;
-        scaleY?: number;
-        translateX?: number;
-        translateY?: number;
-        textX?: number;
-        textY?: number;
-        scaleAnchor?: Point | null;
-        rotation?: number;
-        skewX?: number;
-        skewY?: number;
-        customPivot?: Point | null;
-        fillColor?: string;
-        fillOpacity?: number;
-        borderColor?: string;
-        borderWidth?: number | string;
-        strokeOpacity?: number;
+    state: SerializedShapeState & {
         /**
          * Inherit `fill` from the ancestor cascade rather than emit an explicit
          * attribute. Set at import for shapes inside `<defs>`/`<symbol>` that
@@ -1790,8 +1847,6 @@ interface SerializedShape {
         filterWidth?: string;
         /** @deprecated v2 — see `filterX`. */
         filterHeight?: string;
-        rawTransform?: string;
-        ancestorTransform?: number[];
         pathPoints?: PathPoint[];
         pathCurveType?: PathCurveType;
         pathClosed?: boolean;
@@ -1932,6 +1987,28 @@ interface SerializedShape {
          * rendering tree.
          */
         display?: 'none';
+        /**
+         * Passthrough inline CSS declarations the editor doesn't model as
+         * typed state. Holds CSS Custom Properties (`--foo`, CSS Variables 1
+         * §2 — scoped vars cascading to descendants via `var()` references)
+         * and vendor-prefixed CSS (`-inkscape-*`, `-webkit-*`, …) authored
+         * directly on the source element's `style="…"` attribute.
+         *
+         * Round-trip mechanism (`applyPresentationEntry` / `clearPresentationEntry`
+         * in `apps/editor/src/canvas/import-export/ie-shared.ts`):
+         *  - Custom properties live on `el.style` via `setProperty`; browsers
+         *    cascade them natively.
+         *  - Vendor prefixes live in an editor-internal
+         *    `data-svgsketch-vendor-css` attribute (CSSOM `setProperty` drops
+         *    unknown vendor names per CSSOM §6.3.6 step 1); export merges
+         *    them into the visible `style="…"` attribute on serialize.
+         *
+         * Editor-modeled CSS (`fill`, `stroke`, `font-*`, `mix-blend-mode`,
+         * `mask`, etc.) is captured into the dedicated typed slots above and
+         * does NOT appear in this map — keeps a single source of truth per
+         * declaration and avoids round-trip drift.
+         */
+        inlineStyle?: Record<string, string>;
         metadata?: Partial<ShapeMetadata>;
         /**
          * Shape-scoped `<script>` elements (SVG 2 §15.9 allows scripts as
@@ -2111,6 +2188,26 @@ interface SerializedShape {
     };
 }
 type SerializedViewbox = Viewbox;
+/**
+ * Scene-graph placement for a node in the document tree.
+ *
+ * This is intentionally independent of SVG DOM serialization: `parentId`
+ * identifies the scene parent (`null` means the document root) and `index`
+ * is the sibling slot inside that parent.
+ */
+interface SerializedSceneNodePlacement {
+    id: string;
+    parentId: string | null;
+    index: number;
+    updatedAt?: number;
+    clientId?: string;
+}
+interface SerializedPaintServerDef {
+    id: string;
+    type: 'mask' | 'clipPath' | 'filter' | 'linearGradient' | 'radialGradient' | 'pattern' | 'symbol';
+    /** Serialized SVG element markup for this def. */
+    markup: string;
+}
 /**
  * Schema version for the HistorySnapshot format.
  *
@@ -2132,7 +2229,7 @@ type SerializedViewbox = Viewbox;
  *      (version - 1) snapshots into the new format.
  *   c. Register it in the migrateSnapshot() chain.
  */
-declare const CURRENT_SCHEMA_VERSION = 2;
+declare const CURRENT_SCHEMA_VERSION = 4;
 interface HistorySnapshot {
     /**
      * Schema version — written on save, read on load to trigger migrations.
@@ -2143,6 +2240,12 @@ interface HistorySnapshot {
     viewboxes: SerializedViewbox[];
     guides?: Guide[];
     measurements?: Measurement[];
+    /**
+     * Canonical scene-graph hierarchy/order. Optional for backward
+     * compatibility with older snapshots that encoded structure only through
+     * container-owned `state.children` and legacy group side channels.
+     */
+    sceneTree?: SerializedSceneNodePlacement[];
     /** Group structure: array of group IDs with their parent group ID (null for top-level) */
     groups?: SerializedGroup[];
     /** Clip/mask group structure for undo/redo support */
@@ -2181,6 +2284,12 @@ interface HistorySnapshot {
      * `innerHTML`-append into editor defs on restore.
      */
     rawPaintServerDefs?: string[];
+    /**
+     * Typed paint-server/defs fragments that are not yet represented by the
+     * structured `library` records. This supersedes `rawPaintServerDefs` for
+     * new writers while the legacy string array remains for older clients.
+     */
+    paintServerDefs?: SerializedPaintServerDef[];
     /** @deprecated v2 — use `library`. Read-only: v1 docs migrate into `library`. */
     customPatterns?: CustomPatternDef[];
     /** @deprecated v2 — use `library`. Read-only: v1 docs migrate into `library`. */
@@ -2483,7 +2592,14 @@ interface SymbolLibraryDef extends LibraryDefBase {
  */
 interface MarkerLibraryDef extends LibraryDefBase {
     kind: 'marker';
-    viewBox: string;
+    /**
+     * SVG 2 §11.6: when omitted, marker contents render directly in the
+     * viewport coordinate system (scaled by markerUnits) rather than being
+     * mapped from viewBox space to the markerWidth × markerHeight viewport.
+     * Editor-authored markers always set this; imported markers preserve
+     * "no viewBox" when the source `<marker>` had none.
+     */
+    viewBox?: string;
     /** X reference point — where the marker's tip aligns with the host vertex. */
     refX: number;
     refY: number;
@@ -2499,6 +2615,12 @@ interface MarkerLibraryDef extends LibraryDefBase {
      * start marker; a number is a fixed rotation in degrees.
      */
     orient: 'auto' | 'auto-start-reverse' | number;
+    /**
+     * SVG 2 §11.6: `'visible'` allows content to render past the
+     * markerWidth × markerHeight viewport (default is `'hidden'`). Captured
+     * from the source `overflow` attr; emitted only when explicitly set.
+     */
+    overflow?: 'visible' | 'hidden';
     /**
      * Inner geometry (authoritative for user markers). Built-ins render from
      * the descriptor registry and carry `shapes: []`.
@@ -2582,19 +2704,13 @@ type LibraryDefOfKind<K extends LibraryKind> = Extract<LibraryDef, {
  * - Serialization format for the `.svgs` document format
  */
 
-interface CommonNodeProps {
+interface CommonNodeProps extends CommonTransformNodeProps {
     fillColor: string;
     borderColor: string;
     borderWidth: number;
     opacity: number;
     fillOpacity: number;
     strokeOpacity: number;
-    translateX: number;
-    translateY: number;
-    rotation: number;
-    skewX: number;
-    skewY: number;
-    customPivot: Point | null;
     locked: boolean;
     visible: boolean;
     fillType: string;
@@ -2619,8 +2735,6 @@ interface CommonNodeProps {
     filterY: string | null;
     filterWidth: string | null;
     filterHeight: string | null;
-    rawTransform: string | null;
-    ancestorTransform: number[] | null;
     metadata: unknown | null;
     cssClipPath: string | null;
     cssMaskProperties: Record<string, string> | null;
@@ -2701,6 +2815,7 @@ interface TextNodeProps extends CommonNodeProps {
     unicodeBidi: string;
     scaleX: number;
     scaleY: number;
+    /** @deprecated Runtime-only legacy text anchor; persisted transforms use transformMatrix. */
     scaleAnchor: Point | null;
     useRichText: boolean;
     richTextData: unknown | null;
@@ -3190,6 +3305,33 @@ declare function roundSerializedShape(shape: SerializedShape, precision: number)
  */
 declare function roundSnapshot(snapshot: HistorySnapshot, precision: number): HistorySnapshot;
 
+type Affine2D = readonly [number, number, number, number, number, number];
+declare const IDENTITY_AFFINE: Affine2D;
+declare function affine(a: number, b: number, c: number, d: number, e: number, f: number): Affine2D;
+declare function affineFromArray(m: readonly number[]): Affine2D;
+declare function affineToArray(m: Affine2D): number[];
+declare function isFiniteAffineArray(m: unknown): m is readonly number[];
+declare function isIdentityAffine(m: readonly number[], epsilon?: number): boolean;
+declare function multiplyAffine(parent: Affine2D, child: Affine2D): Affine2D;
+declare function translateAffine(tx: number, ty?: number): Affine2D;
+declare function scaleAffine(sx: number, sy?: number): Affine2D;
+declare function rotateAffine(angleDeg: number): Affine2D;
+declare function skewXAffine(angleDeg: number): Affine2D;
+declare function skewYAffine(angleDeg: number): Affine2D;
+declare function around(origin: Point, operation: Affine2D): Affine2D;
+declare function parseSvgTransformList(transform: string): Affine2D;
+declare function matrixTransformPart(matrix: readonly number[] | null | undefined): string | null;
+declare function composeLegacyTransformMatrix(state: Record<string, unknown>, defaultPivot?: Point): Affine2D;
+declare function canonicalTransformString(state: Record<string, unknown>, defaultPivot?: Point): string | null;
+/**
+ * Compatibility normalizer for documents that still carry the pre-v3
+ * `ancestorTransform` field. The legacy ancestor matrix is composed as the
+ * outer transform and then removed so runtime/editor code only sees the
+ * canonical local `transformMatrix`.
+ */
+declare function foldLegacyAncestorTransformIntoMatrix(state: Record<string, unknown>, defaultPivot?: Point): void;
+declare function canonicalPolygonTransformString(state: Record<string, unknown>, cx: number, cy: number): string;
+
 /**
  * Document-level SVG renderer.
  *
@@ -3570,7 +3712,7 @@ declare function getBuiltInMarkerDefs(): SerializedMarkerDef[];
  *
  * Produces:
  *   - `<animate>` for numeric and color properties
- *   - `<animateTransform>` for rotation, skewX, skewY
+ *   - `<animateTransform>` for transformMatrix, rotation, skewX, skewY
  *   - `<animateMotion>` for path-based motion
  *   - `<discard>` for remove-at-time tracks
  *
@@ -4045,6 +4187,10 @@ declare abstract class ShapeBuilder<T extends ShapeBuilder<T>> {
     scale(x: number, y?: number): T;
     /** Set a custom pivot point for transforms. */
     pivot(x: number, y: number): T;
+    /** Set the canonical local affine transform matrix directly. */
+    transformMatrix(matrix: readonly [number, number, number, number, number, number] | number[]): T;
+    private refreshTransformMatrix;
+    private defaultTransformPivot;
     /** Add one or more filters to the shape. */
     filter(...filters: ShapeFilter[]): T;
     /** Add a drop shadow filter. */
@@ -4599,8 +4745,18 @@ declare class View extends ShapeBuilder<View> {
     zoomAndPan(value: 'disable' | 'magnify'): View;
     /** SVG `viewTarget` attribute. */
     viewTarget(value: string): View;
-    /** Mark this view as the canonical "home" view of the document. */
-    asHome(value?: boolean): View;
+    /**
+     * No-op kept for backwards compatibility with existing call sites.
+     * The "home view" abstraction was retired — the document's framing
+     * is owned by the root `<svg>` element (via the SDK's `Document`
+     * width/height/viewBox), not by a `<view>` element flagged as
+     * "home." `<view>` is reserved for author-authored named viewports
+     * (SVG 2 §16.3.3).
+     *
+     * @deprecated v3 — pass `width`/`height`/`viewBox` to `Document`
+     *             instead. This shim will be removed in a future major.
+     */
+    asHome(_value?: boolean): View;
 }
 declare class NestedSvg extends ContainerShapeBuilder<NestedSvg> {
     constructor(x?: number, y?: number, width?: number, height?: number);
@@ -4766,11 +4922,11 @@ declare class Track {
      * Add a keyframe at the given time.
      *
      * @param time   - Time in seconds from the start of the track.
-     * @param value  - The property value at this time (number or color string).
+     * @param value  - The property value at this time.
      * @param easing - Easing curve leading *into* this keyframe.
      *                 Defaults to LINEAR.
      */
-    keyframe(time: number, value: number | string, easing?: EasingType): Track;
+    keyframe(time: number, value: number | string | number[], easing?: EasingType): Track;
     /**
      * Add a keyframe with a custom cubic-bezier easing.
      *
@@ -4778,7 +4934,7 @@ declare class Track {
      * @param value  - The property value.
      * @param points - Cubic-bezier control points [x1, y1, x2, y2].
      */
-    keyframeBezier(time: number, value: number | string, points: [number, number, number, number]): Track;
+    keyframeBezier(time: number, value: number | string | number[], points: [number, number, number, number]): Track;
     /**
      * Add a keyframe with a CSS linear() easing function.
      *
@@ -4786,7 +4942,7 @@ declare class Track {
      * @param value        - The property value.
      * @param linearPoints - Control points for the piecewise linear function.
      */
-    keyframeLinear(time: number, value: number | string, linearPoints: LinearEasingPoint[]): Track;
+    keyframeLinear(time: number, value: number | string | number[], linearPoints: LinearEasingPoint[]): Track;
     /** Add multiple keyframes at once. */
     keyframes(...kfs: AnimationKeyframe[]): Track;
     /** Disable this track (excluded from playback/export). */
@@ -5438,4 +5594,4 @@ declare function solveSudoku(grid: SudokuGrid, options?: SolveSudokuOptions): Su
 declare function validateSudokuPuzzle(grid: SudokuGrid): SudokuValidationResult;
 declare function generateSudokuPuzzle(options: GenerateSudokuOptions): GeneratedSudokuPuzzle;
 
-export { type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, Audio, BUILTIN_MARKER_ID_MAP, type BaseFilter, type BaseFilterPrimitive, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, Cloud, type CodeFormat, type CodegenOptions, type CommonNodeProps, type ConnectionDirection, type ConnectionPoint, Container, ContainerShapeBuilder, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, DEFAULT_COORDINATE_PRECISION, type DiffuseLightingFilter, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DocumentScript, type DocumentStyle, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FeBlendPrimitive, type FeColorMatrixPrimitive, type FeComponentTransferPrimitive, type FeCompositePrimitive, type FeConvolveMatrixPrimitive, type FeDiffuseLightingPrimitive, type FeDisplacementMapPrimitive, type FeDropShadowPrimitive, type FeFloodPrimitive, type FeGaussianBlurPrimitive, type FeImagePrimitive, type FeMergePrimitive, type FeMorphologyPrimitive, type FeOffsetPrimitive, type FeSpecularLightingPrimitive, type FeTilePrimitive, type FeTurbulencePrimitive, type FillType, type FilmGrainFilter, type FilterBlendMode, type FilterLibraryDef, type FilterLightSource, type FilterPrimitive, type FilterPrimitiveType, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GenerateSudokuOptions, type GeneratedSudokuPuzzle, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GrayscaleFilter, type GroupNodeProps, type Guide, Heart, type HistorySnapshot, type HueRotateFilter, Hyperlink, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, LIBRARY_EMIT_ORDER, type LibraryDef, type LibraryDefBase, type LibraryDefOfKind, type LibraryKind, type LicenseType, type LightSource, Lightning, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinearGradientLibraryDef, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MAX_COORDINATE_PRECISION, MIGRATIONS, type MarkerDescriptor, type MarkerLibraryDef, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, NestedSvg, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, PUZZLE_DEFAULTS, type ParseOptions, Path, PathCurveType, type PathNodeProps, type PathPoint, PathPointType, PatternBuilder, type PatternElement, type PatternFill, type PatternLibraryDef, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type PuzzleBounds, type PuzzleOptions, type PuzzlePiece, type PuzzleStyle, type PuzzleTabPattern, type RadialGradient, RadialGradientBuilder, type RadialGradientLibraryDef, type RawSvgFilter, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedColorGlyph, type SerializedColorGlyphLibrary, type SerializedGroup, type SerializedMarkerDef, type SerializedShape, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, ShapeReference, type SharpenFilter, type SolveSudokuOptions, type SpecularLightingFilter, SpeechBubble, Spiral, type SpiralNodeProps, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type SudokuDifficulty, type SudokuGrid, type SudokuRating, type SudokuValidationResult, type SvgPrimitiveChainFilter, Switch, type SymbolInstanceNodeProps, type SymbolLibraryDef, type TemplateVariable, type TemplateVariableMode, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, type TransferFunc, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, Video, View, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, collectReferencedLibraryIds, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, defaultVariableMode, escXml, extractVariables, filterAttr, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generatePuzzlePieces, generateReactCode, generateSudokuPuzzle, generateSvgCode, generateVueCode, getBuiltInMarkerDefs, getEasingCubicBezier, getEffectivePrecision, getMarkerDescriptors, getPatternElements, linearGradient, migrateSnapshot, parseDocument, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderBuiltinMarkerDefs, renderCircle, renderEllipse, renderFilterDefs, renderFilterLibraryDef, renderFilterPrimitive, renderFilterPrimitivesForType, renderImage, renderLibraryDef, renderLibraryDefs, renderLine, renderLinearGradientLibraryDef, renderMarkerLibraryDef, renderPatternLibraryDef, renderPolygonShape, renderPolyline, renderRadialGradientLibraryDef, renderRectangle, renderReferencedLibraryDefs, renderShape, renderSpline, renderSvgPrimitiveChainFilter, renderSymbolLibraryDef, renderText, renderToSvg, roundCoord, roundNumberString, roundSerializedShape, roundSnapshot, solveSudoku, stringifyDocument, substituteString, substituteVariables, validateSnapshot, validateSudokuPuzzle, verticesToPath };
+export { type Affine2D, type AffineTransformMatrix, type AnimatablePropertyDescriptor, type AnimationKeyframe, type AnimationTimeline, type AnimationTrack, type AnimationTrigger, type AnimationTriggerType, type AnyNodeProps, type ArcParams$1 as ArcParams, type AriaRole, Arrow, type ArrowNodeProps, Audio, BUILTIN_MARKER_ID_MAP, type BaseFilter, type BaseFilterPrimitive, type BlackAndWhiteFilter, type BlurQuality, type BrightnessFilter, COMMON_TRANSFORM_NODE_DEFAULTS, CURRENT_SCHEMA_VERSION, type ChannelPainterFilter, Circle, type CircleNodeProps, Cloud, type CodeFormat, type CodegenOptions, type CommonNodeProps, type CommonTransformNodeProps, type ConnectionDirection, type ConnectionPoint, Container, ContainerShapeBuilder, type ContouringDiscreteFilter, type ContouringTableFilter, type ContrastFilter, type CornerShapeValue, type CreateDocumentOptions, type CreateShapeOptions, Cross, type CrossNodeProps, type CrumpledPlasticFilter, type CustomPatternDef, type CycleBehavior, DEFAULT_COORDINATE_PRECISION, type DiffuseLightingFilter, Document, type DocumentMetadata, type DocumentNodeProps, type DocumentOptions, type DocumentScript, type DocumentStyle, type DropShadowFilter, type DuotoneFilter, EASING_CURVES, EVENT_TRIGGER_OPTIONS, EasingType, Ellipse, type EllipseNodeProps, type EmbossFilter, type ExtractedVariables, type FeBlendPrimitive, type FeColorMatrixPrimitive, type FeComponentTransferPrimitive, type FeCompositePrimitive, type FeConvolveMatrixPrimitive, type FeDiffuseLightingPrimitive, type FeDisplacementMapPrimitive, type FeDropShadowPrimitive, type FeFloodPrimitive, type FeGaussianBlurPrimitive, type FeImagePrimitive, type FeMergePrimitive, type FeMorphologyPrimitive, type FeOffsetPrimitive, type FeSpecularLightingPrimitive, type FeTilePrimitive, type FeTurbulencePrimitive, type FillType, type FilmGrainFilter, type FilterBlendMode, type FilterLibraryDef, type FilterLightSource, type FilterPrimitive, type FilterPrimitiveType, type FilterType, type GaussianBlurFilter, Gear, type GearNodeProps, type GenerateSudokuOptions, type GeneratedSudokuPuzzle, type GlowFilter, type GouacheFilter, type GradientDefinition, type GradientSpreadMethod, type GradientStop, type GradientUnits, type GrayscaleFilter, type GroupNodeProps, type Guide, Heart, type HistorySnapshot, type HueRotateFilter, Hyperlink, IDENTITY_AFFINE, type ImageAttribution, type ImageNodeProps, ImageShape, type InkBlotFilter, type InnerGlowFilter, type InnerShadowFilter, type InvertFilter, LIBRARY_EMIT_ORDER, type LibraryDef, type LibraryDefBase, type LibraryDefOfKind, type LibraryKind, type LicenseType, type LightSource, Lightning, Line, type LineEndpointValue, type LineNodeProps, type LinearEasingPoint, type LinearGradient, LinearGradientBuilder, type LinearGradientLibraryDef, type LinkTarget, MARKER_HEIGHT, MARKER_VIEWBOX, MARKER_WIDTH, MAX_COORDINATE_PRECISION, MIGRATIONS, type MarkerDescriptor, type MarkerLibraryDef, type Measurement, type Migration, type MorphologyFilter, type MorphologyOperator, type MotionBlurFilter, NGon, type NGonNodeProps, NUMERIC_SHAPE_TRANSFORM_STATE_KEYS, NestedSvg, type NodeTypePropsMap, type NoiseFilter, type OpacityFilter, type OutlineFilter, type OutlinePosition, PUZZLE_DEFAULTS, type ParseOptions, Path, PathCurveType, type PathNodeProps, type PathPoint, PathPointType, PatternBuilder, type PatternElement, type PatternFill, type PatternLibraryDef, type PatternParams, type PatternSvgContentResult, type PatternType, type PixelateFilter, type Point, type PointLightFilter, type PolygonBaseNodeProps, Polyline, type PolylineNodeProps, type PuzzleBounds, type PuzzleOptions, type PuzzlePiece, type PuzzleStyle, type PuzzleTabPattern, type RadialGradient, RadialGradientBuilder, type RadialGradientLibraryDef, type RawSvgFilter, Rectangle, type RectangleNodeProps, type RenderOptions, type RichTextData, type RichTextLine, type RichTextSegment, type RichTextSegmentStyle, type RiddledFilter, Ring, type RingNodeProps, type RoundEdgesFilter, SHAPE_TRANSFORM_STATE_KEYS, type SaturateFilter, type SegmentCurveType, type SepiaFilter, type SerializedAnimationTimeline, type SerializedClipMaskGroup, type SerializedColorGlyph, type SerializedColorGlyphLibrary, type SerializedGroup, type SerializedMarkerDef, type SerializedPaintServerDef, type SerializedSceneNodePlacement, type SerializedShape, type SerializedShapeState, type SerializedSymbolDef, type SerializedVariantAxis, type SerializedViewbox, ShapeBuilder, type ShapeFilter, type ShapeMetadata, ShapeReference, type ShapeTransformState, type SharpenFilter, type SolveSudokuOptions, type SpecularLightingFilter, SpeechBubble, Spiral, type SpiralNodeProps, type SpotLightFilter, Square, type SquareNodeProps, Star, type StarNodeProps, type StepPosition, type StepsParams, type StringifyOptions, type StrokeType, type SudokuDifficulty, type SudokuGrid, type SudokuRating, type SudokuValidationResult, type SvgPrimitiveChainFilter, Switch, type SymbolInstanceNodeProps, type SymbolLibraryDef, type TemplateVariable, type TemplateVariableMode, type TemplateVariableSource, type TemplateVariableType, Text, type TextNodeProps, Timeline, Track, type TransferFunc, Triangle, type TriangleNodeProps, type ValidationError, type ValidationResult, type VariableMap, Video, View, type Viewbox, type WarpFilter, type WarpType, type WatercolorFilter, type XrayFilter, affine, affineFromArray, affineToArray, around, canonicalPolygonTransformString, canonicalTransformString, collectReferencedLibraryIds, composeLegacyTransformMatrix, computeArrowVertices, computeCloudPath, computeCrossVertices, computeDashArray, computeGearPath, computeGearVertices, computeHeartPath, computeLightningVertices, computePolygonVertices, computeRectanglePath, computeRingPath, computeSpeechBubbleVertices, computeSpiralPath, computeSplinePath, computeStarVertices, createDocument, createShape, createViewbox, defaultVariableMode, escXml, extractVariables, filterAttr, foldLegacyAncestorTransformIntoMatrix, generateCode, generateCssCode, generateD3Code, generateId, generatePatternSvgContent, generatePuzzlePieces, generateReactCode, generateSudokuPuzzle, generateSvgCode, generateVueCode, getBuiltInMarkerDefs, getEasingCubicBezier, getEffectivePrecision, getMarkerDescriptors, getPatternElements, isFiniteAffineArray, isIdentityAffine, linearGradient, matrixTransformPart, migrateSnapshot, multiplyAffine, parseDocument, parseSvgTransformList, parseVariableArgs, pattern, radialGradient, renderAnimationElements, renderBuiltinMarkerDefs, renderCircle, renderEllipse, renderFilterDefs, renderFilterLibraryDef, renderFilterPrimitive, renderFilterPrimitivesForType, renderImage, renderLibraryDef, renderLibraryDefs, renderLine, renderLinearGradientLibraryDef, renderMarkerLibraryDef, renderPatternLibraryDef, renderPolygonShape, renderPolyline, renderRadialGradientLibraryDef, renderRectangle, renderReferencedLibraryDefs, renderShape, renderSpline, renderSvgPrimitiveChainFilter, renderSymbolLibraryDef, renderText, renderToSvg, rotateAffine, roundCoord, roundNumberString, roundSerializedShape, roundSnapshot, scaleAffine, skewXAffine, skewYAffine, solveSudoku, stringifyDocument, substituteString, substituteVariables, translateAffine, validateSnapshot, validateSudokuPuzzle, verticesToPath };