@public-ui/components 4.1.2-rc.2 → 4.1.2-rc.4

package/dist/types/components.d.ts

@@ -5,7 +5,7 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { AccessKeyPropType, AccordionCallbacksPropType, AlertTypePropType, AlertVariantPropType, AlignPropType, AlternativeButtonLinkRolePropType, AriaCurrentValuePropType, AriaDescriptionPropType, AriaOwnsPropType, AutoCompletePropType, BadgeTextPropType, BreadcrumbLinkProps, ButtonCallbacksPropType, ButtonOrLinkOrTextWithChildrenProps, ButtonTypePropType, ButtonVariantPropType, ColorPair, CustomClassPropType, DetailsCallbacksPropType, DownloadPropType, ErrorListPropType, FixedColsPropType, HasSettingsMenuPropType, HeadingLevel, HrefPropType, IconsHorizontalPropType, IconsPropType, IdPropType, InlinePropType, InputCheckboxIconsProp, InputDateTypePropType, InputTextTypePropType, InputTypeOnDefault, InternalButtonProps, Iso8601, KoliBriAlertEventCallbacks, KoliBriCardEventCallbacks, KoliBriDialogEventCallbacks, KoliBriFormCallbacks, KoliBriIconsProp, KoliBriModalEventCallbacks, KoliBriPaginationButtonCallbacks, KoliBriTableDataType, KoliBriTableHeaderCell, KoliBriTableHeaders, KoliBriTablePaginationProps, KoliBriTableSelectionKeys, KoliBriTabsCallbacks, LabelAlignPropType, LabelPropType, LabelWithExpertSlotPropType, LinkOnCallbacksPropType, LinkProps, LinkTargetPropType, MaxLengthBehaviorPropType, MaxPropType, MsgPropType, NamePropType, NumberString, OpenPropType, OptionsPropType, OptionsWithOptgroupPropType, PaginationHasButton, PaginationPositionPropType, PopoverAlignPropType, PopoverCallbacksPropType, PropColor, RadioOptionsPropType, RowsPropType, ShortKeyPropType, SpellCheckPropType, SpinVariantPropType, StencilUnknown, Stringified, SuggestionsPropType, SyncValueBySelectorPropType, TabBehaviorPropType, TabButtonProps, TableCallbacksPropType, TableDataFootPropType, TableDataPropType, TableHeaderCellsPropType, TableSelectionPropType, TableStatefulCallbacksPropType, TextareaResizePropType, Toast, ToastState, ToolbarItemsPropType, TooltipAlignPropType, VariantClassNamePropType } from "./schema";
+import { AccessKeyPropType, AccordionCallbacksPropType, AlertTypePropType, AlertVariantPropType, AlignPropType, AlternativeButtonLinkRolePropType, AriaCurrentValuePropType, AriaDescriptionPropType, AriaOwnsPropType, AutoCompletePropType, BadgeTextPropType, BreadcrumbLinkProps, ButtonCallbacksPropType, ButtonOrLinkOrTextWithChildrenProps, ButtonTypePropType, ButtonVariantPropType, ColorPair, CustomClassPropType, DetailsCallbacksPropType, DownloadPropType, ErrorListPropType, FixedColsPropType, HasSettingsMenuPropType, HeadingLevel, HrefPropType, IconsHorizontalPropType, IconsPropType, IdPropType, InlinePropType, InputCheckboxIconsProp, InputDateTypePropType, InputTextTypePropType, InputTypeOnDefault, InternalButtonProps, Iso8601, KoliBriAlertEventCallbacks, KoliBriCardEventCallbacks, KoliBriDialogEventCallbacks, KoliBriFormCallbacks, KoliBriIconsProp, KoliBriModalEventCallbacks, KoliBriPaginationButtonCallbacks, KoliBriTableDataType, KoliBriTableHeaderCell, KoliBriTableHeaders, KoliBriTablePaginationProps, KoliBriTableSelectionKeys, KoliBriTabsCallbacks, LabelAlignPropType, LabelPropType, LabelWithExpertSlotPropType, LinkOnCallbacksPropType, LinkProps, LinkTargetPropType, MaxLengthBehaviorPropType, MaxPropType, MsgPropType, NamePropType, NumberString, OpenPropType, OptionsPropType, OptionsWithOptgroupPropType, PaginationHasButton, PaginationPositionPropType, PopoverAlignPropType, PropColor, RadioOptionsPropType, RowsPropType, ShortKeyPropType, SpellCheckPropType, SpinVariantPropType, StencilUnknown, Stringified, SuggestionsPropType, SyncValueBySelectorPropType, TabBehaviorPropType, TabButtonProps, TableCallbacksPropType, TableDataFootPropType, TableDataPropType, TableHeaderCellsPropType, TableSelectionPropType, TableStatefulCallbacksPropType, TextareaResizePropType, Toast, ToastState, ToolbarItemsPropType, TooltipAlignPropType, VariantClassNamePropType } from "./schema";
 import { AriaHasPopupPropType } from "./schema/props/aria-has-popup";
 import { ModalVariantPropType } from "./schema/props/variant/modal";
 import { LoadingType, ProgressVariantType } from "./internal/props";
