@elliemae/ds-fast-list 3.80.0-next.4 → 3.80.0-next.41

package/dist/cjs/FastList.js

@@ -37,9 +37,9 @@ var import_jsx_runtime = require("react/jsx-runtime");
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
 var import_List = require("./parts/List.js");
 var import_react_desc_prop_types = require("./react-desc-prop-types.js");
-var import_DSFastListDefinitions = require("./DSFastListDefinitions.js");
+var import_constants = require("./constants/index.js");
 const DSFastList = (props) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_List.List, { ...props });
-DSFastList.displayName = import_DSFastListDefinitions.DSFastListName;
+DSFastList.displayName = import_constants.DSFastListName;
 const DSFastListWithSchema = (0, import_ds_props_helpers.describe)(DSFastList).description("DSFastList");
 DSFastListWithSchema.propTypes = import_react_desc_prop_types.DSFastListPropTypes;
 //# sourceMappingURL=FastList.js.map

package/dist/cjs/FastList.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/FastList.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { List } from './parts/List.js';\nimport { DSFastListPropTypes, type DSFastListT } from './react-desc-prop-types.js';\nimport { DSFastListName } from './DSFastListDefinitions.js';\n\n// we create ds-fast-list to solve the issue with the children prop in ds-virtual-list\n// this packages use render props instead of children prop.\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSFastList = <T extends object>(props: DSFastListT.Props<T>) => <List {...props} />;\n\nDSFastList.displayName = DSFastListName;\nconst DSFastListWithSchema = describe(DSFastList).description('DSFastList');\nDSFastListWithSchema.propTypes = DSFastListPropTypes;\n\nexport { DSFastList, DSFastListWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADS+C;AARtE,8BAAyB;AACzB,kBAAqB;AACrB,mCAAsD;AACtD,mCAA+B;AAK/B,MAAM,aAAa,CAAmB,UAAgC,4CAAC,oBAAM,GAAG,OAAO;AAEvF,WAAW,cAAc;AACzB,MAAM,2BAAuB,kCAAS,UAAU,EAAE,YAAY,YAAY;AAC1E,qBAAqB,YAAY;",
+  "sourcesContent": ["import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { List } from './parts/List.js';\nimport { DSFastListPropTypes, type DSFastListT } from './react-desc-prop-types.js';\nimport { DSFastListName } from './constants/index.js';\n\n// we create ds-fast-list to solve the issue with the children prop in ds-virtual-list\n// this packages use render props instead of children prop.\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSFastList = <T extends object>(props: DSFastListT.Props<T>) => <List {...props} />;\n\nDSFastList.displayName = DSFastListName;\nconst DSFastListWithSchema = describe(DSFastList).description('DSFastList');\nDSFastListWithSchema.propTypes = DSFastListPropTypes;\n\nexport { DSFastList, DSFastListWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADS+C;AARtE,8BAAyB;AACzB,kBAAqB;AACrB,mCAAsD;AACtD,uBAA+B;AAK/B,MAAM,aAAa,CAAmB,UAAgC,4CAAC,oBAAM,GAAG,OAAO;AAEvF,WAAW,cAAc;AACzB,MAAM,2BAAuB,kCAAS,UAAU,EAAE,YAAY,YAAY;AAC1E,qBAAqB,YAAY;",
   "names": []
 }

package/dist/cjs/{DSFastListDefinitions.js → constants/index.js}

@@ -26,20 +26,21 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var DSFastListDefinitions_exports = {};
-__export(DSFastListDefinitions_exports, {
-  DSCardV3DataTestIds: () => DSCardV3DataTestIds,
+var constants_exports = {};
+__export(constants_exports, {
+  DSFastListDataTestIds: () => DSFastListDataTestIds,
   DSFastListName: () => DSFastListName,
   DSFastListSlots: () => DSFastListSlots
 });
-module.exports = __toCommonJS(DSFastListDefinitions_exports);
+module.exports = __toCommonJS(constants_exports);
 var React = __toESM(require("react"));
 var import_ds_system = require("@elliemae/ds-system");
 const DSFastListName = "DSFastlist";
 const DSFastListSlots = {
   CONTAINER: "container",
   WRAPPER_LIST: "wrapper-list",
-  ITEM: "item"
+  ITEM: "item",
+  EXTRA_CONTENT: "extra-content"
 };
-const DSCardV3DataTestIds = (0, import_ds_system.slotObjectToDataTestIds)(DSFastListName, DSFastListSlots);
-//# sourceMappingURL=DSFastListDefinitions.js.map
+const DSFastListDataTestIds = (0, import_ds_system.slotObjectToDataTestIds)(DSFastListName, DSFastListSlots);
+//# sourceMappingURL=index.js.map

package/dist/cjs/constants/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/constants/index.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { slotObjectToDataTestIds } from '@elliemae/ds-system';\n\nexport const DSFastListName = 'DSFastlist';\n\nexport const DSFastListSlots = {\n  CONTAINER: 'container',\n  WRAPPER_LIST: 'wrapper-list',\n  ITEM: 'item',\n  EXTRA_CONTENT: 'extra-content',\n} as const;\n\nexport const DSFastListDataTestIds = slotObjectToDataTestIds(DSFastListName, DSFastListSlots);\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAwC;AAEjC,MAAM,iBAAiB;AAEvB,MAAM,kBAAkB;AAAA,EAC7B,WAAW;AAAA,EACX,cAAc;AAAA,EACd,MAAM;AAAA,EACN,eAAe;AACjB;AAEO,MAAM,4BAAwB,0CAAwB,gBAAgB,eAAe;",
+  "names": []
+}

package/dist/cjs/hooks/useFastList.js

@@ -36,6 +36,7 @@ var import_react = __toESM(require("react"));
 var import_uid = require("uid");
 var import_react_virtual = require("@tanstack/react-virtual");
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
+var import_ds_system = require("@elliemae/ds-system");
 var import_react_desc_prop_types = require("../react-desc-prop-types.js");
 var import_useValidateProps = require("./useValidateProps.js");
 const useFastList = (propsFromUser) => {
@@ -44,26 +45,54 @@ const useFastList = (propsFromUser) => {
     import_react_desc_prop_types.defaultProps
   );
   (0, import_useValidateProps.useValidateProps)(propsWithDefault, import_react_desc_prop_types.DSFastListPropTypes);
-  const { actionRef, count, estimateSize } = propsWithDefault;
+  const { actionRef, count, estimateSize, paddingStart, paddingEnd, innerRef, remountOnCountChange } = propsWithDefault;
   const parentRef = import_react.default.useRef(null);
+  const containerRef = import_react.default.useMemo(
+    () => innerRef ? (0, import_ds_system.setMultipleRefs)([parentRef, innerRef]) : parentRef,
+    [innerRef]
+  );
   const useVirtualHelpers = (0, import_react_virtual.useVirtualizer)({
     count,
     getScrollElement: () => parentRef.current,
     overscan: 15,
-    estimateSize
+    estimateSize,
+    paddingStart,
+    paddingEnd
   });
   const totalSize = useVirtualHelpers.getTotalSize();
-  if (actionRef && actionRef.current) actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;
-  const instanceUid = import_react.default.useMemo(() => `ds-fast-list-${(0, import_uid.uid)(6)}${count}`, [count]);
+  if (actionRef && actionRef.current) {
+    actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;
+    actionRef.current.measure = useVirtualHelpers.measure;
+    actionRef.current.getVisibleItems = () => {
+      const range = useVirtualHelpers.calculateRange();
+      if (!range) return [];
+      const viewportStart = useVirtualHelpers.scrollOffset ?? 0;
+      const viewportEnd = viewportStart + (useVirtualHelpers.scrollRect?.height ?? 0);
+      const indices = [];
+      for (let index = range.startIndex; index <= range.endIndex; index += 1) {
+        const item = useVirtualHelpers.measurementsCache[index];
+        if (item && item.end > viewportStart && item.start < viewportEnd) indices.push(index);
+      }
+      return indices;
+    };
+    actionRef.current.getMountedItems = () => useVirtualHelpers.getVirtualItems().map((item) => item.index);
+    actionRef.current.getOffsetForIndex = (index, align) => useVirtualHelpers.getOffsetForIndex(index, align)?.[0];
+    actionRef.current.scrollToOffset = useVirtualHelpers.scrollToOffset;
+  }
+  const stableUid = import_react.default.useMemo(() => (0, import_uid.uid)(6), []);
+  const instanceUid = import_react.default.useMemo(
+    () => remountOnCountChange === false ? `ds-fast-list-${stableUid}` : `ds-fast-list-${(0, import_uid.uid)(6)}${count}`,
+    [count, remountOnCountChange, stableUid]
+  );
   return import_react.default.useMemo(
     () => ({
       instanceUid,
-      parentRef,
+      containerRef,
       getVirtualItems: useVirtualHelpers.getVirtualItems,
       totalSize,
       measureElement: useVirtualHelpers.measureElement
     }),
-    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid]
+    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid, containerRef]
   );
 };
 //# sourceMappingURL=useFastList.js.map

