@pyreon/server 0.12.13 → 0.12.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
5386
5386
  </script>
5387
5387
  <script>
5388
5388
  /*<!--*/
5389
- const data = {"version":2,"tree":{"name":"root","children":[{"name":"client.js","children":[{"name":"src/client.ts","uid":"47a8e1af-1"}]}],"isRoot":true},"nodeParts":{"47a8e1af-1":{"renderedLength":4158,"gzipLength":1624,"brotliLength":0,"metaUid":"47a8e1af-0"}},"nodeMetas":{"47a8e1af-0":{"id":"/src/client.ts","moduleParts":{"client.js":"47a8e1af-1"},"imported":[{"uid":"47a8e1af-2"},{"uid":"47a8e1af-3"},{"uid":"47a8e1af-4"}],"importedBy":[],"isEntry":true},"47a8e1af-2":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"47a8e1af-0"}]},"47a8e1af-3":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"47a8e1af-0"}]},"47a8e1af-4":{"id":"@pyreon/runtime-dom","moduleParts":{},"imported":[],"importedBy":[{"uid":"47a8e1af-0"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
5389
+ const data = {"version":2,"tree":{"name":"root","children":[{"name":"client.js","children":[{"name":"src/client.ts","uid":"9000fe03-1"}]}],"isRoot":true},"nodeParts":{"9000fe03-1":{"renderedLength":4420,"gzipLength":1683,"brotliLength":0,"metaUid":"9000fe03-0"}},"nodeMetas":{"9000fe03-0":{"id":"/src/client.ts","moduleParts":{"client.js":"9000fe03-1"},"imported":[{"uid":"9000fe03-2"},{"uid":"9000fe03-3"},{"uid":"9000fe03-4"}],"importedBy":[],"isEntry":true},"9000fe03-2":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"9000fe03-0"}]},"9000fe03-3":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"9000fe03-0"}]},"9000fe03-4":{"id":"@pyreon/runtime-dom","moduleParts":{},"imported":[],"importedBy":[{"uid":"9000fe03-0"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
5390
5390
 
5391
5391
  const run = () => {
5392
5392
  const width = window.innerWidth;
@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
5386
5386
  </script>
5387
5387
  <script>
5388
5388
  /*<!--*/
5389
- const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","uid":"dc208be0-1"},{"name":"src","children":[{"uid":"dc208be0-3","name":"html.ts"},{"uid":"dc208be0-5","name":"middleware.ts"},{"uid":"dc208be0-7","name":"handler.ts"},{"uid":"dc208be0-9","name":"island.ts"},{"uid":"dc208be0-11","name":"ssg.ts"},{"uid":"dc208be0-13","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"dc208be0-1":{"renderedLength":2713,"gzipLength":1078,"brotliLength":0,"metaUid":"dc208be0-0"},"dc208be0-3":{"renderedLength":2797,"gzipLength":1166,"brotliLength":0,"metaUid":"dc208be0-2"},"dc208be0-5":{"renderedLength":1738,"gzipLength":835,"brotliLength":0,"metaUid":"dc208be0-4"},"dc208be0-7":{"renderedLength":3104,"gzipLength":1337,"brotliLength":0,"metaUid":"dc208be0-6"},"dc208be0-9":{"renderedLength":1444,"gzipLength":673,"brotliLength":0,"metaUid":"dc208be0-8"},"dc208be0-11":{"renderedLength":2806,"gzipLength":1214,"brotliLength":0,"metaUid":"dc208be0-10"},"dc208be0-13":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"dc208be0-12"}},"nodeMetas":{"dc208be0-0":{"id":"/home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","moduleParts":{"index.js":"dc208be0-1"},"imported":[{"uid":"dc208be0-14"},{"uid":"dc208be0-16"}],"importedBy":[{"uid":"dc208be0-6"}]},"dc208be0-2":{"id":"/src/html.ts","moduleParts":{"index.js":"dc208be0-3"},"imported":[],"importedBy":[{"uid":"dc208be0-12"},{"uid":"dc208be0-6"}]},"dc208be0-4":{"id":"/src/middleware.ts","moduleParts":{"index.js":"dc208be0-5"},"imported":[{"uid":"dc208be0-14"}],"importedBy":[{"uid":"dc208be0-12"},{"uid":"dc208be0-6"}]},"dc208be0-6":{"id":"/src/handler.ts","moduleParts":{"index.js":"dc208be0-7"},"imported":[{"uid":"dc208be0-14"},{"uid":"dc208be0-0"},{"uid":"dc208be0-15"},{"uid":"dc208be0-16"},{"uid":"dc208be0-2"},{"uid":"dc208be0-4"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-8":{"id":"/src/island.ts","moduleParts":{"index.js":"dc208be0-9"},"imported":[{"uid":"dc208be0-14"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-10":{"id":"/src/ssg.ts","moduleParts":{"index.js":"dc208be0-11"},"imported":[{"uid":"dc208be0-17"},{"uid":"dc208be0-18"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-12":{"id":"/src/index.ts","moduleParts":{"index.js":"dc208be0-13"},"imported":[{"uid":"dc208be0-6"},{"uid":"dc208be0-2"},{"uid":"dc208be0-8"},{"uid":"dc208be0-4"},{"uid":"dc208be0-10"}],"importedBy":[],"isEntry":true},"dc208be0-14":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"},{"uid":"dc208be0-8"},{"uid":"dc208be0-4"},{"uid":"dc208be0-0"}]},"dc208be0-15":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"}]},"dc208be0-16":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"},{"uid":"dc208be0-0"}]},"dc208be0-17":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-10"}]},"dc208be0-18":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-10"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
5389
+ const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","uid":"02c53f6e-1"},{"name":"src","children":[{"uid":"02c53f6e-3","name":"html.ts"},{"uid":"02c53f6e-5","name":"middleware.ts"},{"uid":"02c53f6e-7","name":"handler.ts"},{"uid":"02c53f6e-9","name":"island.ts"},{"uid":"02c53f6e-11","name":"ssg.ts"},{"uid":"02c53f6e-13","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"02c53f6e-1":{"renderedLength":2713,"gzipLength":1078,"brotliLength":0,"metaUid":"02c53f6e-0"},"02c53f6e-3":{"renderedLength":2790,"gzipLength":1162,"brotliLength":0,"metaUid":"02c53f6e-2"},"02c53f6e-5":{"renderedLength":1738,"gzipLength":835,"brotliLength":0,"metaUid":"02c53f6e-4"},"02c53f6e-7":{"renderedLength":3104,"gzipLength":1337,"brotliLength":0,"metaUid":"02c53f6e-6"},"02c53f6e-9":{"renderedLength":1444,"gzipLength":673,"brotliLength":0,"metaUid":"02c53f6e-8"},"02c53f6e-11":{"renderedLength":2806,"gzipLength":1214,"brotliLength":0,"metaUid":"02c53f6e-10"},"02c53f6e-13":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"02c53f6e-12"}},"nodeMetas":{"02c53f6e-0":{"id":"/home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","moduleParts":{"index.js":"02c53f6e-1"},"imported":[{"uid":"02c53f6e-14"},{"uid":"02c53f6e-16"}],"importedBy":[{"uid":"02c53f6e-6"}]},"02c53f6e-2":{"id":"/src/html.ts","moduleParts":{"index.js":"02c53f6e-3"},"imported":[],"importedBy":[{"uid":"02c53f6e-12"},{"uid":"02c53f6e-6"}]},"02c53f6e-4":{"id":"/src/middleware.ts","moduleParts":{"index.js":"02c53f6e-5"},"imported":[{"uid":"02c53f6e-14"}],"importedBy":[{"uid":"02c53f6e-12"},{"uid":"02c53f6e-6"}]},"02c53f6e-6":{"id":"/src/handler.ts","moduleParts":{"index.js":"02c53f6e-7"},"imported":[{"uid":"02c53f6e-14"},{"uid":"02c53f6e-0"},{"uid":"02c53f6e-15"},{"uid":"02c53f6e-16"},{"uid":"02c53f6e-2"},{"uid":"02c53f6e-4"}],"importedBy":[{"uid":"02c53f6e-12"}]},"02c53f6e-8":{"id":"/src/island.ts","moduleParts":{"index.js":"02c53f6e-9"},"imported":[{"uid":"02c53f6e-14"}],"importedBy":[{"uid":"02c53f6e-12"}]},"02c53f6e-10":{"id":"/src/ssg.ts","moduleParts":{"index.js":"02c53f6e-11"},"imported":[{"uid":"02c53f6e-17"},{"uid":"02c53f6e-18"}],"importedBy":[{"uid":"02c53f6e-12"}]},"02c53f6e-12":{"id":"/src/index.ts","moduleParts":{"index.js":"02c53f6e-13"},"imported":[{"uid":"02c53f6e-6"},{"uid":"02c53f6e-2"},{"uid":"02c53f6e-8"},{"uid":"02c53f6e-4"},{"uid":"02c53f6e-10"}],"importedBy":[],"isEntry":true},"02c53f6e-14":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"02c53f6e-6"},{"uid":"02c53f6e-8"},{"uid":"02c53f6e-4"},{"uid":"02c53f6e-0"}]},"02c53f6e-15":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"02c53f6e-6"}]},"02c53f6e-16":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"02c53f6e-6"},{"uid":"02c53f6e-0"}]},"02c53f6e-17":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"02c53f6e-10"}]},"02c53f6e-18":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"02c53f6e-10"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
5390
5390
 
