gridstack 10.0.0 → 10.1.0

package/dist/es5/gridstack.js

@@ -36,7 +36,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GridStack = void 0;
 /*!
- * GridStack 10.0.0
+ * GridStack 10.1.0
  * https://gridstackjs.com/
  *
  * Copyright (c) 2021-2022 Alain Dumesny
@@ -84,6 +84,9 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         this._gsEventHandler = {};
         /** @internal extra row added when dragging at the bottom of the grid */
         this._extraDragRow = 0;
+        /** @internal meant to store the scale of the active grid */
+        this.dragTransform = { xScale: 1, yScale: 1, xOffset: 0, yOffset: 0 };
+        el.gridstack = this;
         this.el = el; // exposed HTML element to the user
         opts = opts || {}; // handles null/undefined/0
         if (!el.classList.contains('grid-stack')) {
@@ -108,7 +111,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         var oldOpts = opts;
         if (oldOpts.oneColumnModeDomSort) {
             delete oldOpts.oneColumnModeDomSort;
-            console.log('Error: Gridstack oneColumnModeDomSort no longer supported. Check GridStackOptions.columnOpts instead.');
+            console.log('warning: Gridstack oneColumnModeDomSort no longer supported. Use GridStackOptions.columnOpts instead.');
         }
         if (oldOpts.oneColumnSize || oldOpts.disableOneColumnMode === false) {
             var oneSize = oldOpts.oneColumnSize || 768;
@@ -153,6 +156,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         this._initMargin(); // part of settings defaults...
         // Now check if we're loading into 1 column mode FIRST so we don't do un-necessary work (like cellHeight = width / 12 then go 1 column)
         this.checkDynamicColumn();
+        this.el.classList.add('gs-' + this.opts.column);
         if (this.opts.rtl === 'auto') {
             this.opts.rtl = (el.style.direction === 'rtl');
         }
@@ -212,6 +216,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
                 _this._updateStyles(false, maxH); // false = don't recreate, just append if need be
             }
         });
+        // create initial global styles BEFORE loading children so resizeToContent margin can be calculated correctly
+        this._updateStyles(false, 0);
         if (this.opts.auto) {
             this.batchUpdate(); // prevent in between re-layout #1535 TODO: this only set float=true, need to prevent collision check...
             this.getGridItems().forEach(function (el) { return _this._prepareElement(el); });
@@ -224,9 +230,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             if (children.length)
                 this.load(children); // don't load empty
         }
+        // if (this.engine.nodes.length) this._updateStyles(); // update based on # of children. done in engine onChange CB
         this.setAnimation(this.opts.animate);
-        this._updateStyles();
-        this.el.classList.add('gs-' + this.opts.column);
         // dynamic grids require pausing during drag to detect over to nest vs push
         if (this.opts.subGridDynamic && !dd_manager_1.DDManager.pauseDrag)
             dd_manager_1.DDManager.pauseDrag = true;
