@aiao/rxdb-plugin-search-react 0.0.23 → 0.0.25

package/README.md

@@ -0,0 +1,78 @@
+# @aiao/rxdb-plugin-search-react
+
+[`@aiao/rxdb-plugin-search`](../rxdb-plugin-search) 的 React 集成层。提供 `useSearch()` hook，将搜索插件的 `SearchHandle` 适配为 React 状态消费接口。
+
+## 安装
+
+```bash
+pnpm add @aiao/rxdb @aiao/rxdb-plugin-search @aiao/rxdb-plugin-search-react react rxjs
+```
+
+## 用法
+
+```tsx
+import type { RxDB } from '@aiao/rxdb';
+import { rxDBPluginSearch } from '@aiao/rxdb-plugin-search';
+import { useSearch, type UseSearchReturn } from '@aiao/rxdb-plugin-search-react';
+
+export async function startSearch(database: RxDB): Promise<void> {
+  database.use(rxDBPluginSearch, { debounce: 200, pageSize: 20 });
+  await database.connect('sqlite-wasm');
+  await database.searchPlugin.ready;
+}
+
+export function SearchPage({ database }: { readonly database: RxDB }) {
+  const search: UseSearchReturn = useSearch(database, {
+    collections: ['Article'],
+    initialQuery: ''
+  });
+
+  return (
+    <main>
+      <label>
+        Search
+        <input value={search.query} onChange={event => search.setQuery(event.currentTarget.value)} />
+      </label>
+      {search.error && <p role="alert">{search.error.message}</p>}
+      {search.state === 'error' && <button onClick={search.retry}>Retry</button>}
+      <ul>
+        {search.results.map(result => (
+          <li key={`${result.collection}:${result.id}`}>{result.snippet}</li>
+        ))}
+      </ul>
+      {search.hasMore && <button onClick={() => void search.loadMore()}>Load more</button>}
+      <button onClick={search.clear}>Clear</button>
+    </main>
+  );
+}
+```
+
+`startSearch()` 必须在渲染 `SearchPage` 前完成。`connect()` 会触发数据库 `init()`；
+`database.searchPlugin.ready` 等待 FTS 安装与回填完成。未安装或销毁后访问 `ready` 会 reject，
+不能把它当成永远成功的探针。
+
+`useSearch` 返回 `UseSearchReturn`。hook 持有 `SearchHandle` 的所有权，组件卸载或重建时自动
+`destroy()`；调用方不要再次销毁底层 handle。
+
+### 重建契约（三端一致）
+
+`source` 变化、或 `options` 的 `collections` / `debounce` / `pageSize` / `snippetLength`
+任一变化时，旧 `SearchHandle` 被销毁、新 handle 以**用户当前 query** 播种：
+
+- `initialQuery` **只在首次创建时**作种子，此后不再参与重建判据，
+  因此传 `initialQuery: query` 不会导致每次击键重建 handle；
+- `options` 按语义（而非引用）比较，每次渲染新建的字面量不触发重建；
+- 重建后 `loadMore` / `clear` / `retry` 一律路由到最新 handle，旧 handle 的晚到 emission 不再写入输出。
+
+判据由 core 的 `searchOptionsEqual` 三端共用，重建时机不会因框架而异。
+
+三框架同功能对称：Angular 用 `injectSearch`（[`@aiao/rxdb-plugin-search-angular`](../rxdb-plugin-search-angular)），Vue 用 `useSearch`（[`@aiao/rxdb-plugin-search-vue`](../rxdb-plugin-search-vue)）。
+
+## 文档
+
+- 仓库主页：[https://github.com/aiao-io/rxdb](https://github.com/aiao-io/rxdb)
+- 框架集成与搜索指南见项目文档站
+
+## License
+
+[MIT](https://github.com/aiao-io/rxdb/blob/main/LICENSE)

package/dist/index.d.ts

@@ -5,7 +5,8 @@
  *
  * @packageDocumentation
  */
-export type { SearchExecutionError, SearchHandle, SearchOptions, SearchResult, SearchState } from '@aiao/rxdb-plugin-search';
+export { SearchExecutionError } from '@aiao/rxdb-plugin-search';
+export type { SearchHandle, SearchOptions, SearchResult, SearchState } from '@aiao/rxdb-plugin-search';
 export { useSearch } from './use-search.js';
 export type { SearchSourceLike, UseSearchReturn } from './use-search.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAKH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvG,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,57 +1,58 @@
 "use client";
-import { useCallback as e, useEffect as t, useMemo as n, useRef as r, useState as i } from "react";
-import { Subscription as a } from "rxjs";
+import { SearchExecutionError as e } from "@aiao/rxdb-plugin-search";
+import { useCallback as t, useEffect as n, useLayoutEffect as r, useMemo as i, useRef as a, useState as o } from "react";
+import { Subscription as s } from "rxjs";
 //#region src/use-search.ts
-function o(e, t) {
-	return e === t ? !0 : e === void 0 || t === void 0 || e.length !== t.length ? !1 : e.every((e, n) => e === t[n]);
-}
-function s(e, t) {
-	return e === t ? !0 : e === void 0 || t === void 0 ? !1 : e.debounce === t.debounce && e.pageSize === t.pageSize && e.snippetLength === t.snippetLength && e.initialQuery === t.initialQuery && o(e.collections, t.collections);
-}
-function c(e) {
-	let t = r(e);
-	return s(t.current, e) || (t.current = e), t.current;
-}
-function l(o, s) {
-	let l = c(s), u = l?.initialQuery ?? "", d = r(null), [f, p] = i(u), [m, h] = i([]), [g, _] = i("idle"), [v, y] = i(void 0), [b, x] = i(!1);
-	t(() => {
-		let e = o.search(u, l);
-		d.current = e, p(u);
-		let t = new a();
-		return t.add(e.results$.subscribe((e) => h(e))), t.add(e.state$.subscribe((e) => _(e))), t.add(e.error$.subscribe((e) => y(e))), t.add(e.hasMore$.subscribe((e) => x(e))), () => {
-			t.unsubscribe(), e.destroy(), d.current === e && (d.current = null);
-		};
+var c = typeof window > "u" ? n : r;
+function l(e) {
+	let t = e?.collections === void 0 ? void 0 : JSON.stringify(e.collections);
+	return i(() => {
+		if (e === void 0) return;
+		let t = {};
+		return e.debounce !== void 0 && (t.debounce = e.debounce), e.pageSize !== void 0 && (t.pageSize = e.pageSize), e.snippetLength !== void 0 && (t.snippetLength = e.snippetLength), e.collections !== void 0 && (t.collections = [...e.collections]), e.initialQuery !== void 0 && (t.initialQuery = e.initialQuery), t;
 	}, [
-		o,
-		l,
-		u
+		e?.debounce,
+		e?.pageSize,
+		e?.snippetLength,
+		t
 	]);
-	let S = e((e) => {
-		p(e), d.current?.setQuery(e);
-	}, []), C = e(() => {
-		p(""), d.current?.clear();
-	}, []), w = e(() => d.current?.retry(), []), T = e(() => d.current?.loadMore() ?? Promise.resolve(), []);
-	return n(() => ({
+}
+function u(e, n) {
+	let r = l(n), u = r?.initialQuery ?? "", d = a(null), [f, p] = o(u), [m, h] = o([]), [g, _] = o("idle"), [v, y] = o(void 0), [b, x] = o(!1), S = a(u);
+	c(() => {
+		let t = S.current, n = e.search(t, r);
+		d.current = n;
+		let i = new s();
+		return i.add(n.results$.subscribe((e) => h(e))), i.add(n.state$.subscribe((e) => _(e))), i.add(n.error$.subscribe((e) => y(e))), i.add(n.hasMore$.subscribe((e) => x(e))), () => {
+			i.unsubscribe(), n.destroy(), d.current === n && (d.current = null);
+		};
+	}, [e, r]);
+	let C = t((e) => {
+		S.current = e, p(e), d.current?.setQuery(e);
+	}, []), w = t(() => {
+		S.current = "", p(""), d.current?.clear();
+	}, []), T = t(() => d.current?.retry(), []), E = t(() => d.current?.loadMore() ?? Promise.resolve(), []);
+	return i(() => ({
 		query: f,
-		setQuery: S,
+		setQuery: C,
 		results: m,
 		state: g,
 		error: v,
 		hasMore: b,
-		loadMore: T,
-		clear: C,
-		retry: w
+		loadMore: E,
+		clear: w,
+		retry: T
 	}), [
 		f,
-		S,
+		C,
 		m,
 		g,
 		v,
 		b,
-		T,
-		C,
-		w
+		E,
+		w,
+		T
 	]);
 }
 //#endregion
-export { l as useSearch };
+export { e as SearchExecutionError, u as useSearch };

package/dist/use-search.d.ts

@@ -3,7 +3,7 @@ import { SearchExecutionError, SearchOptions, SearchResult, SearchSourceLike, Se
  * React 集成 - rxdb-plugin-search
  *
  * 提供 `useSearch()`，将 `SearchHandle` 的 Observable 适配为 React state；
- * 通过 `useEffect` 清理函数在组件卸载时自动释放 handle。
+ * 通过同构 layout effect 的清理函数在组件卸载时自动释放 handle。
  *
  * @packageDocumentation
  */

package/dist/use-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-search.d.ts","sourceRoot":"","sources":["../src/use-search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EAEpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AAEH,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,WAAW;IACX,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,WAAW;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe;IACf,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACxC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,oBAAoB;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AA0BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAgD5F"}
+{"version":3,"file":"use-search.d.ts","sourceRoot":"","sources":["../src/use-search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EAEpB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AAEH,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,WAAW;IACX,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,WAAW;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe;IACf,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACxC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,oBAAoB;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAgE5F"}

package/package.json

@@ -1,6 +1,20 @@
 {
   "name": "@aiao/rxdb-plugin-search-react",
-  "version": "0.0.23",
+  "version": "0.0.25",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiao-io/rxdb.git",
+    "directory": "packages/rxdb-plugin-search-react"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.spec.*",
+    "!src/**/*.test.*",
+    "!src/**/__tests__/**",
+    "!**/*.tsbuildinfo"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -8,20 +22,19 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "@aiao/source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
   },
-  "dependencies": {
-    "@aiao/rxdb-plugin-search": "0.0.23"
-  },
   "peerDependencies": {
     "@aiao/rxdb": "*",
-    "react": "^19.2.7",
-    "rxjs": "^7.8.2",
-    "@aiao/rxdb-plugin-search": "0.0.23"
+    "@aiao/rxdb-plugin-search": "*",
+    "react": "^19.2.8",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@aiao/rxdb-plugin-search": "0.0.25"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -8,12 +8,10 @@
  * @packageDocumentation
  */
 
-export type {
-  SearchExecutionError,
-  SearchHandle,
-  SearchOptions,
-  SearchResult,
-  SearchState
-} from '@aiao/rxdb-plugin-search';
+// `SearchExecutionError` 是 core 的**运行时 class**，必须作为值再导出：
+// 混在 `export type` 里会让它在真实 ESM 中不存在，消费者拿到 `error` 后
+// 无法 `instanceof`，只能额外从 core import（SRCHR-006，三端同款）。
+export { SearchExecutionError } from '@aiao/rxdb-plugin-search';
+export type { SearchHandle, SearchOptions, SearchResult, SearchState } from '@aiao/rxdb-plugin-search';
 export { useSearch } from './use-search.js';
 export type { SearchSourceLike, UseSearchReturn } from './use-search.js';

package/src/use-search.ts

@@ -1,6 +1,6 @@
 'use client';
 
-import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import { Subscription } from 'rxjs';
 
 import type {
@@ -16,7 +16,7 @@ import type {
  * React 集成 - rxdb-plugin-search
  *
  * 提供 `useSearch()`，将 `SearchHandle` 的 Observable 适配为 React state；
- * 通过 `useEffect` 清理函数在组件卸载时自动释放 handle。
+ * 通过同构 layout effect 的清理函数在组件卸载时自动释放 handle。
  *
  * @packageDocumentation
  */
@@ -49,28 +49,20 @@ export interface UseSearchReturn {
   retry: () => void;
 }
 
-function collectionsEqual(left: readonly string[] | undefined, right: readonly string[] | undefined): boolean {
-  if (left === right) return true;
-  if (left === undefined || right === undefined || left.length !== right.length) return false;
-  return left.every((value, index) => value === right[index]);
-}
-
-function searchOptionsEqual(left: SearchOptions | undefined, right: SearchOptions | undefined): boolean {
-  if (left === right) return true;
-  if (left === undefined || right === undefined) return false;
-  return (
-    left.debounce === right.debounce &&
-    left.pageSize === right.pageSize &&
-    left.snippetLength === right.snippetLength &&
-    left.initialQuery === right.initialQuery &&
-    collectionsEqual(left.collections, right.collections)
-  );
-}
+const useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
 
 function useStableSearchOptions(options: SearchOptions | undefined): SearchOptions | undefined {
-  const stableOptions = useRef(options);
-  if (!searchOptionsEqual(stableOptions.current, options)) stableOptions.current = options;
-  return stableOptions.current;
+  const collectionsKey = options?.collections === undefined ? undefined : JSON.stringify(options.collections);
+  return useMemo(() => {
+    if (options === undefined) return undefined;
+    const snapshot: SearchOptions = {};
+    if (options.debounce !== undefined) snapshot.debounce = options.debounce;
+    if (options.pageSize !== undefined) snapshot.pageSize = options.pageSize;
+    if (options.snippetLength !== undefined) snapshot.snippetLength = options.snippetLength;
+    if (options.collections !== undefined) snapshot.collections = [...options.collections];
+    if (options.initialQuery !== undefined) snapshot.initialQuery = options.initialQuery;
+    return snapshot;
+  }, [options?.debounce, options?.pageSize, options?.snippetLength, collectionsKey]);
 }
 
 /**
@@ -97,13 +89,27 @@ export function useSearch(source: SearchSourceLike, options?: SearchOptions): Us
   const [error, setError] = useState<SearchExecutionError | undefined>(undefined);
   const [hasMore, setHasMore] = useState<boolean>(false);
 
-  useEffect(() => {
+  /**
+   * 当前 query 的「最新值」镜像，供重建时播种新 handle。
+   *
+   * @remarks
+   * SRCHR-001：早先重建时无条件 `setQueryState(initial)`，`initial` 只来自
+   * `options.initialQuery` —— 于是「切换搜索范围」这种与输入框无关的操作
+   * 会把用户打了一半的词清空。契约改为**重建保留当前 query**。
+   *
+   * 用 ref 而不是把 `query` 加进 effect 依赖：后者会让每次击键都重建 handle，
+   * 防抖与分页全废。写入点只有 `setQuery` / `clear` 两个回调（非渲染期），
+   * layout effect 负责在消费者同阶段 effect 前完成句柄绑定，避免首个 commit 的命令窗口。
+   */
+  const queryRef = useRef<string>(initial);
+
+  useIsomorphicLayoutEffect(() => {
     // handle 是命令式控制器，不参与渲染，存入 ref 而非 state：
     // 避免 handle 变化触发多余的重渲染，并让 setQuery/clear/retry/loadMore
     // 始终读取最新 handle，不会在 rebuild 后仍调用到已销毁的旧实例。
-    const newHandle = source.search(initial, stableOptions);
+    const seed = queryRef.current;
+    const newHandle = source.search(seed, stableOptions);
     handleRef.current = newHandle;
-    setQueryState(initial);
 
     const subs = new Subscription();
     subs.add(newHandle.results$.subscribe(r => setResults(r)));
@@ -115,14 +121,16 @@ export function useSearch(source: SearchSourceLike, options?: SearchOptions): Us
       newHandle.destroy();
       if (handleRef.current === newHandle) handleRef.current = null;
     };
-  }, [source, stableOptions, initial]);
+  }, [source, stableOptions]);
 
   const setQuery = useCallback((q: string) => {
+    queryRef.current = q;
     setQueryState(q);
     handleRef.current?.setQuery(q);
   }, []);
 
   const clear = useCallback(() => {
+    queryRef.current = '';
     setQueryState('');
     handleRef.current?.clear();
   }, []);

package/REVIEW.md

@@ -1,23 +0,0 @@
-# `@aiao/rxdb-plugin-search-react` 代码评审
-
-## 结论
-
-🔴 不通过。`useSearch()` 宣称 source 变化时重建 handle，但实际把首次 source 永久锁进 ref；组件切换数据库/collection 后仍订阅和查询旧 source。
-
-## 评审基线
-
-- 基线提交：`03a46a5d5992a958c19ae33d5fed15c9c3322021`
-- 评审日期：2026-07-14
-- 范围：React 搜索 hook、测试、公开入口；10 个文件，约 311 行 TS
-- 自动校验：`lint`、`test`、`typecheck`、`build` 全部通过
-
-## 问题
-
-| ID | 级别 | 位置 | 问题与影响 | 建议 |
-| --- | --- | --- | --- | --- |
-| SEARCH-REACT-001 | P1 | `src/use-search.ts:67` | `handleRef` 只在 null 时用 source 创建，订阅 effect 的依赖数组为空；rerender 传入新 source/options 时，hook 仍对旧 handle 调用 setQuery/loadMore，并显示旧数据库结果。源码注释“仅在 source 变化时重建”与实现相反。 | 用 source/稳定 options key 作为 handle 生命周期依赖，切换时先取消旧订阅并 destroy 旧 handle；增加 rerender source A→B 后只能调用 B 的测试。 |
-
-## 三端对称性
-
-- 共享类型透传与 Vue/Angular 一致；运行时入口 `useSearch` 符合 React 约定。
-- source 切换语义目前不可靠，是此三端组唯一 P1。

package/project.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "../../node_modules/nx/schemas/project-schema.json",
-  "name": "rxdb-plugin-search-react",
-  "projectType": "library",
-  "sourceRoot": "packages/rxdb-plugin-search-react/src",
-  "tags": ["react-lib"],
-  "targets": {}
-}

package/src/index.spec.ts

@@ -1,18 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import type { SearchExecutionError, SearchHandle, SearchOptions, SearchResult, SearchState } from './index.js';
-
-type PublicSearchApi = {
-  error: SearchExecutionError | undefined;
-  handle: SearchHandle;
-  options: SearchOptions;
-  result: SearchResult;
-  state: SearchState;
-};
-
-describe('React public search API', () => {
-  it('exposes the core search types from the package entrypoint', () => {
-    const contract: PublicSearchApi | undefined = undefined;
-    expect(contract).toBeUndefined();
-  });
-});

package/src/use-search.spec.ts

@@ -1,224 +0,0 @@
-// @vitest-environment jsdom
-
-import { act, renderHook } from '@testing-library/react';
-import { StrictMode, createElement, type PropsWithChildren } from 'react';
-import { BehaviorSubject } from 'rxjs';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-import type { SearchExecutionError, SearchHandle, SearchResult, SearchState } from '@aiao/rxdb-plugin-search';
-
-import { useSearch, type SearchSourceLike } from '../src/use-search.js';
-
-const makeHandle = () => {
-  const results$ = new BehaviorSubject<SearchResult[]>([]);
-  const state$ = new BehaviorSubject<SearchState>('idle');
-  const error$ = new BehaviorSubject<SearchExecutionError | undefined>(undefined);
-  const hasMore$ = new BehaviorSubject<boolean>(false);
-  const destroyed = { value: false };
-  const setQuery = vi.fn();
-  const loadMore = vi.fn(async () => {
-    /* noop */
-  });
-  const clear = vi.fn();
-  const retry = vi.fn();
-
-  const handle: SearchHandle = {
-    results$,
-    state$,
-    error$,
-    hasMore$,
-    setQuery,
-    loadMore,
-    clear,
-    retry,
-    destroy: vi.fn(() => {
-      destroyed.value = true;
-    })
-  };
-  return { handle, results$, state$, error$, hasMore$, setQuery, loadMore, clear, retry, destroyed };
-};
-
-const makeSource = (handle: SearchHandle): SearchSourceLike & { searchSpy: ReturnType<typeof vi.fn> } => {
-  const searchSpy = vi.fn(() => handle);
-  return {
-    search: searchSpy,
-    searchSpy
-  };
-};
-
-afterEach(() => {
-  vi.useRealTimers();
-});
-
-describe('useSearch (React binding, T039)', () => {
-  it('initial render mirrors handle observables', () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { result } = renderHook(() => useSearch(src));
-    expect(result.current.query).toBe('');
-    expect(result.current.results).toEqual([]);
-    expect(result.current.state).toBe('idle');
-    expect(result.current.hasMore).toBe(false);
-    expect(src.searchSpy).toHaveBeenCalledTimes(1);
-  });
-
-  it('setQuery forwards to handle.setQuery and updates local query state', () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { result } = renderHook(() => useSearch(src));
-    act(() => result.current.setQuery('foo'));
-    expect(h.setQuery).toHaveBeenCalledWith('foo');
-    expect(result.current.query).toBe('foo');
-  });
-
-  it('handle observable updates propagate to hook state', () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { result } = renderHook(() => useSearch(src));
-    const rows: SearchResult[] = [{ entity: 'A', collection: 'a', id: '1', rank: -1, matchedField: 'x', snippet: 's' }];
-    act(() => {
-      h.results$.next(rows);
-      h.state$.next('success');
-      h.hasMore$.next(true);
-    });
-    expect(result.current.results).toEqual(rows);
-    expect(result.current.state).toBe('success');
-    expect(result.current.hasMore).toBe(true);
-  });
-
-  it('unmount calls handle.destroy', () => {
-    vi.useFakeTimers();
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { unmount } = renderHook(() => useSearch(src));
-    unmount();
-    vi.runAllTimers();
-    expect(h.destroyed.value).toBe(true);
-  });
-
-  it('keeps the handle usable under React StrictMode double effects', () => {
-    vi.useFakeTimers();
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const StrictWrapper = ({ children }: PropsWithChildren) => createElement(StrictMode, null, children);
-
-    const { result, unmount } = renderHook(() => useSearch(src), { wrapper: StrictWrapper });
-
-    act(() => {
-      vi.runAllTimers();
-    });
-    expect(h.destroyed.value).toBe(false);
-
-    act(() => result.current.setQuery('foo'));
-    expect(h.setQuery).toHaveBeenCalledWith('foo');
-    expect(result.current.query).toBe('foo');
-
-    unmount();
-    act(() => {
-      vi.runAllTimers();
-    });
-    expect(h.destroyed.value).toBe(true);
-  });
-
-  it('clear() resets query to empty and calls handle.clear', () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { result } = renderHook(() => useSearch(src));
-    act(() => result.current.setQuery('foo'));
-    act(() => result.current.clear());
-    expect(h.clear).toHaveBeenCalledTimes(1);
-    expect(result.current.query).toBe('');
-  });
-
-  it('retry() and loadMore() forward to handle', async () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { result } = renderHook(() => useSearch(src));
-    act(() => result.current.retry());
-    await act(async () => {
-      await result.current.loadMore();
-    });
-    expect(h.retry).toHaveBeenCalledTimes(1);
-    expect(h.loadMore).toHaveBeenCalledTimes(1);
-  });
-
-  it('passes initialQuery to source.search', () => {
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    renderHook(() => useSearch(src, { initialQuery: 'hi' }));
-    expect(src.searchSpy).toHaveBeenCalledWith('hi', { initialQuery: 'hi' });
-  });
-
-  it('rebuilds the handle when source changes', () => {
-    vi.useFakeTimers();
-    const first = makeHandle();
-    const second = makeHandle();
-    const firstSource = makeSource(first.handle);
-    const secondSource = makeSource(second.handle);
-    const { result, rerender } = renderHook(({ source }) => useSearch(source), {
-      initialProps: { source: firstSource as SearchSourceLike }
-    });
-
-    rerender({ source: secondSource });
-    act(() => vi.runAllTimers());
-    act(() => result.current.setQuery('next'));
-
-    expect(first.destroyed.value).toBe(true);
-    expect(first.setQuery).not.toHaveBeenCalled();
-    expect(secondSource.searchSpy).toHaveBeenCalledTimes(1);
-    expect(second.setQuery).toHaveBeenCalledWith('next');
-  });
-
-  it('does not rebuild for a semantically identical inline options object', () => {
-    vi.useFakeTimers();
-    const h = makeHandle();
-    const src = makeSource(h.handle);
-    const { rerender } = renderHook(() => useSearch(src, { debounce: 10, collections: ['Todo'] }));
-
-    rerender();
-    act(() => vi.runAllTimers());
-
-    expect(src.searchSpy).toHaveBeenCalledTimes(1);
-    expect(h.destroyed.value).toBe(false);
-  });
-
-  it('routes calls to the latest handle even via a callback captured before rebuild', () => {
-    vi.useFakeTimers();
-    const first = makeHandle();
-    const second = makeHandle();
-    const firstSource = makeSource(first.handle);
-    const secondSource = makeSource(second.handle);
-    const { result, rerender } = renderHook(({ source }) => useSearch(source), {
-      initialProps: { source: firstSource as SearchSourceLike }
-    });
-    const staleSetQuery = result.current.setQuery;
-
-    rerender({ source: secondSource });
-    act(() => vi.runAllTimers());
-
-    act(() => staleSetQuery('after-rebuild'));
-
-    expect(second.setQuery).toHaveBeenCalledWith('after-rebuild');
-    expect(first.setQuery).not.toHaveBeenCalled();
-  });
-
-  it('keeps stable setQuery/clear/retry/loadMore identities across handle rebuilds', () => {
-    vi.useFakeTimers();
-    const first = makeHandle();
-    const second = makeHandle();
-    const firstSource = makeSource(first.handle);
-    const secondSource = makeSource(second.handle);
-    const { result, rerender } = renderHook(({ source }) => useSearch(source), {
-      initialProps: { source: firstSource as SearchSourceLike }
-    });
-    const { setQuery, clear, retry, loadMore } = result.current;
-
-    rerender({ source: secondSource });
-    act(() => vi.runAllTimers());
-
-    expect(result.current.setQuery).toBe(setQuery);
-    expect(result.current.clear).toBe(clear);
-    expect(result.current.retry).toBe(retry);
-    expect(result.current.loadMore).toBe(loadMore);
-  });
-});

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "ignoreDeprecations": "6.0"
-  },
-  "extends": "../../tsconfig.base.json",
-  "files": [],
-  "include": [],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    },
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ]
-}

