@ubean/cli 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -31,6 +31,45 @@ declare function createFsOps(cwd: string): {
   relative: (to: string) => string;
 };
 //#endregion
+//#region src/analyze-lib.d.ts
+interface ManifestChunk {
+  file: string;
+  isEntry?: boolean;
+  isDynamicEntry?: boolean;
+  name?: string;
+  src?: string;
+}
+interface BundleBudgetEntry {
+  file: string;
+  bytes: number;
+  gzip: number;
+  isEntry?: boolean;
+}
+interface BundleBaseline {
+  generatedAt: string;
+  outDir: string;
+  entries: BundleBudgetEntry[];
+  totalBytes: number;
+  totalGzip: number;
+  entryGzip: number;
+}
+declare function readViteManifest(manifestPath: string): Record<string, ManifestChunk>;
+declare function summarizeBundle(outDir: string, manifest: Record<string, ManifestChunk>): BundleBaseline;
+declare function compareBundleBaseline(current: Pick<BundleBaseline, 'totalGzip' | 'entryGzip'>, committed: Pick<BundleBaseline, 'totalGzip' | 'entryGzip'>, options?: {
+  maxIncrease?: number;
+}): {
+  ok: boolean;
+  maxIncrease: number;
+  totalRatio: number;
+  entryRatio: number;
+  messages: string[];
+};
+declare function writeBundleBaseline(filePath: string, baseline: BundleBaseline): void;
+declare function findClientManifest(cwd: string): {
+  outDir: string;
+  manifestPath: string;
+} | undefined;
+//#endregion
 //#region src/shared/templates.d.ts
 interface TemplateVariables {
   [key: string]: unknown;
@@ -127,7 +166,31 @@ declare function recoverScaffold(options: {
 }): Promise<ScaffoldResult>;
 declare function listScaffoldableFiles(cwd: string, type: ScaffoldType, baseDir?: string): Promise<string[]>;
 //#endregion
+//#region src/scaffold-manifest.d.ts
+declare const SCAFFOLD_CONTRACT_VERSION: 1;
+interface ScaffoldArgManifest {
+  name: string;
+  required: boolean;
+  description: string;
+  default?: string;
+}
+interface ScaffoldTypeManifest {
+  type: ScaffoldType;
+  /** Dedicated CLI command (`ubean api add`, …) or `ubean page add --type`. */
+  cli: boolean;
+  /** Directory relative to `src/`. */
+  baseDir: string;
+  extensions: string[];
+  args: ScaffoldArgManifest[];
+}
+interface ScaffoldManifest {
+  contractVersion: typeof SCAFFOLD_CONTRACT_VERSION;
+  types: ScaffoldTypeManifest[];
+}
+/** Machine-readable scaffold catalog for studio / IDE plugins (RM-S01). */
+declare function getScaffoldManifest(): ScaffoldManifest;
+//#endregion
 //#region src/index.d.ts
 type FsOps = ReturnType<typeof createFsOps>;
 //#endregion
-export { API_TEMPLATE, type ApiTemplateData, type BackupOptions, CRON_TEMPLATE, type CronTemplateData, FsOps, type FsOpOptions as FsOpsOptions, LAYOUT_TEMPLATE, type LayoutTemplateData, MIDDLEWARE_TEMPLATE, type MiddlewareTemplateData, PAGE_TEMPLATE, PLUGIN_TEMPLATE, type PageTemplateData, type PluginTemplateData, type ScaffoldOptions, type ScaffoldResult, type ScaffoldType, type TemplateOptions, type TemplateVariables, createFsOps, deleteScaffold, listScaffoldableFiles, recoverScaffold, renderApiTemplate, renderCronTemplate, renderLayoutTemplate, renderMiddlewareTemplate, renderPageTemplate, renderPluginTemplate, renderTemplate, scaffold, toCamelCase, toKebabCase, toPascalCase };
+export { API_TEMPLATE, type ApiTemplateData, type BackupOptions, type BundleBaseline, type BundleBudgetEntry, CRON_TEMPLATE, type CronTemplateData, FsOps, type FsOpOptions as FsOpsOptions, LAYOUT_TEMPLATE, type LayoutTemplateData, MIDDLEWARE_TEMPLATE, type ManifestChunk, type MiddlewareTemplateData, PAGE_TEMPLATE, PLUGIN_TEMPLATE, type PageTemplateData, type PluginTemplateData, SCAFFOLD_CONTRACT_VERSION, type ScaffoldArgManifest, type ScaffoldManifest, type ScaffoldOptions, type ScaffoldResult, type ScaffoldType, type ScaffoldTypeManifest, type TemplateOptions, type TemplateVariables, compareBundleBaseline, createFsOps, deleteScaffold, findClientManifest, getScaffoldManifest, listScaffoldableFiles, readViteManifest, recoverScaffold, renderApiTemplate, renderCronTemplate, renderLayoutTemplate, renderMiddlewareTemplate, renderPageTemplate, renderPluginTemplate, renderTemplate, scaffold, summarizeBundle, toCamelCase, toKebabCase, toPascalCase, writeBundleBaseline };

package/dist/index.js

@@ -1,2 +1,3 @@
-import { C as toCamelCase, E as createFsOps, S as renderTemplate, T as toPascalCase, _ as renderCronTemplate, a as scaffold, b as renderPageTemplate, d as CRON_TEMPLATE, f as LAYOUT_TEMPLATE, g as renderApiTemplate, h as PLUGIN_TEMPLATE, i as recoverScaffold, m as PAGE_TEMPLATE, n as listScaffoldableFiles, p as MIDDLEWARE_TEMPLATE, t as deleteScaffold, u as API_TEMPLATE, v as renderLayoutTemplate, w as toKebabCase, x as renderPluginTemplate, y as renderMiddlewareTemplate } from "./page-D-LZUcPP.js";
-export { API_TEMPLATE, CRON_TEMPLATE, LAYOUT_TEMPLATE, MIDDLEWARE_TEMPLATE, PAGE_TEMPLATE, PLUGIN_TEMPLATE, createFsOps, deleteScaffold, listScaffoldableFiles, recoverScaffold, renderApiTemplate, renderCronTemplate, renderLayoutTemplate, renderMiddlewareTemplate, renderPageTemplate, renderPluginTemplate, renderTemplate, scaffold, toCamelCase, toKebabCase, toPascalCase };
+import { n as getScaffoldManifest, t as SCAFFOLD_CONTRACT_VERSION } from "./scaffold-manifest-TrH6OCX8.js";
+import { A as summarizeBundle, C as toCamelCase, D as compareBundleBaseline, E as createFsOps, O as findClientManifest, S as renderTemplate, T as toPascalCase, _ as renderCronTemplate, a as scaffold, b as renderPageTemplate, d as CRON_TEMPLATE, f as LAYOUT_TEMPLATE, g as renderApiTemplate, h as PLUGIN_TEMPLATE, i as recoverScaffold, j as writeBundleBaseline, k as readViteManifest, m as PAGE_TEMPLATE, n as listScaffoldableFiles, p as MIDDLEWARE_TEMPLATE, t as deleteScaffold, u as API_TEMPLATE, v as renderLayoutTemplate, w as toKebabCase, x as renderPluginTemplate, y as renderMiddlewareTemplate } from "./page-BRUWKaig.js";
+export { API_TEMPLATE, CRON_TEMPLATE, LAYOUT_TEMPLATE, MIDDLEWARE_TEMPLATE, PAGE_TEMPLATE, PLUGIN_TEMPLATE, SCAFFOLD_CONTRACT_VERSION, compareBundleBaseline, createFsOps, deleteScaffold, findClientManifest, getScaffoldManifest, listScaffoldableFiles, readViteManifest, recoverScaffold, renderApiTemplate, renderCronTemplate, renderLayoutTemplate, renderMiddlewareTemplate, renderPageTemplate, renderPluginTemplate, renderTemplate, scaffold, summarizeBundle, toCamelCase, toKebabCase, toPascalCase, writeBundleBaseline };

package/dist/{page-D-LZUcPP.js → page-BRUWKaig.js}

@@ -1,9 +1,75 @@
-import { existsSync, promises } from "node:fs";
-import { dirname, extname, join, relative, resolve } from "node:path";
-import { getLogger } from "@ubean/logger";
+import { existsSync, mkdirSync, promises, readFileSync, statSync, writeFileSync } from "node:fs";
+import { gzipSync } from "node:zlib";
+import { dirname, join, resolve } from "pathe";
+import { dirname as dirname$1, extname, join as join$1, relative as relative$1, resolve as resolve$1 } from "node:path";
+import { getLogger } from "@ubean/shared/logger";
+//#region src/analyze-lib.ts
+function readViteManifest(manifestPath) {
+	return JSON.parse(readFileSync(manifestPath, "utf8"));
+}
+function summarizeBundle(outDir, manifest) {
+	const entries = [];
+	for (const chunk of Object.values(manifest)) {
+		if (!chunk.file || chunk.file.endsWith(".css")) continue;
+		const abs = join(outDir, chunk.file);
+		if (!existsSync(abs)) continue;
+		const bytes = statSync(abs).size;
+		const gzip = gzipSync(readFileSync(abs)).length;
+		entries.push({
+			file: chunk.file,
+			bytes,
+			gzip,
+			isEntry: chunk.isEntry
+		});
+	}
+	entries.sort((a, b) => b.gzip - a.gzip);
+	const totalBytes = entries.reduce((sum, e) => sum + e.bytes, 0);
+	const totalGzip = entries.reduce((sum, e) => sum + e.gzip, 0);
+	const entryGzip = entries.filter((e) => e.isEntry).reduce((sum, e) => sum + e.gzip, 0);
+	return {
+		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		outDir,
+		entries,
+		totalBytes,
+		totalGzip,
+		entryGzip
+	};
+}
+function compareBundleBaseline(current, committed, options = {}) {
+	const maxIncrease = options.maxIncrease ?? .05;
+	const totalRatio = committed.totalGzip === 0 ? current.totalGzip === 0 ? 0 : Infinity : current.totalGzip / committed.totalGzip - 1;
+	const entryRatio = committed.entryGzip === 0 ? current.entryGzip === 0 ? 0 : Infinity : current.entryGzip / committed.entryGzip - 1;
+	const messages = [];
+	if (totalRatio > maxIncrease) messages.push(`total gzip ${(current.totalGzip / 1024).toFixed(1)} kB exceeds baseline ${(committed.totalGzip / 1024).toFixed(1)} kB by ${(totalRatio * 100).toFixed(1)}% (max ${(maxIncrease * 100).toFixed(0)}%)`);
+	if (entryRatio > maxIncrease) messages.push(`entry gzip ${(current.entryGzip / 1024).toFixed(1)} kB exceeds baseline ${(committed.entryGzip / 1024).toFixed(1)} kB by ${(entryRatio * 100).toFixed(1)}% (max ${(maxIncrease * 100).toFixed(0)}%)`);
+	return {
+		ok: messages.length === 0,
+		maxIncrease,
+		totalRatio,
+		entryRatio,
+		messages
+	};
+}
+function writeBundleBaseline(filePath, baseline) {
+	mkdirSync(dirname(filePath), { recursive: true });
+	writeFileSync(filePath, `${JSON.stringify(baseline, null, 2)}\n`, "utf8");
+}
+function findClientManifest(cwd) {
+	const candidates = [
+		join(cwd, "dist/client/.vite/manifest.json"),
+		join(cwd, "dist/public/.vite/manifest.json"),
+		join(cwd, "dist/.vite/manifest.json"),
+		join(cwd, ".output/public/.vite/manifest.json")
+	];
+	for (const manifestPath of candidates) if (existsSync(manifestPath)) return {
+		outDir: resolve(dirname(manifestPath), ".."),
+		manifestPath
+	};
+}
+//#endregion
 //#region src/shared/fs-ops.ts
 function resolvePath(cwd, ...paths) {
-	return resolve(cwd, ...paths);
+	return resolve$1(cwd, ...paths);
 }
 async function ensureDir(dir) {
 	await promises.mkdir(dir, { recursive: true });
@@ -23,7 +89,7 @@ async function readFile(path, encoding = "utf-8") {
 	return promises.readFile(path, encoding);
 }
 async function writeFile(path, content, encoding = "utf-8") {
-	await ensureDir(dirname(path));
+	await ensureDir(dirname$1(path));
 	await promises.writeFile(path, content, encoding);
 }
 async function appendFile(path, content, encoding = "utf-8") {
@@ -36,15 +102,15 @@ async function remove(path) {
 	});
 }
 async function copyFile(src, dest) {
-	await ensureDir(dirname(dest));
+	await ensureDir(dirname$1(dest));
 	await promises.copyFile(src, dest);
 }
 async function copyDir(src, dest, options) {
 	await ensureDir(dest);
 	const entries = await promises.readdir(src, { withFileTypes: true });
 	for (const entry of entries) {
-		const srcPath = join(src, entry.name);
-		const destPath = join(dest, entry.name);
+		const srcPath = join$1(src, entry.name);
+		const destPath = join$1(dest, entry.name);
 		if (options?.filter && !options.filter(srcPath)) continue;
 		if (entry.isDirectory()) await copyDir(srcPath, destPath, options);
 		else await copyFile(srcPath, destPath);
@@ -81,7 +147,7 @@ async function listFiles(dir, pattern) {
 	async function walk(current) {
 		const entries = await promises.readdir(current, { withFileTypes: true });
 		for (const entry of entries) {
-			const fullPath = join(current, entry.name);
+			const fullPath = join$1(current, entry.name);
 			if (entry.isDirectory()) {
 				if (entry.name === "node_modules" || entry.name.startsWith(".") && entry.name !== ".ubean") continue;
 				await walk(fullPath);
@@ -111,7 +177,7 @@ function createFsOps(cwd) {
 		restoreBackup: (path, opts) => restoreBackup(resolvePath(cwd, path), opts),
 		removeBackup: (path, opts) => removeBackup(resolvePath(cwd, path), opts),
 		listFiles: (dir, pattern) => listFiles(resolvePath(cwd, dir || "."), pattern),
-		relative: (to) => relative(cwd, resolve(cwd, to))
+		relative: (to) => relative$1(cwd, resolve$1(cwd, to))
 	};
 }
 //#endregion
@@ -583,32 +649,6 @@ const GLOBAL_MIDDLEWARE = [
 	"});",
 	""
 ].join("\n");
-const I18N_MIDDLEWARE = [
-	"import { defineMiddleware, createI18nMiddleware, setI18nConfig } from 'ubean';",
-	"",
-	"// Set global i18n config (used by localizePath, switchLocalePath, etc.)",
-	"// Locale messages are auto-loaded by ubean:locales virtual module.",
-	"setI18nConfig({",
-	"  defaultLocale: 'en',",
-	"  strategy: 'prefix_except_default',",
-	"  locales: ['en', 'zh']",
-	"});",
-	"",
-	"// Create i18n middleware instance once.",
-	"const i18nHandler = createI18nMiddleware({",
-	"  strategy: 'prefix_except_default',",
-	"  defaultLocale: 'en',",
-	"  locales: ['en', 'zh'],",
-	"  detectFromHeader: true,",
-	"  detectFromCookie: true,",
-	"  redirectOnLocaleMismatch: false",
-	"});",
-	"",
-	"export default defineMiddleware(async (c, next) => {",
-	"  return i18nHandler(c, next);",
-	"});",
-	""
-].join("\n");
 const HELLO_API = `import { pipe, description, object, string, number } from 'valibot';
 import { defineHandler, describeRoute, resolver } from 'ubean';
 
@@ -990,71 +1030,50 @@ const ZH_LOCALE = `{
 }
 `;
 /** ubean logo SVG — 所有模板共用 */
-const FAVICON_SVG = `<svg width="100%" height="100%" version="1.1" viewBox="0 0 1000 1000" xmlns="http://www.w3.org/2000/svg"
-  xmlns:xlink="http://www.w3.org/1999/xlink">
+const FAVICON_SVG = `<svg width="100%" height="100%" version="1.1" viewBox="0 0 1000 1000" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
   <g>
-    <path
-      d="M 200,866 C 100,866 50,779.4 100,692.8 L 200,519.6 C 220,485 240,490 265,499.6 S 360,542.68 360,542.68 C 480.5,601 498,642.5 500,720 C 498,811 462,856 420,866"
-      fill="url(#LinearGradient)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path
-      d="M 420,866 C 455,861 478,846 500,827 C 614,696 615,597 500,517 C 394,444 333,374 380,207.82 L 260,415.67 C 240.22,450 254.37,465.1 275.28,481.79 S 360,542.68 360,542.68 C 480.5,601 498,642.5 500,720 C 498,811 462,856 420,866"
-      fill="url(#LinearGradient_2)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path d="M 500,517 C 394,444 333,374 380,207.82 L 400,173.2 C 367,295 421,350 603,428 C 572,440 524,474 500,517"
-      fill="url(#LinearGradient_3)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path d="M 500,827 L 660,660 C 738,589 710,482 603,428 C 572,440 524,474 500,517 C 615,597 614,696 500,827"
-      fill="url(#LinearGradient_4)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path d="M 400,173.2 C 367,295 421,350 603,428 C 690,389, 750,445 788,500 L 600,173.2 C 550,86.6 450,86.6 400,173.2"
-      fill="url(#LinearGradient_5)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path
-      d="M 500,827 L 660,660 C 738,589 710,482 603,428 C 690,389, 750,445 788,500 C 816,554 797,606 750,640 L 500,827"
-      fill="url(#LinearGradient_6)" fill-rule="nonzero" opacity="1" stroke="none" />
-    <path
-      d="M 788,500 C 816,554 797,606 750,640 L 500,827 C 497,851 513,862 540,866 L 800,866 C 900,866 950,779.4 900,692.8 L 788,500"
-      fill="url(#LinearGradient_7)" fill-rule="nonzero" opacity="1" stroke="none" />
-
-  <!--左下角图案-->
+    <path d="M 200,866 C 100,866 50,779.4 100,692.8 L 200,519.6 C 220,485 240,490 265,499.6 S 360,542.68 360,542.68 C 480.5,601 498,642.5 500,720 C 498,811 462,856 420,866" fill="url(#LinearGradient)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 420,866 C 455,861 478,846 500,827 C 614,696 615,597 500,517 C 394,444 333,374 380,207.82 L 260,415.67 C 240.22,450 254.37,465.1 275.28,481.79 S 360,542.68 360,542.68 C 480.5,601 498,642.5 500,720 C 498,811 462,856 420,866" fill="url(#LinearGradient_2)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 500,517 C 394,444 333,374 380,207.82 L 400,173.2 C 367,295 421,350 603,428 C 572,440 524,474 500,517" fill="url(#LinearGradient_3)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 500,827 L 660,660 C 738,589 710,482 603,428 C 572,440 524,474 500,517 C 615,597 614,696 500,827" fill="url(#LinearGradient_4)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 400,173.2 C 367,295 421,350 603,428 C 690,389, 750,445 788,500 L 600,173.2 C 550,86.6 450,86.6 400,173.2" fill="url(#LinearGradient_5)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 500,827 L 660,660 C 738,589 710,482 603,428 C 690,389, 750,445 788,500 C 816,554 797,606 750,640 L 500,827" fill="url(#LinearGradient_6)" fill-rule="nonzero" opacity="1" stroke="none"/>
+    <path d="M 788,500 C 816,554 797,606 750,640 L 500,827 C 497,851 513,862 540,866 L 800,866 C 900,866 950,779.4 900,692.8 L 788,500" fill="url(#LinearGradient_7)" fill-rule="nonzero" opacity="1" stroke="none"/>
+  </g>
+<!--左下角图案-->
   <g transform="translate(130, 675) scale(7)">
     <g viewBox="0 0 24 24">
-      	<path fill="#ffffff" d="M4.528 5.118a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 12 10.535V21a1 1 0 0 1-1.555.832l-5.554-3.703A2 2 0 0 1 4 16.465V6a1 1 0 0 1 .528-.882m4-2a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 16 8.535V19a1 1 0 0 1-1.555.832l-.945-.63v-8.667a3.5 3.5 0 0 0-1.559-2.912L8 4.995V4a1 1 0 0 1 .528-.882m4-2a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 20 6.535V17a1 1 0 0 1-1.555.832l-.945-.63V8.534a3.5 3.5 0 0 0-1.559-2.912L12 2.995V2a1 1 0 0 1 .528-.882" />
-
+      <path fill="#ffffff" d="M4.528 5.118a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 12 10.535V21a1 1 0 0 1-1.555.832l-5.554-3.703A2 2 0 0 1 4 16.465V6a1 1 0 0 1 .528-.882m4-2a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 16 8.535V19a1 1 0 0 1-1.555.832l-.945-.63v-8.667a3.5 3.5 0 0 0-1.559-2.912L8 4.995V4a1 1 0 0 1 .528-.882m4-2a1 1 0 0 1 1.027.05l5.554 3.703A2 2 0 0 1 20 6.535V17a1 1 0 0 1-1.555.832l-.945-.63V8.534a3.5 3.5 0 0 0-1.559-2.912L12 2.995V2a1 1 0 0 1 .528-.882"/>
     </g>
   </g>
-  </g>
   <defs>
-    <linearGradient gradientTransform="matrix(104.391 -73.3432 73.3432 104.391 277.441 710.122)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#30a772" />
-      <stop offset="1" stop-color="#30e191" />
+    <linearGradient gradientTransform="matrix(104.391 -73.3432 73.3432 104.391 277.441 710.122)" gradientUnits="userSpaceOnUse" id="LinearGradient" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#373ebf"/>
+      <stop offset="1" stop-color="#5058e6"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(-173.747 557.324 -557.324 -173.747 508.829 258.172)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_2" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#98f6cc" />
-      <stop offset="1" stop-color="#4aefa5" />
+    <linearGradient gradientTransform="matrix(-173.747 557.324 -557.324 -173.747 508.829 258.172)" gradientUnits="userSpaceOnUse" id="LinearGradient_2" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#c2d6ff"/>
+      <stop offset="1" stop-color="#646cff"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(157.951 295.666 -295.666 157.951 382.944 193.642)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_3" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#30e191" />
-      <stop offset="1" stop-color="#30a772" />
+    <linearGradient gradientTransform="matrix(157.951 295.666 -295.666 157.951 382.944 193.642)" gradientUnits="userSpaceOnUse" id="LinearGradient_3" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#5058e6"/>
+      <stop offset="1" stop-color="#373ebf"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(-44.3023 219.578 -219.578 -44.3023 619.69 469.652)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_4" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#6ff3b7" />
-      <stop offset="1" stop-color="#30e191" />
+    <linearGradient gradientTransform="matrix(-44.3023 219.578 -219.578 -44.3023 619.69 469.652)" gradientUnits="userSpaceOnUse" id="LinearGradient_4" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#91a7ff"/>
+      <stop offset="1" stop-color="#5058e6"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(125.52 334.256 -334.256 125.52 539.723 235.139)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_5" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#4aefa5" />
-      <stop offset="1" stop-color="#98f6cc" />
+    <linearGradient gradientTransform="matrix(125.52 334.256 -334.256 125.52 539.723 235.139)" gradientUnits="userSpaceOnUse" id="LinearGradient_5" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#646cff"/>
+      <stop offset="1" stop-color="#c2d6ff"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(-241.23 357.206 -357.206 -241.23 754.054 449.312)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_6" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#98f6cc" />
-      <stop offset="1" stop-color="#4aefa5" />
+    <linearGradient gradientTransform="matrix(-241.23 357.206 -357.206 -241.23 754.054 449.312)" gradientUnits="userSpaceOnUse" id="LinearGradient_6" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#c2d6ff"/>
+      <stop offset="1" stop-color="#646cff"/>
     </linearGradient>
-    <linearGradient gradientTransform="matrix(125.978 210.065 -210.065 125.978 596.433 613.665)"
-      gradientUnits="userSpaceOnUse" id="LinearGradient_7" x1="0" x2="1" y1="0" y2="0">
-      <stop offset="0" stop-color="#30a772" />
-      <stop offset="1" stop-color="#30e191" />
+    <linearGradient gradientTransform="matrix(125.978 210.065 -210.065 125.978 596.433 613.665)" gradientUnits="userSpaceOnUse" id="LinearGradient_7" x1="0" x2="1" y1="0" y2="0">
+      <stop offset="0" stop-color="#373ebf"/>
+      <stop offset="1" stop-color="#5058e6"/>
     </linearGradient>
   </defs>
 </svg>
@@ -1242,7 +1261,6 @@ async function scaffoldUnifyTemplate(fs, options) {
 	await fs.writeFile("src/pages/about2.reuse.ts", ABOUT_REUSE);
 	await fs.writeFile("src/pages/(admin)/dashboard.vue", DASHBOARD_PAGE);
 	await fs.writeFile("src/middleware/01.global.ts", GLOBAL_MIDDLEWARE);
-	await fs.writeFile("src/middleware/02.i18n.ts", I18N_MIDDLEWARE);
 	await fs.writeFile("src/routes/api/hello-world.ts", HELLO_API);
 	await fs.writeFile("src/components/IslandCounter.vue", ISLAND_COUNTER);
 	await fs.writeFile("src/components/IslandClock.vue", ISLAND_CLOCK);
@@ -1301,46 +1319,46 @@ async function scaffoldBlogTemplate(fs, options) {
 //#region src/page.ts
 const logger = getLogger("cli");
 function getSrcDir(cwd) {
-	return join(cwd, "src");
+	return join$1(cwd, "src");
 }
 function getDirForType(cwd, type) {
 	const srcDir = getSrcDir(cwd);
 	switch (type) {
 		case "page":
-		case "reuse": return join(srcDir, "pages");
-		case "api": return join(srcDir, "routes");
-		case "layout": return join(srcDir, "layouts");
-		case "middleware": return join(srcDir, "middleware");
-		case "cron": return join(srcDir, "server", "crons");
-		case "plugin": return join(srcDir, "plugins");
+		case "reuse": return join$1(srcDir, "pages");
+		case "api": return join$1(srcDir, "routes");
+		case "layout": return join$1(srcDir, "layouts");
+		case "middleware": return join$1(srcDir, "middleware");
+		case "cron": return join$1(srcDir, "server", "crons");
+		case "plugin": return join$1(srcDir, "plugins");
 		default: return srcDir;
 	}
 }
 /** Resolve a baseDir that may be relative or absolute into an absolute path. */
 function resolveBaseDir(cwd, baseDir) {
-	return baseDir.startsWith("/") ? baseDir : join(cwd, baseDir);
+	return baseDir.startsWith("/") ? baseDir : join$1(cwd, baseDir);
 }
 function resolveTargetPath(baseDir, path, type) {
 	let normalizedPath = path.startsWith("/") ? path.slice(1) : path;
 	if (normalizedPath === "" || normalizedPath === "/") normalizedPath = type === "page" || type === "reuse" ? "index" : "index";
 	if (type === "page" || type === "layout" || type === "reuse") {
 		if (type === "page" || type === "layout") {
-			if (normalizedPath.endsWith(".vue")) return join(baseDir, normalizedPath);
+			if (normalizedPath.endsWith(".vue")) return join$1(baseDir, normalizedPath);
 			const ext = ".vue";
-			if (normalizedPath.endsWith("/") || normalizedPath === "") return join(baseDir, normalizedPath, `index${ext}`);
-			return join(baseDir, `${normalizedPath}${ext}`);
+			if (normalizedPath.endsWith("/") || normalizedPath === "") return join$1(baseDir, normalizedPath, `index${ext}`);
+			return join$1(baseDir, `${normalizedPath}${ext}`);
 		}
-		if (normalizedPath.endsWith(".reuse.ts")) return join(baseDir, normalizedPath);
-		if (normalizedPath.endsWith(".ts")) return join(baseDir, normalizedPath.replace(/\.ts$/, ".reuse.ts"));
+		if (normalizedPath.endsWith(".reuse.ts")) return join$1(baseDir, normalizedPath);
+		if (normalizedPath.endsWith(".ts")) return join$1(baseDir, normalizedPath.replace(/\.ts$/, ".reuse.ts"));
 		const ext = ".reuse.ts";
-		if (normalizedPath.endsWith("/") || normalizedPath === "") return join(baseDir, normalizedPath, `index${ext}`);
-		return join(baseDir, `${normalizedPath}${ext}`);
+		if (normalizedPath.endsWith("/") || normalizedPath === "") return join$1(baseDir, normalizedPath, `index${ext}`);
+		return join$1(baseDir, `${normalizedPath}${ext}`);
 	}
-	if (normalizedPath.endsWith(".ts") || normalizedPath.endsWith(".js")) return join(baseDir, normalizedPath);
+	if (normalizedPath.endsWith(".ts") || normalizedPath.endsWith(".js")) return join$1(baseDir, normalizedPath);
 	const ext = ".ts";
-	if (normalizedPath.endsWith("/") || normalizedPath === "") return join(baseDir, normalizedPath, `index${ext}`);
-	if ((type === "api" || type === "middleware" || type === "cron" || type === "plugin") && !normalizedPath.includes(".")) return join(baseDir, `${normalizedPath}${ext}`);
-	return join(baseDir, normalizedPath);
+	if (normalizedPath.endsWith("/") || normalizedPath === "") return join$1(baseDir, normalizedPath, `index${ext}`);
+	if ((type === "api" || type === "middleware" || type === "cron" || type === "plugin") && !normalizedPath.includes(".")) return join$1(baseDir, `${normalizedPath}${ext}`);
+	return join$1(baseDir, normalizedPath);
 }
 function sanitizeNameSegment(seg) {
 	return seg.replace(/^\[\.\.\.(.+)\]$/, "All$1").replace(/^\[\[(.+)\]\]$/, "$1Optional").replace(/^\[(.+)\]$/, "$1").replace(/[^a-zA-Z0-9$_]/g, "");
@@ -1721,4 +1739,4 @@ const pageCommand = {
 	}
 };
 //#endregion
-export { toCamelCase as C, createFsOps as E, renderTemplate as S, toPascalCase as T, renderCronTemplate as _, scaffold as a, renderPageTemplate as b, scaffoldStarterTemplate as c, CRON_TEMPLATE as d, LAYOUT_TEMPLATE as f, renderApiTemplate as g, PLUGIN_TEMPLATE as h, recoverScaffold as i, scaffoldUnifyTemplate as l, PAGE_TEMPLATE as m, listScaffoldableFiles as n, scaffoldBlogTemplate as o, MIDDLEWARE_TEMPLATE as p, pageCommand as r, scaffoldMinimalTemplate as s, deleteScaffold as t, API_TEMPLATE as u, renderLayoutTemplate as v, toKebabCase as w, renderPluginTemplate as x, renderMiddlewareTemplate as y };
+export { summarizeBundle as A, toCamelCase as C, compareBundleBaseline as D, createFsOps as E, findClientManifest as O, renderTemplate as S, toPascalCase as T, renderCronTemplate as _, scaffold as a, renderPageTemplate as b, scaffoldStarterTemplate as c, CRON_TEMPLATE as d, LAYOUT_TEMPLATE as f, renderApiTemplate as g, PLUGIN_TEMPLATE as h, recoverScaffold as i, writeBundleBaseline as j, readViteManifest as k, scaffoldUnifyTemplate as l, PAGE_TEMPLATE as m, listScaffoldableFiles as n, scaffoldBlogTemplate as o, MIDDLEWARE_TEMPLATE as p, pageCommand as r, scaffoldMinimalTemplate as s, deleteScaffold as t, API_TEMPLATE as u, renderLayoutTemplate as v, toKebabCase as w, renderPluginTemplate as x, renderMiddlewareTemplate as y };

package/dist/scaffold-manifest-TrH6OCX8.js

@@ -0,0 +1,116 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+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;
+};
+//#endregion
+//#region src/scaffold-manifest.ts
+var scaffold_manifest_exports = /* @__PURE__ */ __exportAll({
+	SCAFFOLD_CONTRACT_VERSION: () => 1,
+	getScaffoldManifest: () => getScaffoldManifest
+});
+const SCAFFOLD_CONTRACT_VERSION = 1;
+const TYPES = [
+	{
+		type: "page",
+		cli: true,
+		baseDir: "pages",
+		extensions: [".vue"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Route path (e.g. users/[id])"
+		}]
+	},
+	{
+		type: "api",
+		cli: true,
+		baseDir: "routes",
+		extensions: [".ts"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "API route path (e.g. users/[id])"
+		}, {
+			name: "method",
+			required: false,
+			description: "HTTP method",
+			default: "GET"
+		}]
+	},
+	{
+		type: "layout",
+		cli: true,
+		baseDir: "layouts",
+		extensions: [".vue"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Layout name (e.g. admin)"
+		}]
+	},
+	{
+		type: "middleware",
+		cli: true,
+		baseDir: "middleware",
+		extensions: [".ts"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Middleware path (e.g. auth)"
+		}]
+	},
+	{
+		type: "cron",
+		cli: true,
+		baseDir: "server/crons",
+		extensions: [".ts"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Cron task path (e.g. daily-cleanup)"
+		}, {
+			name: "schedule",
+			required: false,
+			description: "Cron expression",
+			default: "* * * * *"
+		}]
+	},
+	{
+		type: "plugin",
+		cli: true,
+		baseDir: "plugins",
+		extensions: [".ts"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Plugin path (e.g. analytics)"
+		}]
+	},
+	{
+		type: "reuse",
+		cli: false,
+		baseDir: "pages",
+		extensions: [".reuse.ts", ".reuse.vue"],
+		args: [{
+			name: "path",
+			required: true,
+			description: "Reuse route path; library API only (`scaffold({ type: \"reuse\" })`)"
+		}]
+	}
+];
+/** Machine-readable scaffold catalog for studio / IDE plugins (RM-S01). */
+function getScaffoldManifest() {
+	return {
+		contractVersion: 1,
+		types: TYPES
+	};
+}
+//#endregion
+export { getScaffoldManifest as n, scaffold_manifest_exports as r, SCAFFOLD_CONTRACT_VERSION as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ubean/cli",
-  "version": "0.2.1",
-  "description": "CLI for ubean (ubean-next binary: dev, build, prepare, init, preview, page, env, config, devtools, api/layout/middleware/cron/plugin scaffolds)",
+  "version": "0.3.0",
+  "description": "CLI for ubean (ubean-next binary: dev, build, prepare, init, preview, page, env, config, devtools, api/layout/middleware/cron/plugin scaffolds) plus the Vite dev server runner",
   "bin": {
     "ubean-next": "./bin/ubean-next.mjs"
   },
@@ -27,29 +27,40 @@
     "citty": "^0.2.2",
     "kolorist": "^1.8.0",
     "pathe": "^2.0.3",
-    "@ubean/app": "0.2.1",
-    "@ubean/build": "0.2.1",
-    "@ubean/codegen": "0.2.1",
-    "@ubean/config": "0.2.1",
-    "@ubean/dev-server": "0.2.1",
-    "@ubean/logger": "0.2.1",
-    "@ubean/preset": "0.2.1",
-    "@ubean/prerender": "0.2.1",
-    "@ubean/scan": "0.2.1",
-    "@ubean/shared": "0.2.1",
-    "@ubean/modules": "0.2.1"
+    "@ubean/app": "0.3.0",
+    "@ubean/build": "0.3.0",
+    "@ubean/client": "0.3.0",
+    "@ubean/preset": "0.3.0",
+    "@ubean/islands": "0.3.0",
+    "@ubean/scan": "0.3.0",
+    "@ubean/shared": "0.3.0",
+    "@ubean/config": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "@vitejs/plugin-vue": "^6.0.8",
     "typescript": "7.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.9",
     "vite-plus": "0.2.9"
   },
   "peerDependencies": {
-    "@ubean/devtools": "0.2.1"
+    "@vitejs/plugin-vue": "^6.0.8",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.9",
+    "@ubean/content": "0.3.0",
+    "@ubean/devtools": "0.3.0"
   },
   "peerDependenciesMeta": {
+    "@ubean/content": {
+      "optional": true
+    },
     "@ubean/devtools": {
       "optional": true
+    },
+    "@vitejs/plugin-vue": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
   "scripts": {