@beyondwork/docx-react-component 1.0.28 → 1.0.29

package/dist/ui-tailwind/editor-surface/search-plugin.cjs

@@ -0,0 +1,313 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ui-tailwind/editor-surface/search-plugin.ts
+var search_plugin_exports = {};
+__export(search_plugin_exports, {
+  DEFAULT_SEARCH_HIGHLIGHT_COLOR: () => DEFAULT_SEARCH_HIGHLIGHT_COLOR,
+  clearSearch: () => clearSearch,
+  createSearchExcerpt: () => createSearchExcerpt,
+  createSearchPlugin: () => createSearchPlugin,
+  findSearchMatches: () => findSearchMatches,
+  performSearch: () => performSearch,
+  searchPluginKey: () => searchPluginKey,
+  searchSecondaryStories: () => searchSecondaryStories
+});
+module.exports = __toCommonJS(search_plugin_exports);
+var import_prosemirror_state = require("prosemirror-state");
+var import_prosemirror_view = require("prosemirror-view");
+
+// src/core/search/search-text.ts
+function buildSearchPattern(query, options = {}) {
+  if (!query) {
+    return null;
+  }
+  const caseSensitive = options.matchCase ?? options.caseSensitive ?? false;
+  const regex = options.regex ?? false;
+  const wholeWord = options.wholeWord ?? false;
+  try {
+    const source = regex ? query : query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const wrapped = wholeWord ? `\\b${source}\\b` : source;
+    return new RegExp(wrapped, caseSensitive ? "g" : "gi");
+  } catch {
+    return null;
+  }
+}
+function findSearchMatches(text, query, options = {}) {
+  const pattern = buildSearchPattern(query, options);
+  if (!pattern) return [];
+  const results = [];
+  let match;
+  pattern.lastIndex = 0;
+  while ((match = pattern.exec(text)) !== null) {
+    results.push({
+      from: match.index,
+      to: match.index + match[0].length,
+      text: match[0],
+      index: results.length
+    });
+    if (match[0].length === 0) {
+      pattern.lastIndex += 1;
+    }
+  }
+  return results;
+}
+function createSearchExcerpt(text, from, to, radius = 24) {
+  const safeFrom = Math.max(0, Math.min(from, text.length));
+  const safeTo = Math.max(safeFrom, Math.min(to, text.length));
+  const start = Math.max(0, safeFrom - radius);
+  const end = Math.min(text.length, safeTo + radius);
+  const prefix = start > 0 ? "\u2026" : "";
+  const suffix = end < text.length ? "\u2026" : "";
+  const excerpt = text.slice(start, end).replace(/[\uFFF9\uFFFA]/gu, "").replace(/\s{2,}/gu, " ").trim();
+  return `${prefix}${excerpt}${suffix}`;
+}
+function searchSurfaceBlocks(blocks, query, options = {}) {
+  const projection = projectSurfaceText(blocks);
+  return findSearchMatches(projection.text, query, options).map((match) => {
+    const range = resolveProjectedRuntimeRange(
+      projection.offsetMap,
+      match.from,
+      match.to
+    );
+    if (!range) {
+      return null;
+    }
+    return {
+      ...match,
+      from: range.from,
+      to: range.to,
+      excerpt: createSearchExcerpt(projection.text, match.from, match.to)
+    };
+  }).filter((match) => Boolean(match));
+}
+function searchSecondaryStories(stories, query, options = {}) {
+  const results = [];
+  for (const story of stories) {
+    for (const match of searchSurfaceBlocks(story.blocks, query, options)) {
+      results.push({
+        storyTarget: story.target,
+        from: match.from,
+        to: match.to,
+        text: match.text,
+        index: results.length,
+        excerpt: match.excerpt
+      });
+    }
+  }
+  return results;
+}
+function projectSurfaceText(blocks) {
+  const builder = {
+    text: [],
+    offsetMap: [],
+    nextRuntimeOffset: 0
+  };
+  appendSurfaceBlocks(builder, blocks);
+  return {
+    text: builder.text.join(""),
+    offsetMap: builder.offsetMap
+  };
+}
+function appendSurfaceBlocks(builder, blocks) {
+  for (const block of blocks) {
+    if (block.kind === "opaque_block") {
+      if (block.fragmentId.startsWith("preview:")) {
+        continue;
+      }
+      appendAtomicSpan(builder, block.from, block.to, "\uFFFA");
+      continue;
+    }
+    if (block.kind === "table") {
+      appendRuntimeGap(builder, block.from);
+      for (const [rowIndex, row] of block.rows.entries()) {
+        if (rowIndex > 0) {
+          appendSyntheticSeparator(builder, "\n");
+        }
+        for (const [cellIndex, cell] of row.cells.entries()) {
+          if (cellIndex > 0) {
+            appendSyntheticSeparator(builder, "	");
+          }
+          appendSurfaceBlocks(builder, cell.content);
+        }
+      }
+      appendRuntimeGap(builder, block.to);
+      continue;
+    }
+    if (block.kind === "sdt_block") {
+      appendRuntimeGap(builder, block.from);
+      appendSurfaceBlocks(builder, block.children);
+      appendRuntimeGap(builder, block.to);
+      continue;
+    }
+    for (const segment of block.segments) {
+      switch (segment.kind) {
+        case "text":
+          appendTextSpan(builder, segment.text, segment.from);
+          break;
+        case "tab":
+          appendAtomicSpan(builder, segment.from, segment.to, "	");
+          break;
+        case "hard_break":
+          appendAtomicSpan(builder, segment.from, segment.to, "\n");
+          break;
+        case "image":
+          appendAtomicSpan(builder, segment.from, segment.to, "\uFFFC");
+          break;
+        case "opaque_inline":
+          appendAtomicSpan(builder, segment.from, segment.to, "\uFFF9");
+          break;
+        case "note_ref":
+          appendAtomicSpan(builder, segment.from, segment.to, "\uFFFA");
+          break;
+      }
+    }
+    appendRuntimeGap(builder, block.to);
+  }
+}
+function appendTextSpan(builder, text, startOffset) {
+  appendRuntimeGap(builder, startOffset);
+  for (let index = 0; index < text.length; index += 1) {
+    builder.text.push(text[index]);
+    builder.offsetMap.push(startOffset + index);
+  }
+  builder.nextRuntimeOffset = Math.max(
+    builder.nextRuntimeOffset,
+    startOffset + text.length
+  );
+}
+function appendAtomicSpan(builder, from, to, char) {
+  appendRuntimeGap(builder, from);
+  const width = Math.max(1, to - from);
+  for (let index = 0; index < width; index += 1) {
+    builder.text.push(char);
+    builder.offsetMap.push(from + index);
+  }
+  builder.nextRuntimeOffset = Math.max(builder.nextRuntimeOffset, to);
+}
+function appendRuntimeGap(builder, nextFrom) {
+  for (let offset = builder.nextRuntimeOffset; offset < nextFrom; offset += 1) {
+    builder.text.push("\n");
+    builder.offsetMap.push(offset);
+  }
+  builder.nextRuntimeOffset = Math.max(builder.nextRuntimeOffset, nextFrom);
+}
+function appendSyntheticSeparator(builder, value) {
+  for (const char of value) {
+    builder.text.push(char);
+    builder.offsetMap.push(null);
+  }
+}
+function resolveProjectedRuntimeRange(offsetMap, from, to) {
+  let runtimeFrom;
+  for (let index = from; index < to; index += 1) {
+    const offset = offsetMap[index];
+    if (offset !== null && offset !== void 0) {
+      runtimeFrom = offset;
+      break;
+    }
+  }
+  let runtimeTo;
+  for (let index = to - 1; index >= from; index -= 1) {
+    const offset = offsetMap[index];
+    if (offset !== null && offset !== void 0) {
+      runtimeTo = offset + 1;
+      break;
+    }
+  }
+  if (runtimeFrom === void 0 || runtimeTo === void 0) {
+    return null;
+  }
+  return { from: runtimeFrom, to: runtimeTo };
+}
+
+// src/ui-tailwind/editor-surface/search-plugin.ts
+var DEFAULT_SEARCH_HIGHLIGHT_COLOR = "#fde68a";
+var searchPluginKey = new import_prosemirror_state.PluginKey("search");
+function createSearchPlugin() {
+  return new import_prosemirror_state.Plugin({
+    key: searchPluginKey,
+    state: {
+      init() {
+        return { results: [], highlightColor: null };
+      },
+      apply(tr, pluginState) {
+        const meta = tr.getMeta(searchPluginKey);
+        if (meta) return meta;
+        return pluginState;
+      }
+    },
+    props: {
+      decorations(state) {
+        const pluginState = searchPluginKey.getState(state);
+        if (!pluginState || pluginState.results.length === 0 || !pluginState.highlightColor) {
+          return import_prosemirror_view.DecorationSet.empty;
+        }
+        const decos = pluginState.results.map(
+          (r) => import_prosemirror_view.Decoration.inline(r.from, r.to, {
+            style: `background-color: ${pluginState.highlightColor}; border-radius: 2px;`,
+            class: "search-highlight"
+          })
+        );
+        return import_prosemirror_view.DecorationSet.create(state.doc, decos);
+      }
+    }
+  });
+}
+function performSearch(state, query, options = {}) {
+  const pattern = buildSearchPattern(query, options);
+  if (!pattern) return [];
+  const results = [];
+  state.doc.descendants((node, pos) => {
+    if (!node.isText || !node.text) return;
+    let match;
+    pattern.lastIndex = 0;
+    while ((match = pattern.exec(node.text)) !== null) {
+      results.push({
+        from: pos + match.index,
+        to: pos + match.index + match[0].length,
+        text: match[0],
+        index: results.length
+      });
+      if (match[0].length === 0) {
+        pattern.lastIndex += 1;
+      }
+    }
+  });
+  return results;
+}
+function clearSearch(state, dispatch) {
+  if (!dispatch) return true;
+  dispatch(
+    state.tr.setMeta(searchPluginKey, { results: [], highlightColor: null })
+  );
+  return true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_SEARCH_HIGHLIGHT_COLOR,
+  clearSearch,
+  createSearchExcerpt,
+  createSearchPlugin,
+  findSearchMatches,
+  performSearch,
+  searchPluginKey,
+  searchSecondaryStories
+});
+//# sourceMappingURL=search-plugin.cjs.map

