roosterjs-content-model-core 0.20.0

package/lib-amd/publicApi/domUtils/borderValues.js

@@ -0,0 +1,50 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.combineBorderValue = exports.extractBorderValues = void 0;
+    var BorderStyles = [
+        'none',
+        'hidden',
+        'dotted',
+        'dashed',
+        'solid',
+        'double',
+        'groove',
+        'ridge',
+        'inset',
+        'outset',
+    ];
+    var BorderSizeRegex = /^(thin|medium|thick|[\d\.]+\w*)$/;
+    /**
+     * Extract an integrated border string with border width, style, color to value tuple
+     * @param combinedBorder The integrated border style string
+     * @returns An array with the splitted values
+     */
+    function extractBorderValues(combinedBorder) {
+        var result = {};
+        var values = (combinedBorder || '').replace(/, /g, ',').split(' ');
+        values.forEach(function (v) {
+            if (BorderStyles.indexOf(v) >= 0 && !result.style) {
+                result.style = v;
+            }
+            else if (BorderSizeRegex.test(v) && !result.width) {
+                result.width = v;
+            }
+            else if (v && !result.color) {
+                result.color = v; // TODO: Do we need to use a regex to match all possible colors?
+            }
+        });
+        return result;
+    }
+    exports.extractBorderValues = extractBorderValues;
+    /**
+     * Combine border value array back to string
+     * @param values Input string values
+     * @param initialValue Initial value for those items without valid value
+     */
+    function combineBorderValue(value) {
+        return [value.width || '', value.style || '', value.color || ''].join(' ').trim() || 'none';
+    }
+    exports.combineBorderValue = combineBorderValue;
+});
+//# sourceMappingURL=borderValues.js.map

package/lib-amd/publicApi/domUtils/borderValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"borderValues.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/domUtils/borderValues.ts"],"names":[],"mappings":";;;;IAEA,IAAM,YAAY,GAAG;QACjB,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,OAAO;QACP,QAAQ;KACX,CAAC;IACF,IAAM,eAAe,GAAG,kCAAkC,CAAC;IAE3D;;;;OAIG;IACH,SAAgB,mBAAmB,CAAC,cAAuB;QACvD,IAAM,MAAM,GAAW,EAAE,CAAC;QAC1B,IAAM,MAAM,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAErE,MAAM,CAAC,OAAO,CAAC,UAAA,CAAC;YACZ,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC/C,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;aACpB;iBAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gBACjD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;aACpB;iBAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC3B,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,gEAAgE;aACrF;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAClB,CAAC;IAfD,kDAeC;IAED;;;;OAIG;IACH,SAAgB,kBAAkB,CAAC,KAAa;QAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;IAChG,CAAC;IAFD,gDAEC","sourcesContent":["import type { Border } from 'roosterjs-content-model-types';\n\nconst BorderStyles = [\n    'none',\n    'hidden',\n    'dotted',\n    'dashed',\n    'solid',\n    'double',\n    'groove',\n    'ridge',\n    'inset',\n    'outset',\n];\nconst BorderSizeRegex = /^(thin|medium|thick|[\\d\\.]+\\w*)$/;\n\n/**\n * Extract an integrated border string with border width, style, color to value tuple\n * @param combinedBorder The integrated border style string\n * @returns An array with the splitted values\n */\nexport function extractBorderValues(combinedBorder?: string): Border {\n    const result: Border = {};\n    const values = (combinedBorder || '').replace(/, /g, ',').split(' ');\n\n    values.forEach(v => {\n        if (BorderStyles.indexOf(v) >= 0 && !result.style) {\n            result.style = v;\n        } else if (BorderSizeRegex.test(v) && !result.width) {\n            result.width = v;\n        } else if (v && !result.color) {\n            result.color = v; // TODO: Do we need to use a regex to match all possible colors?\n        }\n    });\n\n    return result;\n}\n\n/**\n * Combine border value array back to string\n * @param values Input string values\n * @param initialValue Initial value for those items without valid value\n */\nexport function combineBorderValue(value: Border): string {\n    return [value.width || '', value.style || '', value.color || ''].join(' ').trim() || 'none';\n}\n"]}

package/lib-amd/publicApi/domUtils/eventUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns true when the event was fired from a modifier key, otherwise false
+ * @param event The keyboard event object
+ */
+export declare function isModifierKey(event: KeyboardEvent): boolean;
+/**
+ * Returns true when the event was fired from a key that produces a character value, otherwise false
+ * This detection is not 100% accurate. event.key is not fully supported by all browsers, and in some browsers (e.g. IE),
+ * event.key is longer than 1 for num pad input. But here we just want to improve performance as much as possible.
+ * So if we missed some case here it is still acceptable.
+ * @param event The keyboard event object
+ */
+export declare function isCharacterValue(event: KeyboardEvent): boolean;

package/lib-amd/publicApi/domUtils/eventUtils.js

@@ -0,0 +1,31 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.isCharacterValue = exports.isModifierKey = void 0;
+    var CTRL_CHAR_CODE = 'Control';
+    var ALT_CHAR_CODE = 'Alt';
+    var META_CHAR_CODE = 'Meta';
+    /**
+     * Returns true when the event was fired from a modifier key, otherwise false
+     * @param event The keyboard event object
+     */
+    function isModifierKey(event) {
+        var isCtrlKey = event.ctrlKey || event.key === CTRL_CHAR_CODE;
+        var isAltKey = event.altKey || event.key === ALT_CHAR_CODE;
+        var isMetaKey = event.metaKey || event.key === META_CHAR_CODE;
+        return isCtrlKey || isAltKey || isMetaKey;
+    }
+    exports.isModifierKey = isModifierKey;
+    /**
+     * Returns true when the event was fired from a key that produces a character value, otherwise false
+     * This detection is not 100% accurate. event.key is not fully supported by all browsers, and in some browsers (e.g. IE),
+     * event.key is longer than 1 for num pad input. But here we just want to improve performance as much as possible.
+     * So if we missed some case here it is still acceptable.
+     * @param event The keyboard event object
+     */
+    function isCharacterValue(event) {
+        return !isModifierKey(event) && !!event.key && event.key.length == 1;
+    }
+    exports.isCharacterValue = isCharacterValue;
+});
+//# sourceMappingURL=eventUtils.js.map

