@swisspost/internet-header 1.15.24 → 1.16.0

package/dist/cjs/focus-trap.cjs.entry.js

@@ -5,15 +5,12 @@ Object.defineProperty(exports, '__esModule', { value: true });
 const index = require('./index-ecd8c9bb.js');
 
 /*!
-* 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;
@@ -26,13 +23,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;
@@ -46,10 +43,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;
 };
 
@@ -75,8 +72,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));
@@ -121,12 +118,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;
@@ -135,7 +132,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 {
@@ -159,7 +156,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
@@ -167,7 +164,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 {
@@ -344,6 +341,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)
@@ -357,7 +376,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
@@ -466,11 +488,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;
@@ -483,7 +501,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;
@@ -497,14 +515,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 {
@@ -526,22 +544,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
@@ -561,7 +579,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/cjs/index.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const postInternetHeader = require('./post-internet-header-7556c7d7.js');
+const postInternetHeader = require('./post-internet-header-72edf928.js');
 const postInternetBreadcrumbs = require('./post-internet-breadcrumbs-6c043d02.js');
 const postInternetFooter = require('./post-internet-footer-9e46e1fc.js');
 const postSkiplinks = require('./post-skiplinks-469cc355.js');
@@ -11,7 +11,7 @@ const postLanguageSwitch = require('./post-language-switch-0730827b.js');
 const postLogo = require('./post-logo-4c1f9387.js');
 const postMainNavigation = require('./post-main-navigation-bd2473fb.js');
 const postSearch = require('./post-search-1894421f.js');
-const postKlpLoginWidget = require('./post-klp-login-widget-0237ef6a.js');
+const postKlpLoginWidget = require('./post-klp-login-widget-75dfc12f.js');
 require('./index-ecd8c9bb.js');
 require('./index-fbcc9ff3.js');
 require('./language.service-15af0e29.js');

package/dist/cjs/{klp-widget.controller-d8938377.js → klp-widget.controller-7a8a5ddc.js}

@@ -14311,6 +14311,7 @@ const vertx = window.vertx || {};
       }
     }
 
+
     function audit(message) {
       const auditingEvent = JSON.stringify({
         adr: address,
@@ -15219,6 +15220,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',
@@ -15229,8 +15236,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/cjs/{post-internet-header-7556c7d7.js → post-internet-header-72edf928.js}

@@ -373,7 +373,7 @@ const setMainNavigationIds = (navMainEntities) => {
 };
 
 const name = "@swisspost/internet-header";
-const version = "1.15.24";
+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";
@@ -414,7 +414,7 @@ const scripts = {
 	generate: "stencil generate"
 };
 const dependencies = {
-	"@swisspost/design-system-styles": "workspace:9.6.0",
+	"@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",
@@ -453,7 +453,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",
@@ -584,6 +584,7 @@ const PostInternetHeader = class {
     /**
      * 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/cjs/{post-klp-login-widget-0237ef6a.js → post-klp-login-widget-75dfc12f.js}

@@ -31,7 +31,7 @@ const PostKlpLoginWidget = class {
         if (((_b = (_a = store.state.localizedConfig) === null || _a === void 0 ? void 0 : _a.header) === null || _b === void 0 ? void 0 : _b.showJobsLoginWidget) ||
             !((_d = (_c = store.state.localizedConfig) === null || _c === void 0 ? void 0 : _c.header) === null || _d === void 0 ? void 0 : _d.loginWidgetOptions))
             return;
-        const { initializeKLPLoginWidget } = await Promise.resolve().then(function () { return require('./klp-widget.controller-d8938377.js'); });
+        const { initializeKLPLoginWidget } = await Promise.resolve().then(function () { return require('./klp-widget.controller-7a8a5ddc.js'); });
         let _e = store.state.localizedConfig.header.loginWidgetOptions, { platform } = _e, widgetOptions = __rest(_e, ["platform"]);
         if (this.logoutUrl !== undefined) {
             platform = Object.assign(Object.assign({}, platform), { logoutURL: this.logoutUrl });
@@ -40,6 +40,36 @@ const PostKlpLoginWidget = class {
             platform = Object.assign(Object.assign({}, platform), { selfAdminOrigin: this.selfAdminOrigin });
         }
         initializeKLPLoginWidget('post-klp-login-widget', Object.assign(Object.assign(Object.assign({}, widgetOptions), { environment: store.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/cjs/post-klp-login-widget.cjs.entry.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const postKlpLoginWidget = require('./post-klp-login-widget-0237ef6a.js');
+const postKlpLoginWidget = require('./post-klp-login-widget-75dfc12f.js');
 require('./index-ecd8c9bb.js');
 require('./store-c3e61d64.js');
 require('./svg-sprite.component-aff81fb2.js');

package/dist/cjs/swisspost-internet-header.cjs.entry.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const postInternetHeader = require('./post-internet-header-7556c7d7.js');
+const postInternetHeader = require('./post-internet-header-72edf928.js');
 require('./index-ecd8c9bb.js');
 require('./index-fbcc9ff3.js');
 require('./language.service-15af0e29.js');

package/dist/collection/assets/js/klp-login-widget.js

@@ -456,6 +456,7 @@ const vertx = window.vertx || {};
       }
     }
 
+
     function audit(message) {
       const auditingEvent = JSON.stringify({
         adr: address,
@@ -1364,6 +1365,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',
@@ -1374,8 +1381,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/collection/components/post-internet-breadcrumbs/post-internet-breadcrumbs.js

@@ -245,8 +245,11 @@ export class PostInternetBreadcrumbs {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Add custom breadcrumb items to the end of the pre-configured list. Handy if your online service has it's own navigation structure."
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "overlays will no longer be provided in the next major release, therefore this method will no longer be needed."
+                        }],
+                    "text": "Add custom breadcrumb items to the end of the pre-configured list. Handy if your online service has its own navigation structure."
                 },
                 "attribute": "custom-items",
                 "reflect": false
@@ -262,7 +265,10 @@ export class PostInternetBreadcrumbs {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "Hide all buttons."
                 },
                 "attribute": "hide-buttons",

package/dist/collection/components/post-internet-header/post-internet-header.js

@@ -14,6 +14,7 @@ export class PostInternetHeader {
     /**
      * 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;
@@ -349,7 +350,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "this option will no longer be configurable with the new header in the next major release."
+                        }],
                     "text": "Sticky behaviour of the header."
                 },
                 "attribute": "stickyness",
@@ -384,7 +388,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "Toggle the meta navigation."
                 },
                 "attribute": "meta",
@@ -402,7 +409,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "use the new configuration API to show or hide the login. This option will be removed in the next major release."
+                        }],
                     "text": "Toggle the login link (when logged out) or the user widget (when logged in)."
                 },
                 "attribute": "login",
@@ -420,7 +430,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "use the new configuration API to show or hide the search. This option will be removed in the next major release."
+                        }],
                     "text": "Toggle the search button."
                 },
                 "attribute": "search",
@@ -438,7 +451,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "please implement the skiplinks component. This option will be removed in the next major release."
+                        }],
                     "text": "Toggle skiplinks. They help keyboard users to quickly jump to important sections of the page."
                 },
                 "attribute": "skiplinks",
@@ -456,8 +472,11 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "DEPRECATED!: Define a proxy URL for the config fetch request. Will be removed in the next major version"
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "this functionality will no longer be provided in the next major release and was deprecated previously."
+                        }],
+                    "text": "Define a proxy URL for the config fetch request."
                 },
                 "attribute": "config-proxy",
                 "reflect": false
@@ -503,7 +522,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "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."
                 },
                 "attribute": "language-switch-overrides",
@@ -526,7 +548,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "use the main navigation slot to add custom menu entries. This option will be removed in the next major release."
+                        }],
                     "text": "Customize the header config loaded from the post portal."
                 },
                 "attribute": "custom-config",
@@ -543,7 +568,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "The header uses this cookie to set the language. Disables automatic language detection."
                 },
                 "attribute": "language-cookie-key",
@@ -560,7 +588,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "The header uses this local storage key to set the language. Disables automatic language selection."
                 },
                 "attribute": "language-local-storage-key",
@@ -578,7 +609,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "use the new configuration API to specify the logout URL. This option will be removed in the next major release."
+                        }],
                     "text": "Overrides the logout-url provided by the portal config."
                 },
                 "attribute": "logout-url",
@@ -595,7 +629,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "use the new configuration API to specify these URLs. This option will be removed in the next major release."
+                        }],
                     "text": "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."
                 },
                 "attribute": "self-admin-origin",
@@ -612,7 +649,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "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."
                 },
                 "attribute": "active-route",
@@ -636,7 +676,10 @@ export class PostInternetHeader {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
+                    "tags": [{
+                            "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."
+                        }],
                     "text": "Online Services only: Add custom links to the special online service navigation entry"
                 },
                 "attribute": "os-flyout-overrides",
@@ -706,6 +749,9 @@ export class PostInternetHeader {
                     "tags": [{
                             "name": "returns",
                             "text": "string"
+                        }, {
+                            "name": "deprecated",
+                            "text": "use `document.documentElement.lang` instead"
                         }]
                 }
             }