package/tsconfig.lib.json

@@ -1,36 +0,0 @@
-{
-  "compilerOptions": {
-    "outDir": "dist",
-    "types": ["node", "vite/client"],
-    "rootDir": "src",
-    "jsx": "react-jsx",
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "tsBuildInfoFile": "dist/tsconfig.lib.tsbuildinfo"
-  },
-  "exclude": [
-    "out-tsc",
-    "dist",
-    "**/*.spec.ts",
-    "**/*.test.ts",
-    "**/*.spec.tsx",
-    "**/*.test.tsx",
-    "vite.config.ts",
-    "vite.config.mts",
-    "vitest.config.ts",
-    "vitest.config.mts",
-    "eslint.config.js",
-    "eslint.config.cjs",
-    "eslint.config.mjs"
-  ],
-  "extends": "../../tsconfig.base.json",
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "references": [
-    {
-      "path": "../rxdb-plugin-search/tsconfig.lib.json"
-    },
-    {
-      "path": "../rxdb/tsconfig.lib.json"
-    }
-  ]
-}

package/tsconfig.spec.json

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "outDir": "./out-tsc/vitest",
-    "types": ["vitest/globals", "vitest/importMeta", "vite/client", "node", "vitest"],
-    "jsx": "react-jsx",
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "rootDir": "."
-  },
-  "extends": "../../tsconfig.base.json",
-  "include": [
-    "vite.config.ts",
-    "vite.config.mts",
-    "vitest.config.ts",
-    "vitest.config.mts",
-    "src/**/*.test.ts",
-    "src/**/*.spec.ts",
-    "src/**/*.test.tsx",
-    "src/**/*.spec.tsx",
-    "src/**/*.d.ts"
-  ],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    }
-  ]
-}