package/lib-amd/publicApi/domUtils/eventUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventUtils.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/domUtils/eventUtils.ts"],"names":[],"mappings":";;;;IAAA,IAAM,cAAc,GAAG,SAAS,CAAC;IACjC,IAAM,aAAa,GAAG,KAAK,CAAC;IAC5B,IAAM,cAAc,GAAG,MAAM,CAAC;IAE9B;;;OAGG;IACH,SAAgB,aAAa,CAAC,KAAoB;QAC9C,IAAM,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC;QAChE,IAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,aAAa,CAAC;QAC7D,IAAM,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC;QAEhE,OAAO,SAAS,IAAI,QAAQ,IAAI,SAAS,CAAC;IAC9C,CAAC;IAND,sCAMC;IAED;;;;;;OAMG;IACH,SAAgB,gBAAgB,CAAC,KAAoB;QACjD,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACzE,CAAC;IAFD,4CAEC","sourcesContent":["const CTRL_CHAR_CODE = 'Control';\nconst ALT_CHAR_CODE = 'Alt';\nconst META_CHAR_CODE = 'Meta';\n\n/**\n * Returns true when the event was fired from a modifier key, otherwise false\n * @param event The keyboard event object\n */\nexport function isModifierKey(event: KeyboardEvent): boolean {\n    const isCtrlKey = event.ctrlKey || event.key === CTRL_CHAR_CODE;\n    const isAltKey = event.altKey || event.key === ALT_CHAR_CODE;\n    const isMetaKey = event.metaKey || event.key === META_CHAR_CODE;\n\n    return isCtrlKey || isAltKey || isMetaKey;\n}\n\n/**\n * Returns true when the event was fired from a key that produces a character value, otherwise false\n * This detection is not 100% accurate. event.key is not fully supported by all browsers, and in some browsers (e.g. IE),\n * event.key is longer than 1 for num pad input. But here we just want to improve performance as much as possible.\n * So if we missed some case here it is still acceptable.\n * @param event The keyboard event object\n */\nexport function isCharacterValue(event: KeyboardEvent): boolean {\n    return !isModifierKey(event) && !!event.key && event.key.length == 1;\n}\n"]}

package/lib-amd/publicApi/domUtils/stringUtil.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Check if the given character is punctuation
+ * @param char The character to check
+ */
+export declare function isPunctuation(char: string): boolean;
+/**
+ * Check if the give character is a space. A space can be normal ASCII pace (32) or non-break space (160) or other kinds of spaces
+ * such as ZeroWidthSpace, ...
+ * @param char The character to check
+ */
+export declare function isSpace(char: string): boolean;
+/**
+ * Normalize spaces of the given string. After normalization, all leading (for forward) or trailing (for backward) spaces
+ * will be replaces with non-break space (160)
+ * @param txt The string to normalize
+ * @param isForward Whether normalize forward or backward
+ */
+export declare function normalizeText(txt: string, isForward: boolean): string;

package/lib-amd/publicApi/domUtils/stringUtil.js

@@ -0,0 +1,37 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.normalizeText = exports.isSpace = exports.isPunctuation = void 0;
+    var SPACES_REGEX = /[\u2000\u2009\u200a​\u200b​\u202f\u205f​\u3000\s\t\r\n]/gm;
+    var PUNCTUATIONS = '.,?!:"()[]\\/';
+    /**
+     * Check if the given character is punctuation
+     * @param char The character to check
+     */
+    function isPunctuation(char) {
+        return PUNCTUATIONS.indexOf(char) >= 0;
+    }
+    exports.isPunctuation = isPunctuation;
+    /**
+     * Check if the give character is a space. A space can be normal ASCII pace (32) or non-break space (160) or other kinds of spaces
+     * such as ZeroWidthSpace, ...
+     * @param char The character to check
+     */
+    function isSpace(char) {
+        var _a;
+        var code = (_a = char === null || char === void 0 ? void 0 : char.charCodeAt(0)) !== null && _a !== void 0 ? _a : 0;
+        return code == 160 || code == 32 || SPACES_REGEX.test(char);
+    }
+    exports.isSpace = isSpace;
+    /**
+     * Normalize spaces of the given string. After normalization, all leading (for forward) or trailing (for backward) spaces
+     * will be replaces with non-break space (160)
+     * @param txt The string to normalize
+     * @param isForward Whether normalize forward or backward
+     */
+    function normalizeText(txt, isForward) {
+        return txt.replace(isForward ? /^\u0020+/ : /\u0020+$/, '\u00A0');
+    }
+    exports.normalizeText = normalizeText;
+});
+//# sourceMappingURL=stringUtil.js.map

package/lib-amd/publicApi/domUtils/stringUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringUtil.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/domUtils/stringUtil.ts"],"names":[],"mappings":";;;;IAAA,IAAM,YAAY,GAAG,2DAA2D,CAAC;IACjF,IAAM,YAAY,GAAG,eAAe,CAAC;IAErC;;;OAGG;IACH,SAAgB,aAAa,CAAC,IAAY;QACtC,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAFD,sCAEC;IAED;;;;OAIG;IACH,SAAgB,OAAO,CAAC,IAAY;;QAChC,IAAM,IAAI,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,UAAU,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC;QACtC,OAAO,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IAHD,0BAGC;IAED;;;;;OAKG;IACH,SAAgB,aAAa,CAAC,GAAW,EAAE,SAAkB;QACzD,OAAO,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;IAFD,sCAEC","sourcesContent":["const SPACES_REGEX = /[\\u2000\\u2009\\u200a​\\u200b​\\u202f\\u205f​\\u3000\\s\\t\\r\\n]/gm;\nconst PUNCTUATIONS = '.,?!:\"()[]\\\\/';\n\n/**\n * Check if the given character is punctuation\n * @param char The character to check\n */\nexport function isPunctuation(char: string) {\n    return PUNCTUATIONS.indexOf(char) >= 0;\n}\n\n/**\n * Check if the give character is a space. A space can be normal ASCII pace (32) or non-break space (160) or other kinds of spaces\n * such as ZeroWidthSpace, ...\n * @param char The character to check\n */\nexport function isSpace(char: string) {\n    const code = char?.charCodeAt(0) ?? 0;\n    return code == 160 || code == 32 || SPACES_REGEX.test(char);\n}\n\n/**\n * Normalize spaces of the given string. After normalization, all leading (for forward) or trailing (for backward) spaces\n * will be replaces with non-break space (160)\n * @param txt The string to normalize\n * @param isForward Whether normalize forward or backward\n */\nexport function normalizeText(txt: string, isForward: boolean): string {\n    return txt.replace(isForward ? /^\\u0020+/ : /\\u0020+$/, '\\u00A0');\n}\n"]}

package/lib-amd/publicApi/model/cloneModel.d.ts

@@ -0,0 +1,30 @@
+import type { ContentModelDocument } from 'roosterjs-content-model-types';
+/**
+ * Function type used for cloneModel API to specify how to handle cached element when clone a model
+ * @param node The cached node
+ * @param type Type of the node, it can be
+ * - general: DOM element of ContentModelGeneralSegment or ContentModelGeneralBlock
+ * - entity: Wrapper element in ContentModelEntity
+ * - cache: Cached node in other model element that supports cache
+ */
+export declare type CachedElementHandler = (node: HTMLElement, type: 'general' | 'entity' | 'cache') => HTMLElement | undefined;
+/**
+ *
+ * Options for cloneModel API
+ */
+export interface CloneModelOptions {
+    /**
+     * Specify how to deal with cached element, including cached block element, element in General Model, and wrapper element in Entity
+     * - True: Cloned model will have the same reference to the cached element
+     * - False/Not passed: For cached block element, cached element will be undefined. For General Model and Entity, the element will have deep clone and assign to the cloned model
+     * - A callback: invoke the callback with the source cached element and a string to specify model type, let the callback return the expected value of cached element.
+     * For General Model and Entity, the callback must return a valid element, otherwise there will be exception thrown.
+     */
+    includeCachedElement?: boolean | CachedElementHandler;
+}
+/**
+ * Clone a content model
+ * @param model The content model to clone
+ * @param options @optional Options to specify customize the clone behavior
+ */
+export declare function cloneModel(model: ContentModelDocument, options?: CloneModelOptions): ContentModelDocument;

