openfig-core 0.2.0

package/dist/index.cjs

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  nodeId: () => nodeId,
+  parseFig: () => parseFig,
+  parseFigBinary: () => parseFigBinary
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/parser.ts
+var import_fflate = require("fflate");
+var import_kiwi_schema = require("kiwi-schema");
+var import_fzstd = require("fzstd");
+
+// src/utils.ts
+function nodeId(node) {
+  if (!node?.guid) return null;
+  return `${node.guid.sessionID}:${node.guid.localID}`;
+}
+
+// src/parser.ts
+function parseFigBinary(data) {
+  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+  const prelude = String.fromCharCode(...data.subarray(0, 8));
+  if (!prelude.startsWith("fig-")) {
+    throw new Error(`Unknown prelude: ${prelude}`);
+  }
+  const version = view.getUint32(8, true);
+  const chunks = [];
+  let off = 12;
+  while (off < data.byteLength) {
+    const len = view.getUint32(off, true);
+    off += 4;
+    chunks.push(data.subarray(off, off + len));
+    off += len;
+  }
+  if (chunks.length < 2) {
+    throw new Error("Expected at least 2 chunks in .fig binary");
+  }
+  const schemaData = (0, import_fflate.inflateSync)(chunks[0]);
+  const schema = (0, import_kiwi_schema.decodeBinarySchema)(schemaData);
+  const compiled = (0, import_kiwi_schema.compileSchema)(schema);
+  let msgData;
+  const c1 = chunks[1];
+  if (c1[0] === 40 && c1[1] === 181 && c1[2] === 47 && c1[3] === 253) {
+    msgData = (0, import_fzstd.decompress)(c1);
+  } else {
+    msgData = (0, import_fflate.inflateSync)(c1);
+  }
+  const message = compiled.decodeMessage(msgData);
+  const nodes = message.nodeChanges;
+  const nodeMap = /* @__PURE__ */ new Map();
+  const childrenMap = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const id = nodeId(node);
+    if (id) nodeMap.set(id, node);
+  }
+  for (const node of nodes) {
+    if (!node.parentIndex?.guid) continue;
+    const pid = `${node.parentIndex.guid.sessionID}:${node.parentIndex.guid.localID}`;
+    if (!childrenMap.has(pid)) childrenMap.set(pid, []);
+    childrenMap.get(pid).push(node);
+  }
+  return {
+    header: { prelude: prelude.trim(), version },
+    nodes,
+    nodeMap,
+    childrenMap,
+    schema,
+    compiledSchema: compiled,
+    rawChunks: chunks,
+    message,
+    images: /* @__PURE__ */ new Map()
+  };
+}
+function parseFig(data) {
+  if (data[0] !== 80 || data[1] !== 75) {
+    throw new Error("Not a valid .fig file (missing ZIP header)");
+  }
+  const unzipped = (0, import_fflate.unzipSync)(data);
+  const canvasKey = Object.keys(unzipped).find((k) => k.endsWith("canvas.fig"));
+  if (!canvasKey) {
+    throw new Error("No canvas.fig found in .fig archive");
+  }
+  const doc = parseFigBinary(unzipped[canvasKey]);
+  const metaKey = Object.keys(unzipped).find((k) => k.endsWith("meta.json"));
+  if (metaKey) {
+    try {
+      doc.meta = JSON.parse(new TextDecoder().decode(unzipped[metaKey]));
+    } catch {
+    }
+  }
+  const thumbKey = Object.keys(unzipped).find((k) => k.endsWith("thumbnail.png"));
+  if (thumbKey) {
+    doc.thumbnail = unzipped[thumbKey];
+  }
+  for (const key of Object.keys(unzipped)) {
+    if (key.includes("images/") && key !== "images/") {
+      const filename = key.split("/").pop();
+      doc.images.set(filename, unzipped[key]);
+    }
+  }
+  return doc;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  nodeId,
+  parseFig,
+  parseFigBinary
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/parser.ts","../src/utils.ts"],"sourcesContent":["export { parseFig, parseFigBinary } from \"./parser.js\";\nexport { nodeId } from \"./utils.js\";\nexport type { FigDocument, FigNode, FigPaint, FigGuid } from \"./types.js\";\n","/**\n * Isomorphic .fig binary parser.\n *\n * .fig files are ZIP archives containing:\n *   - canvas.fig (binary: prelude + version + kiwi-encoded chunks)\n *   - meta.json (optional)\n *   - thumbnail.png (optional)\n *   - images/ (optional)\n *\n * Parsing flow:\n *   1. Unzip → extract canvas.fig\n *   2. Read 8-byte prelude + 4-byte version\n *   3. Chunk 0: deflateRaw → kiwi binary schema\n *   4. Chunk 1: zstd or deflateRaw → kiwi message (nodeChanges[])\n *   5. Build node maps\n */\n\nimport { unzipSync, inflateSync } from \"fflate\";\nimport { decodeBinarySchema, compileSchema } from \"kiwi-schema\";\nimport { decompress as zstdDecompress } from \"fzstd\";\nimport type { FigDocument, FigNode } from \"./types.js\";\nimport { nodeId } from \"./utils.js\";\n\n/**\n * Parse raw canvas.fig binary data (the blob inside the ZIP).\n * Use this if you extract the ZIP yourself.\n */\nexport function parseFigBinary(data: Uint8Array): FigDocument {\n  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n\n  // Read 8-byte prelude + 4-byte version\n  const prelude = String.fromCharCode(...data.subarray(0, 8));\n  if (!prelude.startsWith(\"fig-\")) {\n    throw new Error(`Unknown prelude: ${prelude}`);\n  }\n  const version = view.getUint32(8, true);\n\n  // Read length-prefixed chunks\n  const chunks: Uint8Array[] = [];\n  let off = 12;\n  while (off < data.byteLength) {\n    const len = view.getUint32(off, true);\n    off += 4;\n    chunks.push(data.subarray(off, off + len));\n    off += len;\n  }\n\n  if (chunks.length < 2) {\n    throw new Error(\"Expected at least 2 chunks in .fig binary\");\n  }\n\n  // Chunk 0: kiwi schema (deflateRaw compressed)\n  const schemaData = inflateSync(chunks[0]);\n  const schema = decodeBinarySchema(schemaData);\n  const compiled = compileSchema(schema);\n\n  // Chunk 1: message (zstd or deflateRaw — auto-detect by magic bytes)\n  let msgData: Uint8Array;\n  const c1 = chunks[1];\n  if (c1[0] === 0x28 && c1[1] === 0xb5 && c1[2] === 0x2f && c1[3] === 0xfd) {\n    msgData = zstdDecompress(c1);\n  } else {\n    msgData = inflateSync(c1);\n  }\n  const message = compiled.decodeMessage(msgData);\n\n  // Build maps\n  const nodes: FigNode[] = message.nodeChanges;\n  const nodeMap = new Map<string, FigNode>();\n  const childrenMap = new Map<string, FigNode[]>();\n\n  for (const node of nodes) {\n    const id = nodeId(node);\n    if (id) nodeMap.set(id, node);\n  }\n\n  for (const node of nodes) {\n    if (!node.parentIndex?.guid) continue;\n    const pid = `${node.parentIndex.guid.sessionID}:${node.parentIndex.guid.localID}`;\n    if (!childrenMap.has(pid)) childrenMap.set(pid, []);\n    childrenMap.get(pid)!.push(node);\n  }\n\n  return {\n    header: { prelude: prelude.trim(), version },\n    nodes,\n    nodeMap,\n    childrenMap,\n    schema,\n    compiledSchema: compiled,\n    rawChunks: chunks,\n    message,\n    images: new Map(),\n  };\n}\n\n/**\n * Parse a complete .fig file (ZIP archive).\n * Extracts canvas.fig, meta.json, thumbnail.png, and images/*.\n */\nexport function parseFig(data: Uint8Array): FigDocument {\n  // Check ZIP header\n  if (data[0] !== 0x50 || data[1] !== 0x4b) {\n    throw new Error(\"Not a valid .fig file (missing ZIP header)\");\n  }\n\n  const unzipped = unzipSync(data);\n\n  // Find and parse canvas.fig\n  const canvasKey = Object.keys(unzipped).find((k) => k.endsWith(\"canvas.fig\"));\n  if (!canvasKey) {\n    throw new Error(\"No canvas.fig found in .fig archive\");\n  }\n  const doc = parseFigBinary(unzipped[canvasKey]);\n\n  // Extract meta.json\n  const metaKey = Object.keys(unzipped).find((k) => k.endsWith(\"meta.json\"));\n  if (metaKey) {\n    try {\n      doc.meta = JSON.parse(new TextDecoder().decode(unzipped[metaKey]));\n    } catch { /* ignore malformed meta */ }\n  }\n\n  // Extract thumbnail\n  const thumbKey = Object.keys(unzipped).find((k) => k.endsWith(\"thumbnail.png\"));\n  if (thumbKey) {\n    doc.thumbnail = unzipped[thumbKey];\n  }\n\n  // Extract images\n  for (const key of Object.keys(unzipped)) {\n    if (key.includes(\"images/\") && key !== \"images/\") {\n      const filename = key.split(\"/\").pop()!;\n      doc.images.set(filename, unzipped[key]);\n    }\n  }\n\n  return doc;\n}\n","import type { FigNode } from \"./types.js\";\n\n/**\n * Returns the string ID for a node (\"sessionID:localID\"), or null if no guid.\n */\nexport function nodeId(node: FigNode): string | null {\n  if (!node?.guid) return null;\n  return `${node.guid.sessionID}:${node.guid.localID}`;\n}\n"],"mappings":"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","names":["zstdDecompress"]}

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+interface FigGuid {
+    sessionID: number;
+    localID: number;
+}
+interface FigPaint {
+    type: string;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    opacity?: number;
+    visible?: boolean;
+}
+interface FigNode {
+    guid: FigGuid;
+    type: string;
+    name: string;
+    phase?: string;
+    parentIndex?: {
+        guid: FigGuid;
+        position: string;
+    };
+    size?: {
+        x: number;
+        y: number;
+    };
+    transform?: {
+        m00: number;
+        m01: number;
+        m02: number;
+        m10: number;
+        m11: number;
+        m12: number;
+    };
+    fillPaints?: FigPaint[];
+    strokePaints?: FigPaint[];
+    strokeWeight?: number;
+    cornerRadius?: number;
+    textData?: {
+        characters: string;
+    };
+    fontSize?: number;
+    opacity?: number;
+    shapeWithTextType?: string;
+    [key: string]: any;
+}
+interface FigDocument {
+    header: {
+        prelude: string;
+        version: number;
+    };
+    nodes: FigNode[];
+    nodeMap: Map<string, FigNode>;
+    childrenMap: Map<string, FigNode[]>;
+    /** Decoded kiwi binary schema (needed for re-encoding). */
+    schema: any;
+    /** Compiled kiwi schema with encodeMessage/decodeMessage (needed for re-encoding). */
+    compiledSchema: any;
+    /** Raw length-prefixed chunks from the binary (chunks[2+] are passed through on re-encode). */
+    rawChunks: Uint8Array[];
+    /** Full decoded kiwi message (contains nodeChanges, blobs, etc. — needed for re-encoding). */
+    message: any;
+    meta?: Record<string, any>;
+    thumbnail?: Uint8Array;
+    images: Map<string, Uint8Array>;
+}
+
+/**
+ * Isomorphic .fig binary parser.
+ *
+ * .fig files are ZIP archives containing:
+ *   - canvas.fig (binary: prelude + version + kiwi-encoded chunks)
+ *   - meta.json (optional)
+ *   - thumbnail.png (optional)
+ *   - images/ (optional)
+ *
+ * Parsing flow:
+ *   1. Unzip → extract canvas.fig
+ *   2. Read 8-byte prelude + 4-byte version
+ *   3. Chunk 0: deflateRaw → kiwi binary schema
+ *   4. Chunk 1: zstd or deflateRaw → kiwi message (nodeChanges[])
+ *   5. Build node maps
+ */
+
+/**
+ * Parse raw canvas.fig binary data (the blob inside the ZIP).
+ * Use this if you extract the ZIP yourself.
+ */
+declare function parseFigBinary(data: Uint8Array): FigDocument;
+/**
+ * Parse a complete .fig file (ZIP archive).
+ * Extracts canvas.fig, meta.json, thumbnail.png, and images/*.
+ */
+declare function parseFig(data: Uint8Array): FigDocument;
+
+/**
+ * Returns the string ID for a node ("sessionID:localID"), or null if no guid.
+ */
+declare function nodeId(node: FigNode): string | null;
+
+export { type FigDocument, type FigGuid, type FigNode, type FigPaint, nodeId, parseFig, parseFigBinary };

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+interface FigGuid {
+    sessionID: number;
+    localID: number;
+}
+interface FigPaint {
+    type: string;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    opacity?: number;
+    visible?: boolean;
+}
+interface FigNode {
+    guid: FigGuid;
+    type: string;
+    name: string;
+    phase?: string;
+    parentIndex?: {
+        guid: FigGuid;
+        position: string;
+    };
+    size?: {
+        x: number;
+        y: number;
+    };
+    transform?: {
+        m00: number;
+        m01: number;
+        m02: number;
+        m10: number;
+        m11: number;
+        m12: number;
+    };
+    fillPaints?: FigPaint[];
+    strokePaints?: FigPaint[];
+    strokeWeight?: number;
+    cornerRadius?: number;
+    textData?: {
+        characters: string;
+    };
+    fontSize?: number;
+    opacity?: number;
+    shapeWithTextType?: string;
+    [key: string]: any;
+}
+interface FigDocument {
+    header: {
+        prelude: string;
+        version: number;
+    };
+    nodes: FigNode[];
+    nodeMap: Map<string, FigNode>;
+    childrenMap: Map<string, FigNode[]>;
+    /** Decoded kiwi binary schema (needed for re-encoding). */
+    schema: any;
+    /** Compiled kiwi schema with encodeMessage/decodeMessage (needed for re-encoding). */
+    compiledSchema: any;
+    /** Raw length-prefixed chunks from the binary (chunks[2+] are passed through on re-encode). */
+    rawChunks: Uint8Array[];
+    /** Full decoded kiwi message (contains nodeChanges, blobs, etc. — needed for re-encoding). */
+    message: any;
+    meta?: Record<string, any>;
+    thumbnail?: Uint8Array;
+    images: Map<string, Uint8Array>;
+}
+
+/**
+ * Isomorphic .fig binary parser.
+ *
+ * .fig files are ZIP archives containing:
+ *   - canvas.fig (binary: prelude + version + kiwi-encoded chunks)
+ *   - meta.json (optional)
+ *   - thumbnail.png (optional)
+ *   - images/ (optional)
+ *
+ * Parsing flow:
+ *   1. Unzip → extract canvas.fig
+ *   2. Read 8-byte prelude + 4-byte version
+ *   3. Chunk 0: deflateRaw → kiwi binary schema
+ *   4. Chunk 1: zstd or deflateRaw → kiwi message (nodeChanges[])
+ *   5. Build node maps
+ */
+
+/**
+ * Parse raw canvas.fig binary data (the blob inside the ZIP).
+ * Use this if you extract the ZIP yourself.
+ */
+declare function parseFigBinary(data: Uint8Array): FigDocument;
+/**
+ * Parse a complete .fig file (ZIP archive).
+ * Extracts canvas.fig, meta.json, thumbnail.png, and images/*.
+ */
+declare function parseFig(data: Uint8Array): FigDocument;
+
+/**
+ * Returns the string ID for a node ("sessionID:localID"), or null if no guid.
+ */
+declare function nodeId(node: FigNode): string | null;
+
+export { type FigDocument, type FigGuid, type FigNode, type FigPaint, nodeId, parseFig, parseFigBinary };

