@farcaster/snap 1.3.1 → 1.3.3

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { POST_GRID_TAP_KEY, PAGE_ROOT_TYPE, ELEMENT_TYPE, MEDIA_TYPE, DEFAULT_THEME_ACCENT, DEFAULT_LIST_STYLE, DEFAULT_SLIDER_STEP, PALETTE_COLOR, PALETTE_COLOR_VALUES, PALETTE_LIGHT_HEX, PALETTE_DARK_HEX, type PaletteColor, } from "./constants.js";
-export { rootSchema, firstPageRootSchema, payloadSchema, type SnapAction, type SnapContext, type SnapResponse, type SnapFunction, type SnapPayload, } from "./schemas.js";
+export { rootSchema, firstPageRootSchema, payloadSchema, type SnapAction, type SnapContext, type SnapResponse, type SnapResponseInput, type SnapFunction, type SnapPayload, } from "./schemas.js";
 export { validatePage, validateFirstPage, type ValidationResult, } from "./validator.js";

package/dist/schemas.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod/v4";
+import { z } from "zod";
 declare const buttonSchema: z.ZodObject<{
     label: z.ZodString;
     action: z.ZodEnum<{
@@ -1362,6 +1362,7 @@ export declare const payloadSchema: z.ZodObject<{
     timestamp: z.ZodNumber;
 }, z.core.$strict>;
 export type SnapResponse = z.infer<typeof rootSchema>;
+export type SnapResponseInput = z.input<typeof rootSchema>;
 export type SnapPage = SnapResponse["page"];
 export type SnapPayload = z.infer<typeof payloadSchema>;
 declare const snapPostActionSchema: z.ZodObject<{
@@ -1382,5 +1383,5 @@ export type SnapContext = {
     action: SnapAction;
     request: Request;
 };
-export type SnapFunction = (ctx: SnapContext) => Promise<SnapResponse>;
+export type SnapFunction = (ctx: SnapContext) => Promise<SnapResponseInput>;
 export {};

package/dist/schemas.js

@@ -1,4 +1,4 @@
-import { z } from "zod/v4";
+import { z } from "zod";
 import { BAR_CHART_COLOR_VALUES, BUTTON_ACTION, BUTTON_ACTION_VALUES, BUTTON_GROUP_STYLE, BUTTON_GROUP_STYLE_VALUES, BUTTON_LAYOUT_VALUES, BUTTON_STYLE_VALUES, DEFAULT_BUTTON_LAYOUT, DEFAULT_LIST_STYLE, DEFAULT_SLIDER_STEP, DEFAULT_THEME_ACCENT, EFFECT_VALUES, ELEMENT_TYPE, GRID_CELL_SIZE_VALUES, GRID_GAP_VALUES, GROUP_LAYOUT_VALUES, HEX_COLOR_6_RE, HTTP_PREFIX, HTTPS_PREFIX, IMAGE_ASPECT_VALUES, INTERACTIVE_ELEMENT_TYPES, LIMITS, LIST_STYLE_VALUES, MEDIA_ELEMENT_TYPES, PAGE_ROOT_TYPE, PALETTE_COLOR_VALUES, PROGRESS_COLOR_VALUES, SLIDER_STEP_ALIGN_EPS, SPACER_SIZE, SPACER_SIZE_VALUES, SPEC_VERSION, TEXT_ALIGN_VALUES, TEXT_CONTENT_MAX, TEXT_STYLE, TEXT_STYLE_VALUES, } from "./constants.js";
 /**
  * post/link/mini_app targets must be HTTPS in production; allow HTTP only for

package/dist/server/parseRequest.d.ts

@@ -1,5 +1,5 @@
 import { type SnapAction } from "../schemas.js";
-import { z } from "zod/v4";
+import { z } from "zod";
 export type ParseRequestError = {
     type: "method_not_allowed";
     message: string;

package/dist/server/parseRequest.js

@@ -1,6 +1,6 @@
 import { payloadSchema } from "../schemas.js";
 import { decodePayload, verifyJFSRequestBody } from "./verify.js";
-import { z } from "zod/v4";
+import { z } from "zod";
 /** Default replay window per SPEC.md § Replay Protection (5 minutes). */
 const DEFAULT_SNAP_POST_MAX_SKEW_SECONDS = 300;
 const requestBodySchema = z.object({

package/dist/ui/bar-chart.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const barChartProps: z.ZodObject<{
+    bars: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodNumber;
+        color: z.ZodOptional<z.ZodEnum<{
+            gray: "gray";
+            blue: "blue";
+            red: "red";
+            amber: "amber";
+            green: "green";
+            teal: "teal";
+            purple: "purple";
+            pink: "pink";
+        }>>;
+    }, z.core.$strip>>;
+    max: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodEnum<{
+        gray: "gray";
+        blue: "blue";
+        red: "red";
+        amber: "amber";
+        green: "green";
+        teal: "teal";
+        purple: "purple";
+        pink: "pink";
+        accent: "accent";
+    }>>;
+}, z.core.$strip>;
+export type BarChartProps = z.infer<typeof barChartProps>;

package/dist/ui/bar-chart.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { BAR_CHART_COLOR_VALUES, LIMITS, PALETTE_COLOR_VALUES, } from "../constants.js";
+export const barChartProps = z.object({
+    bars: z
+        .array(z.object({
+        label: z.string(),
+        value: z.number().nonnegative(),
+        color: z.enum(PALETTE_COLOR_VALUES).optional(),
+    }))
+        .min(1)
+        .max(LIMITS.maxBarChartBars),
+    max: z.number().nonnegative().optional(),
+    color: z.enum(BAR_CHART_COLOR_VALUES).optional(),
+});

package/dist/ui/button-group.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const buttonGroupProps: z.ZodObject<{
+    name: z.ZodString;
+    options: z.ZodArray<z.ZodString>;
+    style: z.ZodOptional<z.ZodEnum<{
+        row: "row";
+        stack: "stack";
+        grid: "grid";
+    }>>;
+}, z.core.$strip>;
+export type ButtonGroupProps = z.infer<typeof buttonGroupProps>;

package/dist/ui/button-group.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { BUTTON_GROUP_STYLE_VALUES, LIMITS } from "../constants.js";
+export const buttonGroupProps = z.object({
+    name: z.string().min(1),
+    options: z
+        .array(z.string())
+        .min(LIMITS.minButtonGroupOptions)
+        .max(LIMITS.maxButtonGroupOptions),
+    style: z.enum(BUTTON_GROUP_STYLE_VALUES).optional(),
+});

package/dist/ui/button.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const actionButtonProps: z.ZodObject<{
+    label: z.ZodString;
+    action: z.ZodEnum<{
+        post: "post";
+        link: "link";
+        mini_app: "mini_app";
+        sdk: "sdk";
+    }>;
+    target: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+    }>>;
+}, z.core.$strip>;
+export type ActionButtonProps = z.infer<typeof actionButtonProps>;
+/** Same schema as `actionButtonProps` (legacy export name). */
+export declare const buttonProps: z.ZodObject<{
+    label: z.ZodString;
+    action: z.ZodEnum<{
+        post: "post";
+        link: "link";
+        mini_app: "mini_app";
+        sdk: "sdk";
+    }>;
+    target: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+    }>>;
+}, z.core.$strip>;
+export type ButtonProps = ActionButtonProps;

package/dist/ui/button.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { BUTTON_ACTION_VALUES, BUTTON_STYLE_VALUES } from "../constants.js";
+export const actionButtonProps = z.object({
+    label: z.string(),
+    action: z.enum(BUTTON_ACTION_VALUES),
+    target: z.string(),
+    style: z.enum(BUTTON_STYLE_VALUES).optional(),
+});
+/** Same schema as `actionButtonProps` (legacy export name). */
+export const buttonProps = actionButtonProps;

package/dist/ui/catalog.d.ts

@@ -0,0 +1,271 @@
+import { z } from "zod";
+/**
+ * Basic catalog: one json-render component per snap element type, plus ActionButton for snap buttons.
+ * Does not validate cross-field rules (media count, height budget); snap JSON still goes through `@farcaster/snap` validation.
+ */
+export declare const snapJsonRenderCatalog: import("@json-render/core").Catalog<{
+    spec: import("@json-render/core").SchemaType<"object", {
+        root: import("@json-render/core").SchemaType<"string", unknown>;
+        elements: import("@json-render/core").SchemaType<"record", import("@json-render/core").SchemaType<"object", {
+            type: import("@json-render/core").SchemaType<"ref", string>;
+            props: import("@json-render/core").SchemaType<"propsOf", string>;
+            children: {
+                optional: true;
+                kind: "array";
+                inner?: import("@json-render/core").SchemaType<"string", unknown> | undefined;
+            };
+        }>>;
+    }>;
+    catalog: import("@json-render/core").SchemaType<"object", {
+        components: import("@json-render/core").SchemaType<"map", {
+            props: import("@json-render/core").SchemaType<"zod", unknown>;
+            description: import("@json-render/core").SchemaType<"string", unknown>;
+        }>;
+        actions: import("@json-render/core").SchemaType<"map", {
+            description: import("@json-render/core").SchemaType<"string", unknown>;
+            params: {
+                optional: true;
+                kind: "zod";
+                inner?: unknown;
+            };
+        }>;
+    }>;
+}, {
+    components: {
+        Text: {
+            props: z.ZodObject<{
+                style: z.ZodEnum<{
+                    title: "title";
+                    body: "body";
+                    caption: "caption";
+                    label: "label";
+                }>;
+                content: z.ZodString;
+                align: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    center: "center";
+                    right: "right";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Image: {
+            props: z.ZodObject<{
+                url: z.ZodString;
+                aspect: z.ZodEnum<{
+                    "1:1": "1:1";
+                    "16:9": "16:9";
+                    "4:3": "4:3";
+                    "3:4": "3:4";
+                    "9:16": "9:16";
+                }>;
+                alt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Divider: {
+            props: z.ZodObject<{}, z.core.$strip>;
+            description: string;
+        };
+        Spacer: {
+            props: z.ZodObject<{
+                size: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Progress: {
+            props: z.ZodObject<{
+                value: z.ZodNumber;
+                max: z.ZodNumber;
+                label: z.ZodOptional<z.ZodString>;
+                color: z.ZodOptional<z.ZodEnum<{
+                    gray: "gray";
+                    blue: "blue";
+                    red: "red";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    purple: "purple";
+                    pink: "pink";
+                    accent: "accent";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        List: {
+            props: z.ZodObject<{
+                style: z.ZodOptional<z.ZodEnum<{
+                    ordered: "ordered";
+                    unordered: "unordered";
+                    plain: "plain";
+                }>>;
+                items: z.ZodArray<z.ZodObject<{
+                    content: z.ZodString;
+                    trailing: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Grid: {
+            props: z.ZodObject<{
+                cols: z.ZodNumber;
+                rows: z.ZodNumber;
+                cells: z.ZodArray<z.ZodObject<{
+                    row: z.ZodNumber;
+                    col: z.ZodNumber;
+                    color: z.ZodOptional<z.ZodString>;
+                    content: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                cellSize: z.ZodOptional<z.ZodEnum<{
+                    auto: "auto";
+                    square: "square";
+                }>>;
+                gap: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    none: "none";
+                }>>;
+                interactive: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        TextInput: {
+            props: z.ZodObject<{
+                name: z.ZodString;
+                placeholder: z.ZodOptional<z.ZodString>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Slider: {
+            props: z.ZodObject<{
+                name: z.ZodString;
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+                step: z.ZodOptional<z.ZodNumber>;
+                value: z.ZodOptional<z.ZodNumber>;
+                label: z.ZodOptional<z.ZodString>;
+                minLabel: z.ZodOptional<z.ZodString>;
+                maxLabel: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        ButtonGroup: {
+            props: z.ZodObject<{
+                name: z.ZodString;
+                options: z.ZodArray<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    row: "row";
+                    stack: "stack";
+                    grid: "grid";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Toggle: {
+            props: z.ZodObject<{
+                name: z.ZodString;
+                label: z.ZodString;
+                value: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        BarChart: {
+            props: z.ZodObject<{
+                bars: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodNumber;
+                    color: z.ZodOptional<z.ZodEnum<{
+                        gray: "gray";
+                        blue: "blue";
+                        red: "red";
+                        amber: "amber";
+                        green: "green";
+                        teal: "teal";
+                        purple: "purple";
+                        pink: "pink";
+                    }>>;
+                }, z.core.$strip>>;
+                max: z.ZodOptional<z.ZodNumber>;
+                color: z.ZodOptional<z.ZodEnum<{
+                    gray: "gray";
+                    blue: "blue";
+                    red: "red";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    purple: "purple";
+                    pink: "pink";
+                    accent: "accent";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Group: {
+            props: z.ZodObject<{
+                layout: z.ZodEnum<{
+                    row: "row";
+                    grid: "grid";
+                }>;
+            }, z.core.$strip>;
+            description: string;
+        };
+        Stack: {
+            props: z.ZodObject<{}, z.core.$strip>;
+            description: string;
+        };
+        ActionButton: {
+            props: z.ZodObject<{
+                label: z.ZodString;
+                action: z.ZodEnum<{
+                    post: "post";
+                    link: "link";
+                    mini_app: "mini_app";
+                    sdk: "sdk";
+                }>;
+                target: z.ZodString;
+                style: z.ZodOptional<z.ZodEnum<{
+                    primary: "primary";
+                    secondary: "secondary";
+                }>>;
+            }, z.core.$strip>;
+            description: string;
+        };
+    };
+    actions: {
+        snap_post: {
+            description: string;
+            params: z.ZodObject<{
+                buttonIndex: z.ZodNumber;
+                target: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                style: z.ZodOptional<z.ZodEnum<{
+                    primary: "primary";
+                    secondary: "secondary";
+                }>>;
+            }, z.core.$strip>;
+        };
+        snap_link: {
+            description: string;
+            params: z.ZodObject<{
+                target: z.ZodString;
+            }, z.core.$strip>;
+        };
+        snap_mini_app: {
+            description: string;
+            params: z.ZodObject<{
+                target: z.ZodString;
+            }, z.core.$strip>;
+        };
+        snap_sdk: {
+            description: string;
+            params: z.ZodObject<{
+                target: z.ZodString;
+            }, z.core.$strip>;
+        };
+    };
+}>;

package/dist/ui/catalog.js

@@ -0,0 +1,114 @@
+import { defineCatalog } from "@json-render/core";
+import { z } from "zod";
+import { BUTTON_STYLE_VALUES } from "../constants.js";
+import { snapJsonRenderSchema } from "./schema.js";
+import { textProps } from "./text.js";
+import { imageProps } from "./image.js";
+import { dividerProps } from "./divider.js";
+import { spacerProps } from "./spacer.js";
+import { progressProps } from "./progress.js";
+import { listProps } from "./list.js";
+import { gridProps } from "./grid.js";
+import { textInputProps } from "./text-input.js";
+import { sliderProps } from "./slider.js";
+import { buttonGroupProps } from "./button-group.js";
+import { toggleProps } from "./toggle.js";
+import { barChartProps } from "./bar-chart.js";
+import { groupProps } from "./group.js";
+import { stackProps } from "./stack.js";
+import { actionButtonProps } from "./button.js";
+const snapPostParams = z.object({
+    buttonIndex: z.number().int().nonnegative(),
+    target: z.string(),
+    label: z.string().optional(),
+    style: z.enum(BUTTON_STYLE_VALUES).optional(),
+});
+const snapTargetParams = z.object({
+    target: z.string(),
+});
+/**
+ * Basic catalog: one json-render component per snap element type, plus ActionButton for snap buttons.
+ * Does not validate cross-field rules (media count, height budget); snap JSON still goes through `@farcaster/snap` validation.
+ */
+export const snapJsonRenderCatalog = defineCatalog(snapJsonRenderSchema, {
+    components: {
+        Text: {
+            props: textProps,
+            description: "Snap text block — style: title | body | caption | label; optional align.",
+        },
+        Image: {
+            props: imageProps,
+            description: "HTTPS image with fixed aspect ratio.",
+        },
+        Divider: {
+            props: dividerProps,
+            description: "Horizontal rule between blocks.",
+        },
+        Spacer: {
+            props: spacerProps,
+            description: "Vertical whitespace — size small | medium | large.",
+        },
+        Progress: {
+            props: progressProps,
+            description: "Horizontal progress bar (value/max, optional label and color).",
+        },
+        List: {
+            props: listProps,
+            description: "Ordered / unordered / plain list; max 4 items per snap spec.",
+        },
+        Grid: {
+            props: gridProps,
+            description: "Rows×cols cell grid; optional interactive empty cells for games.",
+        },
+        TextInput: {
+            props: textInputProps,
+            description: "Single-line input; `name` becomes POST inputs key.",
+        },
+        Slider: {
+            props: sliderProps,
+            description: "Numeric slider; `name` becomes POST inputs key.",
+        },
+        ButtonGroup: {
+            props: buttonGroupProps,
+            description: "Exclusive choice; `name` and selected option go into POST inputs.",
+        },
+        Toggle: {
+            props: toggleProps,
+            description: "Boolean toggle; `name` becomes POST inputs key.",
+        },
+        BarChart: {
+            props: barChartProps,
+            description: "Vertical bar chart for labeled values — poll results, rankings, breakdowns.",
+        },
+        Group: {
+            props: groupProps,
+            description: "Button row (`layout: row`) or 2-column grid (`layout: grid`); use `children` element ids only (no nested JSON objects).",
+        },
+        Stack: {
+            props: stackProps,
+            description: "Vertical stack for snap page body; maps from snap `page.elements` (`type: stack`). Children are element ids in order top to bottom.",
+        },
+        ActionButton: {
+            props: actionButtonProps,
+            description: "Snap action button: post (next page), link (browser), mini_app, sdk — target is HTTPS URL or SDK id.",
+        },
+    },
+    actions: {
+        snap_post: {
+            description: "POST to snap `target` with signed body (fid, inputs, button_index, timestamp, signature); response is next snap page JSON.",
+            params: snapPostParams,
+        },
+        snap_link: {
+            description: "Open `target` in the system browser; no server round-trip.",
+            params: snapTargetParams,
+        },
+        snap_mini_app: {
+            description: "Open `target` as an in-app Farcaster mini app.",
+            params: snapTargetParams,
+        },
+        snap_sdk: {
+            description: "Run a Farcaster client SDK action (cast:view, user:follow, …).",
+            params: snapTargetParams,
+        },
+    },
+});

package/dist/ui/divider.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod";
+export declare const dividerProps: z.ZodObject<{}, z.core.$strip>;
+export type DividerProps = z.infer<typeof dividerProps>;

package/dist/ui/divider.js

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export const dividerProps = z.object({});

package/dist/ui/grid.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const gridProps: z.ZodObject<{
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+    cells: z.ZodArray<z.ZodObject<{
+        row: z.ZodNumber;
+        col: z.ZodNumber;
+        color: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cellSize: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        square: "square";
+    }>>;
+    gap: z.ZodOptional<z.ZodEnum<{
+        small: "small";
+        medium: "medium";
+        none: "none";
+    }>>;
+    interactive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GridProps = z.infer<typeof gridProps>;

package/dist/ui/grid.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { GRID_CELL_SIZE_VALUES, GRID_GAP_VALUES, HEX_COLOR_6_RE, LIMITS, } from "../constants.js";
+const gridCellZ = z.object({
+    row: z.number().int().nonnegative(),
+    col: z.number().int().nonnegative(),
+    color: z.string().regex(HEX_COLOR_6_RE).optional(),
+    content: z.string().optional(),
+});
+export const gridProps = z.object({
+    cols: z.number().int().min(LIMITS.minGridCols).max(LIMITS.maxGridCols),
+    rows: z.number().int().min(LIMITS.minGridRows).max(LIMITS.maxGridRows),
+    cells: z.array(gridCellZ),
+    cellSize: z.enum(GRID_CELL_SIZE_VALUES).optional(),
+    gap: z.enum(GRID_GAP_VALUES).optional(),
+    interactive: z.boolean().optional(),
+});

package/dist/ui/group.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const groupProps: z.ZodObject<{
+    layout: z.ZodEnum<{
+        row: "row";
+        grid: "grid";
+    }>;
+}, z.core.$strip>;
+export type GroupProps = z.infer<typeof groupProps>;

package/dist/ui/group.js

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export const groupProps = z.object({
+    layout: z.enum(["row", "grid"]),
+});

package/dist/ui/image.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const imageProps: z.ZodObject<{
+    url: z.ZodString;
+    aspect: z.ZodEnum<{
+        "1:1": "1:1";
+        "16:9": "16:9";
+        "4:3": "4:3";
+        "3:4": "3:4";
+        "9:16": "9:16";
+    }>;
+    alt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImageProps = z.infer<typeof imageProps>;

package/dist/ui/image.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import { IMAGE_ASPECT_VALUES } from "../constants.js";
+export const imageProps = z.object({
+    url: z.string(),
+    aspect: z.enum(IMAGE_ASPECT_VALUES),
+    alt: z.string().optional(),
+});