@ai-matrx/design-system 0.14.3 → 0.15.2

package/dist/data-table/scroll-pagination.cjs

@@ -0,0 +1,222 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/data-table/useScrollPagination.ts
+var useScrollPagination_exports = {};
+__export(useScrollPagination_exports, {
+  useScrollPagination: () => useScrollPagination
+});
+module.exports = __toCommonJS(useScrollPagination_exports);
+var import_react = require("react");
+var DEFAULT_THRESHOLD_PX = 96;
+var DEFAULT_INTENT_TIMEOUT_MS = 1200;
+function resolveContainer(container) {
+  if (!container) return null;
+  return container instanceof HTMLElement ? container : container.current;
+}
+function isVisibleContainer(container) {
+  if (!container.isConnected) return false;
+  for (let node = container; node; node = node.parentElement) {
+    const style = window.getComputedStyle(node);
+    if (style.display === "none" || style.visibility === "hidden") return false;
+  }
+  return true;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  return target.isContentEditable || Boolean(target.closest("input, textarea, select, [contenteditable='true']"));
+}
+function isDownwardKeyboardInput(event) {
+  if (isEditableTarget(event.target)) return false;
+  return ["ArrowDown", "PageDown", "End", " ", "Spacebar"].includes(event.key);
+}
+function isNearBottom(container, thresholdPx) {
+  return container.scrollHeight - container.clientHeight - container.scrollTop <= thresholdPx;
+}
+function isNativeScrollbarPointer(event, container) {
+  if (event.pointerType !== "mouse" || event.button !== 0 || !event.isPrimary) return false;
+  const gutterWidth = container.offsetWidth - container.clientWidth;
+  if (gutterWidth <= 0 || container.scrollHeight <= container.clientHeight) return false;
+  const rect = container.getBoundingClientRect();
+  return event.clientX >= rect.right - gutterWidth && event.clientX <= rect.right;
+}
+function useScrollPagination({
+  containers,
+  queryKey,
+  hasNextPage,
+  isFetchingNextPage,
+  loading,
+  error,
+  loadNextPage,
+  mode = "scroll",
+  thresholdPx = DEFAULT_THRESHOLD_PX,
+  intentTimeoutMs = DEFAULT_INTENT_TIMEOUT_MS,
+  enabled = true
+}) {
+  const [requestError, setRequestError] = (0, import_react.useState)(null);
+  const latestRef = (0, import_react.useRef)({
+    queryKey,
+    hasNextPage,
+    isFetchingNextPage,
+    loading,
+    error,
+    loadNextPage,
+    mode,
+    thresholdPx,
+    enabled
+  });
+  latestRef.current = {
+    queryKey,
+    hasNextPage,
+    isFetchingNextPage,
+    loading,
+    error,
+    loadNextPage,
+    mode,
+    thresholdPx,
+    enabled
+  };
+  const intentRef = (0, import_react.useRef)(null);
+  const inputSequenceRef = (0, import_react.useRef)(0);
+  const consumedSequenceRef = (0, import_react.useRef)(0);
+  const requestGenerationRef = (0, import_react.useRef)(0);
+  const inFlightGenerationRef = (0, import_react.useRef)(null);
+  const requestErrorRef = (0, import_react.useRef)(null);
+  const mountedRef = (0, import_react.useRef)(false);
+  const effectiveError = error ?? requestError;
+  (0, import_react.useEffect)(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const requestNextPage = async () => {
+    const current = latestRef.current;
+    if (!current.enabled || !current.hasNextPage && effectiveError === null || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) {
+      return;
+    }
+    const generation = ++requestGenerationRef.current;
+    inFlightGenerationRef.current = generation;
+    requestErrorRef.current = null;
+    setRequestError(null);
+    try {
+      await current.loadNextPage();
+    } catch (raw) {
+      const nextError = raw instanceof Error ? raw : new Error(String(raw));
+      if (inFlightGenerationRef.current === generation && latestRef.current.queryKey === current.queryKey) {
+        requestErrorRef.current = nextError;
+        if (mountedRef.current) setRequestError(nextError);
+      }
+    } finally {
+      if (inFlightGenerationRef.current === generation) {
+        inFlightGenerationRef.current = null;
+        intentRef.current = null;
+      }
+    }
+  };
+  (0, import_react.useEffect)(() => {
+    intentRef.current = null;
+    consumedSequenceRef.current = inputSequenceRef.current;
+    requestErrorRef.current = null;
+    setRequestError(null);
+    inFlightGenerationRef.current = null;
+    requestGenerationRef.current += 1;
+  }, [queryKey]);
+  (0, import_react.useEffect)(() => {
+    if (mode !== "scroll" || !enabled || typeof window === "undefined") return;
+    const attachable = containers.map(resolveContainer).filter((container) => container !== null);
+    const setIntent = (container) => {
+      const current = latestRef.current;
+      if (!isVisibleContainer(container) || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) return;
+      inputSequenceRef.current += 1;
+      intentRef.current = {
+        queryKey: latestRef.current.queryKey,
+        container,
+        startTop: container.scrollTop,
+        sequence: inputSequenceRef.current,
+        expiresAt: Date.now() + intentTimeoutMs
+      };
+    };
+    const handleScroll = (container) => {
+      const intent = intentRef.current;
+      const current = latestRef.current;
+      if (!intent || intent.queryKey !== current.queryKey || intent.container !== container || Date.now() > intent.expiresAt || container.scrollTop <= intent.startTop || intent.sequence <= consumedSequenceRef.current || !isVisibleContainer(container) || !isNearBottom(container, current.thresholdPx) || !current.hasNextPage || current.loading || current.isFetchingNextPage || current.error !== null || requestErrorRef.current !== null || inFlightGenerationRef.current !== null) {
+        return;
+      }
+      consumedSequenceRef.current = intent.sequence;
+      void requestNextPage();
+    };
+    const cleanups = attachable.map((container) => {
+      const onWheel = (event) => {
+        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) {
+          setIntent(container);
+        }
+      };
+      const onTouchStart = (event) => {
+        const touch = event.touches.item(0);
+        if (touch) container.dataset.matrxPaginationTouchY = String(touch.clientY);
+      };
+      const onTouchMove = (event) => {
+        const touch = event.touches.item(0);
+        const startY = Number(container.dataset.matrxPaginationTouchY);
+        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) {
+          setIntent(container);
+        }
+      };
+      const onTouchEnd = () => {
+        delete container.dataset.matrxPaginationTouchY;
+      };
+      const onKeyDown = (event) => {
+        if (isDownwardKeyboardInput(event)) setIntent(container);
+      };
+      const onPointerDown = (event) => {
+        if (isNativeScrollbarPointer(event, container)) setIntent(container);
+      };
+      const onScroll = () => handleScroll(container);
+      container.addEventListener("wheel", onWheel, { passive: true });
+      container.addEventListener("touchstart", onTouchStart, { passive: true });
+      container.addEventListener("touchmove", onTouchMove, { passive: true });
+      container.addEventListener("touchend", onTouchEnd, { passive: true });
+      container.addEventListener("touchcancel", onTouchEnd, { passive: true });
+      container.addEventListener("keydown", onKeyDown);
+      container.addEventListener("pointerdown", onPointerDown, { passive: true });
+      container.addEventListener("scroll", onScroll, { passive: true });
+      return () => {
+        delete container.dataset.matrxPaginationTouchY;
+        container.removeEventListener("wheel", onWheel);
+        container.removeEventListener("touchstart", onTouchStart);
+        container.removeEventListener("touchmove", onTouchMove);
+        container.removeEventListener("touchend", onTouchEnd);
+        container.removeEventListener("touchcancel", onTouchEnd);
+        container.removeEventListener("keydown", onKeyDown);
+        container.removeEventListener("pointerdown", onPointerDown);
+        container.removeEventListener("scroll", onScroll);
+      };
+    });
+    return () => cleanups.forEach((cleanup) => cleanup());
+  }, [containers, enabled, intentTimeoutMs, mode]);
+  return {
+    requestNextPage,
+    canLoadMore: enabled && !loading && !isFetchingNextPage && (hasNextPage || effectiveError !== null),
+    error: effectiveError
+  };
+}
+//# sourceMappingURL=scroll-pagination.cjs.map

