roosterjs-content-model-core 0.20.0

package/lib-mjs/publicApi/model/paste.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/model/paste.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChangeSource } from '../../constants/ChangeSource';\nimport { GetContentMode, PasteType as OldPasteType, PluginEventType } from 'roosterjs-editor-types';\nimport { getSelectedSegments } from '../selection/collectSelections';\nimport { mergeModel } from './mergeModel';\nimport type {\n    ContentModelDocument,\n    ContentModelSegmentFormat,\n    FormatWithContentModelContext,\n    InsertPoint,\n    PasteType,\n    ContentModelBeforePasteEventData,\n    ContentModelBeforePasteEvent,\n    IStandaloneEditor,\n} from 'roosterjs-content-model-types';\nimport type { ClipboardData, IEditor } from 'roosterjs-editor-types';\nimport {\n    applySegmentFormatToElement,\n    createDomToModelContext,\n    domToContentModel,\n    moveChildNodes,\n} from 'roosterjs-content-model-dom';\nimport {\n    createDefaultHtmlSanitizerOptions,\n    handleImagePaste,\n    handleTextPaste,\n    retrieveMetadataFromClipboard,\n    sanitizePasteContent,\n} from 'roosterjs-editor-dom';\n\n// Map new PasteType to old PasteType\n// TODO: We can remove this once we have standalone editor\nconst PasteTypeMap: Record<PasteType, OldPasteType> = {\n    asImage: OldPasteType.AsImage,\n    asPlainText: OldPasteType.AsPlainText,\n    mergeFormat: OldPasteType.MergeFormat,\n    normal: OldPasteType.Normal,\n};\nconst EmptySegmentFormat: Required<ContentModelSegmentFormat> = {\n    backgroundColor: '',\n    fontFamily: '',\n    fontSize: '',\n    fontWeight: '',\n    italic: false,\n    letterSpacing: '',\n    lineHeight: '',\n    strikethrough: false,\n    superOrSubScriptSequence: '',\n    textColor: '',\n    underline: false,\n};\n\n/**\n * Paste into editor using a clipboardData object\n * @param editor The editor to paste content into\n * @param clipboardData Clipboard data retrieved from clipboard\n * @param pasteType Type of content to paste. @default normal\n */\nexport function paste(\n    editor: IStandaloneEditor & IEditor,\n    clipboardData: ClipboardData,\n    pasteType: PasteType = 'normal'\n) {\n    if (clipboardData.snapshotBeforePaste) {\n        // Restore original content before paste a new one\n        editor.setContent(clipboardData.snapshotBeforePaste);\n    } else {\n        clipboardData.snapshotBeforePaste = editor.getContent(GetContentMode.RawHTMLWithSelection);\n    }\n\n    editor.focus();\n    let originalFormat: ContentModelSegmentFormat | undefined;\n\n    editor.formatContentModel(\n        (model, context) => {\n            const eventData = createBeforePasteEventData(editor, clipboardData, pasteType);\n            const currentSegment = getSelectedSegments(model, true /*includingFormatHolder*/)[0];\n            const { fontFamily, fontSize, textColor, backgroundColor, letterSpacing, lineHeight } =\n                currentSegment?.format ?? {};\n            const {\n                domToModelOption,\n                fragment,\n                customizedMerge,\n            } = triggerPluginEventAndCreatePasteFragment(\n                editor,\n                clipboardData,\n                pasteType,\n                eventData,\n                { fontFamily, fontSize, textColor, backgroundColor, letterSpacing, lineHeight }\n            );\n\n            const pasteModel = domToContentModel(\n                fragment,\n                createDomToModelContext(undefined /*editorContext*/, domToModelOption)\n            );\n\n            const insertPoint = mergePasteContent(\n                model,\n                context,\n                pasteModel,\n                pasteType == 'mergeFormat',\n                customizedMerge\n            );\n\n            if (insertPoint) {\n                originalFormat = insertPoint.marker.format;\n            }\n\n            if (originalFormat) {\n                context.newPendingFormat = { ...EmptySegmentFormat, ...originalFormat }; // Use empty format as initial value to clear any other format inherits from pasted content\n            }\n\n            return true;\n        },\n\n        {\n            changeSource: ChangeSource.Paste,\n            getChangeData: () => clipboardData,\n            apiName: 'paste',\n        }\n    );\n}\n\n/**\n * @internal\n * Export only for unit test\n */\nexport function mergePasteContent(\n    model: ContentModelDocument,\n    context: FormatWithContentModelContext,\n    pasteModel: ContentModelDocument,\n    applyCurrentFormat: boolean,\n    customizedMerge:\n        | undefined\n        | ((source: ContentModelDocument, target: ContentModelDocument) => InsertPoint | null)\n): InsertPoint | null {\n    return customizedMerge\n        ? customizedMerge(model, pasteModel)\n        : mergeModel(model, pasteModel, context, {\n              mergeFormat: applyCurrentFormat ? 'keepSourceEmphasisFormat' : 'none',\n              mergeTable: shouldMergeTable(pasteModel),\n          });\n}\n\nfunction shouldMergeTable(pasteModel: ContentModelDocument): boolean | undefined {\n    // If model contains a table and a paragraph element after the table with a single BR segment, remove the Paragraph after the table\n    if (\n        pasteModel.blocks.length == 2 &&\n        pasteModel.blocks[0].blockType === 'Table' &&\n        pasteModel.blocks[1].blockType === 'Paragraph' &&\n        pasteModel.blocks[1].segments.length === 1 &&\n        pasteModel.blocks[1].segments[0].segmentType === 'Br'\n    ) {\n        pasteModel.blocks.splice(1);\n    }\n    // Only merge table when the document contain a single table.\n    return pasteModel.blocks.length === 1 && pasteModel.blocks[0].blockType === 'Table';\n}\n\nfunction createBeforePasteEventData(\n    editor: IEditor,\n    clipboardData: ClipboardData,\n    pasteType: PasteType\n): ContentModelBeforePasteEventData {\n    const options = createDefaultHtmlSanitizerOptions();\n\n    // Remove \"caret-color\" style generated by Safari to make sure caret shows in right color after paste\n    options.cssStyleCallbacks['caret-color'] = () => false;\n\n    return {\n        clipboardData,\n        fragment: editor.getDocument().createDocumentFragment(),\n        sanitizingOption: options,\n        htmlBefore: '',\n        htmlAfter: '',\n        htmlAttributes: {},\n        domToModelOption: {},\n        pasteType: PasteTypeMap[pasteType],\n    };\n}\n\n/**\n * This function is used to create a BeforePasteEvent object after trigger the event, so other plugins can modify the event object\n * This function will also create a DocumentFragment for paste.\n */\nfunction triggerPluginEventAndCreatePasteFragment(\n    editor: IEditor,\n    clipboardData: ClipboardData,\n    pasteType: PasteType,\n    eventData: ContentModelBeforePasteEventData,\n    currentFormat: ContentModelSegmentFormat\n): ContentModelBeforePasteEventData {\n    const event = {\n        eventType: PluginEventType.BeforePaste,\n        ...eventData,\n    } as ContentModelBeforePasteEvent;\n\n    const { fragment } = event;\n    const { rawHtml, text, imageDataUri } = clipboardData;\n    const trustedHTMLHandler = editor.getTrustedHTMLHandler();\n\n    const doc: Document | undefined = rawHtml\n        ? new DOMParser().parseFromString(trustedHTMLHandler(rawHtml), 'text/html')\n        : undefined;\n\n    // Step 2: Retrieve Metadata from Html and the Html that was copied.\n    retrieveMetadataFromClipboard(doc, event, trustedHTMLHandler);\n\n    // Step 3: Fill the BeforePasteEvent object, especially the fragment for paste\n    if (\n        (pasteType == 'asImage' && imageDataUri) ||\n        (pasteType != 'asPlainText' && !text && imageDataUri)\n    ) {\n        // Paste image\n        handleImagePaste(imageDataUri, fragment);\n    } else if (pasteType != 'asPlainText' && rawHtml && doc ? doc.body : false) {\n        moveChildNodes(fragment, doc?.body);\n    } else if (text) {\n        // Paste text\n        handleTextPaste(text, null /*position*/, fragment);\n    }\n\n    const formatContainer = fragment.ownerDocument.createElement('span');\n\n    moveChildNodes(formatContainer, fragment);\n    fragment.appendChild(formatContainer);\n\n    applySegmentFormatToElement(formatContainer, currentFormat);\n\n    let pluginEvent: ContentModelBeforePasteEvent = event;\n\n    // Step 4: Trigger BeforePasteEvent so that plugins can do proper change before paste, when the type of paste is different than Plain Text\n    if (pasteType !== 'asPlainText') {\n        pluginEvent = editor.triggerPluginEvent(\n            PluginEventType.BeforePaste,\n            event,\n            true /* broadcast */\n        ) as ContentModelBeforePasteEvent;\n    }\n\n    // Step 5. Sanitize the fragment before paste to make sure the content is safe\n    sanitizePasteContent(event, null /*position*/);\n\n    return pluginEvent;\n}\n"]}

