@defai.digital/ax-cli 3.14.9 → 3.14.11

package/packages/schemas/dist/public/design/figma-types.d.ts

@@ -0,0 +1,1306 @@
+/**
+ * Figma API Response Schemas
+ *
+ * Zod schemas for Figma REST API responses.
+ * These schemas validate API responses at system boundaries.
+ *
+ * @see https://www.figma.com/developers/api
+ * @module design/figma-types
+ */
+import { z } from 'zod';
+import { type Brand } from '../core/brand-types.js';
+/**
+ * Figma File Key - unique identifier for a Figma file
+ * Format: alphanumeric string, typically 22 characters
+ */
+export type FigmaFileKey = Brand<string, 'FigmaFileKey'>;
+/**
+ * Figma Node ID - unique identifier for a node within a file
+ * Format: "number:number" (e.g., "123:456")
+ */
+export type FigmaNodeId = Brand<string, 'FigmaNodeId'>;
+/**
+ * Schema for Figma file key validation
+ */
+export declare const FigmaFileKeySchema: z.ZodEffects<z.ZodString, Brand<string, "FigmaFileKey">, string>;
+/**
+ * Schema for Figma node ID validation
+ */
+export declare const FigmaNodeIdSchema: z.ZodEffects<z.ZodString, Brand<string, "FigmaNodeId">, string>;
+/**
+ * Color in RGBA format (0-1 range)
+ */
+export declare const FigmaColorSchema: z.ZodObject<{
+    r: z.ZodNumber;
+    g: z.ZodNumber;
+    b: z.ZodNumber;
+    a: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}, {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}>;
+export type FigmaColor = z.infer<typeof FigmaColorSchema>;
+/**
+ * Rectangle bounds
+ */
+export declare const FigmaRectSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+export type FigmaRect = z.infer<typeof FigmaRectSchema>;
+/**
+ * Constraint for resizing behavior
+ */
+export declare const FigmaConstraintSchema: z.ZodObject<{
+    type: z.ZodEnum<["MIN", "CENTER", "MAX", "STRETCH", "SCALE"]>;
+    value: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+    value?: number | undefined;
+}, {
+    type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+    value?: number | undefined;
+}>;
+export type FigmaConstraint = z.infer<typeof FigmaConstraintSchema>;
+/**
+ * Layout constraint pair (horizontal, vertical)
+ */
+export declare const FigmaConstraintsSchema: z.ZodObject<{
+    horizontal: z.ZodObject<{
+        type: z.ZodEnum<["MIN", "CENTER", "MAX", "STRETCH", "SCALE"]>;
+        value: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    }, {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    }>;
+    vertical: z.ZodObject<{
+        type: z.ZodEnum<["MIN", "CENTER", "MAX", "STRETCH", "SCALE"]>;
+        value: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    }, {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    horizontal: {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    };
+    vertical: {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    };
+}, {
+    horizontal: {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    };
+    vertical: {
+        type: "MIN" | "CENTER" | "MAX" | "STRETCH" | "SCALE";
+        value?: number | undefined;
+    };
+}>;
+export type FigmaConstraints = z.infer<typeof FigmaConstraintsSchema>;
+/**
+ * Auto-layout properties
+ */
+export declare const FigmaAutoLayoutSchema: z.ZodObject<{
+    layoutMode: z.ZodOptional<z.ZodEnum<["NONE", "HORIZONTAL", "VERTICAL"]>>;
+    primaryAxisSizingMode: z.ZodOptional<z.ZodEnum<["FIXED", "AUTO"]>>;
+    counterAxisSizingMode: z.ZodOptional<z.ZodEnum<["FIXED", "AUTO"]>>;
+    primaryAxisAlignItems: z.ZodOptional<z.ZodEnum<["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]>>;
+    counterAxisAlignItems: z.ZodOptional<z.ZodEnum<["MIN", "CENTER", "MAX", "BASELINE"]>>;
+    paddingLeft: z.ZodOptional<z.ZodNumber>;
+    paddingRight: z.ZodOptional<z.ZodNumber>;
+    paddingTop: z.ZodOptional<z.ZodNumber>;
+    paddingBottom: z.ZodOptional<z.ZodNumber>;
+    itemSpacing: z.ZodOptional<z.ZodNumber>;
+    counterAxisSpacing: z.ZodOptional<z.ZodNumber>;
+    layoutWrap: z.ZodOptional<z.ZodEnum<["NO_WRAP", "WRAP"]>>;
+}, "strip", z.ZodTypeAny, {
+    layoutMode?: "NONE" | "HORIZONTAL" | "VERTICAL" | undefined;
+    primaryAxisSizingMode?: "FIXED" | "AUTO" | undefined;
+    counterAxisSizingMode?: "FIXED" | "AUTO" | undefined;
+    primaryAxisAlignItems?: "MIN" | "CENTER" | "MAX" | "SPACE_BETWEEN" | undefined;
+    counterAxisAlignItems?: "MIN" | "CENTER" | "MAX" | "BASELINE" | undefined;
+    paddingLeft?: number | undefined;
+    paddingRight?: number | undefined;
+    paddingTop?: number | undefined;
+    paddingBottom?: number | undefined;
+    itemSpacing?: number | undefined;
+    counterAxisSpacing?: number | undefined;
+    layoutWrap?: "NO_WRAP" | "WRAP" | undefined;
+}, {
+    layoutMode?: "NONE" | "HORIZONTAL" | "VERTICAL" | undefined;
+    primaryAxisSizingMode?: "FIXED" | "AUTO" | undefined;
+    counterAxisSizingMode?: "FIXED" | "AUTO" | undefined;
+    primaryAxisAlignItems?: "MIN" | "CENTER" | "MAX" | "SPACE_BETWEEN" | undefined;
+    counterAxisAlignItems?: "MIN" | "CENTER" | "MAX" | "BASELINE" | undefined;
+    paddingLeft?: number | undefined;
+    paddingRight?: number | undefined;
+    paddingTop?: number | undefined;
+    paddingBottom?: number | undefined;
+    itemSpacing?: number | undefined;
+    counterAxisSpacing?: number | undefined;
+    layoutWrap?: "NO_WRAP" | "WRAP" | undefined;
+}>;
+export type FigmaAutoLayout = z.infer<typeof FigmaAutoLayoutSchema>;
+/**
+ * Paint fill/stroke
+ */
+export declare const FigmaPaintSchema: z.ZodObject<{
+    type: z.ZodEnum<["SOLID", "GRADIENT_LINEAR", "GRADIENT_RADIAL", "GRADIENT_ANGULAR", "GRADIENT_DIAMOND", "IMAGE", "EMOJI", "VIDEO"]>;
+    visible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    opacity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    color: z.ZodOptional<z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        a: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }>>;
+    blendMode: z.ZodOptional<z.ZodString>;
+    gradientStops: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        position: z.ZodNumber;
+        color: z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+            a: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        }, {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        position: number;
+    }, {
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        position: number;
+    }>, "many">>;
+    scaleMode: z.ZodOptional<z.ZodEnum<["FILL", "FIT", "TILE", "STRETCH"]>>;
+    imageRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "SOLID" | "GRADIENT_LINEAR" | "GRADIENT_RADIAL" | "GRADIENT_ANGULAR" | "GRADIENT_DIAMOND" | "IMAGE" | "EMOJI" | "VIDEO";
+    visible: boolean;
+    opacity: number;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    } | undefined;
+    blendMode?: string | undefined;
+    gradientStops?: {
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        position: number;
+    }[] | undefined;
+    scaleMode?: "STRETCH" | "FILL" | "FIT" | "TILE" | undefined;
+    imageRef?: string | undefined;
+}, {
+    type: "SOLID" | "GRADIENT_LINEAR" | "GRADIENT_RADIAL" | "GRADIENT_ANGULAR" | "GRADIENT_DIAMOND" | "IMAGE" | "EMOJI" | "VIDEO";
+    visible?: boolean | undefined;
+    opacity?: number | undefined;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    } | undefined;
+    blendMode?: string | undefined;
+    gradientStops?: {
+        color: {
+            r: number;
+            g: number;
+            b: number;
+            a: number;
+        };
+        position: number;
+    }[] | undefined;
+    scaleMode?: "STRETCH" | "FILL" | "FIT" | "TILE" | undefined;
+    imageRef?: string | undefined;
+}>;
+export type FigmaPaint = z.infer<typeof FigmaPaintSchema>;
+/**
+ * Text style properties
+ */
+export declare const FigmaTextStyleSchema: z.ZodObject<{
+    fontFamily: z.ZodOptional<z.ZodString>;
+    fontPostScriptName: z.ZodOptional<z.ZodString>;
+    fontWeight: z.ZodOptional<z.ZodNumber>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    textAlignHorizontal: z.ZodOptional<z.ZodEnum<["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]>>;
+    textAlignVertical: z.ZodOptional<z.ZodEnum<["TOP", "CENTER", "BOTTOM"]>>;
+    letterSpacing: z.ZodOptional<z.ZodNumber>;
+    lineHeightPx: z.ZodOptional<z.ZodNumber>;
+    lineHeightPercent: z.ZodOptional<z.ZodNumber>;
+    lineHeightUnit: z.ZodOptional<z.ZodEnum<["PIXELS", "FONT_SIZE_%", "INTRINSIC_%"]>>;
+    textCase: z.ZodOptional<z.ZodEnum<["ORIGINAL", "UPPER", "LOWER", "TITLE", "SMALL_CAPS", "SMALL_CAPS_FORCED"]>>;
+    textDecoration: z.ZodOptional<z.ZodEnum<["NONE", "STRIKETHROUGH", "UNDERLINE"]>>;
+    paragraphSpacing: z.ZodOptional<z.ZodNumber>;
+    paragraphIndent: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fontFamily?: string | undefined;
+    fontPostScriptName?: string | undefined;
+    fontWeight?: number | undefined;
+    fontSize?: number | undefined;
+    textAlignHorizontal?: "CENTER" | "LEFT" | "RIGHT" | "JUSTIFIED" | undefined;
+    textAlignVertical?: "CENTER" | "TOP" | "BOTTOM" | undefined;
+    letterSpacing?: number | undefined;
+    lineHeightPx?: number | undefined;
+    lineHeightPercent?: number | undefined;
+    lineHeightUnit?: "PIXELS" | "FONT_SIZE_%" | "INTRINSIC_%" | undefined;
+    textCase?: "ORIGINAL" | "UPPER" | "LOWER" | "TITLE" | "SMALL_CAPS" | "SMALL_CAPS_FORCED" | undefined;
+    textDecoration?: "NONE" | "STRIKETHROUGH" | "UNDERLINE" | undefined;
+    paragraphSpacing?: number | undefined;
+    paragraphIndent?: number | undefined;
+}, {
+    fontFamily?: string | undefined;
+    fontPostScriptName?: string | undefined;
+    fontWeight?: number | undefined;
+    fontSize?: number | undefined;
+    textAlignHorizontal?: "CENTER" | "LEFT" | "RIGHT" | "JUSTIFIED" | undefined;
+    textAlignVertical?: "CENTER" | "TOP" | "BOTTOM" | undefined;
+    letterSpacing?: number | undefined;
+    lineHeightPx?: number | undefined;
+    lineHeightPercent?: number | undefined;
+    lineHeightUnit?: "PIXELS" | "FONT_SIZE_%" | "INTRINSIC_%" | undefined;
+    textCase?: "ORIGINAL" | "UPPER" | "LOWER" | "TITLE" | "SMALL_CAPS" | "SMALL_CAPS_FORCED" | undefined;
+    textDecoration?: "NONE" | "STRIKETHROUGH" | "UNDERLINE" | undefined;
+    paragraphSpacing?: number | undefined;
+    paragraphIndent?: number | undefined;
+}>;
+export type FigmaTextStyle = z.infer<typeof FigmaTextStyleSchema>;
+/**
+ * Effect (shadow, blur, etc.)
+ */
+export declare const FigmaEffectSchema: z.ZodObject<{
+    type: z.ZodEnum<["INNER_SHADOW", "DROP_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]>;
+    visible: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    radius: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        a: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }>>;
+    blendMode: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>>;
+    spread: z.ZodOptional<z.ZodNumber>;
+    showShadowBehindNode: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "INNER_SHADOW" | "DROP_SHADOW" | "LAYER_BLUR" | "BACKGROUND_BLUR";
+    visible: boolean;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    } | undefined;
+    blendMode?: string | undefined;
+    radius?: number | undefined;
+    offset?: {
+        x: number;
+        y: number;
+    } | undefined;
+    spread?: number | undefined;
+    showShadowBehindNode?: boolean | undefined;
+}, {
+    type: "INNER_SHADOW" | "DROP_SHADOW" | "LAYER_BLUR" | "BACKGROUND_BLUR";
+    visible?: boolean | undefined;
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    } | undefined;
+    blendMode?: string | undefined;
+    radius?: number | undefined;
+    offset?: {
+        x: number;
+        y: number;
+    } | undefined;
+    spread?: number | undefined;
+    showShadowBehindNode?: boolean | undefined;
+}>;
+export type FigmaEffect = z.infer<typeof FigmaEffectSchema>;
+/**
+ * Component property definition
+ */
+export declare const FigmaComponentPropertyDefinitionSchema: z.ZodObject<{
+    type: z.ZodEnum<["BOOLEAN", "TEXT", "INSTANCE_SWAP", "VARIANT"]>;
+    defaultValue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    variantOptions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    preferredValues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["COMPONENT", "COMPONENT_SET"]>;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "COMPONENT" | "COMPONENT_SET";
+        key: string;
+    }, {
+        type: "COMPONENT" | "COMPONENT_SET";
+        key: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "BOOLEAN" | "TEXT" | "INSTANCE_SWAP" | "VARIANT";
+    defaultValue?: string | boolean | undefined;
+    variantOptions?: string[] | undefined;
+    preferredValues?: {
+        type: "COMPONENT" | "COMPONENT_SET";
+        key: string;
+    }[] | undefined;
+}, {
+    type: "BOOLEAN" | "TEXT" | "INSTANCE_SWAP" | "VARIANT";
+    defaultValue?: string | boolean | undefined;
+    variantOptions?: string[] | undefined;
+    preferredValues?: {
+        type: "COMPONENT" | "COMPONENT_SET";
+        key: string;
+    }[] | undefined;
+}>;
+export type FigmaComponentPropertyDefinition = z.infer<typeof FigmaComponentPropertyDefinitionSchema>;
+/**
+ * All possible Figma node types
+ */
+export declare const FigmaNodeTypeSchema: z.ZodEnum<["DOCUMENT", "CANVAS", "FRAME", "GROUP", "SECTION", "VECTOR", "LINE", "ELLIPSE", "REGULAR_POLYGON", "STAR", "BOOLEAN_OPERATION", "RECTANGLE", "TEXT", "COMPONENT", "COMPONENT_SET", "INSTANCE", "SLICE", "STICKY", "SHAPE_WITH_TEXT", "CONNECTOR", "STAMP", "WIDGET", "EMBED", "LINK_UNFURL", "MEDIA", "TABLE", "TABLE_CELL", "WASHI_TAPE"]>;
+export type FigmaNodeType = z.infer<typeof FigmaNodeTypeSchema>;
+/**
+ * Base node interface - manually defined to avoid circular inference
+ */
+export interface FigmaBaseNode {
+    id: string;
+    name: string;
+    type: FigmaNodeType;
+    visible?: boolean;
+    locked?: boolean;
+    pluginData?: Record<string, unknown>;
+    sharedPluginData?: Record<string, Record<string, unknown>>;
+    componentPropertyReferences?: Record<string, string>;
+}
+/**
+ * Frame-like node interface (FRAME, GROUP, SECTION, COMPONENT, etc.)
+ */
+export interface FigmaFrameLikeNode extends FigmaBaseNode {
+    type: 'FRAME' | 'GROUP' | 'SECTION' | 'COMPONENT' | 'COMPONENT_SET' | 'INSTANCE';
+    absoluteBoundingBox?: FigmaRect;
+    absoluteRenderBounds?: FigmaRect | null;
+    constraints?: FigmaConstraints;
+    fills?: FigmaPaint[];
+    strokes?: FigmaPaint[];
+    strokeWeight?: number;
+    strokeAlign?: 'INSIDE' | 'OUTSIDE' | 'CENTER';
+    cornerRadius?: number;
+    rectangleCornerRadii?: [number, number, number, number];
+    effects?: FigmaEffect[];
+    blendMode?: string;
+    opacity?: number;
+    clipsContent?: boolean;
+    layoutMode?: 'NONE' | 'HORIZONTAL' | 'VERTICAL';
+    primaryAxisSizingMode?: 'FIXED' | 'AUTO';
+    counterAxisSizingMode?: 'FIXED' | 'AUTO';
+    primaryAxisAlignItems?: 'MIN' | 'CENTER' | 'MAX' | 'SPACE_BETWEEN';
+    counterAxisAlignItems?: 'MIN' | 'CENTER' | 'MAX' | 'BASELINE';
+    paddingLeft?: number;
+    paddingRight?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    itemSpacing?: number;
+    children?: FigmaNode[];
+    componentPropertyDefinitions?: Record<string, FigmaComponentPropertyDefinition>;
+    componentId?: string;
+    componentProperties?: Record<string, {
+        value: string | boolean;
+        type: string;
+    }>;
+}
+/**
+ * Text node interface
+ */
+export interface FigmaTextNode extends FigmaBaseNode {
+    type: 'TEXT';
+    absoluteBoundingBox?: FigmaRect;
+    fills?: FigmaPaint[];
+    strokes?: FigmaPaint[];
+    strokeWeight?: number;
+    effects?: FigmaEffect[];
+    characters?: string;
+    style?: FigmaTextStyle;
+    characterStyleOverrides?: number[];
+    styleOverrideTable?: Record<string, FigmaTextStyle>;
+}
+/**
+ * Vector-like node interface
+ */
+export interface FigmaVectorLikeNode extends FigmaBaseNode {
+    type: 'VECTOR' | 'LINE' | 'ELLIPSE' | 'REGULAR_POLYGON' | 'STAR' | 'BOOLEAN_OPERATION' | 'RECTANGLE';
+    absoluteBoundingBox?: FigmaRect;
+    fills?: FigmaPaint[];
+    strokes?: FigmaPaint[];
+    strokeWeight?: number;
+    effects?: FigmaEffect[];
+    cornerRadius?: number;
+    rectangleCornerRadii?: [number, number, number, number];
+}
+/**
+ * Document node interface
+ */
+export interface FigmaDocumentNode extends FigmaBaseNode {
+    type: 'DOCUMENT';
+    children: FigmaNode[];
+}
+/**
+ * Canvas (page) node interface
+ */
+export interface FigmaCanvasNode extends FigmaBaseNode {
+    type: 'CANVAS';
+    backgroundColor?: FigmaColor;
+    prototypeStartNodeID?: string | null;
+    flowStartingPoints?: Array<{
+        nodeId: string;
+        name: string;
+    }>;
+    children: FigmaNode[];
+}
+/**
+ * Union type for all Figma nodes
+ */
+export type FigmaNode = FigmaDocumentNode | FigmaCanvasNode | FigmaFrameLikeNode | FigmaTextNode | FigmaVectorLikeNode | (FigmaBaseNode & {
+    children?: FigmaNode[];
+});
+/**
+ * Permissive node schema that handles recursive children
+ * Uses passthrough to preserve all properties from API
+ */
+export declare const FigmaNodeSchema: z.ZodType<FigmaNode>;
+/**
+ * Component metadata
+ */
+export declare const FigmaComponentMetaSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    documentationLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+    }, {
+        uri: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+    documentationLinks?: {
+        uri: string;
+    }[] | undefined;
+}, {
+    key: string;
+    name: string;
+    description?: string | undefined;
+    documentationLinks?: {
+        uri: string;
+    }[] | undefined;
+}>;
+export type FigmaComponentMeta = z.infer<typeof FigmaComponentMetaSchema>;
+/**
+ * Style metadata
+ */
+export declare const FigmaStyleMetaSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    styleType: z.ZodEnum<["FILL", "TEXT", "EFFECT", "GRID"]>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+    description?: string | undefined;
+}, {
+    key: string;
+    name: string;
+    styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+    description?: string | undefined;
+}>;
+export type FigmaStyleMeta = z.infer<typeof FigmaStyleMetaSchema>;
+/**
+ * Full file response from GET /v1/files/:key
+ */
+export declare const FigmaFileResponseSchema: z.ZodObject<{
+    name: z.ZodString;
+    lastModified: z.ZodString;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<["owner", "editor", "viewer"]>>;
+    editorType: z.ZodOptional<z.ZodEnum<["figma", "figjam"]>>;
+    document: z.ZodType<FigmaNode, z.ZodTypeDef, FigmaNode>;
+    components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        documentationLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            uri: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+        }, {
+            uri: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }>>>;
+    componentSets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        documentationLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            uri: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+        }, {
+            uri: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }>>>;
+    styles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        styleType: z.ZodEnum<["FILL", "TEXT", "EFFECT", "GRID"]>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        name: string;
+        styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+        description?: string | undefined;
+    }, {
+        key: string;
+        name: string;
+        styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+        description?: string | undefined;
+    }>>>;
+    schemaVersion: z.ZodOptional<z.ZodNumber>;
+    mainFileKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    lastModified: string;
+    version: string;
+    document: FigmaNode;
+    role?: "owner" | "editor" | "viewer" | undefined;
+    thumbnailUrl?: string | undefined;
+    editorType?: "figma" | "figjam" | undefined;
+    components?: Record<string, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }> | undefined;
+    componentSets?: Record<string, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }> | undefined;
+    styles?: Record<string, {
+        key: string;
+        name: string;
+        styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+        description?: string | undefined;
+    }> | undefined;
+    schemaVersion?: number | undefined;
+    mainFileKey?: string | undefined;
+}, {
+    name: string;
+    lastModified: string;
+    version: string;
+    document: FigmaNode;
+    role?: "owner" | "editor" | "viewer" | undefined;
+    thumbnailUrl?: string | undefined;
+    editorType?: "figma" | "figjam" | undefined;
+    components?: Record<string, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }> | undefined;
+    componentSets?: Record<string, {
+        key: string;
+        name: string;
+        description?: string | undefined;
+        documentationLinks?: {
+            uri: string;
+        }[] | undefined;
+    }> | undefined;
+    styles?: Record<string, {
+        key: string;
+        name: string;
+        styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+        description?: string | undefined;
+    }> | undefined;
+    schemaVersion?: number | undefined;
+    mainFileKey?: string | undefined;
+}>;
+export type FigmaFileResponse = z.infer<typeof FigmaFileResponseSchema>;
+/**
+ * Partial file response for nodes endpoint GET /v1/files/:key/nodes
+ */
+export declare const FigmaNodesResponseSchema: z.ZodObject<{
+    name: z.ZodString;
+    lastModified: z.ZodString;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        document: z.ZodType<FigmaNode, z.ZodTypeDef, FigmaNode>;
+        components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            documentationLinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                uri: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                uri: string;
+            }, {
+                uri: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }>>>;
+        styles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            styleType: z.ZodEnum<["FILL", "TEXT", "EFFECT", "GRID"]>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        document: FigmaNode;
+        components?: Record<string, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }> | undefined;
+        styles?: Record<string, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }> | undefined;
+    }, {
+        document: FigmaNode;
+        components?: Record<string, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }> | undefined;
+        styles?: Record<string, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    lastModified: string;
+    version: string;
+    nodes: Record<string, {
+        document: FigmaNode;
+        components?: Record<string, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }> | undefined;
+        styles?: Record<string, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }> | undefined;
+    }>;
+    thumbnailUrl?: string | undefined;
+}, {
+    name: string;
+    lastModified: string;
+    version: string;
+    nodes: Record<string, {
+        document: FigmaNode;
+        components?: Record<string, {
+            key: string;
+            name: string;
+            description?: string | undefined;
+            documentationLinks?: {
+                uri: string;
+            }[] | undefined;
+        }> | undefined;
+        styles?: Record<string, {
+            key: string;
+            name: string;
+            styleType: "FILL" | "TEXT" | "EFFECT" | "GRID";
+            description?: string | undefined;
+        }> | undefined;
+    }>;
+    thumbnailUrl?: string | undefined;
+}>;
+export type FigmaNodesResponse = z.infer<typeof FigmaNodesResponseSchema>;
+/**
+ * Variable value types
+ */
+export declare const FigmaVariableValueSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"COLOR">;
+    value: z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        a: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }, {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    value: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    type: "COLOR";
+}, {
+    value: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    type: "COLOR";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"FLOAT">;
+    value: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    type: "FLOAT";
+}, {
+    value: number;
+    type: "FLOAT";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"STRING">;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    type: "STRING";
+}, {
+    value: string;
+    type: "STRING";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"BOOLEAN">;
+    value: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    value: boolean;
+    type: "BOOLEAN";
+}, {
+    value: boolean;
+    type: "BOOLEAN";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"VARIABLE_ALIAS">;
+    value: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    value: {
+        id: string;
+    };
+    type: "VARIABLE_ALIAS";
+}, {
+    value: {
+        id: string;
+    };
+    type: "VARIABLE_ALIAS";
+}>]>;
+export type FigmaVariableValue = z.infer<typeof FigmaVariableValueSchema>;
+/**
+ * Variable definition
+ */
+export declare const FigmaVariableSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    key: z.ZodString;
+    variableCollectionId: z.ZodString;
+    resolvedType: z.ZodEnum<["COLOR", "FLOAT", "STRING", "BOOLEAN"]>;
+    description: z.ZodOptional<z.ZodString>;
+    hiddenFromPublishing: z.ZodOptional<z.ZodBoolean>;
+    scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<["ALL_SCOPES", "TEXT_CONTENT", "CORNER_RADIUS", "WIDTH_HEIGHT", "GAP", "ALL_FILLS", "FRAME_FILL", "SHAPE_FILL", "TEXT_FILL", "STROKE_COLOR", "STROKE_FLOAT", "EFFECT_COLOR", "EFFECT_FLOAT", "OPACITY", "FONT_FAMILY", "FONT_STYLE", "FONT_WEIGHT", "FONT_SIZE", "LINE_HEIGHT", "LETTER_SPACING", "PARAGRAPH_SPACING", "PARAGRAPH_INDENT"]>, "many">>;
+    codeSyntax: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    valuesByMode: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    id: string;
+    name: string;
+    variableCollectionId: string;
+    resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+    valuesByMode: Record<string, unknown>;
+    description?: string | undefined;
+    hiddenFromPublishing?: boolean | undefined;
+    scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+    codeSyntax?: Record<string, string> | undefined;
+}, {
+    key: string;
+    id: string;
+    name: string;
+    variableCollectionId: string;
+    resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+    valuesByMode: Record<string, unknown>;
+    description?: string | undefined;
+    hiddenFromPublishing?: boolean | undefined;
+    scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+    codeSyntax?: Record<string, string> | undefined;
+}>;
+export type FigmaVariable = z.infer<typeof FigmaVariableSchema>;
+/**
+ * Variable collection
+ */
+export declare const FigmaVariableCollectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    key: z.ZodString;
+    modes: z.ZodArray<z.ZodObject<{
+        modeId: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        modeId: string;
+    }, {
+        name: string;
+        modeId: string;
+    }>, "many">;
+    defaultModeId: z.ZodString;
+    remote: z.ZodOptional<z.ZodBoolean>;
+    hiddenFromPublishing: z.ZodOptional<z.ZodBoolean>;
+    variableIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    id: string;
+    name: string;
+    modes: {
+        name: string;
+        modeId: string;
+    }[];
+    defaultModeId: string;
+    variableIds: string[];
+    hiddenFromPublishing?: boolean | undefined;
+    remote?: boolean | undefined;
+}, {
+    key: string;
+    id: string;
+    name: string;
+    modes: {
+        name: string;
+        modeId: string;
+    }[];
+    defaultModeId: string;
+    variableIds: string[];
+    hiddenFromPublishing?: boolean | undefined;
+    remote?: boolean | undefined;
+}>;
+export type FigmaVariableCollection = z.infer<typeof FigmaVariableCollectionSchema>;
+/**
+ * Variables response from GET /v1/files/:key/variables/local
+ */
+export declare const FigmaVariablesResponseSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodBoolean>;
+    meta: z.ZodObject<{
+        variables: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            key: z.ZodString;
+            variableCollectionId: z.ZodString;
+            resolvedType: z.ZodEnum<["COLOR", "FLOAT", "STRING", "BOOLEAN"]>;
+            description: z.ZodOptional<z.ZodString>;
+            hiddenFromPublishing: z.ZodOptional<z.ZodBoolean>;
+            scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<["ALL_SCOPES", "TEXT_CONTENT", "CORNER_RADIUS", "WIDTH_HEIGHT", "GAP", "ALL_FILLS", "FRAME_FILL", "SHAPE_FILL", "TEXT_FILL", "STROKE_COLOR", "STROKE_FLOAT", "EFFECT_COLOR", "EFFECT_FLOAT", "OPACITY", "FONT_FAMILY", "FONT_STYLE", "FONT_WEIGHT", "FONT_SIZE", "LINE_HEIGHT", "LETTER_SPACING", "PARAGRAPH_SPACING", "PARAGRAPH_INDENT"]>, "many">>;
+            codeSyntax: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            valuesByMode: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }>>;
+        variableCollections: z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            key: z.ZodString;
+            modes: z.ZodArray<z.ZodObject<{
+                modeId: z.ZodString;
+                name: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                modeId: string;
+            }, {
+                name: string;
+                modeId: string;
+            }>, "many">;
+            defaultModeId: z.ZodString;
+            remote: z.ZodOptional<z.ZodBoolean>;
+            hiddenFromPublishing: z.ZodOptional<z.ZodBoolean>;
+            variableIds: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        variables: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }>;
+        variableCollections: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }>;
+    }, {
+        variables: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }>;
+        variableCollections: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    meta: {
+        variables: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }>;
+        variableCollections: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }>;
+    };
+    error?: boolean | undefined;
+    status?: number | undefined;
+}, {
+    meta: {
+        variables: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            variableCollectionId: string;
+            resolvedType: "BOOLEAN" | "COLOR" | "FLOAT" | "STRING";
+            valuesByMode: Record<string, unknown>;
+            description?: string | undefined;
+            hiddenFromPublishing?: boolean | undefined;
+            scopes?: ("ALL_SCOPES" | "TEXT_CONTENT" | "CORNER_RADIUS" | "WIDTH_HEIGHT" | "GAP" | "ALL_FILLS" | "FRAME_FILL" | "SHAPE_FILL" | "TEXT_FILL" | "STROKE_COLOR" | "STROKE_FLOAT" | "EFFECT_COLOR" | "EFFECT_FLOAT" | "OPACITY" | "FONT_FAMILY" | "FONT_STYLE" | "FONT_WEIGHT" | "FONT_SIZE" | "LINE_HEIGHT" | "LETTER_SPACING" | "PARAGRAPH_SPACING" | "PARAGRAPH_INDENT")[] | undefined;
+            codeSyntax?: Record<string, string> | undefined;
+        }>;
+        variableCollections: Record<string, {
+            key: string;
+            id: string;
+            name: string;
+            modes: {
+                name: string;
+                modeId: string;
+            }[];
+            defaultModeId: string;
+            variableIds: string[];
+            hiddenFromPublishing?: boolean | undefined;
+            remote?: boolean | undefined;
+        }>;
+    };
+    error?: boolean | undefined;
+    status?: number | undefined;
+}>;
+export type FigmaVariablesResponse = z.infer<typeof FigmaVariablesResponseSchema>;
+/**
+ * Images response from GET /v1/images/:key
+ */
+export declare const FigmaImagesResponseSchema: z.ZodObject<{
+    err: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    images: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    images: Record<string, string | null>;
+    err?: string | null | undefined;
+}, {
+    images: Record<string, string | null>;
+    err?: string | null | undefined;
+}>;
+export type FigmaImagesResponse = z.infer<typeof FigmaImagesResponseSchema>;
+/**
+ * Options for GET /v1/files/:key
+ */
+export declare const GetFileOptionsSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    geometry: z.ZodOptional<z.ZodEnum<["paths", "bounds"]>>;
+    plugin_data: z.ZodOptional<z.ZodString>;
+    branch_data: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    version?: string | undefined;
+    depth?: number | undefined;
+    geometry?: "paths" | "bounds" | undefined;
+    plugin_data?: string | undefined;
+    branch_data?: boolean | undefined;
+}, {
+    version?: string | undefined;
+    depth?: number | undefined;
+    geometry?: "paths" | "bounds" | undefined;
+    plugin_data?: string | undefined;
+    branch_data?: boolean | undefined;
+}>;
+export type GetFileOptions = z.infer<typeof GetFileOptionsSchema>;
+/**
+ * Options for GET /v1/images/:key
+ */
+export declare const GetImagesOptionsSchema: z.ZodObject<{
+    scale: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<["jpg", "png", "svg", "pdf"]>>;
+    svg_include_id: z.ZodOptional<z.ZodBoolean>;
+    svg_simplify_stroke: z.ZodOptional<z.ZodBoolean>;
+    use_absolute_bounds: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    scale?: number | undefined;
+    format?: "jpg" | "png" | "svg" | "pdf" | undefined;
+    svg_include_id?: boolean | undefined;
+    svg_simplify_stroke?: boolean | undefined;
+    use_absolute_bounds?: boolean | undefined;
+}, {
+    scale?: number | undefined;
+    format?: "jpg" | "png" | "svg" | "pdf" | undefined;
+    svg_include_id?: boolean | undefined;
+    svg_simplify_stroke?: boolean | undefined;
+    use_absolute_bounds?: boolean | undefined;
+}>;
+export type GetImagesOptions = z.infer<typeof GetImagesOptionsSchema>;
+//# sourceMappingURL=figma-types.d.ts.map