@woodsportal/hubspot-kit 1.0.26 → 1.0.29

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   getViteConfigPath,
   kitPath,
   resolveProjectConfig
-} from "./chunk-U4KFGTEW.js";
+} from "./chunk-S2YJDWZU.js";
 
 // src/schema/woodsportal-hs.ts
 import { z } from "zod";
@@ -102,7 +102,7 @@ function loadConfig(projectRoot) {
   if (!resolved) {
     throw new WpHsError(`Missing ${WOODSCLI_CONFIG_FILE}`, {
       exitCode: ExitCode.USER_ERROR,
-      remediation: "Run wp init or wp adopt. Legacy woodsportal.hs.json \u2192 run wp migrate --yes."
+      remediation: "Run wp init. Legacy woodsportal.hs.json \u2192 run wp migrate --yes."
     });
   }
   let raw;

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 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. 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/dist/vite/index.js

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

package/examples/greenfield/module-hybrid-cdn/src/features/starter/content/woodscli-guide-content.ts

@@ -18,8 +18,8 @@ export const WOODSCLI_COMMANDS = [
     desc: 'Build, publish CDN artifacts, and upload the module to HubSpot.',
   },
   {
-    cmd: 'wp adopt',
-    desc: 'Add woodscli.json + .wphs/ to an existing module or theme repo.',
+    cmd: 'wp setup',
+    desc: 'Copy hubspot.config.yml, .env.*, and vite shims from kit templates.',
   },
   {
     cmd: 'wp migrate --yes',
@@ -58,7 +58,7 @@ export const DEV_WORKFLOW = [
   },
   {
     title: '4 · Ship',
-    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload. Advanced apps: wp adopt on woodsportal-client-frontend.',
+    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload.',
   },
 ] as const
 
@@ -81,6 +81,6 @@ export const STARTER_FEATURES = [
   },
   {
     title: 'Ship when ready',
-    body: 'Run wp build and wp deploy, or wp adopt to merge into the full WoodsPortal client app.',
+    body: 'Run wp build and wp deploy when your module is ready for HubSpot.',
   },
 ] as const

package/examples/greenfield/module-monolith/src/features/starter/content/woodscli-guide-content.ts

@@ -18,8 +18,8 @@ export const WOODSCLI_COMMANDS = [
     desc: 'Build, publish CDN artifacts, and upload the module to HubSpot.',
   },
   {
-    cmd: 'wp adopt',
-    desc: 'Add woodscli.json + .wphs/ to an existing module or theme repo.',
+    cmd: 'wp setup',
+    desc: 'Copy hubspot.config.yml, .env.*, and vite shims from kit templates.',
   },
   {
     cmd: 'wp migrate --yes',
@@ -58,7 +58,7 @@ export const DEV_WORKFLOW = [
   },
   {
     title: '4 · Ship',
-    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload. Advanced apps: wp adopt on woodsportal-client-frontend.',
+    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload.',
   },
 ] as const
 
@@ -81,6 +81,6 @@ export const STARTER_FEATURES = [
   },
   {
     title: 'Ship when ready',
-    body: 'Run wp build and wp deploy, or wp adopt to merge into the full WoodsPortal client app.',
+    body: 'Run wp build and wp deploy when your module is ready for HubSpot.',
   },
 ] as const

package/examples/smoke/run-matrix.mjs

