@daikin-oss/design-system-web-components 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,9 @@
 # Daikin Design System - Web Components
 
-This project is an implementation of the Daikin Design Kit using web components.
+This project is an implementation of the Daikin Design Kit using Web Components.
 
 ---
+
 ## Usage
 
 Start by installing the package:
@@ -14,13 +15,15 @@ npm i @daikin-oss/design-system-web-components
 You can then import necessary components in your bundle:
 
 ```javascript
-import '@daikin-oss/design-system-web-components/dist/components/button/index.js';
+import "@daikin-oss/design-system-web-components/dist/components/button/index.js";
 ```
 
 By default, out-of-the-box, the styles are for Daikin brand in light mode.
 
 ### Dark Mode and Brands/Themes
 
+_Due to the encapsulation of styles by the Web Components specification, how themes are applied may change in the future._
+
 For dark-mode support and non-daikin brands, you need to add the `tokens` package and include the CSS reference in your html:
 
 ```bash
@@ -32,15 +35,18 @@ npm install '@daikin-oss/dds-tokens
 Reference the CSS in HTML:
 
 ```html
-<link rel="stylesheet" href="node_modules/@daikin-oss/dds-tokens/build/css/DKN/Dark/buttons.css" media="(prefers-color-scheme: dark)">
+<link
+  rel="stylesheet"
+  href="node_modules/@daikin-oss/dds-tokens/build/css/DKN/Dark/buttons.css"
+  media="(prefers-color-scheme: dark)"
+/>
 ```
 
 Using CSS `@import` with `prefers-color-scheme`:
 
 ```css
-@import '@daikin-oss/dds-tokens/css/daikin/Dark/buttons.css'
-    (prefers-color-scheme: dark);
-
+@import "@daikin-oss/dds-tokens/css/daikin/Dark/buttons.css"
+  (prefers-color-scheme: dark);
 ```
 
 #### Other brands/themes
@@ -48,21 +54,30 @@ Using CSS `@import` with `prefers-color-scheme`:
 Reference the CSS in HTML:
 
 ```html
-<link rel="stylesheet" href="node_modules/@daikin-oss/dds-tokens/build/css/AAF/Dark/buttons.css" media="(prefers-color-scheme: light)">
-<link rel="stylesheet" href="node_modules/@daikin-oss/dds-tokens/build/css/AAF/Dark/buttons.css" media="(prefers-color-scheme: dark)">
+<link
+  rel="stylesheet"
+  href="node_modules/@daikin-oss/dds-tokens/build/css/AAF/Dark/buttons.css"
+  media="(prefers-color-scheme: light)"
+/>
+<link
+  rel="stylesheet"
+  href="node_modules/@daikin-oss/dds-tokens/build/css/AAF/Dark/buttons.css"
+  media="(prefers-color-scheme: dark)"
+/>
 ```
 
 Using CSS `@import` with `prefers-color-scheme`:
 
 ```css
-@import '@daikin-oss/dds-tokens/css/aaf/Light/buttons.css'
-    (prefers-color-scheme: light);
-@import '@daikin-oss/dds-tokens/css/aaf/Dark/buttons.css'
-    (prefers-color-scheme: dark);
+@import "@daikin-oss/dds-tokens/css/aaf/Light/buttons.css"
+  (prefers-color-scheme: light);
+@import "@daikin-oss/dds-tokens/css/aaf/Dark/buttons.css"
+  (prefers-color-scheme: dark);
 ```
 
 ---
-## Contributors
+
+## Contribution
 
 The following are instructions for package contributors.
 
@@ -73,7 +88,12 @@ Clone and install dependencies:
 ```bash
 git clone https://github.com/dsv-rp/DDS.git
 cd DDS
+
+# install dependencies
 npm i
+
+# install Playwright browsers
+npx playwright install
 ```
 
 ### Build
@@ -84,22 +104,25 @@ To build files for production:
 npm run build
 ```
 
-Rollup is used to transform TypeScript code into JavaScript that runs in modern browsers.
-Tailwind classes are also purged.
+Vite is used to transform TypeScript code into JavaScript that runs in modern browsers.
 
