create-tanqory-theme 0.0.0-stage → 0.2.3

package/templates/nova/tests/fixtures/commerce.ts

@@ -0,0 +1,128 @@
+import { placeholderImage, type PlaceholderFamily } from '../../src/components/states/media/MediaPlaceholder'
+import type { Cart, Collection, Money, NovaImage, Product, ProductVariant, SearchResults } from '@tanqory/theme-kit'
+
+const THB = (amount: number): Money => ({ amount, currencyCode: 'THB' })
+
+interface Spec {
+  handle: string
+  title: string
+  price: number
+  compareAt?: number
+  vendor?: string
+  type: string
+  options?: { name: string; values: string[] }[]
+  soldOut?: boolean
+  lowStock?: number
+  badge?: string | null
+  image?: NovaImage | null
+  images?: NovaImage[]
+  rating?: { value: number; count: number }
+  description?: string
+}
+
+let seq = 0
+function variantsFor(s: Spec): ProductVariant[] {
+  const opts = s.options ?? []
+  const combos: { name: string; value: string }[][] = opts.reduce<{ name: string; value: string }[][]>(
+    (acc, o) => acc.flatMap((c) => o.values.map((v) => [...c, { name: o.name, value: v }])),
+    [[]],
+  )
+  return combos.map((sel, i) => ({
+    id: `gid://variant/${++seq}`,
+    title: sel.length ? sel.map((x) => x.value).join(' / ') : 'Default',
+    sku: `HAL-${s.handle.slice(0, 6).toUpperCase()}-${String(i + 1).padStart(2, '0')}`,
+    price: THB(s.price),
+    compareAtPrice: s.compareAt ? THB(s.compareAt) : null,
+    available: !s.soldOut && !(i === combos.length - 1 && opts.length > 0 && combos.length > 2),
+    quantityAvailable: s.soldOut ? 0 : (s.lowStock ?? 24),
+    selectedOptions: sel,
+  }))
+}
+
+export function makeProduct(s: Spec): Product {
+  const image = s.image === undefined ? placeholderImage('product', 800, 800, s.title) : s.image
+  const variants = variantsFor(s)
+  return {
+    id: `gid://product/${s.handle}`,
+    handle: s.handle,
+    title: s.title,
+    vendor: s.vendor ?? 'Halden & Co.',
+    productType: s.type,
+    description: s.description ?? `${s.title}, made in small batches in our Chiang Mai studio.`,
+    url: `/products/${s.handle}`,
+    featuredImage: image,
+    images: s.images ?? (image ? [image, placeholderImage('editorial', 800, 600, `${s.title} in use`)] : []),
+    options: s.options ?? [],
+    variants,
+    priceRange: { min: THB(s.price), max: THB(s.price) },
+    compareAtPriceRange: s.compareAt ? { min: THB(s.compareAt), max: THB(s.compareAt) } : null,
+    available: !s.soldOut,
+    badge: s.badge ?? null,
+    rating: s.rating ?? null,
+    tags: [s.type.toLowerCase()],
+  }
+}
+
+const colour = { name: 'Colour', values: ['Oat', 'Chalk', 'Charcoal'] }
+const bedSize = { name: 'Size', values: ['Single', 'Queen', 'King'] }
+
+export const products: Product[] = [
+  makeProduct({ handle: 'speckled-stoneware-mug', title: 'Speckled Stoneware Mug', price: 690, type: 'Mugs', options: [colour], rating: { value: 4.8, count: 212 } }),
+  makeProduct({ handle: 'washed-linen-duvet-cover', title: 'Washed Linen Duvet Cover', price: 5900, type: 'Bedding', options: [bedSize, colour], rating: { value: 4.7, count: 96 } }),
+  makeProduct({ handle: 'sea-salt-dinner-plate', title: 'Sea Salt Dinner Plate', price: 890, compareAt: 1190, type: 'Plates', badge: null }),
+  makeProduct({ handle: 'linen-tea-towel-set', title: 'Linen Tea Towel, Set of 2', price: 790, type: 'Linen', options: [colour] }),
+  makeProduct({ handle: 'hand-thrown-carafe', title: 'Hand-thrown Carafe', price: 1450, type: 'Drinkware', soldOut: true }),
+  makeProduct({ handle: 'wild-honey-jar', title: 'Wild Longan Honey', price: 420, type: 'Pantry', lowStock: 3 }),
+  makeProduct({ handle: 'lemongrass-candle', title: 'Lemongrass & Vetiver Candle', price: 1150, type: 'Candles', badge: 'Bestseller' }),
+  makeProduct({ handle: 'linen-apron', title: 'Cross-back Linen Apron', price: 1690, type: 'Linen', options: [colour] }),
+  makeProduct({ handle: 'serving-bowl', title: 'Wide Serving Bowl', price: 1890, type: 'Serving' }),
+  makeProduct({ handle: 'waffle-bath-towel', title: 'Waffle Bath Towel', price: 1290, compareAt: 1590, type: 'Bath', options: [colour] }),
+  makeProduct({ handle: 'jasmine-tea', title: 'Jasmine Green Tea, 50 g', price: 380, type: 'Tea' }),
+  makeProduct({ handle: 'gift-card', title: 'Gift Card', price: 1000, type: 'Gift card', options: [{ name: 'Amount', values: ['฿1,000', '฿2,500', '฿5,000'] }] }),
+]
+
+export const variants: ProductVariant[] = products[1].variants
+
+const col = (handle: string, title: string, count: number, fam: PlaceholderFamily = 'collection'): Collection => ({
+  id: `gid://collection/${handle}`,
+  handle,
+  title,
+  url: `/collections/${handle}`,
+  description: `${title} from the Halden studio.`,
+  image: placeholderImage(fam, 800, 1000, title),
+  productsCount: count,
+  products: products.slice(0, Math.min(8, count)),
+})
+
+export const collections: Collection[] = [
+  col('kitchen-table', 'Kitchen & Table', 48),
+  col('bedroom-bath', 'Bedroom & Bath', 31),
+  col('pantry', 'Pantry', 12),
+  col('candles', 'Candles & Scent', 9),
+  col('gifts', 'Gifts', 22),
+  col('studio-seconds', 'Studio Seconds', 0),
+]
+
+export const cart: Cart = {
+  id: 'gid://cart/1',
+  itemCount: 3,
+  note: '',
+  lines: [
+    { id: 'l1', quantity: 2, product: products[0], variant: products[0].variants[0], cost: { total: THB(1380) } },
+    { id: 'l2', quantity: 1, product: products[2], variant: products[2].variants[0], cost: { total: THB(890), compareAtTotal: THB(1190) } },
+  ],
+  subtotal: THB(2270),
+  total: THB(2270),
+}
+
+export const cartEmpty: Cart = { id: 'gid://cart/2', itemCount: 0, lines: [], subtotal: THB(0), total: THB(0) }
+
+export const searchResults: SearchResults = {
+  query: 'linen',
+  products: products.filter((p) => /linen/i.test(p.title)),
+  articles: [],
+  pages: [{ title: 'Linen care', url: '/pages/linen-care', excerpt: 'Wash cool, line dry, skip the iron.' }],
+  total: 4,
+}
+
+export { THB }

