@ubean/content 0.4.6 → 0.4.7

package/dist/index.d.ts

@@ -1,5 +1,90 @@
+import { _ as SearchSection, a as ContentModuleOptions, b as SectionSearchOptions, c as ContentSchema, d as ContentTocItem, f as ContentType, g as SearchHit, h as ParsedContentMeta, i as ContentFieldSchema, l as ContentSearchOptions, m as MarkdownNode, n as ContentCollection, o as ContentNavigationItem, p as GenerateSearchSectionsOptions, r as ContentDocument, s as ContentQueryBuilder, t as ContentBody, u as ContentSourceConfig, v as SectionQueryOptions, y as SectionSearchEngine } from "./types-B9HP8tUf.js";
 import ubeanContentPlugin, { UbeanContentOptions } from "./vite.js";
-import { A as ContentSourceConfig, C as ContentCollection, D as ContentNavigationItem, E as ContentModuleOptions, M as ContentType, N as MarkdownNode, O as ContentQueryBuilder, P as ParsedContentMeta, S as ContentBody, T as ContentFieldSchema, _ as defineContentCollection, a as getCollection, b as parseFrontmatter, c as parseContentFile, d as ContentSourceScanConfig, f as ScanContentSourcesOptions, g as createQueryBuilder, h as createContentCollection, i as fetchContentNavigation, j as ContentTocItem, k as ContentSchema, l as queryCollection, m as buildNavigation, n as configureContentRuntime, o as getContentItem, p as scanContentSources, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as registerContent, v as generateId, w as ContentDocument, x as parseMarkdown, y as parseContent } from "./runtime-bK3ae0UQ.js";
+import { S as parseMarkdown, _ as createQueryBuilder, a as getCollection, b as parseContent, c as parseContentFile, d as registerContent, f as ContentSourceScanConfig, g as createContentCollection, h as buildNavigation, i as fetchContentNavigation, l as queryCollection, m as scanContentSources, n as configureContentRuntime, o as getContentItem, p as ScanContentSourcesOptions, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as queryCollectionSearchSections, v as defineContentCollection, x as parseFrontmatter, y as generateId } from "./runtime-DQ65gYP0.js";
+//#region src/search.d.ts
+/**
+ * 将单个文档按标题层级切分为可搜索的 sections。
+ *
+ * - 首个标题之前的内容为一个 intro section（level 0，title 为页面标题）
+ * - [minHeading, maxHeading] 范围内的标题开启新 section，并维护父级标题链
+ * - 范围外的标题（如 minHeading=2 时的 h1）视为正文内容
+ * - `_draft` / `_partial` / `_empty` 文档由上层过滤
+ */
+export declare function splitDocumentIntoSearchSections(doc: ContentDocument, options?: GenerateSearchSectionsOptions): SearchSection[];
+/** 将文档集合批量切分为 sections */
+export declare function generateSearchSections(documents: ContentDocument[], options?: GenerateSearchSectionsOptions): SearchSection[];
+/** 将 `{ collection: documents }` 快照转换为 `{ collection: sections }` payload */
+export declare function generateSearchSectionsSnapshot(snapshot: Record<string, ContentDocument[]>, options?: GenerateSearchSectionsOptions): Record<string, SearchSection[]>;
+/**
+ * CJK 感知分词器（与引擎共用）：
+ * - 拉丁词按 Unicode 词字符切分
+ * - CJK 连续段优先用 `Intl.Segmenter`（词级），降级为 unigram + bigram
+ * - 混合词（如 `vue每个`）按 CJK 子段切分
+ */
+export declare function tokenizeText(text: string): string[];
+/**
+ * 创建章节搜索引擎。
+ *
+ * 优先使用 MiniSearch（可选依赖，支持前缀 + 模糊匹配 + 字段加权），
+ * 未安装时降级为内置 fallback 引擎（精确/前缀匹配）。
+ * 两条路径共享 CJK 感知分词器。
+ */
+export declare function createSectionSearch(sections: SearchSection[], options?: SectionSearchOptions): Promise<SectionSearchEngine>;
+/** 一次性搜索便捷函数（每次调用重建引擎，适合低频场景；高频场景请缓存 `createSectionSearch` 结果） */
+export declare function searchSections(sections: SearchSection[], query: string, options?: SectionSearchOptions & SectionQueryOptions): Promise<SearchHit[]>;
+interface ResolvedContentSearchConfig {
+  /** 输出 `__search.json` sections payload */
+  sections: boolean;
+  /** 构建后运行 Pagefind 索引 */
+  pagefind: boolean;
+  /** 透传给 Pagefind `createIndex()` 的选项 */
+  pagefindOptions: Record<string, any>;
+}
+/**
+ * 解析构建端搜索配置。
+ *
+ * 默认策略：SSG 模式且内容模块启用时默认开启（pagefind 未安装时优雅跳过）；
+ * 其他模式需显式 `content: { search: { provider: 'pagefind' } }` 开启。
+ */
+export declare function resolveContentSearchConfig(content: boolean | {
+  search?: ContentSearchOptions | false;
+} | undefined, context?: {
+  ssg: boolean;
+}): ResolvedContentSearchConfig;
+interface PagefindIndexOptions {
+  /** 包含构建产物的静态目录（含 HTML） */
+  siteDir: string;
+  /** 索引输出目录（默认 `<siteDir>/pagefind`） */
+  outputPath?: string;
+  /** 传入 `addDirectory` 的 glob（默认匹配所有 `.html` 文件） */
+  glob?: string;
+  /** 透传给 `createIndex()` 的选项 */
+  createIndexOptions?: Record<string, any>;
+  logger?: {
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+  };
+  /**
+   * 注入自定义 pagefind 模块加载器。默认动态 `import('pagefind')`。
+   * 测试用：pnpm 隐藏 hoist 会让工作区内任意位置可解析 pagefind，
+   * 注入失败加载器可确定性覆盖「未安装」分支。
+   */
+  loadPagefind?: () => Promise<any>;
+}
+interface PagefindIndexResult {
+  indexed: boolean;
+  reason?: 'pagefind-not-installed' | 'no-html' | 'error';
+  error?: string;
+}
+/**
+ * 构建后运行 Pagefind 索引（Node API）。
+ *
+ * 扫描 `siteDir` 下的 HTML 生成分片索引（按查询词按需加载，
+ * 10k 页站点总网络开销 < 300KB），输出到 `<siteDir>/pagefind/`。
+ * `pagefind` 为可选依赖，未安装时返回 `pagefind-not-installed` 由调用方降级提示。
+ */
+export declare function runPagefindIndex(options: PagefindIndexOptions): Promise<PagefindIndexResult>;
+//#endregion
 //#region src/routing.d.ts
 interface ContentPageRouteOptions {
   /** URL prefix, e.g. `/blog`. `_path` `/hello` becomes `/blog/hello`. */
@@ -83,4 +168,4 @@ interface LiveCollection extends Omit<ContentCollection, 'documents' | 'list' |
   invalidate(): void;
 }
 //#endregion
