Add option to not re-focus ComboBox when invoking clear() (#1000)

* feat(combo-box): add option to clear accessor to not re-focus input

Closes #994

* yarn build:lib

* test(combo-box): validate clear accessor params

* docs(combo-box): add clear without focus to "Clear selection" example

docs/src/COMPONENT_API.json

@@ -1615,8 +1615,8 @@
           "name": "clear",
           "kind": "function",
           "description": "Clear the combo box programmatically",
-          "type": "() => void",
-          "value": "() => {     prevSelectedIndex = undefined;     selectedIndex = -1;     highlightedIndex = -1;     highlightedId = undefined;     selectedId = undefined;     selectedItem = undefined;     open = false;     inputValue = \"\";     ref?.focus();   }",
+          "type": "(options?: { focus?: boolean; }) => void",
+          "value": "() => {     prevSelectedIndex = undefined;     selectedIndex = -1;     highlightedIndex = -1;     highlightedId = undefined;     selectedId = undefined;     selectedItem = undefined;     open = false;     inputValue = \"\";     if (options?.focus !== false) ref?.focus();   }",
           "isFunction": true,
           "isFunctionDeclaration": true,
           "constant": false,

docs/src/pages/components/ComboBox.svx

@@ -1,9 +1,6 @@
 <script>
   import { ComboBox } from "carbon-components-svelte";
-  import { Button } from "carbon-components-svelte";
   import Preview from "../../components/Preview.svelte";
-  let comboboxComponent
-  let selectedIndex = 1
 </script>
 
 ### Default
@@ -31,15 +28,11 @@ items={[
 
 ### Clear selection
 
-<ComboBox titleText="Contact" placeholder="Select contact method"
-bind:this={comboboxComponent} 
-items={[
-  {id: "0", text: "Slack"},
-  {id: "1", text: "Email"},
-  {id: "2", text: "Fax"}
-  ]}  />
-<br>
-<Button on:click={comboboxComponent.clear}>Clear</Button>
+To programmatically clear the selection, access the component instance using the [bind:this](https://svelte.dev/docs#bind_element) directive and invoke the `ComboBox.clear()` accessor.
+
+Specify `focus: false` in the method options to avoid re-focusing the input.
+
+<FileSource src="/framed/ComboBox/ComboBoxClear" />
 
 ### Multiple combo boxes
 

docs/src/pages/framed/ComboBox/ComboBoxClear.svelte

@@ -0,0 +1,20 @@
+<script>
+  import { ComboBox, Button } from "carbon-components-svelte";
+
+  let ref;
+</script>
+
+<ComboBox
+  titleText="Contact"
+  placeholder="Select contact method"
+  selectedIndex="{1}"
+  bind:this="{ref}"
+  items="{[
+    { id: '0', text: 'Slack' },
+    { id: '1', text: 'Email' },
+    { id: '2', text: 'Fax' },
+  ]}"
+/>
+<br />
+<Button on:click="{ref.clear}">Clear</Button>
+<Button on:click="{() => ref.clear({ focus: false })}">Clear (no focus)</Button>