@scania/tegel 0.0.9 → 0.0.11

package/dist/collection/components/side-menu/side-menu.stories.js

@@ -0,0 +1,215 @@
+import { formatHtmlPreview } from '../../utils/utils';
+import readme from './readme.md';
+import readmeSideMenuUser from './side-menu-user/readme.md';
+import readmeSideMenuOverlay from './side-menu-overlay/readme.md';
+import readmeSideMenuCloseButton from './side-menu-close-button/readme.md';
+import readmeSideMenuCollapseButton from './side-menu-collapse-button/readme.md';
+import readmeSideMenuDropdown from './side-menu-dropdown/readme.md';
+import readmeSideMenuItem from './side-menu-item/readme.md';
+import readmeSideMenuDropdownList from './side-menu-dropdown-list/readme.md';
+import readmeSideMenuDropdownListItem from './side-menu-dropdown-list-item/readme.md';
+import { ComponentsFolder } from '../../utils/constants';
+export default {
+  title: `${ComponentsFolder}/Side Menu`,
+  parameters: {
+    notes: {
+      'Side Menu': readme,
+      'Side Menu Item': readmeSideMenuItem,
+      'Side Menu Dropdown': readmeSideMenuDropdown,
+      'Side Menu Dropdown List': readmeSideMenuDropdownList,
+      'Side Menu Dropdown List Item': readmeSideMenuDropdownListItem,
+      'Side Menu User': readmeSideMenuUser,
+      'Side Menu Collapse Button': readmeSideMenuCollapseButton,
+      'Side Menu Close Button': readmeSideMenuCloseButton,
+      'Side Menu Overlay': readmeSideMenuOverlay,
+    },
+    layout: 'fullscreen',
+    docs: {
+      source: {
+        state: 'closed',
+      },
+    },
+    design: [
+      {
+        name: 'Figma',
+        type: 'figma',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=11142%3A42941&t=Ne6myqwca5m00de7-1',
+      },
+      {
+        name: 'Link',
+        type: 'link',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=11142%3A42941&t=Ne6myqwca5m00de7-1',
+      },
+    ],
+  },
+  argTypes: {
+    persistent: {
+      name: 'Persistent',
+      description: 'Set the Side Menu to always show. This should be used if there are more navigation items to show than can always fit in the Header, more than three Header items is a good rule of thumb.',
+      control: {
+        type: 'boolean',
+      },
+    },
+    collapsible: {
+      name: 'Collapsible',
+      description: 'Make the Side Menu collapsible',
+      control: {
+        type: 'boolean',
+      },
+      if: { arg: 'persistent', truthy: true },
+    },
+  },
+  args: {
+    persistent: true,
+    collapsible: false,
+  },
+};
+const Template = ({ persistent, collapsible }) => formatHtmlPreview(`
+    <script>
+    /* For demonstration purposes only. Do this in the preferred way of your framework instead. */
+    window.demoSideMenu = document.querySelector('#demo-side-menu');
+  </script>
+  <style>
+    :root {
+      --app-bar-height: 64px;
+    }
+
+    /* Note: to make the layout fill the entire viewport height you'll need to set the */
+    /* height of the parent element and all of its ancestors to 100%. */
+    /* Please note that using 'vh' for this can cause issues on some mobile browsers. */
+    .demo-layout {
+      min-height: 100%;
+      display: flex;
+      flex-direction: column;
+    }
+    .demo-header {
+      position: sticky;
+      top: 0;
+    }
+    .demo-wrap-side-menu-and-main {
+      display: flex;
+      flex-grow: 1;
+    }
+    ${persistent
+  ? `
+        /* the lg breakpoint is used here to match the breakpoint used in the Header */
+    @media (min-width: 992px) {
+      #demo-side-menu {
+        /* We suggest you attach the persistent Side Menu to your layout like this: */
+        height: calc(100vh - var(--app-bar-height));
+        position: sticky;
+        top: var(--app-bar-height);
+        left: 0px;
+      }
+    }`
+  : ''}
+    /* If an extra button in the Header is required except on */
+    /* very narrow screens, you can use classes like these: */
+    .demo-hide {
+      display: none;
+    }
+
+    /* https://tegel.scania.com/components/header#:~:text=breakpoints%20larger%20than-,%24small%2D375.,-On%20smaller%20breakpoints */
+    @media (min-width: 375px) {
+      .demo-xs-hide {
+        display: none;
+      }
+      .demo-xs-show {
+        display: block;
+      }
+    }
+  </style>
+
+  <div class="demo-layout">
+    <tds-header class="demo-header">
+      <tds-header-hamburger onclick="demoSideMenu.open = true;" aria-expanded="false" aria-label="Open application drawer" aria-haspopup="true"></tds-header-hamburger>
+
+      <tds-header-title>
+        My Application
+      </tds-header-title>
+
+      <i style="color:white">Header items omitted for brevity. See patterns/navigation</i>
+
+      <tds-header-brand-symbol slot="end">
+        <a aria-label="Scania - red gryphon on blue shield" href="https://scania.com"></a>
+      </tds-header-brand-symbol>
+    </tds-header>
+
+    <div class="demo-wrap-side-menu-and-main">
+      <!-- Note: the "persistent" property keeps the menu open on desktop -->
+      <tds-side-menu aria-label="Side menu" id="demo-side-menu" ${persistent ? 'persistent' : ''}>
+        <tds-side-menu-overlay slot="overlay" onclick="demoSideMenu.open = false;"></tds-side-menu-overlay>
+
+        <tds-side-menu-close-button slot="close-button" aria-label="Close drawer menu" onclick="demoSideMenu.open = false;"></tds-side-menu-close-button>
+
+        <tds-side-menu-item>
+          <button>
+            <tds-icon name="timer" size="24"></tds-icon>
+            About us
+          </button>
+        </tds-side-menu-item>
+
+        <tds-side-menu-item>
+          <button>
+            <tds-icon name="truck" size="24"></tds-icon>
+            Trucks
+          </button>
+        </tds-side-menu-item>
+
+        <tds-side-menu-dropdown default-open selected>
+          <tds-icon slot="button-icon" name="profile" size="24"></tds-icon>
+          <span slot="button-label">
+            Wheel types
+          </span>
+          <tds-side-menu-dropdown-list>
+            <tds-side-menu-dropdown-list-item>
+              <a href="https://www.scania.com">
+                Hub-centric wheel
+              </a>
+            </tds-side-menu-dropdown-list-item>
+            <tds-side-menu-dropdown-list-item selected>
+              <a href="https://www.scania.com" aria-current="page">
+                Rim wheel
+              </a>
+            </tds-side-menu-dropdown-list-item>
+          </tds-side-menu-dropdown-list>
+        </tds-side-menu-dropdown>
+
+        <tds-side-menu-item>
+          <button>
+            <tds-icon name="star" size="24"></tds-icon>
+            Values
+          </button>
+        </tds-side-menu-item>
+
+        ${collapsible
+  ? `<tds-side-menu-collapse-button slot="sticky-end">
+          Collapse  
+        </tds-side-menu-collapse-button>`
+  : ''}
+
+      </tds-side-menu>
+
+      <main class="tds-u-h-100 tds-u-p3" style="box-sizing: border-box;">
+        <p>If there are more than a few buttons and/or links in the Header, they might not fit on medium size screens. 
+        <br/>In that case they should be placed in a persistent Side Menu — which is always visible on large screens.</p>
+
+        <p><i>Note: The Side Menu is sticky, and should not scroll with the main content of the page.</i></p>
+
+        <p><i>Note: The collapse button is optional.</i></p>
+        <button id="test">Toggle the collapsed state programatically</button>
+      </main>
+    </div>
+  </div>
+  <script>
+    sideMenu = document.querySelector('tds-side-menu')
+    document.querySelector('#test').addEventListener('click', ()=> {
+      sideMenu.collapsed = !sideMenu.collapsed;
+    })
+
+    document.querySelector('tds-side-menu-collapse-button').addEventListener('tdsCollapse', (event) => {
+      console.log(event)
+    })
+  </script>
+  `);
+export const Default = Template.bind({});

