@ecodev/natural 63.2.0 → 63.3.0

package/lib/modules/avatar/component/avatar.component.d.ts

@@ -1,52 +1,37 @@
-import { OnChanges, SimpleChanges } from '@angular/core';
+import { Source } from '../sources/source';
 import * as i0 from "@angular/core";
-type Style = Partial<CSSStyleDeclaration>;
 /**
  * Show an avatar from different sources
  */
-export declare class NaturalAvatarComponent implements OnChanges {
+export declare class NaturalAvatarComponent {
     private readonly avatarService;
-    image?: string | null;
-    initials?: string | null;
-    gravatar?: string | null;
-    size: number;
-    decorated: boolean;
-    textSizeRatio: number;
-    bgColor: string | undefined;
-    fgColor: string;
-    borderRadius: string;
-    textMaximumLength: number;
-    avatarSrc: string | null;
-    avatarText: string | null;
-    avatarStyle: Style;
-    hostStyle: Style;
-    private currentIndex;
-    private sources;
+    readonly image: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly initials: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly gravatar: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly size: import("@angular/core").InputSignal<number>;
+    readonly decorated: import("@angular/core").InputSignal<boolean>;
+    readonly textSizeRatio: import("@angular/core").InputSignal<number>;
+    readonly bgColor: import("@angular/core").InputSignal<string | undefined>;
+    readonly fgColor: import("@angular/core").InputSignal<string>;
+    readonly borderRadius: import("@angular/core").InputSignal<string>;
+    readonly textMaximumLength: import("@angular/core").InputSignal<number>;
+    private readonly sources;
+    protected readonly currentSource: import("@angular/core").Signal<Source | undefined>;
+    protected readonly imageAvatar: import("@angular/core").Signal<Promise<string> | undefined>;
+    protected readonly textAvatar: import("@angular/core").Signal<Promise<string> | undefined>;
     /**
-     * Detect inputs change
-     */
-    ngOnChanges(changes: SimpleChanges): void;
-    /**
-     * Fetch avatar source
+     * Try to use the next available avatar source that has not already failed in the past
      */
     tryNextSource(): void;
-    private findNextSource;
-    /**
-     * Initialize the avatar component and its fallback system
-     */
-    private initializeAvatar;
-    private clearAvatar;
-    private buildTextAvatar;
-    private buildImageAvatar;
+    private findNextNonFailingIndex;
     /**
      * Returns initials style
      */
-    private getTextualStyle;
+    protected readonly textualStyle: import("@angular/core").Signal<Partial<CSSStyleDeclaration>>;
     /**
      * Returns image style
      */
-    private getImageStyle;
+    protected readonly imageStyle: import("@angular/core").Signal<Partial<CSSStyleDeclaration>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalAvatarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalAvatarComponent, "natural-avatar", never, { "image": { "alias": "image"; "required": false; }; "initials": { "alias": "initials"; "required": false; }; "gravatar": { "alias": "gravatar"; "required": false; }; "size": { "alias": "size"; "required": false; }; "decorated": { "alias": "decorated"; "required": false; }; "textSizeRatio": { "alias": "textSizeRatio"; "required": false; }; "bgColor": { "alias": "bgColor"; "required": false; }; "fgColor": { "alias": "fgColor"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "textMaximumLength": { "alias": "textMaximumLength"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalAvatarComponent, "natural-avatar", never, { "image": { "alias": "image"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "gravatar": { "alias": "gravatar"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "decorated": { "alias": "decorated"; "required": false; "isSignal": true; }; "textSizeRatio": { "alias": "textSizeRatio"; "required": false; "isSignal": true; }; "bgColor": { "alias": "bgColor"; "required": false; "isSignal": true; }; "fgColor": { "alias": "fgColor"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "textMaximumLength": { "alias": "textMaximumLength"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
-export {};

package/lib/modules/avatar/service/avatar.service.d.ts

@@ -1,6 +1,6 @@
 import { Source, SourceCreator } from '../sources/source';
-import { NaturalAvatarComponent } from '../component/avatar.component';
 import * as i0 from "@angular/core";
+type SourceType = 'gravatar' | 'image' | 'initials';
 /**
  * Provides utilities methods related to Avatar component
  */
@@ -13,7 +13,7 @@ export declare class AvatarService {
     private readonly avatarColors;
     private readonly failedSources;
     getRandomColor(avatarText: string): string;
-    getCreators(): IterableIterator<[keyof NaturalAvatarComponent, SourceCreator]>;
+    getCreators(): IterableIterator<[SourceType, SourceCreator]>;
     private getSourceKey;
     sourceHasFailedBefore(source: Source): boolean;
     markSourceAsFailed(source: Source): void;
@@ -21,3 +21,4 @@ export declare class AvatarService {
     static ɵfac: i0.ɵɵFactoryDeclaration<AvatarService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AvatarService>;
 }
+export {};

package/lib/modules/file/abstract-file.d.ts

@@ -34,7 +34,7 @@ export declare abstract class NaturalAbstractFile implements OnInit, OnDestroy,
      */
     multiple: boolean;
     /**
-     * Comma-separated list of unique file type specifiers. Like the native element
+     * Comma-separated list of unique file type specifiers. Like the native element,
      * it can be a mix of mime-type and file extensions.
      *
      * See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept
@@ -58,7 +58,7 @@ export declare abstract class NaturalAbstractFile implements OnInit, OnDestroy,
     /**
      * If true, the file selection will be broadcast through `NaturalFileService.filesChanged`.
      *
-     * It is useful to set this to false if there is two upload on a page with different purpose
+     * It is useful to set this to false if there are two uploads on a page with different purposes,
      * and the second upload should not be confused with the first one.
      */
     broadcast: boolean;

package/lib/modules/file/component/file.component.d.ts

@@ -12,6 +12,11 @@ export declare class NaturalFileComponent implements OnInit, OnChanges {
     readonly fontSize: import("@angular/core").Signal<number>;
     action: 'upload' | 'download' | null;
     backgroundSize: string;
+    /**
+     * Overrides the default download link by passing a function that received the
+     * file object and returns the download link
+     */
+    private downloadLinkFn?;
     /**
      * Comma-separated list of unique file type specifiers. Like the native element,
      * it can be a mix of mime-type and file extensions.
@@ -54,5 +59,5 @@ export declare class NaturalFileComponent implements OnInit, OnChanges {
     private updateImage;
     private getBase64;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalFileComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalFileComponent, "natural-file", never, { "height": { "alias": "height"; "required": false; "isSignal": true; }; "action": { "alias": "action"; "required": false; }; "backgroundSize": { "alias": "backgroundSize"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "uploader": { "alias": "uploader"; "required": false; }; "model": { "alias": "model"; "required": false; }; "formCtrl": { "alias": "formCtrl"; "required": false; }; }, { "modelChange": "modelChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalFileComponent, "natural-file", never, { "height": { "alias": "height"; "required": false; "isSignal": true; }; "action": { "alias": "action"; "required": false; }; "backgroundSize": { "alias": "backgroundSize"; "required": false; }; "downloadLinkFn": { "alias": "downloadLinkFn"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "uploader": { "alias": "uploader"; "required": false; }; "model": { "alias": "model"; "required": false; }; "formCtrl": { "alias": "formCtrl"; "required": false; }; }, { "modelChange": "modelChange"; }, never, never, true, never>;
 }

package/lib/modules/panels/panels.service.d.ts

@@ -59,14 +59,26 @@ export declare class NaturalPanelsService {
      */
     private isVertical;
     constructor();
+    /**
+     * Notify the service to start listening to route changes to open panels
+     *
+     * @internal
+     */
     start(route: ActivatedRoute): void;
     /**
      * Uses given configuration to add at the end of current url
      */
     private appendConfigToCurrentUrl;
+    /**
+     * Notify the service that all panels were closed
+     *
+     * @internal
+     */
     stop(): void;
     /**
      * Go to panel matching given component. Causes an url change.
+     *
+     * @internal
      */
     goToPanelByComponent(component: NaturalAbstractPanel): void;
     /**
@@ -96,6 +108,10 @@ export declare class NaturalPanelsService {
      * Return panel position (index) by searching matching component
      */
     private getPanelIndex;
+    /**
+     * Whether the given panel is currently the top, visible, panel. If there are no panels opened at all, then any panel given is considered top, visible, panel.
+     */
+    isTopPanel(component: NaturalAbstractPanel): boolean;
     /**
      * Repositions panels from start until given index
      */

package/lib/modules/table-button/table-button.component.d.ts

@@ -1,5 +1,4 @@
-import { OnChanges } from '@angular/core';
-import { Params, QueryParamsHandling, RouterLink } from '@angular/router';
+import { Params, QueryParamsHandling, UrlTree } from '@angular/router';
 import { ThemePalette } from '@angular/material/core';
 import { Subject } from 'rxjs';
 import * as i0 from "@angular/core";
@@ -13,22 +12,21 @@ import * as i0 from "@angular/core";
  *
  * External URL will always be opened in new tab.
  */
-export declare class NaturalTableButtonComponent implements OnChanges {
-    queryParams: Params;
-    queryParamsHandling: QueryParamsHandling;
-    label?: string | null;
-    icon?: string | null;
-    href?: string | null;
-    navigate: RouterLink['routerLink'];
-    fragment?: string | undefined;
-    preserveFragment: boolean;
-    disabled: boolean;
-    raised: boolean;
-    color: ThemePalette;
+export declare class NaturalTableButtonComponent {
+    readonly queryParams: import("@angular/core").InputSignal<Params>;
+    readonly queryParamsHandling: import("@angular/core").InputSignal<QueryParamsHandling>;
+    readonly label: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly icon: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly href: import("@angular/core").InputSignal<string | null | undefined>;
+    readonly navigate: import("@angular/core").InputSignal<string | any[] | UrlTree | null | undefined>;
+    readonly fragment: import("@angular/core").InputSignal<string | undefined>;
+    readonly preserveFragment: import("@angular/core").InputSignal<boolean>;
+    readonly disabled: import("@angular/core").InputSignal<boolean>;
+    readonly raised: import("@angular/core").InputSignal<boolean>;
+    readonly color: import("@angular/core").InputSignal<ThemePalette>;
     protected readonly buttonClick$: Subject<MouseEvent>;
     readonly buttonClick: import("@angular/core").OutputRef<MouseEvent>;
-    type: 'routerLink' | 'href' | 'click' | 'none';
-    ngOnChanges(): void;
+    protected readonly type: import("@angular/core").Signal<"click" | "routerLink" | "none" | "href">;
     static ɵfac: i0.ɵɵFactoryDeclaration<NaturalTableButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalTableButtonComponent, "natural-table-button", never, { "queryParams": { "alias": "queryParams"; "required": false; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; }; "label": { "alias": "label"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "href": { "alias": "href"; "required": false; }; "navigate": { "alias": "navigate"; "required": false; }; "fragment": { "alias": "fragment"; "required": false; }; "preserveFragment": { "alias": "preserveFragment"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "raised": { "alias": "raised"; "required": false; }; "color": { "alias": "color"; "required": false; }; }, { "buttonClick": "buttonClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NaturalTableButtonComponent, "natural-table-button", never, { "queryParams": { "alias": "queryParams"; "required": false; "isSignal": true; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "navigate": { "alias": "navigate"; "required": false; "isSignal": true; }; "fragment": { "alias": "fragment"; "required": false; "isSignal": true; }; "preserveFragment": { "alias": "preserveFragment"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "raised": { "alias": "raised"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; }, { "buttonClick": "buttonClick"; }, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecodev/natural",
-  "version": "63.2.0",
+  "version": "63.3.0",
   "license": "MIT",
   "repository": "github:Ecodev/natural",
   "sideEffects": false,