@acorex/components 22.0.0 → 22.0.1-next.0

package/types/acorex-components-data-table.d.ts

@@ -215,6 +215,10 @@ declare abstract class AXBaseDataTable extends MXBaseComponent {
      * Returns the CSS class of a highlighted column, applied to its header and body cells.
      */
     getColumnCssClass(column: AXDataTableColumnComponent): string;
+    /**
+     * Header `<th>` classes: column highlight + column `cssClass` (e.g. `ax-select-column`).
+     */
+    getHeadColumnCssClass(column: AXDataTableColumnComponent): string;
     /**
      * Returns the temporary highlight state for a row, if any.
      */
@@ -382,6 +386,10 @@ declare class AXDataTableTextColumnComponent extends AXDataTableColumnComponent
      * @defaultValue false
      */
     wrapText: boolean;
+    /**
+     * When `true`, cell values are resolved as i18n expressions (e.g. `@acorex:common.actions.cancel`).
+     */
+    translate: boolean;
     /**
      * Provides a custom template for rendering cells within the column.
      */
@@ -441,6 +449,7 @@ declare class AXDataTableTextColumnComponent extends AXDataTableColumnComponent
      *  @ignore
      */
     private formatService;
+    private translationService;
     protected getDisplayText(rowData: unknown, dataField: string): string;
     /**
      * Defines the format string for displaying values in the component.
@@ -451,7 +460,7 @@ declare class AXDataTableTextColumnComponent extends AXDataTableColumnComponent
      */
     formatOptions: AXFormatOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXDataTableTextColumnComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXDataTableTextColumnComponent, "ax-text-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "allowSorting": { "alias": "allowSorting"; "required": false; }; "allowResizing": { "alias": "allowResizing"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "hasTitle": { "alias": "hasTitle"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "dataField": { "alias": "dataField"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "wrapText": { "alias": "wrapText"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "format": { "alias": "format"; "required": false; }; "formatOptions": { "alias": "formatOptions"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXDataTableTextColumnComponent, "ax-text-column", never, { "width": { "alias": "width"; "required": false; }; "caption": { "alias": "caption"; "required": false; }; "allowSorting": { "alias": "allowSorting"; "required": false; }; "allowResizing": { "alias": "allowResizing"; "required": false; }; "fixed": { "alias": "fixed"; "required": false; }; "hasTitle": { "alias": "hasTitle"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "dataField": { "alias": "dataField"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "wrapText": { "alias": "wrapText"; "required": false; }; "translate": { "alias": "translate"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; "format": { "alias": "format"; "required": false; }; "formatOptions": { "alias": "formatOptions"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 type AXRowCommandItem = AXButtonItemListItem & {
@@ -864,9 +873,10 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
     protected resizeColumnProp: {
         startX: number;
         startWidth: number;
-        columnIndex: number;
-        newColumnWidth: number;
-        thElement: any;
+        column: AXDataTableColumnComponent | null;
+        thElement: HTMLElement | null;
+        /** True when the resize handle sits on the column's trailing edge in screen coordinates. */
+        resizeFromTrailingEdge: boolean;
     };
     /**
      * Columns that used `width="auto"` and received header-only sizing before rows were available.
@@ -1082,10 +1092,20 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
     protected toggleExpanded(rows: any[], expandedItem: any, children: any[]): any[];
     protected refreshExpandedItem(id: string | number): Promise<void>;
     private updateChildren;
+    /**
+     * CDK sort-predicate indices follow physical left-to-right order; map them to `columnsList` order.
+     * @ignore
+     */
+    private cdkSortIndexToColumnIndex;
+    /**
+     * Restricts column reordering to non-fixed columns only.
+     * @ignore
+     */
+    protected columnReorderSortPredicate: (index: number) => boolean;
     /**
      *  @ignore
      */
-    protected drop(event: CdkDragDrop<any, any, any>): void;
+    protected drop(event: CdkDragDrop<AXDataTableColumnComponent>): void;
     /**
      *  @ignore
      */
@@ -1149,11 +1169,11 @@ declare class AXDataTableComponent extends AXBaseDataTable implements OnInit, Af
      * @param columnIndex - The index of the column to auto-fit
      * @ignore
      */
-    protected onResizeHandlerDoubleClick(event: MouseEvent, columnIndex: number): void;
+    protected onResizeHandlerDoubleClick(event: MouseEvent, column: AXDataTableColumnComponent): void;
     /**
      *  @ignore
      */
-    protected onResizeColumnStart(event: MouseEvent, columnIndex: number): void;
+    protected onResizeColumnStart(event: MouseEvent, column: AXDataTableColumnComponent): void;
     /**
      *  @ignore
      */

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

@@ -1,5 +1,6 @@
 import { MXBaseComponent, AXSurfaceType } from '@acorex/cdk/common';
 import * as i0 from '@angular/core';
+import { AXFullScreenMode } from '@acorex/core/full-screen';
 import * as i1 from '@angular/common';
 
 /**
@@ -76,10 +77,21 @@ declare class AXDecoratorFullScreenButtonComponent extends MXBaseComponent {
     #private;
     private readonly fullScreenService;
     private readonly elementRef;
+    /**
+     * Target element to fullscreen. Falls back to the closest decorated parent when omitted.
+     */
     element: i0.ModelSignal<HTMLElement>;
+    /**
+     * Whether fullscreen mode is active.
+     */
     isActive: i0.ModelSignal<boolean>;
+    /**
+     * Fullscreen implementation mode.
+     * @defaultValue 'overlay'
+     */
+    mode: i0.InputSignal<AXFullScreenMode>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXDecoratorFullScreenButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXDecoratorFullScreenButtonComponent, "ax-fullscreen-button", never, { "element": { "alias": "element"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; }, { "element": "elementChange"; "isActive": "isActiveChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXDecoratorFullScreenButtonComponent, "ax-fullscreen-button", never, { "element": { "alias": "element"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "element": "elementChange"; "isActive": "isActiveChange"; }, never, never, true, never>;
 }
 
 /**

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

@@ -0,0 +1,42 @@
+import * as _angular_core from '@angular/core';
+import { AXEmoji } from '@acorex/core/constants';
+
+/**
+ * Renders a single emoji using its Unicode character from metadata.
+ *
+ * @category Components
+ */
+declare class AXEmojiComponent {
+    /**
+     * Emoji metadata to render.
+     */
+    readonly emoji: _angular_core.InputSignal<AXEmoji>;
+    /**
+     * Emoji rendering style.
+     * - `google`: Noto Color Emoji (Android/Google look) on all platforms, including Windows.
+     * - `native`: OS default fonts (Segoe UI Emoji on Windows).
+     *
+     * @defaultValue 'google'
+     */
+    readonly appearance: _angular_core.InputSignal<"google" | "native">;
+    /**
+     * Rendered size in pixels.
+     *
+     * @defaultValue 20
+     */
+    readonly size: _angular_core.InputSignal<number>;
+    /** Unicode glyph to display. */
+    protected readonly glyph: _angular_core.Signal<string>;
+    /** Accessible label sourced from emoji metadata. */
+    protected readonly ariaLabel: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXEmojiComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXEmojiComponent, "ax-emoji", never, { "emoji": { "alias": "emoji"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class AXEmojiModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXEmojiModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXEmojiModule, never, [typeof AXEmojiComponent], [typeof AXEmojiComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXEmojiModule>;
+}
+
+export { AXEmojiComponent, AXEmojiModule };

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';
@@ -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;
@@ -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 };