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

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

@@ -29,6 +29,9 @@ const data = [1, 2, 3];
 const extraProps = { data };
 const MockItemRenderer = ({ index }) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {});
 const actionRef = (0, import_react.createRef)();
+const innerRefObject = (0, import_react.createRef)();
+const innerRefCallback = (node) => {
+};
 const testRequiredProps = {
   ItemRenderer: MockItemRenderer,
   count: 0,
@@ -36,7 +39,9 @@ const testRequiredProps = {
 };
 const testOptionalProps = {
   actionRef,
-  extraItemProps: { data }
+  extraItemProps: { data },
+  innerRef: innerRefObject,
+  extraContent: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", children: "Load more" })
 };
 const testPartialDefaults = {};
 const testProps = {
@@ -50,7 +55,10 @@ const testPropsAsSyntax = {
   ...testPartialDefaults
 };
 const testCompleteDefaults = {
-  estimateSize: () => 36
+  estimateSize: () => 36,
+  paddingStart: 0,
+  paddingEnd: 0,
+  remountOnCountChange: true
 };
 const testInternalProps = {
   ...testRequiredProps,
@@ -69,7 +77,7 @@ const testExplicitDefinition = {
   actionRef,
   extraItemProps: { data }
 };
-const testInferedTypeCompatibility = {
+const testInferredTypeCompatibility = {
   ItemRenderer: MockItemRenderer,
   count: 0,
   getId: (index) => "",
@@ -83,10 +91,59 @@ const testDefinitionAsConst = {
   actionRef,
   extraItemProps: { foo: "bar" }
 };
+const testGlobalAttributes = {
+  ItemRenderer: MockItemRenderer,
+  count: 0,
+  getId: (index) => "",
+  className: "custom-class",
+  id: "custom-id",
+  "aria-label": "custom list"
+};
+const testContainerIntegration = {
+  ...testRequiredProps,
+  innerRef: innerRefCallback,
+  paddingStart: 24,
+  paddingEnd: -5,
+  remountOnCountChange: false,
+  extraContent: null
+};
+const testContainerIntegrationAsSyntax = {
+  ...testRequiredProps,
+  innerRef: innerRefObject,
+  paddingStart: 24,
+  paddingEnd: 40,
+  remountOnCountChange: true,
+  extraContent: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "extra" })
+};
+const testContainerIntegrationAsConst = {
+  ...testRequiredProps,
+  paddingStart: 0,
+  paddingEnd: 0,
+  remountOnCountChange: false
+};
+const publishedScrollToOptions = { align: "start" };
+const publishedAlign = publishedScrollToOptions.align;
+const scrollActionOptions = { behavior: "smooth" };
+const handleScrollToWithActionOptions = () => actionRef.current.scrollTo?.(1, scrollActionOptions);
+const handleScrollToWithPublishedOptions = () => actionRef.current.scrollTo?.(1, publishedScrollToOptions);
+const handleScrollToAlign = () => actionRef.current.scrollTo?.(1, { align: "center" });
+const handleScrollToBehavior = () => actionRef.current.scrollTo?.(1, { behavior: "smooth" });
+const handleScrollToBoth = () => actionRef.current.scrollTo?.(1, { align: "end", behavior: "auto" });
+const handleMeasure = () => actionRef.current.measure?.();
+const handleGetVisibleItems = () => actionRef.current.getVisibleItems?.() ?? [];
+const handleGetMountedItems = () => actionRef.current.getMountedItems?.() ?? [];
+const handleGetOffsetForIndex = () => actionRef.current.getOffsetForIndex?.(1);
+const handleGetOffsetForIndexAligned = () => actionRef.current.getOffsetForIndex?.(1, "center");
+const handleScrollToOffset = () => actionRef.current.scrollToOffset?.(100);
+const handleScrollToOffsetWithOptions = () => actionRef.current.scrollToOffset?.(100, { behavior: "auto" });
 const ExampleUsageComponent = () => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
   /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testExplicitDefinition }),
-  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testInferedTypeCompatibility }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testInferredTypeCompatibility }),
   /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testDefinitionAsConst }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testGlobalAttributes }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testContainerIntegration }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testContainerIntegrationAsSyntax }),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import__.DSFastList, { ...testContainerIntegrationAsConst }),
   /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     import__.DSFastList,
     {
@@ -96,6 +153,32 @@ const ExampleUsageComponent = () => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)
       actionRef,
       extraItemProps: { foo: "bar" }
     }
