@origostudio/origo-design 0.0.49 → 0.0.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origostudio/origo-design",
-  "version": "0.0.49",
+  "version": "0.0.50",
   "license": "MIT",
   "repository": {
     "type": "git",

package/packages/angular-renderer/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.0.50 (2026-10-08)
+
+### 🚀 Features
+
+- add core selection control primitives including select, multi-select, combobox, and autocomplete components ([3866703](https://github.com/OrigoStudio/origo-design/commit/3866703))
+
+### ❤️ Thank You
+
+- Hardik Patel @hardikpatelse
+
 ## 0.0.49 (2026-10-08)
 
 ### 🚀 Features

package/packages/angular-renderer/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@origostudio/angular-renderer",
-  "version": "0.0.49",
+  "version": "0.0.50",
   "private": false,
   "type": "commonjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@origostudio/core": "0.0.49",
-    "@origostudio/design-tokens": "0.0.49",
+    "@origostudio/core": "0.0.50",
+    "@origostudio/design-tokens": "0.0.50",
     "tslib": "^2.3.0",
     "@analogjs/vite-plugin-angular": "^2.7.1",
     "zone.js": "^0.16.3",

package/packages/angular-renderer/src/components/primitives/autocomplete/autocomplete.component.html

@@ -0,0 +1,83 @@
+<div class="origo-autocomplete__wrapper">
+  <div class="origo-autocomplete__control">
+    <input
+      type="text"
+      class="origo-autocomplete__input"
+      [id]="contract().id + '-input'"
+      role="combobox"
+      aria-autocomplete="list"
+      [attr.aria-expanded]="isOpen()"
+      [attr.aria-controls]="isOpen() ? contract().id + '-listbox' : null"
+      [attr.aria-activedescendant]="
+        isOpen() && activeIndex() >= 0 ? contract().id + '-option-' + activeIndex() : null
+      "
+      [attr.aria-invalid]="computedInvalid() ? 'true' : null"
+      [attr.aria-required]="computedRequired() ? 'true' : null"
+      [attr.aria-label]="computedAriaLabel()"
+      [attr.aria-describedby]="computedAriaDescribedBy()"
+      [placeholder]="computedPlaceholder()"
+      [disabled]="computedDisabled()"
+      [readonly]="computedReadonly()"
+      [value]="inputValue()"
+      (input)="onInput($event)"
+      (paste)="onPaste($event)"
+      (focus)="onFocus()"
+      (blur)="onBlur()"
+      (keydown)="onKeydown($event)"
+    />
+
+    <span class="origo-autocomplete__icons">
+      @if (computedClearable() && inputValue() && !computedDisabled() && !computedReadonly()) {
+        <span
+          class="origo-autocomplete__clear"
+          role="button"
+          tabindex="0"
+          aria-label="Clear value"
+          (click)="clear($event)"
+          (keydown.enter)="clear($event)"
+          >✕</span
+        >
+      }
+    </span>
+  </div>
+
+  @if (isOpen()) {
+    <div
+      class="origo-autocomplete__dropdown"
+      [id]="contract().id + '-listbox'"
+      role="listbox"
+      [attr.aria-label]="computedAriaLabel()"
+    >
+      <ul class="origo-autocomplete__options">
+        @for (opt of filteredSuggestions(); track opt.value; let idx = $index) {
+          <li
+            class="origo-autocomplete__option"
+            [class.origo-autocomplete__option--selected]="opt.value === value()"
+            [class.origo-autocomplete__option--active]="activeIndex() === idx"
+            [class.origo-autocomplete__option--disabled]="opt.disabled"
+            [id]="contract().id + '-option-' + idx"
+            role="option"
+            [attr.aria-selected]="opt.value === value()"
+            [attr.aria-disabled]="opt.disabled ? 'true' : null"
+            (click)="!opt.disabled && selectSuggestion(opt)"
+          >
+            {{ opt.label }}
+          </li>
+        } @empty {
+          <li class="origo-autocomplete__no-options" role="presentation">No suggestions found</li>
+        }
+      </ul>
+    </div>
+  }
+</div>
+
+@if (computedErrorText()) {
+  <div class="origo-autocomplete__error" [id]="contract().id + '-error'">
+    {{ computedErrorText() }}
+  </div>
+}
+@if (computedHelpText()) {
+  <div class="origo-autocomplete__help" [id]="contract().id + '-help'">
+    {{ computedHelpText() }}
+  </div>
+}

package/packages/angular-renderer/src/components/primitives/autocomplete/autocomplete.component.scss

@@ -0,0 +1,161 @@
+:host {
+  display: inline-block;
+  position: relative;
+  box-sizing: border-box;
+  font-family: var(--origo-typography-input-font-family);
+  font-size: var(--origo-typography-input-font-size);
+  font-weight: var(--origo-typography-input-font-weight);
+  line-height: var(--origo-typography-input-line-height);
+}
+
+:host(.origo-autocomplete--fluid) {
+  display: block;
+  width: 100%;
+}
+
+.origo-autocomplete__wrapper {
+  display: flex;
+  flex-direction: column;
+  position: relative;
+  width: 100%;
+}
+
+.origo-autocomplete__control {
+  position: relative;
+  display: flex;
+  align-items: center;
+  width: 100%;
+}
+
+.origo-autocomplete__input {
+  box-sizing: border-box;
+  width: 100%;
+  background-color: var(--origo-color-surface-background);
+  color: var(--origo-color-text-primary);
+  padding: var(--origo-spacing-container-padding);
+  border: var(--origo-border-width-default) solid var(--origo-color-border-default);
+  border-radius: var(--origo-radius-sm);
+  box-shadow: var(--origo-shadow-sm);
+  font-family: inherit;
+  font-size: inherit;
+  transition: all var(--origo-duration-fast) ease-in-out;
+
+  &:hover:not(:disabled):not([readonly]) {
+    border-color: var(--origo-color-border-hover);
+  }
+
+  &:active:not(:disabled):not([readonly]) {
+    border-color: var(--origo-color-border-active);
+  }
+
+  &:focus,
+  &:focus-visible {
+    outline: var(--origo-border-width-thick) solid var(--origo-color-focus);
+    outline-offset: var(--origo-border-offset-negative);
+    border-color: var(--origo-color-focus);
+  }
+
+  &:disabled {
+    cursor: not-allowed;
+    opacity: var(--origo-opacity-disabled);
+    background-color: var(--origo-color-surface-disabled);
+    color: var(--origo-color-text-disabled);
+  }
+
+  &[readonly] {
+    background-color: var(--origo-color-surface-readonly);
+  }
+
+  &::placeholder {
+    color: var(--origo-color-text-muted);
+  }
+}
+
+:host(.origo-autocomplete--filled) .origo-autocomplete__input {
+  background-color: var(--origo-color-surface-subtle);
+  border: none;
+}
+
+:host(.origo-autocomplete--invalid) .origo-autocomplete__input {
+  border-color: var(--origo-color-text-danger);
+}
+
+.origo-autocomplete__icons {
+  position: absolute;
+  right: var(--origo-spacing-sm);
+  display: inline-flex;
+  align-items: center;
+  gap: var(--origo-spacing-xs);
+}
+
+.origo-autocomplete__clear {
+  cursor: pointer;
+  color: var(--origo-color-text-muted);
+  font-size: var(--origo-typography-caption-font-size);
+
+  &:hover {
+    color: var(--origo-color-text-primary);
+  }
+}
+
+.origo-autocomplete__dropdown {
+  position: absolute;
+  top: 100%;
+  left: 0;
+  right: 0;
+  z-index: 1000;
+  margin-top: var(--origo-spacing-xs);
+  box-sizing: border-box;
+  background-color: var(--origo-color-surface-background);
+  border: var(--origo-border-width-default) solid var(--origo-color-border-default);
+  border-radius: var(--origo-radius-sm);
+  box-shadow: var(--origo-shadow-md);
+  max-height: 16rem;
+  overflow-y: auto;
+}
+
+.origo-autocomplete__options {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.origo-autocomplete__option {
+  padding: var(--origo-spacing-container-padding);
+  color: var(--origo-color-text-primary);
+  cursor: pointer;
+  transition: background-color var(--origo-duration-fast) ease-in-out;
+
+  &:hover,
+  &--active {
+    background-color: var(--origo-color-surface-subtle);
+  }
+
+  &--selected {
+    background-color: var(--origo-color-surface-subtle);
+    font-weight: bold;
+  }
+
+  &--disabled {
+    opacity: var(--origo-opacity-disabled);
+    cursor: not-allowed;
+  }
+}
+
+.origo-autocomplete__no-options {
+  padding: var(--origo-spacing-container-padding);
+  color: var(--origo-color-text-muted);
+  text-align: center;
+}
+
+.origo-autocomplete__error {
+  color: var(--origo-color-text-danger);
+  font-size: var(--origo-typography-caption-font-size);
+  margin-top: var(--origo-spacing-xs);
+}
+
+.origo-autocomplete__help {
+  color: var(--origo-color-text-muted);
+  font-size: var(--origo-typography-caption-font-size);
+  margin-top: var(--origo-spacing-xs);
+}

package/packages/angular-renderer/src/components/primitives/autocomplete/autocomplete.component.ts

@@ -0,0 +1,338 @@
+import {
+  Component,
+  input,
+  model,
+  ChangeDetectionStrategy,
+  computed,
+  ViewEncapsulation,
+  inject,
+  effect,
+  untracked,
+  signal,
+  PLATFORM_ID,
+  HostListener,
+  ElementRef,
+} from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+import { InteractionContract } from '@origostudio/core';
+import { OrigoAdapter } from '../../../adapters/web/adapter';
+import { WebExperienceAdapterService } from '../../../adapters/web/experience-adapter.service';
+import { NormalizedOption, normalizeOptions, filterOptions } from '../select/selection-utils';
+
+export interface AutocompleteProps {
+  id?: string;
+  value?: unknown;
+  suggestions?: Array<unknown>;
+  minQueryLength?: number;
+  delay?: number;
+  multiple?: boolean;
+  forceSelection?: boolean;
+  optionLabel?: string;
+  optionValue?: string;
+  completeOnFocus?: boolean;
+  virtualScroll?: boolean;
+  loading?: boolean;
+  placeholder?: string;
+  clearable?: boolean;
+  disabled?: boolean;
+  readonly?: boolean;
+  required?: boolean;
+  invalid?: boolean;
+  errorText?: string;
+  helpText?: string;
+  variant?: 'outlined' | 'filled';
+  fluid?: boolean;
+  'aria-label'?: string;
+  'aria-describedby'?: string;
+  permissions?: Record<string, string>;
+  rules?: Record<string, unknown>;
+  metadata?: Record<string, unknown>;
+}
+
+@Component({
+  selector: 'origo-autocomplete',
+  standalone: true,
+  templateUrl: './autocomplete.component.html',
+  styleUrls: ['./autocomplete.component.scss'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  encapsulation: ViewEncapsulation.ShadowDom,
+  host: {
+    '[class.origo-autocomplete]': 'true',
+    '[attr.data-testid]': 'contract().id ?? ""',
+    '[class.origo-autocomplete--fluid]': 'computedFluid()',
+    '[class.origo-autocomplete--outlined]': 'computedVariant() === "outlined"',
+    '[class.origo-autocomplete--filled]': 'computedVariant() === "filled"',
+    '[class.origo-autocomplete--invalid]': 'computedInvalid()',
+    '[class.origo-autocomplete--disabled]': 'computedDisabled()',
+    '[class.origo-autocomplete--readonly]': 'computedReadonly()',
+  },
+})
+export class AutocompleteComponent implements OrigoAdapter<AutocompleteProps> {
+  static readonly contractSchema = {
+    permissions: 'object',
+    rules: 'object',
+    metadata: 'object',
+    suggestions: 'array',
+    value: 'string',
+    minQueryLength: 'number',
+    delay: 'number',
+    multiple: 'boolean',
+    forceSelection: 'boolean',
+    optionLabel: 'string',
+    optionValue: 'string',
+    completeOnFocus: 'boolean',
+    virtualScroll: 'boolean',
+    loading: 'boolean',
+    placeholder: 'string',
+    clearable: 'boolean',
+    disabled: 'boolean',
+    readonly: 'boolean',
+    required: 'boolean',
+    invalid: 'boolean',
+    errorText: 'string',
+    helpText: 'string',
+    variant: 'string',
+    fluid: 'boolean',
+    'aria-label': 'string',
+    'aria-describedby': 'string',
+  };
+  static readonly strictContract = false;
+
+  contract = input.required<InteractionContract<AutocompleteProps>>();
+  value = model<unknown>('');
+
+  inputValue = signal<string>('');
+  query = signal<string>('');
+  isOpen = signal<boolean>(false);
+  activeIndex = signal<number>(-1);
+
+  private debounceTimer: ReturnType<typeof setTimeout> | null = null;
+
+  computedNormalizedSuggestions = computed(() => {
+    const props = this.contract().props;
+    return normalizeOptions(props?.suggestions, props?.optionLabel, props?.optionValue);
+  });
+
+  filteredSuggestions = computed(() => {
+    const suggestions = this.computedNormalizedSuggestions();
+    const q = this.query();
+    if (!q) return suggestions;
+    return filterOptions(suggestions, q, 'contains');
+  });
+
+  computedPlaceholder = computed(() => this.contract().props?.placeholder ?? '');
+  computedMinQueryLength = computed(() => this.contract().props?.minQueryLength ?? 1);
+  computedDelay = computed(() => this.contract().props?.delay ?? 300);
+  computedForceSelection = computed(() => !!this.contract().props?.forceSelection);
+  computedClearable = computed(() => !!this.contract().props?.clearable);
+  computedDisabled = computed(() => !!this.contract().props?.disabled);
+  computedReadonly = computed(() => !!this.contract().props?.readonly);
+  computedRequired = computed(() => !!this.contract().props?.required);
+  computedInvalid = computed(() => !!this.contract().props?.invalid);
+  computedVariant = computed(() => this.contract().props?.variant ?? 'outlined');
+  computedFluid = computed(() => !!this.contract().props?.fluid);
+  computedErrorText = computed(() => this.contract().props?.errorText ?? '');
+  computedHelpText = computed(() => this.contract().props?.helpText ?? '');
+
+  computedAriaLabel = computed(() => {
+    const label = this.contract().props?.['aria-label'];
+    if (label !== undefined && label !== null && String(label).trim() !== '') {
+      return String(label);
+    }
+    return this.computedPlaceholder() || 'Autocomplete';
+  });
+
+  computedAriaDescribedBy = computed(() => {
+    const parts: string[] = [];
+    const desc = this.contract().props?.['aria-describedby'];
+    if (desc) parts.push(String(desc));
+    if (this.computedErrorText()) parts.push(`${this.contract().id}-error`);
+    if (this.computedHelpText()) parts.push(`${this.contract().id}-help`);
+    return parts.length > 0 ? parts.join(' ') : undefined;
+  });
+
+  private experienceAdapter = inject(WebExperienceAdapterService);
+  private platformId = inject(PLATFORM_ID);
+  private elementRef = inject(ElementRef);
+
+  constructor() {
+    effect(() => {
+      const contractVal = this.contract().props?.value;
+      untracked(() => {
+        if (contractVal !== undefined && contractVal !== this.value()) {
+          this.value.set(contractVal);
+          // Sync input display
+          const match = this.computedNormalizedSuggestions().find(s => s.value === contractVal);
+          this.inputValue.set(match ? match.label : String(contractVal ?? ''));
+        }
+      });
+    });
+  }
+
+  onInput(event: Event) {
+    if (this.computedDisabled() || this.computedReadonly()) return;
+    const target = event.target as HTMLInputElement;
+    const text = target.value;
+    this.inputValue.set(text);
+
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+    }
+
+    this.debounceTimer = setTimeout(() => {
+      this.query.set(text);
+      if (text.length >= this.computedMinQueryLength()) {
+        this.isOpen.set(true);
+        this.activeIndex.set(0);
+      } else {
+        this.isOpen.set(false);
+      }
+    }, this.computedDelay());
+  }
+
+  onPaste(event: ClipboardEvent) {
+    if (this.computedDisabled() || this.computedReadonly()) return;
+    event.preventDefault();
+    const plain = event.clipboardData?.getData('text/plain') ?? '';
+    const target = event.target as HTMLInputElement;
+    if (!target) return;
+    const start = target.selectionStart ?? target.value.length;
+    const end = target.selectionEnd ?? target.value.length;
+    const newValue = target.value.slice(0, start) + plain + target.value.slice(end);
+    target.value = newValue;
+    this.inputValue.set(newValue);
+    this.query.set(newValue);
+    if (newValue.length >= this.computedMinQueryLength()) {
+      this.isOpen.set(true);
+      this.activeIndex.set(0);
+    }
+  }
+
+  onFocus() {
+    if (
+      this.contract().props?.completeOnFocus &&
+      !this.computedDisabled() &&
+      !this.computedReadonly()
+    ) {
+      this.isOpen.set(true);
+      this.activeIndex.set(0);
+    }
+  }
+
+  onBlur() {
+    if (this.computedForceSelection()) {
+      const currentText = this.inputValue().trim().toLowerCase();
+      const match = this.computedNormalizedSuggestions().find(
+        s => s.label.toLowerCase() === currentText
+      );
+      if (match) {
+        this.selectSuggestion(match);
+      } else {
+        // Revert to existing value or clear
+        const existing = this.computedNormalizedSuggestions().find(s => s.value === this.value());
+        if (existing) {
+          this.inputValue.set(existing.label);
+        } else {
+          this.value.set('');
+          this.inputValue.set('');
+        }
+      }
+    }
+  }
+
+  selectSuggestion(suggestion: NormalizedOption) {
+    if (this.computedDisabled() || this.computedReadonly() || suggestion.disabled) return;
+    this.value.set(suggestion.value);
+    this.inputValue.set(suggestion.label);
+    this.isOpen.set(false);
+    this.experienceAdapter.updateState(this.contract().id, 'value', suggestion.value);
+  }
+
+  clear(event?: Event) {
+    if (this.computedDisabled() || this.computedReadonly()) return;
+    event?.stopPropagation();
+    this.value.set('');
+    this.inputValue.set('');
+    this.query.set('');
+    this.isOpen.set(false);
+    this.experienceAdapter.updateState(this.contract().id, 'value', '');
+  }
+
+  onKeydown(event: KeyboardEvent) {
+    if (this.computedDisabled() || this.computedReadonly()) return;
+
+    const list = this.filteredSuggestions();
+    const count = list.length;
+
+    switch (event.key) {
+      case 'ArrowDown': {
+        event.preventDefault();
+        if (!this.isOpen() && count > 0) {
+          this.isOpen.set(true);
+          this.activeIndex.set(0);
+        } else if (count > 0) {
+          const next = (this.activeIndex() + 1) % count;
+          this.activeIndex.set(next);
+        }
+        break;
+      }
+      case 'ArrowUp': {
+        event.preventDefault();
+        if (!this.isOpen() && count > 0) {
+          this.isOpen.set(true);
+          this.activeIndex.set(count - 1);
+        } else if (count > 0) {
+          const prev = (this.activeIndex() - 1 + count) % count;
+          this.activeIndex.set(prev);
+        }
+        break;
+      }
+      case 'Enter': {
+        if (this.isOpen()) {
+          event.preventDefault();
+          const idx = this.activeIndex();
+          if (idx >= 0 && idx < count && !list[idx].disabled) {
+            this.selectSuggestion(list[idx]);
+          }
+        }
+        break;
+      }
+      case 'Escape': {
+        if (this.isOpen()) {
+          event.preventDefault();
+          this.isOpen.set(false);
+        }
+        break;
+      }
+      case 'Tab': {
+        if (this.isOpen()) {
+          this.isOpen.set(false);
+        }
+        break;
+      }
+      case 'Home': {
+        if (this.isOpen() && count > 0) {
+          event.preventDefault();
+          this.activeIndex.set(0);
+        }
+        break;
+      }
+      case 'End': {
+        if (this.isOpen() && count > 0) {
+          event.preventDefault();
+          this.activeIndex.set(count - 1);
+        }
+        break;
+      }
+    }
+  }
+
+  @HostListener('document:click', ['$event'])
+  onDocumentClick(event: MouseEvent) {
+    if (!isPlatformBrowser(this.platformId)) return;
+    const clickedInside = this.elementRef.nativeElement.contains(event.target as Node);
+    if (!clickedInside && this.isOpen()) {
+      this.isOpen.set(false);
+    }
+  }
+}