@acorex/components 22.1.0-next.31 → 22.1.0-next.32

package/types/acorex-components-emojipicker.d.ts

@@ -0,0 +1,146 @@
+import * as _angular_core from '@angular/core';
+import { AXValueChangedEvent } from '@acorex/cdk/common';
+import { AXGestureEvent } from '@acorex/cdk/gesture';
+import { AXTabStripChangedEvent } from '@acorex/components/tabs';
+import { AXEmoji, AXEmojiCategory, AXEmojiPickerCategoryId, AXEmojiCategoryMeta } from '@acorex/core/constants';
+
+/**
+ * Telegram-style emoji picker with category tabs, search, and recent emojis.
+ *
+ * @category Components
+ */
+declare class AXEmojiPickerComponent {
+    private readonly hostRef;
+    private readonly destroyRef;
+    /** Emoji entries available in the picker. */
+    readonly items: _angular_core.InputSignal<readonly AXEmoji[]>;
+    /** Rendered emoji size in the grid. */
+    readonly size: _angular_core.InputSignal<number>;
+    /**
+     * Emoji rendering style passed to {@link AXEmojiComponent}.
+     * `google` uses Noto Color Emoji (Android/Google look) on Windows too.
+     *
+     * @defaultValue 'google'
+     */
+    readonly appearance: _angular_core.InputSignal<"google" | "native">;
+    /** Whether the search box is shown. */
+    readonly showSearch: _angular_core.InputSignal<boolean>;
+    /** Whether the recent category tab is shown. */
+    readonly showRecent: _angular_core.InputSignal<boolean>;
+    /** Number of emoji columns in the virtualized grid. */
+    readonly columns: _angular_core.InputSignal<number>;
+    /** Search box placeholder text. */
+    readonly searchPlaceholder: _angular_core.InputSignal<string>;
+    /** Unicode emoji group categories to hide from tabs and results. */
+    readonly excludeCategories: _angular_core.InputSignal<readonly AXEmojiCategory[]>;
+    /** `AXEmoji.code` values to hide (e.g. `1f595`). */
+    readonly excludeCodes: _angular_core.InputSignal<readonly string[]>;
+    /** `AXEmoji.unicode` glyph values to hide (e.g. `🖕`). */
+    readonly excludeUnicode: _angular_core.InputSignal<readonly string[]>;
+    /** Emits when the user selects an emoji. */
+    readonly selected: _angular_core.OutputEmitterRef<AXEmoji>;
+    /**
+     * Recently used emojis supplied by the parent (e.g. API, LocalStorage).
+     * Rendered in the Recent tab when {@link showRecent} is enabled.
+     */
+    readonly recentItems: _angular_core.InputSignal<readonly AXEmoji[]>;
+    /** Emits the updated recent list after the user selects an allowed emoji. */
+    readonly recentChanged: _angular_core.OutputEmitterRef<readonly AXEmoji[]>;
+    /** Current search query. */
+    protected readonly searchQuery: _angular_core.WritableSignal<string>;
+    /** Active category tab. */
+    protected readonly activeCategoryId: _angular_core.WritableSignal<AXEmojiPickerCategoryId>;
+    private readonly containerWidth;
+    protected readonly effectiveColumns: _angular_core.Signal<number>;
+    protected readonly availableWidthCss: _angular_core.Signal<string>;
+    constructor();
+    /** Items after picker exclusions are applied. */
+    protected readonly filteredItems: _angular_core.Signal<readonly AXEmoji[]>;
+    private readonly categoryIndex;
+    /** Recent items after active exclusions are applied for display. */
+    protected readonly visibleRecentItems: _angular_core.Signal<AXEmoji[]>;
+    protected onCategorySwipe(event: AXGestureEvent): void;
+    /** Visible category tabs. */
+    protected readonly categories: _angular_core.Signal<readonly AXEmojiCategoryMeta[]>;
+    /** Emojis shown in the current view (category or search results). */
+    protected readonly visibleEmojis: _angular_core.Signal<readonly AXEmoji[]>;
+    /** Rows used by the virtual scroll viewport. */
+    protected readonly emojiRows: _angular_core.Signal<readonly (readonly AXEmoji[])[]>;
+    /** Virtual scroll row height in pixels. */
+    protected readonly rowHeight: _angular_core.Signal<number>;
+    /** Whether the user is searching. */
+    protected readonly isSearching: _angular_core.Signal<boolean>;
+    /** Whether the current view has no emojis. */
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    /** Keeps the active tab valid when exclusions change. */
+    private readonly syncActiveCategory;
+    /** Selects a category tab and clears search. */
+    protected selectCategory(categoryId: AXEmojiPickerCategoryId): void;
+    /** Whether the given category tab is active. */
+    protected isCategoryActive(categoryId: AXEmojiPickerCategoryId): boolean;
+    /** Whether the category tab is the virtual recent group. */
+    protected isRecentCategory(categoryId: AXEmojiPickerCategoryId): boolean;
+    /** Syncs the active emoji category when a tab is selected. */
+    protected onCategoryTabChanged(event: AXTabStripChangedEvent): void;
+    /** Updates the search query from the search box. */
+    protected onSearchChanged(event: AXValueChangedEvent<string>): void;
+    /** Emits the selected emoji and notifies the parent of the updated recent list. */
+    protected selectEmoji(emoji: AXEmoji): void;
+    /** @ignore */
+    protected trackRow(index: number, row: readonly AXEmoji[]): string;
+    private rememberRecent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXEmojiPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXEmojiPickerComponent, "ax-emoji-picker", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showRecent": { "alias": "showRecent"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "excludeCategories": { "alias": "excludeCategories"; "required": false; "isSignal": true; }; "excludeCodes": { "alias": "excludeCodes"; "required": false; "isSignal": true; }; "excludeUnicode": { "alias": "excludeUnicode"; "required": false; "isSignal": true; }; "recentItems": { "alias": "recentItems"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "recentChanged": "recentChanged"; }, never, never, true, never>;
+}
+
+/** Maximum number of emojis kept in the recent list. */
+declare const RECENT_EMOJI_LIMIT = 20;
+/** Grid cell size in px (`--ax-comp-emoji-picker-cell-size`). */
+declare const EMOJI_PICKER_CELL_SIZE_PX = 36;
+/** Grid cell size in px on narrow viewports. */
+declare const EMOJI_PICKER_CELL_SIZE_PX_COMPACT = 32;
+/** Gap between grid cells in px (`--ax-comp-emoji-picker-cell-gap`). */
+declare const EMOJI_PICKER_CELL_GAP_PX = 2;
+/** Horizontal padding around the emoji grid in px. */
+declare const EMOJI_PICKER_GRID_PADDING_PX = 24;
+/** Minimum column count. */
+declare const EMOJI_PICKER_MIN_COLUMNS = 1;
+/** Nearest ancestor that participates in layout (skips `display: contents`). */
+declare function getEmojiPickerLayoutContainer(element: HTMLElement): HTMLElement;
+/**
+ * Available width for the picker grid.
+ * Uses the tightest ancestor content box and the visible viewport slot so an
+ * overflowing parent cannot keep an 8-column grid that is clipped off-screen.
+ */
+declare function resolveEmojiPickerContainerWidth(element: HTMLElement): number;
+/** Resolves column count from container width while keeping a fixed cell size and gap. */
+declare function resolveEmojiPickerColumns(containerWidth: number, requested: number): number;
+/** Maximum number of emojis returned by search. */
+declare const SEARCH_RESULT_LIMIT = 200;
+/** User-defined exclusions for picker emoji lists. */
+interface AXEmojiPickerFilter {
+    /** Unicode emoji group categories to hide from tabs and results. */
+    readonly excludeCategories?: readonly AXEmojiCategory[];
+    /** `AXEmoji.code` values to hide (hyphen-separated code points, e.g. `1f595`). */
+    readonly excludeCodes?: readonly string[];
+    /** `AXEmoji.unicode` glyph values to hide (e.g. `👋`). */
+    readonly excludeUnicode?: readonly string[];
+}
+/** Applies picker exclusions and default people-body curation. */
+declare function filterPickerItems(items: readonly AXEmoji[], filter?: AXEmojiPickerFilter): readonly AXEmoji[];
+/**
+ * Builds a category index for picker rendering.
+ * Expects items to be pre-filtered with {@link filterPickerItems}.
+ */
+declare function buildEmojiPickerIndex(items: readonly AXEmoji[]): ReadonlyMap<AXEmojiCategory, readonly AXEmoji[]>;
+/** Searches pre-filtered emoji metadata by name and keywords. */
+declare function searchPickerEmojis(items: readonly AXEmoji[], query: string, limit?: number): readonly AXEmoji[];
+
+declare class AXEmojiPickerModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXEmojiPickerModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXEmojiPickerModule, never, [typeof AXEmojiPickerComponent], [typeof AXEmojiPickerComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXEmojiPickerModule>;
+}
+
+export { AXEmojiPickerComponent, AXEmojiPickerModule, EMOJI_PICKER_CELL_GAP_PX, EMOJI_PICKER_CELL_SIZE_PX, EMOJI_PICKER_CELL_SIZE_PX_COMPACT, EMOJI_PICKER_GRID_PADDING_PX, EMOJI_PICKER_MIN_COLUMNS, RECENT_EMOJI_LIMIT, SEARCH_RESULT_LIMIT, buildEmojiPickerIndex, filterPickerItems, getEmojiPickerLayoutContainer, resolveEmojiPickerColumns, resolveEmojiPickerContainerWidth, searchPickerEmojis };
+export type { AXEmojiPickerFilter };