package/dist/index.js

@@ -0,0 +1,101 @@
+// src/parser.ts
+import { unzipSync, inflateSync } from "fflate";
+import { decodeBinarySchema, compileSchema } from "kiwi-schema";
+import { decompress as zstdDecompress } from "fzstd";
+
+// src/utils.ts
+function nodeId(node) {
+  if (!node?.guid) return null;
+  return `${node.guid.sessionID}:${node.guid.localID}`;
+}
+
+// src/parser.ts
+function parseFigBinary(data) {
+  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+  const prelude = String.fromCharCode(...data.subarray(0, 8));
+  if (!prelude.startsWith("fig-")) {
+    throw new Error(`Unknown prelude: ${prelude}`);
+  }
+  const version = view.getUint32(8, true);
+  const chunks = [];
+  let off = 12;
+  while (off < data.byteLength) {
+    const len = view.getUint32(off, true);
+    off += 4;
+    chunks.push(data.subarray(off, off + len));
+    off += len;
+  }
+  if (chunks.length < 2) {
+    throw new Error("Expected at least 2 chunks in .fig binary");
+  }
+  const schemaData = inflateSync(chunks[0]);
+  const schema = decodeBinarySchema(schemaData);
+  const compiled = compileSchema(schema);
+  let msgData;
+  const c1 = chunks[1];
+  if (c1[0] === 40 && c1[1] === 181 && c1[2] === 47 && c1[3] === 253) {
+    msgData = zstdDecompress(c1);
+  } else {
+    msgData = inflateSync(c1);
+  }
+  const message = compiled.decodeMessage(msgData);
+  const nodes = message.nodeChanges;
+  const nodeMap = /* @__PURE__ */ new Map();
+  const childrenMap = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const id = nodeId(node);
+    if (id) nodeMap.set(id, node);
+  }
+  for (const node of nodes) {
+    if (!node.parentIndex?.guid) continue;
+    const pid = `${node.parentIndex.guid.sessionID}:${node.parentIndex.guid.localID}`;
+    if (!childrenMap.has(pid)) childrenMap.set(pid, []);
+    childrenMap.get(pid).push(node);
+  }
+  return {
+    header: { prelude: prelude.trim(), version },
+    nodes,
+    nodeMap,
+    childrenMap,
+    schema,
+    compiledSchema: compiled,
+    rawChunks: chunks,
+    message,
+    images: /* @__PURE__ */ new Map()
+  };
+}
+function parseFig(data) {
+  if (data[0] !== 80 || data[1] !== 75) {
+    throw new Error("Not a valid .fig file (missing ZIP header)");
+  }
+  const unzipped = unzipSync(data);
+  const canvasKey = Object.keys(unzipped).find((k) => k.endsWith("canvas.fig"));
+  if (!canvasKey) {
+    throw new Error("No canvas.fig found in .fig archive");
+  }
+  const doc = parseFigBinary(unzipped[canvasKey]);
+  const metaKey = Object.keys(unzipped).find((k) => k.endsWith("meta.json"));
+  if (metaKey) {
+    try {
+      doc.meta = JSON.parse(new TextDecoder().decode(unzipped[metaKey]));
+    } catch {
+    }
+  }
+  const thumbKey = Object.keys(unzipped).find((k) => k.endsWith("thumbnail.png"));
+  if (thumbKey) {
+    doc.thumbnail = unzipped[thumbKey];
+  }
+  for (const key of Object.keys(unzipped)) {
+    if (key.includes("images/") && key !== "images/") {
+      const filename = key.split("/").pop();
+      doc.images.set(filename, unzipped[key]);
+    }
+  }
+  return doc;
+}
+export {
+  nodeId,
+  parseFig,
+  parseFigBinary
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parser.ts","../src/utils.ts"],"sourcesContent":["/**\n * Isomorphic .fig binary parser.\n *\n * .fig files are ZIP archives containing:\n *   - canvas.fig (binary: prelude + version + kiwi-encoded chunks)\n *   - meta.json (optional)\n *   - thumbnail.png (optional)\n *   - images/ (optional)\n *\n * Parsing flow:\n *   1. Unzip → extract canvas.fig\n *   2. Read 8-byte prelude + 4-byte version\n *   3. Chunk 0: deflateRaw → kiwi binary schema\n *   4. Chunk 1: zstd or deflateRaw → kiwi message (nodeChanges[])\n *   5. Build node maps\n */\n\nimport { unzipSync, inflateSync } from \"fflate\";\nimport { decodeBinarySchema, compileSchema } from \"kiwi-schema\";\nimport { decompress as zstdDecompress } from \"fzstd\";\nimport type { FigDocument, FigNode } from \"./types.js\";\nimport { nodeId } from \"./utils.js\";\n\n/**\n * Parse raw canvas.fig binary data (the blob inside the ZIP).\n * Use this if you extract the ZIP yourself.\n */\nexport function parseFigBinary(data: Uint8Array): FigDocument {\n  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);\n\n  // Read 8-byte prelude + 4-byte version\n  const prelude = String.fromCharCode(...data.subarray(0, 8));\n  if (!prelude.startsWith(\"fig-\")) {\n    throw new Error(`Unknown prelude: ${prelude}`);\n  }\n  const version = view.getUint32(8, true);\n\n  // Read length-prefixed chunks\n  const chunks: Uint8Array[] = [];\n  let off = 12;\n  while (off < data.byteLength) {\n    const len = view.getUint32(off, true);\n    off += 4;\n    chunks.push(data.subarray(off, off + len));\n    off += len;\n  }\n\n  if (chunks.length < 2) {\n    throw new Error(\"Expected at least 2 chunks in .fig binary\");\n  }\n\n  // Chunk 0: kiwi schema (deflateRaw compressed)\n  const schemaData = inflateSync(chunks[0]);\n  const schema = decodeBinarySchema(schemaData);\n  const compiled = compileSchema(schema);\n\n  // Chunk 1: message (zstd or deflateRaw — auto-detect by magic bytes)\n  let msgData: Uint8Array;\n  const c1 = chunks[1];\n  if (c1[0] === 0x28 && c1[1] === 0xb5 && c1[2] === 0x2f && c1[3] === 0xfd) {\n    msgData = zstdDecompress(c1);\n  } else {\n    msgData = inflateSync(c1);\n  }\n  const message = compiled.decodeMessage(msgData);\n\n  // Build maps\n  const nodes: FigNode[] = message.nodeChanges;\n  const nodeMap = new Map<string, FigNode>();\n  const childrenMap = new Map<string, FigNode[]>();\n\n  for (const node of nodes) {\n    const id = nodeId(node);\n    if (id) nodeMap.set(id, node);\n  }\n\n  for (const node of nodes) {\n    if (!node.parentIndex?.guid) continue;\n    const pid = `${node.parentIndex.guid.sessionID}:${node.parentIndex.guid.localID}`;\n    if (!childrenMap.has(pid)) childrenMap.set(pid, []);\n    childrenMap.get(pid)!.push(node);\n  }\n\n  return {\n    header: { prelude: prelude.trim(), version },\n    nodes,\n    nodeMap,\n    childrenMap,\n    schema,\n    compiledSchema: compiled,\n    rawChunks: chunks,\n    message,\n    images: new Map(),\n  };\n}\n\n/**\n * Parse a complete .fig file (ZIP archive).\n * Extracts canvas.fig, meta.json, thumbnail.png, and images/*.\n */\nexport function parseFig(data: Uint8Array): FigDocument {\n  // Check ZIP header\n  if (data[0] !== 0x50 || data[1] !== 0x4b) {\n    throw new Error(\"Not a valid .fig file (missing ZIP header)\");\n  }\n\n  const unzipped = unzipSync(data);\n\n  // Find and parse canvas.fig\n  const canvasKey = Object.keys(unzipped).find((k) => k.endsWith(\"canvas.fig\"));\n  if (!canvasKey) {\n    throw new Error(\"No canvas.fig found in .fig archive\");\n  }\n  const doc = parseFigBinary(unzipped[canvasKey]);\n\n  // Extract meta.json\n  const metaKey = Object.keys(unzipped).find((k) => k.endsWith(\"meta.json\"));\n  if (metaKey) {\n    try {\n      doc.meta = JSON.parse(new TextDecoder().decode(unzipped[metaKey]));\n    } catch { /* ignore malformed meta */ }\n  }\n\n  // Extract thumbnail\n  const thumbKey = Object.keys(unzipped).find((k) => k.endsWith(\"thumbnail.png\"));\n  if (thumbKey) {\n    doc.thumbnail = unzipped[thumbKey];\n  }\n\n  // Extract images\n  for (const key of Object.keys(unzipped)) {\n    if (key.includes(\"images/\") && key !== \"images/\") {\n      const filename = key.split(\"/\").pop()!;\n      doc.images.set(filename, unzipped[key]);\n    }\n  }\n\n  return doc;\n}\n","import type { FigNode } from \"./types.js\";\n\n/**\n * Returns the string ID for a node (\"sessionID:localID\"), or null if no guid.\n */\nexport function nodeId(node: FigNode): string | null {\n  if (!node?.guid) return null;\n  return `${node.guid.sessionID}:${node.guid.localID}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "openfig-core",
+  "version": "0.2.0",
+  "description": "Isomorphic .fig file parser — reads Figma binary format in Node.js and browsers",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "fzstd": "^0.1.1",
+    "kiwi-schema": "^0.5.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}