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

package/dist/{project-C1vtMxE8.cjs → project-1pAh4RxJ.cjs}

@@ -25,7 +25,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-DVcAQYEZ.cjs');
+const require_wrangler = require('./wrangler-BHdkyMRj.cjs');
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -442,7 +443,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 +451,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 +982,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 +994,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 +1004,188 @@ const build = require_factory.createPlugin("build", {
 	onInit: validateBuildConfig
 });
 
+//#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/project.ts
 /**
@@ -1073,6 +1256,12 @@ Object.defineProperty(exports, 'content', {
     return content;
   }
 });
+Object.defineProperty(exports, 'deploy', {
+  enumerable: true,
+  get: function () {
+    return deploy;
+  }
+});
 Object.defineProperty(exports, 'project', {
   enumerable: true,
   get: function () {

package/dist/{project-BTNUWbGQ.mjs → project-BaG_ipVz.mjs}

@@ -1,7 +1,8 @@
 import { l as site, o as head, p as createPlugin, s as router, u as i18n } from "./factory-DwpBwjDk.mjs";
-import { existsSync, statSync } from "node:fs";
+import { a as runWrangler, c as readWranglerConfig, i as extractDeploymentInfo, r as buildWranglerArgs } from "./wrangler-Coyrznz4.mjs";
+import { existsSync, readdirSync, statSync } from "node:fs";
 import { readFile, readdir } from "node:fs/promises";
-import { resolve, sep } from "node:path";
+import { isAbsolute, join, resolve, sep } from "node:path";
 import matter from "gray-matter";
 import rehypeShiki from "@shikijs/rehype";
 import rehypeRaw from "rehype-raw";
@@ -404,7 +405,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: [],
@@ -412,7 +413,7 @@ const defaultConfig$1 = {
 };
 const content = createPlugin("content", {
 	depends: [i18n],
-	config: defaultConfig$1,
+	config: defaultConfig$2,
 	events: (register) => ({
 		"content:ready": register("Articles loaded"),
 		"content:invalidated": register("Paths invalidated")
@@ -943,7 +944,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"
@@ -955,7 +956,7 @@ const build = createPlugin("build", {
 		router,
 		head
 	],
-	config: defaultConfig,
+	config: defaultConfig$1,
 	events: (register) => ({
 		"build:phase": register("Build phase started"),
 		"build:complete": register("Build pipeline complete")
@@ -965,6 +966,188 @@ const build = createPlugin("build", {
 	onInit: validateBuildConfig
 });
 
+//#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 (statSync(path).size > MAX_FILE_SIZE_BYTES) state.oversize = path;
+};
+const walkOutdir = (current, state) => {
+	for (const entry of readdirSync(current, { withFileTypes: true })) {
+		if (state.oversize !== null) return;
+		const 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 (!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 = 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 = extractDeploymentInfo((await runWrangler(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, 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 = isAbsolute(outdir) ? outdir : 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 = createPlugin("deploy", {
+	config: defaultConfig,
+	createState: createDeployState,
+	api: createDeployApi,
+	onInit: validateDeployConfig
+});
+
 //#endregion
 //#region src/project.ts
 /**
@@ -1017,4 +1200,4 @@ function extractSpecs(routes) {
 }
 
 //#endregion
-export { build as n, content as r, project as t };
+export { content as i, deploy as n, build as r, project as t };

package/dist/{route-builder-Lv6HUVvP.d.cts → route-builder-CKvvehVO.d.cts}

@@ -150,6 +150,54 @@ type I18nApi<TLocales extends readonly string[] = readonly string[]> = {
   t(locale: TLocales[number], key: string): string;
 };
 //#endregion
+//#region src/plugins/content/types.d.ts
+type Frontmatter = {
+  title: string;
+  date: string;
+  description: string;
+  tags: string[];
+  language: string;
+  author?: string;
+  draft?: boolean;
+  [key: string]: unknown;
+};
+type ComputedFields = {
+  contentId: string;
+  readingTimeMinutes: number;
+  wordCount: number;
+};
+type Article = {
+  slug: string;
+  locale: string;
+  frontmatter: Frontmatter;
+  html: string;
+  computed: ComputedFields;
+};
+type RehypePluginEntry = readonly [unknown, Record<string, unknown>?];
+type RemarkPluginEntry = readonly [unknown, Record<string, unknown>?];
+type ContentConfig = {
+  dir: string;
+  defaultAuthor?: string;
+  trustedContent: boolean;
+  rehypePlugins?: RehypePluginEntry[];
+  remarkPlugins?: RemarkPluginEntry[];
+};
+type ContentState = {
+  processor: Processor | null;
+  articles: Map<string, Map<string, Article>>;
+  slugs: string[] | null;
+  lastPaths: Set<string>; /** Paths marked stale by `invalidate()` — re-read on next `loadAll()` then cleared. */
+  dirtyPaths: Set<string>;
+};
+type ContentApi = {
+  loadAll(): Promise<Map<string, Article[]>>;
+  load(slug: string, locale: string): Promise<Article | null>;
+  discoverSlugs(): Promise<string[]>;
+  render(markdown: string): Promise<string>;
+  invalidate(paths: string[]): void;
+  reset(): void;
+};
+//#endregion
 //#region src/plugins/router/types.d.ts
 /** @file router plugin types — RouteSpec (non-accumulating), RouteBuilder, RouterApi. */
 /** Render context passed to route handlers. */
