@funstack/static 0.0.10 → 1.0.0

package/README.md

@@ -41,14 +41,14 @@ For detailed API documentation and guides, visit the **[Documentation](https://s
 
 ### :robot: FUNSTACK Static Skill
 
-FUNSTACK Static provides an Agent Skill to feed your AI agents with knowledge about this framework. After installing `@funstack/static`, run the following command to add the skill to the project:
+FUNSTACK Static provides an Agent Skill to feed your AI agents with knowledge about this framework. Run the following command to add the skill to the project:
 
 ```sh
-npx funstack-static-skill-installer
+npx -p @funstack/static funstack-static-skill-installer
 # or
-yarn funstack-static-skill-installer
+yarn dlx -p @funstack/static funstack-static-skill-installer
 # or
-pnpm funstack-static-skill-installer
+pnpm --package @funstack/static dlx funstack-static-skill-installer
 # or, if you use skills CLI (https://skills.sh/)
 npx skills add uhyo/funstack-static
 ```

package/dist/bin/skill-installer.mjs

@@ -1,12 +1,13 @@
 #! /usr/bin/env node
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { install } from "@funstack/skill-installer";
-
 //#region src/bin/skill-installer.ts
-const resolved = path.resolve("./node_modules/@funstack/static/skills/funstack-static-knowledge");
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const resolved = path.resolve(__dirname, "../../skills/funstack-static-knowledge");
 console.log("Installing skill from:", resolved);
 await install(resolved);
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=skill-installer.mjs.map

package/dist/bin/skill-installer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"skill-installer.mjs","names":[],"sources":["../../src/bin/skill-installer.ts"],"sourcesContent":["#! /usr/bin/env node\n\nimport { install } from \"@funstack/skill-installer\";\nimport path from \"node:path\";\n\nconst skillDir =\n  \"./node_modules/@funstack/static/skills/funstack-static-knowledge\";\n\nconst resolved = path.resolve(skillDir);\n\nconsole.log(\"Installing skill from:\", resolved);\n\nawait install(resolved);\n"],"mappings":";;;;;AAQA,MAAM,WAAW,KAAK,QAFpB,mEAEqC;AAEvC,QAAQ,IAAI,0BAA0B,SAAS;AAE/C,MAAM,QAAQ,SAAS"}
+{"version":3,"file":"skill-installer.mjs","names":[],"sources":["../../src/bin/skill-installer.ts"],"sourcesContent":["#! /usr/bin/env node\n\nimport { install } from \"@funstack/skill-installer\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n// Resolve relative to this script (dist/bin/) so it works\n// both when installed locally and via npx -p / pnpm dlx / yarn dlx.\nconst resolved = path.resolve(\n  __dirname,\n  \"../../skills/funstack-static-knowledge\",\n);\n\nconsole.log(\"Installing skill from:\", resolved);\n\nawait install(resolved);\n"],"mappings":";;;;;AAMA,MAAM,YAAY,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAG9D,MAAM,WAAW,KAAK,QACpB,WACA,yCACD;AAED,QAAQ,IAAI,0BAA0B,SAAS;AAE/C,MAAM,QAAQ,SAAS"}

package/dist/build/buildApp.mjs

@@ -7,7 +7,6 @@ import { checkDuplicatePaths, validateEntryPath } from "./validateEntryPath.mjs"
 import path from "node:path";
 import { mkdir, writeFile } from "node:fs/promises";
 import { pathToFileURL } from "node:url";
