openfig-cli 0.4.5 → 0.4.6

package/bin/cli.mjs

@@ -34,6 +34,7 @@ const COMMANDS = {
   'roundtrip':      './commands/roundtrip.mjs',
   'export':         './commands/export.mjs',
   'pdf':            './commands/pdf.mjs',
+  'deck-to-fig':    './commands/deck-to-fig.mjs',
 };
 
 const arg2 = process.argv[2];
@@ -45,6 +46,7 @@ if (!arg2 || arg2 === '--help' || arg2 === '-h') {
   console.log('Commands:');
   console.log('  create-deck    Create a new .deck file from scratch');
   console.log('  convert-html   Convert a Claude Design standalone HTML export into a .deck');
+  console.log('  deck-to-fig    Convert a Figma Slides .deck file into a Figma Design .fig file');
   console.log('  export         Export slides as images (PNG/JPG/WEBP)');
   console.log('  pdf            Export slides as a multi-page PDF');
   console.log('  inspect        Show document structure (node hierarchy tree)');

package/bin/commands/deck-to-fig.mjs

@@ -0,0 +1,128 @@
+/**
+ * deck-to-fig — Convert a Figma Slides (.deck) file to a standard Figma Design (.fig) file.
+ *
+ * Usage: openfig deck-to-fig <input.deck> -o <output.fig> [options]
+ */
+import { statSync, existsSync, readdirSync, readFileSync } from 'fs';
+import { resolve, join } from 'path';
+import { FigDeck } from '../../lib/core/fig-deck.mjs';
+import { convertDeckToFig } from 'openfig-core';
+
+export async function run(args, flags) {
+  const inPath = args[0];
+  const outPath = flags.o || flags.out || flags.output;
+  const dryRun = !!(flags['dry-run'] || flags.dryRun);
+
+  if (!inPath || (!dryRun && (!outPath || outPath === true))) {
+    console.error('Usage: openfig deck-to-fig <input.deck> -o <output.fig> [options]');
+    console.error('  <input.deck>  (required)  Figma Slides .deck file');
+    console.error('  -o / --out    (required unless --dry-run)  output .fig path');
+    console.error('  --title       (optional)  canvas/page name (default: deck title)');
+    console.error('  --layout      (optional)  frame arrangement: "row" or "grid" (default: "row")');
+    console.error('  --gap         (optional)  gap between frames in pixels (default: 200)');
+    console.error('  --wrap        (optional)  number of frames per row in grid layout (default: 5)');
+    console.error('  --dry-run     (optional)  run transform and print summary without emitting file');
+    process.exit(1);
+  }
+
+  const title = typeof flags.title === 'string' ? flags.title : undefined;
+  const layout = typeof flags.layout === 'string' ? flags.layout.toLowerCase() : 'row';
+  const gap = flags.gap ? parseInt(flags.gap, 10) : 200;
+  const wrap = flags.wrap ? parseInt(flags.wrap, 10) : 5;
+
+  if (layout !== 'row' && layout !== 'grid') {
+    console.error(`Error: Invalid layout "${layout}". Must be either "row" or "grid".`);
+    process.exit(1);
+  }
+
+  if (isNaN(gap) || gap < 0) {
+    console.error(`Error: Invalid gap value "${flags.gap}". Must be a non-negative number.`);
+    process.exit(1);
+  }
+
+  if (isNaN(wrap) || wrap <= 0) {
+    console.error(`Error: Invalid wrap value "${flags.wrap}". Must be a positive integer.`);
+    process.exit(1);
+  }
+
+  console.log(`Reading slides deck: ${inPath}`);
+  const deck = await FigDeck.fromDeckFile(inPath);
+
+  const imagesMap = new Map();
+  if (deck.imagesDir && existsSync(deck.imagesDir)) {
+    const files = readdirSync(deck.imagesDir);
+    for (const f of files) {
+      const fullPath = join(deck.imagesDir, f);
+      const stats = statSync(fullPath);
+      if (stats.isFile()) {
+        imagesMap.set(f, new Uint8Array(readFileSync(fullPath)));
+      }
+    }
+  }
+
+  // Build FigDocument for openfig-core convert transform
+  const inputDoc = {
+    header: deck.header,
+    nodes: deck.message.nodeChanges,
+    nodeMap: deck.nodeMap,
+    childrenMap: deck.childrenMap,
+    schema: deck.schema,
+    compiledSchema: deck.compiledSchema,
+    rawChunks: deck.rawFiles,
+    message: deck.message,
+    meta: deck.deckMeta,
+    thumbnail: deck.deckThumbnail,
+    images: imagesMap,
+  };
+
+  console.log(`Baking slides content with overrides...`);
+  const designDoc = convertDeckToFig(inputDoc, {
+    title,
+    layout,
+    gap,
+    wrap,
+  });
+
+  const canvas = designDoc.nodes.find((n) => n.type === 'CANVAS');
+  const canvasGuidStr = canvas ? `${canvas.guid.sessionID}:${canvas.guid.localID}` : '';
+  const frames = designDoc.nodes.filter(
+    (n) => n.type === 'FRAME' && n.parentIndex?.guid &&
+           `${n.parentIndex.guid.sessionID}:${n.parentIndex.guid.localID}` === canvasGuidStr
+  );
+
+  if (dryRun) {
+    console.log('\n--- DRY RUN SUMMARY ---');
+    console.log(`Canvas Page Title: "${canvas?.name || '(Untitled)'}"`);
+    console.log(`Layout strategy  : ${layout.toUpperCase()} (gap: ${gap}px${layout === 'grid' ? `, wrap: ${wrap}` : ''})`);
+    console.log(`Frame count      : ${frames.length}`);
+    console.log('\nFrames positioned on canvas:');
+    frames.forEach((f, idx) => {
+      const x = f.transform?.m02 ?? 0;
+      const y = f.transform?.m12 ?? 0;
+      const w = f.size?.x ?? 1920;
+      const h = f.size?.y ?? 1080;
+      console.log(`  [${String(idx + 1).padStart(2, '0')}] "${f.name}"  size: ${w}x${h}  pos: (${x}, ${y})`);
+    });
+    console.log('\nDry run complete. No file was written.');
+    return;
+  }
+
+  console.log(`Encoding output Design file...`);
+  const outputDeck = new FigDeck();
+  outputDeck.header = { prelude: 'fig-kiwi', version: designDoc.header.version };
+  outputDeck.schema = designDoc.schema;
+  outputDeck.compiledSchema = designDoc.compiledSchema;
+  outputDeck.message = designDoc.message;
+  outputDeck.rawFiles = designDoc.rawChunks;
+  outputDeck.rebuildMaps();
+  outputDeck.deckMeta = designDoc.meta;
+  outputDeck.deckThumbnail = designDoc.thumbnail;
+  outputDeck.imagesDir = deck.imagesDir;
+
+  const absoluteOut = resolve(outPath);
+  await outputDeck.saveDeck(absoluteOut);
+
+  const bytes = statSync(absoluteOut).size;
+  console.log(`Saved: ${outPath} (${bytes} bytes)`);
+  console.log(`Success! Conversion complete. Output file is valid Figma Design format.`);
+}

package/bin/commands/inspect.mjs

@@ -14,9 +14,7 @@ export async function run(args, flags) {
   const filterType = flags.type || null;
   const jsonOut = flags.json != null;
 
-  const deck = file.endsWith('.fig')
-    ? FigDeck.fromFigFile(file)
-    : await FigDeck.fromDeckFile(file);
+  const deck = await FigDeck.fromFile(file);
 
   // Find root nodes (no parentIndex or parent not in nodeMap)
   const roots = deck.message.nodeChanges.filter(n => {

package/bin/commands/list-overrides.mjs

@@ -12,9 +12,7 @@ export async function run(args, flags) {
 
   const filterSym = flags.symbol || null;
 
-  const deck = file.endsWith('.fig')
-    ? FigDeck.fromFigFile(file)
-    : await FigDeck.fromDeckFile(file);
+  const deck = await FigDeck.fromFile(file);
 
   const symbols = deck.getSymbols();
 

package/bin/commands/list-text.mjs

@@ -11,9 +11,7 @@ export async function run(args) {
   const file = args[0];
   if (!file) { console.error('Usage: list-text <file.deck>'); process.exit(1); }
 
-  const deck = file.endsWith('.fig')
-    ? FigDeck.fromFigFile(file)
-    : await FigDeck.fromDeckFile(file);
+  const deck = await FigDeck.fromFile(file);
 
   // Direct text nodes
   console.log('=== Direct text nodes ===\n');

package/lib/core/fig-deck.mjs

@@ -125,6 +125,21 @@ export class FigDeck {
     return deck;
   }
 
+  /**
+   * Load from a file, automatically detecting if it is a ZIP archive (.deck or zipped .fig)
+   * or a raw .fig binary by inspecting the magic bytes.
+   */
+  static async fromFile(filePath) {
+    const buf = readFileSync(resolve(filePath));
+    if (buf[0] === 0x50 && buf[1] === 0x4b) {
+      return this.fromDeckFile(filePath);
+    } else {
+      const deck = new FigDeck();
+      deck._parseFig(buf);
+      return deck;
+    }
+  }
+
   /**
    * Parse a canvas.fig buffer.
    * Format: prelude (8 bytes ASCII) + version (uint32 LE) + N×(length uint32 LE + chunk bytes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfig-cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "OpenFig — Open-source tools for Figma file parsing and rendering",
   "type": "module",
   "bin": {
@@ -47,7 +47,7 @@
     "css": "^3.0.0",
     "kiwi-schema": "^0.5.0",
     "node-html-parser": "^7.1.0",
-    "openfig-core": "^0.3.5",
+    "openfig-core": "^0.3.7",
     "pako": "^2.1.0",
     "pdf-lib": "^1.17.1",
     "playwright-core": "^1.59.1",