create-tanqory-theme 0.0.0-stage → 0.2.3

package/templates/nova/tests/abi-opt-in.test.tsx

@@ -0,0 +1,100 @@
+/**
+ * Theme ABI opt-in answers (storefront-query rev 2.19): collection facets, the search products order and a
+ * product's collections — asked for only on the route that shows them, rendered when the platform sends them.
+ */
+import { describe, expect, it } from 'vitest'
+import { render } from '../entry.abi'
+import { convert as convert } from '@tanqory/theme-kit/runtime'
+import { searchKey, searchOrder } from '@tanqory/theme-kit/runtime'
+import { abiCtx, collection, money, pageOf, product, serverHtml, type Store } from './support/abi-ctx'
+
+const chrome = (main: Record<string, unknown>[]) => [
+  { region: 'header', sections: [{ type: 'header', id: 'header' }] },
+  { region: 'main', sections: main },
+  { region: 'footer', sections: [{ type: 'footer', id: 'footer' }] },
+]
+const P = [
+  { ...product('linen-duvet', 'Washed Linen Duvet', '240.00'), vendor: 'Halden' },
+  { ...product('stone-mug', 'Stoneware Mug', '28.00'), vendor: 'Kiln' },
+  { ...product('oak-board', 'Oak Board', '64.00'), vendor: 'Kiln' },
+]
+const FACETS = [
+  { id: 'filter.available', label: 'Availability', type: 'BOOLEAN', values: [{ id: 'filter.available.true', label: 'In stock', count: 3, input: { key: 'available', value: 'true' } }] },
+  { id: 'filter.vendor', label: 'Vendor', type: 'LIST', values: [{ id: 'filter.vendor.Halden', label: 'Halden', count: 1, input: { key: 'vendor', value: 'Halden' } }, { id: 'filter.vendor.Kiln', label: 'Kiln', count: 2, input: { key: 'vendor', value: 'Kiln' } }] },
+  { id: 'filter.price', label: 'Price', type: 'PRICE_RANGE', values: [], range: { min: money('28.00'), max: money('240.00') } },
+]
+const KITCHEN = { ...collection('kitchen', 'Kitchen', P), filters: FACETS }
+const STORE: Store = { products: P.map((p) => ({ ...p, collections: [{ handle: 'kitchen', title: 'Kitchen' }] })) as never, collections: [KITCHEN as never] }
+
+/** Records the options each snapshot / search call was made with. */
+function spy(ctx: ReturnType<typeof abiCtx>['ctx']) {
+  const calls: { op: string; args: unknown }[] = []
+  const data = ctx.data as unknown as Record<string, any>
+  const snap = data.snapshot
+  data.snapshot = (opts: unknown) => (calls.push({ op: 'snapshot', args: opts }), snap(opts))
+  const search = data.catalog.search
+  data.catalog.search = (args: unknown) => (calls.push({ op: 'search', args }), search(args))
+  return calls
+}
+
+describe('convert: facets both ways', () => {
+  it('ABI filters → the listing raw filters, and the listing inputs → ABI {key, value}', () => {
+    const raw = convert.filters(FACETS as never)
+    expect(raw.map((f) => f.id)).toEqual(['filter.available', 'filter.vendor', 'filter.price'])
+    expect(raw[1]!.values.map((v) => JSON.parse(v.input))).toEqual([{ productVendor: 'Halden' }, { productVendor: 'Kiln' }])
+    expect(JSON.parse(raw[2]!.values[0]!.input)).toEqual({ price: { min: 28, max: 240 } })
+    expect(convert.abiFilters([{ productVendor: 'Kiln' }, { available: true }, { price: { min: 28, max: 99.5 } }, { productType: 'Home' }, { tag: 'x' }, { nope: 1 }])).toEqual([
+      { key: 'vendor', value: 'Kiln' }, { key: 'available', value: 'true' }, { key: 'price.min', value: '28' }, { key: 'price.max', value: '99.5' }, { key: 'productType', value: 'Home' }, { key: 'tag', value: 'x' },
+    ])
+    // an amount the data plane would refuse is dropped, never sent
+    expect(convert.abiFilters([{ price: { min: -1, max: Number.MAX_SAFE_INTEGER } }])).toEqual([])
+    expect(convert.filters(undefined)).toEqual([])
+  })
+  it('search sort ids → the ABI order; relevance and unknown ids are the default', () => {
+    expect(searchOrder('price-desc')).toEqual({ sortKey: 'PRICE', reverse: true })
+    expect(searchOrder('relevance')).toBeNull()
+    expect(searchOrder('__proto__')).toBeNull()
+    expect(searchKey('linen', 'price-asc')).toBe('search:linen|price-asc')
+    expect(searchKey('linen', 'bogus')).toBe('search:linen')
+  })
+})
+
+describe('pages', () => {
+  it('collection: the snapshot asks for facets and the filter UI renders the platform facets', async () => {
+    const { ctx } = abiCtx({ kind: 'collection', handle: 'kitchen', url: 'https://shop.example/collections/kitchen', store: STORE, page: pageOf('collection', chrome([{ type: 'main-collection', id: 'main' }])) })
+    const calls = spy(ctx)
+    const out = await serverHtml(render, ctx)
+    expect(out.status).toBe(200)
+    expect(calls.find((c) => c.op === 'snapshot')?.args).toMatchObject({ facets: true })
+    expect(calls.find((c) => c.op === 'snapshot')?.args).not.toHaveProperty('productCollections')
+    expect(out.root).toContain('Halden')
+    expect(out.root).toContain('Kiln')
+    expect(out.root).toMatch(/Brand/)
+  })
+  it('product: the snapshot asks for the product collections and the breadcrumb goes through the collection', async () => {
+    const { ctx } = abiCtx({ kind: 'product', handle: 'stone-mug', url: 'https://shop.example/products/stone-mug', store: STORE, page: pageOf('product', chrome([{ type: 'product-details', id: 'main' }])) })
+    const calls = spy(ctx)
+    const out = await serverHtml(render, ctx)
+    expect(out.status).toBe(200)
+    expect(calls.find((c) => c.op === 'snapshot')?.args).toMatchObject({ productCollections: true })
+    expect(out.root).toMatch(/<a href="\/collections\/kitchen" class="nv-breadcrumb__link"><bdi>Kitchen<\/bdi>/)
+  })
+  it('search: ?sort= is asked of the platform (round 2 when the gateway did not forward it) and the control shows it', async () => {
+    const { ctx } = abiCtx({ kind: 'search', url: 'https://shop.example/search?q=linen&sort=price-desc', params: { q: 'linen' }, store: STORE, page: pageOf('search', chrome([{ type: 'search-results', id: 'main' }])) })
+    const calls = spy(ctx)
+    const out = await serverHtml(render, ctx)
+    expect(out.status).toBe(200)
+    expect(calls.find((c) => c.op === 'search')?.args).toMatchObject({ query: 'linen', sortKey: 'PRICE', reverse: true })
+    expect(out.root).toMatch(/<option[^>]*value="price-desc"[^>]*selected|<option selected=""[^>]*value="price-desc"/)
+    expect(out.root).toContain('Relevance')
+  })
+  it('search without sort asks for nothing new', async () => {
+    const { ctx } = abiCtx({ kind: 'search', url: 'https://shop.example/search?q=linen', params: { q: 'linen' }, store: STORE, page: pageOf('search', chrome([{ type: 'search-results', id: 'main' }])) })
+    const calls = spy(ctx)
+    await serverHtml(render, ctx)
+    for (const c of calls) {
+      expect(c.args ?? {}).not.toHaveProperty('sortKey')
+      expect(c.args ?? {}).not.toHaveProperty('facets')
+    }
+  })
+})

