@blinkk/root 3.0.2 → 3.0.4

package/dist/jsx/jsx.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module jsx
+ *
+ * Root.js server-side JSX renderer. A zero-dependency JSX runtime that
+ * replaces Preact for server-side rendering (SSR/SSG).
+ *
+ * ## Quick Start
+ *
+ * Configure your `tsconfig.json`:
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "jsx": "react-jsx",
+ *     "jsxImportSource": "@blinkk/root/jsx"
+ *   }
+ * }
+ * ```
+ *
+ * Import hooks and utilities directly:
+ * ```ts
+ * import {createContext, useContext, renderJsxToString} from '@blinkk/root/jsx';
+ * ```
+ *
+ * ## What's included
+ *
+ * - `jsx` / `jsxs` / `Fragment` — Automatic JSX transform
+ * - `createElement` / `h` — Classic JSX transform
+ * - `createContext` / `useContext` — Context API for SSR
+ * - `renderJsxToString` — Render VNode trees to HTML strings
+ * - `options` — VNode lifecycle hook (for nonce injection, etc.)
+ * - Full TypeScript JSX type definitions
+ */
+export { jsx, jsxs, Fragment, createElement, h, options, createContext, useContext, } from './jsx-runtime.js';
+export type { VNode, ComponentChildren, ComponentChild, ComponentType, FunctionalComponent, Context, Key, } from './jsx-runtime.js';
+export { renderJsxToString } from './jsx-render.js';
+export type { HTMLAttributes, SVGAttributes, ScriptHTMLAttributes, DOMAttributes, AriaAttributes, } from './types.js';
+export type { JSX } from './types.js';

package/dist/{jsx-dev-runtime-DHf9jiFH.d.ts → jsx/types.d.ts}

@@ -5,8 +5,8 @@
  * JSX runtime. These types allow TypeScript to type-check JSX expressions
  * when `jsxImportSource` points to this module.
  */
-
-interface DOMAttributes {
+import type { VNode, ComponentChildren } from './jsx-runtime.js';
+export interface DOMAttributes {
     children?: ComponentChildren;
     dangerouslySetInnerHTML?: {
         __html: string;
@@ -54,7 +54,7 @@ interface DOMAttributes {
     onError?: EventHandler;
 }
 type EventHandler = string | ((...args: any[]) => void);
-interface AriaAttributes {
+export interface AriaAttributes {
     role?: string;
     'aria-activedescendant'?: string;
     'aria-atomic'?: boolean | 'false' | 'true';
@@ -111,7 +111,7 @@ interface AriaAttributes {
  * `HTMLAttributes<HTMLElement>` pattern, but is unused at runtime since
  * this is an SSR-only renderer.
  */
-interface HTMLAttributes<T = HTMLElement> extends DOMAttributes, AriaAttributes {
+export interface HTMLAttributes<T = HTMLElement> extends DOMAttributes, AriaAttributes {
     accept?: string;
     acceptCharset?: string;
     accessKey?: string;
@@ -259,7 +259,7 @@ interface HTMLAttributes<T = HTMLElement> extends DOMAttributes, AriaAttributes
 /**
  * SVG-specific attributes.
  */
-interface SVGAttributes<T = SVGElement> extends HTMLAttributes<T> {
+export interface SVGAttributes<T = SVGElement> extends HTMLAttributes<T> {
     accentHeight?: number | string;
     accumulate?: 'none' | 'sum';
     additive?: 'replace' | 'sum';
@@ -366,7 +366,7 @@ interface SVGAttributes<T = SVGElement> extends HTMLAttributes<T> {
 /**
  * Script-specific HTML attributes (for the `<Script>` component).
  */
-interface ScriptHTMLAttributes<T = HTMLScriptElement> extends HTMLAttributes<T> {
+export interface ScriptHTMLAttributes<T = HTMLScriptElement> extends HTMLAttributes<T> {
     async?: boolean;
     crossOrigin?: string;
     defer?: boolean;
@@ -377,7 +377,7 @@ interface ScriptHTMLAttributes<T = HTMLScriptElement> extends HTMLAttributes<T>
     src?: string;
     type?: string;
 }
-declare namespace JSX {
+export declare namespace JSX {
     type Element = VNode<any>;
     interface ElementChildrenAttribute {
         children: {};
@@ -558,120 +558,4 @@ declare namespace JSX {
         view: SVGAttributes<SVGViewElement>;
     }
 }
-
-/**
- * @module jsx-runtime
- *
- * Server-side JSX runtime for Root.js. Replaces Preact as the JSX renderer
- * for server-side rendering (SSR/SSG). This module provides the automatic
- * JSX transform entry point (`jsxImportSource`).
- *
- * Supports:
- * - Automatic JSX transform (jsx, jsxs, Fragment)
- * - Classic JSX transform (createElement / h)
- * - Context API (createContext, useContext)
- * - Server-side renderToString
- */
-type Key = string | number | null;
-/**
- * A virtual DOM node representing an element, component, or fragment.
- */
-interface VNode<P = Record<string, unknown>> {
-    type: string | FunctionalComponent<P> | typeof Fragment | (new (...args: any[]) => any);
-    props: P;
-    key: Key;
-}
-/**
- * Valid children types for JSX elements.
- */
-type ComponentChildren = VNode<any> | string | number | bigint | boolean | null | undefined | ComponentChildren[];
-type ComponentChild = ComponentChildren;
-/**
- * A function component that receives props and returns a VNode or null.
- */
-interface FunctionalComponent<P = Record<string, unknown>> {
-    (props: P): VNode<any> | null;
-    displayName?: string;
-    /** @internal Marks this component as a context Provider. */
-    _isProvider?: boolean;
-    /** @internal Reference to the context object for Provider components. */
-    _context?: Context<any>;
-}
-/**
- * Generic component type (function components only for SSR).
- */
-type ComponentType<P = Record<string, unknown>> = FunctionalComponent<P>;
-/**
- * Global options object. The `vnode` callback is invoked for every VNode
- * created via `jsx()`, `jsxs()`, or `createElement()`. This is used by the
- * renderer to inject nonce values into script/style tags.
- */
-declare const options: {
-    vnode?: (vnode: VNode<any>) => void;
-};
-/**
- * Fragment component. Renders its children without a wrapper DOM element.
- * Used as `<>...</>` or `<Fragment>...</Fragment>` in JSX.
- */
-declare function Fragment(props: {
-    children?: ComponentChildren;
-}): any;
-/**
- * Creates a VNode. Used by the automatic JSX transform for elements with
- * a single child or no children.
- */
-declare function jsx(type: string | FunctionalComponent<any> | typeof Fragment, props: Record<string, any>, key?: Key): VNode;
-
-/**
- * Creates a VNode. Compatible with the classic `React.createElement` API.
- *
- * ```ts
- * createElement('div', {className: 'foo'}, 'Hello', ' ', 'World');
- * ```
- */
-declare function createElement(type: string | FunctionalComponent<any> | typeof Fragment, props?: Record<string, any> | null, ...children: any[]): VNode;
-
-/**
- * A context object created by `createContext()`. Provides a `Provider`
- * component and can be read via `useContext()`.
- */
-interface Context<T> {
-    /** @internal Default value for this context. */
-    _defaultValue: T;
-    /** @internal Stack of provided values (managed by renderToString). */
-    _stack: T[];
-    /** Provider component that supplies a context value to descendants. */
-    Provider: FunctionalComponent<{
-        value: T;
-        children?: ComponentChildren;
-    }>;
-}
-/**
- * Creates a new context with an optional default value. Returns a context
- * object with a `Provider` component.
- *
- * ```ts
- * const ThemeContext = createContext('light');
- *
- * // In a parent component:
- * <ThemeContext.Provider value="dark">
- *   <App />
- * </ThemeContext.Provider>
- *
- * // In a child component:
- * const theme = useContext(ThemeContext);
- * ```
- */
-declare function createContext<T>(defaultValue: T): Context<T>;
-/**
- * Reads the current value of a context. Must be called during the render
- * of a function component that is a descendant of a matching Provider.
- * Returns the default value if no Provider is found.
- *
- * ```ts
- * const theme = useContext(ThemeContext);
- * ```
- */
-declare function useContext<T>(context: Context<T>): T;
-
-export { type AriaAttributes as A, type ComponentChildren as C, type DOMAttributes as D, Fragment as F, type HTMLAttributes as H, JSX as J, type Key as K, type SVGAttributes as S, type VNode as V, createContext as a, type ComponentChild as b, createElement as c, type ComponentType as d, type FunctionalComponent as e, type Context as f, type ScriptHTMLAttributes as g, jsx as j, options as o, useContext as u };
+export {};

package/dist/jsx.js

@@ -1,6 +1,6 @@
 import {
   renderJsxToString
-} from "./chunk-4PO5HYET.js";
+} from "./chunk-X2C2MEJ2.js";
 import {
   Fragment,
   createContext,
@@ -8,7 +8,7 @@ import {
   jsx,
   options,
   useContext
-} from "./chunk-FQBA5QSG.js";
+} from "./chunk-3Z5TNZEP.js";
 export {
   Fragment,
   createContext,
@@ -20,4 +20,4 @@ export {
   renderJsxToString,
   useContext
 };
-//# sourceMappingURL=jsx.js.map
+//# sourceMappingURL=jsx.js.map

package/dist/jsx.js.map

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

package/dist/middleware/common.d.ts

@@ -0,0 +1,22 @@
+import { RootConfig } from '../core/config.js';
+import { Request, Response, NextFunction } from '../core/types.js';
+/**
+ * Middleware that injects the root.js project config into the request context.
+ */
+export declare function rootProjectMiddleware(options: {
+    rootConfig: RootConfig;
+}): (req: Request, _: Response, next: NextFunction) => void;
+/**
+ * Middleware that injects HTTP headers from the `server.headers` config in
+ * root.config.ts.
+ */
+export declare function headersMiddleware(options: {
+    rootConfig: RootConfig;
+}): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Trailing slash middleware. Handles trailing slash redirects (preserving any
+ * query params) using the `server.trailingSlash` config in root.config.ts.
+ */
+export declare function trailingSlashMiddleware(options: {
+    rootConfig: RootConfig;
+}): (req: Request, res: Response, next: NextFunction) => void;

package/dist/middleware/hooks.d.ts

@@ -0,0 +1,8 @@
+import { Request, Response, NextFunction } from '../core/types.js';
+export declare function hooksMiddleware(): (req: Request, res: Response, next: NextFunction) => void;
+export type HooksCallbackFn = (...args: any[]) => any;
+export declare class Hooks {
+    private callbacks;
+    add(name: string, cb: (...args: any[]) => any): void;
+    trigger(name: string, ...args: any[]): void;
+}

package/dist/middleware/middleware.d.ts

@@ -0,0 +1,3 @@
+export * from './common.js';
+export * from './multipart.js';
+export * from './session.js';

package/dist/middleware/multipart.d.ts

@@ -0,0 +1,11 @@
+import { RequestHandler } from 'express';
+/**
+ * Middleware for parsing multipart file uploads that's compatible with the dev
+ * server and Firebase Functions.
+ *
+ * Context:
+ * https://stackoverflow.com/questions/47242340/how-to-perform-an-http-file-upload-using-express-on-cloud-functions-for-firebase
+ */
+export declare function multipartMiddleware(options?: {
+    maxFileSize?: number;
+}): RequestHandler;

package/dist/middleware/redirects.d.ts

@@ -0,0 +1,10 @@
+import { RootRedirectConfig } from '../core/config.js';
+import { NextFunction, Request, Response } from '../core/types.js';
+export interface RedirectsMiddlewareOptions {
+    redirects: RootRedirectConfig[];
+}
+/**
+ * Middleware for handling server-side redirects from the `server.redirects`
+ * config in `root.config.ts`.
+ */
+export declare function redirectsMiddleware(options: RedirectsMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;

package/dist/middleware/session.d.ts

@@ -0,0 +1,24 @@
+import { NextFunction, Request, Response } from '../core/types.js';
+export declare const SESSION_COOKIE = "__session";
+export interface SessionMiddlewareOptions {
+    maxAge?: number;
+}
+export interface SaveSessionOptions {
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+/**
+ * Middleware for storing session data stored in an http cookie called
+ * `__session`. This cookie is compatible with Firebase Hosting:
+ * https://firebase.google.com/docs/hosting/manage-cache#using_cookies
+ */
+export declare function sessionMiddleware(options?: SessionMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+export declare class Session {
+    private data;
+    hasChanges: boolean;
+    constructor(data?: Record<string, string>);
+    static fromCookieValue(cookieValue: string): Session;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    toString(): string;
+}

package/dist/middleware.js

@@ -6,7 +6,7 @@ import {
   rootProjectMiddleware,
   sessionMiddleware,
   trailingSlashMiddleware
-} from "./chunk-JCRXBB26.js";
+} from "./chunk-6NBKAR5Y.js";
 export {
   SESSION_COOKIE,
   Session,
@@ -16,4 +16,4 @@ export {
   sessionMiddleware,
   trailingSlashMiddleware
 };
-//# sourceMappingURL=middleware.js.map
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/node/element-graph.d.ts

@@ -0,0 +1,51 @@
+import { RootConfig } from '../core/config.js';
+import type { ResolvedPod } from './pod-collector.js';
+interface ElementSourceFile {
+    /** Full file path. */
+    filePath: string;
+    /** Path relative to the root project directory. */
+    relPath: string;
+}
+/**
+ * Dependency graph for element files to capture which other elements are used
+ * by any particular element.
+ */
+export declare class ElementGraph {
+    /**
+     * Element tagName => sourceFile.
+     */
+    readonly sourceFiles: {
+        [tagName: string]: ElementSourceFile;
+    };
+    /**
+     * Element tagName => set of element tagName dependencies.
+     */
+    private deps;
+    constructor(sourceFiles: {
+        [tagName: string]: ElementSourceFile;
+    });
+    toJson(): {
+        sourceFiles: {
+            [tagName: string]: ElementSourceFile;
+        };
+        deps: Record<string, string[]>;
+    };
+    static fromJson(data: {
+        deps: any;
+        sourceFiles: any;
+    }): ElementGraph;
+    getDeps(tagName: string, visited?: Set<string>): string[];
+    /**
+     * Parses an element's source file for usage of other custom elements.
+     */
+    private parseDepsFromSource;
+}
+/**
+ * Returns a map of all the element file definitions in the project.
+ */
+export declare function getElements(rootConfig: RootConfig, pods?: ResolvedPod[]): Promise<ElementGraph>;
+/**
+ * Get all element dirs.
+ */
+export declare function getElementsDirs(rootConfig: RootConfig, pods?: ResolvedPod[]): string[];
+export {};

package/dist/node/load-config.d.ts

@@ -0,0 +1,17 @@
+import { RootConfig } from '../core/config.js';
+export interface ConfigOptions {
+    command: string;
+}
+export declare function loadRootConfig(rootDir: string, options: ConfigOptions): Promise<RootConfig>;
+export declare function loadRootConfigWithDeps(rootDir: string, options: ConfigOptions): Promise<{
+    rootConfig: RootConfig;
+    dependencies: string[];
+}>;
+/**
+ * Compiles a root.config.ts file to root.config.js.
+ */
+export declare function bundleRootConfig(rootDir: string, outPath: string): Promise<void>;
+/**
+ * Loads a pre-bundled config file from dist/root.config.js.
+ */
+export declare function loadBundledConfig(rootDir: string, options: ConfigOptions): Promise<RootConfig>;

package/dist/node/monorepo.d.ts

@@ -0,0 +1,14 @@
+import { PackageInfo } from 'workspace-tools';
+export declare function loadPackageJson(filepath: string): PackageInfo | null;
+/**
+ * Returns the top-level monorepo package's deps, if any.
+ */
+export declare function getMonorepoPackageDeps(rootDir: string): Record<string, string>;
+/**
+ * Flattens package.json deps from the root project dir, taking into account any
+ * deps from the monorepo root as well as any `workspace:` deps from within the
+ * monorepo.
+ */
+export declare function flattenPackageDepsFromMonorepo(rootDir: string, options?: {
+    ignore?: Set<string>;
+}): Record<string, string>;

package/dist/node/node.d.ts

@@ -0,0 +1,4 @@
+export * from './load-config.js';
+export * from './monorepo.js';
+export * from './pod-collector.js';
+export * from './vite.js';

package/dist/node/pod-collector.d.ts

@@ -0,0 +1,33 @@
+import { RootConfig } from '../core/config.js';
+import { PodConfig } from '../core/pod.js';
+export interface ResolvedPodRoute {
+    filePath: string;
+    relPath: string;
+    routePath: string;
+}
+export interface ResolvedPodCollection {
+    filePath: string;
+    relPath: string;
+    id: string;
+}
+export interface ResolvedPod {
+    name: string;
+    enabled: boolean;
+    mount: string;
+    priority: number;
+    routesDir?: string;
+    elementsDirs: string[];
+    bundlesDir?: string;
+    collectionsDir?: string;
+    translationsDir?: string;
+    routeFiles: ResolvedPodRoute[];
+    bundleFiles: string[];
+    collectionFiles: ResolvedPodCollection[];
+    translationFiles: Array<{
+        locale: string;
+        filePath: string;
+    }>;
+    config: PodConfig;
+}
+export declare function invalidatePodCache(): void;
+export declare function collectPods(rootConfig: RootConfig): Promise<ResolvedPod[]>;

package/dist/node/pods-vite-plugin.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin as VitePlugin } from 'vite';
+import { RootConfig } from '../core/config.js';
+export declare const VIRTUAL_ROUTES_ID = "virtual:root/routes";
+export declare const VIRTUAL_SCHEMAS_ID = "virtual:root/schemas";
+export declare const VIRTUAL_TRANSLATIONS_ID = "virtual:root/translations";
+export declare function rootPodsVitePlugin(rootConfig: RootConfig): VitePlugin;

package/dist/node/vite-plugin-preact-alias.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+/**
+ * Vite plugin that aliases `preact` imports to `@blinkk/root/jsx`.
+ *
+ * When `jsxRenderer.mode` is configured, the project uses Root's built-in JSX
+ * runtime instead of Preact. This plugin redirects all `preact` imports
+ * (including `preact/hooks`, `preact/jsx-runtime`, etc.) so that Root's
+ * built-in hooks and components use Root's context API rather than Preact's.
+ */
+export declare function preactToRootJsxPlugin(): Plugin;

package/dist/node/vite-plugin-prune-empty-chunks.d.ts

@@ -0,0 +1,27 @@
+import type { Plugin } from 'vite';
+/**
+ * Vite plugin that removes 0-byte JS chunks from the build output and prunes
+ * the import statements that reference them.
+ *
+ * Tree-shaking (via rolldown/esbuild) can reduce a module to nothing — e.g. a
+ * type-only `.ts` file, or an entry whose contents are entirely eliminated.
+ * rolldown still emits a file for every explicit input, so these surface as
+ * 0-byte `.js` files in the build output. Worse, a sibling chunk may keep a
+ * bare side-effect import (`import "./<hash>.js"`) pointing at the empty file.
+ * If that empty file is removed without also removing the import, the import
+ * 404s at runtime and breaks the entire module graph.
+ *
+ * This plugin runs in `generateBundle` (before Vite's manifest plugin) and:
+ *   1. Detects chunks whose generated code is empty.
+ *   2. Skips any that still anchor CSS or asset references, so co-located
+ *      styles are preserved (Vite keeps an empty JS chunk to carry the CSS
+ *      link for a style-only module).
+ *   3. Strips bare side-effect imports of the empty chunks from sibling chunks.
+ *      A 0-byte module exports nothing, so it can only be imported bare.
+ *   4. Deletes the empty chunks from the bundle.
+ *
+ * Because it runs before the manifest is emitted, the resulting
+ * `manifest.json` (consumed by Root's asset map) never references the removed
+ * files.
+ */
+export declare function pruneEmptyChunksPlugin(): Plugin;

package/dist/node/vite-plugin-root-jsx-virtual.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from 'vite';
+export interface PreactToRootJsxPluginOptions {
+    /** Whether Root's JSX renderer mode is enabled. */
+    useRootJsx?: boolean;
+}
+/**
+ * Vite plugin that aliases `preact` imports to `@blinkk/root/jsx` in the SSR
+ * environment only.
+ *
+ * When `jsxRenderer.mode` is configured, the project uses Root's built-in JSX
+ * runtime instead of Preact for server-side rendering. This plugin redirects
+ * `preact` imports (`preact`, `preact/hooks`, `preact/jsx-runtime`, etc.) to
+ * Root's JSX package, but only in the SSR environment. Client-side code (e.g.
+ * islands that depend on real Preact for hydration) is left untouched.
+ */
+export declare function preactToRootJsxPlugin(options?: PreactToRootJsxPluginOptions): Plugin;

package/dist/node/vite.d.ts

@@ -0,0 +1,18 @@
+import { ViteDevServer } from 'vite';
+import { RootConfig } from '../core/config.js';
+export interface CreateViteServerOptions {
+    /** Override HMR settings. */
+    hmr?: boolean;
+    /** The port the server will run on. */
+    port?: number;
+    /** List of files to include in the optimizeDeps.include config. */
+    optimizeDeps?: string[];
+}
+/**
+ * Returns a vite dev server.
+ */
+export declare function createViteServer(rootConfig: RootConfig, options?: CreateViteServerOptions): Promise<ViteDevServer>;
+/**
+ * Shortcut `viteServer.ssrLoadModule()` without starting an actual dev server.
+ */
+export declare function viteSsrLoadModule<T = Record<string, any>>(rootConfig: RootConfig, file: string): Promise<T>;

package/dist/node.js

@@ -10,7 +10,7 @@ import {
   loadRootConfig,
   loadRootConfigWithDeps,
   viteSsrLoadModule
-} from "./chunk-PVBPP5LN.js";
+} from "./chunk-7PSEEE6C.js";
 import "./chunk-XSNCF7WU.js";
 export {
   bundleRootConfig,
@@ -25,4 +25,4 @@ export {
   loadRootConfigWithDeps,
   viteSsrLoadModule
 };
-//# sourceMappingURL=node.js.map
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/render/accept-language.d.ts

@@ -0,0 +1,8 @@
+export declare const ACCEPT_LANG_RE: RegExp;
+export interface AcceptLanguage {
+    code: string;
+    script?: string;
+    region?: string;
+    quality: number;
+}
+export declare function parseAcceptLanguage(value: string): AcceptLanguage[];

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

@@ -0,0 +1,25 @@
+export interface Asset {
+    /**
+     * The path to the asset's src file, relative to the project root.
+     */
+    src: string;
+    /**
+     * The serving URL for the asset.
+     */
+    assetUrl: string;
+    /**
+     * Recursively walks all deps and returns a list of CSS asset URLs.
+     */
+    getCssDeps(): Promise<string[]>;
+    /**
+     * Recursively walks all deps and returns a list of JS asset URLs.
+     */
+    getJsDeps(): 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>;
+}