@tailng-ui/primitives 0.1.0

package/src/lib/form/toggle-group/tng-toggle-group.js

@@ -0,0 +1,156 @@
+import { __decorate } from "tslib";
+import { Directive, HostBinding, booleanAttribute, input, output, signal, } from '@angular/core';
+function coerceSelectionMode(value) {
+    return value === 'single' ? 'single' : 'multiple';
+}
+function normalizeStringValue(value) {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return [];
+    }
+    const normalized = [];
+    for (const item of value) {
+        const normalizedItem = normalizeStringValue(item);
+        if (normalizedItem === null || normalized.includes(normalizedItem)) {
+            continue;
+        }
+        normalized.push(normalizedItem);
+    }
+    return normalized;
+}
+let TngToggleGroup = class TngToggleGroup {
+    internalSingleValue = signal(null);
+    internalMultipleValues = signal([]);
+    ariaLabel = input(null);
+    ariaLabelledby = input(null);
+    orientation = input('horizontal');
+    selectionMode = input('multiple', {
+        transform: coerceSelectionMode,
+    });
+    disabled = input(false, {
+        transform: booleanAttribute,
+    });
+    value = input(undefined);
+    values = input(undefined);
+    defaultValue = input(null);
+    defaultValues = input([]);
+    valueChange = output();
+    valuesChange = output();
+    ngOnInit() {
+        this.internalSingleValue.set(normalizeStringValue(this.defaultValue()));
+        this.internalMultipleValues.set(normalizeStringArray(this.defaultValues()));
+    }
+    isGroupDisabled() {
+        return this.disabled();
+    }
+    isItemSelected(itemValue) {
+        if (this.selectionMode() === 'single') {
+            return this.resolveSingleValue() === itemValue;
+        }
+        return this.resolveMultipleValues().includes(itemValue);
+    }
+    toggleItem(itemValue) {
+        if (this.disabled()) {
+            return this.isItemSelected(itemValue);
+        }
+        if (this.selectionMode() === 'single') {
+            const currentValue = this.resolveSingleValue();
+            const nextValue = currentValue === itemValue ? null : itemValue;
+            if (!this.isSingleControlled()) {
+                this.internalSingleValue.set(nextValue);
+            }
+            if (nextValue !== currentValue) {
+                this.valueChange.emit(nextValue);
+            }
+            return nextValue === itemValue;
+        }
+        const currentValues = this.resolveMultipleValues();
+        const isSelected = currentValues.includes(itemValue);
+        const nextValues = isSelected
+            ? currentValues.filter((value) => value !== itemValue)
+            : [...currentValues, itemValue];
+        if (!this.isMultipleControlled()) {
+            this.internalMultipleValues.set(nextValues);
+        }
+        if (nextValues.length !== currentValues.length || !isSelected) {
+            this.valuesChange.emit(nextValues);
+        }
+        return !isSelected;
+    }
+    isSingleControlled() {
+        return this.value() !== undefined;
+    }
+    isMultipleControlled() {
+        return this.values() !== undefined;
+    }
+    resolveSingleValue() {
+        if (this.isSingleControlled()) {
+            return normalizeStringValue(this.value() ?? null);
+        }
+        return this.internalSingleValue();
+    }
+    resolveMultipleValues() {
+        if (this.isMultipleControlled()) {
+            return normalizeStringArray(this.values());
+        }
+        return this.internalMultipleValues();
+    }
+    get ariaLabelAttr() {
+        return normalizeStringValue(this.ariaLabel());
+    }
+    get ariaLabelledbyAttr() {
+        return normalizeStringValue(this.ariaLabelledby());
+    }
+    get ariaDisabledAttr() {
+        return this.disabled() ? 'true' : null;
+    }
+    get dataDisabledAttr() {
+        return this.disabled() ? '' : null;
+    }
+    get dataOrientationAttr() {
+        return this.orientation();
+    }
+    get dataSelectionModeAttr() {
+        return this.selectionMode();
+    }
+    dataSlot = 'toggle-group';
+    roleAttr = 'group';
+};
+__decorate([
+    HostBinding('attr.aria-label')
+], TngToggleGroup.prototype, "ariaLabelAttr", null);
+__decorate([
+    HostBinding('attr.aria-labelledby')
+], TngToggleGroup.prototype, "ariaLabelledbyAttr", null);
+__decorate([
+    HostBinding('attr.aria-disabled')
+], TngToggleGroup.prototype, "ariaDisabledAttr", null);
+__decorate([
+    HostBinding('attr.data-disabled')
+], TngToggleGroup.prototype, "dataDisabledAttr", null);
+__decorate([
+    HostBinding('attr.data-orientation')
+], TngToggleGroup.prototype, "dataOrientationAttr", null);
+__decorate([
+    HostBinding('attr.data-selection-mode')
+], TngToggleGroup.prototype, "dataSelectionModeAttr", null);
+__decorate([
+    HostBinding('attr.data-slot')
+], TngToggleGroup.prototype, "dataSlot", void 0);
+__decorate([
+    HostBinding('attr.role')
+], TngToggleGroup.prototype, "roleAttr", void 0);
+TngToggleGroup = __decorate([
+    Directive({
+        selector: '[tngToggleGroup]',
+        exportAs: 'tngToggleGroup',
+    })
+], TngToggleGroup);
+export { TngToggleGroup };
+//# sourceMappingURL=tng-toggle-group.js.map

