Alignment with Carbon version 10.31 (#571)

* chore(deps-dev): upgrade carbon-components to v10.31.0

* fix(slider): use CSS to hide input if hideTextInput is true

* docs(slider): add hidden text input, invalid, disabled examples

* feat(tabs): support "container" type for TabsSkeleton

* chore(list-box): remove hotfix inline style to center dropdown chevron

* fix(number-input): use add, subtract icons and update markup

* feat(select): add warning state

* docs(select): add invalid state example

* docs(select): add helper text example

* fix(structured-list): add "rowgroup" role to StructuredListBody

* docs: release code snippet max-width

* docs(select): add skeleton hidden label example

* feat(popover): add Popover component

* feat(pagination): dispatch button click events to be consistent with PaginationNav

* fix(multi-select): type clear as a custom event

* docs(radio-button): add disabled buttons example

* chore(tabs): use absolute icon import

* fix(link): remove line breaks within anchor link

* docs(radio-button): adjust section copy verbiage

* chore(deps-dev): upgrade carbon-icons-svelte to v10.27

v10.27 uses the SvelteComponentTyped interface

* docs(accordion): adjust section title verbiage

* test(types): fix warnings from svelte-check

* fix(search): only set autofocus attribute if equals true

* feat(popover): add closeOnOutsideClick prop

* docs: style [data-outline] as relative positioned

* feat(context-menu): add initial ContextMenu

* feat(context-menu): annotate props, generate types

* feat(context-menu): add initial focus logic

* fix(context-menu): correctly tab in/out of nested menus

* chore(context-menu): update types

* fix(context-menu): obtain radio id from node directly

* docs(context-menu): add examples and test

* fix(context-menu): prevent default keydown behavior

types/ContextMenu/ContextMenu.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface ContextMenuProps
+  extends svelte.JSX.HTMLAttributes<HTMLElementTagNameMap["ul"]> {
+  /**
+   * Set to `true` to open the menu
+   * Either `x` and `y` must be greater than zero
+   * @default false
+   */
+  open?: boolean;
+
+  /**
+   * Specify the horizontal offset of the menu position
+   * @default 0
+   */
+  x?: number;
+
+  /**
+   * Specify the vertical offset of the menu position
+   * @default 0
+   */
+  y?: number;
+
+  /**
+   * Obtain a reference to the unordered list HTML element
+   * @default null
+   */
+  ref?: null | HTMLUListElement;
+}
+
+export default class ContextMenu extends SvelteComponentTyped<
+  ContextMenuProps,
+  {
+    click: WindowEventMap["click"];
+    keydown: WindowEventMap["keydown"];
+    open: CustomEvent<any>;
+    close: CustomEvent<any>;
+  },
+  { default: {} }
+> {}

types/ContextMenu/ContextMenuDivider.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface ContextMenuDividerProps {}
+
+export default class ContextMenuDivider extends SvelteComponentTyped<
+  ContextMenuDividerProps,
+  {},
+  {}
+> {}

types/ContextMenu/ContextMenuGroup.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface ContextMenuGroupProps {
+  /**
+   * @default []
+   */
+  selectedIds?: string[];
+
+  /**
+   * Specify the label text
+   * @default ""
+   */
+  labelText?: string;
+}
+
+export default class ContextMenuGroup extends SvelteComponentTyped<
+  ContextMenuGroupProps,
+  {},
+  { default: {} }
+> {}

types/ContextMenu/ContextMenuOption.d.ts

@@ -0,0 +1,74 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface ContextMenuOptionProps
+  extends svelte.JSX.HTMLAttributes<HTMLElementTagNameMap["li"]> {
+  /**
+   * Set to `true` to enable the disabled state
+   * @default false
+   */
+  disabled?: boolean;
+
+  /**
+   * Set to `true` to indent the label
+   * @default false
+   */
+  indented?: boolean;
+
+  /**
+   * Specify the icon from `carbon-icons-svelte` to render
+   * Icon is rendered to the left of the label text
+   */
+  icon?: typeof import("carbon-icons-svelte").CarbonIcon;
+
+  /**
+   * Specify the label text
+   * Alternatively, use the "labelText" slot (e.g., <span slot="labelText">...</span>)
+   * @default ""
+   */
+  labelText?: string;
+
+  /**
+   * Set to `true` to use the selected variant
+   * @default false
+   */
+  selected?: boolean;
+
+  /**
+   * Set to `true` to enable the selectable variant
+   * Automatically set to `true` if `selected` is `true`
+   * @default false
+   */
+  selectable?: boolean;
+
+  /**
+   * Specify the shortcut text
+   * Alternatively, use the "shortcutText" slot (e.g., <span slot="shortcutText">...</span>)
+   * @default ""
+   */
+  shortcutText?: string;
+
+  /**
+   * Specify the id
+   * It's recommended to provide an id as a value to bind to within a selectable/radio menu group
+   * @default "ccs-" + Math.random().toString(36)
+   */
+  id?: string;
+
+  /**
+   * Obtain a reference to the list item HTML element
+   * @default null
+   */
+  ref?: null | HTMLLIElement;
+}
+
+export default class ContextMenuOption extends SvelteComponentTyped<
+  ContextMenuOptionProps,
+  {
+    keydown: WindowEventMap["keydown"];
+    mouseenter: WindowEventMap["mouseenter"];
+    mouseleave: WindowEventMap["mouseleave"];
+    click: CustomEvent<any>;
+  },
+  { default: {}; labelText: {}; shortcutText: {} }
+> {}

types/ContextMenu/ContextMenuRadioGroup.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface ContextMenuRadioGroupProps {
+  /**
+   * Set the selected radio group id
+   * @default ""
+   */
+  selectedId?: string;
+
+  /**
+   * Specify the label text
+   * @default ""
+   */
+  labelText?: string;
+}
+
+export default class ContextMenuRadioGroup extends SvelteComponentTyped<
+  ContextMenuRadioGroupProps,
+  {},
+  { default: {} }
+> {}

types/MultiSelect/MultiSelect.d.ts

@@ -184,7 +184,7 @@ export default class MultiSelect extends SvelteComponentTyped<
       selected: MultiSelectItem[];
       unselected: MultiSelectItem[];
     }>;
