@educarehq/solaris-components 0.2.6 → 0.2.8

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@educarehq/solaris-components",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "peerDependencies": {
     "@angular/core": "^21.1.0",
     "intl-tel-input": "^26.0.9",
     "@angular/common": "^21.1.0",
     "libphonenumber-js": "^1.12.36",
     "@educarehq/solaris-tokens": "^0.1.2",
-    "@educarehq/solaris-services": "^0.1.6"
+    "@educarehq/solaris-services": "^0.1.7"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/educarehq-solaris-components.d.ts

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
-import { ElementRef, TemplateRef, AfterContentInit, OnDestroy, EventEmitter, QueryList, OnChanges, SimpleChanges, OnInit, AfterViewInit, WritableSignal, InjectionToken } from '@angular/core';
-import { ControlValueAccessor, Validator, ValidationErrors, AbstractControl, NgControl } from '@angular/forms';
-import * as _educarehq_solaris_components from '@educarehq/solaris-components';
+import { ElementRef, TemplateRef, AfterContentInit, OnDestroy, EventEmitter, QueryList, OnChanges, SimpleChanges, InjectionToken, EnvironmentProviders, OnInit, AfterViewInit, WritableSignal } from '@angular/core';
 import { SolarisTranslationParams } from '@educarehq/solaris-services';
