@pajecawav/yamf 0.0.7 → 0.0.9

package/dist/vite/islands.mjs

@@ -2,6 +2,20 @@ import { withMagicString } from "rolldown-string";
 import { Visitor } from "vite";
 //#region src/vite/islands.ts
 const ISLAND_REGEX = /\.island\.(j|t)sx?$/;
+const WRAPPABLE_INIT_TYPES = /* @__PURE__ */ new Set([
+	"ArrowFunctionExpression",
+	"FunctionExpression",
+	"CallExpression",
+	"OptionalCallExpression",
+	"Identifier",
+	"ConditionalExpression",
+	"SequenceExpression",
+	"TSAsExpression",
+	"NonNullExpression"
+]);
+const isWrappableInit = (init) => {
+	return WRAPPABLE_INIT_TYPES.has(init.type);
+};
 function langFromId(id) {
 	if (id.endsWith(".tsx")) return "tsx";
 	if (id.endsWith(".ts")) return "ts";
@@ -19,23 +33,37 @@ const islands = () => {
 				s.prepend(`import * as __runtime from "@pajecawav/yamf/server";\n`);
 				s.prepend(`import __assets from "${id}?assets=client";\n`);
 				const seenExports = /* @__PURE__ */ new Set();
+				const warnings = [];
 				new Visitor({
 					ExportDefaultDeclaration(node) {
 						const declaration = node.declaration;
-						if (declaration.type !== "FunctionDeclaration" && declaration.type !== "FunctionExpression" && declaration.type !== "ArrowFunctionExpression") return;
+						if (declaration.type !== "FunctionDeclaration" && declaration.type !== "FunctionExpression" && declaration.type !== "ArrowFunctionExpression") {
+							warnings.push(`${id}: export default <${declaration.type === "Identifier" ? "identifier" : declaration.type}> is not wrapped as an island — only function components are supported`);
+							return;
+						}
 						s.overwrite(node.start, declaration.start, "const __ISLAND__ = ");
 						s.appendRight(declaration.end, `; export default __runtime.createIsland(__ISLAND__, "default", __assets)`);
 					},
 					ExportNamedDeclaration(node) {
 						const declaration = node.declaration;
-						if (declaration?.type === "VariableDeclaration") {
-							const declarator = declaration.declarations[0];
+						if (!declaration) {
+							if (node.exportKind !== "type") warnings.push(`${id}: export { … } statements are not wrapped as islands — export the component with \`export const\` or \`export function\``);
+							return;
+						}
+						if (declaration.type === "VariableDeclaration") {
+							const declarators = declaration.declarations;
+							const declarator = declarators[0];
 							if (!declarator || declarator.id.type !== "Identifier" || !declarator.init || seenExports.has(declarator.id.name)) return;
 							const exportName = declarator.id.name;
+							if (!isWrappableInit(declarator.init)) {
+								warnings.push(`${id}: export "${exportName}" does not look like a component — left as a plain export, not an island`);
+								return;
+							}
+							if (declarators.length > 1) warnings.push(`${id}: only the first declarator of a multi-declarator export is wrapped as an island ("${exportName}") — split the declaration`);
 							seenExports.add(exportName);
 							s.overwrite(node.start, declarator.init.start, `const __wrap_${exportName} = `);
 							s.appendRight(declarator.init.end, `; export const ${exportName} = __runtime.createIsland(__wrap_${exportName}, "${exportName}", __assets)`);
-						} else if (declaration?.type === "FunctionDeclaration") {
+						} else if (declaration.type === "FunctionDeclaration") {
 							const fnId = declaration.id;
 							if (!fnId || fnId.type !== "Identifier" || seenExports.has(fnId.name)) return;
 							const exportName = fnId.name;
@@ -46,6 +74,7 @@ const islands = () => {
 						}
 					}
 				}).visit(program);
+				for (const warning of warnings) this.warn(warning);
 			})
 		}
 	}, {
@@ -53,7 +82,7 @@ const islands = () => {
 		transform: {
 			order: "post",
 			handler: withMagicString(function(s) {
-				if (s.original.includes("__island_raw_import__")) s.replaceAll("__island_raw_import__", "import");
+				if (s.original.includes("__yamf_raw_import__")) s.replaceAll("__yamf_raw_import__", "import");
 			})
 		}
 	}];