-    clear: WindowEventMap["clear"];
+    clear: CustomEvent<any>;
     keydown: WindowEventMap["keydown"];
     focus: WindowEventMap["focus"];
     blur: WindowEventMap["blur"];

types/Pagination/Pagination.d.ts

@@ -102,6 +102,10 @@ export interface PaginationProps
 
 export default class Pagination extends SvelteComponentTyped<
   PaginationProps,
-  { update: CustomEvent<{ pageSize: number; page: number }> },
+  {
+    update: CustomEvent<{ pageSize: number; page: number }>;
+    ["click:button--previous"]: CustomEvent<{ page: number }>;
+    ["click:button--next"]: CustomEvent<{ page: number }>;
+  },
   {}
 > {}

types/Popover/Popover.d.ts

@@ -0,0 +1,65 @@
+/// <reference types="svelte" />
+import { SvelteComponentTyped } from "svelte";
+
+export interface PopoverProps
+  extends svelte.JSX.HTMLAttributes<HTMLElementTagNameMap["div"]> {
+  /**
+   * Set to `true` to display the popover
+   * @default false
+   */
+  open?: boolean;
+
+  /**
+   * Set to `true` to close the popover on an outside click
+   * @default false
+   */
+  closeOnOutsideClick?: boolean;
+
+  /**
+   * Set to `true` render a caret
+   * @default false
+   */
+  caret?: boolean;
+
+  /**
+   * Specify the alignment of the caret
+   * @default "top"
+   */
+  align?:
+    | "top"
+    | "top-left"
+    | "top-right"
+    | "bottom"
+    | "bottom-left"
+    | "bottom-right"
+    | "left"
+    | "left-bottom"
+    | "left-top"
+    | "right"
+    | "right-bottom"
+    | "right-top";
+
+  /**
+   * Set to `true` to enable the light variant
+   * @default false
+   */
+  light?: boolean;
+
+  /**
+   * Set to `true` to enable the high contrast variant
+   * @default false
+   */
+  highContrast?: boolean;
+
+  /**
+   * Set to `true` to use a relative position
+   * @default false
+   */
+  relative?: boolean;
+}
+
+export default class Popover extends SvelteComponentTyped<
+  PopoverProps,
+  { ["click:outside"]: CustomEvent<any> },
+  { default: {} }
+> {}

types/Select/Select.d.ts

@@ -54,6 +54,18 @@ export interface SelectProps
    */
   invalidText?: string;
 
+  /**
+   * Set to `true` to indicate an warning state
+   * @default false
+   */
+  warn?: boolean;
+
+  /**
+   * Specify the warning state text
+   * @default ""
+   */
+  warnText?: string;
+
   /**
    * Specify the helper text
    * @default ""

types/Tabs/TabsSkeleton.d.ts

@@ -8,6 +8,12 @@ export interface TabsSkeletonProps
    * @default 4
    */
   count?: number;
+
+  /**
+   * Specify the type of tabs
+   * @default "default"
+   */
+  type?: "default" | "container";
 }
 
 export default class TabsSkeleton extends SvelteComponentTyped<

types/index.d.ts

@@ -12,6 +12,11 @@ export { default as Checkbox } from "./Checkbox/Checkbox";
 export { default as CheckboxSkeleton } from "./Checkbox/CheckboxSkeleton";
 export { default as ContentSwitcher } from "./ContentSwitcher/ContentSwitcher";
 export { default as Switch } from "./ContentSwitcher/Switch";
+export { default as ContextMenu } from "./ContextMenu/ContextMenu";
+export { default as ContextMenuDivider } from "./ContextMenu/ContextMenuDivider";
+export { default as ContextMenuGroup } from "./ContextMenu/ContextMenuGroup";
+export { default as ContextMenuOption } from "./ContextMenu/ContextMenuOption";
+export { default as ContextMenuRadioGroup } from "./ContextMenu/ContextMenuRadioGroup";
 export { default as Copy } from "./Copy/Copy";
 export { default as CopyButton } from "./CopyButton/CopyButton";
 export { default as ComboBox } from "./ComboBox/ComboBox";
@@ -86,6 +91,7 @@ export { default as OverflowMenuItem } from "./OverflowMenu/OverflowMenuItem";
 export { default as Pagination } from "./Pagination/Pagination";
 export { default as PaginationSkeleton } from "./Pagination/PaginationSkeleton";
 export { default as PaginationNav } from "./PaginationNav/PaginationNav";
+export { default as Popover } from "./Popover/Popover";
 export { default as ProgressIndicator } from "./ProgressIndicator/ProgressIndicator";
 export { default as ProgressIndicatorSkeleton } from "./ProgressIndicator/ProgressIndicatorSkeleton";
 export { default as ProgressStep } from "./ProgressIndicator/ProgressStep";