@parhelia/core 0.4.12800 → 0.4.12825

package/dist/editor/find-replace/findReplaceCommand.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Replace } from "lucide-react";
+import { findReplaceStore } from "./findReplaceStore";
+/**
+ * Ctrl+H opens the "Find and replace" popover in the toolbar (see
+ * menubar/toolbar-sections/FindReplaceControls). The binding is allowed
+ * while typing because that is where the shortcut is usually pressed, and it
+ * must cancel the browser's own Ctrl+H (history).
+ */
+export const findReplaceCommand = {
+    id: "findReplace",
+    label: "Find and replace",
+    icon: _jsx(Replace, { strokeWidth: 1 }),
+    keyBinding: { key: "h", ctrlOrMeta: true },
+    allowWhileTyping: true,
+    disabled: (context) => context.editContext.mode !== "edit" ||
+        (!context.editContext.page &&
+            !context.editContext.item &&
+            !context.editContext.currentItemDescriptor),
+    execute: async (context) => {
+        const selectedText = context.editContext.selectedRange?.text?.trim();
+        findReplaceStore.open(selectedText && !selectedText.includes("\n") ? selectedText : undefined);
+    },
+};
+//# sourceMappingURL=findReplaceCommand.js.map

package/dist/editor/find-replace/findReplaceCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findReplaceCommand.js","sourceRoot":"","sources":["../../../src/editor/find-replace/findReplaceCommand.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAOvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,kBAAkB;IACzB,IAAI,EAAE,KAAC,OAAO,IAAC,WAAW,EAAE,CAAC,GAAI;IACjC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IAC1C,gBAAgB,EAAE,IAAI;IACtB,QAAQ,EAAE,CAAC,OAAoC,EAAE,EAAE,CACjD,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM;QACnC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;YACxB,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI;YACzB,CAAC,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC;IAC/C,OAAO,EAAE,KAAK,EAAE,OAAoC,EAAE,EAAE;QACtD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACrE,gBAAgB,CAAC,IAAI,CACnB,YAAY,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CACxE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/editor/find-replace/findReplaceMatches.d.ts

@@ -0,0 +1,42 @@
+import type { FieldDescriptor, ItemDescriptor } from "../pageModel";
+import type { FindReplaceFieldTarget } from "./findReplaceTargets";
+/**
+ * Entry in the bridge geometry union. The editing host keeps the latest text
+ * ranges per source, so this name must stay unique among overlay features.
+ */
+export declare const FIND_REPLACE_BRIDGE_SOURCE = "find-replace";
+export declare function getFindReplaceTextRangeKey(targetKey: string, matchIndex: number): string;
+/** One occurrence of the search text, addressed in rendered-text offsets. */
+export type FindReplaceMatch = {
+    /** Bridge text-range key; unique per match. */
+    key: string;
+    /** `fieldKey(field)`: groups matches by field. */
+    targetKey: string;
+    field: FieldDescriptor;
+    item: ItemDescriptor;
+    /** Component that renders the field on the canvas, when known. */
+    componentId?: string;
+    /** Index of this match within its field (0-based). */
+    occurrence: number;
+    /** Offsets into the rendered plain text of the field (tags stripped). */
+    start: number;
+    end: number;
+};
+/**
+ * Turns an HTML value into the plain text the canvas renders, which is the
+ * offset space the bridge measures text ranges in (`element.textContent`).
+ * Falls back to a tag strip where DOMParser is unavailable (tests).
+ */
+export declare function toRenderedText(value: string, fieldType: string | undefined): string;
+/**
+ * Lists every match of `find` inside the planned targets, in target order,
+ * as rendered-text ranges the canvas overlay can highlight and scroll to.
+ */
+export declare function collectFindReplaceMatches(targets: FindReplaceFieldTarget[], find: RegExp | undefined): FindReplaceMatch[];
+export declare function toBridgeTextRange(match: FindReplaceMatch): {
+    key: string;
+    fieldId: string;
+    item: ItemDescriptor;
+    start: number;
+    end: number;
+};

