@pixerate/editor 0.42.0 → 0.43.0

package/dist/vector/index.js

@@ -3,6 +3,7 @@ import {
 } from "../chunk-QVZZGT4X.js";
 import {
   PlanarMap,
+  angleToSvgLinearCoords,
   bezierPathBounds,
   bezierPathToSvg,
   closeContour,
@@ -14,7 +15,6 @@ import {
   fitCubics,
   flattenChain,
   formatNumber,
-  gradientToSvgDef,
   hatchPath,
   isStraightCubic,
   normalizeBezierPath,
@@ -41,17 +41,25 @@ import {
   windingNumber
 } from "../chunk-3LHWTGHW.js";
 import {
-  mixColorsOklab
+  mixColorsOklab,
+  oklabToRgb,
+  rgbToOklab
 } from "../chunk-ZRJMJIQU.js";
 import {
   evaluateEasing
 } from "../chunk-UB2OY7FD.js";
 import {
-  hexToRgba
+  hexToRgba,
+  normalizeTokenColor,
+  rgbaToHex
 } from "../chunk-TGD52FEZ.js";
 
 // src/vector/types.ts
 var VECTOR_CORNER_KINDS = ["round", "inverted", "chamfer"];
+var VECTOR_GRADIENT_TYPES = ["linear", "radial", "conic", "reflected", "diamond"];
+var VECTOR_GRADIENT_SPREADS = ["pad", "reflect", "repeat"];
+var VECTOR_GRADIENT_INTERPOLATIONS = ["srgb", "linear", "oklab"];
+var VECTOR_STROKE_GRADIENT_MODES = ["within", "along", "across"];
 var VECTOR_ARROWHEADS = ["triangle", "arrow", "open", "circle", "square", "bar"];
 var VECTOR_BLEND_SPACINGS = ["steps", "distance", "smoothColor"];
 var VECTOR_TOOLS = [
@@ -70,20 +78,824 @@ var VECTOR_TOOLS = [
   "width",
   "shapeBuilder",
   "paintBucket",
-  "blend"
+  "blend",
+  "gradient"
 ];
 var VECTOR_TRANSFORM_HANDLES = ["nw", "n", "ne", "e", "se", "s", "sw", "w", "rotate"];
 var VECTOR_PATHFINDER_OPERATIONS = ["divide", "trim", "merge", "crop", "outline", "minusBack"];
 var VECTOR_EFFECT_TYPES = ["trim", "roundCorners", "puckerBloat", "twist", "zigzag", "wiggle", "offset", "merge", "repeater"];
 var VECTOR_MERGE_MODES = ["merge", "add", "subtract", "intersect", "exclude"];
 
-// src/vector/corners.ts
-var EPS = 1e-9;
-var MIN_SINE = 1e-6;
+// src/vector/gradient.ts
+var clamp = (v2, lo, hi) => Math.min(hi, Math.max(lo, v2));
+var IDENTITY = [1, 0, 0, 1, 0, 0];
+var mul = (a, b) => [
+  b[0] * a[0] + b[2] * a[1],
+  b[1] * a[0] + b[3] * a[1],
+  b[0] * a[2] + b[2] * a[3],
+  b[1] * a[2] + b[3] * a[3],
+  b[0] * a[4] + b[2] * a[5] + b[4],
+  b[1] * a[4] + b[3] * a[5] + b[5]
+];
+var apply = (m, p) => ({ x: m[0] * p.x + m[2] * p.y + m[4], y: m[1] * p.x + m[3] * p.y + m[5] });
+var invert = (m) => {
+  const [a, b, c, d, e, f] = m;
+  const det = a * d - b * c;
+  if (!Number.isFinite(det) || Math.abs(det) < 1e-18) return null;
+  return [d / det, -b / det, -c / det, a / det, (c * f - d * e) / det, (b * e - a * f) / det];
+};
+var isIdentity = (m) => m[0] === 1 && m[1] === 0 && m[2] === 0 && m[3] === 1 && m[4] === 0 && m[5] === 0;
 var sub = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
 var add = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
-var mul = (a, k) => ({ x: a.x * k, y: a.y * k });
+var scale = (a, k) => ({ x: a.x * k, y: a.y * k });
 var dot = (a, b) => a.x * b.x + a.y * b.y;
+var perp = (v2) => ({ x: -v2.y, y: v2.x });
+var finitePoint = (p) => !!p && typeof p === "object" && Number.isFinite(p.x) && Number.isFinite(p.y);
+var fmt = (n, digits = 4) => {
+  const k = 10 ** digits;
+  const v2 = Math.round(n * k) / k;
+  return Object.is(v2, -0) ? "0" : String(v2);
+};
+var fmtMatrix = (m) => `matrix(${m.map((n) => fmt(n, 6)).join(" ")})`;
+function isVectorGradient(paint) {
+  return !!paint && typeof paint === "object" && VECTOR_GRADIENT_TYPES.includes(paint.type) && Array.isArray(paint.stops);
+}
+function parseVectorColor(color) {
+  const hex = normalizeTokenColor(color);
+  if (hex === null) return null;
+  const c = hexToRgba(hex);
+  return [c.r, c.g, c.b, c.a];
+}
+var toLinear = (c) => c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+var toGamma = (c) => {
+  const v2 = clamp(c, 0, 1);
+  return v2 <= 31308e-7 ? 12.92 * v2 : 1.055 * v2 ** (1 / 2.4) - 0.055;
+};
+function intoSpace(space, [r, g, b]) {
+  if (space === "linear") return [toLinear(r), toLinear(g), toLinear(b)];
+  if (space === "oklab") {
+    const c = rgbToOklab(r, g, b);
+    return [c.l, c.a, c.b];
+  }
+  return [r, g, b];
+}
+function outOfSpace(space, [x, y, z]) {
+  if (space === "linear") return [toGamma(x), toGamma(y), toGamma(z)];
+  if (space === "oklab") {
+    const c = oklabToRgb({ l: x, a: y, b: z, alpha: 1 });
+    return [c.r, c.g, c.b];
+  }
+  return [clamp(x, 0, 1), clamp(y, 0, 1), clamp(z, 0, 1)];
+}
+var MID_MIN = 0.01;
+var MID_MAX = 0.99;
+var VECTOR_GRADIENT_MIN_STOPS = 2;
+function gradientMidpointRemap(u, m) {
+  const mid = clamp(m, MID_MIN, MID_MAX);
+  if (Math.abs(mid - 0.5) < 1e-6) return u;
+  return u <= mid ? 0.5 * u / mid : 0.5 + 0.5 * (u - mid) / (1 - mid);
+}
+var hasMidpoint = (s) => s.midpoint !== void 0 && Number.isFinite(s.midpoint) && Math.abs(s.midpoint - 0.5) > 1e-3;
+function sortedVectorGradientStops(g) {
+  return (g.stops ?? []).filter((s) => s && Number.isFinite(s.offset) && typeof s.color === "string").map((s, i) => ({ s: { ...s, offset: clamp(s.offset, 0, 1) }, i })).sort((a, b) => a.s.offset - b.s.offset || a.i - b.i).map((e) => e.s);
+}
+function vectorGradientNeedsExpansion(g) {
+  return (g.interpolation ?? "srgb") !== "srgb" || (g.smoothness ?? 0) > 0 || (g.stops ?? []).some(hasMidpoint);
+}
+function vectorGradientRamp(g) {
+  const space = g.interpolation && VECTOR_GRADIENT_INTERPOLATIONS.includes(g.interpolation) ? g.interpolation : "srgb";
+  const smooth = clamp(Number.isFinite(g.smoothness) ? g.smoothness : 0, 0, 1);
+  const pts = [];
+  for (const s of sortedVectorGradientStops(g)) {
+    const c = parseVectorColor(s.color);
+    if (!c) return null;
+    pts.push({ t: s.offset, v: intoSpace(space, c), a: c[3] * clamp(s.opacity ?? 1, 0, 1), mid: s.midpoint ?? 0.5 });
+  }
+  return {
+    sample(t) {
+      const n = pts.length;
+      if (!n) return [0, 0, 0, 0];
+      const first = pts[0];
+      const last = pts[n - 1];
+      const at2 = (p) => [...outOfSpace(space, p.v), p.a];
+      if (!(t > first.t) || n < 2) return at2(first);
+      if (t >= last.t) return at2(last);
+      let i = 0;
+      while (i + 2 < n && !(t >= pts[i].t && t <= pts[i + 1].t)) i++;
+      const p0 = pts[i];
+      const p1 = pts[i + 1];
+      const h = Math.max(p1.t - p0.t, 1e-6);
+      const u = gradientMidpointRemap((t - p0.t) / h, p0.mid);
+      const alpha = p0.a + (p1.a - p0.a) * u;
+      if (smooth <= 0) return [...outOfSpace(space, [0, 1, 2].map((c) => p0.v[c] + (p1.v[c] - p0.v[c]) * u)), alpha];
+      const tangent2 = (k) => {
+        const [a, b] = k === 0 ? [0, 1] : k === n - 1 ? [n - 2, n - 1] : [k - 1, k + 1];
+        const d = Math.max(pts[b].t - pts[a].t, 1e-6);
+        const half = k === 0 || k === n - 1 ? 0.5 : 1;
+        return [0, 1, 2].map((c) => (pts[b].v[c] - pts[a].v[c]) / d * half);
+      };
+      const m0 = tangent2(i);
+      const m1 = tangent2(i + 1);
+      const u2 = u * u;
+      const u3 = u2 * u;
+      const h00 = 2 * u3 - 3 * u2 + 1;
+      const h10 = u3 - 2 * u2 + u;
+      const h01 = -2 * u3 + 3 * u2;
+      const h11 = u3 - u2;
+      const v2 = [0, 1, 2].map((c) => {
+        const linear = p0.v[c] + (p1.v[c] - p0.v[c]) * u;
+        const spline = h00 * p0.v[c] + h10 * h * m0[c] + h01 * p1.v[c] + h11 * h * m1[c];
+        const value = linear + (spline - linear) * smooth;
+        return clamp(value, Math.min(p0.v[c], p1.v[c]), Math.max(p0.v[c], p1.v[c]));
+      });
+      return [...outOfSpace(space, v2), alpha];
+    }
+  };
+}
+function sampleVectorGradient(g, t) {
+  const ramp = vectorGradientRamp(g);
+  if (ramp) {
+    const [r, gg, b, a] = ramp.sample(t);
+    return { color: rgbaToHex(r, gg, b), opacity: a };
+  }
+  const stops = sortedVectorGradientStops(g);
+  const s = [...stops].reverse().find((x) => x.offset <= t) ?? stops[0];
+  return s ? { color: s.color, opacity: s.opacity ?? 1 } : { color: "#000000", opacity: 0 };
+}
+var stopOf = (offset, c) => {
+  const color = rgbaToHex(c[0], c[1], c[2]);
+  const opacity = Math.round(c[3] * 1e4) / 1e4;
+  return opacity < 1 ? { offset, color, opacity } : { offset, color };
+};
+var maxDiff = (a, b) => Math.max(Math.abs(a[0] - b[0]), Math.abs(a[1] - b[1]), Math.abs(a[2] - b[2]), Math.abs(a[3] - b[3]));
+var lerpRgba = (a, b, u) => [0, 1, 2, 3].map((c) => a[c] + (b[c] - a[c]) * u);
+function expandVectorGradientStops(g, options = {}) {
+  const stops = sortedVectorGradientStops(g);
+  const plain3 = () => stops.map(({ offset, color, opacity }) => opacity !== void 0 && opacity !== 1 ? { offset, color, opacity } : { offset, color });
+  if (!vectorGradientNeedsExpansion(g)) return plain3();
+  const ramp = vectorGradientRamp(g);
+  if (!ramp || stops.length < 2) return plain3();
+  const tol = options.tolerance ?? 0.5 / 255;
+  const sRgbOnly = (g.interpolation ?? "srgb") === "srgb" && !((g.smoothness ?? 0) > 0);
+  const own = (s) => {
+    const c = parseVectorColor(s.color);
+    return [c[0], c[1], c[2], c[3] * clamp(s.opacity ?? 1, 0, 1)];
+  };
+  const out = [];
+  const push = (offset, c) => out.push(stopOf(offset, c));
+  for (let i = 0; i < stops.length; i++) {
+    const a = stops[i];
+    const b = stops[i + 1];
+    push(a.offset, own(a));
+    if (!b || b.offset - a.offset < 1e-9) continue;
+    const knots = [a.offset];
+    if (hasMidpoint(a)) knots.push(a.offset + (b.offset - a.offset) * clamp(a.midpoint, MID_MIN, MID_MAX));
+    knots.push(b.offset);
+    const inside = (t) => ramp.sample(clamp(t, a.offset + 1e-9, b.offset - 1e-9));
+    for (let k = 0; k + 1 < knots.length; k++) {
+      const t0 = knots[k];
+      const t1 = knots[k + 1];
+      if (k > 0) push(t0, inside(t0));
+      if (sRgbOnly) continue;
+      const refine = (x0, c0, x1, c1, depth) => {
+        const xm = (x0 + x1) / 2;
+        const cm = inside(xm);
+        const ok = depth >= 8 || [0.03, 0.1, 0.25, 0.5, 0.75, 0.9, 0.97].every((f) => maxDiff(inside(x0 + (x1 - x0) * f), lerpRgba(c0, c1, f)) <= tol);
+        if (ok) return;
+        refine(x0, c0, xm, cm, depth + 1);
+        push(xm, cm);
+        refine(xm, cm, x1, c1, depth + 1);
+      };
+      refine(t0, inside(t0), t1, inside(t1), 0);
+    }
+  }
+  return out;
+}
+function samplePlainStops(stops, t) {
+  const parsed = stops.map((s) => {
+    const c = parseVectorColor(s.color) ?? [0, 0, 0, 1];
+    return { t: s.offset, c: [c[0], c[1], c[2], c[3] * (s.opacity ?? 1)] };
+  });
+  if (!parsed.length) return [0, 0, 0, 0];
+  if (t <= parsed[0].t) return parsed[0].c;
+  for (let i = 0; i + 1 < parsed.length; i++) {
+    const a = parsed[i];
+    const b = parsed[i + 1];
+    if (t <= b.t) return b.t - a.t < 1e-12 ? b.c : lerpRgba(a.c, b.c, (t - a.t) / (b.t - a.t));
+  }
+  return parsed[parsed.length - 1].c;
+}
+function reverseVectorGradient(g) {
+  const stops = sortedVectorGradientStops(g).reverse();
+  const next = stops.map((s, i) => {
+    const following = stops[i + 1];
+    const mid = following ? 1 - (following.midpoint ?? 0.5) : 0.5;
+    const { midpoint: _m, ...rest } = s;
+    return { ...rest, offset: 1 - s.offset, ...Math.abs(mid - 0.5) > 1e-6 ? { midpoint: mid } : {} };
+  });
+  return { ...g, stops: next };
+}
+function placeStop(stops, stop) {
+  let i = stops.findIndex((o) => o.offset > stop.offset);
+  if (i < 0) i = stops.length;
+  stops.splice(i, 0, stop);
+  return i;
+}
+function insertVectorGradientStop(g, offset) {
+  const at2 = clamp(offset, 0, 1);
+  const { color, opacity } = sampleVectorGradient(g, at2);
+  const stops = sortedVectorGradientStops(g);
+  const index = placeStop(stops, opacity < 1 ? { offset: at2, color, opacity } : { offset: at2, color });
+  return { stops, index };
+}
+function moveVectorGradientStop(stops, index, offset) {
+  const next = stops.map((s2) => ({ ...s2 }));
+  if (index < 0 || index >= next.length) return { stops: next, index };
+  const [s] = next.splice(index, 1);
+  return { stops: next, index: placeStop(next, { ...s, offset: clamp(offset, 0, 1) }) };
+}
+function removeVectorGradientStop(stops, index) {
+  if (stops.length <= VECTOR_GRADIENT_MIN_STOPS || index < 0 || index >= stops.length) return null;
+  return stops.filter((_, i) => i !== index);
+}
+function vectorGradientMidpointPosition(stops, index) {
+  const a = stops[index];
+  const b = stops[index + 1];
+  if (!a || !b) return null;
+  return a.offset + (b.offset - a.offset) * (a.midpoint ?? 0.5);
+}
+function vectorGradientMidpointFromPosition(stops, index, pos) {
+  const a = stops[index];
+  const b = stops[index + 1];
+  if (!a || !b) return null;
+  const span = Math.max(b.offset - a.offset, 1e-6);
+  return clamp((pos - a.offset) / span, 0.05, 0.95);
+}
+function spanVectorGradientStops(g, from, to, expanded = expandVectorGradientStops(g)) {
+  if (to < from) {
+    const s = spanVectorGradientStops(g, to, from, expanded);
+    return s.map((x) => ({ ...x, offset: 1 - x.offset })).reverse();
+  }
+  const d = to - from;
+  const at2 = (offset, t) => stopOf(offset, samplePlainStops(expanded, t));
+  const out = [at2(0, from)];
+  if (d > 1e-9) {
+    for (const s of expanded) if (s.offset > from && s.offset < to) out.push({ ...s, offset: (s.offset - from) / d });
+  }
+  out.push(at2(1, to));
+  return out;
+}
+var hasExplicitGradientGeometry = (g) => finitePoint(g.start) && finitePoint(g.end);
+function shorthandPoints(g) {
+  if (g.type === "linear" || g.type === "reflected") {
+    const c = angleToSvgLinearCoords(Number.isFinite(g.angle) ? g.angle : 180);
+    const start2 = g.type === "linear" ? { x: c.x1, y: c.y1 } : { x: 0.5, y: 0.5 };
+    const end = { x: c.x2, y: c.y2 };
+    return { start: start2, end, width: add(start2, perp(sub(end, start2))) };
+  }
+  const start = { x: Number.isFinite(g.cx) ? g.cx : 0.5, y: Number.isFinite(g.cy) ? g.cy : 0.5 };
+  const r = Number.isFinite(g.r) ? g.r : 0.5;
+  if (g.type === "radial") return { start, end: { x: start.x + r, y: start.y }, width: { x: start.x, y: start.y + r } };
+  const a = (Number.isFinite(g.angle) ? g.angle : 90) * Math.PI / 180;
+  const dir = { x: Math.sin(a), y: -Math.cos(a) };
+  return { start, end: add(start, scale(dir, r)), width: add(start, scale(perp(dir), r)) };
+}
+function vectorGradientPoints(g) {
+  const explicit = hasExplicitGradientGeometry(g);
+  const base = explicit ? null : shorthandPoints(g);
+  const start = explicit ? { x: g.start.x, y: g.start.y } : base.start;
+  const end = explicit ? { x: g.end.x, y: g.end.y } : base.end;
+  const width = explicit ? finitePoint(g.width) ? { x: g.width.x, y: g.width.y } : add(start, perp(sub(end, start))) : base.width;
+  return {
+    start,
+    end,
+    width,
+    focal: g.type === "radial" && finitePoint(g.focal) ? { x: g.focal.x, y: g.focal.y } : null,
+    focalRadius: g.type === "radial" ? clamp(Number.isFinite(g.focalRadius) ? g.focalRadius : 0, 0, 0.99) : 0,
+    units: explicit && g.units === "userSpaceOnUse" ? "userSpaceOnUse" : "objectBoundingBox"
+  };
+}
+function vectorBoxMatrix(bounds) {
+  if (!bounds) return IDENTITY;
+  let { x, y, width: w, height: h } = bounds;
+  const fallback = Math.max(w, h, 1e-9) > 1e-9 ? Math.max(w, h) : 1;
+  if (!(w > 1e-9)) {
+    x -= fallback / 2 - w / 2;
+    w = fallback;
+  }
+  if (!(h > 1e-9)) {
+    y -= fallback / 2 - h / 2;
+    h = fallback;
+  }
+  return [w, 0, 0, h, x, y];
+}
+var framePointsMatrix = (p) => [p.end.x - p.start.x, p.end.y - p.start.y, p.width.x - p.start.x, p.width.y - p.start.y, p.start.x, p.start.y];
+function vectorGradientUnitsMatrix(g, bounds) {
+  return vectorGradientPoints(g).units === "objectBoundingBox" ? vectorBoxMatrix(bounds) : IDENTITY;
+}
+function vectorGradientMatrix(g, bounds) {
+  return mul(framePointsMatrix(vectorGradientPoints(g)), vectorGradientUnitsMatrix(g, bounds));
+}
+var FOCAL_MAX = 0.99;
+function unitFocal(g) {
+  const p = vectorGradientPoints(g);
+  if (!p.focal && !(p.focalRadius > 0)) return null;
+  const inv = invert(framePointsMatrix(p));
+  if (!inv) return null;
+  let f = p.focal ? apply(inv, p.focal) : { x: 0, y: 0 };
+  const reach = FOCAL_MAX * (1 - p.focalRadius);
+  const r = Math.hypot(f.x, f.y);
+  if (r > reach) f = scale(f, reach / r);
+  return { f, fr: p.focalRadius };
+}
+function vectorGradientFocalParam(q, f = { x: 0, y: 0 }, fr = 0) {
+  const d = sub(q, f);
+  const dr = 1 - fr;
+  const a = dot(f, f) - dr * dr;
+  const b = dot(d, f) - fr * dr;
+  const c = dot(d, d) - fr * fr;
+  if (Math.abs(a) < 1e-12) return Math.abs(b) < 1e-12 ? 0 : -c / (2 * b);
+  return (-b - Math.sqrt(Math.max(0, b * b - a * c))) / a;
+}
+function vectorGradientParam(type, q, focal) {
+  switch (type) {
+    case "linear":
+      return q.x;
+    case "reflected":
+      return Math.abs(q.x);
+    case "diamond":
+      return Math.abs(q.x) + Math.abs(q.y);
+    case "conic": {
+      const turn = Math.atan2(q.y, q.x) / (2 * Math.PI);
+      return turn - Math.floor(turn);
+    }
+    case "radial":
+      return focal ? vectorGradientFocalParam(q, focal.f, focal.fr) : Math.hypot(q.x, q.y);
+  }
+}
+function applyVectorGradientSpread(t, spread = "pad") {
+  if (!Number.isFinite(t)) return 0;
+  if (spread === "repeat") return t - Math.floor(t);
+  if (spread === "reflect") {
+    const m = (t % 2 + 2) % 2;
+    return m <= 1 ? m : 2 - m;
+  }
+  return clamp(t, 0, 1);
+}
+function vectorGradientTAt(g, bounds, p) {
+  const inv = invert(vectorGradientMatrix(g, bounds));
+  if (!inv) return 0;
+  const raw = vectorGradientParam(g.type, apply(inv, p), g.type === "radial" ? unitFocal(g) : null);
+  return g.type === "conic" ? raw : applyVectorGradientSpread(raw, g.spread ?? "pad");
+}
+function sampleVectorGradientAt(g, bounds, p) {
+  const t = vectorGradientTAt(g, bounds, p);
+  const ramp = vectorGradientRamp(g);
+  return ramp ? ramp.sample(t) : samplePlainStops(sortedVectorGradientStops(g), t);
+}
+function vectorGradientAspect(g) {
+  const p = vectorGradientPoints(g);
+  const u = sub(p.end, p.start);
+  const l2 = dot(u, u);
+  return l2 > 1e-18 ? dot(sub(p.width, p.start), perp(u)) / l2 : 1;
+}
+function explicitVectorGradient(g) {
+  const p = vectorGradientPoints(g);
+  const { angle: _a, cx: _cx, cy: _cy, r: _r, ...rest } = g;
+  return {
+    ...rest,
+    start: p.start,
+    end: p.end,
+    width: p.width,
+    ...p.focal ? { focal: p.focal } : {},
+    units: p.units
+  };
+}
+function pinVectorGradient(g, bounds) {
+  const e = explicitVectorGradient(g);
+  if (e.units === "userSpaceOnUse") return e;
+  const m = vectorBoxMatrix(bounds);
+  return { ...e, start: apply(m, e.start), end: apply(m, e.end), width: apply(m, e.width), ...e.focal ? { focal: apply(m, e.focal) } : {}, units: "userSpaceOnUse" };
+}
+function transformVectorGradient(g, m) {
+  if (!hasExplicitGradientGeometry(g) || g.units !== "userSpaceOnUse" || isIdentity(m)) return g;
+  const p = vectorGradientPoints(g);
+  return { ...g, start: apply(m, p.start), end: apply(m, p.end), width: apply(m, p.width), ...p.focal ? { focal: apply(m, p.focal) } : {} };
+}
+function transformVectorPaint(paint, m) {
+  return isVectorGradient(paint) ? transformVectorGradient(paint, m) : paint;
+}
+var isCentredVectorGradient = (type) => type === "radial" || type === "conic" || type === "diamond";
+function vectorGradientHandles(g, bounds, toWorld = IDENTITY) {
+  const p = vectorGradientPoints(g);
+  const m = mul(vectorGradientUnitsMatrix(g, bounds), toWorld);
+  const f = g.type === "radial" ? unitFocal(g) : null;
+  const frame2 = mul(framePointsMatrix(p), m);
+  return {
+    start: apply(m, p.start),
+    end: apply(m, p.end),
+    aspect: isCentredVectorGradient(g.type) ? apply(m, p.width) : null,
+    focal: g.type === "radial" ? apply(frame2, f?.f ?? { x: 0, y: 0 }) : null
+  };
+}
+function withMainAxis(p, start, end) {
+  const before = invert(framePointsMatrix(p));
+  const u = sub(p.end, p.start);
+  const l2 = dot(u, u);
+  const w = sub(p.width, p.start);
+  const rel = l2 > 1e-18 ? { a: dot(w, u) / l2, b: dot(w, perp(u)) / l2 } : { a: 0, b: 1 };
+  const u2 = sub(end, start);
+  const width = add(start, add(scale(u2, rel.a), scale(perp(u2), rel.b)));
+  const next = { start, end, width };
+  const focal = p.focal && before ? apply(framePointsMatrix(next), apply(before, p.focal)) : p.focal;
+  return { ...next, focal };
+}
+function moveVectorGradientHandle(g, bounds, handle, to, from = to) {
+  const pinned = pinVectorGradient(g, bounds);
+  const p = vectorGradientPoints(pinned);
+  const set = (q) => {
+    const next = { ...pinned, ...q };
+    if (next.focal === null || next.focal === void 0) delete next.focal;
+    return next;
+  };
+  switch (handle) {
+    case "start": {
+      const d = sub(to, from);
+      return set({ start: add(p.start, d), end: add(p.end, d), width: add(p.width, d), focal: p.focal ? add(p.focal, d) : null });
+    }
+    case "end":
+    case "radius": {
+      if (Math.hypot(to.x - p.start.x, to.y - p.start.y) < 1e-6) return pinned;
+      const n = withMainAxis(p, p.start, to);
+      return set({ end: n.end, width: n.width, focal: n.focal });
+    }
+    case "aspect": {
+      const u = sub(p.end, p.start);
+      const l2 = dot(u, u);
+      if (l2 < 1e-18) return pinned;
+      let aspect = dot(sub(to, p.start), perp(u)) / l2;
+      if (Math.abs(aspect) < 0.01) aspect = aspect < 0 ? -0.01 : 0.01;
+      const before = invert(framePointsMatrix(p));
+      const width = add(p.start, scale(perp(u), aspect));
+      const focal = p.focal && before ? apply(framePointsMatrix({ start: p.start, end: p.end, width }), apply(before, p.focal)) : null;
+      return set({ width, focal });
+    }
+    case "focal": {
+      const frame2 = framePointsMatrix(p);
+      const inv = invert(frame2);
+      if (!inv) return pinned;
+      let q = apply(inv, to);
+      const r = Math.hypot(q.x, q.y);
+      if (r < 1e-6) return set({ focal: null });
+      const reach = FOCAL_MAX * (1 - p.focalRadius);
+      if (r > reach) q = scale(q, reach / r);
+      return set({ focal: apply(frame2, q) });
+    }
+  }
+}
+function setVectorGradientVector(g, bounds, start, end) {
+  const pinned = pinVectorGradient(g, bounds);
+  const p = vectorGradientPoints(pinned);
+  const aspect = Math.abs(vectorGradientAspect(pinned)) > 1e-6 ? vectorGradientAspect(pinned) : 1;
+  const u = sub(end, start);
+  const width = add(start, scale(perp(u), aspect));
+  const before = invert(framePointsMatrix(p));
+  const focal = p.focal && before ? apply(framePointsMatrix({ start, end, width }), apply(before, p.focal)) : null;
+  const next = { ...pinned, start, end, width };
+  if (focal) next.focal = focal;
+  else delete next.focal;
+  return next;
+}
+var VECTOR_GRADIENT_MAX_PERIODS = 64;
+function wholePeriod(stops) {
+  const out = stops.map((s) => ({ ...s }));
+  if (out.length && out[0].offset > 0) out.unshift({ ...out[0], offset: 0 });
+  const last = out[out.length - 1];
+  if (last && last.offset < 1) out.push({ ...last, offset: 1 });
+  return out;
+}
+function periodicVectorGradientStops(stops, lo, hi, mirrored) {
+  const period = wholePeriod(stops);
+  const back = reverseVectorGradient({ stops: period }).stops;
+  const n = Math.max(1, hi - lo);
+  const out = [];
+  for (let j = 0; j < n; j++) {
+    const one = mirrored(lo + j) ? back : period;
+    for (const s of one) out.push({ ...s, offset: (j + s.offset) / n });
+  }
+  return out;
+}
+function expandVectorGradientSpread(g, bounds, area) {
+  const m = vectorGradientMatrix(g, bounds);
+  const inv = invert(m);
+  const spread = g.spread ?? "pad";
+  const reflected = g.type === "reflected";
+  if (!inv || !reflected && spread === "pad") return null;
+  const odd = (k) => (k % 2 + 2) % 2 === 1;
+  const stops = expandVectorGradientStops(g);
+  const along2 = (a, b, mirrored2, capped2 = false) => ({
+    start: apply(m, { x: a, y: 0 }),
+    end: apply(m, { x: b, y: 0 }),
+    from: a,
+    to: b,
+    matrix: m,
+    stops: periodicVectorGradientStops(stops, a, b, mirrored2),
+    capped: capped2
+  });
+  if (reflected && spread === "pad") return along2(-1, 1, (k) => k < 0);
+  const us = boxCorners(area).map((c) => apply(inv, c).x);
+  let lo = Math.floor(Math.min(...us));
+  let hi = Math.ceil(Math.max(...us));
+  if (reflected) {
+    lo = Math.min(lo, -1);
+    hi = Math.max(hi, 1);
+  }
+  hi = Math.max(hi, lo + 1);
+  if (!reflected && lo >= 0 && hi <= 1) return null;
+  const capped = hi - lo > VECTOR_GRADIENT_MAX_PERIODS;
+  if (capped) {
+    lo = Math.max(lo, -VECTOR_GRADIENT_MAX_PERIODS / 2);
+    hi = lo + VECTOR_GRADIENT_MAX_PERIODS;
+  }
+  const mirrored = reflected ? (k) => {
+    const j = k >= 0 ? k : -k - 1;
+    const own = spread === "reflect" && odd(j);
+    return k < 0 ? !own : own;
+  } : (k) => spread === "reflect" && odd(k);
+  return along2(lo, hi, mirrored, capped);
+}
+var boxCorners = (b) => [
+  { x: b.x, y: b.y },
+  { x: b.x + b.width, y: b.y },
+  { x: b.x + b.width, y: b.y + b.height },
+  { x: b.x, y: b.y + b.height }
+];
+var toSvgStops = (stops) => stops.map((s) => ({ offset: `${fmt(s.offset * 100, 3)}%`, stopColor: s.color, ...s.opacity !== void 0 && s.opacity !== 1 ? { stopOpacity: Math.round(s.opacity * 1e4) / 1e4 } : {} }));
+var polygonD = (pts, precision) => `M${pts.map((p) => `${fmt(p.x, precision)} ${fmt(p.y, precision)}`).join("L")}Z`;
+var padBounds = (b, pad) => ({ x: b.x - pad, y: b.y - pad, width: b.width + 2 * pad, height: b.height + 2 * pad });
+var vectorGradientArea = (bounds) => padBounds(bounds ?? { x: 0, y: 0, width: 1, height: 1 }, 1);
+var transformAttr = (m) => isIdentity(m) ? {} : { gradientTransform: fmtMatrix(m) };
+function minScale(m) {
+  const [a, b, c, d] = m;
+  const p = a * a + b * b;
+  const q = c * c + d * d;
+  const r = a * c + b * d;
+  return Math.sqrt(Math.max(0, (p + q - Math.sqrt((p - q) ** 2 + 4 * r * r)) / 2));
+}
+function patternAttrs(area) {
+  const [x, y, w, h] = [area.x, area.y, Math.max(area.width, 1e-3), Math.max(area.height, 1e-3)].map((n) => fmt(n, 3));
+  return { patternUnits: "userSpaceOnUse", x, y, width: w, height: h, viewBox: `${x} ${y} ${w} ${h}` };
+}
+function patternDef(id, area, gradients, tiles) {
+  return {
+    id,
+    type: "pattern",
+    attrs: patternAttrs(area),
+    gradients,
+    tiles
+  };
+}
+function vectorGradientSvgDefs(g, id, options = {}) {
+  const precision = options.precision ?? 3;
+  const bounds = options.bounds ?? null;
+  const area = options.area ?? vectorGradientArea(bounds);
+  const spread = g.spread && VECTOR_GRADIENT_SPREADS.includes(g.spread) ? g.spread : "pad";
+  const stops = expandVectorGradientStops(g);
+  const p = vectorGradientPoints(g);
+  const unitsM = vectorGradientUnitsMatrix(g, bounds);
+  const frameM = mul(framePointsMatrix(p), unitsM);
+  const spreadAttr = (s) => s === "pad" ? {} : { spreadMethod: s };
+  const base = { gradientUnits: "userSpaceOnUse" };
+  switch (g.type) {
+    case "linear":
+    case "reflected": {
+      if (g.type === "reflected" && spread !== "reflect") {
+        const ex = expandVectorGradientSpread(g, bounds, area);
+        const [a, b] = ex ? [ex.from, ex.to] : [-1, 1];
+        const st = ex?.stops ?? periodicVectorGradientStops(stops, -1, 1, (k) => k < 0);
+        return [{ id, type: "linear", attrs: { ...base, x1: a, y1: 0, x2: b, y2: 0, gradientTransform: fmtMatrix(frameM) }, stops: toSvgStops(st) }];
+      }
+      const u = sub(p.end, p.start);
+      const w = sub(p.width, p.start);
+      const square = Math.abs(dot(u, w)) <= 1e-9 * Math.max(dot(u, u), dot(w, w), 1e-18);
+      const coords = square ? { x1: fmt(p.start.x, 6), y1: fmt(p.start.y, 6), x2: fmt(p.end.x, 6), y2: fmt(p.end.y, 6), ...transformAttr(unitsM) } : { x1: 0, y1: 0, x2: 1, y2: 0, gradientTransform: fmtMatrix(frameM) };
+      return [{ id, type: "linear", attrs: { ...base, ...coords, ...spreadAttr(spread) }, stops: toSvgStops(stops) }];
+    }
+    case "radial": {
+      const f = unitFocal(g);
+      const attrs = { ...base, cx: 0, cy: 0, r: 1, gradientTransform: fmtMatrix(frameM), ...spreadAttr(spread) };
+      if (f && (Math.abs(f.f.x) > 1e-9 || Math.abs(f.f.y) > 1e-9)) {
+        attrs.fx = fmt(f.f.x, 6);
+        attrs.fy = fmt(f.f.y, 6);
+      }
+      if (f && f.fr > 0) attrs.fr = fmt(f.fr, 6);
+      return [{ id, type: "radial", attrs, stops: toSvgStops(stops) }];
+    }
+    case "diamond": {
+      const inv = invert(frameM);
+      if (!inv) return [patternDef(id, area, [], [{ d: polygonD(boxCorners(area), precision), fill: stops[stops.length - 1]?.color ?? "none" }])];
+      const reach = 2 * Math.max(...boxCorners(area).map((c) => {
+        const q = apply(inv, c);
+        return Math.abs(q.x) + Math.abs(q.y);
+      })) + 1;
+      const delta = Math.min(0.05 * reach, 0.75 / Math.max(minScale(frameM), 1e-9));
+      const gradients = [];
+      const tiles = [];
+      [[1, 1], [-1, 1], [-1, -1], [1, -1]].forEach(([sx, sy], k) => {
+        const gid = `${id}-q${k}`;
+        gradients.push({ id: gid, type: "linear", attrs: { ...base, x1: 0, y1: 0, x2: sx / 2, y2: sy / 2, gradientTransform: fmtMatrix(frameM), ...spreadAttr(spread) }, stops: toSvgStops(stops) });
+        const quad = [{ x: -delta * sx, y: -delta * sy }, { x: reach * sx, y: -delta * sy }, { x: -delta * sx, y: reach * sy }].map((q) => apply(frameM, q));
+        tiles.push({ d: polygonD(quad, precision), fill: `url(#${gid})` });
+      });
+      return [patternDef(id, area, gradients, tiles)];
+    }
+    case "conic":
+      return [conicPattern(id, frameM, stops, area, options.wedges ?? 72, precision)];
+  }
+}
+function conicPattern(id, frameM, stops, area, wedges, precision) {
+  const inv = invert(frameM);
+  const n = Math.max(8, Math.min(720, Math.round(wedges)));
+  const half = Math.PI / n;
+  if (!inv || !stops.length) return patternDef(id, area, [], [{ d: polygonD(boxCorners(area), precision), fill: stops[0]?.color ?? "none" }]);
+  const reach = (Math.max(...boxCorners(area).map((c) => Math.hypot(apply(inv, c).x, apply(inv, c).y))) + 1) / Math.cos(half);
+  const overlap = Math.min(half, 2e-3);
+  const gradients = [];
+  const tiles = [];
+  for (let k = 0; k < n; k++) {
+    const a0 = 2 * Math.PI * k / n;
+    const a1 = 2 * Math.PI * (k + 1) / n;
+    const mid = (a0 + a1) / 2;
+    const tau = { x: -Math.sin(mid), y: Math.cos(mid) };
+    const s = Math.sin(half);
+    const at2 = (angle) => (Math.sin(angle - mid) / s + 1) / 2;
+    const t0 = k / n;
+    const t1 = (k + 1) / n;
+    const own = [stopOf(0, samplePlainStops(stops, t0))];
+    for (const st of stops) if (st.offset > t0 && st.offset < t1) own.push({ ...st, offset: at2(st.offset * 2 * Math.PI) });
+    own.push(stopOf(1, samplePlainStops(stops, t1)));
+    const gid = `${id}-w${k}`;
+    gradients.push({
+      id: gid,
+      type: "linear",
+      attrs: { gradientUnits: "userSpaceOnUse", x1: fmt(-s * tau.x, 6), y1: fmt(-s * tau.y, 6), x2: fmt(s * tau.x, 6), y2: fmt(s * tau.y, 6), gradientTransform: fmtMatrix(frameM) },
+      stops: toSvgStops(own)
+    });
+    const from = a0 - (k === 0 ? 0 : overlap);
+    const pts = [{ x: 0, y: 0 }, { x: reach * Math.cos(from), y: reach * Math.sin(from) }, { x: reach * Math.cos(a1), y: reach * Math.sin(a1) }].map((q) => apply(frameM, q));
+    tiles.push({ d: polygonD(pts, precision), fill: `url(#${gid})` });
+  }
+  return patternDef(id, area, gradients, tiles);
+}
+var num = (v2, fallback = 0) => {
+  if (v2 === void 0) return fallback;
+  const n = typeof v2 === "number" ? v2 : parseFloat(v2);
+  return Number.isFinite(n) ? n : fallback;
+};
+var parseMatrixAttr = (v2) => {
+  const m = typeof v2 === "string" ? /^matrix\(([^)]*)\)$/.exec(v2.trim()) : null;
+  if (!m) return IDENTITY;
+  const n = m[1].split(/[\s,]+/).map(Number);
+  return n.length === 6 && n.every(Number.isFinite) ? n : IDENTITY;
+};
+var plainOf = (stops) => stops.map((s) => ({ offset: parseFloat(s.offset) / (s.offset.endsWith("%") ? 100 : 1), color: s.stopColor, ...s.stopOpacity !== void 0 ? { opacity: s.stopOpacity } : {} }));
+function inTile(d, p) {
+  const n = d.match(/-?[\d.]+(?:e-?\d+)?/gi)?.map(Number) ?? [];
+  let inside = false;
+  for (let i = 0, j = n.length - 2; i + 1 < n.length; j = i, i += 2) {
+    const [xi, yi, xj, yj] = [n[i], n[i + 1], n[j], n[j + 1]];
+    if (yi > p.y !== yj > p.y && p.x < (xj - xi) * (p.y - yi) / (yj - yi) + xi) inside = !inside;
+  }
+  return inside;
+}
+function sampleVectorPaintDefAt(defs, id, p) {
+  const all = /* @__PURE__ */ new Map();
+  for (const d of defs) {
+    all.set(d.id, d);
+    if (d.type === "pattern") for (const gd of d.gradients) all.set(gd.id, gd);
+  }
+  const paint = (ref, q) => {
+    const url = /^url\(#(.+)\)$/.exec(ref);
+    if (!url) return parseVectorColor(ref);
+    const def = all.get(url[1]);
+    if (!def) return null;
+    if (def.type === "pattern") {
+      for (let i = def.tiles.length - 1; i >= 0; i--) if (inTile(def.tiles[i].d, q)) return paint(def.tiles[i].fill, q);
+      return null;
+    }
+    const inv = invert(parseMatrixAttr(def.attrs.gradientTransform)) ?? IDENTITY;
+    const local = apply(inv, q);
+    const spread = def.attrs.spreadMethod ?? "pad";
+    let t;
+    if (def.type === "radial") {
+      const r = num(def.attrs.r, 0.5);
+      const c = { x: num(def.attrs.cx), y: num(def.attrs.cy) };
+      const f = { x: num(def.attrs.fx, c.x), y: num(def.attrs.fy, c.y) };
+      const u = { x: (local.x - c.x) / r, y: (local.y - c.y) / r };
+      t = vectorGradientFocalParam(u, { x: (f.x - c.x) / r, y: (f.y - c.y) / r }, num(def.attrs.fr) / r);
+    } else {
+      const a = { x: num(def.attrs.x1), y: num(def.attrs.y1) };
+      const b = { x: num(def.attrs.x2, 1), y: num(def.attrs.y2) };
+      const v2 = sub(b, a);
+      const l2 = dot(v2, v2);
+      t = l2 > 1e-18 ? dot(sub(local, a), v2) / l2 : 0;
+    }
+    return samplePlainStops(plainOf(def.stops), applyVectorGradientSpread(t, spread));
+  };
+  return paint(`url(#${id})`, p);
+}
+var readPoint = (v2) => finitePoint(v2) ? { x: v2.x, y: v2.y } : void 0;
+function sanitizeVectorGradient(input) {
+  if (!input || typeof input !== "object") return null;
+  const r = input;
+  if (!VECTOR_GRADIENT_TYPES.includes(r.type) || !Array.isArray(r.stops)) return null;
+  const stops = [];
+  for (const s of r.stops) {
+    if (!s || typeof s !== "object") continue;
+    const x = s;
+    if (typeof x.color !== "string" || typeof x.offset !== "number" || !Number.isFinite(x.offset)) continue;
+    const stop = { offset: clamp(x.offset, 0, 1), color: x.color.slice(0, 100) };
+    if (typeof x.opacity === "number" && Number.isFinite(x.opacity) && x.opacity !== 1) stop.opacity = clamp(x.opacity, 0, 1);
+    if (typeof x.midpoint === "number" && Number.isFinite(x.midpoint) && Math.abs(x.midpoint - 0.5) > 1e-6) stop.midpoint = clamp(x.midpoint, 0.05, 0.95);
+    stops.push(stop);
+  }
+  if (!stops.length) return null;
+  const g = { type: r.type, stops };
+  for (const k of ["angle", "cx", "cy", "r"]) if (typeof r[k] === "number" && Number.isFinite(r[k])) g[k] = r[k];
+  const start = readPoint(r.start);
+  const end = readPoint(r.end);
+  if (start && end) {
+    g.start = start;
+    g.end = end;
+    const width = readPoint(r.width);
+    if (width) g.width = width;
+    if (r.units === "userSpaceOnUse" || r.units === "objectBoundingBox") g.units = r.units;
+  }
+  const focal = readPoint(r.focal);
+  if (focal && g.type === "radial") g.focal = focal;
+  if (typeof r.focalRadius === "number" && r.focalRadius > 0 && g.type === "radial") g.focalRadius = clamp(r.focalRadius, 0, 0.99);
+  if (VECTOR_GRADIENT_SPREADS.includes(r.spread) && r.spread !== "pad") g.spread = r.spread;
+  if (VECTOR_GRADIENT_INTERPOLATIONS.includes(r.interpolation) && r.interpolation !== "srgb") g.interpolation = r.interpolation;
+  if (typeof r.smoothness === "number" && r.smoothness > 0) g.smoothness = clamp(r.smoothness, 0, 1);
+  if (VECTOR_STROKE_GRADIENT_MODES.includes(r.strokeMode) && r.strokeMode !== "within") g.strokeMode = r.strokeMode;
+  return g;
+}
+function convertVectorGradient(g, type) {
+  if (g.type === type) return g;
+  const next = { ...g, type };
+  if (type !== "radial") {
+    delete next.focal;
+    delete next.focalRadius;
+  }
+  if (!hasExplicitGradientGeometry(g)) {
+    if (isCentredVectorGradient(type) !== isCentredVectorGradient(g.type)) {
+      delete next.angle;
+      delete next.cx;
+      delete next.cy;
+      delete next.r;
+    }
+  }
+  return next;
+}
+function defaultVectorGradient(type = "linear", from) {
+  if (isVectorGradient(from)) return convertVectorGradient(from, type);
+  const colour = typeof from === "string" && parseVectorColor(from) ? from : "#000000";
+  return { type, stops: [{ offset: 0, color: colour }, { offset: 1, color: "#ffffff" }] };
+}
+function applyVectorGradientPatch(g, patch) {
+  const { aspect, reverse: reverse2, type, ...fields } = patch;
+  let next = type && type !== g.type ? convertVectorGradient(g, type) : { ...g };
+  const record = next;
+  for (const [k, v2] of Object.entries(fields)) {
+    if (v2 === void 0) continue;
+    if (v2 === null) delete record[k];
+    else record[k] = v2;
+  }
+  if ((fields.start || fields.end) && !hasExplicitGradientGeometry(next)) {
+    const p = vectorGradientPoints({ ...g, start: void 0, end: void 0 });
+    next.start = next.start ?? p.start;
+    next.end = next.end ?? p.end;
+  }
+  if (aspect !== void 0 && Number.isFinite(aspect)) {
+    const e = explicitVectorGradient(next);
+    const u = sub(e.end, e.start);
+    const a = Math.abs(aspect) < 0.01 ? aspect < 0 ? -0.01 : 0.01 : aspect;
+    next = { ...e, width: add(e.start, scale(perp(u), a)) };
+  }
+  if (reverse2) next = reverseVectorGradient(next);
+  const clean2 = sanitizeVectorGradient(next);
+  if (!clean2) return null;
+  clean2.stops = sortedVectorGradientStops(clean2);
+  return clean2;
+}
+
+// src/vector/corners.ts
+var EPS = 1e-9;
+var MIN_SINE = 1e-6;
+var sub2 = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
+var add2 = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
+var mul2 = (a, k) => ({ x: a.x * k, y: a.y * k });
+var dot2 = (a, b) => a.x * b.x + a.y * b.y;
 var cross = (a, b) => a.x * b.y - a.y * b.x;
 var len = (a) => Math.hypot(a.x, a.y);
 var pt = (p) => [p.x, p.y];
@@ -102,9 +914,9 @@ var Side = class {
   direction() {
     const p0 = vec(this.curve[0]);
     for (const q of this.curve.slice(1)) {
-      const d = sub(vec(q), p0);
+      const d = sub2(vec(q), p0);
       const l = len(d);
-      if (l > EPS) return mul(d, 1 / l);
+      if (l > EPS) return mul2(d, 1 / l);
     }
     return null;
   }
@@ -112,12 +924,12 @@ var Side = class {
   at(s, u) {
     if (this.straight) {
       const t2 = this.length > EPS ? Math.min(1, Math.max(0, s / this.length)) : 0;
-      return { t: t2, p: add(vec(this.curve[0]), mul(u, s)), dir: u };
+      return { t: t2, p: add2(vec(this.curve[0]), mul2(u, s)), dir: u };
     }
     const t = segmentParamAtLength(this.curve, s, this.length);
     const d = vec(segmentDerivative(this.curve, t));
     const l = len(d);
-    return { t, p: vec(segmentPoint(this.curve, t)), dir: l > EPS ? mul(d, 1 / l) : u };
+    return { t, p: vec(segmentPoint(this.curve, t)), dir: l > EPS ? mul2(d, 1 / l) : u };
   }
 };
 function cornerOf(sp, s, i) {
@@ -136,7 +948,7 @@ function cornerOf(sp, s, i) {
   const lu = sideU.length;
   const lv = sideV.length;
   if (!(lu > EPS && lv > EPS) || !Number.isFinite(lu) || !Number.isFinite(lv)) return null;
-  const cos = Math.max(-1, Math.min(1, dot(u, v2)));
+  const cos = Math.max(-1, Math.min(1, dot2(u, v2)));
   const sin = Math.abs(cross(u, v2));
   if (sin <= MIN_SINE) return null;
   return { subpath: s, index: i, at: { x: a.x, y: a.y }, u, v: v2, lu, lv, cos, sin, angle: Math.atan2(sin, cos) * 180 / Math.PI, maxRadius: Math.min(lu, lv) / 2 * sin / (1 + cos), sideU, sideV };
@@ -158,8 +970,8 @@ function vectorCorners(subpaths) {
 }
 var cornerSetback = (c, r) => r * (1 + c.cos) / c.sin;
 var fitCornerRadius = (c, radius) => Number.isFinite(radius) ? Math.min(Math.max(0, radius), c.maxRadius) : 0;
-var cornerBisectorPoint = (c, k) => add(c.at, mul(add(c.u, c.v), k));
-var cornerRadiusChange = (c, d) => dot(d, add(c.u, c.v)) * c.sin / (2 + 2 * c.cos);
+var cornerBisectorPoint = (c, k) => add2(c.at, mul2(add2(c.u, c.v), k));
+var cornerRadiusChange = (c, d) => dot2(d, add2(c.u, c.v)) * c.sin / (2 + 2 * c.cos);
 function arcHandle(cos) {
   const c = Math.max(-1, Math.min(1, cos));
   const sinHalf = Math.sqrt(Math.max(0, (1 - c) / 2));
@@ -167,9 +979,9 @@ function arcHandle(cos) {
   return 4 / 3 * sinHalf / (1 + cosHalf);
 }
 function squareTo(a, b) {
-  const w = sub(b, mul(a, dot(a, b)));
+  const w = sub2(b, mul2(a, dot2(a, b)));
   const l = len(w);
-  return l > EPS ? mul(w, 1 / l) : { x: 0, y: 0 };
+  return l > EPS ? mul2(w, 1 / l) : { x: 0, y: 0 };
 }
 function cutCorner(c, radius, kind) {
   const s = Math.min(cornerSetback(c, radius), Math.min(c.lu, c.lv) / 2);
@@ -178,16 +990,16 @@ function cutCorner(c, radius, kind) {
   const b = c.sideV.at(s, c.v);
   if (kind === "chamfer") return { tu: a.t, tv: b.t, start: a.p, out: null, in: null, end: b.p };
   if (kind === "inverted") {
-    const h = s * arcHandle(dot(a.dir, b.dir));
-    return { tu: a.t, tv: b.t, start: a.p, out: add(a.p, mul(squareTo(a.dir, b.dir), h)), in: add(b.p, mul(squareTo(b.dir, a.dir), h)), end: b.p };
+    const h = s * arcHandle(dot2(a.dir, b.dir));
+    return { tu: a.t, tv: b.t, start: a.p, out: add2(a.p, mul2(squareTo(a.dir, b.dir), h)), in: add2(b.p, mul2(squareTo(b.dir, a.dir), h)), end: b.p };
   }
-  const d1 = mul(a.dir, -1);
-  const d2 = mul(b.dir, -1);
-  const turn = Math.acos(Math.max(-1, Math.min(1, -dot(d1, d2))));
-  const chord = len(sub(b.p, a.p));
+  const d1 = mul2(a.dir, -1);
+  const d2 = mul2(b.dir, -1);
+  const turn = Math.acos(Math.max(-1, Math.min(1, -dot2(d1, d2))));
+  const chord = len(sub2(b.p, a.p));
   const k = turn < 1e-9 ? chord / 3 : 4 / 3 * Math.tan(turn / 4) * chord / (2 * Math.sin(turn / 2));
   if (!Number.isFinite(k)) return null;
-  return { tu: a.t, tv: b.t, start: a.p, out: add(a.p, mul(d1, k)), in: add(b.p, mul(d2, k)), end: b.p };
+  return { tu: a.t, tv: b.t, start: a.p, out: add2(a.p, mul2(d1, k)), in: add2(b.p, mul2(d2, k)), end: b.p };
 }
 var radiusOf = (a) => {
   const r = a.corner?.radius;
@@ -499,7 +1311,7 @@ function pressureWidthProfile(samples, options = {}) {
 // src/vector/varstroke.ts
 var SAMPLES_PER_SUBPATH = 128;
 var MAX_DASHES = 5e3;
-var sub2 = (a, b) => [a[0] - b[0], a[1] - b[1]];
+var sub3 = (a, b) => [a[0] - b[0], a[1] - b[1]];
 var along = (p, v2, k) => [p[0] + v2[0] * k, p[1] + v2[1] * k];
 var lerp = (a, b, u) => [a[0] + (b[0] - a[0]) * u, a[1] + (b[1] - a[1]) * u];
 var dist = (a, b) => Math.hypot(a[0] - b[0], a[1] - b[1]);
@@ -590,11 +1402,11 @@ function arcPoints(c, a0, sweep, r0, r1, tol) {
   return out;
 }
 function crossing(a0, a1, b0, b1) {
-  const r = sub2(a1, a0);
-  const q = sub2(b1, b0);
+  const r = sub3(a1, a0);
+  const q = sub3(b1, b0);
   const den = r[0] * q[1] - r[1] * q[0];
   if (Math.abs(den) < 1e-12) return null;
-  const w = sub2(b0, a0);
+  const w = sub3(b0, a0);
   const t = (w[0] * q[1] - w[1] * q[0]) / den;
   const u = (w[0] * r[1] - w[1] * r[0]) / den;
   return t > 1e-9 && t <= 1 && u >= 0 && u < 1 - 1e-9 ? [a0[0] + r[0] * t, a0[1] + r[1] * t] : null;
@@ -638,7 +1450,7 @@ function variableStrokeRings(path, options) {
       const closed = whole && poly.closed;
       const m = run.length - 1;
       const dirs = [];
-      for (let i = 0; i < m; i++) dirs.push(unitOf(sub2(run[i + 1].p, run[i].p)));
+      for (let i = 0; i < m; i++) dirs.push(unitOf(sub3(run[i + 1].p, run[i].p)));
       const normals = dirs.map(leftNormal);
       const w = run.map((q) => sides2(q.s));
       const side = (sigma) => {
@@ -657,12 +1469,12 @@ function variableStrokeRings(path, options) {
           const d0 = dirs[i];
           const d1 = dirs[j];
           const cross2 = d0[0] * d1[1] - d0[1] * d1[0];
-          const dot2 = d0[0] * d1[0] + d0[1] * d1[1];
+          const dot3 = d0[0] * d1[0] + d0[1] * d1[1];
           const r0 = w[i + 1][k];
           const r1 = w[j][k];
           const e = E(i);
           const st = S(j);
-          if (Math.abs(cross2) < 1e-12 && dot2 > 0) {
+          if (Math.abs(cross2) < 1e-12 && dot3 > 0) {
             push(out, e);
             if (!seam) push(out, st);
             continue;
@@ -680,7 +1492,7 @@ function variableStrokeRings(path, options) {
             continue;
           }
           push(out, e);
-          const theta = uturn ? Math.PI : Math.atan2(cross2, dot2);
+          const theta = uturn ? Math.PI : Math.atan2(cross2, dot3);
           const r = (r0 + r1) / 2;
           const kind = run[i + 1].corner || seam && poly.corner[0] ? join : "round";
           if (r > 1e-9) {
@@ -700,10 +1512,10 @@ function variableStrokeRings(path, options) {
         if (closed && out.length > 1 && dist(out[0], out[out.length - 1]) <= 1e-12) out.pop();
         return out;
       };
-      const left = side(1);
+      const left2 = side(1);
       const right = side(-1);
       if (closed) {
-        rings.push(left, right.reverse());
+        rings.push(left2, right.reverse());
         continue;
       }
       const capPoints = (atStart) => {
@@ -725,7 +1537,7 @@ function variableStrokeRings(path, options) {
         return atStart ? [along(R, o, ext), along(L, o, ext)] : [along(L, o, ext), along(R, o, ext)];
       };
       const ring = [];
-      for (const q of [...left, ...capPoints(false), ...right.reverse(), ...capPoints(true)]) push(ring, q);
+      for (const q of [...left2, ...capPoints(false), ...right.reverse(), ...capPoints(true)]) push(ring, q);
       if (ring.length > 2) rings.push(ring);
     }
   }
@@ -841,8 +1653,8 @@ function vectorStrokeLineArea(parts, style, tolerance) {
 }
 var capExtent = (style, width) => style.strokeLinecap === "round" || style.strokeLinecap === "square" ? width / 2 : 0;
 function arrowheadWeight(style, end) {
-  const scale = end === "start" ? style.startArrowScale : style.endArrowScale;
-  const s = typeof scale === "number" && scale > 0 && Number.isFinite(scale) ? scale : 1;
+  const scale3 = end === "start" ? style.startArrowScale : style.endArrowScale;
+  const s = typeof scale3 === "number" && scale3 > 0 && Number.isFinite(scale3) ? scale3 : 1;
   const width = style.strokeWidth ?? 1;
   const profile = strokeWidthProfileOf(style);
   const at2 = profile ? widthProfileAt(profile, end === "start" ? 0 : 1) : null;
@@ -1082,7 +1894,7 @@ function tangentAt(s, t) {
   const d = segmentDerivative(s, t);
   return unit2(d[0], d[1]) ?? startTangent(s);
 }
-var perp = (v2) => [-v2[1], v2[0]];
+var perp2 = (v2) => [-v2[1], v2[0]];
 function effectPathLength(path) {
   let total = 0;
   for (const s of subsOf(path)) for (const seg of s.segs) total += segmentLength(seg);
@@ -1252,9 +2064,9 @@ function twistPaths(paths, angle, center) {
   };
   return paths.map((p) => {
     const out = [];
-    for (const sub3 of subsOf(p)) {
+    for (const sub5 of subsOf(p)) {
       const segs = [];
-      for (const seg of sub3.segs) {
+      for (const seg of sub5.segs) {
         const cubic = seg.length === 2 ? [seg[0], seg[0], seg[1], seg[1]] : seg;
         const len2 = segmentLength(seg);
         const m = Math.min(64, Math.max(1, Math.ceil(Math.abs(a) * len2 / rmax / 0.15 + len2 / 50)));
@@ -1267,13 +2079,13 @@ function twistPaths(paths, angle, center) {
           segs.push([p0, [p0[0] + h1[0], p0[1] + h1[1]], [p3[0] + h2[0], p3[1] + h2[1]], p3]);
         }
       }
-      out.push({ segs, closed: sub3.closed });
+      out.push({ segs, closed: sub5.closed });
     }
     return subsToPath(out);
   });
 }
-function resample(sub3, m) {
-  const segs = sub3.segs;
+function resample(sub5, m) {
+  const segs = sub5.segs;
   const n = segs.length;
   const lens = segs.map((s) => segmentLength(s));
   const out = [];
@@ -1282,7 +2094,7 @@ function resample(sub3, m) {
     for (let k = 0; k < m; k++) {
       if (k === 0) {
         const tout = startTangent(segs[j]);
-        const prev = sub3.closed || j > 0 ? (j + n - 1) % n : null;
+        const prev = sub5.closed || j > 0 ? (j + n - 1) % n : null;
         let tan = tout;
         if (prev !== null) {
           const tin = endTangent(segs[prev]);
@@ -1295,7 +2107,7 @@ function resample(sub3, m) {
       }
     }
   }
-  if (!sub3.closed) {
+  if (!sub5.closed) {
     const last = segs[n - 1];
     out.push({ p: last[last.length - 1], tan: endTangent(last), lenPrev: lens[n - 1] / m, lenNext: 0 });
   }
@@ -1323,14 +2135,14 @@ function zigzagPaths(paths, size, ridges, smooth = false) {
   const m = Math.min(1e3, Math.max(0, Math.round(Number.isFinite(ridges) ? ridges : 0))) + 1;
   return paths.map((p) => {
     const out = [];
-    for (const sub3 of subsOf(p)) {
-      const s = resample(sub3, m);
+    for (const sub5 of subsOf(p)) {
+      const s = resample(sub5, m);
       const disp = s.map((x, i) => {
-        const n = perp(x.tan);
+        const n = perp2(x.tan);
         const d = i % 2 === 0 ? size : -size;
         return [n[0] * d, n[1] * d];
       });
-      const e = emit(s, disp, sub3.closed, smooth, 0.36);
+      const e = emit(s, disp, sub5.closed, smooth, 0.36);
       if (e) out.push(e);
     }
     return subsToPath(out);
@@ -1369,8 +2181,8 @@ function wigglePaths(paths, w) {
   let idx = 0;
   return paths.map((p) => {
     const out = [];
-    for (const sub3 of subsOf(p)) {
-      const s = resample(sub3, m);
+    for (const sub5 of subsOf(p)) {
+      const s = resample(sub5, m);
       const disp = s.map(() => {
         const i = BigInt(idx);
         const ox = noise(seed, i * 2n, t + idx * 0.37);
@@ -1378,7 +2190,7 @@ function wigglePaths(paths, w) {
         idx++;
         return [(sx * corr + ox * (1 - corr)) * w.size, (sy * corr + oy * (1 - corr)) * w.size];
       });
-      const e = emit(s, disp, sub3.closed, w.smooth, 1 / 3);
+      const e = emit(s, disp, sub5.closed, w.smooth, 1 / 3);
       if (e) out.push(e);
     }
     return subsToPath(out);
@@ -1691,7 +2503,7 @@ var compareOrder = (a, b) => {
   for (let i = 0; i < n; i++) if (a[i] !== b[i]) return a[i] - b[i];
   return a.length - b.length;
 };
-var add2 = (a, b) => ({ x: a.x + (b?.x ?? 0), y: a.y + (b?.y ?? 0) });
+var add3 = (a, b) => ({ x: a.x + (b?.x ?? 0), y: a.y + (b?.y ?? 0) });
 var mapPaths = (shapes, fn) => {
   const out = fn(shapes.map((s) => s.path));
   return shapes.map((s, i) => ({ ...s, path: out[i] ?? [] }));
@@ -1713,7 +2525,7 @@ function applyVectorEffects(shapes, effects) {
         list = mapPaths(list, (p) => puckerBloatPaths(p, e.params.amount));
         break;
       case "twist":
-        list = mapPaths(list, (p) => twistPaths(p, e.params.angle, add2(pathsCenter(p), e.params.center)));
+        list = mapPaths(list, (p) => twistPaths(p, e.params.angle, add3(pathsCenter(p), e.params.center)));
         break;
       case "zigzag":
         list = mapPaths(list, (p) => zigzagPaths(p, e.params.size, e.params.ridges, e.params.smooth));
@@ -1736,7 +2548,7 @@ function applyVectorEffects(shapes, effects) {
         const copies = repeatPaths(
           list.map((s) => s.path),
           r,
-          add2(pathsCenter(list.map((s) => s.path)), r.anchor)
+          add3(pathsCenter(list.map((s) => s.path)), r.anchor)
         );
         const n = copies.length;
         const next = [];
@@ -1982,8 +2794,8 @@ function inferAnchorType(a) {
   const li = Math.hypot(ix, iy);
   const lo = Math.hypot(ox, oy);
   const cross2 = (ix * oy - iy * ox) / (li * lo);
-  const dot2 = (ix * ox + iy * oy) / (li * lo);
-  if (Math.abs(cross2) > 1e-3 || dot2 > 0) return "corner";
+  const dot3 = (ix * ox + iy * oy) / (li * lo);
+  if (Math.abs(cross2) > 1e-3 || dot3 > 0) return "corner";
   return Math.abs(li - lo) <= 1e-3 * Math.max(li, lo) ? "symmetric" : "smooth";
 }
 function bezierToSubpaths(input) {
@@ -2232,6 +3044,9 @@ function bakeIntoGeometry(node, m) {
   return {
     ...path,
     ...mirrored ? { strokeWidthProfile: mirrorWidthProfile(path.strokeWidthProfile) } : {},
+    // Gradients in the node's own space move with its geometry.
+    ...isVectorGradient(path.fill) ? { fill: transformVectorPaint(path.fill, m) } : {},
+    ...isVectorGradient(path.stroke) ? { stroke: transformVectorPaint(path.stroke, m) } : {},
     subpaths: path.subpaths.map((sp) => ({
       closed: sp.closed,
       anchors: sp.anchors.map((a) => mapAnchor(a, m))
@@ -2334,12 +3149,12 @@ function insertAnchor(sp, segment, t) {
   const ia = segment;
   const ib = (segment + 1) % n;
   const seg = subpathSegment(sp, segment);
-  const [left, right] = splitSegment(seg, t);
-  const mid = left[left.length - 1];
+  const [left2, right] = splitSegment(seg, t);
+  const mid = left2[left2.length - 1];
   const anchor = { x: mid[0], y: mid[1] };
   if (seg.length === 4) {
-    anchors[ia].out = { x: left[1][0], y: left[1][1] };
-    anchor.in = { x: left[2][0], y: left[2][1] };
+    anchors[ia].out = { x: left2[1][0], y: left2[1][1] };
+    anchor.in = { x: left2[2][0], y: left2[2][1] };
     anchor.out = { x: right[1][0], y: right[1][1] };
     anchor.type = "smooth";
     anchors[ib].in = { x: right[2][0], y: right[2][1] };
@@ -2424,6 +3239,166 @@ function roundSubpaths(subpaths, precision = 3) {
   }));
 }
 
+// src/vector/gradientStroke.ts
+var SHARP = 1.25;
+var TOLERANCE = 0.2;
+var OVERLAP = 0.5;
+var fmt2 = (n, digits = 3) => {
+  const k = 10 ** digits;
+  const v2 = Math.round(n * k) / k;
+  return Object.is(v2, -0) ? "0" : String(v2);
+};
+var toSvgStops2 = (stops) => stops.map((s) => ({ offset: `${fmt2(s.offset * 100)}%`, stopColor: s.color, ...s.opacity !== void 0 && s.opacity !== 1 ? { stopOpacity: Math.round(s.opacity * 1e4) / 1e4 } : {} }));
+var polygonD2 = (pts, precision) => `M${pts.map((p) => `${fmt2(p.x, precision)} ${fmt2(p.y, precision)}`).join("L")}Z`;
+var add4 = (a, b) => ({ x: a.x + b.x, y: a.y + b.y });
+var sub4 = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
+var scale2 = (a, k) => ({ x: a.x * k, y: a.y * k });
+var left = (d) => ({ x: d.y, y: -d.x });
+var unit3 = (v2) => {
+  const l = Math.hypot(v2.x, v2.y);
+  return l > 1e-12 ? { x: v2.x / l, y: v2.y / l } : { x: 1, y: 0 };
+};
+function flattenedSubpaths(node) {
+  const out = [];
+  for (const contour of pathToContours(subpathsToBezier(node.subpaths))) {
+    const segs = closeContour(contour);
+    if (!segs.length) continue;
+    const ring = flattenChain(segs, TOLERANCE);
+    const pts = ring.map(([x, y]) => ({ x, y })).filter((p, i, a) => i === 0 || Math.hypot(p.x - a[i - 1].x, p.y - a[i - 1].y) > 1e-9);
+    if (contour.closed && pts.length > 2 && Math.hypot(pts[0].x - pts[pts.length - 1].x, pts[0].y - pts[pts.length - 1].y) < 1e-9) pts.pop();
+    if (pts.length >= 2) out.push({ pts, closed: contour.closed && pts.length > 2 });
+  }
+  return out;
+}
+var signedArea = (pts) => {
+  let a = 0;
+  for (let i = 0; i < pts.length; i++) {
+    const p = pts[i];
+    const q = pts[(i + 1) % pts.length];
+    a += p.x * q.y - q.x * p.y;
+  }
+  return a / 2;
+};
+function vectorStrokeGradientDefs(g, id, node, options = {}) {
+  const precision = options.precision ?? 3;
+  const mode = g.strokeMode === "across" ? "across" : "along";
+  const expanded = expandVectorGradientStops(g);
+  const reach = vectorStrokeReach(node) + 1;
+  const area = options.area ?? vectorGradientArea(options.bounds && { x: options.bounds.x - reach, y: options.bounds.y - reach, width: options.bounds.width + 2 * reach, height: options.bounds.height + 2 * reach });
+  const width = node.strokeWidth ?? 1;
+  const align = node.strokeAlign ?? "center";
+  const profile = strokeWidthProfileOf(node);
+  const gradients = [];
+  const patches = [];
+  const slices = [];
+  const colourAt = (t) => {
+    const s = spanVectorGradientStops(g, t, t, expanded)[0];
+    return s;
+  };
+  let counter = 0;
+  const solid = (pts, t) => {
+    const s = colourAt(t);
+    const gid = `${id}-p${counter++}`;
+    gradients.push({ id: gid, type: "linear", attrs: { gradientUnits: "userSpaceOnUse", x1: 0, y1: 0, x2: 1, y2: 0 }, stops: toSvgStops2([{ ...s, offset: 0 }]) });
+    patches.push({ d: polygonD2(pts, precision), fill: `url(#${gid})` });
+  };
+  const disc = (c, r) => Array.from({ length: 16 }, (_, k) => add4(c, scale2({ x: Math.cos(k * Math.PI / 8), y: Math.sin(k * Math.PI / 8) }, r)));
+  for (const { pts, closed } of flattenedSubpaths(node)) {
+    const n = pts.length;
+    const segCount = closed ? n : n - 1;
+    const dirs = [];
+    const lengths = [0];
+    for (let i = 0; i < segCount; i++) {
+      const a = pts[i];
+      const b = pts[(i + 1) % n];
+      dirs.push(unit3(sub4(b, a)));
+      lengths.push(lengths[i] + Math.hypot(b.x - a.x, b.y - a.y));
+    }
+    const total = lengths[segCount];
+    if (!(total > 1e-9)) continue;
+    const tAt = (i) => lengths[i] / total;
+    const clockwise = closed && signedArea(pts) > 0;
+    const visibleLeft = align === "center" || !closed ? null : align === "inside" ? !clockwise : clockwise;
+    const ribs = [];
+    for (let i = 0; i < n; i++) {
+      const p = pts[i];
+      const din = i > 0 || closed ? dirs[(i - 1 + segCount) % segCount] : null;
+      const dout = i < segCount ? dirs[i] : null;
+      const square = (d) => ({ l: add4(p, scale2(left(d), reach)), r: sub4(p, scale2(left(d), reach)) });
+      if (!din || !dout) {
+        const rib = square(din ?? dout);
+        ribs.push({ before: rib, after: rib });
+        continue;
+      }
+      const nin = left(din);
+      const nout = left(dout);
+      const den = 1 + nin.x * nout.x + nin.y * nout.y;
+      const stretch = den > 1e-12 ? Math.sqrt(2 / den) : Infinity;
+      if (stretch <= SHARP) {
+        const m = scale2(add4(nin, nout), reach / den);
+        const rib = { l: add4(p, m), r: sub4(p, m) };
+        ribs.push({ before: rib, after: rib });
+      } else {
+        ribs.push({ before: square(din), after: square(dout) });
+        solid(disc(p, reach * 1.5), tAt(i));
+      }
+    }
+    if (!closed) {
+      const d0 = dirs[0];
+      const d1 = dirs[segCount - 1];
+      const a = pts[0];
+      const b = pts[n - 1];
+      const cap = (p, d) => [add4(p, scale2(left(d), reach)), add4(add4(p, scale2(d, reach)), scale2(left(d), reach)), sub4(add4(p, scale2(d, reach)), scale2(left(d), reach)), sub4(p, scale2(left(d), reach))];
+      solid(cap(a, scale2(d0, -1)), 0);
+      solid(cap(b, d1), 1);
+    }
+    for (let i = 0; i < segCount; i++) {
+      const j = (i + 1) % n;
+      const a = pts[i];
+      const b = pts[j];
+      const d = dirs[i];
+      const from = ribs[i].after;
+      const to = ribs[j].before;
+      const ext = scale2(d, OVERLAP);
+      const quad = [from.l, add4(to.l, ext), add4(to.r, ext), from.r];
+      const gid = `${id}-s${counter++}`;
+      const t0 = tAt(i);
+      const t1 = closed && i === segCount - 1 ? 1 : tAt(i + 1);
+      if (mode === "along") {
+        gradients.push({
+          id: gid,
+          type: "linear",
+          attrs: { gradientUnits: "userSpaceOnUse", x1: fmt2(a.x, 4), y1: fmt2(a.y, 4), x2: fmt2(b.x, 4), y2: fmt2(b.y, 4) },
+          stops: toSvgStops2(spanVectorGradientStops(g, t0, t1, expanded))
+        });
+      } else {
+        const mid = scale2(add4(a, b), 0.5);
+        const side = widthProfileAt(profile, (t0 + t1) / 2);
+        const nrm = left(d);
+        const reachL = visibleLeft === null ? width / 2 * side.left : visibleLeft ? width * side.left : 0;
+        const reachR = visibleLeft === null ? width / 2 * side.right : visibleLeft ? 0 : width * side.right;
+        const p0 = add4(mid, scale2(nrm, reachL));
+        const p1 = sub4(mid, scale2(nrm, reachR));
+        gradients.push({
+          id: gid,
+          type: "linear",
+          attrs: { gradientUnits: "userSpaceOnUse", x1: fmt2(p0.x, 4), y1: fmt2(p0.y, 4), x2: fmt2(p1.x, 4), y2: fmt2(p1.y, 4) },
+          stops: toSvgStops2(expanded)
+        });
+      }
+      slices.push({ d: polygonD2(quad, precision), fill: `url(#${gid})` });
+    }
+  }
+  const def = {
+    id,
+    type: "pattern",
+    attrs: patternAttrs(area),
+    gradients,
+    tiles: [...patches, ...slices]
+  };
+  return [def];
+}
+
 // src/vector/svg.ts
 function vectorCornersAttribute(subpaths, precision = 3) {
   const out = [];
@@ -2448,10 +3423,30 @@ function applyVectorCornersAttribute(subpaths, value) {
   return subpaths;
 }
 var escapeAttr = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-function vectorPaintToSvg(paint, gradientId) {
-  if (!hasPaint(paint)) return { value: "none", gradient: null };
-  if (typeof paint === "string") return { value: paint, gradient: null };
-  return { value: `url(#${gradientId})`, gradient: gradientToSvgDef(paint, gradientId) };
+function vectorPathLocalBounds(node) {
+  const b = bezierPathBounds(subpathsToBezier(node.subpaths));
+  return b ? { x: b.minX, y: b.minY, width: b.maxX - b.minX, height: b.maxY - b.minY } : null;
+}
+var paintCache = /* @__PURE__ */ new WeakMap();
+function vectorPaintToSvg(paint, gradientId, options = {}) {
+  if (!hasPaint(paint)) return { value: "none", defs: [] };
+  if (typeof paint === "string") return { value: paint, defs: [] };
+  if (!isVectorGradient(paint)) return { value: "none", defs: [] };
+  const role = options.role ?? "fill";
+  const precision = options.precision ?? 3;
+  const key = `${gradientId}|${role}|${precision}`;
+  const owner = options.node ?? paint;
+  const cached = paintCache.get(owner)?.get(key);
+  if (cached && (!options.node || (role === "fill" ? options.node.fill : options.node.stroke) === paint)) return { value: `url(#${gradientId})`, defs: cached };
+  const node = options.node;
+  const bounds = node ? vectorPathLocalBounds(node) : null;
+  const reach = node && role === "stroke" ? vectorStrokeReach(node) + 1 : 1;
+  const area = bounds ? { x: bounds.x - reach, y: bounds.y - reach, width: bounds.width + 2 * reach, height: bounds.height + 2 * reach } : null;
+  const defs = node && role === "stroke" && (paint.strokeMode === "along" || paint.strokeMode === "across") ? vectorStrokeGradientDefs(paint, gradientId, node, { bounds, area, precision }) : vectorGradientSvgDefs(paint, gradientId, { bounds, area, precision });
+  let byKey = paintCache.get(owner);
+  if (!byKey) paintCache.set(owner, byKey = /* @__PURE__ */ new Map());
+  byKey.set(key, defs);
+  return { value: `url(#${gradientId})`, defs };
 }
 var partsCache = /* @__PURE__ */ new WeakMap();
 function vectorStrokeSvgParts(node, clipId, precision = 3) {
@@ -2490,18 +3485,26 @@ function widthProfileFromAttribute(value) {
   if (!value) return [];
   return sanitizeWidthProfile(
     value.split(";").map((part) => {
-      const [t, left, right] = part.split(",").map((n) => parseFloat(n));
-      return { t, left, right: Number.isFinite(right) ? right : left };
+      const [t, left2, right] = part.split(",").map((n) => parseFloat(n));
+      return { t, left: left2, right: Number.isFinite(right) ? right : left2 };
     })
   );
 }
 var round2 = (n) => Math.round(n * 100) / 100;
-function gradientMarkup(def) {
+function gradientMarkup(def, extra = "") {
   const tag = def.type === "radial" ? "radialGradient" : "linearGradient";
   const attrs = Object.entries(def.attrs).map(([k, v2]) => ` ${k}="${escapeAttr(String(v2))}"`).join("");
   const stops = def.stops.map((s) => `<stop offset="${s.offset}" stop-color="${escapeAttr(s.stopColor)}"${s.stopOpacity !== void 0 ? ` stop-opacity="${s.stopOpacity}"` : ""}/>`).join("");
-  return `<${tag} id="${escapeAttr(def.id)}"${attrs}>${stops}</${tag}>`;
+  return `<${tag} id="${escapeAttr(def.id)}"${attrs}${extra}>${stops}</${tag}>`;
+}
+function paintDefMarkup(def, gradient) {
+  const extra = gradient ? ` data-vector-gradient="${escapeAttr(JSON.stringify(gradient))}"` : "";
+  if (def.type !== "pattern") return gradientMarkup(def, extra);
+  const attrs = Object.entries(def.attrs).map(([k, v2]) => ` ${k}="${escapeAttr(String(v2))}"`).join("");
+  const inner = def.gradients.map((g) => gradientMarkup(g)).join("") + def.tiles.map((t) => `<path d="${t.d}" fill="${escapeAttr(t.fill)}"/>`).join("");
+  return `<pattern id="${escapeAttr(def.id)}"${attrs}${extra}>${inner}</pattern>`;
 }
+var paintMarkup = (paint, defs) => defs.map((d, i) => paintDefMarkup(d, i === 0 && isVectorGradient(paint) ? paint : void 0));
 function blendFromAttribute(value, m) {
   if (!value) return null;
   let raw;
@@ -2535,12 +3538,12 @@ function vectorDocumentToSvg(doc, options = {}) {
   const pretty = options.pretty !== false;
   const defs = [];
   const lines = [];
-  const num = (n) => formatNumber(n, precision);
+  const num2 = (n) => formatNumber(n, precision);
   const indent = (depth) => pretty ? "  ".repeat(depth) : "";
   const common = (node) => {
     let out2 = ` id="${escapeAttr(node.id)}"`;
     if (node.transform) out2 += ` transform="matrix(${node.transform.map((n) => formatNumber(n, 6)).join(" ")})"`;
-    if (node.opacity !== void 0 && node.opacity < 1) out2 += ` opacity="${num(node.opacity)}"`;
+    if (node.opacity !== void 0 && node.opacity < 1) out2 += ` opacity="${num2(node.opacity)}"`;
     if (node.visible === false) out2 += ` display="none"`;
     if (node.blendStep) out2 += ` data-vector-blend-step=""`;
     if (node.type === "group" && node.blend) out2 += ` data-vector-blend="${escapeAttr(JSON.stringify(node.blend))}"`;
@@ -2574,19 +3577,18 @@ function vectorDocumentToSvg(doc, options = {}) {
       lines.push(`${indent(depth)}</g>`);
       return;
     }
-    const fill = vectorPaintToSvg(node.fill, `${prefix}fill-${node.id}`);
-    const stroke = vectorPaintToSvg(node.stroke, `${prefix}stroke-${node.id}`);
-    if (fill.gradient) defs.push(gradientMarkup(fill.gradient));
-    if (stroke.gradient) defs.push(gradientMarkup(stroke.gradient));
+    const fill = vectorPaintToSvg(node.fill, `${prefix}fill-${node.id}`, { node, precision });
+    const stroke = vectorPaintToSvg(node.stroke, `${prefix}stroke-${node.id}`, { node, role: "stroke", precision });
+    defs.push(...paintMarkup(node.fill, fill.defs), ...paintMarkup(node.stroke, stroke.defs));
     const d = vectorPathData(node, precision);
     const corners2 = vectorCornersAttribute(node.subpaths, precision);
     const live = corners2 ? ` data-vector-d="${bezierPathToSvg(subpathsToBezier(node.subpaths, { corners: false }), { precision })}" data-vector-corners="${corners2}"` : "";
     const fillAttrs = ` fill="${escapeAttr(fill.value)}"${node.fillRule === "evenodd" ? ` fill-rule="evenodd"` : ""}`;
     const lineAttrs = (width) => {
-      let out2 = ` stroke="${escapeAttr(stroke.value)}" stroke-width="${num(width)}"`;
+      let out2 = ` stroke="${escapeAttr(stroke.value)}" stroke-width="${num2(width)}"`;
       if (node.strokeLinecap && node.strokeLinecap !== "butt") out2 += ` stroke-linecap="${node.strokeLinecap}"`;
       if (node.strokeLinejoin && node.strokeLinejoin !== "miter") out2 += ` stroke-linejoin="${node.strokeLinejoin}"`;
-      if (node.strokeDasharray?.length) out2 += ` stroke-dasharray="${node.strokeDasharray.map(num).join(" ")}"`;
+      if (node.strokeDasharray?.length) out2 += ` stroke-dasharray="${node.strokeDasharray.map(num2).join(" ")}"`;
       return out2;
     };
     const parts = stroke.value !== "none" ? vectorStrokeSvgParts(node, `${prefix}clip-${node.id}`, precision) : void 0;
@@ -2594,19 +3596,19 @@ function vectorDocumentToSvg(doc, options = {}) {
       lines.push(`${indent(depth)}<path${common(node)} d="${d}"${fillAttrs}${stroke.value !== "none" ? lineAttrs(node.strokeWidth ?? 1) : ""}${live}/>`);
       return;
     }
-    let data = ` data-vector-path="" data-vector-stroke-width="${num(node.strokeWidth ?? 1)}"`;
+    let data = ` data-vector-path="" data-vector-stroke-width="${num2(node.strokeWidth ?? 1)}"`;
     if (parts.align !== "center") data += ` data-vector-stroke-align="${parts.align}"`;
     if (node.startArrow) data += ` data-vector-start-arrow="${node.startArrow}"`;
     if (node.endArrow) data += ` data-vector-end-arrow="${node.endArrow}"`;
     if (node.arrowAlign && node.arrowAlign !== "extend") data += ` data-vector-arrow-align="${node.arrowAlign}"`;
-    if (node.startArrowScale !== void 0 && node.startArrowScale !== 1) data += ` data-vector-start-arrow-scale="${num(node.startArrowScale)}"`;
-    if (node.endArrowScale !== void 0 && node.endArrowScale !== 1) data += ` data-vector-end-arrow-scale="${num(node.endArrowScale)}"`;
+    if (node.startArrowScale !== void 0 && node.startArrowScale !== 1) data += ` data-vector-start-arrow-scale="${num2(node.startArrowScale)}"`;
+    if (node.endArrowScale !== void 0 && node.endArrowScale !== 1) data += ` data-vector-end-arrow-scale="${num2(node.endArrowScale)}"`;
     const profile = strokeWidthProfileOf(node);
     if (profile) {
       data += ` data-vector-width-profile="${widthProfileToAttribute(profile)}"`;
       if (node.strokeLinecap && node.strokeLinecap !== "butt") data += ` data-vector-stroke-linecap="${node.strokeLinecap}"`;
       if (node.strokeLinejoin && node.strokeLinejoin !== "miter") data += ` data-vector-stroke-linejoin="${node.strokeLinejoin}"`;
-      if (node.strokeDasharray?.length) data += ` data-vector-stroke-dasharray="${node.strokeDasharray.map(num).join(" ")}"`;
+      if (node.strokeDasharray?.length) data += ` data-vector-stroke-dasharray="${node.strokeDasharray.map(num2).join(" ")}"`;
     }
     lines.push(`${indent(depth)}<g${common(node)}${data}>`);
     lines.push(`${indent(depth + 1)}<path data-vector-part="fill" d="${d}"${fillAttrs}${live}/>`);
@@ -2623,7 +3625,7 @@ function vectorDocumentToSvg(doc, options = {}) {
           clip = ` clip-path="url(#${id})"`;
         } else {
           const b = parts.clip.bounds;
-          const box = `x="${num(b.x)}" y="${num(b.y)}" width="${num(b.width)}" height="${num(b.height)}"`;
+          const box = `x="${num2(b.x)}" y="${num2(b.y)}" width="${num2(b.width)}" height="${num2(b.height)}"`;
           defs.push(`<mask id="${id}" maskUnits="userSpaceOnUse" ${box}><rect ${box} fill="#fff"/><path d="${d}" fill="#000" fill-rule="${rule}"/></mask>`);
           clip = ` mask="url(#${id})"`;
         }
@@ -2635,8 +3637,8 @@ function vectorDocumentToSvg(doc, options = {}) {
     lines.push(`${indent(depth)}</g>`);
   };
   for (const node of doc.nodes) emit2(node, 1);
-  const w = num(doc.width);
-  const h = num(doc.height);
+  const w = num2(doc.width);
+  const h = num2(doc.height);
   const nl = pretty ? "\n" : "";
   const out = [`<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">`];
   if (defs.length) out.push(`${indent(1)}<defs>${defs.join("")}</defs>`);
@@ -2766,28 +3768,89 @@ var fraction = (s, fallback) => {
   if (!Number.isFinite(n)) return fallback;
   return s.trim().endsWith("%") ? n / 100 : n;
 };
+var PAINT_SERVERS = /* @__PURE__ */ new Set(["linearGradient", "radialGradient", "pattern"]);
 function collectGradients(el, raw) {
-  if ((el.name === "linearGradient" || el.name === "radialGradient") && el.attrs.id) raw.set(el.attrs.id, el);
+  if (PAINT_SERVERS.has(el.name) && el.attrs.id) raw.set(el.attrs.id, el);
   for (const c of el.children) collectGradients(c, raw);
 }
-function resolveGradient(id, raw, seen = /* @__PURE__ */ new Set()) {
-  const el = raw.get(id);
-  if (!el || seen.has(id)) return null;
-  seen.add(id);
-  let stops = readStops(el);
-  const href = el.attrs.href ?? el.attrs["xlink:href"];
-  if (!stops.length && href?.startsWith("#")) stops = resolveGradient(href.slice(1), raw, seen)?.stops ?? [];
-  if (!stops.length) return null;
-  if (el.name === "radialGradient") {
-    return { type: "radial", cx: fraction(el.attrs.cx, 0.5), cy: fraction(el.attrs.cy, 0.5), r: fraction(el.attrs.r, 0.5), stops };
+function gradientFromAttribute(value) {
+  if (!value) return null;
+  try {
+    return sanitizeVectorGradient(JSON.parse(value));
+  } catch {
+    return null;
   }
-  const x1 = fraction(el.attrs.x1, 0);
-  const y1 = fraction(el.attrs.y1, 0);
-  const x2 = fraction(el.attrs.x2, 1);
-  const y2 = fraction(el.attrs.y2, 0);
-  const angle = Math.round((Math.atan2(x2 - x1, -(y2 - y1)) * 180 / Math.PI + 360) % 360);
-  return { type: "linear", angle, stops };
 }
+function resolveGradient(id, raw) {
+  const first = raw.get(id);
+  if (!first) return null;
+  const own = gradientFromAttribute(first.attrs["data-vector-gradient"]);
+  if (own) return own;
+  if (first.name === "pattern") return null;
+  const chain = [];
+  for (let el = first; el && !chain.includes(el) && chain.length < 32; ) {
+    chain.push(el);
+    const href = el.attrs.href ?? el.attrs["xlink:href"];
+    el = href?.startsWith("#") ? raw.get(href.slice(1)) : void 0;
+  }
+  const attr = (name) => chain.find((el) => el.attrs[name] !== void 0)?.attrs[name];
+  const stops = chain.map(readStops).find((s) => s.length) ?? [];
+  if (!stops.length) return null;
+  const user = attr("gradientUnits") === "userSpaceOnUse";
+  const t = parseSvgTransform(attr("gradientTransform"));
+  const plain3 = t === IDENTITY_MATRIX || t[0] === 1 && t[1] === 0 && t[2] === 0 && t[3] === 1 && t[4] === 0 && t[5] === 0;
+  const at2 = (name, fallback) => user ? length(attr(name), fallback) : fraction(attr(name), fallback);
+  const spreadAttr = attr("spreadMethod");
+  const spread = spreadAttr === "reflect" || spreadAttr === "repeat" ? { spread: spreadAttr } : {};
+  const map = (p) => applySvgMatrix(t, p);
+  if (first.name === "radialGradient") {
+    const cx = at2("cx", user ? 0 : 0.5);
+    const cy = at2("cy", user ? 0 : 0.5);
+    const r = at2("r", user ? 0 : 0.5);
+    const fx = attr("fx") !== void 0 ? at2("fx", cx) : cx;
+    const fy = attr("fy") !== void 0 ? at2("fy", cy) : cy;
+    const fr = attr("fr") !== void 0 ? at2("fr", 0) : 0;
+    const focal = Math.abs(fx - cx) > 1e-9 || Math.abs(fy - cy) > 1e-9;
+    if (!user && plain3 && !focal && !(fr > 0)) return { type: "radial", cx, cy, r, stops, ...spread };
+    const g = {
+      type: "radial",
+      stops,
+      start: map({ x: cx, y: cy }),
+      end: map({ x: cx + r, y: cy }),
+      width: map({ x: cx, y: cy + r }),
+      units: user ? "userSpaceOnUse" : "objectBoundingBox",
+      ...spread
+    };
+    if (focal) g.focal = map({ x: fx, y: fy });
+    if (fr > 0 && r > 0) g.focalRadius = Math.min(0.99, fr / r);
+    return g;
+  }
+  const x1 = at2("x1", 0);
+  const y1 = at2("y1", 0);
+  const x2 = attr("x2") !== void 0 ? at2("x2", 1) : user ? 0 : 1;
+  const y2 = at2("y2", 0);
+  if (!user && plain3) {
+    const angle = Math.round((Math.atan2(x2 - x1, -(y2 - y1)) * 180 / Math.PI + 360) % 360);
+    const c = angleToSvgLinearCoords(angle);
+    const len2 = Math.hypot(x2 - x1, y2 - y1);
+    const d = len2 > 0 ? { x: (x2 - x1) / len2, y: (y2 - y1) / len2 } : { x: 0, y: 1 };
+    const along2 = (x, y) => x * d.x + y * d.y;
+    const same = len2 > 0 && Math.abs((c.x2 - c.x1) * d.y - (c.y2 - c.y1) * d.x) < 1e-3 && Math.abs(along2(c.x1, c.y1) - along2(x1, y1)) < 1e-3 && Math.abs(along2(c.x2, c.y2) - along2(x2, y2)) < 1e-3;
+    if (same) return { type: "linear", angle, stops, ...spread };
+  }
+  const start = { x: x1, y: y1 };
+  const end = { x: x2, y: y2 };
+  return {
+    type: "linear",
+    stops,
+    start: map(start),
+    end: map(end),
+    width: map({ x: x1 - (y2 - y1), y: y1 + (x2 - x1) }),
+    units: user ? "userSpaceOnUse" : "objectBoundingBox",
+    ...spread
+  };
+}
+var applySvgMatrix = (m, p) => ({ x: m[0] * p.x + m[2] * p.y + m[4], y: m[1] * p.x + m[3] * p.y + m[5] });
 function parseVectorSvg(svg, options = {}) {
   const root = parseXml(svg);
   if (!root) throw new Error("The markup has no <svg> element.");
@@ -2888,7 +3951,7 @@ function parseVectorSvg(svg, options = {}) {
     const ss = strokeEl ? readStyle(strokeEl, style) : null;
     const width2 = length(a["data-vector-stroke-width"], ss ? length(ss.strokeWidth, 1) : 1);
     const arrow = (v2) => VECTOR_ARROWHEADS.includes(v2) ? v2 : void 0;
-    const scale = (v2) => {
+    const scale3 = (v2) => {
       const n = v2 === void 0 ? NaN : parseFloat(v2);
       return n > 0 ? n : void 0;
     };
@@ -2912,8 +3975,8 @@ function parseVectorSvg(svg, options = {}) {
       ...arrow(a["data-vector-start-arrow"]) ? { startArrow: arrow(a["data-vector-start-arrow"]) } : {},
       ...arrow(a["data-vector-end-arrow"]) ? { endArrow: arrow(a["data-vector-end-arrow"]) } : {},
       ...a["data-vector-arrow-align"] === "tip" ? { arrowAlign: "tip" } : {},
-      ...scale(a["data-vector-start-arrow-scale"]) ? { startArrowScale: scale(a["data-vector-start-arrow-scale"]) } : {},
-      ...scale(a["data-vector-end-arrow-scale"]) ? { endArrowScale: scale(a["data-vector-end-arrow-scale"]) } : {},
+      ...scale3(a["data-vector-start-arrow-scale"]) ? { startArrowScale: scale3(a["data-vector-start-arrow-scale"]) } : {},
+      ...scale3(a["data-vector-end-arrow-scale"]) ? { endArrowScale: scale3(a["data-vector-end-arrow-scale"]) } : {},
       ...profile.length ? { strokeWidthProfile: profile } : {},
       ...keptCap ? { strokeLinecap: keptCap } : {},
       ...keptJoin ? { strokeLinejoin: keptJoin } : {},
@@ -3006,6 +4069,72 @@ function parseVectorSvg(svg, options = {}) {
   return { width, height, nodes };
 }
 
+// src/vector/gradientTool.ts
+var VECTOR_GRADIENT_STOP_GAP = 12;
+var VECTOR_GRADIENT_MIDPOINT_GAP = 9;
+var VECTOR_GRADIENT_OFF_BAR = 24;
+var STOP_HIT = 6;
+var MIDPOINT_HIT = 5;
+var HANDLE_HIT = 6;
+var BAR_HIT = 5;
+var fmt3 = (n) => Math.round(n * 100) / 100;
+var apply2 = (m, p) => ({ x: m[0] * p.x + m[2] * p.y + m[4], y: m[1] * p.x + m[3] * p.y + m[5] });
+function vectorGradientTargetPath(doc, selection, target) {
+  for (const id of selection) {
+    const node = findVectorNode(doc.nodes, id);
+    if (!node) continue;
+    const path = collectPathNodes(node).find((p) => isVectorGradient(p[target]));
+    if (path) return path;
+  }
+  return null;
+}
+function getVectorGradientAnnotator(doc, selection, viewport, target) {
+  const path = vectorGradientTargetPath(doc, selection, target);
+  if (!path) return null;
+  const gradient = path[target];
+  const world = vectorWorldMatrix(doc.nodes, path.id) ?? IDENTITY_MATRIX;
+  const screen = multiplyMatrices(world, [viewport.zoom, 0, 0, viewport.zoom, viewport.x, viewport.y]);
+  const bounds = vectorPathLocalBounds(path);
+  const h = vectorGradientHandles(gradient, bounds, screen);
+  const v2 = { x: h.end.x - h.start.x, y: h.end.y - h.start.y };
+  const len2 = Math.hypot(v2.x, v2.y);
+  const normal = len2 > 1e-9 ? { x: -v2.y / len2, y: v2.x / len2 } : { x: 0, y: 1 };
+  const at2 = (t, gap) => ({ x: h.start.x + v2.x * t + normal.x * gap, y: h.start.y + v2.y * t + normal.y * gap });
+  const sorted = sortedVectorGradientStops(gradient);
+  const stops = sorted.map((s, index) => ({ ...s, index, ...at2(s.offset, VECTOR_GRADIENT_STOP_GAP) }));
+  const midpoints = sorted.slice(0, -1).flatMap((s, index) => {
+    const pos = vectorGradientMidpointPosition(sorted, index);
+    return pos === null || sorted[index + 1].offset - s.offset < 1e-6 ? [] : [{ index, midpoint: s.midpoint ?? 0.5, ...at2(pos, -VECTOR_GRADIENT_MIDPOINT_GAP) }];
+  });
+  let extent = null;
+  if (isCentredVectorGradient(gradient.type)) {
+    const frame2 = multiplyMatrices(vectorGradientMatrix(gradient, bounds), screen);
+    const pts = gradient.type === "diamond" ? [{ x: 1, y: 0 }, { x: 0, y: 1 }, { x: -1, y: 0 }, { x: 0, y: -1 }] : Array.from({ length: 48 }, (_, k) => ({ x: Math.cos(k * Math.PI / 24), y: Math.sin(k * Math.PI / 24) }));
+    extent = `M${pts.map((p) => apply2(frame2, p)).map((p) => `${fmt3(p.x)} ${fmt3(p.y)}`).join("L")}Z`;
+  }
+  return { nodeId: path.id, target, gradient, bounds, world, start: h.start, end: h.end, aspect: h.aspect, focal: h.focal, normal, stops, midpoints, extent };
+}
+function vectorGradientBarPosition(a, p) {
+  const v2 = { x: a.end.x - a.start.x, y: a.end.y - a.start.y };
+  const l2 = v2.x * v2.x + v2.y * v2.y;
+  const d = { x: p.x - a.start.x, y: p.y - a.start.y };
+  if (l2 < 1e-12) return { offset: 0, across: Math.hypot(d.x, d.y) };
+  return { offset: (d.x * v2.x + d.y * v2.y) / l2, across: d.x * a.normal.x + d.y * a.normal.y };
+}
+function hitVectorGradientAnnotator(a, p) {
+  const near2 = (q, r) => !!q && Math.hypot(q.x - p.x, q.y - p.y) <= r;
+  for (let i = a.stops.length - 1; i >= 0; i--) if (near2(a.stops[i], STOP_HIT)) return { kind: "stop", index: a.stops[i].index };
+  for (const m of a.midpoints) if (near2(m, MIDPOINT_HIT)) return { kind: "midpoint", index: m.index };
+  const centred = isCentredVectorGradient(a.gradient.type);
+  if (near2(a.end, HANDLE_HIT)) return { kind: "handle", handle: centred ? "radius" : "end" };
+  if (a.focal && near2(a.focal, HANDLE_HIT) && !near2(a.start, 1)) return { kind: "handle", handle: "focal" };
+  if (near2(a.start, HANDLE_HIT)) return { kind: "handle", handle: "start" };
+  if (near2(a.aspect, HANDLE_HIT)) return { kind: "handle", handle: "aspect" };
+  const { offset, across } = vectorGradientBarPosition(a, p);
+  if (offset >= 0 && offset <= 1 && across >= -BAR_HIT && across <= VECTOR_GRADIENT_STOP_GAP + STOP_HIT) return { kind: "bar", offset };
+  return null;
+}
+
 // src/vector/blend.ts
 var lerpN = (a, b, t) => a + (b - a) * t;
 var lerpP = (a, b, t) => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
@@ -3097,10 +4226,10 @@ function refineMorphContour(c, segments) {
   const extra = segments - have;
   const want = lens.map((l) => sum > 1e-12 ? l / sum * extra : extra / have);
   const parts = want.map((w) => 1 + Math.floor(w));
-  let left = segments - parts.reduce((a, b) => a + b, 0);
+  let left2 = segments - parts.reduce((a, b) => a + b, 0);
   const frac = want.map((w) => w - Math.floor(w));
   const order = parts.map((_, i) => i).sort((a, b) => Math.abs(frac[b] - frac[a]) > 1e-9 ? frac[b] - frac[a] : a - b);
-  for (let i = 0; left > 0; i = (i + 1) % order.length, left--) parts[order[i]]++;
+  for (let i = 0; left2 > 0; i = (i + 1) % order.length, left2--) parts[order[i]]++;
   const pts = [c.pts[0]];
   const anchors = [0];
   let at2 = 0;
@@ -3209,19 +4338,19 @@ function bestStart(fixed, free, useShapeContext) {
   const gsc = useShapeContext ? shapeContexts(ga, free.closed) : null;
   const m = Math.max(1, fn.length);
   const cost = (s) => {
-    let dot2 = 0;
+    let dot3 = 0;
     let cross2 = 0;
     let sc = 0;
     for (let i = 0; i < fn.length; i++) {
       const j = free.closed ? (i + s) % n : i;
       const p = fn[i];
       const q = gn[j];
-      dot2 += p[0] * q[0] + p[1] * q[1];
+      dot3 += p[0] * q[0] + p[1] * q[1];
       cross2 += p[0] * q[1] - p[1] * q[0];
       if (fsc && gsc) sc += chi2(fsc[i], gsc[j]);
     }
-    const residual = Math.max(0, 1 - (dot2 * dot2 + cross2 * cross2) / (m * m));
-    const turn = 1 - Math.cos(Math.atan2(cross2, dot2));
+    const residual = Math.max(0, 1 - (dot3 * dot3 + cross2 * cross2) / (m * m));
+    const turn = 1 - Math.cos(Math.atan2(cross2, dot3));
     return residual + TURN_WEIGHT * turn + sc / m;
   };
   if (!free.closed) return { start: 0, cost: cost(0) };
@@ -3366,16 +4495,16 @@ function procrustes(a, b) {
   const ca = frame(pa).c;
   const cb = frame(pb).c;
   let ss = 0;
-  let dot2 = 0;
+  let dot3 = 0;
   let cross2 = 0;
   for (let i = 0; i < Math.min(pa.length, pb.length); i++) {
     const p = [pa[i][0] - ca[0], pa[i][1] - ca[1]];
     const q = [pb[i][0] - cb[0], pb[i][1] - cb[1]];
     ss += p[0] * p[0] + p[1] * p[1];
-    dot2 += p[0] * q[0] + p[1] * q[1];
+    dot3 += p[0] * q[0] + p[1] * q[1];
     cross2 += p[0] * q[1] - p[1] * q[0];
   }
-  return { ca, cb, theta: Math.atan2(cross2, dot2), s: ss > 1e-12 ? Math.hypot(dot2, cross2) / ss : 1 };
+  return { ca, cb, theta: Math.atan2(cross2, dot3), s: ss > 1e-12 ? Math.hypot(dot3, cross2) / ss : 1 };
 }
 function interpolateMorphContours(a, b, u, options = {}) {
   const w = options.linear ? 0 : Math.min(1, Math.max(0, options.rigidity ?? 1));
@@ -3429,39 +4558,24 @@ function interpolateVectorColor(a, b, t) {
   if (t >= 1) return b;
   return mixColorsOklab(a, b, t) ?? (t < 0.5 ? a : b);
 }
-function sortedStops(g) {
-  return g.stops.slice().sort((x, y) => x.offset - y.offset);
-}
-function sampleGradient(stops, offset) {
-  if (!stops.length) return { color: "transparent", opacity: 1 };
-  const first = stops[0];
-  const last = stops[stops.length - 1];
-  if (offset <= first.offset) return { color: first.color, opacity: first.opacity ?? 1 };
-  if (offset >= last.offset) return { color: last.color, opacity: last.opacity ?? 1 };
-  let i = 0;
-  while (i + 1 < stops.length && stops[i + 1].offset < offset) i++;
-  const x = stops[i];
-  const y = stops[i + 1];
-  const u = y.offset - x.offset > 1e-12 ? (offset - x.offset) / (y.offset - x.offset) : 1;
-  return { color: interpolateVectorColor(x.color, y.color, u), opacity: lerpN(x.opacity ?? 1, y.opacity ?? 1, u) };
-}
 function resampleGradientStops(g, offsets) {
-  const stops = sortedStops(g);
   return offsets.map((offset) => {
-    const s = sampleGradient(stops, offset);
-    return s.opacity < 1 ? { offset, color: s.color, opacity: s.opacity } : { offset, color: s.color };
+    const s = sampleVectorGradient(g, offset);
+    return s.opacity < 1 ? { offset, color: s.color, opacity: Math.round(s.opacity * 1e4) / 1e4 } : { offset, color: s.color };
   });
 }
 function lerpAngle(a, b, t) {
   const d = ((b - a + 180) % 360 + 360) % 360 - 180;
   return a + d * t;
 }
-function lerpGradient(a, b, t) {
-  if (a.type !== b.type) return null;
-  let stopsA = sortedStops(a);
-  let stopsB = sortedStops(b);
-  if (stopsA.length !== stopsB.length) {
-    const offs = [...stopsA, ...stopsB].map((s) => s.offset).filter(Number.isFinite).sort((x, y) => x - y);
+var lerpPoint = (a, b, t) => ({ x: lerpN(a.x, b.x, t), y: lerpN(a.y, b.y, t) });
+var sameColourModel = (a, b) => (a.interpolation ?? "srgb") === (b.interpolation ?? "srgb") && (a.smoothness ?? 0) === (b.smoothness ?? 0);
+function lerpStops(a, b, t) {
+  let stopsA = sortedVectorGradientStops(a);
+  let stopsB = sortedVectorGradientStops(b);
+  const resampled = stopsA.length !== stopsB.length || !sameColourModel(a, b);
+  if (resampled) {
+    const offs = [...expandVectorGradientStops(a), ...expandVectorGradientStops(b), ...stopsA, ...stopsB].map((s) => s.offset).filter(Number.isFinite).sort((x, y) => x - y);
     const common = offs.filter((o, i) => i === 0 || o - offs[i - 1] > 1e-4);
     stopsA = resampleGradientStops(a, common);
     stopsB = resampleGradientStops(b, common);
@@ -3471,12 +4585,53 @@ function lerpGradient(a, b, t) {
     const opacity = lerpN(x.opacity ?? 1, y.opacity ?? 1, t);
     const stop = { offset: lerpN(x.offset, y.offset, t), color: interpolateVectorColor(x.color, y.color, t) };
     if (opacity < 1) stop.opacity = opacity;
+    const mid = lerpN(x.midpoint ?? 0.5, y.midpoint ?? 0.5, t);
+    if (Math.abs(mid - 0.5) > 1e-6) stop.midpoint = mid;
     return stop;
   });
-  if (a.type === "linear" && b.type === "linear") return { type: "linear", angle: lerpAngle(a.angle ?? 90, b.angle ?? 90, t), stops };
-  const ra = a;
-  const rb = b;
-  return { type: "radial", cx: lerpN(ra.cx ?? 0.5, rb.cx ?? 0.5, t), cy: lerpN(ra.cy ?? 0.5, rb.cy ?? 0.5, t), r: lerpN(ra.r ?? 0.5, rb.r ?? 0.5, t), stops };
+  return { stops, resampled };
+}
+function lerpGradient(a, b, t) {
+  if (a.type !== b.type) return null;
+  const { stops, resampled } = lerpStops(a, b, t);
+  const near2 = t < 0.5 ? a : b;
+  const out = { type: a.type, stops };
+  if (!resampled) {
+    if (a.interpolation && a.interpolation !== "srgb") out.interpolation = a.interpolation;
+    if (a.smoothness) out.smoothness = a.smoothness;
+  }
+  if (near2.spread && near2.spread !== "pad") out.spread = near2.spread;
+  if (near2.strokeMode && near2.strokeMode !== "within") out.strokeMode = near2.strokeMode;
+  const ea = hasExplicitGradientGeometry(a);
+  const eb = hasExplicitGradientGeometry(b);
+  if (!ea && !eb) {
+    if (a.angle !== void 0 || b.angle !== void 0 || a.type === "linear" || a.type === "reflected") {
+      const fallback = a.type === "linear" || a.type === "reflected" ? 180 : 90;
+      out.angle = lerpAngle(a.angle ?? fallback, b.angle ?? fallback, t);
+    }
+    if (a.type !== "linear" && a.type !== "reflected") {
+      out.cx = lerpN(a.cx ?? 0.5, b.cx ?? 0.5, t);
+      out.cy = lerpN(a.cy ?? 0.5, b.cy ?? 0.5, t);
+      out.r = lerpN(a.r ?? 0.5, b.r ?? 0.5, t);
+    }
+    return out;
+  }
+  const pa = vectorGradientPoints(a);
+  const pb = vectorGradientPoints(b);
+  if (pa.units !== pb.units) {
+    const src = explicitVectorGradient(near2);
+    return { ...src, stops: out.stops, ...out.interpolation ? { interpolation: out.interpolation } : {}, ...out.smoothness ? { smoothness: out.smoothness } : {} };
+  }
+  out.start = lerpPoint(pa.start, pb.start, t);
+  out.end = lerpPoint(pa.end, pb.end, t);
+  out.width = lerpPoint(pa.width, pb.width, t);
+  out.units = pa.units;
+  if (a.type === "radial") {
+    if (pa.focal || pb.focal) out.focal = lerpPoint(pa.focal ?? pa.start, pb.focal ?? pb.start, t);
+    const fr = lerpN(pa.focalRadius, pb.focalRadius, t);
+    if (fr > 0) out.focalRadius = fr;
+  }
+  return out;
 }
 function solidLike(color, like) {
   return { ...like, stops: like.stops.map((s) => color === null ? { offset: s.offset, color: s.color, opacity: 0 } : { offset: s.offset, color }) };
@@ -3490,8 +4645,8 @@ function interpolateVectorPaint(a, b, t) {
   if (typeof a === "string" && pa && typeof b === "string" && pb) return interpolateVectorColor(a, b, t);
   if (!pa && typeof b === "string") return interpolateVectorColor("transparent", b, t);
   if (!pb && typeof a === "string") return interpolateVectorColor(a, "transparent", t);
-  const ga = pa && typeof a === "object" && a ? a : null;
-  const gb = pb && typeof b === "object" && b ? b : null;
+  const ga = pa && isVectorGradient(a) ? a : null;
+  const gb = pb && isVectorGradient(b) ? b : null;
   if (ga && gb) return lerpGradient(ga, gb, t) ?? (t < 0.5 ? a : b);
   if (gb) return lerpGradient(solidLike(pa ? a : null, gb), gb, t) ?? b;
   if (ga) return lerpGradient(ga, solidLike(pb ? b : null, ga), t) ?? a;
@@ -3628,15 +4783,15 @@ function createVectorMorph(a, b, options = {}) {
   for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
     const x = pa[i];
     const y = pb[i];
-    const sub3 = { ...options, id: `${id}-${i}`, starts: void 0 };
+    const sub5 = { ...options, id: `${id}-${i}`, starts: void 0 };
     if (x && y) {
-      parts.push(preparePathMorph(x.path, y.path, sub3, x.m, y.m));
+      parts.push(preparePathMorph(x.path, y.path, sub5, x.m, y.m));
       opacities.push([x.opacity, y.opacity]);
     } else if (x) {
-      parts.push(preparePathMorph(x.path, collapsedPath(x.path, x.m, ba, bb), sub3, x.m, IDENTITY_MATRIX));
+      parts.push(preparePathMorph(x.path, collapsedPath(x.path, x.m, ba, bb), sub5, x.m, IDENTITY_MATRIX));
       opacities.push([x.opacity, x.opacity]);
     } else if (y) {
-      parts.push(preparePathMorph(collapsedPath(y.path, y.m, bb, ba), y.path, sub3, IDENTITY_MATRIX, y.m));
+      parts.push(preparePathMorph(collapsedPath(y.path, y.m, bb, ba), y.path, sub5, IDENTITY_MATRIX, y.m));
       opacities.push([y.opacity, y.opacity]);
     }
   }
@@ -4621,16 +5776,16 @@ function solveOnSegment(seg, base, cond) {
     return cond([p[0] - b[0], p[1] - b[1]], segmentDerivative(seg, t));
   };
   const vals = [];
-  let scale = 0;
+  let scale3 = 0;
   for (let i = 0; i <= CURVE_SAMPLES; i++) {
     const t = i / CURVE_SAMPLES;
     const p = segmentPoint(seg, t);
     const d = segmentDerivative(seg, t);
     const r = [p[0] - b[0], p[1] - b[1]];
     vals.push(cond(r, d));
-    scale = Math.max(scale, Math.hypot(r[0], r[1]) * Math.hypot(d[0], d[1]));
+    scale3 = Math.max(scale3, Math.hypot(r[0], r[1]) * Math.hypot(d[0], d[1]));
   }
-  if (!(scale > 0) || vals.every((v2) => Math.abs(v2) <= scale * 1e-12)) return [];
+  if (!(scale3 > 0) || vals.every((v2) => Math.abs(v2) <= scale3 * 1e-12)) return [];
   const out = [];
   for (let i = 0; i < CURVE_SAMPLES; i++) {
     const ga = vals[i];
@@ -4664,7 +5819,7 @@ function solveOnSegment(seg, base, cond) {
 
 // src/vector/pathEdit.ts
 var EPS4 = 1e-9;
-var unit3 = (x, y) => {
+var unit4 = (x, y) => {
   const l = Math.hypot(x, y);
   return l > 1e-12 && Number.isFinite(l) ? [x / l, y / l] : null;
 };
@@ -4677,14 +5832,14 @@ function cubicOf(sp, i) {
 var isLine = (sp, i) => subpathSegment(sp, i).length === 2;
 function startTangent2(c) {
   for (let k = 1; k < 4; k++) {
-    const u = unit3(c[k][0] - c[0][0], c[k][1] - c[0][1]);
+    const u = unit4(c[k][0] - c[0][0], c[k][1] - c[0][1]);
     if (u) return u;
   }
   return [1, 0];
 }
 function endTangent2(c) {
   for (let k = 2; k >= 0; k--) {
-    const u = unit3(c[3][0] - c[k][0], c[3][1] - c[k][1]);
+    const u = unit4(c[3][0] - c[k][0], c[3][1] - c[k][1]);
     if (u) return u;
   }
   return [1, 0];
@@ -4748,13 +5903,13 @@ function removeAnchorKeepingShape(sp, index) {
     const pi = (index + n - 1) % n;
     const ni = (index + 1) % n;
     if (!(isLine(sp, pi) && isLine(sp, index))) {
-      const left = cubicOf(sp, pi);
+      const left2 = cubicOf(sp, pi);
       const right = cubicOf(sp, index);
       const N = 16;
       const pts = [];
-      sample(left, N, pts, true);
+      sample(left2, N, pts, true);
       sample(right, N, pts, false);
-      const t0 = startTangent2(left);
+      const t0 = startTangent2(left2);
       const t1 = endTangent2(right);
       const { curve } = fitAcross(pts, N, t0, t1);
       if ([curve.p1, curve.p2].every((p) => Number.isFinite(p[0]) && Number.isFinite(p[1]))) {
@@ -4956,7 +6111,7 @@ function smoothSubpath(sp, amount = 1, only) {
     const prev = orig[(i + n - 1) % n];
     const next = orig[(i + 1) % n];
     const p = orig[i];
-    const dir = unit3(next.x - prev.x, next.y - prev.y);
+    const dir = unit4(next.x - prev.x, next.y - prev.y);
     if (!dir) continue;
     const li = dist2(p, prev) / 3;
     const lo = dist2(p, next) / 3;
@@ -5091,9 +6246,9 @@ function facesOf(path, fillRule) {
 function splitIntoFaces(path, fillRule = "nonzero") {
   return facesOf(path, fillRule).map(faceToPath);
 }
-function rootsInUnit(a, b, c, d, scale) {
+function rootsInUnit(a, b, c, d, scale3) {
   const f = (t) => ((a * t + b) * t + c) * t + d;
-  const tol = 1e-12 * Math.max(1, scale);
+  const tol = 1e-12 * Math.max(1, scale3);
   const cuts = [0];
   const qa = 3 * a;
   const qb = 2 * b;
@@ -5150,9 +6305,9 @@ function lineHits(p, q, seg) {
     coeffs = [-h0 + 3 * h1 - 3 * h2 + h3, 3 * h0 - 6 * h1 + 3 * h2, -3 * h0 + 3 * h1, h0];
   }
   if (coeffs.every((c) => Math.abs(c) < 1e-12 * Math.max(1, len2))) return [];
-  const scale = Math.sqrt(len2) * Math.max(1, ...seg.map((pt2) => Math.abs(pt2[0]) + Math.abs(pt2[1])));
+  const scale3 = Math.sqrt(len2) * Math.max(1, ...seg.map((pt2) => Math.abs(pt2[0]) + Math.abs(pt2[1])));
   const out = [];
-  for (const t of rootsInUnit(...coeffs, scale)) {
+  for (const t of rootsInUnit(...coeffs, scale3)) {
     const point = segmentPoint(seg, t);
     const s = ((point[0] - p[0]) * dx + (point[1] - p[1]) * dy) / len2;
     if (s >= -1e-9 && s <= 1 + 1e-9) out.push({ s: Math.min(1, Math.max(0, s)), t, point });
@@ -6098,7 +7253,8 @@ var TOOL_LABELS = {
   width: "Width",
   shapeBuilder: "Shape Builder",
   paintBucket: "Paint Bucket",
-  blend: "Blend"
+  blend: "Blend",
+  gradient: "Gradient"
 };
 var TOOL_KEYS = {
   v: "select",
@@ -6116,7 +7272,8 @@ var TOOL_KEYS = {
   w: "width",
   m: "shapeBuilder",
   b: "paintBucket",
-  j: "blend"
+  j: "blend",
+  g: "gradient"
 };
 function vectorToolLabel(tool) {
   return TOOL_LABELS[tool];
@@ -6137,7 +7294,8 @@ var VECTOR_TOOL_SHORTCUTS = {
   width: "W",
   shapeBuilder: "M",
   paintBucket: "B",
-  blend: "J"
+  blend: "J",
+  gradient: "G"
 };
 var VECTOR_TOOL_GLYPHS = {
   select: "\u2196",
@@ -6155,7 +7313,8 @@ var VECTOR_TOOL_GLYPHS = {
   width: "\u21F9",
   shapeBuilder: "\u2295",
   paintBucket: "\u25CD",
-  blend: "\u29D3"
+  blend: "\u29D3",
+  gradient: "\u25D0"
 };
 var SHAPE_TOOLS = /* @__PURE__ */ new Set(["rect", "ellipse", "polygon", "star", "line"]);
 var BOOLEAN_OPS = {
@@ -6252,6 +7411,7 @@ var VectorEditorController = class {
   blendStart = null;
   /** Options new blends get (the toolbars edit them along with the selected blend's). */
   blendDefaults = {};
+  gradientEdit = { target: "fill", stop: null };
   /** What the highlight shows, to skip notifying when the pointer stays over the same face. */
   builderHoverKey = null;
   createId;
@@ -6276,15 +7436,26 @@ var VectorEditorController = class {
     this.createId = options.createId ?? defaultCreateId;
     this.onChange = options.onChange;
     this.state = this.computeState();
+    this.connect();
+  }
+  /** Listens to the history (once; again after `destroy`). */
+  connect() {
+    if (this.cleanups.length) return;
     this.cleanups.push(
       this.history.subscribe((h) => {
-        const s = this.state;
-        if (this.applying || s.canUndo === h.canUndo && s.canRedo === h.canRedo && s.undoLabel === h.undoName && s.redoLabel === h.redoName) return;
-        this.notify();
+        if (!this.applying && this.historyDiffers(h)) this.notify();
       })
     );
+    if (this.historyDiffers(this.history.getState())) this.state = this.computeState();
   }
-  /** Stops listening to the history. */
+  historyDiffers(h) {
+    const s = this.state;
+    return s.canUndo !== h.canUndo || s.canRedo !== h.canRedo || s.undoLabel !== h.undoName || s.redoLabel !== h.redoName;
+  }
+  /**
+   * Stops listening to the history and drops all listeners. A later `subscribe` reconnects, so a
+   * controller torn down by React StrictMode's double effect keeps working when it is reused.
+   */
   destroy() {
     this.cleanups.splice(0).forEach((fn) => fn());
     this.listeners.clear();
@@ -6296,6 +7467,7 @@ var VectorEditorController = class {
   getState = () => this.state;
   /** Calls `listener` after every change. Returns an unsubscribe function. */
   subscribe = (listener) => {
+    this.connect();
     this.listeners.add(listener);
     return () => {
       this.listeners.delete(listener);
@@ -6333,6 +7505,7 @@ var VectorEditorController = class {
       builder: this.builderPreview,
       blendStart: this.blendStart,
       blendDefaults: this.blendDefaults,
+      gradientEdit: this.gradientEdit,
       canUndo: h.canUndo,
       canRedo: h.canRedo,
       undoLabel: h.undoName,
@@ -6406,6 +7579,13 @@ var VectorEditorController = class {
         return this.builderPreview ? "cell" : "crosshair";
       case "blend":
         return h?.nodeId ? this.blendStart && this.blendStart.nodeId !== h.nodeId ? "copy" : "pointer" : "crosshair";
+      case "gradient": {
+        const part = this.drag?.kind === "gradient" ? this.drag.part : h?.gradient;
+        if (!part) return "crosshair";
+        if (part.kind === "bar") return this.drag ? "grabbing" : "copy";
+        if (part.kind === "handle" && part.handle === "start") return this.drag ? "grabbing" : "move";
+        return "pointer";
+      }
       default:
         return "crosshair";
     }
@@ -6831,6 +8011,233 @@ var VectorEditorController = class {
     this.widthEdit = null;
     return this.setStyle({ strokeWidthProfile: points.length ? points : null }, options.ids ?? this.selection, { label: points.length ? "Width Profile" : "Uniform Width" });
   }
+  // -------------------------------------------------------------------------
+  // Gradients
+  // -------------------------------------------------------------------------
+  /** Which paint (fill or stroke) the gradient tool and editor work on. */
+  setGradientTarget(target) {
+    if (target === this.gradientEdit.target) return;
+    this.gradientEdit = { target, stop: null };
+    this.notify();
+  }
+  /** Selects a stop of the gradient being edited (index into its sorted stops), or none. */
+  selectGradientStop(index) {
+    if (index === this.gradientEdit.stop) return;
+    this.gradientEdit = { ...this.gradientEdit, stop: index };
+    this.notify();
+  }
+  /** The gradient tool's annotator for the selection (screen pixels), or null when its paint is not a gradient. */
+  getGradientAnnotator() {
+    return getVectorGradientAnnotator(this.doc, this.selection, this.viewport, this.gradientEdit.target);
+  }
+  /** Unlocked paths of `ids` (default: the selection). */
+  gradientPaths(ids = this.selection) {
+    const out = /* @__PURE__ */ new Map();
+    for (const id of ids) {
+      const node = this.getNode(id);
+      if (node && !node.locked) {
+        for (const p of collectPathNodes(node)) if (!p.locked) out.set(p.id, p);
+      }
+    }
+    return [...out.values()];
+  }
+  /**
+   * Edits the gradient of the `target` paint (default: the editor's) of the selected (or given)
+   * paths with `patch`: a colour or no paint becomes a gradient (`patch.type`, default linear,
+   * from the colour to white). Consecutive edits with the same `merge` key are one undo step.
+   */
+  setGradient(patch, options = {}) {
+    const target = options.target ?? this.gradientEdit.target;
+    const paths = this.gradientPaths(options.ids ?? this.selection);
+    if (!paths.length) return { ok: false, message: "Nothing is selected." };
+    const next = /* @__PURE__ */ new Map();
+    for (const path of paths) {
+      const paint = path[target];
+      const base = isVectorGradient(paint) ? paint : defaultVectorGradient(patch.type ?? "linear", paint);
+      const g = applyVectorGradientPatch(base, patch);
+      if (!g) return { ok: false, message: "That is not a valid gradient: it needs at least one stop with an offset and a colour." };
+      next.set(path.id, { ...path, [target]: g });
+    }
+    this.change(options.label ?? "Gradient", () => this.setDoc(mapTree(this.doc.nodes, (n) => next.get(n.id) ?? n)), options.merge);
+    const stops = next.values().next().value?.[target]?.stops.length ?? 0;
+    if (this.gradientEdit.stop !== null && this.gradientEdit.stop >= stops) this.gradientEdit = { ...this.gradientEdit, stop: null };
+    return { ok: true };
+  }
+  /** Applies `fn` to every target gradient of the selection (paths whose paint is not a gradient are skipped). */
+  editGradients(label, fn, merge) {
+    const target = this.gradientEdit.target;
+    const paths = this.gradientPaths().filter((p) => isVectorGradient(p[target]));
+    if (!paths.length) return { ok: false, message: "The selection has no gradient." };
+    const next = /* @__PURE__ */ new Map();
+    for (const path of paths) {
+      const g = path[target];
+      const stops = fn(sortedVectorGradientStops(g));
+      if (!stops) return { ok: false, message: "A gradient keeps at least two stops." };
+      next.set(path.id, { ...path, [target]: { ...g, stops } });
+    }
+    this.change(label, () => this.setDoc(mapTree(this.doc.nodes, (n) => next.get(n.id) ?? n)), merge);
+    return { ok: true };
+  }
+  /** Changes stop `index` (colour, opacity, offset or midpoint) of the selection's gradients; selects it. */
+  setGradientStop(index, patch, options = {}) {
+    let moved = index;
+    const result = this.editGradients(
+      "Gradient Stop",
+      (stops) => {
+        if (!stops[index]) return stops;
+        let next = stops.map((s, i) => {
+          if (i !== index) return s;
+          const out = { ...s };
+          if (patch.color !== void 0) out.color = patch.color;
+          if (patch.opacity !== void 0 && Number.isFinite(patch.opacity)) {
+            const o = Math.min(1, Math.max(0, patch.opacity));
+            if (o < 1) out.opacity = o;
+            else delete out.opacity;
+          }
+          if (patch.midpoint !== void 0 && Number.isFinite(patch.midpoint)) {
+            const m = Math.min(0.95, Math.max(0.05, patch.midpoint));
+            if (Math.abs(m - 0.5) > 1e-3) out.midpoint = m;
+            else delete out.midpoint;
+          }
+          return out;
+        });
+        if (patch.offset !== void 0 && Number.isFinite(patch.offset)) ({ stops: next, index: moved } = moveVectorGradientStop(next, index, patch.offset));
+        return next;
+      },
+      options.merge
+    );
+    if (result.ok) this.selectGradientStop(moved);
+    return result;
+  }
+  /** Adds a stop at `offset` (painting what the gradient paints there) to the selection's gradients and selects it. */
+  addGradientStop(offset) {
+    let index = 0;
+    const target = this.gradientEdit.target;
+    const result = this.editGradients("Add Gradient Stop", (stops) => {
+      const path = this.gradientPaths().find((p) => isVectorGradient(p[target]));
+      const r = insertVectorGradientStop({ ...path[target], stops }, offset);
+      index = r.index;
+      return r.stops;
+    });
+    if (result.ok) this.selectGradientStop(index);
+    return result;
+  }
+  /** Removes stop `index` of the selection's gradients (never below two stops). */
+  removeGradientStop(index) {
+    const result = this.editGradients("Delete Gradient Stop", (stops) => removeVectorGradientStop(stops, index));
+    if (result.ok) this.selectGradientStop(null);
+    return result;
+  }
+  /** Reverses the selection's gradients (stops and midpoints). */
+  reverseGradient() {
+    return this.setGradient({ reverse: true }, { label: "Reverse Gradient" });
+  }
+  /** `doc` with path `id`'s `target` paint replaced. */
+  withGradient(doc, id, target, g) {
+    return { ...doc, nodes: mapTree(doc.nodes, (n) => n.id === id ? { ...n, [target]: g } : n) };
+  }
+  downGradient(screen, p, input) {
+    const before = this.snapshot();
+    const a = this.getGradientAnnotator();
+    let part = a ? hitVectorGradientAnnotator(a, screen) : null;
+    if (a && part) {
+      if (part.kind === "handle" && part.handle === "start" && input.alt && a.gradient.type === "radial") part = { kind: "handle", handle: "focal" };
+      if (part.kind === "stop") this.gradientEdit = { ...this.gradientEdit, stop: part.index };
+      this.drag = { kind: "gradient", part, nodeId: a.nodeId, targets: [a.nodeId], annotator: a, start: screen, startDoc: p, before, base: this.doc, moved: false, stop: part.kind === "stop" ? part.index : null };
+      this.interaction = { type: "gradient", part: part.kind, ...part.kind === "handle" ? { handle: part.handle } : {} };
+      this.notify();
+      return;
+    }
+    const hit = this.hitPath(p);
+    if (hit && !this.gradientPaths().some((n) => n.id === hit.id)) {
+      this.selection = [hit.id];
+      this.gradientEdit = { ...this.gradientEdit, stop: null };
+    }
+    const targets = this.gradientPaths().map((n) => n.id);
+    if (!targets.length) {
+      if (this.selection.length) this.clearSelection();
+      return;
+    }
+    this.drag = { kind: "gradient", part: null, nodeId: null, targets, annotator: null, start: screen, startDoc: p, before, base: this.doc, moved: false, stop: null };
+    this.interaction = { type: "gradient", part: "create" };
+    this.notify();
+  }
+  moveGradient(drag, screen, p, input) {
+    if (!drag.moved && Math.hypot(screen.x - drag.start.x, screen.y - drag.start.y) < 3) return;
+    drag.moved = true;
+    const target = this.gradientEdit.target;
+    const base = drag.base;
+    const constrained = (from, to) => {
+      if (!input.shift) return to;
+      const ang = Math.round(Math.atan2(to.y - from.y, to.x - from.x) / (Math.PI / 4)) * (Math.PI / 4);
+      const len2 = Math.hypot(to.x - from.x, to.y - from.y);
+      return { x: from.x + Math.cos(ang) * len2, y: from.y + Math.sin(ang) * len2 };
+    };
+    if (!drag.part) {
+      const end = constrained(drag.startDoc, p);
+      let doc = base;
+      for (const id2 of drag.targets) {
+        const node2 = findVectorNode(base.nodes, id2);
+        if (!node2) continue;
+        const paint = node2[target];
+        const g2 = isVectorGradient(paint) ? paint : defaultVectorGradient("linear", paint);
+        doc = this.withGradient(doc, id2, target, setVectorGradientVector(g2, vectorPathLocalBounds(node2), this.toLocal(id2, drag.startDoc, base), this.toLocal(id2, end, base)));
+      }
+      this.doc = doc;
+      this.notify(true);
+      return;
+    }
+    const id = drag.nodeId;
+    const node = findVectorNode(base.nodes, id);
+    const g = node[target];
+    const bounds = vectorPathLocalBounds(node);
+    const local = (q) => this.toLocal(id, q, base);
+    const part = drag.part;
+    let next = g;
+    if (part.kind === "handle") {
+      let to = p;
+      if (part.handle === "end" || part.handle === "radius") to = constrained(this.screenToDocument(drag.annotator.start), p);
+      next = moveVectorGradientHandle(g, bounds, part.handle, local(to), local(drag.startDoc));
+    } else if (part.kind === "bar") {
+      next = moveVectorGradientHandle(g, bounds, "start", local(p), local(drag.startDoc));
+    } else {
+      const a = drag.annotator;
+      const pos = vectorGradientBarPosition(a, screen);
+      const stops = sortedVectorGradientStops(g);
+      if (part.kind === "stop") {
+        const off = Math.abs(pos.across - VECTOR_GRADIENT_STOP_GAP) > VECTOR_GRADIENT_OFF_BAR;
+        const removed = off ? removeVectorGradientStop(stops, part.index) : null;
+        if (removed) {
+          next = { ...g, stops: removed };
+          drag.stop = null;
+        } else {
+          const r = moveVectorGradientStop(stops, part.index, Math.min(1, Math.max(0, pos.offset)));
+          next = { ...g, stops: r.stops };
+          drag.stop = r.index;
+        }
+        this.interaction = { type: "gradient", part: "stop", ...removed ? { removing: true } : {} };
+        this.gradientEdit = { ...this.gradientEdit, stop: drag.stop };
+      } else {
+        const m = vectorGradientMidpointFromPosition(stops, part.index, pos.offset);
+        if (m !== null) next = { ...g, stops: stops.map((s, i) => i !== part.index ? s : Math.abs(m - 0.5) < 1e-3 ? (({ midpoint: _m, ...rest }) => rest)(s) : { ...s, midpoint: m }) };
+      }
+    }
+    this.doc = this.withGradient(base, id, target, next);
+    this.notify(true);
+  }
+  upGradient(drag) {
+    const part = drag.part;
+    if (!drag.moved) {
+      if (part?.kind === "bar") {
+        this.addGradientStop(part.offset);
+        return;
+      }
+      this.notify();
+      return;
+    }
+    const label = !part ? "Gradient" : part.kind === "stop" ? drag.stop === null ? "Delete Gradient Stop" : "Move Gradient Stop" : part.kind === "midpoint" ? "Gradient Midpoint" : part.kind === "bar" || part.kind === "handle" && part.handle === "start" ? "Move Gradient" : "Gradient Handle";
+    return this.commit(label, drag.before);
+  }
   /** Removes one width point of a path's profile. */
   removeWidthPoint(ref) {
     return this.removeWidthPoints([ref]);
@@ -6881,11 +8288,11 @@ var VectorEditorController = class {
     if (node?.type !== "path") return { ok: false, message: "There is no such path." };
     const g = vectorStrokeWidthGeometry(node);
     if (!g || !(g.unit > 0)) return { ok: false, message: "The path has no visible stroke." };
-    const num = (v2) => typeof v2 === "number" && Number.isFinite(v2) ? v2 : void 0;
-    const t = num(values.t);
-    const left = num(values.left);
-    const right = num(values.right);
-    const scale = (w) => w === void 0 ? void 0 : Math.max(0, w) / g.unit;
+    const num2 = (v2) => typeof v2 === "number" && Number.isFinite(v2) ? v2 : void 0;
+    const t = num2(values.t);
+    const left2 = num2(values.left);
+    const right = num2(values.right);
+    const scale3 = (w) => w === void 0 ? void 0 : Math.max(0, w) / g.unit;
     const profile = sanitizeWidthProfile(node.strokeWidthProfile);
     let points;
     let index;
@@ -6893,11 +8300,11 @@ var VectorEditorController = class {
     if (existing === null) {
       if (t === void 0) return { ok: false, message: "A new width point needs a position t." };
       if (profile.length >= VECTOR_WIDTH_PROFILE_MAX_POINTS) return { ok: false, message: "The profile has too many width points." };
-      ({ points, index } = insertWidthPoint(profile.length ? profile : null, t, { left: scale(left), right: scale(right) }, { step: true }));
+      ({ points, index } = insertWidthPoint(profile.length ? profile : null, t, { left: scale3(left2), right: scale3(right) }, { step: true }));
     } else {
       const p = profile[existing];
       if (!p) return { ok: false, message: "There is no such width point." };
-      const sides2 = { left: scale(left) ?? p.left, right: scale(right) ?? p.right };
+      const sides2 = { left: scale3(left2) ?? p.left, right: scale3(right) ?? p.right };
       const tt = t === void 0 ? p.t : Math.min(Math.max(t, 0), 1);
       if (Math.abs(tt - p.t) <= VECTOR_WIDTH_SAME_T) {
         points = setWidthPoint(profile, existing, sides2);
@@ -8714,6 +10121,13 @@ var VectorEditorController = class {
         const spot = this.strokeSpotAt(p);
         return spot ? { nodeId: spot.nodeId, strokeSpot: spot } : null;
       }
+      case "gradient": {
+        const a = this.getGradientAnnotator();
+        const part = a ? hitVectorGradientAnnotator(a, screen) : null;
+        if (a && part) return { nodeId: a.nodeId, gradient: part };
+        const path = this.hitPath(p);
+        return path ? { nodeId: path.id } : null;
+      }
       default:
         return null;
     }
@@ -8936,6 +10350,8 @@ var VectorEditorController = class {
         return this.downBuilder(p, input);
       case "blend":
         return this.downBlend(screen, p);
+      case "gradient":
+        return this.downGradient(screen, p, input);
       case "scissors": {
         const seg = this.nearestOutline(p);
         if (seg) this.cutPathAt(seg.nodeId, seg.point);
@@ -9227,6 +10643,8 @@ var VectorEditorController = class {
         this.viewport = { ...drag.viewport, x: drag.viewport.x + screen.x - drag.start.x, y: drag.viewport.y + screen.y - drag.start.y };
         this.notify();
         return;
+      case "gradient":
+        return this.moveGradient(drag, screen, p, input);
       case "move": {
         let dx = p.x - drag.start.x;
         let dy = p.y - drag.start.y;
@@ -9602,6 +11020,8 @@ var VectorEditorController = class {
       }
       case "builder":
         return this.upBuilder(drag);
+      case "gradient":
+        return this.upGradient(drag);
       case "stroke": {
         this.notify();
         if (drag.tool === "knife") this.knife(drag.points);
@@ -9816,6 +11236,7 @@ var VectorEditorController = class {
       case "Delete":
       case "Backspace":
         if (this.tool === "width" && this.widthPoints.length) return this.removeWidthPoints().ok;
+        if (this.tool === "gradient" && this.gradientEdit.stop !== null) return this.removeGradientStop(this.gradientEdit.stop).ok;
         if (this.pen) {
           const node = this.getNode(this.pen.nodeId);
           const sp = node.subpaths[this.pen.subpath];
@@ -9924,25 +11345,24 @@ function pencilPressureProfile(points, pressures) {
 }
 
 // src/vector/render.ts
-var fmt = (n) => Math.round(n * 100) / 100;
-var fmtMatrix = (m) => `matrix(${m.map((n) => Math.round(n * 1e6) / 1e6).join(" ")})`;
+var fmt4 = (n) => Math.round(n * 100) / 100;
+var fmtMatrix2 = (m) => `matrix(${m.map((n) => Math.round(n * 1e6) / 1e6).join(" ")})`;
 var VECTOR_BUILDER_HATCH_GAP = 6;
 function renderNode(stored, defs, idPrefix) {
   if (stored.visible === false) return null;
   const node = expandVectorAppearance(stored);
   if (node.type === "group") {
     const children = node.children.map((c) => renderNode(c, defs, idPrefix)).filter((c) => !!c);
-    return { kind: "group", id: node.id, ...node.transform ? { transform: fmtMatrix(node.transform) } : {}, opacity: node.opacity ?? 1, children };
+    return { kind: "group", id: node.id, ...node.transform ? { transform: fmtMatrix2(node.transform) } : {}, opacity: node.opacity ?? 1, children };
   }
-  const fill = vectorPaintToSvg(node.fill, `${idPrefix}fill-${node.id}`);
-  const stroke = vectorPaintToSvg(node.stroke, `${idPrefix}stroke-${node.id}`);
-  if (fill.gradient) defs.push(fill.gradient);
-  if (stroke.gradient) defs.push(stroke.gradient);
+  const fill = vectorPaintToSvg(node.fill, `${idPrefix}fill-${node.id}`, { node });
+  const stroke = vectorPaintToSvg(node.stroke, `${idPrefix}stroke-${node.id}`, { node, role: "stroke" });
+  defs.push(...fill.defs, ...stroke.defs);
   const strokeParts = stroke.value !== "none" ? vectorStrokeSvgParts(node, `${idPrefix}clip-${node.id}`) : void 0;
   return {
     kind: "path",
     id: node.id,
-    ...node.transform ? { transform: fmtMatrix(node.transform) } : {},
+    ...node.transform ? { transform: fmtMatrix2(node.transform) } : {},
     ...strokeParts ? { strokeParts } : {},
     d: vectorPathData(node),
     fill: fill.value,
@@ -9961,7 +11381,7 @@ function getVectorSceneRenderData(state, options = {}) {
   const nodes = state.document.nodes.map((n) => renderNode(n, defs, prefix)).filter((n) => !!n);
   const v2 = state.viewport;
   return {
-    transform: `translate(${fmt(v2.x)} ${fmt(v2.y)}) scale(${v2.zoom})`,
+    transform: `translate(${fmt4(v2.x)} ${fmt4(v2.y)}) scale(${v2.zoom})`,
     width: state.document.width,
     height: state.document.height,
     ...state.document.background ? { background: state.document.background } : {},
@@ -10049,7 +11469,7 @@ function getVectorOverlayRenderData(state) {
       const a = toScreen(state, last);
       const p = toScreen(state, state.pointer);
       const c = last.out ? toScreen(state, last.out) : null;
-      penPreview = c ? `M${fmt(a.x)} ${fmt(a.y)}Q${fmt(c.x)} ${fmt(c.y)} ${fmt(p.x)} ${fmt(p.y)}` : `M${fmt(a.x)} ${fmt(a.y)}L${fmt(p.x)} ${fmt(p.y)}`;
+      penPreview = c ? `M${fmt4(a.x)} ${fmt4(a.y)}Q${fmt4(c.x)} ${fmt4(c.y)} ${fmt4(p.x)} ${fmt4(p.y)}` : `M${fmt4(a.x)} ${fmt4(a.y)}L${fmt4(p.x)} ${fmt4(p.y)}`;
     }
   }
   const origin = toScreen(state, { x: 0, y: 0 });
@@ -10057,45 +11477,45 @@ function getVectorOverlayRenderData(state) {
   let status = null;
   const it = state.interaction;
   if (it?.type === "rotate") status = `${Math.round(it.angle)}\xB0`;
-  else if (it?.type === "move" || it?.type === "anchors") status = `\u0394 ${fmt(it.dx)}, ${fmt(it.dy)}`;
+  else if (it?.type === "move" || it?.type === "anchors") status = `\u0394 ${fmt4(it.dx)}, ${fmt4(it.dy)}`;
   else if (it?.type === "scale" || it?.type === "draw") {
     const b = it.type === "draw" ? findVectorNode(doc.nodes, it.nodeId) ? vectorNodeBounds(findVectorNode(doc.nodes, it.nodeId)) : null : state.selectionFrame;
-    if (b) status = `W ${fmt(b.width)} \xD7 H ${fmt(b.height)}`;
+    if (b) status = `W ${fmt4(b.width)} \xD7 H ${fmt4(b.height)}`;
   }
   const guides = { lines: [], labels: [] };
   if (state.guides) {
     for (const l of state.guides.lines) {
       const a = toScreen(state, { x: l.x1, y: l.y1 });
       const b = toScreen(state, { x: l.x2, y: l.y2 });
-      guides.lines.push({ kind: l.kind, x1: fmt(a.x), y1: fmt(a.y), x2: fmt(b.x), y2: fmt(b.y) });
+      guides.lines.push({ kind: l.kind, x1: fmt4(a.x), y1: fmt4(a.y), x2: fmt4(b.x), y2: fmt4(b.y) });
     }
     for (const l of state.guides.labels) {
       const p = toScreen(state, l);
-      guides.labels.push({ kind: l.kind, x: fmt(p.x), y: fmt(p.y), text: l.text });
+      guides.labels.push({ kind: l.kind, x: fmt4(p.x), y: fmt4(p.y), text: l.text });
     }
   }
   let toolStroke = null;
   if (it?.type === "stroke") {
     const pts = it.points.map((q) => toScreen(state, q));
-    const d = pts.map((q, i) => `${i ? "L" : "M"}${fmt(q.x)} ${fmt(q.y)}`).join("") + (pts.length === 1 ? `L${fmt(pts[0].x)} ${fmt(pts[0].y)}` : "");
-    toolStroke = { tool: it.tool, d, width: fmt(it.width * z) };
+    const d = pts.map((q, i) => `${i ? "L" : "M"}${fmt4(q.x)} ${fmt4(q.y)}`).join("") + (pts.length === 1 ? `L${fmt4(pts[0].x)} ${fmt4(pts[0].y)}` : "");
+    toolStroke = { tool: it.tool, d, width: fmt4(it.width * z) };
   }
   let pencilString = null;
   if (it?.type === "draw" && it.string) {
     const a = toScreen(state, it.string[0]);
     const b = toScreen(state, it.string[1]);
-    pencilString = { x1: fmt(a.x), y1: fmt(a.y), x2: fmt(b.x), y2: fmt(b.y) };
+    pencilString = { x1: fmt4(a.x), y1: fmt4(a.y), x2: fmt4(b.x), y2: fmt4(b.y) };
   }
   const dragged = it?.type === "corner" ? it.ref : null;
   const cornerWidgets = getVectorCornerWidgets(state).map((w) => {
     const s = toScreen(state, w);
-    return { ref: w.ref, x: fmt(s.x), y: fmt(s.y), radius: w.radius, kind: w.kind, hovered: sameAnchor(state.hover?.corner, w.ref), active: !!dragged };
+    return { ref: w.ref, x: fmt4(s.x), y: fmt4(s.y), radius: w.radius, kind: w.kind, hovered: sameAnchor(state.hover?.corner, w.ref), active: !!dragged };
   });
-  if (it?.type === "corner") status = `R ${fmt(it.radius)}`;
-  const cutPoint = state.tool === "scissors" && state.hover?.segment && !it ? (({ x, y }) => ({ x: fmt(x), y: fmt(y) }))(toScreen(state, state.hover.segment.point)) : null;
+  if (it?.type === "corner") status = `R ${fmt4(it.radius)}`;
+  const cutPoint = state.tool === "scissors" && state.hover?.segment && !it ? (({ x, y }) => ({ x: fmt4(x), y: fmt4(y) }))(toScreen(state, state.hover.segment.point)) : null;
   const sc = (p) => {
     const q = toScreen(state, p);
-    return { x: fmt(q.x), y: fmt(q.y) };
+    return { x: fmt4(q.x), y: fmt4(q.y) };
   };
   const sameWidth = (a, b) => !!a && a.nodeId === b.nodeId && a.index === b.index;
   const widthPoints = getVectorWidthHandles(state).map((h) => {
@@ -10106,7 +11526,7 @@ function getVectorOverlayRenderData(state) {
   });
   const spot = state.tool === "width" && !it ? state.hover?.strokeSpot : null;
   const widthSpot = spot ? { ...sc(spot.point), left: sc(spot.left), right: sc(spot.right) } : null;
-  if (it?.type === "width") status = it.mode === "move" ? "Move width point" : it.mode === "copy" ? "Copy width point" : `W ${fmt(it.width)}`;
+  if (it?.type === "width") status = it.mode === "move" ? "Move width point" : it.mode === "copy" ? "Copy width point" : `W ${fmt4(it.width)}`;
   let builder = null;
   if (state.builder) {
     const v2 = state.viewport;
@@ -10129,7 +11549,43 @@ function getVectorOverlayRenderData(state) {
   }
   const blend = blendOverlay(state);
   if (state.tool === "blend" && !it) status = state.blendStart ? "Click another shape to blend into" : "Click a shape to blend from";
-  return { outlines, selectionBox, anchors, handles, marquee, penPreview, artboard, guides, status, toolStroke, pencilString, cutPoint, cornerWidgets, widthPoints, widthSpot, builder, blend };
+  let gradient = null;
+  if (state.tool === "gradient") {
+    gradient = gradientOverlay(state);
+    if (!gradient && !it) status = "Drag across a shape to set a gradient";
+    else if (it?.type === "gradient" && it.removing) status = "Release to delete the stop";
+  }
+  return { outlines, selectionBox, anchors, handles, marquee, penPreview, artboard, guides, status, toolStroke, pencilString, cutPoint, cornerWidgets, widthPoints, widthSpot, builder, blend, gradient };
+}
+function gradientOverlay(state) {
+  const a = getVectorGradientAnnotator(state.document, state.selection, state.viewport, state.gradientEdit.target);
+  if (!a) return null;
+  const hover = state.interaction ? null : state.hover?.gradient;
+  const handleHovered = (h) => hover?.kind === "handle" && hover.handle === h;
+  const pt2 = (p) => ({ x: fmt4(p.x), y: fmt4(p.y) });
+  const centred = isCentredVectorGradient(a.gradient.type);
+  const removing = state.interaction?.type === "gradient" && !!state.interaction.removing;
+  return {
+    nodeId: a.nodeId,
+    type: a.gradient.type,
+    start: { ...pt2(a.start), hovered: handleHovered("start") },
+    end: { ...pt2(a.end), hovered: handleHovered(centred ? "radius" : "end"), handle: centred ? "radius" : "end" },
+    aspect: a.aspect ? { ...pt2(a.aspect), hovered: handleHovered("aspect") } : null,
+    focal: a.focal ? { ...pt2(a.focal), hovered: handleHovered("focal") } : null,
+    stops: a.stops.map((s) => ({
+      index: s.index,
+      ...pt2(s),
+      barX: fmt4(s.x - a.normal.x * VECTOR_GRADIENT_STOP_GAP),
+      barY: fmt4(s.y - a.normal.y * VECTOR_GRADIENT_STOP_GAP),
+      color: s.color,
+      opacity: s.opacity ?? 1,
+      selected: state.gradientEdit.stop === s.index,
+      hovered: hover?.kind === "stop" && hover.index === s.index
+    })),
+    midpoints: a.midpoints.map((m) => ({ index: m.index, ...pt2(m), hovered: hover?.kind === "midpoint" && hover.index === m.index })),
+    extent: a.extent,
+    removing
+  };
 }
 function selectedBlends(state) {
   const out = /* @__PURE__ */ new Map();
@@ -10146,7 +11602,7 @@ function blendOverlay(state) {
   const doc = state.document;
   const sc = (p, m) => {
     const q = { x: m[0] * p.x + m[2] * p.y + m[4], y: m[1] * p.x + m[3] * p.y + m[5] };
-    return { x: fmt(q.x), y: fmt(q.y) };
+    return { x: fmt4(q.x), y: fmt4(q.y) };
   };
   const spines = selectedBlends(state).flatMap((g) => {
     const s = vectorBlendSpine(g);
@@ -10224,7 +11680,7 @@ var VECTOR_OVERLAY_THEME = {
   builderHatchOpacity: 0.6
 };
 function vectorDiamondPath(x, y, r = VECTOR_OVERLAY_THEME.widthPointSize) {
-  return `M${fmt(x)} ${fmt(y - r)}L${fmt(x + r)} ${fmt(y)}L${fmt(x)} ${fmt(y + r)}L${fmt(x - r)} ${fmt(y)}Z`;
+  return `M${fmt4(x)} ${fmt4(y - r)}L${fmt4(x + r)} ${fmt4(y)}L${fmt4(x)} ${fmt4(y + r)}L${fmt4(x - r)} ${fmt4(y)}Z`;
 }
 function toVectorModifiers(event) {
   return { shift: !!event.shiftKey, alt: !!event.altKey, mod: !!(event.metaKey || event.ctrlKey) };
@@ -10329,6 +11785,45 @@ function vectorPaintToHex(paint) {
   const hex = m[1].length === 3 ? m[1].replace(/./g, (c) => c + c) : m[1];
   return `#${hex.toLowerCase()}`;
 }
+var VECTOR_GRADIENT_TYPE_LABELS = { linear: "Linear", radial: "Radial", conic: "Conic", reflected: "Reflected", diamond: "Diamond" };
+var VECTOR_GRADIENT_SPREAD_LABELS = { pad: "Pad", reflect: "Reflect", repeat: "Repeat" };
+var VECTOR_GRADIENT_INTERPOLATION_LABELS = { srgb: "sRGB", linear: "Linear light", oklab: "Oklab" };
+var VECTOR_STROKE_GRADIENT_MODE_LABELS = { within: "Within stroke", along: "Along stroke", across: "Across stroke" };
+function getVectorGradientEditor(state) {
+  const paths = [];
+  for (const id of state.selection) {
+    const node = findVectorNode(state.document.nodes, id);
+    if (node) paths.push(...collect(node));
+  }
+  if (!paths.length) return null;
+  const target = state.gradientEdit.target;
+  const paint = paths[0][target];
+  const gradient = isVectorGradient(paint) ? paint : null;
+  const sorted = gradient ? sortedVectorGradientStops(gradient) : [];
+  const stopIndex = state.gradientEdit.stop;
+  const stops = sorted.map((s, index) => ({ ...s, index, selected: index === stopIndex }));
+  const sel = stopIndex !== null && sorted[stopIndex] ? { ...sorted[stopIndex], index: stopIndex, last: stopIndex === sorted.length - 1 } : null;
+  const preview = gradient ? `linear-gradient(to right, ${expandVectorGradientStops(gradient).map((s) => {
+    const c = parseVectorColor(s.color);
+    const a = (c?.[3] ?? 1) * (s.opacity ?? 1);
+    const color = c ? `rgba(${Math.round(c[0] * 255)}, ${Math.round(c[1] * 255)}, ${Math.round(c[2] * 255)}, ${Math.round(a * 1e3) / 1e3})` : s.color;
+    return `${color} ${Math.round(s.offset * 1e4) / 100}%`;
+  }).join(", ")})` : null;
+  return {
+    target,
+    gradient,
+    color: vectorPaintToHex(paint),
+    stops,
+    selected: sel,
+    preview,
+    type: gradient?.type ?? null,
+    spread: gradient?.spread ?? "pad",
+    interpolation: gradient?.interpolation ?? "srgb",
+    smoothness: gradient?.smoothness ?? 0,
+    strokeMode: gradient?.strokeMode ?? "within",
+    mixed: paths.some((p) => JSON.stringify(p[target] ?? null) !== JSON.stringify(paint ?? null))
+  };
+}
 var VECTOR_PATH_ACTIONS = [
   { id: "join", label: "\u22C8", title: "Join", shortcut: "J", enabled: (s, p) => s + p > 0, run: (c) => c.joinPaths() },
   { id: "average", label: "\u22B9", title: "Average Points", shortcut: "Alt+J", enabled: (_s, p) => p > 1, run: (c) => c.averageAnchors("both") },
@@ -10416,8 +11911,41 @@ var checkBlendOptions = (params) => {
   if (params?.steps !== void 0 && !(Number.isFinite(params.steps) && params.steps >= 1)) fail("steps must be at least 1.");
   if (params?.distance !== void 0 && !(Number.isFinite(params.distance) && params.distance > 0)) fail("distance must be positive.");
 };
+var POINT = { type: "object", properties: { x: { type: "number" }, y: { type: "number" } }, required: ["x", "y"] };
+var GRADIENT_PROPS = {
+  type: { type: "string", enum: VECTOR_GRADIENT_TYPES, description: "linear, radial, conic (an angle sweep), reflected (linear mirrored about the start) or diamond." },
+  stops: {
+    type: "array",
+    minItems: 1,
+    items: {
+      type: "object",
+      properties: {
+        offset: { type: "number", minimum: 0, maximum: 1 },
+        color: { type: "string", description: "A CSS colour." },
+        opacity: { type: "number", minimum: 0, maximum: 1 },
+        midpoint: { type: "number", minimum: 0.05, maximum: 0.95, description: "Where between this stop and the next the colours are half-mixed (default 0.5)." }
+      },
+      required: ["offset", "color"]
+    }
+  },
+  angle: { type: "number", description: "Shorthand direction in degrees (0 up, clockwise): linear / reflected direction across the box, conic start angle, diamond turn." },
+  cx: { type: "number", description: "Shorthand centre x of radial / conic / diamond gradients, a fraction of the box (default 0.5)." },
+  cy: { type: "number" },
+  r: { type: "number", description: "Shorthand radius, a fraction of the box (default 0.5)." },
+  start: { ...POINT, description: "Explicit start (centre of radial / conic / diamond), in `units`. Wins over the shorthand." },
+  end: { ...POINT, description: "Explicit end of the main axis (the radius of radial / conic / diamond)." },
+  width: { ...POINT, description: "End of the secondary axis (aspect and turn of radial / conic / diamond); default square to the main axis, as long." },
+  focal: { ...POINT, description: "Radial focal point (where t = 0), in `units`." },
+  focalRadius: { type: "number", minimum: 0, maximum: 0.99, description: "Radial focal circle radius as a fraction of the radius (SVG fr)." },
+  units: { type: "string", enum: ["objectBoundingBox", "userSpaceOnUse"], description: "Space of start / end / width / focal: fractions of the shape box (default) or the node's own coordinates." },
+  spread: { type: "string", enum: VECTOR_GRADIENT_SPREADS, description: "What paints past the ends: pad (default), reflect or repeat." },
+  interpolation: { type: "string", enum: VECTOR_GRADIENT_INTERPOLATIONS, description: "Colour mixing space: srgb (default), linear (light) or oklab." },
+  smoothness: { type: "number", minimum: 0, maximum: 1, description: "Bends the ramp along a smooth spline through the stops (0 = straight)." },
+  strokeMode: { type: "string", enum: VECTOR_STROKE_GRADIENT_MODES, description: "On strokes: within (default, like a fill), along the path or across it." }
+};
 var PAINT = {
-  description: 'A CSS colour, `null` for none, or a gradient `{ type: "linear", angle, stops: [{ offset, color }] }`.'
+  description: 'A CSS colour, `null` for none, or a gradient object: `{ type: "linear" | "radial" | "conic" | "reflected" | "diamond", stops: [{ offset, color, opacity?, midpoint? }] }` plus the shorthand `angle` / `cx, cy, r` or explicit `start`, `end`, `width`, `focal`, `focalRadius`, `units`, and `spread`, `interpolation`, `smoothness`, `strokeMode` (see vector.setGradient).',
+  anyOf: [{ type: "string" }, { type: "null" }, { type: "object", properties: GRADIENT_PROPS, required: ["type", "stops"] }]
 };
 var STYLE_PROPS = {
   fill: PAINT,
@@ -10438,6 +11966,10 @@ var STYLE_PROPS = {
 var pickStyle = (params) => {
   const out = {};
   for (const key of Object.keys(STYLE_PROPS)) if (params[key] !== void 0) out[key] = params[key];
+  for (const key of ["fill", "stroke"]) {
+    const paint = out[key];
+    if (paint && typeof paint === "object") out[key] = sanitizeVectorGradient(paint) ?? fail(`${key} is not a valid gradient: give a type and at least one stop { offset, color }.`);
+  }
   return out;
 };
 var check = (result) => {
@@ -10578,6 +12110,26 @@ function createVectorCommands(controller, options = {}) {
         return { ok: true };
       }
     },
+    {
+      ...base,
+      id: `${prefix}setGradient`,
+      label: "Gradient\u2026",
+      keywords: ["gradient", "linear", "radial", "conic", "angle", "reflected", "diamond", "stops", "midpoint", "oklab", "spread", "focal", "along stroke", "across stroke", "reverse"],
+      description: "Edits the gradient of the fill (default) or stroke of paths (groups apply to every path inside): any gradient field (missing ones keep their value; a colour becomes a gradient from it to white), `aspect` (secondary axis over main axis), `reverse` (flip the stops and midpoints), `focal` / `width` null to remove them. Midpoints, smoothness and oklab / linear interpolation export to SVG as extra stops; conic and diamond gradients as patterns.",
+      params: { type: "object", properties: { ids: IDS, target: { type: "string", enum: ["fill", "stroke"] }, ...GRADIENT_PROPS, aspect: { type: "number" }, reverse: { type: "boolean" } } },
+      enabled: enabledFor,
+      undoable: true,
+      run: (_ctx, params) => {
+        const { ids: _i, target, ...patch } = params ?? {};
+        if (patch.type !== void 0 && !VECTOR_GRADIENT_TYPES.includes(patch.type)) fail(`Unknown gradient type "${patch.type}".`);
+        if (patch.stops !== void 0 && !(Array.isArray(patch.stops) && patch.stops.length)) fail("stops needs at least one { offset, color }.");
+        check(controller.setGradient(patch, { ids: ids(params), target: target ?? "fill" }));
+        const id = ids(params)[0];
+        const node = id ? controller.getNode(id) : void 0;
+        const path = node?.type === "path" ? node : void 0;
+        return { ok: true, ...path ? { gradient: path[target ?? "fill"] } : {} };
+      }
+    },
     {
       ...base,
       id: `${prefix}setCorners`,
@@ -11269,6 +12821,17 @@ export {
   VECTOR_EFFECT_PARAM_SPECS,
   VECTOR_EFFECT_TYPES,
   VECTOR_FILL_GAP,
+  VECTOR_GRADIENT_INTERPOLATIONS,
+  VECTOR_GRADIENT_INTERPOLATION_LABELS,
+  VECTOR_GRADIENT_MAX_PERIODS,
+  VECTOR_GRADIENT_MIDPOINT_GAP,
+  VECTOR_GRADIENT_MIN_STOPS,
+  VECTOR_GRADIENT_OFF_BAR,
+  VECTOR_GRADIENT_SPREADS,
+  VECTOR_GRADIENT_SPREAD_LABELS,
+  VECTOR_GRADIENT_STOP_GAP,
+  VECTOR_GRADIENT_TYPES,
+  VECTOR_GRADIENT_TYPE_LABELS,
   VECTOR_INK_MAX_CORNERS,
   VECTOR_MERGE_MODES,
   VECTOR_OVERLAY_THEME,
@@ -11280,6 +12843,8 @@ export {
   VECTOR_PRESSURE_NOMINAL,
   VECTOR_ROTATE_HANDLE_OFFSET,
   VECTOR_STROKE_ALIGN_LABELS,
+  VECTOR_STROKE_GRADIENT_MODES,
+  VECTOR_STROKE_GRADIENT_MODE_LABELS,
   VECTOR_STYLE_KEYS,
   VECTOR_TOOLS,
   VECTOR_TOOL_GLYPHS,
@@ -11299,6 +12864,8 @@ export {
   applyVectorBlendOptions,
   applyVectorCornersAttribute,
   applyVectorEffects,
+  applyVectorGradientPatch,
+  applyVectorGradientSpread,
   arrowheadInset,
   arrowheadPath,
   arrowheadWeight,
@@ -11314,6 +12881,7 @@ export {
   collectPathNodes,
   constrainToLeave,
   convertAnchor,
+  convertVectorGradient,
   cornerBisectorPoint,
   cornerRadiusChange,
   cornerSetback,
@@ -11325,6 +12893,7 @@ export {
   cutSubpathAt,
   dashIntervals,
   decomposeRigid,
+  defaultVectorGradient,
   effectPathLength,
   effectPathVertexCount,
   effectiveStrokeAlign,
@@ -11338,6 +12907,9 @@ export {
   expandVectorBlend,
   expandVectorCorners,
   expandVectorCornersOf,
+  expandVectorGradientSpread,
+  expandVectorGradientStops,
+  explicitVectorGradient,
   findVectorNode,
   fitCornerRadius,
   foldVectorBooleanOperands,
@@ -11351,6 +12923,8 @@ export {
   getVectorCornerWidgets,
   getVectorEffectsPanel,
   getVectorEnteredGroups,
+  getVectorGradientAnnotator,
+  getVectorGradientEditor,
   getVectorOverlayRenderData,
   getVectorSceneRenderData,
   getVectorSelectionBoxGeometry,
@@ -11359,6 +12933,8 @@ export {
   getVectorWidthHandles,
   getVisibleAnchors,
   getVisibleHandles,
+  gradientMidpointRemap,
+  hasExplicitGradientGeometry,
   hasOwnVectorAppearance,
   hasPaint,
   hasStrokeExtras,
@@ -11367,8 +12943,10 @@ export {
   hitTestVectorNode,
   hitTestVectorNodes,
   hitTestVectorStroke,
+  hitVectorGradientAnnotator,
   inferAnchorType,
   insertAnchor,
+  insertVectorGradientStop,
   insertWidthPoint,
   interpolateMorphContours,
   interpolateRigidMatrix,
@@ -11378,10 +12956,12 @@ export {
   interpolateVectorStyle,
   interpolateWidthProfiles,
   invertMatrix,
+  isCentredVectorGradient,
   isClosedBezierShape,
   isIdentityMatrix,
   isUniformWidthProfile,
   isVectorBlendGroup,
+  isVectorGradient,
   isVectorLiveBoolean,
   isVectorTextTarget,
   joinSubpaths,
@@ -11394,6 +12974,8 @@ export {
   morphContourToSubpath,
   morphPathsCross,
   moveAnchorHandle,
+  moveVectorGradientHandle,
+  moveVectorGradientStop,
   multiplyMatrices,
   nearestSegment,
   nearestStrokePosition,
@@ -11402,8 +12984,12 @@ export {
   normalizeVectorEffectParams,
   offsetPaths,
   parseSvgTransform,
+  parseVectorColor,
   parseVectorSvg,
   pathsCenter,
+  patternAttrs,
+  periodicVectorGradientStops,
+  pinVectorGradient,
   planShapeBuilder,
   polygonSubpath,
   polylineBounds,
@@ -11418,26 +13004,36 @@ export {
   removeAnchors,
   removeAnchorsKeepingShape,
   removeRedundantPoints,
+  removeVectorGradientStop,
   removeWidthPoints,
   repeatPaths,
   resampleGradientStops,
   resolveVectorBlendOptions,
   reverseMorphContour,
   reverseSubpath,
+  reverseVectorGradient,
   reverseWidthProfile,
   rotateMatrix,
   roundCornerPaths,
   roundSubpaths,
+  samplePlainStops,
   samplePolyline,
+  sampleVectorGradient,
+  sampleVectorGradientAt,
+  sampleVectorPaintDefAt,
   sanitizeVectorEffects,
+  sanitizeVectorGradient,
   sanitizeWidthProfile,
   scaleFor,
   scaleMatrix,
   setAnchorCorner,
   setSubpathCorners,
+  setVectorGradientVector,
   setWidthPoint,
   simplifyPolyline,
   smoothSubpath,
+  sortedVectorGradientStops,
+  spanVectorGradientStops,
   splitIntoFaces,
   splitSubpathAt,
   starSubpath,
@@ -11454,7 +13050,9 @@ export {
   toVectorModifiers,
   toVectorPointerInput,
   transformVectorEffects,
+  transformVectorGradient,
   transformVectorNode,
+  transformVectorPaint,
   translateAnchor,
   translateMatrix,
   trimIntervals,
@@ -11475,6 +13073,7 @@ export {
   vectorBlendRailAt,
   vectorBlendSpine,
   vectorBlendStepCount,
+  vectorBoxMatrix,
   vectorBuilderErasedEdges,
   vectorCornerAt,
   vectorCorners,
@@ -11483,6 +13082,22 @@ export {
   vectorDocumentToSvg,
   vectorEnteredGroups,
   vectorFillMap,
+  vectorGradientArea,
+  vectorGradientAspect,
+  vectorGradientBarPosition,
+  vectorGradientFocalParam,
+  vectorGradientHandles,
+  vectorGradientMatrix,
+  vectorGradientMidpointFromPosition,
+  vectorGradientMidpointPosition,
+  vectorGradientNeedsExpansion,
+  vectorGradientParam,
+  vectorGradientPoints,
+  vectorGradientRamp,
+  vectorGradientSvgDefs,
+  vectorGradientTAt,
+  vectorGradientTargetPath,
+  vectorGradientUnitsMatrix,
   vectorInkShapeName,
   vectorLiveBooleanSteps,
   vectorNodeBounds,
@@ -11494,6 +13109,7 @@ export {
   vectorParentMatrix,
   vectorPathData,
   vectorPathEntries,
+  vectorPathLocalBounds,
   vectorPathWorldBezier,
   vectorPathfinderShape,
   vectorRepeaterCopies,
@@ -11501,6 +13117,7 @@ export {
   vectorResultStyle,
   vectorShapeBuilderHit,
   vectorShapeBuilderMap,
+  vectorStrokeGradientDefs,
   vectorStrokeLineArea,
   vectorStrokeOutline,
   vectorStrokeOutlinePath,