roosterjs 8.26.0 → 8.27.1

package/dist/rooster.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for roosterjs (Version 8.26.0)
+// Type definitions for roosterjs (Version 8.27.1)
 // Generated by dts tool from roosterjs
 // Project: https://github.com/Microsoft/roosterjs
 
@@ -2002,7 +2002,7 @@ class Editor implements IEditor  {
      * a ContentChangedEvent will be fired with change source equal to this value
      * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).
      */
-    addUndoSnapshot(callback?: (start: NodePosition, end: NodePosition) => any, changeSource?: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace?: boolean): void;
+    addUndoSnapshot(callback?: (start: NodePosition, end: NodePosition) => any, changeSource?: ChangeSource | CompatibleChangeSource | string, canUndoByBackspace?: boolean, additionalData?: ContentChangedData): void;
     /**
      * Whether there is an available undo/redo snapshot
      */
@@ -2429,8 +2429,9 @@ function toggleBold(editor: IEditor): void;
  * browser execCommand API
  * @param editor The editor instance
  * @param listStyle (Optional) the style of the bullet list. If not defined, the style will be set to disc.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleBullet(editor: IEditor, listStyle?: BulletListType | CompatibleBulletListType): void;
+function toggleBullet(editor: IEditor, listStyle?: BulletListType | CompatibleBulletListType, apiNameOverride?: string): void;
 
     /**
  * Toggle italic at selection
@@ -2451,8 +2452,9 @@ function toggleItalic(editor: IEditor): void;
  * @param editor The editor instance
  * @param startNumber (Optional) Start number of the list
  * @param listStyle (Optional) The style of the numbering list. If not defined, the style will be set to decimal.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleNumbering(editor: IEditor, startNumber?: number, listStyle?: NumberingListType | CompatibleNumberingListType): void;
+function toggleNumbering(editor: IEditor, startNumber?: number, listStyle?: NumberingListType | CompatibleNumberingListType, apiNameOverride?: string): void;
 
     /**
  * Resets Ordered List Numbering back to the value of the parameter startNumber
@@ -2556,8 +2558,9 @@ function applyCellShading(editor: IEditor, color: string | ModeIndependentColor)
  * @param includeSiblingLists Sets wether the operation should include Sibling Lists, by default true
  * @param orderedStyle (Optional) the style of an ordered. If not defined, the style will be set to decimal.
  * @param unorderedStyle (Optional) the style of an unordered list. If not defined, the style will be set to disc.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleListType(editor: IEditor, listType: ListType | CompatibleListType, startNumber?: number, includeSiblingLists?: boolean, orderedStyle?: NumberingListType | CompatibleNumberingListType, unorderedStyle?: BulletListType | CompatibleBulletListType): void;
+function toggleListType(editor: IEditor, listType: ListType | CompatibleListType, startNumber?: number, includeSiblingLists?: boolean, orderedStyle?: NumberingListType | CompatibleNumberingListType, unorderedStyle?: BulletListType | CompatibleBulletListType, apiNameOverride?: string): void;
 
     /**
  * Split selection into regions, and perform a block-wise formatting action for each region.
@@ -3121,6 +3124,10 @@ const enum NodeType {
      * An Element node such as <p> or <div>.
      */
     Element = 1,
+    /**
+     * An Attribute node such as name="value".
+     */
+    Attribute = 2,
     /**
      * The actual Text of Element or Attr.
      */