package/dist/editor/find-replace/findReplaceMatches.js

@@ -0,0 +1,66 @@
+import { fieldKey } from "../version-diff/versionDiffTargets";
+import { isHtmlFieldType } from "./findReplaceText";
+/**
+ * Entry in the bridge geometry union. The editing host keeps the latest text
+ * ranges per source, so this name must stay unique among overlay features.
+ */
+export const FIND_REPLACE_BRIDGE_SOURCE = "find-replace";
+export function getFindReplaceTextRangeKey(targetKey, matchIndex) {
+    return `find-replace:${targetKey}:m${matchIndex}`;
+}
+/**
+ * Turns an HTML value into the plain text the canvas renders, which is the
+ * offset space the bridge measures text ranges in (`element.textContent`).
+ * Falls back to a tag strip where DOMParser is unavailable (tests).
+ */
+export function toRenderedText(value, fieldType) {
+    if (!isHtmlFieldType(fieldType) || !value.includes("<"))
+        return value;
+    if (typeof DOMParser === "undefined")
+        return value.replace(/<[^>]*>/g, "");
+    return (new DOMParser().parseFromString(value, "text/html").body.textContent ?? "");
+}
+/**
+ * Lists every match of `find` inside the planned targets, in target order,
+ * as rendered-text ranges the canvas overlay can highlight and scroll to.
+ */
+export function collectFindReplaceMatches(targets, find) {
+    if (!find)
+        return [];
+    const matches = [];
+    targets.forEach((target) => {
+        const text = toRenderedText(target.value, target.field.type);
+        const targetKey = fieldKey(target.field.descriptor);
+        find.lastIndex = 0;
+        let occurrence = 0;
+        for (const match of text.matchAll(find)) {
+            const start = match.index ?? 0;
+            const end = start + match[0].length;
+            if (end <= start)
+                continue;
+            matches.push({
+                key: getFindReplaceTextRangeKey(targetKey, occurrence),
+                targetKey,
+                field: target.field.descriptor,
+                item: target.field.descriptor.item,
+                componentId: target.source.componentId,
+                occurrence,
+                start,
+                end,
+            });
+            occurrence += 1;
+        }
+        find.lastIndex = 0;
+    });
+    return matches;
+}
+export function toBridgeTextRange(match) {
+    return {
+        key: match.key,
+        fieldId: match.field.fieldId,
+        item: match.item,
+        start: match.start,
+        end: match.end,
+    };
+}
+//# sourceMappingURL=findReplaceMatches.js.map

package/dist/editor/find-replace/findReplaceMatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findReplaceMatches.js","sourceRoot":"","sources":["../../../src/editor/find-replace/findReplaceMatches.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC;AAEzD,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,UAAkB;IAElB,OAAO,gBAAgB,SAAS,KAAK,UAAU,EAAE,CAAC;AACpD,CAAC;AAmBD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,SAA6B;IACzE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3E,OAAO,CACL,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAC3E,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAiC,EACjC,IAAwB;IAExB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YAC/B,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACpC,IAAI,GAAG,IAAI,KAAK;gBAAE,SAAS;YAC3B,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE,0BAA0B,CAAC,SAAS,EAAE,UAAU,CAAC;gBACtD,SAAS;gBACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;gBAC9B,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI;gBAClC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW;gBACtC,UAAU;gBACV,KAAK;gBACL,GAAG;aACJ,CAAC,CAAC;YACH,UAAU,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/editor/find-replace/findReplaceStore.d.ts

