feat: split-button component (#814)

Split button component completed.

Closes #264

Co-authored-by: mehmetcan.boz <mehmetcan.boz@trendyol.com>
Co-authored-by: Erbil <erbilnas071@gmail.com>

commitlint.config.cjs

@@ -32,6 +32,7 @@ module.exports = {
         "popover",
         "notification",
         "table",
+        "split-button",
       ],
     ],
   },

src/baklava.ts

@@ -31,4 +31,5 @@ export { default as BlTableBody } from "./components/table/table-body/bl-table-b
 export { default as BlTableRow } from "./components/table/table-row/bl-table-row";
 export { default as BlTableHeaderCell } from "./components/table/table-header-cell/bl-table-header-cell";
 export { default as BlTableCell } from "./components/table/table-cell/bl-table-cell";
+export { default as BlSplitButton } from "./components/split-button/bl-split-button";
 export { getIconPath, setIconPath } from "./utilities/asset-paths";

src/components/dropdown/item/bl-dropdown-item.ts

@@ -5,6 +5,8 @@ import { event, EventDispatcher } from "../../../utilities/event";
 import "../../button/bl-button";
 import BlButton from "../../button/bl-button";
 import { BaklavaIcon } from "../../icon/icon-list";
+import type BlSplitButton from "../../split-button/bl-split-button";
+import { blSplitButtonTag } from "../../split-button/bl-split-button";
 import type BlDropdown from "../bl-dropdown";
 import { blDropdownTag } from "../bl-dropdown";
 import type BlDropdownGroup from "../group/bl-dropdown-group";
