react-grid-layout 2.0.0 → 2.1.0

package/dist/core.js

@@ -1,218 +1,274 @@
 'use strict';
 
-require('./chunk-PBQSHIID.js');
-var chunk3WO4SAYB_js = require('./chunk-3WO4SAYB.js');
-var chunkF6NQPYKT_js = require('./chunk-F6NQPYKT.js');
+require('./chunk-7ELO5FRW.js');
+var chunkFN6MIZ24_js = require('./chunk-FN6MIZ24.js');
+var chunkBJFPTW5Q_js = require('./chunk-BJFPTW5Q.js');
 
 
 
 Object.defineProperty(exports, "absoluteStrategy", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.absoluteStrategy; }
+  get: function () { return chunkFN6MIZ24_js.absoluteStrategy; }
 });
-Object.defineProperty(exports, "bottom", {
+Object.defineProperty(exports, "applyPositionConstraints", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.bottom; }
+  get: function () { return chunkFN6MIZ24_js.applyPositionConstraints; }
 });
-Object.defineProperty(exports, "cloneLayout", {
+Object.defineProperty(exports, "applySizeConstraints", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.cloneLayout; }
+  get: function () { return chunkFN6MIZ24_js.applySizeConstraints; }
 });
-Object.defineProperty(exports, "cloneLayoutItem", {
+Object.defineProperty(exports, "aspectRatio", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.cloneLayoutItem; }
+  get: function () { return chunkFN6MIZ24_js.aspectRatio; }
 });
-Object.defineProperty(exports, "collides", {
+Object.defineProperty(exports, "boundedX", {
+  enumerable: true,
+  get: function () { return chunkFN6MIZ24_js.boundedX; }
+});
+Object.defineProperty(exports, "boundedY", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.collides; }
+  get: function () { return chunkFN6MIZ24_js.boundedY; }
 });
 Object.defineProperty(exports, "compact", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.compact; }
+  get: function () { return chunkFN6MIZ24_js.compact; }
 });
 Object.defineProperty(exports, "compactItem", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.compactItem; }
+  get: function () { return chunkFN6MIZ24_js.compactItem; }
 });
 Object.defineProperty(exports, "compactItemHorizontal", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.compactItemHorizontal; }
+  get: function () { return chunkFN6MIZ24_js.compactItemHorizontal; }
 });
 Object.defineProperty(exports, "compactItemVertical", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.compactItemVertical; }
+  get: function () { return chunkFN6MIZ24_js.compactItemVertical; }
 });
-Object.defineProperty(exports, "correctBounds", {
+Object.defineProperty(exports, "containerBounds", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.correctBounds; }
+  get: function () { return chunkFN6MIZ24_js.containerBounds; }
 });
 Object.defineProperty(exports, "createScaledStrategy", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.createScaledStrategy; }
+  get: function () { return chunkFN6MIZ24_js.createScaledStrategy; }
+});
+Object.defineProperty(exports, "defaultConstraints", {
+  enumerable: true,
+  get: function () { return chunkFN6MIZ24_js.defaultConstraints; }
 });
 Object.defineProperty(exports, "defaultDragConfig", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.defaultDragConfig; }
+  get: function () { return chunkFN6MIZ24_js.defaultDragConfig; }
 });
 Object.defineProperty(exports, "defaultDropConfig", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.defaultDropConfig; }
+  get: function () { return chunkFN6MIZ24_js.defaultDropConfig; }
 });
 Object.defineProperty(exports, "defaultGridConfig", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.defaultGridConfig; }
+  get: function () { return chunkFN6MIZ24_js.defaultGridConfig; }
 });
 Object.defineProperty(exports, "defaultPositionStrategy", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.defaultPositionStrategy; }
+  get: function () { return chunkFN6MIZ24_js.defaultPositionStrategy; }
 });
 Object.defineProperty(exports, "defaultResizeConfig", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.defaultResizeConfig; }
+  get: function () { return chunkFN6MIZ24_js.defaultResizeConfig; }
 });
 Object.defineProperty(exports, "findOrGenerateResponsiveLayout", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.findOrGenerateResponsiveLayout; }