package/lib-amd/publicApi/model/cloneModel.js

@@ -0,0 +1,208 @@
+define(["require", "exports", "tslib"], function (require, exports, tslib_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.cloneModel = void 0;
+    /**
+     * Clone a content model
+     * @param model The content model to clone
+     * @param options @optional Options to specify customize the clone behavior
+     */
+    function cloneModel(model, options) {
+        var newModel = cloneBlockGroupBase(model, options || {});
+        if (model.format) {
+            newModel.format = Object.assign({}, model.format);
+        }
+        return newModel;
+    }
+    exports.cloneModel = cloneModel;
+    function cloneBlock(block, options) {
+        switch (block.blockType) {
+            case 'BlockGroup':
+                switch (block.blockGroupType) {
+                    case 'FormatContainer':
+                        return cloneFormatContainer(block, options);
+                    case 'General':
+                        return cloneGeneralBlock(block, options);
+                    case 'ListItem':
+                        return cloneListItem(block, options);
+                }
+                break;
+            case 'Divider':
+                return cloneDivider(block, options);
+            case 'Entity':
+                return cloneEntity(block, options);
+            case 'Paragraph':
+                return cloneParagraph(block, options);
+            case 'Table':
+                return cloneTable(block, options);
+        }
+    }
+    function cloneSegment(segment, options) {
+        switch (segment.segmentType) {
+            case 'Br':
+                return cloneSegmentBase(segment);
+            case 'Entity':
+                return cloneEntity(segment, options);
+            case 'General':
+                return cloneGeneralSegment(segment, options);
+            case 'Image':
+                return cloneImage(segment);
+            case 'SelectionMarker':
+                return cloneSelectionMarker(segment);
+            case 'Text':
+                return cloneText(segment);
+        }
+    }
+    function cloneModelWithFormat(model) {
+        return {
+            format: Object.assign({}, model.format),
+        };
+    }
+    function cloneModelWithDataset(model) {
+        return {
+            dataset: Object.assign({}, model.dataset),
+        };
+    }
+    function cloneBlockBase(block) {
+        var blockType = block.blockType;
+        return Object.assign({
+            blockType: blockType,
+        }, cloneModelWithFormat(block));
+    }
+    function cloneBlockGroupBase(group, options) {
+        var blockGroupType = group.blockGroupType, blocks = group.blocks;
+        return {
+            blockGroupType: blockGroupType,
+            blocks: blocks.map(function (block) { return cloneBlock(block, options); }),
+        };
+    }
+    function cloneSegmentBase(segment) {
+        var segmentType = segment.segmentType, isSelected = segment.isSelected, code = segment.code, link = segment.link;
+        var newSegment = Object.assign({
+            segmentType: segmentType,
+            isSelected: isSelected,
+        }, cloneModelWithFormat(segment));
+        if (code) {
+            newSegment.code = cloneModelWithFormat(code);
+        }
+        if (link) {
+            newSegment.link = Object.assign(cloneModelWithFormat(link), cloneModelWithDataset(link));
+        }
+        return newSegment;
+    }
+    function cloneEntity(entity, options) {
+        var wrapper = entity.wrapper, entityFormat = entity.entityFormat;
+        return Object.assign({
+            wrapper: handleCachedElement(wrapper, 'entity', options),
+            entityFormat: (0, tslib_1.__assign)({}, entityFormat),
+        }, cloneBlockBase(entity), cloneSegmentBase(entity));
+    }
+    function cloneParagraph(paragraph, options) {
+        var cachedElement = paragraph.cachedElement, segments = paragraph.segments, isImplicit = paragraph.isImplicit, decorator = paragraph.decorator, segmentFormat = paragraph.segmentFormat;
+        var newParagraph = Object.assign({
+            cachedElement: handleCachedElement(cachedElement, 'cache', options),
+            isImplicit: isImplicit,
+            segments: segments.map(function (segment) { return cloneSegment(segment, options); }),
+            segmentFormat: segmentFormat ? (0, tslib_1.__assign)({}, segmentFormat) : undefined,
+        }, cloneBlockBase(paragraph), cloneModelWithFormat(paragraph));
+        if (decorator) {
+            newParagraph.decorator = Object.assign({
+                tagName: decorator.tagName,
+            }, cloneModelWithFormat(decorator));
+        }
+        return newParagraph;
+    }
+    function cloneTable(table, options) {
+        var cachedElement = table.cachedElement, widths = table.widths, rows = table.rows;
+        return Object.assign({
+            cachedElement: handleCachedElement(cachedElement, 'cache', options),
+            widths: Array.from(widths),
+            rows: rows.map(function (row) { return cloneTableRow(row, options); }),
+        }, cloneBlockBase(table), cloneModelWithDataset(table));
+    }
+    function cloneTableRow(row, options) {
+        var height = row.height, cells = row.cells, cachedElement = row.cachedElement;
+        return Object.assign({
+            height: height,
+            cachedElement: handleCachedElement(cachedElement, 'cache', options),
+            cells: cells.map(function (cell) { return cloneTableCell(cell, options); }),
+        }, cloneModelWithFormat(row));
+    }
+    function cloneTableCell(cell, options) {
+        var cachedElement = cell.cachedElement, isSelected = cell.isSelected, spanAbove = cell.spanAbove, spanLeft = cell.spanLeft, isHeader = cell.isHeader;
+        return Object.assign({
+            cachedElement: handleCachedElement(cachedElement, 'cache', options),
+            isSelected: isSelected,
+            spanAbove: spanAbove,
+            spanLeft: spanLeft,
+            isHeader: isHeader,
+        }, cloneBlockGroupBase(cell, options), cloneModelWithFormat(cell), cloneModelWithDataset(cell));
+    }
+    function cloneFormatContainer(container, options) {
+        var tagName = container.tagName, cachedElement = container.cachedElement;
+        var newContainer = Object.assign({ tagName: tagName, cachedElement: handleCachedElement(cachedElement, 'cache', options) }, cloneBlockBase(container), cloneBlockGroupBase(container, options));
+        if (container.zeroFontSize) {
+            newContainer.zeroFontSize = true;
+        }
+        return newContainer;
+    }
+    function cloneListItem(item, options) {
+        var formatHolder = item.formatHolder, levels = item.levels;
+        return Object.assign({
+            formatHolder: cloneSelectionMarker(formatHolder),
+            levels: levels.map(cloneListLevel),
+        }, cloneBlockBase(item), cloneBlockGroupBase(item, options));
+    }
+    function cloneListLevel(level) {
+        var listType = level.listType;
+        return Object.assign({ listType: listType }, cloneModelWithFormat(level), cloneModelWithDataset(level));
+    }
+    function cloneDivider(divider, options) {
+        var tagName = divider.tagName, isSelected = divider.isSelected, cachedElement = divider.cachedElement;
+        return Object.assign({
+            isSelected: isSelected,
+            tagName: tagName,
+            cachedElement: handleCachedElement(cachedElement, 'cache', options),
+        }, cloneBlockBase(divider));
+    }
+    function cloneGeneralBlock(general, options) {
+        var element = general.element;
+        return Object.assign({
+            element: handleCachedElement(element, 'general', options),
+        }, cloneBlockBase(general), cloneBlockGroupBase(general, options));
+    }
+    function cloneSelectionMarker(marker) {
+        return Object.assign({ isSelected: marker.isSelected }, cloneSegmentBase(marker));
+    }
+    function cloneImage(image) {
+        var src = image.src, alt = image.alt, title = image.title, isSelectedAsImageSelection = image.isSelectedAsImageSelection;
+        return Object.assign({ src: src, alt: alt, title: title, isSelectedAsImageSelection: isSelectedAsImageSelection }, cloneSegmentBase(image), cloneModelWithDataset(image));
+    }
+    function cloneGeneralSegment(general, options) {
+        return Object.assign(cloneGeneralBlock(general, options), cloneSegmentBase(general));
+    }
+    function cloneText(textSegment) {
+        var text = textSegment.text;
+        return Object.assign({ text: text }, cloneSegmentBase(textSegment));
+    }
+    function handleCachedElement(node, type, options) {
+        var includeCachedElement = options.includeCachedElement;
+        if (!node) {
+            return undefined;
+        }
+        else if (!includeCachedElement) {
+            return type == 'cache' ? undefined : node.cloneNode(true /*deep*/);
+        }
+        else if (includeCachedElement === true) {
+            return node;
+        }
+        else {
+            var result = includeCachedElement(node, type);
+            if ((type == 'general' || type == 'entity') && !result) {
+                throw new Error('Entity and General Model must has wrapper element');
+            }
+            return result;
+        }
+    }
+});
+//# sourceMappingURL=cloneModel.js.map

