@ubean/cli 0.2.2 → 0.3.1

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-DU64g_Lv.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-DU64g_Lv.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';
 
@@ -1221,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);
@@ -1280,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, "");
@@ -1700,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.2",
-  "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.1",
+  "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"
   },
@@ -24,32 +24,43 @@
     }
   },
   "dependencies": {
+    "@ubean/app": "0.3.1",
+    "@ubean/build": "0.3.1",
+    "@ubean/client": "0.3.1",
+    "@ubean/config": "0.3.1",
+    "@ubean/islands": "0.3.1",
+    "@ubean/preset": "0.3.1",
+    "@ubean/scan": "0.3.1",
+    "@ubean/shared": "0.3.1",
     "citty": "^0.2.2",
     "kolorist": "^1.8.0",
-    "pathe": "^2.0.3",
-    "@ubean/build": "0.2.2",
-    "@ubean/app": "0.2.2",
-    "@ubean/codegen": "0.2.2",
-    "@ubean/config": "0.2.2",
-    "@ubean/dev-server": "0.2.2",
-    "@ubean/logger": "0.2.2",
-    "@ubean/modules": "0.2.2",
-    "@ubean/preset": "0.2.2",
-    "@ubean/prerender": "0.2.2",
-    "@ubean/shared": "0.2.2",
-    "@ubean/scan": "0.2.2"
+    "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.0",
+    "@vitejs/plugin-vue": "^6.0.8",
     "typescript": "7.0.2",
-    "vite-plus": "0.2.9"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
+    "vite-plus": "0.3.0"
   },
   "peerDependencies": {
-    "@ubean/devtools": "0.2.2"
+    "@ubean/content": "0.3.1",
+    "@ubean/devtools": "0.3.1",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0"
   },
   "peerDependenciesMeta": {
+    "@ubean/content": {
+      "optional": true
+    },
     "@ubean/devtools": {
       "optional": true
+    },
+    "@vitejs/plugin-vue": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
   "scripts": {