@synergy-design-system/mcp 0.1.0 → 1.0.0

package/metadata/packages/components/components/syn-switch/component.vue

@@ -0,0 +1,178 @@
+<script setup lang="ts">
+// ---------------------------------------------------------------------
+// 🔒 AUTOGENERATED @synergy-design-system/vue wrappers for @synergy-design-system/components
+// Please do not edit this file directly!
+// It will get recreated when running pnpm build.
+// ---------------------------------------------------------------------
+
+/**
+ * @summary Switches allow the user to toggle an option on or off.
+ * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-switch--docs
+ * @status stable
+ * @since 2.0
+ *
+ * @slot - The switch's label.
+ * @slot help-text - Text that describes how to use the switch. Alternatively, you can use the `help-text` attribute.
+ *
+ * @event syn-blur - Emitted when the control loses focus.
+ * @event syn-change - Emitted when the control's checked state changes.
+ * @event syn-input - Emitted when the control receives input.
+ * @event syn-focus - Emitted when the control gains focus.
+ * @event syn-invalid - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+ *
+ * @csspart base - The component's base wrapper.
+ * @csspart control - The control that houses the switch's thumb.
+ * @csspart thumb - The switch's thumb.
+ * @csspart label - The switch's label.
+ * @csspart form-control-help-text - The help text's wrapper.
+ *
+ * @cssproperty --width - The width of the switch.
+ * @cssproperty --height - The height of the switch.
+ * @cssproperty --thumb-size - The size of the thumb.
+ */
+import { computed, ref } from 'vue';
+import '@synergy-design-system/components/components/switch/switch.js';
+
+import type { SynBlurEvent } from '@synergy-design-system/components';
+import type { SynChangeEvent } from '@synergy-design-system/components';
+import type { SynInputEvent } from '@synergy-design-system/components';
+import type { SynFocusEvent } from '@synergy-design-system/components';
+import type { SynInvalidEvent } from '@synergy-design-system/components';
+import type { SynSwitch } from '@synergy-design-system/components';
+
+// DOM Reference to the element
+const nativeElement = ref<SynSwitch>();
+
+defineExpose({
+  nativeElement,
+});
+
+// Map attributes
+const props = defineProps<{
+  title?: SynSwitch['title'];
+
+  /**
+   * The name of the switch, submitted as a name/value pair with form data.
+   */
+  name?: SynSwitch['name'];
+
+  /**
+   * The current value of the switch, submitted as a name/value pair with form data.
+   */
+  value?: SynSwitch['value'];
+
+  /**
+   * The switch's size.
+   */
+  size?: SynSwitch['size'];
+
+  /**
+   * Disables the switch.
+   */
+  disabled?: SynSwitch['disabled'];
+
+  /**
+   * Draws the switch in a checked state.
+   */
+  checked?: SynSwitch['checked'];
+
+  /**
+* By default, form controls are associated with the nearest containing `<form>` element.
+* This attribute allows you
+to place the form control outside of a form and associate it with the form that has this `id`.
+* The form must be in
+the same document or shadow root for this to work.
+ */
+  form?: SynSwitch['form'];
+
+  /**
+   * Makes the switch a required field.
+   */
+  required?: SynSwitch['required'];
+
+  /**
+   * The switch's help text.
+   * If you need to display HTML, use the `help-text` slot instead.
+   */
+  helpText?: SynSwitch['helpText'];
+
+  /**
+   * Support for two way data binding
+   */
+  modelValue?: SynSwitch['checked'];
+}>();
+
+// Make sure prop binding only forwards the props that are actually there.
+// This is needed because :param="param" also adds an empty attribute
+// when using web-components, which breaks optional arguments like size in SynInput
+// @see https://github.com/vuejs/core/issues/5190#issuecomment-1003112498
+const visibleProps = computed(() =>
+  Object.fromEntries(
+    Object.entries(props).filter(([, value]) => typeof value !== 'undefined'),
+  ),
+);
+
+// Map events
+defineEmits<{
+  /**
+   * Emitted when the control loses focus.
+   */
+  'syn-blur': [e: SynBlurEvent];
+
+  /**
+   * Emitted when the control's checked state changes.
+   */
+  'syn-change': [e: SynChangeEvent];
+
+  /**
+   * Emitted when the control receives input.
+   */
+  'syn-input': [e: SynInputEvent];
+
+  /**
+   * Emitted when the control gains focus.
+   */
+  'syn-focus': [e: SynFocusEvent];
+
+  /**
+   * Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+   */
+  'syn-invalid': [e: SynInvalidEvent];
+
+  /**
+   * Support for two way data binding
+   */
+  'update:modelValue': [newValue: SynSwitch['checked']];
+}>();
+</script>
+
+<script lang="ts">
+export type { SynBlurEvent } from '@synergy-design-system/components';
+export type { SynChangeEvent } from '@synergy-design-system/components';
+export type { SynInputEvent } from '@synergy-design-system/components';
+export type { SynFocusEvent } from '@synergy-design-system/components';
+export type { SynInvalidEvent } from '@synergy-design-system/components';
+</script>
+
+<template>
+  <syn-switch
+    @syn-blur="$emit('syn-blur', $event)"
+    @syn-change="$emit('syn-change', $event)"
+    @syn-input="
+      $emit('update:modelValue', ($event.target as SynSwitch).checked);
+      $emit('syn-input', $event);
+    "
+    @syn-focus="$emit('syn-focus', $event)"
+    @syn-invalid="$emit('syn-invalid', $event)"
+    :checked="
+      typeof props.modelValue !== 'undefined'
+        ? props.modelValue
+        : typeof props.checked !== 'undefined'
+          ? props.checked
+          : undefined
+    "
+    v-bind="visibleProps"
+    ref="nativeElement">
+    <slot></slot>
+  </syn-switch>
+</template>

