@moku-labs/web 0.1.0-alpha.1 → 0.1.0-alpha.4

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { C as EnvApi, E as EnvState, O as LogApi, S as Events, _ as I18nConfig, a as BuildConfig, b as SiteState, c as ContentApi, d as RouteBuilder, f as RouteSpec, g as I18nApi, h as RouterState, i as BuildApi, k as LogState, l as ContentConfig, m as RouterConfig, n as RouteSpecMap, o as BuildState, p as RouterApi, r as WebAppConfig, s as Article, t as route, u as ContentState, v as I18nState, x as Config, y as SiteApi } from "./index-CWdZdegx.mjs";
-import { a as meta, d as HeadPluginConfig, f as HeadState, i as jsonLd, l as HeadApi, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-kuZFxqV7.mjs";
-import { a as SpaConfig, i as SpaApi, n as ComponentDef, o as SpaState, r as ComponentHooks, t as createComponent } from "./factory-BBVQO5ZG.mjs";
+import { A as ContentState, B as Events, C as RouterApi, D as Article, E as types_d_exports$7, F as types_d_exports$5, G as EnvState, H as EnvApi, I as SiteApi, J as LogApi, L as SiteState, M as I18nApi, N as I18nConfig, O as ContentApi, P as I18nState, R as types_d_exports$8, S as RouteSpec, T as RouterState, V as createPlugin, X as types_d_exports$6, Y as LogState, _ as BuildApi, a as i18n, b as types_d_exports, c as deploy, d as RouteSpecMap, f as WebAppConfig, g as types_d_exports$2, h as DeployState, i as log, j as types_d_exports$1, k as ContentConfig, l as content, m as DeployConfig, n as router, o as head, p as DeployApi, q as types_d_exports$3, r as route, s as env, t as site, u as build, v as BuildConfig, w as RouterConfig, x as RouteBuilder, y as BuildState, z as Config } from "./index-DH3jlpNi.mjs";
+import { a as meta, d as HeadPluginConfig, f as HeadState, i as jsonLd, l as HeadApi, m as types_d_exports$4, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-DKgZfRAO.mjs";
+import { a as SpaConfig, i as SpaApi, n as ComponentDef, o as SpaState, r as ComponentHooks, s as types_d_exports$9, t as createComponent } from "./factory-DRFGSslp.mjs";
+import { spa } from "./plugins/spa/index.mjs";
 import * as _moku_labs_core0 from "@moku-labs/core";
 
 //#region src/index.d.ts
@@ -9,11 +10,26 @@ declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_c
   url: string;
   author: string;
   description: string;
-}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
   'router:registered': {
     routeCount: number;
   };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
   'component:create': {
     name: string;
     element: Element;
@@ -36,22 +52,7 @@ declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_c
   'nav:end': {
     url: string;
   };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
-  'content:ready': {
-    articles: Map<string, Article[]>;
-  };
-  'content:invalidated': {
-    paths: string[];
-  };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
-  'build:phase': {
-    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
-  };
-  'build:complete': {
-    pages: number;
-    durationMs: number;
-  };
-}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"deploy", DeployConfig, DeployState, DeployApi, {}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
   level: "info";
   mode: "auto";
 }, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
@@ -63,11 +64,26 @@ declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_c
   url: string;
   author: string;
   description: string;
-}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
   'router:registered': {
     routeCount: number;
   };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
   'component:create': {
     name: string;
     element: Element;
@@ -90,22 +106,7 @@ declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_c
   'nav:end': {
     url: string;
   };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
-  'content:ready': {
-    articles: Map<string, Article[]>;
-  };
-  'content:invalidated': {
-    paths: string[];
-  };
-}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
-  'build:phase': {
-    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
-  };
-  'build:complete': {
-    pages: number;
-    durationMs: number;
-  };
-}> & Record<never, never>) | ExtraPlugins[number], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"deploy", DeployConfig, DeployState, DeployApi, {}> & Record<never, never>) | ExtraPlugins[number], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
   level: "info";
   mode: "auto";
 }, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
