@pyreon/zero 0.11.8 → 0.11.10

package/lib/types/meta.d.ts

@@ -0,0 +1,91 @@
+import type { VNodeChild } from '@pyreon/core';
+import type { I18nRoutingConfig } from './i18n-routing';
+export interface MetaProps {
+    /** Page title. Accepts reactive accessor `() => string`. */
+    title?: string | (() => string);
+    /** Page description. Accepts reactive accessor. */
+    description?: string | (() => string);
+    /** Canonical URL. Also sets og:url. */
+    canonical?: string;
+    /** Open Graph image URL. Also sets twitter:image. */
+    image?: string;
+    /** Image alt text for accessibility. */
+    imageAlt?: string;
+    /** Open Graph type. Default: "website" */
+    type?: 'website' | 'article' | 'product' | 'profile';
+    /** Site name for og:site_name. */
+    siteName?: string;
+    /** Twitter card type. Default: "summary_large_image" */
+    twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
+    /** Twitter @handle. */
+    twitterSite?: string;
+    /** Twitter creator @handle. */
+    twitterCreator?: string;
+    /** Locale. Default: "en_US" */
+    locale?: string;
+    /** Alternate locales for hreflang. */
+    alternateLocales?: Array<{
+        locale: string;
+        url: string;
+    }>;
+    /** Robots directives. Default: "index, follow" */
+    robots?: string;
+    /** Published time (ISO 8601) for article type. */
+    publishedTime?: string;
+    /** Modified time (ISO 8601) for article type. */
+    modifiedTime?: string;
+    /** Article author. */
+    author?: string;
+    /** Article tags. */
+    tags?: string[];
+    /** JSON-LD structured data object. */
+    jsonLd?: Record<string, unknown>;
+    /** Additional custom meta tags. */
+    extra?: Array<{
+        name?: string;
+        property?: string;
+        content: string;
+    }>;
+    /**
+     * I18n routing config — when provided, auto-generates hreflang alternate
+     * links for all locales based on the current path.
+     * Also sets og:locale and og:locale:alternate.
+     */
+    i18n?: I18nRoutingConfig;
+    /** Base URL for building absolute hreflang URLs. e.g. "https://example.com" */
+    origin?: string;
+    children?: VNodeChild;
+}
+/**
+ * Declarative meta component for SSR-compatible page metadata.
+ *
+ * Supports reactive title/description — when passed as `() => string` accessors,
+ * they are forwarded to `useHead()` as a reactive getter so updates propagate
+ * automatically via signal tracking.
+ *
+ * @example
+ * ```tsx
+ * <Meta title="My Page" description="..." image="/og.jpg" canonical="https://..." />
+ * ```
+ *
+ * @example Reactive title
+ * ```tsx
+ * const count = signal(0)
+ * <Meta title={() => `${count()} items`} />
+ * ```
+ */
+export declare function Meta(props: MetaProps): VNodeChild;
+interface MetaTags {
+    meta: Array<Record<string, string>>;
+    link: Array<Record<string, string>>;
+    script: Array<{
+        type: string;
+        children: string;
+    }>;
+}
+export declare function buildMetaTags(props: Omit<MetaProps, 'title' | 'description' | 'children'> & {
+    title?: string;
+    description?: string;
+}): MetaTags;
+export {};
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/meta.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAKvD,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC/B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IACrC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACpD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,GAAG,KAAK,GAAG,QAAQ,CAAA;IAClE,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzD,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpE;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAKD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAqBjD;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC,GAAG;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GACA,QAAQ,CAiGV"}

package/lib/types/middleware.d.ts

@@ -0,0 +1,35 @@
+import type { Middleware, MiddlewareContext } from '@pyreon/server';
+/**
+ * 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(),
+ * )
+ */
+export 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)
+ * }
+ */
+export declare function getContext(ctx: MiddlewareContext): Record<string, unknown>;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AASnE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAOhE;AAUD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1E"}

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

@@ -0,0 +1,7 @@
+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

