@woodsportal/hubspot-kit 1.0.41-dev.4 → 1.0.41-dev.6

package/dist/index.d.ts

@@ -94,10 +94,18 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
     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"]>>;
+        /** Portal user auth tier (module templates only) */
+        auth: z.ZodDefault<z.ZodEnum<["none", "starter", "sso", "full"]>>;
+        /** Authenticated shell navigation — only when auth ≠ none */
+        nav: z.ZodOptional<z.ZodDefault<z.ZodEnum<["top", "sidebar"]>>>;
     }, "strip", z.ZodTypeAny, {
         router: "none" | "hash" | "browser";
+        auth: "none" | "starter" | "sso" | "full";
+        nav?: "top" | "sidebar" | undefined;
     }, {
         router?: "none" | "hash" | "browser" | undefined;
+        auth?: "none" | "starter" | "sso" | "full" | undefined;
+        nav?: "top" | "sidebar" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     configVersion: number;
@@ -136,6 +144,8 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
     } | undefined;
     scaffold?: {
         router: "none" | "hash" | "browser";
+        auth: "none" | "starter" | "sso" | "full";
+        nav?: "top" | "sidebar" | undefined;
     } | undefined;
 }, {
     projectType: "module-hybrid-cdn" | "module-monolith" | "theme-starter";
@@ -174,6 +184,8 @@ declare const WoodsPortalHsSchema: z.ZodObject<{
     } | undefined;
     scaffold?: {
         router?: "none" | "hash" | "browser" | undefined;
+        auth?: "none" | "starter" | "sso" | "full" | undefined;
+        nav?: "top" | "sidebar" | undefined;
     } | undefined;
 }>;
 type WoodsPortalHsConfig = z.infer<typeof WoodsPortalHsSchema>;

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   getViteConfigPath,
   kitPath,
   resolveProjectConfig
-} from "./chunk-S2YJDWZU.js";
+} from "./chunk-NWBK3XBZ.js";
 
 // src/schema/woodsportal-hs.ts
 import { z } from "zod";
@@ -52,7 +52,11 @@ var WoodsPortalHsSchema = z.object({
   }).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")