package/src/lib/form/toggle-group/tng-toggle-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tng-toggle-group.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/form/toggle-group/tng-toggle-group.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Directive,\n  HostBinding,\n  OnInit,\n  booleanAttribute,\n  input,\n  output,\n  signal,\n} from '@angular/core';\n\ntype TngToggleGroupSelectionMode = 'multiple' | 'single';\n\nfunction coerceSelectionMode(value: unknown): TngToggleGroupSelectionMode {\n  return value === 'single' ? 'single' : 'multiple';\n}\n\nfunction normalizeStringValue(value: string | null | undefined): string | null {\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeStringArray(value: readonly string[] | null | undefined): readonly string[] {\n  if (!Array.isArray(value) || value.length === 0) {\n    return [];\n  }\n\n  const normalized: string[] = [];\n  for (const item of value) {\n    const normalizedItem = normalizeStringValue(item);\n    if (normalizedItem === null || normalized.includes(normalizedItem)) {\n      continue;\n    }\n\n    normalized.push(normalizedItem);\n  }\n\n  return normalized;\n}\n\n@Directive({\n  selector: '[tngToggleGroup]',\n  exportAs: 'tngToggleGroup',\n})\nexport class TngToggleGroup implements OnInit {\n  private readonly internalSingleValue = signal<string | null>(null);\n  private readonly internalMultipleValues = signal<readonly string[]>([]);\n\n  public readonly ariaLabel = input<string | null>(null);\n  public readonly ariaLabelledby = input<string | null>(null);\n  public readonly orientation = input<'horizontal' | 'vertical'>('horizontal');\n  public readonly selectionMode = input<TngToggleGroupSelectionMode, unknown>('multiple', {\n    transform: coerceSelectionMode,\n  });\n  public readonly disabled = input<boolean, boolean | string>(false, {\n    transform: booleanAttribute,\n  });\n  public readonly value = input<string | null | undefined>(undefined);\n  public readonly values = input<readonly string[] | undefined>(undefined);\n  public readonly defaultValue = input<string | null>(null);\n  public readonly defaultValues = input<readonly string[]>([]);\n\n  public readonly valueChange = output<string | null>();\n  public readonly valuesChange = output<readonly string[]>();\n\n  public ngOnInit(): void {\n    this.internalSingleValue.set(normalizeStringValue(this.defaultValue()));\n    this.internalMultipleValues.set(normalizeStringArray(this.defaultValues()));\n  }\n\n  public isGroupDisabled(): boolean {\n    return this.disabled();\n  }\n\n  public isItemSelected(itemValue: string): boolean {\n    if (this.selectionMode() === 'single') {\n      return this.resolveSingleValue() === itemValue;\n    }\n\n    return this.resolveMultipleValues().includes(itemValue);\n  }\n\n  public toggleItem(itemValue: string): boolean {\n    if (this.disabled()) {\n      return this.isItemSelected(itemValue);\n    }\n\n    if (this.selectionMode() === 'single') {\n      const currentValue = this.resolveSingleValue();\n      const nextValue = currentValue === itemValue ? null : itemValue;\n\n      if (!this.isSingleControlled()) {\n        this.internalSingleValue.set(nextValue);\n      }\n\n      if (nextValue !== currentValue) {\n        this.valueChange.emit(nextValue);\n      }\n\n      return nextValue === itemValue;\n    }\n\n    const currentValues = this.resolveMultipleValues();\n    const isSelected = currentValues.includes(itemValue);\n    const nextValues = isSelected\n      ? currentValues.filter((value) => value !== itemValue)\n      : [...currentValues, itemValue];\n\n    if (!this.isMultipleControlled()) {\n      this.internalMultipleValues.set(nextValues);\n    }\n\n    if (nextValues.length !== currentValues.length || !isSelected) {\n      this.valuesChange.emit(nextValues);\n    }\n\n    return !isSelected;\n  }\n\n  private isSingleControlled(): boolean {\n    return this.value() !== undefined;\n  }\n\n  private isMultipleControlled(): boolean {\n    return this.values() !== undefined;\n  }\n\n  private resolveSingleValue(): string | null {\n    if (this.isSingleControlled()) {\n      return normalizeStringValue(this.value() ?? null);\n    }\n\n    return this.internalSingleValue();\n  }\n\n  private resolveMultipleValues(): readonly string[] {\n    if (this.isMultipleControlled()) {\n      return normalizeStringArray(this.values());\n    }\n\n    return this.internalMultipleValues();\n  }\n\n  @HostBinding('attr.aria-label')\n  protected get ariaLabelAttr(): string | null {\n    return normalizeStringValue(this.ariaLabel());\n  }\n\n  @HostBinding('attr.aria-labelledby')\n  protected get ariaLabelledbyAttr(): string | null {\n    return normalizeStringValue(this.ariaLabelledby());\n  }\n\n  @HostBinding('attr.aria-disabled')\n  protected get ariaDisabledAttr(): 'true' | null {\n    return this.disabled() ? 'true' : null;\n  }\n\n  @HostBinding('attr.data-disabled')\n  protected get dataDisabledAttr(): '' | null {\n    return this.disabled() ? '' : null;\n  }\n\n  @HostBinding('attr.data-orientation')\n  protected get dataOrientationAttr(): 'horizontal' | 'vertical' {\n    return this.orientation();\n  }\n\n  @HostBinding('attr.data-selection-mode')\n  protected get dataSelectionModeAttr(): TngToggleGroupSelectionMode {\n    return this.selectionMode();\n  }\n\n  @HostBinding('attr.data-slot')\n  protected readonly dataSlot = 'toggle-group' as const;\n\n  @HostBinding('attr.role')\n  protected readonly roleAttr = 'group' as const;\n}\n"]}

package/src/lib/internal/combobox/combobox.active.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Active descendant sync helpers.
+ * Keeps ensureActive + setActiveDescendantId(getActiveId()) consistent
+ * across Select, AutoComplete, etc.
+ */
+import type { ComboboxListboxApi } from './combobox.listbox-api';
+/** Callback to set aria-activedescendant on the trigger. */
+export type SetActiveDescendantId = (id: string | null) => void;
+/**
+ * Sync aria-activedescendant from listbox active id to the trigger.
+ */
+export declare function syncActiveDescendant(listbox: ComboboxListboxApi | null, setActiveDescendantId: SetActiveDescendantId): void;
+/**
+ * Ensure an option is active (first or last), then sync activeDescendant.
+ */
+export declare function ensureActiveAndSync(listbox: ComboboxListboxApi | null, setActiveDescendantId: SetActiveDescendantId, pref?: 'first' | 'last'): void;
+//# sourceMappingURL=combobox.active.d.ts.map

package/src/lib/internal/combobox/combobox.active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.active.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.active.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAEhE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAAG,IAAI,EAClC,qBAAqB,EAAE,qBAAqB,GAC3C,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,GAAG,IAAI,EAClC,qBAAqB,EAAE,qBAAqB,EAC5C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GACtB,IAAI,CAGN"}

package/src/lib/internal/combobox/combobox.active.js

@@ -0,0 +1,19 @@
+/**
+ * Active descendant sync helpers.
+ * Keeps ensureActive + setActiveDescendantId(getActiveId()) consistent
+ * across Select, AutoComplete, etc.
+ */
+/**
+ * Sync aria-activedescendant from listbox active id to the trigger.
+ */
+export function syncActiveDescendant(listbox, setActiveDescendantId) {
+    setActiveDescendantId(listbox?.getActiveId() ?? null);
+}
+/**
+ * Ensure an option is active (first or last), then sync activeDescendant.
+ */
+export function ensureActiveAndSync(listbox, setActiveDescendantId, pref) {
+    listbox?.ensureActive(pref);
+    syncActiveDescendant(listbox, setActiveDescendantId);
+}
+//# sourceMappingURL=combobox.active.js.map

package/src/lib/internal/combobox/combobox.active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.active.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.active.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAkC,EAClC,qBAA4C;IAE5C,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAkC,EAClC,qBAA4C,EAC5C,IAAuB;IAEvB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACvD,CAAC","sourcesContent":["/**\n * Active descendant sync helpers.\n * Keeps ensureActive + setActiveDescendantId(getActiveId()) consistent\n * across Select, AutoComplete, etc.\n */\n\nimport type { ComboboxListboxApi } from './combobox.listbox-api';\n\n/** Callback to set aria-activedescendant on the trigger. */\nexport type SetActiveDescendantId = (id: string | null) => void;\n\n/**\n * Sync aria-activedescendant from listbox active id to the trigger.\n */\nexport function syncActiveDescendant(\n  listbox: ComboboxListboxApi | null,\n  setActiveDescendantId: SetActiveDescendantId\n): void {\n  setActiveDescendantId(listbox?.getActiveId() ?? null);\n}\n\n/**\n * Ensure an option is active (first or last), then sync activeDescendant.\n */\nexport function ensureActiveAndSync(\n  listbox: ComboboxListboxApi | null,\n  setActiveDescendantId: SetActiveDescendantId,\n  pref?: 'first' | 'last'\n): void {\n  listbox?.ensureActive(pref);\n  syncActiveDescendant(listbox, setActiveDescendantId);\n}\n"]}

package/src/lib/internal/combobox/combobox.commit.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Normalize + commit helpers for combobox listbox value sync.
+ * Listbox emits T | readonly T[] | null; these helpers normalize and compare
+ * for Select, AutoComplete, etc.
+ */
+/** Listbox value shape (single, array, or null). */
+export type ListboxValueShape<T> = T | readonly T[] | null;
+/**
+ * Normalize listbox value to array form (for multi-select).
+ */
+export declare function normalizeToArray<T>(value: ListboxValueShape<T>): readonly T[] | null;
+/**
+ * Normalize listbox value to single form (for single-select).
+ */
+export declare function normalizeToSingle<T>(value: ListboxValueShape<T>): T | null;
+/**
+ * Check if two array values are equal (same refs, same order).
+ */
+export declare function arraysEqual<T>(a: readonly T[] | null, b: readonly T[] | null): boolean;
+//# sourceMappingURL=combobox.commit.d.ts.map

package/src/lib/internal/combobox/combobox.commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.commit.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.commit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;AAE3D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAGpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAG1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,EACtB,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GACrB,OAAO,CAKT"}

package/src/lib/internal/combobox/combobox.commit.js

@@ -0,0 +1,34 @@
+/**
+ * Normalize + commit helpers for combobox listbox value sync.
+ * Listbox emits T | readonly T[] | null; these helpers normalize and compare
+ * for Select, AutoComplete, etc.
+ */
+/**
+ * Normalize listbox value to array form (for multi-select).
+ */
+export function normalizeToArray(value) {
+    if (value === null)
+        return null;
+    return (Array.isArray(value) ? value : [value]);
+}
+/**
+ * Normalize listbox value to single form (for single-select).
+ */
+export function normalizeToSingle(value) {
+    if (value === null)
+        return null;
+    return (Array.isArray(value) ? (value[0] ?? null) : value);
+}
+/**
+ * Check if two array values are equal (same refs, same order).
+ */
+export function arraysEqual(a, b) {
+    if (a === null && b === null)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (a.length !== b.length)
+        return false;
+    return a.every((x, i) => Object.is(x, b[i]));
+}
+//# sourceMappingURL=combobox.commit.js.map

package/src/lib/internal/combobox/combobox.commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.commit.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.commit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAI,KAA2B;IAC7D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAiB,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAA2B;IAC9D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAa,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,CAAsB,EACtB,CAAsB;IAEtB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["/**\n * Normalize + commit helpers for combobox listbox value sync.\n * Listbox emits T | readonly T[] | null; these helpers normalize and compare\n * for Select, AutoComplete, etc.\n */\n\n/** Listbox value shape (single, array, or null). */\nexport type ListboxValueShape<T> = T | readonly T[] | null;\n\n/**\n * Normalize listbox value to array form (for multi-select).\n */\nexport function normalizeToArray<T>(value: ListboxValueShape<T>): readonly T[] | null {\n  if (value === null) return null;\n  return (Array.isArray(value) ? value : [value]) as readonly T[];\n}\n\n/**\n * Normalize listbox value to single form (for single-select).\n */\nexport function normalizeToSingle<T>(value: ListboxValueShape<T>): T | null {\n  if (value === null) return null;\n  return (Array.isArray(value) ? (value[0] ?? null) : value) as T | null;\n}\n\n/**\n * Check if two array values are equal (same refs, same order).\n */\nexport function arraysEqual<T>(\n  a: readonly T[] | null,\n  b: readonly T[] | null\n): boolean {\n  if (a === null && b === null) return true;\n  if (a === null || b === null) return false;\n  if (a.length !== b.length) return false;\n  return a.every((x, i) => Object.is(x, b[i]));\n}\n"]}

