@underlayerdev/ui 0.9.5 → 0.10.0

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@underlayerdev/ui",
-  "version": "0.9.5",
+  "version": "0.10.0",
   "peerDependencies": {
     "@angular/cdk": "^22.0.0",
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",
-    "@splidejs/splide": "^4.1.4"
+    "@splidejs/splide": "^4.1.4",
+    "ngx-image-cropper": "^9.1.7"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/underlayerdev-ui.d.ts

@@ -81,7 +81,14 @@ type UiSize = 'sm' | 'md' | 'lg' | 'xl';
 type UiCheckboxSize = 'default' | 'sm' | 'lg';
 type UiTheme = 'fill-purple' | 'fill-white' | 'fill-yellow' | 'fill-red' | 'transparent-purple' | 'transparent-white' | 'transparent-red' | 'transparent-black' | 'ghost-purple' | 'ghost-white' | 'ghost-red' | 'ghost-green' | 'outline-white' | 'outline-purple' | 'outline-red' | 'outline-green';
 
-type IconSize$1 = '5' | '6' | '7' | '8';
+type IconSize$1 = '5' | '6' | '7' | '8' | '16';
+/**
+ * Avatar-only size scale: the shared UiSize sizes, plus a larger '2xl' for
+ * contexts where the avatar itself is the focal point (e.g. an onboarding
+ * photo step) rather than one control among many. Deliberately not folded
+ * into UiSize — a giant size doesn't make sense on a button or input.
+ */
+type AvatarSize = UiSize | '2xl';
 /**
  * A reusable avatar component that displays user images, initials, or icons.
  * Supports multiple sizes and fallback options when an image is not available.
@@ -90,7 +97,7 @@ type IconSize$1 = '5' | '6' | '7' | '8';
  */
 declare class AvatarComponent {
     /** The size of the avatar */
-    size: _angular_core.InputSignal<UiSize>;
+    size: _angular_core.InputSignal<AvatarSize>;
     /** The image source URL */
     src: _angular_core.InputSignal<string | undefined>;
     /** Fallback initials to display when image is not available */
@@ -871,6 +878,98 @@ declare class ImageNotFoundDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ImageNotFoundDirective, "[peCatchImageNotFound]", never, { "showPlaceholder": { "alias": "showPlaceholder"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual shape of the crop mask/frame — purely cosmetic, doesn't affect the exported file. */
+type ImageCropperShape = 'rectangle' | 'round';
+/**
+ * Modal flow for cropping/resizing a photo. Wraps ngx-image-cropper so the
+ * third-party crop mechanics never leak outside the design system —
+ * consumers only ever see `ul-image-cropper`.
+ *
+ * Two interaction modes, chosen by whether `aspectRatio` is set:
+ * - **Locked** (`aspectRatio` given, e.g. `1` for an avatar): a fixed-size
+ *   frame; the user drags/zooms the photo underneath it. Best when every
+ *   output needs the same ratio (avatars, thumbnails).
+ * - **Free-form** (`aspectRatio` omitted, the default): a resizable frame
+ *   over a static photo; the user drags its corners to trim/straighten with
+ *   no ratio imposed. Best for listing photos, which keep their own shape
+ *   today (see `um-image-upload`'s auto-width carousel).
+ *
+ * Emits a resized `File`, ready to hand to any upload call that accepts
+ * one — this component only produces the file, it never uploads it.
+ *
+ * @example Locked 1:1 round (avatar)
+ * <ul-image-cropper
+ *   [(open)]="showCropper"
+ *   [imageFile]="selectedFile"
+ *   shape="round"
+ *   [aspectRatio]="1"
+ *   [maxOutputSize]="512"
+ *   (cropped)="onCropped($event)"
+ * />
+ *
+ * @example Free-form rectangle (listing photo)
+ * <ul-image-cropper
+ *   [(open)]="showCropper"
+ *   [imageFile]="selectedFile"
+ *   [maxOutputSize]="1920"
+ *   (cropped)="onCropped($event)"
+ * />
+ */
+declare class ImageCropperComponent {
+    /** Whether the crop modal is open. Supports two-way binding with [(open)]. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** The source photo to crop. Required for the modal to render its content. */
+    readonly imageFile: _angular_core.InputSignal<File | null>;
+    /** Visual shape of the crop mask. */
+    readonly shape: _angular_core.InputSignal<ImageCropperShape>;
+    /**
+     * Locks the crop frame to this width/height ratio and switches to
+     * pan-and-zoom mode. Omit (or pass null) for a free-form resizable frame
+     * with no ratio imposed.
+     */
+    readonly aspectRatio: _angular_core.InputSignal<number | null>;
+    /** Longest side (px) of the final output image; scales down without distorting. */
+    readonly maxOutputSize: _angular_core.InputSignal<number>;
+    /** Title shown in the modal header. */
+    readonly title: _angular_core.InputSignal<string>;
+    /** Label for the confirm button. */
+    readonly confirmLabel: _angular_core.InputSignal<string>;
+    /** Label for the cancel button. */
+    readonly cancelLabel: _angular_core.InputSignal<string>;
+    /** Label next to the zoom slider (locked-aspect mode only). */
+    readonly zoomLabel: _angular_core.InputSignal<string>;
+    /** Accessible label for the crop frame. */
+    readonly frameAriaLabel: _angular_core.InputSignal<string>;
+    /** Emitted with the cropped, resized photo once the user confirms. */
+    readonly cropped: _angular_core.OutputEmitterRef<File>;
+    /** Emitted when the user cancels or dismisses the modal without cropping. */
+    readonly cancelled: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the source photo fails to load in the cropper. */
+    readonly loadFailed: _angular_core.OutputEmitterRef<void>;
+    private readonly cropperRef;
+    protected readonly cropperImageFile: _angular_core.Signal<File | undefined>;
+    protected readonly isRound: _angular_core.Signal<boolean>;
+    protected readonly isLocked: _angular_core.Signal<boolean>;
+    /** ngx-image-cropper always wants a number here; unused while isLocked() is false. */
+    protected readonly effectiveAspectRatio: _angular_core.Signal<number>;
+    protected readonly frameWidth: _angular_core.Signal<number | undefined>;
+    protected readonly frameHeight: _angular_core.Signal<number | undefined>;
+    protected readonly minZoom = 1;
+    protected readonly maxZoom = 3;
+    protected readonly zoomStep = 0.01;
+    protected readonly zoom: _angular_core.WritableSignal<number>;
+    protected readonly transform: _angular_core.Signal<{
+        scale: number;
+    }>;
+    protected readonly cropperReady: _angular_core.WritableSignal<boolean>;
+    constructor();
+    protected onZoomInput(event: Event): void;
+    protected onConfirm(): Promise<void>;
+    protected onCancel(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ImageCropperComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ImageCropperComponent, "ul-image-cropper", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "imageFile": { "alias": "imageFile"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "maxOutputSize": { "alias": "maxOutputSize"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "zoomLabel": { "alias": "zoomLabel"; "required": false; "isSignal": true; }; "frameAriaLabel": { "alias": "frameAriaLabel"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "cropped": "cropped"; "cancelled": "cancelled"; "loadFailed": "loadFailed"; }, never, never, true, never>;
+}
+
 type InputType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'url';
 /** Border and hover style: border-only (hover = border only), subtle-tint (hover = border + 5% fill). */
 type InputAppearance = 'border-only' | 'subtle-tint';
@@ -1389,6 +1488,22 @@ declare class SkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonComponent, "ul-skeleton", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "lines": { "alias": "lines"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "show": { "alias": "show"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Presentational step indicator for a multi-step flow (e.g. onboarding,
+ * checkout) — dots connected by a line, current/completed/upcoming states.
+ * Purely visual: it has no notion of step content or navigation, the
+ * consumer owns that. `currentStep` is 1-indexed.
+ */
+declare class StepperComponent {
+    readonly totalSteps: _angular_core.InputSignal<number>;
+    readonly currentStep: _angular_core.InputSignal<number>;
+    readonly labels: _angular_core.InputSignal<string[]>;
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    protected readonly stepIndexes: _angular_core.Signal<number[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StepperComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StepperComponent, "ul-stepper", never, { "totalSteps": { "alias": "totalSteps"; "required": true; "isSignal": true; }; "currentStep": { "alias": "currentStep"; "required": true; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 type ToastKind = 'info' | 'success' | 'warning' | 'error';
 declare const toastIcon: (kind: ToastKind) => "info" | "alert" | "check_circle" | "cross_circle";
 interface ToastConfig {
@@ -1980,5 +2095,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, SearchInputComponent, SearchSelectComponent, SelectComponent, SelectableRowComponent, SidebarComponent, SkeletonComponent, StatusComponent, TableComponent, TextareaComponent, TextareaFieldDirective, ToastContainerComponent, ToastService, ToggleComponent, 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 };
+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, 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 };