package/templates/nova/tests/abi-parity.test.tsx

@@ -0,0 +1,95 @@
+/**
+ * Wiring gaps the visual parity check (scripts/parity: the stories vs the same content through the
+ * ABI host) found in the ABI path. Each test pins one, with the data shape the platform really sends.
+ */
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { act } from 'react'
+import { renderToString } from 'react-dom/server'
+import { hydrateRoot } from 'react-dom/client'
+import { render } from '../entry.abi'
+import { abiCtx, collection, conn, menu, money, pageOf, product, serverHtml, type Store } from './support/abi-ctx'
+import { PHONE_QUERY, useMediaQuery } from '../src/styles/viewport'
+
+;(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true
+
+const P = [product('linen-duvet', 'Washed Linen Duvet', '240.00'), product('stone-mug', 'Stoneware Mug', '28.00')]
+const STORE: Store = { menus: [menu('main-menu', [['Shop', '/collections/all']])], products: P, collections: [collection('kitchen', 'Kitchen', P), collection('pantry', 'Pantry', [])] }
+const chrome = (main: Record<string, unknown>[]) => [
+  { region: 'header', sections: [{ type: 'header', id: 'header' }] },
+  { region: 'main', sections: main },
+  { region: 'footer', sections: [{ type: 'footer', id: 'footer', blocks: [{ type: 'footer-brand', id: 'footer-brand' }, { type: 'payment-icons', id: 'pay' }] }] },
+]
+
+afterEach(() => {
+  vi.unstubAllGlobals()
+  vi.restoreAllMocks()
+})
+
+describe('ABI wiring found by the parity check', () => {
+  it('a collection list does not empty the featured collection on the same page', async () => {
+    const { ctx } = abiCtx({ kind: 'home', url: 'https://shop.example/', store: STORE, page: pageOf('index', chrome([
+      { type: 'featured-collection', id: 's-fc', settings: { heading: 'New arrivals', collection: 'kitchen' } },
+      { type: 'collection-list', id: 's-cl', settings: { heading: 'Shop by room' } },
+    ])) })
+    // The platform's collections() answers CARDS: an empty product page with the real total.
+    ;(ctx.data.catalog as { collections: unknown }).collections = async () => conn((STORE.collections ?? []).map((c) => ({ ...c, products: { ...conn([]), totalCount: c.products.totalCount } })))
+    // …and the snapshot already resolved the featured collection's ref (round 1), as the platform does.
+    const snapshot = ctx.data.snapshot.bind(ctx.data)
+    ;(ctx.data as { snapshot: unknown }).snapshot = async (a: never) => ({ ...(await snapshot(a)), refs: { 's-fc.collection': STORE.collections![0] } })
+    const { root } = await serverHtml(render, ctx)
+    expect(root).toContain('New arrivals')
+    expect(root).toContain('href="/products/stone-mug"')
+    expect(root).toContain('Shop by room')
+  })
+
+  it('the footer region control lists the countries the shop ships to (on by default)', async () => {
+    const { ctx } = abiCtx({ kind: 'home', url: 'https://shop.example/', store: STORE, page: pageOf('index', chrome([])) })
+    const out = await serverHtml(render, ctx)
+    expect(out.root).toMatch(/class="nv-footer__region"/)
+    expect(out.root).toContain('United States')
+  })
+
+  it('no payment marks (the ABI shop has none) leaves no dangling divider in the footer', async () => {
+    const { ctx } = abiCtx({ kind: 'home', url: 'https://shop.example/', store: STORE, page: pageOf('index', chrome([])) })
+    const { root } = await serverHtml(render, ctx)
+    expect(root).not.toContain('nv-footer__rule')
+    expect(root).not.toContain('data-block="payment-icons"')
+  })
+
+  it('a cart line shows its options and its compare-at price from the ABI merchandise', async () => {
+    const line = {
+      id: 'line-1', quantity: 2, attributes: {},
+      merchandise: {
+        id: 'v-duvet-queen-oat', title: 'Queen / Oat', availableForSale: true, sku: null, image: null,
+        price: money('189.00'), compareAtPrice: money('240.00'),
+        selectedOptions: [{ name: 'Size', value: 'Queen' }, { name: 'Colour', value: 'Oat' }],
+        product: { handle: 'linen-duvet', title: 'Washed Linen Duvet', featuredImage: null },
+      },
+      cost: { subtotalAmount: money('378.00'), totalAmount: money('378.00') },
+    }
+    const cart = { id: 'c1', version: 1, totalQuantity: 2, lines: [line], cost: { subtotalAmount: money('378.00'), totalAmount: money('378.00') }, discountCodes: [], note: null, checkoutUrl: '/checkout' }
+    const { ctx } = abiCtx({ kind: 'cart', url: 'https://shop.example/cart', store: { ...STORE, cart }, page: pageOf('cart', chrome([{ type: 'cart-items', id: 'main' }])) })
+    const { root } = await serverHtml(render, ctx)
+    expect(root).toContain('Queen · Oat')
+    expect(root).toMatch(/\$240\.00/) // the struck per-unit compare-at
+    expect(root).toMatch(/\$102\.00/) // "You save" = (240 − 189) × 2
+  })
+
+  it('a media query hydrates with the server value on a phone (no mismatch), then switches', async () => {
+    function Probe(): JSX.Element {
+      return <span>{useMediaQuery(PHONE_QUERY) ? 'phone' : 'wide'}</span>
+    }
+    const html = renderToString(<Probe />)
+    expect(html).toContain('wide')
+    vi.stubGlobal('matchMedia', (q: string) => ({ matches: q === PHONE_QUERY, media: q, addEventListener() {}, removeEventListener() {} }))
+    const errors: string[] = []
+    vi.spyOn(console, 'error').mockImplementation((...a: unknown[]) => { errors.push(a.map(String).join(' ')) })
+    const host = document.createElement('div')
+    host.innerHTML = html
+    document.body.appendChild(host)
+    await act(async () => { hydrateRoot(host, <Probe />, { onRecoverableError: (e) => errors.push(String(e)) }) })
+    expect(errors).toEqual([])
+    expect(host.textContent).toBe('phone')
+    host.remove()
+  })
+})

package/templates/nova/tests/abi-r5-store-settings.test.tsx

@@ -0,0 +1,337 @@
+/**
+ * Run-5 owner decisions (2026-10-19, option (a) each): Dashboard settings Nova V3 now follows, from the
+ * shop/product members of theme-abi 2.0.0-alpha.14 (storefront-query rev 2.26). Every member is optional:
+ * without it the page renders exactly as before.
+ *
+ *   D-2  the cookie banner follows Settings › Customer privacy (where, words, position, colours, preferences)
+ *   D-3  Settings › Brand colour is the theme's brand colour while the theme sets none
+ *   D-4  "Tax included." when prices include tax (product page, cart drawer, cart page)
+ *   D-5  the drawer's free-shipping bar from the lowest "free over" threshold of the shopper's country
+ *   D-6  an empty legal menu lists the published policies
+ *   D-7  the store's contact email / phone in the footer and on the contact form
+ *   D-8  the product's own low-stock threshold overrides the theme's
+ *   D-11 "Show sign-in links" off hides the header's account link
+ *   D-13 the store name (Settings › General) wins over the theme's `shopName` setting
+ */
+import { render as rtl, screen } from '@testing-library/react'
+import { describe, expect, it } from 'vitest'
+import { render } from '../entry.abi'
+import { convert as convert } from '@tanqory/theme-kit/runtime'
+import { withBrandColour } from '../lib/legacy-settings'
+import { shopNameOf } from '@tanqory/theme-kit/runtime'
+import { consentBannerShows, toShop, toProduct } from '@tanqory/theme-kit/runtime'
+import { resolveSettings } from '@tanqory/theme-kit'
+import { CookieConsent } from '../src/components/overlays/CookieConsent'
+import { CartDrawer } from '../src/components/overlays/CartDrawer'
+import { CartSummary } from '../src/components/commerce/CartSummary'
+import { ContactFormSection } from '../src/sections/ContactForm/ContactForm'
+import { contactFormSchema } from '../src/sections/ContactForm/schema'
+import { ProductDetails, type ProductDetailsBlock } from '../src/sections/ProductDetails/ProductDetails'
+import { productDetailsSchema } from '../src/sections/ProductDetails/schema'
+import { freeShippingProgress } from '../src/layouts/Main'
+import { NovaProvider } from '../src/styles/NovaProvider'
+import { STRINGS_AR, STRINGS_EN, STRINGS_TH } from '../src/styles/strings'
+import * as fx from './fixtures'
+import { SHOP, abiCtx, conn, menu, money, pageOf, product, serverHtml } from './support/abi-ctx'
+
+const FOOTER = { type: 'footer', id: 'footer', blocks: [{ type: 'footer-brand', id: 'footer-brand' }] }
+
+function home(o: { settings?: Record<string, unknown>; shop?: Record<string, unknown> } = {}) {
+  return abiCtx({
+    kind: 'home',
+    url: 'https://shop.example/',
+    settings: o.settings ?? {},
+    store: { shop: { ...SHOP, ...(o.shop ?? {}) } },
+    page: pageOf('index', [
+      { region: 'header', sections: [{ type: 'header', id: 'header' }] },
+      { region: 'main', sections: [] },
+      { region: 'footer', sections: [FOOTER] },
+    ]),
+  })
+}
+
+describe('D-13 the store name wins over the theme shop name', () => {
+  it('pure: store name first, theme name only as fallback', () => {
+    expect(shopNameOf('Lanna Silver Studio', 'QA Cat Dolls')).toBe('QA Cat Dolls')
+    expect(shopNameOf('Lanna Silver Studio', '  ')).toBe('Lanna Silver Studio')
+    expect(shopNameOf('', '')).toBe('Store')
+    expect(toShop({ ...SHOP, name: 'QA Cat Dolls' } as never, { shopName: 'Lanna Silver Studio' }).name).toBe('QA Cat Dolls')
+    expect(toShop({ ...SHOP, name: '' } as never, { shopName: 'Lanna Silver Studio' }).name).toBe('Lanna Silver Studio')
+  })
+
+  it('header, footer and the page title show the Settings name, not the AI-built one', async () => {
+    const { ctx } = home({ settings: { shopName: 'Lanna Silver Studio' }, shop: { name: 'QA Cat Dolls 1016' } })
+    const { root, html } = await serverHtml(render, ctx)
+    expect(root).toContain('QA Cat Dolls 1016')
+    expect(root).not.toContain('Lanna Silver Studio')
+    expect(html).toMatch(/<title>[^<]*QA Cat Dolls 1016/)
+  })
+
+  it('an empty store name falls back to the theme shop name', async () => {
+    const { ctx } = home({ settings: { shopName: 'Lanna Silver Studio' }, shop: { name: '' } })
+    const { root } = await serverHtml(render, ctx)
+    expect(root).toContain('Lanna Silver Studio')
+  })
+})
+
+describe('D-3 brand colour as the theme default', () => {
+  const brand = (primary: string) => ({ brand: { logo: null, squareLogo: null, colors: { primary } } })
+
+  it('pure: used only while the theme colour is not set', () => {
+    expect(withBrandColour({ colorPrimary: '' }, '#0F5C4D').colorPrimary).toBe('#0F5C4D')
+    expect(withBrandColour({ colorPrimary: '#111111' }, '#0F5C4D').colorPrimary).toBe('#111111')
+    expect(withBrandColour({ colorPrimary: '' }, 'teal').colorPrimary).toBe('')
+    expect(withBrandColour({ colorPrimary: '' }, undefined).colorPrimary).toBe('')
+  })
+
+  it('an untouched theme colour renders the Settings brand colour', async () => {
+    const { ctx } = home({ shop: brand('#0F5C4D') })
+    const { rules, state } = await serverHtml(render, ctx)
+    expect(rules).toContain('--color-brand:#0F5C4D')
+    // the browser hydrates with the same settings
+    expect(state).toContain('"colorPrimary":"#0F5C4D"')
+  })
+
+  it("the theme's own colour still wins once set (also a legacy AI colour)", async () => {
+    for (const settings of [{ colorPrimary: '#222222' }, { colorBrand: '#222222' }]) {
+      const { ctx } = home({ settings, shop: brand('#0F5C4D') })
+      const { rules } = await serverHtml(render, ctx)
+      expect(rules).toContain('--color-brand:#222222')
+      expect(rules).not.toContain('#0F5C4D')
+    }
+  })
+
+  it('no brand colour: nothing changes', async () => {
+    const { ctx } = home({})
+    const { rules } = await serverHtml(render, ctx)
+    expect(rules).not.toContain('--color-brand:')
+  })
+})
+
+// ── shared fixtures ──────────────────────────────────────────────────────────
+
+const BANNER = {
+  enabled: true, automated: false, position: 'bottom-right', colorTheme: 'dark', regions: ['US-CA', 'TH'],
+  text: { title: 'Cookies here', body: 'We bake them fresh.', acceptLabel: 'Sure', declineLabel: 'No thanks', manageLabel: 'Choose', privacyLinkLabel: 'Our privacy' },
+  preferences: { title: 'Your cookie choices', saveLabel: 'Keep these', declineAllLabel: 'None please', marketingTitle: 'Ads', bulletsEnabled: true, bulletTitle: 'We use them to', bullets: ['remember your cart', ' ', 'measure visits'] },
+}
+const POLICY_LINKS = [
+  { handle: 'refund-policy', title: 'Refund policy', url: 'https://shop.example/policies/refund-policy' },
+  { handle: 'privacy-policy', title: 'Our privacy promise', url: 'https://shop.example/policies/privacy-policy' },
+]
+const ui = (o: Record<string, unknown>, country = 'TH') => toShop(convert.shop({ ...SHOP, ...o } as never, [], country) as never)
+const nova = (el: JSX.Element, locale = 'en') => rtl(<NovaProvider locale={locale} dir="ltr" mode="storefront">{el}</NovaProvider>)
+
+describe('convert.shop: the run-5 members (absent = today)', () => {
+  it('absent: none of them appears', () => {
+    const s = ui({})
+    for (const k of ['email', 'phone', 'taxesIncluded', 'freeShippingThreshold', 'signInLinks', 'policyLinks', 'consentBanner']) expect(s).not.toHaveProperty(k)
+  })
+  it('present: mapped, unsafe values dropped', () => {
+    const s = ui({
+      contact: { email: 'hello@cat.example', phone: '+66 81 234 5678' }, taxesIncluded: true, accounts: { signInLinks: false, type: 'customer', selfServeReturns: false, storeCredit: false },
+      freeShipping: [{ countries: ['US'], minimumSubtotal: money('50.00', 'USD') }, { countries: ['TH', 'LA'], minimumSubtotal: money('1000.00', 'THB') }],
+      policyLinks: POLICY_LINKS, cookieBanner: { ...BANNER, privacyLinkUrl: 'javascript:alert(1)', regions: ['US-CA', 'bad', 'TH'] },
+    })
+    expect(s).toMatchObject({ email: 'hello@cat.example', phone: '+66 81 234 5678', taxesIncluded: true, signInLinks: false, freeShippingThreshold: { amount: 1000, currencyCode: 'THB' } })
+    expect(s.policyLinks).toEqual([{ handle: 'refund-policy', title: 'Refund policy', url: '/policies/refund-policy' }, { handle: 'privacy-policy', title: 'Our privacy promise', url: '/policies/privacy-policy' }])
+    expect(s.consentBanner).toMatchObject({ enabled: true, automated: false, position: 'bottom-right', colorTheme: 'dark', regions: ['US-CA', 'TH'] })
+    expect(s.consentBanner).not.toHaveProperty('privacyLinkUrl')
+    expect(s.consentBanner?.preferences.bullets).toEqual(['remember your cart', 'measure visits'])
+  })
+  it('taxesIncluded false, signInLinks true, bad contact: absent', () => {
+    const s = ui({ taxesIncluded: false, accounts: { signInLinks: true }, contact: { email: 'not an email', phone: 'call me' } })
+    for (const k of ['email', 'phone', 'taxesIncluded', 'signInLinks']) expect(s).not.toHaveProperty(k)
+  })
+})
+
+describe('D-2 cookie banner', () => {
+  const b = convert.cookieBanner(BANNER)!
+  it('where it shows: legal floor, then the merchant switch, automated, regions', () => {
+    expect(consentBannerShows({}, b)).toBe(true) // edge does not say: legal floor
+    expect(consentBannerShows({ regionRequiresBanner: true }, { ...b, enabled: false })).toBe(true) // EEA/UK: the switch cannot turn it off
+    expect(consentBannerShows({ regionRequiresBanner: false }, null)).toBe(true) // old data: as today
+    expect(consentBannerShows({ regionRequiresBanner: false, geo: { country: 'US', region: 'US-NY' } }, { ...b, enabled: false })).toBe(false)
+    expect(consentBannerShows({ regionRequiresBanner: false, geo: { country: 'US', region: 'US-NY' } }, { ...b, automated: true })).toBe(true)
+    expect(consentBannerShows({ regionRequiresBanner: false, geo: { country: 'US', region: 'US-CA' } }, b)).toBe(true)
+    expect(consentBannerShows({ regionRequiresBanner: false, geo: { country: 'TH' } }, b)).toBe(true)
+    expect(consentBannerShows({ regionRequiresBanner: false, geo: { country: 'US', region: 'US-NY' } }, b)).toBe(false)
+    expect(consentBannerShows({ regionRequiresBanner: false }, b)).toBe(false)
+  })
+  it("the merchant's words, position and colours", () => {
+    const { container } = nova(<CookieConsent open privacyUrl="/policies/privacy-policy" config={b} onDecide={() => {}} />)
+    const banner = container.querySelector('.nv-consent')!
+    expect(banner.getAttribute('data-position')).toBe('bottom-right')
+    expect(banner.getAttribute('data-scheme')).toBe('dark')
+    expect(banner.textContent).toContain('Cookies here')
+    expect(banner.textContent).toContain('We bake them fresh.')
+    expect(screen.getByRole('link', { name: 'Our privacy' }).getAttribute('href')).toBe('/policies/privacy-policy')
+    for (const name of ['Sure', 'No thanks', 'Choose']) expect(screen.getByRole('button', { name })).toBeTruthy()
+  })
+  it('the preferences dialog uses the merchant copy', () => {
+    nova(<CookieConsent open defaultManageOpen config={b} onDecide={() => {}} />)
+    expect(screen.getByRole('dialog').textContent).toContain('Your cookie choices')
+    expect(screen.getByRole('button', { name: 'Keep these' })).toBeTruthy()
+    expect(screen.getByRole('button', { name: 'None please' })).toBeTruthy()
+    expect(screen.getByRole('dialog').textContent).toContain('Ads')
+    expect(screen.getAllByRole('listitem').map((li) => li.textContent)).toEqual(expect.arrayContaining(['remember your cart', 'measure visits']))
+  })
+  it('custom colours and no config: the theme banner as before', () => {
+    const { container } = nova(<CookieConsent open config={{ ...b, colorTheme: 'custom', text: {} }} onDecide={() => {}} />)
+    expect(container.querySelector('.nv-consent')!.hasAttribute('data-scheme')).toBe(false)
+    expect(container.textContent).toContain('We use cookies.')
+    const plain = nova(<CookieConsent open onDecide={() => {}} />)
+    const el = plain.container.querySelector('.nv-consent')!
+    expect(el.hasAttribute('data-position')).toBe(false)
+    expect(el.hasAttribute('data-scheme')).toBe(false)
+  })
+})
+
+// A one-variant product page with the inventory block, low-only.
+function pdpServer(o: { shop?: Record<string, unknown>; lowStockThreshold?: number; qty?: number } = {}) {
+  const p = product('mug', 'Cat Mug', '350.00')
+  const withStock = {
+    ...p,
+    ...(o.lowStockThreshold !== undefined ? { lowStockThreshold: o.lowStockThreshold } : {}),
+    variants: conn([{ ...p.variants.nodes[0]!, ...(o.qty !== undefined ? { quantityAvailable: o.qty } : {}) }]),
+  }
+  return abiCtx({
+    kind: 'product', handle: 'mug',
+    store: { shop: { ...SHOP, ...(o.shop ?? {}) }, products: [withStock] },
+    page: pageOf('product', [
+      { region: 'main', sections: [{ type: 'product-details', id: 'main', settings: { showInventory: 'low-only', lowStockThreshold: 5 }, blocks: [{ type: 'product-price', id: 'price' }, { type: 'add-to-cart', id: 'atc' }, { type: 'product-inventory', id: 'inv' }] }] },
+    ]),
+  })
+}
+
+describe('D-4 Tax included', () => {
+  it('product page: under the price only when the store includes tax', async () => {
+    const on = await serverHtml(render, pdpServer({ shop: { taxesIncluded: true } }).ctx)
+    expect(on.root).toContain('Tax included.')
+    const off = await serverHtml(render, pdpServer().ctx)
+    expect(off.root).not.toContain('Tax included.')
+  })
+  it('the words in English, Thai and Arabic', () => {
+    expect([STRINGS_EN.taxIncluded, STRINGS_TH.taxIncluded, STRINGS_TH.taxIncludedShippingAtCheckout]).toEqual(['Tax included.', 'รวมภาษีแล้ว', 'รวมภาษีแล้ว ค่าจัดส่งคำนวณตอนชำระเงิน'])
+    expect(STRINGS_AR.taxIncluded.trim()).not.toBe('')
+  })
+  it('cart page summary: the tax line', () => {
+    nova(<CartSummary subtotal={money2(1200)} taxNote={STRINGS_EN.taxIncludedShippingAtCheckout} checkoutLabel="Checkout" checkoutUrl="/checkout" />)
+    expect(screen.getByText('Tax included. Shipping calculated at checkout.')).toBeTruthy()
+  })
+  it('cart drawer note: Tax included. Shipping calculated at checkout. — else today’s note', () => {
+    const cart = cartOf(400)
+    nova(<CartDrawer open onClose={() => {}} cart={cart} checkoutUrl="/checkout" cartUrl="/cart" note="Tax included. Shipping calculated at checkout." />)
+    expect(screen.getByText('Tax included. Shipping calculated at checkout.')).toBeTruthy()
+  })
+})
+
+const money2 = (amount: number, currencyCode = 'THB') => ({ amount, currencyCode })
+function cartOf(subtotal: number) {
+  const m = money2(subtotal)
+  return { ...fx.cart, subtotal: m, total: m }
+}
+
+describe('D-5 free-shipping bar', () => {
+  it('the threshold of the shopper country only', () => {
+    const list = [{ countries: ['US'], minimumSubtotal: money('50.00', 'USD') }, { countries: ['TH'], minimumSubtotal: money('1000.00', 'THB') }]
+    expect(convert.freeShippingFor(list, 'TH')).toEqual({ amount: '1000.00', currencyCode: 'THB' })
+    expect(convert.freeShippingFor(list, 'JP')).toBeNull()
+    expect(convert.freeShippingFor(undefined, 'TH')).toBeNull()
+  })
+  it('progress against the subtotal; none across currencies', () => {
+    expect(freeShippingProgress(money2(1000), money2(400))).toEqual({ remaining: money2(600), progress: 0.4 })
+    expect(freeShippingProgress(money2(1000), money2(1200))).toEqual({ remaining: money2(0), progress: 1 })
+    expect(freeShippingProgress(money2(0), money2(10))?.progress).toBe(1)
+    expect(freeShippingProgress(money2(50, 'USD'), money2(400))).toBeNull()
+    expect(freeShippingProgress(undefined, money2(400))).toBeNull()
+  })
+  it('the drawer shows the bar with the remaining amount', () => {
+    nova(<CartDrawer open onClose={() => {}} cart={cartOf(400)} checkoutUrl="/checkout" cartUrl="/cart" freeShipping={freeShippingProgress(money2(1000), money2(400))} />)
+    expect(document.body.textContent).toMatch(/600.*away from free shipping/)
+  })
+})
+
+const FOOTER_PAGE = (shop: Record<string, unknown>, footerSettings: Record<string, unknown> = {}, brandSettings?: Record<string, unknown>) =>
+  abiCtx({
+    kind: 'home', url: 'https://shop.example/',
+    store: { shop: { ...SHOP, ...shop }, menus: [menu('legal', [['Imprint', '/pages/imprint']])] },
+    page: pageOf('index', [
+      { region: 'main', sections: [] },
+      { region: 'footer', sections: [{ type: 'footer', id: 'footer', settings: footerSettings, blocks: [{ type: 'footer-brand', id: 'b', ...(brandSettings ? { settings: brandSettings } : {}) }] }] },
+    ]),
+  })
+
+describe('D-6 footer lists published policies when the legal menu is empty', () => {
+  it('empty legal menu: the published policies, platform titles in the theme language', async () => {
+    const { root } = await serverHtml(render, FOOTER_PAGE({ policyLinks: POLICY_LINKS }).ctx)
+    expect(root).toContain('href="/policies/refund-policy"')
+    expect(root).toContain('Refund policy')
+    expect(root).toContain('Our privacy promise') // the store's own title is kept
+  })
+  it("the merchant's legal menu wins", async () => {
+    const { root } = await serverHtml(render, FOOTER_PAGE({ policyLinks: POLICY_LINKS }, { legalMenu: 'legal' }).ctx)
+    expect(root).toContain('Imprint')
+    expect(root).not.toContain('/policies/refund-policy')
+  })
+  it('no policyLinks: as before (no links)', async () => {
+    const { root } = await serverHtml(render, FOOTER_PAGE({}).ctx)
+    expect(root).not.toContain('/policies/')
+  })
+})
+
+describe('D-7 store contact', () => {
+  const contact = { contact: { email: 'hello@cat.example', phone: '+66 81 234 5678' } }
+  it('footer brand block shows it unless the merchant turned it off', async () => {
+    const on = await serverHtml(render, FOOTER_PAGE(contact).ctx)
+    expect(on.root).toContain('mailto:hello@cat.example')
+    expect(on.root).toContain('tel:+66812345678')
+    const off = await serverHtml(render, FOOTER_PAGE(contact, {}, { showContact: false }).ctx)
+    expect(off.root).not.toContain('mailto:hello@cat.example')
+    const none = await serverHtml(render, FOOTER_PAGE({}).ctx)
+    expect(none.root).not.toContain('mailto:')
+  })
+  it('contact form: the store email / phone as details, never twice', () => {
+    const base = resolveSettings(contactFormSchema, {} as never).settings
+    const { container, unmount } = nova(<ContactFormSection {...(base as unknown as Parameters<typeof ContactFormSection>[0])} shopEmail="hello@cat.example" shopPhone="+66 81 234 5678" />)
+    expect(container.querySelector('a[href="mailto:hello@cat.example"]')).toBeTruthy()
+    expect(container.querySelector('a[href="tel:+66812345678"]')).toBeTruthy()
+    unmount()
+    const own = nova(<ContactFormSection {...(base as unknown as Parameters<typeof ContactFormSection>[0])} details={[{ label: 'Write to', value: 'owner@cat.example', link: 'mailto:owner@cat.example' }]} shopEmail="hello@cat.example" />)
+    expect(own.container.querySelector('a[href="mailto:hello@cat.example"]')).toBeNull()
+  })
+})
+
+describe('D-8 product low-stock threshold', () => {
+  it('convert carries it; out of range dropped', () => {
+    expect(toProduct(convert.product({ ...product('a', 'A'), lowStockThreshold: 10 } as never)).lowStockThreshold).toBe(10)
+    expect(toProduct(convert.product({ ...product('a', 'A'), lowStockThreshold: -1 } as never))).not.toHaveProperty('lowStockThreshold')
+  })
+  it("the product's threshold overrides the theme's 5", async () => {
+    const product8 = await serverHtml(render, pdpServer({ qty: 8, lowStockThreshold: 10 }).ctx)
+    expect(product8.root).toContain('Only 8 left')
+    const theme8 = await serverHtml(render, pdpServer({ qty: 8 }).ctx)
+    expect(theme8.root).not.toContain('Only 8 left')
+    const zero = await serverHtml(render, pdpServer({ qty: 3, lowStockThreshold: 0 }).ctx)
+    expect(zero.root).not.toContain('Only 3 left')
+  })
+})
+
+describe('D-11 Show sign-in links', () => {
+  const header = (shop: Record<string, unknown>) =>
+    abiCtx({ kind: 'home', url: 'https://shop.example/', store: { shop: { ...SHOP, ...shop } }, page: pageOf('index', [{ region: 'header', sections: [{ type: 'header', id: 'header' }] }, { region: 'main', sections: [] }]) })
+  it('off: no account link in the header; absent or on: shown', async () => {
+    const off = await serverHtml(render, header({ accounts: { signInLinks: false, type: 'customer', selfServeReturns: false, storeCredit: false } }).ctx)
+    expect(off.root).not.toMatch(/aria-label="(Account|My account)"/)
+    const on = await serverHtml(render, header({}).ctx)
+    expect(on.root).toMatch(/aria-label="(Account|My account)"/)
+  })
+})
+
+describe('ProductDetails component: tax note sits in the price block', () => {
+  it('renders under the price', () => {
+    const props = { ...(resolveSettings(productDetailsSchema, {} as never).settings as object), product: toProduct(convert.product(product('mug', 'Cat Mug') as never)), blocks: [{ type: 'product-price' }] as ProductDetailsBlock[], taxesIncluded: true }
+    const { container } = nova(<ProductDetails {...(props as unknown as Parameters<typeof ProductDetails>[0])} />)
+    expect(container.querySelector('.nv-pdp-price [data-kind="tax"]')?.textContent).toBe('Tax included.')
+  })
+})