-Build components and output in /dist:
+The built files are written to `/dist`.
 
 ### Documentation
 
 Storybook is used to document design system components/tools/examples.
 
-To run in development:
+To run in development mode:
 
 ```bash
+# Web Components version
 npm run storybook
+
+# or React version
+npm run storybook:react
 ```
 
-To produce distributable files in /storybook-static folder:
+To produce distributable files in `/storybook-static/web-components` and `/storybook-static/react` folder:
 
 ```bash
 npm run build-storybook
@@ -107,69 +130,85 @@ npm run build-storybook
 
 ### Testing
 
-Visual regression testing is done by a combination of jest and puppeteer.
-Currently, web components has full support in most major frameworks [except for React](https://custom-elements-everywhere.com/).
-As such, we test both web components by themselves, and also test when imported by React:
+There are currently two test suites: VRT (Visual Regression Test) and Interaction Test.
+
+Visual regression testing, placed in `*.visual.test.ts`, is done by Playwright running in a container.
+To eliminate rendering differences between environments, the browser which takes the screenshots must run on a container.
+
+Currently, Web Components has full support in most major frameworks [except for React](https://custom-elements-everywhere.com/).
+As such, we test both Web Components by themselves, and also test when imported by React:
+
+```bash
+# start a container for running the browsers
+docker compose up -d
+
+# run VRT for Web Components and React versions
+npm run test:visual
+
+# stop the container
+docker compose down
+```
+
+For Podman users, use `podman-compose -f compose.podman.yaml` or `podman compose -f compose.podman.yaml` instead of `docker compose`.
+
+To update snapshots, use `npm run test:visual-update`
+
+---
+
+Interaction testing, placed in `*.stories.ts`, is performed by Storybook, which also uses Playwright internally.
+Interaction tests do not use containers since rendering differences between environments do not matter.
 
 ```bash
-npm run test
+npm run test:interaction
 ```
 
-### Linting
+### Linting and Type checking
 
-Linting is done by ESLint for general linting of TypeScript and JavaScript, and [lit-analyzer](https://www.npmjs.com/package/lit-analyzer) to type check bindings in lit-html templates.
+Linting is performed by ESLint for general linting of JavaScript and TypeScript, and [lit-analyzer](https://www.npmjs.com/package/lit-analyzer) to type check bindings in lit-html templates.
+[cSpell](https://cspell.org/) is used for spell checking.
+[ls-lint](https://ls-lint.org/) is also used to ensure that consistent filenames are used.
 
-To lint the project run:
+To lint the project, run:
 
 ```bash
 npm run lint
