@parhelia/core 0.3.12832 → 0.3.12833

package/dist/editor/field-types/richtext/utils/spellCheckText.d.ts

@@ -0,0 +1,31 @@
+import { Editor, Element, type Descendant, type Point } from "slate";
+/**
+ * Spell-check text of a Slate document. Unlike `getNodesText` (which joins
+ * every text node without separators), a newline is inserted when entering and
+ * when leaving a block element and for every line break, so words in
+ * different blocks never join while adjacent inline formatting still does.
+ *
+ * `starts` maps every text node (by its path key) to its offset in `text`, so
+ * server offsets map onto Slate points without arithmetic. `separators` lists
+ * the offsets of the inserted newlines.
+ */
+export type SpellCheckText = {
+    text: string;
+    starts: Map<string, number>;
+    separators: number[];
+};
+export type SpellCheckTextOptions = {
+    /** Whether an element is inline (part of the surrounding text). */
+    isInline?: (element: Element) => boolean;
+};
+export declare function buildSpellCheckText(nodes: Descendant[], options?: SpellCheckTextOptions): SpellCheckText;
+/**
+ * The Slate point at `offset` of a {@link SpellCheckText}. Offsets that fall
+ * on a separator resolve to the end of the preceding text node; offsets past
+ * the end resolve to the end of the document.
+ */
+export declare function pointAtSpellTextOffset(editor: Editor, starts: Map<string, number>, offset: number): Point;
+/** Text of a text node by path key; used by tests and hit testing. */
+export declare function spellTextNodeText(nodes: Descendant[], pathKey: string): string | undefined;
+/** Length of the common prefix of two strings, in UTF-16 code units. */
+export declare function commonPrefixLength(a: string, b: string): number;

package/dist/editor/field-types/richtext/utils/spellCheckText.js

@@ -0,0 +1,82 @@
+import { Editor, Element, Node, Text, } from "slate";
+const DEFAULT_INLINE_TYPES = new Set(["link", "preserved-inline"]);
+const LINE_BREAK_TYPES = new Set(["line-break"]);
+function defaultIsInline(element) {
+    const type = element.type ?? "";
+    return DEFAULT_INLINE_TYPES.has(type) || LINE_BREAK_TYPES.has(type);
+}
+function isLineBreak(element) {
+    return LINE_BREAK_TYPES.has(element.type ?? "");
+}
+export function buildSpellCheckText(nodes, options) {
+    const isInline = options?.isInline ?? defaultIsInline;
+    const starts = new Map();
+    const separators = [];
+    let text = "";
+    const separator = () => {
+        separators.push(text.length);
+        text += "\n";
+    };
+    const walk = (node, path) => {
+        if (Text.isText(node)) {
+            starts.set(path.join("."), text.length);
+            text += node.text;
+            return;
+        }
+        if (!Element.isElement(node))
+            return;
+        if (isLineBreak(node)) {
+            separator();
+            return;
+        }
+        const block = !isInline(node);
+        if (block)
+            separator();
+        node.children.forEach((child, index) => walk(child, [...path, index]));
+        if (block)
+            separator();
+    };
+    nodes.forEach((node, index) => walk(node, [index]));
+    return { text, starts, separators };
+}
+/**
+ * The Slate point at `offset` of a {@link SpellCheckText}. Offsets that fall
+ * on a separator resolve to the end of the preceding text node; offsets past
+ * the end resolve to the end of the document.
+ */
+export function pointAtSpellTextOffset(editor, starts, offset) {
+    let best = null;
+    let bestStart = -1;
+    for (const [node, path] of Editor.nodes(editor, {
+        at: [],
+        match: Text.isText,
+    })) {
+        const start = starts.get(path.join("."));
+        if (start === undefined)
+            continue;
+        const end = start + node.text.length;
+        if (offset >= start && offset <= end) {
+            return { path, offset: offset - start };
+        }
+        if (start < offset && start >= bestStart) {
+            bestStart = start;
+            best = { path, offset: node.text.length };
+        }
+    }
+    return best ?? Editor.end(editor, []);
+}
+/** Text of a text node by path key; used by tests and hit testing. */
+export function spellTextNodeText(nodes, pathKey) {
+    const path = pathKey.split(".").map(Number);
+    const node = Node.get({ children: nodes }, path);
+    return Text.isText(node) ? node.text : undefined;
+}
+/** Length of the common prefix of two strings, in UTF-16 code units. */
+export function commonPrefixLength(a, b) {
+    const max = Math.min(a.length, b.length);
+    let index = 0;
+    while (index < max && a.charCodeAt(index) === b.charCodeAt(index))
+        index++;
+    return index;
+}
+//# sourceMappingURL=spellCheckText.js.map

