@ufira/vibma 1.1.3-rc1 → 1.1.3-rc2

package/dist/mcp.cjs

@@ -412,7 +412,7 @@ Create frame-like containers
 
 Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
 
-Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg | slot)
 
   ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
@@ -631,7 +631,64 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     name (string, optional) \u2014 Layer name (default: 'SVG')
     parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
-    y (number, optional) \u2014 Y position (default: 0)`,
+    y (number, optional) \u2014 Y position (default: 0)
+
+  ## slot \u2014 Create a slot inside a component. Slots are placeholder containers that instance users fill with content. Defaults to VERTICAL auto-layout with FILL/HUG sizing \u2014 ready to receive children. Accepts all frame layout properties.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID inside the owning component. Required unless componentId is provided.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
+    height (number, optional) \u2014 Height in px (omit to shrink-to-content via HUG)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    imageUrl (string, optional) \u2014 Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills.
+    imageScaleMode (FILL | FIT | CROP | TILE, optional) \u2014 How the image is scaled within the frame (default: FILL)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)
+    layoutWrap (NO_WRAP | WRAP, optional) \u2014 Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns.
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    annotations (array, optional) \u2014 Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type.
+    componentId (string, optional) \u2014 Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.`,
       "commit": '# frames.commit\nCommit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: frames(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
     }
@@ -914,7 +971,7 @@ Methods:
 //   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
 //   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
 //   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
-//   "empty-container" \u2014 empty frames [style]
+//   "empty-container" \u2014 empty frames, excludes SLOT nodes [style]
 // Token rules [token]:
 //   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
 //   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]
