@pyreon/zero 0.12.2 → 0.12.4

package/lib/types/entry-server.d.ts

@@ -1,37 +0,0 @@
-import type { ComponentFn } from "@pyreon/core";
-import type { RouteRecord } from "@pyreon/router";
-import type { Middleware } from "@pyreon/server";
-import type { ApiRouteEntry } from "./api-routes";
-import type { RouteMiddlewareEntry, ZeroConfig } from "./types";
-export 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;
-}
-/** Simple URL pattern matcher supporting :param and :param* segments. */
-export declare function matchPattern(pattern: string, path: string): boolean;
-/**
- * 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 })
- */
-export declare function createServer(options: CreateServerOptions): (req: Request) => Promise<Response>;
-//# sourceMappingURL=entry-server.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"entry-server.d.ts","sourceRoot":"","sources":["../../src/entry-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIhE,MAAM,WAAW,mBAAmB;IACnC,yBAAyB;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mBAAmB;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,sDAAsD;IACtD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,WAAW,CAAC;CAChC;AAuBD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAanE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,uCAwDxD"}

package/lib/types/error-overlay.d.ts

@@ -1,6 +0,0 @@
-/**
- * Dev-only error overlay for SSR/loader errors.
- * Renders a styled HTML page with the error stack trace.
- */
-export declare function renderErrorOverlay(error: Error): string;
-//# sourceMappingURL=error-overlay.d.ts.map

package/lib/types/error-overlay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-overlay.d.ts","sourceRoot":"","sources":["../../src/error-overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CA0FvD"}

package/lib/types/fs-router.d.ts

@@ -1,47 +0,0 @@
-import type { FileRoute, RenderMode } from './types';
-/**
- * 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
- */
-export 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)
- */
-export 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.
- */
-export 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;
-}
-export 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.
- */
-export declare function generateMiddlewareModule(files: string[], routesDir: string): string;
-/**
- * Scan a directory for route files.
- * Returns paths relative to the routes directory.
- */
-export declare function scanRouteFiles(routesDir: string): Promise<string[]>;
-//# sourceMappingURL=fs-router.d.ts.map

package/lib/types/fs-router.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs-router.d.ts","sourceRoot":"","sources":["../../src/fs-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAgCpD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,GAAE,UAAkB,GAAG,SAAS,EAAE,CAK7F;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiC1D;AA6ED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CA0JR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAqBnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBzE"}

package/lib/types/isr.d.ts

@@ -1,9 +0,0 @@
-import type { ISRConfig } from './types';
-/**
- * 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.
- */
-export declare function createISRHandler(handler: (req: Request) => Promise<Response>, config: ISRConfig): (req: Request) => Promise<Response>;
-//# sourceMappingURL=isr.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"isr.d.ts","sourceRoot":"","sources":["../../src/isr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAUxC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAC5C,MAAM,EAAE,SAAS,GAChB,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA2ErC"}

package/lib/types/not-found.d.ts

@@ -1,7 +0,0 @@
-import type { ComponentFn } from "@pyreon/core";
-/**
- * Render a 404 component to a full HTML string.
- * If no component is provided, returns a default 404 page.
- */
-export declare function render404Page(component: ComponentFn | undefined, template?: string): Promise<string>;
-//# sourceMappingURL=not-found.d.ts.map

package/lib/types/not-found.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"not-found.d.ts","sourceRoot":"","sources":["../../src/not-found.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAahD;;;GAGG;AACH,wBAAsB,aAAa,CAClC,SAAS,EAAE,WAAW,GAAG,SAAS,EAClC,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/lib/types/types.d.ts

@@ -1,111 +0,0 @@
-import type { ComponentFn } from '@pyreon/core';
-import type { NavigationGuard } from '@pyreon/router';
-import type { Middleware } from '@pyreon/server';
-/** What a route file (e.g. `src/routes/index.tsx`) can export. */
-export interface RouteModule {
-    /** Default export is the page component. */
-    default?: ComponentFn;
-    /** Layout wrapper — wraps this route and all children. */
-    layout?: ComponentFn;
-    /** Loading component shown while lazy-loading or during Suspense. */
-    loading?: ComponentFn;
-    /** Error component shown when the route errors. */
-    error?: ComponentFn;
-    /** Server-side data loader. */
-    loader?: (ctx: LoaderContext) => Promise<unknown>;
-    /** Per-route middleware. */
-    middleware?: Middleware | Middleware[];
-    /** Navigation guard — can redirect or block navigation. */
-    guard?: NavigationGuard;
-    /** Route metadata. */
-    meta?: RouteMeta;
-    /** Rendering mode override for this route. */
-    renderMode?: RenderMode;
-}
-/** Context passed to route loaders. */
-export interface LoaderContext {
-    params: Record<string, string>;
-    query: Record<string, string>;
-    signal: AbortSignal;
-    request: Request;
-}
-/** Per-route metadata. */
-export interface RouteMeta {
-    title?: string;
-    description?: string;
-    [key: string]: unknown;
-}
-export type RenderMode = 'ssr' | 'ssg' | 'spa' | 'isr';
-export interface ISRConfig {
-    /** Revalidation interval in seconds. */
-    revalidate: number;
-}
-export 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. */
-export 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. */
-export interface RouteMiddlewareEntry {
-    pattern: string;
-    middleware: Middleware | Middleware[];
-}
-export interface Adapter {
-    name: string;
-    /** Build the production server/output for this adapter. */
-    build(options: AdapterBuildOptions): Promise<void>;
-}
-export 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;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/types/utils/use-intersection-observer.d.ts

@@ -1,10 +0,0 @@
-/**
- * Observes an element and calls `onIntersect` once it enters the viewport.
- * Automatically disconnects after the first intersection.
- *
- * @param getElement - Getter for the target element (may be undefined before mount).
- * @param onIntersect - Callback fired when the element becomes visible.
- * @param rootMargin - IntersectionObserver rootMargin. Default: "200px".
- */
-export declare function useIntersectionObserver(getElement: () => HTMLElement | undefined, onIntersect: () => void, rootMargin?: string): void;
-//# sourceMappingURL=use-intersection-observer.d.ts.map

package/lib/types/utils/use-intersection-observer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-intersection-observer.d.ts","sourceRoot":"","sources":["../../../src/utils/use-intersection-observer.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,WAAW,GAAG,SAAS,EACzC,WAAW,EAAE,MAAM,IAAI,EACvB,UAAU,SAAU,QAsBrB"}

package/lib/types/utils/with-headers.d.ts

@@ -1,6 +0,0 @@
-/**
- * Clone a Response with modified headers.
- * Avoids repeating the `new Response(body, { status, statusText, headers })` pattern.
- */
-export declare function withHeaders(response: Response, modify: (headers: Headers) => void): Response;
-//# sourceMappingURL=with-headers.d.ts.map

package/lib/types/utils/with-headers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"with-headers.d.ts","sourceRoot":"","sources":["../../../src/utils/with-headers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,QAAQ,CAQ5F"}

package/lib/types/vite-plugin.d.ts

@@ -1,17 +0,0 @@
-import type { Plugin } from 'vite';
-import type { ZeroConfig } from "./types";
-/**
- * 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()],
- * }
- */
-export declare function zeroPlugin(userConfig?: ZeroConfig): Plugin;
-//# sourceMappingURL=vite-plugin.d.ts.map

package/lib/types/vite-plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../../src/vite-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA4BlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,UAAU,GAAE,UAAe,GAAG,MAAM,CAuK9D"}