@oicl/openbridge-webcomponents-svelte 2.0.0-next.159 → 2.0.0-next.160

package/dist/components/alert-menu/ObcAlertMenu.svelte

@@ -10,26 +10,14 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** If true, displays the "Shelved" tab and enables shelving support for alerts.
-Set to false to hide the "Shelved" tab and related filtering.
-
-Default: false. */
-hasShelved?: boolean;
-      /** If true, enables the "ACK visible" button, allowing users to acknowledge all currently visible alerts in the active tab.
-Should be set to true only when there are unacknowledged alerts in view.
-
-Default: false. */
-canAckAll?: boolean;
-      /** If true, shows the "Silence" button in the action bar.
-When hidden, the "ACK visible" button expands to fill the freed space.
-
-Default: true. */
-showSilenceButton?: boolean;
-      /** If true, shows the "Alerts" navigation button in the action bar.
-When hidden, the "ACK visible" button expands to fill the freed space.
-
-Default: true. */
-showAlertListButton?: boolean
+     /** If true, displays the "Shelved" tab and enables shelving support for alerts. Set to false to hide the "Shelved" tab and related filtering. */
+     hasShelved?: boolean;
+     /** If true, enables the "ACK visible" button, allowing users to acknowledge all currently visible alerts in the active tab. Should be set to true only when there are unacknowledged alerts in view. */
+     canAckAll?: boolean;
+     /** If true, shows the "Silence" button in the action bar. When hidden, the "ACK visible" button expands to fill the freed space. */
+     showSilenceButton?: boolean;
+     /** If true, shows the "Alerts" navigation button in the action bar. When hidden, the "ACK visible" button expands to fill the freed space. */
+     showAlertListButton?: boolean
    }
       export interface Events {
     onAckAllVisibleClick?: (event: ObcAckAllVisibleClickEvent) => void;

package/dist/components/alert-menu/ObcAlertMenu.svelte.d.ts

@@ -4,25 +4,13 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** If true, displays the "Shelved" tab and enables shelving support for alerts.
-Set to false to hide the "Shelved" tab and related filtering.
-
-Default: false. */
+    /** If true, displays the "Shelved" tab and enables shelving support for alerts. Set to false to hide the "Shelved" tab and related filtering. */
     hasShelved?: boolean;
-    /** If true, enables the "ACK visible" button, allowing users to acknowledge all currently visible alerts in the active tab.
-Should be set to true only when there are unacknowledged alerts in view.
-
-Default: false. */
+    /** If true, enables the "ACK visible" button, allowing users to acknowledge all currently visible alerts in the active tab. Should be set to true only when there are unacknowledged alerts in view. */
     canAckAll?: boolean;
-    /** If true, shows the "Silence" button in the action bar.
-When hidden, the "ACK visible" button expands to fill the freed space.
-
-Default: true. */
+    /** If true, shows the "Silence" button in the action bar. When hidden, the "ACK visible" button expands to fill the freed space. */
     showSilenceButton?: boolean;
-    /** If true, shows the "Alerts" navigation button in the action bar.
-When hidden, the "ACK visible" button expands to fill the freed space.
-
-Default: true. */
+    /** If true, shows the "Alerts" navigation button in the action bar. When hidden, the "ACK visible" button expands to fill the freed space. */
     showAlertListButton?: boolean;
 }
 export interface Events {

package/dist/components/alert-menu-item/ObcAlertMenuItem.svelte

@@ -34,10 +34,10 @@ import type {ObcMessageMenuItemSize} from '@oicl/openbridge-webcomponents/dist/c
      animateIntro?: boolean;
      /** The label for the secondary action button. Unlike the primary (ACK) action, the secondary label is not derived from `status`; it must be provided explicitly. The secondary action is only shown when a non-empty label is set and `secondaryActionState` is not `none`. */
      secondaryActionLabel?: string;
-      /** [object Object],[object Object],[object Object] */
-primaryActionState?: ObcAlertMenuItemActionState;
-      /** [object Object],[object Object],[object Object] */
-secondaryActionState?: ObcAlertMenuItemActionState
+     /** Appearance of the primary (ACK) action: `enabled`, `disabled` or `none`, which hides it. */
+     primaryActionState?: ObcAlertMenuItemActionState;
+     /** Appearance of the secondary action: `enabled`, `disabled` or `none`, which hides it. */
+     secondaryActionState?: ObcAlertMenuItemActionState
    }
       export interface Events {
     onAckClick?: (event: CustomEvent<void>) => void;

package/dist/components/alert-menu-item/ObcAlertMenuItem.svelte.d.ts

@@ -27,9 +27,9 @@ export interface Props {
     animateIntro?: boolean;
     /** The label for the secondary action button. Unlike the primary (ACK) action, the secondary label is not derived from `status`; it must be provided explicitly. The secondary action is only shown when a non-empty label is set and `secondaryActionState` is not `none`. */
     secondaryActionLabel?: string;
-    /** [object Object],[object Object],[object Object] */
+    /** Appearance of the primary (ACK) action: `enabled`, `disabled` or `none`, which hides it. */
     primaryActionState?: ObcAlertMenuItemActionState;
-    /** [object Object],[object Object],[object Object] */
+    /** Appearance of the secondary action: `enabled`, `disabled` or `none`, which hides it. */
     secondaryActionState?: ObcAlertMenuItemActionState;
 }
 export interface Events {

package/dist/components/app-button/ObcAppButton.svelte

@@ -10,8 +10,12 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Sets the button's text label. */
-label?: string;
+     /**
+      * Sets the button's text label.
+      *
+      * Available when `showLabel==true`.
+      */
+     label?: string;
      /** If true, applies the "checked" visual style to indicate selection or active state. */
      checked?: boolean;
      /** If true, shows the button's label. */

package/dist/components/app-button/ObcAppButton.svelte.d.ts

@@ -4,7 +4,11 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Sets the button's text label. */
+    /**
+     * Sets the button's text label.
+     *
+     * Available when `showLabel==true`.
+     */
     label?: string;
     /** If true, applies the "checked" visual style to indicate selection or active state. */
     checked?: boolean;

package/dist/components/badge/ObcBadge.svelte

@@ -10,34 +10,22 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** The number to display in the badge. Set to 0 for no count.
-
-If `showNumber` is false, the number is hidden. */
-number?: number;
-      /** Shows the number in the badge when true.
-
-Set to `false` for symbolic or icon-only badges. */
-showNumber?: boolean;
-      /** Visual style/type of the badge.
-
-Possible values: `regular`, `alarm`, `warning`, `caution`, `level-critical`, `level-high`, `level-medium`, `level-low`, `level-diagnostic`, `running`, `notification`, `enhance`, `automation`, `outline`, `empty`.
-
-Defaults to `regular`. */
-type?: string;
-      /** Badge size.
-
-Possible values: `regular` (default), `large`. */
-size?: string;
-      /** Badge variant.
-
-- `default`: Filled background and border (default).
-- `flat`: Minimal background and outline. */
-variant?: BadgeVariant;
-      /** Whether to show an icon in the badge.
-
-For built-in types (`alarm`, `warning`, `caution`, the `level-*` severities, and `running`), a contextual icon is shown automatically.
-For other types, provide a custom icon in the `badge-icon` slot. */
-showIcon?: boolean
+     /**
+      * The number to display in the badge. Set to 0 for no count. If `showNumber` is false, the number is hidden.
+      *
+      * Available when `showNumber==true`.
+      */
+     number?: number;
+     /** Shows the number in the badge when true. Set to `false` for symbolic or icon-only badges. */
+     showNumber?: boolean;
+     /** Visual style/type of the badge. Possible values: `regular`, `alarm`, `warning`, `caution`, `level-critical`, `level-high`, `level-medium`, `level-low`, `level-diagnostic`, `running`, `notification`, `enhance`, `automation`, `outline`, `empty`. Defaults to `regular`. */
+     type?: string;
+     /** Badge size. Possible values: `regular` (default), `large`. */
+     size?: string;
+     /** Badge variant: `default` has a filled background and border, `flat` a minimal background and outline. */
+     variant?: BadgeVariant;
+     /** Whether to show an icon in the badge. For built-in types (`alarm`, `warning`, `caution`, the `level-*` severities, and `running`), a contextual icon is shown automatically. For other types, provide a custom icon in the `badge-icon` slot. */
+     showIcon?: boolean
    }
       export interface Events {
     

package/dist/components/badge/ObcBadge.svelte.d.ts

@@ -4,33 +4,21 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** The number to display in the badge. Set to 0 for no count.
-
-If `showNumber` is false, the number is hidden. */
+    /**
+     * The number to display in the badge. Set to 0 for no count. If `showNumber` is false, the number is hidden.
+     *
+     * Available when `showNumber==true`.
+     */
     number?: number;
-    /** Shows the number in the badge when true.
-
-Set to `false` for symbolic or icon-only badges. */
+    /** Shows the number in the badge when true. Set to `false` for symbolic or icon-only badges. */
     showNumber?: boolean;
-    /** Visual style/type of the badge.
-
-Possible values: `regular`, `alarm`, `warning`, `caution`, `level-critical`, `level-high`, `level-medium`, `level-low`, `level-diagnostic`, `running`, `notification`, `enhance`, `automation`, `outline`, `empty`.
-
-Defaults to `regular`. */
+    /** Visual style/type of the badge. Possible values: `regular`, `alarm`, `warning`, `caution`, `level-critical`, `level-high`, `level-medium`, `level-low`, `level-diagnostic`, `running`, `notification`, `enhance`, `automation`, `outline`, `empty`. Defaults to `regular`. */
     type?: string;
-    /** Badge size.
-
-Possible values: `regular` (default), `large`. */
+    /** Badge size. Possible values: `regular` (default), `large`. */
     size?: string;
-    /** Badge variant.
-
-- `default`: Filled background and border (default).
-- `flat`: Minimal background and outline. */
+    /** Badge variant: `default` has a filled background and border, `flat` a minimal background and outline. */
     variant?: BadgeVariant;
-    /** Whether to show an icon in the badge.
-
-For built-in types (`alarm`, `warning`, `caution`, the `level-*` severities, and `running`), a contextual icon is shown automatically.
-For other types, provide a custom icon in the `badge-icon` slot. */
+    /** Whether to show an icon in the badge. For built-in types (`alarm`, `warning`, `caution`, the `level-*` severities, and `running`), a contextual icon is shown automatically. For other types, provide a custom icon in the `badge-icon` slot. */
     showIcon?: boolean;
 }
 export interface Events {

package/dist/components/breadcrumb/ObcBreadcrumb.svelte

@@ -9,12 +9,8 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** The list of breadcrumb items to display, in order from root to current location.
-
-Each item should be an object with a `label` property (string). The component renders each label in sequence, separated by a chevron icon.
-
-Example: `[ {label: 'Home'}, {label: 'Section'}, {label: 'Page'} ]` */
-items?: BreadcrumbItem[];
+     /** The list of breadcrumb items to display, in order from root to current location. Each item should be an object with a `label` property (string). The component renders each label in sequence, separated by a chevron icon. Example: `[ {label: 'Home'}, {label: 'Section'}, {label: 'Page'} ]` */
+     items?: BreadcrumbItem[];
      iconOnly?: boolean
    }
       export interface Events {

package/dist/components/breadcrumb/ObcBreadcrumb.svelte.d.ts

@@ -4,11 +4,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** The list of breadcrumb items to display, in order from root to current location.
-
-Each item should be an object with a `label` property (string). The component renders each label in sequence, separated by a chevron icon.
-
-Example: `[ {label: 'Home'}, {label: 'Section'}, {label: 'Page'} ]` */
+    /** The list of breadcrumb items to display, in order from root to current location. Each item should be an object with a `label` property (string). The component renders each label in sequence, separated by a chevron icon. Example: `[ {label: 'Home'}, {label: 'Section'}, {label: 'Page'} ]` */
     items?: BreadcrumbItem[];
     iconOnly?: boolean;
 }

package/dist/components/button/ObcButton.svelte

@@ -10,11 +10,8 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Controls the button's visual style.
-- `normal`: Standard button (default)
-- `raised`: Elevated button for emphasis
-- `flat`: Minimal, low-emphasis button */
-variant?: ButtonVariant;
+     /** Visual style: `normal` (default) is the standard button, `raised` is elevated for emphasis, `flat` is minimal and low-emphasis. */
+     variant?: ButtonVariant;
      /** Expands the button to fill the width of its container when true. */
      fullWidth?: boolean;
      /** Disables the button or link, preventing user interaction and applying disabled styling. */
@@ -27,12 +24,8 @@ variant?: ButtonVariant;
      href?: string | undefined;
      /** Specifies the target for the anchor link (only applies when `href` is set). Common values: `_blank`, `_self`, `_parent`, `_top`. */
      target?: string | undefined;
-      /** Defines the segment position when used in a segmented button group.
-- `single`: Standalone button
-- `start`: First button in a group
-- `middle`: Middle button in a group
-- `end`: Last button in a group */
-segmentPosition?: segmentPosition
+     /** Position within a segmented button group: `single` stands alone, `start`, `middle` and `end` shape the button for the first, an inner and the last segment. */
+     segmentPosition?: segmentPosition
    }
       export interface Events {
     onClick?: (event: CustomEvent<unknown>) => void

package/dist/components/button/ObcButton.svelte.d.ts

@@ -4,10 +4,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Controls the button's visual style.
-- `normal`: Standard button (default)
-- `raised`: Elevated button for emphasis
-- `flat`: Minimal, low-emphasis button */
+    /** Visual style: `normal` (default) is the standard button, `raised` is elevated for emphasis, `flat` is minimal and low-emphasis. */
     variant?: ButtonVariant;
     /** Expands the button to fill the width of its container when true. */
     fullWidth?: boolean;
@@ -21,11 +18,7 @@ export interface Props {
     href?: string | undefined;
     /** Specifies the target for the anchor link (only applies when `href` is set). Common values: `_blank`, `_self`, `_parent`, `_top`. */
     target?: string | undefined;
-    /** Defines the segment position when used in a segmented button group.
-- `single`: Standalone button
-- `start`: First button in a group
-- `middle`: Middle button in a group
-- `end`: Last button in a group */
+    /** Position within a segmented button group: `single` stands alone, `start`, `middle` and `end` shape the button for the first, an inner and the last segment. */
     segmentPosition?: segmentPosition;
 }
 export interface Events {

package/dist/components/card/ObcCard.svelte

@@ -11,18 +11,20 @@
      class?: string;
      style?: string;
      showTitle?: boolean;
-      /** Enables dialog mode. When true, the card acts as a button and opens a modal dialog on click.
-
-When `hasDialog` is false, the card is a static container. When true, clicking the card opens a modal dialog overlay, displaying content from the `dialog-title` and `dialog-content` slots. */
-hasDialog?: boolean;
-      /** Total time in seconds before the dialog auto-closes. Use `0` to disable auto-close.
-
-When greater than zero, the dialog closes after this duration unless reset by user activity. The countdown indicator appears for the last `dialogVisibleTimerSeconds` seconds. */
-dialogTimeOutSeconds?: number;
-      /** Duration in seconds for which the countdown indicator is shown before auto-dismiss.
-
-The countdown indicator is visible for the last `dialogVisibleTimerSeconds` seconds of the dialog's lifetime when auto-close is enabled. User activity resets the timer. */
-dialogVisibleTimerSeconds?: number
+     /** Enables dialog mode. When true, the card acts as a button and opens a modal dialog on click. When `hasDialog` is false, the card is a static container. When true, clicking the card opens a modal dialog overlay, displaying content from the `dialog-title` and `dialog-content` slots. */
+     hasDialog?: boolean;
+     /**
+      * Total time in seconds before the dialog auto-closes. Use `0` to disable auto-close. When greater than zero, the dialog closes after this duration unless reset by user activity. The countdown indicator appears for the last `dialogVisibleTimerSeconds` seconds.
+      *
+      * Available when `hasDialog==true`.
+      */
+     dialogTimeOutSeconds?: number;
+     /**
+      * Duration in seconds for which the countdown indicator is shown before auto-dismiss. The countdown indicator is visible for the last `dialogVisibleTimerSeconds` seconds of the dialog's lifetime when auto-close is enabled. User activity resets the timer.
+      *
+      * Available when `hasDialog==true`.
+      */
+     dialogVisibleTimerSeconds?: number
    }
       export interface Events {
     

package/dist/components/card/ObcCard.svelte.d.ts

@@ -4,17 +4,19 @@ export interface Props {
     class?: string;
     style?: string;
     showTitle?: boolean;
-    /** Enables dialog mode. When true, the card acts as a button and opens a modal dialog on click.
-
-When `hasDialog` is false, the card is a static container. When true, clicking the card opens a modal dialog overlay, displaying content from the `dialog-title` and `dialog-content` slots. */
+    /** Enables dialog mode. When true, the card acts as a button and opens a modal dialog on click. When `hasDialog` is false, the card is a static container. When true, clicking the card opens a modal dialog overlay, displaying content from the `dialog-title` and `dialog-content` slots. */
     hasDialog?: boolean;
-    /** Total time in seconds before the dialog auto-closes. Use `0` to disable auto-close.
-
-When greater than zero, the dialog closes after this duration unless reset by user activity. The countdown indicator appears for the last `dialogVisibleTimerSeconds` seconds. */
+    /**
+     * Total time in seconds before the dialog auto-closes. Use `0` to disable auto-close. When greater than zero, the dialog closes after this duration unless reset by user activity. The countdown indicator appears for the last `dialogVisibleTimerSeconds` seconds.
+     *
+     * Available when `hasDialog==true`.
+     */
     dialogTimeOutSeconds?: number;
-    /** Duration in seconds for which the countdown indicator is shown before auto-dismiss.
-
-The countdown indicator is visible for the last `dialogVisibleTimerSeconds` seconds of the dialog's lifetime when auto-close is enabled. User activity resets the timer. */
+    /**
+     * Duration in seconds for which the countdown indicator is shown before auto-dismiss. The countdown indicator is visible for the last `dialogVisibleTimerSeconds` seconds of the dialog's lifetime when auto-close is enabled. User activity resets the timer.
+     *
+     * Available when `hasDialog==true`.
+     */
     dialogVisibleTimerSeconds?: number;
 }
 export interface Events {

package/dist/components/check-button/ObcCheckButton.svelte

@@ -10,14 +10,10 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Determines the visual style and toggle behavior of the button.
-- `regular`: Standard button with optional icon and label.
-- `checkbox`: Checkbox-style toggle with checked/unchecked icons. */
-type?: CheckButtonType;
-      /** Whether the button is currently checked (selected/on).
-
-When clicked, this state toggles and the `check-button-click` event is fired. */
-checked?: boolean;
+     /** Visual style and toggle behaviour: `regular` (default) is a standard button with an optional icon and label, `checkbox` is a checkbox-style toggle with checked and unchecked icons. */
+     type?: CheckButtonType;
+     /** Whether the button is currently checked (selected/on). When clicked, this state toggles and the `check-button-click` event is fired. */
+     checked?: boolean;
      /** Disables the button, preventing user interaction and applying disabled styling. */
      disabled?: boolean;
      /** If false, button width adapts to its content (fit-content). If true, uses the `width` property (if set) or expands to 100% of parent. */

package/dist/components/check-button/ObcCheckButton.svelte.d.ts

@@ -4,13 +4,9 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Determines the visual style and toggle behavior of the button.
-- `regular`: Standard button with optional icon and label.
-- `checkbox`: Checkbox-style toggle with checked/unchecked icons. */
+    /** Visual style and toggle behaviour: `regular` (default) is a standard button with an optional icon and label, `checkbox` is a checkbox-style toggle with checked and unchecked icons. */
     type?: CheckButtonType;
-    /** Whether the button is currently checked (selected/on).
-
-When clicked, this state toggles and the `check-button-click` event is fired. */
+    /** Whether the button is currently checked (selected/on). When clicked, this state toggles and the `check-button-click` event is fired. */
     checked?: boolean;
     /** Disables the button, preventing user interaction and applying disabled styling. */
     disabled?: boolean;

package/dist/components/checkbox/ObcCheckbox.svelte

@@ -9,19 +9,12 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Controls the checkbox status: `checked`, `unchecked`, or `mixed` (indeterminate).
-
-Defaults to `unchecked`. */
-status?: CheckboxStatus;
-      /** Controls the visual state: `enabled` or `loading`.
-
-Defaults to `enabled`. */
-state?: CheckboxState;
-      /** Disables the checkbox and prevents user interaction.
-
-When `true`, the checkbox is visually styled as disabled and does not respond to user input.
-Interaction is also locked when `state === loading`. */
-disabled?: boolean;
+     /** Controls the checkbox status: `checked`, `unchecked`, or `mixed` (indeterminate). Defaults to `unchecked`. */
+     status?: CheckboxStatus;
+     /** Controls the visual state: `enabled` or `loading`. Defaults to `enabled`. */
+     state?: CheckboxState;
+     /** Disables the checkbox and prevents user interaction. When `true`, the checkbox is visually styled as disabled and does not respond to user input. Interaction is also locked when `state === loading`. */
+     disabled?: boolean;
      /** Internal: controls hover effects on the checkbox. Used by wrapper components such as `obc-checkbox-item`. */
      hasHoverEffects?: boolean
    }

package/dist/components/checkbox/ObcCheckbox.svelte.d.ts

@@ -4,18 +4,11 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Controls the checkbox status: `checked`, `unchecked`, or `mixed` (indeterminate).
-
-Defaults to `unchecked`. */
+    /** Controls the checkbox status: `checked`, `unchecked`, or `mixed` (indeterminate). Defaults to `unchecked`. */
     status?: CheckboxStatus;
-    /** Controls the visual state: `enabled` or `loading`.
-
-Defaults to `enabled`. */
+    /** Controls the visual state: `enabled` or `loading`. Defaults to `enabled`. */
     state?: CheckboxState;
-    /** Disables the checkbox and prevents user interaction.
-
-When `true`, the checkbox is visually styled as disabled and does not respond to user input.
-Interaction is also locked when `state === loading`. */
+    /** Disables the checkbox and prevents user interaction. When `true`, the checkbox is visually styled as disabled and does not respond to user input. Interaction is also locked when `state === loading`. */
     disabled?: boolean;
     /** Internal: controls hover effects on the checkbox. Used by wrapper components such as `obc-checkbox-item`. */
     hasHoverEffects?: boolean;

package/dist/components/command-button/ObcCommandButton.svelte

@@ -9,13 +9,8 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Whether the command is currently active.
-
-When `true`, the button displays the "in command" icon and uses active styling.
-When `false`, the button displays the "no command" icon and uses default styling.
-
-Default: `false` */
-inCommand?: boolean
+     /** Whether the command is currently active. When `true`, the button displays the "in command" icon and uses active styling. When `false`, the button displays the "no command" icon and uses default styling. */
+     inCommand?: boolean
    }
       export interface Events {
     onClick?: (event: CustomEvent<unknown>) => void

package/dist/components/command-button/ObcCommandButton.svelte.d.ts

@@ -3,12 +3,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Whether the command is currently active.
-
-When `true`, the button displays the "in command" icon and uses active styling.
-When `false`, the button displays the "no command" icon and uses default styling.
-
-Default: `false` */
+    /** Whether the command is currently active. When `true`, the button displays the "in command" icon and uses active styling. When `false`, the button displays the "no command" icon and uses default styling. */
     inCommand?: boolean;
 }
 export interface Events {

package/dist/components/context-menu-input/ObcContextMenuInput.svelte

@@ -9,54 +9,36 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** The variant type of context menu to display.
-
-- `'regular'`: Single-select navigation menu.
-- `'checkboxes'`: Multi-select with checkboxes.
-- `'nested-checkboxes'`: Multi-select with nested/hierarchical checkboxes.
-- `'flyout'`: Menu with expandable/cascading groups.
-- `'multi'`: Multi-column menu.
-- `'multi-with-subtitles'`: Multi-column menu with group subtitles.
-
-Defaults to `'regular'`. */
-type?: ContextMenuType;
-      /** Array of menu options to display.
-
-Each option should have a unique `value`, a `label`, and can optionally include:
-- `icon`: TemplateResult for a leading icon (e.g., `<obi-placeholder slot="icon"></obi-placeholder>`)
-- `level`: For nested checkboxes, indicates nesting depth.
-- `children`: For flyout/nested menus, an array of child options. */
-options?: ContextMenuOption[];
-      /** Array of currently selected option values.
-
-For multi-select variants, can contain multiple values. For single-select, contains at most one value. */
-selectedValues?: string[];
-      /** Whether to show a title bar with close button at the top of the menu.
-
-If true, displays the `title` property and a close icon button. */
-hasTitleBar?: boolean;
+     /** Menu variant: `regular` (default) is a single-select navigation menu, `checkboxes` and `nested-checkboxes` are flat and hierarchical multi-select, `flyout` has expandable cascading groups, and `multi` and `multi-with-subtitles` lay the menu out in columns, the latter with group subtitles. */
+     type?: ContextMenuType;
+     /** Menu options, each with a unique `value` and a `label`, and optionally an `icon` template for the leading icon, a `level` giving the nesting depth for nested checkboxes, and `children` for a flyout or nested menu. */
+     options?: ContextMenuOption[];
+     /** Array of currently selected option values. For multi-select variants, can contain multiple values. For single-select, contains at most one value. */
+     selectedValues?: string[];
+     /** Whether to show a title bar with close button at the top of the menu. If true, displays the `title` property and a close icon button. */
+     hasTitleBar?: boolean;
      /**
       * Title text displayed in the title bar (if `hasTitleBar` is true).
       *
       * Available when `hasTitleBar==true`.
       */
      title?: string;
-      /** Array of column groups for the `multi-with-subtitles` layout.
-
-Each group defines a `title`, `columns` (number of columns in the group), and `options` (array of options for that group). */
-columnGroups?: ColumnGroup[];
-      /** Number of items per column in multi-column layouts.
-
-Used in `multi` and `multi-with-subtitles` variants to control column splitting. */
-itemsPerColumn?: number;
-      /** Whether multiple selections are allowed.
-
-If not set, defaults to true for checkbox/multi variants, false for regular/flyout. */
-multiSelect?: boolean | undefined;
-      /** If true, restricts selection to one option per group or column (used in flyout and multi-column).
-
-When enabled, only one option can be selected in each group or column. */
-selectPerGroup?: boolean | undefined
+     /**
+      * Array of column groups for the `multi-with-subtitles` layout. Each group defines a `title`, `columns` (number of columns in the group), and `options` (array of options for that group).
+      *
+      * Available when `type==MultiWithSubtitles`.
+      */
+     columnGroups?: ColumnGroup[];
+     /**
+      * Number of items per column in multi-column layouts. Used in `multi` and `multi-with-subtitles` variants to control column splitting.
+      *
+      * Available when `type in [Multi, MultiWithSubtitles]`.
+      */
+     itemsPerColumn?: number;
+     /** Whether multiple selections are allowed. If not set, defaults to true for checkbox/multi variants, false for regular/flyout. */
+     multiSelect?: boolean | undefined;
+     /** If true, restricts selection to one option per group or column (used in flyout and multi-column). When enabled, only one option can be selected in each group or column. */
+     selectPerGroup?: boolean | undefined
    }
       export interface Events {
     onChange?: (event: ObcContextMenuInputChangeEvent) => void;