@swisspost/design-system-components 9.0.1 → 10.0.0-next.38

package/dist/types/components/post-collapsible-trigger/post-collapsible-trigger.d.ts

@@ -1,6 +1,6 @@
 export declare class PostCollapsibleTrigger {
     private trigger?;
-    private observer;
+    private readonly observer;
     private root?;
     host: HTMLPostCollapsibleTriggerElement;
     /**
@@ -10,29 +10,23 @@ export declare class PostCollapsibleTrigger {
     /**
      * Set the "aria-controls" and "aria-expanded" attributes on the trigger to match the state of the controlled post-collapsible
      */
-    setAriaAttributes(): void;
+    validateAriaAttributes(): void;
     /**
      * Initiate a mutation observer that updates the trigger whenever necessary
      */
     connectedCallback(): void;
-    /**
-     * Attach a "postToggle" event listener to the root node
-     * to update the trigger's "aria-expanded" attribute whenever the controlled post-collapsible is toggled
-     */
-    componentWillLoad(): void;
-    /**
-     * Add the "data-version" to the host element and set the trigger
-     */
     componentDidLoad(): void;
-    /**
-     * Disconnect the mutation observer
-     */
     disconnectedCallback(): void;
     /**
      * Update the "aria-controls" and "aria-expanded" attributes on the trigger button
      */
     update(): Promise<void>;
-    private debouncedUpdate;
+    /**
+     * Private handler for the 'postToggle' event.
+     * This updates the trigger's "aria-expanded" attribute based on the event detail.
+     */
+    private handlePostToggle;
+    private updateAriaAttributes;
     /**
      * Toggle the post-collapsible controlled by the trigger
      */
@@ -45,4 +39,5 @@ export declare class PostCollapsibleTrigger {
      * Find the button and add the proper event listener and ARIA attributes to it
      */
     private setTrigger;
+    render(): any;
 }

package/dist/types/components/post-footer/post-footer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @slot grid-{1|2|3|4}-title - Slot for the accordion headers (mobile).
+ * @slot grid-{1|2|3|4} - Slot for the accordion bodies (mobile) and the grid cells (tablet, desktop).
+ * @slot socialmedia - Slot for the social media links.
+ * @slot app - Slot for the app links.
+ * @slot businesssectors - Slot for the business sectors links.
+ * @slot meta - Slot for the meta links.
+ * @slot copyright - Slot for the copyright text.
+ */
+export declare class PostFooter {
+    host: HTMLPostFooterElement;
+    /**
+     * The label to add to the footer (visually hidden).
+     */
+    readonly label: string;
+    isMobile: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private readonly breakpointChange;
+    private renderAccordion;
+    private renderGrid;
+    render(): any;
+}

package/dist/types/components/post-header/post-header.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export type DEVICE_SIZE = 'mobile' | 'tablet' | 'desktop' | null;
+/**
+ * @slot post-logo - Should be used together with the `<post-logo>` component.
+ * @slot meta-navigation - Holds an `<ul>` with meta navigation links.
+ * @slot post-togglebutton - Holds the mobile menu toggler.
+ * @slot post-language-switch - Should be used with the `<post-language-switch>` component.
+ * @slot title - Holds the application title.
+ * @slot default - Custom controls or content, right aligned in the local header.
+ * @slot post-mainnavigation - Has a default slot because it's only meant to be used in the `<post-header>`.
+ */
+export declare class PostHeader {
+    private firstFocusableEl;
+    private lastFocusableEl;
+    private mobileMenu;
+    private mobileMenuAnimation;
+    private readonly throttledResize;
+    private scrollParentResizeObserver;
+    private localHeaderResizeObserver;
+    get scrollParent(): HTMLElement;
+    host: HTMLPostHeaderElement;
+    device: DEVICE_SIZE;
+    mobileMenuExtended: boolean;
+    megadropdownOpen: boolean;
+    lockBody(newValue: boolean | string, _oldValue: boolean | string, propName: string): void;
+    /**
+     * An event emitted when the device has changed
+     */
+    postUpdateDevice: EventEmitter<DEVICE_SIZE>;
+    constructor();
+    connectedCallback(): void;
+    componentWillRender(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    /**
+     * Toggles the mobile navigation.
+     */
+    toggleMobileMenu(force?: boolean): Promise<void>;
+    private megedropdownStateHandler;
+    private getFocusableElements;
+    private keyboardHandler;
+    private handleScrollEvent;
+    private updateLocalHeaderHeight;
+    private updateScrollParentHeight;
+    private handleLinkClick;
+    private handleResize;
+    private handleScrollParentResize;
+    private handleLocalHeaderResize;
+    private switchLanguageSwitchMode;
+    private renderNavigation;
+    render(): any;
+}

package/dist/types/components/post-icon/post-icon.d.ts

@@ -14,33 +14,37 @@ export declare class PostIcon {
      * The base path, where the icons are located (must be a public url).<br/>Leave this field empty to use the default cdn url.
      */
     readonly base?: string | null;
-    validateBase(newValue?: string): void;
+    validateBase(): void;
     /**
      * When set to `true`, the icon will be flipped horizontally.
      */
     readonly flipH?: boolean;
-    validateFlipH(newValue?: boolean): void;
+    validateFlipH(): void;
     /**
      * When set to `true`, the icon will be flipped vertically.
      */
     readonly flipV?: boolean;
-    validateFlipV(newValue?: boolean): void;
+    validateFlipV(): void;
     /**
      * The name/id of the icon (e.g. 1000, 1001, ...).
      */
     readonly name: string;
-    validateName(newValue?: string): void;
+    validateName(): void;
     /**
      * The number of degree for the css rotate transformation.
      */
     readonly rotate?: number | null;
-    validateRotate(newValue?: number): void;
+    validateRotate(): void;
     /**
      * The number for the css scale transformation.
      */
     readonly scale?: number | null;
-    validateScale(newValue?: number): void;
+    validateScale(): void;
     private getUrl;
+    private getUrlDefinition;
+    private getUrlObject;
+    private definesDomain;
+    private definesSlug;
     private getStyles;
     componentDidLoad(): void;
     render(): any;

package/dist/types/components/post-language-option/post-language-option.d.ts

@@ -0,0 +1,49 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { SwitchVariant } from '../post-language-switch/switch-variants';
+/**
+ * @slot default - Slot for placing the content inside the anchor or button.
+ */
+export declare class PostLanguageOption {
+    host: HTMLPostLanguageOptionElement;
+    /**
+     *  The ISO 639 language code, formatted according to [RFC 5646 (also known as BCP 47)](https://datatracker.ietf.org/doc/html/rfc5646). For example, "de".
+     */
+    code: string;
+    validateCode(): void;
+    /**
+     * If set to `true`, the language option is considered the current language for the page.
+     */
+    active: boolean;
+    validateActiveProp(): void;
+    /**
+     * To communicate the variant prop from the parent (post-language-switch) component to the child (post-language-option) component. See parent docs for a description about the property itself.
+     */
+    variant?: SwitchVariant | null;
+    /**
+     * The full name of the language. For example, "Deutsch".
+     */
+    name: string;
+    validateName(): void;
+    /**
+     * The URL used for the href attribute of the internal anchor.
+     * This field is optional; if not provided, a button will be used internally instead of an anchor.
+     */
+    url: string;
+    validateUrl(): void;
+    componentDidLoad(): void;
+    /**
+     * An event emitted when the language option is clicked. The payload is the ISO 639 code of the language.
+     */
+    postChange: EventEmitter<string>;
+    /**
+     * An event emitted when the language option is initially active. The payload is the ISO 639 code of the language.
+     */
+    postLanguageOptionInitiallyActive: EventEmitter<string>;
+    /**
+     * Selects the language option programmatically.
+     */
+    select(): Promise<void>;
+    private emitChange;
+    private isNameRequired;
+    render(): any;
+}

package/dist/types/components/post-language-switch/post-language-switch.d.ts

@@ -0,0 +1,39 @@
+import { SwitchVariant } from './switch-variants';
+export declare class PostLanguageSwitch {
+    private readonly menuId;
+    private get languageOptions();
+    host: HTMLPostLanguageSwitchElement;
+    /**
+     * A title for the list of language options
+     */
+    caption: string;
+    validateCaption(): void;
+    /**
+     * A descriptive text for the list of language options
+     */
+    description: string;
+    validateDescription(): void;
+    /**
+     * Whether the component is rendered as a list or a menu
+     */
+    variant: SwitchVariant;
+    validateVariant(): void;
+    /**
+     * The active language of the language switch
+     */
+    activeLang: string;
+    componentDidLoad(): void;
+    /**
+     * Listen for the postChange event and guard it to run only for events originating from a <post-language-option> element.
+     */
+    handlePostChange(event: CustomEvent<string>): void;
+    /**
+     * Handles cases where the language switch is being rendered before options are available
+     * @param event Initially emitted by <post-langauge-option>
+     */
+    handleInitiallyActive(event: CustomEvent<string>): void;
+    private updateChildrenVariant;
+    private renderList;
+    private renderDropdown;
+    render(): any;
+}

package/dist/types/components/post-language-switch/switch-variants.d.ts

@@ -0,0 +1,2 @@
+export declare const SWITCH_VARIANTS: readonly ["list", "menu"];
+export type SwitchVariant = (typeof SWITCH_VARIANTS)[number];

package/dist/types/components/post-linkarea/post-linkarea.d.ts

@@ -0,0 +1,5 @@
+export declare class PostLinkarea {
+    host: HTMLPostLinkareaElement;
+    private dispatchClick;
+    render(): any;
+}

package/dist/types/components/post-list/post-list.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @slot default - Slot for placing the list title.
+ * @slot post-list-item - Slot for placing post-list-item components.
+ */
+export declare class PostList {
+    host: HTMLPostListElement;
+    /**
+     * The unique title of the list that is also referenced in the labelledby
+     */
+    titleId: string;
+    /**
+     * If `true`, the list title will be hidden. Otherwise, it will be displayed.`
+     */
+    readonly titleHidden: boolean;
+    /**
+     * The list can become horizontal by setting `horizontal="true"` or just `horizontal`
+     */
+    readonly horizontal: boolean;
+    private titleEl;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    private checkTitle;
+    render(): any;
+}

package/dist/types/components/post-list-item/post-list-item.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @slot default- Slot for placing the content of the list item.
+ */
+export declare class PostListItem {
+    host: HTMLPostListItemElement;
+    connectedCallback(): void;
+    render(): any;
+}

package/dist/types/components/post-mainnavigation/post-mainnavigation.d.ts

@@ -0,0 +1,46 @@
+export declare class PostMainnavigation {
+    private navbar;
+    private scrollRepeatInterval;
+    private navbarDisableTimer;
+    private resizeObserver;
+    private mutationObserver;
+    canScrollLeft: boolean;
+    canScrollRight: boolean;
+    constructor();
+    componentDidLoad(): void;
+    /**
+     * Disconnects observers and remove event listeners when the main navigation is removed from the DOM.
+     */
+    disconnectedCallback(): void;
+    /**
+     * Stops the repeated scrolling when the mouse button is released.
+     */
+    stopScrolling(): void;
+    private handleMutations;
+    private get navigationItems();
+    /**
+     * Hack to fix the layout shift due to bold text on active elements
+     */
+    private fixLayoutShift;
+    private handleBackButtonClick;
+    /**
+     * Returns whether scrolling is enabled in either the left or right direction.
+     */
+    private get canScroll();
+    /**
+     * Checks if scrolling is possible in either direction (left or right) and updates the state accordingly.
+     */
+    private checkScrollability;
+    /**
+     * Handles the scrolling behavior when a user clicks on the left or right scroll buttons.
+     */
+    private handleScrollButtonClick;
+    private scrollRight;
+    private scrollLeft;
+    /**
+     * Temporarily disables interactions with the navbar during scrolling to prevent accidental clicks.
+     * Re-enables interactions after a brief delay to avoid blocking the user entirely.
+     */
+    private temporarilyDisableNavbar;
+    render(): any;
+}

package/dist/types/components/post-megadropdown/post-megadropdown.d.ts

@@ -0,0 +1,59 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export declare class PostMegadropdown {
+    private firstFocusableEl;
+    private lastFocusableEl;
+    device: string;
+    host: HTMLPostMegadropdownElement;
+    /** Tracks the currently active dropdown instance. */
+    private static activeDropdown;
+    private breakpointChange;
+    /**
+     * Holds the current visibility state of the dropdown.
+     * This state is internally managed to track whether the dropdown is open (`true`) or closed (`false`),
+     * and updates automatically when the dropdown is toggled.
+     */
+    isVisible: boolean;
+    /** Holds the current animation class. */
+    animationClass: string | null;
+    /**
+     * Emits when the dropdown is shown or hidden.
+     * The event payload is an object.
+     * `isVisible` is true when the dropdown gets opened and false when it gets closed
+     * `focusParent` determines whether after the closing of the mega dropdown, the focus should go back to the trigger parent or naturally go to the next focusable element in the page
+     **/
+    postToggleMegadropdown: EventEmitter<{
+        isVisible: boolean;
+        focusParent?: boolean;
+    }>;
+    disconnectedCallback(): void;
+    componentWillRender(): void;
+    /**
+     * Toggles the dropdown visibility based on its current state.
+     */
+    toggle(): Promise<void>;
+    /**
+     * Displays the dropdown.
+     */
+    show(): Promise<void>;
+    /**
+     * Hides the dropdown with an animation.
+     */
+    hide(focusParent?: boolean, forceClose?: boolean): Promise<void>;
+    /**
+     * Sets focus to the first focusable element within the component.
+     */
+    focusFirst(): Promise<void>;
+    connectedCallback(): void;
+    /**
+     * Forces the dropdown to close without animation.
+     */
+    private forceClose;
+    private handleAnimationEnd;
+    private handleClickOutside;
+    private addListeners;
+    private removeListeners;
+    private getFocusableElements;
+    private keyboardHandler;
+    private handleTabOutside;
+    render(): any;
+}

package/dist/types/components/post-megadropdown-trigger/post-megadropdown-trigger.d.ts

@@ -0,0 +1,33 @@
+export declare class PostMegadropdownTrigger {
+    /**
+     * ID of the mega dropdown element that this trigger is linked to. Used to open and close the specified mega dropdown.
+     */
+    for: string;
+    host: HTMLPostMegadropdownTriggerElement;
+    /**
+     * Manages the accessibility attribute `aria-expanded` to indicate whether the associated mega dropdown is expanded or collapsed.
+     */
+    ariaExpanded: boolean;
+    /**
+     * Reference to the slotted button within the trigger, if present.
+     * Used to manage click and key events for mega dropdown control.
+     */
+    private slottedButton;
+    /**
+     * Tracks whether this trigger's dropdown was expanded before a state change.
+     * Used to determine if this trigger should handle focus when its dropdown closes.
+     */
+    private wasExpanded;
+    /**
+     * Watch for changes to the `for` property to validate its type and ensure it is a string.
+     * @param forValue - The new value of the `for` property.
+     */
+    validateControlFor(): void;
+    private get megadropdown();
+    private handleToggle;
+    private handleKeyDown;
+    private handleToggleMegadropdown;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    render(): any;
+}

package/dist/types/components/post-menu/post-menu.d.ts

@@ -0,0 +1,49 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { Placement } from '@floating-ui/dom';
+export declare class PostMenu {
+    private popoverRef;
+    private lastFocusedElement;
+    private readonly KEYCODES;
+    host: HTMLPostMenuElement;
+    /**
+     * Defines the position of the menu relative to its trigger.
+     * Menus are automatically flipped to the opposite side if there is not enough available space and are shifted towards the viewport if they would overlap edge boundaries.
+     * For supported values and behavior details, see the [Floating UI placement documentation](https://floating-ui.com/docs/computePosition#placement).
+     */
+    readonly placement?: Placement;
+    /**
+     * Holds the current visibility state of the menu.
+     * This state is internally managed to track whether the menu is open (`true`) or closed (`false`),
+     * and updates automatically when the menu is toggled.
+     */
+    isVisible: boolean;
+    /**
+     * Emits when the menu is shown or hidden.
+     * The event payload is a boolean: `true` when the menu was opened, `false` when it was closed.
+     **/
+    toggleMenu: EventEmitter<boolean>;
+    private root?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    componentDidLoad(): void;
+    /**
+     * Toggles the menu visibility based on its current state.
+     */
+    toggle(target: HTMLElement): Promise<void>;
+    /**
+     * Displays the popover menu, focusing the first menu item.
+     *
+     * @param target - The HTML element relative to which the popover menu should be displayed.
+     */
+    show(target: HTMLElement): Promise<void>;
+    /**
+     * Hides the popover menu and restores focus to the previously focused element.
+     */
+    hide(): Promise<void>;
+    private handleKeyDown;
+    private handlePostToggle;
+    private handleClick;
+    private controlKeyDownHandler;
+    private getSlottedItems;
+    render(): any;
+}

package/dist/types/components/post-menu-item/post-menu-item.d.ts

@@ -0,0 +1,3 @@
+export declare class PostMenuItem {
+    render(): any;
+}

package/dist/types/components/post-menu-trigger/post-menu-trigger.d.ts

@@ -0,0 +1,28 @@
+export declare class PostMenuTrigger {
+    /**
+     * ID of the menu element that this trigger is linked to. Used to open and close the specified menu.
+     */
+    for: string;
+    host: HTMLPostMenuTriggerElement;
+    /**
+     * Manages the accessibility attribute `aria-expanded` to indicate whether the associated menu is expanded or collapsed.
+     */
+    ariaExpanded: boolean;
+    /**
+     * Reference to the slotted button within the trigger, if present.
+     * Used to manage click and key events for menu control.
+     */
+    private slottedButton;
+    private root;
+    /**
+     * Watch for changes to the `for` property to validate its type and ensure it is a string.
+     * @param forValue - The new value of the `for` property.
+     */
+    validateControlFor(): void;
+    private get menu();
+    private handleToggle;
+    private readonly handleKeyDown;
+    connectedCallback(): void;
+    componentDidLoad(): void;
+    render(): any;
+}

package/dist/types/components/post-popover/post-popover.d.ts

@@ -1,12 +1,13 @@
 import { Placement } from '@floating-ui/dom';
 export declare class PostPopover {
     private popoverRef;
-    private localBeforeToggleHandler;
+    private readonly localBeforeToggleHandler;
+    private readonly triggerObserver;
     host: HTMLPostPopoverElement;
     /**
-     * Defines the placement of the popover according to the floating-ui options available at https://floating-ui.com/docs/computePosition#placement.
-     * Popoverss are automatically flipped to the opposite side if there is not enough available space and are shifted
-     * towards the viewport if they would overlap edge boundaries.
+     * Defines the position of the popover relative to its trigger.
+     * Popovers are automatically flipped to the opposite side if there is not enough available space and are shifted towards the viewport if they would overlap edge boundaries.
+     * For supported values and behavior details, see the [Floating UI placement documentation](https://floating-ui.com/docs/computePosition#placement).
      */
     readonly placement?: Placement;
     /**
@@ -38,5 +39,6 @@ export declare class PostPopover {
     toggle(target: HTMLElement, force?: boolean): Promise<void>;
     private get triggers();
     private beforeToggleHandler;
+    private patchAccessibilityFeatures;
     render(): any;
 }

package/dist/types/components/post-popovercontainer/post-popovercontainer.d.ts

@@ -1,6 +1,5 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { Placement } from '@floating-ui/dom';
-import '@oddbird/popover-polyfill';
 interface PopoverElement {
     showPopover: () => void;
     hidePopover: () => void;
@@ -40,6 +39,10 @@ export declare class PostPopovercontainer {
      * Whether or not to display a little pointer arrow
      */
     readonly arrow?: boolean;
+    /**
+     * Whether or not the popovercontainer should close when user clicks outside of it
+     */
+    manualClose: boolean;
     /**
      * Enables a safespace through which the cursor can be moved without the popover being disabled
      */
@@ -50,6 +53,7 @@ export declare class PostPopovercontainer {
      * @param event MouseEvent with cursor position
      */
     private mouseTrackingHandler;
+    connectedCallback(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
     /**
@@ -79,6 +83,10 @@ export declare class PostPopovercontainer {
      * an influence on popovercontainer positioning
      */
     private startAutoupdates;
+    /**
+     * Retrieves the dynamic height of the header
+     */
+    private getHeaderHeight;
     private calculatePosition;
     private computeMainPosition;
     private updateSafeSpaceBoundaries;

package/dist/types/components/post-tab-header/post-tab-header.d.ts

@@ -8,7 +8,7 @@ export declare class PostTabHeader {
      * The name of the panel controlled by the tab header.
      */
     readonly panel: HTMLPostTabPanelElement['name'];
-    validateFor(newValue: HTMLPostTabPanelElement['name']): void;
+    validateFor(): void;
     componentWillLoad(): void;
     render(): any;
 }

package/dist/types/components/post-tabs/post-tabs.d.ts

@@ -23,7 +23,7 @@ export declare class PostTabs {
      * An event emitted after the active tab changes, when the fade in transition of its associated panel is finished.
      * The payload is the name of the newly shown panel.
      */
-    postChange: EventEmitter<HTMLPostTabPanelElement['name']>;
+    postChange: EventEmitter<string>;
     componentDidLoad(): void;
     /**
      * Shows the panel with the given name and selects its associated tab.

package/dist/types/components/post-tag/post-tag.d.ts

@@ -14,8 +14,8 @@ export declare class PostTag {
     readonly size: null | 'sm';
     /**
      * Defines the icon `name` inside of the component.
-     * <span className="alert alert-sm alert-info">If not set the icon will not show up.</span>
-     * To learn which icons are available, please visit our <a href="/?path=/docs/5704bdc4-c5b5-45e6-b123-c54d01fce2f1--docs">icon library</a>.
+     * <span className="banner banner-sm banner-info">If not set the icon will not show up.</span>
+     * To learn which icons are available, please visit our <a href="/?path=/docs/0dcfe3c0-bfc0-4107-b43b-7e9d825b805f--docs">icon library</a>.
      */
     readonly icon: null | string;
     constructor();

package/dist/types/components/post-togglebutton/post-togglebutton.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @slot default - Slot for the content of the button.
+ */
+export declare class PostTogglebutton {
+    host: HTMLPostTogglebuttonElement;
+    /**
+     * If `true`, the button is in the "on" state, otherwise it is in the "off" state.
+     */
+    toggled: boolean;
+    validateToggled(): void;
+    componentWillLoad(): void;
+    private handleClick;
+    private handleKeydown;
+    render(): any;
+}

package/dist/types/components/post-tooltip/post-tooltip.d.ts

@@ -21,6 +21,7 @@ export declare class PostTooltip {
      */
     open: boolean;
     validateOpen(): void;
+    connectedCallback(): void;
     componentDidLoad(): void;
     /**
      * Programmatically display the tooltip.

package/dist/types/components/post-tooltip-trigger/post-tooltip-trigger.d.ts

@@ -1,4 +1,3 @@
-import 'long-press-event';
 /**
  * @slot default - Content to trigger the tooltip. Can contain any focusable element or will be made focusable automatically.
  */