@@ -132,4 +133,4 @@ type WebApp<Routes extends Record<string, RouteBuilder>> = Omit<ReturnType<typeo
  */
 declare function createApp<Routes extends Record<string, RouteBuilder>>(input: WebAppConfig<Routes>): WebApp<Routes>;
 //#endregion
-export { type ComponentDef, type ComponentHooks, type Config, type Events, type RouteBuilder, type RouteSpec, WebApp, type WebAppConfig, canonical, createApp, createComponent, feedLink, hreflang, jsonLd, meta, og, route, twitter };
+export { types_d_exports as Build, type ComponentDef, type ComponentHooks, type Config, types_d_exports$1 as Content, types_d_exports$2 as Deploy, types_d_exports$3 as Env, type Events, types_d_exports$4 as Head, types_d_exports$5 as I18n, types_d_exports$6 as Log, type RouteBuilder, type RouteSpec, types_d_exports$7 as Router, types_d_exports$8 as Site, types_d_exports$9 as Spa, WebApp, type WebAppConfig, build, canonical, content, createApp, createComponent, createPlugin, deploy, env, feedLink, head, hreflang, i18n, jsonLd, log, meta, og, route, router, site, spa, twitter };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { c as route, d as coreConfig, f as createCore, l as site, o as head, s as router, t as createComponent, u as i18n } from "./factory-DwpBwjDk.mjs";
-import { n as build, r as content, t as project } from "./project-BTNUWbGQ.mjs";
-import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-gO5i1tD8.mjs";
+import { _ as env, c as route, d as coreConfig, f as createCore, l as site, m as log, o as head, p as createPlugin, s as router, t as createComponent, u as i18n } from "./factory-DiKypQqs.mjs";
+import { a as types_exports$6, c as types_exports$3, d as types_exports$1, f as types_exports, i as types_exports$7, l as types_exports$2, m as content, n as types_exports$9, o as types_exports$5, p as build, r as types_exports$8, s as types_exports$4, t as project, u as deploy } from "./project-guCYpUeD.mjs";
+import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-Dhko-oLM.mjs";
 import { spa } from "./plugins/spa/index.mjs";
 
 //#region src/index.ts
@@ -12,7 +12,8 @@ const { createApp: kernelCreateApp } = createCore(coreConfig, { plugins: [
 	router,
 	head,
 	build,
-	spa
+	spa,
+	deploy
 ] });
 /**
 * Layer-2 createApp wrapper — generic-preserving signature.
@@ -33,4 +34,4 @@ function createApp(input) {
 }
 
 //#endregion
-export { canonical, createApp, createComponent, feedLink, hreflang, jsonLd, meta, og, route, twitter };
+export { types_exports as Build, types_exports$1 as Content, types_exports$2 as Deploy, types_exports$3 as Env, types_exports$4 as Head, types_exports$5 as I18n, types_exports$6 as Log, types_exports$7 as Router, types_exports$8 as Site, types_exports$9 as Spa, build, canonical, content, createApp, createComponent, createPlugin, deploy, env, feedLink, head, hreflang, i18n, jsonLd, log, meta, og, route, router, site, spa, twitter };

package/dist/plugins/head/build.d.cts

@@ -1,4 +1,4 @@
-import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-BBo4wxUL.cjs";
+import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-yZqQkOVR.cjs";
 
 //#region src/plugins/head/build.d.ts
 /**

package/dist/plugins/head/build.d.mts

@@ -1,4 +1,4 @@
-import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-kuZFxqV7.mjs";
+import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-DKgZfRAO.mjs";
 
 //#region src/plugins/head/build.d.ts
 /**

package/dist/plugins/head/build.mjs

@@ -1,4 +1,4 @@
-import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "../../primitives-gO5i1tD8.mjs";
+import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "../../primitives-Dhko-oLM.mjs";
 
 //#region src/plugins/head/build.ts
 /** @file Sub-path /build entry — pure build-time helpers (no plugin state access). */

package/dist/plugins/spa/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_factory = require('../../factory-CixCpR9C.cjs');
+const require_factory = require('../../factory-CMOo4n6a.cjs');
 
 //#region src/plugins/spa/index.ts
 /** @file spa plugin: Very Complex tier — router + head + progress + components sub-modules. */

package/dist/plugins/spa/index.d.cts

