alchemy 2.0.0-beta.74 → 2.0.0-beta.76

package/lib/Cloudflare/Website/Astro.js

@@ -38,16 +38,18 @@ import { Worker, } from "../Workers/Worker.js";
  * ### Static Sites
  * With `astro: { output: "static" }` every page is prerendered at build
  * time and the deploy is **assets-only**: no server bundle is uploaded —
- * Cloudflare's asset layer answers every request (including the built
- * `404.html` via `assets.notFoundHandling: "404-page"`). Session
- * provisioning is skipped for declared-static sites since no Worker code
- * runs at request time.
+ * Cloudflare's asset layer answers every request (serve the built
+ * `404.html` via `assets: { notFoundHandling: "404-page" }`). Session
+ * provisioning is skipped for declared-static sites since no Worker
+ * code runs at request time.
  *
  * **Example:** Fully static Astro site
  * ```typescript
  * const site = yield* Cloudflare.Website.Astro("Docs", {
  *   astro: { output: "static" },
- *   assets: { notFoundHandling: "404-page" },
+ *   assets: {
+ *     notFoundHandling: "404-page",
+ *   },
  * });
  * ```
  *
@@ -109,23 +111,22 @@ import { Worker, } from "../Workers/Worker.js";
  * ```
  *
  * ### Astro Configuration
- * Your `astro.config.*` file loads natively — integrations, Vite
- * plugins, and other non-serializable options work as usual. Common
- * serializable options are exposed under `astro` for deploy-specific
- * overrides; astro merges them OVER the config file (scalars override,
- * arrays like `integrations` concatenate). The Cloudflare adapter is
- * injected for you — declaring an `adapter` in the config file fails
- * the build. `output` defaults to `"server"`, superseding a file-level
- * `output`; opt into a fully prerendered site with
- * `astro: { output: "static" }`.
- *
- * **Example:** Setting the site URL and source directory
+ * Your `astro.config.*` is the home for Astro configuration
+ * (integrations, Vite plugins, `site`, `base`, ...) and loads natively.
+ * The Cloudflare adapter is injected for you — declaring an `adapter`
+ * in the config file fails the build. The `astro` prop is a
+ * deploy-time override bag merged OVER the file (values here win) for
+ * settings that vary per stage or derive from other resources'
+ * Outputs, which a config file cannot consume. `output` defaults to
+ * `"server"` — astro's zero-config `"static"` default would prerender
+ * every page inside workerd, where the Worker's bindings don't exist.
+ * Use `config` to point at an alternate config file (relative to
+ * `rootDir`).
+ *
+ * **Example:** Per-stage site URL override
  * ```typescript
  * const site = yield* Cloudflare.Website.Astro("Blog", {
- *   astro: {
- *     site: "https://blog.example.com",
- *     srcDir: "./app",
- *   },
+ *   astro: { site: "https://blog.example.com" },
  * });
  * ```
  *
@@ -186,14 +187,17 @@ export const Astro = ((id, propsEff) => id === undefined
                     // opt-out.
                     sessionKVBindingName: props.sessionKVBindingName,
                     prerenderEnvironment: props.prerenderEnvironment,
-                    // Server output is the documented default: astro's own
-                    // zero-config default is `"static"`, which would prerender
-                    // every page at build time inside workerd — where the
-                    // Worker's bindings don't exist. The inline config merges
-                    // OVER a project's `astro.config.*`, so an explicit
-                    // file-level `output` is superseded; opt into a fully
-                    // prerendered site with `astro: { output: "static" }`.
-                    astro: { output: "server", ...props.astro },
+                    // The `astro` bag is the deploy-time overlay merged OVER
+                    // the natively-loaded `astro.config.*`. Server output is
+                    // the documented default: astro's own zero-config default
+                    // is `"static"`, which would prerender every page at
+                    // build time inside workerd — where the Worker's bindings
+                    // don't exist.
+                    astro: {
+                        ...props.astro,
+                        output: props.astro?.output ?? "server",
+                    },
+                    config: props.config,
                 },
             },
         };

package/lib/Cloudflare/Website/Astro.js.map

@@ -1 +1 @@
-{"version":3,"file":"Astro.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Astro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAgF9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+IG;AACH,MAAM,CAAC,MAAM,KAAK,GA6Bd,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,GACT,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC;QAC3C,MAAM,kBAAkB,GACtB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACpB,8DAA8D;QAC9D,+DAA+D;QAC/D,4DAA4D;QAC5D,gEAAgE;QAChE,kEAAkE;QAClE,iEAAiE;QACjE,0DAA0D;QAC1D,IACE,OAAO,KAAK,KAAK;YACjB,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ;YAChC,GAAG,EAAE,CAAC,kBAAkB,CAAC,KAAK,SAAS,EACvC,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAClD,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,GAAG,KAAK;YACR,GAAG;YACH,6DAA6D;YAC7D,gEAAgE;YAChE,mDAAmD;YACnD,0DAA0D;YAC1D,IAAI,EAAE,SAAU;YAChB,MAAM,EAAE;gBACN,QAAQ,EAAE,+CAA+C;gBACzD,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE;oBACP,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,qDAAqD;oBACrD,wDAAwD;oBACxD,WAAW;oBACX,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;oBAChD,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;oBAChD,uDAAuD;oBACvD,2DAA2D;oBAC3D,sDAAsD;oBACtD,0DAA0D;oBAC1D,oDAAoD;oBACpD,sDAAsD;oBACtD,uDAAuD;oBACvD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;iBAC5C;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAQ,CAAC"}
+{"version":3,"file":"Astro.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Astro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAuF9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgJG;AACH,MAAM,CAAC,MAAM,KAAK,GA6Bd,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,GACT,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC;QAC3C,MAAM,kBAAkB,GACtB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACpB,8DAA8D;QAC9D,+DAA+D;QAC/D,4DAA4D;QAC5D,gEAAgE;QAChE,kEAAkE;QAClE,iEAAiE;QACjE,0DAA0D;QAC1D,IACE,OAAO,KAAK,KAAK;YACjB,KAAK,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ;YAChC,GAAG,EAAE,CAAC,kBAAkB,CAAC,KAAK,SAAS,EACvC,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAClD,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC;QACnD,CAAC;QACD,OAAO;YACL,GAAG,KAAK;YACR,GAAG;YACH,6DAA6D;YAC7D,gEAAgE;YAChE,mDAAmD;YACnD,0DAA0D;YAC1D,IAAI,EAAE,SAAU;YAChB,MAAM,EAAE;gBACN,QAAQ,EAAE,+CAA+C;gBACzD,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE;oBACP,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,qDAAqD;oBACrD,wDAAwD;oBACxD,WAAW;oBACX,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;oBAChD,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;oBAChD,yDAAyD;oBACzD,yDAAyD;oBACzD,0DAA0D;oBAC1D,qDAAqD;oBACrD,0DAA0D;oBAC1D,eAAe;oBACf,KAAK,EAAE;wBACL,GAAG,KAAK,CAAC,KAAK;wBACd,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,QAAQ;qBACxC;oBACD,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAQ,CAAC"}

package/lib/Cloudflare/Website/Foldkit.d.ts

@@ -58,7 +58,7 @@ export interface FoldkitProps<Bindings extends WorkerBindingProps = {}> extends
      * Foldkit apps route on the client, so `notFoundHandling` defaults to
      * `"single-page-application"` — unmatched paths serve `index.html` and
      * the app's router takes over. Set `notFoundHandling` explicitly to
-     * override.
+     * override (e.g. `"404-page"` to serve the built `404.html`).
      *
      * @default { notFoundHandling: "single-page-application" }
      */
@@ -99,9 +99,8 @@ export interface FoldkitProps<Bindings extends WorkerBindingProps = {}> extends
  *
  * ### Single-Page Application Routing
  * Unmatched paths serve `index.html` by default so deep links boot the
- * app and the Foldkit router resolves the route. An explicit `assets`
- * config merges over the default — a site that ships real 404 content
- * can opt out.
+ * app and the Foldkit router resolves the route. A site that ships real
+ * 404 content overrides the default with `notFoundHandling: "404-page"`.
  *
  * **Example:** Serving a real 404 page
  * ```typescript

