@powerhousedao/builder-tools 6.2.3-dev.60 → 6.2.3-dev.62

package/dist/index.mjs

@@ -1,14 +1,17 @@
 import { createRequire } from "node:module";
-import { createHash, randomUUID } from "node:crypto";
-import fs, { chmodSync, createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
-import path, { dirname, extname, isAbsolute, join, resolve } from "node:path";
+import fs, { chmodSync, cpSync, createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import path, { dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { exec, execSync, spawn } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { cwd } from "node:process";
+import { createHash, randomUUID } from "node:crypto";
+import { Generator, getConfig } from "@tanstack/router-generator";
+import { tanstackRouter } from "@tanstack/router-plugin/vite";
+import { layout, physical, rootRoute } from "@tanstack/virtual-file-routes";
 import { fileURLToPath } from "node:url";
 import { DYNAMIC_BASE_PLACEHOLDER, PWA_FILE_HANDLER_ACTION, buildRuntimeConfig, deepMerge, loadConnectEnv, mergeManifest, mergePwaConfig, normalizeBasePath, phConnectRuntimeConfigSchema, powerhousePackageSchema, resolveSourceConnect, setConnectEnv, unionStrings, withInferredCategory, workerPackageFileName, workflowsSettingConflict } from "@powerhousedao/shared/connect";
 import MagicString from "magic-string";
-import { readFile, writeFile } from "node:fs/promises";
-import { cwd } from "node:process";
-import { getConfig } from "@powerhousedao/config/node";
+import { getConfig as getConfig$1 } from "@powerhousedao/config/node";
 import tailwind from "@tailwindcss/vite";
 import react from "@vitejs/plugin-react";
 import { createLogger, esmExternalRequirePlugin, loadEnv, searchForWorkspaceRoot } from "vite";
@@ -22,6 +25,254 @@ const IMPORT_SCRIPT_FILE = "external-packages.js";
 const LOCAL_PACKAGE_ID = "ph:local-package";
 const PH_DIR_NAME = ".ph";
 //#endregion
+//#region connect-utils/helpers.ts
+const DEFAULT_CONNECT_OUTDIR = ".ph/connect-build/dist/";
+function resolveViteConfigPath(options) {
+	const { projectRoot = cwd(), viteConfigFile } = options;
+	return viteConfigFile || join(projectRoot, "vite.config.ts");
+}
+function resolvePackage(packageName, root = process.cwd()) {
+	return createRequire(root).resolve(packageName, { paths: [root] });
+}
+function resolveConnectPackageJson(root = process.cwd()) {
+	try {
+		const connectPackageJsonPath = resolvePackage("@powerhousedao/connect/package.json", root);
+		const fileContents = fs.readFileSync(connectPackageJsonPath, "utf-8");
+		return JSON.parse(fileContents);
+	} catch (error) {
+		console.error(`Error reading Connect package.json:`, error);
+		return null;
+	}
+}
+/**
+* Finds the dist dir of Connect on the local machine
+*/
+function resolveConnectBundle(root = process.cwd()) {
+	const connectIndexPath = resolvePackage("@powerhousedao/connect", root);
+	const connectRootPath = connectIndexPath.substring(0, connectIndexPath.indexOf("connect") + 7);
+	return join(connectRootPath, "dist/");
+}
+function resolveConnectPublicDir(root = process.cwd()) {
+	const connectIconPath = resolvePackage("@powerhousedao/connect/public/icon.ico", root);
+	return path.join(connectIconPath, "../");
+}
+/**
+* Copies the Connect dist dir to the target path
+*/
+function copyConnect(sourcePath, targetPath) {
+	try {
+		fs.rmSync(targetPath, {
+			recursive: true,
+			force: true
+		});
+		fs.cpSync(sourcePath, targetPath, { recursive: true });
+	} catch (error) {
+		console.error(`❌ Error copying ${sourcePath} to ${targetPath}:`, error);
+	}
+}
+/**
+* Backs up the index.html file
+*
+* Needed when running the Connect Studio dev server on Windows
+*/
+function backupIndexHtml(appPath, restore = false) {
+	const filePath = join(appPath, "index.html");
+	const backupPath = join(appPath, "index.html.bak");
+	const paths = restore ? [backupPath, filePath] : [filePath, backupPath];
+	if (fs.existsSync(paths[0])) fs.copyFileSync(paths[0], paths[1]);
+}
+function removeBase64EnvValues(appPath) {
+	backupIndexHtml(appPath);
+	const filePath = join(appPath, "index.html");
+	fs.readFile(filePath, "utf-8", (err, data) => {
+		if (err) {
+			console.error("Error reading file:", err);
+			return;
+		}
+		const modifiedData = data.replace(/"LOCAL_DOCUMENT_MODELS":\s*".*?",/, `"LOCAL_DOCUMENT_MODELS": "",`).replace(/"LOCAL_DOCUMENT_EDITORS":\s*".*?"/, `"LOCAL_DOCUMENT_EDITORS": ""`);
+		console.log("Modified data:", modifiedData);
+		fs.writeFile(filePath, modifiedData, "utf-8", (err) => {
+			if (err) {
+				console.error("Error writing file:", err);
+				return;
+			}
+		});
+	});
+}
+function readJsonFile(filePath) {
+	try {
+		const absolutePath = resolve(filePath);
+		const fileContents = fs.readFileSync(absolutePath, "utf-8");
+		return JSON.parse(fileContents);
+	} catch (_error) {
+		console.error(`Error reading file: ${filePath}`);
+		return null;
+	}
+}
+/**
+* Takes a list of Powerhouse project packages and optionally local Powerhouse packages and outputs a js file which exports those packages for use in Connect Studio.
+*/
+function makeImportScriptFromPackages(args) {
+	const { packages, localJsPath, localCssPath, importStyles = true } = args;
+	const imports = [];
+	const moduleNames = [];
+	let counter = 0;
+	for (const packageName of packages) {
+		const moduleName = `module${counter}`;
+		moduleNames.push(moduleName);
+		imports.push(`import * as ${moduleName} from '${packageName}';`);
+		if (importStyles) imports.push(`import '${packageName}/style.css';`);
+		counter++;
+	}
+	const exports = moduleNames.map((name, index) => `{
+      id: "${packages[index]}",
+      ...${name},
+    }`);
+	const hasModule = localJsPath !== void 0;
+	const hasStyles = importStyles && localCssPath !== void 0;
+	if (hasModule || hasStyles) {
+		if (hasStyles) imports.push(`import '${localCssPath}';`);
+		if (hasModule) {
+			const moduleName = `module${counter}`;
+			imports.push(`import * as ${moduleName} from '${localJsPath}';`);
+			exports.push(`{
+        id: "${LOCAL_PACKAGE_ID}",
+        ...${moduleName},
+      }`);
+		}
+	}
+	const exportStatement = `export default [${exports.length ? `
+        ${exports.join(",\n")}
+    ` : ""}];`;
+	return `${imports.join("\n")}\n\n${exportStatement}`;
+}
+function ensureNodeVersion(minVersion = "24") {
+	const version = process.versions.node;
+	if (!version) return;
+	if (version < minVersion) {
+		console.error(`Node version ${minVersion} or higher is required. Current version: ${version}`);
+		process.exit(1);
+	}
+}
+function runShellScriptPlugin(scriptName, connectPath) {
+	return {
+		name: "vite-plugin-run-shell-script",
+		buildStart() {
+			const scriptPath = join(connectPath, scriptName);
+			if (fs.existsSync(scriptPath)) exec(`sh ${scriptPath}`, (error, stdout, stderr) => {
+				if (error) {
+					console.error(`Error executing the script: ${error.message}`);
+					removeBase64EnvValues(connectPath);
+					return;
+				}
+				if (stderr) console.error(stderr);
+			});
+		}
+	};
+}
+/**
+* Shared helper to modify the <head> tag of an HTML file by transforming its contents.
+*/
+async function modifyHtmlHead(pathToHtml, contents, transform) {
+	if (!existsSync(pathToHtml)) throw new Error(`File ${pathToHtml} does not exist.`);
+	let html = await readFile(pathToHtml, "utf8");
+	html = transform(html, contents);
+	await writeFile(pathToHtml, html, "utf8");
+}
+/**
+* Appends the contents to the <head> tag of the index.html file
+*/
+async function appendToHtmlHead(pathToHtml, contents) {
+	return modifyHtmlHead(pathToHtml, contents, (html, contents) => {
+		if (!html.includes("</head>")) throw new Error("No </head> tag found in the HTML file.");
+		return html.replace("</head>", `\n${contents}\n</head>`);
+	});
+}
+/**
+* Prepends the contents to the <head> tag of the index.html file
+*/
+async function prependToHtmlHead(pathToHtml, contents) {
+	return modifyHtmlHead(pathToHtml, contents, (html, contents) => {
+		if (!html.includes("</head>")) throw new Error("No </head> tag found in the HTML file.");
+		return html.replace("<head>", `<head>\n${contents}\n`);
+	});
+}
+function runTsc(outDir) {
+	execSync(`npx tsc --outDir ${outDir}`, { stdio: "inherit" });
+}
+function stripVersionFromPackage(packageName) {
+	const trimmed = packageName.trim();
+	if (!trimmed) return "";
+	const lastAtIndex = trimmed.lastIndexOf("@");
+	if (lastAtIndex > 0) return trimmed.substring(0, lastAtIndex);
+	return trimmed;
+}
+//#endregion
+//#region connect-utils/vite-plugins/app-shell.ts
+/** On the prerendered shell's elements; marks an index.html that has it. */
+const APP_SHELL_MARKER = "data-ph-shell";
+/** The shell Connect's build prerendered, if the installed Connect ships one. */
+function readAppShell(projectRoot) {
+	let distDir;
+	try {
+		distDir = join(dirname(resolvePackage("@powerhousedao/connect/package.json", projectRoot)), "dist");
+	} catch {
+		return;
+	}
+	const body = join(distDir, "shell.html");
+	const head = join(distDir, "shell-head.html");
+	if (!existsSync(body) || !existsSync(head)) return void 0;
+	return {
+		body: readFileSync(body, "utf8"),
+		head: readFileSync(head, "utf8")
+	};
+}
+/** On the boot-recovery script; its sessionStorage key guards against reload loops. */
+const BOOT_RECOVER_MARKER = "data-ph-boot-recover";
+const BOOT_RECOVER_KEY = "ph:sw-recover";
+const BOOT_RECOVER_SCRIPT = `(function(){try{var K='${BOOT_RECOVER_KEY}',n=navigator.serviceWorker,done=0;if(!n||sessionStorage.getItem(K))return;var up=function(){return !document.querySelector('style[${APP_SHELL_MARKER}]')};var reload=function(){location.reload()};var skip=function(w){try{sessionStorage.setItem(K,'1')}catch(e){}n.addEventListener('controllerchange',reload);w.postMessage({type:'SKIP_WAITING'});setTimeout(reload,3000)};var watch=function(w){w.addEventListener('statechange',function(){if(w.state==='installed')skip(w)})};var go=function(){if(done||up())return;done=1;n.getRegistration().then(function(r){if(!r)return;if(r.waiting)return skip(r.waiting);if(r.installing)return watch(r.installing);r.addEventListener('updatefound',function(){if(r.installing)watch(r.installing)});return r.update()}).catch(function(){})};addEventListener('error',function(e){var t=e.target;if(e.error instanceof SyntaxError||e.error instanceof TypeError||(t&&t.tagName==='SCRIPT'))go()},true);addEventListener('unhandledrejection',function(e){if(e.reason instanceof SyntaxError||e.reason instanceof TypeError)go()});setTimeout(go,8000)}catch(e){}})();`;
+/** Prefixes the shell's root-relative links with the deploy base. */
+function rebaseShellLinks(body, base) {
+	if (base === "/" || !base) return body;
+	const prefix = base.endsWith("/") ? base : `${base}/`;
+	return body.replace(/(\shref=")\/(?!\/)/g, `$1${prefix}`);
+}
+const STYLESHEET_LINK = /<link\b(?=[^>]*\brel=["']?stylesheet\b)[^>]*>/gi;
+function deferStylesheet(link) {
+	return `${link.replace(/\brel=["']?stylesheet["']?/i, "rel=\"preload\" as=\"style\"").replace(/\/?>$/, ` onload="this.onload=null;this.rel='stylesheet'">`)}<noscript>${link}</noscript>`;
+}
+/** Inlines `shell` into an empty `#root`, adds its critical CSS and defers the
+* stylesheets; React replaces the markup when the app renders. */
+function injectAppShell(html, shell, base = "/") {
+	if (html.includes("data-ph-shell")) return html;
+	const root = /<div id="root"><\/div>/;
+	if (!root.test(html)) return html;
+	const firstSheet = html.search(STYLESHEET_LINK);
+	const at = firstSheet >= 0 ? firstSheet : html.indexOf("</head>");
+	const recover = `<script ${BOOT_RECOVER_MARKER}>${BOOT_RECOVER_SCRIPT}<\/script>`;
+	const body = rebaseShellLinks(shell.body, base);
+	return (html.slice(0, at) + shell.head + recover + html.slice(at)).replace(STYLESHEET_LINK, deferStylesheet).replace(root, () => `<div id="root">${body}</div>`);
+}
+/** Build only: dev keeps the empty root and blocking CSS for HMR. */
+function connectAppShellPlugin(projectRoot) {
+	let shell;
+	let base = "/";
+	return {
+		name: "ph-connect-app-shell",
+		apply: "build",
+		configResolved(config) {
+			base = config.base;
+		},
+		buildStart() {
+			shell = readAppShell(projectRoot);
+		},
+		transformIndexHtml: {
+			order: "post",
+			handler: (html) => shell ? injectAppShell(html, shell, base) : html
+		}
+	};
+}
+//#endregion
 //#region connect-utils/vite-plugins/build-hash.ts
 /** Name of the build-identity file emitted into the build output. */
 const BUILD_HASH_FILE = "build-hash.json";
@@ -90,6 +341,152 @@ function connectBuildHashPlugin(buildHash) {
 	};
 }
 //#endregion
+//#region connect-utils/vite-plugins/connect-routes.ts
+/** A project's routes for its Connect deployment, beside Connect's own. */
+const HOST_ROUTES_DIR = "hosts/connect/routes";
+/** The generated tree of Connect's and the project's routes. */
+const CONNECT_ROUTES_GEN = ".ph/connect-routes.gen.ts";
+/** Connect's dist imports its route tree by this specifier. */
+const ROUTE_TREE_SPECIFIER = "@powerhousedao/connect/route-tree";
+/** The project's routes folder, `hosts/connect/routes/`; undefined if none. */
+function resolveConnectRoutesDir(projectRoot) {
+	const dir = join(projectRoot, HOST_ROUTES_DIR);
+	return existsSync(dir) ? dir : void 0;
+}
+/** Connect's pathless sidebar layout; a project's routes in `_app/` render in it. */
+const APP_LAYOUT = "_app";
+function findRouteFile(dir, name) {
+	return [
+		".tsx",
+		".ts",
+		".jsx",
+		".js"
+	].map((ext) => join(dir, `${name}${ext}`)).find((file) => existsSync(file));
+}
+/** The router plugin's config: Connect's root, its core routes and the project's. */
+function connectRoutesGeneratorConfig(connectDir, projectRoot, projectRoutes) {
+	const routesDirectory = join(connectDir, "src/routes");
+	const fromRoutes = (path) => relative(routesDirectory, path);
+	const appLayout = findRouteFile(projectRoutes, APP_LAYOUT);
+	const appRoutes = join(projectRoutes, APP_LAYOUT);
+	return getConfig({
+		target: "react",
+		routesDirectory,
+		generatedRouteTree: join(projectRoot, CONNECT_ROUTES_GEN),
+		virtualRouteConfig: rootRoute("__root.tsx", [layout(APP_LAYOUT, appLayout ? fromRoutes(appLayout) : `core/${APP_LAYOUT}.tsx`, [physical("", `core/${APP_LAYOUT}`), ...existsSync(appRoutes) ? [physical("", fromRoutes(appRoutes))] : []]), physical("", fromRoutes(projectRoutes))]),
+		routeFileIgnorePattern: `^${APP_LAYOUT}(\\.[cm]?[jt]sx?)?$`,
+		quoteStyle: "double",
+		semicolons: true,
+		addExtensions: "js",
+		autoCodeSplitting: true,
+		disableLogging: true,
+		routeTreeFileFooter: [
+			"import type { ConnectRouterFor } from \"@powerhousedao/connect/router\";",
+			"declare module \"@tanstack/react-router\" {",
+			"  interface Register {",
+			"    router: ConnectRouterFor<typeof routeTree>;",
+			"  }",
+			"}"
+		]
+	}, projectRoot);
+}
+/** Writes the route tree of Connect's and the project's routes; throws on a
+* collision with a core route, which the router plugin would only log. */
+async function generateConnectRoutes(projectRoot, routesDir, config = connectRoutesGeneratorConfig(connectDirOf(projectRoot), projectRoot, routesDir)) {
+	mkdirSync(dirname(config.generatedRouteTree), { recursive: true });
+	try {
+		await new Generator({
+			config,
+			root: projectRoot
+		}).run();
+		assertNoDuplicateRoutes(config.generatedRouteTree);
+		importCoreRoutesByPackage(config.generatedRouteTree, config.routesDirectory);
+	} catch (error) {
+		const message = (Array.isArray(error) ? error : [error]).map((e) => e instanceof Error ? e.message : String(e)).join("\n");
+		const shown = relative(projectRoot, routesDir).split(sep).join("/");
+		throw new Error(`Connect could not mount the routes in ${shown}/:\n${message}`, { cause: error });
+	}
+}
+/** Connect's route files, as the generated tree imports them. */
+const CONNECT_ROUTES_SPECIFIER = "@powerhousedao/connect/routes";
+function importCoreRoutesByPackage(treeFile, routesDirectory) {
+	const prefix = `"./${relative(dirname(treeFile), routesDirectory).split(sep).join("/")}/`;
+	const tree = readFileSync(treeFile, "utf8");
+	const rewritten = tree.replace(new RegExp(`${escapeRegExp(prefix)}([^"]+)\\.js"`, "g"), `"${CONNECT_ROUTES_SPECIFIER}/$1"`);
+	if (rewritten !== tree) writeFileSync(treeFile, rewritten);
+}
+function assertNoDuplicateRoutes(treeFile) {
+	const tree = readFileSync(treeFile, "utf8");
+	const files = /* @__PURE__ */ new Map();
+	for (const [, name, file] of tree.matchAll(/^import \{ Route as (\w+) \} from "([^"]+)";$/gm)) files.set(name, [...files.get(name) ?? [], file]);
+	const conflicts = [...files.values()].filter((list) => list.length > 1);
+	if (conflicts.length === 0) return;
+	throw new Error(`Conflicting configuration paths were found for a layout route.\nConflicting files: \n ${conflicts.flat().join("\n ")}\n`);
+}
+function escapeRegExp(text) {
+	return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Generates the tree when the project has routes, else drops a stale one. */
+async function syncConnectRoutes(projectRoot, routesDir = resolveConnectRoutesDir(projectRoot)) {
+	if (routesDir) await generateConnectRoutes(projectRoot, routesDir);
+	else rmSync(join(projectRoot, CONNECT_ROUTES_GEN), { force: true });
+}
+function connectDirOf(projectRoot) {
+	return dirname(resolvePackage("@powerhousedao/connect/package.json", projectRoot));
+}
+/** Mounts a project's routes folder beside Connect's core routes; without one,
+* Connect keeps its prebuilt core tree and no router plugin runs. */
+function connectRoutes(projectRoot, routesDir = resolveConnectRoutesDir(projectRoot)) {
+	const connectDir = connectDirOf(projectRoot);
+	const find = new RegExp(`^${ROUTE_TREE_SPECIFIER}$`);
+	if (!routesDir) {
+		rmSync(join(projectRoot, CONNECT_ROUTES_GEN), { force: true });
+		return {
+			alias: {
+				find,
+				replacement: join(connectDir, "dist/route-tree.js")
+			},
+			plugins: [],
+			dedupe: []
+		};
+	}
+	const config = connectRoutesGeneratorConfig(connectDir, projectRoot, routesDir);
+	mkdirSync(dirname(config.generatedRouteTree), { recursive: true });
+	return {
+		alias: {
+			find,
+			replacement: config.generatedRouteTree
+		},
+		plugins: [{
+			name: "ph-connect-routes-check",
+			buildStart: () => generateConnectRoutes(projectRoot, routesDir, config)
+		}, tanstackRouter(config)],
+		dedupe: ["@tanstack/react-router"]
+	};
+}
+const ROUTER_PACKAGES = /[\\/]node_modules[\\/]@tanstack[\\/](react-router|router-core|history|react-store|store)[\\/]/;
+/** One chunk for the router and the project's route configs, which the split
+* route components would otherwise spread over several shared chunks. */
+function connectRouterChunkGroups(routesDir) {
+	const routes = routesDir && join(routesDir, sep);
+	return [
+		{
+			name: "preload-helper",
+			test: /vite[\\/]preload-helper/,
+			priority: 1
+		},
+		{
+			name: "use-sync-external-store",
+			test: /[\\/]node_modules[\\/]use-sync-external-store[\\/]/,
+			priority: 1
+		},
+		{
+			name: "router",
+			test: (id) => ROUTER_PACKAGES.test(id) || !!routes && id.startsWith(routes) && !id.includes("tsr-split")
+		}
+	];
+}
+//#endregion
 //#region connect-utils/vite-plugins/dynamic-base.ts
 /**
 * Global the runtime (ph-clint proxy) must set before the entry bundle loads.
@@ -103,6 +500,15 @@ function workerPrelude(stripPrefix) {
 	return `${RUNTIME_GLOBAL}=self.location.pathname.replace(/${prefix}assets\\/[^/]*$/,"");\n`;
 }
 const PLACEHOLDER_LITERAL = new RegExp(`(["'\`])${escapeForRegExp(DYNAMIC_BASE_PLACEHOLDER)}((?:(?!\\1)[^$])*)\\1`, "g");
+const PLACEHOLDER_CSS_URL = new RegExp(`url\\(\\s*(["']?)${escapeForRegExp(DYNAMIC_BASE_PLACEHOLDER)}([^"')]*)\\1\\s*\\)`, "g");
+/** Rewrites `url(<placeholder>assets/x)` relative to the stylesheet at `fileName`. */
+function relativeCssUrls(css, fileName) {
+	const dir = path.posix.dirname(fileName);
+	return css.replace(PLACEHOLDER_CSS_URL, (_match, quote, target) => {
+		const relative = path.posix.relative(dir, target);
+		return `url(${quote}${relative.startsWith(".") ? relative : `./${relative}`}${quote})`;
+	});
+}
 /**
 * Rewrites the placeholder base in emitted JS chunks to a runtime expression so
 * one built `dist/connect` serves under any subpath. Rolldown-native: per-match
@@ -127,9 +533,9 @@ const PLACEHOLDER_LITERAL = new RegExp(`(["'\`])${escapeForRegExp(DYNAMIC_BASE_P
 * (the same proxy also sets the runtime global for the JS rewrite). See the
 * plugin's module doc / report for the exact serve-time contract.
 *
-* CSS `url(...)` references resolve relative to the stylesheet's own URL, so
-* they need no rewrite once the stylesheet itself is loaded from the right
-* prefix (which the HTML substitution handles).
+* CSS `url(...)` references that Vite emits with the placeholder (e.g. bundled
+* fonts) are rewritten relative to the stylesheet, which the HTML substitution
+* already loads from the right prefix.
 */
 function connectDynamicBasePlugin(options = {}) {
 	return {
@@ -153,6 +559,7 @@ function connectDynamicBasePlugin(options = {}) {
 			};
 		},
 		generateBundle(_options, bundle) {
+			for (const file of Object.values(bundle)) if (file.type === "asset" && file.fileName.endsWith(".css")) file.source = relativeCssUrls(String(file.source), file.fileName);
 			for (const file of Object.values(bundle)) if ((file.type === "chunk" ? file.code : file.fileName.endsWith(".css") && typeof file.source === "string" ? file.source : void 0)?.includes(DYNAMIC_BASE_PLACEHOLDER)) this.error(`dynamic-base: unrewritten placeholder ${DYNAMIC_BASE_PLACEHOLDER} remains in ${file.fileName}`);
 		}
 	};
@@ -229,13 +636,19 @@ const VENDOR_DYNAMIC_BASE = `${DYNAMIC_BASE_PLACEHOLDER}${VENDOR_URL_PREFIX.repl
 */
 async function prebuildConnectVendor(options) {
 	const include = expandIncludeSubpaths(options.dirname, options.include ?? DEFAULT_VENDOR_INCLUDE);
+	const own = options.ownDeps ? resolveOwnDeps(options.ownDeps.from, options.ownDeps.specs) : {};
+	for (const spec of Object.keys(own)) if (!include.includes(spec)) include.push(spec);
 	const external = options.external ?? VENDOR_EXTERNAL;
 	const vendorDir = options.vendorDir ?? join(options.dirname, "node_modules/.ph-vendor");
 	const importMapPath = join(vendorDir, "import-map.json");
-	const versionDigest = resolveVersionDigest(options.dirname, [...include, ...external]);
-	const versions = resolveDepVersions(options.dirname, [...include, ...external]);
+	const stamps = /* @__PURE__ */ new Map();
+	const versions = resolveDepVersions(options.dirname, [...include, ...external], stamps);
 	const base = options.base ?? VENDOR_DYNAMIC_BASE;
 	const nodeEnv = options.nodeEnv ?? "development";
+	const versionDigest = resolveVersionDigest(versions, own, stamps, {
+		base,
+		nodeEnv
+	});
 	try {
 		const hit = readCacheHit(importMapPath, include, external, versionDigest);
 		if (hit) return {
@@ -257,7 +670,7 @@ async function prebuildConnectVendor(options) {
 				vendorDir,
 				...raced
 			};
-			const result = await buildVendorAtomic(options.dirname, vendorDir, include, external, versionDigest, versions, base, nodeEnv);
+			const result = await buildVendorAtomic(options.dirname, vendorDir, include, external, versionDigest, versions, base, nodeEnv, own);
 			return result ? {
 				vendorDir,
 				...result
@@ -274,13 +687,41 @@ function readCacheHit(importMapPath, include, external, versionDigest) {
 	if (!existsSync(importMapPath)) return null;
 	try {
 		const cached = JSON.parse(readFileSync(importMapPath, "utf8"));
-		if (sameSet(cached.include, include) && sameSet(cached.external, external) && cached.versionDigest === versionDigest) return {
+		if (sameSet(cached.include, include) && sameSet(cached.external, external) && cached.versionDigest === versionDigest && typeof cached.sharedDeps === "string") return {
 			imports: cached.imports,
-			versions: cached.versions ?? {}
+			versions: cached.versions ?? {},
+			sharedDeps: cached.sharedDeps
 		};
 	} catch {}
 	return null;
 }
+const NON_RUNTIME_FILE = /\.(map|d\.[cm]?ts|tsbuildinfo)$/;
+function linkedBuildStamp(pkgRoot) {
+	if (pkgRoot.split(/[\\/]/).includes("node_modules")) return "";
+	let newest = 0;
+	try {
+		const entries = readdirSync(join(pkgRoot, "dist"), {
+			recursive: true,
+			withFileTypes: true
+		});
+		for (const entry of entries) {
+			if (!entry.isFile() || NON_RUNTIME_FILE.test(entry.name)) continue;
+			const { mtimeMs } = statSync(join(entry.parentPath, entry.name));
+			if (mtimeMs > newest) newest = mtimeMs;
+		}
+	} catch {
+		return "";
+	}
+	return newest ? `+dist.${Math.trunc(newest)}` : "";
+}
+function cachedStamp(stamps, pkgRoot) {
+	let stamp = stamps.get(pkgRoot);
+	if (stamp === void 0) {
+		stamp = linkedBuildStamp(pkgRoot);
+		stamps.set(pkgRoot, stamp);
+	}
+	return stamp;
+}
 /**
 * Resolve the installed version of each spec's owning package, deduped by
 * package name. Resolution order per spec:
@@ -294,7 +735,7 @@ function readCacheHit(importMapPath, include, external, versionDigest) {
 * Unresolvable specs contribute a "missing" sentinel, unknown versions
 * "unknown".
 */
-function resolveDepVersions(dirname$3, specs) {
+function resolveDepVersions(dirname$3, specs, stamps = /* @__PURE__ */ new Map()) {
 	const req = createRequire(join(dirname$3, "noop.js"));
 	const seen = {};
 	let selfMeta = null;
@@ -313,7 +754,7 @@ function resolveDepVersions(dirname$3, specs) {
 			try {
 				const pkgRoot = realpathSync(join(dirname$3, "node_modules", pkg));
 				const meta = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
-				version = String(meta.version ?? "unknown");
+				version = String(meta.version ?? "unknown") + cachedStamp(stamps, pkgRoot);
 			} catch {
 				try {
 					const entry = req.resolve(spec);
@@ -335,12 +776,16 @@ function resolveDepVersions(dirname$3, specs) {
 	}
 	return seen;
 }
-function resolveVersionDigest(dirname, specs) {
-	const versions = resolveDepVersions(dirname, specs);
+function resolveVersionDigest(versions, own, stamps, build) {
 	const h = createHash("sha256");
+	h.update(`base:${build.base}\nnodeEnv:${build.nodeEnv}\n`);
 	const workerHash = createHash("sha256").update(VENDOR_BUILD_WORKER).digest("hex");
 	h.update(`worker:${workerHash}\n`);
 	for (const pkg of Object.keys(versions).sort()) h.update(`${pkg}@${versions[pkg]}\n`);
+	for (const spec of Object.keys(own).sort()) {
+		const stamp = cachedStamp(stamps, ownPackageRoot(own[spec]));
+		h.update(`own:${spec}=${own[spec]}${stamp}\n`);
+	}
 	return h.digest("hex").slice(0, 16);
 }
 function sameSet(a, b) {
@@ -425,6 +870,62 @@ function importTarget$1(value) {
 	}
 	return null;
 }
+/** The package root at or above `from` that Node would load `pkg` from, or null. */
+function findPackageRoot(from, pkg) {
+	let dir = from;
+	for (;;) {
+		const candidate = join(dir, "node_modules", pkg);
+		if (existsSync(join(candidate, "package.json"))) return realpathSync(candidate);
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+function ownRoots(own) {
+	const roots = /* @__PURE__ */ new Set();
+	for (const file of Object.values(own)) {
+		const root = ownPackageRoot(file);
+		try {
+			const meta = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+			if (Object.keys(meta.dependencies ?? {}).length === 0) roots.add(root + sep);
+		} catch {}
+	}
+	return [...roots];
+}
+function ownPackageRoot(file) {
+	let dir = dirname(file);
+	for (;;) {
+		try {
+			if (JSON.parse(readFileSync(join(dir, "package.json"), "utf8")).name) return dir;
+		} catch {}
+		const parent = dirname(dir);
+		if (parent === dir) return dir;
+		dir = parent;
+	}
+}
+/** Each spec's browser/import entry file when resolved from `from`; unresolvable specs are left out. */
+function resolveOwnDeps(from, specs) {
+	const out = {};
+	for (const spec of specs) {
+		const { pkg, sub } = parsePkg(spec);
+		const root = findPackageRoot(from, pkg);
+		if (!root) continue;
+		try {
+			const meta = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+			const key = sub ? `./${sub}` : ".";
+			let target = null;
+			if (meta.exports && typeof meta.exports === "object") {
+				const exp = meta.exports;
+				target = Object.keys(exp).some((k) => k.startsWith(".")) ? key in exp ? importTarget$1(exp[key]) : null : sub ? null : importTarget$1(exp);
+			} else if (typeof meta.exports === "string") target = sub ? null : meta.exports;
+			else if (!sub) target = meta.module ?? meta.main ?? null;
+			if (!target || /\.(css|json|scss)$/.test(target)) continue;
+			const file = join(root, target);
+			if (existsSync(file)) out[spec] = realpathSync(file);
+		} catch {}
+	}
+	return out;
+}
 function parsePkg(spec) {
 	if (spec.startsWith("@")) {
 		const parts = spec.split("/");
@@ -520,12 +1021,12 @@ function withVendorBase(imports, base) {
 * table, writes the runtime shared-deps module, and does the swap.
 * Returns the published import map + versions, or null on failure.
 */
-async function buildVendorAtomic(dirname$4, vendorDir, include, external, versionDigest, versions, base, nodeEnv) {
+async function buildVendorAtomic(dirname$4, vendorDir, include, external, versionDigest, versions, base, nodeEnv, own = {}) {
 	const parent = dirname(vendorDir);
 	mkdirSync(parent, { recursive: true });
 	const tmpDir = mkdtempSync(join(parent, ".ph-vendor.tmp-"));
 	try {
-		const { ok, stderr } = await runBuildWorker(dirname$4, tmpDir, include, external, base, nodeEnv);
+		const { ok, stderr } = await runBuildWorker(dirname$4, tmpDir, include, external, base, nodeEnv, own);
 		const tmpMap = join(tmpDir, "import-map.json");
 		if (!ok || !existsSync(tmpMap)) {
 			const detail = stderr.trim();
@@ -536,8 +1037,14 @@ async function buildVendorAtomic(dirname$4, vendorDir, include, external, versio
 		if (unbacked.length > 0) throw new Error(`vendor build published ${unbacked.length} import-map ${unbacked.length === 1 ? "entry" : "entries"} with no file behind ${unbacked.length === 1 ? "it" : "them"}:\n` + unbacked.map((e) => `  ${e.spec} -> ${e.url}`).join("\n"));
 		meta.versionDigest = versionDigest;
 		meta.versions = versions;
+		meta.base = base;
+		meta.nodeEnv = nodeEnv;
+		const sharedDepsSource = `export const imports = ${JSON.stringify(withVendorBase(meta.imports, base))};\nexport const versions = ${JSON.stringify(versions)};\n`;
+		const sharedDepsFile = `shared-deps-${createHash("sha256").update(sharedDepsSource).digest("hex").slice(0, 12)}.js`;
+		writeFileSync(join(tmpDir, sharedDepsFile), sharedDepsSource);
+		writeFileSync(join(tmpDir, "shared-deps.js"), sharedDepsSource);
+		meta.sharedDeps = VENDOR_URL_PREFIX + sharedDepsFile;
 		writeFileSync(tmpMap, JSON.stringify(meta, null, 2));
-		writeFileSync(join(tmpDir, "shared-deps.js"), `export const imports = ${JSON.stringify(withVendorBase(meta.imports, base))};\nexport const versions = ${JSON.stringify(versions)};\n`);
 		const oldDir = `${vendorDir}.old-${process.pid}-${Date.now()}`;
 		if (existsSync(vendorDir)) renameSync(vendorDir, oldDir);
 		renameSync(tmpDir, vendorDir);
@@ -548,7 +1055,8 @@ async function buildVendorAtomic(dirname$4, vendorDir, include, external, versio
 		});
 		return {
 			imports: meta.imports,
-			versions
+			versions,
+			sharedDeps: meta.sharedDeps
 		};
 	} catch (err) {
 		rmSync(tmpDir, {
@@ -577,7 +1085,7 @@ function resolveSelfModulePath() {
 * given out dir, and writes the import map. Captures stdout/stderr so a failure
 * is debuggable; the normal path stays quiet.
 */
-function runBuildWorker(dirname, outDir, include, external, base, nodeEnv) {
+function runBuildWorker(dirname, outDir, include, external, base, nodeEnv, own = {}) {
 	const workerPath = join(outDir, "build-worker.mjs");
 	writeFileSync(workerPath, VENDOR_BUILD_WORKER);
 	const selfModulePath = resolveSelfModulePath();
@@ -592,7 +1100,11 @@ function runBuildWorker(dirname, outDir, include, external, base, nodeEnv) {
 			VENDOR_DYNAMIC_BASE,
 			selfModulePath,
 			base,
-			nodeEnv
+			nodeEnv,
+			JSON.stringify({
+				files: own,
+				roots: ownRoots(own)
+			})
 		], {
 			cwd: dirname,
 			stdio: [
@@ -630,7 +1142,12 @@ import { createRequire } from 'node:module';
 import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
 import { join, isAbsolute } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-const [dirname, vendorDir, includeJSON, urlPrefix, externalJSON, dynamicBase, selfModulePath, baseArg, nodeEnvArg] = process.argv.slice(2);
+const [dirname, vendorDir, includeJSON, urlPrefix, externalJSON, dynamicBase, selfModulePath, baseArg, nodeEnvArg, ownJSON] = process.argv.slice(2);
+// ownDeps: spec -> absolute entry file, plus each one's package root.
+const { files: own = {}, roots: ownRootList = [] } = JSON.parse(ownJSON || '{}');
+// One chunk per own-dep package: split between an entry and a shared chunk, a
+// barrel can re-export from the entry and run before the classes it extends.
+const ownGroups = ownRootList.map((root, i) => ({ name: 'own-' + i, test: (id) => id.startsWith(root) }));
 // Trailing argv are optional (older callers): base defaults to the dynamic
 // placeholder behavior, nodeEnv to development. baseArg is the APP base —
 // the same string the app build uses; the build base appends the vendor
@@ -655,23 +1172,42 @@ const RESERVED = new Set('enum void null function in instanceof typeof new delet
 const input = {};
 for (const spec of include) {
   const name = entryName(spec);
+  const from = own[spec] ?? spec;
   let src;
   try {
     // Import the bare spec (not reqProj.resolve(spec)) so Node picks the same
     // import/browser-condition module the build resolves — resolving first can
     // pick a CJS sibling whose default-export shape differs from the ESM build.
-    const ns = await import(spec);
+    const ns = await import(own[spec] ? pathToFileURL(own[spec]).href : spec);
     // Only fall back to re-exporting from default when the module exposes NO
     // top-level named exports (a true CJS-interop module). If it does (e.g. zod
     // exposes \`z\`), \`export *\` captures them; destructuring default would miss
     // top-level names that aren't keys of the default object.
     const named = Object.keys(ns).filter((k) => k !== 'default');
     const cjs = named.length === 0 && ns.default && typeof ns.default === 'object';
-    if (cjs) {
+    // A strict entry keeps every export, and zod's \`locales\` (also reachable via \`z\`) pins
+    // ~50 locales; publish them without it. zod/locales stays its own entry.
+    const zodNs = (spec === 'zod' || spec.startsWith('zod/')) && !spec.includes('locales') && named.includes('locales');
+    if (zodNs) {
+      const keep = named.filter((k) => k !== 'locales' && k !== 'z' && /^[A-Za-z_$][\\w$]*$/.test(k));
+      // \`core\` is zod/v4/core's namespace, which exports locales too: rebuild it without them.
+      const coreKeys = keep.includes('core') ? Object.keys(await import('zod/v4/core')).filter((k) => k !== 'locales' && k !== 'default') : [];
+      const reexport = keep.filter((k) => !(k === 'core' && coreKeys.length));
+      src = 'export { ' + reexport.join(', ') + ' } from ' + JSON.stringify(from) + ';\\n'
+        + 'import { ' + reexport.map((k) => k + ' as __z_' + k).join(', ') + ' } from ' + JSON.stringify(from) + ';\\n';
+      if (coreKeys.length) {
+        src += 'import { ' + coreKeys.map((k) => k + ' as __c_' + k).join(', ') + ' } from "zod/v4/core";\\n'
+          + 'const __z_core = Object.freeze({ ' + coreKeys.map((k) => JSON.stringify(k) + ': __c_' + k).join(', ') + ' });\\n'
+          + 'export { __z_core as core };\\n';
+      }
+      src += 'const z = Object.freeze({ ' + keep.map((k) => JSON.stringify(k) + ': __z_' + k).join(', ') + ' });\\n'
+        + (named.includes('z') ? 'export { z };\\n' : '')
+        + (('default' in ns) && ns.default === ns.z ? 'export { z as default };\\n' : '');
+    } else if (cjs) {
       const names = Object.keys(ns.default).filter((k) => k !== 'default' && k !== '__esModule' && /^[A-Za-z_$][\\w$]*$/.test(k));
       const plain = names.filter((n) => !RESERVED.has(n));
       const reserved = names.filter((n) => RESERVED.has(n));
-      src = 'import d from ' + JSON.stringify(spec) + ';\\nexport default d;\\n'
+      src = 'import d from ' + JSON.stringify(from) + ';\\nexport default d;\\n'
         + (plain.length ? 'export const { ' + plain.join(', ') + ' } = d;\\n' : '');
       // reserved words are invalid as const-binding names but valid as export
       // aliases (export { x as enum }).
@@ -679,11 +1215,11 @@ for (const spec of include) {
         src += 'const __r' + i + ' = d[' + JSON.stringify(n) + '];\\nexport { __r' + i + ' as ' + n + ' };\\n';
       });
     } else {
-      src = 'export * from ' + JSON.stringify(spec) + ';\\n'
-        + (('default' in ns) ? 'export { default } from ' + JSON.stringify(spec) + ';\\n' : '');
+      src = 'export * from ' + JSON.stringify(from) + ';\\n'
+        + (('default' in ns) ? 'export { default } from ' + JSON.stringify(from) + ';\\n' : '');
     }
   } catch {
-    src = 'export * from ' + JSON.stringify(spec) + ';\\n';
+    src = 'export * from ' + JSON.stringify(from) + ';\\n';
   }
   const file = join(srcDir, name + '.js');
   writeFileSync(file, src);
@@ -708,7 +1244,7 @@ const phVendorResolve = {
     return resolved;
   },
 };
-await build({
+const result = await build({
   root: dirname, configFile: false, logLevel: 'error',
   // Caller-provided build base (or the dynamic placeholder default):
   // connectDynamicBasePlugin rewrites emitted chunk/asset URLs to resolve
@@ -734,13 +1270,21 @@ await build({
     outDir: vendorDir, emptyOutDir: false, minify: nodeEnv === 'production', target: 'esnext', cssCodeSplit: true,
     rollupOptions: {
       input, preserveEntrySignatures: 'strict',
-      output: { format: 'es', entryFileNames: '[name].js', chunkFileNames: 'chunks/[name]-[hash].js', assetFileNames: 'assets/[name]-[hash][extname]' },
+      // Content-hashed entry names: each build's import map points at new URLs.
+      output: { format: 'es', entryFileNames: '[name]-[hash].js', chunkFileNames: 'chunks/[name]-[hash].js', assetFileNames: 'assets/[name]-[hash][extname]', ...(ownGroups.length ? { codeSplitting: { groups: ownGroups } } : {}) },
     },
   },
 });
 rmSync(srcDir, { recursive: true, force: true });
+const emitted = {};
+for (const out of Array.isArray(result) ? result : [result]) {
+  for (const chunk of out?.output ?? []) {
+    if (chunk.type === 'chunk' && chunk.isEntry) emitted[chunk.name] = chunk.fileName;
+  }
+}
 const imports = {};
-for (const spec of include) imports[spec] = urlPrefix + entryName(spec) + '.js';
+// An entry the build never emitted keeps its unhashed name; the caller reports it as missing.
+for (const spec of include) imports[spec] = urlPrefix + (emitted[entryName(spec)] ?? entryName(spec) + '.js');
 writeFileSync(join(vendorDir, 'import-map.json'), JSON.stringify({ include, external, imports }, null, 2));
 `;
 //#endregion
@@ -975,6 +1519,19 @@ function readWorkerCacheHit(metaPath, sourceDigest, vendorKey, nodeEnv) {
 		return false;
 	}
 }
+/** Content digest of a directory tree (relative paths + bytes; source maps skipped). */
+function directoryContentDigest(dir) {
+	const h = createHash("sha256");
+	const files = readdirSync(dir, {
+		recursive: true,
+		withFileTypes: true
+	}).filter((e) => e.isFile() && !e.name.endsWith(".map")).map((e) => join(e.parentPath, e.name)).sort();
+	for (const file of files) {
+		h.update(`${file.slice(dir.length).split("\\").join("/")}\n`);
+		h.update(readFileSync(file));
+	}
+	return h.digest("hex").slice(0, 16);
+}
 async function waitForWorkerCacheHit(metaPath, sourceDigest, vendorKey, nodeEnv, lockDir) {
 	const deadline = Date.now() + LOCK_STALE_MS;
 	while (Date.now() < deadline) {
@@ -1462,189 +2019,6 @@ async function prebuildWorkerPackages(options) {
 	}
 }
 //#endregion
-//#region connect-utils/helpers.ts
-const DEFAULT_CONNECT_OUTDIR = ".ph/connect-build/dist/";
-function resolveViteConfigPath(options) {
-	const { projectRoot = cwd(), viteConfigFile } = options;
-	return viteConfigFile || join(projectRoot, "vite.config.ts");
-}
-function resolvePackage(packageName, root = process.cwd()) {
-	return createRequire(root).resolve(packageName, { paths: [root] });
-}
-function resolveConnectPackageJson(root = process.cwd()) {
-	try {
-		const connectPackageJsonPath = resolvePackage("@powerhousedao/connect/package.json", root);
-		const fileContents = fs.readFileSync(connectPackageJsonPath, "utf-8");
-		return JSON.parse(fileContents);
-	} catch (error) {
-		console.error(`Error reading Connect package.json:`, error);
-		return null;
-	}
-}
-/**
-* Finds the dist dir of Connect on the local machine
-*/
-function resolveConnectBundle(root = process.cwd()) {
-	const connectIndexPath = resolvePackage("@powerhousedao/connect", root);
-	const connectRootPath = connectIndexPath.substring(0, connectIndexPath.indexOf("connect") + 7);
-	return join(connectRootPath, "dist/");
-}
-function resolveConnectPublicDir(root = process.cwd()) {
-	const connectIconPath = resolvePackage("@powerhousedao/connect/public/icon.ico", root);
-	return path.join(connectIconPath, "../");
-}
-/**
-* Copies the Connect dist dir to the target path
-*/
-function copyConnect(sourcePath, targetPath) {
-	try {
-		fs.rmSync(targetPath, {
-			recursive: true,
-			force: true
-		});
-		fs.cpSync(sourcePath, targetPath, { recursive: true });
-	} catch (error) {
-		console.error(`❌ Error copying ${sourcePath} to ${targetPath}:`, error);
-	}
-}
-/**
-* Backs up the index.html file
-*
-* Needed when running the Connect Studio dev server on Windows
-*/
-function backupIndexHtml(appPath, restore = false) {
-	const filePath = join(appPath, "index.html");
-	const backupPath = join(appPath, "index.html.bak");
-	const paths = restore ? [backupPath, filePath] : [filePath, backupPath];
-	if (fs.existsSync(paths[0])) fs.copyFileSync(paths[0], paths[1]);
-}
-function removeBase64EnvValues(appPath) {
-	backupIndexHtml(appPath);
-	const filePath = join(appPath, "index.html");
-	fs.readFile(filePath, "utf-8", (err, data) => {
-		if (err) {
-			console.error("Error reading file:", err);
-			return;
-		}
-		const modifiedData = data.replace(/"LOCAL_DOCUMENT_MODELS":\s*".*?",/, `"LOCAL_DOCUMENT_MODELS": "",`).replace(/"LOCAL_DOCUMENT_EDITORS":\s*".*?"/, `"LOCAL_DOCUMENT_EDITORS": ""`);
-		console.log("Modified data:", modifiedData);
-		fs.writeFile(filePath, modifiedData, "utf-8", (err) => {
-			if (err) {
-				console.error("Error writing file:", err);
-				return;
-			}
-		});
-	});
-}
-function readJsonFile(filePath) {
-	try {
-		const absolutePath = resolve(filePath);
-		const fileContents = fs.readFileSync(absolutePath, "utf-8");
-		return JSON.parse(fileContents);
-	} catch (_error) {
-		console.error(`Error reading file: ${filePath}`);
-		return null;
-	}
-}
-/**
-* Takes a list of Powerhouse project packages and optionally local Powerhouse packages and outputs a js file which exports those packages for use in Connect Studio.
-*/
-function makeImportScriptFromPackages(args) {
-	const { packages, localJsPath, localCssPath, importStyles = true } = args;
-	const imports = [];
-	const moduleNames = [];
-	let counter = 0;
-	for (const packageName of packages) {
-		const moduleName = `module${counter}`;
-		moduleNames.push(moduleName);
-		imports.push(`import * as ${moduleName} from '${packageName}';`);
-		if (importStyles) imports.push(`import '${packageName}/style.css';`);
-		counter++;
-	}
-	const exports = moduleNames.map((name, index) => `{
-      id: "${packages[index]}",
-      ...${name},
-    }`);
-	const hasModule = localJsPath !== void 0;
-	const hasStyles = importStyles && localCssPath !== void 0;
-	if (hasModule || hasStyles) {
-		if (hasStyles) imports.push(`import '${localCssPath}';`);
-		if (hasModule) {
-			const moduleName = `module${counter}`;
-			imports.push(`import * as ${moduleName} from '${localJsPath}';`);
-			exports.push(`{
-        id: "${LOCAL_PACKAGE_ID}",
-        ...${moduleName},
-      }`);
-		}
-	}
-	const exportStatement = `export default [${exports.length ? `
-        ${exports.join(",\n")}
-    ` : ""}];`;
-	return `${imports.join("\n")}\n\n${exportStatement}`;
-}
-function ensureNodeVersion(minVersion = "24") {
-	const version = process.versions.node;
-	if (!version) return;
-	if (version < minVersion) {
-		console.error(`Node version ${minVersion} or higher is required. Current version: ${version}`);
-		process.exit(1);
-	}
-}
-function runShellScriptPlugin(scriptName, connectPath) {
-	return {
-		name: "vite-plugin-run-shell-script",
-		buildStart() {
-			const scriptPath = join(connectPath, scriptName);
-			if (fs.existsSync(scriptPath)) exec(`sh ${scriptPath}`, (error, stdout, stderr) => {
-				if (error) {
-					console.error(`Error executing the script: ${error.message}`);
-					removeBase64EnvValues(connectPath);
-					return;
-				}
-				if (stderr) console.error(stderr);
-			});
-		}
-	};
-}
-/**
-* Shared helper to modify the <head> tag of an HTML file by transforming its contents.
-*/
-async function modifyHtmlHead(pathToHtml, contents, transform) {
-	if (!existsSync(pathToHtml)) throw new Error(`File ${pathToHtml} does not exist.`);
-	let html = await readFile(pathToHtml, "utf8");
-	html = transform(html, contents);
-	await writeFile(pathToHtml, html, "utf8");
-}
-/**
-* Appends the contents to the <head> tag of the index.html file
-*/
-async function appendToHtmlHead(pathToHtml, contents) {
-	return modifyHtmlHead(pathToHtml, contents, (html, contents) => {
-		if (!html.includes("</head>")) throw new Error("No </head> tag found in the HTML file.");
-		return html.replace("</head>", `\n${contents}\n</head>`);
-	});
-}
-/**
-* Prepends the contents to the <head> tag of the index.html file
-*/
-async function prependToHtmlHead(pathToHtml, contents) {
-	return modifyHtmlHead(pathToHtml, contents, (html, contents) => {
-		if (!html.includes("</head>")) throw new Error("No </head> tag found in the HTML file.");
-		return html.replace("<head>", `<head>\n${contents}\n`);
-	});
-}
-function runTsc(outDir) {
-	execSync(`npx tsc --outDir ${outDir}`, { stdio: "inherit" });
-}
-function stripVersionFromPackage(packageName) {
-	const trimmed = packageName.trim();
-	if (!trimmed) return "";
-	const lastAtIndex = trimmed.lastIndexOf("@");
-	if (lastAtIndex > 0) return trimmed.substring(0, lastAtIndex);
-	return trimmed;
-}
-//#endregion
 //#region connect-utils/runtime-config-schema.ts
 const RUNTIME_CONFIG_SCHEMA_ID = "https://powerhouse.inc/schemas/powerhouse.config.json";
 const RUNTIME_CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/powerhouse-inc/powerhouse/main/packages/builder-tools/connect-utils/runtime-config.schema.json";
@@ -1771,6 +2145,7 @@ const VENDOR_MIME = {
 const VENDOR_MODE = process.env.PH_CONNECT_EXTERNALIZE_VENDOR === "1";
 const VENDOR_EXTRA = (process.env.PH_CONNECT_VENDOR_EXTRA ?? "").split(",").map((s) => s.trim()).filter(Boolean);
 const HEAVY_LIBS = [...DEFAULT_VENDOR_INCLUDE, ...VENDOR_EXTRA];
+const heavyLibsFor = (routesDir) => routesDir ? HEAVY_LIBS.filter((lib) => lib !== "@powerhousedao/connect") : HEAVY_LIBS;
 function withBase$1(base, p) {
 	return `${base}${p}`.replace(/\/{2,}/g, "/");
 }
@@ -1806,15 +2181,16 @@ function externalizePlugin(externals) {
 * the React shims above → one React instance across Connect, the vendor, and
 * CDN editors.
 */
-async function devReactImportmapPlugin(projectRoot = process.cwd()) {
+async function devReactImportmapPlugin(projectRoot = process.cwd(), routesDir = resolveConnectRoutesDir(projectRoot)) {
 	let namedExports = /* @__PURE__ */ new Map();
 	let base = "/";
 	let vendor = null;
+	const heavyLibs = heavyLibsFor(routesDir);
 	if (VENDOR_MODE) {
 		const errorRef = {};
 		vendor = await prebuildConnectVendor({
 			dirname: projectRoot,
-			include: HEAVY_LIBS,
+			include: heavyLibs,
 			errorRef
 		});
 		if (!vendor) {
@@ -1833,8 +2209,8 @@ async function devReactImportmapPlugin(projectRoot = process.cwd()) {
 			const include = new Set(cfg.optimizeDeps.include ?? []);
 			REACT_DEPS.forEach((d) => include.add(d));
 			if (vendorActive) {
-				HEAVY_LIBS.forEach((d) => include.delete(d));
-				cfg.optimizeDeps.exclude = [.../* @__PURE__ */ new Set([...cfg.optimizeDeps.exclude ?? [], ...HEAVY_LIBS])];
+				heavyLibs.forEach((d) => include.delete(d));
+				cfg.optimizeDeps.exclude = [.../* @__PURE__ */ new Set([...cfg.optimizeDeps.exclude ?? [], ...heavyLibs])];
 			}
 			cfg.optimizeDeps.include = [...include];
 		},
@@ -1988,6 +2364,12 @@ function readProjectPackageInfo(projectRoot) {
 		return null;
 	}
 }
+/** `html` with its `<title>` text set to `appName`, when one is configured. */
+function withAppTitle(html, appName) {
+	if (!appName) return html;
+	const escaped = appName.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+	return html.replace(/<title>[^<]*<\/title>/, () => `<title>${escaped}</title>`);
+}
 function phConfigPlugin(options) {
 	const localPackage = readProjectPackageInfo(options.projectRoot ?? process.cwd());
 	const sourceSettings = {
@@ -2030,6 +2412,9 @@ function phConfigPlugin(options) {
 				});
 			}
 		},
+		transformIndexHtml(html) {
+			return withAppTitle(html, runtimeConfig.connect.branding?.appName);
+		},
 		generateBundle() {
 			this.emitFile({
 				type: "asset",
@@ -2455,17 +2840,40 @@ function resolveReactEntries(dirname$1) {
 	}
 	return out;
 }
+function reactImportMap(base, files) {
+	const map = {};
+	for (const [spec, file] of Object.entries(files)) {
+		map[spec] = `${base}${REACT_URL_DIR}/${file}`;
+		if (spec.includes("/")) map[`${spec}.js`] = map[spec];
+	}
+	return map;
+}
 function reactSelfHostPlugin(options) {
 	const entries = resolveReactEntries(options.dirname);
 	let absOutDir = resolve(options.dirname, "dist");
+	let base = "/";
+	let staging;
+	let files = {};
 	let importMap = {};
 	return {
 		name: "ph-react-self-host",
 		apply: "build",
 		configResolved(config) {
 			absOutDir = resolve(config.root, config.build.outDir);
-			importMap = Object.fromEntries(Object.keys(entries).map((spec) => [spec, `${config.base}${REACT_URL_DIR}/${spec}.js`]));
-			for (const pkg of REACT_PACKAGES) importMap[`${pkg}/`] = `${config.base}${REACT_URL_DIR}/${pkg}/`;
+			base = config.base;
+		},
+		async buildStart() {
+			files = {};
+			importMap = {};
+			if (!Object.keys(entries).length) return;
+			const stagingParent = join(options.dirname, "node_modules");
+			staging = mkdtempSync(join(existsSync(stagingParent) ? stagingParent : options.dirname, ".ph-react-self-host-"));
+			const { ok, stderr } = await runReactBuild(options.dirname, staging, entries, options.dev ? "development" : "production");
+			if (!ok) this.error(`react self-host build failed${stderr.trim() ? `:\n${stderr.trim()}` : ""}`);
+			const manifest = join(staging, FILES_MANIFEST);
+			files = JSON.parse(readFileSync(manifest, "utf8"));
+			rmSync(manifest, { force: true });
+			importMap = reactImportMap(base, files);
 		},
 		transformIndexHtml() {
 			if (!Object.keys(importMap).length) return;
@@ -2476,13 +2884,27 @@ function reactSelfHostPlugin(options) {
 				injectTo: "head-prepend"
 			}];
 		},
-		async closeBundle() {
-			if (!Object.keys(entries).length) return;
-			const { ok, stderr } = await runReactBuild(options.dirname, join(absOutDir, REACT_URL_DIR), entries, options.dev ? "development" : "production");
-			if (!ok) this.error(`react self-host build failed${stderr.trim() ? `:\n${stderr.trim()}` : ""}`);
+		closeBundle() {
+			if (!staging) return;
+			const dest = join(absOutDir, REACT_URL_DIR);
+			rmSync(dest, {
+				recursive: true,
+				force: true
+			});
+			mkdirSync(absOutDir, { recursive: true });
+			cpSync(staging, dest, { recursive: true });
+			chmodSync(dest, 493);
+			rmSync(staging, {
+				recursive: true,
+				force: true
+			});
+			staging = void 0;
+			const missing = Object.entries(files).filter(([, file]) => !existsSync(join(dest, file)));
+			if (missing.length) this.error(`react self-host: import map entries have no file in ${dest}:\n` + missing.map(([spec, file]) => `  ${spec} -> ${file}`).join("\n"));
 		}
 	};
 }
+const FILES_MANIFEST = "files.json";
 function runReactBuild(dirname, outDir, entries, nodeEnv) {
 	mkdirSync(outDir, { recursive: true });
 	const workerPath = join(outDir, "build-worker.mjs");
@@ -2557,7 +2979,7 @@ for (const [spec, file] of Object.entries(entries)) {
   input[spec] = entryFile;
 }
 try {
-  await build({
+  const result = await build({
     root: dirname, configFile: false, logLevel: 'error',
     base: './', publicDir: false,
     define: { 'process.env.NODE_ENV': JSON.stringify(nodeEnv) },
@@ -2566,11 +2988,18 @@ try {
       outDir, emptyOutDir: false, minify: nodeEnv === 'production', target: 'esnext',
       rollupOptions: {
         input, preserveEntrySignatures: 'strict',
-        output: { format: 'es', entryFileNames: '[name].js', chunkFileNames: 'chunks/[name]-[hash].js', assetFileNames: 'assets/[name]-[hash][extname]' },
+        output: { format: 'es', entryFileNames: '[name]-[hash].js', chunkFileNames: 'chunks/[name]-[hash].js', assetFileNames: 'assets/[name]-[hash][extname]' },
       },
     },
   });
   rmSync(srcDir, { recursive: true, force: true });
+  const files = {};
+  for (const out of Array.isArray(result) ? result : [result]) {
+    for (const chunk of out?.output ?? []) {
+      if (chunk.type === 'chunk' && chunk.isEntry) files[chunk.name] = chunk.fileName;
+    }
+  }
+  writeFileSync(join(outDir, 'files.json'), JSON.stringify(files));
   // Force exit: rolldown can leave native worker threads alive that keep the
   // event loop open, hanging the parent's spawn() promise indefinitely.
   process.exit(0);
@@ -2679,7 +3108,7 @@ const THEME_BOOT_MARKER = "data-ph-theme-boot";
 * Keep semantically identical to the runtime store in
 * `@powerhousedao/reactor-browser` (hooks/theme.ts).
 */
-const THEME_BOOT_SCRIPT = "(function(){try{var p=new URLSearchParams(location.search).get('theme');if(p==='dark'||p==='light')localStorage.setItem('ph:theme',p);var s=localStorage.getItem('ph:theme');var d=s==='dark'||((!s||s==='system')&&matchMedia('(prefers-color-scheme: dark)').matches);document.documentElement.classList.toggle('dark',d);}catch(e){}})();";
+const THEME_BOOT_SCRIPT = "(function(){try{var p=new URLSearchParams(location.search).get('theme');if(p==='dark'||p==='light')localStorage.setItem('ph:theme',p);var s=localStorage.getItem('ph:theme');var m=matchMedia('(prefers-color-scheme: dark)');var d=s==='dark'||((!s||s==='system')&&m.matches);document.documentElement.classList.toggle('dark',d);if(!s||s==='system'){var f=function(){var t=localStorage.getItem('ph:theme');if(!t||t==='system')document.documentElement.classList.toggle('dark',m.matches);};m.addEventListener('change',f);requestAnimationFrame(f);}}catch(e){}})();";
 /**
 * Injects the theme boot script at the top of `<head>` of every emitted
 * index.html, so built Connect apps render the stored theme from first paint
@@ -2873,7 +3302,7 @@ function getConnectBaseViteConfig(options) {
 	});
 	setConnectEnv(env);
 	const phConfigPath = join(options.dirname, "powerhouse.config.json");
-	const phConfig = options.powerhouseConfig ?? getConfig(phConfigPath);
+	const phConfig = options.powerhouseConfig ?? getConfig$1(phConfigPath);
 	const packagesFromConfig = phConfig.packages ?? [];
 	const localPackagesFromConfig = getLocalPackageNamesFromPowerhouseConfig(phConfig);
 	const phPackagesStr = env.PH_PACKAGES;
@@ -2961,6 +3390,8 @@ function getConnectBaseViteConfig(options) {
 			return null;
 		}
 	}).filter((p) => p !== null);
+	const routesDir = resolveConnectRoutesDir(options.dirname);
+	const routes = connectRoutes(options.dirname, routesDir);
 	return {
 		configFile: false,
 		mode,
@@ -2970,12 +3401,19 @@ function getConnectBaseViteConfig(options) {
 			fs: { allow: [searchForWorkspaceRoot(options.dirname), ...linkedRoots] }
 		},
 		resolve: {
-			dedupe: ["react", "react-dom"],
+			alias: [routes.alias],
+			dedupe: [
+				"react",
+				"react-dom",
+				...routes.dedupe
+			],
 			tsconfigPaths: true
 		},
 		define: {
 			PH_CONNECT_SENTRY_RELEASE: JSON.stringify(release || "unknown"),
-			PH_CONNECT_BUILD_HASH: JSON.stringify(buildHash)
+			PH_CONNECT_BUILD_HASH: JSON.stringify(buildHash),
+			...options.vendor?.sharedDeps && mode === "production" ? { PH_CONNECT_SHARED_DEPS_URL: JSON.stringify(options.vendor.sharedDeps) } : {},
+			...options.reactorWorkerVersion ? { PH_CONNECT_REACTOR_WORKER_VERSION: JSON.stringify(options.reactorWorkerVersion) } : {}
 		},
 		customLogger,
 		envPrefix: ["PH_CONNECT_"],
@@ -3002,8 +3440,9 @@ function getConnectBaseViteConfig(options) {
 				packages: localPackagesFromConfig,
 				projectRoot: options.dirname
 			}),
-			devReactImportmapPlugin(options.dirname),
+			devReactImportmapPlugin(options.dirname, routesDir),
 			reactorWorkerDevPlugin(options.dirname),
+			...routes.plugins,
 			...plugins,
 			esmExternalRequirePlugin({ external: [...reactExternal, ...options.vendor && mode === "production" ? Object.keys(options.vendor.imports) : []] }),
 			reactSelfHostPlugin({
@@ -3013,6 +3452,7 @@ function getConnectBaseViteConfig(options) {
 			...options.vendor && mode === "production" ? [vendorImportMapPlugin({ imports: options.vendor.imports })] : [],
 			connectFaviconPlugin({ faviconPath: options.favicon }),
 			connectThemeBootPlugin(),
+			connectAppShellPlugin(options.dirname),
 			connectBuildHashPlugin(buildHash),
 			...options.dynamicBase ? [connectDynamicBasePlugin()] : [],
 			pwaPlugins
@@ -3023,11 +3463,14 @@ function getConnectBaseViteConfig(options) {
 		},
 		build: {
 			sourcemap: true,
-			rolldownOptions: { shimMissingExports: true }
+			rolldownOptions: {
+				shimMissingExports: true,
+				output: { codeSplitting: { groups: connectRouterChunkGroups(routesDir) } }
+			}
 		}
 	};
 }
 //#endregion
-export { BUILDER_TOOLS_VERSION, BUILD_HASH_FILE, DEFAULT_CONNECT_OUTDIR, DEFAULT_VENDOR_INCLUDE, DYNAMIC_BASE_PLACEHOLDER, EXTERNAL_PACKAGES_IMPORT, IMPORT_SCRIPT_FILE, LOCAL_PACKAGE_ID, LOCK_STALE_MS, PH_DIR_NAME, REACTOR_WORKER_ENTRY, REACTOR_WORKER_MIME, REACTOR_WORKER_URL_PREFIX, RUNTIME_CONFIG_SCHEMA_ID, RUNTIME_CONFIG_SCHEMA_URL, THEME_BOOT_MARKER, VENDOR_EXTERNAL, VENDOR_URL_PREFIX, WORKER_PACKAGES_MANIFEST, acquireLock, appendToHtmlHead, backupIndexHtml, buildHashFromBuildOptions, computeBuildHash, computeSourceDigest, connectBuildHashPlugin, connectDynamicBasePlugin, connectThemeBootPlugin, copyConnect, distDirFingerprint, ensureNodeVersion, escapeForRegExp, findBundleSpecifierOffenders, findDisallowedSpecifiers, findWorkerUnsafeMarkers, getConnectBaseViteConfig, getConnectHtmlTags, makeImportScriptFromPackages, missingVendorEntries, ownProjectPackage, phConfigPlugin, prebuildConnectVendor, prebuildReactorWorker, prebuildWorkerPackages, prependToHtmlHead, publishDirAtomic, readJsonFile, releaseLock, removeBase64EnvValues, resolveConnectBundle, resolveConnectPackageJson, resolveConnectPublicDir, resolveOwnPackageVersion, resolvePackage, resolveReactorWorkerSource, resolveViteConfigPath, resolveWorkspacePackageDir, runShellScriptPlugin, runTsc, runWorkerBuildEntries, runtimeConfigSchema, stripVersionFromPackage, upstreamWorkerPackages, vendorImportMapPlugin, vendorRelativePath, withVendorBase, workerSafeVendorImports };
+export { APP_LAYOUT, APP_SHELL_MARKER, BOOT_RECOVER_KEY, BOOT_RECOVER_MARKER, BOOT_RECOVER_SCRIPT, BUILDER_TOOLS_VERSION, BUILD_HASH_FILE, CONNECT_ROUTES_GEN, CONNECT_ROUTES_SPECIFIER, DEFAULT_CONNECT_OUTDIR, DEFAULT_VENDOR_INCLUDE, DYNAMIC_BASE_PLACEHOLDER, EXTERNAL_PACKAGES_IMPORT, HOST_ROUTES_DIR, IMPORT_SCRIPT_FILE, LOCAL_PACKAGE_ID, LOCK_STALE_MS, PH_DIR_NAME, REACTOR_WORKER_ENTRY, REACTOR_WORKER_MIME, REACTOR_WORKER_URL_PREFIX, ROUTE_TREE_SPECIFIER, RUNTIME_CONFIG_SCHEMA_ID, RUNTIME_CONFIG_SCHEMA_URL, THEME_BOOT_MARKER, VENDOR_EXTERNAL, VENDOR_URL_PREFIX, WORKER_PACKAGES_MANIFEST, acquireLock, appendToHtmlHead, backupIndexHtml, buildHashFromBuildOptions, computeBuildHash, computeSourceDigest, connectAppShellPlugin, connectBuildHashPlugin, connectDynamicBasePlugin, connectRouterChunkGroups, connectRoutes, connectRoutesGeneratorConfig, connectThemeBootPlugin, copyConnect, directoryContentDigest, distDirFingerprint, ensureNodeVersion, escapeForRegExp, findBundleSpecifierOffenders, findDisallowedSpecifiers, findPackageRoot, findWorkerUnsafeMarkers, generateConnectRoutes, getConnectBaseViteConfig, getConnectHtmlTags, injectAppShell, linkedBuildStamp, makeImportScriptFromPackages, missingVendorEntries, ownProjectPackage, phConfigPlugin, prebuildConnectVendor, prebuildReactorWorker, prebuildWorkerPackages, prependToHtmlHead, publishDirAtomic, readAppShell, readJsonFile, rebaseShellLinks, relativeCssUrls, releaseLock, removeBase64EnvValues, resolveConnectBundle, resolveConnectPackageJson, resolveConnectPublicDir, resolveConnectRoutesDir, resolveOwnDeps, resolveOwnPackageVersion, resolvePackage, resolveReactorWorkerSource, resolveVersionDigest, resolveViteConfigPath, resolveWorkspacePackageDir, runShellScriptPlugin, runTsc, runWorkerBuildEntries, runtimeConfigSchema, stripVersionFromPackage, syncConnectRoutes, upstreamWorkerPackages, vendorImportMapPlugin, vendorRelativePath, withAppTitle, withVendorBase, workerSafeVendorImports };
 
 //# sourceMappingURL=index.mjs.map