@@ -6272,7 +6279,7 @@ interface IEditor {
     /**
  * ContentEditFeature interface that handles keyboard event
  */
-type ContentEditFeature = GenericContentEditFeature<PluginKeyboardEvent>;
+type ContentEditFeature = GenericContentEditFeature<PluginKeyboardEvent | CompatiblePluginKeyboardEvent>;
 
     /**
  * Generic ContentEditFeature interface
@@ -8793,6 +8800,10 @@ enum CompatibleNodeType {
      * An Element node such as &lt;p&gt; or &lt;div&gt;.
      */
     Element = 1,
+    /**
+     * An Attribute node such as name="value".
+     */
+    Attribute = 2,
     /**
      * The actual Text of Element or Attr.
      */

package/dist/rooster.js

@@ -3108,7 +3108,7 @@ function setAlignment(editor, alignment) {
         else {
             alignText(editor, alignment);
         }
-    }, 'rotateElement');
+    }, 'setAlignment');
 }
 exports.default = setAlignment;
 /**
@@ -3155,7 +3155,7 @@ function alignText(editor, alignment) {
     editor.queryElements('[align]', 1 /* OnSelection */, function (node) { return (node.style.textAlign = align); });
 }
 function isList(element) {
-    return ['LI', 'UL', 'OL'].indexOf((0, roosterjs_editor_dom_1.getTagOfNode)(element)) > -1;
+    return (0, roosterjs_editor_dom_1.findClosestElementAncestor)(element, undefined /** root */, 'LI');
 }
 function alignList(editor, alignment) {
     (0, blockFormat_1.default)(editor, function (region, start, end) {
@@ -3586,9 +3586,10 @@ var toggleListType_1 = __webpack_require__(/*! ../utils/toggleListType */ "./pac
  * browser execCommand API
  * @param editor The editor instance
  * @param listStyle (Optional) the style of the bullet list. If not defined, the style will be set to disc.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleBullet(editor, listStyle) {
-    (0, toggleListType_1.default)(editor, 2 /* Unordered */, undefined /* startNumber */, false /* includeSiblingLists */, undefined /** orderedStyle  */, listStyle);
+function toggleBullet(editor, listStyle, apiNameOverride) {
+    (0, toggleListType_1.default)(editor, 2 /* Unordered */, undefined /* startNumber */, false /* includeSiblingLists */, undefined /** orderedStyle  */, listStyle, apiNameOverride);
 }
 exports.default = toggleBullet;
 
@@ -3738,9 +3739,10 @@ var toggleListType_1 = __webpack_require__(/*! ../utils/toggleListType */ "./pac
  * @param editor The editor instance
  * @param startNumber (Optional) Start number of the list
  * @param listStyle (Optional) The style of the numbering list. If not defined, the style will be set to decimal.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleNumbering(editor, startNumber, listStyle) {
-    (0, toggleListType_1.default)(editor, 1 /* Ordered */, startNumber, undefined /* includeSiblingLists */, listStyle);
+function toggleNumbering(editor, startNumber, listStyle, apiNameOverride) {
+    (0, toggleListType_1.default)(editor, 1 /* Ordered */, startNumber, undefined /* includeSiblingLists */, listStyle, undefined /* unorderedStyle */, apiNameOverride);
 }
 exports.default = toggleNumbering;
 
@@ -4533,8 +4535,9 @@ var roosterjs_editor_dom_1 = __webpack_require__(/*! roosterjs-editor-dom */ "./
  * @param includeSiblingLists Sets wether the operation should include Sibling Lists, by default true
  * @param orderedStyle (Optional) the style of an ordered. If not defined, the style will be set to decimal.
  * @param unorderedStyle (Optional) the style of an unordered list. If not defined, the style will be set to disc.
+ * @param apiNameOverride (Optional) Set a new api name, if empty the api name will be 'toggleListType'.
  */
-function toggleListType(editor, listType, startNumber, includeSiblingLists, orderedStyle, unorderedStyle) {
+function toggleListType(editor, listType, startNumber, includeSiblingLists, orderedStyle, unorderedStyle, apiNameOverride) {
     if (includeSiblingLists === void 0) { includeSiblingLists = true; }
     (0, blockFormat_1.default)(editor, function (region, start, end, chains) {
         var _a;
@@ -4549,7 +4552,7 @@ function toggleListType(editor, listType, startNumber, includeSiblingLists, orde
             }
             vList.writeBack();
         }
-    }, undefined /* beforeRunCallback */, 'toggleListType');
+    }, undefined /* beforeRunCallback */, apiNameOverride || 'toggleListType');
 }
 exports.default = toggleListType;
 
@@ -4658,7 +4661,7 @@ function addUndoSnapshotInternal(core, canUndoByBackspace) {
 
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachDomEvent = void 0;
-var lib_1 = __webpack_require__(/*! roosterjs-editor-dom/lib */ "./packages/roosterjs-editor-dom/lib/index.ts");
+var roosterjs_editor_dom_1 = __webpack_require__(/*! roosterjs-editor-dom */ "./packages/roosterjs-editor-dom/lib/index.ts");
 /**
  * @internal
  * Attach a DOM event to the editor content DIV
@@ -4668,7 +4671,7 @@ var lib_1 = __webpack_require__(/*! roosterjs-editor-dom/lib */ "./packages/roos
  * @param beforeDispatch Optional callback function to be invoked when the DOM event is triggered before trigger plugin event
  */
 var attachDomEvent = function (core, eventMap) {
-    var disposers = (0, lib_1.getObjectKeys)(eventMap || {}).map(function (eventName) {
+    var disposers = (0, roosterjs_editor_dom_1.getObjectKeys)(eventMap || {}).map(function (eventName) {
         var _a = extractHandler(eventMap[eventName]), pluginEventType = _a.pluginEventType, beforeDispatch = _a.beforeDispatch;
         var onEvent = function (event) {
             if (beforeDispatch) {
@@ -5840,8 +5843,8 @@ function ensureUniqueId(el, idPrefix) {
         //Ensure that there are no elements with the same ID
         var element = getElement();
         while (element) {
-            element = getElement();
             cont_1++;
+            element = getElement();
         }
         el.id = idPrefix + cont_1;
     }
@@ -7591,6 +7594,15 @@ var TypeInContainerPlugin = /** @class */ (function () {
     TypeInContainerPlugin.prototype.dispose = function () {
         this.editor = null;
     };
+    TypeInContainerPlugin.prototype.isRangeEmpty = function (range) {
+        if (range.collapsed &&
+            range.startContainer.nodeType === Node.ELEMENT_NODE &&
+            (0, roosterjs_editor_dom_1.getTagOfNode)(range.startContainer) == 'DIV' &&
+            !range.startContainer.firstChild) {
+            return true;
+        }
+        return false;
+    };
     /**
      * Handle events triggered from editor
      * @param event PluginEvent object
@@ -7606,7 +7618,8 @@ var TypeInContainerPlugin = /** @class */ (function () {
             // Only schedule when the range is not collapsed to catch this edge case.
             var range = this.editor.getSelectionRange();
             if (!range ||
-                this.editor.contains((0, roosterjs_editor_dom_1.findClosestElementAncestor)(range.startContainer, null /* root */, '[style]'))) {
+                (!this.isRangeEmpty(range) &&
+                    this.editor.contains((0, roosterjs_editor_dom_1.findClosestElementAncestor)(range.startContainer, null /* root */, '[style]')))) {
                 return;
             }
             if (range.collapsed) {
@@ -8338,8 +8351,8 @@ var Editor = /** @class */ (function () {
      * a ContentChangedEvent will be fired with change source equal to this value
      * @param canUndoByBackspace True if this action can be undone when user press Backspace key (aka Auto Complete).
      */
-    Editor.prototype.addUndoSnapshot = function (callback, changeSource, canUndoByBackspace) {
-        this.core.api.addUndoSnapshot(this.core, callback, changeSource, canUndoByBackspace);
+    Editor.prototype.addUndoSnapshot = function (callback, changeSource, canUndoByBackspace, additionalData) {
+        this.core.api.addUndoSnapshot(this.core, callback, changeSource, canUndoByBackspace, additionalData);
     };
     /**
      * Whether there is an available undo/redo snapshot
@@ -9780,24 +9793,13 @@ var SelectionBlockScoper = /** @class */ (function () {
      * @param startFrom Where to start, can be Begin, End, SelectionStart
      */
     function SelectionBlockScoper(rootNode, position, startFrom) {
-        var _a;
         this.rootNode = rootNode;
         this.startFrom = startFrom;
-        // Debugging info, will be removed later
-        var isPosition = false;
         if ((0, safeInstanceOf_1.default)(position, 'Range')) {
             position = Position_1.default.getStart(position);
         }
-        else {
-            isPosition = true;
-        }
-        try {
-            this.position = position.normalize();
-            this.block = (0, getBlockElementAtNode_1.default)(this.rootNode, this.position.node);
-        }
-        catch (e) {
-            throw new Error(((_a = e) === null || _a === void 0 ? void 0 : _a.message) + "; isPosition: " + isPosition + "; actual type: " + typeof position + "; String name: " + (typeof (position === null || position === void 0 ? void 0 : position.toString) === 'function' ? position.toString() : 'No toString()'));
-        }
+        this.position = position.normalize();
+        this.block = (0, getBlockElementAtNode_1.default)(this.rootNode, this.position.node);
     }
     /**
      * Get the start block element
@@ -10164,7 +10166,8 @@ function adjustInsertPositionForMoveCursorOutOfALink(root, nodeToInsert, positio
  * Adjust the position cursor out of a not contenteditable element.
  */
 function adjustInsertPositionForNotEditableNode(root, nodeToInsert, position, range) {
-    if (!position.element.isContentEditable) {
+    var _a;
+    if (!((_a = position.element) === null || _a === void 0 ? void 0 : _a.isContentEditable)) {
         var nonEditableElement = void 0;
         var lastNonEditableElement = (0, findClosestElementAncestor_1.default)(position.node, root, NOT_EDITABLE_SELECTOR);
         while (lastNonEditableElement) {
@@ -15565,6 +15568,7 @@ var VTable = /** @class */ (function () {
      */
     VTable.prototype.edit = function (operation) {
         var _this = this;
+        var _a, _b;
         if (!this.table || !this.cells || this.row === undefined || this.col == undefined) {
             return;
         }
@@ -15659,6 +15663,9 @@ var VTable = /** @class */ (function () {
                     ? this.selection.lastCell.y - this.selection.firstCell.y
                     : 0;
                 this.cells.splice(firstRow, removedRows + 1);
+                if (this.cells.length === 0) {
+                    this.cells = null;
+                }
                 break;
             case 5 /* DeleteColumn */:
                 var deletedColumns_1 = 0;
@@ -15679,6 +15686,9 @@ var VTable = /** @class */ (function () {
                 for (var colIndex = firstColumn; colIndex <= lastColumn; colIndex++) {
                     _loop_5(colIndex);
                 }
+                if (((_a = this.cells) === null || _a === void 0 ? void 0 : _a.length) === 0 || ((_b = this.cells) === null || _b === void 0 ? void 0 : _b.every(function (row) { return row.length === 0; }))) {
+                    this.cells = null;
+                }
                 break;
             case 7 /* MergeAbove */:
             case 8 /* MergeBelow */:
@@ -18497,12 +18507,12 @@ __exportStar(__webpack_require__(/*! ./AutoFormat */ "./packages/roosterjs-edito
 "use strict";
 
 Object.defineProperty(exports, "__esModule", { value: true });
-var lib_1 = __webpack_require__(/*! roosterjs-editor-dom/lib */ "./packages/roosterjs-editor-dom/lib/index.ts");
+var roosterjs_editor_dom_1 = __webpack_require__(/*! roosterjs-editor-dom */ "./packages/roosterjs-editor-dom/lib/index.ts");
 /**
  * Generate event names and getXY function based on different platforms to be compatible with desktop and mobile browsers
  */
 var MOUSE_EVENT_INFO = (function () {
-    if (lib_1.Browser.isMobileOrTablet) {
+    if (roosterjs_editor_dom_1.Browser.isMobileOrTablet) {
         return {
             MOUSEDOWN: 'touchstart',
             MOUSEMOVE: 'touchmove',
@@ -18679,7 +18689,7 @@ var AutoFormat = /** @class */ (function () {
                     textRange_1.deleteContents();
                     textRange_1.insertNode(nodeHyphen_1);
                     _this.editor.select(nodeHyphen_1, -1 /* End */);
-                }, null /*changeSource*/, true /*canUndoByBackspace*/);
+                }, "Format" /* Format */, true /*canUndoByBackspace*/, { formatApiName: 'autoHyphen' });
                 //After the substitution the last key typed needs to be cleaned
                 this.lastKeyTyped = '';
             }
@@ -18723,7 +18733,7 @@ Object.defineProperty(exports, "AutoFormat", { enumerable: true, get: function (
 
 Object.defineProperty(exports, "__esModule", { value: true });
 var getAllFeatures_1 = __webpack_require__(/*! ./getAllFeatures */ "./packages/roosterjs-editor-plugins/lib/plugins/ContentEdit/getAllFeatures.ts");
-var lib_1 = __webpack_require__(/*! roosterjs-editor-dom/lib */ "./packages/roosterjs-editor-dom/lib/index.ts");
+var roosterjs_editor_dom_1 = __webpack_require__(/*! roosterjs-editor-dom */ "./packages/roosterjs-editor-dom/lib/index.ts");
 /**
  * An editor plugin to handle content edit event.
  * The following cases are included:
@@ -18760,7 +18770,7 @@ var ContentEdit = /** @class */ (function () {
         var _this = this;
         var features = [];
         var allFeatures = (0, getAllFeatures_1.default)();
-        (0, lib_1.getObjectKeys)(allFeatures).forEach(function (key) {
+        (0, roosterjs_editor_dom_1.getObjectKeys)(allFeatures).forEach(function (key) {
             var feature = allFeatures[key];
             var hasSettingForKey = _this.settingsOverride && _this.settingsOverride[key] !== undefined;
             if ((hasSettingForKey && _this.settingsOverride[key]) ||
@@ -19295,7 +19305,7 @@ var AutoBulletList = {
             var listStyle = (0, getAutoBulletListStyle_1.default)(textBeforeCursor);
             if (textRange) {
                 prepareAutoBullet(editor, textRange);
-                (0, roosterjs_editor_api_1.toggleBullet)(editor, listStyle);
+                (0, roosterjs_editor_api_1.toggleBullet)(editor, listStyle, 'autoToggleList' /** apiNameOverride */);
             }
             (_a = searcher.getRangeFromText(textBeforeCursor, true /*exactMatch*/)) === null || _a === void 0 ? void 0 : _a.deleteContents();
         }, null /*changeSource*/, true /*canUndoByBackspace*/);
@@ -19330,11 +19340,11 @@ var AutoNumberingList = {
             else if ((regions = editor.getSelectedRegions()) && regions.length == 1) {
                 var num = parseInt(textBeforeCursor);
                 prepareAutoBullet(editor, textRange);
-                (0, roosterjs_editor_api_1.toggleNumbering)(editor, num, listStyle);
+                (0, roosterjs_editor_api_1.toggleNumbering)(editor, num, listStyle, 'autoToggleList' /** apiNameOverride */);
             }
             else {
                 prepareAutoBullet(editor, textRange);
-                (0, roosterjs_editor_api_1.toggleNumbering)(editor, undefined /* startNumber*/, listStyle);
+                (0, roosterjs_editor_api_1.toggleNumbering)(editor, undefined /* startNumber*/, listStyle, 'autoToggleList' /** apiNameOverride */);
             }
             (_a = searcher.getRangeFromText(textBeforeCursor, true /*exactMatch*/)) === null || _a === void 0 ? void 0 : _a.deleteContents();
         }, null /*changeSource*/, true /*canUndoByBackspace*/);
@@ -19404,8 +19414,9 @@ function cacheGetListElement(event, editor) {
 }
 function shouldTriggerList(event, editor, getListStyle) {
     var searcher = editor.getContentSearcherOfCursor(event);
-    var textBeforeCursor = searcher.getSubStringBefore(5);
-    return !searcher.getNearestNonTextInlineElement() && getListStyle(textBeforeCursor);
+    var textBeforeCursor = searcher.getSubStringBefore(4);
+    var itHasSpace = /\s/g.test(textBeforeCursor);
+    return (!itHasSpace && !searcher.getNearestNonTextInlineElement() && getListStyle(textBeforeCursor));
 }
 /**
  * @internal
@@ -19658,7 +19669,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ShortcutFeatures = void 0;
 var roosterjs_editor_dom_1 = __webpack_require__(/*! roosterjs-editor-dom */ "./packages/roosterjs-editor-dom/lib/index.ts");
 var roosterjs_editor_api_1 = __webpack_require__(/*! roosterjs-editor-api */ "./packages/roosterjs-editor-api/lib/index.ts");
-function createCommand(winKey, macKey, action) {
+function createCommand(winKey, macKey, action, disabled) {
+    if (disabled === void 0) { disabled = false; }
+    if (disabled) {
+        return null;
+    }
     return {
         winKey: winKey,
         macKey: macKey,
@@ -19671,13 +19686,13 @@ var commands = [
     createCommand(4096 /* Ctrl */ | 85 /* U */, 8192 /* Meta */ | 85 /* U */, roosterjs_editor_api_1.toggleUnderline),
     createCommand(4096 /* Ctrl */ | 32 /* SPACE */, 8192 /* Meta */ | 32 /* SPACE */, roosterjs_editor_api_1.clearFormat),
     createCommand(4096 /* Ctrl */ | 90 /* Z */, 8192 /* Meta */ | 90 /* Z */, function (editor) { return editor.undo(); }),
-    createCommand(18 /* ALT */ | 8 /* BACKSPACE */, 18 /* ALT */ | 8 /* BACKSPACE */, function (editor) { return editor.undo(); }),
+    createCommand(18 /* ALT */ | 8 /* BACKSPACE */, 18 /* ALT */ | 8 /* BACKSPACE */, function (editor) { return editor.undo(); }, roosterjs_editor_dom_1.Browser.isMac /* Option+Backspace to be handled by browsers on Mac */),
     createCommand(4096 /* Ctrl */ | 89 /* Y */, 8192 /* Meta */ | 16384 /* Shift */ | 90 /* Z */, function (editor) { return editor.redo(); }),
     createCommand(4096 /* Ctrl */ | 190 /* PERIOD */, 8192 /* Meta */ | 190 /* PERIOD */, roosterjs_editor_api_1.toggleBullet),
     createCommand(4096 /* Ctrl */ | 191 /* FORWARD_SLASH */, 8192 /* Meta */ | 191 /* FORWARD_SLASH */, roosterjs_editor_api_1.toggleNumbering),
     createCommand(4096 /* Ctrl */ | 16384 /* Shift */ | 190 /* PERIOD */, 8192 /* Meta */ | 16384 /* Shift */ | 190 /* PERIOD */, function (editor) { return (0, roosterjs_editor_api_1.changeFontSize)(editor, 0 /* Increase */); }),
     createCommand(4096 /* Ctrl */ | 16384 /* Shift */ | 188 /* COMMA */, 8192 /* Meta */ | 16384 /* Shift */ | 188 /* COMMA */, function (editor) { return (0, roosterjs_editor_api_1.changeFontSize)(editor, 1 /* Decrease */); }),
-];
+].filter(function (command) { return !!command; });
 /**
  * DefaultShortcut edit feature, provides shortcuts for the following features:
  * Ctrl/Meta+B: toggle bold style
@@ -25825,9 +25840,13 @@ var TableEditor = /** @class */ (function () {
             this.verticalResizer = (0, CellResizer_1.default)(td, zoomScale, this.isRTL, false /*isHorizontal*/, this.onStartCellResize, this.onFinishEditing, this.onShowHelperElement);
         }
     };
+    /**
+     * create or remove TableInserter
+     * @param td td to attach to, set this to null to remove inserters (both horizontal and vertical)
+     */
     TableEditor.prototype.setInserterTd = function (td, isHorizontal) {
         var inserter = isHorizontal ? this.horizontalInserter : this.verticalInserter;
-        if (inserter && inserter.node != td) {
+        if (td === null || (inserter && inserter.node != td)) {
             this.disposeTableInserter();
         }
         if (!this.horizontalInserter && !this.verticalInserter && td) {
@@ -27680,6 +27699,10 @@ var CompatibleNodeType;
      * An Element node such as &lt;p&gt; or &lt;div&gt;.
      */
     CompatibleNodeType[CompatibleNodeType["Element"] = 1] = "Element";
+    /**
+     * An Attribute node such as name="value".
+     */
+    CompatibleNodeType[CompatibleNodeType["Attribute"] = 2] = "Attribute";
     /**
      * The actual Text of Element or Attr.
      */