@funstack/static 0.0.2-alpha.0 → 0.0.3

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

@@ -3,10 +3,10 @@ import React from "react";
 
 //#region src/rsc-client/clientWrapper.d.ts
 declare const RegistryContext: React.Context<DeferRegistry | undefined>;
-interface ClientWrapperProps {
+interface DeferredComponentProps {
   moduleID: string;
 }
-declare const ClientWrapper: React.FC<ClientWrapperProps>;
+declare const DeferredComponent: React.FC<DeferredComponentProps>;
 //#endregion
-export { ClientWrapper, RegistryContext };
+export { DeferredComponent, RegistryContext };
 //# sourceMappingURL=clientWrapper.d.mts.map

package/dist/rsc-client/clientWrapper.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"clientWrapper.d.mts","names":[],"sources":["../../src/rsc-client/clientWrapper.tsx"],"sourcesContent":[],"mappings":";;;;cAUa,iBAAe,KAAA,CAAA,QAAA;UAIlB,kBAAA;EAJG,QAAA,EAAA,MAAA;AAEX;AAMW,cAAA,aAAwB,EAAT,KAAA,CAAM,EAAG,CAAA,kBAAD,CAAA"}
+{"version":3,"file":"clientWrapper.d.mts","names":[],"sources":["../../src/rsc-client/clientWrapper.tsx"],"mappings":";;;;cAUa,eAAA,EAAe,KAAA,CAAA,OAAA,CAAA,aAAA;AAAA,UAIlB,sBAAA;EACR,QAAA;AAAA;AAAA,cAGW,iBAAA,EAAmB,KAAA,CAAM,EAAA,CAAG,sBAAA"}

package/dist/rsc-client/clientWrapper.mjs

@@ -5,7 +5,7 @@ import React, { createContext, use } from "react";
 
 //#region src/rsc-client/clientWrapper.tsx
 const RegistryContext = createContext(void 0);