@@ -0,0 +1,30 @@
+import type { FindReplaceMatch } from "./findReplaceMatches";
+/** What the canvas overlay paints: every match, and which one is current. */
+export type FindReplaceHighlighting = {
+    matches: FindReplaceMatch[];
+    activeIndex: number;
+};
+export type FindReplaceState = {
+    open: boolean;
+    /**
+     * Search text to seed the panel with; bumped `openRequest` tells the panel a
+     * fresh open happened (so Ctrl+H re-focuses the search box even when the
+     * panel was already open).
+     */
+    initialFind: string;
+    openRequest: number;
+    highlighting: FindReplaceHighlighting | null;
+};
+type Listener = () => void;
+export declare const findReplaceStore: {
+    getState: () => FindReplaceState;
+    subscribe: (listener: Listener) => () => void;
+    open: (initialFind?: string) => void;
+    close: () => void;
+    toggle: (initialFind?: string) => void;
+    setHighlighting: (highlighting: FindReplaceHighlighting | null) => void;
+    /** Test seam: reset to the initial state. */
+    reset: () => void;
+};
+export declare function useFindReplaceState(): FindReplaceState;
+export {};

package/dist/editor/find-replace/findReplaceStore.js

@@ -0,0 +1,61 @@
+import { useSyncExternalStore } from "react";
+/**
+ * Tiny external store shared by the toolbar button (which owns the popover),
+ * the Ctrl+H command and the canvas highlight overlay. They sit far apart in
+ * the tree, and none of this state belongs in the persisted edit context.
+ */
+function createFindReplaceStore() {
+    let state = {
+        open: false,
+        initialFind: "",
+        openRequest: 0,
+        highlighting: null,
+    };
+    const listeners = new Set();
+    const setState = (patch) => {
+        state = { ...state, ...patch };
+        listeners.forEach((listener) => listener());
+    };
+    return {
+        getState: () => state,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        open: (initialFind) => setState({
+            open: true,
+            initialFind: initialFind ?? state.initialFind,
+            openRequest: state.openRequest + 1,
+        }),
+        close: () => setState({ open: false, highlighting: null }),
+        toggle: (initialFind) => {
+            if (state.open)
+                setState({ open: false, highlighting: null });
+            else
+                setState({
+                    open: true,
+                    initialFind: initialFind ?? state.initialFind,
+                    openRequest: state.openRequest + 1,
+                });
+        },
+        setHighlighting: (highlighting) => {
+            if (highlighting === state.highlighting)
+                return;
+            setState({ highlighting });
+        },
+        /** Test seam: reset to the initial state. */
+        reset: () => setState({
+            open: false,
+            initialFind: "",
+            openRequest: 0,
+            highlighting: null,
+        }),
+    };
+}
+export const findReplaceStore = createFindReplaceStore();
+export function useFindReplaceState() {
+    return useSyncExternalStore(findReplaceStore.subscribe, findReplaceStore.getState, findReplaceStore.getState);
+}
+//# sourceMappingURL=findReplaceStore.js.map

package/dist/editor/find-replace/findReplaceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findReplaceStore.js","sourceRoot":"","sources":["../../../src/editor/find-replace/findReplaceStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAwB7C;;;;GAIG;AACH,SAAS,sBAAsB;IAC7B,IAAI,KAAK,GAAqB;QAC5B,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAEtC,MAAM,QAAQ,GAAG,CAAC,KAAgC,EAAE,EAAE;QACpD,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;QAC/B,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,SAAS,EAAE,CAAC,QAAkB,EAAE,EAAE;YAChC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,CAAC,WAAoB,EAAE,EAAE,CAC7B,QAAQ,CAAC;YACP,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW;YAC7C,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC;SACnC,CAAC;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,EAAE,CAAC,WAAoB,EAAE,EAAE;YAC/B,IAAI,KAAK,CAAC,IAAI;gBAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;;gBAE5D,QAAQ,CAAC;oBACP,IAAI,EAAE,IAAI;oBACV,WAAW,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW;oBAC7C,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC;iBACnC,CAAC,CAAC;QACP,CAAC;QACD,eAAe,EAAE,CAAC,YAA4C,EAAE,EAAE;YAChE,IAAI,YAAY,KAAK,KAAK,CAAC,YAAY;gBAAE,OAAO;YAChD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,6CAA6C;QAC7C,KAAK,EAAE,GAAG,EAAE,CACV,QAAQ,CAAC;YACP,IAAI,EAAE,KAAK;YACX,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,IAAI;SACnB,CAAC;KACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;AAEzD,MAAM,UAAU,mBAAmB;IACjC,OAAO,oBAAoB,CACzB,gBAAgB,CAAC,SAAS,EAC1B,gBAAgB,CAAC,QAAQ,EACzB,gBAAgB,CAAC,QAAQ,CAC1B,CAAC;AACJ,CAAC"}