package/metadata/packages/components/components/syn-tab/component.angular.ts

@@ -0,0 +1,109 @@
+// ---------------------------------------------------------------------
+// 🔒 AUTOGENERATED @synergy-design-system/angular wrappers for @synergy-design-system/components
+// Please do not edit this file directly!
+// It will get recreated when running pnpm build.
+// ---------------------------------------------------------------------
+import {
+  Component,
+  ElementRef,
+  NgZone,
+  Input,
+  Output,
+  EventEmitter,
+  AfterContentInit,
+} from '@angular/core';
+import type { SynTab } from '@synergy-design-system/components';
+import type { SynCloseEvent } from '@synergy-design-system/components';
+import '@synergy-design-system/components/components/tab/tab.js';
+
+/**
+ * @summary Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab panels](/components/tab-panel).
+ * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-tab--docs
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency syn-icon-button
+ *
+ * @slot - The tab's label.
+ *
+ * @event syn-close - Emitted when the tab is closable and the close button is activated.
+ *
+ * @csspart base - The component's base wrapper.
+ * @csspart close-button - The close button, an `<syn-icon-button>`.
+ * @csspart close-button__base - The close button's exported `base` part.
+ */
+@Component({
+  selector: 'syn-tab',
+  standalone: true,
+  template: '<ng-content></ng-content>',
+})
+export class SynTabComponent {
+  public nativeElement: SynTab;
+  private _ngZone: NgZone;
+
+  constructor(e: ElementRef, ngZone: NgZone) {
+    this.nativeElement = e.nativeElement;
+    this._ngZone = ngZone;
+    this.nativeElement.addEventListener('syn-close', (e: SynCloseEvent) => {
+      this.synCloseEvent.emit(e);
+    });
+  }
+
+  /**
+   * The name of the tab panel this tab is associated with.
+   * The panel must be located in the same tab group.
+   */
+  @Input()
+  set panel(v: SynTab['panel']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.panel = v));
+  }
+  get panel(): SynTab['panel'] {
+    return this.nativeElement.panel;
+  }
+
+  /**
+   * Draws the tab in an active state.
+   */
+  @Input()
+  set active(v: '' | SynTab['active']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.active = v === '' || v),
+    );
+  }
+  get active(): SynTab['active'] {
+    return this.nativeElement.active;
+  }
+
+  /**
+   * Makes the tab closable and shows a close button.
+   */
+  @Input()
+  set closable(v: '' | SynTab['closable']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.closable = v === '' || v),
+    );
+  }
+  get closable(): SynTab['closable'] {
+    return this.nativeElement.closable;
+  }
+
+  /**
+   * Disables the tab and prevents selection.
+   */
+  @Input()
+  set disabled(v: '' | SynTab['disabled']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.disabled = v === '' || v),
+    );
+  }
+  get disabled(): SynTab['disabled'] {
+    return this.nativeElement.disabled;
+  }
+
+  /**
+   * Emitted when the tab is closable and the close button is activated.
+   */
+  @Output() synCloseEvent = new EventEmitter<SynCloseEvent>();
+}
+
+export type { SynCloseEvent } from '@synergy-design-system/components';

