create-tanqory-theme 0.0.0-stage → 0.2.2

package/templates/nova/templates/page.about.json

@@ -0,0 +1,134 @@
+{
+  "contentVersion": 2,
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  },
+  "sections": [
+    {
+      "type": "hero",
+      "id": "hero",
+      "settings": {
+        "layout": "image-background",
+        "eyebrow": "Our story",
+        "heading": "Tell the story of your store",
+        "subtext": "",
+        "buttonLabel": "",
+        "backgroundImage": "data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%201200%20500%22%20preserveAspectRatio=%22xMidYMid%20slice%22%20width=%221600%22%20height=%22900%22%3E%3Crect%20data-dc-tpl=%22140%22%20width=%221200%22%20height=%22500%22%20style=%22fill:%20%23E6EAEC;%22%3E%3C/rect%3E%3Cpath%20data-dc-tpl=%22141%22%20d=%22M760%20360V190a150%20150%200%200%201%20300%200v170z%22%20style=%22fill:%20%23F4F6F6;%22%3E%3C/path%3E%3Crect%20data-dc-tpl=%22142%22%20x=%22908%22%20y=%2240%22%20width=%224%22%20height=%22320%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22143%22%20x=%22760%22%20y=%22250%22%20width=%22300%22%20height=%224%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22144%22%20y=%22360%22%20width=%221200%22%20height=%22140%22%20style=%22fill:%20%23DCE2E4;%22%3E%3C/rect%3E%3Cellipse%20data-dc-tpl=%22145%22%20cx=%22910%22%20cy=%22420%22%20rx=%22250%22%20ry=%2230%22%20opacity=%22.7%22%20style=%22fill:%20%23F4F6F6;%22%3E%3C/ellipse%3E%3Crect%20data-dc-tpl=%22146%22%20x=%22120%22%20y=%22298%22%20width=%22480%22%20height=%2216%22%20rx=%228%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22147%22%20x=%22160%22%20y=%22314%22%20width=%2212%22%20height=%2264%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22148%22%20x=%22548%22%20y=%22314%22%20width=%2212%22%20height=%2264%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22149%22%20x=%22200%22%20y=%22198%22%20width=%2262%22%20height=%22100%22%20rx=%2214%22%20style=%22fill:%20%23CCD4D7;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22150%22%20cx=%22332%22%20cy=%22266%22%20r=%2232%22%20style=%22fill:%20%23B5C0C4;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22151%22%20x=%22400%22%20y=%22234%22%20width=%2292%22%20height=%2264%22%20rx=%2210%22%20style=%22fill:%20%23CCD4D7;%22%3E%3C/rect%3E%3C/svg%3E",
+        "size": "large",
+        "contentPosition": "bottom",
+        "overlay": "medium"
+      }
+    },
+    {
+      "type": "rich-text",
+      "id": "intro",
+      "settings": {
+        "heading": "Why you started",
+        "body": "<p>A paragraph or two on what you make, where, and why it matters to you.</p>",
+        "headingSize": "h2",
+        "width": "narrow"
+      }
+    },
+    {
+      "type": "image-with-text",
+      "id": "studio",
+      "settings": {
+        "image": "data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%20400%20300%22%20preserveAspectRatio=%22xMidYMid%20slice%22%20width=%221200%22%20height=%22900%22%3E%3Crect%20data-dc-tpl=%22202%22%20width=%22400%22%20height=%22300%22%20style=%22fill:%20%23E5EAE6;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22203%22%20x=%2240%22%20y=%2258%22%20width=%22320%22%20height=%22242%22%20style=%22fill:%20%23DAE1DC;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22204%22%20x=%22130%22%20y=%2270%22%20width=%22140%22%20height=%2212%22%20rx=%226%22%20style=%22fill:%20%23C8D3CC;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22205%22%20x=%2230%22%20y=%2292%22%20width=%22340%22%20height=%2226%22%20rx=%224%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22206%22%20cx=%2240%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22207%22%20cx=%2260%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22208%22%20cx=%2280%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22209%22%20cx=%22100%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22210%22%20cx=%22120%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22211%22%20cx=%22140%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22212%22%20cx=%22160%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22213%22%20cx=%22180%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22214%22%20cx=%22200%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22215%22%20cx=%22220%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22216%22%20cx=%22240%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22217%22%20cx=%22260%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22218%22%20cx=%22280%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22219%22%20cx=%22300%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22220%22%20cx=%22320%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22221%22%20cx=%22340%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Ccircle%20data-dc-tpl=%22222%22%20cx=%22360%22%20cy=%22118%22%20r=%2210%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22223%22%20x=%2264%22%20y=%22142%22%20width=%22178%22%20height=%22120%22%20rx=%224%22%20style=%22fill:%20%23F2F5F2;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22224%22%20x=%2288%22%20y=%22198%22%20width=%2230%22%20height=%2264%22%20rx=%226%22%20style=%22fill:%20%23C8D3CC;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22225%22%20cx=%22160%22%20cy=%22238%22%20r=%2222%22%20style=%22fill:%20%23C8D3CC;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22226%22%20x=%22194%22%20y=%22214%22%20width=%2230%22%20height=%2248%22%20rx=%224%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/rect%3E%3Crect%20data-dc-tpl=%22227%22%20x=%22262%22%20y=%22142%22%20width=%2276%22%20height=%22158%22%20rx=%224%22%20style=%22fill:%20%23C8D3CC;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22228%22%20cx=%22324%22%20cy=%22224%22%20r=%224%22%20style=%22fill:%20%23AFBDB4;%22%3E%3C/circle%3E%3Crect%20data-dc-tpl=%22229%22%20y=%22290%22%20width=%22400%22%20height=%2210%22%20style=%22fill:%20%23C8D3CC;%22%3E%3C/rect%3E%3C/svg%3E",
+        "mediaPosition": "start",
+        "mediaRatio": "landscape",
+        "eyebrow": "Where",
+        "heading": "Where your products are made",
+        "body": "Describe the place and the process."
+      }
+    },
+    {
+      "type": "image-with-text",
+      "id": "makers",
+      "settings": {
+        "image": "data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20viewBox=%220%200%20400%20300%22%20preserveAspectRatio=%22xMidYMid%20slice%22%20width=%221200%22%20height=%22900%22%3E%3Crect%20data-dc-tpl=%22286%22%20width=%22400%22%20height=%22300%22%20style=%22fill:%20%23ECEAE6;%22%3E%3C/rect%3E%3Cpath%20data-dc-tpl=%22287%22%20d=%22M220%20212V124a60%2060%200%200%201%20120%200v88z%22%20style=%22fill:%20%23F6F5F2;%22%3E%3C/path%3E%3Crect%20data-dc-tpl=%22288%22%20y=%22212%22%20width=%22400%22%20height=%2288%22%20style=%22fill:%20%23E3E0DA;%22%3E%3C/rect%3E%3Cellipse%20data-dc-tpl=%22289%22%20cx=%22130%22%20cy=%22212%22%20rx=%2270%22%20ry=%226%22%20opacity=%22.5%22%20style=%22fill:%20%23C4BDB3;%22%3E%3C/ellipse%3E%3Crect%20data-dc-tpl=%22290%22%20x=%2282%22%20y=%22130%22%20width=%2250%22%20height=%2282%22%20rx=%2212%22%20style=%22fill:%20%23D5D0C8;%22%3E%3C/rect%3E%3Ccircle%20data-dc-tpl=%22291%22%20cx=%22164%22%20cy=%22188%22%20r=%2224%22%20style=%22fill:%20%23C4BDB3;%22%3E%3C/circle%3E%3C/svg%3E",
+        "mediaPosition": "end",
+        "mediaRatio": "landscape",
+        "eyebrow": "Who",
+        "heading": "The people behind them",
+        "body": "Introduce the people who make or choose what you sell."
+      }
+    },
+    {
+      "type": "timeline",
+      "id": "milestones",
+      "settings": {
+        "heading": "Milestones",
+        "layout": "horizontal",
+        "numbering": "numbers",
+        "columns": 4
+      },
+      "blocks": [
+        {
+          "type": "step",
+          "id": "milestone-1",
+          "settings": {
+            "heading": "Milestone 1",
+            "body": "A line about this moment in your story."
+          }
+        },
+        {
+          "type": "step",
+          "id": "milestone-2",
+          "settings": {
+            "heading": "Milestone 2",
+            "body": "A line about this moment in your story."
+          }
+        },
+        {
+          "type": "step",
+          "id": "milestone-3",
+          "settings": {
+            "heading": "Milestone 3",
+            "body": "A line about this moment in your story."
+          }
+        },
+        {
+          "type": "step",
+          "id": "milestone-4",
+          "settings": {
+            "heading": "Milestone 4",
+            "body": "A line about this moment in your story."
+          }
+        }
+      ]
+    },
+    {
+      "type": "logo-list",
+      "id": "logos",
+      "settings": {
+        "heading": "As seen in",
+        "columns": "6",
+        "grayscale": true,
+        "logoHeight": "medium"
+      },
+      "blocks": [
+        {
+          "type": "logo",
+          "id": "logo-1",
+          "settings": {}
+        },
+        {
+          "type": "logo",
+          "id": "logo-2",
+          "settings": {}
+        },
+        {
+          "type": "logo",
+          "id": "logo-3",
+          "settings": {}
+        },
+        {
+          "type": "logo",
+          "id": "logo-4",
+          "settings": {}
+        }
+      ]
+    }
+  ]
+}