@@ -1,4 +1,4 @@
-import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-D0m7Xil2.cjs";
+import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-k-YoScgB.cjs";
 import * as _moku_labs_core0 from "@moku-labs/core";
 
 //#region src/plugins/spa/index.d.ts

package/dist/plugins/spa/index.d.mts

@@ -1,4 +1,4 @@
-import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-BBVQO5ZG.mjs";
+import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-DRFGSslp.mjs";
 import * as _moku_labs_core0 from "@moku-labs/core";
 
 //#region src/plugins/spa/index.d.ts

package/dist/plugins/spa/index.mjs

@@ -1,4 +1,4 @@
-import { a as createSpaApi, i as createClientRuntime, n as createSpaState, o as head, p as createPlugin, r as registerSpaEvents, s as router, t as createComponent } from "../../factory-DwpBwjDk.mjs";
+import { a as createSpaApi, i as createClientRuntime, n as createSpaState, o as head, p as createPlugin, r as registerSpaEvents, s as router, t as createComponent } from "../../factory-DiKypQqs.mjs";
 
 //#region src/plugins/spa/index.ts
 /** @file spa plugin: Very Complex tier — router + head + progress + components sub-modules. */

package/dist/{primitives-BBo4wxUL.d.cts → primitives-DKgZfRAO.d.mts}

@@ -1,4 +1,6 @@
-//#region src/plugins/head/types.d.ts
+declare namespace types_d_exports {
+  export { ArticleMeta, HeadApi, HeadConfig, HeadElement, HeadPluginConfig, HeadState, OGFontConfig, OGImageConfig, RenderContext };
+}
 /** @file head plugin types — HeadElement, HeadConfig, ArticleMeta, OGImageConfig. */
 type HeadElement = {
   tag: 'meta' | 'link' | 'script' | 'title';
@@ -66,4 +68,4 @@ declare const hreflang: (locale: string, url: string) => HeadElement;
 declare const twitter: (name: string, content: string) => HeadElement;
 declare const feedLink: (title: string, url: string, type?: "rss" | "atom") => HeadElement;
 //#endregion
-export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };
+export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, types_d_exports as m, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };

package/dist/{primitives-kuZFxqV7.d.mts → primitives-yZqQkOVR.d.cts}

@@ -1,4 +1,6 @@
-//#region src/plugins/head/types.d.ts
+declare namespace types_d_exports {
+  export { ArticleMeta, HeadApi, HeadConfig, HeadElement, HeadPluginConfig, HeadState, OGFontConfig, OGImageConfig, RenderContext };
+}
 /** @file head plugin types — HeadElement, HeadConfig, ArticleMeta, OGImageConfig. */
 type HeadElement = {
   tag: 'meta' | 'link' | 'script' | 'title';
@@ -66,4 +68,4 @@ declare const hreflang: (locale: string, url: string) => HeadElement;
 declare const twitter: (name: string, content: string) => HeadElement;
 declare const feedLink: (title: string, url: string, type?: "rss" | "atom") => HeadElement;
 //#endregion
-export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };
+export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, types_d_exports as m, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };

package/dist/{project-C1vtMxE8.cjs → project-B8z4jeMC.cjs}

@@ -5,6 +5,19 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") {
 		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
