@shoplix-ai/sdui-schema 1.0.0

package/dist/block-definition.d.ts

@@ -0,0 +1,1639 @@
+import { z } from 'zod';
+import type { AssetReference } from './assets.js';
+import { type BindingTargetForm } from './binding.js';
+import { type EnvelopePrimitiveNode, type PrimitiveNode } from './primitives.js';
+/** The closed set of what a merchant can set on a Composed Block. */
+export declare const SETTING_TYPES: readonly ["text", "toggle", "select", "number", "color", "image", "action", "rows", "section"];
+export type SettingType = (typeof SETTING_TYPES)[number];
+/** The types a repeatable row may hold: the leaves, never another rows or a header. */
+export declare const ROW_FIELD_TYPES: readonly ["text", "toggle", "select", "number", "color", "image", "action"];
+export type RowFieldType = (typeof ROW_FIELD_TYPES)[number];
+/** A color the merchant chose: a token role by default, a custom hex when they insist. */
+export declare const colorChoiceSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    token: z.ZodString;
+}, z.core.$strict>]>;
+export type ColorChoice = z.infer<typeof colorChoiceSchema>;
+export declare const textSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    maxLength: z.ZodOptional<z.ZodInt>;
+    default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const toggleSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    default: z.ZodOptional<z.ZodBoolean>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const selectSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    default: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const numberSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodNumber>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const colorSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"color">;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        token: z.ZodString;
+    }, z.core.$strict>]>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+/** One asset out of the Shop's library; null until the merchant picks one. */
+export declare const imageSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+/** Where a tap goes, from the same closed action set a platform block carries. */
+export declare const actionSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"action">;
+    default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"open_screen">;
+        screenId: z.ZodUUID;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_cart">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_url">;
+        url: z.ZodURL;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>], "type">>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+/** A heading in the panel, grouping the settings under it. It carries no value. */
+export declare const sectionSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"section">;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const rowFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    maxLength: z.ZodOptional<z.ZodInt>;
+    default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    default: z.ZodOptional<z.ZodBoolean>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    default: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodNumber>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"color">;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        token: z.ZodString;
+    }, z.core.$strict>]>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"action">;
+    default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"open_screen">;
+        screenId: z.ZodUUID;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_cart">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_url">;
+        url: z.ZodURL;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>], "type">>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>], "type">;
+/**
+ * A repeatable group of the leaf types with a ceiling on how many rows the
+ * merchant may add. The ceiling itself is held against the platform's own
+ * maximum where every other limit is held, so raising it is one number in one
+ * place rather than a schema change.
+ */
+export declare const rowsSettingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"rows">;
+    max: z.ZodInt;
+    fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const blockSettingSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    maxLength: z.ZodOptional<z.ZodInt>;
+    default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"toggle">;
+    default: z.ZodOptional<z.ZodBoolean>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    options: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    default: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    step: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodNumber>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"color">;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        token: z.ZodString;
+    }, z.core.$strict>]>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"action">;
+    default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"open_screen">;
+        screenId: z.ZodUUID;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_cart">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open_url">;
+        url: z.ZodURL;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>], "type">>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"rows">;
+    max: z.ZodInt;
+    fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"section">;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>], "type">;
+export type TextSetting = z.infer<typeof textSettingSchema>;
+export type ToggleSetting = z.infer<typeof toggleSettingSchema>;
+export type SelectSetting = z.infer<typeof selectSettingSchema>;
+export type NumberSetting = z.infer<typeof numberSettingSchema>;
+export type ColorSetting = z.infer<typeof colorSettingSchema>;
+export type ImageSetting = z.infer<typeof imageSettingSchema>;
+export type ActionSetting = z.infer<typeof actionSettingSchema>;
+export type SectionSetting = z.infer<typeof sectionSettingSchema>;
+export type RowFieldSetting = z.infer<typeof rowFieldSchema>;
+export type RowsSetting = z.infer<typeof rowsSettingSchema>;
+export type BlockSetting = z.infer<typeof blockSettingSchema>;
+/** A header names a group; it never names a value, so nothing may read it. */
+export declare function carriesValue(setting: BlockSetting): boolean;
+/** The Binding kinds a Private Block Type may declare, beside declaring none. */
+export declare const BLOCK_BINDING_KINDS: readonly ["product", "products", "collection", "collections"];
+export type BlockBindingKind = (typeof BLOCK_BINDING_KINDS)[number];
+/**
+ * Products and collections are never settings: the Binding slot is declared
+ * here, apart from them, with the kind and the target forms it accepts. The
+ * shape mirrors a platform block's manifest entry, so the pickers, the Screen
+ * Subject rules, the publish-time live check and the per-screen batched
+ * request work for a Shop's own block unchanged. A collections Binding names
+ * ids only, so it never accepts the subject form.
+ */
+export declare const blockBindingDeclarationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"none">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"product">;
+    targetForms: z.ZodArray<z.ZodEnum<{
+        literal: "literal";
+        subject: "subject";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"products">;
+    targetForms: z.ZodArray<z.ZodEnum<{
+        literal: "literal";
+        subject: "subject";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"collection">;
+    targetForms: z.ZodArray<z.ZodEnum<{
+        literal: "literal";
+        subject: "subject";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"collections">;
+    targetForms: z.ZodArray<z.ZodEnum<{
+        literal: "literal";
+    }>>;
+}, z.core.$strict>], "kind">;
+export type BlockBindingDeclaration = z.infer<typeof blockBindingDeclarationSchema>;
+/** The declaration as the ladder and the palette read it; null when the block binds nothing. */
+export declare function declaredBinding(declaration: BlockBindingDeclaration): {
+    kind: BlockBindingKind;
+    targetForms: readonly BindingTargetForm[];
+} | null;
+export declare const blockPlacementSchema: z.ZodObject<{
+    allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        custom: "custom";
+        product: "product";
+        collection: "collection";
+        search: "search";
+        home: "home";
+        cart: "cart";
+        account: "account";
+    }>>>;
+    maxPerScreen: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+export type BlockPlacement = z.infer<typeof blockPlacementSchema>;
+/**
+ * The closed capability set a Code Block may declare. It is code on the phone,
+ * never document content, and it does not grow without a new contract major:
+ * the contract package pins its own list to this one.
+ */
+export declare const BLOCK_CAPABILITY_NAMES: readonly ["addToCart", "openCart", "beginCheckout"];
+export type BlockCapabilityName = (typeof BLOCK_CAPABILITY_NAMES)[number];
+/**
+ * The versioned description of a Composed Block: what the merchant sets, what
+ * the block binds, where it may stand, and the body of Primitives it draws.
+ */
+export declare const composedBlockDefinitionSchema: z.ZodObject<{
+    body: z.ZodType<PrimitiveNode, unknown, z.core.$ZodTypeInternals<PrimitiveNode, unknown>>;
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"composed">;
+}, z.core.$strict>;
+/**
+ * The versioned description of a Code Block: the same settings, Binding and
+ * placement, the capabilities its renderer may reach for, the version of that
+ * renderer, and a height hint for the canvas card. No body ever: the code is
+ * compiled into the Shop's app and reaches phones on the code train alone.
+ */
+export declare const codeBlockDefinitionSchema: z.ZodObject<{
+    capabilities: z.ZodArray<z.ZodEnum<{
+        addToCart: "addToCart";
+        openCart: "openCart";
+        beginCheckout: "beginCheckout";
+    }>>;
+    rendererVersion: z.ZodInt;
+    heightHint: z.ZodOptional<z.ZodInt>;
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"code">;
+}, z.core.$strict>;
+export declare const blockDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    body: z.ZodType<PrimitiveNode, unknown, z.core.$ZodTypeInternals<PrimitiveNode, unknown>>;
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"composed">;
+}, z.core.$strict>, z.ZodObject<{
+    capabilities: z.ZodArray<z.ZodEnum<{
+        addToCart: "addToCart";
+        openCart: "openCart";
+        beginCheckout: "beginCheckout";
+    }>>;
+    rendererVersion: z.ZodInt;
+    heightHint: z.ZodOptional<z.ZodInt>;
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"code">;
+}, z.core.$strict>], "kind">;
+export type ComposedBlockDefinition = z.infer<typeof composedBlockDefinitionSchema> & {
+    body: PrimitiveNode;
+};
+export type CodeBlockDefinition = z.infer<typeof codeBlockDefinitionSchema>;
+export type BlockDefinition = ComposedBlockDefinition | CodeBlockDefinition;
+export type BlockDefinitionKind = BlockDefinition['kind'];
+/** A definition as a Release froze it: unlike the push schema, an unknown Primitive is kept. */
+export declare const envelopeComposedBlockDefinitionSchema: z.ZodObject<{
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"composed">;
+    body: z.ZodType<EnvelopePrimitiveNode, unknown, z.core.$ZodTypeInternals<EnvelopePrimitiveNode, unknown>>;
+}, z.core.$strict>;
+export declare const envelopeBlockDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"composed">;
+    body: z.ZodType<EnvelopePrimitiveNode, unknown, z.core.$ZodTypeInternals<EnvelopePrimitiveNode, unknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    capabilities: z.ZodArray<z.ZodEnum<{
+        addToCart: "addToCart";
+        openCart: "openCart";
+        beginCheckout: "beginCheckout";
+    }>>;
+    rendererVersion: z.ZodInt;
+    heightHint: z.ZodOptional<z.ZodInt>;
+    label: z.ZodString;
+    settings: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        maxLength: z.ZodOptional<z.ZodInt>;
+        default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        default: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>;
+        default: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        step: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"color">;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strict>]>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"action">;
+        default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"open_screen">;
+            screenId: z.ZodUUID;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_cart">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"open_url">;
+            url: z.ZodURL;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rows">;
+        max: z.ZodInt;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            maxLength: z.ZodOptional<z.ZodInt>;
+            default: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"toggle">;
+            default: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            default: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            step: z.ZodOptional<z.ZodNumber>;
+            unit: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"color">;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                token: z.ZodString;
+            }, z.core.$strict>]>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"action">;
+            default: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"open_screen">;
+                screenId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_cart">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"open_url">;
+                url: z.ZodURL;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"none">;
+            }, z.core.$strip>], "type">>;
+            key: z.ZodString;
+            label: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>], "type">>;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        key: z.ZodString;
+        label: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>], "type">>;
+    binding: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"products">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collection">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+            subject: "subject";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"collections">;
+        targetForms: z.ZodArray<z.ZodEnum<{
+            literal: "literal";
+        }>>;
+    }, z.core.$strict>], "kind">;
+    placement: z.ZodObject<{
+        allowedScreenKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            product: "product";
+            collection: "collection";
+            search: "search";
+            home: "home";
+            cart: "cart";
+            account: "account";
+        }>>>;
+        maxPerScreen: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+    kind: z.ZodLiteral<"code">;
+}, z.core.$strict>], "kind">;
+export type EnvelopeComposedBlockDefinition = Omit<ComposedBlockDefinition, 'body'> & {
+    body: EnvelopePrimitiveNode;
+};
+export type EnvelopeBlockDefinition = EnvelopeComposedBlockDefinition | CodeBlockDefinition;
+/** The one problem a caller maps to a limit code of its own; everything else is a plain refusal. */
+export type SettingValueIssueCode = 'rows_over_max';
+export interface SettingValueIssue {
+    readonly path: string;
+    readonly message: string;
+    readonly code?: SettingValueIssueCode;
+}
+/**
+ * A placed Composed Block's props held against its live definition: every
+ * setting present, nothing undeclared, each value in its setting's shape.
+ */
+export declare function composedBlockPropsIssues(settings: readonly BlockSetting[], props: unknown): SettingValueIssue[];
+/**
+ * The props of a placed Composed Block as a JSON Schema, generated from the
+ * same zod rules the validator applies, for an editor completing a mock or
+ * a props file by hand.
+ */
+export declare function describeComposedBlockProps(settings: readonly BlockSetting[]): Record<string, unknown>;
+/** The props a fresh drop starts with: each setting's default, or the plainest value it accepts. */
+export declare function defaultComposedBlockProps(settings: readonly BlockSetting[]): Record<string, unknown>;
+/** What one fresh row of a repeatable setting holds, so the panel can add one. */
+export declare function defaultRowValue(setting: RowsSetting): Record<string, unknown>;
+/**
+ * Every asset a placed Composed Block's props name, rows included, each with
+ * the prop path that names it — so a refusal can point the merchant at the
+ * field they still have to fill.
+ */
+export declare function composedPropAssetReferences(settings: readonly BlockSetting[], props: unknown): readonly AssetReference[];
+//# sourceMappingURL=block-definition.d.ts.map