package/lib-amd/publicApi/model/cloneModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneModel.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/model/cloneModel.ts"],"names":[],"mappings":";;;;IAyDA;;;;OAIG;IACH,SAAgB,UAAU,CACtB,KAA2B,EAC3B,OAA2B;QAE3B,IAAM,QAAQ,GAAyB,mBAAmB,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAEjF,IAAI,KAAK,CAAC,MAAM,EAAE;YACd,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;SACrD;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAXD,gCAWC;IAED,SAAS,UAAU,CAAC,KAAwB,EAAE,OAA0B;QACpE,QAAQ,KAAK,CAAC,SAAS,EAAE;YACrB,KAAK,YAAY;gBACb,QAAQ,KAAK,CAAC,cAAc,EAAE;oBAC1B,KAAK,iBAAiB;wBAClB,OAAO,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAChD,KAAK,SAAS;wBACV,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBAC7C,KAAK,UAAU;wBACX,OAAO,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;iBAC5C;gBACD,MAAM;YACV,KAAK,SAAS;gBACV,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxC,KAAK,QAAQ;gBACT,OAAO,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvC,KAAK,WAAW;gBACZ,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC1C,KAAK,OAAO;gBACR,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;SACzC;IACL,CAAC;IAED,SAAS,YAAY,CACjB,OAA4B,EAC5B,OAA0B;QAE1B,QAAQ,OAAO,CAAC,WAAW,EAAE;YACzB,KAAK,IAAI;gBACL,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,QAAQ;gBACT,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzC,KAAK,SAAS;gBACV,OAAO,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,KAAK,OAAO;gBACR,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;YAC/B,KAAK,iBAAiB;gBAClB,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,MAAM;gBACP,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;SACjC;IACL,CAAC;IAED,SAAS,oBAAoB,CACzB,KAAgC;QAEhC,OAAO;YACH,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;SAC1C,CAAC;IACN,CAAC;IAED,SAAS,qBAAqB,CAAI,KAAiC;QAC/D,OAAO;YACH,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;SAC5C,CAAC;IACN,CAAC;IAED,SAAS,cAAc,CACnB,KAA+B;QAEvB,IAAA,SAAS,GAAK,KAAK,UAAV,CAAW;QAE5B,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,SAAS,WAAA;SACZ,EACD,oBAAoB,CAAC,KAAK,CAAC,CAC9B,CAAC;IACN,CAAC;IAED,SAAS,mBAAmB,CACxB,KAAoC,EACpC,OAA0B;QAElB,IAAA,cAAc,GAAa,KAAK,eAAlB,EAAE,MAAM,GAAK,KAAK,OAAV,CAAW;QAEzC,OAAO;YACH,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EAA1B,CAA0B,CAAC;SAC1D,CAAC;IACN,CAAC;IAED,SAAS,gBAAgB,CACrB,OAAmC;QAE3B,IAAA,WAAW,GAA6B,OAAO,YAApC,EAAE,UAAU,GAAiB,OAAO,WAAxB,EAAE,IAAI,GAAW,OAAO,KAAlB,EAAE,IAAI,GAAK,OAAO,KAAZ,CAAa;QAExD,IAAM,UAAU,GAA+B,MAAM,CAAC,MAAM,CACxD;YACI,WAAW,aAAA;YACX,UAAU,YAAA;SACb,EACD,oBAAoB,CAAC,OAAO,CAAC,CAChC,CAAC;QAEF,IAAI,IAAI,EAAE;YACN,UAAU,CAAC,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;SAChD;QACD,IAAI,IAAI,EAAE;YACN,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;SAC5F;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,SAAS,WAAW,CAAC,MAA0B,EAAE,OAA0B;QAC/D,IAAA,OAAO,GAAmB,MAAM,QAAzB,EAAE,YAAY,GAAK,MAAM,aAAX,CAAY;QAEzC,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;YACxD,YAAY,4BAAO,YAAY,CAAE;SACpC,EACD,cAAc,CAAC,MAAM,CAAC,EACtB,gBAAgB,CAAC,MAAM,CAAC,CAC3B,CAAC;IACN,CAAC;IAED,SAAS,cAAc,CACnB,SAAgC,EAChC,OAA0B;QAElB,IAAA,aAAa,GAAqD,SAAS,cAA9D,EAAE,QAAQ,GAA2C,SAAS,SAApD,EAAE,UAAU,GAA+B,SAAS,WAAxC,EAAE,SAAS,GAAoB,SAAS,UAA7B,EAAE,aAAa,GAAK,SAAS,cAAd,CAAe;QAEpF,IAAM,YAAY,GAA0B,MAAM,CAAC,MAAM,CACrD;YACI,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;YACnE,UAAU,YAAA;YACV,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAA,OAAO,IAAI,OAAA,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAA9B,CAA8B,CAAC;YACjE,aAAa,EAAE,aAAa,CAAC,CAAC,2BAAM,aAAa,EAAG,CAAC,CAAC,SAAS;SAClE,EACD,cAAc,CAAC,SAAS,CAAC,EACzB,oBAAoB,CAAC,SAAS,CAAC,CAClC,CAAC;QAEF,IAAI,SAAS,EAAE;YACX,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAClC;gBACI,OAAO,EAAE,SAAS,CAAC,OAAO;aAC7B,EACD,oBAAoB,CAAC,SAAS,CAAC,CAClC,CAAC;SACL;QAED,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,SAAS,UAAU,CAAC,KAAwB,EAAE,OAA0B;QAC5D,IAAA,aAAa,GAAmB,KAAK,cAAxB,EAAE,MAAM,GAAW,KAAK,OAAhB,EAAE,IAAI,GAAK,KAAK,KAAV,CAAW;QAE9C,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;YACnE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,UAAA,GAAG,IAAI,OAAA,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,EAA3B,CAA2B,CAAC;SACrD,EACD,cAAc,CAAC,KAAK,CAAC,EACrB,qBAAqB,CAAC,KAAK,CAAC,CAC/B,CAAC;IACN,CAAC;IAED,SAAS,aAAa,CAClB,GAAyB,EACzB,OAA0B;QAElB,IAAA,MAAM,GAA2B,GAAG,OAA9B,EAAE,KAAK,GAAoB,GAAG,MAAvB,EAAE,aAAa,GAAK,GAAG,cAAR,CAAS;QAE7C,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,MAAM,QAAA;YACN,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;YACnE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,UAAA,IAAI,IAAI,OAAA,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAA7B,CAA6B,CAAC;SAC1D,EACD,oBAAoB,CAAC,GAAG,CAAC,CAC5B,CAAC;IACN,CAAC;IAED,SAAS,cAAc,CACnB,IAA2B,EAC3B,OAA0B;QAElB,IAAA,aAAa,GAAgD,IAAI,cAApD,EAAE,UAAU,GAAoC,IAAI,WAAxC,EAAE,SAAS,GAAyB,IAAI,UAA7B,EAAE,QAAQ,GAAe,IAAI,SAAnB,EAAE,QAAQ,GAAK,IAAI,SAAT,CAAU;QAE1E,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;YACnE,UAAU,YAAA;YACV,SAAS,WAAA;YACT,QAAQ,UAAA;YACR,QAAQ,UAAA;SACX,EACD,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,EAClC,oBAAoB,CAAC,IAAI,CAAC,EAC1B,qBAAqB,CAAC,IAAI,CAAC,CAC9B,CAAC;IACN,CAAC;IAED,SAAS,oBAAoB,CACzB,SAAsC,EACtC,OAA0B;QAElB,IAAA,OAAO,GAAoB,SAAS,QAA7B,EAAE,aAAa,GAAK,SAAS,cAAd,CAAe;QAC7C,IAAM,YAAY,GAAgC,MAAM,CAAC,MAAM,CAC3D,EAAE,OAAO,SAAA,EAAE,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAChF,cAAc,CAAC,SAAS,CAAC,EACzB,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAC1C,CAAC;QAEF,IAAI,SAAS,CAAC,YAAY,EAAE;YACxB,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC;SACpC;QAED,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,SAAS,aAAa,CAClB,IAA0B,EAC1B,OAA0B;QAElB,IAAA,YAAY,GAAa,IAAI,aAAjB,EAAE,MAAM,GAAK,IAAI,OAAT,CAAU;QAEtC,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,YAAY,EAAE,oBAAoB,CAAC,YAAY,CAAC;YAChD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;SACrC,EACD,cAAc,CAAC,IAAI,CAAC,EACpB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CACrC,CAAC;IACN,CAAC;IAED,SAAS,cAAc,CAAC,KAA4B;QACxC,IAAA,QAAQ,GAAK,KAAK,SAAV,CAAW;QAE3B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,UAAA,EAAE,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,SAAS,YAAY,CACjB,OAA4B,EAC5B,OAA0B;QAElB,IAAA,OAAO,GAAgC,OAAO,QAAvC,EAAE,UAAU,GAAoB,OAAO,WAA3B,EAAE,aAAa,GAAK,OAAO,cAAZ,CAAa;QAEvD,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,UAAU,YAAA;YACV,OAAO,SAAA;YACP,aAAa,EAAE,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;SACtE,EACD,cAAc,CAAC,OAAO,CAAC,CAC1B,CAAC;IACN,CAAC;IAED,SAAS,iBAAiB,CACtB,OAAiC,EACjC,OAA0B;QAElB,IAAA,OAAO,GAAK,OAAO,QAAZ,CAAa;QAE5B,OAAO,MAAM,CAAC,MAAM,CAChB;YACI,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;SAC5D,EACD,cAAc,CAAC,OAAO,CAAC,EACvB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CACxC,CAAC;IACN,CAAC;IAED,SAAS,oBAAoB,CAAC,MAAmC;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,SAAS,UAAU,CAAC,KAAwB;QAChC,IAAA,GAAG,GAA6C,KAAK,IAAlD,EAAE,GAAG,GAAwC,KAAK,IAA7C,EAAE,KAAK,GAAiC,KAAK,MAAtC,EAAE,0BAA0B,GAAK,KAAK,2BAAV,CAAW;QAE9D,OAAO,MAAM,CAAC,MAAM,CAChB,EAAE,GAAG,KAAA,EAAE,GAAG,KAAA,EAAE,KAAK,OAAA,EAAE,0BAA0B,4BAAA,EAAE,EAC/C,gBAAgB,CAAC,KAAK,CAAC,EACvB,qBAAqB,CAAC,KAAK,CAAC,CAC/B,CAAC;IACN,CAAC;IAED,SAAS,mBAAmB,CACxB,OAAmC,EACnC,OAA0B;QAE1B,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,SAAS,SAAS,CAAC,WAA6B;QACpC,IAAA,IAAI,GAAK,WAAW,KAAhB,CAAiB;QAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,MAAA,EAAE,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,CAAC;IAcD,SAAS,mBAAmB,CACxB,IAAmB,EACnB,IAAoC,EACpC,OAA0B;QAElB,IAAA,oBAAoB,GAAK,OAAO,qBAAZ,CAAa;QAEzC,IAAI,CAAC,IAAI,EAAE;YACP,OAAO,SAAS,CAAC;SACpB;aAAM,IAAI,CAAC,oBAAoB,EAAE;YAC9B,OAAO,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAO,CAAC;SAC7E;aAAM,IAAI,oBAAoB,KAAK,IAAI,EAAE;YACtC,OAAO,IAAI,CAAC;SACf;aAAM;YACH,IAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAkB,CAAC;YAEjE,IAAI,CAAC,IAAI,IAAI,SAAS,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;gBACpD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;aACxE;YAED,OAAO,MAAM,CAAC;SACjB;IACL,CAAC","sourcesContent":["import type {\n    ContentModelBlock,\n    ContentModelBlockBase,\n    ContentModelBlockGroupBase,\n    ContentModelBlockGroupType,\n    ContentModelBlockType,\n    ContentModelDivider,\n    ContentModelDocument,\n    ContentModelEntity,\n    ContentModelFormatBase,\n    ContentModelFormatContainer,\n    ContentModelGeneralBlock,\n    ContentModelImage,\n    ContentModelListItem,\n    ContentModelParagraph,\n    ContentModelSegment,\n    ContentModelSegmentBase,\n    ContentModelSegmentType,\n    ContentModelSelectionMarker,\n    ContentModelTable,\n    ContentModelTableCell,\n    ContentModelWithDataset,\n    ContentModelWithFormat,\n    ContentModelGeneralSegment,\n    ContentModelText,\n    ContentModelTableRow,\n    ContentModelListLevel,\n} from 'roosterjs-content-model-types';\n\n/**\n * Function type used for cloneModel API to specify how to handle cached element when clone a model\n * @param node The cached node\n * @param type Type of the node, it can be\n * - general: DOM element of ContentModelGeneralSegment or ContentModelGeneralBlock\n * - entity: Wrapper element in ContentModelEntity\n * - cache: Cached node in other model element that supports cache\n */\nexport type CachedElementHandler = (\n    node: HTMLElement,\n    type: 'general' | 'entity' | 'cache'\n) => HTMLElement | undefined;\n\n/**\n *\n * Options for cloneModel API\n */\nexport interface CloneModelOptions {\n    /**\n     * Specify how to deal with cached element, including cached block element, element in General Model, and wrapper element in Entity\n     * - True: Cloned model will have the same reference to the cached element\n     * - False/Not passed: For cached block element, cached element will be undefined. For General Model and Entity, the element will have deep clone and assign to the cloned model\n     * - A callback: invoke the callback with the source cached element and a string to specify model type, let the callback return the expected value of cached element.\n     * For General Model and Entity, the callback must return a valid element, otherwise there will be exception thrown.\n     */\n    includeCachedElement?: boolean | CachedElementHandler;\n}\n\n/**\n * Clone a content model\n * @param model The content model to clone\n * @param options @optional Options to specify customize the clone behavior\n */\nexport function cloneModel(\n    model: ContentModelDocument,\n    options?: CloneModelOptions\n): ContentModelDocument {\n    const newModel: ContentModelDocument = cloneBlockGroupBase(model, options || {});\n\n    if (model.format) {\n        newModel.format = Object.assign({}, model.format);\n    }\n\n    return newModel;\n}\n\nfunction cloneBlock(block: ContentModelBlock, options: CloneModelOptions): ContentModelBlock {\n    switch (block.blockType) {\n        case 'BlockGroup':\n            switch (block.blockGroupType) {\n                case 'FormatContainer':\n                    return cloneFormatContainer(block, options);\n                case 'General':\n                    return cloneGeneralBlock(block, options);\n                case 'ListItem':\n                    return cloneListItem(block, options);\n            }\n            break;\n        case 'Divider':\n            return cloneDivider(block, options);\n        case 'Entity':\n            return cloneEntity(block, options);\n        case 'Paragraph':\n            return cloneParagraph(block, options);\n        case 'Table':\n            return cloneTable(block, options);\n    }\n}\n\nfunction cloneSegment(\n    segment: ContentModelSegment,\n    options: CloneModelOptions\n): ContentModelSegment {\n    switch (segment.segmentType) {\n        case 'Br':\n            return cloneSegmentBase(segment);\n        case 'Entity':\n            return cloneEntity(segment, options);\n        case 'General':\n            return cloneGeneralSegment(segment, options);\n        case 'Image':\n            return cloneImage(segment);\n        case 'SelectionMarker':\n            return cloneSelectionMarker(segment);\n        case 'Text':\n            return cloneText(segment);\n    }\n}\n\nfunction cloneModelWithFormat<T extends ContentModelFormatBase>(\n    model: ContentModelWithFormat<T>\n): ContentModelWithFormat<T> {\n    return {\n        format: Object.assign({}, model.format),\n    };\n}\n\nfunction cloneModelWithDataset<T>(model: ContentModelWithDataset<T>): ContentModelWithDataset<T> {\n    return {\n        dataset: Object.assign({}, model.dataset),\n    };\n}\n\nfunction cloneBlockBase<T extends ContentModelBlockType>(\n    block: ContentModelBlockBase<T>\n): ContentModelBlockBase<T> {\n    const { blockType } = block;\n\n    return Object.assign(\n        {\n            blockType,\n        },\n        cloneModelWithFormat(block)\n    );\n}\n\nfunction cloneBlockGroupBase<T extends ContentModelBlockGroupType>(\n    group: ContentModelBlockGroupBase<T>,\n    options: CloneModelOptions\n): ContentModelBlockGroupBase<T> {\n    const { blockGroupType, blocks } = group;\n\n    return {\n        blockGroupType: blockGroupType,\n        blocks: blocks.map(block => cloneBlock(block, options)),\n    };\n}\n\nfunction cloneSegmentBase<T extends ContentModelSegmentType>(\n    segment: ContentModelSegmentBase<T>\n): ContentModelSegmentBase<T> {\n    const { segmentType, isSelected, code, link } = segment;\n\n    const newSegment: ContentModelSegmentBase<T> = Object.assign(\n        {\n            segmentType,\n            isSelected,\n        },\n        cloneModelWithFormat(segment)\n    );\n\n    if (code) {\n        newSegment.code = cloneModelWithFormat(code);\n    }\n    if (link) {\n        newSegment.link = Object.assign(cloneModelWithFormat(link), cloneModelWithDataset(link));\n    }\n\n    return newSegment;\n}\n\nfunction cloneEntity(entity: ContentModelEntity, options: CloneModelOptions): ContentModelEntity {\n    const { wrapper, entityFormat } = entity;\n\n    return Object.assign(\n        {\n            wrapper: handleCachedElement(wrapper, 'entity', options),\n            entityFormat: { ...entityFormat },\n        },\n        cloneBlockBase(entity),\n        cloneSegmentBase(entity)\n    );\n}\n\nfunction cloneParagraph(\n    paragraph: ContentModelParagraph,\n    options: CloneModelOptions\n): ContentModelParagraph {\n    const { cachedElement, segments, isImplicit, decorator, segmentFormat } = paragraph;\n\n    const newParagraph: ContentModelParagraph = Object.assign(\n        {\n            cachedElement: handleCachedElement(cachedElement, 'cache', options),\n            isImplicit,\n            segments: segments.map(segment => cloneSegment(segment, options)),\n            segmentFormat: segmentFormat ? { ...segmentFormat } : undefined,\n        },\n        cloneBlockBase(paragraph),\n        cloneModelWithFormat(paragraph)\n    );\n\n    if (decorator) {\n        newParagraph.decorator = Object.assign(\n            {\n                tagName: decorator.tagName,\n            },\n            cloneModelWithFormat(decorator)\n        );\n    }\n\n    return newParagraph;\n}\n\nfunction cloneTable(table: ContentModelTable, options: CloneModelOptions): ContentModelTable {\n    const { cachedElement, widths, rows } = table;\n\n    return Object.assign(\n        {\n            cachedElement: handleCachedElement(cachedElement, 'cache', options),\n            widths: Array.from(widths),\n            rows: rows.map(row => cloneTableRow(row, options)),\n        },\n        cloneBlockBase(table),\n        cloneModelWithDataset(table)\n    );\n}\n\nfunction cloneTableRow(\n    row: ContentModelTableRow,\n    options: CloneModelOptions\n): ContentModelTableRow {\n    const { height, cells, cachedElement } = row;\n\n    return Object.assign(\n        {\n            height,\n            cachedElement: handleCachedElement(cachedElement, 'cache', options),\n            cells: cells.map(cell => cloneTableCell(cell, options)),\n        },\n        cloneModelWithFormat(row)\n    );\n}\n\nfunction cloneTableCell(\n    cell: ContentModelTableCell,\n    options: CloneModelOptions\n): ContentModelTableCell {\n    const { cachedElement, isSelected, spanAbove, spanLeft, isHeader } = cell;\n\n    return Object.assign(\n        {\n            cachedElement: handleCachedElement(cachedElement, 'cache', options),\n            isSelected,\n            spanAbove,\n            spanLeft,\n            isHeader,\n        },\n        cloneBlockGroupBase(cell, options),\n        cloneModelWithFormat(cell),\n        cloneModelWithDataset(cell)\n    );\n}\n\nfunction cloneFormatContainer(\n    container: ContentModelFormatContainer,\n    options: CloneModelOptions\n): ContentModelFormatContainer {\n    const { tagName, cachedElement } = container;\n    const newContainer: ContentModelFormatContainer = Object.assign(\n        { tagName, cachedElement: handleCachedElement(cachedElement, 'cache', options) },\n        cloneBlockBase(container),\n        cloneBlockGroupBase(container, options)\n    );\n\n    if (container.zeroFontSize) {\n        newContainer.zeroFontSize = true;\n    }\n\n    return newContainer;\n}\n\nfunction cloneListItem(\n    item: ContentModelListItem,\n    options: CloneModelOptions\n): ContentModelListItem {\n    const { formatHolder, levels } = item;\n\n    return Object.assign(\n        {\n            formatHolder: cloneSelectionMarker(formatHolder),\n            levels: levels.map(cloneListLevel),\n        },\n        cloneBlockBase(item),\n        cloneBlockGroupBase(item, options)\n    );\n}\n\nfunction cloneListLevel(level: ContentModelListLevel): ContentModelListLevel {\n    const { listType } = level;\n\n    return Object.assign({ listType }, cloneModelWithFormat(level), cloneModelWithDataset(level));\n}\nfunction cloneDivider(\n    divider: ContentModelDivider,\n    options: CloneModelOptions\n): ContentModelDivider {\n    const { tagName, isSelected, cachedElement } = divider;\n\n    return Object.assign(\n        {\n            isSelected,\n            tagName,\n            cachedElement: handleCachedElement(cachedElement, 'cache', options),\n        },\n        cloneBlockBase(divider)\n    );\n}\n\nfunction cloneGeneralBlock(\n    general: ContentModelGeneralBlock,\n    options: CloneModelOptions\n): ContentModelGeneralBlock {\n    const { element } = general;\n\n    return Object.assign(\n        {\n            element: handleCachedElement(element, 'general', options),\n        },\n        cloneBlockBase(general),\n        cloneBlockGroupBase(general, options)\n    );\n}\n\nfunction cloneSelectionMarker(marker: ContentModelSelectionMarker): ContentModelSelectionMarker {\n    return Object.assign({ isSelected: marker.isSelected }, cloneSegmentBase(marker));\n}\n\nfunction cloneImage(image: ContentModelImage): ContentModelImage {\n    const { src, alt, title, isSelectedAsImageSelection } = image;\n\n    return Object.assign(\n        { src, alt, title, isSelectedAsImageSelection },\n        cloneSegmentBase(image),\n        cloneModelWithDataset(image)\n    );\n}\n\nfunction cloneGeneralSegment(\n    general: ContentModelGeneralSegment,\n    options: CloneModelOptions\n): ContentModelGeneralSegment {\n    return Object.assign(cloneGeneralBlock(general, options), cloneSegmentBase(general));\n}\n\nfunction cloneText(textSegment: ContentModelText): ContentModelText {\n    const { text } = textSegment;\n    return Object.assign({ text }, cloneSegmentBase(textSegment));\n}\n\nfunction handleCachedElement<T extends HTMLElement>(\n    node: T,\n    type: 'general' | 'entity',\n    options: CloneModelOptions\n): T;\n\nfunction handleCachedElement<T extends HTMLElement>(\n    node: T | undefined,\n    type: 'cache',\n    options: CloneModelOptions\n): T | undefined;\n\nfunction handleCachedElement<T extends HTMLElement>(\n    node: T | undefined,\n    type: 'general' | 'entity' | 'cache',\n    options: CloneModelOptions\n): T | undefined {\n    const { includeCachedElement } = options;\n\n    if (!node) {\n        return undefined;\n    } else if (!includeCachedElement) {\n        return type == 'cache' ? undefined : (node.cloneNode(true /*deep*/) as T);\n    } else if (includeCachedElement === true) {\n        return node;\n    } else {\n        const result = includeCachedElement(node, type) as T | undefined;\n\n        if ((type == 'general' || type == 'entity') && !result) {\n            throw new Error('Entity and General Model must has wrapper element');\n        }\n\n        return result;\n    }\n}\n"]}

