create-tanqory-theme 0.0.0-stage → 0.2.2

package/templates/blank/templates/index.json

@@ -0,0 +1,36 @@
+{
+  "contentVersion": 1,
+  "template": "index",
+  "regions": {
+    "main": {
+      "sections": [
+        {
+          "id": "hero-1",
+          "type": "hero",
+          "settings": {
+            "kicker": "Welcome",
+            "heading": "Your store, your theme",
+            "buttonLabel": "Shop all",
+            "buttonLink": "/collections/all"
+          }
+        },
+        {
+          "id": "featured-1",
+          "type": "featured-collection",
+          "settings": {
+            "heading": "Featured",
+            "collection": "all"
+          }
+        },
+        {
+          "id": "note-1",
+          "type": "rich-text"
+        },
+        {
+          "id": "newsletter-1",
+          "type": "newsletter"
+        }
+      ]
+    }
+  }
+}

package/templates/blank/templates/page.contact.json

@@ -0,0 +1,18 @@
+{
+  "contentVersion": 1,
+  "template": "page.contact",
+  "regions": {
+    "main": {
+      "sections": [
+        {
+          "id": "page-1",
+          "type": "page"
+        },
+        {
+          "id": "contact-1",
+          "type": "contact-form"
+        }
+      ]
+    }
+  }
+}

package/templates/blank/templates/page.json

@@ -0,0 +1,14 @@
+{
+  "contentVersion": 1,
+  "template": "page",
+  "regions": {
+    "main": {
+      "sections": [
+        {
+          "id": "page-1",
+          "type": "page"
+        }
+      ]
+    }
+  }
+}

package/templates/blank/templates/product.json

@@ -0,0 +1,18 @@
+{
+  "contentVersion": 1,
+  "template": "product",
+  "regions": {
+    "main": {
+      "sections": [
+        {
+          "id": "product-1",
+          "type": "product"
+        },
+        {
+          "id": "recs-1",
+          "type": "product-recommendations"
+        }
+      ]
+    }
+  }
+}

package/templates/blank/templates/search.json

@@ -0,0 +1,14 @@
+{
+  "contentVersion": 1,
+  "template": "search",
+  "regions": {
+    "main": {
+      "sections": [
+        {
+          "id": "search-1",
+          "type": "search"
+        }
+      ]
+    }
+  }
+}

package/templates/blank/tests/theme.test.ts

@@ -0,0 +1,49 @@
+/**
+ * Fast checks on the theme's own declarations (run with `npm test`). The full storefront behaviour is
+ * checked by `npm run check` on the built theme.
+ */
+import { readFileSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import theme from '../src/theme'
+import { TEMPLATES } from '../src/templates'
+
+const root = fileURLToPath(new URL('..', import.meta.url))
+const json = (p: string) => JSON.parse(readFileSync(join(root, p), 'utf8'))
+
+describe('locales', () => {
+  const en = json('locales/en.json') as Record<string, string>
+  const th = json('locales/th.json') as Record<string, string>
+  it('every English key has a Thai string, and the reverse', () => {
+    expect(Object.keys(th).sort()).toEqual(Object.keys(en).sort())
+  })
+  it('placeholders match between languages', () => {
+    const vars = (s: string) => (s.match(/\{\w+\}/g) ?? []).sort()
+    for (const k of Object.keys(en)) expect(vars(th[k] ?? ''), k).toEqual(vars(en[k]!))
+  })
+})
+
+describe('templates', () => {
+  it('every template in src/templates.ts has templates/<name>.json, and the reverse', () => {
+    const files = readdirSync(join(root, 'templates')).filter((f) => f.endsWith('.json')).map((f) => f.replace(/\.json$/, ''))
+    expect(files.sort()).toEqual(Object.keys(TEMPLATES).sort())
+  })
+  it('starter content uses only declared section types', () => {
+    const types = new Set(theme.sections.map((s) => s.id))
+    const docs = [
+      ...readdirSync(join(root, 'templates')).map((f) => json(`templates/${f}`)),
+      ...['header', 'footer'].map((r) => ({ regions: { [r]: json(`regions/${r}.json`) } })),
+    ]
+    for (const doc of docs)
+      for (const region of Object.values(doc.regions ?? {}) as Array<{ sections?: Array<{ type: string }> }>)
+        for (const s of region.sections ?? []) expect(types.has(s.type), s.type).toBe(true)
+  })
+})
+
+describe('sections', () => {
+  it('section types are unique', () => {
+    const types = theme.sections.map((s) => s.id)
+    expect(new Set(types).size).toBe(types.length)
+  })
+})

package/templates/blank/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["vite/client", "node"]
+  },
+  "include": ["src", "scripts/probe.ts", "tests", "vite.*.config.ts", "vitest.config.ts"]
+}