package/templates/nova/tests/fixtures/content.ts

@@ -0,0 +1,58 @@
+import { placeholderImage } from '../../src/components/states/media/MediaPlaceholder'
+import type { Article, Blog, CustomerAccount, Policy, Review, StoreLocation, TeamMember, Testimonial, UgcPost } from '@tanqory/theme-kit'
+import { THB } from './commerce'
+
+export const articles: Article[] = [
+  { id: 'a1', handle: 'how-to-wash-linen', title: 'How to wash linen so it lasts twenty years', excerpt: "Heat and softener are linen's only real enemies. A four-step routine for sheets, napkins and everything between.", url: '/blogs/journal/how-to-wash-linen', image: placeholderImage('editorial', 1200, 900, 'Linen on a drying line'), author: 'Mali Srisuk', publishedAt: '2026-08-14', readingMinutes: 6, tags: ['care'], blogHandle: 'journal' },
+  { id: 'a2', handle: 'inside-the-kiln', title: 'Inside the kiln: a Sea Salt firing', excerpt: 'Forty pieces, one glaze, fourteen hours.', url: '/blogs/journal/inside-the-kiln', image: placeholderImage('editorial', 1200, 900, 'Kiln shelves'), author: 'Arun Pattana', publishedAt: '2026-07-02', readingMinutes: 4, tags: ['studio'], blogHandle: 'journal' },
+  { id: 'a3', handle: 'setting-a-slow-table', title: 'Setting a slow table', excerpt: 'Three layers, no rules.', url: '/blogs/journal/setting-a-slow-table', image: null, author: 'Mali Srisuk', publishedAt: '2026-05-20', readingMinutes: 3, tags: ['home'], blogHandle: 'journal' },
+]
+export const blog: Blog = { id: 'b1', handle: 'journal', title: 'Journal', url: '/blogs/journal', articles }
+
+export const reviews: Review[] = [
+  { id: 'r1', author: 'Ploy K.', rating: 5, title: 'Softer every wash', body: 'Six months in and the duvet cover is softer than the day it arrived.', createdAt: '2026-06-02', verified: true },
+  { id: 'r2', author: 'James W.', rating: 4, body: 'Lovely weight. The oat is a touch warmer than the photos.', createdAt: '2026-05-11', verified: true },
+  { id: 'r3', author: 'Nok', rating: 3, title: 'Runs large', body: 'Beautiful mug but bigger than I expected.', createdAt: '2026-04-28' },
+]
+
+export const testimonials: Testimonial[] = [
+  { id: 't1', quote: 'The only mugs our whole team fights over.', name: 'Anya Petrova', role: 'Café owner, Nimman', avatar: placeholderImage('avatar', 300, 300), rating: 5 },
+  { id: 't2', quote: 'Linen that actually gets better. I have bought three sets.', name: 'Somchai R.', role: 'Customer since 2021', avatar: null, rating: 5 },
+  { id: 't3', quote: 'Thoughtful packaging, no plastic, arrived in two days.', name: 'Lena M.', rating: null },
+]
+
+export const team: TeamMember[] = [
+  { id: 'p1', name: 'Mali Srisuk', role: 'Founder & potter', bio: 'Started Halden with one wheel in a rented garage.', image: placeholderImage('avatar', 600, 750) },
+  { id: 'p2', name: 'Arun Pattana', role: 'Kiln & glaze', image: placeholderImage('avatar', 600, 750) },
+  { id: 'p3', name: 'Dao Chaiyaporn', role: 'Linen & textiles', image: null },
+]
+
+export const ugc: UgcPost[] = Array.from({ length: 8 }, (_, i) => ({
+  id: `u${i}`,
+  image: placeholderImage('ugc', 800, 800, `Customer photo ${i + 1}`),
+  handle: ['@ploy.home', '@slowtable', '@nimman.eats', '@linenlove'][i % 4],
+  caption: i % 2 ? 'Sunday breakfast.' : undefined,
+  productHandles: ['speckled-stoneware-mug'],
+}))
+
+export const locations: StoreLocation[] = [
+  { id: 's1', name: 'Chiang Mai Studio', address: ['88 Nimmanhaemin Soi 9', 'Chiang Mai 50200'], phone: '+66 53 123 456', email: 'studio@halden.co', hours: 'Tue–Sun 10:00–18:00', image: placeholderImage('store', 800, 600) },
+  { id: 's2', name: 'Bangkok · Siam Discovery', address: ['Siam Discovery, 3rd floor', '194 Phaya Thai Rd', 'Bangkok 10330'], hours: 'Daily 10:00–22:00', image: placeholderImage('store', 800, 600) },
+]
+
+export const account: CustomerAccount = {
+  firstName: 'Mali',
+  lastName: 'Srisuk',
+  email: 'mali@halden.co',
+  phone: '+66 81 234 5678',
+  orders: [
+    { id: 'o1', number: '#1042', processedAt: '2026-09-02', status: 'fulfilled', total: THB(2270), itemCount: 3 },
+    { id: 'o2', number: '#1017', processedAt: '2026-07-18', status: 'paid', total: THB(5900), itemCount: 1 },
+  ],
+  addresses: [{ id: 'ad1', lines: ['88 Nimmanhaemin Soi 9', 'Chiang Mai 50200', 'Thailand'], default: true }],
+}
+
+export const policies: Policy[] = [
+  { handle: 'privacy-policy', title: 'Privacy policy', url: '/policies/privacy-policy', bodyHtml: '<p>This is sample policy text for the lab. A real store supplies its own policy.</p>' },
+  { handle: 'terms-of-service', title: 'Terms of service', url: '/policies/terms-of-service', bodyHtml: '<p>Sample terms for the lab.</p>' },
+]

