@swisspost/design-system-components 10.0.0-next.48 → 10.0.0-next.50

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

@@ -1,6 +1,7 @@
 import { Device } from "../../utils/breakpoints";
 /**
  * @slot post-logo - Should be used together with the `<post-logo>` component.
+ * @slot global-controls - Holds search button in the global header.
  * @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.
@@ -8,6 +9,8 @@ import { Device } from "../../utils/breakpoints";
  * @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>`.
  * @slot target-group - Holds the list of buttons to choose the target group.
+ * @slot global-login - Holds the user menu or login button in the global header.
+ * @slot navigation-controls - Custom controls, right aligned with the main navigation.
  */
 export declare class PostHeader {
     private firstFocusableEl;
@@ -22,6 +25,7 @@ export declare class PostHeader {
     host: HTMLPostHeaderElement;
     device: Device;
     hasNavigation: boolean;
+    hasTitle: boolean;
     mobileMenuExtended: boolean;
     megadropdownOpen: boolean;
     lockBody(newValue: boolean | string, _oldValue: boolean | string, propName: string): void;
@@ -33,6 +37,7 @@ export declare class PostHeader {
     componentDidLoad(): void;
     disconnectedCallback(): void;
     private checkNavigationExistence;
+    private checkTitleExistence;
     private closeMobileMenu;
     /**
      * Toggles the mobile navigation.

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

@@ -38,6 +38,17 @@ export declare class PostIcon {
      */
     readonly scale?: number;
     validateScale(): void;
+    /**
+     * Construct the icon URL according to the following rules:
+     * 1. `@base` (absolute URL) → use directly.
+     * 2. `@base` (relative URL) → resolve with `base href` and/or `origin`
+     *  - If `base href` is absolute → use just that.
+     *  - If `base href` is relative → prepend with `origin`.
+     *  - If `base href` does not exist → use only `origin`.
+     * 3. `@meta` (absolute URL) → use directly.
+     * 4. `@meta` (relative URL) → resolve with `base href` and/or `origin`. (same as above)
+     * 5. `CDN_URL` fallback → `https://unpkg.com/...`.
+     **/
     private getUrl;
     private getStyles;
     componentDidLoad(): void;

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

@@ -1,5 +1,11 @@
 export declare class PostLinkarea {
+    private mutationObserver;
     host: HTMLPostLinkareaElement;
+    interactiveElements: NodeListOf<HTMLAnchorElement>;
     private dispatchClick;
+    private checkInteractiveElements;
+    connectedCallback(): void;
+    componentWillLoad(): void;
+    disconnectedCallback(): void;
     render(): any;
 }

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

@@ -3,19 +3,21 @@ import { Device } from "../../utils/breakpoints";
 export declare class PostMegadropdown {
     private firstFocusableEl;
     private lastFocusableEl;
-    device: Device;
-    host: HTMLPostMegadropdownElement;
     /** Tracks the currently active dropdown instance. */
     private static activeDropdown;
-    private breakpointChange;
+    private defaultSlotObserver;
+    host: HTMLPostMegadropdownElement;
+    device: Device;
     /**
      * 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;
+    trigger: boolean;
     /** Holds the current animation class. */
     animationClass: string | null;
+    private get megadropdownTrigger();
     /**
      * Emits when the dropdown is shown or hidden.
      * The event payload is an object.
@@ -26,8 +28,10 @@ export declare class PostMegadropdown {
         isVisible: boolean;
         focusParent?: boolean;
     }>;
+    connectedCallback(): void;
+    componentDidRender(): void;
+    componentDidLoad(): void;
     disconnectedCallback(): void;
-    componentWillRender(): void;
     /**
      * Toggles the dropdown visibility based on its current state.
      */
@@ -44,17 +48,40 @@ export declare class PostMegadropdown {
      * Sets focus to the first focusable element within the component.
      */
     focusFirst(): Promise<void>;
-    connectedCallback(): void;
+    private breakpointChange;
     /**
      * Forces the dropdown to close without animation.
      */
     private forceClose;
     private handleAnimationEnd;
-    private handleClickOutside;
+    private readonly handleClickOutside;
     private addListeners;
     private removeListeners;
     private getFocusableElements;
     private keyboardHandler;
     private handleTabOutside;
+    /**
+     * Sets up a MutationObserver on the host to watch for changes
+     * in `aria-current` attributes.
+     */
+    private setupObserver;
+    /**
+     * Adds or removes the 'active' class on the megadropdown trigger button
+     * based on the active state.
+     *
+     * @param isActive - Whether the trigger should appear active
+     */
+    private setTriggerActive;
+    /**
+     * Updates the megadropdown trigger state when the megadropdown content changes.
+     * Checks if any element inside the megadropdown has `aria-current="page"`
+     * and sets the trigger as active accordingly.
+     */
+    private handleAriaCurrentChange;
+    /**
+     * Checks on initialization if any element inside the megadropdown
+     * has `aria-current="page"` and sets the trigger as active if so.
+     */
+    private checkInitialAriaCurrent;
     render(): any;
 }

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

@@ -2,7 +2,8 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { Placement } from '@floating-ui/dom';
 /**
  * @part menu - The container element that holds the list of menu items.
-*/
+ * @slot header - Holds the header part of the menu.
+ */
 export declare class PostMenu {
     private popoverRef;
     private lastFocusedElement;
@@ -15,6 +16,11 @@ export declare class PostMenu {
      */
     readonly placement?: Placement;
     validatePlacement(): void;
+    /**
+     * An accessible name for the menu.
+     */
+    readonly label: string;
+    validateLabel(): void;
     /**
      * Holds the current visibility state of the menu.
      * This state is internally managed to track whether the menu is open (`true`) or closed (`false`),

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

@@ -17,10 +17,14 @@ export declare class PostPopovercontainer {
     private eventTarget;
     private clearAutoUpdate;
     private toggleTimeoutId;
+    private firstOpen;
     /**
-     * Fires whenever the popovercontainer gets shown or hidden, passing the new state in event.details as a boolean
+     * Fires whenever the popovercontainer gets shown or hidden, passing in event.detail an object containing two booleans: `isOpen`, which is true if the popovercontainer was opened and false if it was closed, and `first`, which is true if it was opened for the first time.
      */
-    postToggle: EventEmitter<boolean>;
+    postToggle: EventEmitter<{
+        isOpen: boolean;
+        first?: boolean;
+    }>;
     /**
      * Defines the placement of the popovercontainer according to the floating-ui options available at https://floating-ui.com/docs/computePosition#placement.
      * Popovercontainers are automatically flipped to the opposite side if there is not enough available space and are shifted

package/dist/types/components.d.ts

@@ -7,10 +7,12 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { HeadingLevel } from "./types/index";
 import { BannerType } from "./components/post-banner/banner-types";
+import { ButtonType } from "./components/post-closebutton/button-types";
 import { SwitchVariant } from "./components/post-language-switch/switch-variants";
 import { Placement } from "@floating-ui/dom";
 export { HeadingLevel } from "./types/index";
 export { BannerType } from "./components/post-banner/banner-types";
+export { ButtonType } from "./components/post-closebutton/button-types";
 export { SwitchVariant } from "./components/post-language-switch/switch-variants";
 export { Placement } from "@floating-ui/dom";
 export namespace Components {
@@ -54,6 +56,10 @@ export namespace Components {
         "toggle": (force?: boolean) => Promise<boolean>;
     }
     interface PostAvatar {
+        /**
+          * Provides a custom description for the avatar, used for accessibility purposes.
+         */
+        "description"?: string;
         /**
           * Defines the users email address associated with a gravatar profile picture.
          */
@@ -104,6 +110,10 @@ export namespace Components {
           * The URL for the home breadcrumb item.
          */
         "homeUrl": string;
+        /**
+          * The accessible label for the breadcrumb menu when breadcrumb items are concatenated.
+         */
+        "menuLabel": string;
     }
     /**
      * @class PostCardControl - representing a stencil component
@@ -157,6 +167,11 @@ export namespace Components {
         "value"?: string;
     }
     interface PostClosebutton {
+        /**
+          * Overrides the close button's type ("button" by default)
+          * @default 'button'
+         */
+        "buttonType"?: ButtonType;
     }
     interface PostCollapsible {
         /**
@@ -320,6 +335,10 @@ export namespace Components {
           * Hides the popover menu and restores focus to the previously focused element.
          */
         "hide": () => Promise<void>;
+        /**
+          * An accessible name for the menu.
+         */
+        "label": string;
         /**
           * 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).
           * @default 'bottom'
@@ -798,7 +817,7 @@ declare global {
         new (): HTMLPostPopoverElement;
     };
     interface HTMLPostPopovercontainerElementEventMap {
-        "postToggle": boolean;
+        "postToggle": { isOpen: boolean; first?: boolean };
     }
     interface HTMLPostPopovercontainerElement extends Components.PostPopovercontainer, HTMLStencilElement {
         addEventListener<K extends keyof HTMLPostPopovercontainerElementEventMap>(type: K, listener: (this: HTMLPostPopovercontainerElement, ev: PostPopovercontainerCustomEvent<HTMLPostPopovercontainerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -942,6 +961,10 @@ declare namespace LocalJSX {
         "headingLevel"?: HeadingLevel;
     }
     interface PostAvatar {
+        /**
+          * Provides a custom description for the avatar, used for accessibility purposes.
+         */
+        "description"?: string;
         /**
           * Defines the users email address associated with a gravatar profile picture.
          */
@@ -992,6 +1015,10 @@ declare namespace LocalJSX {
           * The URL for the home breadcrumb item.
          */
         "homeUrl": string;
+        /**
+          * The accessible label for the breadcrumb menu when breadcrumb items are concatenated.
+         */
+        "menuLabel": string;
     }
     /**
      * @class PostCardControl - representing a stencil component
@@ -1045,6 +1072,11 @@ declare namespace LocalJSX {
         "value"?: string;
     }
     interface PostClosebutton {
+        /**
+          * Overrides the close button's type ("button" by default)
+          * @default 'button'
+         */
+        "buttonType"?: ButtonType;
     }
     interface PostCollapsible {
         /**
@@ -1188,6 +1220,10 @@ declare namespace LocalJSX {
         "for": string;
     }
     interface PostMenu {
+        /**
+          * An accessible name for the menu.
+         */
+        "label": string;
         /**
           * 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.
          */
@@ -1244,9 +1280,9 @@ declare namespace LocalJSX {
          */
         "manualClose"?: boolean;
         /**
-          * Fires whenever the popovercontainer gets shown or hidden, passing the new state in event.details as a boolean
+          * Fires whenever the popovercontainer gets shown or hidden, passing in event.detail an object containing two booleans: `isOpen`, which is true if the popovercontainer was opened and false if it was closed, and `first`, which is true if it was opened for the first time.
          */
-        "onPostToggle"?: (event: PostPopovercontainerCustomEvent<boolean>) => void;
+        "onPostToggle"?: (event: PostPopovercontainerCustomEvent<{ isOpen: boolean; first?: boolean }>) => void;
         /**
           * Defines the placement of the popovercontainer according to the floating-ui options available at https://floating-ui.com/docs/computePosition#placement. Popovercontainers 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.
           * @default 'top'

package/dist/types/utils/event-from.d.ts

@@ -5,5 +5,6 @@
  * @param option.ignoreNestedComponents - Whether to ignore events from nested components
  */
 export declare function EventFrom(tag: string, option?: {
-    ignoreNestedComponents: boolean;
+    ignoreNestedComponents?: boolean;
+    allowDescendants?: boolean;
 }): (target: object, propertyKey: string, descriptor?: PropertyDescriptor) => void;