@embedpdf/plugin-search 3.0.0-next.1 → 3.0.0-next.11

package/dist/contract-4PZsI7Ty.cjs

@@ -0,0 +1,13 @@
+let _embedpdf_core = require("@embedpdf/core");
+require("@embedpdf/engine-core/runtime");
+//#region src/types.ts
+const SearchToken = (0, _embedpdf_core.createCapabilityToken)("search");
+//#endregion
+Object.defineProperty(exports, "SearchToken", {
+	enumerable: true,
+	get: function() {
+		return SearchToken;
+	}
+});
+
+//# sourceMappingURL=contract-4PZsI7Ty.cjs.map

package/dist/contract-4PZsI7Ty.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-4PZsI7Ty.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import { createCapabilityToken, type PageObjectNumber } from '@embedpdf/core';\nimport type { Rect, TextQuad } from '@embedpdf/core-geometry';\nimport type { RevealAnchor, ScrollBehaviorKind } from '@embedpdf/plugin-stage/contract';\nimport type { SearchMode, SearchQuery, SearchSnippet } from '@embedpdf/engine-core/runtime';\n\n/**\n * One match, viewer-shaped: the engine's PDF-space line rects converted to\n * CONTENT space (y-down — the same space selection rects live in), plus the\n * page's display index so navigation can `reveal()` without a lookup.\n * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can\n * later seed a selection or a highlight annotation without re-searching.\n */\n/**\n * One merged visual line of a match, in content space — the structural twin\n * of selection's `SelectionSegment` and the engine's `PdfTextSegment`.\n * `quad` is the geometric authority (corner-named, frame-geometric); `rect`\n * its AABB; `advance` the reading direction along the baseline.\n */\nexport interface TextSegment {\n  quad: TextQuad;\n  rect: Rect;\n  advance: 1 | -1;\n}\n\nexport interface SearchHit {\n  pon: PageObjectNumber;\n  pageIndex: number;\n  charStart: number;\n  charCount: number;\n  /** Canonical visual-line segments (content space) — the drawing input. */\n  segments: TextSegment[];\n  /** Union envelope of the segments — the scroll/reveal target. Absent when\n   *  a match carries no drawable geometry (degenerate glyphs only). */\n  bounds?: Rect;\n  snippet?: SearchSnippet;\n}\n\n/**\n * `searching` means the slice loop is still walking pages — results are\n * usable the moment they appear (matches stream in viewport-first order).\n */\nexport type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';\n\n/**\n * Execution options for the session `search()` — HOW the scan runs, never\n * part of what the query MEANS (which is why they're not on `SearchQuery`\n * and are never stored or restored into a search box).\n */\nexport interface SearchExecOptions {\n  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */\n  startPage?: PageObjectNumber;\n}\n\n/** Options for the session-free `findAll()` service. */\nexport interface SearchFindAllOptions {\n  /** Abort the scan; the returned promise rejects with `signal.reason`. */\n  signal?: AbortSignal;\n  /**\n   * Pin the slice mode. Default: `'full'` with automatic `'rects'`\n   * fallback when snippets are denied — pass `'rects'` when you only need\n   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.\n   */\n  mode?: SearchMode;\n}\n\nexport interface SearchState {\n  /**\n   * The query in flight/completed, null when idle/cleared — THE stored\n   * form of the search intent, the same flat `SearchQuery` the engine\n   * matches on, the wire caches by, and a search box renders. Survives\n   * any search UI unmounting (results are document-scoped; so is this).\n   */\n  query: SearchQuery | null;\n  status: SearchStatus;\n  hits: SearchHit[];\n  /** pon → indices into `hits` — the per-page layer's read model. */\n  hitsByPage: Record<number, number[]>;\n  /** Index into `hits`, -1 = none. */\n  activeIndex: number;\n  progress: { scanned: number; total: number };\n  error: string | null;\n}\n\nexport type SearchAction =\n  | { type: 'START'; query: SearchQuery }\n  | { type: 'APPEND'; hits: SearchHit[]; scanned: number; total: number }\n  | { type: 'COMPLETE' }\n  | { type: 'ERROR'; message: string }\n  | { type: 'SET_ACTIVE'; index: number }\n  | { type: 'CLEAR' };\n\n/**\n * How hit navigation arrives (forwarded to the Stage's positioned reveal).\n * The default is the browser find-bar feel: the hit lands at the top-middle\n * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the\n * hit is off-screen, zoom never changes, smooth tween.\n */\nexport interface SearchRevealOptions {\n  anchor?: RevealAnchor;\n  behavior?: ScrollBehaviorKind;\n}\n\nexport interface SearchPluginConfig {\n  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */\n  reveal?: SearchRevealOptions;\n}\n\n/**\n * The search plugin is a find SERVICE plus one user-visible search SESSION\n * per document. `findAll` is the service; `search` is the session; the\n * sidebar, the highlights layer, and next/prev render the session.\n */\nexport interface SearchCapability {\n  /**\n   * The twin (permissions.md): would a search succeed now for this session?\n   * No `mode` (or `'rects'`) asks about finding at all — `doc.text.search`\n   * — which is what `search()` needs (the session degrades `'full'` to\n   * `'rects'` by itself when snippets are denied). `canSearch('full')` also\n   * requires `doc.text.copy` (a snippet reproduces document text) — ask it\n   * before advertising snippet UI or pinning `mode: 'full'` in `findAll`.\n   */\n  canSearch(mode?: SearchMode): boolean;\n\n  // ── the session: THE user-visible find, one per document ────────────────\n  /**\n   * Start a new search (supersedes and aborts any running one). Results\n   * stream into state slice by slice; the first hit becomes active but the\n   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty\n   * `query.text` is \"stop searching\" — identical to `clear()`.\n   */\n  search(query: SearchQuery, exec?: SearchExecOptions): void;\n  /** Re-run the current query from scratch (used after document mutations). */\n  rerun(): void;\n  clear(): void;\n\n  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */\n  next(): SearchHit | null;\n  prev(): SearchHit | null;\n  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */\n  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;\n\n  /** The session's query — what a search box renders. Null when idle. */\n  query(): SearchQuery | null;\n  status(): SearchStatus;\n  hits(): SearchHit[];\n  hitCount(): number;\n  activeIndex(): number;\n  activeHit(): SearchHit | null;\n  /** Hits on one page — the layer's input. Element identity is stable. */\n  hitsForPage(pon: PageObjectNumber): SearchHit[];\n  progress(): { scanned: number; total: number };\n  errorMessage(): string | null;\n\n  // ── the mechanism: session-free find service ─────────────────────────────\n  /**\n   * Run a query to completion and return every hit. Touches NO state — no\n   * sidebar, no highlights, no camera, no activeIndex; the user's visible\n   * search is never superseded. The primitive other features build on\n   * (redact-by-term, link detection, occurrence badges). Scans in natural\n   * page order; concurrent calls are independent.\n   */\n  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;\n}\n\nexport const SearchToken = createCapabilityToken<SearchCapability>('search');\n"],"mappings":";;;AAoKA,MAAa,eAAA,GAAA,eAAA,sBAAA,CAAsD,QAAQ"}

package/dist/contract-CSb66POC.d.cts

@@ -0,0 +1,170 @@
+import { PageObjectNumber } from "@embedpdf/core";
+import { Rect, TextQuad } from "@embedpdf/core-geometry";
+import { RevealAnchor, ScrollBehaviorKind } from "@embedpdf/plugin-stage/contract";
+import { SearchMode, SearchQuery, SearchQuery as SearchQuery$1, SearchQueryIssue, SearchQueryValidation, SearchRegexValidation, SearchSnippet, SearchSnippet as SearchSnippet$1, validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
+//#region src/types.d.ts
+/**
+ * One match, viewer-shaped: the engine's PDF-space line rects converted to
+ * CONTENT space (y-down — the same space selection rects live in), plus the
+ * page's display index so navigation can `reveal()` without a lookup.
+ * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can
+ * later seed a selection or a highlight annotation without re-searching.
+ */
+/**
+ * One merged visual line of a match, in content space — the structural twin
+ * of selection's `SelectionSegment` and the engine's `PdfTextSegment`.
+ * `quad` is the geometric authority (corner-named, frame-geometric); `rect`
+ * its AABB; `advance` the reading direction along the baseline.
+ */
+interface TextSegment {
+  quad: TextQuad;
+  rect: Rect;
+  advance: 1 | -1;
+}
+interface SearchHit {
+  pon: PageObjectNumber;
+  pageIndex: number;
+  charStart: number;
+  charCount: number;
+  /** Canonical visual-line segments (content space) — the drawing input. */
+  segments: TextSegment[];
+  /** Union envelope of the segments — the scroll/reveal target. Absent when
+   *  a match carries no drawable geometry (degenerate glyphs only). */
+  bounds?: Rect;
+  snippet?: SearchSnippet;
+}
+/**
+ * `searching` means the slice loop is still walking pages — results are
+ * usable the moment they appear (matches stream in viewport-first order).
+ */
+type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';
+/**
+ * Execution options for the session `search()` — HOW the scan runs, never
+ * part of what the query MEANS (which is why they're not on `SearchQuery`
+ * and are never stored or restored into a search box).
+ */
+interface SearchExecOptions {
+  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */
+  startPage?: PageObjectNumber;
+}
+/** Options for the session-free `findAll()` service. */
+interface SearchFindAllOptions {
+  /** Abort the scan; the returned promise rejects with `signal.reason`. */
+  signal?: AbortSignal;
+  /**
+   * Pin the slice mode. Default: `'full'` with automatic `'rects'`
+   * fallback when snippets are denied — pass `'rects'` when you only need
+   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.
+   */
+  mode?: SearchMode;
+}
+interface SearchState {
+  /**
+   * The query in flight/completed, null when idle/cleared — THE stored
+   * form of the search intent, the same flat `SearchQuery` the engine
+   * matches on, the wire caches by, and a search box renders. Survives
+   * any search UI unmounting (results are document-scoped; so is this).
+   */
+  query: SearchQuery | null;
+  status: SearchStatus;
+  hits: SearchHit[];
+  /** pon → indices into `hits` — the per-page layer's read model. */
+  hitsByPage: Record<number, number[]>;
+  /** Index into `hits`, -1 = none. */
+  activeIndex: number;
+  progress: {
+    scanned: number;
+    total: number;
+  };
+  error: string | null;
+}
+type SearchAction = {
+  type: 'START';
+  query: SearchQuery;
+} | {
+  type: 'APPEND';
+  hits: SearchHit[];
+  scanned: number;
+  total: number;
+} | {
+  type: 'COMPLETE';
+} | {
+  type: 'ERROR';
+  message: string;
+} | {
+  type: 'SET_ACTIVE';
+  index: number;
+} | {
+  type: 'CLEAR';
+};
+/**
+ * How hit navigation arrives (forwarded to the Stage's positioned reveal).
+ * The default is the browser find-bar feel: the hit lands at the top-middle
+ * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the
+ * hit is off-screen, zoom never changes, smooth tween.
+ */
+interface SearchRevealOptions {
+  anchor?: RevealAnchor;
+  behavior?: ScrollBehaviorKind;
+}
+interface SearchPluginConfig {
+  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */
+  reveal?: SearchRevealOptions;
+}
+/**
+ * The search plugin is a find SERVICE plus one user-visible search SESSION
+ * per document. `findAll` is the service; `search` is the session; the
+ * sidebar, the highlights layer, and next/prev render the session.
+ */
+interface SearchCapability {
+  /**
+   * The twin (permissions.md): would a search succeed now for this session?
+   * No `mode` (or `'rects'`) asks about finding at all — `doc.text.search`
+   * — which is what `search()` needs (the session degrades `'full'` to
+   * `'rects'` by itself when snippets are denied). `canSearch('full')` also
+   * requires `doc.text.copy` (a snippet reproduces document text) — ask it
+   * before advertising snippet UI or pinning `mode: 'full'` in `findAll`.
+   */
+  canSearch(mode?: SearchMode): boolean;
+  /**
+   * Start a new search (supersedes and aborts any running one). Results
+   * stream into state slice by slice; the first hit becomes active but the
+   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty
+   * `query.text` is "stop searching" — identical to `clear()`.
+   */
+  search(query: SearchQuery, exec?: SearchExecOptions): void;
+  /** Re-run the current query from scratch (used after document mutations). */
+  rerun(): void;
+  clear(): void;
+  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */
+  next(): SearchHit | null;
+  prev(): SearchHit | null;
+  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */
+  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;
+  /** The session's query — what a search box renders. Null when idle. */
+  query(): SearchQuery | null;
+  status(): SearchStatus;
+  hits(): SearchHit[];
+  hitCount(): number;
+  activeIndex(): number;
+  activeHit(): SearchHit | null;
+  /** Hits on one page — the layer's input. Element identity is stable. */
+  hitsForPage(pon: PageObjectNumber): SearchHit[];
+  progress(): {
+    scanned: number;
+    total: number;
+  };
+  errorMessage(): string | null;
+  /**
+   * Run a query to completion and return every hit. Touches NO state — no
+   * sidebar, no highlights, no camera, no activeIndex; the user's visible
+   * search is never superseded. The primitive other features build on
+   * (redact-by-term, link detection, occurrence badges). Scans in natural
+   * page order; concurrent calls are independent.
+   */
+  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;
+}
+declare const SearchToken: import("@embedpdf/core").CapabilityToken<SearchCapability>;
+//#endregion
+export { SearchToken as _, SearchSnippet$1 as a, SearchAction as c, SearchFindAllOptions as d, SearchHit as f, SearchStatus as g, SearchState as h, SearchRegexValidation as i, SearchCapability as l, SearchRevealOptions as m, SearchQueryIssue as n, validateSearchQuery as o, SearchPluginConfig as p, SearchQueryValidation as r, validateSearchRegex as s, SearchQuery$1 as t, SearchExecOptions as u };
+//# sourceMappingURL=contract-CSb66POC.d.cts.map

package/dist/contract-Cj4xgdMj.d.ts

@@ -0,0 +1,170 @@
+import { PageObjectNumber } from "@embedpdf/core";
+import { RevealAnchor, ScrollBehaviorKind } from "@embedpdf/plugin-stage/contract";
+import { Rect, TextQuad } from "@embedpdf/core-geometry";
+import { SearchMode, SearchQuery, SearchQuery as SearchQuery$1, SearchQueryIssue, SearchQueryValidation, SearchRegexValidation, SearchSnippet, SearchSnippet as SearchSnippet$1, validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
+//#region src/types.d.ts
+/**
+ * One match, viewer-shaped: the engine's PDF-space line rects converted to
+ * CONTENT space (y-down — the same space selection rects live in), plus the
+ * page's display index so navigation can `reveal()` without a lookup.
+ * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can
+ * later seed a selection or a highlight annotation without re-searching.
+ */
+/**
+ * One merged visual line of a match, in content space — the structural twin
+ * of selection's `SelectionSegment` and the engine's `PdfTextSegment`.
+ * `quad` is the geometric authority (corner-named, frame-geometric); `rect`
+ * its AABB; `advance` the reading direction along the baseline.
+ */
+interface TextSegment {
+  quad: TextQuad;
+  rect: Rect;
+  advance: 1 | -1;
+}
+interface SearchHit {
+  pon: PageObjectNumber;
+  pageIndex: number;
+  charStart: number;
+  charCount: number;
+  /** Canonical visual-line segments (content space) — the drawing input. */
+  segments: TextSegment[];
+  /** Union envelope of the segments — the scroll/reveal target. Absent when
+   *  a match carries no drawable geometry (degenerate glyphs only). */
+  bounds?: Rect;
+  snippet?: SearchSnippet;
+}
+/**
+ * `searching` means the slice loop is still walking pages — results are
+ * usable the moment they appear (matches stream in viewport-first order).
+ */
+type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';
+/**
+ * Execution options for the session `search()` — HOW the scan runs, never
+ * part of what the query MEANS (which is why they're not on `SearchQuery`
+ * and are never stored or restored into a search box).
+ */
+interface SearchExecOptions {
+  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */
+  startPage?: PageObjectNumber;
+}
+/** Options for the session-free `findAll()` service. */
+interface SearchFindAllOptions {
+  /** Abort the scan; the returned promise rejects with `signal.reason`. */
+  signal?: AbortSignal;
+  /**
+   * Pin the slice mode. Default: `'full'` with automatic `'rects'`
+   * fallback when snippets are denied — pass `'rects'` when you only need
+   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.
+   */
+  mode?: SearchMode;
+}
+interface SearchState {
+  /**
+   * The query in flight/completed, null when idle/cleared — THE stored
+   * form of the search intent, the same flat `SearchQuery` the engine
+   * matches on, the wire caches by, and a search box renders. Survives
+   * any search UI unmounting (results are document-scoped; so is this).
+   */
+  query: SearchQuery | null;
+  status: SearchStatus;
+  hits: SearchHit[];
+  /** pon → indices into `hits` — the per-page layer's read model. */
+  hitsByPage: Record<number, number[]>;
+  /** Index into `hits`, -1 = none. */
+  activeIndex: number;
+  progress: {
+    scanned: number;
+    total: number;
+  };
+  error: string | null;
+}
+type SearchAction = {
+  type: 'START';
+  query: SearchQuery;
+} | {
+  type: 'APPEND';
+  hits: SearchHit[];
+  scanned: number;
+  total: number;
+} | {
+  type: 'COMPLETE';
+} | {
+  type: 'ERROR';
+  message: string;
+} | {
+  type: 'SET_ACTIVE';
+  index: number;
+} | {
+  type: 'CLEAR';
+};
+/**
+ * How hit navigation arrives (forwarded to the Stage's positioned reveal).
+ * The default is the browser find-bar feel: the hit lands at the top-middle
+ * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the
+ * hit is off-screen, zoom never changes, smooth tween.
+ */
+interface SearchRevealOptions {
+  anchor?: RevealAnchor;
+  behavior?: ScrollBehaviorKind;
+}
+interface SearchPluginConfig {
+  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */
+  reveal?: SearchRevealOptions;
+}
+/**
+ * The search plugin is a find SERVICE plus one user-visible search SESSION
+ * per document. `findAll` is the service; `search` is the session; the
+ * sidebar, the highlights layer, and next/prev render the session.
+ */
+interface SearchCapability {
+  /**
+   * The twin (permissions.md): would a search succeed now for this session?
+   * No `mode` (or `'rects'`) asks about finding at all — `doc.text.search`
+   * — which is what `search()` needs (the session degrades `'full'` to
+   * `'rects'` by itself when snippets are denied). `canSearch('full')` also
+   * requires `doc.text.copy` (a snippet reproduces document text) — ask it
+   * before advertising snippet UI or pinning `mode: 'full'` in `findAll`.
+   */
+  canSearch(mode?: SearchMode): boolean;
+  /**
+   * Start a new search (supersedes and aborts any running one). Results
+   * stream into state slice by slice; the first hit becomes active but the
+   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty
+   * `query.text` is "stop searching" — identical to `clear()`.
+   */
+  search(query: SearchQuery, exec?: SearchExecOptions): void;
+  /** Re-run the current query from scratch (used after document mutations). */
+  rerun(): void;
+  clear(): void;
+  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */
+  next(): SearchHit | null;
+  prev(): SearchHit | null;
+  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */
+  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;
+  /** The session's query — what a search box renders. Null when idle. */
+  query(): SearchQuery | null;
+  status(): SearchStatus;
+  hits(): SearchHit[];
+  hitCount(): number;
+  activeIndex(): number;
+  activeHit(): SearchHit | null;
+  /** Hits on one page — the layer's input. Element identity is stable. */
+  hitsForPage(pon: PageObjectNumber): SearchHit[];
+  progress(): {
+    scanned: number;
+    total: number;
+  };
+  errorMessage(): string | null;
+  /**
+   * Run a query to completion and return every hit. Touches NO state — no
+   * sidebar, no highlights, no camera, no activeIndex; the user's visible
+   * search is never superseded. The primitive other features build on
+   * (redact-by-term, link detection, occurrence badges). Scans in natural
+   * page order; concurrent calls are independent.
+   */
+  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;
+}
+declare const SearchToken: import("@embedpdf/core").CapabilityToken<SearchCapability>;
+//#endregion
+export { SearchToken as _, SearchSnippet$1 as a, SearchAction as c, SearchFindAllOptions as d, SearchHit as f, SearchStatus as g, SearchState as h, SearchRegexValidation as i, SearchCapability as l, SearchRevealOptions as m, SearchQueryIssue as n, validateSearchQuery as o, SearchPluginConfig as p, SearchQueryValidation as r, validateSearchRegex as s, SearchQuery$1 as t, SearchExecOptions as u };
+//# sourceMappingURL=contract-Cj4xgdMj.d.ts.map

package/dist/contract-YzH14CUn.js

@@ -0,0 +1,8 @@
+import { createCapabilityToken } from "@embedpdf/core";
+import { validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
+//#region src/types.ts
+const SearchToken = createCapabilityToken("search");
+//#endregion
+export { validateSearchRegex as n, SearchToken as r, validateSearchQuery as t };
+
+//# sourceMappingURL=contract-YzH14CUn.js.map

package/dist/contract-YzH14CUn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-YzH14CUn.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import { createCapabilityToken, type PageObjectNumber } from '@embedpdf/core';\nimport type { Rect, TextQuad } from '@embedpdf/core-geometry';\nimport type { RevealAnchor, ScrollBehaviorKind } from '@embedpdf/plugin-stage/contract';\nimport type { SearchMode, SearchQuery, SearchSnippet } from '@embedpdf/engine-core/runtime';\n\n/**\n * One match, viewer-shaped: the engine's PDF-space line rects converted to\n * CONTENT space (y-down — the same space selection rects live in), plus the\n * page's display index so navigation can `reveal()` without a lookup.\n * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can\n * later seed a selection or a highlight annotation without re-searching.\n */\n/**\n * One merged visual line of a match, in content space — the structural twin\n * of selection's `SelectionSegment` and the engine's `PdfTextSegment`.\n * `quad` is the geometric authority (corner-named, frame-geometric); `rect`\n * its AABB; `advance` the reading direction along the baseline.\n */\nexport interface TextSegment {\n  quad: TextQuad;\n  rect: Rect;\n  advance: 1 | -1;\n}\n\nexport interface SearchHit {\n  pon: PageObjectNumber;\n  pageIndex: number;\n  charStart: number;\n  charCount: number;\n  /** Canonical visual-line segments (content space) — the drawing input. */\n  segments: TextSegment[];\n  /** Union envelope of the segments — the scroll/reveal target. Absent when\n   *  a match carries no drawable geometry (degenerate glyphs only). */\n  bounds?: Rect;\n  snippet?: SearchSnippet;\n}\n\n/**\n * `searching` means the slice loop is still walking pages — results are\n * usable the moment they appear (matches stream in viewport-first order).\n */\nexport type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';\n\n/**\n * Execution options for the session `search()` — HOW the scan runs, never\n * part of what the query MEANS (which is why they're not on `SearchQuery`\n * and are never stored or restored into a search box).\n */\nexport interface SearchExecOptions {\n  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */\n  startPage?: PageObjectNumber;\n}\n\n/** Options for the session-free `findAll()` service. */\nexport interface SearchFindAllOptions {\n  /** Abort the scan; the returned promise rejects with `signal.reason`. */\n  signal?: AbortSignal;\n  /**\n   * Pin the slice mode. Default: `'full'` with automatic `'rects'`\n   * fallback when snippets are denied — pass `'rects'` when you only need\n   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.\n   */\n  mode?: SearchMode;\n}\n\nexport interface SearchState {\n  /**\n   * The query in flight/completed, null when idle/cleared — THE stored\n   * form of the search intent, the same flat `SearchQuery` the engine\n   * matches on, the wire caches by, and a search box renders. Survives\n   * any search UI unmounting (results are document-scoped; so is this).\n   */\n  query: SearchQuery | null;\n  status: SearchStatus;\n  hits: SearchHit[];\n  /** pon → indices into `hits` — the per-page layer's read model. */\n  hitsByPage: Record<number, number[]>;\n  /** Index into `hits`, -1 = none. */\n  activeIndex: number;\n  progress: { scanned: number; total: number };\n  error: string | null;\n}\n\nexport type SearchAction =\n  | { type: 'START'; query: SearchQuery }\n  | { type: 'APPEND'; hits: SearchHit[]; scanned: number; total: number }\n  | { type: 'COMPLETE' }\n  | { type: 'ERROR'; message: string }\n  | { type: 'SET_ACTIVE'; index: number }\n  | { type: 'CLEAR' };\n\n/**\n * How hit navigation arrives (forwarded to the Stage's positioned reveal).\n * The default is the browser find-bar feel: the hit lands at the top-middle\n * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the\n * hit is off-screen, zoom never changes, smooth tween.\n */\nexport interface SearchRevealOptions {\n  anchor?: RevealAnchor;\n  behavior?: ScrollBehaviorKind;\n}\n\nexport interface SearchPluginConfig {\n  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */\n  reveal?: SearchRevealOptions;\n}\n\n/**\n * The search plugin is a find SERVICE plus one user-visible search SESSION\n * per document. `findAll` is the service; `search` is the session; the\n * sidebar, the highlights layer, and next/prev render the session.\n */\nexport interface SearchCapability {\n  /**\n   * The twin (permissions.md): would a search succeed now for this session?\n   * No `mode` (or `'rects'`) asks about finding at all — `doc.text.search`\n   * — which is what `search()` needs (the session degrades `'full'` to\n   * `'rects'` by itself when snippets are denied). `canSearch('full')` also\n   * requires `doc.text.copy` (a snippet reproduces document text) — ask it\n   * before advertising snippet UI or pinning `mode: 'full'` in `findAll`.\n   */\n  canSearch(mode?: SearchMode): boolean;\n\n  // ── the session: THE user-visible find, one per document ────────────────\n  /**\n   * Start a new search (supersedes and aborts any running one). Results\n   * stream into state slice by slice; the first hit becomes active but the\n   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty\n   * `query.text` is \"stop searching\" — identical to `clear()`.\n   */\n  search(query: SearchQuery, exec?: SearchExecOptions): void;\n  /** Re-run the current query from scratch (used after document mutations). */\n  rerun(): void;\n  clear(): void;\n\n  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */\n  next(): SearchHit | null;\n  prev(): SearchHit | null;\n  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */\n  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;\n\n  /** The session's query — what a search box renders. Null when idle. */\n  query(): SearchQuery | null;\n  status(): SearchStatus;\n  hits(): SearchHit[];\n  hitCount(): number;\n  activeIndex(): number;\n  activeHit(): SearchHit | null;\n  /** Hits on one page — the layer's input. Element identity is stable. */\n  hitsForPage(pon: PageObjectNumber): SearchHit[];\n  progress(): { scanned: number; total: number };\n  errorMessage(): string | null;\n\n  // ── the mechanism: session-free find service ─────────────────────────────\n  /**\n   * Run a query to completion and return every hit. Touches NO state — no\n   * sidebar, no highlights, no camera, no activeIndex; the user's visible\n   * search is never superseded. The primitive other features build on\n   * (redact-by-term, link detection, occurrence badges). Scans in natural\n   * page order; concurrent calls are independent.\n   */\n  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;\n}\n\nexport const SearchToken = createCapabilityToken<SearchCapability>('search');\n"],"mappings":";;;AAoKA,MAAa,cAAc,sBAAwC,QAAQ"}

package/dist/contract.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contract = require("./contract-4PZsI7Ty.cjs");
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+exports.SearchToken = require_contract.SearchToken;
+Object.defineProperty(exports, "validateSearchQuery", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.validateSearchQuery;
+	}
+});
+Object.defineProperty(exports, "validateSearchRegex", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.validateSearchRegex;
+	}
+});