package/templates/nova/tests/fixtures/index.ts

@@ -0,0 +1,8 @@
+/** Realistic, offline, deterministic data for stories and tests. Never call a live API. */
+export * from './shop'
+export * from './navigation'
+export * from './commerce'
+export * from './content'
+export * from './stress'
+export * from './promotion'
+export * from './merch'

package/templates/nova/tests/fixtures/merch.ts

@@ -0,0 +1,161 @@
+import { placeholderImage } from '../../src/components/states/media/MediaPlaceholder'
+import type { Collection, Money, NovaImage, Product, ProductVariant } from '@tanqory/theme-kit'
+
+/**
+ * 12C · the approved canvas products (Halden, USD). Deterministic: the same
+ * ids, prices and stock every run. The duvet carries the canvas buy box:
+ * Size × Colour, "King is not made in Oat", only 3 left in Queen.
+ */
+const USD = (amount: number): Money => ({ amount, currencyCode: 'USD' })
+const img = (family: Parameters<typeof placeholderImage>[0], alt: string, w = 800, h = 800): NovaImage => placeholderImage(family, w, h, alt)
+
+interface MerchSpec {
+  handle: string
+  title: string
+  price: number
+  maxPrice?: number
+  compareAt?: number
+  vendor?: string
+  options?: { name: string; values: string[] }[]
+  /** Combinations the maker does not make (value per option, in order). */
+  notMade?: string[][]
+  soldOut?: boolean
+  stock?: Record<string, number>
+  tags?: string[]
+  images?: NovaImage[] | null
+  description?: string
+}
+
+let n = 0
+function merch(s: MerchSpec): Product {
+  const opts = s.options ?? []
+  const combos = opts.reduce<string[][]>((acc, o) => acc.flatMap((c) => o.values.map((v) => [...c, v])), [[]])
+  const variants: ProductVariant[] = combos
+    .filter((c) => !s.notMade?.some((m) => m.every((v, i) => v === c[i])))
+    .map((c, i) => {
+      const title = c.length ? c.join(' / ') : 'Default Title'
+      const qty = s.soldOut ? 0 : (s.stock?.[title] ?? s.stock?.[c[0]] ?? 24)
+      return {
+        id: `gid://merch-variant/${++n}`,
+        title,
+        sku: `HAL-${s.handle.slice(0, 5).toUpperCase()}-${String(i + 1).padStart(2, '0')}`,
+        price: USD(s.price),
+        compareAtPrice: s.compareAt ? USD(s.compareAt) : null,
+        available: qty > 0,
+        quantityAvailable: qty,
+        selectedOptions: c.map((value, k) => ({ name: opts[k].name, value })),
+      }
+    })
+  const images = s.images === null ? [] : (s.images ?? [img('product', s.title), img('editorial', `${s.title} in use`, 800, 1000)])
+  return {
+    id: `gid://merch/${s.handle}`,
+    handle: s.handle,
+    title: s.title,
+    vendor: s.vendor ?? 'Halden Studio',
+    productType: 'Home',
+    description: s.description ?? `${s.title}, made in small batches.`,
+    descriptionHtml: `<p>${s.description ?? `${s.title}, made in small batches.`}</p>`,
+    url: `/products/${s.handle}`,
+    featuredImage: images[0] ?? null,
+    images,
+    options: opts,
+    variants,
+    priceRange: { min: USD(s.price), max: USD(s.maxPrice ?? s.price) },
+    compareAtPriceRange: s.compareAt ? { min: USD(s.compareAt), max: USD(s.compareAt) } : null,
+    available: !s.soldOut && variants.some((v) => v.available),
+    tags: s.tags ?? [],
+    badge: null,
+    rating: null,
+  }
+}
+
+const sixColours = { name: 'Colour', values: ['Oat', 'Charcoal', 'Sage', 'Sand', 'Chalk', 'Clay'] }
+
+export const merchMug = merch({ handle: 'speckled-stoneware-mug', title: 'Speckled Stoneware Mug, 350 ml', price: 28, options: [sixColours], description: 'Thrown on the wheel and dipped in a speckled glaze that breaks brown at the rim. Dishwasher-safe.' })
+export const merchDuvet = merch({
+  handle: 'washed-linen-duvet-cover',
+  title: 'Washed Linen Duvet Cover — Queen, Oat',
+  price: 189,
+  compareAt: 240,
+  vendor: 'Halden Linen',
+  options: [
+    { name: 'Size', values: ['Twin', 'Full', 'Queen', 'King'] },
+    { name: 'Colour', values: ['Oat', 'Chalk', 'Clay', 'Charcoal', 'Sage'] },
+  ],
+  notMade: [['King', 'Oat']],
+  stock: { 'Queen / Oat': 3 },
+  images: [img('product', 'Duvet on a made bed', 800, 1000), img('editorial', 'Linen weave, close up', 800, 1000), img('store', 'Folded duvet cover', 800, 1000), img('generic', 'Hidden button closure', 800, 1000), img('hero', 'Bedroom in morning light', 800, 1000), img('collection', 'The five colours', 800, 1000)],
+  description: 'Stonewashed for a lived-in softness from the first night. 100% European flax, woven in Portugal. Hidden button closure and inner corner ties.',
+})
+export const merchOil = merch({ handle: 'early-harvest-olive-oil', title: 'Early Harvest Cold-Pressed Olive Oil, 500 ml', price: 24, tags: ['new'] })
+export const merchCandle = merch({ handle: 'soy-candle-cedar', title: 'Hand-Poured Soy Candle — Cedar & Smoke, 220 g', price: 36, soldOut: true })
+export const merchBoard = merch({ handle: 'walnut-serving-board', title: 'Walnut Serving Board, Large', price: 74, maxPrice: 96, options: [{ name: 'Size', values: ['Large', 'Extra large'] }] })
+export const merchPlatter = merch({ handle: 'speckled-serving-platter', title: 'Extra-Large Hand-Thrown Speckled Stoneware Serving Platter with Reactive Sea Salt Glaze', price: 1249 })
+export const merchNapkins = merch({ handle: 'linen-napkins-chalk', title: 'Linen Napkins, Set of 4 — Chalk', price: 32, images: null })
+export const merchPourOver = merch({
+  handle: 'ceramic-pour-over-set',
+  title: 'Ceramic Pour-Over Coffee Set with Walnut Stand',
+  price: 58,
+  compareAt: 72,
+  options: [{ name: 'Glaze', values: ['Sand', 'Chalk', 'Clay', 'Charcoal', 'Sage'] }],
+  description: 'Brews two cups in four minutes. The stand is oiled FSC walnut, the dripper hand-thrown and glazed in Sea Salt. Filters included for the first month of mornings.',
+})
+export const merchCarafe = merch({ handle: 'glass-carafe', title: 'Mouth-Blown Glass Carafe, 1 L', price: 42 })
+
+/** The canvas's card-states row, in order. */
+export const merchProducts: Product[] = [merchMug, merchDuvet, merchOil, merchCandle, merchBoard, merchPlatter, merchNapkins, merchPourOver, merchCarafe]
+/** "New this season" — the canonical featured row. */
+export const merchNewSeason: Product[] = [merchMug, merchDuvet, merchOil, merchCandle]
+/** A single-variant product with one image and no options. */
+export const merchSimple = merch({ handle: 'linen-tea-towel', title: 'Linen Tea Towel', price: 18, images: [img('product', 'Linen tea towel')] })
+/** Every price in JPY (0 decimals) — currency stress. */
+export const merchJpy: Product = { ...merchMug, priceRange: { min: { amount: 4800, currencyCode: 'JPY' }, max: { amount: 4800, currencyCode: 'JPY' } }, compareAtPriceRange: null }
+/** KWD (3 decimals). */
+export const merchKwd: Product = { ...merchCarafe, priceRange: { min: { amount: 8.75, currencyCode: 'KWD' }, max: { amount: 8.75, currencyCode: 'KWD' } } }
+/** A price of 0 (free sample). */
+export const merchFree: Product = { ...merchSimple, handle: 'sample', title: 'Glaze Sample Tile', priceRange: { min: USD(0), max: USD(0) } }
+
+const room = (handle: string, title: string, count: number, family: Parameters<typeof placeholderImage>[0], products: Product[], description?: string): Collection => ({
+  id: `gid://merch-collection/${handle}`,
+  handle,
+  title,
+  url: `/collections/${handle}`,
+  description: description ?? `${title} from the Halden studio.`,
+  image: placeholderImage(family, 800, 1000, title),
+  productsCount: count,
+  products,
+})
+export const merchRooms: Collection[] = [
+  room('kitchen-table', 'Kitchen & Table', 48, 'collection', merchProducts, 'Everyday stoneware, glass and wood for cooking, pouring and gathering. Dishwasher-safe unless noted.'),
+  room('bedroom-bath', 'Bedroom & Bath', 32, 'editorial', [merchDuvet]),
+  room('pantry', 'Pantry', 27, 'product', [merchOil]),
+  room('candles-scent', 'Candles & Scent', 19, 'store', [merchCandle]),
+  room('studio-seconds', 'Studio Seconds', 12, 'generic', [merchMug]),
+]
+/** A collection without an image: the first product image stands in. */
+export const merchRoomNoImage: Collection = { ...merchRooms[2], handle: 'pantry-no-image', image: null }
+
+/** 12C · the canvas facets for Kitchen & Table (Stoneware on, Textiles 0 → disabled). */
+export const merchFacets: import('@tanqory/theme-kit').Facet[] = [
+  { id: 'availability', label: 'Availability', type: 'list', values: [{ id: 'in-stock', label: 'In stock', count: 18, active: false }, { id: 'out', label: 'Out of stock', count: 3, active: false }] },
+  { id: 'type', label: 'Product type', type: 'list', values: [{ id: 'stoneware', label: 'Stoneware', count: 21, active: true }, { id: 'glassware', label: 'Glassware', count: 9, active: false }, { id: 'textiles', label: 'Textiles', count: 0, active: false }] },
+  { id: 'price', label: 'Price', type: 'price', range: { min: 0, max: 1250, currencyCode: 'USD' } },
+  { id: 'colour', label: 'Colour', type: 'list', values: [{ id: 'oat', label: 'Oat', count: 12, active: false }, { id: 'charcoal', label: 'Charcoal', count: 8, active: false }, { id: 'sage', label: 'Sage', count: 5, active: false }] },
+]
+export const merchSortOptions: import('@tanqory/theme-kit').SortOption[] = [
+  { id: 'featured', label: 'Featured' },
+  { id: 'best-selling', label: 'Best selling' },
+  { id: 'price-asc', label: 'Price ↑' },
+  { id: 'price-desc', label: 'Price ↓' },
+  { id: 'newest', label: 'Newest' },
+]
+/** 21 products for a listing (the canvas shows "Showing 6 of 21"). */
+export const merchListing: Product[] = Array.from({ length: 21 }, (_, i) => {
+  const p = merchProducts[i % merchProducts.length]
+  return { ...p, id: `${p.id}-${i}`, handle: `${p.handle}-${i}` }
+})
+
+/** 12F · shop-the-look and comparison-table products (appended: earlier ids stay stable). */
+export const merchThrow = merch({ handle: 'washed-linen-throw', title: 'Washed Linen Throw — Oat', price: 148, vendor: 'Halden Linen', images: [img('collection', 'Oat linen throw over a sofa arm')] })
+export const merchDuvetBlend = merch({ handle: 'linen-cotton-duvet-cover', title: 'Linen-Cotton Duvet Cover', price: 149, vendor: 'Halden Linen', images: [img('store', 'Linen-cotton duvet cover, folded')] })
+export const merchDuvetPercale = merch({ handle: 'organic-percale-duvet-cover', title: 'Organic Percale Duvet Cover', price: 129, vendor: 'Halden Linen', images: [img('generic', 'Organic percale duvet cover, folded')] })