+npx tsc -b
 ```
 
+If you encounter an `Unknown word` error, add the word to the `cspell-dictionary.txt`.
+
 ### Design Tokens
 
+_We are looking for a more efficient way to import tokens._
+
 1. **Source of Truth**: The `tokens` we use is the foundation of our design styles and was grabbed from https://github.com/dsv-rp/dds-tokens/tree/main.
 
 2. **Using in Components**: For the most part, we use the js variables to apply as the default style:
 
 ```javascript
 import {
-    buttonColorBackgroundPrimaryActive
+  buttonColorBackgroundPrimaryActive
 } from '@daikin-oss/dds-tokens/js/daikin/Light/variables.js';
 
 class DaikinButton extends LitElement implements DaikinButtonProps {
-    static styles = css`
-        :host {
-            --defaultButtonColorBackgroundPrimaryActive: ${unsafeCSS(
-                buttonColorBackgroundPrimaryActive
-            )};
-        }
-    `;
-
-    ...rest of the code
+  static styles = css`
+    :host {
+      --defaultButtonColorBackgroundPrimaryActive: ${unsafeCSS(
+        buttonColorBackgroundPrimaryActive
+      )};
+    }
+  `;
+
+  /* ...rest of the code */
 }
 ```
 
-### Tailwind
-
-There is a custom `daikinPlugin` managed [here](https://github.com/dsv-rp/tailwind)
-
-### Using with VSCode
+### TailwindCSS
 
-If you are using VSCode, there is a great [extension](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) you can use for auto-complete
+There is a custom `daikinPlugin` managed [here](https://github.com/dsv-rp/tailwind).
 
-Add the following to your VSCode `settings.json` file:
-
-```json
-{
-    "editor.quickSuggestions": {
-        "other": true,
-        "comments": false,
-        "strings": true
-    },
-    "tailwindCSS.experimental.classRegex": ["ctl[(]`([^`]*)"]
-}
-```
+### Developing with VSCode
 
-You may need to set the regex if using a library like [classnames-template-literals](https://github.com/netlify/classnames-template-literals)
+This project provides recommended extensions and workspace settings for VSCode.
 
 References [Daikin Design Kit](https://www.figma.com/file/VyaaU8Ta9yzyf0PsURWSSf/DDS%3A-Design-Kit?node-id=2421%3A7943)

package/dist/cjs/colors.cjs

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const variables_js = require("@daikin-oss/dds-tokens/js/daikin/Light/variables.js");
+const DAIKIN_PRIMARY_BLUE = variables_js.colorBrandPrimary;
+const DAIKIN_SECONDARY_BLUE = variables_js.colorBlue40;
+const DAIKIN_DARK_GREY = variables_js.colorGrey90;
+const DAIKIN_MEDIUM_GREY = variables_js.colorGrey70;
+const DAIKIN_NEGATIVE = variables_js.colorRed60;
+const DAIKIN_WARNING = variables_js.colorYellow50;
+const DAIKIN_POSITIVE = variables_js.colorGreen60;
+const colors = {
+  daikinBlue: {
+    50: variables_js.colorBlue10,
+    100: variables_js.colorBlue20,
+    200: variables_js.colorBlue30,
+    300: DAIKIN_SECONDARY_BLUE,
+    400: variables_js.colorBlue50,
+    500: DAIKIN_PRIMARY_BLUE,
+    600: variables_js.colorBlue70,
+    700: variables_js.colorBlue80,
+    800: variables_js.colorBlue90,
+    900: variables_js.colorBlue100,
+    DEFAULT: DAIKIN_PRIMARY_BLUE
+  },
+  daikinNeutral: {
+    50: variables_js.colorGrey10,
+    100: variables_js.colorGrey20,
+    200: variables_js.colorGrey30,
+    300: variables_js.colorGrey40,
+    400: variables_js.colorGrey50,
+    500: variables_js.colorGrey60,
+    600: DAIKIN_MEDIUM_GREY,
+    700: variables_js.colorGrey80,
+    800: DAIKIN_DARK_GREY,
+    900: variables_js.colorGrey100
+  },
+  daikinRed: {
+    50: variables_js.colorRed10,
+    100: variables_js.colorRed20,
+    200: variables_js.colorRed30,
+    300: variables_js.colorRed40,
+    400: variables_js.colorRed50,
+    500: DAIKIN_NEGATIVE,
+    600: variables_js.colorRed70,
+    700: variables_js.colorRed80,
+    800: variables_js.colorRed90,
+    900: variables_js.colorRed100,
+    1e3: variables_js.colorRed110,
+    DEFAULT: DAIKIN_NEGATIVE
+  },
+  daikinYellow: {
+    50: variables_js.colorYellow10,
+    100: variables_js.colorYellow20,
+    200: variables_js.colorYellow30,
+    300: variables_js.colorYellow40,
+    400: DAIKIN_WARNING,
+    500: variables_js.colorYellow60,
+    600: variables_js.colorYellow70,
+    700: variables_js.colorYellow80,
+    800: variables_js.colorYellow90,
+    900: variables_js.colorYellow100,
+    1e3: variables_js.colorYellow110,
+    DEFAULT: DAIKIN_WARNING
+  },
+  daikinGreen: {
+    50: variables_js.colorGreen10,
+    100: variables_js.colorGreen20,
+    200: variables_js.colorGreen30,
+    300: variables_js.colorGreen40,
+    400: variables_js.colorGreen50,
+    500: DAIKIN_POSITIVE,
+    600: variables_js.colorGreen70,
+    700: variables_js.colorGreen80,
+    800: variables_js.colorGreen90,
+    900: variables_js.colorGreen100,
+    1e3: variables_js.colorGreen110,
+    DEFAULT: DAIKIN_POSITIVE
+  }
+};
+exports.colors = colors;

package/{lib → dist/cjs}/colors.d.ts

@@ -67,4 +67,3 @@ export declare const colors: {
         DEFAULT: string;
     };
 };
-//# sourceMappingURL=colors.d.ts.map

package/dist/cjs/components/button/daikin-button.cjs

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const variables_js = require("@daikin-oss/dds-tokens/js/daikin/Light/variables.js");
+const classVarianceAuthority = require("class-variance-authority");
+const lit = require("lit");
+const decorators_js = require("lit/decorators.js");
+const tailwind = require("../../tailwind.css.cjs");
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+const cvaButton = classVarianceAuthority.cva(
+  [
+    "inline-flex",
+    "justify-center",
+    "items-center",
+    "font-daikinSerif",
+    "font-bold",
+    "rounded-lg",
+    "tracking-wide",
+    "text-wrap",
+    "disabled:cursor-default",
+    "w-full",
+    "h-full"
+  ],
+  {
+    variants: {
+      intent: {
+        primary: [
+          "text-white",
+          "bg-[--buttonColorBackgroundPrimaryActive]",
+          "enabled:focus-visible:bg-[--buttonColorBackgroundPrimaryFocus]",
+          "enabled:hover:bg-[--buttonColorBackgroundPrimaryHover]",
+          "enabled:active:bg-[--buttonColorBackgroundPrimaryPress]",
+          "disabled:bg-[--buttonColorBackgroundPrimaryDisabled]",
+          "focus-visible:outline-none"
+        ],
+        secondary: [
+          "border-2",
+          "bg-white",
+          "text-daikinBlue-500",
+          "border-daikinBlue-500",
+          "enabled:hover:text-daikinBlue-300",
+          "enabled:hover:border-daikinBlue-300",
+          "enabled:active:text-daikinBlue-600",
+          "enabled:active:border-daikinBlue-600",
+          "enabled:focus-visible:text-daikinBlue-700",
+          "enabled:focus-visible:border-daikinBlue-700",
+          "disabled:border-daikinNeutral-300",
+          "disabled:text-daikinNeutral-400",
+          "disabled:border",
+          "focus-visible:outline-none"
+        ],
+        tertiary: [
+          "text-daikinBlue-400",
+          "bg-none",
+          "border-none",
+          "shadow-none",
+          "enabled:hover:bg-daikinNeutral-100",
+          "disabled:bg-transparent",
+          "disabled:text-daikinNeutral-400"
+        ],
+        primaryDanger: [
+          "bg-daikinRed",
+          "text-white",
+          "enabled:hover:bg-daikinRed-400",
+          "enabled:focus-visible:bg-daikinRed-700",
+          "enabled:active:bg-daikinRed-700",
+          "disabled:bg-daikinNeutral-300",
+          "focus-visible:outline-none"
+        ]
+      },
+      size: {
+        default: ["px-4", "text-[14px]"],
+        condensed: ["px-[10px]", "text-[12px]"]
+      }
+    },
+    defaultVariants: {
+      intent: "primary",
+      size: "condensed"
+    }
+  }
+);
+exports.DaikinButton = class DaikinButton extends lit.LitElement {
+  constructor() {
+    super(...arguments);
+    this.variant = "primary";
+    this.disabled = false;
+    this.rightIcon = "";
+    this.leftIcon = "";
+    this.href = "";
+    this.size = "default";
+    this.type = "button";
+    this.role = "button";
+    this.isLoading = false;
+  }
+  render() {
+    const buttonClassName = cvaButton({
+      intent: this.variant,
+      size: this.size
+    });
+    const content = lit.html`
+      <slot name="leftIcon"></slot>
+      <span><slot></slot></span>
+      <slot name="rightIcon"></slot>
+    `;
+    if (this.href) {
+      return lit.html` <a
+        href="${this.href}"
+        class="${buttonClassName}"
+        role="${this.role}"
+      >
+        ${content}
+      </a>`;
+    }
+    return lit.html`
+      <button
+        class="${buttonClassName}"
+        ?disabled="${this.disabled}"
+        type="${this.type}"
+        role="${this.role}"
+      >
+        ${content}
+      </button>
+    `;
+  }
+  focus(options) {
+    var _a, _b;
+    (_b = (_a = this.shadowRoot) == null ? void 0 : _a.querySelector("button")) == null ? void 0 : _b.focus(options);
+  }
+};
+exports.DaikinButton.styles = lit.css`
+    ${lit.unsafeCSS(tailwind.default)}
+
+    :host {
+      --buttonColorBackgroundPrimaryActive: ${lit.unsafeCSS(
+  variables_js.buttonColorBackgroundPrimaryActive
+)};
+      --buttonColorBackgroundPrimaryFocus: ${lit.unsafeCSS(
+  variables_js.buttonColorBackgroundPrimaryFocus
+)};
+      --buttonColorBackgroundPrimaryHover: ${lit.unsafeCSS(
+  variables_js.buttonColorBackgroundPrimaryHover
+)};
+      --buttonColorBackgroundPrimaryPress: ${lit.unsafeCSS(
+  variables_js.buttonColorBackgroundPrimaryPress
+)};
+      --buttonColorBackgroundPrimaryDisabled: ${lit.unsafeCSS(
+  variables_js.buttonColorBackgroundPrimaryDisabled
+)};
+
+      display: inline-block;
+      width: fit-content;
+      min-height: 42px;
+      height: 1px;
+    }
+
+    :host([size="condensed"]) {
+      min-height: 32px;
+    }
+  `;
+__decorateClass([
+  decorators_js.property({ type: String })
+], exports.DaikinButton.prototype, "variant", 2);
+__decorateClass([
+  decorators_js.property({ type: Boolean, reflect: true })
+], exports.DaikinButton.prototype, "disabled", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "rightIcon", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "leftIcon", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "href", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "size", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "type", 2);
+__decorateClass([
+  decorators_js.property({ type: String, reflect: true })
+], exports.DaikinButton.prototype, "role", 2);
+__decorateClass([
+  decorators_js.property({ type: Boolean })
+], exports.DaikinButton.prototype, "isLoading", 2);
+exports.DaikinButton = __decorateClass([
+  decorators_js.customElement("daikin-button")
+], exports.DaikinButton);

package/dist/cjs/components/button/daikin-button.d.ts

@@ -0,0 +1,59 @@
+import { LitElement } from 'lit';
+import { ARIARole } from '../../lit-analyzer-types';
+import { MergeVariantProps } from '../../type-utils';
+
+declare const cvaButton: (props?: ({
+    intent?: "primary" | "secondary" | "tertiary" | "primaryDanger" | null | undefined;
+    size?: "default" | "condensed" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+type ButtonVariantProps = MergeVariantProps<typeof cvaButton>;
+/**
+ * Primary UI component for user interaction
+ */
+export declare class DaikinButton extends LitElement {
+    static readonly styles: import('lit').CSSResult;
+    /**
+     * Type of variant.
+     */
+    variant: ButtonVariantProps["intent"];
+    /**
+     * `true` if the button should be disabled.
+     */
+    disabled: boolean;
+    /**
+     * Set a icon in the right of button label.
+     */
+    rightIcon: string;
+    /**
+     * Set a icon in the left of button label.
+     */
+    leftIcon: string;
+    /**
+     * Link `href`. If present, this button is rendered as `<a>`.
+     */
+    href: string;
+    /**
+     * Specify the button size.
+     */
+    size: ButtonVariantProps["size"];
+    /**
+     * Specify the button type.
+     */
+    type: "button" | "submit" | "reset";
+    /**
+     * Specify the button role.
+     */
+    role: ARIARole;
+    /**
+     * Specify whether the button is loading.
+     */
+    isLoading: boolean;
+    render(): import('lit-html').TemplateResult<1>;
+    focus(options?: FocusOptions | undefined): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "daikin-button": DaikinButton;
+    }
+}
+export {};

package/dist/cjs/components/button/index.d.ts

@@ -0,0 +1 @@
+export * from './daikin-button';