openfig-cli 0.3.20 → 0.3.21

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.20",
+  "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.20",
+  "version": "0.3.21",
   "description": "OpenFig — Open-source tools for Figma file parsing and rendering",
   "type": "module",
   "bin": {