package/dist/cjs/hooks/useFastList.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/useFastList.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import React from 'react';\nimport { uid } from 'uid';\nimport { useVirtualizer, type Virtualizer } from '@tanstack/react-virtual';\nimport { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { type DSFastListT, DSFastListPropTypes, defaultProps } from '../react-desc-prop-types.js';\nimport { useValidateProps } from './useValidateProps.js';\n\nexport type FastListCTX = {\n  instanceUid: string;\n  parentRef: React.MutableRefObject<HTMLDivElement | null>;\n  getVirtualItems: Virtualizer<HTMLDivElement, HTMLElement>['getVirtualItems'];\n  totalSize: ReturnType<Virtualizer<HTMLDivElement, HTMLElement>['getTotalSize']>;\n  measureElement: Virtualizer<HTMLDivElement, HTMLElement>['measureElement'];\n};\nexport const useFastList = <T,>(propsFromUser: DSFastListT.Props<T>): FastListCTX => {\n  // =============================================================================\n  // MERGE WITH DEFAULT AND VALIDATE PROPS\n  // =============================================================================\n  const propsWithDefault = useMemoMergePropsWithDefault<DSFastListT.InternalProps<T>>(\n    propsFromUser,\n    defaultProps as Partial<DSFastListT.InternalProps<T>>,\n  );\n  useValidateProps(propsWithDefault, DSFastListPropTypes);\n  // =============================================================================\n  // AD HOC PER COMPONENT LOGIC\n  // =============================================================================\n  const { actionRef, count, estimateSize } = propsWithDefault;\n  const parentRef = React.useRef<HTMLDivElement>(null);\n  const useVirtualHelpers = useVirtualizer({\n    count,\n    getScrollElement: () => parentRef.current,\n    overscan: 15,\n    estimateSize,\n  });\n  const totalSize = useVirtualHelpers.getTotalSize();\n\n  if (actionRef && actionRef.current) actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;\n\n  const instanceUid = React.useMemo(() => `ds-fast-list-${uid(6)}${count}`, [count]);\n  return React.useMemo(\n    () => ({\n      instanceUid,\n      parentRef,\n      getVirtualItems: useVirtualHelpers.getVirtualItems,\n      totalSize,\n      measureElement: useVirtualHelpers.measureElement,\n    }),\n    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAkB;AAClB,iBAAoB;AACpB,2BAAiD;AACjD,8BAA6C;AAC7C,mCAAoE;AACpE,8BAAiC;AAS1B,MAAM,cAAc,CAAK,kBAAqD;AAInF,QAAM,uBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACA,gDAAiB,kBAAkB,gDAAmB;AAItD,QAAM,EAAE,WAAW,OAAO,aAAa,IAAI;AAC3C,QAAM,YAAY,aAAAA,QAAM,OAAuB,IAAI;AACnD,QAAM,wBAAoB,qCAAe;AAAA,IACvC;AAAA,IACA,kBAAkB,MAAM,UAAU;AAAA,IAClC,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACD,QAAM,YAAY,kBAAkB,aAAa;AAEjD,MAAI,aAAa,UAAU,QAAS,WAAU,QAAQ,WAAW,kBAAkB;AAEnF,QAAM,cAAc,aAAAA,QAAM,QAAQ,MAAM,oBAAgB,gBAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC;AACjF,SAAO,aAAAA,QAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,iBAAiB,kBAAkB;AAAA,MACnC;AAAA,MACA,gBAAgB,kBAAkB;AAAA,IACpC;AAAA,IACA,CAAC,kBAAkB,iBAAiB,kBAAkB,gBAAgB,WAAW,WAAW;AAAA,EAC9F;AACF;",
+  "sourcesContent": ["import React from 'react';\nimport { uid } from 'uid';\nimport { useVirtualizer, type Virtualizer } from '@tanstack/react-virtual';\nimport { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { setMultipleRefs } from '@elliemae/ds-system';\nimport { type DSFastListT, DSFastListPropTypes, defaultProps } from '../react-desc-prop-types.js';\nimport { useValidateProps } from './useValidateProps.js';\n\nexport type FastListCTX = {\n  instanceUid: string;\n  containerRef: React.MutableRefObject<HTMLDivElement | null> | React.RefCallback<HTMLDivElement>;\n  getVirtualItems: Virtualizer<HTMLDivElement, HTMLElement>['getVirtualItems'];\n  totalSize: ReturnType<Virtualizer<HTMLDivElement, HTMLElement>['getTotalSize']>;\n  measureElement: Virtualizer<HTMLDivElement, HTMLElement>['measureElement'];\n};\nexport const useFastList = <T,>(propsFromUser: DSFastListT.Props<T>): FastListCTX => {\n  // =============================================================================\n  // MERGE WITH DEFAULT AND VALIDATE PROPS\n  // =============================================================================\n  const propsWithDefault = useMemoMergePropsWithDefault<DSFastListT.InternalProps<T>>(\n    propsFromUser,\n    defaultProps as Partial<DSFastListT.InternalProps<T>>,\n  );\n  useValidateProps(propsWithDefault, DSFastListPropTypes);\n  // =============================================================================\n  // AD HOC PER COMPONENT LOGIC\n  // =============================================================================\n  const { actionRef, count, estimateSize, paddingStart, paddingEnd, innerRef, remountOnCountChange } = propsWithDefault;\n  const parentRef = React.useRef<HTMLDivElement>(null);\n  const containerRef = React.useMemo(\n    () => (innerRef ? setMultipleRefs<HTMLDivElement>([parentRef, innerRef]) : parentRef),\n    [innerRef],\n  );\n  const useVirtualHelpers = useVirtualizer({\n    count,\n    getScrollElement: () => parentRef.current,\n    overscan: 15,\n    estimateSize,\n    paddingStart,\n    paddingEnd,\n  });\n  const totalSize = useVirtualHelpers.getTotalSize();\n\n  if (actionRef && actionRef.current) {\n    actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;\n    actionRef.current.measure = useVirtualHelpers.measure;\n    // `getVirtualItems()` includes the overscan buffer on each side \u2014 not what \"visible\" means.\n    // `calculateRange()` is the virtualizer's own pre-overscan viewport calculation (pure scroll\n    // geometry, no DOM scraping) and is what \"currently visible\" should actually be backed by.\n    actionRef.current.getVisibleItems = () => {\n      const range = useVirtualHelpers.calculateRange();\n      if (!range) return [];\n      /**\n       * `calculateRange()` always seeds the item nearest to the scroll offset, even when only padding is in view\n       * (a `paddingStart` or `paddingEnd` larger than the viewport), so each index is kept only if its item\n       * actually intersects the viewport.\n       */\n      const viewportStart = useVirtualHelpers.scrollOffset ?? 0;\n      const viewportEnd = viewportStart + (useVirtualHelpers.scrollRect?.height ?? 0);\n      const indices: number[] = [];\n      for (let index = range.startIndex; index <= range.endIndex; index += 1) {\n        const item = useVirtualHelpers.measurementsCache[index];\n        if (item && item.end > viewportStart && item.start < viewportEnd) indices.push(index);\n      }\n      return indices;\n    };\n    // The overscanned set (viewport + the 15-item buffer on each side) \u2014 everything currently\n    // mounted in the DOM, as opposed to `getVisibleItems()`'s true-viewport-only set above.\n    actionRef.current.getMountedItems = () => useVirtualHelpers.getVirtualItems().map((item) => item.index);\n    actionRef.current.getOffsetForIndex = (index, align) => useVirtualHelpers.getOffsetForIndex(index, align)?.[0];\n    actionRef.current.scrollToOffset = useVirtualHelpers.scrollToOffset;\n  }\n\n  const stableUid = React.useMemo(() => uid(6), []);\n  const instanceUid = React.useMemo(\n    () => (remountOnCountChange === false ? `ds-fast-list-${stableUid}` : `ds-fast-list-${uid(6)}${count}`),\n    [count, remountOnCountChange, stableUid],\n  );\n  return React.useMemo(\n    () => ({\n      instanceUid,\n      containerRef,\n      getVirtualItems: useVirtualHelpers.getVirtualItems,\n      totalSize,\n      measureElement: useVirtualHelpers.measureElement,\n    }),\n    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid, containerRef],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAkB;AAClB,iBAAoB;AACpB,2BAAiD;AACjD,8BAA6C;AAC7C,uBAAgC;AAChC,mCAAoE;AACpE,8BAAiC;AAS1B,MAAM,cAAc,CAAK,kBAAqD;AAInF,QAAM,uBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACA,gDAAiB,kBAAkB,gDAAmB;AAItD,QAAM,EAAE,WAAW,OAAO,cAAc,cAAc,YAAY,UAAU,qBAAqB,IAAI;AACrG,QAAM,YAAY,aAAAA,QAAM,OAAuB,IAAI;AACnD,QAAM,eAAe,aAAAA,QAAM;AAAA,IACzB,MAAO,eAAW,kCAAgC,CAAC,WAAW,QAAQ,CAAC,IAAI;AAAA,IAC3E,CAAC,QAAQ;AAAA,EACX;AACA,QAAM,wBAAoB,qCAAe;AAAA,IACvC;AAAA,IACA,kBAAkB,MAAM,UAAU;AAAA,IAClC,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,YAAY,kBAAkB,aAAa;AAEjD,MAAI,aAAa,UAAU,SAAS;AAClC,cAAU,QAAQ,WAAW,kBAAkB;AAC/C,cAAU,QAAQ,UAAU,kBAAkB;AAI9C,cAAU,QAAQ,kBAAkB,MAAM;AACxC,YAAM,QAAQ,kBAAkB,eAAe;AAC/C,UAAI,CAAC,MAAO,QAAO,CAAC;AAMpB,YAAM,gBAAgB,kBAAkB,gBAAgB;AACxD,YAAM,cAAc,iBAAiB,kBAAkB,YAAY,UAAU;AAC7E,YAAM,UAAoB,CAAC;AAC3B,eAAS,QAAQ,MAAM,YAAY,SAAS,MAAM,UAAU,SAAS,GAAG;AACtE,cAAM,OAAO,kBAAkB,kBAAkB,KAAK;AACtD,YAAI,QAAQ,KAAK,MAAM,iBAAiB,KAAK,QAAQ,YAAa,SAAQ,KAAK,KAAK;AAAA,MACtF;AACA,aAAO;AAAA,IACT;AAGA,cAAU,QAAQ,kBAAkB,MAAM,kBAAkB,gBAAgB,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK;AACtG,cAAU,QAAQ,oBAAoB,CAAC,OAAO,UAAU,kBAAkB,kBAAkB,OAAO,KAAK,IAAI,CAAC;AAC7G,cAAU,QAAQ,iBAAiB,kBAAkB;AAAA,EACvD;AAEA,QAAM,YAAY,aAAAA,QAAM,QAAQ,UAAM,gBAAI,CAAC,GAAG,CAAC,CAAC;AAChD,QAAM,cAAc,aAAAA,QAAM;AAAA,IACxB,MAAO,yBAAyB,QAAQ,gBAAgB,SAAS,KAAK,oBAAgB,gBAAI,CAAC,CAAC,GAAG,KAAK;AAAA,IACpG,CAAC,OAAO,sBAAsB,SAAS;AAAA,EACzC;AACA,SAAO,aAAAA,QAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,iBAAiB,kBAAkB;AAAA,MACnC;AAAA,MACA,gBAAgB,kBAAkB;AAAA,IACpC;AAAA,IACA,CAAC,kBAAkB,iBAAiB,kBAAkB,gBAAgB,WAAW,aAAa,YAAY;AAAA,EAC5G;AACF;",
   "names": ["React"]
 }

package/dist/cjs/hooks/useValidateProps.js

@@ -33,8 +33,8 @@ __export(useValidateProps_exports, {
 module.exports = __toCommonJS(useValidateProps_exports);
 var React = __toESM(require("react"));
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
-var import_DSFastListDefinitions = require("../DSFastListDefinitions.js");
+var import_constants = require("../constants/index.js");
 const useValidateProps = (props, propTypes) => {
-  (0, import_ds_props_helpers.useValidateTypescriptPropTypes)(props, propTypes, import_DSFastListDefinitions.DSFastListName);
+  (0, import_ds_props_helpers.useValidateTypescriptPropTypes)(props, propTypes, import_constants.DSFastListName);
 };
 //# sourceMappingURL=useValidateProps.js.map

package/dist/cjs/hooks/useValidateProps.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/useValidateProps.ts", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { WeakValidationMap } from 'react';\nimport { type DSFastListT } from '../react-desc-prop-types.js';\nimport { DSFastListName } from '../DSFastListDefinitions.js';\n\nexport const useValidateProps = <T>(\n  props: DSFastListT.InternalProps<T>,\n  propTypes: WeakValidationMap<unknown>,\n): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSFastListName);\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA+C;AAG/C,mCAA+B;AAExB,MAAM,mBAAmB,CAC9B,OACA,cACS;AAET,8DAA+B,OAAO,WAAW,2CAAc;AACjE;",
+  "sourcesContent": ["import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { WeakValidationMap } from 'react';\nimport { type DSFastListT } from '../react-desc-prop-types.js';\nimport { DSFastListName } from '../constants/index.js';\n\nexport const useValidateProps = <T>(\n  props: DSFastListT.InternalProps<T>,\n  propTypes: WeakValidationMap<unknown>,\n): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSFastListName);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA+C;AAG/C,uBAA+B;AAExB,MAAM,mBAAmB,CAC9B,OACA,cACS;AAET,8DAA+B,OAAO,WAAW,+BAAc;AACjE;",
   "names": []
 }

package/dist/cjs/index.js

@@ -29,9 +29,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DSFastList: () => import_FastList.DSFastList,
+  DSFastListDataTestIds: () => import_constants.DSFastListDataTestIds,
+  DSFastListName: () => import_constants.DSFastListName,
+  DSFastListSlots: () => import_constants.DSFastListSlots,
   DSFastListWithSchema: () => import_FastList.DSFastListWithSchema
 });
 module.exports = __toCommonJS(index_exports);
 var React = __toESM(require("react"));
 var import_FastList = require("./FastList.js");
+var import_constants = require("./constants/index.js");
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["export { type DSFastListT } from './react-desc-prop-types.js';\nexport { DSFastList, DSFastListWithSchema } from './FastList.js';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,sBAAiD;",
+  "sourcesContent": ["export { type DSFastListT } from './react-desc-prop-types.js';\nexport { DSFastList, DSFastListWithSchema } from './FastList.js';\nexport { DSFastListName, DSFastListSlots, DSFastListDataTestIds } from './constants/index.js';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,sBAAiD;AACjD,uBAAuE;",
   "names": []
 }

package/dist/cjs/parts/List.js

@@ -37,26 +37,30 @@ var import_react = __toESM(require("react"));
 var import_ds_system = require("@elliemae/ds-system");
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
 var import_useFastList = require("../hooks/useFastList.js");
-var import_DSFastListDefinitions = require("../DSFastListDefinitions.js");
+var import_constants = require("../constants/index.js");
 const StyledList = (0, import_ds_system.styled)("div", {
-  name: import_DSFastListDefinitions.DSFastListName,
-  slot: import_DSFastListDefinitions.DSFastListSlots.WRAPPER_LIST
+  name: import_constants.DSFastListName,
+  slot: import_constants.DSFastListSlots.WRAPPER_LIST
 })`
   width: 100%;
   position: relative;
 `;
 const StyledListItem = (0, import_ds_system.styled)("div", {
-  name: import_DSFastListDefinitions.DSFastListName,
-  slot: import_DSFastListDefinitions.DSFastListSlots.ITEM
+  name: import_constants.DSFastListName,
+  slot: import_constants.DSFastListSlots.ITEM
 })`
   position: absolute;
   top: 0;
   left: 0;
   width: 100%;
 `;
+const StyledExtraContent = (0, import_ds_system.styled)("div", {
+  name: import_constants.DSFastListName,
+  slot: import_constants.DSFastListSlots.EXTRA_CONTENT
+})``;
 const StyledListContainer = (0, import_ds_system.styled)("div", {
-  name: import_DSFastListDefinitions.DSFastListName,
-  slot: import_DSFastListDefinitions.DSFastListSlots.CONTAINER
+  name: import_constants.DSFastListName,
+  slot: import_constants.DSFastListSlots.CONTAINER
 })`
   overflow: auto;
   width: 100%;
@@ -64,8 +68,9 @@ const StyledListContainer = (0, import_ds_system.styled)("div", {
   padding-bottom: 0;
 `;
 const List = (props) => {
-  const { parentRef, getVirtualItems, totalSize, instanceUid, measureElement } = (0, import_useFastList.useFastList)(props);
-  const { ItemRenderer, extraItemProps, getId } = props;
+  const { containerRef, getVirtualItems, totalSize, instanceUid, measureElement } = (0, import_useFastList.useFastList)(props);
+  const { ItemRenderer, extraItemProps, getId, extraContent } = props;
+  const hasExtraContent = extraContent !== null && extraContent !== void 0 && typeof extraContent !== "boolean";
   const virtualItems = getVirtualItems();
   const measureRef = import_react.default.useCallback(
     (node) => measureElement(node),
@@ -76,11 +81,11 @@ const List = (props) => {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     StyledListContainer,
     {
-      innerRef: parentRef,
+      innerRef: containerRef,
       tabIndex: -1,
       getOwnerProps,
       ...globalAttributes,
-      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
         StyledList,
         {
           style: {
@@ -89,24 +94,27 @@ const List = (props) => {
           },
           role: "list",
           getOwnerProps,
-          children: virtualItems.map((virtualItem) => {
-            const { index, start } = virtualItem;
-            return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-              StyledListItem,
-              {
-                innerRef: measureRef,
-                "data-index": index,
-                style: {
-                  transform: `translateY(${start}px)`
+          children: [
+            hasExtraContent ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(StyledExtraContent, { getOwnerProps, children: extraContent }) : null,
+            virtualItems.map((virtualItem) => {
+              const { index, start } = virtualItem;
+              return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                StyledListItem,
+                {
+                  innerRef: measureRef,
+                  "data-index": index,
+                  style: {
+                    transform: `translateY(${start}px)`
+                  },
+                  role: "listitem",
+                  getOwnerProps,
+                  getOwnerPropsArguments: () => ({ index: getId(index) }),
+                  children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ItemRenderer, { extraItemProps, index })
                 },
-                role: "listitem",
-                getOwnerProps,
-                getOwnerPropsArguments: () => ({ index: getId(index) }),
-                children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ItemRenderer, { extraItemProps, index })
-              },
-              getId(index)
-            );
-          })
+                getId(index)
+              );
+            })
+          ]
         }
       )
     },

package/dist/cjs/parts/List.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/parts/List.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import React, { useCallback } from 'react';\nimport { styled } from '@elliemae/ds-system';\nimport { useGetGlobalAttributes } from '@elliemae/ds-props-helpers';\nimport { useFastList } from '../hooks/useFastList.js';\nimport type { DSFastListT } from '../react-desc-prop-types.js';\nimport { DSFastListName, DSFastListSlots } from '../DSFastListDefinitions.js';\n\nconst StyledList = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.WRAPPER_LIST,\n})`\n  width: 100%;\n  position: relative;\n`;\n\nconst StyledListItem = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.ITEM,\n})`\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n`;\n\nconst StyledListContainer = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.CONTAINER,\n})`\n  overflow: auto;\n  width: 100%;\n  height: 100%;\n  padding-bottom: 0;\n`;\n\nexport const List = <T extends object>(props: DSFastListT.Props<T>) => {\n  const { parentRef, getVirtualItems, totalSize, instanceUid, measureElement } = useFastList(props);\n  const { ItemRenderer, extraItemProps, getId } = props;\n\n  const virtualItems = getVirtualItems();\n  const measureRef: React.LegacyRef<HTMLDivElement> = React.useCallback(\n    (node: HTMLDivElement) => measureElement(node),\n    [measureElement],\n  );\n\n  const getOwnerProps = useCallback(() => props, [props]);\n  const globalAttributes = useGetGlobalAttributes(props);\n\n  return (\n    <StyledListContainer\n      innerRef={parentRef}\n      // firefox needs this tabIndex to prevent scrolling\n      tabIndex={-1}\n      key={instanceUid}\n      getOwnerProps={getOwnerProps}\n      {...globalAttributes}\n    >\n      <StyledList\n        style={{\n          // we add up 0.5 to prevent the scrollbar from appearing in some cases\n          height: `${totalSize + 0.5}px`,\n        }}\n        role=\"list\"\n        getOwnerProps={getOwnerProps}\n      >\n        {virtualItems.map((virtualItem) => {\n          const { index, start } = virtualItem;\n          return (\n            <StyledListItem\n              innerRef={measureRef}\n              data-index={index}\n              style={{\n                transform: `translateY(${start}px)`,\n              }}\n              role=\"listitem\"\n              key={getId(index)}\n              getOwnerProps={getOwnerProps}\n              getOwnerPropsArguments={() => ({ index: getId(index) })}\n            >\n              <ItemRenderer extraItemProps={extraItemProps} index={index} />\n            </StyledListItem>\n          );\n        })}\n      </StyledList>\n    </StyledListContainer>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;AD+ET;AA/Ed,mBAAmC;AACnC,uBAAuB;AACvB,8BAAuC;AACvC,yBAA4B;AAE5B,mCAAgD;AAEhD,MAAM,iBAAa,yBAAO,OAAO;AAAA,EAC/B,MAAM;AAAA,EACN,MAAM,6CAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAKD,MAAM,qBAAiB,yBAAO,OAAO;AAAA,EACnC,MAAM;AAAA,EACN,MAAM,6CAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOD,MAAM,0BAAsB,yBAAO,OAAO;AAAA,EACxC,MAAM;AAAA,EACN,MAAM,6CAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOM,MAAM,OAAO,CAAmB,UAAgC;AACrE,QAAM,EAAE,WAAW,iBAAiB,WAAW,aAAa,eAAe,QAAI,gCAAY,KAAK;AAChG,QAAM,EAAE,cAAc,gBAAgB,MAAM,IAAI;AAEhD,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8C,aAAAA,QAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,oBAAgB,0BAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,uBAAmB,gDAAuB,KAAK;AAErD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UAAU;AAAA,MAEV,UAAU;AAAA,MAEV;AAAA,MACC,GAAG;AAAA,MAEJ;AAAA,QAAC;AAAA;AAAA,UACC,OAAO;AAAA;AAAA,YAEL,QAAQ,GAAG,YAAY,GAAG;AAAA,UAC5B;AAAA,UACA,MAAK;AAAA,UACL;AAAA,UAEC,uBAAa,IAAI,CAAC,gBAAgB;AACjC,kBAAM,EAAE,OAAO,MAAM,IAAI;AACzB,mBACE;AAAA,cAAC;AAAA;AAAA,gBACC,UAAU;AAAA,gBACV,cAAY;AAAA,gBACZ,OAAO;AAAA,kBACL,WAAW,cAAc,KAAK;AAAA,gBAChC;AAAA,gBACA,MAAK;AAAA,gBAEL;AAAA,gBACA,wBAAwB,OAAO,EAAE,OAAO,MAAM,KAAK,EAAE;AAAA,gBAErD,sDAAC,gBAAa,gBAAgC,OAAc;AAAA;AAAA,cAJvD,MAAM,KAAK;AAAA,YAKlB;AAAA,UAEJ,CAAC;AAAA;AAAA,MACH;AAAA;AAAA,IA9BK;AAAA,EA+BP;AAEJ;",
+  "sourcesContent": ["import React, { useCallback } from 'react';\nimport { styled } from '@elliemae/ds-system';\nimport { useGetGlobalAttributes } from '@elliemae/ds-props-helpers';\nimport { useFastList } from '../hooks/useFastList.js';\nimport type { DSFastListT } from '../react-desc-prop-types.js';\nimport { DSFastListName, DSFastListSlots } from '../constants/index.js';\n\nconst StyledList = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.WRAPPER_LIST,\n})`\n  width: 100%;\n  position: relative;\n`;\n\nconst StyledListItem = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.ITEM,\n})`\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n`;\n\nconst StyledExtraContent = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.EXTRA_CONTENT,\n})``;\n\nconst StyledListContainer = styled('div', {\n  name: DSFastListName,\n  slot: DSFastListSlots.CONTAINER,\n})`\n  overflow: auto;\n  width: 100%;\n  height: 100%;\n  padding-bottom: 0;\n`;\n\nexport const List = <T extends object>(props: DSFastListT.Props<T>) => {\n  const { containerRef, getVirtualItems, totalSize, instanceUid, measureElement } = useFastList(props);\n  const { ItemRenderer, extraItemProps, getId, extraContent } = props;\n  const hasExtraContent = extraContent !== null && extraContent !== undefined && typeof extraContent !== 'boolean';\n\n  const virtualItems = getVirtualItems();\n  const measureRef: React.LegacyRef<HTMLDivElement> = React.useCallback(\n    (node: HTMLDivElement) => measureElement(node),\n    [measureElement],\n  );\n\n  const getOwnerProps = useCallback(() => props, [props]);\n  const globalAttributes = useGetGlobalAttributes(props);\n\n  return (\n    <StyledListContainer\n      innerRef={containerRef}\n      // firefox needs this tabIndex to prevent scrolling\n      tabIndex={-1}\n      key={instanceUid}\n      getOwnerProps={getOwnerProps}\n      {...globalAttributes}\n    >\n      <StyledList\n        style={{\n          // we add up 0.5 to prevent the scrollbar from appearing in some cases\n          height: `${totalSize + 0.5}px`,\n        }}\n        role=\"list\"\n        getOwnerProps={getOwnerProps}\n      >\n        {hasExtraContent ? <StyledExtraContent getOwnerProps={getOwnerProps}>{extraContent}</StyledExtraContent> : null}\n        {virtualItems.map((virtualItem) => {\n          const { index, start } = virtualItem;\n          return (\n            <StyledListItem\n              innerRef={measureRef}\n              data-index={index}\n              style={{\n                transform: `translateY(${start}px)`,\n              }}\n              role=\"listitem\"\n              key={getId(index)}\n              getOwnerProps={getOwnerProps}\n              getOwnerPropsArguments={() => ({ index: getId(index) })}\n            >\n              <ItemRenderer extraItemProps={extraItemProps} index={index} />\n            </StyledListItem>\n          );\n        })}\n      </StyledList>\n    </StyledListContainer>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;AD+DjB;AA/DN,mBAAmC;AACnC,uBAAuB;AACvB,8BAAuC;AACvC,yBAA4B;AAE5B,uBAAgD;AAEhD,MAAM,iBAAa,yBAAO,OAAO;AAAA,EAC/B,MAAM;AAAA,EACN,MAAM,iCAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAKD,MAAM,qBAAiB,yBAAO,OAAO;AAAA,EACnC,MAAM;AAAA,EACN,MAAM,iCAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOD,MAAM,yBAAqB,yBAAO,OAAO;AAAA,EACvC,MAAM;AAAA,EACN,MAAM,iCAAgB;AACxB,CAAC;AAED,MAAM,0BAAsB,yBAAO,OAAO;AAAA,EACxC,MAAM;AAAA,EACN,MAAM,iCAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOM,MAAM,OAAO,CAAmB,UAAgC;AACrE,QAAM,EAAE,cAAc,iBAAiB,WAAW,aAAa,eAAe,QAAI,gCAAY,KAAK;AACnG,QAAM,EAAE,cAAc,gBAAgB,OAAO,aAAa,IAAI;AAC9D,QAAM,kBAAkB,iBAAiB,QAAQ,iBAAiB,UAAa,OAAO,iBAAiB;AAEvG,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8C,aAAAA,QAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,oBAAgB,0BAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,uBAAmB,gDAAuB,KAAK;AAErD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UAAU;AAAA,MAEV,UAAU;AAAA,MAEV;AAAA,MACC,GAAG;AAAA,MAEJ;AAAA,QAAC;AAAA;AAAA,UACC,OAAO;AAAA;AAAA,YAEL,QAAQ,GAAG,YAAY,GAAG;AAAA,UAC5B;AAAA,UACA,MAAK;AAAA,UACL;AAAA,UAEC;AAAA,8BAAkB,4CAAC,sBAAmB,eAA+B,wBAAa,IAAwB;AAAA,YAC1G,aAAa,IAAI,CAAC,gBAAgB;AACjC,oBAAM,EAAE,OAAO,MAAM,IAAI;AACzB,qBACE;AAAA,gBAAC;AAAA;AAAA,kBACC,UAAU;AAAA,kBACV,cAAY;AAAA,kBACZ,OAAO;AAAA,oBACL,WAAW,cAAc,KAAK;AAAA,kBAChC;AAAA,kBACA,MAAK;AAAA,kBAEL;AAAA,kBACA,wBAAwB,OAAO,EAAE,OAAO,MAAM,KAAK,EAAE;AAAA,kBAErD,sDAAC,gBAAa,gBAAgC,OAAc;AAAA;AAAA,gBAJvD,MAAM,KAAK;AAAA,cAKlB;AAAA,YAEJ,CAAC;AAAA;AAAA;AAAA,MACH;AAAA;AAAA,IA/BK;AAAA,EAgCP;AAEJ;",
   "names": ["React"]
 }

package/dist/cjs/react-desc-prop-types.js

@@ -34,24 +34,60 @@ __export(react_desc_prop_types_exports, {
 module.exports = __toCommonJS(react_desc_prop_types_exports);
 var React = __toESM(require("react"));
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
+var import_constants = require("./constants/index.js");
 const defaultProps = {
-  estimateSize: () => 36
+  estimateSize: () => 36,
+  paddingStart: 0,
+  paddingEnd: 0,
+  remountOnCountChange: true
 };
 const DSFastListPropTypes = {
+  ...(0, import_ds_props_helpers.getPropsPerSlotPropTypes)(import_constants.DSFastListName, import_constants.DSFastListSlots),
+  ...import_ds_props_helpers.globalAttributesPropTypes,
   actionRef: import_ds_props_helpers.PropTypes.shape({
     current: import_ds_props_helpers.PropTypes.oneOfType([
       import_ds_props_helpers.PropTypes.oneOf([null]),
       import_ds_props_helpers.PropTypes.shape({
-        scrollTo: import_ds_props_helpers.PropTypes.func.description("Scroll to a index inside the list").signature(`((index: number, { align: 'start' | 'center' | 'end' | 'auto' }) => void)`)
+        scrollTo: import_ds_props_helpers.PropTypes.func.description("Scroll to a index inside the list").signature(
+          `((index: number, options?: { align?: 'start' | 'center' | 'end' | 'auto'; behavior?: 'auto' | 'smooth' }) => void)`
+        ),
+        measure: import_ds_props_helpers.PropTypes.func.description(
+          "Clears the cached size of every item, falling back to the estimated size until each item is measured again (on its next real layout change or remount) \u2014 does not force an immediate DOM remeasurement"
+        ).signature(`(() => void)`),
+        getVisibleItems: import_ds_props_helpers.PropTypes.func.description("Returns the indices of the items currently visible in the viewport (no overscan buffer)").signature(`(() => number[])`),
+        getMountedItems: import_ds_props_helpers.PropTypes.func.description("Returns the indices of all items currently mounted in the DOM, including the overscan buffer").signature(`(() => number[])`),
+        getOffsetForIndex: import_ds_props_helpers.PropTypes.func.description(
+          "Returns the scroll offset that brings the item at the given index into view with the given alignment, or undefined when there is no measurement for it yet (for example, an empty list). It reads the current measurements, where items not rendered yet still have the estimated size, and it does not scroll"
+        ).signature(`((index: number, align?: 'start' | 'center' | 'end' | 'auto') => number | undefined)`),
+        scrollToOffset: import_ds_props_helpers.PropTypes.func.description(
+          "Scrolls the list to the given offset once. Unlike scrollTo, it does not verify and retry the position on the following frames, so it never competes with the user scrolling at the same time"
+        ).signature(
+          `((offset: number, options?: { align?: 'start' | 'center' | 'end' | 'auto'; behavior?: 'auto' | 'smooth' }) => void)`
+        )
       })
     ])
-  }).description(`mutable reference where methods will be stored`),
+  }).description(
+    "Mutable reference where the methods are stored. They are assigned during render only when `actionRef.current` is already an object, so pass a ref initialized with one (for example `useRef({})`), not `useRef(null)`"
+  ),
   ItemRenderer: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.object, import_ds_props_helpers.PropTypes.func]).isRequired.description(
     "Render function for each item"
   ),
   count: import_ds_props_helpers.PropTypes.number.isRequired.description("Number of items to render"),
   extraItemProps: import_ds_props_helpers.PropTypes.object.description("Extra props to pass to each item"),
   getId: import_ds_props_helpers.PropTypes.func.isRequired.description("Function to get the key for each item"),
-  estimateSize: import_ds_props_helpers.PropTypes.func.description("Function to estimate the size of each item")
+  estimateSize: import_ds_props_helpers.PropTypes.func.description("Function to estimate the size of each item"),
+  innerRef: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.func, import_ds_props_helpers.PropTypes.object]).description(
+    "Ref (object or callback) that receives the scroll container element of the list"
+  ),
+  paddingStart: import_ds_props_helpers.PropTypes.number.description("Space in pixels reserved before the first item inside the scrolling area").defaultValue(0),
+  paddingEnd: import_ds_props_helpers.PropTypes.number.description(
+    "Space in pixels reserved after the last item inside the scrolling area; negative values are passed through"
+  ).defaultValue(0),
+  remountOnCountChange: import_ds_props_helpers.PropTypes.bool.description(
+    "When true the scroll container element is recreated every time count changes; set it to false to keep the same element and scroll position while the number of items changes"
+  ).defaultValue(true),
+  extraContent: import_ds_props_helpers.PropTypes.node.description(
+    'Content rendered inside the list wrapper before the items, within the extra content slot; it should be positioned out of the normal flow because the wrapper height is fixed. The wrapper has role="list" by default, so the content must carry role="listitem" itself (for example a container around a button), unless the wrapper role is overridden through the wrapper-list slot, in which case it must fit that role instead'
+  )
 };
 //# sourceMappingURL=react-desc-prop-types.js.map

