@sellmate/design-system 1.17.0 → 1.19.0

package/dist/collection/components/sd-chip-input/sd-chip-input.js

@@ -1,8 +1,9 @@
 import { h, } from "@stencil/core";
 import { nanoid } from "nanoid/non-secure";
-import { CHIP_INPUT_SIZE_MAP, CHIP_INPUT_COLORS, CHIP_INPUT_LAYOUT, CHIP_INPUT_RESET, } from "./sd-chip-input.config";
+import { CHIP_INPUT_SIZE_MAP, CHIP_INPUT_COLORS, CHIP_INPUT_LAYOUT, CHIP_INPUT_RESET, CHIP_INPUT_MAX_COUNT, CHIP_INPUT_SUGGESTIONS, } from "./sd-chip-input.config";
 import { CHIP_LAYOUT, CHIP_COLORS, CHIP_TYPOGRAPHY } from "../sd-chip/sd-chip.config";
 export class SdChipInput {
+    static SUGGESTIONS_VIEWPORT_PADDING = 8;
     host;
     values = [];
     errors = [];
@@ -14,6 +15,12 @@ export class SdChipInput {
     rules = [];
     error = false;
     useReset = false;
+    maxCount;
+    duplicateLabel;
+    suggestions = [];
+    loadingSuggestions = false;
+    recommendedItems = [];
+    loadingRecommendedItems = false;
     // sd-field props
     label = '';
     labelWidth = '';
@@ -29,8 +36,12 @@ export class SdChipInput {
     focused = false;
     hovered = false;
     inputValue = '';
+    activeSuggestionIndex = -1;
+    suppressSuggestions = false;
+    suppressRecommendations = false;
     inputEl;
     formField;
+    chipInputRef;
     get value() {
         return this.internalValues;
     }
@@ -42,6 +53,22 @@ export class SdChipInput {
             this.internalErrors = [...newErrors];
         }
     }
+    internalValuesChanged_validate() {
+        if (typeof this.formField?.sdValidate === 'function') {
+            this.formField.sdValidate();
+        }
+    }
+    suggestionsChanged(newVal) {
+        if (!Array.isArray(newVal))
+            this.suggestions = [];
+        this.activeSuggestionIndex = -1;
+        this.suppressSuggestions = false;
+    }
+    recommendedItemsChanged(newVal) {
+        if (!Array.isArray(newVal))
+            this.recommendedItems = [];
+        this.activeSuggestionIndex = -1;
+    }
     componentWillLoad() {
         this.internalValues = Array.isArray(this.values) ? [...this.values] : [];
         if (Array.isArray(this.errors)) {
@@ -49,7 +76,13 @@ export class SdChipInput {
         }
         this.inputValue = this.inputValue ?? '';
     }
+    isDuplicateChip(index) {
+        const value = this.internalValues[index];
+        return this.internalValues.indexOf(value) !== index;
+    }
     getChipError(index) {
+        if (this.isDuplicateChip(index))
+            return true;
         if (typeof this.errors === 'function') {
             return this.errors(this.internalValues?.[index] ?? '');
         }
@@ -66,6 +99,7 @@ export class SdChipInput {
     update;
     focusEvent;
     blurEvent;
+    inputEvent;
     async sdValidate() {
         return this.formField?.sdValidate();
     }
@@ -78,6 +112,31 @@ export class SdChipInput {
     async sdFocus() {
         return this.formField?.sdFocus();
     }
+    addChip = (value) => {
+        if (this.maxCount != null && this.internalValues.length >= this.maxCount)
+            return;
+        const next = [...this.internalValues, value];
+        this.internalValues = next;
+        this.values = next;
+        if (Array.isArray(this.errors)) {
+            const nextErrors = [...this.internalErrors, false];
+            this.internalErrors = nextErrors;
+            this.errors = nextErrors;
+        }
+        if (Array.isArray(this.disabledChips)) {
+            this.disabledChips = [...this.disabledChips, false];
+        }
+        if (this.inputEl != null) {
+            this.inputEl.value = '';
+        }
+        this.inputValue = '';
+        this.activeSuggestionIndex = -1;
+        this.suppressSuggestions = true;
+        this.update.emit(next);
+        this.inputEvent.emit('');
+        this.inputEl?.focus();
+        this.suppressRecommendations = true;
+    };
     handleChipRemove = (index) => {
         const next = this.internalValues.filter((_, i) => i !== index);
         this.internalValues = next;
@@ -91,26 +150,54 @@ export class SdChipInput {
             this.disabledChips = this.disabledChips.filter((_, i) => i !== index);
         }
         this.update.emit(next);
+        // .focus()는 동기 실행 → handleFocus가 suppressRecommendations=false로 리셋하므로 이후 덮어씀
         this.inputEl?.focus();
+        this.suppressRecommendations = true;
     };
     handleKeyDown = (event) => {
         const input = event.target;
-        if (event.key === 'Enter' && !event.isComposing && input.value.trim() !== '') {
-            event.preventDefault();
-            const next = [...this.internalValues, input.value.trim()];
-            this.internalValues = next;
-            this.values = next;
-            if (Array.isArray(this.errors)) {
-                const nextErrors = [...this.internalErrors, false];
-                this.internalErrors = nextErrors;
-                this.errors = nextErrors;
+        const suggestions = this.suggestions ?? [];
+        const recommendedItems = this.recommendedItems ?? [];
+        const showAutocomplete = this.focused &&
+            this.inputValue !== '' &&
+            !this.suppressSuggestions &&
+            (suggestions.length > 0 || this.loadingSuggestions);
+        const showRecommendations = this.focused &&
+            this.inputValue === '' &&
+            !this.suppressRecommendations &&
+            (recommendedItems.length > 0 || this.loadingRecommendedItems);
+        const showDropdown = showAutocomplete || showRecommendations;
+        const activeItems = showAutocomplete ? suggestions : recommendedItems;
+        if (showDropdown) {
+            if (event.key === 'ArrowDown') {
+                event.preventDefault();
+                this.activeSuggestionIndex = Math.min(this.activeSuggestionIndex + 1, activeItems.length - 1);
+                return;
             }
-            if (Array.isArray(this.disabledChips)) {
-                this.disabledChips = [...this.disabledChips, false];
+            if (event.key === 'ArrowUp') {
+                event.preventDefault();
+                this.activeSuggestionIndex = Math.max(this.activeSuggestionIndex - 1, -1);
+                return;
             }
-            input.value = '';
-            this.inputValue = '';
-            this.update.emit(next);
+            if (event.key === 'Escape') {
+                if (showAutocomplete)
+                    this.suppressSuggestions = true;
+                if (showRecommendations)
+                    this.suppressRecommendations = true;
+                this.activeSuggestionIndex = -1;
+                return;
+            }
+            if (event.key === 'Enter' && this.activeSuggestionIndex >= 0) {
+                event.preventDefault();
+                this.addChip(activeItems[this.activeSuggestionIndex]);
+                return;
+            }
+        }
+        if (event.key === 'Enter' && !event.isComposing && input.value.trim() !== '') {
+            if (this.maxCount != null && this.internalValues.length >= this.maxCount)
+                return;
+            event.preventDefault();
+            this.addChip(input.value.trim());
         }
         else if (event.key === 'Backspace' && input.value === '' && this.internalValues.length > 0) {
             if (this.getChipDisabled(this.internalValues.length - 1))
@@ -131,16 +218,35 @@ export class SdChipInput {
         }
     };
     handleInput = (event) => {
-        this.inputValue = event.target.value;
+        const value = event.target.value;
+        const wasEmpty = this.inputValue === '';
+        const isEmpty = value === '';
+        if (wasEmpty !== isEmpty) {
+            this.activeSuggestionIndex = -1;
+            if (isEmpty) {
+                this.suppressRecommendations = false;
+            }
+        }
+        this.inputValue = value;
+        this.suppressSuggestions = false;
+        this.inputEvent.emit(value);
     };
     handleFocus = () => {
         this.focused = true;
+        this.suppressRecommendations = false;
         this.focusEvent.emit();
     };
     handleBlur = () => {
         this.focused = false;
+        this.activeSuggestionIndex = -1;
         this.blurEvent.emit();
     };
+    closeSuggestions = () => {
+        this.focused = false;
+        this.activeSuggestionIndex = -1;
+        this.suppressSuggestions = true;
+        this.suppressRecommendations = true;
+    };
     handleContainerClick = () => {
         if (!this.disabled) {
             this.inputEl?.focus();
@@ -170,6 +276,18 @@ export class SdChipInput {
         this.update.emit(next);
         this.inputEl?.focus();
     };
+    duplicateRule = () => {
+        const seen = new Set();
+        for (const val of this.internalValues) {
+            if (seen.has(val)) {
+                if (this.duplicateLabel != null && this.duplicateLabel !== '')
+                    return `이미 입력된 ${this.duplicateLabel}입니다.`;
+                return '중복된 값이 존재합니다.';
+            }
+            seen.add(val);
+        }
+        return true;
+    };
     render() {
         const sizeTokens = CHIP_INPUT_SIZE_MAP[this.size] ?? CHIP_INPUT_SIZE_MAP.sm;
         const cssVars = {
@@ -197,8 +315,84 @@ export class SdChipInput {
             '--sd-chip-input-field-font-weight': CHIP_TYPOGRAPHY.focus.fontWeight,
             '--sd-chip-input-field-line-height': CHIP_TYPOGRAPHY.focus.lineHeight,
             '--sd-chip-input-field-font-family': CHIP_TYPOGRAPHY.focus.fontFamily,
+            '--sd-chip-input-max-count-font-size': CHIP_INPUT_MAX_COUNT.fontSize,
+            '--sd-chip-input-max-count-font-weight': CHIP_INPUT_MAX_COUNT.fontWeight,
+            '--sd-chip-input-max-count-color': CHIP_INPUT_MAX_COUNT.color,
+            '--sd-chip-input-suggestions-radius': CHIP_INPUT_SUGGESTIONS.radius,
+            '--sd-chip-input-suggestions-max-height': CHIP_INPUT_SUGGESTIONS.maxHeight,
+            '--sd-chip-input-suggestion-padding-y': CHIP_INPUT_SUGGESTIONS.itemPaddingY,
+            '--sd-chip-input-suggestion-padding-x': CHIP_INPUT_SUGGESTIONS.itemPaddingX,
+            '--sd-chip-input-suggestion-padding-right': CHIP_INPUT_SUGGESTIONS.itemPaddingRight,
+            '--sd-chip-input-suggestion-gap': CHIP_INPUT_SUGGESTIONS.itemGap,
+            '--sd-chip-input-suggestion-font-size': CHIP_INPUT_SUGGESTIONS.itemFontSize,
+            '--sd-chip-input-suggestion-font-weight': CHIP_INPUT_SUGGESTIONS.itemFontWeight,
+            '--sd-chip-input-suggestion-font-weight-selected': CHIP_INPUT_SUGGESTIONS.itemFontWeightSelected,
+            '--sd-chip-input-suggestion-line-height': CHIP_INPUT_SUGGESTIONS.itemLineHeight,
+            '--sd-chip-input-suggestion-font-family': CHIP_INPUT_SUGGESTIONS.itemFontFamily,
+            '--sd-chip-input-suggestion-color': CHIP_INPUT_SUGGESTIONS.itemColor,
+            '--sd-chip-input-suggestion-color-hover': CHIP_INPUT_SUGGESTIONS.itemColorHover,
+            '--sd-chip-input-suggestion-bg-hover': CHIP_INPUT_SUGGESTIONS.itemBgHover,
+            '--sd-chip-input-suggestions-empty-color': CHIP_INPUT_SUGGESTIONS.emptyColor,
+            '--sd-chip-input-suggestions-empty-font-size': CHIP_INPUT_SUGGESTIONS.emptyFontSize,
+            '--sd-chip-input-suggestions-empty-line-height': CHIP_INPUT_SUGGESTIONS.emptyLineHeight,
+        };
+        const isMaxReached = this.maxCount != null && this.internalValues.length >= this.maxCount;
+        const showResetArea = (this.useReset && this.internalValues.length > 0) || this.maxCount != null;
+        const suggestions = this.suggestions ?? [];
+        const recommendedItems = this.recommendedItems ?? [];
+        const showAutocomplete = this.focused &&
+            this.inputValue !== '' &&
+            !this.suppressSuggestions &&
+            (suggestions.length > 0 || this.loadingSuggestions);
+        const showRecommendations = this.focused &&
+            this.inputValue === '' &&
+            !this.suppressRecommendations &&
+            (recommendedItems.length > 0 || this.loadingRecommendedItems);
+        const showDropdown = showAutocomplete || showRecommendations;
+        const dropdownItems = showAutocomplete ? suggestions : recommendedItems;
+        const isDropdownLoading = showAutocomplete
+            ? this.loadingSuggestions && suggestions.length === 0
+            : this.loadingRecommendedItems && recommendedItems.length === 0;
+        const suggestionBoxStyle = {
+            width: `${this.chipInputRef?.offsetWidth ?? 0}px`,
+            display: 'flex',
+            flexDirection: 'column',
+            boxSizing: 'border-box',
+            background: '#FFFFFF',
+            borderRadius: CHIP_INPUT_SUGGESTIONS.radius,
+            boxShadow: '2px 2px 12px 2px rgba(0, 0, 0, 0.1)',
+            maxHeight: CHIP_INPUT_SUGGESTIONS.maxHeight,
+            minHeight: '0',
+            overflowY: 'auto',
+            overflowX: 'hidden',
+            outline: 'none',
         };
-        return (h("sd-field", { key: 'ea69cfd9fd589f3657f3dff1f73196f684d35d80', name: this.name, label: this.label, labelWidth: this.labelWidth, hint: this.hint, errorMessage: this.errorMessage, rules: this.rules, error: this.error, disabled: this.disabled, focused: this.focused, hovered: this.hovered, status: this.status, size: this.size, width: this.width, icon: this.icon, labelTooltip: this.labelTooltip, labelTooltipProps: this.labelTooltipProps, ref: el => (this.formField = el), style: cssVars, onMouseEnter: () => (this.hovered = true), onMouseLeave: () => (this.hovered = false) }, h("div", { key: 'b4948c02ea157000002661ca9374b300af5e71a8', class: "sd-chip-input", onClick: this.handleContainerClick }, (this.internalValues ?? []).map((value, i) => (h("sd-chip", { key: i, value: value, error: this.getChipError(i), disabled: this.getChipDisabled(i), editable: false, onSdRemove: () => this.handleChipRemove(i) }))), h("div", { key: 'ad36a2c8dd5b8d8ad00d7130da75e92a1fb3b350', class: {
+        const suggestionItemStyle = {
+            display: 'flex',
+            alignItems: 'center',
+            gap: CHIP_INPUT_SUGGESTIONS.itemGap,
+            padding: `${CHIP_INPUT_SUGGESTIONS.itemPaddingY} ${CHIP_INPUT_SUGGESTIONS.itemPaddingRight} ` +
+                `${CHIP_INPUT_SUGGESTIONS.itemPaddingY} ${CHIP_INPUT_SUGGESTIONS.itemPaddingX}`,
+            fontSize: CHIP_INPUT_SUGGESTIONS.itemFontSize,
+            lineHeight: CHIP_INPUT_SUGGESTIONS.itemLineHeight,
+            fontWeight: CHIP_INPUT_SUGGESTIONS.itemFontWeight,
+            fontFamily: CHIP_INPUT_SUGGESTIONS.itemFontFamily,
+            color: CHIP_INPUT_SUGGESTIONS.itemColor,
+            cursor: 'pointer',
+            userSelect: 'none',
+            whiteSpace: 'nowrap',
+            overflow: 'hidden',
+            textOverflow: 'ellipsis',
+        };
+        const suggestionEmptyStyle = {
+            padding: '12px',
+            textAlign: 'center',
+            fontSize: CHIP_INPUT_SUGGESTIONS.emptyFontSize,
+            lineHeight: CHIP_INPUT_SUGGESTIONS.emptyLineHeight,
+            fontFamily: CHIP_INPUT_SUGGESTIONS.itemFontFamily,
+            color: CHIP_INPUT_SUGGESTIONS.emptyColor,
+        };
+        return (h("sd-field", { key: '33ae95b159edcb8ee407cf8d311428f419f26e95', name: this.name, label: this.label, labelWidth: this.labelWidth, hint: this.hint, errorMessage: this.errorMessage, rules: [this.duplicateRule, ...(this.rules ?? [])], error: this.error, disabled: this.disabled, focused: this.focused, hovered: this.hovered, status: this.status, size: this.size, width: this.width, icon: this.icon, labelTooltip: this.labelTooltip, labelTooltipProps: this.labelTooltipProps, ref: el => (this.formField = el), style: cssVars, onMouseEnter: () => (this.hovered = true), onMouseLeave: () => (this.hovered = false) }, h("div", { key: '4f7cd96e4cda06239a7498b8af5f1f3169362028', class: "sd-chip-input", ref: el => (this.chipInputRef = el), onClick: this.handleContainerClick }, (this.internalValues ?? []).map((value, i) => (h("sd-chip", { key: i, value: value, error: this.getChipError(i), disabled: this.getChipDisabled(i), editable: false, onSdRemove: () => this.handleChipRemove(i) }))), !isMaxReached && (h("div", { key: 'dab7b1c520923fdb8cb026141727d8d008b83663', class: {
                 'sd-chip-input__field': true,
                 'sd-chip-input__field--filled': this.inputValue !== '',
                 'sd-chip-input__field--empty': this.inputValue === '' && this.internalValues.length > 0 && !this.focused,
@@ -206,7 +400,20 @@ export class SdChipInput {
                 ? this.inputValue
                 : this.internalValues.length === 0
                     ? this.placeholder
-                    : '' }, h("input", { key: '6ea7cdaa1011543b6c7784561d3752e4ed4a9d7d', ref: el => (this.inputEl = el), class: "sd-chip-input__input", placeholder: this.internalValues.length === 0 ? this.placeholder : '', disabled: this.disabled, size: 1, onInput: this.handleInput, onKeyDown: this.handleKeyDown, onFocus: this.handleFocus, onBlur: this.handleBlur })), this.useReset && this.internalValues.length > 0 && (h("div", { key: '65c366e84ba427704a9c89f6f5c6fdeeb5889554', class: "sd-chip-input__reset" }, this.inputValue === '' && h("span", { key: 'e78f17df8e2fd9a91cc5f0450d22542720adef1b', class: "sd-chip-input__divider" }), h("sd-text-link", { key: '298bd3ce40e0c0c4b91337548d6c6887d5239ccc', icon: "reset", iconColor: CHIP_INPUT_RESET.iconColor, label: "\uC785\uB825 \uCD08\uAE30\uD654", underline: true, disabled: this.disabled, style: { '--sd-text-link-color': CHIP_INPUT_RESET.labelColor }, onSdClick: this.handleResetInput }))))));
+                    : '' }, h("input", { key: '0aee2d0f30c5af7fccfc2e35e5cee17912712ce9', ref: el => (this.inputEl = el), class: "sd-chip-input__input", placeholder: this.internalValues.length === 0 ? this.placeholder : '', disabled: this.disabled, size: 1, onInput: this.handleInput, onKeyDown: this.handleKeyDown, onFocus: this.handleFocus, onBlur: this.handleBlur }))), showResetArea && (h("div", { key: 'b0b508db62d31f6427d5a2def435fec7fc552e92', class: "sd-chip-input__reset" }, this.inputValue === '' && h("span", { key: '30ce147f3bc8070192d95f381fa7f75ad37aab9b', class: "sd-chip-input__divider" }), this.maxCount != null && (h("span", { key: '8c43a2920e55a36ff0c0ab952a52ab3df8d3c98d', class: "sd-chip-input__max-count" }, "\uCD5C\uB300 ", this.maxCount, "\uAC1C")), this.useReset && this.internalValues.length > 0 && (h("sd-text-link", { key: '543316c12760fe16449e2b89a9afb8c43344eab5', icon: "reset", iconColor: CHIP_INPUT_RESET.iconColor, label: "\uC785\uB825 \uCD08\uAE30\uD654", underline: true, disabled: this.disabled, style: { '--sd-text-link-color': CHIP_INPUT_RESET.labelColor }, onSdClick: this.handleResetInput })))), showDropdown && (h("sd-portal", { key: 'c402b8336f7d62213f2b803f80f7a2ffabce2c9d', open: showDropdown, parentRef: this.chipInputRef ?? null, viewportPadding: SdChipInput.SUGGESTIONS_VIEWPORT_PADDING, onSdClose: this.closeSuggestions }, h("div", { key: '4ade4acb535b2db7011699a449afd8c17fe5696d', class: "sd-chip-input__suggestions", role: "listbox", style: suggestionBoxStyle }, isDropdownLoading && (h("div", { key: 'e07a447f7c9a9d376680ddb3af6daf58e0d39167', class: "sd-chip-input__suggestions-empty", style: suggestionEmptyStyle }, "\uBD88\uB7EC\uC624\uB294 \uC911...")), dropdownItems.map((item, i) => (h("div", { key: item, class: {
+                'sd-chip-input__suggestion-item': true,
+                'sd-chip-input__suggestion-item--active': i === this.activeSuggestionIndex,
+            }, role: "option", tabIndex: -1, "aria-selected": i === this.activeSuggestionIndex, style: i === this.activeSuggestionIndex
+                ? {
+                    ...suggestionItemStyle,
+                    background: CHIP_INPUT_SUGGESTIONS.itemBgHover,
+                    color: CHIP_INPUT_SUGGESTIONS.itemColorHover,
+                    fontWeight: CHIP_INPUT_SUGGESTIONS.itemFontWeightSelected,
+                }
+                : suggestionItemStyle, onMouseDown: e => {
+                e.preventDefault();
+                this.addChip(item);
+            } }, item)))))))));
     }
     static get is() { return "sd-chip-input"; }
     static get originalStyleUrls() {
@@ -427,6 +634,120 @@ export class SdChipInput {
                 "attribute": "use-reset",
                 "defaultValue": "false"
             },
+            "maxCount": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "max-count"
+            },
+            "duplicateLabel": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "duplicate-label"
+            },
+            "suggestions": {
+                "type": "unknown",
+                "mutable": true,
+                "complexType": {
+                    "original": "string[]",
+                    "resolved": "string[]",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "defaultValue": "[]"
+            },
+            "loadingSuggestions": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "loading-suggestions",
+                "defaultValue": "false"
+            },
+            "recommendedItems": {
+                "type": "unknown",
+                "mutable": true,
+                "complexType": {
+                    "original": "string[]",
+                    "resolved": "string[]",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "defaultValue": "[]"
+            },
+            "loadingRecommendedItems": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "loading-recommended-items",
+                "defaultValue": "false"
+            },
             "label": {
                 "type": "string",
                 "mutable": false,
@@ -622,7 +943,10 @@ export class SdChipInput {
             "internalErrors": {},
             "focused": {},
             "hovered": {},
-            "inputValue": {}
+            "inputValue": {},
+            "activeSuggestionIndex": {},
+            "suppressSuggestions": {},
+            "suppressRecommendations": {}
         };
     }
     static get events() {
@@ -671,6 +995,21 @@ export class SdChipInput {
                     "resolved": "void",
                     "references": {}
                 }
+            }, {
+                "method": "inputEvent",
+                "name": "sdInput",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                }
             }];
     }
     static get methods() {
@@ -753,6 +1092,15 @@ export class SdChipInput {
             }, {
                 "propName": "errors",
                 "methodName": "errorsChanged"
+            }, {
+                "propName": "internalValues",
+                "methodName": "internalValuesChanged_validate"
+            }, {
+                "propName": "suggestions",
+                "methodName": "suggestionsChanged"
+            }, {
+                "propName": "recommendedItems",
+                "methodName": "recommendedItemsChanged"
             }];
     }
 }

package/dist/collection/components/sd-circle-progress/sd-circle-progress.js

@@ -27,7 +27,7 @@ export class SdCircleProgress {
         }
         const c = CIRCLE_PROGRESS_VIEWBOX_SIZE / 2;
         const showPercent = !this.indeterminate;
-        return (h(Host, { key: '46d74c0edb5a5e8cd0472c83efc45a0efaf353b4', style: hostStyle }, h("svg", { key: '34117c89eb180370a215807e614ad08f4f72b517', class: "sd-circle-progress", viewBox: `0 0 ${CIRCLE_PROGRESS_VIEWBOX_SIZE} ${CIRCLE_PROGRESS_VIEWBOX_SIZE}`, xmlns: "http://www.w3.org/2000/svg" }, h("circle", { key: '08ac6f011b6a4b6744ddcf437b1e0a5b96abfc6e', class: "sd-circle-progress__track", cx: c, cy: c, r: CIRCLE_PROGRESS_RADIUS, fill: "none", "stroke-width": CIRCLE_PROGRESS_STROKE_WIDTH }), h("circle", { key: '5ae0a53ce10bd5a8b2f316ebd00d3ee28c4336d6', class: "sd-circle-progress__arc", cx: c, cy: c, r: CIRCLE_PROGRESS_RADIUS, fill: "none", "stroke-width": CIRCLE_PROGRESS_STROKE_WIDTH, "stroke-linecap": "round", style: arcStyle })), showPercent && (h("span", { key: 'fd52ee1947d41b2117c9ea6e4cc9a448799342e3', class: "sd-circle-progress__percent" }, Math.round(this.clampedValue), "%")), this.label && h("span", { key: 'a58776c4ef67eb900eba97ff4fed138c8f5e8452', class: "sd-circle-progress__label" }, this.label)));
+        return (h(Host, { key: '35b4dc433f5e2bbd02dc3422b286da179472082f', style: hostStyle }, h("svg", { key: 'de1d3e44eccf421491a1107ba234e1562917945b', class: "sd-circle-progress", viewBox: `0 0 ${CIRCLE_PROGRESS_VIEWBOX_SIZE} ${CIRCLE_PROGRESS_VIEWBOX_SIZE}`, xmlns: "http://www.w3.org/2000/svg" }, h("circle", { key: 'b0a54a2e155222a416a6bdcb75f4fe54d9de8270', class: "sd-circle-progress__track", cx: c, cy: c, r: CIRCLE_PROGRESS_RADIUS, fill: "none", "stroke-width": CIRCLE_PROGRESS_STROKE_WIDTH }), h("circle", { key: '6bc314b3fce758d41a3499e9d87b7158b15777a5', class: "sd-circle-progress__arc", cx: c, cy: c, r: CIRCLE_PROGRESS_RADIUS, fill: "none", "stroke-width": CIRCLE_PROGRESS_STROKE_WIDTH, "stroke-linecap": "round", style: arcStyle })), showPercent && (h("span", { key: '16ec46b178d5f2f2f5ad245703c2f4362b8df261', class: "sd-circle-progress__percent" }, Math.round(this.clampedValue), "%")), this.label && h("span", { key: 'c199799d2466c75f91f1bc1f20fdb7e71c64ba0e', class: "sd-circle-progress__label" }, this.label)));
     }
     static get is() { return "sd-circle-progress"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-confirm-modal/sd-confirm-modal.js

@@ -73,9 +73,9 @@ export class SdConfirmModal {
         const type = this.resolvedType;
         const iconName = CONFIRM_MODAL_ICON_MAP[type];
         const iconColor = CONFIRM_MODAL_ICON_COLOR[type];
-        return (h("div", { key: '4d3ce0662b2d860a4ed6ae3c8177ae75dae4fb92', class: "sd-confirm-modal" }, h("sd-ghost-button", { key: '7c406d59c2470b610a187bf45aa5cd4ab5c6b26b', class: "sd-confirm-modal__close-button", icon: "close", ariaLabel: "close", onClick: () => this.close.emit() }), iconName && (h("sd-icon", { key: '10e3d2c8a87a728df4e3f3be7dfab96475738e2b', class: "sd-confirm-modal__icon", name: iconName, size: TITLE_ICON_SIZE, color: iconColor })), h("h2", { key: '9cc844c8cefb2fd0dc96871b55fc1c7c6e41c526', class: `sd-confirm-modal__title ${this.titleClass ?? ''}` }, this.modalTitle), h("div", { key: 'bbaa81a02c067d66c4cc19cf805b7a6939231311', class: "sd-confirm-modal__body" }, (this.topMessage ?? []).length > 0 && (h("div", { key: '31734f096eee6e6a9be770eafa43066c8e763608', class: "sd-confirm-modal__message" }, (this.topMessage ?? []).map(msg => (h("p", { class: "sd-confirm-modal__message-text", innerHTML: sanitizeInlineHtml(msg) }))))), this.showContentBox && (h("div", { key: 'a10838fb7c7081fdaa85cdaa33f92ef30c00a888', class: "sd-confirm-modal__content-box" }, this.tagContents ? (h("div", { class: "sd-confirm-modal__custom-content", ref: el => {
+        return (h("div", { key: '51fb051b436cc511aeac2f578832a267e12ef3c4', class: "sd-confirm-modal" }, h("sd-ghost-button", { key: 'dd9605e312eac8b0602ec558ad5439ea3daa7aa7', class: "sd-confirm-modal__close-button", icon: "close", ariaLabel: "close", onClick: () => this.close.emit() }), iconName && (h("sd-icon", { key: '5027ec2d03731338a9197f7b5b910d2adbf83f0e', class: "sd-confirm-modal__icon", name: iconName, size: TITLE_ICON_SIZE, color: iconColor })), h("h2", { key: '8456707355cc779c169b56abc16b0949909b829e', class: `sd-confirm-modal__title ${this.titleClass ?? ''}` }, this.modalTitle), h("div", { key: 'd11cb38e749f54ce5767ba9b5cca0129df742aca', class: "sd-confirm-modal__body" }, (this.topMessage ?? []).length > 0 && (h("div", { key: 'de653458605a9591d7c66d644a143d0f33738b28', class: "sd-confirm-modal__message" }, (this.topMessage ?? []).map(msg => (h("p", { class: "sd-confirm-modal__message-text", innerHTML: sanitizeInlineHtml(msg) }))))), this.showContentBox && (h("div", { key: '0517e400485551ab21f0f5452af764b5ede7a76d', class: "sd-confirm-modal__content-box" }, this.tagContents ? (h("div", { class: "sd-confirm-modal__custom-content", ref: el => {
                 this.customContentRef = el;
-            } })) : (h("slot", { onSlotchange: () => this.syncHasSlottedContent() }, this.tagLabel && (h("sd-tag", { name: this.tagPreset ?? 'square_sm_grey', label: this.tagLabel })), this.slotLabel && (h("span", { class: "sd-confirm-modal__slot-label" }, this.slotLabel)))))), (this.bottomMessage ?? []).length > 0 && (h("div", { key: '540f3bb73aa61a1a2a041eba9a22a198c7772914', class: "sd-confirm-modal__message" }, (this.bottomMessage ?? []).map(msg => (h("p", { class: "sd-confirm-modal__message-text", innerHTML: sanitizeInlineHtml(msg) })))))), h("div", { key: '1944aeb4d140c779d0af1304160a86c5056335a8', class: "sd-confirm-modal__button" }, this.subButtonLabel && (h("sd-button", { key: 'efd463686d98e9d2edc3e1cd7b4f54d8da4fef56', name: SUB_BUTTON_PRESET, label: this.subButtonLabel, onSdClick: () => this.cancel.emit() })), h("sd-button", { key: 'b9033fb98acf3de36b7fb3e1969ccf5a7becef39', name: this.resolvedMainButton, label: this.mainButtonLabel ?? '확인', onSdClick: () => this.ok.emit() }))));
+            } })) : (h("slot", { onSlotchange: () => this.syncHasSlottedContent() }, this.tagLabel && (h("sd-tag", { name: this.tagPreset ?? 'square_sm_grey', label: this.tagLabel })), this.slotLabel && (h("span", { class: "sd-confirm-modal__slot-label" }, this.slotLabel)))))), (this.bottomMessage ?? []).length > 0 && (h("div", { key: 'd542a08caee30ed7eb1d22ed85a51be6e1f6855e', class: "sd-confirm-modal__message" }, (this.bottomMessage ?? []).map(msg => (h("p", { class: "sd-confirm-modal__message-text", innerHTML: sanitizeInlineHtml(msg) })))))), h("div", { key: '02d012e899969ee55cba43c11d9caeaaff65a348', class: "sd-confirm-modal__button" }, this.subButtonLabel && (h("sd-button", { key: 'fd50d151e515646e5bef5658a1b05b2e26b21461', name: SUB_BUTTON_PRESET, label: this.subButtonLabel, onSdClick: () => this.cancel.emit() })), h("sd-button", { key: '0c2092edf0866a8b1f4f432b176d78eedd9655d6', name: this.resolvedMainButton, label: this.mainButtonLabel ?? '확인', onSdClick: () => this.ok.emit() }))));
     }
     static get is() { return "sd-confirm-modal"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-date-picker/sd-date-picker-trigger/sd-date-picker-trigger.js

@@ -33,7 +33,7 @@ export class SdDatePickerTrigger {
                 ? DATEPICKER_COLORS.icon.disabled
                 : DATEPICKER_COLORS.icon.default,
         };
-        return (h("div", { key: '87ada0414ffc6404b27cf4a41ba7c9cb9903f498', role: "button", tabindex: this.disabled ? -1 : 0, class: {
+        return (h("div", { key: '8ce4e5a7f355e15ad6662efc5d1a697c2f78d455', role: "button", tabindex: this.disabled ? -1 : 0, class: {
                 'sd-date-picker-trigger': true,
                 'sd-date-picker-trigger--disabled': this.disabled,
             }, style: cssVars, onClick: this.handleClick, onKeyDown: e => {
@@ -41,7 +41,7 @@ export class SdDatePickerTrigger {
                     e.preventDefault();
                     this.handleClick();
                 }
-            } }, h("sd-icon", { key: 'e8eee3ed97ab7344e7658b7b22bc91f11aa0b068', name: "date", size: Number(sizeTokens.iconSize), color: "var(--trigger-icon-color)", class: "sd-date-picker-trigger__icon" }), h("span", { key: 'ea25a13a72d00ca31fcddaf0183b520175ef7d93', class: "sd-date-picker-trigger__text" }, hasValue ? this.displayText : this.placeholder)));
+            } }, h("sd-icon", { key: '31d360adaf1a8a0d613d3809be7c724be9d7a29a', name: "date", size: Number(sizeTokens.iconSize), color: "var(--trigger-icon-color)", class: "sd-date-picker-trigger__icon" }), h("span", { key: 'cf17fb4d5fdaadd99847ec9ce5440214c10a5797', class: "sd-date-picker-trigger__text" }, hasValue ? this.displayText : this.placeholder)));
     }
     static get is() { return "sd-date-picker-trigger"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-date-picker/sd-date-picker.js

@@ -93,9 +93,9 @@ export class SdDatePicker {
             '--sd-system-color-field-border-focus': DATEPICKER_COLORS.border.focus,
             '--sd-system-color-field-bg-default': DATEPICKER_COLORS.bg.default,
         };
-        return (h("sd-field", { key: 'baa957e5534b6587da2ef067ecad4a0934693800', name: this.name, label: this.label, labelWidth: this.labelWidth, addonLabel: this.addonLabel, addonAlign: this.addonAlign, hint: this.hint, errorMessage: this.errorMessage, width: this.width, rules: this.rules, error: this.error, disabled: this.disabled, focused: this.focused, hovered: this.hovered, size: this.size, icon: this.icon, labelTooltip: this.labelTooltip, labelTooltipProps: this.labelTooltipProps, ref: el => (this.formField = el), onMouseEnter: () => (this.hovered = true), onMouseLeave: () => (this.hovered = false), style: cssVars }, h("div", { key: '652f9f5c6bd5c6ee58f3c89eee45325a98234ac0', class: "sd-date-picker", ref: el => {
+        return (h("sd-field", { key: '9e1e5cb7419027db803248a657d0d134be049637', name: this.name, label: this.label, labelWidth: this.labelWidth, addonLabel: this.addonLabel, addonAlign: this.addonAlign, hint: this.hint, errorMessage: this.errorMessage, width: this.width, rules: this.rules, error: this.error, disabled: this.disabled, focused: this.focused, hovered: this.hovered, size: this.size, icon: this.icon, labelTooltip: this.labelTooltip, labelTooltipProps: this.labelTooltipProps, ref: el => (this.formField = el), onMouseEnter: () => (this.hovered = true), onMouseLeave: () => (this.hovered = false), style: cssVars }, h("div", { key: 'fbd9adeaa08d19cac34b045aba2b3fbb8d4adc8c', class: "sd-date-picker", ref: el => {
                 this.triggerRef = el;
-            } }, h("sd-date-picker-trigger", { key: '7b0f81badbcf7ca283afd274b4572e4a6eaa590b', displayText: this.value ?? '', placeholder: this.placeholder, disabled: this.disabled, size: this.size, onSdTriggerClick: this.handleTriggerClick })), (this.isOpen || this.isAnimatingOut) && (h("sd-portal", { key: '65fbe892e4cdd9d643b5000d69220b5e28972902', open: this.isOpen, parentRef: this.triggerRef, onSdClose: () => this.closeDropdown() }, h("sd-calendar", { key: 'e9187264f336295907f1d5574810df4a07a0f114', elevated: true, value: this.value, selectable: this.selectable, onSdUpdate: this.handleSelect, onSdViewChange: this.handleViewChange })))));
+            } }, h("sd-date-picker-trigger", { key: 'd51161c4b1eedcfd90832c9b6d049559ff5df08b', displayText: this.value ?? '', placeholder: this.placeholder, disabled: this.disabled, size: this.size, onSdTriggerClick: this.handleTriggerClick })), (this.isOpen || this.isAnimatingOut) && (h("sd-portal", { key: 'd6588d3991eff39eb717d4211b38d68f093aace5', open: this.isOpen, parentRef: this.triggerRef, onSdClose: () => this.closeDropdown() }, h("sd-calendar", { key: '0dc6a8074fcfa63630aab7f0b126caa9f4c7b234', elevated: true, value: this.value, selectable: this.selectable, onSdUpdate: this.handleSelect, onSdViewChange: this.handleViewChange })))));
     }
     static get is() { return "sd-date-picker"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-date-range-picker/sd-date-range-picker-calendar/sd-date-range-picker-calendar.js

@@ -239,7 +239,7 @@ export class SdDateRangePickerCalendar {
             '--range-panel-gap': `${RANGE_LAYOUT.panelGap}px`,
             '--range-divider': RANGE_LAYOUT.divider,
         };
-        return (h(Fragment, { key: '91ba95cf0786d59363ac6b72e9c8f91d1802feee' }, h("div", { key: '98f66737a15e5c3129dd20f674736115a4fad42e', class: "sd-date-range-picker-calendar", style: cssVars }, this.renderYearNav(), h("div", { key: 'd9f326b485864484ed786cb172d3bd33136987ea', class: "sd-date-range-picker-calendar__panels" }, this.renderPanel(this.currentYear, this.currentMonth, true), h("span", { key: 'df7d835ac0da6788f08c7963ed04ed98b7fd6091', class: "sd-date-range-picker-calendar__divider", "aria-hidden": "true" }), this.renderPanel(this.rightYear, this.rightMonth, false)))));
+        return (h(Fragment, { key: '71f25effececd0b83d9b33201230dc615ba87a30' }, h("div", { key: 'f075474fb0be9f8e8562a013532b3cdbaadee069', class: "sd-date-range-picker-calendar", style: cssVars }, this.renderYearNav(), h("div", { key: '4dfa1d65b971f7d80f0799482c8ce41522200a94', class: "sd-date-range-picker-calendar__panels" }, this.renderPanel(this.currentYear, this.currentMonth, true), h("span", { key: '20149f97a5115115cc49894383ca7f989ba2b904', class: "sd-date-range-picker-calendar__divider", "aria-hidden": "true" }), this.renderPanel(this.rightYear, this.rightMonth, false)))));
     }
     static get is() { return "sd-date-range-picker-calendar"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-divider/sd-divider.js

@@ -7,7 +7,7 @@ export class SdDivider {
         const hostStyle = {
             '--sd-divider-color': DIVIDER_COLORS.default,
         };
-        return (h(Host, { key: '8282aae8e5cd26630c54f4347cd26f544672d15d', style: hostStyle }, h("hr", { key: '94df7dc7465b05ecad6527da2c008a4ff503f034', "aria-orientation": this.vertical ? 'vertical' : 'horizontal' })));
+        return (h(Host, { key: '886ca68599a925678d7c598daeff3bf653db513d', style: hostStyle }, h("hr", { key: 'e213413f041cda5d18a74f8c0225c840d92f7dac', "aria-orientation": this.vertical ? 'vertical' : 'horizontal' })));
     }
     static get is() { return "sd-divider"; }
     static get originalStyleUrls() {

package/dist/collection/components/sd-dropdown-button/sd-dropdown-button.config.js

@@ -51,6 +51,13 @@ export const DROPDOWN_CHEVRON_ICON_SIZE = {
     sm: 12,
     md: 16,
 };
+// 버튼 자체의 min-width (px). split 여부에 따라 chevron 버튼이 추가되므로 별도 값을 지정.
+// TODO: 디자인 토큰으로 관리될 때 대체 예정
+export const DROPDOWN_BUTTON_MIN_WIDTH = {
+    xs: { default: 44, split: 60 },
+    sm: { default: 70, split: 76 },
+    md: { default: 100, split: 106 },
+};
 export const DROPDOWN_DISABLED_BACKGROUND = buttonTokens.button.bg.disabled;
 export const DROPDOWN_DISABLED_TEXT = buttonTokens.button.text.disabled;
 export const DROPDOWN_DISABLED_ICON = buttonTokens.button.icon.disabled;