package/src/lib/internal/combobox/combobox.keyboard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared combobox keyboard "brain" for Select and AutoComplete.
+ * Handles closed-state keys, open-state keys, typeahead, and activeDescendant sync.
+ */
+import type { ComboboxListboxApi } from './combobox.listbox-api';
+export type { ComboboxListboxApi } from './combobox.listbox-api';
+/** Context passed to the combobox keyboard handler. */
+export interface ComboboxKeyboardContext {
+    disabled: boolean;
+    open: boolean;
+    /** Open the popup and prepare for interaction (e.g. Select opens list, AutoComplete opens + may filter). */
+    openSelect: () => void;
+    close: () => void;
+    listbox: ComboboxListboxApi | null;
+    /** Sync aria-activedescendant on the trigger (who owns it). */
+    setActiveDescendantId: (id: string | null) => void;
+    /** When true (multiselect), Enter toggles options; we must not call commitActive again when handleKey already ran. */
+    multiSelect?: boolean;
+}
+/** Options to customize keyboard behavior (e.g. AutoComplete may disable typeahead). */
+export interface ComboboxKeyboardOptions {
+    /** Enable typeahead when open. Default true. AutoComplete may set false and handle in input. */
+    enableTypeahead?: boolean;
+    /** Keys that open when closed. Default: ArrowDown, ArrowUp, Enter, Space. */
+    keysToOpen?: readonly string[];
+    /** Keys that open when closed but must NOT preventDefault (e.g. Backspace/Delete so input can delete). */
+    keysToOpenNoPreventDefault?: readonly string[];
+    /**
+     * When true (default), Space commits the active option when open (Select behavior).
+     * When false (AutoComplete), Space inserts into input like normal typing (e.g. "United St" for filtering).
+     */
+    spaceCommits?: boolean;
+}
+/**
+ * Handles combobox keyboard events. Call from the trigger's keydown handler.
+ * Mutates `event` (preventDefault/stopPropagation) when the key is handled.
+ */
+export declare function handleComboboxKeydown(event: KeyboardEvent, context: ComboboxKeyboardContext, options?: ComboboxKeyboardOptions): void;
+//# sourceMappingURL=combobox.keyboard.d.ts.map

