@aquera/nile-elements 0.1.58 → 0.1.59-beta-1.1

package/src/nile-select/nile-select.ts

@@ -33,8 +33,11 @@ import type { CSSResultGroup, PropertyValues } from 'lit';
 import type { NileFormControl } from '../internal/nile-element';
 import type NileOption from '../nile-option/nile-option';
 import type NilePopup from '../nile-popup/nile-popup';
+import type { RenderItemConfig } from '../nile-virtual-select/types.js';
 import { unsafeHTML } from 'lit/directives/unsafe-html.js';
 import { ifDefined } from 'lit/directives/if-defined.js';
+import '../nile-virtual-select/nile-virtual-select';
+import { VirtualScrollHelper } from './virtual-scroll-helper';
 
 type NileRemoveEvent = CustomEvent<Record<PropertyKey, never>>;
 
@@ -53,6 +56,7 @@ type NileRemoveEvent = CustomEvent<Record<PropertyKey, never>>;
  * @dependency nile-icon
  * @dependency nile-popup
  * @dependency nile-tag
+ * @dependency nile-virtual-select
  *
  * @slot - The listbox options. Must be `<nile-option>` elements. You can use `<nile-divider>` to group items visually.
  * @slot label - The input's label. Alternatively, you can use the `label` attribute.
@@ -91,14 +95,15 @@ type NileRemoveEvent = CustomEvent<Record<PropertyKey, never>>;
  */
 
 @customElement('nile-select')
