@simple-table/react 3.8.9 → 3.9.1

package/dist/types/core/src/managers/AnimationCoordinator.d.ts

@@ -205,6 +205,73 @@ export declare class AnimationCoordinator {
      * sort/reorder FLIP-from-off-screen behavior is preserved.
      */
     hasSnapshotEntryInContainer(cellId: string, currentContainer: HTMLElement): boolean;
+    /**
+     * Whether a vertical position transition should be animated. Rows that live
+     * only in the virtualization padding band (above/below the visible viewport)
+     * should teleport rather than FLIP — otherwise a mid-scroll sort animates
+     * hundreds of off-screen rows through the viewport at once.
+     */
+    shouldAnimateVerticalTransition(args: {
+        beforeTop: number;
+        afterTop: number;
+        cellHeight: number;
+        container: HTMLElement;
+    }): boolean;
+    /**
+     * Whether a horizontal position transition should be animated. Same viewport
+     * gate as {@link shouldAnimateVerticalTransition} but for column slides.
+     */
+    shouldAnimateHorizontalTransition(args: {
+        beforeLeft: number;
+        afterLeft: number;
+        cellWidth: number;
+        container: HTMLElement;
+    }): boolean;
+    /**
+     * Whether a cell's position change should participate in FLIP animation.
+     * Only axes that actually moved are checked against the viewport gate —
+     * a vertical sort must not inherit "visible" from an unchanged horizontal
+     * position (which would retain/mount every column in every padding-band row).
+     */
+    shouldAnimateTransition(args: {
+        beforeTop: number;
+        afterTop: number;
+        beforeLeft: number;
+        afterLeft: number;
+        cellHeight: number;
+        cellWidth: number;
+        container: HTMLElement;
+    }): boolean;
+    /**
+     * Whether an incoming cell (in the snapshot but not previously in the DOM)
+     * should be mounted for this sort/reorder render. Padding-band rows that
+     * never intersect the visible viewport are deferred to the next scroll
+     * render so they do not pop into existence at animation start.
+     */
+    shouldMountIncomingCell(args: {
+        cellId: string;
+        afterTop: number;
+        afterLeft: number;
+        cellHeight: number;
+        cellWidth: number;
+        container: HTMLElement;
+    }): boolean;
+    /**
+     * Whether the cell currently paints inside the body scrollers' clip rects.
+     * Outgoing retain decisions use this as a fallback when {@link shouldAnimateTransition}
+     * rejects a cell based on `style.top`/`style.left` alone: virtualization padding
+     * rows can sit with their leading edge outside the scroll band while still being
+     * partially visible on screen (common at the bottom when scrolled to the end).
+     */
+    isCellRenderedInScrollerViewport(element: HTMLElement, container: HTMLElement): boolean;
+    /**
+     * Whether an outgoing DOM cell at a vertical scroll extreme (top or bottom of
+     * the dataset) should be retained even when {@link shouldAnimateTransition}
+     * rejects it on leading-edge grounds. Virtualization keeps a few overscan
+     * rows mounted above/below the strict viewport at max scroll; those rows
+     * must still slide out as ghosts when a sort evicts them.
+     */
+    shouldRetainDomCellAtScrollExtrema(cellId: string, container: HTMLElement): boolean;
     /**
      * Hand a cell that the renderer would otherwise remove to the coordinator.
      * The coordinator updates its absolute positioning to the post-change layout

package/dist/types/core/src/managers/DimensionManager.d.ts

@@ -21,12 +21,20 @@ export interface DimensionManagerState {
     contentHeight: number | undefined;
 }
 type StateChangeCallback = (state: DimensionManagerState) => void;
+/**
+ * Wait this long after the last container-width ResizeObserver tick before
+ * notifying subscribers. Coalesces CSS-transition / animated layout shifts
+ * (e.g. a collapsible nav) into a single trailing update instead of one full
+ * table render per animation frame.
+ */
+export declare const CONTAINER_RESIZE_NOTIFY_DEBOUNCE_MS = 50;
 export declare class DimensionManager {
     private config;
     private state;
     private subscribers;
     private resizeObserver;
     private rafId;
+    private resizeNotifyDebounceId;
     /** Set when applyContainerWidthSync updates state before any subscriber exists. */
     private initialNotifyPending;
     constructor(config: DimensionManagerConfig);
@@ -35,6 +43,9 @@ export declare class DimensionManager {
     private calculateHeaderHeight;
     private convertHeightToPixels;
     private calculateContentHeight;
+    private cancelPendingResizeNotify;
+    /** Trailing debounce for animated / continuous container resizes. */
+    private scheduleResizeNotify;
     private observeContainer;
     private applyContainerWidthSync;
     updateConfig(config: Partial<DimensionManagerConfig>): void;

package/dist/types/core/src/types/AnimationsConfig.d.ts

@@ -3,6 +3,8 @@
  *
  * The animation coordinator runs FLIP-style transitions when cells move between
  * positions. All fields are optional; omit the prop entirely to use defaults.
+ *
+ * Row group expand/collapse never animates when `rowGrouping` is configured.
  */
 export interface AnimationsConfig {
     /** Master toggle. Defaults to `true`. When `false`, no other field has effect. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simple-table/react",
-  "version": "3.8.9",
+  "version": "3.9.1",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
   "types": "dist/types/react/src/index.d.ts",
@@ -29,7 +29,7 @@
     "react-dom": ">=18.0.0"
   },
   "dependencies": {
-    "simple-table-core": "3.8.9"
+    "simple-table-core": "3.9.1"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^4.0.4",

package/dist/types/react/src/__tests__/animationCoordinator.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/autoSizeColumns.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/cellRendererMemoization.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/collapseMultipleColumnGroups.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/columnVirtualizationViewportWidth.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/contextAndSlots.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/deferredHeaders.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/domSlots.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/errorBoundary.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/excludeFromRenderWidth.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/getRowIdChange.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/hostContext.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/imperativeDomSlot.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/linkClickInCell.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/loadingSkeletonExpandableColumn.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/maxHeightCalcScroll.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/maxHeightServerSidePaginationEmptyRows.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/portalBridge.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/resetColumns.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/rowButtons.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/rowHover.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/serverSidePaginationCustomFooter.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/staleCallbacks.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/staleRowIdCells.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/updateDataDuringAnimation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/react/src/__tests__/wrapReactRenderer.test.d.ts

@@ -1 +0,0 @@
-export {};