package/templates/blank/vite.client.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// The browser bundle → dist/build/client. `base: './'`: the asset origin and its /a/<digest>/client prefix
+// are known only once the platform has built the artifact, so every URL stays relative to its file.
+export default defineConfig({
+  plugins: [react()],
+  base: './',
+  build: {
+    outDir: 'dist/build/client',
+    emptyOutDir: true,
+    manifest: true,
+    target: 'es2022',
+    sourcemap: false,
+    rollupOptions: { input: 'src/entry.client.tsx' },
+  },
+})

package/templates/blank/vite.probe.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// The theme's declarations for Node (scripts/build.mjs reads them to write the manifest). The kit is
+// bundled in so its `import.meta.env` reads are defined; React stays external.
+export default defineConfig({
+  plugins: [react()],
+  ssr: { noExternal: ['@tanqory/theme-kit'] },
+  build: {
+    ssr: 'scripts/probe.ts',
+    outDir: 'dist/.probe',
+    emptyOutDir: true,
+    target: 'node20',
+    rollupOptions: { output: { entryFileNames: 'probe.mjs', format: 'es' } },
+  },
+})

package/templates/blank/vite.server.config.ts

@@ -0,0 +1,32 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// The serve entry → dist/build/server/entry.mjs: ONE ES module, everything inlined, no imports, no dynamic
+// import(), no Node built-ins (Theme ABI v2 §1, §11). Browser-only globals are compile-time `undefined` here:
+// every use sits behind a `typeof window` guard or in an effect that never runs during the server render, so
+// the minifier drops those branches and the entry has no free identifier outside the ABI's globals.
+const BROWSER_ONLY = [
+  'window', 'document', 'location', 'history', 'self', 'localStorage', 'sessionStorage',
+  'requestAnimationFrame', 'cancelAnimationFrame', 'getComputedStyle', 'matchMedia', 'CSS',
+  'DOMParser', 'MutationObserver', 'ResizeObserver', 'IntersectionObserver', 'HTMLElement',
+  'MessageChannel', 'setImmediate', 'MSApp', 'reportError', '__REACT_DEVTOOLS_GLOBAL_HOOK__',
+]
+
+export default defineConfig({
+  plugins: [react()],
+  define: {
+    'process.env.NODE_ENV': '"production"',
+    ...Object.fromEntries(BROWSER_ONLY.map((name) => [name, 'undefined'])),
+  },
+  ssr: { noExternal: true, target: 'webworker' },
+  resolve: { conditions: ['workerd', 'worker', 'browser', 'module', 'import', 'default'] },
+  build: {
+    ssr: 'src/entry.server.tsx',
+    outDir: 'dist/build/server',
+    emptyOutDir: true,
+    target: 'es2022',
+    minify: 'esbuild',
+    sourcemap: false,
+    rollupOptions: { output: { entryFileNames: 'entry.mjs', format: 'es', inlineDynamicImports: true } },
+  },
+})

package/templates/blank/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config'
+
+// The kit reads import.meta.env, so it is transformed like the theme's own source.
+export default defineConfig({
+  test: {
+    include: ['tests/**/*.test.{ts,tsx}'],
+    server: { deps: { inline: ['@tanqory/theme-kit'] } },
+  },
+})

package/templates/common/.claude/settings.json

@@ -0,0 +1,8 @@
+{
+  "enableAllProjectMcpServers": true,
+  "permissions": {
+    "allow": [
+      "mcp__tanqory__*"
+    ]
+  }
+}

package/templates/common/.codex/config.toml

@@ -0,0 +1,4 @@
+# Codex (ChatGPT in VS Code): the Tanqory MCP server for this theme.
+[mcp_servers.tanqory]
+command = "npx"
+args = ["-y", "@tanqory/cli", "mcp"]

package/templates/common/.gemini/settings.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "tanqory": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@tanqory/cli",
+        "mcp"
+      ]
+    }
+  }
+}

package/templates/common/.github/workflows/theme-check.yml

@@ -0,0 +1,44 @@
+name: Theme check
+
+# Builds the theme and runs the platform's checks on every push and pull request: the same tiers the
+# platform runs before it accepts a build (security, storefront, budgets).
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install
+        run: |
+          if [ -f pnpm-lock.yaml ]; then corepack enable && pnpm install --frozen-lockfile
+          elif [ -f yarn.lock ]; then corepack enable && yarn install --immutable
+          elif [ -f package-lock.json ]; then npm ci
+          else npm install
+          fi
+
+      - run: npm run build
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run check
+        env:
+          CI: 'true'
+
+      - name: Reports
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: theme-check-reports
+          path: reports/
+          if-no-files-found: ignore

