@inshapardaz/likhari-react 0.1.21 → 0.1.22-dev.216

package/dist/EditorRoot.d.ts

@@ -4,6 +4,9 @@ import { type FormatId } from '@inshapardaz/likhari-converters';
 import { type EditorFeatureConfig, type FeatureConfigPresetName } from '@inshapardaz/likhari-core';
 import { type FontOption } from './fonts/index.js';
 import { type DraftRestoreMode } from './components/DraftRestore.js';
+import { type AutoCorrectStore } from './autocorrect/autoCorrectStores.js';
+import type { UrduNormalizationOptions } from './normalization/urduNormalize.js';
+import type { PunctuationOptions } from './autocorrect/punctuationRules.js';
 import { type Locale } from './i18n/index.js';
 /** What happens when the user is about to leave with unsaved changes. */
 export type NavigationGuardMode = 'confirm' | 'save-draft' | 'off';
@@ -13,6 +16,12 @@ export interface EditorInitialContent {
 }
 export interface EditorRootProps {
     documentId?: string;
+    /** Where auto-corrections are loaded from and saved to, in priority order. Pass a stable array. */
+    autoCorrectStores?: AutoCorrectStore[];
+    /** Urdu normalisation applied as part of auto-correct. Diacritics are kept unless `removeDiacritics` is set. */
+    urduNormalization?: UrduNormalizationOptions;
+    /** Common punctuation fixes, and whether a straight " becomes ”. Both on by default. */
+    punctuation?: PunctuationOptions;
     initialContent?: EditorInitialContent;
     featureConfig?: EditorFeatureConfig;
     featurePreset?: FeatureConfigPresetName;

package/dist/EditorRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorRoot.d.ts","sourceRoot":"","sources":["../src/EditorRoot.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAY1D,OAAO,KAAK,EAA8B,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,EAAwB,KAAK,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAKzH,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAOjE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAahF,OAAO,EAAgC,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMnE,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,uGAAuG;IACvG,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IACrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClD,iBAAiB,IAAI,OAAO,CAAC;IAC7B,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAQD,eAAO,MAAM,UAAU,uGA2XrB,CAAC"}
+{"version":3,"file":"EditorRoot.d.ts","sourceRoot":"","sources":["../src/EditorRoot.tsx"],"names":[],"mappings":"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"}

package/dist/EditorRoot.js

@@ -27,6 +27,11 @@ import { PoetryPlugin } from './plugins/PoetryPlugin.js';
 import { PoetryResizer } from './blocks/PoetryResizer.js';
 import { DraftRestore } from './components/DraftRestore.js';
 import { FindReplaceBar } from './components/FindReplaceBar.js';
+import { AutoCorrectPanel } from './components/AutoCorrectPanel.js';
+import { AutoCorrectPlugin } from './autocorrect/AutoCorrectPlugin.js';
+import { localStorageAutoCorrectStore } from './autocorrect/autoCorrectStores.js';
+import { SpellcheckPanel } from './components/SpellcheckPanel.js';
+import { SpellHighlightPlugin } from './spellcheck/SpellHighlightPlugin.js';
 import { LeaveDialog } from './components/LeaveDialog.js';
 import { clearDraft, createDraftId, hasDraftContent, pruneDrafts, writeDraft, } from './persistence/draftStorage.js';
 import { ImageOptionsContext } from './image/ImageOptionsContext.js';
@@ -35,13 +40,15 @@ import { UiStringsContext, getStrings } from './i18n/index.js';
 const DEFAULT_AUTOSAVE_DELAY_MS = 750;
 const DEFAULT_AUTOSAVE_MAX_BYTES = 2000000;
 const DEFAULT_AUTOSAVE_MAX_DRAFTS = 20;
+/** Used when the host passes no stores: corrections are kept in this browser. */
+const DEFAULT_AUTOCORRECT_STORES = [localStorageAutoCorrectStore()];
 function initialEditorStateJson(initialContent) {
     if (!initialContent)
         return undefined;
     const state = defaultFormatRegistry.parse(initialContent.format, initialContent.value);
     return JSON.stringify(state);
 }
-export const EditorRoot = forwardRef(function EditorRoot({ documentId, initialContent, featureConfig, featurePreset, theme, colorScheme, accentColor, locale = 'en', placeholder, height = '480px', onChange, onSave, showSave = Boolean(onSave), onImageUpload, fetchImage, fontOptions, autosave = true, restoreDraft = 'prompt', navigationGuard = 'confirm', onDraftRestored, autosaveDelayMs = DEFAULT_AUTOSAVE_DELAY_MS, autosaveMaxBytes = DEFAULT_AUTOSAVE_MAX_BYTES, autosaveMaxDrafts = DEFAULT_AUTOSAVE_MAX_DRAFTS, }, ref) {
+export const EditorRoot = forwardRef(function EditorRoot({ documentId, autoCorrectStores, urduNormalization, punctuation, initialContent, featureConfig, featurePreset, theme, colorScheme, accentColor, locale = 'en', placeholder, height = '480px', onChange, onSave, showSave = Boolean(onSave), onImageUpload, fetchImage, fontOptions, autosave = true, restoreDraft = 'prompt', navigationGuard = 'confirm', onDraftRestored, autosaveDelayMs = DEFAULT_AUTOSAVE_DELAY_MS, autosaveMaxBytes = DEFAULT_AUTOSAVE_MAX_BYTES, autosaveMaxDrafts = DEFAULT_AUTOSAVE_MAX_DRAFTS, }, ref) {
     const config = useMemo(() => resolveFeatureConfig(featureConfig, featurePreset), [featureConfig, featurePreset]);
     const strings = useMemo(() => getStrings(locale), [locale]);
     const resolvedPlaceholder = placeholder ?? strings.editor.placeholder;
@@ -68,7 +75,10 @@ export const EditorRoot = forwardRef(function EditorRoot({ documentId, initialCo
     const editorStateRef = useRef(null);
     const lastSavedJsonRef = useRef(null);
     const [isDirty, setIsDirty] = useState(false);
-    const [findOpen, setFindOpen] = useState(false);
+    const [openPanel, setOpenPanel] = useState(null);
+    const [autoCorrectVersion, setAutoCorrectVersion] = useState(0);
+    const stores = autoCorrectStores ?? DEFAULT_AUTOCORRECT_STORES;
+    const togglePanel = (panel) => setOpenPanel((current) => (current === panel ? null : panel));
     const isDirtyRef = useRef(isDirty);
     isDirtyRef.current = isDirty;
     const autosaveTimerRef = useRef(null);
@@ -281,9 +291,9 @@ export const EditorRoot = forwardRef(function EditorRoot({ documentId, initialCo
     // rather than colliding on a shared one.
     const portalTargetId = useId();
     const portalTargetSelector = `#${CSS.escape(portalTargetId)}`;
-    return (_jsx(EditorThemeProvider, { theme: theme, colorScheme: colorScheme, accentColor: accentColor, scopeElementId: portalTargetId, children: _jsxs("div", { className: "likhari-root", dir: dir, ref: rootElementRef, "data-document-id": documentId, style: { height: typeof height === 'number' ? `${height}px` : height }, children: [_jsx("div", { id: portalTargetId, className: "likhari-portal-target" }), _jsx(PortalTargetContext.Provider, { value: portalTargetSelector, children: _jsxs(UiStringsContext.Provider, { value: strings, children: [_jsx(ImageOptionsContext.Provider, { value: imageOptions, children: _jsxs(LexicalComposer, { initialConfig: initialConfig, children: [_jsx(Toolbar, { config: config, onSave: handleSave, findOpen: findOpen, onToggleFind: () => setFindOpen((v) => !v), isDirty: isDirty, showSave: showSave, fontOptions: fontOptions, direction: dir, locale: locale, drafts: autosave
+    return (_jsx(EditorThemeProvider, { theme: theme, colorScheme: colorScheme, accentColor: accentColor, scopeElementId: portalTargetId, children: _jsxs("div", { className: "likhari-root", dir: dir, ref: rootElementRef, "data-document-id": documentId, style: { height: typeof height === 'number' ? `${height}px` : height }, children: [_jsx("div", { id: portalTargetId, className: "likhari-portal-target" }), _jsx(PortalTargetContext.Provider, { value: portalTargetSelector, children: _jsxs(UiStringsContext.Provider, { value: strings, children: [_jsx(ImageOptionsContext.Provider, { value: imageOptions, children: _jsxs(LexicalComposer, { initialConfig: initialConfig, children: [_jsx(Toolbar, { config: config, onSave: handleSave, findOpen: openPanel === 'find', onToggleFind: () => togglePanel('find'), spellOpen: openPanel === 'spell', onToggleSpell: () => togglePanel('spell'), autoCorrectOpen: openPanel === 'autocorrect', onToggleAutoCorrect: () => togglePanel('autocorrect'), isDirty: isDirty, showSave: showSave, fontOptions: fontOptions, direction: dir, locale: locale, drafts: autosave
                                                 ? { currentId: draftId, maxBytes: autosaveMaxBytes, adoptOnRestore: !documentId, onRestored: handleDraftRestored }
-                                                : undefined }), documentId && (_jsx(DraftRestore, { draftId: documentId, mode: restoreDraft, initialJson: initialContentJsonRef.current, locale: locale, onRestored: handleDraftRestored })), _jsxs("div", { className: "likhari-canvas-frame", children: [config.findReplace && findOpen && _jsx(FindReplaceBar, { strings: strings, dir: dir, onClose: () => setFindOpen(false) }), _jsx("div", { className: "likhari-canvas", children: _jsx(RichTextPlugin, { contentEditable: _jsx(ContentEditable, { className: "likhari-content-editable", dir: dir, "aria-label": strings.editor.contentLabel }), placeholder: _jsx("div", { className: "likhari-placeholder", children: resolvedPlaceholder }), ErrorBoundary: LexicalErrorBoundary }) })] }), config.history && _jsx(HistoryPlugin, {}), (config.lists.bullet || config.lists.numbered || config.lists.check) && _jsx(ListPlugin, {}), config.lists.check && _jsx(CheckListPlugin, {}), config.links && _jsx(LinkPlugin, {}), config.links && _jsx(LinkPastePlugin, {}), config.blocks.pageBreak && _jsx(PageBreakPlugin, {}), config.columns && _jsx(LayoutPlugin, {}), config.footnotes && _jsx(FootnotePlugin, {}), config.poetry.enabled && _jsx(PoetryPlugin, {}), config.poetry.enabled && _jsx(PoetryResizer, {}), config.tables && _jsx(TablePlugin, { hasCellMerge: true, hasTabHandler: true }), config.blocks.horizontalRule && _jsx(HorizontalRulePlugin, {}), _jsx(EditorInstancePlugin, { instanceRef: editorInstanceRef }), _jsx(OnChangePlugin, { onChange: handleChange })] }) }), _jsx(LeaveDialog, { opened: leavePrompt !== null, canSave: Boolean(onSave), canSaveDraft: autosave || navigationGuard === 'save-draft', draftFailed: leavePrompt?.draftFailed ?? false, onSave: () => {
+                                                : undefined }), documentId && (_jsx(DraftRestore, { draftId: documentId, mode: restoreDraft, initialJson: initialContentJsonRef.current, locale: locale, onRestored: handleDraftRestored })), _jsxs("div", { className: "likhari-canvas-frame", children: [config.findReplace && openPanel === 'find' && _jsx(FindReplaceBar, { strings: strings, dir: dir, onClose: () => setOpenPanel(null) }), config.language.spellCheck && openPanel === 'spell' && (_jsx(SpellcheckPanel, { strings: strings, dir: dir, onClose: () => setOpenPanel(null) })), config.language.autocorrect && openPanel === 'autocorrect' && (_jsx(AutoCorrectPanel, { strings: strings, dir: dir, stores: stores, onSaved: () => setAutoCorrectVersion((v) => v + 1), onClose: () => setOpenPanel(null) })), _jsx("div", { className: "likhari-canvas", children: _jsx(RichTextPlugin, { contentEditable: _jsx(ContentEditable, { className: "likhari-content-editable", dir: dir, spellCheck: false, "aria-label": strings.editor.contentLabel }), placeholder: _jsx("div", { className: "likhari-placeholder", children: resolvedPlaceholder }), ErrorBoundary: LexicalErrorBoundary }) })] }), config.history && _jsx(HistoryPlugin, {}), (config.lists.bullet || config.lists.numbered || config.lists.check) && _jsx(ListPlugin, {}), config.lists.check && _jsx(CheckListPlugin, {}), config.links && _jsx(LinkPlugin, {}), config.links && _jsx(LinkPastePlugin, {}), config.blocks.pageBreak && _jsx(PageBreakPlugin, {}), config.language.spellCheck && _jsx(SpellHighlightPlugin, {}), (config.language.autocorrect || config.language.textCleanup) && _jsx(AutoCorrectPlugin, { stores: stores, version: autoCorrectVersion, enabled: true, typing: config.language.autocorrect, urduNormalization: urduNormalization, punctuation: punctuation }), config.columns && _jsx(LayoutPlugin, {}), config.footnotes && _jsx(FootnotePlugin, {}), config.poetry.enabled && _jsx(PoetryPlugin, {}), config.poetry.enabled && _jsx(PoetryResizer, {}), config.tables && _jsx(TablePlugin, { hasCellMerge: true, hasTabHandler: true }), config.blocks.horizontalRule && _jsx(HorizontalRulePlugin, {}), _jsx(EditorInstancePlugin, { instanceRef: editorInstanceRef }), _jsx(OnChangePlugin, { onChange: handleChange })] }) }), _jsx(LeaveDialog, { opened: leavePrompt !== null, canSave: Boolean(onSave), canSaveDraft: autosave || navigationGuard === 'save-draft', draftFailed: leavePrompt?.draftFailed ?? false, onSave: () => {
                                     handleSave();
                                     settleLeave(true);
                                 }, onSaveDraft: () => {

package/dist/autocorrect/AutoCorrectPlugin.d.ts

@@ -0,0 +1,27 @@
+import { type LexicalCommand } from 'lexical';
+import { type PunctuationOptions } from './punctuationRules.js';
+import { type AutoCorrectStore } from './autoCorrectStores.js';
+import { type UrduNormalizationOptions } from '../normalization/urduNormalize.js';
+/** Keys that end a word: a space or punctuation, in Latin and Arabic-script forms. */
+/** Corrects every word in the document, e.g. after pasting or loading content. */
+export declare const CORRECT_DOCUMENT_COMMAND: LexicalCommand<void>;
+/**
+ * Corrects typed words as the user finishes them, the way the reference editor
+ * does, but from any set of stores. Corrections are loaded once per change
+ * of `stores` or `version` (bump `version` after saving a new correction so
+ * the table reloads). The table used depends on the block's direction: RTL
+ * blocks use the Urdu and Shahmukhi tables, LTR blocks the English one.
+ */
+export declare function AutoCorrectPlugin({ stores, version, enabled, typing, urduNormalization, punctuation, }: {
+    stores: AutoCorrectStore[];
+    version: number;
+    /** Whether the tables and the whole-document command are active. */
+    enabled: boolean;
+    /** Whether corrections run as the user types (auto-correct), not only on demand. */
+    typing: boolean;
+    /** Urdu normalisation for right-to-left text; character mapping always applies. */
+    urduNormalization?: UrduNormalizationOptions;
+    /** Common punctuation fixes (from the bundled Urdu rule list). */
+    punctuation?: PunctuationOptions;
+}): null;
+//# sourceMappingURL=AutoCorrectPlugin.d.ts.map

package/dist/autocorrect/AutoCorrectPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoCorrectPlugin.d.ts","sourceRoot":"","sources":["../../src/autocorrect/AutoCorrectPlugin.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA4E,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAUxH,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAiB,KAAK,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAG9F,sFAAsF;AACtF,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAE,cAAc,CAAC,IAAI,CAA6C,CAAC;AAMxG;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACP,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,WAAW,GACZ,EAAE;IACD,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,MAAM,EAAE,OAAO,CAAC;IAChB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,QA4FA"}

package/dist/autocorrect/AutoCorrectPlugin.js

@@ -0,0 +1,108 @@
+import { useEffect, useRef } from 'react';
+import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
+import { $getSelection, $isRangeSelection, COMMAND_PRIORITY_EDITOR, createCommand } from 'lexical';
+import { $correctDocument, $correctPunctuationBeforeCaret, $correctPunctuationDocument, $correctWordBeforeCaret, $preservingSelection, $spacePunctuationDocument, } from './autoCorrectActions.js';
+import { $cleanUpText } from '../cleanup/textCleanupActions.js';
+import { activePunctuationRules } from './punctuationRules.js';
+import { loadAutoCorrections } from './autoCorrectStores.js';
+import { normalizeUrdu } from '../normalization/urduNormalize.js';
+/** Keys that end a word: a space or punctuation, in Latin and Arabic-script forms. */
+/** Corrects every word in the document, e.g. after pasting or loading content. */
+export const CORRECT_DOCUMENT_COMMAND = createCommand('CORRECT_DOCUMENT_COMMAND');
+const BOUNDARY_KEYS = new Set([' ', '.', ',', ';', ':', '!', '?', '،', '؛', '؟', '۔']);
+const LANGUAGES = ['en', 'ur', 'pa-shahmukhi'];
+const RTL_LANGUAGES = ['ur', 'pa-shahmukhi'];
+/**
+ * Corrects typed words as the user finishes them, the way the reference editor
+ * does, but from any set of stores. Corrections are loaded once per change
+ * of `stores` or `version` (bump `version` after saving a new correction so
+ * the table reloads). The table used depends on the block's direction: RTL
+ * blocks use the Urdu and Shahmukhi tables, LTR blocks the English one.
+ */
+export function AutoCorrectPlugin({ stores, version, enabled, typing, urduNormalization, punctuation, }) {
+    const [editor] = useLexicalComposerContext();
+    // Effects below run once per editor, so they reach the latest options through this ref.
+    const normalizeOptions = useRef(urduNormalization);
+    normalizeOptions.current = urduNormalization;
+    const punctuationRules = useRef(activePunctuationRules(punctuation));
+    punctuationRules.current = activePunctuationRules(punctuation);
+    const normalizeRtl = (text) => normalizeUrdu(text, normalizeOptions.current);
+    const tables = useRef(new Map());
+    const rtlTable = useRef(new Map());
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let active = true;
+        Promise.all(LANGUAGES.map(async (language) => [language, await loadAutoCorrections(stores, language)])).then((loaded) => {
+            if (!active)
+                return;
+            tables.current = new Map(loaded);
+            // Urdu and Shahmukhi share right-to-left blocks, so both apply there; Urdu wins a clash.
+            const combined = new Map();
+            for (const language of RTL_LANGUAGES) {
+                for (const [from, to] of tables.current.get(language) ?? [])
+                    if (!combined.has(from))
+                        combined.set(from, to);
+            }
+            rtlTable.current = combined;
+        });
+        return () => {
+            active = false;
+        };
+    }, [stores, version, enabled]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        return editor.registerCommand(CORRECT_DOCUMENT_COMMAND, () => {
+            editor.update(() => {
+                $preservingSelection(() => {
+                    $cleanUpText();
+                    if (punctuation?.spacing)
+                        $spacePunctuationDocument();
+                    $correctPunctuationDocument(punctuationRules.current);
+                    $correctDocument(tables.current.get('en') ?? new Map(), rtlTable.current, normalizeRtl);
+                });
+            }, { discrete: true });
+            return true;
+        }, COMMAND_PRIORITY_EDITOR);
+    }, [editor, enabled, punctuation?.spacing]);
+    useEffect(() => {
+        if (!enabled || !typing)
+            return;
+        const tableFor = (rtl) => (rtl ? rtlTable.current : tables.current.get('en'));
+        const onKeyDown = (event) => {
+            if (event.isComposing || event.key.length !== 1)
+                return;
+            const boundary = BOUNDARY_KEYS.has(event.key);
+            // The character is inserted after this event; correct once it is there.
+            setTimeout(() => {
+                editor.update(() => {
+                    const selection = $getSelection();
+                    if (!$isRangeSelection(selection))
+                        return;
+                    // Punctuation can end in any character (e.g. the letter ه), so every key is checked.
+                    $correctPunctuationBeforeCaret(punctuationRules.current);
+                    if (!boundary)
+                        return;
+                    const block = selection.anchor.getNode().getTopLevelElement();
+                    const rtl = block?.getDirection() === 'rtl';
+                    const table = tableFor(rtl);
+                    if (table)
+                        $correctWordBeforeCaret(table, rtl ? normalizeRtl : undefined);
+                }, { discrete: true });
+            }, 0);
+        };
+        let root = null;
+        const attach = (next) => {
+            root?.removeEventListener('keydown', onKeyDown);
+            root = next;
+            root?.addEventListener('keydown', onKeyDown);
+        };
+        const unregister = editor.registerRootListener((next) => attach(next));
+        return () => {
+            unregister();
+            attach(null);
+        };
+    }, [editor, enabled, typing]);
+    return null;
+}

package/dist/autocorrect/autoCorrectActions.d.ts

@@ -0,0 +1,35 @@
+import { type PunctuationRule } from './punctuationRules.js';
+/**
+ * Corrects the word that ends just before the caret, when the character just
+ * typed (the word boundary: space or punctuation) is not a word character. The
+ * correction replaces only the word, and the caret stays right after the
+ * boundary. Returns true if a correction was made.
+ */
+export declare function $correctWordBeforeCaret(table: Map<string, string>, normalize?: (word: string) => string): boolean;
+/**
+ * Corrects every whole word in the document, for text that never went through
+ * typing (pasted or loaded content). Words are found per paragraph or cell, so a
+ * word split by formatting is still one word. Each block uses the table for its
+ * direction. Returns how many words were corrected.
+ */
+export declare function $correctDocument(ltr: Map<string, string>, rtl: Map<string, string>, normalizeRtl?: (text: string) => string): number;
+/**
+ * Applies a punctuation rule to the text just before the caret, when that text
+ * ends with a rule's incorrect form. Longest match first. The caret ends after
+ * the replacement.
+ */
+export declare function $correctPunctuationBeforeCaret(rules: PunctuationRule[]): boolean;
+/**
+ * Applies the punctuation rules to every paragraph and cell in the document.
+ * Where two matches overlap, the longer one wins. Returns how many were applied.
+ */
+export declare function $correctPunctuationDocument(rules: PunctuationRule[]): number;
+/**
+ * Runs `change` and then puts the caret back where it was. Replacements move the
+ * selection onto each match they make, so a whole-document pass would otherwise
+ * leave the caret at the last match, or at the end of the document.
+ */
+export declare function $preservingSelection(change: () => void): void;
+/** Applies urduhack-style punctuation spacing to every text node. Returns how many changed. */
+export declare function $spacePunctuationDocument(): number;
+//# sourceMappingURL=autoCorrectActions.d.ts.map

package/dist/autocorrect/autoCorrectActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoCorrectActions.d.ts","sourceRoot":"","sources":["../../src/autocorrect/autoCorrectActions.ts"],"names":[],"mappings":"AAWA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMhF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAiCjH;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACxB,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACxB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACtC,MAAM,CA8BR;AAQD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAqBhF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CA2B5E;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAoB7D;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,IAAI,MAAM,CAWlD"}

package/dist/autocorrect/autoCorrectActions.js

@@ -0,0 +1,182 @@
+import { $createRangeSelection, $getNodeByKey, $getRoot, $getSelection, $isRangeSelection, $isTextNode, $setSelection, } from 'lexical';
+import { $locate, $replaceMatch, $textGroups } from '../find/findReplaceActions.js';
+import { wordsIn } from '../spellcheck/spellDictionaries.js';
+import { spacePunctuationText } from './punctuationRules.js';
+/** The part of a word that counts as word characters at its end. */
+const WORD_END = /[\p{L}\p{M}'’]+$/u;
+const WORD_CHAR = /[\p{L}\p{M}'’]/u;
+/**
+ * Corrects the word that ends just before the caret, when the character just
+ * typed (the word boundary: space or punctuation) is not a word character. The
+ * correction replaces only the word, and the caret stays right after the
+ * boundary. Returns true if a correction was made.
+ */
+export function $correctWordBeforeCaret(table, normalize) {
+    const selection = $getSelection();
+    if (!$isRangeSelection(selection) || !selection.isCollapsed())
+        return false;
+    const anchor = selection.anchor;
+    const node = anchor.getNode();
+    if (!$isTextNode(node))
+        return false;
+    const before = node.getTextContent().slice(0, anchor.offset);
+    const boundary = before.slice(-1);
+    if (boundary === '' || WORD_CHAR.test(boundary))
+        return false;
+    const body = before.slice(0, -1);
+    const word = WORD_END.exec(body)?.[0];
+    if (!word)
+        return false;
+    const replacement = correctionFor(word, table, normalize);
+    if (replacement === undefined || replacement === word)
+        return false;
+    const start = body.length - word.length;
+    $replaceMatch({ anchorKey: node.getKey(), anchorOffset: start, focusKey: node.getKey(), focusOffset: body.length }, replacement);
+    // Put the caret back after the boundary the user typed, not at the end of the replacement.
+    const after = $getSelection();
+    if ($isRangeSelection(after)) {
+        const focusNode = after.focus.getNode();
+        const caret = after.focus.offset + boundary.length;
+        after.anchor.set(focusNode.getKey(), caret, 'text');
+        after.focus.set(focusNode.getKey(), caret, 'text');
+    }
+    return true;
+}
+/**
+ * Corrects every whole word in the document, for text that never went through
+ * typing (pasted or loaded content). Words are found per paragraph or cell, so a
+ * word split by formatting is still one word. Each block uses the table for its
+ * direction. Returns how many words were corrected.
+ */
+export function $correctDocument(ltr, rtl, normalizeRtl) {
+    if (normalizeRtl) {
+        for (const node of $getRoot().getAllTextNodes()) {
+            if (node.getParentOrThrow().getDirection() !== 'rtl')
+                continue;
+            const text = node.getTextContent();
+            const normalized = normalizeRtl(text);
+            if (normalized !== text)
+                node.setTextContent(normalized);
+        }
+    }
+    let corrected = 0;
+    for (const group of $textGroups()) {
+        const rightToLeft = group[0].getParentOrThrow().getDirection() === 'rtl';
+        const table = rightToLeft ? rtl : ltr;
+        const text = group.map((node) => node.getTextContent()).join('');
+        const spans = wordsIn(text)
+            .map((span) => ({ span, replacement: correctionFor(span.word, table, rightToLeft ? normalizeRtl : undefined) }))
+            .filter((item) => item.replacement !== undefined && item.replacement !== item.span.word);
+        // Right to left, so earlier positions stay valid as each word is replaced.
+        for (const { span, replacement } of spans.reverse()) {
+            const start = $locate(group, span.start, false);
+            const end = $locate(group, span.end, true);
+            $replaceMatch({ anchorKey: start.key, anchorOffset: start.offset, focusKey: end.key, focusOffset: end.offset }, replacement);
+            corrected += 1;
+        }
+    }
+    return corrected;
+}
+/** What a word should become: its normalised form, then any table correction for that. */
+function correctionFor(word, table, normalize) {
+    const normalized = normalize ? normalize(word) : word;
+    return table.get(normalized) ?? (normalized !== word ? normalized : undefined);
+}
+/**
+ * Applies a punctuation rule to the text just before the caret, when that text
+ * ends with a rule's incorrect form. Longest match first. The caret ends after
+ * the replacement.
+ */
+export function $correctPunctuationBeforeCaret(rules) {
+    const selection = $getSelection();
+    if (!$isRangeSelection(selection) || !selection.isCollapsed())
+        return false;
+    const anchor = selection.anchor;
+    const node = anchor.getNode();
+    if (!$isTextNode(node))
+        return false;
+    const before = node.getTextContent().slice(0, anchor.offset);
+    const rule = rules.find((r) => before.endsWith(r.incorrect) && (!r.completeWord || !WORD_CHAR.test(before.charAt(before.length - r.incorrect.length - 1) || ' ')));
+    if (!rule)
+        return false;
+    const start = before.length - rule.incorrect.length;
+    $replaceMatch({ anchorKey: node.getKey(), anchorOffset: start, focusKey: node.getKey(), focusOffset: before.length }, rule.correct);
+    const after = $getSelection();
+    if ($isRangeSelection(after)) {
+        const caret = start + rule.correct.length;
+        after.anchor.set(node.getKey(), caret, 'text');
+        after.focus.set(node.getKey(), caret, 'text');
+    }
+    return true;
+}
+/**
+ * Applies the punctuation rules to every paragraph and cell in the document.
+ * Where two matches overlap, the longer one wins. Returns how many were applied.
+ */
+export function $correctPunctuationDocument(rules) {
+    let applied = 0;
+    for (const group of $textGroups()) {
+        const text = group.map((node) => node.getTextContent()).join('');
+        const candidates = [];
+        for (const rule of rules) {
+            let index = text.indexOf(rule.incorrect);
+            while (index !== -1) {
+                candidates.push({ start: index, end: index + rule.incorrect.length, correct: rule.correct });
+                index = text.indexOf(rule.incorrect, index + 1);
+            }
+        }
+        // Longest first, then earliest; keep only matches that do not overlap a kept one.
+        candidates.sort((a, b) => b.end - b.start - (a.end - a.start) || a.start - b.start);
+        const kept = [];
+        for (const c of candidates) {
+            if (!kept.some((k) => c.start < k.end && k.start < c.end))
+                kept.push(c);
+        }
+        // Right to left, so earlier positions stay valid as each match is replaced.
+        for (const c of kept.sort((a, b) => b.start - a.start)) {
+            const start = $locate(group, c.start, false);
+            const end = $locate(group, c.end, true);
+            $replaceMatch({ anchorKey: start.key, anchorOffset: start.offset, focusKey: end.key, focusOffset: end.offset }, c.correct);
+            applied += 1;
+        }
+    }
+    return applied;
+}
+/**
+ * Runs `change` and then puts the caret back where it was. Replacements move the
+ * selection onto each match they make, so a whole-document pass would otherwise
+ * leave the caret at the last match, or at the end of the document.
+ */
+export function $preservingSelection(change) {
+    const before = $getSelection();
+    const saved = $isRangeSelection(before)
+        ? {
+            anchor: { key: before.anchor.key, offset: before.anchor.offset, type: before.anchor.type },
+            focus: { key: before.focus.key, offset: before.focus.offset, type: before.focus.type },
+        }
+        : null;
+    change();
+    if (!saved) {
+        $setSelection(null);
+        return;
+    }
+    if (!$getNodeByKey(saved.anchor.key) || !$getNodeByKey(saved.focus.key))
+        return;
+    const selection = $createRangeSelection();
+    selection.anchor.set(saved.anchor.key, saved.anchor.offset, saved.anchor.type);
+    selection.focus.set(saved.focus.key, saved.focus.offset, saved.focus.type);
+    $setSelection(selection);
+}
+/** Applies urduhack-style punctuation spacing to every text node. Returns how many changed. */
+export function $spacePunctuationDocument() {
+    let changed = 0;
+    for (const node of $getRoot().getAllTextNodes()) {
+        const text = node.getTextContent();
+        const spaced = spacePunctuationText(text);
+        if (spaced !== text) {
+            node.setTextContent(spaced);
+            changed += 1;
+        }
+    }
+    return changed;
+}

package/dist/autocorrect/autoCorrectStores.d.ts

@@ -0,0 +1,52 @@
+import type { SpellLanguage } from '../spellcheck/spellDictionaries.js';
+/** One correction: a typed word and what it should become. */
+export interface AutoCorrectEntry {
+    from: string;
+    to: string;
+}
+/**
+ * Where auto-corrections come from and go. The host supplies any number of
+ * stores; corrections from all of them are merged, and when two stores
+ * correct the same word, the one listed first wins. New corrections are
+ * appended to the first store that accepts writes.
+ */
+export interface AutoCorrectStore {
+    readonly id: string;
+    /** A store without `append` (or with `readOnly`) is never written to. */
+    readonly readOnly?: boolean;
+    load(language: SpellLanguage): Promise<AutoCorrectEntry[]>;
+    append?(language: SpellLanguage, entry: AutoCorrectEntry): Promise<void>;
+}
+/**
+ * Corrections kept in this browser's localStorage. Storage can be disabled or
+ * full, so every access is guarded: a failure means "no corrections", never a
+ * broken editor.
+ */
+export declare function localStorageAutoCorrectStore(options?: {
+    key?: string;
+}): AutoCorrectStore;
+/**
+ * Corrections served by an API. `load` calls `GET {url}?language=xx` and expects
+ * a JSON array of `{ from, to }`; `append` calls `POST {url}` with
+ * `{ language, from, to }`. Credentials and headers belong to the host.
+ */
+export declare function apiAutoCorrectStore(options: {
+    id?: string;
+    url: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}): AutoCorrectStore;
+/**
+ * Corrections from a JSON file the host publishes — a list of `{ language, from, to }`.
+ * Read-only: it has no way to write back to a static file.
+ */
+export declare function fileAutoCorrectStore(options: {
+    id?: string;
+    url: string;
+    fetch?: typeof fetch;
+}): AutoCorrectStore;
+/** Corrections for one language, merged across stores. Failing stores are skipped. */
+export declare function loadAutoCorrections(stores: AutoCorrectStore[], language: SpellLanguage): Promise<Map<string, string>>;
+/** Saves a correction to the first store that accepts writes. Returns false if none does. */
+export declare function appendAutoCorrection(stores: AutoCorrectStore[], language: SpellLanguage, entry: AutoCorrectEntry): Promise<boolean>;
+//# sourceMappingURL=autoCorrectStores.d.ts.map

package/dist/autocorrect/autoCorrectStores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoCorrectStores.d.ts","sourceRoot":"","sources":["../../src/autocorrect/autoCorrectStores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAkBD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CA6B7F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,GAAG,gBAAgB,CAmBnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,gBAAgB,CAkBlH;AAED,sFAAsF;AACtF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQ3H;AAED,6FAA6F;AAC7F,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKzI"}

package/dist/autocorrect/autoCorrectStores.js

@@ -0,0 +1,115 @@
+const STORAGE_KEY = 'likhari-autocorrect';
+function isEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.from === 'string' &&
+        typeof value.to === 'string' &&
+        value.from !== '');
+}
+/**
+ * Corrections kept in this browser's localStorage. Storage can be disabled or
+ * full, so every access is guarded: a failure means "no corrections", never a
+ * broken editor.
+ */
+export function localStorageAutoCorrectStore(options = {}) {
+    const key = options.key ?? STORAGE_KEY;
+    function readAll() {
+        try {
+            const parsed = JSON.parse(localStorage.getItem(key) ?? '[]');
+            return Array.isArray(parsed) ? parsed.filter((e) => isEntry(e) && 'language' in e) : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    return {
+        id: 'local-storage',
+        async load(language) {
+            return readAll()
+                .filter((e) => e.language === language)
+                .map(({ from, to }) => ({ from, to }));
+        },
+        async append(language, entry) {
+            const all = readAll().filter((e) => !(e.language === language && e.from === entry.from));
+            all.push({ language, from: entry.from, to: entry.to });
+            try {
+                localStorage.setItem(key, JSON.stringify(all));
+            }
+            catch {
+                // Quota exceeded or storage disabled: the correction is kept for this session only.
+            }
+        },
+    };
+}
+/**
+ * Corrections served by an API. `load` calls `GET {url}?language=xx` and expects
+ * a JSON array of `{ from, to }`; `append` calls `POST {url}` with
+ * `{ language, from, to }`. Credentials and headers belong to the host.
+ */
+export function apiAutoCorrectStore(options) {
+    const doFetch = options.fetch ?? fetch;
+    return {
+        id: options.id ?? 'api',
+        async load(language) {
+            const response = await doFetch(`${options.url}?language=${encodeURIComponent(language)}`, { headers: options.headers });
+            if (!response.ok)
+                throw new Error(`Auto-correct API failed: ${response.status}`);
+            const data = await response.json();
+            return Array.isArray(data) ? data.filter(isEntry).map(({ from, to }) => ({ from, to })) : [];
+        },
+        async append(language, entry) {
+            const response = await doFetch(options.url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...options.headers },
+                body: JSON.stringify({ language, from: entry.from, to: entry.to }),
+            });
+            if (!response.ok)
+                throw new Error(`Auto-correct API rejected the entry: ${response.status}`);
+        },
+    };
+}
+/**
+ * Corrections from a JSON file the host publishes — a list of `{ language, from, to }`.
+ * Read-only: it has no way to write back to a static file.
+ */
+export function fileAutoCorrectStore(options) {
+    const doFetch = options.fetch ?? fetch;
+    let cached = null;
+    const all = () => {
+        cached ?? (cached = doFetch(options.url).then(async (response) => {
+            if (!response.ok)
+                throw new Error(`Auto-correct file failed: ${response.status}`);
+            const data = await response.json();
+            return Array.isArray(data) ? data.filter((e) => isEntry(e) && 'language' in e) : [];
+        }));
+        return cached;
+    };
+    return {
+        id: options.id ?? 'file',
+        readOnly: true,
+        async load(language) {
+            return (await all()).filter((e) => e.language === language).map(({ from, to }) => ({ from, to }));
+        },
+    };
+}
+/** Corrections for one language, merged across stores. Failing stores are skipped. */
+export async function loadAutoCorrections(stores, language) {
+    const table = new Map();
+    const results = await Promise.allSettled(stores.map((store) => store.load(language)));
+    results.forEach((result) => {
+        if (result.status !== 'fulfilled')
+            return;
+        for (const entry of result.value)
+            if (!table.has(entry.from))
+                table.set(entry.from, entry.to);
+    });
+    return table;
+}
+/** Saves a correction to the first store that accepts writes. Returns false if none does. */
+export async function appendAutoCorrection(stores, language, entry) {
+    const writable = stores.find((store) => !store.readOnly && store.append);
+    if (!writable?.append)
+        return false;
+    await writable.append(language, entry);
+    return true;
+}