-
 //#region src/build/buildApp.ts
 async function buildApp(builder, context) {
 	const { config } = builder;
@@ -58,7 +57,7 @@ async function writeFileNormal(filePath, data, context, name) {
 	context.info(`[funstack] Writing ${filePath}${nameInfo}`);
 	await writeFile(filePath, data);
 }
-
 //#endregion
 export { buildApp };
+
 //# sourceMappingURL=buildApp.mjs.map

package/dist/build/buildApp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildApp.mjs","names":[],"sources":["../../src/build/buildApp.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { ViteBuilder, MinimalPluginContextWithoutEnvironment } from \"vite\";\nimport { rscPayloadPlaceholder, getRscPayloadPath } from \"./rscPath\";\nimport { getModulePathFor } from \"../rsc/rscModule\";\nimport { processRscComponents } from \"./rscProcessor\";\nimport { computeContentHash } from \"./contentHash\";\nimport { drainStream } from \"../util/drainStream\";\nimport { validateEntryPath, checkDuplicatePaths } from \"./validateEntryPath\";\nimport type { EntryBuildResult } from \"../rsc/entry\";\n\nexport async function buildApp(\n  builder: ViteBuilder,\n  context: MinimalPluginContextWithoutEnvironment,\n) {\n  const { config } = builder;\n  // import server entry\n  const entryPath = path.join(config.environments.rsc.build.outDir, \"index.js\");\n  const entry: typeof import(\"../rsc/entry\") = await import(\n    pathToFileURL(entryPath).href\n  );\n\n  const baseDir = config.environments.client.build.outDir;\n  const base = normalizeBase(config.base);\n\n  const { entries, deferRegistry } = await entry.build();\n\n  // Validate all entry paths\n  const paths: string[] = [];\n  for (const result of entries) {\n    const error = validateEntryPath(result.path);\n    if (error) {\n      throw new Error(error);\n    }\n    paths.push(result.path);\n  }\n  const dupError = checkDuplicatePaths(paths);\n  if (dupError) {\n    throw new Error(dupError);\n  }\n\n  // Process all deferred components once across all entries.\n  // We pass a dummy empty stream since we handle per-entry RSC payloads separately.\n  const dummyStream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.close();\n    },\n  });\n  const { components, idMapping } = await processRscComponents(\n    deferRegistry.loadAll(),\n    dummyStream,\n    context,\n  );\n\n  // Write each entry's HTML and RSC payload\n  for (const result of entries) {\n    await buildSingleEntry(result, idMapping, baseDir, base, context);\n  }\n\n  // Write all deferred component payloads\n  for (const { finalId, finalContent, name } of components) {\n    const filePath = path.join(\n      baseDir,\n      getModulePathFor(finalId).replace(/^\\//, \"\"),\n    );\n    await writeFileNormal(filePath, finalContent, context, name);\n  }\n}\n\nfunction normalizeBase(base: string): string {\n  const normalized = base.endsWith(\"/\") ? base.slice(0, -1) : base;\n  return normalized === \"/\" ? \"\" : normalized;\n}\n\n/**\n * Replaces temporary IDs with final hashed IDs in content.\n */\nfunction replaceIdsInContent(\n  content: string,\n  idMapping: Map<string, string>,\n): string {\n  let result = content;\n  for (const [oldId, newId] of idMapping) {\n    if (oldId !== newId) {\n      result = result.replaceAll(oldId, newId);\n    }\n  }\n  return result;\n}\n\nasync function buildSingleEntry(\n  result: EntryBuildResult,\n  idMapping: Map<string, string>,\n  baseDir: string,\n  base: string,\n  context: MinimalPluginContextWithoutEnvironment,\n) {\n  const { path: entryPath, html, appRsc } = result;\n\n  // Drain HTML stream to string\n  const htmlContent = await drainStream(html);\n\n  // Drain and process RSC payload: replace temp IDs with final hashed IDs\n  const rawAppRscContent = await drainStream(appRsc);\n  const appRscContent = replaceIdsInContent(rawAppRscContent, idMapping);\n\n  // Compute hash for this entry's RSC payload\n  const mainPayloadHash = await computeContentHash(appRscContent);\n  const mainPayloadPath =\n    base === \"\"\n      ? getRscPayloadPath(mainPayloadHash)\n      : base + getRscPayloadPath(mainPayloadHash);\n\n  // Replace placeholder with final hashed path\n  const finalHtmlContent = htmlContent.replaceAll(\n    rscPayloadPlaceholder,\n    mainPayloadPath,\n  );\n\n  // entryPath is already a file name (e.g. \"index.html\", \"about.html\")\n  await writeFileNormal(\n    path.join(baseDir, entryPath),\n    finalHtmlContent,\n    context,\n  );\n\n  // Write RSC payload with hashed filename\n  await writeFileNormal(\n    path.join(baseDir, getRscPayloadPath(mainPayloadHash).replace(/^\\//, \"\")),\n    appRscContent,\n    context,\n  );\n}\n\nasync function writeFileNormal(\n  filePath: string,\n  data: string,\n  context: MinimalPluginContextWithoutEnvironment,\n  name?: string,\n) {\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const nameInfo = name ? ` (${name})` : \"\";\n  context.info(`[funstack] Writing ${filePath}${nameInfo}`);\n  await writeFile(filePath, data);\n}\n"],"mappings":";;;;;;;;;;;AAYA,eAAsB,SACpB,SACA,SACA;CACA,MAAM,EAAE,WAAW;CAGnB,MAAM,QAAuC,MAAM,OACjD,cAFgB,KAAK,KAAK,OAAO,aAAa,IAAI,MAAM,QAAQ,WAAW,CAEnD,CAAC;CAG3B,MAAM,UAAU,OAAO,aAAa,OAAO,MAAM;CACjD,MAAM,OAAO,cAAc,OAAO,KAAK;CAEvC,MAAM,EAAE,SAAS,kBAAkB,MAAM,MAAM,OAAO;CAGtD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,QAAQ,kBAAkB,OAAO,KAAK;AAC5C,MAAI,MACF,OAAM,IAAI,MAAM,MAAM;AAExB,QAAM,KAAK,OAAO,KAAK;;CAEzB,MAAM,WAAW,oBAAoB,MAAM;AAC3C,KAAI,SACF,OAAM,IAAI,MAAM,SAAS;CAK3B,MAAM,cAAc,IAAI,eAA2B,EACjD,MAAM,YAAY;AAChB,aAAW,OAAO;IAErB,CAAC;CACF,MAAM,EAAE,YAAY,cAAc,MAAM,qBACtC,cAAc,SAAS,EACvB,aACA,QACD;AAGD,MAAK,MAAM,UAAU,QACnB,OAAM,iBAAiB,QAAQ,WAAW,SAAS,MAAM,QAAQ;AAInE,MAAK,MAAM,EAAE,SAAS,cAAc,UAAU,WAK5C,OAAM,gBAJW,KAAK,KACpB,SACA,iBAAiB,QAAQ,CAAC,QAAQ,OAAO,GAAG,CAC7C,EAC+B,cAAc,SAAS,KAAK;;AAIhE,SAAS,cAAc,MAAsB;CAC3C,MAAM,aAAa,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG;AAC5D,QAAO,eAAe,MAAM,KAAK;;;;;AAMnC,SAAS,oBACP,SACA,WACQ;CACR,IAAI,SAAS;AACb,MAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,UAAS,OAAO,WAAW,OAAO,MAAM;AAG5C,QAAO;;AAGT,eAAe,iBACb,QACA,WACA,SACA,MACA,SACA;CACA,MAAM,EAAE,MAAM,WAAW,MAAM,WAAW;CAG1C,MAAM,cAAc,MAAM,YAAY,KAAK;CAI3C,MAAM,gBAAgB,oBADG,MAAM,YAAY,OAAO,EACU,UAAU;CAGtE,MAAM,kBAAkB,MAAM,mBAAmB,cAAc;CAC/D,MAAM,kBACJ,SAAS,KACL,kBAAkB,gBAAgB,GAClC,OAAO,kBAAkB,gBAAgB;CAG/C,MAAM,mBAAmB,YAAY,WACnC,uBACA,gBACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,UAAU,EAC7B,kBACA,QACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,kBAAkB,gBAAgB,CAAC,QAAQ,OAAO,GAAG,CAAC,EACzE,eACA,QACD;;AAGH,eAAe,gBACb,UACA,MACA,SACA,MACA;AACA,OAAM,MAAM,KAAK,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;CACxD,MAAM,WAAW,OAAO,KAAK,KAAK,KAAK;AACvC,SAAQ,KAAK,sBAAsB,WAAW,WAAW;AACzD,OAAM,UAAU,UAAU,KAAK"}
+{"version":3,"file":"buildApp.mjs","names":[],"sources":["../../src/build/buildApp.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { ViteBuilder, MinimalPluginContextWithoutEnvironment } from \"vite\";\nimport { rscPayloadPlaceholder, getRscPayloadPath } from \"./rscPath\";\nimport { getModulePathFor } from \"../rsc/rscModule\";\nimport { processRscComponents } from \"./rscProcessor\";\nimport { computeContentHash } from \"./contentHash\";\nimport { drainStream } from \"../util/drainStream\";\nimport { validateEntryPath, checkDuplicatePaths } from \"./validateEntryPath\";\nimport type { EntryBuildResult } from \"../rsc/entry\";\n\nexport async function buildApp(\n  builder: ViteBuilder,\n  context: MinimalPluginContextWithoutEnvironment,\n) {\n  const { config } = builder;\n  // import server entry\n  const entryPath = path.join(config.environments.rsc.build.outDir, \"index.js\");\n  const entry: typeof import(\"../rsc/entry\") = await import(\n    pathToFileURL(entryPath).href\n  );\n\n  const baseDir = config.environments.client.build.outDir;\n  const base = normalizeBase(config.base);\n\n  const { entries, deferRegistry } = await entry.build();\n\n  // Validate all entry paths\n  const paths: string[] = [];\n  for (const result of entries) {\n    const error = validateEntryPath(result.path);\n    if (error) {\n      throw new Error(error);\n    }\n    paths.push(result.path);\n  }\n  const dupError = checkDuplicatePaths(paths);\n  if (dupError) {\n    throw new Error(dupError);\n  }\n\n  // Process all deferred components once across all entries.\n  // We pass a dummy empty stream since we handle per-entry RSC payloads separately.\n  const dummyStream = new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.close();\n    },\n  });\n  const { components, idMapping } = await processRscComponents(\n    deferRegistry.loadAll(),\n    dummyStream,\n    context,\n  );\n\n  // Write each entry's HTML and RSC payload\n  for (const result of entries) {\n    await buildSingleEntry(result, idMapping, baseDir, base, context);\n  }\n\n  // Write all deferred component payloads\n  for (const { finalId, finalContent, name } of components) {\n    const filePath = path.join(\n      baseDir,\n      getModulePathFor(finalId).replace(/^\\//, \"\"),\n    );\n    await writeFileNormal(filePath, finalContent, context, name);\n  }\n}\n\nfunction normalizeBase(base: string): string {\n  const normalized = base.endsWith(\"/\") ? base.slice(0, -1) : base;\n  return normalized === \"/\" ? \"\" : normalized;\n}\n\n/**\n * Replaces temporary IDs with final hashed IDs in content.\n */\nfunction replaceIdsInContent(\n  content: string,\n  idMapping: Map<string, string>,\n): string {\n  let result = content;\n  for (const [oldId, newId] of idMapping) {\n    if (oldId !== newId) {\n      result = result.replaceAll(oldId, newId);\n    }\n  }\n  return result;\n}\n\nasync function buildSingleEntry(\n  result: EntryBuildResult,\n  idMapping: Map<string, string>,\n  baseDir: string,\n  base: string,\n  context: MinimalPluginContextWithoutEnvironment,\n) {\n  const { path: entryPath, html, appRsc } = result;\n\n  // Drain HTML stream to string\n  const htmlContent = await drainStream(html);\n\n  // Drain and process RSC payload: replace temp IDs with final hashed IDs\n  const rawAppRscContent = await drainStream(appRsc);\n  const appRscContent = replaceIdsInContent(rawAppRscContent, idMapping);\n\n  // Compute hash for this entry's RSC payload\n  const mainPayloadHash = await computeContentHash(appRscContent);\n  const mainPayloadPath =\n    base === \"\"\n      ? getRscPayloadPath(mainPayloadHash)\n      : base + getRscPayloadPath(mainPayloadHash);\n\n  // Replace placeholder with final hashed path\n  const finalHtmlContent = htmlContent.replaceAll(\n    rscPayloadPlaceholder,\n    mainPayloadPath,\n  );\n\n  // entryPath is already a file name (e.g. \"index.html\", \"about.html\")\n  await writeFileNormal(\n    path.join(baseDir, entryPath),\n    finalHtmlContent,\n    context,\n  );\n\n  // Write RSC payload with hashed filename\n  await writeFileNormal(\n    path.join(baseDir, getRscPayloadPath(mainPayloadHash).replace(/^\\//, \"\")),\n    appRscContent,\n    context,\n  );\n}\n\nasync function writeFileNormal(\n  filePath: string,\n  data: string,\n  context: MinimalPluginContextWithoutEnvironment,\n  name?: string,\n) {\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const nameInfo = name ? ` (${name})` : \"\";\n  context.info(`[funstack] Writing ${filePath}${nameInfo}`);\n  await writeFile(filePath, data);\n}\n"],"mappings":";;;;;;;;;;AAYA,eAAsB,SACpB,SACA,SACA;CACA,MAAM,EAAE,WAAW;CAGnB,MAAM,QAAuC,MAAM,OACjD,cAFgB,KAAK,KAAK,OAAO,aAAa,IAAI,MAAM,QAAQ,WAAW,CAEnD,CAAC;CAG3B,MAAM,UAAU,OAAO,aAAa,OAAO,MAAM;CACjD,MAAM,OAAO,cAAc,OAAO,KAAK;CAEvC,MAAM,EAAE,SAAS,kBAAkB,MAAM,MAAM,OAAO;CAGtD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,QAAQ,kBAAkB,OAAO,KAAK;AAC5C,MAAI,MACF,OAAM,IAAI,MAAM,MAAM;AAExB,QAAM,KAAK,OAAO,KAAK;;CAEzB,MAAM,WAAW,oBAAoB,MAAM;AAC3C,KAAI,SACF,OAAM,IAAI,MAAM,SAAS;CAK3B,MAAM,cAAc,IAAI,eAA2B,EACjD,MAAM,YAAY;AAChB,aAAW,OAAO;IAErB,CAAC;CACF,MAAM,EAAE,YAAY,cAAc,MAAM,qBACtC,cAAc,SAAS,EACvB,aACA,QACD;AAGD,MAAK,MAAM,UAAU,QACnB,OAAM,iBAAiB,QAAQ,WAAW,SAAS,MAAM,QAAQ;AAInE,MAAK,MAAM,EAAE,SAAS,cAAc,UAAU,WAK5C,OAAM,gBAJW,KAAK,KACpB,SACA,iBAAiB,QAAQ,CAAC,QAAQ,OAAO,GAAG,CAC7C,EAC+B,cAAc,SAAS,KAAK;;AAIhE,SAAS,cAAc,MAAsB;CAC3C,MAAM,aAAa,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG;AAC5D,QAAO,eAAe,MAAM,KAAK;;;;;AAMnC,SAAS,oBACP,SACA,WACQ;CACR,IAAI,SAAS;AACb,MAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,UAAS,OAAO,WAAW,OAAO,MAAM;AAG5C,QAAO;;AAGT,eAAe,iBACb,QACA,WACA,SACA,MACA,SACA;CACA,MAAM,EAAE,MAAM,WAAW,MAAM,WAAW;CAG1C,MAAM,cAAc,MAAM,YAAY,KAAK;CAI3C,MAAM,gBAAgB,oBADG,MAAM,YAAY,OAAO,EACU,UAAU;CAGtE,MAAM,kBAAkB,MAAM,mBAAmB,cAAc;CAC/D,MAAM,kBACJ,SAAS,KACL,kBAAkB,gBAAgB,GAClC,OAAO,kBAAkB,gBAAgB;CAG/C,MAAM,mBAAmB,YAAY,WACnC,uBACA,gBACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,UAAU,EAC7B,kBACA,QACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,kBAAkB,gBAAgB,CAAC,QAAQ,OAAO,GAAG,CAAC,EACzE,eACA,QACD;;AAGH,eAAe,gBACb,UACA,MACA,SACA,MACA;AACA,OAAM,MAAM,KAAK,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;CACxD,MAAM,WAAW,OAAO,KAAK,KAAK,KAAK;AACvC,SAAQ,KAAK,sBAAsB,WAAW,WAAW;AACzD,OAAM,UAAU,UAAU,KAAK"}

package/dist/build/contentHash.mjs

@@ -8,7 +8,7 @@ async function computeContentHash(content) {
 	const hashBuffer = await crypto.subtle.digest("SHA-256", data);
 	return Array.from(new Uint8Array(hashBuffer)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 16);
 }
-
 //#endregion
 export { computeContentHash };
+
 //# sourceMappingURL=contentHash.mjs.map

package/dist/build/dependencyGraph.mjs

@@ -40,7 +40,7 @@ function topologicalSort(dependencies) {
 		inCycle
 	};
 }
-
 //#endregion
 export { findReferencedIds, topologicalSort };
+
 //# sourceMappingURL=dependencyGraph.mjs.map