package/vite.config.mts

@@ -1,60 +0,0 @@
-/// <reference types='vitest' />
-import { codecovVitePlugin } from '@codecov/vite-plugin';
-import react from '@vitejs/plugin-react';
-import * as path from 'path';
-import { defineConfig } from 'vite';
-import dts from 'vite-plugin-dts';
-
-export default defineConfig(() => ({
-  root: import.meta.dirname,
-  cacheDir: '../../node_modules/.vite/packages/rxdb-plugin-search-react',
-  plugins: [
-    react(),
-    dts({
-      entryRoot: 'src',
-      pathsToAliases: false,
-      tsconfigPath: path.join(import.meta.dirname, 'tsconfig.lib.json')
-    }),
-    ...(process.env.CI === 'true' && process.env.CODECOV_TOKEN ?
-      [
-        codecovVitePlugin({
-          enableBundleAnalysis: true,
-          telemetry: false,
-          bundleName: 'rxdb-plugin-search-react',
-          uploadToken: process.env.CODECOV_TOKEN
-        })
-      ]
-    : [])
-  ],
-  build: {
-    outDir: './dist',
-    emptyOutDir: true,
-    reportCompressedSize: true,
-    commonjsOptions: {
-      transformMixedEsModules: true
-    },
-    lib: {
-      entry: 'src/index.ts',
-      name: 'rxdb-plugin-search-react',
-      fileName: 'index',
-      formats: ['es' as const]
-    },
-    rolldownOptions: {
-      // dts 插件生成声明文件天然比 Rolldown 原生链接阶段慢，抑制误报的 PLUGIN_TIMINGS 警告
-      checks: { pluginTimings: false },
-      external: [/^@aiao\//, 'react', 'react-dom', 'react/jsx-runtime', 'rxjs']
-    }
-  },
-  test: {
-    name: 'rxdb-plugin-search-react',
-    watch: false,
-    globals: true,
-    environment: 'jsdom',
-    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
-    reporters: ['default'],
-    coverage: {
-      reportsDirectory: './test-output/vitest/coverage',
-      provider: 'v8' as const
-    }
-  }
-}));