package/dist/ui-tailwind/editor-surface/search-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui-tailwind/editor-surface/search-plugin.ts","../../../src/core/search/search-text.ts"],"sourcesContent":["/**\n * ProseMirror search/highlight plugin for the editor surface.\n *\n * Provides in-document search with optional case sensitivity and regex support.\n * Matched ranges are shown as inline decorations with a configurable highlight color.\n *\n * Usage:\n *   1. Include createSearchPlugin() in the editor plugin list.\n *   2. Call performSearch(state, query, options) to compute matches.\n *   3. Dispatch the results into the plugin state via searchPluginKey meta.\n *   4. Call clearSearch(state, dispatch) to remove all highlights.\n */\n\nimport { Plugin, PluginKey } from \"prosemirror-state\";\nimport type { EditorState, Transaction } from \"prosemirror-state\";\nimport { Decoration, DecorationSet } from \"prosemirror-view\";\n\nimport type {\n  SearchOptions as PublicSearchOptions,\n} from \"../../api/public-types\";\nimport {\n  buildSearchPattern,\n  createSearchExcerpt,\n  findSearchMatches,\n  searchSecondaryStories,\n  type SecondaryStorySearchResult,\n  type SearchTextOptions,\n} from \"../../core/search/search-text.ts\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport interface SearchResult {\n  from: number;\n  to: number;\n  text: string;\n  index: number;\n}\n\nexport interface SearchOptions extends PublicSearchOptions, SearchTextOptions {\n  regex?: boolean;\n  highlightColor?: string;\n}\n\nexport const DEFAULT_SEARCH_HIGHLIGHT_COLOR = \"#fde68a\";\n\n// ---------------------------------------------------------------------------\n// Plugin state\n// ---------------------------------------------------------------------------\n\ninterface SearchPluginState {\n  results: SearchResult[];\n  highlightColor: string | null;\n}\n\nexport const searchPluginKey = new PluginKey<SearchPluginState>(\"search\");\n\n// ---------------------------------------------------------------------------\n// Plugin factory\n// ---------------------------------------------------------------------------\n\nexport function createSearchPlugin(): Plugin<SearchPluginState> {\n  return new Plugin<SearchPluginState>({\n    key: searchPluginKey,\n\n    state: {\n      init(): SearchPluginState {\n        return { results: [], highlightColor: null };\n      },\n\n      apply(tr: Transaction, pluginState: SearchPluginState): SearchPluginState {\n        const meta = tr.getMeta(searchPluginKey) as SearchPluginState | undefined;\n        if (meta) return meta;\n        return pluginState;\n      },\n    },\n\n    props: {\n      decorations(state: EditorState): DecorationSet {\n        const pluginState = searchPluginKey.getState(state);\n        if (\n          !pluginState ||\n          pluginState.results.length === 0 ||\n          !pluginState.highlightColor\n        ) {\n          return DecorationSet.empty;\n        }\n\n        const decos = pluginState.results.map((r) =>\n          Decoration.inline(r.from, r.to, {\n            style: `background-color: ${pluginState.highlightColor}; border-radius: 2px;`,\n            class: \"search-highlight\",\n          }),\n        );\n\n        return DecorationSet.create(state.doc, decos);\n      },\n    },\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Search computation\n// ---------------------------------------------------------------------------\n\n/**\n * Scan all text nodes in the document for matches of `query`.\n * Returns an array of match ranges; does not dispatch anything.\n * To apply highlights, set the results on the plugin via:\n *   view.dispatch(view.state.tr.setMeta(searchPluginKey, { results, highlightColor }))\n */\nexport function performSearch(\n  state: EditorState,\n  query: string,\n  options: SearchOptions = {},\n): SearchResult[] {\n  const pattern = buildSearchPattern(query, options);\n  if (!pattern) return [];\n\n  const results: SearchResult[] = [];\n\n  state.doc.descendants((node, pos) => {\n    if (!node.isText || !node.text) return;\n\n    let match: RegExpExecArray | null;\n    pattern.lastIndex = 0;\n    while ((match = pattern.exec(node.text)) !== null) {\n      results.push({\n        from: pos + match.index,\n        to: pos + match.index + match[0].length,\n        text: match[0],\n        index: results.length,\n      });\n\n      if (match[0].length === 0) {\n        pattern.lastIndex += 1;\n      }\n    }\n  });\n\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// Clear helper (ProseMirror Command signature)\n// ---------------------------------------------------------------------------\n\n/**\n * ProseMirror command that clears all search highlights from the plugin state.\n */\nexport function clearSearch(\n  state: EditorState,\n  dispatch?: (tr: Transaction) => void,\n): boolean {\n  if (!dispatch) return true;\n  dispatch(\n    state.tr.setMeta(searchPluginKey, { results: [], highlightColor: null }),\n  );\n  return true;\n}\n\nexport {\n  createSearchExcerpt,\n  findSearchMatches,\n  searchSecondaryStories,\n};\nexport type { SecondaryStorySearchResult };\n","import type {\n  EditorStoryTarget,\n  SearchOptions as PublicSearchOptions,\n  SecondaryStorySurface,\n  SurfaceBlockSnapshot,\n  WorkflowCandidateRange,\n} from \"../../api/public-types\";\n\nexport interface SearchTextOptions extends PublicSearchOptions {\n  caseSensitive?: boolean;\n  regex?: boolean;\n}\n\nexport interface SearchResult {\n  from: number;\n  to: number;\n  text: string;\n  index: number;\n}\n\nexport interface SurfaceSearchResult extends SearchResult {\n  excerpt: string;\n}\n\nexport interface SecondaryStorySearchResult extends SurfaceSearchResult {\n  storyTarget: EditorStoryTarget;\n}\n\ninterface ProjectedSurfaceText {\n  text: string;\n  offsetMap: Array<number | null>;\n}\n\ninterface SurfaceProjectionBuilder {\n  text: string[];\n  offsetMap: Array<number | null>;\n  nextRuntimeOffset: number;\n}\n\nexport function buildSearchPattern(\n  query: string,\n  options: SearchTextOptions = {},\n): RegExp | null {\n  if (!query) {\n    return null;\n  }\n\n  const caseSensitive = options.matchCase ?? options.caseSensitive ?? false;\n  const regex = options.regex ?? false;\n  const wholeWord = options.wholeWord ?? false;\n\n  try {\n    const source = regex\n      ? query\n      : query.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    const wrapped = wholeWord ? `\\\\b${source}\\\\b` : source;\n    return new RegExp(wrapped, caseSensitive ? \"g\" : \"gi\");\n  } catch {\n    return null;\n  }\n}\n\nexport function findSearchMatches(\n  text: string,\n  query: string,\n  options: SearchTextOptions = {},\n): SearchResult[] {\n  const pattern = buildSearchPattern(query, options);\n  if (!pattern) return [];\n\n  const results: SearchResult[] = [];\n  let match: RegExpExecArray | null;\n  pattern.lastIndex = 0;\n  while ((match = pattern.exec(text)) !== null) {\n    results.push({\n      from: match.index,\n      to: match.index + match[0].length,\n      text: match[0],\n      index: results.length,\n    });\n\n    if (match[0].length === 0) {\n      pattern.lastIndex += 1;\n    }\n  }\n\n  return results;\n}\n\nexport function createSearchExcerpt(\n  text: string,\n  from: number,\n  to: number,\n  radius = 24,\n): string {\n  const safeFrom = Math.max(0, Math.min(from, text.length));\n  const safeTo = Math.max(safeFrom, Math.min(to, text.length));\n  const start = Math.max(0, safeFrom - radius);\n  const end = Math.min(text.length, safeTo + radius);\n  const prefix = start > 0 ? \"…\" : \"\";\n  const suffix = end < text.length ? \"…\" : \"\";\n  const excerpt = text\n    .slice(start, end)\n    .replace(/[\\uFFF9\\uFFFA]/gu, \"\")\n    .replace(/\\s{2,}/gu, \" \")\n    .trim();\n  return `${prefix}${excerpt}${suffix}`;\n}\n\nexport function searchSurfaceBlocks(\n  blocks: readonly SurfaceBlockSnapshot[],\n  query: string,\n  options: SearchTextOptions = {},\n): SurfaceSearchResult[] {\n  const projection = projectSurfaceText(blocks);\n  return findSearchMatches(projection.text, query, options)\n    .map((match) => {\n      const range = resolveProjectedRuntimeRange(\n        projection.offsetMap,\n        match.from,\n        match.to,\n      );\n      if (!range) {\n        return null;\n      }\n\n      return {\n        ...match,\n        from: range.from,\n        to: range.to,\n        excerpt: createSearchExcerpt(projection.text, match.from, match.to),\n      };\n    })\n    .filter((match): match is SurfaceSearchResult => Boolean(match));\n}\n\nexport function searchSecondaryStories(\n  stories: readonly SecondaryStorySurface[],\n  query: string,\n  options: SearchTextOptions = {},\n): SecondaryStorySearchResult[] {\n  const results: SecondaryStorySearchResult[] = [];\n\n  for (const story of stories) {\n    for (const match of searchSurfaceBlocks(story.blocks, query, options)) {\n      results.push({\n        storyTarget: story.target,\n        from: match.from,\n        to: match.to,\n        text: match.text,\n        index: results.length,\n        excerpt: match.excerpt,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Derive workflow candidate ranges from search results.\n *\n * Maps search hits into `WorkflowCandidateRange` values suitable for\n * inclusion in a host-fed `WorkflowOverlay`. The runtime search results\n * supply runtime-mapped `from`/`to` positions that align with the\n * canonical document model.\n */\nexport function deriveCandidateRangesFromSearch(\n  results: readonly SurfaceSearchResult[],\n  storyTarget?: EditorStoryTarget,\n  source: WorkflowCandidateRange[\"source\"] = \"search\",\n): WorkflowCandidateRange[] {\n  return results.map((result, index) => ({\n    candidateId: `search-candidate-${index}`,\n    storyTarget,\n    anchor: {\n      kind: \"range\" as const,\n      from: result.from,\n      to: result.to,\n      assoc: { start: 1 as const, end: -1 as const },\n    },\n    label: result.excerpt,\n    source,\n  }));\n}\n\nexport function projectSurfaceText(\n  blocks: readonly SurfaceBlockSnapshot[],\n): ProjectedSurfaceText {\n  const builder: SurfaceProjectionBuilder = {\n    text: [],\n    offsetMap: [],\n    nextRuntimeOffset: 0,\n  };\n\n  appendSurfaceBlocks(builder, blocks);\n\n  return {\n    text: builder.text.join(\"\"),\n    offsetMap: builder.offsetMap,\n  };\n}\n\nfunction appendSurfaceBlocks(\n  builder: SurfaceProjectionBuilder,\n  blocks: readonly SurfaceBlockSnapshot[],\n): void {\n  for (const block of blocks) {\n    if (block.kind === \"opaque_block\") {\n      if (block.fragmentId.startsWith(\"preview:\")) {\n        continue;\n      }\n      appendAtomicSpan(builder, block.from, block.to, \"\\uFFFA\");\n      continue;\n    }\n\n    if (block.kind === \"table\") {\n      appendRuntimeGap(builder, block.from);\n      for (const [rowIndex, row] of block.rows.entries()) {\n        if (rowIndex > 0) {\n          appendSyntheticSeparator(builder, \"\\n\");\n        }\n        for (const [cellIndex, cell] of row.cells.entries()) {\n          if (cellIndex > 0) {\n            appendSyntheticSeparator(builder, \"\\t\");\n          }\n          appendSurfaceBlocks(builder, cell.content);\n        }\n      }\n      appendRuntimeGap(builder, block.to);\n      continue;\n    }\n\n    if (block.kind === \"sdt_block\") {\n      appendRuntimeGap(builder, block.from);\n      appendSurfaceBlocks(builder, block.children);\n      appendRuntimeGap(builder, block.to);\n      continue;\n    }\n\n    for (const segment of block.segments) {\n      switch (segment.kind) {\n        case \"text\":\n          appendTextSpan(builder, segment.text, segment.from);\n          break;\n        case \"tab\":\n          appendAtomicSpan(builder, segment.from, segment.to, \"\\t\");\n          break;\n        case \"hard_break\":\n          appendAtomicSpan(builder, segment.from, segment.to, \"\\n\");\n          break;\n        case \"image\":\n          appendAtomicSpan(builder, segment.from, segment.to, \"\\uFFFC\");\n          break;\n        case \"opaque_inline\":\n          appendAtomicSpan(builder, segment.from, segment.to, \"\\uFFF9\");\n          break;\n        case \"note_ref\":\n          appendAtomicSpan(builder, segment.from, segment.to, \"\\uFFFA\");\n          break;\n      }\n    }\n\n    appendRuntimeGap(builder, block.to);\n  }\n}\n\nfunction appendTextSpan(\n  builder: SurfaceProjectionBuilder,\n  text: string,\n  startOffset: number,\n): void {\n  appendRuntimeGap(builder, startOffset);\n\n  for (let index = 0; index < text.length; index += 1) {\n    builder.text.push(text[index]!);\n    builder.offsetMap.push(startOffset + index);\n  }\n\n  builder.nextRuntimeOffset = Math.max(\n    builder.nextRuntimeOffset,\n    startOffset + text.length,\n  );\n}\n\nfunction appendAtomicSpan(\n  builder: SurfaceProjectionBuilder,\n  from: number,\n  to: number,\n  char: string,\n): void {\n  appendRuntimeGap(builder, from);\n  const width = Math.max(1, to - from);\n\n  for (let index = 0; index < width; index += 1) {\n    builder.text.push(char);\n    builder.offsetMap.push(from + index);\n  }\n\n  builder.nextRuntimeOffset = Math.max(builder.nextRuntimeOffset, to);\n}\n\nfunction appendRuntimeGap(\n  builder: SurfaceProjectionBuilder,\n  nextFrom: number,\n): void {\n  for (\n    let offset = builder.nextRuntimeOffset;\n    offset < nextFrom;\n    offset += 1\n  ) {\n    builder.text.push(\"\\n\");\n    builder.offsetMap.push(offset);\n  }\n\n  builder.nextRuntimeOffset = Math.max(builder.nextRuntimeOffset, nextFrom);\n}\n\nfunction appendSyntheticSeparator(\n  builder: SurfaceProjectionBuilder,\n  value: string,\n): void {\n  for (const char of value) {\n    builder.text.push(char);\n    builder.offsetMap.push(null);\n  }\n}\n\nfunction resolveProjectedRuntimeRange(\n  offsetMap: ReadonlyArray<number | null>,\n  from: number,\n  to: number,\n): { from: number; to: number } | null {\n  let runtimeFrom: number | undefined;\n  for (let index = from; index < to; index += 1) {\n    const offset = offsetMap[index];\n    if (offset !== null && offset !== undefined) {\n      runtimeFrom = offset;\n      break;\n    }\n  }\n\n  let runtimeTo: number | undefined;\n  for (let index = to - 1; index >= from; index -= 1) {\n    const offset = offsetMap[index];\n    if (offset !== null && offset !== undefined) {\n      runtimeTo = offset + 1;\n      break;\n    }\n  }\n\n  if (runtimeFrom === undefined || runtimeTo === undefined) {\n    return null;\n  }\n\n  return { from: runtimeFrom, to: runtimeTo };\n}\n"],"mappings":"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","names":[]}

