@funstack/static 0.0.1-alpha.0 → 0.0.2-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uhyo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/build/buildApp.mjs

@@ -0,0 +1,34 @@
+import { getModulePathFor } from "../rsc/rscModule.mjs";
+import { getRscPayloadPath, rscPayloadPlaceholder } from "./rscPath.mjs";
+import { drainStream } from "../util/drainStream.mjs";
+import { computeContentHash } from "./contentHash.mjs";
+import { processRscComponents } from "./rscProcessor.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;
+	const entry = await import(pathToFileURL(path.join(config.environments.rsc.build.outDir, "index.js")).href);
+	const baseDir = config.environments.client.build.outDir;
+	const { html, appRsc, deferRegistry } = await entry.build();
+	const htmlContent = await drainStream(html);
+	const { components, appRscContent } = await processRscComponents(deferRegistry.loadAll(), appRsc, context);
+	const mainPayloadHash = await computeContentHash(appRscContent);
+	const base = config.base.endsWith("/") ? config.base.slice(0, -1) : config.base;
+	const mainPayloadPath = base === "/" ? getRscPayloadPath(mainPayloadHash) : base + getRscPayloadPath(mainPayloadHash);
+	const finalHtmlContent = htmlContent.replaceAll(rscPayloadPlaceholder, mainPayloadPath);
+	await writeFileNormal(path.join(baseDir, "index.html"), finalHtmlContent, context);
+	await writeFileNormal(path.join(baseDir, getRscPayloadPath(mainPayloadHash).replace(/^\//, "")), appRscContent, context);
+	for (const { finalId, finalContent } of components) await writeFileNormal(path.join(baseDir, getModulePathFor(finalId).replace(/^\//, "")), finalContent, context);
+}
+async function writeFileNormal(filePath, data, context) {
+	await mkdir(path.dirname(filePath), { recursive: true });
+	context.info(`[funstack] Writing ${filePath}`);
+	await writeFile(filePath, data);
+}
+
+//#endregion
+export { buildApp };
+//# sourceMappingURL=buildApp.mjs.map

package/dist/build/buildApp.mjs.map

@@ -0,0 +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\";\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  // render rsc and html\n  const baseDir = config.environments.client.build.outDir;\n  const { html, appRsc, deferRegistry } = await entry.build();\n\n  // Drain HTML stream to string (needed for placeholder replacement later)\n  const htmlContent = await drainStream(html);\n\n  // Process RSC components with content-based hashes for deterministic file names\n  const { components, appRscContent } = await processRscComponents(\n    deferRegistry.loadAll(),\n    appRsc,\n    context,\n  );\n\n  // Compute hash for main RSC payload and apply base path\n  const mainPayloadHash = await computeContentHash(appRscContent);\n  const base = config.base.endsWith(\"/\")\n    ? config.base.slice(0, -1)\n    : config.base;\n  const mainPayloadPath =\n    base === \"/\"\n      ? getRscPayloadPath(mainPayloadHash)\n      : base + getRscPayloadPath(mainPayloadHash);\n\n  // Replace placeholder with final hashed path (including base path)\n  const finalHtmlContent = htmlContent.replaceAll(\n    rscPayloadPlaceholder,\n    mainPayloadPath,\n  );\n\n  // Write HTML with replaced path\n  await writeFileNormal(\n    path.join(baseDir, \"index.html\"),\n    finalHtmlContent,\n    context,\n  );\n\n  // Write main RSC payload with hashed filename\n  await writeFileNormal(\n    path.join(baseDir, getRscPayloadPath(mainPayloadHash).replace(/^\\//, \"\")),\n    appRscContent,\n    context,\n  );\n\n  // Write processed components with hash-based IDs\n  for (const { finalId, finalContent } of components) {\n    const filePath = path.join(\n      baseDir,\n      getModulePathFor(finalId).replace(/^\\//, \"\"),\n    );\n    await writeFileNormal(filePath, finalContent, context);\n  }\n}\n\nasync function writeFileNormal(\n  filePath: string,\n  data: string,\n  context: MinimalPluginContextWithoutEnvironment,\n) {\n  await mkdir(path.dirname(filePath), { recursive: true });\n  context.info(`[funstack] Writing ${filePath}`);\n  await writeFile(filePath, data);\n}\n"],"mappings":";;;;;;;;;;AAUA,eAAsB,SACpB,SACA,SACA;CACA,MAAM,EAAE,WAAW;CAGnB,MAAM,QAAuC,MAAM,OACjD,cAFgB,KAAK,KAAK,OAAO,aAAa,IAAI,MAAM,QAAQ,WAAW,CAEnD,CAAC;CAI3B,MAAM,UAAU,OAAO,aAAa,OAAO,MAAM;CACjD,MAAM,EAAE,MAAM,QAAQ,kBAAkB,MAAM,MAAM,OAAO;CAG3D,MAAM,cAAc,MAAM,YAAY,KAAK;CAG3C,MAAM,EAAE,YAAY,kBAAkB,MAAM,qBAC1C,cAAc,SAAS,EACvB,QACA,QACD;CAGD,MAAM,kBAAkB,MAAM,mBAAmB,cAAc;CAC/D,MAAM,OAAO,OAAO,KAAK,SAAS,IAAI,GAClC,OAAO,KAAK,MAAM,GAAG,GAAG,GACxB,OAAO;CACX,MAAM,kBACJ,SAAS,MACL,kBAAkB,gBAAgB,GAClC,OAAO,kBAAkB,gBAAgB;CAG/C,MAAM,mBAAmB,YAAY,WACnC,uBACA,gBACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,aAAa,EAChC,kBACA,QACD;AAGD,OAAM,gBACJ,KAAK,KAAK,SAAS,kBAAkB,gBAAgB,CAAC,QAAQ,OAAO,GAAG,CAAC,EACzE,eACA,QACD;AAGD,MAAK,MAAM,EAAE,SAAS,kBAAkB,WAKtC,OAAM,gBAJW,KAAK,KACpB,SACA,iBAAiB,QAAQ,CAAC,QAAQ,OAAO,GAAG,CAC7C,EAC+B,cAAc,QAAQ;;AAI1D,eAAe,gBACb,UACA,MACA,SACA;AACA,OAAM,MAAM,KAAK,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACxD,SAAQ,KAAK,sBAAsB,WAAW;AAC9C,OAAM,UAAU,UAAU,KAAK"}

package/dist/build/contentHash.mjs

@@ -0,0 +1,14 @@
+//#region src/build/contentHash.ts
+/**
+* Computes a SHA-256 hash of the given content and returns the first 16 hex characters.
+* 16 hex chars = 64 bits, which provides sufficient uniqueness for our use case.
+*/
+async function computeContentHash(content) {
+	const data = new TextEncoder().encode(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/contentHash.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentHash.mjs","names":[],"sources":["../../src/build/contentHash.ts"],"sourcesContent":["/**\n * Computes a SHA-256 hash of the given content and returns the first 16 hex characters.\n * 16 hex chars = 64 bits, which provides sufficient uniqueness for our use case.\n */\nexport async function computeContentHash(content: string): Promise<string> {\n  const encoder = new TextEncoder();\n  const data = encoder.encode(content);\n  const hashBuffer = await crypto.subtle.digest(\"SHA-256\", data);\n  const hashArray = Array.from(new Uint8Array(hashBuffer));\n  const hashHex = hashArray\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n  return hashHex.slice(0, 16);\n}\n"],"mappings":";;;;;AAIA,eAAsB,mBAAmB,SAAkC;CAEzE,MAAM,OADU,IAAI,aAAa,CACZ,OAAO,QAAQ;CACpC,MAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,KAAK;AAK9D,QAJkB,MAAM,KAAK,IAAI,WAAW,WAAW,CAAC,CAErD,KAAK,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAC3C,KAAK,GAAG,CACI,MAAM,GAAG,GAAG"}

package/dist/build/dependencyGraph.mjs

@@ -0,0 +1,46 @@
+//#region src/build/dependencyGraph.ts
+/**
+* Finds which IDs from the known set are referenced in the given content.
+*/
+function findReferencedIds(content, allKnownIds) {
+	const referenced = /* @__PURE__ */ new Set();
+	for (const id of allKnownIds) if (content.includes(id)) referenced.add(id);
+	return referenced;
+}
+/**
+* Performs topological sort using Kahn's algorithm.
+* Returns both the sorted nodes and any nodes that are part of cycles.
+*
+* @param dependencies - Map of node ID to the set of IDs it depends on (references)
+*/
+function topologicalSort(dependencies) {
+	const allNodes = new Set(dependencies.keys());
+	const inDegree = /* @__PURE__ */ new Map();
+	for (const node of allNodes) inDegree.set(node, 0);
+	for (const [_node, deps] of dependencies) for (const dep of deps) if (allNodes.has(dep)) inDegree.set(dep, (inDegree.get(dep) ?? 0) + 1);
+	const queue = [];
+	for (const [node, degree] of inDegree) if (degree === 0) queue.push(node);
+	const sorted = [];
+	while (queue.length > 0) {
+		const node = queue.shift();
+		sorted.push(node);
+		const deps = dependencies.get(node);
+		if (deps) {
+			for (const dep of deps) if (allNodes.has(dep)) {
+				const newDegree = (inDegree.get(dep) ?? 1) - 1;
+				inDegree.set(dep, newDegree);
+				if (newDegree === 0) queue.push(dep);
+			}
+		}
+	}
+	const inCycle = [];
+	for (const node of allNodes) if (!sorted.includes(node)) inCycle.push(node);
+	return {
+		sorted,
+		inCycle
+	};
+}
+
+//#endregion
+export { findReferencedIds, topologicalSort };
+//# sourceMappingURL=dependencyGraph.mjs.map

package/dist/build/dependencyGraph.mjs.map

@@ -0,0 +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"}

package/dist/build/rscPath.mjs

@@ -0,0 +1,17 @@
+import { getModulePathFor, getPayloadIDFor } from "../rsc/rscModule.mjs";
+
+//#region src/build/rscPath.ts
+/**
+* Placeholder used during SSR (will be replaced after hash is computed)
+*/
+const rscPayloadPlaceholder = "__FUNSTACK_RSC_PAYLOAD_PATH__";
+/**
+* Generate final path from content hash (reuses same folder as deferred payloads)
+*/
+function getRscPayloadPath(contentHash) {
+	return getModulePathFor(getPayloadIDFor(contentHash));
+}
+
+//#endregion
+export { getRscPayloadPath, rscPayloadPlaceholder };
+//# sourceMappingURL=rscPath.mjs.map

package/dist/build/rscPath.mjs.map

@@ -0,0 +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"}

package/dist/build/rscProcessor.mjs

@@ -0,0 +1,66 @@
+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.
+*
+* @param deferRegistryIterator - Iterator yielding components with { id, data }
+* @param appRscStream - The main RSC stream
+* @param context - Optional context for logging warnings
+*/
+async function processRscComponents(deferRegistryIterator, appRscStream, context) {
+	const components = /* @__PURE__ */ new Map();
+	for await (const { id, data } of deferRegistryIterator) components.set(id, data);
+	let appRscContent = await drainStream(appRscStream);
+	if (components.size === 0) return {
+		components: [],
+		appRscContent,
+		idMapping: /* @__PURE__ */ new Map()
+	};
+	const allIds = new Set(components.keys());
+	const dependencies = /* @__PURE__ */ new Map();
+	for (const [id, content] of components) {
+		const otherIds = new Set(allIds);
+		otherIds.delete(id);
+		const refs = findReferencedIds(content, otherIds);
+		dependencies.set(id, refs);
+	}
+	const { sorted, inCycle } = topologicalSort(dependencies);
+	const idMapping = /* @__PURE__ */ new Map();
+	if (inCycle.length > 0) {
+		context?.warn(`[funstack] Warning: ${inCycle.length} RSC component(s) are in dependency cycles and will keep unstable IDs: ${inCycle.join(", ")}`);
+		for (const id of inCycle) idMapping.set(id, id);
+	}
+	const processedComponents = [];
+	for (const tempId of sorted) {
+		let content = components.get(tempId);
+		for (const [oldId, newId] of idMapping) if (oldId !== newId) content = content.replaceAll(oldId, newId);
+		const finalId = getPayloadIDFor(await computeContentHash(content));
+		idMapping.set(tempId, finalId);
+		processedComponents.push({
+			finalId,
+			finalContent: content
+		});
+	}
+	for (const tempId of inCycle) {
+		let content = components.get(tempId);
+		for (const [oldId, newId] of idMapping) if (oldId !== newId) content = content.replaceAll(oldId, newId);
+		processedComponents.push({
+			finalId: tempId,
+			finalContent: content
+		});
+	}
+	for (const [oldId, newId] of idMapping) if (oldId !== newId) appRscContent = appRscContent.replaceAll(oldId, newId);
+	return {
+		components: processedComponents,
+		appRscContent,
+		idMapping
+	};
+}
+
+//#endregion
+export { processRscComponents };
+//# sourceMappingURL=rscProcessor.mjs.map

package/dist/build/rscProcessor.mjs.map

@@ -0,0 +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}\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}\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  for await (const { id, data } of deferRegistryIterator) {\n    components.set(id, data);\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    });\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    });\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":";;;;;;;;;;;;;AA4BA,eAAsB,qBACpB,uBACA,cACA,SACwB;CAExB,MAAM,6BAAa,IAAI,KAAqB;AAC5C,YAAW,MAAM,EAAE,IAAI,UAAU,sBAC/B,YAAW,IAAI,IAAI,KAAK;CAI1B,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;GACf,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;GACf,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/client/entry.mjs

