@swisspost/design-system-components 9.0.0-next.7 → 9.0.0-next.9

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2024-12-04T07:44:23",
+  "timestamp": "2024-12-16T16:45:20",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.19.2",
@@ -198,6 +198,18 @@
       "readme": "# post-accordion-item\n\n\n",
       "docs": "",
       "docsTags": [
+        {
+          "name": "part",
+          "text": "button - The pseudo-element, used to override styles on the components internal header `button` element."
+        },
+        {
+          "name": "part",
+          "text": "body - The pseudo-element, used to override styles on the components internal `body` element."
+        },
+        {
+          "name": "slot",
+          "text": "logo - Slot for the placing a logo before the header."
+        },
         {
           "name": "slot",
           "text": "header - Slot for placing custom content within the accordion item's header."
@@ -339,23 +351,42 @@
         {
           "name": "header",
           "docs": "Slot for placing custom content within the accordion item's header."
+        },
+        {
+          "name": "logo",
+          "docs": "Slot for the placing a logo before the header."
         }
       ],
       "parts": [
         {
           "name": "accordion-item",
           "docs": ""
+        },
+        {
+          "name": "body",
+          "docs": "The pseudo-element, used to override styles on the components internal `body` element."
+        },
+        {
+          "name": "button",
+          "docs": "The pseudo-element, used to override styles on the components internal header `button` element."
         }
       ],
-      "dependents": [],
+      "dependents": [
+        "post-footer"
+      ],
       "dependencies": [
         "post-collapsible-trigger",
+        "post-icon",
         "post-collapsible"
       ],
       "dependencyGraph": {
         "post-accordion-item": [
           "post-collapsible-trigger",
+          "post-icon",
           "post-collapsible"
+        ],
+        "post-footer": [
+          "post-accordion-item"
         ]
       }
     },
@@ -473,6 +504,53 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/post-back-to-top/post-back-to-top.tsx",
+      "encapsulation": "shadow",
+      "tag": "post-back-to-top",
+      "readme": "# post-back-to-top\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "label",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "The label of the back-to-top button, intended solely for accessibility purposes.\nThis label is always hidden from view.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "post-icon"
+      ],
+      "dependencyGraph": {
+        "post-back-to-top": [
+          "post-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/post-banner/post-banner.tsx",
       "encapsulation": "shadow",
@@ -672,6 +750,89 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/post-breadcrumb/post-breadcrumb.tsx",
+      "encapsulation": "shadow",
+      "tag": "post-breadcrumb",
+      "readme": "# post-breadcrumbs-new\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "homeText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "home-text",
+          "reflectToAttr": false,
+          "docs": "The text label for the home breadcrumb item.",
+          "docsTags": [],
+          "default": "'Home'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "homeUrl",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "home-url",
+          "reflectToAttr": false,
+          "docs": "The URL for the home breadcrumb item.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "post-icon",
+        "post-menu-trigger",
+        "post-menu",
+        "post-menu-item",
+        "post-breadcrumb-item"
+      ],
+      "dependencyGraph": {
+        "post-breadcrumb": [
+          "post-icon",
+          "post-menu-trigger",
+          "post-menu",
+          "post-menu-item",
+          "post-breadcrumb-item"
+        ],
+        "post-menu": [
+          "post-popovercontainer"
+        ],
+        "post-breadcrumb-item": [
+          "post-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/post-breadcrumb-item/post-breadcrumb-item.tsx",
       "encapsulation": "shadow",
@@ -727,13 +888,18 @@
         }
       ],
       "parts": [],
-      "dependents": [],
+      "dependents": [
+        "post-breadcrumb"
+      ],
       "dependencies": [
         "post-icon"
       ],
       "dependencyGraph": {
         "post-breadcrumb-item": [
           "post-icon"
+        ],
+        "post-breadcrumb": [
+          "post-breadcrumb-item"
         ]
       }
     },