package/templates/nova/templates/page.contact.json

@@ -0,0 +1,27 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "page-body",
+      "id": "page-body",
+      "settings": {
+        "fallbackTitle": "Contact us",
+        "fallbackBody": "<p>We'd love to hear from you. Send us a message.</p>"
+      }
+    },
+    {
+      "type": "contact-form",
+      "id": "form",
+      "settings": {
+        "heading": "Send us a message",
+        "subheading": "We read every note.",
+        "buttonLabel": "Send message",
+        "fields": "name,email,message"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/page.json

@@ -0,0 +1,27 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "breadcrumbs",
+      "id": "breadcrumbs",
+      "settings": {
+        "separator": "/",
+        "mobileStyle": "back-link",
+        "showCurrent": true
+      }
+    },
+    {
+      "type": "page-body",
+      "id": "main",
+      "settings": {
+        "fallbackTitle": "Page",
+        "fallbackBody": "<p>This page hasn't been published yet.</p>",
+        "textWidth": "narrow"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/policy.json

@@ -0,0 +1,23 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "breadcrumbs",
+      "id": "breadcrumbs",
+      "settings": {
+        "separator": "/",
+        "mobileStyle": "back-link",
+        "showCurrent": true
+      }
+    },
+    {
+      "type": "policy-page",
+      "id": "policy",
+      "settings": {}
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/product.bundle.json

@@ -0,0 +1,145 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "product-details",
+      "id": "main",
+      "settings": {
+        "galleryLayout": "stacked",
+        "buttonLabel": "Add set to cart",
+        "showQuantity": true,
+        "showBreadcrumb": false,
+        "stickyAddToCart": "mobile"
+      },
+      "blocks": [
+        {
+          "type": "variant-picker",
+          "id": "variant-picker",
+          "settings": {}
+        },
+        {
+          "type": "quantity",
+          "id": "quantity",
+          "settings": {}
+        },
+        {
+          "type": "tab",
+          "id": "tab-set",
+          "settings": {
+            "heading": "What's in the set",
+            "source": "custom",
+            "body": "",
+            "layout": "accordion"
+          }
+        },
+        {
+          "type": "tab",
+          "id": "tab-care",
+          "settings": {
+            "heading": "Care",
+            "source": "custom",
+            "body": "",
+            "layout": "accordion"
+          }
+        }
+      ]
+    },
+    {
+      "type": "multicolumn",
+      "id": "in-this-set",
+      "settings": {
+        "heading": "In this set",
+        "columns": 3,
+        "showImage": true,
+        "imageRatio": "landscape",
+        "textAlignment": "left"
+      },
+      "blocks": [
+        {
+          "type": "column",
+          "id": "set-item-1",
+          "settings": {
+            "heading": "Item 1",
+            "body": "Describe this piece of the set.",
+            "linkLabel": "Buy on its own",
+            "icon": "none"
+          }
+        },
+        {
+          "type": "column",
+          "id": "set-item-2",
+          "settings": {
+            "heading": "Item 2",
+            "body": "Describe this piece of the set.",
+            "linkLabel": "Buy on its own",
+            "icon": "none"
+          }
+        },
+        {
+          "type": "column",
+          "id": "set-item-3",
+          "settings": {
+            "heading": "Item 3",
+            "body": "Describe this piece of the set.",
+            "linkLabel": "Buy on its own",
+            "icon": "none"
+          }
+        }
+      ]
+    },
+    {
+      "type": "trust-badges",
+      "id": "trust",
+      "settings": {
+        "style": "compact",
+        "dividers": true,
+        "iconSize": "sm",
+        "alignment": "start"
+      },
+      "blocks": [
+        {
+          "type": "badge",
+          "id": "trust-badge-1",
+          "settings": {
+            "icon": "truck"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-2",
+          "settings": {
+            "icon": "return"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-3",
+          "settings": {
+            "icon": "shield"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-4",
+          "settings": {
+            "icon": "chat"
+          }
+        }
+      ]
+    },
+    {
+      "type": "product-recommendations",
+      "id": "recommendations",
+      "settings": {
+        "heading": "You may also like",
+        "limit": 4,
+        "layout": "grid",
+        "intent": "related"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/product.json

@@ -0,0 +1,119 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "breadcrumbs",
+      "id": "breadcrumbs",
+      "settings": {
+        "separator": "/",
+        "mobileStyle": "back-link",
+        "showCurrent": true
+      }
+    },
+    {
+      "type": "product-details",
+      "id": "main",
+      "settings": {
+        "buttonLabel": "Add to cart",
+        "showVendor": false,
+        "showSku": false,
+        "showInventory": "low-only",
+        "showQuantity": true,
+        "showBreadcrumb": false,
+        "stickyAddToCart": "mobile",
+        "stickyShowVariant": true
+      },
+      "blocks": [
+        {
+          "type": "variant-picker",
+          "id": "variant-picker",
+          "settings": {}
+        },
+        {
+          "type": "quantity",
+          "id": "quantity",
+          "settings": {}
+        },
+        {
+          "type": "product-inventory",
+          "id": "inventory",
+          "settings": {}
+        },
+        {
+          "type": "tab",
+          "id": "tab-care",
+          "settings": {
+            "heading": "Materials & care",
+            "source": "custom",
+            "body": "",
+            "layout": "accordion"
+          }
+        },
+        {
+          "type": "tab",
+          "id": "tab-shipping",
+          "settings": {
+            "heading": "Shipping & returns",
+            "source": "custom",
+            "body": "",
+            "layout": "accordion"
+          }
+        }
+      ]
+    },
+    {
+      "type": "trust-badges",
+      "id": "trust",
+      "settings": {
+        "style": "compact",
+        "dividers": true,
+        "iconSize": "sm",
+        "alignment": "start"
+      },
+      "blocks": [
+        {
+          "type": "badge",
+          "id": "trust-badge-1",
+          "settings": {
+            "icon": "truck"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-2",
+          "settings": {
+            "icon": "return"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-3",
+          "settings": {
+            "icon": "shield"
+          }
+        },
+        {
+          "type": "badge",
+          "id": "trust-badge-4",
+          "settings": {
+            "icon": "chat"
+          }
+        }
+      ]
+    },
+    {
+      "type": "product-recommendations",
+      "id": "recommendations",
+      "settings": {
+        "heading": "You may also like",
+        "limit": 4,
+        "layout": "grid",
+        "intent": "related"
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/templates/search.json

@@ -0,0 +1,17 @@
+{
+  "contentVersion": 2,
+  "sections": [
+    {
+      "type": "search-results",
+      "id": "results",
+      "settings": {
+        "emptyHeading": "Search",
+        "emptySub": "Type a query above to find products, collections, and pages."
+      }
+    }
+  ],
+  "groups": {
+    "header": "header",
+    "footer": "footer"
+  }
+}

package/templates/nova/tests/abi-ai-contract.test.ts

@@ -0,0 +1,99 @@
+/**
+ * What the AI store builder assumes about a Nova theme
+ * (the platform AI service docs/ONLINESTORE_INTEGRATION.md §3 and the §4 checklist), asserted on the
+ * two catalogues the platform reads:
+ *
+ *   theme.manifest.json   what studio-api's `/tq/v2/catalog` and save validator serve to ai-api; every
+ *                         entry here has its `source` OUTSIDE sections/ (src/…), so studio-api must trust
+ *                         the manifest for it (`ownsExternalSource`) — the entry must therefore carry the
+ *                         full attributes WITH options, not only the type name;
+ *   lib/abi/generated/manifest.json   the ABI manifest storefront-control validates content against.
+ */
+import { describe, expect, it } from 'vitest'
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import v1 from '../theme.manifest.json'
+import abi from '../lib/abi/generated/manifest.json'
+
+type Attr = { type: string; options?: { value: string }[]; default?: unknown; visible_if?: string }
+type Entry = { name: string; source: string; sourceHash?: string; role: string; attributes: Record<string, Attr>; placement?: { parents?: string[] } }
+const sections = (v1 as unknown as { sections: Entry[] }).sections
+const byName = Object.fromEntries(sections.map((s) => [s.name, s]))
+const components = (abi as unknown as { components: Record<string, { attributes: Record<string, Attr> }> }).components
+const settingKeys = new Set((abi as unknown as { settingsSchema: { items: { key: string }[] }[] }).settingsSchema.flatMap((g) => g.items.map((i) => i.key)))
+const ROOT = join(import.meta.dirname ?? __dirname, '..')
+
+describe('§4 item 1 / item 6 — the catalogue is complete', () => {
+  it('every entry has a source file in the theme, a hash, and attributes', () => {
+    for (const s of sections) {
+      expect(s.source, s.name).toMatch(/^src\//)
+      expect(existsSync(join(ROOT, s.source)), s.source).toBe(true)
+      expect(s.sourceHash, s.name).toMatch(/^[0-9a-f]{32}$/)
+      if (s.role !== 'block') expect(Object.keys(s.attributes).length, s.name).toBeGreaterThan(0)
+    }
+  })
+  it('every select / radio attribute carries its options, in the v1 manifest and in the ABI manifest', () => {
+    for (const s of sections) {
+      for (const [k, a] of Object.entries(s.attributes)) {
+        expect(a.type, `${s.name}.${k}`).toBeTruthy()
+        if (a.type === 'select' || a.type === 'radio') expect(a.options?.length, `${s.name}.${k}`).toBeGreaterThan(0)
+        const abiAttr = components[s.name]?.attributes[k]
+        expect(abiAttr?.type, `abi ${s.name}.${k}`).toBe(a.type)
+        if (a.options) expect(abiAttr?.options?.map((o) => o.value), `abi ${s.name}.${k}`).toEqual(a.options.map((o) => o.value))
+      }
+    }
+  })
+  it('the manifest speaks contentVersion 2 (studio workspace) — the ABI content version is the platform’s', () => {
+    expect((v1 as unknown as { contract: { contentVersion: number } }).contract.contentVersion).toBe(2)
+  })
+})
+
+describe('§3.3–§3.5 — types, keys and menus ai-api relies on', () => {
+  it('header has setting `menu` (type menu, default main-menu); footer exists; footer-brand / footer-menu blocks of footer', () => {
+    expect(byName.header!.attributes.menu).toMatchObject({ type: 'menu', default: 'main-menu' })
+    expect(byName.footer).toBeDefined()
+    expect(byName['footer-brand']!.placement?.parents).toContain('footer')
+    expect(byName['footer-menu']!.placement?.parents).toContain('footer')
+    expect(byName['footer-menu']!.attributes.menu?.type).toBe('menu')
+  })
+  it('hero-like types (/hero|banner|cover|slideshow/) keep every §3.4 key Nova v2 declared, with the same type', () => {
+    // Nova v2's §3.4 keys per hero-like type (themes/nova-v2/theme.manifest.json): a key dropped here means AI copy
+    // silently stops landing in that section.
+    const V2: Record<string, Record<string, string>> = {
+      hero: { heading: 'text', subtext: 'textarea', backgroundImage: 'image' },
+      slide: { heading: 'text', image: 'image' },
+      'video-hero': { heading: 'text', text: 'textarea' },
+      'promo-banner': { heading: 'text' },
+      'collection-banner': { collection: 'collection' },
+    }
+    const TEXT = ['text', 'textarea', 'richtext', 'inline_richtext', 'html']
+    for (const [type, keys] of Object.entries(V2)) {
+      expect(/hero|banner|cover|slideshow/i.test(type) || type === 'slide').toBe(true)
+      for (const [k, t] of Object.entries(keys)) {
+        const have = byName[type]!.attributes[k]?.type
+        expect(have, `${type}.${k}`).toBeDefined()
+        expect(TEXT.includes(t) ? TEXT.includes(have!) : have === t, `${type}.${k}: ${have}`).toBe(true)
+      }
+    }
+  })
+  it('the starter footer keeps the footer-shop / footer-help / footer-company columns', async () => {
+    const footer = (await import('../groups/footer.json')).default as { sections: { blocks?: { type: string; settings?: { menu?: string } }[] }[] }
+    const menus = footer.sections[0]!.blocks!.filter((b) => b.type === 'footer-menu').map((b) => b.settings?.menu)
+    expect(menus).toEqual(['footer-shop', 'footer-help', 'footer-company'])
+  })
+  it('the keys ai-api writes into config/settings.json are declared (hidden legacy where the redesign has no control)', () => {
+    for (const k of ['accent', 'colorBrand', 'fontHeading', 'fontBody', 'shopName', 'footerTagline', 'locale', 'headerMenuHandle', 'footerHelpMenuHandle']) expect(settingKeys.has(k), k).toBe(true)
+  })
+  it('settings the redesign removed from product-reviews and ugc-gallery stay declared (hidden)', () => {
+    for (const k of ['contentAlignment', 'contentWidth', 'hideOnMobile', 'mobileContentAlignment', 'pageSize']) expect(byName['product-reviews']!.attributes[k], k).toBeDefined()
+    for (const k of ['contentWidth', 'count']) expect(byName['ugc-gallery']!.attributes[k], k).toBeDefined()
+    expect(byName['product-reviews']!.attributes.pageSize!.visible_if).toBe('{{ false }}')
+  })
+  it('the home template keeps its header override (an announcement bar over the shared header)', async () => {
+    const index = (await import('../templates/index.json')).default as { contentVersion: number; groups: { header: { override?: { type: string }[] } | string; footer: unknown } }
+    expect(index.contentVersion).toBe(2)
+    const header = index.groups.header as { override?: { type: string }[] }
+    expect(header.override?.map((n) => n.type)).toEqual(['announcement-bar', 'header'])
+    expect(index.groups.footer).toBe('footer')
+  })
+})