package/src/lib/internal/combobox/combobox.keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.keyboard.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.keyboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,uDAAuD;AACvD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,4GAA4G;IAC5G,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,+DAA+D;IAC/D,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,sHAAsH;IACtH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,0GAA0G;IAC1G,0BAA0B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAUD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAyFN"}

package/src/lib/internal/combobox/combobox.keyboard.js

@@ -0,0 +1,88 @@
+/**
+ * Shared combobox keyboard "brain" for Select and AutoComplete.
+ * Handles closed-state keys, open-state keys, typeahead, and activeDescendant sync.
+ */
+import { ensureActiveAndSync, syncActiveDescendant } from './combobox.active';
+const DEFAULT_KEYS_TO_OPEN = [
+    'ArrowDown',
+    'ArrowUp',
+    'Enter',
+    ' ',
+    'Spacebar',
+];
+/**
+ * Handles combobox keyboard events. Call from the trigger's keydown handler.
+ * Mutates `event` (preventDefault/stopPropagation) when the key is handled.
+ */
+export function handleComboboxKeydown(event, context, options = {}) {
+    if (context.disabled)
+        return;
+    const { enableTypeahead = true, keysToOpen = DEFAULT_KEYS_TO_OPEN, keysToOpenNoPreventDefault = [], spaceCommits = true, } = options;
+    // --- Closed state: ArrowDown/ArrowUp/Enter/Space open + set active ---
+    if (!context.open) {
+        if (keysToOpen.includes(event.key)) {
+            const noPrevent = keysToOpenNoPreventDefault.includes(event.key);
+            if (!noPrevent) {
+                event.preventDefault();
+            }
+            context.openSelect();
+            ensureActiveAndSync(context.listbox, context.setActiveDescendantId, event.key === 'ArrowUp' ? 'last' : 'first');
+        }
+        return;
+    }
+    // --- Open state ---
+    // Tab: close and allow browser to move focus (do not preventDefault)
+    if (event.key === 'Tab') {
+        context.close();
+        return;
+    }
+    // Escape: close
+    if (event.key === 'Escape') {
+        if (!event.defaultPrevented) {
+            event.preventDefault();
+            event.stopPropagation();
+            context.close();
+        }
+        return;
+    }
+    // Space: when spaceCommits (Select) → commit; when !spaceCommits (AutoComplete) → return so input receives it
+    if (event.key === ' ' || event.key === 'Spacebar') {
+        if (spaceCommits) {
+            event.preventDefault();
+            context.listbox?.commitActive();
+        }
+        return;
+    }
+    // Typeahead: single char (exclude Space, modifiers) → route to listbox or ignore
+    if (enableTypeahead &&
+        event.key.length === 1 &&
+        event.key !== ' ' &&
+        !event.ctrlKey &&
+        !event.metaKey &&
+        !event.altKey) {
+        const moved = context.listbox?.typeahead?.(event.key) ?? false;
+        if (moved) {
+            syncActiveDescendant(context.listbox, context.setActiveDescendantId);
+            event.preventDefault();
+        }
+        return;
+    }
+    // Arrow keys, Home, End, etc.
+    const moved = context.listbox?.handleKey(event.key, event.shiftKey) ?? false;
+    if (moved) {
+        syncActiveDescendant(context.listbox, context.setActiveDescendantId);
+        event.preventDefault();
+        // Single-select: listbox did select-active. Still need commitActive to close overlay.
+        // Multi-select: listbox did toggle-active. Do NOT call commitActive—it would toggle again.
+        if (event.key === 'Enter' && !context.multiSelect) {
+            context.listbox?.commitActive();
+        }
+        return;
+    }
+    // Enter: listbox did not handle it (no active). Fallback: close if we have a selection.
+    if (event.key === 'Enter') {
+        event.preventDefault();
+        context.listbox?.commitActive();
+    }
+}
+//# sourceMappingURL=combobox.keyboard.js.map

