@ufira/vibma 0.2.1 → 0.3.0

package/dist/tools/schemas.cjs

@@ -0,0 +1,101 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tools/schemas.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  colorRgba: () => colorRgba,
+  depth: () => depth,
+  effectEntry: () => effectEntry,
+  nodeId: () => nodeId,
+  nodeIds: () => nodeIds,
+  parentId: () => parentId,
+  xPos: () => xPos,
+  yPos: () => yPos
+});
+module.exports = __toCommonJS(schemas_exports);
+var import_zod2 = require("zod");
+
+// src/utils/coercion.ts
+var import_zod = require("zod");
+var flexBool = (inner) => import_zod.z.preprocess((v) => {
+  if (v === "true" || v === "1") return true;
+  if (v === "false" || v === "0") return false;
+  return v;
+}, inner);
+var flexJson = (inner) => import_zod.z.preprocess((v) => {
+  if (typeof v === "string") {
+    try {
+      return JSON.parse(v);
+    } catch {
+      return v;
+    }
+  }
+  return v;
+}, inner);
+
+// src/tools/schemas.ts
+var nodeId = import_zod2.z.string().describe("Node ID");
+var nodeIds = flexJson(import_zod2.z.array(import_zod2.z.string())).describe("Array of node IDs");
+var parentId = import_zod2.z.string().optional().describe("Parent node ID. Omit to place on current page.");
+var depth = import_zod2.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.");
+var xPos = import_zod2.z.coerce.number().optional().describe("X position (default: 0)");
+var yPos = import_zod2.z.coerce.number().optional().describe("Y position (default: 0)");
+function parseHex(hex) {
+  const m = hex.match(/^#?([0-9a-f]{3,8})$/i);
+  if (!m) return null;
+  let h = m[1];
+  if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+  if (h.length === 4) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2] + h[3] + h[3];
+  if (h.length !== 6 && h.length !== 8) return null;
+  const r = parseInt(h.slice(0, 2), 16) / 255;
+  const g = parseInt(h.slice(2, 4), 16) / 255;
+  const b = parseInt(h.slice(4, 6), 16) / 255;
+  if (h.length === 8) return { r, g, b, a: parseInt(h.slice(6, 8), 16) / 255 };
+  return { r, g, b };
+}
+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.');
+var effectEntry = import_zod2.z.object({
+  type: import_zod2.z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
+  color: flexJson(colorRgba).optional(),
+  offset: flexJson(import_zod2.z.object({ x: import_zod2.z.coerce.number(), y: import_zod2.z.coerce.number() })).optional(),
+  radius: import_zod2.z.coerce.number(),
+  spread: import_zod2.z.coerce.number().optional(),
+  visible: flexBool(import_zod2.z.boolean()).optional(),
+  blendMode: import_zod2.z.string().optional()
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  colorRgba,
+  depth,
+  effectEntry,
+  nodeId,
+  nodeIds,
+  parentId,
+  xPos,
+  yPos
+});
+//# sourceMappingURL=schemas.cjs.map

package/dist/tools/schemas.cjs.map

@@ -0,0 +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":["import_zod"]}