-});
-Object.defineProperty(exports, "getAllCollisions", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getAllCollisions; }
+  get: function () { return chunkFN6MIZ24_js.findOrGenerateResponsiveLayout; }
 });
 Object.defineProperty(exports, "getBreakpointFromWidth", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getBreakpointFromWidth; }
+  get: function () { return chunkFN6MIZ24_js.getBreakpointFromWidth; }
 });
 Object.defineProperty(exports, "getColsFromBreakpoint", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getColsFromBreakpoint; }
+  get: function () { return chunkFN6MIZ24_js.getColsFromBreakpoint; }
 });
 Object.defineProperty(exports, "getCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getCompactor; }
-});
-Object.defineProperty(exports, "getFirstCollision", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getFirstCollision; }
+  get: function () { return chunkFN6MIZ24_js.getCompactor; }
 });
 Object.defineProperty(exports, "getIndentationValue", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getIndentationValue; }
+  get: function () { return chunkFN6MIZ24_js.getIndentationValue; }
 });
-Object.defineProperty(exports, "getLayoutItem", {
+Object.defineProperty(exports, "gridBounds", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getLayoutItem; }
-});
-Object.defineProperty(exports, "getStatics", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.getStatics; }
+  get: function () { return chunkFN6MIZ24_js.gridBounds; }
 });
 Object.defineProperty(exports, "horizontalCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.horizontalCompactor; }
+  get: function () { return chunkFN6MIZ24_js.horizontalCompactor; }
 });
 Object.defineProperty(exports, "horizontalOverlapCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.horizontalOverlapCompactor; }
+  get: function () { return chunkFN6MIZ24_js.horizontalOverlapCompactor; }
 });
-Object.defineProperty(exports, "modifyLayout", {
+Object.defineProperty(exports, "maxSize", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.modifyLayout; }
+  get: function () { return chunkFN6MIZ24_js.maxSize; }
 });
-Object.defineProperty(exports, "moveElement", {
+Object.defineProperty(exports, "minMaxSize", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.moveElement; }
+  get: function () { return chunkFN6MIZ24_js.minMaxSize; }
 });
-Object.defineProperty(exports, "moveElementAwayFromCollision", {
+Object.defineProperty(exports, "minSize", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.moveElementAwayFromCollision; }
+  get: function () { return chunkFN6MIZ24_js.minSize; }
 });
 Object.defineProperty(exports, "noCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.noCompactor; }
+  get: function () { return chunkFN6MIZ24_js.noCompactor; }
 });
 Object.defineProperty(exports, "perc", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.perc; }
+  get: function () { return chunkFN6MIZ24_js.perc; }
 });
 Object.defineProperty(exports, "resizeItemInDirection", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.resizeItemInDirection; }
+  get: function () { return chunkFN6MIZ24_js.resizeItemInDirection; }
 });
 Object.defineProperty(exports, "resolveCompactionCollision", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.resolveCompactionCollision; }
+  get: function () { return chunkFN6MIZ24_js.resolveCompactionCollision; }
 });
 Object.defineProperty(exports, "setTopLeft", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.setTopLeft; }
+  get: function () { return chunkFN6MIZ24_js.setTopLeft; }
 });
 Object.defineProperty(exports, "setTransform", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.setTransform; }
+  get: function () { return chunkFN6MIZ24_js.setTransform; }
 });
-Object.defineProperty(exports, "sortBreakpoints", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.sortBreakpoints; }
-});
-Object.defineProperty(exports, "sortLayoutItems", {
+Object.defineProperty(exports, "snapToGrid", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.sortLayoutItems; }
+  get: function () { return chunkFN6MIZ24_js.snapToGrid; }
 });
-Object.defineProperty(exports, "sortLayoutItemsByColRow", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.sortLayoutItemsByColRow; }
-});
-Object.defineProperty(exports, "sortLayoutItemsByRowCol", {
+Object.defineProperty(exports, "sortBreakpoints", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.sortLayoutItemsByRowCol; }
+  get: function () { return chunkFN6MIZ24_js.sortBreakpoints; }
 });
 Object.defineProperty(exports, "transformStrategy", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.transformStrategy; }
