@lmvz-ds/components 0.28.1 → 0.30.0

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-06-15T10:54:33",
+  "timestamp": "2026-06-15T18:20:41",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -1586,12 +1586,16 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "lmvz-link",
         "lmvz-message",
         "lmvz-modal",
         "lmvz-snackbar"
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "lmvz-link": [
+          "lmvz-icon"
+        ],
         "lmvz-message": [
           "lmvz-icon"
         ],
@@ -5683,6 +5687,207 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/lmvz-link/lmvz-link.tsx",
+      "encapsulation": "shadow",
+      "tag": "lmvz-link",
+      "readme": "# lmvz-link\n\nThe link renders a semantically correct native anchor element with a trailing icon indicating the navigation type.\n\n## Visual Types\n\nThe component supports two visual types controlled by the `type` prop:\n\n- **`internal`** — renders an arrow-right icon, indicating navigation within the same site or application\n- **`external`** — renders an external icon, indicating navigation to an external destination\n\n## Label and Accessibility\n\nThe default slot accepts inline label text for the link. When the link opens in a new tab (`target=\"_blank\"`), a visually-hidden external label is automatically appended to improve accessible announcements. The text of this label is controlled by the `externalLabel` prop (default: `\"(öffnet in neuem Tab)\"`) and can be customized for localization.\n",
+      "docs": "The link renders a native anchor element with an icon indicating navigation type.",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "default - Inline label text for the link."
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "externalLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "external-label",
+          "reflectToAttr": false,
+          "docs": "Visually-hidden text appended inside the anchor when `target=\"_blank\"`.\nProvides an accessible cue for screen reader users.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'(öffnet in neuem Tab)'"
+            }
+          ],
+          "default": "'(öffnet in neuem Tab)'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "href",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "href",
+          "reflectToAttr": true,
+          "docs": "The URL the link points to. Mirrors the native anchor `href` attribute.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "''"
+            }
+          ],
+          "default": "''",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "rel",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "rel",
+          "reflectToAttr": false,
+          "docs": "Relationship of the linked URL. When `target=\"_blank\"`, `noopener` and\n`noreferrer` are automatically added if not already present.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "target",
+          "type": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\" | undefined",
+          "complexType": {
+            "original": "'_self' | '_blank' | '_parent' | '_top'",
+            "resolved": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\" | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "target",
+          "reflectToAttr": true,
+          "docs": "Where to open the linked document.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "_blank",
+              "type": "string"
+            },
+            {
+              "value": "_parent",
+              "type": "string"
+            },
+            {
+              "value": "_self",
+              "type": "string"
+            },
+            {
+              "value": "_top",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "type",
+          "type": "\"external\" | \"internal\"",
+          "complexType": {
+            "original": "Link.Type",
+            "resolved": "\"external\" | \"internal\"",
+            "references": {
+              "Link": {
+                "location": "import",
+                "path": "../../api/ds.constants.js",
+                "id": "src/api/ds.constants.ts::Link",
+                "referenceLocation": "Link"
+              }
+            }
+          },
+          "mutable": true,
+          "attr": "type",
+          "reflectToAttr": true,
+          "docs": "Navigation type. Drives the icon shown after the label text.\n- `internal` → arrow-right icon\n- `external` → external icon\nInvalid values are normalized to `internal`.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'internal'"
+            }
+          ],
+          "default": "'internal'",
+          "values": [
+            {
+              "value": "external",
+              "type": "string"
+            },
+            {
+              "value": "internal",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "default",
+          "docs": "Inline label text for the link."
+        }
+      ],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [
+        "lmvz-icon"
+      ],
+      "dependencyGraph": {
+        "lmvz-link": [
+          "lmvz-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/lmvz-menuitem/lmvz-menuitem.tsx",
       "encapsulation": "scoped",
@@ -8008,6 +8213,11 @@
       "docstring": "",
       "path": "src/api/index.d.ts"
     },
+    "src/api/ds.constants.ts::Link": {
+      "declaration": "any",
+      "docstring": "",
+      "path": "src/api/ds.constants.ts"
+    },
     "src/api/index.d.ts::Message": {
       "declaration": "any",
       "docstring": "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmvz-ds/components",
   "private": false,
-  "version": "0.28.1",
+  "version": "0.30.0",
   "type": "module",
   "description": "The components of the design system",
   "author": "Patrick Nemenz <patrick.nemenz@adesso.at>",
@@ -56,6 +56,10 @@
       "types": "./components/lmvz-icon.d.ts",
       "import": "./components/lmvz-icon.js"
     },
+    "./lmvz-link": {
+      "types": "./components/lmvz-link.d.ts",
+      "import": "./components/lmvz-link.js"
+    },
     "./lmvz-input": {
       "types": "./components/lmvz-input.d.ts",
       "import": "./components/lmvz-input.js"

package/types/api/ds.constants.d.ts

@@ -9,6 +9,7 @@ export declare const iconSizes: readonly ["xs", "sm", "md", "lg", "inherit"];
 export declare const iconWeights: readonly ["thin", "medium", "bold"];
 export declare const chipTypes: readonly ["active", "warning", "success", "error", "neutral"];
 export declare const chipSizes: readonly ["default", "small"];
+export declare const linkTypes: readonly ["internal", "external"];
 export declare namespace LmvzDS {
     type Variant = (typeof variants)[number];
     type Size = (typeof sizes)[number];
@@ -24,6 +25,9 @@ export declare namespace Chip {
     type Type = (typeof chipTypes)[number];
     type Size = (typeof chipSizes)[number];
 }
+export declare namespace Link {
+    type Type = (typeof linkTypes)[number];
+}
 export declare namespace Icon {
     type Size = (typeof iconSizes)[number];
     type IconWeight = (typeof iconWeights)[number];

package/types/components/lmvz-link/lmvz-link.d.ts

@@ -0,0 +1,13 @@
+import { type Link } from '../../api/ds.constants.js';
+export declare class LmvzLink {
+    href: string;
+    target?: '_self' | '_blank' | '_parent' | '_top';
+    rel?: string;
+    type: Link.Type;
+    externalLabel: string;
+    normalizeType(value: string): void;
+    componentWillLoad(): void;
+    private computeHref;
+    private computeRel;
+    render(): any;
+}

package/types/components.d.ts

@@ -374,6 +374,34 @@ export declare namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * The link renders a native anchor element with an icon indicating navigation type.
+     */
+    export interface LmvzLink {
+        /**
+         * Visually-hidden text appended inside the anchor when `target="_blank"`. Provides an accessible cue for screen reader users.
+         * @default '(öffnet in neuem Tab)'
+         */
+        "externalLabel": string;
+        /**
+         * The URL the link points to. Mirrors the native anchor `href` attribute.
+         * @default ''
+         */
+        "href": string;
+        /**
+         * Relationship of the linked URL. When `target="_blank"`, `noopener` and `noreferrer` are automatically added if not already present.
+         */
+        "rel"?: string;
+        /**
+         * Where to open the linked document.
+         */
+        "target"?: '_self' | '_blank' | '_parent' | '_top';
+        /**
+         * Navigation type. Drives the icon shown after the label text. - `internal` → arrow-right icon - `external` → external icon Invalid values are normalized to `internal`.
+         * @default 'internal'
+         */
+        "type": Link.Type;
+    }
     /**
      * A menu item component to be used within the `lmvz-header` component's navigation slots.
      */
@@ -1093,6 +1121,34 @@ export declare namespace JSX {
          */
         "value"?: string;
     }
+    /**
+     * The link renders a native anchor element with an icon indicating navigation type.
+     */
+    export interface LmvzLink {
+        /**
+         * Visually-hidden text appended inside the anchor when `target="_blank"`. Provides an accessible cue for screen reader users.
+         * @default '(öffnet in neuem Tab)'
+         */
+        "externalLabel"?: string;
+        /**
+         * The URL the link points to. Mirrors the native anchor `href` attribute.
+         * @default ''
+         */
+        "href"?: string;
+        /**
+         * Relationship of the linked URL. When `target="_blank"`, `noopener` and `noreferrer` are automatically added if not already present.
+         */
+        "rel"?: string;
+        /**
+         * Where to open the linked document.
+         */
+        "target"?: '_self' | '_blank' | '_parent' | '_top';
+        /**
+         * Navigation type. Drives the icon shown after the label text. - `internal` → arrow-right icon - `external` → external icon Invalid values are normalized to `internal`.
+         * @default 'internal'
+         */
+        "type"?: Link.Type;
+    }
     /**
      * A menu item component to be used within the `lmvz-header` component's navigation slots.
      */
@@ -1513,6 +1569,13 @@ export declare namespace JSX {
         "size": Input.Size;
         "error": boolean;
     }
+    export interface LmvzLinkAttributes {
+        "href": string;
+        "target": '_self' | '_blank' | '_parent' | '_top';
+        "rel": string;
+        "type": Link.Type;
+        "externalLabel": string;
+    }
     export interface LmvzMenuitemAttributes {
         "role": string;
         "ti": number;
@@ -1592,6 +1655,7 @@ export declare namespace JSX {
         "lmvz-header": Omit<LmvzHeader, keyof LmvzHeaderAttributes> & { [K in keyof LmvzHeader & keyof LmvzHeaderAttributes]?: LmvzHeader[K] } & { [K in keyof LmvzHeader & keyof LmvzHeaderAttributes as `attr:${K}`]?: LmvzHeaderAttributes[K] } & { [K in keyof LmvzHeader & keyof LmvzHeaderAttributes as `prop:${K}`]?: LmvzHeader[K] };
         "lmvz-icon": Omit<LmvzIcon, keyof LmvzIconAttributes> & { [K in keyof LmvzIcon & keyof LmvzIconAttributes]?: LmvzIcon[K] } & { [K in keyof LmvzIcon & keyof LmvzIconAttributes as `attr:${K}`]?: LmvzIconAttributes[K] } & { [K in keyof LmvzIcon & keyof LmvzIconAttributes as `prop:${K}`]?: LmvzIcon[K] } & OneOf<"icon", LmvzIcon["icon"], LmvzIconAttributes["icon"]>;
         "lmvz-input": Omit<LmvzInput, keyof LmvzInputAttributes> & { [K in keyof LmvzInput & keyof LmvzInputAttributes]?: LmvzInput[K] } & { [K in keyof LmvzInput & keyof LmvzInputAttributes as `attr:${K}`]?: LmvzInputAttributes[K] } & { [K in keyof LmvzInput & keyof LmvzInputAttributes as `prop:${K}`]?: LmvzInput[K] } & OneOf<"label", LmvzInput["label"], LmvzInputAttributes["label"]>;
+        "lmvz-link": Omit<LmvzLink, keyof LmvzLinkAttributes> & { [K in keyof LmvzLink & keyof LmvzLinkAttributes]?: LmvzLink[K] } & { [K in keyof LmvzLink & keyof LmvzLinkAttributes as `attr:${K}`]?: LmvzLinkAttributes[K] } & { [K in keyof LmvzLink & keyof LmvzLinkAttributes as `prop:${K}`]?: LmvzLink[K] };
         "lmvz-menuitem": Omit<LmvzMenuitem, keyof LmvzMenuitemAttributes> & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes]?: LmvzMenuitem[K] } & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes as `attr:${K}`]?: LmvzMenuitemAttributes[K] } & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes as `prop:${K}`]?: LmvzMenuitem[K] };
         "lmvz-message": Omit<LmvzMessage, keyof LmvzMessageAttributes> & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes]?: LmvzMessage[K] } & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes as `attr:${K}`]?: LmvzMessageAttributes[K] } & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes as `prop:${K}`]?: LmvzMessage[K] };
         "lmvz-modal": Omit<LmvzModal, keyof LmvzModalAttributes> & { [K in keyof LmvzModal & keyof LmvzModalAttributes]?: LmvzModal[K] } & { [K in keyof LmvzModal & keyof LmvzModalAttributes as `attr:${K}`]?: LmvzModalAttributes[K] } & { [K in keyof LmvzModal & keyof LmvzModalAttributes as `prop:${K}`]?: LmvzModal[K] };
