@ufira/vibma 1.0.0-rc1 → 1.0.0-rc2

package/dist/mcp.cjs

@@ -117,8 +117,8 @@ Discriminant: type (component | from_node | variant_set)
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -146,7 +146,7 @@ Discriminant: type (component | from_node | variant_set)
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -165,7 +165,7 @@ Discriminant: type (component | from_node | variant_set)
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     description (string, optional) \u2014 Component description (shown in Figma's component panel)
-    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. Component: {type:"component", name, children?}. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property.
     properties (array, optional) \u2014 Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.
       propertyName (string, required) \u2014 Property name
       type (BOOLEAN | TEXT | INSTANCE_SWAP, required) \u2014 Property type
@@ -181,8 +181,8 @@ Discriminant: type (component | from_node | variant_set)
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -210,7 +210,7 @@ Discriminant: type (component | from_node | variant_set)
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -228,8 +228,9 @@ Discriminant: type (component | from_node | variant_set)
     minHeight (number, optional) \u2014 Min height for responsive auto-layout
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
-    componentIds (string[], required) \u2014 Component IDs to combine (min 2)
-    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')`,
+    componentIds (string[], optional) \u2014 Existing component IDs to combine (min 2). Alternative to children.
+    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')
+    children (array, optional) \u2014 Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.`,
       "update": '# components.update\nAdd, edit, or delete component properties\n\nExample: components(method:"update", items:[{id:"1:23", propertyName:"Label", action:"edit", defaultValue:"Click Me"}])\n\nParams:\n    items (UpdatePropertyItem[], required) \u2014 Array of {id, propertyName, action?, type?, defaultValue?, name?, preferredValues?}\n      id (string, required) \u2014 Component or component set ID\n      propertyName (string, required) \u2014 Property name with #suffix for edit/delete (e.g. "Label#1:0"). Call components.get to find exact keys. For add, plain name works.\n      action (add | edit | delete | rename_variant, optional) \u2014 "add" (default): requires type + defaultValue. "edit": pass defaultValue to change default, name to rename property. "delete": just propertyName. "rename_variant": pass defaultValue=current option name, name=new option name.\n      type (BOOLEAN | TEXT | INSTANCE_SWAP | VARIANT, optional) \u2014 Property type (required for add)\n      defaultValue (string_or_boolean, optional) \u2014 Default value (add/edit). For rename_variant: the CURRENT option name to rename\n      name (string, optional) \u2014 New name \u2014 for edit: renames the property itself, for rename_variant: the new option value name\n      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.',
       "delete": "# components.delete\nDelete components or component sets\n\nParams:\n    id (string, required) \u2014 Component or component set ID"
     }
@@ -353,13 +354,13 @@ Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", item
 
 Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
 
-  ## frame \u2014 Static frame with fixed dimensions
+  ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -387,7 +388,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -406,14 +407,15 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     clipsContent (boolean, optional)
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
 
   ## auto_layout \u2014 Auto-layout frame that arranges children automatically
     name (string, optional) \u2014 Node name
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -461,6 +463,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     clipsContent (boolean, optional)
     nodeIds (string[], optional) \u2014 Existing node IDs to wrap into auto-layout
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
 
   ## section \u2014 Figma section (top-level organizer)
     name (string, required) \u2014 Section name
@@ -1167,8 +1170,8 @@ var tools = [
             parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
@@ -1196,7 +1199,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1215,7 +1218,7 @@ var tools = [
             maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
             description: import_zod4.z.string().optional().describe("Component description (shown in Figma's component panel)"),
-            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.'),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. Component: {type:"component", name, children?}. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property.'),
             properties: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.")
           }).passthrough(),
           "from_node": import_zod4.z.object({
@@ -1227,8 +1230,8 @@ var tools = [
             parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
@@ -1256,7 +1259,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1274,8 +1277,9 @@ var tools = [
             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"),
             overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
-            componentIds: flexJson(import_zod4.z.array(import_zod4.z.string())).describe("Component IDs to combine (min 2)"),
-            variantPropertyName: import_zod4.z.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')")
+            componentIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Existing component IDs to combine (min 2). Alternative to children."),
+            variantPropertyName: import_zod4.z.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')"),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.')
           }).passthrough()
         };
         const s = params.type && schemas[params.type];
@@ -1407,8 +1411,8 @@ var tools = [
             parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
@@ -1436,7 +1440,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1454,15 +1458,16 @@ var tools = [
             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"),
             overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
-            clipsContent: flexBool(import_zod4.z.boolean()).optional()
+            clipsContent: flexBool(import_zod4.z.boolean()).optional(),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.')
           }).passthrough(),
           "auto_layout": import_zod4.z.object({
             name: import_zod4.z.string().optional().describe("Node name"),
             parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
@@ -1509,7 +1514,8 @@ var tools = [
             maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
             clipsContent: flexBool(import_zod4.z.boolean()).optional(),
-            nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Existing node IDs to wrap into auto-layout")
+            nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Existing node IDs to wrap into auto-layout"),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.')
           }).passthrough(),
           "section": import_zod4.z.object({
             name: import_zod4.z.string().describe("Section name"),

package/dist/mcp.js

@@ -95,8 +95,8 @@ Discriminant: type (component | from_node | variant_set)
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -124,7 +124,7 @@ Discriminant: type (component | from_node | variant_set)
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -143,7 +143,7 @@ Discriminant: type (component | from_node | variant_set)
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     description (string, optional) \u2014 Component description (shown in Figma's component panel)
-    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. Component: {type:"component", name, children?}. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property.
     properties (array, optional) \u2014 Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.
       propertyName (string, required) \u2014 Property name
       type (BOOLEAN | TEXT | INSTANCE_SWAP, required) \u2014 Property type
@@ -159,8 +159,8 @@ Discriminant: type (component | from_node | variant_set)
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -188,7 +188,7 @@ Discriminant: type (component | from_node | variant_set)
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -206,8 +206,9 @@ Discriminant: type (component | from_node | variant_set)
     minHeight (number, optional) \u2014 Min height for responsive auto-layout
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
-    componentIds (string[], required) \u2014 Component IDs to combine (min 2)
-    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')`,
+    componentIds (string[], optional) \u2014 Existing component IDs to combine (min 2). Alternative to children.
+    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')
+    children (array, optional) \u2014 Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.`,
       "update": '# components.update\nAdd, edit, or delete component properties\n\nExample: components(method:"update", items:[{id:"1:23", propertyName:"Label", action:"edit", defaultValue:"Click Me"}])\n\nParams:\n    items (UpdatePropertyItem[], required) \u2014 Array of {id, propertyName, action?, type?, defaultValue?, name?, preferredValues?}\n      id (string, required) \u2014 Component or component set ID\n      propertyName (string, required) \u2014 Property name with #suffix for edit/delete (e.g. "Label#1:0"). Call components.get to find exact keys. For add, plain name works.\n      action (add | edit | delete | rename_variant, optional) \u2014 "add" (default): requires type + defaultValue. "edit": pass defaultValue to change default, name to rename property. "delete": just propertyName. "rename_variant": pass defaultValue=current option name, name=new option name.\n      type (BOOLEAN | TEXT | INSTANCE_SWAP | VARIANT, optional) \u2014 Property type (required for add)\n      defaultValue (string_or_boolean, optional) \u2014 Default value (add/edit). For rename_variant: the CURRENT option name to rename\n      name (string, optional) \u2014 New name \u2014 for edit: renames the property itself, for rename_variant: the new option value name\n      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.',
       "delete": "# components.delete\nDelete components or component sets\n\nParams:\n    id (string, required) \u2014 Component or component set ID"
     }
@@ -331,13 +332,13 @@ Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", item
 
 Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
 
-  ## frame \u2014 Static frame with fixed dimensions
+  ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -365,7 +366,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     bottomRightRadius (string, optional)
     bottomLeftRadius (string, optional)
     effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
-    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    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)
     padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
     paddingTop (string, optional)
@@ -384,14 +385,15 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     maxHeight (number, optional) \u2014 Max height for responsive auto-layout
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     clipsContent (boolean, optional)
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
 
   ## auto_layout \u2014 Auto-layout frame that arranges children automatically
     name (string, optional) \u2014 Node name
     parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
-    width (number, optional) \u2014 Width (default: 100)
-    height (number, optional) \u2014 Height (default: 100)
+    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)
     opacity (string, optional) \u2014 Opacity (0-1) or variable name
     visible (boolean, optional) \u2014 Show/hide (default true)
@@ -439,6 +441,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
     clipsContent (boolean, optional)
     nodeIds (string[], optional) \u2014 Existing node IDs to wrap into auto-layout
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
 
   ## section \u2014 Figma section (top-level organizer)
     name (string, required) \u2014 Section name
@@ -1145,8 +1148,8 @@ var tools = [
             parentId: z3.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: z3.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(z3.boolean()).optional().describe("Show/hide (default true)"),
@@ -1174,7 +1177,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: z3.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: z3.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1193,7 +1196,7 @@ var tools = [
             maxHeight: z3.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: z3.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
             description: z3.string().optional().describe("Component description (shown in Figma's component panel)"),
-            children: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.'),
+            children: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. Component: {type:"component", name, children?}. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property.'),
             properties: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe("Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.")
           }).passthrough(),
           "from_node": z3.object({
@@ -1205,8 +1208,8 @@ var tools = [
             parentId: z3.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: z3.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(z3.boolean()).optional().describe("Show/hide (default true)"),
@@ -1234,7 +1237,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: z3.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: z3.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1252,8 +1255,9 @@ var tools = [
             minHeight: z3.coerce.number().optional().describe("Min height for responsive auto-layout"),
             maxHeight: z3.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: z3.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
-            componentIds: flexJson(z3.array(z3.string())).describe("Component IDs to combine (min 2)"),
-            variantPropertyName: z3.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')")
+            componentIds: flexJson(z3.array(z3.string())).optional().describe("Existing component IDs to combine (min 2). Alternative to children."),
+            variantPropertyName: z3.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')"),
+            children: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe('Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.')
           }).passthrough()
         };
         const s = params.type && schemas[params.type];
@@ -1385,8 +1389,8 @@ var tools = [
             parentId: z3.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: z3.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(z3.boolean()).optional().describe("Show/hide (default true)"),
@@ -1414,7 +1418,7 @@ var tools = [
             bottomRightRadius: token.optional(),
             bottomLeftRadius: token.optional(),
             effectStyleName: z3.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
-            layoutMode: z3.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            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(),
             padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
             paddingTop: token.optional(),
@@ -1432,15 +1436,16 @@ var tools = [
             minHeight: z3.coerce.number().optional().describe("Min height for responsive auto-layout"),
             maxHeight: z3.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: z3.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
-            clipsContent: flexBool(z3.boolean()).optional()
+            clipsContent: flexBool(z3.boolean()).optional(),
+            children: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.')
           }).passthrough(),
           "auto_layout": z3.object({
             name: z3.string().optional().describe("Node name"),
             parentId: z3.string().optional().describe("Parent node ID. Omit to place on current page."),
             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 (default: 100)"),
-            height: z3.coerce.number().optional().describe("Height (default: 100)"),
+            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)"),
             opacity: token.optional().describe("Opacity (0-1) or variable name"),
             visible: flexBool(z3.boolean()).optional().describe("Show/hide (default true)"),
@@ -1487,7 +1492,8 @@ var tools = [
             maxHeight: z3.coerce.number().optional().describe("Max height for responsive auto-layout"),
             overflowDirection: z3.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
             clipsContent: flexBool(z3.boolean()).optional(),
-            nodeIds: flexJson(z3.array(z3.string())).optional().describe("Existing node IDs to wrap into auto-layout")
+            nodeIds: flexJson(z3.array(z3.string())).optional().describe("Existing node IDs to wrap into auto-layout"),
+            children: flexJson(z3.array(z3.record(z3.string(), z3.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Instance: {type:"instance", componentId, variantProperties?, properties?}. Component: {type:"component", name, children?}. Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.')
           }).passthrough(),
           "section": z3.object({
             name: z3.string().describe("Section name"),

package/dist/tools/generated/guards.cjs

@@ -128,6 +128,7 @@ var componentsCreateVariantSet = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "componentIds",
   "cornerRadius",
   "counterAxisAlignItems",
@@ -265,6 +266,7 @@ var framesCreateFrame = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "clipsContent",
   "cornerRadius",
   "counterAxisAlignItems",
@@ -319,6 +321,7 @@ var framesCreateAutoLayout = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "clipsContent",
   "cornerRadius",
   "counterAxisAlignItems",

package/dist/tools/generated/guards.js

@@ -61,6 +61,7 @@ var componentsCreateVariantSet = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "componentIds",
   "cornerRadius",
   "counterAxisAlignItems",
@@ -198,6 +199,7 @@ var framesCreateFrame = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "clipsContent",
   "cornerRadius",
   "counterAxisAlignItems",
@@ -252,6 +254,7 @@ var framesCreateAutoLayout = /* @__PURE__ */ new Set([
   "blendMode",
   "bottomLeftRadius",
   "bottomRightRadius",
+  "children",
   "clipsContent",
   "cornerRadius",
   "counterAxisAlignItems",