package/dist/editor/field-types/richtext/utils/spellCheckText.js.map

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

package/dist/editor/field-types/useFocusedFieldInput.d.ts

@@ -0,0 +1,13 @@
+import { type RefObject } from "react";
+import type { Field } from "../pageModel";
+/** How long a focus request waits for the form to render the field. */
+export declare const FOCUSED_FIELD_INPUT_DELAY_MS = 500;
+/**
+ * Moves the focus into the control when the editor focuses its field from
+ * elsewhere (the canvas, a command), once nothing else holds the focus.
+ *
+ * The request is satisfied as soon as the control has had the focus, so a
+ * field the user clicked and then left (the comment picker blurs it, a
+ * submitted composer unmounts) does not take the focus back later.
+ */
+export declare function useFocusedFieldInput(field: Field, inputRef: RefObject<HTMLInputElement | HTMLTextAreaElement | null>): void;

package/dist/editor/field-types/useFocusedFieldInput.js

@@ -0,0 +1,50 @@
+import { useEffect } from "react";
+import { useFieldsEditContextRef } from "../client/editContext";
+/** How long a focus request waits for the form to render the field. */
+export const FOCUSED_FIELD_INPUT_DELAY_MS = 500;
+/**
+ * Moves the focus into the control when the editor focuses its field from
+ * elsewhere (the canvas, a command), once nothing else holds the focus.
+ *
+ * The request is satisfied as soon as the control has had the focus, so a
+ * field the user clicked and then left (the comment picker blurs it, a
+ * submitted composer unmounts) does not take the focus back later.
+ */
+export function useFocusedFieldInput(field, inputRef) {
+    const fieldsContextRef = useFieldsEditContextRef();
+    const focusedField = fieldsContextRef.current?.focusedField;
+    const fieldItem = field.descriptor.item;
+    const isFocusedField = (candidate) => candidate?.fieldId === field.id &&
+        candidate?.item.id === fieldItem.id &&
+        candidate?.item.language === fieldItem.language &&
+        candidate?.item.version === fieldItem.version;
+    const requested = isFocusedField(focusedField);
+    useEffect(() => {
+        const input = inputRef.current;
+        if (!requested || !input || document.activeElement === input)
+            return;
+        let focusedSince = false;
+        const markFocused = () => {
+            focusedSince = true;
+        };
+        input.addEventListener("focus", markFocused);
+        const timer = window.setTimeout(() => {
+            input.removeEventListener("focus", markFocused);
+            if (focusedSince ||
+                !input.isConnected ||
+                !isFocusedField(fieldsContextRef.current?.focusedField))
+                return;
+            // Only focus if no other element currently has focus (e.g., popover buttons)
+            if (!document.activeElement || document.activeElement === document.body) {
+                input.focus();
+            }
+        }, FOCUSED_FIELD_INPUT_DELAY_MS);
+        return () => {
+            window.clearTimeout(timer);
+            input.removeEventListener("focus", markFocused);
+        };
+        // A new request per focusedField change, as before.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [focusedField, requested]);
+}
+//# sourceMappingURL=useFocusedFieldInput.js.map

package/dist/editor/field-types/useFocusedFieldInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusedFieldInput.js","sourceRoot":"","sources":["../../../src/editor/field-types/useFocusedFieldInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,uEAAuE;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,QAAkE;IAElE,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;IACnD,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;IACxC,MAAM,cAAc,GAAG,CAAC,SAA8B,EAAE,EAAE,CACxD,SAAS,EAAE,OAAO,KAAK,KAAK,CAAC,EAAE;QAC/B,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE;QACnC,SAAS,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;QAC/C,SAAS,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,CAAC;IAChD,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO;QAErE,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC,CAAC;QACF,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YACnC,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAChD,IACE,YAAY;gBACZ,CAAC,KAAK,CAAC,WAAW;gBAClB,CAAC,cAAc,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC;gBAEvD,OAAO;YACT,6EAA6E;YAC7E,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxE,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC,EAAE,4BAA4B,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC3B,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAClD,CAAC,CAAC;QACF,oDAAoD;QACpD,uDAAuD;IACzD,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/editor/field-types/useFormFieldSelectionRange.d.ts

@@ -0,0 +1,43 @@
+import type { RefObject } from "react";
+import { type SelectionRange } from "../client/editContext";
+import type { Field } from "../pageModel";
+type TextFormControl = HTMLInputElement | HTMLTextAreaElement;
+/**
+ * How long the caret has to rest before a caret-only selection is recorded
+ * in the edit context.
+ *
+ * Carets used to be published as `selectedRange` state, which replaces the
+ * (memoized) edit context value and re-renders every consumer in the editor.
+ * Doing that on every keystroke is what let React's nested-update guard trip
+ * during fast typing: the caret commits kept a Default-priority re-render
+ * pending across dozens of synchronous keystroke commits, React threw
+ * "Maximum update depth exceeded" from the text field's own setState, and
+ * restored the stale value (dropping the typed character and moving the caret
+ * to the end). Carets now go through `setCaretRange`, which does not render;
+ * the settle delay still spares building a range per keystroke.
+ */
+export declare const SELECTION_RANGE_SETTLE_MS = 200;
+/**
+ * Publishes the native selection of a form text control as the edit
+ * context's `selectedRange`.
+ *
+ * Text selections (used by the inline AI trigger) are published at once and
+ * re-render their consumers. Caret-only positions are recorded with
+ * `setCaretRange` once typing settles: consumers read them when they act
+ * (insert at cursor, the inline AI dialog), so focusing a field or pausing
+ * while typing does not re-render the editor. Ranges are read from the live
+ * control, so the range and its `replaceText` callback always describe the
+ * current value.
+ */
+export declare function useFormFieldSelectionRange({ field, inputRef, setValue, updateFieldValue, }: {
+    field: Field;
+    inputRef: RefObject<TextFormControl | null>;
+    setValue: (value: string) => void;
+    updateFieldValue: (value: string) => void;
+}): {
+    scheduleSelectionRange: (target: TextFormControl) => void;
+    flushSelectionRange: () => void;
+    cancelPendingSelectionRange: () => void;
+    externalSelectedRange: SelectionRange | undefined;
+};
+export {};

package/dist/editor/field-types/useFormFieldSelectionRange.js

@@ -0,0 +1,149 @@
+import { useCallback, useEffect, useRef } from "react";
+import { useEditContextRef } from "../client/editContext";
+import { useSelectedRange } from "../client/liveEditState";
+import { cleanId } from "../utils/id-helper";
+import { extractPlainTextContext } from "../utils/selectionContext";
+import { logFieldValueDiagnostic, summarizeField, summarizeFieldValue, } from "../fieldValueDiagnostics";
+/**
+ * How long the caret has to rest before a caret-only selection is recorded
+ * in the edit context.
+ *
+ * Carets used to be published as `selectedRange` state, which replaces the
+ * (memoized) edit context value and re-renders every consumer in the editor.
+ * Doing that on every keystroke is what let React's nested-update guard trip
+ * during fast typing: the caret commits kept a Default-priority re-render
+ * pending across dozens of synchronous keystroke commits, React threw
+ * "Maximum update depth exceeded" from the text field's own setState, and
+ * restored the stale value (dropping the typed character and moving the caret
+ * to the end). Carets now go through `setCaretRange`, which does not render;
+ * the settle delay still spares building a range per keystroke.
+ */
+export const SELECTION_RANGE_SETTLE_MS = 200;
+/**
+ * Publishes the native selection of a form text control as the edit
+ * context's `selectedRange`.
+ *
+ * Text selections (used by the inline AI trigger) are published at once and
+ * re-render their consumers. Caret-only positions are recorded with
+ * `setCaretRange` once typing settles: consumers read them when they act
+ * (insert at cursor, the inline AI dialog), so focusing a field or pausing
+ * while typing does not re-render the editor. Ranges are read from the live
+ * control, so the range and its `replaceText` callback always describe the
+ * current value.
+ */
+export function useFormFieldSelectionRange({ field, inputRef, setValue, updateFieldValue, }) {
+    const editContextRef = useEditContextRef();
+    const settleTimerRef = useRef(null);
+    // Context renders can commit after further native caret movement. Published
+    // ranges describe what the control already did; they are not restore commands.
+    const publishedRangesRef = useRef(new WeakSet());
+    const updateFieldValueRef = useRef(updateFieldValue);
+    updateFieldValueRef.current = updateFieldValue;
+    const setValueRef = useRef(setValue);
+    setValueRef.current = setValue;
+    const fieldRef = useRef(field);
+    fieldRef.current = field;
+    // A selection of this field published elsewhere (the canvas, the inline AI
+    // word expansion), for the control to mirror; never one of its own. Only
+    // these re-render this field, not every selection in the editor.
+    const externalSelectedRange = useSelectedRange({
+        select: (range) => range &&
+            !publishedRangesRef.current.has(range) &&
+            cleanId(range.fieldId) === cleanId(field.id) &&
+            cleanId(range.itemId) === cleanId(field.descriptor.item?.id)
+            ? range
+            : undefined,
+    });
+    const cancelPendingSelectionRange = useCallback(() => {
+        if (settleTimerRef.current != null) {
+            window.clearTimeout(settleTimerRef.current);
+            settleTimerRef.current = null;
+        }
+    }, []);
+    const createReplaceTextCallback = useCallback((currentValue, startOffset, endOffset) => {
+        return (newText) => {
+            // If startOffset === endOffset, there's no selection - insert at cursor
+            const newValue = currentValue.slice(0, startOffset) +
+                newText +
+                currentValue.slice(endOffset);
+            logFieldValueDiagnostic("text-field", "replace selected text", {
+                field: summarizeField(fieldRef.current),
+                currentValue: summarizeFieldValue(currentValue),
+                replacement: summarizeFieldValue(newText),
+                nextValue: summarizeFieldValue(newValue),
+                startOffset,
+                endOffset,
+            });
+            setValueRef.current(newValue);
+            updateFieldValueRef.current(newValue);
+        };
+    }, []);
+    const publishSelectionRange = useCallback((target) => {
+        cancelPendingSelectionRange();
+        const editor = editContextRef.current;
+        const currentField = fieldRef.current;
+        const fieldItem = currentField.descriptor.item;
+        if (!editor || !fieldItem)
+            return;
+        const startOffset = target.selectionStart || 0;
+        const endOffset = target.selectionEnd || 0;
+        const selectedText = target.value.slice(startOffset, endOffset);
+        const { contextBefore, contextAfter } = extractPlainTextContext(target.value, startOffset, endOffset);
+        // Always publish the range, even if empty (cursor position tracking).
+        const range = {
+            itemId: fieldItem.id,
+            fieldId: currentField.id,
+            language: fieldItem.language,
+            version: fieldItem.version,
+            startOffset,
+            endOffset,
+            text: selectedText, // Empty string if no selection
+            element: target, // Element reference for AI trigger positioning
+            contextBefore,
+            contextAfter,
+            replaceText: createReplaceTextCallback(target.value, startOffset, endOffset),
+        };
+        const currentRange = editor.selectedRange;
+        if (range.text !== currentRange?.text ||
+            range.startOffset !== currentRange?.startOffset ||
+            range.endOffset !== currentRange?.endOffset ||
+            range.fieldId !== currentRange?.fieldId ||
+            range.itemId !== currentRange?.itemId) {
+            publishedRangesRef.current.add(range);
+            if (startOffset === endOffset)
+                editor.setCaretRange(range);
+            else
+                editor.setSelectedRange(range);
+        }
+    }, [cancelPendingSelectionRange, createReplaceTextCallback, editContextRef]);
+    const scheduleSelectionRange = useCallback((target) => {
+        const collapsed = (target.selectionStart ?? 0) === (target.selectionEnd ?? 0);
+        if (!collapsed) {
+            publishSelectionRange(target);
+            return;
+        }
+        cancelPendingSelectionRange();
+        settleTimerRef.current = window.setTimeout(() => {
+            settleTimerRef.current = null;
+            if (inputRef.current === target)
+                publishSelectionRange(target);
+        }, SELECTION_RANGE_SETTLE_MS);
+    }, [cancelPendingSelectionRange, inputRef, publishSelectionRange]);
+    /** Publishes a deferred caret position right away (before it is consumed). */
+    const flushSelectionRange = useCallback(() => {
+        if (settleTimerRef.current == null)
+            return;
+        cancelPendingSelectionRange();
+        const target = inputRef.current;
+        if (target)
+            publishSelectionRange(target);
+    }, [cancelPendingSelectionRange, inputRef, publishSelectionRange]);
+    useEffect(() => cancelPendingSelectionRange, [cancelPendingSelectionRange]);
+    return {
+        scheduleSelectionRange,
+        flushSelectionRange,
+        cancelPendingSelectionRange,
+        externalSelectedRange,
+    };
+}
+//# sourceMappingURL=useFormFieldSelectionRange.js.map

package/dist/editor/field-types/useFormFieldSelectionRange.js.map

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

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

@@ -0,0 +1,11 @@
+import { EditContextType } from "../client/editContext";
+/**
+ * Content of the "Find and replace" popover: searches every text field of the
+ * current item (or of every item on the page), highlights the matches on the
+ * canvas through the shared store, steps through them, and replaces one or
+ * all of them through the regular field-edit path.
+ */
+export declare function FindReplacePanel({ editContext, onClose, }: {
+    editContext: EditContextType;
+    onClose: () => void;
+}): import("react").JSX.Element;