package/lib/Cloudflare/Website/Foldkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Foldkit.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Foldkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY,CAC3B,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB;;;;;WAKG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5D,CAAC;IACF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAChE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAChE,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CAwBW,CAAC"}
+{"version":3,"file":"Foldkit.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Foldkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,YAAY,CAC3B,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB;;;;;WAKG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5D,CAAC;IACF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAChE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAChE,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CAyBW,CAAC"}

package/lib/Cloudflare/Website/Foldkit.js

@@ -36,9 +36,8 @@ import { Worker, } from "../Workers/Worker.js";
  *
  * ### Single-Page Application Routing
  * Unmatched paths serve `index.html` by default so deep links boot the
- * app and the Foldkit router resolves the route. An explicit `assets`
- * config merges over the default — a site that ships real 404 content
- * can opt out.
+ * app and the Foldkit router resolves the route. A site that ships real
+ * 404 content overrides the default with `notFoundHandling: "404-page"`.
  *
  * **Example:** Serving a real 404 page
  * ```typescript
@@ -106,7 +105,8 @@ export const Foldkit = ((id, propsEff) => id === undefined
     : Worker(id, Effect.map(Effect.isEffect(propsEff) ? propsEff : Effect.succeed(propsEff), (props) => ({
         ...props,
         // Foldkit routes on the client; serve index.html for unmatched
-        // paths so deep links boot the app instead of 404ing.
+        // paths so deep links boot the app instead of 404ing. An
+        // explicit `assets.notFoundHandling` wins over the default.
         assets: {
             notFoundHandling: "single-page-application",
             ...props?.assets,

package/lib/Cloudflare/Website/Foldkit.js.map

@@ -1 +1 @@
-{"version":3,"file":"Foldkit.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Foldkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAkE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AACH,MAAM,CAAC,MAAM,OAAO,GA6BhB,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,+DAA+D;QAC/D,sDAAsD;QACtD,MAAM,EAAE;YACN,gBAAgB,EAAE,yBAAkC;YACpD,GAAG,KAAK,EAAE,MAAM;SACjB;QACD,IAAI,EAAE,SAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,EAAE,IAAI;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,IAAI,EAAE,KAAK,EAAE,IAAI;SAClB;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}
+{"version":3,"file":"Foldkit.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Foldkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAkE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,MAAM,CAAC,MAAM,OAAO,GA6BhB,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,+DAA+D;QAC/D,yDAAyD;QACzD,4DAA4D;QAC5D,MAAM,EAAE;YACN,gBAAgB,EAAE,yBAAkC;YACpD,GAAG,KAAK,EAAE,MAAM;SACjB;QACD,IAAI,EAAE,SAAU;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,EAAE,IAAI;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,IAAI,EAAE,KAAK,EAAE,IAAI;SAClB;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}

package/lib/Cloudflare/Website/Nextjs.d.ts

@@ -4,50 +4,7 @@ import type { InputProps } from "../../Input.ts";
 import type { Providers } from "../Providers.ts";
 import type { AssetsConfig } from "../Workers/Assets.ts";
 import { Worker, type NormalizedBindings, type WorkerAssetsConfig, type WorkerBindingProps, type WorkerProps } from "../Workers/Worker.ts";
-/** Next.js/OpenNext-specific build knobs, forwarded to the source provider. */
-export interface NextjsBuildOptions {
-    /**
-     * Path of the OpenNext config, relative to the project root.
-     * @default "open-next.config.ts"
-     */
-    configPath?: string;
-    /**
-     * The command the OpenNext pipeline runs to build the Next.js app.
-     * A `buildCommand` set in the project's `open-next.config.ts` takes
-     * precedence over this option.
-     * @default "npx next build"
-     */
-    buildCommand?: string;
-    /**
-     * Skip the internal `next build` and reuse an existing `.next` directory.
-     * @default false
-     */
-    skipNextBuild?: boolean;
-    /**
-     * Minify the OpenNext bundling steps and the final worker bundle pass.
-     * @default false
-     */
-    minify?: boolean;
-    /**
-     * Enable OpenNext debug logging (and verbose workerd output in dev).
-     * @default false
-     */
-    debug?: boolean;
-    /**
-     * Local dev (`alchemy dev`) behavior.
-     *
-     * - `"preview"` (default): build the OpenNext worker and serve it under
-     *   workerd — production parity (workerd APIs, ISR/cache semantics),
-     *   no HMR.
-     * - `"hmr"`: run the real `next dev` (Turbopack HMR) in Node with the
-     *   Worker's bindings proxied onto OpenNext's `getCloudflareContext()`
-     *   contract. App code runs in Node, not workerd — CF-specific runtime
-     *   behavior still needs `"preview"`.
-     * @default "preview"
-     */
-    devMode?: "preview" | "hmr";
-}
-export interface NextjsProps<Bindings extends WorkerBindingProps = {}> extends Omit<WorkerProps<Bindings>, "vite" | "main" | "assets" | "script" | "bundle" | "source" | "rules"> {
+export interface NextjsProps<Bindings extends WorkerBindingProps = {}> extends Omit<WorkerProps<Bindings>, "vite" | "main" | "assets" | "script" | "bundle" | "source" | "rules" | "dev"> {
     /**
      * The Next.js project root (the directory containing `next.config.*` and
      * `open-next.config.ts`). Defaults to the process working directory.
@@ -61,8 +18,26 @@ export interface NextjsProps<Bindings extends WorkerBindingProps = {}> extends O
      * `include`/`exclude` globs when the default is too broad.
      */
     memo?: MemoOptions;
-    /** Next.js/OpenNext-specific build and dev configuration. */
-    nextjs?: NextjsBuildOptions;
+    /**
+     * Local dev (`alchemy dev`) behavior.
+     */
+    dev?: {
+        /**
+         * - `"preview"` (default): build the OpenNext worker and serve it
+         *   under workerd — production parity (workerd APIs, ISR/cache
+         *   semantics), no HMR.
+         * - `"hmr"`: run the real `next dev` (Turbopack HMR) in Node with the
+         *   Worker's bindings proxied onto OpenNext's `getCloudflareContext()`
+         *   contract. App code runs in Node, not workerd — CF-specific
+         *   runtime behavior still needs `"preview"`.
+         * @default "preview"
+         */
+        mode?: "preview" | "hmr";
+        /**
+         * Port for the local dev server. `0` picks an ephemeral port.
+         */
+        port?: number;
+    };
     /**
      * Optional configuration for static asset routing behavior.
      * Defaults to `runWorkerFirst: true` with `htmlHandling`/`notFoundHandling`
@@ -88,8 +63,8 @@ export interface NextjsProps<Bindings extends WorkerBindingProps = {}> extends O
  * `import()`.
  *
  * Local dev (`alchemy dev`) defaults to preview parity — the built worker
- * served under workerd. Set `nextjs: { devMode: "hmr" }` for the real
- * `next dev` (Turbopack HMR) with the Worker's bindings proxied onto
+ * served under workerd. Set `devMode: "hmr"` for the real `next dev`
+ * (Turbopack HMR) with the Worker's bindings proxied onto
  * `getCloudflareContext()`.
  *
  * ISR comes in two flavors, chosen by the project's `open-next.config.ts`:
@@ -217,18 +192,9 @@ export interface NextjsProps<Bindings extends WorkerBindingProps = {}> extends O
  * ```
  *
  * ### Build Configuration