@@ -14,7 +14,7 @@ import { PasswordVariantPropType } from "./schema/props/variant/password-variant
 import { OrientationPropType } from "./schema/props/orientation";
 import { QuoteVariantType } from "./internal/props/variant-quote";
 import { HasCreateButtonPropType } from "./schema/props/has-create-button";
-export { AccessKeyPropType, AccordionCallbacksPropType, AlertTypePropType, AlertVariantPropType, AlignPropType, AlternativeButtonLinkRolePropType, AriaCurrentValuePropType, AriaDescriptionPropType, AriaOwnsPropType, AutoCompletePropType, BadgeTextPropType, BreadcrumbLinkProps, ButtonCallbacksPropType, ButtonOrLinkOrTextWithChildrenProps, ButtonTypePropType, ButtonVariantPropType, ColorPair, CustomClassPropType, DetailsCallbacksPropType, DownloadPropType, ErrorListPropType, FixedColsPropType, HasSettingsMenuPropType, HeadingLevel, HrefPropType, IconsHorizontalPropType, IconsPropType, IdPropType, InlinePropType, InputCheckboxIconsProp, InputDateTypePropType, InputTextTypePropType, InputTypeOnDefault, InternalButtonProps, Iso8601, KoliBriAlertEventCallbacks, KoliBriCardEventCallbacks, KoliBriDialogEventCallbacks, KoliBriFormCallbacks, KoliBriIconsProp, KoliBriModalEventCallbacks, KoliBriPaginationButtonCallbacks, KoliBriTableDataType, KoliBriTableHeaderCell, KoliBriTableHeaders, KoliBriTablePaginationProps, KoliBriTableSelectionKeys, KoliBriTabsCallbacks, LabelAlignPropType, LabelPropType, LabelWithExpertSlotPropType, LinkOnCallbacksPropType, LinkProps, LinkTargetPropType, MaxLengthBehaviorPropType, MaxPropType, MsgPropType, NamePropType, NumberString, OpenPropType, OptionsPropType, OptionsWithOptgroupPropType, PaginationHasButton, PaginationPositionPropType, PopoverAlignPropType, PopoverCallbacksPropType, PropColor, RadioOptionsPropType, RowsPropType, ShortKeyPropType, SpellCheckPropType, SpinVariantPropType, StencilUnknown, Stringified, SuggestionsPropType, SyncValueBySelectorPropType, TabBehaviorPropType, TabButtonProps, TableCallbacksPropType, TableDataFootPropType, TableDataPropType, TableHeaderCellsPropType, TableSelectionPropType, TableStatefulCallbacksPropType, TextareaResizePropType, Toast, ToastState, ToolbarItemsPropType, TooltipAlignPropType, VariantClassNamePropType } from "./schema";
+export { AccessKeyPropType, AccordionCallbacksPropType, AlertTypePropType, AlertVariantPropType, AlignPropType, AlternativeButtonLinkRolePropType, AriaCurrentValuePropType, AriaDescriptionPropType, AriaOwnsPropType, AutoCompletePropType, BadgeTextPropType, BreadcrumbLinkProps, ButtonCallbacksPropType, ButtonOrLinkOrTextWithChildrenProps, ButtonTypePropType, ButtonVariantPropType, ColorPair, CustomClassPropType, DetailsCallbacksPropType, DownloadPropType, ErrorListPropType, FixedColsPropType, HasSettingsMenuPropType, HeadingLevel, HrefPropType, IconsHorizontalPropType, IconsPropType, IdPropType, InlinePropType, InputCheckboxIconsProp, InputDateTypePropType, InputTextTypePropType, InputTypeOnDefault, InternalButtonProps, Iso8601, KoliBriAlertEventCallbacks, KoliBriCardEventCallbacks, KoliBriDialogEventCallbacks, KoliBriFormCallbacks, KoliBriIconsProp, KoliBriModalEventCallbacks, KoliBriPaginationButtonCallbacks, KoliBriTableDataType, KoliBriTableHeaderCell, KoliBriTableHeaders, KoliBriTablePaginationProps, KoliBriTableSelectionKeys, KoliBriTabsCallbacks, LabelAlignPropType, LabelPropType, LabelWithExpertSlotPropType, LinkOnCallbacksPropType, LinkProps, LinkTargetPropType, MaxLengthBehaviorPropType, MaxPropType, MsgPropType, NamePropType, NumberString, OpenPropType, OptionsPropType, OptionsWithOptgroupPropType, PaginationHasButton, PaginationPositionPropType, PopoverAlignPropType, PropColor, RadioOptionsPropType, RowsPropType, ShortKeyPropType, SpellCheckPropType, SpinVariantPropType, StencilUnknown, Stringified, SuggestionsPropType, SyncValueBySelectorPropType, TabBehaviorPropType, TabButtonProps, TableCallbacksPropType, TableDataFootPropType, TableDataPropType, TableHeaderCellsPropType, TableSelectionPropType, TableStatefulCallbacksPropType, TextareaResizePropType, Toast, ToastState, ToolbarItemsPropType, TooltipAlignPropType, VariantClassNamePropType } from "./schema";
 export { AriaHasPopupPropType } from "./schema/props/aria-has-popup";
 export { ModalVariantPropType } from "./schema/props/variant/modal";
 export { LoadingType, ProgressVariantType } from "./internal/props";