package/lib-amd/publicApi/model/getClosestAncestorBlockGroupIndex.d.ts

@@ -0,0 +1,12 @@
+import type { ContentModelBlockGroup, ContentModelBlockGroupBase, ContentModelBlockGroupType } from 'roosterjs-content-model-types';
+/**
+ * Retrieve block group type string from a given block group
+ */
+export declare type TypeOfBlockGroup<T extends ContentModelBlockGroup> = T extends ContentModelBlockGroupBase<infer U> ? U : never;
+/**
+ * Get index of closest ancestor block group of the expected block group type. If not found, return -1
+ * @param path The block group path, from the closest one to root
+ * @param blockGroupTypes The expected block group types
+ * @param stopTypes @optional Block group types that will cause stop searching
+ */
+export declare function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(path: ContentModelBlockGroup[], blockGroupTypes: TypeOfBlockGroup<T>[], stopTypes?: ContentModelBlockGroupType[]): number;

package/lib-amd/publicApi/model/getClosestAncestorBlockGroupIndex.js

@@ -0,0 +1,30 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getClosestAncestorBlockGroupIndex = void 0;
+    /**
+     * Get index of closest ancestor block group of the expected block group type. If not found, return -1
+     * @param path The block group path, from the closest one to root
+     * @param blockGroupTypes The expected block group types
+     * @param stopTypes @optional Block group types that will cause stop searching
+     */
+    function getClosestAncestorBlockGroupIndex(path, blockGroupTypes, stopTypes) {
+        if (stopTypes === void 0) { stopTypes = []; }
+        for (var i = 0; i < path.length; i++) {
+            var group = path[i];
+            if (blockGroupTypes.indexOf(group.blockGroupType) >= 0) {
+                return i;
+            }
+            else if (stopTypes.indexOf(group.blockGroupType) >= 0) {
+                // Do not go across boundary specified by stopTypes.
+                // For example, in most case we will set table as the boundary,
+                // in order to allow modify list item under a table when the table itself is in another list item
+                // Although this is not very likely to happen in most case, but we still need to handle it
+                return -1;
+            }
+        }
+        return -1;
+    }
+    exports.getClosestAncestorBlockGroupIndex = getClosestAncestorBlockGroupIndex;
+});
+//# sourceMappingURL=getClosestAncestorBlockGroupIndex.js.map