-});
-Object.defineProperty(exports, "validateLayout", {
-  enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.validateLayout; }
+  get: function () { return chunkFN6MIZ24_js.transformStrategy; }
 });
 Object.defineProperty(exports, "verticalCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.verticalCompactor; }
+  get: function () { return chunkFN6MIZ24_js.verticalCompactor; }
 });
 Object.defineProperty(exports, "verticalOverlapCompactor", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.verticalOverlapCompactor; }
+  get: function () { return chunkFN6MIZ24_js.verticalOverlapCompactor; }
 });
-Object.defineProperty(exports, "withLayoutItem", {
+Object.defineProperty(exports, "bottom", {
   enumerable: true,
-  get: function () { return chunk3WO4SAYB_js.withLayoutItem; }
+  get: function () { return chunkBJFPTW5Q_js.bottom; }
 });
 Object.defineProperty(exports, "calcGridCellDimensions", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcGridCellDimensions; }
+  get: function () { return chunkBJFPTW5Q_js.calcGridCellDimensions; }
 });
 Object.defineProperty(exports, "calcGridColWidth", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcGridColWidth; }
+  get: function () { return chunkBJFPTW5Q_js.calcGridColWidth; }
 });
 Object.defineProperty(exports, "calcGridItemPosition", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcGridItemPosition; }
+  get: function () { return chunkBJFPTW5Q_js.calcGridItemPosition; }
 });
 Object.defineProperty(exports, "calcGridItemWHPx", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcGridItemWHPx; }
+  get: function () { return chunkBJFPTW5Q_js.calcGridItemWHPx; }
 });
 Object.defineProperty(exports, "calcWH", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcWH; }
+  get: function () { return chunkBJFPTW5Q_js.calcWH; }
+});
+Object.defineProperty(exports, "calcWHRaw", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.calcWHRaw; }
 });
 Object.defineProperty(exports, "calcXY", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.calcXY; }
+  get: function () { return chunkBJFPTW5Q_js.calcXY; }
+});
+Object.defineProperty(exports, "calcXYRaw", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.calcXYRaw; }
 });
 Object.defineProperty(exports, "clamp", {
   enumerable: true,
-  get: function () { return chunkF6NQPYKT_js.clamp; }
+  get: function () { return chunkBJFPTW5Q_js.clamp; }
+});
+Object.defineProperty(exports, "cloneLayout", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.cloneLayout; }
+});
+Object.defineProperty(exports, "cloneLayoutItem", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.cloneLayoutItem; }
+});
+Object.defineProperty(exports, "collides", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.collides; }
+});
+Object.defineProperty(exports, "correctBounds", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.correctBounds; }
+});
+Object.defineProperty(exports, "getAllCollisions", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.getAllCollisions; }
+});
+Object.defineProperty(exports, "getFirstCollision", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.getFirstCollision; }
+});
+Object.defineProperty(exports, "getLayoutItem", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.getLayoutItem; }
+});
+Object.defineProperty(exports, "getStatics", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.getStatics; }
+});
+Object.defineProperty(exports, "modifyLayout", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.modifyLayout; }
+});
+Object.defineProperty(exports, "moveElement", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.moveElement; }
+});
+Object.defineProperty(exports, "moveElementAwayFromCollision", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.moveElementAwayFromCollision; }
+});
+Object.defineProperty(exports, "sortLayoutItems", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.sortLayoutItems; }
+});
+Object.defineProperty(exports, "sortLayoutItemsByColRow", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.sortLayoutItemsByColRow; }
+});
+Object.defineProperty(exports, "sortLayoutItemsByRowCol", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.sortLayoutItemsByRowCol; }
+});
+Object.defineProperty(exports, "validateLayout", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.validateLayout; }
+});
+Object.defineProperty(exports, "withLayoutItem", {
+  enumerable: true,
+  get: function () { return chunkBJFPTW5Q_js.withLayoutItem; }
 });
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/core.mjs