package/dist/vite/islands.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"islands.mjs","names":[],"sources":["../../src/vite/islands.ts"],"sourcesContent":["// reference https://github.com/hi-ogawa/vite-plugin-fullstack/blob/28e9540a68529c58842e9a3bf17d2193a065d524/examples/island/src/framework/island/plugin.ts\nimport { withMagicString } from \"rolldown-string\";\nimport type { ParserOptions, Plugin } from \"vite\";\nimport { Visitor } from \"vite\";\n\nconst ISLAND_REGEX = /\\.island\\.(j|t)sx?$/;\n\ntype Lang = NonNullable<ParserOptions[\"lang\"]>;\n\nfunction langFromId(id: string): Lang {\n\tif (id.endsWith(\".tsx\")) return \"tsx\";\n\tif (id.endsWith(\".ts\")) return \"ts\";\n\tif (id.endsWith(\".jsx\")) return \"jsx\";\n\treturn \"js\";\n}\n\nexport const islands = (): Plugin[] => {\n\treturn [\n\t\t{\n\t\t\tname: \"yamf:islands\",\n\t\t\ttransform: {\n\t\t\t\tfilter: { id: ISLAND_REGEX },\n\t\t\t\thandler: withMagicString(function (this, s, id) {\n\t\t\t\t\tif (this.environment.name !== \"ssr\") {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst program = this.parse(s.original, {\n\t\t\t\t\t\tlang: langFromId(id),\n\t\t\t\t\t});\n\n\t\t\t\t\t// prepend server island runtime + asset imports:\n\t\t\t\t\t//   import * as __runtime from \"@pajecawav/yamf/server\";\n\t\t\t\t\t//   import __assets from \"<id>?assets=client\";\n\t\t\t\t\ts.prepend(`import * as __runtime from \"@pajecawav/yamf/server\";\\n`);\n\t\t\t\t\ts.prepend(`import __assets from \"${id}?assets=client\";\\n`);\n\n\t\t\t\t\tconst seenExports = new Set<string>();\n\n\t\t\t\t\tnew Visitor({\n\t\t\t\t\t\tExportDefaultDeclaration(node) {\n\t\t\t\t\t\t\tconst declaration = node.declaration;\n\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\tdeclaration.type !== \"FunctionDeclaration\" &&\n\t\t\t\t\t\t\t\tdeclaration.type !== \"FunctionExpression\" &&\n\t\t\t\t\t\t\t\tdeclaration.type !== \"ArrowFunctionExpression\"\n\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// export default <fn> ->\n\t\t\t\t\t\t\t// const __ISLAND__ = <fn>; export default __runtime.createIsland(__ISLAND__, \"default\", __assets)\n\t\t\t\t\t\t\ts.overwrite(node.start, declaration.start, \"const __ISLAND__ = \");\n\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\tdeclaration.end,\n\t\t\t\t\t\t\t\t`; export default __runtime.createIsland(__ISLAND__, \"default\", __assets)`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tExportNamedDeclaration(node) {\n\t\t\t\t\t\t\tconst declaration = node.declaration;\n\t\t\t\t\t\t\tif (declaration?.type === \"VariableDeclaration\") {\n\t\t\t\t\t\t\t\tconst declarator = declaration.declarations[0];\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t!declarator ||\n\t\t\t\t\t\t\t\t\tdeclarator.id.type !== \"Identifier\" ||\n\t\t\t\t\t\t\t\t\t!declarator.init ||\n\t\t\t\t\t\t\t\t\tseenExports.has(declarator.id.name)\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst exportName = declarator.id.name;\n\t\t\t\t\t\t\t\tseenExports.add(exportName);\n\n\t\t\t\t\t\t\t\t// export const <name> = <init> ->\n\t\t\t\t\t\t\t\t// const __wrap_<name> = <init>; export const <name> = __runtime.createIsland(__wrap_<name>, \"<name>\", __assets)\n\t\t\t\t\t\t\t\ts.overwrite(\n\t\t\t\t\t\t\t\t\tnode.start,\n\t\t\t\t\t\t\t\t\tdeclarator.init.start,\n\t\t\t\t\t\t\t\t\t`const __wrap_${exportName} = `,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\t\tdeclarator.init.end,\n\t\t\t\t\t\t\t\t\t`; export const ${exportName} = __runtime.createIsland(__wrap_${exportName}, \"${exportName}\", __assets)`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t} else if (declaration?.type === \"FunctionDeclaration\") {\n\t\t\t\t\t\t\t\tconst fnId = declaration.id;\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t!fnId ||\n\t\t\t\t\t\t\t\t\tfnId.type !== \"Identifier\" ||\n\t\t\t\t\t\t\t\t\tseenExports.has(fnId.name)\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst exportName = fnId.name;\n\t\t\t\t\t\t\t\tseenExports.add(exportName);\n\n\t\t\t\t\t\t\t\t// export function <name>() {} ->\n\t\t\t\t\t\t\t\t// function __wrap_<name>() {}; export const <name> = __runtime.createIsland(__wrap_<name>, \"<name>\", __assets)\n\t\t\t\t\t\t\t\ts.remove(node.start, declaration.start);\n\t\t\t\t\t\t\t\ts.overwrite(fnId.start, fnId.end, `__wrap_${exportName}`);\n\t\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\t\tdeclaration.end,\n\t\t\t\t\t\t\t\t\t`; export const ${exportName} = __runtime.createIsland(__wrap_${exportName}, \"${exportName}\", __assets)`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t}).visit(program);\n\t\t\t\t}),\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"yamf:islands:raw-import\",\n\t\t\ttransform: {\n\t\t\t\torder: \"post\",\n\t\t\t\thandler: withMagicString(function (s) {\n\t\t\t\t\tif (s.original.includes(\"__island_raw_import__\")) {\n\t\t\t\t\t\ts.replaceAll(\"__island_raw_import__\", \"import\");\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t},\n\t\t},\n\t];\n};\n"],"mappings":";;;AAKA,MAAM,eAAe;AAIrB,SAAS,WAAW,IAAkB;CACrC,IAAI,GAAG,SAAS,MAAM,GAAG,OAAO;CAChC,IAAI,GAAG,SAAS,KAAK,GAAG,OAAO;CAC/B,IAAI,GAAG,SAAS,MAAM,GAAG,OAAO;CAChC,OAAO;AACR;AAEA,MAAa,gBAA0B;CACtC,OAAO,CACN;EACC,MAAM;EACN,WAAW;GACV,QAAQ,EAAE,IAAI,aAAa;GAC3B,SAAS,gBAAgB,SAAgB,GAAG,IAAI;IAC/C,IAAI,KAAK,YAAY,SAAS,OAC7B;IAGD,MAAM,UAAU,KAAK,MAAM,EAAE,UAAU,EACtC,MAAM,WAAW,EAAE,EACpB,CAAC;IAKD,EAAE,QAAQ,wDAAwD;IAClE,EAAE,QAAQ,yBAAyB,GAAG,mBAAmB;IAEzD,MAAM,8BAAc,IAAI,IAAY;IAEpC,IAAI,QAAQ;KACX,yBAAyB,MAAM;MAC9B,MAAM,cAAc,KAAK;MACzB,IACC,YAAY,SAAS,yBACrB,YAAY,SAAS,wBACrB,YAAY,SAAS,2BAErB;MAKD,EAAE,UAAU,KAAK,OAAO,YAAY,OAAO,qBAAqB;MAChE,EAAE,YACD,YAAY,KACZ,0EACD;KACD;KACA,uBAAuB,MAAM;MAC5B,MAAM,cAAc,KAAK;MACzB,IAAI,aAAa,SAAS,uBAAuB;OAChD,MAAM,aAAa,YAAY,aAAa;OAC5C,IACC,CAAC,cACD,WAAW,GAAG,SAAS,gBACvB,CAAC,WAAW,QACZ,YAAY,IAAI,WAAW,GAAG,IAAI,GAElC;OAED,MAAM,aAAa,WAAW,GAAG;OACjC,YAAY,IAAI,UAAU;OAI1B,EAAE,UACD,KAAK,OACL,WAAW,KAAK,OAChB,gBAAgB,WAAW,IAC5B;OACA,EAAE,YACD,WAAW,KAAK,KAChB,kBAAkB,WAAW,mCAAmC,WAAW,KAAK,WAAW,aAC5F;MACD,OAAO,IAAI,aAAa,SAAS,uBAAuB;OACvD,MAAM,OAAO,YAAY;OACzB,IACC,CAAC,QACD,KAAK,SAAS,gBACd,YAAY,IAAI,KAAK,IAAI,GAEzB;OAED,MAAM,aAAa,KAAK;OACxB,YAAY,IAAI,UAAU;OAI1B,EAAE,OAAO,KAAK,OAAO,YAAY,KAAK;OACtC,EAAE,UAAU,KAAK,OAAO,KAAK,KAAK,UAAU,YAAY;OACxD,EAAE,YACD,YAAY,KACZ,kBAAkB,WAAW,mCAAmC,WAAW,KAAK,WAAW,aAC5F;MACD;KACD;IACD,CAAC,CAAC,CAAC,MAAM,OAAO;GACjB,CAAC;EACF;CACD,GACA;EACC,MAAM;EACN,WAAW;GACV,OAAO;GACP,SAAS,gBAAgB,SAAU,GAAG;IACrC,IAAI,EAAE,SAAS,SAAS,uBAAuB,GAC9C,EAAE,WAAW,yBAAyB,QAAQ;GAEhD,CAAC;EACF;CACD,CACD;AACD"}
+{"version":3,"file":"islands.mjs","names":[],"sources":["../../src/vite/islands.ts"],"sourcesContent":["// reference https://github.com/hi-ogawa/vite-plugin-fullstack/blob/28e9540a68529c58842e9a3bf17d2193a065d524/examples/island/src/framework/island/plugin.ts\nimport { withMagicString } from \"rolldown-string\";\nimport type { ParserOptions, Plugin } from \"vite\";\nimport { Visitor } from \"vite\";\n\nconst ISLAND_REGEX = /\\.island\\.(j|t)sx?$/;\n\n// inits that can plausibly evaluate to a component; anything else (object,\n// array, literal, class…) is left as a plain export with a warning\nconst WRAPPABLE_INIT_TYPES = new Set([\n\t\"ArrowFunctionExpression\",\n\t\"FunctionExpression\",\n\t\"CallExpression\",\n\t\"OptionalCallExpression\",\n\t\"Identifier\",\n\t\"ConditionalExpression\",\n\t\"SequenceExpression\",\n\t\"TSAsExpression\",\n\t\"NonNullExpression\",\n]);\n\nconst isWrappableInit = (init: { type: string }): boolean => {\n\treturn WRAPPABLE_INIT_TYPES.has(init.type);\n};\n\ntype Lang = NonNullable<ParserOptions[\"lang\"]>;\n\nfunction langFromId(id: string): Lang {\n\tif (id.endsWith(\".tsx\")) {\n\t\treturn \"tsx\";\n\t}\n\tif (id.endsWith(\".ts\")) {\n\t\treturn \"ts\";\n\t}\n\tif (id.endsWith(\".jsx\")) {\n\t\treturn \"jsx\";\n\t}\n\treturn \"js\";\n}\n\nexport const islands = (): Plugin[] => {\n\treturn [\n\t\t{\n\t\t\tname: \"yamf:islands\",\n\t\t\ttransform: {\n\t\t\t\tfilter: { id: ISLAND_REGEX },\n\t\t\t\thandler: withMagicString(function (this, s, id) {\n\t\t\t\t\tif (this.environment.name !== \"ssr\") {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst program = this.parse(s.original, {\n\t\t\t\t\t\tlang: langFromId(id),\n\t\t\t\t\t});\n\n\t\t\t\t\t// prepend server island runtime + asset imports:\n\t\t\t\t\t//   import * as __runtime from \"@pajecawav/yamf/server\";\n\t\t\t\t\t//   import __assets from \"<id>?assets=client\";\n\t\t\t\t\ts.prepend(`import * as __runtime from \"@pajecawav/yamf/server\";\\n`);\n\t\t\t\t\ts.prepend(`import __assets from \"${id}?assets=client\";\\n`);\n\n\t\t\t\t\tconst seenExports = new Set<string>();\n\t\t\t\t\tconst warnings: string[] = [];\n\n\t\t\t\t\tnew Visitor({\n\t\t\t\t\t\tExportDefaultDeclaration(node) {\n\t\t\t\t\t\t\tconst declaration = node.declaration;\n\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\tdeclaration.type !== \"FunctionDeclaration\" &&\n\t\t\t\t\t\t\t\tdeclaration.type !== \"FunctionExpression\" &&\n\t\t\t\t\t\t\t\tdeclaration.type !== \"ArrowFunctionExpression\"\n\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\twarnings.push(\n\t\t\t\t\t\t\t\t\t`${id}: export default <${declaration.type === \"Identifier\" ? \"identifier\" : declaration.type}> is not wrapped as an island — only function components are supported`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// export default <fn> ->\n\t\t\t\t\t\t\t// const __ISLAND__ = <fn>; export default __runtime.createIsland(__ISLAND__, \"default\", __assets)\n\t\t\t\t\t\t\ts.overwrite(node.start, declaration.start, \"const __ISLAND__ = \");\n\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\tdeclaration.end,\n\t\t\t\t\t\t\t\t`; export default __runtime.createIsland(__ISLAND__, \"default\", __assets)`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tExportNamedDeclaration(node) {\n\t\t\t\t\t\t\tconst declaration = node.declaration;\n\n\t\t\t\t\t\t\tif (!declaration) {\n\t\t\t\t\t\t\t\tif (node.exportKind !== \"type\") {\n\t\t\t\t\t\t\t\t\twarnings.push(\n\t\t\t\t\t\t\t\t\t\t`${id}: export { … } statements are not wrapped as islands — export the component with \\`export const\\` or \\`export function\\``,\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tif (declaration.type === \"VariableDeclaration\") {\n\t\t\t\t\t\t\t\tconst declarators = declaration.declarations;\n\t\t\t\t\t\t\t\tconst declarator = declarators[0];\n\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t!declarator ||\n\t\t\t\t\t\t\t\t\tdeclarator.id.type !== \"Identifier\" ||\n\t\t\t\t\t\t\t\t\t!declarator.init ||\n\t\t\t\t\t\t\t\t\tseenExports.has(declarator.id.name)\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tconst exportName = declarator.id.name;\n\n\t\t\t\t\t\t\t\tif (!isWrappableInit(declarator.init)) {\n\t\t\t\t\t\t\t\t\twarnings.push(\n\t\t\t\t\t\t\t\t\t\t`${id}: export \"${exportName}\" does not look like a component — left as a plain export, not an island`,\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tif (declarators.length > 1) {\n\t\t\t\t\t\t\t\t\twarnings.push(\n\t\t\t\t\t\t\t\t\t\t`${id}: only the first declarator of a multi-declarator export is wrapped as an island (\"${exportName}\") — split the declaration`,\n\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tseenExports.add(exportName);\n\n\t\t\t\t\t\t\t\t// export const <name> = <init> ->\n\t\t\t\t\t\t\t\t// const __wrap_<name> = <init>; export const <name> = __runtime.createIsland(__wrap_<name>, \"<name>\", __assets)\n\t\t\t\t\t\t\t\ts.overwrite(\n\t\t\t\t\t\t\t\t\tnode.start,\n\t\t\t\t\t\t\t\t\tdeclarator.init.start,\n\t\t\t\t\t\t\t\t\t`const __wrap_${exportName} = `,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\t\tdeclarator.init.end,\n\t\t\t\t\t\t\t\t\t`; export const ${exportName} = __runtime.createIsland(__wrap_${exportName}, \"${exportName}\", __assets)`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t} else if (declaration.type === \"FunctionDeclaration\") {\n\t\t\t\t\t\t\t\tconst fnId = declaration.id;\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t!fnId ||\n\t\t\t\t\t\t\t\t\tfnId.type !== \"Identifier\" ||\n\t\t\t\t\t\t\t\t\tseenExports.has(fnId.name)\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tconst exportName = fnId.name;\n\t\t\t\t\t\t\t\tseenExports.add(exportName);\n\n\t\t\t\t\t\t\t\t// export function <name>() {} ->\n\t\t\t\t\t\t\t\t// function __wrap_<name>() {}; export const <name> = __runtime.createIsland(__wrap_<name>, \"<name>\", __assets)\n\t\t\t\t\t\t\t\ts.remove(node.start, declaration.start);\n\t\t\t\t\t\t\t\ts.overwrite(fnId.start, fnId.end, `__wrap_${exportName}`);\n\t\t\t\t\t\t\t\ts.appendRight(\n\t\t\t\t\t\t\t\t\tdeclaration.end,\n\t\t\t\t\t\t\t\t\t`; export const ${exportName} = __runtime.createIsland(__wrap_${exportName}, \"${exportName}\", __assets)`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t}).visit(program);\n\n\t\t\t\t\tfor (const warning of warnings) {\n\t\t\t\t\t\tthis.warn(warning);\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"yamf:islands:raw-import\",\n\t\t\ttransform: {\n\t\t\t\torder: \"post\",\n\t\t\t\thandler: withMagicString(function (s) {\n\t\t\t\t\t// the token is namespaced to avoid colliding with user code\n\t\t\t\t\tif (s.original.includes(\"__yamf_raw_import__\")) {\n\t\t\t\t\t\ts.replaceAll(\"__yamf_raw_import__\", \"import\");\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t},\n\t\t},\n\t];\n};\n"],"mappings":"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"}

