@woodsportal/hubspot-kit 1.0.2

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@woodsportal/hubspot-kit",
+  "version": "1.0.2",
+  "description": "WoodsCLI — HubSpot CMS dev kit by WoodsPortal. wp CLI, Vite presets, module-config overlay, and theme/module build pipelines.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "wp": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "vite",
+    "templates",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./vite": {
+      "import": "./dist/vite/index.js"
+    },
+    "./dev/bootstrap": "./src/dev/bootstrap.tsx",
+    "./routing/route-format": "./src/routing/route-format.ts",
+    "./routing/build-api-routes": "./src/routing/build-api-routes.ts",
+    "./scripts/tailwind/prefix.env.js": "./scripts/tailwind/prefix.env.js",
+    "./scripts/*": "./scripts/*",
+    "./vite/*": "./vite/*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Digital-Woods/digitalwoods.io-woodsportal-hubspot-kit.git"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test 'src/lib/**/*.test.ts' 'src/schema/**/*.test.ts' 'src/vite/**/*.test.ts' && vitest run src/dev-module-config/__tests__/normalize-repeater-items.test.ts src/dev-module-config/__tests__/module-config-transform.test.ts",
+    "test:examples": "node examples/smoke/run-matrix.mjs --tier static",
+    "lint": "eslint src",
+    "verify": "npm run typecheck && npm run test && npm run test:examples && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@babel/generator": "^7.27.0",
+    "@babel/parser": "^7.27.0",
+    "@babel/traverse": "^7.27.0",
+    "@babel/types": "^7.27.0",
+    "@clack/prompts": "^0.10.1",
+    "commander": "^13.1.0",
+    "picocolors": "^1.1.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "vitest": "^3.2.4",
+    "tsx": "^4.19.3",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "@tailwindcss/vite": "^4.0.0",
+    "@tanstack/router-plugin": "^1.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "vite": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tailwindcss/vite": { "optional": true },
+    "@tanstack/router-plugin": { "optional": true },
+    "@vitejs/plugin-react": { "optional": true },
+    "babel-plugin-react-compiler": { "optional": true },
+    "react": { "optional": true },
+    "react-dom": { "optional": true },
+    "vite": { "optional": true }
+  }
+}

package/scripts/audit-module-config-fields.mjs

@@ -0,0 +1,73 @@
+/**
+ * Audits fields.json leaf paths against supported module-config field types.
+ * Run: node scripts/audit-module-config-fields.mjs
+ */
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+
+const HUBSPOT_ONLY = new Set([
+  'portal_cdn_base_url',
+  'portal_build_id',
+  'portal_vendor_script',
+  'portal_app_script',
+  'portal_app_css',
+  'hubspot_data_source',
+])
+
+const SUPPORTED_TYPES = new Set([
+  'text',
+  'number',
+  'boolean',
+  'choice',
+  'color',
+  'richtext',
+  'image',
+  'link',
+  'url',
+  'group',
+])
+
+/** @typedef {{ name: string, type: string, children?: Field[], occurrence?: unknown, tab?: string }} Field */
+
+/** @param {Field[]} fields @param {string} prefix */
+function collectPaths(fields, prefix = '') {
+  /** @type {Array<{ path: string, type: string, name: string }>} */
+  const paths = []
+  for (const field of fields) {
+    const fieldPath = prefix ? `${prefix}.${field.name}` : field.name
+    const topName = field.name
+
+    if (HUBSPOT_ONLY.has(topName)) continue
+
+    if (field.type === 'group') {
+      if (field.occurrence) {
+        paths.push({ path: fieldPath, type: 'occurrence-group', name: field.name })
+      }
+      if (field.children?.length) {
+        paths.push(...collectPaths(field.children, field.occurrence ? fieldPath : fieldPath))
+      }
+      continue
+    }
+
+    paths.push({ path: fieldPath, type: field.type, name: field.name })
+  }
+  return paths
+}
+
+const fieldsPath = path.join(root, 'public/fields.json')
+const fields = JSON.parse(await fs.readFile(fieldsPath, 'utf8'))
+const paths = collectPaths(fields)
+const unsupported = paths.filter((entry) => !SUPPORTED_TYPES.has(entry.type) && entry.type !== 'occurrence-group')
+
+if (unsupported.length > 0) {
+  console.error('Unsupported module-config field paths:')
+  for (const entry of unsupported) {
+    console.error(`  - ${entry.path} (${entry.type})`)
+  }
+  process.exit(1)
+}
+
+console.log(`OK: ${paths.length} field paths covered by module-config editors`)

