@swisspost/internet-header 1.15.23 → 1.16.0

package/dist/collection/components/post-klp-login-widget/post-klp-login-widget.js

@@ -33,6 +33,36 @@ export class PostKlpLoginWidget {
             platform = Object.assign(Object.assign({}, platform), { selfAdminOrigin: this.selfAdminOrigin });
         }
         initializeKLPLoginWidget('post-klp-login-widget', Object.assign(Object.assign(Object.assign({}, widgetOptions), { environment: state.environment }), { platform }));
+        this.setupTracking();
+    }
+    setupTracking() {
+        var _a;
+        if (typeof window === 'undefined')
+            return;
+        window.dataLayer = window.dataLayer || [];
+        (_a = this.host.shadowRoot) === null || _a === void 0 ? void 0 : _a.addEventListener('click', this.handleClick);
+    }
+    handleClick(event) {
+        var _a, _b;
+        const settingsLink = event
+            .composedPath()
+            .find(el => el instanceof HTMLAnchorElement && el.matches('#authenticated-menu a[href*="/settings"]'));
+        if (!settingsLink)
+            return;
+        const linkText = (_b = (_a = settingsLink
+            .querySelector('.klp-widget-notification-link-text')) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim();
+        window.dataLayer.push({
+            event: 'select_menu',
+            type: 'authenticated_menu',
+            label: 'settings',
+            text: linkText,
+            link_url: settingsLink.href,
+            additional_info: '',
+        });
+    }
+    disconnectedCallback() {
+        var _a;
+        (_a = this.host.shadowRoot) === null || _a === void 0 ? void 0 : _a.removeEventListener('click', this.handleClick);
     }
     /**
      * Sets the focus on the login button

package/dist/components/focus-trap2.js

@@ -1,15 +1,12 @@
 import { proxyCustomElement, HTMLElement, h, Host } from '@stencil/core/internal/client';
 
 /*!
-* tabbable 6.2.0
+* tabbable 6.4.0
 * @license MIT, https://github.com/focus-trap/tabbable/blob/master/LICENSE
 */
 // NOTE: separate `:not()` selectors has broader browser support than the newer
 //  `:not([inert], [inert] *)` (Feb 2023)
-// CAREFUL: JSDom does not support `:not([inert] *)` as a selector; using it causes
-//  the entire query to fail, resulting in no nodes found, which will break a lot
-//  of things... so we have to rely on JS to identify nodes inside an inert container
-var candidateSelectors = ['input:not([inert])', 'select:not([inert])', 'textarea:not([inert])', 'a[href]:not([inert])', 'button:not([inert])', '[tabindex]:not(slot):not([inert])', 'audio[controls]:not([inert])', 'video[controls]:not([inert])', '[contenteditable]:not([contenteditable="false"]):not([inert])', 'details>summary:first-of-type:not([inert])', 'details:not([inert])'];
+var candidateSelectors = ['input:not([inert]):not([inert] *)', 'select:not([inert]):not([inert] *)', 'textarea:not([inert]):not([inert] *)', 'a[href]:not([inert]):not([inert] *)', 'button:not([inert]):not([inert] *)', '[tabindex]:not(slot):not([inert]):not([inert] *)', 'audio[controls]:not([inert]):not([inert] *)', 'video[controls]:not([inert]):not([inert] *)', '[contenteditable]:not([contenteditable="false"]):not([inert]):not([inert] *)', 'details>summary:first-of-type:not([inert]):not([inert] *)', 'details:not([inert]):not([inert] *)'];
 var candidateSelector = /* #__PURE__ */candidateSelectors.join(',');
 var NoElement = typeof Element === 'undefined';
 var matches = NoElement ? function () {} : Element.prototype.matches || Element.prototype.msMatchesSelector || Element.prototype.webkitMatchesSelector;
@@ -22,13 +19,13 @@ var getRootNode = !NoElement && Element.prototype.getRootNode ? function (elemen
 
 /**
  * Determines if a node is inert or in an inert ancestor.
- * @param {Element} [node]
+ * @param {Node} [node]
  * @param {boolean} [lookUp] If true and `node` is not inert, looks up at ancestors to
  *  see if any of them are inert. If false, only `node` itself is considered.
  * @returns {boolean} True if inert itself or by way of being in an inert ancestor.
  *  False if `node` is falsy.
  */
-var isInert = function isInert(node, lookUp) {
+var _isInert = function isInert(node, lookUp) {
   var _node$getAttribute;
   if (lookUp === void 0) {
     lookUp = true;
@@ -42,10 +39,10 @@ var isInert = function isInert(node, lookUp) {
   // NOTE: this could also be handled with `node.matches('[inert], :is([inert] *)')`
   //  if it weren't for `matches()` not being a function on shadow roots; the following
   //  code works for any kind of node
-  // CAREFUL: JSDom does not appear to support certain selectors like `:not([inert] *)`
-  //  so it likely would not support `:is([inert] *)` either...
-  var result = inert || lookUp && node && isInert(node.parentNode); // recursive
-
+  var result = inert || lookUp && node && (
+  // closest does not exist on shadow roots, so we fall back to a manual
+  // lookup upward, in case it is not defined.
+  typeof node.closest === 'function' ? node.closest('[inert]') : _isInert(node.parentNode));
   return result;
 };
 
@@ -71,8 +68,8 @@ var isContentEditable = function isContentEditable(node) {
  */
 var getCandidates = function getCandidates(el, includeContainer, filter) {
   // even if `includeContainer=false`, we still have to check it for inertness because
-  //  if it's inert, all its children are inert
-  if (isInert(el)) {
+  //  if it's inert (either by itself or via its parent), then all its children are inert
+  if (_isInert(el)) {
     return [];
   }
   var candidates = Array.prototype.slice.apply(el.querySelectorAll(candidateSelector));
@@ -117,12 +114,12 @@ var getCandidates = function getCandidates(el, includeContainer, filter) {
  * @param {IterativeOptions} options
  * @returns {Array.<Element|CandidateScope>}
  */
-var getCandidatesIteratively = function getCandidatesIteratively(elements, includeContainer, options) {
+var _getCandidatesIteratively = function getCandidatesIteratively(elements, includeContainer, options) {
   var candidates = [];
   var elementsToCheck = Array.from(elements);
   while (elementsToCheck.length) {
     var element = elementsToCheck.shift();
-    if (isInert(element, false)) {
+    if (_isInert(element, false)) {
       // no need to look up since we're drilling down
       // anything inside this container will also be inert
       continue;
@@ -131,7 +128,7 @@ var getCandidatesIteratively = function getCandidatesIteratively(elements, inclu
       // add shadow dom slot scope (slot itself cannot be focusable)
       var assigned = element.assignedElements();
       var content = assigned.length ? assigned : element.children;
-      var nestedCandidates = getCandidatesIteratively(content, true, options);
+      var nestedCandidates = _getCandidatesIteratively(content, true, options);
       if (options.flatten) {
         candidates.push.apply(candidates, nestedCandidates);
       } else {
@@ -155,7 +152,7 @@ var getCandidatesIteratively = function getCandidatesIteratively(elements, inclu
       // no inert look up because we're already drilling down and checking for inertness
       //  on the way down, so all containers to this root node should have already been
       //  vetted as non-inert
-      var validShadowRoot = !isInert(shadowRoot, false) && (!options.shadowRootFilter || options.shadowRootFilter(element));
+      var validShadowRoot = !_isInert(shadowRoot, false) && (!options.shadowRootFilter || options.shadowRootFilter(element));
       if (shadowRoot && validShadowRoot) {
         // add shadow dom scope IIF a shadow root node was given; otherwise, an undisclosed
         //  shadow exists, so look at light dom children as fallback BUT create a scope for any
@@ -163,7 +160,7 @@ var getCandidatesIteratively = function getCandidatesIteratively(elements, inclu
         //  children of the web component element (which has the shadow), in the light dom, but
         //  slotted somewhere _inside_ the undisclosed shadow) -- the scope is created below,
         //  _after_ we return from this recursive call
-        var _nestedCandidates = getCandidatesIteratively(shadowRoot === true ? element.children : shadowRoot.children, true, options);
+        var _nestedCandidates = _getCandidatesIteratively(shadowRoot === true ? element.children : shadowRoot.children, true, options);
         if (options.flatten) {
           candidates.push.apply(candidates, _nestedCandidates);
         } else {
@@ -340,6 +337,28 @@ var isZeroArea = function isZeroArea(node) {
 var isHidden = function isHidden(node, _ref) {
   var displayCheck = _ref.displayCheck,
     getShadowRoot = _ref.getShadowRoot;
+  if (displayCheck === 'full-native') {
+    if ('checkVisibility' in node) {
+      // Chrome >= 105, Edge >= 105, Firefox >= 106, Safari >= 17.4
+      // @see https://developer.mozilla.org/en-US/docs/Web/API/Element/checkVisibility#browser_compatibility
+      var visible = node.checkVisibility({
+        // Checking opacity might be desirable for some use cases, but natively,
+        // opacity zero elements _are_ focusable and tabbable.
+        checkOpacity: false,
+        opacityProperty: false,
+        contentVisibilityAuto: true,
+        visibilityProperty: true,
+        // This is an alias for `visibilityProperty`. Contemporary browsers
+        // support both. However, this alias has wider browser support (Chrome
+        // >= 105 and Firefox >= 106, vs. Chrome >= 121 and Firefox >= 122), so
+        // we include it anyway.
+        checkVisibilityCSS: true
+      });
+      return !visible;
+    }
+    // Fall through to manual visibility checks
+  }
+
   // NOTE: visibility will be `undefined` if node is detached from the document
   //  (see notes about this further down), which means we will consider it visible
   //  (this is legacy behavior from a very long way back)
@@ -353,7 +372,10 @@ var isHidden = function isHidden(node, _ref) {
   if (matches.call(nodeUnderDetails, 'details:not([open]) *')) {
     return true;
   }
-  if (!displayCheck || displayCheck === 'full' || displayCheck === 'legacy-full') {
+  if (!displayCheck || displayCheck === 'full' ||
+  // full-native can run this branch when it falls through in case
+  // Element#checkVisibility is unsupported
+  displayCheck === 'full-native' || displayCheck === 'legacy-full') {
     if (typeof getShadowRoot === 'function') {
       // figure out if we should consider the node to be in an undisclosed shadow and use the
       //  'non-zero-area' fallback
@@ -462,11 +484,7 @@ var isDisabledFromFieldset = function isDisabledFromFieldset(node) {
   return false;
 };
 var isNodeMatchingSelectorFocusable = function isNodeMatchingSelectorFocusable(options, node) {
-  if (node.disabled ||
-  // we must do an inert look up to filter out any elements inside an inert ancestor
-  //  because we're limited in the type of selectors we can use in JSDom (see related
-  //  note related to `candidateSelectors`)
-  isInert(node) || isHiddenInput(node) || isHidden(node, options) ||
+  if (node.disabled || isHiddenInput(node) || isHidden(node, options) ||
   // For a details element with a summary, the summary element gets the focus
   isDetailsWithSummary(node) || isDisabledFromFieldset(node)) {
     return false;
@@ -479,7 +497,7 @@ var isNodeMatchingSelectorTabbable = function isNodeMatchingSelectorTabbable(opt
   }
   return true;
 };
-var isValidShadowRootTabbable = function isValidShadowRootTabbable(shadowHostNode) {
+var isShadowRootTabbable = function isShadowRootTabbable(shadowHostNode) {
   var tabIndex = parseInt(shadowHostNode.getAttribute('tabindex'), 10);
   if (isNaN(tabIndex) || tabIndex >= 0) {
     return true;
@@ -493,14 +511,14 @@ var isValidShadowRootTabbable = function isValidShadowRootTabbable(shadowHostNod
  * @param {Array.<Element|CandidateScope>} candidates
  * @returns Element[]
  */
-var sortByOrder = function sortByOrder(candidates) {
+var _sortByOrder = function sortByOrder(candidates) {
   var regularTabbables = [];
   var orderedTabbables = [];
   candidates.forEach(function (item, i) {
     var isScope = !!item.scopeParent;
     var element = isScope ? item.scopeParent : item;
     var candidateTabindex = getSortOrderTabIndex(element, isScope);
-    var elements = isScope ? sortByOrder(item.candidates) : element;
+    var elements = isScope ? _sortByOrder(item.candidates) : element;
     if (candidateTabindex === 0) {
       isScope ? regularTabbables.push.apply(regularTabbables, elements) : regularTabbables.push(element);
     } else {
@@ -522,22 +540,22 @@ var tabbable = function tabbable(container, options) {
   options = options || {};
   var candidates;
   if (options.getShadowRoot) {
-    candidates = getCandidatesIteratively([container], options.includeContainer, {
+    candidates = _getCandidatesIteratively([container], options.includeContainer, {
       filter: isNodeMatchingSelectorTabbable.bind(null, options),
       flatten: false,
       getShadowRoot: options.getShadowRoot,
-      shadowRootFilter: isValidShadowRootTabbable
+      shadowRootFilter: isShadowRootTabbable
     });
   } else {
     candidates = getCandidates(container, options.includeContainer, isNodeMatchingSelectorTabbable.bind(null, options));
   }
-  return sortByOrder(candidates);
+  return _sortByOrder(candidates);
 };
 var focusable = function focusable(container, options) {
   options = options || {};
   var candidates;
   if (options.getShadowRoot) {
-    candidates = getCandidatesIteratively([container], options.includeContainer, {
+    candidates = _getCandidatesIteratively([container], options.includeContainer, {
       filter: isNodeMatchingSelectorFocusable.bind(null, options),
       flatten: true,
       getShadowRoot: options.getShadowRoot
@@ -557,7 +575,7 @@ var isTabbable = function isTabbable(node, options) {
   }
   return isNodeMatchingSelectorTabbable(options, node);
 };
-var focusableCandidateSelector = /* #__PURE__ */candidateSelectors.concat('iframe').join(',');
+var focusableCandidateSelector = /* #__PURE__ */candidateSelectors.concat('iframe:not([inert]):not([inert] *)').join(',');
 var isFocusable = function isFocusable(node, options) {
   options = options || {};
   if (!node) {

package/dist/components/klp-widget.controller.js

@@ -14309,6 +14309,7 @@ const vertx = window.vertx || {};
       }
     }
 
+
     function audit(message) {
       const auditingEvent = JSON.stringify({
         adr: address,
@@ -15217,6 +15218,12 @@ const vertx = window.vertx || {};
       if (!address) {
         if (trySubscription()) {
           log('Subscribing to get an address');
+          if (globalThis.console && globalThis.console.info) {
+            console.info('[klp-login-widget] subscribe attempt', {
+              hasNctrl: document.cookie.includes(controlCookieName + '='),
+              userAgent: navigator.userAgent,
+            });
+          }
           const startTime = new Date().getTime();
           fetch(platformEndPoints.subscribe, {
             method: 'GET',
@@ -15227,8 +15234,25 @@ const vertx = window.vertx || {};
             .then(message => handleMessage(message))
             .catch(error => {
               log('Failed to subscribe: ' + error.message);
-              logout();
-              renderWidget();
+              if (globalThis.console && globalThis.console.warn) {
+                console.warn('[klp-login-widget] subscribe failed', {
+                  errorType: error.constructor ? error.constructor.name : typeof error,
+                  errorMessage: error.message,
+                  isTypeError: error instanceof TypeError,
+                  hasNctrl: document.cookie.includes(controlCookieName + '='),
+                  userAgent: navigator.userAgent,
+                  url: globalThis.location.href,
+                });
+              }
+              if (error instanceof TypeError) {
+                // Fetch cancelled by browser navigation, not an auth failure.
+                // Do not call logout(): this would delete NCTRL and prevent recovery.
+                log('Subscribe cancelled by navigation: preserving NCTRL, skipping logout.');
+                renderWidget();
+              } else {
+                logout();
+                renderWidget();
+              }
             });
           logPerformanceMetric('subscribe()', new Date().getTime() - startTime);
         } else {

package/dist/components/post-klp-login-widget2.js

@@ -40,6 +40,36 @@ const PostKlpLoginWidget = /*@__PURE__*/ proxyCustomElement(class PostKlpLoginWi
             platform = Object.assign(Object.assign({}, platform), { selfAdminOrigin: this.selfAdminOrigin });
         }
         initializeKLPLoginWidget('post-klp-login-widget', Object.assign(Object.assign(Object.assign({}, widgetOptions), { environment: state.environment }), { platform }));
+        this.setupTracking();
+    }
+    setupTracking() {
+        var _a;
+        if (typeof window === 'undefined')
+            return;
+        window.dataLayer = window.dataLayer || [];
+        (_a = this.host.shadowRoot) === null || _a === void 0 ? void 0 : _a.addEventListener('click', this.handleClick);
+    }
+    handleClick(event) {
+        var _a, _b;
+        const settingsLink = event
+            .composedPath()
+            .find(el => el instanceof HTMLAnchorElement && el.matches('#authenticated-menu a[href*="/settings"]'));
+        if (!settingsLink)
+            return;
+        const linkText = (_b = (_a = settingsLink
+            .querySelector('.klp-widget-notification-link-text')) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim();
+        window.dataLayer.push({
+            event: 'select_menu',
+            type: 'authenticated_menu',
+            label: 'settings',
+            text: linkText,
+            link_url: settingsLink.href,
+            additional_info: '',
+        });
+    }
+    disconnectedCallback() {
+        var _a;
+        (_a = this.host.shadowRoot) === null || _a === void 0 ? void 0 : _a.removeEventListener('click', this.handleClick);
     }
     /**
      * Sets the focus on the login button

package/dist/components/swisspost-internet-header.js

@@ -378,7 +378,7 @@ const setMainNavigationIds = (navMainEntities) => {
 };
 
 const name = "@swisspost/internet-header";
-const version = "1.15.23";
+const version = "1.16.0";
 const description = "The header for client facing applications.";
 const author = "Swiss Post <design-system@post.ch>";
 const license = "Apache-2.0";
@@ -419,7 +419,7 @@ const scripts = {
 	generate: "stencil generate"
 };
 const dependencies = {
-	"@swisspost/design-system-styles": "workspace:9.5.1",
+	"@swisspost/design-system-styles": "workspace:9.7.0",
 	"body-scroll-lock": "4.0.0-beta.0",
 	"iframe-resizer": "4.4.5",
 	jquery: "3.7.1",
@@ -458,7 +458,7 @@ const devDependencies = {
 	sass: "1.77.8",
 	"start-server-and-test": "2.0.5",
 	"ts-jest": "29.2.4",
-	typescript: "5.5.4"
+	typescript: "5.9.3"
 };
 const keywords = [
 	"components",
@@ -589,6 +589,7 @@ const PostInternetHeader = /*@__PURE__*/ proxyCustomElement(class PostInternetHe
     /**
      * Get the currently set language as a two letter string ("de", "fr" "it" or "en")
      * @returns string
+     * @deprecated use `document.documentElement.lang` instead
      */
     async getCurrentLanguage() {
         var _a;

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-11-17T10:12:05",
+  "timestamp": "2026-02-23T18:09:42",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.19.2",
@@ -749,8 +749,14 @@
           "mutable": false,
           "attr": "custom-items",
           "reflectToAttr": false,
-          "docs": "Add custom breadcrumb items to the end of the pre-configured list. Handy if your online service has it's own navigation structure.",
-          "docsTags": [],
+          "docs": "Add custom breadcrumb items to the end of the pre-configured list. Handy if your online service has its own navigation structure.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "overlays will no longer be provided in the next major release, therefore this method will no longer be needed."
+            }
+          ],
+          "deprecation": "overlays will no longer be provided in the next major release, therefore this method will no longer be needed.",
           "values": [
             {
               "type": "IBreadcrumbItem[]"
@@ -777,8 +783,14 @@
           "attr": "hide-buttons",
           "reflectToAttr": false,
           "docs": "Hide all buttons.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "Help and Contact buttons will no longer be provided in the next major release, therefore this prop will no longer be needed."
+            }
+          ],
           "default": "false",
+          "deprecation": "Help and Contact buttons will no longer be provided in the next major release, therefore this prop will no longer be needed.",
           "values": [
             {
               "type": "boolean"
@@ -889,8 +901,14 @@
           "attr": "active-route",
           "reflectToAttr": false,
           "docs": "Set the currently activated route. If there is a link matching this URL in the header, it will be highlighted.\nWill also highlight partly matching URLs. When set to auto, will use current location.href for comparison.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "boolean values will no longer be accepted in the next major release. Use \"none\" for false and \"auto\" for true. All other values remain unchanged."
+            }
+          ],
           "default": "'auto'",
+          "deprecation": "boolean values will no longer be accepted in the next major release. Use \"none\" for false and \"auto\" for true. All other values remain unchanged.",
           "values": [
             {
               "type": "boolean"
@@ -916,8 +934,14 @@
           "mutable": false,
           "attr": "config-proxy",
           "reflectToAttr": false,
-          "docs": "DEPRECATED!: Define a proxy URL for the config fetch request. Will be removed in the next major version",
-          "docsTags": [],
+          "docs": "Define a proxy URL for the config fetch request.",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "this functionality will no longer be provided in the next major release and was deprecated previously."
+            }
+          ],
+          "deprecation": "this functionality will no longer be provided in the next major release and was deprecated previously.",
           "values": [
             {
               "type": "string"
@@ -947,7 +971,13 @@
           "attr": "custom-config",
           "reflectToAttr": false,
           "docs": "Customize the header config loaded from the post portal.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the main navigation slot to add custom menu entries. This option will be removed in the next major release."
+            }
+          ],
+          "deprecation": "use the main navigation slot to add custom menu entries. This option will be removed in the next major release.",
           "values": [
             {
               "type": "ICustomConfig"
@@ -1089,7 +1119,13 @@
           "attr": "language-cookie-key",
           "reflectToAttr": false,
           "docs": "The header uses this cookie to set the language. Disables automatic language detection.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "this will no longer be supported in the next major release due to low usage, in favor of a project-specific solution."
+            }
+          ],
+          "deprecation": "this will no longer be supported in the next major release due to low usage, in favor of a project-specific solution.",
           "values": [
             {
               "type": "string"
@@ -1113,8 +1149,14 @@
           "attr": "language-local-storage-key",
           "reflectToAttr": false,
           "docs": "The header uses this local storage key to set the language. Disables automatic language selection.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "this will no longer be supported in the next major release due to low usage, in favor of a project-specific solution."
+            }
+          ],
           "default": "'swisspost-internet-header-language'",
+          "deprecation": "this will no longer be supported in the next major release due to low usage, in favor of a project-specific solution.",
           "values": [
             {
               "type": "string"
@@ -1144,7 +1186,13 @@
           "attr": "language-switch-overrides",
           "reflectToAttr": false,
           "docs": "Override the language switch links with custom URLs. Helpful when your application contains sub-pages, and you\nwould like to stay on subpages when the user changes language.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the language menu slot to override the language switch and specify custom URLs. This option will be removed in the next major release."
+            }
+          ],
+          "deprecation": "use the language menu slot to override the language switch and specify custom URLs. This option will be removed in the next major release.",
           "values": [
             {
               "type": "IAvailableLanguage[]"
@@ -1171,8 +1219,14 @@
           "attr": "login",
           "reflectToAttr": false,
           "docs": "Toggle the login link (when logged out) or the user widget (when logged in).",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the new configuration API to show or hide the login. This option will be removed in the next major release."
+            }
+          ],
           "default": "true",
+          "deprecation": "use the new configuration API to show or hide the login. This option will be removed in the next major release.",
           "values": [
             {
               "type": "boolean"
@@ -1193,7 +1247,13 @@
           "attr": "logout-url",
           "reflectToAttr": false,
           "docs": "Overrides the logout-url provided by the portal config.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the new configuration API to specify the logout URL. This option will be removed in the next major release."
+            }
+          ],
+          "deprecation": "use the new configuration API to specify the logout URL. This option will be removed in the next major release.",
           "values": [
             {
               "type": "string"
@@ -1217,8 +1277,14 @@
           "attr": "meta",
           "reflectToAttr": false,
           "docs": "Toggle the meta navigation.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the new configuration API to show or hide the meta navigation links. This option will be removed in the next major release."
+            }
+          ],
           "default": "true",
+          "deprecation": "use the new configuration API to show or hide the meta navigation links. This option will be removed in the next major release.",
           "values": [
             {
               "type": "boolean"
@@ -1245,7 +1311,12 @@
           "attr": "os-flyout-overrides",
           "reflectToAttr": false,
           "docs": "Online Services only: Add custom links to the special online service navigation entry",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecatedthe",
+              "text": "new header will no longer include this flyout in the next major release. Use the main navigation slot to add application-specific menu items."
+            }
+          ],
           "values": [
             {
               "type": "NavMainEntity"
@@ -1293,8 +1364,14 @@
           "attr": "search",
           "reflectToAttr": false,
           "docs": "Toggle the search button.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the new configuration API to show or hide the search. This option will be removed in the next major release."
+            }
+          ],
           "default": "true",
+          "deprecation": "use the new configuration API to show or hide the search. This option will be removed in the next major release.",
           "values": [
             {
               "type": "boolean"
@@ -1315,7 +1392,13 @@
           "attr": "self-admin-origin",
           "reflectToAttr": false,
           "docs": "Overrides the selfadmin url in case it needs to differ from the logoutUrl, which is the url that is used by default.\nThe selfadmin url is used in the KLP login widget to set the user menu links.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use the new configuration API to specify these URLs. This option will be removed in the next major release."
+            }
+          ],
+          "deprecation": "use the new configuration API to specify these URLs. This option will be removed in the next major release.",
           "values": [
             {
               "type": "string"
@@ -1339,8 +1422,14 @@
           "attr": "skiplinks",
           "reflectToAttr": false,
           "docs": "Toggle skiplinks. They help keyboard users to quickly jump to important sections of the page.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "please implement the skiplinks component. This option will be removed in the next major release."
+            }
+          ],
           "default": "true",
+          "deprecation": "please implement the skiplinks component. This option will be removed in the next major release.",
           "values": [
             {
               "type": "boolean"
@@ -1367,8 +1456,14 @@
           "attr": "stickyness",
           "reflectToAttr": false,
           "docs": "Sticky behaviour of the header.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "this option will no longer be configurable with the new header in the next major release."
+            }
+          ],
           "default": "'minimal'",
+          "deprecation": "this option will no longer be configurable with the new header in the next major release.",
           "values": [
             {
               "value": "full",
@@ -1416,8 +1511,13 @@
             {
               "name": "returns",
               "text": "string"
+            },
+            {
+              "name": "deprecated",
+              "text": "use `document.documentElement.lang` instead"
             }
-          ]
+          ],
+          "deprecation": "use `document.documentElement.lang` instead"
         }
       ],
       "events": [