@pnp/spfx-controls-react 3.25.0-beta.2845356 → 3.25.0-beta.3152906

package/jest-output/JUnit.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<testsuites name="jest tests" tests="85" failures="0" errors="0" time="6.752">
-  <testsuite name="&lt;ComboBoxListItemPicker /&gt;" errors="0" failures="0" skipped="7" timestamp="2026-06-30T14:55:19" time="1.594" tests="7">
+<testsuites name="jest tests" tests="94" failures="0" errors="0" time="5.38">
+  <testsuite name="&lt;ComboBoxListItemPicker /&gt;" errors="0" failures="0" skipped="7" timestamp="2026-08-11T19:43:31" time="1.217" tests="7">
     <testcase classname="&lt;ComboBoxListItemPicker /&gt; &gt; " name="Should render initial data (lib-commonjs/controls/listItemPicker/ComboBoxListItemPicker.test.js)" time="0">
       <skipped/>
     </testcase>
@@ -23,178 +23,198 @@
       <skipped/>
     </testcase>
   </testsuite>
-  <testsuite name="&lt;AccessibleChartTable /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:19" time="1.727" tests="13">
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render only one table (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.087">
+  <testsuite name="&lt;AccessibleChartTable /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:30" time="1.367" tests="13">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render only one table (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.07">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render with a custom className if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.009">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render with a custom className if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.006">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a caption if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.009">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a caption if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a caption if no caption is provided but a title is available (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.007">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a caption if no caption is provided but a title is available (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.006">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should prioritize the caption if both caption and title are provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.012">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should prioritize the caption if both caption and title are provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render the same number of rows as there are data elements (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.016">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render the same number of rows as there are data elements (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.014">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a table matching the data provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.025">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a table matching the data provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.018">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should include a summary in the caption if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.008">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should include a summary in the caption if one is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.02">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should include a summary in the caption if one is provided -- even if no title is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.016">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should include a summary in the caption if one is provided -- even if no title is provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.012">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should do nothing if there are no data labels (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.005">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should do nothing if there are no data labels (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render an X and Y label if axis labels are provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.017">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render an X and Y label if axis labels are provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.022">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render multi dataset labels (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.041">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render multi dataset labels (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.032">
     </testcase>
-    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a multi dataset table matching the data provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.032">
+    <testcase classname="&lt;AccessibleChartTable /&gt; &gt; " name="Should render a multi dataset table matching the data provided (lib-commonjs/controls/chartControl/AccessibleChartTable.test.js)" time="0.022">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;FileTypeIcon /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:19" time="1.82" tests="21">
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.196">
+  <testsuite name="&lt;FileTypeIcon /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:30" time="1.318" tests="21">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.128">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with path (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.01">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with path (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.008">
     </testcase>
     <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with path that contains querystring params (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with path of unknown extension (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.006">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with path of unknown extension (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.013">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test without application or path, should render the generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.008">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test without application or path, should render the generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with both the application and path, should take the path into account (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.01">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Font icon test with both the application and path, should take the path into account (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.006">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.032">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.013">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.009">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path that contains querystring params (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.006">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path that contains querystring params (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path of unknown extension (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.01">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with path of unknown extension (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test without application or path, should render the generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test without application or path, should render the generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with both application and path, should take the path into account (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with both application and path, should take the path into account (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size SMALL test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size SMALL test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size MEDIUM test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.006">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size MEDIUM test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.008">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size LARGE test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size LARGE test (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size SMALL test for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.003">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size SMALL test for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.019">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size MEDIUM test for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size MEDIUM test for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.003">
     </testcase>
     <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size LARGE test for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.008">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size test with unkown size (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size test with unkown size (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.003">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size test with unkown size for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.004">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon size test with unkown size for generic icon (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.003">
     </testcase>
-    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with unkown application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.005">
+    <testcase classname="&lt;FileTypeIcon /&gt; &gt; " name="Image icon test with unkown application (lib-commonjs/controls/fileTypeIcon/FileTypeIcon.test.js)" time="0.006">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;WebPartTitle /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:20" time="0.85" tests="8">
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check the read mode of the component (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.102">
+  <testsuite name="&lt;WebPartTitle /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:32" time="0.649" tests="8">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check the read mode of the component (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.06">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check the edit mode of the component (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.039">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check the edit mode of the component (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check class change (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.008">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check class change (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check if the change is processed correctly (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.009">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check if the change is processed correctly (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is shown if function specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.011">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is shown if function specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.006">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is shown if children specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.01">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is shown if children specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is not shown otherwise (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.007">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check more link is not shown otherwise (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.006">
     </testcase>
-    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check theme&apos;s color is used if specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.042">
+    <testcase classname="&lt;WebPartTitle /&gt; &gt; " name="Check theme&apos;s color is used if specified (lib-commonjs/controls/webPartTitle/WebPartTitle.test.js)" time="0.015">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;ChartControl /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:21" time="1.133" tests="12">
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created by default (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.102">
+  <testsuite name="&lt;ChartControl /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:32" time="0.875" tests="12">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created by default (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.084">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table accepts a custom classname (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.019">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table accepts a custom classname (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.018">
     </testcase>
     <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table doesn&apos;t get rendered if disabled (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created with the caption matching the title (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.012">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created with the caption matching the title (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.014">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created with a caption (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.011">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that an accessible table gets created with a caption (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.012">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table has a number of rows matching the number of data elements (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.027">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table has a number of rows matching the number of data elements (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.015">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table has only one header row (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.008">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that the accessible table has only one header row (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.016">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that custom class gets rendered (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.012">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that custom class gets rendered (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.008">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that a canvas gets rendered (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.021">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that a canvas gets rendered (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.008">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it doesn&apos;t crash if data is omitted (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.015">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it doesn&apos;t crash if data is omitted (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it applies a themed background by default (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.025">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it applies a themed background by default (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.009">
     </testcase>
-    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it disables themed background when useTheme is set to false (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.013">
+    <testcase classname="&lt;ChartControl /&gt; &gt; " name="Check that it disables themed background when useTheme is set to false (lib-commonjs/controls/chartControl/ChartControl.test.js)" time="0.018">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;ListView /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:20" time="1.998" tests="8">
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with an empty array of items (lib-commonjs/controls/listView/ListView.test.js)" time="0.208">
+  <testsuite name="&lt;ListView /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:32" time="1.475" tests="8">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with an empty array of items (lib-commonjs/controls/listView/ListView.test.js)" time="0.137">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with two items (lib-commonjs/controls/listView/ListView.test.js)" time="0.051">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with two items (lib-commonjs/controls/listView/ListView.test.js)" time="0.074">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view by updating the items porperty (lib-commonjs/controls/listView/ListView.test.js)" time="0.05">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view by updating the items porperty (lib-commonjs/controls/listView/ListView.test.js)" time="0.046">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with iconFieldName (lib-commonjs/controls/listView/ListView.test.js)" time="0.166">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with iconFieldName (lib-commonjs/controls/listView/ListView.test.js)" time="0.111">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with iconFieldName render method (lib-commonjs/controls/listView/ListView.test.js)" time="0.057">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with iconFieldName render method (lib-commonjs/controls/listView/ListView.test.js)" time="0.03">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with _flattenItems function (lib-commonjs/controls/listView/ListView.test.js)" time="0.045">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with _flattenItems function (lib-commonjs/controls/listView/ListView.test.js)" time="0.023">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with viewFields (lib-commonjs/controls/listView/ListView.test.js)" time="0.046">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test view with viewFields (lib-commonjs/controls/listView/ListView.test.js)" time="0.03">
     </testcase>
-    <testcase classname="&lt;ListView /&gt; &gt; " name="Test out the sorting method (lib-commonjs/controls/listView/ListView.test.js)" time="0.117">
+    <testcase classname="&lt;ListView /&gt; &gt; " name="Test out the sorting method (lib-commonjs/controls/listView/ListView.test.js)" time="0.072">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;GridLayout /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:22" time="1.246" tests="1">
-    <testcase classname="&lt;GridLayout /&gt; &gt; " name="Test grid layout (lib-commonjs/controls/gridLayout/GridLayout.test.js)" time="0.22">
+  <testsuite name="&lt;GridLayout /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:33" time="0.955" tests="1">
+    <testcase classname="&lt;GridLayout /&gt; &gt; " name="Test grid layout (lib-commonjs/controls/gridLayout/GridLayout.test.js)" time="0.172">
     </testcase>
   </testsuite>
-  <testsuite name="PaletteGenerator" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:22" time="0.837" tests="8">
+  <testsuite name="PaletteGenerator" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:33" time="0.591" tests="8">
     <testcase classname="PaletteGenerator &gt; " name="Should repeat palette if array is longer than number of available colors in repeating palette (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.004">
     </testcase>
-    <testcase classname="PaletteGenerator &gt; " name="Should stretch palette if array is longer than number of available colors in non-repeating palette (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.002">
+    <testcase classname="PaletteGenerator &gt; " name="Should stretch palette if array is longer than number of available colors in non-repeating palette (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.003">
     </testcase>
-    <testcase classname="PaletteGenerator &gt; " name="Should return the right alpha palette length (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.005">
+    <testcase classname="PaletteGenerator &gt; " name="Should return the right alpha palette length (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.009">
     </testcase>
     <testcase classname="PaletteGenerator &gt; " name="Should repeat a shorter array of colors (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.001">
     </testcase>
-    <testcase classname="PaletteGenerator &gt; " name="Should not repeat colors in a gradient (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.003">
+    <testcase classname="PaletteGenerator &gt; " name="Should not repeat colors in a gradient (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.001">
     </testcase>
-    <testcase classname="PaletteGenerator &gt; " name="Should return an array of alpha value for a given array of colors (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.002">
+    <testcase classname="PaletteGenerator &gt; " name="Should return an array of alpha value for a given array of colors (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.001">
     </testcase>
-    <testcase classname="PaletteGenerator &gt; " name="Should return a single alpha value for a single color (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.001">
+    <testcase classname="PaletteGenerator &gt; " name="Should return a single alpha value for a single color (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.002">
     </testcase>
     <testcase classname="PaletteGenerator &gt; " name="Should return a single alpha value for any valid type of color value (lib-commonjs/controls/chartControl/PaletteGenerator.test.js)" time="0.002">
     </testcase>
   </testsuite>
-  <testsuite name="ControlsTestWebPart" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:23" time="0.679" tests="1">
-    <testcase classname="ControlsTestWebPart &gt; " name="should do something (lib-commonjs/webparts/controlsTest/test/ControlsTestWebPart.test.js)" time="0.002">
+  <testsuite name="SPFilePicker helpers" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:34" time="0.647" tests="9">
+    <testcase classname="SPFilePicker helpers buildSPFilePickerConfiguration &gt; " name="builds a token-authenticated file picker configuration (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.004">
+    </testcase>
+    <testcase classname="SPFilePicker helpers buildSPFilePickerConfiguration &gt; " name="omits host authentication in cookie mode (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers isExpectedPickerInitializeEvent &gt; " name="accepts initialization from the expected picker window (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers isExpectedPickerInitializeEvent &gt; " name="rejects initialization with the wrong origin (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers isExpectedPickerInitializeEvent &gt; " name="rejects initialization with the wrong window (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers isExpectedPickerInitializeEvent &gt; " name="rejects initialization with the wrong channel (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers isExpectedPickerInitializeEvent &gt; " name="rejects initialization with the wrong message type (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.001">
+    </testcase>
+    <testcase classname="SPFilePicker helpers requireAccessToken &gt; " name="returns a valid token (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.002">
+    </testcase>
+    <testcase classname="SPFilePicker helpers requireAccessToken &gt; " name="rejects an empty token (lib-commonjs/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.js)" time="0.013">
+    </testcase>
+  </testsuite>
+  <testsuite name="ControlsTestWebPart" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:34" time="0.569" tests="1">
+    <testcase classname="ControlsTestWebPart &gt; " name="should do something (lib-commonjs/webparts/controlsTest/test/ControlsTestWebPart.test.js)" time="0.001">
     </testcase>
   </testsuite>
-  <testsuite name="&lt;Placeholder /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-06-30T14:55:21" time="3.138" tests="6">
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test that placeholder renders (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.05">
+  <testsuite name="&lt;Placeholder /&gt;" errors="0" failures="0" skipped="0" timestamp="2026-08-11T19:43:33" time="2.576" tests="6">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test that placeholder renders (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.035">
     </testcase>
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder without button (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.015">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder without button (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.01">
     </testcase>
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with custom classname (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.008">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with custom classname (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.005">
     </testcase>
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with null values (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.009">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with null values (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.007">
     </testcase>
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with button (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.016">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test placeholder with button (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.012">
     </testcase>
-    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test button onConfigure trigger (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.008">
+    <testcase classname="&lt;Placeholder /&gt; &gt; " name="Test button onConfigure trigger (lib-commonjs/controls/placeholder/PlaceholderComponent.test.js)" time="0.007">
     </testcase>
   </testsuite>
 </testsuites>

package/lib/SPFilePicker.d.ts

@@ -0,0 +1,2 @@
+export * from './controls/SPFilePicker/index';
+//# sourceMappingURL=SPFilePicker.d.ts.map

package/lib/SPFilePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.d.ts","sourceRoot":"","sources":["../src/SPFilePicker.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/lib/SPFilePicker.js

@@ -0,0 +1,2 @@
+export * from './controls/SPFilePicker/index';
+//# sourceMappingURL=SPFilePicker.js.map

package/lib/SPFilePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.js","sourceRoot":"","sources":["../src/SPFilePicker.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/lib/common/telemetry/version.js

@@ -1,2 +1,2 @@
-export var version = "3.25.0-beta.2845356";
+export var version = "3.25.0-beta.3152906";
 //# sourceMappingURL=version.js.map

package/lib/controls/SPFilePicker/ISPFilePicker.types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Types for the SharePoint / OneDrive File Picker (SDK v8).
+ *
+ * The picker is a Microsoft-hosted page (`/_layouts/15/FilePicker.aspx`) that is
+ * embedded in an iframe (or opened in a popup window). The host application and
+ * the picker communicate through `postMessage` + a `MessageChannel` port.
+ *
+ * @see https://learn.microsoft.com/onedrive/developer/controls/file-pickers/
+ */
+/** Selection mode passed to the picker configuration. */
+export type SPFilePickerSelectionMode = 'single' | 'multiple' | 'pick';
+/** What kind of items the user is allowed to pick. */
+export type SPFilePickerItemsMode = 'files' | 'folders' | 'all';
+/** How the picker surface is hosted. */
+export type SPFilePickerTarget = 'iframe' | 'window';
+/**
+ * How the picker authenticates.
+ * - `token` (default): the host supplies SharePoint bearer tokens in response to
+ *   the picker's `authenticate` command (via the SPFx `aadTokenProviderFactory`
+ *   or a custom `getToken`). This is REQUIRED when embedding the picker in an
+ *   iframe (`target: 'iframe'`) — the picker only delivers `pick`/`close`
+ *   commands once a token channel is established — and is the correct mode for
+ *   SPFx web parts. It requires the SharePoint API permissions
+ *   (`AllSites.Read`, `MyFiles.Read`) to be approved in the tenant.
+ * - `cookie`: relies on the user's existing SharePoint session cookies and omits
+ *   the `authentication` config. This ONLY works with the popup window target
+ *   (`target: 'window'`); it is not supported for iframe embedding, where the
+ *   picker would render but never return a selection.
+ */
+export type SPFilePickerAuthMode = 'cookie' | 'token';
+/**
+ * The `entry` section of the picker configuration. Only ONE of these should be
+ * supplied — the picker works with either OneDrive OR SharePoint per instance.
+ * When omitted, the picker defaults to the SharePoint site of `baseUrl`.
+ */
+export interface ISPFilePickerEntry {
+    /** Show the user's OneDrive. */
+    oneDrive?: Record<string, unknown>;
+    /** Show a SharePoint location. */
+    sharePoint?: Record<string, unknown>;
+    /** Show the current SharePoint site (of `baseUrl`). */
+    site?: Record<string, unknown>;
+}
+/**
+ * Raw v8 picker configuration object. Provided as an escape hatch through
+ * {@link ISPFilePickerConfig.raw} for advanced scenarios not covered by the
+ * friendly options.
+ */
+export interface ISPFilePickerRawConfiguration extends Record<string, unknown> {
+    sdk: string;
+    entry: ISPFilePickerEntry;
+    /**
+     * Presence of this object (even if empty) tells the picker the HOST will
+     * supply tokens (token mode). Omit it entirely to make the picker rely on
+     * the user's SharePoint cookies (cookie mode).
+     */
+    authentication?: Record<string, unknown>;
+    messaging: {
+        origin: string;
+        channelId: string;
+        /** Whether the picker should identify/verify the parent window. */
+        identifyParent?: boolean;
+        /** Whether the picker waits for the host configuration before rendering. */
+        waitForConfiguration?: boolean;
+    };
+}
+/**
+ * Friendly configuration used to build the v8 picker configuration.
+ */
+export interface ISPFilePickerConfig {
+    /**
+     * SharePoint web URL used both as the picker host and the token resource,
+     * e.g. `https://contoso.sharepoint.com/sites/dev` or
+     * `https://contoso-my.sharepoint.com`.
+     */
+    baseUrl: string;
+    /** Picker entry point. Defaults to `{ sharePoint: {} }`. */
+    entry?: ISPFilePickerEntry;
+    /** Selection mode. Defaults to `single`. */
+    selectionMode?: SPFilePickerSelectionMode;
+    /** Kind of items that can be picked. Defaults to `files`. */
+    itemsMode?: SPFilePickerItemsMode;
+    /**
+     * Allowed file extensions (without the dot), e.g. `['docx', 'pdf']`.
+     * When omitted, all file types are allowed.
+     */
+    fileTypes?: string[];
+    /** Locale / LCID for the picker UI, e.g. `en-us`. Defaults to `en-us`. */
+    locale?: string;
+    /**
+     * How the picker authenticates. Defaults to `token` (SharePoint bearer tokens
+     * via the SPFx `aadTokenProviderFactory`), which is REQUIRED for the iframe
+     * target and is the correct mode for SPFx web parts. Use `cookie` only with
+     * the popup window target (`target: 'window'`).
+     */
+    authMode?: SPFilePickerAuthMode;
+    /**
+     * The hosting app identifier passed to the picker (query string `app`).
+     * Not set by default. Only needed to opt into a specific SharePoint scenario.
+     */
+    app?: string;
+    /**
+     * The picker scenario passed to the picker (query string `scenario`).
+     * Not set by default. Avoid SharePoint-internal scenarios (e.g. `SPBannerEdit`)
+     * when embedding in a third-party context, as they run scenario-specific init.
+     */
+    scenario?: string;
+    /**
+     * Advanced escape hatch. When supplied, this object is merged over the
+     * generated configuration, allowing any v8 option to be set directly.
+     */
+    raw?: Partial<ISPFilePickerRawConfiguration>;
+}
+/**
+ * The `authenticate` command the picker sends when it needs a token.
+ */
+export interface ISPFilePickerAuthenticateCommand {
+    command: 'authenticate';
+    /** The resource the token must be issued for (a SharePoint URL). */
+    resource: string;
+    /** Token type requested by the picker, e.g. `SharePoint`. */
+    type?: string;
+}
+/**
+ * A single item returned by the picker. Only the guaranteed fields are typed;
+ * the picker returns many more properties depending on the item.
+ *
+ * A drive-item URL can be built as:
+ * `item['@sharePoint.endpoint'] + '/drives/' + item.parentReference.driveId + '/items/' + item.id`
+ */
+export interface ISPFilePickerItem extends Record<string, unknown> {
+    id: string;
+    name?: string;
+    webUrl?: string;
+    size?: number;
+    parentReference?: {
+        driveId?: string;
+        [key: string]: unknown;
+    };
+    '@sharePoint.endpoint'?: string;
+}
+/** Error surfaced by the picker workflow. */
+export interface ISPFilePickerError {
+    code: string;
+    message: string;
+}
+/**
+ * Signature for the token resolver. Given the resource requested by the picker
+ * it must return a valid SharePoint access token for that resource.
+ */
+export type SPFilePickerTokenResolver = (resource: string) => Promise<string>;
+//# sourceMappingURL=ISPFilePicker.types.d.ts.map

package/lib/controls/SPFilePicker/ISPFilePicker.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISPFilePicker.types.d.ts","sourceRoot":"","sources":["../../../src/controls/SPFilePicker/ISPFilePicker.types.ts"],"names":[],"mappings":"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"}

package/lib/controls/SPFilePicker/ISPFilePicker.types.js

@@ -0,0 +1,11 @@
+/**
+ * Types for the SharePoint / OneDrive File Picker (SDK v8).
+ *
+ * The picker is a Microsoft-hosted page (`/_layouts/15/FilePicker.aspx`) that is
+ * embedded in an iframe (or opened in a popup window). The host application and
+ * the picker communicate through `postMessage` + a `MessageChannel` port.
+ *
+ * @see https://learn.microsoft.com/onedrive/developer/controls/file-pickers/
+ */
+export {};
+//# sourceMappingURL=ISPFilePicker.types.js.map

package/lib/controls/SPFilePicker/ISPFilePicker.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISPFilePicker.types.js","sourceRoot":"","sources":["../../../src/controls/SPFilePicker/ISPFilePicker.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/lib/controls/SPFilePicker/ISPFilePickerProps.d.ts

@@ -0,0 +1,80 @@
+import type { MouseEventHandler, ReactElement } from 'react';
+import type { WebPartContext } from '@microsoft/sp-webpart-base';
+import type { ISPFilePickerEntry, ISPFilePickerError, ISPFilePickerItem, SPFilePickerAuthMode, SPFilePickerItemsMode, SPFilePickerSelectionMode, SPFilePickerTarget, SPFilePickerTokenResolver } from './ISPFilePicker.types';
+export interface ISPFilePickerTriggerProps {
+    'aria-disabled'?: boolean;
+    className?: string;
+    onClick?: MouseEventHandler<HTMLElement>;
+}
+/**
+ * Props for the ready-to-use {@link SPFilePicker} component.
+ *
+ * The component renders a trigger button that opens the SharePoint / OneDrive
+ * File Picker (v8) inside a modal dialog (iframe) or a popup window. For full
+ * control over the surface, use the {@link useSPFilePicker} hook directly.
+ */
+export interface ISPFilePickerProps {
+    /**
+     * The SPFx web part context. Used to resolve the default `baseUrl` from
+     * `pageContext.web.absoluteUrl` and to acquire SharePoint access tokens via
+     * the `aadTokenProviderFactory` when no custom `getToken` is supplied.
+     */
+    context: WebPartContext;
+    /**
+     * SharePoint web URL used as the picker host and token resource. When omitted,
+     * the component falls back to `context.pageContext.web.absoluteUrl`.
+     */
+    baseUrl?: string;
+    /** Picker entry point. Defaults to `{ sharePoint: {} }`. */
+    entry?: ISPFilePickerEntry;
+    /** Selection mode. Defaults to `single`. */
+    selectionMode?: SPFilePickerSelectionMode;
+    /** Kind of items that can be picked. Defaults to `files`. */
+    itemsMode?: SPFilePickerItemsMode;
+    /** Allowed file extensions (without the dot), e.g. `['docx', 'pdf']`. */
+    fileTypes?: string[];
+    /** Locale / LCID for the picker UI. Defaults to `en-us`. */
+    locale?: string;
+    /**
+     * How the picker authenticates. Defaults to `token` (SharePoint bearer tokens
+     * via the SPFx `aadTokenProviderFactory` or a custom `getToken`), which is
+     * REQUIRED for the iframe target and is the correct mode for SPFx web parts.
+     * Use `cookie` only with the popup window target (`target: 'window'`).
+     */
+    authMode?: SPFilePickerAuthMode;
+    /** Hosting app identifier (query string `app`). Not set by default. */
+    app?: string;
+    /** Picker scenario (query string `scenario`). Not set by default. */
+    scenario?: string;
+    /** Where the picker is hosted. Defaults to `iframe` (rendered in a dialog). */
+    target?: SPFilePickerTarget;
+    /**
+     * Custom token resolver. When omitted, the SPFx `aadTokenProviderFactory`
+     * from `context` is used to acquire a token for the SharePoint resource.
+     */
+    getToken?: SPFilePickerTokenResolver;
+    /** Fired with the picked items when the user confirms a selection. */
+    onPicked: (items: ISPFilePickerItem[]) => void;
+    /** Fired when the picker is cancelled / closed without a selection. */
+    onCancel?: () => void;
+    /** Fired when an error occurs during the picker workflow. */
+    onError?: (error: ISPFilePickerError) => void;
+    /**
+     * Custom interactive trigger element. When provided it replaces the default
+     * button and receives an `onClick` handler that opens the picker.
+     */
+    trigger?: ReactElement<ISPFilePickerTriggerProps>;
+    /** Text for the default trigger button. Defaults to `Select from SharePoint`. */
+    buttonText?: string;
+    /** Accessible title applied to the picker iframe. Defaults to `Select a file`. */
+    dialogTitle?: string;
+    /** Disable the trigger. */
+    disabled?: boolean;
+    /** Dialog width in px (iframe target). Defaults to `1080`. */
+    dialogWidth?: number;
+    /** Dialog / iframe height in px (iframe target). Defaults to `680`. */
+    dialogHeight?: number;
+    /** Additional CSS class applied to the trigger element. */
+    className?: string;
+}
+//# sourceMappingURL=ISPFilePickerProps.d.ts.map