@oicl/openbridge-webcomponents-svelte 2.0.0-next.1 → 2.0.0-next.100

package/dist/components/menu-button/ObcMenuButton.svelte.d.ts

@@ -1,4 +1,5 @@
 import '@oicl/openbridge-webcomponents/dist/components/menu-button/menu-button.js';
+import type { ObcSplitButtonChangeEvent, ObcMenuButtonItemClickEvent } from '@oicl/openbridge-webcomponents/dist/components/menu-button/menu-button.js';
 import type { ContextMenuOption, ContextMenuType, ColumnGroup } from '@oicl/openbridge-webcomponents/dist/components/context-menu-input/context-menu-input.js';
 import type { Snippet } from 'svelte';
 export interface Props {
@@ -59,14 +60,8 @@ Disables both the button and the menu. */
     disabled?: boolean;
 }
 export interface Events {
-    onChange?: (event: CustomEvent<{
-        selectedValues: string[];
-        selectedOptions: Array<ContextMenuOption>;
-    }>) => void;
-    onItemClick?: (event: CustomEvent<{
-        value: string;
-        option: ContextMenuOption;
-    }>) => void;
+    onChange?: (event: ObcSplitButtonChangeEvent) => void;
+    onItemClick?: (event: ObcMenuButtonItemClickEvent) => void;
     onOpen?: (event: CustomEvent<void>) => void;
     onClose?: (event: CustomEvent<void>) => void;
 }
