@daikin-oss/design-system-web-components 1.3.2 → 1.4.0-next.1

package/dist/cjs-dev/components/button/daikin-button.d.cts

@@ -14,6 +14,9 @@ type ButtonVariantProps = MergeVariantProps<typeof cvaButton | typeof cvaIcon>;
  * The button component is a versatile UI element that triggers actions or submits forms when clicked.
  * It functions similarly to the HTML `<button>` tag, allowing users to initiate various operations such as submitting data, opening dialogs, or navigating to different sections of an application.
  *
+ * @attr form - The form the component belongs to.
+ * @prop {String} formAttr - The form the component belongs to.
+ *
  * @fires click - A retargeted event of a [click event](https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event) emitted from the inner `<a>` or `<button>` element. Suppressed if `disabled` is true,
  *
  * @slot - A slot for the button content.
@@ -36,19 +39,25 @@ export declare class DaikinButton extends DDSFormSubmitElement {
     static readonly styles: import('lit').CSSResult;
     /**
      * Variant of the button.
+     *
+     * @default "fill"
      */
     variant: ButtonVariantProps["variant"];
     /**
      * Type of the button.
      * If `"link"` is specified, the button will be rendered as an `<a>` element.
+     *
+     * @default "button"
      */
     type: "button" | "submit" | "reset" | "link";
     /**
      * Size of the button.
      */
-    size: "small" | "medium" | "large";
+    size: ButtonVariantProps["size"];
     /**
      * Color of the button.
+     *
+     * @default "default"
      */
     color: ButtonVariantProps["color"];
     /**
@@ -74,7 +83,14 @@ export declare class DaikinButton extends DDSFormSubmitElement {
      * The aria-expanded of button when `type="button"`.
      * When used within a daikin-menu component, this property will be controlled by daikin-menu, so you don't need to specify it explicitly.
      */
-    buttonAriaExpanded: boolean | null;
+    buttonAriaExpanded: "true" | "false" | "undefined" | null;
+    /**
+     * The `tabindex` of the button.
+     * If omitted or set to 0, the button follows the default tab flow.
+     * Setting it to -1 makes the button unreachable via the Tab key.
+     * This is useful when the button is part of a composite widget and accessible via other keys.
+     */
+    buttonTabIndex: number;
     private _focusableElement;
     constructor();
     render(): import('lit-html').TemplateResult<1>;

package/dist/cjs-dev/components/calendar/daikin-calendar.cjs

@@ -7,6 +7,7 @@ const ifDefined_js = require("lit/directives/if-defined.js");
 const repeat_js = require("lit/directives/repeat.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -126,16 +127,15 @@ function getNextFocusDateByKey(date, event) {
 exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
   constructor() {
     super(...arguments);
-    this.value = null;
-    this.min = "1900-01-01";
-    this.max = "2099-12-31";
+    this.value = "";
     this.defaultValue = null;
     this.view = "day";
+    this._lastFocusedDate = null;
     this._dateToBeFocused = null;
     this._viewDate = getToday();
   }
   get _value() {
-    return calendarCommon.tryParseDateFromProperty(this.value ?? "");
+    return calendarCommon.tryParseDateFromProperty(this.value);
   }
   get _min() {
     return calendarCommon.tryParseDateFromProperty(this.min) ?? calendarCommon.parseDateFromProperty(calendarCommon.DEFAULT_MIN_DATE);
@@ -177,6 +177,7 @@ exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
   }
   _navigateMonth(date, offset) {
     this._viewDate = calendarCommon.getDateByMonthOffsetClamped(date, offset);
+    this._lastFocusedDate = null;
   }
   _handleCalendarClick(date) {
     this.value = calendarCommon.formatDateForProperty(date);
@@ -208,6 +209,7 @@ exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
       `[data-type=day][data-date="${calendarCommon.formatDateForProperty(dateToBeFocused)}"]`
     );
     if (dateButton && calendarCommon.isSameYearMonth(dateToBeFocused, focusedDate)) {
+      this._lastFocusedDate = dateToBeFocused;
       dateButton.focus();
     } else {
       this._dateToBeFocused = dateToBeFocused;
@@ -363,7 +365,19 @@ exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
       viewDate.getUTCFullYear(),
       viewDate.getUTCMonth()
     );
-    const focusable = value && calendarCommon.isSameYearMonth(viewDate, value) ? value : calendarCommon.isSameYearMonth(viewDate, today) ? today : calendarCommon.clampDate(viewDate, min, max);
+    const focusable = (
+      // If the last focused date is in the same month as the view date, use it as the focusable date.
+      this._lastFocusedDate && calendarCommon.isSameYearMonth(viewDate, this._lastFocusedDate) ? this._lastFocusedDate : (
+        // If the value is in the same month as the view date, use it as the focusable date.
+        value && calendarCommon.isSameYearMonth(viewDate, value) ? value : (
+          // If today's date is in the same month as the view date, use it as the focusable date.
+          calendarCommon.isSameYearMonth(viewDate, today) ? today : (
+            // Otherwise, use the first day of the month (clamped).
+            calendarCommon.clampDate(calendarCommon.toFirstDayOfMonth(viewDate), min, max)
+          )
+        )
+      )
+    );
     return lit.html`<div class="flex flex-col gap-2 w-full h-72" role="grid">
       <div class="flex gap-1 flex-wrap w-full px-4" role="row">
         ${repeat_js.repeat(
@@ -398,9 +412,7 @@ exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
         })}
                     role="gridcell"
                     ?disabled=${calendarCommon.isDateOutOfRange(date, min, max)}
-                    tabindex=${ifDefined_js.ifDefined(
-          focusable.getTime() != date.getTime() ? -1 : void 0
-        )}
+                    tabindex=${date.getTime() === focusable.getTime() ? lit.nothing : -1}
                     aria-current=${date.getTime() === today.getTime() ? "date" : lit.nothing}
                     aria-selected=${date.getTime() === (value == null ? void 0 : value.getTime())}
                     data-type="day"
@@ -509,11 +521,14 @@ exports.DaikinCalendar = class DaikinCalendar extends ddsElement.DDSElement {
     }
   }
   updated(changedProperties) {
-    if (changedProperties.has("_viewDate") && this._dateToBeFocused != null) {
+    if (this._dateToBeFocused != null) {
       const dateButton = this.renderRoot.querySelector(
         `[data-type=day][data-date="${calendarCommon.formatDateForProperty(this._dateToBeFocused)}"]`
       );
-      dateButton == null ? void 0 : dateButton.focus();
+      if (dateButton) {
+        this._lastFocusedDate = this._dateToBeFocused;
+        dateButton.focus();
+      }
       this._dateToBeFocused = null;
     }
     if (changedProperties.get("view") != null) {
@@ -542,20 +557,26 @@ exports.DaikinCalendar.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String, attribute: false })
+  ddsProperty.property({ type: String })
 ], exports.DaikinCalendar.prototype, "value", 2);
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true })
+  ddsProperty.property({ type: String, reflect: true, fallbackValue: "1900-01-01" })
 ], exports.DaikinCalendar.prototype, "min", 2);
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true })
+  ddsProperty.property({ type: String, reflect: true, fallbackValue: "2099-12-31" })
 ], exports.DaikinCalendar.prototype, "max", 2);
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true, attribute: "default-value" })
+  ddsProperty.property({ type: String, reflect: true, attribute: "default-value" })
 ], exports.DaikinCalendar.prototype, "defaultValue", 2);
 __decorateClass([
-  decorators_js.property({ type: String, attribute: false })
+  ddsProperty.property({ type: String, attribute: false })
 ], exports.DaikinCalendar.prototype, "view", 2);
+__decorateClass([
+  decorators_js.state()
+], exports.DaikinCalendar.prototype, "_lastFocusedDate", 2);
+__decorateClass([
+  decorators_js.state()
+], exports.DaikinCalendar.prototype, "_dateToBeFocused", 2);
 __decorateClass([
   decorators_js.state()
 ], exports.DaikinCalendar.prototype, "_viewDate", 2);

package/dist/cjs-dev/components/calendar/daikin-calendar.d.cts

@@ -21,15 +21,17 @@ export declare class DaikinCalendar extends DDSElement {
     /**
      * The current value of the input, submitted as a name/value pair with form data.
      */
-    value: string | null;
+    value: string;
     /**
      * The minimum date.
-     * example: `1900-01-01`
+     *
+     * @default "1900-01-01"
      */
     min: string;
     /**
      * The maximum date.
-     * example: `2099-12-31`
+     *
+     * @default "2099-12-31"
      */
     max: string;
     /**
@@ -46,6 +48,15 @@ export declare class DaikinCalendar extends DDSElement {
      * Intended for use only by `daikin-date-picker`.
      */
     view: "year" | "month" | "day";
+    /**
+     * The date that was last focused.
+     * Used to preserve focus when tabbing out and back in.
+     */
+    private _lastFocusedDate;
+    /**
+     * The date to be focused.
+     * Used to set focus on a date that is not in the current view (year and month).
+     */
     private _dateToBeFocused;
     private get _value();
     private get _min();

package/dist/cjs-dev/components/card/daikin-card.cjs

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const classVarianceAuthority = require("class-variance-authority");
 const lit = require("lit");
-const decorators_js = require("lit/decorators.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -61,7 +61,7 @@ exports.DaikinCard.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCard.prototype, "outline", 2);
 exports.DaikinCard = __decorateClass([
   decorators.ddsElement("daikin-card")

package/dist/cjs-dev/components/card-footer/daikin-card-footer.cjs

@@ -3,6 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const lit = require("lit");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+require("lit/decorators.js");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");

package/dist/cjs-dev/components/card-header/daikin-card-header.cjs

@@ -4,6 +4,7 @@ const classVarianceAuthority = require("class-variance-authority");
 const lit = require("lit");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+require("lit/decorators.js");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");

package/dist/cjs-dev/components/carousel/daikin-carousel.cjs

@@ -7,6 +7,7 @@ const ref_js = require("lit/directives/ref.js");
 const repeat_js = require("lit/directives/repeat.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -219,7 +220,7 @@ exports.DaikinCarousel.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: Number, reflect: true, attribute: "current-index" })
+  ddsProperty.property({ type: Number, reflect: true, attribute: "current-index" })
 ], exports.DaikinCarousel.prototype, "currentIndex", 2);
 __decorateClass([
   decorators_js.queryAssignedElements({ selector: "daikin-carousel-item" })

package/dist/cjs-dev/components/carousel-item/daikin-carousel-item.cjs

@@ -4,6 +4,7 @@ const lit = require("lit");
 const decorators_js = require("lit/decorators.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -62,10 +63,10 @@ exports.DaikinCarouselItem.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String, attribute: false })
+  ddsProperty.property({ type: String, attribute: false })
 ], exports.DaikinCarouselItem.prototype, "label", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, attribute: false })
+  ddsProperty.property({ type: Boolean, attribute: false })
 ], exports.DaikinCarouselItem.prototype, "active", 2);
 __decorateClass([
   decorators_js.queryAssignedElements({ slot: "title" })

package/dist/cjs-dev/components/checkbox/daikin-checkbox.cjs

@@ -2,9 +2,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const classVarianceAuthority = require("class-variance-authority");
 const lit = require("lit");
-const decorators_js = require("lit/decorators.js");
+const ifDefined_js = require("lit/directives/if-defined.js");
 require("../../base/dds-element.cjs");
 const ddsFormElement = require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -78,9 +79,6 @@ const cvaLabel = classVarianceAuthority.cva([], {
 exports.DaikinCheckbox = class DaikinCheckbox extends ddsFormElement.DDSFormElement {
   constructor() {
     super(...arguments);
-    this.label = "";
-    this.labelPosition = "right";
-    this.checkState = "unchecked";
     this.disabled = false;
     this.disabledByParent = false;
   }
@@ -126,7 +124,7 @@ exports.DaikinCheckbox = class DaikinCheckbox extends ddsFormElement.DDSFormElem
         <input
           class=${CHECKBOX_CLASS_NAME}
           type="checkbox"
-          name=${this.name}
+          name=${ifDefined_js.ifDefined(this.getBackingProperty("name"))}
           ?disabled=${disabled}
           aria-label=${this._labelHidden ? this.label : lit.nothing}
           .checked=${this.checked}
@@ -160,19 +158,35 @@ exports.DaikinCheckbox.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String })
+  ddsProperty.property({ type: String, reflect: true, fallbackValue: "" })
 ], exports.DaikinCheckbox.prototype, "label", 2);
 __decorateClass([
-  decorators_js.property({ type: String, attribute: "label-position" })
+  ddsProperty.property({
+    type: String,
+    reflect: true,
+    attribute: "label-position",
+    fallbackValue: "right",
+    isAllowedValue: ddsProperty.oneOf(["right", "hidden"])
+  })
 ], exports.DaikinCheckbox.prototype, "labelPosition", 2);
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true, attribute: "check-state" })
+  ddsProperty.property({
+    type: String,
+    reflect: true,
+    attribute: "check-state",
+    fallbackValue: "unchecked",
+    isAllowedValue: ddsProperty.oneOf([
+      "unchecked",
+      "indeterminate",
+      "checked"
+    ])
+  })
 ], exports.DaikinCheckbox.prototype, "checkState", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCheckbox.prototype, "disabled", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true, attribute: false })
+  ddsProperty.property({ type: Boolean, reflect: true, attribute: false })
 ], exports.DaikinCheckbox.prototype, "disabledByParent", 2);
 exports.DaikinCheckbox = __decorateClass([
   decorators.ddsElement("daikin-checkbox")

package/dist/cjs-dev/components/checkbox/daikin-checkbox.d.cts

@@ -5,11 +5,18 @@ import { DDSFormElement } from "../../base/index.cjs";
  * It functions similarly to the HTML `<input type="checkbox">` tag, enabling users to toggle the selection of each option independently.
  * This component is ideal for cases where multiple selections are allowed or required.
  *
+ * @attr form - The form the component belongs to.
+ * @attr name - The form name, submitted as a name/value pair when submitting the form.
+ * @attr value - The initial form value, submitted as a name/value pair when submitting the form.
+ * @prop {String} formAttr - The form the component belongs to.
+ * @prop {String} name - The form name, submitted as a name/value pair when submitting the form.
+ * @prop {String} value - The form value, submitted as a name/value pair when submitting the form.
+ *
  * @fires change - A cloned event of a [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) emitted from the inner `<input type="checkbox">` element.
  *
  * @slot - A slot for the checkbox label content.
  *
- * @csspart label - Change the style of checkbox label.
+ * @csspart label - CSS styles applied to the `label` part target the internal `<label>` element containing the checkbox. For instance, setting `cursor: pointer;` is useful when the checkbox acts as part of a larger interactive component.
  *
  * @example
  *
@@ -31,10 +38,14 @@ export declare class DaikinCheckbox extends DDSFormElement {
      * Label position.
      * - `right` (default): The label will be placed to the right of the checkbox.
      * - `hidden`: The label will not be shown.
+     *
+     * @default "right"
      */
     labelPosition: "right" | "hidden";
     /**
      * Specify the checkbox checked state.
+     *
+     * @default "unchecked"
      */
     checkState: "unchecked" | "indeterminate" | "checked";
     /**

package/dist/cjs-dev/components/checkbox-group/daikin-checkbox-group.cjs

@@ -6,6 +6,7 @@ const decorators_js = require("lit/decorators.js");
 const ifDefined_js = require("lit/directives/if-defined.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -77,13 +78,21 @@ exports.DaikinCheckboxGroup.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String })
+  ddsProperty.property({
+    type: String,
+    reflect: true,
+    fallbackValue: "vertical",
+    isAllowedValue: ddsProperty.oneOf([
+      "vertical",
+      "horizontal"
+    ])
+  })
 ], exports.DaikinCheckboxGroup.prototype, "orientation", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCheckboxGroup.prototype, "required", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCheckboxGroup.prototype, "disabled", 2);
 __decorateClass([
   decorators_js.state()

package/dist/cjs-dev/components/checkbox-group/daikin-checkbox-group.d.cts

@@ -33,6 +33,8 @@ export declare class DaikinCheckboxGroup extends DDSElement {
     static readonly styles: import('lit').CSSResult;
     /**
      * Specify the checkbox group orientation
+     *
+     * @default "vertical"
      */
     orientation: CheckboxGroupProps["orientation"];
     /**

package/dist/cjs-dev/components/chip/daikin-chip.cjs

@@ -6,6 +6,7 @@ const decorators_js = require("lit/decorators.js");
 const ifDefined_js = require("lit/directives/if-defined.js");
 const ddsElement = require("../../base/dds-element.cjs");
 require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const tailwind = require("../../tailwind.css.cjs");
@@ -100,7 +101,7 @@ exports.DaikinChip.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true, attribute: "chip-aria-label" })
+  ddsProperty.property({ type: String, reflect: true, attribute: "chip-aria-label" })
 ], exports.DaikinChip.prototype, "chipAriaLabel", 2);
 __decorateClass([
   decorators_js.query("button")

package/dist/cjs-dev/components/combobox/daikin-combobox.cjs

@@ -8,6 +8,7 @@ const ifDefined_js = require("lit/directives/if-defined.js");
 const repeat_js = require("lit/directives/repeat.js");
 require("../../base/dds-element.cjs");
 const ddsFormElement = require("../../base/dds-form-element.cjs");
+const ddsProperty = require("../../base/dds-property.cjs");
 const decorators = require("../../base/decorators.cjs");
 require("../../base/define.cjs");
 const clickOutside = require("../../controllers/click-outside.cjs");
@@ -106,8 +107,11 @@ const cvaOption = classVarianceAuthority.cva(
           "active:var-color-ddt-color-common-surface-selected-press/color-primary",
           "after:i-daikin-dropdown-check",
           "after:size-6",
-          "after:flex-none",
-          "justify-between"
+          "pr-10",
+          "after:absolute",
+          "after:right-3",
+          "after:top-1/2",
+          "after:-translate-y-1/2"
         ]
       },
       disabled: {
@@ -185,7 +189,6 @@ function defaultFilterFn(items, value) {
 exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElement {
   constructor() {
     super(...arguments);
-    this.placeholder = null;
     this.disabled = false;
     this.required = false;
     this.error = false;
@@ -249,7 +252,9 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
     this._currentFocusItemIndex = null;
   }
   _handleFocusOut(event) {
-    if (!event.relatedTarget) {
+    if (this.open && // ignore if focusing within the component, especially to the menu items
+    // or menu item will be destroyed before click event is handled
+    (!event.relatedTarget || !this.renderRoot.contains(event.relatedTarget))) {
       this._closePopup();
     }
   }
@@ -274,8 +279,9 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
   }
   _handleClickItem(item) {
     const value = getItemValue(item);
-    this._handleClick();
     this.value = value;
+    this.open = false;
+    this._currentFocusItemIndex = null;
     this.dispatchEvent(
       new Event("input", {
         bubbles: true,
@@ -399,9 +405,7 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
   _handleInput(event) {
     this.value = event.target.value;
     this._synchronizeShowItems("filtered");
-    if (this._viewItems.length > 0) {
-      this.open = true;
-    }
+    this.open = this._viewItems.length > 0;
   }
   /**
    * Handles change events from the combobox input field.
@@ -426,20 +430,18 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
       placeholder: !this.value || this.value.length === 0
     })}
           role="combobox"
-          placeholder=${ifDefined_js.ifDefined(this.placeholder ?? void 0)}
-          name=${ifDefined_js.ifDefined(this.name)}
+          name=${ifDefined_js.ifDefined(this.getBackingProperty("name"))}
+          placeholder=${ifDefined_js.ifDefined(this.getBackingProperty("placeholder"))}
           .value=${this.value}
           ?disabled=${this.disabled}
-          aria-label=${ifDefined_js.ifDefined(this._label ?? void 0)}
+          aria-label=${ifDefined_js.ifDefined(this._label)}
           aria-expanded=${this.open && !this.disabled}
           aria-disabled=${this.disabled}
-          aria-controls="combobox-items"
+          aria-controls=${this.open ? "combobox-items" : lit.nothing}
           aria-autocomplete="list"
           aria-required=${this.required}
           aria-haspopup="listbox"
-          aria-activedescendant=${ifDefined_js.ifDefined(
-      this._currentFocusItemIndex !== null ? `combobox-item-${this._currentFocusItemIndex}` : void 0
-    )}
+          aria-activedescendant=${this._currentFocusItemIndex !== null ? `combobox-item-${this._currentFocusItemIndex}` : lit.nothing}
           @input=${this._handleInput}
           @change=${this._handleChange}
           @click=${this._handleClick}
@@ -455,7 +457,7 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
                 variant="ghost"
                 ?disabled=${this.disabled}
                 button-aria-label="Clear"
-                icon="close"
+                button-tabindex="-1"
                 @click=${this._handleClearClick}
                 @focusout=${this._handleFocusOut}
               >
@@ -463,7 +465,8 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
               </daikin-icon-button>` : lit.nothing}
           <span
             class=${cvaArrow({ open: this.open, disabled: this.disabled })}
-            button-aria-label=${this.open ? "Close" : "Open"}
+            role="img"
+            aria-label=${this.open ? "Close" : "Open"}
             @mousedown=${this._handleArrowClick}
             @keydown=${this._handleKeyDown}
           >
@@ -473,12 +476,14 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
       <div
         id="combobox-items"
         popover="manual"
+        tabindex="-1"
         class="flex flex-col overflow-hidden rounded border border-ddt-color-divider floating-unready:hidden absolute left-[--floating-x,0] top-[--floating-y,0] min-w-[--floating-width] max-h-[12.5rem] opacity-1 transition-[opacity] max-w-min"
         @floating-ready=${this._handleFloatingReady}
         ${this._autoUpdateController.refFloating()}
       >
         <div
-          class="flex-1 overflow-y-auto break-all"
+          tabindex="-1"
+          class="flex-1 overflow-y-auto natural-break"
           aria-label=${ifDefined_js.ifDefined(this._label ?? void 0)}
           role="listbox"
         >
@@ -540,6 +545,10 @@ exports.DaikinCombobox = class DaikinCombobox extends ddsFormElement.DDSFormElem
         this.focus();
       }
     }
