@woodsportal/hubspot-kit 1.0.31 → 1.0.34

package/dist/index.js

@@ -30,7 +30,7 @@ var WoodsPortalHsSchema = z.object({
   }).optional(),
   cdn: z.object({
     mode: z.enum(["jsdelivr", "custom", "local", "none"]).default("jsdelivr"),
-    buildIdFile: z.string().default(".portal-build-id"),
+    buildIdFile: z.string().default(".module-build-id"),
     mirror: z.string().default("portal.cdn.json")
   }).default({}),
   entries: z.object({
@@ -65,7 +65,7 @@ var DEFAULT_WOODSPORTAL_HS = {
   },
   cdn: {
     mode: "jsdelivr",
-    buildIdFile: ".portal-build-id",
+    buildIdFile: ".module-build-id",
     mirror: "portal.cdn.json"
   },
   entries: {

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      /** 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. 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('.module-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: '.module-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. 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/fixtures/adopted-module-hybrid/woodscli.json

@@ -2,6 +2,6 @@
   "configVersion": 1,
   "projectType": "module-hybrid-cdn",
   "module": {"name": "demo", "uploadPath": "dw-modules/demo.module", "outDir": "dist/Demo.Module"},
-  "cdn": {"mode": "jsdelivr", "buildIdFile": ".portal-build-id", "mirror": "portal.cdn.json"},
+  "cdn": {"mode": "jsdelivr", "buildIdFile": ".module-build-id", "mirror": "portal.cdn.json"},
   "dev": {"moduleConfigDir": ".wphs", "adapter": "./wphs.adapter.ts", "fieldsJson": "public/fields.json"}
 }

package/examples/fixtures/adopted-module-monolith/woodscli.json

@@ -2,6 +2,6 @@
   "configVersion": 1,
   "projectType": "module-monolith",
   "module": {"name": "demo", "uploadPath": "dw-modules/demo.module", "outDir": "dist/Demo.Module"},
-  "cdn": {"mode": "none", "buildIdFile": ".portal-build-id", "mirror": "portal.cdn.json"},
+  "cdn": {"mode": "none", "buildIdFile": ".module-build-id", "mirror": "portal.cdn.json"},
   "dev": {"moduleConfigDir": ".wphs", "fieldsJson": "public/fields.json"}
 }

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

@@ -24,26 +24,32 @@
     "default": true
   },
   {
-    "name": "accent_color",
-    "label": "Accent color",
-    "type": "color",
+    "type": "group",
+    "name": "styles",
+    "label": "Styles",
     "tab": "STYLE",
-    "default": {
-      "color": "#0091ae",
-      "opacity": 100
-    }
-  },
-  {
-    "name": "hero_style",
-    "label": "Hero style",
-    "type": "choice",
-    "display": "select",
-    "tab": "STYLE",
-    "choices": [
-      ["gradient", "Gradient"],
-      ["minimal", "Minimal"],
-      ["bold", "Bold"]
-    ],
-    "default": "gradient"
+    "children": [
+      {
+        "name": "accent_color",
+        "label": "Accent color",
+        "type": "color",
+        "default": {
+          "color": "#0091ae",
+          "opacity": 100
+        }
+      },
+      {
+        "name": "hero_style",
+        "label": "Hero style",
+        "type": "choice",
+        "display": "select",
+        "choices": [
+          ["gradient", "Gradient"],
+          ["minimal", "Minimal"],
+          ["bold", "Bold"]
+        ],
+        "default": "gradient"
+      }
+    ]
   }
 ]

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

@@ -0,0 +1,9 @@
+{
+  "label": "WoodsPortal hybrid module",
+  "css_assets": [],
+  "external_js": [],
+  "global": false,
+  "host_template_types": ["PAGE", "BLOG_POST", "BLOG_LISTING"],
+  "content_types": ["SITE_PAGE", "LANDING_PAGE", "BLOG_POST", "BLOG_LISTING"],
+  "is_available_for_new_content": true
+}

package/examples/greenfield/module-hybrid-cdn/public/module.html

@@ -6,8 +6,8 @@
     title: {{ module.title|tojson }},
     tagline: {{ module.tagline|tojson }},
     show_feature_cards: {{ module.show_feature_cards|lower }},
-    accent_color: {{ module.accent_color|tojson }},
-    hero_style: {{ module.hero_style|tojson }},
+    accent_color: {{ module.styles.accent_color|tojson }},
+    hero_style: {{ module.styles.hero_style|tojson }},
     assetBaseUrl: "__PORTAL_CDN_BASE__",
     buildId: "__PORTAL_BUILD_ID__",
     isInEditor: {{ in_cms_editor|lower }}
@@ -16,8 +16,7 @@
 {% set portal_cdn_base = "__PORTAL_CDN_BASE__" %}
 {% set portal_vendor_script = "__PORTAL_VENDOR_FILE__" %}
 {% set portal_app_script = "__PORTAL_APP_FILE__" %}
-{% set portal_app_css = "__PORTAL_APP_CSS_FILE__" %}
-{{ require_css(portal_cdn_base ~ '/' ~ portal_app_css, { position: 'footer' }) }}
+{# App styles ship in module.css (HubSpot editor cannot rely on external CDN CSS). #}
 {{ require_js(portal_cdn_base ~ '/' ~ portal_vendor_script, { position: 'footer', defer: true }) }}
 {{ require_js(portal_cdn_base ~ '/' ~ portal_app_script, { position: 'footer', defer: true }) }}
 <div id="app"></div>

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

@@ -0,0 +1,6 @@
+@import 'tailwindcss' prefix(dw);
+
+/* Prefixed utilities from tailwind-content.js (.temp) — must match prefix plugin on TSX */
+@source '../../../.temp/**/*.{js,jsx,ts,tsx}';
+@source '../../../.wphs/.kit-module-config/**/*.{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

@@ -1,9 +1,13 @@
 /**
  * CDN application chunk — mounts after vendor.js (HubSpot require_js order).
+ *
+ * Build extracts main.dev.css → app.{buildId}.css (linked from module.html).
+ * Runtime also injects that stylesheet when HubSpot preview skips require_css.
  */
 import '@/assets/css/main.dev.css'
 
 import { resolvePortalApiEndpoint } from '@/portal/api-endpoint'
+import { ensurePortalCdnStylesheet } from '@/portal/ensure-portal-cdn-stylesheet'
 import { mountPortal } from '@/portal/mount-portal'
 
 declare const __PORTAL_BUILD_ID__: string | undefined
@@ -31,6 +35,7 @@ async function autoMount() {
   if (!document.getElementById('app')) {
     return
   }
+  await ensurePortalCdnStylesheet()
   await mountPortal()
 }
 

package/examples/greenfield/module-hybrid-cdn/src/hubspot/bootstrap.ts

@@ -1,6 +1,12 @@
 /**
  * Thin HubSpot module.js bootstrap — JS app loads from CDN via require_js in module.html.
+ *
+ * CSS imports are extracted to module.css by the HubSpot Vite build (same pattern as
+ * digitalwoods.io-woodsportal-client-frontend). HubSpot CMS editor does not reliably
+ * load external jsDelivr stylesheets from module.html.
  */
+import '@/assets/css/main.dev.css'
+
 declare global {
   interface Window {
     WoodsPortalHubSpotBootstrap?: { ready: true }

package/examples/greenfield/module-hybrid-cdn/src/portal/ensure-portal-cdn-stylesheet.ts

@@ -0,0 +1,58 @@
+declare global {
+  interface Window {
+    hubSpotData?: {
+      assetBaseUrl?: string
+      buildId?: string
+    }
+  }
+}
+
+/** Resolve app.{buildId}.css on the CDN mirror (jsDelivr / custom base). */
+export function portalCdnStylesheetUrl(): string | null {
+  const base = window.hubSpotData?.assetBaseUrl?.replace(/\/$/, '')
+  const buildId = window.hubSpotData?.buildId?.trim()
+  if (!base || !buildId) {
+    return null
+  }
+  return `${base}/app.${buildId}.css`
+}
+
+function waitForStylesheet(link: HTMLLinkElement): Promise<void> {
+  if (link.sheet) {
+    return Promise.resolve()
+  }
+
+  return new Promise((resolve) => {
+    link.addEventListener('load', () => resolve(), { once: true })
+    link.addEventListener('error', () => resolve(), { once: true })
+  })
+}
+
+/**
+ * HubSpot module.html uses require_css for app.*.css, but the page editor preview
+ * can skip external footer stylesheets. Inject the CDN stylesheet before React mounts.
+ */
+export async function ensurePortalCdnStylesheet(): Promise<void> {
+  const href = portalCdnStylesheetUrl()
+  if (!href) {
+    return
+  }
+
+  const marker = 'data-portal-cdn-css'
+  const existing = document.querySelector<HTMLLinkElement>(`link[${marker}]`)
+  if (existing) {
+    if (existing.href === href) {
+      await waitForStylesheet(existing)
+      return
+    }
+    existing.remove()
+  }
+
+  const link = document.createElement('link')
+  link.rel = 'stylesheet'
+  link.href = href
+  link.crossOrigin = 'anonymous'
+  link.setAttribute(marker, 'true')
+  document.head.appendChild(link)
+  await waitForStylesheet(link)
+}

package/examples/greenfield/module-hybrid-cdn/woodscli.json

@@ -2,7 +2,7 @@
   "configVersion": 1,
   "projectType": "module-hybrid-cdn",
   "module": {"name": "my-portal-module", "uploadPath": "dw-modules/my-portal-module.module", "outDir": "dist/MyPortal.Module"},
-  "cdn": {"mode": "jsdelivr", "buildIdFile": ".portal-build-id", "mirror": "portal.cdn.json"},
+  "cdn": {"mode": "jsdelivr", "buildIdFile": ".module-build-id", "mirror": "portal.cdn.json"},
   "entries": {"app": "src/cdn/app-entry.ts", "vendor": "src/cdn/vendor-entry.ts", "hubspotBootstrap": "src/hubspot/bootstrap.ts", "localDev": "src/main.tsx"},
   "dev": {"moduleConfigDir": ".wphs", "adapter": "./wphs.adapter.ts", "fieldsJson": "public/fields.json"}
 }

package/examples/greenfield/module-monolith/woodscli.json

@@ -8,7 +8,7 @@
   },
   "cdn": {
     "mode": "none",
-    "buildIdFile": ".portal-build-id",
+    "buildIdFile": ".module-build-id",
     "mirror": "portal.cdn.json"
   },
   "entries": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woodsportal/hubspot-kit",
-  "version": "1.0.31",
+  "version": "1.0.34",
   "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",
@@ -51,7 +51,7 @@
     "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": "node --import tsx --test 'src/lib/**/*.test.ts' 'src/schema/**/*.test.ts' 'src/vite/**/*.test.ts' 'scripts/portal-build-id.test.mjs' && vitest run src/dev-module-config/__tests__/normalize-repeater-items.test.ts src/dev-module-config/__tests__/module-config-transform.test.ts src/dev-module-config/__tests__/flatten-visible-fields.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",

package/scripts/build-cdn.mjs

@@ -9,7 +9,8 @@ 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'
+import { isPrefixBuildMode, resolvePortalViteMode } from './portal-env-mode.mjs'
+import tailwindContent from './tailwind/tailwind-content.js'
 import { resolveViteConfig } from './resolve-vite-config.mjs'
 import {
   exitOnSpawnFailure,
@@ -21,6 +22,10 @@ const root = findProjectRoot()
 
 const mode = resolvePortalViteMode()
 
+if (isPrefixBuildMode(mode)) {
+  await tailwindContent()
+}
+
 const env = envForPortalBuild(mode, root, {
   VITE_DATADOG_RUM_ENABLED: defaultDatadogFlag(mode),
 })

package/scripts/bump-module-build-id.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * Bump .wphs/state/module-build-id.json and print JSON result to stdout.
+ * Used by wp deploy / wp build --cdn-only before CDN builds.
+ */
+import { bumpModuleBuildId, clearPortalBuildIdCache } from './portal-build-id.mjs'
+import { findProjectRoot } from './project-root.mjs'
+
+const args = new Set(process.argv.slice(2))
+const dryRun = args.has('--dry-run')
+const tierArg = [...args].find((a) => a.startsWith('--tier='))
+const tier = tierArg?.split('=')[1]
+
+clearPortalBuildIdCache()
+
+try {
+  const result = bumpModuleBuildId({
+    projectRoot: findProjectRoot(),
+    tier,
+    dryRun,
+    env: process.env,
+  })
+  process.stdout.write(`${JSON.stringify(result)}\n`)
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`[bump-module-build-id] ERROR: ${message}`)
+  process.exit(1)
+}

package/scripts/hubspot-module-postbuild.mjs

@@ -22,6 +22,7 @@ const ALLOWED_DIST_FILES = new Set([
   'module.js',
   'module.css',
   'fields.json',
+  'meta.json',
 ])
 
 /**
@@ -89,6 +90,35 @@ export function injectCdnManifestIntoModuleHtml(html, manifestPath) {
     .replaceAll('__PORTAL_APP_CSS_FILE__', appCss.file)
 }
 
+/**
+ * HubSpot serves module.css with every module instance (including the CMS editor preview).
+ * External jsDelivr stylesheets from module.html are often blocked in the editor iframe.
+ */
+export function mergeCdnAppStylesIntoModuleCss(moduleDir, manifestPath) {
+  if (!existsSync(manifestPath)) {
+    return false
+  }
+
+  const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+  const appCss = manifest.styles?.find((s) => s.name === 'app') ?? manifest.styles?.[0]
+  if (!appCss?.file) {
+    throw new Error('manifest.json must include app styles for module.css merge')
+  }
+
+  const cdnCssPath = resolve(moduleDir, '../cdn', appCss.file)
+  if (!existsSync(cdnCssPath)) {
+    throw new Error(
+      `Missing ${cdnCssPath} — run build:cdn before hubspot post-build (needed for module.css)`,
+    )
+  }
+
+  const banner =
+    '/* Hybrid CDN app styles — copied from dist/cdn at build time for HubSpot module.css */\n'
+  const css = readFileSync(cdnCssPath, 'utf8')
+  writeFileSync(resolve(moduleDir, 'module.css'), `${banner}${css}`, 'utf8')
+  return true
+}
+
 /**
  * @param {string} moduleDir absolute path to dist/WoodsPortal.Module
  * @param {string} publicDir absolute path to public/
@@ -120,7 +150,7 @@ export function finalizeHubSpotModuleDist(moduleDir, publicDir, options = {}) {
     }
   }
 
-  for (const file of ['module.html', 'fields.json']) {
+  for (const file of ['module.html', 'fields.json', 'meta.json']) {
     const src = resolve(publicDir, file)
     if (!existsSync(src)) {
       throw new Error(`Missing public/${file} (required for HubSpot module upload)`)
@@ -134,6 +164,10 @@ export function finalizeHubSpotModuleDist(moduleDir, publicDir, options = {}) {
     }
   }
 
+  if (existsSync(manifestPath)) {
+    mergeCdnAppStylesIntoModuleCss(moduleDir, manifestPath)
+  }
+
   const escaped = escapeHubSpotModuleJs(readFileSync(jsPath, 'utf8'))
   assertNoForbiddenHubLTokens(escaped, jsPath)
   writeFileSync(jsPath, escaped, 'utf8')

package/scripts/load-portal-cdn-config.mjs

@@ -28,8 +28,14 @@ function readWoodscliConfig(projectRoot) {
   }
 }
 
+const LOCAL_CDN_MIRROR_FILE = 'portal.cdn.local.json'
+
 function resolveMirrorPath(projectRoot, hsConfig) {
   const mirror = hsConfig?.cdn?.mirror?.trim() || 'portal.cdn.json'
+  const localMirror = resolve(projectRoot, LOCAL_CDN_MIRROR_FILE)
+  if (existsSync(localMirror)) {
+    return localMirror
+  }
   return resolve(projectRoot, mirror)
 }
 
@@ -61,6 +67,8 @@ export function loadPortalCdnConfig(env = process.env, projectRoot) {
     fileConfig.publishMode ||
     DEFAULTS.publishMode
 
+  const usingLocalMirror = loadedFrom?.endsWith(LOCAL_CDN_MIRROR_FILE) ?? false
+
   return {
     publishMode,
     cdnMode,
@@ -69,6 +77,7 @@ export function loadPortalCdnConfig(env = process.env, projectRoot) {
     cdnPathInRepo: fileConfig.cdnPathInRepo || DEFAULTS.cdnPathInRepo,
     defaultBranch: fileConfig.defaultBranch || DEFAULTS.defaultBranch,
     configPath: loadedFrom,
+    usingLocalMirror,
   }
 }
 
@@ -82,10 +91,19 @@ export function envWithPortalCdnConfig(baseEnv = process.env, projectRoot) {
   }
 }
 
-/** jsDelivr base URL for a tagged release. */
-export function jsDelivrBaseUrl(github, buildId, cdnPathInRepo = DEFAULTS.cdnPathInRepo) {
+/**
+ * jsDelivr base URL for GitHub CDN mirror.
+ * Uses the default branch ref (not the git tag): chunk filenames already include buildId,
+ * and jsDelivr indexes branches reliably (tag refs often 404 until propagated).
+ */
+export function jsDelivrBaseUrl(
+  github,
+  cdnPathInRepo = DEFAULTS.cdnPathInRepo,
+  branch = DEFAULTS.defaultBranch,
+) {
   const path = cdnPathInRepo.replace(/^\//, '').replace(/\/$/, '')
-  return `https://cdn.jsdelivr.net/gh/${github}@${buildId}/${path}`
+  const ref = branch.replace(/^@/, '').trim() || DEFAULTS.defaultBranch
+  return `https://cdn.jsdelivr.net/gh/${github}@${ref}/${path}`
 }
 
 export { DEFAULTS }