openfig-core 0.3.2 → 0.3.5

package/dist/index.cjs

@@ -20,13 +20,30 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  appendVectorPayloadToDocument: () => appendVectorPayloadToDocument,
   assembleCanvasFig: () => assembleCanvasFig,
   createEmptyFigDoc: () => createEmptyFigDoc,
   createFigZip: () => createFigZip,
+  cssColorToFigColor: () => cssColorToFigColor,
+  encodeCommandsBlob: () => encodeCommandsBlob,
   encodeFigParts: () => encodeFigParts,
+  encodeVectorNetworkBlob: () => encodeVectorNetworkBlob,
+  extractRenderableGradientFill: () => extractRenderableGradientFill,
+  geometryBlobToSVGPath: () => geometryBlobToSVGPath,
+  getBlobBytes: () => getBlobBytes,
+  hexToFigColor: () => hexToFigColor,
+  makeSolidPaint: () => makeSolidPaint,
+  mapStrokeCap: () => mapStrokeCap,
+  mapStrokeJoin: () => mapStrokeJoin,
   nodeId: () => nodeId,
+  parseCssRgbColor: () => parseCssRgbColor,
   parseFig: () => parseFig,
-  parseFigBinary: () => parseFigBinary
+  parseFigBinary: () => parseFigBinary,
+  parseSVGPathData: () => parseSVGPathData,
+  resolveGradientGeometry: () => resolveGradientGeometry,
+  resolveVectorNodePaths: () => resolveVectorNodePaths,
+  serializeSvgPathData: () => serializeSvgPathData,
+  transformSvgPathData: () => transformSvgPathData
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -204,14 +221,806 @@ function createEmptyFigDoc() {
   const bytes = b64decode(emptyFigTemplate);
   return parseFig(bytes);
 }