+  ),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import__.DSFastList,
+    {
+      ItemRenderer: MockItemRenderer,
+      count: 0,
+      getId: (index) => "",
+      innerRef: innerRefObject,
+      paddingStart: 24,
+      paddingEnd: -5,
+      remountOnCountChange: false,
+      extraContent: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", children: "Load more" }),
+      dsFastlistExtraContent: { role: "listitem" }
+    }
+  ),
+  /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import__.DSFastList,
+    {
+      className: "custom-class",
+      id: "custom-id",
+      "aria-label": "custom list",
+      "data-testid": "custom-testid",
+      ItemRenderer: MockItemRenderer,
+      count: 0,
+      getId: (index) => ""
+    }
   )
 ] });
 //# sourceMappingURL=typescript-fast-list-valid.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/typescript-testing/typescript-fast-list-valid.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */\nimport { type MutableRefObject, createRef } from 'react';\nimport { DSFastList } from '../index.js';\nimport type { DSFastListT } from '../index.js';\n\nconst data = [1, 2, 3];\nconst extraProps = { data };\n// test we expose the namespace and the namespace follows our deliverable conventions\ntype ComponentPropsForApp = DSFastListT.Props<typeof extraProps>;\ntype ComponentPropsInternals = DSFastListT.InternalProps<typeof extraProps>;\ntype ComponentPropsDefaultProps = DSFastListT.DefaultProps;\ntype ComponentPropsOptionalProps = DSFastListT.OptionalProps<typeof extraProps>;\ntype ComponentPropsRequiredProps = DSFastListT.RequiredProps<typeof extraProps>;\n\nconst MockItemRenderer = ({ index }: { index: number }) => <div></div>;\n\nconst actionRef = createRef() as MutableRefObject<{ scrollTo: (index: number) => void }>;\n\nconst testRequiredProps: ComponentPropsRequiredProps = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n};\n\nconst testOptionalProps: ComponentPropsOptionalProps = {\n  actionRef,\n  extraItemProps: { data },\n};\n\n// difference Props and InternalProps is that InternalProps has all the default props filled in\n// Props allows for partial defaults\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\n// InternalProps requires all defaults to be filled in\nconst testCompleteDefaults: Required<ComponentPropsDefaultProps> = {\n  estimateSize: () => 36,\n};\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// using the explicit type definition, if there is an error, it will be marked on the key that is wrong\nconst testExplicitDefinition: ComponentPropsForApp = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { data },\n};\n\n// using the \"as\" syntax, if there is an error, it will be marking the whole object as wrong because it is not compatible with the type\nconst testInferedTypeCompatibility = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { data },\n} as ComponentPropsForApp;\n\nconst testDefinitionAsConst = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { foo: 'bar' },\n} as const;\n\nconst ExampleUsageComponent = () => (\n  <>\n    {/* works with explicitly casted props, all syntaxes */}\n    <DSFastList {...testExplicitDefinition} />\n    <DSFastList {...testInferedTypeCompatibility} />\n    <DSFastList {...testDefinitionAsConst} />\n    {/* works with inline values */}\n    <DSFastList\n      ItemRenderer={MockItemRenderer}\n      count={0}\n      getId={(index: number) => ''}\n      actionRef={actionRef}\n      extraItemProps={{ foo: 'bar' }}\n    />\n  </>\n);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,YAAuB;ACcoC;AAb3D,mBAAiD;AACjD,eAA2B;AAG3B,MAAM,OAAO,CAAC,GAAG,GAAG,CAAC;AACrB,MAAM,aAAa,EAAE,KAAK;AAQ1B,MAAM,mBAAmB,CAAC,EAAE,MAAM,MAAyB,4CAAC,SAAI;AAEhE,MAAM,gBAAY,wBAAU;AAE5B,MAAM,oBAAiD;AAAA,EACrD,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAC5B;AAEA,MAAM,oBAAiD;AAAA,EACrD;AAAA,EACA,gBAAgB,EAAE,KAAK;AACzB;AAIA,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;AAGA,MAAM,uBAA6D;AAAA,EACjE,cAAc,MAAM;AACtB;AAEA,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,yBAA+C;AAAA,EACnD,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK;AACzB;AAGA,MAAM,+BAA+B;AAAA,EACnC,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK;AACzB;AAEA,MAAM,wBAAwB;AAAA,EAC5B,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK,MAAM;AAC/B;AAEA,MAAM,wBAAwB,MAC5B,4EAEE;AAAA,8CAAC,uBAAY,GAAG,wBAAwB;AAAA,EACxC,4CAAC,uBAAY,GAAG,8BAA8B;AAAA,EAC9C,4CAAC,uBAAY,GAAG,uBAAuB;AAAA,EAEvC;AAAA,IAAC;AAAA;AAAA,MACC,cAAc;AAAA,MACd,OAAO;AAAA,MACP,OAAO,CAAC,UAAkB;AAAA,MAC1B;AAAA,MACA,gBAAgB,EAAE,KAAK,MAAM;AAAA;AAAA,EAC/B;AAAA,GACF;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-unused-vars, no-unused-vars */\nimport { type MutableRefObject, createRef } from 'react';\nimport { DSFastList } from '../index.js';\nimport type { DSFastListT } from '../index.js';\n\nconst data = [1, 2, 3];\nconst extraProps = { data };\n// test we expose the namespace and the namespace follows our deliverable conventions\ntype ComponentPropsForApp = DSFastListT.Props<typeof extraProps>;\ntype ComponentPropsInternals = DSFastListT.InternalProps<typeof extraProps>;\ntype ComponentPropsDefaultProps = DSFastListT.DefaultProps;\ntype ComponentPropsOptionalProps = DSFastListT.OptionalProps<typeof extraProps>;\ntype ComponentPropsRequiredProps = DSFastListT.RequiredProps<typeof extraProps>;\n\nconst MockItemRenderer = ({ index }: { index: number }) => <div></div>;\n\n// Referencing DSFastListT.ActionRef directly (not a hand-written shape) so this file breaks if\n// the real ActionRef contract changes \u2014 a hand-written shape here would silently drift.\nconst actionRef = createRef() as MutableRefObject<DSFastListT.ActionRef>;\nconst innerRefObject = createRef() as MutableRefObject<HTMLDivElement | null>;\nconst innerRefCallback = (node: HTMLDivElement | null) => {};\n\nconst testRequiredProps: ComponentPropsRequiredProps = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n};\n\nconst testOptionalProps: ComponentPropsOptionalProps = {\n  actionRef,\n  extraItemProps: { data },\n  innerRef: innerRefObject,\n  extraContent: <button type=\"button\">Load more</button>,\n};\n\n// difference Props and InternalProps is that InternalProps has all the default props filled in\n// Props allows for partial defaults\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\n// InternalProps requires all defaults to be filled in\nconst testCompleteDefaults: Required<ComponentPropsDefaultProps> = {\n  estimateSize: () => 36,\n  paddingStart: 0,\n  paddingEnd: 0,\n  remountOnCountChange: true,\n};\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// using the explicit type definition, if there is an error, it will be marked on the key that is wrong\nconst testExplicitDefinition: ComponentPropsForApp = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { data },\n};\n\n// using the \"as\" syntax, if there is an error, it will be marking the whole object as wrong because it is not compatible with the type\nconst testInferredTypeCompatibility = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { data },\n} as ComponentPropsForApp;\n\nconst testDefinitionAsConst = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  actionRef,\n  extraItemProps: { foo: 'bar' },\n} as const;\n\n// Global HTML/ARIA attributes (className, id, aria-*, data-*) work at runtime via\n// useGetGlobalAttributes in List.tsx \u2014 PropsT/InternalPropsT intersect with\n// Omit<GlobalAttributesT<HTMLElement>, ...> specifically so this compiles. Regression here means\n// the type/runtime contract has drifted apart again.\nconst testGlobalAttributes: ComponentPropsForApp = {\n  ItemRenderer: MockItemRenderer,\n  count: 0,\n  getId: (index: number) => '',\n  className: 'custom-class',\n  id: 'custom-id',\n  'aria-label': 'custom list',\n};\n// container-integration props, all assignment styles\nconst testContainerIntegration: ComponentPropsForApp = {\n  ...testRequiredProps,\n  innerRef: innerRefCallback,\n  paddingStart: 24,\n  paddingEnd: -5,\n  remountOnCountChange: false,\n  extraContent: null,\n};\n\nconst testContainerIntegrationAsSyntax = {\n  ...testRequiredProps,\n  innerRef: innerRefObject,\n  paddingStart: 24,\n  paddingEnd: 40,\n  remountOnCountChange: true,\n  extraContent: <span>extra</span>,\n} as ComponentPropsForApp;\n\nconst testContainerIntegrationAsConst = {\n  ...testRequiredProps,\n  paddingStart: 0,\n  paddingEnd: 0,\n  remountOnCountChange: false,\n} as const;\n\n// scrollTo accepts the virtualizer's full scroll options\n// ScrollToOptions keeps its published shape: `align` is required, so reading it needs no undefined check\nconst publishedScrollToOptions: DSFastListT.ScrollToOptions = { align: 'start' };\nconst publishedAlign: 'start' | 'center' | 'end' | 'auto' = publishedScrollToOptions.align;\nconst scrollActionOptions: DSFastListT.ScrollActionOptions = { behavior: 'smooth' };\nconst handleScrollToWithActionOptions = () => actionRef.current.scrollTo?.(1, scrollActionOptions);\nconst handleScrollToWithPublishedOptions = () => actionRef.current.scrollTo?.(1, publishedScrollToOptions);\nconst handleScrollToAlign = () => actionRef.current.scrollTo?.(1, { align: 'center' });\nconst handleScrollToBehavior = () => actionRef.current.scrollTo?.(1, { behavior: 'smooth' });\nconst handleScrollToBoth = () => actionRef.current.scrollTo?.(1, { align: 'end', behavior: 'auto' });\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\n// single-shot scrolling primitives \u2014 getOffsetForIndex() + scrollToOffset()\nconst handleGetOffsetForIndex: () => number | undefined = () => actionRef.current.getOffsetForIndex?.(1);\nconst handleGetOffsetForIndexAligned: () => number | undefined = () =>\n  actionRef.current.getOffsetForIndex?.(1, 'center');\nconst handleScrollToOffset = () => actionRef.current.scrollToOffset?.(100);\nconst handleScrollToOffsetWithOptions = () => actionRef.current.scrollToOffset?.(100, { behavior: 'auto' });\n\nconst ExampleUsageComponent = () => (\n  <>\n    {/* works with explicitly casted props, all syntaxes */}\n    <DSFastList {...testExplicitDefinition} />\n    <DSFastList {...testInferredTypeCompatibility} />\n    <DSFastList {...testDefinitionAsConst} />\n    <DSFastList {...testGlobalAttributes} />\n    <DSFastList {...testContainerIntegration} />\n    <DSFastList {...testContainerIntegrationAsSyntax} />\n    <DSFastList {...testContainerIntegrationAsConst} />\n    {/* works with inline values */}\n    <DSFastList\n      ItemRenderer={MockItemRenderer}\n      count={0}\n      getId={(index: number) => ''}\n      actionRef={actionRef}\n      extraItemProps={{ foo: 'bar' }}\n    />\n    {/* Inline props test \u2014 container-integration props */}\n    <DSFastList\n      ItemRenderer={MockItemRenderer}\n      count={0}\n      getId={(index: number) => ''}\n      innerRef={innerRefObject}\n      paddingStart={24}\n      paddingEnd={-5}\n      remountOnCountChange={false}\n      extraContent={<button type=\"button\">Load more</button>}\n      dsFastlistExtraContent={{ role: 'listitem' }}\n    />\n    {/* Inline props test \u2014 global HTML/ARIA attributes */}\n    <DSFastList\n      className=\"custom-class\"\n      id=\"custom-id\"\n      aria-label=\"custom list\"\n      data-testid=\"custom-testid\"\n      ItemRenderer={MockItemRenderer}\n      count={0}\n      getId={(index: number) => ''}\n    />\n  </>\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;AAAA,YAAuB;ACcoC;AAb3D,mBAAiD;AACjD,eAA2B;AAG3B,MAAM,OAAO,CAAC,GAAG,GAAG,CAAC;AACrB,MAAM,aAAa,EAAE,KAAK;AAQ1B,MAAM,mBAAmB,CAAC,EAAE,MAAM,MAAyB,4CAAC,SAAI;AAIhE,MAAM,gBAAY,wBAAU;AAC5B,MAAM,qBAAiB,wBAAU;AACjC,MAAM,mBAAmB,CAAC,SAAgC;AAAC;AAE3D,MAAM,oBAAiD;AAAA,EACrD,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAC5B;AAEA,MAAM,oBAAiD;AAAA,EACrD;AAAA,EACA,gBAAgB,EAAE,KAAK;AAAA,EACvB,UAAU;AAAA,EACV,cAAc,4CAAC,YAAO,MAAK,UAAS,uBAAS;AAC/C;AAIA,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;AAGA,MAAM,uBAA6D;AAAA,EACjE,cAAc,MAAM;AAAA,EACpB,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AACxB;AAEA,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,yBAA+C;AAAA,EACnD,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK;AACzB;AAGA,MAAM,gCAAgC;AAAA,EACpC,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK;AACzB;AAEA,MAAM,wBAAwB;AAAA,EAC5B,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B;AAAA,EACA,gBAAgB,EAAE,KAAK,MAAM;AAC/B;AAMA,MAAM,uBAA6C;AAAA,EACjD,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO,CAAC,UAAkB;AAAA,EAC1B,WAAW;AAAA,EACX,IAAI;AAAA,EACJ,cAAc;AAChB;AAEA,MAAM,2BAAiD;AAAA,EACrD,GAAG;AAAA,EACH,UAAU;AAAA,EACV,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AAAA,EACtB,cAAc;AAChB;AAEA,MAAM,mCAAmC;AAAA,EACvC,GAAG;AAAA,EACH,UAAU;AAAA,EACV,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AAAA,EACtB,cAAc,4CAAC,UAAK,mBAAK;AAC3B;AAEA,MAAM,kCAAkC;AAAA,EACtC,GAAG;AAAA,EACH,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AACxB;AAIA,MAAM,2BAAwD,EAAE,OAAO,QAAQ;AAC/E,MAAM,iBAAsD,yBAAyB;AACrF,MAAM,sBAAuD,EAAE,UAAU,SAAS;AAClF,MAAM,kCAAkC,MAAM,UAAU,QAAQ,WAAW,GAAG,mBAAmB;AACjG,MAAM,qCAAqC,MAAM,UAAU,QAAQ,WAAW,GAAG,wBAAwB;AACzG,MAAM,sBAAsB,MAAM,UAAU,QAAQ,WAAW,GAAG,EAAE,OAAO,SAAS,CAAC;AACrF,MAAM,yBAAyB,MAAM,UAAU,QAAQ,WAAW,GAAG,EAAE,UAAU,SAAS,CAAC;AAC3F,MAAM,qBAAqB,MAAM,UAAU,QAAQ,WAAW,GAAG,EAAE,OAAO,OAAO,UAAU,OAAO,CAAC;AAGnG,MAAM,gBAAgB,MAAM,UAAU,QAAQ,UAAU;AACxD,MAAM,wBAAwC,MAAM,UAAU,QAAQ,kBAAkB,KAAK,CAAC;AAC9F,MAAM,wBAAwC,MAAM,UAAU,QAAQ,kBAAkB,KAAK,CAAC;AAG9F,MAAM,0BAAoD,MAAM,UAAU,QAAQ,oBAAoB,CAAC;AACvG,MAAM,iCAA2D,MAC/D,UAAU,QAAQ,oBAAoB,GAAG,QAAQ;AACnD,MAAM,uBAAuB,MAAM,UAAU,QAAQ,iBAAiB,GAAG;AACzE,MAAM,kCAAkC,MAAM,UAAU,QAAQ,iBAAiB,KAAK,EAAE,UAAU,OAAO,CAAC;AAE1G,MAAM,wBAAwB,MAC5B,4EAEE;AAAA,8CAAC,uBAAY,GAAG,wBAAwB;AAAA,EACxC,4CAAC,uBAAY,GAAG,+BAA+B;AAAA,EAC/C,4CAAC,uBAAY,GAAG,uBAAuB;AAAA,EACvC,4CAAC,uBAAY,GAAG,sBAAsB;AAAA,EACtC,4CAAC,uBAAY,GAAG,0BAA0B;AAAA,EAC1C,4CAAC,uBAAY,GAAG,kCAAkC;AAAA,EAClD,4CAAC,uBAAY,GAAG,iCAAiC;AAAA,EAEjD;AAAA,IAAC;AAAA;AAAA,MACC,cAAc;AAAA,MACd,OAAO;AAAA,MACP,OAAO,CAAC,UAAkB;AAAA,MAC1B;AAAA,MACA,gBAAgB,EAAE,KAAK,MAAM;AAAA;AAAA,EAC/B;AAAA,EAEA;AAAA,IAAC;AAAA;AAAA,MACC,cAAc;AAAA,MACd,OAAO;AAAA,MACP,OAAO,CAAC,UAAkB;AAAA,MAC1B,UAAU;AAAA,MACV,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,sBAAsB;AAAA,MACtB,cAAc,4CAAC,YAAO,MAAK,UAAS,uBAAS;AAAA,MAC7C,wBAAwB,EAAE,MAAM,WAAW;AAAA;AAAA,EAC7C;AAAA,EAEA;AAAA,IAAC;AAAA;AAAA,MACC,WAAU;AAAA,MACV,IAAG;AAAA,MACH,cAAW;AAAA,MACX,eAAY;AAAA,MACZ,cAAc;AAAA,MACd,OAAO;AAAA,MACP,OAAO,CAAC,UAAkB;AAAA;AAAA,EAC5B;AAAA,GACF;",
   "names": []
 }

