@pajecawav/yamf 0.0.4 → 0.0.5

package/README.md

@@ -0,0 +1,262 @@
+# yamf
+
+SSR meta-framework on top of [Vite](https://vite.dev), [Nitro](https://nitro.build/), and [Hono JSX](https://hono.dev/docs/guides/jsx). File-based routing for HTML pages, islands architecture for client interactivity, head/SEO via [unhead](https://unhead.unjs.io/), and full Nitro feature set (presets, caching, middleware, API routes).
+
+## Install
+
+```bash
+npm install @pajecawav/yamf hono vite
+# or
+yarn add @pajecawav/yamf hono vite
+# or
+pnpm add @pajecawav/yamf hono vite
+```
+
+## Project structure
+
+```
+src/
+  server.tsx              # server entry with export default defineServerEntry(...)
+  client/index.ts         # client entry with import "@pajecawav/yamf/client"
+  pages/*.page.tsx        # file-based routes (.page suffix required)
+  root/index.tsx          # optional root layout
+  template.html           # optional HTML shell with <!--ssr-outlet-->
+  routes/                 # optional nitro API routes
+vite.config.ts
+```
+
+## Vite plugin
+
+```ts
+// vite.config.ts
+import yamf from "@pajecawav/yamf/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+    plugins: [yamf()],
+});
+```
+
+## Server entry
+
+```tsx
+// src/server.tsx
+import { defineServerEntry } from "@pajecawav/yamf/server";
+
+export default defineServerEntry({
+    head: {
+        titleTemplate: "%s | my app",
+        htmlAttrs: { lang: "en" },
+    },
+});
+```
+
+## Pages
+
+```tsx
+// src/pages/index.page.tsx
+import { definePage } from "@pajecawav/yamf";
+
+export default definePage({
+    render: (event, { head }) => {
+        head.push({ title: "Home" });
+
+        return <h1>Hello, {event.url.hostname}!</h1>;
+    },
+});
+```
+
+### File routing
+
+Files in `src/pages/` with `.page` suffix are mapped to routes following `nitro` conventions:
+
+| File                      | Route           |
+| ------------------------- | --------------- |
+| `index.page.tsx`          | `/`             |
+| `about.page.tsx`          | `/about`        |
+| `[owner].page.tsx`        | `/:owner`       |
+| `post/[postId].page.tsx`  | `/post/:postId` |
+| `docs/[...rest].page.tsx` | `/docs/**`      |
+
+### Redirects and non-HTML responses
+
+```tsx
+import { definePage } from "@pajecawav/yamf";
+import { HTTPResponse, redirect } from "nitro/h3";
+
+export default definePage({
+    render: async () => {
+        return redirect("/calc");
+
+        // or
+
+        return new HTTPResponse(null, {
+            status: 302,
+            headers: { location: "/calc" },
+        });
+    },
+});
+```
+
+## Islands
+
+Any file matching `*.island.{tsx,ts,jsx,js}` is automatically wrapped. Each exported function becomes an island that server-renders inside `<yamf-island>` and hydrates on the client.
+
+```tsx
+// src/components/Counter.island.tsx
+import { type IslandProps, useHead } from "@pajecawav/yamf";
+import { useState } from "hono/jsx";
+
+export interface CounterProps extends IslandProps {
+    initialValue?: number;
+}
+
+export const Counter = ({ initialValue = 0 }: CounterProps) => {
+    const [value, setValue] = useState(initialValue);
+
+    useHead({ title: `Counter: ${value}` });
+
+    return <button onClick={() => setValue(value + 1)}>{value}</button>;
+};
+```
+
+```tsx
+// src/pages/index.page.tsx
+import { Counter } from "~/components/Counter.island";
+
+export default definePage({
+    render: () => (
+        <>
+            <Counter initialValue={2} />
+            <Counter initialValue={5} />
+            <Counter yamf-client="visible" />
+            <Counter yamf-client="skip" />
+        </>
+    ),
+});
+```
+
+### Hydration directives
+
+`yamf-client` prop controls when hydration happens:
+
+| Value            | Behavior                            |
+| ---------------- | ----------------------------------- |
+| `load` (default) | Hydrate immediately on connection.  |
+| `idle`           | Defer via `requestIdleCallback`.    |
+| `visible`        | Hydrate when scrolled into view.    |
+| `skip`           | Server-rendered only, no hydration. |
+
+Props are serialized with `devalue` (supports `Date`, `Map`, `Set`, `URL`, `RegExp`, `Error`, `BigInt`, cycles).
+
+## Client entry
+
+```ts
+// src/client/index.ts
+import "@pajecawav/yamf/client";
+```
+
+Side-effect import. Registers the `yamf-island` custom element and initializes `window.__UNHEAD__`. Required for island hydration and client-side `useHead`.
+
+## Head and SEO
+
+```tsx
+import { useHead, useSeoMeta } from "@pajecawav/yamf";
+
+// In any component inside the render tree:
+useHead({
+    title: "Page title",
+    meta: [{ name: "description", content: "..." }],
+    link: [{ rel: "canonical", href: "https://..." }],
+});
+
+useSeoMeta({
+    title: "Page title",
+    ogTitle: "Page title",
+    ogImage: "https://example.com/og.png",
+});
+```
+
+In the `render` function itself, use the `head` argument directly (SSR context is not set up yet):
+
+```tsx
+export default definePage({
+    render: (event, { head }) => {
+        head.push({ title: "Page" });
+
+        return <Content />;
+    },
+});
+```
+
+Default head from `defineServerEntry` is applied first, then page-specific head overrides individual fields.
+
+## Root layout
+
+```tsx
+// src/root/index.tsx
+import type { PropsWithChildren } from "hono/jsx";
+import { useEvent } from "@pajecawav/yamf";
+import "./index.css";
+
+export default function Root({ children }: PropsWithChildren) {
+    const event = useEvent();
+
+    return (
+        <>
+            <nav>...</nav>
+            <main>{children}</main>
+        </>
+    );
+}
+```
+
+Optional. Wraps every page's content. CSS imported here is included in the asset manifest automatically. `useEvent()` works here because root renders inside the SSR context.
+
+## HTML template
+
+```html
+<!-- src/template.html -->
+<!doctype html>
+<html>
+    <head></head>
+    <body>
+        <!--ssr-outlet-->
+    </body>
+</html>
+```
+
+`<!--ssr-outlet-->` is replaced with rendered content. Head tags are injected by unhead. Falls back to a minimal default if the file is missing.
+
+## Hooks
+
+- `useEvent()` — current `H3Event`. Works in components inside the render tree and root layout, not in `render` itself.
+- `useSSRContext()` — returns `{ head, event } | null`.
+- `useHead(input)` — push head tags.
+- `useSeoMeta(input)` — shorthand for SEO meta.
+
+## API routes and error handling
+
+Handled by Nitro directly. Place files in `src/routes/`:
+
+```ts
+// src/routes/api/badge.get.ts
+import { defineHandler, getQuery, setHeader } from "nitro/h3";
+
+export default defineHandler(event => {
+    setHeader(event, "cache-control", "public, max-age=60");
+
+    return "Cached response";
+});
+```
+
+```ts
+// src/error.ts
+import { defineErrorHandler } from "nitro";
+
+export default defineErrorHandler(error => {
+    console.error(error);
+
+    return new Response(`${error.statusCode} ${error.statusMessage}`);
+});
+```

package/dist/components/Head.d.ts

@@ -1,5 +1,4 @@
 import { ResolvableHead } from "unhead/types";
-
 //#region src/components/Head.d.ts
 type HeadProps = ResolvableHead;
 declare const Head: (props: HeadProps) => void;

package/dist/components/Head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Head.d.ts","names":[],"sources":["../../src/components/Head.tsx"],"mappings":";;;KAGY,SAAA,GAAY,cAAA;AAAA,cAEX,IAAA,GAAQ,KAAO,EAAA,SAAA"}
+{"version":3,"file":"Head.d.ts","names":[],"sources":["../../src/components/Head.tsx"],"mappings":";;KAGY,YAAY;cAEX,OAAQ,OAAO"}

package/dist/context/ssr.d.ts

@@ -1,6 +1,6 @@
+import "hono/jsx";
 import { ServerUnhead } from "unhead/server";
 import { H3Event } from "nitro";
-
 //#region src/context/ssr.d.ts
 interface SSRContextValue {
   head: ServerUnhead;

package/dist/context/ssr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.d.ts","names":[],"sources":["../../src/context/ssr.ts"],"mappings":";;;;UAIU,eAAA;EACT,IAAA,EAAM,YAAA;EACN,KAAA,EAAO,OAAA;AAAA;AAAA,cAOK,aAAA,QAAoB,eAAA"}
+{"version":3,"file":"ssr.d.ts","names":[],"sources":["../../src/context/ssr.ts"],"mappings":";;;;UAIU;EACT,MAAM;EACN,OAAO;;cAOK,qBAAoB"}

package/dist/hooks/useEvent.d.ts

@@ -1,5 +1,4 @@
 import { H3Event } from "nitro";
-
 //#region src/hooks/useEvent.d.ts
 declare const useEvent: () => H3Event;
 //#endregion

package/dist/hooks/useEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEvent.d.ts","names":[],"sources":["../../src/hooks/useEvent.tsx"],"mappings":";;;cAGa,QAAA,QAAe,OAAA"}
+{"version":3,"file":"useEvent.d.ts","names":[],"sources":["../../src/hooks/useEvent.tsx"],"mappings":";;cAGa,gBAAe"}

package/dist/hooks/useHead.d.ts

@@ -1,6 +1,5 @@
 import { ClientUnhead } from "unhead/client";
 import { ResolvableHead, UseSeoMetaInput } from "unhead/types";
-
 //#region src/hooks/useHead.d.ts
 declare global {
   interface Window {

package/dist/hooks/useHead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHead.d.ts","names":[],"sources":["../../src/hooks/useHead.tsx"],"mappings":";;;;;YAOW,MAAA;IACT,UAAA,GAAa,YAAA;EAAA;AAAA;AAAA,cAQF,OAAA,GAAW,KAAQ,GAAA,cAAA;AAAA,cAYnB,UAAA,GAAc,KAAQ,GAAA,eAAA"}
+{"version":3,"file":"useHead.d.ts","names":[],"sources":["../../src/hooks/useHead.tsx"],"mappings":";;;;YAOW;IACT,aAAa;;;cAQF,UAAW,QAAQ;cAYnB,aAAc,QAAQ"}

package/dist/island/client.js

@@ -36,6 +36,7 @@ customElements.define("yamf-island", class extends HTMLElement {
 			__island_raw_import__(src).then(hydrateIsland);
 		};
 		switch (islandClient) {
+			case true:
 			case "load":
 				initIsland();
 				break;
@@ -46,6 +47,7 @@ customElements.define("yamf-island", class extends HTMLElement {
 				if (this.firstElementChild) observe(this.firstElementChild, initIsland);
 				else initIsland();
 				break;
+			case false:
 			case "skip": break;
 			default: throw new Error(`Invalid island-client value: ${islandClient}`);
 		}

package/dist/island/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/island/client.tsx"],"sourcesContent":["import { parse } from \"devalue\";\nimport type { FC } from \"hono/jsx\";\nimport { hydrateRoot } from \"hono/jsx/dom/client\";\nimport { withLeadingSlash } from \"ufo\";\nimport type { IslandClientDirective } from \"./types\";\n\ndeclare let __island_raw_import__: <T>(file: string) => Promise<T>;\n\nconst listeners = new WeakMap<Element, VoidFunction>();\n\nconst observer = new IntersectionObserver(entries => {\n\tfor (const entry of entries) {\n\t\tif (entry.isIntersecting) {\n\t\t\tlisteners.get(entry.target)?.();\n\t\t\tunobserve(entry.target);\n\t\t}\n\t}\n});\n\nconst observe = (target: Element, cb: VoidFunction) => {\n\tobserver.observe(target);\n\tlisteners.set(target, cb);\n};\n\nconst unobserve = (target: Element) => {\n\tobserver.unobserve(target);\n\tlisteners.delete(target);\n};\n\ncustomElements.define(\n\t\"yamf-island\",\n\tclass extends HTMLElement {\n\t\tpublic connectedCallback() {\n\t\t\tconst islandProps = parse(this.getAttribute(\"island-props\") ?? \"{}\");\n\t\t\tconst islandSrc = this.getAttribute(\"island-src\");\n\t\t\tconst islandEntry = this.getAttribute(\"island-entry\");\n\t\t\t// oxlint-disable-next-line typescript/no-unsafe-type-assertion\n\t\t\tconst islandClient = (this.getAttribute(\"island-client\") ??\n\t\t\t\t\"load\") as IslandClientDirective;\n\n\t\t\tif (!islandSrc) {\n\t\t\t\tthrow new Error(\"Missing island-src attribute\");\n\t\t\t}\n\n\t\t\tif (!islandEntry) {\n\t\t\t\tthrow new Error(\"Missing island-entry attribute\");\n\t\t\t}\n\n\t\t\tconst hydrateIsland = (mod: Record<string, FC>) => {\n\t\t\t\tconst Comp = mod[islandEntry];\n\n\t\t\t\tif (!Comp) {\n\t\t\t\t\tthrow new Error(`Missing island entry ${islandEntry} in ${islandSrc}`);\n\t\t\t\t}\n\n\t\t\t\thydrateRoot(this, <Comp {...islandProps} />);\n\t\t\t};\n\n\t\t\tconst initIsland = () => {\n\t\t\t\tconst src = withLeadingSlash(islandSrc);\n\t\t\t\tvoid __island_raw_import__<Record<string, FC>>(src).then(hydrateIsland);\n\t\t\t};\n\n\t\t\tswitch (islandClient) {\n\t\t\t\tcase \"load\":\n\t\t\t\t\tinitIsland();\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"idle\":\n\t\t\t\t\trequestIdleCallback(initIsland);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"visible\":\n\t\t\t\t\t// yamf-island has `display: contents` which breaks IntersectionObserver\n\t\t\t\t\t// so we have to observe the first child instead if it exists\n\t\t\t\t\tif (this.firstElementChild) {\n\t\t\t\t\t\tobserve(this.firstElementChild, initIsland);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tinitIsland();\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"skip\":\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\t// oxlint-disable-next-line typescript/restrict-template-expressions\n\t\t\t\t\tthrow new Error(`Invalid island-client value: ${islandClient}`);\n\t\t\t}\n\t\t}\n\n\t\tpublic disconnectedCallback() {\n\t\t\tunobserve(this);\n\t\t}\n\t},\n);\n"],"mappings":";;;;;AAQA,MAAM,4BAAY,IAAI,QAA+B;AAErD,MAAM,WAAW,IAAI,sBAAqB,YAAW;CACpD,KAAK,MAAM,SAAS,SACnB,IAAI,MAAM,gBAAgB;EACzB,UAAU,IAAI,MAAM,MAAM,CAAC,GAAG;EAC9B,UAAU,MAAM,MAAM;CACvB;AAEF,CAAC;AAED,MAAM,WAAW,QAAiB,OAAqB;CACtD,SAAS,QAAQ,MAAM;CACvB,UAAU,IAAI,QAAQ,EAAE;AACzB;AAEA,MAAM,aAAa,WAAoB;CACtC,SAAS,UAAU,MAAM;CACzB,UAAU,OAAO,MAAM;AACxB;AAEA,eAAe,OACd,eACA,cAAc,YAAY;CACzB,oBAA2B;EAC1B,MAAM,cAAc,MAAM,KAAK,aAAa,cAAc,KAAK,IAAI;EACnE,MAAM,YAAY,KAAK,aAAa,YAAY;EAChD,MAAM,cAAc,KAAK,aAAa,cAAc;EAEpD,MAAM,eAAgB,KAAK,aAAa,eAAe,KACtD;EAED,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,8BAA8B;EAG/C,IAAI,CAAC,aACJ,MAAM,IAAI,MAAM,gCAAgC;EAGjD,MAAM,iBAAiB,QAA4B;GAClD,MAAM,OAAO,IAAI;GAEjB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,wBAAwB,YAAY,MAAM,WAAW;GAGtE,YAAY,MAAM,oBAAC,MAAD,EAAM,GAAI,YAAc,CAAA,CAAC;EAC5C;EAEA,MAAM,mBAAmB;GACxB,MAAM,MAAM,iBAAiB,SAAS;GACtC,sBAA+C,GAAG,CAAC,CAAC,KAAK,aAAa;EACvE;EAEA,QAAQ,cAAR;GACC,KAAK;IACJ,WAAW;IACX;GACD,KAAK;IACJ,oBAAoB,UAAU;IAC9B;GACD,KAAK;IAGJ,IAAI,KAAK,mBACR,QAAQ,KAAK,mBAAmB,UAAU;SAE1C,WAAW;IAEZ;GACD,KAAK,QACJ;GACD,SAEC,MAAM,IAAI,MAAM,gCAAgC,cAAc;EAChE;CACD;CAEA,uBAA8B;EAC7B,UAAU,IAAI;CACf;AACD,CACD"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/island/client.tsx"],"sourcesContent":["import { parse } from \"devalue\";\nimport type { FC } from \"hono/jsx\";\nimport { hydrateRoot } from \"hono/jsx/dom/client\";\nimport { withLeadingSlash } from \"ufo\";\nimport type { IslandClientDirective } from \"./types\";\n\ndeclare let __island_raw_import__: <T>(file: string) => Promise<T>;\n\nconst listeners = new WeakMap<Element, VoidFunction>();\n\nconst observer = new IntersectionObserver(entries => {\n\tfor (const entry of entries) {\n\t\tif (entry.isIntersecting) {\n\t\t\tlisteners.get(entry.target)?.();\n\t\t\tunobserve(entry.target);\n\t\t}\n\t}\n});\n\nconst observe = (target: Element, cb: VoidFunction) => {\n\tobserver.observe(target);\n\tlisteners.set(target, cb);\n};\n\nconst unobserve = (target: Element) => {\n\tobserver.unobserve(target);\n\tlisteners.delete(target);\n};\n\ncustomElements.define(\n\t\"yamf-island\",\n\tclass extends HTMLElement {\n\t\tpublic connectedCallback() {\n\t\t\tconst islandProps = parse(this.getAttribute(\"island-props\") ?? \"{}\");\n\t\t\tconst islandSrc = this.getAttribute(\"island-src\");\n\t\t\tconst islandEntry = this.getAttribute(\"island-entry\");\n\t\t\t// oxlint-disable-next-line typescript/no-unsafe-type-assertion\n\t\t\tconst islandClient = (this.getAttribute(\"island-client\") ??\n\t\t\t\t\"load\") as IslandClientDirective;\n\n\t\t\tif (!islandSrc) {\n\t\t\t\tthrow new Error(\"Missing island-src attribute\");\n\t\t\t}\n\n\t\t\tif (!islandEntry) {\n\t\t\t\tthrow new Error(\"Missing island-entry attribute\");\n\t\t\t}\n\n\t\t\tconst hydrateIsland = (mod: Record<string, FC>) => {\n\t\t\t\tconst Comp = mod[islandEntry];\n\n\t\t\t\tif (!Comp) {\n\t\t\t\t\tthrow new Error(`Missing island entry ${islandEntry} in ${islandSrc}`);\n\t\t\t\t}\n\n\t\t\t\thydrateRoot(this, <Comp {...islandProps} />);\n\t\t\t};\n\n\t\t\tconst initIsland = () => {\n\t\t\t\tconst src = withLeadingSlash(islandSrc);\n\t\t\t\tvoid __island_raw_import__<Record<string, FC>>(src).then(hydrateIsland);\n\t\t\t};\n\n\t\t\tswitch (islandClient) {\n\t\t\t\tcase true:\n\t\t\t\tcase \"load\":\n\t\t\t\t\tinitIsland();\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"idle\":\n\t\t\t\t\trequestIdleCallback(initIsland);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"visible\":\n\t\t\t\t\t// yamf-island has `display: contents` which breaks IntersectionObserver\n\t\t\t\t\t// so we have to observe the first child instead if it exists\n\t\t\t\t\tif (this.firstElementChild) {\n\t\t\t\t\t\tobserve(this.firstElementChild, initIsland);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tinitIsland();\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\tcase false:\n\t\t\t\tcase \"skip\":\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tislandClient satisfies never;\n\t\t\t\t\t// oxlint-disable-next-line typescript/restrict-template-expressions\n\t\t\t\t\tthrow new Error(`Invalid island-client value: ${islandClient}`);\n\t\t\t}\n\t\t}\n\n\t\tpublic disconnectedCallback() {\n\t\t\tunobserve(this);\n\t\t}\n\t},\n);\n"],"mappings":";;;;;AAQA,MAAM,4BAAY,IAAI,QAA+B;AAErD,MAAM,WAAW,IAAI,sBAAqB,YAAW;CACpD,KAAK,MAAM,SAAS,SACnB,IAAI,MAAM,gBAAgB;EACzB,UAAU,IAAI,MAAM,MAAM,CAAC,GAAG;EAC9B,UAAU,MAAM,MAAM;CACvB;AAEF,CAAC;AAED,MAAM,WAAW,QAAiB,OAAqB;CACtD,SAAS,QAAQ,MAAM;CACvB,UAAU,IAAI,QAAQ,EAAE;AACzB;AAEA,MAAM,aAAa,WAAoB;CACtC,SAAS,UAAU,MAAM;CACzB,UAAU,OAAO,MAAM;AACxB;AAEA,eAAe,OACd,eACA,cAAc,YAAY;CACzB,oBAA2B;EAC1B,MAAM,cAAc,MAAM,KAAK,aAAa,cAAc,KAAK,IAAI;EACnE,MAAM,YAAY,KAAK,aAAa,YAAY;EAChD,MAAM,cAAc,KAAK,aAAa,cAAc;EAEpD,MAAM,eAAgB,KAAK,aAAa,eAAe,KACtD;EAED,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,8BAA8B;EAG/C,IAAI,CAAC,aACJ,MAAM,IAAI,MAAM,gCAAgC;EAGjD,MAAM,iBAAiB,QAA4B;GAClD,MAAM,OAAO,IAAI;GAEjB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,wBAAwB,YAAY,MAAM,WAAW;GAGtE,YAAY,MAAM,oBAAC,MAAD,EAAM,GAAI,YAAc,CAAA,CAAC;EAC5C;EAEA,MAAM,mBAAmB;GACxB,MAAM,MAAM,iBAAiB,SAAS;GACtC,sBAA+C,GAAG,CAAC,CAAC,KAAK,aAAa;EACvE;EAEA,QAAQ,cAAR;GACC,KAAK;GACL,KAAK;IACJ,WAAW;IACX;GACD,KAAK;IACJ,oBAAoB,UAAU;IAC9B;GACD,KAAK;IAGJ,IAAI,KAAK,mBACR,QAAQ,KAAK,mBAAmB,UAAU;SAE1C,WAAW;IAEZ;GACD,KAAK;GACL,KAAK,QACJ;GACD,SAGC,MAAM,IAAI,MAAM,gCAAgC,cAAc;EAChE;CACD;CAEA,uBAA8B;EAC7B,UAAU,IAAI;CACf;AACD,CACD"}

package/dist/island/types.d.ts

@@ -1,5 +1,5 @@
 //#region src/island/types.d.ts
-type IslandClientDirective = "load" | "idle" | "visible" | "skip";
+type IslandClientDirective = "load" | "idle" | "visible" | "skip" | boolean;
 interface IslandProps {
   "yamf-client"?: IslandClientDirective;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/island/types.ts"],"mappings":";KAAY,qBAAA;AAAA,UAEK,WAAA;EAChB,aAAA,GAAgB,qBAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/island/types.ts"],"mappings":";KAAY;UAEK;EAChB,gBAAgB"}

package/dist/page.d.ts

@@ -4,7 +4,6 @@ import { Child } from "hono/jsx";
 import { EventHandlerResponse, H3Event, HTTPResponse } from "nitro/h3";
 import { Unhead } from "unhead/server";
 import { UseSeoMetaInput } from "unhead/types";
-
 //#region src/page.d.ts
 type PageHandler = (event: H3Event, params: {
   assets: ImportAssetsResult;
@@ -13,12 +12,12 @@ type PageHandler = (event: H3Event, params: {
 type PageRenderer = (event: H3Event, params: {
   head: Unhead;
   seoHead: (input: UseSeoMetaInput) => void;
-}) => HTTPResponse | Promise<HTTPResponse> | Child | Promise<Child>;
+}) => HTTPResponse | Child | Promise<Child | HTTPResponse>;
 interface DefinePageOptions {
   render: PageRenderer;
   stream?: boolean;
 }
 declare const definePage: (options: DefinePageOptions) => PageHandler;
 //#endregion
-export { PageHandler, definePage };
+export { PageHandler, PageRenderer, definePage };
 //# sourceMappingURL=page.d.ts.map

package/dist/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","names":[],"sources":["../src/page.tsx"],"mappings":";;;;;;;;KAgBY,WAAA,IACX,KAAA,EAAO,OAAA,EACP,MAAA;EACC,MAAA,EAAQ,kBAAA;EACR,IAAA,GAAO,QAAA;AAAA,MAEJ,oBAAA;AAAA,KAEO,YAAA,IACX,KAAA,EAAO,OAAA,EACP,MAAA;EACC,IAAA,EAAM,MAAA;EACN,OAAA,GAAU,KAAA,EAAO,eAAA;AAAA,MAEd,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,KAAA,GAAQ,OAAA,CAAQ,KAAA;AAAA,UAElD,iBAAA;EACT,MAAA,EAAQ,YAAA;EACR,MAAA;AAAA;AAAA,cAGY,UAAA,GAAc,OAAA,EAAS,iBAAA,KAAoB,WAAA"}
+{"version":3,"file":"page.d.ts","names":[],"sources":["../src/page.tsx"],"mappings":";;;;;;;KAgBY,eACX,OAAO,SACP;EACC,QAAQ;EACR,OAAO;MAEJ;KAEO,gBACX,OAAO,SACP;EACC,MAAM;EACN,UAAU,OAAO;MAEd,eAAe,QAAQ,QAAQ,QAAQ;UAElC;EACT,QAAQ;EACR;;cAGY,aAAc,SAAS,sBAAoB"}

package/dist/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","names":["Root","RootComponent"],"sources":["../src/page.tsx"],"sourcesContent":["import { Fragment, type Child } from \"hono/jsx\";\nimport { renderToReadableStream } from \"hono/jsx/streaming\";\nimport { Hono } from \"hono/tiny\";\nimport type { EventHandlerResponse, H3Event } from \"nitro/h3\";\nimport { HTTPResponse, withServerTiming } from \"nitro/h3\";\nimport { useSeoMeta } from \"unhead\";\nimport type { Unhead } from \"unhead/server\";\nimport { transformHtmlTemplate } from \"unhead/server\";\nimport { createStreamableHead, wrapStream } from \"unhead/stream/server\";\nimport type { ResolvableLink, UseSeoMetaInput } from \"unhead/types\";\nimport { Root as RootComponent } from \"virtual:yamf:root\";\nimport { template } from \"virtual:yamf:template\";\nimport { SSRContext } from \"./context/ssr\";\nimport type { ImportAssetsResult } from \"./shared/assets\";\nimport { YamfHead } from \"./shared/head\";\n\nexport type PageHandler = (\n\tevent: H3Event,\n\tparams: {\n\t\tassets: ImportAssetsResult;\n\t\thead?: YamfHead;\n\t},\n) => EventHandlerResponse;\n\nexport type PageRenderer = (\n\tevent: H3Event,\n\tparams: {\n\t\thead: Unhead;\n\t\tseoHead: (input: UseSeoMetaInput) => void;\n\t},\n) => HTTPResponse | Promise<HTTPResponse> | Child | Promise<Child>;\n\ninterface DefinePageOptions {\n\trender: PageRenderer;\n\tstream?: boolean;\n}\n\nexport const definePage = (options: DefinePageOptions): PageHandler => {\n\treturn async (event, { assets, head: headInit }) => {\n\t\tconst { head } = createStreamableHead({ init: [headInit] });\n\t\tconst seoHead = (input?: UseSeoMetaInput) => useSeoMeta(head, input);\n\t\tseoHead(headInit?.seo);\n\n\t\thead.push({\n\t\t\tlink: [\n\t\t\t\t...assets.js.map((attrs): ResolvableLink => ({ rel: \"modulepreload\", ...attrs })),\n\t\t\t\t...assets.css.map((attrs): ResolvableLink => ({ rel: \"stylesheet\", ...attrs })),\n\t\t\t],\n\t\t\tscript: [{ type: \"module\", src: assets.entry }],\n\t\t});\n\n\t\tconst content = await options.render(event, { head, seoHead });\n\n\t\tif (content instanceof HTTPResponse) {\n\t\t\treturn content;\n\t\t}\n\n\t\tconst Root = RootComponent ?? Fragment;\n\n\t\tconst App = async () => (\n\t\t\t<SSRContext value={{ head, event }}>\n\t\t\t\t<Root>{content}</Root>\n\t\t\t</SSRContext>\n\t\t);\n\n\t\tconst responseInit = {\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"text/html; charset=utf-8\",\n\t\t\t},\n\t\t};\n\n\t\tif (!options.stream) {\n\t\t\t// TODO: figure out how expensive this is\n\t\t\treturn new Hono()\n\t\t\t\t.get(\"/\", async c =>\n\t\t\t\t\twithServerTiming(event, \"#render\", async () => {\n\t\t\t\t\t\tconst response = await c.html(<App />);\n\n\t\t\t\t\t\tlet html = await response.text();\n\n\t\t\t\t\t\thtml = transformHtmlTemplate(\n\t\t\t\t\t\t\thead,\n\t\t\t\t\t\t\ttemplate.replace(\"<!--ssr-outlet-->\", html ?? \"\"),\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\treturn new Response(html, responseInit);\n\t\t\t\t\t}),\n\t\t\t\t)\n\t\t\t\t.request(\"/\");\n\t\t}\n\n\t\tconst stream = wrapStream(head, renderToReadableStream(<App />), template);\n\n\t\treturn new Response(stream, responseInit);\n\t};\n};\n"],"mappings":";;;;;;;;;;;;AAqCA,MAAa,cAAc,YAA4C;CACtE,OAAO,OAAO,OAAO,EAAE,QAAQ,MAAM,eAAe;EACnD,MAAM,EAAE,SAAS,qBAAqB,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;EAC1D,MAAM,WAAW,UAA4B,WAAW,MAAM,KAAK;EACnE,QAAQ,UAAU,GAAG;EAErB,KAAK,KAAK;GACT,MAAM,CACL,GAAG,OAAO,GAAG,KAAK,WAA2B;IAAE,KAAK;IAAiB,GAAG;GAAM,EAAE,GAChF,GAAG,OAAO,IAAI,KAAK,WAA2B;IAAE,KAAK;IAAc,GAAG;GAAM,EAAE,CAC/E;GACA,QAAQ,CAAC;IAAE,MAAM;IAAU,KAAK,OAAO;GAAM,CAAC;EAC/C,CAAC;EAED,MAAM,UAAU,MAAM,QAAQ,OAAO,OAAO;GAAE;GAAM;EAAQ,CAAC;EAE7D,IAAI,mBAAmB,cACtB,OAAO;EAGR,MAAMA,SAAOC,QAAiB;EAE9B,MAAM,MAAM,YACX,oBAAC,YAAD;GAAY,OAAO;IAAE;IAAM;GAAM;aAChC,oBAACD,QAAD,EAAA,UAAO,QAAc,CAAA;EACV,CAAA;EAGb,MAAM,eAAe,EACpB,SAAS,EACR,gBAAgB,2BACjB,EACD;EAEA,IAAI,CAAC,QAAQ,QAEZ,OAAO,IAAI,KAAK,CAAC,CACf,IAAI,KAAK,OAAM,MACf,iBAAiB,OAAO,WAAW,YAAY;GAG9C,IAAI,OAAO,OAAM,MAFM,EAAE,KAAK,oBAAC,KAAD,CAAM,CAAA,CAAC,EAAA,CAEX,KAAK;GAE/B,OAAO,sBACN,MACA,SAAS,QAAQ,qBAAqB,QAAQ,EAAE,CACjD;GAEA,OAAO,IAAI,SAAS,MAAM,YAAY;EACvC,CAAC,CACF,CAAC,CACA,QAAQ,GAAG;EAGd,MAAM,SAAS,WAAW,MAAM,uBAAuB,oBAAC,KAAD,CAAM,CAAA,CAAC,GAAG,QAAQ;EAEzE,OAAO,IAAI,SAAS,QAAQ,YAAY;CACzC;AACD"}
+{"version":3,"file":"page.js","names":["Root","RootComponent"],"sources":["../src/page.tsx"],"sourcesContent":["import { Fragment, type Child } from \"hono/jsx\";\nimport { renderToReadableStream } from \"hono/jsx/streaming\";\nimport { Hono } from \"hono/tiny\";\nimport type { EventHandlerResponse, H3Event } from \"nitro/h3\";\nimport { HTTPResponse, withServerTiming } from \"nitro/h3\";\nimport { useSeoMeta } from \"unhead\";\nimport type { Unhead } from \"unhead/server\";\nimport { transformHtmlTemplate } from \"unhead/server\";\nimport { createStreamableHead, wrapStream } from \"unhead/stream/server\";\nimport type { ResolvableLink, UseSeoMetaInput } from \"unhead/types\";\nimport { Root as RootComponent } from \"virtual:yamf:root\";\nimport { template } from \"virtual:yamf:template\";\nimport { SSRContext } from \"./context/ssr\";\nimport type { ImportAssetsResult } from \"./shared/assets\";\nimport { YamfHead } from \"./shared/head\";\n\nexport type PageHandler = (\n\tevent: H3Event,\n\tparams: {\n\t\tassets: ImportAssetsResult;\n\t\thead?: YamfHead;\n\t},\n) => EventHandlerResponse;\n\nexport type PageRenderer = (\n\tevent: H3Event,\n\tparams: {\n\t\thead: Unhead;\n\t\tseoHead: (input: UseSeoMetaInput) => void;\n\t},\n) => HTTPResponse | Child | Promise<Child | HTTPResponse>;\n\ninterface DefinePageOptions {\n\trender: PageRenderer;\n\tstream?: boolean;\n}\n\nexport const definePage = (options: DefinePageOptions): PageHandler => {\n\treturn async (event, { assets, head: headInit }) => {\n\t\tconst { head } = createStreamableHead({ init: [headInit] });\n\t\tconst seoHead = (input?: UseSeoMetaInput) => useSeoMeta(head, input);\n\t\tseoHead(headInit?.seo);\n\n\t\thead.push({\n\t\t\tlink: [\n\t\t\t\t...assets.js.map((attrs): ResolvableLink => ({ rel: \"modulepreload\", ...attrs })),\n\t\t\t\t...assets.css.map((attrs): ResolvableLink => ({ rel: \"stylesheet\", ...attrs })),\n\t\t\t],\n\t\t\tscript: [{ type: \"module\", src: assets.entry }],\n\t\t});\n\n\t\tconst content = await options.render(event, { head, seoHead });\n\n\t\tif (content instanceof HTTPResponse) {\n\t\t\treturn content;\n\t\t}\n\n\t\tconst Root = RootComponent ?? Fragment;\n\n\t\tconst App = async () => (\n\t\t\t<SSRContext value={{ head, event }}>\n\t\t\t\t<Root>{content}</Root>\n\t\t\t</SSRContext>\n\t\t);\n\n\t\tconst responseInit = {\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"text/html; charset=utf-8\",\n\t\t\t},\n\t\t};\n\n\t\tif (!options.stream) {\n\t\t\t// TODO: figure out how expensive this is\n\t\t\treturn new Hono()\n\t\t\t\t.get(\"/\", async c =>\n\t\t\t\t\twithServerTiming(event, \"#render\", async () => {\n\t\t\t\t\t\tconst response = await c.html(<App />);\n\n\t\t\t\t\t\tlet html = await response.text();\n\n\t\t\t\t\t\thtml = transformHtmlTemplate(\n\t\t\t\t\t\t\thead,\n\t\t\t\t\t\t\ttemplate.replace(\"<!--ssr-outlet-->\", html ?? \"\"),\n\t\t\t\t\t\t);\n\n\t\t\t\t\t\treturn new Response(html, responseInit);\n\t\t\t\t\t}),\n\t\t\t\t)\n\t\t\t\t.request(\"/\");\n\t\t}\n\n\t\tconst stream = wrapStream(head, renderToReadableStream(<App />), template);\n\n\t\treturn new Response(stream, responseInit);\n\t};\n};\n"],"mappings":";;;;;;;;;;;;AAqCA,MAAa,cAAc,YAA4C;CACtE,OAAO,OAAO,OAAO,EAAE,QAAQ,MAAM,eAAe;EACnD,MAAM,EAAE,SAAS,qBAAqB,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;EAC1D,MAAM,WAAW,UAA4B,WAAW,MAAM,KAAK;EACnE,QAAQ,UAAU,GAAG;EAErB,KAAK,KAAK;GACT,MAAM,CACL,GAAG,OAAO,GAAG,KAAK,WAA2B;IAAE,KAAK;IAAiB,GAAG;GAAM,EAAE,GAChF,GAAG,OAAO,IAAI,KAAK,WAA2B;IAAE,KAAK;IAAc,GAAG;GAAM,EAAE,CAC/E;GACA,QAAQ,CAAC;IAAE,MAAM;IAAU,KAAK,OAAO;GAAM,CAAC;EAC/C,CAAC;EAED,MAAM,UAAU,MAAM,QAAQ,OAAO,OAAO;GAAE;GAAM;EAAQ,CAAC;EAE7D,IAAI,mBAAmB,cACtB,OAAO;EAGR,MAAMA,SAAOC,QAAiB;EAE9B,MAAM,MAAM,YACX,oBAAC,YAAD;GAAY,OAAO;IAAE;IAAM;GAAM;aAChC,oBAACD,QAAD,EAAA,UAAO,QAAc,CAAA;EACV,CAAA;EAGb,MAAM,eAAe,EACpB,SAAS,EACR,gBAAgB,2BACjB,EACD;EAEA,IAAI,CAAC,QAAQ,QAEZ,OAAO,IAAI,KAAK,CAAC,CACf,IAAI,KAAK,OAAM,MACf,iBAAiB,OAAO,WAAW,YAAY;GAG9C,IAAI,OAAO,OAAM,MAFM,EAAE,KAAK,oBAAC,KAAD,CAAM,CAAA,CAAC,EAAA,CAEX,KAAK;GAE/B,OAAO,sBACN,MACA,SAAS,QAAQ,qBAAqB,QAAQ,EAAE,CACjD;GAEA,OAAO,IAAI,SAAS,MAAM,YAAY;EACvC,CAAC,CACF,CAAC,CACA,QAAQ,GAAG;EAGd,MAAM,SAAS,WAAW,MAAM,uBAAuB,oBAAC,KAAD,CAAM,CAAA,CAAC,GAAG,QAAQ;EAEzE,OAAO,IAAI,SAAS,QAAQ,YAAY;CACzC;AACD"}

package/dist/server/entry.d.mts

@@ -1,6 +1,5 @@
 import { YamfHead } from "./shared/head.mjs";
 import { EventHandlerRequest, EventHandlerWithFetch, H3Event } from "nitro/h3";
-
 //#region src/server/entry.d.ts
 type ServerEntry = EventHandlerWithFetch<EventHandlerRequest, Promise<unknown>>;
 interface DefineServerEntryOptions {

package/dist/server/entry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/server/entry.tsx"],"mappings":";;;;KA8CY,WAAA,GAAc,qBAAA,CAAsB,mBAAA,EAAqB,OAAA;AAAA,UAEpD,wBAAA;EAChB,IAAA,GAAO,QAAA,KAAa,KAAA,EAAO,OAAA,KAAY,QAAA;EACvC,iBAAA;AAAA;AAAA,cAGY,iBAAA,GAAqB,OAAA,GAAU,wBAAA,KAA2B,WAAA"}
+{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/server/entry.tsx"],"mappings":";;;KA8CY,cAAc,sBAAsB,qBAAqB;UAEpD;EAChB,OAAO,aAAa,OAAO,YAAY;EACvC;;cAGY,oBAAqB,UAAU,6BAA2B"}

package/dist/server/island/server.d.mts

@@ -1,7 +1,6 @@
 import { ImportAssetsResultRaw } from "../shared/assets.mjs";
 import { IslandClientDirective } from "./types.mjs";
 import { Child, FC } from "hono/jsx";
-
 //#region src/island/server.d.ts
 declare module "hono/jsx" {
   namespace JSX {

package/dist/server/island/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","names":[],"sources":["../../../src/island/server.tsx"],"mappings":";;;;;;YAMW,GAAA;IAAA,UACC,iBAAA;MACT,aAAA;QACC,cAAA;QACA,YAAA;QACA,cAAA;QACA,eAAA,EAAiB,qBAAA;QACjB,QAAA,EAAU,KAAA;QACV,KAAA,GAAQ,GAAA,CAAI,aAAA;MAAA;IAAA;EAAA;AAAA;AAAA,cAMH,YAAA,GACZ,SAAA,EAAW,EAAA,EACX,UAAA,UACA,MAAA,EAAQ,qBAAA,KACN,EAAA"}
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../../src/island/server.tsx"],"mappings":";;;;;YAMW;cACC;MACT;QACC;QACA;QACA;QACA,iBAAiB;QACjB,UAAU;QACV,QAAQ,IAAI;;;;;cAMH,eACZ,WAAW,IACX,oBACA,QAAQ,0BACN"}

package/dist/server/island/types.d.mts

@@ -1,5 +1,5 @@
 //#region src/island/types.d.ts
-type IslandClientDirective = "load" | "idle" | "visible" | "skip";
+type IslandClientDirective = "load" | "idle" | "visible" | "skip" | boolean;
 //#endregion
 export { IslandClientDirective };
 //# sourceMappingURL=types.d.mts.map

package/dist/server/island/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/island/types.ts"],"mappings":";KAAY,qBAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/island/types.ts"],"mappings":";KAAY"}

package/dist/server/shared/assets.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.mts","names":[],"sources":["../../../src/shared/assets.ts"],"mappings":";KAKY,qBAAA;EACX,KAAA;EACA,EAAA;IAAM,IAAA;EAAA;EACN,GAAA;IAAO,IAAA;IAAc,kBAAA;EAAA;AAAA"}
+{"version":3,"file":"assets.d.mts","names":[],"sources":["../../../src/shared/assets.ts"],"mappings":";KAKY;EACX;EACA;IAAM;;EACN;IAAO;IAAc"}

package/dist/server/shared/head.d.mts

@@ -1,5 +1,4 @@
 import { ResolvableHead, UseSeoMetaInput } from "unhead/types";
-
 //#region src/shared/head.d.ts
 type YamfHead = ResolvableHead & {
   seo?: UseSeoMetaInput;

package/dist/server/shared/head.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.mts","names":[],"sources":["../../../src/shared/head.ts"],"mappings":";;;KAEY,QAAA,GAAW,cAAA;EAAmB,GAAA,GAAM,eAAA;AAAA"}
+{"version":3,"file":"head.d.mts","names":[],"sources":["../../../src/shared/head.ts"],"mappings":";;KAEY,WAAW;EAAmB,MAAM"}

package/dist/shared/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","names":[],"sources":["../../src/shared/assets.ts"],"mappings":";KACY,kBAAA,GAAqB,qBAAA;EAChC,KAAA,IAAS,IAAA,EAAM,qBAAA,KAA0B,kBAAA;AAAA;AAAA,KAG9B,qBAAA;EACX,KAAA;EACA,EAAA;IAAM,IAAA;EAAA;EACN,GAAA;IAAO,IAAA;IAAc,kBAAA;EAAA;AAAA"}
+{"version":3,"file":"assets.d.ts","names":[],"sources":["../../src/shared/assets.ts"],"mappings":";KACY,qBAAqB;EAChC,SAAS,MAAM,0BAA0B;;KAG9B;EACX;EACA;IAAM;;EACN;IAAO;IAAc"}

package/dist/shared/head.d.ts

@@ -1,5 +1,4 @@
 import { ResolvableHead, UseSeoMetaInput } from "unhead/types";
-
 //#region src/shared/head.d.ts
 type YamfHead = ResolvableHead & {
   seo?: UseSeoMetaInput;

package/dist/shared/head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.ts","names":[],"sources":["../../src/shared/head.ts"],"mappings":";;;KAEY,QAAA,GAAW,cAAA;EAAmB,GAAA,GAAM,eAAA;AAAA"}
+{"version":3,"file":"head.d.ts","names":[],"sources":["../../src/shared/head.ts"],"mappings":";;KAEY,WAAW;EAAmB,MAAM"}

package/dist/vite/index.d.mts

@@ -1,6 +1,5 @@
 import { NitroPluginConfig } from "nitro/vite";
 import { PluginOption } from "vite";
-
 //#region src/vite/index.d.ts
 interface YamfOptions {
   nitro?: NitroPluginConfig;

package/dist/vite/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vite/index.ts"],"mappings":";;;;UAUiB,WAAA;EAChB,KAAA,GAAQ,iBAAA;AAAA;AAAA,cAGH,IAAA,GAAQ,OAAA,GAAU,WAAA,KAAc,YAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vite/index.ts"],"mappings":";;;UAUiB;EAChB,QAAQ;;cAGH,OAAQ,UAAU,gBAAc"}

package/dist/vite/virtual-pages.mjs

@@ -11,11 +11,12 @@ const virtualPages = () => {
 		load(id) {
 			if (id !== resolvedVirtualModuleId) return;
 			return js`
-const pages = import.meta.glob("/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}", {
+const pages = import.meta.glob("/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}", {
 	import: "default",
 });
+
 const assets = import.meta.glob(
-	"/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}",
+	"/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}",
 	{
 		import: "default",
 		query: "?assets=ssr",

package/dist/vite/virtual-pages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-pages.mjs","names":[],"sources":["../../src/vite/virtual-pages.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport const virtualPages = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:pages\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-pages\",\n\t\tresolveId(id) {\n\t\t\tif (id === virtualModuleId) {\n\t\t\t\treturn resolvedVirtualModuleId;\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t},\n\t\tload(id) {\n\t\t\tif (id !== resolvedVirtualModuleId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\treturn js`\nconst pages = import.meta.glob(\"/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}\", {\n\timport: \"default\",\n});\nconst assets = import.meta.glob(\n\t\"/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}\",\n\t{\n\t\timport: \"default\",\n\t\tquery: \"?assets=ssr\",\n\t\teager: true,\n\t},\n);\n\nexport { pages, assets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;AAGA,MAAa,qBAA6B;CACzC,MAAM,kBAAkB;CACxB,MAAM,0BAA0B;CAEhC,OAAO;EACN,MAAM;EACN,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,KAAK,IAAI;GACR,IAAI,OAAO,yBACV;GAGD,OAAO,EAAE;;;;;;;;;;;;;;EAcV,KAAK;EACL;CACD;AACD"}
+{"version":3,"file":"virtual-pages.mjs","names":[],"sources":["../../src/vite/virtual-pages.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport const virtualPages = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:pages\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-pages\",\n\t\tresolveId(id) {\n\t\t\tif (id === virtualModuleId) {\n\t\t\t\treturn resolvedVirtualModuleId;\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t},\n\t\tload(id) {\n\t\t\tif (id !== resolvedVirtualModuleId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\treturn js`\nconst pages = import.meta.glob(\"/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}\", {\n\timport: \"default\",\n});\n\nconst assets = import.meta.glob(\n\t\"/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}\",\n\t{\n\t\timport: \"default\",\n\t\tquery: \"?assets=ssr\",\n\t\teager: true,\n\t},\n);\n\nexport { pages, assets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;AAGA,MAAa,qBAA6B;CACzC,MAAM,kBAAkB;CACxB,MAAM,0BAA0B;CAEhC,OAAO;EACN,MAAM;EACN,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,KAAK,IAAI;GACR,IAAI,OAAO,yBACV;GAGD,OAAO,EAAE;;;;;;;;;;;;;;;EAeV,KAAK;EACL;CACD;AACD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pajecawav/yamf",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Yet another meta framework",
   "license": "MIT",
   "homepage": "https://github.com/pajecawav/yamf#readme",
@@ -39,31 +39,31 @@
     "@babel/traverse": "^7.29.7",
     "@babel/types": "^7.29.7",
     "devalue": "^5.8.1",
-    "exsolve": "^1.0.8",
+    "exsolve": "^1.1.0",
     "nitro": "3.0.260610-beta",
-    "rou3": "^0.8.1",
+    "rou3": "^0.9.1",
     "ufo": "^1.6.4",
-    "unhead": "^3.1.4"
+    "unhead": "^3.1.7"
   },
   "devDependencies": {
-    "@pajecawav/tools": "^0.0.4",
+    "@pajecawav/tools": "^0.0.5",
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
-    "@types/node": "^24.13.2",
-    "@typescript/native-preview": "7.0.0-dev.20260612.1",
-    "@vitest/coverage-v8": "^4.1.8",
-    "@vitest/ui": "^4.1.8",
+    "@types/node": "^24.13.3",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/ui": "^4.1.10",
     "cross-env": "^10.1.0",
-    "hono": "^4.12.25",
+    "hono": "^4.12.29",
     "husky": "^9.1.7",
-    "npm-run-all2": "^9.0.1",
-    "oxfmt": "^0.54.0",
-    "oxlint": "^1.69.0",
-    "oxlint-tsgolint": "^0.23.0",
+    "npm-run-all2": "^9.0.2",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "oxlint-tsgolint": "^0.24.0",
     "publint": "^0.3.21",
-    "tsdown": "0.22.2",
+    "tsdown": "0.22.4",
+    "typescript": "~7.0.2",
     "vite": "^8.0.16",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsdown",
@@ -77,7 +77,7 @@
     "test:ui": "vitest --ui",
     "lint": "cross-env FORCE_COLOR=1 run-p -l lint:*",
     "lint:oxlint": "oxlint .",
-    "lint:tsc": "tsgo -b --noEmit",
+    "lint:tsc": "tsc -b --noEmit",
     "lint:format": "pt format --check",
     "lint:package": "publint",
     "format": "pt format"

package/src/island/client.tsx

@@ -62,6 +62,7 @@ customElements.define(
 			};
 
 			switch (islandClient) {
+				case true:
 				case "load":
 					initIsland();
 					break;
@@ -77,9 +78,11 @@ customElements.define(
 						initIsland();
 					}
 					break;
+				case false:
 				case "skip":
 					break;
 				default:
+					islandClient satisfies never;
 					// oxlint-disable-next-line typescript/restrict-template-expressions
 					throw new Error(`Invalid island-client value: ${islandClient}`);
 			}

package/src/island/types.ts

@@ -1,4 +1,4 @@
-export type IslandClientDirective = "load" | "idle" | "visible" | "skip";
+export type IslandClientDirective = "load" | "idle" | "visible" | "skip" | boolean;
 
 export interface IslandProps {
 	"yamf-client"?: IslandClientDirective;

package/src/page.tsx

@@ -28,7 +28,7 @@ export type PageRenderer = (
 		head: Unhead;
 		seoHead: (input: UseSeoMetaInput) => void;
 	},
-) => HTTPResponse | Promise<HTTPResponse> | Child | Promise<Child>;
+) => HTTPResponse | Child | Promise<Child | HTTPResponse>;
 
 interface DefinePageOptions {
 	render: PageRenderer;

package/src/vite/virtual-pages.ts

@@ -20,11 +20,12 @@ export const virtualPages = (): Plugin => {
 			}
 
 			return js`
-const pages = import.meta.glob("/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}", {
+const pages = import.meta.glob("/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}", {
 	import: "default",
 });
+
 const assets = import.meta.glob(
-	"/src/pages/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}",
+	"/src/pages/**/*.page.{js,mjs,cjs,ts,mts,cts,tsx,jsx}",
 	{
 		import: "default",
 		query: "?assets=ssr",