simple-table-core 3.8.9 → 3.9.0

package/dist/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-table-core",
-  "version": "3.8.9",
+  "version": "3.9.0",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
   "types": "dist/src/index.d.ts",