package/lib-mjs/publicApi/selection/collectSelections.d.ts

@@ -0,0 +1,50 @@
+import type { ContentModelBlock, ContentModelBlockGroup, ContentModelBlockGroupType, ContentModelDocument, ContentModelListItem, ContentModelParagraph, ContentModelSegment, ContentModelTable } from 'roosterjs-content-model-types';
+import type { TypeOfBlockGroup } from '../model/getClosestAncestorBlockGroupIndex';
+/**
+ * Represent a pair of parent block group and child block
+ */
+export declare type OperationalBlocks<T extends ContentModelBlockGroup> = {
+    /**
+     * The parent block group
+     */
+    parent: ContentModelBlockGroup;
+    /**
+     * The child block
+     */
+    block: ContentModelBlock | T;
+};
+/**
+ * Get an array of selected parent paragraph and child segment pair
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null
+ */
+export declare function getSelectedSegmentsAndParagraphs(model: ContentModelDocument, includingFormatHolder: boolean): [ContentModelSegment, ContentModelParagraph | null][];
+/**
+ * Get an array of selected segments from a content model
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item
+ */
+export declare function getSelectedSegments(model: ContentModelDocument, includingFormatHolder: boolean): ContentModelSegment[];
+/**
+ * Get any array of selected paragraphs from a content model
+ * @param model The Content Model to get selection from
+ */
+export declare function getSelectedParagraphs(model: ContentModelDocument): ContentModelParagraph[];
+/**
+ * Get an array of block group - block pair that is of the expected block group type from selection
+ * @param model The Content Model to get selection from
+ * @param blockGroupTypes The expected block group types
+ * @param stopTypes Block group types that will stop searching when hit
+ * @param deepFirst True means search in deep first, otherwise wide first
+ */
+export declare function getOperationalBlocks<T extends ContentModelBlockGroup>(model: ContentModelDocument, blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes: ContentModelBlockGroupType[], deepFirst?: boolean): OperationalBlocks<T>[];
+/**
+ * Get the first selected table from content model
+ * @param model The Content Model to get selection from
+ */
+export declare function getFirstSelectedTable(model: ContentModelDocument): [ContentModelTable | undefined, ContentModelBlockGroup[]];
+/**
+ * Get the first selected list item from content model
+ * @param model The Content Model to get selection from
+ */
+export declare function getFirstSelectedListItem(model: ContentModelDocument): ContentModelListItem | undefined;

package/lib-mjs/publicApi/selection/collectSelections.js