@@ -1278,6 +1444,116 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/post-footer/post-footer.tsx",
+      "encapsulation": "shadow",
+      "tag": "post-footer",
+      "readme": "# post-footer\n\n\n",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "grid-{1|2|3|4}-title - Slot for the accordion headers (mobile)."
+        },
+        {
+          "name": "slot",
+          "text": "grid-{1|2|3|4} - Slot for the accordion bodies (mobile) and the grid cells (tablet, desktop)."
+        },
+        {
+          "name": "slot",
+          "text": "socialmedia - Slot for the social media links."
+        },
+        {
+          "name": "slot",
+          "text": "app - Slot for the app links."
+        },
+        {
+          "name": "slot",
+          "text": "businesssectors - Slot for the business sectors links."
+        },
+        {
+          "name": "slot",
+          "text": "meta - Slot for the meta links."
+        },
+        {
+          "name": "slot",
+          "text": "copyright - Slot for the copyright text."
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "label",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "The label to add to the footer (visually hidden).",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "app",
+          "docs": "Slot for the app links."
+        },
+        {
+          "name": "businesssectors",
+          "docs": "Slot for the business sectors links."
+        },
+        {
+          "name": "copyright",
+          "docs": "Slot for the copyright text."
+        },
+        {
+          "name": "grid-{1|2|3|4}",
+          "docs": "Slot for the accordion bodies (mobile) and the grid cells (tablet, desktop)."
+        },
+        {
+          "name": "grid-{1|2|3|4}-title",
+          "docs": "Slot for the accordion headers (mobile)."
+        },
+        {
+          "name": "meta",
+          "docs": "Slot for the meta links."
+        },
+        {
+          "name": "socialmedia",
+          "docs": "Slot for the social media links."
+        }
+      ],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "post-accordion-item"
+      ],
+      "dependencyGraph": {
+        "post-footer": [
+          "post-accordion-item"
+        ],
+        "post-accordion-item": [
+          "post-collapsible-trigger",
+          "post-icon",
+          "post-collapsible"
+        ]
+      }
+    },
     {
       "filePath": "src/components/post-header/post-header.tsx",
       "encapsulation": "shadow",
@@ -1287,15 +1563,36 @@
       "docsTags": [],
       "usage": {},
       "props": [],
-      "methods": [],
-      "events": [],
-      "listeners": [
+      "methods": [
         {
-          "event": "postMainNavigationClosed",
-          "capture": false,
-          "passive": false
+          "name": "toggleMobileMenu",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              },
+              "HTMLPostTogglebuttonElement": {
+                "location": "global",
+                "id": "global::HTMLPostTogglebuttonElement"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "toggleMobileMenu() => Promise<void>",
+          "parameters": [],
+          "docs": "Toggles the mobile navigation.",
+          "docsTags": []
         }
       ],
+      "events": [],
+      "listeners": [],
       "styles": [],
       "slots": [],
       "parts": [],
@@ -1504,18 +1801,31 @@
       "slots": [],
       "parts": [],
       "dependents": [
+        "post-accordion-item",
+        "post-back-to-top",
         "post-banner",
+        "post-breadcrumb",
         "post-breadcrumb-item",
         "post-card-control",
         "post-closebutton",
+        "post-language-switch",
         "post-rating",
         "post-tag"
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "post-accordion-item": [
+          "post-icon"
+        ],
+        "post-back-to-top": [
+          "post-icon"
+        ],
         "post-banner": [
           "post-icon"
         ],
+        "post-breadcrumb": [
+          "post-icon"
+        ],
         "post-breadcrumb-item": [
           "post-icon"
         ],
@@ -1525,6 +1835,9 @@
         "post-closebutton": [
           "post-icon"
         ],
+        "post-language-switch": [
+          "post-icon"
+        ],
         "post-rating": [
           "post-icon"
         ],
@@ -1630,6 +1943,38 @@
           ],
           "optional": false,
           "required": false
+        },
+        {
+          "name": "variant",
+          "type": "\"dropdown\" | \"list\"",
+          "complexType": {
+            "original": "SwitchVariant | null",
+            "resolved": "\"dropdown\" | \"list\"",
+            "references": {
+              "SwitchVariant": {
+                "location": "import",
+                "path": "../post-language-switch/switch-variants",
+                "id": "src/components/post-language-switch/switch-variants.ts::SwitchVariant"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "variant",
+          "reflectToAttr": false,
+          "docs": "The variant of the post-language-switch parent (dynamically set by the parent)",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "dropdown",
+              "type": "string"
+            },
+            {
+              "value": "list",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
         }
       ],
       "methods": [
@@ -1685,6 +2030,114 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/post-language-switch/post-language-switch.tsx",
+      "encapsulation": "shadow",
+      "tag": "post-language-switch",
+      "readme": "# post-language-switch\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "caption",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "caption",
+          "reflectToAttr": false,
+          "docs": "A title for the list of language options",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "description",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "A descriptive text for the list of language options",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "variant",
+          "type": "\"dropdown\" | \"list\"",
+          "complexType": {
+            "original": "SwitchVariant",
+            "resolved": "\"dropdown\" | \"list\"",
+            "references": {
+              "SwitchVariant": {
+                "location": "import",
+                "path": "./switch-variants",
+                "id": "src/components/post-language-switch/switch-variants.ts::SwitchVariant"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "variant",
+          "reflectToAttr": false,
+          "docs": "Variant that determines the rendering of the language switch either as a list (used on mobile in the header) or a dropdown (used on desktop in the header)",
+          "docsTags": [],
+          "default": "'list'",
+          "values": [
+            {
+              "value": "dropdown",
+              "type": "string"
+            },
+            {
+              "value": "list",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "post-menu-trigger",
+        "post-icon",
+        "post-menu"
+      ],
+      "dependencyGraph": {
+        "post-language-switch": [
+          "post-menu-trigger",
+          "post-icon",
+          "post-menu"
+        ],
+        "post-menu": [
+          "post-popovercontainer"
+        ]
+      }
+    },
     {
       "filePath": "src/components/post-list/post-list.tsx",
       "encapsulation": "none",
@@ -1713,7 +2166,7 @@
           },
           "mutable": false,
           "attr": "horizontal",
-          "reflectToAttr": false,
+          "reflectToAttr": true,
           "docs": "The list can become horizontal by setting `horizontal=\"true\"` or just `horizontal`",
           "docsTags": [],
           "default": "false",
@@ -1881,13 +2334,7 @@
           "docsTags": []
         }
       ],
-      "listeners": [
-        {
-          "event": "postToggle",
-          "capture": false,
-          "passive": false
-        }
-      ],
+      "listeners": [],
       "styles": [],
       "slots": [],
       "parts": [],
@@ -1905,46 +2352,19 @@
       "usage": {},
       "props": [],
       "methods": [
-        {
-          "name": "hide",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": "boolean"
-          },
-          "complexType": {
-            "signature": "() => Promise<void>",
-            "parameters": [],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              }
-            },
-            "return": "Promise<void>"
-          },
-          "signature": "hide() => Promise<void>",
-          "parameters": [],
-          "docs": "Hide megadropdown",
-          "docsTags": [
-            {
-              "name": "returns",
-              "text": "boolean"
-            }
-          ]
-        },
         {
           "name": "show",
           "returns": {
             "type": "Promise<void>",
-            "docs": "boolean"
+            "docs": ""
           },
           "complexType": {
-            "signature": "(element: HTMLElement) => Promise<void>",
+            "signature": "(target: HTMLElement) => Promise<void>",
             "parameters": [
               {
-                "name": "element",
+                "name": "target",
                 "type": "HTMLElement",
-                "docs": "HTMLElement"
+                "docs": "- The HTML element relative to which the popover dropdown should be displayed."
               }
             ],
             "references": {
@@ -1959,44 +2379,35 @@
             },
             "return": "Promise<void>"
           },
-          "signature": "show(element: HTMLElement) => Promise<void>",
+          "signature": "show(target: HTMLElement) => Promise<void>",
           "parameters": [
             {
-              "name": "element",
+              "name": "target",
               "type": "HTMLElement",
-              "docs": "HTMLElement"
+              "docs": "- The HTML element relative to which the popover dropdown should be displayed."
             }
           ],
-          "docs": "Show megadropdown",
+          "docs": "Displays the popover dropdown",
           "docsTags": [
             {
               "name": "param",
-              "text": "element HTMLElement"
-            },
-            {
-              "name": "returns",
-              "text": "boolean"
+              "text": "target - The HTML element relative to which the popover dropdown should be displayed."
             }
           ]
         },
         {
           "name": "toggle",
           "returns": {
-            "type": "Promise<boolean>",
-            "docs": "boolean"
+            "type": "Promise<void>",
+            "docs": ""
           },
           "complexType": {
-            "signature": "(element: HTMLElement, force?: boolean) => Promise<boolean>",
+            "signature": "(target: HTMLElement) => Promise<void>",
             "parameters": [
               {
-                "name": "element",
+                "name": "target",
                 "type": "HTMLElement",
-                "docs": "HTMLElement"
-              },
-              {
-                "name": "force",
-                "type": "boolean",
-                "docs": "boolean"
+                "docs": ""
               }
             ],
             "references": {
@@ -2009,39 +2420,36 @@
                 "id": "global::HTMLElement"
               }
             },
-            "return": "Promise<boolean>"
+            "return": "Promise<void>"
           },
-          "signature": "toggle(element: HTMLElement, force?: boolean) => Promise<boolean>",
+          "signature": "toggle(target: HTMLElement) => Promise<void>",
           "parameters": [
             {
-              "name": "element",
+              "name": "target",
               "type": "HTMLElement",
-              "docs": "HTMLElement"
-            },
-            {
-              "name": "force",
-              "type": "boolean",
-              "docs": "boolean"
+              "docs": ""
             }
           ],
-          "docs": "Toggle megadropdown",
-          "docsTags": [
-            {
-              "name": "param",
-              "text": "element HTMLElement"
-            },
-            {
-              "name": "param",
-              "text": "force boolean"
-            },
-            {
-              "name": "returns",
-              "text": "boolean"
-            }
-          ]
+          "docs": "Toggles the dropdown visibility based on its current state.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "postToggleMegadropdown",
+          "detail": "boolean",
+          "bubbles": true,
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emits when the dropdown is shown or hidden.\nThe event payload is a boolean: `true` when the dropdown was opened, `false` when it was closed.",
+          "docsTags": []
         }
       ],
-      "events": [],
       "listeners": [],
       "styles": [],
       "slots": [],
@@ -2058,30 +2466,37 @@
     },
     {
       "filePath": "src/components/post-megadropdown-trigger/post-megadropdown-trigger.tsx",
-      "encapsulation": "shadow",
+      "encapsulation": "none",
       "tag": "post-megadropdown-trigger",
       "readme": "# post-megadropdown-toggle\n\n\n",
       "docs": "",
       "docsTags": [],
       "usage": {},
-      "props": [],
-      "methods": [],
-      "events": [
+      "props": [
         {
-          "event": "postToggle",
-          "detail": "any",
-          "bubbles": true,
+          "name": "for",
+          "type": "string",
           "complexType": {
-            "original": "any",
-            "resolved": "any",
+            "original": "string",
+            "resolved": "string",
             "references": {}
           },
-          "cancelable": true,
-          "composed": true,
-          "docs": "Emits after each toggle",
-          "docsTags": []
+          "mutable": false,
+          "attr": "for",
+          "reflectToAttr": false,
+          "docs": "ID of the mega dropdown element that this trigger is linked to. Used to open and close the specified mega dropdown.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true
         }
       ],
+      "methods": [],
+      "events": [],
       "listeners": [],
       "styles": [],
       "slots": [],
@@ -2297,14 +2712,28 @@
       "listeners": [],
       "styles": [],
       "slots": [],
-      "parts": [],
-      "dependents": [],
+      "parts": [
+        {
+          "name": "popover-container",
+          "docs": ""
+        }
+      ],
+      "dependents": [
+        "post-breadcrumb",
+        "post-language-switch"
+      ],
       "dependencies": [
         "post-popovercontainer"
       ],
       "dependencyGraph": {
         "post-menu": [
           "post-popovercontainer"
+        ],
+        "post-breadcrumb": [
+          "post-menu"
+        ],
+        "post-language-switch": [
+          "post-menu"
         ]
       }
     },
@@ -2323,9 +2752,15 @@
       "styles": [],
       "slots": [],
       "parts": [],
-      "dependents": [],
+      "dependents": [
+        "post-breadcrumb"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "post-breadcrumb": [
+          "post-menu-item"
+        ]
+      }
     },
     {
       "filePath": "src/components/post-menu-trigger/post-menu-trigger.tsx",
@@ -2364,9 +2799,19 @@
       "styles": [],
       "slots": [],
       "parts": [],
-      "dependents": [],
+      "dependents": [
+        "post-breadcrumb",
+        "post-language-switch"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "post-breadcrumb": [
+          "post-menu-trigger"
+        ],
+        "post-language-switch": [
+          "post-menu-trigger"
+        ]
+      }
     },
     {
       "filePath": "src/components/post-popover/post-popover.tsx",
@@ -3458,11 +3903,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "toggled - Slot for content displayed when the button is in the \"on\" state."
-        },
-        {
-          "name": "slot",
-          "text": "untoggled - Slot for content displayed when the button is in the \"off\" state."
+          "text": "default - Slot for the content of the button."
         }
       ],
       "usage": {},
