fix(file-uploader): update clearFiles accessor description (#1122)

The `clearFiles` prop description currently reads "Override the default behavior of clearing the array of uploaded files."

This is misleading as `clearFiles` is a component accessor, not a `let` prop.

COMPONENT_INDEX.md

@@ -1262,12 +1262,12 @@ None.
 ### Props
 
 | Prop name        | Kind               | Reactive | Type                                                                                       | Default value                           | Description                                                 |
-| :--------------- | :----------------- | :------- | :----------------------------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------------------------- |
+| :--------------- | :----------------- | :------- | :----------------------------------------------------------------------------------------- | --------------------------------------- | ----------------------------------------------------------- |
 | files            | <code>let</code>   | Yes      | <code>File[]</code>                                                                        | <code>[]</code>                         | Obtain the uploaded file names                              |
 | status           | <code>let</code>   | No       | <code>"uploading" &#124; "edit" &#124; "complete"</code>                                   | <code>"uploading"</code>                | Specify the file uploader status                            |
 | accept           | <code>let</code>   | No       | <code>string[]</code>                                                                      | <code>[]</code>                         | Specify the accepted file types                             |
 | multiple         | <code>let</code>   | No       | <code>boolean</code>                                                                       | <code>false</code>                      | Set to `true` to allow multiple files                       |
-| clearFiles       | <code>const</code> | No       | <code>() => void</code>                                                                    | <code>() => { files = []; }</code>      | Override the default behavior of clearing the array of uploaded files |
+| clearFiles       | <code>const</code> | No       | <code>() => void</code>                                                                    | <code>() => { files = []; }</code>      | Programmatically clear the uploaded files                   |
 | labelDescription | <code>let</code>   | No       | <code>string</code>                                                                        | <code>""</code>                         | Specify the label description                               |
 | labelTitle       | <code>let</code>   | No       | <code>string</code>                                                                        | <code>""</code>                         | Specify the label title                                     |
 | kind             | <code>let</code>   | No       | <code>"primary" &#124; "secondary" &#124; "tertiary" &#124; "ghost" &#124; "danger"</code> | <code>"primary"</code>                  | Specify the kind of file uploader button                    |

docs/src/COMPONENT_API.json

@@ -3503,7 +3503,7 @@
         {
           "name": "clearFiles",
           "kind": "const",
-          "description": "Override the default behavior of clearing the array of uploaded files",
+          "description": "Programmatically clear the uploaded files",
           "type": "() => void",
           "value": "() => {     files = [];   }",
           "isFunction": true,

src/FileUploader/FileUploader.svelte

@@ -27,7 +27,7 @@
   export let multiple = false;
 
   /**
-   * Override the default behavior of clearing the array of uploaded files
+   * Programmatically clear the uploaded files
    * @type {() => void}
    */
   export const clearFiles = () => {

tests/FileUploader.test.svelte

@@ -6,6 +6,10 @@
     FileUploaderItem,
     FileUploaderSkeleton,
   } from "../types";
+
+  let fileUploader: FileUploader;
+
+  $: fileUploader?.clearFiles();
 </script>
 
 <FileUploaderButton
@@ -16,6 +20,7 @@
 />
 
 <FileUploader
+  bind:this="{fileUploader}"
   multiple
   labelTitle="Upload files"
   buttonLabel="Add files"

types/FileUploader/FileUploader.svelte.d.ts

@@ -79,7 +79,7 @@ export default class FileUploader extends SvelteComponentTyped<
   {}
 > {
   /**
-   * Override the default behavior of clearing the array of uploaded files
+   * Programmatically clear the uploaded files
    */
   clearFiles: () => void;
 }