eidos-ui 4.1.1 → 4.2.0

package/dist/{chunk-GRKC4PIX.cjs.map → chunk-SHGRJX7B.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-GRKC4PIX.cjs","../src/components/PageLayout/useScrollRestoration.ts","../src/components/PageLayout/PageLayout.component.tsx"],"names":[],"mappings":"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","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-GRKC4PIX.cjs","sourcesContent":[null,"import { useCallback, useEffect, useLayoutEffect, useRef } from 'react';\n\n/**\n * Remembers the content region's scroll offset per key, and applies the\n * stored offset whenever the key changes.\n *\n * The key is supplied by the consumer rather than derived here, because only\n * they know what counts as a navigation - this library has no router opinion.\n * That also decides the semantics, exactly as React Router's `getKey` does:\n * a per-path key gives \"this path always reopens where you left it\", while a\n * per-history-entry key gives the browser's own behaviour, where Back\n * restores but a fresh link to the same URL starts at the top.\n *\n * Returns a ref callback for the scroll container, which also forwards the\n * node to the caller's own `contentRef`.\n */\nexport const useScrollRestoration = (\n  key: string | number | undefined,\n  forwardTo: React.Ref<HTMLElement> | undefined,\n): ((node: HTMLElement | null) => void) => {\n  const node = useRef<HTMLElement | null>(null);\n  const offsets = useRef(new Map<string | number, number>());\n  const appliedKey = useRef(key);\n\n  // Held in a ref so the ref callback below can keep a stable identity. A\n  // callback ref that changes identity is invoked with `null` and then the\n  // node again on every render that changes it, which would detach and\n  // reattach the caller's ref for no reason.\n  const forwarded = useRef(forwardTo);\n  useEffect(() => {\n    forwarded.current = forwardTo;\n  }, [forwardTo]);\n\n  // Recorded as it happens rather than when the key changes: by the time a\n  // navigation commits, the new page's content is already in the DOM and the\n  // browser has clamped `scrollTop` to the new, possibly shorter, height. The\n  // outgoing offset is no longer readable at that point.\n  //\n  // **The key is read from a ref, and the listener is registered once per\n  // node.** Both halves matter. A listener re-subscribed per key closes over\n  // the key it was created with, and restoring the incoming page's offset sets\n  // `scrollTop`, which makes the browser dispatch a `scroll` event - so the\n  // two race:\n  //\n  //   1. the layout effect below sets `scrollTop` for the incoming key\n  //   2. passive effects swap the listener from the outgoing key to it\n  //   3. the browser dispatches the scroll event from step 1\n  //\n  // React flushes passive effects through the scheduler and the browser\n  // dispatches `scroll` at its own rendering opportunity, so nothing orders 2\n  // before 3. When 3 won, the still-attached *outgoing* listener recorded the\n  // incoming page's offset under the outgoing page's key - overwriting a real\n  // offset with 0 and losing the position it exists to keep. It passed locally\n  // and failed in CI, which is what a race of this shape looks like.\n  //\n  // Reading `appliedKey` instead means whichever order those steps take, the\n  // offset is filed under the key that is actually on screen: the layout effect\n  // updates the ref before it touches `scrollTop`.\n  //\n  // **Attached in the ref callback, not in an effect.** It used to be a\n  // passive `useEffect`, which React runs some time *after* the commit - so a\n  // scroll landing in between was never recorded, and returning to that page\n  // restored 0. Storybook's production build starts a play function inside\n  // that window (the dev server happens not to), which is how\n  // `RestoresScrollPerKey` passed locally and failed on Chromatic, every time.\n  // A ref callback runs during the commit itself, so the listener exists from\n  // the moment the element does - and a swapped element is detached from and\n  // re-attached to rather than silently left unobserved.\n  const record = useCallback((event: Event) => {\n    const current = appliedKey.current;\n    const element = event.currentTarget as HTMLElement;\n    if (current !== undefined) offsets.current.set(current, element.scrollTop);\n  }, []);\n\n  const setNode = useCallback(\n    (element: HTMLElement | null) => {\n      node.current?.removeEventListener('scroll', record);\n      node.current = element;\n      element?.addEventListener('scroll', record, { passive: true });\n\n      const ref = forwarded.current;\n      if (typeof ref === 'function') ref(element);\n      else if (ref) (ref as React.RefObject<HTMLElement | null>).current = element;\n    },\n    [record],\n  );\n\n  // Layout effect so the offset is applied before paint - in a passive effect\n  // the new page is visible at the previous page's offset for a frame first.\n  // It does not run on the server, which is correct here: there is no scroll\n  // position to restore in static markup, and the client applies it on mount.\n  useLayoutEffect(() => {\n    const element = node.current;\n    if (!element || key === undefined || appliedKey.current === key) return;\n\n    appliedKey.current = key;\n    element.scrollTop = offsets.current.get(key) ?? 0;\n  }, [key]);\n\n  return setNode;\n};\n","import React from 'react';\nimport type { PageLayoutProps } from './PageLayout.types';\nimport './PageLayout.scss';\nimport { Toolbar } from '../Toolbar';\nimport { Header } from '../Header';\nimport { Footer } from '../Footer';\nimport type { FooterProps } from '../Footer';\nimport { Navigation } from '../Navigation';\nimport { useScrollRestoration } from './useScrollRestoration';\n\nconst defaultFooter: FooterProps = { copyright: `© ${new Date().getFullYear()} Eidos UI` };\n\nexport const PageLayout: React.FC<PageLayoutProps> = ({\n  toolbar,\n  navigation,\n  header,\n  footer,\n  children,\n  className = '',\n  // Destructured so they cannot fall into `...rest` and land on the root\n  // element, which is not the scroll container.\n  contentRef,\n  scrollRestorationKey,\n  ...rest\n}) => {\n  const classes = ['eidos-pagelayout', className].filter(Boolean).join(' ');\n  const setContentRef = useScrollRestoration(scrollRestorationKey, contentRef);\n\n  return (\n    <div className={classes} {...rest}>\n      {/* Spread rather than forwarded field by field, so a prop added to\n          `Toolbar` reaches `PageLayout` consumers without a second edit\n          here - the previous per-field list silently dropped anything it\n          didn't know about. `className` is merged last so the layout's own\n          grid-area class can't be overwritten by the caller's. */}\n      <Toolbar\n        {...toolbar}\n        className={['eidos-pagelayout__toolbar', toolbar?.className].filter(Boolean).join(' ')}\n      />\n      <div className=\"eidos-pagelayout__navigation\">\n        {navigation && <Navigation {...navigation} />}\n      </div>\n      {/* A scrollable region containing nothing focusable cannot be scrolled\n          by keyboard at all, and a page body is often pure content - a\n          report, an article. `tabIndex={0}` makes the region itself focusable\n          so arrow keys and Page Up/Down reach it (SC 2.1.1), matching\n          `VirtualList` and `Chat`. */}\n      <main ref={setContentRef} tabIndex={0} className=\"eidos-pagelayout__content\">\n        {header && (\n          <Header\n            {...header}\n            className={['eidos-pagelayout__header', header.className].filter(Boolean).join(' ')}\n          />\n        )}\n        <div className=\"eidos-pagelayout__body\">{children}</div>\n        <Footer\n          {...(footer ?? defaultFooter)}\n          className={['eidos-pagelayout__footer', footer?.className].filter(Boolean).join(' ')}\n        />\n      </main>\n    </div>\n  );\n};\n"]}
+{"version":3,"sources":["/home/runner/work/eidos-ui/eidos-ui/dist/chunk-SHGRJX7B.cjs","../src/components/PageLayout/useScrollRestoration.ts","../src/components/PageLayout/PageLayout.component.tsx"],"names":[],"mappings":"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","file":"/home/runner/work/eidos-ui/eidos-ui/dist/chunk-SHGRJX7B.cjs","sourcesContent":[null,"import { useCallback, useEffect, useLayoutEffect, useRef } from 'react';\n\n/**\n * Remembers the content region's scroll offset per key, and applies the\n * stored offset whenever the key changes.\n *\n * The key is supplied by the consumer rather than derived here, because only\n * they know what counts as a navigation - this library has no router opinion.\n * That also decides the semantics, exactly as React Router's `getKey` does:\n * a per-path key gives \"this path always reopens where you left it\", while a\n * per-history-entry key gives the browser's own behaviour, where Back\n * restores but a fresh link to the same URL starts at the top.\n *\n * Returns a ref callback for the scroll container, which also forwards the\n * node to the caller's own `contentRef`.\n */\nexport const useScrollRestoration = (\n  key: string | number | undefined,\n  forwardTo: React.Ref<HTMLElement> | undefined,\n): ((node: HTMLElement | null) => void) => {\n  const node = useRef<HTMLElement | null>(null);\n  const offsets = useRef(new Map<string | number, number>());\n  const appliedKey = useRef(key);\n\n  // Held in a ref so the ref callback below can keep a stable identity. A\n  // callback ref that changes identity is invoked with `null` and then the\n  // node again on every render that changes it, which would detach and\n  // reattach the caller's ref for no reason.\n  const forwarded = useRef(forwardTo);\n  useEffect(() => {\n    forwarded.current = forwardTo;\n  }, [forwardTo]);\n\n  // Recorded as it happens rather than when the key changes: by the time a\n  // navigation commits, the new page's content is already in the DOM and the\n  // browser has clamped `scrollTop` to the new, possibly shorter, height. The\n  // outgoing offset is no longer readable at that point.\n  //\n  // **The key is read from a ref, and the listener is registered once per\n  // node.** Both halves matter. A listener re-subscribed per key closes over\n  // the key it was created with, and restoring the incoming page's offset sets\n  // `scrollTop`, which makes the browser dispatch a `scroll` event - so the\n  // two race:\n  //\n  //   1. the layout effect below sets `scrollTop` for the incoming key\n  //   2. passive effects swap the listener from the outgoing key to it\n  //   3. the browser dispatches the scroll event from step 1\n  //\n  // React flushes passive effects through the scheduler and the browser\n  // dispatches `scroll` at its own rendering opportunity, so nothing orders 2\n  // before 3. When 3 won, the still-attached *outgoing* listener recorded the\n  // incoming page's offset under the outgoing page's key - overwriting a real\n  // offset with 0 and losing the position it exists to keep. It passed locally\n  // and failed in CI, which is what a race of this shape looks like.\n  //\n  // Reading `appliedKey` instead means whichever order those steps take, the\n  // offset is filed under the key that is actually on screen: the layout effect\n  // updates the ref before it touches `scrollTop`.\n  //\n  // **Attached in the ref callback, not in an effect.** It used to be a\n  // passive `useEffect`, which React runs some time *after* the commit - so a\n  // scroll landing in between was never recorded, and returning to that page\n  // restored 0. Storybook's production build starts a play function inside\n  // that window (the dev server happens not to), which is how\n  // `RestoresScrollPerKey` passed locally and failed on Chromatic, every time.\n  // A ref callback runs during the commit itself, so the listener exists from\n  // the moment the element does - and a swapped element is detached from and\n  // re-attached to rather than silently left unobserved.\n  const record = useCallback((event: Event) => {\n    const current = appliedKey.current;\n    const element = event.currentTarget as HTMLElement;\n    if (current !== undefined) offsets.current.set(current, element.scrollTop);\n  }, []);\n\n  const setNode = useCallback(\n    (element: HTMLElement | null) => {\n      node.current?.removeEventListener('scroll', record);\n      node.current = element;\n      element?.addEventListener('scroll', record, { passive: true });\n\n      const ref = forwarded.current;\n      if (typeof ref === 'function') ref(element);\n      else if (ref) (ref as React.RefObject<HTMLElement | null>).current = element;\n    },\n    [record],\n  );\n\n  // Layout effect so the offset is applied before paint - in a passive effect\n  // the new page is visible at the previous page's offset for a frame first.\n  // It does not run on the server, which is correct here: there is no scroll\n  // position to restore in static markup, and the client applies it on mount.\n  useLayoutEffect(() => {\n    const element = node.current;\n    if (!element || key === undefined || appliedKey.current === key) return;\n\n    appliedKey.current = key;\n    element.scrollTop = offsets.current.get(key) ?? 0;\n  }, [key]);\n\n  return setNode;\n};\n","import React from 'react';\nimport type { PageLayoutProps } from './PageLayout.types';\nimport './PageLayout.scss';\nimport { Toolbar } from '../Toolbar';\nimport { Header } from '../Header';\nimport { Footer } from '../Footer';\nimport type { FooterProps } from '../Footer';\nimport { Navigation } from '../Navigation';\nimport { useScrollRestoration } from './useScrollRestoration';\n\nconst defaultFooter: FooterProps = { copyright: `© ${new Date().getFullYear()} Eidos UI` };\n\nexport const PageLayout: React.FC<PageLayoutProps> = ({\n  toolbar,\n  navigation,\n  header,\n  footer,\n  children,\n  className = '',\n  // Destructured so they cannot fall into `...rest` and land on the root\n  // element, which is not the scroll container.\n  contentRef,\n  scrollRestorationKey,\n  ...rest\n}) => {\n  const classes = ['eidos-pagelayout', className].filter(Boolean).join(' ');\n  const setContentRef = useScrollRestoration(scrollRestorationKey, contentRef);\n\n  return (\n    <div className={classes} {...rest}>\n      {/* Spread rather than forwarded field by field, so a prop added to\n          `Toolbar` reaches `PageLayout` consumers without a second edit\n          here - the previous per-field list silently dropped anything it\n          didn't know about. `className` is merged last so the layout's own\n          grid-area class can't be overwritten by the caller's. */}\n      <Toolbar\n        {...toolbar}\n        className={['eidos-pagelayout__toolbar', toolbar?.className].filter(Boolean).join(' ')}\n      />\n      <div className=\"eidos-pagelayout__navigation\">\n        {navigation && <Navigation {...navigation} />}\n      </div>\n      {/* A scrollable region containing nothing focusable cannot be scrolled\n          by keyboard at all, and a page body is often pure content - a\n          report, an article. `tabIndex={0}` makes the region itself focusable\n          so arrow keys and Page Up/Down reach it (SC 2.1.1), matching\n          `VirtualList` and `Chat`. */}\n      <main ref={setContentRef} tabIndex={0} className=\"eidos-pagelayout__content\">\n        {header && (\n          <Header\n            {...header}\n            className={['eidos-pagelayout__header', header.className].filter(Boolean).join(' ')}\n          />\n        )}\n        <div className=\"eidos-pagelayout__body\">{children}</div>\n        <Footer\n          {...(footer ?? defaultFooter)}\n          className={['eidos-pagelayout__footer', footer?.className].filter(Boolean).join(' ')}\n        />\n      </main>\n    </div>\n  );\n};\n"]}

package/dist/{chunk-VGMRIXW4.cjs → chunk-STVAB7FD.cjs}

@@ -11,25 +11,25 @@
 
 
 
-var _chunk7VMF6LICcjs = require('./chunk-7VMF6LIC.cjs');
+var _chunkTUNG4IDWcjs = require('./chunk-TUNG4IDW.cjs');
 
 
 var _chunkE7BFBU6Kcjs = require('./chunk-E7BFBU6K.cjs');
 
 
-var _chunkSJKD3WCVcjs = require('./chunk-SJKD3WCV.cjs');
+var _chunkS3IZPWYPcjs = require('./chunk-S3IZPWYP.cjs');
 
 
-var _chunk6JYXGRJ3cjs = require('./chunk-6JYXGRJ3.cjs');
+var _chunkEAUTJAKVcjs = require('./chunk-EAUTJAKV.cjs');
 
 
-var _chunkBKUZF7CWcjs = require('./chunk-BKUZF7CW.cjs');
+var _chunkVY7DTPO3cjs = require('./chunk-VY7DTPO3.cjs');
 
 
 var _chunkYJNQLH2Lcjs = require('./chunk-YJNQLH2L.cjs');
 
 
-var _chunkHKLLKNRQcjs = require('./chunk-HKLLKNRQ.cjs');
+var _chunkEM4WYYFNcjs = require('./chunk-EM4WYYFN.cjs');
 
 
 var _chunkKF2OGUADcjs = require('./chunk-KF2OGUAD.cjs');
@@ -41,10 +41,10 @@ var _chunkTROYIUDHcjs = require('./chunk-TROYIUDH.cjs');
 var _chunkKV3V2CPHcjs = require('./chunk-KV3V2CPH.cjs');
 
 
-var _chunkVPN7AR7Tcjs = require('./chunk-VPN7AR7T.cjs');
+var _chunkUSGEUG2Ocjs = require('./chunk-USGEUG2O.cjs');
 
 
-var _chunkMKQVDEHIcjs = require('./chunk-MKQVDEHI.cjs');
+var _chunkCPRNLW4Mcjs = require('./chunk-CPRNLW4M.cjs');
 
 
 var _chunkNSA7ASZ7cjs = require('./chunk-NSA7ASZ7.cjs');
@@ -91,7 +91,7 @@ function SortableTableRow({
   className,
   children
 }) {
-  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = _chunk7VMF6LICcjs.useSortable.call(void 0, {
+  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = _chunkTUNG4IDWcjs.useSortable.call(void 0, {
     id,
     disabled
   });
@@ -101,7 +101,7 @@ function SortableTableRow({
       ref: setNodeRef,
       className: [className, isDragging ? "eidos-datagrid-row--dragging" : ""].filter(Boolean).join(" "),
       style: {
-        transform: _chunk7VMF6LICcjs.CSS.Transform.toString(transform),
+        transform: _chunkTUNG4IDWcjs.CSS.Transform.toString(transform),
         transition: _nullishCoalesce(transition, () => ( void 0)),
         opacity: isDragging ? 0.4 : 1
       },
@@ -817,9 +817,9 @@ function DataGridInner({
     },
     [onPageChange]
   );
-  const sensors = _chunk7VMF6LICcjs.useSensors.call(void 0, 
-    _chunk7VMF6LICcjs.useSensor.call(void 0, _chunk7VMF6LICcjs.PointerSensor, { activationConstraint: { distance: 5 } }),
-    _chunk7VMF6LICcjs.useSensor.call(void 0, _chunk7VMF6LICcjs.KeyboardSensor)
+  const sensors = _chunkTUNG4IDWcjs.useSensors.call(void 0, 
+    _chunkTUNG4IDWcjs.useSensor.call(void 0, _chunkTUNG4IDWcjs.PointerSensor, { activationConstraint: { distance: 5 } }),
+    _chunkTUNG4IDWcjs.useSensor.call(void 0, _chunkTUNG4IDWcjs.KeyboardSensor)
   );
   const handleRowDragEnd = _react.useCallback.call(void 0, 
     (event) => {
@@ -833,7 +833,7 @@ function DataGridInner({
         (row, i) => String(_nullishCoalesce(cellOf(row, rowKeyField), () => ( i))) === String(over.id)
       );
       if (oldIndex === -1 || newIndex === -1) return;
-      const newData = _chunk7VMF6LICcjs.arrayMove.call(void 0, localDataRef.current, oldIndex, newIndex);
+      const newData = _chunkTUNG4IDWcjs.arrayMove.call(void 0, localDataRef.current, oldIndex, newIndex);
       setLocalData(newData);
       _optionalChain([onChange, 'optionalCall', _23 => _23(newData)]);
       _optionalChain([onRowReorder, 'optionalCall', _24 => _24(newData)]);
@@ -910,7 +910,7 @@ function DataGridInner({
           label: o.label
         }));
         return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkBKUZF7CWcjs.Select,
+          _chunkVY7DTPO3cjs.Select,
           {
             options: selectOptions,
             value: String(_nullishCoalesce(value, () => ( ""))),
@@ -1006,7 +1006,7 @@ function DataGridInner({
     });
     if (!items.length) return null;
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkVPN7AR7Tcjs.Menu,
+      _chunkUSGEUG2Ocjs.Menu,
       {
         trigger: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "button", { type: "button", className: "eidos-datagrid-actions-trigger", "aria-label": "Row actions", children: actionsColumn.actionsIcon ? _chunkR5WI5IGRcjs.renderIcon.call(void 0, actionsColumn.actionsIcon, "eidos-datagrid-actions-trigger-icon") : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.MoreVertical, { size: 16 }) }),
         items
@@ -1055,7 +1055,7 @@ function DataGridInner({
           );
         case "combobox":
           return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkHKLLKNRQcjs.Combobox,
+            _chunkEM4WYYFNcjs.Combobox,
             {
               size: "sm",
               fullWidth: true,
@@ -1077,7 +1077,7 @@ function DataGridInner({
         case "select":
         default:
           return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkBKUZF7CWcjs.Select,
+            _chunkVY7DTPO3cjs.Select,
             {
               fullWidth: true,
               inputProps: { size: "sm", "aria-label": label },
@@ -1185,7 +1185,7 @@ function DataGridInner({
                 const isDisabled = typeof action.disabled === "function" ? action.disabled(selectedItems) : _nullishCoalesce(action.disabled, () => ( false));
                 if (action.type === "split-button") {
                   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                    _chunkSJKD3WCVcjs.SplitButton,
+                    _chunkS3IZPWYPcjs.SplitButton,
                     {
                       size: "sm",
                       variant: _nullishCoalesce(action.variant, () => ( "outlined")),
@@ -1235,7 +1235,7 @@ function DataGridInner({
           ] }),
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "eidos-datagrid-toolbar-right", children: [
             showDensity && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-              _chunkMKQVDEHIcjs.Dropdown,
+              _chunkCPRNLW4Mcjs.Dropdown,
               {
                 placement: "bottom",
                 align: "end",
@@ -1263,7 +1263,7 @@ function DataGridInner({
               }
             ),
             showFilters && filterDropdownColumns.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-              _chunk7VMF6LICcjs.TableFiltersDropdown,
+              _chunkTUNG4IDWcjs.TableFiltersDropdown,
               {
                 columns: filterDropdownColumns,
                 filters: dropdownFilters,
@@ -1389,10 +1389,10 @@ function DataGridInner({
             }
           )
         ) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsxruntime.Fragment, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunk7VMF6LICcjs.DndContext,
+          _chunkTUNG4IDWcjs.DndContext,
           {
             sensors,
-            collisionDetection: _chunk7VMF6LICcjs.closestCenter,
+            collisionDetection: _chunkTUNG4IDWcjs.closestCenter,
             onDragEnd: handleRowDragEnd,
             children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-data-grid-scroll", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "table", { className: ["eidos-data-grid", densityClass].filter(Boolean).join(" "), children: [
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "thead", { ref: theadRef, children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "tr", { children: [
@@ -1499,7 +1499,7 @@ function DataGridInner({
                   }
                 )
               ] }) }),
-              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "tbody", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7VMF6LICcjs.SortableContext, { items: rowIds, strategy: _chunk7VMF6LICcjs.verticalListSortingStrategy, children: displayData.length > 0 ? displayData.map((row, displayIndex) => {
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "tbody", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkTUNG4IDWcjs.SortableContext, { items: rowIds, strategy: _chunkTUNG4IDWcjs.verticalListSortingStrategy, children: displayData.length > 0 ? displayData.map((row, displayIndex) => {
                 const localIndex = localData.indexOf(row);
                 const rowKeyValue = String(_nullishCoalesce(cellOf(row, rowKeyField), () => ( displayIndex)));
                 const isRowSelected = selectable && selectedSet.has(rowKeyValue);
@@ -1694,7 +1694,7 @@ function DataGridInner({
           }
         ) }),
         showPagination && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "eidos-datagrid-footer", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunk6JYXGRJ3cjs.Pagination,
+          _chunkEAUTJAKVcjs.Pagination,
           {
             page: currentPage,
             totalPages,
@@ -1725,4 +1725,4 @@ var DataGrid = Object.assign(DataGridInner, { displayName: "DataGrid" });
 
 
 exports.DataGrid = DataGrid;
-//# sourceMappingURL=chunk-VGMRIXW4.cjs.map
+//# sourceMappingURL=chunk-STVAB7FD.cjs.map