@@ -1,5 +1,5 @@
-import './chunk-ZWN22PS2.mjs';
-export { absoluteStrategy, bottom, cloneLayout, cloneLayoutItem, collides, compact, compactItem, compactItemHorizontal, compactItemVertical, correctBounds, createScaledStrategy, defaultDragConfig, defaultDropConfig, defaultGridConfig, defaultPositionStrategy, defaultResizeConfig, findOrGenerateResponsiveLayout, getAllCollisions, getBreakpointFromWidth, getColsFromBreakpoint, getCompactor, getFirstCollision, getIndentationValue, getLayoutItem, getStatics, horizontalCompactor, horizontalOverlapCompactor, modifyLayout, moveElement, moveElementAwayFromCollision, noCompactor, perc, resizeItemInDirection, resolveCompactionCollision, setTopLeft, setTransform, sortBreakpoints, sortLayoutItems, sortLayoutItemsByColRow, sortLayoutItemsByRowCol, transformStrategy, validateLayout, verticalCompactor, verticalOverlapCompactor, withLayoutItem } from './chunk-4HNUMWQK.mjs';
-export { calcGridCellDimensions, calcGridColWidth, calcGridItemPosition, calcGridItemWHPx, calcWH, calcXY, clamp } from './chunk-2KUHNJXF.mjs';
+import './chunk-526JND3R.mjs';
+export { absoluteStrategy, applyPositionConstraints, applySizeConstraints, aspectRatio, boundedX, boundedY, compact, compactItem, compactItemHorizontal, compactItemVertical, containerBounds, createScaledStrategy, defaultConstraints, defaultDragConfig, defaultDropConfig, defaultGridConfig, defaultPositionStrategy, defaultResizeConfig, findOrGenerateResponsiveLayout, getBreakpointFromWidth, getColsFromBreakpoint, getCompactor, getIndentationValue, gridBounds, horizontalCompactor, horizontalOverlapCompactor, maxSize, minMaxSize, minSize, noCompactor, perc, resizeItemInDirection, resolveCompactionCollision, setTopLeft, setTransform, snapToGrid, sortBreakpoints, transformStrategy, verticalCompactor, verticalOverlapCompactor } from './chunk-2O3ZME4Q.mjs';
+export { bottom, calcGridCellDimensions, calcGridColWidth, calcGridItemPosition, calcGridItemWHPx, calcWH, calcWHRaw, calcXY, calcXYRaw, clamp, cloneLayout, cloneLayoutItem, collides, correctBounds, getAllCollisions, getFirstCollision, getLayoutItem, getStatics, modifyLayout, moveElement, moveElementAwayFromCollision, sortLayoutItems, sortLayoutItemsByColRow, sortLayoutItemsByRowCol, validateLayout, withLayoutItem } from './chunk-AWM66AWF.mjs';
 //# sourceMappingURL=core.mjs.map
 //# sourceMappingURL=core.mjs.map

package/dist/extras.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { d as GridCellConfig } from './calculate-CwYDW8na.mjs';
-import './types-Cxf4nHNr.mjs';
+import { d as GridCellConfig } from './calculate-DwbL1D06.mjs';
+import { c as Compactor } from './types-CokovIMH.mjs';
 
 /**
  * GridBackground component
@@ -75,4 +75,134 @@ interface GridBackgroundProps extends GridCellConfig {
  */
 declare function GridBackground({ width, cols, rowHeight, margin, containerPadding, rows, height, color, borderRadius, className, style }: GridBackgroundProps): React.ReactElement;
 