@@ -66,7 +66,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     /**
      * The **Alert** component provides visual feedback to users. It consists of a color-coded container, a heading, content text, and an icon. The icon used and the color scheme depend on the `_type` of the alert.
@@ -295,7 +295,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
           * Returns the current value.
          */
@@ -398,7 +398,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
           * Returns the current value.
          */
@@ -699,7 +699,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     interface KolDialog {
         /**
@@ -814,9 +814,6 @@ export namespace Components {
          */
         "focusErrorList": () => Promise<void>;
     }
-    /**
-     * The **Heading** component can be used wherever a heading needs to be displayed. By using the different sizes, content can be clearly structured and pages can be presented effectively and with variety. It separates styling from semantics and enables flexibility.
-     */
     interface KolHeading {
         /**
           * Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). Set to `false` to enable the expert slot.
@@ -2148,7 +2145,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     /**
      * The **LinkButton** component is semantically a link but has the appearance of a button. All relevant properties of the Link component are adopted and extended with the design-defining properties of a button.
@@ -2231,7 +2228,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     interface KolLinkWc {
         /**
@@ -2501,6 +2498,10 @@ export namespace Components {
          */
         "_tooltipAlign"?: TooltipAlignPropType;
     }
+    /**
+     * A button that toggles the visibility of a popover overlay containing arbitrary content.
+     * The popover uses the native HTML Popover API for lightweight, non-modal overlays.
+     */
     interface KolPopoverButton {
         /**
           * Defines the key combination that can be used to trigger or focus the component's interactive element.
@@ -2581,7 +2582,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<any>;
+        "focus": () => Promise<void>;
         /**
           * Hides the popover programmatically by forwarding the call to the web component.
          */
@@ -2675,33 +2676,16 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
-          * Hides the popover programmatically by calling the native hidePopover method.
+          * Hides the popover programmatically by calling the PopoverController.
          */
         "hidePopover": () => Promise<void>;
         /**
-          * Show the popover programmatically by calling the native showPopover method.
+          * Show the popover programmatically by calling the PopoverController.
          */
         "showPopover": () => Promise<void>;
     }
-    interface KolPopoverWc {
-        /**
-          * Defines the alignment of the tooltip, popover or tabs in relation to the element.
-          * @default 'top'
-         */
-        "_align"?: AlignPropType;
-        /**
-          * Defines the callback functions for popover events.
-         */
-        "_on"?: PopoverCallbacksPropType;
-        /**
-          * Makes the element show up.
-          * @TODO : Change type back to `ShowPropType` after Stencil#4663 has been resolved.
-          * @default false
-         */
-        "_show"?: boolean;
-    }
     /**
      * The **Progress** component visualizes the completion status of a task or process. It supports both determinate (percentage-based) and indeterminate variants.
      */
@@ -2847,7 +2831,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
           * Returns the selected values.
          */
@@ -3092,7 +3076,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     /**
      * The **Spin** component informs users about loading or processing operations being performed by the system. Progress can be communicated through a repeated animation.
@@ -3209,7 +3193,7 @@ export namespace Components {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
           * Returns the current value.
          */
@@ -3379,6 +3363,10 @@ export namespace Components {
           * Defines the tab captions.
          */
         "_tabs": Stringified<TabButtonProps[]>;
+        /**
+          * Sets focus on the current tab button.
+         */
+        "focus": () => Promise<void>;
     }
     /**
      * The **Textarea** component provides a larger input field for content. Unlike InputText, it also allows extensive content to be entered, including line breaks.
@@ -3538,6 +3526,10 @@ export namespace Components {
           * Defines whether the orientation of the component is horizontal or vertical.
          */
         "_orientation"?: OrientationPropType;
