@synergy-design-system/mcp 0.1.0 → 1.0.0

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

@@ -0,0 +1,441 @@
+// ---------------------------------------------------------------------
+// 🔒 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 { SynSelect } from '@synergy-design-system/components';
+import type { SynChangeEvent } from '@synergy-design-system/components';
+import type { SynClearEvent } from '@synergy-design-system/components';
+import type { SynInputEvent } from '@synergy-design-system/components';
+import type { SynFocusEvent } from '@synergy-design-system/components';
+import type { SynBlurEvent } from '@synergy-design-system/components';
+import type { SynShowEvent } from '@synergy-design-system/components';
+import type { SynAfterShowEvent } from '@synergy-design-system/components';
+import type { SynHideEvent } from '@synergy-design-system/components';
+import type { SynAfterHideEvent } from '@synergy-design-system/components';
+import type { SynInvalidEvent } from '@synergy-design-system/components';
+import '@synergy-design-system/components/components/select/select.js';
+
+/**
+ * @summary Selects allow you to choose items from a menu of predefined options.
+ * @documentation https://synergy-design-system.github.io/?path=/docs/components-syn-select--docs
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency syn-icon
+ * @dependency syn-popup
+ * @dependency syn-tag
+ *
+ * @slot - The listbox options. Must be `<syn-option>` elements. You can use `<syn-divider>` to group items visually.
+ * @slot label - The input's label. Alternatively, you can use the `label` attribute.
+ * @slot prefix - Used to prepend a presentational icon or similar element to the combobox.
+ * @slot suffix - Used to append a presentational icon or similar element to the combobox.
+ * @slot clear-icon - An icon to use in lieu of the default clear icon.
+ * @slot expand-icon - The icon to show when the control is expanded and collapsed. Rotates on open and close.
+ * @slot help-text - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.
+ *
+ * @event syn-change - Emitted when the control's value changes.
+ * @event syn-clear - Emitted when the control's value is cleared.
+ * @event syn-input - Emitted when the control receives input.
+ * @event syn-focus - Emitted when the control gains focus.
+ * @event syn-blur - Emitted when the control loses focus.
+ * @event syn-show - Emitted when the select's menu opens.
+ * @event syn-after-show - Emitted after the select's menu opens and all animations are complete.
+ * @event syn-hide - Emitted when the select's menu closes.
+ * @event syn-after-hide - Emitted after the select's menu closes and all animations are complete.
+ * @event syn-invalid - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+ *
+ * @csspart form-control - The form control that wraps the label, input, and help text.
+ * @csspart form-control-label - The label's wrapper.
+ * @csspart form-control-input - The select's wrapper.
+ * @csspart form-control-help-text - The help text's wrapper.
+ * @csspart combobox - The container the wraps the prefix, suffix, combobox, clear icon, and expand button.
+ * @csspart prefix - The container that wraps the prefix slot.
+ * @csspart suffix - The container that wraps the suffix slot.
+ * @csspart display-input - The element that displays the selected option's label, an `<input>` element.
+ * @csspart listbox - The listbox container where options are slotted.
+ * @csspart tags - The container that houses option tags when `multiselect` is used.
+ * @csspart tag - The individual tags that represent each multiselect option.
+ * @csspart tag__base - The tag's base part.
+ * @csspart tag__content - The tag's content part.
+ * @csspart tag__remove-button - The tag's remove button.
+ * @csspart tag__remove-button__base - The tag's remove button base part.
+ * @csspart clear-button - The clear button.
+ * @csspart expand-icon - The container that wraps the expand icon.
+ * @csspart popup - The popup's exported `popup` part. Use this to target the tooltip's popup container.
+ */
+@Component({
+  selector: 'syn-select',
+  standalone: true,
+  template: '<ng-content></ng-content>',
+})
+export class SynSelectComponent {
+  public nativeElement: SynSelect;
+  private _ngZone: NgZone;
+  private modelSignal = new AbortController();
+
+  constructor(e: ElementRef, ngZone: NgZone) {
+    this.nativeElement = e.nativeElement;
+    this._ngZone = ngZone;
+    this.nativeElement.addEventListener('syn-change', (e: SynChangeEvent) => {
+      this.synChangeEvent.emit(e);
+    });
+    this.nativeElement.addEventListener('syn-clear', (e: SynClearEvent) => {
+      this.synClearEvent.emit(e);
+    });
+    this.nativeElement.addEventListener('syn-input', (e: SynInputEvent) => {
+      this.synInputEvent.emit(e);
+    });
+    this.nativeElement.addEventListener('syn-focus', (e: SynFocusEvent) => {
+      this.synFocusEvent.emit(e);
+    });
+    this.nativeElement.addEventListener('syn-blur', (e: SynBlurEvent) => {
+      this.synBlurEvent.emit(e);
+    });
+    this.nativeElement.addEventListener('syn-show', (e: SynShowEvent) => {
+      this.synShowEvent.emit(e);
+    });
+    this.nativeElement.addEventListener(
+      'syn-after-show',
+      (e: SynAfterShowEvent) => {
+        this.synAfterShowEvent.emit(e);
+      },
+    );
+    this.nativeElement.addEventListener('syn-hide', (e: SynHideEvent) => {
+      this.synHideEvent.emit(e);
+    });
+    this.nativeElement.addEventListener(
+      'syn-after-hide',
+      (e: SynAfterHideEvent) => {
+        this.synAfterHideEvent.emit(e);
+      },
+    );
+    this.nativeElement.addEventListener('syn-invalid', (e: SynInvalidEvent) => {
+      this.synInvalidEvent.emit(e);
+    });
+    this.ngModelUpdateOn = 'syn-input';
+  }
+
+  /**
+   * The event that will trigger the ngModel update.
+   * By default, this is set to "syn-input".
+   */
+  @Input()
+  set ngModelUpdateOn(v: keyof HTMLElementEventMap) {
+    this.modelSignal.abort();
+    this.modelSignal = new AbortController();
+    const option = v || 'syn-input';
+    this.nativeElement.addEventListener(
+      option,
+      () => {
+        this.valueChange.emit(this.value);
+      },
+      {
+        signal: this.modelSignal.signal,
+      },
+    );
+  }
+  get ngModelUpdateOn(): keyof HTMLElementEventMap {
+    return this.ngModelUpdateOn;
+  }
+
+  /**
+* The delimiter to use when setting the value when `multiple` is enabled.
+The default is a space, but you can set it to a comma or other character.
+ */
+  @Input()
+  set delimiter(v: SynSelect['delimiter']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.delimiter = v));
+  }
+  get delimiter(): SynSelect['delimiter'] {
+    return this.nativeElement.delimiter;
+  }
+
+  /**
+   * The name of the select, submitted as a name/value pair with form data.
+   */
+  @Input()
+  set name(v: SynSelect['name']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.name = v));
+  }
+  get name(): SynSelect['name'] {
+    return this.nativeElement.name;
+  }
+
+  /**
+   * The select's size.
+   */
+  @Input()
+  set size(v: SynSelect['size']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.size = v));
+  }
+  get size(): SynSelect['size'] {
+    return this.nativeElement.size;
+  }
+
+  /**
+   * Placeholder text to show as a hint when the select is empty.
+   */
+  @Input()
+  set placeholder(v: SynSelect['placeholder']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.placeholder = v));
+  }
+  get placeholder(): SynSelect['placeholder'] {
+    return this.nativeElement.placeholder;
+  }
+
+  /**
+   * Allows more than one option to be selected.
+   */
+  @Input()
+  set multiple(v: '' | SynSelect['multiple']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.multiple = v === '' || v),
+    );
+  }
+  get multiple(): SynSelect['multiple'] {
+    return this.nativeElement.multiple;
+  }
+
+  /**
+* The maximum number of selected options to show when `multiple` is true.
+* After the maximum, "+n" will be shown to
+indicate the number of additional items that are selected.
+* Set to 0 to remove the limit.
+ */
+  @Input()
+  set maxOptionsVisible(v: SynSelect['maxOptionsVisible']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.maxOptionsVisible = v),
+    );
+  }
+  get maxOptionsVisible(): SynSelect['maxOptionsVisible'] {
+    return this.nativeElement.maxOptionsVisible;
+  }
+
+  /**
+   * Disables the select control.
+   */
+  @Input()
+  set disabled(v: '' | SynSelect['disabled']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.disabled = v === '' || v),
+    );
+  }
+  get disabled(): SynSelect['disabled'] {
+    return this.nativeElement.disabled;
+  }
+
+  /**
+   * Adds a clear button when the select is not empty.
+   */
+  @Input()
+  set clearable(v: '' | SynSelect['clearable']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.clearable = v === '' || v),
+    );
+  }
+  get clearable(): SynSelect['clearable'] {
+    return this.nativeElement.clearable;
+  }
+
+  /**
+* Indicates whether or not the select is open.
+* You can toggle this attribute to show and hide the menu, or you can
+use the `show()` and `hide()` methods and this attribute will reflect the select's open state.
+ */
+  @Input()
+  set open(v: '' | SynSelect['open']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.open = v === '' || v),
+    );
+  }
+  get open(): SynSelect['open'] {
+    return this.nativeElement.open;
+  }
+
+  /**
+* Enable this option to prevent the listbox from being clipped when the component is placed inside a container with
+`overflow: auto|scroll`.
+* Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.
+ */
+  @Input()
+  set hoist(v: '' | SynSelect['hoist']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.hoist = v === '' || v),
+    );
+  }
+  get hoist(): SynSelect['hoist'] {
+    return this.nativeElement.hoist;
+  }
+
+  /**
+   * The select's label.
+   * If you need to display HTML, use the `label` slot instead.
+   */
+  @Input()
+  set label(v: SynSelect['label']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.label = v));
+  }
+  get label(): SynSelect['label'] {
+    return this.nativeElement.label;
+  }
+
+  /**
+* The preferred placement of the select's menu.
+* Note that the actual placement may vary as needed to keep the listbox
+inside of the viewport.
+ */
+  @Input()
+  set placement(v: SynSelect['placement']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.placement = v));
+  }
+  get placement(): SynSelect['placement'] {
+    return this.nativeElement.placement;
+  }
+
+  /**
+   * The select's help text.
+   * If you need to display HTML, use the `help-text` slot instead.
+   */
+  @Input()
+  set helpText(v: SynSelect['helpText']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.helpText = v));
+  }
+  get helpText(): SynSelect['helpText'] {
+    return this.nativeElement.helpText;
+  }
+
+  /**
+* 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.
+ */
+  @Input()
+  set form(v: SynSelect['form']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.form = v));
+  }
+  get form(): SynSelect['form'] {
+    return this.nativeElement.form;
+  }
+
+  /**
+   * The select's required attribute.
+   */
+  @Input()
+  set required(v: '' | SynSelect['required']) {
+    this._ngZone.runOutsideAngular(
+      () => (this.nativeElement.required = v === '' || v),
+    );
+  }
+  get required(): SynSelect['required'] {
+    return this.nativeElement.required;
+  }
+
+  /**
+* A function that customizes the tags to be rendered when multiple=true.
+* The first argument is the option, the second
+is the current tag's index.
+* The function should return either a Lit TemplateResult or a string containing trusted HTML of the symbol to render at
+the specified value.
+ */
+  @Input()
+  set getTag(v: SynSelect['getTag']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.getTag = v));
+  }
+  get getTag(): SynSelect['getTag'] {
+    return this.nativeElement.getTag;
+  }
+
+  /**
+* The current value of the select, submitted as a name/value pair with form data.
+* When `multiple` is enabled, the
+value attribute will be a space-delimited list of values based on the options selected, and the value property will
+be an array.
+* **For this reason, values must not contain spaces.**
+ */
+  @Input()
+  set value(v: SynSelect['value']) {
+    this._ngZone.runOutsideAngular(() => (this.nativeElement.value = v));
+  }
+  get value(): SynSelect['value'] {
+    return this.nativeElement.value;
+  }
+
+  /**
+   * Emitted when the control's value changes.
+   */
+  @Output() synChangeEvent = new EventEmitter<SynChangeEvent>();
+
+  /**
+   * Emitted when the control's value is cleared.
+   */
+  @Output() synClearEvent = new EventEmitter<SynClearEvent>();
+
+  /**
+   * Emitted when the control receives input.
+   */
+  @Output() synInputEvent = new EventEmitter<SynInputEvent>();
+
+  /**
+   * Emitted when the control gains focus.
+   */
+  @Output() synFocusEvent = new EventEmitter<SynFocusEvent>();
+
+  /**
+   * Emitted when the control loses focus.
+   */
+  @Output() synBlurEvent = new EventEmitter<SynBlurEvent>();
+
+  /**
+   * Emitted when the select's menu opens.
+   */
+  @Output() synShowEvent = new EventEmitter<SynShowEvent>();
+
+  /**
+   * Emitted after the select's menu opens and all animations are complete.
+   */
+  @Output() synAfterShowEvent = new EventEmitter<SynAfterShowEvent>();
+
+  /**
+   * Emitted when the select's menu closes.
+   */
+  @Output() synHideEvent = new EventEmitter<SynHideEvent>();
+
+  /**
+   * Emitted after the select's menu closes and all animations are complete.
+   */
+  @Output() synAfterHideEvent = new EventEmitter<SynAfterHideEvent>();
+
+  /**
+   * Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+   */
+  @Output() synInvalidEvent = new EventEmitter<SynInvalidEvent>();
+
+  /**
+   * Support for two way data binding
+   */
+  @Output() valueChange = new EventEmitter<SynSelect['value']>();
+}
+
+export type { SynChangeEvent } from '@synergy-design-system/components';
+export type { SynClearEvent } from '@synergy-design-system/components';
+export type { SynInputEvent } from '@synergy-design-system/components';
+export type { SynFocusEvent } from '@synergy-design-system/components';
+export type { SynBlurEvent } from '@synergy-design-system/components';
+export type { SynShowEvent } from '@synergy-design-system/components';
+export type { SynAfterShowEvent } from '@synergy-design-system/components';
+export type { SynHideEvent } from '@synergy-design-system/components';
+export type { SynAfterHideEvent } from '@synergy-design-system/components';
+export type { SynInvalidEvent } from '@synergy-design-system/components';

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

