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

package/types/acorex-core-file.d.ts

@@ -28,7 +28,7 @@ declare class AXFileSizeFormatter implements AXFormatter {
      */
     format(value: number): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileSizeFormatter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileSizeFormatter>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Human-readable file size (binary units, e.g. `41.5 MB`). */
@@ -236,6 +236,7 @@ declare class AXFileTypeRendererOutletComponent {
     readonly resolvedComponent: i0.WritableSignal<Type<unknown>>;
     readonly loading: i0.WritableSignal<boolean>;
     readonly mergedInputs: i0.WritableSignal<Record<string, unknown>>;
+    private loadId;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileTypeRendererOutletComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AXFileTypeRendererOutletComponent, "ax-file-type-renderer", never, { "fileType": { "alias": "fileType"; "required": true; "isSignal": true; }; "payload": { "alias": "payload"; "required": true; "isSignal": true; }; "extensionHint": { "alias": "extensionHint"; "required": false; "isSignal": true; }; "inputs": { "alias": "inputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -276,7 +277,7 @@ declare class AXFileTypeRegistryService {
         }[];
     }>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileTypeRegistryService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileTypeRegistryService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Merges type-level validations with extension overrides (extension wins per field). */
@@ -304,7 +305,7 @@ declare const AX_AUDIO_FILE_TYPE: AXFileType;
 declare class AXAudioFileTypeProvider extends AXFileTypeInfoProvider {
     items(): Promise<AXFileType[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXAudioFileTypeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXAudioFileTypeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Extension-only: no type `validations` — only listed extensions are allowed. */
@@ -312,28 +313,28 @@ declare const AX_DOCUMENT_FILE_TYPE: AXFileType;
 declare class AXDocumentFileTypeProvider extends AXFileTypeInfoProvider {
     items(): Promise<AXFileType[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXDocumentFileTypeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXDocumentFileTypeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare const AX_FILE_FILE_TYPE: AXFileType;
 declare class AXFileFileTypeProvider extends AXFileTypeInfoProvider {
     items(): Promise<AXFileType[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileFileTypeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileFileTypeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare const AX_IMAGE_FILE_TYPE: AXFileType;
 declare class AXImageFileTypeProvider extends AXFileTypeInfoProvider {
     items(): Promise<AXFileType[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXImageFileTypeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXImageFileTypeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare const AX_VIDEO_FILE_TYPE: AXFileType;
 declare class AXVideoFileTypeProvider extends AXFileTypeInfoProvider {
     items(): Promise<AXFileType[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXVideoFileTypeProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXVideoFileTypeProvider>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Built-in file type provider classes (one logical type per provider). */
@@ -357,7 +358,7 @@ declare class AXFileMimeTypeValidationRule implements AXValidationRule {
     validate(value: File | Blob, options: AXFileMimeTypeValidationRuleOptions): Promise<AXValidationRuleResult>;
     private matchesMime;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileMimeTypeValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileMimeTypeValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXFileMinSizeValidationRuleOptions extends AXValidationRuleOptions {
@@ -373,7 +374,7 @@ declare class AXFileMinSizeValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: File | Blob, options: AXFileMinSizeValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileMinSizeValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileMinSizeValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXFileMaxSizeValidationRuleOptions extends AXValidationRuleOptions {
@@ -389,7 +390,7 @@ declare class AXFileMaxSizeValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: File | Blob, options: AXFileMaxSizeValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileMaxSizeValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileMaxSizeValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 /** Validation rule classes to register with {@link AXValidationModule}. */
@@ -462,7 +463,7 @@ declare class AXFileService {
     private resolveChooseOptions;
     private openFileDialog;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFileService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXAudioFileTypeProvider, AXDocumentFileTypeProvider, AXFileFileTypeProvider, AXFileMaxSizeValidationRule, AXFileMimeTypeValidationRule, AXFileMinSizeValidationRule, AXFileModule, AXFileService, AXFileSizeFormatter, AXFileTypeInfoProvider, AXFileTypeRegistryService, AXFileTypeRendererOutletComponent, AXImageFileTypeProvider, AXVideoFileTypeProvider, AX_AUDIO_FILE_TYPE, AX_BUILTIN_FILE_TYPE_PROVIDERS, AX_DOCUMENT_FILE_TYPE, AX_FILE_FILE_TYPE, AX_FILE_TYPE_INFO_PROVIDER, AX_FILE_TYPE_METADATA_PURPOSE, AX_FILE_VALIDATION_RULES, AX_IMAGE_FILE_TYPE, AX_VIDEO_FILE_TYPE, createFileTypeMetadata, defineFileType, ensureFileValidationRules, fileTypeMatchesPurpose, fileValidationsToRules, filterFileTypesByPurpose, findFileTypeExtension, findFileTypeExtensionByName, findFileTypeExtensionForMime, formatFileSizeBytes, getFileExtension, getFileTypePurposes, isEmptyFileValidations, isExtensionsOnlyType, isLazyFileTypeComponentLoader, loadFileTypeComponent, matchesFileMime, mergeFileValidations, provideBuiltinFileTypeProviders, provideDefaultFileTypeProviders, provideFileTypeInfoProvider, provideFileTypeSystem, provideFileTypes, provideFileValidationRules, resolveFileCopyText, resolveFileTypeComponent, resolveFileTypeComponentType, resolveFileTypeCopy, resolveFileTypeExtension, resolveFileTypeOpen, resolveFileTypePaste, resolveFileTypeUtility, resolveFileValidations, runFileTypeCopy, runFileTypeOpen, runFileTypeUtility, runFileTypeUtilityForFile, validateFileAgainstType, validateFileWithValidations };

package/types/acorex-core-format.d.ts

@@ -90,7 +90,7 @@ declare class AXFormatterRegistryService {
      */
     get(name: string): AXFormatter;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFormatterRegistryService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFormatterRegistryService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 declare class AXFormatService {
     private pluginRegistry;
@@ -119,7 +119,7 @@ declare class AXFormatService {
      */
     format(value: unknown): AXFormatFluent;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXFormatService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFormatService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 declare class AXFormatFluent {
     private formatService;
@@ -153,7 +153,7 @@ declare class AXNumberFormatter implements AXFormatter {
     format(value: number, options: AXNumberFormatterOptions): string;
     private getLocaleSeparators;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXNumberFormatter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXNumberFormatter>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXStringFormatterOptions extends AXFormatOptions {

package/types/acorex-core-full-screen.d.ts

@@ -1,53 +1,102 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 
+/**
+ * Fullscreen implementation mode.
+ * - `overlay`: CSS fixed container that covers the viewport.
+ * - `browser`: Native Fullscreen API via `element.requestFullscreen()`.
+ */
+type AXFullScreenMode = 'overlay' | 'browser';
 declare class AXFullScreenService {
     private readonly zIndexService;
+    private readonly document;
+    private readonly platformId;
+    private readonly destroyRef;
     /**
-     * Current fullscreen state
+     * Current fullscreen state.
      */
     private readonly isFullscreenState;
     /**
-     * Original element styles to restore
+     * Active fullscreen element.
+     */
+    private readonly activeElementState;
+    /**
+     * Active fullscreen mode.
+     */
+    private currentMode;
+    /**
+     * Original element styles to restore (overlay mode).
      */
     private originalStyles;
     /**
-     * Original parent element reference
+     * Original parent element reference (overlay mode).
      */
     private originalParent;
     /**
-     * Fullscreen container element
+     * Original next sibling so overlay restore keeps DOM order (overlay mode).
+     */
+    private originalNextSibling;
+    /**
+     * Fullscreen container element (overlay mode).
      */
     private fullscreenContainer;
     /**
-     * Z-index token for this fullscreen instance
+     * Z-index token for overlay fullscreen.
      */
     private zToken;
+    private readonly fullscreenChangeHandler;
+    constructor();
     /**
-     * Toggle fullscreen state
+     * Toggle fullscreen state.
      */
-    toggle(element: HTMLElement): void;
+    toggle(element: HTMLElement, mode?: AXFullScreenMode): void;
     /**
-     * Enter fullscreen mode
+     * Enter fullscreen mode.
      */
-    enter(element: HTMLElement): void;
+    enter(element: HTMLElement, mode?: AXFullScreenMode): void;
     /**
-     * Exit fullscreen mode
+     * Exit fullscreen mode.
      */
-    exit(element: HTMLElement): void;
+    exit(element?: HTMLElement): void;
     /**
-     * Check fullscreen state
+     * Check whether any element is in fullscreen mode.
      */
     isFullscreen(): boolean;
     /**
-     * Store original computed styles
+     * Read-only signal of the active fullscreen element.
      */
-    private storeOriginalStyles;
+    readonly activeElement: _angular_core.Signal<HTMLElement>;
     /**
-     * Restore original styles
+     * Read-only signal of the fullscreen state.
      */
+    readonly fullscreen: _angular_core.Signal<boolean>;
+    /**
+     * Check whether the given element is the active fullscreen element.
+     */
+    isActive(element: HTMLElement): boolean;
+    /**
+     * Returns the currently active fullscreen element, if any.
+     */
+    getActiveElement(): HTMLElement | null;
+    /**
+     * Returns the active fullscreen mode, if any.
+     */
+    getActiveMode(): AXFullScreenMode | null;
+    private enterOverlay;
+    private exitOverlay;
+    private enterBrowser;
+    private exitBrowser;
+    private clearBrowserState;
+    private clearActiveState;
+    private cleanupOverlayResources;
+    private restoreOriginalPosition;
+    private getFullscreenElement;
+    private getRequestFullscreen;
+    private getExitFullscreen;
+    private storeOriginalStyles;
     private restoreOriginalStyles;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFullScreenService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFullScreenService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXFullScreenService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXFullScreenService };
+export type { AXFullScreenMode };

package/types/acorex-core-icon.d.ts

@@ -6,7 +6,7 @@ declare class AXIconResolverService {
     private cache;
     resolve(icon: string): Promise<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXIconResolverService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXIconResolverService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare abstract class AXIconResolver {

package/types/acorex-core-image.d.ts

@@ -18,7 +18,7 @@ declare class AXImageService {
         quality?: number;
     }): Promise<Blob>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXImageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXImageService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXImageService };

package/types/acorex-core-locale.d.ts

@@ -34,6 +34,8 @@ interface AXLocaleProfile {
         week: {
             startsOn: number;
             weekends: number[];
+            /** Number of characters shown for weekday headers in calendar views (e.g. 1 for fa, 2 for en). */
+            weekdayLabelLength: number;
         };
         clock: {
             format24Hour: boolean;
@@ -129,7 +131,7 @@ declare class AXLocaleProfileProviderService {
      */
     has(localeCode: string): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocaleProfileProviderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXLocaleProfileProviderService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXLocaleConfig {
@@ -188,7 +190,7 @@ declare class AXLocaleService {
      */
     reset(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocaleService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXLocaleService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare const AXUSLocaleProfile: AXLocaleProfile;

package/types/acorex-core-network.d.ts

@@ -62,7 +62,7 @@ declare class AXNetworkService {
     download(url: string): AXDownloadTask;
     download(request: HttpRequest<Blob>): AXDownloadTask;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXNetworkService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXNetworkService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXDownloadStatus, AXDownloadTask, AXNetworkService, AXUploadStatus, AXUploadTask };

package/types/acorex-core-platform.d.ts

@@ -96,7 +96,7 @@ declare class AXPlatform {
     private detectScrollEvent;
     private detectDocumentDirectionChange;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPlatform, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPlatform>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXPlatform, AXPlatformEvent, PLATFORMS_MAP, is2XLScreen, is3XLScreen, is4XLScreen, isAndroid, isAndroidTablet, isBrowser, isCapacitorNative, isChrome, isCordova, isDesktop, isEdge, isElectron, isFirefox, isHybrid, isIOS, isIpad, isIphone, isLGScreen, isMDScreen, isMSIE, isMobile, isMobileWeb, isOpera, isPWA, isPhablet, isSMScreen, isSafari, isServer, isTablet, isTouch, isXLScreen, matchMedia, testUserAgent };

package/types/acorex-core-storage.d.ts

@@ -116,7 +116,7 @@ declare class AXCookieStorageService {
      */
     deleteAll(path?: AXCookieOptions['path'], domain?: AXCookieOptions['domain'], secure?: AXCookieOptions['secure'], sameSite?: AXSameSite): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXCookieStorageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXCookieStorageService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare const AX_LOCALSTORAGE_SECRET_KEY: InjectionToken<string>;
@@ -160,7 +160,7 @@ declare class AXLocalStorageService implements AXStorage {
      */
     getWithEncription<T = unknown>(key: string): T;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocalStorageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXLocalStorageService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare class AXSessionStorageService implements AXStorage {
@@ -169,7 +169,7 @@ declare class AXSessionStorageService implements AXStorage {
     clear(): void;
     removeItem(key: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXSessionStorageService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXSessionStorageService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXCookieStorageService, AXLocalStorageService, AXSessionStorageService, AX_LOCALSTORAGE_SECRET_KEY };

package/types/acorex-core-theme-builder.d.ts

@@ -0,0 +1,42 @@
+type AXThemeBuilderColors = 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'surface' | 'accent' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6';
+type AXThemeBuilderColorVariants = '50' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900' | '950' | 'on' | 'on-contrast';
+type AXThemeBuilderPalette = Record<AXThemeBuilderColors, Record<AXThemeBuilderColorVariants, string>>;
+type AXThemeBuilderFullPalette = {
+    light: AXThemeBuilderPalette;
+    dark: AXThemeBuilderPalette;
+};
+type AXThemeBuilderBaseColors = {
+    light: Record<AXThemeBuilderColors, string>;
+    dark: Record<AXThemeBuilderColors, string>;
+};
+
+type AXThemeColors = Partial<Record<AXThemeBuilderColors, string>>;
+interface AXCreateThemeOptions {
+    /** 'file' (default) emits a complete stylesheet with :root/.ax-dark plus the Tailwind layer.
+     *  'preview' emits variables only, scoped to `scope`, for injecting into a live page. */
+    target?: 'file' | 'preview';
+    /** Selectors used when target is 'preview'. */
+    scope?: {
+        light: string;
+        dark: string;
+    };
+    /** Roles to emit when target is 'preview'. Defaults to all roles. */
+    roles?: AXThemeBuilderColors[];
+}
+interface AXTheme {
+    /** The generated CSS. */
+    css: string;
+    /** Generated shade scales per role, for both modes. */
+    palette: AXThemeBuilderFullPalette;
+}
+/**
+ * Creates an ACoreX theme from a flat map of role seed colors.
+ *
+ * Each provided color is applied to both light and dark modes; dark shades are
+ * derived via the dark-palette tone mapping. Omitted roles fall back to the
+ * packaged default seeds (which may differ per mode for `secondary`, `danger`, and `surface`).
+ */
+declare function createTheme(colors?: AXThemeColors, options?: AXCreateThemeOptions): AXTheme;
+
+export { createTheme };
+export type { AXCreateThemeOptions, AXTheme, AXThemeBuilderBaseColors, AXThemeBuilderColorVariants, AXThemeBuilderColors, AXThemeBuilderFullPalette, AXThemeBuilderPalette, AXThemeColors };

package/types/acorex-core-translation.d.ts

@@ -1,10 +1,8 @@
-import { ResolveFn } from '@angular/router';
 import * as i0 from '@angular/core';
-import { InjectionToken, PipeTransform, OnInit } from '@angular/core';
+import { Signal, InjectionToken, PipeTransform, OnInit } from '@angular/core';
+import { ResolveFn } from '@angular/router';
 import { Observable } from 'rxjs';
 
-declare const loadTranslationScope: ResolveFn<unknown>;
-
 type AXTranslateHashMap<T = unknown> = Record<string, T>;
 type AXTranslateLang = string;
 type AXTranslateScope = string;
@@ -41,6 +39,14 @@ declare function createMultiLanguageString(enUs: string, faIr: string): AXMultiL
  */
 declare function isEffectivelyEmptyLocalizedValue(value: unknown): boolean;
 
+/**
+ * Creates a signal that mirrors a string source signal, translating its value whenever
+ * the source or active language changes.
+ */
+declare function toTranslatedSignal(source: Signal<string | null | undefined>, options?: AXTranslateOptions): Signal<string>;
+
+declare const loadTranslationScope: ResolveFn<unknown>;
+
 interface AXTranslationConfig {
     defaults: {
         lang: AXTranslateLang;
@@ -135,8 +141,8 @@ declare class AXTranslationService {
     private resolveContext;
     isValidMultiLanguageObject(value: unknown): value is AXMultiLanguageMap;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXTranslationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXTranslationService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
-export { AXTranslationDefaultConfig, AXTranslationLoaderDefault, AXTranslationModule, AXTranslationService, AXTranslatorDirective, AXTranslatorPipe, AX_TRANSLATION_CONFIG, AX_TRANSLATION_LOADER, LOCALE_KEY_REGEX, createMultiLanguageString, isEffectivelyEmptyLocalizedValue, isValidMultiLanguageObject, loadTranslationScope, resolveMultiLanguageString, resolveMultiLanguageValue, translateSync, translationConfig };
+export { AXTranslationDefaultConfig, AXTranslationLoaderDefault, AXTranslationModule, AXTranslationService, AXTranslatorDirective, AXTranslatorPipe, AX_TRANSLATION_CONFIG, AX_TRANSLATION_LOADER, LOCALE_KEY_REGEX, createMultiLanguageString, isEffectivelyEmptyLocalizedValue, isValidMultiLanguageObject, loadTranslationScope, resolveMultiLanguageString, resolveMultiLanguageValue, toTranslatedSignal, translateSync, translationConfig };
 export type { AXMultiLanguageMap, AXMultiLanguageString, AXParsedToken, AXPartialTranslationConfig, AXTranslateHashMap, AXTranslateLang, AXTranslateOptions, AXTranslateParams, AXTranslateScope, AXTranslation, AXTranslationConfig, AXTranslationLoader, AXTranslationLoaderOptions };

package/types/acorex-core-utils.d.ts

@@ -83,32 +83,70 @@ declare function debounceAsync<T extends (...args: any[]) => Promise<any>>(fn: T
  */
 declare function fallbackChain<T>(tasks: Array<() => Promise<T>>): Promise<T>;
 
+type AXHighlightTarget = string | Element | readonly Element[];
+interface AXHighlightOptions {
+    /** When false (default), matching is case-insensitive. */
+    caseSensitive?: boolean;
+    /** When true, only match whole words. */
+    wholeWord?: boolean;
+    /** Maximum number of matches to highlight across all targets. */
+    maxMatches?: number;
+    /** CSS class applied to highlighted match spans. */
+    highlightClass?: string;
+    /** CSS class applied to the wrapper span around highlighted text nodes. */
+    wrapperClass?: string;
+    /** Parent tag names whose text content is skipped. */
+    ignoredTags?: readonly string[];
+}
 /**
  * Service for applying and resetting text highlighting within specified HTML elements.
  */
 declare class AXHighlightService {
-    private querySelector;
-    private searchValue;
+    private readonly document;
+    private readonly platformId;
+    private readonly selectorStates;
+    private readonly elementStates;
+    private readonly trackedElements;
     /**
-     * Highlights all occurrences of a search value within the elements matching the provided query selector.
+     * Highlights all occurrences of a search value within the elements matching the provided target.
      *
-     * @param querySelector - CSS selector to identify target elements.
-     * @param searchValue - Text to search and highlight.
+     * @param target - CSS selector, a single element, or an array of elements to search within.
+     * @param term - Text or list of texts to search and highlight.
+     * @param options - Optional highlight behavior configuration.
+     * @returns The number of matches highlighted.
      */
-    highlight(querySelector: string, searchValue: string): void;
+    highlight(target: AXHighlightTarget, term: string | readonly string[], options?: AXHighlightOptions): number;
     /**
-     * Resets highlighted text within the elements matching the query selector.
+     * Resets highlighted text within the elements matching the target.
+     * When no target is provided, clears all highlights registered by this service.
      *
-     * @param querySelector - CSS selector to clear. Falls back to the last selector used by `highlight`.
+     * @param target - CSS selector, element, or elements to clear.
      */
-    clear(querySelector?: string): void;
+    clear(target?: AXHighlightTarget): void;
+    private toElementArray;
+    private normalizeTerms;
+    private resolveOptions;
+    private registerState;
+    private resolveRoots;
     private createSearchRegex;
-    private applyHighlight;
-    private recursivelyHighlight;
-    private createHighlightedHTML;
+    private collectTextNodes;
+    private highlightTextNode;
+    private clearSelector;
+    private clearElement;
+    private unwrapHighlight;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXHighlightService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXHighlightService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+interface AXHighlightSegment {
+    text: string;
+    match: boolean;
 }
+/**
+ * Splits text into highlighted and non-highlighted segments for template rendering.
+ * Uses the same matching semantics as {@link AXHighlightService}.
+ */
+declare function splitHighlightSegments(text: string, term: string | readonly string[], options?: AXHighlightOptions): AXHighlightSegment[];
 
 /** ACoreX layout size classes applied on a host or container. */
 declare const AX_SIZE_CLASSES: readonly ["ax-xs", "ax-sm", "ax-md", "ax-lg", "ax-xl"];
@@ -141,7 +179,7 @@ declare class AXUnsubscriber implements OnDestroy {
     unsubscribe(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXUnsubscriber, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXUnsubscriber>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 declare function getWordBoundsAtPosition(str: string, position: number): {
@@ -149,5 +187,5 @@ declare function getWordBoundsAtPosition(str: string, position: number): {
     end: number;
 };
 
-export { AXAutoUnsubscriber, AXColorUtil, AXDrawingUtil, AXHighlightService, AXHtmlUtil, AXUnsubscriber, AX_SIZE_CLASSES, debounceAsync, delay, fallbackChain, getWordBoundsAtPosition, pollUntil, pollUntilAbortable, retryUntil, throttleAsync, waitFor };
-export type { AXBoundingClientRect, AXClosestAxSizeMatch, AXColorFormat, AXColorMode, AXPoint, AXSizeClass };
+export { AXAutoUnsubscriber, AXColorUtil, AXDrawingUtil, AXHighlightService, AXHtmlUtil, AXUnsubscriber, AX_SIZE_CLASSES, debounceAsync, delay, fallbackChain, getWordBoundsAtPosition, pollUntil, pollUntilAbortable, retryUntil, splitHighlightSegments, throttleAsync, waitFor };
+export type { AXBoundingClientRect, AXClosestAxSizeMatch, AXColorFormat, AXColorMode, AXHighlightOptions, AXHighlightSegment, AXHighlightTarget, AXPoint, AXSizeClass };

package/types/acorex-core-validation.d.ts

@@ -43,7 +43,7 @@ declare class AXCallbackValidationRule<T> implements AXValidationRule {
     get name(): string;
     validate(value: T, options: AXCallbackValidationRuleOptions<T>): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXCallbackValidationRule<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXCallbackValidationRule<any>>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXRegexValidationRuleOptions extends AXValidationRuleOptions {
@@ -59,7 +59,7 @@ declare class AXRegexValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: string, options: AXRegexValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRegexValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXRegexValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXRequiredValidationRuleOptions extends AXValidationRuleOptions {
@@ -74,7 +74,7 @@ declare class AXRequiredValidationRule implements AXValidationRule {
     get name(): string;
     validate(value?: unknown, options?: AXRequiredValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXRequiredValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXRequiredValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXLengthValidationRuleOptions extends AXValidationRuleOptions {
@@ -90,7 +90,7 @@ declare class AXLengthValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: string, options: AXLengthValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLengthValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXLengthValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXMaxLengthValidationRuleOptions extends AXValidationRuleOptions {
@@ -105,7 +105,7 @@ declare class AXMaxLengthValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: string, options: AXMaxLengthValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMaxLengthValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMaxLengthValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXMinLengthValidationRuleOptions extends AXValidationRuleOptions {
@@ -120,7 +120,7 @@ declare class AXMinLengthValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: string, options: AXMinLengthValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMinLengthValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMinLengthValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXBetweenValidationRuleOptions<T = number | Date> extends AXValidationRuleOptions {
@@ -137,7 +137,7 @@ declare class AXBetweenValidationRule<T = number | Date> implements AXValidation
     get name(): string;
     validate(value: T, options: AXBetweenValidationRuleOptions<T>): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXBetweenValidationRule<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXBetweenValidationRule<any>>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXEqualValidationRuleOptions extends AXValidationRuleOptions {
@@ -153,7 +153,7 @@ declare class AXEqualValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: any, options: AXEqualValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXEqualValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXEqualValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXGreaterThanValidationRuleOptions extends AXValidationRuleOptions {
@@ -169,7 +169,7 @@ declare class AXGreaterThanValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: number, options: AXGreaterThanValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXGreaterThanValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXGreaterThanValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXLessThanValidationRuleOptions extends AXValidationRuleOptions {
@@ -185,7 +185,7 @@ declare class AXLessThanValidationRule implements AXValidationRule {
     get name(): string;
     validate(value: number, options: AXLessThanValidationRuleOptions): Promise<AXValidationRuleResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLessThanValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXLessThanValidationRule>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 type AXValidationConfigRules = {
@@ -225,7 +225,7 @@ declare class AXValidationRegistryService {
     register(...plugins: (new () => AXValidationRule)[]): void;
     get(ruleName: string): AXValidationRule | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXValidationRegistryService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXValidationRegistryService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 declare class AXValidationService {
     private translationService;
@@ -237,7 +237,7 @@ declare class AXValidationService {
     validate(ruleName: string, value: unknown, options?: AXValidationRuleOptions): Promise<AXValidationRuleResult>;
     ruleFor(value: unknown): AXValidationRuleChain;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXValidationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXValidationService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 declare class AXValidationRuleChain {
     private validationService;

package/types/acorex-core-z-index.d.ts

@@ -14,7 +14,7 @@ declare class AXZIndexService {
     bringToFront(token: AXZToken): AXZToken;
     lastIndex(): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXZIndexService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXZIndexService>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXZIndexService };