@wular/pnext 0.1.7 → 0.1.9

package/dist/server/compat/next/dist/server/web/spec-extension/unstable-cache.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   unstable_cache
-} from "../../../../../../_chunks/index-tq0pc7eg.js";
-import"../../../../../../_chunks/index-9hx2641q.js";
-import"../../../../../../_chunks/index-eajaspjk.js";
-import"../../../../../../_chunks/index-9n2914ww.js";
+} from "../../../../../../_chunks/index-zfrwq472.js";
+import"../../../../../../_chunks/index-entm8bmz.js";
+import"../../../../../../_chunks/index-j0m1jxqa.js";
+import"../../../../../../_chunks/index-akkrvjn6.js";
 import"../../../../../../_chunks/index-bcws5eh2.js";
-import"../../../../../../_chunks/index-6e4fqv30.js";
+import"../../../../../../_chunks/index-m63czgq5.js";
 import"../../../../../../_chunks/index-cjgqs13g.js";
 import"../../../../../../_chunks/index-jks0x0a1.js";
 import"../../../../../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/dist/server/web/spec-extension/unstable-no-store.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   unstable_noStore
-} from "../../../../../../_chunks/index-tq0pc7eg.js";
-import"../../../../../../_chunks/index-9hx2641q.js";
-import"../../../../../../_chunks/index-eajaspjk.js";
-import"../../../../../../_chunks/index-9n2914ww.js";
+} from "../../../../../../_chunks/index-zfrwq472.js";
+import"../../../../../../_chunks/index-entm8bmz.js";
+import"../../../../../../_chunks/index-j0m1jxqa.js";
+import"../../../../../../_chunks/index-akkrvjn6.js";
 import"../../../../../../_chunks/index-bcws5eh2.js";
-import"../../../../../../_chunks/index-6e4fqv30.js";
+import"../../../../../../_chunks/index-m63czgq5.js";
 import"../../../../../../_chunks/index-cjgqs13g.js";
 import"../../../../../../_chunks/index-jks0x0a1.js";
 import"../../../../../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/dynamic.js

@@ -3,29 +3,18 @@ import"../../_chunks/index-rt9qq1va.js";
 
 // src/compat/next/dynamic.tsx
 import { h } from "preact";
-import { lazy, Suspense } from "preact/compat";
 import {
   dynamic as pnextDynamic,
   dynamicReferenceSymbol
 } from "../../../../src/api/dynamic.tsx";
 function dynamic(loader, options = {}, target) {
-  if (typeof loader === "string")
-    return pnextDynamic(loader, options, target);
   const coreDynamic = pnextDynamic(loader, options, target);
-  const Lazy = lazy(() => loader().then((module) => ({ default: componentFromModule(module) })));
-  const DynamicComponent = (props) => {
-    const Loading = options.loading;
-    if (options.ssr === false) {
-      return h("pnext-dynamic", { style: { display: "contents" } }, typeof window === "undefined" ? null : h(coreDynamic, props));
-    }
-    return h(Suspense, { fallback: Loading ? h(Loading, props) : null }, h(Lazy, props));
-  };
+  if (typeof loader === "string" || options.ssr !== false)
+    return coreDynamic;
+  const DynamicComponent = (props) => h("pnext-dynamic", { style: { display: "contents" } }, typeof window === "undefined" ? null : h(coreDynamic, props));
   DynamicComponent[dynamicReferenceSymbol] = coreDynamic[dynamicReferenceSymbol];
   return DynamicComponent;
 }
-function componentFromModule(module) {
-  return typeof module === "function" ? module : module.default;
-}
 export {
   dynamic as default,
   dynamic

package/dist/server/compat/next/font/cache.js

@@ -2,11 +2,13 @@
 import {
   persistFont,
   persistedFont
-} from "../../../_chunks/index-3b3at80h.js";
+} from "../../../_chunks/index-s61bx2aj.js";
 import"../../../_chunks/index-knp0s912.js";
-import"../../../_chunks/index-c0g2wf3z.js";
-import"../../../_chunks/index-20ppawv7.js";
-import"../../../_chunks/index-tqn2qnnn.js";
+import"../../../_chunks/index-md5jchzy.js";
+import"../../../_chunks/index-4qsce64w.js";
+import"../../../_chunks/index-bzd2ef7t.js";
+import"../../../_chunks/index-fpghsgb4.js";
+import"../../../_chunks/index-jt8e1pje.js";
 import"../../../_chunks/index-rt9qq1va.js";
 export {
   persistFont,

package/dist/server/compat/next/font/local.js

@@ -1,16 +1,18 @@
 // @bun
 import {
   localFont
-} from "../../../_chunks/index-ytjvpbm2.js";
-import"../../../_chunks/index-3b3at80h.js";
+} from "../../../_chunks/index-26gwrm07.js";
+import"../../../_chunks/index-s61bx2aj.js";
 import"../../../_chunks/index-knp0s912.js";
-import"../../../_chunks/index-c0g2wf3z.js";
+import"../../../_chunks/index-md5jchzy.js";
 import"../../../_chunks/index-fn1chkkd.js";
-import"../../../_chunks/index-20ppawv7.js";
-import"../../../_chunks/index-tqn2qnnn.js";
+import"../../../_chunks/index-4qsce64w.js";
+import"../../../_chunks/index-bzd2ef7t.js";
+import"../../../_chunks/index-fpghsgb4.js";
 import"../../../_chunks/index-grta8ap3.js";
 import"../../../_chunks/index-kresp2n8.js";
 import"../../../_chunks/index-e3a6yx84.js";
+import"../../../_chunks/index-jt8e1pje.js";
 import"../../../_chunks/index-zqpqyg8p.js";
 import"../../../_chunks/index-qjj6gddn.js";
 import"../../../_chunks/index-rt9qq1va.js";

package/dist/server/compat/next/font/runtime.js

@@ -12,16 +12,18 @@ import {
   releaseFonts,
   runWithFontScope,
   takeFontHeaderPreloads
-} from "../../../_chunks/index-ytjvpbm2.js";
-import"../../../_chunks/index-3b3at80h.js";
+} from "../../../_chunks/index-26gwrm07.js";
+import"../../../_chunks/index-s61bx2aj.js";
 import"../../../_chunks/index-knp0s912.js";
-import"../../../_chunks/index-c0g2wf3z.js";
+import"../../../_chunks/index-md5jchzy.js";
 import"../../../_chunks/index-fn1chkkd.js";
-import"../../../_chunks/index-20ppawv7.js";
-import"../../../_chunks/index-tqn2qnnn.js";
+import"../../../_chunks/index-4qsce64w.js";
+import"../../../_chunks/index-bzd2ef7t.js";
+import"../../../_chunks/index-fpghsgb4.js";
 import"../../../_chunks/index-grta8ap3.js";
 import"../../../_chunks/index-kresp2n8.js";
 import"../../../_chunks/index-e3a6yx84.js";
+import"../../../_chunks/index-jt8e1pje.js";
 import"../../../_chunks/index-zqpqyg8p.js";
 import"../../../_chunks/index-qjj6gddn.js";
 import"../../../_chunks/index-rt9qq1va.js";

package/dist/server/compat/next/headers.js

@@ -4,12 +4,12 @@ import {
   cookies,
   draftMode,
   headers
-} from "../../_chunks/index-sctcgyvv.js";
+} from "../../_chunks/index-drwv61cc.js";
 import"../../_chunks/index-2vz0wzdn.js";
-import"../../_chunks/index-0374j2b9.js";
-import"../../_chunks/index-9n2914ww.js";
+import"../../_chunks/index-y4d02znn.js";
+import"../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/image/config.js

@@ -1,8 +1,8 @@
 // @bun
 import {
   getImagesConfig
-} from "../../../_chunks/index-357na4a8.js";
-import"../../../_chunks/index-6e4fqv30.js";
+} from "../../../_chunks/index-141vcwk6.js";
+import"../../../_chunks/index-m63czgq5.js";
 import"../../../_chunks/index-cjgqs13g.js";
 import"../../../_chunks/index-jks0x0a1.js";
 import"../../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/image/optimizer.js

@@ -3,11 +3,11 @@ import {
   generateBlurDataURL,
   isImageOptimizerRequest,
   serveImageOptimizer
-} from "../../../_chunks/index-qn4z5s3c.js";
+} from "../../../_chunks/index-typcbcsv.js";
 import"../../../_chunks/index-tgsfjmep.js";
-import"../../../_chunks/index-357na4a8.js";
+import"../../../_chunks/index-141vcwk6.js";
 import"../../../_chunks/index-bcws5eh2.js";
-import"../../../_chunks/index-6e4fqv30.js";
+import"../../../_chunks/index-m63czgq5.js";
 import"../../../_chunks/index-cjgqs13g.js";
 import"../../../_chunks/index-jks0x0a1.js";
 import"../../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/image/static-metadata.js

@@ -6,12 +6,12 @@ import {
   staticImageModule,
   staticImageModuleText,
   staticMediaRelative
-} from "../../../_chunks/index-06nyqntx.js";
-import"../../../_chunks/index-qn4z5s3c.js";
+} from "../../../_chunks/index-q3r9z8mq.js";
+import"../../../_chunks/index-typcbcsv.js";
 import"../../../_chunks/index-tgsfjmep.js";
-import"../../../_chunks/index-357na4a8.js";
+import"../../../_chunks/index-141vcwk6.js";
 import"../../../_chunks/index-bcws5eh2.js";
-import"../../../_chunks/index-6e4fqv30.js";
+import"../../../_chunks/index-m63czgq5.js";
 import"../../../_chunks/index-cjgqs13g.js";
 import"../../../_chunks/index-jks0x0a1.js";
 import"../../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/legacy-request-apis.js

@@ -2,10 +2,10 @@
 import {
   withSyncAccess,
   withSyncProps
-} from "../../_chunks/index-0374j2b9.js";
-import"../../_chunks/index-9n2914ww.js";
+} from "../../_chunks/index-y4d02znn.js";
+import"../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/link-transform.js

@@ -1,11 +1,12 @@
 // @bun
 import {
   rewriteLegacyLinkValidation
-} from "../../_chunks/index-11sfk4hb.js";
-import"../../_chunks/index-z4z9zv3b.js";
-import"../../_chunks/index-yz54pxrh.js";
+} from "../../_chunks/index-vmr35jjw.js";
+import"../../_chunks/index-x9c55pzy.js";
+import"../../_chunks/index-d1jsmhhk.js";
 import"../../_chunks/index-7wc9n8be.js";
 import"../../_chunks/index-pym1cezq.js";
+import"../../_chunks/index-jt8e1pje.js";
 import"../../_chunks/index-zqpqyg8p.js";
 import"../../_chunks/index-qjj6gddn.js";
 import"../../_chunks/index-rt9qq1va.js";

package/dist/server/compat/next/navigation.js

@@ -3,10 +3,10 @@ import {
   currentLayoutSegments,
   currentParamsSnapshot,
   hasLayoutSegmentScope
-} from "../../_chunks/index-fkp000p1.js";
-import"../../_chunks/index-p77b4kcx.js";
-import"../../_chunks/index-20ppawv7.js";
-import"../../_chunks/index-tqn2qnnn.js";
+} from "../../_chunks/index-jjppzw0s.js";
+import"../../_chunks/index-veycp46e.js";
+import"../../_chunks/index-4qsce64w.js";
+import"../../_chunks/index-fpghsgb4.js";
 import {
   canonicalUrlHref
 } from "../../_chunks/index-en7n9f7m.js";
@@ -19,6 +19,7 @@ import {
   PostponeError,
   isPostpone
 } from "../../_chunks/index-e3a6yx84.js";
+import"../../_chunks/index-jt8e1pje.js";
 import"../../_chunks/index-zqpqyg8p.js";
 import"../../_chunks/index-qjj6gddn.js";
 import {

package/dist/server/compat/next/redirects.js

@@ -2,26 +2,28 @@
 import {
   loadCompatRedirects,
   resolveCompatRedirect
-} from "../../_chunks/index-hkdfj58q.js";
-import"../../_chunks/index-z84ab1w0.js";
+} from "../../_chunks/index-y9bygr95.js";
+import"../../_chunks/index-e176wk6x.js";
 import"../../_chunks/index-6q7zvrap.js";
 import"../../_chunks/index-79ngvam8.js";
-import"../../_chunks/index-9n2914ww.js";
+import"../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";
 import"../../_chunks/index-4zzebszd.js";
 import"../../_chunks/index-sq3kvz3g.js";
 import"../../_chunks/index-ckkdpht5.js";
-import"../../_chunks/index-x93hv0sc.js";
-import"../../_chunks/index-tqn2qnnn.js";
+import"../../_chunks/index-zedjt25v.js";
+import"../../_chunks/index-bzd2ef7t.js";
+import"../../_chunks/index-fpghsgb4.js";
 import"../../_chunks/index-grta8ap3.js";
 import"../../_chunks/index-kresp2n8.js";
 import"../../_chunks/index-e3a6yx84.js";
 import"../../_chunks/index-7wc9n8be.js";
 import"../../_chunks/index-pym1cezq.js";
+import"../../_chunks/index-jt8e1pje.js";
 import"../../_chunks/index-qjj6gddn.js";
 import"../../_chunks/index-rt9qq1va.js";
 export {

package/dist/server/compat/next/resource-hints.js

@@ -5,8 +5,8 @@ import {
   registerResourceHintFinalizer,
   takeResourceHintHeader,
   takeResourceHintsForResponse
-} from "../../_chunks/index-ym67zqxp.js";
-import"../../_chunks/index-6e4fqv30.js";
+} from "../../_chunks/index-tf4j19ge.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/rewrites.js

@@ -8,25 +8,27 @@ import {
   resolveCompatRewrite,
   splitDestination,
   substitute
-} from "../../_chunks/index-z84ab1w0.js";
+} from "../../_chunks/index-e176wk6x.js";
 import"../../_chunks/index-6q7zvrap.js";
 import"../../_chunks/index-79ngvam8.js";
-import"../../_chunks/index-9n2914ww.js";
+import"../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";
 import"../../_chunks/index-4zzebszd.js";
 import"../../_chunks/index-sq3kvz3g.js";
 import"../../_chunks/index-ckkdpht5.js";
-import"../../_chunks/index-x93hv0sc.js";
-import"../../_chunks/index-tqn2qnnn.js";
+import"../../_chunks/index-zedjt25v.js";
+import"../../_chunks/index-bzd2ef7t.js";
+import"../../_chunks/index-fpghsgb4.js";
 import"../../_chunks/index-grta8ap3.js";
 import"../../_chunks/index-kresp2n8.js";
 import"../../_chunks/index-e3a6yx84.js";
 import"../../_chunks/index-7wc9n8be.js";
 import"../../_chunks/index-pym1cezq.js";
+import"../../_chunks/index-jt8e1pje.js";
 import"../../_chunks/index-qjj6gddn.js";
 import"../../_chunks/index-rt9qq1va.js";
 export {

package/dist/server/compat/next/root-params.js

@@ -6,13 +6,13 @@ import {
 import {
   insideUseCacheProducer,
   recordUseCacheRootParamRead
-} from "../../_chunks/index-eajaspjk.js";
+} from "../../_chunks/index-j0m1jxqa.js";
 import {
   currentRenderCacheMeta,
   insideUnstableCacheProducer
-} from "../../_chunks/index-9n2914ww.js";
+} from "../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/route-state.js

@@ -3,9 +3,9 @@ import {
   nextClientRouteState,
   staticSiblingNames,
   staticSiblingNamesBySegment
-} from "../../_chunks/index-cf4rvxv6.js";
+} from "../../_chunks/index-52k54ykj.js";
 import"../../_chunks/index-z88qv16t.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/script.js

@@ -9,9 +9,9 @@ import {
   renderPartytownHeadScripts,
   takeDeferredScripts,
   takeHeadScripts
-} from "../../_chunks/index-sjpckxqn.js";
+} from "../../_chunks/index-9f49w76j.js";
 import"../../_chunks/index-ye9hmsvf.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/compat/next/server.js

@@ -6,23 +6,23 @@ import {
 } from "../../_chunks/index-r97ptz1q.js";
 import {
   io
-} from "../../_chunks/index-9hx2641q.js";
+} from "../../_chunks/index-entm8bmz.js";
 import {
   assertDynamicErrorRequestApi
-} from "../../_chunks/index-sctcgyvv.js";
+} from "../../_chunks/index-drwv61cc.js";
 import {
   afterRequestApisAllowed,
   assertRequestApiAllowedInAfter,
   recordRequestPath,
   runWithAfterRequestApiScope
 } from "../../_chunks/index-2vz0wzdn.js";
-import"../../_chunks/index-0374j2b9.js";
+import"../../_chunks/index-y4d02znn.js";
 import {
   assertNoDynamicApiInsideCache,
   currentRenderCacheMeta
-} from "../../_chunks/index-9n2914ww.js";
+} from "../../_chunks/index-akkrvjn6.js";
 import"../../_chunks/index-bcws5eh2.js";
-import"../../_chunks/index-6e4fqv30.js";
+import"../../_chunks/index-m63czgq5.js";
 import"../../_chunks/index-cjgqs13g.js";
 import"../../_chunks/index-jks0x0a1.js";
 import"../../_chunks/index-6b009mt0.js";

package/dist/server/generation.json

@@ -1 +1 @@
-{"version":"0.1.7","fingerprint":"3e1b3462bd8a29ed","source":["src/api/cache.ts","src/api/client-navigation.ts","src/api/dynamic.tsx","src/api/link.tsx","src/api/navigation.ts","src/api/server.ts","src/api/suspense.ts","src/client/router/events.ts","src/client/router/history.ts","src/client/router/hub.ts","src/client/router/index.ts","src/client/router/page-slot.ts","src/client/router/policies.ts","src/client/router/runtime.ts","src/index.ts","src/internal.ts","src/request/cache.ts","src/routing/href.ts","src/utils/decode.ts"]}
+{"version":"0.1.9","fingerprint":"5c05030a635e53e4","source":["src/api/cache.ts","src/api/client-navigation.ts","src/api/dynamic.tsx","src/api/link.tsx","src/api/navigation.ts","src/api/server.ts","src/api/suspense.ts","src/client/router/events.ts","src/client/router/history.ts","src/client/router/hub.ts","src/client/router/index.ts","src/client/router/page-slot.ts","src/client/router/policies.ts","src/client/router/runtime.ts","src/index.ts","src/internal.ts","src/request/cache.ts","src/routing/href.ts","src/utils/decode.ts"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wular/pnext",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A fast little framework for server-first React apps, fully compatible with Next.js",
   "type": "module",
   "bin": {

package/reference/compat.md

@@ -125,4 +125,4 @@ A route or proxy declaring an edge runtime, and a Pages Router handler configure
 
 `output: 'export'` writes a static tree to `out/`, or to `distDir` when the app configures a custom one. The tree carries the HTML and the flat per-page artifacts the client router fetches when no pnext server is present, the client runtime under `_next/static/chunks/`, the build manifests, the `public/` tree, and the not-found page. Dynamic routes without `generateStaticParams`, pages forcing dynamic rendering, and route handlers with disallowed segment config are build errors, as they are in Next.
 
-`output: 'standalone'` writes `.next/standalone/` with a `server.js` that boots on `PORT` and `HOSTNAME`, along with a `.nft.json` trace beside each page entry and a middleware manifest. Because pnext's production server runs under Bun, that launcher is a thin Node script that re-executes the real pnext server pointed back at the original build directory. The folder is therefore not a self-contained bundle you can ship on its own, because the build tree has to travel with it.
+`output: 'standalone'` writes the same `standalone/` folder as every build (see [Deploy](./dev.md#deploy)), at `.next/standalone/`, with `.nft.json` traces, a middleware manifest and a `server.js` that serves it on `PORT` and `HOSTNAME` via `node server.js`. Bun must be installed. `public/` and static files are already inside.

package/reference/config.md

@@ -21,7 +21,7 @@ This is the form `pnext create` scaffolds. With `compat.next`, pnext also loads
 
 | Field                         | Default     | What it does                                                                                               |
 | ----------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------- |
-| `outDir`                      | `'.pnext'`  | Build output for HTML, client assets, cache files, and `manifest.json`.                                    |
+| `outDir`                      | `'.pnext'`  | Build output: the shippable `standalone/` folder, the build `cache/`, and generated `types/`.              |
 | `basePath`                    | `''`        | Path prefix for an app served below the domain root.                                                       |
 | `assetPrefix`                 | `basePath`  | URL prefix for emitted assets. Set it when assets come from a CDN.                                         |
 | `trailingSlash`               | `false`     | Canonicalizes URLs to a trailing slash and redirects the form without one.                                 |
@@ -51,7 +51,7 @@ Both `compat.next` and `compat.reactCompiler` imply `compat.react`. Direct Preac
 
 ## Deployment adapter
 
-`exclude` and `keep` are string lists that adjust which directories and file suffixes an adapter packs. The Vercel adapter consumes them.
+`exclude` drops matching directories and file suffixes from `standalone/`. `keep` ships matching app files the server reads at runtime. Both apply to the Vercel function.
 
 ```ts
 export default {

package/reference/dev.md

@@ -48,7 +48,7 @@ Debug flags: `--experimental-build-mode compile|generate` splits the build into
 
 ## Deploy
 
-pnext deploys anywhere Bun runs: a VPS, a container, or any host you control. Run `pnext build` on the machine or in CI, then `pnext start` serves the app on your port.
+pnext deploys anywhere Bun runs: a VPS, a container, or any host you control. Run `pnext build`, then ship `<outDir>/standalone`; it needs nothing else. Serve it with `pnext start`, or import `standalone/server/entry.js` in your own server and call `createRequestHandler()`. To use a CDN, upload `standalone/static/` as-is.
 
 Vercel has a dedicated adapter: `pnext build --adapter vercel` writes Build Output to `.vercel/output`. Static pages and static route-handler responses are emitted as files; everything dynamic runs in a single `_pnext` function on Vercel's Bun runtime.
 

package/reference/getting-started.md

@@ -41,7 +41,7 @@ pnext start
 
 `pnext build` makes the production build and `pnext start` serves it. Routes render on the server per request; ones that never read the request are prerendered to static HTML at build time.
 
-That deploys anywhere Bun runs. For Vercel, build with `pnext build --adapter vercel` and it writes ready-to-deploy Build Output.
+Ship `.pnext/standalone` to any host with Bun. For Vercel, build with `pnext build --adapter vercel` and it writes ready-to-deploy Build Output.
 
 ## A quick tour
 

package/reference/rendering.md

@@ -40,7 +40,7 @@ Put the directive at the top of a page when the whole page needs browser-only be
 
 ## Lazy loading
 
-`dynamic()` defers loading a component. It works in Server Components and Client Components alike, and inside a Client Component it is a browser lazy loader. The loader can also be a literal module path for a default export.
+`dynamic()` defers loading a component in Server and Client Components. The loader can also be a literal module path for a default export.
 
 ```tsx
 import { dynamic } from '@wular/pnext/dynamic'
@@ -50,10 +50,10 @@ const Chart = dynamic(() => import('./chart').then(m => m.Chart), {
 })
 ```
 
-A Client Component target renders on the server and hydrates by default. The options change that:
+The component renders on the server and hydrates by default. The options change that:
 
-- `ssr: false` produces browser-only output.
-- `load: 'visible'` waits for the island to enter view, and accepts `rootMargin` and `threshold`. It is browser-only as well unless `ssr` is true.
+- `ssr: false` renders only in the browser.
+- `load: 'visible'` waits for the component to enter view, and accepts `rootMargin` and `threshold`. It renders only in the browser, except with `ssr: true` in a Server Component.
 - `loading` supplies fallback UI.
 
 ## Props that cross the boundary

package/src/api/dynamic.tsx

@@ -1,6 +1,6 @@
 /** @jsxImportSource preact */
-import { h, type ComponentType } from 'preact'
-import { useEffect, useRef, useState } from 'preact/hooks'
+import { Component, h, type ComponentChildren, type ComponentType } from 'preact'
+import { useEffect, useLayoutEffect, useRef, useState } from 'preact/hooks'
 
 export type DynamicModule<Props> = ComponentType<Props> | { default: ComponentType<Props> }
 export type DynamicLoader<Props> = string | (() => Promise<DynamicModule<Props>>)
@@ -35,6 +35,7 @@ export function dynamic<Props extends object = object>(
 ) {
   let loaded: ComponentType<Props> | null = null
   let pending: Promise<ComponentType<Props>> | null = null
+  let failed = false
   const loadModule =
     typeof loader === 'string'
       ? () => {
@@ -50,11 +51,45 @@ export function dynamic<Props extends object = object>(
     return pending
   }
 
-  function DynamicComponent(props: Props) {
-    const [Component, setComponent] = useState<ComponentType<Props> | null>(() => loaded)
+  // Rendered on the server and hydrated from its markup: suspends until the module loads.
+  function Loaded(props: Props) {
+    const ref = useRef<HTMLElement>(null)
+    const [remounts, setRemounts] = useState(0)
+    // The server sent `loading` because its load failed: replace that markup, never hydrate it.
+    useLayoutEffect(() => {
+      if (ref.current?.hasAttribute('data-pnext-loading')) setRemounts(1)
+    }, [])
+    if (loaded)
+      return h('pnext-dynamic', { key: remounts, ref, style: HOST_STYLE }, h(loaded, props))
+    const Loading = options.loading
+    if (failed) {
+      return h(
+        'pnext-dynamic',
+        { ref, style: HOST_STYLE, 'data-pnext-loading': '' },
+        Loading ? h(Loading, props) : null,
+      )
+    }
+    // eslint-disable-next-line @typescript-eslint/only-throw-error
+    throw typeof window === 'undefined'
+      ? load().then(
+          () => undefined,
+          () => {
+            failed = true
+          },
+        )
+      : load()
+  }
+
+  function ClientDynamic(props: Props) {
+    const [Component, setComponent] = useState<ComponentType<Props> | null>(null)
     const [shouldLoad, setShouldLoad] = useState(() => options.load !== 'visible')
     const visibleRef = useRef<HTMLDivElement>(null)
 
+    // The server sent `loading`: hydrate it, then swap in a module that is already loaded.
+    useLayoutEffect(() => {
+      if (loaded) setComponent(() => loaded)
+    }, [])
+
     useEffect(() => {
       if (Component || shouldLoad) return
       const node = visibleRef.current
@@ -98,6 +133,18 @@ export function dynamic<Props extends object = object>(
     return Loading ? h(Loading, props) : null
   }
 
+  const DynamicComponent =
+    options.ssr === false || options.load === 'visible'
+      ? ClientDynamic
+      : (props: Props) =>
+          typeof window === 'undefined'
+            ? h(Loaded, props)
+            : h(
+                DynamicBoundary,
+                { fallback: options.loading ? h(options.loading, props) : null },
+                h(Loaded, props),
+              )
+
   ;(
     DynamicComponent as typeof DynamicComponent & {
       [dynamicReferenceSymbol]: DynamicReference<Props>
@@ -106,3 +153,36 @@ export function dynamic<Props extends object = object>(
 
   return DynamicComponent
 }
+
+const HOST_STYLE = { display: 'contents' }
+// preact's mangled MODE_HYDRATE flag on a vnode's `__u`.
+const MODE_HYDRATE = 32
+
+interface SuspendedVNode {
+  __u: number
+}
+
+// Suspense for one dynamic(): hydration keeps the server markup until the chunk loads, a fresh render
+// shows `fallback`. `__c` is compat's mangled `_childDidSuspend`, so compat suspends here too.
+class DynamicBoundary extends Component<
+  { fallback: ComponentChildren; children?: ComponentChildren },
+  { waiting?: boolean; held?: boolean }
+> {
+  __c(promise: Promise<unknown>, vnode: SuspendedVNode) {
+    this.setState({ waiting: true, held: (vnode.__u & MODE_HYDRATE) !== 0 })
+    void promise.then(() => this.setState({ waiting: false }))
+  }
+
+  componentDidCatch(error: unknown) {
+    if (!(error instanceof Promise)) throw error
+    this.__c(error, (this as unknown as { __v: { __k: SuspendedVNode[] } }).__v.__k[0]!)
+  }
+
+  shouldComponentUpdate(_props: unknown, state: { waiting?: boolean; held?: boolean }) {
+    return !(state.waiting && state.held)
+  }
+
+  render() {
+    return this.state.waiting && !this.state.held ? this.props.fallback : this.props.children
+  }
+}