package/dist/vite/prerender.mjs

@@ -0,0 +1,16 @@
+//#region src/vite/prerender.ts
+const prerenderModule = {
+	name: "yamf:prerender",
+	setup(nitro) {
+		nitro.hooks.hook("prerender:config", (config) => {
+			config.serverEntry = false;
+		});
+		nitro.hooks.hook("prerender:generate", (route) => {
+			if (route.route === "/404" && !route.error && !route.skip) route.fileName = "404.html";
+		});
+	}
+};
+//#endregion
+export { prerenderModule };
+
+//# sourceMappingURL=prerender.mjs.map

package/dist/vite/prerender.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender.mjs","names":[],"sources":["../../src/vite/prerender.ts"],"sourcesContent":["import type { NitroModule } from \"nitro/types\";\n\n// Nitro's prerenderer is a standalone rolldown build (`nitro-prerender` preset)\n// that cannot run yamf's vite plugins, so `virtual:yamf:*` modules, the islands\n// transform, and the vite asset manifests do not exist there. Its auto-detected\n// serverEntry (src/server.tsx) would be bundled by rolldown and crash the\n// worker at init (`Received protocol 'virtual:'`). Disabling it lets prerender\n// requests fall through to the inherited renderer — nitro's vite ssr-renderer —\n// which dispatches them into the vite-built ssr service bundle: the exact code\n// path the production server uses.\nexport const prerenderModule: NitroModule = {\n\tname: \"yamf:prerender\",\n\tsetup(nitro) {\n\t\tnitro.hooks.hook(\"prerender:config\", config => {\n\t\t\tconfig.serverEntry = false;\n\t\t});\n\n\t\tnitro.hooks.hook(\"prerender:generate\", route => {\n\t\t\t// static hosts (github-pages & friends) expect the not-found document\n\t\t\t// at exactly /404.html; nitro would write /404 as 404/index.html\n\t\t\t// (autoSubfolderIndex)\n\t\t\tif (route.route === \"/404\" && !route.error && !route.skip) {\n\t\t\t\troute.fileName = \"404.html\";\n\t\t\t}\n\t\t});\n\t},\n};\n"],"mappings":";AAUA,MAAa,kBAA+B;CAC3C,MAAM;CACN,MAAM,OAAO;EACZ,MAAM,MAAM,KAAK,qBAAoB,WAAU;GAC9C,OAAO,cAAc;EACtB,CAAC;EAED,MAAM,MAAM,KAAK,uBAAsB,UAAS;GAI/C,IAAI,MAAM,UAAU,UAAU,CAAC,MAAM,SAAS,CAAC,MAAM,MACpD,MAAM,WAAW;EAEnB,CAAC;CACF;AACD"}

