@nivaro/react 0.3.32 → 0.3.34

package/dist/hooks/useSessionRecorder.js

@@ -9,7 +9,7 @@ import { noteReplayEvent as _e, createReplayCheckoutState as De } from "../share
 import { emitReplayTap as Te, setReplayRecorderMode as N, registerReplayCapture as qe, clipEndOffset as Le, withClipKind as Pe } from "../shared/lib/replay-capture.js";
 import { instrumentConsole as Ne, instrumentRequests as Fe, redactSecrets as Me } from "../shared/lib/replay-context.js";
 import { instrumentSocket as Oe } from "../shared/lib/replay-socket.js";
-const Ue = "nivaro-react@0.3.32", j = 1e4, We = 150, He = 3e3, Ke = 600, $e = (n) => `nvr_replay_resume${n ? `:${n}` : ""}`, G = () => typeof navigator > "u" || navigator.onLine !== !1;
+const Ue = "nivaro-react@0.3.34", j = 1e4, We = 150, He = 3e3, Ke = 600, $e = (n) => `nvr_replay_resume${n ? `:${n}` : ""}`, G = () => typeof navigator > "u" || navigator.onLine !== !1;
 function Be(n) {
   return typeof n.url != "string" || typeof fetch != "function" ? null : (f, a) => {
     const u = typeof n.getToken == "function" ? n.getToken() : void 0, d = { "Content-Type": "application/json" };

package/dist/index.d.ts

@@ -2851,6 +2851,9 @@ export declare interface EventPathSheetProps {
 
 declare type EventStatus = 'ok' | 'error' | 'info';
 
+/** Each token with its alternatives (itself first, then every synonym it shares a group with). */
+export declare function expandTokens(tokens: string[], synonyms?: SynonymGroups): string[][];
+
 export declare type ExprNode = {
     kind: 'number';
     value: number;
@@ -3202,6 +3205,9 @@ export declare function focusRecordTarget(target: {
     rowId?: string;
 }): void;
 
+/** Case- and accent-folded text. */
+export declare function foldSearchText(text: string): string;
+
 /** A press of Expand all or Collapse all; `seq` changes on every press. */
 declare interface FoldSignal {
     open: boolean;
@@ -4093,6 +4099,18 @@ declare interface HelpVideoWhatsNew {
     whole: boolean;
 }
 
+export declare interface HighlightPart {
+    text: string;
+    match: boolean;
+}
+
+/**
+ * The text split into matched / unmatched runs for every token and synonym
+ * found in it. Overlapping or touching matches merge into one run. No query,
+ * or nothing found, returns the whole text as one unmatched part.
+ */
+export declare function highlightParts(text: string | null | undefined, q: string | null | undefined, opts?: SearchTextOptions): HighlightPart[];
+
 /** A held frame (#1537): the edited timeline freezes on the source frame at
  *  `at_ms` for `hold_ms` (edited time, 0.2–10 s). Extra edited time with no
  *  source advance, like 0.5x slow motion; everything on screen at that moment
@@ -5003,6 +5021,8 @@ export declare function isCodeError(err: unknown): boolean;
  */
 export declare function isListTimeout(err: unknown): boolean;
 
+export declare function isReloadingForUpdate(): boolean;
+
 /** True once a 401 said this tab is signed out, until a sign-in is heard. */
 export declare function isSignedOut(): boolean;
 
@@ -5040,11 +5060,6 @@ export declare type ItemEditAuthContextValue = {
     userId: string;
 };
 
-/**
- * The record form. With `design` (the layout editor's canvas) the whole form —
- * its own hooks included — runs inside DesignCanvas: a client that cannot
- * write, no realtime, inert inputs, selectable shells.
- */
 export declare function ItemEditForm(props: ItemEditFormProps): JSX.Element;
 
 export declare interface ItemEditFormProps {
@@ -5820,6 +5835,12 @@ declare type MatchedDrawerConfig = {
     defaults?: Record<string, unknown>;
 };
 
+/**
+ * Every token (or one of its synonyms) occurs in the text. An empty query
+ * matches everything — same contract as `matchesAllTokens`.
+ */
+export declare function matchesSearch(text: string | null | undefined, q: string | null | undefined, opts?: SearchTextOptions): boolean;
+
 /** Match a filter surface (by its own key and/or its options collection) to a
  *  scope dimension. Convention: key === dimension name wins, else the filter's
  *  options collection === the dimension's target collection. */
@@ -8490,7 +8511,7 @@ export declare function registerReplayCapture(fn: Capture, snap?: Snapshot): ()
 export declare function registerRoomOpener(fn: RoomOpener): () => void;
 
 /** Report a source of unsaved work; the returned function removes it. */
-export declare function registerUnsavedWork(label: string, dirty: () => boolean): () => void;
+export declare function registerUnsavedWork(label: string, dirty: () => boolean, opts?: UnsavedWorkOptions): () => void;
 
 /** Register the host's opener. Returns an unregister function. */
 export declare function registerViewAsOpener(fn: ViewAsOpener): () => void;
@@ -9142,6 +9163,36 @@ declare interface ScopeDimensionLite {
     display_field?: string | null;
 }
 
+/**
+ * Text with the typed search marked (lib/search-text.ts `highlightParts`):
+ * every token and synonym, case- and accent-insensitive. The mark keeps the
+ * text's own colour and only tints behind it (the admin palette's treatment),
+ * so it reads in light and dark alike. No query = the plain text.
+ */
+export declare function SearchHighlight({ text, query, synonyms, className, markClassName }: {
+    text: string | null | undefined;
+    query: string | null | undefined;
+    synonyms?: SynonymGroups;
+    className?: string;
+    markClassName?: string;
+}): JSX.Element;
+
+/**
+ * The API's `search_rank=1` tier for one row, from its searched values in
+ * request order (`values[0]` = the primary column, e.g. the item number):
+ * 0 primary equals the text · 1 another column equals it · 2 primary starts
+ * with it · 3 another column starts with it · 4 every word starts a word of
+ * some column (start, or after a non-letter/digit) · 5 anything else.
+ * Case-insensitive like the database collation; accents are compared as-is
+ * (SQL Server *_CI_AS), so this never folds them.
+ */
+export declare function searchRankTier(values: ReadonlyArray<unknown>, q: string | null | undefined): number;
+
+export declare interface SearchTextOptions {
+    /** Groups of interchangeable words/phrases; a token in a group also matches the rest. */
+    synonyms?: SynonymGroups;
+}
+
 export declare type SectionState = {
     isCollapsed: (key: string) => boolean;
     toggle: (key: string) => void;
@@ -9877,6 +9928,28 @@ export declare function SupportView({ initialTicketId, onTicketChange, className
     className?: string;
 }): JSX.Element;
 
+/**
+ * One search-text vocabulary for every client surface that matches typed text
+ * against labels: pickers (RelationCombobox, CatalogPickerField), the command
+ * palettes and full search pages (2026-10-28 search program, item 22).
+ *
+ * - `tokenize(q)`: words, lower-cased and accent-folded; "quoted phrases" stay
+ *   one token. Duplicates drop.
+ * - `matchesSearch(text, q)`: every token (or one of its synonyms) is a
+ *   substring of the text — `matchesAllTokens` (lib/utils.ts) semantics, plus
+ *   accent folding, phrases and synonyms.
+ * - `highlightParts(text, q)`: the text cut into matched / unmatched parts for
+ *   rendering `<mark>`s (multi-token, case- and accent-insensitive, overlaps
+ *   merged, indices mapped back to the ORIGINAL text).
+ * - Synonyms are a hook, never fetched here: pass `synonyms` (groups of
+ *   interchangeable words, e.g. the search-analytics synonym list the server's
+ *   `searchPhrases` reads) and each token also matches the others in its group.
+ *
+ * `searchRankTier` is the client twin of the API's `search_rank=1` ORDER BY
+ * (api/src/services/list-search-rank.ts) — change both together.
+ */
+export declare type SynonymGroups = ReadonlyArray<ReadonlyArray<string>>;
+
 declare type TabKey = 'catalog' | 'rules' | 'subscriptions' | 'history' | 'widget_alerts' | 'widget_alert_history' | 'anomaly_rules' | 'anomaly_history';
 
 export declare type TabState = {
@@ -10023,6 +10096,9 @@ export declare function TipLayer(): ReactPortal | null;
 
 export declare function titleCase(str: string): string;
 
+/** Typed text → tokens: whitespace-split words, "quoted phrases" kept whole; folded, unique. */
+export declare function tokenize(q: string | null | undefined): string[];
+
 export declare type TokenResolver = (path: string) => unknown;
 
 declare type Tone = 'accent' | 'warning' | 'neutral';
@@ -10182,6 +10258,10 @@ declare interface UnsavedSummary {
 /** What would be lost, by label (empty = nothing). */
 export declare function unsavedWorkLabels(): string[];
 
+declare interface UnsavedWorkOptions {
+    saveForReload?: () => boolean | Promise<boolean>;
+}
+
 /** The ids an update covers: one, a coalesced list, or null = "too many — refresh it all". */
 export declare function updateItemIds(ev: CollectionUpdateEvent): Array<string | number> | null;
 
@@ -11079,8 +11159,9 @@ export declare function useTypingIndicator(room: string | null): {
 
 export declare function useUnreadChirp(totalUnread: number, rooms?: RoomInfo[]): void;
 
-/** A form reports its dirty state while mounted. */
-export declare function useUnsavedWork(dirty: boolean, label?: string): void;
+/** A form reports its dirty state while mounted (and, optionally, how to keep it through a
+ *  pushed reload — the latest function is always the one called). */
+export declare function useUnsavedWork(dirty: boolean, label?: string, saveForReload?: () => boolean | Promise<boolean>): void;
 
 /** Directory of users to add to a private channel. */
 export declare function useUserSearch(search: string, enabled: boolean): {