@@ -0,0 +1,173 @@
+import { __read, __spreadArray } from "tslib";
+import { getClosestAncestorBlockGroupIndex } from '../model/getClosestAncestorBlockGroupIndex';
+import { isBlockGroupOfType } from '../model/isBlockGroupOfType';
+import { iterateSelections } from './iterateSelections';
+/**
+ * Get an array of selected parent paragraph and child segment pair
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null
+ */
+export function getSelectedSegmentsAndParagraphs(model, includingFormatHolder) {
+    var selections = collectSelections(model, {
+        includeListFormatHolder: includingFormatHolder ? 'allSegments' : 'never',
+    });
+    var result = [];
+    selections.forEach(function (_a) {
+        var segments = _a.segments, block = _a.block;
+        if (segments && ((includingFormatHolder && !block) || (block === null || block === void 0 ? void 0 : block.blockType) == 'Paragraph')) {
+            segments.forEach(function (segment) {
+                if (segment.segmentType != 'Entity' || !segment.entityFormat.isReadonly) {
+                    result.push([segment, (block === null || block === void 0 ? void 0 : block.blockType) == 'Paragraph' ? block : null]);
+                }
+            });
+        }
+    });
+    return result;
+}
+/**
+ * Get an array of selected segments from a content model
+ * @param model The Content Model to get selection from
+ * @param includingFormatHolder True means also include format holder as segment from list item
+ */
+export function getSelectedSegments(model, includingFormatHolder) {
+    return getSelectedSegmentsAndParagraphs(model, includingFormatHolder).map(function (x) { return x[0]; });
+}
+/**
+ * Get any array of selected paragraphs from a content model
+ * @param model The Content Model to get selection from
+ */
+export function getSelectedParagraphs(model) {
+    var selections = collectSelections(model, { includeListFormatHolder: 'never' });
+    var result = [];
+    removeUnmeaningfulSelections(selections);
+    selections.forEach(function (_a) {
+        var block = _a.block;
+        if ((block === null || block === void 0 ? void 0 : block.blockType) == 'Paragraph') {
+            result.push(block);
+        }
+    });
+    return result;
+}
+/**
+ * Get an array of block group - block pair that is of the expected block group type from selection
+ * @param model The Content Model to get selection from
+ * @param blockGroupTypes The expected block group types
+ * @param stopTypes Block group types that will stop searching when hit
+ * @param deepFirst True means search in deep first, otherwise wide first
+ */
+export function getOperationalBlocks(model, blockGroupTypes, stopTypes, deepFirst) {
+    var result = [];
+    var findSequence = deepFirst ? blockGroupTypes.map(function (type) { return [type]; }) : [blockGroupTypes];
+    var selections = collectSelections(model, {
+        includeListFormatHolder: 'never',
+        contentUnderSelectedTableCell: 'ignoreForTable', // When whole table is selected, we treat the table as a single block
+    });
+    removeUnmeaningfulSelections(selections);
+    selections.forEach(function (_a) {
+        var path = _a.path, block = _a.block;
+        var _loop_1 = function (i) {
+            var groupIndex = getClosestAncestorBlockGroupIndex(path, findSequence[i], stopTypes);
+            if (groupIndex >= 0) {
+                if (result.filter(function (x) { return x.block == path[groupIndex]; }).length <= 0) {
+                    result.push({
+                        parent: path[groupIndex + 1],
+                        block: path[groupIndex],
+                    });
+                }
+                return "break";
+            }
+            else if (i == findSequence.length - 1 && block) {
+                result.push({
+                    parent: path[0],
+                    block: block,
+                });
+                return "break";
+            }
+        };
+        for (var i = 0; i < findSequence.length; i++) {
+            var state_1 = _loop_1(i);
+            if (state_1 === "break")
+                break;
+        }
+    });
+    return result;
+}
+/**
+ * Get the first selected table from content model
+ * @param model The Content Model to get selection from
+ */
+export function getFirstSelectedTable(model) {
+    var selections = collectSelections(model, { includeListFormatHolder: 'never' });
+    var table;
+    var resultPath = [];
+    removeUnmeaningfulSelections(selections);
+    selections.forEach(function (_a) {
+        var block = _a.block, tableContext = _a.tableContext, path = _a.path;
+        if (!table) {
+            if ((block === null || block === void 0 ? void 0 : block.blockType) == 'Table') {
+                table = block;
+                resultPath = __spreadArray([], __read(path), false);
+            }
+            else if (tableContext === null || tableContext === void 0 ? void 0 : tableContext.table) {
+                table = tableContext.table;
+                var parent_1 = path.filter(function (group) { return group.blocks.indexOf(tableContext.table) >= 0; })[0];
+                var index = path.indexOf(parent_1);
+                resultPath = index >= 0 ? path.slice(index) : [];
+            }
+        }
+    });
+    return [table, resultPath];
+}
+/**
+ * Get the first selected list item from content model
+ * @param model The Content Model to get selection from
+ */
+export function getFirstSelectedListItem(model) {
+    var listItem;
+    getOperationalBlocks(model, ['ListItem'], ['TableCell']).forEach(function (r) {
+        if (!listItem && isBlockGroupOfType(r.block, 'ListItem')) {
+            listItem = r.block;
+        }
+    });
+    return listItem;
+}
+function collectSelections(model, option) {
+    var selections = [];
+    iterateSelections(model, function (path, tableContext, block, segments) {
+        selections.push({
+            path: path,
+            tableContext: tableContext,
+            block: block,
+            segments: segments,
+        });
+    }, option);
+    return selections;
+}
+function removeUnmeaningfulSelections(selections) {
+    if (selections.length > 1 &&
+        isOnlySelectionMarkerSelected(selections, false /*checkFirstParagraph*/)) {
+        selections.pop();
+    }
+    // Remove head paragraph if first selection marker is the only selection
+    if (selections.length > 1 &&
+        isOnlySelectionMarkerSelected(selections, true /*checkFirstParagraph*/)) {
+        selections.shift();
+    }
+}
+function isOnlySelectionMarkerSelected(selections, checkFirstParagraph) {
+    var _a;
+    var selection = selections[checkFirstParagraph ? 0 : selections.length - 1];
+    if (((_a = selection.block) === null || _a === void 0 ? void 0 : _a.blockType) == 'Paragraph' &&
+        selection.segments &&
+        selection.segments.length > 0) {
+        var allSegments = selection.block.segments;
+        var segment = selection.segments[0];
+        return (selection.segments.length == 1 &&
+            segment.segmentType == 'SelectionMarker' &&
+            segment == allSegments[checkFirstParagraph ? allSegments.length - 1 : 0]);
+    }
+    else {
+        return false;
+    }
+}
+//# sourceMappingURL=collectSelections.js.map