+import * as _educarehq_solaris_components from '@educarehq/solaris-components';
+import { ControlValueAccessor, Validator, ValidationErrors, AbstractControl, NgControl } from '@angular/forms';
 
 declare class SolarisDropdownContentTriggerDirective {
     readonly elementRef: ElementRef<HTMLElement>;
@@ -260,6 +260,210 @@ declare class SolarisLoadingOverlay implements OnChanges {
     static ngAcceptInputType_lockScroll: any;
 }
 
+declare class SolarisNotificationIntlService {
+    private readonly translationService;
+    private readonly notificationConfig;
+    private readonly translationConfig;
+    private readonly activeLang;
+    private readonly prefix;
+    translate(key: string, params?: SolarisTranslationParams): string;
+    close(): string;
+    expand(): string;
+    collapse(): string;
+    stopTimer(): string;
+    resumeTimer(): string;
+    paused(): string;
+    centerTitle(): string;
+    emptyCenter(): string;
+    clearHistory(): string;
+    autoClose(seconds: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SolarisNotificationIntlService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SolarisNotificationIntlService>;
+}
+
+type SolarisSizePreset = 'sm' | 'md' | 'lg';
+type SolarisRadiusPreset = 'none' | 'sm' | 'md' | 'lg' | 'full';
+type SolarisColorPreset = 'primary' | 'surface' | 'success' | 'warning' | 'error' | 'info' | 'gradient';
+
+type SolarisButtonVariant = 'solid' | 'outline' | 'ghost' | 'soft';
+type SolarisRadiusInput = SolarisRadiusPreset | SolarisCustomString;
+type SolarisButtonColorInput = SolarisColorPreset | SolarisCustomString;
+type SolarisCustomString = string & {
+    readonly __solarisCustom?: unique symbol;
+};
+
+type SolarisNotificationState = 'queued' | 'visible' | 'archived';
+type SolarisNotificationKind = 'success' | 'warning' | 'error' | 'info';
+type SolarisNotificationConfigInput = Partial<SolarisNotificationConfig>;
+type SolarisNotificationPosition = 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center';
+interface SolarisNotificationActionContext {
+    id: string;
+    data: Record<string, unknown> | null;
+    dismiss: () => void;
+    remove: () => void;
+    update: (patch: Partial<SolarisNotificationInput>) => void;
+}
+interface SolarisNotificationAction {
+    id: string;
+    label?: string;
+    labelKey?: string;
+    labelParams?: SolarisTranslationParams;
+    variant?: SolarisButtonVariant;
+    color?: SolarisButtonColorInput;
+    size?: SolarisSizePreset;
+    radius?: SolarisRadiusInput;
+    closeOnClick?: boolean;
+    disabled?: boolean;
+    run?: (ctx: SolarisNotificationActionContext) => void | Promise<void>;
+}
+interface SolarisNotificationInput {
+    title?: string;
+    titleKey?: string;
+    titleParams?: SolarisTranslationParams;
+    description?: string | null;
+    descriptionKey?: string;
+    descriptionParams?: SolarisTranslationParams;
+    kind?: SolarisNotificationKind;
+    position?: SolarisNotificationPosition;
+    duration?: number | null;
+    expandable?: boolean;
+    expanded?: boolean;
+    closeable?: boolean;
+    pauseOnHover?: boolean;
+    actions?: SolarisNotificationAction[];
+    ariaLive?: 'polite' | 'assertive';
+    data?: Record<string, unknown> | null;
+}
+interface SolarisNotificationRecord {
+    id: string;
+    title: string;
+    description: string | null;
+    kind: SolarisNotificationKind;
+    position: SolarisNotificationPosition;
+    state: SolarisNotificationState;
+    duration: number | null;
+    remainingMs: number | null;
+    expandable: boolean;
+    expanded: boolean;
+    closeable: boolean;
+    pauseOnHover: boolean;
+    pausedByHover: boolean;
+    pausedByUser: boolean;
+    pausedByVisibility: boolean;
+    actions: SolarisNotificationAction[];
+    ariaLive: 'polite' | 'assertive';
+    data: Record<string, unknown> | null;
+    createdAt: number;
+}
+interface SolarisNotificationConfig {
+    defaultPosition: SolarisNotificationPosition;
+    defaultDuration: number;
+    maxVisiblePerPosition: number;
+    hoverPause: boolean;
+    newestOnTop: boolean;
+    expandSingle: boolean;
+    persistInCenter: boolean;
+    translationScope: string;
+}
+interface SolarisNotificationRef {
+    id: string;
+    dismiss: () => void;
+    remove: () => void;
+    pause: () => void;
+    resume: () => void;
+    toggleExpanded: () => void;
+    update: (patch: Partial<SolarisNotificationInput>) => void;
+}
+
+declare class SolarisNotificationService {
+    private readonly platformId;
+    private readonly destroyRef;
+    readonly config: SolarisNotificationConfig;
+    private readonly translationService;
+    readonly centerOpen: i0.WritableSignal<boolean>;
+    private readonly _items;
+    readonly items: i0.Signal<SolarisNotificationRecord[]>;
+    readonly visibleItems: i0.Signal<SolarisNotificationRecord[]>;
+    readonly centerItems: i0.Signal<SolarisNotificationRecord[]>;
+    private lastTick;
+    private readonly intervalId;
+    constructor();
+    success(input: Omit<SolarisNotificationInput, 'kind'>): SolarisNotificationRef;
+    warning(input: Omit<SolarisNotificationInput, 'kind'>): SolarisNotificationRef;
+    error(input: Omit<SolarisNotificationInput, 'kind'>): SolarisNotificationRef;
+    info(input: Omit<SolarisNotificationInput, 'kind'>): SolarisNotificationRef;
+    show(input: SolarisNotificationInput): SolarisNotificationRef;
+    visibleByPosition(position: SolarisNotificationPosition): SolarisNotificationRecord[];
+    isPaused(item: SolarisNotificationRecord): boolean;
+    dismiss(id: string): void;
+    remove(id: string): void;
+    clearHistory(): void;
+    pause(id: string): void;
+    resume(id: string): void;
+    toggleUserPause(id: string): void;
+    setHoverPaused(id: string, paused: boolean): void;
+    toggleExpanded(id: string): void;
+    update(id: string, patch: Partial<SolarisNotificationInput>): void;
+    openCenter(): void;
+    closeCenter(): void;
+    toggleCenter(): void;
+    private tick;
+    private rebalance;
+    private createRecord;
+    private resolveAriaLive;
+    private createRef;
+    private createId;
+    private find;
+    private patch;
+    private resolveRequiredText;
+    private resolveOptionalText;
+    private hasOwn;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SolarisNotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SolarisNotificationService>;
+}
+
+declare class SolarisNotificationCenterComponent {
+    protected readonly notificationService: SolarisNotificationService;
+    protected readonly intl: SolarisNotificationIntlService;
+    onEscape(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SolarisNotificationCenterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SolarisNotificationCenterComponent, "solaris-notification-center", never, {}, {}, never, never, true, never>;
+}
+
+declare class SolarisNotificationItemComponent {
+    protected readonly notificationService: SolarisNotificationService;
+    protected readonly intl: SolarisNotificationIntlService;
+    readonly item: i0.InputSignal<SolarisNotificationRecord>;
+    readonly mode: i0.InputSignal<"center" | "toast">;
+    readonly paused: i0.Signal<boolean>;
+    readonly secondsLeft: i0.Signal<number>;
+    readonly progress: i0.Signal<number>;
+    readonly iconClass: i0.Signal<"ph-check-circle" | "ph-warning-circle" | "ph-x-circle" | "ph-info">;
+    toggleExpanded(): void;
+    toggleUserPause(): void;
+    close(): void;
+    onMouseEnter(): void;
+    onMouseLeave(): void;
+    runAction(action: SolarisNotificationAction): Promise<void>;
+    protected resolveActionLabel(action: SolarisNotificationAction): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SolarisNotificationItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SolarisNotificationItemComponent, "solaris-notification-item", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class SolarisNotificationHostComponent {
+    protected readonly notificationService: SolarisNotificationService;
+    protected readonly positions: readonly SolarisNotificationPosition[];
+    readonly withCenter: i0.InputSignal<boolean>;
+    visibleByPosition(position: SolarisNotificationPosition): _educarehq_solaris_components.SolarisNotificationRecord[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SolarisNotificationHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SolarisNotificationHostComponent, "solaris-notification-host", never, { "withCenter": { "alias": "withCenter"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare const SOLARIS_NOTIFICATION_POSITIONS: readonly SolarisNotificationPosition[];
+declare const SOLARIS_NOTIFICATION_DEFAULT_CONFIG: SolarisNotificationConfig;
+declare const SOLARIS_NOTIFICATION_CONFIG: InjectionToken<SolarisNotificationConfig>;
+declare function provideSolarisNotifications(input?: SolarisNotificationConfigInput): EnvironmentProviders;
+
 type SolarisLoadingTrail = 'forward' | 'reverse';
 type SolarisLoadingSpeed = 'slow' | 'md' | 'fast';
 type SolarisLoadingDashDensity = 'low' | 'md' | 'high';
@@ -298,10 +502,6 @@ type Spoke = {
     opacity: number;
 };
 
-type SolarisSizePreset = 'sm' | 'md' | 'lg';
-type SolarisRadiusPreset = 'none' | 'sm' | 'md' | 'lg' | 'full';
-type SolarisColorPreset = 'primary' | 'surface' | 'success' | 'warning' | 'error' | 'info' | 'gradient';
-
 type BadgeVariant = 'solid' | 'subtle' | 'outline';
 type BadgeColorInput = SolarisColorPreset | string & {
     readonly __solarisCustom?: unique symbol;
@@ -806,13 +1006,6 @@ declare class SolarisCheckbox implements ControlValueAccessor {
     static ɵcmp: i0.ɵɵComponentDeclaration<SolarisCheckbox, "solaris-checkbox", never, { "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "inputId": { "alias": "id"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "checkColor": { "alias": "checkColor"; "required": false; "isSignal": true; }; }, { "checkedChange": "checkedChange"; "indeterminateChange": "indeterminateChange"; }, never, ["*"], true, never>;
 }
 
-type SolarisButtonVariant = 'solid' | 'outline' | 'ghost' | 'soft';
-type SolarisRadiusInput = SolarisRadiusPreset | SolarisCustomString;
-type SolarisButtonColorInput = SolarisColorPreset | SolarisCustomString;
-type SolarisCustomString = string & {
-    readonly __solarisCustom?: unique symbol;
-};
-
 declare class ButtonGroupDirective {
     private _radius;
     set radius(v: SolarisRadiusInput | null | undefined);
@@ -1084,6 +1277,7 @@ declare class FormField {
     appearance: SolarisFormFieldAppearance;
     showErrors: SolarisFormFieldShowErrors;
     private readonly _tick;
+    readonly customErrorKey: i0.InputSignal<string>;
     constructor();
     get hasPrefix(): boolean;
     get hasSuffix(): boolean;
@@ -1096,7 +1290,7 @@ declare class FormField {
     } | undefined>;
     readonly errorKey: i0.Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormField, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FormField, "solaris-form-field", never, { "hint": { "alias": "hint"; "required": false; }; "label": { "alias": "label"; "required": false; }; "hintKey": { "alias": "hintKey"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "radius": { "alias": "radius"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "showErrors": { "alias": "showErrors"; "required": false; }; }, {}, ["prefix", "suffix"], ["[solaris-prefix]", "*", "[solaris-suffix]", "[form-field-message]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormField, "solaris-form-field", never, { "hint": { "alias": "hint"; "required": false; }; "label": { "alias": "label"; "required": false; }; "hintKey": { "alias": "hintKey"; "required": false; }; "labelKey": { "alias": "labelKey"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "radius": { "alias": "radius"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; "showErrors": { "alias": "showErrors"; "required": false; }; "customErrorKey": { "alias": "customErrorKey"; "required": false; "isSignal": true; }; }, {}, ["prefix", "suffix"], ["[solaris-prefix]", "*", "[solaris-suffix]", "[form-field-message]"], true, never>;
 }
 
 type SolarisSelectNode<T = any> = SolarisSelectItem<T> | SolarisSelectDivider | SolarisSelectGroup<T>;
@@ -1277,5 +1471,5 @@ declare class SolarisSelect implements OnInit, ControlValueAccessor, AfterViewIn
     static ɵcmp: i0.ɵɵComponentDeclaration<SolarisSelect, "solaris-select", never, { "items": { "alias": "items"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "valueKey": { "alias": "valueKey"; "required": false; }; "backKey": { "alias": "backKey"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "placeholderKey": { "alias": "placeholderKey"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "selectedCountKey": { "alias": "selectedCountKey"; "required": false; }; "selectedFirst": { "alias": "selectedFirst"; "required": false; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; }; "selectedCountText": { "alias": "selectedCountText"; "required": false; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; }; "searchPlaceholderKey": { "alias": "searchPlaceholderKey"; "required": false; }; "selectionSeparator": { "alias": "selectionSeparator"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "backText": { "alias": "backText"; "required": false; }; "selectionDisplay": { "alias": "selectionDisplay"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { ButtonDirective, ButtonGroupDirective, FieldErrorComponent, FormField, InputTextDirective, PasswordToggle, SOLARIS_FORM_FIELD_CONTROLLER, SOLARIS_FORM_FIELD_FEATURES, SOLARIS_INPUT, SolarisBadge, SolarisBodyDirective, SolarisBreadcrumb, SolarisCheckbox, SolarisColumnCellDef, SolarisColumnHeaderDef, SolarisControlBridgeDirective, SolarisDivider, SolarisDrawer, SolarisDrawerFooterDirective, SolarisDrawerHeaderDirective, SolarisDropdownContent, SolarisDropdownContentPanelDirective, SolarisDropdownContentRegistry, SolarisDropdownContentTriggerDirective, SolarisEmailDirective, SolarisFilterBar, SolarisFilterChip, SolarisFilterField, SolarisFilterPanel, SolarisFilterPanelFooterDirective, SolarisFooterDirective, SolarisFormFieldController, SolarisHeaderDirective, SolarisIdGenerator, SolarisImageSliderComponent, SolarisLoading, SolarisLoadingOverlay, SolarisPage, SolarisPageHeader, SolarisPageHeaderBreadcrumbDirective, SolarisPageHeaderDescriptionDirective, SolarisPageHeaderTitle, SolarisPageHeaderTitleDirective, SolarisPasswordDirective, SolarisPhoneInput, SolarisPopover, SolarisPopoverPanelDirective, SolarisPopoverTriggerDirective, SolarisPrefixDirective, SolarisRowComponent, SolarisSectionComponent, SolarisSelect, SolarisSuffixDirective, SolarisTab, SolarisTable, SolarisTableColumn, SolarisTableFilters, SolarisTableSkeleton, SolarisTabs, computePopoverPosition, uniqueId };
-export type { BadgeColorInput, BadgeVariant, CheckboxAppearance, CheckboxColorInput, CheckboxVariant, DividerLabelAlign, DividerOrientation, DividerSpacing, DividerStrength, DividerVariant, Iso2, LoadingType, PhoneFormat, SelectionDisplay, SolarisAlign, SolarisBreadcrumbItem, SolarisBreadcrumbTarget, SolarisButtonColorInput, SolarisButtonVariant, SolarisCheckCustomString, SolarisColorPreset, SolarisCustomString, SolarisDrawerSide, SolarisDropdownContentInterface, SolarisDropdownWidthMode, SolarisFilterPanelRadius, SolarisFormFieldAppearance, SolarisFormFieldControllerLike, SolarisFormFieldFeature, SolarisFormFieldRadius, SolarisFormFieldShowErrors, SolarisInputApi, SolarisLoadingColor, SolarisLoadingDashDensity, SolarisLoadingEasing, SolarisLoadingPresetColor, SolarisLoadingSize, SolarisLoadingSpeed, SolarisLoadingTrail, SolarisPageChange, SolarisPopoverPlacement, SolarisPopoverPositionConfiguration, SolarisPopoverPositionResult, SolarisRadiusInput, SolarisRadiusPreset, SolarisRowKey, SolarisSelectDivider, SolarisSelectGroup, SolarisSelectItem, SolarisSelectNode, SolarisSelectRow, SolarisSizePreset, SolarisSliderItem, SolarisSliderOverlayContext, SolarisSort, SolarisSortDirection, SolarisTableI18n, SolarisTableVariant, StackLevel, TabsSize, TabsVariant };
+export { ButtonDirective, ButtonGroupDirective, FieldErrorComponent, FormField, InputTextDirective, PasswordToggle, SOLARIS_FORM_FIELD_CONTROLLER, SOLARIS_FORM_FIELD_FEATURES, SOLARIS_INPUT, SOLARIS_NOTIFICATION_CONFIG, SOLARIS_NOTIFICATION_DEFAULT_CONFIG, SOLARIS_NOTIFICATION_POSITIONS, SolarisBadge, SolarisBodyDirective, SolarisBreadcrumb, SolarisCheckbox, SolarisColumnCellDef, SolarisColumnHeaderDef, SolarisControlBridgeDirective, SolarisDivider, SolarisDrawer, SolarisDrawerFooterDirective, SolarisDrawerHeaderDirective, SolarisDropdownContent, SolarisDropdownContentPanelDirective, SolarisDropdownContentRegistry, SolarisDropdownContentTriggerDirective, SolarisEmailDirective, SolarisFilterBar, SolarisFilterChip, SolarisFilterField, SolarisFilterPanel, SolarisFilterPanelFooterDirective, SolarisFooterDirective, SolarisFormFieldController, SolarisHeaderDirective, SolarisIdGenerator, SolarisImageSliderComponent, SolarisLoading, SolarisLoadingOverlay, SolarisNotificationCenterComponent, SolarisNotificationHostComponent, SolarisNotificationIntlService, SolarisNotificationItemComponent, SolarisNotificationService, SolarisPage, SolarisPageHeader, SolarisPageHeaderBreadcrumbDirective, SolarisPageHeaderDescriptionDirective, SolarisPageHeaderTitle, SolarisPageHeaderTitleDirective, SolarisPasswordDirective, SolarisPhoneInput, SolarisPopover, SolarisPopoverPanelDirective, SolarisPopoverTriggerDirective, SolarisPrefixDirective, SolarisRowComponent, SolarisSectionComponent, SolarisSelect, SolarisSuffixDirective, SolarisTab, SolarisTable, SolarisTableColumn, SolarisTableFilters, SolarisTableSkeleton, SolarisTabs, computePopoverPosition, provideSolarisNotifications, uniqueId };
+export type { BadgeColorInput, BadgeVariant, CheckboxAppearance, CheckboxColorInput, CheckboxVariant, DividerLabelAlign, DividerOrientation, DividerSpacing, DividerStrength, DividerVariant, Iso2, LoadingType, PhoneFormat, SelectionDisplay, SolarisAlign, SolarisBreadcrumbItem, SolarisBreadcrumbTarget, SolarisButtonColorInput, SolarisButtonVariant, SolarisCheckCustomString, SolarisColorPreset, SolarisCustomString, SolarisDrawerSide, SolarisDropdownContentInterface, SolarisDropdownWidthMode, SolarisFilterPanelRadius, SolarisFormFieldAppearance, SolarisFormFieldControllerLike, SolarisFormFieldFeature, SolarisFormFieldRadius, SolarisFormFieldShowErrors, SolarisInputApi, SolarisLoadingColor, SolarisLoadingDashDensity, SolarisLoadingEasing, SolarisLoadingPresetColor, SolarisLoadingSize, SolarisLoadingSpeed, SolarisLoadingTrail, SolarisNotificationAction, SolarisNotificationActionContext, SolarisNotificationConfig, SolarisNotificationConfigInput, SolarisNotificationInput, SolarisNotificationKind, SolarisNotificationPosition, SolarisNotificationRecord, SolarisNotificationRef, SolarisNotificationState, SolarisPageChange, SolarisPopoverPlacement, SolarisPopoverPositionConfiguration, SolarisPopoverPositionResult, SolarisRadiusInput, SolarisRadiusPreset, SolarisRowKey, SolarisSelectDivider, SolarisSelectGroup, SolarisSelectItem, SolarisSelectNode, SolarisSelectRow, SolarisSizePreset, SolarisSliderItem, SolarisSliderOverlayContext, SolarisSort, SolarisSortDirection, SolarisTableI18n, SolarisTableVariant, StackLevel, TabsSize, TabsVariant };