import { type EditorCommit, type Range, RangeApi, type Selection, type SelectionValue, SelectionApi, } from '../..'; import type { EditableInputController } from './input-state'; import { setEditableModelSelectionPreference } from './selection-controller'; type SelectorListener = (change?: EditorCommit) => void; type SelectorSubscriptionOptions = { profileId?: string; shouldUpdate?: (change?: EditorCommit) => boolean; }; type AddSelectorEventListener = ( listener: SelectorListener, options?: SelectorSubscriptionOptions ) => () => void; type CancelScheduledDOMExport = () => void; type ScheduleDOMExport = ( callback: () => void ) => CancelScheduledDOMExport | void; type SyncDOMSelectionToEditor = (options?: { forceModelExport?: boolean; }) => void; export const shouldExportModelSelectionToDOM = ( inputController: EditableInputController, { commit, modelSelection, }: { commit?: EditorCommit; modelSelection?: Selection; } = {} ) => { if ( commit?.tags.includes('semantic-command') && commit?.changed.hasAny('document') && modelSelection && (SelectionApi.isNode(modelSelection) || (RangeApi.isRange(modelSelection) && RangeApi.isExpanded(modelSelection))) ) { return true; } return ( inputController.state.selectionChangeOrigin !== 'native-user' && inputController.state.selectionSource !== 'dom-current' ); }; export const isTextInputSelectionHandledByCaretRepair = ( inputController: EditableInputController, commit?: EditorCommit ) => Boolean( inputController.state.activeIntent === 'text-insert' && !inputController.state.isComposing && commit?.changed.hasAny('document') && commit.selectionChanged && !commit.changed.hasAny('structure') && !commit.changed.hasAny('root-order') ); const isSyncedTextOnlySelectionCommit = ( commit?: EditorCommit, inputController?: EditableInputController ) => { if ( !inputController || inputController.state.isComposing || !commit?.changed.hasAny('text') || !commit.selectionChanged || commit.changed.hasAny('structure') || commit.changed.hasAny('properties') || commit.changed.hasAny('root-order') ) { return false; } if (commit.tags.includes('semantic-command')) { return false; } return true; }; export const shouldSyncModelSelectionAfterCommit = ( commit?: EditorCommit, inputController?: EditableInputController ) => { if ( inputController && isTextInputSelectionHandledByCaretRepair(inputController, commit) ) { return ( inputController.state.modelSelectionPreference?.reason === 'repair-induced' ); } if (isSyncedTextOnlySelectionCommit(commit, inputController)) { return false; } return Boolean( commit?.selectionChanged || commit?.changed.hasAny('structure') || commit?.changed.hasAny('root-order') ); }; export const subscribeSelectionOnlyDOMExport = ({ addSelectorEventListener, getDOMSelectionProjection, getModelSelection = () => null, inputController, scheduleDOMExport, shouldSkipDOMExport, syncDOMSelectionToEditor, }: { addSelectorEventListener: AddSelectorEventListener; getDOMSelectionProjection?: (selection: SelectionValue) => Range | null; getModelSelection?: () => Selection; inputController: EditableInputController; scheduleDOMExport: ScheduleDOMExport; shouldSkipDOMExport?: ( selection: Range | null, commit?: EditorCommit ) => boolean; syncDOMSelectionToEditor: SyncDOMSelectionToEditor; }) => { let pendingDOMExport: { cancel: CancelScheduledDOMExport; generation: number; } | null = null; let nextDOMExportGeneration = 0; let subscribed = true; const readProjection = () => { const modelSelection = getModelSelection(); const projectedSelection = modelSelection ? getDOMSelectionProjection ? getDOMSelectionProjection(modelSelection) : RangeApi.isRange(modelSelection) ? modelSelection : null : null; return { modelSelection, projectedSelection, requiresProjectedExport: !!modelSelection && !!getDOMSelectionProjection && (!projectedSelection || !RangeApi.isRange(modelSelection) || !RangeApi.equals(modelSelection, projectedSelection)), }; }; const unsubscribeSelector = addSelectorEventListener( (commit) => { const sync = () => { if (!subscribed) { return; } const { modelSelection, projectedSelection, requiresProjectedExport } = readProjection(); if (shouldSkipDOMExport?.(projectedSelection, commit)) { return; } if ( !requiresProjectedExport && !shouldExportModelSelectionToDOM(inputController, { commit, modelSelection, }) ) { return; } if (requiresProjectedExport) { setEditableModelSelectionPreference({ inputController, preferModelSelection: true, reason: 'programmatic-export', selectionSource: 'model-owned', }); inputController.state.selectionChangeOrigin = 'programmatic-export'; } syncDOMSelectionToEditor( requiresProjectedExport ? { forceModelExport: true } : undefined ); }; if (commit?.changed.hasAny('document')) { nextDOMExportGeneration += 1; const generation = nextDOMExportGeneration; pendingDOMExport?.cancel(); pendingDOMExport = null; let cancelScheduledDOMExport: CancelScheduledDOMExport | undefined; let didRunScheduledDOMExport = false; const runScheduledDOMExport = () => { didRunScheduledDOMExport = true; if (!subscribed || generation !== nextDOMExportGeneration) { return; } if (pendingDOMExport?.generation === generation) { pendingDOMExport = null; } sync(); }; const nextCancelScheduledDOMExport = scheduleDOMExport( runScheduledDOMExport ); if (nextCancelScheduledDOMExport) { cancelScheduledDOMExport = nextCancelScheduledDOMExport; if (subscribed && !didRunScheduledDOMExport) { pendingDOMExport = { cancel: cancelScheduledDOMExport, generation, }; } else if (!didRunScheduledDOMExport) { cancelScheduledDOMExport(); } } } else { sync(); } }, { profileId: 'selection-dom-export', shouldUpdate: (commit) => shouldSyncModelSelectionAfterCommit(commit, inputController) || (!!commit?.changed.hasAny('document') && readProjection().requiresProjectedExport), } ); return () => { subscribed = false; nextDOMExportGeneration += 1; pendingDOMExport?.cancel(); pendingDOMExport = null; unsubscribeSelector(); }; };