@acorex/components 22.0.0-next.3 → 22.0.0-next.31

package/types/acorex-components-datetime-box.d.ts

@@ -37,6 +37,7 @@ declare const AXDateTimeBoxComponent_base: polytype.Polytype.ClusteredConstructo
  * @category Components
  */
 declare class AXDateTimeBoxComponent extends AXDateTimeBoxComponent_base {
+    private readonly defaultConfig;
     /**
      *  @ignore
      */
@@ -56,7 +57,10 @@ declare class AXDateTimeBoxComponent extends AXDateTimeBoxComponent_base {
      */
     formatChange: EventEmitter<string>;
     /**
-     * Indicates whether typing is allowed in the component.
+     * Indicates whether typing is allowed in the input.
+     * When false, clicking the input (or the calendar icon) opens the picker.
+     * When true, the input is for typing and the picker opens from the calendar button.
+     * Defaults to `AX_DATETIME_INPUT_CONFIG.allowTyping` when not set on the instance.
      *
      * @defaultValue false
      */
@@ -91,7 +95,7 @@ declare class AXDateTimeBoxComponent extends AXDateTimeBoxComponent_base {
     protected _editingDateObj: _angular_core.WritableSignal<Date>;
     protected readonly _calendarSystem: _angular_core.Signal<string>;
     protected readonly _resolvedFormat: _angular_core.Signal<string>;
-    protected readonly _classicDateFields: _acorex_components_datetime_box.AXDateTimeBoxClassicField[];
+    protected readonly _classicDateFields: _angular_core.Signal<_acorex_components_datetime_box.AXDateTimeBoxClassicField[]>;
     protected readonly _classicTimeFields: _acorex_components_datetime_box.AXDateTimeBoxClassicField[];
     private readonly _classicTimeOptions;
     protected _classicDate: _angular_core.Signal<dist_packages_core_types_acorex_core_date_time.AXDateTime>;
@@ -125,7 +129,13 @@ declare class AXDateTimeBoxComponent extends AXDateTimeBoxComponent_base {
         text: string;
     }[];
     /**
-     *  @ignore
+     * Syncs typed input values into the box (and the picker via `_editingDateObj`).
+     * @ignore
+     */
+    protected _handleInputModelChange(value: Date | null): void;
+    /**
+     * Syncs picker selection into the box (and the input via `_editingDateObj`).
+     * @ignore
      */
     protected _handlePickerModelChange(value: Date | null): void;
     /**
@@ -163,7 +173,9 @@ declare class AXDateTimeBoxComponent extends AXDateTimeBoxComponent_base {
      */
     private _readSelectValue;
     /**
-     *  @ignore
+     * When typing is disabled, open the picker on input click.
+     * When typing is enabled, keep the picker closed so the user can type.
+     * @ignore
      */
     protected _handleInputOnClick(): void;
     private get __hostName();

package/types/acorex-components-datetime-input.d.ts

@@ -1,32 +1,32 @@
 import * as _angular_core from '@angular/core';
+import { InjectionToken } from '@angular/core';
 import { MXInputBaseValueComponent, AXClickEvent } from '@acorex/cdk/common';
 import { AXDateTimePickerType } from '@acorex/components/calendar';
+import { AXLocaleProfile } from '@acorex/core/locale';
 
 /**
- * A component for date and time input with various custom features.
+ * A component for date and time input with segment-based typing, keyboard navigation,
+ * and calendar-aware formatting (gregorian and solar-hijri).
  *
  * @category Components
  */
 declare class AXDateTimeInputComponent extends MXInputBaseValueComponent<Date> {
     #private;
-    private platformService;
-    private formatService;
     private localeService;
     private calendarService;
-    /**
-     *  @ignore
-     */
+    private readonly defaultConfig;
+    /** @ignore */
     private readonly _editingParts;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
     protected _editingText: _angular_core.WritableSignal<string>;
+    /** @ignore */
+    private _inputChars;
+    /** @ignore */
+    private _activePart;
     /**
-     *  @ignore
-     */
-    protected _inputChars: string[];
-    /**
-     * Indicates whether typing is allowed in the input field.
+     * When true, the user can type digits and navigate segments with the keyboard.
+     * When false, keyboard input is blocked (used by datetime-box picker mode).
+     * Defaults to `AX_DATETIME_INPUT_CONFIG.allowTyping` when not set on the instance.
      * @defaultValue false
      */
     allowTyping: _angular_core.InputSignal<boolean>;
@@ -34,95 +34,97 @@ declare class AXDateTimeInputComponent extends MXInputBaseValueComponent<Date> {
      * @description The calendar type to use for the datetime input.
      */
     calendar: _angular_core.InputSignal<string>;
-    protected readonly _calendarSystem: _angular_core.Signal<string>;
-    private _activePart;
-    private _editingDate;
-    /**
-     *  @ignore
-     */
-    private input;
     minValue: _angular_core.InputSignal<Date>;
     maxValue: _angular_core.InputSignal<Date>;
     /**
-     * Emitted when a click event occurs on the datetime box.
+     * Emitted when a click event occurs on the datetime input.
      * @event
      */
     onClick: _angular_core.OutputEmitterRef<AXClickEvent>;
     picker: _angular_core.InputSignal<AXDateTimePickerType>;
-    protected readonly _resolvedFormat: _angular_core.Signal<string>;
     /**
      * @deprecated use locale & mode instead
      */
     format: _angular_core.InputSignal<string>;
-    private _detectParts;
+    protected readonly _calendarSystem: _angular_core.Signal<string>;
+    protected readonly _resolvedFormat: _angular_core.Signal<string>;
+    /** @ignore */
+    protected readonly _isHijriRtl: _angular_core.Signal<boolean>;
+    /** @ignore */
+    private _editingDate;
+    /** @ignore */
+    private inputRef;
+    /** @ignore */
+    private get inputElement();
     /**
      * @description check if page is in rtl or ltr
      */
-    protected isRtl: _angular_core.WritableSignal<boolean>;
+    protected readonly isRtl: _angular_core.Signal<boolean>;
     /**
-     * @description listen to direction change to react to it.
-     */
-    protected ngOnInit(): void;
-    /**
-     *  @ignore
+     * Formats a part using the calendar already attached to the AXDateTime.
+     * @ignore
      */
+    private _formatPart;
+    /** @ignore */
+    private _detectParts;
+    /** @ignore */
     private _getOrderedParts;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
+    private _getNavigationParts;
+    /** @ignore */
     private _clearInputBuffer;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
     private _updateText;
-    /**
-     * Sets the internal date value, adjusting it based on editing parts.
-     * @param value - The date to set. Returns `undefined` if no value is provided.
-     * @ignore
-     */
     /**
      * Handles changes to the internal date value, updating editing parts and text representation.
-     *
-     * @param value - The new date value. If not provided, resets editing parts.
      * @ignore
      */
     internalValueChanged(value?: Date): void;
     /**
-     *  @ignore
-     */
-    _handleOnKeydownEvent(e: KeyboardEvent): void;
-    /**
-     *  @ignore
-     */
-    _handleKeyUpEvent(): void;
-    /**
-     *  @ignore
+     * Normalizes Persian (U+06F0-U+06F9) and Arabic-Indic (U+0660-U+0669) digits to ASCII.
+     * @ignore
      */
+    private _normalizeDigit;
+    /** @ignore */
+    protected _handleOnKeydownEvent(e: KeyboardEvent): void;
+    /** @ignore */
+    private _handleDigitInput;
+    /** @ignore */
+    private _applyEditingDate;
+    /** @ignore */
+    protected _handleKeyUpEvent(): void;
+    /** @ignore */
     protected _handleFocusEvent(e: FocusEvent): void;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
     protected _handleBlurEvent(e: FocusEvent): void;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
+    private _clampToRange;
+    /** @ignore */
     protected _handleOnInputClickEvent(e: MouseEvent): void;
-    /**
-     *  @ignore
-     */
-    private _detectPartAtPosition;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
+    private _selectFirstPart;
+    /** @ignore */
+    private _ensureEditableText;
+    /** @ignore */
     private _highlightActivePart;
-    /**
-     *  @ignore
-     */
+    /** @ignore */
     private _detectValueChanges;
-    private get __hostName();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXDateTimeInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXDateTimeInputComponent, "ax-datetime-input", never, { "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "value": { "alias": "value"; "required": false; }; "state": { "alias": "state"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "allowTyping": { "alias": "allowTyping"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "picker": { "alias": "picker"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "stateChange": "stateChange"; "onValueChanged": "onValueChanged"; "onBlur": "onBlur"; "onFocus": "onFocus"; "readonlyChange": "readonlyChange"; "disabledChange": "disabledChange"; "onClick": "onClick"; }, never, ["ax-validation-rule"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXDateTimeInputComponent, "ax-datetime-input", never, { "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "value": { "alias": "value"; "required": false; }; "state": { "alias": "state"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "allowTyping": { "alias": "allowTyping"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "picker": { "alias": "picker"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "stateChange": "stateChange"; "onValueChanged": "onValueChanged"; "onBlur": "onBlur"; "onFocus": "onFocus"; "readonlyChange": "readonlyChange"; "disabledChange": "disabledChange"; "onKeyDown": "onKeyDown"; "onKeyUp": "onKeyUp"; "onKeyPress": "onKeyPress"; "onClick": "onClick"; }, never, ["ax-validation-rule"], true, never>;
+}
+
+interface AXDateTimeInputConfig {
+    allowTyping: boolean;
 }
+declare const AXDateTimeInputDefaultConfig: AXDateTimeInputConfig;
+declare const AX_DATETIME_INPUT_CONFIG: InjectionToken<AXDateTimeInputConfig>;
+declare function resolveDateTimeInputFormat(options: {
+    customFormat: string | null | undefined;
+    calendarSystem: string;
+    picker: AXDateTimePickerType;
+    isRtl: boolean;
+    localeFormats: AXLocaleProfile['formats'];
+}): string;
 
 declare class AXDateTimeInputModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXDateTimeInputModule, never>;
@@ -130,4 +132,5 @@ declare class AXDateTimeInputModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXDateTimeInputModule>;
 }
 
-export { AXDateTimeInputComponent, AXDateTimeInputModule };
+export { AXDateTimeInputComponent, AXDateTimeInputDefaultConfig, AXDateTimeInputModule, AX_DATETIME_INPUT_CONFIG, resolveDateTimeInputFormat };
+export type { AXDateTimeInputConfig };

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

@@ -1,8 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { Provider, OnDestroy } from '@angular/core';
+import { OnDestroy, TemplateRef, Type, Provider } from '@angular/core';
+import { AXComponentContent, AXComponentInputs } from '@acorex/core/components';
+import { Subject } from 'rxjs';
+import { AXStyleColorType, AXComponentClosedPromise } from '@acorex/cdk/common';
 import * as _acorex_core_file from '@acorex/core/file';
 import { AXFileTypeExtensionHint, AXFileType, AXFileTypeViewComponent } from '@acorex/core/file';
-import { AXStyleColorType } from '@acorex/cdk/common';
 import { SafeResourceUrl } from '@angular/platform-browser';
 
 /** Single item displayed in a file-viewer carousel. */
@@ -36,34 +38,35 @@ declare class AXFileViewerService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXFileViewerService>;
 }
 
-/** Registers file-viewer components on standard file-type catalog entries. */
-declare function provideFileViewer(): Provider[];
-
 /** Infers a file-type catalog name from the item. */
 declare function resolveFileViewerFileType(item: AXFileViewerItem): string;
 /** Builds an extension hint from item metadata. */
 declare function buildFileViewerExtensionHint(item: AXFileViewerItem): AXFileTypeExtensionHint | undefined;
 
-declare function createFileViewerFileTypes(): AXFileType[];
-
 declare class AXFileViewerContainerComponent implements OnDestroy {
     #private;
     readonly items: _angular_core.InputSignal<AXFileViewerItem[]>;
+    readonly startIndex: _angular_core.InputSignal<number>;
     readonly thumbnail: _angular_core.InputSignal<boolean>;
     readonly pagination: _angular_core.InputSignal<boolean>;
     readonly download: _angular_core.InputSignal<boolean>;
     readonly fullscreen: _angular_core.InputSignal<boolean>;
+    /** 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>;
     /** External loading flag — show overlay while parent data is being fetched. */
     readonly loading: _angular_core.InputSignal<boolean>;
+    readonly fullscreenClosed: _angular_core.OutputEmitterRef<void>;
     readonly service: AXFileViewerService;
     private readonly host;
-    private readonly zIndexService;
     private readonly fullScreenService;
     private readonly mainCarouselRef;
     private readonly thumbCarouselRef;
-    readonly fullscreenActive: _angular_core.WritableSignal<boolean>;
-    private zToken;
     private initToken;
+    readonly isFullscreenActive: _angular_core.WritableSignal<boolean>;
     /** True while carousels are being (re)initialized. */
     readonly initializing: _angular_core.WritableSignal<boolean>;
     readonly isBusy: _angular_core.Signal<boolean>;
@@ -74,34 +77,123 @@ declare class AXFileViewerContainerComponent implements OnDestroy {
     readonly currentTypeLabel: _angular_core.Signal<string>;
     readonly currentTypeColor: _angular_core.Signal<AXStyleColorType>;
     readonly slideCounter: _angular_core.Signal<string>;
+    readonly headerTemplateContent: _angular_core.Signal<TemplateRef<any>>;
+    readonly headerComponentContent: _angular_core.Signal<Type<unknown>>;
+    readonly hasHeaderCenterContent: _angular_core.Signal<boolean>;
+    readonly headerContentContext: _angular_core.Signal<{
+        item: AXFileViewerItem;
+        items: AXFileViewerItem[];
+        selectedIndex: number;
+        slideCounter: string;
+    }>;
     readonly resolveFileType: typeof resolveFileViewerFileType;
     resolveTypeLabel(item: AXFileViewerItem): string;
     formatSize(size?: number): string;
     private readonly mainCarouselOptions;
     private readonly thumbnailCarouselOptions;
-    private acquireFullscreenZIndex;
-    private releaseFullscreenZIndex;
+    toggleFullscreen(): void;
+    enterFullscreen(): void;
+    /** @param emitGalleryClose When false, skips gallery close notification (used during service teardown). */
+    exitFullscreen(emitGalleryClose?: boolean): void;
+    closeGallery(): void;
     private initCarousels;
     private readonly onSlideChange;
     next(): void;
     prev(): void;
     goToIndex(index: number, speed?: number): void;
-    toggleFullscreen(): void;
     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; }; "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; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, ["ax-header"], 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; }; "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>;
+}
+
+interface AXFileViewerGalleryConfig {
+    items: AXFileViewerItem[];
+    startIndex?: number;
+    thumbnail?: boolean;
+    download?: boolean;
+    loading?: boolean;
+    panelClass?: string[];
+    headerContent?: AXComponentContent | null;
+    headerContentInputs?: AXComponentInputs | null;
+    fallbackContent?: AXComponentContent | null;
+    fallbackContentInputs?: AXComponentInputs | null;
+}
+interface AXFileViewerGalleryRef<TResult = any> {
+    close: (data?: TResult) => void;
+    setInputs: (values: AXComponentInputs) => void;
+    bringToFront: () => void;
+    onClose: Subject<TResult>;
+    componentInstance?: AXFileViewerContainerComponent;
+}
+
+/** Opens {@link AXFileViewerContainerComponent} in fullscreen gallery mode. */
+declare class AXFileViewerGalleryService {
+    private readonly galleryList;
+    private readonly overlayService;
+    /**
+     * Opens a file viewer gallery in fullscreen.
+     * @param config - Gallery configuration
+     * @returns Promise that resolves when the gallery is closed
+     */
+    open(config: AXFileViewerGalleryConfig): AXComponentClosedPromise;
+    /**
+     * Closes a gallery by its ID.
+     * @param id - The gallery ID to close
+     * @param data - Optional data to pass to the close event
+     */
+    close<TResult = unknown>(id: number, data?: TResult): void;
+    /**
+     * Sets input values for a gallery by its ID.
+     * @param id - The gallery ID
+     * @param values - Object containing input values to set
+     */
+    setInputs(id: number, values: AXComponentInputs): void;
+    /**
+     * Brings a gallery to the front of all other overlays.
+     * @param id - The gallery ID to bring to front
+     */
+    bringToFront(id: number): void;
+    private openInternal;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerGalleryService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXFileViewerGalleryService>;
+}
+
+/** Registers file-viewer components on standard file-type catalog entries. */
+declare function provideFileViewer(): Provider[];
+
+declare function createFileViewerFileTypes(): AXFileType[];
+
+/** Optional center header slot component for use with {@link headerContent}. */
+declare class AXFileViewerHeaderPlaceholderComponent {
+    readonly slideCounter: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerHeaderPlaceholderComponent, never>;
+    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 AXFileViewerSlideComponent {
     readonly item: _angular_core.InputSignal<AXFileViewerItem>;
     readonly index: _angular_core.InputSignal<number>;
+    readonly fallbackContent: _angular_core.InputSignal<AXComponentContent>;
+    readonly fallbackContentInputs: _angular_core.InputSignal<AXComponentInputs>;
     private readonly service;
     readonly fileTypeName: _angular_core.Signal<string>;
     readonly extensionHint: _angular_core.Signal<_acorex_core_file.AXFileTypeExtensionHint>;
     readonly viewPayload: _angular_core.Signal<AXFileViewerViewPayload>;
+    readonly fallbackTemplateContent: _angular_core.Signal<TemplateRef<any>>;
+    readonly fallbackComponentContent: _angular_core.Signal<Type<unknown>>;
+    readonly useCustomFallback: _angular_core.Signal<boolean>;
+    readonly fallbackContentContext: _angular_core.Signal<{
+        payload: AXFileViewerViewPayload;
+        item: AXFileViewerItem;
+        index: number;
+        active: boolean;
+    }>;
+    readonly fallbackComponentInputs: _angular_core.Signal<{
+        payload: AXFileViewerViewPayload;
+    }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFileViewerSlideComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerSlideComponent, "ax-file-viewer-slide", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "index": { "alias": "index"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXFileViewerSlideComponent, "ax-file-viewer-slide", never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "index": { "alias": "index"; "required": true; "isSignal": true; }; "fallbackContent": { "alias": "fallbackContent"; "required": false; "isSignal": true; }; "fallbackContentInputs": { "alias": "fallbackContentInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXFileViewerThumbPreviewComponent {
@@ -176,5 +268,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, AXFileViewerImageComponent, AXFileViewerPdfComponent, AXFileViewerService, AXFileViewerSlideComponent, AXFileViewerThumbPreviewComponent, AXFileViewerThumbnailsComponent, AXFileViewerVideoComponent, buildFileViewerExtensionHint, createFileViewerFileTypes, provideFileViewer, resolveFileViewerFileType };
-export type { AXFileViewerItem, AXFileViewerViewPayload };
+export { AXFileViewerAudioComponent, AXFileViewerContainerComponent, AXFileViewerFileFallbackComponent, AXFileViewerGalleryService, AXFileViewerHeaderPlaceholderComponent, AXFileViewerImageComponent, AXFileViewerPdfComponent, AXFileViewerService, AXFileViewerSlideComponent, AXFileViewerThumbPreviewComponent, AXFileViewerThumbnailsComponent, AXFileViewerVideoComponent, buildFileViewerExtensionHint, createFileViewerFileTypes, provideFileViewer, resolveFileViewerFileType };
+export type { AXFileViewerGalleryConfig, AXFileViewerGalleryRef, AXFileViewerItem, AXFileViewerViewPayload };

package/types/acorex-components-grid-layout-builder.d.ts

@@ -5,6 +5,8 @@ import { NXEvent, NXComponent } from '@acorex/cdk/common';
 import { Subscription } from 'rxjs';
 import * as gridstack from 'gridstack';
 
+/** Grid size preset as `[width, height]` in column/row units. */
+type AXGridLayoutSize = readonly [width: number, height: number];
 interface AXGridLayoutPosition {
     /** widget position x (default?: 0) */
     x?: number;
@@ -22,6 +24,11 @@ interface AXGridLayoutPosition {
     minWidth?: number;
     /** minimum height of widget in rows (default?: undefined = un-constrained) */
     minHeight?: number;
+    /**
+     * When set, resize snaps to one of these `[width, height]` presets.
+     * Min/max bounds are derived from this list during grid conversion.
+     */
+    allowedSizes?: readonly AXGridLayoutSize[];
 }
 interface AXGridLayoutWidget extends AXGridLayoutPosition {
     id?: string;
@@ -318,5 +325,25 @@ declare class AXGridLayoutBuilderModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXGridLayoutBuilderModule>;
 }
 
-export { AXGridLayoutBuilderModule, AXGridLayoutContainerComponent, AXGridLayoutWidgetComponent };
-export type { AXGridLayout, AXGridLayoutContainerElement, AXGridLayoutEvent, AXGridLayoutNode, AXGridLayoutOptions, AXGridLayoutPosition, AXGridLayoutWidget, AXGridLayoutWidgetElement };
+declare const AX_GRID_LAYOUT_ALLOWED_SIZES_ATTR = "data-ax-allowed-sizes";
+declare function convertAXGridLayoutWidgetToGridStackWidget(widget: AXGridLayoutWidget): gridstack.GridStackWidget;
+declare function convertGridStackWidgetToAXGridLayoutWidget(widget: gridstack.GridStackWidget): AXGridLayoutWidget;
+declare function convertAXGridLayoutNodeToGridStackNode(node: AXGridLayoutNode): gridstack.GridStackNode;
+declare function convertGridStackNodeToAXGridLayoutNode(node: gridstack.GridStackNode): AXGridLayoutNode;
+declare function convertAXGridLayoutOptionsToGridStackOptions(options: AXGridLayoutOptions): gridstack.GridStackOptions;
+declare function convertGridStackOptionsToAXGridLayoutOptions(options: gridstack.GridStackOptions): AXGridLayoutOptions;
+/** remove keys which are undefined */
+declare function removeUndefinedKeys<T extends object>(obj: T): T;
+declare function writeAllowedSizesToElement(element: HTMLElement | undefined, allowedSizes: readonly AXGridLayoutSize[] | undefined): void;
+declare function readAllowedSizesFromElement(element: HTMLElement): readonly AXGridLayoutSize[] | undefined;
+declare const AX_GRID_LAYOUT_RESIZE_INVALID_CLASS = "ax-grid-layout-resize-invalid";
+declare function isExactAllowedSize(width: number, height: number, allowedSizes: readonly AXGridLayoutSize[]): boolean;
+declare function updateResizeValidityMarkers(gridEl: HTMLElement, element: gridstack.GridItemHTMLElement): void;
+declare function clearResizeValidityMarkers(gridEl: HTMLElement): void;
+declare function snapToAllowedSize(width: number, height: number, allowedSizes: readonly AXGridLayoutSize[]): AXGridLayoutSize;
+declare function deriveMinMaxFromAllowedSizes(allowedSizes: readonly AXGridLayoutSize[]): Pick<AXGridLayoutWidget, 'minWidth' | 'maxWidth' | 'minHeight' | 'maxHeight'>;
+declare function normalizeLayoutNodeWithAllowedSizes<T extends AXGridLayoutWidget>(node: T): T;
+declare function snapElementToAllowedSize(grid: gridstack.GridStack, element: gridstack.GridItemHTMLElement): boolean;
+
+export { AXGridLayoutBuilderModule, AXGridLayoutContainerComponent, AXGridLayoutWidgetComponent, AX_GRID_LAYOUT_ALLOWED_SIZES_ATTR, AX_GRID_LAYOUT_RESIZE_INVALID_CLASS, clearResizeValidityMarkers, convertAXGridLayoutNodeToGridStackNode, convertAXGridLayoutOptionsToGridStackOptions, convertAXGridLayoutWidgetToGridStackWidget, convertGridStackNodeToAXGridLayoutNode, convertGridStackOptionsToAXGridLayoutOptions, convertGridStackWidgetToAXGridLayoutWidget, deriveMinMaxFromAllowedSizes, isExactAllowedSize, normalizeLayoutNodeWithAllowedSizes, readAllowedSizesFromElement, removeUndefinedKeys, snapElementToAllowedSize, snapToAllowedSize, updateResizeValidityMarkers, writeAllowedSizesToElement };
+export type { AXGridLayout, AXGridLayoutContainerElement, AXGridLayoutEvent, AXGridLayoutNode, AXGridLayoutOptions, AXGridLayoutPosition, AXGridLayoutSize, AXGridLayoutWidget, AXGridLayoutWidgetElement };

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

@@ -175,8 +175,16 @@ declare class AXMenuItemComponent extends NXComponent implements OnDestroy {
     private unsuscriber;
     private renderer;
     private injector;
+    private document;
     private zIndexService;
     private zToken;
+    private submenuPortalParent;
+    private submenuPortalNextSibling;
+    /** Survives submenu portaling when the DOM parent chain is broken. */
+    private linkedParent;
+    private mouseLeaveTimeout;
+    private submenuUnlistenEnter;
+    private submenuUnlistenLeave;
     protected arrowIcon: _angular_core.Signal<string>;
     onClick: _angular_core.OutputEmitterRef<AXMenuItemClickEvent>;
     name: _angular_core.InputSignal<string>;
@@ -186,8 +194,8 @@ declare class AXMenuItemComponent extends NXComponent implements OnDestroy {
     constructor();
     private getText;
     /**
-     * Resolves the parent menu item. Items rendered via recursive `ngTemplateOutlet` do not
-     * receive a DI parent, so we fall back to the DOM tree after reparenting.
+     * Resolves the parent menu item. Prefers an explicit link (survives submenu portaling),
+     * then DI, then the DOM tree.
      */
     getParentMenuItem(): AXMenuItemComponent | null;
     /**
@@ -204,10 +212,20 @@ declare class AXMenuItemComponent extends NXComponent implements OnDestroy {
     private schedulePositionCalculation;
     /**
      * Calculate the position of the submenu to avoid it going out of the viewport.
+     * Tall panels are height-clamped; the panel is portaled so parent overflow cannot clip it.
      */
     private calculatePosition;
     /** Measures submenu size using the same flex layout as the rendered menu. */
     private measureSubmenuRect;
+    /** Moves the submenu under the context-menu backdrop (or body) to escape ancestor overflow. */
+    private portalSubmenu;
+    private restoreSubmenuPortal;
+    /** Keep this item open while the pointer is over its portaled submenu panel. */
+    private bindSubmenuPointerListeners;
+    private unbindSubmenuPointerListeners;
+    /** Links direct children so parent resolution still works after the panel is portaled. */
+    private linkChildItems;
+    private getInstanceFromElement;
     /**
      * Moves nested `ax-menu-item` nodes rendered by recursive `ngTemplateOutlet` templates
      * into the submenu slot. Angular content queries do not traverse those embedded views.
@@ -225,10 +243,14 @@ declare class AXMenuItemComponent extends NXComponent implements OnDestroy {
     private clampVerticalPosition;
     handleClick(e: MouseEvent): void;
     handleMouseEnter(event: MouseEvent): void;
-    private mouseLeaveTimeout;
     handleMouseLeave(event: MouseEvent): void;
-    /** True when the pointer moved into this item's submenu panel or a nested open submenu. */
+    private handlePointerLeave;
+    private scheduleClose;
+    private clearCloseTimeout;
+    private clearAncestorCloseTimeouts;
+    /** True when the pointer is still inside this item's submenu tree (including portaled panels). */
     private containsSubmenuPointer;
+    private isSelfOrAncestorOf;
     ngOnDestroy(): void;
     /** @ignore */
     get __hostClass(): string[];

package/types/acorex-components-number-box.d.ts

@@ -27,6 +27,7 @@ declare class AXNumberBoxComponent extends AXNumberBoxComponent_base {
     changeOnScroll: _angular_core.InputSignal<boolean>;
     step: _angular_core.InputSignal<number>;
     protected mode: _angular_core.WritableSignal<"digits" | "thousandsSeparator" | "decimal">;
+    protected decimalPlaces: _angular_core.Signal<number>;
     private input;
     protected stringValue: _angular_core.WritableSignal<string>;
     private translationService;
@@ -37,11 +38,12 @@ declare class AXNumberBoxComponent extends AXNumberBoxComponent_base {
         result: boolean;
         message?: undefined;
     }>;
-    protected internalValueChanged(value: number | undefined): void;
+    protected internalValueChanged(value: number | undefined | null): void;
     private plusValue;
     private minusValue;
     private getNumericValue;
     private getSteppedValue;
+    private formatDisplayValue;
     private clampToRange;
     private getFractionDigits;
     protected handleOnKeydownEvent(e: KeyboardEvent): void;