- * The `nextjs` prop tunes the OpenNext pipeline: a custom build command,
- * minification, or reusing an existing `.next` build.
- *
- * **Example:** Minified build with a custom command
- * ```typescript
- * const site = yield* Cloudflare.Website.Nextjs("Site", {
- *   nextjs: {
- *     buildCommand: "npx next build --no-lint",
- *     minify: true,
- *   },
- * });
- * ```
+ * The OpenNext build pipeline (build command, minification, ...) is
+ * configured in your project's `open-next.config.ts`, which loads
+ * natively — the resource only deploys the result.
  *
  * ### Class Form
  * Calling `Nextjs` with no arguments returns a constructor you can

package/lib/Cloudflare/Website/Nextjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Nextjs.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nextjs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Nextjs.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAEL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAiB9B,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAC9E;IACC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IAInB;;OAEG;IACH,GAAG,CAAC,EAAE;QACJ;;;;;;;;;WASG;QACH,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;QACzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC/D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC/D,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CA8DW,CAAC"}

package/lib/Cloudflare/Website/Nextjs.js

@@ -31,8 +31,8 @@ const DEFAULT_COMPATIBILITY_DATE = "2026-05-12";
  * `import()`.
  *
  * Local dev (`alchemy dev`) defaults to preview parity — the built worker