package/dist/build/dependencyGraph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dependencyGraph.mjs","names":[],"sources":["../../src/build/dependencyGraph.ts"],"sourcesContent":["/**\n * Result of topological sort.\n */\nexport interface SortResult {\n  /** Components that can be processed in dependency order */\n  sorted: string[];\n  /** Components stuck in cycles (cannot determine stable order) */\n  inCycle: string[];\n}\n\n/**\n * Finds which IDs from the known set are referenced in the given content.\n */\nexport function findReferencedIds(\n  content: string,\n  allKnownIds: Set<string>,\n): Set<string> {\n  const referenced = new Set<string>();\n  for (const id of allKnownIds) {\n    if (content.includes(id)) {\n      referenced.add(id);\n    }\n  }\n  return referenced;\n}\n\n/**\n * Performs topological sort using Kahn's algorithm.\n * Returns both the sorted nodes and any nodes that are part of cycles.\n *\n * @param dependencies - Map of node ID to the set of IDs it depends on (references)\n */\nexport function topologicalSort(\n  dependencies: Map<string, Set<string>>,\n): SortResult {\n  const allNodes = new Set(dependencies.keys());\n\n  // Calculate in-degree for each node (how many other nodes reference it)\n  const inDegree = new Map<string, number>();\n  for (const node of allNodes) {\n    inDegree.set(node, 0);\n  }\n\n  for (const [_node, deps] of dependencies) {\n    for (const dep of deps) {\n      if (allNodes.has(dep)) {\n        inDegree.set(dep, (inDegree.get(dep) ?? 0) + 1);\n      }\n    }\n  }\n\n  // Start with nodes that have in-degree 0 (no one references them)\n  const queue: string[] = [];\n  for (const [node, degree] of inDegree) {\n    if (degree === 0) {\n      queue.push(node);\n    }\n  }\n\n  const sorted: string[] = [];\n\n  while (queue.length > 0) {\n    const node = queue.shift()!;\n    sorted.push(node);\n\n    // Decrement in-degree of nodes this node depends on\n    const deps = dependencies.get(node);\n    if (deps) {\n      for (const dep of deps) {\n        if (allNodes.has(dep)) {\n          const newDegree = (inDegree.get(dep) ?? 1) - 1;\n          inDegree.set(dep, newDegree);\n          if (newDegree === 0) {\n            queue.push(dep);\n          }\n        }\n      }\n    }\n  }\n\n  // Nodes not in sorted result are part of cycles\n  const inCycle: string[] = [];\n  for (const node of allNodes) {\n    if (!sorted.includes(node)) {\n      inCycle.push(node);\n    }\n  }\n\n  return { sorted, inCycle };\n}\n"],"mappings":";;;;AAaA,SAAgB,kBACd,SACA,aACa;CACb,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,MAAM,YACf,KAAI,QAAQ,SAAS,GAAG,CACtB,YAAW,IAAI,GAAG;AAGtB,QAAO;;;;;;;;AAST,SAAgB,gBACd,cACY;CACZ,MAAM,WAAW,IAAI,IAAI,aAAa,MAAM,CAAC;CAG7C,MAAM,2BAAW,IAAI,KAAqB;AAC1C,MAAK,MAAM,QAAQ,SACjB,UAAS,IAAI,MAAM,EAAE;AAGvB,MAAK,MAAM,CAAC,OAAO,SAAS,aAC1B,MAAK,MAAM,OAAO,KAChB,KAAI,SAAS,IAAI,IAAI,CACnB,UAAS,IAAI,MAAM,SAAS,IAAI,IAAI,IAAI,KAAK,EAAE;CAMrD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,CAAC,MAAM,WAAW,SAC3B,KAAI,WAAW,EACb,OAAM,KAAK,KAAK;CAIpB,MAAM,SAAmB,EAAE;AAE3B,QAAO,MAAM,SAAS,GAAG;EACvB,MAAM,OAAO,MAAM,OAAO;AAC1B,SAAO,KAAK,KAAK;EAGjB,MAAM,OAAO,aAAa,IAAI,KAAK;AACnC,MAAI,MACF;QAAK,MAAM,OAAO,KAChB,KAAI,SAAS,IAAI,IAAI,EAAE;IACrB,MAAM,aAAa,SAAS,IAAI,IAAI,IAAI,KAAK;AAC7C,aAAS,IAAI,KAAK,UAAU;AAC5B,QAAI,cAAc,EAChB,OAAM,KAAK,IAAI;;;;CAQzB,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,QAAQ,SACjB,KAAI,CAAC,OAAO,SAAS,KAAK,CACxB,SAAQ,KAAK,KAAK;AAItB,QAAO;EAAE;EAAQ;EAAS"}
+{"version":3,"file":"dependencyGraph.mjs","names":[],"sources":["../../src/build/dependencyGraph.ts"],"sourcesContent":["/**\n * Result of topological sort.\n */\nexport interface SortResult {\n  /** Components that can be processed in dependency order */\n  sorted: string[];\n  /** Components stuck in cycles (cannot determine stable order) */\n  inCycle: string[];\n}\n\n/**\n * Finds which IDs from the known set are referenced in the given content.\n */\nexport function findReferencedIds(\n  content: string,\n  allKnownIds: Set<string>,\n): Set<string> {\n  const referenced = new Set<string>();\n  for (const id of allKnownIds) {\n    if (content.includes(id)) {\n      referenced.add(id);\n    }\n  }\n  return referenced;\n}\n\n/**\n * Performs topological sort using Kahn's algorithm.\n * Returns both the sorted nodes and any nodes that are part of cycles.\n *\n * @param dependencies - Map of node ID to the set of IDs it depends on (references)\n */\nexport function topologicalSort(\n  dependencies: Map<string, Set<string>>,\n): SortResult {\n  const allNodes = new Set(dependencies.keys());\n\n  // Calculate in-degree for each node (how many other nodes reference it)\n  const inDegree = new Map<string, number>();\n  for (const node of allNodes) {\n    inDegree.set(node, 0);\n  }\n\n  for (const [_node, deps] of dependencies) {\n    for (const dep of deps) {\n      if (allNodes.has(dep)) {\n        inDegree.set(dep, (inDegree.get(dep) ?? 0) + 1);\n      }\n    }\n  }\n\n  // Start with nodes that have in-degree 0 (no one references them)\n  const queue: string[] = [];\n  for (const [node, degree] of inDegree) {\n    if (degree === 0) {\n      queue.push(node);\n    }\n  }\n\n  const sorted: string[] = [];\n\n  while (queue.length > 0) {\n    const node = queue.shift()!;\n    sorted.push(node);\n\n    // Decrement in-degree of nodes this node depends on\n    const deps = dependencies.get(node);\n    if (deps) {\n      for (const dep of deps) {\n        if (allNodes.has(dep)) {\n          const newDegree = (inDegree.get(dep) ?? 1) - 1;\n          inDegree.set(dep, newDegree);\n          if (newDegree === 0) {\n            queue.push(dep);\n          }\n        }\n      }\n    }\n  }\n\n  // Nodes not in sorted result are part of cycles\n  const inCycle: string[] = [];\n  for (const node of allNodes) {\n    if (!sorted.includes(node)) {\n      inCycle.push(node);\n    }\n  }\n\n  return { sorted, inCycle };\n}\n"],"mappings":";;;;AAaA,SAAgB,kBACd,SACA,aACa;CACb,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,MAAM,YACf,KAAI,QAAQ,SAAS,GAAG,CACtB,YAAW,IAAI,GAAG;AAGtB,QAAO;;;;;;;;AAST,SAAgB,gBACd,cACY;CACZ,MAAM,WAAW,IAAI,IAAI,aAAa,MAAM,CAAC;CAG7C,MAAM,2BAAW,IAAI,KAAqB;AAC1C,MAAK,MAAM,QAAQ,SACjB,UAAS,IAAI,MAAM,EAAE;AAGvB,MAAK,MAAM,CAAC,OAAO,SAAS,aAC1B,MAAK,MAAM,OAAO,KAChB,KAAI,SAAS,IAAI,IAAI,CACnB,UAAS,IAAI,MAAM,SAAS,IAAI,IAAI,IAAI,KAAK,EAAE;CAMrD,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,CAAC,MAAM,WAAW,SAC3B,KAAI,WAAW,EACb,OAAM,KAAK,KAAK;CAIpB,MAAM,SAAmB,EAAE;AAE3B,QAAO,MAAM,SAAS,GAAG;EACvB,MAAM,OAAO,MAAM,OAAO;AAC1B,SAAO,KAAK,KAAK;EAGjB,MAAM,OAAO,aAAa,IAAI,KAAK;AACnC,MAAI;QACG,MAAM,OAAO,KAChB,KAAI,SAAS,IAAI,IAAI,EAAE;IACrB,MAAM,aAAa,SAAS,IAAI,IAAI,IAAI,KAAK;AAC7C,aAAS,IAAI,KAAK,UAAU;AAC5B,QAAI,cAAc,EAChB,OAAM,KAAK,IAAI;;;;CAQzB,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,QAAQ,SACjB,KAAI,CAAC,OAAO,SAAS,KAAK,CACxB,SAAQ,KAAK,KAAK;AAItB,QAAO;EAAE;EAAQ;EAAS"}

package/dist/build/rscPath.mjs

@@ -1,5 +1,4 @@
 import { getModulePathFor, getPayloadIDFor } from "../rsc/rscModule.mjs";
-
 //#region src/build/rscPath.ts
 /**
 * Placeholder used during SSR (will be replaced after hash is computed)
@@ -11,7 +10,7 @@ const rscPayloadPlaceholder = "__FUNSTACK_RSC_PAYLOAD_PATH__";
 function getRscPayloadPath(contentHash) {
 	return getModulePathFor(getPayloadIDFor(contentHash));
 }
-
 //#endregion
 export { getRscPayloadPath, rscPayloadPlaceholder };
+
 //# sourceMappingURL=rscPath.mjs.map

package/dist/build/rscPath.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rscPath.mjs","names":[],"sources":["../../src/build/rscPath.ts"],"sourcesContent":["import { getModulePathFor, getPayloadIDFor } from \"../rsc/rscModule\";\n\n/**\n * Placeholder used during SSR (will be replaced after hash is computed)\n */\nexport const rscPayloadPlaceholder = \"__FUNSTACK_RSC_PAYLOAD_PATH__\";\n\n/**\n * Generate final path from content hash (reuses same folder as deferred payloads)\n */\nexport function getRscPayloadPath(contentHash: string): string {\n  return getModulePathFor(getPayloadIDFor(contentHash));\n}\n"],"mappings":";;;;;;AAKA,MAAa,wBAAwB;;;;AAKrC,SAAgB,kBAAkB,aAA6B;AAC7D,QAAO,iBAAiB,gBAAgB,YAAY,CAAC"}
+{"version":3,"file":"rscPath.mjs","names":[],"sources":["../../src/build/rscPath.ts"],"sourcesContent":["import { getModulePathFor, getPayloadIDFor } from \"../rsc/rscModule\";\n\n/**\n * Placeholder used during SSR (will be replaced after hash is computed)\n */\nexport const rscPayloadPlaceholder = \"__FUNSTACK_RSC_PAYLOAD_PATH__\";\n\n/**\n * Generate final path from content hash (reuses same folder as deferred payloads)\n */\nexport function getRscPayloadPath(contentHash: string): string {\n  return getModulePathFor(getPayloadIDFor(contentHash));\n}\n"],"mappings":";;;;;AAKA,MAAa,wBAAwB;;;;AAKrC,SAAgB,kBAAkB,aAA6B;AAC7D,QAAO,iBAAiB,gBAAgB,YAAY,CAAC"}

