@elliemae/ds-virtual-list 3.80.0-next.2 → 3.80.0-next.20

package/dist/cjs/VirtualList.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_DSVirtualListDefinitions = require("./DSVirtualListDefinitions.js");
+var import_constants = require("./constants/index.js");
 const DSVirtualList = (props) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_List.List, { ...props });
-DSVirtualList.displayName = import_DSVirtualListDefinitions.DSVirtualListName;
+DSVirtualList.displayName = import_constants.DSVirtualListName;
 const DSVirtualListWithSchema = (0, import_ds_props_helpers.describe)(DSVirtualList).description("DSVirtualList");
 DSVirtualListWithSchema.propTypes = import_react_desc_prop_types.DSVirtualListPropTypes;
 //# sourceMappingURL=VirtualList.js.map

package/dist/cjs/VirtualList.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/VirtualList.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 { DSVirtualListPropTypes, type DSVirtualListT } from './react-desc-prop-types.js';\nimport { DSVirtualListName } from './DSVirtualListDefinitions.js';\n\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSVirtualList = (props: DSVirtualListT.Props) => <List {...props} />;\n\nDSVirtualList.displayName = DSVirtualListName;\nconst DSVirtualListWithSchema = describe(DSVirtualList).description('DSVirtualList');\nDSVirtualListWithSchema.propTypes = DSVirtualListPropTypes;\n\nexport { DSVirtualList, DSVirtualListWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADOgC;AANvD,8BAAyB;AACzB,kBAAqB;AACrB,mCAA4D;AAC5D,sCAAkC;AAGlC,MAAM,gBAAgB,CAAC,UAAgC,4CAAC,oBAAM,GAAG,OAAO;AAExE,cAAc,cAAc;AAC5B,MAAM,8BAA0B,kCAAS,aAAa,EAAE,YAAY,eAAe;AACnF,wBAAwB,YAAY;",
+  "sourcesContent": ["import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { List } from './parts/List.js';\nimport { DSVirtualListPropTypes, type DSVirtualListT } from './react-desc-prop-types.js';\nimport { DSVirtualListName } from './constants/index.js';\n\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSVirtualList = (props: DSVirtualListT.Props) => <List {...props} />;\n\nDSVirtualList.displayName = DSVirtualListName;\nconst DSVirtualListWithSchema = describe(DSVirtualList).description('DSVirtualList');\nDSVirtualListWithSchema.propTypes = DSVirtualListPropTypes;\n\nexport { DSVirtualList, DSVirtualListWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADOgC;AANvD,8BAAyB;AACzB,kBAAqB;AACrB,mCAA4D;AAC5D,uBAAkC;AAGlC,MAAM,gBAAgB,CAAC,UAAgC,4CAAC,oBAAM,GAAG,OAAO;AAExE,cAAc,cAAc;AAC5B,MAAM,8BAA0B,kCAAS,aAAa,EAAE,YAAY,eAAe;AACnF,wBAAwB,YAAY;",
   "names": []
 }

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

@@ -26,17 +26,25 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var DSVirtualListDefinitions_exports = {};
-__export(DSVirtualListDefinitions_exports, {
+var constants_exports = {};
+__export(constants_exports, {
+  DSVirtualListDataTestIds: () => DSVirtualListDataTestIds,
   DSVirtualListName: () => DSVirtualListName,
   DSVirtualListSlots: () => DSVirtualListSlots
 });
-module.exports = __toCommonJS(DSVirtualListDefinitions_exports);
+module.exports = __toCommonJS(constants_exports);
 var React = __toESM(require("react"));
+var import_ds_system = require("@elliemae/ds-system");
 const DSVirtualListName = "DSVirtuallist";
 const DSVirtualListSlots = {
   ROOT: "root",
+  // legacy — data-testid preserved below, do not let slot auto-generation replace it
   LIST_WRAPPER: "list-wrapper",
   ITEM_WRAPPER: "item-wrapper"
 };
-//# sourceMappingURL=DSVirtualListDefinitions.js.map
+const DSVirtualListDataTestIds = {
+  ...(0, import_ds_system.slotObjectToDataTestIds)(DSVirtualListName, DSVirtualListSlots),
+  ROOT: "virtual-list-container"
+  // legacy value — e2e/ds-virtuallist/DSVirtualListCO.js depends on it, breaking change if removed
+};
+//# 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 DSVirtualListName = 'DSVirtuallist';\n\nexport const DSVirtualListSlots = {\n  ROOT: 'root', // legacy \u2014 data-testid preserved below, do not let slot auto-generation replace it\n  LIST_WRAPPER: 'list-wrapper',\n  ITEM_WRAPPER: 'item-wrapper',\n} as const;\n\nexport const DSVirtualListDataTestIds = {\n  ...slotObjectToDataTestIds(DSVirtualListName, DSVirtualListSlots),\n  ROOT: 'virtual-list-container', // legacy value \u2014 e2e/ds-virtuallist/DSVirtualListCO.js depends on it, breaking change if removed\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAwC;AAEjC,MAAM,oBAAoB;AAE1B,MAAM,qBAAqB;AAAA,EAChC,MAAM;AAAA;AAAA,EACN,cAAc;AAAA,EACd,cAAc;AAChB;AAEO,MAAM,2BAA2B;AAAA,EACtC,OAAG,0CAAwB,mBAAmB,kBAAkB;AAAA,EAChE,MAAM;AAAA;AACR;",
+  "names": []
+}

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_DSVirtualListDefinitions = require("../DSVirtualListDefinitions.js");
+var import_constants = require("../constants/index.js");
 const useValidateProps = (props, propTypes) => {
-  (0, import_ds_props_helpers.useValidateTypescriptPropTypes)(props, propTypes, import_DSVirtualListDefinitions.DSVirtualListName);
+  (0, import_ds_props_helpers.useValidateTypescriptPropTypes)(props, propTypes, import_constants.DSVirtualListName);
 };
 //# 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 DSVirtualListT } from '../react-desc-prop-types.js';\nimport { DSVirtualListName } from '../DSVirtualListDefinitions.js';\n\nexport const useValidateProps = (props: DSVirtualListT.InternalProps, propTypes: WeakValidationMap<unknown>): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSVirtualListName);\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA+C;AAG/C,sCAAkC;AAE3B,MAAM,mBAAmB,CAAC,OAAqC,cAAgD;AAEpH,8DAA+B,OAAO,WAAW,iDAAiB;AACpE;",
+  "sourcesContent": ["import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { WeakValidationMap } from 'react';\nimport { type DSVirtualListT } from '../react-desc-prop-types.js';\nimport { DSVirtualListName } from '../constants/index.js';\n\nexport const useValidateProps = (props: DSVirtualListT.InternalProps, propTypes: WeakValidationMap<unknown>): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSVirtualListName);\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA+C;AAG/C,uBAAkC;AAE3B,MAAM,mBAAmB,CAAC,OAAqC,cAAgD;AAEpH,8DAA+B,OAAO,WAAW,kCAAiB;AACpE;",
   "names": []
 }

package/dist/cjs/hooks/useVirtualList.js

@@ -55,7 +55,18 @@ const useVirtualListV3 = (propsFromUser) => {
     estimateSize
   });
   const totalSize = useVirtualHelpers.getTotalSize();
-  if (actionRef && actionRef.current) actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;
+  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 indices = [];
+      for (let index = range.startIndex; index <= range.endIndex; index += 1) indices.push(index);
+      return indices;
+    };
+    actionRef.current.getMountedItems = () => useVirtualHelpers.getVirtualItems().map((item) => item.index);
+  }
   const instanceUid = import_react.default.useMemo(() => `ds-virtual-list-${(0, import_uid.uid)(6)}`, []);
   return import_react.default.useMemo(
     () => ({

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/useVirtualList.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useVirtualizer, type Virtualizer } from '@tanstack/react-virtual';\nimport React from 'react';\nimport { uid } from 'uid';\nimport { DSVirtualListPropTypes, defaultProps, type DSVirtualListT } from '../react-desc-prop-types.js';\nimport { useValidateProps } from './useValidateProps.js';\n\nconst estimateSize = () => 50;\n\nexport type VirtualListCTX = {\n  instanceUid: string;\n  filteredChildren: React.ReactNode[];\n  propsWithDefault: DSVirtualListT.InternalProps;\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 useVirtualListV3 = (propsFromUser: DSVirtualListT.Props): VirtualListCTX => {\n  // =============================================================================\n  // MERGE WITH DEFAULT AND VALIDATE PROPS\n  // =============================================================================\n  const propsWithDefault = useMemoMergePropsWithDefault<DSVirtualListT.InternalProps>(propsFromUser, defaultProps);\n  useValidateProps(propsWithDefault, DSVirtualListPropTypes);\n  // =============================================================================\n  // AD HOC PER COMPONENT LOGIC\n  // =============================================================================\n  const { children, actionRef } = propsWithDefault;\n  const parentRef = React.useRef<HTMLDivElement>(null);\n  const filteredChildren = React.useMemo(\n    () => React.Children.toArray(children).filter((child) => child !== undefined && child !== null),\n    [children],\n  ) as React.ReactNode[];\n  const useVirtualHelpers = useVirtualizer({\n    count: filteredChildren.length,\n    getScrollElement: () => parentRef.current,\n    overscan: 15,\n    estimateSize,\n  });\n  const totalSize = useVirtualHelpers.getTotalSize();\n  if (actionRef && actionRef.current) actionRef.current.scrollTo = useVirtualHelpers.scrollToIndex;\n\n  const instanceUid = React.useMemo(() => `ds-virtual-list-${uid(6)}`, []);\n  return React.useMemo(\n    () => ({\n      instanceUid,\n      filteredChildren,\n      propsWithDefault,\n      parentRef,\n      getVirtualItems: useVirtualHelpers.getVirtualItems,\n      totalSize,\n      measureElement: useVirtualHelpers.measureElement,\n    }),\n    [\n      useVirtualHelpers.getVirtualItems,\n      useVirtualHelpers.measureElement,\n      filteredChildren,\n      totalSize,\n      instanceUid,\n      propsWithDefault,\n    ],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA6C;AAC7C,2BAAiD;AACjD,mBAAkB;AAClB,iBAAoB;AACpB,mCAA0E;AAC1E,8BAAiC;AAEjC,MAAM,eAAe,MAAM;AAWpB,MAAM,mBAAmB,CAAC,kBAAwD;AAIvF,QAAM,uBAAmB,sDAA2D,eAAe,yCAAY;AAC/G,gDAAiB,kBAAkB,mDAAsB;AAIzD,QAAM,EAAE,UAAU,UAAU,IAAI;AAChC,QAAM,YAAY,aAAAA,QAAM,OAAuB,IAAI;AACnD,QAAM,mBAAmB,aAAAA,QAAM;AAAA,IAC7B,MAAM,aAAAA,QAAM,SAAS,QAAQ,QAAQ,EAAE,OAAO,CAAC,UAAU,UAAU,UAAa,UAAU,IAAI;AAAA,IAC9F,CAAC,QAAQ;AAAA,EACX;AACA,QAAM,wBAAoB,qCAAe;AAAA,IACvC,OAAO,iBAAiB;AAAA,IACxB,kBAAkB,MAAM,UAAU;AAAA,IAClC,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACD,QAAM,YAAY,kBAAkB,aAAa;AACjD,MAAI,aAAa,UAAU,QAAS,WAAU,QAAQ,WAAW,kBAAkB;AAEnF,QAAM,cAAc,aAAAA,QAAM,QAAQ,MAAM,uBAAmB,gBAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AACvE,SAAO,aAAAA,QAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,iBAAiB,kBAAkB;AAAA,MACnC;AAAA,MACA,gBAAgB,kBAAkB;AAAA,IACpC;AAAA,IACA;AAAA,MACE,kBAAkB;AAAA,MAClB,kBAAkB;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';\nimport { useVirtualizer, type Virtualizer } from '@tanstack/react-virtual';\nimport React from 'react';\nimport { uid } from 'uid';\nimport { DSVirtualListPropTypes, defaultProps, type DSVirtualListT } from '../react-desc-prop-types.js';\nimport { useValidateProps } from './useValidateProps.js';\n\nconst estimateSize = () => 50;\n\nexport type VirtualListCTX = {\n  instanceUid: string;\n  filteredChildren: React.ReactNode[];\n  propsWithDefault: DSVirtualListT.InternalProps;\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 useVirtualListV3 = (propsFromUser: DSVirtualListT.Props): VirtualListCTX => {\n  // =============================================================================\n  // MERGE WITH DEFAULT AND VALIDATE PROPS\n  // =============================================================================\n  const propsWithDefault = useMemoMergePropsWithDefault<DSVirtualListT.InternalProps>(propsFromUser, defaultProps);\n  useValidateProps(propsWithDefault, DSVirtualListPropTypes);\n  // =============================================================================\n  // AD HOC PER COMPONENT LOGIC\n  // =============================================================================\n  const { children, actionRef } = propsWithDefault;\n  const parentRef = React.useRef<HTMLDivElement>(null);\n  const filteredChildren = React.useMemo(\n    () => React.Children.toArray(children).filter((child) => child !== undefined && child !== null),\n    [children],\n  ) as React.ReactNode[];\n  const useVirtualHelpers = useVirtualizer({\n    count: filteredChildren.length,\n    getScrollElement: () => parentRef.current,\n    overscan: 15,\n    estimateSize,\n  });\n  const totalSize = useVirtualHelpers.getTotalSize();\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      const indices: number[] = [];\n      for (let index = range.startIndex; index <= range.endIndex; index += 1) indices.push(index);\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  }\n\n  const instanceUid = React.useMemo(() => `ds-virtual-list-${uid(6)}`, []);\n  return React.useMemo(\n    () => ({\n      instanceUid,\n      filteredChildren,\n      propsWithDefault,\n      parentRef,\n      getVirtualItems: useVirtualHelpers.getVirtualItems,\n      totalSize,\n      measureElement: useVirtualHelpers.measureElement,\n    }),\n    [\n      useVirtualHelpers.getVirtualItems,\n      useVirtualHelpers.measureElement,\n      filteredChildren,\n      totalSize,\n      instanceUid,\n      propsWithDefault,\n    ],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,8BAA6C;AAC7C,2BAAiD;AACjD,mBAAkB;AAClB,iBAAoB;AACpB,mCAA0E;AAC1E,8BAAiC;AAEjC,MAAM,eAAe,MAAM;AAWpB,MAAM,mBAAmB,CAAC,kBAAwD;AAIvF,QAAM,uBAAmB,sDAA2D,eAAe,yCAAY;AAC/G,gDAAiB,kBAAkB,mDAAsB;AAIzD,QAAM,EAAE,UAAU,UAAU,IAAI;AAChC,QAAM,YAAY,aAAAA,QAAM,OAAuB,IAAI;AACnD,QAAM,mBAAmB,aAAAA,QAAM;AAAA,IAC7B,MAAM,aAAAA,QAAM,SAAS,QAAQ,QAAQ,EAAE,OAAO,CAAC,UAAU,UAAU,UAAa,UAAU,IAAI;AAAA,IAC9F,CAAC,QAAQ;AAAA,EACX;AACA,QAAM,wBAAoB,qCAAe;AAAA,IACvC,OAAO,iBAAiB;AAAA,IACxB,kBAAkB,MAAM,UAAU;AAAA,IAClC,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACD,QAAM,YAAY,kBAAkB,aAAa;AACjD,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;AACpB,YAAM,UAAoB,CAAC;AAC3B,eAAS,QAAQ,MAAM,YAAY,SAAS,MAAM,UAAU,SAAS,EAAG,SAAQ,KAAK,KAAK;AAC1F,aAAO;AAAA,IACT;AAGA,cAAU,QAAQ,kBAAkB,MAAM,kBAAkB,gBAAgB,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK;AAAA,EACxG;AAEA,QAAM,cAAc,aAAAA,QAAM,QAAQ,MAAM,uBAAmB,gBAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AACvE,SAAO,aAAAA,QAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,iBAAiB,kBAAkB;AAAA,MACnC;AAAA,MACA,gBAAgB,kBAAkB;AAAA,IACpC;AAAA,IACA;AAAA,MACE,kBAAkB;AAAA,MAClB,kBAAkB;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;",
   "names": ["React"]
 }

package/dist/cjs/index.js

@@ -29,12 +29,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DSVirtualList: () => import_VirtualList.DSVirtualList,
-  DSVirtualListName: () => import_DSVirtualListDefinitions.DSVirtualListName,
-  DSVirtualListSlots: () => import_DSVirtualListDefinitions.DSVirtualListSlots,
+  DSVirtualListDataTestIds: () => import_constants.DSVirtualListDataTestIds,
+  DSVirtualListName: () => import_constants.DSVirtualListName,
+  DSVirtualListSlots: () => import_constants.DSVirtualListSlots,
   DSVirtualListWithSchema: () => import_VirtualList.DSVirtualListWithSchema
 });
 module.exports = __toCommonJS(index_exports);
 var React = __toESM(require("react"));
 var import_VirtualList = require("./VirtualList.js");
-var import_DSVirtualListDefinitions = require("./DSVirtualListDefinitions.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 DSVirtualListT } from './react-desc-prop-types.js';\nexport { DSVirtualList, DSVirtualListWithSchema } from './VirtualList.js';\nexport { DSVirtualListName, DSVirtualListSlots } from './DSVirtualListDefinitions.js';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADCvB,yBAAuD;AACvD,sCAAsD;",
+  "sourcesContent": ["export { type DSVirtualListT } from './react-desc-prop-types.js';\nexport { DSVirtualList, DSVirtualListWithSchema } from './VirtualList.js';\nexport { DSVirtualListName, DSVirtualListSlots, DSVirtualListDataTestIds } 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,yBAAuD;AACvD,uBAAgF;",
   "names": []
 }

package/dist/cjs/parts/List.js

@@ -35,7 +35,7 @@ var React = __toESM(require("react"));
 var import_jsx_runtime = require("react/jsx-runtime");
 var import_react = __toESM(require("react"));
 var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
-var import_VirtualListDataTestID = require("../VirtualListDataTestID.js");
+var import_constants = require("../constants/index.js");
 var import_useVirtualList = require("../hooks/useVirtualList.js");
 var import_styled = require("./styled.js");
 const List = (props) => {
@@ -46,13 +46,15 @@ const List = (props) => {
     [measureElement]
   );
   const ownerPropsConfig = (0, import_ds_props_helpers.useOwnerProps)(propsWithDefault);
+  const globalAttributes = (0, import_ds_props_helpers.useGetGlobalAttributes)(propsWithDefault);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     import_styled.StyledWrapper,
     {
       innerRef: parentRef,
-      "data-testid": import_VirtualListDataTestID.LIST_DATA_TESTID.CONTAINER,
+      "data-testid": import_constants.DSVirtualListDataTestIds.ROOT,
       role: "list",
       ...ownerPropsConfig,
+      ...globalAttributes,
       children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_styled.StyledListWrapper, { height: totalSize, ...ownerPropsConfig, children: virtualItems.map((virtualItem) => {
         const { index, start, key } = virtualItem;
         return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(

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 from 'react';\nimport { useOwnerProps } from '@elliemae/ds-props-helpers';\nimport { LIST_DATA_TESTID } from '../VirtualListDataTestID.js';\nimport { useVirtualListV3 } from '../hooks/useVirtualList.js';\nimport type { DSVirtualListT } from '../react-desc-prop-types.js';\nimport { StyledWrapper, StyledListWrapper, StyledItemWrapper } from './styled.js';\n\nexport const List = (props: DSVirtualListT.Props) => {\n  const { parentRef, getVirtualItems, filteredChildren, totalSize, instanceUid, measureElement, propsWithDefault } =\n    useVirtualListV3(props);\n  const virtualItems = getVirtualItems();\n  const measureRef: React.LegacyRef<HTMLDivElement> = React.useCallback(\n    (node: HTMLDivElement) => measureElement(node),\n    [measureElement],\n  );\n\n  const ownerPropsConfig = useOwnerProps(propsWithDefault);\n\n  return (\n    <StyledWrapper\n      key={instanceUid}\n      innerRef={parentRef}\n      data-testid={LIST_DATA_TESTID.CONTAINER}\n      role=\"list\"\n      {...ownerPropsConfig}\n    >\n      <StyledListWrapper height={totalSize} {...ownerPropsConfig}>\n        {virtualItems.map((virtualItem) => {\n          const { index, start, key } = virtualItem;\n          return (\n            <StyledItemWrapper\n              innerRef={measureRef}\n              data-index={index}\n              start={start}\n              role=\"listitem\"\n              key={`${instanceUid}-item-${key}`}\n              {...ownerPropsConfig}\n            >\n              {filteredChildren[index]}\n            </StyledItemWrapper>\n          );\n        })}\n      </StyledListWrapper>\n    </StyledWrapper>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;AD8BX;AA9BZ,mBAAkB;AAClB,8BAA8B;AAC9B,mCAAiC;AACjC,4BAAiC;AAEjC,oBAAoE;AAE7D,MAAM,OAAO,CAAC,UAAgC;AACnD,QAAM,EAAE,WAAW,iBAAiB,kBAAkB,WAAW,aAAa,gBAAgB,iBAAiB,QAC7G,wCAAiB,KAAK;AACxB,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8C,aAAAA,QAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,uBAAmB,uCAAc,gBAAgB;AAEvD,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,UAAU;AAAA,MACV,eAAa,8CAAiB;AAAA,MAC9B,MAAK;AAAA,MACJ,GAAG;AAAA,MAEJ,sDAAC,mCAAkB,QAAQ,WAAY,GAAG,kBACvC,uBAAa,IAAI,CAAC,gBAAgB;AACjC,cAAM,EAAE,OAAO,OAAO,IAAI,IAAI;AAC9B,eACE;AAAA,UAAC;AAAA;AAAA,YACC,UAAU;AAAA,YACV,cAAY;AAAA,YACZ;AAAA,YACA,MAAK;AAAA,YAEJ,GAAG;AAAA,YAEH,2BAAiB,KAAK;AAAA;AAAA,UAHlB,GAAG,WAAW,SAAS,GAAG;AAAA,QAIjC;AAAA,MAEJ,CAAC,GACH;AAAA;AAAA,IAtBK;AAAA,EAuBP;AAEJ;",
+  "sourcesContent": ["import React from 'react';\nimport { useOwnerProps, useGetGlobalAttributes } from '@elliemae/ds-props-helpers';\nimport { DSVirtualListDataTestIds } from '../constants/index.js';\nimport { useVirtualListV3 } from '../hooks/useVirtualList.js';\nimport type { DSVirtualListT } from '../react-desc-prop-types.js';\nimport { StyledWrapper, StyledListWrapper, StyledItemWrapper } from './styled.js';\n\nexport const List = (props: DSVirtualListT.Props) => {\n  const { parentRef, getVirtualItems, filteredChildren, totalSize, instanceUid, measureElement, propsWithDefault } =\n    useVirtualListV3(props);\n  const virtualItems = getVirtualItems();\n  const measureRef: React.LegacyRef<HTMLDivElement> = React.useCallback(\n    (node: HTMLDivElement) => measureElement(node),\n    [measureElement],\n  );\n\n  const ownerPropsConfig = useOwnerProps(propsWithDefault);\n  const globalAttributes = useGetGlobalAttributes(propsWithDefault);\n\n  return (\n    <StyledWrapper\n      key={instanceUid}\n      innerRef={parentRef}\n      data-testid={DSVirtualListDataTestIds.ROOT}\n      role=\"list\"\n      {...ownerPropsConfig}\n      {...globalAttributes}\n    >\n      <StyledListWrapper height={totalSize} {...ownerPropsConfig}>\n        {virtualItems.map((virtualItem) => {\n          const { index, start, key } = virtualItem;\n          return (\n            <StyledItemWrapper\n              innerRef={measureRef}\n              data-index={index}\n              start={start}\n              role=\"listitem\"\n              key={`${instanceUid}-item-${key}`}\n              {...ownerPropsConfig}\n            >\n              {filteredChildren[index]}\n            </StyledItemWrapper>\n          );\n        })}\n      </StyledListWrapper>\n    </StyledWrapper>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADgCX;AAhCZ,mBAAkB;AAClB,8BAAsD;AACtD,uBAAyC;AACzC,4BAAiC;AAEjC,oBAAoE;AAE7D,MAAM,OAAO,CAAC,UAAgC;AACnD,QAAM,EAAE,WAAW,iBAAiB,kBAAkB,WAAW,aAAa,gBAAgB,iBAAiB,QAC7G,wCAAiB,KAAK;AACxB,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8C,aAAAA,QAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,uBAAmB,uCAAc,gBAAgB;AACvD,QAAM,uBAAmB,gDAAuB,gBAAgB;AAEhE,SACE;AAAA,IAAC;AAAA;AAAA,MAEC,UAAU;AAAA,MACV,eAAa,0CAAyB;AAAA,MACtC,MAAK;AAAA,MACJ,GAAG;AAAA,MACH,GAAG;AAAA,MAEJ,sDAAC,mCAAkB,QAAQ,WAAY,GAAG,kBACvC,uBAAa,IAAI,CAAC,gBAAgB;AACjC,cAAM,EAAE,OAAO,OAAO,IAAI,IAAI;AAC9B,eACE;AAAA,UAAC;AAAA;AAAA,YACC,UAAU;AAAA,YACV,cAAY;AAAA,YACZ;AAAA,YACA,MAAK;AAAA,YAEJ,GAAG;AAAA,YAEH,2BAAiB,KAAK;AAAA;AAAA,UAHlB,GAAG,WAAW,SAAS,GAAG;AAAA,QAIjC;AAAA,MAEJ,CAAC,GACH;AAAA;AAAA,IAvBK;AAAA,EAwBP;AAEJ;",
   "names": ["React"]
 }

package/dist/cjs/parts/styled.js

@@ -35,19 +35,19 @@ __export(styled_exports, {
 module.exports = __toCommonJS(styled_exports);
 var React = __toESM(require("react"));
 var import_ds_system = require("@elliemae/ds-system");
-var import_DSVirtualListDefinitions = require("../DSVirtualListDefinitions.js");
-const StyledWrapper = (0, import_ds_system.styled)("div", { name: import_DSVirtualListDefinitions.DSVirtualListName, slot: import_DSVirtualListDefinitions.DSVirtualListSlots.ROOT })`
+var import_constants = require("../constants/index.js");
+const StyledWrapper = (0, import_ds_system.styled)("div", { name: import_constants.DSVirtualListName, slot: import_constants.DSVirtualListSlots.ROOT })`
   width: 100%;
   height: 100%;
   padding-bottom: 0;
   overflow: auto;
 `;
-const StyledListWrapper = (0, import_ds_system.styled)("div", { name: import_DSVirtualListDefinitions.DSVirtualListName, slot: import_DSVirtualListDefinitions.DSVirtualListSlots.LIST_WRAPPER })`
+const StyledListWrapper = (0, import_ds_system.styled)("div", { name: import_constants.DSVirtualListName, slot: import_constants.DSVirtualListSlots.LIST_WRAPPER })`
   width: 100%;
   height: ${({ height }) => `${height}px`};
   position: relative;
 `;
-const StyledItemWrapper = (0, import_ds_system.styled)("div", { name: import_DSVirtualListDefinitions.DSVirtualListName, slot: import_DSVirtualListDefinitions.DSVirtualListSlots.ITEM_WRAPPER })`
+const StyledItemWrapper = (0, import_ds_system.styled)("div", { name: import_constants.DSVirtualListName, slot: import_constants.DSVirtualListSlots.ITEM_WRAPPER })`
   position: absolute;
   top: 0;
   left: 0;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/parts/styled.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["import { styled } from '@elliemae/ds-system';\nimport { DSVirtualListName, DSVirtualListSlots } from '../DSVirtualListDefinitions.js';\n\nexport const StyledWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.ROOT })`\n  width: 100%;\n  height: 100%;\n  padding-bottom: 0;\n  overflow: auto;\n`;\n\nexport const StyledListWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.LIST_WRAPPER })<{\n  height: number;\n}>`\n  width: 100%;\n  height: ${({ height }) => `${height}px`};\n  position: relative;\n`;\n\nexport const StyledItemWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.ITEM_WRAPPER })<{\n  start: number;\n}>`\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n  transform: ${({ start }) => `translateY(${start}px)`};\n`;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAuB;AACvB,sCAAsD;AAE/C,MAAM,oBAAgB,yBAAO,OAAO,EAAE,MAAM,mDAAmB,MAAM,mDAAmB,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAO9F,MAAM,wBAAoB,yBAAO,OAAO,EAAE,MAAM,mDAAmB,MAAM,mDAAmB,aAAa,CAAC;AAAA;AAAA,YAIrG,CAAC,EAAE,OAAO,MAAM,GAAG,MAAM,IAAI;AAAA;AAAA;AAIlC,MAAM,wBAAoB,yBAAO,OAAO,EAAE,MAAM,mDAAmB,MAAM,mDAAmB,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,eAOlG,CAAC,EAAE,MAAM,MAAM,cAAc,KAAK,KAAK;AAAA;",
+  "sourcesContent": ["import { styled } from '@elliemae/ds-system';\nimport { DSVirtualListName, DSVirtualListSlots } from '../constants/index.js';\n\nexport const StyledWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.ROOT })`\n  width: 100%;\n  height: 100%;\n  padding-bottom: 0;\n  overflow: auto;\n`;\n\nexport const StyledListWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.LIST_WRAPPER })<{\n  height: number;\n}>`\n  width: 100%;\n  height: ${({ height }) => `${height}px`};\n  position: relative;\n`;\n\nexport const StyledItemWrapper = styled('div', { name: DSVirtualListName, slot: DSVirtualListSlots.ITEM_WRAPPER })<{\n  start: number;\n}>`\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n  transform: ${({ start }) => `translateY(${start}px)`};\n`;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,uBAAuB;AACvB,uBAAsD;AAE/C,MAAM,oBAAgB,yBAAO,OAAO,EAAE,MAAM,oCAAmB,MAAM,oCAAmB,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAO9F,MAAM,wBAAoB,yBAAO,OAAO,EAAE,MAAM,oCAAmB,MAAM,oCAAmB,aAAa,CAAC;AAAA;AAAA,YAIrG,CAAC,EAAE,OAAO,MAAM,GAAG,MAAM,IAAI;AAAA;AAAA;AAIlC,MAAM,wBAAoB,yBAAO,OAAO,EAAE,MAAM,oCAAmB,MAAM,oCAAmB,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,eAOlG,CAAC,EAAE,MAAM,MAAM,cAAc,KAAK,KAAK;AAAA;",
   "names": []
 }

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

@@ -34,16 +34,22 @@ __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_DSVirtualListDefinitions = require("./DSVirtualListDefinitions.js");
+var import_constants = require("./constants/index.js");
 const defaultProps = {};
 const DSVirtualListPropTypes = {
-  ...(0, import_ds_props_helpers.getPropsPerSlotPropTypes)(import_DSVirtualListDefinitions.DSVirtualListName, import_DSVirtualListDefinitions.DSVirtualListSlots),
+  ...(0, import_ds_props_helpers.getPropsPerSlotPropTypes)(import_constants.DSVirtualListName, import_constants.DSVirtualListSlots),
+  ...import_ds_props_helpers.globalAttributesPropTypes,
   children: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.node).description("Children list").isRequired,
   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, { align: 'start' | 'center' | 'end' | 'auto' }) => 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[])`)
       })
     ])
   }).description(`mutable reference where methods will be stored`)

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 type React from 'react';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport { PropTypes, getPropsPerSlotPropTypes } from '@elliemae/ds-props-helpers';\nimport { DSVirtualListName, DSVirtualListSlots } from './DSVirtualListDefinitions.js';\n\nexport declare namespace DSVirtualListT {\n  type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';\n  type ScrollToOptions = {\n    align: ScrollAlignment;\n  };\n\n  export type ActionRef = {\n    scrollTo?: (index: number, options?: ScrollToOptions | undefined) => void;\n  };\n  export interface RequiredProps {\n    children: React.ReactNode;\n  }\n\n  export interface DefaultProps {}\n\n  export interface OptionalProps extends TypescriptHelpersT.PropsForGlobalOnSlots<\n    typeof DSVirtualListName,\n    typeof DSVirtualListSlots\n  > {\n    actionRef: React.MutableRefObject<ActionRef>;\n  }\n\n  export interface Props extends Partial<DefaultProps>, OptionalProps, RequiredProps {}\n\n  export interface InternalProps extends DefaultProps, OptionalProps, RequiredProps {}\n}\n\nexport const defaultProps: DSVirtualListT.DefaultProps = {};\n\nexport const DSVirtualListPropTypes = {\n  ...getPropsPerSlotPropTypes(DSVirtualListName, DSVirtualListSlots),\n  children: PropTypes.arrayOf(PropTypes.node).description('Children list').isRequired,\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} as React.WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEvB,8BAAoD;AACpD,sCAAsD;AA6B/C,MAAM,eAA4C,CAAC;AAEnD,MAAM,yBAAyB;AAAA,EACpC,OAAG,kDAAyB,mDAAmB,kDAAkB;AAAA,EACjE,UAAU,kCAAU,QAAQ,kCAAU,IAAI,EAAE,YAAY,eAAe,EAAE;AAAA,EACzE,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;AACjE;",
+  "sourcesContent": ["import type React from 'react';\nimport { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';\nimport type { GlobalAttributesT } from '@elliemae/ds-props-helpers';\nimport { PropTypes, getPropsPerSlotPropTypes, globalAttributesPropTypes } from '@elliemae/ds-props-helpers';\nimport { DSVirtualListName, DSVirtualListSlots } from './constants/index.js';\n\nexport declare namespace DSVirtualListT {\n  type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';\n  type ScrollToOptions = {\n    align: ScrollAlignment;\n  };\n\n  export type ActionRef = {\n    scrollTo?: (index: number, options?: ScrollToOptions | undefined) => void;\n    measure?: () => void;\n    getVisibleItems?: () => number[];\n    getMountedItems?: () => number[];\n  };\n\n  export type SlotFunctionArguments = {\n    dsVirtuallistRoot: () => object;\n    dsVirtuallistListWrapper: () => object;\n    dsVirtuallistItemWrapper: () => object;\n  };\n\n  export interface RequiredProps {\n    children: React.ReactNode;\n  }\n\n  export interface DefaultProps {}\n\n  export interface OptionalProps extends TypescriptHelpersT.PropsForGlobalOnSlots<\n    typeof DSVirtualListName,\n    typeof DSVirtualListSlots\n  > {\n    actionRef?: React.MutableRefObject<ActionRef>;\n  }\n\n  export interface Props\n    extends\n      Partial<DefaultProps>,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLElement>, keyof DefaultProps | keyof RequiredProps>,\n      RequiredProps {}\n\n  export interface InternalProps\n    extends\n      DefaultProps,\n      OptionalProps,\n      Omit<GlobalAttributesT<HTMLElement>, keyof DefaultProps | keyof RequiredProps>,\n      RequiredProps {}\n}\n\nexport const defaultProps: DSVirtualListT.DefaultProps = {};\n\nexport const DSVirtualListPropTypes = {\n  ...getPropsPerSlotPropTypes(DSVirtualListName, DSVirtualListSlots),\n  ...globalAttributesPropTypes,\n  children: PropTypes.arrayOf(PropTypes.node).description('Children list').isRequired,\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        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      }),\n    ]),\n  }).description(`mutable reference where methods will be stored`),\n} as React.WeakValidationMap<unknown>;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADGvB,8BAA+E;AAC/E,uBAAsD;AAiD/C,MAAM,eAA4C,CAAC;AAEnD,MAAM,yBAAyB;AAAA,EACpC,OAAG,kDAAyB,oCAAmB,mCAAkB;AAAA,EACjE,GAAG;AAAA,EACH,UAAU,kCAAU,QAAQ,kCAAU,IAAI,EAAE,YAAY,eAAe,EAAE;AAAA,EACzE,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,QACxF,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,MACjC,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC,EAAE,YAAY,gDAAgD;AACjE;",
   "names": []
 }

package/dist/cjs/{VirtualListDataTestID.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,16 @@ 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 VirtualListDataTestID_exports = {};
-__export(VirtualListDataTestID_exports, {
-  LIST_DATA_TESTID: () => LIST_DATA_TESTID
-});
-module.exports = __toCommonJS(VirtualListDataTestID_exports);
 var React = __toESM(require("react"));
-const LIST_DATA_TESTID = {
-  CONTAINER: "virtual-list-container"
+const SlotPropsAsObject = {
+  dsVirtuallistRoot: { "aria-label": "just a typescript test" },
+  dsVirtuallistListWrapper: { "aria-label": "just a typescript test" },
+  dsVirtuallistItemWrapper: { "aria-label": "just a typescript test" }
+};
+const SlotPropsAsFunctions = {
+  dsVirtuallistRoot: () => ({ "aria-label": "just a typescript test" }),
+  dsVirtuallistListWrapper: () => ({ "aria-label": "just a typescript test" }),
+  dsVirtuallistItemWrapper: () => ({ "aria-label": "just a typescript test" })
 };
-//# sourceMappingURL=VirtualListDataTestID.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 { DSVirtualListName, DSVirtualListSlots } from '../constants/index.js';\nimport type { DSVirtualListT } from '../react-desc-prop-types.js';\n\nconst SlotPropsAsObject: Partial<DSVirtualListT.Props> = {\n  dsVirtuallistRoot: { 'aria-label': 'just a typescript test' },\n  dsVirtuallistListWrapper: { 'aria-label': 'just a typescript test' },\n  dsVirtuallistItemWrapper: { 'aria-label': 'just a typescript test' },\n};\n\nconst SlotPropsAsFunctions: DSVirtualListT.SlotFunctionArguments = {\n  dsVirtuallistRoot: () => ({ 'aria-label': 'just a typescript test' }),\n  dsVirtuallistListWrapper: () => ({ 'aria-label': 'just a typescript test' }),\n  dsVirtuallistItemWrapper: () => ({ '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 DSVirtualListName, typeof DSVirtualListSlots>\n> = SlotPropsAsFunctions;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,YAAuB;ACMvB,MAAM,oBAAmD;AAAA,EACvD,mBAAmB,EAAE,cAAc,yBAAyB;AAAA,EAC5D,0BAA0B,EAAE,cAAc,yBAAyB;AAAA,EACnE,0BAA0B,EAAE,cAAc,yBAAyB;AACrE;AAEA,MAAM,uBAA6D;AAAA,EACjE,mBAAmB,OAAO,EAAE,cAAc,yBAAyB;AAAA,EACnE,0BAA0B,OAAO,EAAE,cAAc,yBAAyB;AAAA,EAC1E,0BAA0B,OAAO,EAAE,cAAc,yBAAyB;AAC5E;AAGA,MAAM,6CAEF;",
+  "names": []
+}

package/dist/cjs/typescript-testing/typescript-virtual-list-valid.js

@@ -0,0 +1,114 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var typescript_virtual_list_valid_exports = {};
+__export(typescript_virtual_list_valid_exports, {
+  default: () => typescript_virtual_list_valid_default
+});
+module.exports = __toCommonJS(typescript_virtual_list_valid_exports);
+var React = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_VirtualList = require("../VirtualList.js");
+const testRequiredProps = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0")]
+};
+const testOptionalProps = {};
+const testPartialDefaults = {};
+const testProps = {
+  ...testRequiredProps,
+  ...testOptionalProps,
+  ...testPartialDefaults
+};
+const testPropsAsSyntax = {
+  ...testRequiredProps,
+  ...testOptionalProps,
+  ...testPartialDefaults
+};
+const testCompleteDefaults = {};
+const testInternalProps = {
+  ...testRequiredProps,
+  ...testOptionalProps,
+  ...testCompleteDefaults
+};
+const testInternalPropsAsSyntax = {
+  ...testRequiredProps,
+  ...testOptionalProps,
+  ...testCompleteDefaults
+};
+const actionRef = { current: {} };
+const testExplicitDefinition = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0"), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 1" }, "1")],
+  actionRef
+};
+const testInferredTypeCompatibility = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0"), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 1" }, "1")],
+  actionRef
+};
+const testDefinitionAsConst = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0"), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 1" }, "1")]
+};
+const testSlotPropsAsObject = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0")],
+  dsVirtuallistRoot: { "aria-label": "items list" },
+  dsVirtuallistListWrapper: { "aria-label": "items list wrapper" },
+  dsVirtuallistItemWrapper: { "aria-label": "item wrapper" }
+};
+const testGlobalAttributes = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0")],
+  className: "custom-class",
+  id: "custom-id",
+  "aria-label": "custom list"
+};
+const testSlotPropsAsFunctions = {
+  children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0")],
+  dsVirtuallistRoot: () => ({ "aria-label": "items list" }),
+  dsVirtuallistListWrapper: () => ({ "aria-label": "items list wrapper" }),
+  dsVirtuallistItemWrapper: () => ({ "aria-label": "item wrapper" })
+};
+const handleMeasure = () => actionRef.current.measure?.();
+const handleGetVisibleItems = () => actionRef.current.getVisibleItems?.() ?? [];
+const handleGetMountedItems = () => actionRef.current.getMountedItems?.() ?? [];
+const ExampleUsageComponent = () => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testExplicitDefinition }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testInferredTypeCompatibility }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testDefinitionAsConst }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testSlotPropsAsObject }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testSlotPropsAsFunctions }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { ...testGlobalAttributes }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_VirtualList.DSVirtualList, { className: "custom-class", id: "custom-id", "aria-label": "custom list", "data-testid": "custom-testid", children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }, "0")] }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_VirtualList.DSVirtualList, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 1" })
+  ] }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_VirtualList.DSVirtualList, { actionRef, dsVirtuallistRoot: { tabIndex: 0 }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 0" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: "item 1" })
+  ] })
+] });
+var typescript_virtual_list_valid_default = ExampleUsageComponent;
+//# sourceMappingURL=typescript-virtual-list-valid.js.map

package/dist/cjs/typescript-testing/typescript-virtual-list-valid.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/typescript-testing/typescript-virtual-list-valid.tsx", "../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */\n/* eslint-disable local-rules/custom-rule */\nimport React from 'react';\nimport { DSVirtualList } from '../VirtualList.js';\nimport type { DSVirtualListT } from '../react-desc-prop-types.js';\n\ntype ComponentPropsForApp = DSVirtualListT.Props;\ntype ComponentPropsInternals = DSVirtualListT.InternalProps;\ntype ComponentPropsDefaultProps = DSVirtualListT.DefaultProps;\ntype ComponentPropsOptionalProps = DSVirtualListT.OptionalProps;\ntype ComponentPropsRequiredProps = DSVirtualListT.RequiredProps;\n\n// NOTE: `children` is typed as `React.ReactNode` (accepts a single element or an array), but\n// `DSVirtualListPropTypes.children` is `PropTypes.arrayOf(PropTypes.node).isRequired` \u2014 stricter\n// than the TS type. A single non-array child compiles here but throws at runtime. Every example\n// below passes an array to match the real, enforced contract \u2014 not just what the type permits.\nconst testRequiredProps: ComponentPropsRequiredProps = {\n  children: [<div key=\"0\">item 0</div>],\n};\n\nconst testOptionalProps: ComponentPropsOptionalProps = {};\n\nconst testPartialDefaults: Partial<ComponentPropsDefaultProps> = {};\n\nconst testProps: ComponentPropsForApp = {\n  ...testRequiredProps,\n  ...testOptionalProps,\n  ...testPartialDefaults,\n};\n\nconst testPropsAsSyntax = {\n  ...testRequiredProps,\n  ...testOptionalProps,\n  ...testPartialDefaults,\n} as ComponentPropsForApp;\n\nconst testCompleteDefaults: Required<ComponentPropsDefaultProps> = {};\n\nconst testInternalProps: ComponentPropsInternals = {\n  ...testRequiredProps,\n  ...testOptionalProps,\n  ...testCompleteDefaults,\n};\n\nconst testInternalPropsAsSyntax = {\n  ...testRequiredProps,\n  ...testOptionalProps,\n  ...testCompleteDefaults,\n} as ComponentPropsInternals;\n\n// Example usages start here\nconst actionRef: React.MutableRefObject<DSVirtualListT.ActionRef> = { current: {} };\n\nconst testExplicitDefinition: ComponentPropsForApp = {\n  children: [<div key=\"0\">item 0</div>, <div key=\"1\">item 1</div>],\n  actionRef,\n};\n\nconst testInferredTypeCompatibility = {\n  children: [<div key=\"0\">item 0</div>, <div key=\"1\">item 1</div>],\n  actionRef,\n} as ComponentPropsForApp;\n\nconst testDefinitionAsConst = {\n  children: [<div key=\"0\">item 0</div>, <div key=\"1\">item 1</div>],\n} as const;\n\nconst testSlotPropsAsObject: ComponentPropsForApp = {\n  children: [<div key=\"0\">item 0</div>],\n  dsVirtuallistRoot: { 'aria-label': 'items list' },\n  dsVirtuallistListWrapper: { 'aria-label': 'items list wrapper' },\n  dsVirtuallistItemWrapper: { 'aria-label': 'item wrapper' },\n};\n\n// Global HTML/ARIA attributes (className, id, aria-*, data-*) work at runtime via\n// useGetGlobalAttributes in List.tsx \u2014 Props/InternalProps extend Omit<GlobalAttributesT<HTMLElement>, ...>\n// specifically so this compiles. Regression here means the type/runtime contract has drifted apart again.\nconst testGlobalAttributes: ComponentPropsForApp = {\n  children: [<div key=\"0\">item 0</div>],\n  className: 'custom-class',\n  id: 'custom-id',\n  'aria-label': 'custom list',\n};\n\nconst testSlotPropsAsFunctions: ComponentPropsForApp = {\n  children: [<div key=\"0\">item 0</div>],\n  dsVirtuallistRoot: () => ({ 'aria-label': 'items list' }),\n  dsVirtuallistListWrapper: () => ({ 'aria-label': 'items list wrapper' }),\n  dsVirtuallistItemWrapper: () => ({ 'aria-label': 'item wrapper' }),\n};\n\n// actionRef method usages \u2014 measure() and getVisibleItems() (PUI-17898)\nconst handleMeasure = () => actionRef.current.measure?.();\nconst handleGetVisibleItems: () => number[] = () => actionRef.current.getVisibleItems?.() ?? [];\nconst handleGetMountedItems: () => number[] = () => actionRef.current.getMountedItems?.() ?? [];\n\nconst ExampleUsageComponent = () => (\n  <>\n    {/* Works with explicitly casted props */}\n    <DSVirtualList {...testExplicitDefinition} />\n    <DSVirtualList {...testInferredTypeCompatibility} />\n    <DSVirtualList {...testDefinitionAsConst} />\n    <DSVirtualList {...testSlotPropsAsObject} />\n    <DSVirtualList {...testSlotPropsAsFunctions} />\n    <DSVirtualList {...testGlobalAttributes} />\n\n    {/* Inline props test \u2014 global HTML/ARIA attributes. Array child to match the real, enforced\n        runtime contract \u2014 a single child here would compile but throw (see NOTE above). */}\n    <DSVirtualList className=\"custom-class\" id=\"custom-id\" aria-label=\"custom list\" data-testid=\"custom-testid\">\n      {[<div key=\"0\">item 0</div>]}\n    </DSVirtualList>\n\n    {/* Inline props test \u2014 required prop only. Two children so JSX itself produces an array;\n        a single child here would compile (React.ReactNode) but throw at runtime (see NOTE above). */}\n    <DSVirtualList>\n      <div>item 0</div>\n      <div>item 1</div>\n    </DSVirtualList>\n\n    {/* Inline props test \u2014 actionRef and slot props */}\n    <DSVirtualList actionRef={actionRef} dsVirtuallistRoot={{ tabIndex: 0 }}>\n      <div>item 0</div>\n      <div>item 1</div>\n    </DSVirtualList>\n  </>\n);\n\nexport default ExampleUsageComponent;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADiBV;AAdb,yBAA8B;AAa9B,MAAM,oBAAiD;AAAA,EACrD,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AACtC;AAEA,MAAM,oBAAiD,CAAC;AAExD,MAAM,sBAA2D,CAAC;AAElE,MAAM,YAAkC;AAAA,EACtC,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAEA,MAAM,oBAAoB;AAAA,EACxB,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAEA,MAAM,uBAA6D,CAAC;AAEpE,MAAM,oBAA6C;AAAA,EACjD,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAEA,MAAM,4BAA4B;AAAA,EAChC,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAGA,MAAM,YAA8D,EAAE,SAAS,CAAC,EAAE;AAElF,MAAM,yBAA+C;AAAA,EACnD,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,GAAQ,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AAAA,EAC/D;AACF;AAEA,MAAM,gCAAgC;AAAA,EACpC,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,GAAQ,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AAAA,EAC/D;AACF;AAEA,MAAM,wBAAwB;AAAA,EAC5B,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,GAAQ,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AACjE;AAEA,MAAM,wBAA8C;AAAA,EAClD,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AAAA,EACpC,mBAAmB,EAAE,cAAc,aAAa;AAAA,EAChD,0BAA0B,EAAE,cAAc,qBAAqB;AAAA,EAC/D,0BAA0B,EAAE,cAAc,eAAe;AAC3D;AAKA,MAAM,uBAA6C;AAAA,EACjD,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AAAA,EACpC,WAAW;AAAA,EACX,IAAI;AAAA,EACJ,cAAc;AAChB;AAEA,MAAM,2BAAiD;AAAA,EACrD,UAAU,CAAC,4CAAC,SAAY,sBAAJ,GAAU,CAAM;AAAA,EACpC,mBAAmB,OAAO,EAAE,cAAc,aAAa;AAAA,EACvD,0BAA0B,OAAO,EAAE,cAAc,qBAAqB;AAAA,EACtE,0BAA0B,OAAO,EAAE,cAAc,eAAe;AAClE;AAGA,MAAM,gBAAgB,MAAM,UAAU,QAAQ,UAAU;AACxD,MAAM,wBAAwC,MAAM,UAAU,QAAQ,kBAAkB,KAAK,CAAC;AAC9F,MAAM,wBAAwC,MAAM,UAAU,QAAQ,kBAAkB,KAAK,CAAC;AAE9F,MAAM,wBAAwB,MAC5B,4EAEE;AAAA,8CAAC,oCAAe,GAAG,wBAAwB;AAAA,EAC3C,4CAAC,oCAAe,GAAG,+BAA+B;AAAA,EAClD,4CAAC,oCAAe,GAAG,uBAAuB;AAAA,EAC1C,4CAAC,oCAAe,GAAG,uBAAuB;AAAA,EAC1C,4CAAC,oCAAe,GAAG,0BAA0B;AAAA,EAC7C,4CAAC,oCAAe,GAAG,sBAAsB;AAAA,EAIzC,4CAAC,oCAAc,WAAU,gBAAe,IAAG,aAAY,cAAW,eAAc,eAAY,iBACzF,WAAC,4CAAC,SAAY,sBAAJ,GAAU,CAAM,GAC7B;AAAA,EAIA,6CAAC,oCACC;AAAA,gDAAC,SAAI,oBAAM;AAAA,IACX,4CAAC,SAAI,oBAAM;AAAA,KACb;AAAA,EAGA,6CAAC,oCAAc,WAAsB,mBAAmB,EAAE,UAAU,EAAE,GACpE;AAAA,gDAAC,SAAI,oBAAM;AAAA,IACX,4CAAC,SAAI,oBAAM;AAAA,KACb;AAAA,GACF;AAGF,IAAO,wCAAQ;",
+  "names": []
+}

package/dist/esm/VirtualList.js

@@ -3,7 +3,7 @@ import { jsx } from "react/jsx-runtime";
 import { describe } from "@elliemae/ds-props-helpers";
 import { List } from "./parts/List.js";
 import { DSVirtualListPropTypes } from "./react-desc-prop-types.js";
-import { DSVirtualListName } from "./DSVirtualListDefinitions.js";
+import { DSVirtualListName } from "./constants/index.js";
 const DSVirtualList = (props) => /* @__PURE__ */ jsx(List, { ...props });
 DSVirtualList.displayName = DSVirtualListName;
 const DSVirtualListWithSchema = describe(DSVirtualList).description("DSVirtualList");

package/dist/esm/VirtualList.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/VirtualList.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { List } from './parts/List.js';\nimport { DSVirtualListPropTypes, type DSVirtualListT } from './react-desc-prop-types.js';\nimport { DSVirtualListName } from './DSVirtualListDefinitions.js';\n\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSVirtualList = (props: DSVirtualListT.Props) => <List {...props} />;\n\nDSVirtualList.displayName = DSVirtualListName;\nconst DSVirtualListWithSchema = describe(DSVirtualList).description('DSVirtualList');\nDSVirtualListWithSchema.propTypes = DSVirtualListPropTypes;\n\nexport { DSVirtualList, DSVirtualListWithSchema };\n"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React from 'react';\nimport { describe } from '@elliemae/ds-props-helpers';\nimport { List } from './parts/List.js';\nimport { DSVirtualListPropTypes, type DSVirtualListT } from './react-desc-prop-types.js';\nimport { DSVirtualListName } from './constants/index.js';\n\n// we are not using a context nor zustand so all the logic is handled in List...\nconst DSVirtualList = (props: DSVirtualListT.Props) => <List {...props} />;\n\nDSVirtualList.displayName = DSVirtualListName;\nconst DSVirtualListWithSchema = describe(DSVirtualList).description('DSVirtualList');\nDSVirtualListWithSchema.propTypes = DSVirtualListPropTypes;\n\nexport { DSVirtualList, DSVirtualListWithSchema };\n"],
   "mappings": "AAAA,YAAY,WAAW;ACOgC;AANvD,SAAS,gBAAgB;AACzB,SAAS,YAAY;AACrB,SAAS,8BAAmD;AAC5D,SAAS,yBAAyB;AAGlC,MAAM,gBAAgB,CAAC,UAAgC,oBAAC,QAAM,GAAG,OAAO;AAExE,cAAc,cAAc;AAC5B,MAAM,0BAA0B,SAAS,aAAa,EAAE,YAAY,eAAe;AACnF,wBAAwB,YAAY;",
   "names": []
 }

package/dist/esm/constants/index.js

@@ -0,0 +1,20 @@
+import * as React from "react";
+import { slotObjectToDataTestIds } from "@elliemae/ds-system";
+const DSVirtualListName = "DSVirtuallist";
+const DSVirtualListSlots = {
+  ROOT: "root",
+  // legacy — data-testid preserved below, do not let slot auto-generation replace it
+  LIST_WRAPPER: "list-wrapper",
+  ITEM_WRAPPER: "item-wrapper"
+};
+const DSVirtualListDataTestIds = {
+  ...slotObjectToDataTestIds(DSVirtualListName, DSVirtualListSlots),
+  ROOT: "virtual-list-container"
+  // legacy value — e2e/ds-virtuallist/DSVirtualListCO.js depends on it, breaking change if removed
+};
+export {
+  DSVirtualListDataTestIds,
+  DSVirtualListName,
+  DSVirtualListSlots
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/constants/index.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { slotObjectToDataTestIds } from '@elliemae/ds-system';\n\nexport const DSVirtualListName = 'DSVirtuallist';\n\nexport const DSVirtualListSlots = {\n  ROOT: 'root', // legacy \u2014 data-testid preserved below, do not let slot auto-generation replace it\n  LIST_WRAPPER: 'list-wrapper',\n  ITEM_WRAPPER: 'item-wrapper',\n} as const;\n\nexport const DSVirtualListDataTestIds = {\n  ...slotObjectToDataTestIds(DSVirtualListName, DSVirtualListSlots),\n  ROOT: 'virtual-list-container', // legacy value \u2014 e2e/ds-virtuallist/DSVirtualListCO.js depends on it, breaking change if removed\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,+BAA+B;AAEjC,MAAM,oBAAoB;AAE1B,MAAM,qBAAqB;AAAA,EAChC,MAAM;AAAA;AAAA,EACN,cAAc;AAAA,EACd,cAAc;AAChB;AAEO,MAAM,2BAA2B;AAAA,EACtC,GAAG,wBAAwB,mBAAmB,kBAAkB;AAAA,EAChE,MAAM;AAAA;AACR;",
+  "names": []
+}

package/dist/esm/hooks/useValidateProps.js

@@ -1,6 +1,6 @@
 import * as React from "react";
 import { useValidateTypescriptPropTypes } from "@elliemae/ds-props-helpers";
-import { DSVirtualListName } from "../DSVirtualListDefinitions.js";
+import { DSVirtualListName } from "../constants/index.js";
 const useValidateProps = (props, propTypes) => {
   useValidateTypescriptPropTypes(props, propTypes, DSVirtualListName);
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useValidateProps.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { WeakValidationMap } from 'react';\nimport { type DSVirtualListT } from '../react-desc-prop-types.js';\nimport { DSVirtualListName } from '../DSVirtualListDefinitions.js';\n\nexport const useValidateProps = (props: DSVirtualListT.InternalProps, propTypes: WeakValidationMap<unknown>): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSVirtualListName);\n};\n"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';\nimport type { WeakValidationMap } from 'react';\nimport { type DSVirtualListT } from '../react-desc-prop-types.js';\nimport { DSVirtualListName } from '../constants/index.js';\n\nexport const useValidateProps = (props: DSVirtualListT.InternalProps, propTypes: WeakValidationMap<unknown>): void => {\n  // we validate the \"required if\" via 'isRequiredIf from our custom PropTypes\n  useValidateTypescriptPropTypes(props, propTypes, DSVirtualListName);\n};\n"],
   "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,sCAAsC;AAG/C,SAAS,yBAAyB;AAE3B,MAAM,mBAAmB,CAAC,OAAqC,cAAgD;AAEpH,iCAA+B,OAAO,WAAW,iBAAiB;AACpE;",
   "names": []
 }