package/dist/ui-tailwind/editor-surface/search-plugin.d.cts

@@ -0,0 +1,67 @@
+import { EditorState, Transaction, Plugin, PluginKey } from 'prosemirror-state';
+import { aS as SearchOptions$1, v as EditorStoryTarget, aT as SecondaryStorySurface } from '../../public-types-CeMaDueh.cjs';
+import '../../canonical-document-BLEbzL2J.cjs';
+
+interface SearchTextOptions extends SearchOptions$1 {
+    caseSensitive?: boolean;
+    regex?: boolean;
+}
+interface SearchResult$1 {
+    from: number;
+    to: number;
+    text: string;
+    index: number;
+}
+interface SurfaceSearchResult extends SearchResult$1 {
+    excerpt: string;
+}
+interface SecondaryStorySearchResult extends SurfaceSearchResult {
+    storyTarget: EditorStoryTarget;
+}
+declare function findSearchMatches(text: string, query: string, options?: SearchTextOptions): SearchResult$1[];
+declare function createSearchExcerpt(text: string, from: number, to: number, radius?: number): string;
+declare function searchSecondaryStories(stories: readonly SecondaryStorySurface[], query: string, options?: SearchTextOptions): SecondaryStorySearchResult[];
+
+/**
+ * ProseMirror search/highlight plugin for the editor surface.
+ *
+ * Provides in-document search with optional case sensitivity and regex support.
+ * Matched ranges are shown as inline decorations with a configurable highlight color.
+ *
+ * Usage:
+ *   1. Include createSearchPlugin() in the editor plugin list.
+ *   2. Call performSearch(state, query, options) to compute matches.
+ *   3. Dispatch the results into the plugin state via searchPluginKey meta.
+ *   4. Call clearSearch(state, dispatch) to remove all highlights.
+ */
+
+interface SearchResult {
+    from: number;
+    to: number;
+    text: string;
+    index: number;
+}
+interface SearchOptions extends SearchOptions$1, SearchTextOptions {
+    regex?: boolean;
+    highlightColor?: string;
+}
+declare const DEFAULT_SEARCH_HIGHLIGHT_COLOR = "#fde68a";
+interface SearchPluginState {
+    results: SearchResult[];
+    highlightColor: string | null;
+}
+declare const searchPluginKey: PluginKey<SearchPluginState>;
+declare function createSearchPlugin(): Plugin<SearchPluginState>;
+/**
+ * Scan all text nodes in the document for matches of `query`.
+ * Returns an array of match ranges; does not dispatch anything.
+ * To apply highlights, set the results on the plugin via:
+ *   view.dispatch(view.state.tr.setMeta(searchPluginKey, { results, highlightColor }))
+ */
+declare function performSearch(state: EditorState, query: string, options?: SearchOptions): SearchResult[];
+/**
+ * ProseMirror command that clears all search highlights from the plugin state.
+ */
+declare function clearSearch(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+
+export { DEFAULT_SEARCH_HIGHLIGHT_COLOR, type SearchOptions, type SearchResult, type SecondaryStorySearchResult, clearSearch, createSearchExcerpt, createSearchPlugin, findSearchMatches, performSearch, searchPluginKey, searchSecondaryStories };

package/dist/ui-tailwind/editor-surface/search-plugin.d.ts

@@ -0,0 +1,67 @@
+import { EditorState, Transaction, Plugin, PluginKey } from 'prosemirror-state';
+import { aS as SearchOptions$1, v as EditorStoryTarget, aT as SecondaryStorySurface } from '../../public-types-7ZL_94cz.js';
+import '../../canonical-document-BLEbzL2J.js';
+
+interface SearchTextOptions extends SearchOptions$1 {
+    caseSensitive?: boolean;
+    regex?: boolean;
+}
+interface SearchResult$1 {
+    from: number;
+    to: number;
+    text: string;
+    index: number;
+}
+interface SurfaceSearchResult extends SearchResult$1 {
+    excerpt: string;
+}
+interface SecondaryStorySearchResult extends SurfaceSearchResult {
+    storyTarget: EditorStoryTarget;
+}
+declare function findSearchMatches(text: string, query: string, options?: SearchTextOptions): SearchResult$1[];
+declare function createSearchExcerpt(text: string, from: number, to: number, radius?: number): string;
+declare function searchSecondaryStories(stories: readonly SecondaryStorySurface[], query: string, options?: SearchTextOptions): SecondaryStorySearchResult[];
+
+/**
+ * ProseMirror search/highlight plugin for the editor surface.
+ *
+ * Provides in-document search with optional case sensitivity and regex support.
+ * Matched ranges are shown as inline decorations with a configurable highlight color.
+ *
+ * Usage:
+ *   1. Include createSearchPlugin() in the editor plugin list.
+ *   2. Call performSearch(state, query, options) to compute matches.
+ *   3. Dispatch the results into the plugin state via searchPluginKey meta.
+ *   4. Call clearSearch(state, dispatch) to remove all highlights.
+ */
+
+interface SearchResult {
+    from: number;
+    to: number;
+    text: string;
+    index: number;
+}
+interface SearchOptions extends SearchOptions$1, SearchTextOptions {
+    regex?: boolean;
+    highlightColor?: string;
+}
+declare const DEFAULT_SEARCH_HIGHLIGHT_COLOR = "#fde68a";
+interface SearchPluginState {
+    results: SearchResult[];
+    highlightColor: string | null;
+}
+declare const searchPluginKey: PluginKey<SearchPluginState>;
+declare function createSearchPlugin(): Plugin<SearchPluginState>;
+/**
+ * Scan all text nodes in the document for matches of `query`.
+ * Returns an array of match ranges; does not dispatch anything.
+ * To apply highlights, set the results on the plugin via:
+ *   view.dispatch(view.state.tr.setMeta(searchPluginKey, { results, highlightColor }))
+ */
+declare function performSearch(state: EditorState, query: string, options?: SearchOptions): SearchResult[];
+/**
+ * ProseMirror command that clears all search highlights from the plugin state.
+ */
+declare function clearSearch(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+
+export { DEFAULT_SEARCH_HIGHLIGHT_COLOR, type SearchOptions, type SearchResult, type SecondaryStorySearchResult, clearSearch, createSearchExcerpt, createSearchPlugin, findSearchMatches, performSearch, searchPluginKey, searchSecondaryStories };

package/dist/ui-tailwind/editor-surface/search-plugin.js

@@ -0,0 +1,23 @@
+import {
+  DEFAULT_SEARCH_HIGHLIGHT_COLOR,
+  clearSearch,
+  createSearchPlugin,
+  performSearch,
+  searchPluginKey
+} from "../../chunk-4D5EWJ3P.js";
+import {
+  createSearchExcerpt,
+  findSearchMatches,
+  searchSecondaryStories
+} from "../../chunk-CN3XMECL.js";
+export {
+  DEFAULT_SEARCH_HIGHLIGHT_COLOR,
+  clearSearch,
+  createSearchExcerpt,
+  createSearchPlugin,
+  findSearchMatches,
+  performSearch,
+  searchPluginKey,
+  searchSecondaryStories
+};
+//# sourceMappingURL=search-plugin.js.map

package/dist/ui-tailwind/editor-surface/search-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}