@@ -55,7 +55,7 @@ function runStaticScenario(scenario) {
     if (layout.hasWphs || existsSync(join(root, '.wphs', 'config'))) {
       // ok
     } else if (scenario.setup === 'existing') {
-      // existing fixtures may lack .wphs until adopt
+      // existing fixtures may lack .wphs until wp setup
     } else if (scenario.setup === 'adopted') {
       throw new Error(`${scenario.id}: expected .wphs workspace`)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woodsportal/hubspot-kit",
-  "version": "1.0.26",
+  "version": "1.0.29",
   "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",

package/scripts/detect-layout.mjs

@@ -1,11 +1,36 @@
 /**
  * Detect HubSpot CMS project layout (module vs theme, adopted vs existing).
  */
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
 import { join, resolve } from 'node:path'
 
 import { resolveProjectConfigPath } from './config-files.mjs'
 
+/**
+ * HubSpot custom modules must live in a directory whose name ends with `.module`.
+ * @param {string} root
+ * @returns {string[]}
+ */
+function hubspotModuleArtifactDirs(root) {
+  const dirs = []
+  const base = resolve(root)
+
+  if (base.endsWith('.module') && existsSync(base)) {
+    dirs.push(base)
+    return dirs
+  }
+
+  if (!existsSync(base)) return dirs
+
+  for (const entry of readdirSync(base, { withFileTypes: true })) {
+    if (entry.isDirectory() && entry.name.endsWith('.module')) {
+      dirs.push(join(base, entry.name))
+    }
+  }
+
+  return dirs
+}
+
 /**
  * @param {string} projectRoot
  */
@@ -23,12 +48,26 @@ export function detectProjectLayout(projectRoot) {
     }
   }
 
+  const moduleArtifactDirs = hubspotModuleArtifactDirs(root)
+
   const fieldsJsonPaths = [
+    ...moduleArtifactDirs.map((dir) => join(dir, 'fields.json')),
+    join(root, 'fields.json'),
     join(root, 'public/fields.json'),
     join(root, config?.dev?.fieldsJson ?? 'public/fields.json'),
   ].filter((p, i, arr) => arr.indexOf(p) === i)
 
-  const moduleHtmlPaths = [join(root, 'public/module.html'), join(root, 'module.html')]
+  const moduleHtmlPaths = [
+    ...moduleArtifactDirs.map((dir) => join(dir, 'module.html')),
+    join(root, 'module.html'),
+    join(root, 'public/module.html'),
+  ]
+
+  const moduleJsPaths = [
+    ...moduleArtifactDirs.map((dir) => join(dir, 'module.js')),
+    join(root, 'module.js'),
+    join(root, 'public/module.js'),
+  ]
 
   const themeJsonPaths = [
     join(root, config?.theme?.themeJson ?? 'src/theme/theme.json'),
@@ -38,6 +77,25 @@ export function detectProjectLayout(projectRoot) {
 
   const hasFieldsJson = fieldsJsonPaths.some((p) => existsSync(p))
   const hasModuleHtml = moduleHtmlPaths.some((p) => existsSync(p))
+  const hasModuleJs = moduleJsPaths.some((p) => existsSync(p))
+  const hasModuleCss =
+    moduleArtifactDirs.some((dir) => existsSync(join(dir, 'module.css'))) ||
+    existsSync(join(root, 'module.css')) ||
+    existsSync(join(root, 'public/module.css'))
+  const hasMetaJson =
+    moduleArtifactDirs.some((dir) => existsSync(join(dir, 'meta.json'))) ||
+    existsSync(join(root, 'meta.json'))
+
+  /** HubSpot upload folder: `<name>.module/` with fields + html/js (+ css, meta.json); no src/ */
+  const isPreexistingModuleArtifacts =
+    moduleArtifactDirs.length > 0 &&
+    moduleArtifactDirs.some(
+      (dir) =>
+        existsSync(join(dir, 'fields.json')) &&
+        (existsSync(join(dir, 'module.html')) || existsSync(join(dir, 'module.js'))),
+    ) &&
+    !existsSync(join(root, 'src'))
+
   const hasThemeJson = themeJsonPaths.some((p) => existsSync(p))
   const hasTemplates =
     existsSync(join(root, 'src/theme/templates')) || existsSync(join(root, 'templates'))
@@ -47,12 +105,16 @@ export function detectProjectLayout(projectRoot) {
 
   let track = 'unknown'
   if (hasThemeJson || hasTemplates) track = 'theme'
-  else if (hasFieldsJson || hasModuleHtml) track = 'module'
+  else if (hasFieldsJson || hasModuleHtml || hasModuleJs || moduleArtifactDirs.length > 0) {
+    track = 'module'
+  }
 
   let setup = 'existing'
   if (hasConfig && hasWphs) setup = 'adopted'
   else if (hasConfig && !hasWphs) setup = 'partial'
-  else if (!hasConfig && (hasFieldsJson || hasThemeJson)) setup = 'existing'
+  else if (!hasConfig && (hasFieldsJson || hasThemeJson || isPreexistingModuleArtifacts)) {
+    setup = isPreexistingModuleArtifacts ? 'preexisting-module' : 'existing'
+  }
 
   return {
     projectRoot: root,
@@ -62,6 +124,11 @@ export function detectProjectLayout(projectRoot) {
     hasWphs,
     hasFieldsJson,
     hasModuleHtml,
+    hasModuleJs,
+    hasModuleCss,
+    hasMetaJson,
+    moduleArtifactDirs,
+    isPreexistingModuleArtifacts,
     hasThemeJson,
     hasTemplates,
     projectType: config?.projectType ?? null,

package/scripts/run-hubspot-module-postbuild.mjs

@@ -3,19 +3,42 @@
  * HubSpot module post-build runner — invoked after `vite build` completes.
  * Kept separate from Vite closeBundle to avoid hook-order races on CI.
  */
-import { fileURLToPath } from 'node:url'
-import { resolve } from 'node:path'
+import { existsSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
 
 import { finalizeHubSpotModuleDist } from './hubspot-module-postbuild.mjs'
 import { moduleOutDir, readWoodsportalConfig } from './read-woodsportal-config.mjs'
 
+/**
+ * Postbuild copies fields.json + module.html from public/ by default.
+ * Upload-only layouts may keep them under dev.fieldsJson (e.g. `<name>.module/`).
+ * @param {string} root
+ * @param {import('./read-woodsportal-config.mjs').readWoodsportalConfig extends Function ? ReturnType<import('./read-woodsportal-config.mjs').readWoodsportalConfig>['config'] : unknown} config
+ */
+function resolveModulePublicDir(root, config) {
+  const publicDir = resolve(root, 'public')
+  if (existsSync(resolve(publicDir, 'fields.json'))) {
+    return publicDir
+  }
+
+  const fieldsJson = config?.dev?.fieldsJson
+  if (fieldsJson) {
+    const parent = resolve(root, dirname(fieldsJson))
+    if (existsSync(resolve(parent, 'fields.json'))) {
+      return parent
+    }
+  }
+
+  return publicDir
+}
+
 const { root, config } = readWoodsportalConfig()
 /** Hybrid CDN thin bootstrap only — monolith ships the full app in module.js. */
 const bootstrapRawLimit = config?.projectType === 'module-monolith' ? null : 200 * 1024
 
 const { jsBytes, cssBytes } = finalizeHubSpotModuleDist(
   moduleOutDir(root),
-  resolve(root, 'public'),
+  resolveModulePublicDir(root, config),
   { bootstrapRawLimit },
 )
 

package/templates/module-hybrid-cdn/src/features/starter/content/woodscli-guide-content.ts

@@ -18,8 +18,8 @@ export const WOODSCLI_COMMANDS = [
     desc: 'Build, publish CDN artifacts, and upload the module to HubSpot.',
   },
   {
-    cmd: 'wp adopt',
-    desc: 'Add woodscli.json + .wphs/ to an existing module or theme repo.',
+    cmd: 'wp setup',
+    desc: 'Copy hubspot.config.yml, .env.*, and vite shims from kit templates.',
   },
   {
     cmd: 'wp migrate --yes',
@@ -58,7 +58,7 @@ export const DEV_WORKFLOW = [
   },
   {
     title: '4 · Ship',
-    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload. Advanced apps: wp adopt on woodsportal-client-frontend.',
+    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload.',
   },
 ] as const
 
@@ -81,6 +81,6 @@ export const STARTER_FEATURES = [
   },
   {
     title: 'Ship when ready',
-    body: 'Run wp build and wp deploy, or wp adopt to merge into the full WoodsPortal client app.',
+    body: 'Run wp build and wp deploy when your module is ready for HubSpot.',
   },
 ] as const

package/templates/module-monolith/src/features/starter/content/woodscli-guide-content.ts

@@ -18,8 +18,8 @@ export const WOODSCLI_COMMANDS = [
     desc: 'Build, publish CDN artifacts, and upload the module to HubSpot.',
   },
   {
-    cmd: 'wp adopt',
-    desc: 'Add woodscli.json + .wphs/ to an existing module or theme repo.',
+    cmd: 'wp setup',
+    desc: 'Copy hubspot.config.yml, .env.*, and vite shims from kit templates.',
   },
   {
     cmd: 'wp migrate --yes',
@@ -58,7 +58,7 @@ export const DEV_WORKFLOW = [
   },
   {
     title: '4 · Ship',
-    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload. Advanced apps: wp adopt on woodsportal-client-frontend.',
+    body: 'Hybrid CDN: wp deploy. Monolith: wp build --hubspot-only then wp upload.',
   },
 ] as const
 
@@ -81,6 +81,6 @@ export const STARTER_FEATURES = [
   },
   {
     title: 'Ship when ready',
-    body: 'Run wp build and wp deploy, or wp adopt to merge into the full WoodsPortal client app.',
+    body: 'Run wp build and wp deploy when your module is ready for HubSpot.',
   },
 ] as const

package/dist/chunk-U4KFGTEW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/paths.ts","../src/lib/config-files.ts","../src/lib/errors.ts","../src/vite/paths.ts","../src/vite/create-vite-config.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { findProjectRoot as findConfigProjectRoot } from './config-files.js'\nimport { WpHsError, ExitCode } from './errors.js'\n\nconst KIT_PACKAGE_NAME = '@woodsportal/hubspot-kit'\n\nfunction resolveKitRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  while (true) {\n    const pkgPath = resolve(dir, 'package.json')\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as { name?: string }\n        if (pkg.name === KIT_PACKAGE_NAME) {\n          return dir\n        }\n      } catch {\n        // keep walking\n      }\n    }\n    const parent = dirname(dir)\n    if (parent === dir) {\n      break\n    }\n    dir = parent\n  }\n\n  throw new WpHsError('Could not resolve @woodsportal/hubspot-kit package root.', {\n    exitCode: ExitCode.INTERNAL,\n  })\n}\n\nconst kitRoot = resolveKitRoot()\n\nexport function getKitRoot(): string {\n  return kitRoot\n}\n\nexport function findProjectRoot(from = process.cwd()): string {\n  const root = findConfigProjectRoot(from)\n  if (!root) {\n    throw new WpHsError('Could not find woodscli.json in this directory or any parent.', {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp init, wp adopt, or pass --project <path>. Legacy config: wp migrate --yes.',\n    })\n  }\n  return root\n}\n\nexport function kitPath(...segments: string[]): string {\n  return resolve(kitRoot, ...segments)\n}\n\nexport { resolveProjectConfig, WOODSCLI_CONFIG_FILE, LEGACY_WOODSPORTAL_HS_FILE } from './config-files.js'\n","import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\n/** Canonical WoodsCLI project config — the only supported filename. */\nexport const WOODSCLI_CONFIG_FILE = 'woodscli.json'\n\n/** Removed in v1.0.2+ — detected only for migrate/doctor messaging. */\nexport const LEGACY_WOODSPORTAL_HS_FILE = 'woodsportal.hs.json'\n\nexport type ResolvedProjectConfig = {\n  path: string\n  fileName: typeof WOODSCLI_CONFIG_FILE\n}\n\nfunction envConfigPath(projectRoot: string): string | null {\n  const fromEnv = process.env.WOODSCLI_CONFIG?.trim() || process.env.WP_HS_CONFIG?.trim() || null\n  if (!fromEnv) return null\n  return resolve(projectRoot, fromEnv)\n}\n\nexport function legacyConfigPath(projectRoot: string): string {\n  return resolve(projectRoot, LEGACY_WOODSPORTAL_HS_FILE)\n}\n\nexport function woodscliConfigPath(projectRoot: string): string {\n  return resolve(projectRoot, WOODSCLI_CONFIG_FILE)\n}\n\n/** @returns null | 'legacy-only' | 'duplicate' */\nexport function legacyConfigConflict(projectRoot: string): 'legacy-only' | 'duplicate' | null {\n  const hasWoodscli = existsSync(woodscliConfigPath(projectRoot))\n  const hasLegacy = existsSync(legacyConfigPath(projectRoot))\n  if (hasLegacy && hasWoodscli) return 'duplicate'\n  if (hasLegacy && !hasWoodscli) return 'legacy-only'\n  return null\n}\n\n/**\n * Resolve the active project config file (`woodscli.json` only).\n */\nexport function resolveProjectConfig(projectRoot: string): ResolvedProjectConfig | null {\n  const envPath = envConfigPath(projectRoot)\n  if (envPath) {\n    if (!existsSync(envPath)) return null\n    return { path: envPath, fileName: WOODSCLI_CONFIG_FILE }\n  }\n\n  const path = woodscliConfigPath(projectRoot)\n  if (existsSync(path)) {\n    return { path, fileName: WOODSCLI_CONFIG_FILE }\n  }\n\n  return null\n}\n\nexport function findProjectRoot(from = process.cwd()): string | null {\n  if (process.env.WP_HS_PROJECT_ROOT?.trim()) {\n    return resolve(process.env.WP_HS_PROJECT_ROOT.trim())\n  }\n\n  let dir = resolve(from)\n  while (true) {\n    if (resolveProjectConfig(dir)) {\n      return dir\n    }\n    const parent = resolve(dir, '..')\n    if (parent === dir) {\n      return null\n    }\n    dir = parent\n  }\n}\n","export const ExitCode = {\n  SUCCESS: 0,\n  USER_ERROR: 1,\n  PREREQUISITE: 2,\n  BUILD_FAILED: 3,\n  PUBLISH_FAILED: 4,\n  AUDIT_FAILED: 5,\n  INTERNAL: 10,\n} as const\n\nexport type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode]\n\nexport class WpHsError extends Error {\n  readonly exitCode: ExitCodeValue\n  readonly remediation?: string\n\n  constructor(\n    message: string,\n    options: { exitCode?: ExitCodeValue; remediation?: string; cause?: unknown } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'WpHsError'\n    this.exitCode = options.exitCode ?? ExitCode.USER_ERROR\n    this.remediation = options.remediation\n  }\n}\n\nexport function isWpHsError(error: unknown): error is WpHsError {\n  return error instanceof WpHsError\n}\n","import { kitPath } from '../lib/paths.js'\n\nexport type VitePreset = 'dev' | 'hubspot' | 'cdn-vendor' | 'cdn-app' | 'cdn-esm'\n\nexport function getViteConfigPath(preset: VitePreset): string {\n  return kitPath('vite', `vite.config.${preset}.mjs`)\n}\n","import { getViteConfigPath, type VitePreset } from './paths.js'\n\nexport type CreateViteConfigOptions = {\n  /** Vite preset shipped with @woodsportal/hubspot-kit */\n  preset: VitePreset\n  /** Consumer project root (sets WP_HS_PROJECT_ROOT for kit scripts) */\n  projectRoot?: string\n}\n\n/**\n * Returns the absolute path to a kit Vite config preset.\n * Consumer repos typically re-export: `export { default } from '@woodsportal/hubspot-kit/vite/vite.config.hubspot.mjs'`\n * or use this helper in a thin wrapper config.\n */\nexport function createViteConfig(\n  presetOrOptions: VitePreset | CreateViteConfigOptions,\n): string {\n  const options: CreateViteConfigOptions =\n    typeof presetOrOptions === 'string' ? { preset: presetOrOptions } : presetOrOptions\n\n  if (options.projectRoot?.trim()) {\n    process.env.WP_HS_PROJECT_ROOT = options.projectRoot.trim()\n  }\n\n  return getViteConfigPath(options.preset)\n}\n"],"mappings":"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","names":["existsSync","resolve","resolve","existsSync","findProjectRoot"]}