package/types/acorex-components-file-viewer.d.ts

@@ -1,8 +1,9 @@
 import * as _angular_core from '@angular/core';
 import { OnDestroy, TemplateRef, Type, Provider } from '@angular/core';
+import { AXMenuItem } from '@acorex/components/menu';
 import { AXComponentContent, AXComponentInputs } from '@acorex/core/components';
 import { Subject } from 'rxjs';
-import { AXStyleColorType, AXComponentClosedPromise } from '@acorex/cdk/common';
+import { AXStyleColorType, AXClickEvent, AXComponentClosedPromise } from '@acorex/cdk/common';
 import * as _acorex_core_file from '@acorex/core/file';
 import { AXFileTypeExtensionHint, AXFileType, AXFileTypeViewComponent } from '@acorex/core/file';
 import { SafeResourceUrl } from '@angular/platform-browser';
@@ -35,7 +36,7 @@ declare class AXFileViewerService {
     /** Resolve a potentially lazy URL — caches the result. */
     resolveUrl(item: AXFileViewerItem, key: 'url' | 'thumbnailUrl'): Promise<string | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXFileViewerService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 /** Infers a file-type catalog name from the item. */
@@ -43,6 +44,16 @@ declare function resolveFileViewerFileType(item: AXFileViewerItem): string;
 /** Builds an extension hint from item metadata. */
 declare function buildFileViewerExtensionHint(item: AXFileViewerItem): AXFileTypeExtensionHint | undefined;
 
+interface AXFileViewerHeaderActionClickEvent {
+    sender: AXFileViewerContainerComponent;
+    nativeEvent: Event;
+    canceled: boolean;
+    item: {
+        name?: string;
+        text: string;
+        data?: unknown;
+    };
+}
 declare class AXFileViewerContainerComponent implements OnDestroy {
     #private;
     readonly items: _angular_core.InputSignal<AXFileViewerItem[]>;
@@ -51,18 +62,27 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     readonly pagination: _angular_core.InputSignal<boolean>;
     readonly download: _angular_core.InputSignal<boolean>;
     readonly fullscreen: _angular_core.InputSignal<boolean>;
+    /** Header action buttons rendered in the top-right actions area. */
+    readonly headerActions: _angular_core.InputSignal<AXMenuItem[]>;
     /** When true, opens in a gallery overlay and closes when fullscreen exits. */
     readonly galleryMode: _angular_core.InputSignal<boolean>;
     readonly headerContent: _angular_core.InputSignal<AXComponentContent>;
     readonly headerContentInputs: _angular_core.InputSignal<AXComponentInputs>;
     readonly fallbackContent: _angular_core.InputSignal<AXComponentContent>;
     readonly fallbackContentInputs: _angular_core.InputSignal<AXComponentInputs>;
+    /** Custom empty-state template or component. Falls back to the built-in empty state. */
+    readonly emptyContent: _angular_core.InputSignal<AXComponentContent>;
+    readonly emptyContentInputs: _angular_core.InputSignal<AXComponentInputs>;
     /** External loading flag — show overlay while parent data is being fetched. */
     readonly loading: _angular_core.InputSignal<boolean>;
+    readonly headerActionClick: _angular_core.OutputEmitterRef<AXFileViewerHeaderActionClickEvent>;
     readonly fullscreenClosed: _angular_core.OutputEmitterRef<void>;
     readonly service: AXFileViewerService;
     private readonly host;
     private readonly fullScreenService;
+    private readonly document;
+    private readonly platformId;
+    private readonly destroyRef;
     private readonly mainCarouselRef;
     private readonly thumbCarouselRef;
     private initToken;
@@ -70,6 +90,7 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     /** True while carousels are being (re)initialized. */
     readonly initializing: _angular_core.WritableSignal<boolean>;
     readonly isBusy: _angular_core.Signal<boolean>;
+    readonly isEmpty: _angular_core.Signal<boolean>;
     readonly isFirstSlide: _angular_core.Signal<boolean>;
     readonly isLastSlide: _angular_core.Signal<boolean>;
     readonly currentItem: _angular_core.Signal<AXFileViewerItem>;
@@ -80,6 +101,9 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     readonly headerTemplateContent: _angular_core.Signal<TemplateRef<any>>;
     readonly headerComponentContent: _angular_core.Signal<Type<unknown>>;
     readonly hasHeaderCenterContent: _angular_core.Signal<boolean>;
+    readonly emptyTemplateContent: _angular_core.Signal<TemplateRef<any>>;
+    readonly emptyComponentContent: _angular_core.Signal<Type<unknown>>;
+    readonly resolvedHeaderActions: _angular_core.Signal<AXMenuItem[]>;
     readonly headerContentContext: _angular_core.Signal<{
         item: AXFileViewerItem;
         items: AXFileViewerItem[];
@@ -91,11 +115,16 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     formatSize(size?: number): string;
     private readonly mainCarouselOptions;
     private readonly thumbnailCarouselOptions;
+    constructor();
+    resolveHeaderAction(action: AXMenuItem): AXMenuItem;
+    onHeaderActionClick(action: AXMenuItem, event: AXClickEvent): void;
+    private isFullscreenAction;
     toggleFullscreen(): void;
     enterFullscreen(): void;
     /** @param emitGalleryClose When false, skips gallery close notification (used during service teardown). */
     exitFullscreen(emitGalleryClose?: boolean): void;
     closeGallery(): void;
+    private onFullscreenEscape;
     private initCarousels;
     private readonly onSlideChange;
     next(): void;
@@ -104,7 +133,7 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     downloadCurrent(): Promise<void>;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerContainerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerContainerComponent, "ax-file-viewer-container", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "startIndex": { "alias": "startIndex"; "required": false; "isSignal": true; }; "thumbnail": { "alias": "thumbnail"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "download": { "alias": "download"; "required": false; "isSignal": true; }; "fullscreen": { "alias": "fullscreen"; "required": false; "isSignal": true; }; "galleryMode": { "alias": "galleryMode"; "required": false; "isSignal": true; }; "headerContent": { "alias": "headerContent"; "required": false; "isSignal": true; }; "headerContentInputs": { "alias": "headerContentInputs"; "required": false; "isSignal": true; }; "fallbackContent": { "alias": "fallbackContent"; "required": false; "isSignal": true; }; "fallbackContentInputs": { "alias": "fallbackContentInputs"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "fullscreenClosed": "fullscreenClosed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerContainerComponent, "ax-file-viewer-container", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "startIndex": { "alias": "startIndex"; "required": false; "isSignal": true; }; "thumbnail": { "alias": "thumbnail"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "download": { "alias": "download"; "required": false; "isSignal": true; }; "fullscreen": { "alias": "fullscreen"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "galleryMode": { "alias": "galleryMode"; "required": false; "isSignal": true; }; "headerContent": { "alias": "headerContent"; "required": false; "isSignal": true; }; "headerContentInputs": { "alias": "headerContentInputs"; "required": false; "isSignal": true; }; "fallbackContent": { "alias": "fallbackContent"; "required": false; "isSignal": true; }; "fallbackContentInputs": { "alias": "fallbackContentInputs"; "required": false; "isSignal": true; }; "emptyContent": { "alias": "emptyContent"; "required": false; "isSignal": true; }; "emptyContentInputs": { "alias": "emptyContentInputs"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "headerActionClick": "headerActionClick"; "fullscreenClosed": "fullscreenClosed"; }, never, never, true, never>;
 }
 
 interface AXFileViewerGalleryConfig {
@@ -112,12 +141,15 @@ interface AXFileViewerGalleryConfig {
     startIndex?: number;
     thumbnail?: boolean;
     download?: boolean;
+    headerActions?: AXMenuItem[];
     loading?: boolean;
     panelClass?: string[];
     headerContent?: AXComponentContent | null;
     headerContentInputs?: AXComponentInputs | null;
     fallbackContent?: AXComponentContent | null;
     fallbackContentInputs?: AXComponentInputs | null;
+    emptyContent?: AXComponentContent | null;
+    emptyContentInputs?: AXComponentInputs | null;
 }
 interface AXFileViewerGalleryRef<TResult = any> {
     close: (data?: TResult) => void;
@@ -156,7 +188,7 @@ declare class AXFileViewerGalleryService {
     bringToFront(id: number): void;
     private openInternal;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerGalleryService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXFileViewerGalleryService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 /** Registers file-viewer components on standard file-type catalog entries. */
@@ -171,6 +203,11 @@ declare class AXFileViewerHeaderPlaceholderComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerHeaderPlaceholderComponent, "ax-file-viewer-header-placeholder", never, { "slideCounter": { "alias": "slideCounter"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class AXFileViewerEmptyStateComponent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerEmptyStateComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerEmptyStateComponent, "ax-file-viewer-empty-state", never, {}, {}, never, never, true, never>;
+}
+
 declare class AXFileViewerSlideComponent {
     readonly item: _angular_core.InputSignal<AXFileViewerItem>;
     readonly index: _angular_core.InputSignal<number>;
@@ -202,6 +239,7 @@ declare class AXFileViewerThumbPreviewComponent {
     private readonly service;
     readonly src: _angular_core.WritableSignal<string>;
     readonly icon: _angular_core.Signal<string>;
+    onImageError(): void;
     private resolvePreview;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerThumbPreviewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerThumbPreviewComponent, "ax-file-viewer-thumb-preview", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -226,6 +264,7 @@ declare class AXFileViewerImageComponent implements AXFileTypeViewComponent<AXFi
     private readonly service;
     readonly src: _angular_core.WritableSignal<string>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private loadedId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerImageComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerImageComponent, "ax-file-viewer-image", never, { "payload": { "alias": "payload"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -234,8 +273,10 @@ declare class AXFileViewerVideoComponent implements AXFileTypeViewComponent<AXFi
     #private;
     readonly payload: _angular_core.InputSignal<AXFileViewerViewPayload>;
     private readonly service;
+    private readonly mediaEl;
     readonly src: _angular_core.WritableSignal<string>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private loadedId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerVideoComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerVideoComponent, "ax-file-viewer-video", never, { "payload": { "alias": "payload"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -244,8 +285,10 @@ declare class AXFileViewerAudioComponent implements AXFileTypeViewComponent<AXFi
     #private;
     readonly payload: _angular_core.InputSignal<AXFileViewerViewPayload>;
     private readonly service;
+    private readonly mediaEl;
     readonly src: _angular_core.WritableSignal<string>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private loadedId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerAudioComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerAudioComponent, "ax-file-viewer-audio", never, { "payload": { "alias": "payload"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -257,6 +300,7 @@ declare class AXFileViewerPdfComponent implements AXFileTypeViewComponent<AXFile
     private readonly sanitizer;
     readonly safeSrc: _angular_core.WritableSignal<SafeResourceUrl>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private loadedId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerPdfComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerPdfComponent, "ax-file-viewer-pdf", never, { "payload": { "alias": "payload"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -268,5 +312,5 @@ declare class AXFileViewerFileFallbackComponent implements AXFileTypeViewCompone
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerFileFallbackComponent, "ax-file-viewer-fallback", never, { "payload": { "alias": "payload"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AXFileViewerAudioComponent, AXFileViewerContainerComponent, AXFileViewerFileFallbackComponent, AXFileViewerGalleryService, AXFileViewerHeaderPlaceholderComponent, AXFileViewerImageComponent, AXFileViewerPdfComponent, AXFileViewerService, AXFileViewerSlideComponent, AXFileViewerThumbPreviewComponent, AXFileViewerThumbnailsComponent, AXFileViewerVideoComponent, buildFileViewerExtensionHint, createFileViewerFileTypes, provideFileViewer, resolveFileViewerFileType };
-export type { AXFileViewerGalleryConfig, AXFileViewerGalleryRef, AXFileViewerItem, AXFileViewerViewPayload };
+export { AXFileViewerAudioComponent, AXFileViewerContainerComponent, AXFileViewerEmptyStateComponent, AXFileViewerFileFallbackComponent, AXFileViewerGalleryService, AXFileViewerHeaderPlaceholderComponent, AXFileViewerImageComponent, AXFileViewerPdfComponent, AXFileViewerService, AXFileViewerSlideComponent, AXFileViewerThumbPreviewComponent, AXFileViewerThumbnailsComponent, AXFileViewerVideoComponent, buildFileViewerExtensionHint, createFileViewerFileTypes, provideFileViewer, resolveFileViewerFileType };
+export type { AXFileViewerGalleryConfig, AXFileViewerGalleryRef, AXFileViewerHeaderActionClickEvent, AXFileViewerItem, AXFileViewerViewPayload };

package/types/acorex-components-highlight.d.ts

@@ -0,0 +1,31 @@
+import * as _angular_core from '@angular/core';
+import { AXHighlightOptions, AXHighlightSegment } from '@acorex/core/utils';
+import { SafeHtml } from '@angular/platform-browser';
+
+/**
+ * Renders text with search-term matches wrapped in `.ax-highlight` spans.
+ *
+ * Uses a single innerHTML string so Angular control-flow whitespace cannot insert
+ * gaps between highlighted and non-highlighted characters.
+ *
+ * Does not use the `ax-highlight-text` class on the host — that class is reserved for
+ * {@link AXHighlightService} DOM wrappers.
+ */
+declare class AXHighlightTextComponent {
+    #private;
+    private readonly sanitizer;
+    /** The full text to render. */
+    readonly text: _angular_core.InputSignal<string>;
+    /** The search term or terms to highlight within the text. */
+    readonly query: _angular_core.InputSignal<string | readonly string[]>;
+    /** When true, highlighting is disabled and plain text is shown. */
+    readonly highlightDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Optional highlight behavior configuration. */
+    readonly highlightOptions: _angular_core.InputSignal<AXHighlightOptions>;
+    protected readonly segments: _angular_core.Signal<AXHighlightSegment[]>;
+    protected readonly highlightedHtml: _angular_core.Signal<SafeHtml>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXHighlightTextComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXHighlightTextComponent, "ax-highlight-text", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "highlightDisabled": { "alias": "highlightDisabled"; "required": false; "isSignal": true; }; "highlightOptions": { "alias": "highlightOptions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { AXHighlightTextComponent };

package/types/acorex-components-image-editor.d.ts

@@ -2,15 +2,6 @@ import * as polytype from 'polytype';
 import * as _angular_core from '@angular/core';
 import { OnDestroy, ElementRef, Renderer2 } from '@angular/core';
 import { MXBaseComponent, MXInputBaseValueComponent, MXLookComponent } from '@acorex/cdk/common';
-import * as i1 from '@acorex/components/button';
-import * as i2 from '@angular/forms';
-import * as i3 from '@acorex/components/range-slider';
-import * as i4 from '@acorex/components/select-box';
-import * as i5 from '@acorex/components/color-box';
-import * as i6 from '@acorex/components/popover';
-import * as i7 from '@acorex/components/decorators';
-import * as i8 from '@acorex/components/loading';
-import * as i9 from '@acorex/components/dialog';
 
 type AXImageEditorTool = 'pen' | 'highlight' | 'crop' | 'rotate';
 declare class AXImageEditorService {
@@ -25,19 +16,27 @@ declare class AXImageEditorService {
         userInteract: boolean;
     }>;
     isImageLoad: _angular_core.WritableSignal<boolean>;
+    loadError: _angular_core.WritableSignal<boolean>;
     newImage: HTMLImageElement | null;
     initialImage: HTMLImageElement | null;
     imageBlob: _angular_core.WritableSignal<Blob[]>;
     undoPressed: _angular_core.WritableSignal<boolean>;
     redoPressed: _angular_core.WritableSignal<boolean>;
+    canUndo: _angular_core.WritableSignal<boolean>;
+    canRedo: _angular_core.WritableSignal<boolean>;
     cropperRatio: _angular_core.WritableSignal<string>;
     cropperSize: _angular_core.WritableSignal<number>;
     toggleTool(tool: AXImageEditorTool): void;
     activateTool(tool: AXImageEditorTool): void;
+    undo(): void;
+    redo(): void;
+    /** Handles Ctrl/Cmd+Z and Ctrl/Cmd+Y history shortcuts. Returns true when handled. */
+    handleHistoryShortcut(event: KeyboardEvent): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXImageEditorService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
+type AXImageEditorCropHandle = 'right' | 'top' | 'left' | 'bottom' | 'right-top' | 'bottom-right' | 'bottom-left' | 'left-top';
 /**
  * paint mode.
  * @category Components
@@ -55,39 +54,43 @@ declare class AXImageEditorCropperWindowComponent implements OnDestroy {
     protected cropperWindow: _angular_core.Signal<ElementRef<any>>;
     private currentX;
     private currentY;
-    private prevX;
-    private prevY;
     private aspectWidth;
     private aspectHeight;
     private isMousePressed;
     protected renderer: Renderer2;
     private platformID;
-    private mouseMoveEvent;
-    private mouseUpEvent;
-    private mouseMoveEvent2;
-    private mouseUpEvent2;
-    private mouseDownEvent;
-    private mouseLeaveEvent;
+    private mouseMoveEvent?;
+    private mouseUpEvent?;
+    private mouseMoveEvent2?;
+    private mouseUpEvent2?;
+    private mouseDownEvent?;
+    private mouseLeaveEvent?;
+    private positioned;
     ngOnDestroy(): void;
-    protected panMove(e: MouseEvent): void;
-    protected panDown(e: MouseEvent): void;
+    protected panMove(e: PointerEvent): void;
+    protected panDown(e: PointerEvent): void;
     protected panUp(): void;
     getCropperArea(): DOMRect;
-    private setPosition;
     private startX;
     private startY;
     private startWidth;
     private startHeight;
     private startLeft;
     private startTop;
-    protected handleSelector(e: MouseEvent, value: string): void;
-    protected changeSizeHandler(e: MouseEvent): void;
+    protected handleSelector(e: PointerEvent, value: AXImageEditorCropHandle): void;
+    protected changeSizeHandler(e: PointerEvent): void;
     protected clearSelector(): void;
+    private normalizeRatio;
+    private centerOnParent;
+    private getImageBounds;
+    private constrainCropBox;
+    private clampToParent;
+    private applyPosition;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorCropperWindowComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorCropperWindowComponent, "ax-image-editor-cropper-window", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDestroy {
+declare class AXImageEditorViewComponent extends MXBaseComponent {
     /**
      * its change grid display state.
      */
@@ -118,44 +121,54 @@ declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDe
     protected isDrawRectangleCreated: _angular_core.WritableSignal<boolean>;
     /** @ignore */
     protected parent: AXImageEditorContainerComponent;
-    /** @ignore */
-    protected renderer: Renderer2;
+    private readonly destroyRef;
+    private readonly host;
     /** @ignore */
     protected imageEditorHistory: _angular_core.WritableSignal<HTMLImageElement[]>;
     /** @ignore */
     protected imageEditorHistoryPointer: _angular_core.WritableSignal<number>;
-    /** @ignore */
-    private resizeEventListener;
-    /** @ignore */
-    private imageLoadEventListener;
-    private originalWidth;
-    private originalHeight;
-    private scale;
+    private canvasReady;
+    private drawing;
+    private didDraw;
+    private highlightSnapshot;
+    private highlightPoints;
+    private persistGeneration;
+    private sourceToken;
+    constructor();
     /** @ignore */
     protected resizeWindow(): void;
     /** @ignore */
     protected canvasResponsive(image: HTMLImageElement): void;
-    /** @ignore */
-    constructor();
-    /** @ignore */
-    ngOnDestroy(): void;
-    private setInitialImage;
-    /** @ignore */
-    protected imageChanged(): void;
+    private loadSource;
+    private paintImage;
+    private fitCanvasDisplay;
+    private replaceHistory;
+    private pushHistory;
+    private syncHistoryFlags;
+    private applyUndo;
+    private applyRedo;
+    private canvasPoint;
+    private isDrawTool;
     /** @ignore */
     protected penConfigHandler(penType: 'pen' | 'highlight'): void;
+    private strokeHighlight;
     /** @ignore */
-    protected mouseDownHandler(e: MouseEvent): void;
+    protected historyKeyDown(event: KeyboardEvent): void;
     /** @ignore */
-    protected mouseMoveHandler(e: MouseEvent): void;
+    protected focusCanvas(): void;
     /** @ignore */
-    protected mouseUpHandler(): void;
+    protected mouseDownHandler(event: PointerEvent): void;
     /** @ignore */
-    crop(): Promise<void>;
+    protected mouseMoveHandler(event: PointerEvent): void;
     /** @ignore */
-    protected rotateImage(): void;
+    protected mouseUpHandler(event?: PointerEvent): void;
+    /** Applies the current cropper selection. */
+    crop(): Promise<void>;
+    /** Encodes the current canvas into JPEG, PNG, and WebP blobs. */
+    commitChanges(): Promise<Blob[]>;
     /** @ignore */
-    protected saveImageChange(): Promise<void>;
+    protected rotateImage(): Promise<void>;
+    private persistCanvas;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorViewComponent, "ax-image-editor-view", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "cropperSize": { "alias": "cropperSize"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -163,7 +176,7 @@ declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDe
 declare const AXImageEditorContainerComponent_base: polytype.Polytype.ClusteredConstructor<[{
     new (): MXInputBaseValueComponent<Blob[]>;
     ɵfac: _angular_core.ɵɵFactoryDeclaration<MXInputBaseValueComponent<any>, never>;
-    ɵprov: _angular_core.ɵɵInjectableDeclaration<MXInputBaseValueComponent<any>>;
+    ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }, typeof MXLookComponent]>;
 /**
  * paint container.
@@ -173,12 +186,21 @@ declare class AXImageEditorContainerComponent extends AXImageEditorContainerComp
     #private;
     /** @ignore */
     protected service: AXImageEditorService;
+    private readonly host;
+    private readonly destroyRef;
     imageEditorContainer: _angular_core.Signal<ElementRef<any>>;
     view: _angular_core.Signal<AXImageEditorViewComponent>;
+    constructor();
+    /** @ignore */
+    protected focusEditor(): void;
     /** Applies the current cropper selection. */
     crop(): Promise<void>;
-    get __hostClass(): string;
-    private get __hostName();
+    /** @ignore */
+    protected onEditorPointerDown(event: PointerEvent): void;
+    /** @ignore */
+    protected handleHistoryShortcut(event: KeyboardEvent): void;
+    /** Encodes the current canvas into JPEG, PNG, and WebP blobs. */
+    commitChanges(): Promise<Blob[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorContainerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorContainerComponent, "ax-image-editor-container", never, { "look": { "alias": "look"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "onValueChanged": "onValueChanged"; }, ["view"], ["ax-header", "ax-image-editor-view", "ax-footer", "ax-validation-rule"], true, never>;
 }
@@ -287,7 +309,7 @@ declare class AXImageEditorToolSelectorComponent {
 
 declare class AXImageEditorModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXImageEditorModule, never, [typeof i1.AXButtonModule, typeof i2.FormsModule, typeof i3.AXRangeSliderModule, typeof i4.AXSelectBoxModule, typeof i5.AXColorBoxModule, typeof i6.AXPopoverModule, typeof i7.AXDecoratorModule, typeof i8.AXLoadingModule, typeof i9.AXDialogModule, typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent], [typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXImageEditorModule, never, [typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent], [typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXImageEditorModule>;
 }