package/src/lib/internal/combobox/combobox.keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.keyboard.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.keyboard.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared combobox keyboard \"brain\" for Select and AutoComplete.\n * Handles closed-state keys, open-state keys, typeahead, and activeDescendant sync.\n */\n\nimport { ensureActiveAndSync, syncActiveDescendant } from './combobox.active';\nimport type { ComboboxListboxApi } from './combobox.listbox-api';\nexport type { ComboboxListboxApi } from './combobox.listbox-api';\n\n/** Context passed to the combobox keyboard handler. */\nexport interface ComboboxKeyboardContext {\n  disabled: boolean;\n  open: boolean;\n  /** Open the popup and prepare for interaction (e.g. Select opens list, AutoComplete opens + may filter). */\n  openSelect: () => void;\n  close: () => void;\n  listbox: ComboboxListboxApi | null;\n  /** Sync aria-activedescendant on the trigger (who owns it). */\n  setActiveDescendantId: (id: string | null) => void;\n  /** When true (multiselect), Enter toggles options; we must not call commitActive again when handleKey already ran. */\n  multiSelect?: boolean;\n}\n\n/** Options to customize keyboard behavior (e.g. AutoComplete may disable typeahead). */\nexport interface ComboboxKeyboardOptions {\n  /** Enable typeahead when open. Default true. AutoComplete may set false and handle in input. */\n  enableTypeahead?: boolean;\n  /** Keys that open when closed. Default: ArrowDown, ArrowUp, Enter, Space. */\n  keysToOpen?: readonly string[];\n  /** Keys that open when closed but must NOT preventDefault (e.g. Backspace/Delete so input can delete). */\n  keysToOpenNoPreventDefault?: readonly string[];\n  /**\n   * When true (default), Space commits the active option when open (Select behavior).\n   * When false (AutoComplete), Space inserts into input like normal typing (e.g. \"United St\" for filtering).\n   */\n  spaceCommits?: boolean;\n}\n\nconst DEFAULT_KEYS_TO_OPEN = [\n  'ArrowDown',\n  'ArrowUp',\n  'Enter',\n  ' ',\n  'Spacebar',\n] as const;\n\n/**\n * Handles combobox keyboard events. Call from the trigger's keydown handler.\n * Mutates `event` (preventDefault/stopPropagation) when the key is handled.\n */\nexport function handleComboboxKeydown(\n  event: KeyboardEvent,\n  context: ComboboxKeyboardContext,\n  options: ComboboxKeyboardOptions = {}\n): void {\n  if (context.disabled) return;\n\n  const {\n    enableTypeahead = true,\n    keysToOpen = DEFAULT_KEYS_TO_OPEN,\n    keysToOpenNoPreventDefault = [],\n    spaceCommits = true,\n  } = options;\n\n  // --- Closed state: ArrowDown/ArrowUp/Enter/Space open + set active ---\n  if (!context.open) {\n    if (keysToOpen.includes(event.key)) {\n      const noPrevent = keysToOpenNoPreventDefault.includes(event.key);\n      if (!noPrevent) {\n        event.preventDefault();\n      }\n      context.openSelect();\n      ensureActiveAndSync(\n        context.listbox,\n        context.setActiveDescendantId,\n        event.key === 'ArrowUp' ? 'last' : 'first'\n      );\n    }\n    return;\n  }\n\n  // --- Open state ---\n\n  // Tab: close and allow browser to move focus (do not preventDefault)\n  if (event.key === 'Tab') {\n    context.close();\n    return;\n  }\n\n  // Escape: close\n  if (event.key === 'Escape') {\n    if (!event.defaultPrevented) {\n      event.preventDefault();\n      event.stopPropagation();\n      context.close();\n    }\n    return;\n  }\n\n  // Space: when spaceCommits (Select) → commit; when !spaceCommits (AutoComplete) → return so input receives it\n  if (event.key === ' ' || event.key === 'Spacebar') {\n    if (spaceCommits) {\n      event.preventDefault();\n      context.listbox?.commitActive();\n    }\n    return;\n  }\n\n  // Typeahead: single char (exclude Space, modifiers) → route to listbox or ignore\n  if (\n    enableTypeahead &&\n    event.key.length === 1 &&\n    event.key !== ' ' &&\n    !event.ctrlKey &&\n    !event.metaKey &&\n    !event.altKey\n  ) {\n    const moved = context.listbox?.typeahead?.(event.key) ?? false;\n    if (moved) {\n      syncActiveDescendant(context.listbox, context.setActiveDescendantId);\n      event.preventDefault();\n    }\n    return;\n  }\n\n  // Arrow keys, Home, End, etc.\n  const moved = context.listbox?.handleKey(event.key, event.shiftKey) ?? false;\n  if (moved) {\n    syncActiveDescendant(context.listbox, context.setActiveDescendantId);\n    event.preventDefault();\n    // Single-select: listbox did select-active. Still need commitActive to close overlay.\n    // Multi-select: listbox did toggle-active. Do NOT call commitActive—it would toggle again.\n    if (event.key === 'Enter' && !context.multiSelect) {\n      context.listbox?.commitActive();\n    }\n    return;\n  }\n\n  // Enter: listbox did not handle it (no active). Fallback: close if we have a selection.\n  if (event.key === 'Enter') {\n    event.preventDefault();\n    context.listbox?.commitActive();\n  }\n}\n"]}