package/dist/cjs/react-desc-prop-types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/react-desc-prop-types.ts", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { PropTypes } from '@elliemae/ds-props-helpers';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport type React from 'react';\nimport type { DSFastListName, DSFastListSlots } from './DSFastListDefinitions.js';\n\nexport declare namespace DSFastListT {\n  type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';\n  export type ScrollToOptions = {\n    align: ScrollAlignment;\n  };\n\n  export type ActionRef = {\n    scrollTo?: (index: number, options?: ScrollToOptions | undefined) => void;\n  };\n\n  export interface OptionalProps<ExtraItemPropsT> extends TypescriptHelpersT.PropsForGlobalOnSlots<\n    typeof DSFastListName,\n    typeof DSFastListSlots\n  > {\n    actionRef?: React.MutableRefObject<ActionRef>;\n    extraItemProps?: ExtraItemPropsT;\n  }\n\n  export interface RequiredProps<ExtraItemPropsT> {\n    ItemRenderer: React.ComponentType<{ index: number; extraItemProps?: ExtraItemPropsT }>;\n    count: number;\n    getId: (index: number) => string | number;\n  }\n\n  export interface DefaultProps {\n    estimateSize: () => number;\n  }\n\n  type PropsT<D, R, O> = Partial<D> & R & O;\n  type InternalPropsT<D, R, O> = D & R & O;\n\n  export type Props<ExtraItemPropsT> = PropsT<\n    DefaultProps,\n    RequiredProps<ExtraItemPropsT>,\n    OptionalProps<ExtraItemPropsT>\n  >;\n  export type InternalProps<ExtraItemPropsT> = InternalPropsT<\n    DefaultProps,\n    RequiredProps<ExtraItemPropsT>,\n    OptionalProps<ExtraItemPropsT>\n  >;\n}\n\nexport const defaultProps = {\n  estimateSize: () => 36,\n};\n\nexport const DSFastListPropTypes = {\n  actionRef: PropTypes.shape({\n    current: PropTypes.oneOfType([\n      PropTypes.oneOf([null]),\n      PropTypes.shape({\n        scrollTo: PropTypes.func\n          .description('Scroll to a index inside the list')\n          .signature(`((index: number, { align: 'start' | 'center' | 'end' | 'auto' }) => void)`),\n      }),\n    ]),\n  }).description(`mutable reference where methods will be stored`),\n  ItemRenderer: PropTypes.oneOfType([PropTypes.object, PropTypes.func]).isRequired.description(\n    'Render function for each item',\n  ),\n  count: PropTypes.number.isRequired.description('Number of items to render'),\n  extraItemProps: PropTypes.object.description('Extra props to pass to each item'),\n  getId: PropTypes.func.isRequired.description('Function to get the key for each item'),\n  estimateSize: PropTypes.func.description('Function to estimate the size of each item'),\n} as React.WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA0B;AAgDnB,MAAM,eAAe;AAAA,EAC1B,cAAc,MAAM;AACtB;AAEO,MAAM,sBAAsB;AAAA,EACjC,WAAW,kCAAU,MAAM;AAAA,IACzB,SAAS,kCAAU,UAAU;AAAA,MAC3B,kCAAU,MAAM,CAAC,IAAI,CAAC;AAAA,MACtB,kCAAU,MAAM;AAAA,QACd,UAAU,kCAAU,KACjB,YAAY,mCAAmC,EAC/C,UAAU,2EAA2E;AAAA,MAC1F,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC,EAAE,YAAY,gDAAgD;AAAA,EAC/D,cAAc,kCAAU,UAAU,CAAC,kCAAU,QAAQ,kCAAU,IAAI,CAAC,EAAE,WAAW;AAAA,IAC/E;AAAA,EACF;AAAA,EACA,OAAO,kCAAU,OAAO,WAAW,YAAY,2BAA2B;AAAA,EAC1E,gBAAgB,kCAAU,OAAO,YAAY,kCAAkC;AAAA,EAC/E,OAAO,kCAAU,KAAK,WAAW,YAAY,uCAAuC;AAAA,EACpF,cAAc,kCAAU,KAAK,YAAY,4CAA4C;AACvF;",
+  "sourcesContent": ["import type { GlobalAttributesT } from '@elliemae/ds-props-helpers';\nimport { PropTypes, getPropsPerSlotPropTypes, globalAttributesPropTypes } from '@elliemae/ds-props-helpers';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport type React from 'react';\nimport { DSFastListName, DSFastListSlots } from './constants/index.js';\n\nexport declare namespace DSFastListT {\n  type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';\n  /** Kept with its published shape (`align` required) so code that reads it keeps compiling. */\n  export type ScrollToOptions = {\n    align: ScrollAlignment;\n  };\n\n  /** What the scroll actions accept: `align` is optional and `behavior` can request a smooth scroll. */\n  export type ScrollActionOptions = {\n    align?: ScrollAlignment;\n    behavior?: 'auto' | 'smooth';\n  };\n\n  /**\n   * `scrollTo` and `scrollToOffset` use method syntax on purpose: their parameters are compared bivariantly, so an\n   * `actionRef` typed with the published `(index, options?: ScrollToOptions) => void` stays assignable.\n   */\n  export type ActionRef = {\n    scrollTo?(index: number, options?: ScrollActionOptions): void;\n    measure?: () => void;\n    getVisibleItems?: () => number[];\n    getMountedItems?: () => number[];\n    getOffsetForIndex?: (index: number, align?: ScrollAlignment) => number | undefined;\n    scrollToOffset?(offset: number, options?: ScrollActionOptions): void;\n  };\n\n  export type SlotFunctionArguments = {\n    dsFastlistContainer: () => object;\n    dsFastlistWrapperList: () => object;\n    dsFastlistItem: () => object;\n    dsFastlistExtraContent: () => object;\n  };\n\n  export interface OptionalProps<ExtraItemPropsT> extends TypescriptHelpersT.PropsForGlobalOnSlots<\n    typeof DSFastListName,\n    typeof DSFastListSlots\n  > {\n    actionRef?: React.MutableRefObject<ActionRef>;\n    extraItemProps?: ExtraItemPropsT;\n    innerRef?: React.MutableRefObject<HTMLDivElement | null> | React.RefCallback<HTMLDivElement>;\n    extraContent?: React.ReactNode;\n  }\n\n  export interface RequiredProps<ExtraItemPropsT> {\n    ItemRenderer: React.ComponentType<{ index: number; extraItemProps?: ExtraItemPropsT }>;\n    count: number;\n    getId: (index: number) => string | number;\n  }\n\n  export interface DefaultProps {\n    estimateSize: () => number;\n    paddingStart: number;\n    paddingEnd: number;\n    remountOnCountChange: boolean;\n  }\n\n  // 'children' is excluded on top of `keyof D | keyof R`: DSFastList is the render-prop variant\n  // (see FastList.tsx's own comment) and never reads props.children \u2014 without this exclusion,\n  // GlobalAttributesT<HTMLElement> (which includes children via React's DOMAttributes) would let\n  // the public type silently accept children that are dropped at runtime.\n  type PropsT<D, R, O> = Partial<D> & R & O & Omit<GlobalAttributesT<HTMLElement>, keyof D | keyof R | 'children'>;\n  type InternalPropsT<D, R, O> = D & R & O & Omit<GlobalAttributesT<HTMLElement>, keyof D | keyof R | 'children'>;\n\n  export type Props<ExtraItemPropsT> = PropsT<\n    DefaultProps,\n    RequiredProps<ExtraItemPropsT>,\n    OptionalProps<ExtraItemPropsT>\n  >;\n  export type InternalProps<ExtraItemPropsT> = InternalPropsT<\n    DefaultProps,\n    RequiredProps<ExtraItemPropsT>,\n    OptionalProps<ExtraItemPropsT>\n  >;\n}\n\nexport const defaultProps = {\n  estimateSize: () => 36,\n  paddingStart: 0,\n  paddingEnd: 0,\n  remountOnCountChange: true,\n};\n\nexport const DSFastListPropTypes = {\n  ...getPropsPerSlotPropTypes(DSFastListName, DSFastListSlots),\n  ...globalAttributesPropTypes,\n  actionRef: PropTypes.shape({\n    current: PropTypes.oneOfType([\n      PropTypes.oneOf([null]),\n      PropTypes.shape({\n        scrollTo: PropTypes.func\n          .description('Scroll to a index inside the list')\n          .signature(\n            `((index: number, options?: { align?: 'start' | 'center' | 'end' | 'auto'; behavior?: 'auto' | 'smooth' }) => void)`,\n          ),\n        measure: PropTypes.func\n          .description(\n            'Clears the cached size of every item, falling back to the estimated size until each item is measured again (on its next real layout change or remount) \u2014 does not force an immediate DOM remeasurement',\n          )\n          .signature(`(() => void)`),\n        getVisibleItems: PropTypes.func\n          .description('Returns the indices of the items currently visible in the viewport (no overscan buffer)')\n          .signature(`(() => number[])`),\n        getMountedItems: PropTypes.func\n          .description('Returns the indices of all items currently mounted in the DOM, including the overscan buffer')\n          .signature(`(() => number[])`),\n        getOffsetForIndex: PropTypes.func\n          .description(\n            'Returns the scroll offset that brings the item at the given index into view with the given alignment, or undefined when there is no measurement for it yet (for example, an empty list). It reads the current measurements, where items not rendered yet still have the estimated size, and it does not scroll',\n          )\n          .signature(`((index: number, align?: 'start' | 'center' | 'end' | 'auto') => number | undefined)`),\n        scrollToOffset: PropTypes.func\n          .description(\n            'Scrolls the list to the given offset once. Unlike scrollTo, it does not verify and retry the position on the following frames, so it never competes with the user scrolling at the same time',\n          )\n          .signature(\n            `((offset: number, options?: { align?: 'start' | 'center' | 'end' | 'auto'; behavior?: 'auto' | 'smooth' }) => void)`,\n          ),\n      }),\n    ]),\n  }).description(\n    'Mutable reference where the methods are stored. They are assigned during render only when `actionRef.current` is already an object, so pass a ref initialized with one (for example `useRef({})`), not `useRef(null)`',\n  ),\n  ItemRenderer: PropTypes.oneOfType([PropTypes.object, PropTypes.func]).isRequired.description(\n    'Render function for each item',\n  ),\n  count: PropTypes.number.isRequired.description('Number of items to render'),\n  extraItemProps: PropTypes.object.description('Extra props to pass to each item'),\n  getId: PropTypes.func.isRequired.description('Function to get the key for each item'),\n  estimateSize: PropTypes.func.description('Function to estimate the size of each item'),\n  innerRef: PropTypes.oneOfType([PropTypes.func, PropTypes.object]).description(\n    'Ref (object or callback) that receives the scroll container element of the list',\n  ),\n  paddingStart: PropTypes.number\n    .description('Space in pixels reserved before the first item inside the scrolling area')\n    .defaultValue(0),\n  paddingEnd: PropTypes.number\n    .description(\n      'Space in pixels reserved after the last item inside the scrolling area; negative values are passed through',\n    )\n    .defaultValue(0),\n  remountOnCountChange: PropTypes.bool\n    .description(\n      'When true the scroll container element is recreated every time count changes; set it to false to keep the same element and scroll position while the number of items changes',\n    )\n    .defaultValue(true),\n  extraContent: PropTypes.node.description(\n    'Content rendered inside the list wrapper before the items, within the extra content slot; it should be positioned out of the normal flow because the wrapper height is fixed. The wrapper has role=\"list\" by default, so the content must carry role=\"listitem\" itself (for example a container around a button), unless the wrapper role is overridden through the wrapper-list slot, in which case it must fit that role instead',\n  ),\n} as React.WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,8BAA+E;AAG/E,uBAAgD;AA6EzC,MAAM,eAAe;AAAA,EAC1B,cAAc,MAAM;AAAA,EACpB,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AACxB;AAEO,MAAM,sBAAsB;AAAA,EACjC,OAAG,kDAAyB,iCAAgB,gCAAe;AAAA,EAC3D,GAAG;AAAA,EACH,WAAW,kCAAU,MAAM;AAAA,IACzB,SAAS,kCAAU,UAAU;AAAA,MAC3B,kCAAU,MAAM,CAAC,IAAI,CAAC;AAAA,MACtB,kCAAU,MAAM;AAAA,QACd,UAAU,kCAAU,KACjB,YAAY,mCAAmC,EAC/C;AAAA,UACC;AAAA,QACF;AAAA,QACF,SAAS,kCAAU,KAChB;AAAA,UACC;AAAA,QACF,EACC,UAAU,cAAc;AAAA,QAC3B,iBAAiB,kCAAU,KACxB,YAAY,yFAAyF,EACrG,UAAU,kBAAkB;AAAA,QAC/B,iBAAiB,kCAAU,KACxB,YAAY,8FAA8F,EAC1G,UAAU,kBAAkB;AAAA,QAC/B,mBAAmB,kCAAU,KAC1B;AAAA,UACC;AAAA,QACF,EACC,UAAU,sFAAsF;AAAA,QACnG,gBAAgB,kCAAU,KACvB;AAAA,UACC;AAAA,QACF,EACC;AAAA,UACC;AAAA,QACF;AAAA,MACJ,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC,EAAE;AAAA,IACD;AAAA,EACF;AAAA,EACA,cAAc,kCAAU,UAAU,CAAC,kCAAU,QAAQ,kCAAU,IAAI,CAAC,EAAE,WAAW;AAAA,IAC/E;AAAA,EACF;AAAA,EACA,OAAO,kCAAU,OAAO,WAAW,YAAY,2BAA2B;AAAA,EAC1E,gBAAgB,kCAAU,OAAO,YAAY,kCAAkC;AAAA,EAC/E,OAAO,kCAAU,KAAK,WAAW,YAAY,uCAAuC;AAAA,EACpF,cAAc,kCAAU,KAAK,YAAY,4CAA4C;AAAA,EACrF,UAAU,kCAAU,UAAU,CAAC,kCAAU,MAAM,kCAAU,MAAM,CAAC,EAAE;AAAA,IAChE;AAAA,EACF;AAAA,EACA,cAAc,kCAAU,OACrB,YAAY,0EAA0E,EACtF,aAAa,CAAC;AAAA,EACjB,YAAY,kCAAU,OACnB;AAAA,IACC;AAAA,EACF,EACC,aAAa,CAAC;AAAA,EACjB,sBAAsB,kCAAU,KAC7B;AAAA,IACC;AAAA,EACF,EACC,aAAa,IAAI;AAAA,EACpB,cAAc,kCAAU,KAAK;AAAA,IAC3B;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/cjs/{FastListDataTestID.js → typescript-testing/slot-props.js}

@@ -5,10 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 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))
@@ -25,14 +21,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var FastListDataTestID_exports = {};
-__export(FastListDataTestID_exports, {
-  LIST_DATA_TESTID: () => LIST_DATA_TESTID
-});
-module.exports = __toCommonJS(FastListDataTestID_exports);
 var React = __toESM(require("react"));
