@woodsportal/hubspot-kit 1.0.33 → 1.0.35

package/CHANGELOG.md

@@ -19,6 +19,18 @@
 - **CSS entries** — shared `tailwind.css.config.css`; documented never-merge rules on `main.dev.css` / `main.prod.css`
 - **`wp doctor`** — CSS pipeline checks (prefix, `.temp` @source, `skipRuntimeCss`, `module.css` dw utilities, CDN `require_css` warning)
 
+## 1.0.35 — 2026-06-08
+
+### Dev server
+- **Vite config load** — lazy-load kit plugins (defer `@babel/*` prefix plugin) so Node 22.18+ / 23.x do not crash with `getStatus` during config import; `wp doctor` warns on affected Node versions (Node 24 LTS recommended)
+- **Windows dev shims** — create `.wphs/.kit-module-config` via directory junction (or copy fallback) and bootstrap shims via copy when symlinks fail; fixes `jsxDEV` export errors from `react/jsx-dev-runtime`
+- **Vite dev** — pre-bundle React JSX runtimes and dedupe `react` / `react-dom`
+
+## 1.0.34 — 2026-06-08
+
+### Dev server
+- **`wp dev` / `wp local`** — spawn Vite via `node …/vite/bin/vite.js` (or `vite.cmd` on Windows) instead of `.bin/vite` shell shim; fixes `ENOENT` on Windows
+
 ## 1.0.33 — 2026-06-08
 
 ### Dev server

package/dist/cli.js

@@ -302,8 +302,8 @@ function defaultBaselineDir(projectRoot, config) {
 }
 
 // src/cli/commands/doctor.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
