@evotor-dev/ui-kit 6.17.1 → 6.17.2

package/lib/components/evo-navigation-tabs/evo-navigation-tab.directive.d.ts

@@ -0,0 +1,19 @@
+import { ElementRef, OnDestroy } from '@angular/core';
+import { RouterLinkActive } from '@angular/router';
+import { RouterLinkActiveService } from '../../services/router-link-active.service';
+import { MutationObserverService } from '../../services/mutation-observer.service';
+import * as i0 from "@angular/core";
+export declare const EVO_TAB_ACTIVATE = "evo-tab-activate";
+export declare class EvoNavigationTabDirective implements OnDestroy {
+    private readonly el;
+    private readonly routerLinkActiveService;
+    private readonly rla;
+    private readonly mutation;
+    tabClass: boolean;
+    private readonly destroy$;
+    constructor(el: ElementRef, routerLinkActiveService: RouterLinkActiveService, rla: RouterLinkActive, mutation: MutationObserverService);
+    ngOnDestroy(): void;
+    private initSubscriptions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EvoNavigationTabDirective, [null, null, { optional: true; }, { optional: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EvoNavigationTabDirective, "button[evoNavigationTab]:not([routerLink]), button[evoNavigationTab][routerLink][routerLinkActive]", never, {}, {}, never>;
+}

package/lib/components/evo-navigation-tabs/evo-navigation-tabs.component.d.ts

@@ -0,0 +1,32 @@
+import { AfterViewChecked, AfterViewInit, ElementRef, EventEmitter, OnDestroy } from '@angular/core';
+import { EvoNavigationTabsSize } from './types/evo-navigation-tabs-size';
+import * as i0 from "@angular/core";
+export declare class EvoNavigationTabsComponent implements AfterViewInit, AfterViewChecked, OnDestroy {
+    private readonly el;
+    tabs: {
+        label: string;
+        link?: string;
+        disabled?: boolean;
+    }[];
+    size: EvoNavigationTabsSize;
+    set setActiveIndex(index: number);
+    set setDisabled(disabled: boolean);
+    activeItemIndexChange: EventEmitter<number>;
+    disabled: boolean;
+    private activeIndex;
+    private readonly disabledSubject$;
+    private readonly nextRenderSubject$;
+    private readonly destroy$;
+    constructor(el: ElementRef);
+    ngAfterViewInit(): void;
+    ngAfterViewChecked(): void;
+    ngOnDestroy(): void;
+    onActivate(event: Event, element: HTMLButtonElement): void;
+    private get tabsList();
+    private get activeElement();
+    private markTabAsActive;
+    private markTabAsDisabled;
+    private initSubscriptions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EvoNavigationTabsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EvoNavigationTabsComponent, "evo-navigation-tabs", never, { "tabs": "tabs"; "size": "size"; "setActiveIndex": "activeIndex"; "setDisabled": "disabled"; }, { "activeItemIndexChange": "activeItemIndexChange"; }, never, ["[position=start]", "*"]>;
+}

package/lib/components/evo-navigation-tabs/evo-navigation-tabs.module.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./evo-navigation-tabs.component";
+import * as i2 from "./evo-navigation-tab.directive";
+import * as i3 from "@angular/common";
+import * as i4 from "@angular/router";
+export declare class EvoNavigationTabsModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<EvoNavigationTabsModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<EvoNavigationTabsModule, [typeof i1.EvoNavigationTabsComponent, typeof i2.EvoNavigationTabDirective], [typeof i3.CommonModule, typeof i4.RouterModule], [typeof i1.EvoNavigationTabsComponent, typeof i2.EvoNavigationTabDirective]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<EvoNavigationTabsModule>;
+}

package/lib/components/evo-navigation-tabs/index.d.ts

@@ -0,0 +1 @@
+export * from './public-api';

package/lib/components/evo-navigation-tabs/public-api.d.ts

@@ -0,0 +1,4 @@
+export * from './evo-navigation-tabs.module';
+export * from './evo-navigation-tabs.component';
+export * from './evo-navigation-tab.directive';
+export * from "./types/evo-navigation-tabs-size";

package/lib/components/evo-navigation-tabs/types/evo-navigation-tabs-size.d.ts

@@ -0,0 +1 @@
+export declare type EvoNavigationTabsSize = 'small' | 'normal';

package/lib/services/mutation-observer.service.d.ts

@@ -0,0 +1,34 @@
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Безопасная обёртка над `MutationObserver`, которая гарантирует,
+ * что код не упадёт в средах, где `MutationObserver` недоступен
+ * (например, серверный рендеринг или тесты без DOM).
+ *
+ * Если `MutationObserver` существует — используется он.
+ * Если нет — используется заглушка с пустыми методами.
+ */
+export declare const SafeObserver: {
+    new (callback: MutationCallback): MutationObserver;
+    prototype: MutationObserver;
+};
+/**
+ * Сервис `MutationObserverService` предоставляет поток `Observable<MutationRecord[]>`,
+ * который эмитит записи изменений DOM для текущего элемента (`ElementRef`).
+ *
+ * Наблюдает за изменениями потомков, текстового содержимого и вложенных структур (`subtree: true`).
+ *
+ * Используется `SafeObserver`, чтобы гарантировать совместимость с SSR и тестовой средой.
+ *
+ * ⚠️ Важно: требует, чтобы `ElementRef` был доступен через DI-контекст (т.е. работает в компонентах/директивах).
+ *
+ * @example
+ * this.mutationObserverService.subscribe(records => {
+ *   console.log('Mutation detected!', records);
+ * });
+ */
+export declare class MutationObserverService extends Observable<readonly MutationRecord[]> {
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MutationObserverService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MutationObserverService>;
+}

package/lib/services/router-link-active.service.d.ts

@@ -0,0 +1,16 @@
+import { NgZone } from '@angular/core';
+import { RouterLinkActive } from '@angular/router';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Сервис создает поток, отслеживающий состояние активности
+ * `RouterLinkActive` в реальном времени с использованием `requestAnimationFrame`.
+ *
+ * Наследуется от `Observable<boolean>` и эмитит `true` или `false`, когда состояние `isActive`
+ * меняется. Если `RouterLinkActive` не передан — поток будет пустым (`EMPTY`).
+ */
+export declare class RouterLinkActiveService extends Observable<boolean> {
+    constructor(routerLinkActive: RouterLinkActive | null, ngZone: NgZone, animationFrame$: Observable<number>);
+    static ɵfac: i0.ɵɵFactoryDeclaration<RouterLinkActiveService, [{ optional: true; }, null, null]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RouterLinkActiveService>;
+}

package/lib/utils/observables/zone-free.d.ts

@@ -0,0 +1,54 @@
+import { NgZone } from '@angular/core';
+import { MonoTypeOperatorFunction } from 'rxjs';
+/**
+ * Кратко:
+ * 🔥 evoZonefull — тащит всё в Angular-зону.
+ * 🧊 evoZonefree — игнорирует Angular-зону, экономит CD.
+ * ⚖️ evoZoneOptimized — как утро с кофе: просыпаешься вовремя и не дергаешь лишний раз change detection.
+ */
+/**
+ * Оператор `evoZonefull` обеспечивает полное выполнение потока внутри зоны Angular.
+ *
+ * Все `next`, `error` и `complete` вызовы оборачиваются в `NgZone.run`, чтобы гарантировать
+ * корректный запуск change detection.
+ *
+ * Используй, если поток формируется вне зоны или ты не уверен, что Angular узнает об изменениях.
+ *
+ * @param zone Сервис `NgZone` из Angular DI.
+ * @returns Оператор, оборачивающий поток в `NgZone.run()`.
+ *
+ * @example
+ * source$.pipe(evoZonefull(this.ngZone)).subscribe(...);
+ */
+export declare function evoZonefull<T>(zone: NgZone): MonoTypeOperatorFunction<T>;
+/**
+ * Оператор `evoZonefree` исполняет весь поток вне зоны Angular.
+ *
+ * Это помогает избежать лишних срабатываний change detection и повысить производительность,
+ * особенно для часто испускаемых потоков (например, `scroll`, `animationFrame`, таймеры).
+ *
+ * Используй, если тебе не нужно обновлять Angular view внутри этого потока.
+ *
+ * @param zone Сервис `NgZone` из Angular DI.
+ * @returns Оператор, исполняющий подписку вне Angular-зоны.
+ *
+ * @example
+ * source$.pipe(evoZonefree(this.ngZone)).subscribe(...);
+ */
+export declare function evoZonefree<T>(zone: NgZone): MonoTypeOperatorFunction<T>;
+/**
+ * Оператор `evoZoneOptimized` — комбо из `evoZonefree` и `evoZonefull`.
+ *
+ * Сначала поток исполняется вне Angular-зоны (`runOutsideAngular`), чтобы избежать лишнего
+ * change detection. Но события `next`, `error` и `complete` всё равно возвращаются в Angular-зону.
+ *
+ * Это идеальный баланс, если тебе нужен быстрый поток без лишнего CD, но ты всё равно хочешь,
+ * чтобы Angular знал о результатах.
+ *
+ * @param zone Сервис `NgZone` из Angular DI.
+ * @returns Оператор, оптимизированный по производительности.
+ *
+ * @example
+ * source$.pipe(evoZoneOptimized(this.ngZone)).subscribe(...);
+ */
+export declare function evoZoneOptimized<T>(zone: NgZone): MonoTypeOperatorFunction<T>;

package/lib/utils/tokens/animation-frame.d.ts

@@ -0,0 +1,10 @@
+import { InjectionToken } from '@angular/core';
+import { Observable } from 'rxjs';
+/**
+ * Токен `ANIMATION_FRAME` предоставляет поток значений времени из `requestAnimationFrame`,
+ * испускаемый каждый кадр анимации.
+ *
+ * Может быть полезен для задач, которые требуют частого обновления, например, отслеживания
+ * активности или плавной анимации в UI.
+ */
+export declare const ANIMATION_FRAME: InjectionToken<Observable<number>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evotor-dev/ui-kit",
-  "version": "6.17.1",
+  "version": "6.17.2",
   "homepage": "https://evotor.github.io/Evo-UI-Kit",
   "repository": {
     "type": "git",

package/public_api.d.ts

@@ -52,6 +52,7 @@ export * from './lib/components/evo-dropdown/index';
 export * from './lib/components/evo-navbar/index';
 export * from './lib/components/evo-navigation-button/index';
 export * from './lib/components/evo-tooltip/index';
+export * from './lib/components/evo-navigation-tabs/index';
 export * from './lib/pipes/index';
 export * from './lib/services/index';
 export * from './lib/components/evo-portal/index';