package/templates/nova/tests/fixtures/navigation.ts

@@ -0,0 +1,125 @@
+import type { BreadcrumbItem, NovaMenu } from '@tanqory/theme-kit'
+
+const u = (s: string) => `/collections/${s}`
+
+/** 12A canonical main menu — five top-level items; the first carries a mega panel (L2 headings, L3 links). */
+export const mainMenu: NovaMenu = {
+  handle: 'main-menu',
+  title: 'Main menu',
+  items: [
+    {
+      title: 'Kitchen & Table',
+      url: u('kitchen-table'),
+      active: true,
+      items: [
+        { title: 'Tableware', url: u('tableware'), items: [{ title: 'Mugs & Cups', url: u('mugs') }, { title: 'Plates & Bowls', url: u('plates-bowls') }, { title: 'Serving', url: u('serving') }] },
+        { title: 'Drinkware', url: u('drinkware'), items: [{ title: 'Glassware', url: u('glassware') }, { title: 'Carafes', url: u('carafes') }, { title: 'Coffee & Tea', url: u('coffee-tea') }] },
+        { title: 'Linen', url: u('table-linen'), items: [{ title: 'Table Linen', url: u('table-linen') }, { title: 'Aprons', url: u('aprons') }, { title: 'Tea Towels', url: u('tea-towels') }] },
+        { title: 'Gifts', url: u('gifts'), items: [{ title: 'Gift Sets', url: u('gift-sets') }, { title: 'Gift Cards', url: '/products/gift-card' }] },
+      ],
+    },
+    {
+      title: 'Bedroom & Bath',
+      url: u('bedroom-bath'),
+      items: [
+        { title: 'Bedding', url: u('bedding'), items: [{ title: 'Duvet Covers', url: u('duvet-covers') }, { title: 'Sheets', url: u('sheets') }, { title: 'Pillowcases', url: u('pillowcases') }] },
+        { title: 'Bath', url: u('bath'), items: [{ title: 'Towels', url: u('towels') }, { title: 'Robes', url: u('robes') }] },
+      ],
+    },
+    { title: 'Pantry', url: u('pantry'), items: [{ title: 'Honey & Preserves', url: u('preserves') }, { title: 'Tea', url: u('tea') }, { title: 'Spices', url: u('spices') }] },
+    { title: 'Candles & Scent', url: u('candles') },
+    { title: 'Journal', url: '/blogs/journal' },
+  ],
+}
+
+/** Two levels only (no L3) — the simple dropdown's natural data. */
+export const mainMenuShort: NovaMenu = {
+  handle: 'main-menu',
+  title: 'Main menu',
+  items: [
+    { title: 'Shop', url: u('all'), items: [{ title: 'Kitchen', url: u('kitchen-table') }, { title: 'Bedroom', url: u('bedroom-bath') }, { title: 'Pantry', url: u('pantry') }] },
+    { title: 'Journal', url: '/blogs/journal' },
+    { title: 'About', url: '/pages/about' },
+  ],
+}
+
+/** Flat — one level; menuStyle has nothing to open. */
+export const mainMenuFlat: NovaMenu = {
+  handle: 'main-menu',
+  title: 'Main menu',
+  items: mainMenu.items.map(({ title, url }) => ({ title, url })),
+}
+
+export const mainMenuThai: NovaMenu = {
+  handle: 'main-menu',
+  title: 'เมนูหลัก',
+  items: [
+    {
+      title: 'ห้องครัวและโต๊ะอาหาร',
+      url: u('kitchen-table'),
+      items: [
+        { title: 'แก้วและถ้วย', url: u('mugs') },
+        { title: 'จานและชาม', url: u('plates-bowls') },
+        { title: 'ภาชนะเสิร์ฟ', url: u('serving') },
+        { title: 'ผ้าปูโต๊ะ ผ้ากันเปื้อน และผ้าเช็ดจาน', url: u('table-linen') },
+        { title: 'ชุดของขวัญ', url: u('gift-sets') },
+      ],
+    },
+    { title: 'ห้องนอนและห้องน้ำ', url: u('bedroom-bath'), items: [{ title: 'ปลอกผ้านวม', url: u('duvet-covers') }] },
+    { title: 'ของแห้งและเครื่องปรุง', url: u('pantry') },
+    { title: 'เทียนหอมและกลิ่น', url: u('candles') },
+  ],
+}
+
+export const mainMenuArabic: NovaMenu = {
+  handle: 'main-menu',
+  title: 'القائمة الرئيسية',
+  items: [
+    { title: 'المطبخ والمائدة', url: u('kitchen-table'), items: [{ title: 'أكواب وفناجين', url: u('mugs') }, { title: 'أطباق وأوعية', url: u('plates-bowls') }] },
+    { title: 'غرفة النوم والحمام', url: u('bedroom-bath'), items: [{ title: 'أغطية لحاف', url: u('duvet-covers') }] },
+    { title: 'المؤن', url: u('pantry'), items: [{ title: 'شاي', url: u('tea') }] },
+    { title: 'الشموع والعطور', url: u('candles') },
+    { title: 'المجلة', url: '/blogs/journal' },
+  ],
+}
+
+/** Nine long top-level items: overflows every desktop width → the header collapses to the drawer. */
+export const mainMenuLong: NovaMenu = {
+  handle: 'main-menu',
+  title: 'Main menu',
+  items: [
+    'Kitchen & Table Essentials',
+    'Bedroom & Bath Linen',
+    'Pantry & Preserves',
+    'Candles, Scent & Home Fragrance',
+    'Gifts for Every Occasion',
+    'Studio Seconds',
+    'Collaborations',
+    'Journal & Care Guides',
+    'Visit the Studio',
+  ].map((title, i) => ({ title, url: `/pages/item-${i}` })),
+}
+
+export const footerShop: NovaMenu = { handle: 'footer-shop', title: 'Shop', items: [{ title: 'Kitchen & Table', url: u('kitchen-table') }, { title: 'Bedroom & Bath', url: u('bedroom-bath') }, { title: 'Pantry', url: u('pantry') }, { title: 'Gift cards', url: '/products/gift-card' }] }
+export const footerHelp: NovaMenu = { handle: 'footer-help', title: 'Help', items: [{ title: 'Shipping', url: '/policies/shipping-policy' }, { title: 'Returns', url: '/policies/refund-policy' }, { title: 'Care guides', url: '/blogs/journal/tagged/care' }, { title: 'Contact', url: '/pages/contact' }] }
+export const footerCompany: NovaMenu = { handle: 'footer-company', title: 'Studio', items: [{ title: 'Our story', url: '/pages/about' }, { title: 'Journal', url: '/blogs/journal' }, { title: 'Stockists', url: '/pages/stockists' }, { title: 'Careers', url: '/pages/careers' }] }
+export const footerMinimal: NovaMenu = { handle: 'footer', title: 'Footer', items: [{ title: 'Shop', url: u('all') }, { title: 'Journal', url: '/blogs/journal' }, { title: 'Shipping', url: '/policies/shipping-policy' }, { title: 'Returns', url: '/policies/refund-policy' }, { title: 'Contact', url: '/pages/contact' }] }
+export const legalMenu: NovaMenu = { handle: 'legal', title: 'Legal', items: [{ title: 'Privacy policy', url: '/policies/privacy-policy' }, { title: 'Terms of service', url: '/policies/terms-of-service' }, { title: 'Refund policy', url: '/policies/refund-policy' }] }
+/** The centered / minimal footer's short legal line. */
+export const legalMenuShort: NovaMenu = { handle: 'legal', title: 'Legal', items: [{ title: 'Privacy', url: '/policies/privacy-policy' }, { title: 'Terms', url: '/policies/terms-of-service' }] }
+export const footerShopThai: NovaMenu = { handle: 'footer-shop', title: 'ร้านค้า', items: [{ title: 'ห้องครัวและโต๊ะอาหาร', url: u('kitchen-table') }, { title: 'ห้องนอนและห้องน้ำ', url: u('bedroom-bath') }, { title: 'บัตรของขวัญ', url: '/products/gift-card' }] }
+export const footerHelpThai: NovaMenu = { handle: 'footer-help', title: 'ช่วยเหลือ', items: [{ title: 'การจัดส่ง', url: '/policies/shipping-policy' }, { title: 'การคืนสินค้า', url: '/policies/refund-policy' }, { title: 'ติดต่อเรา', url: '/pages/contact' }] }
+export const legalMenuThai: NovaMenu = { handle: 'legal', title: 'กฎหมาย', items: [{ title: 'นโยบายความเป็นส่วนตัว', url: '/policies/privacy-policy' }, { title: 'ข้อกำหนด', url: '/policies/terms-of-service' }] }
+export const footerShopArabic: NovaMenu = { handle: 'footer-shop', title: 'تسوق', items: [{ title: 'المطبخ والمائدة', url: u('kitchen-table') }, { title: 'غرفة النوم والحمام', url: u('bedroom-bath') }] }
+export const footerHelpArabic: NovaMenu = { handle: 'footer-help', title: 'مساعدة', items: [{ title: 'الشحن', url: '/policies/shipping-policy' }, { title: 'الإرجاع', url: '/policies/refund-policy' }] }
+
+export const trails = {
+  collection: [{ title: 'Home', url: '/' }, { title: 'Collections', url: '/collections' }, { title: 'Kitchen & Table' }] as BreadcrumbItem[],
+  product: [{ title: 'Home', url: '/' }, { title: 'Bedroom & Bath', url: u('bedroom-bath') }, { title: 'Washed Linen Duvet Cover — Queen, Oat' }] as BreadcrumbItem[],
+  longTitle: [{ title: 'Home', url: '/' }, { title: 'Kitchen & Table', url: u('kitchen-table') }, { title: 'Extra-Large Hand-Thrown Speckled Stoneware Serving Platter with Reactive Glaze' }] as BreadcrumbItem[],
+  article: [{ title: 'Home', url: '/' }, { title: 'Journal', url: '/blogs/journal' }, { title: 'How to wash linen' }] as BreadcrumbItem[],
+  deep: [{ title: 'Home', url: '/' }, { title: 'Collections', url: '/collections' }, { title: 'Kitchen & Table', url: u('kitchen-table') }, { title: 'Tableware', url: u('tableware') }, { title: 'Speckled Stoneware Mug' }] as BreadcrumbItem[],
+  thai: [{ title: 'หน้าแรก', url: '/' }, { title: 'ห้องนอนและห้องน้ำ', url: u('bedroom-bath') }, { title: 'ปลอกผ้านวมลินินซัก — ควีน สีโอ๊ต' }] as BreadcrumbItem[],
+  arabic: [{ title: 'الرئيسية', url: '/' }, { title: 'غرفة النوم', url: u('bedroom-bath') }, { title: 'غطاء لحاف من الكتان' }] as BreadcrumbItem[],
+  home: [{ title: 'Home' }] as BreadcrumbItem[],
+}