@@ -3477,7 +3918,7 @@
           },
           "mutable": true,
           "attr": "toggled",
-          "reflectToAttr": true,
+          "reflectToAttr": false,
           "docs": "If `true`, the button is in the \"on\" state, otherwise it is in the \"off\" state.",
           "docsTags": [],
           "default": "false",
@@ -3496,12 +3937,8 @@
       "styles": [],
       "slots": [
         {
-          "name": "toggled",
-          "docs": "Slot for content displayed when the button is in the \"on\" state."
-        },
-        {
-          "name": "untoggled",
-          "docs": "Slot for content displayed when the button is in the \"off\" state."
+          "name": "default",
+          "docs": "Slot for the content of the button."
         }
       ],
       "parts": [],
@@ -3801,6 +4238,11 @@
       "docstring": "",
       "path": "src/components/post-banner/banner-types.ts"
     },
+    "src/components/post-language-switch/switch-variants.ts::SwitchVariant": {
+      "declaration": "\"list\" | \"dropdown\"",
+      "docstring": "",
+      "path": "src/components/post-language-switch/switch-variants.ts"
+    },
     "../../node_modules/.pnpm/@floating-ui+dom@1.6.8/node_modules/@floating-ui/dom/dist/floating-ui.dom.d.ts::Placement": {
       "declaration": "any",
       "docstring": "",