@cdevhub/ngx-tw 0.2.1 → 0.3.0

package/types/cdevhub-ngx-tw-tags-input.d.ts

@@ -0,0 +1,217 @@
+import * as _angular_core from '@angular/core';
+import { OnInit, Signal } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { TwColor, TwSize, ErrorStateMatcher } from '@cdevhub/ngx-tw/core';
+import { FormFieldControl } from '@cdevhub/ngx-tw/form-field';
+
+/**
+ * Maps the committed input text to a tag value. The default returns the trimmed
+ * string, so the value type defaults to `string`. Override to build object tags
+ * (e.g. `(text) => ({ id: crypto.randomUUID(), name: text })`).
+ */
+type TwTagFactory<T> = (text: string) => T;
+/**
+ * Maps a tag value to its visible chip label and the remove-button accessible
+ * name. Defaults to `String(tag)`.
+ */
+type TwTagLabelFn<T> = (tag: T) => string;
+/**
+ * Equality comparator used to dedupe tags when `allowDuplicates` is `false` and
+ * to resolve a tag passed to `removeTag`. Defaults to `Object.is`.
+ */
+type TwTagCompareFn<T> = (a: T, b: T) => boolean;
+/** Payload of the `tagAdded` output. */
+interface TwTagAddedEvent<T> {
+    /** The tag that was committed. */
+    tag: T;
+    /** The full tag array after the addition. A fresh array reference. */
+    value: T[];
+}
+/** Payload of the `tagRemoved` output. */
+interface TwTagRemovedEvent<T> {
+    /** The tag that was removed. */
+    tag: T;
+    /** The full tag array after the removal. A fresh array reference. */
+    value: T[];
+    /** The index the removed tag occupied before removal. */
+    index: number;
+}
+
+/**
+ * Free-text multi-value input. The user types a token and commits it via Enter,
+ * a separator key, paste, or blur; committed tokens render as dismissible chips
+ * (composing `[twBadge]`) inline with the text input. The value is exposed as a
+ * real `T[]` (default `string[]`) through `ControlValueAccessor`, so it works
+ * with template-driven, reactive, and signal forms and integrates with
+ * `<tw-form-field>` for label / hint / error chrome.
+ *
+ * The control is a single tab stop with a roving-tabindex chip strip
+ * (Material `MatChipGrid` interaction model): Arrow keys traverse chips and the
+ * input, Delete / a two-step Backspace remove chips, and `LiveAnnouncer` voices
+ * add / remove. Autocomplete suggestions are out of scope (use `tw-combobox`).
+ */
+declare class TagsInputComponent<T = string> extends FormFieldControl<T[]> implements ControlValueAccessor, OnInit {
+    /** Semantic color for the container focus-within ring and the chip accent. Defaults to `'primary'`. */
+    readonly color: _angular_core.InputSignal<TwColor>;
+    /** Controls overall density: container padding, chip size, and text scale. Defaults to `'md'`. */
+    readonly size: _angular_core.InputSignal<TwSize>;
+    /** When true, blocks typing, committing, and chip removal, and applies muted styling. Reactive forms also propagate disabled via `setDisabledState`. Defaults to `false`. */
+    readonly disabledInput: _angular_core.InputSignal<boolean>;
+    /** Marks the control as required. Mirrored to the input's `aria-required`. Also inferred from `Validators.required` on a bound control. Defaults to `false`. */
+    readonly requiredInput: _angular_core.InputSignal<boolean>;
+    /** Placeholder shown in the text input only while there are no chips and the input is empty. */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    /** Keys that commit the in-progress text as a tag. Each entry is a `KeyboardEvent.key` value (`'Enter'`) or a single separator character (`','`). Single-character separators also split pasted text. Defaults to `['Enter', ',']`. */
+    readonly separatorKeys: _angular_core.InputSignal<readonly string[]>;
+    /** When true, blurring the control while the input holds non-empty text commits it as a tag. Defaults to `false`. */
+    readonly addOnBlur: _angular_core.InputSignal<boolean>;
+    /** Maximum number of tags. Once reached, further commits are blocked and announced. Does not truncate an oversized `writeValue`. Defaults to `undefined` (no limit). */
+    readonly maxTags: _angular_core.InputSignal<number | undefined>;
+    /** When false (default), a committed tag equal (per `compareWith`) to an existing tag is dropped silently. When true, duplicates are kept. Defaults to `false`. */
+    readonly allowDuplicates: _angular_core.InputSignal<boolean>;
+    /** Maps committed text to a tag value. Default is identity — the trimmed string. Override to build object tags. */
+    readonly createTag: _angular_core.InputSignal<TwTagFactory<T>>;
+    /** Maps a tag value to its visible chip label and the remove-button accessible name. Defaults to `String(tag)`. */
+    readonly tagLabel: _angular_core.InputSignal<TwTagLabelFn<T>>;
+    /** Equality comparator used for dedup when `allowDuplicates` is false. Defaults to `Object.is` (reference / value identity). String tags dedupe case-sensitively by default; pass `(a, b) => a.toLowerCase() === b.toLowerCase()` for case-insensitive dedup. */
+    readonly compareWith: _angular_core.InputSignal<TwTagCompareFn<T>>;
+    /** Applied to the text input for labeling and identification only; does not submit the tag array via native (non-Angular) form posting. */
+    readonly name: _angular_core.InputSignal<string | undefined>;
+    /** Id on the host element. Auto-generated as `tw-tags-input-N` when not provided. Used by the form-field's `<label for>` association. */
+    readonly idInput: _angular_core.InputSignal<string | undefined>;
+    /** Accessible name applied to the control when no visible label is wired. Mirrored to `aria-label`. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** ID of an external element that labels the control. Mirrored to `aria-labelledby`. */
+    readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
+    /** ID of an external element that describes the control. Form-field merges its hint / error ids alongside. */
+    readonly ariaDescribedby: _angular_core.InputSignal<string | undefined>;
+    /** Per-instance override of the {@link ErrorStateMatcher}. When omitted, uses the `TW_ERROR_STATE_MATCHER` token's value. */
+    readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
+    /** Fires when the tag array changes through user interaction (add, remove, clear). Emits a fresh array reference. Does not fire on `writeValue`. */
+    readonly valueChange: _angular_core.OutputEmitterRef<T[]>;
+    /** Fires when a tag is committed via Enter, a separator key, paste, or `addTag()`. Does not fire for dropped duplicates, blocked-by-max commits, empty commits, or `writeValue`. */
+    readonly tagAdded: _angular_core.OutputEmitterRef<TwTagAddedEvent<T>>;
+    /** Fires when a tag is removed via the remove button, Backspace / Delete, or `removeTag()`. Does not fire on `writeValue` or `clear()`. */
+    readonly tagRemoved: _angular_core.OutputEmitterRef<TwTagRemovedEvent<T>>;
+    private readonly focusMonitor;
+    private readonly liveAnnouncer;
+    private readonly elementRef;
+    private readonly destroyRef;
+    private readonly ngControl;
+    private readonly parentForm;
+    private readonly parentFormGroup;
+    private readonly defaultMatcher;
+    private readonly formField;
+    private readonly textInputRef;
+    private readonly removeButtons;
+    private onChange;
+    private onTouched;
+    private readonly tags;
+    /** The current in-progress (uncommitted) text in the input. Empty when nothing is typed. */
+    readonly inputText: _angular_core.WritableSignal<string>;
+    /** @internal Roving-tabindex position. `null` = the text input is the active element; a number = that chip's remove button. */
+    protected readonly activeChipIndex: _angular_core.WritableSignal<number | null>;
+    private readonly cvaDisabled;
+    private readonly _focused;
+    private readonly _ngControlRev;
+    private readonly _formSubmitRev;
+    private readonly describedByIdsSignal;
+    private readonly labelledByIdsSignal;
+    /** Nonce bumped only on explicit focus intent — keeps the focus effect from stealing focus on unrelated renders. */
+    private readonly focusNonce;
+    private lastMaxAnnounce;
+    private readonly uid;
+    /** @internal Fallback id used when the consumer does not set `[id]`. */
+    readonly hostId: string;
+    /** @internal */
+    readonly id: Signal<string>;
+    /** The current tag array (empty array when there are no tags). Read from a template ref (`#t="twTagsInput"`) for non-form usage. Doubles as the `FormFieldControl` contract member. */
+    readonly value: Signal<T[]>;
+    /** @internal */
+    readonly focused: Signal<boolean>;
+    /** @internal Empty when there are no chips AND the input text is blank — drives the form-field floating label. */
+    readonly empty: Signal<boolean>;
+    /** @internal */
+    readonly disabled: Signal<boolean>;
+    /** @internal */
+    readonly required: Signal<boolean>;
+    /** @internal */
+    readonly errorState: Signal<boolean>;
+    /** @internal Active validation errors map from the bound control, for `[twError match="…"]` filtering. */
+    readonly errors: Signal<Record<string, unknown> | null>;
+    /** @internal */
+    readonly controlType = "tags-input";
+    /** @internal */
+    readonly userAriaDescribedBy: Signal<string | undefined>;
+    /** @internal */
+    readonly userAriaLabelledby: Signal<string | undefined>;
+    /** @internal Merged `aria-describedby` (form-field hint/error ids + consumer-supplied). */
+    readonly resolvedDescribedBy: Signal<string>;
+    /** @internal Merged `aria-labelledby` (form-field label id + consumer-supplied). */
+    readonly resolvedLabelledBy: Signal<string>;
+    private readonly variantResult;
+    /** @internal */
+    readonly rootClasses: Signal<string>;
+    /** @internal */
+    readonly chipClasses: Signal<string>;
+    /** @internal */
+    readonly chipLabelClasses: Signal<string>;
+    /** @internal */
+    readonly removeButtonClasses: Signal<string>;
+    /** @internal */
+    readonly removeIconClasses: Signal<string>;
+    /** @internal */
+    readonly inputClasses: Signal<string>;
+    /** @internal Pre-resolved chip view models so the template never calls accessor functions inline. */
+    readonly chipViews: Signal<{
+        tag: T;
+        label: string;
+        removeLabel: string;
+        index: number;
+    }[]>;
+    constructor();
+    /** Commits `text` as a tag (trim → `createTag` → dedup unless `allowDuplicates` → `maxTags` check). Returns true if a tag was added, false if dropped (empty / duplicate / max). Emits `tagAdded` + `valueChange` on success. No-op when disabled. */
+    addTag(text: string): boolean;
+    /** Removes a tag by value (first match via `compareWith`) or by index when a number is passed. Emits `tagRemoved` + `valueChange` and restores focus. No-op when disabled or when no match. Note: when the tag type is `number`, the argument is treated as an index. */
+    removeTag(tag: T | number): void;
+    /** Removes all tags and clears the in-progress input text. Emits `valueChange` with `[]`. Does NOT emit `tagRemoved` per tag (bulk reset). No-op when already empty or disabled. */
+    clear(): void;
+    /** Moves focus to the text input. */
+    focus(): void;
+    private tryAdd;
+    private commitInput;
+    private removeAt;
+    /** @internal */
+    onInput(event: Event): void;
+    /** @internal */
+    onInputKeydown(event: KeyboardEvent): void;
+    /** @internal */
+    onChipKeydown(event: KeyboardEvent, index: number): void;
+    /** @internal */
+    onRemoveClick(index: number): void;
+    /** @internal */
+    onPaste(event: ClipboardEvent): void;
+    writeValue(value: T[] | null | undefined): void;
+    registerOnChange(fn: (value: T[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /** @internal */
+    setDescribedByIds(ids: string[]): void;
+    /** @internal */
+    setLabelledByIds(ids: string[]): void;
+    /** @internal Clicking the form-field surface (outside the control) focuses the text input. Clicks inside the control are left alone so chip removal keeps its own focus restoration. */
+    onContainerClick(event: MouseEvent): void;
+    ngOnInit(): void;
+    private focusChip;
+    private focusInput;
+    private requestFocus;
+    private setInputText;
+    private announceMax;
+    private splitOnSeparators;
+    private hasAccessibleNameHint;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagsInputComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagsInputComponent<any>, "tw-tags-input", ["twTagsInput"], { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "requiredInput": { "alias": "required"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "separatorKeys": { "alias": "separatorKeys"; "required": false; "isSignal": true; }; "addOnBlur": { "alias": "addOnBlur"; "required": false; "isSignal": true; }; "maxTags": { "alias": "maxTags"; "required": false; "isSignal": true; }; "allowDuplicates": { "alias": "allowDuplicates"; "required": false; "isSignal": true; }; "createTag": { "alias": "createTag"; "required": false; "isSignal": true; }; "tagLabel": { "alias": "tagLabel"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "ariaDescribedby": { "alias": "aria-describedby"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "tagAdded": "tagAdded"; "tagRemoved": "tagRemoved"; }, never, never, true, never>;
+}
+
+export { TagsInputComponent };
+export type { TwTagAddedEvent, TwTagCompareFn, TwTagFactory, TwTagLabelFn, TwTagRemovedEvent };

package/types/cdevhub-ngx-tw-time-picker.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { Provider, OnInit, Signal } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
+import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 import { TwSize, TwColor, TimePickerFormat, ErrorStateMatcher, TimePickerMeridiem } from '@cdevhub/ngx-tw/core';
 export { TimePickerFormat, TimePickerMeridiem } from '@cdevhub/ngx-tw/core';
 import { FormFieldControl } from '@cdevhub/ngx-tw/form-field';
@@ -97,7 +97,24 @@ interface TimePickerInputEvent<D> {
  * `DateAdapter<D>`, so the component works with the default native adapter
  * (`provideNativeDateAdapter()`) or any custom adapter a consumer ships.
  */
-declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implements ControlValueAccessor, OnInit {
+/**
+ * Validation errors a `tw-time-picker` can place on its bound control.
+ *
+ * Mirrors the shape of `CalendarValidationErrors` so the two pickers report
+ * constraint violations the same way: a code keyed by what was violated, with
+ * the offending value and the bound it broke.
+ */
+type TimePickerValidationErrors = Partial<{
+    timePickerMin: {
+        min: unknown;
+        actual: unknown;
+    };
+    timePickerMax: {
+        max: unknown;
+        actual: unknown;
+    };
+}>;
+declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implements ControlValueAccessor, Validator, OnInit {
     /** Id on the time-picker's host element. Auto-generated when not provided. Used by the form-field's `<label for>` attribute. */
     readonly idInput: _angular_core.InputSignal<string | undefined>;
     /** When true, the whole component is disabled and every field sets `aria-disabled="true"`. Defaults to `false`. */
@@ -122,9 +139,9 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly minuteStep: _angular_core.InputSignal<number>;
     /** Amount to add/subtract when stepping seconds. Defaults to `1`. */
     readonly secondStep: _angular_core.InputSignal<number>;
-    /** Earliest accepted time-of-day. Values earlier than this set `errorState`. Defaults to `null`. Note: when `showSeconds` is `false`, the seconds component of any value still participates in the range comparison — supply `minTime` with zeroed seconds to match the 2-field display. */
+    /** Earliest accepted time-of-day. Values earlier than this set `errorState` and mark the bound control invalid with `timePickerMin`. Defaults to `null`. Note: when `showSeconds` is `false`, the seconds component of any value still participates in the range comparison — supply `minTime` with zeroed seconds to match the 2-field display. */
     readonly minTime: _angular_core.InputSignal<D | null>;
-    /** Latest accepted time-of-day. Values later than this set `errorState`. Defaults to `null`. Note: when `showSeconds` is `false`, the seconds component of any value still participates in the range comparison — supply `maxTime` with zeroed seconds to match the 2-field display. */
+    /** Latest accepted time-of-day. Values later than this set `errorState` and mark the bound control invalid with `timePickerMax`. Defaults to `null`. Note: when `showSeconds` is `false`, the seconds component of any value still participates in the range comparison — supply `maxTime` with zeroed seconds to match the 2-field display. */
     readonly maxTime: _angular_core.InputSignal<D | null>;
     /** Date portion used when the user types a time while `value` is `null`. Defaults to today. */
     readonly referenceDate: _angular_core.InputSignal<D | null>;
@@ -155,8 +172,9 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     private readonly liveAnnouncer;
     private readonly elementRef;
     private readonly destroyRef;
+    private readonly injector;
     private readonly formField;
-    private readonly ngControl;
+    private ngControl;
     private readonly parentForm;
     private readonly parentFormGroup;
     private readonly defaultMatcher;
@@ -287,6 +305,13 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     private stepFor;
     private fieldMinFor;
     private fieldMaxFor;
+    private validatorOnChange;
+    /** @internal */
+    validate(control: AbstractControl): ValidationErrors | null;
+    /** @internal */
+    registerOnValidatorChange(fn: () => void): void;
+    /** Time-of-day in seconds, ignoring the date part — the same basis `isInRange` uses. */
+    private secondsOf;
     writeValue(value: unknown): void;
     registerOnChange(fn: (value: D | null) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -300,4 +325,4 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
 }
 
 export { TimePickerComponent, TimePickerIntl, provideTimePickerIntl };
-export type { TimePickerChangeEvent, TimePickerChangeSource, TimePickerField, TimePickerInputEvent, TimePickerVariant };
+export type { TimePickerChangeEvent, TimePickerChangeSource, TimePickerField, TimePickerInputEvent, TimePickerValidationErrors, TimePickerVariant };

package/types/cdevhub-ngx-tw-transfer.d.ts

@@ -0,0 +1,330 @@
+import * as _angular_core from '@angular/core';
+import { OnInit, Signal, TemplateRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { ListboxValueChangeEvent } from '@angular/cdk/listbox';
+import { TwSize, ErrorStateMatcher } from '@cdevhub/ngx-tw/core';
+import { FormFieldControl } from '@cdevhub/ngx-tw/form-field';
+
+/** Which panel of the transfer an item / event belongs to. */
+type TwTransferSide = 'source' | 'target';
+/** i18n strings for the transfer. Pass any subset; unset keys fall back to the English defaults. */
+interface TwTransferLabels {
+    /** Source (left) panel title. Defaults to `'Source'`. */
+    sourceTitle?: string;
+    /** Target (right) panel title. Defaults to `'Target'`. */
+    targetTitle?: string;
+    /** Placeholder + accessible name for the per-panel search inputs. Defaults to `'Search'`. */
+    searchPlaceholder?: string;
+    /** Text shown in a panel body when it has no visible items. Defaults to `'No items'`. */
+    emptyText?: string;
+    /** Accessible name for the header select-all checkbox. Defaults to `'Select all'`. */
+    selectAllLabel?: string;
+    /** Accessible name for the → (move-to-target) button. Defaults to `'Move selected to target'`. */
+    moveToTargetLabel?: string;
+    /** Accessible name for the ← (move-to-source) button. Defaults to `'Move selected to source'`. */
+    moveToSourceLabel?: string;
+    /** Count template rendered in each panel header. Variables: `{total}`, `{selected}`. Defaults to `'{total} items'`. */
+    countFormat?: string;
+    /** LiveAnnouncer template announced after a move. Variables: `{count}`, `{target}`. Defaults to `'{count} items moved to {target}'`. */
+    moveAnnouncement?: string;
+}
+/** Visual configuration for the transfer. Pass any subset; unset keys fall back to the defaults. */
+interface TwTransferDisplayConfig {
+    /** Row / control density across the design-system ramps. Defaults to `'md'`. */
+    size?: TwSize;
+    /** Scroll-viewport height of each list, in px (a number) or `'auto'` (flow with content). Defaults to `240`. */
+    listHeight?: number | 'auto';
+    /** When true, each panel gets a labelled search input above its list. Defaults to `false`. */
+    showSearch?: boolean;
+    /** When true, each panel header shows a tri-state select-all checkbox. Defaults to `true`. */
+    showSelectAll?: boolean;
+}
+/** Behavioural configuration for the transfer. Generic over item type `T`. Pass any subset; unset keys fall back to the defaults. */
+interface TwTransferBehaviorConfig<T = unknown> {
+    /** When true, items only flow source → target; the ← button is not rendered. Defaults to `false`. */
+    oneWay?: boolean;
+    /** Custom search predicate. Defaults to a case-insensitive substring match of the query against `labelFn(item)`. */
+    filterFn?: (item: T, query: string) => boolean;
+    /** Per-item disable predicate. A disabled item renders as a disabled option and is excluded from select-all and all moves. Defaults to `() => false`. */
+    disabledItem?: (item: T) => boolean;
+}
+/** Context surfaced to a `*twTransferItem` template. Generic over the item type `T`. */
+interface TwTransferItemContext<T> {
+    /** The item data (implicit `let-item`). */
+    $implicit: T;
+    /** Resolved `labelFn(item)`. */
+    label: string;
+    /** Ephemeral pending-move checked state of this row's option. */
+    checked: boolean;
+    /** Whether the item is disabled (via `behavior.disabledItem`). */
+    disabled: boolean;
+    /** Which panel this row renders in. */
+    side: TwTransferSide;
+}
+/** Payload emitted by `moved`. Generic over the key type `K`. */
+interface TwTransferMovedEvent<K> {
+    /** The keys that moved in this interaction. */
+    keys: readonly K[];
+    /** The direction of the move. */
+    direction: 'toTarget' | 'toSource';
+}
+/** Structural directive (`*twTransferItem="let item"`) declaring the per-item template. Typed as `TwTransferItemContext<T>`. */
+declare class TransferItemDefDirective<T = unknown> {
+    /** @internal Consumer-projected per-item template. */
+    readonly template: TemplateRef<any>;
+    /** @internal */
+    static ngTemplateContextGuard<T>(_dir: TransferItemDefDirective<T>, _ctx: unknown): _ctx is TwTransferItemContext<T>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TransferItemDefDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TransferItemDefDirective<any>, "[twTransferItem]", never, {}, {}, never, never, true, never>;
+}
+interface RowBase<T, K> {
+    readonly item: T;
+    readonly key: K;
+    readonly label: string;
+    readonly disabled: boolean;
+}
+interface RowView<T, K> extends RowBase<T, K> {
+    readonly checked: boolean;
+    readonly optionClass: string;
+    readonly checkClass: string;
+    readonly context: TwTransferItemContext<T>;
+}
+interface PanelView<T, K> {
+    readonly side: TwTransferSide;
+    readonly title: string;
+    readonly titleId: string;
+    readonly countText: string;
+    readonly emptyText: string;
+    readonly searchPlaceholder: string;
+    readonly selectAllLabel: string;
+    readonly query: string;
+    readonly rows: readonly RowView<T, K>[];
+    readonly checkedValue: readonly K[];
+    readonly selectAllChecked: boolean;
+    readonly selectAllIndeterminate: boolean;
+}
+/**
+ * A dual-listbox shuttle: two panels (source / target) with a column of move
+ * buttons between them. The user ticks items in a panel and shuttles them across;
+ * an optional per-panel search and a tri-state header select-all accelerate bulk
+ * moves. The component's value is the set of keys on the target side, exposed
+ * through `ControlValueAccessor` + `FormFieldControl` so it works with reactive,
+ * template-driven, and signal forms and integrates with `<tw-form-field>`.
+ *
+ * Each panel composes `@angular/cdk/listbox` (`CdkListbox` / `CdkOption`) for
+ * focus-managed, accessible, keyboard-navigable selection. Consumers supply
+ * `keyFn` (required) and `labelFn` (defaulted to `String(item)`), and may project
+ * a `*twTransferItem` template for rich row content.
+ */
+declare class TransferComponent<T = unknown, K = unknown> extends FormFieldControl<readonly K[]> implements ControlValueAccessor, OnInit {
+    /** All items across both panels. The source/target split derives from the value, not the reverse. Defaults to `[]`. */
+    readonly data: _angular_core.InputSignal<readonly T[]>;
+    /** Resolves a stable key for an item — drives membership (the value), checked state, tracking, the cdkOption value, and compareWith. Required. */
+    readonly keyFn: _angular_core.InputSignal<(item: T) => K>;
+    /** Resolves an item's display label — used for the default row render, search filtering, and listbox typeahead. Defaults to `(item) => String(item)`. */
+    readonly labelFn: _angular_core.InputSignal<(item: T) => string>;
+    /** Per-panel text + ARIA labels. Partial; unset keys fall back to the English defaults. */
+    readonly labels: _angular_core.InputSignal<Partial<TwTransferLabels>>;
+    /** Visual configuration — size, list viewport height, search / select-all visibility. Partial; unset keys fall back to the defaults. */
+    readonly display: _angular_core.InputSignal<Partial<TwTransferDisplayConfig>>;
+    /** Behavioural configuration — oneWay, custom filterFn, per-item disabledItem predicate. Partial; unset keys fall back to the defaults. */
+    readonly behavior: _angular_core.InputSignal<Partial<TwTransferBehaviorConfig<T>>>;
+    /** Disables the entire control — panels non-interactive, search + buttons disabled, muted styling. Also driven by Forms `setDisabledState`. Defaults to `false`. */
+    readonly disabledInput: _angular_core.InputSignal<boolean>;
+    /** Marks the control as required. Mirrored to `aria-required` chrome via the form-field; also inferred from `Validators.required` on a bound control. Defaults to `false`. */
+    readonly requiredInput: _angular_core.InputSignal<boolean>;
+    /** Reserved for control identification (e.g. analytics, future native-submission parity). The transfer has no single native value element, so it is not currently reflected to the DOM. Defaults to `undefined`. */
+    readonly name: _angular_core.InputSignal<string | undefined>;
+    /** Id on the host element. Auto-generated as `tw-transfer-N` when unset. Used by the form-field's `<label for>` association. */
+    readonly idInput: _angular_core.InputSignal<string | undefined>;
+    /** Accessible name applied to the control when no visible label is wired. Mirrored to `aria-label`. Defaults to `undefined`. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** ID of an external element that labels the control. Mirrored to `aria-labelledby`. Defaults to `undefined`. */
+    readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
+    /** ID of an external element that describes the control. The form-field merges its hint / error ids alongside. Defaults to `undefined`. */
+    readonly ariaDescribedby: _angular_core.InputSignal<string | undefined>;
+    /** Per-instance override of the {@link ErrorStateMatcher}. When omitted, uses the `TW_ERROR_STATE_MATCHER` token's value. Defaults to `undefined`. */
+    readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
+    /** Fires when items move between panels by user interaction. Payload is the new full target-keys array. Does not fire on `writeValue`. */
+    readonly valueChange: _angular_core.OutputEmitterRef<readonly K[]>;
+    /** Fires after each directional move, identifying the moved keys and their direction. Does not fire on `writeValue`. */
+    readonly moved: _angular_core.OutputEmitterRef<TwTransferMovedEvent<K>>;
+    /** @internal Consumer-projected per-item template (`*twTransferItem`). */
+    readonly itemTemplate: Signal<TransferItemDefDirective<any> | undefined>;
+    private readonly elementRef;
+    private readonly injector;
+    private readonly destroyRef;
+    private readonly focusMonitor;
+    private readonly liveAnnouncer;
+    private readonly ngControl;
+    private readonly parentForm;
+    private readonly parentFormGroup;
+    private readonly defaultMatcher;
+    private readonly platform;
+    private readonly uid;
+    /** @internal Fallback id used when the consumer does not set `[id]`. */
+    readonly hostId: string;
+    private readonly sourceTitleId;
+    private readonly targetTitleId;
+    /** @internal The value: keys currently on the target side. Source of truth for membership. */
+    private readonly targetKeys;
+    /** @internal Per-panel search queries. */
+    private readonly sourceQuery;
+    private readonly targetQuery;
+    private readonly cvaDisabled;
+    private readonly _focused;
+    private readonly _ngControlRev;
+    private readonly _formSubmitRev;
+    private readonly describedByIdsSignal;
+    private readonly labelledByIdsSignal;
+    private onChange;
+    private onTouched;
+    /** @internal Stable comparator for `[cdkListboxCompareWith]`. Keys are identity-comparable. */
+    readonly compareKeys: (a: K, b: K) => boolean;
+    /** @internal */
+    readonly resolvedLabels: Signal<Required<TwTransferLabels>>;
+    private readonly resolvedDisplay;
+    private readonly resolvedBehavior;
+    /** @internal */
+    readonly resolvedSize: Signal<TwSize>;
+    /** @internal Checkbox tops out at `lg` density; map xl → lg. */
+    readonly checkboxSize: Signal<TwSize>;
+    /** @internal */
+    readonly showSearch: Signal<boolean>;
+    /** @internal */
+    readonly showSelectAll: Signal<boolean>;
+    /** @internal */
+    readonly oneWay: Signal<boolean>;
+    /** @internal Fixed list height in px, or `null` when `'auto'`. */
+    readonly listHeightPx: Signal<number | null>;
+    /** @internal Map from key to item across all data — for orphan-aware target rendering and disabled lookups. */
+    private readonly itemByKey;
+    private readonly targetKeySet;
+    /** @internal Items on the source side (in `data` order). */
+    private readonly sourceItems;
+    /** @internal Items on the target side (in `targetKeys` order; orphan keys with no item are skipped). */
+    private readonly targetItems;
+    private readonly sourceRowsBase;
+    private readonly sourceRenderedKeys;
+    /**
+     * @internal Ephemeral pending-move checked keys for the source panel — the
+     * controlled `[cdkListboxValue]`. A `linkedSignal` over the rendered-key set so
+     * it auto-prunes keys whose option a filter / move removed (kept ⊆ rendered → no
+     * CdkListbox `_invalid`; dropped keys do not re-surface). Cleared after moves.
+     */
+    readonly sourceChecked: _angular_core.WritableSignal<readonly K[]>;
+    private readonly sourceCheckedSet;
+    private readonly sourceRows;
+    private readonly targetRowsBase;
+    private readonly targetRenderedKeys;
+    /** @internal Ephemeral pending-move checked keys for the target panel — see {@link sourceChecked}. */
+    readonly targetChecked: _angular_core.WritableSignal<readonly K[]>;
+    private readonly targetCheckedSet;
+    private readonly targetRows;
+    /** @internal Checked, enabled, visible source keys — what the → button moves. */
+    readonly sourceMovableKeys: Signal<readonly K[]>;
+    /** @internal Checked, enabled, visible target keys — what the ← button moves. */
+    readonly targetMovableKeys: Signal<readonly K[]>;
+    private readonly sourceSelectAllKeys;
+    private readonly targetSelectAllKeys;
+    /** @internal */
+    readonly sourcePanel: Signal<PanelView<T, K>>;
+    /** @internal */
+    readonly targetPanel: Signal<PanelView<T, K>>;
+    private readonly variants;
+    /** @internal */
+    readonly rootClasses: Signal<string>;
+    /** @internal */
+    readonly panelClasses: Signal<string>;
+    /** @internal */
+    readonly panelHeaderClasses: Signal<string>;
+    /** @internal */
+    readonly panelTitleClasses: Signal<string>;
+    /** @internal */
+    readonly panelCountClasses: Signal<string>;
+    /** @internal */
+    readonly searchClasses: Signal<string>;
+    /** @internal */
+    readonly listClasses: Signal<string>;
+    /** @internal */
+    readonly optionLabelClasses: Signal<string>;
+    /** @internal */
+    readonly controlsClasses: Signal<string>;
+    /** @internal */
+    readonly moveButtonClasses: Signal<string>;
+    /** @internal */
+    readonly moveIconClasses: Signal<string>;
+    /** @internal */
+    readonly emptyClasses: Signal<string>;
+    constructor();
+    /** Moves the given items (by key) to the target side; ignores keys already there or whose item is disabled. Clears the source panel's pending checks, emits `valueChange` + `moved`, calls the CVA onChange, and announces the move. No-op when the control is disabled. */
+    moveToTarget(keys: readonly K[]): void;
+    /** Moves the given items (by key) to the source side; ignores keys not on target or whose item is disabled. Clears the target panel's pending checks. No-op when the control is disabled or `behavior.oneWay` is on. Same emissions as {@link moveToTarget}. */
+    moveToSource(keys: readonly K[]): void;
+    /** @internal */
+    onCheckedChange(side: TwTransferSide, event: ListboxValueChangeEvent<K>): void;
+    /** @internal Select-all toggles the visible, enabled keys for the panel (replace semantics). */
+    onSelectAll(side: TwTransferSide, checked: boolean): void;
+    /** @internal */
+    onSearch(side: TwTransferSide, event: Event): void;
+    /** @internal */
+    onMoveToTarget(): void;
+    /** @internal */
+    onMoveToSource(): void;
+    /**
+     * @internal Focuses the destination panel's listbox after the move re-renders.
+     * Deferred to the next render (the destination listbox may have just mounted
+     * from empty) and matched by its title id rather than DOM order (the *other*
+     * panel may have emptied, removing its listbox).
+     */
+    private focusDestination;
+    private applyValue;
+    private filterItems;
+    private toRowsBase;
+    private toRows;
+    private buildPanel;
+    private selectAllState;
+    private hasAccessibleNameHint;
+    /** @internal */
+    readonly id: Signal<string>;
+    /** The current target-keys array. Doubles as the `FormFieldControl` value member. */
+    readonly value: Signal<readonly K[]>;
+    /** @internal */
+    readonly focused: Signal<boolean>;
+    /** @internal Empty when nothing is on the target side — drives the form-field floating label. */
+    readonly empty: Signal<boolean>;
+    /** @internal */
+    readonly disabled: Signal<boolean>;
+    /** @internal */
+    readonly required: Signal<boolean>;
+    /** @internal */
+    readonly errorState: Signal<boolean>;
+    /** @internal Active validation errors from the bound control, for `[twError match="…"]` filtering. */
+    readonly errors: Signal<Record<string, unknown> | null>;
+    /** @internal */
+    readonly controlType = "transfer";
+    /** @internal */
+    readonly userAriaDescribedBy: Signal<string | undefined>;
+    /** @internal */
+    readonly userAriaLabelledby: Signal<string | undefined>;
+    /** @internal Merged `aria-describedby` (form-field hint/error ids + consumer-supplied). */
+    readonly resolvedDescribedBy: Signal<string>;
+    /** @internal Merged `aria-labelledby` (form-field label id + consumer-supplied). */
+    readonly resolvedLabelledBy: Signal<string>;
+    writeValue(value: readonly K[] | null | undefined): void;
+    registerOnChange(fn: (value: readonly K[]) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /** @internal */
+    setDescribedByIds(ids: string[]): void;
+    /** @internal */
+    setLabelledByIds(ids: string[]): void;
+    /** @internal Clicking the form-field surface focuses the first listbox. */
+    onContainerClick(event: MouseEvent): void;
+    ngOnInit(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TransferComponent<any, any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TransferComponent<any, any>, "tw-transfer", ["twTransfer"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "keyFn": { "alias": "keyFn"; "required": true; "isSignal": true; }; "labelFn": { "alias": "labelFn"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "display": { "alias": "display"; "required": false; "isSignal": true; }; "behavior": { "alias": "behavior"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "requiredInput": { "alias": "required"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "ariaDescribedby": { "alias": "aria-describedby"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "moved": "moved"; }, ["itemTemplate"], never, true, never>;
+}
+
+export { TransferComponent, TransferItemDefDirective };
+export type { TwTransferBehaviorConfig, TwTransferDisplayConfig, TwTransferItemContext, TwTransferLabels, TwTransferMovedEvent, TwTransferSide };