@rt-tools/ui-kit 0.0.12 → 0.0.14

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@rt-tools/ui-kit",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "license": "Apache-2.0",
   "author": "Yauheni Krumin",
   "type": "module",
   "dependencies": {
     "tslib": "^2.8.0",
-    "@rt-tools/core": "^0.0.2",
+    "@rt-tools/core": "^0.0.3",
     "@rt-tools/store": "^0.0.4",
     "@rt-tools/utils": "^0.0.5"
   },
   "peerDependencies": {
-    "@rt-tools/core": "^0.0.2",
+    "@rt-tools/core": "^0.0.3",
     "@rt-tools/store": "^0.0.4",
     "@rt-tools/utils": "^0.0.5",
     "@angular/animations": "^21.0.0",

package/types/rt-tools-ui-kit.d.ts

@@ -1,16 +1,16 @@
 import * as i0 from '@angular/core';
-import { OnChanges, ElementRef, Renderer2, PipeTransform, Provider, InjectionToken, Type, OnInit, Signal, TemplateRef, WritableSignal, InputSignal, InputSignalWithTransform, OutputEmitterRef, ModelSignal, AfterViewInit, AfterViewChecked, AfterContentChecked, OnDestroy } from '@angular/core';
-import { Nullable, PageModel, SortModel, FilterOperatorType, FilterModel, FILTER_OPERATOR_TYPE_ENUM, POSITION_ENUM, OSTypes } from '@rt-tools/utils';
-import { Observable, Subject } from 'rxjs';
+import { Type, OnInit, Signal, TemplateRef, WritableSignal, InputSignal, InputSignalWithTransform, OutputEmitterRef, InjectionToken, ModelSignal, AfterViewInit, ElementRef, AfterViewChecked, Provider, AfterContentChecked, OnDestroy } from '@angular/core';
 import { FormControl, ControlValueAccessor, Validator, FormGroup, ValidationErrors } from '@angular/forms';
 import { ThemePalette } from '@angular/material/core';
-import { Nullable as Nullable$1 } from '@rt-tools/core';
+import { Observable, Subject } from 'rxjs';
+import { Nullable } from '@rt-tools/core';
 import { MatDialogConfig } from '@angular/material/dialog';
 import { MatDrawer } from '@angular/material/sidenav';
 import { OverlayRef, ComponentType, ConnectedPosition, CdkOverlayOrigin } from '@angular/cdk/overlay';
 import { ComponentType as ComponentType$1 } from '@angular/cdk/portal';
 import { HttpErrorResponse } from '@angular/common/http';
 import { MatFormFieldAppearance } from '@angular/material/form-field';
+import { PageModel, SortModel, FilterOperatorType, FilterModel, FILTER_OPERATOR_TYPE_ENUM, POSITION_ENUM, OSTypes } from '@rt-tools/utils';
 import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
 import { TooltipPosition } from '@angular/material/tooltip';
 import { AnimationPlayer, AnimationTriggerMetadata } from '@angular/animations';
@@ -19,332 +19,6 @@ import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { MatInput } from '@angular/material/input';
 import { ImageCroppedEvent } from 'ngx-image-cropper';
 
-type IModsObject = Record<string, unknown>;
-interface IBemConfig {
-    separators: {
-        el: string;
-        mod: string;
-        val: string;
-    };
-    ignoreValues?: boolean;
-    modCase?: string;
-}
-
-declare class BlockDirective implements OnChanges {
-    #private;
-    readonly element: ElementRef;
-    readonly renderer: Renderer2;
-    readonly name: string;
-    private readonly elem;
-    rtMod?: string | string[] | (string | false)[] | IModsObject;
-    constructor(element: ElementRef, renderer: Renderer2, name: string, elem: string);
-    ngOnChanges(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BlockDirective, [null, null, { attribute: "rtBlock"; }, { attribute: "rtElem"; optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<BlockDirective, "[rtBlock]", never, { "rtMod": { "alias": "rtMod"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-declare class ConcatClassesPipe implements PipeTransform {
-    transform<C extends string | boolean | null | undefined>(classes: (C | C[])[]): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ConcatClassesPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<ConcatClassesPipe, "concatClasses", true>;
-}
-
-declare class ElemDirective implements OnChanges {
-    #private;
-    readonly element: ElementRef;
-    readonly renderer: Renderer2;
-    readonly name: string;
-    private readonly rtBlock;
-    rtMod?: string | string[] | (string | false)[] | IModsObject;
-    blockName: string;
-    constructor(element: ElementRef, renderer: Renderer2, name: string, rtBlock: BlockDirective);
-    ngOnChanges(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ElemDirective, [null, null, { attribute: "rtElem"; }, null]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ElemDirective, "[rtElem]", never, { "rtMod": { "alias": "rtMod"; "required": false; }; }, {}, never, never, true, never>;
-}
-
-declare class ModDirective {
-    static ɵfac: i0.ɵɵFactoryDeclaration<ModDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ModDirective, "[rtMod]", never, {}, {}, never, never, true, never>;
-}
-
-declare enum STORAGE_TYPES_ENUM {
-    LOCAL = "local",
-    SESSION = "session",
-    IN_MEMORY = "inMemory",
-    CUSTOM = "custom"
-}
-type StorageType = STORAGE_TYPES_ENUM.LOCAL | STORAGE_TYPES_ENUM.SESSION | STORAGE_TYPES_ENUM.IN_MEMORY | STORAGE_TYPES_ENUM.CUSTOM;
-
-/**
- * A service that implements the `Storage` interface using an in-memory map.
- * This service provides a fallback storage solution when `localStorage`
- * or `sessionStorage` is not available, such as in server-side rendering (SSR) scenarios.
- *
- * @Injectable
- */
-declare class InMemoryStorageService implements Storage {
-    #private;
-    /**
-     * Returns the number of key-value pairs currently stored.
-     *
-     * @returns the number of items in storage
-     * @public
-     */
-    get length(): number;
-    /**
-     * Retrieves the value associated with the given key.
-     *
-     * @param key - The name of the key to retrieve the value for
-     * @returns the value associated with the key, or `null` if the key does not exist
-     * @public
-     * @returns string | null
-     */
-    getItem(key: string): string | null;
-    /**
-     * Adds or updates the key-value pair in the storage.
-     *
-     * @param key - The name of the key to create or update
-     * @param data - The value to associate with the key
-     * @public
-     * @returns void
-     */
-    setItem(key: string, data: string): void;
-    /**
-     * Retrieves the key at the specified index.
-     *
-     * @param index - The index of the key to retrieve
-     * @returns the key at the specified index, or `null` if the index is out of bounds
-     * @public
-     * @returns string | null
-     */
-    key(index: number): string | null;
-    /**
-     * Removes the key-value pair associated with the given key.
-     *
-     * @param key - The name of the key to remove
-     * @public
-     * @returns void
-     */
-    removeItem(key: string): void;
-    /**
-     * Clears all key-value pairs from the storage.
-     *
-     * @public
-     * @returns void
-     */
-    clear(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InMemoryStorageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<InMemoryStorageService>;
-}
-
-interface IStorageConverter {
-    convertTo(data: any): string;
-    convertFrom<T>(data: any): Nullable<T>;
-}
-
-interface IStorageConfig {
-    ctx: Nullable<StorageType>;
-    storageRef: Nullable<Storage>;
-    converter: Nullable<IStorageConverter>;
-}
-
-declare class JsonConverter implements IStorageConverter {
-    convertTo(data: Nullable<any>): string;
-    convertFrom<T>(data: any): Nullable<T>;
-}
-
-/**
- * Returns the set of dependency-injection providers
- * required to setup storages in an application.
- *
- * @usageNotes
- *
- * This function sets up the essential storage services needed for
- * working with `localStorage`, `sessionStorage`, and an in-memory storage solution.
- * It includes providers for each type of storage, ensuring that the appropriate
- * storage service is injected based on the platform or specific use case.
- *
- * The function is particularly useful in scenarios where the application may be
- * running on the server-side (SSR). In such cases, instead of using `localStorage`
- * and `sessionStorage`, which are only available in the browser, the `InMemoryStorageService`
- * can be used as a fallback, ensuring that the application still functions correctly.
- *
- * ```typescript
- * bootstrapApplication(RootComponent, {
- *   providers: [
- *     provideRtStorage()
- *   ]
- * });
- * ```
- *
- * @publicApi
- */
-declare function provideRtStorage(): Provider[];
-
-/**
- * Factory for creating or returning `localStorage`.
- * Returns `localStorage` global object if the application is running in a browser,
- * otherwise returns null.
- *
- * @returns localStorage or null
- */
-declare function localStorageFactory(): Nullable<Storage>;
-/**
- * Factory for creating or returning `sessionStorage`.
- * Returns `sessionStorage` global object if the application is running in a browser,
- * otherwise returns null.
- *
- * @returns sessionStorage or null
- */
-declare function sessionStorageFactory(): Nullable<Storage>;
-/**
- * Factory for creating `InMemoryStorageService`.
- * Returns a new instance of InMemoryStorageService.
- *
- * @returns a new instance of InMemoryStorageService
- */
-declare function inMemoryStorageFactory(): Storage;
-
-/**
- * A service for managing data storage across different storage types,
- * including `localStorage`, `sessionStorage`, and an in-memory storage fallback.
- * The service supports custom storage types and data conversion through configurable converters.
- *
- * @Injectable
- */
-declare class StorageService {
-    #private;
-    /**
-     * Retrieves an item from the specified storage context.
-     *
-     * @param key - The key of the item to retrieve.
-     * @param config - Optional configuration for the storage context and data conversion.
-     * @returns The retrieved item, converted from storage if a converter is provided, or `null` if the item does not exist.
-     */
-    getItem<T>(key: string, config?: Partial<IStorageConfig>): Nullable<T>;
-    /**
-     * Stores an item in the specified storage context.
-     *
-     * @param key - The key to associate with the stored item.
-     * @param data - The data to store, which will be converted if a converter is provided.
-     * @param config - Optional configuration for the storage context and data conversion.
-     */
-    setItem(key: string, data: any, config?: Partial<IStorageConfig>): void;
-    /**
-     * Checks if a given key exists in the specified storage context.
-     *
-     * @param key - The key to check for.
-     * @param ctx - The storage context to search in (local, session, or in-memory).
-     * @returns `true` if the key exists, `false` otherwise.
-     */
-    hasKey(key: string, ctx?: Nullable<StorageType>): boolean;
-    /**
-     * Executes callback functions based on whether a key exists in the specified storage context.
-     *
-     * @param key - The key to check for.
-     * @param onHas - The callback to execute if the key exists.
-     * @param onHasNot - The optional callback to execute if the key does not exist.
-     * @param config - Optional configuration for the storage context and data conversion.
-     */
-    onHasKey<T>(key: string, onHas: (value: Nullable<T>) => void, onHasNot?: () => void, config?: Partial<IStorageConfig>): void;
-    /**
-     * Removes an item from the specified storage context.
-     *
-     * @param key - The key of the item to remove.
-     * @param ctx - The storage context from which to remove the item.
-     */
-    removeItem(key: string, ctx?: Nullable<StorageType>): void;
-    /**
-     * Clears all items from the specified storage context.
-     *
-     * @param ctx - The storage context to clear.
-     */
-    clear(ctx?: Nullable<StorageType>): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<StorageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<StorageService>;
-}
-
-declare const CUSTOM_STORAGE: InjectionToken<Storage>;
-
-declare const IN_MEMORY_STORAGE: InjectionToken<Storage>;
-
-declare const LOCAL_STORAGE: InjectionToken<Storage>;
-
-declare const SESSION_STORAGE: InjectionToken<Storage>;
-
-/**
- * Abstract StorageService class for interacting with a storage system.
- * Uses Observable to handle asynchronous operations.
- */
-interface IIDBStorageServiceInterface<T> {
-    /**
-     * Retrieves a value from storage by the given key.
-     * @param key - The key to retrieve the value.
-     * @returns An Observable that emits the value of type T or undefined if the key does not exist.
-     */
-    get(key: string): Observable<T | undefined>;
-    /**
-     * Saves a value in storage under the specified key.
-     * @param key - The key to store the value under.
-     * @param value - The value to be stored.
-     * @returns An Observable that completes once the value is successfully saved.
-     */
-    set(key: string, value: T): Observable<void>;
-    /**
-     * Removes a value from storage by the specified key.
-     * @param key - The key to remove the value from.
-     * @returns An Observable that completes once the value is successfully removed.
-     */
-    remove(key: string): Observable<void>;
-}
-
-declare class IDBStorageService<ENTITY_TYPE> implements IIDBStorageServiceInterface<ENTITY_TYPE> {
-    #private;
-    constructor();
-    get(key: string): Observable<ENTITY_TYPE | undefined>;
-    set(key: string, value: ENTITY_TYPE): Observable<void>;
-    remove(key: string): Observable<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IDBStorageService<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IDBStorageService<any>>;
-}
-
-/**
- * Factory for creating `IDBStorageService`.
- * Returns a new instance of IDBStorageService.
- *
- * @returns a new instance of IDBStorageService
- */
-declare function iDBStorageFactory(): IDBStorageService<Record<string, unknown>>;
-
-/**
- * Returns the set of dependency-injection providers
- * required to set up storages in an application.
- *
- * @usageNotes
- *
- * This function sets up the essential storage services needed for
- * working with `idb storage` solution.
- * It includes providers for each type of storage, ensuring that the appropriate
- * storage service is injected based on the platform or specific use case.
- *
- * ```typescript
- * bootstrapApplication(RootComponent, {
- *   providers: [
- *     provideRtIDBStorage()
- *   ]
- * });
- * ```
- *
- * @publicApi
- */
-declare function provideRtIDBStorage(): Provider[];
-
-/**
- * Injection token for IDBStorageService.
- */
-declare const IDB_STORAGE_SERVICE_TOKEN: InjectionToken<IDBStorageService<any>>;
-
 declare enum MODAL_WINDOW_SIZE_ENUM {
     SM = "25rem",
     MD = "45rem",
@@ -371,7 +45,7 @@ declare namespace IModal {
     interface Button<T> {
         text: string;
         color?: ThemePalette;
-        value: Nullable$1<T>;
+        value: Nullable<T>;
         appearance?: 'standard' | 'raised' | 'flat' | 'stroked' | 'fab' | 'mini-fab';
         validateSelect?: boolean;
         assignSelectedValue?: boolean;
@@ -404,11 +78,11 @@ declare namespace IModal {
         value: T;
         message: string;
     }
-    type ConfirmResponsePredicate<T> = (answer: Nullable$1<IModal.DataAnswer<T>>) => boolean;
+    type ConfirmResponsePredicate<T> = (answer: Nullable<IModal.DataAnswer<T>>) => boolean;
     interface ConfirmResponse<T> {
-        on(predicate: ConfirmResponsePredicate<T>): Observable<Nullable$1<IModal.DataAnswer<T>>>;
-        onCancel(cancel?: ConfirmResponsePredicate<T>): Observable<Nullable$1<IModal.DataAnswer<T>>>;
-        onConfirm(confirm?: ConfirmResponsePredicate<T>): Observable<Nullable$1<IModal.DataAnswer<T>>>;
+        on(predicate: ConfirmResponsePredicate<T>): Observable<Nullable<IModal.DataAnswer<T>>>;
+        onCancel(cancel?: ConfirmResponsePredicate<T>): Observable<Nullable<IModal.DataAnswer<T>>>;
+        onConfirm(confirm?: ConfirmResponsePredicate<T>): Observable<Nullable<IModal.DataAnswer<T>>>;
     }
 }
 
@@ -1898,5 +1572,5 @@ declare class RtActionBarService {
     static ɵprov: i0.ɵɵInjectableDeclaration<RtActionBarService>;
 }
 
-export { ASIDE_BUTTONS_ENUM, ASIDE_REF, AsideRef, BUTTON_APPEARANCE, BUTTON_COLOR, BUTTON_SIZE, BlockDirective, CUSTOM_STORAGE, ConcatClassesPipe, DEFAULT_PAGE_MODEL, DEFAULT_PAGE_SIZE, ElemDirective, IAside, IDBStorageService, IDB_STORAGE_SERVICE_TOKEN, IModal, INFO_BADGE_SIZE_ENUM, INFO_BADGE_TYPE_ENUM, IN_MEMORY_STORAGE, IRtActionBar, IRtSnackBar, ISideMenu, ITable, InMemoryStorageService, JsonConverter, LOCAL_STORAGE, MODAL_WINDOW_SIZE_ENUM, ModDirective, RTUI_TABLE_COMPONENT_TOKEN, RTUI_TABLE_STOP_ROW_CLICK_ATTRIBUTE, RtActionBarService, RtAsideService, RtDynamicListSelectorsDirective, RtModalService, RtPopoverDirective, RtSnackBarService, RtTableConfigService, RtTableSelectorsDirective, RtuiActionBarComponent, RtuiActionBarContainerComponent, RtuiAsideContainerComponent, RtuiAsideContainerHeaderDirective, RtuiButtonComponent, RtuiClearButtonComponent, RtuiCustomTableCellsDirective, RtuiDynamicInputAdditionalControlDirective, RtuiDynamicInputComponent, RtuiDynamicListComponent, RtuiDynamicListCustomTableCellsDirective, RtuiDynamicListRowActionsDirective, RtuiDynamicListRowAdditionalActionsDirective, RtuiDynamicListToolbarActionsDirective, RtuiDynamicListToolbarSelectorsDirective, RtuiDynamicSelectorAdditionalControlDirective, RtuiDynamicSelectorComponent, RtuiDynamicSelectorItemAdditionalControlDirective, RtuiDynamicSelectorListActionsComponent, RtuiDynamicSelectorPlaceholderComponent, RtuiDynamicSelectorSelectedListComponent, RtuiFileUploadComponent, RtuiHeaderCenterDirective, RtuiHeaderComponent, RtuiHeaderLeftDirective, RtuiHeaderRightDirective, RtuiImageUploadComponent, RtuiInfoBadgeComponent, RtuiModalComponent, RtuiMultiButtonComponent, RtuiMultiSelectorPopupComponent, RtuiPaginationComponent, RtuiRoundIconButtonComponent, RtuiScrollableContainerComponent, RtuiScrollableContainerContentDirective, RtuiScrollableContainerFooterDirective, RtuiScrollableContainerHeaderDirective, RtuiSideMenuComponent, RtuiSideMenuFooterDirective, RtuiSideMenuHeaderDirective, RtuiSnackBarComponent, RtuiSpinnerComponent, RtuiStopTableRowClickDirective, RtuiTableAdditionalRowActionsDirective, RtuiTableComponent, RtuiTableRowActionsDirective, RtuiTableRowClickDirective, RtuiToggleComponent, RtuiToolbarCenterDirective, RtuiToolbarComponent, RtuiToolbarLeftDirective, RtuiToolbarRightDirective, SESSION_STORAGE, STORAGE_TYPES_ENUM, StorageService, TABLE_COLUMN_FILTER_TYPES_ENUM, TABLE_COLUMN_TYPES_ENUM, TEXT_CELL_COLOR_ENUM, TOGGLE_SIZE_TYPE_ENUM, darkenHexColor, ddServices, getColorBasedOnBackground, iDBStorageFactory, inMemoryStorageFactory, localStorageFactory, progressDecreaseAnimation, progressIncreaseAnimation, provideRtIDBStorage, provideRtStorage, provideRtUi, sessionStorageFactory };
-export type { AsideButtonsType, AsidePositions, ButtonAppearanceType, ButtonColorType, ButtonSizeType, IBemConfig, IIDBStorageServiceInterface, IImageUploadFormat, IInfoBadgeSizeType, IModsObject, IRtuiTable, IStorageConfig, IStorageConverter, Icon, IconSideType, InfoBadgeType, MenuItemTrigger, ModalWindowSizeType, NameValueType, Select, StorageType, ToggleSizeType };
+export { ASIDE_BUTTONS_ENUM, ASIDE_REF, AsideRef, BUTTON_APPEARANCE, BUTTON_COLOR, BUTTON_SIZE, DEFAULT_PAGE_MODEL, DEFAULT_PAGE_SIZE, IAside, IModal, INFO_BADGE_SIZE_ENUM, INFO_BADGE_TYPE_ENUM, IRtActionBar, IRtSnackBar, ISideMenu, ITable, MODAL_WINDOW_SIZE_ENUM, RTUI_TABLE_COMPONENT_TOKEN, RTUI_TABLE_STOP_ROW_CLICK_ATTRIBUTE, RtActionBarService, RtAsideService, RtDynamicListSelectorsDirective, RtModalService, RtPopoverDirective, RtSnackBarService, RtTableConfigService, RtTableSelectorsDirective, RtuiActionBarComponent, RtuiActionBarContainerComponent, RtuiAsideContainerComponent, RtuiAsideContainerHeaderDirective, RtuiButtonComponent, RtuiClearButtonComponent, RtuiCustomTableCellsDirective, RtuiDynamicInputAdditionalControlDirective, RtuiDynamicInputComponent, RtuiDynamicListComponent, RtuiDynamicListCustomTableCellsDirective, RtuiDynamicListRowActionsDirective, RtuiDynamicListRowAdditionalActionsDirective, RtuiDynamicListToolbarActionsDirective, RtuiDynamicListToolbarSelectorsDirective, RtuiDynamicSelectorAdditionalControlDirective, RtuiDynamicSelectorComponent, RtuiDynamicSelectorItemAdditionalControlDirective, RtuiDynamicSelectorListActionsComponent, RtuiDynamicSelectorPlaceholderComponent, RtuiDynamicSelectorSelectedListComponent, RtuiFileUploadComponent, RtuiHeaderCenterDirective, RtuiHeaderComponent, RtuiHeaderLeftDirective, RtuiHeaderRightDirective, RtuiImageUploadComponent, RtuiInfoBadgeComponent, RtuiModalComponent, RtuiMultiButtonComponent, RtuiMultiSelectorPopupComponent, RtuiPaginationComponent, RtuiRoundIconButtonComponent, RtuiScrollableContainerComponent, RtuiScrollableContainerContentDirective, RtuiScrollableContainerFooterDirective, RtuiScrollableContainerHeaderDirective, RtuiSideMenuComponent, RtuiSideMenuFooterDirective, RtuiSideMenuHeaderDirective, RtuiSnackBarComponent, RtuiSpinnerComponent, RtuiStopTableRowClickDirective, RtuiTableAdditionalRowActionsDirective, RtuiTableComponent, RtuiTableRowActionsDirective, RtuiTableRowClickDirective, RtuiToggleComponent, RtuiToolbarCenterDirective, RtuiToolbarComponent, RtuiToolbarLeftDirective, RtuiToolbarRightDirective, TABLE_COLUMN_FILTER_TYPES_ENUM, TABLE_COLUMN_TYPES_ENUM, TEXT_CELL_COLOR_ENUM, TOGGLE_SIZE_TYPE_ENUM, darkenHexColor, ddServices, getColorBasedOnBackground, progressDecreaseAnimation, progressIncreaseAnimation, provideRtUi };
+export type { AsideButtonsType, AsidePositions, ButtonAppearanceType, ButtonColorType, ButtonSizeType, IImageUploadFormat, IInfoBadgeSizeType, IRtuiTable, Icon, IconSideType, InfoBadgeType, MenuItemTrigger, ModalWindowSizeType, NameValueType, Select, ToggleSizeType };