@ufira/vibma 0.3.2 → 1.0.0-rc1

package/dist/tools/schemas.d.ts

@@ -18,13 +18,45 @@ declare const depth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 declare const xPos: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 /** Y position for creation tools */
 declare const yPos: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-/** RGBA color — accepts {r,g,b,a?} object (0-1) or hex string (#RGB, #RRGGBB, #RRGGBBAA) */
-declare const colorRgba: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+/** RGBA color — accepts {r,g,b,a?} object (0-1), hex string (#RGB, #RRGGBB, #RRGGBBAA), or style/variable name string */
+declare const colorRgba: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodObject<{
     r: z.ZodCoercedNumber<unknown>;
     g: z.ZodCoercedNumber<unknown>;
     b: z.ZodCoercedNumber<unknown>;
     a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>>;
+}, z.core.$strip>, z.ZodString]>>;
+/** Variable value — color (hex or RGBA), number, boolean, string, or alias */
+declare const variableValue: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodObject<{
+    r: z.ZodNumber;
+    g: z.ZodNumber;
+    b: z.ZodNumber;
+    a: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"VARIABLE_ALIAS">;
+    name: z.ZodString;
+}, z.core.$strip>]>>;
+/** Line height — number (px) or {value, unit} */
+declare const lineHeight: z.ZodUnion<readonly [z.ZodCoercedNumber<unknown>, z.ZodObject<{
+    value: z.ZodCoercedNumber<unknown>;
+    unit: z.ZodEnum<{
+        PIXELS: "PIXELS";
+        PERCENT: "PERCENT";
+        AUTO: "AUTO";
+    }>;
+}, z.core.$strip>]>;
+/** Letter spacing — number (px) or {value, unit} */
+declare const letterSpacing: z.ZodUnion<readonly [z.ZodCoercedNumber<unknown>, z.ZodObject<{
+    value: z.ZodCoercedNumber<unknown>;
+    unit: z.ZodEnum<{
+        PIXELS: "PIXELS";
+        PERCENT: "PERCENT";
+    }>;
+}, z.core.$strip>]>;
+/** String or boolean — for component property defaults */
+declare const stringOrBoolean: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+/** Design token — accepts a string that is either a numeric value ("8") or a variable name/ID ("Radii/Medium").
+ *  Numeric strings are parsed to numbers in the handler; non-numeric strings are variable references. */
+declare const token: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
 /** Single effect entry — shared by set_effects and styles create */
 declare const effectEntry: z.ZodObject<{
     type: z.ZodEnum<{
@@ -33,12 +65,12 @@ declare const effectEntry: z.ZodObject<{
         LAYER_BLUR: "LAYER_BLUR";
         BACKGROUND_BLUR: "BACKGROUND_BLUR";
     }>;
-    color: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+    color: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodUnion<readonly [z.ZodObject<{
         r: z.ZodCoercedNumber<unknown>;
         g: z.ZodCoercedNumber<unknown>;
         b: z.ZodCoercedNumber<unknown>;
         a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-    }, z.core.$strip>>>>;
+    }, z.core.$strip>, z.ZodString]>>>>;
     offset: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodObject<{
         x: z.ZodCoercedNumber<unknown>;
         y: z.ZodCoercedNumber<unknown>;
@@ -49,4 +81,4 @@ declare const effectEntry: z.ZodObject<{
     blendMode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 
-export { colorRgba, depth, effectEntry, nodeId, nodeIds, parentId, xPos, yPos };
+export { colorRgba, depth, effectEntry, letterSpacing, lineHeight, nodeId, nodeIds, parentId, stringOrBoolean, token, variableValue, xPos, yPos };

package/dist/tools/schemas.js

@@ -42,12 +42,39 @@ function parseHex(hex) {
 var colorRgba = z2.preprocess((v) => {
   if (typeof v === "string") return parseHex(v) ?? v;
   return v;
-}, z2.object({
-  r: z2.coerce.number().min(0).max(1),
-  g: z2.coerce.number().min(0).max(1),
-  b: z2.coerce.number().min(0).max(1),
-  a: z2.coerce.number().min(0).max(1).optional()
-})).describe('Hex "#FF0000" or {r,g,b,a?} with values 0-1.');
+}, z2.union([
+  z2.object({
+    r: z2.coerce.number().min(0).max(1),
+    g: z2.coerce.number().min(0).max(1),
+    b: z2.coerce.number().min(0).max(1),
+    a: z2.coerce.number().min(0).max(1).optional()
+  }),
+  z2.string()
+  // Non-hex strings pass through for handler-level style/variable resolution
+])).describe('Hex "#FF0000", {r,g,b,a?} 0-1, or style/variable name.');
+var variableValue = z2.preprocess((v) => {
+  if (typeof v === "string") return parseHex(v) ?? v;
+  return v;
+}, z2.union([
+  z2.number(),
+  z2.boolean(),
+  z2.string(),
+  z2.object({ r: z2.number(), g: z2.number(), b: z2.number(), a: z2.number().optional() }),
+  z2.object({ type: z2.literal("VARIABLE_ALIAS"), name: z2.string() })
+])).describe('number, boolean, string, hex "#FF0000", {r,g,b,a?}, or {type:"VARIABLE_ALIAS",name:"other/variable"}');
+var lineHeight = z2.union([
+  z2.coerce.number(),
+  z2.object({ value: z2.coerce.number(), unit: z2.enum(["PIXELS", "PERCENT", "AUTO"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"|"AUTO"}');
+var letterSpacing = z2.union([
+  z2.coerce.number(),
+  z2.object({ value: z2.coerce.number(), unit: z2.enum(["PIXELS", "PERCENT"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"}');
+var stringOrBoolean = z2.union([z2.string(), z2.boolean()]);
+var token = z2.preprocess((v) => {
+  if (typeof v === "number") return String(v);
+  return v;
+}, z2.string()).describe('number as string ("8") or variable name ("Radii/Medium")');
 var effectEntry = z2.object({
   type: z2.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
   color: flexJson(colorRgba).optional(),
@@ -61,9 +88,14 @@ export {
   colorRgba,
   depth,
   effectEntry,
+  letterSpacing,
+  lineHeight,
   nodeId,
   nodeIds,
   parentId,
+  stringOrBoolean,
+  token,
+  variableValue,
   xPos,
   yPos
 };

package/dist/tools/schemas.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tools/schemas.ts","../../src/utils/coercion.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { flexJson, flexBool } from \"../utils/coercion\";\n\n// ─── Shared Zod Schema Fragments ────────────────────────────────\n// Import as: import * as S from \"./schemas\";\n\n/** Single node ID */\nexport const nodeId = z.string().describe(\"Node ID\");\n\n/** Array of node IDs */\nexport const nodeIds = flexJson(z.array(z.string())).describe(\"Array of node IDs\");\n\n/** Optional parent reference for creation tools */\nexport const parentId = z.string().optional()\n  .describe(\"Parent node ID. Omit to place on current page.\");\n\n/**\n * Response depth — controls how much node detail is returned after an operation.\n * Omit for minimal response (id + name only).\n * 0 = node with full properties, children as stubs.\n * N = recurse N levels of children with full properties.\n * -1 = unlimited recursion.\n */\nexport const depth = z.coerce.number().optional()\n  .describe(\"Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\");\n\n/** X position for creation tools */\nexport const xPos = z.coerce.number().optional().describe(\"X position (default: 0)\");\n\n/** Y position for creation tools */\nexport const yPos = z.coerce.number().optional().describe(\"Y position (default: 0)\");\n\n/** Parse hex color string (#RGB, #RRGGBB, #RRGGBBAA) to {r,g,b,a} 0-1 */\nfunction parseHex(hex: string): { r: number; g: number; b: number; a?: number } | null {\n  const m = hex.match(/^#?([0-9a-f]{3,8})$/i);\n  if (!m) return null;\n  let h = m[1];\n  if (h.length === 3) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2];\n  if (h.length === 4) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2]+h[3]+h[3];\n  if (h.length !== 6 && h.length !== 8) return null;\n  const r = parseInt(h.slice(0, 2), 16) / 255;\n  const g = parseInt(h.slice(2, 4), 16) / 255;\n  const b = parseInt(h.slice(4, 6), 16) / 255;\n  if (h.length === 8) return { r, g, b, a: parseInt(h.slice(6, 8), 16) / 255 };\n  return { r, g, b };\n}\n\n/** RGBA color — accepts {r,g,b,a?} object (0-1) or hex string (#RGB, #RRGGBB, #RRGGBBAA) */\nexport const colorRgba = z.preprocess((v) => {\n  if (typeof v === \"string\") return parseHex(v) ?? v;\n  return v;\n}, z.object({\n  r: z.coerce.number().min(0).max(1),\n  g: z.coerce.number().min(0).max(1),\n  b: z.coerce.number().min(0).max(1),\n  a: z.coerce.number().min(0).max(1).optional(),\n})).describe('Hex \"#FF0000\" or {r,g,b,a?} with values 0-1.');\n\n/** Single effect entry — shared by set_effects and styles create */\nexport const effectEntry = z.object({\n  type: z.enum([\"DROP_SHADOW\", \"INNER_SHADOW\", \"LAYER_BLUR\", \"BACKGROUND_BLUR\"]),\n  color: flexJson(colorRgba).optional(),\n  offset: flexJson(z.object({ x: z.coerce.number(), y: z.coerce.number() })).optional(),\n  radius: z.coerce.number(),\n  spread: z.coerce.number().optional(),\n  visible: flexBool(z.boolean()).optional(),\n  blendMode: z.string().optional(),\n});\n","import { z } from \"zod\";\n\n// AI agents (Claude, GPT, etc.) frequently pass numbers as strings\n// (\"10\" instead of 10), booleans as strings (\"true\" instead of true),\n// and objects/arrays as JSON strings. These helpers add resilient\n// coercion so tools don't fail on valid-but-mistyped input.\n\n/** Coerce \"true\"/\"false\"/\"1\"/\"0\" strings to boolean */\nexport const flexBool = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (v === \"true\" || v === \"1\") return true;\n    if (v === \"false\" || v === \"0\") return false;\n    return v;\n  }, inner);\n\n/** Coerce JSON strings to parsed values (for objects/arrays that agents may stringify) */\nexport const flexJson = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (typeof v === \"string\") {\n      try {\n        return JSON.parse(v);\n      } catch {\n        return v;\n      }\n    }\n    return v;\n  }, inner);\n\n/** Coerce numeric strings only when they're valid numbers (safe for use inside unions) */\nexport const flexNum = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (typeof v === \"string\") {\n      const n = Number(v);\n      if (!isNaN(n) && v.trim() !== \"\") return n;\n    }\n    return v;\n  }, inner);\n"],"mappings":"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","names":["z","z"]}
+{"version":3,"sources":["../../src/tools/schemas.ts","../../src/utils/coercion.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { flexJson, flexBool } from \"../utils/coercion\";\n\n// ─── Shared Zod Schema Fragments ────────────────────────────────\n// Import as: import * as S from \"./schemas\";\n\n/** Single node ID */\nexport const nodeId = z.string().describe(\"Node ID\");\n\n/** Array of node IDs */\nexport const nodeIds = flexJson(z.array(z.string())).describe(\"Array of node IDs\");\n\n/** Optional parent reference for creation tools */\nexport const parentId = z.string().optional()\n  .describe(\"Parent node ID. Omit to place on current page.\");\n\n/**\n * Response depth — controls how much node detail is returned after an operation.\n * Omit for minimal response (id + name only).\n * 0 = node with full properties, children as stubs.\n * N = recurse N levels of children with full properties.\n * -1 = unlimited recursion.\n */\nexport const depth = z.coerce.number().optional()\n  .describe(\"Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\");\n\n/** X position for creation tools */\nexport const xPos = z.coerce.number().optional().describe(\"X position (default: 0)\");\n\n/** Y position for creation tools */\nexport const yPos = z.coerce.number().optional().describe(\"Y position (default: 0)\");\n\n/** Parse hex color string (#RGB, #RRGGBB, #RRGGBBAA) to {r,g,b,a} 0-1 */\nfunction parseHex(hex: string): { r: number; g: number; b: number; a?: number } | null {\n  const m = hex.match(/^#?([0-9a-f]{3,8})$/i);\n  if (!m) return null;\n  let h = m[1];\n  if (h.length === 3) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2];\n  if (h.length === 4) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2]+h[3]+h[3];\n  if (h.length !== 6 && h.length !== 8) return null;\n  const r = parseInt(h.slice(0, 2), 16) / 255;\n  const g = parseInt(h.slice(2, 4), 16) / 255;\n  const b = parseInt(h.slice(4, 6), 16) / 255;\n  if (h.length === 8) return { r, g, b, a: parseInt(h.slice(6, 8), 16) / 255 };\n  return { r, g, b };\n}\n\n/** RGBA color — accepts {r,g,b,a?} object (0-1), hex string (#RGB, #RRGGBB, #RRGGBBAA), or style/variable name string */\nexport const colorRgba = z.preprocess((v) => {\n  if (typeof v === \"string\") return parseHex(v) ?? v;\n  return v;\n}, z.union([\n  z.object({\n    r: z.coerce.number().min(0).max(1),\n    g: z.coerce.number().min(0).max(1),\n    b: z.coerce.number().min(0).max(1),\n    a: z.coerce.number().min(0).max(1).optional(),\n  }),\n  z.string(), // Non-hex strings pass through for handler-level style/variable resolution\n])).describe('Hex \"#FF0000\", {r,g,b,a?} 0-1, or style/variable name.');\n\n/** Variable value — color (hex or RGBA), number, boolean, string, or alias */\nexport const variableValue = z.preprocess((v) => {\n  if (typeof v === \"string\") return parseHex(v) ?? v;\n  return v;\n}, z.union([\n  z.number(),\n  z.boolean(),\n  z.string(),\n  z.object({ r: z.number(), g: z.number(), b: z.number(), a: z.number().optional() }),\n  z.object({ type: z.literal(\"VARIABLE_ALIAS\"), name: z.string() }),\n])).describe('number, boolean, string, hex \"#FF0000\", {r,g,b,a?}, or {type:\"VARIABLE_ALIAS\",name:\"other/variable\"}');\n\n/** Line height — number (px) or {value, unit} */\nexport const lineHeight = z.union([\n  z.coerce.number(),\n  z.object({ value: z.coerce.number(), unit: z.enum([\"PIXELS\", \"PERCENT\", \"AUTO\"]) }),\n]).describe('number (px) or {value, unit: \"PIXELS\"|\"PERCENT\"|\"AUTO\"}');\n\n/** Letter spacing — number (px) or {value, unit} */\nexport const letterSpacing = z.union([\n  z.coerce.number(),\n  z.object({ value: z.coerce.number(), unit: z.enum([\"PIXELS\", \"PERCENT\"]) }),\n]).describe('number (px) or {value, unit: \"PIXELS\"|\"PERCENT\"}');\n\n/** String or boolean — for component property defaults */\nexport const stringOrBoolean = z.union([z.string(), z.boolean()]);\n\n/** Design token — accepts a string that is either a numeric value (\"8\") or a variable name/ID (\"Radii/Medium\").\n *  Numeric strings are parsed to numbers in the handler; non-numeric strings are variable references. */\nexport const token = z.preprocess((v) => {\n  // Accept raw numbers from agents that pass them correctly\n  if (typeof v === \"number\") return String(v);\n  return v;\n}, z.string()).describe('number as string (\"8\") or variable name (\"Radii/Medium\")');\n\n/** Single effect entry — shared by set_effects and styles create */\nexport const effectEntry = z.object({\n  type: z.enum([\"DROP_SHADOW\", \"INNER_SHADOW\", \"LAYER_BLUR\", \"BACKGROUND_BLUR\"]),\n  color: flexJson(colorRgba).optional(),\n  offset: flexJson(z.object({ x: z.coerce.number(), y: z.coerce.number() })).optional(),\n  radius: z.coerce.number(),\n  spread: z.coerce.number().optional(),\n  visible: flexBool(z.boolean()).optional(),\n  blendMode: z.string().optional(),\n});\n","import { z } from \"zod\";\n\n// AI agents (Claude, GPT, etc.) frequently pass numbers as strings\n// (\"10\" instead of 10), booleans as strings (\"true\" instead of true),\n// and objects/arrays as JSON strings. These helpers add resilient\n// coercion so tools don't fail on valid-but-mistyped input.\n\n/** Coerce \"true\"/\"false\"/\"1\"/\"0\" strings to boolean */\nexport const flexBool = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (v === \"true\" || v === \"1\") return true;\n    if (v === \"false\" || v === \"0\") return false;\n    return v;\n  }, inner);\n\n/** Coerce JSON strings to parsed values (for objects/arrays that agents may stringify) */\nexport const flexJson = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (typeof v === \"string\") {\n      try {\n        return JSON.parse(v);\n      } catch {\n        return v;\n      }\n    }\n    return v;\n  }, inner);\n\n/** Coerce numeric strings only when they're valid numbers (safe for use inside unions) */\nexport const flexNum = <T extends z.ZodTypeAny>(inner: T) =>\n  z.preprocess((v) => {\n    if (typeof v === \"string\") {\n      const n = Number(v);\n      if (!isNaN(n) && v.trim() !== \"\") return n;\n    }\n    return v;\n  }, inner);\n"],"mappings":"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","names":["z","z"]}

package/dist/tools/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tools/types.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { z } from \"zod\";\n\n/** Function signature for sending commands to Figma via WebSocket */\nexport type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;\n\n/** Re-export McpServer type for tool files */\nexport type { McpServer };\n\n// ─── Tool Registry Types ────────────────────────────────────────\n\n/** Access tier for a tool */\nexport type ToolTier = \"read\" | \"create\" | \"edit\";\n\n/** Which tiers are enabled for this MCP session */\nexport interface Capabilities { create: boolean; edit: boolean }\n\n/** Declarative tool definition — replaces imperative registerMcpTools() */\nexport interface ToolDef {\n  name: string;\n  description: string;\n  schema: Record<string, z.ZodTypeAny>\n        | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);\n  tier: ToolTier;\n  /** Figma command name. Defaults to name. */\n  command?: string;\n  /** sendCommand timeout in ms (default: 30 000) */\n  timeout?: number;\n  /** Pre-send validation (e.g. per-method item parsing for endpoints) */\n  validate?: (params: any) => void;\n  /** Custom response formatter. Default: mcpJson */\n  formatResponse?: (result: unknown) => any;\n}\n\n/** Standard batch result from Figma handlers */\nexport interface BatchResult<T = unknown> {\n  results: Array<T | \"ok\" | { error: string }>;\n  warnings?: string[];\n  /** Set when some items were deferred (e.g. font loading cap exceeded) */\n  deferred?: string;\n}\n\n/** Max response size in characters (~12K tokens). Prevents LLM client-side truncation that corrupts JSON. */\nconst MAX_RESPONSE_CHARS = 50_000;\n\n/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */\nexport function mcpJson(data: unknown) {\n  const text = JSON.stringify(data);\n  if (text.length <= MAX_RESPONSE_CHARS) {\n    return { content: [{ type: \"text\" as const, text }] };\n  }\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify({\n        _error: \"response_too_large\",\n        _sizeKB: Math.round(text.length / 1024),\n        warning: \"Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size.\",\n      }),\n    }],\n  };\n}\n\n/** Format an error MCP response */\nexport function mcpError(prefix: string, error: unknown) {\n  const msg = error instanceof Error ? error.message : String(error);\n  return { content: [{ type: \"text\" as const, text: `${prefix}: ${msg}` }] };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2CA,IAAM,qBAAqB;AAGpB,SAAS,QAAQ,MAAe;AACrC,QAAM,OAAO,KAAK,UAAU,IAAI;AAChC,MAAI,KAAK,UAAU,oBAAoB;AACrC,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,KAAK,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,MACR,MAAM;AAAA,MACN,MAAM,KAAK,UAAU;AAAA,QACnB,QAAQ;AAAA,QACR,SAAS,KAAK,MAAM,KAAK,SAAS,IAAI;AAAA,QACtC,SAAS;AAAA,MACX,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAGO,SAAS,SAAS,QAAgB,OAAgB;AACvD,QAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACjE,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,GAAG,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE;AAC3E;","names":[]}
+{"version":3,"sources":["../../src/tools/types.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { z } from \"zod\";\n\n/** Function signature for sending commands to Figma via WebSocket */\nexport type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;\n\n/** Re-export McpServer type for tool files */\nexport type { McpServer };\n\n// ─── Tool Registry Types ────────────────────────────────────────\n\n/** Access tier for a tool */\nexport type ToolTier = \"read\" | \"create\" | \"edit\";\n\n/** Which tiers are enabled for this MCP session */\nexport interface Capabilities { create: boolean; edit: boolean }\n\n/** Declarative tool definition — replaces imperative registerMcpTools() */\nexport interface ToolDef {\n  name: string;\n  description: string;\n  schema: Record<string, z.ZodTypeAny>\n        | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);\n  tier: ToolTier;\n  /** Figma command name. Defaults to name. For legacy standalone tools. */\n  command?: string;\n  /** Method → Figma command dispatch map. For endpoint tools (generated by schema compiler). */\n  commandMap?: Record<string, string>;\n  /** sendCommand timeout in ms (default: 30 000) */\n  timeout?: number;\n  /** Pre-send validation (e.g. per-method item parsing for endpoints) */\n  validate?: (params: any) => void;\n  /** Custom response formatter. Default: mcpJson */\n  formatResponse?: (result: unknown) => any;\n  /** Per-method response formatters. Overrides formatResponse for specific methods. */\n  methodFormatters?: Record<string, (result: unknown) => any>;\n}\n\n/** Standard batch result from Figma handlers */\nexport interface BatchResult<T = unknown> {\n  results: Array<T | \"ok\" | { error: string }>;\n  warnings?: string[];\n  /** Set when some items were deferred (e.g. font loading cap exceeded) */\n  deferred?: string;\n}\n\n/** Max response size in characters (~12K tokens). Prevents LLM client-side truncation that corrupts JSON. */\nconst MAX_RESPONSE_CHARS = 50_000;\n\n/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */\nexport function mcpJson(data: unknown) {\n  const text = JSON.stringify(data);\n  if (text.length <= MAX_RESPONSE_CHARS) {\n    return { content: [{ type: \"text\" as const, text }] };\n  }\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify({\n        _error: \"response_too_large\",\n        _sizeKB: Math.round(text.length / 1024),\n        warning: \"Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size.\",\n      }),\n    }],\n  };\n}\n\n/** Format an error MCP response */\nexport function mcpError(prefix: string, error: unknown) {\n  const msg = error instanceof Error ? error.message : String(error);\n  return { content: [{ type: \"text\" as const, text: `${prefix}: ${msg}` }] };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+CA,IAAM,qBAAqB;AAGpB,SAAS,QAAQ,MAAe;AACrC,QAAM,OAAO,KAAK,UAAU,IAAI;AAChC,MAAI,KAAK,UAAU,oBAAoB;AACrC,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,KAAK,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,MACR,MAAM;AAAA,MACN,MAAM,KAAK,UAAU;AAAA,QACnB,QAAQ;AAAA,QACR,SAAS,KAAK,MAAM,KAAK,SAAS,IAAI;AAAA,QACtC,SAAS;AAAA,MACX,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAGO,SAAS,SAAS,QAAgB,OAAgB;AACvD,QAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACjE,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,GAAG,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE;AAC3E;","names":[]}

package/dist/tools/types.d.cts

@@ -17,14 +17,18 @@ interface ToolDef {
     description: string;
     schema: Record<string, z.ZodTypeAny> | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);
     tier: ToolTier;
-    /** Figma command name. Defaults to name. */
+    /** Figma command name. Defaults to name. For legacy standalone tools. */
     command?: string;
+    /** Method → Figma command dispatch map. For endpoint tools (generated by schema compiler). */
+    commandMap?: Record<string, string>;
     /** sendCommand timeout in ms (default: 30 000) */
     timeout?: number;
     /** Pre-send validation (e.g. per-method item parsing for endpoints) */
     validate?: (params: any) => void;
     /** Custom response formatter. Default: mcpJson */
     formatResponse?: (result: unknown) => any;
+    /** Per-method response formatters. Overrides formatResponse for specific methods. */
+    methodFormatters?: Record<string, (result: unknown) => any>;
 }
 /** Standard batch result from Figma handlers */
 interface BatchResult<T = unknown> {

package/dist/tools/types.d.ts

@@ -17,14 +17,18 @@ interface ToolDef {
     description: string;
     schema: Record<string, z.ZodTypeAny> | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);
     tier: ToolTier;
-    /** Figma command name. Defaults to name. */
+    /** Figma command name. Defaults to name. For legacy standalone tools. */
     command?: string;
+    /** Method → Figma command dispatch map. For endpoint tools (generated by schema compiler). */
+    commandMap?: Record<string, string>;
     /** sendCommand timeout in ms (default: 30 000) */
     timeout?: number;
     /** Pre-send validation (e.g. per-method item parsing for endpoints) */
     validate?: (params: any) => void;
     /** Custom response formatter. Default: mcpJson */
     formatResponse?: (result: unknown) => any;
+    /** Per-method response formatters. Overrides formatResponse for specific methods. */
+    methodFormatters?: Record<string, (result: unknown) => any>;
 }
 /** Standard batch result from Figma handlers */
 interface BatchResult<T = unknown> {

package/dist/tools/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tools/types.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { z } from \"zod\";\n\n/** Function signature for sending commands to Figma via WebSocket */\nexport type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;\n\n/** Re-export McpServer type for tool files */\nexport type { McpServer };\n\n// ─── Tool Registry Types ────────────────────────────────────────\n\n/** Access tier for a tool */\nexport type ToolTier = \"read\" | \"create\" | \"edit\";\n\n/** Which tiers are enabled for this MCP session */\nexport interface Capabilities { create: boolean; edit: boolean }\n\n/** Declarative tool definition — replaces imperative registerMcpTools() */\nexport interface ToolDef {\n  name: string;\n  description: string;\n  schema: Record<string, z.ZodTypeAny>\n        | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);\n  tier: ToolTier;\n  /** Figma command name. Defaults to name. */\n  command?: string;\n  /** sendCommand timeout in ms (default: 30 000) */\n  timeout?: number;\n  /** Pre-send validation (e.g. per-method item parsing for endpoints) */\n  validate?: (params: any) => void;\n  /** Custom response formatter. Default: mcpJson */\n  formatResponse?: (result: unknown) => any;\n}\n\n/** Standard batch result from Figma handlers */\nexport interface BatchResult<T = unknown> {\n  results: Array<T | \"ok\" | { error: string }>;\n  warnings?: string[];\n  /** Set when some items were deferred (e.g. font loading cap exceeded) */\n  deferred?: string;\n}\n\n/** Max response size in characters (~12K tokens). Prevents LLM client-side truncation that corrupts JSON. */\nconst MAX_RESPONSE_CHARS = 50_000;\n\n/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */\nexport function mcpJson(data: unknown) {\n  const text = JSON.stringify(data);\n  if (text.length <= MAX_RESPONSE_CHARS) {\n    return { content: [{ type: \"text\" as const, text }] };\n  }\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify({\n        _error: \"response_too_large\",\n        _sizeKB: Math.round(text.length / 1024),\n        warning: \"Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size.\",\n      }),\n    }],\n  };\n}\n\n/** Format an error MCP response */\nexport function mcpError(prefix: string, error: unknown) {\n  const msg = error instanceof Error ? error.message : String(error);\n  return { content: [{ type: \"text\" as const, text: `${prefix}: ${msg}` }] };\n}\n"],"mappings":";AA2CA,IAAM,qBAAqB;AAGpB,SAAS,QAAQ,MAAe;AACrC,QAAM,OAAO,KAAK,UAAU,IAAI;AAChC,MAAI,KAAK,UAAU,oBAAoB;AACrC,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,KAAK,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,MACR,MAAM;AAAA,MACN,MAAM,KAAK,UAAU;AAAA,QACnB,QAAQ;AAAA,QACR,SAAS,KAAK,MAAM,KAAK,SAAS,IAAI;AAAA,QACtC,SAAS;AAAA,MACX,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAGO,SAAS,SAAS,QAAgB,OAAgB;AACvD,QAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACjE,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,GAAG,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE;AAC3E;","names":[]}
+{"version":3,"sources":["../../src/tools/types.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { z } from \"zod\";\n\n/** Function signature for sending commands to Figma via WebSocket */\nexport type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;\n\n/** Re-export McpServer type for tool files */\nexport type { McpServer };\n\n// ─── Tool Registry Types ────────────────────────────────────────\n\n/** Access tier for a tool */\nexport type ToolTier = \"read\" | \"create\" | \"edit\";\n\n/** Which tiers are enabled for this MCP session */\nexport interface Capabilities { create: boolean; edit: boolean }\n\n/** Declarative tool definition — replaces imperative registerMcpTools() */\nexport interface ToolDef {\n  name: string;\n  description: string;\n  schema: Record<string, z.ZodTypeAny>\n        | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);\n  tier: ToolTier;\n  /** Figma command name. Defaults to name. For legacy standalone tools. */\n  command?: string;\n  /** Method → Figma command dispatch map. For endpoint tools (generated by schema compiler). */\n  commandMap?: Record<string, string>;\n  /** sendCommand timeout in ms (default: 30 000) */\n  timeout?: number;\n  /** Pre-send validation (e.g. per-method item parsing for endpoints) */\n  validate?: (params: any) => void;\n  /** Custom response formatter. Default: mcpJson */\n  formatResponse?: (result: unknown) => any;\n  /** Per-method response formatters. Overrides formatResponse for specific methods. */\n  methodFormatters?: Record<string, (result: unknown) => any>;\n}\n\n/** Standard batch result from Figma handlers */\nexport interface BatchResult<T = unknown> {\n  results: Array<T | \"ok\" | { error: string }>;\n  warnings?: string[];\n  /** Set when some items were deferred (e.g. font loading cap exceeded) */\n  deferred?: string;\n}\n\n/** Max response size in characters (~12K tokens). Prevents LLM client-side truncation that corrupts JSON. */\nconst MAX_RESPONSE_CHARS = 50_000;\n\n/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */\nexport function mcpJson(data: unknown) {\n  const text = JSON.stringify(data);\n  if (text.length <= MAX_RESPONSE_CHARS) {\n    return { content: [{ type: \"text\" as const, text }] };\n  }\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify({\n        _error: \"response_too_large\",\n        _sizeKB: Math.round(text.length / 1024),\n        warning: \"Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size.\",\n      }),\n    }],\n  };\n}\n\n/** Format an error MCP response */\nexport function mcpError(prefix: string, error: unknown) {\n  const msg = error instanceof Error ? error.message : String(error);\n  return { content: [{ type: \"text\" as const, text: `${prefix}: ${msg}` }] };\n}\n"],"mappings":";AA+CA,IAAM,qBAAqB;AAGpB,SAAS,QAAQ,MAAe;AACrC,QAAM,OAAO,KAAK,UAAU,IAAI;AAChC,MAAI,KAAK,UAAU,oBAAoB;AACrC,WAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,KAAK,CAAC,EAAE;AAAA,EACtD;AACA,SAAO;AAAA,IACL,SAAS,CAAC;AAAA,MACR,MAAM;AAAA,MACN,MAAM,KAAK,UAAU;AAAA,QACnB,QAAQ;AAAA,QACR,SAAS,KAAK,MAAM,KAAK,SAAS,IAAI;AAAA,QACtC,SAAS;AAAA,MACX,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAGO,SAAS,SAAS,QAAgB,OAAgB;AACvD,QAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACjE,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,GAAG,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE;AAC3E;","names":[]}

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": "0.3.2",
+  "version": "1.0.0-rc1",
   "license": "MIT",
   "author": "ufira <https://github.com/ufira-ai>",
   "homepage": "https://github.com/ufira-ai/vibma",
@@ -44,6 +44,10 @@
       "import": "./dist/tools/registry.js",
       "require": "./dist/tools/registry.cjs"
     },
+    "./guards": {
+      "import": "./dist/tools/generated/guards.js",
+      "require": "./dist/tools/generated/guards.cjs"
+    },
     "./utils/color": {
       "import": "./dist/utils/color.js",
       "require": "./dist/utils/color.cjs"
@@ -75,7 +79,7 @@
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.4.0",
     "@types/ws": "^8.18.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"