@@ -25,7 +38,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_factory = require('./factory-CixCpR9C.cjs');
+const require_factory = require('./factory-CMOo4n6a.cjs');
+const require_wrangler = require('./wrangler-Bomk9mU-.cjs');
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -442,7 +456,7 @@ const wireContentApi = (ctx) => {
 //#endregion
 //#region src/plugins/content/index.ts
 /** @file content plugin: markdown pipeline + invalidate(). Complex tier. */
-const defaultConfig$1 = {
+const defaultConfig$2 = {
 	dir: "",
 	trustedContent: false,
 	rehypePlugins: [],
@@ -450,7 +464,7 @@ const defaultConfig$1 = {
 };
 const content = require_factory.createPlugin("content", {
 	depends: [require_factory.i18n],
-	config: defaultConfig$1,
+	config: defaultConfig$2,
 	events: (register) => ({
 		"content:ready": register("Articles loaded"),
 		"content:invalidated": register("Paths invalidated")
@@ -981,7 +995,7 @@ const validateBuildConfig = (ctx) => {
 //#endregion
 //#region src/plugins/build/index.ts
 /** @file build plugin: app.build.run() orchestrator + in-memory manifest. Complex tier. */
-const defaultConfig = {
+const defaultConfig$1 = {
 	outdir: "dist",
 	mode: "production",
 	renderMode: "hybrid"
@@ -993,7 +1007,7 @@ const build = require_factory.createPlugin("build", {
 		require_factory.router,
 		require_factory.head
 	],
-	config: defaultConfig,
+	config: defaultConfig$1,
 	events: (register) => ({
 		"build:phase": register("Build phase started"),
 		"build:complete": register("Build pipeline complete")
@@ -1003,6 +1017,228 @@ const build = require_factory.createPlugin("build", {
 	onInit: validateBuildConfig
 });
 
+//#endregion
+//#region src/plugins/build/types.ts
+var types_exports$9 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/content/types.ts
+var types_exports$8 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/deploy/api.ts
+/** @file deploy plugin API factory — orchestrates app.deploy.run(). */
+/** Free-tier Cloudflare Pages limit. The paid tier (100,000) requires extra env. */
+const FREE_TIER_FILE_LIMIT = 2e4;
+/** Per-file size cap for Cloudflare Pages (25 MiB). */
+const MAX_FILE_SIZE_BYTES = 25 * 1024 * 1024;
+const sanitizedProcessEnv = () => {
+	const out = {};
+	for (const [k, v] of Object.entries(process.env)) if (typeof v === "string") out[k] = v;
+	return out;
+};
+const checkFile = (path, state) => {
+	state.count += 1;
+	if ((0, node_fs.statSync)(path).size > MAX_FILE_SIZE_BYTES) state.oversize = path;
+};
+const walkOutdir = (current, state) => {
+	for (const entry of (0, node_fs.readdirSync)(current, { withFileTypes: true })) {
+		if (state.oversize !== null) return;
+		const path = (0, node_path.join)(current, entry.name);
+		if (entry.isDirectory()) walkOutdir(path, state);
+		else if (entry.isFile()) checkFile(path, state);
+	}
+};
+/** Recursively count files and check max size under `dir`. Short-circuits on first oversize file. */
+const inspectOutdir = (dir) => {
+	const state = {
+		count: 0,
+		oversize: null
+	};
+	walkOutdir(dir, state);
+	return {
+		fileCount: state.count,
+		oversize: state.oversize
+	};
+};
+/** Throw if any pre-flight constraint on the resolved outdir fails. */
+const assertOutdirReady = (outdir, outdirAbsolute) => {
+	if (!(0, node_fs.existsSync)(outdirAbsolute)) throw new Error(`deploy: outdir "${outdir}" does not exist — run \`moku build\` first (or pass --build).`);
+	const inspection = inspectOutdir(outdirAbsolute);
+	if (inspection.fileCount === 0) throw new Error(`deploy: outdir "${outdir}" is empty — nothing to deploy.`);
+	if (inspection.fileCount > FREE_TIER_FILE_LIMIT) throw new Error(`deploy: outdir contains ${inspection.fileCount} files; free tier limit is ${FREE_TIER_FILE_LIMIT}. Paid tier supports up to 100,000 files (requires PAGES_WRANGLER_MAJOR_VERSION=4 in CI env).`);
+	if (inspection.oversize !== null) throw new Error(`deploy: file "${inspection.oversize}" exceeds Cloudflare Pages per-file limit (25 MiB).`);
+	return inspection;
+};
+/** Resolve outdir from `wrangler.jsonc#pages_build_output_dir` or throw if missing. */
+const resolveOutdir = (cwd) => {
+	const wrangler = require_wrangler.readWranglerConfig(cwd);
+	if (wrangler === null) throw new Error("deploy: wrangler.jsonc not found — run `moku deploy init` first");
+	return wrangler.pages_build_output_dir;
+};
+/**
+* Build the public `app.deploy` API surface.
+*
+* `run()` reads outdir from `wrangler.jsonc#pages_build_output_dir` (the
+* deploy-time SSoT — `DeployConfig.outdir` is only the init-time default).
+* Errors with a "run `moku deploy init` first" message if `wrangler.jsonc` is
+* missing.
+*
+* @param ctx - The deploy plugin context.
+* @param deps - Optional injectables for testing.
+* @returns The {@link DeployApi}.
+*/
+/** Trigger the optional pre-build hook for `--build`. */
+const maybeRunBuild = async (deps, build) => {
+	if (build !== true) return;
+	if (deps.runBuild === void 0) throw new Error("deploy: --build flag set but no `runBuild` hook provided to createDeployApi. Wire `app.build.run` through the plugin index.");
+	await deps.runBuild();
+};
+/** Invoke wrangler and shape its output into a {@link DeployResult}. */
+const invokeWranglerForDeploy = async (ctx, deps, outdir, branch, startedAt, now) => {
+	const env = deps.env ?? sanitizedProcessEnv();
+	const info = require_wrangler.extractDeploymentInfo((await require_wrangler.runWrangler(require_wrangler.buildWranglerArgs(ctx.config.target, outdir, branch), env, deps.spawn)).ndJson);
+	if (info === null) ctx.log.warn("deploy:no-deployment-info", { note: "wrangler exited 0 but no deployment URL/id was found in ND-JSON output." });
+	return {
+		url: info?.url ?? "",
+		deploymentId: info?.deploymentId ?? "",
+		branch,
+		durationMs: now() - startedAt
+	};
+};
+/**
+* Build the public `app.deploy` API surface.
+*
+* `run()` reads outdir from `wrangler.jsonc#pages_build_output_dir` (the
+* deploy-time SSoT — `DeployConfig.outdir` is only the init-time default).
+* Errors with a "run `moku deploy init` first" message if `wrangler.jsonc` is
+* missing.
+*
+* @param ctx - The deploy plugin context.
+* @param deps - Optional injectables for testing.
+* @returns The {@link DeployApi}.
+*/
+const createDeployApi = (ctx, deps = {}) => {
+	const cwd = deps.cwd ?? process.cwd();
+	const now = deps.now ?? Date.now;
+	const run = async (options = {}) => {
+		await maybeRunBuild(deps, options.build);
+		const outdir = resolveOutdir(cwd);
+		const branch = options.branch ?? ctx.config.productionBranch;
+		const inspection = assertOutdirReady(outdir, (0, node_path.join)(cwd, outdir));
+		const deployResult = await invokeWranglerForDeploy(ctx, deps, outdir, branch, now(), now);
+		ctx.state.lastDeployment = deployResult;
+		ctx.log.info("deploy:complete", {
+			url: deployResult.url,
+			branch,
+			durationMs: deployResult.durationMs,
+			files: inspection.fileCount
+		});
+		return deployResult;
+	};
+	const getLastDeployment = () => ctx.state.lastDeployment;
+	return {
+		run,
+		getLastDeployment
+	};
+};
+
+//#endregion
+//#region src/plugins/deploy/state.ts
+/**
+* Create a fresh deploy state.
+*
+* `lastDeployment` starts as `null` and is set after the first successful
+* `app.deploy.run()` call. State is per-`createApp` instance — never a module
+* singleton — so parallel vitest workers do not share state.
+*
+* @returns A new {@link DeployState}.
+*/
+const createDeployState = () => ({ lastDeployment: null });
+
+//#endregion
+//#region src/plugins/deploy/validate.ts
+/** @file deploy plugin onInit hook — config-shape validation only. NEVER spawns wrangler. */
+const VALID_TARGETS = new Set(["pages", "workers"]);
+/**
+* Validate `DeployConfig` shape at `onInit` time.
+*
+* Checks: `target` is in the valid enum; `outdir` is a non-empty string and
+* does not escape the current working directory via `..` traversal;
+* `productionBranch` is a non-empty string.
+*
+* Does NOT check wrangler presence — `ensureWrangler()` in `wrangler.ts` is
+* lazy and called only on first `run()`/`init()` invocation. This keeps
+* `moku dev`, `moku build`, and `moku preview` unaffected by wrangler absence.
+*
+* @param ctx - The deploy plugin context.
+* @throws Error when any config field is structurally invalid.
+*/
+const validateDeployConfig = (ctx) => {
+	const { target, outdir, productionBranch } = ctx.config;
+	if (!VALID_TARGETS.has(target)) throw new Error(`deploy: target must be "pages" or "workers" (got "${target}")`);
+	if (typeof outdir !== "string" || outdir === "") throw new Error("deploy: outdir must be a non-empty string");
+	const resolved = (0, node_path.isAbsolute)(outdir) ? outdir : (0, node_path.resolve)(process.cwd(), outdir);
+	const cwd = process.cwd();
+	if (!resolved.startsWith(cwd)) throw new Error(`deploy: outdir "${outdir}" must resolve inside the project root (got "${resolved}")`);
+	if (typeof productionBranch !== "string" || productionBranch === "") throw new Error("deploy: productionBranch must be a non-empty string");
+};
+
+//#endregion
+//#region src/plugins/deploy/index.ts
+/** @file deploy plugin: Cloudflare Pages publishing via wrangler subprocess. Standard tier.
+*
+* Wave 4 placement alongside `build`. `depends: []` — no plugin-graph edge to `build`;
+* ordering via the framework's plugin registration array is sufficient. Consumers who want
+* auto-outdir resolution must register the `build` plugin alongside this one; otherwise the
+* `'dist'` default fallback applies.
+*
+* @see README.md
+*/
+const defaultConfig = {
+	target: "pages",
+	outdir: "dist",
+	productionBranch: "main"
+};
+const deploy = require_factory.createPlugin("deploy", {
+	config: defaultConfig,
+	createState: createDeployState,
+	api: createDeployApi,
+	onInit: validateDeployConfig
+});
+
+//#endregion
+//#region src/plugins/deploy/types.ts
+var types_exports$7 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/env/types.ts
+var types_exports$6 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/head/types.ts
+var types_exports$5 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/i18n/types.ts
+var types_exports$4 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/log/types.ts
+var types_exports$3 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/router/types.ts
+var types_exports$2 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/site/types.ts
+var types_exports$1 = /* @__PURE__ */ __exportAll({});
+
+//#endregion
+//#region src/plugins/spa/types.ts
+var types_exports = /* @__PURE__ */ __exportAll({});
+
 //#endregion
 //#region src/project.ts
 /**
@@ -1073,9 +1309,75 @@ Object.defineProperty(exports, 'content', {
     return content;
   }
 });
+Object.defineProperty(exports, 'deploy', {
+  enumerable: true,
+  get: function () {
+    return deploy;
+  }
+});
 Object.defineProperty(exports, 'project', {
   enumerable: true,
   get: function () {
     return project;
   }
+});
+Object.defineProperty(exports, 'types_exports', {
+  enumerable: true,
+  get: function () {
+    return types_exports;
+  }
+});
+Object.defineProperty(exports, 'types_exports$1', {
+  enumerable: true,
+  get: function () {
+    return types_exports$1;
+  }
+});
+Object.defineProperty(exports, 'types_exports$2', {
+  enumerable: true,
+  get: function () {
+    return types_exports$2;
+  }
+});
+Object.defineProperty(exports, 'types_exports$3', {
+  enumerable: true,
+  get: function () {
+    return types_exports$3;
+  }
+});
+Object.defineProperty(exports, 'types_exports$4', {
+  enumerable: true,
+  get: function () {
+    return types_exports$4;
+  }
+});
+Object.defineProperty(exports, 'types_exports$5', {
+  enumerable: true,
+  get: function () {
+    return types_exports$5;
+  }
+});
+Object.defineProperty(exports, 'types_exports$6', {
+  enumerable: true,
+  get: function () {
+    return types_exports$6;
+  }
+});
+Object.defineProperty(exports, 'types_exports$7', {
+  enumerable: true,
+  get: function () {
+    return types_exports$7;
+  }
+});
+Object.defineProperty(exports, 'types_exports$8', {
+  enumerable: true,
+  get: function () {
+    return types_exports$8;
+  }
+});
+Object.defineProperty(exports, 'types_exports$9', {
+  enumerable: true,
+  get: function () {
+    return types_exports$9;
+  }
 });