package/templates/common/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "tanqory": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@tanqory/cli",
+        "mcp"
+      ]
+    }
+  }
+}

package/templates/common/.vscode/mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": {
+    "tanqory": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@tanqory/cli", "mcp"]
+    }
+  }
+}

package/templates/common/_gitignore

@@ -0,0 +1,9 @@
+node_modules/
+dist/
+reports/
+src/generated/
+lib/abi/generated/
+.DS_Store
+*.tgz
+.tanqory/dev-server.json
+.tanqory/dev/

package/templates/common/scripts/check.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * `npm run check`: the platform's checks on the built theme (dist/abi), the same ones the platform runs before
+ * it accepts a build. The same checks as `tanqory theme check` (which also builds first and prints a JSON report).
+ *
+ *   npm run check                      every tier: security (9 ABI suites), storefront, budgets
+ *   npm run check -- --tier security   one tier (security | storefront | budgets | all)
+ *
+ * Reports: reports/conformance-report.json and reports/storefront-report.json. Each failing check prints its id,
+ * the reason and a `fix:` hint. Exit 0 only when every selected tier passes.
+ *
+ * Suite 5 and the storefront tier drive headless Chromium: the first run downloads it with the Playwright that
+ * @tanqory/theme-conformance pins (`--with-deps` on Linux CI, which also installs the OS libraries).
+ */
+import { spawnSync } from 'node:child_process'
+import { existsSync, mkdirSync, readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const require = createRequire(join(root, 'package.json'))
+const run = (cmd, args) => spawnSync(cmd, args, { cwd: root, stdio: 'inherit' }).status ?? 1
+
+if (!existsSync(join(root, 'dist', 'abi', 'manifest.json'))) {
+  console.error('dist/abi is missing: run `npm run build` first.')
+  process.exit(1)
+}
+
+const conformance = dirname(require.resolve('@tanqory/theme-conformance/package.json'))
+const pw = createRequire(join(conformance, 'package.json')).resolve('playwright/package.json')
+const install = ['install', ...(process.platform === 'linux' && process.env.CI ? ['--with-deps'] : []), 'chromium']
+if (run(process.execPath, [join(dirname(pw), 'cli.js'), ...install]) !== 0) {
+  console.error('Could not install headless Chromium for the checks (see the output above).')
+  process.exit(1)
+}
+
+const args = process.argv.slice(2)
+const tier = args.includes('--tier') ? [] : ['--tier', 'all']
+mkdirSync(join(root, 'reports'), { recursive: true })
+const bin = join(conformance, JSON.parse(readFileSync(join(conformance, 'package.json'), 'utf8')).bin['theme-conformance'])
+const status = run(process.execPath, [bin, 'run', 'dist/abi', ...tier, '--out', 'reports/conformance-report.json', '--storefront-out', 'reports/storefront-report.json', ...args])
+console.error('\nAgents: the `check_theme` MCP tool (Claude Code: mcp__tanqory__check_theme) runs these checks and returns each failure as JSON with its check id, fix hint and file:line when known.')
+process.exit(status)

package/templates/common/scripts/dev.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * `npm run dev`: `tanqory theme dev` from the Tanqory CLI this theme pins (devDependency @tanqory/cli).
+ *
+ *   npm run dev                         real store data (sign in first: npx tanqory login)
+ *   npm run dev -- --mock               offline, on the checks' fixture store
+ *   npm run dev -- --store <handle|id>  another signed-in store
+ *
+ * Serves http://localhost:9292 (the theme in workerd under the platform's production shim, rebuilt on change)
+ * and the Tanqory Editor at http://localhost:9292/__editor.
+ */
+import { spawn } from 'node:child_process'
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const require = createRequire(join(root, 'package.json'))
+let bin
+try {
+  const pj = require.resolve('@tanqory/cli/package.json')
+  bin = join(dirname(pj), JSON.parse(readFileSync(pj, 'utf8')).bin.tanqory)
+} catch {
+  console.error('The Tanqory CLI (@tanqory/cli) is not installed in this theme: run `npm install`.')
+  process.exit(1)
+}
+const child = spawn(process.execPath, [bin, 'theme', 'dev', ...process.argv.slice(2)], { cwd: root, stdio: 'inherit' })
+for (const sig of ['SIGINT', 'SIGTERM']) process.on(sig, () => child.kill(sig))
+child.on('exit', (code, signal) => process.exit(code ?? (signal ? 0 : 1)))

package/templates/common/tanqory.config.json

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "theme": "__PACKAGE_NAME__",
+  "store": null,
+  "output": "dist/abi"
+}