package/templates/nova/tests/fixtures/promotion.ts

@@ -0,0 +1,43 @@
+import { placeholderImage } from '../../src/components/states/media/MediaPlaceholder'
+import type { Collection, NovaImage, NovaVideo } from '@tanqory/theme-kit'
+import { collections } from './commerce'
+
+/**
+ * Heroes & promotion fixtures (12B). Images are the Nova 14 placeholder art;
+ * videos are short muted VP9 loops served by the lab (apps/nova-storybook/
+ * public/media) whose FIRST FRAME is the same art as their poster, so a
+ * paused capture and the poster are the same picture.
+ */
+export const heroPortrait: NovaImage = placeholderImage('hero', 800, 1000, 'Linen drying in the Chiang Mai studio')
+export const heroEditorial: NovaImage = placeholderImage('editorial', 1600, 900, 'A potter trimming a bowl at the wheel')
+export const heroProduct: NovaImage = placeholderImage('product', 1000, 1250, 'Sea Salt glaze mug on a linen runner')
+
+export const heroVideo: NovaVideo = { src: 'media/hero-loop.webm', poster: placeholderImage('hero', 1600, 900, 'Linen drying in the Chiang Mai studio') }
+export const heroVideoPortrait: NovaVideo = { src: 'media/hero-loop-portrait.webm', poster: heroPortrait }
+export const studioVideo: NovaVideo = { src: 'media/studio-loop.webm', poster: heroEditorial }
+/** A video whose file never loads — the failure state (poster stays, controls hide). */
+export const brokenVideo: NovaVideo = { src: 'media/does-not-exist.webm', poster: heroEditorial }
+
+export const slideImages: NovaImage[] = [
+  placeholderImage('hero', 1600, 900, 'Sea Salt glaze mugs in morning light'),
+  placeholderImage('editorial', 1600, 900, 'Linen napkins folded on an oak table'),
+  placeholderImage('store', 1600, 900, 'Gift boxes wrapped in kraft paper'),
+  placeholderImage('collection', 1600, 900, 'Stoneware bowls stacked by colour'),
+]
+
+export const bannerCollection: Collection = {
+  ...collections[0],
+  description: 'Everyday stoneware, glass and wood for cooking, pouring and gathering. Dishwasher-safe unless noted.',
+  image: placeholderImage('collection', 1600, 700, 'Stoneware and glass on a kitchen shelf'),
+}
+export const bannerCollectionLong: Collection = {
+  ...bannerCollection,
+  description:
+    'Everyday stoneware, glass and wood for cooking, pouring and gathering. Dishwasher-safe unless noted. Every piece is made in batches of forty in our Chiang Mai studio, glazed by hand and fired twice, so no two are quite the same — and that is the point.',
+}
+export const bannerCollectionNoImage: Collection = { ...bannerCollection, image: null }
+export const bannerCollectionThai: Collection = {
+  ...bannerCollection,
+  title: 'ภาชนะเซรามิกเคลือบมือสำหรับโต๊ะอาหารทุกวัน',
+  description: 'เครื่องปั้นดินเผา แก้ว และไม้ สำหรับการทำอาหารและการรวมตัวทุกวัน',
+}