-export { GridBackground, type GridBackgroundProps };
+/**
+ * Fast Vertical Compactor
+ *
+ * An optimized vertical compaction algorithm using a "rising tide" approach.
+ * This algorithm has O(n log n) complexity (dominated by sorting) compared to
+ * the default vertical compactor which can have O(n²) complexity due to
+ * recursive collision resolution.
+ *
+ * Best suited for large layouts (200+ items) where compaction performance
+ * is critical. For smaller layouts, the difference is negligible.
+ *
+ * Based on the algorithm from PR #2152 by Morris Brodersen (@morris).
+ *
+ * @example
+ * ```tsx
+ * import { fastVerticalCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={fastVerticalCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Fast vertical compactor - optimized for large layouts.
+ *
+ * Uses a "rising tide" algorithm that achieves O(n log n) complexity
+ * instead of the potentially O(n²) recursive collision resolution.
+ *
+ * Best suited for layouts with 200+ items where compaction performance
+ * becomes noticeable. For smaller layouts, the standard verticalCompactor
+ * works equally well.
+ */
+declare const fastVerticalCompactor: Compactor;
+/**
+ * Fast vertical compactor that allows overlapping items.
+ *
+ * Compacts items upward but allows them to overlap each other.
+ */
+declare const fastVerticalOverlapCompactor: Compactor;
+
+/**
+ * Fast Horizontal Compactor
+ *
+ * An optimized horizontal compaction algorithm using a "sweeping tide" approach.
+ * This algorithm has O(n log n) complexity (dominated by sorting) compared to
+ * the default horizontal compactor which can have O(n²) complexity due to
+ * recursive collision resolution.
+ *
+ * Best suited for large layouts (200+ items) where compaction performance
+ * is critical. For smaller layouts, the difference is negligible.
+ *
+ * Adapted from the vertical fast compactor algorithm from PR #2152 by Morris Brodersen (@morris).
+ *
+ * @example
+ * ```tsx
+ * import { fastHorizontalCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={fastHorizontalCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Fast horizontal compactor - optimized for large layouts.
+ *
+ * Uses a "sweeping tide" algorithm that achieves O(n log n) complexity
+ * instead of the potentially O(n²) recursive collision resolution.
+ *
+ * Best suited for layouts with 200+ items where compaction performance
+ * becomes noticeable. For smaller layouts, the standard horizontalCompactor
+ * works equally well.
+ */
+declare const fastHorizontalCompactor: Compactor;
+/**
+ * Fast horizontal compactor that allows overlapping items.
+ *
+ * Compacts items leftward but allows them to overlap each other.
+ */
+declare const fastHorizontalOverlapCompactor: Compactor;
+
+/**
+ * Wrap Compactor
+ *
+ * A compaction algorithm that treats grid items like words in a paragraph.
+ * Items flow left-to-right, wrapping to the next row when they reach
+ * the grid edge.
+ *
+ * When dragging:
+ * - Moving an item earlier in the sequence shifts other items down/right
+ * - Moving an item later in the sequence shifts other items up/left
+ *
+ * This creates a natural reordering behavior similar to drag-and-drop
+ * in file managers or card layouts.
+ *
+ * Based on the algorithm from PR #1773 by John Thomson (@JohnThomson).
+ *
+ * @example
+ * ```tsx
+ * import { wrapCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={wrapCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Wrap compactor - arranges items like words in a paragraph.
+ *
+ * Items flow left-to-right and wrap to the next row when they
+ * reach the grid edge. Dragging an item reorders the sequence,
+ * with other items shifting to maintain the flow.
+ *
+ * Works best with uniformly-sized items (especially 1x1), but
+ * handles larger items by ensuring they fit within row bounds.
+ */
+declare const wrapCompactor: Compactor;
+/**
+ * Wrap compactor that allows overlapping items.
+ */
+declare const wrapOverlapCompactor: Compactor;
+
+export { GridBackground, type GridBackgroundProps, fastHorizontalCompactor, fastHorizontalOverlapCompactor, fastVerticalCompactor, fastVerticalOverlapCompactor, wrapCompactor, wrapOverlapCompactor };

package/dist/extras.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { d as GridCellConfig } from './calculate-mgLpNJ5O.js';
-import './types-Cxf4nHNr.js';
+import { d as GridCellConfig } from './calculate-DsVTldEE.js';
+import { c as Compactor } from './types-CokovIMH.js';
 
 /**
  * GridBackground component
@@ -75,4 +75,134 @@ interface GridBackgroundProps extends GridCellConfig {
  */
 declare function GridBackground({ width, cols, rowHeight, margin, containerPadding, rows, height, color, borderRadius, className, style }: GridBackgroundProps): React.ReactElement;
 