package/dist/esm/FastList.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 { DSFastListPropTypes } from "./react-desc-prop-types.js";
-import { DSFastListName } from "./DSFastListDefinitions.js";
+import { DSFastListName } from "./constants/index.js";
 const DSFastList = (props) => /* @__PURE__ */ jsx(List, { ...props });
 DSFastList.displayName = DSFastListName;
 const DSFastListWithSchema = describe(DSFastList).description("DSFastList");

package/dist/esm/FastList.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/FastList.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 { 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"],
+  "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 { 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"],
   "mappings": "AAAA,YAAY,WAAW;ACS+C;AARtE,SAAS,gBAAgB;AACzB,SAAS,YAAY;AACrB,SAAS,2BAA6C;AACtD,SAAS,sBAAsB;AAK/B,MAAM,aAAa,CAAmB,UAAgC,oBAAC,QAAM,GAAG,OAAO;AAEvF,WAAW,cAAc;AACzB,MAAM,uBAAuB,SAAS,UAAU,EAAE,YAAY,YAAY;AAC1E,qBAAqB,YAAY;",
   "names": []
 }

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

@@ -4,12 +4,13 @@ const DSFastListName = "DSFastlist";
 const DSFastListSlots = {
   CONTAINER: "container",
   WRAPPER_LIST: "wrapper-list",
-  ITEM: "item"
+  ITEM: "item",
+  EXTRA_CONTENT: "extra-content"
 };