package/dist/data-table/scroll-pagination.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-table/useScrollPagination.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\nexport type ScrollPaginationContainer =\n  | HTMLElement\n  | RefObject<HTMLElement | null>\n  | null;\n\nexport interface UseScrollPaginationOptions {\n  /** Every visible desktop/mobile scroll container that may present this table. */\n  containers: readonly ScrollPaginationContainer[];\n  /** Immutable identity of every source-affecting query value. */\n  queryKey: string;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  loading: boolean;\n  /** Automatic scrolling never retries a failed append. */\n  error: Error | null;\n  loadNextPage: () => Promise<void> | void;\n  /** Manual mode exposes the explicit request only; it installs no listeners. */\n  mode?: \"scroll\" | \"manual\";\n  /** Distance from the bottom at which a qualifying user scroll may append. */\n  thresholdPx?: number;\n  /** How long an input may authorize the following real scroll movement. */\n  intentTimeoutMs?: number;\n  enabled?: boolean;\n}\n\nexport interface UseScrollPaginationResult {\n  /** For the table's accessible Load more / Retry control. */\n  requestNextPage: () => Promise<void>;\n  canLoadMore: boolean;\n  /** Includes an unexpected loader rejection until the person explicitly retries. */\n  error: Error | null;\n}\n\ninterface ScrollIntent {\n  queryKey: string;\n  container: HTMLElement;\n  startTop: number;\n  sequence: number;\n  expiresAt: number;\n}\n\nconst DEFAULT_THRESHOLD_PX = 96;\nconst DEFAULT_INTENT_TIMEOUT_MS = 1_200;\n\nfunction resolveContainer(container: ScrollPaginationContainer): HTMLElement | null {\n  if (!container) return null;\n  return container instanceof HTMLElement ? container : container.current;\n}\n\nfunction isVisibleContainer(container: HTMLElement): boolean {\n  if (!container.isConnected) return false;\n  for (let node: HTMLElement | null = container; node; node = node.parentElement) {\n    const style = window.getComputedStyle(node);\n    if (style.display === \"none\" || style.visibility === \"hidden\") return false;\n  }\n  return true;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  return target.isContentEditable || Boolean(target.closest(\"input, textarea, select, [contenteditable='true']\"));\n}\n\nfunction isDownwardKeyboardInput(event: KeyboardEvent): boolean {\n  if (isEditableTarget(event.target)) return false;\n  return [\"ArrowDown\", \"PageDown\", \"End\", \" \", \"Spacebar\"].includes(event.key);\n}\n\nfunction isNearBottom(container: HTMLElement, thresholdPx: number): boolean {\n  return container.scrollHeight - container.clientHeight - container.scrollTop <= thresholdPx;\n}\n\nfunction isNativeScrollbarPointer(event: PointerEvent, container: HTMLElement): boolean {\n  // Overlay scrollbars expose no measurable gutter. Do not guess: Load more is\n  // the accessible, reliable fallback there. A content click must never grant\n  // permission for a later programmatic scroll to append rows.\n  if (event.pointerType !== \"mouse\" || event.button !== 0 || !event.isPrimary) return false;\n  const gutterWidth = container.offsetWidth - container.clientWidth;\n  if (gutterWidth <= 0 || container.scrollHeight <= container.clientHeight) return false;\n  const rect = container.getBoundingClientRect();\n  return event.clientX >= rect.right - gutterWidth && event.clientX <= rect.right;\n}\n\n/**\n * Gates automatic append behind a fresh, real downward user scroll. The hook\n * owns neither fetching nor row state: callers feed it the data hook receipt\n * and render its explicit request as the accessible fallback control.\n */\nexport function useScrollPagination({\n  containers,\n  queryKey,\n  hasNextPage,\n  isFetchingNextPage,\n  loading,\n  error,\n  loadNextPage,\n  mode = \"scroll\",\n  thresholdPx = DEFAULT_THRESHOLD_PX,\n  intentTimeoutMs = DEFAULT_INTENT_TIMEOUT_MS,\n  enabled = true,\n}: UseScrollPaginationOptions): UseScrollPaginationResult {\n  const [requestError, setRequestError] = useState<Error | null>(null);\n  const latestRef = useRef({\n    queryKey,\n    hasNextPage,\n    isFetchingNextPage,\n    loading,\n    error,\n    loadNextPage,\n    mode,\n    thresholdPx,\n    enabled,\n  });\n  latestRef.current = {\n    queryKey,\n    hasNextPage,\n    isFetchingNextPage,\n    loading,\n    error,\n    loadNextPage,\n    mode,\n    thresholdPx,\n    enabled,\n  };\n\n  const intentRef = useRef<ScrollIntent | null>(null);\n  const inputSequenceRef = useRef(0);\n  const consumedSequenceRef = useRef(0);\n  const requestGenerationRef = useRef(0);\n  const inFlightGenerationRef = useRef<number | null>(null);\n  const requestErrorRef = useRef<Error | null>(null);\n  const mountedRef = useRef(false);\n  const effectiveError = error ?? requestError;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const requestNextPage = async () => {\n    const current = latestRef.current;\n    if (\n      !current.enabled ||\n      (!current.hasNextPage && effectiveError === null) ||\n      current.loading ||\n      current.isFetchingNextPage ||\n      inFlightGenerationRef.current !== null\n    ) {\n      return;\n    }\n    const generation = ++requestGenerationRef.current;\n    inFlightGenerationRef.current = generation;\n    requestErrorRef.current = null;\n    setRequestError(null);\n    try {\n      await current.loadNextPage();\n    } catch (raw) {\n      const nextError = raw instanceof Error ? raw : new Error(String(raw));\n      if (inFlightGenerationRef.current === generation && latestRef.current.queryKey === current.queryKey) {\n        requestErrorRef.current = nextError;\n        if (mountedRef.current) setRequestError(nextError);\n      }\n    } finally {\n      if (inFlightGenerationRef.current === generation) {\n        inFlightGenerationRef.current = null;\n        intentRef.current = null;\n      }\n    }\n  };\n\n  useEffect(() => {\n    intentRef.current = null;\n    consumedSequenceRef.current = inputSequenceRef.current;\n    requestErrorRef.current = null;\n    setRequestError(null);\n    // A query change makes every existing completion stale. Its finally block\n    // cannot clear a new request because generations are monotonically unique.\n    inFlightGenerationRef.current = null;\n    requestGenerationRef.current += 1;\n  }, [queryKey]);\n\n  useEffect(() => {\n    if (mode !== \"scroll\" || !enabled || typeof window === \"undefined\") return;\n\n    const attachable = containers\n      .map(resolveContainer)\n      .filter((container): container is HTMLElement => container !== null);\n\n    const setIntent = (container: HTMLElement) => {\n      const current = latestRef.current;\n      if (!isVisibleContainer(container) || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) return;\n      inputSequenceRef.current += 1;\n      intentRef.current = {\n        queryKey: latestRef.current.queryKey,\n        container,\n        startTop: container.scrollTop,\n        sequence: inputSequenceRef.current,\n        expiresAt: Date.now() + intentTimeoutMs,\n      };\n    };\n\n    const handleScroll = (container: HTMLElement) => {\n      const intent = intentRef.current;\n      const current = latestRef.current;\n      if (\n        !intent ||\n        intent.queryKey !== current.queryKey ||\n        intent.container !== container ||\n        Date.now() > intent.expiresAt ||\n        container.scrollTop <= intent.startTop ||\n        intent.sequence <= consumedSequenceRef.current ||\n        !isVisibleContainer(container) ||\n        !isNearBottom(container, current.thresholdPx) ||\n        !current.hasNextPage ||\n        current.loading ||\n        current.isFetchingNextPage ||\n        current.error !== null ||\n        requestErrorRef.current !== null ||\n        inFlightGenerationRef.current !== null\n      ) {\n        return;\n      }\n      consumedSequenceRef.current = intent.sequence;\n      void requestNextPage();\n    };\n\n    const cleanups = attachable.map((container) => {\n      const onWheel = (event: WheelEvent) => {\n        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) {\n          setIntent(container);\n        }\n      };\n      const onTouchStart = (event: TouchEvent) => {\n        const touch = event.touches.item(0);\n        if (touch) container.dataset.matrxPaginationTouchY = String(touch.clientY);\n      };\n      const onTouchMove = (event: TouchEvent) => {\n        const touch = event.touches.item(0);\n        const startY = Number(container.dataset.matrxPaginationTouchY);\n        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) {\n          setIntent(container);\n        }\n      };\n      const onTouchEnd = () => {\n        delete container.dataset.matrxPaginationTouchY;\n      };\n      const onKeyDown = (event: KeyboardEvent) => {\n        if (isDownwardKeyboardInput(event)) setIntent(container);\n      };\n      const onPointerDown = (event: PointerEvent) => {\n        if (isNativeScrollbarPointer(event, container)) setIntent(container);\n      };\n      const onScroll = () => handleScroll(container);\n\n      container.addEventListener(\"wheel\", onWheel, { passive: true });\n      container.addEventListener(\"touchstart\", onTouchStart, { passive: true });\n      container.addEventListener(\"touchmove\", onTouchMove, { passive: true });\n      container.addEventListener(\"touchend\", onTouchEnd, { passive: true });\n      container.addEventListener(\"touchcancel\", onTouchEnd, { passive: true });\n      container.addEventListener(\"keydown\", onKeyDown);\n      container.addEventListener(\"pointerdown\", onPointerDown, { passive: true });\n      container.addEventListener(\"scroll\", onScroll, { passive: true });\n      return () => {\n        delete container.dataset.matrxPaginationTouchY;\n        container.removeEventListener(\"wheel\", onWheel);\n        container.removeEventListener(\"touchstart\", onTouchStart);\n        container.removeEventListener(\"touchmove\", onTouchMove);\n        container.removeEventListener(\"touchend\", onTouchEnd);\n        container.removeEventListener(\"touchcancel\", onTouchEnd);\n        container.removeEventListener(\"keydown\", onKeyDown);\n        container.removeEventListener(\"pointerdown\", onPointerDown);\n        container.removeEventListener(\"scroll\", onScroll);\n      };\n    });\n    return () => cleanups.forEach((cleanup) => cleanup());\n  }, [containers, enabled, intentTimeoutMs, mode]);\n\n  return {\n    requestNextPage,\n    canLoadMore: enabled && !loading && !isFetchingNextPage && (hasNextPage || effectiveError !== null),\n    error: effectiveError,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/scroll-pagination.d.cts

@@ -0,0 +1,37 @@
+import { RefObject } from 'react';
+
+type ScrollPaginationContainer = HTMLElement | RefObject<HTMLElement | null> | null;
+interface UseScrollPaginationOptions {
+    /** Every visible desktop/mobile scroll container that may present this table. */
+    containers: readonly ScrollPaginationContainer[];
+    /** Immutable identity of every source-affecting query value. */
+    queryKey: string;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    loading: boolean;
+    /** Automatic scrolling never retries a failed append. */
+    error: Error | null;
+    loadNextPage: () => Promise<void> | void;
+    /** Manual mode exposes the explicit request only; it installs no listeners. */
+    mode?: "scroll" | "manual";
+    /** Distance from the bottom at which a qualifying user scroll may append. */
+    thresholdPx?: number;
+    /** How long an input may authorize the following real scroll movement. */
+    intentTimeoutMs?: number;
+    enabled?: boolean;
+}
+interface UseScrollPaginationResult {
+    /** For the table's accessible Load more / Retry control. */
+    requestNextPage: () => Promise<void>;
+    canLoadMore: boolean;
+    /** Includes an unexpected loader rejection until the person explicitly retries. */
+    error: Error | null;
+}
+/**
+ * Gates automatic append behind a fresh, real downward user scroll. The hook
+ * owns neither fetching nor row state: callers feed it the data hook receipt
+ * and render its explicit request as the accessible fallback control.
+ */
+declare function useScrollPagination({ containers, queryKey, hasNextPage, isFetchingNextPage, loading, error, loadNextPage, mode, thresholdPx, intentTimeoutMs, enabled, }: UseScrollPaginationOptions): UseScrollPaginationResult;
+
+export { type ScrollPaginationContainer, type UseScrollPaginationOptions, type UseScrollPaginationResult, useScrollPagination };

package/dist/data-table/scroll-pagination.d.ts

@@ -0,0 +1,37 @@
+import { RefObject } from 'react';
+
+type ScrollPaginationContainer = HTMLElement | RefObject<HTMLElement | null> | null;
+interface UseScrollPaginationOptions {
+    /** Every visible desktop/mobile scroll container that may present this table. */
+    containers: readonly ScrollPaginationContainer[];
+    /** Immutable identity of every source-affecting query value. */
+    queryKey: string;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    loading: boolean;
+    /** Automatic scrolling never retries a failed append. */
+    error: Error | null;
+    loadNextPage: () => Promise<void> | void;
+    /** Manual mode exposes the explicit request only; it installs no listeners. */
+    mode?: "scroll" | "manual";
+    /** Distance from the bottom at which a qualifying user scroll may append. */
+    thresholdPx?: number;
+    /** How long an input may authorize the following real scroll movement. */
+    intentTimeoutMs?: number;
+    enabled?: boolean;
+}
+interface UseScrollPaginationResult {
+    /** For the table's accessible Load more / Retry control. */
+    requestNextPage: () => Promise<void>;
+    canLoadMore: boolean;
+    /** Includes an unexpected loader rejection until the person explicitly retries. */
+    error: Error | null;
+}
+/**
+ * Gates automatic append behind a fresh, real downward user scroll. The hook
+ * owns neither fetching nor row state: callers feed it the data hook receipt
+ * and render its explicit request as the accessible fallback control.
+ */
+declare function useScrollPagination({ containers, queryKey, hasNextPage, isFetchingNextPage, loading, error, loadNextPage, mode, thresholdPx, intentTimeoutMs, enabled, }: UseScrollPaginationOptions): UseScrollPaginationResult;
+
+export { type ScrollPaginationContainer, type UseScrollPaginationOptions, type UseScrollPaginationResult, useScrollPagination };

package/dist/data-table/scroll-pagination.js

@@ -0,0 +1,202 @@
+"use client";
+"use client";
+
+// src/data-table/useScrollPagination.ts
+import { useEffect, useRef, useState } from "react";
+var DEFAULT_THRESHOLD_PX = 96;
+var DEFAULT_INTENT_TIMEOUT_MS = 1200;
+function resolveContainer(container) {
+  if (!container) return null;
+  return container instanceof HTMLElement ? container : container.current;
+}
+function isVisibleContainer(container) {
+  if (!container.isConnected) return false;
+  for (let node = container; node; node = node.parentElement) {
+    const style = window.getComputedStyle(node);
+    if (style.display === "none" || style.visibility === "hidden") return false;
+  }
+  return true;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  return target.isContentEditable || Boolean(target.closest("input, textarea, select, [contenteditable='true']"));
+}
+function isDownwardKeyboardInput(event) {
+  if (isEditableTarget(event.target)) return false;
+  return ["ArrowDown", "PageDown", "End", " ", "Spacebar"].includes(event.key);
+}
+function isNearBottom(container, thresholdPx) {
+  return container.scrollHeight - container.clientHeight - container.scrollTop <= thresholdPx;
+}
+function isNativeScrollbarPointer(event, container) {
+  if (event.pointerType !== "mouse" || event.button !== 0 || !event.isPrimary) return false;
+  const gutterWidth = container.offsetWidth - container.clientWidth;
+  if (gutterWidth <= 0 || container.scrollHeight <= container.clientHeight) return false;
+  const rect = container.getBoundingClientRect();
+  return event.clientX >= rect.right - gutterWidth && event.clientX <= rect.right;
+}
+function useScrollPagination({
+  containers,
+  queryKey,
+  hasNextPage,
+  isFetchingNextPage,
+  loading,
+  error,
+  loadNextPage,
+  mode = "scroll",
+  thresholdPx = DEFAULT_THRESHOLD_PX,
+  intentTimeoutMs = DEFAULT_INTENT_TIMEOUT_MS,
+  enabled = true
+}) {
+  const [requestError, setRequestError] = useState(null);
+  const latestRef = useRef({
+    queryKey,
+    hasNextPage,
+    isFetchingNextPage,
+    loading,
+    error,
+    loadNextPage,
+    mode,
+    thresholdPx,
+    enabled
+  });
+  latestRef.current = {
+    queryKey,
+    hasNextPage,
+    isFetchingNextPage,
+    loading,
+    error,
+    loadNextPage,
+    mode,
+    thresholdPx,
+    enabled
+  };
+  const intentRef = useRef(null);
+  const inputSequenceRef = useRef(0);
+  const consumedSequenceRef = useRef(0);
+  const requestGenerationRef = useRef(0);
+  const inFlightGenerationRef = useRef(null);
+  const requestErrorRef = useRef(null);
+  const mountedRef = useRef(false);
+  const effectiveError = error ?? requestError;
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const requestNextPage = async () => {
+    const current = latestRef.current;
+    if (!current.enabled || !current.hasNextPage && effectiveError === null || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) {
+      return;
+    }
+    const generation = ++requestGenerationRef.current;
+    inFlightGenerationRef.current = generation;
+    requestErrorRef.current = null;
+    setRequestError(null);
+    try {
+      await current.loadNextPage();
+    } catch (raw) {
+      const nextError = raw instanceof Error ? raw : new Error(String(raw));
+      if (inFlightGenerationRef.current === generation && latestRef.current.queryKey === current.queryKey) {
+        requestErrorRef.current = nextError;
+        if (mountedRef.current) setRequestError(nextError);
+      }
+    } finally {
+      if (inFlightGenerationRef.current === generation) {
+        inFlightGenerationRef.current = null;
+        intentRef.current = null;
+      }
+    }
+  };
+  useEffect(() => {
+    intentRef.current = null;
+    consumedSequenceRef.current = inputSequenceRef.current;
+    requestErrorRef.current = null;
+    setRequestError(null);
+    inFlightGenerationRef.current = null;
+    requestGenerationRef.current += 1;
+  }, [queryKey]);
+  useEffect(() => {
+    if (mode !== "scroll" || !enabled || typeof window === "undefined") return;
+    const attachable = containers.map(resolveContainer).filter((container) => container !== null);
+    const setIntent = (container) => {
+      const current = latestRef.current;
+      if (!isVisibleContainer(container) || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) return;
+      inputSequenceRef.current += 1;
+      intentRef.current = {
+        queryKey: latestRef.current.queryKey,
+        container,
+        startTop: container.scrollTop,
+        sequence: inputSequenceRef.current,
+        expiresAt: Date.now() + intentTimeoutMs
+      };
+    };
+    const handleScroll = (container) => {
+      const intent = intentRef.current;
+      const current = latestRef.current;
+      if (!intent || intent.queryKey !== current.queryKey || intent.container !== container || Date.now() > intent.expiresAt || container.scrollTop <= intent.startTop || intent.sequence <= consumedSequenceRef.current || !isVisibleContainer(container) || !isNearBottom(container, current.thresholdPx) || !current.hasNextPage || current.loading || current.isFetchingNextPage || current.error !== null || requestErrorRef.current !== null || inFlightGenerationRef.current !== null) {
+        return;
+      }
+      consumedSequenceRef.current = intent.sequence;
+      void requestNextPage();
+    };
+    const cleanups = attachable.map((container) => {
+      const onWheel = (event) => {
+        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) {
+          setIntent(container);
+        }
+      };
+      const onTouchStart = (event) => {
+        const touch = event.touches.item(0);
+        if (touch) container.dataset.matrxPaginationTouchY = String(touch.clientY);
+      };
+      const onTouchMove = (event) => {
+        const touch = event.touches.item(0);
+        const startY = Number(container.dataset.matrxPaginationTouchY);
+        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) {
+          setIntent(container);
+        }
+      };
+      const onTouchEnd = () => {
+        delete container.dataset.matrxPaginationTouchY;
+      };
+      const onKeyDown = (event) => {
+        if (isDownwardKeyboardInput(event)) setIntent(container);
+      };
+      const onPointerDown = (event) => {
+        if (isNativeScrollbarPointer(event, container)) setIntent(container);
+      };
+      const onScroll = () => handleScroll(container);
+      container.addEventListener("wheel", onWheel, { passive: true });
+      container.addEventListener("touchstart", onTouchStart, { passive: true });
+      container.addEventListener("touchmove", onTouchMove, { passive: true });
+      container.addEventListener("touchend", onTouchEnd, { passive: true });
+      container.addEventListener("touchcancel", onTouchEnd, { passive: true });
+      container.addEventListener("keydown", onKeyDown);
+      container.addEventListener("pointerdown", onPointerDown, { passive: true });
+      container.addEventListener("scroll", onScroll, { passive: true });
+      return () => {
+        delete container.dataset.matrxPaginationTouchY;
+        container.removeEventListener("wheel", onWheel);
+        container.removeEventListener("touchstart", onTouchStart);
+        container.removeEventListener("touchmove", onTouchMove);
+        container.removeEventListener("touchend", onTouchEnd);
+        container.removeEventListener("touchcancel", onTouchEnd);
+        container.removeEventListener("keydown", onKeyDown);
+        container.removeEventListener("pointerdown", onPointerDown);
+        container.removeEventListener("scroll", onScroll);
+      };
+    });
+    return () => cleanups.forEach((cleanup) => cleanup());
+  }, [containers, enabled, intentTimeoutMs, mode]);
+  return {
+    requestNextPage,
+    canLoadMore: enabled && !loading && !isFetchingNextPage && (hasNextPage || effectiveError !== null),
+    error: effectiveError
+  };
+}
+export {
+  useScrollPagination
+};
+//# sourceMappingURL=scroll-pagination.js.map

