@pixerate/editor 0.36.0 → 0.37.0

package/dist/vector/index.d.cts

@@ -1,4 +1,4 @@
-import { C as CanvasGradientDef, A as AffineMatrix, B as BezierPathInput, a as BezierPath, S as SvgGradientDef } from '../bezier-D8bsO-L0.cjs';
+import { C as CanvasGradientDef, A as AffineMatrix, B as BezierPathInput, a as BezierPath, S as SvgGradientDef, b as StrokeJoin, c as StrokeCap } from '../stroke-CWjFKal4.cjs';
 import { P as Point } from '../types-BFkYA4eF.cjs';
 import { H as HistoryManager } from '../HistoryManager-DeQQMBCj.cjs';
 import { C as CommandSpec } from '../registry-D0GADKc7.cjs';
@@ -75,6 +75,17 @@ declare const VECTOR_ARROWHEADS: readonly VectorArrowhead[];
  * tip sits on the end point and the stroke is shortened under the head.
  */
 type VectorArrowAlign = 'extend' | 'tip';
+/**
+ * One point of a variable-width stroke profile. `t` is the position along the subpath by
+ * length (0 at its start, 1 at its end); `left` and `right` are how far the stroke reaches on
+ * each side, as multiples of half the stroke width (looking along the path on screen, y down).
+ * A uniform stroke has 1 on both sides. Two points at the same `t` make a step.
+ */
+interface VectorWidthPoint {
+    t: number;
+    left: number;
+    right: number;
+}
 /** Paint and stroke settings of a path. */
 interface VectorStyle {
     fill?: VectorPaint;
@@ -98,6 +109,12 @@ interface VectorStyle {
     startArrowScale?: number;
     /** Size of the end head (default 1). */
     endArrowScale?: number;
+    /**
+     * Variable width: side scales along each subpath, interpolated with a monotone cubic (see
+     * `widthProfileAt`). Absent, empty or `null` strokes at a uniform width. A profiled stroke is
+     * drawn as its filled outline.
+     */
+    strokeWidthProfile?: VectorWidthPoint[] | null;
 }
 interface VectorNodeBase {
     id: string;
@@ -154,10 +171,10 @@ interface VectorHandleRef extends VectorAnchorRef {
 }
 /**
  * Canvas tools. `direct` edits anchors, handles and segments; the shape tools drag out a new
- * shape; `scissors` cuts a path at a point, `knife` cuts filled shapes along a freehand stroke
- * and `eraser` rubs out the area under one.
+ * shape; `scissors` cuts a path at a point, `knife` cuts filled shapes along a freehand stroke,
+ * `eraser` rubs out the area under one and `width` drags a stroke's width at a point.
  */
-type VectorTool = 'select' | 'direct' | 'pen' | 'pencil' | 'rect' | 'ellipse' | 'polygon' | 'star' | 'line' | 'scissors' | 'knife' | 'eraser';
+type VectorTool = 'select' | 'direct' | 'pen' | 'pencil' | 'rect' | 'ellipse' | 'polygon' | 'star' | 'line' | 'scissors' | 'knife' | 'eraser' | 'width';
 declare const VECTOR_TOOLS: readonly VectorTool[];
 /** Keyboard modifiers held during a pointer event. */
 interface VectorModifiers {
@@ -408,6 +425,11 @@ interface VectorRenderStrokeParts {
     d: string;
     /** Width to draw it with: twice the stroke width when aligned, half of it being clipped away. */
     width: number;
+    /**
+     * A variable-width stroke: the area to fill with `stroke` (nonzero) instead of stroking `d`,
+     * clipped or masked like the stroke would be.
+     */
+    outline?: string;
     /**
      * Inside: a `<clipPath id>` holding the shape (`d`, `clip-rule` = `fillRule`). Outside: a
      * `<mask id>` in user space over `bounds`, white with the shape (`d`) in black.
@@ -422,6 +444,10 @@ interface VectorRenderStrokeParts {
 }
 /** The stroke parts of a path whose stroke needs more than one element, in its own space (undefined otherwise). */
 declare function vectorStrokeSvgParts(node: VectorPathNode, clipId: string, precision?: number): VectorRenderStrokeParts | undefined;
+/** A width profile as a data attribute: `t,left,right` points separated by `;`. */
+declare function widthProfileToAttribute(points: readonly VectorWidthPoint[], precision?: number): string;
+/** Reads `widthProfileToAttribute` output (invalid points are dropped). */
+declare function widthProfileFromAttribute(value: string | undefined): VectorWidthPoint[];
 /** Serializes a vector document as a standalone SVG string. */
 declare function vectorDocumentToSvg(doc: VectorDocument, options?: VectorSvgExportOptions): string;
 interface VectorSvgImportOptions {
@@ -491,6 +517,136 @@ declare function nextVectorCornerKind(kind: VectorCornerKind | undefined): Vecto
 /** Every anchor of a subpath given the same live corner (radius 0 clears them). */
 declare function setSubpathCorners(sp: VectorSubpath, radius: number, kind?: VectorCornerKind): VectorSubpath;
 
+/**
+ * Variable-width stroke profiles: stroke widths at positions along a path (each subpath on its
+ * own), interpolated smoothly and held flat before the first and after the last point. Each
+ * point has a left and a right side scale (looking along the path on screen, y down), so a
+ * stroke can grow on one side only.
+ *
+ * Ported from ArtCraft (MIT OR Apache-2.0, see THIRD_PARTY_NOTICES.md):
+ * - figcraft `crates/doc/src/props.rs` — `WidthProfile` / `WidthPoint`: sanitising, side
+ *   scales, inserting and moving points, and the monotone cubic (Fritsch–Carlson) interpolation
+ *   that never overshoots its neighbouring points.
+ * - vectorcraft `crates/doc/src/appearance.rs` — `WidthProfile` as `(t, left, right)` points,
+ *   discontinuous points (two points at one `t` make a step) and the profile presets.
+ * - effectcraft `crates/path/src/varstroke.rs` — `width_factor`: the parametric Taper (lengths,
+ *   end widths, ease) and Wave (amount, cycles, phase) shapes, used here as profile generators.
+ */
+
+/** The most points a profile keeps. */
+declare const VECTOR_WIDTH_PROFILE_MAX_POINTS = 64;
+/** The widest a side can be, as a multiple of the stroke width. */
+declare const VECTOR_WIDTH_PROFILE_MAX_SCALE = 1000;
+/** Positions closer than this are the same place (the two sides of a discontinuous point). */
+declare const VECTOR_WIDTH_SAME_T = 0.000001;
+/** Built-in profiles. `uniform` is the plain stroke (no profile). */
+type VectorWidthPreset = 'uniform' | 'taperStart' | 'taperEnd' | 'taperBoth' | 'bulge' | 'pinch' | 'teardrop' | 'wave' | 'pressure';
+/** One preset as a menu shows it. */
+interface VectorWidthPresetInfo {
+    id: VectorWidthPreset;
+    label: string;
+    points: readonly VectorWidthPoint[];
+}
+/** The built-in profiles, in menu order. */
+declare const VECTOR_WIDTH_PRESETS: readonly VectorWidthPresetInfo[];
+declare const VECTOR_WIDTH_PRESET_IDS: readonly VectorWidthPreset[];
+/**
+ * A profile as the outline uses it: finite points only, `t` in 0–1, side scales in 0–1000,
+ * sorted by `t` (stable, so a step keeps its order), at most 64 points. Points missing a side
+ * take the other side's scale.
+ */
+declare function sanitizeWidthProfile(points: readonly Partial<VectorWidthPoint>[] | null | undefined): VectorWidthPoint[];
+/** True when the profile draws a plain stroke: no points, or every side at scale 1. */
+declare function isUniformWidthProfile(points: readonly VectorWidthPoint[] | null | undefined): boolean;
+/**
+ * The left and right side scales at `t` (0–1 along the subpath by length). Each side is
+ * interpolated on its own with a monotone cubic, so the width never overshoots its points;
+ * a profile without points is uniform (1, 1).
+ */
+declare function widthProfileAt(points: readonly VectorWidthPoint[] | null | undefined, t: number): {
+    left: number;
+    right: number;
+};
+/** The largest side scale (the interpolation never exceeds its points); 1 without a profile. */
+declare function widthProfileMaxScale(points: readonly VectorWidthPoint[] | null | undefined): number;
+/** The points of a preset (empty for `uniform`), or null for an unknown id. */
+declare function widthProfilePreset(id: string): VectorWidthPoint[] | null;
+/** The preset a profile matches: `uniform` without one (or all at scale 1), `custom` when none matches. */
+declare function widthProfilePresetId(points: readonly VectorWidthPoint[] | null | undefined): VectorWidthPreset | 'custom';
+/** The profile of the reversed path: positions mirrored and the sides swapped. */
+declare function reverseWidthProfile(points: readonly VectorWidthPoint[]): VectorWidthPoint[];
+/** The profile of a mirrored path (it runs the same way, but its sides swap). */
+declare function mirrorWidthProfile(points: readonly VectorWidthPoint[]): VectorWidthPoint[];
+/**
+ * Adds a width point at `t` (side scales `left` / `right`, default: as wide as the stroke is
+ * there) and returns the new profile and the point's index. Inserting at the position of an
+ * existing point replaces it, unless `step` is set (which makes a discontinuous point).
+ */
+declare function insertWidthPoint(points: readonly VectorWidthPoint[] | null | undefined, t: number, sides?: {
+    left?: number;
+    right?: number;
+}, options?: {
+    step?: boolean;
+}): {
+    points: VectorWidthPoint[];
+    index: number;
+};
+/**
+ * Changes point `index`: moves it to `t` (kept between its neighbours, so indices stay put)
+ * and / or sets its side scales. Out-of-range indices leave the profile as it is.
+ */
+declare function setWidthPoint(points: readonly VectorWidthPoint[], index: number, patch: Partial<VectorWidthPoint>): VectorWidthPoint[];
+/** Removes the points at `indices`. */
+declare function removeWidthPoints(points: readonly VectorWidthPoint[], indices: readonly number[]): VectorWidthPoint[];
+/** A parametric taper (effectcraft's Stroke Taper), lengths as fractions of the path. */
+interface VectorTaperOptions {
+    /** Fraction of the path the start taper covers (default 0). */
+    startLength?: number;
+    /** Fraction the end taper covers (default 0). */
+    endLength?: number;
+    /** Width at the start as a fraction of the stroke width (default 0: a point). */
+    startWidth?: number;
+    endWidth?: number;
+    /** 0 linear, 1 a quarter circle bulging outwards (default 0). */
+    startEase?: number;
+    endEase?: number;
+}
+/** A width wave (effectcraft's Stroke Wave): the width swings between `1 − amount` and 1. */
+interface VectorWaveOptions {
+    /** 0–1 (default 0.5). */
+    amount?: number;
+    /** Whole cycles along the path (default 4). */
+    cycles?: number;
+    /** Degrees (default 0). */
+    phase?: number;
+}
+/** The width factor at fraction `t` of a taper and / or a wave (effectcraft `width_factor`). */
+declare function taperWaveFactor(t: number, taper?: VectorTaperOptions | null, wave?: VectorWaveOptions | null): number;
+/**
+ * Samples a taper and / or wave into profile points (symmetric), simplified to within
+ * `tolerance` of the factor (default 0.01). The monotone interpolation draws them back smoothly.
+ */
+declare function generateWidthProfile(options: {
+    taper?: VectorTaperOptions | null;
+    wave?: VectorWaveOptions | null;
+    samples?: number;
+    tolerance?: number;
+}): VectorWidthPoint[];
+/** Pen pressure that draws the stroke's own width (a mouse reports 0.5 while a button is down). */
+declare const VECTOR_PRESSURE_NOMINAL = 0.5;
+/**
+ * A profile from pen pressure recorded along a stroke: `(t, pressure 0–1)` samples in order.
+ * The width scale is pressure ÷ 0.5 (so half pressure draws the stroke's width, full pressure
+ * twice it), at least 0.05; the samples are simplified to within `tolerance` (default 0.02).
+ * Returns an empty (uniform) profile when every sample is the same.
+ */
+declare function pressureWidthProfile(samples: readonly {
+    t: number;
+    pressure: number;
+}[], options?: {
+    tolerance?: number;
+}): VectorWidthPoint[];
+
 /**
  * What a guide line shows: `align` lines run from a target through the snapped point or box,
  * `construction` lines from where a drawn point leaves, `spacing` marks equal gaps and `size`
@@ -725,6 +881,11 @@ interface VectorPathEditOptions {
     recognizeShapes: boolean;
     /** Eraser diameter in document units (default 10). */
     eraserSize: number;
+    /**
+     * Record pointer pressure on pencil strokes as a width profile: `pen` (default) for pen input
+     * only, `all` for any pointer that reports pressure, `off` never.
+     */
+    pencilPressure: 'pen' | 'all' | 'off';
 }
 /** Path-editing options new editors start with. */
 declare const DEFAULT_VECTOR_PATH_EDIT: Readonly<VectorPathEditOptions>;
@@ -752,6 +913,27 @@ interface VectorEditorOptions {
 interface VectorPointerInput extends VectorModifiers {
     /** 0 = primary, 1 = middle (pans), 2 = secondary. Default 0. */
     button?: number;
+    /** `PointerEvent.pressure` (0–1), recorded on pencil strokes. */
+    pressure?: number;
+    /** `PointerEvent.pointerType` (`mouse`, `pen`, `touch`). */
+    pointerType?: string;
+}
+/** One width point of a path's stroke profile; `subpath` is the subpath it is shown on. */
+interface VectorWidthPointRef {
+    nodeId: string;
+    index: number;
+    subpath: number;
+}
+/** A spot on a stroke (width tool): where a drag would add a width point. Positions in document units. */
+interface VectorStrokeSpot {
+    nodeId: string;
+    subpath: number;
+    /** Position along the subpath by length, 0–1. */
+    t: number;
+    point: Vec2;
+    /** Ends of the stroke's width across the path there. */
+    left: Vec2;
+    right: Vec2;
 }
 /** A key press as the controller needs it. */
 interface VectorKeyInput extends VectorModifiers {
@@ -774,6 +956,12 @@ interface VectorHover {
     transformHandle?: VectorTransformHandle;
     /** A live corner widget (direct tool): the corner's anchor. */
     corner?: VectorAnchorRef;
+    /** A width point (width tool): its centre or the end of its left / right side. */
+    widthPoint?: VectorWidthPointRef & {
+        part: 'center' | 'left' | 'right';
+    };
+    /** A spot on a stroke away from its width points (width tool). */
+    strokeSpot?: VectorStrokeSpot;
 }
 /** The drag in progress, for overlays and status text. */
 type VectorInteraction = {
@@ -816,6 +1004,11 @@ type VectorInteraction = {
     tool: 'knife' | 'eraser';
     points: Vec2[];
     width: number;
+} | {
+    type: 'width';
+    ref: VectorWidthPointRef;
+    mode: 'width' | 'move';
+    width: number;
 } | {
     type: 'pen';
     nodeId: string;
@@ -830,6 +1023,8 @@ interface VectorEditorState {
     selection: readonly string[];
     /** Selected anchors (direct tool). */
     selectedAnchors: readonly VectorAnchorRef[];
+    /** The selected width point (width tool); Delete removes it. */
+    selectedWidthPoint: VectorWidthPointRef | null;
     /** The path whose anchors are being edited, if any. */
     editingId: string | null;
     /** Axis-aligned bounds of the selected nodes in document units. */
@@ -893,7 +1088,7 @@ interface VectorShapeInput extends VectorStyle {
     name?: string;
 }
 /** Every field of `VectorStyle`, in the order style panels and commands list them. */
-declare const VECTOR_STYLE_KEYS: readonly ["fill", "stroke", "strokeWidth", "strokeLinecap", "strokeLinejoin", "strokeDasharray", "fillRule", "strokeAlign", "startArrow", "endArrow", "arrowAlign", "startArrowScale", "endArrowScale"];
+declare const VECTOR_STYLE_KEYS: readonly ["fill", "stroke", "strokeWidth", "strokeLinecap", "strokeLinejoin", "strokeDasharray", "fillRule", "strokeAlign", "startArrow", "endArrow", "arrowAlign", "startArrowScale", "endArrowScale", "strokeWidthProfile"];
 /** Clipboard payload type written by `copy()`. */
 declare const VECTOR_CLIPBOARD_TYPE = "pixerate/vector";
 /** Screen distance of the rotation handle above the selection box. */
@@ -930,6 +1125,37 @@ interface VectorCornerWidget {
  * THIRD_PARTY_NOTICES.md), as is the `corner` drag below.
  */
 declare function getVectorCornerWidgets(state: Pick<VectorEditorState, 'document' | 'selection' | 'editingId' | 'tool' | 'pen' | 'selectedAnchors' | 'viewport'>): VectorCornerWidget[];
+/**
+ * The line a path's stroke follows (node space; shortened under `tip` arrowheads) and the
+ * distance a side scale of 1 reaches from it (half the drawn width: twice the stroke width for
+ * inside / outside strokes). Null for paths without a visible stroke.
+ */
+declare function vectorStrokeWidthGeometry(node: VectorPathNode): {
+    line: BezierPath;
+    unit: number;
+} | null;
+/** A width point of the width tool, in document units. */
+interface VectorWidthHandle {
+    ref: VectorWidthPointRef;
+    /** The point on the path. */
+    x: number;
+    y: number;
+    /** Ends of its left and right sides. */
+    left: Vec2;
+    right: Vec2;
+    t: number;
+    /** Side scales (multiples of half the stroke width). */
+    leftScale: number;
+    rightScale: number;
+    selected: boolean;
+}
+/**
+ * The width points the width tool shows: every profile point on every subpath of the stroke
+ * under the pointer, the selected paths and the stroke being edited. Ported from ArtCraft
+ * vectorcraft `crates/tools/src/distort/width.rs` (MIT OR Apache-2.0, see
+ * THIRD_PARTY_NOTICES.md), as are the `width` drag and hover below.
+ */
+declare function getVectorWidthHandles(state: Pick<VectorEditorState, 'document' | 'selection' | 'tool' | 'hover' | 'interaction' | 'selectedWidthPoint'>): VectorWidthHandle[];
 /** Looks up an anchor (positions in its node's own space). */
 declare function getAnchor(doc: VectorDocument, ref: VectorAnchorRef): VectorAnchor | undefined;
 /** An anchor with its position and handles in document space (its node's transforms applied). */
@@ -998,6 +1224,7 @@ declare class VectorEditorController {
     private doc;
     private selection;
     private anchors;
+    private widthPoint;
     private editingId;
     private pen;
     private tool;
@@ -1131,6 +1358,19 @@ declare class VectorEditorController {
     }, ids?: readonly string[], options?: {
         label?: string;
     }): VectorActionResult;
+    /**
+     * Sets the variable-width profile of the selected (or given) paths: a preset id
+     * (`uniform` removes the profile), points, or a parametric taper / wave. Returns an error for
+     * an unknown preset.
+     */
+    setWidthProfile(profile: VectorWidthPreset | readonly VectorWidthPoint[] | {
+        taper?: VectorTaperOptions;
+        wave?: VectorWaveOptions;
+    } | null, options?: {
+        ids?: readonly string[];
+    }): VectorActionResult;
+    /** Removes one width point of a path's profile (the width tool's Delete). */
+    removeWidthPoint(ref: Pick<VectorWidthPointRef, 'nodeId' | 'index'>): VectorActionResult;
     /**
      * Sets the live corner radius (and optionally the kind) of anchors: `refs`, else the selected
      * anchors (direct tool), else every anchor of the `ids` / selected paths. Radius 0 makes the
@@ -1403,6 +1643,12 @@ declare class VectorEditorController {
     /** Endpoints of open subpaths of unlocked visible paths (pen tool resumes from them). */
     private openEndpoints;
     private computeHover;
+    private widthView;
+    /** The width point centre or side end under `screen` (width tool). */
+    private hitWidthHandle;
+    /** The nearest stroked, unlocked visible path whose stroke is under document point `p` (width tool). */
+    private strokeSpotAt;
+    private downWidth;
     /** The nearest outline point of any visible, unlocked path within the pick distance of document point `p`. */
     private nearestOutline;
     private sameHover;
@@ -1517,6 +1763,22 @@ interface VectorRenderCornerWidget {
     /** Its corners are being dragged. */
     active: boolean;
 }
+/**
+ * A width point of the width tool in screen pixels: a diamond at (`x`, `y`) on the path and a
+ * line across the stroke from `left` to `right`, with a handle at each end.
+ */
+interface VectorRenderWidthPoint {
+    ref: VectorWidthPointRef;
+    x: number;
+    y: number;
+    left: Vec2;
+    right: Vec2;
+    selected: boolean;
+    /** The part under the pointer, if any. */
+    hovered: 'center' | 'left' | 'right' | null;
+    /** Being dragged. */
+    active: boolean;
+}
 /** A smart guide line in screen pixels. */
 interface VectorRenderGuideLine {
     kind: VectorGuideKind;
@@ -1586,6 +1848,18 @@ interface VectorOverlayRenderData {
      * Alt-click to cycle round / inverted / chamfer, click to pick its corner alone.
      */
     cornerWidgets: VectorRenderCornerWidget[];
+    /** Width points of the width tool (screen space). */
+    widthPoints: VectorRenderWidthPoint[];
+    /**
+     * Where a width-tool drag would add a width point (screen space): draw a dashed line from
+     * `left` to `right` and a hollow diamond at (`x`, `y`).
+     */
+    widthSpot: {
+        x: number;
+        y: number;
+        left: Vec2;
+        right: Vec2;
+    } | null;
     /** A short status, e.g. "W 120 × H 80" or "45°". */
     status: string | null;
 }
@@ -1612,7 +1886,11 @@ declare const VECTOR_OVERLAY_THEME: {
     readonly handleRadius: 3.5;
     /** Radius of a live corner widget (a ring with a dot). */
     readonly cornerWidgetRadius: 4;
+    /** Half the diagonal of a width point's diamond. */
+    readonly widthPointSize: 5;
 };
+/** SVG path data of the diamond a width point is drawn with (screen pixels). */
+declare function vectorDiamondPath(x: number, y: number, r?: number): string;
 interface ModifierEventLike {
     shiftKey?: boolean;
     altKey?: boolean;
@@ -1625,10 +1903,17 @@ declare function toVectorModifiers(event: ModifierEventLike): {
     alt: boolean;
     mod: boolean;
 };
-/** A pointer event as `VectorEditorController.pointerDown/Move/Up` input. */
+/**
+ * A pointer event as `VectorEditorController.pointerDown/Move/Up` input: modifiers, button,
+ * and the pressure and pointer type the pencil records as a width profile.
+ */
 declare function toVectorPointerInput(event: ModifierEventLike & {
     button?: number;
+    pressure?: number;
+    pointerType?: string;
 }): {
+    pointerType?: string | undefined;
+    pressure?: number | undefined;
     button: number | undefined;
     shift: boolean;
     alt: boolean;
@@ -1657,6 +1942,9 @@ interface VectorSelectionStyle {
     arrowAlign: VectorArrowAlign;
     startArrowScale: number;
     endArrowScale: number;
+    /** The first path's width profile (null when uniform) and the preset it matches. */
+    strokeWidthProfile: VectorWidthPoint[] | null;
+    widthProfile: VectorWidthPreset | 'custom';
     /**
      * Live corners of the selected anchors (direct tool) or of every corner of the selected
      * paths: the first one's radius and kind, and how many corners there are (0: none to round).
@@ -1677,6 +1965,7 @@ interface VectorSelectionStyle {
         arrowAlign: boolean;
         startArrowScale: boolean;
         endArrowScale: boolean;
+        widthProfile: boolean;
         cornerRadius: boolean;
         cornerKind: boolean;
     };
@@ -1954,8 +2243,15 @@ interface VectorStrokeParts {
 declare function isClosedBezierShape(path: BezierPath): boolean;
 /** The alignment a stroke is drawn with: the style's, or `center` for open shapes. */
 declare function effectiveStrokeAlign(style: Pick<VectorStyle, 'strokeAlign'>, closedShape: boolean): VectorStrokeAlign;
-/** True when the style asks for more than a plain centred stroke (an alignment or arrowheads). */
+/** The style's width profile, sanitised, or null when the stroke is uniform. */
+declare function strokeWidthProfileOf(style: Pick<VectorStyle, 'strokeWidthProfile'>): VectorWidthPoint[] | null;
+/** True when the style asks for more than a plain centred stroke (an alignment, arrowheads or a width profile). */
 declare function hasStrokeExtras(style: VectorStyle): boolean;
+/**
+ * The area of the stroke along `parts.line` before alignment clipping: SVG's stroke for a
+ * uniform width, the variable-width outline (`variableStrokeOutline`) for a profiled one.
+ */
+declare function vectorStrokeLineArea(parts: Pick<VectorStrokeParts, 'line' | 'drawWidth'>, style: VectorStyle, tolerance?: number): BezierPath;
 /** The weight of a head: the stroke width times its scale (at least 0.25). A head is 4 weights long and wide. */
 declare function arrowheadWeight(style: VectorStyle, end: 'start' | 'end'): number;
 /** Distance from the tip where the stroke ends, for a stroke whose cap reaches `cap` past its end. */
@@ -1983,4 +2279,81 @@ declare function hitTestVectorStroke(path: BezierPath, p: Vec2, style: VectorSty
 /** How far the stroke can reach past the outline (for padding bounds and masks). */
 declare function vectorStrokeReach(style: VectorStyle): number;
 
-export { type AddVectorNodeOptions, AffineMatrix, DEFAULT_VECTOR_PATH_EDIT, DEFAULT_VECTOR_SNAP, IDENTITY_MATRIX, KAPPA, LazyMouse, type NearestSegment, type RecognizeInkOptions, SvgGradientDef, VECTOR_ARROWHEADS, VECTOR_ARROWHEAD_LABELS, VECTOR_CLIPBOARD_TYPE, VECTOR_CONSTRUCTION_ANGLES, VECTOR_CORNER_KINDS, VECTOR_CORNER_KIND_LABELS, VECTOR_CORNER_WIDGET_INSET, VECTOR_EDIT_TOGGLES, VECTOR_INK_MAX_CORNERS, VECTOR_OVERLAY_THEME, VECTOR_PATH_ACTIONS, VECTOR_PENCIL_STRING_PX, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_STROKE_ALIGN_LABELS, VECTOR_STYLE_KEYS, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorArrowAlign, type VectorArrowhead, type VectorArrowheadShape, type VectorAverageAxis, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorCorner, type VectorCornerInfo, type VectorCornerKind, type VectorCornerWidget, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorGuideKind, type VectorGuideLabel, type VectorGuideLine, type VectorHandleRef, type VectorHover, type VectorInkShape, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorMatrix, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathAction, type VectorPathEditOptions, type VectorPathNode, type VectorPointSnap, type VectorPointerInput, type VectorRectSnap, type VectorRenderAnchor, type VectorRenderCornerWidget, type VectorRenderGroup, type VectorRenderGuideLabel, type VectorRenderGuideLine, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorRenderStrokeParts, type VectorScaleSnap, type VectorSceneRenderData, type VectorSegmentRef, type VectorSelectionBoxGeometry, type VectorSelectionFrame, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapGuides, type VectorSnapKind, type VectorSnapLeave, type VectorSnapOptions, VectorSnapTargets, type VectorStrokeAlign, type VectorStrokeParts, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, applyMatrixLinear, applyVectorCornersAttribute, arrowheadInset, arrowheadPath, arrowheadWeight, bendSegment, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, constrainToLeave, convertAnchor, cornerBisectorPoint, cornerRadiusChange, cornerSetback, createVectorCommands, curvatureMoveAnchor, cutSubpathAt, decomposeRigid, effectiveStrokeAlign, ellipseSubpath, eraseFromFill, eraseFromOutline, eraserRegion, expandVectorCorners, expandVectorCornersOf, findVectorNode, fitCornerRadius, getAnchor, getAnchorWorld, getEditablePathIds, getTransformHandlePositions, getVectorCornerWidgets, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionBoxGeometry, getVectorSelectionFrame, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hasStrokeExtras, hasVectorCorners, hitTestVectorNode, hitTestVectorNodes, hitTestVectorStroke, inferAnchorType, insertAnchor, invertMatrix, isClosedBezierShape, isIdentityMatrix, isVectorTextTarget, joinSubpaths, knifePath, lineSubpath, locateVectorNode, matrixRotation, moveAnchorHandle, multiplyMatrices, nearestSegment, nextVectorCornerKind, nodeMatrix, parseSvgTransform, parseVectorSvg, polygonSubpath, polylineBounds, recognizeInkShape, rectSubpath, removeAnchorKeepingShape, removeAnchors, removeAnchorsKeepingShape, removeRedundantPoints, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, setAnchorCorner, setSubpathCorners, simplifyPolyline, smoothSubpath, splitIntoFaces, splitSubpathAt, starSubpath, subpathPointAt, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorCornerAt, vectorCorners, vectorCornersAttribute, vectorDocumentToSvg, vectorInkShapeName, vectorNodeBounds, vectorNodeRotation, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorParentMatrix, vectorPathData, vectorPathWorldBezier, vectorResizeCursor, vectorStrokeOutline, vectorStrokeOutlinePath, vectorStrokeParts, vectorStrokeReach, vectorStrokeSvgParts, vectorToolLabel, vectorWorldMatrix, walkVectorNodes };
+/**
+ * The outline of a variable-width stroke, as a clean filled Bézier path.
+ *
+ * Each subpath is flattened (finely enough for the width to vary smoothly) and the stroke is
+ * the union of positively wound pieces: one trapezoid per flattened segment (its ends at the
+ * local side widths), a wedge on the outer side of every bend (the style's join at the path's
+ * own corners, round inside curves) and the caps. Filled with the non-zero rule the union is
+ * exact whatever the profile does; it is built as the boundary those pieces add up to (see
+ * `variableStrokeRings`), normalised with the polygon boolean engine, and every ring is refitted
+ * with cubics (`fitCubics`) to within the tolerance — a real Bézier outline, not a polyline.
+ *
+ * Ported from ArtCraft effectcraft `crates/path/src/varstroke.rs` (`outline`, `dash_intervals`)
+ * (MIT OR Apache-2.0, see THIRD_PARTY_NOTICES.md), with one-sided widths after figcraft
+ * `crates/pathops/src/width.rs` (`variable_outline`).
+ */
+
+interface VariableStrokeOptions {
+    /** Stroke width: a side scale of 1 reaches half of it from the centre line. */
+    width: number;
+    profile: readonly VectorWidthPoint[];
+    /** Joins at the path's own corners (default `miter`); bends inside curves are always round. */
+    join?: StrokeJoin;
+    /** Default `butt`. */
+    cap?: StrokeCap;
+    /** Default 4 (as SVG). */
+    miterLimit?: number;
+    /** Dash pattern (as SVG); the profile still runs along the whole subpath. */
+    dash?: readonly number[];
+    dashOffset?: number;
+    /** Largest distance of the result from the exact outline (default 0.05). */
+    tolerance?: number;
+}
+type Vec = [number, number];
+/** Arc-length intervals that are "on" for a dash pattern on a path `len` long (effectcraft `dash_intervals`). */
+declare function dashIntervals(pattern: readonly number[], offset: number, len: number): [number, number][];
+/**
+ * The rings of a variable-width stroke in the path's own space; filled with the non-zero rule
+ * they are the stroke.
+ *
+ * effectcraft builds the stroke as a union of positively wound pieces: a trapezoid per flattened
+ * segment (its ends at the local side widths), a wedge on the outer side of every bend and the
+ * caps. Unioning thousands of overlapping pieces is slow, so each run is emitted as the boundary
+ * those pieces add up to instead (winding numbers add, so the non-zero fill is the same): the
+ * offset sides with the outer join between them, and on the inner side of a bend either the point
+ * where the two offsets cross (the region cut off is covered by both trapezoids) or, when they do
+ * not cross, a detour through the centre point (which keeps the winding right when segments are
+ * shorter than the width). A closed subpath gives two rings, an open run one.
+ */
+declare function variableStrokeRings(path: BezierPath, options: VariableStrokeOptions): Point[][];
+/**
+ * The outline of a variable-width stroke of `path` (side widths from `profile`), as a clean
+ * Bézier path: overlaps removed, outer rings and holes, each refitted with cubics to within
+ * `tolerance` of the exact outline. Fill it with the non-zero rule (either rule works).
+ */
+declare function variableStrokeOutline(path: BezierPath, options: VariableStrokeOptions): BezierPath;
+/**
+ * Where point `p` lies relative to the stroke's centre line: the nearest point's contour,
+ * its position `t` by length (0–1), the distance, and the side (`left` looking along the
+ * path on screen) — what hit-testing and the width tool need.
+ */
+declare function nearestStrokePosition(path: BezierPath, p: Point, 
+/** Only this contour (subpath) of the path. */
+only?: number): {
+    contour: number;
+    t: number;
+    distance: number;
+    side: 'left' | 'right';
+    point: Point;
+    tangent: Vec;
+    length: number;
+} | null;
+/** The point and unit tangent at position `t` (0–1 by length) of contour `index` of `path`. */
+declare function strokePositionPoint(path: BezierPath, index: number, t: number): {
+    point: Point;
+    tangent: Vec;
+} | null;
+
+export { type AddVectorNodeOptions, AffineMatrix, DEFAULT_VECTOR_PATH_EDIT, DEFAULT_VECTOR_SNAP, IDENTITY_MATRIX, KAPPA, LazyMouse, type NearestSegment, type RecognizeInkOptions, SvgGradientDef, VECTOR_ARROWHEADS, VECTOR_ARROWHEAD_LABELS, VECTOR_CLIPBOARD_TYPE, VECTOR_CONSTRUCTION_ANGLES, VECTOR_CORNER_KINDS, VECTOR_CORNER_KIND_LABELS, VECTOR_CORNER_WIDGET_INSET, VECTOR_EDIT_TOGGLES, VECTOR_INK_MAX_CORNERS, VECTOR_OVERLAY_THEME, VECTOR_PATH_ACTIONS, VECTOR_PENCIL_STRING_PX, VECTOR_PRESSURE_NOMINAL, VECTOR_ROTATE_HANDLE_OFFSET, VECTOR_STROKE_ALIGN_LABELS, VECTOR_STYLE_KEYS, VECTOR_TOOLS, VECTOR_TOOL_GLYPHS, VECTOR_TOOL_SHORTCUTS, VECTOR_TRANSFORM_HANDLES, VECTOR_WIDTH_PRESETS, VECTOR_WIDTH_PRESET_IDS, VECTOR_WIDTH_PROFILE_MAX_POINTS, VECTOR_WIDTH_PROFILE_MAX_SCALE, VECTOR_WIDTH_SAME_T, type VariableStrokeOptions, type Vec2, type VectorActionResult, type VectorAlign, type VectorAnchor, type VectorAnchorRef, type VectorAnchorType, type VectorArrange, type VectorArrowAlign, type VectorArrowhead, type VectorArrowheadShape, type VectorAverageAxis, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, type VectorCorner, type VectorCornerInfo, type VectorCornerKind, type VectorCornerWidget, type VectorDefaults, type VectorDistribute, type VectorDocument, VectorEditorController, type VectorEditorOptions, type VectorEditorState, type VectorFillRule, type VectorGroupNode, type VectorGuideKind, type VectorGuideLabel, type VectorGuideLine, type VectorHandleRef, type VectorHover, type VectorInkShape, type VectorInteraction, type VectorKeyInput, type VectorLineCap, type VectorLineJoin, type VectorMatrix, type VectorModifiers, type VectorNode, type VectorNodeListing, type VectorOverlayRenderData, type VectorPaint, type VectorPathAction, type VectorPathEditOptions, type VectorPathNode, type VectorPointSnap, type VectorPointerInput, type VectorRectSnap, type VectorRenderAnchor, type VectorRenderCornerWidget, type VectorRenderGroup, type VectorRenderGuideLabel, type VectorRenderGuideLine, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorRenderStrokeParts, type VectorRenderWidthPoint, type VectorScaleSnap, type VectorSceneRenderData, type VectorSegmentRef, type VectorSelectionBoxGeometry, type VectorSelectionFrame, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapGuides, type VectorSnapKind, type VectorSnapLeave, type VectorSnapOptions, VectorSnapTargets, type VectorStrokeAlign, type VectorStrokeParts, type VectorStrokeSpot, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTaperOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, type VectorWaveOptions, type VectorWidthHandle, type VectorWidthPoint, type VectorWidthPointRef, type VectorWidthPreset, type VectorWidthPresetInfo, applyMatrix, applyMatrixLinear, applyVectorCornersAttribute, arrowheadInset, arrowheadPath, arrowheadWeight, bendSegment, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, constrainToLeave, convertAnchor, cornerBisectorPoint, cornerRadiusChange, cornerSetback, createVectorCommands, curvatureMoveAnchor, cutSubpathAt, dashIntervals, decomposeRigid, effectiveStrokeAlign, ellipseSubpath, eraseFromFill, eraseFromOutline, eraserRegion, expandVectorCorners, expandVectorCornersOf, findVectorNode, fitCornerRadius, generateWidthProfile, getAnchor, getAnchorWorld, getEditablePathIds, getTransformHandlePositions, getVectorCornerWidgets, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionBoxGeometry, getVectorSelectionFrame, getVectorSelectionStyle, getVectorWidthHandles, getVisibleAnchors, getVisibleHandles, hasPaint, hasStrokeExtras, hasVectorCorners, hitTestVectorNode, hitTestVectorNodes, hitTestVectorStroke, inferAnchorType, insertAnchor, insertWidthPoint, invertMatrix, isClosedBezierShape, isIdentityMatrix, isUniformWidthProfile, isVectorTextTarget, joinSubpaths, knifePath, lineSubpath, locateVectorNode, matrixRotation, mirrorWidthProfile, moveAnchorHandle, multiplyMatrices, nearestSegment, nearestStrokePosition, nextVectorCornerKind, nodeMatrix, parseSvgTransform, parseVectorSvg, polygonSubpath, polylineBounds, pressureWidthProfile, recognizeInkShape, rectSubpath, removeAnchorKeepingShape, removeAnchors, removeAnchorsKeepingShape, removeRedundantPoints, removeWidthPoints, reverseSubpath, reverseWidthProfile, rotateMatrix, roundSubpaths, sanitizeWidthProfile, scaleFor, scaleMatrix, setAnchorCorner, setSubpathCorners, setWidthPoint, simplifyPolyline, smoothSubpath, splitIntoFaces, splitSubpathAt, starSubpath, strokePositionPoint, strokeWidthProfileOf, subpathPointAt, subpathSegment, subpathSegmentCount, subpathsToBezier, taperWaveFactor, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, variableStrokeOutline, variableStrokeRings, vectorCornerAt, vectorCorners, vectorCornersAttribute, vectorDiamondPath, vectorDocumentToSvg, vectorInkShapeName, vectorNodeBounds, vectorNodeRotation, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorParentMatrix, vectorPathData, vectorPathWorldBezier, vectorResizeCursor, vectorStrokeLineArea, vectorStrokeOutline, vectorStrokeOutlinePath, vectorStrokeParts, vectorStrokeReach, vectorStrokeSvgParts, vectorStrokeWidthGeometry, vectorToolLabel, vectorWorldMatrix, walkVectorNodes, widthProfileAt, widthProfileFromAttribute, widthProfileMaxScale, widthProfilePreset, widthProfilePresetId, widthProfileToAttribute };