package/dist/tools/schemas.d.cts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+/** Single node ID */
+declare const nodeId: z.ZodString;
+/** Array of node IDs */
+declare const nodeIds: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodArray<z.ZodString>>;
+/** Optional parent reference for creation tools */
+declare const parentId: z.ZodOptional<z.ZodString>;
+/**
+ * Response depth — controls how much node detail is returned after an operation.
+ * Omit for minimal response (id + name only).
+ * 0 = node with full properties, children as stubs.
+ * N = recurse N levels of children with full properties.
+ * -1 = unlimited recursion.
+ */
+declare const depth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+/** X position for creation tools */
+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<{
+    r: z.ZodCoercedNumber<unknown>;
+    g: z.ZodCoercedNumber<unknown>;
+    b: z.ZodCoercedNumber<unknown>;
+    a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>>;
+/** Single effect entry — shared by set_effects and styles create */
+declare const effectEntry: z.ZodObject<{
+    type: z.ZodEnum<{
+        DROP_SHADOW: "DROP_SHADOW";
+        INNER_SHADOW: "INNER_SHADOW";
+        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<{
+        r: z.ZodCoercedNumber<unknown>;
+        g: z.ZodCoercedNumber<unknown>;
+        b: z.ZodCoercedNumber<unknown>;
+        a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>>>>;
+    offset: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodObject<{
+        x: z.ZodCoercedNumber<unknown>;
+        y: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>>>;
+    radius: z.ZodCoercedNumber<unknown>;
+    spread: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    visible: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+    blendMode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+export { colorRgba, depth, effectEntry, nodeId, nodeIds, parentId, xPos, yPos };

package/dist/tools/schemas.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+/** Single node ID */
+declare const nodeId: z.ZodString;
+/** Array of node IDs */
+declare const nodeIds: z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodArray<z.ZodString>>;
+/** Optional parent reference for creation tools */
+declare const parentId: z.ZodOptional<z.ZodString>;
+/**
+ * Response depth — controls how much node detail is returned after an operation.
+ * Omit for minimal response (id + name only).
+ * 0 = node with full properties, children as stubs.
+ * N = recurse N levels of children with full properties.
+ * -1 = unlimited recursion.
+ */
+declare const depth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+/** X position for creation tools */
+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<{
+    r: z.ZodCoercedNumber<unknown>;
+    g: z.ZodCoercedNumber<unknown>;
+    b: z.ZodCoercedNumber<unknown>;
+    a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>>;
+/** Single effect entry — shared by set_effects and styles create */
+declare const effectEntry: z.ZodObject<{
+    type: z.ZodEnum<{
+        DROP_SHADOW: "DROP_SHADOW";
+        INNER_SHADOW: "INNER_SHADOW";
+        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<{
+        r: z.ZodCoercedNumber<unknown>;
+        g: z.ZodCoercedNumber<unknown>;
+        b: z.ZodCoercedNumber<unknown>;
+        a: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>>>>;
+    offset: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodObject<{
+        x: z.ZodCoercedNumber<unknown>;
+        y: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>>>;
+    radius: z.ZodCoercedNumber<unknown>;
+    spread: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    visible: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+    blendMode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+export { colorRgba, depth, effectEntry, nodeId, nodeIds, parentId, xPos, yPos };

package/dist/tools/schemas.js

@@ -0,0 +1,70 @@
+// src/tools/schemas.ts
+import { z as z2 } from "zod";
+
+// src/utils/coercion.ts
+import { z } from "zod";
+var flexBool = (inner) => z.preprocess((v) => {
+  if (v === "true" || v === "1") return true;
+  if (v === "false" || v === "0") return false;
+  return v;
+}, inner);
+var flexJson = (inner) => z.preprocess((v) => {
+  if (typeof v === "string") {
+    try {
+      return JSON.parse(v);
+    } catch {
+      return v;
+    }
+  }
+  return v;
+}, inner);
+
+// src/tools/schemas.ts
+var nodeId = z2.string().describe("Node ID");
+var nodeIds = flexJson(z2.array(z2.string())).describe("Array of node IDs");
+var parentId = z2.string().optional().describe("Parent node ID. Omit to place on current page.");
+var depth = z2.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.");
+var xPos = z2.coerce.number().optional().describe("X position (default: 0)");
+var yPos = z2.coerce.number().optional().describe("Y position (default: 0)");
+function parseHex(hex) {
+  const m = hex.match(/^#?([0-9a-f]{3,8})$/i);
+  if (!m) return null;
+  let h = m[1];
+  if (h.length === 3) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2];
+  if (h.length === 4) h = h[0] + h[0] + h[1] + h[1] + h[2] + h[2] + h[3] + h[3];
+  if (h.length !== 6 && h.length !== 8) return null;
+  const r = parseInt(h.slice(0, 2), 16) / 255;
+  const g = parseInt(h.slice(2, 4), 16) / 255;
+  const b = parseInt(h.slice(4, 6), 16) / 255;
+  if (h.length === 8) return { r, g, b, a: parseInt(h.slice(6, 8), 16) / 255 };
+  return { r, g, b };
+}
+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.');
+var effectEntry = z2.object({
+  type: z2.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
+  color: flexJson(colorRgba).optional(),
+  offset: flexJson(z2.object({ x: z2.coerce.number(), y: z2.coerce.number() })).optional(),
+  radius: z2.coerce.number(),
+  spread: z2.coerce.number().optional(),
+  visible: flexBool(z2.boolean()).optional(),
+  blendMode: z2.string().optional()
+});
+export {
+  colorRgba,
+  depth,
+  effectEntry,
+  nodeId,
+  nodeIds,
+  parentId,
+  xPos,
+  yPos
+};
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +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"]}

package/dist/tools/types.cjs

@@ -0,0 +1,52 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tools/types.ts
+var types_exports = {};
+__export(types_exports, {
+  mcpError: () => mcpError,
+  mcpJson: () => mcpJson
+});
+module.exports = __toCommonJS(types_exports);
+var MAX_RESPONSE_CHARS = 5e4;
+function mcpJson(data) {
+  const text = JSON.stringify(data);
+  if (text.length <= MAX_RESPONSE_CHARS) {
+    return { content: [{ type: "text", text }] };
+  }
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        _error: "response_too_large",
+        _sizeKB: Math.round(text.length / 1024),
+        warning: "Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size."
+      })
+    }]
+  };
+}
+function mcpError(prefix, error) {
+  const msg = error instanceof Error ? error.message : String(error);
+  return { content: [{ type: "text", text: `${prefix}: ${msg}` }] };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mcpError,
+  mcpJson
+});
+//# sourceMappingURL=types.cjs.map

package/dist/tools/types.cjs.map

@@ -0,0 +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":[]}

package/dist/tools/types.d.cts

@@ -0,0 +1,53 @@
+export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+/** Function signature for sending commands to Figma via WebSocket */
+type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;
+
+/** Access tier for a tool */
+type ToolTier = "read" | "create" | "edit";
+/** Which tiers are enabled for this MCP session */
+interface Capabilities {
+    create: boolean;
+    edit: boolean;
+}
+/** Declarative tool definition — replaces imperative registerMcpTools() */
+interface ToolDef {
+    name: string;
+    description: string;
+    schema: Record<string, z.ZodTypeAny> | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);
+    tier: ToolTier;
+    /** Figma command name. Defaults to name. */
+    command?: 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;
+}
+/** Standard batch result from Figma handlers */
+interface BatchResult<T = unknown> {
+    results: Array<T | "ok" | {
+        error: string;
+    }>;
+    warnings?: string[];
+    /** Set when some items were deferred (e.g. font loading cap exceeded) */
+    deferred?: string;
+}
+/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */
+declare function mcpJson(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Format an error MCP response */
+declare function mcpError(prefix: string, error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+
+export { type BatchResult, type Capabilities, type SendCommandFn, type ToolDef, type ToolTier, mcpError, mcpJson };

package/dist/tools/types.d.ts

@@ -0,0 +1,53 @@
+export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+/** Function signature for sending commands to Figma via WebSocket */
+type SendCommandFn = (command: string, params?: unknown, timeoutMs?: number) => Promise<unknown>;
+
+/** Access tier for a tool */
+type ToolTier = "read" | "create" | "edit";
+/** Which tiers are enabled for this MCP session */
+interface Capabilities {
+    create: boolean;
+    edit: boolean;
+}
+/** Declarative tool definition — replaces imperative registerMcpTools() */
+interface ToolDef {
+    name: string;
+    description: string;
+    schema: Record<string, z.ZodTypeAny> | ((caps: Capabilities) => Record<string, z.ZodTypeAny>);
+    tier: ToolTier;
+    /** Figma command name. Defaults to name. */
+    command?: 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;
+}
+/** Standard batch result from Figma handlers */
+interface BatchResult<T = unknown> {
+    results: Array<T | "ok" | {
+        error: string;
+    }>;
+    warnings?: string[];
+    /** Set when some items were deferred (e.g. font loading cap exceeded) */
+    deferred?: string;
+}
+/** Format a successful MCP response (JSON). Returns a clean error if response exceeds safe size. */
+declare function mcpJson(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/** Format an error MCP response */
+declare function mcpError(prefix: string, error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+
+export { type BatchResult, type Capabilities, type SendCommandFn, type ToolDef, type ToolTier, mcpError, mcpJson };

package/dist/tools/types.js

@@ -0,0 +1,27 @@
+// src/tools/types.ts
+var MAX_RESPONSE_CHARS = 5e4;
+function mcpJson(data) {
+  const text = JSON.stringify(data);
+  if (text.length <= MAX_RESPONSE_CHARS) {
+    return { content: [{ type: "text", text }] };
+  }
+  return {
+    content: [{
+      type: "text",
+      text: JSON.stringify({
+        _error: "response_too_large",
+        _sizeKB: Math.round(text.length / 1024),
+        warning: "Response exceeds safe size. Use 'depth', 'fields', 'limit', or 'summaryOnly' parameters to reduce response size."
+      })
+    }]
+  };
+}
+function mcpError(prefix, error) {
+  const msg = error instanceof Error ? error.message : String(error);
+  return { content: [{ type: "text", text: `${prefix}: ${msg}` }] };
+}
+export {
+  mcpError,
+  mcpJson
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +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":[]}

package/dist/utils/coercion.cjs

@@ -0,0 +1,56 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/coercion.ts
+var coercion_exports = {};
+__export(coercion_exports, {
+  flexBool: () => flexBool,
+  flexJson: () => flexJson,
+  flexNum: () => flexNum
+});
+module.exports = __toCommonJS(coercion_exports);
+var import_zod = require("zod");
+var flexBool = (inner) => import_zod.z.preprocess((v) => {
+  if (v === "true" || v === "1") return true;
+  if (v === "false" || v === "0") return false;
+  return v;
+}, inner);
+var flexJson = (inner) => import_zod.z.preprocess((v) => {
+  if (typeof v === "string") {
+    try {
+      return JSON.parse(v);
+    } catch {
+      return v;
+    }
+  }
+  return v;
+}, inner);
+var flexNum = (inner) => import_zod.z.preprocess((v) => {
+  if (typeof v === "string") {
+    const n = Number(v);
+    if (!isNaN(n) && v.trim() !== "") return n;
+  }
+  return v;
+}, inner);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  flexBool,
+  flexJson,
+  flexNum
+});
+//# sourceMappingURL=coercion.cjs.map

package/dist/utils/coercion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/coercion.ts"],"sourcesContent":["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":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAQX,IAAM,WAAW,CAAyB,UAC/C,aAAE,WAAW,CAAC,MAAM;AAClB,MAAI,MAAM,UAAU,MAAM,IAAK,QAAO;AACtC,MAAI,MAAM,WAAW,MAAM,IAAK,QAAO;AACvC,SAAO;AACT,GAAG,KAAK;AAGH,IAAM,WAAW,CAAyB,UAC/C,aAAE,WAAW,CAAC,MAAM;AAClB,MAAI,OAAO,MAAM,UAAU;AACzB,QAAI;AACF,aAAO,KAAK,MAAM,CAAC;AAAA,IACrB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT,GAAG,KAAK;AAGH,IAAM,UAAU,CAAyB,UAC9C,aAAE,WAAW,CAAC,MAAM;AAClB,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,OAAO,CAAC;AAClB,QAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,MAAM,GAAI,QAAO;AAAA,EAC3C;AACA,SAAO;AACT,GAAG,KAAK;","names":[]}

package/dist/utils/coercion.d.cts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+/** Coerce "true"/"false"/"1"/"0" strings to boolean */
+declare const flexBool: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, T>;
+/** Coerce JSON strings to parsed values (for objects/arrays that agents may stringify) */
+declare const flexJson: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<any, unknown>, T>;
+/** Coerce numeric strings only when they're valid numbers (safe for use inside unions) */
+declare const flexNum: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, T>;
+
+export { flexBool, flexJson, flexNum };

package/dist/utils/coercion.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+/** Coerce "true"/"false"/"1"/"0" strings to boolean */
+declare const flexBool: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, T>;
+/** Coerce JSON strings to parsed values (for objects/arrays that agents may stringify) */
+declare const flexJson: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<any, unknown>, T>;
+/** Coerce numeric strings only when they're valid numbers (safe for use inside unions) */
+declare const flexNum: <T extends z.ZodTypeAny>(inner: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, T>;
+
+export { flexBool, flexJson, flexNum };

package/dist/utils/coercion.js

@@ -0,0 +1,30 @@
+// src/utils/coercion.ts
+import { z } from "zod";
+var flexBool = (inner) => z.preprocess((v) => {
+  if (v === "true" || v === "1") return true;
+  if (v === "false" || v === "0") return false;
+  return v;
+}, inner);
+var flexJson = (inner) => z.preprocess((v) => {
+  if (typeof v === "string") {
+    try {
+      return JSON.parse(v);
+    } catch {
+      return v;
+    }
+  }
+  return v;
+}, inner);
+var flexNum = (inner) => z.preprocess((v) => {
+  if (typeof v === "string") {
+    const n = Number(v);
+    if (!isNaN(n) && v.trim() !== "") return n;
+  }
+  return v;
+}, inner);
+export {
+  flexBool,
+  flexJson,
+  flexNum
+};
+//# sourceMappingURL=coercion.js.map

package/dist/utils/coercion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/coercion.ts"],"sourcesContent":["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":";AAAA,SAAS,SAAS;AAQX,IAAM,WAAW,CAAyB,UAC/C,EAAE,WAAW,CAAC,MAAM;AAClB,MAAI,MAAM,UAAU,MAAM,IAAK,QAAO;AACtC,MAAI,MAAM,WAAW,MAAM,IAAK,QAAO;AACvC,SAAO;AACT,GAAG,KAAK;AAGH,IAAM,WAAW,CAAyB,UAC/C,EAAE,WAAW,CAAC,MAAM;AAClB,MAAI,OAAO,MAAM,UAAU;AACzB,QAAI;AACF,aAAO,KAAK,MAAM,CAAC;AAAA,IACrB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT,GAAG,KAAK;AAGH,IAAM,UAAU,CAAyB,UAC9C,EAAE,WAAW,CAAC,MAAM;AAClB,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,OAAO,CAAC;AAClB,QAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,MAAM,GAAI,QAAO;AAAA,EAC3C;AACA,SAAO;AACT,GAAG,KAAK;","names":[]}