@aquera/nile-elements 1.7.1 → 1.7.3

package/dist/src/nile-combobox/nile-combobox.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nile-combobox.css.js","sourceRoot":"","sources":["../../../src/nile-combobox/nile-combobox.css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0sBxB,CAAC;AAEF,eAAe,CAAC,MAAM,CAAC,CAAC","sourcesContent":["/**\n * Copyright Aquera Inc 2025\n *\n * This source code is licensed under the BSD-3-Clause license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport { css } from 'lit';\n\nexport const styles = css`\n  :host {\n    display: block;\n    box-sizing: border-box;\n    -webkit-font-smoothing: var(--nile-webkit-font-smoothing, var(--ng-webkit-font-smoothing));\n    -moz-osx-font-smoothing: var(--nile-moz-osx-font-smoothing, var(--ng-moz-osx-font-smoothing));\n    text-rendering: var(--nile-text-rendering, var(--ng-text-rendering));\n  }\n\n  :host *,\n  :host *::before,\n  :host *::after {\n    box-sizing: inherit;\n  }\n\n  [hidden] {\n    display: none;\n  }\n\n  /* ── Form control ── */\n\n  .form-control .form-control__label {\n    display: none;\n  }\n\n  .form-control--has-label .form-control__label {\n    display: block;\n    margin-bottom: var(--nile-spacing-sm, var(--ng-spacing-sm));\n    color: var(--nile-colors-dark-900, var(--ng-colors-text-secondary-700));\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-md));\n    font-style: normal;\n    font-weight: var(--nile-font-weight-regular, var(--ng-font-weight-medium));\n    line-height: var(--nile-spacing-2xl, var(--ng-line-height-text-sm));\n    letter-spacing: 0.2px;\n  }\n\n  .form-control--has-label.form-control--medium .form-control__label {\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n  }\n\n  :host([required]) .form-control--has-label .form-control__label::after {\n    content: '*';\n    margin-inline-start: -2px;\n    color: var(--nile-colors-red-700, var(--ng-colors-text-error-primary-600));\n  }\n\n  :host([disabled]) .form-control--has-label .form-control__label {\n    user-select: none;\n    -webkit-user-select: none;\n  }\n\n  /* ── Popup ── */\n\n  .combobox-popup {\n    flex: 1 1 auto;\n    display: inline-flex;\n    width: 100%;\n    position: relative;\n    vertical-align: middle;\n  }\n\n  .combobox-popup::part(popup) {\n    z-index: 9999;\n  }\n\n  .combobox-popup[data-current-placement^='top']::part(popup) {\n    transform-origin: bottom;\n  }\n\n  .combobox-popup[data-current-placement^='bottom']::part(popup) {\n    transform-origin: top;\n  }\n\n  /* ── Trigger: outer row that never scrolls ── */\n\n  .combobox__trigger {\n    display: flex;\n    align-items: center;\n    width: 100%;\n    min-width: 0;\n    position: relative;\n    font-family: var(--nile-font-family-sans-serif, var(--ng-font-family-body));\n    font-weight: var(--nile-font-weight-regular, var(--ng-font-weight-medium));\n    letter-spacing: normal;\n    cursor: text;\n    transition: 150ms color, 150ms border, 150ms box-shadow, 150ms background-color;\n    background-color: var(--nile-colors-white-base, var(--ng-colors-bg-primary));\n    border: solid 1px var(--nile-colors-neutral-500, var(--ng-colors-border-primary));\n    outline: none;\n  }\n\n  .combobox__trigger:hover {\n    border-color: var(--nile-colors-dark-900, var(--ng-colors-border-neutral));\n  }\n\n  .combobox--open .combobox__trigger,\n  .combobox--focused .combobox__trigger {\n    border-color: var(--ng-colors-border-brand);\n    box-shadow: 0 0 0 1px var(--ng-colors-border-brand) inset;\n    background-color: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n  }\n\n  .combobox--disabled .combobox__trigger {\n    background-color: var(--nile-colors-dark-200, var(--ng-colors-bg-disabled-subtle));\n    border-color: var(--nile-colors-neutral-500, var(--ng-colors-border-primary));\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-disabled));\n    cursor: not-allowed;\n    user-select: none;\n  }\n\n  .combobox--warning .combobox__trigger {\n    border-color: var(--nile-colors-yellow-500, var(--ng-colors-border-warning));\n  }\n\n  .combobox--error .combobox__trigger {\n    border-color: var(--nile-colors-red-500, var(--ng-colors-border-error));\n  }\n\n  .combobox--success .combobox__trigger {\n    border-color: var(--nile-colors-green-500, var(--ng-componentcolors-utility-success-500));\n  }\n\n  /* Size: small */\n  .combobox--small .combobox__trigger {\n    border-radius: var(--nile-radius-sm, var(--ng-radius-md));\n    font-size: var(--nile-type-scale-2, var(--ng-font-size-text-xs));\n    padding: var(--nile-spacing-md, var(--ng-spacing-sm)) var(--nile-spacing-md, var(--ng-spacing-md));\n    min-height: var(--nile-height-32px, var(--ng-height-32px));\n  }\n\n  /* Size: medium */\n  .combobox--medium .combobox__trigger {\n    border-radius: var(--nile-radius-sm, var(--ng-radius-md));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-md));\n    padding: var(--nile-spacing-lg, var(--ng-spacing-md)) var(--nile-spacing-lg, var(--ng-spacing-lg));\n    min-height: var(--nile-height-40px, var(--ng-height-40px));\n    box-sizing: border-box;\n  }\n\n  /* Size: large */\n  .combobox--large .combobox__trigger {\n    border-radius: var(--nile-radius-sm, var(--ng-radius-md));\n    font-size: var(--nile-type-scale-4, var(--ng-font-size-text-md));\n    padding: var(--nile-spacing-xl, var(--ng-spacing-lg)) var(--nile-spacing-xl, var(--ng-spacing-xl));\n    min-height: var(--nile-height-48px, var(--ng-height-48px));\n  }\n\n  .combobox--pill .combobox__trigger {\n    border-radius: var(--nile-radius-3xl, var(--ng-radius-3xl));\n  }\n\n  .combobox--filled .combobox__trigger {\n    border: none;\n    background-color: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n  }\n\n  .combobox--filled.combobox--open .combobox__trigger,\n  .combobox--filled.combobox--focused .combobox__trigger {\n    outline: 3px solid rgba(0, 89, 255, 0.4);\n  }\n\n  /* ── Inner area: holds tags + input ── */\n\n  .combobox__scroll-area {\n    flex: 1;\n    min-width: 0;\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    gap: 4px;\n    overflow: hidden;\n  }\n\n  /* Single-line: horizontal scroll for overflowing tags */\n  .combobox__scroll-area--single-line {\n    flex-wrap: nowrap;\n    overflow-x: auto;\n    overflow-y: hidden;\n    -webkit-overflow-scrolling: touch;\n    scrollbar-width: thin;\n    scrollbar-color: var(--nile-colors-neutral-500, var(--ng-colors-border-primary)) transparent;\n  }\n\n  .combobox__scroll-area--single-line::-webkit-scrollbar {\n    height: 3px;\n  }\n\n  .combobox__scroll-area--single-line::-webkit-scrollbar-track {\n    background: transparent;\n  }\n\n  .combobox__scroll-area--single-line::-webkit-scrollbar-thumb {\n    background: var(--nile-colors-neutral-500, var(--ng-colors-bg-quaternary));\n    border-radius: 3px;\n  }\n\n  .combobox__scroll-area--single-line::-webkit-scrollbar-thumb:hover {\n    background: var(--nile-colors-dark-500, var(--ng-colors-fg-quaternary-400));\n  }\n\n  /* Wrap: tags flow to multiple lines, trigger grows in height */\n  .combobox__scroll-area--wrap {\n    flex-wrap: wrap;\n    overflow: visible;\n  }\n\n  /* ── Tags inside the scroll area ── */\n\n  .combobox__scroll-area nile-tag {\n    cursor: pointer;\n    flex-shrink: 0;\n  }\n\n  .combobox--disabled .combobox__scroll-area nile-tag {\n    cursor: not-allowed;\n  }\n\n  .combobox__tags-count {\n    color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    font-weight: var(--nile-font-weight-regular, var(--ng-font-weight-medium));\n    line-height: var(--nile-line-height-xsmall, var(--ng-line-height-text-sm));\n    letter-spacing: 0.2px;\n    white-space: nowrap;\n    flex-shrink: 0;\n  }\n\n  /* ── Input wrapper inside scroll area ── */\n\n  .combobox__input-wrapper {\n    flex: 1;\n    min-width: 60px;\n    display: flex;\n    align-items: center;\n  }\n\n  .combobox__input {\n    width: 100%;\n    font: inherit;\n    border: none;\n    background: none;\n    color: var(--nile-colors-dark-900, var(--ng-colors-text-primary-900));\n    cursor: inherit;\n    overflow: hidden;\n    padding: 0;\n    margin: 0;\n    -webkit-appearance: none;\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: inherit;\n    font-weight: var(--nile-font-weight-regular, var(--ng-font-weight-regular));\n    text-overflow: ellipsis;\n    line-height: var(--nile-line-height-xsmall, var(--ng-line-height-text-sm));\n  }\n\n  .combobox__input::placeholder {\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    color: var(--nile-colors-text-placeholder, var(--ng-colors-text-placeholder));\n  }\n\n  .combobox__input:focus {\n    outline: none;\n  }\n\n  .combobox--disabled .combobox__input {\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-disabled));\n    pointer-events: none;\n  }\n\n  /* ── Hidden form value input ── */\n\n  .combobox__value-input {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    padding: 0;\n    margin: 0;\n    opacity: 0;\n    z-index: -1;\n  }\n\n  /* ── Action icons (clear, expand) ── */\n\n  .combobox__actions {\n    display: flex;\n    align-items: center;\n    flex-shrink: 0;\n    gap: var(--nile-spacing-sm, var(--ng-spacing-sm));\n    margin-inline-start: auto;\n  }\n\n  .combobox__clear {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    border: none;\n    background: none;\n    padding: 0;\n    cursor: pointer;\n    color: var(--nile-colors-dark-500, var(--ng-colors-fg-quaternary-400));\n    transition: 150ms color;\n  }\n\n  .combobox__clear:hover {\n    color: var(--nile-colors-dark-900, var(--ng-colors-text-primary-900));\n  }\n\n  .combobox__clear:focus {\n    outline: none;\n  }\n\n  .combobox__expand-icon {\n    display: flex;\n    align-items: center;\n    flex-shrink: 0;\n    transition: 250ms rotate ease;\n    rotate: 0;\n  }\n\n  .combobox--open .combobox__expand-icon {\n    rotate: -180deg;\n  }\n\n  /* ── Prefix / suffix ── */\n\n  .combobox__prefix,\n  .combobox__suffix {\n    flex: 0;\n    display: inline-flex;\n    align-items: center;\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-tertiary-600));\n  }\n\n  .combobox__prefix {\n    margin-inline-end: var(--nile-spacing-md, var(--ng-spacing-md));\n  }\n\n  /* ── Listbox (dropdown) ── */\n\n  .combobox__listbox {\n    display: block;\n    position: relative;\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-md));\n    font-weight: var(--nile-font-weight-regular, var(--ng-font-weight-regular));\n    background: var(--nile-colors-white-base, var(--ng-colors-bg-primary));\n    border: solid 1px var(--nile-colors-neutral-500, var(--ng-colors-border-secondary-alt));\n    border-radius: var(--nile-radius-sm, var(--ng-radius-md));\n    padding-block: var(--nile-spacing-none, var(--ng-spacing-xs));\n    padding-inline: var(--nile-spacing-none, var(--ng-spacing-xs));\n    overscroll-behavior: none;\n    overflow-y: auto;\n    max-width: var(--auto-size-available-width);\n    max-height: var(--auto-size-available-height);\n    box-shadow: 0px 2px 4px 0px rgba(119, 125, 130, 0.15);\n  }\n\n  /* ── Options ── */\n\n  .combobox__options {\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    color: rgb(133, 129, 129);\n    width: 100%;\n  }\n\n  .combobox__options.loading {\n    opacity: 0.5;\n    pointer-events: none;\n  }\n\n  .combobox__no-results {\n    padding: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-tertiary-600));\n    text-align: center;\n  }\n\n  .combobox__no-results-title {\n    font-weight: var(--nile-font-weight-medium, var(--ng-font-weight-medium));\n    color: var(--nile-colors-dark-700, var(--ng-colors-text-secondary-700));\n  }\n\n  .combobox__no-results-subtitle {\n    margin-top: var(--nile-spacing-xs, var(--ng-spacing-xs));\n    font-size: var(--nile-type-scale-2, var(--ng-font-size-text-xs));\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-tertiary-600));\n  }\n\n  /* ── Options (both virtual and plain) ── */\n\n  .combobox__options nile-option {\n    width: 100%;\n    display: block;\n  }\n\n  .combobox__options nile-option[selected] {\n    background-color: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n  }\n\n  .combobox__options nile-option[selected]::part(base) {\n    color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));\n  }\n\n  .combobox__options-plain {\n    display: flex;\n    flex-direction: column;\n  }\n\n  .combobox__options-plain nile-option {\n    flex-shrink: 0;\n  }\n\n  /* ── Top actions (Select All + Selected/All filter toggle) ── */\n\n  .combobox__top-actions {\n    position: sticky;\n    top: 0;\n    z-index: 2;\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    justify-content: space-between;\n    gap: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    background: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n    border-bottom: 1px solid var(--nile-colors-neutral-400, var(--ng-colors-border-secondary));\n    padding: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    user-select: none;\n  }\n\n  .combobox__top-actions--disabled {\n    opacity: 0.6;\n    pointer-events: none;\n  }\n\n  .combobox__select-all {\n    display: flex;\n    align-items: center;\n    gap: var(--nile-spacing-md, var(--ng-spacing-md));\n    cursor: pointer;\n    flex: 1 1 auto;\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    line-height: 14px;\n    letter-spacing: 0.2px;\n    color: var(--nile-colors-dark-900, var(--ng-colors-text-primary));\n  }\n\n  .combobox__show-toggle {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--nile-spacing-md, var(--ng-spacing-md));\n    border: none;\n    background: none;\n    padding: 0;\n    border-radius: var(--nile-radius-sm, var(--ng-radius-sm));\n    cursor: pointer;\n    color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    line-height: 14px;\n    letter-spacing: 0.2px;\n    white-space: nowrap;\n  }\n\n  .combobox__show-toggle[disabled] {\n    color: var(--nile-colors-primary-500, var(--ng-colors-fg-quaternary-400));\n    cursor: not-allowed;\n  }\n\n  /* ── Footer ── */\n\n  .combobox__footer {\n    position: sticky;\n    bottom: 0;\n    background: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n    border-top: 1px solid var(--nile-colors-neutral-400, var(--ng-colors-border-secondary));\n    display: flex;\n    flex-direction: row;\n    align-items: flex-start;\n    padding: var(--nile-spacing-md, var(--ng-spacing-md)) var(--nile-spacing-lg, var(--ng-spacing-lg)) var(--nile-spacing-xl, var(--ng-spacing-xl));\n    gap: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    justify-content: space-between;\n  }\n\n  .combobox__footer.loading {\n    opacity: 0.5;\n    pointer-events: none;\n  }\n\n  .combobox__footer-clear {\n    display: inline-flex;\n    align-items: center;\n    color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));\n    border: none;\n    background: none;\n    padding: 0;\n    cursor: pointer;\n    font-family: var(--nile-font-family-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n    letter-spacing: 0.2px;\n  }\n\n  .combobox__footer-clear:hover {\n    text-decoration: underline;\n  }\n\n  /* ── Loader ── */\n\n  .combobox__loader {\n    width: 100%;\n    text-align: center;\n    display: block;\n  }\n\n  .combobox__loader--icon {\n    margin-top: var(--nile-spacing-xl, var(--ng-spacing-xl));\n    animation: combobox-spin 0.6s linear infinite;\n  }\n\n  .combobox__loader--center {\n    position: absolute;\n    display: flex;\n    justify-content: center;\n    align-items: center;\n    width: 100%;\n    height: 75%;\n  }\n\n  @keyframes combobox-spin {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n  }\n\n  .combobox__add-option::part(base) {\n    color: var(--nile-colors-primary-600, var(--ng-colors-text-brand-secondary-700));\n  }\n\n  /* ── Grid layout ── */\n\n  :host([grid-columns]) .combobox__listbox {\n    overflow-y: auto;\n  }\n\n  .combobox__grid-row {\n    width: 100%;\n  }\n\n  .combobox__grid-row nile-option {\n    min-width: 0;\n    overflow: hidden;\n  }\n\n  .combobox__grid-row nile-option::part(base) {\n    border-radius: var(--nile-radius-xs, var(--ng-radius-sm));\n  }\n\n  /* ── Bidirectional grid layout (vertical + horizontal scroll) ── */\n\n  .combobox__listbox.combobox__listbox--bidirectional {\n    overflow: auto;\n    max-width: none;\n    scrollbar-width: thin;\n    scrollbar-color: var(--nile-colors-neutral-500, var(--ng-colors-bg-quaternary)) transparent;\n  }\n\n  .combobox__listbox--bidirectional .combobox__options {\n    width: max-content;\n    min-width: 100%;\n  }\n\n  .combobox__listbox--bidirectional .combobox__grid-row {\n    width: max-content;\n    min-width: 100%;\n  }\n\n  /* ── Horizontal grid layout ── */\n\n  .combobox__listbox.combobox__listbox--horizontal {\n    overflow-x: auto;\n    overflow-y: hidden;\n    max-height: none;\n    max-width: none;\n    width: 100%;\n    scrollbar-width: thin;\n    scrollbar-color: var(--nile-colors-neutral-500, var(--ng-colors-bg-quaternary)) transparent;\n  }\n\n  .combobox__listbox--horizontal::-webkit-scrollbar {\n    height: 6px;\n  }\n\n  .combobox__listbox--horizontal::-webkit-scrollbar-track {\n    background: transparent;\n  }\n\n  .combobox__listbox--horizontal::-webkit-scrollbar-thumb {\n    background: var(--nile-colors-neutral-500, var(--ng-colors-bg-quaternary));\n    border-radius: 3px;\n  }\n\n  .combobox__listbox--horizontal::-webkit-scrollbar-thumb:hover {\n    background: var(--nile-colors-dark-500, var(--ng-colors-fg-quaternary-400));\n  }\n\n  .combobox__options--horizontal {\n    display: block;\n    width: max-content;\n    min-width: 100%;\n  }\n\n  .combobox__grid-col {\n    border-right: 1px solid var(--nile-colors-neutral-200, var(--ng-colors-border-secondary));\n  }\n\n  .combobox__grid-col:last-child {\n    border-right: none;\n  }\n\n  .combobox__grid-col nile-option {\n    width: 100%;\n    display: block;\n  }\n\n  .combobox__grid-col nile-option::part(base) {\n    border-radius: 0;\n  }\n\n  /* ── Group headers (data-driven grouping) ── */\n\n  /* Plain (non-virtualized) listbox: sticky relative to the scroll container.\n   * Activated only when the host has [sticky-group-header]. */\n  :host([sticky-group-header]) .combobox__options-plain .combobox__group-header {\n    position: sticky;\n    top: calc(var(--group-depth, 0) * 28px);\n    z-index: 1;\n  }\n\n  /* Virtualized listbox: each row is absolutely positioned by the virtualizer.\n   * Sticky doesn't pin against the scroll container because the row wrapper's\n   * transform creates a containing block. Instead we render a separate\n   * overlay inside the listbox that mirrors the currently-active group\n   * header (computed on scroll). */\n  .combobox__group-header-slot {\n    pointer-events: none;\n  }\n  .combobox__group-header-slot .combobox__group-header {\n    height: 100%;\n    box-sizing: border-box;\n  }\n\n  .combobox__group-sticky-overlay {\n    position: sticky;\n    top: 0;\n    z-index: 2;\n    pointer-events: none;\n  }\n  .combobox__group-sticky-overlay .combobox__group-header {\n    box-shadow: 0 1px 0 0 var(--nile-colors-neutral-300, var(--ng-colors-border-secondary));\n  }\n\n  .combobox__group-header {\n    display: flex;\n    align-items: center;\n    gap: 6px;\n    box-sizing: border-box;\n    width: 100%;\n    height: 100%;\n    /* Match the listbox's natural inline padding so the header sits like a\n     * section divider, edge-to-edge with options. Nested groups indent by\n     * depth. Override with --combobox-group-header-indent if needed. */\n    padding-block: 8px;\n    padding-inline-end: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    padding-inline-start: calc(var(--combobox-group-header-indent, var(--nile-spacing-lg, var(--ng-spacing-lg))) + var(--group-depth, 0) * 16px);\n    font-family: var(--nile-font-family-sans-serif, var(--ng-font-family-body));\n    font-size: var(--nile-type-scale-2, var(--ng-font-size-text-xs));\n    font-weight: var(--nile-font-weight-semibold, var(--ng-font-weight-semibold));\n    line-height: 1;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-tertiary-600));\n    background: var(--nile-colors-neutral-100, var(--ng-colors-bg-secondary));\n    border-bottom: 1px solid var(--nile-colors-neutral-300, var(--ng-colors-border-secondary));\n    pointer-events: none;\n    user-select: none;\n  }\n\n  .combobox__group-label {\n    flex: 1;\n    min-width: 0;\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n\n  .combobox__group-prefix {\n    flex-shrink: 0;\n    color: inherit;\n  }\n\n  /* ── Help / Error ── */\n\n  .form-control__help-text {\n    display: none;\n  }\n\n  .form-control--has-help-text .form-control__help-text {\n    display: block;\n    color: var(--nile-colors-dark-500, var(--ng-colors-text-tertiary-600));\n    margin-top: var(--nile-spacing-lg, var(--ng-spacing-lg));\n    font-size: var(--nile-type-scale-3, var(--ng-font-size-text-sm));\n  }\n`;\n\nexport default [styles];\n"]}

package/dist/src/nile-combobox/nile-combobox.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Copyright Aquera Inc 2025
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import '../nile-icon';
+import '../nile-popup/nile-popup';
+import '../nile-tag/nile-tag';
+import '../nile-option/nile-option';
+import '../nile-checkbox/nile-checkbox';
+import '../nile-loader/nile-loader';
+import NileElement from '../internal/nile-element';
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+import type { NileFormControl } from '../internal/nile-element';
+import type NilePopup from '../nile-popup/nile-popup';
+import type { ComboboxOption, ComboboxRenderItemConfig, ComboboxTagLayout, ComboboxSize, ComboboxPlacement } from './types.js';
+/**
+ * @summary A data-driven combobox with virtualized options, inline search, multi-select tags,
+ * custom value creation, and full WAI-ARIA Combobox keyboard navigation.
+ *
+ * @tag nile-combobox
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency nile-icon
+ * @dependency nile-popup
+ * @dependency nile-tag
+ * @dependency nile-checkbox
+ * @dependency nile-loader
+ *
+ * @slot label - The input's label.
+ * @slot prefix - Prepend a presentational icon or element before the input.
+ * @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/collapsed.
+ * @slot help-text - Text that describes how to use the input.
+ * @slot footer - Custom footer content (overrides default footer in multi-select mode).
+ * @slot no-results - Custom no-results content.
+ *
+ * @event nile-change - Emitted when the control's value changes.
+ * @event nile-clear - Emitted when the control's value is cleared.
+ * @event nile-input - Emitted when the control receives input.
+ * @event nile-focus - Emitted when the control gains focus.
+ * @event nile-blur - Emitted when the control loses focus.
+ * @event nile-show - Emitted when the dropdown opens.
+ * @event nile-after-show - Emitted after the dropdown opens and all animations complete.
+ * @event nile-hide - Emitted when the dropdown closes.
+ * @event nile-after-hide - Emitted after the dropdown closes and all animations complete.
+ * @event nile-search - Emitted (debounced) when the user types. Useful for API-driven filtering.
+ * @event nile-tag-remove - Emitted when a tag is removed in multi-select mode.
+ * @event nile-tag-add - Emitted when a custom value is added via allowCustomValue.
+ * @event nile-scroll-end - Emitted when scrolled to the bottom (for infinite loading).
+ * @event nile-invalid - Emitted when form validation constraints aren't satisfied.
+ * @event nile-select-all - Emitted when the Select all / Deselect all control toggles. Detail: { value, name, action: 'select-all' | 'deselect-all' }.
+ *
+ * @csspart form-control - The form control wrapper.
+ * @csspart form-control-label - The label wrapper.
+ * @csspart form-control-input - The input area wrapper.
+ * @csspart combobox - The combobox trigger (input + tags + icons).
+ * @csspart input - The text input element.
+ * @csspart listbox - The dropdown listbox.
+ * @csspart tags - The tags container in multi-select mode.
+ * @csspart tag - Each individual tag.
+ * @csspart clear-button - The clear button.
+ * @csspart expand-icon - The expand/collapse icon.
+ * @csspart top-actions - The sticky row above the option list that contains the Select all checkbox and the Selected / Show all filter toggle. Rendered only when multiple && selectAllEnabled.
+ * @csspart select-all - The Select all / Deselect all checkbox wrapper inside top-actions.
+ * @csspart show-toggle - The "Selected / Show all" filter button inside top-actions.
+ * @csspart no-results - The empty-state container shown when a search/filter returns no items. Contains no-results-title and no-results-subtitle.
+ * @csspart no-results-title - The title row of the no-results empty state.
+ * @csspart no-results-subtitle - The subtitle row of the no-results empty state.
+ * @csspart no-data - The empty-state container shown when the dataset is empty (no active search/filter).
+ * @csspart footer - The footer with "Show Selected" / "Clear All".
+ * @csspart no-results - The no-results message.
+ */
+export declare class NileCombobox extends NileElement implements NileFormControl {
+    static styles: CSSResultGroup;
+    private readonly formControlController;
+    private readonly hasSlotController;
+    private readonly portalManager;
+    private readonly searchManager;
+    private scrollElementRef;
+    private virtualizerCtrl;
+    private hScrollElementRef;
+    private hVirtualizerCtrl;
+    private scrollTimeout;
+    private scrolling;
+    private visibilityManager?;
+    private keyboardActiveIndex;
+    popup: NilePopup;
+    combobox: HTMLElement;
+    inputElement: HTMLInputElement;
+    valueInput: HTMLInputElement;
+    private hasFocus;
+    displayLabel: string;
+    selectedOptions: ComboboxOption[];
+    /** The items displayed after filtering. Renderer reads from this. */
+    filteredData: any[];
+    /**
+     * Mixed (header + option) row list, only populated when `data` contains
+     * group entries (`type: 'group'`). When non-empty, the listbox renders from
+     * this instead of `filteredData`. `filteredData` stays in sync as the
+     * option-only projection so existing select-all / strict-match / etc. logic
+     * keeps working unchanged.
+     */
+    private filteredRows;
+    /** The complete unfiltered dataset (preserved for re-filtering). */
+    private originalData;
+    showNoResults: boolean;
+    showListbox: boolean;
+    searchValue: string;
+    private showSelectedOnly;
+    private selectAllChecked;
+    private selectAllIndeterminate;
+    /**
+     * Index into `filteredRows` of the group header that should be pinned at
+     * the top of the (virtualized) listbox right now. -1 means none.
+     * Recomputed on scroll.
+     */
+    private stickyHeaderIndex;
+    name: string;
+    data: any[];
+    value: string | string[];
+    defaultValue: string | string[];
+    size: ComboboxSize;
+    placeholder: string;
+    multiple: boolean;
+    label: string;
+    required: boolean;
+    disabled: boolean;
+    open: boolean;
+    clearable: boolean;
+    loading: boolean;
+    optionsLoading: boolean;
+    /** When true, skip local filtering and rely solely on the `nile-search` event for API-driven results. */
+    disableLocalSearch: boolean;
+    /** When true, displays a "+ Add [value]" option for values not in the data. */
+    allowCustomValue: boolean;
+    /** When true, typing free text and pressing Enter/Tab adds it as a tag (like nile-chip's acceptUserInput). */
+    acceptUserInput: boolean;
+    /** When true, custom values added via allowCustomValue or acceptUserInput are also appended to the suggestions list. */
+    addToSuggestions: boolean;
+    /** When true, value must match an option. On blur, reverts to the last valid value if text doesn't match. */
+    strict: boolean;
+    /** Max tags visible before showing "+N more" (0 = no limit). */
+    maxTagsVisible: number;
+    /** Controls how tags wrap in multi-select mode. */
+    tagLayout: ComboboxTagLayout;
+    /**
+     * Show footer with "Show Selected" and "Clear All" in multi-select mode.
+     * Automatically suppressed when `selectAllEnabled` is true, since the top
+     * actions row already provides the same controls.
+     */
+    showFooter: boolean;
+    /**
+     * When true (and `multiple` is true), renders a "Select all" / "Deselect all"
+     * checkbox at the top of the listbox. Operates on the currently visible,
+     * non-disabled options (respects the active search filter).
+     */
+    selectAllEnabled: boolean;
+    /**
+     * When true (default), data-driven group headers stick to the top of the
+     * listbox while scrolling through that group's options (Atlassian-style).
+     * Works in both plain and virtualized rendering modes. Set to false for
+     * inline-only headers that scroll away with their options.
+     */
+    stickyGroupHeader: boolean;
+    portal: boolean;
+    hoist: boolean;
+    placement: ComboboxPlacement;
+    form: string;
+    helpText: string;
+    errorMessage: string;
+    warning: boolean;
+    error: boolean;
+    success: boolean;
+    filled: boolean;
+    pill: boolean;
+    noResultsMessage: string;
+    noResultsSubtitle: string;
+    noDataMessage: string;
+    /**
+     * Pre-defined autocomplete suggestions. Accepts a JSON array string attribute
+     * or a JS array property (like nile-chip). When `addToSuggestions` is true,
+     * custom values added by the user are appended to this list and persisted.
+     */
+    autoCompleteOptions: any[];
+    /** Debounce interval (ms) for the nile-search event. */
+    debounceMs: number;
+    renderItemConfig?: ComboboxRenderItemConfig;
+    allowHtmlLabel: boolean;
+    enableVisibilityEffect: boolean;
+    enableTabClose: boolean;
+    noWidthSync: boolean;
+    /** Number of columns in the dropdown grid (vertical scroll). When > 1, options render in a multi-column grid layout. */
+    gridColumns: number;
+    /** Number of visible rows in horizontal grid mode. When > 0, enables horizontal virtual scroll with columns scrolling left/right. */
+    gridRows: number;
+    /** Width of each column in horizontal grid mode (px). */
+    gridColumnWidth: number;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected firstUpdated(_changed: PropertyValues): void;
+    protected updated(changedProperties: PropertyValues): void;
+    private get isHorizontalGrid();
+    /** True when the source data contains at least one group entry. */
+    private get hasGroupedData();
+    /**
+     * Walk filteredRows and find the index of the deepest group header whose
+     * virtual position is at or above `scrollTop`. That's the header that
+     * should be pinned at the top of the listbox right now.
+     */
+    private updateStickyHeader;
+    /** Recursively keep only options whose value is in `selectedSet`; drop empty groups. */
+    private pruneTreeBySelection;
+    private get hasActiveFilter();
+    private renderEmptyState;
+    private get isBidirectionalGrid();
+    private get virtualRowCount();
+    private get virtualColumnCount();
+    private updateVirtualizerCount;
+    private lastVirtualizerGrouped;
+    private getDisplayText;
+    private getItemValue;
+    private getSearchText;
+    private getItemDescription;
+    private getItemPrefix;
+    private getItemSuffix;
+    private syncSelection;
+    /**
+     * Returns the options eligible for Select All — the currently filtered data
+     * (so the active search/filter is respected) minus any `disabled` items.
+     * Mirrors nile-select's `getSelectableOptions()` contract.
+     */
+    private getSelectableData;
+    /**
+     * Derives `selectAllChecked` + `selectAllIndeterminate` from the current
+     * selection vs. the selectable set. No-op when `multiple` is false.
+     *
+     *   options=0            → both false (nothing to select, e.g. empty search)
+     *   selected=0           → checked=false, indeterminate=false
+     *   selected=options     → checked=true,  indeterminate=false
+     *   otherwise (partial)  → checked=false, indeterminate=true
+     */
+    private updateSelectAllState;
+    /**
+     * Toggles all selectable, visible options. Indeterminate → clears selection
+     * (matches the "Deselect All" label flip), empty → selects all,
+     * fully-selected → clears.
+     */
+    private handleSelectAllToggle;
+    private handleDocumentFocusIn;
+    private handleDocumentKeyDown;
+    private handleDocumentMouseDown;
+    private handleWindowError;
+    private handleWindowResize;
+    private handleWindowScroll;
+    private setupBoundHandlers;
+    private addOpenListeners;
+    private removeOpenListeners;
+    private onInputKeyDown;
+    private onGlobalKeyDown;
+    private getVisibleOptions;
+    private moveActiveOption;
+    private setActiveOption;
+    private selectActiveOption;
+    private onInputChange;
+    private onInputHandler;
+    private filterOptions;
+    private onFocusIn;
+    private onFocusOut;
+    private onTriggerMouseDown;
+    private onOptionClick;
+    private handleOptionSelection;
+    private addCustomValue;
+    private onClearClick;
+    private removeTag;
+    private onFooterClick;
+    private toggleShowSelected;
+    private clearAll;
+    private onScroll;
+    show(): Promise<unknown>;
+    hide(): Promise<unknown>;
+    handleOpenChange(): Promise<void>;
+    private doOpen;
+    private doClose;
+    handleDisabledChange(): void;
+    handleValueChange(): void;
+    handleDataChange(): void;
+    handleAutoCompleteOptionsChange(): void;
+    handleSelectAllConfigChange(): void;
+    handlePortalChange(): void;
+    checkValidity(): boolean;
+    getForm(): HTMLFormElement | null;
+    reportValidity(): boolean;
+    setCustomValidity(message: string): void;
+    focus(options?: FocusOptions): void;
+    blur(): void;
+    private handleInvalid;
+    private updateValidity;
+    private resetScrollPosition;
+    render(): TemplateResult;
+    private renderTrigger;
+    private renderInlineTags;
+    private renderClearButton;
+    private renderStickyHeaderOverlay;
+    private renderListbox;
+    private renderHorizontalListbox;
+    private renderLoader;
+    private renderSelectAll;
+    private renderFooter;
+}
+export default NileCombobox;
+declare global {
+    interface HTMLElementTagNameMap {
+        'nile-combobox': NileCombobox;
+    }
+}