package/dist/collection/components/slider/slider.js

@@ -1,4 +1,5 @@
 import { h } from '@stencil/core';
+import { generateUniqueId } from '../../utils/utils';
 export class TdsSlider {
   constructor() {
     this.wrapperElement = null;
@@ -12,7 +13,6 @@ export class TdsSlider {
     this.scrubberGrabbed = false;
     this.scrubberLeft = 0;
     this.tickValues = [];
-    this.disabledState = false;
     this.readonlyState = false;
     this.useControls = false;
     this.useInput = false;
@@ -36,7 +36,7 @@ export class TdsSlider {
     this.name = '';
     this.scrubberSize = 'lg';
     this.snap = false;
-    this.sliderId = crypto.randomUUID();
+    this.sliderId = generateUniqueId();
   }
   /** Public method to re-initialise the slider if some configuration props are changed */
   async reset() {
@@ -297,7 +297,6 @@ export class TdsSlider {
       }
       this.tickValues.push(this.getMax());
     }
-    this.disabledState = this.disabled;
     this.readonlyState = this.readOnly;
     this.useInput = false;
     this.useControls = false;
@@ -307,27 +306,27 @@ export class TdsSlider {
     else if (this.input) {
       this.useInput = true;
     }
-    this.useSmall = false;
-    if (this.scrubberSize === 'sm') {
-      this.useSmall = true;
-    }
-    this.useSnapping = false;
-    if (this.snap) {
-      this.useSnapping = true;
-    }
+    this.useSmall = this.scrubberSize === 'sm';
+    this.useSnapping = this.snap;
     const min = this.getMin();
     const max = this.getMax();
     if (min > max) {
       console.warn('min-prop must have a higher value than max-prop for the component to work correctly.');
-      this.disabledState = true;
+      this.disabled = true;
     }
   }
   render() {
-    return (h("div", { class: `tds-slider-wrapper ${this.readonlyState ? 'read-only' : ''}` }, h("input", { class: "tds-slider-native-element", type: "range", value: this.value, name: this.name, min: this.min, max: this.max, disabled: this.disabled }), h("div", { class: `tds-slider ${this.disabledState ? 'disabled' : ''} ${this.useSmall ? 'tds-slider-small' : ''}`, ref: (el) => {
+    return (h("div", { class: `tds-slider-wrapper ${this.readonlyState ? 'read-only' : ''}` }, h("input", { class: "tds-slider-native-element", type: "range", value: this.value, name: this.name, min: this.min, max: this.max, disabled: this.disabled }), h("div", { class: {
+        'tds-slider': true,
+        'disabled': this.disabled,
+        'tds-slider-small': this.useSmall,
+      }, ref: (el) => {
         this.wrapperElement = el;
       } }, h("label", { class: this.showTickNumbers && 'offset' }, this.label), this.useInput && (h("div", { class: "tds-slider__input-values" }, h("div", { ref: (el) => {
         this.minusElement = el;
-      }, class: "tds-slider__input-value min-value" }, this.min))), this.useControls && (h("div", { class: "tds-slider__controls" }, h("div", { ref: (el) => (this.minusElement = el), class: "tds-slider__control tds-slider__control-minus" }, h("tds-icon", { name: "minus", size: "16px" })))), h("div", { class: "tds-slider-inner" }, this.tickValues.length > 0 && (h("div", { class: "tds-slider__value-dividers-wrapper" }, h("div", { class: "tds-slider__value-dividers" }, this.tickValues.map((value) => (h("div", { class: "tds-slider__value-divider" }, this.showTickNumbers && h("span", null, value))))))), h("div", { class: "tds-slider__track", ref: (el) => {
+      }, class: "tds-slider__input-value min-value" }, this.min))), this.useControls && (h("div", { class: "tds-slider__controls" }, h("div", { ref: (el) => {
+        this.minusElement = el;
+      }, class: "tds-slider__control tds-slider__control-minus" }, h("tds-icon", { name: "minus", size: "16px" })))), h("div", { class: "tds-slider-inner" }, this.tickValues.length > 0 && (h("div", { class: "tds-slider__value-dividers-wrapper" }, h("div", { class: "tds-slider__value-dividers" }, this.tickValues.map((value) => (h("div", { class: "tds-slider__value-divider" }, this.showTickNumbers && h("span", null, value))))))), h("div", { class: "tds-slider__track", ref: (el) => {
         this.trackElement = el;
       }, tabindex: this.disabled ? '-1' : '0' }, h("div", { class: "tds-slider__track-fill", ref: (el) => {
         this.trackFillElement = el;
@@ -344,7 +343,9 @@ export class TdsSlider {
         }
       }, size: this.calculateInputSizeFromMax(), class: "tds-slider__input-field", value: this.value, ref: (el) => {
         this.inputElement = el;
-      } })))), this.useControls && (h("div", { class: "tds-slider__controls" }, h("div", { ref: (el) => (this.plusElement = el), class: "tds-slider__control tds-slider__control-plus" }, h("tds-icon", { name: "plus", size: "16px" })))))));
+      } })))), this.useControls && (h("div", { class: "tds-slider__controls" }, h("div", { ref: (el) => {
+        this.plusElement = el;
+      }, class: "tds-slider__control tds-slider__control-plus" }, h("tds-icon", { name: "plus", size: "16px" })))))));
   }
   static get is() { return "tds-slider"; }
   static get originalStyleUrls() {
@@ -645,7 +646,7 @@ export class TdsSlider {
         },
         "attribute": "slider-id",
         "reflect": false,
-        "defaultValue": "crypto.randomUUID()"
+        "defaultValue": "generateUniqueId()"
       }
     };
   }

