@olddevs/ui 4.3.0 → 4.5.0

package/src/editor/features/search/searchPlugin.ts

@@ -23,7 +23,7 @@ interface SearchPluginState {
 }
 
 type SearchMeta =
-  | { type: "set"; query: string; options: SearchOptions }
+  | { type: "set"; query: string; options?: Partial<SearchOptions> }
   | { type: "select"; index: number }
   | { type: "clear" };
 
@@ -85,17 +85,39 @@ function build(
   };
 }
 
-function searchPlugin() {
+/**
+ * Флажки после `setSearch`: названные в `named` заменяют прежние, остальные
+ * остаются. Ключ со значением `undefined` — не названный: обычное слияние
+ * `{ ...a, ...b }` стёрло бы им флажок, а вызов `setQuery(q, { matchCase: value })`
+ * с необязательным значением экрана не просит ничего менять.
+ */
+function withNamedFlags(current: SearchOptions, named: Partial<SearchOptions> = {}): SearchOptions {
+  const next = { ...current };
+  for (const key of Object.keys(named) as (keyof SearchOptions)[]) {
+    const value = named[key];
+    if (value !== undefined) next[key] = value;
+  }
+  return next;
+}
+
+/**
+ * @param flags флажки без запроса: до первого `setSearch` и после `clearSearch`
+ * (Опции Инструмента). Поиск, который идёт, держит свои.
+ */
+function searchPlugin(flags: SearchOptions) {
   return new Plugin<SearchPluginState>({
     key: SEARCH_KEY,
     state: {
-      init: (_, state) => build(state, "", EMPTY_OPTIONS, () => -1),
+      init: (_, state) => build(state, "", flags, () => -1),
       apply(tr: Transaction, previous, _old, state) {
         const meta = tr.getMeta(SEARCH_KEY) as SearchMeta | undefined;
-        if (meta?.type === "clear") return build(state, "", previous.options, () => -1);
+        if (meta?.type === "clear") return build(state, "", flags, () => -1);
         if (meta?.type === "set") {
-          return build(state, meta.query, meta.options, (matches) =>
-            indexFrom(matches, state.selection.from)
+          return build(
+            state,
+            meta.query,
+            withNamedFlags(previous.options, meta.options),
+            (matches) => indexFrom(matches, state.selection.from)
           );
         }
         if (meta?.type === "select") {
@@ -151,8 +173,11 @@ function replaceRange(tr: Transaction, { from, to }: SearchMatch, text: string)
 declare module "@tiptap/core" {
   interface Commands<ReturnType> {
     search: {
-      /** Новый запрос или опции: совпадения пересчитываются, текущее — первое после каретки. */
-      setSearch: (query: string, options: SearchOptions) => ReturnType;
+      /**
+       * Новый запрос или флажки: совпадения пересчитываются, текущее — первое после
+       * каретки. Не названные флажки остаются как были.
+       */
+      setSearch: (query: string, options?: Partial<SearchOptions>) => ReturnType;
       /**
        * Следующее (`1`) или предыдущее (`-1`) совпадение по кругу; выделяет его.
        * Прокрутка ProseMirror срабатывает, только когда фокус в Документе; из
@@ -163,13 +188,15 @@ declare module "@tiptap/core" {
       replaceMatch: (replacement: string) => ReturnType;
       /** Заменить все совпадения — одна транзакция, одна отмена. */
       replaceAllMatches: (replacement: string) => ReturnType;
-      /** Убрать запрос и подсветку. */
+      /** Убрать запрос и подсветку; флажки вернутся к Опциям Инструмента. */
       clearSearch: () => ReturnType;
     };
   }
 }
 
 export interface SearchExtensionOptions {
+  /** Флажки, с которых стартует поиск и к которым он возвращается: Опции Инструмента. */
+  flags: SearchOptions;
   /**
    * Открыть панель поиска (`replace` — с фокусом в поле замены). Панель держит
    * `RichTextEditor`; `false` — панели нет, и `Mod+F` уходит браузеру.
@@ -186,8 +213,10 @@ export interface SearchExtensionOptions {
  */
 export const SearchExtension = Extension.create<SearchExtensionOptions>({
   name: "search",
-  addOptions: () => ({ open: () => false }),
-  addProseMirrorPlugins: () => [searchPlugin()],
+  addOptions: () => ({ open: () => false, flags: EMPTY_OPTIONS }),
+  addProseMirrorPlugins() {
+    return [searchPlugin(this.options.flags)];
+  },
   addKeyboardShortcuts() {
     return {
       "Mod-f": () => this.options.open(false),

package/src/editor/features/search/searchSnapshot.ts

@@ -0,0 +1,29 @@
+"use client";
+
+import type { Editor } from "@tiptap/core";
+import type { SearchToolState } from "../../core/toolState.js";
+import { searchState } from "./searchPlugin.js";
+
+/**
+ * Снимок Состояния `search` для `useRichTextToolState`: открытые поля
+ * `searchState` плагина плюс открытость панели, без позиций совпадений. Лежит
+ * отдельно от `searchPlugin.ts`: вычисление нужно только хуку и не должно
+ * попадать в статический граф Редактора.
+ *
+ * Флажки — из плагина и при закрытой панели: их держит движок, а не панель.
+ * Закрытие возвращает их к стартовым из Опций, а `setQuery` без панели ставит
+ * свои. `null` — плагина нет (Инструмент `search` не вошёл в движок).
+ */
+export function searchSnapshot(editor: Editor, open: boolean): SearchToolState | null {
+  const state = searchState(editor.state);
+  if (!state) return null;
+  const { matchCase, wholeWord, regex } = state.options;
+  return {
+    open,
+    query: state.query,
+    flags: { matchCase, wholeWord, regex },
+    total: state.total,
+    current: state.current,
+    error: state.error ?? null,
+  };
+}

package/src/editor/features/search/searchTool.ts

@@ -1,6 +1,9 @@
 "use client";
 
+import type { Editor } from "@tiptap/core";
 import type { ToolDescriptor } from "../../core/toolDescriptor.js";
+import type { SearchToolCommands } from "../../core/toolCommands.js";
+import type { SearchToolOptions } from "../../core/toolOptions.js";
 import { SearchExtension } from "./searchPlugin.js";
 
 /**
@@ -14,9 +17,56 @@ import { SearchExtension } from "./searchPlugin.js";
 /** Сочетание кнопки «Поиск»: строка справочника и подсказка кнопки — из одной записи. */
 export const SEARCH_KEYS = ["mod", "F"] as const;
 
+/** Стартовые флажки панели: все выключены. */
+export const SEARCH_DEFAULTS: SearchToolOptions = {
+  matchCase: false,
+  wholeWord: false,
+  regex: false,
+};
+
+const isFlag = (value: unknown) => typeof value === "boolean";
+
+/*
+  Показать текущее совпадение после команды. ProseMirror прокручивает только
+  при фокусе в Документе, а команды зовут и с кнопки экрана. Код прокрутки
+  (`revealMatch.ts`) лежит в ленивом куске панели и в старт не входит:
+  грузится при первом вызове, поэтому прокрутка приходит на микрозадачу и кадр
+  позже. Открытая панель уже подгрузила его, и её переходы сливаются с этим
+  вызовом в одну прокрутку.
+*/
+const reveal = (editor: Editor, done: boolean) => {
+  if (done) void import("./revealMatch.js").then((module) => module.scheduleRevealMatch(editor));
+  return done;
+};
+
 export const SEARCH_TOOL: ToolDescriptor = {
   name: "search",
-  engine: (context) => [SearchExtension.configure({ open: context.openSearch ?? (() => false) })],
+  defaults: SEARCH_DEFAULTS,
+  checks: { matchCase: isFlag, wholeWord: isFlag, regex: isFlag },
+  /*
+    Запрос, переходы и замена — команды движка, как у панели; панель и HTML-режим
+    знает мост. `editor.commands` читается при каждом вызове, а не один раз:
+    Tiptap собирает его вместе с транзакцией, и сохранённый набор отправил бы
+    устаревшую.
+  */
+  commands: ({ editor, bridge }): SearchToolCommands => ({
+    open: (options) => bridge.openSearch(options?.replace === true, options?.query),
+    close: bridge.closeSearch,
+    setQuery: (query, flags) =>
+      !bridge.sourceOpen() &&
+      editor.commands.setSearch(query, flags) &&
+      (reveal(editor, query !== ""), true),
+    next: () => reveal(editor, editor.commands.searchStep(1)),
+    previous: () => reveal(editor, editor.commands.searchStep(-1)),
+    replace: (text) => editor.commands.replaceMatch(text),
+    replaceAll: (text) => editor.commands.replaceAllMatches(text),
+  }),
+  engine: (context, options) => [
+    SearchExtension.configure({
+      open: context.openSearch ?? (() => false),
+      flags: options as SearchToolOptions,
+    }),
+  ],
   shortcuts: [
     { id: "search", group: "search", tool: "search", keys: SEARCH_KEYS, label: (m) => m.search },
     {