-const LIST_DATA_TESTID = {
-  CONTAINER: "fast-list-container"
+const SlotPropsAsObject = {
+  dsFastlistContainer: { "aria-label": "just a typescript test" },
+  dsFastlistWrapperList: { "aria-label": "just a typescript test" },
+  dsFastlistItem: { "aria-label": "just a typescript test" },
+  dsFastlistExtraContent: { "aria-label": "just a typescript test" }
+};
+const SlotPropsAsFunctions = {
+  dsFastlistContainer: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistWrapperList: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistItem: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistExtraContent: () => ({ "aria-label": "just a typescript test" })
 };
-//# sourceMappingURL=FastListDataTestID.js.map
+const EnsureAllSlotsExistInSlotFunctionArguments = SlotPropsAsFunctions;
+//# sourceMappingURL=slot-props.js.map

package/dist/cjs/typescript-testing/slot-props.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/typescript-testing/slot-props.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */\n\nimport type { TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport type { DSFastListName, DSFastListSlots } from '../constants/index.js';\nimport type { DSFastListT } from '../react-desc-prop-types.js';\n\nconst SlotPropsAsObject: Partial<DSFastListT.OptionalProps<object>> = {\n  dsFastlistContainer: { 'aria-label': 'just a typescript test' },\n  dsFastlistWrapperList: { 'aria-label': 'just a typescript test' },\n  dsFastlistItem: { 'aria-label': 'just a typescript test' },\n  dsFastlistExtraContent: { 'aria-label': 'just a typescript test' },\n};\n\nconst SlotPropsAsFunctions: DSFastListT.SlotFunctionArguments = {\n  dsFastlistContainer: () => ({ 'aria-label': 'just a typescript test' }),\n  dsFastlistWrapperList: () => ({ 'aria-label': 'just a typescript test' }),\n  dsFastlistItem: () => ({ 'aria-label': 'just a typescript test' }),\n  dsFastlistExtraContent: () => ({ 'aria-label': 'just a typescript test' }),\n};\n\n// Exhaustiveness check \u2014 fails compilation if a slot is missing from SlotFunctionArguments\nconst EnsureAllSlotsExistInSlotFunctionArguments: Required<\n  TypescriptHelpersT.PropsForSlots<typeof DSFastListName, typeof DSFastListSlots>\n> = SlotPropsAsFunctions;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,YAAuB;ACMvB,MAAM,oBAAgE;AAAA,EACpE,qBAAqB,EAAE,cAAc,yBAAyB;AAAA,EAC9D,uBAAuB,EAAE,cAAc,yBAAyB;AAAA,EAChE,gBAAgB,EAAE,cAAc,yBAAyB;AAAA,EACzD,wBAAwB,EAAE,cAAc,yBAAyB;AACnE;AAEA,MAAM,uBAA0D;AAAA,EAC9D,qBAAqB,OAAO,EAAE,cAAc,yBAAyB;AAAA,EACrE,uBAAuB,OAAO,EAAE,cAAc,yBAAyB;AAAA,EACvE,gBAAgB,OAAO,EAAE,cAAc,yBAAyB;AAAA,EAChE,wBAAwB,OAAO,EAAE,cAAc,yBAAyB;AAC1E;AAGA,MAAM,6CAEF;",
+  "names": []
+}