refactor: update/fix JSDoc props

src/UIShell/GlobalHeader/Header.svelte

@@ -1,44 +1,37 @@
 <script>
-  /**
-   * Set to `false` to hide the side nav by default
-   * @type {boolean} [expandedByDefault=true]
-   */
+  /** Set to `false` to hide the side nav by default */
   export let expandedByDefault = true;
 
-  /**
-   * Set to `true` to open the side nav
-   * @type {boolean} [isSideNavOpen=false]
-   */
+  /** Set to `true` to open the side nav */
   export let isSideNavOpen = false;
 
   /**
    * Specify the ARIA label for the header
-   * @type {string} [uiShellAriaLabel]
+   * @type {string}
    */
   export let uiShellAriaLabel = undefined;
 
   /**
    * Specify the `href` attribute
-   * @type {string} [href]
+   * @type {string}
    */
   export let href = undefined;
 
   /**
    * Specify the company name
-   * @type {string} [company]
+   * @type {string}
    */
   export let company = undefined;
 
   /**
    * Specify the platform name
    * Alternatively, use the named slot "platform" (e.g. <span slot="platform">...</span>)
-   * @type {string} [platformName=""]
    */
   export let platformName = "";
 
   /**
    * Obtain a reference to the HTML anchor element
-   * @type {null | HTMLAnchorElement} [ref=null]
+   * @type {null | HTMLAnchorElement}
    */
   export let ref = null;
 

src/UIShell/GlobalHeader/HeaderAction.svelte

@@ -1,26 +1,23 @@
 <script>
-  /**
-   * Set to `true` to open the panel
-   * @type {boolean} [isOpen=false]
-   */
+  /** Set to `true` to open the panel */
   export let isOpen = false;
 
   /**
    * Specify the icon props
-   * @type {{ render: typeof import("carbon-icons-svelte/lib/Add16").default; skeleton: boolean; }} [icon]
+   * @type {{ render: typeof import("carbon-icons-svelte/lib/Add16").default; skeleton: boolean; }}
    */
   export let icon = undefined;
 
   /**
    * Specify the text
    * Alternatively, use the named slot "text" (e.g. <div slot="text">...</div>)
-   * @type {string} [text]
+   * @type {string}
    */
   export let text = undefined;
 
   /**
    * Obtain a reference to the button HTML element
-   * @type {null | HTMLButtonElement} [ref=null]
+   * @type {null | HTMLButtonElement}
    */
   export let ref = null;
 

src/UIShell/GlobalHeader/HeaderActionLink.svelte

@@ -1,25 +1,22 @@
 <script>
-  /**
-   * Set to `true` to use the active state
-   * @type {boolean} [linkIsActive=false]
-   */
+  /** Set to `true` to use the active state */
   export let linkIsActive = false;
 
   /**
    * Specify the `href` attribute
-   * @type {string} [href]
+   * @type {string}
    */
   export let href = undefined;
 
   /**
    * Specify the icon props
-   * @type {{ render: typeof import("carbon-icons-svelte/lib/Add16").default; skeleton: boolean; }} [icon]
+   * @type {{ render: typeof import("carbon-icons-svelte/lib/Add16").default; skeleton: boolean; }}
    */
   export let icon = undefined;
 
   /**
    * Obtain a reference to the HTML anchor element
-   * @type {null | HTMLAnchorElement} [ref=null]
+   * @type {null | HTMLAnchorElement}
    */
   export let ref = null;
 

src/UIShell/GlobalHeader/HeaderActionSearch.svelte

@@ -1,8 +1,9 @@
 <script>
   /**
-   * Set to `true` to focus the search
-   * @type {boolean} [searchIsActive=false]
+   * @event {{ action: "search"; textInput: string; }} inputSearch
    */
+
+  /** Set to `true` to focus the search */
   export let searchIsActive = false;
 
   import { createEventDispatcher } from "svelte";
@@ -24,6 +25,7 @@
       action: "search",
       textInput: event.target.value,
     };
+
     dispatch("inputSearch", params);
   }
 

src/UIShell/GlobalHeader/HeaderNav.svelte

@@ -1,7 +1,7 @@
 <script>
   /**
    * Specify the ARIA label for the nav
-   * @type {string} [ariaLabel]
+   * @type {string}
    */
   export let ariaLabel = undefined;
 </script>

src/UIShell/GlobalHeader/HeaderNavItem.svelte

@@ -1,19 +1,19 @@
 <script>
   /**
    * Specify the `href` attribute
-   * @type {string} [href]
+   * @type {string}
    */
   export let href = undefined;
 
   /**
    * Specify the text
-   * @type {string} [text]
+   * @type {string}
    */
   export let text = undefined;
 
   /**
    * Obtain a reference to the HTML anchor element
-   * @type {null | HTMLAnchorElement} [ref=null]
+   * @type {null | HTMLAnchorElement}
    */
   export let ref = null;
 </script>

src/UIShell/GlobalHeader/HeaderNavMenu.svelte

@@ -1,32 +1,23 @@
 <script>
-  /**
-   * Set to `true` to toggle the expanded state
-   * @type {boolean} [expanded=false]
-   */
+  /** Set to `true` to toggle the expanded state */
   export let expanded = false;
 
-  /**
-   * Specify the `href` attribute
-   * @type {string} [href="/"]
-   */
+  /** Specify the `href` attribute */
   export let href = "/";
 
   /**
    * Specify the text
-   * @type {string} [text]
+   * @type {string}
    */
   export let text = undefined;
 
   /**
    * Obtain a reference to the HTML anchor element
-   * @type {null | HTMLAnchorElement} [ref=null]
+   * @type {null | HTMLAnchorElement}
    */
   export let ref = null;
 
-  /**
-   * Specify the ARIA label for the chevron icon
-   * @type {string} [iconDescription="Expand/Collapse"]
-   */
+  /** Specify the ARIA label for the chevron icon */
   export let iconDescription = "Expand/Collapse";
 
   import ChevronDown16 from "carbon-icons-svelte/lib/ChevronDown16";

src/UIShell/GlobalHeader/HeaderPanelLink.svelte

@@ -1,13 +1,13 @@
 <script>
   /**
    * Specify the `href` attribute
-   * @type {string} [href]
+   * @type {string}
    */
   export let href = undefined;
 
   /**
    * Obtain a reference to the HTML anchor element
-   * @type {null | HTMLAnchorElement} [ref=null]
+   * @type {null | HTMLAnchorElement}
    */
   export let ref = null;
 </script>