+    router: z.enum(["hash", "browser", "none"]).default("hash"),
+    /** Portal user auth tier (module templates only) */
+    auth: z.enum(["none", "starter", "sso", "full"]).default("none"),
+    /** Authenticated shell navigation — only when auth ≠ none */
+    nav: z.enum(["top", "sidebar"]).default("top").optional()
   }).optional()
 });
 var DEFAULT_WOODSPORTAL_HS = {

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('.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":[]}
+{"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      /** Portal user auth tier (module templates only) */\n      auth: z.enum(['none', 'starter', 'sso', 'full']).default('none'),\n      /** Authenticated shell navigation — only when auth ≠ none */\n      nav: z.enum(['top', 'sidebar']).default('top').optional(),\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":";;;;;;;;;;;;;AAAA,SAAS,SAAS;AAEX,IAAM,iBAAiB;AAEvB,IAAM,qBAAqB;AAE3B,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,cAAc;AAAA,EACtD,aAAa,EAAE,KAAK,CAAC,qBAAqB,mBAAmB,eAAe,CAAC;AAAA,EAC7E,QAAQ,EAAE,OAAO;AAAA,IACf,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACtB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IAC5B,QAAQ,EAAE,OAAO,EAAE,QAAQ,yBAAyB;AAAA,EACtD,CAAC;AAAA,EACD,OAAO,EACJ,OAAO;AAAA,IACN,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACtB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IAC5B,QAAQ,EAAE,OAAO,EAAE,QAAQ,WAAW;AAAA,IACtC,WAAW,EAAE,OAAO,EAAE,QAAQ,sBAAsB;AAAA,EACtD,CAAC,EACA,SAAS;AAAA,EACZ,KAAK,EACF,OAAO;AAAA,IACN,MAAM,EAAE,KAAK,CAAC,YAAY,UAAU,SAAS,MAAM,CAAC,EAAE,QAAQ,UAAU;AAAA,IACxE,aAAa,EAAE,OAAO,EAAE,QAAQ,kBAAkB;AAAA,IAClD,QAAQ,EAAE,OAAO,EAAE,QAAQ,iBAAiB;AAAA,EAC9C,CAAC,EACA,QAAQ,CAAC,CAAC;AAAA,EACb,SAAS,EACN,OAAO;AAAA,IACN,KAAK,EAAE,OAAO,EAAE,QAAQ,sBAAsB;AAAA,IAC9C,QAAQ,EAAE,OAAO,EAAE,QAAQ,yBAAyB;AAAA,IACpD,kBAAkB,EAAE,OAAO,EAAE,QAAQ,0BAA0B;AAAA;AAAA,IAE/D,QAAQ,EAAE,OAAO,EAAE,QAAQ,8BAA8B;AAAA,IACzD,UAAU,EAAE,OAAO,EAAE,QAAQ,cAAc;AAAA,EAC7C,CAAC,EACA,QAAQ,CAAC,CAAC;AAAA,EACb,KAAK,EACF,OAAO;AAAA,IACN,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,OAAO,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,OAAO,MAAM,CAAC;AAAA,EAC/E,CAAC,EACA,QAAQ,CAAC,CAAC;AAAA,EACb,KAAK,EACF,OAAO;AAAA,IACN,iBAAiB,EAAE,QAAQ,kBAAkB,EAAE,QAAQ,kBAAkB;AAAA,IACzE,SAAS,EAAE,OAAO,EAAE,QAAQ,mBAAmB;AAAA,IAC/C,YAAY,EAAE,OAAO,EAAE,QAAQ,oBAAoB;AAAA,IACnD,iBAAiB,EAAE,OAAO,EAAE,SAAS;AAAA,EACvC,CAAC,EACA,QAAQ,CAAC,CAAC;AAAA,EACb,UAAU,EACP,OAAO;AAAA;AAAA,IAEN,QAAQ,EAAE,KAAK,CAAC,QAAQ,WAAW,MAAM,CAAC,EAAE,QAAQ,MAAM;AAAA;AAAA,IAE1D,MAAM,EAAE,KAAK,CAAC,QAAQ,WAAW,OAAO,MAAM,CAAC,EAAE,QAAQ,MAAM;AAAA;AAAA,IAE/D,KAAK,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,EAAE,QAAQ,KAAK,EAAE,SAAS;AAAA,EAC1D,CAAC,EACA,SAAS;AACd,CAAC;AAIM,IAAM,yBAA8C;AAAA,EACzD,eAAe;AAAA,EACf,aAAa;AAAA,EACb,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,QAAQ;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,EACV;AAAA,EACA,SAAS;AAAA,IACP,KAAK;AAAA,IACL,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA,KAAK;AAAA,IACH,OAAO,CAAC,OAAO,OAAO,MAAM;AAAA,EAC9B;AAAA,EACA,KAAK;AAAA,IACH,iBAAiB;AAAA,IACjB,SAAS;AAAA,IACT,YAAY;AAAA,EACd;AACF;AAEO,SAAS,gBAAgB,QAAsC;AACpE,SAAO,OAAO,gBAAgB,uBAAuB,OAAO,gBAAgB;AAC9E;AAEO,SAAS,eAAe,QAAsC;AACnE,SAAO,OAAO,gBAAgB;AAChC;AAEO,SAAS,gBAAgB,QAAsC;AACpE,SAAO,OAAO,gBAAgB,uBAAuB,OAAO,IAAI,SAAS;AAC3E;;;AC1GA,SAAS,oBAAoB;AAiBtB,SAAS,WAAW,aAA2C;AACpE,QAAM,OAAO,eAAe,gBAAgB;AAC5C,QAAM,WAAW,qBAAqB,IAAI;AAE1C,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,UAAU,WAAW,oBAAoB,IAAI;AAAA,MACrD,UAAU,SAAS;AAAA,MACnB,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAEA,MAAI;AACJ,MAAI;AACF,UAAM,KAAK,MAAM,aAAa,SAAS,MAAM,MAAM,CAAC;AAAA,EACtD,SAAS,OAAO;AACd,UAAM,IAAI,UAAU,mBAAmB,SAAS,QAAQ,IAAI;AAAA,MAC1D,UAAU,SAAS;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,SAAS,oBAAoB,UAAU,GAAG;AAChD,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,UAAU,GAAG,SAAS,QAAQ,uBAAuB,OAAO,MAAM,OAAO,IAAI;AAAA,MACrF,UAAU,SAAS;AAAA,MACnB,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,OAAO;AAAA,IACf,YAAY,SAAS;AAAA,IACrB,gBAAgB,SAAS;AAAA,EAC3B;AACF;AAEO,SAAS,mBAAmB,aAIjC;AACA,MAAI;AACF,UAAM,EAAE,OAAO,IAAI,WAAW,WAAW;AACzC,WAAO,EAAE,OAAO,MAAM,QAAQ,CAAC,GAAG,OAAO;AAAA,EAC3C,SAAS,OAAO;AACd,QAAI,iBAAiB,WAAW;AAC9B,aAAO,EAAE,OAAO,OAAO,QAAQ,CAAC,MAAM,OAAO,EAAE;AAAA,IACjD;AACA,WAAO,EAAE,OAAO,OAAO,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE;AAAA,EACjD;AACF;;;ACnEO,IAAM,wBAAwB;AAa9B,SAAS,0BAA0B,SAAkC;AAC1E,MAAI,OAAO,WAAW,WAAW,YAAa;AAC9C,aAAW,OAAO,iBAAiB,uBAAuB,CAAC,UAAiB;AAC1E,UAAM,SAAU,MAA8C;AAC9D,YAAQ,aAAa,OAAO,KAAK;AAAA,EACnC,CAAC;AACH;AAEO,SAAS,2BACd,SACA,OACM;AACN,UAAQ,aAAa,MAAM,KAAK;AAClC;AAGO,IAAM,2BAA8C;AAAA,EACzD,aAAa,OAAO;AAClB,UAAM,IAAI;AACV,MAAE,gBAAgB;AAAA,EACpB;AAAA,EACA,wBAAwB;AACtB,WAAO,CAAC;AAAA,EACV;AACF;;;AC1BA,SAAS,aACP,OACA,QACA,KACM;AACN,QAAM,MAAM,MAAM;AAClB,QAAM,QAAQ,OAAO,GAAG;AAExB,MAAI,MAAM,SAAS,WAAW,MAAM,YAAY,SAAS,OAAO,UAAU,UAAU;AAClF,UAAM,cAAc;AACpB,eAAW,SAAS,MAAM,UAAU;AAClC,mBAAa,OAAO,aAAa,GAAG;AAAA,IACtC;AACA;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,cAAc,MAAM,QAAQ,KAAK,GAAG;AACrD,QAAI,GAAG,IAAI;AACX;AAAA,EACF;AAEA,MAAI,GAAG,IAAI,SAAS,MAAM,WAAW;AACvC;AAEO,SAAS,mBACd,QACA,QACyB;AACzB,QAAM,MAA+B,CAAC;AACtC,aAAW,SAAS,QAAQ;AAC1B,iBAAa,OAAO,QAAQ,GAAG;AAAA,EACjC;AACA,SAAO;AACT;","names":[]}

package/dist/scaffold-page-lifecycle-EHMPWPPE.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+import {
+  isModuleProject,
+  isThemeProject,
+  normalizePageSlug,
+  regenerateRouteTree,
+  removeNavItemsEntry,
+  resolveProjectNavConfig,
+  slugToCamelCase,
+  slugToPascalCase
+} from "./chunk-WHYTQEZX.js";
+import {
+  ExitCode,
+  WpHsError
+} from "./chunk-4GOJPOW3.js";
+
+// src/lib/scaffold-page-lifecycle.ts
+import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { resolve } from "path";
+var BUILTIN_ROUTE_KEYS = /* @__PURE__ */ new Set([
+  "home",
+  "guide",
+  "login",
+  "twoFa",
+  "unauthorized",
+  "ssoLogin",
+  "portal",
+  "app"
+]);
+function assertModuleWithRouter(config) {
+  if (isThemeProject(config)) {
+    throw new WpHsError("wp page is only supported for module projects.", {
+      exitCode: ExitCode.USER_ERROR
+    });
+  }
+  if (!isModuleProject(config)) {
+    throw new WpHsError("wp page requires a module project.", { exitCode: ExitCode.USER_ERROR });
+  }
+  if ((config.scaffold?.router ?? "hash") === "none") {
+    throw new WpHsError("wp page requires client-side routing.", {
+      exitCode: ExitCode.USER_ERROR
+    });
+  }
+}
+function routesConfigPath(projectRoot) {
+  const path = resolve(projectRoot, "src/config/routes.ts");
+  if (!existsSync(path)) {
+    throw new WpHsError("Missing src/config/routes.ts", { exitCode: ExitCode.USER_ERROR });
+  }
+  return path;
+}
+function parseRoutePaths(routesFile) {
+  const content = readFileSync(routesFile, "utf8");
+  const entries = {};
+  const pattern = /^\s*([a-zA-Z][a-zA-Z0-9_]*)\s*:\s*'([^']*)'/gm;
+  for (const match of content.matchAll(pattern)) {
+    entries[match[1]] = match[2];
+  }
+  return entries;
+}
+function navContainsRoutesKey(projectRoot, routesKey) {
+  const navConfig = resolveProjectNavConfig(projectRoot);
+  if (!navConfig) {
+    return false;
+  }
+  const content = readFileSync(navConfig.filePath, "utf8");
+  return new RegExp(`\\.${routesKey}\\b`).test(content);
+}
+function detectPageAccess(projectRoot, slug) {
+  const protectedRoute = resolve(projectRoot, "src/routes/_app", `${slug}.tsx`);
+  if (existsSync(protectedRoute)) {
+    return "protected";
+  }
+  return "public";
+}
+function listScaffoldedPages(projectRoot, config) {
+  assertModuleWithRouter(config);
+  const pagesDir = resolve(projectRoot, "src/features/pages");
+  if (!existsSync(pagesDir)) {
+    return [];
+  }
+  const routesFile = routesConfigPath(projectRoot);
+  const routePaths = parseRoutePaths(routesFile);
+  const pages = [];
+  for (const file of readdirSync(pagesDir)) {
+    if (!file.endsWith("-page.tsx")) {
+      continue;
+    }
+    const slug = file.replace(/-page\.tsx$/, "");
+    const routesKey = slugToCamelCase(slug);
+    if (BUILTIN_ROUTE_KEYS.has(routesKey)) {
+      continue;
+    }
+    const access = detectPageAccess(projectRoot, slug);
+    const routeRelative = access === "protected" ? `src/routes/_app/${slug}.tsx` : `src/routes/${slug}.tsx`;
+    pages.push({
+      slug,
+      routesKey,
+      path: routePaths[routesKey] ?? `/${slug}`,
+      access,
+      routeFile: routeRelative,
+      pageFile: `src/features/pages/${slug}-page.tsx`,
+      inNav: navContainsRoutesKey(projectRoot, routesKey)
+    });
+  }
+  return pages.sort((a, b) => a.slug.localeCompare(b.slug));
+}
+function removeRoutesKeyFromFile(routesFile, routesKey) {
+  const content = readFileSync(routesFile, "utf8");
+  const linePattern = new RegExp(`^\\s*${routesKey}\\s*:\\s*'[^']*',?\\n`, "m");
+  const updated = content.replace(linePattern, "");
+  if (updated === content) {
+    throw new WpHsError(`Routes key "${routesKey}" not found in src/config/routes.ts.`, {
+      exitCode: ExitCode.USER_ERROR
+    });
+  }
+  writeFileSync(routesFile, updated);
+}
+function removePagesBarrelExport(projectRoot, slug, componentName) {
+  const barrelPath = resolve(projectRoot, "src/features/pages/index.ts");
+  if (!existsSync(barrelPath)) {
+    return;
+  }
+  const exportLine = `export { ${componentName} } from './${slug}-page'`;
+  const content = readFileSync(barrelPath, "utf8");
+  const updated = content.split("\n").filter((line) => line.trim() !== exportLine).join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+  if (updated) {
+    writeFileSync(barrelPath, `${updated}
+`);
+  } else {
+    rmSync(barrelPath);
+  }
+}
+function removeScaffoldedPage(input) {
+  assertModuleWithRouter(input.config);
+  const slug = normalizePageSlug(input.slug);
+  const routesKey = slugToCamelCase(slug);
+  const componentName = `${slugToPascalCase(slug)}Page`;
+  if (BUILTIN_ROUTE_KEYS.has(routesKey)) {
+    throw new WpHsError(`Cannot remove built-in route key "${routesKey}".`, {
+      exitCode: ExitCode.USER_ERROR
+    });
+  }
+  const pageFile = resolve(input.projectRoot, "src/features/pages", `${slug}-page.tsx`);
+  const access = detectPageAccess(input.projectRoot, slug);
+  const routeRelative = access === "protected" ? `src/routes/_app/${slug}.tsx` : `src/routes/${slug}.tsx`;
+  const routeFile = resolve(input.projectRoot, routeRelative);
+  if (!existsSync(pageFile)) {
+    throw new WpHsError(`Scaffolded page not found: src/features/pages/${slug}-page.tsx`, {
+      exitCode: ExitCode.USER_ERROR,
+      remediation: "Use wp page list to see scaffolded pages."
+    });
+  }
+  if (input.dryRun) {
+    input.logger?.info(`[dry-run] Would remove ${routeRelative} and src/features/pages/${slug}-page.tsx`);
+    return {
+      slug,
+      removedRoute: routeRelative,
+      removedPage: `src/features/pages/${slug}-page.tsx`,
+      routeTreeRegenerated: false
+    };
+  }
+  const { projectRoot } = input;
+  rmSync(pageFile);
+  if (existsSync(routeFile)) {
+    rmSync(routeFile);
+  }
+  removeRoutesKeyFromFile(routesConfigPath(projectRoot), routesKey);
+  removePagesBarrelExport(projectRoot, slug, componentName);
+  const navConfig = resolveProjectNavConfig(projectRoot);
+  if (input.removeFromNav !== false && navConfig && navContainsRoutesKey(projectRoot, routesKey)) {
+    try {
+      removeNavItemsEntry(navConfig, routesKey);
+    } catch {
+      input.logger?.warn(`Nav entry for "${routesKey}" was not removed \u2014 edit ${navConfig.relativePath} manually.`);
+    }
+  }
+  const regen = regenerateRouteTree(projectRoot, { logger: input.logger, dryRun: input.dryRun });
+  if (regen.warning) {
+    input.logger?.warn(regen.warning);
+  }
+  return {
+    slug,
+    removedRoute: routeRelative,
+    removedPage: `src/features/pages/${slug}-page.tsx`,
+    routeTreeRegenerated: regen.ok,
+    routeTreeWarning: regen.warning
+  };
+}
+export {
+  listScaffoldedPages,
+  removeScaffoldedPage
+};
+//# sourceMappingURL=scaffold-page-lifecycle-EHMPWPPE.js.map