package/dist/contract.d.cts

@@ -0,0 +1,2 @@
+import { _ as SearchToken, a as SearchSnippet, d as SearchFindAllOptions, f as SearchHit, g as SearchStatus, h as SearchState, i as SearchRegexValidation, l as SearchCapability, m as SearchRevealOptions, n as SearchQueryIssue, o as validateSearchQuery, p as SearchPluginConfig, r as SearchQueryValidation, s as validateSearchRegex, t as SearchQuery, u as SearchExecOptions } from "./contract-CSb66POC.cjs";
+export { type SearchCapability, type SearchExecOptions, type SearchFindAllOptions, type SearchHit, type SearchPluginConfig, type SearchQuery, type SearchQueryIssue, type SearchQueryValidation, type SearchRegexValidation, type SearchRevealOptions, type SearchSnippet, type SearchState, type SearchStatus, SearchToken, validateSearchQuery, validateSearchRegex };

package/dist/contract.d.ts

@@ -0,0 +1,2 @@
+import { _ as SearchToken, a as SearchSnippet, d as SearchFindAllOptions, f as SearchHit, g as SearchStatus, h as SearchState, i as SearchRegexValidation, l as SearchCapability, m as SearchRevealOptions, n as SearchQueryIssue, o as validateSearchQuery, p as SearchPluginConfig, r as SearchQueryValidation, s as validateSearchRegex, t as SearchQuery, u as SearchExecOptions } from "./contract-Cj4xgdMj.js";
+export { type SearchCapability, type SearchExecOptions, type SearchFindAllOptions, type SearchHit, type SearchPluginConfig, type SearchQuery, type SearchQueryIssue, type SearchQueryValidation, type SearchRegexValidation, type SearchRevealOptions, type SearchSnippet, type SearchState, type SearchStatus, SearchToken, validateSearchQuery, validateSearchRegex };

package/dist/contract.js

@@ -0,0 +1,2 @@
+import { n as validateSearchRegex, r as SearchToken, t as validateSearchQuery } from "./contract-YzH14CUn.js";
+export { SearchToken, validateSearchQuery, validateSearchRegex };

package/dist/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contract = require("./contract-4PZsI7Ty.cjs");
 let _embedpdf_core = require("@embedpdf/core");
-let _embedpdf_plugin_stage = require("@embedpdf/plugin-stage");
+let _embedpdf_plugin_stage_contract = require("@embedpdf/plugin-stage/contract");
 let _embedpdf_core_geometry = require("@embedpdf/core-geometry");
 let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
 //#region src/capability.ts