package/metadata/packages/components/components/syn-tab/component.custom.styles.ts

@@ -0,0 +1,92 @@
+import { css } from 'lit';
+
+export default css`
+  /* Write custom CSS here */
+
+  :host {
+    --background-color: none;
+    --border-width: var(--syn-border-width-none);
+    --border-color: none;
+    --border-radius: var(--syn-border-radius-none);
+  }
+
+  .tab {
+    border-color: transparent;
+    border-radius: var(--border-radius);
+    border-style: solid;
+    border-width: var(--border-width);
+    color: var(--syn-typography-color-text);
+    font: var(--syn-body-small-bold);
+    min-height: var(--syn-spacing-2x-large);
+    padding: var(--syn-spacing-small) var(--syn-spacing-large);
+
+    /* Stretch the tabs so they are aligned to each other vertically and the focus width stays the same  */
+    width: 100%;
+  }
+
+
+  /** #429: Use token for opacity */
+  .tab.tab--disabled {
+    opacity: var(--syn-opacity-50);
+  }
+
+  /**
+   * Focus
+   */
+  :host(:focus-visible) {
+    outline-offset: calc(var(--syn-focus-ring-offset) * -1);
+  }
+
+  :host(:focus-visible:not(.tab--disabled)) {
+    color: var(--syn-typography-color-text);
+  }
+
+  @media (forced-colors: active) {
+    .tab.tab--active:not(.tab--disabled) {
+      outline-offset: calc(var(--syn-focus-ring-offset) * -1);
+    }
+  }
+
+  .tab:hover:not(.tab--disabled) {
+    color: var(--syn-color-primary-700);
+  }
+
+  .tab.tab--active:not(.tab--disabled) {
+    color: var(--syn-typography-color-text);
+  }
+
+
+  /**
+   * Closable
+   */
+  .tab.tab--closable {
+    padding: var(--syn-spacing-2x-small) var(--syn-spacing-large);
+  }
+
+  .tab__close-button {
+    color: var(--syn-color-neutral-500);
+    font-size: var(--syn-font-size-x-large);
+    margin-inline-start: var(--syn-spacing-2x-small);
+  }
+
+  .tab__close-button::part(base) {
+    padding: var(--syn-spacing-x-small);
+  }
+
+  .tab__close-button::part(base):hover {
+    color: var(--syn-color-primary-700);
+  }
+
+  .tab--active {
+    background-color: var(--background-color);
+    border-color: var(--border-color);
+    border-style: solid;
+    border-width: var(--border-width);
+  }
+
+  /* Slotted icon style */
+  .tab ::slotted(syn-icon) {
+    font-size: var(--syn-font-size-x-large);
+    margin-inline-end: var(--syn-spacing-x-small);
+  }
+`;

package/metadata/packages/components/components/syn-tab/component.react.ts