package/dist/build/rscProcessor.mjs

@@ -2,7 +2,6 @@ import { getPayloadIDFor } from "../rsc/rscModule.mjs";
 import { drainStream } from "../util/drainStream.mjs";
 import { computeContentHash } from "./contentHash.mjs";
 import { findReferencedIds, topologicalSort } from "./dependencyGraph.mjs";
-
 //#region src/build/rscProcessor.ts
 /**
 * Processes RSC components by replacing temporary UUIDs with content-based hashes.
@@ -66,7 +65,7 @@ async function processRscComponents(deferRegistryIterator, appRscStream, context
 		idMapping
 	};
 }
-
 //#endregion
 export { processRscComponents };
+
 //# sourceMappingURL=rscProcessor.mjs.map

package/dist/build/rscProcessor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rscProcessor.mjs","names":[],"sources":["../../src/build/rscProcessor.ts"],"sourcesContent":["import { drainStream } from \"../util/drainStream\";\nimport { getPayloadIDFor } from \"../rsc/rscModule\";\nimport { computeContentHash } from \"./contentHash\";\nimport { findReferencedIds, topologicalSort } from \"./dependencyGraph\";\n\nexport interface ProcessedComponent {\n  finalId: string;\n  finalContent: string;\n  name?: string;\n}\n\nexport interface ProcessResult {\n  components: ProcessedComponent[];\n  appRscContent: string;\n  idMapping: Map<string, string>;\n}\n\ninterface RawComponent {\n  id: string;\n  data: string;\n  name?: string;\n}\n\n/**\n * Processes RSC components by replacing temporary UUIDs with content-based hashes.\n *\n * @param deferRegistryIterator - Iterator yielding components with { id, data }\n * @param appRscStream - The main RSC stream\n * @param context - Optional context for logging warnings\n */\nexport async function processRscComponents(\n  deferRegistryIterator: AsyncIterable<RawComponent>,\n  appRscStream: ReadableStream,\n  context?: { warn: (message: string) => void },\n): Promise<ProcessResult> {\n  // Step 1: Collect all components from deferRegistry\n  const components = new Map<string, string>();\n  const componentNames = new Map<string, string | undefined>();\n  for await (const { id, data, name } of deferRegistryIterator) {\n    components.set(id, data);\n    componentNames.set(id, name);\n  }\n\n  // Step 2: Drain appRsc stream to string\n  let appRscContent = await drainStream(appRscStream);\n\n  // If no components, return early\n  if (components.size === 0) {\n    return {\n      components: [],\n      appRscContent,\n      idMapping: new Map(),\n    };\n  }\n\n  const allIds = new Set(components.keys());\n\n  // Step 3: Build dependency graph\n  // For each component, find which other component IDs appear in its content\n  const dependencies = new Map<string, Set<string>>();\n  for (const [id, content] of components) {\n    const otherIds = new Set(allIds);\n    otherIds.delete(id); // Don't include self-references\n    const refs = findReferencedIds(content, otherIds);\n    dependencies.set(id, refs);\n  }\n\n  // Step 4: Topologically sort components\n  const { sorted, inCycle } = topologicalSort(dependencies);\n\n  // Step 5: Handle cycles - warn and keep original temp IDs\n  const idMapping = new Map<string, string>();\n\n  if (inCycle.length > 0) {\n    context?.warn(\n      `[funstack] Warning: ${inCycle.length} RSC component(s) are in dependency cycles and will keep unstable IDs: ${inCycle.join(\", \")}`,\n    );\n    for (const id of inCycle) {\n      idMapping.set(id, id); // Map to itself (keep original ID)\n    }\n  }\n\n  // Step 6: Process sorted components in order\n  const processedComponents: ProcessedComponent[] = [];\n\n  for (const tempId of sorted) {\n    let content = components.get(tempId)!;\n\n    // Replace all already-finalized temp IDs with their hash-based IDs\n    for (const [oldId, newId] of idMapping) {\n      if (oldId !== newId) {\n        content = content.replaceAll(oldId, newId);\n      }\n    }\n\n    // Compute content hash for this component\n    const contentHash = await computeContentHash(content);\n    const finalId = getPayloadIDFor(contentHash);\n\n    // Create mapping\n    idMapping.set(tempId, finalId);\n\n    processedComponents.push({\n      finalId,\n      finalContent: content,\n      name: componentNames.get(tempId),\n    });\n  }\n\n  // Add cycle members to processed components (with original IDs)\n  for (const tempId of inCycle) {\n    let content = components.get(tempId)!;\n\n    // Replace finalized IDs in cycle member content\n    for (const [oldId, newId] of idMapping) {\n      if (oldId !== newId) {\n        content = content.replaceAll(oldId, newId);\n      }\n    }\n\n    processedComponents.push({\n      finalId: tempId, // Keep original temp ID\n      finalContent: content,\n      name: componentNames.get(tempId),\n    });\n  }\n\n  // Step 7: Process appRsc - replace all temp IDs with final IDs\n  for (const [oldId, newId] of idMapping) {\n    if (oldId !== newId) {\n      appRscContent = appRscContent.replaceAll(oldId, newId);\n    }\n  }\n\n  return {\n    components: processedComponents,\n    appRscContent,\n    idMapping,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,eAAsB,qBACpB,uBACA,cACA,SACwB;CAExB,MAAM,6BAAa,IAAI,KAAqB;CAC5C,MAAM,iCAAiB,IAAI,KAAiC;AAC5D,YAAW,MAAM,EAAE,IAAI,MAAM,UAAU,uBAAuB;AAC5D,aAAW,IAAI,IAAI,KAAK;AACxB,iBAAe,IAAI,IAAI,KAAK;;CAI9B,IAAI,gBAAgB,MAAM,YAAY,aAAa;AAGnD,KAAI,WAAW,SAAS,EACtB,QAAO;EACL,YAAY,EAAE;EACd;EACA,2BAAW,IAAI,KAAK;EACrB;CAGH,MAAM,SAAS,IAAI,IAAI,WAAW,MAAM,CAAC;CAIzC,MAAM,+BAAe,IAAI,KAA0B;AACnD,MAAK,MAAM,CAAC,IAAI,YAAY,YAAY;EACtC,MAAM,WAAW,IAAI,IAAI,OAAO;AAChC,WAAS,OAAO,GAAG;EACnB,MAAM,OAAO,kBAAkB,SAAS,SAAS;AACjD,eAAa,IAAI,IAAI,KAAK;;CAI5B,MAAM,EAAE,QAAQ,YAAY,gBAAgB,aAAa;CAGzD,MAAM,4BAAY,IAAI,KAAqB;AAE3C,KAAI,QAAQ,SAAS,GAAG;AACtB,WAAS,KACP,uBAAuB,QAAQ,OAAO,yEAAyE,QAAQ,KAAK,KAAK,GAClI;AACD,OAAK,MAAM,MAAM,QACf,WAAU,IAAI,IAAI,GAAG;;CAKzB,MAAM,sBAA4C,EAAE;AAEpD,MAAK,MAAM,UAAU,QAAQ;EAC3B,IAAI,UAAU,WAAW,IAAI,OAAO;AAGpC,OAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,WAAU,QAAQ,WAAW,OAAO,MAAM;EAM9C,MAAM,UAAU,gBADI,MAAM,mBAAmB,QAAQ,CACT;AAG5C,YAAU,IAAI,QAAQ,QAAQ;AAE9B,sBAAoB,KAAK;GACvB;GACA,cAAc;GACd,MAAM,eAAe,IAAI,OAAO;GACjC,CAAC;;AAIJ,MAAK,MAAM,UAAU,SAAS;EAC5B,IAAI,UAAU,WAAW,IAAI,OAAO;AAGpC,OAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,WAAU,QAAQ,WAAW,OAAO,MAAM;AAI9C,sBAAoB,KAAK;GACvB,SAAS;GACT,cAAc;GACd,MAAM,eAAe,IAAI,OAAO;GACjC,CAAC;;AAIJ,MAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,iBAAgB,cAAc,WAAW,OAAO,MAAM;AAI1D,QAAO;EACL,YAAY;EACZ;EACA;EACD"}
+{"version":3,"file":"rscProcessor.mjs","names":[],"sources":["../../src/build/rscProcessor.ts"],"sourcesContent":["import { drainStream } from \"../util/drainStream\";\nimport { getPayloadIDFor } from \"../rsc/rscModule\";\nimport { computeContentHash } from \"./contentHash\";\nimport { findReferencedIds, topologicalSort } from \"./dependencyGraph\";\n\nexport interface ProcessedComponent {\n  finalId: string;\n  finalContent: string;\n  name?: string;\n}\n\nexport interface ProcessResult {\n  components: ProcessedComponent[];\n  appRscContent: string;\n  idMapping: Map<string, string>;\n}\n\ninterface RawComponent {\n  id: string;\n  data: string;\n  name?: string;\n}\n\n/**\n * Processes RSC components by replacing temporary UUIDs with content-based hashes.\n *\n * @param deferRegistryIterator - Iterator yielding components with { id, data }\n * @param appRscStream - The main RSC stream\n * @param context - Optional context for logging warnings\n */\nexport async function processRscComponents(\n  deferRegistryIterator: AsyncIterable<RawComponent>,\n  appRscStream: ReadableStream,\n  context?: { warn: (message: string) => void },\n): Promise<ProcessResult> {\n  // Step 1: Collect all components from deferRegistry\n  const components = new Map<string, string>();\n  const componentNames = new Map<string, string | undefined>();\n  for await (const { id, data, name } of deferRegistryIterator) {\n    components.set(id, data);\n    componentNames.set(id, name);\n  }\n\n  // Step 2: Drain appRsc stream to string\n  let appRscContent = await drainStream(appRscStream);\n\n  // If no components, return early\n  if (components.size === 0) {\n    return {\n      components: [],\n      appRscContent,\n      idMapping: new Map(),\n    };\n  }\n\n  const allIds = new Set(components.keys());\n\n  // Step 3: Build dependency graph\n  // For each component, find which other component IDs appear in its content\n  const dependencies = new Map<string, Set<string>>();\n  for (const [id, content] of components) {\n    const otherIds = new Set(allIds);\n    otherIds.delete(id); // Don't include self-references\n    const refs = findReferencedIds(content, otherIds);\n    dependencies.set(id, refs);\n  }\n\n  // Step 4: Topologically sort components\n  const { sorted, inCycle } = topologicalSort(dependencies);\n\n  // Step 5: Handle cycles - warn and keep original temp IDs\n  const idMapping = new Map<string, string>();\n\n  if (inCycle.length > 0) {\n    context?.warn(\n      `[funstack] Warning: ${inCycle.length} RSC component(s) are in dependency cycles and will keep unstable IDs: ${inCycle.join(\", \")}`,\n    );\n    for (const id of inCycle) {\n      idMapping.set(id, id); // Map to itself (keep original ID)\n    }\n  }\n\n  // Step 6: Process sorted components in order\n  const processedComponents: ProcessedComponent[] = [];\n\n  for (const tempId of sorted) {\n    let content = components.get(tempId)!;\n\n    // Replace all already-finalized temp IDs with their hash-based IDs\n    for (const [oldId, newId] of idMapping) {\n      if (oldId !== newId) {\n        content = content.replaceAll(oldId, newId);\n      }\n    }\n\n    // Compute content hash for this component\n    const contentHash = await computeContentHash(content);\n    const finalId = getPayloadIDFor(contentHash);\n\n    // Create mapping\n    idMapping.set(tempId, finalId);\n\n    processedComponents.push({\n      finalId,\n      finalContent: content,\n      name: componentNames.get(tempId),\n    });\n  }\n\n  // Add cycle members to processed components (with original IDs)\n  for (const tempId of inCycle) {\n    let content = components.get(tempId)!;\n\n    // Replace finalized IDs in cycle member content\n    for (const [oldId, newId] of idMapping) {\n      if (oldId !== newId) {\n        content = content.replaceAll(oldId, newId);\n      }\n    }\n\n    processedComponents.push({\n      finalId: tempId, // Keep original temp ID\n      finalContent: content,\n      name: componentNames.get(tempId),\n    });\n  }\n\n  // Step 7: Process appRsc - replace all temp IDs with final IDs\n  for (const [oldId, newId] of idMapping) {\n    if (oldId !== newId) {\n      appRscContent = appRscContent.replaceAll(oldId, newId);\n    }\n  }\n\n  return {\n    components: processedComponents,\n    appRscContent,\n    idMapping,\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,eAAsB,qBACpB,uBACA,cACA,SACwB;CAExB,MAAM,6BAAa,IAAI,KAAqB;CAC5C,MAAM,iCAAiB,IAAI,KAAiC;AAC5D,YAAW,MAAM,EAAE,IAAI,MAAM,UAAU,uBAAuB;AAC5D,aAAW,IAAI,IAAI,KAAK;AACxB,iBAAe,IAAI,IAAI,KAAK;;CAI9B,IAAI,gBAAgB,MAAM,YAAY,aAAa;AAGnD,KAAI,WAAW,SAAS,EACtB,QAAO;EACL,YAAY,EAAE;EACd;EACA,2BAAW,IAAI,KAAK;EACrB;CAGH,MAAM,SAAS,IAAI,IAAI,WAAW,MAAM,CAAC;CAIzC,MAAM,+BAAe,IAAI,KAA0B;AACnD,MAAK,MAAM,CAAC,IAAI,YAAY,YAAY;EACtC,MAAM,WAAW,IAAI,IAAI,OAAO;AAChC,WAAS,OAAO,GAAG;EACnB,MAAM,OAAO,kBAAkB,SAAS,SAAS;AACjD,eAAa,IAAI,IAAI,KAAK;;CAI5B,MAAM,EAAE,QAAQ,YAAY,gBAAgB,aAAa;CAGzD,MAAM,4BAAY,IAAI,KAAqB;AAE3C,KAAI,QAAQ,SAAS,GAAG;AACtB,WAAS,KACP,uBAAuB,QAAQ,OAAO,yEAAyE,QAAQ,KAAK,KAAK,GAClI;AACD,OAAK,MAAM,MAAM,QACf,WAAU,IAAI,IAAI,GAAG;;CAKzB,MAAM,sBAA4C,EAAE;AAEpD,MAAK,MAAM,UAAU,QAAQ;EAC3B,IAAI,UAAU,WAAW,IAAI,OAAO;AAGpC,OAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,WAAU,QAAQ,WAAW,OAAO,MAAM;EAM9C,MAAM,UAAU,gBADI,MAAM,mBAAmB,QAAQ,CACT;AAG5C,YAAU,IAAI,QAAQ,QAAQ;AAE9B,sBAAoB,KAAK;GACvB;GACA,cAAc;GACd,MAAM,eAAe,IAAI,OAAO;GACjC,CAAC;;AAIJ,MAAK,MAAM,UAAU,SAAS;EAC5B,IAAI,UAAU,WAAW,IAAI,OAAO;AAGpC,OAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,WAAU,QAAQ,WAAW,OAAO,MAAM;AAI9C,sBAAoB,KAAK;GACvB,SAAS;GACT,cAAc;GACd,MAAM,eAAe,IAAI,OAAO;GACjC,CAAC;;AAIJ,MAAK,MAAM,CAAC,OAAO,UAAU,UAC3B,KAAI,UAAU,MACZ,iBAAgB,cAAc,WAAW,OAAO,MAAM;AAI1D,QAAO;EACL,YAAY;EACZ;EACA;EACD"}

package/dist/build/validateEntryPath.mjs

@@ -22,7 +22,7 @@ function checkDuplicatePaths(paths) {
 		seen.add(p);
 	}
 }
-
 //#endregion
 export { checkDuplicatePaths, validateEntryPath };
+
 //# sourceMappingURL=validateEntryPath.mjs.map

package/dist/client/entry.d.mts

@@ -1 +1 @@
-import "virtual:funstack/client-init";
+export { };

package/dist/client/entry.mjs

@@ -9,7 +9,6 @@ import { createRoot, hydrateRoot } from "react-dom/client";
 import { rscStream } from "rsc-html-stream/client";
 import { jsx } from "react/jsx-runtime";
 import { ssr } from "virtual:funstack/config";
-
 //#region src/client/entry.tsx
 async function devMain() {
 	let setPayload;
@@ -55,7 +54,7 @@ async function prodMain() {
 }
 if (import.meta.env.DEV) devMain();
 else prodMain();
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=entry.mjs.map

package/dist/client/entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.mjs","names":["ssrEnabled"],"sources":["../../src/client/entry.tsx"],"sourcesContent":["// Client initialization - runs before React (side effects only)\nimport \"virtual:funstack/client-init\";\n\nimport {\n  createFromReadableStream,\n  createFromFetch,\n} from \"@vitejs/plugin-rsc/browser\";\nimport React, { startTransition, useEffect, useState } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { rscStream } from \"rsc-html-stream/client\";\nimport { GlobalErrorBoundary } from \"./error-boundary\";\nimport type { RscPayload } from \"../rsc/entry\";\nimport { devMainRscPath } from \"../rsc/request\";\nimport { appClientManifestVar, type AppClientManifest } from \"./globals\";\nimport { withBasePath } from \"../util/basePath\";\n\nimport { ssr as ssrEnabled } from \"virtual:funstack/config\";\n\nasync function devMain() {\n  let setPayload: (v: RscPayload) => void;\n\n  const initialPayload = await createFromReadableStream<RscPayload>(rscStream);\n\n  function BrowserRoot() {\n    const [payload, setPayload_] = useState(initialPayload);\n\n    useEffect(() => {\n      setPayload = (v) => startTransition(() => setPayload_(v));\n    }, [setPayload_]);\n\n    return payload.root;\n  }\n\n  // re-fetch RSC and trigger re-rendering\n  async function fetchRscPayload() {\n    const payload = await createFromFetch<RscPayload>(\n      fetch(withBasePath(devMainRscPath)),\n    );\n    setPayload(payload);\n  }\n\n  const browserRoot = (\n    <React.StrictMode>\n      <GlobalErrorBoundary>\n        <BrowserRoot />\n      </GlobalErrorBoundary>\n    </React.StrictMode>\n  );\n\n  if (\n    // @ts-expect-error\n    globalThis.__NO_HYDRATE\n  ) {\n    // This happens when SSR failed on server\n    createRoot(document).render(browserRoot);\n  } else if (ssrEnabled) {\n    hydrateRoot(document, browserRoot);\n  } else {\n    // SSR off: Root shell is static HTML, mount App client-side\n    createRoot(document).render(browserRoot);\n  }\n\n  // implement server HMR by triggering re-fetch/render of RSC upon server code change\n  if (import.meta.hot) {\n    import.meta.hot.on(\"rsc:update\", () => {\n      fetchRscPayload();\n    });\n  }\n}\n\nasync function prodMain() {\n  const manifest: AppClientManifest =\n    // @ts-expect-error\n    globalThis[appClientManifestVar];\n\n  const payload = await createFromFetch<RscPayload>(fetch(manifest.stream));\n\n  function BrowserRoot() {\n    return payload.root;\n  }\n\n  if (ssrEnabled) {\n    // SSR on: full tree was SSR'd, hydrate from RSC payload\n    const browserRoot = (\n      <React.StrictMode>\n        <GlobalErrorBoundary>\n          <BrowserRoot />\n        </GlobalErrorBoundary>\n      </React.StrictMode>\n    );\n\n    hydrateRoot(document, browserRoot);\n  } else {\n    // SSR off: Root shell only, mount App client-side\n    const browserRoot = <BrowserRoot />;\n    const appRootId = manifest.marker!;\n\n    const appMarker = document.getElementById(appRootId);\n    if (!appMarker) {\n      throw new Error(\n        `Failed to find app root element by id \"${appRootId}\". This is likely a bug.`,\n      );\n    }\n    const appRoot = appMarker.parentElement;\n    if (!appRoot) {\n      throw new Error(\n        `App root element has no parent element. This is likely a bug.`,\n      );\n    }\n    appMarker.remove();\n\n    createRoot(appRoot).render(browserRoot);\n  }\n}\n\nif (import.meta.env.DEV) {\n  devMain();\n} else {\n  prodMain();\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,eAAe,UAAU;CACvB,IAAI;CAEJ,MAAM,iBAAiB,MAAM,yBAAqC,UAAU;CAE5E,SAAS,cAAc;EACrB,MAAM,CAAC,SAAS,eAAe,SAAS,eAAe;AAEvD,kBAAgB;AACd,iBAAc,MAAM,sBAAsB,YAAY,EAAE,CAAC;KACxD,CAAC,YAAY,CAAC;AAEjB,SAAO,QAAQ;;CAIjB,eAAe,kBAAkB;EAC/B,MAAM,UAAU,MAAM,gBACpB,MAAM,aAAa,eAAe,CAAC,CACpC;AACD,aAAW,QAAQ;;CAGrB,MAAM,cACJ,oBAAC,MAAM,wBACL,oBAAC,iCACC,oBAAC,gBAAc,GACK,GACL;AAGrB,KAEE,WAAW,aAGX,YAAW,SAAS,CAAC,OAAO,YAAY;UAC/BA,IACT,aAAY,UAAU,YAAY;KAGlC,YAAW,SAAS,CAAC,OAAO,YAAY;AAI1C,KAAI,OAAO,KAAK,IACd,QAAO,KAAK,IAAI,GAAG,oBAAoB;AACrC,mBAAiB;GACjB;;AAIN,eAAe,WAAW;CACxB,MAAM,WAEJ,WAAW;CAEb,MAAM,UAAU,MAAM,gBAA4B,MAAM,SAAS,OAAO,CAAC;CAEzE,SAAS,cAAc;AACrB,SAAO,QAAQ;;AAGjB,KAAIA,KAAY;EAEd,MAAM,cACJ,oBAAC,MAAM,wBACL,oBAAC,iCACC,oBAAC,gBAAc,GACK,GACL;AAGrB,cAAY,UAAU,YAAY;QAC7B;EAEL,MAAM,cAAc,oBAAC,gBAAc;EACnC,MAAM,YAAY,SAAS;EAE3B,MAAM,YAAY,SAAS,eAAe,UAAU;AACpD,MAAI,CAAC,UACH,OAAM,IAAI,MACR,0CAA0C,UAAU,0BACrD;EAEH,MAAM,UAAU,UAAU;AAC1B,MAAI,CAAC,QACH,OAAM,IAAI,MACR,gEACD;AAEH,YAAU,QAAQ;AAElB,aAAW,QAAQ,CAAC,OAAO,YAAY;;;AAI3C,IAAI,OAAO,KAAK,IAAI,IAClB,UAAS;IAET,WAAU"}
+{"version":3,"file":"entry.mjs","names":["ssrEnabled"],"sources":["../../src/client/entry.tsx"],"sourcesContent":["// Client initialization - runs before React (side effects only)\nimport \"virtual:funstack/client-init\";\n\nimport {\n  createFromReadableStream,\n  createFromFetch,\n} from \"@vitejs/plugin-rsc/browser\";\nimport React, { startTransition, useEffect, useState } from \"react\";\nimport { createRoot, hydrateRoot } from \"react-dom/client\";\nimport { rscStream } from \"rsc-html-stream/client\";\nimport { GlobalErrorBoundary } from \"./error-boundary\";\nimport type { RscPayload } from \"../rsc/entry\";\nimport { devMainRscPath } from \"../rsc/request\";\nimport { appClientManifestVar, type AppClientManifest } from \"./globals\";\nimport { withBasePath } from \"../util/basePath\";\n\nimport { ssr as ssrEnabled } from \"virtual:funstack/config\";\n\nasync function devMain() {\n  let setPayload: (v: RscPayload) => void;\n\n  const initialPayload = await createFromReadableStream<RscPayload>(rscStream);\n\n  function BrowserRoot() {\n    const [payload, setPayload_] = useState(initialPayload);\n\n    useEffect(() => {\n      setPayload = (v) => startTransition(() => setPayload_(v));\n    }, [setPayload_]);\n\n    return payload.root;\n  }\n\n  // re-fetch RSC and trigger re-rendering\n  async function fetchRscPayload() {\n    const payload = await createFromFetch<RscPayload>(\n      fetch(withBasePath(devMainRscPath)),\n    );\n    setPayload(payload);\n  }\n\n  const browserRoot = (\n    <React.StrictMode>\n      <GlobalErrorBoundary>\n        <BrowserRoot />\n      </GlobalErrorBoundary>\n    </React.StrictMode>\n  );\n\n  if (\n    // @ts-expect-error\n    globalThis.__NO_HYDRATE\n  ) {\n    // This happens when SSR failed on server\n    createRoot(document).render(browserRoot);\n  } else if (ssrEnabled) {\n    hydrateRoot(document, browserRoot);\n  } else {\n    // SSR off: Root shell is static HTML, mount App client-side\n    createRoot(document).render(browserRoot);\n  }\n\n  // implement server HMR by triggering re-fetch/render of RSC upon server code change\n  if (import.meta.hot) {\n    import.meta.hot.on(\"rsc:update\", () => {\n      fetchRscPayload();\n    });\n  }\n}\n\nasync function prodMain() {\n  const manifest: AppClientManifest =\n    // @ts-expect-error\n    globalThis[appClientManifestVar];\n\n  const payload = await createFromFetch<RscPayload>(fetch(manifest.stream));\n\n  function BrowserRoot() {\n    return payload.root;\n  }\n\n  if (ssrEnabled) {\n    // SSR on: full tree was SSR'd, hydrate from RSC payload\n    const browserRoot = (\n      <React.StrictMode>\n        <GlobalErrorBoundary>\n          <BrowserRoot />\n        </GlobalErrorBoundary>\n      </React.StrictMode>\n    );\n\n    hydrateRoot(document, browserRoot);\n  } else {\n    // SSR off: Root shell only, mount App client-side\n    const browserRoot = <BrowserRoot />;\n    const appRootId = manifest.marker!;\n\n    const appMarker = document.getElementById(appRootId);\n    if (!appMarker) {\n      throw new Error(\n        `Failed to find app root element by id \"${appRootId}\". This is likely a bug.`,\n      );\n    }\n    const appRoot = appMarker.parentElement;\n    if (!appRoot) {\n      throw new Error(\n        `App root element has no parent element. This is likely a bug.`,\n      );\n    }\n    appMarker.remove();\n\n    createRoot(appRoot).render(browserRoot);\n  }\n}\n\nif (import.meta.env.DEV) {\n  devMain();\n} else {\n  prodMain();\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,eAAe,UAAU;CACvB,IAAI;CAEJ,MAAM,iBAAiB,MAAM,yBAAqC,UAAU;CAE5E,SAAS,cAAc;EACrB,MAAM,CAAC,SAAS,eAAe,SAAS,eAAe;AAEvD,kBAAgB;AACd,iBAAc,MAAM,sBAAsB,YAAY,EAAE,CAAC;KACxD,CAAC,YAAY,CAAC;AAEjB,SAAO,QAAQ;;CAIjB,eAAe,kBAAkB;EAC/B,MAAM,UAAU,MAAM,gBACpB,MAAM,aAAa,eAAe,CAAC,CACpC;AACD,aAAW,QAAQ;;CAGrB,MAAM,cACJ,oBAAC,MAAM,YAAP,EAAA,UACE,oBAAC,qBAAD,EAAA,UACE,oBAAC,aAAD,EAAe,CAAA,EACK,CAAA,EACL,CAAA;AAGrB,KAEE,WAAW,aAGX,YAAW,SAAS,CAAC,OAAO,YAAY;UAC/BA,IACT,aAAY,UAAU,YAAY;KAGlC,YAAW,SAAS,CAAC,OAAO,YAAY;AAI1C,KAAI,OAAO,KAAK,IACd,QAAO,KAAK,IAAI,GAAG,oBAAoB;AACrC,mBAAiB;GACjB;;AAIN,eAAe,WAAW;CACxB,MAAM,WAEJ,WAAW;CAEb,MAAM,UAAU,MAAM,gBAA4B,MAAM,SAAS,OAAO,CAAC;CAEzE,SAAS,cAAc;AACrB,SAAO,QAAQ;;AAGjB,KAAIA,KAAY;EAEd,MAAM,cACJ,oBAAC,MAAM,YAAP,EAAA,UACE,oBAAC,qBAAD,EAAA,UACE,oBAAC,aAAD,EAAe,CAAA,EACK,CAAA,EACL,CAAA;AAGrB,cAAY,UAAU,YAAY;QAC7B;EAEL,MAAM,cAAc,oBAAC,aAAD,EAAe,CAAA;EACnC,MAAM,YAAY,SAAS;EAE3B,MAAM,YAAY,SAAS,eAAe,UAAU;AACpD,MAAI,CAAC,UACH,OAAM,IAAI,MACR,0CAA0C,UAAU,0BACrD;EAEH,MAAM,UAAU,UAAU;AAC1B,MAAI,CAAC,QACH,OAAM,IAAI,MACR,gEACD;AAEH,YAAU,QAAQ;AAElB,aAAW,QAAQ,CAAC,OAAO,YAAY;;;AAI3C,IAAI,OAAO,KAAK,IAAI,IAClB,UAAS;IAET,WAAU"}

package/dist/client/error-boundary.mjs

@@ -1,9 +1,7 @@
 "use client";
-
-import React, { startTransition } from "react";
+import { startTransition } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { jsx, jsxs } from "react/jsx-runtime";
-
 //#region src/client/error-boundary.tsx
 /**
 * Whole-page error boundary for unexpected errors during development
@@ -42,7 +40,7 @@ const Fallback = ({ error, resetErrorBoundary }) => {
 		]
 	})] });
 };
-
 //#endregion
 export { GlobalErrorBoundary };
+
 //# sourceMappingURL=error-boundary.mjs.map

package/dist/client/error-boundary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.mjs","names":[],"sources":["../../src/client/error-boundary.tsx"],"sourcesContent":["\"use client\";\n\nimport React, { startTransition } from \"react\";\nimport { ErrorBoundary, type FallbackProps } from \"react-error-boundary\";\n\n/**\n * Whole-page error boundary for unexpected errors during development\n */\nexport const GlobalErrorBoundary: React.FC<React.PropsWithChildren> = (\n  props,\n) => {\n  return (\n    <ErrorBoundary FallbackComponent={Fallback}>{props.children}</ErrorBoundary>\n  );\n};\n\nconst Fallback: React.FC<FallbackProps> = ({ error, resetErrorBoundary }) => {\n  const errorMessage = error instanceof Error ? error.message : String(error);\n  return (\n    <html>\n      <head>\n        <title>Unexpected Error</title>\n      </head>\n      <body\n        style={{\n          height: \"100vh\",\n          display: \"flex\",\n          flexDirection: \"column\",\n          placeContent: \"center\",\n          placeItems: \"center\",\n          fontSize: \"24px\",\n          fontWeight: 400,\n          lineHeight: \"1.5em\",\n        }}\n      >\n        <h1>Caught an unexpected error</h1>\n        <p>See the console for details.</p>\n        <pre>Error: {errorMessage}</pre>\n        <button\n          onClick={() => {\n            startTransition(() => {\n              resetErrorBoundary();\n            });\n          }}\n        >\n          Reset\n        </button>\n      </body>\n    </html>\n  );\n};\n"],"mappings":";;;;;;;;;;AAQA,MAAa,uBACX,UACG;AACH,QACE,oBAAC;EAAc,mBAAmB;YAAW,MAAM;GAAyB;;AAIhF,MAAM,YAAqC,EAAE,OAAO,yBAAyB;CAC3E,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,QACE,qBAAC,qBACC,oBAAC,oBACC,oBAAC,qBAAM,qBAAwB,GAC1B,EACP,qBAAC;EACC,OAAO;GACL,QAAQ;GACR,SAAS;GACT,eAAe;GACf,cAAc;GACd,YAAY;GACZ,UAAU;GACV,YAAY;GACZ,YAAY;GACb;;GAED,oBAAC,kBAAG,+BAA+B;GACnC,oBAAC,iBAAE,iCAAgC;GACnC,qBAAC,oBAAI,WAAQ,gBAAmB;GAChC,oBAAC;IACC,eAAe;AACb,2BAAsB;AACpB,0BAAoB;OACpB;;cAEL;KAEQ;;GACJ,IACF"}
+{"version":3,"file":"error-boundary.mjs","names":[],"sources":["../../src/client/error-boundary.tsx"],"sourcesContent":["\"use client\";\n\nimport React, { startTransition } from \"react\";\nimport { ErrorBoundary, type FallbackProps } from \"react-error-boundary\";\n\n/**\n * Whole-page error boundary for unexpected errors during development\n */\nexport const GlobalErrorBoundary: React.FC<React.PropsWithChildren> = (\n  props,\n) => {\n  return (\n    <ErrorBoundary FallbackComponent={Fallback}>{props.children}</ErrorBoundary>\n  );\n};\n\nconst Fallback: React.FC<FallbackProps> = ({ error, resetErrorBoundary }) => {\n  const errorMessage = error instanceof Error ? error.message : String(error);\n  return (\n    <html>\n      <head>\n        <title>Unexpected Error</title>\n      </head>\n      <body\n        style={{\n          height: \"100vh\",\n          display: \"flex\",\n          flexDirection: \"column\",\n          placeContent: \"center\",\n          placeItems: \"center\",\n          fontSize: \"24px\",\n          fontWeight: 400,\n          lineHeight: \"1.5em\",\n        }}\n      >\n        <h1>Caught an unexpected error</h1>\n        <p>See the console for details.</p>\n        <pre>Error: {errorMessage}</pre>\n        <button\n          onClick={() => {\n            startTransition(() => {\n              resetErrorBoundary();\n            });\n          }}\n        >\n          Reset\n        </button>\n      </body>\n    </html>\n  );\n};\n"],"mappings":";;;;;;;;AAQA,MAAa,uBACX,UACG;AACH,QACE,oBAAC,eAAD;EAAe,mBAAmB;YAAW,MAAM;EAAyB,CAAA;;AAIhF,MAAM,YAAqC,EAAE,OAAO,yBAAyB;CAC3E,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,QACE,qBAAC,QAAD,EAAA,UAAA,CACE,oBAAC,QAAD,EAAA,UACE,oBAAC,SAAD,EAAA,UAAO,oBAAwB,CAAA,EAC1B,CAAA,EACP,qBAAC,QAAD;EACE,OAAO;GACL,QAAQ;GACR,SAAS;GACT,eAAe;GACf,cAAc;GACd,YAAY;GACZ,UAAU;GACV,YAAY;GACZ,YAAY;GACb;YAVH;GAYE,oBAAC,MAAD,EAAA,UAAI,8BAA+B,CAAA;GACnC,oBAAC,KAAD,EAAA,UAAG,gCAAgC,CAAA;GACnC,qBAAC,OAAD,EAAA,UAAA,CAAK,WAAQ,aAAmB,EAAA,CAAA;GAChC,oBAAC,UAAD;IACE,eAAe;AACb,2BAAsB;AACpB,0BAAoB;OACpB;;cAEL;IAEQ,CAAA;GACJ;IACF,EAAA,CAAA"}

package/dist/client/globals.mjs

@@ -1,10 +1,8 @@
-//#region src/client/globals.ts
-const globalPrefix = "FUNSTACK_STATIC_";
 /**
 * Variable name for the app client manifest
 */
-const appClientManifestVar = `${globalPrefix}appClientManifest`;
-
+const appClientManifestVar = `FUNSTACK_STATIC_appClientManifest`;
 //#endregion
 export { appClientManifestVar };
+
 //# sourceMappingURL=globals.mjs.map

package/dist/client/globals.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"globals.mjs","names":[],"sources":["../../src/client/globals.ts"],"sourcesContent":["// Prefix for global variables\nconst globalPrefix = \"FUNSTACK_STATIC_\";\n\n/**\n * Variable name for the app client manifest\n */\nexport const appClientManifestVar = `${globalPrefix}appClientManifest`;\n\nexport interface AppClientManifest {\n  marker?: string;\n  stream: string;\n}\n"],"mappings":";AACA,MAAM,eAAe;;;;AAKrB,MAAa,uBAAuB,GAAG,aAAa"}
+{"version":3,"file":"globals.mjs","names":[],"sources":["../../src/client/globals.ts"],"sourcesContent":["// Prefix for global variables\nconst globalPrefix = \"FUNSTACK_STATIC_\";\n\n/**\n * Variable name for the app client manifest\n */\nexport const appClientManifestVar = `${globalPrefix}appClientManifest`;\n\nexport interface AppClientManifest {\n  marker?: string;\n  stream: string;\n}\n"],"mappings":";;;AAMA,MAAa,uBAAuB"}

package/dist/docs/GettingStarted.md

@@ -168,7 +168,11 @@ Only two files are required: `Root.tsx` and `App.tsx`. The paths to these files
 If you use AI coding assistants like [Claude Code](https://docs.anthropic.com/en/docs/claude-code), you can install the FUNSTACK Static knowledge skill to help your AI assistant better understand the framework:
 
 ```bash
-npx funstack-static-skill-installer
+npx -p @funstack/static funstack-static-skill-installer
+# or
+yarn dlx -p @funstack/static funstack-static-skill-installer
+# or
+pnpm --package @funstack/static dlx funstack-static-skill-installer
 # or, if you use skills CLI (https://skills.sh/)
 npx skills add uhyo/funstack-static
 ```
@@ -177,7 +181,7 @@ This registers the `funstack-static-knowledge` skill, which provides your AI ass
 
 ## What's Next?
 
-- Learn about the [funstackStatic() Plugin API](/funstack-static/api/funstack-static) for configuration options
-- Understand [defer()](/funstack-static/api/defer) for Server Component chunk splitting
-- Build multi-page static sites with [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints)
-- Dive into [React Server Components](/funstack-static/learn/rsc) concepts
+- Learn about the [funstackStatic() Plugin API](/api/funstack-static) for configuration options
+- Understand [defer()](/api/defer) for Server Component chunk splitting
+- Build multi-page static sites with [Multiple Entrypoints](/advanced/multiple-entrypoints)
+- Dive into [React Server Components](/learn/rsc) concepts

package/dist/docs/MigratingFromViteSPA.md

@@ -27,7 +27,7 @@ Or with pnpm:
 pnpm add @funstack/static
 ```
 
-**Hint:** at this point, a skill installer command is available to add FUNSTACK Static knowledge to your AI agents. Run `npx funstack-static-skill-installer` (or `npx skills add uhyo/funstack-static` if you use [skills CLI](https://skills.sh/)) to add the skill. Then you can ask your AI assistant for help with the migration!
+**Hint:** at this point, you can add FUNSTACK Static knowledge to your AI agents. Run `npx -p @funstack/static funstack-static-skill-installer` (or `npx skills add uhyo/funstack-static` if you use [skills CLI](https://skills.sh/)) to add the skill. Then you can ask your AI assistant for help with the migration!
 
 ## Step 2: Update Vite Config
 
@@ -316,6 +316,6 @@ Ensure CSS imports are in `App.tsx` or in client components that are actually re
 
 ## What's Next?
 
-- Learn about [defer()](/funstack-static/api/defer) for code splitting Server Components
-- Explore [Optimizing RSC Payloads](/funstack-static/learn/optimizing-payloads) for better performance
-- Understand [How It Works](/funstack-static/learn/how-it-works) under the hood
+- Learn about [defer()](/api/defer) for code splitting Server Components
+- Explore [Optimizing RSC Payloads](/learn/optimizing-payloads) for better performance
+- Understand [How It Works](/learn/how-it-works) under the hood

package/dist/docs/{learn → advanced}/MultipleEntrypoints.md

@@ -1,13 +1,13 @@
-# Multiple Entrypoints
+# Multiple Entrypoints (SSG)
 
 By default, FUNSTACK Static produces a single `index.html` from one `root` + `app` pair. The **multiple entries** feature lets you produce multiple HTML pages from a single project, targeting SSG (Static Site Generation) use cases where a site has distinct pages like `index.html`, `about.html`, and `blog/post-1.html`.
 
 ## When to Use Multiple Entries
 
-Use the `entries` option when you want to build a **multi-page static site** where each page is a self-contained HTML document. This is different from a single-page app with client-side routing:
+Use the `entries` option when you want to build a **multi-page static site** where each page is more like a self-contained HTML document.
 
-- **Single-entry mode** (`root` + `app`): One HTML file, client-side routing between pages. Best for app-like experiences where navigation should not trigger full page reloads.
-- **Multiple entries mode** (`entries`): Multiple HTML files, each independently pre-rendered. Best for content sites (blogs, docs, marketing pages) where each page should be a standalone document.
+- **Single-entry mode** (`root` + `app`): One HTML file, client-side routing between pages. Best for app-like experiences where dynamic data loading and client-side interactivity are heavily used, and SEO is less of a concern (e.g., dashboards, web apps).
+- **Multiple entries mode** (`entries`): Multiple HTML files, each independently pre-rendered. Best for content sites (blogs, docs, marketing pages) where SEO and fast initial load are priorities. Client-side routing is still possible by using a router library with SSR support.
 
 ## Basic Setup
 
@@ -33,7 +33,7 @@ export default defineConfig({
 
 ### 2. Create the Entries Module
 
-The entries module default-exports a function that returns an array of entry definitions:
+The entries module is run in **the server environment at build time**. It must default-export a function that returns an array of entry definitions (async functions are also supported):
 
 ```tsx
 // src/entries.tsx
@@ -110,7 +110,7 @@ import type { EntryDefinition } from "@funstack/static/entries";
 
 **Type:** `string`
 
-The output file path relative to the build output directory. Must end with `.html` and must not start with `/`.
+The output file path relative to the build output directory. Must include file extensions and must not start with `/`.
 
 ```typescript
 {
@@ -133,8 +133,8 @@ The root component module. Accepts either a lazy import or a synchronous module
 root: () => import("./root"),
 
 // Synchronous module object
-import Root from "./root";
-root: { default: Root },
+import * as Root from "./root";
+root: Root,
 ```
 
 The module must have a `default` export of a component that accepts `children`.
@@ -150,8 +150,8 @@ The app content for this entry. Accepts a module (sync or lazy), or a React node
 app: () => import("./pages/Home"),
 
 // Synchronous module object
-import Home from "./pages/Home";
-app: { default: Home },
+import * as Home from "./pages/Home";
+app: Home,
 
 // React node (server component JSX)
 app: <BlogPost slug="hello-world" />,
@@ -166,14 +166,14 @@ For sites with many pages generated from external data, use an async generator t
 ```tsx
 // src/entries.tsx
 import type { EntryDefinition } from "@funstack/static/entries";
-import Root from "./root";
+import * as Root from "./root";
 import { readdir } from "node:fs/promises";
 
 export default async function* getEntries(): AsyncGenerator<EntryDefinition> {
   // Static pages
   yield {
     path: "index.html",
-    root: { default: Root },
+    root: Root,
     app: () => import("./pages/Home"),
   };
 
@@ -182,7 +182,7 @@ export default async function* getEntries(): AsyncGenerator<EntryDefinition> {
     const content = await loadMarkdown(`./content/blog/${slug}`);
     yield {
       path: `blog/${slug.replace(/\.md$/, ".html")}`,
-      root: { default: Root },
+      root: Root,
       app: <BlogPost content={content} />,
     };
   }
@@ -213,34 +213,6 @@ dist/public/
 
 All pages share the same client JavaScript bundle. Only the HTML and RSC payloads differ per entry.
 
-## Navigation Between Entries
-
-Each entry is a fully independent HTML page. Navigation between entries is a full page reload via standard `<a>` links. Client-side interactivity within each page works as usual.
-
-If you need client-side navigation between pages (SPA-style transitions), use single-entry mode with a client-side router instead.
-
-## Interaction with defer()
-
-The `defer()` function works with multiple entries. Deferred components are shared across entries via content hashing -- if multiple entries defer the same component, it is rendered once and reused.
-
-## Path Validation
-
-The build enforces these rules for entry paths:
-
-- Must end with `.html`
-- Must not start with `/` (paths are relative to the output directory)
-- Duplicate paths cause a build error
-
-## Dev and Preview Server
-
-Both the dev server (`vite dev`) and preview server (`vite preview`) handle URL-to-file mapping automatically:
-
-- `/` serves `index.html`
-- `/about` serves `about.html`, falling back to `about/index.html`
-- `/blog/post-1` serves `blog/post-1.html`, falling back to `blog/post-1/index.html`
-
 ## See Also
 
-- [funstackStatic()](/funstack-static/api/funstack-static) - Configuration reference
-- [Getting Started](/funstack-static/getting-started) - Quick start guide
-- [defer()](/funstack-static/api/defer) - Deferred rendering for streaming
+- [Server-Side Rendering](/advanced/SSR) - Content-heavy sites may also benefit from SSR for faster initial paint

package/dist/docs/{learn → advanced}/SSR.md

@@ -90,7 +90,7 @@ Common browser APIs to watch for:
 
 - You want the fastest possible initial paint
 - Your client components are already SSR-compatible
-- You're building content-heavy pages
+- You're building content-heavy pages with [multiple entrypoints](/advanced/multiple-entrypoints)
 
 **Keep SSR disabled when:**
 
@@ -100,5 +100,5 @@ Common browser APIs to watch for:
 
 ## See Also
 
-- [How It Works](/funstack-static/learn/how-it-works) - Understanding the build process
-- [funstackStatic()](/funstack-static/api/funstack-static) - Configuration reference
+- [How It Works](/learn/how-it-works) - Understanding the build process
+- [funstackStatic()](/api/funstack-static) - Configuration reference

package/dist/docs/api/EntryDefinition.md

@@ -135,5 +135,5 @@ export default async function* getEntries() {
 
 ## See Also
 
-- [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) - Guide and examples
-- [funstackStatic()](/funstack-static/api/funstack-static) - Plugin configuration
+- [Multiple Entrypoints](/advanced/multiple-entrypoints) - Guide and examples
+- [funstackStatic()](/api/funstack-static) - Plugin configuration

package/dist/docs/api/FunstackStatic.md

@@ -51,7 +51,7 @@ export default defineConfig({
 });
 ```
 
-See [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) for a full guide.
+See [Multiple Entrypoints](/advanced/multiple-entrypoints) for a full guide.
 
 ## Options
 
@@ -158,7 +158,7 @@ export default function getEntries(): EntryDefinition[] {
 }
 ```
 
-See [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) for details on the `EntryDefinition` type and advanced usage patterns like async generators.
+See [Multiple Entrypoints](/advanced/multiple-entrypoints) for details on the `EntryDefinition` type and advanced usage patterns like async generators.
 
 ### publicOutDir (optional)
 
@@ -274,7 +274,7 @@ You can use the same Vite commands you would use in a normal Vite project:
 
 ## See Also
 
-- [Getting Started](/funstack-static/getting-started) - Quick start guide
-- [Multiple Entrypoints](/funstack-static/learn/multiple-entrypoints) - Multi-page static site generation
-- [defer()](/funstack-static/api/defer) - Deferred rendering for streaming
-- [React Server Components](/funstack-static/learn/rsc) - Understanding RSC
+- [Getting Started](/getting-started) - Quick start guide
+- [Multiple Entrypoints](/advanced/multiple-entrypoints) - Multi-page static site generation
+- [defer()](/api/defer) - Deferred rendering for streaming
+- [React Server Components](/learn/rsc) - Understanding RSC

package/dist/docs/index.md

@@ -8,6 +8,11 @@ A Vite plugin for building static sites with React Server Components.
 - [Getting Started](./GettingStarted.md) - Welcome to **FUNSTACK Static**! Build high-performance Single Page Applications powered by React Server Components - no server required at runtime.
 - [Migrating from Vite SPA](./MigratingFromViteSPA.md) - Already have a Vite-powered React SPA? This guide walks you through migrating to FUNSTACK Static to unlock React Server Components and improved performance.
 
+### Advanced
+
+- [Multiple Entrypoints (SSG)](./advanced/MultipleEntrypoints.md) - By default, FUNSTACK Static produces a single `index.html` from one `root` + `app` pair. The **multiple entries** feature lets you produce multiple HTML pages from a single project, targeting SSG (Static Site Generation) use cases where a site has distinct pages like `index.html`, `about.html`, and `blog/post-1.html`.
+- [Server-Side Rendering](./advanced/SSR.md) - In FUNSTACK Static, **Server-Side Rendering (SSR)** means a build-time process that pre-renders your React components (including client components) to HTML. This can make the initial paint faster.
+
 ### API
 
 - [defer()](./api/Defer.md) - The `defer()` function enables deferred rendering for React Server Components, reducing initial data load.
@@ -19,7 +24,5 @@ A Vite plugin for building static sites with React Server Components.
 - [Prefetching with defer() and Activity](./learn/DeferAndActivity.md) - When using `defer()` to split RSC payloads, content is fetched on-demand as it renders. But what if you want to start fetching _before_ the user actually needs it? By combining `defer()` with React 19's `<Activity>` component, you can prefetch deferred payloads in the background so they're ready instantly when revealed.
 - [How It Works](./learn/HowItWorks.md) - FUNSTACK Static is a React framework that leverages React Server Components (RSC) to build a fully static Single Page Application. The result is a set of files that can be deployed to **any static file hosting service** - no server required at runtime.
 - [Using lazy() in Server Components](./learn/LazyServerComponents.md) - React's `lazy()` API is typically associated with client-side code splitting. However, it can also be used in server environments to reduce the initial response time of the development server by deferring the work needed to compute your application.
-- [Multiple Entrypoints](./learn/MultipleEntrypoints.md) - By default, FUNSTACK Static produces a single `index.html` from one `root` + `app` pair. The **multiple entries** feature lets you produce multiple HTML pages from a single project, targeting SSG (Static Site Generation) use cases where a site has distinct pages like `index.html`, `about.html`, and `blog/post-1.html`.
 - [Optimizing RSC Payloads](./learn/OptimizingPayloads.md) - FUNSTACK Static uses React Server Components (RSC) to pre-render your application at build time. By default, all content is bundled into a single RSC payload. This page explains how to split that payload into smaller chunks for better loading performance.
 - [React Server Components](./learn/RSC.md) - [React Server Components (RSC)](https://react.dev/reference/rsc/server-components) are a new paradigm for building React applications where components can run on the server (or at build time) rather than in the browser.
-- [Server-Side Rendering](./learn/SSR.md) - In FUNSTACK Static, **Server-Side Rendering (SSR)** means a build-time process that pre-renders your React components (including client components) to HTML. This can make the initial paint faster.

package/dist/docs/learn/DeferAndActivity.md

@@ -171,6 +171,6 @@ Avoid this pattern when:
 
 ## See Also
 
-- [Optimizing RSC Payloads](/funstack-static/learn/optimizing-payloads) - Using `defer()` to split RSC payloads
-- [defer()](/funstack-static/api/defer) - API reference with full signature and technical details
-- [React Server Components](/funstack-static/learn/rsc) - Understanding RSC fundamentals
+- [Optimizing RSC Payloads](/learn/optimizing-payloads) - Using `defer()` to split RSC payloads
+- [defer()](/api/defer) - API reference with full signature and technical details
+- [React Server Components](/learn/rsc) - Understanding RSC fundamentals

package/dist/docs/learn/HowItWorks.md

@@ -105,5 +105,5 @@ Note that in both modes, React Server Components are still used - the `ssr` opti
 
 ## See Also
 
-- [React Server Components](/funstack-static/learn/rsc) - Understanding RSC in depth
-- [Getting Started](/funstack-static/getting-started) - Set up your first project
+- [React Server Components](/learn/rsc) - Understanding RSC in depth
+- [Getting Started](/getting-started) - Set up your first project

package/dist/docs/learn/LazyServerComponents.md

@@ -115,6 +115,6 @@ For small applications with few routes, the overhead of `lazy()` may not be wort
 
 ## See Also
 
-- [Optimizing RSC Payloads](/funstack-static/learn/optimizing-payloads) - Using `defer()` to split RSC payloads
-- [How It Works](/funstack-static/learn/how-it-works) - Overall FUNSTACK Static architecture
-- [defer()](/funstack-static/api/defer) - API reference for the defer function
+- [Optimizing RSC Payloads](/learn/optimizing-payloads) - Using `defer()` to split RSC payloads
+- [How It Works](/learn/how-it-works) - Overall FUNSTACK Static architecture
+- [defer()](/api/defer) - API reference for the defer function