package/dist/scaffold-page-lifecycle-EHMPWPPE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/scaffold-page-lifecycle.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { WoodsPortalHsConfig } from '../schema/woodsportal-hs.js'\nimport { isModuleProject, isThemeProject } from '../schema/woodsportal-hs.js'\nimport { ExitCode, WpHsError } from './errors.js'\nimport type { Logger } from './logger.js'\nimport {\n  removeNavItemsEntry,\n  resolveProjectNavConfig,\n} from './project-nav-config.js'\nimport { regenerateRouteTree } from './regenerate-route-tree.js'\nimport {\n  normalizePageSlug,\n  type PageAccess,\n  slugToCamelCase,\n  slugToPascalCase,\n} from './scaffold-page.js'\n\nexport type ListedPage = {\n  slug: string\n  routesKey: string\n  path: string\n  access: PageAccess\n  routeFile: string\n  pageFile: string\n  inNav: boolean\n}\n\nconst BUILTIN_ROUTE_KEYS = new Set([\n  'home',\n  'guide',\n  'login',\n  'twoFa',\n  'unauthorized',\n  'ssoLogin',\n  'portal',\n  'app',\n])\n\nfunction assertModuleWithRouter(config: WoodsPortalHsConfig): void {\n  if (isThemeProject(config)) {\n    throw new WpHsError('wp page is only supported for module projects.', {\n      exitCode: ExitCode.USER_ERROR,\n    })\n  }\n  if (!isModuleProject(config)) {\n    throw new WpHsError('wp page requires a module project.', { exitCode: ExitCode.USER_ERROR })\n  }\n  if ((config.scaffold?.router ?? 'hash') === 'none') {\n    throw new WpHsError('wp page requires client-side routing.', {\n      exitCode: ExitCode.USER_ERROR,\n    })\n  }\n}\n\nfunction routesConfigPath(projectRoot: string): string {\n  const path = resolve(projectRoot, 'src/config/routes.ts')\n  if (!existsSync(path)) {\n    throw new WpHsError('Missing src/config/routes.ts', { exitCode: ExitCode.USER_ERROR })\n  }\n  return path\n}\n\nfunction parseRoutePaths(routesFile: string): Record<string, string> {\n  const content = readFileSync(routesFile, 'utf8')\n  const entries: Record<string, string> = {}\n  const pattern = /^\\s*([a-zA-Z][a-zA-Z0-9_]*)\\s*:\\s*'([^']*)'/gm\n  for (const match of content.matchAll(pattern)) {\n    entries[match[1]] = match[2]\n  }\n  return entries\n}\n\nfunction navContainsRoutesKey(projectRoot: string, routesKey: string): boolean {\n  const navConfig = resolveProjectNavConfig(projectRoot)\n  if (!navConfig) {\n    return false\n  }\n  const content = readFileSync(navConfig.filePath, 'utf8')\n  return new RegExp(`\\\\.${routesKey}\\\\b`).test(content)\n}\n\nfunction detectPageAccess(projectRoot: string, slug: string): PageAccess {\n  const protectedRoute = resolve(projectRoot, 'src/routes/_app', `${slug}.tsx`)\n  if (existsSync(protectedRoute)) {\n    return 'protected'\n  }\n  return 'public'\n}\n\nexport function listScaffoldedPages(projectRoot: string, config: WoodsPortalHsConfig): ListedPage[] {\n  assertModuleWithRouter(config)\n\n  const pagesDir = resolve(projectRoot, 'src/features/pages')\n  if (!existsSync(pagesDir)) {\n    return []\n  }\n\n  const routesFile = routesConfigPath(projectRoot)\n  const routePaths = parseRoutePaths(routesFile)\n\n  const pages: ListedPage[] = []\n  for (const file of readdirSync(pagesDir)) {\n    if (!file.endsWith('-page.tsx')) {\n      continue\n    }\n    const slug = file.replace(/-page\\.tsx$/, '')\n    const routesKey = slugToCamelCase(slug)\n    if (BUILTIN_ROUTE_KEYS.has(routesKey)) {\n      continue\n    }\n\n    const access = detectPageAccess(projectRoot, slug)\n    const routeRelative =\n      access === 'protected' ? `src/routes/_app/${slug}.tsx` : `src/routes/${slug}.tsx`\n\n    pages.push({\n      slug,\n      routesKey,\n      path: routePaths[routesKey] ?? `/${slug}`,\n      access,\n      routeFile: routeRelative,\n      pageFile: `src/features/pages/${slug}-page.tsx`,\n      inNav: navContainsRoutesKey(projectRoot, routesKey),\n    })\n  }\n\n  return pages.sort((a, b) => a.slug.localeCompare(b.slug))\n}\n\nfunction removeRoutesKeyFromFile(routesFile: string, routesKey: string): void {\n  const content = readFileSync(routesFile, 'utf8')\n  const linePattern = new RegExp(`^\\\\s*${routesKey}\\\\s*:\\\\s*'[^']*',?\\\\n`, 'm')\n  const updated = content.replace(linePattern, '')\n  if (updated === content) {\n    throw new WpHsError(`Routes key \"${routesKey}\" not found in src/config/routes.ts.`, {\n      exitCode: ExitCode.USER_ERROR,\n    })\n  }\n  writeFileSync(routesFile, updated)\n}\n\nfunction removePagesBarrelExport(projectRoot: string, slug: string, componentName: string): void {\n  const barrelPath = resolve(projectRoot, 'src/features/pages/index.ts')\n  if (!existsSync(barrelPath)) {\n    return\n  }\n  const exportLine = `export { ${componentName} } from './${slug}-page'`\n  const content = readFileSync(barrelPath, 'utf8')\n  const updated = content\n    .split('\\n')\n    .filter((line) => line.trim() !== exportLine)\n    .join('\\n')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trimEnd()\n  if (updated) {\n    writeFileSync(barrelPath, `${updated}\\n`)\n  } else {\n    rmSync(barrelPath)\n  }\n}\n\nexport type RemovePageInput = {\n  projectRoot: string\n  config: WoodsPortalHsConfig\n  slug: string\n  removeFromNav?: boolean\n  dryRun?: boolean\n  logger?: Logger\n}\n\nexport type RemovePageResult = {\n  slug: string\n  removedRoute: string\n  removedPage: string\n  routeTreeRegenerated: boolean\n  routeTreeWarning?: string\n}\n\nexport function removeScaffoldedPage(input: RemovePageInput): RemovePageResult {\n  assertModuleWithRouter(input.config)\n\n  const slug = normalizePageSlug(input.slug)\n  const routesKey = slugToCamelCase(slug)\n  const componentName = `${slugToPascalCase(slug)}Page`\n\n  if (BUILTIN_ROUTE_KEYS.has(routesKey)) {\n    throw new WpHsError(`Cannot remove built-in route key \"${routesKey}\".`, {\n      exitCode: ExitCode.USER_ERROR,\n    })\n  }\n\n  const pageFile = resolve(input.projectRoot, 'src/features/pages', `${slug}-page.tsx`)\n  const access = detectPageAccess(input.projectRoot, slug)\n  const routeRelative =\n    access === 'protected' ? `src/routes/_app/${slug}.tsx` : `src/routes/${slug}.tsx`\n  const routeFile = resolve(input.projectRoot, routeRelative)\n\n  if (!existsSync(pageFile)) {\n    throw new WpHsError(`Scaffolded page not found: src/features/pages/${slug}-page.tsx`, {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Use wp page list to see scaffolded pages.',\n    })\n  }\n\n  if (input.dryRun) {\n    input.logger?.info(`[dry-run] Would remove ${routeRelative} and src/features/pages/${slug}-page.tsx`)\n    return {\n      slug,\n      removedRoute: routeRelative,\n      removedPage: `src/features/pages/${slug}-page.tsx`,\n      routeTreeRegenerated: false,\n    }\n  }\n\n  const { projectRoot } = input\n  rmSync(pageFile)\n  if (existsSync(routeFile)) {\n    rmSync(routeFile)\n  }\n\n  removeRoutesKeyFromFile(routesConfigPath(projectRoot), routesKey)\n  removePagesBarrelExport(projectRoot, slug, componentName)\n\n  const navConfig = resolveProjectNavConfig(projectRoot)\n  if (input.removeFromNav !== false && navConfig && navContainsRoutesKey(projectRoot, routesKey)) {\n    try {\n      removeNavItemsEntry(navConfig, routesKey)\n    } catch {\n      input.logger?.warn(`Nav entry for \"${routesKey}\" was not removed — edit ${navConfig.relativePath} manually.`)\n    }\n  }\n\n  const regen = regenerateRouteTree(projectRoot, { logger: input.logger, dryRun: input.dryRun })\n  if (regen.warning) {\n    input.logger?.warn(regen.warning)\n  }\n\n  return {\n    slug,\n    removedRoute: routeRelative,\n    removedPage: `src/features/pages/${slug}-page.tsx`,\n    routeTreeRegenerated: regen.ok,\n    routeTreeWarning: regen.warning,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/vite/index.js

@@ -1,7 +1,7 @@
 import {
   createViteConfig,
   getViteConfigPath
-} from "../chunk-S2YJDWZU.js";
+} from "../chunk-NWBK3XBZ.js";
 export {
   createViteConfig,
   getViteConfigPath

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

@@ -1,41 +1,86 @@
 [
   {
-    "name": "title",
-    "label": "Portal title",
-    "type": "text",
-    "tab": "CONTENT",
-    "default": "My HubSpot Portal"
-  },
-  {
-    "name": "tagline",
-    "label": "Tagline",
-    "type": "text",
-    "display": "textarea",
-    "tab": "CONTENT",
-    "help_text": "Subtitle shown under the hero title.",
-    "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",
+    "type": "group",
+    "name": "content",
+    "label": "Content",
     "tab": "CONTENT",
-    "default": true
+    "children": [
+      {
+        "name": "title",
+        "label": "Portal title",
+        "type": "text",
+        "default": "My HubSpot Portal"
+      },
+      {
+        "name": "tagline",
+        "label": "Tagline",
+        "type": "text",
+        "display": "textarea",
+        "help_text": "Subtitle shown under the hero title.",
+        "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",
+        "default": true
+      }
+    ]
   },
   {
     "type": "group",
-    "name": "styles",
-    "label": "Styles",
+    "name": "style",
+    "label": "Style",
     "tab": "STYLE",
     "children": [
       {
-        "name": "accent_color",
-        "label": "Accent color",
-        "type": "color",
+        "type": "group",
+        "name": "module_global_colors",
+        "label": "Module Global Colors",
+        "tab": "STYLE",
+        "children": [
+          {
+            "name": "primary_color",
+            "label": "Primary Color",
+            "type": "color",
+            "default": {
+              "color": "#FF7A59",
+              "opacity": 100
+            }
+          },
+          {
+            "name": "secondary_color",
+            "label": "Secondary Color",
+            "type": "color",
+            "default": {
+              "color": "#2797AF",
+              "opacity": 100
+            }
+          },
+          {
+            "name": "button_text_color",
+            "label": "Button Text Color",
+            "type": "color",
+            "default": {
+              "color": "#FFFFFF",
+              "opacity": 100
+            }
+          }
+        ],
         "default": {
-          "color": "#0091ae",
-          "opacity": 100
+          "primary_color": {
+            "color": "#FF7A59",
+            "opacity": 100
+          },
+          "secondary_color": {
+            "color": "#2797AF",
+            "opacity": 100
+          },
+          "button_text_color": {
+            "color": "#FFFFFF",
+            "opacity": 100
+          }
         }
       },
       {

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

@@ -1,13 +1,29 @@
 {# Hybrid CDN — React app loads from jsDelivr; module.js is a thin bootstrap only. #}
 {% set in_cms_editor = is_in_editor or is_in_page_editor or is_in_previewer %}
+{% require_css %}
+<style>
+{% scope_css %}
+:root {
+  --primary-color: {{ module.style.module_global_colors.primary_color.color|default('#FF7A59') }};
+  --secondary-color: {{ module.style.module_global_colors.secondary_color.color|default('#2797AF') }};
+  --button-text-color: {{ module.style.module_global_colors.button_text_color.color|default('#FFFFFF') }};
+}
+p:not([class]) {
+  margin: 0;
+}
+ul, ol {
+  margin: 0;
+}
+{% end_scope_css %}
+</style>
+{% end_require_css %}
 <script>
   window.hsInEditor = {{ in_cms_editor|lower }};
   window.hubSpotData = {
-    title: {{ module.title|tojson }},
-    tagline: {{ module.tagline|tojson }},
-    show_feature_cards: {{ module.show_feature_cards|lower }},
-    accent_color: {{ module.styles.accent_color|tojson }},
-    hero_style: {{ module.styles.hero_style|tojson }},
+    title: {{ module.content.title|default(module.title)|tojson }},
+    tagline: {{ module.content.tagline|default(module.tagline)|tojson }},
+    show_feature_cards: {{ module.content.show_feature_cards|default(module.show_feature_cards)|lower }},
+    hero_style: {{ module.style.hero_style|tojson }},
     assetBaseUrl: "__PORTAL_CDN_BASE__",
     buildId: "__PORTAL_BUILD_ID__",
     isInEditor: {{ in_cms_editor|lower }}

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

@@ -1,4 +1,19 @@
+/**
+ * LOCAL DEV ONLY (wp dev) — unprefixed Tailwind utilities.
+ *
+ * Never merge with main.prod.css:
+ * - Do not add dw prefix on this file
+ * - Do not point @source at .temp/ only (that is for HubSpot builds)
+ */
 @import 'tailwindcss';
+@import './tailwind.css.config.css';
+
+/* WoodsPortal module global colors — defaults until HubSpot fields / module-config apply overrides */
+:root {
+  --primary-color: #ff7a59;
+  --secondary-color: #2797af;
+  --button-text-color: #ffffff;
+}
 
 /* Kit dev-module-config — paths relative to this file (src/assets/css/) */
 @source '../../../.wphs/.kit-module-config/**/*.{ts,tsx}';

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

@@ -1,26 +1,23 @@
 import { Link } from '@tanstack/react-router'
 
-import { ROUTES } from '@/config/routes'
+import { starterNavItems } from '@/config/starter-nav'
 
 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 className="flex flex-wrap gap-4 text-sm font-medium">
+          {starterNavItems.map((item) => (
+            <Link
+              key={item.to}
+              to={item.to}
+              className="text-[#516f90] hover:text-[#0091ae] [&.active]:text-[#0091ae]"
+              activeOptions={{ exact: item.to === '/' }}
+            >
+              {item.label}
+            </Link>
+          ))}
         </nav>
       </div>
     </header>

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

@@ -0,0 +1,9 @@
+import { ROUTES } from '@/config/routes'
+
+/** No-auth module navigation — edit once; StarterNav reads this file. */
+export const starterNavItems = [
+  { to: ROUTES.home, label: 'Home' },
+  { to: ROUTES.guide, label: 'Developer guide' },
+] as const
+
+export type StarterNavItem = (typeof starterNavItems)[number]

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

@@ -1,38 +1,34 @@
 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()
+  const { title, tagline, showFeatureCards, 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>
+      <section
+        className={
+          heroStyle === 'minimal'
+            ? 'px-6 py-14 sm:px-10 sm:py-16 bg-[var(--mc-bg-shell,#f5f8fa)] text-[var(--mc-text,#33475b)] border-b border-[var(--mc-border,#cbd6e2)]'
+            : heroStyle === 'bold'
+              ? 'px-6 py-14 sm:px-10 sm:py-16 bg-[#1c1c1f] text-white'
+              : 'px-6 py-14 sm:px-10 sm:py-16 bg-gradient-to-br from-[var(--primary-color,#FF7A59)] to-[var(--secondary-color,#2797AF)] text-white'
+        }
+      >
+        <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>
 
       {showFeatureCards ? (
         <div className="mx-auto grid max-w-4xl gap-4 px-6 py-10 sm:grid-cols-3 sm:px-10">
@@ -41,7 +37,7 @@ export function StarterHome() {
               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>
+              <h2 className="text-sm font-semibold text-[var(--primary-color,#FF7A59)]">{feature.title}</h2>
               <p className="mt-2 text-sm leading-relaxed text-[#516f90]">{feature.body}</p>
             </article>
           ))}