package/lib-amd/publicApi/model/getClosestAncestorBlockGroupIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClosestAncestorBlockGroupIndex.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/model/getClosestAncestorBlockGroupIndex.ts"],"names":[],"mappings":";;;;IAaA;;;;;OAKG;IACH,SAAgB,iCAAiC,CAC7C,IAA8B,EAC9B,eAAsC,EACtC,SAA4C;QAA5C,0BAAA,EAAA,cAA4C;QAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAClC,IAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAK,eAA4B,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;gBAClE,OAAO,CAAC,CAAC;aACZ;iBAAM,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;gBACrD,oDAAoD;gBACpD,+DAA+D;gBAC/D,iGAAiG;gBACjG,0FAA0F;gBAC1F,OAAO,CAAC,CAAC,CAAC;aACb;SACJ;QAED,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;IApBD,8EAoBC","sourcesContent":["import type {\n    ContentModelBlockGroup,\n    ContentModelBlockGroupBase,\n    ContentModelBlockGroupType,\n} from 'roosterjs-content-model-types';\n\n/**\n * Retrieve block group type string from a given block group\n */\nexport type TypeOfBlockGroup<\n    T extends ContentModelBlockGroup\n> = T extends ContentModelBlockGroupBase<infer U> ? U : never;\n\n/**\n * Get index of closest ancestor block group of the expected block group type. If not found, return -1\n * @param path The block group path, from the closest one to root\n * @param blockGroupTypes The expected block group types\n * @param stopTypes @optional Block group types that will cause stop searching\n */\nexport function getClosestAncestorBlockGroupIndex<T extends ContentModelBlockGroup>(\n    path: ContentModelBlockGroup[],\n    blockGroupTypes: TypeOfBlockGroup<T>[],\n    stopTypes: ContentModelBlockGroupType[] = []\n): number {\n    for (let i = 0; i < path.length; i++) {\n        const group = path[i];\n\n        if ((blockGroupTypes as string[]).indexOf(group.blockGroupType) >= 0) {\n            return i;\n        } else if (stopTypes.indexOf(group.blockGroupType) >= 0) {\n            // Do not go across boundary specified by stopTypes.\n            // For example, in most case we will set table as the boundary,\n            // in order to allow modify list item under a table when the table itself is in another list item\n            // Although this is not very likely to happen in most case, but we still need to handle it\n            return -1;\n        }\n    }\n\n    return -1;\n}\n"]}

package/lib-amd/publicApi/model/isBlockGroupOfType.d.ts

@@ -0,0 +1,8 @@
+import type { ContentModelBlock, ContentModelBlockGroup } from 'roosterjs-content-model-types';
+import type { TypeOfBlockGroup } from './getClosestAncestorBlockGroupIndex';
+/**
+ * Check if the given content model block or block group is of the expected block group type
+ * @param input The object to check
+ * @param type The expected type
+ */
+export declare function isBlockGroupOfType<T extends ContentModelBlockGroup>(input: ContentModelBlock | ContentModelBlockGroup | null | undefined, type: TypeOfBlockGroup<T>): input is T;

package/lib-amd/publicApi/model/isBlockGroupOfType.js

@@ -0,0 +1,16 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.isBlockGroupOfType = void 0;
+    /**
+     * Check if the given content model block or block group is of the expected block group type
+     * @param input The object to check
+     * @param type The expected type
+     */
+    function isBlockGroupOfType(input, type) {
+        var item = input;
+        return (item === null || item === void 0 ? void 0 : item.blockGroupType) == type;
+    }
+    exports.isBlockGroupOfType = isBlockGroupOfType;
+});
+//# sourceMappingURL=isBlockGroupOfType.js.map

package/lib-amd/publicApi/model/isBlockGroupOfType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isBlockGroupOfType.js","sourceRoot":"","sources":["../../../../../packages-content-model/roosterjs-content-model-core/lib/publicApi/model/isBlockGroupOfType.ts"],"names":[],"mappings":";;;;IAGA;;;;OAIG;IACH,SAAgB,kBAAkB,CAC9B,KAAoE,EACpE,IAAyB;QAEzB,IAAM,IAAI,GAAyB,KAAK,CAAC;QAEzC,OAAO,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,cAAc,KAAI,IAAI,CAAC;IACxC,CAAC;IAPD,gDAOC","sourcesContent":["import type { ContentModelBlock, ContentModelBlockGroup } from 'roosterjs-content-model-types';\nimport type { TypeOfBlockGroup } from './getClosestAncestorBlockGroupIndex';\n\n/**\n * Check if the given content model block or block group is of the expected block group type\n * @param input The object to check\n * @param type The expected type\n */\nexport function isBlockGroupOfType<T extends ContentModelBlockGroup>(\n    input: ContentModelBlock | ContentModelBlockGroup | null | undefined,\n    type: TypeOfBlockGroup<T>\n): input is T {\n    const item = <T | null | undefined>input;\n\n    return item?.blockGroupType == type;\n}\n"]}

package/lib-amd/publicApi/model/mergeModel.d.ts

@@ -0,0 +1,36 @@
+import type { ContentModelDocument, FormatWithContentModelContext, InsertPoint } from 'roosterjs-content-model-types';
+/**
+ * Options to specify how to merge models
+ */
+export interface MergeModelOption {
+    /**
+     * When there is only a table to merge, whether merge this table into current table (if any), or just directly insert (nested table).
+     * This is usually used when paste table inside a table
+     * @default false
+     */
+    mergeTable?: boolean;
+    /**
+     * Use this insert position to merge instead of querying selection from target model
+     * @default undefined
+     */
+    insertPosition?: InsertPoint;
+    /**
+     * Use this to decide whether to change the source model format when doing the merge.
+     * 'mergeAll': segment format of the insert position will be merged into the content that is merged into current model.
+     * If the source model already has some format, it will not be overwritten.
+     * 'keepSourceEmphasisFormat': format of the insert position will be set into the content that is merged into current model.
+     * If the source model already has emphasis format, such as, fontWeight, Italic or underline different than the default style, it will not be overwritten.
+     * 'none' the source segment format will not be modified.
+     * @default undefined
+     */
+    mergeFormat?: 'mergeAll' | 'keepSourceEmphasisFormat' | 'none';
+}
+/**
+ * Merge source model into target mode
+ * @param target Target Content Model that will merge content into
+ * @param source Source Content Model will be merged to target model
+ * @param context Format context. When call this function inside formatContentModel, provide this context so that formatContentModel will do extra handling to the result
+ * @param options More options, see MergeModelOption
+ * @returns Insert point after merge, or null if there is no insert point
+ */
+export declare function mergeModel(target: ContentModelDocument, source: ContentModelDocument, context?: FormatWithContentModelContext, options?: MergeModelOption): InsertPoint | null;