-import { join, resolve as resolve7 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
+import { join, resolve as resolve8 } from "path";
 
 // src/lib/cli-spinner.ts
 import * as p from "@clack/prompts";
@@ -797,6 +797,57 @@ function isUploadOnlyPreexistingProject(projectRoot, moduleArtifactDirs) {
   return moduleArtifactDirs.some((dir) => existsSync5(resolve6(dir, "fields.json")));
 }
 
+// src/vite/resolve-dev-config.ts
+import { existsSync as existsSync6 } from "fs";
+import { platform } from "os";
+import { resolve as resolve7 } from "path";
+var CONSUMER_DEV_CONFIG = "vite.config.dev.mjs";
+var VITE_JS_SEGMENTS = ["node_modules", "vite", "bin", "vite.js"];
+function resolveDevViteConfigPath(projectRoot) {
+  const consumerConfig = resolve7(projectRoot, CONSUMER_DEV_CONFIG);
+  if (existsSync6(consumerConfig)) {
+    return consumerConfig;
+  }
+  return kitPath("vite", "vite.config.dev.mjs");
+}
+function isProjectViteInstalled(projectRoot) {
+  return existsSync6(resolve7(projectRoot, ...VITE_JS_SEGMENTS));
+}
+function resolveProjectViteSpawn(projectRoot) {
+  const viteJs = resolve7(projectRoot, ...VITE_JS_SEGMENTS);
+  if (existsSync6(viteJs)) {
+    return { command: process.execPath, prefixArgs: [viteJs] };
+  }
+  const binDir = resolve7(projectRoot, "node_modules", ".bin");
+  if (platform() === "win32") {
+    const winCmd = resolve7(binDir, "vite.cmd");
+    if (existsSync6(winCmd)) {
+      return { command: winCmd, prefixArgs: [] };
+    }
+  }
+  const posixShim = resolve7(binDir, "vite");
+  if (existsSync6(posixShim)) {
+    return { command: posixShim, prefixArgs: [] };
+  }
+  return null;
+}
+function formatProjectViteSpawn(spawn2) {
+  return [spawn2.command, ...spawn2.prefixArgs].join(" ");
+}
+
+// src/lib/node-loader-interop.ts
+var NODE_LTS_RECOMMENDED = "24";
+function nodeLoaderInteropWarning() {
+  const [major, minor] = process.versions.node.split(".").map(Number);
+  if (major === 22 && minor >= 18) {
+    return `Node 22.18+ can fail loading Vite config (getStatus). Upgrade to Node ${NODE_LTS_RECOMMENDED} LTS or the latest Node 22 patch.`;
+  }
+  if (major === 23 && minor < 4) {
+    return `Node 23.0\u201323.3 can fail loading Vite config (getStatus). Upgrade to Node ${NODE_LTS_RECOMMENDED} LTS.`;
+  }
+  return null;
+}
+
 // src/cli/commands/doctor.ts
 function checkNode() {
   const major = Number(process.versions.node.split(".")[0]);
@@ -805,7 +856,7 @@ function checkNode() {
     name: "node",
     ok,
     message: ok ? `Node ${process.versions.node}` : `Node ${process.versions.node} (need >= 20)`,
-    remediation: ok ? void 0 : "Install Node 20 LTS or newer.",
+    remediation: ok ? void 0 : "Install Node 24 LTS (recommended) or Node 20 LTS.",
     severity: "error"
   };
 }
@@ -862,8 +913,8 @@ function checkConfig(ctx) {
 function checkEnvFiles(ctx) {
   return ctx.config.env.tiers.map((tier) => {
     const file = tier === "dev" ? ".env.dev" : tier === "stg" ? ".env.stg" : ".env.prod";
-    const path = resolve7(ctx.projectRoot, file);
-    const ok = existsSync6(path);
+    const path = resolve8(ctx.projectRoot, file);
+    const ok = existsSync7(path);
     return {
       name: `env-${tier}`,
       ok,
@@ -875,8 +926,8 @@ function checkEnvFiles(ctx) {
 }
 function checkLegacyBuildIdFile(ctx) {
   if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return null;
-  const legacy = resolve7(ctx.projectRoot, ".portal-build-id");
-  if (!existsSync6(legacy)) return null;
+  const legacy = resolve8(ctx.projectRoot, ".portal-build-id");
+  if (!existsSync7(legacy)) return null;
   return {
     name: "legacy-build-id",
     ok: false,
@@ -887,8 +938,8 @@ function checkLegacyBuildIdFile(ctx) {
 }
 function checkBuildId(ctx) {
   if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return null;
-  const file = resolve7(ctx.projectRoot, ctx.config.cdn.buildIdFile);
-  const ok = existsSync6(file);
+  const file = resolve8(ctx.projectRoot, ctx.config.cdn.buildIdFile);
+  const ok = existsSync7(file);
   return {
     name: "build-id",
     ok,
@@ -942,7 +993,7 @@ function checkDevSlug(ctx) {
   };
 }
 function isUploadOnlyProject(ctx) {
-  const moduleDirs = [resolve7(ctx.projectRoot, ctx.config.module.uploadPath)];
+  const moduleDirs = [resolve8(ctx.projectRoot, ctx.config.module.uploadPath)];
   return isUploadOnlyPreexistingProject(ctx.projectRoot, moduleDirs);
 }
 function checkUploadOnlyNote(ctx) {
@@ -956,8 +1007,8 @@ function checkUploadOnlyNote(ctx) {
   };
 }
 function checkDevViteConfig(ctx) {
-  const path = resolve7(ctx.projectRoot, "vite.config.dev.mjs");
-  const ok = existsSync6(path);
+  const path = resolve8(ctx.projectRoot, "vite.config.dev.mjs");
+  const ok = existsSync7(path);
   return {
     name: "vite-dev-config",
     ok,
@@ -968,8 +1019,8 @@ function checkDevViteConfig(ctx) {
 }
 function checkMetaJson(ctx) {
   if (isThemeProject(ctx.config)) return null;
-  const path = resolve7(ctx.projectRoot, "public/meta.json");
-  if (!existsSync6(path)) {
+  const path = resolve8(ctx.projectRoot, "public/meta.json");
+  if (!existsSync7(path)) {
     return {
       name: "meta-json",
       ok: false,
@@ -1001,8 +1052,8 @@ function checkMetaJson(ctx) {
 }
 async function checkCdnMirrorPublic(ctx) {
   if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return null;
-  const mirrorPath = resolve7(ctx.projectRoot, ctx.config.cdn?.mirror ?? "portal.cdn.json");
-  if (!existsSync6(mirrorPath)) {
+  const mirrorPath = resolve8(ctx.projectRoot, ctx.config.cdn?.mirror ?? "portal.cdn.json");
+  if (!existsSync7(mirrorPath)) {
     return {
       name: "cdn-mirror-public",
       ok: false,
@@ -1065,8 +1116,8 @@ async function checkCdnMirrorPublic(ctx) {
       severity: "warn"
     };
   }
-  const manifestPath = resolve7(ctx.projectRoot, "dist/cdn/manifest.json");
-  if (!existsSync6(manifestPath)) {
+  const manifestPath = resolve8(ctx.projectRoot, "dist/cdn/manifest.json");
+  if (!existsSync7(manifestPath)) {
     return {
       name: "cdn-mirror-public",
       ok: true,
@@ -1112,8 +1163,8 @@ async function checkCdnMirrorPublic(ctx) {
 }
 function checkFieldsJson(ctx) {
   if (isThemeProject(ctx.config)) return null;
-  const path = resolve7(ctx.projectRoot, "public/fields.json");
-  if (!existsSync6(path)) {
+  const path = resolve8(ctx.projectRoot, "public/fields.json");
+  if (!existsSync7(path)) {
     return {
       name: "fields-json",
       ok: false,
@@ -1153,8 +1204,8 @@ function checkFieldsJson(ctx) {
   }
 }
 function readProjectFile(projectRoot, relativePath) {
-  const path = resolve7(projectRoot, relativePath);
-  if (!existsSync6(path)) {
+  const path = resolve8(projectRoot, relativePath);
+  if (!existsSync7(path)) {
     return null;
   }
   return readFileSync5(path, "utf8");
@@ -1224,8 +1275,8 @@ function checkCssPipeline(ctx) {
   }
   const moduleOutDir = ctx.config.module?.outDir;
   if (moduleOutDir && usesCdnPipeline(ctx.config)) {
-    const moduleCssPath = resolve7(ctx.projectRoot, moduleOutDir, "module.css");
-    if (existsSync6(moduleCssPath)) {
+    const moduleCssPath = resolve8(ctx.projectRoot, moduleOutDir, "module.css");
+    if (existsSync7(moduleCssPath)) {
       const css = readFileSync5(moduleCssPath, "utf8");
       const hasDwUtilities = /dw\\:/.test(css) || /\.dw:/.test(css);
       checks.push({
@@ -1241,8 +1292,8 @@ function checkCssPipeline(ctx) {
 }
 function checkHybridModuleHtml(ctx) {
   if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return null;
-  const path = resolve7(ctx.projectRoot, "public/module.html");
-  if (!existsSync6(path)) {
+  const path = resolve8(ctx.projectRoot, "public/module.html");
+  if (!existsSync7(path)) {
     return {
       name: "module-html",
       ok: false,
@@ -1269,8 +1320,8 @@ function checkHybridModuleHtml(ctx) {
 function checkCdnViteConfigs(ctx) {
   if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return [];
   return ["vite.config.cdn-vendor.mjs", "vite.config.cdn-app.mjs"].map((file) => {
-    const path = resolve7(ctx.projectRoot, file);
-    const ok = existsSync6(path);
+    const path = resolve8(ctx.projectRoot, file);
+    const ok = existsSync7(path);
     return {
       name: file.replace(/\./g, "-"),
       ok,
@@ -1282,8 +1333,8 @@ function checkCdnViteConfigs(ctx) {
 }
 function checkDevEntry(ctx) {
   const checks = [];
-  const indexHtml = resolve7(ctx.projectRoot, "index.html");
-  const hasIndex = existsSync6(indexHtml);
+  const indexHtml = resolve8(ctx.projectRoot, "index.html");
+  const hasIndex = existsSync7(indexHtml);
   checks.push({
     name: "index-html",
     ok: hasIndex,
@@ -1291,8 +1342,8 @@ function checkDevEntry(ctx) {
     remediation: hasIndex ? void 0 : "Re-run wp init or copy index.html from kit templates",
     severity: "error"
   });
-  const localDev = resolve7(ctx.projectRoot, ctx.config.entries.localDev);
-  const hasEntry = existsSync6(localDev);
+  const localDev = resolve8(ctx.projectRoot, ctx.config.entries.localDev);
+  const hasEntry = existsSync7(localDev);
   checks.push({
     name: "local-dev-entry",
     ok: hasEntry,
@@ -1319,7 +1370,7 @@ function checkDevEntry(ctx) {
 }
 function checkKitScripts() {
   const script = kitPath("scripts", "build-cdn.mjs");
-  const ok = existsSync6(script);
+  const ok = existsSync7(script);
   return {
     name: "kit-scripts",
     ok,
@@ -1332,8 +1383,8 @@ function checkWphsWorkspace(ctx) {
   const workspace = ctx.config.dev.moduleConfigDir;
   const checks = [];
   for (const legacy of [".dev", ".woodsportal"]) {
-    const legacyPath = resolve7(ctx.projectRoot, legacy);
-    if (existsSync6(legacyPath)) {
+    const legacyPath = resolve8(ctx.projectRoot, legacy);
+    if (existsSync7(legacyPath)) {
       checks.push({
         name: `legacy-${legacy}`,
         ok: false,
@@ -1343,7 +1394,7 @@ function checkWphsWorkspace(ctx) {
       });
     }
   }
-  if (existsSync6(resolve7(ctx.projectRoot, ".wp-hs-baseline"))) {
+  if (existsSync7(resolve8(ctx.projectRoot, ".wp-hs-baseline"))) {
     checks.push({
       name: "legacy-baseline",
       ok: false,
@@ -1362,10 +1413,10 @@ function checkWphsWorkspace(ctx) {
     });
     return checks;
   }
-  const wphsRoot = resolve7(ctx.projectRoot, workspace);
+  const wphsRoot = resolve8(ctx.projectRoot, workspace);
   const required = ["config", "assets/branding", "fixtures", "cache", "audit/baseline", "state"];
   for (const sub of required) {
-    const ok = existsSync6(join(wphsRoot, sub));
+    const ok = existsSync7(join(wphsRoot, sub));
     checks.push({
       name: `wphs-${sub.replace(/\//g, "-")}`,
       ok,
@@ -1378,8 +1429,8 @@ function checkWphsWorkspace(ctx) {
 }
 function checkAdapter(ctx) {
   if (isThemeProject(ctx.config)) return null;
-  const adapterPath = resolve7(ctx.projectRoot, ctx.config.dev.adapter);
-  const ok = existsSync6(adapterPath);
+  const adapterPath = resolve8(ctx.projectRoot, ctx.config.dev.adapter);
+  const ok = existsSync7(adapterPath);
   return {
     name: "wphs-adapter",
     ok,
@@ -1390,8 +1441,8 @@ function checkAdapter(ctx) {
 }
 function checkModuleConfigUiDeps(ctx) {
   if (isThemeProject(ctx.config)) return [];
-  const pkgPath = resolve7(ctx.projectRoot, "package.json");
-  if (!existsSync6(pkgPath)) return [];
+  const pkgPath = resolve8(ctx.projectRoot, "package.json");
+  if (!existsSync7(pkgPath)) return [];
   let deps = {};
   try {
     const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
@@ -1410,12 +1461,21 @@ function checkModuleConfigUiDeps(ctx) {
     };
   });
 }
+function checkNodeLoaderInterop() {
+  const warning = nodeLoaderInteropWarning();
+  return {
+    name: "node-loader-interop",
+    ok: !warning,
+    message: warning ?? `Node ${process.versions.node} (Vite config load OK)`,
+    remediation: warning ?? void 0,
+    severity: "warn"
+  };
+}
 function checkViteInstalled(ctx) {
-  if (isThemeProject(ctx.config) && !existsSync6(resolve7(ctx.projectRoot, "vite.config.dev.mjs"))) {
+  if (isThemeProject(ctx.config) && !existsSync7(resolve8(ctx.projectRoot, "vite.config.dev.mjs"))) {
     return null;
   }
-  const localBin = resolve7(ctx.projectRoot, "node_modules", ".bin", "vite");
-  const ok = existsSync6(localBin);
+  const ok = isProjectViteInstalled(ctx.projectRoot);
   return {
     name: "vite",
     ok,
@@ -1444,7 +1504,7 @@ async function gatherDoctorChecks(ctx) {
     {
       title: "Checking Node, Vite, and kit scripts",
       task: async () => {
-        checks.push(checkNode(), checkKitScripts());
+        checks.push(checkNode(), checkNodeLoaderInterop(), checkKitScripts());
         const uploadOnlyNote = checkUploadOnlyNote(ctx);
         if (uploadOnlyNote) {
           checks.push(uploadOnlyNote);
@@ -1569,21 +1629,21 @@ async function runConfigValidate(ctx) {
 }
 
 // src/cli/commands/build.ts
-import { resolve as resolve9 } from "path";
+import { resolve as resolve10 } from "path";
 
 // src/lib/cli-banner.ts
 import pc3 from "picocolors";
 
 // src/lib/kit-version.ts
 import { readFileSync as readFileSync6 } from "fs";
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } from "path";
 var cachedVersion = null;
 function readKitVersion() {
   if (cachedVersion) {
     return cachedVersion;
   }
   try {
-    const pkg = JSON.parse(readFileSync6(resolve8(getKitRoot(), "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync6(resolve9(getKitRoot(), "package.json"), "utf8"));
     cachedVersion = pkg.version ?? "0.0.0";
   } catch {
     cachedVersion = "0.0.0";
@@ -1715,7 +1775,7 @@ function buildTasks(ctx, options, run) {
       title: `Building monolith module (${tier})`,
       task: async () => {
         await run("run-vite-build.mjs", [
-          resolve9(ctx.projectRoot, "vite.config.monolith.mjs"),
+          resolve10(ctx.projectRoot, "vite.config.monolith.mjs"),
           ...tierToStgFlag(tier)
         ]);
         await run("run-hubspot-module-postbuild.mjs");
@@ -1729,7 +1789,7 @@ function buildTasks(ctx, options, run) {
       task: async () => {
         if (options.cdnEsm) {
           await run("run-vite-build.mjs", [
-            resolve9(ctx.projectRoot, "vite.config.cdn-esm.mjs"),
+            resolve10(ctx.projectRoot, "vite.config.cdn-esm.mjs"),
             ...tierToStgFlag(tier)
           ]);
         } else {
@@ -1744,7 +1804,7 @@ function buildTasks(ctx, options, run) {
       title: `Building HubSpot module (${tier})`,
       task: async () => {
         await run("run-vite-build.mjs", [
-          resolve9(ctx.projectRoot, "vite.config.hubspot.mjs"),
+          resolve10(ctx.projectRoot, "vite.config.hubspot.mjs"),
           ...tierToStgFlag(tier)
         ]);
         await run("run-hubspot-module-postbuild.mjs");
@@ -1841,7 +1901,7 @@ async function runBuild(ctx, options) {
         command: "build",
         tier,
         ok: true,
-        outDir: resolve9(ctx.projectRoot, ctx.config.module.outDir)
+        outDir: resolve10(ctx.projectRoot, ctx.config.module.outDir)
       });
     } else if (!options.quiet) {
       printCommandDone(ctx, "Build complete");
@@ -1858,40 +1918,24 @@ async function runBuild(ctx, options) {
 import { existsSync as existsSync8 } from "fs";
 import { resolve as resolve11 } from "path";
 import { spawn } from "child_process";
-
-// src/vite/resolve-dev-config.ts
-import { existsSync as existsSync7 } from "fs";
-import { resolve as resolve10 } from "path";
-var CONSUMER_DEV_CONFIG = "vite.config.dev.mjs";
-function resolveDevViteConfigPath(projectRoot) {
-  const consumerConfig = resolve10(projectRoot, CONSUMER_DEV_CONFIG);
-  if (existsSync7(consumerConfig)) {
-    return consumerConfig;
-  }
-  return kitPath("vite", "vite.config.dev.mjs");
-}
-function resolveProjectViteBin(projectRoot) {
-  const localBin = resolve10(projectRoot, "node_modules", ".bin", "vite");
-  if (existsSync7(localBin)) {
-    return localBin;
-  }
-  return "vite";
-}
-
-// src/cli/commands/dev.ts
 async function runDev(ctx, options) {
   const port = options.port ?? 3e3;
+  const nodeWarning = nodeLoaderInteropWarning();
+  if (nodeWarning) {
+    ctx.logger.warn(nodeWarning);
+  }
   const env = {
     ...process.env,
     WP_HS_PROJECT_ROOT: ctx.projectRoot
   };
   const configPath = resolveDevViteConfigPath(ctx.projectRoot);
-  const viteBin = resolveProjectViteBin(ctx.projectRoot);
+  const viteSpawn = resolveProjectViteSpawn(ctx.projectRoot);
   if (ctx.global.dryRun) {
-    ctx.logger.info(`[dry-run] ${viteBin} --config ${configPath} --port ${port}`);
+    const dryRunTarget = viteSpawn ? formatProjectViteSpawn(viteSpawn) : "vite";
+    ctx.logger.info(`[dry-run] ${dryRunTarget} --config ${configPath} --port ${port}`);
     return ExitCode.SUCCESS;
   }
-  if (viteBin === "vite") {
+  if (!viteSpawn) {
     throw new WpHsError("vite is not installed in this project.", {
       exitCode: ExitCode.PREREQUISITE,
       remediation: "Run yarn install or npm install. If this is an older wp init project, add vite and peers to devDependencies (run wp init again or see @woodsportal/hubspot-kit templates)."
@@ -1911,8 +1955,16 @@ async function runDev(ctx, options) {
   });
   return new Promise((resolvePromise) => {
     const child = spawn(
-      viteBin,
-      ["--config", configPath, "--port", String(port), "--mode", "dev"],
+      viteSpawn.command,
+      [
+        ...viteSpawn.prefixArgs,
+        "--config",
+        configPath,
+        "--port",
+        String(port),
+        "--mode",
+        "dev"
+      ],
       {
         cwd: ctx.projectRoot,
         env,