@@ -1746,7 +1803,7 @@ var tools = [
   },
   {
     name: "frames",
-    description: '/** Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes \u2014 produces a same-type copy (frame\u2192frame, instance\u2192instance, component\u2192component). Instance clones reference the same source component; they do not duplicate the component definition.\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (type: frame|auto_layout|section|rectangle|ellipse|line|group|boolean_operation|svg, items: (FrameItem | AutoLayoutItem | SectionItem | RectangleItem | EllipseItem | LineItem | GroupItem | BooleanOperationItem | SvgItem)[]) \u2192 { results: {id}[] }  // Create frame-like containers\n  commit    (id) \u2192 { results: {id}[] }  // Commit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n  export    (id, format?: PNG|JPG|SVG|SVG_STRING|PDF, scale?) \u2192 { imageData?, mimeType? }  // Export a node as PNG, JPG, SVG, SVG_STRING, or PDF\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    description: '/** Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes \u2014 produces a same-type copy (frame\u2192frame, instance\u2192instance, component\u2192component). Instance clones reference the same source component; they do not duplicate the component definition.\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (type: frame|auto_layout|section|rectangle|ellipse|line|group|boolean_operation|svg|slot, items: (FrameItem | AutoLayoutItem | SectionItem | RectangleItem | EllipseItem | LineItem | GroupItem | BooleanOperationItem | SvgItem | SlotItem)[]) \u2192 { results: {id}[] }  // Create frame-like containers\n  commit    (id) \u2192 { results: {id}[] }  // Commit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n  export    (id, format?: PNG|JPG|SVG|SVG_STRING|PDF, scale?) \u2192 { imageData?, mimeType? }  // Export a node as PNG, JPG, SVG, SVG_STRING, or PDF\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
     schema: (caps2) => filterMethodsByTier({
       method: import_zod4.z.enum(["get", "list", "update", "delete", "clone", "audit", "reparent", "create", "commit", "export", "help"]),
       id: import_zod4.z.string().optional().describe("Node ID"),
@@ -1767,7 +1824,7 @@ var tools = [
       maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
       minSeverity: import_zod4.z.enum(["error", "unsafe", "heuristic", "style", "verbose"]).optional().describe("Minimum severity to report (default: style). Set to 'verbose' to include AAA contrast and line-height checks."),
       skipInstances: flexBool(import_zod4.z.boolean()).optional().describe("Skip instance internals \u2014 findings inside instances are owned by the component (default: true)"),
-      type: import_zod4.z.enum(["frame", "auto_layout", "section", "rectangle", "ellipse", "line", "group", "boolean_operation", "svg"]).optional().describe("Discriminant for create method"),
+      type: import_zod4.z.enum(["frame", "auto_layout", "section", "rectangle", "ellipse", "line", "group", "boolean_operation", "svg", "slot"]).optional().describe("Discriminant for create method"),
       format: import_zod4.z.enum(["PNG", "JPG", "SVG", "SVG_STRING", "PDF"]).optional().describe("Export format (default: PNG). SVG_STRING returns raw SVG text."),
       scale: import_zod4.z.coerce.number().optional().describe("Export scale (default: 1, only for PNG/JPG)"),
       topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
@@ -2000,6 +2057,63 @@ var tools = [
             parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
             y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)")
+          }).passthrough(),
+          "slot": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Node name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID inside the owning component. Required unless componentId is provided."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width in px (omit to shrink-to-content via HUG)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height in px (omit to shrink-to-content via HUG)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            imageUrl: import_zod4.z.string().optional().describe("Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills."),
+            imageScaleMode: import_zod4.z.enum(["FILL", "FIT", "CROP", "TILE"]).optional().describe("How the image is scaled within the frame (default: FILL)"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)"),
+            layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional().describe("Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns."),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            annotations: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type."),
+            componentId: import_zod4.z.string().optional().describe("Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.")
           }).passthrough()
         };
         const s = params.type && schemas[params.type];
@@ -3032,7 +3146,7 @@ var guidelinesList = [
   }
 ];
 var guidelinesContent = {
-  "component-structure": '# Component Structure\n\nComponents need correct sizing, property bindings, and token usage to work well as instances.\n\n## Width Constraints\n\nComponents with text content need a width \u2014 otherwise text never wraps.\n\n- Set `width` and `layoutSizingHorizontal:"FIXED"` on cards, panels, list items\n- HUG on both axes is only correct for buttons, badges, icons \u2014 intrinsically-sized elements\n\n## Property Bindings\n\nEvery text node inside a component should be bound to a TEXT property so instances can edit the content.\n\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- After creation: `frames(method:"update", items:[{id:"<textNodeId>", componentPropertyName:"<propName>"}])`\n- For existing nodes with many text children: `components(method:"create", type:"from_node", exposeText:true)`\n\nOrphaned properties (defined but not bound to any node) should be deleted:\n```\ncomponents(method:"update", items:[{id, propertyName:"<key>", action:"delete"}])\n```\n\n## Variant Sets\n\nGroup related components as variants \u2014 don\'t leave them as separate components.\n\n- Name variants with the property format: `Style=Primary`, `Style=Secondary`\n- Combine: `components(method:"create", type:"variant_set", items:[{componentIds:[...], name:"Button"}])`\n- Instances pick variants via `variantProperties:{"Style":"Primary"}`\n\n### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
+  "component-structure": '# Component Structure\n\nComponents need correct sizing, property bindings, and token usage to work well as instances.\n\n## Width Constraints\n\nComponents with text content need a width \u2014 otherwise text never wraps.\n\n- Set `width` and `layoutSizingHorizontal:"FIXED"` on cards, panels, list items\n- HUG on both axes is only correct for buttons, badges, icons \u2014 intrinsically-sized elements\n\n## Property Bindings\n\nEvery text node inside a component should be bound to a TEXT property so instances can edit the content.\n\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- After creation: `frames(method:"update", items:[{id:"<textNodeId>", componentPropertyName:"<propName>"}])`\n- For existing nodes with many text children: `components(method:"create", type:"from_node", exposeText:true)`\n\nOrphaned properties (defined but not bound to any node) should be deleted:\n```\ncomponents(method:"update", items:[{id, propertyName:"<key>", action:"delete"}])\n```\n\n## Variant Sets\n\nGroup related components as variants \u2014 don\'t leave them as separate components.\n\n- Name variants with the property format: `Style=Primary`, `Style=Secondary`\n- Combine: `components(method:"create", type:"variant_set", items:[{componentIds:[...], name:"Button"}])`\n- Instances pick variants via `variantProperties:{"Style":"Primary"}`\n\n### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\n\n## Slots\n\nSlots are placeholder containers inside components that instance users can fill with custom content.\n\n- Create at component root: `frames(method:"create", type:"slot", items:[{parentId:"<comp_id>", name:"Content"}])`\n- Create nested inside a frame within a component: `frames(method:"create", type:"slot", items:[{parentId:"<frame_id>", name:"Content"}])`\n- In instances, add content by using the slot\'s ID as `parentId` on any create/reparent call\n- Empty slots are normal \u2014 they don\'t trigger lint warnings\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
   "library-components": '# Working with Library Components\n\nLibrary components are read-only \u2014 they come from external team libraries and cannot be edited in the current file.\n\n## Reading\n\nWhen reading nodes, library instances appear as stubs with their overridable properties:\n```\n{name: "Header", type: "INSTANCE", componentProperties: {"Platform": "Desktop"}}\n```\n\nLibrary internals are hidden: no `componentId`, no variable names, no style names. You see resolved values (hex colors, numbers) instead.\n\n## Using\n\nPlace library instances via `instances(method:"create", items:[{componentId:"<id>"}])` when you have a local component ID. For library components, instances are already placed by the designer \u2014 interact via `instances(method:"update")` to set properties.\n\n## Customizing\n\nTo edit a library component, clone it into the local file first:\n\n```\ncomponents(method:"clone", id:"<instanceId>")\n```\n\nThis resolves the instance to its source component (or full component set) and creates a local copy with a new ID. Edit the local copy freely \u2014 it is independent of the library.\n\nDo not attempt to `components(method:"get")` or `components(method:"update")` a library component directly \u2014 these will error.\n\n## Overriding Instance Properties\n\nUse `instances(method:"update")` to change overridable properties on library instances:\n```\ninstances(method:"update", items:[{id:"<instanceId>", properties:{"Label":"New Text", "State":"Hover"}}])\n```\n\nProperty names are clean (no hash suffixes needed for update \u2014 the system resolves partial keys).',
   "responsive-designs": '# Responsive Sizing\n\n## Workflow: Top-Down Sizing\n\nBuild layouts from the outside in:\n\n1. **Set the container first.** Every container needs an explicit width \u2014 either `width` + `layoutSizingHorizontal:"FIXED"` for shells and bounded panels, or `layoutSizingHorizontal:"FILL"` inside an auto-layout parent. Set `layoutMode` (VERTICAL or HORIZONTAL) and spacing/padding.\n2. **Children fill the container.** Use `layoutSizingHorizontal:"FILL"` on children so they stretch to the available space. Use `layoutSizingVertical:"HUG"` so height follows content.\n3. **Only leaves use HUG on both axes.** Buttons, badges, icons \u2014 elements with short, predictable content that should shrink-wrap.\n\nThis ensures every level of the tree has a clear width constraint. Text wraps, FILL children stretch, and the layout adapts when the container resizes.\n\nAlways set BOTH axes explicitly on every node. Omitting sizing leads to unintended defaults.\n\n## FIXED / FILL / HUG\n\n- **FIXED** \u2014 explicit bounded widths: page shell, sidebar, modal max-width, specimen frames\n- **FILL** \u2014 children that adapt to parent: cards, rows, panels, nav stacks, text that should wrap. Use `minWidth`/`maxWidth` for responsive constraints.\n- **HUG** \u2014 content-sized leaves only: icons, badges, pills, button labels\n\n## Anti-patterns: HUG/HUG\n\nHUG on both axes is the most common cause of broken layouts. It means "shrink to fit my content on both axes" \u2014 the container has no opinion about its own size and collapses to whatever its children measure.\n\n**Why HUG/HUG breaks designs:**\n\n1. **Text never wraps.** A HUG-width container grows to fit the longest text line. Body text becomes a single very long line instead of wrapping at a readable width. The design looks correct with short placeholder text but breaks with real content.\n\n2. **Layouts don\'t adapt.** HUG/HUG containers ignore their parent\'s width. A card inside a responsive column won\'t stretch to fill available space \u2014 it stays at its content width, leaving gaps or overflowing.\n\n3. **FILL children become under-constrained.** A child with `layoutSizingHorizontal:"FILL"` inside a HUG-width parent has no space to fill \u2014 the parent defers its width to its children, but the FILL child defers its width to the parent. The result is under-constrained sizing that produces unpredictable or collapsed layouts.\n\n4. **Cascading failures.** One HUG/HUG container at the top of a tree forces every child to resolve its own width. The entire layout becomes rigid and content-dependent instead of responsive.\n\n**HUG/HUG is only correct for:**\n- Buttons, pills, badges, chips \u2014 intrinsically-sized leaf elements with short, predictable content\n- Icon containers with fixed-size children\n- Inline tags and status indicators\n\n**For everything else, set at least one axis to FIXED or FILL:**\n- Cards, panels, list rows \u2192 `layoutSizingHorizontal:"FILL"`, vertical `HUG`. Add `minWidth`/`maxWidth` for responsive bounds.\n- Shells, sidebars, modals \u2192 `width` + `layoutSizingHorizontal:"FIXED"`, vertical `FILL` or `HUG`\n- Full-width sections \u2192 `layoutSizingHorizontal:"FILL"`, `layoutSizingVertical:"HUG"`\n\n## Wrapping Layouts (layoutWrap)\n\n`layoutWrap: WRAP` enables children to flow into new rows when they exceed the container width \u2014 like CSS `flex-wrap`. This only works with **HORIZONTAL** auto-layout. Figma does not support wrap on VERTICAL layouts.\n\n**When to use wrap:**\n- Card grids with a fixed number of columns at a known width\n- Tag/chip collections where items flow into multiple rows\n- Any layout where items should reflow based on available width\n\n**Horizontal wrap pattern:**\n```\nframes.create(type: "auto_layout", layoutMode: "HORIZONTAL", layoutWrap: "WRAP",\n  itemSpacing: "space/16", counterAxisSpacing: "space/16")\n```\nChildren use FIXED width to control column count. `counterAxisSpacing` sets the gap between wrapped rows.\n\n**Vertical grid alternative:**\nSince VERTICAL layouts cannot wrap, build column-based grids by nesting VERTICAL columns inside a HORIZONTAL parent:\n```\nouter (HORIZONTAL, itemSpacing: 20, FILL width)\n  col-1 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n  col-2 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n  col-3 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n```\nEach column gets equal width via FILL. Reparent items into columns for column-first ordering. This handles variable card heights per column independently.\n\n## Component Sizing\n\nComponent roots use `FILL` when placed in a parent \u2014 they adapt to context, not a fixed specimen width. Use `FIXED` only for the specimen (the component definition itself when it needs a specific preview width).\n\nExample sidebar item:\n- Instance: `FILL` in parent nav stack\n- Icon child: fixed 18x18\n- Label child: `FILL`\n- Badge child: `HUG`\n\n## Text Sizing\n\n- Body text inside containers: prefer `FILL` width, `HUG` height (auto-wraps)\n- Single-line labels: prefer `FILL` horizontal (truncates if needed)\n- Standalone headings: `HUG` is fine\n\nInside auto-layout parents, target `layoutSizingHorizontal:"FILL"` + `layoutSizingVertical:"HUG"` + `textAutoResize:"HEIGHT"` for text that should wrap. These are not auto-applied \u2014 set them explicitly on text.create or text.update.\n\n## Checklist\n\nBefore finalizing a layout, verify:\n1. No container with text has HUG on the horizontal axis (unless it\'s a button/badge)\n2. Children use FILL on the axis that should absorb available space \u2014 not blindly on both axes. Compact controls in horizontal rows often stay HUG vertically.\n3. Top-level containers have an explicit width (FIXED) or stretch to their parent (FILL)\n4. Run `lint(method:"check", nodeId:"<rootId>", rules:["composition"])` to catch overflow-parent, unbounded-hug, and fixed-in-autolayout issues',
   "token-discipline": '# Token Discipline\n\nEvery color, spacing value, and text style should come from a design token \u2014 not hardcoded values.\n\n## Colors\n\nBind fills and strokes to color variables instead of hex values.\n\n- Fill: `fillVariableName:"bg/primary"` or `fillStyleName:"Surface/Primary"`\n- Stroke: `strokeVariableName:"border/default"`\n- Text color: `fontColorVariableName:"text/primary"`\n\nIf no matching variable exists, create one first:\n```\nvariables(method:"create", collectionId:"Colors", items:[{name:"bg/accent", type:"COLOR", valuesByMode:{"Light":"#E8F0FE","Dark":"#1A3A5C"}, scopes:["ALL_FILLS"]}])\n```\n\n## Spacing and Radius\n\nPass a variable name string instead of a number for cornerRadius, padding, itemSpacing, strokeWeight, opacity.\n\n- `cornerRadius:"radius/8"` not `cornerRadius:8`\n- `paddingTop:"space/16"` not `paddingTop:16`\n- `itemSpacing:"space/8"` not `itemSpacing:8`\n\nCreate FLOAT variables with appropriate scopes:\n```\nvariables(method:"create", collectionId:"Metrics", items:[{name:"space/12", type:"FLOAT", value:12, scopes:["GAP","WIDTH_HEIGHT"]}])\n```\n\n## Text Styles\n\nApply text styles by name \u2014 don\'t set fontSize/fontFamily/fontWeight manually.\n\n- `textStyleName:"Body/M"` on text.create or frames.update\n- Create styles with `styles(method:"create", type:"text", items:[{name:"Body/M", fontFamily:"Inter", fontSize:14, lineHeight:{value:20, unit:"PIXELS"}}])`\n\n## Common Scopes\n\nCOLOR variables:\n- `ALL_FILLS` \u2014 background fills\n- `TEXT_FILL` \u2014 text color\n- `STROKE_COLOR` \u2014 borders and outlines\n\nFLOAT variables:\n- `GAP`, `WIDTH_HEIGHT` \u2014 spacing and padding\n- `CORNER_RADIUS` \u2014 border radius\n- `STROKE_FLOAT` \u2014 stroke weight\n- `OPACITY` \u2014 transparency\n\n## Checking\n\nLint rules `hardcoded-color`, `hardcoded-token`, `no-text-style` catch unbound values. Run `audit` on any node to check.',

package/dist/mcp.js

@@ -390,7 +390,7 @@ Create frame-like containers
 
 Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
 
-Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg | slot)
 
   ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
@@ -609,7 +609,64 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     name (string, optional) \u2014 Layer name (default: 'SVG')
     parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
-    y (number, optional) \u2014 Y position (default: 0)`,
+    y (number, optional) \u2014 Y position (default: 0)
+
+  ## slot \u2014 Create a slot inside a component. Slots are placeholder containers that instance users fill with content. Defaults to VERTICAL auto-layout with FILL/HUG sizing \u2014 ready to receive children. Accepts all frame layout properties.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID inside the owning component. Required unless componentId is provided.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
+    height (number, optional) \u2014 Height in px (omit to shrink-to-content via HUG)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    imageUrl (string, optional) \u2014 Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills.
+    imageScaleMode (FILL | FIT | CROP | TILE, optional) \u2014 How the image is scaled within the frame (default: FILL)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)
+    layoutWrap (NO_WRAP | WRAP, optional) \u2014 Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns.
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    annotations (array, optional) \u2014 Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type.
+    componentId (string, optional) \u2014 Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.`,
       "commit": '# frames.commit\nCommit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: frames(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
     }
@@ -892,7 +949,7 @@ Methods:
 //   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
 //   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
 //   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
-//   "empty-container" \u2014 empty frames [style]
+//   "empty-container" \u2014 empty frames, excludes SLOT nodes [style]
 // Token rules [token]:
 //   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
 //   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]
@@ -1724,7 +1781,7 @@ var tools = [
   },
   {
     name: "frames",
-    description: '/** Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes \u2014 produces a same-type copy (frame\u2192frame, instance\u2192instance, component\u2192component). Instance clones reference the same source component; they do not duplicate the component definition.\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (type: frame|auto_layout|section|rectangle|ellipse|line|group|boolean_operation|svg, items: (FrameItem | AutoLayoutItem | SectionItem | RectangleItem | EllipseItem | LineItem | GroupItem | BooleanOperationItem | SvgItem)[]) \u2192 { results: {id}[] }  // Create frame-like containers\n  commit    (id) \u2192 { results: {id}[] }  // Commit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n  export    (id, format?: PNG|JPG|SVG|SVG_STRING|PDF, scale?) \u2192 { imageData?, mimeType? }  // Export a node as PNG, JPG, SVG, SVG_STRING, or PDF\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    description: '/** Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes \u2014 produces a same-type copy (frame\u2192frame, instance\u2192instance, component\u2192component). Instance clones reference the same source component; they do not duplicate the component definition.\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (type: frame|auto_layout|section|rectangle|ellipse|line|group|boolean_operation|svg|slot, items: (FrameItem | AutoLayoutItem | SectionItem | RectangleItem | EllipseItem | LineItem | GroupItem | BooleanOperationItem | SvgItem | SlotItem)[]) \u2192 { results: {id}[] }  // Create frame-like containers\n  commit    (id) \u2192 { results: {id}[] }  // Commit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n  export    (id, format?: PNG|JPG|SVG|SVG_STRING|PDF, scale?) \u2192 { imageData?, mimeType? }  // Export a node as PNG, JPG, SVG, SVG_STRING, or PDF\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
     schema: (caps2) => filterMethodsByTier({
       method: z3.enum(["get", "list", "update", "delete", "clone", "audit", "reparent", "create", "commit", "export", "help"]),
       id: z3.string().optional().describe("Node ID"),
@@ -1745,7 +1802,7 @@ var tools = [
       maxFindings: z3.coerce.number().optional().describe("Max findings (default: 50)"),
       minSeverity: z3.enum(["error", "unsafe", "heuristic", "style", "verbose"]).optional().describe("Minimum severity to report (default: style). Set to 'verbose' to include AAA contrast and line-height checks."),
       skipInstances: flexBool(z3.boolean()).optional().describe("Skip instance internals \u2014 findings inside instances are owned by the component (default: true)"),
-      type: z3.enum(["frame", "auto_layout", "section", "rectangle", "ellipse", "line", "group", "boolean_operation", "svg"]).optional().describe("Discriminant for create method"),
+      type: z3.enum(["frame", "auto_layout", "section", "rectangle", "ellipse", "line", "group", "boolean_operation", "svg", "slot"]).optional().describe("Discriminant for create method"),
       format: z3.enum(["PNG", "JPG", "SVG", "SVG_STRING", "PDF"]).optional().describe("Export format (default: PNG). SVG_STRING returns raw SVG text."),
       scale: z3.coerce.number().optional().describe("Export scale (default: 1, only for PNG/JPG)"),
       topic: z3.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
@@ -1978,6 +2035,63 @@ var tools = [
             parentId: z3.string().optional().describe("Parent node ID. Omit to place at current page root."),
             x: z3.coerce.number().optional().describe("X position (default: 0)"),
             y: z3.coerce.number().optional().describe("Y position (default: 0)")
+          }).passthrough(),
+          "slot": z3.object({
+            name: z3.string().optional().describe("Node name"),
+            parentId: z3.string().optional().describe("Parent node ID inside the owning component. Required unless componentId is provided."),
+            x: z3.coerce.number().optional().describe("X position (default: 0)"),
+            y: z3.coerce.number().optional().describe("Y position (default: 0)"),
+            width: z3.coerce.number().optional().describe("Width in px (omit to shrink-to-content via HUG)"),
+            height: z3.coerce.number().optional().describe("Height in px (omit to shrink-to-content via HUG)"),
+            rotation: z3.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            visible: flexBool(z3.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(z3.boolean()).optional().describe("Lock/unlock (default false)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            blendMode: z3.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            effectStyleName: z3.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            fills: z3.array(z3.record(z3.string(), z3.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: z3.string().optional().describe("Paint style name for fill"),
+            fillVariableName: z3.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            imageUrl: z3.string().optional().describe("Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills."),
+            imageScaleMode: z3.enum(["FILL", "FIT", "CROP", "TILE"]).optional().describe("How the image is scaled within the frame (default: FILL)"),
+            strokes: z3.array(z3.record(z3.string(), z3.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: z3.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: z3.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: z3.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            layoutMode: z3.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)"),
+            layoutWrap: z3.enum(["NO_WRAP", "WRAP"]).optional().describe("Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns."),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: z3.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: z3.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            strokesIncludedInLayout: flexBool(z3.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            overflowDirection: z3.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            layoutPositioning: z3.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            layoutSizingHorizontal: z3.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: z3.enum(["FIXED", "HUG", "FILL"]).optional(),
+            minWidth: z3.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: z3.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: z3.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: z3.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            annotations: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe("Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type."),
+            componentId: z3.string().optional().describe("Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.")
           }).passthrough()
         };
         const s = params.type && schemas[params.type];
@@ -3010,7 +3124,7 @@ var guidelinesList = [
   }
 ];
 var guidelinesContent = {
-  "component-structure": '# Component Structure\n\nComponents need correct sizing, property bindings, and token usage to work well as instances.\n\n## Width Constraints\n\nComponents with text content need a width \u2014 otherwise text never wraps.\n\n- Set `width` and `layoutSizingHorizontal:"FIXED"` on cards, panels, list items\n- HUG on both axes is only correct for buttons, badges, icons \u2014 intrinsically-sized elements\n\n## Property Bindings\n\nEvery text node inside a component should be bound to a TEXT property so instances can edit the content.\n\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- After creation: `frames(method:"update", items:[{id:"<textNodeId>", componentPropertyName:"<propName>"}])`\n- For existing nodes with many text children: `components(method:"create", type:"from_node", exposeText:true)`\n\nOrphaned properties (defined but not bound to any node) should be deleted:\n```\ncomponents(method:"update", items:[{id, propertyName:"<key>", action:"delete"}])\n```\n\n## Variant Sets\n\nGroup related components as variants \u2014 don\'t leave them as separate components.\n\n- Name variants with the property format: `Style=Primary`, `Style=Secondary`\n- Combine: `components(method:"create", type:"variant_set", items:[{componentIds:[...], name:"Button"}])`\n- Instances pick variants via `variantProperties:{"Style":"Primary"}`\n\n### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
+  "component-structure": '# Component Structure\n\nComponents need correct sizing, property bindings, and token usage to work well as instances.\n\n## Width Constraints\n\nComponents with text content need a width \u2014 otherwise text never wraps.\n\n- Set `width` and `layoutSizingHorizontal:"FIXED"` on cards, panels, list items\n- HUG on both axes is only correct for buttons, badges, icons \u2014 intrinsically-sized elements\n\n## Property Bindings\n\nEvery text node inside a component should be bound to a TEXT property so instances can edit the content.\n\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- After creation: `frames(method:"update", items:[{id:"<textNodeId>", componentPropertyName:"<propName>"}])`\n- For existing nodes with many text children: `components(method:"create", type:"from_node", exposeText:true)`\n\nOrphaned properties (defined but not bound to any node) should be deleted:\n```\ncomponents(method:"update", items:[{id, propertyName:"<key>", action:"delete"}])\n```\n\n## Variant Sets\n\nGroup related components as variants \u2014 don\'t leave them as separate components.\n\n- Name variants with the property format: `Style=Primary`, `Style=Secondary`\n- Combine: `components(method:"create", type:"variant_set", items:[{componentIds:[...], name:"Button"}])`\n- Instances pick variants via `variantProperties:{"Style":"Primary"}`\n\n### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\n\n## Slots\n\nSlots are placeholder containers inside components that instance users can fill with custom content.\n\n- Create at component root: `frames(method:"create", type:"slot", items:[{parentId:"<comp_id>", name:"Content"}])`\n- Create nested inside a frame within a component: `frames(method:"create", type:"slot", items:[{parentId:"<frame_id>", name:"Content"}])`\n- In instances, add content by using the slot\'s ID as `parentId` on any create/reparent call\n- Empty slots are normal \u2014 they don\'t trigger lint warnings\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
   "library-components": '# Working with Library Components\n\nLibrary components are read-only \u2014 they come from external team libraries and cannot be edited in the current file.\n\n## Reading\n\nWhen reading nodes, library instances appear as stubs with their overridable properties:\n```\n{name: "Header", type: "INSTANCE", componentProperties: {"Platform": "Desktop"}}\n```\n\nLibrary internals are hidden: no `componentId`, no variable names, no style names. You see resolved values (hex colors, numbers) instead.\n\n## Using\n\nPlace library instances via `instances(method:"create", items:[{componentId:"<id>"}])` when you have a local component ID. For library components, instances are already placed by the designer \u2014 interact via `instances(method:"update")` to set properties.\n\n## Customizing\n\nTo edit a library component, clone it into the local file first:\n\n```\ncomponents(method:"clone", id:"<instanceId>")\n```\n\nThis resolves the instance to its source component (or full component set) and creates a local copy with a new ID. Edit the local copy freely \u2014 it is independent of the library.\n\nDo not attempt to `components(method:"get")` or `components(method:"update")` a library component directly \u2014 these will error.\n\n## Overriding Instance Properties\n\nUse `instances(method:"update")` to change overridable properties on library instances:\n```\ninstances(method:"update", items:[{id:"<instanceId>", properties:{"Label":"New Text", "State":"Hover"}}])\n```\n\nProperty names are clean (no hash suffixes needed for update \u2014 the system resolves partial keys).',
   "responsive-designs": '# Responsive Sizing\n\n## Workflow: Top-Down Sizing\n\nBuild layouts from the outside in:\n\n1. **Set the container first.** Every container needs an explicit width \u2014 either `width` + `layoutSizingHorizontal:"FIXED"` for shells and bounded panels, or `layoutSizingHorizontal:"FILL"` inside an auto-layout parent. Set `layoutMode` (VERTICAL or HORIZONTAL) and spacing/padding.\n2. **Children fill the container.** Use `layoutSizingHorizontal:"FILL"` on children so they stretch to the available space. Use `layoutSizingVertical:"HUG"` so height follows content.\n3. **Only leaves use HUG on both axes.** Buttons, badges, icons \u2014 elements with short, predictable content that should shrink-wrap.\n\nThis ensures every level of the tree has a clear width constraint. Text wraps, FILL children stretch, and the layout adapts when the container resizes.\n\nAlways set BOTH axes explicitly on every node. Omitting sizing leads to unintended defaults.\n\n## FIXED / FILL / HUG\n\n- **FIXED** \u2014 explicit bounded widths: page shell, sidebar, modal max-width, specimen frames\n- **FILL** \u2014 children that adapt to parent: cards, rows, panels, nav stacks, text that should wrap. Use `minWidth`/`maxWidth` for responsive constraints.\n- **HUG** \u2014 content-sized leaves only: icons, badges, pills, button labels\n\n## Anti-patterns: HUG/HUG\n\nHUG on both axes is the most common cause of broken layouts. It means "shrink to fit my content on both axes" \u2014 the container has no opinion about its own size and collapses to whatever its children measure.\n\n**Why HUG/HUG breaks designs:**\n\n1. **Text never wraps.** A HUG-width container grows to fit the longest text line. Body text becomes a single very long line instead of wrapping at a readable width. The design looks correct with short placeholder text but breaks with real content.\n\n2. **Layouts don\'t adapt.** HUG/HUG containers ignore their parent\'s width. A card inside a responsive column won\'t stretch to fill available space \u2014 it stays at its content width, leaving gaps or overflowing.\n\n3. **FILL children become under-constrained.** A child with `layoutSizingHorizontal:"FILL"` inside a HUG-width parent has no space to fill \u2014 the parent defers its width to its children, but the FILL child defers its width to the parent. The result is under-constrained sizing that produces unpredictable or collapsed layouts.\n\n4. **Cascading failures.** One HUG/HUG container at the top of a tree forces every child to resolve its own width. The entire layout becomes rigid and content-dependent instead of responsive.\n\n**HUG/HUG is only correct for:**\n- Buttons, pills, badges, chips \u2014 intrinsically-sized leaf elements with short, predictable content\n- Icon containers with fixed-size children\n- Inline tags and status indicators\n\n**For everything else, set at least one axis to FIXED or FILL:**\n- Cards, panels, list rows \u2192 `layoutSizingHorizontal:"FILL"`, vertical `HUG`. Add `minWidth`/`maxWidth` for responsive bounds.\n- Shells, sidebars, modals \u2192 `width` + `layoutSizingHorizontal:"FIXED"`, vertical `FILL` or `HUG`\n- Full-width sections \u2192 `layoutSizingHorizontal:"FILL"`, `layoutSizingVertical:"HUG"`\n\n## Wrapping Layouts (layoutWrap)\n\n`layoutWrap: WRAP` enables children to flow into new rows when they exceed the container width \u2014 like CSS `flex-wrap`. This only works with **HORIZONTAL** auto-layout. Figma does not support wrap on VERTICAL layouts.\n\n**When to use wrap:**\n- Card grids with a fixed number of columns at a known width\n- Tag/chip collections where items flow into multiple rows\n- Any layout where items should reflow based on available width\n\n**Horizontal wrap pattern:**\n```\nframes.create(type: "auto_layout", layoutMode: "HORIZONTAL", layoutWrap: "WRAP",\n  itemSpacing: "space/16", counterAxisSpacing: "space/16")\n```\nChildren use FIXED width to control column count. `counterAxisSpacing` sets the gap between wrapped rows.\n\n**Vertical grid alternative:**\nSince VERTICAL layouts cannot wrap, build column-based grids by nesting VERTICAL columns inside a HORIZONTAL parent:\n```\nouter (HORIZONTAL, itemSpacing: 20, FILL width)\n  col-1 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n  col-2 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n  col-3 (VERTICAL, FILL width, HUG height, itemSpacing: 20)\n```\nEach column gets equal width via FILL. Reparent items into columns for column-first ordering. This handles variable card heights per column independently.\n\n## Component Sizing\n\nComponent roots use `FILL` when placed in a parent \u2014 they adapt to context, not a fixed specimen width. Use `FIXED` only for the specimen (the component definition itself when it needs a specific preview width).\n\nExample sidebar item:\n- Instance: `FILL` in parent nav stack\n- Icon child: fixed 18x18\n- Label child: `FILL`\n- Badge child: `HUG`\n\n## Text Sizing\n\n- Body text inside containers: prefer `FILL` width, `HUG` height (auto-wraps)\n- Single-line labels: prefer `FILL` horizontal (truncates if needed)\n- Standalone headings: `HUG` is fine\n\nInside auto-layout parents, target `layoutSizingHorizontal:"FILL"` + `layoutSizingVertical:"HUG"` + `textAutoResize:"HEIGHT"` for text that should wrap. These are not auto-applied \u2014 set them explicitly on text.create or text.update.\n\n## Checklist\n\nBefore finalizing a layout, verify:\n1. No container with text has HUG on the horizontal axis (unless it\'s a button/badge)\n2. Children use FILL on the axis that should absorb available space \u2014 not blindly on both axes. Compact controls in horizontal rows often stay HUG vertically.\n3. Top-level containers have an explicit width (FIXED) or stretch to their parent (FILL)\n4. Run `lint(method:"check", nodeId:"<rootId>", rules:["composition"])` to catch overflow-parent, unbounded-hug, and fixed-in-autolayout issues',
   "token-discipline": '# Token Discipline\n\nEvery color, spacing value, and text style should come from a design token \u2014 not hardcoded values.\n\n## Colors\n\nBind fills and strokes to color variables instead of hex values.\n\n- Fill: `fillVariableName:"bg/primary"` or `fillStyleName:"Surface/Primary"`\n- Stroke: `strokeVariableName:"border/default"`\n- Text color: `fontColorVariableName:"text/primary"`\n\nIf no matching variable exists, create one first:\n```\nvariables(method:"create", collectionId:"Colors", items:[{name:"bg/accent", type:"COLOR", valuesByMode:{"Light":"#E8F0FE","Dark":"#1A3A5C"}, scopes:["ALL_FILLS"]}])\n```\n\n## Spacing and Radius\n\nPass a variable name string instead of a number for cornerRadius, padding, itemSpacing, strokeWeight, opacity.\n\n- `cornerRadius:"radius/8"` not `cornerRadius:8`\n- `paddingTop:"space/16"` not `paddingTop:16`\n- `itemSpacing:"space/8"` not `itemSpacing:8`\n\nCreate FLOAT variables with appropriate scopes:\n```\nvariables(method:"create", collectionId:"Metrics", items:[{name:"space/12", type:"FLOAT", value:12, scopes:["GAP","WIDTH_HEIGHT"]}])\n```\n\n## Text Styles\n\nApply text styles by name \u2014 don\'t set fontSize/fontFamily/fontWeight manually.\n\n- `textStyleName:"Body/M"` on text.create or frames.update\n- Create styles with `styles(method:"create", type:"text", items:[{name:"Body/M", fontFamily:"Inter", fontSize:14, lineHeight:{value:20, unit:"PIXELS"}}])`\n\n## Common Scopes\n\nCOLOR variables:\n- `ALL_FILLS` \u2014 background fills\n- `TEXT_FILL` \u2014 text color\n- `STROKE_COLOR` \u2014 borders and outlines\n\nFLOAT variables:\n- `GAP`, `WIDTH_HEIGHT` \u2014 spacing and padding\n- `CORNER_RADIUS` \u2014 border radius\n- `STROKE_FLOAT` \u2014 stroke weight\n- `OPACITY` \u2014 transparency\n\n## Checking\n\nLint rules `hardcoded-color`, `hardcoded-token`, `no-text-style` catch unbound values. Run `audit` on any node to check.',

package/dist/tools/generated/guards.cjs

@@ -35,6 +35,7 @@ __export(guards_exports, {
   framesCreateLine: () => framesCreateLine,
   framesCreateRectangle: () => framesCreateRectangle,
   framesCreateSection: () => framesCreateSection,
+  framesCreateSlot: () => framesCreateSlot,
   framesCreateSvg: () => framesCreateSvg,
   instancesCreate: () => instancesCreate,
   instancesDetach: () => instancesDetach,
@@ -499,6 +500,63 @@ var framesCreateSvg = /* @__PURE__ */ new Set([
   "x",
   "y"
 ]);
+var framesCreateSlot = /* @__PURE__ */ new Set([
+  "annotations",
+  "blendMode",
+  "bottomLeftRadius",
+  "bottomRightRadius",
+  "componentId",
+  "cornerRadius",
+  "counterAxisAlignItems",
+  "counterAxisSpacing",
+  "effectStyleName",
+  "fillColor",
+  "fillStyleName",
+  "fillVariableName",
+  "fills",
+  "height",
+  "imageScaleMode",
+  "imageUrl",
+  "itemSpacing",
+  "layoutMode",
+  "layoutPositioning",
+  "layoutSizingHorizontal",
+  "layoutSizingVertical",
+  "layoutWrap",
+  "locked",
+  "maxHeight",
+  "maxWidth",
+  "minHeight",
+  "minWidth",
+  "name",
+  "opacity",
+  "overflowDirection",
+  "padding",
+  "paddingBottom",
+  "paddingLeft",
+  "paddingRight",
+  "paddingTop",
+  "parentId",
+  "primaryAxisAlignItems",
+  "rotation",
+  "strokeAlign",
+  "strokeBottomWeight",
+  "strokeColor",
+  "strokeLeftWeight",
+  "strokeRightWeight",
+  "strokeStyleName",
+  "strokeTopWeight",
+  "strokeVariableName",
+  "strokeWeight",
+  "strokes",
+  "strokesIncludedInLayout",
+  "topLeftRadius",
+  "topRightRadius",
+  "visible",
+  "width",
+  "x",
+  "y"
+]);
 var instancesCreate = /* @__PURE__ */ new Set([
   "blendMode",
   "componentId",
@@ -853,6 +911,7 @@ var mixinVectorStyleParams = /* @__PURE__ */ new Set(["fillStyleName", "fillVari
   framesCreateLine,
   framesCreateRectangle,
   framesCreateSection,
+  framesCreateSlot,
   framesCreateSvg,
   instancesCreate,
   instancesDetach,

package/dist/tools/generated/guards.d.cts

@@ -40,6 +40,8 @@ declare const framesCreateGroup: ReadonlySet<string>;
 declare const framesCreateBooleanOperation: ReadonlySet<string>;
 /** frames create type="svg" */
 declare const framesCreateSvg: ReadonlySet<string>;
+/** frames create type="slot" */
+declare const framesCreateSlot: ReadonlySet<string>;
 /** instances.create item params */
 declare const instancesCreate: ReadonlySet<string>;
 /** instances.update item params */
@@ -111,4 +113,4 @@ declare const mixinTextParams: ReadonlySet<string>;
 /** vector_style_params */
 declare const mixinVectorStyleParams: ReadonlySet<string>;
 
-export { annotationsAdd, annotationsGet, annotationsRemove, annotationsSet, componentsCreateComponent, componentsCreateFromNode, componentsCreateVariantSet, componentsUpdate, framesCreateAutoLayout, framesCreateBooleanOperation, framesCreateEllipse, framesCreateFrame, framesCreateGroup, framesCreateLine, framesCreateRectangle, framesCreateSection, framesCreateSvg, instancesCreate, instancesDetach, instancesResetOverrides, instancesSwap, instancesUpdate, lintFix, mixinAutoLayoutParams, mixinBlendParams, mixinCornerParams, mixinFillParams, mixinFrameParams, mixinGeometryParams, mixinSceneParams, mixinSizingParams, mixinStrokeParams, mixinTextParams, mixinVectorStyleParams, nodeClone, nodeDelete, nodeReparent, nodeUpdate, prototypingAdd, stylesCreateEffect, stylesCreateGrid, stylesCreatePaint, stylesCreateText, stylesDelete, stylesUpdate, textCreate, textSetContent, variableCollectionsAddMode, variableCollectionsCreate, variableCollectionsDelete, variableCollectionsRemoveMode, variableCollectionsRenameMode, variableCollectionsUpdate, variablesCreate, variablesDelete, variablesUpdate };
+export { annotationsAdd, annotationsGet, annotationsRemove, annotationsSet, componentsCreateComponent, componentsCreateFromNode, componentsCreateVariantSet, componentsUpdate, framesCreateAutoLayout, framesCreateBooleanOperation, framesCreateEllipse, framesCreateFrame, framesCreateGroup, framesCreateLine, framesCreateRectangle, framesCreateSection, framesCreateSlot, framesCreateSvg, instancesCreate, instancesDetach, instancesResetOverrides, instancesSwap, instancesUpdate, lintFix, mixinAutoLayoutParams, mixinBlendParams, mixinCornerParams, mixinFillParams, mixinFrameParams, mixinGeometryParams, mixinSceneParams, mixinSizingParams, mixinStrokeParams, mixinTextParams, mixinVectorStyleParams, nodeClone, nodeDelete, nodeReparent, nodeUpdate, prototypingAdd, stylesCreateEffect, stylesCreateGrid, stylesCreatePaint, stylesCreateText, stylesDelete, stylesUpdate, textCreate, textSetContent, variableCollectionsAddMode, variableCollectionsCreate, variableCollectionsDelete, variableCollectionsRemoveMode, variableCollectionsRenameMode, variableCollectionsUpdate, variablesCreate, variablesDelete, variablesUpdate };

package/dist/tools/generated/guards.d.ts

@@ -40,6 +40,8 @@ declare const framesCreateGroup: ReadonlySet<string>;
 declare const framesCreateBooleanOperation: ReadonlySet<string>;
 /** frames create type="svg" */
 declare const framesCreateSvg: ReadonlySet<string>;
+/** frames create type="slot" */
+declare const framesCreateSlot: ReadonlySet<string>;
 /** instances.create item params */
 declare const instancesCreate: ReadonlySet<string>;
 /** instances.update item params */
@@ -111,4 +113,4 @@ declare const mixinTextParams: ReadonlySet<string>;
 /** vector_style_params */
 declare const mixinVectorStyleParams: ReadonlySet<string>;
 
-export { annotationsAdd, annotationsGet, annotationsRemove, annotationsSet, componentsCreateComponent, componentsCreateFromNode, componentsCreateVariantSet, componentsUpdate, framesCreateAutoLayout, framesCreateBooleanOperation, framesCreateEllipse, framesCreateFrame, framesCreateGroup, framesCreateLine, framesCreateRectangle, framesCreateSection, framesCreateSvg, instancesCreate, instancesDetach, instancesResetOverrides, instancesSwap, instancesUpdate, lintFix, mixinAutoLayoutParams, mixinBlendParams, mixinCornerParams, mixinFillParams, mixinFrameParams, mixinGeometryParams, mixinSceneParams, mixinSizingParams, mixinStrokeParams, mixinTextParams, mixinVectorStyleParams, nodeClone, nodeDelete, nodeReparent, nodeUpdate, prototypingAdd, stylesCreateEffect, stylesCreateGrid, stylesCreatePaint, stylesCreateText, stylesDelete, stylesUpdate, textCreate, textSetContent, variableCollectionsAddMode, variableCollectionsCreate, variableCollectionsDelete, variableCollectionsRemoveMode, variableCollectionsRenameMode, variableCollectionsUpdate, variablesCreate, variablesDelete, variablesUpdate };
+export { annotationsAdd, annotationsGet, annotationsRemove, annotationsSet, componentsCreateComponent, componentsCreateFromNode, componentsCreateVariantSet, componentsUpdate, framesCreateAutoLayout, framesCreateBooleanOperation, framesCreateEllipse, framesCreateFrame, framesCreateGroup, framesCreateLine, framesCreateRectangle, framesCreateSection, framesCreateSlot, framesCreateSvg, instancesCreate, instancesDetach, instancesResetOverrides, instancesSwap, instancesUpdate, lintFix, mixinAutoLayoutParams, mixinBlendParams, mixinCornerParams, mixinFillParams, mixinFrameParams, mixinGeometryParams, mixinSceneParams, mixinSizingParams, mixinStrokeParams, mixinTextParams, mixinVectorStyleParams, nodeClone, nodeDelete, nodeReparent, nodeUpdate, prototypingAdd, stylesCreateEffect, stylesCreateGrid, stylesCreatePaint, stylesCreateText, stylesDelete, stylesUpdate, textCreate, textSetContent, variableCollectionsAddMode, variableCollectionsCreate, variableCollectionsDelete, variableCollectionsRemoveMode, variableCollectionsRenameMode, variableCollectionsUpdate, variablesCreate, variablesDelete, variablesUpdate };

package/dist/tools/generated/guards.js

@@ -421,6 +421,63 @@ var framesCreateSvg = /* @__PURE__ */ new Set([
   "x",
   "y"
 ]);
+var framesCreateSlot = /* @__PURE__ */ new Set([
+  "annotations",
+  "blendMode",
+  "bottomLeftRadius",
+  "bottomRightRadius",
+  "componentId",
+  "cornerRadius",
+  "counterAxisAlignItems",
+  "counterAxisSpacing",
+  "effectStyleName",
+  "fillColor",
+  "fillStyleName",
+  "fillVariableName",
+  "fills",
+  "height",
+  "imageScaleMode",
+  "imageUrl",
+  "itemSpacing",
+  "layoutMode",
+  "layoutPositioning",
+  "layoutSizingHorizontal",
+  "layoutSizingVertical",
+  "layoutWrap",
+  "locked",
+  "maxHeight",
+  "maxWidth",
+  "minHeight",
+  "minWidth",
+  "name",
+  "opacity",
+  "overflowDirection",
+  "padding",
+  "paddingBottom",
+  "paddingLeft",
+  "paddingRight",
+  "paddingTop",
+  "parentId",
+  "primaryAxisAlignItems",
+  "rotation",
+  "strokeAlign",
+  "strokeBottomWeight",
+  "strokeColor",
+  "strokeLeftWeight",
+  "strokeRightWeight",
+  "strokeStyleName",
+  "strokeTopWeight",
+  "strokeVariableName",
+  "strokeWeight",
+  "strokes",
+  "strokesIncludedInLayout",
+  "topLeftRadius",
+  "topRightRadius",
+  "visible",
+  "width",
+  "x",
+  "y"
+]);
 var instancesCreate = /* @__PURE__ */ new Set([
   "blendMode",
   "componentId",
@@ -774,6 +831,7 @@ export {
   framesCreateLine,
   framesCreateRectangle,
   framesCreateSection,
+  framesCreateSlot,
   framesCreateSvg,
   instancesCreate,
   instancesDetach,

package/dist/tools/registry.cjs

@@ -399,7 +399,7 @@ Create frame-like containers
 
 Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
 
-Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg | slot)
 
   ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
@@ -618,7 +618,64 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     name (string, optional) \u2014 Layer name (default: 'SVG')
     parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
-    y (number, optional) \u2014 Y position (default: 0)`,
+    y (number, optional) \u2014 Y position (default: 0)
+
+  ## slot \u2014 Create a slot inside a component. Slots are placeholder containers that instance users fill with content. Defaults to VERTICAL auto-layout with FILL/HUG sizing \u2014 ready to receive children. Accepts all frame layout properties.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID inside the owning component. Required unless componentId is provided.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
+    height (number, optional) \u2014 Height in px (omit to shrink-to-content via HUG)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    imageUrl (string, optional) \u2014 Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills.
+    imageScaleMode (FILL | FIT | CROP | TILE, optional) \u2014 How the image is scaled within the frame (default: FILL)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)
+    layoutWrap (NO_WRAP | WRAP, optional) \u2014 Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns.
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    annotations (array, optional) \u2014 Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type.
+    componentId (string, optional) \u2014 Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.`,
       "commit": '# frames.commit\nCommit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: frames(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
     }
@@ -901,7 +958,7 @@ Methods:
 //   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
 //   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
 //   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
-//   "empty-container" \u2014 empty frames [style]
+//   "empty-container" \u2014 empty frames, excludes SLOT nodes [style]
 // Token rules [token]:
 //   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
 //   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]

package/dist/tools/registry.js

@@ -376,7 +376,7 @@ Create frame-like containers
 
 Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
 
-Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg | slot)
 
   ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
@@ -595,7 +595,64 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     name (string, optional) \u2014 Layer name (default: 'SVG')
     parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
-    y (number, optional) \u2014 Y position (default: 0)`,
+    y (number, optional) \u2014 Y position (default: 0)
+
+  ## slot \u2014 Create a slot inside a component. Slots are placeholder containers that instance users fill with content. Defaults to VERTICAL auto-layout with FILL/HUG sizing \u2014 ready to receive children. Accepts all frame layout properties.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID inside the owning component. Required unless componentId is provided.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
+    height (number, optional) \u2014 Height in px (omit to shrink-to-content via HUG)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    imageUrl (string, optional) \u2014 Image source \u2014 'pexel:<id>' for Pexels photos, a public URL, or a local file path. SVGs are inserted as vectors; raster images become IMAGE fills.
+    imageScaleMode (FILL | FIT | CROP | TILE, optional) \u2014 How the image is scaled within the frame (default: FILL)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: auto \u2014 NONE when width+height set, otherwise inferred from layout props)
+    layoutWrap (NO_WRAP | WRAP, optional) \u2014 Wrap children to new rows (HORIZONTAL layout only \u2014 Figma does not support WRAP on VERTICAL layouts). Use column frames inside a HORIZONTAL parent for vertical grid patterns.
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    annotations (array, optional) \u2014 Set annotations \u2014 [{label?, labelMarkdown?, properties?, categoryId?}]. Properties validated per node type.
+    componentId (string, optional) \u2014 Owning component ID. Optional \u2014 auto-resolved from parentId by walking up ancestors.`,
       "commit": '# frames.commit\nCommit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: frames(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
     }
@@ -878,7 +935,7 @@ Methods:
 //   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
 //   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
 //   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
-//   "empty-container" \u2014 empty frames [style]
+//   "empty-container" \u2014 empty frames, excludes SLOT nodes [style]
 // Token rules [token]:
 //   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
 //   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ufira/vibma",
   "description": "Vibma — Vibe Design meets Figma. AI-powered MCP bridge for designing in Figma.",
-  "version": "1.1.3-rc1",
+  "version": "1.1.3-rc2",
   "license": "MIT",
   "author": "ufira <https://github.com/ufira-ai>",
   "homepage": "https://github.com/ufira-ai/vibma",