@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/bindVariablesToComponent.js

@@ -1,110 +1,110 @@
-/**
- * bindVariablesToComponent
- *
- * Binds design token variables to the visual properties of a component node.
- * Supports fills, strokes, all padding directions, item spacing, and corner radius.
- * Only binds properties for which a variable ID is provided in `bindings`.
- *
- * This function should be called on each variant individually within a component
- * set, OR on the component set itself for properties shared by all variants.
- *
- * @param {ComponentNode | FrameNode | RectangleNode} component
- *   The Figma node to mutate. Usually a ComponentNode or one of its children.
- * @param {{
- *   fills?: string,
- *   strokes?: string,
- *   paddingTop?: string,
- *   paddingBottom?: string,
- *   paddingLeft?: string,
- *   paddingRight?: string,
- *   itemSpacing?: string,
- *   cornerRadius?: string
- * }} bindings
- *   Each key is a visual property name; each value is a Figma Variable ID
- *   (e.g. "VariableID:123:456"). Omit a key to skip binding that property.
- * @returns {{ mutatedNodeIds: string[] }}
- *   List of node IDs that were mutated (for audit/validation purposes).
- */
-function bindVariablesToComponent(component, bindings) {
-  const mutatedNodeIds = []
-
-  if (!component) {
-    return { mutatedNodeIds }
-  }
-
-  // --- Fills ---
-  if (bindings.fills) {
-    const fillVar = figma.variables.getVariableById(bindings.fills)
-    if (fillVar) {
-      const existingFills = component.fills
-      if (Array.isArray(existingFills) && existingFills.length > 0) {
-        // Bind the color of the first fill to the variable
-        const boundFill = figma.variables.setBoundVariableForPaint(
-          existingFills[0],
-          'color',
-          fillVar,
-        )
-        component.fills = [boundFill, ...existingFills.slice(1)]
-      } else {
-        // No existing fill — create a solid fill bound to the variable
-        const boundFill = figma.variables.setBoundVariableForPaint(
-          { type: 'SOLID', color: { r: 0.5, g: 0.5, b: 0.5 } },
-          'color',
-          fillVar,
-        )
-        component.fills = [boundFill]
-      }
-      mutatedNodeIds.push(component.id)
-    }
-  }
-
-  // --- Strokes ---
-  if (bindings.strokes) {
-    const strokeVar = figma.variables.getVariableById(bindings.strokes)
-    if (strokeVar) {
-      const existingStrokes = component.strokes
-      if (Array.isArray(existingStrokes) && existingStrokes.length > 0) {
-        const boundStroke = figma.variables.setBoundVariableForPaint(
-          existingStrokes[0],
-          'color',
-          strokeVar,
-        )
-        component.strokes = [boundStroke, ...existingStrokes.slice(1)]
-      } else {
-        const boundStroke = figma.variables.setBoundVariableForPaint(
-          { type: 'SOLID', color: { r: 0.5, g: 0.5, b: 0.5 } },
-          'color',
-          strokeVar,
-        )
-        component.strokes = [boundStroke]
-      }
-      if (!mutatedNodeIds.includes(component.id)) {
-        mutatedNodeIds.push(component.id)
-      }
-    }
-  }
-
-  // --- Spacing properties (FLOAT variables bound via setBoundVariable) ---
-  const floatBindings = [
-    ['paddingTop', 'paddingTop'],
-    ['paddingBottom', 'paddingBottom'],
-    ['paddingLeft', 'paddingLeft'],
-    ['paddingRight', 'paddingRight'],
-    ['itemSpacing', 'itemSpacing'],
-    ['cornerRadius', 'cornerRadius'],
-  ]
-
-  for (const [bindingKey, figmaProp] of floatBindings) {
-    if (bindings[bindingKey]) {
-      const variable = figma.variables.getVariableById(bindings[bindingKey])
-      if (variable) {
-        component.setBoundVariable(figmaProp, variable)
-        if (!mutatedNodeIds.includes(component.id)) {
-          mutatedNodeIds.push(component.id)
-        }
-      }
-    }
-  }
-
-  return { mutatedNodeIds }
-}
+/**
+ * bindVariablesToComponent
+ *
+ * Binds design token variables to the visual properties of a component node.
+ * Supports fills, strokes, all padding directions, item spacing, and corner radius.
+ * Only binds properties for which a variable ID is provided in `bindings`.
+ *
+ * This function should be called on each variant individually within a component
+ * set, OR on the component set itself for properties shared by all variants.
+ *
+ * @param {ComponentNode | FrameNode | RectangleNode} component
+ *   The Figma node to mutate. Usually a ComponentNode or one of its children.
+ * @param {{
+ *   fills?: string,
+ *   strokes?: string,
+ *   paddingTop?: string,
+ *   paddingBottom?: string,
+ *   paddingLeft?: string,
+ *   paddingRight?: string,
+ *   itemSpacing?: string,
+ *   cornerRadius?: string
+ * }} bindings
+ *   Each key is a visual property name; each value is a Figma Variable ID
+ *   (e.g. "VariableID:123:456"). Omit a key to skip binding that property.
+ * @returns {{ mutatedNodeIds: string[] }}
+ *   List of node IDs that were mutated (for audit/validation purposes).
+ */
+function bindVariablesToComponent(component, bindings) {
+  const mutatedNodeIds = []
+
+  if (!component) {
+    return { mutatedNodeIds }
+  }
+
+  // --- Fills ---
+  if (bindings.fills) {
+    const fillVar = figma.variables.getVariableById(bindings.fills)
+    if (fillVar) {
+      const existingFills = component.fills
+      if (Array.isArray(existingFills) && existingFills.length > 0) {
+        // Bind the color of the first fill to the variable
+        const boundFill = figma.variables.setBoundVariableForPaint(
+          existingFills[0],
+          'color',
+          fillVar,
+        )
+        component.fills = [boundFill, ...existingFills.slice(1)]
+      } else {
+        // No existing fill — create a solid fill bound to the variable
+        const boundFill = figma.variables.setBoundVariableForPaint(
+          { type: 'SOLID', color: { r: 0.5, g: 0.5, b: 0.5 } },
+          'color',
+          fillVar,
+        )
+        component.fills = [boundFill]
+      }
+      mutatedNodeIds.push(component.id)
+    }
+  }
+
+  // --- Strokes ---
+  if (bindings.strokes) {
+    const strokeVar = figma.variables.getVariableById(bindings.strokes)
+    if (strokeVar) {
+      const existingStrokes = component.strokes
+      if (Array.isArray(existingStrokes) && existingStrokes.length > 0) {
+        const boundStroke = figma.variables.setBoundVariableForPaint(
+          existingStrokes[0],
+          'color',
+          strokeVar,
+        )
+        component.strokes = [boundStroke, ...existingStrokes.slice(1)]
+      } else {
+        const boundStroke = figma.variables.setBoundVariableForPaint(
+          { type: 'SOLID', color: { r: 0.5, g: 0.5, b: 0.5 } },
+          'color',
+          strokeVar,
+        )
+        component.strokes = [boundStroke]
+      }
+      if (!mutatedNodeIds.includes(component.id)) {
+        mutatedNodeIds.push(component.id)
+      }
+    }
+  }
+
+  // --- Spacing properties (FLOAT variables bound via setBoundVariable) ---
+  const floatBindings = [
+    ['paddingTop', 'paddingTop'],
+    ['paddingBottom', 'paddingBottom'],
+    ['paddingLeft', 'paddingLeft'],
+    ['paddingRight', 'paddingRight'],
+    ['itemSpacing', 'itemSpacing'],
+    ['cornerRadius', 'cornerRadius'],
+  ]
+
+  for (const [bindingKey, figmaProp] of floatBindings) {
+    if (bindings[bindingKey]) {
+      const variable = figma.variables.getVariableById(bindings[bindingKey])
+      if (variable) {
+        component.setBoundVariable(figmaProp, variable)
+        if (!mutatedNodeIds.includes(component.id)) {
+          mutatedNodeIds.push(component.id)
+        }
+      }
+    }
+  }
+
+  return { mutatedNodeIds }
+}

