@pyreon/zero 0.12.1 → 0.12.3

package/lib/testing.js

@@ -0,0 +1,179 @@
+//#region src/api-routes.ts
+/**
+* Match a URL path against an API route pattern.
+* Returns extracted params or null if no match.
+*/
+function matchApiRoute(pattern, path) {
+	const patternParts = pattern.split("/").filter(Boolean);
+	const pathParts = path.split("/").filter(Boolean);
+	const params = {};
+	for (let i = 0; i < patternParts.length; i++) {
+		const pp = patternParts[i];
+		if (!pp) continue;
+		if (pp.endsWith("*")) {
+			const paramName = pp.slice(1, -1);
+			params[paramName] = pathParts.slice(i).join("/");
+			return params;
+		}
+		if (i >= pathParts.length) return null;
+		if (pp.startsWith(":")) {
+			params[pp.slice(1)] = pathParts[i];
+			continue;
+		}
+		if (pp !== pathParts[i]) return null;
+	}
+	return patternParts.length === pathParts.length ? params : null;
+}
+const HTTP_METHODS = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE",
+	"HEAD",
+	"OPTIONS"
+];
+/**
+* Create a middleware that dispatches API route requests.
+* API routes are matched by URL pattern and HTTP method.
+*/
+function createApiMiddleware(routes) {
+	return async (ctx) => {
+		for (const route of routes) {
+			const params = matchApiRoute(route.pattern, ctx.path);
+			if (!params) continue;
+			const method = ctx.req.method.toUpperCase();
+			const handler = route.module[method];
+			if (!handler) {
+				const allowed = HTTP_METHODS.filter((m) => route.module[m]).join(", ");
+				return new Response(null, {
+					status: 405,
+					headers: {
+						Allow: allowed,
+						"Content-Type": "application/json"
+					}
+				});
+			}
+			return handler({
+				request: ctx.req,
+				url: ctx.url,
+				path: ctx.path,
+				params,
+				headers: ctx.req.headers
+			});
+		}
+	};
+}
+
+//#endregion
+//#region src/testing.ts
+/**
+* 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)
+*/
+function createTestContext(path, options = {}) {
+	const { method = "GET", headers = {}, body } = options;
+	const url = new URL(`http://localhost${path}`);
+	const requestHeaders = { ...headers };
+	let requestBody;
+	if (body !== void 0) {
+		requestHeaders["Content-Type"] = "application/json";
+		requestBody = JSON.stringify(body);
+	}
+	return {
+		req: new Request(url.toString(), {
+			method,
+			headers: requestHeaders,
+			...requestBody != null ? { body: requestBody } : {}
+		}),
+		url,
+		path,
+		headers: new Headers(),
+		locals: {}
+	};
+}
+/**
+* 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("*")
+*/
+async function testMiddleware(middleware, path, options = {}) {
+	const ctx = createTestContext(path, options);
+	return {
+		response: await middleware(ctx),
+		headers: ctx.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)
+*/
+function createTestApiServer(routes) {
+	const middleware = createApiMiddleware(routes);
+	return { async request(path, options = {}) {
+		const result = await middleware(createTestContext(path, options));
+		if (!result) return new Response("Not Found", { status: 404 });
+		return result;
+	} };
+}
+/**
+* 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" })
+*/
+function createMockHandler(responseConfig = {}) {
+	const { status = 200, body = null, headers = {} } = responseConfig;
+	const calls = [];
+	const handler = (ctx) => {
+		calls.push({
+			path: ctx.path,
+			params: ctx.params
+		});
+		return new Response(JSON.stringify(body), {
+			status,
+			headers: {
+				"Content-Type": "application/json",
+				...headers
+			}
+		});
+	};
+	return Object.assign(handler, { calls });
+}
+
+//#endregion
+export { createMockHandler, createTestApiServer, createTestContext, testMiddleware };
+//# sourceMappingURL=testing.js.map

package/lib/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","names":[],"sources":["../src/api-routes.ts","../src/testing.ts"],"sourcesContent":["import type { Middleware, MiddlewareContext } from '@pyreon/server'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** HTTP methods supported by API routes. */\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'\n\n/** Context passed to API route handlers. */\nexport interface ApiContext {\n  /** The incoming request. */\n  request: Request\n  /** Parsed URL. */\n  url: URL\n  /** URL path. */\n  path: string\n  /** Dynamic route parameters (e.g., { id: \"123\" }). */\n  params: Record<string, string>\n  /** Request headers. */\n  headers: Headers\n}\n\n/** An API route handler function. */\nexport type ApiHandler = (ctx: ApiContext) => Response | Promise<Response>\n\n/** An API route module — exports named HTTP method handlers. */\nexport interface ApiRouteModule {\n  GET?: ApiHandler\n  POST?: ApiHandler\n  PUT?: ApiHandler\n  PATCH?: ApiHandler\n  DELETE?: ApiHandler\n  HEAD?: ApiHandler\n  OPTIONS?: ApiHandler\n}\n\n/** A registered API route entry. */\nexport interface ApiRouteEntry {\n  /** URL pattern (e.g., \"/api/posts/:id\"). */\n  pattern: string\n  /** The route module with method handlers. */\n  module: ApiRouteModule\n}\n\n// ─── Pattern matching ────────────────────────────────────────────────────────\n\n/**\n * Match a URL path against an API route pattern.\n * Returns extracted params or null if no match.\n */\nexport function matchApiRoute(pattern: string, path: string): Record<string, string> | null {\n  const patternParts = pattern.split('/').filter(Boolean)\n  const pathParts = path.split('/').filter(Boolean)\n  const params: Record<string, string> = {}\n\n  for (let i = 0; i < patternParts.length; i++) {\n    const pp = patternParts[i]\n    if (!pp) continue\n\n    // Catch-all: :param*\n    if (pp.endsWith('*')) {\n      const paramName = pp.slice(1, -1)\n      params[paramName] = pathParts.slice(i).join('/')\n      return params\n    }\n\n    // No more path segments\n    if (i >= pathParts.length) return null\n\n    // Dynamic segment: :param\n    if (pp.startsWith(':')) {\n      params[pp.slice(1)] = pathParts[i]!\n      continue\n    }\n\n    // Static segment\n    if (pp !== pathParts[i]) return null\n  }\n\n  return patternParts.length === pathParts.length ? params : null\n}\n\n// ─── Middleware ───────────────────────────────────────────────────────────────\n\nconst HTTP_METHODS: HttpMethod[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']\n\n/**\n * Create a middleware that dispatches API route requests.\n * API routes are matched by URL pattern and HTTP method.\n */\nexport function createApiMiddleware(routes: ApiRouteEntry[]): Middleware {\n  return async (ctx: MiddlewareContext) => {\n    for (const route of routes) {\n      const params = matchApiRoute(route.pattern, ctx.path)\n      if (!params) continue\n\n      const method = ctx.req.method.toUpperCase() as HttpMethod\n      const handler = route.module[method]\n\n      if (!handler) {\n        // Route matched but method not supported\n        const allowed = HTTP_METHODS.filter((m) => route.module[m]).join(', ')\n        return new Response(null, {\n          status: 405,\n          headers: {\n            Allow: allowed,\n            'Content-Type': 'application/json',\n          },\n        })\n      }\n\n      return handler({\n        request: ctx.req,\n        url: ctx.url,\n        path: ctx.path,\n        params,\n        headers: ctx.req.headers,\n      })\n    }\n  }\n}\n\n// ─── Virtual module generation ───────────────────────────────────────────────\n\n/**\n * Detect whether a route file is an API route.\n * API routes are `.ts` or `.js` files inside an `api/` directory.\n */\nexport function isApiRoute(filePath: string): boolean {\n  const normalized = filePath.replace(/\\\\/g, '/')\n  return (\n    normalized.startsWith('api/') &&\n    (normalized.endsWith('.ts') || normalized.endsWith('.js')) &&\n    !normalized.endsWith('.tsx') &&\n    !normalized.endsWith('.jsx')\n  )\n}\n\n/**\n * Convert an API route file path to a URL pattern.\n *\n * Examples:\n *   \"api/posts.ts\"        → \"/api/posts\"\n *   \"api/posts/index.ts\"  → \"/api/posts\"\n *   \"api/posts/[id].ts\"   → \"/api/posts/:id\"\n *   \"api/[...path].ts\"    → \"/api/:path*\"\n */\nexport function apiFilePathToPattern(filePath: string): string {\n  let route = filePath\n  // Remove extension\n  for (const ext of ['.ts', '.js']) {\n    if (route.endsWith(ext)) {\n      route = route.slice(0, -ext.length)\n      break\n    }\n  }\n\n  const segments = route.split('/')\n  const urlSegments: string[] = []\n\n  for (const seg of segments) {\n    if (seg === 'index') continue\n\n    // Catch-all: [...param]\n    const catchAll = seg.match(/^\\[\\.\\.\\.(\\w+)\\]$/)\n    if (catchAll) {\n      urlSegments.push(`:${catchAll[1]}*`)\n      continue\n    }\n\n    // Dynamic: [param]\n    const dynamic = seg.match(/^\\[(\\w+)\\]$/)\n    if (dynamic) {\n      urlSegments.push(`:${dynamic[1]}`)\n      continue\n    }\n\n    urlSegments.push(seg)\n  }\n\n  return `/${urlSegments.join('/')}`\n}\n\n/**\n * Generate a virtual module that exports API route entries.\n * Each entry maps a URL pattern to a module with HTTP method handlers.\n */\nexport function generateApiRouteModule(files: string[], routesDir: string): string {\n  const apiFiles = files.filter(isApiRoute)\n\n  if (apiFiles.length === 0) {\n    return 'export const apiRoutes = []\\n'\n  }\n\n  const imports: string[] = []\n  const entries: string[] = []\n\n  for (let i = 0; i < apiFiles.length; i++) {\n    const name = `_api${i}`\n    const file = apiFiles[i]\n    if (!file) continue\n    const fullPath = `${routesDir}/${file}`\n    const pattern = apiFilePathToPattern(file)\n\n    imports.push(`import * as ${name} from \"${fullPath}\"`)\n    entries.push(`  { pattern: ${JSON.stringify(pattern)}, module: ${name} }`)\n  }\n\n  return [...imports, '', 'export const apiRoutes = [', entries.join(',\\n'), ']'].join('\\n')\n}\n","import type { Middleware, MiddlewareContext } from '@pyreon/server'\nimport type { ApiHandler, ApiRouteEntry } from './api-routes'\nimport { createApiMiddleware } from './api-routes'\n\n// ─── Test helpers for Zero applications ─────────────────────────────────────\n\n/**\n * Create a mock MiddlewareContext for testing middleware.\n *\n * @example\n * import { createTestContext } from \"@pyreon/zero/testing\"\n *\n * const ctx = createTestContext(\"/api/posts\", { method: \"POST\", body: { title: \"Hello\" } })\n * const result = await myMiddleware(ctx)\n */\nexport function createTestContext(\n  path: string,\n  options: {\n    method?: string\n    headers?: Record<string, string>\n    body?: unknown\n  } = {},\n): MiddlewareContext {\n  const { method = 'GET', headers = {}, body } = options\n  const url = new URL(`http://localhost${path}`)\n\n  const requestHeaders: Record<string, string> = { ...headers }\n  let requestBody: string | undefined\n\n  if (body !== undefined) {\n    requestHeaders['Content-Type'] = 'application/json'\n    requestBody = JSON.stringify(body)\n  }\n\n  const req = new Request(url.toString(), {\n    method,\n    headers: requestHeaders,\n    ...(requestBody != null ? { body: requestBody } : {}),\n  })\n\n  return {\n    req,\n    url,\n    path,\n    headers: new Headers(),\n    locals: {},\n  }\n}\n\n/**\n * Test a middleware by running it with a mock context and returning\n * the result along with the response headers it set.\n *\n * @example\n * import { testMiddleware } from \"@pyreon/zero/testing\"\n *\n * const { response, headers } = await testMiddleware(\n *   corsMiddleware({ origin: \"*\" }),\n *   \"/api/posts\"\n * )\n * expect(headers.get(\"Access-Control-Allow-Origin\")).toBe(\"*\")\n */\nexport async function testMiddleware(\n  middleware: Middleware,\n  path: string,\n  options: {\n    method?: string\n    headers?: Record<string, string>\n    body?: unknown\n  } = {},\n): Promise<{ response: Response | undefined; headers: Headers }> {\n  const ctx = createTestContext(path, options)\n  const response = (await middleware(ctx)) as Response | undefined\n  return { response, headers: ctx.headers }\n}\n\n/**\n * Create a test server for API routes. Returns a function that\n * accepts Request objects and dispatches to the correct handler.\n *\n * @example\n * import { createTestApiServer } from \"@pyreon/zero/testing\"\n *\n * const server = createTestApiServer([\n *   { pattern: \"/api/posts\", module: postsApi },\n *   { pattern: \"/api/posts/:id\", module: postByIdApi },\n * ])\n *\n * const response = await server.request(\"/api/posts\")\n * expect(response.status).toBe(200)\n *\n * const data = await server.request(\"/api/posts\", { method: \"POST\", body: { title: \"Hi\" } })\n * expect(data.status).toBe(201)\n */\nexport function createTestApiServer(routes: ApiRouteEntry[]) {\n  const middleware = createApiMiddleware(routes)\n\n  return {\n    async request(\n      path: string,\n      options: {\n        method?: string\n        headers?: Record<string, string>\n        body?: unknown\n      } = {},\n    ): Promise<Response> {\n      const ctx = createTestContext(path, options)\n      const result = await middleware(ctx)\n      if (!result) {\n        return new Response('Not Found', { status: 404 })\n      }\n      return result\n    },\n  }\n}\n\n/**\n * Create a mock API handler for testing.\n * Records all calls and returns a configurable response.\n *\n * @example\n * import { createMockHandler } from \"@pyreon/zero/testing\"\n *\n * const handler = createMockHandler({ status: 200, body: { ok: true } })\n * // ... use handler in your API route module\n * expect(handler.calls).toHaveLength(1)\n * expect(handler.calls[0].params).toEqual({ id: \"123\" })\n */\nexport function createMockHandler(\n  responseConfig: { status?: number; body?: unknown; headers?: Record<string, string> } = {},\n): ApiHandler & {\n  calls: Array<{ path: string; params: Record<string, string> }>\n} {\n  const { status = 200, body = null, headers = {} } = responseConfig\n  const calls: Array<{ path: string; params: Record<string, string> }> = []\n\n  const handler: ApiHandler = (ctx) => {\n    calls.push({ path: ctx.path, params: ctx.params })\n    return new Response(JSON.stringify(body), {\n      status,\n      headers: { 'Content-Type': 'application/json', ...headers },\n    })\n  }\n\n  return Object.assign(handler, { calls })\n}\n"],"mappings":";;;;;AAiDA,SAAgB,cAAc,SAAiB,MAA6C;CAC1F,MAAM,eAAe,QAAQ,MAAM,IAAI,CAAC,OAAO,QAAQ;CACvD,MAAM,YAAY,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CACjD,MAAM,SAAiC,EAAE;AAEzC,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAC5C,MAAM,KAAK,aAAa;AACxB,MAAI,CAAC,GAAI;AAGT,MAAI,GAAG,SAAS,IAAI,EAAE;GACpB,MAAM,YAAY,GAAG,MAAM,GAAG,GAAG;AACjC,UAAO,aAAa,UAAU,MAAM,EAAE,CAAC,KAAK,IAAI;AAChD,UAAO;;AAIT,MAAI,KAAK,UAAU,OAAQ,QAAO;AAGlC,MAAI,GAAG,WAAW,IAAI,EAAE;AACtB,UAAO,GAAG,MAAM,EAAE,IAAI,UAAU;AAChC;;AAIF,MAAI,OAAO,UAAU,GAAI,QAAO;;AAGlC,QAAO,aAAa,WAAW,UAAU,SAAS,SAAS;;AAK7D,MAAM,eAA6B;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAQ;CAAU;;;;;AAM/F,SAAgB,oBAAoB,QAAqC;AACvE,QAAO,OAAO,QAA2B;AACvC,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,SAAS,cAAc,MAAM,SAAS,IAAI,KAAK;AACrD,OAAI,CAAC,OAAQ;GAEb,MAAM,SAAS,IAAI,IAAI,OAAO,aAAa;GAC3C,MAAM,UAAU,MAAM,OAAO;AAE7B,OAAI,CAAC,SAAS;IAEZ,MAAM,UAAU,aAAa,QAAQ,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,KAAK;AACtE,WAAO,IAAI,SAAS,MAAM;KACxB,QAAQ;KACR,SAAS;MACP,OAAO;MACP,gBAAgB;MACjB;KACF,CAAC;;AAGJ,UAAO,QAAQ;IACb,SAAS,IAAI;IACb,KAAK,IAAI;IACT,MAAM,IAAI;IACV;IACA,SAAS,IAAI,IAAI;IAClB,CAAC;;;;;;;;;;;;;;;;ACrGR,SAAgB,kBACd,MACA,UAII,EAAE,EACa;CACnB,MAAM,EAAE,SAAS,OAAO,UAAU,EAAE,EAAE,SAAS;CAC/C,MAAM,MAAM,IAAI,IAAI,mBAAmB,OAAO;CAE9C,MAAM,iBAAyC,EAAE,GAAG,SAAS;CAC7D,IAAI;AAEJ,KAAI,SAAS,QAAW;AACtB,iBAAe,kBAAkB;AACjC,gBAAc,KAAK,UAAU,KAAK;;AASpC,QAAO;EACL,KAPU,IAAI,QAAQ,IAAI,UAAU,EAAE;GACtC;GACA,SAAS;GACT,GAAI,eAAe,OAAO,EAAE,MAAM,aAAa,GAAG,EAAE;GACrD,CAAC;EAIA;EACA;EACA,SAAS,IAAI,SAAS;EACtB,QAAQ,EAAE;EACX;;;;;;;;;;;;;;;AAgBH,eAAsB,eACpB,YACA,MACA,UAII,EAAE,EACyD;CAC/D,MAAM,MAAM,kBAAkB,MAAM,QAAQ;AAE5C,QAAO;EAAE,UADS,MAAM,WAAW,IAAI;EACpB,SAAS,IAAI;EAAS;;;;;;;;;;;;;;;;;;;;AAqB3C,SAAgB,oBAAoB,QAAyB;CAC3D,MAAM,aAAa,oBAAoB,OAAO;AAE9C,QAAO,EACL,MAAM,QACJ,MACA,UAII,EAAE,EACa;EAEnB,MAAM,SAAS,MAAM,WADT,kBAAkB,MAAM,QAAQ,CACR;AACpC,MAAI,CAAC,OACH,QAAO,IAAI,SAAS,aAAa,EAAE,QAAQ,KAAK,CAAC;AAEnD,SAAO;IAEV;;;;;;;;;;;;;;AAeH,SAAgB,kBACd,iBAAwF,EAAE,EAG1F;CACA,MAAM,EAAE,SAAS,KAAK,OAAO,MAAM,UAAU,EAAE,KAAK;CACpD,MAAM,QAAiE,EAAE;CAEzE,MAAM,WAAuB,QAAQ;AACnC,QAAM,KAAK;GAAE,MAAM,IAAI;GAAM,QAAQ,IAAI;GAAQ,CAAC;AAClD,SAAO,IAAI,SAAS,KAAK,UAAU,KAAK,EAAE;GACxC;GACA,SAAS;IAAE,gBAAgB;IAAoB,GAAG;IAAS;GAC5D,CAAC;;AAGJ,QAAO,OAAO,OAAO,SAAS,EAAE,OAAO,CAAC"}

package/lib/theme.js

@@ -55,11 +55,20 @@ const jsxs = jsx;
 const STORAGE_KEY = "zero-theme";
 /** Reactive theme signal. */
 const theme = signal("system");
+/** SSR fallback when system preference can't be detected. Default: 'light'. */
+let _ssrDefault = "light";
+/**
+* Set the default theme for SSR (when `matchMedia` is unavailable).
+* Call once at server startup before rendering.
+*/
+function setSSRThemeDefault(value) {
+	_ssrDefault = value;
+}
 /** Computed resolved theme (what's actually applied). */
 function resolvedTheme() {
 	const t = theme();
 	if (t === "system") {
-		if (typeof window === "undefined") return "dark";
+		if (typeof window === "undefined") return _ssrDefault;
 		return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
 	}
 	return t;
@@ -210,5 +219,5 @@ function ThemeToggle(props) {
 const themeScript = `(function(){try{var t=localStorage.getItem("${STORAGE_KEY}");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 { ThemeToggle, initTheme, resolvedTheme, setTheme, theme, themeScript, toggleTheme };
+export { ThemeToggle, initTheme, resolvedTheme, setSSRThemeDefault, setTheme, theme, themeScript, toggleTheme };
 //# sourceMappingURL=theme.js.map

package/lib/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","names":[],"sources":["../../../core/core/lib/jsx-runtime.js","../src/theme.tsx"],"sourcesContent":["//#region src/h.ts\n/** Marker for fragment nodes — renders children without a wrapper element */\nconst Fragment = Symbol(\"Pyreon.Fragment\");\n/**\n* Hyperscript function — the compiled output of JSX.\n* `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n*\n* Generic on P so TypeScript validates props match the component's signature\n* at the call site, then stores the result in the loosely-typed VNode.\n*/\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nconst EMPTY_PROPS = {};\nfunction h(type, props, ...children) {\n\treturn {\n\t\ttype,\n\t\tprops: props ?? EMPTY_PROPS,\n\t\tchildren: normalizeChildren(children),\n\t\tkey: props?.key ?? null\n\t};\n}\nfunction normalizeChildren(children) {\n\tfor (let i = 0; i < children.length; i++) if (Array.isArray(children[i])) return flattenChildren(children);\n\treturn children;\n}\nfunction flattenChildren(children) {\n\tconst result = [];\n\tfor (const child of children) if (Array.isArray(child)) result.push(...flattenChildren(child));\n\telse result.push(child);\n\treturn result;\n}\n\n//#endregion\n//#region src/jsx-runtime.ts\n/**\n* JSX automatic runtime.\n*\n* When tsconfig has `\"jsxImportSource\": \"@pyreon/core\"`, the TS/bundler compiler\n* rewrites JSX to imports from this file automatically:\n*   <div class=\"x\" />  →  jsx(\"div\", { class: \"x\" })\n*/\nfunction jsx(type, props, key) {\n\tconst { children, ...rest } = props;\n\tconst propsWithKey = key != null ? {\n\t\t...rest,\n\t\tkey\n\t} : rest;\n\tif (typeof type === \"function\") return h(type, children !== void 0 ? {\n\t\t...propsWithKey,\n\t\tchildren\n\t} : propsWithKey);\n\treturn h(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);\n}\nconst jsxs = jsx;\n\n//#endregion\nexport { Fragment, jsx, jsxs };\n//# sourceMappingURL=jsx-runtime.js.map","import type { VNodeChild } from '@pyreon/core'\nimport { onMount, onUnmount } from '@pyreon/core'\nimport { effect, signal } from '@pyreon/reactivity'\n\n// ─── Theme system ───────────────────────────────────────────────────────────\n//\n// Provides dark/light/system theme support with:\n// - System preference detection via matchMedia\n// - Persistent preference via localStorage\n// - No flash of wrong theme (inline script in HTML)\n// - Reactive theme signal for components\n\nexport type Theme = 'light' | 'dark' | 'system'\n\nconst STORAGE_KEY = 'zero-theme'\n\n/** Reactive theme signal. */\nexport const theme = signal<Theme>('system')\n\n/** Computed resolved theme (what's actually applied). */\nexport function resolvedTheme(): 'light' | 'dark' {\n  const t = theme()\n  if (t === 'system') {\n    if (typeof window === 'undefined') return 'dark'\n    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'\n  }\n  return t\n}\n\n/** Toggle between light and dark. */\nexport function toggleTheme() {\n  const current = resolvedTheme()\n  setTheme(current === 'dark' ? 'light' : 'dark')\n}\n\n/** Set theme explicitly. */\nexport function setTheme(t: Theme) {\n  theme.set(t)\n  if (typeof document !== 'undefined') {\n    document.documentElement.dataset.theme = resolvedTheme()\n    try {\n      localStorage.setItem(STORAGE_KEY, t)\n    } catch {\n      // localStorage may not be available (SSR, private browsing)\n    }\n  }\n}\n\n/**\n * Initialize the theme system. Call once in your app entry or layout.\n * Reads from localStorage, listens for system preference changes.\n */\nexport function initTheme() {\n  onMount(() => {\n    // Read persisted preference\n    try {\n      const stored = localStorage.getItem(STORAGE_KEY) as Theme | null\n      if (stored === 'light' || stored === 'dark' || stored === 'system') {\n        theme.set(stored)\n      }\n    } catch {\n      // localStorage may not be available\n    }\n\n    // Apply to document\n    document.documentElement.dataset.theme = resolvedTheme()\n\n    // Watch for system preference changes\n    const mq = window.matchMedia('(prefers-color-scheme: dark)')\n    function onChange() {\n      if (theme() === 'system') {\n        document.documentElement.dataset.theme = resolvedTheme()\n      }\n    }\n    mq.addEventListener('change', onChange)\n    onUnmount(() => mq.removeEventListener('change', onChange))\n\n    // Re-apply when theme signal changes\n    const dispose = effect(() => {\n      document.documentElement.dataset.theme = resolvedTheme()\n    })\n    if (dispose) onUnmount(() => dispose.dispose())\n\n    return undefined\n  })\n}\n\n/**\n * Theme toggle button component.\n *\n * @example\n * import { ThemeToggle } from \"@pyreon/zero/theme\"\n * <ThemeToggle />\n */\nexport function ThemeToggle(props: { class?: string; style?: string }): VNodeChild {\n  initTheme()\n\n  return (\n    <button\n      class={props.class}\n      style={props.style}\n      onClick={toggleTheme}\n      aria-label=\"Toggle theme\"\n      title=\"Toggle theme\"\n      type=\"button\"\n    >\n      {() =>\n        resolvedTheme() === 'dark' ? (\n          <svg\n            width=\"18\"\n            height=\"18\"\n            viewBox=\"0 0 24 24\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            stroke-width=\"2\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n            aria-hidden=\"true\"\n          >\n            <circle cx=\"12\" cy=\"12\" r=\"5\" />\n            <line x1=\"12\" y1=\"1\" x2=\"12\" y2=\"3\" />\n            <line x1=\"12\" y1=\"21\" x2=\"12\" y2=\"23\" />\n            <line x1=\"4.22\" y1=\"4.22\" x2=\"5.64\" y2=\"5.64\" />\n            <line x1=\"18.36\" y1=\"18.36\" x2=\"19.78\" y2=\"19.78\" />\n            <line x1=\"1\" y1=\"12\" x2=\"3\" y2=\"12\" />\n            <line x1=\"21\" y1=\"12\" x2=\"23\" y2=\"12\" />\n            <line x1=\"4.22\" y1=\"19.78\" x2=\"5.64\" y2=\"18.36\" />\n            <line x1=\"18.36\" y1=\"5.64\" x2=\"19.78\" y2=\"4.22\" />\n          </svg>\n        ) : (\n          <svg\n            width=\"18\"\n            height=\"18\"\n            viewBox=\"0 0 24 24\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            stroke-width=\"2\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n            aria-hidden=\"true\"\n          >\n            <path d=\"M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z\" />\n          </svg>\n        )\n      }\n    </button>\n  )\n}\n\n/**\n * Inline script to prevent flash of wrong theme.\n * Include this in your index.html <head> BEFORE any stylesheets.\n *\n * @example\n * // index.html\n * <head>\n *   <script>{themeScript}</script>\n *   ...\n * </head>\n */\nexport const themeScript = `(function(){try{var t=localStorage.getItem(\"${STORAGE_KEY}\");var r=t===\"light\"?\"light\":t===\"dark\"?\"dark\":window.matchMedia(\"(prefers-color-scheme:dark)\").matches?\"dark\":\"light\";document.documentElement.dataset.theme=r}catch(e){}})()`\n"],"mappings":"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"}
+{"version":3,"file":"theme.js","names":[],"sources":["../../../core/core/lib/jsx-runtime.js","../src/theme.tsx"],"sourcesContent":["//#region src/h.ts\n/** Marker for fragment nodes — renders children without a wrapper element */\nconst Fragment = Symbol(\"Pyreon.Fragment\");\n/**\n* Hyperscript function — the compiled output of JSX.\n* `<div class=\"x\">hello</div>` → `h(\"div\", { class: \"x\" }, \"hello\")`\n*\n* Generic on P so TypeScript validates props match the component's signature\n* at the call site, then stores the result in the loosely-typed VNode.\n*/\n/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */\nconst EMPTY_PROPS = {};\nfunction h(type, props, ...children) {\n\treturn {\n\t\ttype,\n\t\tprops: props ?? EMPTY_PROPS,\n\t\tchildren: normalizeChildren(children),\n\t\tkey: props?.key ?? null\n\t};\n}\nfunction normalizeChildren(children) {\n\tfor (let i = 0; i < children.length; i++) if (Array.isArray(children[i])) return flattenChildren(children);\n\treturn children;\n}\nfunction flattenChildren(children) {\n\tconst result = [];\n\tfor (const child of children) if (Array.isArray(child)) result.push(...flattenChildren(child));\n\telse result.push(child);\n\treturn result;\n}\n\n//#endregion\n//#region src/jsx-runtime.ts\n/**\n* JSX automatic runtime.\n*\n* When tsconfig has `\"jsxImportSource\": \"@pyreon/core\"`, the TS/bundler compiler\n* rewrites JSX to imports from this file automatically:\n*   <div class=\"x\" />  →  jsx(\"div\", { class: \"x\" })\n*/\nfunction jsx(type, props, key) {\n\tconst { children, ...rest } = props;\n\tconst propsWithKey = key != null ? {\n\t\t...rest,\n\t\tkey\n\t} : rest;\n\tif (typeof type === \"function\") return h(type, children !== void 0 ? {\n\t\t...propsWithKey,\n\t\tchildren\n\t} : propsWithKey);\n\treturn h(type, propsWithKey, ...children === void 0 ? [] : Array.isArray(children) ? children : [children]);\n}\nconst jsxs = jsx;\n\n//#endregion\nexport { Fragment, jsx, jsxs };\n//# sourceMappingURL=jsx-runtime.js.map","import type { VNodeChild } from '@pyreon/core'\nimport { onMount, onUnmount } from '@pyreon/core'\nimport { effect, signal } from '@pyreon/reactivity'\n\n// ─── Theme system ───────────────────────────────────────────────────────────\n//\n// Provides dark/light/system theme support with:\n// - System preference detection via matchMedia\n// - Persistent preference via localStorage\n// - No flash of wrong theme (inline script in HTML)\n// - Reactive theme signal for components\n\nexport type Theme = 'light' | 'dark' | 'system'\n\nconst STORAGE_KEY = 'zero-theme'\n\n/** Reactive theme signal. */\nexport const theme = signal<Theme>('system')\n\n/** SSR fallback when system preference can't be detected. Default: 'light'. */\nlet _ssrDefault: 'light' | 'dark' = 'light'\n\n/**\n * Set the default theme for SSR (when `matchMedia` is unavailable).\n * Call once at server startup before rendering.\n */\nexport function setSSRThemeDefault(value: 'light' | 'dark'): void {\n  _ssrDefault = value\n}\n\n/** Computed resolved theme (what's actually applied). */\nexport function resolvedTheme(): 'light' | 'dark' {\n  const t = theme()\n  if (t === 'system') {\n    if (typeof window === 'undefined') return _ssrDefault\n    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'\n  }\n  return t\n}\n\n/** Toggle between light and dark. */\nexport function toggleTheme() {\n  const current = resolvedTheme()\n  setTheme(current === 'dark' ? 'light' : 'dark')\n}\n\n/** Set theme explicitly. */\nexport function setTheme(t: Theme) {\n  theme.set(t)\n  if (typeof document !== 'undefined') {\n    document.documentElement.dataset.theme = resolvedTheme()\n    try {\n      localStorage.setItem(STORAGE_KEY, t)\n    } catch {\n      // localStorage may not be available (SSR, private browsing)\n    }\n  }\n}\n\n/**\n * Initialize the theme system. Call once in your app entry or layout.\n * Reads from localStorage, listens for system preference changes.\n */\nexport function initTheme() {\n  onMount(() => {\n    // Read persisted preference\n    try {\n      const stored = localStorage.getItem(STORAGE_KEY) as Theme | null\n      if (stored === 'light' || stored === 'dark' || stored === 'system') {\n        theme.set(stored)\n      }\n    } catch {\n      // localStorage may not be available\n    }\n\n    // Apply to document\n    document.documentElement.dataset.theme = resolvedTheme()\n\n    // Watch for system preference changes\n    const mq = window.matchMedia('(prefers-color-scheme: dark)')\n    function onChange() {\n      if (theme() === 'system') {\n        document.documentElement.dataset.theme = resolvedTheme()\n      }\n    }\n    mq.addEventListener('change', onChange)\n    onUnmount(() => mq.removeEventListener('change', onChange))\n\n    // Re-apply when theme signal changes\n    const dispose = effect(() => {\n      document.documentElement.dataset.theme = resolvedTheme()\n    })\n    if (dispose) onUnmount(() => dispose.dispose())\n\n    return undefined\n  })\n}\n\n/**\n * Theme toggle button component.\n *\n * @example\n * import { ThemeToggle } from \"@pyreon/zero/theme\"\n * <ThemeToggle />\n */\nexport function ThemeToggle(props: { class?: string; style?: string }): VNodeChild {\n  initTheme()\n\n  return (\n    <button\n      class={props.class}\n      style={props.style}\n      onClick={toggleTheme}\n      aria-label=\"Toggle theme\"\n      title=\"Toggle theme\"\n      type=\"button\"\n    >\n      {() =>\n        resolvedTheme() === 'dark' ? (\n          <svg\n            width=\"18\"\n            height=\"18\"\n            viewBox=\"0 0 24 24\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            stroke-width=\"2\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n            aria-hidden=\"true\"\n          >\n            <circle cx=\"12\" cy=\"12\" r=\"5\" />\n            <line x1=\"12\" y1=\"1\" x2=\"12\" y2=\"3\" />\n            <line x1=\"12\" y1=\"21\" x2=\"12\" y2=\"23\" />\n            <line x1=\"4.22\" y1=\"4.22\" x2=\"5.64\" y2=\"5.64\" />\n            <line x1=\"18.36\" y1=\"18.36\" x2=\"19.78\" y2=\"19.78\" />\n            <line x1=\"1\" y1=\"12\" x2=\"3\" y2=\"12\" />\n            <line x1=\"21\" y1=\"12\" x2=\"23\" y2=\"12\" />\n            <line x1=\"4.22\" y1=\"19.78\" x2=\"5.64\" y2=\"18.36\" />\n            <line x1=\"18.36\" y1=\"5.64\" x2=\"19.78\" y2=\"4.22\" />\n          </svg>\n        ) : (\n          <svg\n            width=\"18\"\n            height=\"18\"\n            viewBox=\"0 0 24 24\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            stroke-width=\"2\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n            aria-hidden=\"true\"\n          >\n            <path d=\"M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z\" />\n          </svg>\n        )\n      }\n    </button>\n  )\n}\n\n/**\n * Inline script to prevent flash of wrong theme.\n * Include this in your index.html <head> BEFORE any stylesheets.\n *\n * @example\n * // index.html\n * <head>\n *   <script>{themeScript}</script>\n *   ...\n * </head>\n */\nexport const themeScript = `(function(){try{var t=localStorage.getItem(\"${STORAGE_KEY}\");var r=t===\"light\"?\"light\":t===\"dark\"?\"dark\":window.matchMedia(\"(prefers-color-scheme:dark)\").matches?\"dark\":\"light\";document.documentElement.dataset.theme=r}catch(e){}})()`\n"],"mappings":"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"}

package/lib/types/actions.d.ts

@@ -1,28 +1,30 @@
-import type { MiddlewareContext } from '@pyreon/server';
+import { MiddlewareContext } from "@pyreon/server";
+
+//#region src/actions.d.ts
 /** Context passed to server action handlers. */
-export interface ActionContext {
-    /** The original request. */
-    request: Request;
-    /** Parsed form data (for form submissions). */
-    formData: FormData | null;
-    /** Parsed JSON body (for JSON submissions). */
-    json: unknown;
-    /** Request headers. */
-    headers: Headers;
+interface ActionContext {
+  /** The original request. */
+  request: Request;
+  /** Parsed form data (for form submissions). */
+  formData: FormData | null;
+  /** Parsed JSON body (for JSON submissions). */
+  json: unknown;
+  /** Request headers. */
+  headers: Headers;
 }
 /** A server action handler function. */
-export type ActionHandler<T = unknown> = (ctx: ActionContext) => T | Promise<T>;
+type ActionHandler<T = unknown> = (ctx: ActionContext) => T | Promise<T>;
 /** A registered action with its ID and handler. */
 interface RegisteredAction {
-    id: string;
-    handler: ActionHandler;
+  id: string;
+  handler: ActionHandler;
 }
 /** Client-side callable action returned by defineAction. */
-export interface Action<T = unknown> {
-    /** Call the action with JSON data. */
-    (data?: unknown): Promise<T>;
-    /** The action's unique ID. */
-    actionId: string;
+interface Action<T = unknown> {
+  /** Call the action with JSON data. */
+  (data?: unknown): Promise<T>;
+  /** The action's unique ID. */
+  actionId: string;
 }
 /**
  * Define a server action. Returns a callable function that:
@@ -40,18 +42,19 @@ export interface Action<T = unknown> {
  * // In a component:
  * const result = await createPost({ title: 'Hello', body: '...' })
  */
-export declare function defineAction<T = unknown>(handler: ActionHandler<T>): Action<T>;
+declare function defineAction<T = unknown>(handler: ActionHandler<T>): Action<T>;
 /** Get all registered actions. Useful for testing. */
-export declare function getRegisteredActions(): Map<string, RegisteredAction>;
+declare function getRegisteredActions(): Map<string, RegisteredAction>;
 /**
  * Reset the action registry. Useful for testing.
  * @internal
  */
-export declare function _resetActions(): void;
+declare function _resetActions(): void;
 /**
  * Create a middleware that handles action requests at `/_zero/actions/*`.
  * Mount this before the SSR handler in the server entry.
  */
-export declare function createActionMiddleware(): (ctx: MiddlewareContext) => Response | undefined | Promise<Response | undefined>;
-export {};
-//# sourceMappingURL=actions.d.ts.map
+declare function createActionMiddleware(): (ctx: MiddlewareContext) => Response | undefined | Promise<Response | undefined>;
+//#endregion
+export { Action, ActionContext, ActionHandler, _resetActions, createActionMiddleware, defineAction, getRegisteredActions };
+//# sourceMappingURL=actions2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAIvD,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACzB,+CAA+C;IAC/C,IAAI,EAAE,OAAO,CAAA;IACb,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE/E,mDAAmD;AACnD,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,sCAAsC;IACtC,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC5B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAmC9E;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,CACxC,GAAG,EAAE,iBAAiB,KACnB,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAiBxD"}
+{"version":3,"file":"actions2.d.ts","names":[],"sources":["../../../src/actions.ts"],"mappings":";;;;UAKiB,aAAA;EAAA;EAEf,OAAA,EAAS,OAAA;;EAET,QAAA,EAAU,QAAA;EAAA;EAEV,IAAA;EAEgB;EAAhB,OAAA,EAAS,OAAA;AAAA;;KAIC,aAAA,iBAA8B,GAAA,EAAK,aAAA,KAAkB,CAAA,GAAI,OAAA,CAAQ,CAAA;;UAGnE,gBAAA;EACR,EAAA;EACA,OAAA,EAAS,aAAA;AAAA;;UAIM,MAAA;EATQ;EAAA,CAWtB,IAAA,aAAiB,OAAA,CAAQ,CAAA;EAXmB;EAa7C,QAAA;AAAA;;;;;;;;;;;;AAb6E;;;;;iBAoC/D,YAAA,aAAA,CAA0B,OAAA,EAAS,aAAA,CAAc,CAAA,IAAK,MAAA,CAAO,CAAA;;iBAsC7D,oBAAA,CAAA,GAAwB,GAAA,SAAY,gBAAA;;AAjEpD;;;iBAyEgB,aAAA,CAAA;;;;;iBAUA,sBAAA,CAAA,IACd,GAAA,EAAK,iBAAA,KACF,QAAA,eAAuB,OAAA,CAAQ,QAAA"}

package/lib/types/ai.d.ts

@@ -0,0 +1,163 @@
+import { Plugin } from "vite";
+
+//#region src/ai.d.ts
+interface AiPluginConfig {
+  /** App/API name. */
+  name: string;
+  /** App description for AI agents. */
+  description: string;
+  /** Base URL. e.g. "https://example.com" */
+  origin: string;
+  /** Contact email (required by OpenAI plugin spec). */
+  contactEmail?: string;
+  /** Legal info URL. */
+  legalUrl?: string;
+  /** Logo URL for the plugin. */
+  logoUrl?: string;
+  /** Routes directory relative to project root. Default: "src/routes" */
+  routesDir?: string;
+  /** API routes directory relative to project root. Default: "src/api" */
+  apiDir?: string;
+  /**
+   * API route descriptions — map of pattern to description.
+   * Used for llms.txt and ai-plugin.json.
+   *
+   * @example
+   * ```ts
+   * apiDescriptions: {
+   *   "GET /api/posts": "List all blog posts, supports ?page=N&limit=N",
+   *   "GET /api/posts/:id": "Get a single post by ID",
+   *   "POST /api/posts": "Create a new post (requires auth)",
+   * }
+   * ```
+   */
+  apiDescriptions?: Record<string, string>;
+  /**
+   * Page descriptions — map of URL path to description.
+   * Used for llms.txt. Falls back to route meta.title/description.
+   */
+  pageDescriptions?: Record<string, string>;
+  /**
+   * Additional content to append to llms.txt.
+   * Useful for authentication instructions, rate limits, etc.
+   */
+  llmsExtra?: string;
+}
+/**
+ * Generate llms.txt content from route files and config.
+ *
+ * Format follows the llms.txt proposal:
+ * ```
+ * # {name}
+ * > {description}
+ *
+ * ## Pages
+ * - [/about](/about): About page
+ *
+ * ## API
+ * - GET /api/posts: List posts
+ * ```
+ *
+ * @internal Exported for testing.
+ */
+declare function generateLlmsTxt(routeFiles: string[], apiFiles: string[], config: AiPluginConfig): string;
+/**
+ * Generate llms-full.txt — expanded version with more detail.
+ * Includes all route metadata and API descriptions.
+ *
+ * @internal Exported for testing.
+ */
+declare function generateLlmsFullTxt(routeFiles: string[], apiFiles: string[], config: AiPluginConfig): string;
+interface InferJsonLdOptions {
+  /** Page URL. */
+  url: string;
+  /** Page title. */
+  title?: string;
+  /** Page description. */
+  description?: string;
+  /** Page image. */
+  image?: string;
+  /** Site name. */
+  siteName?: string;
+  /** Page type hint. */
+  type?: 'website' | 'article' | 'product' | 'profile';
+  /** Article metadata. */
+  publishedTime?: string;
+  /** Article author. */
+  author?: string;
+  /** Article tags. */
+  tags?: string[];
+  /** Breadcrumb path segments. */
+  breadcrumbs?: Array<{
+    name: string;
+    url: string;
+  }>;
+}
+/**
+ * Auto-infer JSON-LD structured data from page metadata.
+ *
+ * Returns an array of JSON-LD objects (multiple schemas can apply to one page).
+ * For example, an article page gets both `Article` and `BreadcrumbList`.
+ *
+ * @example
+ * ```tsx
+ * const schemas = inferJsonLd({
+ *   url: "https://example.com/blog/my-post",
+ *   title: "My Post",
+ *   description: "A great article",
+ *   type: "article",
+ *   author: "Vit Bokisch",
+ *   publishedTime: "2026-03-31",
+ * })
+ * // → [Article schema, BreadcrumbList schema]
+ * ```
+ */
+declare function inferJsonLd(options: InferJsonLdOptions): Record<string, unknown>[];
+/**
+ * Generate an OpenAI-compatible AI plugin manifest.
+ *
+ * Follows the /.well-known/ai-plugin.json spec.
+ *
+ * @internal Exported for testing.
+ */
+declare function generateAiPluginManifest(config: AiPluginConfig): Record<string, unknown>;
+/**
+ * Generate a minimal OpenAPI 3.0 spec from API route descriptions.
+ *
+ * @internal Exported for testing.
+ */
+declare function generateOpenApiSpec(apiFiles: string[], config: AiPluginConfig): Record<string, unknown>;
+/**
+ * AI integration Vite plugin.
+ *
+ * Generates at build time:
+ * - `/llms.txt` — concise site summary for AI agents
+ * - `/llms-full.txt` — detailed reference for AI agents
+ * - `/.well-known/ai-plugin.json` — OpenAI plugin manifest
+ * - `/.well-known/openapi.yaml` — minimal OpenAPI spec from API routes
+ *
+ * In dev, serves these files via middleware.
+ *
+ * @example
+ * ```ts
+ * import { aiPlugin } from "@pyreon/zero/ai"
+ *
+ * export default {
+ *   plugins: [
+ *     aiPlugin({
+ *       name: "My App",
+ *       origin: "https://example.com",
+ *       description: "A modern web application",
+ *       apiDescriptions: {
+ *         "GET /api/posts": "List blog posts",
+ *         "GET /api/posts/:id": "Get post by ID",
+ *       },
+ *     }),
+ *   ],
+ * }
+ * ```
+ */
+declare function aiPlugin(config: AiPluginConfig): Plugin;
+//#endregion
+export { AiPluginConfig, InferJsonLdOptions, aiPlugin, generateAiPluginManifest, generateLlmsFullTxt, generateLlmsTxt, generateOpenApiSpec, inferJsonLd };
+//# sourceMappingURL=ai2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai2.d.ts","names":[],"sources":["../../../src/ai.ts"],"mappings":";;;UA4BiB,cAAA;EAiEO;EA/DtB,IAAA;EA8DA;EA5DA,WAAA;EA6DA;EA3DA,MAAA;EA2DsB;EAzDtB,YAAA;EAmJiC;EAjJjC,QAAA;EAoJsB;EAlJtB,OAAA;EAiJA;EA/IA,SAAA;EAgJA;EA9IA,MAAA;EA8IsB;AAsDxB;;;;;;;;;;;;EAtLE,eAAA,GAAkB,MAAA;EA0MlB;;;;EArMA,gBAAA,GAAmB,MAAA;EAqMoB;AAsBzC;;;EAtNE,SAAA;AAAA;;;;;AAwTF;;;;;;;;;AAuBA;;;;iBAzTgB,eAAA,CACd,UAAA,YACA,QAAA,YACA,MAAA,EAAQ,cAAA;;;;;;AAuYV;iBA7SgB,mBAAA,CACd,UAAA,YACA,QAAA,YACA,MAAA,EAAQ,cAAA;AAAA,UAsDO,kBAAA;EAoPuC;EAlPtD,GAAA;EAkPuB;EAhPvB,KAAA;EAgPsD;EA9OtD,WAAA;;EAEA,KAAA;;EAEA,QAAA;;EAEA,IAAA;;EAEA,aAAA;;EAEA,MAAA;;EAEA,IAAA;;EAEA,WAAA,GAAc,KAAA;IAAQ,IAAA;IAAc,GAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;iBAsBtB,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,MAAA;;;;;;;;iBAkG1C,wBAAA,CAAyB,MAAA,EAAQ,cAAA,GAAiB,MAAA;;;;;;iBAuBlD,mBAAA,CACd,QAAA,YACA,MAAA,EAAQ,cAAA,GACP,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Ea,QAAA,CAAS,MAAA,EAAQ,cAAA,GAAiB,MAAA"}

package/lib/types/api-routes.d.ts

@@ -1,53 +1,55 @@
-import type { Middleware } from '@pyreon/server';
+import { Middleware } from "@pyreon/server";
+
+//#region src/api-routes.d.ts
 /** HTTP methods supported by API routes. */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
 /** Context passed to API route handlers. */
-export 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;
+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. */
-export type ApiHandler = (ctx: ApiContext) => Response | Promise<Response>;
+type ApiHandler = (ctx: ApiContext) => Response | Promise<Response>;
 /** An API route module — exports named HTTP method handlers. */
-export interface ApiRouteModule {
-    GET?: ApiHandler;
-    POST?: ApiHandler;
-    PUT?: ApiHandler;
-    PATCH?: ApiHandler;
-    DELETE?: ApiHandler;
-    HEAD?: ApiHandler;
-    OPTIONS?: ApiHandler;
+interface ApiRouteModule {
+  GET?: ApiHandler;
+  POST?: ApiHandler;
+  PUT?: ApiHandler;
+  PATCH?: ApiHandler;
+  DELETE?: ApiHandler;
+  HEAD?: ApiHandler;
+  OPTIONS?: ApiHandler;
 }
 /** A registered API route entry. */
-export interface ApiRouteEntry {
-    /** URL pattern (e.g., "/api/posts/:id"). */
-    pattern: string;
-    /** The route module with method handlers. */
-    module: ApiRouteModule;
+interface ApiRouteEntry {
+  /** URL pattern (e.g., "/api/posts/:id"). */
+  pattern: string;
+  /** The route module with method handlers. */
+  module: ApiRouteModule;
 }
 /**
  * Match a URL path against an API route pattern.
  * Returns extracted params or null if no match.
  */
-export declare function matchApiRoute(pattern: string, path: string): Record<string, string> | null;
+declare function matchApiRoute(pattern: string, path: string): Record<string, string> | null;
 /**
  * Create a middleware that dispatches API route requests.
  * API routes are matched by URL pattern and HTTP method.
  */
-export declare function createApiMiddleware(routes: ApiRouteEntry[]): Middleware;
+declare function createApiMiddleware(routes: ApiRouteEntry[]): Middleware;
 /**
  * Detect whether a route file is an API route.
  * API routes are `.ts` or `.js` files inside an `api/` directory.
  */
-export declare function isApiRoute(filePath: string): boolean;
+declare function isApiRoute(filePath: string): boolean;
 /**
  * Convert an API route file path to a URL pattern.
  *
@@ -57,10 +59,12 @@ export declare function isApiRoute(filePath: string): boolean;
  *   "api/posts/[id].ts"   → "/api/posts/:id"
  *   "api/[...path].ts"    → "/api/:path*"
  */
-export declare function apiFilePathToPattern(filePath: string): string;
+declare function apiFilePathToPattern(filePath: string): string;
 /**
  * Generate a virtual module that exports API route entries.
  * Each entry maps a URL pattern to a module with HTTP method handlers.
  */
-export declare function generateApiRouteModule(files: string[], routesDir: string): string;
-//# sourceMappingURL=api-routes.d.ts.map
+declare function generateApiRouteModule(files: string[], routesDir: string): string;
+//#endregion
+export { ApiContext, ApiHandler, ApiRouteEntry, ApiRouteModule, HttpMethod, apiFilePathToPattern, createApiMiddleware, generateApiRouteModule, isApiRoute, matchApiRoute };
+//# sourceMappingURL=api-routes2.d.ts.map