-const ClientWrapper = ({ moduleID }) => {
+const DeferredComponent = ({ moduleID }) => {
 	const registry = use(RegistryContext);
 	const modulePath = getModulePathFor(moduleID);
 	if (registry) {
@@ -40,5 +40,5 @@ function getClientRSCStream(modulePath) {
 }
 
 //#endregion
-export { ClientWrapper, RegistryContext };
+export { DeferredComponent, RegistryContext };
 //# sourceMappingURL=clientWrapper.mjs.map

package/dist/rsc-client/clientWrapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"clientWrapper.mjs","names":[],"sources":["../../src/rsc-client/clientWrapper.tsx"],"sourcesContent":["import React from \"react\";\nimport {\n  createFromFetch,\n  createFromReadableStream,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { getModulePathFor } from \"../rsc/rscModule\";\nimport { createContext, use } from \"react\";\nimport type { LoadedDeferEntry, DeferRegistry } from \"../rsc/defer\";\nimport { withBasePath } from \"../util/basePath\";\n\nexport const RegistryContext = createContext<DeferRegistry | undefined>(\n  undefined,\n);\n\ninterface ClientWrapperProps {\n  moduleID: string;\n}\n\nexport const ClientWrapper: React.FC<ClientWrapperProps> = ({ moduleID }) => {\n  const registry = use(RegistryContext);\n  const modulePath = getModulePathFor(moduleID);\n  if (registry) {\n    const entry = registry.load(moduleID);\n    if (!entry) {\n      throw new Error(`Module entry not found for ID '${moduleID}'`);\n    }\n    return getRSCStreamFromRegistry(entry);\n  }\n  const stream = getClientRSCStream(withBasePath(modulePath));\n  return use(stream);\n};\n\nconst moduleToStreamMap = new Map<string, Promise<React.ReactNode>>();\n\nasync function getRSCStreamFromRegistry(\n  entry: LoadedDeferEntry,\n): Promise<React.ReactNode> {\n  switch (entry.state.state) {\n    case \"streaming\": {\n      return createFromReadableStream<React.ReactNode>(entry.state.stream);\n    }\n    case \"ready\": {\n      const { readable, writable } = new TransformStream<\n        Uint8Array,\n        Uint8Array\n      >();\n      const writer = writable.getWriter();\n      const encoder = new TextEncoder();\n      await writer.write(encoder.encode(entry.state.data));\n      await writer.close();\n      return createFromReadableStream<React.ReactNode>(readable);\n    }\n    case \"error\": {\n      return Promise.reject(entry.state.error);\n    }\n  }\n}\n\nfunction getClientRSCStream(modulePath: string) {\n  let stream = moduleToStreamMap.get(modulePath);\n  if (!stream) {\n    stream = createFromFetch<React.ReactNode>(fetch(modulePath));\n    moduleToStreamMap.set(modulePath, stream);\n  }\n  return stream;\n}\n"],"mappings":";;;;;;AAUA,MAAa,kBAAkB,cAC7B,OACD;AAMD,MAAa,iBAA+C,EAAE,eAAe;CAC3E,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,aAAa,iBAAiB,SAAS;AAC7C,KAAI,UAAU;EACZ,MAAM,QAAQ,SAAS,KAAK,SAAS;AACrC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,kCAAkC,SAAS,GAAG;AAEhE,SAAO,yBAAyB,MAAM;;AAGxC,QAAO,IADQ,mBAAmB,aAAa,WAAW,CAAC,CACzC;;AAGpB,MAAM,oCAAoB,IAAI,KAAuC;AAErE,eAAe,yBACb,OAC0B;AAC1B,SAAQ,MAAM,MAAM,OAApB;EACE,KAAK,YACH,QAAO,yBAA0C,MAAM,MAAM,OAAO;EAEtE,KAAK,SAAS;GACZ,MAAM,EAAE,UAAU,aAAa,IAAI,iBAGhC;GACH,MAAM,SAAS,SAAS,WAAW;GACnC,MAAM,UAAU,IAAI,aAAa;AACjC,SAAM,OAAO,MAAM,QAAQ,OAAO,MAAM,MAAM,KAAK,CAAC;AACpD,SAAM,OAAO,OAAO;AACpB,UAAO,yBAA0C,SAAS;;EAE5D,KAAK,QACH,QAAO,QAAQ,OAAO,MAAM,MAAM,MAAM;;;AAK9C,SAAS,mBAAmB,YAAoB;CAC9C,IAAI,SAAS,kBAAkB,IAAI,WAAW;AAC9C,KAAI,CAAC,QAAQ;AACX,WAAS,gBAAiC,MAAM,WAAW,CAAC;AAC5D,oBAAkB,IAAI,YAAY,OAAO;;AAE3C,QAAO"}
+{"version":3,"file":"clientWrapper.mjs","names":[],"sources":["../../src/rsc-client/clientWrapper.tsx"],"sourcesContent":["import React from \"react\";\nimport {\n  createFromFetch,\n  createFromReadableStream,\n} from \"@vitejs/plugin-rsc/browser\";\nimport { getModulePathFor } from \"../rsc/rscModule\";\nimport { createContext, use } from \"react\";\nimport type { LoadedDeferEntry, DeferRegistry } from \"../rsc/defer\";\nimport { withBasePath } from \"../util/basePath\";\n\nexport const RegistryContext = createContext<DeferRegistry | undefined>(\n  undefined,\n);\n\ninterface DeferredComponentProps {\n  moduleID: string;\n}\n\nexport const DeferredComponent: React.FC<DeferredComponentProps> = ({\n  moduleID,\n}) => {\n  const registry = use(RegistryContext);\n  const modulePath = getModulePathFor(moduleID);\n  if (registry) {\n    const entry = registry.load(moduleID);\n    if (!entry) {\n      throw new Error(`Module entry not found for ID '${moduleID}'`);\n    }\n    return getRSCStreamFromRegistry(entry);\n  }\n  const stream = getClientRSCStream(withBasePath(modulePath));\n  return use(stream);\n};\n\nconst moduleToStreamMap = new Map<string, Promise<React.ReactNode>>();\n\nasync function getRSCStreamFromRegistry(\n  entry: LoadedDeferEntry,\n): Promise<React.ReactNode> {\n  switch (entry.state.state) {\n    case \"streaming\": {\n      return createFromReadableStream<React.ReactNode>(entry.state.stream);\n    }\n    case \"ready\": {\n      const { readable, writable } = new TransformStream<\n        Uint8Array,\n        Uint8Array\n      >();\n      const writer = writable.getWriter();\n      const encoder = new TextEncoder();\n      await writer.write(encoder.encode(entry.state.data));\n      await writer.close();\n      return createFromReadableStream<React.ReactNode>(readable);\n    }\n    case \"error\": {\n      return Promise.reject(entry.state.error);\n    }\n  }\n}\n\nfunction getClientRSCStream(modulePath: string) {\n  let stream = moduleToStreamMap.get(modulePath);\n  if (!stream) {\n    stream = createFromFetch<React.ReactNode>(fetch(modulePath));\n    moduleToStreamMap.set(modulePath, stream);\n  }\n  return stream;\n}\n"],"mappings":";;;;;;AAUA,MAAa,kBAAkB,cAC7B,OACD;AAMD,MAAa,qBAAuD,EAClE,eACI;CACJ,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,aAAa,iBAAiB,SAAS;AAC7C,KAAI,UAAU;EACZ,MAAM,QAAQ,SAAS,KAAK,SAAS;AACrC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,kCAAkC,SAAS,GAAG;AAEhE,SAAO,yBAAyB,MAAM;;AAGxC,QAAO,IADQ,mBAAmB,aAAa,WAAW,CAAC,CACzC;;AAGpB,MAAM,oCAAoB,IAAI,KAAuC;AAErE,eAAe,yBACb,OAC0B;AAC1B,SAAQ,MAAM,MAAM,OAApB;EACE,KAAK,YACH,QAAO,yBAA0C,MAAM,MAAM,OAAO;EAEtE,KAAK,SAAS;GACZ,MAAM,EAAE,UAAU,aAAa,IAAI,iBAGhC;GACH,MAAM,SAAS,SAAS,WAAW;GACnC,MAAM,UAAU,IAAI,aAAa;AACjC,SAAM,OAAO,MAAM,QAAQ,OAAO,MAAM,MAAM,KAAK,CAAC;AACpD,SAAM,OAAO,OAAO;AACpB,UAAO,yBAA0C,SAAS;;EAE5D,KAAK,QACH,QAAO,QAAQ,OAAO,MAAM,MAAM,MAAM;;;AAK9C,SAAS,mBAAmB,YAAoB;CAC9C,IAAI,SAAS,kBAAkB,IAAI,WAAW;AAC9C,KAAI,CAAC,QAAQ;AACX,WAAS,gBAAiC,MAAM,WAAW,CAAC;AAC5D,oBAAkB,IAAI,YAAY,OAAO;;AAE3C,QAAO"}

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

@@ -1 +1 @@
-import { ClientWrapper, RegistryContext } from "./clientWrapper.mjs";
+import { DeferredComponent, RegistryContext } from "./clientWrapper.mjs";

package/dist/rsc-client/entry.mjs

@@ -1,5 +1,5 @@
 "use client";
 
-import { ClientWrapper, RegistryContext } from "./clientWrapper.mjs";
+import { DeferredComponent, RegistryContext } from "./clientWrapper.mjs";
 
 export {  };

package/dist/ssr/entry.d.mts

@@ -4,8 +4,10 @@ import { DeferRegistry } from "../rsc/defer.mjs";
 declare function renderHTML(rscStream: ReadableStream<Uint8Array>, options: {
   appEntryMarker: string;
   build: boolean;
+  ssr?: boolean;
   nonce?: string;
   deferRegistry?: DeferRegistry;
+  clientRscStream?: ReadableStream<Uint8Array>;
 }): Promise<{
   stream: ReadableStream<Uint8Array>;
   status?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/ssr/entry.tsx"],"sourcesContent":[],"mappings":";;;iBAWsB,UAAA,YACT,eAAe;;EADN,KAAA,EAAA,OAAU;EACJ,KAAA,CAAA,EAAA,MAAA;EAAf,aAAA,CAAA,EAKO,aALP;CAKO,CAAA,EAEjB,OAFiB,CAAA;EAEgB,MAAA,EAAf,cAAe,CAAA,UAAA,CAAA;EAAf,MAAA,CAAA,EAAA,MAAA;CAAlB,CAAA"}
+{"version":3,"file":"entry.d.mts","names":[],"sources":["../../src/ssr/entry.tsx"],"mappings":";;;iBAWsB,UAAA,CACpB,SAAA,EAAW,cAAA,CAAe,UAAA,GAC1B,OAAA;EACE,cAAA;EACA,KAAA;EACA,GAAA;EACA,KAAA;EACA,aAAA,GAAgB,aAAA;EAChB,eAAA,GAAkB,cAAA,CAAe,UAAA;AAAA,IAElC,OAAA;EAAU,MAAA,EAAQ,cAAA,CAAe,UAAA;EAAa,MAAA;AAAA"}

package/dist/ssr/entry.mjs

@@ -24,7 +24,8 @@ async function renderHTML(rscStream, options) {
 		});
 	}
 	let bootstrapScriptContent = "";
-	if (options.build) bootstrapScriptContent += `globalThis.${appClientManifestVar}={marker:"${options.appEntryMarker}",stream:"${rscPayloadPlaceholder}"};\n`;
+	if (options.build) if (options.ssr) bootstrapScriptContent += `globalThis.${appClientManifestVar}={stream:"${rscPayloadPlaceholder}"};\n`;
+	else bootstrapScriptContent += `globalThis.${appClientManifestVar}={marker:"${options.appEntryMarker}",stream:"${rscPayloadPlaceholder}"};\n`;
 	bootstrapScriptContent += await import.meta.viteRsc.loadBootstrapScriptContent("index");
 	let htmlStream;
 	let status;
@@ -41,7 +42,10 @@ async function renderHTML(rscStream, options) {
 		});
 	}
 	let responseStream = htmlStream;