package/docs/skill-candidates/v0.0.10/figma-generate-library/scripts/cleanupOrphans.js

@@ -1,127 +1,127 @@
-/**
- * cleanupOrphans
- *
- * Finds and removes all Figma nodes (pages, frames, components, variables,
- * and variable collections) that were tagged with the given `dsb_run_id`
- * by a previous build run. This is safe cleanup: it uses plugin data tags,
- * never name-prefix matching, so it cannot accidentally delete user-owned nodes.
- *
- * Use this when a build run fails mid-way and you need to reset to a clean
- * slate before retrying. The function traverses the entire document looking
- * for `dsb_run_id` plugin data matching `runId`.
- *
- * Variables and variable collections are handled separately (they are not
- * scene nodes and cannot be discovered via node traversal).
- *
- * @param {string} runId - The dsb_run_id value to match (e.g. "ds-build-2024-001").
- * @returns {Promise<{
- *   removedCount: number,
- *   removedIds: string[]
- * }>}
- */
-async function cleanupOrphans(runId) {
-  if (!runId) {
-    throw new Error('cleanupOrphans: runId is required.')
-  }
-
-  const removedIds = []
-  const originalPage = figma.currentPage
-
-  // --- Remove tagged scene nodes (pages, frames, components, etc.) ---
-  // Collect pages to remove (can't remove during iteration)
-  const pagesToRemove = []
-
-  for (const page of figma.root.children) {
-    if (page.getPluginData('dsb_run_id') === runId) {
-      pagesToRemove.push(page)
-      continue
-    }
-
-    // Traverse all nodes on this page
-    await figma.setCurrentPageAsync(page)
-
-    const nodesToRemove = []
-    page.findAll((node) => {
-      if (node.getPluginData('dsb_run_id') === runId) {
-        nodesToRemove.push(node)
-        return false // Don't descend — removing the parent removes its children
-      }
-      return true
-    })
-
-    // Remove deepest nodes first (children before parents) to avoid
-    // "parent no longer exists" errors
-    const sorted = nodesToRemove.sort((a, b) => {
-      // Sort by depth descending: deeper nodes first
-      return getDepth(b) - getDepth(a)
-    })
-
-    for (const node of sorted) {
-      if (node && node.parent) {
-        removedIds.push(node.id)
-        node.remove()
-      }
-    }
-  }
-
-  // Remove tagged pages last
-  for (const page of pagesToRemove) {
-    // Cannot remove the last page in the document
-    if (figma.root.children.length <= 1) {
-      break
-    }
-    removedIds.push(page.id)
-    page.remove()
-  }
-
-  // --- Remove tagged variables ---
-  const allVariables = figma.variables.getLocalVariables()
-  for (const variable of allVariables) {
-    if (variable.getPluginData('dsb_run_id') === runId) {
-      removedIds.push(variable.id)
-      variable.remove()
-    }
-  }
-
-  // --- Remove tagged variable collections ---
-  // Must be done after variables are removed
-  const allCollections = figma.variables.getLocalVariableCollections()
-  for (const collection of allCollections) {
-    if (collection.getPluginData('dsb_run_id') === runId) {
-      removedIds.push(collection.id)
-      collection.remove()
-    }
-  }
-
-  // Restore original page (if it still exists)
-  try {
-    await figma.setCurrentPageAsync(originalPage)
-  } catch (_) {
-    // Original page was removed — switch to first available page
-    if (figma.root.children.length > 0) {
-      await figma.setCurrentPageAsync(figma.root.children[0])
-    }
-  }
-
-  return {
-    removedCount: removedIds.length,
-    removedIds,
-  }
-}
-
-/**
- * Returns the depth of a node in the document tree.
- * Root children (pages) have depth 1; their children have depth 2; etc.
- *
- * @param {BaseNode} node
- * @returns {number}
- */
-function getDepth(node) {
-  let depth = 0
-  let current = node
-  while (current.parent) {
-    depth++
-    current = current.parent
-  }
-  return depth
-}
+/**
+ * cleanupOrphans
+ *
+ * Finds and removes all Figma nodes (pages, frames, components, variables,
+ * and variable collections) that were tagged with the given `dsb_run_id`
+ * by a previous build run. This is safe cleanup: it uses plugin data tags,
+ * never name-prefix matching, so it cannot accidentally delete user-owned nodes.
+ *
+ * Use this when a build run fails mid-way and you need to reset to a clean
+ * slate before retrying. The function traverses the entire document looking
+ * for `dsb_run_id` plugin data matching `runId`.
+ *
+ * Variables and variable collections are handled separately (they are not
+ * scene nodes and cannot be discovered via node traversal).
+ *
+ * @param {string} runId - The dsb_run_id value to match (e.g. "ds-build-2024-001").
+ * @returns {Promise<{
+ *   removedCount: number,
+ *   removedIds: string[]
+ * }>}
+ */
+async function cleanupOrphans(runId) {
+  if (!runId) {
+    throw new Error('cleanupOrphans: runId is required.')
+  }
+
+  const removedIds = []
+  const originalPage = figma.currentPage
+
+  // --- Remove tagged scene nodes (pages, frames, components, etc.) ---
+  // Collect pages to remove (can't remove during iteration)
+  const pagesToRemove = []
+
+  for (const page of figma.root.children) {
+    if (page.getPluginData('dsb_run_id') === runId) {
+      pagesToRemove.push(page)
+      continue
+    }
+
+    // Traverse all nodes on this page
+    await figma.setCurrentPageAsync(page)
+
+    const nodesToRemove = []
+    page.findAll((node) => {
+      if (node.getPluginData('dsb_run_id') === runId) {
+        nodesToRemove.push(node)
+        return false // Don't descend — removing the parent removes its children
+      }
+      return true
+    })
+
+    // Remove deepest nodes first (children before parents) to avoid
+    // "parent no longer exists" errors
+    const sorted = nodesToRemove.sort((a, b) => {
+      // Sort by depth descending: deeper nodes first
+      return getDepth(b) - getDepth(a)
+    })
+
+    for (const node of sorted) {
+      if (node && node.parent) {
+        removedIds.push(node.id)
+        node.remove()
+      }
+    }
+  }
+
+  // Remove tagged pages last
+  for (const page of pagesToRemove) {
+    // Cannot remove the last page in the document
+    if (figma.root.children.length <= 1) {
+      break
+    }
+    removedIds.push(page.id)
+    page.remove()
+  }
+
+  // --- Remove tagged variables ---
+  const allVariables = figma.variables.getLocalVariables()
+  for (const variable of allVariables) {
+    if (variable.getPluginData('dsb_run_id') === runId) {
+      removedIds.push(variable.id)
+      variable.remove()
+    }
+  }
+
+  // --- Remove tagged variable collections ---
+  // Must be done after variables are removed
+  const allCollections = figma.variables.getLocalVariableCollections()
+  for (const collection of allCollections) {
+    if (collection.getPluginData('dsb_run_id') === runId) {
+      removedIds.push(collection.id)
+      collection.remove()
+    }
+  }
+
+  // Restore original page (if it still exists)
+  try {
+    await figma.setCurrentPageAsync(originalPage)
+  } catch (_) {
+    // Original page was removed — switch to first available page
+    if (figma.root.children.length > 0) {
+      await figma.setCurrentPageAsync(figma.root.children[0])
+    }
+  }
+
+  return {
+    removedCount: removedIds.length,
+    removedIds,
+  }
+}
+
+/**
+ * Returns the depth of a node in the document tree.
+ * Root children (pages) have depth 1; their children have depth 2; etc.
+ *
+ * @param {BaseNode} node
+ * @returns {number}
+ */
+function getDepth(node) {
+  let depth = 0
+  let current = node
+  while (current.parent) {
+    depth++
+    current = current.parent
+  }
+  return depth
+}