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

package/dist/esm/typescript-testing/slot-props.js

@@ -0,0 +1,15 @@
+import * as React from "react";
+const SlotPropsAsObject = {
+  dsFastlistContainer: { "aria-label": "just a typescript test" },
+  dsFastlistWrapperList: { "aria-label": "just a typescript test" },
+  dsFastlistItem: { "aria-label": "just a typescript test" },
+  dsFastlistExtraContent: { "aria-label": "just a typescript test" }
+};
+const SlotPropsAsFunctions = {
+  dsFastlistContainer: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistWrapperList: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistItem: () => ({ "aria-label": "just a typescript test" }),
+  dsFastlistExtraContent: () => ({ "aria-label": "just a typescript test" })
+};
+const EnsureAllSlotsExistInSlotFunctionArguments = SlotPropsAsFunctions;
+//# sourceMappingURL=slot-props.js.map

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

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

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

@@ -6,6 +6,9 @@ const data = [1, 2, 3];
 const extraProps = { data };
 const MockItemRenderer = ({ index }) => /* @__PURE__ */ jsx("div", {});
 const actionRef = createRef();
+const innerRefObject = createRef();
+const innerRefCallback = (node) => {
+};
 const testRequiredProps = {
   ItemRenderer: MockItemRenderer,
   count: 0,
@@ -13,7 +16,9 @@ const testRequiredProps = {
 };
 const testOptionalProps = {
   actionRef,
-  extraItemProps: { data }
+  extraItemProps: { data },
+  innerRef: innerRefObject,
+  extraContent: /* @__PURE__ */ jsx("button", { type: "button", children: "Load more" })
 };
 const testPartialDefaults = {};
 const testProps = {
@@ -27,7 +32,10 @@ const testPropsAsSyntax = {
   ...testPartialDefaults
 };
 const testCompleteDefaults = {
-  estimateSize: () => 36
+  estimateSize: () => 36,
+  paddingStart: 0,
+  paddingEnd: 0,
+  remountOnCountChange: true
 };
 const testInternalProps = {
   ...testRequiredProps,
@@ -46,7 +54,7 @@ const testExplicitDefinition = {
   actionRef,
   extraItemProps: { data }
 };
-const testInferedTypeCompatibility = {
+const testInferredTypeCompatibility = {
   ItemRenderer: MockItemRenderer,
   count: 0,
   getId: (index) => "",
@@ -60,10 +68,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__ */ 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__ */ jsxs(Fragment, { children: [
   /* @__PURE__ */ jsx(DSFastList, { ...testExplicitDefinition }),
-  /* @__PURE__ */ jsx(DSFastList, { ...testInferedTypeCompatibility }),
+  /* @__PURE__ */ jsx(DSFastList, { ...testInferredTypeCompatibility }),
   /* @__PURE__ */ jsx(DSFastList, { ...testDefinitionAsConst }),
+  /* @__PURE__ */ jsx(DSFastList, { ...testGlobalAttributes }),
+  /* @__PURE__ */ jsx(DSFastList, { ...testContainerIntegration }),
+  /* @__PURE__ */ jsx(DSFastList, { ...testContainerIntegrationAsSyntax }),
+  /* @__PURE__ */ jsx(DSFastList, { ...testContainerIntegrationAsConst }),
   /* @__PURE__ */ jsx(
     DSFastList,
     {
@@ -73,6 +130,32 @@ const ExampleUsageComponent = () => /* @__PURE__ */ jsxs(Fragment, { children: [
       actionRef,
       extraItemProps: { foo: "bar" }
     }
+  ),
+  /* @__PURE__ */ jsx(
+    DSFastList,
+    {
+      ItemRenderer: MockItemRenderer,
+      count: 0,
+      getId: (index) => "",
+      innerRef: innerRefObject,
+      paddingStart: 24,
+      paddingEnd: -5,
+      remountOnCountChange: false,
+      extraContent: /* @__PURE__ */ jsx("button", { type: "button", children: "Load more" }),
+      dsFastlistExtraContent: { role: "listitem" }
+    }
+  ),
+  /* @__PURE__ */ jsx(
+    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/esm/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,YAAY,WAAW;ACcoC,SA2EzD,UA3EyD,KA2EzD,YA3EyD;AAb3D,SAAgC,iBAAiB;AACjD,SAAS,kBAAkB;AAG3B,MAAM,OAAO,CAAC,GAAG,GAAG,CAAC;AACrB,MAAM,aAAa,EAAE,KAAK;AAQ1B,MAAM,mBAAmB,CAAC,EAAE,MAAM,MAAyB,oBAAC,SAAI;AAEhE,MAAM,YAAY,UAAU;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,iCAEE;AAAA,sBAAC,cAAY,GAAG,wBAAwB;AAAA,EACxC,oBAAC,cAAY,GAAG,8BAA8B;AAAA,EAC9C,oBAAC,cAAY,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": "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",
   "names": []
 }

package/dist/types/constants/index.d.ts

@@ -0,0 +1,13 @@
+export declare const DSFastListName = "DSFastlist";
+export declare const DSFastListSlots: {
+    readonly CONTAINER: "container";
+    readonly WRAPPER_LIST: "wrapper-list";
+    readonly ITEM: "item";
+    readonly EXTRA_CONTENT: "extra-content";
+};
+export declare const DSFastListDataTestIds: {
+    readonly CONTAINER: "ds-fastlist-container";
+    readonly WRAPPER_LIST: "ds-fastlist-wrapper-list";
+    readonly ITEM: "ds-fastlist-item";
+    readonly EXTRA_CONTENT: "ds-fastlist-extra-content";
+};

package/dist/types/hooks/useFastList.d.ts

@@ -3,7 +3,7 @@ import { type Virtualizer } from '@tanstack/react-virtual';
 import { type DSFastListT } from '../react-desc-prop-types.js';
 export type FastListCTX = {
     instanceUid: string;
-    parentRef: React.MutableRefObject<HTMLDivElement | null>;
+    containerRef: React.MutableRefObject<HTMLDivElement | null> | React.RefCallback<HTMLDivElement>;
     getVirtualItems: Virtualizer<HTMLDivElement, HTMLElement>['getVirtualItems'];
     totalSize: ReturnType<Virtualizer<HTMLDivElement, HTMLElement>['getTotalSize']>;
     measureElement: Virtualizer<HTMLDivElement, HTMLElement>['measureElement'];

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
 export { type DSFastListT } from './react-desc-prop-types.js';
 export { DSFastList, DSFastListWithSchema } from './FastList.js';
+export { DSFastListName, DSFastListSlots, DSFastListDataTestIds } from './constants/index.js';

package/dist/types/react-desc-prop-types.d.ts

@@ -1,17 +1,41 @@
+import type { GlobalAttributesT } from '@elliemae/ds-props-helpers';
 import { type TypescriptHelpersT } from '@elliemae/ds-typescript-helpers';
 import type React from 'react';
-import type { DSFastListName, DSFastListSlots } from './DSFastListDefinitions.js';
+import { DSFastListName, DSFastListSlots } from './constants/index.js';
 export declare namespace DSFastListT {
     type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';
+    /** Kept with its published shape (`align` required) so code that reads it keeps compiling. */
     type ScrollToOptions = {
         align: ScrollAlignment;
     };
+    /** What the scroll actions accept: `align` is optional and `behavior` can request a smooth scroll. */
+    type ScrollActionOptions = {
+        align?: ScrollAlignment;
+        behavior?: 'auto' | 'smooth';
+    };
+    /**
+     * `scrollTo` and `scrollToOffset` use method syntax on purpose: their parameters are compared bivariantly, so an
+     * `actionRef` typed with the published `(index, options?: ScrollToOptions) => void` stays assignable.
+     */
     type ActionRef = {
-        scrollTo?: (index: number, options?: ScrollToOptions | undefined) => void;
+        scrollTo?(index: number, options?: ScrollActionOptions): void;
+        measure?: () => void;
+        getVisibleItems?: () => number[];
+        getMountedItems?: () => number[];
+        getOffsetForIndex?: (index: number, align?: ScrollAlignment) => number | undefined;
+        scrollToOffset?(offset: number, options?: ScrollActionOptions): void;
+    };
+    type SlotFunctionArguments = {
+        dsFastlistContainer: () => object;
+        dsFastlistWrapperList: () => object;
+        dsFastlistItem: () => object;
+        dsFastlistExtraContent: () => object;
     };
     interface OptionalProps<ExtraItemPropsT> extends TypescriptHelpersT.PropsForGlobalOnSlots<typeof DSFastListName, typeof DSFastListSlots> {
         actionRef?: React.MutableRefObject<ActionRef>;
         extraItemProps?: ExtraItemPropsT;
+        innerRef?: React.MutableRefObject<HTMLDivElement | null> | React.RefCallback<HTMLDivElement>;
+        extraContent?: React.ReactNode;
     }
     interface RequiredProps<ExtraItemPropsT> {
         ItemRenderer: React.ComponentType<{
@@ -23,13 +47,19 @@ export declare namespace DSFastListT {
     }
     interface DefaultProps {
         estimateSize: () => number;
+        paddingStart: number;
+        paddingEnd: number;
+        remountOnCountChange: boolean;
     }
-    type PropsT<D, R, O> = Partial<D> & R & O;
-    type InternalPropsT<D, R, O> = D & R & O;
+    type PropsT<D, R, O> = Partial<D> & R & O & Omit<GlobalAttributesT<HTMLElement>, keyof D | keyof R | 'children'>;
+    type InternalPropsT<D, R, O> = D & R & O & Omit<GlobalAttributesT<HTMLElement>, keyof D | keyof R | 'children'>;
     type Props<ExtraItemPropsT> = PropsT<DefaultProps, RequiredProps<ExtraItemPropsT>, OptionalProps<ExtraItemPropsT>>;
     type InternalProps<ExtraItemPropsT> = InternalPropsT<DefaultProps, RequiredProps<ExtraItemPropsT>, OptionalProps<ExtraItemPropsT>>;
 }
 export declare const defaultProps: {
     estimateSize: () => number;
+    paddingStart: number;
+    paddingEnd: number;
+    remountOnCountChange: boolean;
 };
 export declare const DSFastListPropTypes: React.WeakValidationMap<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-fast-list",
-  "version": "3.80.0-next.4",
+  "version": "3.80.0-next.40",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Virtual List",
   "files": [
@@ -36,17 +36,18 @@
     "indent": 4
   },
   "dependencies": {
+    "@elliemae/ds-props-helpers": "3.80.0-next.40",
+    "@elliemae/ds-system": "3.80.0-next.40",
+    "@elliemae/ds-typescript-helpers": "3.80.0-next.40",
     "@tanstack/react-virtual": "3.13.18",
-    "uid": "^2.0.2",
-    "@elliemae/ds-props-helpers": "3.80.0-next.4",
-    "@elliemae/ds-system": "3.80.0-next.4",
-    "@elliemae/ds-typescript-helpers": "3.80.0-next.4"
+    "uid": "^2.0.2"
   },
   "devDependencies": {
+    "@elliemae/ds-monorepo-devops": "3.80.0-next.40",
+    "@elliemae/ds-test-utils": "3.80.0-next.40",
+    "@playwright/experimental-ct-react": "1.61.1",
     "jest": "^30.0.0",
-    "styled-components": "~5.3.11",
-    "@elliemae/ds-monorepo-devops": "3.80.0-next.4",
-    "@elliemae/ds-test-utils": "3.80.0-next.4"
+    "styled-components": "~5.3.11"
   },
   "peerDependencies": {
     "lodash-es": "^4.18.1",
@@ -59,7 +60,7 @@
     "typeSafety": true
   },
   "scripts": {
-    "test": "ds-monorepo-devops test --passWithNoTests --coverage=\"false\"",
+    "test": "playwright test -c ./playwright.config.mjs && ds-monorepo-devops test --passWithNoTests --coverage=\"false\"",
     "lint": "node ../../../scripts/lint.mjs --fix",
     "lint:strict": "node ../../../scripts/lint-strict.mjs",
     "dts": "node ../../../scripts/dts.mjs",

package/dist/cjs/DSFastListDefinitions.js.map

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

package/dist/cjs/FastListDataTestID.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/FastListDataTestID.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["export const LIST_DATA_TESTID = {\n  CONTAINER: 'fast-list-container',\n};\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAhB,MAAM,mBAAmB;AAAA,EAC9B,WAAW;AACb;",
-  "names": []
-}

package/dist/esm/DSFastListDefinitions.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/DSFastListDefinitions.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { slotObjectToDataTestIds } from '@elliemae/ds-system';\n\nexport const DSFastListName = 'DSFastlist';\nexport const DSFastListSlots = {\n  CONTAINER: 'container',\n  WRAPPER_LIST: 'wrapper-list',\n  ITEM: 'item',\n};\n\nexport const DSCardV3DataTestIds = slotObjectToDataTestIds(DSFastListName, DSFastListSlots);\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,+BAA+B;AAEjC,MAAM,iBAAiB;AACvB,MAAM,kBAAkB;AAAA,EAC7B,WAAW;AAAA,EACX,cAAc;AAAA,EACd,MAAM;AACR;AAEO,MAAM,sBAAsB,wBAAwB,gBAAgB,eAAe;",
-  "names": []
-}

package/dist/esm/FastListDataTestID.js

@@ -1,8 +0,0 @@
-import * as React from "react";
-const LIST_DATA_TESTID = {
-  CONTAINER: "fast-list-container"
-};
-export {
-  LIST_DATA_TESTID
-};
-//# sourceMappingURL=FastListDataTestID.js.map

package/dist/esm/FastListDataTestID.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../src/FastListDataTestID.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export const LIST_DATA_TESTID = {\n  CONTAINER: 'fast-list-container',\n};\n"],
-  "mappings": "AAAA,YAAY,WAAW;ACAhB,MAAM,mBAAmB;AAAA,EAC9B,WAAW;AACb;",
-  "names": []
-}

package/dist/types/DSFastListDefinitions.d.ts

@@ -1,11 +0,0 @@
-export declare const DSFastListName = "DSFastlist";
-export declare const DSFastListSlots: {
-    CONTAINER: string;
-    WRAPPER_LIST: string;
-    ITEM: string;
-};
-export declare const DSCardV3DataTestIds: {
-    CONTAINER: `ds-fastlist-${string}`;
-    WRAPPER_LIST: `ds-fastlist-${string}`;
-    ITEM: `ds-fastlist-${string}`;
-};

package/dist/types/FastListDataTestID.d.ts

@@ -1,3 +0,0 @@
-export declare const LIST_DATA_TESTID: {
-    CONTAINER: string;
-};