@woodsportal/hubspot-kit 1.0.4 → 1.0.26

package/dist/exec-U2OJATR3.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  runCommand,
+  runNodeScript,
+  runNodeScriptLongRunning
+} from "./chunk-GTTIJVAR.js";
+export {
+  runCommand,
+  runNodeScript,
+  runNodeScriptLongRunning
+};
+//# sourceMappingURL=exec-U2OJATR3.js.map

package/dist/index.d.ts

@@ -52,13 +52,17 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
         app: z.ZodDefault<z.ZodString>;
         vendor: z.ZodDefault<z.ZodString>;
         hubspotBootstrap: z.ZodDefault<z.ZodString>;
+        /** Monolith production IIFE entry (wp build --hubspot-only) */
+        module: z.ZodDefault<z.ZodString>;
         localDev: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        module: string;
         app: string;
         vendor: string;
         hubspotBootstrap: string;
         localDev: string;
     }, {
+        module?: string | undefined;
         app?: string | undefined;
         vendor?: string | undefined;
         hubspotBootstrap?: string | undefined;
@@ -87,10 +91,19 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
         fieldsJson?: string | undefined;
         themeFieldsJson?: string | undefined;
     }>>;
+    scaffold: z.ZodOptional<z.ZodObject<{
+        /** hash = woodsportal-client-frontend (HubSpot CMS); browser = local clean URLs; none = single page */
+        router: z.ZodDefault<z.ZodEnum<["hash", "browser", "none"]>>;
+    }, "strip", z.ZodTypeAny, {
+        router: "none" | "hash" | "browser";
+    }, {
+        router?: "none" | "hash" | "browser" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     configVersion: number;
     projectType: "module-hybrid-cdn" | "module-monolith" | "theme-starter";
     entries: {
+        module: string;
         app: string;
         vendor: string;
         hubspotBootstrap: string;
@@ -121,6 +134,9 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
         srcDir: string;
         themeJson: string;
     } | undefined;
+    scaffold?: {
+        router: "none" | "hash" | "browser";
+    } | undefined;
 }, {
     projectType: "module-hybrid-cdn" | "module-monolith" | "theme-starter";
     module: {
@@ -130,6 +146,7 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
     };
     configVersion?: number | undefined;
     entries?: {
+        module?: string | undefined;
         app?: string | undefined;
         vendor?: string | undefined;
         hubspotBootstrap?: string | undefined;
@@ -155,6 +172,9 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
     env?: {
         tiers?: ("dev" | "stg" | "prod")[] | undefined;
     } | undefined;
+    scaffold?: {
+        router?: "none" | "hash" | "browser" | undefined;
+    } | undefined;
 }>;
 type WoodsPortalHsConfig = z.infer<typeof WoodsPortalHsSchema>;
 declare const DEFAULT_WOODSPORTAL_HS: WoodsPortalHsConfig;

package/dist/index.js

@@ -37,6 +37,8 @@ var WoodsPortalHsSchema = z.object({
     app: z.string().default("src/cdn/app-entry.ts"),
     vendor: z.string().default("src/cdn/vendor-entry.ts"),
     hubspotBootstrap: z.string().default("src/hubspot/bootstrap.ts"),
+    /** Monolith production IIFE entry (wp build --hubspot-only) */
+    module: z.string().default("src/hubspot/module-entry.tsx"),
     localDev: z.string().default("src/main.tsx")
   }).default({}),
   env: z.object({
@@ -47,7 +49,11 @@ var WoodsPortalHsSchema = z.object({
     adapter: z.string().default("./wphs.adapter.ts"),
     fieldsJson: z.string().default("public/fields.json"),
     themeFieldsJson: z.string().optional()
-  }).default({})
+  }).default({}),
+  scaffold: z.object({
+    /** hash = woodsportal-client-frontend (HubSpot CMS); browser = local clean URLs; none = single page */
+    router: z.enum(["hash", "browser", "none"]).default("hash")
+  }).optional()
 });
 var DEFAULT_WOODSPORTAL_HS = {
   configVersion: CONFIG_VERSION,
@@ -66,6 +72,7 @@ var DEFAULT_WOODSPORTAL_HS = {
     app: "src/cdn/app-entry.ts",
     vendor: "src/cdn/vendor-entry.ts",
     hubspotBootstrap: "src/hubspot/bootstrap.ts",
+    module: "src/hubspot/module-entry.tsx",
     localDev: "src/main.tsx"
   },
   env: {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schema/woodsportal-hs.ts","../src/lib/config.ts","../src/adapters/types.ts","../src/lib/generic-field-mapper.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const CONFIG_VERSION = 1\n\nexport const WPHS_WORKSPACE_DIR = '.wphs' as const\n\nexport const WoodsPortalHsSchema = z.object({\n  configVersion: z.number().int().default(CONFIG_VERSION),\n  projectType: z.enum(['module-hybrid-cdn', 'module-monolith', 'theme-starter']),\n  module: z.object({\n    name: z.string().min(1),\n    uploadPath: z.string().min(1),\n    outDir: z.string().default('dist/WoodsPortal.Module'),\n  }),\n  theme: z\n    .object({\n      name: z.string().min(1),\n      uploadPath: z.string().min(1),\n      srcDir: z.string().default('src/theme'),\n      themeJson: z.string().default('src/theme/theme.json'),\n    })\n    .optional(),\n  cdn: z\n    .object({\n      mode: z.enum(['jsdelivr', 'custom', 'local', 'none']).default('jsdelivr'),\n      buildIdFile: z.string().default('.portal-build-id'),\n      mirror: z.string().default('portal.cdn.json'),\n    })\n    .default({}),\n  entries: z\n    .object({\n      app: z.string().default('src/cdn/app-entry.ts'),\n      vendor: z.string().default('src/cdn/vendor-entry.ts'),\n      hubspotBootstrap: z.string().default('src/hubspot/bootstrap.ts'),\n      localDev: z.string().default('src/main.tsx'),\n    })\n    .default({}),\n  env: z\n    .object({\n      tiers: z.array(z.enum(['dev', 'stg', 'prod'])).default(['dev', 'stg', 'prod']),\n    })\n    .default({}),\n  dev: z\n    .object({\n      moduleConfigDir: z.literal(WPHS_WORKSPACE_DIR).default(WPHS_WORKSPACE_DIR),\n      adapter: z.string().default('./wphs.adapter.ts'),\n      fieldsJson: z.string().default('public/fields.json'),\n      themeFieldsJson: z.string().optional(),\n    })\n    .default({}),\n})\n\nexport type WoodsPortalHsConfig = z.infer<typeof WoodsPortalHsSchema>\n\nexport const DEFAULT_WOODSPORTAL_HS: WoodsPortalHsConfig = {\n  configVersion: CONFIG_VERSION,\n  projectType: 'module-hybrid-cdn',\n  module: {\n    name: 'woodsportal-module',\n    uploadPath: 'dw-modules/woodsportal-module.module',\n    outDir: 'dist/WoodsPortal.Module',\n  },\n  cdn: {\n    mode: 'jsdelivr',\n    buildIdFile: '.portal-build-id',\n    mirror: 'portal.cdn.json',\n  },\n  entries: {\n    app: 'src/cdn/app-entry.ts',\n    vendor: 'src/cdn/vendor-entry.ts',\n    hubspotBootstrap: 'src/hubspot/bootstrap.ts',\n    localDev: 'src/main.tsx',\n  },\n  env: {\n    tiers: ['dev', 'stg', 'prod'],\n  },\n  dev: {\n    moduleConfigDir: WPHS_WORKSPACE_DIR,\n    adapter: './wphs.adapter.ts',\n    fieldsJson: 'public/fields.json',\n  },\n}\n\nexport function isModuleProject(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'module-hybrid-cdn' || config.projectType === 'module-monolith'\n}\n\nexport function isThemeProject(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'theme-starter'\n}\n\nexport function usesCdnPipeline(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'module-hybrid-cdn' && config.cdn.mode !== 'none'\n}\n","import { readFileSync } from 'node:fs'\n\nimport {\n  resolveProjectConfig,\n  WOODSCLI_CONFIG_FILE,\n} from './config-files.js'\nimport { WoodsPortalHsSchema, type WoodsPortalHsConfig } from '../schema/woodsportal-hs.js'\nimport { WpHsError, ExitCode } from './errors.js'\nimport { findProjectRoot } from './paths.js'\n\nexport type LoadedProjectConfig = {\n  root: string\n  config: WoodsPortalHsConfig\n  configPath: string\n  configFileName: string\n}\n\nexport function loadConfig(projectRoot?: string): LoadedProjectConfig {\n  const root = projectRoot ?? findProjectRoot()\n  const resolved = resolveProjectConfig(root)\n\n  if (!resolved) {\n    throw new WpHsError(`Missing ${WOODSCLI_CONFIG_FILE}`, {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp init or wp adopt. Legacy woodsportal.hs.json → run wp migrate --yes.',\n    })\n  }\n\n  let raw: unknown\n  try {\n    raw = JSON.parse(readFileSync(resolved.path, 'utf8'))\n  } catch (cause) {\n    throw new WpHsError(`Invalid JSON in ${resolved.fileName}`, {\n      exitCode: ExitCode.USER_ERROR,\n      cause,\n    })\n  }\n\n  const parsed = WoodsPortalHsSchema.safeParse(raw)\n  if (!parsed.success) {\n    throw new WpHsError(`${resolved.fileName} validation failed: ${parsed.error.message}`, {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp config validate for details.',\n    })\n  }\n\n  return {\n    root,\n    config: parsed.data,\n    configPath: resolved.path,\n    configFileName: resolved.fileName,\n  }\n}\n\nexport function validateConfigFile(projectRoot?: string): {\n  valid: boolean\n  errors: string[]\n  config?: WoodsPortalHsConfig\n} {\n  try {\n    const { config } = loadConfig(projectRoot)\n    return { valid: true, errors: [], config }\n  } catch (error) {\n    if (error instanceof WpHsError) {\n      return { valid: false, errors: [error.message] }\n    }\n    return { valid: false, errors: [String(error)] }\n  }\n}\n","/** Must match dev-module-config/schema/types.ts */\nexport const MODULE_CONFIG_CHANGED = 'woodsportal:module-config-changed'\n\nexport type ModuleConfigBuiltState = {\n  built: Record<string, unknown>\n}\n\n/** WoodsCLI consumer hook — mount app + sync module-config live data. */\nexport interface HubSpotKitAdapter {\n  syncLiveData(built: Record<string, unknown>): void\n  getDefaultHubSpotData?(): Record<string, unknown>\n  mountDevApp?(root: unknown): void | Promise<void>\n}\n\nexport function bindAdapterToModuleConfig(adapter: HubSpotKitAdapter): void {\n  if (typeof globalThis.window === 'undefined') return\n  globalThis.window.addEventListener(MODULE_CONFIG_CHANGED, (event: Event) => {\n    const detail = (event as CustomEvent<ModuleConfigBuiltState>).detail\n    adapter.syncLiveData(detail.built)\n  })\n}\n\nexport function syncAdapterFromModuleState(\n  adapter: HubSpotKitAdapter,\n  state: ModuleConfigBuiltState,\n): void {\n  adapter.syncLiveData(state.built)\n}\n\n/** Minimal adapter for greenfield templates without a full app. */\nexport const defaultHubSpotKitAdapter: HubSpotKitAdapter = {\n  syncLiveData(built) {\n    const w = globalThis as typeof globalThis & { __WPHS_DATA__?: Record<string, unknown> }\n    w.__WPHS_DATA__ = built\n  },\n  getDefaultHubSpotData() {\n    return {}\n  },\n}\n","/**\n * Generic fields.json → flat runtime object (WoodsCLI default transform).\n */\nexport type GenericFieldDefinition = {\n  name: string\n  type: string\n  default?: unknown\n  children?: GenericFieldDefinition[]\n}\n\nexport type GenericFieldValues = Record<string, unknown>\n\nfunction flattenField(\n  field: GenericFieldDefinition,\n  values: GenericFieldValues,\n  out: Record<string, unknown>,\n): void {\n  const key = field.name\n  const value = values[key]\n\n  if (field.type === 'group' && field.children && value && typeof value === 'object') {\n    const groupValues = value as GenericFieldValues\n    for (const child of field.children) {\n      flattenField(child, groupValues, out)\n    }\n    return\n  }\n\n  if (field.type === 'repeater' && Array.isArray(value)) {\n    out[key] = value\n    return\n  }\n\n  out[key] = value ?? field.default ?? null\n}\n\nexport function mapFieldsToRuntime(\n  schema: GenericFieldDefinition[],\n  values: GenericFieldValues,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const field of schema) {\n    flattenField(field, values, out)\n  }\n  return out\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/schema/woodsportal-hs.ts","../src/lib/config.ts","../src/adapters/types.ts","../src/lib/generic-field-mapper.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const CONFIG_VERSION = 1\n\nexport const WPHS_WORKSPACE_DIR = '.wphs' as const\n\nexport const WoodsPortalHsSchema = z.object({\n  configVersion: z.number().int().default(CONFIG_VERSION),\n  projectType: z.enum(['module-hybrid-cdn', 'module-monolith', 'theme-starter']),\n  module: z.object({\n    name: z.string().min(1),\n    uploadPath: z.string().min(1),\n    outDir: z.string().default('dist/WoodsPortal.Module'),\n  }),\n  theme: z\n    .object({\n      name: z.string().min(1),\n      uploadPath: z.string().min(1),\n      srcDir: z.string().default('src/theme'),\n      themeJson: z.string().default('src/theme/theme.json'),\n    })\n    .optional(),\n  cdn: z\n    .object({\n      mode: z.enum(['jsdelivr', 'custom', 'local', 'none']).default('jsdelivr'),\n      buildIdFile: z.string().default('.portal-build-id'),\n      mirror: z.string().default('portal.cdn.json'),\n    })\n    .default({}),\n  entries: z\n    .object({\n      app: z.string().default('src/cdn/app-entry.ts'),\n      vendor: z.string().default('src/cdn/vendor-entry.ts'),\n      hubspotBootstrap: z.string().default('src/hubspot/bootstrap.ts'),\n      /** Monolith production IIFE entry (wp build --hubspot-only) */\n      module: z.string().default('src/hubspot/module-entry.tsx'),\n      localDev: z.string().default('src/main.tsx'),\n    })\n    .default({}),\n  env: z\n    .object({\n      tiers: z.array(z.enum(['dev', 'stg', 'prod'])).default(['dev', 'stg', 'prod']),\n    })\n    .default({}),\n  dev: z\n    .object({\n      moduleConfigDir: z.literal(WPHS_WORKSPACE_DIR).default(WPHS_WORKSPACE_DIR),\n      adapter: z.string().default('./wphs.adapter.ts'),\n      fieldsJson: z.string().default('public/fields.json'),\n      themeFieldsJson: z.string().optional(),\n    })\n    .default({}),\n  scaffold: z\n    .object({\n      /** hash = woodsportal-client-frontend (HubSpot CMS); browser = local clean URLs; none = single page */\n      router: z.enum(['hash', 'browser', 'none']).default('hash'),\n    })\n    .optional(),\n})\n\nexport type WoodsPortalHsConfig = z.infer<typeof WoodsPortalHsSchema>\n\nexport const DEFAULT_WOODSPORTAL_HS: WoodsPortalHsConfig = {\n  configVersion: CONFIG_VERSION,\n  projectType: 'module-hybrid-cdn',\n  module: {\n    name: 'woodsportal-module',\n    uploadPath: 'dw-modules/woodsportal-module.module',\n    outDir: 'dist/WoodsPortal.Module',\n  },\n  cdn: {\n    mode: 'jsdelivr',\n    buildIdFile: '.portal-build-id',\n    mirror: 'portal.cdn.json',\n  },\n  entries: {\n    app: 'src/cdn/app-entry.ts',\n    vendor: 'src/cdn/vendor-entry.ts',\n    hubspotBootstrap: 'src/hubspot/bootstrap.ts',\n    module: 'src/hubspot/module-entry.tsx',\n    localDev: 'src/main.tsx',\n  },\n  env: {\n    tiers: ['dev', 'stg', 'prod'],\n  },\n  dev: {\n    moduleConfigDir: WPHS_WORKSPACE_DIR,\n    adapter: './wphs.adapter.ts',\n    fieldsJson: 'public/fields.json',\n  },\n}\n\nexport function isModuleProject(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'module-hybrid-cdn' || config.projectType === 'module-monolith'\n}\n\nexport function isThemeProject(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'theme-starter'\n}\n\nexport function usesCdnPipeline(config: WoodsPortalHsConfig): boolean {\n  return config.projectType === 'module-hybrid-cdn' && config.cdn.mode !== 'none'\n}\n","import { readFileSync } from 'node:fs'\n\nimport {\n  resolveProjectConfig,\n  WOODSCLI_CONFIG_FILE,\n} from './config-files.js'\nimport { WoodsPortalHsSchema, type WoodsPortalHsConfig } from '../schema/woodsportal-hs.js'\nimport { WpHsError, ExitCode } from './errors.js'\nimport { findProjectRoot } from './paths.js'\n\nexport type LoadedProjectConfig = {\n  root: string\n  config: WoodsPortalHsConfig\n  configPath: string\n  configFileName: string\n}\n\nexport function loadConfig(projectRoot?: string): LoadedProjectConfig {\n  const root = projectRoot ?? findProjectRoot()\n  const resolved = resolveProjectConfig(root)\n\n  if (!resolved) {\n    throw new WpHsError(`Missing ${WOODSCLI_CONFIG_FILE}`, {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp init or wp adopt. Legacy woodsportal.hs.json → run wp migrate --yes.',\n    })\n  }\n\n  let raw: unknown\n  try {\n    raw = JSON.parse(readFileSync(resolved.path, 'utf8'))\n  } catch (cause) {\n    throw new WpHsError(`Invalid JSON in ${resolved.fileName}`, {\n      exitCode: ExitCode.USER_ERROR,\n      cause,\n    })\n  }\n\n  const parsed = WoodsPortalHsSchema.safeParse(raw)\n  if (!parsed.success) {\n    throw new WpHsError(`${resolved.fileName} validation failed: ${parsed.error.message}`, {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp config validate for details.',\n    })\n  }\n\n  return {\n    root,\n    config: parsed.data,\n    configPath: resolved.path,\n    configFileName: resolved.fileName,\n  }\n}\n\nexport function validateConfigFile(projectRoot?: string): {\n  valid: boolean\n  errors: string[]\n  config?: WoodsPortalHsConfig\n} {\n  try {\n    const { config } = loadConfig(projectRoot)\n    return { valid: true, errors: [], config }\n  } catch (error) {\n    if (error instanceof WpHsError) {\n      return { valid: false, errors: [error.message] }\n    }\n    return { valid: false, errors: [String(error)] }\n  }\n}\n","/** Must match dev-module-config/schema/types.ts */\nexport const MODULE_CONFIG_CHANGED = 'woodsportal:module-config-changed'\n\nexport type ModuleConfigBuiltState = {\n  built: Record<string, unknown>\n}\n\n/** WoodsCLI consumer hook — mount app + sync module-config live data. */\nexport interface HubSpotKitAdapter {\n  syncLiveData(built: Record<string, unknown>): void\n  getDefaultHubSpotData?(): Record<string, unknown>\n  mountDevApp?(root: unknown): void | Promise<void>\n}\n\nexport function bindAdapterToModuleConfig(adapter: HubSpotKitAdapter): void {\n  if (typeof globalThis.window === 'undefined') return\n  globalThis.window.addEventListener(MODULE_CONFIG_CHANGED, (event: Event) => {\n    const detail = (event as CustomEvent<ModuleConfigBuiltState>).detail\n    adapter.syncLiveData(detail.built)\n  })\n}\n\nexport function syncAdapterFromModuleState(\n  adapter: HubSpotKitAdapter,\n  state: ModuleConfigBuiltState,\n): void {\n  adapter.syncLiveData(state.built)\n}\n\n/** Minimal adapter for greenfield templates without a full app. */\nexport const defaultHubSpotKitAdapter: HubSpotKitAdapter = {\n  syncLiveData(built) {\n    const w = globalThis as typeof globalThis & { __WPHS_DATA__?: Record<string, unknown> }\n    w.__WPHS_DATA__ = built\n  },\n  getDefaultHubSpotData() {\n    return {}\n  },\n}\n","/**\n * Generic fields.json → flat runtime object (WoodsCLI default transform).\n */\nexport type GenericFieldDefinition = {\n  name: string\n  type: string\n  default?: unknown\n  children?: GenericFieldDefinition[]\n}\n\nexport type GenericFieldValues = Record<string, unknown>\n\nfunction flattenField(\n  field: GenericFieldDefinition,\n  values: GenericFieldValues,\n  out: Record<string, unknown>,\n): void {\n  const key = field.name\n  const value = values[key]\n\n  if (field.type === 'group' && field.children && value && typeof value === 'object') {\n    const groupValues = value as GenericFieldValues\n    for (const child of field.children) {\n      flattenField(child, groupValues, out)\n    }\n    return\n  }\n\n  if (field.type === 'repeater' && Array.isArray(value)) {\n    out[key] = value\n    return\n  }\n\n  out[key] = value ?? field.default ?? null\n}\n\nexport function mapFieldsToRuntime(\n  schema: GenericFieldDefinition[],\n  values: GenericFieldValues,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const field of schema) {\n    flattenField(field, values, out)\n  }\n  return out\n}\n"],"mappings":"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","names":[]}

package/examples/greenfield/module-hybrid-cdn/README.md

@@ -1,9 +1,46 @@
-# HubSpot portal module (hybrid CDN)
+# Getting started
 
-Scaffolded by `wp init --template module-hybrid-cdn`.
+This project was scaffolded with **WoodsCLI** (`@woodsportal/hubspot-kit`).
+
+## Daily dev
 
 ```bash
-npm install
+yarn install
 wp doctor
 wp dev
 ```
+
+Open the local URL, then **Ctrl+Shift+Z** (Mac **⌃⇧Z**) to edit module fields. Click **Apply changes** to refresh the starter preview.
+
+## `src/` layout
+
+| Path | Purpose |
+|------|---------|
+| `main.tsx` | Dev entry — loads styles and `mountDevPreview()` |
+| `portal/` | Dev vs production mount (`mount-dev-preview`, `mount-portal`) |
+| `routes/` | TanStack file routes — keep thin; import from `features/` |
+| `features/starter/` | Demo home + developer guide (replace with your app) |
+| `components/` | Shared layout and UI |
+| `integrations/` | Router and third-party wiring |
+| `cdn/` | Production vendor + app chunks (`wp build` / `wp deploy`) |
+| `hubspot/` | HubSpot bootstrap, types, and dev fixtures |
+| `config/` | Route constants and app config |
+| `assets/css/` | Tailwind entry for local dev |
+
+Kit runtime expects `src/defaultData.ts` (re-exports `hubspot/default-data.ts`).
+
+## Docs (in the kit package)
+
+After `npm install`, see:
+
+- `node_modules/@woodsportal/hubspot-kit/docs/CLI-REFERENCE.md`
+- `node_modules/@woodsportal/hubspot-kit/docs/MODULES.md`
+- `node_modules/@woodsportal/hubspot-kit/docs/HUBSPOT-CLI-SETUP.md`
+
+## HubSpot upload
+
+```bash
+cp hubspot.config.yml.example hubspot.config.yml
+# add portal + personal access key
+wp upload
+```

package/examples/greenfield/module-hybrid-cdn/public/fields.json

@@ -1 +1,44 @@
-[{"name":"title","label":"Title","type":"text","default":"WoodsCLI module"}]
+[
+  {
+    "name": "title",
+    "label": "Portal title",
+    "type": "text",
+    "tab": "CONTENT",
+    "default": "My HubSpot Portal"
+  },
+  {
+    "name": "tagline",
+    "label": "Tagline",
+    "type": "text",
+    "tab": "CONTENT",
+    "help_text": "Subtitle shown under the hero title in the local dev preview.",
+    "default": "Customize this preview with Ctrl+Shift+Z, then replace StarterPage with your portal app."
+  },
+  {
+    "name": "show_feature_cards",
+    "label": "Show feature cards",
+    "type": "boolean",
+    "display": "toggle",
+    "tab": "CONTENT",
+    "default": true
+  },
+  {
+    "name": "accent_color",
+    "label": "Accent color",
+    "type": "color",
+    "tab": "STYLE",
+    "default": { "color": "#0091ae", "opacity": 100 }
+  },
+  {
+    "name": "hero_style",
+    "label": "Hero style",
+    "type": "choice",
+    "tab": "STYLE",
+    "choices": [
+      ["gradient", "Gradient"],
+      ["minimal", "Minimal"],
+      ["bold", "Bold"]
+    ],
+    "default": "gradient"
+  }
+]

package/examples/greenfield/module-hybrid-cdn/src/app.tsx

@@ -0,0 +1,8 @@
+import { RouterProvider } from '@tanstack/react-router'
+
+import { router } from '@/integrations/tanstack-router/router'
+
+/** Root app shell — same pattern as woodsportal-client-frontend `App`. */
+export function App() {
+  return <RouterProvider router={router} />
+}

package/examples/greenfield/module-hybrid-cdn/src/assets/css/main.dev.css

@@ -1,3 +1,8 @@
 @import 'tailwindcss';
 
-@source '../../.wphs/**/*.{js,jsx,ts,tsx}';
+/* Kit dev-module-config — paths relative to this file (src/assets/css/) */
+@source '../../../.wphs/.kit-module-config/**/*.{ts,tsx}';
+@source '../../../.wphs/.kit-bootstrap.tsx';
+@source '../../../.wphs/.kit-bootstrap-greenfield.tsx';
+@source '../../../src/**/*.{ts,tsx}';
+@source '../../../node_modules/@woodsportal/hubspot-kit/src/dev-module-config/**/*.{ts,tsx}';

package/examples/greenfield/module-hybrid-cdn/src/cdn/app-entry.ts

@@ -0,0 +1,32 @@
+/**
+ * CDN application chunk — mounts after vendor.js (HubSpot require_js order).
+ */
+import { mountPortal } from '@/portal/mount-portal'
+
+declare const __PORTAL_BUILD_ID__: string | undefined
+
+declare global {
+  interface Window {
+    WoodsPortal?: {
+      mount: typeof mountPortal
+      version: string
+    }
+  }
+}
+
+const buildId =
+  typeof __PORTAL_BUILD_ID__ !== 'undefined' ? String(__PORTAL_BUILD_ID__) : 'dev'
+
+window.WoodsPortal = {
+  mount: mountPortal,
+  version: buildId,
+}
+
+async function autoMount() {
+  if (!document.getElementById('app')) {
+    return
+  }
+  await mountPortal()
+}
+
+void autoMount()

package/examples/greenfield/module-hybrid-cdn/src/cdn/vendor-entry.ts

@@ -0,0 +1,28 @@
+/**
+ * CDN vendor chunk — React + ReactDOM on `window` for the app IIFE externals.
+ */
+import React from 'react'
+import * as ReactDOM from 'react-dom'
+import * as ReactDOMClient from 'react-dom/client'
+import * as jsxRuntime from 'react/jsx-runtime'
+import * as jsxDevRuntime from 'react/jsx-dev-runtime'
+
+declare global {
+  interface Window {
+    WoodsPortalVendor?: {
+      React: typeof React
+      ReactDOM: typeof ReactDOM
+      ReactDOMClient: typeof ReactDOMClient
+      jsxRuntime: typeof jsxRuntime
+      jsxDevRuntime: typeof jsxDevRuntime
+    }
+  }
+}
+
+window.WoodsPortalVendor = {
+  React,
+  ReactDOM,
+  ReactDOMClient,
+  jsxRuntime,
+  jsxDevRuntime,
+}

package/examples/greenfield/module-hybrid-cdn/src/components/layout/section-card.tsx

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react'
+
+export function SectionCard({
+  title,
+  children,
+  className = '',
+}: {
+  title: string
+  children: ReactNode
+  className?: string
+}) {
+  return (
+    <section
+      className={`rounded-lg border border-[#cbd6e2] bg-white p-6 shadow-sm ${className}`}
+    >
+      <h2 className="text-base font-semibold text-[#33475b]">{title}</h2>
+      <div className="mt-4">{children}</div>
+    </section>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/components/layout/starter-nav.tsx

@@ -0,0 +1,28 @@
+import { Link } from '@tanstack/react-router'
+
+import { ROUTES } from '@/config/routes'
+
+export function StarterNav() {
+  return (
+    <header className="border-b border-[#cbd6e2] bg-white/90 backdrop-blur">
+      <div className="mx-auto flex max-w-4xl items-center justify-between gap-4 px-6 py-3 sm:px-10">
+        <span className="text-sm font-semibold text-[#0091ae]">WoodsCLI starter</span>
+        <nav className="flex gap-4 text-sm font-medium">
+          <Link
+            to={ROUTES.home}
+            className="text-[#516f90] hover:text-[#0091ae] [&.active]:text-[#0091ae]"
+            activeOptions={{ exact: true }}
+          >
+            Home
+          </Link>
+          <Link
+            to={ROUTES.guide}
+            className="text-[#516f90] hover:text-[#0091ae] [&.active]:text-[#0091ae]"
+          >
+            Developer guide
+          </Link>
+        </nav>
+      </div>
+    </header>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/components/layout/starter-shell.tsx

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react'
+
+import { StarterNav } from './starter-nav'
+
+export function StarterShell({
+  children,
+  showNav = true,
+}: {
+  children: ReactNode
+  showNav?: boolean
+}) {
+  return (
+    <div className="min-h-screen bg-[#eaf0f6] text-[#33475b]">
+      {showNav ? <StarterNav /> : null}
+      {children}
+    </div>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/config/router.ts

@@ -0,0 +1,4 @@
+/** Router history — set by `wp init`. Hash matches woodsportal-client-frontend (HubSpot CMS embeds). */
+export type RouterHistoryMode = 'hash' | 'browser'
+
+export const ROUTER_HISTORY: RouterHistoryMode = 'hash'

package/examples/greenfield/module-hybrid-cdn/src/config/routes.ts

@@ -0,0 +1,5 @@
+/** Route paths — keep in sync with `src/routes/` file routes. */
+export const ROUTES = {
+  home: '/',
+  guide: '/guide',
+} as const

package/examples/greenfield/module-hybrid-cdn/src/defaultData.ts

@@ -1,7 +1,2 @@
-/** Local dev fixtures for module-config runtime (greenfield wp init). */
-export const defaultData = {
-  dataSourceSet: [],
-  hubId: 'dev',
-  userData: {},
-  objectList: [] as unknown[],
-}
+/** Kit runtime imports `@/defaultData` — re-export from the hubspot slice. */
+export { devDefaultData as defaultData } from './hubspot/default-data'

package/examples/greenfield/module-hybrid-cdn/src/features/starter/components/starter-guide-page.tsx

@@ -0,0 +1,93 @@
+import { SectionCard } from '@/components/layout/section-card'
+
+import {
+  DEV_WORKFLOW,
+  PROJECT_LAYOUT,
+  WOODSCLI_ABOUT,
+  WOODSCLI_COMMANDS,
+} from '../content/woodscli-guide-content'
+
+export function StarterGuidePage() {
+  return (
+    <main className="mx-auto max-w-4xl space-y-8 px-6 py-10 sm:px-10">
+      <div>
+        <h1 className="text-2xl font-semibold tracking-tight">Developer guide</h1>
+        <p className="mt-2 text-sm leading-relaxed text-[#516f90]">
+          Commands, project layout, and workflow for this WoodsCLI module. Routes live in{' '}
+          <code className="font-mono text-xs">src/routes/</code> and delegate to{' '}
+          <code className="font-mono text-xs">src/features/</code>.
+        </p>
+      </div>
+
+      <SectionCard title="About WoodsCLI">
+        <p className="text-sm leading-relaxed text-[#516f90]">{WOODSCLI_ABOUT.tagline}</p>
+        <p className="mt-3 text-sm leading-relaxed text-[#516f90]">{WOODSCLI_ABOUT.docsHint}</p>
+      </SectionCard>
+
+      <SectionCard title="Essential commands">
+        <ul className="divide-y divide-[#eaf0f6]">
+          {WOODSCLI_COMMANDS.map(({ cmd, desc }) => (
+            <li key={cmd} className="flex flex-col gap-1 py-3 first:pt-0 last:pb-0 sm:flex-row sm:gap-4">
+              <code className="shrink-0 rounded bg-[#eaf0f6] px-2 py-1 font-mono text-xs text-[#0091ae]">
+                {cmd}
+              </code>
+              <span className="text-sm leading-relaxed text-[#516f90]">{desc}</span>
+            </li>
+          ))}
+        </ul>
+      </SectionCard>
+
+      <SectionCard title="Project layout">
+        <ul className="space-y-3">
+          {PROJECT_LAYOUT.map(({ path, note }) => (
+            <li key={path} className="text-sm leading-relaxed">
+              <code className="rounded bg-[#eaf0f6] px-1.5 py-0.5 font-mono text-xs text-[#33475b]">
+                {path}
+              </code>
+              <span className="mt-1 block text-[#516f90] sm:mt-0 sm:inline sm:before:content-['—_']">
+                {note}
+              </span>
+            </li>
+          ))}
+        </ul>
+      </SectionCard>
+
+      <SectionCard title="Developer workflow">
+        <ol className="space-y-4">
+          {DEV_WORKFLOW.map(({ title: stepTitle, body }) => (
+            <li key={stepTitle}>
+              <h3 className="text-sm font-medium text-[#33475b]">{stepTitle}</h3>
+              <p className="mt-1 text-sm leading-relaxed text-[#516f90]">{body}</p>
+            </li>
+          ))}
+        </ol>
+      </SectionCard>
+
+      <SectionCard title="Routing">
+        <p className="text-sm leading-relaxed text-[#516f90]">
+          This starter uses the same TanStack Router setup as{' '}
+          <code className="font-mono text-xs">woodsportal-client-frontend</code>: file routes under{' '}
+          <code className="font-mono text-xs">src/routes/</code>,{' '}
+          <code className="font-mono text-xs">src/app.tsx</code> with{' '}
+          <code className="font-mono text-xs">RouterProvider</code>, and{' '}
+          <strong>hash history</strong> by default (
+          <code className="font-mono text-xs">src/config/router.ts</code>) so routes work inside
+          HubSpot CMS embeds. Run <code className="font-mono text-xs">wp init</code> again on a new
+          folder to choose browser history or no router. Add{' '}
+          <code className="font-mono text-xs">src/routes/about.tsx</code> and restart{' '}
+          <code className="font-mono text-xs">wp dev</code> to regenerate{' '}
+          <code className="font-mono text-xs">routeTree.gen.ts</code>.
+        </p>
+      </SectionCard>
+
+      <SectionCard title="Customize this preview">
+        <p className="text-sm leading-relaxed text-[#516f90]">
+          Edit <code className="font-mono text-xs">public/fields.json</code> to add module fields,
+          then adjust <code className="font-mono text-xs">src/features/starter/</code> to bind them.
+          Replace the starter feature with your own under{' '}
+          <code className="font-mono text-xs">src/features/</code> when you outgrow the demo.
+        </p>
+      </SectionCard>
+    </main>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/features/starter/components/starter-home-page.tsx

@@ -0,0 +1,21 @@
+import { Link } from '@tanstack/react-router'
+
+import { ROUTES } from '@/config/routes'
+
+import { StarterHome } from './starter-home'
+
+export function StarterHomePage() {
+  return (
+    <>
+      <StarterHome />
+      <div className="mx-auto max-w-4xl px-6 pb-10 sm:px-10">
+        <Link
+          to={ROUTES.guide}
+          className="inline-flex items-center rounded-md bg-[#0091ae] px-4 py-2 text-sm font-semibold text-white shadow-sm hover:bg-[#007a8c]"
+        >
+          Open developer guide →
+        </Link>
+      </div>
+    </>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/features/starter/components/starter-home.tsx

@@ -0,0 +1,52 @@
+import { useStarterPreview } from '../hooks/use-starter-preview'
+import { STARTER_FEATURES, WOODSCLI_ABOUT } from '../content/woodscli-guide-content'
+
+function heroClass(style: ReturnType<typeof useStarterPreview>['heroStyle']): string {
+  if (style === 'minimal') {
+    return 'bg-[var(--mc-bg-shell,#f5f8fa)] text-[var(--mc-text,#33475b)] border-b border-[var(--mc-border,#cbd6e2)]'
+  }
+  if (style === 'bold') {
+    return 'bg-[#1c1c1f] text-white'
+  }
+  return 'bg-gradient-to-br from-[var(--starter-accent,#0091ae)] to-[#ff7a59] text-white'
+}
+
+export function StarterHome() {
+  const { title, tagline, showFeatureCards, accentColor, heroStyle } = useStarterPreview()
+
+  return (
+    <>
+      <div style={{ ['--starter-accent' as string]: accentColor }}>
+        <section className={`px-6 py-14 sm:px-10 sm:py-16 ${heroClass(heroStyle)}`}>
+          <div className="mx-auto max-w-4xl">
+            <p className="mb-2 text-xs font-semibold uppercase tracking-widest opacity-80">
+              {WOODSCLI_ABOUT.package} · local dev
+            </p>
+            <h1 className="text-3xl font-semibold tracking-tight sm:text-4xl">{title}</h1>
+            <p className="mt-4 max-w-2xl text-base leading-relaxed opacity-90 sm:text-lg">{tagline}</p>
+            <p className="mt-6 text-sm opacity-75">
+              Module config overlay:{' '}
+              <kbd className="rounded bg-black/10 px-1.5 py-0.5 font-mono text-xs">Ctrl+Shift+Z</kbd>
+              {' · '}
+              Mac: <kbd className="rounded bg-black/10 px-1.5 py-0.5 font-mono text-xs">⌃⇧Z</kbd>
+            </p>
+          </div>
+        </section>
+      </div>
+
+      {showFeatureCards ? (
+        <div className="mx-auto grid max-w-4xl gap-4 px-6 py-10 sm:grid-cols-3 sm:px-10">
+          {STARTER_FEATURES.map((feature) => (
+            <article
+              key={feature.title}
+              className="rounded-lg border border-[#cbd6e2] bg-white p-5 shadow-sm"
+            >
+              <h2 className="text-sm font-semibold text-[#0091ae]">{feature.title}</h2>
+              <p className="mt-2 text-sm leading-relaxed text-[#516f90]">{feature.body}</p>
+            </article>
+          ))}
+        </div>
+      ) : null}
+    </>
+  )
+}

package/examples/greenfield/module-hybrid-cdn/src/features/starter/components/starter-single-page.tsx

@@ -0,0 +1,17 @@
+import { StarterShell } from '@/components/layout/starter-shell'
+
+import { StarterGuidePage } from './starter-guide-page'
+import { StarterHome } from './starter-home'
+
+/** Single-page starter when `wp init --router none` (no TanStack Router). */
+export function StarterSinglePage() {
+  return (
+    <StarterShell showNav={false}>
+      <StarterHome />
+      <div className="mx-auto max-w-4xl px-6 sm:px-10">
+        <hr className="my-10 border-[#cbd6e2]" />
+      </div>
+      <StarterGuidePage />
+    </StarterShell>
+  )
+}