@@ -75,6 +70,8 @@ export interface Slots {
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcMenuButton: import("svelte").Component<$$ComponentProps, {
+    ObcSplitButtonChangeEvent: typeof ObcSplitButtonChangeEvent;
+    ObcMenuButtonItemClickEvent: typeof ObcMenuButtonItemClickEvent;
     ContextMenuOption: typeof ContextMenuOption;
     ContextMenuType: typeof ContextMenuType;
     ColumnGroup: typeof ColumnGroup;

package/dist/components/message-menu-item/ObcMessageMenuItem.svelte

@@ -19,6 +19,8 @@
      time?: string;
      primaryActionLabel?: string;
      secondaryActionLabel?: string;
+     enablePrimaryAction?: boolean;
+     enableSecondaryAction?: boolean;
      hasPrimaryIcon?: boolean;
      hasSecondaryIcon?: boolean;
      hasTrailingIcon?: boolean;
@@ -31,14 +33,14 @@
     onSecondaryActionClick?: (event: CustomEvent<void>) => void
   }
       export interface Slots {
-  title?: Snippet;
-  description?: Snippet;
+  titleSnippet?: Snippet;
+  descriptionSnippet?: Snippet;
   actionLabel?: Snippet;
   primaryIcon?: Snippet;
   secondaryIcon?: Snippet;
   trailingIcon?: Snippet
 }
-      const {onMessageClick, onPrimaryActionClick, onSecondaryActionClick, class: className, style, title, description, actionLabel, primaryIcon, secondaryIcon, trailingIcon, ...props} = $props<Props & Events & Slots>();
+      const {onMessageClick, onPrimaryActionClick, onSecondaryActionClick, class: className, style, titleSnippet, descriptionSnippet, actionLabel, primaryIcon, secondaryIcon, trailingIcon, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-message-menu-item
@@ -49,15 +51,15 @@
    onprimary-action-click={onPrimaryActionClick}
    onsecondary-action-click={onSecondaryActionClick} >
       
-      {#if title}
+      {#if titleSnippet}
         <div slot="title">
-          {@render title()}
+          {@render titleSnippet()}
         </div>
       {/if}
 
-      {#if description}
+      {#if descriptionSnippet}
         <div slot="description">
-          {@render description()}
+          {@render descriptionSnippet()}
         </div>
       {/if}
 

package/dist/components/message-menu-item/ObcMessageMenuItem.svelte.d.ts

@@ -14,6 +14,8 @@ export interface Props {
     time?: string;
     primaryActionLabel?: string;
     secondaryActionLabel?: string;
+    enablePrimaryAction?: boolean;
+    enableSecondaryAction?: boolean;
     hasPrimaryIcon?: boolean;
     hasSecondaryIcon?: boolean;
     hasTrailingIcon?: boolean;
@@ -28,8 +30,8 @@ export interface Events {
     onSecondaryActionClick?: (event: CustomEvent<void>) => void;
 }
 export interface Slots {
-    title?: Snippet;
-    description?: Snippet;
+    titleSnippet?: Snippet;
+    descriptionSnippet?: Snippet;
     actionLabel?: Snippet;
     primaryIcon?: Snippet;
     secondaryIcon?: Snippet;

package/dist/components/modal-window/ObcModalWindow.svelte

@@ -14,7 +14,11 @@ size?: ObcModalWindowSize;
       /** Whether to show an optional third action button. */
 hasOptionalAction?: boolean;
       /** Whether to show the leading icon slot in the header. */
-hasLeadingIcon?: boolean
+hasLeadingIcon?: boolean;
+      /** Whether to show the footer cancel button. */
+hasCancelAction?: boolean;
+      /** Whether to show the header close (X) button. */
+hasCloseAction?: boolean
    }
       export interface Events {
     onCloseClick?: (event: CustomEvent<unknown>) => void;

package/dist/components/modal-window/ObcModalWindow.svelte.d.ts

@@ -10,6 +10,10 @@ export interface Props {
     hasOptionalAction?: boolean;
     /** Whether to show the leading icon slot in the header. */
     hasLeadingIcon?: boolean;
+    /** Whether to show the footer cancel button. */
+    hasCancelAction?: boolean;
+    /** Whether to show the header close (X) button. */
+    hasCloseAction?: boolean;
 }
 export interface Events {
     onCloseClick?: (event: CustomEvent<unknown>) => void;

package/dist/components/navigation-item/ObcNavigationItem.svelte

@@ -1,9 +1,11 @@
 
   <script lang="ts">
     export type {ObcNavigationMenuVariant} from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+export type {TreeBranchType, TreeNavigationItemAlerts} from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
       import '@oicl/openbridge-webcomponents/dist/components/navigation-item/navigation-item.js';
       import { setProperties } from "../../util.js";
       import type {ObcNavigationMenuVariant} from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+import type {TreeBranchType, TreeNavigationItemAlerts} from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
       import type { Snippet } from 'svelte';
 
       export interface Props {
@@ -31,7 +33,16 @@ Only relevant when `group` is true. */
 groupSelected?: boolean;
       /** Whether the item has a leading icon. */
 hasIcon?: boolean;
-     hasTrailingIcon?: boolean
+     hasTrailingIcon?: boolean;
+      /** Set by `obc-navigation-menu` in its Tree variant — renders the row as a tree item. */
+treeMode?: boolean;
+      /** Indentation columns for tree mode, assigned by `obc-navigation-menu`. */
+treeBranches?: TreeBranchType[];
+      /** Terminal type for the row in the Tree variant — one of `regular` (default),
+`aggregated-header`, or `group-header`. Has no effect in the flat variants. */
+terminalType?: string;
+      /** [object Object],[object Object],[object Object] */
+alerts?: TreeNavigationItemAlerts | undefined
    }
       export interface Events {
     onClick?: (event: CustomEvent<void>) => void

package/dist/components/navigation-item/ObcNavigationItem.svelte.d.ts

@@ -1,5 +1,6 @@
 import '@oicl/openbridge-webcomponents/dist/components/navigation-item/navigation-item.js';
 import type { ObcNavigationMenuVariant } from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+import type { TreeBranchType, TreeNavigationItemAlerts } from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
@@ -27,6 +28,15 @@ Only relevant when `group` is true. */
     /** Whether the item has a leading icon. */
     hasIcon?: boolean;
     hasTrailingIcon?: boolean;
+    /** Set by `obc-navigation-menu` in its Tree variant — renders the row as a tree item. */
+    treeMode?: boolean;
+    /** Indentation columns for tree mode, assigned by `obc-navigation-menu`. */
+    treeBranches?: TreeBranchType[];
+    /** Terminal type for the row in the Tree variant — one of `regular` (default),
+`aggregated-header`, or `group-header`. Has no effect in the flat variants. */
+    terminalType?: string;
+    /** [object Object],[object Object],[object Object] */
+    alerts?: TreeNavigationItemAlerts | undefined;
 }
 export interface Events {
     onClick?: (event: CustomEvent<void>) => void;
@@ -38,6 +48,8 @@ export interface Slots {
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcNavigationItem: import("svelte").Component<$$ComponentProps, {
     ObcNavigationMenuVariant: typeof ObcNavigationMenuVariant;
+    TreeBranchType: typeof TreeBranchType;
+    TreeNavigationItemAlerts: typeof TreeNavigationItemAlerts;
 }, "">;
 type ObcNavigationItem = ReturnType<typeof ObcNavigationItem>;
 export default ObcNavigationItem;

package/dist/components/navigation-item-group/ObcNavigationItemGroup.svelte

@@ -1,9 +1,11 @@
 
   <script lang="ts">
     export type {ObcNavigationMenuVariant} from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+export type {TreeBranchType, TreeNavigationItemAlerts} from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
       import '@oicl/openbridge-webcomponents/dist/components/navigation-item-group/navigation-item-group.js';
       import { setProperties } from "../../util.js";
       import type {ObcNavigationMenuVariant} from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+import type {TreeBranchType, TreeNavigationItemAlerts} from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
       import type { Snippet } from 'svelte';
 
       export interface Props {
@@ -23,7 +25,18 @@ Controls the styling and layout of the group and its flyout. */
 variant?: ObcNavigationMenuVariant;
       /** If true, the flyout panel appears tightly anchored to the group label with compact styling. */
 hug?: boolean;
-     hasIcon?: boolean
+     hasIcon?: boolean;
+      /** Set by `obc-navigation-menu` in its Tree variant — renders the group as a tree row. */
+treeMode?: boolean;
+      /** Indentation columns for tree mode, assigned by `obc-navigation-menu`. */
+treeBranches?: TreeBranchType[];
+      /** Terminal type for the group header in the Tree variant — one of `regular`
+(default), `aggregated-header`, or `group-header`. No effect in flat variants. */
+terminalType?: string;
+      /** [object Object],[object Object],[object Object] */
+alerts?: TreeNavigationItemAlerts | undefined;
+      /** Whether the group starts expanded. Useful for trees that open by default. */
+defaultOpen?: boolean
    }
       export interface Events {
     onOpen?: (event: CustomEvent<void>) => void

package/dist/components/navigation-item-group/ObcNavigationItemGroup.svelte.d.ts

@@ -1,5 +1,6 @@
 import '@oicl/openbridge-webcomponents/dist/components/navigation-item-group/navigation-item-group.js';
 import type { ObcNavigationMenuVariant } from '@oicl/openbridge-webcomponents/dist/components/navigation-menu/navigation-menu.js';
+import type { TreeBranchType, TreeNavigationItemAlerts } from '@oicl/openbridge-webcomponents/dist/components/tree-navigation-item/tree-navigation-item.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
@@ -19,6 +20,17 @@ Controls the styling and layout of the group and its flyout. */
     /** If true, the flyout panel appears tightly anchored to the group label with compact styling. */
     hug?: boolean;
     hasIcon?: boolean;
+    /** Set by `obc-navigation-menu` in its Tree variant — renders the group as a tree row. */
+    treeMode?: boolean;
+    /** Indentation columns for tree mode, assigned by `obc-navigation-menu`. */
+    treeBranches?: TreeBranchType[];
+    /** Terminal type for the group header in the Tree variant — one of `regular`
+(default), `aggregated-header`, or `group-header`. No effect in flat variants. */
+    terminalType?: string;
+    /** [object Object],[object Object],[object Object] */
+    alerts?: TreeNavigationItemAlerts | undefined;
+    /** Whether the group starts expanded. Useful for trees that open by default. */
+    defaultOpen?: boolean;
 }
 export interface Events {
     onOpen?: (event: CustomEvent<void>) => void;
@@ -30,6 +42,8 @@ export interface Slots {
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcNavigationItemGroup: import("svelte").Component<$$ComponentProps, {
     ObcNavigationMenuVariant: typeof ObcNavigationMenuVariant;
+    TreeBranchType: typeof TreeBranchType;
+    TreeNavigationItemAlerts: typeof TreeNavigationItemAlerts;
 }, "">;
 type ObcNavigationItemGroup = ReturnType<typeof ObcNavigationItemGroup>;
 export default ObcNavigationItemGroup;

package/dist/components/navigation-menu/ObcNavigationMenu.svelte

@@ -14,7 +14,8 @@
 - `full`: Standard menu with icons and labels (default).
 - `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).
 - `icon-only-large`: Icon-only menu supporting flyouts/groups.
-- `compact`: Minimal, space-saving menu. */
+- `compact`: Minimal, space-saving menu.
+- `tree`: Hierarchical tree — groups expand inline and rows are indented by depth. */
 variant?: ObcNavigationMenuVariant;
       /** Visual variant of the flyout.
 One of `Full` (default) or `Compact`. */

package/dist/components/navigation-menu/ObcNavigationMenu.svelte.d.ts

@@ -9,7 +9,8 @@ export interface Props {
 - `full`: Standard menu with icons and labels (default).
 - `icon-only`: Compact, icon-only menu (use only when no flyouts/groups are present).
 - `icon-only-large`: Icon-only menu supporting flyouts/groups.
-- `compact`: Minimal, space-saving menu. */
+- `compact`: Minimal, space-saving menu.
+- `tree`: Hierarchical tree — groups expand inline and rows are indented by depth. */
     variant?: ObcNavigationMenuVariant;
     /** Visual variant of the flyout.
 One of `Full` (default) or `Compact`. */

package/dist/components/notification-floating-item/ObcNotificationFloatingItem.svelte

@@ -45,15 +45,14 @@ lineType?: ObcFloatingItemLineType
   }
       export interface Slots {
   primaryIcon?: Snippet;
-  secondaryIcon?: Snippet;
   title?: Snippet;
   description?: Snippet;
   time?: Snippet;
   day?: Snippet;
-  action?: Snippet;
-  action2?: Snippet
+  actionSnippet?: Snippet;
+  action2Snippet?: Snippet
 }
-      const {onActionClick, onAction2Click, onDismissClick, class: className, style, primaryIcon, secondaryIcon, title, description, time, day, action, action2, ...props} = $props<Props & Events & Slots>();
+      const {onActionClick, onAction2Click, onDismissClick, class: className, style, primaryIcon, title, description, time, day, actionSnippet, action2Snippet, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-notification-floating-item
@@ -70,12 +69,6 @@ lineType?: ObcFloatingItemLineType
         </div>
       {/if}
 
-      {#if secondaryIcon}
-        <div slot="secondary-icon">
-          {@render secondaryIcon()}
-        </div>
-      {/if}
-
       {#if title}
         <div slot="title">
           {@render title()}
@@ -100,15 +93,15 @@ lineType?: ObcFloatingItemLineType
         </div>
       {/if}
 
-      {#if action}
+      {#if actionSnippet}
         <div slot="action">
-          {@render action()}
+          {@render actionSnippet()}
         </div>
       {/if}
 
-      {#if action2}
+      {#if action2Snippet}
         <div slot="action2">
-          {@render action2()}
+          {@render action2Snippet()}
         </div>
       {/if}
     </obc-notification-floating-item>

package/dist/components/notification-floating-item/ObcNotificationFloatingItem.svelte.d.ts

@@ -40,13 +40,12 @@ export interface Events {
 }
 export interface Slots {
     primaryIcon?: Snippet;
-    secondaryIcon?: Snippet;
     title?: Snippet;
     description?: Snippet;
     time?: Snippet;
     day?: Snippet;
-    action?: Snippet;
-    action2?: Snippet;
+    actionSnippet?: Snippet;
+    action2Snippet?: Snippet;
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcNotificationFloatingItem: import("svelte").Component<$$ComponentProps, {

package/dist/components/number-input-field/ObcNumberInputField.svelte

@@ -9,7 +9,7 @@
       export interface Props {
      class?: string;
      style?: string;
-     value?: string;
+     value?: number;
      unit?: string;
      placeholder?: string;
      textAlign?: ObcNumberInputFieldTextAlign;
@@ -40,24 +40,38 @@ minlength?: number | undefined;
      hasHelperIcon?: boolean;
      helperPlacement?: ObcNumberInputFieldPlacement;
       /** Internal property for squared corners, used when input is used in stepper-box */
-squared?: boolean
+squared?: boolean;
+      /** Optional display text override for controlled consumers (e.g. keyboard-numeric)
+that manage formatted strings while the committed value may be NaN. */
+displayOverride?: string;
+     decimalSeparator?: string | undefined;
+     groupSeparator?: string | undefined;
+     minFractionDigits?: number;
+     maxFractionDigits?: number | undefined;
+      /** Optional regex pattern. When set, any keystroke or paste whose resulting
+value does not match this pattern is blocked at the `beforeinput` stage.
+When unset, a permissive numeric filter (digits, sign, active separators,
+whitespace) is applied instead. */
+validationPattern?: string
    }
       export interface Events {
-    onInput?: (event: CustomEvent<unknown>) => void
+    onInput?: (event: CustomEvent<{value: number}>) => void;
+    onChange?: (event: CustomEvent<{value: number}>) => void
   }
       export interface Slots {
   leadingIcon?: Snippet;
   labelIcon?: Snippet;
   helperIcon?: Snippet
 }
-      const {onInput, class: className, style, leadingIcon, labelIcon, helperIcon, ...props} = $props<Props & Events & Slots>();
+      const {onInput, onChange, class: className, style, leadingIcon, labelIcon, helperIcon, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-number-input-field
     use:setProperties={props}
     class={className}
     style={style}
-    oninput={onInput} >
+    oninput={onInput}
+   onchange={onChange} >
       
       {#if leadingIcon}
         <div slot="leading-icon">

package/dist/components/number-input-field/ObcNumberInputField.svelte.d.ts

@@ -4,7 +4,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    value?: string;
+    value?: number;
     unit?: string;
     placeholder?: string;
     textAlign?: ObcNumberInputFieldTextAlign;
@@ -36,9 +36,26 @@ This is useful to avoid React re-rendering to reset the value. */
     helperPlacement?: ObcNumberInputFieldPlacement;
     /** Internal property for squared corners, used when input is used in stepper-box */
     squared?: boolean;
+    /** Optional display text override for controlled consumers (e.g. keyboard-numeric)
+that manage formatted strings while the committed value may be NaN. */
+    displayOverride?: string;
+    decimalSeparator?: string | undefined;
+    groupSeparator?: string | undefined;
+    minFractionDigits?: number;
+    maxFractionDigits?: number | undefined;
+    /** Optional regex pattern. When set, any keystroke or paste whose resulting
+value does not match this pattern is blocked at the `beforeinput` stage.
+When unset, a permissive numeric filter (digits, sign, active separators,
+whitespace) is applied instead. */
+    validationPattern?: string;
 }
 export interface Events {
-    onInput?: (event: CustomEvent<unknown>) => void;
+    onInput?: (event: CustomEvent<{
+        value: number;
+    }>) => void;
+    onChange?: (event: CustomEvent<{
+        value: number;
+    }>) => void;
 }
 export interface Slots {
     leadingIcon?: Snippet;

package/dist/components/pagination/ObcPagination.svelte

@@ -1,9 +1,9 @@
 
   <script lang="ts">
-    export type {ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, PaginationVariant} from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
+    export type {ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, ObcPaginationSelectPageEvent, PaginationVariant} from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
       import '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
       import { setProperties } from "../../util.js";
-      import type {ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, PaginationVariant} from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
+      import type {ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, ObcPaginationSelectPageEvent, PaginationVariant} from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
       import type { Snippet } from 'svelte';
 
       export interface Props {
@@ -39,12 +39,13 @@ fullWidth?: boolean;
    }
       export interface Events {
     onValue?: (event: ObcPaginationValueChangeEvent) => void;
-    onNavigate?: (event: ObcPaginationNavigateEvent) => void
+    onNavigate?: (event: ObcPaginationNavigateEvent) => void;
+    onSelectPage?: (event: ObcPaginationSelectPageEvent) => void
   }
       export interface Slots {
   children?: Snippet
 }
-      const {onValue, onNavigate, class: className, style, children, ...props} = $props<Props & Events & Slots>();
+      const {onValue, onNavigate, onSelectPage, class: className, style, children, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-pagination
@@ -52,7 +53,8 @@ fullWidth?: boolean;
     class={className}
     style={style}
     onvalue={onValue}
-   onnavigate={onNavigate} >
+   onnavigate={onNavigate}
+   onselect-page={onSelectPage} >
       
     {#if children}
       {@render children()}

package/dist/components/pagination/ObcPagination.svelte.d.ts

@@ -1,5 +1,5 @@
 import '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
-import type { ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, PaginationVariant } from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
+import type { ObcPaginationValueChangeEvent, ObcPaginationNavigateEvent, ObcPaginationSelectPageEvent, PaginationVariant } from '@oicl/openbridge-webcomponents/dist/components/pagination/pagination.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
@@ -35,6 +35,7 @@ Default: `false` */
 export interface Events {
     onValue?: (event: ObcPaginationValueChangeEvent) => void;
     onNavigate?: (event: ObcPaginationNavigateEvent) => void;
+    onSelectPage?: (event: ObcPaginationSelectPageEvent) => void;
 }
 export interface Slots {
     children?: Snippet;
@@ -43,6 +44,7 @@ type $$ComponentProps = Props & Events & Slots;
 declare const ObcPagination: import("svelte").Component<$$ComponentProps, {
     ObcPaginationValueChangeEvent: typeof ObcPaginationValueChangeEvent;
     ObcPaginationNavigateEvent: typeof ObcPaginationNavigateEvent;
+    ObcPaginationSelectPageEvent: typeof ObcPaginationSelectPageEvent;
     PaginationVariant: typeof PaginationVariant;
 }, "">;
 type ObcPagination = ReturnType<typeof ObcPagination>;

package/dist/components/progress-bar/ObcProgressBar.svelte

@@ -9,25 +9,41 @@
       export interface Props {
      class?: string;
      style?: string;
-     type?: ProgressBarType;
-     mode?: ProgressBarMode;
-     circularState?: CircularProgressState;
-     value?: number;
-     showValue?: boolean;
-     showUnit?: boolean;
-     hasDescription?: boolean;
-     description?: string;
-     showState?: boolean;
-     stateLabel?: string;
-     progressiveIndeterminate?: boolean
+      /** Layout type: `linear` (horizontal bar) or `circular` (ring). */
+type?: ProgressBarType;
+      /** Progress mode: `determinate` tracks `value`, `indeterminate` loops indefinitely. */
+mode?: ProgressBarMode;
+      /** Circular display state: `determinate` (numeric ring), `indeterminate` (animated ring with
+icon), or `icon` (ring framing the icon slot). */
+circularState?: CircularProgressState;
+      /** Progress percentage (0–100); clamped when rendered. */
+value?: number;
+      /** Shows the value label above the bar (percentage when determinate, "Loading" when indeterminate). */
+showValue?: boolean;
+      /** Appends a `%` unit next to the centered value. */
+showUnit?: boolean;
+      /** Shows the `description` text below the bar. */
+hasDescription?: boolean;
+      /** Description text rendered below the bar. */
+description?: string;
+      /** Shows the `stateLabel` next to the value.
+
+**TODO(designer):** Confirm the intended purpose of the state indicator — the story labels
+this a "future feature". */
+showState?: boolean;
+      /** Text shown alongside the value when `showState` is enabled. */
+stateLabel?: string;
+      /** Uses a progressive indeterminate ring (spinning arc that grows with `value`); takes
+precedence over `circularState`. */
+progressiveIndeterminate?: boolean
    }
       export interface Events {
     
   }
       export interface Slots {
-  children?: Snippet
+  icon?: Snippet
 }
-      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+      const { class: className, style, icon, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-progress-bar
@@ -36,7 +52,9 @@
     style={style}
      >
       
-    {#if children}
-      {@render children()}
-    {/if}
+      {#if icon}
+        <div slot="icon">
+          {@render icon()}
+        </div>
+      {/if}
     </obc-progress-bar>

package/dist/components/progress-bar/ObcProgressBar.svelte.d.ts

@@ -4,22 +4,38 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
+    /** Layout type: `linear` (horizontal bar) or `circular` (ring). */
     type?: ProgressBarType;
+    /** Progress mode: `determinate` tracks `value`, `indeterminate` loops indefinitely. */
     mode?: ProgressBarMode;
+    /** Circular display state: `determinate` (numeric ring), `indeterminate` (animated ring with
+icon), or `icon` (ring framing the icon slot). */
     circularState?: CircularProgressState;
+    /** Progress percentage (0–100); clamped when rendered. */
     value?: number;
+    /** Shows the value label above the bar (percentage when determinate, "Loading" when indeterminate). */
     showValue?: boolean;
+    /** Appends a `%` unit next to the centered value. */
     showUnit?: boolean;
+    /** Shows the `description` text below the bar. */
     hasDescription?: boolean;
+    /** Description text rendered below the bar. */
     description?: string;
+    /** Shows the `stateLabel` next to the value.
+
+**TODO(designer):** Confirm the intended purpose of the state indicator — the story labels
+this a "future feature". */
     showState?: boolean;
+    /** Text shown alongside the value when `showState` is enabled. */
     stateLabel?: string;
+    /** Uses a progressive indeterminate ring (spinning arc that grows with `value`); takes
+precedence over `circularState`. */
     progressiveIndeterminate?: boolean;
 }
 export interface Events {
 }
 export interface Slots {
-    children?: Snippet;
+    icon?: Snippet;
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcProgressBar: import("svelte").Component<$$ComponentProps, {