package/src/lib/internal/combobox/combobox.listbox-api.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared listbox bridge contract for combobox-based controls (Select, AutoComplete).
+ * Used by SelectTrigger and AutocompleteInput to communicate with the listbox.
+ */
+export interface ComboboxListboxApi {
+    /** Host element id of the listbox (for aria-controls). */
+    getHostId(): string | null;
+    /** Currently active/focused option id (for aria-activedescendant). */
+    getActiveId(): string | null;
+    /** Ensure an option is active; pref 'first' | 'last' when opening. */
+    ensureActive(pref?: 'first' | 'last'): void;
+    /** Handle arrow keys, Home, End, etc. Returns true if focus/selection moved. */
+    handleKey(key: string, shiftKey?: boolean): boolean;
+    /** Typeahead by character. Optional (Autocomplete may omit). */
+    typeahead?: (key: string) => boolean;
+    /** Commit/select the active option (Enter/Space semantics). */
+    commitActive(): void;
+}
+//# sourceMappingURL=combobox.listbox-api.d.ts.map

package/src/lib/internal/combobox/combobox.listbox-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.listbox-api.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.listbox-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAE7B,sEAAsE;IACtE,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAE5C,gFAAgF;IAChF,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEpD,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAErC,+DAA+D;IAC/D,YAAY,IAAI,IAAI,CAAC;CACtB"}

