@seed-design/figma 1.3.8 → 1.3.9

package/src/normalizer/from-plugin.ts

@@ -11,6 +11,7 @@ import type {
   NormalizedTextNode,
   NormalizedComponentNode,
   NormalizedInstanceNode,
+  NormalizedSlotNode,
   NormalizedVectorNode,
   NormalizedBooleanOperationNode,
   NormalizedHasEffectsTrait,
@@ -41,6 +42,8 @@ export function createPluginNormalizer(): (node: SceneNode) => Promise<Normalize
         return normalizeComponentNode(node);
       case "INSTANCE":
         return normalizeInstanceNode(node);
+      case "SLOT":
+        return normalizeSlotNode(node);
       case "VECTOR":
         return normalizeVectorNode(node);
       case "BOOLEAN_OPERATION":
@@ -148,7 +151,7 @@ export function createPluginNormalizer(): (node: SceneNode) => Promise<Normalize
       return [];
     }
 
-    return fills.map(normalizePaint);
+    return fills.filter((paint) => paint.visible !== false).map(normalizePaint);
   }
 
   function normalizeRadiusProps(
@@ -289,6 +292,36 @@ export function createPluginNormalizer(): (node: SceneNode) => Promise<Normalize
     };
   }
 
+  async function normalizeSlotNode(node: SlotNode): Promise<NormalizedSlotNode> {
+    return {
+      // NormalizedIsLayerTrait
+      type: node.type,
+      id: node.id,
+      name: node.name,
+      boundVariables: normalizeBoundVariables(node),
+
+      // NormalizedHasLayoutTrait, NormalizedHasGeometryTrait, NormalizedHasEffectsTrait
+      ...(await normalizeShapeProps(node)),
+
+      // NormalizedCornerTrait
+      ...normalizeRadiusProps(node),
+
+      // NormalizedHasFramePropertiesTrait
+      ...(await normalizeAutolayoutProps(node)),
+
+      // NormalizedHasChildrenTrait
+      children: await normalizeNodes(node.children),
+
+      // NormalizedSlotNode specific
+      // Plugin API types don't include "slotContentId" in componentPropertyReferences yet
+      ...((node.componentPropertyReferences as Record<string, string> | null)?.[
+        "slotContentId"
+      ] && {
+        componentPropertyReferences: node.componentPropertyReferences as Record<string, string>,
+      }),
+    };
+  }
+
   async function normalizeRectangleNode(node: RectangleNode): Promise<NormalizedRectangleNode> {
     return {
       // NormalizedIsLayerTrait

package/src/normalizer/from-rest.ts

@@ -18,6 +18,7 @@ import type {
   NormalizedComponentNode,
   NormalizedInstanceNode,
   NormalizedTextSegment,
+  NormalizedSlotNode,
   NormalizedVectorNode,
   NormalizedBooleanOperationNode,
   NormalizedShadow,
@@ -64,6 +65,8 @@ export function createRestNormalizer(
         return normalizeComponentNode(node);
       case "INSTANCE":
         return normalizeInstanceNode(node);
+      case "SLOT":
+        return normalizeSlotNode(node);
       case "VECTOR":
         return normalizeVectorNode(node);
       case "BOOLEAN_OPERATION":
@@ -125,7 +128,9 @@ export function createRestNormalizer(
   function normalizePaints(paints: FigmaRestSpec.Paint[] | undefined): NormalizedPaint[] {
     if (!paints) return [];
 
-    return paints.map(normalizePaint);
+    return paints
+      .filter((paint) => !("visible" in paint) || paint.visible !== false)
+      .map(normalizePaint);
   }
 
   function normalizeRadiusProps({
@@ -268,6 +273,33 @@ export function createRestNormalizer(
     };
   }
 
+  function normalizeSlotNode(node: FigmaRestSpec.SlotNode): NormalizedSlotNode {
+    return {
+      // NormalizedIsLayerTrait
+      type: node.type,
+      id: node.id,
+      name: node.name,
+      boundVariables: normalizeBoundVariables(node.boundVariables),
+
+      // NormalizedHasLayoutTrait, NormalizedHasGeometryTrait, NormalizedHasEffectsTrait, NormalizedHasFramePropertiesTrait
+      ...normalizeShapeProps(node),
+
+      // NormalizedCornerTrait
+      ...normalizeRadiusProps(node),
+
+      // NormalizedHasFramePropertiesTrait
+      ...normalizeAutolayoutProps(node),
+
+      // NormalizedHasChildrenTrait
+      children: normalizeNodes(node.children),
+
+      // NormalizedSlotNode specific
+      ...(node.componentPropertyReferences?.["slotContentId"] && {
+        componentPropertyReferences: node.componentPropertyReferences,
+      }),
+    };
+  }
+
   function normalizeRectangleNode(node: FigmaRestSpec.RectangleNode): NormalizedRectangleNode {
     return {
       //  NormalizedIsLayerTrait

package/src/normalizer/types.ts

@@ -178,6 +178,13 @@ export interface NormalizedInstanceNode extends NormalizedFrameTrait {
   children: NormalizedSceneNode[];
 }
 
+export interface NormalizedSlotNode extends NormalizedFrameTrait {
+  type: FigmaRestSpec.SlotNode["type"];
+  componentPropertyReferences?: FigmaRestSpec.IsLayerTrait["componentPropertyReferences"] & {
+    slotContentId?: string;
+  };
+}
+
 export interface NormalizedVectorNode extends NormalizedDefaultShapeTrait, NormalizedCornerTrait {
   type: FigmaRestSpec.VectorNode["type"];
 }
@@ -203,6 +210,7 @@ export type NormalizedSceneNode =
   | NormalizedTextNode
   | NormalizedComponentNode
   | NormalizedInstanceNode
+  | NormalizedSlotNode
   | NormalizedVectorNode
   | NormalizedBooleanOperationNode
   | NormalizedUnhandledNode;

package/src/utils/figma-node.ts

@@ -2,6 +2,7 @@ import type {
   NormalizedHasGeometryTrait,
   NormalizedInstanceNode,
   NormalizedSceneNode,
+  NormalizedSlotNode,
   NormalizedSolidPaint,
 } from "../normalizer";
 
@@ -55,11 +56,19 @@ export function findAllInstances<T>({ node, key }: { node: NormalizedSceneNode;
   ) as (Omit<NormalizedInstanceNode, "componentProperties"> & { componentProperties: T })[];
 }
 
+export function findSlotNode<T extends NormalizedInstanceNode["componentProperties"]>(
+  node: Omit<NormalizedInstanceNode, "componentProperties"> & { componentProperties: T },
+  slotPropertyKey: { [K in keyof T]: T[K] extends { type: "SLOT" } ? K : never }[keyof T] & string,
+): NormalizedSlotNode | undefined {
+  return findOne(
+    node,
+    (child) =>
+      child.type === "SLOT" && child.componentPropertyReferences?.slotContentId === slotPropertyKey,
+  ) as NormalizedSlotNode | undefined;
+}
+
 export function getFirstSolidFill(node: NormalizedHasGeometryTrait) {
-  const fills = node.fills.filter(
-    (fill): fill is NormalizedSolidPaint =>
-      fill.type === "SOLID" && (!("visible" in fill) || fill.visible === true),
-  );
+  const fills = node.fills.filter((fill): fill is NormalizedSolidPaint => fill.type === "SOLID");
 
   if (fills.length === 0) {
     return undefined;
@@ -76,10 +85,7 @@ export function getFirstFillVariable(node: NormalizedHasGeometryTrait) {
 
 export function getFirstStroke(node: NormalizedHasGeometryTrait) {
   const strokes =
-    node.strokes?.filter(
-      (stroke): stroke is NormalizedSolidPaint =>
-        stroke.type === "SOLID" && (!("visible" in stroke) || stroke.visible === true),
-    ) ?? [];
+    node.strokes?.filter((stroke): stroke is NormalizedSolidPaint => stroke.type === "SOLID") ?? [];
 
   if (strokes.length === 0) {
     return undefined;