@@ -30,12 +31,6 @@ const isPermissionDenied = (err) => err instanceof Error && err.name === "Permis
 function createSearchCapability(ctx, config = {}) {
 	let generation = 0;
 	let inflight = null;
-	const toContent = (m, b) => (0, _embedpdf_core_geometry.applyRect)(m, {
-		x: b.left,
-		y: b.bottom,
-		width: b.right - b.left,
-		height: b.top - b.bottom
-	});
 	function hitsFromSlice(slice) {
 		const converters = /* @__PURE__ */ new Map();
 		const converterFor = (pon) => {
@@ -49,9 +44,15 @@ function createSearchCapability(ctx, config = {}) {
 					rotation: layout.rotation,
 					userUnit: layout.userUnit
 				}, 1);
+				const toPoint = (pt) => (0, _embedpdf_core_geometry.applyPoint)(pdfToContent, pt);
 				conv = {
 					pageIndex: layout.index,
-					toRect: (b) => toContent(pdfToContent, b)
+					toQuad: (q) => ({
+						upperStart: toPoint(q.p1),
+						upperEnd: toPoint(q.p2),
+						lowerStart: toPoint(q.p3),
+						lowerEnd: toPoint(q.p4)
+					})
 				};
 			}
 			converters.set(pon, conv);
@@ -61,12 +62,21 @@ function createSearchCapability(ctx, config = {}) {
 		for (const match of slice.matches) {
 			const conv = converterFor(match.pageObjectNumber);
 			if (!conv) continue;
+			const segments = match.segments.map((segment) => {
+				const quad = conv.toQuad(segment.quad);
+				return {
+					quad,
+					rect: (0, _embedpdf_core_geometry.textQuadBounds)(quad),
+					advance: segment.advance
+				};
+			});
 			hits.push({
 				pon: match.pageObjectNumber,
 				pageIndex: conv.pageIndex,
 				charStart: match.charStart,
 				charCount: match.charCount,
-				rects: match.rects.map(conv.toRect),
+				segments,
+				...segments.length ? { bounds: (0, _embedpdf_core_geometry.boundsOfRects)(segments.map((s) => s.rect)) ?? void 0 } : {},
 				...match.snippet ? { snippet: match.snippet } : {}
 			});
 		}
@@ -132,7 +142,7 @@ function createSearchCapability(ctx, config = {}) {
 			return;
 		}
 		if (startPage === void 0) {
-			const stage = ctx.tryGet(_embedpdf_plugin_stage.StageToken);
+			const stage = ctx.tryGet(_embedpdf_plugin_stage_contract.StageToken);
 			if (stage) startPage = ctx.document()?.pages[stage.currentPage()]?.pageObjectNumber;
 		}
 		try {
@@ -174,8 +184,8 @@ function createSearchCapability(ctx, config = {}) {
 			...config.reveal,
 			...reveal
 		};
-		ctx.tryGet(_embedpdf_plugin_stage.StageToken)?.reveal(hit.pageIndex, {
-			rect: (0, _embedpdf_core_geometry.boundsOfRects)(hit.rects) ?? void 0,
+		ctx.tryGet(_embedpdf_plugin_stage_contract.StageToken)?.reveal(hit.pageIndex, {
+			rect: hit.bounds,
 			anchor: arrival.anchor,
 			behavior: arrival.behavior
 		});
@@ -188,6 +198,11 @@ function createSearchCapability(ctx, config = {}) {
 		ctx.dispatch({ type: "CLEAR" });
 	};
 	return {
+		canSearch: (mode) => {
+			const sec = ctx.doc?.security;
+			if (!sec) return false;
+			return sec.allows("doc.text.search") && (mode !== "full" || sec.allows("doc.text.copy"));
+		},
 		search: (query, exec) => query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),
 		rerun: () => {
 			const { query, status } = ctx.getState();
@@ -240,9 +255,6 @@ function createSearchCapability(ctx, config = {}) {
 	};
 }
 //#endregion
-//#region src/types.ts
-const SearchToken = (0, _embedpdf_core.createCapabilityToken)("search");
-//#endregion
 //#region src/effects.ts
 const RERUN_DELAY_MS = 250;
 function registerSearchEffects(ctx) {
@@ -254,7 +266,7 @@ function registerSearchEffects(ctx) {
 		if (timer !== null) clearTimeout(timer);
 		timer = setTimeout(() => {
 			timer = null;
-			ctx.get(SearchToken).rerun();
+			ctx.get(require_contract.SearchToken).rerun();
 		}, RERUN_DELAY_MS);
 	});
 	ctx.cleanup(() => {
@@ -336,16 +348,16 @@ const searchReducer = (state, action) => {
 */
 const searchPlugin = (config) => (0, _embedpdf_core.definePlugin)({
 	id: "search",
-	token: SearchToken,
+	token: require_contract.SearchToken,
 	scope: "document",
-	optional: [_embedpdf_plugin_stage.StageToken],
+	optional: [_embedpdf_plugin_stage_contract.StageToken],
 	initialState: initialSearchState,
 	reduce: searchReducer,
 	capability: (ctx) => createSearchCapability(ctx, config),
 	effects: registerSearchEffects
 });
 //#endregion
-exports.SearchToken = SearchToken;
+exports.SearchToken = require_contract.SearchToken;
 exports.searchPlugin = searchPlugin;
 Object.defineProperty(exports, "validateSearchQuery", {
 	enumerable: true,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["EngineError","EngineErrorCode","StageToken","StageToken"],"sources":["../src/capability.ts","../src/types.ts","../src/effects.ts","../src/reducer.ts","../src/search.plugin.ts"],"sourcesContent":["import type { PageObjectNumber, PluginContext } from '@embedpdf/core';\nimport {\n  applyRect,\n  boundsOfRects,\n  pageGeometry,\n  type Rect,\n  type RectIn,\n} from '@embedpdf/core-geometry';\nimport { StageToken } from '@embedpdf/plugin-stage';\nimport { EngineError, EngineErrorCode } from '@embedpdf/engine-core/runtime';\nimport type {\n  PdfRect,\n  SearchMatch,\n  SearchMode,\n  SearchQuery,\n  SearchSlice,\n} from '@embedpdf/engine-core/runtime';\n\nimport type {\n  SearchAction,\n  SearchCapability,\n  SearchHit,\n  SearchPluginConfig,\n  SearchRevealOptions,\n  SearchState,\n} from './types';\n\nconst EMPTY: SearchHit[] = [];\n\n/** The browser find-bar feel: hit at the top-middle, no zoom change. */\nconst DEFAULT_REVEAL: SearchRevealOptions = { anchor: { y: 0.35 }, behavior: 'smooth' };\n\n/** Local engines reject a denied scope before the worker; cloud maps 403. */\nconst isPermissionDenied = (err: unknown): boolean =>\n  (err instanceof Error && err.name === 'PermissionDenied') ||\n  EngineError.is(err, EngineErrorCode.Forbidden);\n\n/**\n * The search capability: a client-driven cursor loop over the engine's\n * budgeted slices. One generation counter arbitrates: a new `search()` (or\n * `clear()`, or a document mutation via `rerun()`) supersedes the running\n * loop, which aborts its in-flight slice and stops dispatching.\n *\n * Rect conversion happens HERE, once per slice: the engine's PDF-space\n * line rects → content space through the same page geometry the selection\n * plugin uses, so search highlights and selection highlights are pixel-twins.\n *\n * Stage integration is optional and additive: with a Stage present the scan\n * starts at the current page (viewport-first — the hits the user is looking\n * at arrive in the first slice) and `next()`/`prev()`/`goTo()` reveal the\n * hit's page. Without one, navigation still works; the host scrolls.\n */\nexport function createSearchCapability(\n  ctx: PluginContext<SearchState, SearchAction>,\n  config: SearchPluginConfig = {},\n): SearchCapability {\n  let generation = 0;\n  let inflight: { abort(reason?: unknown): void } | null = null;\n\n  const toContent = (m: ReturnType<typeof pageGeometry>['pdfToContent'], b: PdfRect): Rect =>\n    applyRect(\n      m as never,\n      {\n        x: b.left,\n        y: b.bottom,\n        width: b.right - b.left,\n        height: b.top - b.bottom,\n      } as RectIn<'pdf'>,\n    ) as Rect;\n\n  interface PageConverter {\n    pageIndex: number;\n    toRect: (b: PdfRect) => Rect;\n  }\n\n  function hitsFromSlice(slice: SearchSlice): SearchHit[] {\n    // zoom = 1: content space is scale-free; the layer applies the page\n    // transform at render time (the selection idiom).\n    const converters = new Map<PageObjectNumber, PageConverter | null>();\n    const converterFor = (pon: PageObjectNumber): PageConverter | null => {\n      let conv = converters.get(pon);\n      if (conv !== undefined) return conv;\n      const layout = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon);\n      if (!layout) {\n        conv = null; // page vanished mid-search (delete); drop its hits\n      } else {\n        const { pdfToContent } = pageGeometry(\n          { crop: layout.boxes.crop, rotation: layout.rotation, userUnit: layout.userUnit },\n          1,\n        );\n        conv = { pageIndex: layout.index, toRect: (b) => toContent(pdfToContent, b) };\n      }\n      converters.set(pon, conv);\n      return conv;\n    };\n\n    const hits: SearchHit[] = [];\n    for (const match of slice.matches) {\n      const conv = converterFor(match.pageObjectNumber);\n      if (!conv) continue;\n      hits.push({\n        pon: match.pageObjectNumber,\n        pageIndex: conv.pageIndex,\n        charStart: match.charStart,\n        charCount: match.charCount,\n        rects: match.rects.map(conv.toRect),\n        ...(match.snippet ? { snippet: match.snippet } : {}),\n      });\n    }\n    return hits;\n  }\n\n  /** How a collect() consumer observes the loop — the session dispatches\n   *  into state, findAll accumulates locally. */\n  interface CollectSink {\n    /** Called before the first slice AND again on a stale-cursor restart —\n     *  reset any accumulation. */\n    onStart: () => void;\n    onSlice: (hits: SearchHit[], scanned: number, total: number) => void;\n    /** Superseded / aborted — the loop stops without completing. */\n    isCancelled: () => boolean;\n    setInflight: (pending: { abort(reason?: unknown): void } | null) => void;\n  }\n\n  /**\n   * THE MECHANISM — one cursor loop over the engine's budgeted slices,\n   * shared by the session (`search`) and the session-free service\n   * (`findAll`): permission fallback ('full' → 'rects' when snippets are\n   * denied, unless the caller pinned a mode), restart-once on a stale\n   * cursor, rect conversion per slice. Resolves true on exhaustion, false\n   * when cancelled; throws on error.\n   */\n  async function collect(\n    query: SearchQuery,\n    opts: { startPage?: PageObjectNumber; mode?: SearchMode },\n    sink: CollectSink,\n  ): Promise<boolean> {\n    const doc = ctx.doc;\n    if (!doc) return false;\n\n    sink.onStart();\n\n    let mode: SearchMode = opts.mode ?? 'full';\n    const modePinned = opts.mode !== undefined;\n    let cursor: string | undefined;\n    let restarted = false;\n    for (;;) {\n      let slice: SearchSlice;\n      try {\n        const request = {\n          query,\n          mode,\n          ...(cursor !== undefined\n            ? { cursor }\n            : opts.startPage !== undefined\n              ? { startPage: opts.startPage }\n              : {}),\n        };\n        const pending = doc.search.query(request);\n        sink.setInflight(pending);\n        slice = await pending;\n      } catch (err) {\n        if (sink.isCancelled()) return false; // superseded — the abort was ours\n        // Snippets denied (no doc.text.copy)? Degrade to rect-only matches\n        // instead of failing the whole search — find still works.\n        if (!modePinned && mode === 'full' && cursor === undefined && isPermissionDenied(err)) {\n          mode = 'rects';\n          continue;\n        }\n        // A stale cursor rejects with InvalidArg — the document changed\n        // under the loop, or the engine's session was recycled. Position\n        // is lost, the query isn't: restart once from scratch.\n        if (cursor !== undefined && !restarted && EngineError.is(err, EngineErrorCode.InvalidArg)) {\n          restarted = true;\n          cursor = undefined;\n          sink.onStart();\n          continue;\n        }\n        throw err;\n      }\n      if (sink.isCancelled()) return false;\n      sink.onSlice(hitsFromSlice(slice), slice.scannedPages, slice.totalPages);\n      if (slice.nextCursor === null) {\n        sink.setInflight(null);\n        return true;\n      }\n      cursor = slice.nextCursor;\n    }\n  }\n\n  /** THE SESSION — collect() with state as the sink, generation-guarded. */\n  async function runSession(query: SearchQuery, startPage?: PageObjectNumber): Promise<void> {\n    const gen = ++generation;\n    inflight?.abort('superseded');\n    inflight = null;\n\n    if (!ctx.doc) {\n      ctx.dispatch({ type: 'CLEAR' });\n      return;\n    }\n\n    // Viewport-first: begin scanning where the user is looking.\n    if (startPage === undefined) {\n      const stage = ctx.tryGet(StageToken);\n      if (stage) startPage = ctx.document()?.pages[stage.currentPage()]?.pageObjectNumber;\n    }\n\n    try {\n      const complete = await collect(\n        query,\n        { startPage },\n        {\n          onStart: () => ctx.dispatch({ type: 'START', query }),\n          onSlice: (hits, scanned, total) => ctx.dispatch({ type: 'APPEND', hits, scanned, total }),\n          isCancelled: () => gen !== generation,\n          setInflight: (pending) => {\n            if (gen === generation) inflight = pending;\n          },\n        },\n      );\n      if (complete && gen === generation) ctx.dispatch({ type: 'COMPLETE' });\n    } catch (err) {\n      if (gen !== generation) return;\n      ctx.dispatch({ type: 'ERROR', message: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  function goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null {\n    const { hits } = ctx.getState();\n    if (hits.length === 0) return null;\n    const wrapped = ((index % hits.length) + hits.length) % hits.length;\n    ctx.dispatch({ type: 'SET_ACTIVE', index: wrapped });\n    const hit = hits[wrapped];\n    // Positioned reveal: the HIT (not just its page) arrives at the anchor —\n    // per-call override > plugin config > find-bar default. Zoom never changes.\n    const arrival = { ...DEFAULT_REVEAL, ...config.reveal, ...reveal };\n    ctx.tryGet(StageToken)?.reveal(hit.pageIndex, {\n      rect: boundsOfRects(hit.rects) ?? undefined,\n      anchor: arrival.anchor,\n      behavior: arrival.behavior,\n    });\n    return hit;\n  }\n\n  const clear = () => {\n    generation++;\n    inflight?.abort('cleared');\n    inflight = null;\n    ctx.dispatch({ type: 'CLEAR' });\n  };\n\n  return {\n    // An empty text is \"stop searching\", not a query — identical to clear().\n    search: (query, exec) =>\n      query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),\n\n    // Replay the stored query verbatim; the rescan starts viewport-first.\n    rerun: () => {\n      const { query, status } = ctx.getState();\n      if (query && status !== 'idle') void runSession(query);\n    },\n\n    clear,\n\n    next: () => goTo(ctx.getState().activeIndex + 1),\n    prev: () => goTo(ctx.getState().activeIndex - 1),\n    goTo,\n\n    query: () => ctx.getState().query,\n\n    findAll: async (query, opts = {}) => {\n      if (!ctx.doc) return [];\n      const all: SearchHit[] = [];\n      const signal = opts.signal;\n      // Independent lifecycle: its own abort handle, never the session's\n      // generation counter — a findAll can neither supersede the user's\n      // visible search nor be superseded by it.\n      let pending: { abort(reason?: unknown): void } | null = null;\n      const onAbort = () => pending?.abort(signal?.reason);\n      signal?.addEventListener('abort', onAbort, { once: true });\n      try {\n        await collect(\n          query,\n          { mode: opts.mode },\n          {\n            onStart: () => {\n              all.length = 0;\n            },\n            onSlice: (hits) => all.push(...hits),\n            isCancelled: () => signal?.aborted ?? false,\n            setInflight: (p) => {\n              pending = p;\n            },\n          },\n        );\n        if (signal?.aborted) throw signal.reason ?? new Error('findAll aborted');\n        return all;\n      } finally {\n        signal?.removeEventListener('abort', onAbort);\n      }\n    },\n\n    status: () => ctx.getState().status,\n    hits: () => ctx.getState().hits,\n    hitCount: () => ctx.getState().hits.length,\n    activeIndex: () => ctx.getState().activeIndex,\n    activeHit: () => {\n      const { hits, activeIndex } = ctx.getState();\n      return activeIndex >= 0 && activeIndex < hits.length ? hits[activeIndex] : null;\n    },\n    hitsForPage: (pon) => {\n      const { hits, hitsByPage } = ctx.getState();\n      const indices = hitsByPage[pon];\n      return indices?.length ? indices.map((i) => hits[i]) : EMPTY;\n    },\n    progress: () => ctx.getState().progress,\n    errorMessage: () => ctx.getState().error,\n  };\n}\n","import { createCapabilityToken, type PageObjectNumber } from '@embedpdf/core';\nimport type { Rect } from '@embedpdf/core-geometry';\nimport type { RevealAnchor, ScrollBehaviorKind } from '@embedpdf/plugin-stage';\nimport type { SearchMode, SearchQuery, SearchSnippet } from '@embedpdf/engine-core/runtime';\n\n/**\n * One match, viewer-shaped: the engine's PDF-space line rects converted to\n * CONTENT space (y-down — the same space selection rects live in), plus the\n * page's display index so navigation can `reveal()` without a lookup.\n * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can\n * later seed a selection or a highlight annotation without re-searching.\n */\nexport interface SearchHit {\n  pon: PageObjectNumber;\n  pageIndex: number;\n  charStart: number;\n  charCount: number;\n  rects: Rect[];\n  snippet?: SearchSnippet;\n}\n\n/**\n * `searching` means the slice loop is still walking pages — results are\n * usable the moment they appear (matches stream in viewport-first order).\n */\nexport type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';\n\n/**\n * Execution options for the session `search()` — HOW the scan runs, never\n * part of what the query MEANS (which is why they're not on `SearchQuery`\n * and are never stored or restored into a search box).\n */\nexport interface SearchExecOptions {\n  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */\n  startPage?: PageObjectNumber;\n}\n\n/** Options for the session-free `findAll()` service. */\nexport interface SearchFindAllOptions {\n  /** Abort the scan; the returned promise rejects with `signal.reason`. */\n  signal?: AbortSignal;\n  /**\n   * Pin the slice mode. Default: `'full'` with automatic `'rects'`\n   * fallback when snippets are denied — pass `'rects'` when you only need\n   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.\n   */\n  mode?: SearchMode;\n}\n\nexport interface SearchState {\n  /**\n   * The query in flight/completed, null when idle/cleared — THE stored\n   * form of the search intent, the same flat `SearchQuery` the engine\n   * matches on, the wire caches by, and a search box renders. Survives\n   * any search UI unmounting (results are document-scoped; so is this).\n   */\n  query: SearchQuery | null;\n  status: SearchStatus;\n  hits: SearchHit[];\n  /** pon → indices into `hits` — the per-page layer's read model. */\n  hitsByPage: Record<number, number[]>;\n  /** Index into `hits`, -1 = none. */\n  activeIndex: number;\n  progress: { scanned: number; total: number };\n  error: string | null;\n}\n\nexport type SearchAction =\n  | { type: 'START'; query: SearchQuery }\n  | { type: 'APPEND'; hits: SearchHit[]; scanned: number; total: number }\n  | { type: 'COMPLETE' }\n  | { type: 'ERROR'; message: string }\n  | { type: 'SET_ACTIVE'; index: number }\n  | { type: 'CLEAR' };\n\n/**\n * How hit navigation arrives (forwarded to the Stage's positioned reveal).\n * The default is the browser find-bar feel: the hit lands at the top-middle\n * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the\n * hit is off-screen, zoom never changes, smooth tween.\n */\nexport interface SearchRevealOptions {\n  anchor?: RevealAnchor;\n  behavior?: ScrollBehaviorKind;\n}\n\nexport interface SearchPluginConfig {\n  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */\n  reveal?: SearchRevealOptions;\n}\n\n/**\n * The search plugin is a find SERVICE plus one user-visible search SESSION\n * per document. `findAll` is the service; `search` is the session; the\n * sidebar, the highlights layer, and next/prev render the session.\n */\nexport interface SearchCapability {\n  // ── the session: THE user-visible find, one per document ────────────────\n  /**\n   * Start a new search (supersedes and aborts any running one). Results\n   * stream into state slice by slice; the first hit becomes active but the\n   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty\n   * `query.text` is \"stop searching\" — identical to `clear()`.\n   */\n  search(query: SearchQuery, exec?: SearchExecOptions): void;\n  /** Re-run the current query from scratch (used after document mutations). */\n  rerun(): void;\n  clear(): void;\n\n  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */\n  next(): SearchHit | null;\n  prev(): SearchHit | null;\n  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */\n  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;\n\n  /** The session's query — what a search box renders. Null when idle. */\n  query(): SearchQuery | null;\n  status(): SearchStatus;\n  hits(): SearchHit[];\n  hitCount(): number;\n  activeIndex(): number;\n  activeHit(): SearchHit | null;\n  /** Hits on one page — the layer's input. Element identity is stable. */\n  hitsForPage(pon: PageObjectNumber): SearchHit[];\n  progress(): { scanned: number; total: number };\n  errorMessage(): string | null;\n\n  // ── the mechanism: session-free find service ─────────────────────────────\n  /**\n   * Run a query to completion and return every hit. Touches NO state — no\n   * sidebar, no highlights, no camera, no activeIndex; the user's visible\n   * search is never superseded. The primitive other features build on\n   * (redact-by-term, link detection, occurrence badges). Scans in natural\n   * page order; concurrent calls are independent.\n   */\n  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;\n}\n\nexport const SearchToken = createCapabilityToken<SearchCapability>('search');\n","/**\n * Keeps results honest across document mutations. Every confirmed\n * mutation (own or remote) bumps the engine's mutation sequence, which\n * invalidates search cursors AND can change what's findable (redaction,\n * page delete, import). The correct reaction is always the same: re-run\n * the current query from scratch. Reruns are coalesced — a burst of\n * events (multi-part mutation, SSE catch-up) triggers one rescan.\n */\nimport type { EffectContext } from '@embedpdf/core';\n\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchState } from './types';\n\nconst RERUN_DELAY_MS = 250;\n\nexport function registerSearchEffects(ctx: EffectContext<SearchState, SearchAction>): void {\n  const doc = ctx.doc;\n  if (!doc) return;\n\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  const unsubscribe = doc.events.subscribe(() => {\n    if (ctx.getState().status === 'idle') return;\n    if (timer !== null) clearTimeout(timer);\n    timer = setTimeout(() => {\n      timer = null;\n      ctx.get(SearchToken).rerun();\n    }, RERUN_DELAY_MS);\n  });\n\n  ctx.cleanup(() => {\n    if (timer !== null) clearTimeout(timer);\n    unsubscribe();\n  });\n}\n","import type { SearchAction, SearchState } from './types';\n\nexport const initialSearchState = (): SearchState => ({\n  query: null,\n  status: 'idle',\n  hits: [],\n  hitsByPage: {},\n  activeIndex: -1,\n  progress: { scanned: 0, total: 0 },\n  error: null,\n});\n\nexport const searchReducer = (state: SearchState, action: SearchAction): SearchState => {\n  switch (action.type) {\n    case 'START':\n      return { ...initialSearchState(), query: action.query, status: 'searching' };\n    case 'APPEND': {\n      if (action.hits.length === 0) {\n        return { ...state, progress: { scanned: action.scanned, total: action.total } };\n      }\n      const hits = state.hits.concat(action.hits);\n      const hitsByPage = { ...state.hitsByPage };\n      for (let i = state.hits.length; i < hits.length; i++) {\n        const pon = hits[i].pon;\n        hitsByPage[pon] = (hitsByPage[pon] ?? []).concat(i);\n      }\n      return {\n        ...state,\n        hits,\n        hitsByPage,\n        // The first hit becomes active (so \"1/N\" reads right) — navigation,\n        // not the stream, moves the camera.\n        activeIndex: state.activeIndex === -1 ? 0 : state.activeIndex,\n        progress: { scanned: action.scanned, total: action.total },\n      };\n    }\n    case 'COMPLETE':\n      return { ...state, status: 'complete' };\n    case 'ERROR':\n      return { ...state, status: 'error', error: action.message };\n    case 'SET_ACTIVE':\n      return { ...state, activeIndex: action.index };\n    case 'CLEAR':\n      return initialSearchState();\n    default:\n      return state;\n  }\n};\n","import { definePlugin } from '@embedpdf/core';\nimport { StageToken } from '@embedpdf/plugin-stage';\n\nimport { createSearchCapability } from './capability';\nimport { registerSearchEffects } from './effects';\nimport { initialSearchState, searchReducer } from './reducer';\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchCapability, SearchPluginConfig, SearchState } from './types';\n\n/**\n * Document text search over `doc.search` — the engine's budgeted,\n * cursor-resumable slices. Document-scoped; no pointer handling, so it\n * needs no interaction hub. The Stage is optional: when present, scans\n * start at the current page (viewport-first) and hit navigation reveals\n * the hit's page; without it the host owns scrolling.\n */\nexport const searchPlugin = (config?: SearchPluginConfig) =>\n  definePlugin<SearchState, SearchAction, SearchCapability>({\n    id: 'search',\n    token: SearchToken,\n    scope: 'document',\n    optional: [StageToken],\n    initialState: initialSearchState,\n    reduce: searchReducer,\n    capability: (ctx) => createSearchCapability(ctx, config),\n    effects: registerSearchEffects,\n  });\n"],"mappings":";;;;;;AA2BA,MAAM,QAAqB,CAAC;;AAG5B,MAAM,iBAAsC;CAAE,QAAQ,EAAE,GAAG,IAAK;CAAG,UAAU;AAAS;;AAGtF,MAAM,sBAAsB,QACzB,eAAe,SAAS,IAAI,SAAS,sBACtCA,8BAAAA,YAAY,GAAG,KAAKC,8BAAAA,gBAAgB,SAAS;;;;;;;;;;;;;;;;AAiB/C,SAAgB,uBACd,KACA,SAA6B,CAAC,GACZ;CAClB,IAAI,aAAa;CACjB,IAAI,WAAqD;CAEzD,MAAM,aAAa,GAAoD,OAAA,GAAA,wBAAA,UAAA,CAEnE,GACA;EACE,GAAG,EAAE;EACL,GAAG,EAAE;EACL,OAAO,EAAE,QAAQ,EAAE;EACnB,QAAQ,EAAE,MAAM,EAAE;CACpB,CACF;CAOF,SAAS,cAAc,OAAiC;EAGtD,MAAM,6BAAa,IAAI,IAA4C;EACnE,MAAM,gBAAgB,QAAgD;GACpE,IAAI,OAAO,WAAW,IAAI,GAAG;GAC7B,IAAI,SAAS,KAAA,GAAW,OAAO;GAC/B,MAAM,SAAS,IAAI,SAAS,CAAC,EAAE,MAAM,MAAM,MAAM,EAAE,qBAAqB,GAAG;GAC3E,IAAI,CAAC,QACH,OAAO;QACF;IACL,MAAM,EAAE,kBAAA,GAAA,wBAAA,aAAA,CACN;KAAE,MAAM,OAAO,MAAM;KAAM,UAAU,OAAO;KAAU,UAAU,OAAO;IAAS,GAChF,CACF;IACA,OAAO;KAAE,WAAW,OAAO;KAAO,SAAS,MAAM,UAAU,cAAc,CAAC;IAAE;GAC9E;GACA,WAAW,IAAI,KAAK,IAAI;GACxB,OAAO;EACT;EAEA,MAAM,OAAoB,CAAC;EAC3B,KAAK,MAAM,SAAS,MAAM,SAAS;GACjC,MAAM,OAAO,aAAa,MAAM,gBAAgB;GAChD,IAAI,CAAC,MAAM;GACX,KAAK,KAAK;IACR,KAAK,MAAM;IACX,WAAW,KAAK;IAChB,WAAW,MAAM;IACjB,WAAW,MAAM;IACjB,OAAO,MAAM,MAAM,IAAI,KAAK,MAAM;IAClC,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;GACpD,CAAC;EACH;EACA,OAAO;CACT;;;;;;;;;CAsBA,eAAe,QACb,OACA,MACA,MACkB;EAClB,MAAM,MAAM,IAAI;EAChB,IAAI,CAAC,KAAK,OAAO;EAEjB,KAAK,QAAQ;EAEb,IAAI,OAAmB,KAAK,QAAQ;EACpC,MAAM,aAAa,KAAK,SAAS,KAAA;EACjC,IAAI;EACJ,IAAI,YAAY;EAChB,SAAS;GACP,IAAI;GACJ,IAAI;IACF,MAAM,UAAU;KACd;KACA;KACA,GAAI,WAAW,KAAA,IACX,EAAE,OAAO,IACT,KAAK,cAAc,KAAA,IACjB,EAAE,WAAW,KAAK,UAAU,IAC5B,CAAC;IACT;IACA,MAAM,UAAU,IAAI,OAAO,MAAM,OAAO;IACxC,KAAK,YAAY,OAAO;IACxB,QAAQ,MAAM;GAChB,SAAS,KAAK;IACZ,IAAI,KAAK,YAAY,GAAG,OAAO;IAG/B,IAAI,CAAC,cAAc,SAAS,UAAU,WAAW,KAAA,KAAa,mBAAmB,GAAG,GAAG;KACrF,OAAO;KACP;IACF;IAIA,IAAI,WAAW,KAAA,KAAa,CAAC,aAAaD,8BAAAA,YAAY,GAAG,KAAKC,8BAAAA,gBAAgB,UAAU,GAAG;KACzF,YAAY;KACZ,SAAS,KAAA;KACT,KAAK,QAAQ;KACb;IACF;IACA,MAAM;GACR;GACA,IAAI,KAAK,YAAY,GAAG,OAAO;GAC/B,KAAK,QAAQ,cAAc,KAAK,GAAG,MAAM,cAAc,MAAM,UAAU;GACvE,IAAI,MAAM,eAAe,MAAM;IAC7B,KAAK,YAAY,IAAI;IACrB,OAAO;GACT;GACA,SAAS,MAAM;EACjB;CACF;;CAGA,eAAe,WAAW,OAAoB,WAA6C;EACzF,MAAM,MAAM,EAAE;EACd,UAAU,MAAM,YAAY;EAC5B,WAAW;EAEX,IAAI,CAAC,IAAI,KAAK;GACZ,IAAI,SAAS,EAAE,MAAM,QAAQ,CAAC;GAC9B;EACF;EAGA,IAAI,cAAc,KAAA,GAAW;GAC3B,MAAM,QAAQ,IAAI,OAAOC,uBAAAA,UAAU;GACnC,IAAI,OAAO,YAAY,IAAI,SAAS,CAAC,EAAE,MAAM,MAAM,YAAY,EAAE,EAAE;EACrE;EAEA,IAAI;GAaF,IAAI,MAZmB,QACrB,OACA,EAAE,UAAU,GACZ;IACE,eAAe,IAAI,SAAS;KAAE,MAAM;KAAS;IAAM,CAAC;IACpD,UAAU,MAAM,SAAS,UAAU,IAAI,SAAS;KAAE,MAAM;KAAU;KAAM;KAAS;IAAM,CAAC;IACxF,mBAAmB,QAAQ;IAC3B,cAAc,YAAY;KACxB,IAAI,QAAQ,YAAY,WAAW;IACrC;GACF,CACF,KACgB,QAAQ,YAAY,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;EACvE,SAAS,KAAK;GACZ,IAAI,QAAQ,YAAY;GACxB,IAAI,SAAS;IAAE,MAAM;IAAS,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAAE,CAAC;EAC3F;CACF;CAEA,SAAS,KAAK,OAAe,QAAgD;EAC3E,MAAM,EAAE,SAAS,IAAI,SAAS;EAC9B,IAAI,KAAK,WAAW,GAAG,OAAO;EAC9B,MAAM,WAAY,QAAQ,KAAK,SAAU,KAAK,UAAU,KAAK;EAC7D,IAAI,SAAS;GAAE,MAAM;GAAc,OAAO;EAAQ,CAAC;EACnD,MAAM,MAAM,KAAK;EAGjB,MAAM,UAAU;GAAE,GAAG;GAAgB,GAAG,OAAO;GAAQ,GAAG;EAAO;EACjE,IAAI,OAAOA,uBAAAA,UAAU,CAAC,EAAE,OAAO,IAAI,WAAW;GAC5C,OAAA,GAAA,wBAAA,cAAA,CAAoB,IAAI,KAAK,KAAK,KAAA;GAClC,QAAQ,QAAQ;GAChB,UAAU,QAAQ;EACpB,CAAC;EACD,OAAO;CACT;CAEA,MAAM,cAAc;EAClB;EACA,UAAU,MAAM,SAAS;EACzB,WAAW;EACX,IAAI,SAAS,EAAE,MAAM,QAAQ,CAAC;CAChC;CAEA,OAAO;EAEL,SAAS,OAAO,SACd,MAAM,KAAK,WAAW,IAAI,MAAM,IAAI,KAAK,WAAW,OAAO,MAAM,SAAS;EAG5E,aAAa;GACX,MAAM,EAAE,OAAO,WAAW,IAAI,SAAS;GACvC,IAAI,SAAS,WAAW,QAAQ,WAAgB,KAAK;EACvD;EAEA;EAEA,YAAY,KAAK,IAAI,SAAS,CAAC,CAAC,cAAc,CAAC;EAC/C,YAAY,KAAK,IAAI,SAAS,CAAC,CAAC,cAAc,CAAC;EAC/C;EAEA,aAAa,IAAI,SAAS,CAAC,CAAC;EAE5B,SAAS,OAAO,OAAO,OAAO,CAAC,MAAM;GACnC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;GACtB,MAAM,MAAmB,CAAC;GAC1B,MAAM,SAAS,KAAK;GAIpB,IAAI,UAAoD;GACxD,MAAM,gBAAgB,SAAS,MAAM,QAAQ,MAAM;GACnD,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;GACzD,IAAI;IACF,MAAM,QACJ,OACA,EAAE,MAAM,KAAK,KAAK,GAClB;KACE,eAAe;MACb,IAAI,SAAS;KACf;KACA,UAAU,SAAS,IAAI,KAAK,GAAG,IAAI;KACnC,mBAAmB,QAAQ,WAAW;KACtC,cAAc,MAAM;MAClB,UAAU;KACZ;IACF,CACF;IACA,IAAI,QAAQ,SAAS,MAAM,OAAO,0BAAU,IAAI,MAAM,iBAAiB;IACvE,OAAO;GACT,UAAU;IACR,QAAQ,oBAAoB,SAAS,OAAO;GAC9C;EACF;EAEA,cAAc,IAAI,SAAS,CAAC,CAAC;EAC7B,YAAY,IAAI,SAAS,CAAC,CAAC;EAC3B,gBAAgB,IAAI,SAAS,CAAC,CAAC,KAAK;EACpC,mBAAmB,IAAI,SAAS,CAAC,CAAC;EAClC,iBAAiB;GACf,MAAM,EAAE,MAAM,gBAAgB,IAAI,SAAS;GAC3C,OAAO,eAAe,KAAK,cAAc,KAAK,SAAS,KAAK,eAAe;EAC7E;EACA,cAAc,QAAQ;GACpB,MAAM,EAAE,MAAM,eAAe,IAAI,SAAS;GAC1C,MAAM,UAAU,WAAW;GAC3B,OAAO,SAAS,SAAS,QAAQ,KAAK,MAAM,KAAK,EAAE,IAAI;EACzD;EACA,gBAAgB,IAAI,SAAS,CAAC,CAAC;EAC/B,oBAAoB,IAAI,SAAS,CAAC,CAAC;CACrC;AACF;;;ACpLA,MAAa,eAAA,GAAA,eAAA,sBAAA,CAAsD,QAAQ;;;AC7H3E,MAAM,iBAAiB;AAEvB,SAAgB,sBAAsB,KAAqD;CACzF,MAAM,MAAM,IAAI;CAChB,IAAI,CAAC,KAAK;CAEV,IAAI,QAA8C;CAClD,MAAM,cAAc,IAAI,OAAO,gBAAgB;EAC7C,IAAI,IAAI,SAAS,CAAC,CAAC,WAAW,QAAQ;EACtC,IAAI,UAAU,MAAM,aAAa,KAAK;EACtC,QAAQ,iBAAiB;GACvB,QAAQ;GACR,IAAI,IAAI,WAAW,CAAC,CAAC,MAAM;EAC7B,GAAG,cAAc;CACnB,CAAC;CAED,IAAI,cAAc;EAChB,IAAI,UAAU,MAAM,aAAa,KAAK;EACtC,YAAY;CACd,CAAC;AACH;;;AC/BA,MAAa,4BAAyC;CACpD,OAAO;CACP,QAAQ;CACR,MAAM,CAAC;CACP,YAAY,CAAC;CACb,aAAa;CACb,UAAU;EAAE,SAAS;EAAG,OAAO;CAAE;CACjC,OAAO;AACT;AAEA,MAAa,iBAAiB,OAAoB,WAAsC;CACtF,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO;GAAE,GAAG,mBAAmB;GAAG,OAAO,OAAO;GAAO,QAAQ;EAAY;EAC7E,KAAK,UAAU;GACb,IAAI,OAAO,KAAK,WAAW,GACzB,OAAO;IAAE,GAAG;IAAO,UAAU;KAAE,SAAS,OAAO;KAAS,OAAO,OAAO;IAAM;GAAE;GAEhF,MAAM,OAAO,MAAM,KAAK,OAAO,OAAO,IAAI;GAC1C,MAAM,aAAa,EAAE,GAAG,MAAM,WAAW;GACzC,KAAK,IAAI,IAAI,MAAM,KAAK,QAAQ,IAAI,KAAK,QAAQ,KAAK;IACpD,MAAM,MAAM,KAAK,EAAE,CAAC;IACpB,WAAW,QAAQ,WAAW,QAAQ,CAAC,EAAA,CAAG,OAAO,CAAC;GACpD;GACA,OAAO;IACL,GAAG;IACH;IACA;IAGA,aAAa,MAAM,gBAAgB,KAAK,IAAI,MAAM;IAClD,UAAU;KAAE,SAAS,OAAO;KAAS,OAAO,OAAO;IAAM;GAC3D;EACF;EACA,KAAK,YACH,OAAO;GAAE,GAAG;GAAO,QAAQ;EAAW;EACxC,KAAK,SACH,OAAO;GAAE,GAAG;GAAO,QAAQ;GAAS,OAAO,OAAO;EAAQ;EAC5D,KAAK,cACH,OAAO;GAAE,GAAG;GAAO,aAAa,OAAO;EAAM;EAC/C,KAAK,SACH,OAAO,mBAAmB;EAC5B,SACE,OAAO;CACX;AACF;;;;;;;;;;AC/BA,MAAa,gBAAgB,YAAA,GAAA,eAAA,aAAA,CAC+B;CACxD,IAAI;CACJ,OAAO;CACP,OAAO;CACP,UAAU,CAACC,uBAAAA,UAAU;CACrB,cAAc;CACd,QAAQ;CACR,aAAa,QAAQ,uBAAuB,KAAK,MAAM;CACvD,SAAS;AACX,CAAC"}
+{"version":3,"file":"index.cjs","names":["EngineError","EngineErrorCode","StageToken","SearchToken","SearchToken","StageToken"],"sources":["../src/capability.ts","../src/effects.ts","../src/reducer.ts","../src/search.plugin.ts"],"sourcesContent":["import type { PageObjectNumber, PluginContext } from '@embedpdf/core';\nimport { type PointIn, type TextQuad, applyPoint, boundsOfRects, pageGeometry, textQuadBounds } from '@embedpdf/core-geometry';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\nimport { EngineError, EngineErrorCode } from '@embedpdf/engine-core/runtime';\nimport type {\n  PdfQuad,\n  PdfRect,\n  SearchMatch,\n  SearchMode,\n  SearchQuery,\n  SearchSlice,\n} from '@embedpdf/engine-core/runtime';\n\nimport type {\n  SearchAction,\n  SearchCapability,\n  SearchHit,\n  SearchPluginConfig,\n  SearchRevealOptions,\n  SearchState,\n} from './types';\n\nconst EMPTY: SearchHit[] = [];\n\n/** The browser find-bar feel: hit at the top-middle, no zoom change. */\nconst DEFAULT_REVEAL: SearchRevealOptions = { anchor: { y: 0.35 }, behavior: 'smooth' };\n\n/** Local engines reject a denied scope before the worker; cloud maps 403. */\nconst isPermissionDenied = (err: unknown): boolean =>\n  (err instanceof Error && err.name === 'PermissionDenied') ||\n  EngineError.is(err, EngineErrorCode.Forbidden);\n\n/**\n * The search capability: a client-driven cursor loop over the engine's\n * budgeted slices. One generation counter arbitrates: a new `search()` (or\n * `clear()`, or a document mutation via `rerun()`) supersedes the running\n * loop, which aborts its in-flight slice and stops dispatching.\n *\n * Rect conversion happens HERE, once per slice: the engine's PDF-space\n * line rects → content space through the same page geometry the selection\n * plugin uses, so search highlights and selection highlights are pixel-twins.\n *\n * Stage integration is optional and additive: with a Stage present the scan\n * starts at the current page (viewport-first — the hits the user is looking\n * at arrive in the first slice) and `next()`/`prev()`/`goTo()` reveal the\n * hit's page. Without one, navigation still works; the host scrolls.\n */\nexport function createSearchCapability(\n  ctx: PluginContext<SearchState, SearchAction>,\n  config: SearchPluginConfig = {},\n): SearchCapability {\n  let generation = 0;\n  let inflight: { abort(reason?: unknown): void } | null = null;\n\n  interface PageConverter {\n    pageIndex: number;\n    toQuad: (q: PdfQuad) => TextQuad;\n  }\n\n  function hitsFromSlice(slice: SearchSlice): SearchHit[] {\n    // zoom = 1: content space is scale-free; the layer applies the page\n    // transform at render time (the selection idiom).\n    const converters = new Map<PageObjectNumber, PageConverter | null>();\n    const converterFor = (pon: PageObjectNumber): PageConverter | null => {\n      let conv = converters.get(pon);\n      if (conv !== undefined) return conv;\n      const layout = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon);\n      if (!layout) {\n        conv = null; // page vanished mid-search (delete); drop its hits\n      } else {\n        const { pdfToContent } = pageGeometry(\n          { crop: layout.boxes.crop, rotation: layout.rotation, userUnit: layout.userUnit },\n          1,\n        );\n        // Engine quads carry frame-geometric slot semantics (p1..p4 =\n        // upper-start, upper-end, lower-start, lower-end) — a trusted\n        // producer, so the y-flip maps corners straight onto their names.\n        const toPoint = (pt: { x: number; y: number }) =>\n          applyPoint(pdfToContent as never, pt as PointIn<'pdf'>) as { x: number; y: number };\n        conv = {\n          pageIndex: layout.index,\n          toQuad: (q) => ({\n            upperStart: toPoint(q.p1),\n            upperEnd: toPoint(q.p2),\n            lowerStart: toPoint(q.p3),\n            lowerEnd: toPoint(q.p4),\n          }),\n        };\n      }\n      converters.set(pon, conv);\n      return conv;\n    };\n\n    const hits: SearchHit[] = [];\n    for (const match of slice.matches) {\n      const conv = converterFor(match.pageObjectNumber);\n      if (!conv) continue;\n      const segments = match.segments.map((segment) => {\n        const quad = conv.toQuad(segment.quad);\n        // `rect` is recomputed from the MAPPED quad so the pair can't drift.\n        return { quad, rect: textQuadBounds(quad), advance: segment.advance };\n      });\n      hits.push({\n        pon: match.pageObjectNumber,\n        pageIndex: conv.pageIndex,\n        charStart: match.charStart,\n        charCount: match.charCount,\n        segments,\n        ...(segments.length\n          ? { bounds: boundsOfRects(segments.map((s) => s.rect)) ?? undefined }\n          : {}),\n        ...(match.snippet ? { snippet: match.snippet } : {}),\n      });\n    }\n    return hits;\n  }\n\n  /** How a collect() consumer observes the loop — the session dispatches\n   *  into state, findAll accumulates locally. */\n  interface CollectSink {\n    /** Called before the first slice AND again on a stale-cursor restart —\n     *  reset any accumulation. */\n    onStart: () => void;\n    onSlice: (hits: SearchHit[], scanned: number, total: number) => void;\n    /** Superseded / aborted — the loop stops without completing. */\n    isCancelled: () => boolean;\n    setInflight: (pending: { abort(reason?: unknown): void } | null) => void;\n  }\n\n  /**\n   * THE MECHANISM — one cursor loop over the engine's budgeted slices,\n   * shared by the session (`search`) and the session-free service\n   * (`findAll`): permission fallback ('full' → 'rects' when snippets are\n   * denied, unless the caller pinned a mode), restart-once on a stale\n   * cursor, rect conversion per slice. Resolves true on exhaustion, false\n   * when cancelled; throws on error.\n   */\n  async function collect(\n    query: SearchQuery,\n    opts: { startPage?: PageObjectNumber; mode?: SearchMode },\n    sink: CollectSink,\n  ): Promise<boolean> {\n    const doc = ctx.doc;\n    if (!doc) return false;\n\n    sink.onStart();\n\n    let mode: SearchMode = opts.mode ?? 'full';\n    const modePinned = opts.mode !== undefined;\n    let cursor: string | undefined;\n    let restarted = false;\n    for (;;) {\n      let slice: SearchSlice;\n      try {\n        const request = {\n          query,\n          mode,\n          ...(cursor !== undefined\n            ? { cursor }\n            : opts.startPage !== undefined\n              ? { startPage: opts.startPage }\n              : {}),\n        };\n        const pending = doc.search.query(request);\n        sink.setInflight(pending);\n        slice = await pending;\n      } catch (err) {\n        if (sink.isCancelled()) return false; // superseded — the abort was ours\n        // Snippets denied (no doc.text.copy)? Degrade to rect-only matches\n        // instead of failing the whole search — find still works.\n        if (!modePinned && mode === 'full' && cursor === undefined && isPermissionDenied(err)) {\n          mode = 'rects';\n          continue;\n        }\n        // A stale cursor rejects with InvalidArg — the document changed\n        // under the loop, or the engine's session was recycled. Position\n        // is lost, the query isn't: restart once from scratch.\n        if (cursor !== undefined && !restarted && EngineError.is(err, EngineErrorCode.InvalidArg)) {\n          restarted = true;\n          cursor = undefined;\n          sink.onStart();\n          continue;\n        }\n        throw err;\n      }\n      if (sink.isCancelled()) return false;\n      sink.onSlice(hitsFromSlice(slice), slice.scannedPages, slice.totalPages);\n      if (slice.nextCursor === null) {\n        sink.setInflight(null);\n        return true;\n      }\n      cursor = slice.nextCursor;\n    }\n  }\n\n  /** THE SESSION — collect() with state as the sink, generation-guarded. */\n  async function runSession(query: SearchQuery, startPage?: PageObjectNumber): Promise<void> {\n    const gen = ++generation;\n    inflight?.abort('superseded');\n    inflight = null;\n\n    if (!ctx.doc) {\n      ctx.dispatch({ type: 'CLEAR' });\n      return;\n    }\n\n    // Viewport-first: begin scanning where the user is looking.\n    if (startPage === undefined) {\n      const stage = ctx.tryGet(StageToken);\n      if (stage) startPage = ctx.document()?.pages[stage.currentPage()]?.pageObjectNumber;\n    }\n\n    try {\n      const complete = await collect(\n        query,\n        { startPage },\n        {\n          onStart: () => ctx.dispatch({ type: 'START', query }),\n          onSlice: (hits, scanned, total) => ctx.dispatch({ type: 'APPEND', hits, scanned, total }),\n          isCancelled: () => gen !== generation,\n          setInflight: (pending) => {\n            if (gen === generation) inflight = pending;\n          },\n        },\n      );\n      if (complete && gen === generation) ctx.dispatch({ type: 'COMPLETE' });\n    } catch (err) {\n      if (gen !== generation) return;\n      ctx.dispatch({ type: 'ERROR', message: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  function goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null {\n    const { hits } = ctx.getState();\n    if (hits.length === 0) return null;\n    const wrapped = ((index % hits.length) + hits.length) % hits.length;\n    ctx.dispatch({ type: 'SET_ACTIVE', index: wrapped });\n    const hit = hits[wrapped];\n    // Positioned reveal: the HIT (not just its page) arrives at the anchor —\n    // per-call override > plugin config > find-bar default. Zoom never changes.\n    const arrival = { ...DEFAULT_REVEAL, ...config.reveal, ...reveal };\n    ctx.tryGet(StageToken)?.reveal(hit.pageIndex, {\n      rect: hit.bounds,\n      anchor: arrival.anchor,\n      behavior: arrival.behavior,\n    });\n    return hit;\n  }\n\n  const clear = () => {\n    generation++;\n    inflight?.abort('cleared');\n    inflight = null;\n    ctx.dispatch({ type: 'CLEAR' });\n  };\n\n  return {\n    // The twin. Search is a pure request, so the VERBS carry no client gate\n    // (the engine enforces; the ERROR state reports) — the twin exists for\n    // affordance hiding. 'full' composes both capabilities because a snippet\n    // reproduces document text; the session's own degradation means plain\n    // `canSearch()` is exactly \"would `search()` produce hits\".\n    canSearch: (mode) => {\n      const sec = ctx.doc?.security;\n      if (!sec) return false;\n      return sec.allows('doc.text.search') && (mode !== 'full' || sec.allows('doc.text.copy'));\n    },\n\n    // An empty text is \"stop searching\", not a query — identical to clear().\n    search: (query, exec) =>\n      query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),\n\n    // Replay the stored query verbatim; the rescan starts viewport-first.\n    rerun: () => {\n      const { query, status } = ctx.getState();\n      if (query && status !== 'idle') void runSession(query);\n    },\n\n    clear,\n\n    next: () => goTo(ctx.getState().activeIndex + 1),\n    prev: () => goTo(ctx.getState().activeIndex - 1),\n    goTo,\n\n    query: () => ctx.getState().query,\n\n    findAll: async (query, opts = {}) => {\n      if (!ctx.doc) return [];\n      const all: SearchHit[] = [];\n      const signal = opts.signal;\n      // Independent lifecycle: its own abort handle, never the session's\n      // generation counter — a findAll can neither supersede the user's\n      // visible search nor be superseded by it.\n      let pending: { abort(reason?: unknown): void } | null = null;\n      const onAbort = () => pending?.abort(signal?.reason);\n      signal?.addEventListener('abort', onAbort, { once: true });\n      try {\n        await collect(\n          query,\n          { mode: opts.mode },\n          {\n            onStart: () => {\n              all.length = 0;\n            },\n            onSlice: (hits) => all.push(...hits),\n            isCancelled: () => signal?.aborted ?? false,\n            setInflight: (p) => {\n              pending = p;\n            },\n          },\n        );\n        if (signal?.aborted) throw signal.reason ?? new Error('findAll aborted');\n        return all;\n      } finally {\n        signal?.removeEventListener('abort', onAbort);\n      }\n    },\n\n    status: () => ctx.getState().status,\n    hits: () => ctx.getState().hits,\n    hitCount: () => ctx.getState().hits.length,\n    activeIndex: () => ctx.getState().activeIndex,\n    activeHit: () => {\n      const { hits, activeIndex } = ctx.getState();\n      return activeIndex >= 0 && activeIndex < hits.length ? hits[activeIndex] : null;\n    },\n    hitsForPage: (pon) => {\n      const { hits, hitsByPage } = ctx.getState();\n      const indices = hitsByPage[pon];\n      return indices?.length ? indices.map((i) => hits[i]) : EMPTY;\n    },\n    progress: () => ctx.getState().progress,\n    errorMessage: () => ctx.getState().error,\n  };\n}\n","/**\n * Keeps results honest across document mutations. Every confirmed\n * mutation (own or remote) bumps the engine's mutation sequence, which\n * invalidates search cursors AND can change what's findable (redaction,\n * page delete, import). The correct reaction is always the same: re-run\n * the current query from scratch. Reruns are coalesced — a burst of\n * events (multi-part mutation, SSE catch-up) triggers one rescan.\n */\nimport type { EffectContext } from '@embedpdf/core';\n\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchState } from './types';\n\nconst RERUN_DELAY_MS = 250;\n\nexport function registerSearchEffects(ctx: EffectContext<SearchState, SearchAction>): void {\n  const doc = ctx.doc;\n  if (!doc) return;\n\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  const unsubscribe = doc.events.subscribe(() => {\n    if (ctx.getState().status === 'idle') return;\n    if (timer !== null) clearTimeout(timer);\n    timer = setTimeout(() => {\n      timer = null;\n      ctx.get(SearchToken).rerun();\n    }, RERUN_DELAY_MS);\n  });\n\n  ctx.cleanup(() => {\n    if (timer !== null) clearTimeout(timer);\n    unsubscribe();\n  });\n}\n","import type { SearchAction, SearchState } from './types';\n\nexport const initialSearchState = (): SearchState => ({\n  query: null,\n  status: 'idle',\n  hits: [],\n  hitsByPage: {},\n  activeIndex: -1,\n  progress: { scanned: 0, total: 0 },\n  error: null,\n});\n\nexport const searchReducer = (state: SearchState, action: SearchAction): SearchState => {\n  switch (action.type) {\n    case 'START':\n      return { ...initialSearchState(), query: action.query, status: 'searching' };\n    case 'APPEND': {\n      if (action.hits.length === 0) {\n        return { ...state, progress: { scanned: action.scanned, total: action.total } };\n      }\n      const hits = state.hits.concat(action.hits);\n      const hitsByPage = { ...state.hitsByPage };\n      for (let i = state.hits.length; i < hits.length; i++) {\n        const pon = hits[i].pon;\n        hitsByPage[pon] = (hitsByPage[pon] ?? []).concat(i);\n      }\n      return {\n        ...state,\n        hits,\n        hitsByPage,\n        // The first hit becomes active (so \"1/N\" reads right) — navigation,\n        // not the stream, moves the camera.\n        activeIndex: state.activeIndex === -1 ? 0 : state.activeIndex,\n        progress: { scanned: action.scanned, total: action.total },\n      };\n    }\n    case 'COMPLETE':\n      return { ...state, status: 'complete' };\n    case 'ERROR':\n      return { ...state, status: 'error', error: action.message };\n    case 'SET_ACTIVE':\n      return { ...state, activeIndex: action.index };\n    case 'CLEAR':\n      return initialSearchState();\n    default:\n      return state;\n  }\n};\n","import { definePlugin } from '@embedpdf/core';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport { createSearchCapability } from './capability';\nimport { registerSearchEffects } from './effects';\nimport { initialSearchState, searchReducer } from './reducer';\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchCapability, SearchPluginConfig, SearchState } from './types';\n\n/**\n * Document text search over `doc.search` — the engine's budgeted,\n * cursor-resumable slices. Document-scoped; no pointer handling, so it\n * needs no interaction hub. The Stage is optional: when present, scans\n * start at the current page (viewport-first) and hit navigation reveals\n * the hit's page; without it the host owns scrolling.\n */\nexport const searchPlugin = (config?: SearchPluginConfig) =>\n  definePlugin<SearchState, SearchAction, SearchCapability>({\n    id: 'search',\n    token: SearchToken,\n    scope: 'document',\n    optional: [StageToken],\n    initialState: initialSearchState,\n    reduce: searchReducer,\n    capability: (ctx) => createSearchCapability(ctx, config),\n    effects: registerSearchEffects,\n  });\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,147 +1,4 @@
-import { PageObjectNumber } from "@embedpdf/core";
-import { Rect } from "@embedpdf/core-geometry";
-import { RevealAnchor, ScrollBehaviorKind } from "@embedpdf/plugin-stage";
-import { SearchMode, SearchQuery, SearchQuery as SearchQuery$1, SearchQueryIssue, SearchQueryValidation, SearchRegexValidation, SearchSnippet, SearchSnippet as SearchSnippet$1, validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
-//#region src/types.d.ts
-/**
- * One match, viewer-shaped: the engine's PDF-space line rects converted to
- * CONTENT space (y-down — the same space selection rects live in), plus the
- * page's display index so navigation can `reveal()` without a lookup.
- * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can
- * later seed a selection or a highlight annotation without re-searching.
- */
-interface SearchHit {
-  pon: PageObjectNumber;
-  pageIndex: number;
-  charStart: number;
-  charCount: number;
-  rects: Rect[];
-  snippet?: SearchSnippet$1;
-}
-/**
- * `searching` means the slice loop is still walking pages — results are
- * usable the moment they appear (matches stream in viewport-first order).
- */
-type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';
-/**
- * Execution options for the session `search()` — HOW the scan runs, never
- * part of what the query MEANS (which is why they're not on `SearchQuery`
- * and are never stored or restored into a search box).
- */
-interface SearchExecOptions {
-  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */
-  startPage?: PageObjectNumber;
-}
-/** Options for the session-free `findAll()` service. */
-interface SearchFindAllOptions {
-  /** Abort the scan; the returned promise rejects with `signal.reason`. */
-  signal?: AbortSignal;
-  /**
-   * Pin the slice mode. Default: `'full'` with automatic `'rects'`
-   * fallback when snippets are denied — pass `'rects'` when you only need
-   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.
-   */
-  mode?: SearchMode;
-}
-interface SearchState {
-  /**
-   * The query in flight/completed, null when idle/cleared — THE stored
-   * form of the search intent, the same flat `SearchQuery` the engine
-   * matches on, the wire caches by, and a search box renders. Survives
-   * any search UI unmounting (results are document-scoped; so is this).
-   */
-  query: SearchQuery$1 | null;
-  status: SearchStatus;
-  hits: SearchHit[];
-  /** pon → indices into `hits` — the per-page layer's read model. */
-  hitsByPage: Record<number, number[]>;
-  /** Index into `hits`, -1 = none. */
-  activeIndex: number;
-  progress: {
-    scanned: number;
-    total: number;
-  };
-  error: string | null;
-}
-type SearchAction = {
-  type: 'START';
-  query: SearchQuery$1;
-} | {
-  type: 'APPEND';
-  hits: SearchHit[];
-  scanned: number;
-  total: number;
-} | {
-  type: 'COMPLETE';
-} | {
-  type: 'ERROR';
-  message: string;
-} | {
-  type: 'SET_ACTIVE';
-  index: number;
-} | {
-  type: 'CLEAR';
-};
-/**
- * How hit navigation arrives (forwarded to the Stage's positioned reveal).
- * The default is the browser find-bar feel: the hit lands at the top-middle
- * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the
- * hit is off-screen, zoom never changes, smooth tween.
- */
-interface SearchRevealOptions {
-  anchor?: RevealAnchor;
-  behavior?: ScrollBehaviorKind;
-}
-interface SearchPluginConfig {
-  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */
-  reveal?: SearchRevealOptions;
-}
-/**
- * The search plugin is a find SERVICE plus one user-visible search SESSION
- * per document. `findAll` is the service; `search` is the session; the
- * sidebar, the highlights layer, and next/prev render the session.
- */
-interface SearchCapability {
-  /**
-   * Start a new search (supersedes and aborts any running one). Results
-   * stream into state slice by slice; the first hit becomes active but the
-   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty
-   * `query.text` is "stop searching" — identical to `clear()`.
-   */
-  search(query: SearchQuery$1, exec?: SearchExecOptions): void;
-  /** Re-run the current query from scratch (used after document mutations). */
-  rerun(): void;
-  clear(): void;
-  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */
-  next(): SearchHit | null;
-  prev(): SearchHit | null;
-  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */
-  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;
-  /** The session's query — what a search box renders. Null when idle. */
-  query(): SearchQuery$1 | null;
-  status(): SearchStatus;
-  hits(): SearchHit[];
-  hitCount(): number;
-  activeIndex(): number;
-  activeHit(): SearchHit | null;
-  /** Hits on one page — the layer's input. Element identity is stable. */
-  hitsForPage(pon: PageObjectNumber): SearchHit[];
-  progress(): {
-    scanned: number;
-    total: number;
-  };
-  errorMessage(): string | null;
-  /**
-   * Run a query to completion and return every hit. Touches NO state — no
-   * sidebar, no highlights, no camera, no activeIndex; the user's visible
-   * search is never superseded. The primitive other features build on
-   * (redact-by-term, link detection, occurrence badges). Scans in natural
-   * page order; concurrent calls are independent.
-   */
-  findAll(query: SearchQuery$1, opts?: SearchFindAllOptions): Promise<SearchHit[]>;
-}
-declare const SearchToken: import("@embedpdf/core").CapabilityToken<SearchCapability>;
-//#endregion
+import { _ as SearchToken, a as SearchSnippet, c as SearchAction, d as SearchFindAllOptions, f as SearchHit, g as SearchStatus, h as SearchState, i as SearchRegexValidation, l as SearchCapability, m as SearchRevealOptions, n as SearchQueryIssue, o as validateSearchQuery, p as SearchPluginConfig, r as SearchQueryValidation, s as validateSearchRegex, t as SearchQuery, u as SearchExecOptions } from "./contract-CSb66POC.cjs";
 //#region src/search.plugin.d.ts
 /**
  * Document text search over `doc.search` — the engine's budgeted,

package/dist/index.d.ts

@@ -1,147 +1,4 @@
-import { PageObjectNumber } from "@embedpdf/core";
-import { RevealAnchor, ScrollBehaviorKind } from "@embedpdf/plugin-stage";
-import { Rect } from "@embedpdf/core-geometry";
-import { SearchMode, SearchQuery, SearchQuery as SearchQuery$1, SearchQueryIssue, SearchQueryValidation, SearchRegexValidation, SearchSnippet, SearchSnippet as SearchSnippet$1, validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
-//#region src/types.d.ts
-/**
- * One match, viewer-shaped: the engine's PDF-space line rects converted to
- * CONTENT space (y-down — the same space selection rects live in), plus the
- * page's display index so navigation can `reveal()` without a lookup.
- * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can
- * later seed a selection or a highlight annotation without re-searching.
- */
-interface SearchHit {
-  pon: PageObjectNumber;
-  pageIndex: number;
-  charStart: number;
-  charCount: number;
-  rects: Rect[];
-  snippet?: SearchSnippet$1;
-}
-/**
- * `searching` means the slice loop is still walking pages — results are
- * usable the moment they appear (matches stream in viewport-first order).
- */
-type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';
-/**
- * Execution options for the session `search()` — HOW the scan runs, never
- * part of what the query MEANS (which is why they're not on `SearchQuery`
- * and are never stored or restored into a search box).
- */
-interface SearchExecOptions {
-  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */
-  startPage?: PageObjectNumber;
-}
-/** Options for the session-free `findAll()` service. */
-interface SearchFindAllOptions {
-  /** Abort the scan; the returned promise rejects with `signal.reason`. */
-  signal?: AbortSignal;
-  /**
-   * Pin the slice mode. Default: `'full'` with automatic `'rects'`
-   * fallback when snippets are denied — pass `'rects'` when you only need
-   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.
-   */
-  mode?: SearchMode;
-}
-interface SearchState {
-  /**
-   * The query in flight/completed, null when idle/cleared — THE stored
-   * form of the search intent, the same flat `SearchQuery` the engine
-   * matches on, the wire caches by, and a search box renders. Survives
-   * any search UI unmounting (results are document-scoped; so is this).
-   */
-  query: SearchQuery$1 | null;
-  status: SearchStatus;
-  hits: SearchHit[];
-  /** pon → indices into `hits` — the per-page layer's read model. */
-  hitsByPage: Record<number, number[]>;
-  /** Index into `hits`, -1 = none. */
-  activeIndex: number;
-  progress: {
-    scanned: number;
-    total: number;
-  };
-  error: string | null;
-}
-type SearchAction = {
-  type: 'START';
-  query: SearchQuery$1;
-} | {
-  type: 'APPEND';
-  hits: SearchHit[];
-  scanned: number;
-  total: number;
-} | {
-  type: 'COMPLETE';
-} | {
-  type: 'ERROR';
-  message: string;
-} | {
-  type: 'SET_ACTIVE';
-  index: number;
-} | {
-  type: 'CLEAR';
-};
-/**
- * How hit navigation arrives (forwarded to the Stage's positioned reveal).
- * The default is the browser find-bar feel: the hit lands at the top-middle
- * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the
- * hit is off-screen, zoom never changes, smooth tween.
- */
-interface SearchRevealOptions {
-  anchor?: RevealAnchor;
-  behavior?: ScrollBehaviorKind;
-}
-interface SearchPluginConfig {
-  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */
-  reveal?: SearchRevealOptions;
-}
-/**
- * The search plugin is a find SERVICE plus one user-visible search SESSION
- * per document. `findAll` is the service; `search` is the session; the
- * sidebar, the highlights layer, and next/prev render the session.
- */
-interface SearchCapability {
-  /**
-   * Start a new search (supersedes and aborts any running one). Results
-   * stream into state slice by slice; the first hit becomes active but the
-   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty
-   * `query.text` is "stop searching" — identical to `clear()`.
-   */
-  search(query: SearchQuery$1, exec?: SearchExecOptions): void;
-  /** Re-run the current query from scratch (used after document mutations). */
-  rerun(): void;
-  clear(): void;
-  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */
-  next(): SearchHit | null;
-  prev(): SearchHit | null;
-  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */
-  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;
-  /** The session's query — what a search box renders. Null when idle. */
-  query(): SearchQuery$1 | null;
-  status(): SearchStatus;
-  hits(): SearchHit[];
-  hitCount(): number;
-  activeIndex(): number;
-  activeHit(): SearchHit | null;
-  /** Hits on one page — the layer's input. Element identity is stable. */
-  hitsForPage(pon: PageObjectNumber): SearchHit[];
-  progress(): {
-    scanned: number;
-    total: number;
-  };
-  errorMessage(): string | null;
-  /**
-   * Run a query to completion and return every hit. Touches NO state — no
-   * sidebar, no highlights, no camera, no activeIndex; the user's visible
-   * search is never superseded. The primitive other features build on
-   * (redact-by-term, link detection, occurrence badges). Scans in natural
-   * page order; concurrent calls are independent.
-   */
-  findAll(query: SearchQuery$1, opts?: SearchFindAllOptions): Promise<SearchHit[]>;
-}
-declare const SearchToken: import("@embedpdf/core").CapabilityToken<SearchCapability>;
-//#endregion
+import { _ as SearchToken, a as SearchSnippet, c as SearchAction, d as SearchFindAllOptions, f as SearchHit, g as SearchStatus, h as SearchState, i as SearchRegexValidation, l as SearchCapability, m as SearchRevealOptions, n as SearchQueryIssue, o as validateSearchQuery, p as SearchPluginConfig, r as SearchQueryValidation, s as validateSearchRegex, t as SearchQuery, u as SearchExecOptions } from "./contract-Cj4xgdMj.js";
 //#region src/search.plugin.d.ts
 /**
  * Document text search over `doc.search` — the engine's budgeted,

package/dist/index.js

@@ -1,7 +1,8 @@
-import { createCapabilityToken, definePlugin } from "@embedpdf/core";
-import { StageToken } from "@embedpdf/plugin-stage";
-import { applyRect, boundsOfRects, pageGeometry } from "@embedpdf/core-geometry";
-import { EngineError, EngineErrorCode, validateSearchQuery, validateSearchRegex } from "@embedpdf/engine-core/runtime";
+import { n as validateSearchRegex, r as SearchToken, t as validateSearchQuery } from "./contract-YzH14CUn.js";
+import { definePlugin } from "@embedpdf/core";
+import { StageToken } from "@embedpdf/plugin-stage/contract";
+import { applyPoint, boundsOfRects, pageGeometry, textQuadBounds } from "@embedpdf/core-geometry";
+import { EngineError, EngineErrorCode } from "@embedpdf/engine-core/runtime";
 //#region src/capability.ts
 const EMPTY = [];
 /** The browser find-bar feel: hit at the top-middle, no zoom change. */
@@ -29,12 +30,6 @@ const isPermissionDenied = (err) => err instanceof Error && err.name === "Permis
 function createSearchCapability(ctx, config = {}) {
 	let generation = 0;
 	let inflight = null;
-	const toContent = (m, b) => applyRect(m, {
-		x: b.left,
-		y: b.bottom,
-		width: b.right - b.left,
-		height: b.top - b.bottom
-	});
 	function hitsFromSlice(slice) {
 		const converters = /* @__PURE__ */ new Map();
 		const converterFor = (pon) => {
@@ -48,9 +43,15 @@ function createSearchCapability(ctx, config = {}) {
 					rotation: layout.rotation,
 					userUnit: layout.userUnit
 				}, 1);
+				const toPoint = (pt) => applyPoint(pdfToContent, pt);
 				conv = {
 					pageIndex: layout.index,
-					toRect: (b) => toContent(pdfToContent, b)
+					toQuad: (q) => ({
+						upperStart: toPoint(q.p1),
+						upperEnd: toPoint(q.p2),
+						lowerStart: toPoint(q.p3),
+						lowerEnd: toPoint(q.p4)
+					})
 				};
 			}
 			converters.set(pon, conv);
@@ -60,12 +61,21 @@ function createSearchCapability(ctx, config = {}) {
 		for (const match of slice.matches) {
 			const conv = converterFor(match.pageObjectNumber);
 			if (!conv) continue;
+			const segments = match.segments.map((segment) => {
+				const quad = conv.toQuad(segment.quad);
+				return {
+					quad,
+					rect: textQuadBounds(quad),
+					advance: segment.advance
+				};
+			});
 			hits.push({
 				pon: match.pageObjectNumber,
 				pageIndex: conv.pageIndex,
 				charStart: match.charStart,
 				charCount: match.charCount,
-				rects: match.rects.map(conv.toRect),
+				segments,
+				...segments.length ? { bounds: boundsOfRects(segments.map((s) => s.rect)) ?? void 0 } : {},
 				...match.snippet ? { snippet: match.snippet } : {}
 			});
 		}
@@ -174,7 +184,7 @@ function createSearchCapability(ctx, config = {}) {
 			...reveal
 		};
 		ctx.tryGet(StageToken)?.reveal(hit.pageIndex, {
-			rect: boundsOfRects(hit.rects) ?? void 0,
+			rect: hit.bounds,
 			anchor: arrival.anchor,
 			behavior: arrival.behavior
 		});
@@ -187,6 +197,11 @@ function createSearchCapability(ctx, config = {}) {
 		ctx.dispatch({ type: "CLEAR" });
 	};
 	return {
+		canSearch: (mode) => {
+			const sec = ctx.doc?.security;
+			if (!sec) return false;
+			return sec.allows("doc.text.search") && (mode !== "full" || sec.allows("doc.text.copy"));
+		},
 		search: (query, exec) => query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),
 		rerun: () => {
 			const { query, status } = ctx.getState();
@@ -239,9 +254,6 @@ function createSearchCapability(ctx, config = {}) {
 	};
 }
 //#endregion
-//#region src/types.ts
-const SearchToken = createCapabilityToken("search");
-//#endregion
 //#region src/effects.ts
 const RERUN_DELAY_MS = 250;
 function registerSearchEffects(ctx) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/capability.ts","../src/types.ts","../src/effects.ts","../src/reducer.ts","../src/search.plugin.ts"],"sourcesContent":["import type { PageObjectNumber, PluginContext } from '@embedpdf/core';\nimport {\n  applyRect,\n  boundsOfRects,\n  pageGeometry,\n  type Rect,\n  type RectIn,\n} from '@embedpdf/core-geometry';\nimport { StageToken } from '@embedpdf/plugin-stage';\nimport { EngineError, EngineErrorCode } from '@embedpdf/engine-core/runtime';\nimport type {\n  PdfRect,\n  SearchMatch,\n  SearchMode,\n  SearchQuery,\n  SearchSlice,\n} from '@embedpdf/engine-core/runtime';\n\nimport type {\n  SearchAction,\n  SearchCapability,\n  SearchHit,\n  SearchPluginConfig,\n  SearchRevealOptions,\n  SearchState,\n} from './types';\n\nconst EMPTY: SearchHit[] = [];\n\n/** The browser find-bar feel: hit at the top-middle, no zoom change. */\nconst DEFAULT_REVEAL: SearchRevealOptions = { anchor: { y: 0.35 }, behavior: 'smooth' };\n\n/** Local engines reject a denied scope before the worker; cloud maps 403. */\nconst isPermissionDenied = (err: unknown): boolean =>\n  (err instanceof Error && err.name === 'PermissionDenied') ||\n  EngineError.is(err, EngineErrorCode.Forbidden);\n\n/**\n * The search capability: a client-driven cursor loop over the engine's\n * budgeted slices. One generation counter arbitrates: a new `search()` (or\n * `clear()`, or a document mutation via `rerun()`) supersedes the running\n * loop, which aborts its in-flight slice and stops dispatching.\n *\n * Rect conversion happens HERE, once per slice: the engine's PDF-space\n * line rects → content space through the same page geometry the selection\n * plugin uses, so search highlights and selection highlights are pixel-twins.\n *\n * Stage integration is optional and additive: with a Stage present the scan\n * starts at the current page (viewport-first — the hits the user is looking\n * at arrive in the first slice) and `next()`/`prev()`/`goTo()` reveal the\n * hit's page. Without one, navigation still works; the host scrolls.\n */\nexport function createSearchCapability(\n  ctx: PluginContext<SearchState, SearchAction>,\n  config: SearchPluginConfig = {},\n): SearchCapability {\n  let generation = 0;\n  let inflight: { abort(reason?: unknown): void } | null = null;\n\n  const toContent = (m: ReturnType<typeof pageGeometry>['pdfToContent'], b: PdfRect): Rect =>\n    applyRect(\n      m as never,\n      {\n        x: b.left,\n        y: b.bottom,\n        width: b.right - b.left,\n        height: b.top - b.bottom,\n      } as RectIn<'pdf'>,\n    ) as Rect;\n\n  interface PageConverter {\n    pageIndex: number;\n    toRect: (b: PdfRect) => Rect;\n  }\n\n  function hitsFromSlice(slice: SearchSlice): SearchHit[] {\n    // zoom = 1: content space is scale-free; the layer applies the page\n    // transform at render time (the selection idiom).\n    const converters = new Map<PageObjectNumber, PageConverter | null>();\n    const converterFor = (pon: PageObjectNumber): PageConverter | null => {\n      let conv = converters.get(pon);\n      if (conv !== undefined) return conv;\n      const layout = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon);\n      if (!layout) {\n        conv = null; // page vanished mid-search (delete); drop its hits\n      } else {\n        const { pdfToContent } = pageGeometry(\n          { crop: layout.boxes.crop, rotation: layout.rotation, userUnit: layout.userUnit },\n          1,\n        );\n        conv = { pageIndex: layout.index, toRect: (b) => toContent(pdfToContent, b) };\n      }\n      converters.set(pon, conv);\n      return conv;\n    };\n\n    const hits: SearchHit[] = [];\n    for (const match of slice.matches) {\n      const conv = converterFor(match.pageObjectNumber);\n      if (!conv) continue;\n      hits.push({\n        pon: match.pageObjectNumber,\n        pageIndex: conv.pageIndex,\n        charStart: match.charStart,\n        charCount: match.charCount,\n        rects: match.rects.map(conv.toRect),\n        ...(match.snippet ? { snippet: match.snippet } : {}),\n      });\n    }\n    return hits;\n  }\n\n  /** How a collect() consumer observes the loop — the session dispatches\n   *  into state, findAll accumulates locally. */\n  interface CollectSink {\n    /** Called before the first slice AND again on a stale-cursor restart —\n     *  reset any accumulation. */\n    onStart: () => void;\n    onSlice: (hits: SearchHit[], scanned: number, total: number) => void;\n    /** Superseded / aborted — the loop stops without completing. */\n    isCancelled: () => boolean;\n    setInflight: (pending: { abort(reason?: unknown): void } | null) => void;\n  }\n\n  /**\n   * THE MECHANISM — one cursor loop over the engine's budgeted slices,\n   * shared by the session (`search`) and the session-free service\n   * (`findAll`): permission fallback ('full' → 'rects' when snippets are\n   * denied, unless the caller pinned a mode), restart-once on a stale\n   * cursor, rect conversion per slice. Resolves true on exhaustion, false\n   * when cancelled; throws on error.\n   */\n  async function collect(\n    query: SearchQuery,\n    opts: { startPage?: PageObjectNumber; mode?: SearchMode },\n    sink: CollectSink,\n  ): Promise<boolean> {\n    const doc = ctx.doc;\n    if (!doc) return false;\n\n    sink.onStart();\n\n    let mode: SearchMode = opts.mode ?? 'full';\n    const modePinned = opts.mode !== undefined;\n    let cursor: string | undefined;\n    let restarted = false;\n    for (;;) {\n      let slice: SearchSlice;\n      try {\n        const request = {\n          query,\n          mode,\n          ...(cursor !== undefined\n            ? { cursor }\n            : opts.startPage !== undefined\n              ? { startPage: opts.startPage }\n              : {}),\n        };\n        const pending = doc.search.query(request);\n        sink.setInflight(pending);\n        slice = await pending;\n      } catch (err) {\n        if (sink.isCancelled()) return false; // superseded — the abort was ours\n        // Snippets denied (no doc.text.copy)? Degrade to rect-only matches\n        // instead of failing the whole search — find still works.\n        if (!modePinned && mode === 'full' && cursor === undefined && isPermissionDenied(err)) {\n          mode = 'rects';\n          continue;\n        }\n        // A stale cursor rejects with InvalidArg — the document changed\n        // under the loop, or the engine's session was recycled. Position\n        // is lost, the query isn't: restart once from scratch.\n        if (cursor !== undefined && !restarted && EngineError.is(err, EngineErrorCode.InvalidArg)) {\n          restarted = true;\n          cursor = undefined;\n          sink.onStart();\n          continue;\n        }\n        throw err;\n      }\n      if (sink.isCancelled()) return false;\n      sink.onSlice(hitsFromSlice(slice), slice.scannedPages, slice.totalPages);\n      if (slice.nextCursor === null) {\n        sink.setInflight(null);\n        return true;\n      }\n      cursor = slice.nextCursor;\n    }\n  }\n\n  /** THE SESSION — collect() with state as the sink, generation-guarded. */\n  async function runSession(query: SearchQuery, startPage?: PageObjectNumber): Promise<void> {\n    const gen = ++generation;\n    inflight?.abort('superseded');\n    inflight = null;\n\n    if (!ctx.doc) {\n      ctx.dispatch({ type: 'CLEAR' });\n      return;\n    }\n\n    // Viewport-first: begin scanning where the user is looking.\n    if (startPage === undefined) {\n      const stage = ctx.tryGet(StageToken);\n      if (stage) startPage = ctx.document()?.pages[stage.currentPage()]?.pageObjectNumber;\n    }\n\n    try {\n      const complete = await collect(\n        query,\n        { startPage },\n        {\n          onStart: () => ctx.dispatch({ type: 'START', query }),\n          onSlice: (hits, scanned, total) => ctx.dispatch({ type: 'APPEND', hits, scanned, total }),\n          isCancelled: () => gen !== generation,\n          setInflight: (pending) => {\n            if (gen === generation) inflight = pending;\n          },\n        },\n      );\n      if (complete && gen === generation) ctx.dispatch({ type: 'COMPLETE' });\n    } catch (err) {\n      if (gen !== generation) return;\n      ctx.dispatch({ type: 'ERROR', message: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  function goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null {\n    const { hits } = ctx.getState();\n    if (hits.length === 0) return null;\n    const wrapped = ((index % hits.length) + hits.length) % hits.length;\n    ctx.dispatch({ type: 'SET_ACTIVE', index: wrapped });\n    const hit = hits[wrapped];\n    // Positioned reveal: the HIT (not just its page) arrives at the anchor —\n    // per-call override > plugin config > find-bar default. Zoom never changes.\n    const arrival = { ...DEFAULT_REVEAL, ...config.reveal, ...reveal };\n    ctx.tryGet(StageToken)?.reveal(hit.pageIndex, {\n      rect: boundsOfRects(hit.rects) ?? undefined,\n      anchor: arrival.anchor,\n      behavior: arrival.behavior,\n    });\n    return hit;\n  }\n\n  const clear = () => {\n    generation++;\n    inflight?.abort('cleared');\n    inflight = null;\n    ctx.dispatch({ type: 'CLEAR' });\n  };\n\n  return {\n    // An empty text is \"stop searching\", not a query — identical to clear().\n    search: (query, exec) =>\n      query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),\n\n    // Replay the stored query verbatim; the rescan starts viewport-first.\n    rerun: () => {\n      const { query, status } = ctx.getState();\n      if (query && status !== 'idle') void runSession(query);\n    },\n\n    clear,\n\n    next: () => goTo(ctx.getState().activeIndex + 1),\n    prev: () => goTo(ctx.getState().activeIndex - 1),\n    goTo,\n\n    query: () => ctx.getState().query,\n\n    findAll: async (query, opts = {}) => {\n      if (!ctx.doc) return [];\n      const all: SearchHit[] = [];\n      const signal = opts.signal;\n      // Independent lifecycle: its own abort handle, never the session's\n      // generation counter — a findAll can neither supersede the user's\n      // visible search nor be superseded by it.\n      let pending: { abort(reason?: unknown): void } | null = null;\n      const onAbort = () => pending?.abort(signal?.reason);\n      signal?.addEventListener('abort', onAbort, { once: true });\n      try {\n        await collect(\n          query,\n          { mode: opts.mode },\n          {\n            onStart: () => {\n              all.length = 0;\n            },\n            onSlice: (hits) => all.push(...hits),\n            isCancelled: () => signal?.aborted ?? false,\n            setInflight: (p) => {\n              pending = p;\n            },\n          },\n        );\n        if (signal?.aborted) throw signal.reason ?? new Error('findAll aborted');\n        return all;\n      } finally {\n        signal?.removeEventListener('abort', onAbort);\n      }\n    },\n\n    status: () => ctx.getState().status,\n    hits: () => ctx.getState().hits,\n    hitCount: () => ctx.getState().hits.length,\n    activeIndex: () => ctx.getState().activeIndex,\n    activeHit: () => {\n      const { hits, activeIndex } = ctx.getState();\n      return activeIndex >= 0 && activeIndex < hits.length ? hits[activeIndex] : null;\n    },\n    hitsForPage: (pon) => {\n      const { hits, hitsByPage } = ctx.getState();\n      const indices = hitsByPage[pon];\n      return indices?.length ? indices.map((i) => hits[i]) : EMPTY;\n    },\n    progress: () => ctx.getState().progress,\n    errorMessage: () => ctx.getState().error,\n  };\n}\n","import { createCapabilityToken, type PageObjectNumber } from '@embedpdf/core';\nimport type { Rect } from '@embedpdf/core-geometry';\nimport type { RevealAnchor, ScrollBehaviorKind } from '@embedpdf/plugin-stage';\nimport type { SearchMode, SearchQuery, SearchSnippet } from '@embedpdf/engine-core/runtime';\n\n/**\n * One match, viewer-shaped: the engine's PDF-space line rects converted to\n * CONTENT space (y-down — the same space selection rects live in), plus the\n * page's display index so navigation can `reveal()` without a lookup.\n * `charStart`/`charCount` keep the engine's text-page offsets, so a hit can\n * later seed a selection or a highlight annotation without re-searching.\n */\nexport interface SearchHit {\n  pon: PageObjectNumber;\n  pageIndex: number;\n  charStart: number;\n  charCount: number;\n  rects: Rect[];\n  snippet?: SearchSnippet;\n}\n\n/**\n * `searching` means the slice loop is still walking pages — results are\n * usable the moment they appear (matches stream in viewport-first order).\n */\nexport type SearchStatus = 'idle' | 'searching' | 'complete' | 'error';\n\n/**\n * Execution options for the session `search()` — HOW the scan runs, never\n * part of what the query MEANS (which is why they're not on `SearchQuery`\n * and are never stored or restored into a search box).\n */\nexport interface SearchExecOptions {\n  /** Scan origin override. Defaults to the Stage's current page (viewport-first). */\n  startPage?: PageObjectNumber;\n}\n\n/** Options for the session-free `findAll()` service. */\nexport interface SearchFindAllOptions {\n  /** Abort the scan; the returned promise rejects with `signal.reason`. */\n  signal?: AbortSignal;\n  /**\n   * Pin the slice mode. Default: `'full'` with automatic `'rects'`\n   * fallback when snippets are denied — pass `'rects'` when you only need\n   * geometry (e.g. redact-by-term) to skip snippet extraction entirely.\n   */\n  mode?: SearchMode;\n}\n\nexport interface SearchState {\n  /**\n   * The query in flight/completed, null when idle/cleared — THE stored\n   * form of the search intent, the same flat `SearchQuery` the engine\n   * matches on, the wire caches by, and a search box renders. Survives\n   * any search UI unmounting (results are document-scoped; so is this).\n   */\n  query: SearchQuery | null;\n  status: SearchStatus;\n  hits: SearchHit[];\n  /** pon → indices into `hits` — the per-page layer's read model. */\n  hitsByPage: Record<number, number[]>;\n  /** Index into `hits`, -1 = none. */\n  activeIndex: number;\n  progress: { scanned: number; total: number };\n  error: string | null;\n}\n\nexport type SearchAction =\n  | { type: 'START'; query: SearchQuery }\n  | { type: 'APPEND'; hits: SearchHit[]; scanned: number; total: number }\n  | { type: 'COMPLETE' }\n  | { type: 'ERROR'; message: string }\n  | { type: 'SET_ACTIVE'; index: number }\n  | { type: 'CLEAR' };\n\n/**\n * How hit navigation arrives (forwarded to the Stage's positioned reveal).\n * The default is the browser find-bar feel: the hit lands at the top-middle\n * of the viewport (`anchor: { y: 0.35 }`), horizontal only moves when the\n * hit is off-screen, zoom never changes, smooth tween.\n */\nexport interface SearchRevealOptions {\n  anchor?: RevealAnchor;\n  behavior?: ScrollBehaviorKind;\n}\n\nexport interface SearchPluginConfig {\n  /** Arrival defaults for `next()`/`prev()`/`goTo()`. */\n  reveal?: SearchRevealOptions;\n}\n\n/**\n * The search plugin is a find SERVICE plus one user-visible search SESSION\n * per document. `findAll` is the service; `search` is the session; the\n * sidebar, the highlights layer, and next/prev render the session.\n */\nexport interface SearchCapability {\n  // ── the session: THE user-visible find, one per document ────────────────\n  /**\n   * Start a new search (supersedes and aborts any running one). Results\n   * stream into state slice by slice; the first hit becomes active but the\n   * camera does NOT move until `next()`/`prev()`/`goTo()`. An empty\n   * `query.text` is \"stop searching\" — identical to `clear()`.\n   */\n  search(query: SearchQuery, exec?: SearchExecOptions): void;\n  /** Re-run the current query from scratch (used after document mutations). */\n  rerun(): void;\n  clear(): void;\n\n  /** Advance to the next/previous hit (wraps) and reveal it (see {@link SearchRevealOptions}). */\n  next(): SearchHit | null;\n  prev(): SearchHit | null;\n  /** Jump to a specific hit index and reveal it; `reveal` overrides the plugin defaults. */\n  goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null;\n\n  /** The session's query — what a search box renders. Null when idle. */\n  query(): SearchQuery | null;\n  status(): SearchStatus;\n  hits(): SearchHit[];\n  hitCount(): number;\n  activeIndex(): number;\n  activeHit(): SearchHit | null;\n  /** Hits on one page — the layer's input. Element identity is stable. */\n  hitsForPage(pon: PageObjectNumber): SearchHit[];\n  progress(): { scanned: number; total: number };\n  errorMessage(): string | null;\n\n  // ── the mechanism: session-free find service ─────────────────────────────\n  /**\n   * Run a query to completion and return every hit. Touches NO state — no\n   * sidebar, no highlights, no camera, no activeIndex; the user's visible\n   * search is never superseded. The primitive other features build on\n   * (redact-by-term, link detection, occurrence badges). Scans in natural\n   * page order; concurrent calls are independent.\n   */\n  findAll(query: SearchQuery, opts?: SearchFindAllOptions): Promise<SearchHit[]>;\n}\n\nexport const SearchToken = createCapabilityToken<SearchCapability>('search');\n","/**\n * Keeps results honest across document mutations. Every confirmed\n * mutation (own or remote) bumps the engine's mutation sequence, which\n * invalidates search cursors AND can change what's findable (redaction,\n * page delete, import). The correct reaction is always the same: re-run\n * the current query from scratch. Reruns are coalesced — a burst of\n * events (multi-part mutation, SSE catch-up) triggers one rescan.\n */\nimport type { EffectContext } from '@embedpdf/core';\n\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchState } from './types';\n\nconst RERUN_DELAY_MS = 250;\n\nexport function registerSearchEffects(ctx: EffectContext<SearchState, SearchAction>): void {\n  const doc = ctx.doc;\n  if (!doc) return;\n\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  const unsubscribe = doc.events.subscribe(() => {\n    if (ctx.getState().status === 'idle') return;\n    if (timer !== null) clearTimeout(timer);\n    timer = setTimeout(() => {\n      timer = null;\n      ctx.get(SearchToken).rerun();\n    }, RERUN_DELAY_MS);\n  });\n\n  ctx.cleanup(() => {\n    if (timer !== null) clearTimeout(timer);\n    unsubscribe();\n  });\n}\n","import type { SearchAction, SearchState } from './types';\n\nexport const initialSearchState = (): SearchState => ({\n  query: null,\n  status: 'idle',\n  hits: [],\n  hitsByPage: {},\n  activeIndex: -1,\n  progress: { scanned: 0, total: 0 },\n  error: null,\n});\n\nexport const searchReducer = (state: SearchState, action: SearchAction): SearchState => {\n  switch (action.type) {\n    case 'START':\n      return { ...initialSearchState(), query: action.query, status: 'searching' };\n    case 'APPEND': {\n      if (action.hits.length === 0) {\n        return { ...state, progress: { scanned: action.scanned, total: action.total } };\n      }\n      const hits = state.hits.concat(action.hits);\n      const hitsByPage = { ...state.hitsByPage };\n      for (let i = state.hits.length; i < hits.length; i++) {\n        const pon = hits[i].pon;\n        hitsByPage[pon] = (hitsByPage[pon] ?? []).concat(i);\n      }\n      return {\n        ...state,\n        hits,\n        hitsByPage,\n        // The first hit becomes active (so \"1/N\" reads right) — navigation,\n        // not the stream, moves the camera.\n        activeIndex: state.activeIndex === -1 ? 0 : state.activeIndex,\n        progress: { scanned: action.scanned, total: action.total },\n      };\n    }\n    case 'COMPLETE':\n      return { ...state, status: 'complete' };\n    case 'ERROR':\n      return { ...state, status: 'error', error: action.message };\n    case 'SET_ACTIVE':\n      return { ...state, activeIndex: action.index };\n    case 'CLEAR':\n      return initialSearchState();\n    default:\n      return state;\n  }\n};\n","import { definePlugin } from '@embedpdf/core';\nimport { StageToken } from '@embedpdf/plugin-stage';\n\nimport { createSearchCapability } from './capability';\nimport { registerSearchEffects } from './effects';\nimport { initialSearchState, searchReducer } from './reducer';\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchCapability, SearchPluginConfig, SearchState } from './types';\n\n/**\n * Document text search over `doc.search` — the engine's budgeted,\n * cursor-resumable slices. Document-scoped; no pointer handling, so it\n * needs no interaction hub. The Stage is optional: when present, scans\n * start at the current page (viewport-first) and hit navigation reveals\n * the hit's page; without it the host owns scrolling.\n */\nexport const searchPlugin = (config?: SearchPluginConfig) =>\n  definePlugin<SearchState, SearchAction, SearchCapability>({\n    id: 'search',\n    token: SearchToken,\n    scope: 'document',\n    optional: [StageToken],\n    initialState: initialSearchState,\n    reduce: searchReducer,\n    capability: (ctx) => createSearchCapability(ctx, config),\n    effects: registerSearchEffects,\n  });\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/capability.ts","../src/effects.ts","../src/reducer.ts","../src/search.plugin.ts"],"sourcesContent":["import type { PageObjectNumber, PluginContext } from '@embedpdf/core';\nimport { type PointIn, type TextQuad, applyPoint, boundsOfRects, pageGeometry, textQuadBounds } from '@embedpdf/core-geometry';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\nimport { EngineError, EngineErrorCode } from '@embedpdf/engine-core/runtime';\nimport type {\n  PdfQuad,\n  PdfRect,\n  SearchMatch,\n  SearchMode,\n  SearchQuery,\n  SearchSlice,\n} from '@embedpdf/engine-core/runtime';\n\nimport type {\n  SearchAction,\n  SearchCapability,\n  SearchHit,\n  SearchPluginConfig,\n  SearchRevealOptions,\n  SearchState,\n} from './types';\n\nconst EMPTY: SearchHit[] = [];\n\n/** The browser find-bar feel: hit at the top-middle, no zoom change. */\nconst DEFAULT_REVEAL: SearchRevealOptions = { anchor: { y: 0.35 }, behavior: 'smooth' };\n\n/** Local engines reject a denied scope before the worker; cloud maps 403. */\nconst isPermissionDenied = (err: unknown): boolean =>\n  (err instanceof Error && err.name === 'PermissionDenied') ||\n  EngineError.is(err, EngineErrorCode.Forbidden);\n\n/**\n * The search capability: a client-driven cursor loop over the engine's\n * budgeted slices. One generation counter arbitrates: a new `search()` (or\n * `clear()`, or a document mutation via `rerun()`) supersedes the running\n * loop, which aborts its in-flight slice and stops dispatching.\n *\n * Rect conversion happens HERE, once per slice: the engine's PDF-space\n * line rects → content space through the same page geometry the selection\n * plugin uses, so search highlights and selection highlights are pixel-twins.\n *\n * Stage integration is optional and additive: with a Stage present the scan\n * starts at the current page (viewport-first — the hits the user is looking\n * at arrive in the first slice) and `next()`/`prev()`/`goTo()` reveal the\n * hit's page. Without one, navigation still works; the host scrolls.\n */\nexport function createSearchCapability(\n  ctx: PluginContext<SearchState, SearchAction>,\n  config: SearchPluginConfig = {},\n): SearchCapability {\n  let generation = 0;\n  let inflight: { abort(reason?: unknown): void } | null = null;\n\n  interface PageConverter {\n    pageIndex: number;\n    toQuad: (q: PdfQuad) => TextQuad;\n  }\n\n  function hitsFromSlice(slice: SearchSlice): SearchHit[] {\n    // zoom = 1: content space is scale-free; the layer applies the page\n    // transform at render time (the selection idiom).\n    const converters = new Map<PageObjectNumber, PageConverter | null>();\n    const converterFor = (pon: PageObjectNumber): PageConverter | null => {\n      let conv = converters.get(pon);\n      if (conv !== undefined) return conv;\n      const layout = ctx.document()?.pages.find((p) => p.pageObjectNumber === pon);\n      if (!layout) {\n        conv = null; // page vanished mid-search (delete); drop its hits\n      } else {\n        const { pdfToContent } = pageGeometry(\n          { crop: layout.boxes.crop, rotation: layout.rotation, userUnit: layout.userUnit },\n          1,\n        );\n        // Engine quads carry frame-geometric slot semantics (p1..p4 =\n        // upper-start, upper-end, lower-start, lower-end) — a trusted\n        // producer, so the y-flip maps corners straight onto their names.\n        const toPoint = (pt: { x: number; y: number }) =>\n          applyPoint(pdfToContent as never, pt as PointIn<'pdf'>) as { x: number; y: number };\n        conv = {\n          pageIndex: layout.index,\n          toQuad: (q) => ({\n            upperStart: toPoint(q.p1),\n            upperEnd: toPoint(q.p2),\n            lowerStart: toPoint(q.p3),\n            lowerEnd: toPoint(q.p4),\n          }),\n        };\n      }\n      converters.set(pon, conv);\n      return conv;\n    };\n\n    const hits: SearchHit[] = [];\n    for (const match of slice.matches) {\n      const conv = converterFor(match.pageObjectNumber);\n      if (!conv) continue;\n      const segments = match.segments.map((segment) => {\n        const quad = conv.toQuad(segment.quad);\n        // `rect` is recomputed from the MAPPED quad so the pair can't drift.\n        return { quad, rect: textQuadBounds(quad), advance: segment.advance };\n      });\n      hits.push({\n        pon: match.pageObjectNumber,\n        pageIndex: conv.pageIndex,\n        charStart: match.charStart,\n        charCount: match.charCount,\n        segments,\n        ...(segments.length\n          ? { bounds: boundsOfRects(segments.map((s) => s.rect)) ?? undefined }\n          : {}),\n        ...(match.snippet ? { snippet: match.snippet } : {}),\n      });\n    }\n    return hits;\n  }\n\n  /** How a collect() consumer observes the loop — the session dispatches\n   *  into state, findAll accumulates locally. */\n  interface CollectSink {\n    /** Called before the first slice AND again on a stale-cursor restart —\n     *  reset any accumulation. */\n    onStart: () => void;\n    onSlice: (hits: SearchHit[], scanned: number, total: number) => void;\n    /** Superseded / aborted — the loop stops without completing. */\n    isCancelled: () => boolean;\n    setInflight: (pending: { abort(reason?: unknown): void } | null) => void;\n  }\n\n  /**\n   * THE MECHANISM — one cursor loop over the engine's budgeted slices,\n   * shared by the session (`search`) and the session-free service\n   * (`findAll`): permission fallback ('full' → 'rects' when snippets are\n   * denied, unless the caller pinned a mode), restart-once on a stale\n   * cursor, rect conversion per slice. Resolves true on exhaustion, false\n   * when cancelled; throws on error.\n   */\n  async function collect(\n    query: SearchQuery,\n    opts: { startPage?: PageObjectNumber; mode?: SearchMode },\n    sink: CollectSink,\n  ): Promise<boolean> {\n    const doc = ctx.doc;\n    if (!doc) return false;\n\n    sink.onStart();\n\n    let mode: SearchMode = opts.mode ?? 'full';\n    const modePinned = opts.mode !== undefined;\n    let cursor: string | undefined;\n    let restarted = false;\n    for (;;) {\n      let slice: SearchSlice;\n      try {\n        const request = {\n          query,\n          mode,\n          ...(cursor !== undefined\n            ? { cursor }\n            : opts.startPage !== undefined\n              ? { startPage: opts.startPage }\n              : {}),\n        };\n        const pending = doc.search.query(request);\n        sink.setInflight(pending);\n        slice = await pending;\n      } catch (err) {\n        if (sink.isCancelled()) return false; // superseded — the abort was ours\n        // Snippets denied (no doc.text.copy)? Degrade to rect-only matches\n        // instead of failing the whole search — find still works.\n        if (!modePinned && mode === 'full' && cursor === undefined && isPermissionDenied(err)) {\n          mode = 'rects';\n          continue;\n        }\n        // A stale cursor rejects with InvalidArg — the document changed\n        // under the loop, or the engine's session was recycled. Position\n        // is lost, the query isn't: restart once from scratch.\n        if (cursor !== undefined && !restarted && EngineError.is(err, EngineErrorCode.InvalidArg)) {\n          restarted = true;\n          cursor = undefined;\n          sink.onStart();\n          continue;\n        }\n        throw err;\n      }\n      if (sink.isCancelled()) return false;\n      sink.onSlice(hitsFromSlice(slice), slice.scannedPages, slice.totalPages);\n      if (slice.nextCursor === null) {\n        sink.setInflight(null);\n        return true;\n      }\n      cursor = slice.nextCursor;\n    }\n  }\n\n  /** THE SESSION — collect() with state as the sink, generation-guarded. */\n  async function runSession(query: SearchQuery, startPage?: PageObjectNumber): Promise<void> {\n    const gen = ++generation;\n    inflight?.abort('superseded');\n    inflight = null;\n\n    if (!ctx.doc) {\n      ctx.dispatch({ type: 'CLEAR' });\n      return;\n    }\n\n    // Viewport-first: begin scanning where the user is looking.\n    if (startPage === undefined) {\n      const stage = ctx.tryGet(StageToken);\n      if (stage) startPage = ctx.document()?.pages[stage.currentPage()]?.pageObjectNumber;\n    }\n\n    try {\n      const complete = await collect(\n        query,\n        { startPage },\n        {\n          onStart: () => ctx.dispatch({ type: 'START', query }),\n          onSlice: (hits, scanned, total) => ctx.dispatch({ type: 'APPEND', hits, scanned, total }),\n          isCancelled: () => gen !== generation,\n          setInflight: (pending) => {\n            if (gen === generation) inflight = pending;\n          },\n        },\n      );\n      if (complete && gen === generation) ctx.dispatch({ type: 'COMPLETE' });\n    } catch (err) {\n      if (gen !== generation) return;\n      ctx.dispatch({ type: 'ERROR', message: err instanceof Error ? err.message : String(err) });\n    }\n  }\n\n  function goTo(index: number, reveal?: SearchRevealOptions): SearchHit | null {\n    const { hits } = ctx.getState();\n    if (hits.length === 0) return null;\n    const wrapped = ((index % hits.length) + hits.length) % hits.length;\n    ctx.dispatch({ type: 'SET_ACTIVE', index: wrapped });\n    const hit = hits[wrapped];\n    // Positioned reveal: the HIT (not just its page) arrives at the anchor —\n    // per-call override > plugin config > find-bar default. Zoom never changes.\n    const arrival = { ...DEFAULT_REVEAL, ...config.reveal, ...reveal };\n    ctx.tryGet(StageToken)?.reveal(hit.pageIndex, {\n      rect: hit.bounds,\n      anchor: arrival.anchor,\n      behavior: arrival.behavior,\n    });\n    return hit;\n  }\n\n  const clear = () => {\n    generation++;\n    inflight?.abort('cleared');\n    inflight = null;\n    ctx.dispatch({ type: 'CLEAR' });\n  };\n\n  return {\n    // The twin. Search is a pure request, so the VERBS carry no client gate\n    // (the engine enforces; the ERROR state reports) — the twin exists for\n    // affordance hiding. 'full' composes both capabilities because a snippet\n    // reproduces document text; the session's own degradation means plain\n    // `canSearch()` is exactly \"would `search()` produce hits\".\n    canSearch: (mode) => {\n      const sec = ctx.doc?.security;\n      if (!sec) return false;\n      return sec.allows('doc.text.search') && (mode !== 'full' || sec.allows('doc.text.copy'));\n    },\n\n    // An empty text is \"stop searching\", not a query — identical to clear().\n    search: (query, exec) =>\n      query.text.length === 0 ? clear() : void runSession(query, exec?.startPage),\n\n    // Replay the stored query verbatim; the rescan starts viewport-first.\n    rerun: () => {\n      const { query, status } = ctx.getState();\n      if (query && status !== 'idle') void runSession(query);\n    },\n\n    clear,\n\n    next: () => goTo(ctx.getState().activeIndex + 1),\n    prev: () => goTo(ctx.getState().activeIndex - 1),\n    goTo,\n\n    query: () => ctx.getState().query,\n\n    findAll: async (query, opts = {}) => {\n      if (!ctx.doc) return [];\n      const all: SearchHit[] = [];\n      const signal = opts.signal;\n      // Independent lifecycle: its own abort handle, never the session's\n      // generation counter — a findAll can neither supersede the user's\n      // visible search nor be superseded by it.\n      let pending: { abort(reason?: unknown): void } | null = null;\n      const onAbort = () => pending?.abort(signal?.reason);\n      signal?.addEventListener('abort', onAbort, { once: true });\n      try {\n        await collect(\n          query,\n          { mode: opts.mode },\n          {\n            onStart: () => {\n              all.length = 0;\n            },\n            onSlice: (hits) => all.push(...hits),\n            isCancelled: () => signal?.aborted ?? false,\n            setInflight: (p) => {\n              pending = p;\n            },\n          },\n        );\n        if (signal?.aborted) throw signal.reason ?? new Error('findAll aborted');\n        return all;\n      } finally {\n        signal?.removeEventListener('abort', onAbort);\n      }\n    },\n\n    status: () => ctx.getState().status,\n    hits: () => ctx.getState().hits,\n    hitCount: () => ctx.getState().hits.length,\n    activeIndex: () => ctx.getState().activeIndex,\n    activeHit: () => {\n      const { hits, activeIndex } = ctx.getState();\n      return activeIndex >= 0 && activeIndex < hits.length ? hits[activeIndex] : null;\n    },\n    hitsForPage: (pon) => {\n      const { hits, hitsByPage } = ctx.getState();\n      const indices = hitsByPage[pon];\n      return indices?.length ? indices.map((i) => hits[i]) : EMPTY;\n    },\n    progress: () => ctx.getState().progress,\n    errorMessage: () => ctx.getState().error,\n  };\n}\n","/**\n * Keeps results honest across document mutations. Every confirmed\n * mutation (own or remote) bumps the engine's mutation sequence, which\n * invalidates search cursors AND can change what's findable (redaction,\n * page delete, import). The correct reaction is always the same: re-run\n * the current query from scratch. Reruns are coalesced — a burst of\n * events (multi-part mutation, SSE catch-up) triggers one rescan.\n */\nimport type { EffectContext } from '@embedpdf/core';\n\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchState } from './types';\n\nconst RERUN_DELAY_MS = 250;\n\nexport function registerSearchEffects(ctx: EffectContext<SearchState, SearchAction>): void {\n  const doc = ctx.doc;\n  if (!doc) return;\n\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  const unsubscribe = doc.events.subscribe(() => {\n    if (ctx.getState().status === 'idle') return;\n    if (timer !== null) clearTimeout(timer);\n    timer = setTimeout(() => {\n      timer = null;\n      ctx.get(SearchToken).rerun();\n    }, RERUN_DELAY_MS);\n  });\n\n  ctx.cleanup(() => {\n    if (timer !== null) clearTimeout(timer);\n    unsubscribe();\n  });\n}\n","import type { SearchAction, SearchState } from './types';\n\nexport const initialSearchState = (): SearchState => ({\n  query: null,\n  status: 'idle',\n  hits: [],\n  hitsByPage: {},\n  activeIndex: -1,\n  progress: { scanned: 0, total: 0 },\n  error: null,\n});\n\nexport const searchReducer = (state: SearchState, action: SearchAction): SearchState => {\n  switch (action.type) {\n    case 'START':\n      return { ...initialSearchState(), query: action.query, status: 'searching' };\n    case 'APPEND': {\n      if (action.hits.length === 0) {\n        return { ...state, progress: { scanned: action.scanned, total: action.total } };\n      }\n      const hits = state.hits.concat(action.hits);\n      const hitsByPage = { ...state.hitsByPage };\n      for (let i = state.hits.length; i < hits.length; i++) {\n        const pon = hits[i].pon;\n        hitsByPage[pon] = (hitsByPage[pon] ?? []).concat(i);\n      }\n      return {\n        ...state,\n        hits,\n        hitsByPage,\n        // The first hit becomes active (so \"1/N\" reads right) — navigation,\n        // not the stream, moves the camera.\n        activeIndex: state.activeIndex === -1 ? 0 : state.activeIndex,\n        progress: { scanned: action.scanned, total: action.total },\n      };\n    }\n    case 'COMPLETE':\n      return { ...state, status: 'complete' };\n    case 'ERROR':\n      return { ...state, status: 'error', error: action.message };\n    case 'SET_ACTIVE':\n      return { ...state, activeIndex: action.index };\n    case 'CLEAR':\n      return initialSearchState();\n    default:\n      return state;\n  }\n};\n","import { definePlugin } from '@embedpdf/core';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport { createSearchCapability } from './capability';\nimport { registerSearchEffects } from './effects';\nimport { initialSearchState, searchReducer } from './reducer';\nimport { SearchToken } from './types';\nimport type { SearchAction, SearchCapability, SearchPluginConfig, SearchState } from './types';\n\n/**\n * Document text search over `doc.search` — the engine's budgeted,\n * cursor-resumable slices. Document-scoped; no pointer handling, so it\n * needs no interaction hub. The Stage is optional: when present, scans\n * start at the current page (viewport-first) and hit navigation reveals\n * the hit's page; without it the host owns scrolling.\n */\nexport const searchPlugin = (config?: SearchPluginConfig) =>\n  definePlugin<SearchState, SearchAction, SearchCapability>({\n    id: 'search',\n    token: SearchToken,\n    scope: 'document',\n    optional: [StageToken],\n    initialState: initialSearchState,\n    reduce: searchReducer,\n    capability: (ctx) => createSearchCapability(ctx, config),\n    effects: registerSearchEffects,\n  });\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-search",
-  "version": "3.0.0-next.1",
+  "version": "3.0.0-next.11",
   "private": false,
   "description": "Document text search: drives the engine's budgeted search slices, converts match rects to content space, and integrates with the Stage for viewport-first scanning and reveal-on-navigate.",
   "type": "module",
@@ -12,16 +12,20 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./contract": {
+      "import": "./dist/contract.js",
+      "require": "./dist/contract.cjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@embedpdf/core": "3.0.0-next.1",
-    "@embedpdf/plugin-stage": "3.0.0-next.1",
-    "@embedpdf/core-geometry": "3.0.0-next.1",
-    "@embedpdf/engine-core": "3.0.0-next.1"
+    "@embedpdf/plugin-stage": "3.0.0-next.11",
+    "@embedpdf/core-geometry": "3.0.0-next.11",
+    "@embedpdf/engine-core": "3.0.0-next.11",
+    "@embedpdf/core": "3.0.0-next.11"
   },
   "devDependencies": {
     "typescript": "^5.0.0",