@simple-table/angular 3.6.7 → 3.6.8

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

@@ -1,7 +1,14 @@
 export type SectionId = "pinned-left" | "main" | "pinned-right";
 export type SectionPaneRole = "sticky" | "scrollbar" | "header" | "body";
 export interface SectionScrollControllerConfig {
+    /** Heavy body virtualization. Throttled to every {@link VIRTUALIZATION_THRESHOLD_PX}px. */
     onMainSectionScrollLeft?: (scrollLeft: number) => void;
+    /**
+     * Lightweight header re-render, run on every main-section scroll frame (not throttled) so the
+     * header tracks the body fluidly during momentum. Re-rendering only the (few) header cells each
+     * frame avoids the stepwise "stagger" that throttled header virtualization produces.
+     */
+    onMainSectionHeaderFrame?: (scrollLeft: number) => void;
 }
 /**
  * Single controller for horizontal scroll sync across all four panes per section:
@@ -18,6 +25,15 @@ export declare class SectionScrollController {
     private isSyncing;
     /** Last scrollLeft at which we ran main-section virtualization; used to run heavy ops only every N px. */
     private lastMainVirtualizationScrollLeft;
+    /**
+     * True while a touch-driven scroll (including post-release momentum) is in progress on a body
+     * pane. While true, we must not write scrollLeft to scroll-container followers (the horizontal
+     * scrollbar), because on iOS that cancels the body's inertial momentum. Such followers are
+     * reconciled once scrolling settles.
+     */
+    private isTouchScrolling;
+    /** Scroll-idle timer used to detect the end of a touch-driven scroll (incl. momentum). */
+    private touchSettleTimeoutId;
     constructor(config?: SectionScrollControllerConfig);
     updateConfig(config: Partial<SectionScrollControllerConfig>): void;
     /**
@@ -45,6 +61,18 @@ export declare class SectionScrollController {
      */
     restoreAll(): void;
     private addScrollListener;
+    /**
+     * Track touch-driven scrolling on a body pane. While a touch (and its post-release momentum) is
+     * active, scroll-container followers (the horizontal scrollbar) are not written, to preserve iOS
+     * momentum; they are reconciled when scrolling settles.
+     */
+    private addTouchTracking;
+    /**
+     * (Re)arm the scroll-idle timer that marks the end of a touch-driven scroll. When it fires (no
+     * scroll for the idle window, i.e. momentum has stopped), reconcile scroll-container followers
+     * (the scrollbar) to the final position, which we deliberately skipped during the touch scroll.
+     */
+    private scheduleTouchSettle;
     private removeScrollListener;
     destroy(): void;
 }

package/dist/types/core/src/utils/headerCell/eventTracking.d.ts

@@ -19,7 +19,7 @@ export interface CachedHeaderPosition {
     height: number;
 }
 export declare const getHeaderPositionCache: (container: HTMLElement) => Map<string, CachedHeaderPosition>;
-export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 1500;
+export declare const REVERT_TO_PREVIOUS_HEADERS_DELAY = 150;
 export declare const throttle: (callback: () => void, limit: number) => void;
 export declare const addTrackedEventListener: (element: HTMLElement, event: string, handler: EventListener, options?: AddEventListenerOptions) => void;
 /** Header tooltips are portaled under .simple-table-root; remove them when header DOM is torn down

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simple-table/angular",
-  "version": "3.6.7",
+  "version": "3.6.8",
   "main": "dist/cjs/index.js",
   "module": "dist/index.es.js",
   "types": "dist/types/angular/src/index.d.ts",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "tslib": "^2.8.1",
-    "simple-table-core": "3.6.7"
+    "simple-table-core": "3.6.8"
   },
   "devDependencies": {
     "@angular/common": "^20.0.0",