roosterjs-content-model-core 0.20.0

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

@@ -0,0 +1,180 @@
+define(["require", "exports", "tslib", "../model/getClosestAncestorBlockGroupIndex", "../model/isBlockGroupOfType", "./iterateSelections"], function (require, exports, tslib_1, getClosestAncestorBlockGroupIndex_1, isBlockGroupOfType_1, iterateSelections_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getFirstSelectedListItem = exports.getFirstSelectedTable = exports.getOperationalBlocks = exports.getSelectedParagraphs = exports.getSelectedSegments = exports.getSelectedSegmentsAndParagraphs = void 0;
+    /**
+     * 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
+     */
+    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;
+    }
+    exports.getSelectedSegmentsAndParagraphs = getSelectedSegmentsAndParagraphs;
+    /**
+     * 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
+     */
+    function getSelectedSegments(model, includingFormatHolder) {
+        return getSelectedSegmentsAndParagraphs(model, includingFormatHolder).map(function (x) { return x[0]; });
+    }
+    exports.getSelectedSegments = getSelectedSegments;
+    /**
+     * Get any array of selected paragraphs from a content model
+     * @param model The Content Model to get selection from
+     */
+    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;
+    }
+    exports.getSelectedParagraphs = getSelectedParagraphs;
+    /**
+     * 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
+     */
+    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 = (0, getClosestAncestorBlockGroupIndex_1.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;
+    }
+    exports.getOperationalBlocks = getOperationalBlocks;
+    /**
+     * Get the first selected table from content model
+     * @param model The Content Model to get selection from
+     */
+    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 = (0, tslib_1.__spreadArray)([], (0, tslib_1.__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];
+    }
+    exports.getFirstSelectedTable = getFirstSelectedTable;
+    /**
+     * Get the first selected list item from content model
+     * @param model The Content Model to get selection from
+     */
+    function getFirstSelectedListItem(model) {
+        var listItem;
+        getOperationalBlocks(model, ['ListItem'], ['TableCell']).forEach(function (r) {
+            if (!listItem && (0, isBlockGroupOfType_1.isBlockGroupOfType)(r.block, 'ListItem')) {
+                listItem = r.block;
+            }
+        });
+        return listItem;
+    }
+    exports.getFirstSelectedListItem = getFirstSelectedListItem;
+    function collectSelections(model, option) {
+        var selections = [];
+        (0, iterateSelections_1.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-amd/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-amd/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-amd/publicApi/selection/deleteBlock.js

@@ -0,0 +1,58 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.deleteBlock = void 0;
+    /**
+     * 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
+     */
+    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;
+    }
+    exports.deleteBlock = deleteBlock;
+});
+//# sourceMappingURL=deleteBlock.js.map

package/lib-amd/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":";;;;IAMA;;;;;;;;OAQG;IACH,SAAgB,WAAW,CACvB,MAA2B,EAC3B,aAAgC,EAChC,WAA+B,EAC/B,OAAuC,EACvC,SAAkC;QAElC,IAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAE5C,QAAQ,aAAa,CAAC,SAAS,EAAE;YAC7B,KAAK,OAAO,CAAC;YACb,KAAK,SAAS;gBACV,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,IAAI,CAAC;YAEhB,KAAK,QAAQ;gBACT,IAAM,SAAS,GAAuC,aAAa,CAAC,UAAU;oBAC1E,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,SAAS,IAAI,SAAS;wBACxB,CAAC,CAAC,iBAAiB;wBACnB,CAAC,CAAC,SAAS,IAAI,UAAU;4BACzB,CAAC,CAAC,eAAe;4BACjB,CAAC,CAAC,SAAS,CAAC;gBAEhB,IAAI,SAAS,KAAK,SAAS,EAAE;oBACzB,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;oBAC7E,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe,CAAC,IAAI,CAAC;wBAC1B,MAAM,EAAE,aAAa;wBACrB,SAAS,WAAA;qBACZ,CAAC,CAAC;iBACN;gBAED,OAAO,IAAI,CAAC;YAEhB,KAAK,YAAY;gBACb,QAAQ,aAAa,CAAC,cAAc,EAAE;oBAClC,KAAK,SAAS;wBACV,IAAI,WAAW,EAAE;4BACb,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;4BACrC,OAAO,IAAI,CAAC;yBACf;6BAAM;4BACH,+BAA+B;4BAC/B,OAAO,KAAK,CAAC;yBAChB;oBAEL,KAAK,UAAU,CAAC;oBAChB,KAAK,iBAAiB;wBAClB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;wBACxB,OAAO,IAAI,CAAC;iBACnB;SACR;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IArDD,kCAqDC","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-amd/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-amd/publicApi/selection/deleteSegment.js