-	if (!options.build) responseStream = responseStream.pipeThrough(injectRSCPayload(rscStream2, { nonce: options?.nonce }));
+	if (!options.build) {
+		const streamToInject = options.clientRscStream ?? rscStream2;
+		responseStream = responseStream.pipeThrough(injectRSCPayload(streamToInject, { nonce: options?.nonce }));
+	}
 	return {
 		stream: responseStream,
 		status

package/dist/ssr/entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.mjs","names":[],"sources":["../../src/ssr/entry.tsx"],"sourcesContent":["import { createFromReadableStream } from \"@vitejs/plugin-rsc/ssr\";\nimport { use } from \"react\";\nimport { renderToReadableStream } from \"react-dom/server.edge\";\nimport { injectRSCPayload } from \"rsc-html-stream/server\";\nimport type { RscPayload } from \"../rsc/entry\";\nimport { appClientManifestVar } from \"../client/globals\";\nimport { rscPayloadPlaceholder } from \"../build/rscPath\";\nimport { preload } from \"react-dom\";\nimport type { DeferRegistry } from \"../rsc/defer\";\nimport { RegistryContext } from \"#rsc-client\";\n\nexport async function renderHTML(\n  rscStream: ReadableStream<Uint8Array>,\n  options: {\n    appEntryMarker: string;\n    build: boolean;\n    nonce?: string;\n    deferRegistry?: DeferRegistry;\n  },\n): Promise<{ stream: ReadableStream<Uint8Array>; status?: number }> {\n  const [rscStream1, rscStream2] = rscStream.tee();\n\n  let payload: Promise<RscPayload> | undefined;\n  function SsrRoot() {\n    // Tip: calling `createFromReadableStream` inside a component\n    // makes `preinit`/`preload` work properly.\n    payload ??= createFromReadableStream<RscPayload>(rscStream1);\n    if (options.build) {\n      preload(rscPayloadPlaceholder, {\n        crossOrigin: \"anonymous\",\n        as: \"fetch\",\n      });\n    }\n    return (\n      <RegistryContext value={options.deferRegistry}>\n        {use(payload).root}\n      </RegistryContext>\n    );\n  }\n\n  let bootstrapScriptContent: string = \"\";\n  if (options.build) {\n    bootstrapScriptContent += `globalThis.${appClientManifestVar}={marker:\"${options.appEntryMarker}\",stream:\"${rscPayloadPlaceholder}\"};\\n`;\n  }\n  bootstrapScriptContent +=\n    await import.meta.viteRsc.loadBootstrapScriptContent(\"index\");\n\n  let htmlStream: ReadableStream<Uint8Array>;\n  let status: number | undefined;\n  try {\n    htmlStream = await renderToReadableStream(<SsrRoot />, {\n      bootstrapScriptContent,\n      nonce: options?.nonce,\n    });\n  } catch (e) {\n    // In this case, RSC payload is still sent to client and we let client render from scratch anyway.\n    // This triggers the error boundary on client side.\n    status = 500;\n    htmlStream = await renderToReadableStream(\n      <html>\n        <body>\n          <noscript>Internal Server Error: SSR failed</noscript>\n        </body>\n      </html>,\n      {\n        bootstrapScriptContent:\n          `globalThis.__NO_HYDRATE=1;` + bootstrapScriptContent,\n        nonce: options?.nonce,\n      },\n    );\n  }\n\n  let responseStream = htmlStream;\n\n  if (!options.build) {\n    responseStream = responseStream.pipeThrough(\n      injectRSCPayload(rscStream2, {\n        nonce: options?.nonce,\n      }),\n    );\n  }\n\n  return { stream: responseStream, status };\n}\n"],"mappings":";;;;;;;;;;;AAWA,eAAsB,WACpB,WACA,SAMkE;CAClE,MAAM,CAAC,YAAY,cAAc,UAAU,KAAK;CAEhD,IAAI;CACJ,SAAS,UAAU;AAGjB,cAAY,yBAAqC,WAAW;AAC5D,MAAI,QAAQ,MACV,SAAQ,uBAAuB;GAC7B,aAAa;GACb,IAAI;GACL,CAAC;AAEJ,SACE,oBAAC;GAAgB,OAAO,QAAQ;aAC7B,IAAI,QAAQ,CAAC;IACE;;CAItB,IAAI,yBAAiC;AACrC,KAAI,QAAQ,MACV,2BAA0B,cAAc,qBAAqB,YAAY,QAAQ,eAAe,YAAY,sBAAsB;AAEpI,2BACE,MAAM,OAAO,KAAK,QAAQ,2BAA2B,QAAQ;CAE/D,IAAI;CACJ,IAAI;AACJ,KAAI;AACF,eAAa,MAAM,uBAAuB,oBAAC,YAAU,EAAE;GACrD;GACA,OAAO,SAAS;GACjB,CAAC;UACK,GAAG;AAGV,WAAS;AACT,eAAa,MAAM,uBACjB,oBAAC,oBACC,oBAAC,oBACC,oBAAC,wBAAS,sCAA4C,GACjD,GACF,EACP;GACE,wBACE,+BAA+B;GACjC,OAAO,SAAS;GACjB,CACF;;CAGH,IAAI,iBAAiB;AAErB,KAAI,CAAC,QAAQ,MACX,kBAAiB,eAAe,YAC9B,iBAAiB,YAAY,EAC3B,OAAO,SAAS,OACjB,CAAC,CACH;AAGH,QAAO;EAAE,QAAQ;EAAgB;EAAQ"}
+{"version":3,"file":"entry.mjs","names":[],"sources":["../../src/ssr/entry.tsx"],"sourcesContent":["import { createFromReadableStream } from \"@vitejs/plugin-rsc/ssr\";\nimport { use } from \"react\";\nimport { renderToReadableStream } from \"react-dom/server.edge\";\nimport { injectRSCPayload } from \"rsc-html-stream/server\";\nimport type { RscPayload } from \"../rsc/entry\";\nimport { appClientManifestVar } from \"../client/globals\";\nimport { rscPayloadPlaceholder } from \"../build/rscPath\";\nimport { preload } from \"react-dom\";\nimport type { DeferRegistry } from \"../rsc/defer\";\nimport { RegistryContext } from \"#rsc-client\";\n\nexport async function renderHTML(\n  rscStream: ReadableStream<Uint8Array>,\n  options: {\n    appEntryMarker: string;\n    build: boolean;\n    ssr?: boolean;\n    nonce?: string;\n    deferRegistry?: DeferRegistry;\n    clientRscStream?: ReadableStream<Uint8Array>;\n  },\n): Promise<{ stream: ReadableStream<Uint8Array>; status?: number }> {\n  const [rscStream1, rscStream2] = rscStream.tee();\n\n  let payload: Promise<RscPayload> | undefined;\n  function SsrRoot() {\n    // Tip: calling `createFromReadableStream` inside a component\n    // makes `preinit`/`preload` work properly.\n    payload ??= createFromReadableStream<RscPayload>(rscStream1);\n    if (options.build) {\n      preload(rscPayloadPlaceholder, {\n        crossOrigin: \"anonymous\",\n        as: \"fetch\",\n      });\n    }\n    return (\n      <RegistryContext value={options.deferRegistry}>\n        {use(payload).root}\n      </RegistryContext>\n    );\n  }\n\n  let bootstrapScriptContent: string = \"\";\n  if (options.build) {\n    if (options.ssr) {\n      // SSR on: no marker needed, client hydrates full document\n      bootstrapScriptContent += `globalThis.${appClientManifestVar}={stream:\"${rscPayloadPlaceholder}\"};\\n`;\n    } else {\n      // SSR off: marker needed for client to find mount point\n      bootstrapScriptContent += `globalThis.${appClientManifestVar}={marker:\"${options.appEntryMarker}\",stream:\"${rscPayloadPlaceholder}\"};\\n`;\n    }\n  }\n  bootstrapScriptContent +=\n    await import.meta.viteRsc.loadBootstrapScriptContent(\"index\");\n\n  let htmlStream: ReadableStream<Uint8Array>;\n  let status: number | undefined;\n  try {\n    htmlStream = await renderToReadableStream(<SsrRoot />, {\n      bootstrapScriptContent,\n      nonce: options?.nonce,\n    });\n  } catch (e) {\n    // In this case, RSC payload is still sent to client and we let client render from scratch anyway.\n    // This triggers the error boundary on client side.\n    status = 500;\n    htmlStream = await renderToReadableStream(\n      <html>\n        <body>\n          <noscript>Internal Server Error: SSR failed</noscript>\n        </body>\n      </html>,\n      {\n        bootstrapScriptContent:\n          `globalThis.__NO_HYDRATE=1;` + bootstrapScriptContent,\n        nonce: options?.nonce,\n      },\n    );\n  }\n\n  let responseStream = htmlStream;\n\n  // Inject RSC payload into HTML for client consumption.\n  // In dev: always inject (client reads from inline stream).\n  // In build+SSR: skip (HTML already has full content, client hydrates directly).\n  // In build+no-SSR: skip (client fetches RSC from separate file).\n  if (!options.build) {\n    const streamToInject = options.clientRscStream ?? rscStream2;\n    responseStream = responseStream.pipeThrough(\n      injectRSCPayload(streamToInject, {\n        nonce: options?.nonce,\n      }),\n    );\n  }\n\n  return { stream: responseStream, status };\n}\n"],"mappings":";;;;;;;;;;;AAWA,eAAsB,WACpB,WACA,SAQkE;CAClE,MAAM,CAAC,YAAY,cAAc,UAAU,KAAK;CAEhD,IAAI;CACJ,SAAS,UAAU;AAGjB,cAAY,yBAAqC,WAAW;AAC5D,MAAI,QAAQ,MACV,SAAQ,uBAAuB;GAC7B,aAAa;GACb,IAAI;GACL,CAAC;AAEJ,SACE,oBAAC;GAAgB,OAAO,QAAQ;aAC7B,IAAI,QAAQ,CAAC;IACE;;CAItB,IAAI,yBAAiC;AACrC,KAAI,QAAQ,MACV,KAAI,QAAQ,IAEV,2BAA0B,cAAc,qBAAqB,YAAY,sBAAsB;KAG/F,2BAA0B,cAAc,qBAAqB,YAAY,QAAQ,eAAe,YAAY,sBAAsB;AAGtI,2BACE,MAAM,OAAO,KAAK,QAAQ,2BAA2B,QAAQ;CAE/D,IAAI;CACJ,IAAI;AACJ,KAAI;AACF,eAAa,MAAM,uBAAuB,oBAAC,YAAU,EAAE;GACrD;GACA,OAAO,SAAS;GACjB,CAAC;UACK,GAAG;AAGV,WAAS;AACT,eAAa,MAAM,uBACjB,oBAAC,oBACC,oBAAC,oBACC,oBAAC,wBAAS,sCAA4C,GACjD,GACF,EACP;GACE,wBACE,+BAA+B;GACjC,OAAO,SAAS;GACjB,CACF;;CAGH,IAAI,iBAAiB;AAMrB,KAAI,CAAC,QAAQ,OAAO;EAClB,MAAM,iBAAiB,QAAQ,mBAAmB;AAClD,mBAAiB,eAAe,YAC9B,iBAAiB,gBAAgB,EAC/B,OAAO,SAAS,OACjB,CAAC,CACH;;AAGH,QAAO;EAAE,QAAQ;EAAgB;EAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funstack/static",
-  "version": "0.0.2-alpha.0",
+  "version": "0.0.3",
   "description": "FUNSTACK static library",
   "type": "module",
   "repository": {
@@ -8,6 +8,16 @@
     "url": "git+https://github.com/uhyo/funstack-static.git",
     "directory": "packages/static"
   },
+  "keywords": [
+    "vite-plugin",
+    "react",
+    "framework",
+    "react-server-components",
+    "rsc"
+  ],
+  "bin": {
+    "funstack-static-skill-installer": "./dist/bin/skill-installer.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
@@ -26,27 +36,30 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "author": "uhyo <uhyo@uhy.ooo>",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^25.0.9",
-    "@types/react": "^19.2.8",
+    "@playwright/test": "^1.58.1",
+    "@types/node": "^25.1.0",
+    "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
-    "jsdom": "^27.3.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "tsdown": "^0.19.0",
+    "jsdom": "^27.4.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tsdown": "^0.20.1",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@vitejs/plugin-rsc": "^0.5.14",
+    "@funstack/skill-installer": "^1.0.0",
+    "@vitejs/plugin-rsc": "^0.5.17",
     "react-error-boundary": "^6.1.0",
     "rsc-html-stream": "^0.0.7",
-    "srvx": "^0.10.0"
+    "srvx": "^0.10.1"
   },
   "peerDependencies": {
     "react": "^19.2.3",
@@ -55,9 +68,11 @@
   },
   "scripts": {
     "build": "tsdown",
+    "build:docs": "node --experimental-strip-types scripts/generate-ai-docs.ts",
     "dev": "tsdown --watch",
     "test": "vitest",
     "test:run": "vitest run",
+    "test:e2e": "playwright test --config e2e/playwright.config.ts",
     "typecheck": "tsc --noEmit"
   }
 }