+        /**
+          * Sets focus on the currently active toolbar item.
+         */
+        "focus": () => Promise<void>;
     }
     interface KolTooltipWc {
         /**
@@ -3567,6 +3559,10 @@ export namespace Components {
           * Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.).
          */
         "_label": LabelPropType;
+        /**
+          * Sets focus on the first focusable tree item.
+         */
+        "focus": () => Promise<void>;
     }
     interface KolTreeItem {
         /**
@@ -3630,7 +3626,7 @@ export namespace Components {
         /**
           * Focuses the link element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
         /**
           * Returns whether the tree item is expanded.
          */
@@ -3641,6 +3637,14 @@ export namespace Components {
           * Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.).
          */
         "_label": LabelPropType;
+        /**
+          * Sets focus on the first focusable tree item.
+         */
+        "focus": () => Promise<void>;
+        /**
+          * Invalidates the cache for open tree items. Called by tree-item when expand/collapse occurs.
+         */
+        "invalidateOpenItemsCache": () => Promise<void>;
     }
     interface KolVersion {
         /**
@@ -3674,7 +3678,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolAccordionElement: {
         prototype: HTMLKolAccordionElement;
@@ -3734,7 +3738,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolButtonElement: {
         prototype: HTMLKolButtonElement;
@@ -3751,7 +3755,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolButtonLinkElement: {
         prototype: HTMLKolButtonLinkElement;
@@ -3816,7 +3820,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolDetailsElement: {
         prototype: HTMLKolDetailsElement;
@@ -3852,9 +3856,6 @@ declare global {
         prototype: HTMLKolFormElement;
         new (): HTMLKolFormElement;
     };
-    /**
-     * The **Heading** component can be used wherever a heading needs to be displayed. By using the different sizes, content can be clearly structured and pages can be presented effectively and with variety. It separates styling from semantics and enables flexibility.
-     */
     interface HTMLKolHeadingElement extends Components.KolHeading, HTMLStencilElement {
     }
     var HTMLKolHeadingElement: {
@@ -4019,7 +4020,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolLinkElement: {
         prototype: HTMLKolLinkElement;
@@ -4032,7 +4033,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolLinkButtonElement: {
         prototype: HTMLKolLinkButtonElement;
@@ -4080,6 +4081,10 @@ declare global {
         prototype: HTMLKolPaginationWcElement;
         new (): HTMLKolPaginationWcElement;
     };
+    /**
+     * A button that toggles the visibility of a popover overlay containing arbitrary content.
+     * The popover uses the native HTML Popover API for lightweight, non-modal overlays.
+     */
     interface HTMLKolPopoverButtonElement extends Omit<Components.KolPopoverButton, "hidePopover" | "showPopover" | "focus">, HTMLStencilElement {
         /**
           * Hides the popover programmatically by forwarding the call to the web component.
@@ -4092,7 +4097,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<any>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolPopoverButtonElement: {
         prototype: HTMLKolPopoverButtonElement;
@@ -4100,28 +4105,22 @@ declare global {
     };
     interface HTMLKolPopoverButtonWcElement extends Omit<Components.KolPopoverButtonWc, "hidePopover" | "showPopover" | "focus">, HTMLStencilElement {
         /**
-          * Hides the popover programmatically by calling the native hidePopover method.
+          * Hides the popover programmatically by calling the PopoverController.
          */
         "hidePopover": () => Promise<void>;
         /**
-          * Show the popover programmatically by calling the native showPopover method.
+          * Show the popover programmatically by calling the PopoverController.
          */
         "showPopover": () => Promise<void>;
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolPopoverButtonWcElement: {
         prototype: HTMLKolPopoverButtonWcElement;
         new (): HTMLKolPopoverButtonWcElement;
     };
-    interface HTMLKolPopoverWcElement extends Components.KolPopoverWc, HTMLStencilElement {
-    }
-    var HTMLKolPopoverWcElement: {
-        prototype: HTMLKolPopoverWcElement;
-        new (): HTMLKolPopoverWcElement;
-    };
     /**
      * The **Progress** component visualizes the completion status of a task or process. It supports both determinate (percentage-based) and indeterminate variants.
      */
@@ -4144,7 +4143,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolSelectElement: {
         prototype: HTMLKolSelectElement;
@@ -4202,7 +4201,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolSkipNavElement: {
         prototype: HTMLKolSkipNavElement;
@@ -4225,7 +4224,7 @@ declare global {
         /**
           * Sets focus on the internal element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolSplitButtonElement: {
         prototype: HTMLKolSplitButtonElement;
@@ -4261,7 +4260,11 @@ declare global {
     /**
      * The **Tabs** component is used to organize related content on the same page and navigate between them. Tabs ensure that large amounts of content can be more easily organized for users.
      */
-    interface HTMLKolTabsElement extends Components.KolTabs, HTMLStencilElement {
+    interface HTMLKolTabsElement extends Omit<Components.KolTabs, "focus">, HTMLStencilElement {
+        /**
+          * Sets focus on the current tab button.
+         */
+        "focus": () => Promise<void>;
     }
     var HTMLKolTabsElement: {
         prototype: HTMLKolTabsElement;
@@ -4289,7 +4292,11 @@ declare global {
         prototype: HTMLKolToastContainerElement;
         new (): HTMLKolToastContainerElement;
     };
-    interface HTMLKolToolbarElement extends Components.KolToolbar, HTMLStencilElement {
+    interface HTMLKolToolbarElement extends Omit<Components.KolToolbar, "focus">, HTMLStencilElement {
+        /**
+          * Sets focus on the currently active toolbar item.
+         */
+        "focus": () => Promise<void>;
     }
     var HTMLKolToolbarElement: {
         prototype: HTMLKolToolbarElement;
@@ -4301,7 +4308,11 @@ declare global {
         prototype: HTMLKolTooltipWcElement;
         new (): HTMLKolTooltipWcElement;
     };
-    interface HTMLKolTreeElement extends Components.KolTree, HTMLStencilElement {
+    interface HTMLKolTreeElement extends Omit<Components.KolTree, "focus">, HTMLStencilElement {
+        /**
+          * Sets focus on the first focusable tree item.
+         */
+        "focus": () => Promise<void>;
     }
     var HTMLKolTreeElement: {
         prototype: HTMLKolTreeElement;
@@ -4321,13 +4332,17 @@ declare global {
         /**
           * Focuses the link element.
          */
-        "focus": () => Promise<void | undefined>;
+        "focus": () => Promise<void>;
     }
     var HTMLKolTreeItemWcElement: {
         prototype: HTMLKolTreeItemWcElement;
         new (): HTMLKolTreeItemWcElement;
     };
-    interface HTMLKolTreeWcElement extends Components.KolTreeWc, HTMLStencilElement {
+    interface HTMLKolTreeWcElement extends Omit<Components.KolTreeWc, "focus">, HTMLStencilElement {
+        /**
+          * Sets focus on the first focusable tree item.
+         */
+        "focus": () => Promise<void>;
     }
     var HTMLKolTreeWcElement: {
         prototype: HTMLKolTreeWcElement;
@@ -4388,7 +4403,6 @@ declare global {
         "kol-pagination-wc": HTMLKolPaginationWcElement;
         "kol-popover-button": HTMLKolPopoverButtonElement;
         "kol-popover-button-wc": HTMLKolPopoverButtonWcElement;
-        "kol-popover-wc": HTMLKolPopoverWcElement;
         "kol-progress": HTMLKolProgressElement;
         "kol-quote": HTMLKolQuoteElement;
         "kol-select": HTMLKolSelectElement;
@@ -5106,9 +5120,6 @@ declare namespace LocalJSX {
          */
         "_requiredText"?: Stringified<boolean>;
     }
-    /**
-     * The **Heading** component can be used wherever a heading needs to be displayed. By using the different sizes, content can be clearly structured and pages can be presented effectively and with variety. It separates styling from semantics and enables flexibility.
-     */
     interface KolHeading {
         /**
           * Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). Set to `false` to enable the expert slot.
@@ -6621,6 +6632,10 @@ declare namespace LocalJSX {
          */
         "_tooltipAlign"?: TooltipAlignPropType;
     }
+    /**
+     * A button that toggles the visibility of a popover overlay containing arbitrary content.
+     * The popover uses the native HTML Popover API for lightweight, non-modal overlays.
+     */
     interface KolPopoverButton {
         /**
           * Defines the key combination that can be used to trigger or focus the component's interactive element.
@@ -6769,23 +6784,6 @@ declare namespace LocalJSX {
          */
         "_variant"?: ButtonVariantPropType;
     }
-    interface KolPopoverWc {
-        /**
-          * Defines the alignment of the tooltip, popover or tabs in relation to the element.
-          * @default 'top'
-         */
-        "_align"?: AlignPropType;
-        /**
-          * Defines the callback functions for popover events.
-         */
-        "_on"?: PopoverCallbacksPropType;
-        /**
-          * Makes the element show up.
-          * @TODO : Change type back to `ShowPropType` after Stencil#4663 has been resolved.
-          * @default false
-         */
-        "_show"?: boolean;
-    }
     /**
      * The **Progress** component visualizes the completion status of a task or process. It supports both determinate (percentage-based) and indeterminate variants.
      */
@@ -7657,7 +7655,6 @@ declare namespace LocalJSX {
         "kol-pagination-wc": KolPaginationWc;
         "kol-popover-button": KolPopoverButton;
         "kol-popover-button-wc": KolPopoverButtonWc;
-        "kol-popover-wc": KolPopoverWc;
         "kol-progress": KolProgress;
         "kol-quote": KolQuote;
         "kol-select": KolSelect;
@@ -7757,9 +7754,6 @@ declare module "@stencil/core" {
              * The **Form** component is used to wrap all input fields, correctly position the required-fields hint text, and forward the `submit` and `reset` events.
              */
             "kol-form": LocalJSX.KolForm & JSXBase.HTMLAttributes<HTMLKolFormElement>;
-            /**
-             * The **Heading** component can be used wherever a heading needs to be displayed. By using the different sizes, content can be clearly structured and pages can be presented effectively and with variety. It separates styling from semantics and enables flexibility.
-             */
             "kol-heading": LocalJSX.KolHeading & JSXBase.HTMLAttributes<HTMLKolHeadingElement>;
             /**
              * The **Icon** component allows icons from included icon fonts to be displayed at any position.
@@ -7828,9 +7822,12 @@ declare module "@stencil/core" {
             "kol-nav": LocalJSX.KolNav & JSXBase.HTMLAttributes<HTMLKolNavElement>;
             "kol-pagination": LocalJSX.KolPagination & JSXBase.HTMLAttributes<HTMLKolPaginationElement>;
             "kol-pagination-wc": LocalJSX.KolPaginationWc & JSXBase.HTMLAttributes<HTMLKolPaginationWcElement>;
+            /**
+             * A button that toggles the visibility of a popover overlay containing arbitrary content.
+             * The popover uses the native HTML Popover API for lightweight, non-modal overlays.
+             */
             "kol-popover-button": LocalJSX.KolPopoverButton & JSXBase.HTMLAttributes<HTMLKolPopoverButtonElement>;
             "kol-popover-button-wc": LocalJSX.KolPopoverButtonWc & JSXBase.HTMLAttributes<HTMLKolPopoverButtonWcElement>;
-            "kol-popover-wc": LocalJSX.KolPopoverWc & JSXBase.HTMLAttributes<HTMLKolPopoverWcElement>;
             /**
              * The **Progress** component visualizes the completion status of a task or process. It supports both determinate (percentage-based) and indeterminate variants.
              */

package/dist/types/core/component-names.d.ts

@@ -39,7 +39,6 @@ export declare let KolModalTag: "kol-modal";
 export declare let KolNavTag: "kol-nav";
 export declare let KolPaginationTag: "kol-pagination";
 export declare let KolPaginationWcTag: "kol-pagination-wc";
-export declare let KolPopoverWcTag: "kol-popover-wc";
 export declare let KolPopoverButtonTag: "kol-popover-button";
 export declare let KolPopoverButtonWcTag: "kol-popover-button-wc";
 export declare let KolProgressTag: "kol-progress";

package/dist/types/internal/functional-components/heading/api.d.ts

@@ -0,0 +1,6 @@
+import type { ApiFromConfig } from '../generic-types';
+export declare const headingPropsConfig: {
+    readonly optional: readonly [import("../../props").PropDefinition<import("../../props").InternalPropValue<import("../../props").LevelProp>, import("../../props").LevelProp>, import("../../props").PropDefinition<string, import("../../props").SecondaryHeadlineProp>];
+    readonly required: readonly [import("../../props").PropDefinition<string, import("../../props").LabelWithExpertSlotProp>];
+};
+export type HeadingApi = ApiFromConfig<typeof headingPropsConfig>;

package/dist/types/internal/functional-components/heading/component.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionalComponent as FC } from '../../../stencil-public-runtime';
+import type { FunctionalComponentProps } from '../generic-types';
+import type { HeadingApi } from './api';
+export declare const HeadingFC: FC<FunctionalComponentProps<HeadingApi>>;

package/dist/types/internal/functional-components/heading/controller.d.ts

@@ -0,0 +1,10 @@
+import { BaseController } from '../base-controller';
+import type { ControllerInterface, GetStateFn, ResolvedInputProps, SetStateFn } from '../generic-types';
+import type { HeadingApi } from './api';
+export declare class HeadingController extends BaseController<HeadingApi> implements ControllerInterface<HeadingApi> {
+    constructor(setState: SetStateFn<HeadingApi>, getState: GetStateFn<HeadingApi>);
+    componentWillLoad(props: ResolvedInputProps<HeadingApi>): void;
+    watchLabel(value?: string): void;
+    watchLevel(value?: number): void;
+    watchSecondaryHeadline(value?: string): void;
+}

package/dist/types/internal/functional-components/popover/api.d.ts

@@ -0,0 +1,5 @@
+import type { ApiFromConfig } from '../generic-types';
+export declare const popoverPropsConfig: {
+    readonly optional: readonly [import("../../props").PropDefinition<import("../../props").InternalPropValue<import("../../props").AlignProp>, import("../../props").AlignProp>];
+};
+export type PopoverApi = ApiFromConfig<typeof popoverPropsConfig>;

package/dist/types/internal/functional-components/popover/component.d.ts

@@ -0,0 +1,9 @@
+import type { FunctionalComponent as FC } from '../../../stencil-public-runtime';
+import type { JSXBase } from '../../../stencil-public-runtime';
+import type { FunctionalComponentProps } from '../generic-types';
+import type { PopoverApi } from './api';
+export type PopoverFCProps = FunctionalComponentProps<PopoverApi> & JSXBase.HTMLAttributes<HTMLDivElement> & {
+    popoverRef?: (el?: HTMLDivElement) => void;
+    arrowRef?: (el?: HTMLDivElement) => void;
+};
+export declare const PopoverFC: FC<PopoverFCProps>;

package/dist/types/internal/functional-components/popover/controller.d.ts

@@ -0,0 +1,16 @@
+import type { AlignPropType } from '../../../schema';
+export declare class PopoverController {
+    private show;
+    private popoverElement?;
+    private arrowElement?;
+    private triggerElement?;
+    private align;
+    private cleanupAutoUpdate?;
+    setShow(value: boolean): void;
+    setPopoverElementRef: (element?: HTMLDivElement) => void;
+    setTriggerElement: (element?: HTMLElement) => void;
+    setAlign: (align: AlignPropType) => void;
+    private alignPopover;
+    private setupAutoUpdate;
+    destroy(): void;
+}

package/dist/types/internal/functional-components/popover/snapshot.test.d.ts

@@ -0,0 +1 @@
+export{};

package/dist/types/internal/props/align.d.ts

@@ -0,0 +1,4 @@
+import type { AlignPropType } from '../../schema';
+import type { SimpleProp } from './helpers/factory';
+export type AlignProp = SimpleProp<'align', AlignPropType>;
+export declare const alignProp: import("./helpers/factory").PropDefinition<import("./helpers/factory").InternalPropValue<AlignProp>, AlignProp>;

package/dist/types/internal/props/index.d.ts

@@ -1 +1 @@
-export*from"./allow-markdown";export*from"./alt";export*from"./badge-text";export*from"./color";export*from"./helpers/factory";export*from"./hide-label";export*from"./href";export*from"./icons";export*from"./label";export*from"./loading";export*from"./max";export*from"./name";export*from"./quote";export*from"./show";export*from"./sizes";export*from"./span-icons";export*from"./src";export*from"./srcset";export*from"./unit";export*from"./value-number";export*from"./value-number-clamped";export*from"./variant-progress";export*from"./variant-quote";
+export*from"./align";export*from"./allow-markdown";export*from"./alt";export*from"./badge-text";export*from"./color";export*from"./helpers/factory";export*from"./hide-label";export*from"./href";export*from"./icons";export*from"./label";export*from"./label-with-expert-slot";export*from"./level";export*from"./loading";export*from"./max";export*from"./name";export*from"./quote";export*from"./secondary-headline";export*from"./show";export*from"./sizes";export*from"./span-icons";export*from"./src";export*from"./srcset";export*from"./unit";export*from"./value-number";export*from"./value-number-clamped";export*from"./variant-progress";export*from"./variant-quote";

package/dist/types/internal/props/label-with-expert-slot.d.ts

@@ -0,0 +1,3 @@
+import type { SimpleProp } from './helpers/factory';
+export type LabelWithExpertSlotProp = SimpleProp<'label', string>;
+export declare const labelWithExpertSlotProp: import("./helpers/factory").PropDefinition<string, LabelWithExpertSlotProp>;

package/dist/types/internal/props/level.d.ts

@@ -0,0 +1,5 @@
+import type { SimpleProp } from './helpers/factory';
+export declare const headingLevelOptions: readonly [0, 1, 2, 3, 4, 5, 6];
+export type HeadingLevel = (typeof headingLevelOptions)[number];
+export type LevelProp = SimpleProp<'level', HeadingLevel>;
+export declare const levelProp: import("./helpers/factory").PropDefinition<import("./helpers/factory").InternalPropValue<LevelProp>, LevelProp>;

package/dist/types/internal/props/secondary-headline.d.ts

@@ -0,0 +1,3 @@
+import type { SimpleProp } from './helpers/factory';
+export type SecondaryHeadlineProp = SimpleProp<'secondaryHeadline', string>;
+export declare const secondaryHeadlineProp: import("./helpers/factory").PropDefinition<string, SecondaryHeadlineProp>;

package/dist/types/schema/components/index.d.ts

@@ -1 +1 @@
-export*from"./abbr";export*from"./accordion";export*from"./alert";export*from"./avatar";export*from"./badge";export*from"./breadcrumb";export*from"./button";export*from"./button-link";export*from"./card";export*from"./combobox";export*from"./details";export*from"./dialog";export*from"./drawer";export*from"./form";export*from"./heading";export*from"./icon";export*from"./image";export*from"./input-checkbox";export*from"./input-color";export*from"./input-date";export*from"./input-email";export*from"./input-file";export*from"./input-number";export*from"./input-password";export*from"./input-radio";export*from"./input-range";export*from"./input-text";export*from"./kolibri";export*from"./link";export*from"./link-button";export*from"./modal";export*from"./nav";export*from"./pagination";export*from"./popover";export*from"./popover-button";export*from"./progress";export*from"./quote";export*from"./select";export*from"./single-select";export*from"./skip-nav";export*from"./span";export*from"./spin";export*from"./split-button";export*from"./table";export*from"./tableStateless";export*from"./tabs";export*from"./textarea";export*from"./toaster";export*from"./toolbar";export*from"./tooltip";export*from"./tree";export*from"./tree-item";export*from"./version";
+export*from"./abbr";export*from"./accordion";export*from"./alert";export*from"./avatar";export*from"./badge";export*from"./breadcrumb";export*from"./button";export*from"./button-link";export*from"./card";export*from"./combobox";export*from"./details";export*from"./dialog";export*from"./drawer";export*from"./form";export*from"./heading";export*from"./icon";export*from"./image";export*from"./input-checkbox";export*from"./input-color";export*from"./input-date";export*from"./input-email";export*from"./input-file";export*from"./input-number";export*from"./input-password";export*from"./input-radio";export*from"./input-range";export*from"./input-text";export*from"./kolibri";export*from"./link";export*from"./link-button";export*from"./modal";export*from"./nav";export*from"./pagination";export*from"./popover-button";export*from"./progress";export*from"./quote";export*from"./select";export*from"./single-select";export*from"./skip-nav";export*from"./span";export*from"./spin";export*from"./split-button";export*from"./table";export*from"./tableStateless";export*from"./tabs";export*from"./textarea";export*from"./toaster";export*from"./toolbar";export*from"./tooltip";export*from"./tree";export*from"./tree-item";export*from"./version";

package/dist/types/schema/props/index.d.ts

@@ -1 +1 @@
-export*from"./accept";export*from"./access-key";export*from"./accordion-callbacks";export*from"./active";export*from"./adjust-height";export*from"./alert";export*from"./alert-type";export*from"./align";export*from"./allow-multi-sort";export*from"./alt";export*from"./alternative-button-link-role";export*from"./aria-controls";export*from"./aria-current-value";export*from"./aria-description";export*from"./aria-expanded";export*from"./aria-owns";export*from"./aria-selected";export*from"./auto-complete";export*from"./badge-text";export*from"./button-callbacks";export*from"./button-type";export*from"./button-variant";export*from"./checked";export*from"./collapsible";export*from"./color";export*from"./current-length";export*from"./custom-class";export*from"./details-callbacks";export*from"./disabled";export*from"./download";export*from"./error-list";export*from"./has-closer";export*from"./has-compact-button";export*from"./has-counter";export*from"./has-icons-when-expanded";export*from"./has-settings-menu";export*from"./has-value";export*from"./hide-label";export*from"./hide-msg";export*from"./hint";export*from"./href";export*from"./icons";export*from"./icons-input-checkbox";export*from"./id";export*from"./image-sizes";export*from"./image-source";export*from"./image-srcset";export*from"./indeterminate";export*from"./inline";export*from"./label";export*from"./label-align";export*from"./level";export*from"./link-on-callbacks";export*from"./link-target";export*from"./loading";export*from"./max";export*from"./max-length";export*from"./max-length-behavior";export*from"./modal";export*from"./msg";export*from"./multiple";export*from"./name";export*from"./open";export*from"./options";export*from"./pagination-position";export*from"./pattern";export*from"./placeholder";export*from"./popover-align";export*from"./popover-callbacks";export*from"./quote";export*from"./read-only";export*from"./required";export*from"./resize-textarea";export*from"./rows";export*from"./short-key";export*from"./show";export*from"./spell-check";export*from"./suggestions";export*from"./sync-value-by-selector";export*from"./tab-behavior";export*from"./tab-index";export*from"./table-callbacks";export*from"./table-data";export*from"./table-data-foot";export*from"./table-fixed-cols";export*from"./table-header-cells";export*from"./table-selection";export*from"./toolbar-items";export*from"./tooltip-align";export*from"./touched";export*from"./type-input-date";export*from"./type-input-text";export*from"./unit";export*from"./variant-alert";export*from"./variant-class-name";export*from"./variant-input-checkbox";export*from"./variant-progress";export*from"./variant-quote";export*from"./variant/spin";export*from"./width";
+export{headingLevelOptions,type,HeadingLevel}from"../../internal/props/level";export*from"./accept";export*from"./access-key";export*from"./accordion-callbacks";export*from"./active";export*from"./adjust-height";export*from"./alert";export*from"./alert-type";export*from"./align";export*from"./allow-multi-sort";export*from"./alt";export*from"./alternative-button-link-role";export*from"./aria-controls";export*from"./aria-current-value";export*from"./aria-description";export*from"./aria-expanded";export*from"./aria-owns";export*from"./aria-selected";export*from"./auto-complete";export*from"./badge-text";export*from"./button-callbacks";export*from"./button-type";export*from"./button-variant";export*from"./checked";export*from"./collapsible";export*from"./color";export*from"./current-length";export*from"./custom-class";export*from"./details-callbacks";export*from"./disabled";export*from"./download";export*from"./error-list";export*from"./has-closer";export*from"./has-compact-button";export*from"./has-counter";export*from"./has-icons-when-expanded";export*from"./has-settings-menu";export*from"./has-value";export*from"./hide-label";export*from"./hide-msg";export*from"./hint";export*from"./href";export*from"./icons";export*from"./icons-input-checkbox";export*from"./id";export*from"./image-sizes";export*from"./image-source";export*from"./image-srcset";export*from"./indeterminate";export*from"./inline";export*from"./label";export*from"./label-align";export*from"./link-on-callbacks";export*from"./link-target";export*from"./loading";export*from"./max";export*from"./max-length";export*from"./max-length-behavior";export*from"./modal";export*from"./msg";export*from"./multiple";export*from"./name";export*from"./open";export*from"./options";export*from"./pagination-position";export*from"./pattern";export*from"./placeholder";export*from"./popover-align";export*from"./quote";export*from"./read-only";export*from"./required";export*from"./resize-textarea";export*from"./rows";export*from"./short-key";export*from"./show";export*from"./spell-check";export*from"./suggestions";export*from"./sync-value-by-selector";export*from"./tab-behavior";export*from"./tab-index";export*from"./table-callbacks";export*from"./table-data";export*from"./table-data-foot";export*from"./table-fixed-cols";export*from"./table-header-cells";export*from"./table-selection";export*from"./toolbar-items";export*from"./tooltip-align";export*from"./touched";export*from"./type-input-date";export*from"./type-input-text";export*from"./unit";export*from"./variant-alert";export*from"./variant-class-name";export*from"./variant-input-checkbox";export*from"./variant-progress";export*from"./variant-quote";export*from"./variant/spin";export*from"./width";