package/scripts/audit-parity.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Regression: snapshot dist/ layout hashes vs .wp-hs-baseline (optional).
+ * Invoked via: wp audit parity
+ */
+import { spawnSync } from 'node:child_process'
+import { createRequire } from 'node:module'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const require = createRequire(import.meta.url)
+const kitRoot = dirname(require.resolve('@woodsportal/hubspot-kit/package.json', {
+  paths: [dirname(fileURLToPath(import.meta.url))],
+}))
+
+const cli = resolve(kitRoot, 'dist/cli.js')
+const result = spawnSync(process.execPath, [cli, 'audit', 'parity', ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  env: process.env,
+})
+
+process.exit(result.status ?? 1)

package/scripts/audit-tdz-split.mjs

@@ -0,0 +1,111 @@
+/**
+ * TDZ audit: build with TanStack route code-splitting + dynamic imports (no inline).
+ * Usage: node scripts/audit-tdz-split.mjs
+ */
+import { defineConfig, build } from 'vite'
+import viteReact from '@vitejs/plugin-react'
+import { TanStackRouterVite } from '@tanstack/router-plugin/vite'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execSync } from 'node:child_process'
+import { readFileSync, readdirSync, existsSync } from 'node:fs'
+import tailwindcss from '@tailwindcss/vite'
+import tailwindPrefixPlugin from './tailwind/prefix-plugin.js'
+import TailwindContentPlugin from './tailwind/tailwind-content-plugin.js'
+import isPrefix from './tailwind/prefix.env.js'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = resolve(__dirname, '..')
+const outDir = resolve(root, 'dist/TdzAudit')
+const mode = 'production'
+
+const config = defineConfig({
+  plugins: [
+    TanStackRouterVite({ autoCodeSplitting: true }),
+    viteReact({
+      babel: { plugins: ['babel-plugin-react-compiler'] },
+    }),
+    tailwindcss(),
+    ...(isPrefix(mode)
+      ? [tailwindPrefixPlugin(), TailwindContentPlugin()]
+      : []),
+  ],
+  resolve: { alias: { '@': resolve(root, './src') } },
+  define: {
+    'process.env.NODE_ENV': JSON.stringify('production'),
+    'process.env': {},
+    process: JSON.stringify({ env: {} }),
+  },
+  build: {
+    outDir,
+    emptyOutDir: true,
+    copyPublicDir: false,
+    cssCodeSplit: true,
+    lib: {
+      entry: resolve(root, 'src/main.tsx'),
+      name: 'TdzAuditModule',
+      fileName: () => 'module.js',
+      formats: ['iife'],
+    },
+    rollupOptions: {
+      external: [],
+      output: {
+        assetFileNames: 'module.css',
+        inlineDynamicImports: false,
+      },
+    },
+    minify: true,
+    sourcemap: true,
+  },
+})
+
+try {
+  await build(config)
+
+  const files = existsSync(outDir) ? readdirSync(outDir) : []
+  const jsFiles = files.filter((f) => f.endsWith('.js'))
+  let syntaxOk = true
+  let syntaxError = null
+  for (const f of jsFiles) {
+    try {
+      execSync(`node --check ${JSON.stringify(resolve(outDir, f))}`, {
+        stdio: 'pipe',
+      })
+    } catch (e) {
+      syntaxOk = false
+      syntaxError = String(e.stderr ?? e.message)
+    }
+  }
+
+  const mainJs = resolve(outDir, 'module.js')
+  const mainSize = existsSync(mainJs) ? readFileSync(mainJs).length : 0
+
+  console.log(
+    JSON.stringify(
+      {
+        outcome: 'build_succeeded',
+        jsFiles,
+        chunkCount: jsFiles.length,
+        mainModuleBytes: mainSize,
+        syntaxCheckPassed: syntaxOk,
+        syntaxError: syntaxError?.slice(0, 500) ?? null,
+        note:
+          'Documented production failure: ReferenceError Cannot access before initialization when route lazy chunks load inside HubSpot single IIFE. Static node --check does not reproduce runtime TDZ.',
+      },
+      null,
+      2,
+    ),
+  )
+} catch (error) {
+  console.log(
+    JSON.stringify(
+      {
+        outcome: 'build_failed',
+        message: String(error.message ?? error).slice(0, 1200),
+        note: 'IIFE lib format + dynamic route imports often conflict at Rollup emit for HubSpot module.js.',
+      },
+      null,
+      2,
+    ),
+  )
+}