package/skills/funstack-static-knowledge/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: funstack-static-knowledge
+description: Use this skill when you need information about `@funstack/static` (the React framework your app is built with). What it is even about, API references, best practices, etc.
+---
+
+# FUNSTACK Static Knowledge
+
+**FUNSTACK Static** (`@funstack/static`) is a React framework designed to build SPA application that can be deployed as static files to any static hosting service. Its prominent features is support for React Server Components (RSC) which allows optimizing the performance of the application by rendering parts of the UI at build time.
+
+Note that FUNSTACK Static never runs on the server at runtime (except during development). Server Components are rendered at build time into RSC payloads which are then shipped to the client. The client React runtime can then seamlessly render both Client and Server Components into the DOM.
+
+## FUNSTACK Static Entrypoint
+
+FUNSTACk Static is served as a Vite plugin. See your app's `vite.config.ts` file for the current configuration. A typical configuration looks like this:
+
+```ts
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { funstackStatic } from "@funstack/static";
+
+export default defineConfig({
+  plugins: [
+    react(),
+    funstackStatic({
+      root: "./src/Root.tsx",
+      app: "./src/App.tsx",
+    }),
+  ],
+});
+```
+
+**Entrypoint.** Here, the `root` option points to the Root component of your application which is responsible for the HTML shell of your application. The `app` option points to the main App component which is the entrypoint for your application's UI.
+
+**Server and Client Components.** The entrypoint components (Root and App) are **server components**. FUNSTACK Static follows React's conventions for Server and Client Components; the entrypoint is executed as a Server module. Modules marked with the `"use client"` directive are executed as Client modules. Server modules can import both Server and Client modules, while Client modules can only import other Client modules.
+
+**Server Actions.** Note that Server Actions (`"use server"`) are **NOT** supported in FUNSTACK Static, as there is no server runtime deployed.
+
+## FUNSTACK Static Docs
+
+More detailed documentation about FUNSTACK Static (including API references and best practices) can be found inside `node_modules` at:
+
+```
+node_modules/@funstack/static/dist/docs/index.md
+```