- * served under workerd. Set `nextjs: { devMode: "hmr" }` for the real
- * `next dev` (Turbopack HMR) with the Worker's bindings proxied onto
+ * served under workerd. Set `devMode: "hmr"` for the real `next dev`
+ * (Turbopack HMR) with the Worker's bindings proxied onto
  * `getCloudflareContext()`.
  *
  * ISR comes in two flavors, chosen by the project's `open-next.config.ts`:
@@ -160,18 +160,9 @@ const DEFAULT_COMPATIBILITY_DATE = "2026-05-12";
  * ```
  *
  * ### Build Configuration
- * The `nextjs` prop tunes the OpenNext pipeline: a custom build command,
- * minification, or reusing an existing `.next` build.
- *
- * **Example:** Minified build with a custom command
- * ```typescript
- * const site = yield* Cloudflare.Website.Nextjs("Site", {
- *   nextjs: {
- *     buildCommand: "npx next build --no-lint",
- *     minify: true,
- *   },
- * });
- * ```
+ * The OpenNext build pipeline (build command, minification, ...) is
+ * configured in your project's `open-next.config.ts`, which loads
+ * natively — the resource only deploys the result.
  *
  * ### Class Form
  * Calling `Nextjs` with no arguments returns a constructor you can
@@ -196,6 +187,12 @@ export const Nextjs = ((id, propsEff) => id === undefined
     ? (id, propsEff) => effectClass(Nextjs(id, propsEff))
     : Worker(id, Effect.map(Effect.isEffect(propsEff) ? propsEff : Effect.succeed(propsEff), (props) => ({
         ...props,
+        // `dev.mode` is the integration's dev behavior (routed through
+        // the source options below); only `port` maps onto the Worker's
+        // own local-dev config.
+        dev: props?.dev?.port !== undefined
+            ? { port: props.dev.port }
+            : undefined,
         // OpenNext's revalidation queues (memory-queue, do-queue) fetch
         // the worker back through `WORKER_SELF_REFERENCE`. Always wire
         // the self service binding — it's inert when unused, and its
@@ -232,13 +229,8 @@ export const Nextjs = ((id, propsEff) => id === undefined
             options: {
                 root: props?.rootDir,
                 memo: props?.memo,
-                ...(props?.nextjs !== undefined
-                    ? (({ devMode, ...build }) => ({
-                        ...build,
-                        ...(devMode !== undefined
-                            ? { dev: { mode: devMode } }
-                            : {}),
-                    }))(props.nextjs)
+                ...(props?.dev?.mode !== undefined
+                    ? { dev: { mode: props.dev.mode } }
                     : {}),
             },
         },

package/lib/Cloudflare/Website/Nextjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"Nextjs.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,IAAI,EACJ,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,gDAAgD,CAAC;AAEhF;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,YAAY,CAAC;AA4EhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiLG;AACH,MAAM,CAAC,MAAM,MAAM,GA6Bf,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,gEAAgE;QAChE,+DAA+D;QAC/D,6DAA6D;QAC7D,yDAAyD;QACzD,2DAA2D;QAC3D,GAAG,EAAE;YACH,qBAAqB,EAAE,IAAI;YAC3B,GAAG,KAAK,EAAE,GAAG;SACd;QACD,+DAA+D;QAC/D,wDAAwD;QACxD,aAAa,EAAE;YACb,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,IAAI,0BAA0B;YAC9D,KAAK,EAAE,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC;gBACN,eAAe;gBACf,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;aACvC,CAAC,CACH;SACF;QACD,6DAA6D;QAC7D,4DAA4D;QAC5D,MAAM,EAAE;YACN,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,MAAM;YACpB,gBAAgB,EAAE,MAAM;YACxB,GAAG,KAAK,EAAE,MAAM;SACjB;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,sBAAsB;YAChC,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,6DAA6D;YAC7D,iEAAiE;YACjE,OAAO,EAAE,MAAM;YACf,OAAO,EAAE;gBACP,IAAI,EAAE,KAAK,EAAE,OAAO;gBACpB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS;oBAC7B,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;wBAC3B,GAAG,KAAK;wBACR,GAAG,CAAC,OAAO,KAAK,SAAS;4BACvB,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;4BAC5B,CAAC,CAAC,EAAE,CAAC;qBACR,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;oBACnB,CAAC,CAAC,EAAE,CAAC;aACR;SACF;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}
+{"version":3,"file":"Nextjs.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,IAAI,EACJ,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG,gDAAgD,CAAC;AAEhF;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAqDhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,MAAM,CAAC,MAAM,MAAM,GA6Bf,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,+DAA+D;QAC/D,gEAAgE;QAChE,wBAAwB;QACxB,GAAG,EACD,KAAK,EAAE,GAAG,EAAE,IAAI,KAAK,SAAS;YAC5B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;YAC1B,CAAC,CAAC,SAAS;QACf,gEAAgE;QAChE,+DAA+D;QAC/D,6DAA6D;QAC7D,yDAAyD;QACzD,2DAA2D;QAC3D,GAAG,EAAE;YACH,qBAAqB,EAAE,IAAI;YAC3B,GAAG,KAAK,EAAE,GAAG;SACd;QACD,+DAA+D;QAC/D,wDAAwD;QACxD,aAAa,EAAE;YACb,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,IAAI,0BAA0B;YAC9D,KAAK,EAAE,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC;gBACN,eAAe;gBACf,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;aACvC,CAAC,CACH;SACF;QACD,6DAA6D;QAC7D,4DAA4D;QAC5D,MAAM,EAAE;YACN,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,MAAM;YACpB,gBAAgB,EAAE,MAAM;YACxB,GAAG,KAAK,EAAE,MAAM;SACjB;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,sBAAsB;YAChC,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,6DAA6D;YAC7D,iEAAiE;YACjE,OAAO,EAAE,MAAM;YACf,OAAO,EAAE;gBACP,IAAI,EAAE,KAAK,EAAE,OAAO;gBACpB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;aACR;SACF;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}

package/lib/Cloudflare/Website/Nuxt.d.ts

@@ -37,21 +37,24 @@ export interface NuxtProps<Bindings extends WorkerBindingProps = {}> extends Omi
      * `include`/`exclude` globs when the project sits in a large repository.
      */
     memo?: MemoOptions;
-    /**
-     * Nuxt configuration overrides merged over the project's own
-     * `nuxt.config.ts` (the override wins). The project's config file is
-     * loaded natively — modules, layers, and all — so this is for
-     * deploy-specific tweaks (`routeRules`, `runtimeConfig`, ...). Must be
-     * JSON-serializable (it persists in state). Do not set `nitro.preset`
-     * here — the Cloudflare deploy target owns the preset and a foreign
-     * preset is a hard error.
-     */
-    nuxt?: Record<string, unknown>;
     /**
      * Optional configuration for static asset routing behavior.
      * Supports `runWorkerFirst`, `htmlHandling`, `notFoundHandling`, etc.
      */
     assets?: AssetsConfig;
+    /**
+     * Nuxt config overrides merged over the project's own `nuxt.config.ts`
+     * (the highest-priority c12 layer — a value here wins over the file).
+     * Use it for deploy-time values the config file can't express, e.g.
+     * per-stage `runtimeConfig`; `nuxt.config.ts` remains the primary home
+     * for everything else.
+     *
+     * Must be JSON-serializable — no functions, plugins, or modules (the
+     * value persists in state and participates in the rebuild hash).
+     * `nitro.preset` is always owned by the deploy target and cannot be
+     * overridden here.
+     */
+    nuxt?: Record<string, unknown>;
 }
 /**
  * A Cloudflare Worker deployed from a [Nuxt](https://nuxt.com) project.
@@ -134,14 +137,34 @@ export interface NuxtProps<Bindings extends WorkerBindingProps = {}> extends Omi
  * ### Prerendering
  * Routes marked for prerendering in `routeRules` (or via
  * `nitro.prerender`) render at build time into `.output/public` and are
- * served as static assets — no Worker invocation.
+ * served as static assets — no Worker invocation. Configure them in
+ * your `nuxt.config.ts`, which loads natively:
+ *
+ * **Example:** Prerendering a route (nuxt.config.ts)
+ * ```typescript
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ *   routeRules: {
+ *     "/about": { prerender: true },
+ *   },
+ * });
+ * ```
+ *
+ * ### Config Overrides
+ * `nuxt.config.ts` is the primary home for Nuxt configuration — it loads
+ * natively. The `nuxt` prop layers deploy-time overrides on top (the
+ * highest-priority c12 layer) for values the file can't express, like
+ * per-stage settings. The bag must be JSON-serializable — no functions,
+ * plugins, or modules — and `nitro.preset` stays owned by the deploy
+ * target.
  *
- * **Example:** Prerendering a route
+ * **Example:** Deploy-time config overrides
  * ```typescript
  * const site = yield* Cloudflare.Website.Nuxt("Website", {
  *   nuxt: {
- *     routeRules: {
- *       "/about": { prerender: true },
+ *     app: { baseURL: "/docs/" },
+ *     runtimeConfig: {
+ *       public: { apiBase: "https://api.example.com" },
  *     },
  *   },
  * });

package/lib/Cloudflare/Website/Nuxt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Nuxt.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,WAAW,SAAS,CACxB,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC7D,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CA8BW,CAAC"}
+{"version":3,"file":"Nuxt.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,WAAW,SAAS,CACxB,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmMG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAC7D,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CA8BW,CAAC"}

package/lib/Cloudflare/Website/Nuxt.js

@@ -88,14 +88,34 @@ const NUXT_SOURCE_PROVIDER = "@alchemy.run/frontend-frameworks/nuxt/source";
  * ### Prerendering
  * Routes marked for prerendering in `routeRules` (or via
  * `nitro.prerender`) render at build time into `.output/public` and are
- * served as static assets — no Worker invocation.
+ * served as static assets — no Worker invocation. Configure them in
+ * your `nuxt.config.ts`, which loads natively:
  *
- * **Example:** Prerendering a route
+ * **Example:** Prerendering a route (nuxt.config.ts)
+ * ```typescript
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ *   routeRules: {
+ *     "/about": { prerender: true },
+ *   },
+ * });
+ * ```
+ *
+ * ### Config Overrides
+ * `nuxt.config.ts` is the primary home for Nuxt configuration — it loads
+ * natively. The `nuxt` prop layers deploy-time overrides on top (the
+ * highest-priority c12 layer) for values the file can't express, like
+ * per-stage settings. The bag must be JSON-serializable — no functions,
+ * plugins, or modules — and `nitro.preset` stays owned by the deploy
+ * target.
+ *
+ * **Example:** Deploy-time config overrides
  * ```typescript
  * const site = yield* Cloudflare.Website.Nuxt("Website", {
  *   nuxt: {
- *     routeRules: {
- *       "/about": { prerender: true },
+ *     app: { baseURL: "/docs/" },
+ *     runtimeConfig: {
+ *       public: { apiBase: "https://api.example.com" },
  *     },
  *   },
  * });

package/lib/Cloudflare/Website/Nuxt.js.map

@@ -1 +1 @@
-{"version":3,"file":"Nuxt.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,8CAA8C,CAAC;AAyD5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KG;AACH,MAAM,CAAC,MAAM,IAAI,GA6Bb,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,2DAA2D;QAC3D,6DAA6D;QAC7D,4DAA4D;QAC5D,8CAA8C;QAC9C,2DAA2D;QAC3D,+CAA+C;QAC/C,IAAI,EAAE,SAAU;QAChB,MAAM,EAAE;YACN,QAAQ,EAAE,oBAAoB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE;gBACP,OAAO,EAAE,KAAK,EAAE,OAAO;gBACvB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,IAAI,EAAE,KAAK,EAAE,IAAI;aAClB;SACF;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}
+{"version":3,"file":"Nuxt.js","sourceRoot":"","sources":["../../../src/Cloudflare/Website/Nuxt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,MAAM,GAKP,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,8CAA8C,CAAC;AA4D5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmMG;AACH,MAAM,CAAC,MAAM,IAAI,GA6Bb,CAAC,CAAC,EAAQ,EAAE,QAAc,EAAE,EAAE,CAChC,EAAE,KAAK,SAAS;IACd,CAAC,CAAC,CAAC,EAAU,EAAE,QAAa,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC,CAAC,MAAM,CACJ,EAAE,EACF,MAAM,CAAC,GAAG,CACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,GAAG,KAAK;QACR,2DAA2D;QAC3D,6DAA6D;QAC7D,4DAA4D;QAC5D,8CAA8C;QAC9C,2DAA2D;QAC3D,+CAA+C;QAC/C,IAAI,EAAE,SAAU;QAChB,MAAM,EAAE;YACN,QAAQ,EAAE,oBAAoB;YAC9B,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE;gBACP,OAAO,EAAE,KAAK,EAAE,OAAO;gBACvB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,IAAI,EAAE,KAAK,EAAE,IAAI;aAClB;SACF;KACF,CAAC,CACH,CACF,CAAQ,CAAC"}

package/lib/Cloudflare/Website/SvelteKit.d.ts

@@ -20,41 +20,14 @@ export interface SvelteKitProps<Bindings extends WorkerBindingProps = {}> extend
      */
     memo?: MemoOptions;
     /**
-     * SvelteKit configuration overrides. A project-owned `vite.config.*`
-     * loads natively — its `sveltekit(...)` call is the primary config
-     * source — and these options are merged OVER it (the override wins).
-     * Without a config file, this is the whole kit config. Construction-time
-     * options (`preprocess`, `extensions`, `compilerOptions`, `vitePlugin`)
-     * only apply in the no-config-file case — put them in your own
-     * `sveltekit(...)` call otherwise. The `adapter` field is injected by
-     * Alchemy's wrangler-free Cloudflare adapter — do not set it here. Must
-     * be JSON-serializable (it persists in state).
+     * SvelteKit config overrides for the `sveltekit(...)` plugin call, merged
+     * over the options of the user's own call (these win). JSON-serializable
+     * only — no `preprocess`/`vitePlugin`/functions; construction-time options
+     * (`preprocess`, `extensions`, `compilerOptions`, `vitePlugin`) can only
+     * apply when no user `vite.config.*` exists. The `adapter` field is
+     * always owned by alchemy.
      */
     kit?: Record<string, unknown>;
-    /**
-     * Options for the wrangler-free Cloudflare adapter.
-     */
-    adapter?: {
-        /**
-         * Name of the static-assets binding the generated worker serves files
-         * through.
-         * @default "ASSETS"
-         */
-        assetsBinding?: string;
-        /**
-         * Fallback-page generation, mirroring Workers static assets
-         * `not_found_handling`: `"404-page"` writes a `404.html`,
-         * `"single-page-application"` writes an app-shell `index.html`.
-         * @default "none"
-         */
-        notFoundHandling?: "none" | "404-page" | "single-page-application";
-        /**
-         * With `notFoundHandling: "404-page"`: `"spa"` renders the app shell
-         * as the fallback, `"plaintext"` writes a plain `Not Found` page.
-         * @default "plaintext"
-         */
-        fallback?: "spa" | "plaintext";
-    };
     /**
      * Optional configuration for static asset routing behavior.
      * Supports `runWorkerFirst`, `htmlHandling`, `notFoundHandling`, etc.
@@ -117,18 +90,31 @@ export interface SvelteKitProps<Bindings extends WorkerBindingProps = {}> extend
  * // });
  * ```
  *
- * ### Kit and Adapter Options
- * Kit options normally live in the `sveltekit(...)` call in your
- * `vite.config.ts`, which loads natively; `kit` is a deploy-time
- * override layer merged over them (the override wins). The generated
- * Cloudflare adapter is configured via `adapter`.
+ * ### Kit Options and 404 Handling
+ * Kit options live in the `sveltekit(...)` call in your
+ * `vite.config.ts`, which loads natively. Fallback-page behavior is
+ * driven by the platform-native `assets.notFoundHandling` knob — the
+ * build generates the matching fallback page (rendering the app shell,
+ * so kit's own error page shows).
  *
- * **Example:** SPA-style 404 fallback
+ * **Example:** App-shell 404 fallback
  * ```typescript
  * const site = yield* Cloudflare.Website.SvelteKit("Website", {
- *   adapter: {
+ *   assets: {
  *     notFoundHandling: "404-page",
- *     fallback: "spa",
+ *   },
+ * });
+ * ```
+ *
+ * The `kit` prop is a deploy-time override bag merged over your own
+ * `sveltekit(...)` options (the prop wins) — useful for per-stage values
+ * the config file can't compute. JSON-serializable values only.
+ *
+ * **Example:** Deploy-time kit overrides
+ * ```typescript
+ * const site = yield* Cloudflare.Website.SvelteKit("Website", {
+ *   kit: {
+ *     paths: { base: "/docs" },
  *   },
  * });
  * ```

package/lib/Cloudflare/Website/SvelteKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SvelteKit.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/SvelteKit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc,CAC7B,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;WAKG;QACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,yBAAyB,CAAC;QACnE;;;;WAIG;QACH,QAAQ,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;KAChC,CAAC;IACF;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwGG;AACH,eAAO,MAAM,SAAS,EAAE;IACtB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GACpC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAClE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GACpC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAClE,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CA0CW,CAAC"}
+{"version":3,"file":"SvelteKit.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Website/SvelteKit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAc,CAC7B,QAAQ,SAAS,kBAAkB,GAAG,EAAE,CACxC,SAAQ,IAAI,CACZ,WAAW,CAAC,QAAQ,CAAC,EACrB,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAC5D;IACC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHG;AACH,eAAO,MAAM,SAAS,EAAE;IACtB,CAAC,IAAI,KAAK;QACR,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GACpC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAClE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG;YAC/C,QAAQ,MAAM,CAAC;iBAEX,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;aAC7D,CAAC,CAAC;SACJ,CAAC;KACH,CAAC;IACF,CAAC,KAAK,CAAC,QAAQ,SAAS,kBAAkB,GAAG,EAAE,EAAE,GAAG,GAAG,KAAK,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EACL,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GACpC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAClE,MAAM,CAAC,MAAM,CACd,MAAM,CAAC;SAEH,OAAO,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAChE,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC;KAC7D,CAAC,EACF,KAAK,EACL,GAAG,GAAG,SAAS,CAChB,CAAC;CAyCW,CAAC"}