@dt-dds/react-link 1.0.0-beta.16

package/CHANGELOG.md

@@ -0,0 +1,142 @@
+# @dt-ui/react-link
+
+## 1.0.0-beta.16
+
+### Patch Changes
+
+- chore: fix publish after npmjs.org pkg unpublish
+- Updated dependencies
+  - @dt-dds/react-button@1.0.0-beta.39
+
+## 1.0.0-beta.15
+
+### Major Changes
+
+- refactor!: rename pkg and publish to npmjs
+
+### Patch Changes
+
+- Updated dependencies
+  - @dt-dds/icons@1.0.0-beta.4
+  - @dt-dds/react-button@1.0.0-beta.38
+  - @dt-dds/react-core@1.0.0-beta.41
+  - @dt-dds/react-icon@1.0.0-beta.42
+
+## 0.1.0-beta.14
+
+### Patch Changes
+
+- refactor: drop icon funcional state
+- Updated dependencies
+  - @dt-ui/react-icon@0.1.0-beta.41
+
+## 0.1.0-beta.13
+
+### Patch Changes
+
+- refactor: theme typography values
+- Updated dependencies
+  - @dt-ui/react-core@0.1.0-beta.40
+  - @dt-ui/react-button@0.1.0-beta.37
+  - @dt-ui/react-icon@0.1.0-beta.40
+
+## 0.1.0-beta.12
+
+### Minor Changes
+
+- feat: update shadow theme values
+
+### Patch Changes
+
+- Updated dependencies
+  - @dt-ui/react-core@0.1.0-beta.39
+  - @dt-ui/react-button@0.1.0-beta.36
+  - @dt-ui/react-icon@0.1.0-beta.39
+
+## 0.1.0-beta.11
+
+### Minor Changes
+
+- feat: add new icon font sizes
+
+### Patch Changes
+
+- Updated dependencies
+  - @dt-ui/react-icon@0.1.0-beta.38
+
+## 0.1.0-beta.10
+
+### Patch Changes
+
+- chore: update theme font-styles
+- Updated dependencies
+  - @dt-ui/react-core@0.1.0-beta.38
+  - @dt-ui/react-button@0.1.0-beta.35
+  - @dt-ui/react-icon@0.1.0-beta.37
+
+## 0.1.0-beta.9
+
+### Patch Changes
+
+- chore: review OSS files
+- Updated dependencies
+  - @dt-ui/icons@0.1.0-beta.3
+  - @dt-ui/react-button@0.1.0-beta.34
+  - @dt-ui/react-core@0.1.0-beta.37
+  - @dt-ui/react-icon@0.1.0-beta.36
+
+## 0.1.0-beta.8
+
+### Minor Changes
+
+- feat: add mobile breakpoint for button
+
+### Patch Changes
+
+- Updated dependencies
+  - @dt-ui/react-button@0.1.0-beta.33
+
+## 0.1.0-beta.7
+
+### Patch Changes
+
+- refactor: repalce enum with type
+
+## 0.1.0-beta.6
+
+### Patch Changes
+
+- fix: link build
+
+## 0.1.0-beta.5
+
+### Minor Changes
+
+- feat: add icon to link
+
+## 0.1.0-beta.4
+
+### Patch Changes
+
+- chore: update contextual colors
+- Updated dependencies
+  - @dt-ui/react-button@0.1.0-beta.32
+  - @dt-ui/react-core@0.1.0-beta.36
+
+## 0.1.0-beta.3
+
+### Minor Changes
+
+- feat: add active state to link
+
+## 0.1.0-beta.2
+
+### Minor Changes
+
+- feat: update link according to design
+
+## 0.1.0-beta.1
+
+### Patch Changes
+
+- chore: link independent pkg

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daimler Truck AG.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# Link Package
+
+The link component is used as a navigational element to navigate users to another location and it allows to easily customize anchor elements.
+
+## Link Usage
+
+```jsx
+import { Link } from '@dt-dds/react-link';
+
+export const App = () => {
+  return <Link href='/'>Some text</Link>;
+};
+```
+
+## Properties
+
+| Property     | Type        | Default  | Description                                     |
+| ------------ | ----------- | -------- | ----------------------------------------------- |
+| `children`   | `ReactNode` | -        | Child components to be rendered                 |
+| `dataTestId` | `string`    | tag      | Customizable test identifier                    |
+| `onClick`    | `function`  | -        | The triggered function when the Link is clicked |
+| `isDisabled` | `boolean`   | `false`  | Specifies if the element should be disabled     |
+| `size`       | `LinkSize`  | `medium` | Specifies the text size of the element          |
+
+This component inherits all native anchor properties. [Learn more](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a).
+
+## Stack
+
+- [TypeScript](https://www.typescriptlang.org/) for static type checking
+- [React](https://reactjs.org/) — JavaScript library for user interfaces
+- [Emotion](https://emotion.sh/docs/introduction) — for writing css styles with JavaScript
+- [Storybook](https://storybook.js.org/) — UI component environment powered by Vite
+- [Jest](https://jestjs.io/) - JavaScript Testing Framework
+- [React Testing Library](https://testing-library.com/) - to test UI components in a user-centric way
+- [ESLint](https://eslint.org/) for code linting
+- [Prettier](https://prettier.io) for code formatting
+- [Tsup](https://github.com/egoist/tsup) — TypeScript bundler powered by esbuild
+- [Yarn](https://yarnpkg.com/) from managing packages
+
+## Commands
+
+- `yarn build` - Build the package
+- `yarn dev` - Run the package locally
+- `yarn lint` - Lint all files within this package
+- `yarn test` - Run all unit tests
+- `yarn test:report` - Open the test coverage report
+- `yarn test:update:snapshot` - Run all unit tests and update the snapshot
+
+## Compilation
+
+Running `yarn build` from the root of the package will use [tsup](https://tsup.egoist.dev/) to compile the raw TypeScript and React code to plain JavaScript.
+
+The `/dist` folder contains the compiled output.
+
+```bash
+link
+└── dist
+    ├── index.d.ts  <-- Types
+    ├── index.js    <-- CommonJS version
+    └── index.mjs   <-- ES Modules version
+    ...
+```
+
+## Versioning
+
+Follows [semantic versioning](https://semver.org/)
+
+## &copy; License
+
+Licensed under [MIT License](LICENSE.md)

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { BaseProps, Theme } from '@dt-dds/react-core';
+import * as react from 'react';
+import { Code } from '@dt-dds/icons';
+import { IconProps } from '@dt-dds/react-icon';
+
+interface LinkProps extends BaseProps, React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    isDisabled?: boolean;
+    onClick?: () => void;
+    size?: LinkSize;
+    variant?: LinkVariant;
+    icon?: Code;
+}
+declare const Link: react.ForwardRefExoticComponent<LinkProps & react.RefAttributes<HTMLAnchorElement>>;
+
+type LinkVariant = 'primary' | 'secondary';
+type LinkSize = 'small' | 'medium' | 'large';
+
+declare const iconSize: Record<LinkSize, IconProps['size']>;
+
+declare module '@emotion/react' {
+    interface Theme extends Theme {
+    }
+}
+
+export { Link, LinkProps, LinkSize, LinkVariant, iconSize };

package/dist/index.js

@@ -0,0 +1,169 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var link_exports = {};
+__export(link_exports, {
+  Link: () => Link,
+  iconSize: () => iconSize
+});
+module.exports = __toCommonJS(link_exports);
+
+// src/Link.tsx
+var import_react_icon = require("@dt-dds/react-icon");
+var import_react = require("react");
+
+// src/Link.styled.ts
+var import_styled = __toESM(require("@emotion/styled"));
+var LinkStyled = import_styled.default.a`
+  ${({ theme, disabled, size, variant = "primary" }) => `
+    color: ${theme.palette[variant].default};
+    text-decoration: none;
+    display: inline-flex;
+    align-items: center;
+    gap: ${theme.spacing["5xs"]};
+
+    ${disabled && `
+        color: ${theme.palette[variant].light};
+        cursor: not-allowed;
+      `};
+
+    ${!disabled && `
+        &:hover > span {
+          text-decoration: underline;
+        }
+
+        &:active {
+          color: ${theme.palette[variant].dark};
+          text-decoration: none;
+        }
+      `};
+
+    &:focus-visible {
+      outline: 2px solid ${theme.palette.primary.default};
+    }
+
+    ${size == "large" && `
+        ${theme.fontStyles.body1Bold}
+      `};
+
+    ${size == "medium" && `
+        ${theme.fontStyles.body2Bold}
+      `};
+
+    ${size == "small" && `
+        ${theme.fontStyles.body3Bold}
+      `};
+  `}
+`;
+
+// src/Link.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var Link = (0, import_react.forwardRef)(
+  (_a, ref) => {
+    var _b = _a, {
+      isDisabled,
+      children,
+      size = "medium",
+      dataTestId,
+      onClick,
+      variant,
+      href,
+      style,
+      icon
+    } = _b, rest = __objRest(_b, [
+      "isDisabled",
+      "children",
+      "size",
+      "dataTestId",
+      "onClick",
+      "variant",
+      "href",
+      "style",
+      "icon"
+    ]);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+      LinkStyled,
+      __spreadProps(__spreadValues(__spreadValues({
+        "data-testid": dataTestId != null ? dataTestId : "link",
+        disabled: isDisabled,
+        ref,
+        size,
+        style,
+        variant
+      }, !isDisabled && { href, onClick }), rest), {
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children }),
+          icon ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_icon.Icon, { code: icon, color: "inherit", size: iconSize[size] }) : null
+        ]
+      })
+    );
+  }
+);
+
+// src/constants/constants.ts
+var iconSize = {
+  small: "xs",
+  medium: "s",
+  large: "l"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Link,
+  iconSize
+});

package/dist/index.mjs

@@ -0,0 +1,134 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+
+// src/Link.tsx
+import { Icon } from "@dt-dds/react-icon";
+import { forwardRef } from "react";
+
+// src/Link.styled.ts
+import styled from "@emotion/styled";
+var LinkStyled = styled.a`
+  ${({ theme, disabled, size, variant = "primary" }) => `
+    color: ${theme.palette[variant].default};
+    text-decoration: none;
+    display: inline-flex;
+    align-items: center;
+    gap: ${theme.spacing["5xs"]};
+
+    ${disabled && `
+        color: ${theme.palette[variant].light};
+        cursor: not-allowed;
+      `};
+
+    ${!disabled && `
+        &:hover > span {
+          text-decoration: underline;
+        }
+
+        &:active {
+          color: ${theme.palette[variant].dark};
+          text-decoration: none;
+        }
+      `};
+
+    &:focus-visible {
+      outline: 2px solid ${theme.palette.primary.default};
+    }
+
+    ${size == "large" && `
+        ${theme.fontStyles.body1Bold}
+      `};
+
+    ${size == "medium" && `
+        ${theme.fontStyles.body2Bold}
+      `};
+
+    ${size == "small" && `
+        ${theme.fontStyles.body3Bold}
+      `};
+  `}
+`;
+
+// src/Link.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var Link = forwardRef(
+  (_a, ref) => {
+    var _b = _a, {
+      isDisabled,
+      children,
+      size = "medium",
+      dataTestId,
+      onClick,
+      variant,
+      href,
+      style,
+      icon
+    } = _b, rest = __objRest(_b, [
+      "isDisabled",
+      "children",
+      "size",
+      "dataTestId",
+      "onClick",
+      "variant",
+      "href",
+      "style",
+      "icon"
+    ]);
+    return /* @__PURE__ */ jsxs(
+      LinkStyled,
+      __spreadProps(__spreadValues(__spreadValues({
+        "data-testid": dataTestId != null ? dataTestId : "link",
+        disabled: isDisabled,
+        ref,
+        size,
+        style,
+        variant
+      }, !isDisabled && { href, onClick }), rest), {
+        children: [
+          /* @__PURE__ */ jsx("span", { children }),
+          icon ? /* @__PURE__ */ jsx(Icon, { code: icon, color: "inherit", size: iconSize[size] }) : null
+        ]
+      })
+    );
+  }
+);
+
+// src/constants/constants.ts
+var iconSize = {
+  small: "xs",
+  medium: "s",
+  large: "l"
+};
+export {
+  Link,
+  iconSize
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@dt-dds/react-link",
+  "version": "1.0.0-beta.16",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint --cache .",
+    "test": "jest",
+    "test:report": "open ./jest-coverage/lcov-report/index.html",
+    "test:update:snapshot": "jest -u"
+  },
+  "dependencies": {
+    "@dt-dds/icons": "1.0.0-beta.4",
+    "@dt-dds/react-button": "1.0.0-beta.39",
+    "@dt-dds/react-core": "1.0.0-beta.41",
+    "@dt-dds/react-icon": "1.0.0-beta.42"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.22.9",
+    "@babel/preset-env": "^7.22.9",
+    "@babel/preset-react": "^7.22.5",
+    "@babel/preset-typescript": "^7.23.3",
+    "@emotion/babel-plugin": "^11.11.0",
+    "@emotion/css": "^11.7.1",
+    "@emotion/jest": "^11.10.0",
+    "@emotion/react": "^11.8.2",
+    "@emotion/styled": "^11.8.1",
+    "@types/react": "^18.0.9",
+    "@types/react-dom": "^18.0.4",
+    "babel-loader": "^8.3.0",
+    "eslint-config-custom": "*",
+    "eslint-plugin-storybook": "^9.1.0",
+    "jest-config": "*",
+    "react": "^18.1.0",
+    "react-dom": "^18.2.0",
+    "tsconfig": "*",
+    "tsup": "^6.6.3",
+    "typescript": "^4.5.3"
+  },
+  "peerDependencies": {
+    "@emotion/css": "^11.7.1",
+    "@emotion/react": "^11.8.2",
+    "@emotion/styled": "^11.8.1",
+    "react": ">=17.0.2",
+    "react-dom": ">=17.0.2"
+  }
+}