package/dist/editor/find-replace/findReplaceTargets.d.ts

@@ -0,0 +1,49 @@
+import type { Field, FullItem, ItemDescriptor, Page } from "../pageModel";
+export type FindReplaceScope = "page" | "item";
+/** An item whose text fields the dialog searches, with where it came from. */
+export type FindReplaceItemSource = {
+    descriptor: ItemDescriptor;
+    /** True for the item that is being edited (the page itself in page mode). */
+    isMainItem: boolean;
+    /** Name of the canvas component the item belongs to, when it is a component's content. */
+    componentName?: string;
+    /** Id of that canvas component (scroll fallback when a text range cannot be measured). */
+    componentId?: string;
+    /** Content of a shared component: replacing it changes every page that renders it. */
+    isShared?: boolean;
+};
+export type FindReplaceFieldTarget = {
+    item: FullItem;
+    field: Field;
+    source: FindReplaceItemSource;
+    /** The current text (HTML for rich text) the replacement runs on. */
+    value: string;
+    count: number;
+    snippet: string;
+};
+export type FindReplacePlan = {
+    targets: FindReplaceFieldTarget[];
+    totalMatches: number;
+    /** Fields with a match whose value is inherited (fallback / standard value); never rewritten. */
+    skippedInherited: number;
+    /** Fields with a match the current user may not write. */
+    skippedReadOnly: number;
+};
+/**
+ * Lists the items the dialog searches. In page scope that is the page item
+ * plus every item rendered by a component on it (datasources and embedded
+ * content parts); in item scope only the item being edited. The main item
+ * always comes first and every item appears once.
+ */
+export declare function collectFindReplaceItemSources(args: {
+    page?: Page;
+    item?: FullItem;
+    currentItemDescriptor?: ItemDescriptor;
+    scope: FindReplaceScope;
+}): FindReplaceItemSource[];
+/**
+ * Computes which fields the replacement would touch. Inherited values
+ * (language fallback, standard values) and read-only fields are counted but
+ * excluded, so "Replace all" only rewrites values the item actually owns.
+ */
+export declare function planFindReplace(items: FullItem[], sources: FindReplaceItemSource[], find: RegExp | undefined): FindReplacePlan;

package/dist/editor/find-replace/findReplaceTargets.js