package/src/lib/internal/combobox/combobox.listbox-api.js

@@ -0,0 +1,5 @@
+/**
+ * Shared listbox bridge contract for combobox-based controls (Select, AutoComplete).
+ * Used by SelectTrigger and AutocompleteInput to communicate with the listbox.
+ */
+//# sourceMappingURL=combobox.listbox-api.js.map

package/src/lib/internal/combobox/combobox.listbox-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.listbox-api.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/combobox.listbox-api.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Shared listbox bridge contract for combobox-based controls (Select, AutoComplete).\n * Used by SelectTrigger and AutocompleteInput to communicate with the listbox.\n */\n\nexport interface ComboboxListboxApi {\n  /** Host element id of the listbox (for aria-controls). */\n  getHostId(): string | null;\n  /** Currently active/focused option id (for aria-activedescendant). */\n  getActiveId(): string | null;\n\n  /** Ensure an option is active; pref 'first' | 'last' when opening. */\n  ensureActive(pref?: 'first' | 'last'): void;\n\n  /** Handle arrow keys, Home, End, etc. Returns true if focus/selection moved. */\n  handleKey(key: string, shiftKey?: boolean): boolean;\n\n  /** Typeahead by character. Optional (Autocomplete may omit). */\n  typeahead?: (key: string) => boolean;\n\n  /** Commit/select the active option (Enter/Space semantics). */\n  commitActive(): void;\n}\n"]}