@@ -1605,6 +1669,12 @@ export declare namespace JSX {
     }
 }
 
+export declare namespace Link {
+    export type Type = (typeof linkTypes)[number];
+}
+
+declare const linkTypes: readonly ["internal", "external"];
+
 export declare interface LmvzActionCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLLmvzActionElement;

package/types/index.d.ts

@@ -1,6 +1,6 @@
 export * from '@lmvz-ds/aria-validation';
 export type * from './components.d.ts';
-export { chipSizes, chipTypes, iconSizes, iconWeights, inputSizes, inputTypes, messageTypes, selectSizes, textSizes } from './api/ds.constants';
+export { chipSizes, chipTypes, iconSizes, iconWeights, inputSizes, inputTypes, linkTypes, messageTypes, selectSizes, textSizes } from './api/ds.constants';
 export type { LmvzDS, Typography } from './api';
 export * from './components/lmvz-message/public';
 export * from './components/lmvz-snackbar/public';

package/lmvz-components/p-DWePb-zu.js

@@ -1 +0,0 @@
-const a=["xs","sm","md","lg"],s=[...a,"xl"],e=["text","email","password","tel","url","search","number"],l=["sm","md","lg"],r=["small","default","large"],t=[...a,"inherit"],m=["thin","medium","bold"],n=["active","warning","success","error","neutral"],i=["default","small"],d=["neutral","warning"];export{n as a,m as b,i as c,l as d,e,t as i,d as m,r as s,s as t}