@@ -0,0 +1,110 @@
+import { buildMatchSnippet, countMatchesInFieldValue, isFindReplaceTextFieldType, } from "./findReplaceText";
+function descriptorKey(descriptor) {
+    return `${descriptor.id.replace(/[{}]/g, "").toLowerCase()}|${(descriptor.language ?? "").toLowerCase()}|${descriptor.version ?? 0}`;
+}
+function collectComponentSources(component, add, inheritedShared) {
+    const isShared = inheritedShared || !!component.isShared;
+    if (component.datasourceItem) {
+        add({
+            descriptor: component.datasourceItem,
+            isMainItem: false,
+            componentName: component.name,
+            componentId: component.id,
+            isShared,
+        });
+    }
+    component.items?.forEach((item) => add({
+        descriptor: item,
+        isMainItem: false,
+        componentName: component.name,
+        componentId: component.id,
+        isShared,
+    }));
+    component.placeholders?.forEach((placeholder) => placeholder.components?.forEach((child) => collectComponentSources(child, add, isShared)));
+}
+/**
+ * Lists the items the dialog searches. In page scope that is the page item
+ * plus every item rendered by a component on it (datasources and embedded
+ * content parts); in item scope only the item being edited. The main item
+ * always comes first and every item appears once.
+ */
+export function collectFindReplaceItemSources(args) {
+    const { page, item, currentItemDescriptor, scope } = args;
+    const mainDescriptor = page?.item?.descriptor ?? item?.descriptor ?? currentItemDescriptor;
+    const sources = [];
+    const seen = new Set();
+    const add = (source) => {
+        if (!source.descriptor?.id)
+            return;
+        const key = descriptorKey(source.descriptor);
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        sources.push(source);
+    };
+    if (mainDescriptor)
+        add({ descriptor: mainDescriptor, isMainItem: true });
+    if (scope === "page" && page?.rootComponent) {
+        collectComponentSources(page.rootComponent, add, false);
+    }
+    return sources;
+}
+function getSearchableValue(field) {
+    if (typeof field.value === "string")
+        return field.value;
+    if (typeof field.rawValue === "string")
+        return field.rawValue;
+    return undefined;
+}
+/**
+ * Computes which fields the replacement would touch. Inherited values
+ * (language fallback, standard values) and read-only fields are counted but
+ * excluded, so "Replace all" only rewrites values the item actually owns.
+ */
+export function planFindReplace(items, sources, find) {
+    const plan = {
+        targets: [],
+        totalMatches: 0,
+        skippedInherited: 0,
+        skippedReadOnly: 0,
+    };
+    if (!find)
+        return plan;
+    const itemsByKey = new Map(items.map((item) => [descriptorKey(item.descriptor ?? item), item]));
+    sources.forEach((source) => {
+        const item = itemsByKey.get(descriptorKey(source.descriptor));
+        if (!item)
+            return;
+        const fields = [...item.fields].sort((a, b) => (a.sectionSortOrder ?? 0) - (b.sectionSortOrder ?? 0) ||
+            (a.sortOrder ?? 0) - (b.sortOrder ?? 0));
+        fields.forEach((field) => {
+            if (!isFindReplaceTextFieldType(field.type))
+                return;
+            const value = getSearchableValue(field);
+            if (!value)
+                return;
+            const count = countMatchesInFieldValue(value, field.type, find);
+            if (count === 0)
+                return;
+            if (field.isFallback || field.isStandardValue) {
+                plan.skippedInherited += count;
+                return;
+            }
+            if (field.canWrite === false || item.canWriteItem === false) {
+                plan.skippedReadOnly += count;
+                return;
+            }
+            plan.targets.push({
+                item,
+                field,
+                source,
+                value,
+                count,
+                snippet: buildMatchSnippet(value, field.type, find),
+            });
+            plan.totalMatches += count;
+        });
+    });
+    return plan;
+}
+//# sourceMappingURL=findReplaceTargets.js.map

package/dist/editor/find-replace/findReplaceTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findReplaceTargets.js","sourceRoot":"","sources":["../../../src/editor/find-replace/findReplaceTargets.ts"],"names":[],"mappings":"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"}

package/dist/editor/find-replace/findReplaceText.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Pure text helpers for the "Find and replace" dialog. Everything in here is
+ * free of React and of the edit context so it can be unit tested directly.
+ */
+export type FindReplaceOptions = {
+    matchCase: boolean;
+    wholeWord: boolean;
+};
+/** Field types whose value is a text string the dialog may search and rewrite. */
+export declare function isFindReplaceTextFieldType(type: string | undefined): boolean;
+/** True for rich text: the value is HTML, so only text between tags is searched. */
+export declare function isHtmlFieldType(type: string | undefined): boolean;
+/**
+ * Builds the global search expression for a literal search string. Returns
+ * undefined for an empty search string so callers never match "everything".
+ */
+export declare function buildFindRegExp(find: string, options: FindReplaceOptions): RegExp | undefined;
+export declare function countMatches(text: string, find: RegExp): number;
+/**
+ * Replaces every match in plain text, or only the match with the given
+ * 0-based occurrence index. The replacement is literal: `$` in the
+ * replacement string is not interpreted as a back-reference.
+ */
+export declare function replaceInText(text: string, find: RegExp, replacement: string, onlyOccurrence?: number): {
+    value: string;
+    count: number;
+};
+/**
+ * Strips tags and decodes entities so an HTML value can be searched (for
+ * counting) and shown as a plain snippet.
+ */
+export declare function htmlToSearchableText(html: string): string;
+/**
+ * Replaces matches in the text nodes of an HTML string. Tags and attributes
+ * are left alone. Text segments that contain no match keep their original
+ * entity spelling; changed segments are re-encoded so `&`, `<` and `>` in the
+ * replacement never break the markup. Matches that span a tag boundary (for
+ * example "Hello <b>world</b>") are not found.
+ */
+export declare function replaceInHtml(html: string, find: RegExp, replacement: string, onlyOccurrence?: number): {
+    value: string;
+    count: number;
+};
+export declare function countMatchesInFieldValue(value: string, fieldType: string | undefined, find: RegExp): number;
+export declare function replaceInFieldValue(value: string, fieldType: string | undefined, find: RegExp, replacement: string, onlyOccurrence?: number): {
+    value: string;
+    count: number;
+};
+/** Short, single-line excerpt around the first match for the preview list. */
+export declare function buildMatchSnippet(value: string, fieldType: string | undefined, find: RegExp, contextLength?: number): string;

