@ebrains/components 2.1.0 → 2.3.0

package/dist/types/components.d.ts

@@ -504,12 +504,20 @@ export namespace Components {
     /**
      * `EdsDropdown` is a versatile dropdown component that provides a list of items
      * that appear upon clicking the dropdown button. It supports various customization options,
-     * such as positioning, styling, and keyboard accessibility.
-     * Key features include:
-     * - Configurable dropdown position (left or right) and offset.
-     * - Customizable intent styles (e.g., primary, secondary).
-     * - Keyboard navigation with support for up and down arrow keys.
-     * - Option to use as a navigation menu or standard dropdown.
+     * such as positioning, styling, keyboard accessibility, and automatic closing behavior.
+     * ## Key Features:
+     * - Configurable dropdown position (left or right) and offset
+     * - Customizable intent styles (e.g., primary, secondary)
+     * - Keyboard navigation with support for up and down arrow keys
+     * - Automatic closing on clicks inside the dropdown panel
+     * - Flexible opt-in/opt-out mechanisms for closing behavior
+     * - Option to use as a navigation menu or standard dropdown
+     * ## Auto-Close Behavior:
+     * By default (`autoClose: true`), the dropdown closes when any element inside the panel is clicked.
+     * This includes links, buttons, custom elements, or any other clickable content.
+     * ## Data Attributes:
+     * - `data-dropdown-close`: Force close dropdown when clicked (works regardless of autoClose setting)
+     * - `data-dropdown-no-close`: Prevent dropdown from closing when this element or its children are clicked
      * This component is well-suited for use in menus, navigational elements, and other interactive UI patterns.
      */
     interface EdsDropdown {
@@ -525,6 +533,11 @@ export namespace Components {
           * @default true
          */
         "asNav": boolean;
+        /**
+          * Auto-close dropdown prop - when true, any click inside the panel closes the dropdown
+         */
+        "autoClose": boolean;
+        "close": () => Promise<void>;
         /**
           * Offset spacing for the dropdown relative to the button.
           * @type {boolean}
@@ -554,6 +567,10 @@ export namespace Components {
           * @type {string}
          */
         "label": string;
+        /**
+          * Opt-out attribute - elements with this attribute won't trigger auto-close
+         */
+        "noCloseSelector": string;
         /**
           * Whether the dropdown nav list placeholder has rounded (pill) styling.
           * @type {boolean}
@@ -610,6 +627,10 @@ export namespace Components {
           * @type {string}
          */
         "cookiesPreferences": string;
+        /**
+          * Controls the display of the "Cookies preferences" link.
+          * @type {string}
+         */
         "enableCookiesSettings": boolean;
         /**
           * Controls the display of the "Back to Top" button. When true, the button appears in the footer.
@@ -643,6 +664,14 @@ export namespace Components {
      * This component is ideal for implementing complex forms with specific validation and submission behaviors.
      */
     interface EdsForm {
+        /**
+          * Variant/style intent for the submit button (e.g., primary, secondary, tertiary, ghost).
+         */
+        "buttonIntent"?: 'primary' | 'secondary' | 'tertiary' | 'ghost';
+        /**
+          * The description displayed below the title.
+         */
+        "description"?: string;
         /**
           * The message displayed when the form submission fails.
          */
@@ -659,6 +688,10 @@ export namespace Components {
           * If `true`, includes a submit button in the form.
          */
         "formBtnLabel"?: string;
+        /**
+          * Choose between default layout or an always-shadow style. When "shadow", the form gets the same effect-shadow + shadow-hover classes
+         */
+        "formStyle": 'default' | 'shadow';
         "getData": () => Promise<FormData>;
         /**
           * New: list of groups, each with `{ id: string, title: string }`
@@ -677,6 +710,10 @@ export namespace Components {
           * If `true`, includes the current form URL in the submission data.
          */
         "setFormUrl"?: boolean;
+        /**
+          * The title displayed above the form.
+         */
+        "title": string;
     }
     interface EdsFrame {
         /**
@@ -719,14 +756,27 @@ export namespace Components {
      * - **Footer Integration**: Optionally displays social links and a customizable footer section within the fullscreen menu.
      */
     interface EdsFullscreenMenu {
+        /**
+          * URL for the logo link in the header.
+          * @default "/"
+          * @attr home-url
+         */
         "homeUrl": string;
+        /**
+          * When true, uses an inverse (dark) header background.
+          * @default false
+          * @attr inverse-header
+         */
         "inverseHeader": boolean;
         /**
-          * JSON string representing the links for primary navigation. Each link should include `label`, `url`, and optionally an `icon`.
+          * Primary navigation links. Accepts a JSON string or array of objects `{ label, url, icon?, external? }`.
+          * @example links='[{"label":"Home","url":"/"},{"label":"Docs","url":"/docs","icon":"book"}]'
          */
-        "links": string | { label: string; url: string; icon?: string; external?: boolean }[];
+        "links": string | LinkItem[];
         /**
-          * JSON string representing the extra menu links a user wants for smaill screens navigation. Each link should include `label`, `url`.
+          * Secondary navigation links (extra menu items for small screens). Accepts a JSON string or array of objects `{ label, url }`.
+          * @example menu-links='[{"label":"Help","url":"/help"},{"label":"Contact","url":"/contact"}]'
+          * @attr menu-links
          */
         "menuLinks": string;
     }
@@ -753,6 +803,24 @@ export namespace Components {
         "valueMin": number;
         "variant": 'default' | 'dark' | 'strong' | 'black';
     }
+    interface EdsGlobalSearch {
+        /**
+          * API endpoint for search
+         */
+        "apiEndpoint": string;
+        /**
+          * Debounce delay in milliseconds
+         */
+        "debounceDelay": number;
+        /**
+          * Maximum number of results to fetch
+         */
+        "limit": number;
+        /**
+          * Placeholder text for the input
+         */
+        "placeholder": string;
+    }
     /**
      * `EdsHeader` is a header component designed for the EBRAINS platform.
      * It provides a customizable and responsive navigation experience, tailored for both desktop and mobile views.
@@ -854,6 +922,12 @@ export namespace Components {
          */
         "class": string;
     }
+    interface EdsIconDownload {
+        /**
+          * Additional CSS classes to be applied to the icon for styling.
+         */
+        "class": string;
+    }
     interface EdsIconDraft {
         /**
           * Additional CSS classes to be applied to the icon for styling.
@@ -1473,17 +1547,24 @@ export namespace Components {
     }
     interface EdsMatomoNotice {
         /**
-          * The description displayed in the notice.
+          * The description displayed when the user has not yet opted in to analytics.
+          * @default "We use anonymous analytics..."
          */
         "description": string;
         /**
-          * When true, the notice is forced to show regardless of cookies/session.
+          * When true, the notice is forced to show regardless of cookies or session storage state. Useful for testing or forcing the consent UI.
+          * @default false
          */
         "forceShow": boolean;
         /**
-          * The title displayed in the notice.
+          * The title displayed in the notice accordion.
+          * @default "Analytics Consent"
          */
         "heading": string;
+        /**
+          * The description displayed when the user has already opted in to analytics.
+          * @default "You are already part of our community..."
+         */
         "optOutMessage": string;
     }
     /**
@@ -1725,25 +1806,74 @@ export namespace Components {
     }
     interface EdsSteps {
         /**
-          * JSON string containing an array of step objects. Example: '[   { "title": "Get Access...", "content": "To participate..." },   { "title": "Subscribe...", "content": "Technical Coordination..." },   { "title": "Confirm Your Subscription" } ]'
+          * Label for the **Back** button (linear mode).
+          * @default "Back"
+          * @attr back-label
+         */
+        "backLabel": string;
+        /**
+          * If `true`, disables **Next/Finish** and prevents advancing. Useful for gating progression until validation passes.
+          * @default false
+          * @attr disable-next
+         */
+        "disableNext": boolean | boolean[];
+        /**
+          * Label for the **Finish** button on the **last step** (linear mode).
+          * @default "Finish"
+          * @attr finish-label
+         */
+        "finishLabel": string;
+        /**
+          * Semantic heading tag used for each step title. Accepted values: `"h3" | "h4" | "h5"`.
+          * @default "h4"
+          * @attr heading-level
+         */
+        "headingLevel": 'h3' | 'h4' | 'h5';
+        /**
+          * Label for the **Next** button (linear mode).
+          * @default "Next"
+          * @attr next-label
+         */
+        "nextLabel": string;
+        /**
+          * Steps data as an **array** or **JSON string** of objects: `{ title: string; content?: string }`.  In static mode, all steps and their content render. In linear mode, only the active step renders its content.
+          * @default []
          */
         "steps": string | Step[];
         /**
-          * The type of stepper. Default is "static" (all steps visible, no buttons). If set to "linear", then only one step is visible at a time with navigation.
+          * Stepper mode. - `static`: all steps are visible (no navigation controls) - `linear`: one step at a time with Back/Next/Finish controls
+          * @default "static"
          */
         "type": 'static' | 'linear';
     }
     interface EdsStepsV2 {
         /**
-          * If true, apply a background class to the container.
+          * Label text for the "Back" button.
+         */
+        "backLabel": string;
+        /**
+          * If true, apply an inverse background to the container.
          */
         "bg": boolean;
+        /**
+          * If true, disables the "Next" button to block progression.
+         */
+        "disableNext": boolean;
+        /**
+          * Label text for the "Finish" button (last step in linear mode).
+         */
+        "finishLabel": string;
+        /**
+          * Heading level to use for each step title.
+          * @default "h4"
+         */
+        "headingLevel": 'h3' | 'h4' | 'h5';
         /**
           * Optional image source to display above the steps.
          */
         "imageSrc"?: string;
         /**
-          * Optional image width for the eds-img component.
+          * Optional image width for the `eds-img` component.
          */
         "imageWidth"?: number;
         /**
@@ -1751,11 +1881,16 @@ export namespace Components {
          */
         "message"?: string;
         /**
-          * JSON string or an array of step objects. Example: '[   { "title": "Step One", "content": "Details for step one" },   { "title": "Step Two", "content": "Details for step two" } ]'
+          * Label text for the "Next" button.
+         */
+        "nextLabel": string;
+        /**
+          * JSON string or an array of step objects. Each object should have a `title` and optional `content` property.
          */
         "steps": string | Step1[];
         /**
-          * The type of stepper. Default is "static" (all steps visible, no navigation buttons). Use "linear" if only one step should be visible at a time.
+          * The type of stepper: - `"static"`: shows all steps with their content. - `"linear"`: shows only one step at a time with navigation controls.
+          * @default "static"
          */
         "type": 'static' | 'linear';
     }
@@ -1791,7 +1926,7 @@ export namespace Components {
          */
         "actionTemplate"?: (row: any) => VNode;
         /**
-          * Array of actions to render in each row. Each action should have:  - `name`: a unique key (e.g. "view", "delete")  - `label`: what shows in the button (or you could pass an icon name here)
+          * Array of actions to render in each row. Can be passed as a JSON string or as a `TableAction[]`.  Each action object may include:  - `name`       (string; required)  — unique action key, e.g. `"view"`, `"delete"`.  - `label`      (string; required)  — text shown on the button, or used as the tooltip/aria-label when icon-only.  - `type`       ("button" | "checkbox"; optional) — whether to render a standard button (default) or a checkbox.  - `icon`       (string; optional)  — name of the icon to display in icon-only mode.  - `field`      (string; optional)  — for checkboxes, the row field whose truthiness binds the checked state (defaults to `name`).  - `showLabel`  (boolean; optional) — if `true`, render the full `label` instead of an icon + tooltip.  When you pass JSON, make sure field names match exactly: ```html actions='[   { "name":"view",  "label":"View",  "icon":"eye" },   { "name":"edit",  "label":"Edit",  "icon":"pencil", "showLabel":true },   { "name":"del",   "label":"Delete","type":"checkbox", "field":"selected" } ]' ```
          */
         "actions": string | TableAction[];
         /**
@@ -1856,7 +1991,7 @@ export namespace Components {
         /**
           * The visual style or intent of the tag.
          */
-        "intent": 'default' | 'strong' | 'accent' | 'weak' | 'inverse' | 'inverse-strong';
+        "intent": 'primary' | 'default' | 'strong' | 'accent' | 'weak' | 'inverse' | 'inverse-strong';
         /**
           * The label to be displayed inside the tag.
          */
@@ -1910,6 +2045,12 @@ export namespace Components {
      * This component is ideal for embedding into any layout requiring user authentication.
      */
     interface EdsUser {
+        "closeDropdown": () => Promise<void>;
+        "dropdownLabel": string;
+        /**
+          * Visual intent of the trigger button
+         */
+        "intent": Intent;
         /**
           * The user object containing user information, or a JSON string to be parsed.
          */
@@ -1986,6 +2127,10 @@ export interface EdsFullscreenMenuCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLEdsFullscreenMenuElement;
 }
+export interface EdsGlobalSearchCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLEdsGlobalSearchElement;
+}
 export interface EdsHeaderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLEdsHeaderElement;
@@ -2295,12 +2440,20 @@ declare global {
     /**
      * `EdsDropdown` is a versatile dropdown component that provides a list of items
      * that appear upon clicking the dropdown button. It supports various customization options,
-     * such as positioning, styling, and keyboard accessibility.
-     * Key features include:
-     * - Configurable dropdown position (left or right) and offset.
-     * - Customizable intent styles (e.g., primary, secondary).
-     * - Keyboard navigation with support for up and down arrow keys.
-     * - Option to use as a navigation menu or standard dropdown.
+     * such as positioning, styling, keyboard accessibility, and automatic closing behavior.
+     * ## Key Features:
+     * - Configurable dropdown position (left or right) and offset
+     * - Customizable intent styles (e.g., primary, secondary)
+     * - Keyboard navigation with support for up and down arrow keys
+     * - Automatic closing on clicks inside the dropdown panel
+     * - Flexible opt-in/opt-out mechanisms for closing behavior
+     * - Option to use as a navigation menu or standard dropdown
+     * ## Auto-Close Behavior:
+     * By default (`autoClose: true`), the dropdown closes when any element inside the panel is clicked.
+     * This includes links, buttons, custom elements, or any other clickable content.
+     * ## Data Attributes:
+     * - `data-dropdown-close`: Force close dropdown when clicked (works regardless of autoClose setting)
+     * - `data-dropdown-no-close`: Prevent dropdown from closing when this element or its children are clicked
      * This component is well-suited for use in menus, navigational elements, and other interactive UI patterns.
      */
     interface HTMLEdsDropdownElement extends Components.EdsDropdown, HTMLStencilElement {
@@ -2436,6 +2589,34 @@ declare global {
         prototype: HTMLEdsGaugeElement;
         new (): HTMLEdsGaugeElement;
     };
+    interface HTMLEdsGlobalSearchElementEventMap {
+        "resultSelected": {
+    id: string;
+    title: string;
+    url: string;
+    section: string;
+    tags: string[];
+    date: string | null;
+    source: string;
+    snippet: string;
+    score: number | null;
+  };
+        "searchClosed": void;
+    }
+    interface HTMLEdsGlobalSearchElement extends Components.EdsGlobalSearch, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLEdsGlobalSearchElementEventMap>(type: K, listener: (this: HTMLEdsGlobalSearchElement, ev: EdsGlobalSearchCustomEvent<HTMLEdsGlobalSearchElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLEdsGlobalSearchElementEventMap>(type: K, listener: (this: HTMLEdsGlobalSearchElement, ev: EdsGlobalSearchCustomEvent<HTMLEdsGlobalSearchElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLEdsGlobalSearchElement: {
+        prototype: HTMLEdsGlobalSearchElement;
+        new (): HTMLEdsGlobalSearchElement;
+    };
     interface HTMLEdsHeaderElementEventMap {
         "toggleheadermenu": boolean;
     }
@@ -2536,6 +2717,12 @@ declare global {
         prototype: HTMLEdsIconCopyElement;
         new (): HTMLEdsIconCopyElement;
     };
+    interface HTMLEdsIconDownloadElement extends Components.EdsIconDownload, HTMLStencilElement {
+    }
+    var HTMLEdsIconDownloadElement: {
+        prototype: HTMLEdsIconDownloadElement;
+        new (): HTMLEdsIconDownloadElement;
+    };
     interface HTMLEdsIconDraftElement extends Components.EdsIconDraft, HTMLStencilElement {
     }
     var HTMLEdsIconDraftElement: {
@@ -3017,6 +3204,9 @@ declare global {
     };
     interface HTMLEdsStepsElementEventMap {
         "step": number;
+        "finished": void;
+        "next": number;
+        "back": number;
     }
     interface HTMLEdsStepsElement extends Components.EdsSteps, HTMLStencilElement {
         addEventListener<K extends keyof HTMLEdsStepsElementEventMap>(type: K, listener: (this: HTMLEdsStepsElement, ev: EdsStepsCustomEvent<HTMLEdsStepsElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3034,6 +3224,9 @@ declare global {
     };
     interface HTMLEdsStepsV2ElementEventMap {
         "step": number;
+        "finished": void;
+        "next": number;
+        "back": number;
     }
     interface HTMLEdsStepsV2Element extends Components.EdsStepsV2, HTMLStencilElement {
         addEventListener<K extends keyof HTMLEdsStepsV2ElementEventMap>(type: K, listener: (this: HTMLEdsStepsV2Element, ev: EdsStepsV2CustomEvent<HTMLEdsStepsV2ElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3312,6 +3505,7 @@ declare global {
         "eds-frame": HTMLEdsFrameElement;
         "eds-fullscreen-menu": HTMLEdsFullscreenMenuElement;
         "eds-gauge": HTMLEdsGaugeElement;
+        "eds-global-search": HTMLEdsGlobalSearchElement;
         "eds-header": HTMLEdsHeaderElement;
         "eds-icon-arrow-diagonal": HTMLEdsIconArrowDiagonalElement;
         "eds-icon-arrow-right": HTMLEdsIconArrowRightElement;
@@ -3325,6 +3519,7 @@ declare global {
         "eds-icon-clone": HTMLEdsIconCloneElement;
         "eds-icon-close": HTMLEdsIconCloseElement;
         "eds-icon-copy": HTMLEdsIconCopyElement;
+        "eds-icon-download": HTMLEdsIconDownloadElement;
         "eds-icon-draft": HTMLEdsIconDraftElement;
         "eds-icon-edit": HTMLEdsIconEditElement;
         "eds-icon-eu": HTMLEdsIconEuElement;
@@ -3903,12 +4098,20 @@ declare namespace LocalJSX {
     /**
      * `EdsDropdown` is a versatile dropdown component that provides a list of items
      * that appear upon clicking the dropdown button. It supports various customization options,
-     * such as positioning, styling, and keyboard accessibility.
-     * Key features include:
-     * - Configurable dropdown position (left or right) and offset.
-     * - Customizable intent styles (e.g., primary, secondary).
-     * - Keyboard navigation with support for up and down arrow keys.
-     * - Option to use as a navigation menu or standard dropdown.
+     * such as positioning, styling, keyboard accessibility, and automatic closing behavior.
+     * ## Key Features:
+     * - Configurable dropdown position (left or right) and offset
+     * - Customizable intent styles (e.g., primary, secondary)
+     * - Keyboard navigation with support for up and down arrow keys
+     * - Automatic closing on clicks inside the dropdown panel
+     * - Flexible opt-in/opt-out mechanisms for closing behavior
+     * - Option to use as a navigation menu or standard dropdown
+     * ## Auto-Close Behavior:
+     * By default (`autoClose: true`), the dropdown closes when any element inside the panel is clicked.
+     * This includes links, buttons, custom elements, or any other clickable content.
+     * ## Data Attributes:
+     * - `data-dropdown-close`: Force close dropdown when clicked (works regardless of autoClose setting)
+     * - `data-dropdown-no-close`: Prevent dropdown from closing when this element or its children are clicked
      * This component is well-suited for use in menus, navigational elements, and other interactive UI patterns.
      */
     interface EdsDropdown {
@@ -3924,6 +4127,10 @@ declare namespace LocalJSX {
           * @default true
          */
         "asNav"?: boolean;
+        /**
+          * Auto-close dropdown prop - when true, any click inside the panel closes the dropdown
+         */
+        "autoClose"?: boolean;
         /**
           * Offset spacing for the dropdown relative to the button.
           * @type {boolean}
@@ -3953,6 +4160,10 @@ declare namespace LocalJSX {
           * @type {string}
          */
         "label"?: string;
+        /**
+          * Opt-out attribute - elements with this attribute won't trigger auto-close
+         */
+        "noCloseSelector"?: string;
         /**
           * Event emitted when the dropdown toggles, indicating the new expanded/collapsed state
          */
@@ -4017,6 +4228,10 @@ declare namespace LocalJSX {
           * @type {string}
          */
         "cookiesPreferences"?: string;
+        /**
+          * Controls the display of the "Cookies preferences" link.
+          * @type {string}
+         */
         "enableCookiesSettings"?: boolean;
         /**
           * Controls the display of the "Back to Top" button. When true, the button appears in the footer.
@@ -4051,6 +4266,14 @@ declare namespace LocalJSX {
      * This component is ideal for implementing complex forms with specific validation and submission behaviors.
      */
     interface EdsForm {
+        /**
+          * Variant/style intent for the submit button (e.g., primary, secondary, tertiary, ghost).
+         */
+        "buttonIntent"?: 'primary' | 'secondary' | 'tertiary' | 'ghost';
+        /**
+          * The description displayed below the title.
+         */
+        "description"?: string;
         /**
           * The message displayed when the form submission fails.
          */
@@ -4067,6 +4290,10 @@ declare namespace LocalJSX {
           * If `true`, includes a submit button in the form.
          */
         "formBtnLabel"?: string;
+        /**
+          * Choose between default layout or an always-shadow style. When "shadow", the form gets the same effect-shadow + shadow-hover classes
+         */
+        "formStyle"?: 'default' | 'shadow';
         /**
           * New: list of groups, each with `{ id: string, title: string }`
          */
@@ -4091,6 +4318,10 @@ declare namespace LocalJSX {
           * If `true`, includes the current form URL in the submission data.
          */
         "setFormUrl"?: boolean;
+        /**
+          * The title displayed above the form.
+         */
+        "title"?: string;
     }
     interface EdsFrame {
         /**
@@ -4133,18 +4364,32 @@ declare namespace LocalJSX {
      * - **Footer Integration**: Optionally displays social links and a customizable footer section within the fullscreen menu.
      */
     interface EdsFullscreenMenu {
+        /**
+          * URL for the logo link in the header.
+          * @default "/"
+          * @attr home-url
+         */
         "homeUrl"?: string;
+        /**
+          * When true, uses an inverse (dark) header background.
+          * @default false
+          * @attr inverse-header
+         */
         "inverseHeader"?: boolean;
         /**
-          * JSON string representing the links for primary navigation. Each link should include `label`, `url`, and optionally an `icon`.
+          * Primary navigation links. Accepts a JSON string or array of objects `{ label, url, icon?, external? }`.
+          * @example links='[{"label":"Home","url":"/"},{"label":"Docs","url":"/docs","icon":"book"}]'
          */
-        "links"?: string | { label: string; url: string; icon?: string; external?: boolean }[];
+        "links"?: string | LinkItem[];
         /**
-          * JSON string representing the extra menu links a user wants for smaill screens navigation. Each link should include `label`, `url`.
+          * Secondary navigation links (extra menu items for small screens). Accepts a JSON string or array of objects `{ label, url }`.
+          * @example menu-links='[{"label":"Help","url":"/help"},{"label":"Contact","url":"/contact"}]'
+          * @attr menu-links
          */
         "menuLinks"?: string;
         /**
-          * Event to signal menu open/close actions
+          * Emitted when the menu is closed (via UI or resize).
+          * @event menuClose
          */
         "onMenuClose"?: (event: EdsFullscreenMenuCustomEvent<void>) => void;
     }
@@ -4171,6 +4416,42 @@ declare namespace LocalJSX {
         "valueMin"?: number;
         "variant"?: 'default' | 'dark' | 'strong' | 'black';
     }
+    interface EdsGlobalSearch {
+        /**
+          * API endpoint for search
+         */
+        "apiEndpoint"?: string;
+        /**
+          * Debounce delay in milliseconds
+         */
+        "debounceDelay"?: number;
+        /**
+          * Maximum number of results to fetch
+         */
+        "limit"?: number;
+        /**
+          * Emitted when a result is selected
+         */
+        "onResultSelected"?: (event: EdsGlobalSearchCustomEvent<{
+    id: string;
+    title: string;
+    url: string;
+    section: string;
+    tags: string[];
+    date: string | null;
+    source: string;
+    snippet: string;
+    score: number | null;
+  }>) => void;
+        /**
+          * Emitted when search is closed (for expandable mode)
+         */
+        "onSearchClosed"?: (event: EdsGlobalSearchCustomEvent<void>) => void;
+        /**
+          * Placeholder text for the input
+         */
+        "placeholder"?: string;
+    }
     /**
      * `EdsHeader` is a header component designed for the EBRAINS platform.
      * It provides a customizable and responsive navigation experience, tailored for both desktop and mobile views.
@@ -4276,6 +4557,12 @@ declare namespace LocalJSX {
          */
         "class"?: string;
     }
+    interface EdsIconDownload {
+        /**
+          * Additional CSS classes to be applied to the icon for styling.
+         */
+        "class"?: string;
+    }
     interface EdsIconDraft {
         /**
           * Additional CSS classes to be applied to the icon for styling.
@@ -4913,21 +5200,28 @@ declare namespace LocalJSX {
     }
     interface EdsMatomoNotice {
         /**
-          * The description displayed in the notice.
+          * The description displayed when the user has not yet opted in to analytics.
+          * @default "We use anonymous analytics..."
          */
         "description"?: string;
         /**
-          * When true, the notice is forced to show regardless of cookies/session.
+          * When true, the notice is forced to show regardless of cookies or session storage state. Useful for testing or forcing the consent UI.
+          * @default false
          */
         "forceShow"?: boolean;
         /**
-          * The title displayed in the notice.
+          * The title displayed in the notice accordion.
+          * @default "Analytics Consent"
          */
         "heading"?: string;
         /**
           * Event emitted when the rating is changed.
          */
         "onConsent"?: (event: EdsMatomoNoticeCustomEvent<'in' | 'out' | 'defer'>) => void;
+        /**
+          * The description displayed when the user has already opted in to analytics.
+          * @default "You are already part of our community..."
+         */
         "optOutMessage"?: string;
     }
     /**
@@ -5164,29 +5458,94 @@ declare namespace LocalJSX {
     }
     interface EdsSteps {
         /**
-          * Emits when a step is clicked, providing the step's index.
+          * Label for the **Back** button (linear mode).
+          * @default "Back"
+          * @attr back-label
+         */
+        "backLabel"?: string;
+        /**
+          * If `true`, disables **Next/Finish** and prevents advancing. Useful for gating progression until validation passes.
+          * @default false
+          * @attr disable-next
+         */
+        "disableNext"?: boolean | boolean[];
+        /**
+          * Label for the **Finish** button on the **last step** (linear mode).
+          * @default "Finish"
+          * @attr finish-label
+         */
+        "finishLabel"?: string;
+        /**
+          * Semantic heading tag used for each step title. Accepted values: `"h3" | "h4" | "h5"`.
+          * @default "h4"
+          * @attr heading-level
+         */
+        "headingLevel"?: 'h3' | 'h4' | 'h5';
+        /**
+          * Label for the **Next** button (linear mode).
+          * @default "Next"
+          * @attr next-label
+         */
+        "nextLabel"?: string;
+        /**
+          * Fired when the user clicks **Back** (before going back), with the **target** step index (current - 1).
+          * @event back
+         */
+        "onBack"?: (event: EdsStepsCustomEvent<number>) => void;
+        /**
+          * Fired when the user clicks **Finish** on the **last** step.
+          * @event finished
+         */
+        "onFinished"?: (event: EdsStepsCustomEvent<void>) => void;
+        /**
+          * Fired when the user clicks **Next** (before advancing), with the **target** step index (current + 1).
+          * @event next
+         */
+        "onNext"?: (event: EdsStepsCustomEvent<number>) => void;
+        /**
+          * Fired whenever the active step changes. Payload: the **current step index**.
+          * @event step
          */
         "onStep"?: (event: EdsStepsCustomEvent<number>) => void;
         /**
-          * JSON string containing an array of step objects. Example: '[   { "title": "Get Access...", "content": "To participate..." },   { "title": "Subscribe...", "content": "Technical Coordination..." },   { "title": "Confirm Your Subscription" } ]'
+          * Steps data as an **array** or **JSON string** of objects: `{ title: string; content?: string }`.  In static mode, all steps and their content render. In linear mode, only the active step renders its content.
+          * @default []
          */
         "steps"?: string | Step[];
         /**
-          * The type of stepper. Default is "static" (all steps visible, no buttons). If set to "linear", then only one step is visible at a time with navigation.
+          * Stepper mode. - `static`: all steps are visible (no navigation controls) - `linear`: one step at a time with Back/Next/Finish controls
+          * @default "static"
          */
         "type"?: 'static' | 'linear';
     }
     interface EdsStepsV2 {
         /**
-          * If true, apply a background class to the container.
+          * Label text for the "Back" button.
+         */
+        "backLabel"?: string;
+        /**
+          * If true, apply an inverse background to the container.
          */
         "bg"?: boolean;
+        /**
+          * If true, disables the "Next" button to block progression.
+         */
+        "disableNext"?: boolean;
+        /**
+          * Label text for the "Finish" button (last step in linear mode).
+         */
+        "finishLabel"?: string;
+        /**
+          * Heading level to use for each step title.
+          * @default "h4"
+         */
+        "headingLevel"?: 'h3' | 'h4' | 'h5';
         /**
           * Optional image source to display above the steps.
          */
         "imageSrc"?: string;
         /**
-          * Optional image width for the eds-img component.
+          * Optional image width for the `eds-img` component.
          */
         "imageWidth"?: number;
         /**
@@ -5194,15 +5553,39 @@ declare namespace LocalJSX {
          */
         "message"?: string;
         /**
-          * Emits when a step is clicked, providing the step's index.
+          * Label text for the "Next" button.
+         */
+        "nextLabel"?: string;
+        /**
+          * Emitted when the "Back" button is clicked.
+          * @event back
+          * @payload {number} The target step index.
+         */
+        "onBack"?: (event: EdsStepsV2CustomEvent<number>) => void;
+        /**
+          * Emitted when the "Finish" button is clicked (last step in linear mode).
+          * @event finished
+         */
+        "onFinished"?: (event: EdsStepsV2CustomEvent<void>) => void;
+        /**
+          * Emitted when the "Next" button is clicked.
+          * @event next
+          * @payload {number} The target step index.
+         */
+        "onNext"?: (event: EdsStepsV2CustomEvent<number>) => void;
+        /**
+          * Emitted when the active step changes.
+          * @event step
+          * @payload {number} The index of the new active step.
          */
         "onStep"?: (event: EdsStepsV2CustomEvent<number>) => void;
         /**
-          * JSON string or an array of step objects. Example: '[   { "title": "Step One", "content": "Details for step one" },   { "title": "Step Two", "content": "Details for step two" } ]'
+          * JSON string or an array of step objects. Each object should have a `title` and optional `content` property.
          */
         "steps"?: string | Step1[];
         /**
-          * The type of stepper. Default is "static" (all steps visible, no navigation buttons). Use "linear" if only one step should be visible at a time.
+          * The type of stepper: - `"static"`: shows all steps with their content. - `"linear"`: shows only one step at a time with navigation controls.
+          * @default "static"
          */
         "type"?: 'static' | 'linear';
     }
@@ -5242,7 +5625,7 @@ declare namespace LocalJSX {
          */
         "actionTemplate"?: (row: any) => VNode;
         /**
-          * Array of actions to render in each row. Each action should have:  - `name`: a unique key (e.g. "view", "delete")  - `label`: what shows in the button (or you could pass an icon name here)
+          * Array of actions to render in each row. Can be passed as a JSON string or as a `TableAction[]`.  Each action object may include:  - `name`       (string; required)  — unique action key, e.g. `"view"`, `"delete"`.  - `label`      (string; required)  — text shown on the button, or used as the tooltip/aria-label when icon-only.  - `type`       ("button" | "checkbox"; optional) — whether to render a standard button (default) or a checkbox.  - `icon`       (string; optional)  — name of the icon to display in icon-only mode.  - `field`      (string; optional)  — for checkboxes, the row field whose truthiness binds the checked state (defaults to `name`).  - `showLabel`  (boolean; optional) — if `true`, render the full `label` instead of an icon + tooltip.  When you pass JSON, make sure field names match exactly: ```html actions='[   { "name":"view",  "label":"View",  "icon":"eye" },   { "name":"edit",  "label":"Edit",  "icon":"pencil", "showLabel":true },   { "name":"del",   "label":"Delete","type":"checkbox", "field":"selected" } ]' ```
          */
         "actions"?: string | TableAction[];
         /**
@@ -5316,7 +5699,7 @@ declare namespace LocalJSX {
         /**
           * The visual style or intent of the tag.
          */
-        "intent"?: 'default' | 'strong' | 'accent' | 'weak' | 'inverse' | 'inverse-strong';
+        "intent"?: 'primary' | 'default' | 'strong' | 'accent' | 'weak' | 'inverse' | 'inverse-strong';
         /**
           * The label to be displayed inside the tag.
          */
@@ -5371,6 +5754,11 @@ declare namespace LocalJSX {
      * This component is ideal for embedding into any layout requiring user authentication.
      */
     interface EdsUser {
+        "dropdownLabel"?: string;
+        /**
+          * Visual intent of the trigger button
+         */
+        "intent"?: Intent;
         /**
           * The user object containing user information, or a JSON string to be parsed.
          */
@@ -5449,6 +5837,7 @@ declare namespace LocalJSX {
         "eds-frame": EdsFrame;
         "eds-fullscreen-menu": EdsFullscreenMenu;
         "eds-gauge": EdsGauge;
+        "eds-global-search": EdsGlobalSearch;
         "eds-header": EdsHeader;
         "eds-icon-arrow-diagonal": EdsIconArrowDiagonal;
         "eds-icon-arrow-right": EdsIconArrowRight;
@@ -5462,6 +5851,7 @@ declare namespace LocalJSX {
         "eds-icon-clone": EdsIconClone;
         "eds-icon-close": EdsIconClose;
         "eds-icon-copy": EdsIconCopy;
+        "eds-icon-download": EdsIconDownload;
         "eds-icon-draft": EdsIconDraft;
         "eds-icon-edit": EdsIconEdit;
         "eds-icon-eu": EdsIconEu;
@@ -5657,12 +6047,20 @@ declare module "@stencil/core" {
             /**
              * `EdsDropdown` is a versatile dropdown component that provides a list of items
              * that appear upon clicking the dropdown button. It supports various customization options,
-             * such as positioning, styling, and keyboard accessibility.
-             * Key features include:
-             * - Configurable dropdown position (left or right) and offset.
-             * - Customizable intent styles (e.g., primary, secondary).
-             * - Keyboard navigation with support for up and down arrow keys.
-             * - Option to use as a navigation menu or standard dropdown.
+             * such as positioning, styling, keyboard accessibility, and automatic closing behavior.
+             * ## Key Features:
+             * - Configurable dropdown position (left or right) and offset
+             * - Customizable intent styles (e.g., primary, secondary)
+             * - Keyboard navigation with support for up and down arrow keys
+             * - Automatic closing on clicks inside the dropdown panel
+             * - Flexible opt-in/opt-out mechanisms for closing behavior
+             * - Option to use as a navigation menu or standard dropdown
+             * ## Auto-Close Behavior:
+             * By default (`autoClose: true`), the dropdown closes when any element inside the panel is clicked.
+             * This includes links, buttons, custom elements, or any other clickable content.
+             * ## Data Attributes:
+             * - `data-dropdown-close`: Force close dropdown when clicked (works regardless of autoClose setting)
+             * - `data-dropdown-no-close`: Prevent dropdown from closing when this element or its children are clicked
              * This component is well-suited for use in menus, navigational elements, and other interactive UI patterns.
              */
             "eds-dropdown": LocalJSX.EdsDropdown & JSXBase.HTMLAttributes<HTMLEdsDropdownElement>;
@@ -5704,6 +6102,7 @@ declare module "@stencil/core" {
              */
             "eds-fullscreen-menu": LocalJSX.EdsFullscreenMenu & JSXBase.HTMLAttributes<HTMLEdsFullscreenMenuElement>;
             "eds-gauge": LocalJSX.EdsGauge & JSXBase.HTMLAttributes<HTMLEdsGaugeElement>;
+            "eds-global-search": LocalJSX.EdsGlobalSearch & JSXBase.HTMLAttributes<HTMLEdsGlobalSearchElement>;
             /**
              * `EdsHeader` is a header component designed for the EBRAINS platform.
              * It provides a customizable and responsive navigation experience, tailored for both desktop and mobile views.
@@ -5728,6 +6127,7 @@ declare module "@stencil/core" {
             "eds-icon-clone": LocalJSX.EdsIconClone & JSXBase.HTMLAttributes<HTMLEdsIconCloneElement>;
             "eds-icon-close": LocalJSX.EdsIconClose & JSXBase.HTMLAttributes<HTMLEdsIconCloseElement>;
             "eds-icon-copy": LocalJSX.EdsIconCopy & JSXBase.HTMLAttributes<HTMLEdsIconCopyElement>;
+            "eds-icon-download": LocalJSX.EdsIconDownload & JSXBase.HTMLAttributes<HTMLEdsIconDownloadElement>;
             "eds-icon-draft": LocalJSX.EdsIconDraft & JSXBase.HTMLAttributes<HTMLEdsIconDraftElement>;
             "eds-icon-edit": LocalJSX.EdsIconEdit & JSXBase.HTMLAttributes<HTMLEdsIconEditElement>;
             "eds-icon-eu": LocalJSX.EdsIconEu & JSXBase.HTMLAttributes<HTMLEdsIconEuElement>;