@@ -0,0 +1,176 @@
+import { css } from 'lit';
+import sharedOptionSize from '../option/option-size.styles.js';
+
+export default css`
+  /** #429: Use token for opacity */
+  .select--standard.select--disabled .select__combobox {
+    opacity: var(--syn-input-disabled-opacity);
+  }
+
+  /**
+   * Invalid user data
+   */
+  :host([data-user-invalid]) .select__combobox {
+    border-color: var(--syn-input-border-color-focus-error);
+  }
+
+  :host([data-user-invalid]) .select--standard:not(.select--disabled).select--open .select__combobox,
+  :host([data-user-invalid]) .select--standard:not(.select--disabled).select--focused .select__combobox {
+    border-color: var(--syn-input-border-color-focus-error);
+    box-shadow: 0 0 0 var(--syn-focus-ring-width) var(--syn-input-focus-ring-error);
+  }
+
+  /* Clear button */
+  .select__clear {
+    color: var(--syn-input-icon-icon-clearable-color);
+    font-size: var(--syn-spacing-large);
+  }
+
+  .select--small .select__clear {
+    font-size: var(--syn-spacing-medium);
+  }
+
+  .select--large .select__clear {
+    font-size: var(--syn-spacing-x-large);
+  }
+
+  .select--medium .select__clear {
+    margin-inline-start: var(--syn-spacing-small);
+  }
+
+  /* Expand icon */
+  .select__expand-icon {
+    color: var(--syn-color-neutral-950);
+    margin-inline-start: var(--syn-spacing-small);
+  }
+
+  .select--small .select__expand-icon {
+    font-size: var(--syn-spacing-medium);
+  }
+
+  .select--medium .select__expand-icon {
+    font-size: var(--syn-spacing-large);
+  }
+
+  .select--large .select__expand-icon {
+    font-size: var(--syn-spacing-x-large);
+  }
+
+  /* Change select border on hover */
+  /* stylelint-disable-next-line no-descending-specificity */
+  .select:not(.select--disabled):hover .select__combobox {
+    border-color: var(--syn-input-color-hover);
+  }
+
+  /* Prefix and Suffix */
+
+  /* Small */
+  .select--small .select__prefix::slotted(*) {
+    margin-inline-end: var(--syn-spacing-x-small);
+  }
+
+  .select--small .select__suffix::slotted(*) {
+    margin-inline-start: var(--syn-spacing-x-small);
+  }
+
+  .select--small .select__suffix::slotted(syn-icon),
+  .select--small .select__prefix::slotted(syn-icon) {
+    font-size: var(--syn-font-size-medium);
+  }
+
+  /* Medium */
+  .select--medium .select__prefix::slotted(*) {
+    margin-inline-end: var(--syn-input-spacing-small);
+  }
+
+  .select--medium .select__suffix::slotted(*) {
+    margin-inline-start: var(--syn-input-spacing-small);
+  }
+
+  .select--medium .select__suffix::slotted(syn-icon),
+  .select--medium .select__prefix::slotted(syn-icon) {
+    font-size: var(--syn-font-size-x-large);
+  }
+
+  /* Large */
+  .select--large .select__prefix::slotted(*) {
+    margin-inline-end: var(--syn-input-spacing-medium);
+  }
+
+  .select--large .select__suffix::slotted(*) {
+    margin-inline-start: var(--syn-input-spacing-medium);
+  }
+
+  .select--large .select__suffix::slotted(syn-icon),
+  .select--large .select__prefix::slotted(syn-icon) {
+    font-size: var(--syn-font-size-2x-large);
+  }
+
+
+  .select__prefix,
+  .select__suffix {
+    color: var(--syn-input-help-text-color);
+  }
+
+  /* Multi Select */
+  .select__tags {
+    margin-inline-start: var(--syn-spacing-medium);
+  }
+
+  .select--small .select__tags {
+    gap: var(--syn-spacing-2x-small);
+  }
+
+  .select--medium .select__tags {
+    gap: var(--syn-spacing-x-small);
+  }
+
+  .select--large .select__tags {
+    gap: var(--syn-spacing-small);
+  }
+
+  /* Listbox */
+  .select__listbox {
+    /* @todo: Should be --syn-border-radius-medium, which should be set to 0 */
+    border-radius: var(--syn-border-radius-none);
+    box-shadow: var(--syn-shadow-medium);
+  }
+
+  /**
+   * Make sure to hide the syn-divider for the first syn-optgroup
+   * Note! ::slotted does currently not work with ::part, so we
+   * opted for using a css variable here.
+   */
+  .select__listbox ::slotted(syn-optgroup:first-of-type) {
+    --display-divider: none;
+  }
+
+  /**
+   * #850: Allow to measure the size of the combobox.
+   * This is needed so we can automatically size and truncate the tags in the <syn-select multiple> component.
+   * Scoped to multiple to not break the single select per accident.
+   */
+  :host([multiple]) .select__tags {
+    min-width: 100px;
+    overflow: hidden;
+  }
+
+  :host([multiple]) .select__tags > div {
+    display: contents;
+  }
+
+  :host([multiple]) .select__tags > div > syn-tag {
+    --syn-tag-position-adjustment: var(--syn-spacing-3x-small);
+
+    max-width: var(--syn-select-tag-max-width);
+  }
+
+  :host([multiple]) .select__tags > div > syn-tag::part(content) {
+    display: initial;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  ${sharedOptionSize}
+`;