@underlayerdev/ui 0.13.4 → 0.14.0

package/package.json

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

package/types/underlayerdev-ui.d.ts

@@ -346,6 +346,81 @@ declare class CardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "ul-card", never, { "focused": { "alias": "focused"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "cardDirection": { "alias": "cardDirection"; "required": false; "isSignal": true; }; "cardCaptionSize": { "alias": "cardCaptionSize"; "required": false; "isSignal": true; }; "footerDist": { "alias": "footerDist"; "required": false; "isSignal": true; }; "mediaAspectRatio": { "alias": "mediaAspectRatio"; "required": false; "isSignal": true; }; "mediaBlur": { "alias": "mediaBlur"; "required": false; "isSignal": true; }; "mediaGrayscale": { "alias": "mediaGrayscale"; "required": false; "isSignal": true; }; "cardCaption": { "alias": "cardCaption"; "required": false; "isSignal": true; }; "cardTitle": { "alias": "cardTitle"; "required": false; "isSignal": true; }; "cardTitleSingleLine": { "alias": "cardTitleSingleLine"; "required": false; "isSignal": true; }; "cardSubtitle": { "alias": "cardSubtitle"; "required": false; "isSignal": true; }; "cardSubtitleSingleLine": { "alias": "cardSubtitleSingleLine"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, ["[ulCardMedia]", "[ulCardMediaOverlay]", "[ulCardMediaAction]", "[ulCardFooter]"], true, never>;
 }
 
+interface CategoryPickerNode {
+    id: string;
+    parentId: string | null;
+    label: string;
+    icon?: string;
+    isLeaf: boolean;
+}
+/**
+ * Picker for a hierarchical category tree of unbounded depth: a closed field
+ * that opens a drill-down + search modal (one level of children at a time,
+ * with a breadcrumb trail back to root) and resolves to a single leaf
+ * node's id. Implements FormValueControl for Signal Forms [formField]. Use
+ * [(value)] for two-way binding.
+ *
+ * Rows are real buttons (ul-list-item), so Tab/Shift+Tab and Enter/Space
+ * already give full keyboard access without extra arrow-key wiring — unlike
+ * ul-search-select's single-line combobox overlay, there's no need for
+ * ComboboxState here.
+ *
+ * @example
+ * <ul-category-picker label="Category" [nodes]="categoryNodes" [(value)]="categoryId" />
+ */
+declare class CategoryPickerComponent implements FormValueControl<string | null> {
+    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 required: _angular_core.InputSignal<boolean>;
+    readonly showRequiredIndicator: _angular_core.InputSignal<boolean>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly searchPlaceholder: _angular_core.InputSignal<string>;
+    readonly modalTitle: _angular_core.InputSignal<string>;
+    readonly rootLabel: _angular_core.InputSignal<string>;
+    readonly noResultsText: _angular_core.InputSignal<string>;
+    readonly nodes: _angular_core.InputSignal<CategoryPickerNode[]>;
+    readonly invalid: _angular_core.InputSignal<boolean>;
+    readonly errors: _angular_core.InputSignal<readonly WithOptionalFieldTree<ValidationError>[]>;
+    /** Emitted when the modal closes, whether or not a value was picked — mirrors ul-select's touch. */
+    readonly touch: _angular_core.OutputEmitterRef<void>;
+    readonly value: _angular_core.ModelSignal<string | null>;
+    protected readonly ids: {
+        controlId: string;
+        helperId: string;
+        errorId: string;
+    };
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly currentParentId: _angular_core.WritableSignal<string | null>;
+    protected readonly query: _angular_core.WritableSignal<string>;
+    protected readonly hasError: _angular_core.Signal<boolean>;
+    protected readonly describedBy: _angular_core.Signal<string | undefined>;
+    private readonly nodesById;
+    protected readonly selectedNode: _angular_core.Signal<CategoryPickerNode | null>;
+    protected readonly selectedLabel: _angular_core.Signal<string>;
+    protected readonly currentChildren: _angular_core.Signal<CategoryPickerNode[]>;
+    /** Root→current ancestor chain, for the breadcrumb trail (empty at the root level). */
+    protected readonly breadcrumb: _angular_core.Signal<CategoryPickerNode[]>;
+    private readonly normalizedQuery;
+    protected readonly isSearching: _angular_core.Signal<boolean>;
+    protected readonly searchResults: _angular_core.Signal<{
+        node: CategoryPickerNode;
+        breadcrumb: string;
+    }[]>;
+    protected readonly hasNoResults: _angular_core.Signal<boolean>;
+    openPicker(): void;
+    closePicker(): void;
+    selectNode(node: CategoryPickerNode): void;
+    goToBreadcrumb(parentId: string | null): void;
+    private ancestorNodes;
+    private ancestorLabels;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CategoryPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CategoryPickerComponent, "ul-category-picker", 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; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "modalTitle": { "alias": "modalTitle"; "required": false; "isSignal": true; }; "rootLabel": { "alias": "rootLabel"; "required": false; "isSignal": true; }; "noResultsText": { "alias": "noResultsText"; "required": false; "isSignal": true; }; "nodes": { "alias": "nodes"; "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; }; }, { "touch": "touch"; "value": "valueChange"; }, never, never, true, never>;
+}
+
 type CheckboxZoneType = 'none' | 'accessible' | 'visible' | 'checked-visible';
 /**
  * Checkbox component. Implements FormCheckboxControl for Signal Forms [formField].
@@ -2107,5 +2182,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, CheckboxComponent, CollapseComponent, CustomCurrencyPipe, DockComponent, DockItemComponent, DockItemContentSlotDirective, DropdownComponent, FileInputComponent, FooterComponent, FormFieldHelperComponent, FormFieldLabelComponent, HeroComponent, IconComponent, ImageCropperComponent, ImageNotFoundComponent, 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, StepperComponent, TableComponent, TextareaComponent, TextareaFieldDirective, ToastContainerComponent, ToastService, ToggleComponent, TooltipComponent, createFormFieldIds, getFormFieldDescribedBy, toastIcon };
-export type { ActionsDistribution, AvatarData, AvatarSize, BreadcrumbItem, BreadcrumbSeparator, CalendarDay, CalendarMode, CardCaptionSize, CardDirection, CheckboxZoneType, CollapseVariant, Currency, DockItemVariant, DropdownItem, FileInputAppearance, HeroAction, HeroAlignment, HeroSize, IconName, IconSize, IconWeight, ImageCropperShape, 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 };
+export { AccordionComponent, AccordionItemComponent, AreaCodeComponent, AvatarComponent, AvatarGroupComponent, BreadcrumbComponent, ButtonComponent, CalendarComponent, CardComponent, CategoryPickerComponent, CheckboxComponent, CollapseComponent, CustomCurrencyPipe, DockComponent, DockItemComponent, DockItemContentSlotDirective, DropdownComponent, FileInputComponent, FooterComponent, FormFieldHelperComponent, FormFieldLabelComponent, HeroComponent, IconComponent, ImageCropperComponent, ImageNotFoundComponent, 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, StepperComponent, TableComponent, TextareaComponent, TextareaFieldDirective, ToastContainerComponent, ToastService, ToggleComponent, TooltipComponent, createFormFieldIds, getFormFieldDescribedBy, toastIcon };
+export type { ActionsDistribution, AvatarData, AvatarSize, BreadcrumbItem, BreadcrumbSeparator, CalendarDay, CalendarMode, CardCaptionSize, CardDirection, CategoryPickerNode, CheckboxZoneType, CollapseVariant, Currency, DockItemVariant, DropdownItem, FileInputAppearance, HeroAction, HeroAlignment, HeroSize, IconName, IconSize, IconWeight, ImageCropperShape, 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 };