@ubean/build 0.2.2 → 0.3.0

package/dist/vue-BJO18Lwe.js

@@ -0,0 +1,694 @@
+import { a as useVirtualRegistry, n as defineVirtualModule } from "./virtual-registry-BWkaQHXN.js";
+import { c as getCssImports, i as ssrSingletonDevPolicy, s as getComponentResolvers } from "./ssr-singleton-CEQi_H6-.js";
+import { f as UBEAN_CLIENT_PRESET, p as UBEAN_SERVER_PRESET } from "./codegen-D6ewf11I.js";
+import { createRequire } from "node:module";
+import { join } from "pathe";
+import { scanProject } from "@ubean/scan";
+import { getVueLocaleParam } from "@ubean/i18n";
+import { transformWithOxc } from "vite";
+import Components from "unplugin-vue-components/vite";
+import Markdown from "unplugin-vue-markdown/vite";
+import AutoImport from "unplugin-auto-import/vite";
+import VueI18nPlugin from "@intlify/unplugin-vue-i18n/vite";
+import { getColorModeScript, getPartyTownScript, resolveColorModeConfig, resolvePartyTownConfig } from "@ubean/client";
+import { ubeanMdxPlugin } from "@ubean/markdown";
+import { renderFaviconLink } from "@ubean/pages";
+import { generatePagesModuleSource } from "@ubean/vue/vite";
+//#region src/vue-virtual-modules.ts
+/**
+* 页面虚拟模块(`virtual:ubean-pages`)。
+*
+* 生成逻辑已沉淀到 `@ubean/vue/vite` 的 `generatePagesModuleSource`
+* (页面路由唯一所有者,与精简内核 `virtual:ubean-vue-routes` 共用同一
+* 生成器)。此处仅保留框架层的模块 ID 注册(`defineVirtualModule`)与
+* 兼容签名;route meta 相比旧版额外携带 `matchers` / `transition` /
+* `requiresAuth` / `head` / `definePage({ meta })` 透传字段(超集,
+* 使 `createMatcherGuard()` 与 SPA head guard 在框架模式下同样可用)。
+*/
+function createVuePagesVirtualModule(pages, layouts, notFoundPage, loadingPage, errorPage, localeVueParam) {
+	return defineVirtualModule("virtual:ubean-pages", () => generatePagesModuleSource({
+		pages,
+		layouts,
+		notFoundPage,
+		loadingPage,
+		errorPage
+	}, { vueParam: localeVueParam }));
+}
+const EMPTY_APP_ENTRY = {
+	shared: { exists: false },
+	server: { exists: false },
+	client: { exists: false }
+};
+function createVueAppEntryVirtualModule(appEntry = EMPTY_APP_ENTRY) {
+	return defineVirtualModule("virtual:ubean-app", () => {
+		const hasSharedApp = appEntry.shared.exists;
+		const hasServerApp = appEntry.server.exists;
+		const hasClientApp = appEntry.client.exists;
+		return `${`
+// Auto-generated by ubean - do not edit
+/* eslint-disable */
+${hasSharedApp ? `import _sharedApp from ${JSON.stringify(appEntry.shared.fullPath)};` : "const _sharedApp = null;"}
+${hasServerApp ? `import _serverApp from ${JSON.stringify(appEntry.server.fullPath)};` : "const _serverApp = null;"}
+${hasClientApp ? `import _clientApp from ${JSON.stringify(appEntry.client.fullPath)};` : "const _clientApp = null;"}
+
+import {
+  createUbeanClientApp,
+  createUbeanSSRApp,
+  usePage,
+  useRouter,
+  useHead,
+  useSeoMeta,
+  Link,
+  Head,
+  getInitialPageData,
+  getInitialState,
+  defineApp,
+  applyAppConfig,
+  createDefaultAppConfig,
+  createClientHead,
+  createServerHead,
+  hydrateIslands,
+  hasPendingIslands,
+  scheduleIslandHydration,
+  configureI18nRuntime
+} from 'ubean/client';
+
+import { i18nConfig as _i18nConfig, loadLocale as _loadLocale } from 'ubean:locales';
+
+if (_i18nConfig && _i18nConfig.enabled !== false) {
+  configureI18nRuntime({
+    config: {
+      defaultLocale: _i18nConfig.defaultLocale,
+      locales: (_i18nConfig.locales || []).map(l => typeof l === 'string' ? l : l.code),
+      strategy: _i18nConfig.strategy || 'prefix_except_default',
+      fallbackLocale: _i18nConfig.fallbackLocale || _i18nConfig.defaultLocale,
+      cookieName: (_i18nConfig.detectBrowserLanguage && _i18nConfig.detectBrowserLanguage.cookieName) || 'ubean_locale',
+      baseUrl: _i18nConfig.baseUrl || '',
+      vueI18n: _i18nConfig.vueI18n
+    },
+    loadLocale: _loadLocale,
+    locales: (_i18nConfig.locales || []).map(l => typeof l === 'string' ? { code: l } : l)
+  });
+}
+
+export {
+  createUbeanClientApp,
+  createUbeanSSRApp,
+  usePage,
+  useRouter,
+  useHead,
+  useSeoMeta,
+  Link,
+  Head,
+  getInitialPageData,
+  getInitialState,
+  defineApp,
+  applyAppConfig,
+  createDefaultAppConfig
+};
+
+import {
+  routes,
+  resolvePageComponent,
+  resolveLayoutComponent,
+  defaultLayout,
+  pageNames,
+  layoutNames,
+  resolveLoadingComponent,
+  resolveErrorComponent,
+  hasNotFoundPage,
+  hasErrorPage
+} from 'virtual:ubean-pages';
+
+export {
+  routes,
+  resolvePageComponent,
+  resolveLayoutComponent,
+  defaultLayout,
+  pageNames,
+  layoutNames,
+  resolveLoadingComponent,
+  resolveErrorComponent,
+  hasNotFoundPage,
+  hasErrorPage
+};
+
+function _mergeAppConfig(base, ...configs) {
+  const result = { ...base };
+  for (const cfg of configs) {
+    if (!cfg) continue;
+    if (cfg.plugins) result.plugins = [...(result.plugins || []), ...cfg.plugins];
+    if (cfg.globalComponents) result.globalComponents = { ...(result.globalComponents || {}), ...cfg.globalComponents };
+    if (cfg.provides) result.provides = { ...(result.provides || {}), ...cfg.provides };
+    if (cfg.head) result.head = { ...(result.head || {}), ...cfg.head };
+    if (cfg.rootId) result.rootId = cfg.rootId;
+    if (cfg.rootAttrs) result.rootAttrs = { ...(result.rootAttrs || {}), ...cfg.rootAttrs };
+    if (cfg.onAppCreated) result.onAppCreated = cfg.onAppCreated;
+    if (cfg.onClientReady) result.onClientReady = cfg.onClientReady;
+    if (cfg.errorComponent) result.errorComponent = cfg.errorComponent;
+    if (cfg.loadingComponent) result.loadingComponent = cfg.loadingComponent;
+    if (cfg.viewTransitions !== undefined) result.viewTransitions = cfg.viewTransitions;
+    if (cfg.serializeState) result.serializeState = cfg.serializeState;
+    if (cfg.hydrateState) result.hydrateState = cfg.hydrateState;
+  }
+  // router.setup:累加语义 — shared 和 client/server 各自定义的 setup 都会执行
+  // (顺序:shared 先,client/server 后)。这样 shared 可放通用守卫(如埋点),
+  // client/server 可放环境专用守卫(如 SSR 鉴权)。
+  const setups = [];
+  for (const cfg of [base, ...configs]) {
+    if (cfg?.router?.setup) setups.push(cfg.router.setup);
+  }
+  if (setups.length === 1) {
+    result.router = { setup: setups[0] };
+  } else if (setups.length > 1) {
+    result.router = {
+      setup: (router) => {
+        for (const s of setups) s(router);
+      }
+    };
+  }
+  return result;
+}
+
+export function resolveAppConfig(mode) {
+  const base = createDefaultAppConfig();
+  if (!_sharedApp && !_serverApp && !_clientApp) return base;
+
+  const sharedCfg = typeof _sharedApp === 'function' ? _sharedApp() : _sharedApp;
+  const serverCfg = mode === 'server' && _serverApp ? (typeof _serverApp === 'function' ? _serverApp() : _serverApp) : null;
+  const clientCfg = mode === 'client' && _clientApp ? (typeof _clientApp === 'function' ? _clientApp() : _clientApp) : null;
+
+  const merged = _mergeAppConfig(base, sharedCfg, mode === 'server' ? serverCfg : clientCfg);
+
+  // onAppCreated: shared config is the default; server/client-specific overrides it if present.
+  if (sharedCfg?.onAppCreated) merged.onAppCreated = sharedCfg.onAppCreated;
+  if (mode === 'client' && clientCfg?.onClientReady) merged.onClientReady = clientCfg.onClientReady;
+  else if (mode === 'server' && serverCfg?.onAppCreated) merged.onAppCreated = serverCfg.onAppCreated;
+
+  return merged;
+}
+
+export async function createApp() {
+  const config = resolveAppConfig('client');
+  const head = createClientHead();
+
+  // Push global app head (from defineApp) as defaults before any page-level head.
+  if (config.head) {
+    const headInput = {};
+    if (config.head.title) headInput.title = config.head.title;
+    if (config.head.htmlAttrs) headInput.htmlAttrs = config.head.htmlAttrs;
+    if (config.head.bodyAttrs) headInput.bodyAttrs = config.head.bodyAttrs;
+    if (config.head.meta) headInput.meta = config.head.meta;
+    if (config.head.link) headInput.link = config.head.link;
+    if (config.head.script) headInput.script = config.head.script;
+    head.push(headInput);
+  }
+
+  // Resolve the auto-detected loading/error components from pages/loading.vue
+  // and pages/error.vue. These loaders return Promises (dynamic imports), so
+  // they MUST be awaited — otherwise 'resolveComp' markRaw's the unresolved
+  // Promise object and passes it to <Suspense>/<ErrorBoundary> as the
+  // 'component' prop, causing "Hydration node mismatch: server <div> vs
+  // client Symbol(v-fgt)" (rendering a Promise produces a fragment).
+  // defineApp({ loadingComponent/errorComponent }) takes priority.
+  const loadingComponent = config.loadingComponent || (await resolveLoadingComponent()) || undefined;
+  const errorComponent = config.errorComponent || (await resolveErrorComponent()) || undefined;
+
+  const initialPage = getInitialPageData();
+  const instance = createUbeanClientApp({
+    routes,
+    resolveLayoutComponent,
+    defaultLayout,
+    head,
+    viewTransitions: config.viewTransitions,
+    initialPage: initialPage || undefined,
+    hydrate: !!initialPage,
+    routerSetup: config.router?.setup,
+    loadingComponent,
+    errorComponent
+  });
+
+  applyAppConfig(instance.app, config, 'client');
+
+  if (config.onAppCreated) config.onAppCreated(instance.app);
+
+  // SSR 状态水合:在 applyAppConfig(注册插件)之后、mount 之前调用。
+  // getInitialState() 从 DOM 的 __UBEAN_STATE__ script 读取服务端
+  // serializeState 产生的状态对象(如 Pinia 的 state)。
+  // 必须在 mount 前执行,否则 store 已初始化为默认值,水合无效。
+  if (config.hydrateState) {
+    const state = getInitialState();
+    config.hydrateState(instance.app, state);
+  }
+
+  const mountApp = () => {
+    instance.app.mount('#' + (config.rootId || 'app'));
+    if (config.onClientReady) {
+      config.onClientReady(instance.app);
+    }
+    // Islands: first mount always waits two rAFs so Vue's patch finishes.
+    // SPA afterEach waits one rAF, then skips the second when no pending islands.
+    var appRoot = function () {
+      return document.getElementById('app') || undefined;
+    };
+    var hydrateNow = function () {
+      hydrateIslands({ appContext: instance.app, root: appRoot() });
+    };
+    var pendingIslands = function () {
+      return hasPendingIslands(appRoot());
+    };
+    scheduleIslandHydration({
+      requestAnimationFrame: requestAnimationFrame,
+      hasPending: pendingIslands,
+      hydrate: hydrateNow,
+      forceDoubleFrame: true
+    });
+    instance.router.afterEach(function () {
+      scheduleIslandHydration({
+        requestAnimationFrame: requestAnimationFrame,
+        hasPending: pendingIslands,
+        hydrate: hydrateNow
+      });
+    });
+  };
+
+  // When hydrating SSR content, must wait for router to be ready before mounting,
+  // otherwise RouterView has no matched route and causes hydration mismatch.
+  if (initialPage) {
+    instance.router.isReady().then(mountApp);
+  } else {
+    mountApp();
+  }
+
+  return instance;
+}
+
+export async function createSSRApp(initialPage) {
+  const config = resolveAppConfig('server');
+  const head = createServerHead();
+
+  // SSR doesn't need Suspense fallback (server resolves async synchronously),
+  // but we still pass it for consistency. Await the loaders so resolved
+  // Component values (not Promises) are passed to createUbeanSSRApp.
+  const loadingComponent = config.loadingComponent || (await resolveLoadingComponent()) || undefined;
+
+  const errorComponent = config.errorComponent || (await resolveErrorComponent()) || undefined;
+
+  const { app, router } = createUbeanSSRApp(initialPage, {
+    routes,
+    resolveLayoutComponent,
+    defaultLayout,
+    head,
+    routerSetup: config.router?.setup,
+    loadingComponent,
+    errorComponent
+  });
+
+  applyAppConfig(app, config, 'server');
+
+  if (config.onAppCreated) config.onAppCreated(app);
+
+  return { app, router, head, config };
+}
+
+export const rootId = 'app';
+`.trim()}\n`;
+	});
+}
+function createClientEntryVirtualModule() {
+	return defineVirtualModule("virtual:ubean-client-entry", () => {
+		return `${`
+// Auto-generated by ubean client entry - do not edit
+/* eslint-disable */
+${getCssImports().map((css) => `import ${JSON.stringify(css)};`).join("\n")}
+import { createApp } from 'virtual:ubean-app';
+
+createApp();
+`.trim()}\n`;
+	});
+}
+const EMPTY_SERVER_ENTRY = {
+	shared: { exists: false },
+	dev: { exists: false },
+	prod: { exists: false }
+};
+function createServerEntryVirtualModule(serverEntry = EMPTY_SERVER_ENTRY) {
+	return defineVirtualModule("virtual:ubean-server", () => {
+		const hasShared = serverEntry.shared.exists;
+		const hasDev = serverEntry.dev.exists;
+		const hasProd = serverEntry.prod.exists;
+		return `${`
+// Auto-generated by ubean server entry - do not edit
+/* eslint-disable */
+${hasShared ? `import _sharedServer from ${JSON.stringify(serverEntry.shared.fullPath)};` : "const _sharedServer = null;"}
+${hasDev ? `import _devServer from ${JSON.stringify(serverEntry.dev.fullPath)};` : "const _devServer = null;"}
+${hasProd ? `import _prodServer from ${JSON.stringify(serverEntry.prod.fullPath)};` : "const _prodServer = null;"}
+
+import {
+  defineServer,
+  createDefaultServerConfig,
+  mergeServerConfigs
+} from 'ubean/runtime/app';
+
+export {
+  defineServer,
+  createDefaultServerConfig,
+  mergeServerConfigs
+};
+
+/**
+ * Resolve the user's server config for the given mode ('dev' | 'prod').
+ * Merges shared config with mode-specific config. Returns an empty
+ * config when no server entry file exists.
+ */
+export function resolveServerConfig(mode) {
+  const base = createDefaultServerConfig();
+
+  if (!_sharedServer && !_devServer && !_prodServer) return base;
+
+  const sharedCfg = typeof _sharedServer === 'function' ? _sharedServer() : _sharedServer;
+  const modeCfg = mode === 'dev'
+    ? (typeof _devServer === 'function' ? _devServer() : _devServer)
+    : (typeof _prodServer === 'function' ? _prodServer() : _prodServer);
+
+  return mergeServerConfigs(base, sharedCfg, modeCfg);
+}
+`.trim()}\n`;
+	});
+}
+//#endregion
+//#region src/vue-plugin.ts
+const VUE_PLUGIN_INCLUDE = [/\.vue$/, /\.md$/];
+const VIRTUAL_PAGES = "virtual:ubean-pages";
+const VIRTUAL_APP = "virtual:ubean-app";
+const VIRTUAL_CLIENT = "virtual:ubean-client-entry";
+const VIRTUAL_SERVER = "virtual:ubean-server";
+const CLIENT_ENTRY_URL = `/@id/${VIRTUAL_CLIENT}`;
+const TS_VIRTUAL_IDS = [
+	VIRTUAL_PAGES,
+	VIRTUAL_APP,
+	VIRTUAL_SERVER
+];
+const VIRTUAL_IDS = [
+	VIRTUAL_PAGES,
+	VIRTUAL_APP,
+	VIRTUAL_CLIENT,
+	VIRTUAL_SERVER
+];
+const HASH_ID_TO_VIRTUAL = {
+	"#ubean-pages": VIRTUAL_PAGES,
+	"#ubean-app": VIRTUAL_APP,
+	"#ubean-client-entry": VIRTUAL_CLIENT,
+	"#ubean-server": VIRTUAL_SERVER
+};
+const NULL_PREFIX = "\0";
+const VIRTUAL_EXT = ".ts";
+function toResolvedVirtualId(virtualId) {
+	return NULL_PREFIX + virtualId + VIRTUAL_EXT;
+}
+function parseResolvedVirtualId(resolvedId) {
+	if (!resolvedId.startsWith(NULL_PREFIX)) return void 0;
+	const withoutPrefix = resolvedId.slice(1);
+	if (!withoutPrefix.endsWith(VIRTUAL_EXT)) return void 0;
+	const virtualId = withoutPrefix.slice(0, -3);
+	return VIRTUAL_IDS.includes(virtualId) ? virtualId : void 0;
+}
+function localeVueParamFromConfig(config) {
+	if (config.i18n?.enabled === false) return void 0;
+	const codes = (config.i18n?.locales || []).map((l) => l.code);
+	if (codes.length === 0) return void 0;
+	return getVueLocaleParam({
+		defaultLocale: config.i18n.defaultLocale,
+		locales: codes,
+		strategy: config.i18n.strategy
+	}) || void 0;
+}
+function ubeanVite(options) {
+	const { config: ubeanConfig } = options;
+	const virtualRegistry = useVirtualRegistry();
+	const srcDir = join(ubeanConfig.rootDir, ubeanConfig.srcDir);
+	const dtsDir = join(ubeanConfig.rootDir, ".ubean");
+	const markdownEnabled = ubeanConfig.markdown?.enabled !== false;
+	const mdxEnabled = ubeanConfig.markdown?.mdx === true;
+	const autoImportEnabled = ubeanConfig.imports.autoImport !== false;
+	const componentAutoImportEnabled = ubeanConfig.components.autoImport !== false;
+	const markdownComponentsAutoImport = ubeanConfig.markdown?.components?.autoImport !== false;
+	const directoryAsNamespace = ubeanConfig.components.directoryAsNamespace ?? false;
+	const composablesDirName = ubeanConfig.dir.composables || "composables";
+	const componentsDirName = ubeanConfig.dir.components || "components";
+	const composablesDirs = [join(srcDir, composablesDirName), ...ubeanConfig.imports.dirs || []];
+	const componentsDirs = [join(srcDir, componentsDirName), ...ubeanConfig.components.dirs || []];
+	const mdExtensions = mdxEnabled ? ["md", "mdx"] : ["md"];
+	function getVirtualModule(virtualId) {
+		return virtualRegistry.getModules().find((m) => m.id === virtualId);
+	}
+	async function loadVirtualModule(virtualId) {
+		const mod = getVirtualModule(virtualId);
+		if (!mod) return void 0;
+		return mod.load();
+	}
+	async function scanAndRegister() {
+		const result = await scanProject({
+			cwd: ubeanConfig.rootDir,
+			srcDir: ubeanConfig.srcDir,
+			dirs: ubeanConfig.dir,
+			ignore: ubeanConfig.scanOptions?.ignore
+		});
+		virtualRegistry.register(createVuePagesVirtualModule(result.pages, result.layouts, result.notFoundPage, result.loadingPage, result.errorPage, localeVueParamFromConfig(ubeanConfig)));
+		virtualRegistry.register(createVueAppEntryVirtualModule(result.appEntry));
+		virtualRegistry.register(createServerEntryVirtualModule(result.serverEntry));
+		virtualRegistry.register(createClientEntryVirtualModule());
+	}
+	const HASH_IDS = Object.keys(HASH_ID_TO_VIRTUAL);
+	const plugins = [{
+		name: "ubean:vue",
+		enforce: "pre",
+		async buildStart() {
+			await scanAndRegister();
+		},
+		resolveId(id, importer, opts) {
+			if (HASH_ID_TO_VIRTUAL[id]) return toResolvedVirtualId(HASH_ID_TO_VIRTUAL[id]);
+			if (VIRTUAL_IDS.includes(id)) return toResolvedVirtualId(id);
+			if (id === "@ubean/i18n" && !opts?.ssr) return this.resolve("@ubean/i18n/browser", importer, {
+				skipSelf: true,
+				...opts
+			});
+		},
+		async load(id) {
+			const virtualId = parseResolvedVirtualId(id);
+			if (virtualId) {
+				let code = await loadVirtualModule(virtualId);
+				if (code && TS_VIRTUAL_IDS.includes(virtualId)) code = (await transformWithOxc(code, `${virtualId}.ts`)).code;
+				return code;
+			}
+		},
+		config() {
+			const require = createRequire(import.meta.url);
+			let vueI18nEntry = "vue-i18n";
+			let intlifyCoreEntry = "@intlify/core";
+			let intlifyBaseEntry = "@intlify/core-base";
+			try {
+				vueI18nEntry = require.resolve("vue-i18n/dist/vue-i18n.esm-bundler.js");
+			} catch {
+				try {
+					vueI18nEntry = require.resolve("vue-i18n");
+				} catch {}
+			}
+			try {
+				intlifyCoreEntry = require.resolve("@intlify/core/dist/core.node.mjs");
+			} catch {}
+			try {
+				intlifyBaseEntry = require.resolve("@intlify/core-base/dist/core-base.mjs");
+			} catch {}
+			const singleton = ssrSingletonDevPolicy();
+			return {
+				appType: "custom",
+				resolve: {
+					...singleton.resolve,
+					alias: {
+						"vue-i18n": vueI18nEntry,
+						"@intlify/core": intlifyCoreEntry,
+						"@intlify/core-base": intlifyBaseEntry
+					}
+				},
+				optimizeDeps: {
+					exclude: [
+						...singleton.optimizeDeps.exclude,
+						...VIRTUAL_IDS,
+						...HASH_IDS
+					],
+					include: singleton.optimizeDeps.include
+				},
+				ssr: singleton.ssr
+			};
+		},
+		transformIndexHtml(html, ctx) {
+			if (ctx?.path?.includes("_devtools")) return html;
+			let result = html;
+			const colorModeConfig = ubeanConfig.colorMode;
+			if (colorModeConfig !== false) {
+				const script = getColorModeScript(resolveColorModeConfig(colorModeConfig));
+				result = result.replace("<head>", `<head>\n    ${script}`);
+			}
+			const partyTownConfig = ubeanConfig.partyTown;
+			if (partyTownConfig !== false && partyTownConfig !== void 0) {
+				const resolved = resolvePartyTownConfig(partyTownConfig === true ? { enabled: true } : partyTownConfig);
+				if (resolved.enabled) {
+					const script = getPartyTownScript(resolved);
+					if (script) result = result.replace("</head>", `    ${script}\n</head>`);
+				}
+			}
+			if (!/<link\b[^>]*rel=["']icon["']/i.test(result)) {
+				const faviconLink = renderFaviconLink(ubeanConfig.favicon ?? void 0);
+				if (faviconLink) result = result.replace("<head>", `<head>\n    ${faviconLink}`);
+			}
+			if (result.includes(CLIENT_ENTRY_URL) || result.includes(VIRTUAL_CLIENT)) return result;
+			return result.replace("</body>", `  <script type="module" src="${CLIENT_ENTRY_URL}"><\/script>\n</body>`);
+		},
+		configureServer(server) {
+			const watchDirs = [
+				"pages",
+				"layouts",
+				"app"
+			];
+			for (const dir of watchDirs) server.watcher.add(join(srcDir, dir));
+			async function handleFileChange(file) {
+				const rel = file.replace(`${srcDir}/`, "");
+				const isAppFile = /^app(\.(server|client))?\.(ts|js|mjs|mts)$/.test(rel);
+				const isServerFile = /^server(\.(dev|prod))?\.(ts|js|mjs|mts)$/.test(rel);
+				const isMarkdownFile = new RegExp(`\\.(${mdExtensions.join("|")})$`).test(rel);
+				if (isAppFile || isServerFile || watchDirs.some((d) => rel.startsWith(`${d}/`)) || isMarkdownFile) {
+					await scanAndRegister();
+					for (const vid of VIRTUAL_IDS) {
+						const mod = server.moduleGraph.getModuleById(toResolvedVirtualId(vid));
+						if (mod) server.moduleGraph.invalidateModule(mod);
+					}
+					server.ws.send({ type: "full-reload" });
+				}
+			}
+			server.watcher.on("add", handleFileChange);
+			server.watcher.on("unlink", handleFileChange);
+			server.watcher.on("change", handleFileChange);
+		}
+	}];
+	if (ubeanConfig.i18n?.enabled !== false) plugins.push(VueI18nPlugin({
+		include: [join(srcDir, "locales/**")],
+		ssr: true,
+		compositionOnly: true,
+		runtimeOnly: false
+	}));
+	if (markdownEnabled) {
+		const markdownOptions = {
+			...ubeanConfig.markdown?.markdownExit,
+			html: true
+		};
+		plugins.push(Markdown({
+			markdownOptions,
+			wrapperClasses: ubeanConfig.markdown?.wrapperClass ?? "markdown-body",
+			headEnabled: true,
+			headField: "head"
+		}));
+	}
+	if (mdxEnabled) plugins.push(ubeanMdxPlugin({
+		remarkPlugins: ubeanConfig.markdown?.remarkPlugins || [],
+		rehypePlugins: ubeanConfig.markdown?.rehypePlugins || []
+	}));
+	if (autoImportEnabled) plugins.push(AutoImport({
+		imports: [UBEAN_CLIENT_PRESET, UBEAN_SERVER_PRESET],
+		dirs: composablesDirs,
+		dts: join(dtsDir, "auto-imports.d.ts"),
+		vueTemplate: true,
+		eslintrc: { enabled: false }
+	}));
+	const UBEAN_BUILTIN_COMPONENTS = [
+		"Link",
+		"Head",
+		"PageView"
+	];
+	function ubeanComponentsResolver(componentName) {
+		if (UBEAN_BUILTIN_COMPONENTS.includes(componentName)) return {
+			name: componentName,
+			from: "ubean/client"
+		};
+	}
+	const dynamicResolvers = [ubeanComponentsResolver, (name) => {
+		for (const resolver of getComponentResolvers()) {
+			const result = typeof resolver === "function" ? resolver(name) : resolver.resolve(name);
+			if (result) return result;
+		}
+	}];
+	if (componentAutoImportEnabled) {
+		const extensions = ["vue"];
+		const includePatterns = [/\.vue$/, /\.vue\?vue/];
+		if (markdownEnabled && markdownComponentsAutoImport) {
+			extensions.push(...mdExtensions);
+			includePatterns.push(/\.md$/);
+			if (mdxEnabled) includePatterns.push(/\.mdx$/);
+		}
+		plugins.push(Components({
+			dirs: componentsDirs,
+			extensions,
+			include: includePatterns,
+			directoryAsNamespace,
+			dts: join(dtsDir, "components.d.ts"),
+			deep: true,
+			resolvers: dynamicResolvers
+		}));
+	} else plugins.push(Components({
+		dts: true,
+		resolvers: dynamicResolvers
+	}));
+	const searchConfig = ubeanConfig.search;
+	if (searchConfig !== false && searchConfig !== void 0) plugins.push({
+		name: "ubean:pagefind",
+		apply: "build",
+		closeBundle() {
+			return runPagefindIndexing(ubeanConfig, searchConfig);
+		}
+	});
+	return plugins;
+}
+/**
+* P9-26: Run the Pagefind CLI to index built HTML files.
+*
+* Spawns `npx pagefind --site <dir>` after the build. If the `pagefind`
+* package is not installed, prints a helpful warning instead of failing.
+*/
+async function runPagefindIndexing(ubeanConfig, searchConfig) {
+	const { spawn } = await import("node:child_process");
+	const { resolve } = await import("node:path");
+	const isObjectConfig = typeof searchConfig === "object";
+	if (!(isObjectConfig ? searchConfig.enabled !== false : true)) return;
+	const outDir = isObjectConfig && searchConfig.site ? searchConfig.site : "dist";
+	const indexPath = isObjectConfig && searchConfig.indexPath ? searchConfig.indexPath : "pagefind";
+	const verbose = isObjectConfig && searchConfig.verbose === true;
+	const args = [
+		"pagefind",
+		"--site",
+		resolve(ubeanConfig.rootDir, outDir),
+		"--output-subdir",
+		indexPath
+	];
+	if (isObjectConfig && searchConfig.glob) args.push("--glob", searchConfig.glob);
+	if (isObjectConfig && searchConfig.excludeSelectors) for (const selector of searchConfig.excludeSelectors) args.push("--exclude-selectors", selector);
+	if (verbose) args.push("--verbose");
+	return new Promise((resolvePromise) => {
+		const child = spawn("npx", args, {
+			stdio: "inherit",
+			cwd: ubeanConfig.rootDir,
+			shell: true
+		});
+		child.on("error", (err) => {
+			if (err.code === "ENOENT" || /not found/i.test(err.message)) console.warn("[ubean:pagefind] Pagefind CLI not found. Install it with `pnpm add -D pagefind` to enable full-text search.");
+			else console.error("[ubean:pagefind] Failed to run Pagefind:", err.message);
+			resolvePromise();
+		});
+		child.on("exit", (code) => {
+			if (code === 0) console.log("[ubean:pagefind] Search index generated successfully.");
+			else console.warn(`[ubean:pagefind] Pagefind exited with code ${code}. Search index may be incomplete.`);
+			resolvePromise();
+		});
+	});
+}
+//#endregion
+export { createVueAppEntryVirtualModule as a, createServerEntryVirtualModule as i, ubeanVite as n, createVuePagesVirtualModule as o, createClientEntryVirtualModule as r, VUE_PLUGIN_INCLUDE as t };