package/src/lib/internal/combobox/index.d.ts

@@ -0,0 +1,5 @@
+export { ensureActiveAndSync, syncActiveDescendant, type SetActiveDescendantId, } from './combobox.active';
+export type { ComboboxListboxApi } from './combobox.listbox-api';
+export { arraysEqual, normalizeToArray, normalizeToSingle, type ListboxValueShape, } from './combobox.commit';
+export { handleComboboxKeydown, type ComboboxKeyboardContext, type ComboboxKeyboardOptions, } from './combobox.keyboard';
+//# sourceMappingURL=index.d.ts.map

package/src/lib/internal/combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}

package/src/lib/internal/combobox/index.js

@@ -0,0 +1,4 @@
+export { ensureActiveAndSync, syncActiveDescendant, } from './combobox.active';
+export { arraysEqual, normalizeToArray, normalizeToSingle, } from './combobox.commit';
+export { handleComboboxKeydown, } from './combobox.keyboard';
+//# sourceMappingURL=index.js.map

package/src/lib/internal/combobox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/tailng-ui/primitives/src/lib/internal/combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,GAGtB,MAAM,qBAAqB,CAAC","sourcesContent":["export {\n  ensureActiveAndSync,\n  syncActiveDescendant,\n  type SetActiveDescendantId,\n} from './combobox.active';\nexport type { ComboboxListboxApi } from './combobox.listbox-api';\nexport {\n  arraysEqual,\n  normalizeToArray,\n  normalizeToSingle,\n  type ListboxValueShape,\n} from './combobox.commit';\nexport {\n  handleComboboxKeydown,\n  type ComboboxKeyboardContext,\n  type ComboboxKeyboardOptions,\n} from './combobox.keyboard';\n"]}