@blinkk/root 3.3.1 → 3.4.1

package/dist/{chunk-KHO3HMX6.js → chunk-Y4H75NIO.js}

@@ -89,7 +89,10 @@ async function directoryContains(dirpath, subpath) {
 
 // src/node/monorepo.ts
 import path2 from "node:path";
-import { getWorkspaces, getWorkspaceRoot } from "workspace-tools";
+import {
+  getWorkspaceInfos,
+  getWorkspaceManagerRoot
+} from "workspace-tools";
 function loadPackageJson(filepath) {
   if (!fileExistsSync(filepath)) {
     return null;
@@ -97,11 +100,11 @@ function loadPackageJson(filepath) {
   return loadJsonSync(filepath);
 }
 function getMonorepoPackages(rootDir) {
-  const monorepoRoot = getWorkspaceRoot(rootDir);
+  const monorepoRoot = getWorkspaceManagerRoot(rootDir);
   if (!monorepoRoot) {
     return {};
   }
-  const workspaces = getWorkspaces(monorepoRoot);
+  const workspaces = getWorkspaceInfos(monorepoRoot) || [];
   const packages = {};
   workspaces.forEach((workspaceInfo) => {
     packages[workspaceInfo.name] = workspaceInfo;
@@ -109,7 +112,7 @@ function getMonorepoPackages(rootDir) {
   return packages;
 }
 function getMonorepoPackageDeps(rootDir) {
-  const monorepoRoot = getWorkspaceRoot(rootDir);
+  const monorepoRoot = getWorkspaceManagerRoot(rootDir);
   if (!monorepoRoot) {
     return {};
   }
@@ -288,4 +291,4 @@ export {
   bundleRootConfig,
   loadBundledConfig
 };
-//# sourceMappingURL=chunk-KHO3HMX6.js.map
+//# sourceMappingURL=chunk-Y4H75NIO.js.map

package/dist/chunk-Y4H75NIO.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/utils/fsutils.ts", "../src/node/monorepo.ts", "../src/node/load-config.ts"],
+  "sourcesContent": ["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 {\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 {\n  getWorkspaceInfos,\n  getWorkspaceManagerRoot,\n  PackageInfo,\n} 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 = getWorkspaceManagerRoot(rootDir);\n  if (!monorepoRoot) {\n    return {};\n  }\n\n  const workspaces = getWorkspaceInfos(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 = getWorkspaceManagerRoot(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 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 {rootConfig} = await loadRootConfigWithDeps(rootDir, options);\n  return rootConfig;\n}\n\nexport async function loadRootConfigWithDeps(\n  rootDir: string,\n  options: ConfigOptions\n): Promise<{rootConfig: RootConfig; dependencies: string[]}> {\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  const rootConfig = Object.assign({}, config, {rootDir});\n  validateRootconfig(rootConfig);\n  return {rootConfig, dependencies: configBundle.dependencies};\n}\n\nfunction validateRootconfig(rootConfig: RootConfig) {\n  // Update vite legacy config options.\n  const scss: any = rootConfig.vite?.css?.preprocessorOptions?.scss;\n  if (scss?.includePaths) {\n    console.warn(\n      '[deprecation warning] root.config.ts: vite.css.preprocessorOptions.scss.includePaths is deprecated. rename \"includePaths\" -> \"loadPaths\"'\n    );\n    scss.loadPaths = scss.includePaths;\n  }\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"],
+  "mappings": "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",
+  "names": ["path", "path", "path", "path", "build"]
+}

package/dist/cli.js

@@ -8,11 +8,11 @@ import {
   dev,
   preview,
   start
-} from "./chunk-WGQNQPWG.js";
-import "./chunk-YU22SAIG.js";
+} from "./chunk-WRZLI2L2.js";
+import "./chunk-QJ4F45DC.js";
 import "./chunk-I3RCAIW7.js";
-import "./chunk-M3E4RKS7.js";
-import "./chunk-KHO3HMX6.js";
+import "./chunk-DLPHCMFV.js";
+import "./chunk-Y4H75NIO.js";
 import "./chunk-3PWR4F2R.js";
 import "./chunk-XSNCF7WU.js";
 import "./chunk-TM6QRBGS.js";

package/dist/core/config.d.ts

@@ -48,6 +48,22 @@ export interface RootUserConfig {
          */
         entries?: string[];
     };
+    /**
+     * Whether to auto-inject `<link rel="modulepreload">` tags for the JS chunks
+     * imported by the page's `<script type="module">` tags. Disabled by default;
+     * pass `modulePreload: true` to opt in.
+     *
+     * Root injects a `<script type="module">` tag for every custom element and
+     * bundle used on the page, but the shared chunks those scripts import are
+     * only discovered once the browser has downloaded and parsed the script.
+     * Preloading them removes that request waterfall.
+     *
+     * Chunks that are already injected as `<script>` tags are skipped, and no
+     * tags are injected by the dev server (where modules are served unbundled).
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/modulepreload}
+     */
+    modulePreload?: boolean;
     /**
      * Config options for localization and internationalization.
      */

package/dist/core/core.d.ts

@@ -3,6 +3,7 @@ export { Body } from './components/Body.js';
 export { Head } from './components/Head.js';
 export { Html, HTML_CONTEXT } from './components/Html.js';
 export { Script } from './components/Script.js';
+export { useAsset, useAssetMap, useAssetUrl } from './hooks/useAssetMap.js';
 export { StringParamsContext, StringParamsProvider, useStringParams, } from './hooks/useStringParams.js';
 export { TranslationMiddlewareProvider, useTranslationMiddleware, } from './hooks/useTranslationsMiddleware.js';
 export { I18nContext, useI18nContext, getTranslations, } from './hooks/useI18nContext.js';

package/dist/core/hooks/useAssetMap.d.ts

@@ -0,0 +1,22 @@
+import type { Asset, AssetMap } from '../../render/asset-map/asset-map.js';
+export declare const ASSET_MAP_CONTEXT: import("preact").Context<AssetMap | null>;
+/**
+ * Returns the asset map for the current render.
+ */
+export declare function useAssetMap(): AssetMap;
+/**
+ * Returns an asset from the project's module graph. Paths are relative to the
+ * project root and may optionally start with `/`.
+ */
+export declare function useAsset(src: string): Asset;
+/**
+ * Returns the serving URL for a file compiled from the project's module graph.
+ *
+ * Usage:
+ *
+ * ```tsx
+ * const customJs = useAssetUrl('/bundles/foo.ts');
+ * return <div data-custom-js={customJs} />;
+ * ```
+ */
+export declare function useAssetUrl(src: string): string;

package/dist/core.js

@@ -4,9 +4,12 @@ import {
   getTranslations,
   replaceParams,
   testPathHasParams,
+  useAsset,
+  useAssetMap,
+  useAssetUrl,
   useI18nContext,
   useRequestContext
-} from "./chunk-KW7KTYGC.js";
+} from "./chunk-6QWKKJOB.js";
 import {
   configureServerPlugins,
   getVitePlugins
@@ -192,6 +195,9 @@ export {
   getVitePlugins,
   replaceParams,
   testPathHasParams,
+  useAsset,
+  useAssetMap,
+  useAssetUrl,
   useI18nContext,
   useRequestContext,
   useStringParams,

package/dist/core.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/core/config.ts", "../src/core/components/Body.tsx", "../src/core/components/Head.ts", "../src/core/components/Script.ts", "../src/core/hooks/useStringParams.tsx", "../src/core/hooks/useTranslationsMiddleware.tsx", "../src/core/hooks/useTranslations.ts", "../src/core/pod.ts"],
-  "sourcesContent": ["import {UserConfig as ViteUserConfig} from 'vite';\nimport {JsxRenderOptions} from '../jsx/jsx-render.js';\nimport {HtmlMinifyOptions} from '../render/html-minify.js';\nimport {HtmlPrettyOptions} from '../render/html-pretty.js';\nimport {Plugin} from './plugin.js';\nimport {PodConfig} from './pod.js';\nimport {RequestMiddleware} from './types.js';\n\nexport interface RootUserConfig {\n  /**\n   * Canonical domain the website will serve on. Useful for things like the\n   * sitemap, SEO tags, etc.\n   */\n  domain?: string;\n\n  /**\n   * The base URL path that the site will serve on. Defaults to `/`;\n   */\n  base?: string;\n\n  /**\n   * Config for auto-injecting custom element dependencies.\n   */\n  elements?: {\n    /**\n     * A list of directories to use to look for custom elements. The dir path\n     * should be relative to the project dir, e.g. \"path/to/elements\".\n     */\n    include?: string[];\n\n    /**\n     * A list of RegEx patterns to exclude. The string passed to the RegEx is\n     * the file URL relative to the project root, e.g. \"/elements/foo/foo.ts\".\n     */\n    exclude?: RegExp[];\n  };\n\n  /**\n   * Config for manually injecting stylesheet entries as\n   * `<link rel=\"stylesheet\">` tags.\n   */\n  styles?: {\n    /**\n     * Project-root-relative stylesheet files to include on every rendered\n     * page, e.g. `styles/index.css`.\n     *\n     * Entries are normalized as URL paths, so both `styles/index.css` and\n     * `/styles/index.css` resolve to `/styles/index.css`.\n     *\n     * Manual entries are injected first, then auto-collected CSS\n     * dependencies are merged after. Duplicate URLs are de-duped so each\n     * stylesheet is only injected once.\n     */\n    entries?: string[];\n  };\n\n  /**\n   * Config options for localization and internationalization.\n   */\n  i18n?: RootI18nConfig;\n\n  /**\n   * Config options for the Root.js express server.\n   */\n  server?: RootServerConfig;\n\n  /**\n   * Build options for the `root build` command.\n   */\n  build?: RootBuildConfig;\n\n  /**\n   * Vite config.\n   * @see {@link https://vitejs.dev/config/} for more information.\n   */\n  vite?: ViteUserConfig;\n\n  /**\n   * Config for the built-in JSX-to-HTML renderer.\n   *\n   * - `mode: 'pretty'` (default) \u2014 block-level elements render on their own\n   *   line with no indentation.\n   * - `mode: 'minimal'` \u2014 compact output with no extra whitespace.\n   *\n   * Use `blockElements` to specify additional custom element tag names that\n   * should be treated as block-level in pretty mode.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   jsxRenderer: {\n   *     mode: 'pretty',\n   *     blockElements: ['my-card', 'my-section'],\n   *   },\n   * });\n   * ```\n   */\n  jsxRenderer?: JsxRenderOptions;\n\n  /**\n   * Whether to minify HTML output via html-minifier-terser. Disabled by\n   * default; pass `minifyHtml: true` to opt in.\n   *\n   * Ignored when the built-in JSX renderer (`jsxRenderer`) is enabled, since\n   * that renderer controls its own output formatting via its `mode` option.\n   */\n  minifyHtml?: boolean;\n\n  /**\n   * Options to pass to html-minifier-terser.\n   */\n  minifyHtmlOptions?: HtmlMinifyOptions;\n\n  /**\n   * Whether to pretty print HTML output via js-beautify. Disabled by default;\n   * pass `prettyHtml: true` to opt in. When both `prettyHtml` and `minifyHtml`\n   * are set, `prettyHtml` takes precedence.\n   *\n   * Ignored when the built-in JSX renderer (`jsxRenderer`) is enabled, since\n   * that renderer controls its own output formatting via its `mode` option.\n   */\n  prettyHtml?: boolean;\n\n  /**\n   * Options to pass to js-beautify.\n   */\n  prettyHtmlOptions?: HtmlPrettyOptions;\n\n  /**\n   * Whether to include a sitemap.xml file to the build output.\n   */\n  sitemap?: boolean;\n\n  /**\n   * Plugins.\n   */\n  plugins?: Plugin[];\n\n  /**\n   * Per-pod user-level overrides. The key is the pod name as declared in\n   * Pod.name.\n   */\n  pods?: Record<string, PodConfig>;\n\n  /**\n   * Experimental config options. Note: these are subject to change at any time.\n   */\n  experiments?: {\n    /** Whether to render `<script>` tags with `async`. */\n    enableScriptAsync?: boolean;\n  };\n}\n\nexport type RootConfig = RootUserConfig & {\n  rootDir: string;\n};\n\nexport interface LocaleGroup {\n  label?: string;\n  locales: RootLocale[];\n}\n\n/**\n * A site-defined locale identifier, as configured in `i18n.locales`.\n * Root is agnostic to its format.\n */\nexport type RootLocale = string;\n\n/**\n * The language identifier used by translation systems (CSV/Sheets columns,\n * translation services, CMS translations pages), mapped from a root locale\n * via `i18n.translationLanguages`. Defaults to the root locale id.\n */\nexport type TranslationLanguage = string;\n\nexport interface RootI18nConfig {\n  /**\n   * Locales enabled for the site.\n   */\n  locales?: RootLocale[];\n\n  /**\n   * The default locale to use. Defaults is `en`.\n   */\n  defaultLocale?: RootLocale;\n\n  /**\n   * URL format for localized content. Default is `/[locale]/[base]/[path]`.\n   */\n  urlFormat?: string;\n\n  /**\n   * Localization groups, to help UIs (like Root.js CMS) logically group\n   * locales.\n   */\n  groups?: Record<string, LocaleGroup>;\n\n  /**\n   * Maps a root locale to the \"translation language\" used by translation\n   * systems. Translation systems often use different language identifiers\n   * than root locales, and multiple root locales may share the same\n   * translations. For example:\n   *\n   * ```\n   * i18n: {\n   *   locales: ['en', 'es_mx', 'es_co', 'en_gb', 'en_ca', 'fr_ca'],\n   *   translationLanguages: {\n   *     es_mx: 'es-419',\n   *     es_co: 'es-419',\n   *     en_gb: 'en-GB',\n   *     en_ca: 'en-GB',\n   *     fr_ca: 'fr-CA',\n   *   },\n   * }\n   * ```\n   *\n   * With the config above, translations for the `es_mx` and `es_co` locales\n   * are imported and exported using a single `es-419` language. The\n   * conversion applies anywhere translations are used, e.g. CSV and Google\n   * Sheets import/export, translation services, and the CMS translations\n   * pages. Locales not listed here use the locale id as the translation\n   * language.\n   */\n  translationLanguages?: Record<RootLocale, TranslationLanguage>;\n\n  /**\n   * Locale fallback chains for translations. When a translation is missing\n   * for a locale, each fallback locale is checked (in order) before falling\n   * back to `defaultLocale` and finally the source string. Fallbacks are\n   * resolved recursively, e.g. with the config below, `en-CA` resolves to\n   * `['en-CA', 'en-GB', 'en']`. For example:\n   *\n   * ```\n   * i18n: {\n   *   locales: ['en', 'en-GB', 'en-CA'],\n   *   fallbacks: {\n   *     'en-CA': ['en-GB'],\n   *   },\n   * }\n   * ```\n   */\n  fallbacks?: Record<RootLocale, RootLocale[]>;\n}\n\nexport interface RootBuildConfig {\n  /**\n   * Excludes the `/intl/{defaultLocale}/...` path from the SSG build.\n   */\n  excludeDefaultLocaleFromIntlPaths?: boolean;\n}\n\nexport interface RootRedirectConfig {\n  /**\n   * The source path to redirect. Accepts placeholders in the format\n   * `[key]` or `[...key]`. Use `[key]` for single segments and\n   * `[...key]` for multi-segment wildcards.\n   * @example \"/old-path/[id]\" or \"/old-path/[...wildcard]\"\n   */\n  source: string;\n\n  /**\n   * The destination to redirect to. Placeholders from the source can\n   * optionally be inserted into the destination using the same\n   * placeholder format.\n   * @example \"/new-path/[id]\" or \"/new-path/[...wildcard]\"\n   */\n  destination: string;\n\n  /**\n   * The redirect type (`301` = permanent, `302` = temporary). If unspecified,\n   * defaults to `302` (temporary).\n   */\n  type?: 301 | 302;\n}\n\nexport interface RootHeaderConfig {\n  /** A glob pattern match (regex not supported yet). */\n  source: string;\n  headers: Array<{\n    key: string;\n    value: string;\n  }>;\n}\n\nexport interface ContentSecurityPolicyConfig {\n  directives?: Record<string, string[]>;\n  reportOnly?: boolean;\n}\n\nexport interface XFrameOptionsConfig {\n  action: 'DENY' | 'SAMEORIGIN';\n}\n\nexport interface RootSecurityConfig {\n  /**\n   * Content-Security-Policy config. If enabled, a nonce is auto-generated\n   * for every request and appended to script and stylesheet tags. You can\n   * validate your CSP headers using a tool like {@link https://csp-evaluator.withgoogle.com/}.\n   *\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP}\n   */\n  contentSecurityPolicy?: ContentSecurityPolicyConfig | boolean;\n\n  /**\n   * Strict-Transport-Security config. When enabled, the header value is set\n   * to `Strict-Transport-Security: max-age=63072000; includeSubDomains; preload`.\n   */\n  strictTransportSecurity?: boolean;\n\n  /**\n   * X-Content-Type-Options config. When enabled, the header value is set to\n   * `X-Content-Type-Options: nosniff`.\n   */\n  xContentTypeOptions?: boolean;\n\n  /**\n   * X-Frame-Options config. Setting this value to `true` will default the\n   * header value to `X-Frame-Options: SAMEORIGIN`.\n   *\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options}\n   */\n  xFrameOptions?: 'DENY' | 'SAMEORIGIN' | boolean;\n\n  /**\n   * X-XSS-Protection config. When enabled, the header value is set to\n   * `X-XSS-Protection: 1; mode=block`.\n   */\n  xXssProtection?: boolean;\n}\n\nexport interface RootServerConfig {\n  /**\n   * An array of middleware to add to the express server. These middleware are\n   * added to the beginning of the express app.\n   */\n  middlewares?: RequestMiddleware[];\n\n  /**\n   * The `trailingSlash` config allows you to control how the server handles\n   * trailing slashes. This config only affects URLs that do not have a file\n   * extension (i.e. HTML paths).\n   *\n   * - When `true`, the server redirects URLs to add a trailing slash\n   * - When `false`, the server redirects URLs to remove a trailing slash\n   * - When unspecified, the server allows URLs with and without trailing slash\n   */\n  trailingSlash?: boolean;\n\n  /**\n   * Cookie secret for the session middleware.\n   *\n   * Generate a secure secret with:\n   * ```\n   * node -e \"console.log(require('crypto').randomBytes(32).toString('hex'))\"\n   * ```\n   */\n  sessionCookieSecret?: string | string[];\n\n  /**\n   * List of redirects. Supports optional wildcards.\n   *\n   * @example\n   * ```ts\n   * redirects: [\n   *   {\n   *     source: '/old-path/[id]',\n   *     destination: '/new-path/[id]',\n   *     type: 301,\n   *   },\n   *   {\n   *     source: '/old-path/[...wildcard]',\n   *     destination: '/new-path/[...wildcard]',\n   *   },\n   * ]\n   * ```\n   */\n  redirects?: RootRedirectConfig[];\n\n  /**\n   * HTTP headers to add to a response.\n   */\n  headers?: RootHeaderConfig[];\n\n  /**\n   * HTTP security settings. By default, all security settings are enabled with\n   * commonly used default values.\n   */\n  security?: RootSecurityConfig;\n\n  /**\n   * Home page URL path, which is printed when the dev server starts.\n   */\n  homePagePath?: string;\n}\n\nexport function defineConfig(config: RootUserConfig): RootUserConfig {\n  return config;\n}\n", "import {ComponentChildren, FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type BodyProps = preact.JSX.HTMLAttributes<HTMLBodyElement> & {\n  children?: ComponentChildren;\n};\n\n/**\n * The `<Body>` component can be used to update attrs in the `<body>` tag.\n *\n * Usage:\n *\n * ```tsx\n * <Body className=\"body\">\n *   <h1>Hello world</h1>\n * </Body>\n * ```\n *\n * Output:\n *\n * ```html\n * <body class=\"body\">\n *   <h1>Hello world</h1>\n * </body>\n */\nexport const Body: FunctionalComponent<BodyProps> = ({children, ...attrs}) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Body> component'\n    );\n  }\n  context.bodyAttrs = attrs;\n  return <>{children}</>;\n};\n", "import {ComponentChildren, FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type HeadProps = preact.JSX.HTMLAttributes<HTMLHeadElement> & {\n  children?: ComponentChildren;\n};\n\n/**\n * The <Head> component can be used for injecting elements into the HTML head\n * tag from any part of a page. The <Head> can be added via any component or\n * sub-component and will automatically be hoisted to the `<head>` element.\n *\n * Usage:\n *\n * ```tsx\n * <Head>\n *   <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n * </Head>\n * ```\n */\nexport const Head: FunctionalComponent<HeadProps> = ({children, ...attrs}) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Head> component'\n    );\n  }\n  context.headComponents.push(children);\n  context.headAttrs = attrs;\n  return null;\n};\n", "import {FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type ScriptProps = preact.JSX.HTMLAttributes<HTMLScriptElement> & {\n  // Cast the \"src\" attr to string. See:\n  // https://github.com/blinkk/rootjs/issues/519\n  src?: string;\n};\n\n/**\n * The <Script> component is used for rendering any custom script modules. At\n * the moment, the system only pre-renders and bundles files that are in the\n * `/bundles` folder at the root of the project.\n *\n * Usage:\n *\n * ```tsx\n * <Script src=\"/bundles/main.ts\" />\n * ```\n */\nexport const Script: FunctionalComponent<ScriptProps> = (props) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Script> component'\n    );\n  }\n  context.scriptDeps.push(props);\n  return null;\n};\n", "import {ComponentChildren, FunctionalComponent, createContext} from 'preact';\nimport {useContext} from 'preact/hooks';\n\nexport type StringParamsContext = Record<string, string>;\n\nexport const STRING_PARAMS_CONTEXT = createContext<StringParamsContext | null>(\n  null\n);\n\nexport interface StringParamsProviderProps {\n  value?: StringParamsContext;\n  children?: ComponentChildren;\n}\n\nexport const StringParamsProvider: FunctionalComponent<\n  StringParamsProviderProps\n> = (props) => {\n  // Allow for nested param values from parent content providers.\n  const parent = useContext(STRING_PARAMS_CONTEXT) || {};\n  const merged = {...parent, ...props.value};\n  return (\n    <STRING_PARAMS_CONTEXT.Provider value={merged}>\n      {props.children}\n    </STRING_PARAMS_CONTEXT.Provider>\n  );\n};\n\n/**\n * A hook that returns a map of string params, configured via the\n * `StringParamsProvider` context provider. These params are automatically\n * applied to the `useTranslations()` hook.\n *\n *\n * Usage:\n *\n * ```\n * export default function Page() {\n *   return (\n *     <StringParamsProvider value={{name: 'Alice'}}>\n *       <SayHello />\n *     </StringParamsProvider>\n *   );\n * }\n *\n * function SayHello() {\n *   const t = useTranslations();\n *   return <h1>{t('Hello, {name}!')}</h1>;\n * }\n * ```\n *\n * This should render `<h1>Hello, Alice!</h1>`.\n */\nexport function useStringParams() {\n  return useContext(STRING_PARAMS_CONTEXT) || {};\n}\n", "import {ComponentChildren, FunctionalComponent, createContext} from 'preact';\nimport {useContext} from 'preact/hooks';\n\ntype TransformFn = (str: string) => string;\n\nexport interface TranslationMiddleware {\n  /** Transform the string before translation lookup. */\n  beforeTranslate?: TransformFn;\n  /** Transform the string after translation lookup. */\n  afterTranslate?: TransformFn;\n  /** Transform the string before `{param}` values are replaced. */\n  beforeReplaceParams?: TransformFn;\n  /** Transform the string after `{param}` values are replaced. */\n  afterReplaceParams?: TransformFn;\n}\n\nexport interface TranslationMiddlewareContext {\n  beforeTranslateFns: TransformFn[];\n  afterTranslateFns: TransformFn[];\n  beforeReplaceParamsFns: TransformFn[];\n  afterReplaceParamsFns: TransformFn[];\n}\n\nconst TRANSLATION_MIDDLEWARE_CONTEXT =\n  createContext<TranslationMiddlewareContext | null>(null);\n\nexport interface TranslationMiddlewareProviderProps {\n  value?: TranslationMiddleware;\n  children?: ComponentChildren;\n}\n\nexport const TranslationMiddlewareProvider: FunctionalComponent<\n  TranslationMiddlewareProviderProps\n> = (props) => {\n  const parent = useContext(TRANSLATION_MIDDLEWARE_CONTEXT) || {\n    beforeTranslateFns: [],\n    afterTranslateFns: [],\n    beforeReplaceParamsFns: [],\n    afterReplaceParamsFns: [],\n  };\n  const merged: TranslationMiddlewareContext = {\n    beforeTranslateFns: [...parent.beforeTranslateFns],\n    afterTranslateFns: [...parent.afterTranslateFns],\n    beforeReplaceParamsFns: [...parent.beforeReplaceParamsFns],\n    afterReplaceParamsFns: [...parent.afterReplaceParamsFns],\n  };\n  if (props.value?.beforeTranslate) {\n    merged.beforeTranslateFns.push(props.value.beforeTranslate);\n  }\n  if (props.value?.afterTranslate) {\n    merged.afterTranslateFns.push(props.value.afterTranslate);\n  }\n  if (props.value?.beforeReplaceParams) {\n    merged.beforeReplaceParamsFns.push(props.value.beforeReplaceParams);\n  }\n  if (props.value?.afterReplaceParams) {\n    merged.afterReplaceParamsFns.push(props.value.afterReplaceParams);\n  }\n  return (\n    <TRANSLATION_MIDDLEWARE_CONTEXT.Provider value={merged}>\n      {props.children}\n    </TRANSLATION_MIDDLEWARE_CONTEXT.Provider>\n  );\n};\n\nexport function useTranslationMiddleware(): TranslationMiddlewareContext {\n  return (\n    useContext(TRANSLATION_MIDDLEWARE_CONTEXT) || {\n      beforeTranslateFns: [],\n      afterTranslateFns: [],\n      beforeReplaceParamsFns: [],\n      afterReplaceParamsFns: [],\n    }\n  );\n}\n", "import {I18nContext, useI18nContext} from './useI18nContext.js';\nimport {useStringParams} from './useStringParams.js';\nimport {useTranslationMiddleware} from './useTranslationsMiddleware.js';\n\n/**\n * A hook that returns a function that can be used to translate a string, and\n * optionally replace any parameterized values that are surrounded in curly\n * braces.\n *\n * Usage:\n *\n * ```ts\n * const t = useTranslations();\n * t('Hello {name}', {name: 'Bob'});\n * // => 'Bounjour Bob'\n * ```\n */\nexport function useTranslations() {\n  // Ignore I18nContext not found error when used with client-side rehydration.\n  let i18nContext: I18nContext | null = null;\n  try {\n    i18nContext = useI18nContext();\n  } catch {\n    console.warn('I18nContext not found');\n  }\n  const translations = i18nContext?.translations || {};\n  const stringParams = useStringParams();\n  const middleware = useTranslationMiddleware();\n\n  function t(str: string, params?: Record<string, string | number>): string;\n  function t(\n    str: string | null | undefined,\n    params?: Record<string, string | number>\n  ): string | undefined {\n    // Suppress verbatim `'undefined'` and `'null'` output, which can occur when\n    // using `useTranslations` with undefined values.\n    if (typeof str === 'undefined' || str === null) {\n      // Return `undefined` to suppress empty props, e.g.\n      // <a title={t(undefined)}>Learn more</a>\n      return undefined;\n    }\n    let input = normalizeString(str);\n    middleware.beforeTranslateFns.forEach((fn) => {\n      input = fn(input);\n    });\n    let translation = translations[input] ?? input ?? '';\n    middleware.afterTranslateFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n\n    // Replace string params, e.g. \"Hello, {name}\".\n    middleware.beforeReplaceParamsFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n    if (testHasStringParams(translation)) {\n      translation = replaceStringParams(translation, {\n        ...stringParams,\n        ...params,\n      });\n    }\n    middleware.afterReplaceParamsFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n\n    return translation;\n  }\n  return t;\n}\n\n/**\n * Cleans a string that's used for translations. Performs the following:\n * - Removes any leading/trailing whitespace\n * - Removes spaces at the end of any line\n */\nexport function normalizeString(str: string) {\n  const lines = String(str)\n    .trim()\n    .split('\\n')\n    .map((line) => removeTrailingWhitespace(line));\n  return lines.join('\\n');\n}\n\nfunction removeTrailingWhitespace(str: string) {\n  return String(str)\n    .trimEnd()\n    .replace(/&nbsp;$/, '');\n}\n\nfunction testHasStringParams(str: string) {\n  return str.includes('{') && str.includes('}');\n}\n\n/**\n * Replaces string placeholder params, e.g.\n *\n * ```\n * replaceStringParams('Hello, {name}!', {name: 'Joe'})\n * // => 'Hello, Joe!'\n * ```\n */\nfunction replaceStringParams(\n  str: string,\n  params: Record<string, string | number>\n): string {\n  return str.replace(/{([^}]+)}/g, (match, key) => {\n    if (key in params) {\n      return String(params[key]);\n    }\n    return match;\n  });\n}\n", "import {PluginOption as VitePlugin} from 'vite';\nimport {RootConfig} from './config.js';\n\nexport interface Pod {\n  /** Unique pod name, e.g. '@blinkk/root-docs-pod'. */\n  name: string;\n\n  /**\n   * URL prefix for pod routes. Routes within the pod are served under this\n   * mount path. Defaults to '/'.\n   */\n  mount?: string;\n\n  /**\n   * Priority for route conflict resolution. Higher values win when multiple\n   * pods register the same URL path. User-site routes always take precedence\n   * regardless of priority. Defaults to 0.\n   */\n  priority?: number;\n\n  /** Absolute path to the pod's routes/ directory. */\n  routesDir?: string;\n\n  /** Absolute path(s) to the pod's elements/ directory(s). */\n  elementsDirs?: string[];\n\n  /** Absolute path to the pod's bundles/ directory. */\n  bundlesDir?: string;\n\n  /** Absolute path to the pod's collections/ directory (root-cms only). */\n  collectionsDir?: string;\n\n  /** Absolute path to the pod's translations/ directory. */\n  translationsDir?: string;\n\n  /** Extra Vite plugins contributed by the pod. */\n  vitePlugins?: VitePlugin[];\n}\n\nexport type PodFactory = (ctx: {rootConfig: RootConfig}) => Pod | Promise<Pod>;\n\nexport interface PodConfig {\n  /** Whether the pod is enabled. Defaults to true. */\n  enabled?: boolean;\n\n  /** Override the pod's mount path. */\n  mount?: string;\n\n  /** Override the pod's priority. */\n  priority?: number;\n\n  /** Filter pod routes. */\n  routes?: {\n    exclude?: (string | RegExp)[];\n  };\n\n  /** Configure pod collections. */\n  collections?: {\n    exclude?: string[];\n    /** Rename collection ids, e.g. {Posts: 'DocsPosts'}. */\n    rename?: Record<string, string>;\n  };\n}\n\n/**\n * Helper to define a pod with type-checking.\n */\nexport function definePod(pod: Pod): Pod {\n  return pod;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;AA2YO,SAAS,aAAa,QAAwC;AACnE,SAAO;AACT;;;AC5YA,SAAQ,kBAAiB;AAiChB;AARF,IAAM,OAAuC,CAAC,EAAC,UAAU,GAAG,MAAK,MAAM;AAC5E,QAAM,UAAU,WAAW,YAAY;AACvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,UAAQ,YAAY;AACpB,SAAO,gCAAG,UAAS;AACrB;;;AClCA,SAAQ,cAAAA,mBAAiB;AAoBlB,IAAM,OAAuC,CAAC,EAAC,UAAU,GAAG,MAAK,MAAM;AAC5E,QAAM,UAAUC,YAAW,YAAY;AACvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,UAAQ,eAAe,KAAK,QAAQ;AACpC,UAAQ,YAAY;AACpB,SAAO;AACT;;;AC9BA,SAAQ,cAAAC,mBAAiB;AAoBlB,IAAM,SAA2C,CAAC,UAAU;AACjE,QAAM,UAAUC,YAAW,YAAY;AACvC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,UAAQ,WAAW,KAAK,KAAK;AAC7B,SAAO;AACT;;;AC9BA,SAAgD,qBAAoB;AACpE,SAAQ,cAAAC,mBAAiB;AAoBrB,gBAAAC,YAAA;AAhBG,IAAM,wBAAwB;AAAA,EACnC;AACF;AAOO,IAAM,uBAET,CAAC,UAAU;AAEb,QAAM,SAASD,YAAW,qBAAqB,KAAK,CAAC;AACrD,QAAM,SAAS,EAAC,GAAG,QAAQ,GAAG,MAAM,MAAK;AACzC,SACE,gBAAAC,KAAC,sBAAsB,UAAtB,EAA+B,OAAO,QACpC,gBAAM,UACT;AAEJ;AA2BO,SAAS,kBAAkB;AAChC,SAAOD,YAAW,qBAAqB,KAAK,CAAC;AAC/C;;;ACtDA,SAAgD,iBAAAE,sBAAoB;AACpE,SAAQ,cAAAC,mBAAiB;AA0DrB,gBAAAC,YAAA;AApCJ,IAAM,iCACJF,eAAmD,IAAI;AAOlD,IAAM,gCAET,CAAC,UAAU;AACb,QAAM,SAASC,YAAW,8BAA8B,KAAK;AAAA,IAC3D,oBAAoB,CAAC;AAAA,IACrB,mBAAmB,CAAC;AAAA,IACpB,wBAAwB,CAAC;AAAA,IACzB,uBAAuB,CAAC;AAAA,EAC1B;AACA,QAAM,SAAuC;AAAA,IAC3C,oBAAoB,CAAC,GAAG,OAAO,kBAAkB;AAAA,IACjD,mBAAmB,CAAC,GAAG,OAAO,iBAAiB;AAAA,IAC/C,wBAAwB,CAAC,GAAG,OAAO,sBAAsB;AAAA,IACzD,uBAAuB,CAAC,GAAG,OAAO,qBAAqB;AAAA,EACzD;AACA,MAAI,MAAM,OAAO,iBAAiB;AAChC,WAAO,mBAAmB,KAAK,MAAM,MAAM,eAAe;AAAA,EAC5D;AACA,MAAI,MAAM,OAAO,gBAAgB;AAC/B,WAAO,kBAAkB,KAAK,MAAM,MAAM,cAAc;AAAA,EAC1D;AACA,MAAI,MAAM,OAAO,qBAAqB;AACpC,WAAO,uBAAuB,KAAK,MAAM,MAAM,mBAAmB;AAAA,EACpE;AACA,MAAI,MAAM,OAAO,oBAAoB;AACnC,WAAO,sBAAsB,KAAK,MAAM,MAAM,kBAAkB;AAAA,EAClE;AACA,SACE,gBAAAC,KAAC,+BAA+B,UAA/B,EAAwC,OAAO,QAC7C,gBAAM,UACT;AAEJ;AAEO,SAAS,2BAAyD;AACvE,SACED,YAAW,8BAA8B,KAAK;AAAA,IAC5C,oBAAoB,CAAC;AAAA,IACrB,mBAAmB,CAAC;AAAA,IACpB,wBAAwB,CAAC;AAAA,IACzB,uBAAuB,CAAC;AAAA,EAC1B;AAEJ;;;ACzDO,SAAS,kBAAkB;AAEhC,MAAI,cAAkC;AACtC,MAAI;AACF,kBAAc,eAAe;AAAA,EAC/B,QAAQ;AACN,YAAQ,KAAK,uBAAuB;AAAA,EACtC;AACA,QAAM,eAAe,aAAa,gBAAgB,CAAC;AACnD,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAAa,yBAAyB;AAG5C,WAAS,EACP,KACA,QACoB;AAGpB,QAAI,OAAO,QAAQ,eAAe,QAAQ,MAAM;AAG9C,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,gBAAgB,GAAG;AAC/B,eAAW,mBAAmB,QAAQ,CAAC,OAAO;AAC5C,cAAQ,GAAG,KAAK;AAAA,IAClB,CAAC;AACD,QAAI,cAAc,aAAa,KAAK,KAAK,SAAS;AAClD,eAAW,kBAAkB,QAAQ,CAAC,OAAO;AAC3C,oBAAc,GAAG,WAAW;AAAA,IAC9B,CAAC;AAGD,eAAW,uBAAuB,QAAQ,CAAC,OAAO;AAChD,oBAAc,GAAG,WAAW;AAAA,IAC9B,CAAC;AACD,QAAI,oBAAoB,WAAW,GAAG;AACpC,oBAAc,oBAAoB,aAAa;AAAA,QAC7C,GAAG;AAAA,QACH,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AACA,eAAW,sBAAsB,QAAQ,CAAC,OAAO;AAC/C,oBAAc,GAAG,WAAW;AAAA,IAC9B,CAAC;AAED,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,gBAAgB,KAAa;AAC3C,QAAM,QAAQ,OAAO,GAAG,EACrB,KAAK,EACL,MAAM,IAAI,EACV,IAAI,CAAC,SAAS,yBAAyB,IAAI,CAAC;AAC/C,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,yBAAyB,KAAa;AAC7C,SAAO,OAAO,GAAG,EACd,QAAQ,EACR,QAAQ,WAAW,EAAE;AAC1B;AAEA,SAAS,oBAAoB,KAAa;AACxC,SAAO,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS,GAAG;AAC9C;AAUA,SAAS,oBACP,KACA,QACQ;AACR,SAAO,IAAI,QAAQ,cAAc,CAAC,OAAO,QAAQ;AAC/C,QAAI,OAAO,QAAQ;AACjB,aAAO,OAAO,OAAO,GAAG,CAAC;AAAA,IAC3B;AACA,WAAO;AAAA,EACT,CAAC;AACH;;;AC3CO,SAAS,UAAU,KAAe;AACvC,SAAO;AACT;",
+  "sourcesContent": ["import {UserConfig as ViteUserConfig} from 'vite';\nimport {JsxRenderOptions} from '../jsx/jsx-render.js';\nimport {HtmlMinifyOptions} from '../render/html-minify.js';\nimport {HtmlPrettyOptions} from '../render/html-pretty.js';\nimport {Plugin} from './plugin.js';\nimport {PodConfig} from './pod.js';\nimport {RequestMiddleware} from './types.js';\n\nexport interface RootUserConfig {\n  /**\n   * Canonical domain the website will serve on. Useful for things like the\n   * sitemap, SEO tags, etc.\n   */\n  domain?: string;\n\n  /**\n   * The base URL path that the site will serve on. Defaults to `/`;\n   */\n  base?: string;\n\n  /**\n   * Config for auto-injecting custom element dependencies.\n   */\n  elements?: {\n    /**\n     * A list of directories to use to look for custom elements. The dir path\n     * should be relative to the project dir, e.g. \"path/to/elements\".\n     */\n    include?: string[];\n\n    /**\n     * A list of RegEx patterns to exclude. The string passed to the RegEx is\n     * the file URL relative to the project root, e.g. \"/elements/foo/foo.ts\".\n     */\n    exclude?: RegExp[];\n  };\n\n  /**\n   * Config for manually injecting stylesheet entries as\n   * `<link rel=\"stylesheet\">` tags.\n   */\n  styles?: {\n    /**\n     * Project-root-relative stylesheet files to include on every rendered\n     * page, e.g. `styles/index.css`.\n     *\n     * Entries are normalized as URL paths, so both `styles/index.css` and\n     * `/styles/index.css` resolve to `/styles/index.css`.\n     *\n     * Manual entries are injected first, then auto-collected CSS\n     * dependencies are merged after. Duplicate URLs are de-duped so each\n     * stylesheet is only injected once.\n     */\n    entries?: string[];\n  };\n\n  /**\n   * Whether to auto-inject `<link rel=\"modulepreload\">` tags for the JS chunks\n   * imported by the page's `<script type=\"module\">` tags. Disabled by default;\n   * pass `modulePreload: true` to opt in.\n   *\n   * Root injects a `<script type=\"module\">` tag for every custom element and\n   * bundle used on the page, but the shared chunks those scripts import are\n   * only discovered once the browser has downloaded and parsed the script.\n   * Preloading them removes that request waterfall.\n   *\n   * Chunks that are already injected as `<script>` tags are skipped, and no\n   * tags are injected by the dev server (where modules are served unbundled).\n   *\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/modulepreload}\n   */\n  modulePreload?: boolean;\n\n  /**\n   * Config options for localization and internationalization.\n   */\n  i18n?: RootI18nConfig;\n\n  /**\n   * Config options for the Root.js express server.\n   */\n  server?: RootServerConfig;\n\n  /**\n   * Build options for the `root build` command.\n   */\n  build?: RootBuildConfig;\n\n  /**\n   * Vite config.\n   * @see {@link https://vitejs.dev/config/} for more information.\n   */\n  vite?: ViteUserConfig;\n\n  /**\n   * Config for the built-in JSX-to-HTML renderer.\n   *\n   * - `mode: 'pretty'` (default) \u2014 block-level elements render on their own\n   *   line with no indentation.\n   * - `mode: 'minimal'` \u2014 compact output with no extra whitespace.\n   *\n   * Use `blockElements` to specify additional custom element tag names that\n   * should be treated as block-level in pretty mode.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   jsxRenderer: {\n   *     mode: 'pretty',\n   *     blockElements: ['my-card', 'my-section'],\n   *   },\n   * });\n   * ```\n   */\n  jsxRenderer?: JsxRenderOptions;\n\n  /**\n   * Whether to minify HTML output via html-minifier-terser. Disabled by\n   * default; pass `minifyHtml: true` to opt in.\n   *\n   * Ignored when the built-in JSX renderer (`jsxRenderer`) is enabled, since\n   * that renderer controls its own output formatting via its `mode` option.\n   */\n  minifyHtml?: boolean;\n\n  /**\n   * Options to pass to html-minifier-terser.\n   */\n  minifyHtmlOptions?: HtmlMinifyOptions;\n\n  /**\n   * Whether to pretty print HTML output via js-beautify. Disabled by default;\n   * pass `prettyHtml: true` to opt in. When both `prettyHtml` and `minifyHtml`\n   * are set, `prettyHtml` takes precedence.\n   *\n   * Ignored when the built-in JSX renderer (`jsxRenderer`) is enabled, since\n   * that renderer controls its own output formatting via its `mode` option.\n   */\n  prettyHtml?: boolean;\n\n  /**\n   * Options to pass to js-beautify.\n   */\n  prettyHtmlOptions?: HtmlPrettyOptions;\n\n  /**\n   * Whether to include a sitemap.xml file to the build output.\n   */\n  sitemap?: boolean;\n\n  /**\n   * Plugins.\n   */\n  plugins?: Plugin[];\n\n  /**\n   * Per-pod user-level overrides. The key is the pod name as declared in\n   * Pod.name.\n   */\n  pods?: Record<string, PodConfig>;\n\n  /**\n   * Experimental config options. Note: these are subject to change at any time.\n   */\n  experiments?: {\n    /** Whether to render `<script>` tags with `async`. */\n    enableScriptAsync?: boolean;\n  };\n}\n\nexport type RootConfig = RootUserConfig & {\n  rootDir: string;\n};\n\nexport interface LocaleGroup {\n  label?: string;\n  locales: RootLocale[];\n}\n\n/**\n * A site-defined locale identifier, as configured in `i18n.locales`.\n * Root is agnostic to its format.\n */\nexport type RootLocale = string;\n\n/**\n * The language identifier used by translation systems (CSV/Sheets columns,\n * translation services, CMS translations pages), mapped from a root locale\n * via `i18n.translationLanguages`. Defaults to the root locale id.\n */\nexport type TranslationLanguage = string;\n\nexport interface RootI18nConfig {\n  /**\n   * Locales enabled for the site.\n   */\n  locales?: RootLocale[];\n\n  /**\n   * The default locale to use. Defaults is `en`.\n   */\n  defaultLocale?: RootLocale;\n\n  /**\n   * URL format for localized content. Default is `/[locale]/[base]/[path]`.\n   */\n  urlFormat?: string;\n\n  /**\n   * Localization groups, to help UIs (like Root.js CMS) logically group\n   * locales.\n   */\n  groups?: Record<string, LocaleGroup>;\n\n  /**\n   * Maps a root locale to the \"translation language\" used by translation\n   * systems. Translation systems often use different language identifiers\n   * than root locales, and multiple root locales may share the same\n   * translations. For example:\n   *\n   * ```\n   * i18n: {\n   *   locales: ['en', 'es_mx', 'es_co', 'en_gb', 'en_ca', 'fr_ca'],\n   *   translationLanguages: {\n   *     es_mx: 'es-419',\n   *     es_co: 'es-419',\n   *     en_gb: 'en-GB',\n   *     en_ca: 'en-GB',\n   *     fr_ca: 'fr-CA',\n   *   },\n   * }\n   * ```\n   *\n   * With the config above, translations for the `es_mx` and `es_co` locales\n   * are imported and exported using a single `es-419` language. The\n   * conversion applies anywhere translations are used, e.g. CSV and Google\n   * Sheets import/export, translation services, and the CMS translations\n   * pages. Locales not listed here use the locale id as the translation\n   * language.\n   */\n  translationLanguages?: Record<RootLocale, TranslationLanguage>;\n\n  /**\n   * Locale fallback chains for translations. When a translation is missing\n   * for a locale, each fallback locale is checked (in order) before falling\n   * back to `defaultLocale` and finally the source string. Fallbacks are\n   * resolved recursively, e.g. with the config below, `en-CA` resolves to\n   * `['en-CA', 'en-GB', 'en']`. For example:\n   *\n   * ```\n   * i18n: {\n   *   locales: ['en', 'en-GB', 'en-CA'],\n   *   fallbacks: {\n   *     'en-CA': ['en-GB'],\n   *   },\n   * }\n   * ```\n   */\n  fallbacks?: Record<RootLocale, RootLocale[]>;\n}\n\nexport interface RootBuildConfig {\n  /**\n   * Excludes the `/intl/{defaultLocale}/...` path from the SSG build.\n   */\n  excludeDefaultLocaleFromIntlPaths?: boolean;\n}\n\nexport interface RootRedirectConfig {\n  /**\n   * The source path to redirect. Accepts placeholders in the format\n   * `[key]` or `[...key]`. Use `[key]` for single segments and\n   * `[...key]` for multi-segment wildcards.\n   * @example \"/old-path/[id]\" or \"/old-path/[...wildcard]\"\n   */\n  source: string;\n\n  /**\n   * The destination to redirect to. Placeholders from the source can\n   * optionally be inserted into the destination using the same\n   * placeholder format.\n   * @example \"/new-path/[id]\" or \"/new-path/[...wildcard]\"\n   */\n  destination: string;\n\n  /**\n   * The redirect type (`301` = permanent, `302` = temporary). If unspecified,\n   * defaults to `302` (temporary).\n   */\n  type?: 301 | 302;\n}\n\nexport interface RootHeaderConfig {\n  /** A glob pattern match (regex not supported yet). */\n  source: string;\n  headers: Array<{\n    key: string;\n    value: string;\n  }>;\n}\n\nexport interface ContentSecurityPolicyConfig {\n  directives?: Record<string, string[]>;\n  reportOnly?: boolean;\n}\n\nexport interface XFrameOptionsConfig {\n  action: 'DENY' | 'SAMEORIGIN';\n}\n\nexport interface RootSecurityConfig {\n  /**\n   * Content-Security-Policy config. If enabled, a nonce is auto-generated\n   * for every request and appended to script and stylesheet tags. You can\n   * validate your CSP headers using a tool like {@link https://csp-evaluator.withgoogle.com/}.\n   *\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP}\n   */\n  contentSecurityPolicy?: ContentSecurityPolicyConfig | boolean;\n\n  /**\n   * Strict-Transport-Security config. When enabled, the header value is set\n   * to `Strict-Transport-Security: max-age=63072000; includeSubDomains; preload`.\n   */\n  strictTransportSecurity?: boolean;\n\n  /**\n   * X-Content-Type-Options config. When enabled, the header value is set to\n   * `X-Content-Type-Options: nosniff`.\n   */\n  xContentTypeOptions?: boolean;\n\n  /**\n   * X-Frame-Options config. Setting this value to `true` will default the\n   * header value to `X-Frame-Options: SAMEORIGIN`.\n   *\n   * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options}\n   */\n  xFrameOptions?: 'DENY' | 'SAMEORIGIN' | boolean;\n\n  /**\n   * X-XSS-Protection config. When enabled, the header value is set to\n   * `X-XSS-Protection: 1; mode=block`.\n   */\n  xXssProtection?: boolean;\n}\n\nexport interface RootServerConfig {\n  /**\n   * An array of middleware to add to the express server. These middleware are\n   * added to the beginning of the express app.\n   */\n  middlewares?: RequestMiddleware[];\n\n  /**\n   * The `trailingSlash` config allows you to control how the server handles\n   * trailing slashes. This config only affects URLs that do not have a file\n   * extension (i.e. HTML paths).\n   *\n   * - When `true`, the server redirects URLs to add a trailing slash\n   * - When `false`, the server redirects URLs to remove a trailing slash\n   * - When unspecified, the server allows URLs with and without trailing slash\n   */\n  trailingSlash?: boolean;\n\n  /**\n   * Cookie secret for the session middleware.\n   *\n   * Generate a secure secret with:\n   * ```\n   * node -e \"console.log(require('crypto').randomBytes(32).toString('hex'))\"\n   * ```\n   */\n  sessionCookieSecret?: string | string[];\n\n  /**\n   * List of redirects. Supports optional wildcards.\n   *\n   * @example\n   * ```ts\n   * redirects: [\n   *   {\n   *     source: '/old-path/[id]',\n   *     destination: '/new-path/[id]',\n   *     type: 301,\n   *   },\n   *   {\n   *     source: '/old-path/[...wildcard]',\n   *     destination: '/new-path/[...wildcard]',\n   *   },\n   * ]\n   * ```\n   */\n  redirects?: RootRedirectConfig[];\n\n  /**\n   * HTTP headers to add to a response.\n   */\n  headers?: RootHeaderConfig[];\n\n  /**\n   * HTTP security settings. By default, all security settings are enabled with\n   * commonly used default values.\n   */\n  security?: RootSecurityConfig;\n\n  /**\n   * Home page URL path, which is printed when the dev server starts.\n   */\n  homePagePath?: string;\n}\n\nexport function defineConfig(config: RootUserConfig): RootUserConfig {\n  return config;\n}\n", "import {ComponentChildren, FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type BodyProps = preact.JSX.HTMLAttributes<HTMLBodyElement> & {\n  children?: ComponentChildren;\n};\n\n/**\n * The `<Body>` component can be used to update attrs in the `<body>` tag.\n *\n * Usage:\n *\n * ```tsx\n * <Body className=\"body\">\n *   <h1>Hello world</h1>\n * </Body>\n * ```\n *\n * Output:\n *\n * ```html\n * <body class=\"body\">\n *   <h1>Hello world</h1>\n * </body>\n */\nexport const Body: FunctionalComponent<BodyProps> = ({children, ...attrs}) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Body> component'\n    );\n  }\n  context.bodyAttrs = attrs;\n  return <>{children}</>;\n};\n", "import {ComponentChildren, FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type HeadProps = preact.JSX.HTMLAttributes<HTMLHeadElement> & {\n  children?: ComponentChildren;\n};\n\n/**\n * The <Head> component can be used for injecting elements into the HTML head\n * tag from any part of a page. The <Head> can be added via any component or\n * sub-component and will automatically be hoisted to the `<head>` element.\n *\n * Usage:\n *\n * ```tsx\n * <Head>\n *   <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n * </Head>\n * ```\n */\nexport const Head: FunctionalComponent<HeadProps> = ({children, ...attrs}) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Head> component'\n    );\n  }\n  context.headComponents.push(children);\n  context.headAttrs = attrs;\n  return null;\n};\n", "import {FunctionalComponent} from 'preact';\nimport {useContext} from 'preact/hooks';\nimport {HTML_CONTEXT} from './Html.js';\n\nexport type ScriptProps = preact.JSX.HTMLAttributes<HTMLScriptElement> & {\n  // Cast the \"src\" attr to string. See:\n  // https://github.com/blinkk/rootjs/issues/519\n  src?: string;\n};\n\n/**\n * The <Script> component is used for rendering any custom script modules. At\n * the moment, the system only pre-renders and bundles files that are in the\n * `/bundles` folder at the root of the project.\n *\n * Usage:\n *\n * ```tsx\n * <Script src=\"/bundles/main.ts\" />\n * ```\n */\nexport const Script: FunctionalComponent<ScriptProps> = (props) => {\n  const context = useContext(HTML_CONTEXT);\n  if (!context) {\n    throw new Error(\n      'HTML_CONTEXT not found, double-check usage of the <Script> component'\n    );\n  }\n  context.scriptDeps.push(props);\n  return null;\n};\n", "import {ComponentChildren, FunctionalComponent, createContext} from 'preact';\nimport {useContext} from 'preact/hooks';\n\nexport type StringParamsContext = Record<string, string>;\n\nexport const STRING_PARAMS_CONTEXT = createContext<StringParamsContext | null>(\n  null\n);\n\nexport interface StringParamsProviderProps {\n  value?: StringParamsContext;\n  children?: ComponentChildren;\n}\n\nexport const StringParamsProvider: FunctionalComponent<\n  StringParamsProviderProps\n> = (props) => {\n  // Allow for nested param values from parent content providers.\n  const parent = useContext(STRING_PARAMS_CONTEXT) || {};\n  const merged = {...parent, ...props.value};\n  return (\n    <STRING_PARAMS_CONTEXT.Provider value={merged}>\n      {props.children}\n    </STRING_PARAMS_CONTEXT.Provider>\n  );\n};\n\n/**\n * A hook that returns a map of string params, configured via the\n * `StringParamsProvider` context provider. These params are automatically\n * applied to the `useTranslations()` hook.\n *\n *\n * Usage:\n *\n * ```\n * export default function Page() {\n *   return (\n *     <StringParamsProvider value={{name: 'Alice'}}>\n *       <SayHello />\n *     </StringParamsProvider>\n *   );\n * }\n *\n * function SayHello() {\n *   const t = useTranslations();\n *   return <h1>{t('Hello, {name}!')}</h1>;\n * }\n * ```\n *\n * This should render `<h1>Hello, Alice!</h1>`.\n */\nexport function useStringParams() {\n  return useContext(STRING_PARAMS_CONTEXT) || {};\n}\n", "import {ComponentChildren, FunctionalComponent, createContext} from 'preact';\nimport {useContext} from 'preact/hooks';\n\ntype TransformFn = (str: string) => string;\n\nexport interface TranslationMiddleware {\n  /** Transform the string before translation lookup. */\n  beforeTranslate?: TransformFn;\n  /** Transform the string after translation lookup. */\n  afterTranslate?: TransformFn;\n  /** Transform the string before `{param}` values are replaced. */\n  beforeReplaceParams?: TransformFn;\n  /** Transform the string after `{param}` values are replaced. */\n  afterReplaceParams?: TransformFn;\n}\n\nexport interface TranslationMiddlewareContext {\n  beforeTranslateFns: TransformFn[];\n  afterTranslateFns: TransformFn[];\n  beforeReplaceParamsFns: TransformFn[];\n  afterReplaceParamsFns: TransformFn[];\n}\n\nconst TRANSLATION_MIDDLEWARE_CONTEXT =\n  createContext<TranslationMiddlewareContext | null>(null);\n\nexport interface TranslationMiddlewareProviderProps {\n  value?: TranslationMiddleware;\n  children?: ComponentChildren;\n}\n\nexport const TranslationMiddlewareProvider: FunctionalComponent<\n  TranslationMiddlewareProviderProps\n> = (props) => {\n  const parent = useContext(TRANSLATION_MIDDLEWARE_CONTEXT) || {\n    beforeTranslateFns: [],\n    afterTranslateFns: [],\n    beforeReplaceParamsFns: [],\n    afterReplaceParamsFns: [],\n  };\n  const merged: TranslationMiddlewareContext = {\n    beforeTranslateFns: [...parent.beforeTranslateFns],\n    afterTranslateFns: [...parent.afterTranslateFns],\n    beforeReplaceParamsFns: [...parent.beforeReplaceParamsFns],\n    afterReplaceParamsFns: [...parent.afterReplaceParamsFns],\n  };\n  if (props.value?.beforeTranslate) {\n    merged.beforeTranslateFns.push(props.value.beforeTranslate);\n  }\n  if (props.value?.afterTranslate) {\n    merged.afterTranslateFns.push(props.value.afterTranslate);\n  }\n  if (props.value?.beforeReplaceParams) {\n    merged.beforeReplaceParamsFns.push(props.value.beforeReplaceParams);\n  }\n  if (props.value?.afterReplaceParams) {\n    merged.afterReplaceParamsFns.push(props.value.afterReplaceParams);\n  }\n  return (\n    <TRANSLATION_MIDDLEWARE_CONTEXT.Provider value={merged}>\n      {props.children}\n    </TRANSLATION_MIDDLEWARE_CONTEXT.Provider>\n  );\n};\n\nexport function useTranslationMiddleware(): TranslationMiddlewareContext {\n  return (\n    useContext(TRANSLATION_MIDDLEWARE_CONTEXT) || {\n      beforeTranslateFns: [],\n      afterTranslateFns: [],\n      beforeReplaceParamsFns: [],\n      afterReplaceParamsFns: [],\n    }\n  );\n}\n", "import {I18nContext, useI18nContext} from './useI18nContext.js';\nimport {useStringParams} from './useStringParams.js';\nimport {useTranslationMiddleware} from './useTranslationsMiddleware.js';\n\n/**\n * A hook that returns a function that can be used to translate a string, and\n * optionally replace any parameterized values that are surrounded in curly\n * braces.\n *\n * Usage:\n *\n * ```ts\n * const t = useTranslations();\n * t('Hello {name}', {name: 'Bob'});\n * // => 'Bounjour Bob'\n * ```\n */\nexport function useTranslations() {\n  // Ignore I18nContext not found error when used with client-side rehydration.\n  let i18nContext: I18nContext | null = null;\n  try {\n    i18nContext = useI18nContext();\n  } catch {\n    console.warn('I18nContext not found');\n  }\n  const translations = i18nContext?.translations || {};\n  const stringParams = useStringParams();\n  const middleware = useTranslationMiddleware();\n\n  function t(str: string, params?: Record<string, string | number>): string;\n  function t(\n    str: string | null | undefined,\n    params?: Record<string, string | number>\n  ): string | undefined {\n    // Suppress verbatim `'undefined'` and `'null'` output, which can occur when\n    // using `useTranslations` with undefined values.\n    if (typeof str === 'undefined' || str === null) {\n      // Return `undefined` to suppress empty props, e.g.\n      // <a title={t(undefined)}>Learn more</a>\n      return undefined;\n    }\n    let input = normalizeString(str);\n    middleware.beforeTranslateFns.forEach((fn) => {\n      input = fn(input);\n    });\n    let translation = translations[input] ?? input ?? '';\n    middleware.afterTranslateFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n\n    // Replace string params, e.g. \"Hello, {name}\".\n    middleware.beforeReplaceParamsFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n    if (testHasStringParams(translation)) {\n      translation = replaceStringParams(translation, {\n        ...stringParams,\n        ...params,\n      });\n    }\n    middleware.afterReplaceParamsFns.forEach((fn) => {\n      translation = fn(translation);\n    });\n\n    return translation;\n  }\n  return t;\n}\n\n/**\n * Cleans a string that's used for translations. Performs the following:\n * - Removes any leading/trailing whitespace\n * - Removes spaces at the end of any line\n */\nexport function normalizeString(str: string) {\n  const lines = String(str)\n    .trim()\n    .split('\\n')\n    .map((line) => removeTrailingWhitespace(line));\n  return lines.join('\\n');\n}\n\nfunction removeTrailingWhitespace(str: string) {\n  return String(str)\n    .trimEnd()\n    .replace(/&nbsp;$/, '');\n}\n\nfunction testHasStringParams(str: string) {\n  return str.includes('{') && str.includes('}');\n}\n\n/**\n * Replaces string placeholder params, e.g.\n *\n * ```\n * replaceStringParams('Hello, {name}!', {name: 'Joe'})\n * // => 'Hello, Joe!'\n * ```\n */\nfunction replaceStringParams(\n  str: string,\n  params: Record<string, string | number>\n): string {\n  return str.replace(/{([^}]+)}/g, (match, key) => {\n    if (key in params) {\n      return String(params[key]);\n    }\n    return match;\n  });\n}\n", "import {PluginOption as VitePlugin} from 'vite';\nimport {RootConfig} from './config.js';\n\nexport interface Pod {\n  /** Unique pod name, e.g. '@blinkk/root-docs-pod'. */\n  name: string;\n\n  /**\n   * URL prefix for pod routes. Routes within the pod are served under this\n   * mount path. Defaults to '/'.\n   */\n  mount?: string;\n\n  /**\n   * Priority for route conflict resolution. Higher values win when multiple\n   * pods register the same URL path. User-site routes always take precedence\n   * regardless of priority. Defaults to 0.\n   */\n  priority?: number;\n\n  /** Absolute path to the pod's routes/ directory. */\n  routesDir?: string;\n\n  /** Absolute path(s) to the pod's elements/ directory(s). */\n  elementsDirs?: string[];\n\n  /** Absolute path to the pod's bundles/ directory. */\n  bundlesDir?: string;\n\n  /** Absolute path to the pod's collections/ directory (root-cms only). */\n  collectionsDir?: string;\n\n  /** Absolute path to the pod's translations/ directory. */\n  translationsDir?: string;\n\n  /** Extra Vite plugins contributed by the pod. */\n  vitePlugins?: VitePlugin[];\n}\n\nexport type PodFactory = (ctx: {rootConfig: RootConfig}) => Pod | Promise<Pod>;\n\nexport interface PodConfig {\n  /** Whether the pod is enabled. Defaults to true. */\n  enabled?: boolean;\n\n  /** Override the pod's mount path. */\n  mount?: string;\n\n  /** Override the pod's priority. */\n  priority?: number;\n\n  /** Filter pod routes. */\n  routes?: {\n    exclude?: (string | RegExp)[];\n  };\n\n  /** Configure pod collections. */\n  collections?: {\n    exclude?: string[];\n    /** Rename collection ids, e.g. {Posts: 'DocsPosts'}. */\n    rename?: Record<string, string>;\n  };\n}\n\n/**\n * Helper to define a pod with type-checking.\n */\nexport function definePod(pod: Pod): Pod {\n  return pod;\n}\n"],
+  "mappings": "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",
   "names": ["useContext", "useContext", "useContext", "useContext", "useContext", "jsx", "createContext", "useContext", "jsx"]
 }

package/dist/functions/server.d.ts

@@ -7,4 +7,4 @@ export interface ProdServerOptions {
 /**
  * Firebase Function that runs a Root.js server running in SSR mode.
  */
-export declare function server(options?: ProdServerOptions): import("firebase-functions/v2/https").HttpsFunction;
+export declare function server(options?: ProdServerOptions): import("firebase-functions/https").HttpsFunction;

package/dist/functions.js

@@ -1,11 +1,11 @@
 import {
   createPreviewServer,
   createProdServer
-} from "./chunk-WGQNQPWG.js";
-import "./chunk-YU22SAIG.js";
+} from "./chunk-WRZLI2L2.js";
+import "./chunk-QJ4F45DC.js";
 import "./chunk-I3RCAIW7.js";
-import "./chunk-M3E4RKS7.js";
-import "./chunk-KHO3HMX6.js";
+import "./chunk-DLPHCMFV.js";
+import "./chunk-Y4H75NIO.js";
 import "./chunk-3PWR4F2R.js";
 import "./chunk-XSNCF7WU.js";
 import "./chunk-TM6QRBGS.js";

package/dist/node.js

@@ -3,7 +3,7 @@ import {
   createViteServer,
   invalidatePodCache,
   viteSsrLoadModule
-} from "./chunk-YU22SAIG.js";
+} from "./chunk-QJ4F45DC.js";
 import {
   bundleRootConfig,
   flattenPackageDepsFromMonorepo,
@@ -12,7 +12,7 @@ import {
   loadPackageJson,
   loadRootConfig,
   loadRootConfigWithDeps
-} from "./chunk-KHO3HMX6.js";
+} from "./chunk-Y4H75NIO.js";
 import "./chunk-XSNCF7WU.js";
 export {
   bundleRootConfig,

package/dist/render/asset-map/asset-map.d.ts

@@ -15,11 +15,18 @@ export interface Asset {
      * Recursively walks all deps and returns a list of JS asset URLs.
      */
     getJsDeps(): Promise<string[]>;
+    /**
+     * Recursively walks all deps and returns a list of JS chunk URLs that the
+     * browser loads as a result of importing this asset. The asset's own URL is
+     * excluded. These URLs are injected as `<link rel="modulepreload">` tags
+     * when `modulePreload` is enabled in `root.config.ts`.
+     */
+    getModulePreloadDeps(): Promise<string[]>;
 }
 export interface AssetMap {
     /**
      * Returns the asset for a given src file. The `src` value should be a path
      * relative to the project root, e.g. "routes/index.tsx".
      */
-    get: (src: string) => Promise<Asset | null>;
+    get: (src: string) => Asset | null;
 }

package/dist/render/asset-map/build-asset-map.d.ts

@@ -23,7 +23,8 @@ export declare class BuildAssetMap implements AssetMap {
     private rootConfig;
     private srcToAsset;
     constructor(rootConfig: RootConfig);
-    get(src: string): Promise<Asset | null>;
+    get(src: string): Asset | null;
+    private find;
     private add;
     toJson(): BuildAssetManifest;
     static fromViteManifest(rootConfig: RootConfig, clientManifest: Manifest, elementsGraph: ElementGraph, podRoutes?: PodRouteAsset[]): BuildAssetMap;
@@ -45,7 +46,13 @@ export declare class BuildAsset {
     });
     getCssDeps(): Promise<string[]>;
     getJsDeps(): Promise<string[]>;
+    getModulePreloadDeps(): Promise<string[]>;
     private collectJs;
+    /**
+     * Walks `srcs` and their transitive imports, collecting the JS chunk URL of
+     * every module along the way.
+     */
+    private collectModulePreload;
     private collectCss;
     toJson(): {
         src: string;

package/dist/render/asset-map/dev-asset-map.d.ts

@@ -5,7 +5,7 @@ export declare class DevServerAssetMap implements AssetMap {
     private rootConfig;
     private moduleGraph;
     constructor(rootConfig: RootConfig, moduleGraph: ModuleGraph);
-    get(src: string): Promise<Asset | null>;
+    get(src: string): Asset | null;
     filePathToSrc(file: string): string;
 }
 export declare class DevServerAsset implements Asset {
@@ -20,6 +20,12 @@ export declare class DevServerAsset implements Asset {
     });
     getCssDeps(): Promise<string[]>;
     getJsDeps(): Promise<string[]>;
+    /**
+     * The dev server serves modules unbundled and unhashed, so there are no
+     * shared chunks to preload. Returning an empty list keeps
+     * `<link rel="modulepreload">` tags out of the dev server's HTML.
+     */
+    getModulePreloadDeps(): Promise<string[]>;
     getImportedModules(): Set<ModuleNode>;
     private collectJs;
     private collectCss;

package/dist/render/render.d.ts

@@ -90,7 +90,9 @@ export declare class Renderer {
     }>;
     /**
      * Parses rendered HTML for custom element tags used on the page and
-     * automatically adds the JS/CSS deps to the page.
+     * automatically adds the JS/CSS deps to the page. When `preloadDeps` is
+     * provided, the chunks imported by those elements are collected into it for
+     * `<link rel="modulepreload">` injection.
      */
     private collectElementDeps;
     /**

package/dist/render.js

@@ -1,11 +1,12 @@
 import {
+  ASSET_MAP_CONTEXT,
   HTML_CONTEXT,
   I18N_CONTEXT,
   REQUEST_CONTEXT,
   getTranslations,
   replaceParams,
   testPathHasParams
-} from "./chunk-KW7KTYGC.js";
+} from "./chunk-6QWKKJOB.js";
 import {
   RouteTrie
 } from "./chunk-I3RCAIW7.js";
@@ -13186,7 +13187,7 @@ var Renderer = class {
       bodyAttrs: {},
       scriptDeps: []
     };
-    const vdom = /* @__PURE__ */ jsx4(REQUEST_CONTEXT.Provider, { value: ctx, children: /* @__PURE__ */ jsx4(I18N_CONTEXT.Provider, { value: { locale, translations }, children: /* @__PURE__ */ jsx4(HTML_CONTEXT.Provider, { value: htmlContext, children: /* @__PURE__ */ jsx4(Component, { ...props }) }) }) });
+    const vdom = /* @__PURE__ */ jsx4(ASSET_MAP_CONTEXT.Provider, { value: this.assetMap, children: /* @__PURE__ */ jsx4(REQUEST_CONTEXT.Provider, { value: ctx, children: /* @__PURE__ */ jsx4(I18N_CONTEXT.Provider, { value: { locale, translations }, children: /* @__PURE__ */ jsx4(HTML_CONTEXT.Provider, { value: htmlContext, children: /* @__PURE__ */ jsx4(Component, { ...props }) }) }) }) });
     const renderJsxFn = await this.getJsxRenderFn({ mode: options.renderMode });
     const preactHook = preactOptions.vnode;
     let mainHtml;
@@ -13211,6 +13212,7 @@ var Renderer = class {
     }
     const jsDeps = /* @__PURE__ */ new Set();
     const cssDeps = /* @__PURE__ */ new Set();
+    const preloadDeps = this.rootConfig.modulePreload ? /* @__PURE__ */ new Set() : null;
     const routeAsset = await this.assetMap.get(route.src);
     if (routeAsset) {
       const routeCssDeps = await routeAsset.getCssDeps();
@@ -13224,7 +13226,7 @@ var Renderer = class {
     this.getConfiguredStyleEntries().forEach((styleEntry) => {
       cssDeps.add(styleEntry);
     });
-    await this.collectElementDeps(mainHtml, jsDeps, cssDeps);
+    await this.collectElementDeps(mainHtml, jsDeps, cssDeps, preloadDeps);
     await Promise.all(
       htmlContext.scriptDeps.map(async (scriptDep) => {
         if (!scriptDep.src) {
@@ -13236,12 +13238,19 @@ var Renderer = class {
           jsDeps.add(scriptAsset.assetUrl);
           const scriptJsDeps = await scriptAsset.getJsDeps();
           scriptJsDeps.forEach((dep) => jsDeps.add(dep));
+          if (preloadDeps) {
+            const scriptPreloadDeps = await scriptAsset.getModulePreloadDeps();
+            scriptPreloadDeps.forEach((dep) => preloadDeps.add(dep));
+          }
         }
       })
     );
     const styleTags = Array.from(cssDeps).map((cssUrl) => {
       return /* @__PURE__ */ jsx4("link", { rel: "stylesheet", href: cssUrl, nonce });
     });
+    const preloadTags = Array.from(preloadDeps || []).filter((jsUrl) => !jsDeps.has(jsUrl)).map((jsUrl) => {
+      return /* @__PURE__ */ jsx4("link", { rel: "modulepreload", href: jsUrl, nonce });
+    });
     const scriptTags = Array.from(jsDeps).map((jsUrls) => {
       if (this.rootConfig.experiments?.enableScriptAsync) {
         return /* @__PURE__ */ jsx4("script", { type: "module", src: jsUrls, nonce, async: true });
@@ -13255,6 +13264,7 @@ var Renderer = class {
       headComponents: [
         ...htmlContext.headComponents,
         ...styleTags,
+        ...preloadTags,
         ...scriptTags
       ],
       renderMode: options.renderMode
@@ -13682,9 +13692,11 @@ ${content}`;
   }
   /**
    * Parses rendered HTML for custom element tags used on the page and
-   * automatically adds the JS/CSS deps to the page.
+   * automatically adds the JS/CSS deps to the page. When `preloadDeps` is
+   * provided, the chunks imported by those elements are collected into it for
+   * `<link rel="modulepreload">` injection.
    */
-  async collectElementDeps(html, jsDeps, cssDeps) {
+  async collectElementDeps(html, jsDeps, cssDeps, preloadDeps) {
     const elementsMap = this.elementGraph.sourceFiles;
     const assetMap = this.assetMap;
     const tagNames = /* @__PURE__ */ new Set();
@@ -13705,6 +13717,10 @@ ${content}`;
         }
         const assetJsDeps = await asset.getJsDeps();
         assetJsDeps.forEach((dep) => jsDeps.add(dep));
+        if (preloadDeps) {
+          const assetPreloadDeps = await asset.getModulePreloadDeps();
+          assetPreloadDeps.forEach((dep) => preloadDeps.add(dep));
+        }
         const assetCssDeps = await asset.getCssDeps();
         assetCssDeps.forEach((dep) => {
           if (dep.endsWith("?inline")) {