@@ -222,54 +270,6 @@ type RouterApi<Routes extends Record<string, RouteSpec> = Record<string, RouteSp
   entries(): ReadonlyArray<RouteEntry>;
 };
 //#endregion
-//#region src/plugins/content/types.d.ts
-type Frontmatter = {
-  title: string;
-  date: string;
-  description: string;
-  tags: string[];
-  language: string;
-  author?: string;
-  draft?: boolean;
-  [key: string]: unknown;
-};
-type ComputedFields = {
-  contentId: string;
-  readingTimeMinutes: number;
-  wordCount: number;
-};
-type Article = {
-  slug: string;
-  locale: string;
-  frontmatter: Frontmatter;
-  html: string;
-  computed: ComputedFields;
-};
-type RehypePluginEntry = readonly [unknown, Record<string, unknown>?];
-type RemarkPluginEntry = readonly [unknown, Record<string, unknown>?];
-type ContentConfig = {
-  dir: string;
-  defaultAuthor?: string;
-  trustedContent: boolean;
-  rehypePlugins?: RehypePluginEntry[];
-  remarkPlugins?: RemarkPluginEntry[];
-};
-type ContentState = {
-  processor: Processor | null;
-  articles: Map<string, Map<string, Article>>;
-  slugs: string[] | null;
-  lastPaths: Set<string>; /** Paths marked stale by `invalidate()` — re-read on next `loadAll()` then cleared. */
-  dirtyPaths: Set<string>;
-};
-type ContentApi = {
-  loadAll(): Promise<Map<string, Article[]>>;
-  load(slug: string, locale: string): Promise<Article | null>;
-  discoverSlugs(): Promise<string[]>;
-  render(markdown: string): Promise<string>;
-  invalidate(paths: string[]): void;
-  reset(): void;
-};
-//#endregion
 //#region src/plugins/build/types.d.ts
 type BuildConfig = {
   outdir: string;
@@ -299,6 +299,70 @@ type BuildApi = {
   getManifest(): Readonly<BundleManifest> | null;
 };
 //#endregion
+//#region src/plugins/deploy/types.d.ts
+/** @file deploy plugin types — DeployConfig, DeployState, DeployResult, RunOptions, DeployApi. */
+/**
+ * Deployment target. Phase 1 ships `'pages'` only; `'workers'` is reserved
+ * for the Workers Static Assets expansion path and `buildWranglerArgs`
+ * throws "not implemented in Phase 1" if invoked with it.
+ */
+type DeployTarget = 'pages' | 'workers';
+/**
+ * deploy plugin config.
+ *
+ * `outdir` precedence at deploy time: `wrangler.jsonc#pages_build_output_dir`
+ * (written by `moku deploy init`) — this is the deploy-time single source of
+ * truth, NOT `DeployConfig.outdir`. The config field is the *init-time* default;
+ * once `wrangler.jsonc` exists, it owns the value.
+ *
+ * Forbidden: reading the `build` plugin's config via `ctx.has(build)` /
+ * `ctx.require(build).config.outdir`. The core `HasFunction` takes a name
+ * string and returns a non-narrowing boolean; `RequireFunction` returns the
+ * API surface only (`BuildApi = { run, getManifest }`). The optional coupling
+ * is a `ctx.log.warn` at init time when divergence is detectable through the
+ * directly-imported `build` plugin instance, never via the core API.
+ */
+type DeployConfig = {
+  /** Deployment target. Default: `'pages'`. */target: DeployTarget; /** Build output directory used at init only. Default: `'dist'` (matches build plugin default). */
+  outdir: string; /** Production branch name. Default: `'main'`. Overwritten by `init` via `git symbolic-ref`. */
+  productionBranch: string; /** Optional explicit override for the Cloudflare Pages project name. Default: derived from `site.name`. */
+  projectName?: string;
+};
+/**
+ * In-memory deploy plugin state.
+ *
+ * `lastDeployment` is reset per `createApp()` call and captures the most
+ * recent deploy's metadata (URL, deployment ID, branch, duration). Used by
+ * the future REST-API-based rollback command (deferred from Phase 1).
+ */
+type DeployState = {
+  lastDeployment: DeployResult | null;
+};
+/** Result of a successful `app.deploy.run()` invocation. */
+type DeployResult = {
+  /** Production URL (e.g., `https://<project>.pages.dev`) or branch-alias preview URL. */url: string; /** Cloudflare deployment ID — captured for future rollback support. */
+  deploymentId: string; /** Branch the deploy was published to. */
+  branch: string; /** Total subprocess duration in milliseconds (init + upload + finalize). */
+  durationMs: number;
+};
+/**
+ * Options accepted by `app.deploy.run()`.
+ *
+ * `branch` overrides the production branch from wrangler.jsonc (defaults to
+ * `DeployConfig.productionBranch`). `build` runs `app.build.run()` first
+ * when true — used only for local convenience; the generated CI workflow
+ * always issues the two-step `moku build` then `moku deploy` pattern.
+ */
+type RunOptions = {
+  /** Override the production branch for this deploy. */branch?: string; /** Run `app.build.run()` first (local convenience). Default: `false`. */
+  build?: boolean;
+};
+/** Public deploy plugin API surface, attached as `app.deploy`. */
+type DeployApi = {
+  /** Run a deploy. Reads outdir from wrangler.jsonc; errors if missing. */run(options?: RunOptions): Promise<DeployResult>; /** Read the last deployment result without re-running. */
+  getLastDeployment(): Readonly<DeployResult> | null;
+};
+//#endregion
 //#region src/project.d.ts
 /**
  * Map each consumer `RouteBuilder` to the `RouteSpec` shape the router stores.
@@ -346,4 +410,4 @@ type WebAppConfig<Routes extends Record<string, RouteBuilder>> = {
  */
 declare function route(pattern: string): RouteBuilder;
 //#endregion
-export { EnvApi as C, EnvVarSpec as D, EnvState as E, LogApi as O, Events as S, EnvProvider as T, I18nConfig as _, BuildConfig as a, SiteState as b, ContentApi as c, RouteBuilder as d, RouteSpec as f, I18nApi as g, RouterState as h, BuildApi as i, LogState as k, ContentConfig as l, RouterConfig as m, RouteSpecMap as n, BuildState as o, RouterApi as p, WebAppConfig as r, Article as s, route as t, ContentState as u, I18nState as v, EnvConfig as w, Config as x, SiteApi as y };
+export { EnvVarSpec as A, SiteState as C, EnvConfig as D, EnvApi as E, LogState as M, EnvProvider as O, SiteApi as S, Events as T, ContentConfig as _, DeployConfig as a, I18nConfig as b, BuildConfig as c, RouteSpec as d, RouterApi as f, ContentApi as g, Article as h, DeployApi as i, LogApi as j, EnvState as k, BuildState as l, RouterState as m, RouteSpecMap as n, DeployState as o, RouterConfig as p, WebAppConfig as r, BuildApi as s, route as t, RouteBuilder as u, ContentState as v, Config as w, I18nState as x, I18nApi as y };

package/dist/test.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_project = require('./project-C1vtMxE8.cjs');
-const require_factory = require('./factory-CixCpR9C.cjs');
+const require_project = require('./project-1pAh4RxJ.cjs');
+const require_factory = require('./factory-DVcAQYEZ.cjs');
 const require_index = require('./index.cjs');
 let _moku_labs_core = require("@moku-labs/core");