@@ -0,0 +1,42 @@
+// ---------------------------------------------------------------------
+// 🔒 AUTOGENERATED @synergy-design-system/react wrappers for @synergy-design-system/components
+// Please do not edit this file directly!
+// It will get recreated when running pnpm build.
+// ---------------------------------------------------------------------
+import * as React from 'react';
+import { createComponent } from '@lit/react';
+import Component from '@synergy-design-system/components/components/tab/tab.component.js';
+
+import { type EventName } from '@lit/react';
+import type { SynCloseEvent } from '@synergy-design-system/components';
+
+const tagName = 'syn-tab';
+Component.define('syn-tab');
+
+/**
+ * @summary Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab panels](/components/tab-panel).
+ * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-tab--docs
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency syn-icon-button
+ *
+ * @slot - The tab's label.
+ *
+ * @event syn-close - Emitted when the tab is closable and the close button is activated.
+ *
+ * @csspart base - The component's base wrapper.
+ * @csspart close-button - The close button, an `<syn-icon-button>`.
+ * @csspart close-button__base - The close button's exported `base` part.
+ */
+export const SynTab = createComponent({
+  displayName: 'SynTab',
+  elementClass: Component,
+  events: {
+    onSynClose: 'syn-close' as EventName<SynCloseEvent>,
+  },
+  react: React,
+  tagName,
+});
+
+export type { SynCloseEvent } from '@synergy-design-system/components';

package/metadata/packages/components/components/syn-tab/component.styles.ts

@@ -0,0 +1,77 @@
+/**
+ * ---------------------------------------------------------------------
+ * 🔒 AUTOGENERATED BY VENDORISM
+ * Removing this comment will prevent it from being managed by it.
+ * ---------------------------------------------------------------------
+ */
+
+/* eslint-disable */
+import { css } from 'lit';
+
+export default css`
+	/* stylelint-disable */
+  :host {
+    display: inline-block;
+  }
+
+  .tab {
+    display: inline-flex;
+    align-items: center;
+    font-family: var(--syn-font-sans);
+    font-size: var(--syn-font-size-small);
+    font-weight: var(--syn-font-weight-semibold);
+    border-radius: var(--syn-border-radius-medium);
+    color: var(--syn-color-neutral-600);
+    padding: var(--syn-spacing-medium) var(--syn-spacing-large);
+    white-space: nowrap;
+    user-select: none;
+    -webkit-user-select: none;
+    cursor: pointer;
+    transition:
+      var(--transition-speed) box-shadow,
+      var(--transition-speed) color;
+  }
+
+  .tab:hover:not(.tab--disabled) {
+    color: var(--syn-color-primary-600);
+  }
+
+  :host(:focus) {
+    outline: transparent;
+  }
+
+  :host(:focus-visible) {
+    color: var(--syn-color-primary-600);
+    outline: var(--syn-focus-ring);
+    outline-offset: calc(-1 * var(--syn-focus-ring-width) - var(--syn-focus-ring-offset));
+  }
+
+  .tab.tab--active:not(.tab--disabled) {
+    color: var(--syn-color-primary-600);
+  }
+
+  .tab.tab--closable {
+    padding-inline-end: var(--syn-spacing-small);
+  }
+
+  .tab.tab--disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+
+  .tab__close-button {
+    font-size: var(--syn-font-size-small);
+    margin-inline-start: var(--syn-spacing-small);
+  }
+
+  .tab__close-button::part(base) {
+    padding: var(--syn-spacing-3x-small);
+  }
+
+  @media (forced-colors: active) {
+    .tab.tab--active:not(.tab--disabled) {
+      outline: solid 1px transparent;
+      outline-offset: -3px;
+    }
+  }
+`;

package/metadata/packages/components/components/syn-tab/component.ts