@@ -252,6 +257,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
     GridStack.init = function (options, elOrString) {
         if (options === void 0) { options = {}; }
         if (elOrString === void 0) { elOrString = '.grid-stack'; }
+        if (typeof document === 'undefined')
+            return null; // temp workaround SSR
         var el = GridStack.getGridElement(elOrString);
         if (!el) {
             if (typeof elOrString === 'string') {
@@ -281,6 +288,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         if (options === void 0) { options = {}; }
         if (selector === void 0) { selector = '.grid-stack'; }
         var grids = [];
+        if (typeof document === 'undefined')
+            return grids; // temp workaround SSR
         GridStack.getGridElements(selector).forEach(function (el) {
             if (!el.gridstack) {
                 el.gridstack = new GridStack(el, utils_1.Utils.cloneDeep(options));
@@ -429,6 +438,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
      * @param el gridItem element to convert
      * @param ops (optional) sub-grid options, else default to node, then parent settings, else defaults
      * @param nodeToAdd (optional) node to add to the newly created sub grid (used when dragging over existing regular item)
+     * @param saveContent if true (default) the html inside .grid-stack-content will be saved to child widget
      * @returns newly created grid
      */
     GridStack.prototype.makeSubGrid = function (el, ops, nodeToAdd, saveContent) {
@@ -448,7 +458,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             grid = (_c = grid.parentGridItem) === null || _c === void 0 ? void 0 : _c.grid;
         }
         //... and set the create options
-        ops = utils_1.Utils.cloneDeep(__assign(__assign(__assign({}, (subGridTemplate || {})), { children: undefined }), (ops || node.subGridOpts)));
+        ops = utils_1.Utils.cloneDeep(__assign(__assign(__assign({}, (subGridTemplate || {})), { children: undefined }), (ops || node.subGridOpts || {})));
         node.subGridOpts = ops;
         // if column special case it set, remember that flag and set default
         var autoColumn;
@@ -644,6 +654,10 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             GridStack.addRemoveCB = addRemove;
         var removed = [];
         this.batchUpdate();
+        // if we are blank (loading into empty like startup) temp remove animation
+        var noAnim = !this.engine.nodes.length;
+        if (noAnim)
+            this.setAnimation(false);
         // see if any items are missing from new layout and need to be removed first
         if (addRemove) {
             var copyNodes = __spreadArray([], this.engine.nodes, true); // don't loop through array you modify
@@ -669,22 +683,20 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             } // remove if found from list
             return true;
         });
-        var widthChanged = false;
         items.forEach(function (w) {
             var _a;
             var item = utils_1.Utils.find(updateNodes, w.id);
             if (item) {
-                // if item sizes to content, re-use the exiting height so it's a better guess at the final size 9same if width doesn't change)
+                // if item sizes to content, re-use the exiting height so it's a better guess at the final size (same if width doesn't change)
                 if (utils_1.Utils.shouldSizeToContent(item))
                     w.h = item.h;
                 // check if missing coord, in which case find next empty slot with new (or old if missing) sizes
-                _this.engine.nodeBoundFix(w); // before widthChanged is checked below...
+                _this.engine.nodeBoundFix(w);
                 if (w.autoPosition || w.x === undefined || w.y === undefined) {
                     w.w = w.w || item.w;
                     w.h = w.h || item.h;
                     _this.engine.findEmptyPosition(w);
                 }
-                widthChanged = widthChanged || (w.w !== undefined && w.w !== item.w);
                 // add back to current list BUT force a collision check if it 'appears' we didn't change to make sure we don't overlap others now
                 _this.engine.nodes.push(item);
                 if (utils_1.Utils.samePos(item, w)) {
@@ -704,12 +716,14 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             }
         });
         this.engine.removedNodes = removed;
-        this.doContentResize(widthChanged, true); // we only need to wait for animation if we changed any widths
         this.batchUpdate(false);
         // after commit, clear that flag
         delete this._ignoreLayoutsNodeChange;
         delete this._insertNotAppend;
         prevCB ? GridStack.addRemoveCB = prevCB : delete GridStack.addRemoveCB;
+        // delay adding animation back
+        if (noAnim && this.opts.animate)
+            setTimeout(function () { return _this.setAnimation(_this.opts.animate); });
         return this;
     };
     /**
@@ -736,11 +750,25 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             (!forcePixel || !this.opts.cellHeightUnit || this.opts.cellHeightUnit === 'px')) {
             return this.opts.cellHeight;
         }
+        // do rem/em/cm/mm to px conversion
+        if (this.opts.cellHeightUnit === 'rem') {
+            return this.opts.cellHeight * parseFloat(getComputedStyle(document.documentElement).fontSize);
+        }
+        if (this.opts.cellHeightUnit === 'em') {
+            return this.opts.cellHeight * parseFloat(getComputedStyle(this.el).fontSize);
+        }
+        if (this.opts.cellHeightUnit === 'cm') {
+            // 1cm = 96px/2.54. See https://www.w3.org/TR/css-values-3/#absolute-lengths
+            return this.opts.cellHeight * (96 / 2.54);
+        }
+        if (this.opts.cellHeightUnit === 'mm') {
+            return this.opts.cellHeight * (96 / 2.54) / 10;
+        }
         // else get first cell height
         var el = this.el.querySelector('.' + this.opts.itemClass);
         if (el) {
-            var height = utils_1.Utils.toNumber(el.getAttribute('gs-h')) || 1; // since we don't write 1 anymore
-            return Math.round(el.offsetHeight / height);
+            var h = utils_1.Utils.toNumber(el.getAttribute('gs-h')) || 1; // since we don't write 1 anymore
+            return Math.round(el.offsetHeight / h);
         }
         // else do entire grid and # of rows (but doesn't work if min-height is the actual constrain)
         var rows = parseInt(this.el.getAttribute('gs-current-row'));
@@ -784,7 +812,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         }
         this.opts.cellHeightUnit = data.unit;
         this.opts.cellHeight = data.h;
-        this.doContentResize(false, true); // no anim wait, but use attributes since we only change row height
+        this.resizeToContentCheck();
         if (update) {
             this._updateStyles(true); // true = force re-create for current # of rows
         }
@@ -866,10 +894,10 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         // update the items now, checking if we have a custom children layout
         /*const newChildren = this.opts.columnOpts?.breakpoints?.find(r => r.c === column)?.children;
         if (newChildren) this.load(newChildren);
-        else*/ this.engine.columnChanged(oldColumn, column, undefined, layout);
+        else*/ this.engine.columnChanged(oldColumn, column, layout);
         if (this._isAutoCellHeight)
             this.cellHeight();
-        this.doContentResize();
+        this.resizeToContentCheck(true); // wait for width resizing
         // and trigger our event last...
         this._ignoreLayoutsNodeChange = true; // skip layout update
         this._triggerChangeEvent();
@@ -994,7 +1022,6 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         this._prepareElement(el, true, options);
         var node = el.gridstackNode;
         this._updateContainerHeight();
-        this.doContentResize(false, false, node);
         // see if there is a sub-grid to create
         if (node.subGridOpts) {
             this.makeSubGrid(el, node.subGridOpts, undefined, false); // node.subGrid will be used as option in method, no need to pass
@@ -1009,22 +1036,6 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         delete this._ignoreLayoutsNodeChange;
         return el;
     };
-    /**
-     * Event handler that extracts our CustomEvent data out automatically for receiving custom
-     * notifications (see doc for supported events)
-     * @param name of the event (see possible values) or list of names space separated
-     * @param callback function called with event and optional second/third param
-     * (see README documentation for each signature).
-     *
-     * @example
-     * grid.on('added', function(e, items) { log('added ', items)} );
-     * or
-     * grid.on('added removed change', function(e, items) { log(e.type, items)} );
-     *
-     * Note: in some cases it is the same as calling native handler and parsing the event.
-     * grid.el.addEventListener('added', function(event) { log('added ', event.detail)} );
-     *
-     */
     GridStack.prototype.on = function (name, callback) {
         var _this = this;
         // check for array of names being passed instead
@@ -1051,13 +1062,13 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             this._gsEventHandler[name] = callback;
         }
         else {
-            console.log('GridStack.on(' + name + ') event not supported');
+            console.error('GridStack.on(' + name + ') event not supported');
         }
         return this;
     };
     /**
-     * unsubscribe from the 'on' event below
-     * @param name of the event (see possible values)
+     * unsubscribe from the 'on' event GridStackEvent
+     * @param name of the event (see possible values) or list of names space separated
      */
     GridStack.prototype.off = function (name) {
         var _this = this;
@@ -1148,6 +1159,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         }
         return this;
     };
+    /** @internal */
+    GridStack.prototype.hasAnimationCSS = function () { return this.el.classList.contains('grid-stack-animate'); };
     /**
      * Toggle the grid static state, which permanently removes/add Drag&Drop support, unlike disable()/enable() that just turns it off/on.
      * Also toggle the grid-stack-static class.
@@ -1238,8 +1251,11 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             }
             utils_1.Utils.sanitizeMinMax(n);
             // finally move the widget and update attr
-            if (m)
+            if (m) {
+                var widthChanged = (m.w !== undefined && m.w !== n.w);
                 _this.moveNode(n, m);
+                _this.resizeToContentCheck(widthChanged, n); // wait for animation if we changed width
+            }
             if (m || changed) {
                 _this._writeAttr(el, n);
             }
@@ -1260,10 +1276,10 @@ var GridStack = exports.GridStack = /** @class */ (function () {
     /**
      * Updates widget height to match the content height to avoid v-scrollbar or dead space.
      * Note: this assumes only 1 child under resizeToContentParent='.grid-stack-item-content' (sized to gridItem minus padding) that is at the entire content size wanted.
-     * useAttrSize set to true if GridStackNode.h should be used instead of actual container height when we don't need to wait for animation to finish to get actual DOM heights
+     * @param el grid item element
+     * @param useNodeH set to true if GridStackNode.h should be used instead of actual container height when we don't need to wait for animation to finish to get actual DOM heights
      */
-    GridStack.prototype.resizeToContent = function (el, useAttrSize) {
-        if (useAttrSize === void 0) { useAttrSize = false; }
+    GridStack.prototype.resizeToContent = function (el) {
         if (!el)
             return;
         el.classList.remove('size-to-content-max');
@@ -1273,14 +1289,12 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         if (!n)
             return;
         var grid = n.grid;
-        if (!grid)
-            return;
-        if (el.parentElement !== grid.el)
+        if (!grid || el.parentElement !== grid.el)
             return; // skip if we are not inside a grid
-        var cell = grid.getCellHeight();
+        var cell = grid.getCellHeight(true);
         if (!cell)
             return;
-        var height = useAttrSize && n.h ? n.h * cell : el.clientHeight; // getBoundingClientRect().height seem to flicker back and forth
+        var height = n.h ? n.h * cell : el.clientHeight; // getBoundingClientRect().height seem to flicker back and forth
         var item;
         if (n.resizeToContentParent)
             item = el.querySelector(n.resizeToContentParent);
@@ -1289,17 +1303,17 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         if (!item)
             return;
         var padding = el.clientHeight - item.clientHeight; // full - available height to our child (minus border, padding...)
-        var itemH = useAttrSize && n.h ? n.h * cell - padding : item.clientHeight; // calculated to what cellHeight is or will become (rather than actual to prevent waiting for animation to finish)
+        var itemH = n.h ? n.h * cell - padding : item.clientHeight; // calculated to what cellHeight is or will become (rather than actual to prevent waiting for animation to finish)
         var wantedH;
         if (n.subGrid) {
             // sub-grid - use their actual row count * their cell height
-            wantedH = n.subGrid.getRow() * n.subGrid.getCellHeight();
+            wantedH = n.subGrid.getRow() * n.subGrid.getCellHeight(true);
         }
         else {
             // NOTE: clientHeight & getBoundingClientRect() is undefined for text and other leaf nodes. use <div> container!
             var child = item.firstElementChild;
             if (!child) {
-                console.log("Error: resizeToContent() '".concat(GridStack.resizeToContentParent, "'.firstElementChild is null, make sure to have a div like container. Skipping sizing."));
+                console.error("Error: GridStack.resizeToContent() widget id:".concat(n.id, " '").concat(GridStack.resizeToContentParent, "'.firstElementChild is null, make sure to have a div like container. Skipping sizing."));
                 return;
             }
             wantedH = child.getBoundingClientRect().height || itemH;
@@ -1325,12 +1339,11 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         }
     };
     /** call the user resize (so they can do extra work) else our build in version */
-    GridStack.prototype.resizeToContentCheck = function (el, useAttr) {
-        if (useAttr === void 0) { useAttr = false; }
+    GridStack.prototype.resizeToContentCBCheck = function (el) {
         if (GridStack.resizeToContentCB)
-            GridStack.resizeToContentCB(el, useAttr);
+            GridStack.resizeToContentCB(el);
         else
-            this.resizeToContent(el, useAttr);
+            this.resizeToContent(el);
     };
     /**
      * Updates the margins which will set all 4 sides at once - see `GridStackOptions.margin` for format options (CSS string format of 1,2,4 values or single number).
@@ -1425,7 +1438,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
     /** @internal called to delete the current dynamic style sheet used for our layout */
     GridStack.prototype._removeStylesheet = function () {
         if (this._styles) {
-            utils_1.Utils.removeStylesheet(this._styleSheetClass);
+            var styleLocation = this.opts.styleInHead ? undefined : this.el.parentNode;
+            utils_1.Utils.removeStylesheet(this._styleSheetClass, styleLocation);
             delete this._styles;
         }
         return this;
@@ -1437,7 +1451,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         if (forceUpdate) {
             this._removeStylesheet();
         }
-        if (!maxH)
+        if (maxH === undefined)
             maxH = this.getRow();
         this._updateContainerHeight();
         // if user is telling us they will handle the CSS themselves by setting heights to 0. Do we need this opts really ??
@@ -1469,6 +1483,8 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             utils_1.Utils.addCSSRule(this._styles, content, "top: ".concat(top_1, "; right: ").concat(right, "; bottom: ").concat(bottom, "; left: ").concat(left, ";"));
             utils_1.Utils.addCSSRule(this._styles, placeholder, "top: ".concat(top_1, "; right: ").concat(right, "; bottom: ").concat(bottom, "; left: ").concat(left, ";"));
             // resize handles offset (to match margin)
+            utils_1.Utils.addCSSRule(this._styles, "".concat(prefix, " > .ui-resizable-n"), "top: ".concat(top_1, ";"));
+            utils_1.Utils.addCSSRule(this._styles, "".concat(prefix, " > .ui-resizable-s"), "bottom: ".concat(bottom));
             utils_1.Utils.addCSSRule(this._styles, "".concat(prefix, " > .ui-resizable-ne"), "right: ".concat(right));
             utils_1.Utils.addCSSRule(this._styles, "".concat(prefix, " > .ui-resizable-e"), "right: ".concat(right));
             utils_1.Utils.addCSSRule(this._styles, "".concat(prefix, " > .ui-resizable-se"), "right: ".concat(right, "; bottom: ").concat(bottom));
@@ -1517,26 +1533,25 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         }
         // if we're a nested grid inside an sizeToContent item, tell it to resize itself too
         if (parent && !parent.grid.engine.batchMode && utils_1.Utils.shouldSizeToContent(parent)) {
-            parent.grid.resizeToContentCheck(parent.el);
+            parent.grid.resizeToContentCBCheck(parent.el);
         }
         return this;
     };
     /** @internal */
     GridStack.prototype._prepareElement = function (el, triggerAddEvent, node) {
         if (triggerAddEvent === void 0) { triggerAddEvent = false; }
-        el.classList.add(this.opts.itemClass);
         node = node || this._readAttr(el);
         el.gridstackNode = node;
         node.el = el;
         node.grid = this;
-        var copy = __assign({}, node);
         node = this.engine.addNode(node, triggerAddEvent);
-        // write node attr back in case there was collision or we have to fix bad values during addNode()
-        if (!utils_1.Utils.same(node, copy)) {
-            this._writeAttr(el, node);
-        }
-        if (utils_1.Utils.shouldSizeToContent(node))
-            el.classList.add('size-to-content');
+        // write the dom sizes and class
+        this._writeAttr(el, node);
+        el.classList.add(types_1.gridDefaults.itemClass, this.opts.itemClass);
+        var sizeToContent = utils_1.Utils.shouldSizeToContent(node);
+        sizeToContent ? el.classList.add('size-to-content') : el.classList.remove('size-to-content');
+        if (sizeToContent)
+            this.resizeToContentCheck(false, node);
         this._prepareDragDropByNode(node);
         return this;
     };
@@ -1666,38 +1681,38 @@ var GridStack = exports.GridStack = /** @class */ (function () {
                 n.subGrid.onResize();
         });
         if (!this._skipInitialResize)
-            this.doContentResize(columnChanged); // wait for anim of column changed (DOM reflow before we can size correctly)
+            this.resizeToContentCheck(columnChanged); // wait for anim of column changed (DOM reflow before we can size correctly)
         delete this._skipInitialResize;
         this.batchUpdate(false);
         return this;
     };
-    GridStack.prototype.doContentResize = function (delay, useAttr, n) {
+    /** resizes content for given node (or all) if shouldSizeToContent() is true */
+    GridStack.prototype.resizeToContentCheck = function (delay, n) {
         var _this = this;
-        if (delay === void 0) { delay = true; }
-        if (useAttr === void 0) { useAttr = false; }
+        if (delay === void 0) { delay = false; }
         if (n === void 0) { n = undefined; }
+        if (!this.engine)
+            return; // we've been deleted in between!
         // update any gridItem height with sizeToContent, but wait for DOM $animation_speed to settle if we changed column count
         // TODO: is there a way to know what the final (post animation) size of the content will be so we can animate the column width and height together rather than sequentially ?
-        setTimeout(function () {
-            if (!_this.engine)
-                return; // we've been deleted in between!
-            if (n) {
+        if (delay && this.hasAnimationCSS())
+            return setTimeout(function () { return _this.resizeToContentCheck(false, n); }, 300 + 10);
+        if (n) {
+            if (utils_1.Utils.shouldSizeToContent(n))
+                this.resizeToContentCBCheck(n.el);
+        }
+        else if (this.engine.nodes.some(function (n) { return utils_1.Utils.shouldSizeToContent(n); })) {
+            var nodes = __spreadArray([], this.engine.nodes, true); // in case order changes while resizing one
+            this.batchUpdate();
+            nodes.forEach(function (n) {
                 if (utils_1.Utils.shouldSizeToContent(n))
-                    _this.resizeToContentCheck(n.el, useAttr);
-            }
-            else if (_this.engine.nodes.some(function (n) { return utils_1.Utils.shouldSizeToContent(n); })) {
-                var nodes = __spreadArray([], _this.engine.nodes, true); // in case order changes while resizing one
-                _this.batchUpdate();
-                nodes.forEach(function (n) {
-                    if (utils_1.Utils.shouldSizeToContent(n))
-                        _this.resizeToContentCheck(n.el, useAttr);
-                });
-                _this.batchUpdate(false);
-            }
-            // call this regardless of shouldSizeToContent because widget might need to stretch to take available space after a resize
-            if (_this._gsEventHandler['resizecontent'])
-                _this._gsEventHandler['resizecontent'](null, n ? [n] : _this.engine.nodes);
-        }, delay ? 300 + 10 : 0);
+                    _this.resizeToContentCBCheck(n.el);
+            });
+            this.batchUpdate(false);
+        }
+        // call this regardless of shouldSizeToContent because widget might need to stretch to take available space after a resize
+        if (this._gsEventHandler['resizecontent'])
+            this._gsEventHandler['resizecontent'](null, n ? [n] : this.engine.nodes);
     };
     /** add or remove the grid element size event handler */
     GridStack.prototype._updateResizeEvent = function (forceRemove) {
@@ -1956,15 +1971,32 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         var cellHeight, cellWidth;
         var onDrag = function (event, el, helper) {
             var _a;
+            var _b;
             var node = el.gridstackNode;
             if (!node)
                 return;
             helper = helper || el;
+            // if the element is being dragged from outside, scale it down to match the grid's scale
+            // and slightly adjust its position relative to the mouse
+            if (!((_b = node.grid) === null || _b === void 0 ? void 0 : _b.el)) {
+                // this scales the helper down
+                helper.style.transform = "scale(".concat(1 / _this.dragTransform.xScale, ",").concat(1 / _this.dragTransform.yScale, ")");
+                // this makes it so that the helper is well positioned relative to the mouse after scaling
+                var helperRect = helper.getBoundingClientRect();
+                helper.style.left = helperRect.x + (_this.dragTransform.xScale - 1) * (event.clientX - helperRect.x) / _this.dragTransform.xScale + 'px';
+                helper.style.top = helperRect.y + (_this.dragTransform.yScale - 1) * (event.clientY - helperRect.y) / _this.dragTransform.yScale + 'px';
+                helper.style.transformOrigin = "0px 0px";
+            }
             var parent = _this.el.getBoundingClientRect();
             var top = (_a = helper.getBoundingClientRect(), _a.top), left = _a.left;
             left -= parent.left;
             top -= parent.top;
-            var ui = { position: { top: top, left: left } };
+            var ui = {
+                position: {
+                    top: top * _this.dragTransform.xScale,
+                    left: left * _this.dragTransform.yScale
+                }
+            };
             if (node._temporaryRemoved) {
                 node.x = Math.max(0, Math.round(left / cellWidth));
                 node.y = Math.max(0, Math.round(top / cellHeight));
@@ -2106,6 +2138,10 @@ var GridStack = exports.GridStack = /** @class */ (function () {
                 return false;
             var wasAdded = !!_this.placeholder.parentElement; // skip items not actually added to us because of constrains, but do cleanup #1419
             _this.placeholder.remove();
+            // disable animation when replacing a placeholder (already positioned) with actual content
+            var noAnim = wasAdded && _this.opts.animate;
+            if (noAnim)
+                _this.setAnimation(false);
             // notify previous grid of removal
             // console.log('drop delete _gridstackNodeOrig') // TEST
             var origNode = el._gridstackNodeOrig;
@@ -2150,15 +2186,13 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             // @ts-ignore
             utils_1.Utils.copyPos(node, _this._readAttr(_this.placeholder)); // placeholder values as moving VERY fast can throw things off #1578
             utils_1.Utils.removePositioningStyles(el); // @ts-ignore
-            _this._writeAttr(el, node);
-            el.classList.add(types_1.gridDefaults.itemClass, _this.opts.itemClass);
             _this.el.appendChild(el); // @ts-ignore // TODO: now would be ideal time to _removeHelperStyle() overriding floating styles (native only)
+            _this._prepareElement(el, true, node);
             if (subGrid) {
                 subGrid.parentGridItem = node;
                 if (!subGrid.opts.styleInHead)
                     subGrid._updateStyles(true); // re-create sub-grid styles now that we've moved
             }
-            _this._prepareDragDropByNode(node);
             _this._updateContainerHeight();
             _this.engine.addedNodes.push(node); // @ts-ignore
             _this._triggerAddEvent(); // @ts-ignore
@@ -2167,6 +2201,9 @@ var GridStack = exports.GridStack = /** @class */ (function () {
             if (_this._gsEventHandler['dropped']) {
                 _this._gsEventHandler['dropped'](__assign(__assign({}, event), { type: 'dropped' }), origNode && origNode.grid ? origNode : undefined, node);
             }
+            // delay adding animation back
+            if (noAnim)
+                setTimeout(function () { return _this.setAnimation(_this.opts.animate); });
             return false; // prevent parent from receiving msg (which may be grid as well)
         });
         return this;
@@ -2236,6 +2273,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
                 delete node._moving;
                 delete node._event;
                 delete node._lastTried;
+                var widthChanged = node.w !== node._orig.w;
                 // if the item has moved to another grid, we're done here
                 var target = event.target;
                 if (!target.gridstackNode || target.gridstackNode.grid !== _this)
@@ -2273,7 +2311,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
                 if (event.type === 'resizestop') {
                     if (Number.isInteger(node.sizeToContent))
                         node.sizeToContent = node.h; // new soft limit
-                    _this.doContentResize(false, true, node); // no amin wait as will use the actual sized coordinate attr
+                    _this.resizeToContentCheck(widthChanged, node); // wait for width animation if changed
                 }
             };
             dd.draggable(el, {
@@ -2294,12 +2332,33 @@ var GridStack = exports.GridStack = /** @class */ (function () {
     };
     /** @internal handles actual drag/resize start */
     GridStack.prototype._onStartMoving = function (el, event, ui, node, cellWidth, cellHeight) {
+        var _a;
         this.engine.cleanNodes()
             .beginUpdate(node);
         // @ts-ignore
         this._writePosAttr(this.placeholder, node);
         this.el.appendChild(this.placeholder);
         // console.log('_onStartMoving placeholder') // TEST
+        // if the element is inside a grid, it has already been scaled
+        // we can use that as a scale reference
+        if ((_a = node.grid) === null || _a === void 0 ? void 0 : _a.el) {
+            this.dragTransform = utils_1.Utils.getValuesFromTransformedElement(el);
+        }
+        // if the element is being dragged from outside (not from any grid)
+        // we use the grid as the transformation reference, since the helper is not subject to transformation
+        else if (this.placeholder && this.placeholder.closest('.grid-stack')) {
+            var gridEl = this.placeholder.closest('.grid-stack');
+            this.dragTransform = utils_1.Utils.getValuesFromTransformedElement(gridEl);
+        }
+        // Fallback
+        else {
+            this.dragTransform = {
+                xScale: 1,
+                xOffset: 0,
+                yScale: 1,
+                yOffset: 0,
+            };
+        }
         node.el = this.placeholder;
         node._lastUiPosition = ui.position;
         node._prevYPix = ui.position.top;
@@ -2416,6 +2475,9 @@ var GridStack = exports.GridStack = /** @class */ (function () {
         var node = el.gridstackNode;
         if (!node)
             return;
+        helper = helper || el;
+        // restore the scale of the helper on leave
+        helper.style.transform = 'scale(1)';
         dd.off(el, 'drag'); // no need to track while being outside
         // this gets called when cursor leaves and shape is outside, so only do this once
         if (node._temporaryRemoved)
@@ -2449,7 +2511,7 @@ var GridStack = exports.GridStack = /** @class */ (function () {
     GridStack.Utils = utils_1.Utils;
     /** scoping so users can call new GridStack.Engine(12) for example */
     GridStack.Engine = gridstack_engine_1.GridStackEngine;
-    GridStack.GDRev = '10.0.0';
+    GridStack.GDRev = '10.1.0';
     return GridStack;
 }());
 //# sourceMappingURL=gridstack.js.map