package/scripts/build-cdn.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Build CDN vendor + app IIFE chunks into dist/cdn/
+ */
+import { spawnSync } from 'node:child_process'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findProjectRoot } from './project-root.mjs'
+
+import { envWithPortalBuildId } from './resolve-portal-build-id.mjs'
+import { envForPortalBuild, defaultDatadogFlag } from './portal-vite-env.mjs'
+import { resolvePortalViteMode } from './portal-env-mode.mjs'
+
+const root = findProjectRoot()
+
+const mode = resolvePortalViteMode()
+
+const env = envForPortalBuild(mode, root, {
+  VITE_DATADOG_RUM_ENABLED: defaultDatadogFlag(mode),
+})
+
+function runWithEnv(config, buildMode) {
+  const result = spawnSync(
+    'yarn',
+    ['vite', 'build', '--config', config, '--mode', buildMode],
+    { cwd: root, stdio: 'inherit', env },
+  )
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1)
+  }
+}
+
+runWithEnv('vite.config.cdn-vendor.mjs', mode)
+runWithEnv('vite.config.cdn-app.mjs', mode)
+
+console.log('[build-cdn] vendor + app chunks written to dist/cdn/')

package/scripts/check-hubspot-bundle-size.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * CI / local gate for HubSpot module and CDN chunk sizes.
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findProjectRoot } from './project-root.mjs'
+import { gzipSync } from 'node:zlib'
+
+const root = findProjectRoot()
+const embedMode = process.env.VITE_PORTAL_EMBED_MODE ?? 'cdn'
+
+const HUBSPOT_FILE_LIMIT = Number(process.env.HUBSPOT_MODULE_RAW_LIMIT_BYTES ?? 1.5 * 1024 * 1024)
+const BOOTSTRAP_RAW_LIMIT = Number(process.env.HUBSPOT_BOOTSTRAP_RAW_LIMIT_BYTES ?? 200 * 1024)
+const CDN_CHUNK_RAW_LIMIT = Number(process.env.PORTAL_CDN_CHUNK_RAW_LIMIT_BYTES ?? 1.5 * 1024 * 1024)
+/** Phase 1 app chunk may exceed 1.5 MiB until ESM route splitting (Phase 2). */
+const CDN_APP_RAW_LIMIT = Number(
+  process.env.PORTAL_CDN_APP_RAW_LIMIT_BYTES ?? 2.3 * 1024 * 1024,
+)
+
+function checkFile(label, path, rawLimit) {
+  if (!existsSync(path)) {
+    console.error(`FAIL: missing ${label} at ${path}`)
+    process.exit(1)
+  }
+  const raw = readFileSync(path)
+  const gzip = gzipSync(raw)
+  console.log(
+    `${label}: ${(raw.length / 1024).toFixed(1)} KiB raw, ${(gzip.length / 1024).toFixed(1)} KiB gzip (limit ${(rawLimit / 1024).toFixed(0)} KiB raw)`,
+  )
+  if (raw.length > rawLimit) {
+    console.error(`FAIL: ${label} exceeds raw limit`)
+    process.exit(1)
+  }
+}
+
+const moduleDir = resolve(root, 'dist/WoodsPortal.Module')
+const moduleJs = resolve(moduleDir, 'module.js')
+
+if (embedMode === 'monolith') {
+  checkFile('module.js (monolith)', moduleJs, HUBSPOT_FILE_LIMIT)
+} else {
+  checkFile('module.js (bootstrap)', moduleJs, BOOTSTRAP_RAW_LIMIT)
+  checkFile('module.css', resolve(moduleDir, 'module.css'), HUBSPOT_FILE_LIMIT)
+
+  const cdnDir = resolve(root, 'dist/cdn')
+  if (!existsSync(cdnDir)) {
+    console.error('FAIL: dist/cdn missing — run yarn build:cdn')
+    process.exit(1)
+  }
+  for (const file of readdirSync(cdnDir).filter((f) => f.endsWith('.js'))) {
+    const limit = file.startsWith('app.') ? CDN_APP_RAW_LIMIT : CDN_CHUNK_RAW_LIMIT
+    checkFile(`cdn/${file}`, resolve(cdnDir, file), limit)
+  }
+}
+
+console.log('OK: HubSpot / CDN bundle size checks passed')

