@underlayerdev/ui 0.8.2 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@underlayerdev/ui",
-  "version": "0.8.2",
+  "version": "0.9.1",
   "peerDependencies": {
     "@angular/cdk": "^22.0.0",
     "@angular/common": "^22.0.0",

package/types/underlayerdev-ui.d.ts

@@ -1085,6 +1085,13 @@ declare class ModalComponent {
     cancelLabel: _angular_core.InputSignal<string>;
     /** Optional CSS class for the panel (e.g. for custom variant). */
     customClass: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Below the phone breakpoint, fills the entire viewport edge-to-edge (no
+     * margin, no rounded corners, no visible backdrop) instead of the default
+     * bottom-pinned sheet every variant otherwise gets there. Has no effect
+     * above that breakpoint — desktop/tablet layout is unchanged either way.
+     */
+    fullScreenInMobile: _angular_core.InputSignal<boolean>;
     /** Emitted when the modal is closed (button, backdrop, or escape). */
     closed: _angular_core.OutputEmitterRef<void>;
     /** Emitted when the user confirms in the confirmation variant. */
@@ -1104,7 +1111,7 @@ declare class ModalComponent {
     onBackdropClick(event: MouseEvent): void;
     onEscape(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ul-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "customClass": { "alias": "customClass"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, ["*", "[ul-modal-footer]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ul-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "closeOnBackdropClick": { "alias": "closeOnBackdropClick"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "customClass": { "alias": "customClass"; "required": false; "isSignal": true; }; "fullScreenInMobile": { "alias": "fullScreenInMobile"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; "cancelled": "cancelled"; }, never, ["*", "[ul-modal-footer]"], true, never>;
 }
 
 /** Place on the element projected into [ul-navbar-logo] so the navbar can detect logo content. */
@@ -1455,6 +1462,134 @@ declare class TooltipComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TooltipComponent, "ul-tooltip", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showDelay": { "alias": "showDelay"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Open/focus/highlight state and keyboard navigation shared by combobox-
+ * style inputs (a text field paired with a listbox of options) —
+ * `ul-search-select` (closed list, one selection) and `ul-search-input`
+ * (free text plus suggestions/results) need identical open/close timing and
+ * arrow-key/Escape mechanics despite having different value semantics. This
+ * holds only that shared mechanics; each consumer still owns its own list,
+ * selection, and what Enter does when nothing is highlighted.
+ */
+declare class ComboboxState {
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
+    readonly highlightedIndex: _angular_core.WritableSignal<number>;
+    private closeTimeout;
+    /** Cancels any pending blur-close and opens immediately — for focus/typing. */
+    open(): void;
+    /**
+     * Closes after a short delay instead of immediately, so a mousedown on an
+     * option (which fires before the field's blur) can still register before
+     * the panel disappears. `onClosed` runs once the delay elapses, unless a
+     * subsequent `open()`/`close()` cancels it first.
+     */
+    scheduleClose(onClosed?: () => void, delay?: number): void;
+    /** Closes immediately — for selecting an option, submitting, or Escape. */
+    close(): void;
+    cancelScheduledClose(): void;
+    resetHighlight(): void;
+    /**
+     * Handles ArrowDown/ArrowUp (cycling over `listLength`) and Escape
+     * (closes). Returns whether it handled the key, so the caller's own
+     * keydown handler knows whether to fall through to its own Enter logic —
+     * Enter is deliberately not handled here, since selecting the highlighted
+     * option vs. falling back to something else (e.g. `ul-search-input`'s
+     * free-text submit) is caller-specific.
+     */
+    handleNavigationKey(event: KeyboardEvent, listLength: number): boolean;
+}
+
+interface SearchSuggestion {
+    value: string;
+    label: string;
+    icon?: IconName;
+}
+/**
+ * Free-text search box with a results panel: `suggestions` (e.g. recent
+ * searches) while the query is empty, swapped for `results` as soon as the
+ * user types. On desktop the panel is an anchored dropdown below the field.
+ * Below the phone breakpoint, tapping the field opens a full-screen `ul-modal`
+ * (via `fullScreenInMobile`) instead — the same pattern as X/Twitter, Google,
+ * etc.: a back button and the real field pinned to the top, results filling
+ * the rest of the screen edge to edge, no card, no backdrop. `ul-modal`
+ * supplies the focus trap, dialog role, and Escape-to-close; this component
+ * just projects its own header/results as the modal's body content.
+ * Consumers never branch on viewport or manage this themselves.
+ *
+ * Implements FormValueControl for Signal Forms. Use `[(value)]` for two-way
+ * binding.
+ */
+declare class SearchInputComponent implements FormValueControl<string> {
+    readonly size: _angular_core.InputSignal<UiSize>;
+    readonly label: _angular_core.InputSignal<string | null>;
+    readonly helperText: _angular_core.InputSignal<string | null>;
+    readonly errorText: _angular_core.InputSignal<string | null>;
+    readonly error: _angular_core.InputSignal<boolean>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Aria-label for the back button shown in the mobile takeover. */
+    readonly backLabel: _angular_core.InputSignal<string>;
+    /** Aria-label for the clear button shown in the mobile takeover when query is not empty. */
+    readonly clearLabel: _angular_core.InputSignal<string>;
+    /** Shown while the query is empty — e.g. recent searches. Replaced by `results` as soon as the user types. The consumer owns the data/persistence; this component only renders and reports selection. */
+    readonly suggestions: _angular_core.InputSignal<SearchSuggestion[]>;
+    /** Heading shown above `suggestions`, e.g. "Recent searches". Not shown once `results` takes over. */
+    readonly suggestionsLabel: _angular_core.InputSignal<string | null>;
+    /** Shown once the query is non-empty — e.g. live search results. The consumer computes/fetches these as `value` changes (via `[(value)]`/`valueChange`). */
+    readonly results: _angular_core.InputSignal<SearchSuggestion[]>;
+    /**
+     * Overrides `results` once the query is non-empty, projecting arbitrary
+     * content (e.g. rich cards with images/prices) instead of the built-in
+     * plain-text rows. `suggestions` (shown while the query is empty) are
+     * unaffected and keep rendering as plain `SearchSuggestion` rows regardless.
+     * When set, arrow-key/Enter option-highlighting is skipped — Enter always
+     * falls through to `searchSubmit` since the projected content owns its own
+     * selection interaction.
+     */
+    readonly resultsTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
+    readonly invalid: _angular_core.InputSignal<boolean>;
+    readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Emitted when the user picks a suggestion, by click or keyboard. */
+    readonly suggestionSelected: _angular_core.OutputEmitterRef<SearchSuggestion>;
+    /** Emitted on Enter when no suggestion is highlighted — the free-typed query. */
+    readonly searchSubmit: _angular_core.OutputEmitterRef<string>;
+    protected readonly ids: {
+        controlId: string;
+        helperId: string;
+        errorId: string;
+    };
+    /** Open/focus/highlight state and arrow-key/Escape mechanics shared with ul-search-select. */
+    protected readonly combobox: ComboboxState;
+    private readonly mobileInput;
+    /** Phone-sized viewport — below this, tapping the field opens the full-screen takeover instead of the anchored dropdown. */
+    protected readonly isMobile: _angular_core.Signal<boolean>;
+    protected readonly listId: string;
+    protected readonly hasError: _angular_core.Signal<boolean>;
+    protected readonly describedBy: _angular_core.Signal<string | undefined>;
+    /** Whether the query is non-empty — `results` replaces `suggestions` (and its heading) once true. */
+    protected readonly hasQuery: _angular_core.Signal<boolean>;
+    protected readonly activeList: _angular_core.Signal<SearchSuggestion[]>;
+    protected readonly activeListLabel: _angular_core.Signal<string | null>;
+    protected readonly hasCustomResults: _angular_core.Signal<boolean>;
+    protected readonly shouldShowPanel: _angular_core.Signal<boolean>;
+    protected readonly optionId: (index: number) => string;
+    protected readonly activeDescendantId: _angular_core.Signal<string | undefined>;
+    onValueChange(text: string): void;
+    onInputFocus(): void;
+    onInputBlur(): void;
+    /** The visible field on mobile is a read-only trigger — typing happens in the takeover's own field, focused once it renders. */
+    openMobileSearch(): void;
+    closeMobileSearch(): void;
+    clearInput(): void;
+    onKeydown(event: KeyboardEvent): void;
+    selectSuggestion(suggestion: SearchSuggestion): void;
+    private submitSearch;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchInputComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchInputComponent, "ul-search-input", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "suggestionsLabel": { "alias": "suggestionsLabel"; "required": false; "isSignal": true; }; "results": { "alias": "results"; "required": false; "isSignal": true; }; "resultsTemplate": { "alias": "resultsTemplate"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "suggestionSelected": "suggestionSelected"; "searchSubmit": "searchSubmit"; }, never, never, true, never>;
+}
+
 interface SearchSelectOption {
     label: string;
     value: string;
@@ -1484,10 +1619,8 @@ declare class SearchSelectComponent implements FormValueControl<string | null> {
         errorId: string;
     };
     protected readonly query: _angular_core.WritableSignal<string>;
-    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
-    protected readonly isFocused: _angular_core.WritableSignal<boolean>;
-    protected readonly highlightedIndex: _angular_core.WritableSignal<number>;
-    protected blurCloseTimeout: ReturnType<typeof setTimeout> | null;
+    /** Open/focus/highlight state and arrow-key/Escape mechanics shared with ul-search-input. */
+    protected readonly combobox: ComboboxState;
     protected readonly listId: string;
     protected readonly hasError: _angular_core.Signal<boolean>;
     protected readonly describedBy: _angular_core.Signal<string | undefined>;
@@ -1504,7 +1637,6 @@ declare class SearchSelectComponent implements FormValueControl<string | null> {
     onInputBlur(): void;
     onKeydown(event: KeyboardEvent): void;
     selectOption(opt: SearchSelectOption): void;
-    private cancelBlurClose;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchSelectComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchSelectComponent, "ul-search-select", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "showRequiredIndicator": { "alias": "showRequiredIndicator"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "minCharsToOpen": { "alias": "minCharsToOpen"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
@@ -1810,5 +1942,5 @@ declare class TextareaComponent implements FormValueControl<string> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ul-textarea", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "showRequiredIndicator": { "alias": "showRequiredIndicator"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "helperText": { "alias": "helperText"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "groupFocused": { "alias": "groupFocused"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "touched": "touchedChange"; "touch": "touch"; "value": "valueChange"; "inputBlur": "inputBlur"; "inputFocus": "inputFocus"; }, ["customField"], ["[ul-textarea-left-elements]", "[ul-textarea-field]", "[ul-textarea-right-elements]"], true, never>;
 }
 
-export { AccordionComponent, AccordionItemComponent, AreaCodeComponent, AvatarComponent, AvatarGroupComponent, BreadcrumbComponent, ButtonComponent, CalendarComponent, CardComponent, CarouselComponent, CarouselItemComponent, CheckboxComponent, CollapseComponent, CustomCurrencyPipe, DockComponent, DockItemComponent, DockItemContentSlotDirective, DropdownComponent, FileInputComponent, FooterComponent, FormFieldHelperComponent, FormFieldLabelComponent, HeroComponent, IconComponent, ImageNotFoundDirective, InputComponent, ListItemComponent, LongPressDirective, MenuComponent, MenuItemsComponent, MenuTriggerComponent, ModalComponent, NavbarAppNameSlotDirective, NavbarAvatarSlotDirective, NavbarComponent, NavbarLogoSlotDirective, NavbarSearchSlotDirective, PeHeroActionsSlotDirective, PeHeroBadgesSlotDirective, PeHeroContentSlotDirective, PeHeroSubtitleSlotDirective, PeHeroTitleSlotDirective, PillComponent, PriceButtonComponent, RadialComponent, RadioComponent, RadioGroupComponent, RichTextComponent, SearchSelectComponent, SelectComponent, SelectableRowComponent, SidebarComponent, SkeletonComponent, StatusComponent, TableComponent, TextareaComponent, TextareaFieldDirective, ToastContainerComponent, ToastService, TooltipComponent, createFormFieldIds, getFormFieldDescribedBy, toastIcon };
-export type { ActionsDistribution, AvatarData, BreadcrumbItem, BreadcrumbSeparator, CalendarDay, CalendarMode, CardCaptionSize, CardDirection, CheckboxZoneType, CollapseVariant, Currency, DockItemVariant, DropdownItem, FileInputAppearance, HeroAction, HeroAlignment, HeroSize, IconName, IconSize, IconWeight, InputAppearance, InputType, ListItemTheme, MediaAspectRatio, MenuItem, ModalVariant, PillSize, PillTheme, PillVariant, RadioGroupOption, RichTextSize, RichTextTone, SalePosition, SearchSelectOption, SelectOption, SidebarItem, SkeletonBorderRadius, SkeletonVariant, SortDirection, Status, TableColumn, TextareaResize, TimeSelection, ToastConfig, ToastKind, ToastWithRole, TooltipPosition };
+export { AccordionComponent, AccordionItemComponent, AreaCodeComponent, AvatarComponent, AvatarGroupComponent, BreadcrumbComponent, ButtonComponent, CalendarComponent, CardComponent, CarouselComponent, CarouselItemComponent, CheckboxComponent, CollapseComponent, CustomCurrencyPipe, DockComponent, DockItemComponent, DockItemContentSlotDirective, DropdownComponent, FileInputComponent, FooterComponent, FormFieldHelperComponent, FormFieldLabelComponent, HeroComponent, IconComponent, ImageNotFoundDirective, InputComponent, ListItemComponent, LongPressDirective, MenuComponent, MenuItemsComponent, MenuTriggerComponent, ModalComponent, NavbarAppNameSlotDirective, NavbarAvatarSlotDirective, NavbarComponent, NavbarLogoSlotDirective, NavbarSearchSlotDirective, PeHeroActionsSlotDirective, PeHeroBadgesSlotDirective, PeHeroContentSlotDirective, PeHeroSubtitleSlotDirective, PeHeroTitleSlotDirective, PillComponent, PriceButtonComponent, RadialComponent, RadioComponent, RadioGroupComponent, RichTextComponent, SearchInputComponent, SearchSelectComponent, SelectComponent, SelectableRowComponent, SidebarComponent, SkeletonComponent, StatusComponent, TableComponent, TextareaComponent, TextareaFieldDirective, ToastContainerComponent, ToastService, TooltipComponent, createFormFieldIds, getFormFieldDescribedBy, toastIcon };
+export type { ActionsDistribution, AvatarData, BreadcrumbItem, BreadcrumbSeparator, CalendarDay, CalendarMode, CardCaptionSize, CardDirection, CheckboxZoneType, CollapseVariant, Currency, DockItemVariant, DropdownItem, FileInputAppearance, HeroAction, HeroAlignment, HeroSize, IconName, IconSize, IconWeight, InputAppearance, InputType, ListItemTheme, MediaAspectRatio, MenuItem, ModalVariant, PillSize, PillTheme, PillVariant, RadioGroupOption, RichTextSize, RichTextTone, SalePosition, SearchSelectOption, SearchSuggestion, SelectOption, SidebarItem, SkeletonBorderRadius, SkeletonVariant, SortDirection, Status, TableColumn, TextareaResize, TimeSelection, ToastConfig, ToastKind, ToastWithRole, TooltipPosition };