@@ -0,0 +1,87 @@
+define(["require", "exports", "../../modelApi/edit/deleteSingleChar", "roosterjs-content-model-dom", "../domUtils/stringUtil"], function (require, exports, deleteSingleChar_1, roosterjs_content_model_dom_1, stringUtil_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.deleteSegment = void 0;
+    /**
+     * 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
+     */
+    function deleteSegment(paragraph, segmentToDelete, context, direction) {
+        var segments = paragraph.segments;
+        var index = segments.indexOf(segmentToDelete);
+        var preserveWhiteSpace = (0, roosterjs_content_model_dom_1.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 = (0, deleteSingleChar_1.deleteSingleChar)(text, isForward); //  isForward ? text.substring(1) : text.substring(0, text.length - 1);
+                    if (!preserveWhiteSpace) {
+                        text = (0, stringUtil_1.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;
+                }
+        }
+    }
+    exports.deleteSegment = deleteSegment;
+    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) {
+            (0, roosterjs_content_model_dom_1.normalizeSingleSegment)(segment);
+        }
+    }
+});
+//# sourceMappingURL=deleteSegment.js.map

package/lib-amd/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-amd/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-amd/publicApi/selection/deleteSelection.js

@@ -0,0 +1,44 @@
+define(["require", "exports", "tslib", "../../modelApi/edit/deleteExpandedSelection"], function (require, exports, tslib_1, deleteExpandedSelection_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.deleteSelection = void 0;
+    /**
+     * 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
+     */
+    function deleteSelection(model, additionalSteps, formatContext) {
+        if (additionalSteps === void 0) { additionalSteps = []; }
+        var context = (0, deleteExpandedSelection_1.deleteExpandedSelection)(model, formatContext);
+        additionalSteps.forEach(function (step) {
+            if (step &&
+                isValidDeleteSelectionContext(context) &&
+                context.deleteResult == 'notDeleted') {
+                step(context);
+            }
+        });
+        mergeParagraphAfterDelete(context);
+        return context;
+    }
+    exports.deleteSelection = deleteSelection;
+    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, (0, tslib_1.__spreadArray)([], (0, tslib_1.__read)(lastParagraph.segments), false));
+            lastParagraph.segments = [];
+        }
+    }
+});
+//# sourceMappingURL=deleteSelection.js.map

package/lib-amd/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":";;;;IAUA;;;;;;OAMG;IACH,SAAgB,eAAe,CAC3B,KAA2B,EAC3B,eAAoD,EACpD,aAA6C;QAD7C,gCAAA,EAAA,oBAAoD;QAGpD,IAAM,OAAO,GAAG,IAAA,iDAAuB,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAE9D,eAAe,CAAC,OAAO,CAAC,UAAA,IAAI;YACxB,IACI,IAAI;gBACJ,6BAA6B,CAAC,OAAO,CAAC;gBACtC,OAAO,CAAC,YAAY,IAAI,YAAY,EACtC;gBACE,IAAI,CAAC,OAAO,CAAC,CAAC;aACjB;QACL,CAAC,CAAC,CAAC;QAEH,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO,OAAO,CAAC;IACnB,CAAC;IApBD,0CAoBC;IAED,SAAS,6BAA6B,CAClC,OAA+B;QAE/B,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACjC,CAAC;IAED,wEAAwE;IACxE,SAAS,yBAAyB,CAAC,OAA+B;;QACtD,IAAA,WAAW,GAAoD,OAAO,YAA3D,EAAE,YAAY,GAAsC,OAAO,aAA7C,EAAE,aAAa,GAAuB,OAAO,cAA9B,EAAE,gBAAgB,GAAK,OAAO,iBAAZ,CAAa;QAE/E,IACI,WAAW;YACX,YAAY,IAAI,YAAY;YAC5B,YAAY,IAAI,iBAAiB;YACjC,aAAa;YACb,aAAa,IAAI,WAAW,CAAC,SAAS;YACtC,gBAAgB,IAAI,WAAW,CAAC,YAAY,EAC9C;YACE,CAAA,KAAA,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAA,CAAC,IAAI,8DAAI,aAAa,CAAC,QAAQ,WAAE;YAC/D,aAAa,CAAC,QAAQ,GAAG,EAAE,CAAC;SAC/B;IACL,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-amd/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-amd/publicApi/selection/getSelectionRootNode.js

@@ -0,0 +1,25 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getSelectionRootNode = void 0;
+    /**
+     * 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
+     */
+    function getSelectionRootNode(selection) {
+        return !selection
+            ? undefined
+            : selection.type == 'range'
+                ? selection.range.commonAncestorContainer
+                : selection.type == 'table'
+                    ? selection.table
+                    : selection.type == 'image'
+                        ? selection.image
+                        : undefined;
+    }
+    exports.getSelectionRootNode = getSelectionRootNode;
+});
+//# sourceMappingURL=getSelectionRootNode.js.map

package/lib-amd/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":";;;;IAEA;;;;;;OAMG;IACH,SAAgB,oBAAoB,CAAC,SAAmC;QACpE,OAAO,CAAC,SAAS;YACb,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;gBAC3B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,uBAAuB;gBACzC,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;oBAC3B,CAAC,CAAC,SAAS,CAAC,KAAK;oBACjB,CAAC,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO;wBAC3B,CAAC,CAAC,SAAS,CAAC,KAAK;wBACjB,CAAC,CAAC,SAAS,CAAC;IACpB,CAAC;IAVD,oDAUC","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-amd/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;