@@ -34,6 +36,7 @@ export default class BlDropdownItem extends LitElement {
 
   private _handleClick() {
     this.BlDropdownField?.close();
+    this.BlSplitButtonField?.close();
     this.onClick("Action clicked!");
   }
 
@@ -48,16 +51,18 @@ export default class BlDropdownItem extends LitElement {
 
   private BlDropdownGroupField: BlDropdownGroup | null;
   private BlDropdownField: BlDropdown | null;
+  private BlSplitButtonField: BlSplitButton | null;
 
   connectedCallback(): void {
     super.connectedCallback();
 
     this.BlDropdownGroupField = this.closest<BlDropdownGroup>(blDropdownGroupTag);
     this.BlDropdownField = this.closest<BlDropdown>(blDropdownTag);
+    this.BlSplitButtonField = this.closest<BlSplitButton>(blSplitButtonTag);
 
-    if (!this.BlDropdownField && !this.BlDropdownGroupField) {
+    if (!this.BlDropdownField && !this.BlDropdownGroupField && !this.BlSplitButtonField) {
       console.warn(
-        `bl-dropdown-item is designed to be used inside a ${blDropdownGroupTag} or ${blDropdownTag}`,
+        `bl-dropdown-item is designed to be used inside a ${blDropdownGroupTag}, ${blDropdownTag} or ${blSplitButtonTag}`,
         this
       );
     }

src/components/split-button/bl-split-button.css

@@ -0,0 +1,70 @@
+:host {
+  position: relative;
+  display: inline-block;
+}
+
+:host([kind="neutral"]) bl-popover {
+  --bl-popover-border-color: var(--bl-color-neutral-darker);
+}
+
+:host([kind="success"]) bl-popover {
+  --bl-popover-border-color: var(--bl-color-success);
+}
+
+:host([kind="danger"]) bl-popover {
+  --bl-popover-border-color: var(--bl-color-danger);
+}
+
+.split-button-container {
+  display: flex;
+}
+
+.split-main-button {
+  width: 100%;
+
+  --bl-border-radius-m: calc(var(--bl-size-xs) / 2) 0 0 calc(var(--bl-size-xs) / 2);
+}
+
+.split-main-button:focus {
+  --bl-border-radius-l: calc(var(--bl-size-m) / 2) 0 0 calc(var(--bl-size-m) / 2);
+}
+
+.dropdown-button {
+  --bl-border-radius-m: 0 calc(var(--bl-size-xs) / 2) calc(var(--bl-size-xs) / 2) 0;
+}
+
+.dropdown-button:focus {
+  --bl-border-radius-l: 0 calc(var(--bl-size-m) / 2) calc(var(--bl-size-m) / 2) 0;
+}
+
+:host([variant="secondary"]) .dropdown-button {
+  left: -1px;
+}
+
+:host([dropdown-disabled][variant="secondary"]) .dropdown-button {
+  left: 0;
+}
+
+.split-divider {
+  display: block;
+  height: var(--bl-size-2xl);
+  width: 1px;
+  background-color: var(--bl-color-neutral-full);
+}
+
+:host([variant="secondary"]) .split-divider {
+  display: none;
+}
+
+:host([size="small"]) .split-divider {
+  height: var(--bl-size-xl);
+}
+
+:host([size="large"]) .split-divider {
+  height: var(--bl-size-3xl);
+}
+
+:host([dropdown-disabled][disabled]) .split-divider {
+  display: block;
+  background-color: var(--bl-color-neutral-lighter);
+}

src/components/split-button/bl-split-button.stories.mdx

@@ -0,0 +1,184 @@
+import { html } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import { styleMap } from 'lit/directives/style-map.js';
+import { Meta, Canvas, ArgsTable, Story } from '@storybook/addon-docs';
+import { userEvent } from '@storybook/testing-library';
+
+<Meta
+  title="Components/Split Button"
+  component="bl-split-button"
+  argTypes={{
+    label: {
+      control: {
+        type: 'text'
+      }
+    },
+    variant: {
+      options: ['primary', 'secondary'],
+      default: 'primary',
+      control: { type: 'select' }
+    },
+    kind: {
+      options: ['default', 'neutral', 'success', 'danger'],
+      default: 'default',
+      control: { type: 'select' }
+    },
+    disabled: {
+      control: 'boolean'
+    },
+    dropdownDisabled: {
+      control: 'boolean'
+    },
+    size: {
+      options: ['large', 'medium', 'small'],
+      control: { type: 'select' }
+    }
+  }}
+/>
+
+export const dropdownOpener = async ({ canvasElement }) => {
+  const splitButton = canvasElement?.querySelector('bl-split-button')
+  if(splitButton.shadowRoot) {
+    const button = splitButton.shadowRoot.querySelector('#dropdown-button')
+    await userEvent.click(button);
+  }
+}
+
+export const SingleSplitButtonTemplate = (args) => html`<bl-split-button
+    variant=${ifDefined(args.variant)}
+    kind=${ifDefined(args.kind)}
+    size=${ifDefined(args.size)}
+    label="${ifDefined(args.label)}"
+    icon="${ifDefined(args.icon)}"
+    ?disabled=${args.disabled}
+    ?dropdown-disabled=${args.dropdownDisabled}
+    style=${ifDefined(args.styles ? styleMap(args.styles) : undefined)}
+    >
+      <bl-dropdown-group caption="Caption">
+        <bl-dropdown-item>${args.content || 'Action 1'}</bl-dropdown-item>
+        <bl-dropdown-item>Action 2</bl-dropdown-item>
+      </bl-dropdown-group>
+      <bl-dropdown-item>Action 3</bl-dropdown-item>
+      <bl-dropdown-item icon="info">Action 4</bl-dropdown-item>
+      <bl-dropdown-item>Action 5</bl-dropdown-item>
+      <bl-dropdown-group caption="Caption">
+        <bl-dropdown-item icon="heart">Action 6</bl-dropdown-item>
+        <bl-dropdown-item>Action 7</bl-dropdown-item>
+      </bl-dropdown-group>
+  </bl-split-button>`
+
+export const Template = (args) => html`
+${SingleSplitButtonTemplate({...args})}
+${SingleSplitButtonTemplate({variant: 'secondary', ...args})}`
+
+export const ButtonTypes = (args) => html`
+${SingleSplitButtonTemplate({...args})}
+${SingleSplitButtonTemplate({kind: 'neutral', ...args})}
+${SingleSplitButtonTemplate({kind: 'success', ...args})}
+${SingleSplitButtonTemplate({kind: 'danger', ...args})}`
+
+export const SizesTemplate = (args) => html`
+${SingleSplitButtonTemplate({size: 'large', ...args})}
+${SingleSplitButtonTemplate({size: 'medium', ...args})}
+${SingleSplitButtonTemplate({size: 'small', ...args})}`
+
+# Split Button
+
+<bl-badge icon="document">[ADR](https://github.com/Trendyol/baklava/issues/264#issuecomment-1927105000)</bl-badge>
+<bl-badge icon="puzzle">[Figma](https://www.figma.com/file/RrcLH0mWpIUy4vwuTlDeKN/Baklava-Design-Guide?type=design&node-id=2161-9122&mode=design)</bl-badge>
+
+Split Button component is very similar to Dropdown Component with a key difference: Split Button is a Dropdown that one action is put forward as the main action.
+
+<bl-alert variant="warning" icon>Inline styles in examples are only for **demo purposes**. Use regular CSS classes or tag selectors to set styles.</bl-alert>
+
+## Split Button Variants
+
+Split Button has the same variants ([Primary](/docs/components-button--primary-buttons), [Secondary](/docs/components-button--secondary-buttons)) with the [Button](/docs/components-button--variants).
+Every variant represents the importance of the actions inside it.
+
+<Canvas>
+  <Story name="Variants" args={{ label: 'Split Button' }} play={dropdownOpener}>
+    {Template.bind({})}
+  </Story>
+</Canvas>
+
+## Split Button Kinds
+
+Split Button has the same kinds as the button has.
+Every kind indicates a state of the split buttons. It can has 4 different "kind"s. `default`, `neutral`, `success` and `danger`.
+
+<Canvas>
+  <Story name="Kinds" args={{ label: 'Split Button' }} play={dropdownOpener}>
+    {ButtonTypes.bind({})}
+  </Story>
+</Canvas>
+
+## Split Button Sizes
+
+We have 3 sizes of split buttons: **Large**, **Medium**, **Small**. Default size is **Medium**.
+
+<Canvas>
+  <Story name="Split Button Sizes" args={{ label: 'Split Button' }} play={dropdownOpener}>
+    {SizesTemplate.bind({})}
+  </Story>
+</Canvas>
+
+If split button has an action with a long text that can not fit in a single line in dropdown, popover will be automatically widen to the right side of the split button.
+
+<Canvas>
+  <Story name="Automatic Left Align" args={{ label: 'Split Button', content: 'Action with very long text' }} play={dropdownOpener}>
+    {SingleSplitButtonTemplate.bind({})}
+  </Story>
+</Canvas>
+
+The split button is designed to automatically adjust its size to fit the space it's given. If there's a enough space, the main button of split button will stretch out to use that space.
+
+<Canvas>
+  <Story name="Block Level Buttons" args={{ label: 'Split Button', icon: 'info', styles: { width: "100%" } }}>
+    {SingleSplitButtonTemplate.bind({})}
+  </Story>
+</Canvas>
+
+## Split Button Icons
+
+You might want to add icons to your button.You can add icons to main button of split button.
+
+<Canvas>
+  <Story name="Icons" args={{ label: 'Split Button',icon:"account" }} play={dropdownOpener}>
+    {ButtonTypes.bind({})}
+  </Story>
+</Canvas>
+
+## Disabling Split Buttons
+
+We have 2 types of disabled split buttons: Disable version of Primary and Secondary buttons is the same.
+
+<Canvas columns={1}>
+  <Story name="Disabling Split Buttons" args={{ label: 'Split Button', disabled: true, dropdownDisabled:true }} play={dropdownOpener}>
+     {SingleSplitButtonTemplate.bind({})}
+  </Story>
+</Canvas>
+
+## Disabling Main Button
+
+We have 2 types of disabled split main buttons.
+
+<Canvas columns={1}>
+  <Story name="Disabling Primary Buttons" args={{ label: 'Split Button', disabled: true }} play={dropdownOpener}>
+     {Template.bind({})}
+  </Story>
+</Canvas>
+
+## Disabling Dropdown Button
+
+We have 2 types of disabled split dropdown buttons.
+
+<Canvas columns={1}>
+  <Story name="Disabling Dropdown Buttons" args={{ label: 'Split Button', dropdownDisabled:true }} play={dropdownOpener}>
+     {Template.bind({})}
+  </Story>
+</Canvas>
+
+## Reference
+
+<ArgsTable of="bl-split-button" />