@blinkk/root 2.0.0-rc.1 → 2.0.0

package/dist/{chunk-UJ6F5RQ5.js → chunk-HTBDTUFE.js}

@@ -1,14 +1,13 @@
 import {
   getVitePlugins
-} from "./chunk-ZUUGSC6Z.js";
+} from "./chunk-MA6MSEP4.js";
 
-// src/node/load-config.ts
+// src/node/monorepo.ts
 import path2 from "node:path";
-import { bundleRequire } from "bundle-require";
-import { build } from "esbuild";
+import { getWorkspaces, getWorkspaceRoot } from "workspace-tools";
 
 // src/utils/fsutils.ts
-import { promises as fs } from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 import fsExtra from "fs-extra";
 import glob from "tiny-glob";
@@ -18,13 +17,13 @@ function isJsFile(filename) {
 async function writeFile(filepath, content) {
   const dirPath = path.dirname(filepath);
   await makeDir(dirPath);
-  await fs.writeFile(filepath, content);
+  await fs.promises.writeFile(filepath, content);
 }
 async function makeDir(dirpath) {
   try {
-    await fs.access(dirpath);
+    await fs.promises.access(dirpath);
   } catch (e) {
-    await fs.mkdir(dirpath, { recursive: true });
+    await fs.promises.mkdir(dirpath, { recursive: true });
   }
 }
 async function copyDir(srcdir, dstdir) {
@@ -43,10 +42,14 @@ async function copyGlob(pattern, srcdir, dstdir) {
   });
 }
 async function rmDir(dirpath) {
-  await fs.rm(dirpath, { recursive: true, force: true });
+  await fs.promises.rm(dirpath, { recursive: true, force: true });
 }
 async function loadJson(filepath) {
-  const content = await fs.readFile(filepath, "utf-8");
+  const content = await fs.promises.readFile(filepath, "utf-8");
+  return JSON.parse(content);
+}
+function loadJsonSync(filepath) {
+  const content = fs.readFileSync(filepath, "utf-8");
   return JSON.parse(content);
 }
 async function writeJson(filepath, data) {
@@ -54,7 +57,7 @@ async function writeJson(filepath, data) {
   await writeFile(filepath, content);
 }
 async function isDirectory(dirpath) {
-  return fs.stat(dirpath).then((fsStat) => {
+  return fs.promises.stat(dirpath).then((fsStat) => {
     return fsStat.isDirectory();
   }).catch((err) => {
     if (err.code === "ENOENT") {
@@ -64,11 +67,19 @@ async function isDirectory(dirpath) {
   });
 }
 function fileExists(filepath) {
-  return fs.access(filepath).then(() => true).catch(() => false);
+  return fs.promises.access(filepath).then(() => true).catch(() => false);
+}
+function fileExistsSync(filepath) {
+  try {
+    fs.accessSync(filepath);
+    return true;
+  } catch {
+    return false;
+  }
 }
 async function dirExists(dirpath) {
   try {
-    const stat = await fs.stat(dirpath);
+    const stat = await fs.promises.stat(dirpath);
     return stat.isDirectory();
   } catch (error) {
     if (error.code === "ENOENT") {
@@ -78,21 +89,105 @@ async function dirExists(dirpath) {
   }
 }
 async function directoryContains(dirpath, subpath) {
-  const outer = await fs.realpath(dirpath);
-  const inner = await fs.realpath(subpath);
+  const outer = await fs.promises.realpath(dirpath);
+  const inner = await fs.promises.realpath(subpath);
   const rel = path.relative(outer, inner);
   return !rel.startsWith("..");
 }
 
+// src/node/monorepo.ts
+function loadPackageJson(filepath) {
+  if (!fileExistsSync(filepath)) {
+    return null;
+  }
+  return loadJsonSync(filepath);
+}
+function getMonorepoPackages(rootDir) {
+  const monorepoRoot = getWorkspaceRoot(rootDir);
+  if (!monorepoRoot) {
+    return {};
+  }
+  const workspaces = getWorkspaces(monorepoRoot);
+  const packages = {};
+  workspaces.forEach((workspaceInfo) => {
+    packages[workspaceInfo.name] = workspaceInfo;
+  });
+  return packages;
+}
+function getMonorepoPackageDeps(rootDir) {
+  const monorepoRoot = getWorkspaceRoot(rootDir);
+  if (!monorepoRoot) {
+    return {};
+  }
+  const packageJsonPath = path2.join(monorepoRoot, "package.json");
+  const packageJson = loadPackageJson(packageJsonPath);
+  return packageJson?.dependencies || {};
+}
+function flattenPackageDepsFromMonorepo(rootDir, options) {
+  const packageJsonPath = path2.resolve(rootDir, "package.json");
+  const packageJson = loadPackageJson(packageJsonPath);
+  const monorepoDeps = getMonorepoPackageDeps(rootDir);
+  const projectDeps = {
+    ...packageJson?.peerDependencies,
+    ...packageJson?.dependencies
+  };
+  const allDeps = {};
+  const workspacePackages = getMonorepoPackages(rootDir);
+  const ignore = options?.ignore || /* @__PURE__ */ new Set();
+  Object.entries(projectDeps).forEach(([depName, depVersion]) => {
+    if (depName.startsWith("@blinkk/root") && depVersion.startsWith("workspace:")) {
+      const packageInfo = workspacePackages[depName];
+      if (packageInfo) {
+        allDeps[depName] = packageInfo.packageJson.version;
+      }
+    } else if (depVersion.startsWith("workspace:")) {
+      if (ignore.has(depName)) {
+        return;
+      }
+      ignore.add(depName);
+      const packageInfo = workspacePackages[depName];
+      if (packageInfo) {
+        const workspacePackageDir = packageInfo.path;
+        const deps = flattenPackageDepsFromMonorepo(workspacePackageDir, {
+          ignore
+        });
+        for (const key in deps) {
+          const currentValue = allDeps[key];
+          if (deps[key] && deps[key] !== "*" && (!currentValue || currentValue === "*")) {
+            allDeps[key] = deps[key];
+          }
+        }
+      }
+    } else if (depVersion === "*" && monorepoDeps[depName]) {
+      allDeps[depName] = monorepoDeps[depName];
+    } else {
+      allDeps[depName] = depVersion;
+    }
+  });
+  return sortDeps(allDeps);
+}
+function sortDeps(deps) {
+  const keys = Object.keys(deps).sort();
+  const sortedDeps = {};
+  for (const key of keys) {
+    sortedDeps[key] = deps[key];
+  }
+  return sortedDeps;
+}
+
 // src/node/load-config.ts
+import path3 from "node:path";
+import { bundleRequire } from "bundle-require";
+import { build } from "esbuild";
 async function loadRootConfig(rootDir, options) {
-  const configPath = path2.resolve(rootDir, "root.config.ts");
+  const configPath = path3.resolve(rootDir, "root.config.ts");
   const exists = await fileExists(configPath);
   if (!exists) {
     throw new Error(`${configPath} does not exist`);
   }
   const configBundle = await bundleRequire({
-    filepath: configPath
+    filepath: configPath,
+    esbuildOptions: { plugins: [esbuildExternalsPlugin({ rootDir })] }
   });
   let config = configBundle.mod.default || {};
   if (typeof config === "function") {
@@ -101,27 +196,11 @@ async function loadRootConfig(rootDir, options) {
   return Object.assign({}, config, { rootDir });
 }
 async function bundleRootConfig(rootDir, outPath) {
-  const configPath = path2.resolve(rootDir, "root.config.ts");
+  const configPath = path3.resolve(rootDir, "root.config.ts");
   const configExists = await fileExists(configPath);
   if (!configExists) {
     throw new Error(`${configPath} does not exist`);
   }
-  const packageJsonPath = path2.resolve(rootDir, "package.json");
-  const packageJson = await loadPackageJson(packageJsonPath);
-  const allDeps = {
-    ...packageJson.peerDependencies,
-    ...packageJson.dependencies
-  };
-  function getPackageName(id) {
-    const segments = id.split("/");
-    if (segments.length > 1) {
-      if (segments[0].startsWith("@") && segments[0].length > 1) {
-        return `${segments[0]}/${segments[1]}`;
-      }
-      return segments[0];
-    }
-    return id;
-  }
   await build({
     entryPoints: [configPath],
     bundle: true,
@@ -131,30 +210,11 @@ async function bundleRootConfig(rootDir, outPath) {
     sourcemap: "inline",
     metafile: true,
     format: "esm",
-    plugins: [
-      // Externalizes deps that are in package.json.
-      {
-        name: "externalize-package-json-deps",
-        setup(build2) {
-          build2.onResolve({ filter: /.*/ }, (args) => {
-            const id = args.path;
-            if (id[0] !== "." && !id.startsWith("@/")) {
-              const packageName = getPackageName(id);
-              if (packageName in allDeps) {
-                return {
-                  external: true
-                };
-              }
-            }
-            return null;
-          });
-        }
-      }
-    ]
+    plugins: [esbuildExternalsPlugin({ rootDir })]
   });
 }
 async function loadBundledConfig(rootDir, options) {
-  const configPath = path2.resolve(rootDir, "dist/root.config.js");
+  const configPath = path3.resolve(rootDir, "dist/root.config.js");
   const exists = await fileExists(configPath);
   if (!exists) {
     throw new Error(`${configPath} does not exist`);
@@ -166,13 +226,36 @@ async function loadBundledConfig(rootDir, options) {
   }
   return Object.assign({}, config, { rootDir });
 }
-async function loadPackageJson(filepath) {
-  try {
-    const packageJson = await loadJson(filepath);
-    return packageJson || {};
-  } catch (err) {
-    return {};
+function esbuildExternalsPlugin(options) {
+  const rootDir = options.rootDir;
+  const allDeps = flattenPackageDepsFromMonorepo(rootDir);
+  function getPackageName(id) {
+    const segments = id.split("/");
+    if (segments.length > 1) {
+      if (segments[0].startsWith("@") && segments[0].length > 1) {
+        return `${segments[0]}/${segments[1]}`;
+      }
+      return segments[0];
+    }
+    return id;
   }
+  return {
+    name: "root-externals-plugin",
+    setup(build2) {
+      build2.onResolve({ filter: /.*/ }, (args) => {
+        const id = args.path;
+        if (id[0] !== "." && !id.startsWith("@/")) {
+          const packageName = getPackageName(id);
+          if (packageName in allDeps) {
+            return {
+              external: true
+            };
+          }
+        }
+        return null;
+      });
+    }
+  };
 }
 
 // src/node/vite.ts
@@ -257,11 +340,13 @@ export {
   fileExists,
   dirExists,
   directoryContains,
+  loadPackageJson,
+  getMonorepoPackageDeps,
+  flattenPackageDepsFromMonorepo,
   loadRootConfig,
   bundleRootConfig,
   loadBundledConfig,
-  loadPackageJson,
   createViteServer,
   viteSsrLoadModule
 };
-//# sourceMappingURL=chunk-UJ6F5RQ5.js.map
+//# sourceMappingURL=chunk-HTBDTUFE.js.map

package/dist/chunk-HTBDTUFE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/monorepo.ts","../src/utils/fsutils.ts","../src/node/load-config.ts","../src/node/vite.ts"],"sourcesContent":["import path from 'node:path';\nimport {getWorkspaces, getWorkspaceRoot, PackageInfo} from 'workspace-tools';\nimport {fileExistsSync, loadJsonSync} from '../utils/fsutils.js';\n\ninterface WorkspacePackage {\n  name: string;\n  path: string;\n  packageJson: PackageInfo;\n}\n\nexport function loadPackageJson(filepath: string): PackageInfo | null {\n  if (!fileExistsSync(filepath)) {\n    return null;\n  }\n  return loadJsonSync(filepath);\n}\n\n/**\n * Returns a map of all packages in the monorepo and the corresponding\n * package.json path.\n */\nfunction getMonorepoPackages(\n  rootDir: string\n): Record<string, WorkspacePackage> {\n  const monorepoRoot = getWorkspaceRoot(rootDir);\n  if (!monorepoRoot) {\n    return {};\n  }\n\n  const workspaces = getWorkspaces(monorepoRoot);\n  const packages: Record<string, WorkspacePackage> = {};\n  workspaces.forEach((workspaceInfo) => {\n    packages[workspaceInfo.name] = workspaceInfo;\n  });\n  return packages;\n}\n\n/**\n * Returns the top-level monorepo package's deps, if any.\n */\nexport function getMonorepoPackageDeps(\n  rootDir: string\n): Record<string, string> {\n  const monorepoRoot = getWorkspaceRoot(rootDir);\n  if (!monorepoRoot) {\n    return {};\n  }\n\n  const packageJsonPath = path.join(monorepoRoot, 'package.json');\n  const packageJson = loadPackageJson(packageJsonPath);\n  return packageJson?.dependencies || {};\n}\n\n/**\n * Flattens package.json deps from the root project dir, taking into account any\n * deps from the monorepo root as well as any `workspace:` deps from within the\n * monorepo.\n */\nexport function flattenPackageDepsFromMonorepo(\n  rootDir: string,\n  options?: {ignore?: Set<string>}\n): Record<string, string> {\n  const packageJsonPath = path.resolve(rootDir, 'package.json');\n  const packageJson = loadPackageJson(packageJsonPath);\n  const monorepoDeps = getMonorepoPackageDeps(rootDir);\n\n  // Flatten `peerDependencies` and `dependencies`.\n  const projectDeps = {\n    ...packageJson?.peerDependencies,\n    ...packageJson?.dependencies,\n  };\n\n  const allDeps: Record<string, string> = {};\n  const workspacePackages = getMonorepoPackages(rootDir);\n  const ignore = options?.ignore || new Set();\n  Object.entries(projectDeps).forEach(([depName, depVersion]) => {\n    if (\n      depName.startsWith('@blinkk/root') &&\n      depVersion.startsWith('workspace:')\n    ) {\n      const packageInfo = workspacePackages[depName];\n      if (packageInfo) {\n        allDeps[depName] = packageInfo.packageJson.version;\n      }\n    } else if (depVersion.startsWith('workspace:')) {\n      // For internal packages within the workspace, recursively collect the\n      // deps from those packages.\n      if (ignore.has(depName)) {\n        return;\n      }\n      ignore.add(depName);\n      const packageInfo = workspacePackages[depName];\n      if (packageInfo) {\n        const workspacePackageDir = packageInfo.path;\n        const deps = flattenPackageDepsFromMonorepo(workspacePackageDir, {\n          ignore: ignore,\n        });\n        for (const key in deps) {\n          const currentValue = allDeps[key];\n          if (\n            deps[key] &&\n            deps[key] !== '*' &&\n            (!currentValue || currentValue === '*')\n          ) {\n            allDeps[key] = deps[key];\n          }\n        }\n      }\n    } else if (depVersion === '*' && monorepoDeps[depName]) {\n      // For any dependencies using a wildcard version `*`, if the top-level\n      // package.json has the depdenency defined, overwrite the version.\n      allDeps[depName] = monorepoDeps[depName];\n    } else {\n      allDeps[depName] = depVersion;\n    }\n  });\n  return sortDeps(allDeps);\n}\n\nfunction sortDeps(deps: Record<string, string>): Record<string, string> {\n  const keys = Object.keys(deps).sort();\n  const sortedDeps: Record<string, string> = {};\n  for (const key of keys) {\n    sortedDeps[key] = deps[key];\n  }\n  return sortedDeps;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\n\nimport fsExtra from 'fs-extra';\nimport glob from 'tiny-glob';\n\nexport function isJsFile(filename: string) {\n  return !!filename.match(/\\.(j|t)sx?$/);\n}\n\nexport async function writeFile(filepath: string, content: string) {\n  const dirPath = path.dirname(filepath);\n  await makeDir(dirPath);\n  await fs.promises.writeFile(filepath, content);\n}\n\nexport async function makeDir(dirpath: string) {\n  try {\n    await fs.promises.access(dirpath);\n  } catch (e) {\n    await fs.promises.mkdir(dirpath, {recursive: true});\n  }\n}\n\nexport async function copyDir(srcdir: string, dstdir: string) {\n  if (!fsExtra.existsSync(srcdir)) {\n    return;\n  }\n  fsExtra.copySync(srcdir, dstdir, {overwrite: true});\n}\n\n/**\n * Copies a glob of files from one directory to another.\n *\n * Example:\n *\n * ```\n * await copyGlob('*.css', 'src/styles', 'dist/html/styles');\n * ```\n */\nexport async function copyGlob(\n  pattern: string,\n  srcdir: string,\n  dstdir: string\n) {\n  const files = await glob(pattern, {cwd: srcdir});\n  if (files.length > 0) {\n    await makeDir(dstdir);\n  }\n  files.forEach((file) => {\n    fsExtra.copySync(path.resolve(srcdir, file), path.resolve(dstdir, file));\n  });\n}\n\nexport async function rmDir(dirpath: string) {\n  await fs.promises.rm(dirpath, {recursive: true, force: true});\n}\n\nexport async function loadJson<T = unknown>(filepath: string): Promise<T> {\n  const content = await fs.promises.readFile(filepath, 'utf-8');\n  return JSON.parse(content);\n}\n\nexport function loadJsonSync<T = unknown>(filepath: string): T {\n  const content = fs.readFileSync(filepath, 'utf-8');\n  return JSON.parse(content);\n}\n\nexport async function writeJson(filepath: string, data: any) {\n  const content = JSON.stringify(data, null, 2);\n  await writeFile(filepath, content);\n}\n\nexport async function isDirectory(dirpath: string) {\n  return fs.promises\n    .stat(dirpath)\n    .then((fsStat) => {\n      return fsStat.isDirectory();\n    })\n    .catch((err) => {\n      if (err.code === 'ENOENT') {\n        return false;\n      }\n      throw err;\n    });\n}\n\nexport function fileExists(filepath: string): Promise<boolean> {\n  return fs.promises\n    .access(filepath)\n    .then(() => true)\n    .catch(() => false);\n}\n\nexport function fileExistsSync(filepath: string): boolean {\n  try {\n    fs.accessSync(filepath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function dirExists(dirpath: string): Promise<boolean> {\n  try {\n    const stat = await fs.promises.stat(dirpath);\n    return stat.isDirectory();\n  } catch (error) {\n    if (error.code === 'ENOENT') {\n      return false;\n    }\n    throw error;\n  }\n}\n\nexport async function directoryContains(\n  dirpath: string,\n  subpath: string\n): Promise<boolean> {\n  const outer = await fs.promises.realpath(dirpath);\n  const inner = await fs.promises.realpath(subpath);\n  const rel = path.relative(outer, inner);\n  return !rel.startsWith('..');\n}\n\nexport async function listFilesRecursive(dirPath: string): Promise<string[]> {\n  const files: string[] = [];\n  const entries = await fs.promises.readdir(dirPath, {withFileTypes: true});\n  for (const entry of entries) {\n    const fullPath = path.join(dirPath, entry.name);\n    if (entry.isDirectory()) {\n      const subFiles = await listFilesRecursive(fullPath);\n      files.push(...subFiles);\n    } else {\n      files.push(fullPath);\n    }\n  }\n  return files;\n}\n","import path from 'node:path';\nimport {bundleRequire} from 'bundle-require';\nimport {build, Plugin as EsbuildPlugin} from 'esbuild';\nimport {RootConfig} from '../core/config.js';\nimport {fileExists} from '../utils/fsutils.js';\nimport {flattenPackageDepsFromMonorepo} from './monorepo.js';\n\nexport interface ConfigOptions {\n  command: string;\n}\n\nexport async function loadRootConfig(\n  rootDir: string,\n  options: ConfigOptions\n): Promise<RootConfig> {\n  const configPath = path.resolve(rootDir, 'root.config.ts');\n  const exists = await fileExists(configPath);\n  if (!exists) {\n    throw new Error(`${configPath} does not exist`);\n  }\n  const configBundle = await bundleRequire({\n    filepath: configPath,\n    esbuildOptions: {plugins: [esbuildExternalsPlugin({rootDir})]},\n  });\n  let config = configBundle.mod.default || {};\n  if (typeof config === 'function') {\n    config = (await config(options)) || {};\n  }\n  return Object.assign({}, config, {rootDir});\n}\n\n/**\n * Compiles a root.config.ts file to root.config.js.\n */\nexport async function bundleRootConfig(rootDir: string, outPath: string) {\n  const configPath = path.resolve(rootDir, 'root.config.ts');\n  const configExists = await fileExists(configPath);\n  if (!configExists) {\n    throw new Error(`${configPath} does not exist`);\n  }\n  await build({\n    entryPoints: [configPath],\n    bundle: true,\n    minify: true,\n    platform: 'node',\n    outfile: outPath,\n    sourcemap: 'inline',\n    metafile: true,\n    format: 'esm',\n    plugins: [esbuildExternalsPlugin({rootDir})],\n  });\n}\n\n/**\n * Loads a pre-bundled config file from dist/root.config.js.\n */\nexport async function loadBundledConfig(\n  rootDir: string,\n  options: ConfigOptions\n): Promise<RootConfig> {\n  const configPath = path.resolve(rootDir, 'dist/root.config.js');\n  const exists = await fileExists(configPath);\n  if (!exists) {\n    throw new Error(`${configPath} does not exist`);\n  }\n  const module = await import(configPath);\n  let config = module.default || {};\n  if (typeof config === 'function') {\n    config = (await config(options)) || {};\n  }\n  return Object.assign({}, config, {rootDir});\n}\n\n/**\n * Externalizes node_modules deps from the package and any dependent packages\n * from the monorepo.\n */\nfunction esbuildExternalsPlugin(options: {rootDir: string}): EsbuildPlugin {\n  const rootDir = options.rootDir;\n  const allDeps = flattenPackageDepsFromMonorepo(rootDir);\n\n  function getPackageName(id: string): string {\n    const segments = id.split('/');\n    if (segments.length > 1) {\n      // Check if package is an org path like `@blinkk/root`.\n      if (segments[0].startsWith('@') && segments[0].length > 1) {\n        return `${segments[0]}/${segments[1]}`;\n      }\n      // For imports like `my-package/subpackage`, return `my-package`.\n      return segments[0];\n    }\n    return id;\n  }\n\n  return {\n    name: 'root-externals-plugin',\n    setup(build) {\n      build.onResolve({filter: /.*/}, (args) => {\n        const id = args.path;\n        if (id[0] !== '.' && !id.startsWith('@/')) {\n          const packageName = getPackageName(id);\n          if (packageName in allDeps) {\n            return {\n              external: true,\n            };\n          }\n        }\n        return null;\n      });\n    },\n  };\n}\n","import {createServer, ViteDevServer} from 'vite';\nimport {RootConfig} from '../core/config.js';\nimport {getVitePlugins} from '../core/plugin.js';\n\nexport interface CreateViteServerOptions {\n  /** Override HMR settings. */\n  hmr?: boolean;\n  /** The port the server will run on. */\n  port?: number;\n  /** List of files to include in the optimizeDeps.include config. */\n  optimizeDeps?: string[];\n}\n\n/**\n * Returns a vite dev server.\n */\nexport async function createViteServer(\n  rootConfig: RootConfig,\n  options?: CreateViteServerOptions\n): Promise<ViteDevServer> {\n  const rootDir = rootConfig.rootDir;\n  const viteConfig = rootConfig.vite || {};\n\n  let hmrOptions = viteConfig.server?.hmr;\n  if (options?.hmr === false) {\n    hmrOptions = false;\n  } else if (typeof hmrOptions === 'undefined' && options?.port) {\n    // Automatically set the HMR port to `port + 10`. This allows multiple\n    // root.js dev servers to run without conflicts.\n    hmrOptions = {port: options.port + 10};\n  }\n\n  const viteServer = await createServer({\n    ...viteConfig,\n    mode: 'development',\n    root: rootDir,\n    // publicDir is disabled from the vite dev server since it's handled by the\n    // root dev server directly, which allows user middlewares to override\n    // files in the public dir.\n    publicDir: false,\n    server: {\n      ...(viteConfig.server || {}),\n      middlewareMode: true,\n      hmr: hmrOptions,\n    },\n    appType: 'custom',\n    optimizeDeps: {\n      // As of vite v5 / esbuild v19, experimentalDecorators need to be\n      // explicitly set, and for some reason this option isn't read from the\n      // project's tsconfig.json file by default.\n      // See: https://vitejs.dev/blog/announcing-vite5\n      esbuildOptions: {\n        tsconfigRaw: {\n          compilerOptions: {\n            target: 'esnext',\n            experimentalDecorators: true,\n            useDefineForClassFields: false,\n          },\n        },\n      },\n      ...(viteConfig.optimizeDeps || {}),\n      include: [\n        ...(options?.optimizeDeps || []),\n        ...(viteConfig.optimizeDeps?.include || []),\n      ],\n      extensions: [...(viteConfig.optimizeDeps?.extensions || []), '.tsx'],\n    },\n    ssr: {\n      ...(viteConfig.ssr || {}),\n      noExternal: ['@blinkk/root', '@blinkk/root-cms/richtext'],\n    },\n    esbuild: {\n      ...(viteConfig.esbuild || {}),\n      jsx: 'automatic',\n      jsxImportSource: 'preact',\n    },\n    plugins: [\n      ...(viteConfig.plugins || []),\n      ...getVitePlugins(rootConfig.plugins || []),\n    ],\n  });\n  return viteServer;\n}\n\n/**\n * Shortcut `viteServer.ssrLoadModule()` without starting an actual dev server.\n */\nexport async function viteSsrLoadModule(\n  rootConfig: RootConfig,\n  file: string\n): Promise<Record<string, any>> {\n  const viteServer = await createViteServer(rootConfig, {hmr: false});\n  const module = await viteServer.ssrLoadModule(file);\n  await viteServer.close();\n  return module;\n}\n"],"mappings":"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","names":["path","path","path","path","build"]}

package/dist/{chunk-ZUUGSC6Z.js → chunk-MA6MSEP4.js}

@@ -32,4 +32,4 @@ export {
   configureServerPlugins,
   getVitePlugins
 };
-//# sourceMappingURL=chunk-ZUUGSC6Z.js.map
+//# sourceMappingURL=chunk-MA6MSEP4.js.map

package/dist/chunk-MA6MSEP4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/plugin.ts"],"sourcesContent":["import {ViteDevServer, PluginOption as VitePlugin} from 'vite';\nimport {RootConfig} from './config.js';\nimport {NextFunction, Request, Response, Server} from './types.js';\n\ntype MaybePromise<T> = T | Promise<T>;\n\nexport type ConfigureServerHook = (\n  server: Server,\n  options: ConfigureServerOptions\n) => MaybePromise<void> | MaybePromise<() => void>;\n\nexport interface ConfigureServerOptions {\n  type: 'dev' | 'preview' | 'prod';\n  rootConfig: RootConfig;\n}\n\nexport interface PluginHooks {\n  /**\n   * Post-render hook that's called before the HTML is rendered to the response\n   * object. If a string is returned from this hook, it will replace the\n   * rendered HTML.\n   */\n  preRender: (html: string) => void | string | Promise<string>;\n}\n\nexport interface Plugin {\n  [key: string]: any;\n  /** The name of the plugin. */\n  name?: string;\n  /**\n   * Configures the root.js express server. Any middleware defined by the plugin\n   * will be added to the server first. If a callback fn is returned, it will\n   * be called after the root.js middlewares are added.\n   */\n  configureServer?: ConfigureServerHook;\n  /**\n   * Hook for file changes.\n   */\n  onFileChange?: (\n    eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir',\n    path: string\n  ) => void;\n  /**\n   * Returns a list of deps to bundle for ssr. The files will be bundled and\n   * output to `dist/server/`. The return value should be a map of\n   * `{output filename => input filepath}`.\n   *\n   * E.g. a value of `{foo: 'path/to/bar.js'}` will output `dist/server/foo.js`.\n   *\n   * @experimental This config is subject to change to be incorporated into a\n   * broader config option called \"ssr\" or \"ssrOptions\".\n   */\n  ssrInput?: () => {[entryAlias: string]: string};\n  /** Adds vite plugins. */\n  vitePlugins?: VitePlugin[];\n  /** Plugin lifecycle callback hooks. */\n  hooks?: PluginHooks;\n  /** Custom 404 handler. */\n  handle404?: (\n    req: Request,\n    res: Response,\n    next: NextFunction\n  ) => void | Promise<void>;\n}\n\n/**\n * Runs the pre-hook configureServer method of every plugin, calls a callback\n * function, and then runs the configureServer's post-hook if provided. Plugins\n * provide a post-hook by returning a callback function from configureServer.\n */\nexport async function configureServerPlugins(\n  server: Server,\n  callback: () => Promise<void>,\n  plugins: Plugin[],\n  options: ConfigureServerOptions\n) {\n  const postHooks: Array<() => void> = [];\n  const viteServer = server.get('viteServer') as ViteDevServer;\n\n  // Call the `configureServer()` method for each plugin.\n  for (const plugin of plugins) {\n    if (plugin.configureServer) {\n      const postHook = await plugin.configureServer(server, options);\n      if (postHook) {\n        postHooks.push(postHook);\n      }\n    }\n\n    if (viteServer && plugin.onFileChange) {\n      viteServer.watcher.on('all', plugin.onFileChange);\n    }\n  }\n\n  // Register any built-in middleware.\n  callback();\n\n  // Run any post hooks returned by `plugin.configureServer()`.\n  for (const postHook of postHooks) {\n    await postHook();\n  }\n}\n\nexport function getVitePlugins(plugins: Plugin[]): VitePlugin[] {\n  const vitePlugins: VitePlugin[] = [];\n  for (const plugin of plugins) {\n    if (plugin.vitePlugins) {\n      vitePlugins.push(...plugin.vitePlugins);\n    }\n  }\n  return vitePlugins;\n}\n"],"mappings":";AAsEA,eAAsB,uBACpB,QACA,UACA,SACA,SACA;AACA,QAAM,YAA+B,CAAC;AACtC,QAAM,aAAa,OAAO,IAAI,YAAY;AAG1C,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,iBAAiB;AAC1B,YAAM,WAAW,MAAM,OAAO,gBAAgB,QAAQ,OAAO;AAC7D,UAAI,UAAU;AACZ,kBAAU,KAAK,QAAQ;AAAA,MACzB;AAAA,IACF;AAEA,QAAI,cAAc,OAAO,cAAc;AACrC,iBAAW,QAAQ,GAAG,OAAO,OAAO,YAAY;AAAA,IAClD;AAAA,EACF;AAGA,WAAS;AAGT,aAAW,YAAY,WAAW;AAChC,UAAM,SAAS;AAAA,EACjB;AACF;AAEO,SAAS,eAAe,SAAiC;AAC9D,QAAM,cAA4B,CAAC;AACnC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,aAAa;AACtB,kBAAY,KAAK,GAAG,OAAO,WAAW;AAAA,IACxC;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { S as Server } from './types-RwR6rV2O.js';
+import { S as Server } from './types-Mr1zFAT1.js';
 import 'express';
 import 'preact';
 import 'vite';
@@ -9,6 +9,7 @@ interface BuildOptions {
     ssrOnly?: boolean;
     mode?: string;
     concurrency?: string | number;
+    filter?: string;
 }
 declare function build(rootProjectDir?: string, options?: BuildOptions): Promise<void>;
 
@@ -18,6 +19,7 @@ interface CreatePackageOptions {
     out?: string;
     target?: DeployTarget;
     version?: string;
+    appYaml?: string;
 }
 declare function createPackage(rootProjectDir?: string, options?: CreatePackageOptions): Promise<void>;
 
@@ -53,4 +55,4 @@ declare class CliRunner {
     run(argv: string[]): Promise<void>;
 }
 
-export { CliRunner, build, createDevServer, createPackage, createPreviewServer, createProdServer, dev, preview, start };
+export { type BuildOptions, CliRunner, build, createDevServer, createPackage, createPreviewServer, createProdServer, dev, preview, start };

package/dist/cli.js

@@ -8,11 +8,11 @@ import {
   dev,
   preview,
   start
-} from "./chunk-7D26JHIF.js";
+} from "./chunk-A4DNVP34.js";
 import "./chunk-DISVDCLA.js";
-import "./chunk-UJ6F5RQ5.js";
-import "./chunk-ZUUGSC6Z.js";
-import "./chunk-5YDJSEDK.js";
+import "./chunk-HTBDTUFE.js";
+import "./chunk-MA6MSEP4.js";
+import "./chunk-3KGEENDW.js";
 export {
   CliRunner,
   build,

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { R as Route } from './types-RwR6rV2O.js';
-export { j as ConfigureServerHook, k as ConfigureServerOptions, C as ContentSecurityPolicyConfig, p as GetStaticPaths, G as GetStaticProps, t as Handler, H as HandlerContext, w as HandlerRenderFn, v as HandlerRenderOptions, L as LocaleGroup, M as MultipartFile, N as NextFunction, l as Plugin, P as PluginHooks, r as Request, q as RequestMiddleware, s as Response, c as RootConfig, a as RootExperimentsConfig, f as RootHeaderConfig, d as RootI18nConfig, e as RootRedirectConfig, g as RootSecurityConfig, h as RootServerConfig, b as RootUserConfig, u as RouteModule, o as RouteParams, S as Server, x as Sitemap, y as SitemapItem, X as XFrameOptionsConfig, m as configureServerPlugins, i as defineConfig, n as getVitePlugins } from './types-RwR6rV2O.js';
+import { R as Route } from './types-Mr1zFAT1.js';
+export { j as ConfigureServerHook, k as ConfigureServerOptions, C as ContentSecurityPolicyConfig, v as GetStaticContent, p as GetStaticPaths, G as GetStaticProps, t as Handler, H as HandlerContext, y as HandlerRenderFn, x as HandlerRenderOptions, L as LocaleGroup, M as MultipartFile, N as NextFunction, l as Plugin, P as PluginHooks, r as Request, q as RequestMiddleware, s as Response, d as RootBuildConfig, b as RootConfig, f as RootHeaderConfig, c as RootI18nConfig, e as RootRedirectConfig, g as RootSecurityConfig, h as RootServerConfig, a as RootUserConfig, w as RouteModule, o as RouteParams, S as Server, z as Sitemap, A as SitemapItem, u as StaticContentResult, X as XFrameOptionsConfig, m as configureServerPlugins, i as defineConfig, n as getVitePlugins } from './types-Mr1zFAT1.js';
 import * as preact$1 from 'preact';
 import { FunctionalComponent, ComponentChildren } from 'preact';
 import 'express';
@@ -72,7 +72,9 @@ type HtmlProps = preact$1.JSX.HTMLAttributes<HTMLHtmlElement> & {
  */
 declare const Html: FunctionalComponent<HtmlProps>;
 
-type ScriptProps = preact.JSX.HTMLAttributes<HTMLScriptElement>;
+type ScriptProps = preact.JSX.HTMLAttributes<HTMLScriptElement> & {
+    src?: string;
+};
 /**
  * The <Script> component is used for rendering any custom script modules. At
  * the moment, the system only pre-renders and bundles files that are in the
@@ -87,7 +89,11 @@ type ScriptProps = preact.JSX.HTMLAttributes<HTMLScriptElement>;
 declare const Script: FunctionalComponent<ScriptProps>;
 
 type StringParamsContext = Record<string, string>;
-declare const StringParamsProvider: preact$1.Provider<StringParamsContext | null>;
+interface StringParamsProviderProps {
+    value?: StringParamsContext;
+    children?: ComponentChildren;
+}
+declare const StringParamsProvider: FunctionalComponent<StringParamsProviderProps>;
 /**
  * A hook that returns a map of string params, configured via the
  * `StringParamsProvider` context provider. These params are automatically
@@ -115,6 +121,30 @@ declare const StringParamsProvider: preact$1.Provider<StringParamsContext | null
  */
 declare function useStringParams(): StringParamsContext;
 
+type TransformFn = (str: string) => string;
+interface TranslationMiddleware {
+    /** Transform the string before translation lookup. */
+    beforeTranslate?: TransformFn;
+    /** Transform the string after translation lookup. */
+    afterTranslate?: TransformFn;
+    /** Transform the string before `{param}` values are replaced. */
+    beforeReplaceParams?: TransformFn;
+    /** Transform the string after `{param}` values are replaced. */
+    afterReplaceParams?: TransformFn;
+}
+interface TranslationMiddlewareContext {
+    beforeTranslateFns: TransformFn[];
+    afterTranslateFns: TransformFn[];
+    beforeReplaceParamsFns: TransformFn[];
+    afterReplaceParamsFns: TransformFn[];
+}
+interface TranslationMiddlewareProviderProps {
+    value?: TranslationMiddleware;
+    children?: ComponentChildren;
+}
+declare const TranslationMiddlewareProvider: FunctionalComponent<TranslationMiddlewareProviderProps>;
+declare function useTranslationMiddleware(): TranslationMiddlewareContext;
+
 interface I18nContext {
     locale: string;
     translations: Record<string, string>;
@@ -175,4 +205,4 @@ declare function useRequestContext(): RequestContext;
  */
 declare function useTranslations(): (str: string, params?: Record<string, string | number>) => string;
 
-export { Body, HTML_CONTEXT, Head, Html, type I18nContext, type RequestContext, Route, Script, type StringParamsContext, StringParamsProvider, getTranslations, useI18nContext, useRequestContext, useStringParams, useTranslations };
+export { Body, HTML_CONTEXT, Head, Html, type I18nContext, type RequestContext, Route, Script, type StringParamsContext, StringParamsProvider, TranslationMiddlewareProvider, getTranslations, useI18nContext, useRequestContext, useStringParams, useTranslationMiddleware, useTranslations };

package/dist/core.js

@@ -1,7 +1,7 @@
 import {
   configureServerPlugins,
   getVitePlugins
-} from "./chunk-ZUUGSC6Z.js";
+} from "./chunk-MA6MSEP4.js";
 import {
   HTML_CONTEXT,
   Html,
@@ -56,17 +56,63 @@ var Script = (props) => {
   return null;
 };
 
-// src/core/hooks/useStringParams.ts
+// src/core/hooks/useStringParams.tsx
 import { createContext } from "preact";
 import { useContext as useContext4 } from "preact/hooks";
+import { jsx as jsx2 } from "preact/jsx-runtime";
 var STRING_PARAMS_CONTEXT = createContext(
   null
 );
-var StringParamsProvider = STRING_PARAMS_CONTEXT.Provider;
+var StringParamsProvider = (props) => {
+  const parent = useContext4(STRING_PARAMS_CONTEXT) || {};
+  const merged = { ...parent, ...props.value };
+  return /* @__PURE__ */ jsx2(STRING_PARAMS_CONTEXT.Provider, { value: merged, children: props.children });
+};
 function useStringParams() {
   return useContext4(STRING_PARAMS_CONTEXT) || {};
 }
 
+// src/core/hooks/useTranslationsMiddleware.tsx
+import { createContext as createContext2 } from "preact";
+import { useContext as useContext5 } from "preact/hooks";
+import { jsx as jsx3 } from "preact/jsx-runtime";
+var TRANSLATION_MIDDLEWARE_CONTEXT = createContext2(null);
+var TranslationMiddlewareProvider = (props) => {
+  const parent = useContext5(TRANSLATION_MIDDLEWARE_CONTEXT) || {
+    beforeTranslateFns: [],
+    afterTranslateFns: [],
+    beforeReplaceParamsFns: [],
+    afterReplaceParamsFns: []
+  };
+  const merged = {
+    beforeTranslateFns: [...parent.beforeTranslateFns],
+    afterTranslateFns: [...parent.afterTranslateFns],
+    beforeReplaceParamsFns: [...parent.beforeReplaceParamsFns],
+    afterReplaceParamsFns: [...parent.afterReplaceParamsFns]
+  };
+  if (props.value?.beforeTranslate) {
+    merged.beforeTranslateFns.push(props.value.beforeTranslate);
+  }
+  if (props.value?.afterTranslate) {
+    merged.afterTranslateFns.push(props.value.afterTranslate);
+  }
+  if (props.value?.beforeReplaceParams) {
+    merged.beforeReplaceParamsFns.push(props.value.beforeReplaceParams);
+  }
+  if (props.value?.afterReplaceParams) {
+    merged.afterReplaceParamsFns.push(props.value.afterReplaceParams);
+  }
+  return /* @__PURE__ */ jsx3(TRANSLATION_MIDDLEWARE_CONTEXT.Provider, { value: merged, children: props.children });
+};
+function useTranslationMiddleware() {
+  return useContext5(TRANSLATION_MIDDLEWARE_CONTEXT) || {
+    beforeTranslateFns: [],
+    afterTranslateFns: [],
+    beforeReplaceParamsFns: [],
+    afterReplaceParamsFns: []
+  };
+}
+
 // src/core/hooks/useTranslations.ts
 function useTranslations() {
   let i18nContext = null;
@@ -77,14 +123,28 @@ function useTranslations() {
   }
   const translations = i18nContext?.translations || {};
   const stringParams = useStringParams();
+  const middleware = useTranslationMiddleware();
   const t = (str, params) => {
-    const key = normalizeString(str);
-    let translation = translations[key] ?? key ?? "";
-    const allParams = { ...stringParams, ...params };
-    for (const paramName of Object.keys(allParams)) {
-      const paramValue = String(allParams[paramName] ?? "");
-      translation = translation.replaceAll(`{${paramName}}`, paramValue);
+    let input = normalizeString(str);
+    middleware.beforeTranslateFns.forEach((fn) => {
+      input = fn(input);
+    });
+    let translation = translations[input] ?? input ?? "";
+    middleware.afterTranslateFns.forEach((fn) => {
+      translation = fn(translation);
+    });
+    middleware.beforeReplaceParamsFns.forEach((fn) => {
+      translation = fn(translation);
+    });
+    if (testHasStringParams(translation)) {
+      translation = replaceStringParams(translation, {
+        ...stringParams,
+        ...params
+      });
     }
+    middleware.afterReplaceParamsFns.forEach((fn) => {
+      translation = fn(translation);
+    });
     return translation;
   };
   return t;
@@ -96,6 +156,17 @@ function normalizeString(str) {
 function removeTrailingWhitespace(str) {
   return String(str).trimEnd().replace(/ $/, "");
 }
+function testHasStringParams(str) {
+  return str.includes("{") && str.includes("}");
+}
+function replaceStringParams(str, params) {
+  return str.replace(/{([^}]+)}/g, (match, key) => {
+    if (key in params) {
+      return String(params[key]);
+    }
+    return match;
+  });
+}
 export {
   Body,
   HTML_CONTEXT,
@@ -103,6 +174,7 @@ export {
   Html,
   Script,
   StringParamsProvider,
+  TranslationMiddlewareProvider,
   configureServerPlugins,
   defineConfig,
   getTranslations,
@@ -110,6 +182,7 @@ export {
   useI18nContext,
   useRequestContext,
   useStringParams,
+  useTranslationMiddleware,
   useTranslations
 };
 //# sourceMappingURL=core.js.map