-export { GridBackground, type GridBackgroundProps };
+/**
+ * Fast Vertical Compactor
+ *
+ * An optimized vertical compaction algorithm using a "rising tide" approach.
+ * This algorithm has O(n log n) complexity (dominated by sorting) compared to
+ * the default vertical compactor which can have O(n²) complexity due to
+ * recursive collision resolution.
+ *
+ * Best suited for large layouts (200+ items) where compaction performance
+ * is critical. For smaller layouts, the difference is negligible.
+ *
+ * Based on the algorithm from PR #2152 by Morris Brodersen (@morris).
+ *
+ * @example
+ * ```tsx
+ * import { fastVerticalCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={fastVerticalCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Fast vertical compactor - optimized for large layouts.
+ *
+ * Uses a "rising tide" algorithm that achieves O(n log n) complexity
+ * instead of the potentially O(n²) recursive collision resolution.
+ *
+ * Best suited for layouts with 200+ items where compaction performance
+ * becomes noticeable. For smaller layouts, the standard verticalCompactor
+ * works equally well.
+ */
+declare const fastVerticalCompactor: Compactor;
+/**
+ * Fast vertical compactor that allows overlapping items.
+ *
+ * Compacts items upward but allows them to overlap each other.
+ */
+declare const fastVerticalOverlapCompactor: Compactor;
+
+/**
+ * Fast Horizontal Compactor
+ *
+ * An optimized horizontal compaction algorithm using a "sweeping tide" approach.
+ * This algorithm has O(n log n) complexity (dominated by sorting) compared to
+ * the default horizontal compactor which can have O(n²) complexity due to
+ * recursive collision resolution.
+ *
+ * Best suited for large layouts (200+ items) where compaction performance
+ * is critical. For smaller layouts, the difference is negligible.
+ *
+ * Adapted from the vertical fast compactor algorithm from PR #2152 by Morris Brodersen (@morris).
+ *
+ * @example
+ * ```tsx
+ * import { fastHorizontalCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={fastHorizontalCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Fast horizontal compactor - optimized for large layouts.
+ *
+ * Uses a "sweeping tide" algorithm that achieves O(n log n) complexity
+ * instead of the potentially O(n²) recursive collision resolution.
+ *
+ * Best suited for layouts with 200+ items where compaction performance
+ * becomes noticeable. For smaller layouts, the standard horizontalCompactor
+ * works equally well.
+ */
+declare const fastHorizontalCompactor: Compactor;
+/**
+ * Fast horizontal compactor that allows overlapping items.
+ *
+ * Compacts items leftward but allows them to overlap each other.
+ */
+declare const fastHorizontalOverlapCompactor: Compactor;
+
+/**
+ * Wrap Compactor
+ *
+ * A compaction algorithm that treats grid items like words in a paragraph.
+ * Items flow left-to-right, wrapping to the next row when they reach
+ * the grid edge.
+ *
+ * When dragging:
+ * - Moving an item earlier in the sequence shifts other items down/right
+ * - Moving an item later in the sequence shifts other items up/left
+ *
+ * This creates a natural reordering behavior similar to drag-and-drop
+ * in file managers or card layouts.
+ *
+ * Based on the algorithm from PR #1773 by John Thomson (@JohnThomson).
+ *
+ * @example
+ * ```tsx
+ * import { wrapCompactor } from 'react-grid-layout/extras';
+ *
+ * <GridLayout
+ *   compactor={wrapCompactor}
+ *   layout={layout}
+ *   // ...
+ * />
+ * ```
+ */
+
+/**
+ * Wrap compactor - arranges items like words in a paragraph.
+ *
+ * Items flow left-to-right and wrap to the next row when they
+ * reach the grid edge. Dragging an item reorders the sequence,
+ * with other items shifting to maintain the flow.
+ *
+ * Works best with uniformly-sized items (especially 1x1), but
+ * handles larger items by ensuring they fit within row bounds.
+ */
+declare const wrapCompactor: Compactor;
+/**
+ * Wrap compactor that allows overlapping items.
+ */
+declare const wrapOverlapCompactor: Compactor;
+
+export { GridBackground, type GridBackgroundProps, fastHorizontalCompactor, fastHorizontalOverlapCompactor, fastVerticalCompactor, fastVerticalOverlapCompactor, wrapCompactor, wrapOverlapCompactor };