5391
5391
  const run = () => {
5392
5392
  const width = window.innerWidth;
package/lib/client.js CHANGED
@@ -14,9 +14,10 @@ import { hydrateRoot, mount } from "@pyreon/runtime-dom";
14
14
  * Returns a cleanup function that unmounts the app.
15
15
  */
16
16
  function startClient(options) {
17
+ if (typeof document === "undefined") throw new Error("[Pyreon] startClient() can only be called in the browser.");
17
18
  const { App, routes, container = "#app" } = options;
18
19
  const el = typeof container === "string" ? document.querySelector(container) : container;
19
- if (!el) throw new Error(`[pyreon/client] Container "${container}" not found`);
20
+ if (!el) throw new Error(`[Pyreon] Container "${container}" not found`);
20
21
  const router = createRouter({
21
22
  routes,
22
23
  mode: "history"
@@ -44,6 +45,7 @@ function startClient(options) {
44
45
  * Returns a cleanup function that disconnects any pending observers/listeners.
45
46
  */
46
47
  function hydrateIslands(registry) {
48
+ if (typeof document === "undefined") return () => {};
47
49
  const islands = document.querySelectorAll("pyreon-island");
48
50
  const cleanups = [];
49
51
  for (const el of islands) {
@@ -63,6 +65,7 @@ function hydrateIslands(registry) {
63
65
  };
64
66
  }
65
67
  function scheduleHydration(el, loader, propsJson, strategy) {
68
+ if (typeof window === "undefined") return null;
66
69
  let cancelled = false;
67
70
  const hydrate = () => {
68
71
  if (!cancelled) hydrateIsland(el, loader, propsJson);
@@ -129,6 +132,7 @@ async function hydrateIsland(el, loader, propsJson) {
129
132
  }
130
133
  }
131
134
  function observeVisibility(el, callback) {
135
+ if (typeof window === "undefined") return null;
132
136
  if (!("IntersectionObserver" in window)) {
133
137
  callback();
134
138
  return null;
package/lib/client.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["/**\n * Client-side entry helpers for Pyreon SSR/SSG apps.\n *\n * ## Full app hydration\n *\n * ```ts\n * // entry-client.ts\n * import { startClient } from \"@pyreon/server/client\"\n * import { App } from \"./App\"\n * import { routes } from \"./routes\"\n *\n * startClient({ App, routes })\n * ```\n *\n * ## Island hydration (partial)\n *\n * ```ts\n * // entry-client.ts\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n * ```\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { createRouter, hydrateLoaderData, type RouteRecord, RouterProvider } from '@pyreon/router'\nimport { hydrateRoot, mount } from '@pyreon/runtime-dom'\nimport type { HydrationStrategy } from './island'\n\n// ─── Full app hydration ──────────────────────────────────────────────────────\n\nexport interface StartClientOptions {\n /** Root application component */\n App: ComponentFn\n /** Route definitions (same as server) */\n routes: RouteRecord[]\n /** CSS selector or element for the app container (default: \"#app\") */\n container?: string | Element\n}\n\n/**\n * Hydrate a server-rendered Pyreon app on the client.\n *\n * Handles:\n * - Router creation (history mode)\n * - Loader data hydration from `window.__PYREON_LOADER_DATA__`\n * - Hydration if container has SSR content, fresh mount otherwise\n *\n * Returns a cleanup function that unmounts the app.\n */\nexport function startClient(options: StartClientOptions): () => void {\n const { App, routes, container = '#app' } = options\n\n const el = typeof container === 'string' ? document.querySelector(container) : container\n\n if (!el) {\n throw new Error(`[pyreon/client] Container \"${container}\" not found`)\n }\n\n // Create client-side router (history mode to match SSR)\n const router = createRouter({ routes, mode: 'history' })\n\n // Hydrate loader data from SSR (avoids re-fetching on initial render)\n const loaderData = (window as unknown as Record<string, unknown>).__PYREON_LOADER_DATA__\n if (loaderData && typeof loaderData === 'object') {\n hydrateLoaderData(router as never, loaderData as Record<string, unknown>)\n }\n\n // Build app tree\n const app = h(RouterProvider, { router }, h(App, null))\n\n // Hydrate if container has SSR content, mount fresh otherwise\n if (el.childNodes.length > 0) {\n return hydrateRoot(el, app)\n }\n return mount(app, el as HTMLElement)\n}\n\n// ─── Island hydration ────────────────────────────────────────────────────────\n\ntype IslandLoader = () => Promise<{ default: ComponentFn } | ComponentFn>\n\n/**\n * Hydrate all `<pyreon-island>` elements on the page.\n *\n * Only loads JavaScript for components that are actually present in the HTML.\n * Respects hydration strategies (load, idle, visible, media, never).\n *\n * @example\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n */\n/**\n * Hydrate all `<pyreon-island>` elements on the page.\n * Returns a cleanup function that disconnects any pending observers/listeners.\n */\nexport function hydrateIslands(registry: Record<string, IslandLoader>): () => void {\n const islands = document.querySelectorAll('pyreon-island')\n const cleanups: (() => void)[] = []\n\n for (const el of islands) {\n const componentId = el.getAttribute('data-component')\n if (!componentId) continue\n\n const loader = registry[componentId]\n if (!loader) {\n console.warn(`No loader registered for island \"${componentId}\"`)\n continue\n }\n\n const strategy = (el.getAttribute('data-hydrate') ?? 'load') as HydrationStrategy\n const propsJson = el.getAttribute('data-props') ?? '{}'\n\n const cleanup = scheduleHydration(el as HTMLElement, loader, propsJson, strategy)\n if (cleanup) cleanups.push(cleanup)\n }\n\n return () => {\n for (const fn of cleanups) fn()\n }\n}\n\nfunction scheduleHydration(\n el: HTMLElement,\n loader: IslandLoader,\n propsJson: string,\n strategy: HydrationStrategy,\n): (() => void) | null {\n let cancelled = false\n const hydrate = () => {\n if (!cancelled) hydrateIsland(el, loader, propsJson)\n }\n\n switch (strategy) {\n case 'load':\n hydrate()\n return null\n\n case 'idle': {\n if ('requestIdleCallback' in window) {\n const id = requestIdleCallback(hydrate)\n return () => {\n cancelled = true\n cancelIdleCallback(id)\n }\n }\n const id = setTimeout(hydrate, 200)\n return () => {\n cancelled = true\n clearTimeout(id)\n }\n }\n\n case 'visible':\n return observeVisibility(el, hydrate)\n\n case 'never':\n return null\n\n default:\n // media(query)\n if (strategy.startsWith('media(')) {\n const query = strategy.slice(6, -1)\n const mql = window.matchMedia(query)\n if (mql.matches) {\n hydrate()\n return null\n }\n const onChange = (e: MediaQueryListEvent) => {\n if (e.matches) {\n mql.removeEventListener('change', onChange)\n hydrate()\n }\n }\n mql.addEventListener('change', onChange)\n return () => {\n cancelled = true\n mql.removeEventListener('change', onChange)\n }\n }\n hydrate()\n return null\n }\n}\n\nasync function hydrateIsland(\n el: HTMLElement,\n loader: IslandLoader,\n propsJson: string,\n): Promise<void> {\n const name = el.getAttribute('data-component') ?? 'unknown'\n try {\n let props: Record<string, unknown>\n try {\n props = JSON.parse(propsJson)\n if (typeof props !== 'object' || props === null || Array.isArray(props)) {\n throw new TypeError('Expected object')\n }\n } catch (parseErr) {\n console.error(`Invalid island props JSON for \"${name}\"`, parseErr)\n return\n }\n\n const mod = await loader()\n const Comp = typeof mod === 'function' ? mod : mod.default\n hydrateRoot(el, h(Comp, props))\n } catch (err) {\n console.error(`Failed to hydrate island \"${name}\"`, err)\n }\n}\n\nfunction observeVisibility(el: HTMLElement, callback: () => void): (() => void) | null {\n if (!('IntersectionObserver' in window)) {\n callback()\n return null\n }\n\n const observer = new IntersectionObserver(\n (entries) => {\n for (const entry of entries) {\n if (entry.isIntersecting) {\n observer.disconnect()\n callback()\n return\n }\n }\n },\n { rootMargin: '200px' },\n )\n\n observer.observe(el)\n return () => observer.disconnect()\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["/**\n * Client-side entry helpers for Pyreon SSR/SSG apps.\n *\n * ## Full app hydration\n *\n * ```ts\n * // entry-client.ts\n * import { startClient } from \"@pyreon/server/client\"\n * import { App } from \"./App\"\n * import { routes } from \"./routes\"\n *\n * startClient({ App, routes })\n * ```\n *\n * ## Island hydration (partial)\n *\n * ```ts\n * // entry-client.ts\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n * ```\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { createRouter, hydrateLoaderData, type RouteRecord, RouterProvider } from '@pyreon/router'\nimport { hydrateRoot, mount } from '@pyreon/runtime-dom'\nimport type { HydrationStrategy } from './island'\n\n// ─── Full app hydration ──────────────────────────────────────────────────────\n\nexport interface StartClientOptions {\n /** Root application component */\n App: ComponentFn\n /** Route definitions (same as server) */\n routes: RouteRecord[]\n /** CSS selector or element for the app container (default: \"#app\") */\n container?: string | Element\n}\n\n/**\n * Hydrate a server-rendered Pyreon app on the client.\n *\n * Handles:\n * - Router creation (history mode)\n * - Loader data hydration from `window.__PYREON_LOADER_DATA__`\n * - Hydration if container has SSR content, fresh mount otherwise\n *\n * Returns a cleanup function that unmounts the app.\n */\nexport function startClient(options: StartClientOptions): () => void {\n if (typeof document === 'undefined') {\n throw new Error('[Pyreon] startClient() can only be called in the browser.')\n }\n const { App, routes, container = '#app' } = options\n\n const el = typeof container === 'string' ? document.querySelector(container) : container\n\n if (!el) {\n throw new Error(`[Pyreon] Container \"${container}\" not found`)\n }\n\n // Create client-side router (history mode to match SSR)\n const router = createRouter({ routes, mode: 'history' })\n\n // Hydrate loader data from SSR (avoids re-fetching on initial render)\n const loaderData = (window as unknown as Record<string, unknown>).__PYREON_LOADER_DATA__\n if (loaderData && typeof loaderData === 'object') {\n hydrateLoaderData(router as never, loaderData as Record<string, unknown>)\n }\n\n // Build app tree\n const app = h(RouterProvider, { router }, h(App, null))\n\n // Hydrate if container has SSR content, mount fresh otherwise\n if (el.childNodes.length > 0) {\n return hydrateRoot(el, app)\n }\n return mount(app, el as HTMLElement)\n}\n\n// ─── Island hydration ────────────────────────────────────────────────────────\n\ntype IslandLoader = () => Promise<{ default: ComponentFn } | ComponentFn>\n\n/**\n * Hydrate all `<pyreon-island>` elements on the page.\n *\n * Only loads JavaScript for components that are actually present in the HTML.\n * Respects hydration strategies (load, idle, visible, media, never).\n *\n * @example\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n */\n/**\n * Hydrate all `<pyreon-island>` elements on the page.\n * Returns a cleanup function that disconnects any pending observers/listeners.\n */\nexport function hydrateIslands(registry: Record<string, IslandLoader>): () => void {\n if (typeof document === 'undefined') return () => {}\n const islands = document.querySelectorAll('pyreon-island')\n const cleanups: (() => void)[] = []\n\n for (const el of islands) {\n const componentId = el.getAttribute('data-component')\n if (!componentId) continue\n\n const loader = registry[componentId]\n if (!loader) {\n console.warn(`No loader registered for island \"${componentId}\"`)\n continue\n }\n\n const strategy = (el.getAttribute('data-hydrate') ?? 'load') as HydrationStrategy\n const propsJson = el.getAttribute('data-props') ?? '{}'\n\n const cleanup = scheduleHydration(el as HTMLElement, loader, propsJson, strategy)\n if (cleanup) cleanups.push(cleanup)\n }\n\n return () => {\n for (const fn of cleanups) fn()\n }\n}\n\nfunction scheduleHydration(\n el: HTMLElement,\n loader: IslandLoader,\n propsJson: string,\n strategy: HydrationStrategy,\n): (() => void) | null {\n if (typeof window === 'undefined') return null\n let cancelled = false\n const hydrate = () => {\n if (!cancelled) hydrateIsland(el, loader, propsJson)\n }\n\n switch (strategy) {\n case 'load':\n hydrate()\n return null\n\n case 'idle': {\n if ('requestIdleCallback' in window) {\n const id = requestIdleCallback(hydrate)\n return () => {\n cancelled = true\n cancelIdleCallback(id)\n }\n }\n const id = setTimeout(hydrate, 200)\n return () => {\n cancelled = true\n clearTimeout(id)\n }\n }\n\n case 'visible':\n return observeVisibility(el, hydrate)\n\n case 'never':\n return null\n\n default:\n // media(query)\n if (strategy.startsWith('media(')) {\n const query = strategy.slice(6, -1)\n const mql = window.matchMedia(query)\n if (mql.matches) {\n hydrate()\n return null\n }\n const onChange = (e: MediaQueryListEvent) => {\n if (e.matches) {\n mql.removeEventListener('change', onChange)\n hydrate()\n }\n }\n mql.addEventListener('change', onChange)\n return () => {\n cancelled = true\n mql.removeEventListener('change', onChange)\n }\n }\n hydrate()\n return null\n }\n}\n\nasync function hydrateIsland(\n el: HTMLElement,\n loader: IslandLoader,\n propsJson: string,\n): Promise<void> {\n const name = el.getAttribute('data-component') ?? 'unknown'\n try {\n let props: Record<string, unknown>\n try {\n props = JSON.parse(propsJson)\n if (typeof props !== 'object' || props === null || Array.isArray(props)) {\n throw new TypeError('Expected object')\n }\n } catch (parseErr) {\n console.error(`Invalid island props JSON for \"${name}\"`, parseErr)\n return\n }\n\n const mod = await loader()\n const Comp = typeof mod === 'function' ? mod : mod.default\n hydrateRoot(el, h(Comp, props))\n } catch (err) {\n console.error(`Failed to hydrate island \"${name}\"`, err)\n }\n}\n\nfunction observeVisibility(el: HTMLElement, callback: () => void): (() => void) | null {\n if (typeof window === 'undefined') return null\n if (!('IntersectionObserver' in window)) {\n callback()\n return null\n }\n\n const observer = new IntersectionObserver(\n (entries) => {\n for (const entry of entries) {\n if (entry.isIntersecting) {\n observer.disconnect()\n callback()\n return\n }\n }\n },\n { rootMargin: '200px' },\n )\n\n observer.observe(el)\n return () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsDA,SAAgB,YAAY,SAAyC;AACnE,KAAI,OAAO,aAAa,YACtB,OAAM,IAAI,MAAM,4DAA4D;CAE9E,MAAM,EAAE,KAAK,QAAQ,YAAY,WAAW;CAE5C,MAAM,KAAK,OAAO,cAAc,WAAW,SAAS,cAAc,UAAU,GAAG;AAE/E,KAAI,CAAC,GACH,OAAM,IAAI,MAAM,uBAAuB,UAAU,aAAa;CAIhE,MAAM,SAAS,aAAa;EAAE;EAAQ,MAAM;EAAW,CAAC;CAGxD,MAAM,aAAc,OAA8C;AAClE,KAAI,cAAc,OAAO,eAAe,SACtC,mBAAkB,QAAiB,WAAsC;CAI3E,MAAM,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,KAAK,KAAK,CAAC;AAGvD,KAAI,GAAG,WAAW,SAAS,EACzB,QAAO,YAAY,IAAI,IAAI;AAE7B,QAAO,MAAM,KAAK,GAAkB;;;;;;;;;;;;;;;;;;AAuBtC,SAAgB,eAAe,UAAoD;AACjF,KAAI,OAAO,aAAa,YAAa,cAAa;CAClD,MAAM,UAAU,SAAS,iBAAiB,gBAAgB;CAC1D,MAAM,WAA2B,EAAE;AAEnC,MAAK,MAAM,MAAM,SAAS;EACxB,MAAM,cAAc,GAAG,aAAa,iBAAiB;AACrD,MAAI,CAAC,YAAa;EAElB,MAAM,SAAS,SAAS;AACxB,MAAI,CAAC,QAAQ;AACX,WAAQ,KAAK,oCAAoC,YAAY,GAAG;AAChE;;EAGF,MAAM,WAAY,GAAG,aAAa,eAAe,IAAI;EAGrD,MAAM,UAAU,kBAAkB,IAAmB,QAFnC,GAAG,aAAa,aAAa,IAAI,MAEqB,SAAS;AACjF,MAAI,QAAS,UAAS,KAAK,QAAQ;;AAGrC,cAAa;AACX,OAAK,MAAM,MAAM,SAAU,KAAI;;;AAInC,SAAS,kBACP,IACA,QACA,WACA,UACqB;AACrB,KAAI,OAAO,WAAW,YAAa,QAAO;CAC1C,IAAI,YAAY;CAChB,MAAM,gBAAgB;AACpB,MAAI,CAAC,UAAW,eAAc,IAAI,QAAQ,UAAU;;AAGtD,SAAQ,UAAR;EACE,KAAK;AACH,YAAS;AACT,UAAO;EAET,KAAK,QAAQ;AACX,OAAI,yBAAyB,QAAQ;IACnC,MAAM,KAAK,oBAAoB,QAAQ;AACvC,iBAAa;AACX,iBAAY;AACZ,wBAAmB,GAAG;;;GAG1B,MAAM,KAAK,WAAW,SAAS,IAAI;AACnC,gBAAa;AACX,gBAAY;AACZ,iBAAa,GAAG;;;EAIpB,KAAK,UACH,QAAO,kBAAkB,IAAI,QAAQ;EAEvC,KAAK,QACH,QAAO;EAET;AAEE,OAAI,SAAS,WAAW,SAAS,EAAE;IACjC,MAAM,QAAQ,SAAS,MAAM,GAAG,GAAG;IACnC,MAAM,MAAM,OAAO,WAAW,MAAM;AACpC,QAAI,IAAI,SAAS;AACf,cAAS;AACT,YAAO;;IAET,MAAM,YAAY,MAA2B;AAC3C,SAAI,EAAE,SAAS;AACb,UAAI,oBAAoB,UAAU,SAAS;AAC3C,eAAS;;;AAGb,QAAI,iBAAiB,UAAU,SAAS;AACxC,iBAAa;AACX,iBAAY;AACZ,SAAI,oBAAoB,UAAU,SAAS;;;AAG/C,YAAS;AACT,UAAO;;;AAIb,eAAe,cACb,IACA,QACA,WACe;CACf,MAAM,OAAO,GAAG,aAAa,iBAAiB,IAAI;AAClD,KAAI;EACF,IAAI;AACJ,MAAI;AACF,WAAQ,KAAK,MAAM,UAAU;AAC7B,OAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,MAAM,CACrE,OAAM,IAAI,UAAU,kBAAkB;WAEjC,UAAU;AACjB,WAAQ,MAAM,kCAAkC,KAAK,IAAI,SAAS;AAClE;;EAGF,MAAM,MAAM,MAAM,QAAQ;AAE1B,cAAY,IAAI,EADH,OAAO,QAAQ,aAAa,MAAM,IAAI,SAC3B,MAAM,CAAC;UACxB,KAAK;AACZ,UAAQ,MAAM,6BAA6B,KAAK,IAAI,IAAI;;;AAI5D,SAAS,kBAAkB,IAAiB,UAA2C;AACrF,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI,EAAE,0BAA0B,SAAS;AACvC,YAAU;AACV,SAAO;;CAGT,MAAM,WAAW,IAAI,sBAClB,YAAY;AACX,OAAK,MAAM,SAAS,QAClB,KAAI,MAAM,gBAAgB;AACxB,YAAS,YAAY;AACrB,aAAU;AACV;;IAIN,EAAE,YAAY,SAAS,CACxB;AAED,UAAS,QAAQ,GAAG;AACpB,cAAa,SAAS,YAAY"}
package/lib/index.js CHANGED
@@ -125,7 +125,7 @@ const DEFAULT_TEMPLATE = `<!DOCTYPE html>
125
125
  </body>
126
126
  </html>`;
127
127
  function compileTemplate(template) {
128
- if (!template.includes("<!--pyreon-app-->")) throw new Error("[pyreon/server] Template must contain <!--pyreon-app--> placeholder");
128
+ if (!template.includes("<!--pyreon-app-->")) throw new Error("[Pyreon] Template must contain <!--pyreon-app--> placeholder");
129
129
  const [beforeHead, afterHead] = splitOnce(template, "<!--pyreon-head-->");
130
130
  const [betweenHeadApp, afterApp] = splitOnce(afterHead, "<!--pyreon-app-->");
131
131
  const [betweenAppScripts, afterScripts] = splitOnce(afterApp, "<!--pyreon-scripts-->");
package/lib/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../../head/lib/ssr.js","../src/html.ts","../src/middleware.ts","../src/handler.ts","../src/island.ts","../src/ssg.ts"],"sourcesContent":["import { createContext, h, pushContext } from \"@pyreon/core\";\nimport { renderToString } from \"@pyreon/runtime-server\";\n\n//#region src/context.ts\nfunction createHeadContext() {\n\tconst map = /* @__PURE__ */ new Map();\n\tlet dirty = true;\n\tlet cachedTags = [];\n\tlet cachedTitleTemplate;\n\tlet cachedHtmlAttrs = {};\n\tlet cachedBodyAttrs = {};\n\tfunction rebuild() {\n\t\tif (!dirty) return;\n\t\tdirty = false;\n\t\tconst keyed = /* @__PURE__ */ new Map();\n\t\tconst unkeyed = [];\n\t\tlet titleTemplate;\n\t\tconst htmlAttrs = {};\n\t\tconst bodyAttrs = {};\n\t\tfor (const entry of map.values()) {\n\t\t\tfor (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);\n\t\t\telse unkeyed.push(tag);\n\t\t\tif (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;\n\t\t\tif (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);\n\t\t\tif (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);\n\t\t}\n\t\tcachedTags = [...keyed.values(), ...unkeyed];\n\t\tcachedTitleTemplate = titleTemplate;\n\t\tcachedHtmlAttrs = htmlAttrs;\n\t\tcachedBodyAttrs = bodyAttrs;\n\t}\n\treturn {\n\t\tadd(id, entry) {\n\t\t\tmap.set(id, entry);\n\t\t\tdirty = true;\n\t\t},\n\t\tremove(id) {\n\t\t\tmap.delete(id);\n\t\t\tdirty = true;\n\t\t},\n\t\tresolve() {\n\t\t\trebuild();\n\t\t\treturn cachedTags;\n\t\t},\n\t\tresolveTitleTemplate() {\n\t\t\trebuild();\n\t\t\treturn cachedTitleTemplate;\n\t\t},\n\t\tresolveHtmlAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedHtmlAttrs;\n\t\t},\n\t\tresolveBodyAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedBodyAttrs;\n\t\t}\n\t};\n}\nconst HeadContext = createContext(null);\n\n//#endregion\n//#region src/ssr.ts\nconst VOID_TAGS = new Set([\n\t\"meta\",\n\t\"link\",\n\t\"base\"\n]);\nasync function renderWithHead(app) {\n\tconst ctx = createHeadContext();\n\tfunction HeadInjector() {\n\t\tpushContext(new Map([[HeadContext.id, ctx]]));\n\t\treturn app;\n\t}\n\tconst html = await renderToString(h(HeadInjector, null));\n\tconst titleTemplate = ctx.resolveTitleTemplate();\n\treturn {\n\t\thtml,\n\t\thead: ctx.resolve().map((tag) => serializeTag(tag, titleTemplate)).join(\"\\n \"),\n\t\thtmlAttrs: ctx.resolveHtmlAttrs(),\n\t\tbodyAttrs: ctx.resolveBodyAttrs()\n\t};\n}\nfunction serializeTag(tag, titleTemplate) {\n\tif (tag.tag === \"title\") {\n\t\tconst raw = tag.children || \"\";\n\t\treturn `<title>${esc(titleTemplate ? typeof titleTemplate === \"function\" ? titleTemplate(raw) : titleTemplate.replace(/%s/g, raw) : raw)}</title>`;\n\t}\n\tconst props = tag.props;\n\tconst attrs = props ? Object.entries(props).map(([k, v]) => `${k}=\"${esc(v)}\"`).join(\" \") : \"\";\n\tconst open = attrs ? `<${tag.tag} ${attrs}` : `<${tag.tag}`;\n\tif (VOID_TAGS.has(tag.tag)) return `${open} />`;\n\treturn `${open}>${(tag.children || \"\").replace(/<\\/(script|style|noscript)/gi, \"<\\\\/$1\").replace(/<!--/g, \"<\\\\!--\")}</${tag.tag}>`;\n}\nconst ESC_RE = /[&<>\"]/g;\nconst ESC_MAP = {\n\t\"&\": \"&amp;\",\n\t\"<\": \"&lt;\",\n\t\">\": \"&gt;\",\n\t\"\\\"\": \"&quot;\"\n};\nfunction esc(s) {\n\treturn ESC_RE.test(s) ? s.replace(ESC_RE, (ch) => ESC_MAP[ch]) : s;\n}\n\n//#endregion\nexport { renderWithHead };\n//# sourceMappingURL=ssr.js.map","/**\n * HTML template processing for SSR/SSG.\n *\n * Templates use comment placeholders:\n * <!--pyreon-head--> — replaced with <head> tags (title, meta, link, etc.)\n * <!--pyreon-app--> — replaced with rendered application HTML\n * <!--pyreon-scripts--> — replaced with client entry script + inline loader data\n */\n\nexport const DEFAULT_TEMPLATE = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <!--pyreon-head-->\n</head>\n<body>\n <div id=\"app\"><!--pyreon-app--></div>\n <!--pyreon-scripts-->\n</body>\n</html>`\n\nexport interface TemplateData {\n head: string\n app: string\n scripts: string\n}\n\n/**\n * Pre-compiled template — splits the template string once so that\n * each request only concatenates 6 parts instead of scanning 3x with `.replace()`.\n */\nexport interface CompiledTemplate {\n /** [before-head, between-head-app, between-app-scripts, after-scripts] */\n parts: [string, string, string, string]\n}\n\nexport function compileTemplate(template: string): CompiledTemplate {\n if (!template.includes('<!--pyreon-app-->')) {\n throw new Error('[pyreon/server] Template must contain <!--pyreon-app--> placeholder')\n }\n const [beforeHead, afterHead] = splitOnce(template, '<!--pyreon-head-->')\n const [betweenHeadApp, afterApp] = splitOnce(afterHead, '<!--pyreon-app-->')\n const [betweenAppScripts, afterScripts] = splitOnce(afterApp, '<!--pyreon-scripts-->')\n return { parts: [beforeHead, betweenHeadApp, betweenAppScripts, afterScripts] }\n}\n\nfunction splitOnce(str: string, delimiter: string): [string, string] {\n const idx = str.indexOf(delimiter)\n if (idx === -1) return [str, '']\n return [str.slice(0, idx), str.slice(idx + delimiter.length)]\n}\n\nexport function processTemplate(template: string, data: TemplateData): string {\n return template\n .replace('<!--pyreon-head-->', data.head)\n .replace('<!--pyreon-app-->', data.app)\n .replace('<!--pyreon-scripts-->', data.scripts)\n}\n\n/** Fast path using a pre-compiled template */\nexport function processCompiledTemplate(compiled: CompiledTemplate, data: TemplateData): string {\n const [p0, p1, p2, p3] = compiled.parts\n return p0 + data.head + p1 + data.app + p2 + data.scripts + p3\n}\n\n/**\n * Build the script tags for client hydration.\n *\n * Emits:\n * 1. Inline script with serialized loader data (if any)\n * 2. Module script tag pointing to the client entry\n */\nexport function buildScripts(\n clientEntry: string,\n loaderData: Record<string, unknown> | null,\n): string {\n const parts: string[] = []\n\n if (loaderData && Object.keys(loaderData).length > 0) {\n // Escape </script> inside JSON to prevent premature tag close\n const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n parts.push(`<script>window.__PYREON_LOADER_DATA__=${json}</script>`)\n }\n\n parts.push(`<script type=\"module\" src=\"${clientEntry}\"></script>`)\n\n return parts.join('\\n ')\n}\n\n/** Pre-build the static client entry script tag (invariant across requests) */\nexport function buildClientEntryTag(clientEntry: string): string {\n return `<script type=\"module\" src=\"${clientEntry}\"></script>`\n}\n\n/** Fast path: build scripts with a pre-built client entry tag */\nexport function buildScriptsFast(\n clientEntryTag: string,\n loaderData: Record<string, unknown> | null,\n): string {\n if (loaderData && Object.keys(loaderData).length > 0) {\n const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n return `<script>window.__PYREON_LOADER_DATA__=${json}</script>\\n ${clientEntryTag}`\n }\n return clientEntryTag\n}\n","/**\n * SSR middleware — simple request processing pipeline.\n *\n * Middleware runs before rendering. Return a Response to short-circuit\n * (e.g. for redirects, auth checks, or static file serving).\n * Return void / undefined to continue to the next middleware or rendering.\n *\n * @example\n * const authMiddleware: Middleware = async (ctx) => {\n * const token = ctx.req.headers.get(\"Authorization\")\n * if (!token) return new Response(\"Unauthorized\", { status: 401 })\n * ctx.locals.user = await verifyToken(token)\n * }\n *\n * const handler = createHandler({\n * App,\n * routes,\n * middleware: [authMiddleware],\n * })\n */\n\nimport { createContext, useContext, provide } from '@pyreon/core'\n\nexport interface MiddlewareContext {\n /** The incoming request */\n req: Request\n /** Parsed URL */\n url: URL\n /** Pathname + search (passed to router) */\n path: string\n /** Response headers — middleware can set custom headers */\n headers: Headers\n /** Arbitrary per-request data shared between middleware and components */\n locals: Record<string, unknown>\n}\n\n/**\n * Middleware function. Return a Response to short-circuit, or void to continue.\n */\nexport type Middleware = (ctx: MiddlewareContext) => Response | void | Promise<Response | void>\n\n/**\n * Context for per-request locals — populated by the SSR handler from\n * middleware `ctx.locals`. Components access it via `useRequestLocals()`.\n *\n * This bridges the middleware → component gap: middleware sets `ctx.locals`,\n * the handler provides it into the Pyreon context system, and components\n * read it without coupling to the middleware layer.\n */\nexport const RequestLocalsCtx = createContext<Record<string, unknown>>({})\n\n/**\n * Read per-request locals inside a component (SSR only).\n *\n * Returns the `ctx.locals` object populated by middleware.\n * On the client, returns an empty object.\n *\n * @example\n * ```tsx\n * import { useRequestLocals } from \"@pyreon/server\"\n *\n * function MyComponent() {\n * const locals = useRequestLocals()\n * const nonce = locals.cspNonce as string ?? ''\n * return <script nonce={nonce}>...</script>\n * }\n * ```\n */\nexport function useRequestLocals(): Record<string, unknown> {\n return useContext(RequestLocalsCtx)\n}\n\n/**\n * Provide request locals into the component tree.\n * Called by the SSR handler — not for direct use.\n * @internal\n */\nexport function provideRequestLocals(locals: Record<string, unknown>): void {\n provide(RequestLocalsCtx, locals)\n}\n","/**\n * SSR request handler.\n *\n * Creates a Web-standard `(Request) => Promise<Response>` handler that:\n * 1. Runs middleware (auth, redirects, headers, etc.)\n * 2. Creates a per-request router with the matched URL\n * 3. Prefetches loader data for matched routes\n * 4. Renders the app to HTML with head tag collection\n * 5. Injects everything into an HTML template\n * 6. Returns a Response\n *\n * Compatible with Bun.serve, Deno.serve, Cloudflare Workers,\n * Express (via adapter), and any Web-standard server.\n *\n * @example\n * import { createHandler } from \"@pyreon/server\"\n *\n * const handler = createHandler({\n * App,\n * routes,\n * template: await Bun.file(\"index.html\").text(),\n * })\n *\n * Bun.serve({ fetch: handler })\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { renderWithHead } from '@pyreon/head/ssr'\nimport {\n createRouter,\n prefetchLoaderData,\n type RouteRecord,\n RouterProvider,\n serializeLoaderData,\n} from '@pyreon/router'\nimport { renderToStream, runWithRequestContext } from '@pyreon/runtime-server'\nimport {\n buildClientEntryTag,\n buildScriptsFast,\n type CompiledTemplate,\n compileTemplate,\n DEFAULT_TEMPLATE,\n processCompiledTemplate,\n} from './html'\nimport type { Middleware, MiddlewareContext } from './middleware'\nimport { provideRequestLocals } from './middleware'\n\nconst __DEV__ = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface HandlerOptions {\n /** Root application component */\n App: ComponentFn\n /** Route definitions */\n routes: RouteRecord[]\n /**\n * HTML template with placeholders:\n * <!--pyreon-head--> — head tags (title, meta, link, etc.)\n * <!--pyreon-app--> — rendered app HTML\n * <!--pyreon-scripts--> — client entry + loader data\n *\n * Defaults to a minimal HTML5 template.\n */\n template?: string\n /** Path to the client entry module (default: \"/src/entry-client.ts\") */\n clientEntry?: string\n /** Middleware chain — runs before rendering */\n middleware?: Middleware[]\n /**\n * Rendering mode:\n * \"string\" (default) — full renderToString, complete HTML in one response\n * \"stream\" — progressive streaming via renderToStream (Suspense out-of-order)\n */\n mode?: 'string' | 'stream'\n /**\n * Collect CSS styles after rendering. Called after renderToString/renderWithHead.\n * Return a `<style>` tag string to inject into `<head>`.\n * Used by @pyreon/styler's sheet.getStyleTag() to prevent FOUC in SSG.\n *\n * @example\n * import { sheet } from '@pyreon/styler'\n * createHandler({\n * collectStyles: () => {\n * const tag = sheet.getStyleTag()\n * sheet.reset()\n * return tag\n * },\n * })\n */\n collectStyles?: () => string\n}\n\nexport function createHandler(options: HandlerOptions): (req: Request) => Promise<Response> {\n const {\n App,\n routes,\n template = DEFAULT_TEMPLATE,\n clientEntry = '/src/entry-client.ts',\n middleware = [],\n mode = 'string',\n collectStyles,\n } = options\n\n // Pre-compile once at handler creation — avoids 3x string scan per request\n const compiled = compileTemplate(template)\n const clientEntryTag = buildClientEntryTag(clientEntry)\n\n return async function handler(req: Request): Promise<Response> {\n const url = new URL(req.url)\n const path = url.pathname + url.search\n\n // ── Middleware pipeline ────────────────────────────────────────────────────\n const ctx: MiddlewareContext = {\n req,\n url,\n path,\n headers: new Headers({ 'Content-Type': 'text/html; charset=utf-8' }),\n locals: {},\n }\n\n for (const mw of middleware) {\n const result = await mw(ctx)\n if (result instanceof Response) return result\n }\n\n // ── Per-request router ────────────────────────────────────────────────────\n const router = createRouter({ routes, mode: 'history', url: path })\n\n return runWithRequestContext(async () => {\n try {\n // Bridge middleware locals → Pyreon context system so components\n // can access per-request data (CSP nonce, auth user, etc.)\n provideRequestLocals(ctx.locals)\n\n // Pre-run loaders so data is available during render\n await prefetchLoaderData(router as never, path)\n\n // Build the VNode tree\n const app = h(RouterProvider, { router }, h(App, null))\n\n if (mode === 'stream') {\n return renderStreamResponse(app, router, compiled, clientEntryTag, ctx.headers)\n }\n\n // ── String mode (default) ─────────────────────────────────────────────\n const { html: appHtml, head } = await renderWithHead(app)\n\n // Collect CSS-in-JS styles if a collector was provided.\n // The consumer passes collectStyles (e.g. sheet.getStyleTag from @pyreon/styler)\n // to inject scoped CSS into <head> and prevent FOUC in SSG pages.\n const styleTag = collectStyles ? collectStyles() : ''\n\n const loaderData = serializeLoaderData(router as never)\n const scripts = buildScriptsFast(clientEntryTag, loaderData)\n const headWithStyles = styleTag ? `${styleTag}\\n${head}` : head\n const fullHtml = processCompiledTemplate(compiled, { head: headWithStyles, app: appHtml, scripts })\n\n return new Response(fullHtml, { status: 200, headers: ctx.headers })\n } catch (err) {\n if (__DEV__) {\n console.error('[Pyreon Server] SSR render failed:', err)\n }\n return new Response('Internal Server Error', {\n status: 500,\n headers: { 'Content-Type': 'text/plain' },\n })\n }\n })\n }\n}\n\n/**\n * Streaming mode: shell is emitted immediately, app content streams progressively.\n *\n * Head tags from the initial synchronous render are included in the shell.\n * Suspense boundaries resolve out-of-order via inline <template> + swap scripts.\n */\nasync function renderStreamResponse(\n app: ReturnType<typeof h>,\n router: ReturnType<typeof createRouter>,\n compiled: CompiledTemplate,\n clientEntryTag: string,\n extraHeaders: Headers,\n): Promise<Response> {\n const loaderData = serializeLoaderData(router as never)\n const scripts = buildScriptsFast(clientEntryTag, loaderData)\n\n // Use pre-split parts: [before-head, between-head-app, between-app-scripts, after-scripts]\n const [p0, p1, p2, p3] = compiled.parts\n const shellHead = p0 + p1\n const shellTail = p2 + scripts + p3\n\n const appStream = renderToStream(app)\n const reader = appStream.getReader()\n\n const stream = new ReadableStream<Uint8Array>({\n async start(controller) {\n const encoder = new TextEncoder()\n const push = (s: string) => controller.enqueue(encoder.encode(s))\n\n try {\n push(shellHead)\n\n // Stream app content\n let done = false\n while (!done) {\n const result = await reader.read()\n done = result.done\n if (result.value) push(result.value)\n }\n\n push(shellTail)\n } catch (err) {\n if (__DEV__) {\n console.error('[Pyreon Server] Stream render failed:', err)\n }\n // Emit an inline error indicator — status code is already sent (200)\n push(`<script>console.error(\"[pyreon/server] Stream render failed\")</script>`)\n push(shellTail)\n } finally {\n controller.close()\n }\n },\n })\n\n return new Response(stream, {\n status: 200,\n headers: extraHeaders,\n })\n}\n","/**\n * Island architecture — partial hydration for content-heavy sites.\n *\n * Islands are interactive components embedded in otherwise-static HTML.\n * Only island components ship JavaScript to the client — the rest of the\n * page stays as zero-JS server-rendered HTML.\n *\n * ## Server side\n *\n * `island()` wraps an async component import and returns a ComponentFn.\n * During SSR, it renders the component output inside a `<pyreon-island>` element\n * with serialized props, so the client knows what to hydrate.\n *\n * ```tsx\n * import { island } from \"@pyreon/server\"\n *\n * const Counter = island(() => import(\"./Counter\"), { name: \"Counter\" })\n * const Search = island(() => import(\"./Search\"), { name: \"Search\" })\n *\n * function Page() {\n * return <div>\n * <h1>Static heading (no JS)</h1>\n * <Counter initial={5} /> // hydrated on client\n * <p>Static paragraph</p>\n * <Search /> // hydrated on client\n * </div>\n * }\n * ```\n *\n * ## Client side\n *\n * Use `hydrateIslands()` from `@pyreon/server/client` to hydrate all islands\n * on the page. Only the island components' JavaScript is loaded.\n *\n * ```ts\n * // entry-client.ts (island mode)\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n * ```\n *\n * ## Hydration strategies\n *\n * Control when an island hydrates via the `hydrate` option:\n * - \"load\" (default) — hydrate immediately on page load\n * - \"idle\" — hydrate when the browser is idle (requestIdleCallback)\n * - \"visible\" — hydrate when the island scrolls into the viewport\n * - \"media(query)\" — hydrate when a media query matches\n * - \"never\" — never hydrate (render-only, no client JS)\n */\n\nimport type { ComponentFn, Props, VNode } from '@pyreon/core'\nimport { h } from '@pyreon/core'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type HydrationStrategy = 'load' | 'idle' | 'visible' | 'never' | `media(${string})`\n\nexport interface IslandOptions {\n /** Unique name — must match the key in the client-side hydrateIslands() registry */\n name: string\n /** When to hydrate on the client (default: \"load\") */\n hydrate?: HydrationStrategy\n}\n\nexport interface IslandMeta {\n readonly __island: true\n readonly name: string\n readonly hydrate: HydrationStrategy\n}\n\n// ─── Server-side island factory ──────────────────────────────────────────────\n\n/**\n * Create an island component.\n *\n * Returns an async ComponentFn that:\n * 1. Resolves the dynamic import\n * 2. Renders the component to VNodes\n * 3. Wraps the output in `<pyreon-island>` with serialized props + hydration strategy\n */\nexport function island<P extends Props = Props>(\n loader: () => Promise<{ default: ComponentFn<P> } | ComponentFn<P>>,\n options: IslandOptions,\n): ComponentFn<P> & IslandMeta {\n const { name, hydrate = 'load' } = options\n\n const IslandWrapper = async function IslandWrapper(props: P): Promise<VNode | null> {\n const mod = await loader()\n const Comp = typeof mod === 'function' ? mod : mod.default\n const serializedProps = serializeIslandProps(props)\n\n return h(\n 'pyreon-island',\n {\n 'data-component': name,\n 'data-props': serializedProps,\n 'data-hydrate': hydrate,\n },\n h(Comp, props),\n )\n }\n\n // Attach metadata so the Vite plugin can detect islands for code-splitting\n const wrapper = IslandWrapper as unknown as ComponentFn<P> & IslandMeta\n Object.defineProperties(wrapper, {\n __island: { value: true, enumerable: true },\n name: { value: name, enumerable: true, writable: false, configurable: true },\n hydrate: { value: hydrate, enumerable: true },\n })\n\n return wrapper\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Serialize component props to a JSON string for embedding in HTML attributes.\n * Strips non-serializable values (functions, symbols, children).\n */\nfunction serializeIslandProps(props: Record<string, unknown>): string {\n const clean: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(props)) {\n // Skip non-serializable or internal props\n if (key === 'children') continue\n if (typeof value === 'function') continue\n if (typeof value === 'symbol') continue\n if (value === undefined) continue\n clean[key] = value\n }\n // The SSR renderer's renderProp() already applies escapeHtml() to attribute\n // values, so the JSON is safe to embed in HTML attributes without double-escaping.\n return JSON.stringify(clean)\n}\n","/**\n * Static Site Generation — pre-render routes to HTML files at build time.\n *\n * @example\n * // ssg.ts (run with: bun run ssg.ts)\n * import { createHandler } from \"@pyreon/server\"\n * import { prerender } from \"@pyreon/server\"\n * import { App } from \"./src/App\"\n * import { routes } from \"./src/routes\"\n *\n * const handler = createHandler({ App, routes })\n *\n * await prerender({\n * handler,\n * paths: [\"/\", \"/about\", \"/blog\", \"/blog/hello-world\"],\n * outDir: \"dist\",\n * })\n *\n * @example\n * // Dynamic paths from a CMS or filesystem\n * await prerender({\n * handler,\n * paths: async () => {\n * const posts = await fetchAllPosts()\n * return [\"/\", \"/about\", ...posts.map(p => `/blog/${p.slug}`)]\n * },\n * outDir: \"dist\",\n * })\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\n\nexport interface PrerenderOptions {\n /** SSR handler created by createHandler() */\n handler: (req: Request) => Promise<Response>\n /** Routes to pre-render — array of URL paths or async function that returns them */\n paths: string[] | (() => string[] | Promise<string[]>)\n /** Output directory for the generated HTML files */\n outDir: string\n /** Origin for constructing full URLs (default: \"http://localhost\") */\n origin?: string\n /**\n * Called after each page is rendered — use for logging or progress tracking.\n * Return false to skip writing this page.\n */\n onPage?: (path: string, html: string) => void | boolean | Promise<void | boolean>\n}\n\nexport interface PrerenderResult {\n /** Number of pages generated */\n pages: number\n /** Paths that failed to render */\n errors: { path: string; error: unknown }[]\n /** Total elapsed time in milliseconds */\n elapsed: number\n}\n\n/**\n * Pre-render a list of routes to static HTML files.\n *\n * For each path:\n * 1. Constructs a Request for the path\n * 2. Calls the SSR handler to render to HTML\n * 3. Writes the HTML to `outDir/<path>/index.html`\n *\n * The root path \"/\" becomes `outDir/index.html`.\n * Paths like \"/about\" become `outDir/about/index.html`.\n */\nexport async function prerender(options: PrerenderOptions): Promise<PrerenderResult> {\n const { handler, outDir, origin = 'http://localhost', onPage } = options\n\n const start = Date.now()\n\n // Resolve paths (may be async)\n const paths = typeof options.paths === 'function' ? await options.paths() : options.paths\n\n let pages = 0\n const errors: PrerenderResult['errors'] = []\n\n async function renderPage(path: string): Promise<void> {\n const url = new URL(path, origin)\n const req = new Request(url.href)\n const res = await Promise.race([\n handler(req),\n new Promise<never>((_, reject) =>\n setTimeout(() => reject(new Error(`Prerender timeout for \"${path}\" (30s)`)), 30_000),\n ),\n ])\n\n if (!res.ok) {\n errors.push({ path, error: new Error(`HTTP ${res.status}`) })\n return\n }\n\n const html = await res.text()\n\n if (onPage) {\n const result = await onPage(path, html)\n if (result === false) return\n }\n\n const filePath = resolveOutputPath(outDir, path)\n\n const resolvedOut = resolve(outDir)\n if (!resolve(filePath).startsWith(resolvedOut)) {\n errors.push({ path, error: new Error(`Path traversal detected: \"${path}\"`) })\n return\n }\n\n await mkdir(dirname(filePath), { recursive: true })\n await writeFile(filePath, html, 'utf-8')\n pages++\n }\n\n // Process paths concurrently (batch of 10 to avoid overwhelming)\n const BATCH_SIZE = 10\n for (let i = 0; i < paths.length; i += BATCH_SIZE) {\n const batch = paths.slice(i, i + BATCH_SIZE)\n await Promise.all(\n batch.map(async (path) => {\n try {\n await renderPage(path)\n } catch (error) {\n errors.push({ path, error })\n }\n }),\n )\n }\n\n return {\n pages,\n errors,\n elapsed: Date.now() - start,\n }\n}\n\nfunction resolveOutputPath(outDir: string, path: string): string {\n if (path === '/') return join(outDir, 'index.html')\n if (path.endsWith('.html')) return join(outDir, path)\n return join(outDir, path, 'index.html')\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../head/lib/ssr.js","../src/html.ts","../src/middleware.ts","../src/handler.ts","../src/island.ts","../src/ssg.ts"],"sourcesContent":["import { createContext, h, pushContext } from \"@pyreon/core\";\nimport { renderToString } from \"@pyreon/runtime-server\";\n\n//#region src/context.ts\nfunction createHeadContext() {\n\tconst map = /* @__PURE__ */ new Map();\n\tlet dirty = true;\n\tlet cachedTags = [];\n\tlet cachedTitleTemplate;\n\tlet cachedHtmlAttrs = {};\n\tlet cachedBodyAttrs = {};\n\tfunction rebuild() {\n\t\tif (!dirty) return;\n\t\tdirty = false;\n\t\tconst keyed = /* @__PURE__ */ new Map();\n\t\tconst unkeyed = [];\n\t\tlet titleTemplate;\n\t\tconst htmlAttrs = {};\n\t\tconst bodyAttrs = {};\n\t\tfor (const entry of map.values()) {\n\t\t\tfor (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);\n\t\t\telse unkeyed.push(tag);\n\t\t\tif (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;\n\t\t\tif (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);\n\t\t\tif (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);\n\t\t}\n\t\tcachedTags = [...keyed.values(), ...unkeyed];\n\t\tcachedTitleTemplate = titleTemplate;\n\t\tcachedHtmlAttrs = htmlAttrs;\n\t\tcachedBodyAttrs = bodyAttrs;\n\t}\n\treturn {\n\t\tadd(id, entry) {\n\t\t\tmap.set(id, entry);\n\t\t\tdirty = true;\n\t\t},\n\t\tremove(id) {\n\t\t\tmap.delete(id);\n\t\t\tdirty = true;\n\t\t},\n\t\tresolve() {\n\t\t\trebuild();\n\t\t\treturn cachedTags;\n\t\t},\n\t\tresolveTitleTemplate() {\n\t\t\trebuild();\n\t\t\treturn cachedTitleTemplate;\n\t\t},\n\t\tresolveHtmlAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedHtmlAttrs;\n\t\t},\n\t\tresolveBodyAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedBodyAttrs;\n\t\t}\n\t};\n}\nconst HeadContext = createContext(null);\n\n//#endregion\n//#region src/ssr.ts\nconst VOID_TAGS = new Set([\n\t\"meta\",\n\t\"link\",\n\t\"base\"\n]);\nasync function renderWithHead(app) {\n\tconst ctx = createHeadContext();\n\tfunction HeadInjector() {\n\t\tpushContext(new Map([[HeadContext.id, ctx]]));\n\t\treturn app;\n\t}\n\tconst html = await renderToString(h(HeadInjector, null));\n\tconst titleTemplate = ctx.resolveTitleTemplate();\n\treturn {\n\t\thtml,\n\t\thead: ctx.resolve().map((tag) => serializeTag(tag, titleTemplate)).join(\"\\n \"),\n\t\thtmlAttrs: ctx.resolveHtmlAttrs(),\n\t\tbodyAttrs: ctx.resolveBodyAttrs()\n\t};\n}\nfunction serializeTag(tag, titleTemplate) {\n\tif (tag.tag === \"title\") {\n\t\tconst raw = tag.children || \"\";\n\t\treturn `<title>${esc(titleTemplate ? typeof titleTemplate === \"function\" ? titleTemplate(raw) : titleTemplate.replace(/%s/g, raw) : raw)}</title>`;\n\t}\n\tconst props = tag.props;\n\tconst attrs = props ? Object.entries(props).map(([k, v]) => `${k}=\"${esc(v)}\"`).join(\" \") : \"\";\n\tconst open = attrs ? `<${tag.tag} ${attrs}` : `<${tag.tag}`;\n\tif (VOID_TAGS.has(tag.tag)) return `${open} />`;\n\treturn `${open}>${(tag.children || \"\").replace(/<\\/(script|style|noscript)/gi, \"<\\\\/$1\").replace(/<!--/g, \"<\\\\!--\")}</${tag.tag}>`;\n}\nconst ESC_RE = /[&<>\"]/g;\nconst ESC_MAP = {\n\t\"&\": \"&amp;\",\n\t\"<\": \"&lt;\",\n\t\">\": \"&gt;\",\n\t\"\\\"\": \"&quot;\"\n};\nfunction esc(s) {\n\treturn ESC_RE.test(s) ? s.replace(ESC_RE, (ch) => ESC_MAP[ch]) : s;\n}\n\n//#endregion\nexport { renderWithHead };\n//# sourceMappingURL=ssr.js.map","/**\n * HTML template processing for SSR/SSG.\n *\n * Templates use comment placeholders:\n * <!--pyreon-head--> — replaced with <head> tags (title, meta, link, etc.)\n * <!--pyreon-app--> — replaced with rendered application HTML\n * <!--pyreon-scripts--> — replaced with client entry script + inline loader data\n */\n\nexport const DEFAULT_TEMPLATE = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <!--pyreon-head-->\n</head>\n<body>\n <div id=\"app\"><!--pyreon-app--></div>\n <!--pyreon-scripts-->\n</body>\n</html>`\n\nexport interface TemplateData {\n head: string\n app: string\n scripts: string\n}\n\n/**\n * Pre-compiled template — splits the template string once so that\n * each request only concatenates 6 parts instead of scanning 3x with `.replace()`.\n */\nexport interface CompiledTemplate {\n /** [before-head, between-head-app, between-app-scripts, after-scripts] */\n parts: [string, string, string, string]\n}\n\nexport function compileTemplate(template: string): CompiledTemplate {\n if (!template.includes('<!--pyreon-app-->')) {\n throw new Error('[Pyreon] Template must contain <!--pyreon-app--> placeholder')\n }\n const [beforeHead, afterHead] = splitOnce(template, '<!--pyreon-head-->')\n const [betweenHeadApp, afterApp] = splitOnce(afterHead, '<!--pyreon-app-->')\n const [betweenAppScripts, afterScripts] = splitOnce(afterApp, '<!--pyreon-scripts-->')\n return { parts: [beforeHead, betweenHeadApp, betweenAppScripts, afterScripts] }\n}\n\nfunction splitOnce(str: string, delimiter: string): [string, string] {\n const idx = str.indexOf(delimiter)\n if (idx === -1) return [str, '']\n return [str.slice(0, idx), str.slice(idx + delimiter.length)]\n}\n\nexport function processTemplate(template: string, data: TemplateData): string {\n return template\n .replace('<!--pyreon-head-->', data.head)\n .replace('<!--pyreon-app-->', data.app)\n .replace('<!--pyreon-scripts-->', data.scripts)\n}\n\n/** Fast path using a pre-compiled template */\nexport function processCompiledTemplate(compiled: CompiledTemplate, data: TemplateData): string {\n const [p0, p1, p2, p3] = compiled.parts\n return p0 + data.head + p1 + data.app + p2 + data.scripts + p3\n}\n\n/**\n * Build the script tags for client hydration.\n *\n * Emits:\n * 1. Inline script with serialized loader data (if any)\n * 2. Module script tag pointing to the client entry\n */\nexport function buildScripts(\n clientEntry: string,\n loaderData: Record<string, unknown> | null,\n): string {\n const parts: string[] = []\n\n if (loaderData && Object.keys(loaderData).length > 0) {\n // Escape </script> inside JSON to prevent premature tag close\n const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n parts.push(`<script>window.__PYREON_LOADER_DATA__=${json}</script>`)\n }\n\n parts.push(`<script type=\"module\" src=\"${clientEntry}\"></script>`)\n\n return parts.join('\\n ')\n}\n\n/** Pre-build the static client entry script tag (invariant across requests) */\nexport function buildClientEntryTag(clientEntry: string): string {\n return `<script type=\"module\" src=\"${clientEntry}\"></script>`\n}\n\n/** Fast path: build scripts with a pre-built client entry tag */\nexport function buildScriptsFast(\n clientEntryTag: string,\n loaderData: Record<string, unknown> | null,\n): string {\n if (loaderData && Object.keys(loaderData).length > 0) {\n const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n return `<script>window.__PYREON_LOADER_DATA__=${json}</script>\\n ${clientEntryTag}`\n }\n return clientEntryTag\n}\n","/**\n * SSR middleware — simple request processing pipeline.\n *\n * Middleware runs before rendering. Return a Response to short-circuit\n * (e.g. for redirects, auth checks, or static file serving).\n * Return void / undefined to continue to the next middleware or rendering.\n *\n * @example\n * const authMiddleware: Middleware = async (ctx) => {\n * const token = ctx.req.headers.get(\"Authorization\")\n * if (!token) return new Response(\"Unauthorized\", { status: 401 })\n * ctx.locals.user = await verifyToken(token)\n * }\n *\n * const handler = createHandler({\n * App,\n * routes,\n * middleware: [authMiddleware],\n * })\n */\n\nimport { createContext, useContext, provide } from '@pyreon/core'\n\nexport interface MiddlewareContext {\n /** The incoming request */\n req: Request\n /** Parsed URL */\n url: URL\n /** Pathname + search (passed to router) */\n path: string\n /** Response headers — middleware can set custom headers */\n headers: Headers\n /** Arbitrary per-request data shared between middleware and components */\n locals: Record<string, unknown>\n}\n\n/**\n * Middleware function. Return a Response to short-circuit, or void to continue.\n */\nexport type Middleware = (ctx: MiddlewareContext) => Response | void | Promise<Response | void>\n\n/**\n * Context for per-request locals — populated by the SSR handler from\n * middleware `ctx.locals`. Components access it via `useRequestLocals()`.\n *\n * This bridges the middleware → component gap: middleware sets `ctx.locals`,\n * the handler provides it into the Pyreon context system, and components\n * read it without coupling to the middleware layer.\n */\nexport const RequestLocalsCtx = createContext<Record<string, unknown>>({})\n\n/**\n * Read per-request locals inside a component (SSR only).\n *\n * Returns the `ctx.locals` object populated by middleware.\n * On the client, returns an empty object.\n *\n * @example\n * ```tsx\n * import { useRequestLocals } from \"@pyreon/server\"\n *\n * function MyComponent() {\n * const locals = useRequestLocals()\n * const nonce = locals.cspNonce as string ?? ''\n * return <script nonce={nonce}>...</script>\n * }\n * ```\n */\nexport function useRequestLocals(): Record<string, unknown> {\n return useContext(RequestLocalsCtx)\n}\n\n/**\n * Provide request locals into the component tree.\n * Called by the SSR handler — not for direct use.\n * @internal\n */\nexport function provideRequestLocals(locals: Record<string, unknown>): void {\n provide(RequestLocalsCtx, locals)\n}\n","/**\n * SSR request handler.\n *\n * Creates a Web-standard `(Request) => Promise<Response>` handler that:\n * 1. Runs middleware (auth, redirects, headers, etc.)\n * 2. Creates a per-request router with the matched URL\n * 3. Prefetches loader data for matched routes\n * 4. Renders the app to HTML with head tag collection\n * 5. Injects everything into an HTML template\n * 6. Returns a Response\n *\n * Compatible with Bun.serve, Deno.serve, Cloudflare Workers,\n * Express (via adapter), and any Web-standard server.\n *\n * @example\n * import { createHandler } from \"@pyreon/server\"\n *\n * const handler = createHandler({\n * App,\n * routes,\n * template: await Bun.file(\"index.html\").text(),\n * })\n *\n * Bun.serve({ fetch: handler })\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { renderWithHead } from '@pyreon/head/ssr'\nimport {\n createRouter,\n prefetchLoaderData,\n type RouteRecord,\n RouterProvider,\n serializeLoaderData,\n} from '@pyreon/router'\nimport { renderToStream, runWithRequestContext } from '@pyreon/runtime-server'\nimport {\n buildClientEntryTag,\n buildScriptsFast,\n type CompiledTemplate,\n compileTemplate,\n DEFAULT_TEMPLATE,\n processCompiledTemplate,\n} from './html'\nimport type { Middleware, MiddlewareContext } from './middleware'\nimport { provideRequestLocals } from './middleware'\n\nconst __DEV__ = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface HandlerOptions {\n /** Root application component */\n App: ComponentFn\n /** Route definitions */\n routes: RouteRecord[]\n /**\n * HTML template with placeholders:\n * <!--pyreon-head--> — head tags (title, meta, link, etc.)\n * <!--pyreon-app--> — rendered app HTML\n * <!--pyreon-scripts--> — client entry + loader data\n *\n * Defaults to a minimal HTML5 template.\n */\n template?: string\n /** Path to the client entry module (default: \"/src/entry-client.ts\") */\n clientEntry?: string\n /** Middleware chain — runs before rendering */\n middleware?: Middleware[]\n /**\n * Rendering mode:\n * \"string\" (default) — full renderToString, complete HTML in one response\n * \"stream\" — progressive streaming via renderToStream (Suspense out-of-order)\n */\n mode?: 'string' | 'stream'\n /**\n * Collect CSS styles after rendering. Called after renderToString/renderWithHead.\n * Return a `<style>` tag string to inject into `<head>`.\n * Used by @pyreon/styler's sheet.getStyleTag() to prevent FOUC in SSG.\n *\n * @example\n * import { sheet } from '@pyreon/styler'\n * createHandler({\n * collectStyles: () => {\n * const tag = sheet.getStyleTag()\n * sheet.reset()\n * return tag\n * },\n * })\n */\n collectStyles?: () => string\n}\n\nexport function createHandler(options: HandlerOptions): (req: Request) => Promise<Response> {\n const {\n App,\n routes,\n template = DEFAULT_TEMPLATE,\n clientEntry = '/src/entry-client.ts',\n middleware = [],\n mode = 'string',\n collectStyles,\n } = options\n\n // Pre-compile once at handler creation — avoids 3x string scan per request\n const compiled = compileTemplate(template)\n const clientEntryTag = buildClientEntryTag(clientEntry)\n\n return async function handler(req: Request): Promise<Response> {\n const url = new URL(req.url)\n const path = url.pathname + url.search\n\n // ── Middleware pipeline ────────────────────────────────────────────────────\n const ctx: MiddlewareContext = {\n req,\n url,\n path,\n headers: new Headers({ 'Content-Type': 'text/html; charset=utf-8' }),\n locals: {},\n }\n\n for (const mw of middleware) {\n const result = await mw(ctx)\n if (result instanceof Response) return result\n }\n\n // ── Per-request router ────────────────────────────────────────────────────\n const router = createRouter({ routes, mode: 'history', url: path })\n\n return runWithRequestContext(async () => {\n try {\n // Bridge middleware locals → Pyreon context system so components\n // can access per-request data (CSP nonce, auth user, etc.)\n provideRequestLocals(ctx.locals)\n\n // Pre-run loaders so data is available during render\n await prefetchLoaderData(router as never, path)\n\n // Build the VNode tree\n const app = h(RouterProvider, { router }, h(App, null))\n\n if (mode === 'stream') {\n return renderStreamResponse(app, router, compiled, clientEntryTag, ctx.headers)\n }\n\n // ── String mode (default) ─────────────────────────────────────────────\n const { html: appHtml, head } = await renderWithHead(app)\n\n // Collect CSS-in-JS styles if a collector was provided.\n // The consumer passes collectStyles (e.g. sheet.getStyleTag from @pyreon/styler)\n // to inject scoped CSS into <head> and prevent FOUC in SSG pages.\n const styleTag = collectStyles ? collectStyles() : ''\n\n const loaderData = serializeLoaderData(router as never)\n const scripts = buildScriptsFast(clientEntryTag, loaderData)\n const headWithStyles = styleTag ? `${styleTag}\\n${head}` : head\n const fullHtml = processCompiledTemplate(compiled, { head: headWithStyles, app: appHtml, scripts })\n\n return new Response(fullHtml, { status: 200, headers: ctx.headers })\n } catch (err) {\n if (__DEV__) {\n console.error('[Pyreon Server] SSR render failed:', err)\n }\n return new Response('Internal Server Error', {\n status: 500,\n headers: { 'Content-Type': 'text/plain' },\n })\n }\n })\n }\n}\n\n/**\n * Streaming mode: shell is emitted immediately, app content streams progressively.\n *\n * Head tags from the initial synchronous render are included in the shell.\n * Suspense boundaries resolve out-of-order via inline <template> + swap scripts.\n */\nasync function renderStreamResponse(\n app: ReturnType<typeof h>,\n router: ReturnType<typeof createRouter>,\n compiled: CompiledTemplate,\n clientEntryTag: string,\n extraHeaders: Headers,\n): Promise<Response> {\n const loaderData = serializeLoaderData(router as never)\n const scripts = buildScriptsFast(clientEntryTag, loaderData)\n\n // Use pre-split parts: [before-head, between-head-app, between-app-scripts, after-scripts]\n const [p0, p1, p2, p3] = compiled.parts\n const shellHead = p0 + p1\n const shellTail = p2 + scripts + p3\n\n const appStream = renderToStream(app)\n const reader = appStream.getReader()\n\n const stream = new ReadableStream<Uint8Array>({\n async start(controller) {\n const encoder = new TextEncoder()\n const push = (s: string) => controller.enqueue(encoder.encode(s))\n\n try {\n push(shellHead)\n\n // Stream app content\n let done = false\n while (!done) {\n const result = await reader.read()\n done = result.done\n if (result.value) push(result.value)\n }\n\n push(shellTail)\n } catch (err) {\n if (__DEV__) {\n console.error('[Pyreon Server] Stream render failed:', err)\n }\n // Emit an inline error indicator — status code is already sent (200)\n push(`<script>console.error(\"[pyreon/server] Stream render failed\")</script>`)\n push(shellTail)\n } finally {\n controller.close()\n }\n },\n })\n\n return new Response(stream, {\n status: 200,\n headers: extraHeaders,\n })\n}\n","/**\n * Island architecture — partial hydration for content-heavy sites.\n *\n * Islands are interactive components embedded in otherwise-static HTML.\n * Only island components ship JavaScript to the client — the rest of the\n * page stays as zero-JS server-rendered HTML.\n *\n * ## Server side\n *\n * `island()` wraps an async component import and returns a ComponentFn.\n * During SSR, it renders the component output inside a `<pyreon-island>` element\n * with serialized props, so the client knows what to hydrate.\n *\n * ```tsx\n * import { island } from \"@pyreon/server\"\n *\n * const Counter = island(() => import(\"./Counter\"), { name: \"Counter\" })\n * const Search = island(() => import(\"./Search\"), { name: \"Search\" })\n *\n * function Page() {\n * return <div>\n * <h1>Static heading (no JS)</h1>\n * <Counter initial={5} /> // hydrated on client\n * <p>Static paragraph</p>\n * <Search /> // hydrated on client\n * </div>\n * }\n * ```\n *\n * ## Client side\n *\n * Use `hydrateIslands()` from `@pyreon/server/client` to hydrate all islands\n * on the page. Only the island components' JavaScript is loaded.\n *\n * ```ts\n * // entry-client.ts (island mode)\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n * Counter: () => import(\"./Counter\"),\n * Search: () => import(\"./Search\"),\n * })\n * ```\n *\n * ## Hydration strategies\n *\n * Control when an island hydrates via the `hydrate` option:\n * - \"load\" (default) — hydrate immediately on page load\n * - \"idle\" — hydrate when the browser is idle (requestIdleCallback)\n * - \"visible\" — hydrate when the island scrolls into the viewport\n * - \"media(query)\" — hydrate when a media query matches\n * - \"never\" — never hydrate (render-only, no client JS)\n */\n\nimport type { ComponentFn, Props, VNode } from '@pyreon/core'\nimport { h } from '@pyreon/core'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type HydrationStrategy = 'load' | 'idle' | 'visible' | 'never' | `media(${string})`\n\nexport interface IslandOptions {\n /** Unique name — must match the key in the client-side hydrateIslands() registry */\n name: string\n /** When to hydrate on the client (default: \"load\") */\n hydrate?: HydrationStrategy\n}\n\nexport interface IslandMeta {\n readonly __island: true\n readonly name: string\n readonly hydrate: HydrationStrategy\n}\n\n// ─── Server-side island factory ──────────────────────────────────────────────\n\n/**\n * Create an island component.\n *\n * Returns an async ComponentFn that:\n * 1. Resolves the dynamic import\n * 2. Renders the component to VNodes\n * 3. Wraps the output in `<pyreon-island>` with serialized props + hydration strategy\n */\nexport function island<P extends Props = Props>(\n loader: () => Promise<{ default: ComponentFn<P> } | ComponentFn<P>>,\n options: IslandOptions,\n): ComponentFn<P> & IslandMeta {\n const { name, hydrate = 'load' } = options\n\n const IslandWrapper = async function IslandWrapper(props: P): Promise<VNode | null> {\n const mod = await loader()\n const Comp = typeof mod === 'function' ? mod : mod.default\n const serializedProps = serializeIslandProps(props)\n\n return h(\n 'pyreon-island',\n {\n 'data-component': name,\n 'data-props': serializedProps,\n 'data-hydrate': hydrate,\n },\n h(Comp, props),\n )\n }\n\n // Attach metadata so the Vite plugin can detect islands for code-splitting\n const wrapper = IslandWrapper as unknown as ComponentFn<P> & IslandMeta\n Object.defineProperties(wrapper, {\n __island: { value: true, enumerable: true },\n name: { value: name, enumerable: true, writable: false, configurable: true },\n hydrate: { value: hydrate, enumerable: true },\n })\n\n return wrapper\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Serialize component props to a JSON string for embedding in HTML attributes.\n * Strips non-serializable values (functions, symbols, children).\n */\nfunction serializeIslandProps(props: Record<string, unknown>): string {\n const clean: Record<string, unknown> = {}\n for (const [key, value] of Object.entries(props)) {\n // Skip non-serializable or internal props\n if (key === 'children') continue\n if (typeof value === 'function') continue\n if (typeof value === 'symbol') continue\n if (value === undefined) continue\n clean[key] = value\n }\n // The SSR renderer's renderProp() already applies escapeHtml() to attribute\n // values, so the JSON is safe to embed in HTML attributes without double-escaping.\n return JSON.stringify(clean)\n}\n","/**\n * Static Site Generation — pre-render routes to HTML files at build time.\n *\n * @example\n * // ssg.ts (run with: bun run ssg.ts)\n * import { createHandler } from \"@pyreon/server\"\n * import { prerender } from \"@pyreon/server\"\n * import { App } from \"./src/App\"\n * import { routes } from \"./src/routes\"\n *\n * const handler = createHandler({ App, routes })\n *\n * await prerender({\n * handler,\n * paths: [\"/\", \"/about\", \"/blog\", \"/blog/hello-world\"],\n * outDir: \"dist\",\n * })\n *\n * @example\n * // Dynamic paths from a CMS or filesystem\n * await prerender({\n * handler,\n * paths: async () => {\n * const posts = await fetchAllPosts()\n * return [\"/\", \"/about\", ...posts.map(p => `/blog/${p.slug}`)]\n * },\n * outDir: \"dist\",\n * })\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\n\nexport interface PrerenderOptions {\n /** SSR handler created by createHandler() */\n handler: (req: Request) => Promise<Response>\n /** Routes to pre-render — array of URL paths or async function that returns them */\n paths: string[] | (() => string[] | Promise<string[]>)\n /** Output directory for the generated HTML files */\n outDir: string\n /** Origin for constructing full URLs (default: \"http://localhost\") */\n origin?: string\n /**\n * Called after each page is rendered — use for logging or progress tracking.\n * Return false to skip writing this page.\n */\n onPage?: (path: string, html: string) => void | boolean | Promise<void | boolean>\n}\n\nexport interface PrerenderResult {\n /** Number of pages generated */\n pages: number\n /** Paths that failed to render */\n errors: { path: string; error: unknown }[]\n /** Total elapsed time in milliseconds */\n elapsed: number\n}\n\n/**\n * Pre-render a list of routes to static HTML files.\n *\n * For each path:\n * 1. Constructs a Request for the path\n * 2. Calls the SSR handler to render to HTML\n * 3. Writes the HTML to `outDir/<path>/index.html`\n *\n * The root path \"/\" becomes `outDir/index.html`.\n * Paths like \"/about\" become `outDir/about/index.html`.\n */\nexport async function prerender(options: PrerenderOptions): Promise<PrerenderResult> {\n const { handler, outDir, origin = 'http://localhost', onPage } = options\n\n const start = Date.now()\n\n // Resolve paths (may be async)\n const paths = typeof options.paths === 'function' ? await options.paths() : options.paths\n\n let pages = 0\n const errors: PrerenderResult['errors'] = []\n\n async function renderPage(path: string): Promise<void> {\n const url = new URL(path, origin)\n const req = new Request(url.href)\n const res = await Promise.race([\n handler(req),\n new Promise<never>((_, reject) =>\n setTimeout(() => reject(new Error(`Prerender timeout for \"${path}\" (30s)`)), 30_000),\n ),\n ])\n\n if (!res.ok) {\n errors.push({ path, error: new Error(`HTTP ${res.status}`) })\n return\n }\n\n const html = await res.text()\n\n if (onPage) {\n const result = await onPage(path, html)\n if (result === false) return\n }\n\n const filePath = resolveOutputPath(outDir, path)\n\n const resolvedOut = resolve(outDir)\n if (!resolve(filePath).startsWith(resolvedOut)) {\n errors.push({ path, error: new Error(`Path traversal detected: \"${path}\"`) })\n return\n }\n\n await mkdir(dirname(filePath), { recursive: true })\n await writeFile(filePath, html, 'utf-8')\n pages++\n }\n\n // Process paths concurrently (batch of 10 to avoid overwhelming)\n const BATCH_SIZE = 10\n for (let i = 0; i < paths.length; i += BATCH_SIZE) {\n const batch = paths.slice(i, i + BATCH_SIZE)\n await Promise.all(\n batch.map(async (path) => {\n try {\n await renderPage(path)\n } catch (error) {\n errors.push({ path, error })\n }\n }),\n )\n }\n\n return {\n pages,\n errors,\n elapsed: Date.now() - start,\n }\n}\n\nfunction resolveOutputPath(outDir: string, path: string): string {\n if (path === '/') return join(outDir, 'index.html')\n if (path.endsWith('.html')) return join(outDir, path)\n return join(outDir, path, 'index.html')\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"client2.d.ts","names":[],"sources":["../../../src/client.ts"],"mappings":";;;;UAmCiB,kBAAA;EAiD4C;EA/C3D,GAAA,EAAK,WAAA;EA+C0B;EA7C/B,MAAA,EAAQ,WAAA;EA6CgB;EA3CxB,SAAA,YAAqB,OAAA;AAAA;;;;AA6DvB;;;;;;;iBAhDgB,WAAA,CAAY,OAAA,EAAS,kBAAA;AAAA,KA8BhC,YAAA,SAAqB,OAAA;EAAU,OAAA,EAAS,WAAA;AAAA,IAAgB,WAAA;;;;;;;;;;;;;;;;;iBAkB7C,cAAA,CAAe,QAAA,EAAU,MAAA,SAAe,YAAA"}
1
+ {"version":3,"file":"client2.d.ts","names":[],"sources":["../../../src/client.ts"],"mappings":";;;;UAmCiB,kBAAA;EAoD4C;EAlD3D,GAAA,EAAK,WAAA;EAkD0B;EAhD/B,MAAA,EAAQ,WAAA;EAgDgB;EA9CxB,SAAA,YAAqB,OAAA;AAAA;;;;AAgEvB;;;;;;;iBAnDgB,WAAA,CAAY,OAAA,EAAS,kBAAA;AAAA,KAiChC,YAAA,SAAqB,OAAA;EAAU,OAAA,EAAS,WAAA;AAAA,IAAgB,WAAA;;;;;;;;;;;;;;;;;iBAkB7C,cAAA,CAAe,QAAA,EAAU,MAAA,SAAe,YAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pyreon/server",
3
- "version": "0.12.13",
3
+ "version": "0.12.14",
4
4
  "description": "SSR handler, SSG prerender, and island architecture for Pyreon",
5
5
  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/server#readme",
6
6
  "bugs": {
@@ -47,11 +47,11 @@
47
47
  "prepublishOnly": "bun run build"
48
48
  },
49
49
  "dependencies": {
50
- "@pyreon/core": "^0.12.13",
51
- "@pyreon/head": "^0.12.13",
52
- "@pyreon/reactivity": "^0.12.13",
53
- "@pyreon/router": "^0.12.13",
54
- "@pyreon/runtime-dom": "^0.12.13",
55
- "@pyreon/runtime-server": "^0.12.13"
50
+ "@pyreon/core": "^0.12.14",
51
+ "@pyreon/head": "^0.12.14",
52
+ "@pyreon/reactivity": "^0.12.14",
53
+ "@pyreon/router": "^0.12.14",
54
+ "@pyreon/runtime-dom": "^0.12.14",
55
+ "@pyreon/runtime-server": "^0.12.14"
56
56
  }
57
57
  }
package/src/client.ts CHANGED
@@ -53,12 +53,15 @@ export interface StartClientOptions {
53
53
  * Returns a cleanup function that unmounts the app.
54
54
  */
55
55
  export function startClient(options: StartClientOptions): () => void {
56
+ if (typeof document === 'undefined') {
57
+ throw new Error('[Pyreon] startClient() can only be called in the browser.')
58
+ }
56
59
  const { App, routes, container = '#app' } = options
57
60
 
58
61
  const el = typeof container === 'string' ? document.querySelector(container) : container
59
62
 
60
63
  if (!el) {
61
- throw new Error(`[pyreon/client] Container "${container}" not found`)
64
+ throw new Error(`[Pyreon] Container "${container}" not found`)
62
65
  }
63
66
 
64
67
  // Create client-side router (history mode to match SSR)
@@ -101,6 +104,7 @@ type IslandLoader = () => Promise<{ default: ComponentFn } | ComponentFn>
101
104
  * Returns a cleanup function that disconnects any pending observers/listeners.
102
105
  */
103
106
  export function hydrateIslands(registry: Record<string, IslandLoader>): () => void {
107
+ if (typeof document === 'undefined') return () => {}
104
108
  const islands = document.querySelectorAll('pyreon-island')
105
109
  const cleanups: (() => void)[] = []
106
110
 
@@ -132,6 +136,7 @@ function scheduleHydration(
132
136
  propsJson: string,
133
137
  strategy: HydrationStrategy,
134
138
  ): (() => void) | null {
139
+ if (typeof window === 'undefined') return null
135
140
  let cancelled = false
136
141
  const hydrate = () => {
137
142
  if (!cancelled) hydrateIsland(el, loader, propsJson)
@@ -216,6 +221,7 @@ async function hydrateIsland(
216
221
  }
217
222
 
218
223
  function observeVisibility(el: HTMLElement, callback: () => void): (() => void) | null {
224
+ if (typeof window === 'undefined') return null
219
225
  if (!('IntersectionObserver' in window)) {
220
226
  callback()
221
227
  return null
package/src/html.ts CHANGED
@@ -37,7 +37,7 @@ export interface CompiledTemplate {
37
37
 
38
38
  export function compileTemplate(template: string): CompiledTemplate {
39
39
  if (!template.includes('<!--pyreon-app-->')) {
40
- throw new Error('[pyreon/server] Template must contain <!--pyreon-app--> placeholder')
40
+ throw new Error('[Pyreon] Template must contain <!--pyreon-app--> placeholder')
41
41
  }
42
42
  const [beforeHead, afterHead] = splitOnce(template, '<!--pyreon-head-->')
43
43
  const [betweenHeadApp, afterApp] = splitOnce(afterHead, '<!--pyreon-app-->')