@toolbox-web/grid 1.29.0 → 1.30.1

package/lib/plugins/pinned-columns/pinned-columns.d.ts

@@ -80,15 +80,51 @@ export interface GroupEndAdjustments {
     addGroupEnd: Set<string>;
     removeGroupEnd: Set<string>;
 }
+/**
+ * Result of applying sticky offsets — includes both the group-end adjustments
+ * and the measured left/right offset maps for use in per-cell rendering hooks.
+ */
+export interface StickyOffsetsResult {
+    groupEndAdjustments: GroupEndAdjustments;
+    leftOffsets: Map<string, number>;
+    rightOffsets: Map<string, number>;
+    splitGroups: SplitGroupState[];
+}
+/**
+ * State for an explicit group header that was split at a pin boundary.
+ *
+ * The pinned fragment is sticky and initially empty. The non-pinned fragment
+ * holds the label in a CSS-sticky span that floats toward the pinned area on
+ * horizontal scroll.  When the non-pinned fragment scrolls far enough, the
+ * plugin's `onScroll` handler transfers the label into the pinned fragment.
+ */
+export interface SplitGroupState {
+    /** Group identifier (data-group attribute value). */
+    groupId: string;
+    /** Original group label text. */
+    label: string;
+    /** The sticky (pinned) fragment element. */
+    pinnedFragment: HTMLElement;
+    /** The scrollable (non-pinned) fragment element. */
+    scrollableFragment: HTMLElement;
+    /** The floating <span> inside the scrollable fragment. */
+    floatLabel: HTMLElement;
+    /** Field of the last pinned column — used to toggle `.group-end`. */
+    pinnedField: string;
+    /** Whether the label is currently shown inside the pinned fragment. */
+    isTransferred: boolean;
+    /** Current translateX offset applied to the floating label (px). */
+    floatOffset: number;
+}
 /**
  * Apply sticky offsets to header and body cells.
  * This modifies the DOM elements in place.
  *
  * @param host - The grid host element (render root for DOM queries)
  * @param columns - Array of column configurations
- * @returns Group-end adjustments for `afterCellRender` hooks to maintain during scroll
+ * @returns Sticky offsets result with group-end adjustments and measured offset maps
  */
-export declare function applyStickyOffsets(host: HTMLElement, columns: any[]): GroupEndAdjustments;
+export declare function applyStickyOffsets(host: HTMLElement, columns: any[]): StickyOffsetsResult;
 /**
  * Reorder columns so that pinned-left columns come first and pinned-right columns come last.
  * Maintains the relative order within each group (left-pinned, unpinned, right-pinned).