@blinkk/root 3.0.1 → 3.0.3

package/dist/core/plugin.d.ts

@@ -0,0 +1,80 @@
+import { PluginOption as VitePlugin } from 'vite';
+import { RootConfig } from './config.js';
+import { Pod, PodFactory } from './pod.js';
+import { NextFunction, Request, Response, Server } from './types.js';
+type MaybePromise<T> = T | Promise<T>;
+type PreBuildHook = (rootConfig: RootConfig) => MaybePromise<void>;
+export interface PostBuildOptions {
+    /** Whether the build was SSR-only (no SSG pre-rendering). */
+    ssrOnly?: boolean;
+}
+type PostBuildHook = (rootConfig: RootConfig, options?: PostBuildOptions) => MaybePromise<void>;
+export type ConfigureServerHook = (server: Server, options: ConfigureServerOptions) => MaybePromise<void> | MaybePromise<() => void>;
+export interface ConfigureServerOptions {
+    type: 'dev' | 'preview' | 'prod';
+    rootConfig: RootConfig;
+}
+export interface PluginHooks {
+    /**
+     * Hook that runs before the build starts.
+     */
+    preBuild?: PreBuildHook;
+    /**
+     * Hook that runs after the build completes.
+     */
+    postBuild?: PostBuildHook;
+    /**
+     * Post-render hook that's called before the HTML is rendered to the response
+     * object. If a string is returned from this hook, it will replace the
+     * rendered HTML.
+     */
+    preRender?: (html: string) => void | MaybePromise<string>;
+}
+export interface Plugin {
+    [key: string]: any;
+    /** The name of the plugin. */
+    name?: string;
+    /**
+     * Configures the root.js express server. Any middleware defined by the plugin
+     * will be added to the server first. If a callback fn is returned, it will
+     * be called after the root.js middlewares are added.
+     */
+    configureServer?: ConfigureServerHook;
+    /**
+     * Hook for file changes.
+     */
+    onFileChange?: (eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir', path: string) => void;
+    /**
+     * Returns a list of deps to bundle for ssr. The files will be bundled and
+     * output to `dist/server/`. The return value should be a map of
+     * `{output filename => input filepath}`.
+     *
+     * E.g. a value of `{foo: 'path/to/bar.js'}` will output `dist/server/foo.js`.
+     *
+     * @experimental This config is subject to change to be incorporated into a
+     * broader config option called "ssr" or "ssrOptions".
+     */
+    ssrInput?: () => {
+        [entryAlias: string]: string;
+    };
+    /** Adds vite plugins. */
+    vitePlugins?: VitePlugin[];
+    /** Plugin lifecycle callback hooks. */
+    hooks?: PluginHooks;
+    /** Custom 404 handler. */
+    handle404?: (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+    /**
+     * Registers a pod (a mini root.js site) that gets merged into the parent
+     * site at dev/build time. A plugin may return a single pod, an array of
+     * pods, or a factory that receives the rootConfig.
+     */
+    pod?: Pod | Pod[] | PodFactory;
+}
+/**
+ * Runs the pre-hook configureServer method of every plugin, calls a callback
+ * function, and then runs the configureServer's post-hook if provided. Plugins
+ * provide a post-hook by returning a callback function from configureServer.
+ */
+export declare function configureServerPlugins(server: Server, callback: () => Promise<void>, plugins: Plugin[], options: ConfigureServerOptions): Promise<void>;
+export declare function getVitePlugins(plugins: Plugin[]): VitePlugin[];
+export {};

package/dist/core/pod.d.ts

@@ -0,0 +1,54 @@
+import { PluginOption as VitePlugin } from 'vite';
+import { RootConfig } from './config.js';
+export interface Pod {
+    /** Unique pod name, e.g. '@blinkk/root-docs-pod'. */
+    name: string;
+    /**
+     * URL prefix for pod routes. Routes within the pod are served under this
+     * mount path. Defaults to '/'.
+     */
+    mount?: string;
+    /**
+     * Priority for route conflict resolution. Higher values win when multiple
+     * pods register the same URL path. User-site routes always take precedence
+     * regardless of priority. Defaults to 0.
+     */
+    priority?: number;
+    /** Absolute path to the pod's routes/ directory. */
+    routesDir?: string;
+    /** Absolute path(s) to the pod's elements/ directory(s). */
+    elementsDirs?: string[];
+    /** Absolute path to the pod's bundles/ directory. */
+    bundlesDir?: string;
+    /** Absolute path to the pod's collections/ directory (root-cms only). */
+    collectionsDir?: string;
+    /** Absolute path to the pod's translations/ directory. */
+    translationsDir?: string;
+    /** Extra Vite plugins contributed by the pod. */
+    vitePlugins?: VitePlugin[];
+}
+export type PodFactory = (ctx: {
+    rootConfig: RootConfig;
+}) => Pod | Promise<Pod>;
+export interface PodConfig {
+    /** Whether the pod is enabled. Defaults to true. */
+    enabled?: boolean;
+    /** Override the pod's mount path. */
+    mount?: string;
+    /** Override the pod's priority. */
+    priority?: number;
+    /** Filter pod routes. */
+    routes?: {
+        exclude?: (string | RegExp)[];
+    };
+    /** Configure pod collections. */
+    collections?: {
+        exclude?: string[];
+        /** Rename collection ids, e.g. {Posts: 'DocsPosts'}. */
+        rename?: Record<string, string>;
+    };
+}
+/**
+ * Helper to define a pod with type-checking.
+ */
+export declare function definePod(pod: Pod): Pod;

package/dist/core/types.d.ts

@@ -0,0 +1,228 @@
+import { Express, Request as ExpressRequest, Response as ExpressResponse, NextFunction as ExpressNextFunction } from 'express';
+import { ComponentType } from 'preact';
+import { ViteDevServer } from 'vite';
+import { Hooks } from '../middleware/hooks.js';
+import { SaveSessionOptions, Session } from '../middleware/session.js';
+import { Renderer } from '../render/render.js';
+import { RootConfig } from './config.js';
+/**
+ * Param values from the route, e.g. a route like `/route/[slug].tsx` will pass
+ * `{slug: 'foo'}`.
+ */
+export type RouteParams = Record<string, string>;
+/**
+ * The `getStaticProps()` function is an optional function that routes can
+ * define to fetch and transform props before passing it to the route's
+ * component.
+ */
+export type GetStaticProps<T = unknown> = (ctx: {
+    rootConfig: RootConfig;
+    params: RouteParams;
+}) => Promise<{
+    /** Props to pass to the component. */
+    props?: T;
+    /** The rendered locale. */
+    locale?: string;
+    /**
+     * Translations to pass to `useTranslations()`. If provided, the translations
+     * map passed here will be merged with the translations from
+     * `/translations/{locale}.json`.
+     */
+    translations?: Record<string, string>;
+    /**  Set to true if the route should result in a 404 page. */
+    notFound?: boolean;
+}>;
+/**
+ * The `getStaticPaths()` is used by the SSG build to determine all of the
+ * paths that exist for a given route. This should be used alongside a
+ * parameterized route, e.g. `/routes/blog/[slug].tsx`.
+ */
+export type GetStaticPaths<T = RouteParams> = (ctx: {
+    rootConfig: RootConfig;
+}) => Promise<{
+    paths: Array<{
+        params: T;
+    }>;
+}>;
+/** Multipart file type for the multipartMiddleware(). */
+export interface MultipartFile {
+    fieldname: string;
+    originalName: string;
+    encoding: string;
+    mimetype: string;
+    buffer: Buffer;
+}
+export type RequestMiddleware = ((req: Request, res: Response) => any) | ((req: Request, res: Response, next: NextFunction) => any) | ((err: any, req: Request, res: Response, next: NextFunction) => any);
+/** Root.js express app. */
+export type Server = Express & {
+    use(middlewares: RequestMiddleware | RequestMiddleware[]): any;
+    use(urlPath: string, middlewares: RequestMiddleware | RequestMiddleware[]): any;
+};
+/** Root.js express request. */
+export type Request = ExpressRequest & {
+    /** The root.js project config. */
+    rootConfig?: RootConfig & {
+        rootDir: string;
+    };
+    /** The vite dev server. This is only available when running `root dev`. */
+    viteServer?: ViteDevServer;
+    /** The root.js renderer, to render routes within middleware. */
+    renderer?: Renderer;
+    /** Logged in user for the request. */
+    user?: {
+        email: string;
+    };
+    /**
+     * Handler context, provided to route files that export a custom `handler()`
+     * function.
+     */
+    handlerContext?: HandlerContext;
+    hooks: Hooks;
+    /** Gets and sets session data via cookie. */
+    session: Session;
+    /** Firebase functions uses rawBody for its multipart data. */
+    rawBody?: any;
+    /** Map of field name to file. */
+    files?: {
+        [fieldname: string]: MultipartFile;
+    };
+};
+/** Root.js express response. */
+export type Response = ExpressResponse & {
+    session: Session;
+    saveSession: (options?: SaveSessionOptions) => void;
+};
+/** Root.js express next function. */
+export type NextFunction = ExpressNextFunction;
+/**
+ * A context variable passed to a route's `handle()` method within the req
+ * object.
+ */
+export interface HandlerContext<Props = any> {
+    /**
+     * The resolved route.
+     */
+    route: Route;
+    /**
+     * Param values from the route, e.g. a route like `/route/[slug].tsx` will
+     * pass `{slug: 'foo'}`.
+     */
+    params: RouteParams;
+    /**
+     * i18n locales to try for the user's http request. The priority order mimics
+     * the Firebase Hosting i18n fallback logic.
+     * https://firebase.google.com/docs/hosting/i18n-rewrites#priority-order
+     */
+    i18nFallbackLocales: string[];
+    /**
+     * Iterates through the i18nFallbackLocales and returns the first available
+     * locale.
+     */
+    getPreferredLocale: (availableLocales: string[]) => string;
+    /** Renders the default exported component from the route. */
+    render: HandlerRenderFn<Props>;
+    /**
+     * Renders a 404 page. When `nextRoute` is true, the next matching route
+     * handler will be invoked instead of rendering the default 404 page.
+     */
+    render404: (options?: {
+        nextRoute?: boolean;
+    }) => Promise<void>;
+}
+/**
+ * The `handle()` function can be exported by a route to define a custom express
+ * request handler. The `req` object will contain a `handlerContext` which
+ * contains the route's param values and also a `render()` method that can be
+ * used to render the route's default component.
+ */
+export type Handler = (req: Request, res: Response, next: NextFunction) => void | Promise<void>;
+export interface StaticContentResult {
+    body: string;
+    contentType?: string;
+}
+/**
+ * The `getStaticContent()` function is a SSG handler function for non-HTML
+ * routes, e.g. `routes/sitemap.xml.ts`.
+ *
+ * If the route exports a `getStaticProps()` function, the props returned from
+ * that function is passed to `getStaticContent()`. Otherwise a default props
+ * value is passed which includes the `rootConfig` and route param values.
+ */
+export type GetStaticContent = (props: any) => Promise<StaticContentResult | string> | StaticContentResult | string;
+export interface RouteModule {
+    default?: ComponentType<unknown>;
+    getStaticPaths?: GetStaticPaths;
+    getStaticProps?: GetStaticProps;
+    handle?: Handler;
+    getStaticContent?: GetStaticContent;
+}
+export interface Route {
+    /** The relative path to the route file, e.g. `routes/index.tsx`. */
+    src: string;
+    /** The imported route module. */
+    module: RouteModule;
+    /** The locale used for the route. */
+    locale: string;
+    /**
+     * Returns `true` if the route is the default locale route mapped without the
+     * i18n url prefix. For example, a route may be mapped to `/foo` and
+     * `/[locale]/foo`. The `/foo` route would have `route.isDefaultLocale` set to
+     * `true` whereas for `/[locale]/foo` it would be `false`.
+     */
+    isDefaultLocale: boolean;
+    /**
+     * The mapped URL path for the route, e.g.:
+     *
+     *   routes/index.tsx => `/`.
+     *   routes/events.tsx => `/events`.
+     *   routes/blog/[slug].tsx => `/blog/[slug]`.
+     *
+     * Per the example above, this value may contain placeholder params.
+     */
+    routePath: string;
+    /**
+     * The localized URL path for the route, e.g. `/[locale]/blog/[slug]`.
+     * Per the example above, this value contains placeholder params.
+     */
+    localeRoutePath: string;
+    /**
+     * The name of the pod that contributed this route, or undefined if the
+     * route is from the user's project.
+     */
+    podName?: string;
+}
+export interface HandlerRenderOptions {
+    /** HTTP status code to return. Defaults to 200. */
+    statusCode?: number;
+    /** The rendered locale. */
+    locale?: string;
+    /**
+     * Translations to pass to `useTranslations()`. If provided, the translations
+     * map passed here will be merged with the translations from
+     * `/translations/{locale}.json`.
+     */
+    translations?: Record<string, string>;
+}
+export type HandlerRenderFn<Props = any> = (props: Props, options?: HandlerRenderOptions) => Promise<void>;
+/**
+ * Sitemap is a map of URL path -> route info.
+ */
+export type Sitemap = Record<string, SitemapItem>;
+/**
+ * Sitemap route info. The "default locale" route provides "alts" that can be
+ * used for outputting the localized url paths.
+ */
+export interface SitemapItem {
+    urlPath: string;
+    route: Route;
+    params: Record<string, string>;
+    locale: string;
+    hrefLang: string;
+    /**
+     * Hreflang alts.
+     */
+    alts: Record<string, {
+        hrefLang: string;
+        urlPath: string;
+    }>;
+}

package/dist/core.js

@@ -6,7 +6,7 @@ import {
   testPathHasParams,
   useI18nContext,
   useRequestContext
-} from "./chunk-WAZTR3DX.js";
+} from "./chunk-KW7KTYGC.js";
 import {
   configureServerPlugins,
   getVitePlugins
@@ -120,7 +120,7 @@ function useTranslations() {
   let i18nContext = null;
   try {
     i18nContext = useI18nContext();
-  } catch (err) {
+  } catch {
     console.warn("I18nContext not found");
   }
   const translations = i18nContext?.translations || {};
@@ -198,4 +198,4 @@ export {
   useTranslationMiddleware,
   useTranslations
 };
-//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +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) — block-level elements render on their own\n   *   line with no indentation.\n   * - `mode: 'minimal'` — 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 automatically minify HTML output. This is enabled by default,\n   * in order to disable, pass `minifyHtml: false` to root.config.ts.\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.\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: string[];\n}\n\nexport interface RootI18nConfig {\n  /**\n   * Locales enabled for the site.\n   */\n  locales?: string[];\n\n  /**\n   * The default locale to use. Defaults is `en`.\n   */\n  defaultLocale?: string;\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\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 (err) {\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"]}
+{
+  "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 automatically minify HTML output. This is enabled by default,\n   * in order to disable, pass `minifyHtml: false` to root.config.ts.\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.\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: string[];\n}\n\nexport interface RootI18nConfig {\n  /**\n   * Locales enabled for the site.\n   */\n  locales?: string[];\n\n  /**\n   * The default locale to use. Defaults is `en`.\n   */\n  defaultLocale?: string;\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\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/functions.d.ts

@@ -0,0 +1 @@
+export * from './server.js';

package/dist/functions/server.d.ts

@@ -0,0 +1,10 @@
+import { HttpsOptions } from 'firebase-functions/v2/https';
+export interface ProdServerOptions {
+    rootDir?: string;
+    mode?: 'preview' | 'production';
+    httpsOptions?: HttpsOptions;
+}
+/**
+ * Firebase Function that runs a Root.js server running in SSR mode.
+ */
+export declare function server(options?: ProdServerOptions): import("firebase-functions/v2/https").HttpsFunction;

package/dist/functions.js

@@ -1,14 +1,14 @@
 import {
   createPreviewServer,
   createProdServer
-} from "./chunk-GSR74KEI.js";
+} from "./chunk-JTZWI4MH.js";
 import "./chunk-6P3B7ZXL.js";
-import "./chunk-JCRXBB26.js";
-import "./chunk-PVBPP5LN.js";
+import "./chunk-6NBKAR5Y.js";
+import "./chunk-7PSEEE6C.js";
 import "./chunk-XSNCF7WU.js";
 
 // src/functions/server.ts
-import path from "path";
+import path from "node:path";
 import { onRequest } from "firebase-functions/v2/https";
 function server(options) {
   let rootServer;
@@ -27,4 +27,4 @@ function server(options) {
 export {
   server
 };
-//# sourceMappingURL=functions.js.map
+//# sourceMappingURL=functions.js.map

package/dist/functions.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../src/functions/server.ts"],"sourcesContent":["import path from 'node:path';\nimport {HttpsOptions, onRequest} from 'firebase-functions/v2/https';\nimport {createPreviewServer, createProdServer} from '../cli/cli.js';\nimport {Server} from '../core/types.js';\n\nexport interface ProdServerOptions {\n  rootDir?: string;\n  mode?: 'preview' | 'production';\n  httpsOptions?: HttpsOptions;\n}\n\n/**\n * Firebase Function that runs a Root.js server running in SSR mode.\n */\nexport function server(options?: ProdServerOptions) {\n  let rootServer: Server;\n  const rootDir = path.resolve(options?.rootDir || process.cwd());\n  return onRequest(options?.httpsOptions || {}, async (req, res) => {\n    if (!rootServer) {\n      if (options?.mode === 'preview') {\n        rootServer = await createPreviewServer({rootDir});\n      } else {\n        rootServer = await createProdServer({rootDir});\n      }\n    }\n    await rootServer(req, res);\n  });\n}\n"],"mappings":";;;;;;;;;;AAAA,OAAO,UAAU;AACjB,SAAsB,iBAAgB;AAa/B,SAAS,OAAO,SAA6B;AAClD,MAAI;AACJ,QAAM,UAAU,KAAK,QAAQ,SAAS,WAAW,QAAQ,IAAI,CAAC;AAC9D,SAAO,UAAU,SAAS,gBAAgB,CAAC,GAAG,OAAO,KAAK,QAAQ;AAChE,QAAI,CAAC,YAAY;AACf,UAAI,SAAS,SAAS,WAAW;AAC/B,qBAAa,MAAM,oBAAoB,EAAC,QAAO,CAAC;AAAA,MAClD,OAAO;AACL,qBAAa,MAAM,iBAAiB,EAAC,QAAO,CAAC;AAAA,MAC/C;AAAA,IACF;AACA,UAAM,WAAW,KAAK,GAAG;AAAA,EAC3B,CAAC;AACH;","names":[]}
+{
+  "version": 3,
+  "sources": ["../src/functions/server.ts"],
+  "sourcesContent": ["import path from 'node:path';\nimport {HttpsOptions, onRequest} from 'firebase-functions/v2/https';\nimport {createPreviewServer, createProdServer} from '../cli/cli.js';\nimport {Server} from '../core/types.js';\n\nexport interface ProdServerOptions {\n  rootDir?: string;\n  mode?: 'preview' | 'production';\n  httpsOptions?: HttpsOptions;\n}\n\n/**\n * Firebase Function that runs a Root.js server running in SSR mode.\n */\nexport function server(options?: ProdServerOptions) {\n  let rootServer: Server;\n  const rootDir = path.resolve(options?.rootDir || process.cwd());\n  return onRequest(options?.httpsOptions || {}, async (req, res) => {\n    if (!rootServer) {\n      if (options?.mode === 'preview') {\n        rootServer = await createPreviewServer({rootDir});\n      } else {\n        rootServer = await createProdServer({rootDir});\n      }\n    }\n    await rootServer(req, res);\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;AAAA,OAAO,UAAU;AACjB,SAAsB,iBAAgB;AAa/B,SAAS,OAAO,SAA6B;AAClD,MAAI;AACJ,QAAM,UAAU,KAAK,QAAQ,SAAS,WAAW,QAAQ,IAAI,CAAC;AAC9D,SAAO,UAAU,SAAS,gBAAgB,CAAC,GAAG,OAAO,KAAK,QAAQ;AAChE,QAAI,CAAC,YAAY;AACf,UAAI,SAAS,SAAS,WAAW;AAC/B,qBAAa,MAAM,oBAAoB,EAAC,QAAO,CAAC;AAAA,MAClD,OAAO;AACL,qBAAa,MAAM,iBAAiB,EAAC,QAAO,CAAC;AAAA,MAC/C;AAAA,IACF;AACA,UAAM,WAAW,KAAK,GAAG;AAAA,EAC3B,CAAC;AACH;",
+  "names": []
+}

package/dist/jsx/jsx-dev-runtime.d.ts

@@ -1 +1,10 @@
-export { F as Fragment, J as JSX, j as jsx, j as jsxDEV, j as jsxs } from '../jsx-dev-runtime-DUJrvx5P.js';
+/**
+ * @module jsx-dev-runtime
+ *
+ * Development JSX runtime entry point. For SSR, this is identical to the
+ * production runtime since there is no client-side diffing or dev warnings
+ * to add. TypeScript / bundlers look for this module when `jsxImportSource`
+ * is configured and the build is in development mode.
+ */
+export { jsx, jsx as jsxDEV, jsxs, Fragment } from './jsx-runtime.js';
+export type { JSX } from './types.js';

package/dist/jsx/jsx-dev-runtime.js

@@ -1,11 +1,11 @@
 import {
   Fragment,
   jsx
-} from "../chunk-FQBA5QSG.js";
+} from "../chunk-3Z5TNZEP.js";
 export {
   Fragment,
   jsx,
   jsx as jsxDEV,
   jsx as jsxs
 };
-//# sourceMappingURL=jsx-dev-runtime.js.map
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx/jsx-dev-runtime.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/{jsx-C8BaDh-4.d.ts → jsx/jsx-render.d.ts}

@@ -1,6 +1,5 @@
-import { V as VNode } from './jsx-dev-runtime-DUJrvx5P.js';
-
-interface JsxRenderOptions {
+import { VNode } from './jsx-runtime.js';
+export interface JsxRenderOptions {
     /** Render mode. `'pretty'` adds newlines around block elements; `'minimal'` outputs compact HTML. Default: `'pretty'`. */
     mode?: 'pretty' | 'minimal';
     /** Additional tag names to treat as block-level elements in pretty mode. */
@@ -9,6 +8,4 @@ interface JsxRenderOptions {
 /**
  * Renders a Preact VNode tree to an HTML string.
  */
-declare function renderJsxToString(vnode: VNode, options?: JsxRenderOptions): string;
-
-export { type JsxRenderOptions as J, renderJsxToString as r };
+export declare function renderJsxToString(vnode: VNode, options?: JsxRenderOptions): string;