package/lib-mjs/publicApi/selection/collectSelections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectSelections.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/selection/collectSelections.ts"],"names":[],"mappings":"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","sourcesContent":["import { getClosestAncestorBlockGroupIndex } from '../model/getClosestAncestorBlockGroupIndex';\nimport { isBlockGroupOfType } from '../model/isBlockGroupOfType';\nimport { iterateSelections } from './iterateSelections';\nimport type { IterateSelectionsOption } from './iterateSelections';\nimport type {\n    ContentModelBlock,\n    ContentModelBlockGroup,\n    ContentModelBlockGroupType,\n    ContentModelDocument,\n    ContentModelListItem,\n    ContentModelParagraph,\n    ContentModelSegment,\n    ContentModelTable,\n    TableSelectionContext,\n} from 'roosterjs-content-model-types';\nimport type { TypeOfBlockGroup } from '../model/getClosestAncestorBlockGroupIndex';\n\n/**\n * Represent a pair of parent block group and child block\n */\nexport type OperationalBlocks<T extends ContentModelBlockGroup> = {\n    /**\n     * The parent block group\n     */\n    parent: ContentModelBlockGroup;\n\n    /**\n     * The child block\n     */\n    block: ContentModelBlock | T;\n};\n\n/**\n * Get an array of selected parent paragraph and child segment pair\n * @param model The Content Model to get selection from\n * @param includingFormatHolder True means also include format holder as segment from list item, in that case paragraph will be null\n */\nexport function getSelectedSegmentsAndParagraphs(\n    model: ContentModelDocument,\n    includingFormatHolder: boolean\n): [ContentModelSegment, ContentModelParagraph | null][] {\n    const selections = collectSelections(model, {\n        includeListFormatHolder: includingFormatHolder ? 'allSegments' : 'never',\n    });\n    const result: [ContentModelSegment, ContentModelParagraph | null][] = [];\n\n    selections.forEach(({ segments, block }) => {\n        if (segments && ((includingFormatHolder && !block) || block?.blockType == 'Paragraph')) {\n            segments.forEach(segment => {\n                if (segment.segmentType != 'Entity' || !segment.entityFormat.isReadonly) {\n                    result.push([segment, block?.blockType == 'Paragraph' ? block : null]);\n                }\n            });\n        }\n    });\n\n    return result;\n}\n\n/**\n * Get an array of selected segments from a content model\n * @param model The Content Model to get selection from\n * @param includingFormatHolder True means also include format holder as segment from list item\n */\nexport function getSelectedSegments(\n    model: ContentModelDocument,\n    includingFormatHolder: boolean\n): ContentModelSegment[] {\n    return getSelectedSegmentsAndParagraphs(model, includingFormatHolder).map(x => x[0]);\n}\n\n/**\n * Get any array of selected paragraphs from a content model\n * @param model The Content Model to get selection from\n */\nexport function getSelectedParagraphs(model: ContentModelDocument): ContentModelParagraph[] {\n    const selections = collectSelections(model, { includeListFormatHolder: 'never' });\n    const result: ContentModelParagraph[] = [];\n\n    removeUnmeaningfulSelections(selections);\n\n    selections.forEach(({ block }) => {\n        if (block?.blockType == 'Paragraph') {\n            result.push(block);\n        }\n    });\n\n    return result;\n}\n\n/**\n * Get an array of block group - block pair that is of the expected block group type from selection\n * @param model The Content Model to get selection from\n * @param blockGroupTypes The expected block group types\n * @param stopTypes Block group types that will stop searching when hit\n * @param deepFirst True means search in deep first, otherwise wide first\n */\nexport function getOperationalBlocks<T extends ContentModelBlockGroup>(\n    model: ContentModelDocument,\n    blockGroupTypes: TypeOfBlockGroup<T>[],\n    stopTypes: ContentModelBlockGroupType[],\n    deepFirst?: boolean\n): OperationalBlocks<T>[] {\n    const result: OperationalBlocks<T>[] = [];\n    const findSequence = deepFirst ? blockGroupTypes.map(type => [type]) : [blockGroupTypes];\n    const selections = collectSelections(model, {\n        includeListFormatHolder: 'never',\n        contentUnderSelectedTableCell: 'ignoreForTable', // When whole table is selected, we treat the table as a single block\n    });\n\n    removeUnmeaningfulSelections(selections);\n\n    selections.forEach(({ path, block }) => {\n        for (let i = 0; i < findSequence.length; i++) {\n            const groupIndex = getClosestAncestorBlockGroupIndex(path, findSequence[i], stopTypes);\n\n            if (groupIndex >= 0) {\n                if (result.filter(x => x.block == path[groupIndex]).length <= 0) {\n                    result.push({\n                        parent: path[groupIndex + 1],\n                        block: path[groupIndex] as T,\n                    });\n                }\n                break;\n            } else if (i == findSequence.length - 1 && block) {\n                result.push({\n                    parent: path[0],\n                    block: block,\n                });\n                break;\n            }\n        }\n    });\n\n    return result;\n}\n\n/**\n * Get the first selected table from content model\n * @param model The Content Model to get selection from\n */\nexport function getFirstSelectedTable(\n    model: ContentModelDocument\n): [ContentModelTable | undefined, ContentModelBlockGroup[]] {\n    const selections = collectSelections(model, { includeListFormatHolder: 'never' });\n    let table: ContentModelTable | undefined;\n    let resultPath: ContentModelBlockGroup[] = [];\n\n    removeUnmeaningfulSelections(selections);\n\n    selections.forEach(({ block, tableContext, path }) => {\n        if (!table) {\n            if (block?.blockType == 'Table') {\n                table = block;\n                resultPath = [...path];\n            } else if (tableContext?.table) {\n                table = tableContext.table;\n\n                const parent = path.filter(\n                    group => group.blocks.indexOf(tableContext.table) >= 0\n                )[0];\n                const index = path.indexOf(parent);\n                resultPath = index >= 0 ? path.slice(index) : [];\n            }\n        }\n    });\n\n    return [table, resultPath];\n}\n\n/**\n * Get the first selected list item from content model\n * @param model The Content Model to get selection from\n */\nexport function getFirstSelectedListItem(\n    model: ContentModelDocument\n): ContentModelListItem | undefined {\n    let listItem: ContentModelListItem | undefined;\n\n    getOperationalBlocks(model, ['ListItem'], ['TableCell']).forEach(r => {\n        if (!listItem && isBlockGroupOfType<ContentModelListItem>(r.block, 'ListItem')) {\n            listItem = r.block;\n        }\n    });\n\n    return listItem;\n}\n\ninterface SelectionInfo {\n    path: ContentModelBlockGroup[];\n    segments?: ContentModelSegment[];\n    block?: ContentModelBlock;\n    tableContext?: TableSelectionContext;\n}\n\nfunction collectSelections(\n    model: ContentModelDocument,\n    option?: IterateSelectionsOption\n): SelectionInfo[] {\n    const selections: SelectionInfo[] = [];\n\n    iterateSelections(\n        model,\n        (path, tableContext, block, segments) => {\n            selections.push({\n                path,\n                tableContext,\n                block,\n                segments,\n            });\n        },\n        option\n    );\n\n    return selections;\n}\n\nfunction removeUnmeaningfulSelections(selections: SelectionInfo[]) {\n    if (\n        selections.length > 1 &&\n        isOnlySelectionMarkerSelected(selections, false /*checkFirstParagraph*/)\n    ) {\n        selections.pop();\n    }\n\n    // Remove head paragraph if first selection marker is the only selection\n    if (\n        selections.length > 1 &&\n        isOnlySelectionMarkerSelected(selections, true /*checkFirstParagraph*/)\n    ) {\n        selections.shift();\n    }\n}\n\nfunction isOnlySelectionMarkerSelected(\n    selections: SelectionInfo[],\n    checkFirstParagraph: boolean\n): boolean {\n    const selection = selections[checkFirstParagraph ? 0 : selections.length - 1];\n\n    if (\n        selection.block?.blockType == 'Paragraph' &&\n        selection.segments &&\n        selection.segments.length > 0\n    ) {\n        const allSegments = selection.block.segments;\n        const segment = selection.segments[0];\n\n        return (\n            selection.segments.length == 1 &&\n            segment.segmentType == 'SelectionMarker' &&\n            segment == allSegments[checkFirstParagraph ? allSegments.length - 1 : 0]\n        );\n    } else {\n        return false;\n    }\n}\n"]}

package/lib-mjs/publicApi/selection/deleteBlock.d.ts

@@ -0,0 +1,11 @@
+import type { ContentModelBlock, FormatWithContentModelContext } from 'roosterjs-content-model-types';
+/**
+ * Delete a content model block from current selection
+ * @param blocks Array of the block to delete
+ * @param blockToDelete The block to delete
+ * @param replacement @optional If specified, use this block to replace the deleted block
+ * @param context @optional Context object provided by formatContentModel API
+ * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
+ * If not specified, only selected entity will be deleted
+ */
+export declare function deleteBlock(blocks: ContentModelBlock[], blockToDelete: ContentModelBlock, replacement?: ContentModelBlock, context?: FormatWithContentModelContext, direction?: 'forward' | 'backward'): boolean;

package/lib-mjs/publicApi/selection/deleteBlock.js

@@ -0,0 +1,52 @@
+/**
+ * Delete a content model block from current selection
+ * @param blocks Array of the block to delete
+ * @param blockToDelete The block to delete
+ * @param replacement @optional If specified, use this block to replace the deleted block
+ * @param context @optional Context object provided by formatContentModel API
+ * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
+ * If not specified, only selected entity will be deleted
+ */
+export function deleteBlock(blocks, blockToDelete, replacement, context, direction) {
+    var index = blocks.indexOf(blockToDelete);
+    switch (blockToDelete.blockType) {
+        case 'Table':
+        case 'Divider':
+            replacement ? blocks.splice(index, 1, replacement) : blocks.splice(index, 1);
+            return true;
+        case 'Entity':
+            var operation = blockToDelete.isSelected
+                ? 'overwrite'
+                : direction == 'forward'
+                    ? 'removeFromStart'
+                    : direction == 'backward'
+                        ? 'removeFromEnd'
+                        : undefined;
+            if (operation !== undefined) {
+                replacement ? blocks.splice(index, 1, replacement) : blocks.splice(index, 1);
+                context === null || context === void 0 ? void 0 : context.deletedEntities.push({
+                    entity: blockToDelete,
+                    operation: operation,
+                });
+            }
+            return true;
+        case 'BlockGroup':
+            switch (blockToDelete.blockGroupType) {
+                case 'General':
+                    if (replacement) {
+                        blocks.splice(index, 1, replacement);
+                        return true;
+                    }
+                    else {
+                        // no op, let browser handle it
+                        return false;
+                    }
+                case 'ListItem':
+                case 'FormatContainer':
+                    blocks.splice(index, 1);
+                    return true;
+            }
+    }
+    return false;
+}
+//# sourceMappingURL=deleteBlock.js.map

package/lib-mjs/publicApi/selection/deleteBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteBlock.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/selection/deleteBlock.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACvB,MAA2B,EAC3B,aAAgC,EAChC,WAA+B,EAC/B,OAAuC,EACvC,SAAkC;IAElC,IAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5C,QAAQ,aAAa,CAAC,SAAS,EAAE;QAC7B,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACV,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QAEhB,KAAK,QAAQ;YACT,IAAM,SAAS,GAAuC,aAAa,CAAC,UAAU;gBAC1E,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,SAAS,IAAI,SAAS;oBACxB,CAAC,CAAC,iBAAiB;oBACnB,CAAC,CAAC,SAAS,IAAI,UAAU;wBACzB,CAAC,CAAC,eAAe;wBACjB,CAAC,CAAC,SAAS,CAAC;YAEhB,IAAI,SAAS,KAAK,SAAS,EAAE;gBACzB,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC7E,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,aAAa;oBACrB,SAAS,WAAA;iBACZ,CAAC,CAAC;aACN;YAED,OAAO,IAAI,CAAC;QAEhB,KAAK,YAAY;YACb,QAAQ,aAAa,CAAC,cAAc,EAAE;gBAClC,KAAK,SAAS;oBACV,IAAI,WAAW,EAAE;wBACb,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;wBACrC,OAAO,IAAI,CAAC;qBACf;yBAAM;wBACH,+BAA+B;wBAC/B,OAAO,KAAK,CAAC;qBAChB;gBAEL,KAAK,UAAU,CAAC;gBAChB,KAAK,iBAAiB;oBAClB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBACxB,OAAO,IAAI,CAAC;aACnB;KACR;IAED,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["import type {\n    ContentModelBlock,\n    EntityRemovalOperation,\n    FormatWithContentModelContext,\n} from 'roosterjs-content-model-types';\n\n/**\n * Delete a content model block from current selection\n * @param blocks Array of the block to delete\n * @param blockToDelete The block to delete\n * @param replacement @optional If specified, use this block to replace the deleted block\n * @param context @optional Context object provided by formatContentModel API\n * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.\n * If not specified, only selected entity will be deleted\n */\nexport function deleteBlock(\n    blocks: ContentModelBlock[],\n    blockToDelete: ContentModelBlock,\n    replacement?: ContentModelBlock,\n    context?: FormatWithContentModelContext,\n    direction?: 'forward' | 'backward'\n): boolean {\n    const index = blocks.indexOf(blockToDelete);\n\n    switch (blockToDelete.blockType) {\n        case 'Table':\n        case 'Divider':\n            replacement ? blocks.splice(index, 1, replacement) : blocks.splice(index, 1);\n            return true;\n\n        case 'Entity':\n            const operation: EntityRemovalOperation | undefined = blockToDelete.isSelected\n                ? 'overwrite'\n                : direction == 'forward'\n                ? 'removeFromStart'\n                : direction == 'backward'\n                ? 'removeFromEnd'\n                : undefined;\n\n            if (operation !== undefined) {\n                replacement ? blocks.splice(index, 1, replacement) : blocks.splice(index, 1);\n                context?.deletedEntities.push({\n                    entity: blockToDelete,\n                    operation,\n                });\n            }\n\n            return true;\n\n        case 'BlockGroup':\n            switch (blockToDelete.blockGroupType) {\n                case 'General':\n                    if (replacement) {\n                        blocks.splice(index, 1, replacement);\n                        return true;\n                    } else {\n                        // no op, let browser handle it\n                        return false;\n                    }\n\n                case 'ListItem':\n                case 'FormatContainer':\n                    blocks.splice(index, 1);\n                    return true;\n            }\n    }\n\n    return false;\n}\n"]}

package/lib-mjs/publicApi/selection/deleteSegment.d.ts

@@ -0,0 +1,10 @@
+import type { ContentModelParagraph, ContentModelSegment, FormatWithContentModelContext } from 'roosterjs-content-model-types';
+/**
+ * Delete a content model segment from current selection
+ * @param paragraph Parent paragraph of the segment to delete
+ * @param segmentToDelete The segment to delete
+ * @param context @optional Context object provided by formatContentModel API
+ * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
+ * If not specified, only selected entity will be deleted
+ */
+export declare function deleteSegment(paragraph: ContentModelParagraph, segmentToDelete: ContentModelSegment, context?: FormatWithContentModelContext, direction?: 'forward' | 'backward'): boolean;

package/lib-mjs/publicApi/selection/deleteSegment.js

@@ -0,0 +1,84 @@
+import { deleteSingleChar } from '../../modelApi/edit/deleteSingleChar';
+import { isWhiteSpacePreserved, normalizeSingleSegment } from 'roosterjs-content-model-dom';
+import { normalizeText } from '../domUtils/stringUtil';
+/**
+ * Delete a content model segment from current selection
+ * @param paragraph Parent paragraph of the segment to delete
+ * @param segmentToDelete The segment to delete
+ * @param context @optional Context object provided by formatContentModel API
+ * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.
+ * If not specified, only selected entity will be deleted
+ */
+export function deleteSegment(paragraph, segmentToDelete, context, direction) {
+    var segments = paragraph.segments;
+    var index = segments.indexOf(segmentToDelete);
+    var preserveWhiteSpace = isWhiteSpacePreserved(paragraph);
+    var isForward = direction == 'forward';
+    var isBackward = direction == 'backward';
+    if (!preserveWhiteSpace) {
+        normalizePreviousSegment(segments, index);
+    }
+    switch (segmentToDelete.segmentType) {
+        case 'Br':
+        case 'Image':
+        case 'SelectionMarker':
+            segments.splice(index, 1);
+            return true;
+        case 'Entity':
+            var operation = segmentToDelete.isSelected
+                ? 'overwrite'
+                : isForward
+                    ? 'removeFromStart'
+                    : isBackward
+                        ? 'removeFromEnd'
+                        : undefined;
+            if (operation !== undefined) {
+                segments.splice(index, 1);
+                context === null || context === void 0 ? void 0 : context.deletedEntities.push({
+                    entity: segmentToDelete,
+                    operation: operation,
+                });
+            }
+            return true;
+        case 'Text':
+            var text = segmentToDelete.text;
+            if (text.length == 0 || segmentToDelete.isSelected) {
+                segments.splice(index, 1);
+            }
+            else if (direction) {
+                text = deleteSingleChar(text, isForward); //  isForward ? text.substring(1) : text.substring(0, text.length - 1);
+                if (!preserveWhiteSpace) {
+                    text = normalizeText(text, isForward);
+                }
+                if (text == '') {
+                    segments.splice(index, 1);
+                }
+                else {
+                    segmentToDelete.text = text;
+                }
+            }
+            return true;
+        case 'General':
+            if (segmentToDelete.isSelected) {
+                segments.splice(index, 1);
+                return true;
+            }
+            else {
+                // No op if a general segment is not selected, let browser handle general segment
+                // TODO: Need to revisit this
+                return false;
+            }
+    }
+}
+function normalizePreviousSegment(segments, currentIndex) {
+    var _a;
+    var index = currentIndex - 1;
+    while (((_a = segments[index]) === null || _a === void 0 ? void 0 : _a.segmentType) == 'SelectionMarker') {
+        index--;
+    }
+    var segment = segments[index];
+    if (segment) {
+        normalizeSingleSegment(segment);
+    }
+}
+//# sourceMappingURL=deleteSegment.js.map

package/lib-mjs/publicApi/selection/deleteSegment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteSegment.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/selection/deleteSegment.ts"],"names":[],"mappings":"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","sourcesContent":["import { deleteSingleChar } from '../../modelApi/edit/deleteSingleChar';\nimport { isWhiteSpacePreserved, normalizeSingleSegment } from 'roosterjs-content-model-dom';\nimport { normalizeText } from '../domUtils/stringUtil';\nimport type {\n    ContentModelParagraph,\n    ContentModelSegment,\n    EntityRemovalOperation,\n    FormatWithContentModelContext,\n} from 'roosterjs-content-model-types';\n\n/**\n * Delete a content model segment from current selection\n * @param paragraph Parent paragraph of the segment to delete\n * @param segmentToDelete The segment to delete\n * @param context @optional Context object provided by formatContentModel API\n * @param direction @optional Whether this is deleting forward or backward. This is only used for deleting entity.\n * If not specified, only selected entity will be deleted\n */\nexport function deleteSegment(\n    paragraph: ContentModelParagraph,\n    segmentToDelete: ContentModelSegment,\n    context?: FormatWithContentModelContext,\n    direction?: 'forward' | 'backward'\n): boolean {\n    const segments = paragraph.segments;\n    const index = segments.indexOf(segmentToDelete);\n    const preserveWhiteSpace = isWhiteSpacePreserved(paragraph);\n    const isForward = direction == 'forward';\n    const isBackward = direction == 'backward';\n\n    if (!preserveWhiteSpace) {\n        normalizePreviousSegment(segments, index);\n    }\n\n    switch (segmentToDelete.segmentType) {\n        case 'Br':\n        case 'Image':\n        case 'SelectionMarker':\n            segments.splice(index, 1);\n            return true;\n\n        case 'Entity':\n            const operation: EntityRemovalOperation | undefined = segmentToDelete.isSelected\n                ? 'overwrite'\n                : isForward\n                ? 'removeFromStart'\n                : isBackward\n                ? 'removeFromEnd'\n                : undefined;\n            if (operation !== undefined) {\n                segments.splice(index, 1);\n                context?.deletedEntities.push({\n                    entity: segmentToDelete,\n                    operation,\n                });\n            }\n\n            return true;\n\n        case 'Text':\n            let text = segmentToDelete.text;\n\n            if (text.length == 0 || segmentToDelete.isSelected) {\n                segments.splice(index, 1);\n            } else if (direction) {\n                text = deleteSingleChar(text, isForward); //  isForward ? text.substring(1) : text.substring(0, text.length - 1);\n\n                if (!preserveWhiteSpace) {\n                    text = normalizeText(text, isForward);\n                }\n\n                if (text == '') {\n                    segments.splice(index, 1);\n                } else {\n                    segmentToDelete.text = text;\n                }\n            }\n\n            return true;\n\n        case 'General':\n            if (segmentToDelete.isSelected) {\n                segments.splice(index, 1);\n                return true;\n            } else {\n                // No op if a general segment is not selected, let browser handle general segment\n                // TODO: Need to revisit this\n                return false;\n            }\n    }\n}\n\nfunction normalizePreviousSegment(segments: ContentModelSegment[], currentIndex: number) {\n    let index = currentIndex - 1;\n\n    while (segments[index]?.segmentType == 'SelectionMarker') {\n        index--;\n    }\n\n    const segment = segments[index];\n\n    if (segment) {\n        normalizeSingleSegment(segment);\n    }\n}\n"]}

package/lib-mjs/publicApi/selection/deleteSelection.d.ts

@@ -0,0 +1,9 @@
+import type { ContentModelDocument, DeleteSelectionResult, DeleteSelectionStep, FormatWithContentModelContext } from 'roosterjs-content-model-types';
+/**
+ * Delete selected content from Content Model
+ * @param model The model to delete selected content from
+ * @param additionalSteps @optional Addition delete steps
+ * @param formatContext @optional A context object provided by formatContentModel API
+ * @returns A DeleteSelectionResult object to specify the deletion result
+ */
+export declare function deleteSelection(model: ContentModelDocument, additionalSteps?: (DeleteSelectionStep | null)[], formatContext?: FormatWithContentModelContext): DeleteSelectionResult;

package/lib-mjs/publicApi/selection/deleteSelection.js

@@ -0,0 +1,40 @@
+import { __read, __spreadArray } from "tslib";
+import { deleteExpandedSelection } from '../../modelApi/edit/deleteExpandedSelection';
+/**
+ * Delete selected content from Content Model
+ * @param model The model to delete selected content from
+ * @param additionalSteps @optional Addition delete steps
+ * @param formatContext @optional A context object provided by formatContentModel API
+ * @returns A DeleteSelectionResult object to specify the deletion result
+ */
+export function deleteSelection(model, additionalSteps, formatContext) {
+    if (additionalSteps === void 0) { additionalSteps = []; }
+    var context = deleteExpandedSelection(model, formatContext);
+    additionalSteps.forEach(function (step) {
+        if (step &&
+            isValidDeleteSelectionContext(context) &&
+            context.deleteResult == 'notDeleted') {
+            step(context);
+        }
+    });
+    mergeParagraphAfterDelete(context);
+    return context;
+}
+function isValidDeleteSelectionContext(context) {
+    return !!context.insertPoint;
+}
+// If we end up with multiple paragraphs impacted, we need to merge them
+function mergeParagraphAfterDelete(context) {
+    var _a;
+    var insertPoint = context.insertPoint, deleteResult = context.deleteResult, lastParagraph = context.lastParagraph, lastTableContext = context.lastTableContext;
+    if (insertPoint &&
+        deleteResult != 'notDeleted' &&
+        deleteResult != 'nothingToDelete' &&
+        lastParagraph &&
+        lastParagraph != insertPoint.paragraph &&
+        lastTableContext == insertPoint.tableContext) {
+        (_a = insertPoint.paragraph.segments).push.apply(_a, __spreadArray([], __read(lastParagraph.segments), false));
+        lastParagraph.segments = [];
+    }
+}
+//# sourceMappingURL=deleteSelection.js.map

package/lib-mjs/publicApi/selection/deleteSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteSelection.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/selection/deleteSelection.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAUtF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC3B,KAA2B,EAC3B,eAAoD,EACpD,aAA6C;IAD7C,gCAAA,EAAA,oBAAoD;IAGpD,IAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAE9D,eAAe,CAAC,OAAO,CAAC,UAAA,IAAI;QACxB,IACI,IAAI;YACJ,6BAA6B,CAAC,OAAO,CAAC;YACtC,OAAO,CAAC,YAAY,IAAI,YAAY,EACtC;YACE,IAAI,CAAC,OAAO,CAAC,CAAC;SACjB;IACL,CAAC,CAAC,CAAC;IAEH,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,6BAA6B,CAClC,OAA+B;IAE/B,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;AACjC,CAAC;AAED,wEAAwE;AACxE,SAAS,yBAAyB,CAAC,OAA+B;;IACtD,IAAA,WAAW,GAAoD,OAAO,YAA3D,EAAE,YAAY,GAAsC,OAAO,aAA7C,EAAE,aAAa,GAAuB,OAAO,cAA9B,EAAE,gBAAgB,GAAK,OAAO,iBAAZ,CAAa;IAE/E,IACI,WAAW;QACX,YAAY,IAAI,YAAY;QAC5B,YAAY,IAAI,iBAAiB;QACjC,aAAa;QACb,aAAa,IAAI,WAAW,CAAC,SAAS;QACtC,gBAAgB,IAAI,WAAW,CAAC,YAAY,EAC9C;QACE,CAAA,KAAA,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAA,CAAC,IAAI,oCAAI,aAAa,CAAC,QAAQ,WAAE;QAC/D,aAAa,CAAC,QAAQ,GAAG,EAAE,CAAC;KAC/B;AACL,CAAC","sourcesContent":["import { deleteExpandedSelection } from '../../modelApi/edit/deleteExpandedSelection';\nimport type {\n    ContentModelDocument,\n    DeleteSelectionContext,\n    DeleteSelectionResult,\n    DeleteSelectionStep,\n    FormatWithContentModelContext,\n    ValidDeleteSelectionContext,\n} from 'roosterjs-content-model-types';\n\n/**\n * Delete selected content from Content Model\n * @param model The model to delete selected content from\n * @param additionalSteps @optional Addition delete steps\n * @param formatContext @optional A context object provided by formatContentModel API\n * @returns A DeleteSelectionResult object to specify the deletion result\n */\nexport function deleteSelection(\n    model: ContentModelDocument,\n    additionalSteps: (DeleteSelectionStep | null)[] = [],\n    formatContext?: FormatWithContentModelContext\n): DeleteSelectionResult {\n    const context = deleteExpandedSelection(model, formatContext);\n\n    additionalSteps.forEach(step => {\n        if (\n            step &&\n            isValidDeleteSelectionContext(context) &&\n            context.deleteResult == 'notDeleted'\n        ) {\n            step(context);\n        }\n    });\n\n    mergeParagraphAfterDelete(context);\n\n    return context;\n}\n\nfunction isValidDeleteSelectionContext(\n    context: DeleteSelectionContext\n): context is ValidDeleteSelectionContext {\n    return !!context.insertPoint;\n}\n\n// If we end up with multiple paragraphs impacted, we need to merge them\nfunction mergeParagraphAfterDelete(context: DeleteSelectionContext) {\n    const { insertPoint, deleteResult, lastParagraph, lastTableContext } = context;\n\n    if (\n        insertPoint &&\n        deleteResult != 'notDeleted' &&\n        deleteResult != 'nothingToDelete' &&\n        lastParagraph &&\n        lastParagraph != insertPoint.paragraph &&\n        lastTableContext == insertPoint.tableContext\n    ) {\n        insertPoint.paragraph.segments.push(...lastParagraph.segments);\n        lastParagraph.segments = [];\n    }\n}\n"]}

package/lib-mjs/publicApi/selection/getSelectionRootNode.d.ts

@@ -0,0 +1,9 @@
+import type { DOMSelection } from 'roosterjs-content-model-types';
+/**
+ * Get root node of a given DOM selection
+ * For table selection, root node is the selected table
+ * For image selection, root node is the selected image
+ * For range selection, root node is the common ancestor container node of the selection range
+ * @param selection The selection to get root node from
+ */
+export declare function getSelectionRootNode(selection: DOMSelection | undefined): Node | undefined;

package/lib-mjs/publicApi/selection/getSelectionRootNode.js

@@ -0,0 +1,19 @@
+/**
+ * Get root node of a given DOM selection
+ * For table selection, root node is the selected table
+ * For image selection, root node is the selected image
+ * For range selection, root node is the common ancestor container node of the selection range
+ * @param selection The selection to get root node from
+ */
+export function getSelectionRootNode(selection) {
+    return !selection
+        ? undefined
+        : selection.type == 'range'
+            ? selection.range.commonAncestorContainer
+            : selection.type == 'table'
+                ? selection.table
+                : selection.type == 'image'
+                    ? selection.image
+                    : undefined;
+}
+//# sourceMappingURL=getSelectionRootNode.js.map

package/lib-mjs/publicApi/selection/getSelectionRootNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSelectionRootNode.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/selection/getSelectionRootNode.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAmC;IACpE,OAAO,CAAC,SAAS;QACb,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;YAC3B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,uBAAuB;YACzC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;gBAC3B,CAAC,CAAC,SAAS,CAAC,KAAK;gBACjB,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;oBAC3B,CAAC,CAAC,SAAS,CAAC,KAAK;oBACjB,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC","sourcesContent":["import type { DOMSelection } from 'roosterjs-content-model-types';\n\n/**\n * Get root node of a given DOM selection\n * For table selection, root node is the selected table\n * For image selection, root node is the selected image\n * For range selection, root node is the common ancestor container node of the selection range\n * @param selection The selection to get root node from\n */\nexport function getSelectionRootNode(selection: DOMSelection | undefined): Node | undefined {\n    return !selection\n        ? undefined\n        : selection.type == 'range'\n        ? selection.range.commonAncestorContainer\n        : selection.type == 'table'\n        ? selection.table\n        : selection.type == 'image'\n        ? selection.image\n        : undefined;\n}\n"]}

package/lib-mjs/publicApi/selection/iterateSelections.d.ts

@@ -0,0 +1,48 @@
+import type { ContentModelBlock, ContentModelBlockGroup, ContentModelSegment, TableSelectionContext } from 'roosterjs-content-model-types';
+/**
+ * Options for iterateSelections API
+ */
+export interface IterateSelectionsOption {
+    /**
+     * For selected table cell, this property determines how do we handle its content.
+     * include: No matter if table cell is selected, always invoke callback function for selected content (default value)
+     * ignoreForTable: When the whole table is selected we invoke callback for the table (using block parameter) but skip
+     * all its cells and content, otherwise keep invoking callback for table cell and content
+     * ignoreForTableOrCell: If whole table is selected, same with ignoreForTable, or if a table cell is selected, only
+     * invoke callback for the table cell itself but not for its content, otherwise keep invoking callback for content.
+     * @default include
+     */
+    contentUnderSelectedTableCell?: 'include' | 'ignoreForTable' | 'ignoreForTableOrCell';
+    /**
+     * For a selected general element, this property determines how do we handle its content.
+     * contentOnly: (Default) When the whole general element is selected, we only invoke callback for its selected content
+     * generalElementOnly: When the whole general element is selected, we only invoke callback for the general element (using block or
+     * segment parameter depends on if it is a block or segment), but skip all its content.
+     * both: When general element is selected, we invoke callback first for its content, then for general element itself
+     */
+    contentUnderSelectedGeneralElement?: 'contentOnly' | 'generalElementOnly' | 'both';
+    /**
+     * Whether call the callback for the list item format holder segment
+     * anySegment: call the callback if any segment is selected under a list item
+     * allSegments: call the callback only when all segments under the list item are selected
+     * never: never call the callback for list item format holder
+     * @default allSegments
+     */
+    includeListFormatHolder?: 'anySegment' | 'allSegments' | 'never';
+}
+/**
+ * The callback function type for iterateSelections
+ * @param path The block group path of current selection
+ * @param tableContext Table context of current selection
+ * @param block Block of current selection
+ * @param segments Segments of current selection
+ * @returns True to stop iterating, otherwise keep going
+ */
+export declare type IterateSelectionsCallback = (path: ContentModelBlockGroup[], tableContext?: TableSelectionContext, block?: ContentModelBlock, segments?: ContentModelSegment[]) => void | boolean;
+/**
+ * Iterate all selected elements in a given model
+ * @param group The given Content Model to iterate selection from
+ * @param callback The callback function to access the selected element
+ * @param option Option to determine how to iterate
+ */
+export declare function iterateSelections(group: ContentModelBlockGroup, callback: IterateSelectionsCallback, option?: IterateSelectionsOption): void;