@@ -0,0 +1,53 @@
+import { GlobalErrorBoundary } from "./error-boundary.mjs";
+import { devMainRscPath } from "../rsc/request.mjs";
+import { appClientManifestVar } from "./globals.mjs";
+import { withBasePath } from "../util/basePath.mjs";
+import { createFromFetch, createFromReadableStream } from "@vitejs/plugin-rsc/browser";
+import React, { startTransition, useEffect, useState } from "react";
+import { createRoot, hydrateRoot } from "react-dom/client";
+import { rscStream } from "rsc-html-stream/client";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/client/entry.tsx
+async function devMain() {
+	let setPayload;
+	const initialPayload = await createFromReadableStream(rscStream);
+	function BrowserRoot() {
+		const [payload, setPayload_] = useState(initialPayload);
+		useEffect(() => {
+			setPayload = (v) => startTransition(() => setPayload_(v));
+		}, [setPayload_]);
+		return payload.root;
+	}
+	async function fetchRscPayload() {
+		const payload = await createFromFetch(fetch(withBasePath(devMainRscPath)));
+		setPayload(payload);
+	}
+	const browserRoot = /* @__PURE__ */ jsx(React.StrictMode, { children: /* @__PURE__ */ jsx(GlobalErrorBoundary, { children: /* @__PURE__ */ jsx(BrowserRoot, {}) }) });
+	if (globalThis.__NO_HYDRATE) createRoot(document).render(browserRoot);
+	else hydrateRoot(document, browserRoot);
+	if (import.meta.hot) import.meta.hot.on("rsc:update", () => {
+		fetchRscPayload();
+	});
+}
+async function prodMain() {
+	const manifest = globalThis[appClientManifestVar];
+	const payload = await createFromFetch(fetch(manifest.stream));
+	function BrowserRoot() {
+		return payload.root;
+	}
+	const browserRoot = /* @__PURE__ */ jsx(BrowserRoot, {});
+	const appRootId = manifest.marker;
+	const appMarker = document.getElementById(appRootId);
+	if (!appMarker) throw new Error(`Failed to find app root element by id "${appRootId}". This is likely a bug.`);
+	const appRoot = appMarker.parentElement;
+	if (!appRoot) throw new Error(`App root element has no parent element. This is likely a bug.`);
+	appMarker.remove();
+	createRoot(appRoot).render(browserRoot);
+}
+if (import.meta.env.DEV) devMain();
+else prodMain();
+
+//#endregion
+export {  };
+//# sourceMappingURL=entry.mjs.map