package/scripts/config-files.mjs

@@ -0,0 +1,53 @@
+/**
+ * Shared project config resolution — `woodscli.json` only.
+ */
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+
+export const WOODSCLI_CONFIG_FILE = 'woodscli.json'
+export const LEGACY_WOODSPORTAL_HS_FILE = 'woodsportal.hs.json'
+
+/**
+ * @param {string} projectRoot
+ */
+export function woodscliConfigPath(projectRoot) {
+  return resolve(projectRoot, WOODSCLI_CONFIG_FILE)
+}
+
+/**
+ * @param {string} projectRoot
+ */
+export function legacyConfigPath(projectRoot) {
+  return resolve(projectRoot, LEGACY_WOODSPORTAL_HS_FILE)
+}
+
+/**
+ * @param {string} projectRoot
+ */
+export function resolveProjectConfigPath(projectRoot) {
+  const fromEnv = process.env.WOODSCLI_CONFIG?.trim() || process.env.WP_HS_CONFIG?.trim() || null
+  if (fromEnv) {
+    const path = resolve(projectRoot, fromEnv)
+    return existsSync(path) ? path : null
+  }
+
+  const path = woodscliConfigPath(projectRoot)
+  return existsSync(path) ? path : null
+}
+
+/**
+ * @param {string} [from]
+ */
+export function findProjectRootWithConfig(from = process.cwd()) {
+  if (process.env.WP_HS_PROJECT_ROOT?.trim()) {
+    return resolve(process.env.WP_HS_PROJECT_ROOT.trim())
+  }
+
+  let dir = resolve(from)
+  while (true) {
+    if (resolveProjectConfigPath(dir)) return dir
+    const parent = resolve(dir, '..')
+    if (parent === dir) return resolve(from)
+    dir = parent
+  }
+}

package/scripts/detect-layout.mjs