+    if (changedProperties.has("_currentFocusItemIndex")) {
+      const focusedItem = this.renderRoot.querySelector("[data-focus]");
+      focusedItem == null ? void 0 : focusedItem.scrollIntoView({ block: "nearest" });
+    }
   }
   /**
    * This method is used by `daikin-input-group` to reflect it's attributes to this component.
@@ -566,22 +575,22 @@ exports.DaikinCombobox.styles = lit.css`
     }
   `;
 __decorateClass([
-  decorators_js.property({ type: String, reflect: true })
+  ddsProperty.property({ type: String, reflect: true, fallbackValue: "" })
 ], exports.DaikinCombobox.prototype, "placeholder", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCombobox.prototype, "disabled", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCombobox.prototype, "required", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCombobox.prototype, "error", 2);
 __decorateClass([
-  decorators_js.property({ type: Boolean, reflect: true })
+  ddsProperty.property({ type: Boolean, reflect: true })
 ], exports.DaikinCombobox.prototype, "open", 2);
 __decorateClass([
-  decorators_js.property({ type: Array, attribute: false })
+  ddsProperty.property({ type: Array, attribute: false })
 ], exports.DaikinCombobox.prototype, "items", 2);
 __decorateClass([
   decorators_js.state()
@@ -590,7 +599,7 @@ __decorateClass([
   decorators_js.state()
 ], exports.DaikinCombobox.prototype, "_currentFocusItemIndex", 2);
 __decorateClass([
-  decorators_js.property({ attribute: false })
+  ddsProperty.property({ attribute: false })
 ], exports.DaikinCombobox.prototype, "filter", 2);
 __decorateClass([
   decorators_js.query("input")

package/dist/cjs-dev/components/combobox/daikin-combobox.d.cts

@@ -16,7 +16,14 @@ export type ComboboxItem = string | ComboboxOption;
 export declare function defaultFilterFn(items: readonly ComboboxItem[], value: string): readonly ComboboxItem[];
 /**
  * A combobox component.
- * Unlike a dropdown component, a combobox primarily functions as a text field (using a native <input> tag) that can accept custom user input. The dropdown list serves as a helpful aid to expedite the user's input process.
+ * Unlike a dropdown component, a combobox primarily functions as a text field (using a native `<input>` tag) that can accept custom user input. The dropdown list serves as a helpful aid to expedite the user's input process.
+ *
+ * @attr form - The form the component belongs to.
+ * @attr name - The form name, submitted as a name/value pair when submitting the form.
+ * @attr value - The initial form value, submitted as a name/value pair when submitting the form.
+ * @prop {String} formAttr - The form the component belongs to.
+ * @prop {String} name - The form name, submitted as a name/value pair when submitting the form.
+ * @prop {String} value - The form value, submitted as a name/value pair when submitting the form.
  *
  * @fires change - A custom event emitted when a user selects a combobox item or inputs a custom value.
  * @fires input - A retargeted event of a [input event](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event). Triggered when the user types in the input field, clicks clear button, or selects from dropdown options.
@@ -41,7 +48,7 @@ export declare class DaikinCombobox extends DDSFormElement {
     /**
      * Placeholder text of the combobox.
      */
-    placeholder: string | null;
+    placeholder: string;
     /**
      * Whether the combobox is disabled.
      */