package/dist/editor/find-replace/findReplaceText.js

@@ -0,0 +1,189 @@
+/**
+ * Pure text helpers for the "Find and replace" dialog. Everything in here is
+ * free of React and of the edit context so it can be unit tested directly.
+ */
+const FIND_REPLACE_TEXT_FIELD_TYPES = new Set([
+    "single-line text",
+    "multi-line text",
+    "memo",
+    "rich text",
+]);
+/** Field types whose value is a text string the dialog may search and rewrite. */
+export function isFindReplaceTextFieldType(type) {
+    return FIND_REPLACE_TEXT_FIELD_TYPES.has((type ?? "").trim().toLowerCase());
+}
+/** True for rich text: the value is HTML, so only text between tags is searched. */
+export function isHtmlFieldType(type) {
+    return (type ?? "").trim().toLowerCase() === "rich text";
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Builds the global search expression for a literal search string. Returns
+ * undefined for an empty search string so callers never match "everything".
+ */
+export function buildFindRegExp(find, options) {
+    if (!find)
+        return undefined;
+    const escaped = escapeRegExp(find);
+    const source = options.wholeWord
+        ? `(?<![\\p{L}\\p{N}_])${escaped}(?![\\p{L}\\p{N}_])`
+        : escaped;
+    return new RegExp(source, options.matchCase ? "gu" : "giu");
+}
+export function countMatches(text, find) {
+    if (!text)
+        return 0;
+    find.lastIndex = 0;
+    const matches = text.match(find);
+    find.lastIndex = 0;
+    return matches ? matches.length : 0;
+}
+/**
+ * Replaces every match in plain text, or only the match with the given
+ * 0-based occurrence index. The replacement is literal: `$` in the
+ * replacement string is not interpreted as a back-reference.
+ */
+export function replaceInText(text, find, replacement, onlyOccurrence) {
+    if (!text)
+        return { value: text, count: 0 };
+    let count = 0;
+    let seen = 0;
+    find.lastIndex = 0;
+    const value = text.replace(find, (matched) => {
+        const index = seen;
+        seen += 1;
+        if (onlyOccurrence !== undefined && index !== onlyOccurrence) {
+            return matched;
+        }
+        count += 1;
+        return replacement;
+    });
+    find.lastIndex = 0;
+    return { value, count };
+}
+const NBSP = String.fromCharCode(0xa0);
+const NAMED_ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    nbsp: NBSP,
+};
+function decodeEntities(text) {
+    return text.replace(/&(#x[0-9a-f]+|#[0-9]+|[a-z]+);/gi, (entity, body) => {
+        const lower = body.toLowerCase();
+        if (lower.startsWith("#x")) {
+            const code = parseInt(lower.slice(2), 16);
+            return Number.isFinite(code) ? String.fromCodePoint(code) : entity;
+        }
+        if (lower.startsWith("#")) {
+            const code = parseInt(lower.slice(1), 10);
+            return Number.isFinite(code) ? String.fromCodePoint(code) : entity;
+        }
+        return NAMED_ENTITIES[lower] ?? entity;
+    });
+}
+function encodeEntities(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(new RegExp(NBSP, "g"), "&nbsp;");
+}
+/**
+ * Splits HTML into alternating tag and text segments. Tags (including
+ * comments, doctype and processing instructions) are returned untouched so
+ * attributes, URLs and class names are never searched.
+ */
+function splitHtml(html) {
+    const segments = [];
+    const tagPattern = /<!--[\s\S]*?-->|<[^>]*>/g;
+    let last = 0;
+    for (const match of html.matchAll(tagPattern)) {
+        const start = match.index ?? 0;
+        if (start > last)
+            segments.push({ tag: false, text: html.slice(last, start) });
+        segments.push({ tag: true, text: match[0] });
+        last = start + match[0].length;
+    }
+    if (last < html.length)
+        segments.push({ tag: false, text: html.slice(last) });
+    return segments;
+}
+/**
+ * Strips tags and decodes entities so an HTML value can be searched (for
+ * counting) and shown as a plain snippet.
+ */
+export function htmlToSearchableText(html) {
+    return splitHtml(html)
+        .filter((segment) => !segment.tag)
+        .map((segment) => decodeEntities(segment.text))
+        .join("");
+}
+/**
+ * Replaces matches in the text nodes of an HTML string. Tags and attributes
+ * are left alone. Text segments that contain no match keep their original
+ * entity spelling; changed segments are re-encoded so `&`, `<` and `>` in the
+ * replacement never break the markup. Matches that span a tag boundary (for
+ * example "Hello <b>world</b>") are not found.
+ */
+export function replaceInHtml(html, find, replacement, onlyOccurrence) {
+    if (!html)
+        return { value: html, count: 0 };
+    let count = 0;
+    // Occurrences are numbered across the whole value, so a single-match
+    // replacement addresses the same match the overlay highlights.
+    let seenBefore = 0;
+    const value = splitHtml(html)
+        .map((segment) => {
+        if (segment.tag)
+            return segment.text;
+        const decoded = decodeEntities(segment.text);
+        const inSegment = countMatches(decoded, find);
+        if (inSegment === 0)
+            return segment.text;
+        const localOccurrence = onlyOccurrence === undefined ? undefined : onlyOccurrence - seenBefore;
+        seenBefore += inSegment;
+        if (localOccurrence !== undefined &&
+            (localOccurrence < 0 || localOccurrence >= inSegment)) {
+            return segment.text;
+        }
+        const result = replaceInText(decoded, find, replacement, localOccurrence);
+        if (result.count === 0)
+            return segment.text;
+        count += result.count;
+        return encodeEntities(result.value);
+    })
+        .join("");
+    return { value, count };
+}
+export function countMatchesInFieldValue(value, fieldType, find) {
+    if (!isHtmlFieldType(fieldType))
+        return countMatches(value, find);
+    return replaceInHtml(value, find, "").count;
+}
+export function replaceInFieldValue(value, fieldType, find, replacement, onlyOccurrence) {
+    return isHtmlFieldType(fieldType)
+        ? replaceInHtml(value, find, replacement, onlyOccurrence)
+        : replaceInText(value, find, replacement, onlyOccurrence);
+}
+/** Short, single-line excerpt around the first match for the preview list. */
+export function buildMatchSnippet(value, fieldType, find, contextLength = 32) {
+    const text = (isHtmlFieldType(fieldType) ? htmlToSearchableText(value) : value)
+        .replace(/\s+/g, " ")
+        .trim();
+    find.lastIndex = 0;
+    const match = find.exec(text);
+    find.lastIndex = 0;
+    if (!match)
+        return text.slice(0, contextLength * 2);
+    const start = Math.max(0, match.index - contextLength);
+    const end = Math.min(text.length, match.index + match[0].length + contextLength);
+    return ((start > 0 ? "…" : "") +
+        text.slice(start, end) +
+        (end < text.length ? "…" : ""));
+}
+//# sourceMappingURL=findReplaceText.js.map