@pyreon/zero 0.12.2 → 0.12.4

package/lib/types/server.d.ts

@@ -0,0 +1,455 @@
+import * as _pyreon_core0 from "@pyreon/core";
+import { ComponentFn } from "@pyreon/core";
+import * as _pyreon_router0 from "@pyreon/router";
+import { RouteRecord } from "@pyreon/router";
+import { Middleware, MiddlewareContext } from "@pyreon/server";
+import { Plugin } from "vite";
+//#region src/app.d.ts
+interface CreateAppOptions {
+  /** Route definitions (from file-based routing or manual). */
+  routes: RouteRecord[];
+  /** Router mode. Default: "history" for SSR, "hash" for SPA. */
+  routerMode?: 'hash' | 'history';
+  /** Initial URL for SSR. */
+  url?: string;
+  /** Root layout component wrapping all routes. */
+  layout?: ComponentFn;
+  /** Global error component. */
+  errorComponent?: ComponentFn;
+}
+/**
+ * Create a full Zero app — assembles router, head provider, and root layout.
+ *
+ * Used internally by entry-server and entry-client.
+ */
+declare function createApp(options: CreateAppOptions): {
+  App: () => _pyreon_core0.VNode;
+  router: _pyreon_router0.Router;
+};
+//#endregion
+//#region src/api-routes.d.ts
+/** Context passed to API route handlers. */
+interface ApiContext {
+  /** The incoming request. */
+  request: Request;
+  /** Parsed URL. */
+  url: URL;
+  /** URL path. */
+  path: string;
+  /** Dynamic route parameters (e.g., { id: "123" }). */
+  params: Record<string, string>;
+  /** Request headers. */
+  headers: Headers;
+}
+/** An API route handler function. */
+type ApiHandler = (ctx: ApiContext) => Response | Promise<Response>;
+/** An API route module — exports named HTTP method handlers. */
+interface ApiRouteModule {
+  GET?: ApiHandler;
+  POST?: ApiHandler;
+  PUT?: ApiHandler;
+  PATCH?: ApiHandler;
+  DELETE?: ApiHandler;
+  HEAD?: ApiHandler;
+  OPTIONS?: ApiHandler;
+}
+/** A registered API route entry. */
+interface ApiRouteEntry {
+  /** URL pattern (e.g., "/api/posts/:id"). */
+  pattern: string;
+  /** The route module with method handlers. */
+  module: ApiRouteModule;
+}
+//#endregion
+//#region src/types.d.ts
+type RenderMode = 'ssr' | 'ssg' | 'spa' | 'isr';
+interface ISRConfig {
+  /** Revalidation interval in seconds. */
+  revalidate: number;
+}
+interface ZeroConfig {
+  /** Default rendering mode. Default: "ssr" */
+  mode?: RenderMode;
+  /** Vite config overrides. */
+  vite?: Record<string, unknown>;
+  /** SSR options. */
+  ssr?: {
+    /** Streaming mode. Default: "string" */mode?: 'string' | 'stream';
+  };
+  /** SSG options — only used when mode is "ssg". */
+  ssg?: {
+    /** Paths to prerender (or function returning paths). */paths?: string[] | (() => string[] | Promise<string[]>);
+  };
+  /** ISR config — only used when mode is "isr". */
+  isr?: ISRConfig;
+  /** Deploy adapter. Default: "node" */
+  adapter?: 'node' | 'bun' | 'static' | 'vercel' | 'cloudflare' | 'netlify';
+  /** Base URL path. Default: "/" */
+  base?: string;
+  /** App-level middleware applied to all routes. */
+  middleware?: Middleware[];
+  /** Server port for dev/preview. Default: 3000 */
+  port?: number;
+}
+/** Internal representation of a file-system route before conversion to RouteRecord. */
+interface FileRoute {
+  /** File path relative to routes dir (e.g. "users/[id].tsx") */
+  filePath: string;
+  /** Parsed URL path pattern (e.g. "/users/:id") */
+  urlPath: string;
+  /** Directory path for grouping (e.g. "users" or "" for root) */
+  dirPath: string;
+  /** Route segment depth for nesting. */
+  depth: number;
+  /** Whether this is a layout file. */
+  isLayout: boolean;
+  /** Whether this is an error boundary file. */
+  isError: boolean;
+  /** Whether this is a loading fallback file. */
+  isLoading: boolean;
+  /** Whether this is a not-found (404) file. */
+  isNotFound: boolean;
+  /** Whether this is a catch-all route. */
+  isCatchAll: boolean;
+  /** Resolved rendering mode. */
+  renderMode: RenderMode;
+}
+/** Entry mapping a URL pattern to its route-level middleware. */
+interface RouteMiddlewareEntry {
+  pattern: string;
+  middleware: Middleware | Middleware[];
+}
+interface Adapter {
+  name: string;
+  /** Build the production server/output for this adapter. */
+  build(options: AdapterBuildOptions): Promise<void>;
+}
+interface AdapterBuildOptions {
+  /** Path to the built server entry. */
+  serverEntry: string;
+  /** Path to the client build output. */
+  clientOutDir: string;
+  /** Final output directory. */
+  outDir: string;
+  config: ZeroConfig;
+}
+//#endregion
+//#region src/entry-server.d.ts
+interface CreateServerOptions {
+  /** Route definitions. */
+  routes: RouteRecord[];
+  /** Zero config. */
+  config?: ZeroConfig;
+  /** Additional middleware. */
+  middleware?: Middleware[];
+  /** Per-route middleware from virtual:zero/route-middleware. */
+  routeMiddleware?: RouteMiddlewareEntry[];
+  /** API route entries from virtual:zero/api-routes. */
+  apiRoutes?: ApiRouteEntry[];
+  /** HTML template override. */
+  template?: string;
+  /** Client entry path. */
+  clientEntry?: string;
+  /** Component to render when no route matches (from _404.tsx). */
+  notFoundComponent?: ComponentFn;
+}
+/**
+ * Create the SSR request handler for production.
+ *
+ * @example
+ * import { routes } from "virtual:zero/routes"
+ * import { routeMiddleware } from "virtual:zero/route-middleware"
+ * import { createServer } from "@pyreon/zero"
+ *
+ * export default createServer({ routes, routeMiddleware, apiRoutes })
+ */
+declare function createServer(options: CreateServerOptions): (req: Request) => Promise<Response>;
+//#endregion
+//#region src/config.d.ts
+/**
+ * Define a Zero configuration.
+ * Used in `zero.config.ts` at the project root.
+ *
+ * @example
+ * import { defineConfig } from "@pyreon/zero/config"
+ *
+ * export default defineConfig({
+ *   mode: "ssr",
+ *   ssr: { mode: "stream" },
+ *   port: 3000,
+ * })
+ */
+declare function defineConfig(config: ZeroConfig): ZeroConfig;
+/** Merge user config with defaults. */
+declare function resolveConfig(userConfig?: ZeroConfig): Required<Pick<ZeroConfig, 'mode' | 'base' | 'port' | 'adapter'>> & ZeroConfig;
+//#endregion
+//#region src/fs-router.d.ts
+/**
+ * Parse a set of file paths (relative to routes dir) into FileRoute objects.
+ *
+ * @param files Array of file paths like ["index.tsx", "users/[id].tsx"]
+ * @param defaultMode Default rendering mode from config
+ */
+declare function parseFileRoutes(files: string[], defaultMode?: RenderMode): FileRoute[];
+/**
+ * Convert a file path (without extension) to a URL path pattern.
+ *
+ * Examples:
+ *   "index"            → "/"
+ *   "about"            → "/about"
+ *   "users/index"      → "/users"
+ *   "users/[id]"       → "/users/:id"
+ *   "blog/[...slug]"   → "/blog/:slug*"
+ *   "(auth)/login"     → "/login"         (group stripped)
+ *   "_layout"          → "/"              (layout marker)
+ */
+declare function filePathToUrlPath(filePath: string): string;
+/**
+ * Generate a virtual module that exports a nested route tree.
+ * Wires up layouts as parent routes with children, loaders, guards,
+ * error/loading components, middleware, and meta from route module exports.
+ */
+interface GenerateRouteModuleOptions {
+  /**
+   * When true, skip lazy() for route components and use static imports.
+   * Use for SSG/prerender mode where all routes are rendered at build time
+   * and code splitting provides no benefit. Avoids Rolldown warnings about
+   * static + dynamic imports of the same module.
+   */
+  staticImports?: boolean;
+}
+declare function generateRouteModule(files: string[], routesDir: string, options?: GenerateRouteModuleOptions): string;
+/**
+ * Generate a virtual module that maps URL patterns to their middleware exports.
+ * Used by the server entry to dispatch per-route middleware.
+ */
+declare function generateMiddlewareModule(files: string[], routesDir: string): string;
+/**
+ * Scan a directory for route files.
+ * Returns paths relative to the routes directory.
+ */
+declare function scanRouteFiles(routesDir: string): Promise<string[]>;
+//#endregion
+//#region src/isr.d.ts
+/**
+ * In-memory ISR cache with stale-while-revalidate semantics.
+ *
+ * Wraps an SSR handler and caches responses per URL path.
+ * Serves stale content immediately while revalidating in the background.
+ */
+declare function createISRHandler(handler: (req: Request) => Promise<Response>, config: ISRConfig): (req: Request) => Promise<Response>;
+//#endregion
+//#region src/adapters/bun.d.ts
+/**
+ * Bun adapter — generates a standalone Bun.serve() entry.
+ */
+declare function bunAdapter(): Adapter;
+//#endregion
+//#region src/adapters/cloudflare.d.ts
+/**
+ * Cloudflare Pages adapter — generates output for Cloudflare Pages with Functions.
+ *
+ * Produces:
+ * - Client assets in the output directory root (served as static)
+ * - `_worker.js` — Cloudflare Pages Function for SSR
+ *
+ * Note: Cloudflare Pages Functions have a ~1MB module size limit.
+ * For large apps, configure Vite's SSR build to bundle server code:
+ * `ssr: { noExternal: true }` in vite.config.ts.
+ *
+ * Deploy with: `npx wrangler pages deploy ./dist`
+ *
+ * @example
+ * ```ts
+ * // zero.config.ts
+ * import { defineConfig } from "@pyreon/zero"
+ *
+ * export default defineConfig({
+ *   adapter: "cloudflare",
+ * })
+ * ```
+ */
+declare function cloudflareAdapter(): Adapter;
+//#endregion
+//#region src/adapters/netlify.d.ts
+/**
+ * Netlify adapter — generates output for Netlify Functions (v2).
+ *
+ * Produces:
+ * - Client assets in `publish/` directory
+ * - `netlify/functions/ssr.mjs` — Netlify Function for SSR
+ * - `netlify.toml` — routing configuration
+ *
+ * @example
+ * ```ts
+ * // zero.config.ts
+ * import { defineConfig } from "@pyreon/zero"
+ *
+ * export default defineConfig({
+ *   adapter: "netlify",
+ * })
+ * ```
+ */
+declare function netlifyAdapter(): Adapter;
+//#endregion
+//#region src/adapters/node.d.ts
+/**
+ * Node.js adapter — generates a standalone server entry using node:http.
+ */
+declare function nodeAdapter(): Adapter;
+//#endregion
+//#region src/adapters/static.d.ts
+/**
+ * Static adapter — just copies the client build output.
+ * Used with SSG mode where all pages are pre-rendered at build time.
+ */
+declare function staticAdapter(): Adapter;
+//#endregion
+//#region src/adapters/vercel.d.ts
+/**
+ * Vercel adapter — generates output for Vercel's Build Output API v3.
+ *
+ * Produces a `.vercel/output` directory with:
+ * - `static/` — client-side assets (JS, CSS, images)
+ * - `functions/ssr.func/` — serverless function for SSR
+ * - `config.json` — routing configuration
+ *
+ * @example
+ * ```ts
+ * // zero.config.ts
+ * import { defineConfig } from "@pyreon/zero"
+ *
+ * export default defineConfig({
+ *   adapter: "vercel",
+ * })
+ * ```
+ */
+declare function vercelAdapter(): Adapter;
+//#endregion
+//#region src/adapters/index.d.ts
+/**
+ * Resolve the adapter from config.
+ * Returns a built-in adapter or throws if unknown.
+ */
+declare function resolveAdapter(config: ZeroConfig): Adapter;
+//#endregion
+//#region src/not-found.d.ts
+/**
+ * Render a 404 component to a full HTML string.
+ * If no component is provided, returns a default 404 page.
+ */
+declare function render404Page(component: ComponentFn | undefined, template?: string): Promise<string>;
+//#endregion
+//#region src/middleware.d.ts
+/**
+ * Compose multiple middleware into a single middleware function.
+ * Middleware runs sequentially — if any returns a Response, the chain stops.
+ *
+ * @example
+ * import { compose } from "@pyreon/zero/middleware"
+ * import { corsMiddleware } from "@pyreon/zero/cors"
+ * import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
+ *
+ * const combined = compose(
+ *   corsMiddleware({ origin: "*" }),
+ *   rateLimitMiddleware({ max: 100 }),
+ *   cacheMiddleware(),
+ * )
+ */
+declare function compose(...middlewares: Middleware[]): Middleware;
+/**
+ * Get the shared Zero context from a middleware context.
+ * Creates one if it doesn't exist. Middleware can use this to
+ * pass data to downstream middleware without polluting `ctx.locals`.
+ *
+ * @example
+ * const authMiddleware: Middleware = (ctx) => {
+ *   const zctx = getContext(ctx)
+ *   zctx.userId = "user_123"
+ * }
+ *
+ * const loggingMiddleware: Middleware = (ctx) => {
+ *   const zctx = getContext(ctx)
+ *   console.log("User:", zctx.userId)
+ * }
+ */
+declare function getContext(ctx: MiddlewareContext): Record<string, unknown>;
+//#endregion
+//#region src/vite-plugin.d.ts
+/**
+ * Zero Vite plugin — adds file-based routing and zero-config conventions
+ * on top of @pyreon/vite-plugin.
+ *
+ * @example
+ * // vite.config.ts
+ * import pyreon from "@pyreon/vite-plugin"
+ * import zero from "@pyreon/zero"
+ *
+ * export default {
+ *   plugins: [pyreon(), zero()],
+ * }
+ */
+declare function zeroPlugin(userConfig?: ZeroConfig): Plugin;
+//#endregion
+//#region src/i18n-routing.d.ts
+interface I18nRoutingConfig {
+  /** Supported locales. e.g. ["en", "de", "cs"] */
+  locales: string[];
+  /** Default locale — served without prefix (/ instead of /en/). */
+  defaultLocale: string;
+  /** Redirect root to detected locale. Default: true */
+  detectLocale?: boolean;
+  /** Cookie name to persist locale preference. Default: "locale" */
+  cookieName?: string;
+  /** URL strategy. Default: "prefix-except-default" */
+  strategy?: 'prefix' | 'prefix-except-default';
+}
+interface LocaleContext {
+  /** Current locale code. e.g. "en", "de" */
+  locale: string;
+  /** All supported locales. */
+  locales: string[];
+  /** Default locale. */
+  defaultLocale: string;
+  /** Build a localized path. e.g. localePath("/about", "de") → "/de/about" */
+  localePath: (path: string, locale?: string) => string;
+  /** Get hreflang alternates for the current path. */
+  alternates: () => Array<{
+    locale: string;
+    url: string;
+  }>;
+}
+/**
+ * Detect preferred locale from Accept-Language header.
+ */
+declare function detectLocaleFromHeader(acceptLanguage: string | null | undefined, locales: string[], defaultLocale: string): string;
+/**
+ * Create a LocaleContext for use in components and loaders.
+ */
+declare function createLocaleContext(locale: string, path: string, config: I18nRoutingConfig): LocaleContext;
+/**
+ * I18n routing middleware for Zero's server.
+ *
+ * - Detects locale from URL prefix or Accept-Language header
+ * - Redirects root to preferred locale (when detectLocale is true)
+ * - Sets locale context for loaders and components
+ *
+ * @example
+ * ```ts
+ * // zero.config.ts
+ * import { i18nRouting } from "@pyreon/zero"
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     i18nRouting({
+ *       locales: ["en", "de", "cs"],
+ *       defaultLocale: "en",
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare function i18nRouting(config: I18nRoutingConfig): Plugin;
+//#endregion
+export { type CreateAppOptions, type CreateServerOptions, type GenerateRouteModuleOptions, bunAdapter, cloudflareAdapter, compose, createApp, createISRHandler, createLocaleContext, createServer, zeroPlugin as default, defineConfig, detectLocaleFromHeader, filePathToUrlPath, generateMiddlewareModule, generateRouteModule, getContext, i18nRouting, netlifyAdapter, nodeAdapter, parseFileRoutes, render404Page, resolveAdapter, resolveConfig, scanRouteFiles, staticAdapter, vercelAdapter };
+//# sourceMappingURL=server2.d.ts.map

package/lib/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server2.d.ts","names":[],"sources":["../../../src/app.ts","../../../src/api-routes.ts","../../../src/types.ts","../../../src/entry-server.ts","../../../src/config.ts","../../../src/fs-router.ts","../../../src/isr.ts","../../../src/adapters/bun.ts","../../../src/adapters/cloudflare.ts","../../../src/adapters/netlify.ts","../../../src/adapters/node.ts","../../../src/adapters/static.ts","../../../src/adapters/vercel.ts","../../../src/adapters/index.ts","../../../src/not-found.ts","../../../src/middleware.ts","../../../src/vite-plugin.ts","../../../src/i18n-routing.ts"],"mappings":"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"}

package/lib/types/testing.d.ts

@@ -1,5 +1,40 @@
-import type { Middleware, MiddlewareContext } from '@pyreon/server';
-import type { ApiHandler, ApiRouteEntry } from './api-routes';
+import { Middleware, MiddlewareContext } from "@pyreon/server";
+
+//#region src/api-routes.d.ts
+/** Context passed to API route handlers. */
+interface ApiContext {
+  /** The incoming request. */
+  request: Request;
+  /** Parsed URL. */
+  url: URL;
+  /** URL path. */
+  path: string;
+  /** Dynamic route parameters (e.g., { id: "123" }). */
+  params: Record<string, string>;
+  /** Request headers. */
+  headers: Headers;
+}
+/** An API route handler function. */
+type ApiHandler = (ctx: ApiContext) => Response | Promise<Response>;
+/** An API route module — exports named HTTP method handlers. */
+interface ApiRouteModule {
+  GET?: ApiHandler;
+  POST?: ApiHandler;
+  PUT?: ApiHandler;
+  PATCH?: ApiHandler;
+  DELETE?: ApiHandler;
+  HEAD?: ApiHandler;
+  OPTIONS?: ApiHandler;
+}
+/** A registered API route entry. */
+interface ApiRouteEntry {
+  /** URL pattern (e.g., "/api/posts/:id"). */
+  pattern: string;
+  /** The route module with method handlers. */
+  module: ApiRouteModule;
+}
+//#endregion
+//#region src/testing.d.ts
 /**
  * Create a mock MiddlewareContext for testing middleware.
  *
@@ -9,10 +44,10 @@ import type { ApiHandler, ApiRouteEntry } from './api-routes';
  * const ctx = createTestContext("/api/posts", { method: "POST", body: { title: "Hello" } })
  * const result = await myMiddleware(ctx)
  */
