@pixerate/editor 0.35.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';
@@ -19,6 +19,22 @@ interface Vec2 {
  * - `symmetric`: handles stay on one line with equal lengths.
  */
 type VectorAnchorType = 'corner' | 'smooth' | 'symmetric';
+/**
+ * Live corner shapes: `round` (an arc tangent to both sides), `inverted` (an arc centred on
+ * the corner, cut into the shape) and `chamfer` (a straight bevel).
+ */
+type VectorCornerKind = 'round' | 'inverted' | 'chamfer';
+declare const VECTOR_CORNER_KINDS: readonly VectorCornerKind[];
+/**
+ * A live corner: drawn rounded (or cut) at render, hit-test, bounds, boolean, outline and export
+ * time while the stored anchor stays sharp. The radius shrinks to fit when the sides are short:
+ * the cut reaches at most halfway along each side.
+ */
+interface VectorCorner {
+    radius: number;
+    /** Default `round`. */
+    kind?: VectorCornerKind;
+}
 /**
  * One anchor of a subpath. Handles are absolute document positions; a missing (or `null`)
  * handle sits on the anchor, so a segment with no handles at either end is a straight line.
@@ -32,6 +48,8 @@ interface VectorAnchor {
     out?: Vec2 | null;
     /** Default `corner`. */
     type?: VectorAnchorType;
+    /** Live corner radius. Ignored on smooth / symmetric anchors and the ends of open subpaths. */
+    corner?: VectorCorner | null;
 }
 /** A chain of anchors joined by line or cubic Bézier segments. */
 interface VectorSubpath {
@@ -44,6 +62,30 @@ type VectorPaint = string | CanvasGradientDef | null;
 type VectorFillRule = 'nonzero' | 'evenodd';
 type VectorLineCap = 'butt' | 'round' | 'square';
 type VectorLineJoin = 'miter' | 'round' | 'bevel';
+/**
+ * Where the stroke sits on the outline: centred on it, inside the shape or outside it. Only
+ * shapes whose subpaths are all closed have an inside; open paths always stroke centred.
+ */
+type VectorStrokeAlign = 'center' | 'inside' | 'outside';
+/** Arrowheads and end markers for the ends of open paths. */
+type VectorArrowhead = 'triangle' | 'arrow' | 'open' | 'circle' | 'square' | 'bar';
+declare const VECTOR_ARROWHEADS: readonly VectorArrowhead[];
+/**
+ * `extend`: the head's tip sits past the end point and the path keeps its length; `tip`: the
+ * 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;
@@ -55,6 +97,24 @@ interface VectorStyle {
     strokeDasharray?: number[];
     /** Default `nonzero`. */
     fillRule?: VectorFillRule;
+    /** Default `center`. */
+    strokeAlign?: VectorStrokeAlign;
+    /** Head at the start of the first subpath when it is open, or none. */
+    startArrow?: VectorArrowhead | null;
+    /** Head at the end of the last subpath when it is open, or none. */
+    endArrow?: VectorArrowhead | null;
+    /** Default `extend`. */
+    arrowAlign?: VectorArrowAlign;
+    /** Size of the start head as a multiple of the stroke width (default 1: a head 4 widths long). */
+    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;
@@ -111,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 {
@@ -141,8 +201,10 @@ interface VectorDefaults extends VectorStyle {
     starPoints?: number;
     /** Inner radius of the star tool as a fraction of the outer one (default 0.5). */
     starInnerRatio?: number;
-    /** Corner radius of the rectangle tool (default 0). */
+    /** Live corner radius the rectangle, polygon and star tools give their corners (default 0). */
     cornerRadius?: number;
+    /** Corner kind of those tools (default `round`). */
+    cornerKind?: VectorCornerKind;
 }
 type VectorAlign = 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom';
 type VectorDistribute = 'horizontal' | 'vertical';
@@ -173,8 +235,13 @@ declare function hasPaint(paint: VectorPaint | undefined): boolean;
 declare function subpathSegmentCount(sp: VectorSubpath): number;
 /** Control points of segment `i` of a subpath: 2 for a line, 4 for a cubic. */
 declare function subpathSegment(sp: VectorSubpath, i: number): Point[];
-/** Absolute `M` / `L` / `C` / `Z` commands of subpaths. */
-declare function subpathsToBezier(subpaths: readonly VectorSubpath[]): BezierPath;
+/**
+ * Absolute `M` / `L` / `C` / `Z` commands of subpaths, with live corners cut
+ * (`expandVectorCorners`). Pass `{ corners: false }` for the stored anchors as they are.
+ */
+declare function subpathsToBezier(subpaths: readonly VectorSubpath[], options?: {
+    corners?: boolean;
+}): BezierPath;
 /** The node's outline as Bézier commands. Groups have none. */
 declare function vectorNodeToBezier(node: VectorNode): BezierPath;
 /** SVG path data (`d`) of a path node or subpaths. */
@@ -216,10 +283,16 @@ declare function boundsIntersect(a: VectorBounds, b: VectorBounds): boolean;
 /** A box from two corners in any order. */
 declare function boundsFromPoints(a: Vec2, b: Vec2): VectorBounds;
 /**
- * Whether `p` hits a node: inside its fill (when it has one) or within half its stroke
- * width plus `tolerance` of its outline. A group is hit when any visible child is.
+ * Whether `p` hits a node: inside its fill (when it has one), on its stroke as drawn (its
+ * alignment and arrowheads respected) or within `tolerance` of either. A group is hit when
+ * any visible child is.
  */
 declare function hitTestVectorNode(node: VectorNode, p: Vec2, tolerance?: number, parent?: AffineMatrix): boolean;
+/**
+ * The area a path node's stroke paints (alignment, caps, joins, dashes and arrowheads
+ * included), as a filled path in the space `parent` maps to. Empty without a stroke.
+ */
+declare function vectorStrokeOutline(node: VectorPathNode, parent?: AffineMatrix): BezierPath;
 /** The topmost node hit by `p` (skipping hidden and locked ones), or null. */
 declare function hitTestVectorNodes(nodes: readonly VectorNode[], p: Vec2, tolerance?: number): VectorNode | null;
 interface NearestSegment {
@@ -302,8 +375,11 @@ declare function removeAnchors(sp: VectorSubpath, indices: readonly number[]): V
 declare function reverseSubpath(sp: VectorSubpath): VectorSubpath;
 /** Handle length that makes a cubic approximate a quarter circle. */
 declare const KAPPA = 0.5522847498307936;
-/** A rectangle, optionally with rounded corners (clamped to half the shorter side). */
-declare function rectSubpath(b: VectorBounds, radius?: number): VectorSubpath;
+/**
+ * A rectangle. A `radius` becomes a live corner on each of its four anchors (drawn round, and
+ * clamped to half the shorter side, when the path is turned into curves).
+ */
+declare function rectSubpath(b: VectorBounds, radius?: number, kind?: VectorCornerKind): VectorSubpath;
 /** An ellipse inscribed in a box (four smooth anchors). */
 declare function ellipseSubpath(b: VectorBounds): VectorSubpath;
 /** A regular polygon inscribed in a box, first vertex at the top. */
@@ -315,14 +391,6 @@ declare function lineSubpath(a: Vec2, b: Vec2): VectorSubpath;
 /** Rounds every coordinate to `precision` decimals (stable JSON and SVG output). */
 declare function roundSubpaths(subpaths: readonly VectorSubpath[], precision?: number): VectorSubpath[];
 
-/**
- * SVG export and import for vector documents. Import is DOM-free (works in Node and
- * workers): it reads `<svg>`, `<g>`, `<path>`, `<rect>`, `<circle>`, `<ellipse>`, `<line>`,
- * `<polyline>`, `<polygon>`, linear / radial gradients, presentation attributes, `style`
- * declarations and `transform`s. Text, images, clip paths, masks, filters and `<use>` are
- * skipped.
- */
-
 interface VectorSvgExportOptions {
     /** Decimal places for coordinates (default 3). */
     precision?: number;
@@ -334,12 +402,52 @@ interface VectorSvgExportOptions {
     idPrefix?: string;
     /** Indent nested elements (default true). */
     pretty?: boolean;
+    /**
+     * How strokes with an inside / outside alignment or arrowheads are written: `clip` (default)
+     * as a double-width stroke clipped or masked by the shape plus filled heads, `outline` as
+     * one filled path of the area the stroke paints.
+     */
+    strokes?: 'clip' | 'outline';
 }
+/** `data-vector-corners`: the live corners of subpaths as `subpath.index:radius[:kind]`, space separated. */
+declare function vectorCornersAttribute(subpaths: readonly VectorSubpath[], precision?: number): string;
+/** Puts `data-vector-corners` back on subpaths (malformed entries are ignored). */
+declare function applyVectorCornersAttribute(subpaths: VectorSubpath[], value: string): VectorSubpath[];
 /** A paint as an SVG attribute value plus the gradient def it needs (if any). */
 declare function vectorPaintToSvg(paint: VectorPaint | undefined, gradientId: string): {
     value: string;
     gradient: SvgGradientDef | null;
 };
+/** The parts of an aligned or arrowed stroke (see `VectorRenderPath.strokeParts`). */
+interface VectorRenderStrokeParts {
+    align: VectorStrokeAlign;
+    /** The line the stroke follows (shortened under `tip`-aligned heads). */
+    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.
+     */
+    clip: {
+        kind: 'clip' | 'mask';
+        id: string;
+        bounds: VectorBounds;
+    } | null;
+    /** Arrowhead outlines (fill with `stroke`, nonzero). */
+    heads: string[];
+}
+/** 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 {
@@ -351,6 +459,194 @@ declare function parseSvgTransform(value: string | undefined): AffineMatrix;
 /** Parses SVG markup into a vector document. Throws when there is no `<svg>` element. */
 declare function parseVectorSvg(svg: string, options?: VectorSvgImportOptions): VectorDocument;
 
+/**
+ * A corner a live radius can cut: an anchor that is not smooth, where two sides (straight or
+ * curved) meet at an angle. Positions are in the path node's own space.
+ */
+interface VectorCornerInfo {
+    subpath: number;
+    index: number;
+    /** Where the sides meet. */
+    at: Vec2;
+    /** Unit directions the sides leave the corner in: towards the previous anchor, then the next one. */
+    u: Vec2;
+    v: Vec2;
+    /** The sides' lengths (along curves), in the same order. */
+    lu: number;
+    lv: number;
+    /** Cosine and sine of the angle between the sides. */
+    cos: number;
+    sin: number;
+    /** The angle between the sides in degrees (90 at a rectangle's corners). */
+    angle: number;
+    /** The largest radius that fits: its cut then reaches halfway along the shorter side. */
+    maxRadius: number;
+}
+/** The corner at anchor `index` of a subpath, or null when the anchor makes none (an open end, smooth, or straight on). */
+declare function vectorCornerAt(sp: VectorSubpath, index: number, subpath?: number): VectorCornerInfo | null;
+/** Every corner of the subpaths that a live radius can cut, in anchor order. */
+declare function vectorCorners(subpaths: readonly VectorSubpath[]): VectorCornerInfo[];
+/** How far from the corner a round cut of radius `r` meets each side: r / tan(angle / 2). */
+declare const cornerSetback: (c: Pick<VectorCornerInfo, "cos" | "sin">, r: number) => number;
+/** `radius` clamped to what the corner can draw (0 for negative or non-finite radii). */
+declare const fitCornerRadius: (c: Pick<VectorCornerInfo, "maxRadius">, radius: number) => number;
+/** The point `k` along the corner's bisector, measured in (u + v): a round cut of radius r is centred at k = r / sin. */
+declare const cornerBisectorPoint: (c: VectorCornerInfo, k: number) => Vec2;
+/** How much the radius grows when the round cut's centre moves by `d` (its part along the bisector, in radius units). */
+declare const cornerRadiusChange: (c: VectorCornerInfo, d: Vec2) => number;
+/** True when any anchor of the subpaths has a live corner radius. */
+declare function hasVectorCorners(subpaths: readonly VectorSubpath[]): boolean;
+/** One subpath with its corners cut; `sources[i]` is the stored anchor each output anchor comes from. */
+declare function expandVectorCornersOf(sp: VectorSubpath, subpath?: number): {
+    subpath: VectorSubpath;
+    sources: number[];
+};
+/**
+ * The subpaths with every live corner cut (round, inverted or chamfer), each radius no larger
+ * than fits. A cut corner becomes two anchors and curved sides are trimmed to what the cuts
+ * leave of them. Subpaths without corners come back unchanged.
+ */
+declare function expandVectorCorners(subpaths: readonly VectorSubpath[]): VectorSubpath[];
+/**
+ * Sets (or clears, with radius 0) the live corner of anchors. `kind` keeps each anchor's own
+ * kind when omitted. Anchors that make no corner keep the radius too, so it applies once they do.
+ */
+declare function setAnchorCorner(a: VectorAnchor, radius: number, kind?: VectorCornerKind): VectorAnchor;
+/** The next corner kind (Alt-clicking a corner widget cycles round → inverted → chamfer). */
+declare function nextVectorCornerKind(kind: VectorCornerKind | undefined): VectorCornerKind;
+/** 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`
@@ -585,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>;
@@ -612,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 {
@@ -632,6 +954,14 @@ interface VectorHover {
         point: Vec2;
     };
     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 = {
@@ -659,6 +989,10 @@ type VectorInteraction = {
 } | {
     type: 'bend';
     ref: VectorSegmentRef;
+} | {
+    type: 'corner';
+    ref: VectorAnchorRef;
+    radius: number;
 } | {
     type: 'draw';
     tool: VectorTool;
@@ -670,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;
@@ -684,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. */
@@ -691,7 +1032,7 @@ interface VectorEditorState {
     /** The selection box, rotated with the selection when its nodes share a rotation. */
     selectionFrame: VectorSelectionFrame | null;
     viewport: VectorViewport;
-    defaults: Readonly<Required<Pick<VectorDefaults, 'polygonSides' | 'starPoints' | 'starInnerRatio' | 'cornerRadius'>> & VectorStyle>;
+    defaults: Readonly<Required<Pick<VectorDefaults, 'polygonSides' | 'starPoints' | 'starInnerRatio' | 'cornerRadius'>> & Pick<VectorDefaults, 'cornerKind'> & VectorStyle>;
     snap: VectorSnapOptions;
     editing: VectorPathEditOptions;
     /** Smart guides of the snap in progress, in document units (null when there are none). */
@@ -738,12 +1079,16 @@ interface VectorShapeInput extends VectorStyle {
     y: number;
     width: number;
     height: number;
+    /** Live corner radius of a rectangle, polygon or star (default: the editor default). */
     cornerRadius?: number;
+    cornerKind?: VectorCornerKind;
     sides?: number;
     points?: number;
     innerRatio?: number;
     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", "strokeWidthProfile"];
 /** Clipboard payload type written by `copy()`. */
 declare const VECTOR_CLIPBOARD_TYPE = "pixerate/vector";
 /** Screen distance of the rotation handle above the selection box. */
@@ -757,6 +1102,60 @@ declare function getVisibleAnchors(state: Pick<VectorEditorState, 'document' | '
  * (direct tool), or of the last anchor of the pen path.
  */
 declare function getVisibleHandles(state: Pick<VectorEditorState, 'document' | 'selection' | 'editingId' | 'tool' | 'pen' | 'selectedAnchors'>): VectorHandleRef[];
+/** Live corner widgets sit at least this far inside their corner (screen px along each side of a right angle). */
+declare const VECTOR_CORNER_WIDGET_INSET = 10;
+/** A live corner widget of the direct tool: drag it to round the corners, Alt-click to change their kind. */
+interface VectorCornerWidget {
+    ref: VectorAnchorRef;
+    /** Document position of the widget. */
+    x: number;
+    y: number;
+    /** The radius stored on the anchor and the radius drawn (no larger than fits). */
+    radius: number;
+    drawnRadius: number;
+    kind: VectorCornerKind;
+    /** The corner in its node's own space. */
+    corner: VectorCornerInfo;
+}
+/**
+ * The live corner widgets the direct tool shows: on each editable path, at its selected corner
+ * anchors (or at every corner when none of its anchors is selected). Corners whose sides are
+ * shorter than three insets on screen hide theirs. Dragging one sets the radius of all of them.
+ * Ported from ArtCraft vectorcraft `crates/tools/src/corners.rs` (MIT OR Apache-2.0, see
+ * 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). */
@@ -825,6 +1224,7 @@ declare class VectorEditorController {
     private doc;
     private selection;
     private anchors;
+    private widthPoint;
     private editingId;
     private pen;
     private tool;
@@ -958,6 +1358,44 @@ 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
+     * corners sharp again. Corners shrink to fit when drawn, so any radius is accepted.
+     */
+    setCornerRadius(radius: number, options?: {
+        kind?: VectorCornerKind;
+        refs?: readonly VectorAnchorRef[];
+        ids?: readonly string[];
+    }): VectorActionResult;
+    /** Sets the live corner kind of the same anchors as `setCornerRadius`, keeping their radii. */
+    setCornerKind(kind: VectorCornerKind, options?: {
+        refs?: readonly VectorAnchorRef[];
+        ids?: readonly string[];
+    }): VectorActionResult;
+    /** Anchors a corner change applies to (see `setCornerRadius`). */
+    private cornerTargets;
+    /**
+     * Outline Stroke: replaces each selected (or given) path's stroke with a filled path of the
+     * area it paints (alignment, joins, caps, dashes and arrowheads included), placed above a copy
+     * of the path that keeps the fill (left out when there is none). Returns the new paths' ids.
+     */
+    outlineStroke(options?: {
+        ids?: readonly string[];
+    }): string[];
     rename(id: string, name: string): VectorActionResult;
     setVisible(id: string, visible: boolean): VectorActionResult;
     setLocked(id: string, locked: boolean): VectorActionResult;
@@ -1197,12 +1635,20 @@ declare class VectorEditorController {
     private tolerance;
     private hitTransformHandle;
     private hitHandle;
+    private cornerView;
+    private hitCornerWidget;
     private hitAnchor;
     /** Deepest unlocked visible path under `p`. */
     private hitPath;
     /** 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;
@@ -1258,6 +1704,13 @@ interface VectorRenderPath {
     strokeDasharray?: string;
     fillRule: 'nonzero' | 'evenodd';
     opacity: number;
+    /**
+     * Set when the stroke takes more than one element: an inside / outside alignment or
+     * arrowheads. Draw `d` with the fill only, then `stroke.d` with the stroke (at
+     * `stroke.width`, clipped or masked as `stroke.clip` says), then each head filled with
+     * `stroke`; group them under `id`, `transform` and `opacity`.
+     */
+    strokeParts?: VectorRenderStrokeParts;
 }
 interface VectorRenderGroup {
     kind: 'group';
@@ -1299,6 +1752,33 @@ interface VectorRenderHandle {
     anchorY: number;
     hovered: boolean;
 }
+/** A live corner widget in screen pixels. */
+interface VectorRenderCornerWidget {
+    ref: VectorAnchorRef;
+    x: number;
+    y: number;
+    radius: number;
+    kind: VectorCornerKind;
+    hovered: boolean;
+    /** 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;
@@ -1363,6 +1843,23 @@ interface VectorOverlayRenderData {
     } | null;
     /** Where the scissors would cut (screen space). */
     cutPoint: Vec2 | null;
+    /**
+     * Live corner widgets of the direct tool (screen space): drag one to round its corners,
+     * 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;
 }
@@ -1387,7 +1884,13 @@ declare const VECTOR_OVERLAY_THEME: {
     readonly transformHandleSize: 8;
     readonly anchorSize: 7;
     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;
@@ -1400,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;
@@ -1426,21 +1936,52 @@ interface VectorSelectionStyle {
     stroke: VectorPaint;
     strokeWidth: number;
     opacity: number;
+    strokeAlign: VectorStrokeAlign;
+    startArrow: VectorArrowhead | null;
+    endArrow: VectorArrowhead | null;
+    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).
+     */
+    cornerRadius: number;
+    cornerKind: VectorCornerKind;
+    corners: number;
+    /** Some selected path is open, so arrowheads apply. */
+    hasOpenPath: boolean;
     mixed: {
         fill: boolean;
         stroke: boolean;
         strokeWidth: boolean;
         opacity: boolean;
+        strokeAlign: boolean;
+        startArrow: boolean;
+        endArrow: boolean;
+        arrowAlign: boolean;
+        startArrowScale: boolean;
+        endArrowScale: boolean;
+        widthProfile: boolean;
+        cornerRadius: boolean;
+        cornerKind: boolean;
     };
     /** Ids of the paths the style applies to. */
     pathIds: string[];
 }
-declare function getVectorSelectionStyle(state: Pick<VectorEditorState, 'document' | 'selection'>): VectorSelectionStyle | null;
+declare function getVectorSelectionStyle(state: Pick<VectorEditorState, 'document' | 'selection'> & Partial<Pick<VectorEditorState, 'selectedAnchors' | 'tool'>>): VectorSelectionStyle | null;
+/** Labels of the stroke alignments, corner kinds and arrowheads, for style panels. */
+declare const VECTOR_STROKE_ALIGN_LABELS: Readonly<Record<VectorStrokeAlign, string>>;
+declare const VECTOR_CORNER_KIND_LABELS: Readonly<Record<VectorCornerKind, string>>;
+declare const VECTOR_ARROWHEAD_LABELS: Readonly<Record<VectorArrowhead, string>>;
 /** A paint as `#rrggbb` for `<input type="color">`, or null for none, gradients and other CSS colours. */
 declare function vectorPaintToHex(paint: VectorPaint | undefined): string | null;
 /** A path-editing button of the bundled toolbars. */
 interface VectorPathAction {
-    id: 'join' | 'average' | 'cut' | 'clean' | 'smooth';
+    id: 'join' | 'average' | 'cut' | 'clean' | 'smooth' | 'outline';
     label: string;
     title: string;
     /** Shortcut after Cmd / Ctrl, if any. */
@@ -1449,7 +1990,7 @@ interface VectorPathAction {
     enabled: (selected: number, points: number) => boolean;
     run: (controller: VectorEditorController) => unknown;
 }
-/** Join, Average, Cut at Points, Remove Redundant Points and Smooth, as the toolbars show them. */
+/** Join, Average, Cut at Points, Remove Redundant Points, Smooth and Outline Stroke, as the toolbars show them. */
 declare const VECTOR_PATH_ACTIONS: readonly VectorPathAction[];
 /** The on / off path-editing settings the toolbars toggle. */
 declare const VECTOR_EDIT_TOGGLES: readonly {
@@ -1677,4 +2218,142 @@ declare function vectorInkShapeName(shape: VectorInkShape): string;
  */
 declare function recognizeInkShape(points: readonly Point[], options?: RecognizeInkOptions): VectorInkShape | null;
 
-export { type AddVectorNodeOptions, AffineMatrix, DEFAULT_VECTOR_PATH_EDIT, DEFAULT_VECTOR_SNAP, IDENTITY_MATRIX, KAPPA, LazyMouse, type NearestSegment, type RecognizeInkOptions, SvgGradientDef, VECTOR_CLIPBOARD_TYPE, VECTOR_CONSTRUCTION_ANGLES, VECTOR_EDIT_TOGGLES, VECTOR_INK_MAX_CORNERS, VECTOR_OVERLAY_THEME, VECTOR_PATH_ACTIONS, VECTOR_PENCIL_STRING_PX, VECTOR_ROTATE_HANDLE_OFFSET, 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 VectorAverageAxis, type VectorBooleanOperation, type VectorBounds, type VectorCommandOptions, 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 VectorRenderGroup, type VectorRenderGuideLabel, type VectorRenderGuideLine, type VectorRenderHandle, type VectorRenderNode, type VectorRenderPath, type VectorScaleSnap, type VectorSceneRenderData, type VectorSegmentRef, type VectorSelectionBoxGeometry, type VectorSelectionFrame, type VectorSelectionStyle, type VectorShapeInput, type VectorSnapGuides, type VectorSnapKind, type VectorSnapLeave, type VectorSnapOptions, VectorSnapTargets, type VectorStyle, type VectorSubpath, type VectorSvgExportOptions, type VectorSvgImportOptions, type VectorTool, type VectorTransformHandle, type VectorViewport, applyMatrix, applyMatrixLinear, bendSegment, bezierToSubpaths, boundsFromPoints, boundsIntersect, cloneAnchor, cloneSubpath, cloneVectorDocument, cloneVectorNode, collectPathNodes, constrainToLeave, convertAnchor, createVectorCommands, curvatureMoveAnchor, cutSubpathAt, decomposeRigid, ellipseSubpath, eraseFromFill, eraseFromOutline, eraserRegion, findVectorNode, getAnchor, getAnchorWorld, getEditablePathIds, getTransformHandlePositions, getVectorOverlayRenderData, getVectorSceneRenderData, getVectorSelectionBoxGeometry, getVectorSelectionFrame, getVectorSelectionStyle, getVisibleAnchors, getVisibleHandles, hasPaint, hitTestVectorNode, hitTestVectorNodes, inferAnchorType, insertAnchor, invertMatrix, isIdentityMatrix, isVectorTextTarget, joinSubpaths, knifePath, lineSubpath, locateVectorNode, matrixRotation, moveAnchorHandle, multiplyMatrices, nearestSegment, nodeMatrix, parseSvgTransform, parseVectorSvg, polygonSubpath, polylineBounds, recognizeInkShape, rectSubpath, removeAnchorKeepingShape, removeAnchors, removeAnchorsKeepingShape, removeRedundantPoints, reverseSubpath, rotateMatrix, roundSubpaths, scaleFor, scaleMatrix, simplifyPolyline, smoothSubpath, splitIntoFaces, splitSubpathAt, starSubpath, subpathPointAt, subpathSegment, subpathSegmentCount, subpathsToBezier, toVectorKeyInput, toVectorModifiers, toVectorPointerInput, transformVectorNode, translateAnchor, translateMatrix, unionBounds, vectorDocumentToSvg, vectorInkShapeName, vectorNodeBounds, vectorNodeRotation, vectorNodeToBezier, vectorPaintToHex, vectorPaintToSvg, vectorParentMatrix, vectorPathData, vectorPathWorldBezier, vectorResizeCursor, vectorToolLabel, vectorWorldMatrix, walkVectorNodes };
+/** One arrowhead: a filled outline (nonzero) painted with the stroke's paint. */
+interface VectorArrowheadShape {
+    end: 'start' | 'end';
+    kind: VectorArrowhead;
+    tip: Vec2;
+    /** Unit direction the head points in. */
+    dir: Vec2;
+    /** Distance from the tip back to where the stroke ends under the head. */
+    inset: number;
+    path: BezierPath;
+}
+/** What the stroke of a path draws. */
+interface VectorStrokeParts {
+    /** Where the stroke sits (`center` for open shapes, whatever the style says). */
+    align: VectorStrokeAlign;
+    /** The line the stroke follows: the outline, shortened under `tip`-aligned heads. */
+    line: BezierPath;
+    /** The stroke width to draw `line` with: twice the style's width for inside / outside (half is clipped away). */
+    drawWidth: number;
+    heads: VectorArrowheadShape[];
+}
+/** True when the path has subpaths and all of them are closed (only such shapes have an inside). */
+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;
+/** 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. */
+declare function arrowheadInset(kind: VectorArrowhead, hw: number, cap: number): number;
+/** The outline of a `kind` head of weight `hw` with its tip at `tip`, pointing along unit `dir`. */
+declare function arrowheadPath(kind: VectorArrowhead, tip: Vec2, dir: Vec2, hw: number): BezierPath;
+/**
+ * The stroke of `path` as `style` draws it: its alignment, the line it follows (shortened under
+ * `tip`-aligned heads) and its arrowheads. Heads go on the start of the first subpath and the
+ * end of the last one, when those are open.
+ */
+declare function vectorStrokeParts(path: BezierPath, style: VectorStyle): VectorStrokeParts;
+/**
+ * The area the stroke paints, as one filled path: the outlined stroke (joins, caps and dashes
+ * as SVG) clipped by the alignment (against the fill, read with the style's `fillRule`), plus
+ * the arrowheads.
+ */
+declare function vectorStrokeOutlinePath(path: BezierPath, style: VectorStyle): BezierPath;
+/**
+ * Whether point `p` hits the stroke of `path` (`tolerance` added on every side): within half
+ * the width of the outline for a centred stroke, within the whole width on the inside or the
+ * outside of the fill for an aligned one, or on an arrowhead.
+ */
+declare function hitTestVectorStroke(path: BezierPath, p: Vec2, style: VectorStyle, tolerance?: number): boolean;
+/** How far the stroke can reach past the outline (for padding bounds and masks). */
+declare function vectorStrokeReach(style: VectorStyle): number;
+
+/**
+ * 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 };