openfig-cli 0.3.19 → 0.3.21

package/lib/core/fig-deck.mjs

@@ -278,12 +278,64 @@ export class FigDeck {
     });
   }
 
+  /**
+   * Validate deck integrity before saving. Warns about issues that would
+   * cause Figma to fail silently (blank slides, missing symbols, etc.).
+   */
+  validate() {
+    const warnings = [];
+    const symbols = this.getSymbols().filter(s => s.phase !== 'REMOVED');
+
+    // Check for variant name / variantPropSpecs mismatch
+    const byKey = new Map();
+    for (const sym of symbols) {
+      if (!sym.componentKey) continue;
+      if (!byKey.has(sym.componentKey)) byKey.set(sym.componentKey, []);
+      byKey.get(sym.componentKey).push(sym);
+    }
+    for (const [key, variants] of byKey) {
+      if (variants.length < 2) continue;
+      const specValues = new Set();
+      for (const sym of variants) {
+        if (sym.variantPropSpecs) {
+          for (const spec of sym.variantPropSpecs) specValues.add(spec.value);
+        }
+      }
+      for (const sym of variants) {
+        const parts = (sym.name || '').split(', ').map(p => p.split('=')[1]).filter(Boolean);
+        for (const val of parts) {
+          if (!specValues.has(val)) {
+            const id = `${sym.guid.sessionID}:${sym.guid.localID}`;
+            warnings.push(`SYMBOL ${id} "${sym.name}": variant value "${val}" not in variantPropSpecs — Figma will show blank slides`);
+          }
+        }
+      }
+    }
+
+    // Check for instances referencing missing symbols
+    for (const node of this.message.nodeChanges) {
+      if (node.type !== 'INSTANCE' || node.phase === 'REMOVED') continue;
+      const sid = node.symbolData?.symbolID;
+      if (!sid) continue;
+      const symId = `${sid.sessionID}:${sid.localID}`;
+      const sym = this.getNode(symId);
+      if (!sym || sym.type !== 'SYMBOL') {
+        const nid = `${node.guid.sessionID}:${node.guid.localID}`;
+        warnings.push(`INSTANCE ${nid} "${node.name}": references missing SYMBOL ${symId}`);
+      }
+    }
+
+    for (const w of warnings) console.warn(`⚠️  ${w}`);
+    return warnings;
+  }
+
   /**
    * Save as a .deck (ZIP archive).
    * @param {string} outPath - Output file path
    * @param {object} opts - { imagesDir, thumbnail, meta }
    */
   async saveDeck(outPath, opts = {}) {
+    this.validate();
     const figBuf = await this.encodeFig();
     const absOut = resolve(outPath);
 

package/lib/rasterizer/svg-builder.mjs

@@ -1102,6 +1102,22 @@ function renderInstance(deck, node) {
   const symbol = deck.getNode(symNid);
   if (!symbol) return renderPlaceholder(deck, node);
 
+  // Figma-parity: reject instances of symbols with invalid variant specs.
+  // Figma Desktop silently shows blank slides for these. We match that behavior
+  // deliberately so our preview catches invalid decks instead of hiding them.
+  // Root cause: older tooling created SYMBOL variants with names (e.g.
+  // "Size=Wide") that don't exist in the component set's variantPropSpecs.
+  if (symbol.componentKey && symbol.variantPropSpecs) {
+    const specValues = new Set(symbol.variantPropSpecs.map(s => s.value));
+    const nameValues = (symbol.name || '').split(', ').map(p => p.split('=')[1]).filter(Boolean);
+    const invalid = nameValues.some(v => !specValues.has(v));
+    if (invalid) {
+      const nid = `${node.guid.sessionID}:${node.guid.localID}`;
+      console.warn(`⚠️  Skipping INSTANCE ${nid}: symbol ${symNid} "${symbol.name}" has invalid variant specs — Figma would show blank`);
+      return renderPlaceholder(deck, node);
+    }
+  }
+
   // Temporarily apply symbolOverrides so rendered content reflects overrides.
   // Override guidPaths may reference library-original IDs (e.g. 100:656) rather
   // than local node IDs (e.g. 1:1131). Nodes expose their library ID via the

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.2",
   "name": "openfig",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Open-source tools for Figma file parsing and rendering",
   "author": {
     "name": "OpenFig Contributors"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfig-cli",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "OpenFig — Open-source tools for Figma file parsing and rendering",
   "type": "module",
   "bin": {