@shoplix-ai/sdui-schema 1.4.0 → 1.6.0

package/dist/blocks.d.ts

@@ -1,8 +1,19 @@
 import { z } from 'zod';
 /** JSON-safe, for an editor that has to shape an id before the parse sees it. */
 export declare const BLOCK_ID_PATTERN = "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$";
+/**
+ * When a placed block of the cart screen draws, by the state of the held
+ * cart. Absent means always. The screen document holds it to the cart screen.
+ */
+export declare const CART_VISIBILITIES: readonly ["always", "when_empty", "when_has_lines"];
+export type CartVisibility = (typeof CART_VISIBILITIES)[number];
 export declare const textBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"text">;
     props: z.ZodObject<{
         text: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -13,9 +24,9 @@ export declare const textBlockSchema: z.ZodObject<{
             xl: "xl";
         }>>;
         weight: z.ZodOptional<z.ZodEnum<{
+            bold: "bold";
             regular: "regular";
             medium: "medium";
-            bold: "bold";
         }>>;
         align: z.ZodOptional<z.ZodEnum<{
             start: "start";
@@ -27,6 +38,11 @@ export declare const textBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const imageBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"image">;
     props: z.ZodObject<{
         image: z.ZodOptional<z.ZodObject<{
@@ -49,6 +65,11 @@ export declare const imageBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const buttonBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"button">;
     props: z.ZodObject<{
         label: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -68,6 +89,11 @@ export declare const buttonBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const spacerBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"spacer">;
     props: z.ZodObject<{
         size: z.ZodEnum<{
@@ -82,6 +108,11 @@ export declare const spacerBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const dividerBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"divider">;
     props: z.ZodObject<{
         label: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -90,6 +121,11 @@ export declare const dividerBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const sectionHeaderBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"section_header">;
     props: z.ZodObject<{
         title: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -109,6 +145,11 @@ export declare const sectionHeaderBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const searchBarBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"search_bar">;
     props: z.ZodObject<{
         placeholder: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -117,6 +158,11 @@ export declare const searchBarBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const videoBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"video">;
     props: z.ZodObject<{
         assetId: z.ZodOptional<z.ZodUUID>;
@@ -129,6 +175,11 @@ export declare const videoBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const heroBannerBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"hero_banner">;
     props: z.ZodObject<{
         title: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -153,6 +204,11 @@ export declare const heroBannerBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const promoBannerBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"promo_banner">;
     props: z.ZodObject<{
         image: z.ZodOptional<z.ZodObject<{
@@ -176,6 +232,11 @@ export declare const promoBannerBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const announcementBarBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"announcement_bar">;
     props: z.ZodObject<{
         text: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -184,6 +245,11 @@ export declare const announcementBarBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const countdownBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"countdown">;
     props: z.ZodObject<{
         endsAt: z.ZodISODateTime;
@@ -193,6 +259,11 @@ export declare const countdownBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const featureStripBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"feature_strip">;
     props: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
@@ -204,6 +275,11 @@ export declare const featureStripBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productCardBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_card">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -222,6 +298,11 @@ export declare const productCardBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productCarouselBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_carousel">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"products">;
@@ -255,6 +336,11 @@ export declare const productCarouselBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productGridBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_grid">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"products">;
@@ -289,6 +375,11 @@ export declare const productGridBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productListBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_list">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"products">;
@@ -322,6 +413,11 @@ export declare const productListBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const collectionCirclesBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"collection_circles">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"collections">;
@@ -334,6 +430,11 @@ export declare const collectionCirclesBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const collectionGridBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"collection_grid">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"collections">;
@@ -347,6 +448,11 @@ export declare const collectionGridBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const collectionRowBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"collection_row">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"collections">;
@@ -359,6 +465,11 @@ export declare const collectionRowBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productGalleryBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_gallery">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -371,6 +482,11 @@ export declare const productGalleryBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productSummaryBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_summary">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -388,6 +504,11 @@ export declare const productSummaryBlockSchema: z.ZodObject<{
  */
 export declare const variantPickerBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"variant_picker">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -405,6 +526,11 @@ export declare const variantPickerBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const addToCartBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"add_to_cart">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -419,6 +545,11 @@ export declare const addToCartBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const productSpecsBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"product_specs">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -431,6 +562,11 @@ export declare const productSpecsBlockSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const reviewsSlotBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodLiteral<"reviews_slot">;
     binding: z.ZodObject<{
         kind: z.ZodLiteral<"product">;
@@ -441,11 +577,134 @@ export declare const reviewsSlotBlockSchema: z.ZodObject<{
     props: z.ZodObject<{}, z.core.$strip>;
     children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
 }, z.core.$strip>;
-export declare const BLOCK_TYPES: readonly ["text", "image", "button", "spacer", "divider", "section_header", "search_bar", "video", "hero_banner", "promo_banner", "announcement_bar", "countdown", "feature_strip", "product_card", "product_carousel", "product_grid", "product_list", "collection_circles", "collection_grid", "collection_row", "product_gallery", "product_summary", "variant_picker", "add_to_cart", "product_specs", "reviews_slot"];
+/**
+ * The four platform cart blocks, welded to the held cart the way the buying
+ * blocks are welded to the product: subject form only, strict props, and
+ * nothing that wires behaviour. Each draws by the state of the cart it
+ * receives: the bound three draw nothing while the cart is empty, and the
+ * empty block draws only then.
+ */
+export declare const cartLinesBlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
+    type: z.ZodLiteral<"cart_lines">;
+    binding: z.ZodObject<{
+        kind: z.ZodLiteral<"cart">;
+        target: z.ZodObject<{
+            form: z.ZodLiteral<"subject">;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    props: z.ZodObject<{
+        imageSize: z.ZodOptional<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+        }>>;
+        variantTitle: z.ZodOptional<z.ZodBoolean>;
+        selectedOptions: z.ZodOptional<z.ZodBoolean>;
+        remove: z.ZodOptional<z.ZodBoolean>;
+        stepper: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            inline: "inline";
+        }>>;
+    }, z.core.$strict>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const cartSummaryBlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
+    type: z.ZodLiteral<"cart_summary">;
+    binding: z.ZodObject<{
+        kind: z.ZodLiteral<"cart">;
+        target: z.ZodObject<{
+            form: z.ZodLiteral<"subject">;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    props: z.ZodObject<{
+        discountLine: z.ZodOptional<z.ZodBoolean>;
+        total: z.ZodOptional<z.ZodBoolean>;
+        subtotalLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        discountLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        totalLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const checkoutButtonBlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
+    type: z.ZodLiteral<"checkout_button">;
+    binding: z.ZodObject<{
+        kind: z.ZodLiteral<"cart">;
+        target: z.ZodObject<{
+            form: z.ZodLiteral<"subject">;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    props: z.ZodObject<{
+        label: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            outline: "outline";
+            ghost: "ghost";
+        }>>;
+    }, z.core.$strict>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const cartEmptyBlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
+    type: z.ZodLiteral<"cart_empty">;
+    binding: z.ZodObject<{
+        kind: z.ZodLiteral<"cart">;
+        target: z.ZodObject<{
+            form: z.ZodLiteral<"subject">;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    props: z.ZodObject<{
+        text: z.ZodRecord<z.ZodString, z.ZodString>;
+        image: z.ZodOptional<z.ZodObject<{
+            assetId: z.ZodUUID;
+            alt: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>>;
+        action: 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">;
+    }, z.core.$strict>;
+    children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const BLOCK_TYPES: readonly ["text", "image", "button", "spacer", "divider", "section_header", "search_bar", "video", "hero_banner", "promo_banner", "announcement_bar", "countdown", "feature_strip", "product_card", "product_carousel", "product_grid", "product_list", "collection_circles", "collection_grid", "collection_row", "product_gallery", "product_summary", "variant_picker", "add_to_cart", "product_specs", "reviews_slot", "cart_lines", "cart_summary", "checkout_button", "cart_empty"];
 export type BlockType = (typeof BLOCK_TYPES)[number];
 export declare const KNOWN_BLOCK_SCHEMAS: {
     readonly text: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"text">;
         props: z.ZodObject<{
             text: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -456,9 +715,9 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
                 xl: "xl";
             }>>;
             weight: z.ZodOptional<z.ZodEnum<{
+                bold: "bold";
                 regular: "regular";
                 medium: "medium";
-                bold: "bold";
             }>>;
             align: z.ZodOptional<z.ZodEnum<{
                 start: "start";
@@ -470,6 +729,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly image: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"image">;
         props: z.ZodObject<{
             image: z.ZodOptional<z.ZodObject<{
@@ -492,6 +756,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly button: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"button">;
         props: z.ZodObject<{
             label: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -511,6 +780,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly spacer: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"spacer">;
         props: z.ZodObject<{
             size: z.ZodEnum<{
@@ -525,6 +799,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly divider: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"divider">;
         props: z.ZodObject<{
             label: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -533,6 +812,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly section_header: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"section_header">;
         props: z.ZodObject<{
             title: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -552,6 +836,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly search_bar: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"search_bar">;
         props: z.ZodObject<{
             placeholder: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -560,6 +849,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly video: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"video">;
         props: z.ZodObject<{
             assetId: z.ZodOptional<z.ZodUUID>;
@@ -572,6 +866,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly hero_banner: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"hero_banner">;
         props: z.ZodObject<{
             title: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -596,6 +895,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly promo_banner: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"promo_banner">;
         props: z.ZodObject<{
             image: z.ZodOptional<z.ZodObject<{
@@ -619,6 +923,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly announcement_bar: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"announcement_bar">;
         props: z.ZodObject<{
             text: z.ZodRecord<z.ZodString, z.ZodString>;
@@ -627,6 +936,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly countdown: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"countdown">;
         props: z.ZodObject<{
             endsAt: z.ZodISODateTime;
@@ -636,6 +950,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly feature_strip: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"feature_strip">;
         props: z.ZodObject<{
             items: z.ZodArray<z.ZodObject<{
@@ -647,6 +966,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_card: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_card">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -665,6 +989,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_carousel: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_carousel">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"products">;
@@ -698,6 +1027,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_grid: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_grid">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"products">;
@@ -732,6 +1066,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_list: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_list">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"products">;
@@ -765,6 +1104,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly collection_circles: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"collection_circles">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"collections">;
@@ -777,6 +1121,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly collection_grid: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"collection_grid">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"collections">;
@@ -790,6 +1139,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly collection_row: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"collection_row">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"collections">;
@@ -802,6 +1156,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_gallery: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_gallery">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -814,6 +1173,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_summary: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_summary">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -826,6 +1190,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly variant_picker: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"variant_picker">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -843,6 +1212,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly add_to_cart: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"add_to_cart">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -857,6 +1231,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly product_specs: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"product_specs">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -869,6 +1248,11 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
     }, z.core.$strip>;
     readonly reviews_slot: z.ZodObject<{
         id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
         type: z.ZodLiteral<"reviews_slot">;
         binding: z.ZodObject<{
             kind: z.ZodLiteral<"product">;
@@ -879,6 +1263,117 @@ export declare const KNOWN_BLOCK_SCHEMAS: {
         props: z.ZodObject<{}, z.core.$strip>;
         children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
     }, z.core.$strip>;
+    readonly cart_lines: z.ZodObject<{
+        id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
+        type: z.ZodLiteral<"cart_lines">;
+        binding: z.ZodObject<{
+            kind: z.ZodLiteral<"cart">;
+            target: z.ZodObject<{
+                form: z.ZodLiteral<"subject">;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        props: z.ZodObject<{
+            imageSize: z.ZodOptional<z.ZodEnum<{
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+            }>>;
+            variantTitle: z.ZodOptional<z.ZodBoolean>;
+            selectedOptions: z.ZodOptional<z.ZodBoolean>;
+            remove: z.ZodOptional<z.ZodBoolean>;
+            stepper: z.ZodOptional<z.ZodEnum<{
+                compact: "compact";
+                inline: "inline";
+            }>>;
+        }, z.core.$strict>;
+        children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
+    readonly cart_summary: z.ZodObject<{
+        id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
+        type: z.ZodLiteral<"cart_summary">;
+        binding: z.ZodObject<{
+            kind: z.ZodLiteral<"cart">;
+            target: z.ZodObject<{
+                form: z.ZodLiteral<"subject">;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        props: z.ZodObject<{
+            discountLine: z.ZodOptional<z.ZodBoolean>;
+            total: z.ZodOptional<z.ZodBoolean>;
+            subtotalLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            discountLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            totalLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+        children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
+    readonly checkout_button: z.ZodObject<{
+        id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
+        type: z.ZodLiteral<"checkout_button">;
+        binding: z.ZodObject<{
+            kind: z.ZodLiteral<"cart">;
+            target: z.ZodObject<{
+                form: z.ZodLiteral<"subject">;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        props: z.ZodObject<{
+            label: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                solid: "solid";
+                outline: "outline";
+                ghost: "ghost";
+            }>>;
+        }, z.core.$strict>;
+        children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
+    readonly cart_empty: z.ZodObject<{
+        id: z.ZodString;
+        cartVisibility: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            when_empty: "when_empty";
+            when_has_lines: "when_has_lines";
+        }>>;
+        type: z.ZodLiteral<"cart_empty">;
+        binding: z.ZodObject<{
+            kind: z.ZodLiteral<"cart">;
+            target: z.ZodObject<{
+                form: z.ZodLiteral<"subject">;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        props: z.ZodObject<{
+            text: z.ZodRecord<z.ZodString, z.ZodString>;
+            image: z.ZodOptional<z.ZodObject<{
+                assetId: z.ZodUUID;
+                alt: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>>;
+            action: 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">;
+        }, z.core.$strict>;
+        children: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
 };
 export type TextBlock = z.infer<typeof textBlockSchema>;
 export type ImageBlock = z.infer<typeof imageBlockSchema>;
@@ -906,7 +1401,11 @@ export type VariantPickerBlock = z.infer<typeof variantPickerBlockSchema>;
 export type AddToCartBlock = z.infer<typeof addToCartBlockSchema>;
 export type ProductSpecsBlock = z.infer<typeof productSpecsBlockSchema>;
 export type ReviewsSlotBlock = z.infer<typeof reviewsSlotBlockSchema>;
-export type KnownBlock = TextBlock | ImageBlock | ButtonBlock | SpacerBlock | DividerBlock | SectionHeaderBlock | SearchBarBlock | VideoBlock | HeroBannerBlock | PromoBannerBlock | AnnouncementBarBlock | CountdownBlock | FeatureStripBlock | ProductCardBlock | ProductCarouselBlock | ProductGridBlock | ProductListBlock | CollectionCirclesBlock | CollectionGridBlock | CollectionRowBlock | ProductGalleryBlock | ProductSummaryBlock | VariantPickerBlock | AddToCartBlock | ProductSpecsBlock | ReviewsSlotBlock;
+export type CartLinesBlock = z.infer<typeof cartLinesBlockSchema>;
+export type CartSummaryBlock = z.infer<typeof cartSummaryBlockSchema>;
+export type CheckoutButtonBlock = z.infer<typeof checkoutButtonBlockSchema>;
+export type CartEmptyBlock = z.infer<typeof cartEmptyBlockSchema>;
+export type KnownBlock = TextBlock | ImageBlock | ButtonBlock | SpacerBlock | DividerBlock | SectionHeaderBlock | SearchBarBlock | VideoBlock | HeroBannerBlock | PromoBannerBlock | AnnouncementBarBlock | CountdownBlock | FeatureStripBlock | ProductCardBlock | ProductCarouselBlock | ProductGridBlock | ProductListBlock | CollectionCirclesBlock | CollectionGridBlock | CollectionRowBlock | ProductGalleryBlock | ProductSummaryBlock | VariantPickerBlock | AddToCartBlock | ProductSpecsBlock | ReviewsSlotBlock | CartLinesBlock | CartSummaryBlock | CheckoutButtonBlock | CartEmptyBlock;
 /**
  * A block whose type this schema version does not know: a newer platform
  * type, or a Shop's own. It parses and keeps its content so renderers can
@@ -915,6 +1414,11 @@ export type KnownBlock = TextBlock | ImageBlock | ButtonBlock | SpacerBlock | Di
  */
 declare const unknownBlockSchema: z.ZodObject<{
     id: z.ZodString;
+    cartVisibility: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        when_empty: "when_empty";
+        when_has_lines: "when_has_lines";
+    }>>;
     type: z.ZodString;
 }, z.core.$loose>;
 export type UnknownBlock = z.infer<typeof unknownBlockSchema>;