+
+// src/gradient.ts
+var IDENTITY_TRANSFORM = {
+  m00: 1,
+  m01: 0,
+  m02: 0,
+  m10: 0,
+  m11: 1,
+  m12: 0
+};
+function cloneTransform(transform) {
+  if (!transform) return { ...IDENTITY_TRANSFORM };
+  return {
+    m00: transform.m00,
+    m01: transform.m01,
+    m02: transform.m02,
+    m10: transform.m10,
+    m11: transform.m11,
+    m12: transform.m12
+  };
+}
+function isRenderableGradientPaint(paint) {
+  return !!paint && paint.visible !== false && (paint.type === "GRADIENT_LINEAR" || paint.type === "GRADIENT_RADIAL") && Array.isArray(paint.stops) && paint.stops.length > 0;
+}
+function extractRenderableGradientFill(paints) {
+  const paint = paints?.find((entry) => isRenderableGradientPaint(entry));
+  if (!paint) return null;
+  return {
+    type: paint.type === "GRADIENT_LINEAR" ? "linear" : "radial",
+    opacity: paint.opacity ?? 1,
+    transform: cloneTransform(paint.transform),
+    stops: [...paint.stops].sort((a, b) => a.position - b.position).map((stop) => ({
+      position: stop.position,
+      color: { ...stop.color },
+      colorVar: stop.colorVar
+    }))
+  };
+}
+function resolveGradientGeometry(fill, width, height) {
+  if (width <= 0 || height <= 0) return null;
+  const transform = fill.transform ?? IDENTITY_TRANSFORM;
+  const { m00, m01, m02, m10, m11, m12 } = transform;
+  const det = m00 * m11 - m10 * m01;
+  if (Math.abs(det) < 1e-12) return null;
+  const ia = m11 / det;
+  const ic = -m01 / det;
+  const ie = (m01 * m12 - m11 * m02) / det;
+  const ib = -m10 / det;
+  const iid = m00 / det;
+  const iif = (m10 * m02 - m00 * m12) / det;
+  const point = (gx, gy) => ({
+    x: (ia * gx + ic * gy + ie) * width,
+    y: (ib * gx + iid * gy + iif) * height
+  });
+  if (fill.type === "linear") {
+    return {
+      type: "linear",
+      start: point(0, 0.5),
+      end: point(1, 0.5)
+    };
+  }
+  const center = point(0.5, 0.5);
+  const xAxisPoint = point(1, 0.5);
+  const yAxisPoint = point(0.5, 1);
+  return {
+    type: "radial",
+    center,
+    radiusX: Math.hypot(xAxisPoint.x - center.x, xAxisPoint.y - center.y),
+    radiusY: Math.hypot(yAxisPoint.x - center.x, yAxisPoint.y - center.y),
+    angle: Math.atan2(xAxisPoint.y - center.y, xAxisPoint.x - center.x)
+  };
+}
+
+// src/vector.ts
+var CMD_CLOSE = 0;
+var CMD_MOVE_TO = 1;
+var CMD_LINE_TO = 2;
+var CMD_CUBIC_TO = 4;
+var SEGMENT_LINE = 0;
+var SEGMENT_CUBIC = 4;
+var DEFAULT_HANDLE_MIRRORING = 4;
+function quadraticToCubic(x0, y0, qx, qy, x, y) {
+  return {
+    type: "C",
+    c1x: x0 + 2 / 3 * (qx - x0),
+    c1y: y0 + 2 / 3 * (qy - y0),
+    c2x: x + 2 / 3 * (qx - x),
+    c2y: y + 2 / 3 * (qy - y),
+    x,
+    y
+  };
+}
+function roundPathNumber(n, decimals = 2) {
+  const factor = 10 ** decimals;
+  return Math.round(n * factor) / factor;
+}
+function getBlobBytes(doc, blobIndex) {
+  if (blobIndex == null || blobIndex < 0) return null;
+  const blob = doc.message?.blobs?.[blobIndex];
+  if (!blob) return null;
+  if (blob instanceof Uint8Array) return blob;
+  if (blob.bytes instanceof Uint8Array) return blob.bytes;
+  if (Array.isArray(blob.bytes)) return Uint8Array.from(blob.bytes);
+  if (blob.bytes && typeof blob.bytes === "object") {
+    const values = Object.values(blob.bytes);
+    if (values.every((value) => typeof value === "number")) {
+      return Uint8Array.from(values);
+    }
+  }
+  return null;
+}
+function geometryBlobToSVGPath(blob) {
+  if (!blob.length) return "";
+  const view = new DataView(blob.buffer, blob.byteOffset, blob.byteLength);
+  let offset = 0;
+  const parts = [];
+  const canRead = (byteLength) => offset + byteLength <= blob.length;
+  while (offset < blob.length) {
+    const cmd = blob[offset++];
+    switch (cmd) {
+      case CMD_CLOSE:
+        parts.push("Z");
+        break;
+      case CMD_MOVE_TO: {
+        if (!canRead(8)) return parts.join("");
+        const x = roundPathNumber(view.getFloat32(offset, true));
+        const y = roundPathNumber(view.getFloat32(offset + 4, true));
+        offset += 8;
+        parts.push(`M${x} ${y}`);
+        break;
+      }
+      case CMD_LINE_TO: {
+        if (!canRead(8)) return parts.join("");
+        const x = roundPathNumber(view.getFloat32(offset, true));
+        const y = roundPathNumber(view.getFloat32(offset + 4, true));
+        offset += 8;
+        parts.push(`L${x} ${y}`);
+        break;
+      }
+      case CMD_CUBIC_TO: {
+        if (!canRead(24)) return parts.join("");
+        const x1 = roundPathNumber(view.getFloat32(offset, true));
+        const y1 = roundPathNumber(view.getFloat32(offset + 4, true));
+        const x2 = roundPathNumber(view.getFloat32(offset + 8, true));
+        const y2 = roundPathNumber(view.getFloat32(offset + 12, true));
+        const x = roundPathNumber(view.getFloat32(offset + 16, true));
+        const y = roundPathNumber(view.getFloat32(offset + 20, true));
+        offset += 24;
+        parts.push(`C${x1} ${y1} ${x2} ${y2} ${x} ${y}`);
+        break;
+      }
+      default:
+        return parts.join("");
+    }
+  }
+  return parts.join("");
+}
+function parseSVGPathData(svgPath) {
+  const tokens = [];
+  const re = /([MmLlCcSsQqTtHhVvZz])|([+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?)/g;
+  let match;
+  while ((match = re.exec(svgPath)) !== null) {
+    if (match[1]) tokens.push(match[1]);
+    else tokens.push(Number.parseFloat(match[2]));
+  }
+  const commands = [];
+  let i = 0;
+  let cx = 0;
+  let cy = 0;
+  let startX = 0;
+  let startY = 0;
+  let prevC2x = 0;
+  let prevC2y = 0;
+  let prevQuadraticX = 0;
+  let prevQuadraticY = 0;
+  let cmd = "";
+  const num = () => {
+    const value = tokens[i++];
+    if (typeof value !== "number" || Number.isNaN(value)) {
+      throw new Error(`Invalid SVG path data near token index ${i - 1}`);
+    }
+    return value;
+  };
+  while (i < tokens.length) {
+    if (typeof tokens[i] === "string") cmd = tokens[i++];
+    switch (cmd) {
+      case "M":
+        cx = num();
+        cy = num();
+        startX = cx;
+        startY = cy;
+        commands.push({ type: "M", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        cmd = "L";
+        break;
+      case "m":
+        cx += num();
+        cy += num();
+        startX = cx;
+        startY = cy;
+        commands.push({ type: "M", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        cmd = "l";
+        break;
+      case "L":
+        cx = num();
+        cy = num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "l":
+        cx += num();
+        cy += num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "H":
+        cx = num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "h":
+        cx += num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "V":
+        cy = num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "v":
+        cy += num();
+        commands.push({ type: "L", x: cx, y: cy });
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "C": {
+        const c1x = num();
+        const c1y = num();
+        const c2x = num();
+        const c2y = num();
+        cx = num();
+        cy = num();
+        prevC2x = c2x;
+        prevC2y = c2y;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        commands.push({ type: "C", c1x, c1y, c2x, c2y, x: cx, y: cy });
+        break;
+      }
+      case "c": {
+        const c1x = cx + num();
+        const c1y = cy + num();
+        const c2x = cx + num();
+        const c2y = cy + num();
+        cx += num();
+        cy += num();
+        prevC2x = c2x;
+        prevC2y = c2y;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        commands.push({ type: "C", c1x, c1y, c2x, c2y, x: cx, y: cy });
+        break;
+      }
+      case "S": {
+        const c1x = 2 * cx - prevC2x;
+        const c1y = 2 * cy - prevC2y;
+        const c2x = num();
+        const c2y = num();
+        cx = num();
+        cy = num();
+        prevC2x = c2x;
+        prevC2y = c2y;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        commands.push({ type: "C", c1x, c1y, c2x, c2y, x: cx, y: cy });
+        break;
+      }
+      case "s": {
+        const c1x = 2 * cx - prevC2x;
+        const c1y = 2 * cy - prevC2y;
+        const c2x = cx + num();
+        const c2y = cy + num();
+        cx += num();
+        cy += num();
+        prevC2x = c2x;
+        prevC2y = c2y;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        commands.push({ type: "C", c1x, c1y, c2x, c2y, x: cx, y: cy });
+        break;
+      }
+      case "Q": {
+        const qx = num();
+        const qy = num();
+        const x = num();
+        const y = num();
+        const cubic = quadraticToCubic(cx, cy, qx, qy, x, y);
+        commands.push(cubic);
+        prevQuadraticX = qx;
+        prevQuadraticY = qy;
+        prevC2x = cubic.c2x;
+        prevC2y = cubic.c2y;
+        cx = x;
+        cy = y;
+        break;
+      }
+      case "q": {
+        const qx = cx + num();
+        const qy = cy + num();
+        const x = cx + num();
+        const y = cy + num();
+        const cubic = quadraticToCubic(cx, cy, qx, qy, x, y);
+        commands.push(cubic);
+        prevQuadraticX = qx;
+        prevQuadraticY = qy;
+        prevC2x = cubic.c2x;
+        prevC2y = cubic.c2y;
+        cx = x;
+        cy = y;
+        break;
+      }
+      case "T": {
+        const qx = 2 * cx - prevQuadraticX;
+        const qy = 2 * cy - prevQuadraticY;
+        const x = num();
+        const y = num();
+        const cubic = quadraticToCubic(cx, cy, qx, qy, x, y);
+        commands.push(cubic);
+        prevQuadraticX = qx;
+        prevQuadraticY = qy;
+        prevC2x = cubic.c2x;
+        prevC2y = cubic.c2y;
+        cx = x;
+        cy = y;
+        break;
+      }
+      case "t": {
+        const qx = 2 * cx - prevQuadraticX;
+        const qy = 2 * cy - prevQuadraticY;
+        const x = cx + num();
+        const y = cy + num();
+        const cubic = quadraticToCubic(cx, cy, qx, qy, x, y);
+        commands.push(cubic);
+        prevQuadraticX = qx;
+        prevQuadraticY = qy;
+        prevC2x = cubic.c2x;
+        prevC2y = cubic.c2y;
+        cx = x;
+        cy = y;
+        break;
+      }
+      case "Z":
+      case "z":
+        commands.push({ type: "Z" });
+        cx = startX;
+        cy = startY;
+        prevC2x = cx;
+        prevC2y = cy;
+        prevQuadraticX = cx;
+        prevQuadraticY = cy;
+        break;
+      case "":
+        i++;
+        break;
+      default:
+        throw new Error(`Unsupported SVG path command: ${cmd}`);
+    }
+  }
+  return commands;
+}
+function encodeCommandsBlob(commands, scaleX = 1, scaleY = 1) {
+  let byteLength = 0;
+  for (const command of commands) {
+    byteLength += 1;
+    if (command.type === "M" || command.type === "L") byteLength += 8;
+    else if (command.type === "C") byteLength += 24;
+  }
+  const buffer = new ArrayBuffer(byteLength);
+  const view = new DataView(buffer);
+  let offset = 0;
+  for (const command of commands) {
+    switch (command.type) {
+      case "M":
+        view.setUint8(offset++, CMD_MOVE_TO);
+        view.setFloat32(offset, command.x * scaleX, true);
+        offset += 4;
+        view.setFloat32(offset, command.y * scaleY, true);
+        offset += 4;
+        break;
+      case "L":
+        view.setUint8(offset++, CMD_LINE_TO);
+        view.setFloat32(offset, command.x * scaleX, true);
+        offset += 4;
+        view.setFloat32(offset, command.y * scaleY, true);
+        offset += 4;
+        break;
+      case "C":
+        view.setUint8(offset++, CMD_CUBIC_TO);
+        view.setFloat32(offset, command.c1x * scaleX, true);
+        offset += 4;
+        view.setFloat32(offset, command.c1y * scaleY, true);
+        offset += 4;
+        view.setFloat32(offset, command.c2x * scaleX, true);
+        offset += 4;
+        view.setFloat32(offset, command.c2y * scaleY, true);
+        offset += 4;
+        view.setFloat32(offset, command.x * scaleX, true);
+        offset += 4;
+        view.setFloat32(offset, command.y * scaleY, true);
+        offset += 4;
+        break;
+      case "Z":
+        view.setUint8(offset++, CMD_CLOSE);
+        break;
+    }
+  }
+  return new Uint8Array(buffer, 0, offset);
+}
+function encodeVectorNetworkBlob(pathCommandsList) {
+  const vertices = [];
+  const segments = [];
+  const regions = [];
+  for (const pathCommands of pathCommandsList) {
+    let regionSegments = [];
+    let firstVertex = -1;
+    let prevVertex = -1;
+    let prevX = 0;
+    let prevY = 0;
+    for (const command of pathCommands) {
+      if (command.type === "M") {
+        if (regionSegments.length > 0) {
+          regions.push(regionSegments);
+          regionSegments = [];
+        }
+        const vertexIndex = vertices.length;
+        vertices.push({ x: command.x, y: command.y });
+        firstVertex = vertexIndex;
+        prevVertex = vertexIndex;
+        prevX = command.x;
+        prevY = command.y;
+      } else if (command.type === "L") {
+        const vertexIndex = vertices.length;
+        vertices.push({ x: command.x, y: command.y });
+        if (prevVertex >= 0) {
+          regionSegments.push(segments.length);
+          segments.push({ s: prevVertex, tsx: 0, tsy: 0, e: vertexIndex, tex: 0, tey: 0, t: SEGMENT_LINE });
+        }
+        prevVertex = vertexIndex;
+        prevX = command.x;
+        prevY = command.y;
+      } else if (command.type === "C") {
+        const vertexIndex = vertices.length;
+        vertices.push({ x: command.x, y: command.y });
+        if (prevVertex >= 0) {
+          regionSegments.push(segments.length);
+          segments.push({
+            s: prevVertex,
+            tsx: command.c1x - prevX,
+            tsy: command.c1y - prevY,
+            e: vertexIndex,
+            tex: command.c2x - command.x,
+            tey: command.c2y - command.y,
+            t: SEGMENT_CUBIC
+          });
+        }
+        prevVertex = vertexIndex;
+        prevX = command.x;
+        prevY = command.y;
+      } else if (command.type === "Z") {
+        if (prevVertex >= 0 && prevVertex !== firstVertex) {
+          const lastPos = vertices[prevVertex];
+          const firstPos = vertices[firstVertex];
+          const dx = lastPos.x - firstPos.x;
+          const dy = lastPos.y - firstPos.y;
+          if (dx * dx + dy * dy < 1e-4) {
+            const lastSeg = segments[segments.length - 1];
+            if (lastSeg && lastSeg.e === prevVertex) {
+              lastSeg.e = firstVertex;
+              vertices.pop();
+            }
+          } else {
+            regionSegments.push(segments.length);
+            segments.push({ s: prevVertex, tsx: 0, tsy: 0, e: firstVertex, tex: 0, tey: 0, t: SEGMENT_LINE });
+          }
+        }
+        if (firstVertex >= 0) {
+          prevVertex = firstVertex;
+          prevX = vertices[firstVertex].x;
+          prevY = vertices[firstVertex].y;
+        }
+      }
+    }
+    regions.push(regionSegments);
+  }
+  let regionsByteLength = 0;
+  for (const region of regions) regionsByteLength += 4 + 4 + region.length * 4 + 4;
+  const totalByteLength = 16 + vertices.length * 12 + segments.length * 28 + regionsByteLength;
+  const buffer = new ArrayBuffer(totalByteLength);
+  const view = new DataView(buffer);
+  let offset = 0;
+  view.setUint32(offset, vertices.length, true);
+  offset += 4;
+  view.setUint32(offset, segments.length, true);
+  offset += 4;
+  view.setUint32(offset, regions.length, true);
+  offset += 4;
+  view.setUint32(offset, 1, true);
+  offset += 4;
+  for (const vertex of vertices) {
+    view.setFloat32(offset, vertex.x, true);
+    offset += 4;
+    view.setFloat32(offset, vertex.y, true);
+    offset += 4;
+    view.setUint32(offset, DEFAULT_HANDLE_MIRRORING, true);
+    offset += 4;
+  }
+  for (const segment of segments) {
+    view.setUint32(offset, segment.s, true);
+    offset += 4;
+    view.setFloat32(offset, segment.tsx, true);
+    offset += 4;
+    view.setFloat32(offset, segment.tsy, true);
+    offset += 4;
+    view.setUint32(offset, segment.e, true);
+    offset += 4;
+    view.setFloat32(offset, segment.tex, true);
+    offset += 4;
+    view.setFloat32(offset, segment.tey, true);
+    offset += 4;
+    view.setUint32(offset, segment.t, true);
+    offset += 4;
+  }
+  for (const region of regions) {
+    view.setUint32(offset, 1, true);
+    offset += 4;
+    view.setUint32(offset, region.length, true);
+    offset += 4;
+    for (const segmentIndex of region) {
+      view.setUint32(offset, segmentIndex, true);
+      offset += 4;
+    }
+    view.setUint32(offset, 1, true);
+    offset += 4;
+  }
+  return new Uint8Array(buffer, 0, offset);
+}
+function cloneStyleOverrides(styleOverrideTable) {
+  if (!styleOverrideTable?.length) return void 0;
+  return JSON.parse(JSON.stringify(styleOverrideTable));
+}
+function toCommands(input) {
+  if (Array.isArray(input.commands) && input.commands.length > 0) {
+    return input.commands.map((command) => ({ ...command }));
+  }
+  if (input.svgPath) return parseSVGPathData(input.svgPath);
+  throw new Error("Vector geometry input requires either svgPath or commands");
+}
+function appendVectorPayloadToDocument(doc, input) {
+  const blobs = doc.message?.blobs ?? (doc.message.blobs = []);
+  const normalizedWidth = input.normalizedWidth ?? input.width;
+  const normalizedHeight = input.normalizedHeight ?? input.height;
+  const scaleX = normalizedWidth === 0 ? 1 : input.width / normalizedWidth;
+  const scaleY = normalizedHeight === 0 ? 1 : input.height / normalizedHeight;
+  const fillPaths = (input.fillPaths ?? []).map(toCommands);
+  const strokePaths = (input.strokePaths ?? []).map(toCommands);
+  if (fillPaths.length === 0 && strokePaths.length === 0) {
+    throw new Error("Vector payload requires at least one fill or stroke path");
+  }
+  const fillGeometry = [];
+  for (let i = 0; i < fillPaths.length; i++) {
+    const bytes = encodeCommandsBlob(fillPaths[i], scaleX, scaleY);
+    blobs.push({ bytes });
+    const path = input.fillPaths?.[i];
+    fillGeometry.push({
+      windingRule: path?.windingRule ?? "NONZERO",
+      commandsBlob: blobs.length - 1,
+      styleID: path?.styleID ?? 0
+    });
+  }
+  const strokeGeometry = [];
+  for (let i = 0; i < strokePaths.length; i++) {
+    const bytes = encodeCommandsBlob(strokePaths[i], scaleX, scaleY);
+    blobs.push({ bytes });
+    const path = input.strokePaths?.[i];
+    strokeGeometry.push({
+      windingRule: path?.windingRule ?? "NONZERO",
+      commandsBlob: blobs.length - 1,
+      styleID: path?.styleID ?? 0
+    });
+  }
+  const vectorNetworkBlob = encodeVectorNetworkBlob([...fillPaths, ...strokePaths]);
+  blobs.push({ bytes: vectorNetworkBlob });
+  return {
+    fillGeometry,
+    strokeGeometry,
+    vectorData: {
+      vectorNetworkBlob: blobs.length - 1,
+      normalizedSize: { x: normalizedWidth, y: normalizedHeight },
+      ...cloneStyleOverrides(input.styleOverrideTable)?.length ? { styleOverrideTable: cloneStyleOverrides(input.styleOverrideTable) } : {}
+    }
+  };
+}
+function getStyleOverrideTable(node) {
+  const table = node.vectorData?.styleOverrideTable;
+  return Array.isArray(table) ? table : [];
+}
+function resolveFillPaints(node, styleID) {
+  if (!styleID) return node.fillPaints;
+  const override = getStyleOverrideTable(node).find((entry) => entry?.styleID === styleID);
+  if (!override || !("fillPaints" in override)) return node.fillPaints;
+  return override.fillPaints;
+}
+function resolveGeometry(doc, node, geometry, kind) {
+  if (!Array.isArray(geometry) || geometry.length === 0) return [];
+  const resolved = geometry.map((entry) => {
+    if (typeof entry?.commandsBlob !== "number") return null;
+    const bytes = getBlobBytes(doc, entry.commandsBlob);
+    if (!bytes) return null;
+    const svgPath = geometryBlobToSVGPath(bytes);
+    if (!svgPath) return null;
+    const path = {
+      blobIndex: entry.commandsBlob,
+      commandsBlob: bytes,
+      svgPath,
+      windingRule: entry.windingRule,
+      styleID: entry.styleID || 0,
+      paints: kind === "fill" ? resolveFillPaints(node, entry.styleID || 0) : node.strokePaints
+    };
+    return path;
+  });
+  return resolved.filter((entry) => entry !== null);
+}
+function resolveVectorNodePaths(doc, node) {
+  return {
+    fill: resolveGeometry(doc, node, node.fillGeometry, "fill"),
+    stroke: resolveGeometry(doc, node, node.strokeGeometry, "stroke")
+  };
+}
+
+// src/color.ts
+function hexToFigColor(hex) {
+  if (!hex || hex === "transparent") return { r: 0, g: 0, b: 0, a: 0 };
+  const h = hex.replace("#", "");
+  const r = parseInt(h.substring(0, 2), 16) / 255;
+  const g = parseInt(h.substring(2, 4), 16) / 255;
+  const b = parseInt(h.substring(4, 6), 16) / 255;
+  const a = h.length >= 8 ? parseInt(h.substring(6, 8), 16) / 255 : 1;
+  return { r, g, b, a };
+}
+function parseCssRgbColor(value) {
+  const match = value.trim().match(/^rgba?\((.+)\)$/i);
+  if (!match) return null;
+  const parts = match[1].split(",").map((part) => part.trim());
+  if (parts.length < 3) return null;
+  const r = Number.parseFloat(parts[0]);
+  const g = Number.parseFloat(parts[1]);
+  const b = Number.parseFloat(parts[2]);
+  const a = parts.length >= 4 ? Number.parseFloat(parts[3]) : 1;
+  if ([r, g, b, a].some((n) => Number.isNaN(n))) return null;
+  return { r: r / 255, g: g / 255, b: b / 255, a };
+}
+function cssColorToFigColor(value, resolveNamed) {
+  const trimmed = value.trim();
+  if (trimmed === "transparent" || trimmed === "none") return { r: 0, g: 0, b: 0, a: 0 };
+  if (trimmed.startsWith("#")) return hexToFigColor(trimmed);
+  const rgba = parseCssRgbColor(trimmed);
+  if (rgba) return rgba;
+  if (resolveNamed) {
+    const resolved = resolveNamed(trimmed);
+    if (resolved) return resolved;
+  }
+  throw new Error(`Unsupported CSS color: ${value}`);
+}
+function makeSolidPaint(fill, resolveNamed) {
+  const color = cssColorToFigColor(fill, resolveNamed);
+  return {
+    type: "SOLID",
+    color: { r: color.r, g: color.g, b: color.b, a: 1 },
+    opacity: color.a,
+    visible: true,
+    blendMode: "NORMAL"
+  };
+}
+
+// src/svgPath.ts
+function serializeSvgPathData(commands) {
+  return commands.map((command) => {
+    switch (command.type) {
+      case "M":
+        return `M${command.x} ${command.y}`;
+      case "L":
+        return `L${command.x} ${command.y}`;
+      case "C":
+        return `C${command.c1x} ${command.c1y} ${command.c2x} ${command.c2y} ${command.x} ${command.y}`;
+      case "Z":
+        return "Z";
+    }
+  }).join(" ");
+}
+function transformSvgPathData(svgPath, {
+  scaleX = 1,
+  scaleY = 1,
+  translateX = 0,
+  translateY = 0
+}) {
+  const commands = parseSVGPathData(svgPath).map((command) => {
+    switch (command.type) {
+      case "M":
+      case "L":
+        return {
+          ...command,
+          x: command.x * scaleX + translateX,
+          y: command.y * scaleY + translateY
+        };
+      case "C":
+        return {
+          ...command,
+          c1x: command.c1x * scaleX + translateX,
+          c1y: command.c1y * scaleY + translateY,
+          c2x: command.c2x * scaleX + translateX,
+          c2y: command.c2y * scaleY + translateY,
+          x: command.x * scaleX + translateX,
+          y: command.y * scaleY + translateY
+        };
+      case "Z":
+        return command;
+    }
+  });
+  return serializeSvgPathData(commands);
+}
+function mapStrokeJoin(value) {
+  switch ((value || "").toLowerCase()) {
+    case "round":
+      return "ROUND";
+    case "bevel":
+      return "BEVEL";
+    default:
+      return "MITER";
+  }
+}
+function mapStrokeCap(value) {
+  switch ((value || "").toLowerCase()) {
+    case "round":
+      return "ROUND";
+    case "square":
+      return "SQUARE";
+    default:
+      return "NONE";
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  appendVectorPayloadToDocument,
   assembleCanvasFig,
   createEmptyFigDoc,
   createFigZip,
+  cssColorToFigColor,
+  encodeCommandsBlob,
   encodeFigParts,
+  encodeVectorNetworkBlob,
+  extractRenderableGradientFill,
+  geometryBlobToSVGPath,
+  getBlobBytes,
+  hexToFigColor,
+  makeSolidPaint,
+  mapStrokeCap,
+  mapStrokeJoin,
   nodeId,
+  parseCssRgbColor,
   parseFig,
-  parseFigBinary
+  parseFigBinary,
+  parseSVGPathData,
+  resolveGradientGeometry,
+  resolveVectorNodePaths,
+  serializeSvgPathData,
+  transformSvgPathData
 });
 //# sourceMappingURL=index.cjs.map