package/dist/client/entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.mjs","names":[],"sources":["../../src/client/entry.tsx"],"sourcesContent":["import {\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\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  // hydration\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 {\n    hydrateRoot(document, 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  const browserRoot = <BrowserRoot />;\n  const appRootId: string = 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\nif (import.meta.env.DEV) {\n  devMain();\n} else {\n  prodMain();\n}\n"],"mappings":";;;;;;;;;;;AAaA,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;KAExC,aAAY,UAAU,YAAY;AAIpC,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;;CAEjB,MAAM,cAAc,oBAAC,gBAAc;CACnC,MAAM,YAAoB,SAAS;CAEnC,MAAM,YAAY,SAAS,eAAe,UAAU;AACpD,KAAI,CAAC,UACH,OAAM,IAAI,MACR,0CAA0C,UAAU,0BACrD;CAEH,MAAM,UAAU,UAAU;AAC1B,KAAI,CAAC,QACH,OAAM,IAAI,MACR,gEACD;AAEH,WAAU,QAAQ;AAElB,YAAW,QAAQ,CAAC,OAAO,YAAY;;AAGzC,IAAI,OAAO,KAAK,IAAI,IAClB,UAAS;IAET,WAAU"}

package/dist/client/error-boundary.mjs

@@ -0,0 +1,48 @@
+"use client";
+
+import React, { 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
+*/
+const GlobalErrorBoundary = (props) => {
+	return /* @__PURE__ */ jsx(ErrorBoundary, {
+		FallbackComponent: Fallback,
+		children: props.children
+	});
+};
+const Fallback = ({ error, resetErrorBoundary }) => {
+	const errorMessage = error instanceof Error ? error.message : String(error);
+	return /* @__PURE__ */ jsxs("html", { children: [/* @__PURE__ */ jsx("head", { children: /* @__PURE__ */ jsx("title", { children: "Unexpected Error" }) }), /* @__PURE__ */ jsxs("body", {
+		style: {
+			height: "100vh",
+			display: "flex",
+			flexDirection: "column",
+			placeContent: "center",
+			placeItems: "center",
+			fontSize: "24px",
+			fontWeight: 400,
+			lineHeight: "1.5em"
+		},
+		children: [
+			/* @__PURE__ */ jsx("h1", { children: "Caught an unexpected error" }),
+			/* @__PURE__ */ jsx("p", { children: "See the console for details." }),
+			/* @__PURE__ */ jsxs("pre", { children: ["Error: ", errorMessage] }),
+			/* @__PURE__ */ jsx("button", {
+				onClick: () => {
+					startTransition(() => {
+						resetErrorBoundary();
+					});
+				},
+				children: "Reset"
+			})
+		]
+	})] });
+};
+
+//#endregion
+export { GlobalErrorBoundary };
+//# sourceMappingURL=error-boundary.mjs.map

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

@@ -0,0 +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"}

package/dist/client/globals.mjs

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

package/dist/client/globals.mjs.map

@@ -0,0 +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"}

package/dist/entries/client.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/entries/client.mjs

@@ -0,0 +1,3 @@
+import "../client/entry.mjs";
+
+export {  };

package/dist/entries/rsc-client.d.mts

@@ -0,0 +1,3 @@
+import { ClientWrapper, RegistryContext } from "../rsc-client/clientWrapper.mjs";
+import "../rsc-client/entry.mjs";
+export { ClientWrapper, RegistryContext };

package/dist/entries/rsc-client.mjs

@@ -0,0 +1,6 @@
+"use client";
+
+import { ClientWrapper, RegistryContext } from "../rsc-client/clientWrapper.mjs";
+import "../rsc-client/entry.mjs";
+
+export { ClientWrapper, RegistryContext };

package/dist/entries/rsc.d.mts

@@ -0,0 +1,3 @@
+import { defer } from "../rsc/defer.mjs";
+import { RscPayload, build, isServeRSCError, serveHTML, serveRSC } from "../rsc/entry.mjs";
+export { RscPayload, build, defer, isServeRSCError, serveHTML, serveRSC };

package/dist/entries/rsc.mjs

@@ -0,0 +1,4 @@
+import { defer } from "../rsc/defer.mjs";
+import { build, isServeRSCError, serveHTML, serveRSC } from "../rsc/entry.mjs";
+
+export { build, defer, isServeRSCError, serveHTML, serveRSC };

package/dist/entries/server.d.mts

@@ -0,0 +1,2 @@
+import { defer } from "../rsc/defer.mjs";
+export { defer };

package/dist/entries/server.mjs

@@ -0,0 +1,3 @@
+import { defer } from "../rsc/defer.mjs";
+
+export { defer };

package/dist/entries/ssr.d.mts

@@ -0,0 +1,2 @@
+import { renderHTML } from "../ssr/entry.mjs";
+export { renderHTML };

package/dist/entries/ssr.mjs

@@ -0,0 +1,3 @@
+import { renderHTML } from "../ssr/entry.mjs";
+
+export { renderHTML };

package/dist/index.d.mts

@@ -1,30 +1,2 @@
-import { Plugin } from "vite";
-
-//#region src/index.d.ts
-interface FunstackStaticOptions {
-  /**
-   * Root component of the page.
-   * The file should `export default` a React component that renders the whole page.
-   * (`<html>...</html>`).
-   */
-  root: string;
-  /**
-   * Entry point of your application.
-   * The file should `export default` a React component that renders the application content.
-   */
-  app: string;
-  /**
-   * Output directory for build.
-   *
-   * @default dist/public
-   */
-  publicOutDir?: string;
-}
-declare function funstackStatic({
-  root,
-  app,
-  publicOutDir
-}: FunstackStaticOptions): (Plugin | Plugin[])[];
-//#endregion
-export { FunstackStaticOptions, funstackStatic as default };
-//# sourceMappingURL=index.d.mts.map
+import { FunstackStaticOptions, funstackStatic } from "./plugin/index.mjs";
+export { type FunstackStaticOptions, funstackStatic as default };