@ubean/scan 0.3.6 → 0.4.0

package/dist/index.js

@@ -1,5 +1,5 @@
 import { GLOB_SCAN_PATTERN, HTTP_METHODS } from "./types.js";
-import { readFile } from "node:fs/promises";
+import { readFile, readdir } from "node:fs/promises";
 import { getLogger } from "@ubean/shared/logger";
 import { extractCallObject, extractDefinePage, extractDefinePageFromCode, extractSlotAndIntercept, filePathToRoute, filePathToRoute as filePathToRoute$1, generateLayoutName, generateRouteName, generateRouteName as generateRouteName$1, parseMatchers, scanPages, stripRouteGroups } from "@ubean/vue/vite";
 import { basename, dirname, extname, isAbsolute, join, relative } from "pathe";
@@ -469,14 +469,30 @@ async function scanAppEntry(srcDir) {
 		}
 		return { exists: false };
 	};
-	const [shared, server, client] = await Promise.all([
+	const scanRootApp = async () => {
+		let entries;
+		try {
+			entries = await readdir(srcDir);
+		} catch {
+			return { exists: false };
+		}
+		for (const name of ["app.vue", "App.vue"]) if (entries.includes(name)) return {
+			exists: true,
+			fullPath: join(srcDir, name),
+			relativePath: name
+		};
+		return { exists: false };
+	};
+	const [shared, server, client, root] = await Promise.all([
 		findEntry("app"),
 		findEntry("app.server"),
-		findEntry("app.client")
+		findEntry("app.client"),
+		scanRootApp()
 	]);
 	result.shared = shared;
 	result.server = server;
 	result.client = client;
+	if (root.exists) result.root = root;
 	return result;
 }
 async function scanServerEntry(srcDir) {

package/dist/types.d.ts

@@ -60,6 +60,20 @@ interface ScannedAppEntry {
   shared: AppEntry;
   server: AppEntry;
   client: AppEntry;
+  /**
+   * `src/app.vue` / `src/App.vue` — 应用根组件(包装组件,可选)。
+   *
+   * 两种命名都支持(经典 Vue `App.vue` 大写约定 / Nuxt 风格小写
+   * `app.vue`),仅 `.vue` 扩展(defineApp 配置入口 `app.ts`/
+   * `app.server.ts`/`app.client.ts` 已占用 ts/js 命名)。若两者同时存在,
+   * **小写 `app.vue` 优先**(与配置入口共用 `app` 词根,扩展名不同可共存)。
+   *
+   * 当用户显式配置 `defineApp({ appRoot })` 时,该文件作为回退
+   * (优先级:`defineApp({ appRoot })` > `src/app.vue` > `src/App.vue`)。
+   * 组件渲染约定:框架出口(布局链 + 页面)通过默认 slot 注入,组件内用
+   * `<slot />` 声明渲染位置。
+   */
+  root?: AppEntry;
 }
 interface ScannedServerEntry {
   shared: AppEntry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/scan",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "Project scanner & route metadata for ubean — server-side directory scanning (API routes, middleware, plugins, crons, queues, locales, entries) plus page scanning delegated to @ubean/vue",
   "files": [
     "dist"
@@ -24,14 +24,14 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.3.6",
-    "@ubean/vue": "0.3.6",
+    "@ubean/shared": "0.4.0",
+    "@ubean/vue": "0.4.0",
     "pathe": "^2.0.3",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "@ubean/markdown": "0.3.6",
+    "@ubean/markdown": "0.4.0",
     "typescript": "7.0.2",
     "vite-plus": "0.3.0",
     "vue": "^3.5.42",