@@ -0,0 +1 @@
+{"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/rate-limit.d.ts

@@ -0,0 +1,34 @@
+import type { Middleware, MiddlewareContext } from '@pyreon/server';
+export interface RateLimitConfig {
+    /** Maximum requests per window. Default: `100` */
+    max?: number;
+    /** Time window in seconds. Default: `60` */
+    window?: number;
+    /** Function to extract the client identifier. Default: IP from headers. */
+    keyFn?: (ctx: MiddlewareContext) => string;
+    /** Custom response when rate limited. */
+    onLimit?: (ctx: MiddlewareContext) => Response;
+    /** URL patterns to rate limit (glob-style). Default: all paths. */
+    include?: string[];
+    /** URL patterns to exclude from rate limiting. */
+    exclude?: string[];
+}
+/**
+ * Rate limiting middleware — limits requests per client within a time window.
+ * Uses an in-memory store (suitable for single-instance deployments).
+ *
+ * @example
+ * import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
+ *
+ * // 100 requests per minute (default)
+ * rateLimitMiddleware()
+ *
+ * // Strict API rate limiting
+ * rateLimitMiddleware({
+ *   max: 20,
+ *   window: 60,
+ *   include: ["/api/*"],
+ * })
+ */
+export declare function rateLimitMiddleware(config?: RateLimitConfig): Middleware;
+//# sourceMappingURL=rate-limit.d.ts.map

package/lib/types/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAInE,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,MAAM,CAAA;IAC1C,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,QAAQ,CAAA;IAC9C,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,eAAoB,GAAG,UAAU,CAgE5E"}

package/lib/types/script.d.ts

@@ -0,0 +1,35 @@
+import type { VNodeChild } from '@pyreon/core';
+export interface ScriptProps {
+    /** Script source URL. */
+    src: string;
+    /** Loading strategy. Default: "afterHydration" */
+    strategy?: ScriptStrategy;
+    /** Inline script content (alternative to src). */
+    children?: string;
+    /** Script id for deduplication. */
+    id?: string;
+    /** Async attribute. Default: true */
+    async?: boolean;
+    /** onLoad callback. */
+    onLoad?: () => void;
+    /** onError callback. */
+    onError?: (error: Error) => void;
+}
+export type ScriptStrategy = 'beforeHydration' | 'afterHydration' | 'onIdle' | 'onInteraction' | 'onViewport';
+/**
+ * Optimized script loading component.
+ *
+ * @example
+ * // Load analytics after page is interactive
+ * <Script src="https://analytics.example.com/script.js" strategy="onIdle" />
+ *
+ * // Load chat widget when user scrolls
+ * <Script src="/chat-widget.js" strategy="onViewport" />
+ *
+ * // Inline script with deferred execution
+ * <Script strategy="afterHydration">
+ *   {`console.log("App hydrated!")`}
+ * </Script>
+ */
+export declare function Script(props: ScriptProps): VNodeChild;
+//# sourceMappingURL=script.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/script.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAa9C,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,kDAAkD;IAClD,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,QAAQ,GACR,eAAe,GACf,YAAY,CAAA;AAEhB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAgFrD"}

package/lib/types/seo.d.ts

@@ -0,0 +1,88 @@
+import type { Middleware } from '@pyreon/server';
+import type { Plugin } from 'vite';
+export interface SitemapConfig {
+    /** Base URL of the site (required). e.g. "https://example.com" */
+    origin: string;
+    /** Paths to exclude from the sitemap. */
+    exclude?: string[];
+    /** Default change frequency. Default: "weekly" */
+    changefreq?: ChangeFreq;
+    /** Default priority. Default: 0.7 */
+    priority?: number;
+    /** Additional URLs to include (for dynamic routes). */
+    additionalPaths?: SitemapEntry[];
+}
+export interface SitemapEntry {
+    path: string;
+    changefreq?: ChangeFreq;
+    priority?: number;
+    lastmod?: string;
+}
+export type ChangeFreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+/**
+ * Generate a sitemap.xml string from route file paths.
+ */
+export declare function generateSitemap(routeFiles: string[], config: SitemapConfig): string;
+export interface RobotsConfig {
+    /** Rules per user-agent. */
+    rules?: RobotsRule[];
+    /** Sitemap URL. */
+    sitemap?: string;
+    /** Host directive. */
+    host?: string;
+}
+export interface RobotsRule {
+    userAgent: string;
+    allow?: string[];
+    disallow?: string[];
+    crawlDelay?: number;
+}
+/**
+ * Generate a robots.txt string.
+ */
+export declare function generateRobots(config?: RobotsConfig): string;
+export type JsonLdType = 'WebSite' | 'WebPage' | 'Article' | 'BlogPosting' | 'Product' | 'Organization' | 'Person' | 'BreadcrumbList' | 'FAQPage' | (string & {});
+/**
+ * Generate a JSON-LD script tag string for structured data.
+ *
+ * @example
+ * useHead({
+ *   script: [jsonLd({
+ *     "@type": "WebSite",
+ *     name: "My Site",
+ *     url: "https://example.com",
+ *   })],
+ * })
+ */
+export declare function jsonLd(data: Record<string, unknown>): string;
+export interface SeoPluginConfig {
+    /** Sitemap configuration. */
+    sitemap?: SitemapConfig;
+    /** Robots.txt configuration. */
+    robots?: RobotsConfig;
+}
+/**
+ * Zero SEO Vite plugin.
+ * Generates sitemap.xml and robots.txt at build time.
+ *
+ * @example
+ * import { seoPlugin } from "@pyreon/zero/seo"
+ *
+ * export default {
+ *   plugins: [
+ *     pyreon(),
+ *     zero(),
+ *     seoPlugin({
+ *       sitemap: { origin: "https://example.com" },
+ *       robots: { sitemap: "https://example.com/sitemap.xml" },
+ *     }),
+ *   ],
+ * }
+ */
+export declare function seoPlugin(config?: SeoPluginConfig): Plugin;
+/**
+ * SEO middleware for dev server.
+ * Serves sitemap.xml and robots.txt dynamically during development.
+ */
+export declare function seoMiddleware(config?: SeoPluginConfig): Middleware;
+//# sourceMappingURL=seo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAUlC,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,eAAe,CAAC,EAAE,YAAY,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAElG;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAmDnF;AAaD,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CAoBhE;AAID,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,SAAS,GACT,aAAa,GACb,SAAS,GACT,cAAc,GACd,QAAQ,GACR,gBAAgB,GAChB,SAAS,GACT,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAM5D;AAID,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,gCAAgC;IAChC,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,eAAoB,GAAG,MAAM,CAqC9D;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,eAAoB,GAAG,UAAU,CAuBtE"}

package/lib/types/testing.d.ts

@@ -0,0 +1,85 @@
+import type { Middleware, MiddlewareContext } from '@pyreon/server';
+import type { ApiHandler, ApiRouteEntry } from './api-routes';
+/**
+ * Create a mock MiddlewareContext for testing middleware.
+ *
+ * @example
+ * import { createTestContext } from "@pyreon/zero/testing"
+ *
+ * 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;
+}): MiddlewareContext;
+/**
+ * Test a middleware by running it with a mock context and returning
+ * the result along with the response headers it set.
+ *
+ * @example
+ * import { testMiddleware } from "@pyreon/zero/testing"
+ *
+ * const { response, headers } = await testMiddleware(
+ *   corsMiddleware({ origin: "*" }),
+ *   "/api/posts"
+ * )
+ * 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;
+}): Promise<{
+    response: Response | undefined;
+    headers: Headers;
+}>;
+/**
+ * Create a test server for API routes. Returns a function that
+ * accepts Request objects and dispatches to the correct handler.
+ *
+ * @example
+ * import { createTestApiServer } from "@pyreon/zero/testing"
+ *
+ * const server = createTestApiServer([
+ *   { pattern: "/api/posts", module: postsApi },
+ *   { pattern: "/api/posts/:id", module: postByIdApi },
+ * ])
+ *
+ * const response = await server.request("/api/posts")
+ * expect(response.status).toBe(200)
+ *
+ * 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>;
+};
+/**
+ * Create a mock API handler for testing.
+ * Records all calls and returns a configurable response.
+ *
+ * @example
+ * import { createMockHandler } from "@pyreon/zero/testing"
+ *
+ * const handler = createMockHandler({ status: 200, body: { ok: true } })
+ * // ... use handler in your API route module
+ * 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>;
+}): ApiHandler & {
+    calls: Array<{
+        path: string;
+        params: Record<string, string>;
+    }>;
+};
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +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"}

package/lib/types/theme.d.ts

@@ -0,0 +1,39 @@
+import type { VNodeChild } from '@pyreon/core';
+export type Theme = 'light' | 'dark' | 'system';
+/** Reactive theme signal. */
+export declare const theme: import("@pyreon/reactivity").Signal<Theme>;
+/** Computed resolved theme (what's actually applied). */
+export declare function resolvedTheme(): 'light' | 'dark';
+/** Toggle between light and dark. */
+export declare function toggleTheme(): void;
+/** Set theme explicitly. */
+export 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;
+/**
+ * Theme toggle button component.
+ *
+ * @example
+ * import { ThemeToggle } from "@pyreon/zero/theme"
+ * <ThemeToggle />
+ */
+export declare function ThemeToggle(props: {
+    class?: string;
+    style?: string;
+}): VNodeChild;
+/**
+ * Inline script to prevent flash of wrong theme.
+ * Include this in your index.html <head> BEFORE any stylesheets.
+ *
+ * @example
+ * // index.html
+ * <head>
+ *   <script>{themeScript}</script>
+ *   ...
+ * </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

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

@@ -0,0 +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"}

package/lib/types/types.d.ts

@@ -0,0 +1,111 @@
+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';
+    /** 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1 @@
+{"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"}