-export { type ContentBody, type ContentCollection, type ContentDocument, type ContentFieldSchema, type ContentModuleOptions, type ContentNavigationItem, type ContentPageRouteOptions, type ContentQueryBuilder, type ContentSchema, type ContentSourceConfig, type ContentSourceScanConfig, type ContentTocItem, type ContentType, type DiscoverContentPageRoutesOptions, type LiveCollection, type LiveCollectionCacheOptions, type LiveCollectionEntry, type LiveCollectionLoader, type LiveCollectionLoaderParams, type LiveCollectionOptions, type MarkdownNode, type ParsedContentMeta, type ScanContentSourcesOptions, type UbeanContentOptions, bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, fetchContentNavigation as fetchNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollection as queryContent, registerContent, scanContentSources, ubeanContentPlugin };
+export { type ContentBody, type ContentCollection, type ContentDocument, type ContentFieldSchema, type ContentModuleOptions, type ContentNavigationItem, type ContentPageRouteOptions, type ContentQueryBuilder, type ContentSchema, type ContentSearchOptions, type ContentSourceConfig, type ContentSourceScanConfig, type ContentTocItem, type ContentType, type DiscoverContentPageRoutesOptions, type GenerateSearchSectionsOptions, type LiveCollection, type LiveCollectionCacheOptions, type LiveCollectionEntry, type LiveCollectionLoader, type LiveCollectionLoaderParams, type LiveCollectionOptions, type MarkdownNode, type PagefindIndexOptions, type PagefindIndexResult, type ParsedContentMeta, type ResolvedContentSearchConfig, type ScanContentSourcesOptions, type SearchHit, type SearchSection, type SectionQueryOptions, type SectionSearchEngine, type SectionSearchOptions, type UbeanContentOptions, bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, fetchContentNavigation as fetchNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollection as queryContent, queryCollectionSearchSections, registerContent, scanContentSources, ubeanContentPlugin };

package/dist/index.js

