alabjs 0.1.0

package/dist/ssr/router-dev.test.js

@@ -0,0 +1,189 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { scanDevRoutes, matchDevRoute, findLayoutFiles, findErrorFile, findLoadingFile, scanDevApiRoutes, matchDevApiRoute, } from "./router-dev.js";
+let appDir;
+beforeEach(() => {
+    appDir = mkdtempSync(join(tmpdir(), "alab-test-"));
+});
+afterEach(() => {
+    rmSync(appDir, { recursive: true, force: true });
+});
+function createFile(relPath, content = "export default function Page() { return null; }") {
+    const full = join(appDir, relPath);
+    mkdirSync(join(full, ".."), { recursive: true });
+    writeFileSync(full, content, "utf8");
+}
+// ─── scanDevRoutes ────────────────────────────────────────────────────────────
+describe("scanDevRoutes", () => {
+    it("finds page.tsx at root", () => {
+        createFile("page.tsx");
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(1);
+        expect(routes[0].pattern.test("/")).toBe(true);
+    });
+    it("finds nested page.tsx", () => {
+        createFile("about/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(1);
+        expect(routes[0].pattern.test("/about")).toBe(true);
+    });
+    it("finds dynamic route [id]", () => {
+        createFile("users/[id]/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(1);
+        expect(routes[0].pattern.test("/users/42")).toBe(true);
+        expect(routes[0].paramNames).toEqual(["id"]);
+    });
+    it("sorts static routes before dynamic ones", () => {
+        createFile("users/new/page.tsx");
+        createFile("users/[id]/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(2);
+        // Static route (0 params) should come first
+        expect(routes[0].paramNames).toHaveLength(0);
+        expect(routes[1].paramNames).toHaveLength(1);
+    });
+    it("finds page.ts files too", () => {
+        createFile("page.ts");
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(1);
+    });
+    it("returns empty for empty directory", () => {
+        const routes = scanDevRoutes(appDir);
+        expect(routes).toHaveLength(0);
+    });
+});
+// ─── matchDevRoute ────────────────────────────────────────────────────────────
+describe("matchDevRoute", () => {
+    it("matches a static route", () => {
+        createFile("about/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/about");
+        expect(match).not.toBe(null);
+        expect(match.params).toEqual({});
+    });
+    it("matches root route", () => {
+        createFile("page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/");
+        expect(match).not.toBe(null);
+    });
+    it("extracts dynamic params", () => {
+        createFile("users/[id]/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/users/42");
+        expect(match).not.toBe(null);
+        expect(match.params).toEqual({ id: "42" });
+    });
+    it("returns null for unmatched path", () => {
+        createFile("about/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/nonexistent");
+        expect(match).toBe(null);
+    });
+    it("decodes URI components in params", () => {
+        createFile("posts/[slug]/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/posts/hello%20world");
+        expect(match).not.toBe(null);
+        expect(match.params["slug"]).toBe("hello world");
+    });
+    it("matches with optional trailing slash", () => {
+        createFile("about/page.tsx");
+        const routes = scanDevRoutes(appDir);
+        const match = matchDevRoute(routes, "/about/");
+        expect(match).not.toBe(null);
+    });
+});
+// ─── findLayoutFiles ──────────────────────────────────────────────────────────
+describe("findLayoutFiles", () => {
+    it("finds root layout", () => {
+        createFile("layout.tsx");
+        createFile("page.tsx");
+        const layouts = findLayoutFiles(join(appDir, "page.tsx"), appDir);
+        expect(layouts).toHaveLength(1);
+        expect(layouts[0]).toContain("layout.tsx");
+    });
+    it("finds nested layouts ordered outermost first", () => {
+        createFile("layout.tsx");
+        createFile("dashboard/layout.tsx");
+        createFile("dashboard/settings/page.tsx");
+        const layouts = findLayoutFiles(join(appDir, "dashboard/settings/page.tsx"), appDir);
+        expect(layouts).toHaveLength(2);
+        // Root layout should come first
+        expect(layouts[0]).toContain(join(appDir, "layout.tsx"));
+        expect(layouts[1]).toContain(join(appDir, "dashboard/layout.tsx"));
+    });
+    it("returns empty when no layouts exist", () => {
+        createFile("about/page.tsx");
+        const layouts = findLayoutFiles(join(appDir, "about/page.tsx"), appDir);
+        expect(layouts).toHaveLength(0);
+    });
+});
+// ─── findErrorFile ────────────────────────────────────────────────────────────
+describe("findErrorFile", () => {
+    it("finds nearest error.tsx", () => {
+        createFile("error.tsx");
+        createFile("dashboard/page.tsx");
+        const errorFile = findErrorFile(join(appDir, "dashboard/page.tsx"), appDir);
+        expect(errorFile).not.toBe(null);
+        expect(errorFile).toContain("error.tsx");
+    });
+    it("returns null when no error file exists", () => {
+        createFile("page.tsx");
+        const errorFile = findErrorFile(join(appDir, "page.tsx"), appDir);
+        expect(errorFile).toBe(null);
+    });
+    it("prefers the innermost error.tsx", () => {
+        createFile("error.tsx");
+        createFile("dashboard/error.tsx");
+        createFile("dashboard/settings/page.tsx");
+        const errorFile = findErrorFile(join(appDir, "dashboard/settings/page.tsx"), appDir);
+        expect(errorFile).toContain(join("dashboard", "error.tsx"));
+    });
+});
+// ─── findLoadingFile ──────────────────────────────────────────────────────────
+describe("findLoadingFile", () => {
+    it("finds nearest loading.tsx", () => {
+        createFile("loading.tsx");
+        createFile("page.tsx");
+        const loadingFile = findLoadingFile(join(appDir, "page.tsx"), appDir);
+        expect(loadingFile).not.toBe(null);
+        expect(loadingFile).toContain("loading.tsx");
+    });
+    it("returns null when no loading file exists", () => {
+        createFile("page.tsx");
+        const loadingFile = findLoadingFile(join(appDir, "page.tsx"), appDir);
+        expect(loadingFile).toBe(null);
+    });
+});
+// ─── API routes ───────────────────────────────────────────────────────────────
+describe("scanDevApiRoutes", () => {
+    it("finds route.ts files", () => {
+        createFile("api/health/route.ts");
+        const routes = scanDevApiRoutes(appDir);
+        expect(routes).toHaveLength(1);
+    });
+    it("returns empty when no route files", () => {
+        createFile("page.tsx");
+        const routes = scanDevApiRoutes(appDir);
+        expect(routes).toHaveLength(0);
+    });
+});
+describe("matchDevApiRoute", () => {
+    it("matches static API route", () => {
+        createFile("api/health/route.ts");
+        const routes = scanDevApiRoutes(appDir);
+        const match = matchDevApiRoute(routes, "/api/health");
+        expect(match).not.toBe(null);
+    });
+    it("returns null for unmatched API path", () => {
+        createFile("api/health/route.ts");
+        const routes = scanDevApiRoutes(appDir);
+        const match = matchDevApiRoute(routes, "/api/nonexistent");
+        expect(match).toBe(null);
+    });
+});
+//# sourceMappingURL=router-dev.test.js.map

package/dist/ssr/router-dev.test.js.map

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

package/dist/test/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Alab test utilities — zero setup required.
+ *
+ * @example
+ * ```ts
+ * import { renderPage, mockServerFn } from "alabjs/test";
+ * import { getUser } from "./app/users/[id]/page.server.js";
+ *
+ * mockServerFn(getUser, { id: "1", name: "Alice" });
+ * const { html, status } = await renderPage("/users/1");
+ * expect(html).toContain("Alice");
+ * ```
+ */
+import { type ComponentType } from "react";
+import type { ServerFn } from "../types/index.js";
+/**
+ * Mock a `defineServerFn` function for the duration of a test.
+ *
+ * The mock is applied globally for the current test process. Use
+ * `clearMocks()` in `afterEach` if you need isolation between tests,
+ * or rely on Vitest's built-in mock isolation.
+ *
+ * @example
+ * ```ts
+ * import { getUser } from "./page.server.js";
+ * mockServerFn(getUser, { id: "1", name: "Alice", email: "alice@example.com" });
+ * ```
+ */
+export declare function mockServerFn<T extends ServerFn<any, any, any>>(fn: T, returnValue: T extends ServerFn<any, infer O, any> ? O : never): void;
+/**
+ * Mock a server function with a custom handler (for dynamic responses).
+ *
+ * @example
+ * ```ts
+ * mockServerFnWith(getUser, async ({ params }) => {
+ *   if (params.id === "1") return { name: "Alice" };
+ *   throw new Error("Not found");
+ * });
+ * ```
+ */
+export declare function mockServerFnWith<T extends ServerFn<any, any, any>>(fn: T, handler: T extends ServerFn<infer I, infer O, any> ? (ctx: {
+    params: Record<string, string>;
+}, input: I) => Promise<O> : never): void;
+/** Remove all server function mocks. Call in `afterEach` for test isolation. */
+export declare function clearMocks(): void;
+/** @internal Used by Alab's dev server to resolve mocked functions in tests. */
+export declare function _getMock(fnName: string): unknown | undefined;
+export interface RenderPageResult {
+    /** Full HTML string including the Alab shell. */
+    html: string;
+    /** HTTP status code (200, 404, 500, etc.). */
+    status: number;
+    /** Whether the render threw an error. */
+    error: Error | null;
+}
+export interface RenderPageOptions {
+    /**
+     * Params to inject — useful when the route path has dynamic segments.
+     * @example `{ id: "42" }` for `/users/[id]`
+     */
+    params?: Record<string, string>;
+    /** Search params to inject. */
+    searchParams?: Record<string, string>;
+    /**
+     * Request headers forwarded to middleware and server functions.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Render a page component to an HTML string for integration testing.
+ *
+ * Automatically applies any `mockServerFn` mocks registered before this call.
+ * Does not start an HTTP server — renders entirely in-process.
+ *
+ * @example
+ * ```ts
+ * const { html, status } = await renderPage("/users/1", { params: { id: "1" } });
+ * expect(status).toBe(200);
+ * expect(html).toContain('<h1>Alice</h1>');
+ * ```
+ */
+export declare function renderPage(path: string, options?: RenderPageOptions): Promise<RenderPageResult>;
+/**
+ * Render a specific component to HTML (lower-level than `renderPage`).
+ *
+ * @example
+ * ```ts
+ * import UserPage from "./app/users/[id]/page.js";
+ * const { html } = await renderComponent(UserPage, { params: { id: "1" }, searchParams: {} });
+ * ```
+ */
+export declare function renderComponent<P extends Record<string, unknown>>(Component: ComponentType<P>, props: P): Promise<RenderPageResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAOlD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC5D,EAAE,EAAE,CAAC,EACL,WAAW,EAAE,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,GAC7D,IAAI,CAEN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAChE,EAAE,EAAE,CAAC,EACL,OAAO,EAAE,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAC9C,CAAC,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACjE,KAAK,GACR,IAAI,CAEN;AAED,gFAAgF;AAChF,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D;AAID,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/test/index.js

@@ -0,0 +1,146 @@
+/**
+ * Alab test utilities — zero setup required.
+ *
+ * @example
+ * ```ts
+ * import { renderPage, mockServerFn } from "alabjs/test";
+ * import { getUser } from "./app/users/[id]/page.server.js";
+ *
+ * mockServerFn(getUser, { id: "1", name: "Alice" });
+ * const { html, status } = await renderPage("/users/1");
+ * expect(html).toContain("Alice");
+ * ```
+ */
+import { createElement } from "react";
+import { renderToString } from "react-dom/server";
+// ─── mockServerFn ─────────────────────────────────────────────────────────────
+/** Registry of mocked server functions — keyed by function name. */
+const _mocks = new Map();
+/**
+ * Mock a `defineServerFn` function for the duration of a test.
+ *
+ * The mock is applied globally for the current test process. Use
+ * `clearMocks()` in `afterEach` if you need isolation between tests,
+ * or rely on Vitest's built-in mock isolation.
+ *
+ * @example
+ * ```ts
+ * import { getUser } from "./page.server.js";
+ * mockServerFn(getUser, { id: "1", name: "Alice", email: "alice@example.com" });
+ * ```
+ */
+export function mockServerFn(fn, returnValue) {
+    _mocks.set(fn.name, returnValue);
+}
+/**
+ * Mock a server function with a custom handler (for dynamic responses).
+ *
+ * @example
+ * ```ts
+ * mockServerFnWith(getUser, async ({ params }) => {
+ *   if (params.id === "1") return { name: "Alice" };
+ *   throw new Error("Not found");
+ * });
+ * ```
+ */
+export function mockServerFnWith(fn, handler) {
+    _mocks.set(fn.name, handler);
+}
+/** Remove all server function mocks. Call in `afterEach` for test isolation. */
+export function clearMocks() {
+    _mocks.clear();
+}
+/** @internal Used by Alab's dev server to resolve mocked functions in tests. */
+export function _getMock(fnName) {
+    return _mocks.get(fnName);
+}
+/**
+ * Render a page component to an HTML string for integration testing.
+ *
+ * Automatically applies any `mockServerFn` mocks registered before this call.
+ * Does not start an HTTP server — renders entirely in-process.
+ *
+ * @example
+ * ```ts
+ * const { html, status } = await renderPage("/users/1", { params: { id: "1" } });
+ * expect(status).toBe(200);
+ * expect(html).toContain('<h1>Alice</h1>');
+ * ```
+ */
+export async function renderPage(path, options = {}) {
+    const { params = {}, searchParams = {} } = options;
+    // Dynamically resolve the page module from the file-system.
+    // In test environments, Vitest handles module resolution via the Vite plugin.
+    const appDir = new URL("../../app", import.meta.url).pathname;
+    // Convert URL path to a candidate file path.
+    // e.g. "/users/1" → try "app/users/[id]/page.tsx" based on path segments.
+    const segments = path.split("/").filter(Boolean);
+    const candidates = buildCandidatePaths(appDir, segments, params);
+    let PageComponent = null;
+    for (const candidate of candidates) {
+        try {
+            const mod = await import(candidate);
+            if (typeof mod.default === "function") {
+                PageComponent = mod.default;
+                break;
+            }
+        }
+        catch {
+            // Try next candidate.
+        }
+    }
+    if (!PageComponent) {
+        return { html: "", status: 404, error: new Error(`[alabjs/test] No page found for path: ${path}`) };
+    }
+    try {
+        const html = renderToString(createElement(PageComponent, { params, searchParams }));
+        return { html, status: 200, error: null };
+    }
+    catch (err) {
+        return {
+            html: "",
+            status: 500,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/**
+ * Render a specific component to HTML (lower-level than `renderPage`).
+ *
+ * @example
+ * ```ts
+ * import UserPage from "./app/users/[id]/page.js";
+ * const { html } = await renderComponent(UserPage, { params: { id: "1" }, searchParams: {} });
+ * ```
+ */
+export async function renderComponent(Component, props) {
+    try {
+        const html = renderToString(createElement(Component, props));
+        return { html, status: 200, error: null };
+    }
+    catch (err) {
+        return {
+            html: "",
+            status: 500,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildCandidatePaths(appDir, segments, params) {
+    const paramValues = Object.values(params);
+    const candidates = [];
+    // Try resolving dynamic segments in reverse (known params replace segments).
+    const resolvedSegments = segments.map((seg) => {
+        // If this segment matches a known param value, try both [param] and the value.
+        const matchingParam = paramValues.find((v) => v === seg);
+        return matchingParam ? `[${Object.keys(params).find((k) => params[k] === matchingParam) ?? seg}]` : seg;
+    });
+    const extensions = [".tsx", ".ts", ".jsx", ".js"];
+    for (const ext of extensions) {
+        candidates.push(`${appDir}/${resolvedSegments.join("/")}/page${ext}`);
+        candidates.push(`${appDir}/${segments.join("/")}/page${ext}`);
+    }
+    return candidates;
+}
+//# sourceMappingURL=index.js.map

package/dist/test/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+import type { ReactElement } from "react";
+/**
+ * Extracts dynamic segment names from a route path string.
+ *
+ * @example
+ * ExtractParams<"/users/[id]/posts/[slug]"> → "id" | "slug"
+ */
+type ExtractParams<Path extends string> = Path extends `${string}[${infer Param}]${infer Rest}` ? Param | ExtractParams<Rest> : never;
+/**
+ * A typed record of URL path parameters for a given route path.
+ *
+ * @example
+ * RouteParams<"/users/[id]"> → { id: string }
+ */
+export type RouteParams<Path extends string = string> = [
+    ExtractParams<Path>
+] extends [never] ? Record<string, string> : {
+    readonly [K in ExtractParams<Path>]: string;
+};
+/**
+ * The context object passed to every server function.
+ * All fields are readonly — the context is immutable inside a handler.
+ */
+export interface ServerFnContext<Path extends string = string> {
+    /** Typed URL path parameters derived from the route pattern. */
+    readonly params: RouteParams<Path>;
+    /** Parsed query string parameters. */
+    readonly query: Readonly<Record<string, string | readonly string[]>>;
+    /** Raw request headers (lowercase keys). */
+    readonly headers: Readonly<Record<string, string | readonly string[]>>;
+    /** HTTP method — always uppercase. */
+    readonly method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    /** Full request URL including protocol and host. */
+    readonly url: string;
+}
+declare const SERVER_FN_BRAND: unique symbol;
+/**
+ * The type of a server function defined with `defineServerFn()`.
+ *
+ * **Type-level boundary enforcement:**
+ * - Runtime import (`import { fn } from "./page.server"`) in a client file
+ *   → Rust compiler BUILD ERROR
+ * - Type-only import (`import type { fn } from "./page.server"`) in a client file
+ *   → ✅ Allowed — erased at compile time, used only for inference
+ *
+ * Use `InferServerOutput<T>` and `InferServerInput<T>` to extract the types
+ * from a server function for use in `useServerData`.
+ */
+export type ServerFn<Input = undefined, Output = unknown, Path extends string = string> = {
+    /** @internal Nominal brand — prevents plain functions from being used as ServerFn */
+    readonly [SERVER_FN_BRAND]: true;
+    (ctx: ServerFnContext<Path>, input: Input): Promise<Output>;
+};
+/** Extract the resolved output type of a ServerFn. */
+export type InferServerOutput<T extends ServerFn<any, any, any>> = T extends ServerFn<any, infer O, any> ? Awaited<O> : never;
+/** Extract the input type of a ServerFn. */
+export type InferServerInput<T extends ServerFn<any, any, any>> = T extends ServerFn<infer I, any, any> ? I : never;
+/** Extract the route path type of a ServerFn. */
+export type InferServerPath<T extends ServerFn<any, any, any>> = T extends ServerFn<any, any, infer P> ? P : never;
+/**
+ * A typed React page component for a given route path.
+ *
+ * @example
+ * // app/users/[id]/page.tsx
+ * const UserPage: ALabPage<"/users/[id]"> = ({ params }) => {
+ *   params.id; // string ✅
+ *   params.foo; // TS error ✅
+ * };
+ */
+export type AlabPage<Path extends string = string> = (props: {
+    readonly params: RouteParams<Path>;
+    readonly searchParams: Readonly<Record<string, string | readonly string[]>>;
+}) => ReactElement | null;
+export interface OpenGraphMetadata {
+    readonly title?: string;
+    readonly description?: string;
+    readonly image?: string;
+    readonly url?: string;
+    readonly type?: "website" | "article" | "profile";
+    readonly siteName?: string;
+}
+export interface TwitterMetadata {
+    readonly card?: "summary" | "summary_large_image" | "app" | "player";
+    readonly title?: string;
+    readonly description?: string;
+    readonly image?: string;
+    readonly creator?: string;
+}
+/**
+ * Export `metadata` from any page to populate `<head>` on SSR.
+ *
+ * @example
+ * export const metadata: PageMetadata = {
+ *   title: "About us",
+ *   description: "Learn more about our team.",
+ * };
+ */
+export interface PageMetadata {
+    readonly title?: string;
+    readonly description?: string;
+    readonly canonical?: string;
+    readonly robots?: string;
+    readonly og?: OpenGraphMetadata;
+    readonly twitter?: TwitterMetadata;
+    readonly themeColor?: string;
+    /** Additional arbitrary <meta> tags. */
+    readonly extra?: ReadonlyArray<Readonly<Record<string, string>>>;
+}
+/**
+ * Functional metadata for dynamic pages.
+ */
+export type GenerateMetadata<Path extends string = string> = (props: {
+    readonly params: RouteParams<Path>;
+    readonly searchParams: Readonly<Record<string, string | readonly string[]>>;
+}) => Promise<PageMetadata> | PageMetadata;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/napi.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimal interface for the @alabjs/compiler napi binding.
+ * Loaded dynamically at runtime — no static import needed.
+ */
+export interface AlabNapi {
+    compileSource(source: string, filename: string, minify: boolean): string;
+    checkBoundary(source: string, filename: string): string;
+    buildRoutes(appDir: string): string;
+    optimizeImage(input: Buffer, quality?: number | null, width?: number | null, height?: number | null, format?: string | null): Promise<Buffer>;
+    /** Returns JSON `Array<{ name: string; endpoint: string }>` */
+    extractServerFns(source: string, filename: string): string;
+    /** Returns an ES module stub replacing the real handler in client bundles. */
+    serverFnStub(name: string, endpoint: string): string;
+}
+//# sourceMappingURL=napi.d.ts.map

package/dist/types/napi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"napi.d.ts","sourceRoot":"","sources":["../../src/types/napi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACxD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,aAAa,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,+DAA+D;IAC/D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3D,8EAA8E;IAC9E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACtD"}

package/dist/types/napi.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=napi.js.map

package/dist/types/napi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"napi.js","sourceRoot":"","sources":["../../src/types/napi.ts"],"names":[],"mappings":""}