@moku-labs/web 1.3.0 → 1.4.0

package/dist/browser.d.mts

@@ -2028,11 +2028,18 @@ type Config = {
  *
  * @example
  * ```ts
- * { articles: new Map() }
+ * { articles: new Map(), loadedAll: null }
  * ```
  */
 type State = {
   /** Article cache keyed locale -> (slug -> Article). Starts empty. */articles: Map<string, Map<string, Article>>;
+  /**
+   * Memoized full `loadAll()` result, or `null` when not yet loaded / invalidated. List-route
+   * loaders call `loadAll()` once PER PAGE, so without this every page re-reads + re-renders
+   * every article (the dev-loop killer). The memo makes repeated calls O(1); `invalidate()`
+   * clears it so a dev rebuild reloads (re-resolving only the changed slugs). Starts `null`.
+   */
+  loadedAll: Map<string, Article[]> | null;
 };
 /**
  * Notification-only events emitted by the content plugin.
@@ -2082,11 +2089,13 @@ type ContentApiContext = {
  */
 type LoadAllOptions = {
   /**
-   * Reuse already-cached articles for slugs NOT dropped by a preceding `invalidate()`,
-   * re-reading + re-rendering (Shiki) ONLY the invalidated (dirty) articles. The
-   * post-sort `contentId` ordinals are always recomputed across the full set, so order +
-   * ids match a full load. Default `false` (a full load that re-reads every article).
-   * Used by dev incremental rebuilds; a fresh process / production build never reuses.
+   * Reuse the per-build memo + per-slug cache (re-resolving only slugs a preceding
+   * `invalidate()` dropped). Default `true` — this is what keeps repeated `loadAll()` calls
+   * (a list route's loader runs once per page) cheap, and makes a dev rebuild re-render only
+   * changed articles. Set `false` to force a FRESH full reload (cold build / an
+   * unclassifiable change), which re-reads + re-renders every article and rebuilds the memo.
+   * The post-sort `contentId` ordinals are always recomputed across the full set, so order +
+   * ids match a full load either way.
    */
   reuse?: boolean;
 };
@@ -2100,10 +2109,13 @@ type LoadAllOptions = {
  */
 type Api = {
   /**
-   * Load every article across every active locale, returning a locale-keyed
-   * map of date-descending Article arrays. Emits content:ready.
+   * Load every article across every active locale, returning a locale-keyed map of
+   * date-descending Article arrays. Emits content:ready (once per actual load). Cache-first
+   * + memoized: repeated calls (e.g. a list route's loader on every page) return the SAME
+   * cached result with no re-read — so treat the result as READ-ONLY (do not sort/mutate it
+   * in place; slice/copy first). Pass `{ reuse: false }` to force a fresh full reload.
    *
-   * @param options - Optional load behaviour ({@link LoadAllOptions}); omit for a full load.
+   * @param options - Optional load behaviour ({@link LoadAllOptions}); default reuses the cache.
    */
   loadAll(options?: LoadAllOptions): Promise<Map<string, Article[]>>;
   /**

package/dist/browser.mjs

@@ -4409,12 +4409,15 @@ function createContentApi(ctx) {
 		* Load every article across every active locale (locale fallback, production
 		* draft exclusion, date sort, `contentId` after sort), cache them, emit `content:ready`.
 		*
-		* With `{ reuse: true }` (dev incremental rebuild) cached articles are reused for
-		* every slug a preceding `invalidate()` did not drop, so only the dirty articles
-		* re-read + re-run the Markdown/Shiki pipeline; the `contentId` ordinals are still
-		* recomputed across the FULL sorted set, so ids + order match a full load.
+		* Cache-first by default: repeated calls return the per-build memo (list-route loaders
+		* call this once PER PAGE — without the memo every page would re-read + re-render every
+		* article, the dev-loop killer), and a rebuild after `invalidate()` re-resolves only the
+		* dropped slugs while reusing the cached articles for the rest (`contentId` ordinals are
+		* still recomputed across the FULL sorted set, so ids + order match a full load). Pass
+		* `{ reuse: false }` to force a FRESH full reload (cold build / an unclassifiable change
+		* where the caller cannot pinpoint what changed) — this bypasses the memo + per-slug cache.
 		*
-		* @param options - Optional load behaviour (`reuse`); omit for a full load.
+		* @param options - Optional load behaviour (`reuse`, default `true`).
 		* @returns A locale-keyed map of date-descending articles.
 		* @example
 		* ```ts
@@ -4422,7 +4425,9 @@ function createContentApi(ctx) {
 		* ```
 		*/
 		async loadAll(options) {
-			const reuse = options?.reuse === true;
+			const reuse = options?.reuse !== false;
+			const memo = ctx.state.loadedAll;
+			if (reuse && memo !== null) return memo;
 			const slugs = await ctx.provider.slugs();
 			const locales = ctx.locales();
 			const result = /* @__PURE__ */ new Map();
@@ -4440,6 +4445,7 @@ function createContentApi(ctx) {
 				result.set(locale, present);
 				total += present.length;
 			}
+			ctx.state.loadedAll = result;
 			ctx.emit("content:ready", {
 				locales,
 				articleCount: total
@@ -4503,6 +4509,7 @@ function createContentApi(ctx) {
 				if (slug === void 0) continue;
 				for (const cache of ctx.state.articles.values()) cache.delete(slug);
 			}
+			if (accepted.length > 0) ctx.state.loadedAll = null;
 			ctx.emit("content:invalidated", { paths: accepted });
 		},
 		/**
@@ -4572,14 +4579,17 @@ const contentEvents = (register) => ({
 * @param _ctx - Minimal context with global and config.
 * @param _ctx.global - Global plugin registry.
 * @param _ctx.config - Resolved plugin configuration.
-* @returns Fresh content shell state: an empty article cache.
+* @returns Fresh content shell state: an empty article cache + an empty loadAll memo.
 * @example
 * ```ts
 * const state = createContentState({ global: {}, config: { providers: [] } });
 * ```
 */
 function createContentState(_ctx) {
-	return { articles: /* @__PURE__ */ new Map() };
+	return {
+		articles: /* @__PURE__ */ new Map(),
+		loadedAll: null
+	};
 }
 //#endregion
 //#region src/plugins/content/validate.ts

package/dist/index.cjs

@@ -1349,12 +1349,15 @@ function createContentApi(ctx) {
 		* Load every article across every active locale (locale fallback, production
 		* draft exclusion, date sort, `contentId` after sort), cache them, emit `content:ready`.
 		*
-		* With `{ reuse: true }` (dev incremental rebuild) cached articles are reused for
-		* every slug a preceding `invalidate()` did not drop, so only the dirty articles
-		* re-read + re-run the Markdown/Shiki pipeline; the `contentId` ordinals are still
-		* recomputed across the FULL sorted set, so ids + order match a full load.
+		* Cache-first by default: repeated calls return the per-build memo (list-route loaders
+		* call this once PER PAGE — without the memo every page would re-read + re-render every
+		* article, the dev-loop killer), and a rebuild after `invalidate()` re-resolves only the
+		* dropped slugs while reusing the cached articles for the rest (`contentId` ordinals are
+		* still recomputed across the FULL sorted set, so ids + order match a full load). Pass
+		* `{ reuse: false }` to force a FRESH full reload (cold build / an unclassifiable change
+		* where the caller cannot pinpoint what changed) — this bypasses the memo + per-slug cache.
 		*
-		* @param options - Optional load behaviour (`reuse`); omit for a full load.
+		* @param options - Optional load behaviour (`reuse`, default `true`).
 		* @returns A locale-keyed map of date-descending articles.
 		* @example
 		* ```ts
@@ -1362,7 +1365,9 @@ function createContentApi(ctx) {
 		* ```
 		*/
 		async loadAll(options) {
-			const reuse = options?.reuse === true;
+			const reuse = options?.reuse !== false;
+			const memo = ctx.state.loadedAll;
+			if (reuse && memo !== null) return memo;
 			const slugs = await ctx.provider.slugs();
 			const locales = ctx.locales();
 			const result = /* @__PURE__ */ new Map();
@@ -1380,6 +1385,7 @@ function createContentApi(ctx) {
 				result.set(locale, present);
 				total += present.length;
 			}
+			ctx.state.loadedAll = result;
 			ctx.emit("content:ready", {
 				locales,
 				articleCount: total
@@ -1443,6 +1449,7 @@ function createContentApi(ctx) {
 				if (slug === void 0) continue;
 				for (const cache of ctx.state.articles.values()) cache.delete(slug);
 			}
+			if (accepted.length > 0) ctx.state.loadedAll = null;
 			ctx.emit("content:invalidated", { paths: accepted });
 		},
 		/**
@@ -1512,14 +1519,17 @@ const contentEvents = (register) => ({
 * @param _ctx - Minimal context with global and config.
 * @param _ctx.global - Global plugin registry.
 * @param _ctx.config - Resolved plugin configuration.
-* @returns Fresh content shell state: an empty article cache.
+* @returns Fresh content shell state: an empty article cache + an empty loadAll memo.
 * @example
 * ```ts
 * const state = createContentState({ global: {}, config: { providers: [] } });
 * ```
 */
 function createContentState(_ctx) {
-	return { articles: /* @__PURE__ */ new Map() };
+	return {
+		articles: /* @__PURE__ */ new Map(),
+		loadedAll: null
+	};
 }
 //#endregion
 //#region src/plugins/content/validate.ts
@@ -3832,7 +3842,7 @@ const DEFAULT_BODY = "<h1>404</h1><p>The page you requested could not be found.<
 * ```
 */
 function wrap(body) {
-	return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>404 — Not Found</title></head><body>${body}</body></html>`;
+	return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>404 — Not Found</title></head><body>${body}</body></html>`;
 }
 /**
 * Emits `outDir/404.html`. When `config.notFound` is `true`, writes the built-in
@@ -4516,6 +4526,8 @@ const HEAD_PLACEHOLDER = "<!--moku:head-->";
 const BODY_PLACEHOLDER = "<!--moku:body-->";
 /** Template placeholder for the injected asset `<link>`/`<script>` tags. */
 const ASSETS_PLACEHOLDER = "<!--moku:assets-->";
+/** Template placeholder for the page's locale (`<html lang>`). */
+const LANG_PLACEHOLDER = "<!--moku:lang-->";
 /**
 * Read the bundle phase's hashed asset manifest for one kind from `state.buildCache`
 * as a typed {@link BuildCacheEntry} (no `Map<string, unknown>` reads).
@@ -4563,14 +4575,16 @@ function buildAssetTags(ctx) {
 * ```
 */
 function renderDocument(parts) {
-	return `<!DOCTYPE html><html lang="${parts.locale}"><head>${parts.head}${parts.assets}</head><body>${parts.body}</body></html>`;
+	return `<!DOCTYPE html><html lang="${parts.locale}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">${parts.head}${parts.assets}</head><body>${parts.body}</body></html>`;
 }
 /**
-* Fill a shell template's `<!--moku:head-->` / `<!--moku:body-->` /
-* `<!--moku:assets-->` placeholders deterministically at build time.
+* Fill a shell template's `<!--moku:lang-->` / `<!--moku:head-->` /
+* `<!--moku:body-->` / `<!--moku:assets-->` placeholders deterministically at build
+* time. `<!--moku:lang-->` carries the page locale (for `<html lang>`), so a single
+* shared template stays locale-correct across every locale.
 *
 * @param template - The raw shell template HTML.
-* @param parts - The composed head/body/assets pieces.
+* @param parts - The composed head/body/assets/locale pieces.
 * @returns The filled document string.
 * @example
 * ```ts
@@ -4578,7 +4592,7 @@ function renderDocument(parts) {
 * ```
 */
 function fillTemplate(template, parts) {
-	return template.replaceAll(HEAD_PLACEHOLDER, parts.head).replaceAll(BODY_PLACEHOLDER, parts.body).replaceAll(ASSETS_PLACEHOLDER, parts.assets);
+	return template.replaceAll(LANG_PLACEHOLDER, parts.locale).replaceAll(HEAD_PLACEHOLDER, parts.head).replaceAll(BODY_PLACEHOLDER, parts.body).replaceAll(ASSETS_PLACEHOLDER, parts.assets);
 }
 /**
 * Resolve the compiled entry for a manifest definition, asserting the router
@@ -5830,7 +5844,8 @@ function buildWranglerArgs(input) {
 		"--project-name",
 		input.slug,
 		"--branch",
-		branch
+		branch,
+		"--commit-dirty=true"
 	];
 }
 /**
@@ -6439,17 +6454,18 @@ function validateConfig$1(ctx) {
 	ctx.require(sitePlugin);
 }
 /**
-* Run wrangler for the prepared argv and surface its scrubbed result, translating
-* a non-zero exit into the classified deploy error. The API token is read from env
-* here so it never crosses a logging boundary; only scrubbed output is returned.
-* Shared by `run()` (deploy) and `createProject()` (project create).
+* Run wrangler for the prepared argv and return its stdout, translating a non-zero
+* exit into the classified deploy error. The API token is read from env here so it
+* never crosses a logging boundary; the scrubbed stderr is used only to classify a
+* failure — it is never logged (that was console noise), so nothing leaks. Shared by
+* `run()` (deploy) and `createProject()` (project create).
 *
 * @param ctx - Plugin context (provides `state.spawn`, `config`, `env`).
 * @param args - The fully-built, pre-validated wrangler argv.
-* @returns The wrangler `stdout` plus the scrubbed `stderr` to log on success.
+* @returns The wrangler `stdout` (for URL/id parsing on a deploy).
 * @throws {Error} With a `code` from the deploy error taxonomy on a non-zero exit.
 * @example
-* const { stdout, scrubbedStderr } = await executeWrangler(ctx, args);
+* const stdout = await executeWrangler(ctx, args);
 */
 async function executeWrangler(ctx, args) {
 	const token = ctx.env.require("CLOUDFLARE_API_TOKEN");
@@ -6463,10 +6479,7 @@ async function executeWrangler(ctx, args) {
 		const { code, message } = classifyWranglerError(exitCode, scrubbedStderr);
 		throw deployError(code, message);
 	}
-	return {
-		stdout,
-		scrubbedStderr
-	};
+	return stdout;
 }
 /**
 * Assemble the public {@link DeployResult} from wrangler's stdout, parsing the
@@ -6523,9 +6536,7 @@ function createApi$2(ctx) {
 				root
 			});
 			const start = Date.now();
-			const { stdout, scrubbedStderr } = await executeWrangler(ctx, args);
-			ctx.log.info(scrubbedStderr);
-			const result = buildDeployResult(stdout, branch, start);
+			const result = buildDeployResult(await executeWrangler(ctx, args), branch, start);
 			ctx.state.lastDeployment = result;
 			ctx.emit("deploy:complete", {
 				url: result.url,
@@ -6585,11 +6596,10 @@ function createApi$2(ctx) {
 		async createProject() {
 			const name = toSlug(ctx.require(sitePlugin).name());
 			const branch = ctx.config.productionBranch ?? "main";
-			const { scrubbedStderr } = await executeWrangler(ctx, buildProjectCreateArgs({
+			await executeWrangler(ctx, buildProjectCreateArgs({
 				slug: name,
 				branch
 			}));
-			ctx.log.info(scrubbedStderr);
 			return {
 				name,
 				branch
@@ -7515,23 +7525,23 @@ function createDevHandler(ctx, hub) {
 }
 /**
 * Build the per-run {@link BuildRunOverrides} for a dev build from the session feature
-* opt-ins: minification is always off in dev (no benefit, slower), and each expensive
-* output stays off unless its flag re-enables it (`ogImage: false` disables OG generation
-* regardless of the persisted config). The persisted plugin config is never mutated — the
-* overrides apply to the dev run only.
+* opt-ins: minification is always off in dev (no benefit, slower), and each expensive,
+* NON-navigational output stays off unless its flag re-enables it (`ogImage: false`
+* disables OG generation regardless of the persisted config). Locale-redirects are NOT
+* overridden — they produce navigable pages (the bare `/` → `/{defaultLocale}/` redirect),
+* so they follow the app's own config. The persisted plugin config is never mutated.
 *
 * @param features - The resolved per-session dev feature opt-ins.
 * @returns The config overrides merged into the dev build run.
 * @example
-* devBuildOverrides({ og: false, sitemap: false, feeds: false, localeRedirects: false });
+* devBuildOverrides({ og: false, sitemap: false, feeds: false });
 */
 function devBuildOverrides(features) {
 	return {
 		minify: false,
 		...features.feeds ? {} : { feeds: false },
 		...features.sitemap ? {} : { sitemap: false },
-		...features.og ? {} : { ogImage: false },
-		...features.localeRedirects ? {} : { localeRedirects: false }
+		...features.og ? {} : { ogImage: false }
 	};
 }
 /**
@@ -7891,9 +7901,10 @@ function createApi$1(ctx) {
 		/**
 		* Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
 		* `watchDirs`, debounced + incremental rebuild + reload. For a fast rebuild the dev
-		* build disables minification + expensive, preview-irrelevant outputs (feeds /
-		* sitemap / og-images / locale-redirects); pass `og`/`sitemap`/`feeds`/
-		* `localeRedirects` to re-enable any of them for the session. Resolves on SIGINT/SIGTERM.
+		* build disables minification + expensive, NON-navigational outputs (feeds / sitemap /
+		* og-images); pass `og`/`sitemap`/`feeds` to re-enable any of them for the session.
+		* Locale-redirects are always built per the app config (they emit the navigable bare-path
+		* `/` → `/{defaultLocale}/` redirect). Resolves on SIGINT/SIGTERM.
 		*
 		* @param options - Optional port override + per-session dev feature opt-ins.
 		* @returns Resolves once the server has been torn down.
@@ -7906,8 +7917,7 @@ function createApi$1(ctx) {
 			return runDevServer(ctx, port, {
 				og: options.og ?? false,
 				sitemap: options.sitemap ?? false,
-				feeds: options.feeds ?? false,
-				localeRedirects: options.localeRedirects ?? false
+				feeds: options.feeds ?? false
 			});
 		},
 		/**
@@ -8756,16 +8766,24 @@ function createPanelRenderer(options = {}) {
 			write(line);
 		},
 		/**
-		* Render the deploy result from a `deploy:complete` event: a `✓ DEPLOYED → url` line
-		* with the URL the hero value, then a dim `branch · id · time` line beneath it.
+		* Render the deploy result from a `deploy:complete` event as a full-width box (matching
+		* the BUILD panel): a `✓ DEPLOYED · branch` header with the elapsed time right-aligned,
+		* then a `→ url · id` row. The url/id row is omitted entirely when wrangler returned no
+		* URL, so a first-deploy with nothing to parse never renders a dangling `→` or `· ·`.
 		*
 		* @param result - The `deploy:complete` payload.
 		* @example
 		* render.deployed({ url: "https://x.pages.dev", deploymentId: "id", branch: "main", durationMs: 1200 });
 		*/
 		deployed(result) {
-			const meta = palette.dim(`branch ${result.branch} · ${result.deploymentId} · ${result.durationMs}ms`);
-			writeBlock([`  ${palette.green("✓")} ${palette.bold("DEPLOYED")}   ${palette.dim("→")}  ${palette.cyan(result.url)}`, `  ${meta}`]);
+			const dot = palette.dim("·");
+			const time = result.durationMs >= 1e3 ? `${(result.durationMs / 1e3).toFixed(1)}s` : `${result.durationMs}ms`;
+			const lines = [railLine(`${palette.green("✓")} ${palette.bold("DEPLOYED")} ${dot} ${result.branch}`, palette.dim(time), BOX_INNER)];
+			if (result.url) {
+				const id = result.deploymentId ? ` ${dot} ${palette.dim(result.deploymentId)}` : "";
+				lines.push(`${palette.dim("→")} ${palette.cyan(result.url)}${id}`);
+			} else if (result.deploymentId) lines.push(palette.dim(`id ${result.deploymentId}`));
+			writeBlock(box(lines, color, BOX_INNER));
 		},
 		/**
 		* Render a neutral informational line.
@@ -8860,6 +8878,29 @@ function createPanelRenderer(options = {}) {
 */
 /** Matches an explicit affirmative answer (`y`/`yes`, case-insensitive). */
 const YES_PATTERN = /^y(es)?$/i;
+/** Prompt rail width — matches the renderer's `RAIL_WIDTH` so the hint aligns with other rows. */
+const PROMPT_WIDTH = 66;
+/** Whether the interactive prompts render with the MOKU marker styling (color/TTY only). */
+const PROMPT_COLOR = supportsColor();
+/** Shared palette for the interactive prompts (same brand colors as the Panel renderer). */
+const PROMPT_PALETTE = makePalette(PROMPT_COLOR, PROMPT_COLOR && supportsTruecolor());
+/**
+* Build the styled y/N confirm prompt: a brand `◆` marker + the question on the left,
+* a dim `y / N` hint + cyan `›` caret right-aligned to {@link PROMPT_WIDTH}. Falls back
+* to the plain `question [y/N] ` form off a color TTY (CI/pipes), where prompts rarely run.
+*
+* @param question - The yes/no question to display.
+* @returns The readline prompt string (the typed answer follows the caret).
+* @example
+* confirmPrompt("Deploy dist/ to Cloudflare Pages?");
+*/
+function confirmPrompt(question) {
+	if (!PROMPT_COLOR) return `${question} [y/N] `;
+	const left = `  ${PROMPT_PALETTE.pink("◆")} ${question}`;
+	const right = `${PROMPT_PALETTE.dim("y / N")} ${PROMPT_PALETTE.cyan("›")} `;
+	const gap = Math.max(1, PROMPT_WIDTH - visibleWidth(left) - visibleWidth(right));
+	return `${left}${" ".repeat(gap)}${right}`;
+}
 /**
 * Resolve the `Bun` runtime global, or `undefined` when not running under Bun.
 *
@@ -8917,7 +8958,7 @@ function defaultConfirm(question) {
 			input: process.stdin,
 			output: process.stdout
 		});
-		readline.question(`${question} [y/N] `, (answer) => {
+		readline.question(confirmPrompt(question), (answer) => {
 			readline.close();
 			resolve(YES_PATTERN.test(answer.trim()));
 		});
@@ -8940,8 +8981,8 @@ function defaultSelect(question, choices) {
 			input: process.stdin,
 			output: process.stdout
 		});
-		for (const [index, choice] of choices.entries()) console.log(`  ${index + 1}) ${choice}`);
-		readline.question(`${question} [1-${choices.length}] `, (answer) => {
+		console.log(selectChoicesBlock(question, choices));
+		readline.question(selectPrompt(question, choices.length), (answer) => {
 			readline.close();
 			const picked = Number.parseInt(answer.trim(), 10);
 			resolve(Number.isInteger(picked) && picked >= 1 && picked <= choices.length ? picked - 1 : 0);
@@ -8949,6 +8990,36 @@ function defaultSelect(question, choices) {
 	});
 }
 /**
+* Render the select block: a brand `◆` marker + the question, then each choice as an
+* indented dim number + label. Off a color TTY, falls back to the plain `  N) label`
+* list (the question rides the prompt instead).
+*
+* @param question - The prompt shown above the choices (styled mode only).
+* @param choices - The selectable option labels.
+* @returns The multi-line choices block.
+* @example
+* selectChoicesBlock("Set up a workflow?", ["Auto", "Manual", "Skip"]);
+*/
+function selectChoicesBlock(question, choices) {
+	if (!PROMPT_COLOR) return choices.map((choice, index) => `  ${index + 1}) ${choice}`).join("\n");
+	return [`  ${PROMPT_PALETTE.pink("◆")} ${question}`, ...choices.map((choice, index) => `      ${PROMPT_PALETTE.dim(String(index + 1))}  ${choice}`)].join("\n");
+}
+/**
+* Build the select input prompt: a dim `pick 1–N` hint + cyan `›` caret in styled mode,
+* or the plain `question [1-N] ` form off a color TTY (where the question is not printed
+* separately).
+*
+* @param question - The prompt (used only by the plain fallback).
+* @param count - The number of choices.
+* @returns The readline prompt string.
+* @example
+* selectPrompt("Set up a workflow?", 3);
+*/
+function selectPrompt(question, count) {
+	if (!PROMPT_COLOR) return `${question} [1-${count}] `;
+	return `    ${PROMPT_PALETTE.dim(`pick 1–${count}`)} ${PROMPT_PALETTE.cyan("›")} `;
+}
+/**
 * Default recursive directory watcher — wraps `node:fs.watch` with `{ recursive: true }`
 * and adapts its handle to {@link WatchHandle}. Tests inject a fake emitter so no real
 * FS watch is registered.

package/dist/index.d.cts

@@ -1615,7 +1615,17 @@ type Config$3 = {
     body?: string;
   }; /** Emit per-path i18n bare-path redirect HTML pages. Default `false`. */
   localeRedirects?: boolean; /** Authoritative client bundle entry path (overrides the conventional scan). */
-  clientEntry?: string; /** HTML shell template with `<!--moku:head-->`/`<!--moku:body-->`/`<!--moku:assets-->` placeholders. */
+  clientEntry?: string;
+  /**
+   * Path to a custom HTML document shell, giving the app full control over the
+   * scaffold (charset, viewport, `<html lang>`, body attributes, wrapper markup).
+   * Placeholders, substituted per page at build time:
+   * `<!--moku:lang-->` (page locale for `<html lang>`),
+   * `<!--moku:head-->` (composed `<head>` inner HTML),
+   * `<!--moku:assets-->` (injected `<link>`/`<script>` tags),
+   * `<!--moku:body-->` (SSR body HTML).
+   * When unset, the built-in shell is used (it emits charset + viewport by default).
+   */
   template?: string;
 };
 /**
@@ -2460,8 +2470,7 @@ type ServeOptions = {
    */
   og?: boolean; /** Re-enable `sitemap.xml` + `robots.txt` for this dev session (maps to `--sitemap`). Defaults to `false`. */
   sitemap?: boolean; /** Re-enable RSS/Atom/JSON feeds for this dev session (maps to `--feeds`). Defaults to `false`. */
-  feeds?: boolean; /** Re-enable i18n locale-redirect pages for this dev session (maps to `--locale-redirects`). Defaults to `false`. */
-  localeRedirects?: boolean;
+  feeds?: boolean;
 };
 /**
  * Options for `cli.preview()`.
@@ -2736,11 +2745,18 @@ type Config = {
  *
  * @example
  * ```ts
- * { articles: new Map() }
+ * { articles: new Map(), loadedAll: null }
  * ```
  */
 type State = {
   /** Article cache keyed locale -> (slug -> Article). Starts empty. */articles: Map<string, Map<string, Article>>;
+  /**
+   * Memoized full `loadAll()` result, or `null` when not yet loaded / invalidated. List-route
+   * loaders call `loadAll()` once PER PAGE, so without this every page re-reads + re-renders
+   * every article (the dev-loop killer). The memo makes repeated calls O(1); `invalidate()`
+   * clears it so a dev rebuild reloads (re-resolving only the changed slugs). Starts `null`.
+   */
+  loadedAll: Map<string, Article[]> | null;
 };
 /**
  * Notification-only events emitted by the content plugin.
@@ -2790,11 +2806,13 @@ type ContentApiContext = {
  */
 type LoadAllOptions = {
   /**
-   * Reuse already-cached articles for slugs NOT dropped by a preceding `invalidate()`,
-   * re-reading + re-rendering (Shiki) ONLY the invalidated (dirty) articles. The
-   * post-sort `contentId` ordinals are always recomputed across the full set, so order +
-   * ids match a full load. Default `false` (a full load that re-reads every article).
-   * Used by dev incremental rebuilds; a fresh process / production build never reuses.
+   * Reuse the per-build memo + per-slug cache (re-resolving only slugs a preceding
+   * `invalidate()` dropped). Default `true` — this is what keeps repeated `loadAll()` calls
+   * (a list route's loader runs once per page) cheap, and makes a dev rebuild re-render only
+   * changed articles. Set `false` to force a FRESH full reload (cold build / an
+   * unclassifiable change), which re-reads + re-renders every article and rebuilds the memo.
+   * The post-sort `contentId` ordinals are always recomputed across the full set, so order +
+   * ids match a full load either way.
    */
   reuse?: boolean;
 };
@@ -2808,10 +2826,13 @@ type LoadAllOptions = {
  */
 type Api = {
   /**
-   * Load every article across every active locale, returning a locale-keyed
-   * map of date-descending Article arrays. Emits content:ready.
+   * Load every article across every active locale, returning a locale-keyed map of
+   * date-descending Article arrays. Emits content:ready (once per actual load). Cache-first
+   * + memoized: repeated calls (e.g. a list route's loader on every page) return the SAME
+   * cached result with no re-read — so treat the result as READ-ONLY (do not sort/mutate it
+   * in place; slice/copy first). Pass `{ reuse: false }` to force a fresh full reload.
    *
-   * @param options - Optional load behaviour ({@link LoadAllOptions}); omit for a full load.
+   * @param options - Optional load behaviour ({@link LoadAllOptions}); default reuses the cache.
    */
   loadAll(options?: LoadAllOptions): Promise<Map<string, Article[]>>;
   /**

package/dist/index.d.mts

@@ -1615,7 +1615,17 @@ type Config$3 = {
     body?: string;
   }; /** Emit per-path i18n bare-path redirect HTML pages. Default `false`. */
   localeRedirects?: boolean; /** Authoritative client bundle entry path (overrides the conventional scan). */
-  clientEntry?: string; /** HTML shell template with `<!--moku:head-->`/`<!--moku:body-->`/`<!--moku:assets-->` placeholders. */
+  clientEntry?: string;
+  /**
+   * Path to a custom HTML document shell, giving the app full control over the
+   * scaffold (charset, viewport, `<html lang>`, body attributes, wrapper markup).
+   * Placeholders, substituted per page at build time:
+   * `<!--moku:lang-->` (page locale for `<html lang>`),
+   * `<!--moku:head-->` (composed `<head>` inner HTML),
+   * `<!--moku:assets-->` (injected `<link>`/`<script>` tags),
+   * `<!--moku:body-->` (SSR body HTML).
+   * When unset, the built-in shell is used (it emits charset + viewport by default).
+   */
   template?: string;
 };
 /**
@@ -2460,8 +2470,7 @@ type ServeOptions = {
    */
   og?: boolean; /** Re-enable `sitemap.xml` + `robots.txt` for this dev session (maps to `--sitemap`). Defaults to `false`. */
   sitemap?: boolean; /** Re-enable RSS/Atom/JSON feeds for this dev session (maps to `--feeds`). Defaults to `false`. */
-  feeds?: boolean; /** Re-enable i18n locale-redirect pages for this dev session (maps to `--locale-redirects`). Defaults to `false`. */
-  localeRedirects?: boolean;
+  feeds?: boolean;
 };
 /**
  * Options for `cli.preview()`.
@@ -2736,11 +2745,18 @@ type Config = {
  *
  * @example
  * ```ts
- * { articles: new Map() }
+ * { articles: new Map(), loadedAll: null }
  * ```
  */
 type State = {
   /** Article cache keyed locale -> (slug -> Article). Starts empty. */articles: Map<string, Map<string, Article>>;
+  /**
+   * Memoized full `loadAll()` result, or `null` when not yet loaded / invalidated. List-route
+   * loaders call `loadAll()` once PER PAGE, so without this every page re-reads + re-renders
+   * every article (the dev-loop killer). The memo makes repeated calls O(1); `invalidate()`
+   * clears it so a dev rebuild reloads (re-resolving only the changed slugs). Starts `null`.
+   */
+  loadedAll: Map<string, Article[]> | null;
 };
 /**
  * Notification-only events emitted by the content plugin.
@@ -2790,11 +2806,13 @@ type ContentApiContext = {
  */
 type LoadAllOptions = {
   /**
-   * Reuse already-cached articles for slugs NOT dropped by a preceding `invalidate()`,
-   * re-reading + re-rendering (Shiki) ONLY the invalidated (dirty) articles. The
-   * post-sort `contentId` ordinals are always recomputed across the full set, so order +
-   * ids match a full load. Default `false` (a full load that re-reads every article).
-   * Used by dev incremental rebuilds; a fresh process / production build never reuses.
+   * Reuse the per-build memo + per-slug cache (re-resolving only slugs a preceding
+   * `invalidate()` dropped). Default `true` — this is what keeps repeated `loadAll()` calls
+   * (a list route's loader runs once per page) cheap, and makes a dev rebuild re-render only
+   * changed articles. Set `false` to force a FRESH full reload (cold build / an
+   * unclassifiable change), which re-reads + re-renders every article and rebuilds the memo.
+   * The post-sort `contentId` ordinals are always recomputed across the full set, so order +
+   * ids match a full load either way.
    */
   reuse?: boolean;
 };
@@ -2808,10 +2826,13 @@ type LoadAllOptions = {
  */
 type Api = {
   /**
-   * Load every article across every active locale, returning a locale-keyed
-   * map of date-descending Article arrays. Emits content:ready.
+   * Load every article across every active locale, returning a locale-keyed map of
+   * date-descending Article arrays. Emits content:ready (once per actual load). Cache-first
+   * + memoized: repeated calls (e.g. a list route's loader on every page) return the SAME
+   * cached result with no re-read — so treat the result as READ-ONLY (do not sort/mutate it
+   * in place; slice/copy first). Pass `{ reuse: false }` to force a fresh full reload.
    *
-   * @param options - Optional load behaviour ({@link LoadAllOptions}); omit for a full load.
+   * @param options - Optional load behaviour ({@link LoadAllOptions}); default reuses the cache.
    */
   loadAll(options?: LoadAllOptions): Promise<Map<string, Article[]>>;
   /**

package/dist/index.mjs

@@ -1336,12 +1336,15 @@ function createContentApi(ctx) {
 		* Load every article across every active locale (locale fallback, production
 		* draft exclusion, date sort, `contentId` after sort), cache them, emit `content:ready`.
 		*
-		* With `{ reuse: true }` (dev incremental rebuild) cached articles are reused for
-		* every slug a preceding `invalidate()` did not drop, so only the dirty articles
-		* re-read + re-run the Markdown/Shiki pipeline; the `contentId` ordinals are still
-		* recomputed across the FULL sorted set, so ids + order match a full load.
+		* Cache-first by default: repeated calls return the per-build memo (list-route loaders
+		* call this once PER PAGE — without the memo every page would re-read + re-render every
+		* article, the dev-loop killer), and a rebuild after `invalidate()` re-resolves only the
+		* dropped slugs while reusing the cached articles for the rest (`contentId` ordinals are
+		* still recomputed across the FULL sorted set, so ids + order match a full load). Pass
+		* `{ reuse: false }` to force a FRESH full reload (cold build / an unclassifiable change
+		* where the caller cannot pinpoint what changed) — this bypasses the memo + per-slug cache.
 		*
-		* @param options - Optional load behaviour (`reuse`); omit for a full load.
+		* @param options - Optional load behaviour (`reuse`, default `true`).
 		* @returns A locale-keyed map of date-descending articles.
 		* @example
 		* ```ts
@@ -1349,7 +1352,9 @@ function createContentApi(ctx) {
 		* ```
 		*/
 		async loadAll(options) {
-			const reuse = options?.reuse === true;
+			const reuse = options?.reuse !== false;
+			const memo = ctx.state.loadedAll;
+			if (reuse && memo !== null) return memo;
 			const slugs = await ctx.provider.slugs();
 			const locales = ctx.locales();
 			const result = /* @__PURE__ */ new Map();
@@ -1367,6 +1372,7 @@ function createContentApi(ctx) {
 				result.set(locale, present);
 				total += present.length;
 			}
+			ctx.state.loadedAll = result;
 			ctx.emit("content:ready", {
 				locales,
 				articleCount: total
@@ -1430,6 +1436,7 @@ function createContentApi(ctx) {
 				if (slug === void 0) continue;
 				for (const cache of ctx.state.articles.values()) cache.delete(slug);
 			}
+			if (accepted.length > 0) ctx.state.loadedAll = null;
 			ctx.emit("content:invalidated", { paths: accepted });
 		},
 		/**
@@ -1499,14 +1506,17 @@ const contentEvents = (register) => ({
 * @param _ctx - Minimal context with global and config.
 * @param _ctx.global - Global plugin registry.
 * @param _ctx.config - Resolved plugin configuration.
-* @returns Fresh content shell state: an empty article cache.
+* @returns Fresh content shell state: an empty article cache + an empty loadAll memo.
 * @example
 * ```ts
 * const state = createContentState({ global: {}, config: { providers: [] } });
 * ```
 */
 function createContentState(_ctx) {
-	return { articles: /* @__PURE__ */ new Map() };
+	return {
+		articles: /* @__PURE__ */ new Map(),
+		loadedAll: null
+	};
 }
 //#endregion
 //#region src/plugins/content/validate.ts
@@ -3819,7 +3829,7 @@ const DEFAULT_BODY = "<h1>404</h1><p>The page you requested could not be found.<
 * ```
 */
 function wrap(body) {
-	return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>404 — Not Found</title></head><body>${body}</body></html>`;
+	return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>404 — Not Found</title></head><body>${body}</body></html>`;
 }
 /**
 * Emits `outDir/404.html`. When `config.notFound` is `true`, writes the built-in
@@ -4503,6 +4513,8 @@ const HEAD_PLACEHOLDER = "<!--moku:head-->";
 const BODY_PLACEHOLDER = "<!--moku:body-->";
 /** Template placeholder for the injected asset `<link>`/`<script>` tags. */
 const ASSETS_PLACEHOLDER = "<!--moku:assets-->";
+/** Template placeholder for the page's locale (`<html lang>`). */
+const LANG_PLACEHOLDER = "<!--moku:lang-->";
 /**
 * Read the bundle phase's hashed asset manifest for one kind from `state.buildCache`
 * as a typed {@link BuildCacheEntry} (no `Map<string, unknown>` reads).
@@ -4550,14 +4562,16 @@ function buildAssetTags(ctx) {
 * ```
 */
 function renderDocument(parts) {
-	return `<!DOCTYPE html><html lang="${parts.locale}"><head>${parts.head}${parts.assets}</head><body>${parts.body}</body></html>`;
+	return `<!DOCTYPE html><html lang="${parts.locale}"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">${parts.head}${parts.assets}</head><body>${parts.body}</body></html>`;
 }
 /**
-* Fill a shell template's `<!--moku:head-->` / `<!--moku:body-->` /
-* `<!--moku:assets-->` placeholders deterministically at build time.
+* Fill a shell template's `<!--moku:lang-->` / `<!--moku:head-->` /
+* `<!--moku:body-->` / `<!--moku:assets-->` placeholders deterministically at build
+* time. `<!--moku:lang-->` carries the page locale (for `<html lang>`), so a single
+* shared template stays locale-correct across every locale.
 *
 * @param template - The raw shell template HTML.
-* @param parts - The composed head/body/assets pieces.
+* @param parts - The composed head/body/assets/locale pieces.
 * @returns The filled document string.
 * @example
 * ```ts
@@ -4565,7 +4579,7 @@ function renderDocument(parts) {
 * ```
 */
 function fillTemplate(template, parts) {
-	return template.replaceAll(HEAD_PLACEHOLDER, parts.head).replaceAll(BODY_PLACEHOLDER, parts.body).replaceAll(ASSETS_PLACEHOLDER, parts.assets);
+	return template.replaceAll(LANG_PLACEHOLDER, parts.locale).replaceAll(HEAD_PLACEHOLDER, parts.head).replaceAll(BODY_PLACEHOLDER, parts.body).replaceAll(ASSETS_PLACEHOLDER, parts.assets);
 }
 /**
 * Resolve the compiled entry for a manifest definition, asserting the router
@@ -5817,7 +5831,8 @@ function buildWranglerArgs(input) {
 		"--project-name",
 		input.slug,
 		"--branch",
-		branch
+		branch,
+		"--commit-dirty=true"
 	];
 }
 /**
@@ -6426,17 +6441,18 @@ function validateConfig$1(ctx) {
 	ctx.require(sitePlugin);
 }
 /**
-* Run wrangler for the prepared argv and surface its scrubbed result, translating
-* a non-zero exit into the classified deploy error. The API token is read from env
-* here so it never crosses a logging boundary; only scrubbed output is returned.
-* Shared by `run()` (deploy) and `createProject()` (project create).
+* Run wrangler for the prepared argv and return its stdout, translating a non-zero
+* exit into the classified deploy error. The API token is read from env here so it
+* never crosses a logging boundary; the scrubbed stderr is used only to classify a
+* failure — it is never logged (that was console noise), so nothing leaks. Shared by
+* `run()` (deploy) and `createProject()` (project create).
 *
 * @param ctx - Plugin context (provides `state.spawn`, `config`, `env`).
 * @param args - The fully-built, pre-validated wrangler argv.
-* @returns The wrangler `stdout` plus the scrubbed `stderr` to log on success.
+* @returns The wrangler `stdout` (for URL/id parsing on a deploy).
 * @throws {Error} With a `code` from the deploy error taxonomy on a non-zero exit.
 * @example
-* const { stdout, scrubbedStderr } = await executeWrangler(ctx, args);
+* const stdout = await executeWrangler(ctx, args);
 */
 async function executeWrangler(ctx, args) {
 	const token = ctx.env.require("CLOUDFLARE_API_TOKEN");
@@ -6450,10 +6466,7 @@ async function executeWrangler(ctx, args) {
 		const { code, message } = classifyWranglerError(exitCode, scrubbedStderr);
 		throw deployError(code, message);
 	}
-	return {
-		stdout,
-		scrubbedStderr
-	};
+	return stdout;
 }
 /**
 * Assemble the public {@link DeployResult} from wrangler's stdout, parsing the
@@ -6510,9 +6523,7 @@ function createApi$2(ctx) {
 				root
 			});
 			const start = Date.now();
-			const { stdout, scrubbedStderr } = await executeWrangler(ctx, args);
-			ctx.log.info(scrubbedStderr);
-			const result = buildDeployResult(stdout, branch, start);
+			const result = buildDeployResult(await executeWrangler(ctx, args), branch, start);
 			ctx.state.lastDeployment = result;
 			ctx.emit("deploy:complete", {
 				url: result.url,
@@ -6572,11 +6583,10 @@ function createApi$2(ctx) {
 		async createProject() {
 			const name = toSlug(ctx.require(sitePlugin).name());
 			const branch = ctx.config.productionBranch ?? "main";
-			const { scrubbedStderr } = await executeWrangler(ctx, buildProjectCreateArgs({
+			await executeWrangler(ctx, buildProjectCreateArgs({
 				slug: name,
 				branch
 			}));
-			ctx.log.info(scrubbedStderr);
 			return {
 				name,
 				branch
@@ -7502,23 +7512,23 @@ function createDevHandler(ctx, hub) {
 }
 /**
 * Build the per-run {@link BuildRunOverrides} for a dev build from the session feature
-* opt-ins: minification is always off in dev (no benefit, slower), and each expensive
-* output stays off unless its flag re-enables it (`ogImage: false` disables OG generation
-* regardless of the persisted config). The persisted plugin config is never mutated — the
-* overrides apply to the dev run only.
+* opt-ins: minification is always off in dev (no benefit, slower), and each expensive,
+* NON-navigational output stays off unless its flag re-enables it (`ogImage: false`
+* disables OG generation regardless of the persisted config). Locale-redirects are NOT
+* overridden — they produce navigable pages (the bare `/` → `/{defaultLocale}/` redirect),
+* so they follow the app's own config. The persisted plugin config is never mutated.
 *
 * @param features - The resolved per-session dev feature opt-ins.
 * @returns The config overrides merged into the dev build run.
 * @example
-* devBuildOverrides({ og: false, sitemap: false, feeds: false, localeRedirects: false });
+* devBuildOverrides({ og: false, sitemap: false, feeds: false });
 */
 function devBuildOverrides(features) {
 	return {
 		minify: false,
 		...features.feeds ? {} : { feeds: false },
 		...features.sitemap ? {} : { sitemap: false },
-		...features.og ? {} : { ogImage: false },
-		...features.localeRedirects ? {} : { localeRedirects: false }
+		...features.og ? {} : { ogImage: false }
 	};
 }
 /**
@@ -7878,9 +7888,10 @@ function createApi$1(ctx) {
 		/**
 		* Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
 		* `watchDirs`, debounced + incremental rebuild + reload. For a fast rebuild the dev
-		* build disables minification + expensive, preview-irrelevant outputs (feeds /
-		* sitemap / og-images / locale-redirects); pass `og`/`sitemap`/`feeds`/
-		* `localeRedirects` to re-enable any of them for the session. Resolves on SIGINT/SIGTERM.
+		* build disables minification + expensive, NON-navigational outputs (feeds / sitemap /
+		* og-images); pass `og`/`sitemap`/`feeds` to re-enable any of them for the session.
+		* Locale-redirects are always built per the app config (they emit the navigable bare-path
+		* `/` → `/{defaultLocale}/` redirect). Resolves on SIGINT/SIGTERM.
 		*
 		* @param options - Optional port override + per-session dev feature opt-ins.
 		* @returns Resolves once the server has been torn down.
@@ -7893,8 +7904,7 @@ function createApi$1(ctx) {
 			return runDevServer(ctx, port, {
 				og: options.og ?? false,
 				sitemap: options.sitemap ?? false,
-				feeds: options.feeds ?? false,
-				localeRedirects: options.localeRedirects ?? false
+				feeds: options.feeds ?? false
 			});
 		},
 		/**
@@ -8743,16 +8753,24 @@ function createPanelRenderer(options = {}) {
 			write(line);
 		},
 		/**
-		* Render the deploy result from a `deploy:complete` event: a `✓ DEPLOYED → url` line
-		* with the URL the hero value, then a dim `branch · id · time` line beneath it.
+		* Render the deploy result from a `deploy:complete` event as a full-width box (matching
+		* the BUILD panel): a `✓ DEPLOYED · branch` header with the elapsed time right-aligned,
+		* then a `→ url · id` row. The url/id row is omitted entirely when wrangler returned no
+		* URL, so a first-deploy with nothing to parse never renders a dangling `→` or `· ·`.
 		*
 		* @param result - The `deploy:complete` payload.
 		* @example
 		* render.deployed({ url: "https://x.pages.dev", deploymentId: "id", branch: "main", durationMs: 1200 });
 		*/
 		deployed(result) {
-			const meta = palette.dim(`branch ${result.branch} · ${result.deploymentId} · ${result.durationMs}ms`);
-			writeBlock([`  ${palette.green("✓")} ${palette.bold("DEPLOYED")}   ${palette.dim("→")}  ${palette.cyan(result.url)}`, `  ${meta}`]);
+			const dot = palette.dim("·");
+			const time = result.durationMs >= 1e3 ? `${(result.durationMs / 1e3).toFixed(1)}s` : `${result.durationMs}ms`;
+			const lines = [railLine(`${palette.green("✓")} ${palette.bold("DEPLOYED")} ${dot} ${result.branch}`, palette.dim(time), BOX_INNER)];
+			if (result.url) {
+				const id = result.deploymentId ? ` ${dot} ${palette.dim(result.deploymentId)}` : "";
+				lines.push(`${palette.dim("→")} ${palette.cyan(result.url)}${id}`);
+			} else if (result.deploymentId) lines.push(palette.dim(`id ${result.deploymentId}`));
+			writeBlock(box(lines, color, BOX_INNER));
 		},
 		/**
 		* Render a neutral informational line.
@@ -8847,6 +8865,29 @@ function createPanelRenderer(options = {}) {
 */
 /** Matches an explicit affirmative answer (`y`/`yes`, case-insensitive). */
 const YES_PATTERN = /^y(es)?$/i;
+/** Prompt rail width — matches the renderer's `RAIL_WIDTH` so the hint aligns with other rows. */
+const PROMPT_WIDTH = 66;
+/** Whether the interactive prompts render with the MOKU marker styling (color/TTY only). */
+const PROMPT_COLOR = supportsColor();
+/** Shared palette for the interactive prompts (same brand colors as the Panel renderer). */
+const PROMPT_PALETTE = makePalette(PROMPT_COLOR, PROMPT_COLOR && supportsTruecolor());
+/**
+* Build the styled y/N confirm prompt: a brand `◆` marker + the question on the left,
+* a dim `y / N` hint + cyan `›` caret right-aligned to {@link PROMPT_WIDTH}. Falls back
+* to the plain `question [y/N] ` form off a color TTY (CI/pipes), where prompts rarely run.
+*
+* @param question - The yes/no question to display.
+* @returns The readline prompt string (the typed answer follows the caret).
+* @example
+* confirmPrompt("Deploy dist/ to Cloudflare Pages?");
+*/
+function confirmPrompt(question) {
+	if (!PROMPT_COLOR) return `${question} [y/N] `;
+	const left = `  ${PROMPT_PALETTE.pink("◆")} ${question}`;
+	const right = `${PROMPT_PALETTE.dim("y / N")} ${PROMPT_PALETTE.cyan("›")} `;
+	const gap = Math.max(1, PROMPT_WIDTH - visibleWidth(left) - visibleWidth(right));
+	return `${left}${" ".repeat(gap)}${right}`;
+}
 /**
 * Resolve the `Bun` runtime global, or `undefined` when not running under Bun.
 *
@@ -8904,7 +8945,7 @@ function defaultConfirm(question) {
 			input: process.stdin,
 			output: process.stdout
 		});
-		readline.question(`${question} [y/N] `, (answer) => {
+		readline.question(confirmPrompt(question), (answer) => {
 			readline.close();
 			resolve(YES_PATTERN.test(answer.trim()));
 		});
@@ -8927,8 +8968,8 @@ function defaultSelect(question, choices) {
 			input: process.stdin,
 			output: process.stdout
 		});
-		for (const [index, choice] of choices.entries()) console.log(`  ${index + 1}) ${choice}`);
-		readline.question(`${question} [1-${choices.length}] `, (answer) => {
+		console.log(selectChoicesBlock(question, choices));
+		readline.question(selectPrompt(question, choices.length), (answer) => {
 			readline.close();
 			const picked = Number.parseInt(answer.trim(), 10);
 			resolve(Number.isInteger(picked) && picked >= 1 && picked <= choices.length ? picked - 1 : 0);
@@ -8936,6 +8977,36 @@ function defaultSelect(question, choices) {
 	});
 }
 /**
+* Render the select block: a brand `◆` marker + the question, then each choice as an
+* indented dim number + label. Off a color TTY, falls back to the plain `  N) label`
+* list (the question rides the prompt instead).
+*
+* @param question - The prompt shown above the choices (styled mode only).
+* @param choices - The selectable option labels.
+* @returns The multi-line choices block.
+* @example
+* selectChoicesBlock("Set up a workflow?", ["Auto", "Manual", "Skip"]);
+*/
+function selectChoicesBlock(question, choices) {
+	if (!PROMPT_COLOR) return choices.map((choice, index) => `  ${index + 1}) ${choice}`).join("\n");
+	return [`  ${PROMPT_PALETTE.pink("◆")} ${question}`, ...choices.map((choice, index) => `      ${PROMPT_PALETTE.dim(String(index + 1))}  ${choice}`)].join("\n");
+}
+/**
+* Build the select input prompt: a dim `pick 1–N` hint + cyan `›` caret in styled mode,
+* or the plain `question [1-N] ` form off a color TTY (where the question is not printed
+* separately).
+*
+* @param question - The prompt (used only by the plain fallback).
+* @param count - The number of choices.
+* @returns The readline prompt string.
+* @example
+* selectPrompt("Set up a workflow?", 3);
+*/
+function selectPrompt(question, count) {
+	if (!PROMPT_COLOR) return `${question} [1-${count}] `;
+	return `    ${PROMPT_PALETTE.dim(`pick 1–${count}`)} ${PROMPT_PALETTE.cyan("›")} `;
+}
+/**
 * Default recursive directory watcher — wraps `node:fs.watch` with `{ recursive: true }`
 * and adapts its handle to {@link WatchHandle}. Tests inject a fake emitter so no real
 * FS watch is registered.

package/package.json

@@ -58,7 +58,7 @@
     "bun": ">=1.3.14"
   },
   "dependencies": {
-    "@moku-labs/core": "0.1.0-alpha.6",
+    "@moku-labs/core": "0.1.1",
     "@resvg/resvg-js": "2.6.2",
     "@shikijs/rehype": "3.22.0",
     "feed": "5.2.0",
@@ -113,5 +113,5 @@
     "test:cli-e2e": "bun test src/plugins/cli/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "1.3.0"
+  "version": "1.4.0"
 }