@@ -0,0 +1,132 @@
+/**
+ * ---------------------------------------------------------------------
+ * 🔒 AUTOGENERATED BY VENDORISM
+ * Removing this comment will prevent it from being managed by it.
+ * ---------------------------------------------------------------------
+ */
+
+/* eslint-disable */
+import { classMap } from 'lit/directives/class-map.js';
+import { html } from 'lit';
+import { LocalizeController } from '../../utilities/localize.js';
+import { property, query } from 'lit/decorators.js';
+import { watch } from '../../internal/watch.js';
+import componentStyles from '../../styles/component.styles.js';
+import SynergyElement from '../../internal/synergy-element.js';
+import SynIconButton from '../icon-button/icon-button.component.js';
+import styles from './tab.styles.js';
+import customStyles from './tab.custom.styles.js';
+import type { CSSResultGroup } from 'lit';
+
+let id = 0;
+
+/**
+ * @summary Tabs are used inside [tab groups](/components/tab-group) to represent and activate [tab panels](/components/tab-panel).
+ * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-tab--docs
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency syn-icon-button
+ *
+ * @slot - The tab's label.
+ *
+ * @event syn-close - Emitted when the tab is closable and the close button is activated.
+ *
+ * @csspart base - The component's base wrapper.
+ * @csspart close-button - The close button, an `<syn-icon-button>`.
+ * @csspart close-button__base - The close button's exported `base` part.
+ */
+export default class SynTab extends SynergyElement {
+  static styles: CSSResultGroup = [componentStyles, styles, customStyles];
+  static dependencies = { 'syn-icon-button': SynIconButton };
+
+  private readonly localize = new LocalizeController(this);
+
+  private readonly attrId = ++id;
+  private readonly componentId = `syn-tab-${this.attrId}`;
+
+  @query('.tab') tab: HTMLElement;
+
+  /** The name of the tab panel this tab is associated with. The panel must be located in the same tab group. */
+  @property({ reflect: true }) panel = '';
+
+  /** Draws the tab in an active state. */
+  @property({ type: Boolean, reflect: true }) active = false;
+
+  /** Makes the tab closable and shows a close button. */
+  @property({ type: Boolean, reflect: true }) closable = false;
+
+  /** Disables the tab and prevents selection. */
+  @property({ type: Boolean, reflect: true }) disabled = false;
+
+  /**
+   * @internal
+   * Need to wrap in a `@property()` otherwise CustomElement throws a "The result must not have attributes" runtime error.
+   */
+  @property({ type: Number, reflect: true }) tabIndex = 0;
+
+  connectedCallback() {
+    super.connectedCallback();
+    this.setAttribute('role', 'tab');
+  }
+
+  private handleCloseClick(event: Event) {
+    event.stopPropagation();
+    this.emit('syn-close');
+  }
+
+  @watch('active')
+  handleActiveChange() {
+    this.setAttribute('aria-selected', this.active ? 'true' : 'false');
+  }
+
+  @watch('disabled')
+  handleDisabledChange() {
+    this.setAttribute('aria-disabled', this.disabled ? 'true' : 'false');
+
+    if (this.disabled && !this.active) {
+      this.tabIndex = -1;
+    } else {
+      this.tabIndex = 0;
+    }
+  }
+
+  render() {
+    // If the user didn't provide an ID, we'll set one so we can link tabs and tab panels with aria labels
+    this.id = this.id.length > 0 ? this.id : this.componentId;
+
+    return html`
+      <div
+        part="base"
+        class=${classMap({
+          tab: true,
+          'tab--active': this.active,
+          'tab--closable': this.closable,
+          'tab--disabled': this.disabled
+        })}
+      >
+        <slot></slot>
+        ${this.closable
+          ? html`
+              <syn-icon-button
+                part="close-button"
+                exportparts="base:close-button__base"
+                name="x-lg"
+                library="system"
+                label=${this.localize.term('close')}
+                class="tab__close-button"
+                @click=${this.handleCloseClick}
+                tabindex="-1"
+              ></syn-icon-button>
+            `
+          : ''}
+      </div>
+    `;
+  }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'syn-tab': SynTab;
+  }
+}