-const DSCardV3DataTestIds = slotObjectToDataTestIds(DSFastListName, DSFastListSlots);
+const DSFastListDataTestIds = slotObjectToDataTestIds(DSFastListName, DSFastListSlots);
 export {
-  DSCardV3DataTestIds,
+  DSFastListDataTestIds,
   DSFastListName,
   DSFastListSlots
 };
-//# sourceMappingURL=DSFastListDefinitions.js.map
+//# 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 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"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,+BAA+B;AAEjC,MAAM,iBAAiB;AAEvB,MAAM,kBAAkB;AAAA,EAC7B,WAAW;AAAA,EACX,cAAc;AAAA,EACd,MAAM;AAAA,EACN,eAAe;AACjB;AAEO,MAAM,wBAAwB,wBAAwB,gBAAgB,eAAe;",
+  "names": []
+}

package/dist/esm/hooks/useFastList.js

@@ -3,6 +3,7 @@ import React2 from "react";
 import { uid } from "uid";
 import { useVirtualizer } from "@tanstack/react-virtual";
 import { useMemoMergePropsWithDefault } from "@elliemae/ds-props-helpers";
+import { setMultipleRefs } from "@elliemae/ds-system";
 import { DSFastListPropTypes, defaultProps } from "../react-desc-prop-types.js";
 import { useValidateProps } from "./useValidateProps.js";
 const useFastList = (propsFromUser) => {
@@ -11,26 +12,54 @@ const useFastList = (propsFromUser) => {
     defaultProps
   );
   useValidateProps(propsWithDefault, DSFastListPropTypes);
-  const { actionRef, count, estimateSize } = propsWithDefault;
+  const { actionRef, count, estimateSize, paddingStart, paddingEnd, innerRef, remountOnCountChange } = propsWithDefault;
   const parentRef = React2.useRef(null);
+  const containerRef = React2.useMemo(
+    () => innerRef ? setMultipleRefs([parentRef, innerRef]) : parentRef,
+    [innerRef]
+  );
   const useVirtualHelpers = 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 = React2.useMemo(() => `ds-fast-list-${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 = React2.useMemo(() => uid(6), []);
+  const instanceUid = React2.useMemo(
+    () => remountOnCountChange === false ? `ds-fast-list-${stableUid}` : `ds-fast-list-${uid(6)}${count}`,
+    [count, remountOnCountChange, stableUid]
+  );
   return React2.useMemo(
     () => ({
       instanceUid,
-      parentRef,
+      containerRef,
       getVirtualItems: useVirtualHelpers.getVirtualItems,
       totalSize,
       measureElement: useVirtualHelpers.measureElement
     }),
-    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid]
+    [useVirtualHelpers.getVirtualItems, useVirtualHelpers.measureElement, totalSize, instanceUid, containerRef]
   );
 };
 export {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useFastList.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "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"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,OAAOA,YAAW;AAClB,SAAS,WAAW;AACpB,SAAS,sBAAwC;AACjD,SAAS,oCAAoC;AAC7C,SAA2B,qBAAqB,oBAAoB;AACpE,SAAS,wBAAwB;AAS1B,MAAM,cAAc,CAAK,kBAAqD;AAInF,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACA,mBAAiB,kBAAkB,mBAAmB;AAItD,QAAM,EAAE,WAAW,OAAO,aAAa,IAAI;AAC3C,QAAM,YAAYA,OAAM,OAAuB,IAAI;AACnD,QAAM,oBAAoB,eAAe;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,cAAcA,OAAM,QAAQ,MAAM,gBAAgB,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC;AACjF,SAAOA,OAAM;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 * as React from 'react';\nexport { React };\n", "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"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,OAAOA,YAAW;AAClB,SAAS,WAAW;AACpB,SAAS,sBAAwC;AACjD,SAAS,oCAAoC;AAC7C,SAAS,uBAAuB;AAChC,SAA2B,qBAAqB,oBAAoB;AACpE,SAAS,wBAAwB;AAS1B,MAAM,cAAc,CAAK,kBAAqD;AAInF,QAAM,mBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACA,mBAAiB,kBAAkB,mBAAmB;AAItD,QAAM,EAAE,WAAW,OAAO,cAAc,cAAc,YAAY,UAAU,qBAAqB,IAAI;AACrG,QAAM,YAAYA,OAAM,OAAuB,IAAI;AACnD,QAAM,eAAeA,OAAM;AAAA,IACzB,MAAO,WAAW,gBAAgC,CAAC,WAAW,QAAQ,CAAC,IAAI;AAAA,IAC3E,CAAC,QAAQ;AAAA,EACX;AACA,QAAM,oBAAoB,eAAe;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,YAAYA,OAAM,QAAQ,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,QAAM,cAAcA,OAAM;AAAA,IACxB,MAAO,yBAAyB,QAAQ,gBAAgB,SAAS,KAAK,gBAAgB,IAAI,CAAC,CAAC,GAAG,KAAK;AAAA,IACpG,CAAC,OAAO,sBAAsB,SAAS;AAAA,EACzC;AACA,SAAOA,OAAM;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/esm/hooks/useValidateProps.js

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

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 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"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "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"],
   "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,sCAAsC;AAG/C,SAAS,sBAAsB;AAExB,MAAM,mBAAmB,CAC9B,OACA,cACS;AAET,iCAA+B,OAAO,WAAW,cAAc;AACjE;",
   "names": []
 }

package/dist/esm/index.js

@@ -1,7 +1,11 @@
 import * as React from "react";
 import { DSFastList, DSFastListWithSchema } from "./FastList.js";
+import { DSFastListName, DSFastListSlots, DSFastListDataTestIds } from "./constants/index.js";
 export {
   DSFastList,
+  DSFastListDataTestIds,
+  DSFastListName,
+  DSFastListSlots,
   DSFastListWithSchema
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { type DSFastListT } from './react-desc-prop-types.js';\nexport { DSFastList, DSFastListWithSchema } from './FastList.js';\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACCvB,SAAS,YAAY,4BAA4B;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { type DSFastListT } from './react-desc-prop-types.js';\nexport { DSFastList, DSFastListWithSchema } from './FastList.js';\nexport { DSFastListName, DSFastListSlots, DSFastListDataTestIds } from './constants/index.js';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACCvB,SAAS,YAAY,4BAA4B;AACjD,SAAS,gBAAgB,iBAAiB,6BAA6B;",
   "names": []
 }

package/dist/esm/parts/List.js

@@ -1,10 +1,10 @@
 import * as React from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import React2, { useCallback } from "react";
 import { styled } from "@elliemae/ds-system";
 import { useGetGlobalAttributes } from "@elliemae/ds-props-helpers";
 import { useFastList } from "../hooks/useFastList.js";
-import { DSFastListName, DSFastListSlots } from "../DSFastListDefinitions.js";
+import { DSFastListName, DSFastListSlots } from "../constants/index.js";
 const StyledList = styled("div", {
   name: DSFastListName,
   slot: DSFastListSlots.WRAPPER_LIST
@@ -21,6 +21,10 @@ const StyledListItem = styled("div", {
   left: 0;
   width: 100%;
 `;
+const StyledExtraContent = styled("div", {
+  name: DSFastListName,
+  slot: DSFastListSlots.EXTRA_CONTENT
+})``;
 const StyledListContainer = styled("div", {
   name: DSFastListName,
   slot: DSFastListSlots.CONTAINER
@@ -31,8 +35,9 @@ const StyledListContainer = styled("div", {
   padding-bottom: 0;
 `;
 const List = (props) => {
-  const { parentRef, getVirtualItems, totalSize, instanceUid, measureElement } = useFastList(props);
-  const { ItemRenderer, extraItemProps, getId } = props;
+  const { containerRef, getVirtualItems, totalSize, instanceUid, measureElement } = useFastList(props);
+  const { ItemRenderer, extraItemProps, getId, extraContent } = props;
+  const hasExtraContent = extraContent !== null && extraContent !== void 0 && typeof extraContent !== "boolean";
   const virtualItems = getVirtualItems();
   const measureRef = React2.useCallback(
     (node) => measureElement(node),
@@ -43,11 +48,11 @@ const List = (props) => {
   return /* @__PURE__ */ jsx(
     StyledListContainer,
     {
-      innerRef: parentRef,
+      innerRef: containerRef,
       tabIndex: -1,
       getOwnerProps,
       ...globalAttributes,
-      children: /* @__PURE__ */ jsx(
+      children: /* @__PURE__ */ jsxs(
         StyledList,
         {
           style: {
@@ -56,24 +61,27 @@ const List = (props) => {
           },
           role: "list",
           getOwnerProps,
-          children: virtualItems.map((virtualItem) => {
-            const { index, start } = virtualItem;
-            return /* @__PURE__ */ jsx(
-              StyledListItem,
-              {
-                innerRef: measureRef,
-                "data-index": index,
-                style: {
-                  transform: `translateY(${start}px)`
+          children: [
+            hasExtraContent ? /* @__PURE__ */ jsx(StyledExtraContent, { getOwnerProps, children: extraContent }) : null,
+            virtualItems.map((virtualItem) => {
+              const { index, start } = virtualItem;
+              return /* @__PURE__ */ jsx(
+                StyledListItem,
+                {
+                  innerRef: measureRef,
+                  "data-index": index,
+                  style: {
+                    transform: `translateY(${start}px)`
+                  },
+                  role: "listitem",
+                  getOwnerProps,
+                  getOwnerPropsArguments: () => ({ index: getId(index) }),
+                  children: /* @__PURE__ */ jsx(ItemRenderer, { extraItemProps, index })
                 },
-                role: "listitem",
-                getOwnerProps,
-                getOwnerPropsArguments: () => ({ index: getId(index) }),
-                children: /* @__PURE__ */ jsx(ItemRenderer, { extraItemProps, index })
-              },
-              getId(index)
-            );
-          })
+                getId(index)
+              );
+            })
+          ]
         }
       )
     },

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/List.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "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"],
-  "mappings": "AAAA,YAAY,WAAW;AC+ET;AA/Ed,OAAOA,UAAS,mBAAmB;AACnC,SAAS,cAAc;AACvB,SAAS,8BAA8B;AACvC,SAAS,mBAAmB;AAE5B,SAAS,gBAAgB,uBAAuB;AAEhD,MAAM,aAAa,OAAO,OAAO;AAAA,EAC/B,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAKD,MAAM,iBAAiB,OAAO,OAAO;AAAA,EACnC,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOD,MAAM,sBAAsB,OAAO,OAAO;AAAA,EACxC,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOM,MAAM,OAAO,CAAmB,UAAgC;AACrE,QAAM,EAAE,WAAW,iBAAiB,WAAW,aAAa,eAAe,IAAI,YAAY,KAAK;AAChG,QAAM,EAAE,cAAc,gBAAgB,MAAM,IAAI;AAEhD,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8CA,OAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,gBAAgB,YAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,mBAAmB,uBAAuB,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,8BAAC,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 * as React from 'react';\nexport { React };\n", "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"],
+  "mappings": "AAAA,YAAY,WAAW;AC+DjB,SAQqB,KARrB;AA/DN,OAAOA,UAAS,mBAAmB;AACnC,SAAS,cAAc;AACvB,SAAS,8BAA8B;AACvC,SAAS,mBAAmB;AAE5B,SAAS,gBAAgB,uBAAuB;AAEhD,MAAM,aAAa,OAAO,OAAO;AAAA,EAC/B,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAKD,MAAM,iBAAiB,OAAO,OAAO;AAAA,EACnC,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOD,MAAM,qBAAqB,OAAO,OAAO;AAAA,EACvC,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAED,MAAM,sBAAsB,OAAO,OAAO;AAAA,EACxC,MAAM;AAAA,EACN,MAAM,gBAAgB;AACxB,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAOM,MAAM,OAAO,CAAmB,UAAgC;AACrE,QAAM,EAAE,cAAc,iBAAiB,WAAW,aAAa,eAAe,IAAI,YAAY,KAAK;AACnG,QAAM,EAAE,cAAc,gBAAgB,OAAO,aAAa,IAAI;AAC9D,QAAM,kBAAkB,iBAAiB,QAAQ,iBAAiB,UAAa,OAAO,iBAAiB;AAEvG,QAAM,eAAe,gBAAgB;AACrC,QAAM,aAA8CA,OAAM;AAAA,IACxD,CAAC,SAAyB,eAAe,IAAI;AAAA,IAC7C,CAAC,cAAc;AAAA,EACjB;AAEA,QAAM,gBAAgB,YAAY,MAAM,OAAO,CAAC,KAAK,CAAC;AACtD,QAAM,mBAAmB,uBAAuB,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,oBAAC,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,8BAAC,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/esm/react-desc-prop-types.js

@@ -1,24 +1,60 @@
 import * as React from "react";
-import { PropTypes } from "@elliemae/ds-props-helpers";
+import { PropTypes, getPropsPerSlotPropTypes, globalAttributesPropTypes } from "@elliemae/ds-props-helpers";
+import { DSFastListName, DSFastListSlots } from "./constants/index.js";
 const defaultProps = {
-  estimateSize: () => 36
+  estimateSize: () => 36,
+  paddingStart: 0,
+  paddingEnd: 0,
+  remountOnCountChange: true
 };
 const DSFastListPropTypes = {
+  ...getPropsPerSlotPropTypes(DSFastListName, DSFastListSlots),
+  ...globalAttributesPropTypes,
   actionRef: PropTypes.shape({
     current: PropTypes.oneOfType([
       PropTypes.oneOf([null]),
       PropTypes.shape({
-        scrollTo: PropTypes.func.description("Scroll to a index inside the list").signature(`((index: number, { align: 'start' | 'center' | 'end' | 'auto' }) => void)`)
+        scrollTo: PropTypes.func.description("Scroll to a index inside the list").signature(
+          `((index: number, options?: { align?: 'start' | 'center' | 'end' | 'auto'; behavior?: 'auto' | 'smooth' }) => void)`
+        ),
+        measure: 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: PropTypes.func.description("Returns the indices of the items currently visible in the viewport (no overscan buffer)").signature(`(() => number[])`),
+        getMountedItems: PropTypes.func.description("Returns the indices of all items currently mounted in the DOM, including the overscan buffer").signature(`(() => number[])`),
+        getOffsetForIndex: 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: 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: PropTypes.oneOfType([PropTypes.object, PropTypes.func]).isRequired.description(
     "Render function for each item"
   ),
   count: PropTypes.number.isRequired.description("Number of items to render"),
   extraItemProps: PropTypes.object.description("Extra props to pass to each item"),
   getId: PropTypes.func.isRequired.description("Function to get the key for each item"),
-  estimateSize: PropTypes.func.description("Function to estimate the size of each item")
+  estimateSize: PropTypes.func.description("Function to estimate the size of each item"),
+  innerRef: PropTypes.oneOfType([PropTypes.func, PropTypes.object]).description(
+    "Ref (object or callback) that receives the scroll container element of the list"
+  ),
+  paddingStart: PropTypes.number.description("Space in pixels reserved before the first item inside the scrolling area").defaultValue(0),
+  paddingEnd: PropTypes.number.description(
+    "Space in pixels reserved after the last item inside the scrolling area; negative values are passed through"
+  ).defaultValue(0),
+  remountOnCountChange: 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: 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'
+  )
 };
 export {
   DSFastListPropTypes,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/react-desc-prop-types.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "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"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,iBAAiB;AAgDnB,MAAM,eAAe;AAAA,EAC1B,cAAc,MAAM;AACtB;AAEO,MAAM,sBAAsB;AAAA,EACjC,WAAW,UAAU,MAAM;AAAA,IACzB,SAAS,UAAU,UAAU;AAAA,MAC3B,UAAU,MAAM,CAAC,IAAI,CAAC;AAAA,MACtB,UAAU,MAAM;AAAA,QACd,UAAU,UAAU,KACjB,YAAY,mCAAmC,EAC/C,UAAU,2EAA2E;AAAA,MAC1F,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC,EAAE,YAAY,gDAAgD;AAAA,EAC/D,cAAc,UAAU,UAAU,CAAC,UAAU,QAAQ,UAAU,IAAI,CAAC,EAAE,WAAW;AAAA,IAC/E;AAAA,EACF;AAAA,EACA,OAAO,UAAU,OAAO,WAAW,YAAY,2BAA2B;AAAA,EAC1E,gBAAgB,UAAU,OAAO,YAAY,kCAAkC;AAAA,EAC/E,OAAO,UAAU,KAAK,WAAW,YAAY,uCAAuC;AAAA,EACpF,cAAc,UAAU,KAAK,YAAY,4CAA4C;AACvF;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "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"],
+  "mappings": "AAAA,YAAY,WAAW;ACCvB,SAAS,WAAW,0BAA0B,iCAAiC;AAG/E,SAAS,gBAAgB,uBAAuB;AA6EzC,MAAM,eAAe;AAAA,EAC1B,cAAc,MAAM;AAAA,EACpB,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,sBAAsB;AACxB;AAEO,MAAM,sBAAsB;AAAA,EACjC,GAAG,yBAAyB,gBAAgB,eAAe;AAAA,EAC3D,GAAG;AAAA,EACH,WAAW,UAAU,MAAM;AAAA,IACzB,SAAS,UAAU,UAAU;AAAA,MAC3B,UAAU,MAAM,CAAC,IAAI,CAAC;AAAA,MACtB,UAAU,MAAM;AAAA,QACd,UAAU,UAAU,KACjB,YAAY,mCAAmC,EAC/C;AAAA,UACC;AAAA,QACF;AAAA,QACF,SAAS,UAAU,KAChB;AAAA,UACC;AAAA,QACF,EACC,UAAU,cAAc;AAAA,QAC3B,iBAAiB,UAAU,KACxB,YAAY,yFAAyF,EACrG,UAAU,kBAAkB;AAAA,QAC/B,iBAAiB,UAAU,KACxB,YAAY,8FAA8F,EAC1G,UAAU,kBAAkB;AAAA,QAC/B,mBAAmB,UAAU,KAC1B;AAAA,UACC;AAAA,QACF,EACC,UAAU,sFAAsF;AAAA,QACnG,gBAAgB,UAAU,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,UAAU,UAAU,CAAC,UAAU,QAAQ,UAAU,IAAI,CAAC,EAAE,WAAW;AAAA,IAC/E;AAAA,EACF;AAAA,EACA,OAAO,UAAU,OAAO,WAAW,YAAY,2BAA2B;AAAA,EAC1E,gBAAgB,UAAU,OAAO,YAAY,kCAAkC;AAAA,EAC/E,OAAO,UAAU,KAAK,WAAW,YAAY,uCAAuC;AAAA,EACpF,cAAc,UAAU,KAAK,YAAY,4CAA4C;AAAA,EACrF,UAAU,UAAU,UAAU,CAAC,UAAU,MAAM,UAAU,MAAM,CAAC,EAAE;AAAA,IAChE;AAAA,EACF;AAAA,EACA,cAAc,UAAU,OACrB,YAAY,0EAA0E,EACtF,aAAa,CAAC;AAAA,EACjB,YAAY,UAAU,OACnB;AAAA,IACC;AAAA,EACF,EACC,aAAa,CAAC;AAAA,EACjB,sBAAsB,UAAU,KAC7B;AAAA,IACC;AAAA,EACF,EACC,aAAa,IAAI;AAAA,EACpB,cAAc,UAAU,KAAK;AAAA,IAC3B;AAAA,EACF;AACF;",
   "names": []
 }