@@ -1,4 +1,5 @@
-import { _ as parseContent, a as getCollection, c as parseContentFile, d as scanContentSources, f as buildNavigation, g as generateId, h as defineContentCollection, i as fetchContentNavigation, l as queryCollection, m as createQueryBuilder, n as configureContentRuntime, o as getContentItem, p as createContentCollection, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as registerContent, v as parseFrontmatter, y as parseMarkdown } from "./runtime-Dhw-W7yi.js";
+import { _ as generateId, a as getCollection, b as parseMarkdown, c as parseContentFile, d as registerContent, f as scanContentSources, g as defineContentCollection, h as createQueryBuilder, i as fetchContentNavigation, l as queryCollection, m as createContentCollection, n as configureContentRuntime, o as getContentItem, p as buildNavigation, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as queryCollectionSearchSections, v as parseContent, y as parseFrontmatter } from "./runtime-Cdi5T8aE.js";
+import { a as runPagefindIndex, c as tokenizeText, i as resolveContentSearchConfig, n as generateSearchSections, o as searchSections, r as generateSearchSectionsSnapshot, s as splitDocumentIntoSearchSections, t as createSectionSearch } from "./search-CNUu8Xvf.js";
 import ubeanContentPlugin from "./vite.js";
 //#region src/routing.ts
 function joinPrefix(prefix, path) {
@@ -31,4 +32,4 @@ function discoverContentPageRoutes(rootDir, options = {}) {
 	return extractContentPageRoutes(Object.values(collections).flat(), { includeDrafts });
 }
 //#endregion
-export { bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, discoverContentPageRoutes, extractContentPageRoutes, fetchContentNavigation, fetchContentNavigation as fetchNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollection as queryContent, registerContent, scanContentSources, ubeanContentPlugin };
+export { bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, createSectionSearch, defineCollection, defineContentCollection, discoverContentPageRoutes, extractContentPageRoutes, fetchContentNavigation, fetchContentNavigation as fetchNavigation, generateId, generateSearchSections, generateSearchSectionsSnapshot, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollection as queryContent, queryCollectionSearchSections, registerContent, resolveContentSearchConfig, runPagefindIndex, scanContentSources, searchSections, splitDocumentIntoSearchSections, tokenizeText, ubeanContentPlugin };

package/dist/{runtime-Dhw-W7yi.js → runtime-Cdi5T8aE.js}

@@ -1,3 +1,4 @@
+import { n as generateSearchSections } from "./search-CNUu8Xvf.js";
 import { join, relative } from "pathe";
 import { getBasename, getDirname, getExtension, getStem, normalizePath, pathToTitle } from "@ubean/shared";
 import { kebabCase } from "scule";
@@ -129,7 +130,7 @@ function parseMarkdown(content) {
 			flushParagraph();
 			const depth = headingMatch[1].length;
 			const text = headingMatch[2].replace(/[#*_`~[\]]/g, "").trim();
-			const id = kebabCase(text);
+			const id = kebabCase(text.replace(/\s+/g, "-"));
 			while (headingDepths[headingDepths.length - 1] >= depth) {
 				headingDepths.pop();
 				headingStack.pop();
@@ -561,6 +562,18 @@ async function fetchContentNavigation(collectionName) {
 	if (!collectionName) navigationCache = nav;
 	return nav;
 }
+/**
+* 全文检索数据原语：将 collection 中的文档按标题层级切分为可搜索 sections。
+*
+* 与搜索引擎解耦 —— 结果可直接交给 `createSectionSearch`（内置 fallback /
+* MiniSearch）或 Fuse.js 等任意引擎。SSG 构建时由 CLI 序列化为 `__search.json`。
+*/
+async function queryCollectionSearchSections(collectionName, options = {}) {
+	const collection = collections.get(collectionName);
+	if (!collection) throw new Error(`Collection "${collectionName}" not found. Available collections: ${listCollections().join(", ")}`);
+	const docs = await collection.list();
+	return generateSearchSections(docs, options);
+}
 function registerContent(collectionName, documents) {
 	let collection = collections.get(collectionName);
 	if (!collection) {
@@ -590,4 +603,4 @@ function bootstrapContentFromDisk(rootDir, options = {}) {
 	return loaded;
 }
 //#endregion
-export { parseContent as _, getCollection as a, parseContentFile as c, scanContentSources as d, buildNavigation as f, generateId as g, defineContentCollection as h, fetchContentNavigation as i, queryCollection as l, createQueryBuilder as m, configureContentRuntime as n, getContentItem as o, createContentCollection as p, defineCollection as r, listCollections as s, bootstrapContentFromDisk as t, registerContent as u, parseFrontmatter as v, parseMarkdown as y };
+export { generateId as _, getCollection as a, parseMarkdown as b, parseContentFile as c, registerContent as d, scanContentSources as f, defineContentCollection as g, createQueryBuilder as h, fetchContentNavigation as i, queryCollection as l, createContentCollection as m, configureContentRuntime as n, getContentItem as o, buildNavigation as p, defineCollection as r, listCollections as s, bootstrapContentFromDisk as t, queryCollectionSearchSections as u, parseContent as v, parseFrontmatter as y };

package/dist/runtime-DQ65gYP0.d.ts

@@ -0,0 +1,75 @@
+import { _ as SearchSection, a as ContentModuleOptions, c as ContentSchema, n as ContentCollection, o as ContentNavigationItem, p as GenerateSearchSectionsOptions, r as ContentDocument, s as ContentQueryBuilder, t as ContentBody } from "./types-B9HP8tUf.js";
+//#region src/core.d.ts
+declare function generateId(path: string, extension?: string): string;
+declare function parseFrontmatter(content: string): {
+  data: Record<string, any>;
+  content: string;
+};
+declare function parseMarkdown(content: string): ContentBody;
+declare function createQueryBuilder(documents: ContentDocument[]): ContentQueryBuilder;
+declare function buildNavigation(documents: ContentDocument[], _options?: {
+  fields?: string[];
+}): ContentNavigationItem[];
+declare function parseContent(raw: string, filePath: string, options?: {
+  type?: string;
+}): ContentDocument;
+declare function defineContentCollection(collection: {
+  name: string;
+  source: string;
+  type?: any;
+  schema?: ContentSchema;
+  documents?: ContentDocument[];
+}): ContentCollection;
+declare function createContentCollection(name: string, source: string, documents?: ContentDocument[]): ContentCollection;
+//#endregion
+//#region src/scan.d.ts
+interface ContentSourceScanConfig {
+  dir: string;
+  prefix?: string;
+  type?: string;
+}
+interface ScanContentSourcesOptions {
+  sources?: Record<string, ContentSourceScanConfig>;
+  defaultDir?: string;
+}
+/**
+ * Read content source directories on disk into named document arrays.
+ *
+ * Used by the Vite plugin (dev), production server bootstrap, and
+ * prerender URL discovery so `queryCollection` is not Vite-only.
+ */
+declare function scanContentSources(rootDir: string, options?: ScanContentSourcesOptions): Record<string, ContentDocument[]>;
+//#endregion
+//#region src/runtime.d.ts
+declare function configureContentRuntime(_options?: Partial<ContentModuleOptions>): void;
+declare function defineCollection(config: {
+  name: string;
+  source: string;
+  type?: any;
+  schema?: ContentSchema;
+}): ContentCollection;
+declare function getCollection(name: string): ContentCollection | undefined;
+declare function listCollections(): string[];
+declare function queryCollection(name: string): Promise<ContentQueryBuilder>;
+declare function getContentItem(collection: string, path: string): Promise<ContentDocument | null>;
+declare function fetchContentNavigation(collectionName?: string): Promise<ContentNavigationItem[]>;
+/**
+ * 全文检索数据原语：将 collection 中的文档按标题层级切分为可搜索 sections。
+ *
+ * 与搜索引擎解耦 —— 结果可直接交给 `createSectionSearch`（内置 fallback /
+ * MiniSearch）或 Fuse.js 等任意引擎。SSG 构建时由 CLI 序列化为 `__search.json`。
+ */
+declare function queryCollectionSearchSections(collectionName: string, options?: GenerateSearchSectionsOptions): Promise<SearchSection[]>;
+declare function registerContent(collectionName: string, documents: ContentDocument[]): ContentCollection;
+declare function parseContentFile(raw: string, filePath: string, options?: {
+  type?: string;
+}): ContentDocument;
+/**
+ * Fill the in-memory collection map from disk (production SSR / tests).
+ *
+ * Dev already does this via the Vite plugin; call this from a custom
+ * server entry if you skip the generated production snapshot.
+ */
+declare function bootstrapContentFromDisk(rootDir: string, options?: ScanContentSourcesOptions): Record<string, ContentDocument[]>;
+//#endregion
+export { parseMarkdown as S, createQueryBuilder as _, getCollection as a, parseContent as b, parseContentFile as c, registerContent as d, ContentSourceScanConfig as f, createContentCollection as g, buildNavigation as h, fetchContentNavigation as i, queryCollection as l, scanContentSources as m, configureContentRuntime as n, getContentItem as o, ScanContentSourcesOptions as p, defineCollection as r, listCollections as s, bootstrapContentFromDisk as t, queryCollectionSearchSections as u, defineContentCollection as v, parseFrontmatter as x, generateId as y };

package/dist/runtime.d.ts

@@ -1,2 +1,3 @@
-import { A as ContentSourceConfig, C as ContentCollection, D as ContentNavigationItem, E as ContentModuleOptions, M as ContentType, N as MarkdownNode, O as ContentQueryBuilder, S as ContentBody, _ as defineContentCollection, a as getCollection, b as parseFrontmatter, c as parseContentFile, g as createQueryBuilder, h as createContentCollection, i as fetchContentNavigation, j as ContentTocItem, k as ContentSchema, l as queryCollection, m as buildNavigation, n as configureContentRuntime, o as getContentItem, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as registerContent, v as generateId, w as ContentDocument, x as parseMarkdown, y as parseContent } from "./runtime-bK3ae0UQ.js";
-export { type ContentBody, type ContentCollection, type ContentDocument, type ContentModuleOptions, type ContentNavigationItem, type ContentQueryBuilder, type ContentSchema, type ContentSourceConfig, type ContentTocItem, type ContentType, type MarkdownNode, bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, registerContent };
+import { _ as SearchSection, a as ContentModuleOptions, c as ContentSchema, d as ContentTocItem, f as ContentType, g as SearchHit, l as ContentSearchOptions, m as MarkdownNode, n as ContentCollection, o as ContentNavigationItem, p as GenerateSearchSectionsOptions, r as ContentDocument, s as ContentQueryBuilder, t as ContentBody, u as ContentSourceConfig } from "./types-B9HP8tUf.js";
+import { S as parseMarkdown, _ as createQueryBuilder, a as getCollection, b as parseContent, c as parseContentFile, d as registerContent, g as createContentCollection, h as buildNavigation, i as fetchContentNavigation, l as queryCollection, n as configureContentRuntime, o as getContentItem, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as queryCollectionSearchSections, v as defineContentCollection, x as parseFrontmatter, y as generateId } from "./runtime-DQ65gYP0.js";
+export { type ContentBody, type ContentCollection, type ContentDocument, type ContentModuleOptions, type ContentNavigationItem, type ContentQueryBuilder, type ContentSchema, type ContentSearchOptions, type ContentSourceConfig, type ContentTocItem, type ContentType, type GenerateSearchSectionsOptions, type MarkdownNode, type SearchHit, type SearchSection, bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollectionSearchSections, registerContent };

package/dist/runtime.js

@@ -1,2 +1,2 @@
-import { _ as parseContent, a as getCollection, c as parseContentFile, f as buildNavigation, g as generateId, h as defineContentCollection, i as fetchContentNavigation, l as queryCollection, m as createQueryBuilder, n as configureContentRuntime, o as getContentItem, p as createContentCollection, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as registerContent, v as parseFrontmatter, y as parseMarkdown } from "./runtime-Dhw-W7yi.js";
-export { bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, registerContent };
+import { _ as generateId, a as getCollection, b as parseMarkdown, c as parseContentFile, d as registerContent, g as defineContentCollection, h as createQueryBuilder, i as fetchContentNavigation, l as queryCollection, m as createContentCollection, n as configureContentRuntime, o as getContentItem, p as buildNavigation, r as defineCollection, s as listCollections, t as bootstrapContentFromDisk, u as queryCollectionSearchSections, v as parseContent, y as parseFrontmatter } from "./runtime-Cdi5T8aE.js";
+export { bootstrapContentFromDisk, buildNavigation, configureContentRuntime, createContentCollection, createQueryBuilder, defineCollection, defineContentCollection, fetchContentNavigation, generateId, getCollection, getContentItem, listCollections, parseContent, parseContentFile, parseFrontmatter, parseMarkdown, queryCollection, queryCollectionSearchSections, registerContent };

package/dist/search-CNUu8Xvf.js

@@ -0,0 +1,328 @@
+import { join } from "pathe";
+//#region src/search.ts
+const DEFAULT_IGNORED_TAGS = ["pre"];
+function extractNodeText(node, ignoredTags) {
+	if (node.type === "text") return node.value || "";
+	if (node.type === "element") {
+		if (ignoredTags.includes(node.tag || "")) return "";
+		return (node.children || []).map((child) => extractNodeText(child, ignoredTags)).join("");
+	}
+	return "";
+}
+function isHeadingNode(node) {
+	if (node.type !== "element") return false;
+	const match = node.tag?.match(/^h([1-6])$/);
+	if (!match) return false;
+	return {
+		depth: Number(match[1]),
+		text: extractNodeText(node, []).trim(),
+		anchor: node.props?.id || ""
+	};
+}
+/**
+* 将单个文档按标题层级切分为可搜索的 sections。
+*
+* - 首个标题之前的内容为一个 intro section（level 0，title 为页面标题）
+* - [minHeading, maxHeading] 范围内的标题开启新 section，并维护父级标题链
+* - 范围外的标题（如 minHeading=2 时的 h1）视为正文内容
+* - `_draft` / `_partial` / `_empty` 文档由上层过滤
+*/
+function splitDocumentIntoSearchSections(doc, options = {}) {
+	const ignoredTags = options.ignoredTags ?? DEFAULT_IGNORED_TAGS;
+	const minHeading = options.minHeading ?? 1;
+	const maxHeading = options.maxHeading ?? 6;
+	const sections = [];
+	if (!doc.body?.children?.length) return sections;
+	let current = null;
+	/** 父级标题栈：`[{ level, title }]`，新标题弹出所有 >= 自身 level 的项 */
+	const headingStack = [];
+	const buffer = [];
+	function pushSection() {
+		if (!current) return;
+		current.content = buffer.join(" ").replace(/\s+/g, " ").trim();
+		if (current.content || current.level > 0) sections.push(current);
+		buffer.length = 0;
+	}
+	for (const node of doc.body.children) {
+		const heading = isHeadingNode(node);
+		if (heading && heading.depth >= minHeading && heading.depth <= maxHeading) {
+			pushSection();
+			while (headingStack.length > 0 && headingStack[headingStack.length - 1].level >= heading.depth) headingStack.pop();
+			const titles = headingStack.map((h) => h.title);
+			headingStack.push({
+				level: heading.depth,
+				title: heading.text
+			});
+			current = {
+				id: heading.anchor ? `${doc._path}#${heading.anchor}` : doc._path,
+				title: heading.text,
+				titles,
+				level: heading.depth,
+				content: ""
+			};
+			continue;
+		}
+		if (!current) current = {
+			id: doc._path,
+			title: doc.title || doc._path,
+			titles: [],
+			level: 0,
+			content: ""
+		};
+		const text = extractNodeText(node, ignoredTags);
+		if (text.trim()) buffer.push(text.trim());
+	}
+	pushSection();
+	return sections;
+}
+/** 过滤不可搜索文档（草稿 / partial / 空文件） */
+function isSearchableDocument(doc) {
+	return !doc._draft && !doc._partial && !doc._empty;
+}
+/** 将文档集合批量切分为 sections */
+function generateSearchSections(documents, options = {}) {
+	return documents.filter(isSearchableDocument).flatMap((doc) => splitDocumentIntoSearchSections(doc, options));
+}
+/** 将 `{ collection: documents }` 快照转换为 `{ collection: sections }` payload */
+function generateSearchSectionsSnapshot(snapshot, options = {}) {
+	const payload = {};
+	for (const [name, documents] of Object.entries(snapshot)) payload[name] = generateSearchSections(documents, options);
+	return payload;
+}
+/** CJK 表意文字 / 假名 / 谚文区间 */
+const CJK_REGEX = /[\u2E80-\u9FFF\u3040-\u30FF\u31F0-\u31FF\uAC00-\uD7AF\uF900-\uFAFF]/;
+const CJK_RUN_REGEX = /[\u2E80-\u9FFF\u3040-\u30FF\u31F0-\u31FF\uAC00-\uD7AF\uF900-\uFAFF]+/g;
+const WORD_RUN_REGEX = /[\p{L}\p{N}]+/gu;
+let segmenter;
+function getSegmenter() {
+	if (segmenter !== void 0) return segmenter;
+	try {
+		segmenter = new Intl.Segmenter("en", { granularity: "word" });
+	} catch {
+		segmenter = null;
+	}
+	return segmenter;
+}
+function segmentCjkRun(run) {
+	const seg = getSegmenter();
+	if (seg) {
+		const tokens = [];
+		for (const part of seg.segment(run)) if (part.isWordLike) tokens.push(part.segment.toLowerCase());
+		return tokens;
+	}
+	const chars = Array.from(run.toLowerCase());
+	const tokens = [...chars];
+	for (let i = 0; i < chars.length - 1; i++) tokens.push(chars[i] + chars[i + 1]);
+	return tokens;
+}
+/**
+* CJK 感知分词器（与引擎共用）：
+* - 拉丁词按 Unicode 词字符切分
+* - CJK 连续段优先用 `Intl.Segmenter`（词级），降级为 unigram + bigram
+* - 混合词（如 `vue每个`）按 CJK 子段切分
+*/
+function tokenizeText(text) {
+	if (!text) return [];
+	const normalized = text.toLowerCase();
+	const tokens = [];
+	let wordMatch;
+	WORD_RUN_REGEX.lastIndex = 0;
+	while ((wordMatch = WORD_RUN_REGEX.exec(normalized)) !== null) {
+		const word = wordMatch[0];
+		if (!CJK_REGEX.test(word)) {
+			tokens.push(word);
+			continue;
+		}
+		let cursor = 0;
+		CJK_RUN_REGEX.lastIndex = 0;
+		let cjkMatch;
+		while ((cjkMatch = CJK_RUN_REGEX.exec(word)) !== null) {
+			if (cjkMatch.index > cursor) tokens.push(word.slice(cursor, cjkMatch.index));
+			tokens.push(...segmentCjkRun(cjkMatch[0]));
+			cursor = cjkMatch.index + cjkMatch[0].length;
+		}
+		if (cursor < word.length) tokens.push(word.slice(cursor));
+	}
+	return tokens;
+}
+function toHit(section, score) {
+	return {
+		id: section.id,
+		title: section.title,
+		titles: section.titles,
+		level: section.level,
+		content: section.content,
+		score
+	};
+}
+/** 内置 fallback 引擎：词元精确/前缀匹配 + 标题加权打分（无编辑距离容错） */
+function createFallbackEngine(sections) {
+	const indexed = sections.map((section) => ({
+		section,
+		titleTokens: tokenizeText(`${section.title} ${section.titles.join(" ")}`),
+		contentTokens: tokenizeText(section.content)
+	}));
+	return {
+		engine: "fallback",
+		search(query, options = {}) {
+			const terms = tokenizeText(query);
+			if (terms.length === 0) return [];
+			const titleBoost = options.titleBoost ?? 4;
+			const contentBoost = options.contentBoost ?? 1;
+			const hits = [];
+			for (const entry of indexed) {
+				let score = 0;
+				let matched = false;
+				for (const term of terms) {
+					let termScore = 0;
+					for (const token of entry.titleTokens) if (token === term) termScore = Math.max(termScore, titleBoost);
+					else if (token.startsWith(term)) termScore = Math.max(termScore, titleBoost / 2);
+					for (const token of entry.contentTokens) if (token === term) termScore = Math.max(termScore, contentBoost);
+					else if (token.startsWith(term)) termScore = Math.max(termScore, contentBoost / 2);
+					if (termScore > 0) matched = true;
+					score += termScore;
+				}
+				if (matched) hits.push(toHit(entry.section, score));
+			}
+			hits.sort((a, b) => b.score - a.score);
+			const limit = options.limit ?? 20;
+			return hits.slice(0, limit);
+		}
+	};
+}
+/**
+* 创建章节搜索引擎。
+*
+* 优先使用 MiniSearch（可选依赖，支持前缀 + 模糊匹配 + 字段加权），
+* 未安装时降级为内置 fallback 引擎（精确/前缀匹配）。
+* 两条路径共享 CJK 感知分词器。
+*/
+async function createSectionSearch(sections, options = {}) {
+	const moduleId = "minisearch";
+	let MiniSearch = null;
+	try {
+		const mod = await import(
+			/* @vite-ignore */
+			moduleId
+);
+		MiniSearch = mod.default ?? mod.MiniSearch ?? mod;
+	} catch {
+		MiniSearch = null;
+	}
+	if (MiniSearch && typeof MiniSearch === "function") {
+		const miniSearch = new MiniSearch({
+			fields: ["title", "content"],
+			storeFields: [],
+			tokenize: tokenizeText,
+			...options.miniSearch
+		});
+		miniSearch.addAll(sections);
+		const searchOptions = {
+			prefix: true,
+			fuzzy: .2,
+			boost: {
+				title: 4,
+				content: 1
+			},
+			...options.searchOptions
+		};
+		return {
+			engine: "minisearch",
+			search(query, queryOptions = {}) {
+				const limit = queryOptions.limit ?? 20;
+				const results = miniSearch.search(query, {
+					...searchOptions,
+					boost: {
+						...searchOptions.boost,
+						...queryOptions.titleBoost !== void 0 ? { title: queryOptions.titleBoost } : {},
+						...queryOptions.contentBoost !== void 0 ? { content: queryOptions.contentBoost } : {}
+					}
+				});
+				const byId = new Map(sections.map((s) => [s.id, s]));
+				const hits = [];
+				for (const result of results) {
+					const section = byId.get(result.id);
+					if (section) hits.push(toHit(section, result.score));
+				}
+				return hits.slice(0, limit);
+			}
+		};
+	}
+	return createFallbackEngine(sections);
+}
+/** 一次性搜索便捷函数（每次调用重建引擎，适合低频场景；高频场景请缓存 `createSectionSearch` 结果） */
+async function searchSections(sections, query, options = {}) {
+	const { miniSearch, searchOptions, ...queryOptions } = options;
+	return (await createSectionSearch(sections, {
+		miniSearch,
+		searchOptions
+	})).search(query, queryOptions);
+}
+/**
+* 解析构建端搜索配置。
+*
+* 默认策略：SSG 模式且内容模块启用时默认开启（pagefind 未安装时优雅跳过）；
+* 其他模式需显式 `content: { search: { provider: 'pagefind' } }` 开启。
+*/
+function resolveContentSearchConfig(content, context = { ssg: false }) {
+	if (content === false) return {
+		sections: false,
+		pagefind: false,
+		pagefindOptions: {}
+	};
+	const search = content === true || content === void 0 ? void 0 : content.search;
+	if (search === false || search?.provider === false) return {
+		sections: false,
+		pagefind: false,
+		pagefindOptions: {}
+	};
+	const enabled = Boolean(search) || context.ssg;
+	return {
+		sections: enabled ? search?.sections ?? true : false,
+		pagefind: enabled,
+		pagefindOptions: search?.pagefind ?? {}
+	};
+}
+/**
+* 构建后运行 Pagefind 索引（Node API）。
+*
+* 扫描 `siteDir` 下的 HTML 生成分片索引（按查询词按需加载，
+* 10k 页站点总网络开销 < 300KB），输出到 `<siteDir>/pagefind/`。
+* `pagefind` 为可选依赖，未安装时返回 `pagefind-not-installed` 由调用方降级提示。
+*/
+async function runPagefindIndex(options) {
+	const { siteDir, outputPath, glob, createIndexOptions = {}, logger } = options;
+	let pagefind;
+	try {
+		pagefind = await (options.loadPagefind?.() ?? import(
+			/* @vite-ignore */
+			"pagefind"
+));
+	} catch {
+		return {
+			indexed: false,
+			reason: "pagefind-not-installed"
+		};
+	}
+	try {
+		const { index } = await pagefind.createIndex(createIndexOptions);
+		if (index?.on) index.on("error", (err) => {
+			logger?.warn?.(`[pagefind] index error: ${err instanceof Error ? err.message : String(err)}`);
+		});
+		await index.addDirectory({
+			path: siteDir,
+			glob: glob || "**/*.{html}"
+		});
+		await index.writeFiles({ outputPath: outputPath ?? join(siteDir, "pagefind") });
+		logger?.info?.(`[pagefind] search index written to ${outputPath ?? join(siteDir, "pagefind")}`);
+		return { indexed: true };
+	} catch (err) {
+		return {
+			indexed: false,
+			reason: "error",
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+//#endregion
+export { runPagefindIndex as a, tokenizeText as c, resolveContentSearchConfig as i, generateSearchSections as n, searchSections as o, generateSearchSectionsSnapshot as r, splitDocumentIntoSearchSections as s, createSectionSearch as t };

package/dist/{runtime-bK3ae0UQ.d.ts → types-B9HP8tUf.d.ts}

@@ -144,71 +144,78 @@ interface ContentNavigationItem {
   draft?: boolean;
   children?: ContentNavigationItem[];
 }
-//#endregion
-//#region src/core.d.ts
-declare function generateId(path: string, extension?: string): string;
-declare function parseFrontmatter(content: string): {
-  data: Record<string, any>;
-  content: string;
-};
-declare function parseMarkdown(content: string): ContentBody;
-declare function createQueryBuilder(documents: ContentDocument[]): ContentQueryBuilder;
-declare function buildNavigation(documents: ContentDocument[], _options?: {
-  fields?: string[];
-}): ContentNavigationItem[];
-declare function parseContent(raw: string, filePath: string, options?: {
-  type?: string;
-}): ContentDocument;
-declare function defineContentCollection(collection: {
-  name: string;
-  source: string;
-  type?: any;
-  schema?: ContentSchema;
-  documents?: ContentDocument[];
-}): ContentCollection;
-declare function createContentCollection(name: string, source: string, documents?: ContentDocument[]): ContentCollection;
-//#endregion
-//#region src/scan.d.ts
-interface ContentSourceScanConfig {
-  dir: string;
-  prefix?: string;
-  type?: string;
-}
-interface ScanContentSourcesOptions {
-  sources?: Record<string, ContentSourceScanConfig>;
-  defaultDir?: string;
-}
-/**
- * Read content source directories on disk into named document arrays.
- *
- * Used by the Vite plugin (dev), production server bootstrap, and
- * prerender URL discovery so `queryCollection` is not Vite-only.
- */
-declare function scanContentSources(rootDir: string, options?: ScanContentSourcesOptions): Record<string, ContentDocument[]>;
-//#endregion
-//#region src/runtime.d.ts
-declare function configureContentRuntime(_options?: Partial<ContentModuleOptions>): void;
-declare function defineCollection(config: {
-  name: string;
-  source: string;
-  type?: any;
-  schema?: ContentSchema;
-}): ContentCollection;
-declare function getCollection(name: string): ContentCollection | undefined;
-declare function listCollections(): string[];
-declare function queryCollection(name: string): Promise<ContentQueryBuilder>;
-declare function getContentItem(collection: string, path: string): Promise<ContentDocument | null>;
-declare function fetchContentNavigation(collectionName?: string): Promise<ContentNavigationItem[]>;
-declare function registerContent(collectionName: string, documents: ContentDocument[]): ContentCollection;
-declare function parseContentFile(raw: string, filePath: string, options?: {
-  type?: string;
-}): ContentDocument;
 /**
- * Fill the in-memory collection map from disk (production SSR / tests).
+ * 全文检索的文档章节（数据原语）。
  *
- * Dev already does this via the Vite plugin; call this from a custom
- * server entry if you skip the generated production snapshot.
+ * 将文档按标题层级切分为可搜索的 sections，与搜索引擎解耦：
+ * 构建时序列化为静态 JSON（`__search.json`），客户端可交给
+ * MiniSearch / Fuse.js 或内置 fallback 引擎。
  */
-declare function bootstrapContentFromDisk(rootDir: string, options?: ScanContentSourcesOptions): Record<string, ContentDocument[]>;
+interface SearchSection {
+  /** `页面路径` 或 `页面路径#锚点` */
+  id: string;
+  /** 章节标题（首段无标题时为页面标题） */
+  title: string;
+  /** 父级标题链（面包屑），如 `['指南', '安装']` */
+  titles: string[];
+  /** 标题层级，首段为 0，h1~h6 为 1~6 */
+  level: number;
+  /** 章节纯文本内容 */
+  content: string;
+}
+/** `queryCollectionSearchSections` / `generateSearchSections` 的切分选项 */
+interface GenerateSearchSectionsOptions {
+  /** 提取文本时忽略的标签（如 `['pre', 'code']`），默认 `['pre']` */
+  ignoredTags?: string[];
+  /** 切分的最小标题级别（默认 1，即 h1 起切分） */
+  minHeading?: 1 | 2 | 3 | 4 | 5 | 6;
+  /** 切分的最大标题级别（默认 6） */
+  maxHeading?: 1 | 2 | 3 | 4 | 5 | 6;
+}
+/** 搜索命中结果（引擎无关） */
+interface SearchHit {
+  id: string;
+  title: string;
+  titles: string[];
+  level: number;
+  content: string;
+  /** 相关性得分，越高越相关 */
+  score: number;
+}
+/** 章节搜索引擎实例（MiniSearch 或内置 fallback） */
+interface SectionSearchEngine {
+  engine: 'minisearch' | 'fallback';
+  search(query: string, options?: SectionQueryOptions): SearchHit[];
+}
+/** 引擎查询选项 */
+interface SectionQueryOptions {
+  limit?: number;
+  /** 标题命中权重（默认 4） */
+  titleBoost?: number;
+  /** 正文命中权重（默认 1） */
+  contentBoost?: number;
+}
+/** `createSectionSearch` 的引擎选项 */
+interface SectionSearchOptions {
+  /** MiniSearch 选项（fields/storeFields 由内部固定，此处可传 tokenize/processTerm） */
+  miniSearch?: Record<string, any>;
+  /** MiniSearch 搜索选项（默认 `{ prefix: true, fuzzy: 0.2 }`） */
+  searchOptions?: Record<string, any>;
+}
+/** 内容搜索配置（`UbeanContentOptions.search`） */
+interface ContentSearchOptions {
+  /**
+   * SSG 搜索引擎：`'pagefind'`（默认）构建后扫描静态 HTML 生成分片索引；
+   * `false` 禁用。pagefind 未安装时构建端优雅跳过。
+   */
+  provider?: 'pagefind' | false;
+  /**
+   * 构建时输出 sections JSON payload（`__search.json`），
+   * 供 `useContentSearch` / 自定义引擎使用。默认 `true`。
+   */
+  sections?: boolean;
+  /** 透传给 Pagefind Node API `createIndex()` 的选项 */
+  pagefind?: Record<string, any>;
+}
 //#endregion
-export { ContentSourceConfig as A, ContentCollection as C, ContentNavigationItem as D, ContentModuleOptions as E, ContentType as M, MarkdownNode as N, ContentQueryBuilder as O, ParsedContentMeta as P, ContentBody as S, ContentFieldSchema as T, defineContentCollection as _, getCollection as a, parseFrontmatter as b, parseContentFile as c, ContentSourceScanConfig as d, ScanContentSourcesOptions as f, createQueryBuilder as g, createContentCollection as h, fetchContentNavigation as i, ContentTocItem as j, ContentSchema as k, queryCollection as l, buildNavigation as m, configureContentRuntime as n, getContentItem as o, scanContentSources as p, defineCollection as r, listCollections as s, bootstrapContentFromDisk as t, registerContent as u, generateId as v, ContentDocument as w, parseMarkdown as x, parseContent as y };
+export { SearchSection as _, ContentModuleOptions as a, SectionSearchOptions as b, ContentSchema as c, ContentTocItem as d, ContentType as f, SearchHit as g, ParsedContentMeta as h, ContentFieldSchema as i, ContentSearchOptions as l, MarkdownNode as m, ContentCollection as n, ContentNavigationItem as o, GenerateSearchSectionsOptions as p, ContentDocument as r, ContentQueryBuilder as s, ContentBody as t, ContentSourceConfig as u, SectionQueryOptions as v, SectionSearchEngine as y };

package/dist/vite.d.ts

@@ -1,3 +1,4 @@
+import { l as ContentSearchOptions } from "./types-B9HP8tUf.js";
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 export interface UbeanContentOptions {
@@ -19,6 +20,13 @@ export interface UbeanContentOptions {
   experimental?: {
     watch?: boolean;
   };
+  /**
+   * 全文检索配置（SSG 默认开启）：
+   * - `provider: 'pagefind'`（默认）构建后扫描静态 HTML 生成分片索引
+   * - `sections: true`（默认）输出 `__search.json` 供 `useContentSearch` 使用
+   * - dev server 自动提供 `/__search.json`（与 SSG 产物同构）
+   */
+  search?: ContentSearchOptions | false;
 }
 export declare function ubeanContentPlugin(userOptions?: UbeanContentOptions): Plugin;
 //#endregion

package/dist/vite.js

@@ -1,4 +1,5 @@
-import { d as scanContentSources, n as configureContentRuntime, u as registerContent } from "./runtime-Dhw-W7yi.js";
+import { d as registerContent, f as scanContentSources, n as configureContentRuntime } from "./runtime-Cdi5T8aE.js";
+import { r as generateSearchSectionsSnapshot } from "./search-CNUu8Xvf.js";
 import { defu } from "defu";
 import { join } from "pathe";
 //#region src/vite.ts
@@ -59,6 +60,11 @@ export default collections;
 			return null;
 		},
 		configureServer(server) {
+			if (options.search !== false) server.middlewares.use("/__search.json", (_req, res) => {
+				const payload = generateSearchSectionsSnapshot(loadedDocuments);
+				res.setHeader("Content-Type", "application/json");
+				res.end(JSON.stringify(payload));
+			});
 			if (options.experimental?.watch) {
 				const watchPatterns = Object.values(options.sources || {}).map((s) => {
 					return join(s.dir || options.defaultDir, "**/*.{md,mdx,json,yaml,yml}");

package/dist/vue.d.ts

@@ -0,0 +1,42 @@
+import { _ as SearchSection, b as SectionSearchOptions, g as SearchHit, v as SectionQueryOptions } from "./types-B9HP8tUf.js";
+import { Ref } from "vue";
+//#region src/vue.d.ts
+export interface UseContentSearchOptions {
+  /**
+   * 直接提供 sections（SSR 场景：由 `queryCollectionSearchSections` 生成后传入）。
+   * 提供时跳过 fetch。
+   */
+  sections?: SearchSection[] | (() => SearchSection[] | Promise<SearchSection[]>);
+  /**
+   * sections JSON payload 的 URL（dev 由 Vite 插件提供，SSG 由构建产物提供）。
+   * 默认 `/__search.json`。
+   */
+  sectionsUrl?: string;
+  /** 仅搜索指定 collections（`__search.json` 为 `{ [collection]: sections }`） */
+  collections?: string | string[];
+  /** 立即初始化引擎（默认 true）；`false` 时延迟到首次 search */
+  immediate?: boolean;
+  /** 引擎选项（MiniSearch 可用时的选项与降级 fallback 的权重） */
+  searchOptions?: SectionSearchOptions;
+}
+export interface UseContentSearchReturn {
+  status: Ref<'idle' | 'loading' | 'ready' | 'error'>;
+  error: Ref<Error | null>;
+  results: Ref<SearchHit[]>;
+  /** 手动触发引擎初始化（`immediate: false` 时使用） */
+  init: () => Promise<void>;
+  /** 执行搜索；空查询清空结果。引擎懒初始化 */
+  search: (query: string, options?: SectionQueryOptions) => Promise<SearchHit[]>;
+}
+/**
+ * 客户端全文搜索 composable。
+ *
+ * 数据源优先级：
+ * 1. `options.sections`（SSR 直传 / 静态导入）
+ * 2. `fetch(options.sectionsUrl ?? '/__search.json')`（dev 中间件 / SSG 构建产物）
+ *
+ * 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装时降级内置
+ * fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+ */
+export declare function useContentSearch(options?: UseContentSearchOptions): UseContentSearchReturn;
+//#endregion

package/dist/vue.js

@@ -0,0 +1,66 @@
+import { t as createSectionSearch } from "./search-CNUu8Xvf.js";
+import { ref } from "vue";
+//#region src/vue.ts
+/**
+* 客户端全文搜索 composable。
+*
+* 数据源优先级：
+* 1. `options.sections`（SSR 直传 / 静态导入）
+* 2. `fetch(options.sectionsUrl ?? '/__search.json')`（dev 中间件 / SSG 构建产物）
+*
+* 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装时降级内置
+* fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+*/
+function useContentSearch(options = {}) {
+	const status = ref("idle");
+	const error = ref(null);
+	const results = ref([]);
+	let engine = null;
+	let initPromise = null;
+	function filterCollections(payload) {
+		const wanted = options.collections ? Array.isArray(options.collections) ? options.collections : [options.collections] : null;
+		if (!wanted) return Object.values(payload).flat();
+		return wanted.flatMap((name) => payload[name] ?? []);
+	}
+	async function loadSections() {
+		if (options.sections) return typeof options.sections === "function" ? await options.sections() : options.sections;
+		const res = await fetch(options.sectionsUrl ?? "/__search.json");
+		if (!res.ok) throw new Error(`Failed to load search sections from ${options.sectionsUrl ?? "/__search.json"}: HTTP ${res.status}`);
+		return filterCollections(await res.json());
+	}
+	async function init() {
+		if (engine || status.value === "loading") return initPromise ?? Promise.resolve();
+		status.value = "loading";
+		error.value = null;
+		initPromise = (async () => {
+			try {
+				const sections = await loadSections();
+				engine = await createSectionSearch(sections, options.searchOptions);
+				status.value = "ready";
+			} catch (err) {
+				engine = null;
+				error.value = err instanceof Error ? err : new Error(String(err));
+				status.value = "error";
+			} finally {
+				initPromise = null;
+			}
+		})();
+		return initPromise;
+	}
+	async function search(query, queryOptions = {}) {
+		if (!engine) await init();
+		if (!engine) return [];
+		results.value = query.trim() ? engine.search(query, queryOptions) : [];
+		return results.value;
+	}
+	if (options.immediate !== false) init();
+	return {
+		status,
+		error,
+		results,
+		init,
+		search
+	};
+}
+//#endregion
+export { useContentSearch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/content",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "File-based content module for ubean (markdown/MDX/YAML/JSON)",
   "files": [
     "dist"
@@ -21,10 +21,14 @@
     "./runtime": {
       "types": "./dist/runtime.d.ts",
       "import": "./dist/runtime.js"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js"
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.4.6",
+    "@ubean/shared": "0.4.7",
     "defu": "6.1.7",
     "pathe": "^2.0.3",
     "scule": "^1.3.0"
@@ -33,14 +37,19 @@
     "@types/node": "^26.5.0",
     "typescript": "npm:typescript-native-bridge@latest",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
-    "vite-plus": "0.3.1"
+    "vite-plus": "0.3.1",
+    "vue": "^3.5.42"
   },
   "peerDependencies": {
-    "vite": "^5.0.0 || ^6.0.0"
+    "vite": "^5.0.0 || ^6.0.0",
+    "vue": "^3.5.0"
   },
   "peerDependenciesMeta": {
     "vite": {
       "optional": true
+    },
+    "vue": {
+      "optional": true
     }
   },
   "optionalDependencies": {},