@underlayerdev/ui 0.13.3 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@underlayerdev/ui",
-  "version": "0.13.3",
+  "version": "0.14.0",
   "peerDependencies": {
     "@angular/cdk": "^22.0.0",
     "@angular/common": "^22.0.0",
@@ -22,6 +22,10 @@
       "types": "./types/underlayerdev-ui.d.ts",
       "default": "./fesm2022/underlayerdev-ui.mjs"
     },
+    "./carousel": {
+      "types": "./types/underlayerdev-ui-carousel.d.ts",
+      "default": "./fesm2022/underlayerdev-ui-carousel.mjs"
+    },
     "./design-tokens/*": "./design-tokens/*",
     "./breakpoints/*": "./breakpoints/*",
     "./containers/*": "./containers/*"

package/types/underlayerdev-ui-carousel.d.ts

@@ -0,0 +1,30 @@
+import * as i0 from '@angular/core';
+import { AfterViewInit, OnDestroy } from '@angular/core';
+import Splide, { Options } from '@splidejs/splide';
+
+declare class CarouselItemComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<CarouselItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CarouselItemComponent, "ul-carousel-item", never, {}, {}, never, ["*"], true, never>;
+}
+declare class CarouselComponent implements AfterViewInit, OnDestroy {
+    options: i0.InputSignal<Options>;
+    autoMount: i0.InputSignal<boolean>;
+    mounted: i0.OutputEmitterRef<Splide>;
+    private carousel;
+    private items;
+    private instance;
+    constructor();
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getInstance(): Splide | null;
+    goNext(): void;
+    goPrev(): void;
+    goTo(index: number): void;
+    mount(): void;
+    private init;
+    private updateCarouselOnItemsChange;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CarouselComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CarouselComponent, "ul-carousel", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "autoMount": { "alias": "autoMount"; "required": false; "isSignal": true; }; }, { "mounted": "mounted"; }, ["items"], ["*"], true, never>;
+}
+
+export { CarouselComponent, CarouselItemComponent };

package/types/underlayerdev-ui.d.ts

@@ -1,9 +1,8 @@
 import * as _angular_core from '@angular/core';
-import { AfterViewInit, OnDestroy, ElementRef, TemplateRef, PipeTransform } from '@angular/core';
+import { AfterViewInit, ElementRef, TemplateRef, PipeTransform } from '@angular/core';
 import * as i1 from '@angular/cdk/accordion';
 import { CdkAccordionItem } from '@angular/cdk/accordion';
 import { FormValueControl, WithOptionalFieldTree, ValidationError, FormCheckboxControl } from '@angular/forms/signals';
-import Splide, { Options } from '@splidejs/splide';
 import { ImageTransform, Dimensions } from 'ngx-image-cropper';
 import { CurrencyPipe } from '@angular/common';
 import * as _underlayerdev_ui from '@underlayerdev/ui';
@@ -347,29 +346,79 @@ 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>;
 }
 
-declare class CarouselItemComponent {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CarouselItemComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CarouselItemComponent, "ul-carousel-item", never, {}, {}, never, ["*"], true, never>;
-}
-declare class CarouselComponent implements AfterViewInit, OnDestroy {
-    options: _angular_core.InputSignal<Options>;
-    autoMount: _angular_core.InputSignal<boolean>;
-    mounted: _angular_core.OutputEmitterRef<Splide>;
-    private carousel;
-    private items;
-    private instance;
-    constructor();
-    ngAfterViewInit(): void;
-    ngOnDestroy(): void;
-    getInstance(): Splide | null;
-    goNext(): void;
-    goPrev(): void;
-    goTo(index: number): void;
-    mount(): void;
-    private init;
-    private updateCarouselOnItemsChange;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CarouselComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CarouselComponent, "ul-carousel", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "autoMount": { "alias": "autoMount"; "required": false; "isSignal": true; }; }, { "mounted": "mounted"; }, ["items"], ["*"], 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';
@@ -2133,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, CarouselComponent, CarouselItemComponent, 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 };