package/templates/nova/.gitattributes

@@ -0,0 +1,3 @@
+# Compiler-managed: written by `tanqory-theme`, never edited by hand.
+.tanqory/** linguist-generated=true
+theme.manifest.json linguist-generated=true

package/templates/nova/.tanqory/contracts/LOCK.json

@@ -0,0 +1,66 @@
+{
+  "$comment": "Generated by `tanqory-theme contracts`. Do not edit — neither this file nor the locks beside it. Re-lock from the approved design package with `tanqory-theme contracts --design <dir> --write`.",
+  "generator": "@tanqory/theme-compiler contracts",
+  "files": {
+    "nova-01.json": {
+      "family": "01",
+      "design": "Nova 01 Style System.dc.html",
+      "designSha256": "f6d9d86d1cc8e43d9270dc02d0531112ab8c3875ae445e115a16a4360f28886e",
+      "sha256": "18b652c02e0286e38f2a2fb43c0c7ae6ab71bd6d06cb51cc18f79e9e8c52e103"
+    },
+    "nova-12A.json": {
+      "family": "12A",
+      "design": "Nova 12A - Chrome and Structure.dc.html",
+      "designSha256": "818a65c5273842c5503347035e8be3719db98db3aea027ef274d977a3d1b6cfd",
+      "sha256": "6ffb832ee9f5b96daef62bfdb3d7dc83ea8282764cd340088012819e5c7d2696"
+    },
+    "nova-12B.json": {
+      "family": "12B",
+      "design": "Nova 12B - Heroes and Promotion.dc.html",
+      "designSha256": "c5c694e88cf42524261d4b6c0d80e3cca3c67559677c2345ff6313ec63d5da4f",
+      "sha256": "e871e752b3b9e63fa84c6c30e6c83710635d6ee0fe87ef4ed623d17cb9eb9246"
+    },
+    "nova-12C.json": {
+      "family": "12C",
+      "design": "Nova 12C - Product and Merchandising.dc.html",
+      "designSha256": "b1fae6177f6ccc6371c939c9d890963a70c005c32b5579c0563083da325c9e67",
+      "sha256": "f1b81651782e4dd7ae2d0449ff2afed8ae60f3f0652c0f7188057d0c4db41c61"
+    },
+    "nova-12D.json": {
+      "family": "12D",
+      "design": "Nova 12D - Content and Storytelling.dc.html",
+      "designSha256": "d3b02aa06eb38eca9e7de82d8cc2e04da18de269c672508b3ec6381a61b9e72d",
+      "sha256": "6392e08914b6a3d0701be9053dd2d1f319a167104719230804611acab1cd0ddb"
+    },
+    "nova-12E.json": {
+      "family": "12E",
+      "design": "Nova 12E - Editorial and Long-form.dc.html",
+      "designSha256": "8d9f89a03827e5ec7d6c0d59cadd912ec02353f30ce04c2662dd03c93a5cc3e0",
+      "sha256": "86b98e1b206163b989741f5421d1beed2a97efdc6ecd0094fd97663466a9c831"
+    },
+    "nova-12F.json": {
+      "family": "12F",
+      "design": "Nova 12F - Trust and Advanced Commerce.dc.html",
+      "designSha256": "46679ec18e3631316ec0ad6c23984a8ad5c0a4c577e776a859603af9b4f33570",
+      "sha256": "8c57eb9eacecd1d70bef6bff121d41a4ac253bcb04324c94fa1fa636f1517a2f"
+    },
+    "nova-12G.json": {
+      "family": "12G",
+      "design": "Nova 12G - Utility and Customer Experience.dc.html",
+      "designSha256": "bcab23f69624054de9593cdea2e7e907a066730be24f1a1b6a705e7559565d47",
+      "sha256": "9a2169e250e5ae6012068a05e79ca4ebdd2fd218781d5fd27825ea8fc481e0eb"
+    },
+    "nova-13.json": {
+      "family": "13",
+      "design": "Nova 13 - Overlays and Feedback.dc.html",
+      "designSha256": "a4ae0368e868042561d1000817e3f125f77ffd0391490073d9ffd2d72e03cb3c",
+      "sha256": "582e3596f03a036f8135f3c344d85a87eeaa68058d2924b15062eb2a14e874af"
+    },
+    "nova-14.json": {
+      "family": "14",
+      "design": "Nova 14 - Media and System States.dc.html",
+      "designSha256": "5b332d357feff8cb0a2e4606dd3aa41591eaa0d121c88f451327a22e6a40b9cd",
+      "sha256": "5faca992be4bfebd57e7f75dc5c0f23adaeea71e05b8155bce0f07b84da2d2a4"
+    }
+  }
+}