@epam/statgpt-conversation-view 0.7.0-dev.7 → 0.7.0-dev.9

package/components/Attachments/useViewModeScrollAnchor.d.ts

@@ -0,0 +1,27 @@
+import { RefObject } from 'react';
+/**
+ * Keeps the conversation content and the attachment's tabs/buttons row fixed on
+ * screen while the user switches the visualization (e.g. grid ↔ chart) and the
+ * new content has a different height.
+ *
+ * Call {@link captureAnchor} synchronously right before triggering the switch.
+ * It simply locks `scrollTop` for a short settle window:
+ *
+ * - **Taller / same-size new view** → `scrollTop` is valid throughout, so the
+ *   view stays exactly put (no jump), even while the chart builds.
+ * - **Shorter new view** → holding the old `scrollTop` is only clamped by the
+ *   browser when it now exceeds the maximum, which happens exactly when the user
+ *   was at the very bottom of the taller view. In that case the content settles
+ *   down by the height difference (the one allowed movement); otherwise it still
+ *   stays put.
+ *
+ * Native scroll anchoring is suspended during the window (its heuristic is
+ * unreliable for the last message / at the bottom), and re-enabled afterwards.
+ * A manual scroll (wheel / touch) hands control back to the user immediately.
+ *
+ * No-op when `enabled` is false (e.g. advanced view has no such scroll
+ * container).
+ */
+export declare function useViewModeScrollAnchor<T extends HTMLElement>(anchorRef: RefObject<T | null>, enabled: boolean): {
+    captureAnchor: () => void;
+};