package/dist/data-table/scroll-pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-table/useScrollPagination.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\nimport type { RefObject } from \"react\";\n\nexport type ScrollPaginationContainer =\n  | HTMLElement\n  | RefObject<HTMLElement | null>\n  | null;\n\nexport interface UseScrollPaginationOptions {\n  /** Every visible desktop/mobile scroll container that may present this table. */\n  containers: readonly ScrollPaginationContainer[];\n  /** Immutable identity of every source-affecting query value. */\n  queryKey: string;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  loading: boolean;\n  /** Automatic scrolling never retries a failed append. */\n  error: Error | null;\n  loadNextPage: () => Promise<void> | void;\n  /** Manual mode exposes the explicit request only; it installs no listeners. */\n  mode?: \"scroll\" | \"manual\";\n  /** Distance from the bottom at which a qualifying user scroll may append. */\n  thresholdPx?: number;\n  /** How long an input may authorize the following real scroll movement. */\n  intentTimeoutMs?: number;\n  enabled?: boolean;\n}\n\nexport interface UseScrollPaginationResult {\n  /** For the table's accessible Load more / Retry control. */\n  requestNextPage: () => Promise<void>;\n  canLoadMore: boolean;\n  /** Includes an unexpected loader rejection until the person explicitly retries. */\n  error: Error | null;\n}\n\ninterface ScrollIntent {\n  queryKey: string;\n  container: HTMLElement;\n  startTop: number;\n  sequence: number;\n  expiresAt: number;\n}\n\nconst DEFAULT_THRESHOLD_PX = 96;\nconst DEFAULT_INTENT_TIMEOUT_MS = 1_200;\n\nfunction resolveContainer(container: ScrollPaginationContainer): HTMLElement | null {\n  if (!container) return null;\n  return container instanceof HTMLElement ? container : container.current;\n}\n\nfunction isVisibleContainer(container: HTMLElement): boolean {\n  if (!container.isConnected) return false;\n  for (let node: HTMLElement | null = container; node; node = node.parentElement) {\n    const style = window.getComputedStyle(node);\n    if (style.display === \"none\" || style.visibility === \"hidden\") return false;\n  }\n  return true;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  return target.isContentEditable || Boolean(target.closest(\"input, textarea, select, [contenteditable='true']\"));\n}\n\nfunction isDownwardKeyboardInput(event: KeyboardEvent): boolean {\n  if (isEditableTarget(event.target)) return false;\n  return [\"ArrowDown\", \"PageDown\", \"End\", \" \", \"Spacebar\"].includes(event.key);\n}\n\nfunction isNearBottom(container: HTMLElement, thresholdPx: number): boolean {\n  return container.scrollHeight - container.clientHeight - container.scrollTop <= thresholdPx;\n}\n\nfunction isNativeScrollbarPointer(event: PointerEvent, container: HTMLElement): boolean {\n  // Overlay scrollbars expose no measurable gutter. Do not guess: Load more is\n  // the accessible, reliable fallback there. A content click must never grant\n  // permission for a later programmatic scroll to append rows.\n  if (event.pointerType !== \"mouse\" || event.button !== 0 || !event.isPrimary) return false;\n  const gutterWidth = container.offsetWidth - container.clientWidth;\n  if (gutterWidth <= 0 || container.scrollHeight <= container.clientHeight) return false;\n  const rect = container.getBoundingClientRect();\n  return event.clientX >= rect.right - gutterWidth && event.clientX <= rect.right;\n}\n\n/**\n * Gates automatic append behind a fresh, real downward user scroll. The hook\n * owns neither fetching nor row state: callers feed it the data hook receipt\n * and render its explicit request as the accessible fallback control.\n */\nexport function useScrollPagination({\n  containers,\n  queryKey,\n  hasNextPage,\n  isFetchingNextPage,\n  loading,\n  error,\n  loadNextPage,\n  mode = \"scroll\",\n  thresholdPx = DEFAULT_THRESHOLD_PX,\n  intentTimeoutMs = DEFAULT_INTENT_TIMEOUT_MS,\n  enabled = true,\n}: UseScrollPaginationOptions): UseScrollPaginationResult {\n  const [requestError, setRequestError] = useState<Error | null>(null);\n  const latestRef = useRef({\n    queryKey,\n    hasNextPage,\n    isFetchingNextPage,\n    loading,\n    error,\n    loadNextPage,\n    mode,\n    thresholdPx,\n    enabled,\n  });\n  latestRef.current = {\n    queryKey,\n    hasNextPage,\n    isFetchingNextPage,\n    loading,\n    error,\n    loadNextPage,\n    mode,\n    thresholdPx,\n    enabled,\n  };\n\n  const intentRef = useRef<ScrollIntent | null>(null);\n  const inputSequenceRef = useRef(0);\n  const consumedSequenceRef = useRef(0);\n  const requestGenerationRef = useRef(0);\n  const inFlightGenerationRef = useRef<number | null>(null);\n  const requestErrorRef = useRef<Error | null>(null);\n  const mountedRef = useRef(false);\n  const effectiveError = error ?? requestError;\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n    };\n  }, []);\n\n  const requestNextPage = async () => {\n    const current = latestRef.current;\n    if (\n      !current.enabled ||\n      (!current.hasNextPage && effectiveError === null) ||\n      current.loading ||\n      current.isFetchingNextPage ||\n      inFlightGenerationRef.current !== null\n    ) {\n      return;\n    }\n    const generation = ++requestGenerationRef.current;\n    inFlightGenerationRef.current = generation;\n    requestErrorRef.current = null;\n    setRequestError(null);\n    try {\n      await current.loadNextPage();\n    } catch (raw) {\n      const nextError = raw instanceof Error ? raw : new Error(String(raw));\n      if (inFlightGenerationRef.current === generation && latestRef.current.queryKey === current.queryKey) {\n        requestErrorRef.current = nextError;\n        if (mountedRef.current) setRequestError(nextError);\n      }\n    } finally {\n      if (inFlightGenerationRef.current === generation) {\n        inFlightGenerationRef.current = null;\n        intentRef.current = null;\n      }\n    }\n  };\n\n  useEffect(() => {\n    intentRef.current = null;\n    consumedSequenceRef.current = inputSequenceRef.current;\n    requestErrorRef.current = null;\n    setRequestError(null);\n    // A query change makes every existing completion stale. Its finally block\n    // cannot clear a new request because generations are monotonically unique.\n    inFlightGenerationRef.current = null;\n    requestGenerationRef.current += 1;\n  }, [queryKey]);\n\n  useEffect(() => {\n    if (mode !== \"scroll\" || !enabled || typeof window === \"undefined\") return;\n\n    const attachable = containers\n      .map(resolveContainer)\n      .filter((container): container is HTMLElement => container !== null);\n\n    const setIntent = (container: HTMLElement) => {\n      const current = latestRef.current;\n      if (!isVisibleContainer(container) || current.loading || current.isFetchingNextPage || inFlightGenerationRef.current !== null) return;\n      inputSequenceRef.current += 1;\n      intentRef.current = {\n        queryKey: latestRef.current.queryKey,\n        container,\n        startTop: container.scrollTop,\n        sequence: inputSequenceRef.current,\n        expiresAt: Date.now() + intentTimeoutMs,\n      };\n    };\n\n    const handleScroll = (container: HTMLElement) => {\n      const intent = intentRef.current;\n      const current = latestRef.current;\n      if (\n        !intent ||\n        intent.queryKey !== current.queryKey ||\n        intent.container !== container ||\n        Date.now() > intent.expiresAt ||\n        container.scrollTop <= intent.startTop ||\n        intent.sequence <= consumedSequenceRef.current ||\n        !isVisibleContainer(container) ||\n        !isNearBottom(container, current.thresholdPx) ||\n        !current.hasNextPage ||\n        current.loading ||\n        current.isFetchingNextPage ||\n        current.error !== null ||\n        requestErrorRef.current !== null ||\n        inFlightGenerationRef.current !== null\n      ) {\n        return;\n      }\n      consumedSequenceRef.current = intent.sequence;\n      void requestNextPage();\n    };\n\n    const cleanups = attachable.map((container) => {\n      const onWheel = (event: WheelEvent) => {\n        if (event.deltaY > 0 && Math.abs(event.deltaY) > Math.abs(event.deltaX)) {\n          setIntent(container);\n        }\n      };\n      const onTouchStart = (event: TouchEvent) => {\n        const touch = event.touches.item(0);\n        if (touch) container.dataset.matrxPaginationTouchY = String(touch.clientY);\n      };\n      const onTouchMove = (event: TouchEvent) => {\n        const touch = event.touches.item(0);\n        const startY = Number(container.dataset.matrxPaginationTouchY);\n        if (touch && Number.isFinite(startY) && startY - touch.clientY > 0) {\n          setIntent(container);\n        }\n      };\n      const onTouchEnd = () => {\n        delete container.dataset.matrxPaginationTouchY;\n      };\n      const onKeyDown = (event: KeyboardEvent) => {\n        if (isDownwardKeyboardInput(event)) setIntent(container);\n      };\n      const onPointerDown = (event: PointerEvent) => {\n        if (isNativeScrollbarPointer(event, container)) setIntent(container);\n      };\n      const onScroll = () => handleScroll(container);\n\n      container.addEventListener(\"wheel\", onWheel, { passive: true });\n      container.addEventListener(\"touchstart\", onTouchStart, { passive: true });\n      container.addEventListener(\"touchmove\", onTouchMove, { passive: true });\n      container.addEventListener(\"touchend\", onTouchEnd, { passive: true });\n      container.addEventListener(\"touchcancel\", onTouchEnd, { passive: true });\n      container.addEventListener(\"keydown\", onKeyDown);\n      container.addEventListener(\"pointerdown\", onPointerDown, { passive: true });\n      container.addEventListener(\"scroll\", onScroll, { passive: true });\n      return () => {\n        delete container.dataset.matrxPaginationTouchY;\n        container.removeEventListener(\"wheel\", onWheel);\n        container.removeEventListener(\"touchstart\", onTouchStart);\n        container.removeEventListener(\"touchmove\", onTouchMove);\n        container.removeEventListener(\"touchend\", onTouchEnd);\n        container.removeEventListener(\"touchcancel\", onTouchEnd);\n        container.removeEventListener(\"keydown\", onKeyDown);\n        container.removeEventListener(\"pointerdown\", onPointerDown);\n        container.removeEventListener(\"scroll\", onScroll);\n      };\n    });\n    return () => cleanups.forEach((cleanup) => cleanup());\n  }, [containers, enabled, intentTimeoutMs, mode]);\n\n  return {\n    requestNextPage,\n    canLoadMore: enabled && !loading && !isFetchingNextPage && (hasNextPage || effectiveError !== null),\n    error: effectiveError,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/data-table/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/data-table/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map