-export declare function createTestContext(path: string, options?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
+declare function createTestContext(path: string, options?: {
+  method?: string;
+  headers?: Record<string, string>;
+  body?: unknown;
 }): MiddlewareContext;
 /**
  * Test a middleware by running it with a mock context and returning
@@ -27,13 +62,13 @@ export declare function createTestContext(path: string, options?: {
  * )
  * expect(headers.get("Access-Control-Allow-Origin")).toBe("*")
  */
-export declare function testMiddleware(middleware: Middleware, path: string, options?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
+declare function testMiddleware(middleware: Middleware, path: string, options?: {
+  method?: string;
+  headers?: Record<string, string>;
+  body?: unknown;
 }): Promise<{
-    response: Response | undefined;
-    headers: Headers;
+  response: Response | undefined;
+  headers: Headers;
 }>;
 /**
  * Create a test server for API routes. Returns a function that
@@ -53,12 +88,12 @@ export declare function testMiddleware(middleware: Middleware, path: string, opt
  * const data = await server.request("/api/posts", { method: "POST", body: { title: "Hi" } })
  * expect(data.status).toBe(201)
  */
-export declare function createTestApiServer(routes: ApiRouteEntry[]): {
-    request(path: string, options?: {
-        method?: string;
-        headers?: Record<string, string>;
-        body?: unknown;
-    }): Promise<Response>;
+declare function createTestApiServer(routes: ApiRouteEntry[]): {
+  request(path: string, options?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+  }): Promise<Response>;
 };
 /**
  * Create a mock API handler for testing.
@@ -72,14 +107,16 @@ export declare function createTestApiServer(routes: ApiRouteEntry[]): {
  * expect(handler.calls).toHaveLength(1)
  * expect(handler.calls[0].params).toEqual({ id: "123" })
  */
-export declare function createMockHandler(responseConfig?: {
-    status?: number;
-    body?: unknown;
-    headers?: Record<string, string>;
+declare function createMockHandler(responseConfig?: {
+  status?: number;
+  body?: unknown;
+  headers?: Record<string, string>;
 }): ApiHandler & {
-    calls: Array<{
-        path: string;
-        params: Record<string, string>;
-    }>;
+  calls: Array<{
+    path: string;
+    params: Record<string, string>;
+  }>;
 };
-//# sourceMappingURL=testing.d.ts.map
+//#endregion
+export { createMockHandler, createTestApiServer, createTestContext, testMiddleware };
+//# sourceMappingURL=testing2.d.ts.map

package/lib/types/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAK7D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;CACV,GACL,iBAAiB,CAyBnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;CACV,GACL,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAI/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE;kBAK/C,MAAM,YACH;QACP,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,GACA,OAAO,CAAC,QAAQ,CAAC;EASvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GACzF,UAAU,GAAG;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;CAC/D,CAaA"}
+{"version":3,"file":"testing2.d.ts","names":[],"sources":["../../../src/api-routes.ts","../../../src/testing.ts"],"mappings":";;;AAQA;AAAA,UAAiB,UAAA;;EAEf,OAAA,EAAS,OAAA;EAEJ;EAAL,GAAA,EAAK,GAAA;EAMI;EAJT,IAAA;EAIgB;EAFhB,MAAA,EAAQ,MAAA;EANC;EAQT,OAAA,EAAS,OAAA;AAAA;;KAIC,UAAA,IAAc,GAAA,EAAK,UAAA,KAAe,QAAA,GAAW,OAAA,CAAQ,QAAA;;UAGhD,cAAA;EACf,GAAA,GAAM,UAAA;EACN,IAAA,GAAO,UAAA;EACP,GAAA,GAAM,UAAA;EACN,KAAA,GAAQ,UAAA;EACR,MAAA,GAAS,UAAA;EACT,IAAA,GAAO,UAAA;EACP,OAAA,GAAU,UAAA;AAAA;;UAIK,aAAA;EAd+C;EAgB9D,OAAA;EAhB6B;EAkB7B,MAAA,EAAQ,cAAA;AAAA;;;;AAhCV;;;;;;;;iBCOgB,iBAAA,CACd,IAAA,UACA,OAAA;EACE,MAAA;EACA,OAAA,GAAU,MAAA;EACV,IAAA;AAAA,IAED,iBAAA;;;;;;;;ADAH;;;;;;iBCwCsB,cAAA,CACpB,UAAA,EAAY,UAAA,EACZ,IAAA,UACA,OAAA;EACE,MAAA;EACA,OAAA,GAAU,MAAA;EACV,IAAA;AAAA,IAED,OAAA;EAAU,QAAA,EAAU,QAAA;EAAsB,OAAA,EAAS,OAAA;AAAA;;;AD7CtD;;;;;;;;;;;;;;;;iBCqEgB,mBAAA,CAAoB,MAAA,EAAQ,aAAA;wBAK1B,OAAA;IAEV,MAAA;IACA,OAAA,GAAU,MAAA;IACV,IAAA;EAAA,IAED,OAAA,CAAQ,QAAA;AAAA;;;;;;ADrEf;;;;;;;iBC4FgB,iBAAA,CACd,cAAA;EAAkB,MAAA;EAAiB,IAAA;EAAgB,OAAA,GAAU,MAAA;AAAA,IAC5D,UAAA;EACD,KAAA,EAAO,KAAA;IAAQ,IAAA;IAAc,MAAA,EAAQ,MAAA;EAAA;AAAA"}

package/lib/types/theme.d.ts

@@ -1,18 +1,26 @@
-import type { VNodeChild } from '@pyreon/core';
-export type Theme = 'light' | 'dark' | 'system';
+import * as _pyreon_reactivity0 from "@pyreon/reactivity";
+import { VNodeChild } from "@pyreon/core";
+
+//#region src/theme.d.ts
+type Theme = 'light' | 'dark' | 'system';
 /** Reactive theme signal. */
-export declare const theme: import("@pyreon/reactivity").Signal<Theme>;
+declare const theme: _pyreon_reactivity0.Signal<Theme>;
+/**
+ * Set the default theme for SSR (when `matchMedia` is unavailable).
+ * Call once at server startup before rendering.
+ */
+declare function setSSRThemeDefault(value: 'light' | 'dark'): void;
 /** Computed resolved theme (what's actually applied). */
-export declare function resolvedTheme(): 'light' | 'dark';
+declare function resolvedTheme(): 'light' | 'dark';
 /** Toggle between light and dark. */
-export declare function toggleTheme(): void;
+declare function toggleTheme(): void;
 /** Set theme explicitly. */
-export declare function setTheme(t: Theme): void;
+declare function setTheme(t: Theme): void;
 /**
  * Initialize the theme system. Call once in your app entry or layout.
  * Reads from localStorage, listens for system preference changes.
  */
-export declare function initTheme(): void;
+declare function initTheme(): void;
 /**
  * Theme toggle button component.
  *
@@ -20,9 +28,9 @@ export declare function initTheme(): void;
  * import { ThemeToggle } from "@pyreon/zero/theme"
  * <ThemeToggle />
  */
-export declare function ThemeToggle(props: {
-    class?: string;
-    style?: string;
+declare function ThemeToggle(props: {
+  class?: string;
+  style?: string;
 }): VNodeChild;
 /**
  * Inline script to prevent flash of wrong theme.
@@ -35,5 +43,7 @@ export declare function ThemeToggle(props: {
  *   ...
  * </head>
  */
-export declare const themeScript = "(function(){try{var t=localStorage.getItem(\"zero-theme\");var r=t===\"light\"?\"light\":t===\"dark\"?\"dark\":window.matchMedia(\"(prefers-color-scheme:dark)\").matches?\"dark\":\"light\";document.documentElement.dataset.theme=r}catch(e){}})()";
-//# sourceMappingURL=theme.d.ts.map
+declare const themeScript = "(function(){try{var t=localStorage.getItem(\"zero-theme\");var r=t===\"light\"?\"light\":t===\"dark\"?\"dark\":window.matchMedia(\"(prefers-color-scheme:dark)\").matches?\"dark\":\"light\";document.documentElement.dataset.theme=r}catch(e){}})()";
+//#endregion
+export { Theme, ThemeToggle, initTheme, resolvedTheme, setSSRThemeDefault, setTheme, theme, themeScript, toggleTheme };
+//# sourceMappingURL=theme2.d.ts.map

package/lib/types/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/theme.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAY9C,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAI/C,6BAA6B;AAC7B,eAAO,MAAM,KAAK,4CAA0B,CAAA;AAE5C,yDAAyD;AACzD,wBAAgB,aAAa,IAAI,OAAO,GAAG,MAAM,CAOhD;AAED,qCAAqC;AACrC,wBAAgB,WAAW,SAG1B;AAED,4BAA4B;AAC5B,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,QAUhC;AAED;;;GAGG;AACH,wBAAgB,SAAS,SAiCxB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAqDjF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,yPAA6O,CAAA"}
+{"version":3,"file":"theme2.d.ts","names":[],"sources":["../../../src/theme.tsx"],"mappings":";;;;KAYY,KAAA;;cAKC,KAAA,EAAK,mBAAA,CAAA,MAAA,CAAA,KAAA;AALlB;;;;AAAA,iBAcgB,kBAAA,CAAmB,KAAA;AATnC;AAAA,iBAcgB,aAAA,CAAA;;iBAUA,WAAA,CAAA;;iBAMA,QAAA,CAAS,CAAA,EAAG,KAAA;;;;;iBAgBZ,SAAA,CAAA;;;;;AAtBhB;;;iBAgEgB,WAAA,CAAY,KAAA;EAAS,KAAA;EAAgB,KAAA;AAAA,IAAmB,UAAA;;;;AA1CxE;;;;;AA0CA;;;cAkEa,WAAA"}