-export class NileSelect extends NileElement implements NileFormControl {
+export class NileSelect extends NileElement implements NileFormControl{
   static styles: CSSResultGroup = styles;
 
   // protected override BUBBLES=false;
 
-  private readonly formControlController = new FormControlController(this, {
-    assumeInteractionOn: ['nile-blur', 'nile-input'],
-  });
+  private formControlController: FormControlController | null;
+  private virtualScrollHelper!: VirtualScrollHelper;
+
+
   private readonly hasSlotController = new HasSlotController(
     this,
     'help-text',
@@ -232,6 +237,13 @@ export class NileSelect extends NileElement implements NileFormControl {
 
   @property({ type: String }) noResultsMessage: string = 'No results found';
 
+  /** Enhanced configuration for rendering items with support for display text, value, and search text */
+  @property({ attribute: false }) renderItemConfig?: RenderItemConfig;
+
+  @property({ type: Array }) data: any = [];
+
+  @property({ type: Boolean }) enableVirtualScroll = false;
+
   /** Gets the validity state object */
   get validity() {
     return this.valueInput?.validity;
@@ -242,8 +254,18 @@ export class NileSelect extends NileElement implements NileFormControl {
     return this.valueInput?.validationMessage;
   }
 
+  constructor() {
+    super();
+  }
+
   connectedCallback() {
     super.connectedCallback();
+    if(!this.enableVirtualScroll) {
+      this.formControlController = new FormControlController(this, {
+          assumeInteractionOn: ['nile-blur', 'nile-input'],
+      });
+    }
+    this.virtualScrollHelper = new VirtualScrollHelper(this);
     this.handleDocumentFocusIn = this.handleDocumentFocusIn.bind(this);
     this.handleDocumentKeyDown = this.handleDocumentKeyDown.bind(this);
     this.handleDocumentMouseDown = this.handleDocumentMouseDown.bind(this);
@@ -747,7 +769,7 @@ export class NileSelect extends NileElement implements NileFormControl {
 
     // Update validity
     this.updateComplete.then(() => {
-      this.formControlController.updateValidity();
+      this.formControlController?.updateValidity();
     });
 
     this.calculateTotalWidthOfTags();
@@ -798,8 +820,8 @@ export class NileSelect extends NileElement implements NileFormControl {
   }
 
   private handleInvalid(event: Event) {
-    this.formControlController.setValidity(false);
-    this.formControlController.emitInvalidEvent(event);
+    this.formControlController?.setValidity(false);
+    this.formControlController?.emitInvalidEvent(event);
   }
 
   @watch('disabled', { waitUntilFirstUpdate: true })
@@ -902,7 +924,7 @@ export class NileSelect extends NileElement implements NileFormControl {
 
   /** Gets the associated form, if one exists. */
   getForm(): HTMLFormElement | null {
-    return this.formControlController.getForm();
+    return this.formControlController?.getForm() || null;
   }
 
   /** Checks for validity and shows the browser's validation message if the control is invalid. */
@@ -913,7 +935,7 @@ export class NileSelect extends NileElement implements NileFormControl {
   /** Sets a custom validation message. Pass an empty string to restore validity. */
   setCustomValidity(message: string) {
     this.valueInput.setCustomValidity(message);
-    this.formControlController.updateValidity();
+    this.formControlController?.updateValidity();
   }
 
   /** Sets focus on the control. */
@@ -986,6 +1008,10 @@ export class NileSelect extends NileElement implements NileFormControl {
   }
 
   render() {
+    if(this.enableVirtualScroll) {
+      return this.virtualScrollHelper.renderVirtualizedContent();
+    }
+
     const hasLabelSlot = this.hasSlotController.test('label');
     const hasHelpTextSlot = this.hasSlotController.test('help-text');
     const hasLabelSuffixSlot = this.hasSlotController.test('label-suffix');

package/src/nile-select/virtual-scroll-helper.ts

@@ -0,0 +1,56 @@
+import { html } from 'lit';
+import type NileElement from '../internal/nile-element';
+
+/**
+ * Helper class to manage virtual scroll functionality for nile-select component
+ */
+export class VirtualScrollHelper {
+  private component: NileElement;
+
+  constructor(component: NileElement) {
+    this.component = component;
+  }
+
+  renderVirtualizedContent(): any {
+    const component = this.component as any;
+
+    return html`
+      <div class="virtual-select">
+        <nile-virtual-select
+          .name=${component.name}
+          .value=${component.value}
+          .placeholder=${component.placeholder}
+          .size=${component.size}
+          .searchEnabled=${component.searchEnabled}
+          .internalSearchPlaceHolder=${component.internalSearchPlaceHolder}
+          .disableLocalSearch=${component.disableLocalSearch}
+          .optionsLoading=${component.optionsLoading}
+          .multiple=${component.multiple}
+          .helpText=${component.helpText}
+          .errorMessage=${component.errorMessage}
+          .warning=${component.warning}
+          .error=${component.error}
+          .success=${component.success}
+          .disabled=${component.disabled}
+          .clearable=${component.clearable}
+          .hoist=${component.hoist}
+          .filled=${component.filled}
+          .pill=${component.pill}
+          .label=${component.label}
+          .placement=${component.placement}
+          .form=${component.form}
+          .required=${component.required}
+          .showNoResults=${component.showNoResults}
+          .noResultsMessage=${component.noResultsMessage}
+          .renderItemConfig=${component.renderItemConfig}
+          .blockValueChange=${component.blockValueChange}
+          .noWidthSync=${component.noWidthSync}
+          .maxOptionsVisible=${component.maxOptionsVisible}
+          .data=${component.data}
+        >
+          <slot name="prefix" slot="prefix"></slot>
+        </nile-virtual-select>
+      </div>
+    `;
+  }
+}

package/src/nile-virtual-select/index.ts

@@ -0,0 +1 @@
+export { NileVirtualSelect } from './nile-virtual-select';

package/src/nile-virtual-select/nile-virtual-select.css.ts

@@ -0,0 +1,491 @@
+/**
+ * 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 {css} from 'lit';
+
+/**
+ * Select_2 CSS
+ */
+export const styles = css`
+  :host {
+    box-sizing: border-box;
+  }
+
+  .virtualized{
+    min-width: 110px;
+    width: 100%;
+  }
+
+  .virtualized ::slotted(nile-option),
+  .virtualized nile-option {
+    width: 100%;
+    display: block;
+  }
+
+  /* Ensure proper sizing for non-virtualized options (small datasets) */
+  .virtualized:not(:has(lit-virtualizer)) {
+    display: flex;
+    flex-direction: column;
+  }
+
+  .virtualized:not(:has(lit-virtualizer)) nile-option {
+    flex-shrink: 0;
+  }
+
+  :host *,
+  :host *::before,
+  :host *::after {
+    box-sizing: inherit;
+  }
+
+  [hidden] {
+    display: none !important;
+  }
+
+  .form-control .form-control__label {
+    display: none;
+  }
+
+  .form-control .form-control__help-text {
+    display: none;
+  }
+
+  /* Label */
+  .form-control--has-label .form-control__label {
+    display: block;
+    margin-bottom: 6px;
+    color: var(--nile-colors-dark-900);
+    font-family: Colfax-regular;
+    font-size: 14px;
+    font-style: normal;
+    font-weight: 400;
+    line-height: 20px;
+    letter-spacing: 0.2px;
+  }
+
+  .form-control--has-label.form-control--medium .form-control__label {
+    font-size: 14px;
+  }
+
+  :host([required]) .form-control--has-label .form-control__label::after {
+    content: '*';
+    margin-inline-start: -2px;
+    color: var(--nile-colors-red-700);
+  }
+
+  /* Help text */
+  .form-control--has-help-text .form-control__help-text {
+    display: block;
+    color: var(--nile-colors-dark-500);
+    margin-top: 0.75rem;
+  }
+
+  .form-control--has-help-text.form-control--medium .form-control__help-text {
+    font-size: 0.875rem;
+  }
+
+  .form-control--has-help-text.form-control--radio-group
+    .form-control__help-text {
+    margin-top: 0.25rem;
+  }
+
+  :host {
+    display: block;
+  }
+
+  /** The popup */
+  .select {
+    flex: 1 1 auto;
+    display: inline-flex;
+    width: 100%;
+    position: relative;
+    vertical-align: middle;
+  }
+
+  .select::part(popup) {
+    z-index: 9999;
+  }
+
+  .select[data-current-placement^='top']::part(popup) {
+    transform-origin: bottom;
+  }
+
+  .select[data-current-placement^='bottom']::part(popup) {
+    transform-origin: top;
+  }
+
+  /* Combobox */
+  .select__combobox {
+    flex: 1;
+    display: flex;
+    width: 100%;
+    min-width: 0;
+    position: relative;
+    align-items: center;
+    justify-content: start;
+    font-family: var(--nile-font-family-sans-serif);
+    font-weight: 400;
+    letter-spacing: normal;
+    vertical-align: middle;
+    overflow: hidden;
+    cursor: pointer;
+    transition: 150ms color, 150ms border, 150ms box-shadow,
+      150ms background-color;
+  }
+
+  .select__display-input {
+    position: relative;
+    width: 100%;
+    font: inherit;
+    border: none;
+    background: none;
+    color: var(--nile-colors-dark-900);
+    cursor: inherit;
+    overflow: hidden;
+    padding: 0;
+    margin: 0;
+    -webkit-appearance: none;
+    font-family: var(--nile-font-family-serif);
+  }
+
+  .select__display-input::placeholder {
+    font-family: var(--nile-font-family-serif);
+  }
+
+  .select:not(.select--disabled):hover .select__display-input {
+    color: var(--nile-colors-dark-900);
+  }
+
+  .select__display-input:focus {
+    outline: none;
+  }
+
+  /* Visually hide the display input when multiple is enabled */
+  .select--multiple:not(.select--placeholder-visible) .select__display-input {
+    position: absolute;
+    z-index: -1;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    opacity: 0;
+  }
+
+  .select__value-input {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    padding: 0;
+    margin: 0;
+    opacity: 0;
+    z-index: -1;
+  }
+
+  .select__tags {
+    display: flex;
+    flex: 1;
+    align-items: center;
+    flex-wrap: no-wrap;
+    margin-inline-start: 0.5rem;
+    width: 100%;
+    overflow: hidden;
+  }
+
+  .select__tags-count {
+    color: var(--nile-colors-primary-600);
+    font-family: Colfax-regular;
+    font-size: 14px;
+    font-style: normal;
+    font-weight: 400;
+    line-height: 14px;
+    letter-spacing: 0.2px;
+    margin: 6px;
+  }
+
+  .select__tags-count-clearable {
+    margin-right: 50px;
+  }
+
+  .select__tags::slotted(nile-tag) {
+    cursor: pointer !important;
+  }
+
+  .select--disabled .select__tags,
+  .select--disabled .select__tags::slotted(nile-tag) {
+    cursor: not-allowed !important;
+  }
+
+  /* Standard selects */
+  .select--standard .select__combobox {
+    background-color: var(--nile-colors-white-base);
+    border: solid 1px var(--nile-colors-neutral-500);
+  }
+
+  .select--standard .select__combobox:hover {
+    border: 1px solid  var(--nile-colors-dark-900);
+    background: var(--nile-colors-white-base);
+  }
+
+  .select--standard.select--disabled .select__combobox {
+    background-color: var(--nile-colors-neutral-100);
+    border-color: var(--nile-colors-neutral-500);
+    color: var(--nile-colors-dark-500);
+    opacity: 0.5;
+    cursor: not-allowed;
+    outline: none;
+  }
+
+  .select--standard:not(.select--disabled).select--open .select__combobox,
+  .select--standard:not(.select--disabled).select--focused .select__combobox {
+    background-color: var(--nile-colors-neutral-100);
+  }
+
+  .select--warning .select__combobox {
+    border-color: var(--nile-colors-yellow-500);
+  }
+
+  .select--error .select__combobox {
+    border-color: var(--nile-colors-red-500);
+  }
+
+  .select--success {
+    border-color: var(--nile-colors-green-500);
+  }
+
+  /* Filled selects */
+  .select--filled .select__combobox {
+    border: none;
+    background-color: var(--nile-colors-neutral-100);
+    color: var(--nile-colors-dark-900);
+  }
+
+  .select--filled:hover:not(.select--disabled) .select__combobox {
+    background-color: var(--nile-colors-neutral-100);
+  }
+
+  .select--filled.select--disabled .select__combobox {
+    background-color: var(--nile-colors-neutral-100);
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+
+  .select--filled:not(.select--disabled).select--open .select__combobox,
+  .select--filled:not(.select--disabled).select--focused .select__combobox {
+    background-color: var(--nile-colors-neutral-100);
+    outline: 3px solid rgba(0, 89, 255, 0.4);
+  }
+
+  .select--medium .select__combobox {
+    border-radius: 4px;
+    font-size: 14px;
+    padding: 12px;
+    height: 40px;
+    box-sizing: border-box;
+  }
+
+  .select--medium .select__clear {
+    margin-inline-start: 0.75rem;
+  }
+
+  .select--medium .select__prefix::slotted(*) {
+    margin-inline-end: 0.75rem;
+  }
+
+  .select--medium .select__prefix.multiple::slotted(*) {
+    margin-inline-start: 0.75rem;
+  }
+
+  .select--medium.select--multiple:not(.select--placeholder-visible)
+    .select__combobox {
+    padding-inline-start: 0;
+  }
+
+  .select--medium .select__tags {
+    gap: 3px;
+  }
+
+  /* Pills */
+  .select--pill.select--medium .select__combobox {
+    border-radius: 2.5rem;
+  }
+
+  /* Prefix */
+  .select__prefix {
+    flex: 0;
+    display: inline-flex;
+    align-items: center;
+    color: var(--nile-colors-dark-500);
+  }
+
+  .select__suffix {
+    flex: 0;
+    display: inline-flex;
+    align-items: center;
+    color: var(--nile-colors-dark-500);
+  }
+
+  /* Clear button */
+  .select__clear {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    font-size: inherit;
+    color: var(--nile-colors-primary-600);
+    border: none;
+    background: none;
+    padding: 0;
+    transition: 150ms color;
+    cursor: pointer;
+  }
+
+  .select__clear:hover {
+    color: var(--nile-colors-dark-500);
+  }
+
+  .select__clear:focus {
+    outline: none;
+  }
+
+  /* Expand icon */
+  .select__expand-icon {
+    flex: 0 0 auto;
+    display: flex;
+    align-items: center;
+    transition: 250ms rotate ease;
+    rotate: 0;
+    margin-inline-start: 0.25rem;
+  }
+
+  .select--open .select__expand-icon {
+    rotate: -180deg;
+  }
+
+  /* Listbox */
+  .select__listbox {
+    display: block;
+    position: relative;
+    font-size: 1rem;
+    font-weight: 400;
+    background: var(--nile-colors-white-base);
+    border: solid 1px var(--nile-colors-neutral-500);
+    border-radius: 0.25rem;
+    padding-block: 0;
+    padding-inline: 0;
+    overflow: auto;
+    overscroll-behavior: none;
+    /* Make sure it adheres to the popup's auto size */
+    max-width: var(--auto-size-available-width);
+    max-height: var(--auto-size-available-height);
+  }
+
+  .select__options {
+    font-size: 14px;
+    color: rgb(133, 129, 129);
+    width: 100%;
+  }
+
+  .select__options__search-enabled {
+    padding-top: 10px;
+    width: 100%;
+  }
+
+  .select__listbox::slotted(nile-divider) {
+    --spacing: 0.25rem;
+  }
+
+  .select__listbox::slotted(small) {
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: var(--nile-colors-dark-500);
+    padding-block: 0.25rem;
+    padding-inline: 1rem;
+  }
+
+  .select__search {
+    position: sticky;
+    top: 0px;
+    z-index: 1;
+    width: calc(100% - 16px);
+    padding: 8px;
+    background-color: white;
+    margin-bottom: -8px;
+  }
+
+  .select__footer {
+    position: sticky;
+    bottom: 0px;
+    background: var(--nile-colors-neutral-100);
+    border: 1px solid var(--nile-colors-neutral-400);
+    display: flex;
+    height: 15px;
+    /* Auto layout */
+    display: flex;
+    flex-direction: row;
+    align-items: flex-start;
+    padding: 8px 12px 16px;
+    gap: 12px;
+    justify-content: space-between;
+  }
+
+  .tag__prefix[slot='prefix'] {
+    height: 14px;
+    display: inline-block;
+    overflow: hidden;
+  }
+
+  .tag__prefix[slot='prefix'] img {
+    max-height: 100%;
+  }
+
+  .select__loader {
+    width: 100%;
+    text-align: center;
+    display: block;
+  }
+
+  .select__loader--icon {
+    margin-top: 20px;
+    animation: spin 0.6s linear infinite;
+  }
+
+  .select__no-results {
+    padding: 10px;
+  }
+
+  @keyframes spin {
+    0% {
+      transform: rotate(0deg);
+    }
+    100% {
+      transform: rotate(360deg);
+    }
+  }
+
+  .select__invisible{
+    opacity: 0;
+  }
+
+  .select__prefix--from-options {
+    margin-inline-end: 12px;
+  }
+  
+  .select__hide-default{
+    display: none;
+  }
+
+  .virtualized nile-option[selected] {
+    background-color: var(--nile-colors-neutral-100);
+  }
+
+  .virtualized nile-option[selected]::part(base) {
+    color: var(--nile-colors-primary-600);
+  }
+`;
+
+export default [styles];