@ufira/vibma 0.3.2 → 1.0.0-rc2

package/dist/tools/schemas.cjs

@@ -22,9 +22,14 @@ __export(schemas_exports, {
   colorRgba: () => colorRgba,
   depth: () => depth,
   effectEntry: () => effectEntry,
+  letterSpacing: () => letterSpacing,
+  lineHeight: () => lineHeight,
   nodeId: () => nodeId,
   nodeIds: () => nodeIds,
   parentId: () => parentId,
+  stringOrBoolean: () => stringOrBoolean,
+  token: () => token,
+  variableValue: () => variableValue,
   xPos: () => xPos,
   yPos: () => yPos
 });
@@ -72,12 +77,39 @@ function parseHex(hex) {
 var colorRgba = import_zod2.z.preprocess((v) => {
   if (typeof v === "string") return parseHex(v) ?? v;
   return v;
-}, import_zod2.z.object({
-  r: import_zod2.z.coerce.number().min(0).max(1),
-  g: import_zod2.z.coerce.number().min(0).max(1),
-  b: import_zod2.z.coerce.number().min(0).max(1),
-  a: import_zod2.z.coerce.number().min(0).max(1).optional()
-})).describe('Hex "#FF0000" or {r,g,b,a?} with values 0-1.');
+}, import_zod2.z.union([
+  import_zod2.z.object({
+    r: import_zod2.z.coerce.number().min(0).max(1),
+    g: import_zod2.z.coerce.number().min(0).max(1),
+    b: import_zod2.z.coerce.number().min(0).max(1),
+    a: import_zod2.z.coerce.number().min(0).max(1).optional()
+  }),
+  import_zod2.z.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 = import_zod2.z.preprocess((v) => {
+  if (typeof v === "string") return parseHex(v) ?? v;
+  return v;
+}, import_zod2.z.union([
+  import_zod2.z.number(),
+  import_zod2.z.boolean(),
+  import_zod2.z.string(),
+  import_zod2.z.object({ r: import_zod2.z.number(), g: import_zod2.z.number(), b: import_zod2.z.number(), a: import_zod2.z.number().optional() }),
+  import_zod2.z.object({ type: import_zod2.z.literal("VARIABLE_ALIAS"), name: import_zod2.z.string() })
+])).describe('number, boolean, string, hex "#FF0000", {r,g,b,a?}, or {type:"VARIABLE_ALIAS",name:"other/variable"}');
+var lineHeight = import_zod2.z.union([
+  import_zod2.z.coerce.number(),
+  import_zod2.z.object({ value: import_zod2.z.coerce.number(), unit: import_zod2.z.enum(["PIXELS", "PERCENT", "AUTO"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"|"AUTO"}');
+var letterSpacing = import_zod2.z.union([
+  import_zod2.z.coerce.number(),
+  import_zod2.z.object({ value: import_zod2.z.coerce.number(), unit: import_zod2.z.enum(["PIXELS", "PERCENT"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"}');
+var stringOrBoolean = import_zod2.z.union([import_zod2.z.string(), import_zod2.z.boolean()]);
+var token = import_zod2.z.preprocess((v) => {
+  if (typeof v === "number") return String(v);
+  return v;
+}, import_zod2.z.string()).describe('number as string ("8") or variable name ("Radii/Medium")');
 var effectEntry = import_zod2.z.object({
   type: import_zod2.z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
   color: flexJson(colorRgba).optional(),
@@ -92,9 +124,14 @@ var effectEntry = import_zod2.z.object({
   colorRgba,
   depth,
   effectEntry,
+  letterSpacing,
+  lineHeight,
   nodeId,
   nodeIds,
   parentId,
+  stringOrBoolean,
+  token,
+  variableValue,
   xPos,
   yPos
 });

package/dist/tools/schemas.d.cts

@@ -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.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/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/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-rc2",
   "license": "MIT",
   "author": "ufira <https://github.com/ufira-ai>",
   "homepage": "https://github.com/ufira-ai/vibma",
@@ -21,6 +21,7 @@
   "module": "dist/mcp.js",
   "main": "dist/mcp.js",
   "bin": {
+    "vibma": "dist/mcp.js",
     "vibma-mcp": "dist/mcp.js"
   },
   "exports": {
@@ -44,6 +45,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"
@@ -59,6 +64,7 @@
   },
   "files": [
     "dist",
+    "!dist/**/*.map",
     "README.md",
     "LICENSE"
   ],
@@ -75,7 +81,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"