@ubean/content 0.4.7 → 0.4.9

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-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 { _ 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-DN6hB1zj.js";
 import ubeanContentPlugin, { UbeanContentOptions } from "./vite.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";
+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-w0CWrefy.js";
 //#region src/search.d.ts
 /**
  * 将单个文档按标题层级切分为可搜索的 sections。
@@ -26,8 +26,11 @@ export declare function tokenizeText(text: string): string[];
  * 创建章节搜索引擎。
  *
  * 优先使用 MiniSearch（可选依赖，支持前缀 + 模糊匹配 + 字段加权），
- * 未安装时降级为内置 fallback 引擎（精确/前缀匹配）。
+ * 未安装/加载失败时降级为内置 fallback 引擎（精确/前缀匹配）。
  * 两条路径共享 CJK 感知分词器。
+ *
+ * 浏览器端必须通过 `options.loadMiniSearch` 注入字面量加载器，否则
+ * MiniSearch 无法加载（详见该选项文档）。
  */
 export declare function createSectionSearch(sections: SearchSection[], options?: SectionSearchOptions): Promise<SectionSearchEngine>;
 /** 一次性搜索便捷函数（每次调用重建引擎，适合低频场景；高频场景请缓存 `createSectionSearch` 结果） */

package/dist/index.js

@@ -1,5 +1,5 @@
-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 { _ 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-DPsviqaI.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-C73D12td.js";
 import ubeanContentPlugin from "./vite.js";
 //#region src/routing.ts
 function joinPrefix(prefix, path) {

package/dist/{runtime-Cdi5T8aE.js → runtime-DPsviqaI.js}

@@ -1,4 +1,4 @@
-import { n as generateSearchSections } from "./search-CNUu8Xvf.js";
+import { n as generateSearchSections } from "./search-C73D12td.js";
 import { join, relative } from "pathe";
 import { getBasename, getDirname, getExtension, getStem, normalizePath, pathToTitle } from "@ubean/shared";
 import { kebabCase } from "scule";
@@ -89,6 +89,8 @@ function parseMarkdown(content) {
 	let foundExcerptSeparator = false;
 	let headingStack = [toc];
 	let headingDepths = [0];
+	/** 标题文本 → 已出现次数；重复标题追加 `-n` 后缀，保证锚点/搜索 section id 唯一 */
+	const headingIdCounts = /* @__PURE__ */ new Map();
 	for (let i = 0; i < lines.length; i++) {
 		const line = lines[i];
 		if (line.startsWith("```")) {
@@ -130,7 +132,10 @@ function parseMarkdown(content) {
 			flushParagraph();
 			const depth = headingMatch[1].length;
 			const text = headingMatch[2].replace(/[#*_`~[\]]/g, "").trim();
-			const id = kebabCase(text.replace(/\s+/g, "-"));
+			const baseId = kebabCase(text.replace(/\s+/g, "-"));
+			const idCount = headingIdCounts.get(baseId) ?? 0;
+			headingIdCounts.set(baseId, idCount + 1);
+			const id = idCount === 0 ? baseId : `${baseId}-${idCount}`;
 			while (headingDepths[headingDepths.length - 1] >= depth) {
 				headingDepths.pop();
 				headingStack.pop();

package/dist/{runtime-DQ65gYP0.d.ts → runtime-w0CWrefy.d.ts}

@@ -1,4 +1,4 @@
-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";
+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-DN6hB1zj.js";
 //#region src/core.d.ts
 declare function generateId(path: string, extension?: string): string;
 declare function parseFrontmatter(content: string): {

package/dist/runtime.d.ts

@@ -1,3 +1,3 @@
-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";
+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-DN6hB1zj.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-w0CWrefy.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 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";
+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-DPsviqaI.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 → search-C73D12td.js}

@@ -191,21 +191,41 @@ function createFallbackEngine(sections) {
 	};
 }
 /**
+* 加载 MiniSearch 模块（可选依赖）。
+*
+* 优先使用 `options.loadMiniSearch`。默认实现是 `import(变量)` +
+* `@vite-ignore`：它**只在 Node 下有效**（Node 在运行时解析裸说明符），
+* 浏览器 ESM 不认裸模块名，会抛 `Failed to resolve module specifier
+* "minisearch"`，被下方的 try/catch 静默降级为 fallback 引擎。
+*
+* 因此浏览器场景必须由应用侧注入加载器 —— 字面量 import 落在应用源码里，
+* Vite 才能解析并预打包（见 `SectionSearchOptions.loadMiniSearch`）：
+*
+* ```ts
+* useContentSearch({ searchOptions: { loadMiniSearch: () => import('minisearch') } });
+* ```
+*/
+async function loadMiniSearchModule(loader) {
+	const mod = loader ? await loader() : await import(
+		/* @vite-ignore */
+		"minisearch"
+);
+	return mod?.default ?? mod?.MiniSearch ?? mod;
+}
+/**
 * 创建章节搜索引擎。
 *
 * 优先使用 MiniSearch（可选依赖，支持前缀 + 模糊匹配 + 字段加权），
-* 未安装时降级为内置 fallback 引擎（精确/前缀匹配）。
+* 未安装/加载失败时降级为内置 fallback 引擎（精确/前缀匹配）。
 * 两条路径共享 CJK 感知分词器。
+*
+* 浏览器端必须通过 `options.loadMiniSearch` 注入字面量加载器，否则
+* MiniSearch 无法加载（详见该选项文档）。
 */
 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;
+		MiniSearch = await loadMiniSearchModule(options.loadMiniSearch);
 	} catch {
 		MiniSearch = null;
 	}

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

@@ -201,6 +201,20 @@ interface SectionSearchOptions {
   miniSearch?: Record<string, any>;
   /** MiniSearch 搜索选项（默认 `{ prefix: true, fuzzy: 0.2 }`） */
   searchOptions?: Record<string, any>;
+  /**
+   * 注入 MiniSearch 模块加载器。**浏览器场景必须提供。**
+   *
+   * 包内的默认加载是 `import(变量)` + `@vite-ignore`，只在 Node 下有效
+   * （Node 运行时解析裸说明符）；浏览器 ESM 不认裸模块名，会抛
+   * `Failed to resolve module specifier "minisearch"` 并被静默降级。
+   *
+   * 由应用侧注入，字面量 import 就落在应用源码里，Vite 可正常解析/预打包：
+   *
+   * ```ts
+   * useContentSearch({ searchOptions: { loadMiniSearch: () => import('minisearch') } });
+   * ```
+   */
+  loadMiniSearch?: () => Promise<any>;
 }
 /** 内容搜索配置（`UbeanContentOptions.search`） */
 interface ContentSearchOptions {

package/dist/vite.d.ts

@@ -1,4 +1,4 @@
-import { l as ContentSearchOptions } from "./types-B9HP8tUf.js";
+import { l as ContentSearchOptions } from "./types-DN6hB1zj.js";
 import { Plugin } from "vite";
 //#region src/vite.d.ts
 export interface UbeanContentOptions {

package/dist/vite.js

@@ -1,5 +1,5 @@
-import { d as registerContent, f as scanContentSources, n as configureContentRuntime } from "./runtime-Cdi5T8aE.js";
-import { r as generateSearchSectionsSnapshot } from "./search-CNUu8Xvf.js";
+import { d as registerContent, f as scanContentSources, n as configureContentRuntime } from "./runtime-DPsviqaI.js";
+import { r as generateSearchSectionsSnapshot } from "./search-C73D12td.js";
 import { defu } from "defu";
 import { join } from "pathe";
 //#region src/vite.ts

package/dist/vue.d.ts

@@ -1,4 +1,4 @@
-import { _ as SearchSection, b as SectionSearchOptions, g as SearchHit, v as SectionQueryOptions } from "./types-B9HP8tUf.js";
+import { _ as SearchSection, b as SectionSearchOptions, g as SearchHit, v as SectionQueryOptions } from "./types-DN6hB1zj.js";
 import { Ref } from "vue";
 //#region src/vue.d.ts
 export interface UseContentSearchOptions {
@@ -35,8 +35,11 @@ export interface UseContentSearchReturn {
  * 1. `options.sections`（SSR 直传 / 静态导入）
  * 2. `fetch(options.sectionsUrl ?? '/__search.json')`（dev 中间件 / SSG 构建产物）
  *
- * 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装时降级内置
- * fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+ * 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装/加载失败时降级
+ * 内置 fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+ *
+ * 浏览器端必须注入 `searchOptions.loadMiniSearch`，字面量 import 才能被 Vite
+ * 解析（详见 `UseContentSearchOptions.searchOptions` / `SectionSearchOptions`）。
  */
 export declare function useContentSearch(options?: UseContentSearchOptions): UseContentSearchReturn;
 //#endregion

package/dist/vue.js

@@ -1,4 +1,4 @@
-import { t as createSectionSearch } from "./search-CNUu8Xvf.js";
+import { t as createSectionSearch } from "./search-C73D12td.js";
 import { ref } from "vue";
 //#region src/vue.ts
 /**
@@ -8,8 +8,11 @@ import { ref } from "vue";
 * 1. `options.sections`（SSR 直传 / 静态导入）
 * 2. `fetch(options.sectionsUrl ?? '/__search.json')`（dev 中间件 / SSG 构建产物）
 *
-* 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装时降级内置
-* fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+* 引擎：优先 MiniSearch（可选依赖，前缀 + 模糊匹配），未安装/加载失败时降级
+* 内置 fallback 引擎（精确/前缀匹配）。两者共享 CJK 感知分词器。
+*
+* 浏览器端必须注入 `searchOptions.loadMiniSearch`，字面量 import 才能被 Vite
+* 解析（详见 `UseContentSearchOptions.searchOptions` / `SectionSearchOptions`）。
 */
 function useContentSearch(options = {}) {
 	const status = ref("idle");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/content",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "File-based content module for ubean (markdown/MDX/YAML/JSON)",
   "files": [
     "dist"
@@ -28,7 +28,7 @@
     }
   },
   "dependencies": {
-    "@ubean/shared": "0.4.7",
+    "@ubean/shared": "0.4.9",
     "defu": "6.1.7",
     "pathe": "^2.0.3",
     "scule": "^1.3.0"