@@ -0,0 +1,70 @@
+/**
+ * Detect HubSpot CMS project layout (module vs theme, adopted vs existing).
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+
+import { resolveProjectConfigPath } from './config-files.mjs'
+
+/**
+ * @param {string} projectRoot
+ */
+export function detectProjectLayout(projectRoot) {
+  const root = resolve(projectRoot)
+  const configPath = resolveProjectConfigPath(root)
+  const hasConfig = Boolean(configPath && existsSync(configPath))
+
+  let config = null
+  if (hasConfig && configPath) {
+    try {
+      config = JSON.parse(readFileSync(configPath, 'utf8'))
+    } catch {
+      config = null
+    }
+  }
+
+  const fieldsJsonPaths = [
+    join(root, 'public/fields.json'),
+    join(root, config?.dev?.fieldsJson ?? 'public/fields.json'),
+  ].filter((p, i, arr) => arr.indexOf(p) === i)
+
+  const moduleHtmlPaths = [join(root, 'public/module.html'), join(root, 'module.html')]
+
+  const themeJsonPaths = [
+    join(root, config?.theme?.themeJson ?? 'src/theme/theme.json'),
+    join(root, 'theme.json'),
+    join(root, 'src/theme/theme.json'),
+  ]
+
+  const hasFieldsJson = fieldsJsonPaths.some((p) => existsSync(p))
+  const hasModuleHtml = moduleHtmlPaths.some((p) => existsSync(p))
+  const hasThemeJson = themeJsonPaths.some((p) => existsSync(p))
+  const hasTemplates =
+    existsSync(join(root, 'src/theme/templates')) || existsSync(join(root, 'templates'))
+
+  const wphsDir = config?.dev?.moduleConfigDir ?? '.wphs'
+  const hasWphs = existsSync(join(root, wphsDir))
+
+  let track = 'unknown'
+  if (hasThemeJson || hasTemplates) track = 'theme'
+  else if (hasFieldsJson || hasModuleHtml) track = 'module'
+
+  let setup = 'existing'
+  if (hasConfig && hasWphs) setup = 'adopted'
+  else if (hasConfig && !hasWphs) setup = 'partial'
+  else if (!hasConfig && (hasFieldsJson || hasThemeJson)) setup = 'existing'
+
+  return {
+    projectRoot: root,
+    track,
+    setup,
+    hasConfig,
+    hasWphs,
+    hasFieldsJson,
+    hasModuleHtml,
+    hasThemeJson,
+    hasTemplates,
+    projectType: config?.projectType ?? null,
+    configPath: hasConfig ? configPath : null,
+  }
+}

package/scripts/ensure-wphs-workspace.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Scaffold WoodsCLI `.wphs/` workspace + kit symlinks.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs'
+
+import { findProjectRoot, getKitRoot } from './project-root.mjs'
+import { wphsPaths, wphsWorkspaceSubdirs } from './wphs-paths.mjs'
+import { ensureDevKitShims } from './vite/ensure-dev-kit-shims.js'
+
+const WPHS_README = `# WoodsCLI workspace (.wphs/)
+
+Local state for **WoodsCLI** (\`@woodsportal/hubspot-kit\`). Not shipped to HubSpot.
+
+| Path | Purpose |
+|------|---------|
+| \`config/module-config.local.json\` | Live Content/Styles values (gitignored) |
+| \`config/module-config.example.json\` | Example generated from \`fields.json\` |
+| \`assets/branding/\` | Dev-tool uploaded images (gitignored) |
+| \`fixtures/\` | Optional preview / hubspot-data overrides |
+| \`cache/\` | CLI caches (gitignored) |
+| \`audit/baseline/\` | Build parity snapshots (gitignored) |
+| \`.kit-module-config\` | Symlink to kit dev-module-config |
+| \`.kit-bootstrap.tsx\` | Symlink to kit dev bootstrap |
+
+Run \`wp doctor\` to recreate missing folders.
+`
+
+/**
+ * @param {string} [projectRoot]
+ * @param {string} [kitRoot]
+ */
+export function ensureWphsWorkspace(projectRoot, kitRoot) {
+  const root = projectRoot ?? findProjectRoot()
+  const kit = kitRoot ?? getKitRoot()
+  const paths = wphsPaths(root)
+
+  for (const dir of wphsWorkspaceSubdirs(root)) {
+    mkdirSync(dir, { recursive: true })
+  }
+
+  if (!existsSync(paths.readmePath)) {
+    writeFileSync(paths.readmePath, WPHS_README)
+  }
+
+  ensureDevKitShims(root, kit)
+  return paths
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const paths = ensureWphsWorkspace()
+  console.log(`[wphs] workspace ready at ${paths.workspaceRoot}`)
+}