package/dist/vite/virtual-assets.mjs

@@ -2,7 +2,7 @@ import { js } from "./shared/utils.mjs";
 //#region src/vite/virtual-assets.ts
 const virtualAssets = () => {
 	const virtualModuleId = "virtual:yamf:assets";
-	const resolvedVirtualModuleId = "\0virtual:yamf:assets";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
 	return {
 		name: "yamf:virtual-assets",
 		resolveId(id) {

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-assets.mjs","names":[],"sources":["../../src/vite/virtual-assets.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport const virtualAssets = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:assets\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-assets\",\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`\nimport clientAssets from \"./src/client?assets=client\";\n\nexport { clientAssets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;AAGA,MAAa,sBAA8B;CAC1C,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;;;;EAIV,KAAK;EACL;CACD;AACD"}
+{"version":3,"file":"virtual-assets.mjs","names":[],"sources":["../../src/vite/virtual-assets.ts"],"sourcesContent":["import type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport const virtualAssets = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:assets\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-assets\",\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`\nimport clientAssets from \"./src/client?assets=client\";\n\nexport { clientAssets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;AAGA,MAAa,sBAA8B;CAC1C,MAAM,kBAAkB;CACxB,MAAM,0BAA0B,OAAO;CAEvC,OAAO;EACN,MAAM;EACN,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,KAAK,IAAI;GACR,IAAI,OAAO,yBACV;GAGD,OAAO,EAAE;;;;EAIV,KAAK;EACL;CACD;AACD"}

package/dist/vite/virtual-error-handler.mjs

@@ -2,7 +2,7 @@ import { js } from "./shared/utils.mjs";
 //#region src/vite/virtual-error-handler.ts
 const virtualErrorHandler = (options) => {
 	const virtualModuleId = "virtual:yamf:error-handler";
-	const resolvedVirtualModuleId = "\0virtual:yamf:error-handler";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
 	return {
 		name: "yamf:virtual-error-handler",
 		resolveId(id) {

package/dist/vite/virtual-error-handler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-error-handler.mjs","names":[],"sources":["../../src/vite/virtual-error-handler.ts"],"sourcesContent":["import type { NitroPluginConfig } from \"nitro/vite\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport interface VirtualErrorHandlerOptions {\n\tnitro?: NitroPluginConfig;\n}\n\nexport const virtualErrorHandler = (options?: VirtualErrorHandlerOptions): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:error-handler\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-error-handler\",\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\tconst errorHandler = options?.nitro?.errorHandler;\n\n\t\t\tif (!errorHandler) {\n\t\t\t\treturn js`export const errorHandler = null;`;\n\t\t\t}\n\n\t\t\tif (Array.isArray(errorHandler)) {\n\t\t\t\tthrow new Error(\"Multiple error handlers are not supported\");\n\t\t\t}\n\n\t\t\treturn js`export { default as errorHandler } from \"${errorHandler}\";`;\n\t\t},\n\t};\n};\n"],"mappings":";;AAQA,MAAa,uBAAuB,YAAiD;CACpF,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,MAAM,eAAe,SAAS,OAAO;GAErC,IAAI,CAAC,cACJ,OAAO,EAAE;GAGV,IAAI,MAAM,QAAQ,YAAY,GAC7B,MAAM,IAAI,MAAM,2CAA2C;GAG5D,OAAO,EAAE,4CAA4C,aAAa;EACnE;CACD;AACD"}
+{"version":3,"file":"virtual-error-handler.mjs","names":[],"sources":["../../src/vite/virtual-error-handler.ts"],"sourcesContent":["import type { NitroPluginConfig } from \"nitro/vite\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nexport interface VirtualErrorHandlerOptions {\n\tnitro?: NitroPluginConfig;\n}\n\nexport const virtualErrorHandler = (options?: VirtualErrorHandlerOptions): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:error-handler\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-error-handler\",\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\tconst errorHandler = options?.nitro?.errorHandler;\n\n\t\t\tif (!errorHandler) {\n\t\t\t\treturn js`export const errorHandler = null;`;\n\t\t\t}\n\n\t\t\tif (Array.isArray(errorHandler)) {\n\t\t\t\tthrow new Error(\"Multiple error handlers are not supported\");\n\t\t\t}\n\n\t\t\treturn js`export { default as errorHandler } from \"${errorHandler}\";`;\n\t\t},\n\t};\n};\n"],"mappings":";;AAQA,MAAa,uBAAuB,YAAiD;CACpF,MAAM,kBAAkB;CACxB,MAAM,0BAA0B,OAAO;CAEvC,OAAO;EACN,MAAM;EACN,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,KAAK,IAAI;GACR,IAAI,OAAO,yBACV;GAGD,MAAM,eAAe,SAAS,OAAO;GAErC,IAAI,CAAC,cACJ,OAAO,EAAE;GAGV,IAAI,MAAM,QAAQ,YAAY,GAC7B,MAAM,IAAI,MAAM,2CAA2C;GAG5D,OAAO,EAAE,4CAA4C,aAAa;EACnE;CACD;AACD"}

package/dist/vite/virtual-pages.mjs

@@ -2,7 +2,7 @@ import { js } from "./shared/utils.mjs";
 //#region src/vite/virtual-pages.ts
 const virtualPages = () => {
 	const virtualModuleId = "virtual:yamf:pages";
-	const resolvedVirtualModuleId = "\0virtual:yamf:pages";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
 	return {
 		name: "yamf:virtual-pages",
 		resolveId(id) {

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/**/*.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"}
+{"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,OAAO;CAEvC,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/dist/vite/virtual-root.mjs

@@ -1,18 +1,24 @@
 import { js } from "./shared/utils.mjs";
+import { resolve } from "node:path";
 import { resolveModulePath } from "exsolve";
 //#region src/vite/virtual-root.ts
 const ROOT_PATH = "./src/root";
 const virtualRoot = () => {
 	const virtualModuleId = "virtual:yamf:root";
-	const resolvedVirtualModuleId = "\0virtual:yamf:root";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
+	let root = process.cwd();
 	return {
 		name: "yamf:virtual-root",
+		configResolved(config) {
+			root = config.root;
+		},
 		resolveId(id) {
 			if (id === virtualModuleId) return resolvedVirtualModuleId;
 		},
 		load(id) {
 			if (id !== resolvedVirtualModuleId) return;
-			if (!resolveModulePath(ROOT_PATH, {
+			const rootPath = resolve(root, ROOT_PATH);
+			const rootModule = resolveModulePath(rootPath, {
 				try: true,
 				suffixes: ["", "/index"],
 				extensions: [
@@ -25,15 +31,16 @@ const virtualRoot = () => {
 					".mts",
 					".cts"
 				]
-			})) return js`
+			});
+			if (!rootModule) return js`
 const Root = null;
 const rootAssets = null;
 
 export { Root, rootAssets };
         `;
 			return js`
-import Root from "${ROOT_PATH}";
-import rootAssets from "${ROOT_PATH}?assets=ssr";
+import Root from "${rootModule}";
+import rootAssets from "${rootModule}?assets=ssr";
 
 export { Root, rootAssets };
 `.trim();

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-root.mjs","names":[],"sources":["../../src/vite/virtual-root.ts"],"sourcesContent":["import { resolveModulePath } from \"exsolve\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nconst ROOT_PATH = \"./src/root\";\n\nexport const virtualRoot = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:root\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-root\",\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\tconst root = resolveModulePath(ROOT_PATH, {\n\t\t\t\ttry: true,\n\t\t\t\tsuffixes: [\"\", \"/index\"],\n\t\t\t\textensions: [\".tsx\", \".jsx\", \".ts\", \".js\", \".mjs\", \".cjs\", \".mts\", \".cts\"],\n\t\t\t});\n\n\t\t\tif (!root) {\n\t\t\t\treturn js`\nconst Root = null;\nconst rootAssets = null;\n\nexport { Root, rootAssets };\n        `;\n\t\t\t}\n\n\t\t\treturn js`\nimport Root from \"${ROOT_PATH}\";\nimport rootAssets from \"${ROOT_PATH}?assets=ssr\";\n\nexport { Root, rootAssets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;;AAIA,MAAM,YAAY;AAElB,MAAa,oBAA4B;CACxC,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;GASD,IAAI,CANS,kBAAkB,WAAW;IACzC,KAAK;IACL,UAAU,CAAC,IAAI,QAAQ;IACvB,YAAY;KAAC;KAAQ;KAAQ;KAAO;KAAO;KAAQ;KAAQ;KAAQ;IAAM;GAC1E,CAEQ,GACP,OAAO,EAAE;;;;;;GAQV,OAAO,EAAE;oBACQ,UAAU;0BACJ,UAAU;;;EAGlC,KAAK;EACL;CACD;AACD"}
+{"version":3,"file":"virtual-root.mjs","names":[],"sources":["../../src/vite/virtual-root.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { resolveModulePath } from \"exsolve\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nconst ROOT_PATH = \"./src/root\";\n\nexport const virtualRoot = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:root\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\t// resolved against the vite root (not cwd) so running vite from another\n\t// working directory does not silently skip the root layout\n\tlet root = process.cwd();\n\n\treturn {\n\t\tname: \"yamf:virtual-root\",\n\t\tconfigResolved(config) {\n\t\t\troot = config.root;\n\t\t},\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\tconst rootPath = resolve(root, ROOT_PATH);\n\n\t\t\tconst rootModule = resolveModulePath(rootPath, {\n\t\t\t\ttry: true,\n\t\t\t\tsuffixes: [\"\", \"/index\"],\n\t\t\t\textensions: [\".tsx\", \".jsx\", \".ts\", \".js\", \".mjs\", \".cjs\", \".mts\", \".cts\"],\n\t\t\t});\n\n\t\t\tif (!rootModule) {\n\t\t\t\treturn js`\nconst Root = null;\nconst rootAssets = null;\n\nexport { Root, rootAssets };\n        `;\n\t\t\t}\n\n\t\t\treturn js`\nimport Root from \"${rootModule}\";\nimport rootAssets from \"${rootModule}?assets=ssr\";\n\nexport { Root, rootAssets };\n`.trim();\n\t\t},\n\t};\n};\n"],"mappings":";;;;AAKA,MAAM,YAAY;AAElB,MAAa,oBAA4B;CACxC,MAAM,kBAAkB;CACxB,MAAM,0BAA0B,OAAO;CAIvC,IAAI,OAAO,QAAQ,IAAI;CAEvB,OAAO;EACN,MAAM;EACN,eAAe,QAAQ;GACtB,OAAO,OAAO;EACf;EACA,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,KAAK,IAAI;GACR,IAAI,OAAO,yBACV;GAGD,MAAM,WAAW,QAAQ,MAAM,SAAS;GAExC,MAAM,aAAa,kBAAkB,UAAU;IAC9C,KAAK;IACL,UAAU,CAAC,IAAI,QAAQ;IACvB,YAAY;KAAC;KAAQ;KAAQ;KAAO;KAAO;KAAQ;KAAQ;KAAQ;IAAM;GAC1E,CAAC;GAED,IAAI,CAAC,YACJ,OAAO,EAAE;;;;;;GAQV,OAAO,EAAE;oBACQ,WAAW;0BACL,WAAW;;;EAGnC,KAAK;EACL;CACD;AACD"}

package/dist/vite/virtual-template.mjs

@@ -1,6 +1,6 @@
 import { js } from "./shared/utils.mjs";
+import { isAbsolute, relative, resolve } from "node:path";
 import { readFile } from "node:fs/promises";
-import { relative } from "node:path";
 //#region src/vite/virtual-template.ts
 const TEMPLATE_PATH = "./src/template.html";
 const DEFAULT_TEMPLATE = `
@@ -14,16 +14,20 @@ const DEFAULT_TEMPLATE = `
 `.trim();
 const virtualTemplate = () => {
 	const virtualModuleId = "virtual:yamf:template";
-	const resolvedVirtualModuleId = "\0virtual:yamf:template";
+	const resolvedVirtualModuleId = "\0" + virtualModuleId;
+	let root = process.cwd();
 	return {
 		name: "yamf:virtual-template",
+		configResolved(config) {
+			root = config.root;
+		},
 		resolveId(id) {
 			if (id === virtualModuleId) return resolvedVirtualModuleId;
 		},
 		async load(id) {
 			if (id !== resolvedVirtualModuleId) return;
 			try {
-				const template = await readFile(TEMPLATE_PATH, "utf8");
+				const template = await readFile(resolve(root, TEMPLATE_PATH), "utf8");
 				return js`export const template = ${JSON.stringify(template)};`;
 			} catch (error) {
 				if (error instanceof Error && "code" in error && error.code === "ENOENT") return js`export const template = ${JSON.stringify(DEFAULT_TEMPLATE)};`;
@@ -31,7 +35,8 @@ const virtualTemplate = () => {
 			}
 		},
 		handleHotUpdate({ file, server }) {
-			if (relative(file, TEMPLATE_PATH) === "") {
+			if (!isAbsolute(file)) return;
+			if (relative(resolve(root, TEMPLATE_PATH), file) === "") {
 				const mod = server.moduleGraph.getModuleById(resolvedVirtualModuleId);
 				if (mod) server.moduleGraph.invalidateModule(mod);
 				server.ws.send({ type: "full-reload" });

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-template.mjs","names":[],"sources":["../../src/vite/virtual-template.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { relative } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nconst TEMPLATE_PATH = \"./src/template.html\";\n\nconst DEFAULT_TEMPLATE = /* html */ `\n<!DOCTYPE html>\n<html>\n    <head></head>\n    <body>\n        <!--ssr-outlet-->\n    </body>\n</html>\n`.trim();\n\nexport const virtualTemplate = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:template\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\treturn {\n\t\tname: \"yamf:virtual-template\",\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\tasync load(id) {\n\t\t\tif (id !== resolvedVirtualModuleId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst template = await readFile(TEMPLATE_PATH, \"utf8\");\n\n\t\t\t\treturn js`export const template = ${JSON.stringify(template)};`;\n\t\t\t} catch (error) {\n\t\t\t\tif (error instanceof Error && \"code\" in error && error.code === \"ENOENT\") {\n\t\t\t\t\treturn js`export const template = ${JSON.stringify(DEFAULT_TEMPLATE)};`;\n\t\t\t\t}\n\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\thandleHotUpdate({ file, server }) {\n\t\t\tif (relative(file, TEMPLATE_PATH) === \"\") {\n\t\t\t\tconst mod = server.moduleGraph.getModuleById(resolvedVirtualModuleId);\n\n\t\t\t\tif (mod) {\n\t\t\t\t\tserver.moduleGraph.invalidateModule(mod);\n\t\t\t\t}\n\n\t\t\t\tserver.ws.send({ type: \"full-reload\" });\n\t\t\t}\n\t\t},\n\t};\n};\n"],"mappings":";;;;AAKA,MAAM,gBAAgB;AAEtB,MAAM,mBAA8B;;;;;;;;EAQlC,KAAK;AAEP,MAAa,wBAAgC;CAC5C,MAAM,kBAAkB;CACxB,MAAM,0BAA0B;CAEhC,OAAO;EACN,MAAM;EACN,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,MAAM,KAAK,IAAI;GACd,IAAI,OAAO,yBACV;GAGD,IAAI;IACH,MAAM,WAAW,MAAM,SAAS,eAAe,MAAM;IAErD,OAAO,EAAE,2BAA2B,KAAK,UAAU,QAAQ,EAAE;GAC9D,SAAS,OAAO;IACf,IAAI,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,UAC/D,OAAO,EAAE,2BAA2B,KAAK,UAAU,gBAAgB,EAAE;IAGtE,MAAM;GACP;EACD;EACA,gBAAgB,EAAE,MAAM,UAAU;GACjC,IAAI,SAAS,MAAM,aAAa,MAAM,IAAI;IACzC,MAAM,MAAM,OAAO,YAAY,cAAc,uBAAuB;IAEpE,IAAI,KACH,OAAO,YAAY,iBAAiB,GAAG;IAGxC,OAAO,GAAG,KAAK,EAAE,MAAM,cAAc,CAAC;GACvC;EACD;CACD;AACD"}
+{"version":3,"file":"virtual-template.mjs","names":[],"sources":["../../src/vite/virtual-template.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { isAbsolute, relative, resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport { js } from \"../shared/utils\";\n\nconst TEMPLATE_PATH = \"./src/template.html\";\n\nconst DEFAULT_TEMPLATE = /* html */ `\n<!DOCTYPE html>\n<html>\n    <head></head>\n    <body>\n        <!--ssr-outlet-->\n    </body>\n</html>\n`.trim();\n\nexport const virtualTemplate = (): Plugin => {\n\tconst virtualModuleId = \"virtual:yamf:template\";\n\tconst resolvedVirtualModuleId = \"\\0\" + virtualModuleId;\n\n\t// resolved against the vite root (not cwd) so running vite from another\n\t// working directory — monorepo tooling, turbo, etc — does not silently\n\t// fall back to the default template\n\tlet root = process.cwd();\n\n\treturn {\n\t\tname: \"yamf:virtual-template\",\n\t\tconfigResolved(config) {\n\t\t\troot = config.root;\n\t\t},\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\tasync load(id) {\n\t\t\tif (id !== resolvedVirtualModuleId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst template = await readFile(resolve(root, TEMPLATE_PATH), \"utf8\");\n\n\t\t\t\treturn js`export const template = ${JSON.stringify(template)};`;\n\t\t\t} catch (error) {\n\t\t\t\tif (error instanceof Error && \"code\" in error && error.code === \"ENOENT\") {\n\t\t\t\t\treturn js`export const template = ${JSON.stringify(DEFAULT_TEMPLATE)};`;\n\t\t\t\t}\n\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\thandleHotUpdate({ file, server }) {\n\t\t\tif (!isAbsolute(file)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (relative(resolve(root, TEMPLATE_PATH), file) === \"\") {\n\t\t\t\tconst mod = server.moduleGraph.getModuleById(resolvedVirtualModuleId);\n\n\t\t\t\tif (mod) {\n\t\t\t\t\tserver.moduleGraph.invalidateModule(mod);\n\t\t\t\t}\n\n\t\t\t\tserver.ws.send({ type: \"full-reload\" });\n\t\t\t}\n\t\t},\n\t};\n};\n"],"mappings":";;;;AAKA,MAAM,gBAAgB;AAEtB,MAAM,mBAA8B;;;;;;;;EAQlC,KAAK;AAEP,MAAa,wBAAgC;CAC5C,MAAM,kBAAkB;CACxB,MAAM,0BAA0B,OAAO;CAKvC,IAAI,OAAO,QAAQ,IAAI;CAEvB,OAAO;EACN,MAAM;EACN,eAAe,QAAQ;GACtB,OAAO,OAAO;EACf;EACA,UAAU,IAAI;GACb,IAAI,OAAO,iBACV,OAAO;EAIT;EACA,MAAM,KAAK,IAAI;GACd,IAAI,OAAO,yBACV;GAGD,IAAI;IACH,MAAM,WAAW,MAAM,SAAS,QAAQ,MAAM,aAAa,GAAG,MAAM;IAEpE,OAAO,EAAE,2BAA2B,KAAK,UAAU,QAAQ,EAAE;GAC9D,SAAS,OAAO;IACf,IAAI,iBAAiB,SAAS,UAAU,SAAS,MAAM,SAAS,UAC/D,OAAO,EAAE,2BAA2B,KAAK,UAAU,gBAAgB,EAAE;IAGtE,MAAM;GACP;EACD;EACA,gBAAgB,EAAE,MAAM,UAAU;GACjC,IAAI,CAAC,WAAW,IAAI,GACnB;GAGD,IAAI,SAAS,QAAQ,MAAM,aAAa,GAAG,IAAI,MAAM,IAAI;IACxD,MAAM,MAAM,OAAO,YAAY,cAAc,uBAAuB;IAEpE,IAAI,KACH,OAAO,YAAY,iBAAiB,GAAG;IAGxC,OAAO,GAAG,KAAK,EAAE,MAAM,cAAc,CAAC;GACvC;EACD;CACD;AACD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pajecawav/yamf",
   "type": "module",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Yet another meta framework",
   "license": "MIT",
   "homepage": "https://github.com/pajecawav/yamf#readme",
@@ -30,36 +30,43 @@
     "access": "public"
   },
   "peerDependencies": {
-    "hono": "^4.12.30",
-    "vite": "^8.1.5"
+    "hono": "^4.13.9",
+    "vite": "^8.3.0",
+    "wouter": "^3.11.0"
+  },
+  "peerDependenciesMeta": {
+    "wouter": {
+      "optional": true
+    }
   },
   "dependencies": {
     "@hono/react-compat": "^0.0.3",
-    "devalue": "^5.8.2",
-    "exsolve": "^1.1.0",
-    "nitro": "3.0.260610-beta",
+    "@standard-schema/spec": "^1.1.0",
+    "devalue": "^6.0.2",
+    "exsolve": "^1.1.1",
+    "nitro": "3.0.260903-beta",
     "rolldown-string": "^0.3.1",
-    "rou3": "^0.9.1",
+    "rou3": "^0.9.2",
     "ufo": "^1.6.4",
-    "unhead": "^3.2.3",
-    "wouter": "^3.10.0"
+    "unhead": "^3.4.1",
+    "wouter": "^3.11.0"
   },
   "devDependencies": {
     "@hono/react-compat": "^0.0.3",
-    "@pajecawav/tools": "^0.0.7",
-    "@playwright/test": "^1.61.1",
-    "@types/node": "^24.13.3",
+    "@pajecawav/tools": "^0.0.9",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^26.6.2",
     "cross-env": "^10.1.0",
-    "hono": "^4.12.32",
+    "hono": "^4.13.9",
     "husky": "^9.1.7",
-    "npm-run-all2": "^9.0.2",
-    "oxfmt": "^0.60.0",
-    "oxlint": "^1.75.0",
-    "oxlint-tsgolint": "^7.0.2001",
-    "publint": "^0.3.22",
-    "tsdown": "0.22.14",
+    "npm-run-all2": "^9.0.3",
+    "oxfmt": "^0.70.0",
+    "oxlint": "^1.85.0",
+    "oxlint-tsgolint": "^7.0.2002",
+    "publint": "^0.3.24",
+    "tsdown": "0.23.0",
     "typescript": "~7.0.2",
-    "vite": "^8.1.5"
+    "vite": "^8.3.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/client/index.ts

@@ -1 +1,51 @@
-import "../island/client";
+/**
+ * Tiny bootstrap for the island runtime.
+ *
+ * Defines the <yamf-island> custom element and dynamically imports the real
+ * hydration runtime (hono/jsx dom renderer, devalue, unhead client) only when
+ * the document actually contains an island. Pages — or whole apps — without
+ * islands never pay for it.
+ */
+
+const pending: Set<HTMLElement> = new Set();
+
+type Hydrate = (island: HTMLElement) => void;
+
+let hydrate: Hydrate | null = null;
+let loading: boolean = false;
+
+const loadRuntime = (): void => {
+	if (loading) {
+		return;
+	}
+
+	loading = true;
+
+	void import("../island/client").then(({ hydrateIsland }) => {
+		hydrate = hydrateIsland;
+
+		for (const island of pending) {
+			pending.delete(island);
+			hydrate(island);
+		}
+	});
+};
+
+customElements.define(
+	"yamf-island",
+	class extends HTMLElement {
+		public connectedCallback() {
+			if (hydrate) {
+				hydrate(this);
+				return;
+			}
+
+			pending.add(this);
+			loadRuntime();
+		}
+
+		public disconnectedCallback() {
+			pending.delete(this);
+		}
+	},
+);

package/src/components/Head.tsx

@@ -1,7 +1,7 @@
-import type { ResolvableHead } from "unhead/types";
 import { useHead } from "#/hooks/useHead";
+import type { YamfHead } from "#/shared/head";
 
-export type HeadProps = ResolvableHead;
+export type HeadProps = YamfHead;
 
 export const Head = (props: HeadProps): void => {
 	useHead(props);

package/src/hooks/isPrerendering.ts

@@ -0,0 +1,13 @@
+import { useSSRContext } from "#/context/ssr";
+
+/**
+ * Whether the current render runs inside Nitro's build-time prerender pass —
+ * the prerenderer fetching the route to write it to disk as a static file.
+ *
+ * Always `false` in dev and at request time. Prefer this over
+ * `import.meta.prerender`: pages are bundled by the vite ssr service, where
+ * that flag is never replaced and would always read as `undefined`.
+ */
+export const isPrerendering = (): boolean => {
+	return useSSRContext()?.event.req.headers.has("x-nitro-prerender") ?? false;
+};

package/src/hooks/useHead.tsx

@@ -1,39 +1,128 @@
+import { useEffect, useRef } from "hono/jsx";
 import { useHead as _useHead, useSeoMeta as _useSeoMeta } from "unhead";
 import type { ClientUnhead } from "unhead/client";
 import { createHead } from "unhead/client";
-import type { ResolvableHead, UseSeoMetaInput } from "unhead/types";
+import type { ActiveHeadEntry, ResolvableHead, UseSeoMetaInput } from "unhead/types";
 import { useSSRContext } from "#/context/ssr";
+import type { YamfHead } from "#/shared/head";
+
+interface StreamQueue {
+	_q?: unknown[][];
+	push?: (batch: unknown[]) => void;
+}
 
 declare global {
 	interface Window {
-		__UNHEAD__?: ClientUnhead;
+		__unhead__?: StreamQueue;
+		__yamfHead__?: ClientUnhead;
 	}
 }
 
 if (!import.meta.env.SSR) {
-	window.__UNHEAD__ = createHead();
+	const head = createHead();
+
+	const drain = (batch: unknown[]): void => {
+		for (const input of batch) {
+			head.push(input as ResolvableHead);
+		}
+	};
+
+	// inline scripts (the handshake payload and streamed suspense patches)
+	// queue into window.__unhead__ while the document parses; this module is
+	// part of the deferred client entry and runs after parsing, so by now the
+	// queue holds everything the server sent — drain it into the client head
+	const queue = window.__unhead__?._q;
+
+	if (queue) {
+		for (const batch of queue) {
+			drain(batch);
+		}
+	}
+
+	// keep late patches (a stream that is still open) working
+	window.__unhead__ = { push: drain };
+
+	window.__yamfHead__ = head;
 }
 
-export const useHead = (input?: ResolvableHead): void => {
+/**
+ * Binds an unhead entry to the calling component's lifecycle: the entry is
+ * created once on mount, patched on every re-render with the latest input,
+ * and disposed on unmount. Without this, every re-render pushes a new entry
+ * that is never removed — a leak and growing DOM render cost.
+ */
+const useHeadEntryLifecycle = <T,>(
+	input: T | undefined,
+	createEntry: (head: ClientUnhead, input: T) => ActiveHeadEntry<T>,
+): void => {
+	const entryRef = useRef<ActiveHeadEntry<T> | null>(null);
+
+	useEffect(() => {
+		const head = window.__yamfHead__;
+
+		if (!head || input === undefined) {
+			return;
+		}
+
+		const entry = createEntry(head, input);
+
+		entryRef.current = entry;
+
+		return () => {
+			entry.dispose();
+			entryRef.current = null;
+		};
+		// mount-only: the entry is created once per component instance
+		// oxlint-disable-next-line eslint(exhaustive-deps)
+	}, []);
+
+	useEffect(() => {
+		if (input !== undefined) {
+			entryRef.current?.patch(input);
+		}
+	}, [input]);
+};
+
+export const useHead = (input?: YamfHead): void => {
 	if (import.meta.env.SSR) {
+		if (input === undefined) {
+			return;
+		}
+
 		const ctx = useSSRContext();
 
 		if (ctx?.head) {
-			_useHead(ctx.head, input);
+			// the custom `seo` key is yamf sugar for useSeoMeta — process it
+			// instead of passing an unknown key down to unhead
+			const { seo, ...rest } = input;
+
+			if (seo !== undefined) {
+				_useSeoMeta(ctx.head, seo);
+			}
+
+			_useHead(ctx.head, rest);
 		}
-	} else if (window.__UNHEAD__) {
-		_useHead(window.__UNHEAD__, input);
+
+		return;
 	}
+
+	useHeadEntryLifecycle(input, (head, resolved) => _useHead(head, resolved));
 };
 
 export const useSeoMeta = (input?: UseSeoMetaInput): void => {
 	if (import.meta.env.SSR) {
+		if (input === undefined) {
+			return;
+		}
+
 		const ctx = useSSRContext();
 
 		if (ctx?.head) {
 			_useSeoMeta(ctx.head, input);
 		}
-	} else if (window.__UNHEAD__) {
-		_useSeoMeta(window.__UNHEAD__, input);
+
+		return;
 	}
+
+	useHeadEntryLifecycle(input, (head, resolved) => _useSeoMeta(head, resolved));
 };

package/src/index.ts

@@ -1,8 +1,17 @@
 export { definePage } from "./page";
-export type { PageHandler } from "./page";
+export type { PageCacheOptions, PageHandler, PageRenderer } from "./page";
+
+export type { StandardSchemaV1 } from "@standard-schema/spec";
+
+// re-exported so apps can annotate render args without depending on unhead
+export type { Unhead } from "unhead/server";
+
+export { safeAsync } from "./safeAsync";
+export type { SafeAsyncFallbackProps } from "./safeAsync";
 
 export { useSSRContext } from "./context/ssr";
 export { useEvent } from "./hooks/useEvent";
+export { isPrerendering } from "./hooks/isPrerendering";
 export { useHead, useSeoMeta } from "./hooks/useHead";
 
 export type { IslandClientDirective, IslandProps } from "./island/types";