package/dist/collection/components/slider/slider.stories.js

@@ -0,0 +1,243 @@
+import { formatHtmlPreview } from '../../utils/utils';
+import readme from './readme.md';
+import { ComponentsFolder } from '../../utils/constants';
+export default {
+  title: `${ComponentsFolder}/Slider`,
+  argTypes: {
+    min: {
+      name: 'Min. value',
+      description: 'Sets the minimum value for the slider.',
+      control: {
+        type: 'number',
+      },
+      table: {
+        defaultValue: { summary: 0 },
+      },
+    },
+    max: {
+      name: 'Max. value',
+      description: 'Sets the maximum value for the slider.',
+      control: {
+        type: 'number',
+      },
+      table: {
+        defaultValue: { summary: 100 },
+      },
+    },
+    initialValue: {
+      name: 'Initial value',
+      description: 'Sets the initial value for the slider.',
+      control: {
+        type: 'number',
+      },
+      table: {
+        defaultValue: { summary: 0 },
+      },
+    },
+    showLabel: {
+      name: 'Show label',
+      description: 'Toggles if the lable should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+    },
+    labelText: {
+      name: 'Label text',
+      description: 'Sets the text for the label.',
+      control: {
+        type: 'text',
+      },
+      if: { arg: 'showLabel', eq: true },
+    },
+    showTicks: {
+      name: 'Show ticks',
+      description: 'Toggles if ticks should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+    },
+    numTicks: {
+      name: 'Number of ticks',
+      description: 'Sets the number of ticks to be displayed.',
+      control: {
+        type: 'number',
+      },
+      if: { arg: 'showTicks', eq: true },
+      table: {
+        defaultValue: { summary: 0 },
+      },
+    },
+    showTickNumbers: {
+      name: 'Show tick numbers',
+      description: 'Toggles if tick numbers should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+      if: { arg: 'showTicks', eq: true },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    snapToTicks: {
+      name: 'Snap to ticks',
+      description: 'Snaps the scrubber to the closest tick when dragging.',
+      control: {
+        type: 'boolean',
+      },
+      if: { arg: 'showTicks', eq: true },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    showTooltip: {
+      name: 'Show tooltip',
+      description: 'Toggles if the tooltip should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    showControls: {
+      name: 'Show controls (not compatible with input field)',
+      description: 'Toggles if controls should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    step: {
+      name: 'Step value',
+      description: 'Sets the value to increment/decrement with when using controls.',
+      control: {
+        type: 'number',
+      },
+      if: { arg: 'showControls', eq: true },
+      table: {
+        defaultValue: { summary: 1 },
+      },
+    },
+    showInput: {
+      name: 'Show value input field (not compatible with controls)',
+      description: 'Toggles if the values input field should be shown or hidden.',
+      control: {
+        type: 'boolean',
+      },
+      if: { arg: 'showControls', eq: false },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    scrubberSize: {
+      name: 'Scrubber size',
+      description: 'Switches between the large and small version of the scrubber.',
+      control: {
+        type: 'radio',
+      },
+      options: ['Large', 'Small'],
+      table: {
+        defaultValue: { summary: 'lg' },
+      },
+    },
+    readonly: {
+      name: 'Read Only',
+      description: 'Puts the control in a read-only state.',
+      control: {
+        type: 'boolean',
+      },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+    disabled: {
+      name: 'Disabled',
+      description: 'Disables the slider.',
+      control: {
+        type: 'boolean',
+      },
+      table: {
+        defaultValue: { summary: false },
+      },
+    },
+  },
+  parameters: {
+    notes: readme,
+    design: [
+      {
+        name: 'Figma',
+        type: 'figma',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=9649%3A20759&t=Ne6myqwca5m00de7-1',
+      },
+      {
+        name: 'Link',
+        type: 'link',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=9649%3A20759&t=Ne6myqwca5m00de7-1',
+      },
+    ],
+  },
+  args: {
+    min: '0',
+    max: '100',
+    initialValue: '50',
+    showLabel: false,
+    labelText: 'Label',
+    showTicks: false,
+    numTicks: '3',
+    showTickNumbers: false,
+    snapToTicks: false,
+    showTooltip: true,
+    showControls: false,
+    step: '1',
+    showInput: false,
+    scrubberSize: 'Large',
+    readonly: false,
+    disabled: false,
+  },
+};
+const sizeLookUp = {
+  Large: 'lg',
+  Small: 'sm',
+};
+const Template = ({ min, max, initialValue, showLabel, labelText, showTicks, numTicks, showTickNumbers, snapToTicks, showTooltip, showControls, step, showInput, scrubberSize, readonly, disabled, }) => formatHtmlPreview(`
+ <!-- Style code below is just for demo purposes -->
+    <style>
+      .demo-wrapper {
+          width: 500px;
+          margin-left: 150px;
+      }
+    </style>
+
+   <div class="demo-wrapper">
+     <tds-slider 
+        min="${min}"
+        max="${max}"
+        ${showControls && step ? `step="${step}"` : ''}
+        value="${initialValue}"
+        ${showTicks ? `ticks="${numTicks}"` : ''}
+        ${showTickNumbers ? 'show-tick-numbers' : ''}
+        ${snapToTicks ? 'snap' : ''}
+        ${showLabel ? `label="${labelText}"` : ''}
+        ${showTooltip ? 'tooltip' : ''}
+        ${showControls ? 'controls' : ''}
+        ${showInput ? 'input' : ''}
+        ${disabled ? 'disabled' : ''}
+        scrubber-size="${sizeLookUp[scrubberSize]}"
+        ${readonly ? 'read-only' : ''}
+        >
+      </tds-slider>
+    </div>
+
+     <!-- Script tag for demo purposes -->
+    <script>
+      slider = document.querySelector('tds-slider')
+
+      slider.removeEventListener('tdsChange', null)
+      slider.addEventListener('tdsChange', (event) => {
+        console.log(event);
+      });
+    </script>
+  `);
+export const Default = Template.bind({});

package/dist/collection/components/spinner/spinner.stories.js

@@ -0,0 +1,61 @@
+import { formatHtmlPreview } from '../../utils/utils';
+import readme from './readme.md';
+import { ComponentsFolder } from '../../utils/constants';
+export default {
+  title: `${ComponentsFolder}/Spinner`,
+  parameters: {
+    layout: 'centered',
+    notes: readme,
+    design: [
+      {
+        name: 'Figma',
+        type: 'figma',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=10259%3A29263&t=Ne6myqwca5m00de7-1',
+      },
+      {
+        name: 'Link',
+        type: 'link',
+        url: 'https://www.figma.com/file/d8bTgEx7h694MSesi2CTLF/Tegel-UI-Library?node-id=10259%3A29263&t=Ne6myqwca5m00de7-1',
+      },
+    ],
+  },
+  argTypes: {
+    variant: {
+      name: 'Variant',
+      description: 'Switches the variant of the Spinner.',
+      control: {
+        type: 'radio',
+      },
+      options: ['Standard', 'Inverted'],
+      table: {
+        defaultValue: { summary: 'standard' },
+      },
+    },
+    size: {
+      name: 'Size',
+      description: 'Sets the size of the Spinner.',
+      control: {
+        type: 'radio',
+      },
+      options: ['Large', 'Medium', 'Small', 'Extra small'],
+      table: {
+        defaultValue: { summary: 'lg' },
+      },
+    },
+  },
+  args: {
+    variant: 'Standard',
+    size: 'Large',
+  },
+};
+const Template = ({ size, variant }) => {
+  const sizeLookup = { 'Large': 'lg', 'Medium': 'md', 'Small': 'sm', 'Extra small': 'xs' };
+  const variantLookup = { Standard: 'standard', Inverted: 'inverted' };
+  return formatHtmlPreview(`
+  <tds-spinner 
+    size="${sizeLookup[size]}"  
+    variant="${variantLookup[variant]}">
+  </tds-spinner>
+  `);
+};
+export const Default = Template.bind({});

package/dist/collection/components/stepper/step/step.js

@@ -1,4 +1,7 @@
 import { Host, h } from '@stencil/core';
+/**
+ * @slot label - Slot for the label text.
+ */
 export class TdsStep {
   constructor() {
     this.index = undefined;

package/dist/collection/components/stepper/stepper.css

@@ -18,4 +18,7 @@
 }
 :host [role=list].vertical.sm {
   gap: 36px;
+}
+:host [role=list].horizontal.text-position-aside {
+  justify-content: unset;
 }

package/dist/collection/components/stepper/stepper.js

@@ -1,11 +1,15 @@
 import { Host, h } from '@stencil/core';
+import { generateUniqueId } from '../../utils/utils';
+/**
+ * @slot <default> - <b>Unnamed slot.</b> For the step elements.
+ */
 export class TdsStepper {
   constructor() {
     this.orientation = 'horizontal';
     this.labelPosition = 'below';
     this.size = 'lg';
     this.hideLabels = false;
-    this.stepperId = crypto.randomUUID();
+    this.stepperId = generateUniqueId();
   }
   componentWillLoad() {
     this.host.children[0].classList.add('first');
@@ -147,7 +151,7 @@ export class TdsStepper {
         },
         "attribute": "stepper-id",
         "reflect": false,
-        "defaultValue": "crypto.randomUUID()"
+        "defaultValue": "generateUniqueId()"
       }
     };
   }
@@ -168,7 +172,7 @@ export class TdsStepper {
           "references": {
             "InternalTdsStepperPropChange": {
               "location": "local",
-              "path": "/Users/martin.jarsater/Documents/scania/tegel/core/src/components/stepper/stepper.tsx"
+              "path": "/Users/johnny/dev/scania/tegel/core/src/components/stepper/stepper.tsx"
             }
           }
         }