package/scripts/generate-cdn-manifest.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * Write dist/cdn/manifest.json after vendor + app builds.
+ */
+import { readdirSync, writeFileSync, statSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findProjectRoot } from './project-root.mjs'
+import { gzipSync } from 'node:zlib'
+import { readFileSync } from 'node:fs'
+import { resolveCdnBaseUrl, portalBuildId } from './resolve-cdn-base-url.mjs'
+
+const root = findProjectRoot()
+const cdnDir = resolve(root, 'dist/cdn')
+const buildId = portalBuildId()
+
+function fileMetrics(file) {
+  const path = resolve(cdnDir, file)
+  const raw = readFileSync(path)
+  return {
+    file,
+    rawBytes: raw.length,
+    gzipBytes: gzipSync(raw).length,
+  }
+}
+
+const jsFiles = readdirSync(cdnDir)
+  .filter((f) => f.endsWith('.js'))
+  .map((file) => {
+    const metrics = fileMetrics(file)
+    return {
+      ...metrics,
+      name: file.startsWith('vendor.') ? 'vendor' : file.startsWith('app.') ? 'app' : file,
+      order: file.startsWith('vendor.') ? 1 : file.startsWith('app.') ? 2 : 99,
+    }
+  })
+  .sort((a, b) => a.order - b.order)
+
+const cssFiles = readdirSync(cdnDir)
+  .filter((f) => f.endsWith('.css'))
+  .map((file) => {
+    const metrics = fileMetrics(file)
+    return {
+      ...metrics,
+      name: file.startsWith('app.') ? 'app' : file,
+      order: 1,
+    }
+  })
+
+const appCss = cssFiles.find((f) => f.name === 'app') ?? cssFiles[0]
+
+if (!jsFiles.some((f) => f.name === 'vendor') || !jsFiles.some((f) => f.name === 'app')) {
+  console.error('[cdn-manifest] expected vendor.*.js and app.*.js in dist/cdn/')
+  process.exit(1)
+}
+
+if (!appCss) {
+  console.error('[cdn-manifest] expected app.*.css in dist/cdn/ — component styles load from CDN')
+  process.exit(1)
+}
+
+const manifest = {
+  generatedAt: new Date().toISOString(),
+  buildId,
+  baseUrl: resolveCdnBaseUrl(),
+  publishMode: process.env.VITE_PORTAL_CDN_PUBLISH_MODE ?? 'jsdelivr',
+  scripts: jsFiles.map(({ name, file, order, rawBytes, gzipBytes }) => ({
+    name,
+    file,
+    order,
+    rawBytes,
+    gzipBytes,
+    url: `${resolveCdnBaseUrl()}/${file}`,
+  })),
+  styles: cssFiles.map(({ name, file, order, rawBytes, gzipBytes }) => ({
+    name,
+    file,
+    order,
+    rawBytes,
+    gzipBytes,
+    url: `${resolveCdnBaseUrl()}/${file}`,
+  })),
+}
+
+writeFileSync(resolve(cdnDir, 'manifest.json'), JSON.stringify(manifest, null, 2))
+console.log('[cdn-manifest] wrote dist/cdn/manifest.json')
+for (const s of manifest.scripts) {
+  console.log(`  ${s.file}: ${(s.rawBytes / 1024).toFixed(1)} KiB raw, ${(s.gzipBytes / 1024).toFixed(1)} KiB gzip`)
+}
+console.log(
+  `  ${appCss.file}: ${(appCss.rawBytes / 1024).toFixed(1)} KiB raw, ${(appCss.gzipBytes / 1024).toFixed(1)} KiB gzip (styles)`,
+)