@acorex/core 21.0.0-next.13 → 21.0.0-next.14

package/image/index.d.ts

@@ -3,6 +3,14 @@ import * as i0 from '@angular/core';
 declare class AXImageService {
     private document;
     private platformID;
+    /**
+     * Resizes an image (File or HTMLImageElement) to fit within maxSize while preserving aspect ratio.
+     * @param options.maxSize Maximum width/height in pixels.
+     * @param options.source File or HTMLImageElement as source.
+     * @param options.type Output MIME type (default 'image/png').
+     * @param options.quality Output quality (0..1) for supported formats.
+     * @returns Promise<Blob> of the resized image.
+     */
     resize(options: {
         maxSize: number;
         source: HTMLImageElement | File;

package/locale/index.d.ts

@@ -15,12 +15,20 @@ declare module '@acorex/core/format' {
 }
 
 interface AXLocaleProfile {
+    /**
+     * Returns the locale info.
+     * @returns The locale info.
+     */
     localeInfo: {
         code: string;
         language: string;
         region: string;
         timezone: string;
     };
+    /**
+     * Returns the calendar.
+     * @returns The calendar.
+     */
     calendar: {
         system: 'gregorian' | 'solar-hijri' | string;
         week: {
@@ -31,6 +39,10 @@ interface AXLocaleProfile {
             format24Hour: boolean;
         };
     };
+    /**
+     * Returns the formats.
+     * @returns The formats.
+     */
     formats: {
         date: FormatPattern;
         time: FormatPattern;
@@ -46,6 +58,10 @@ interface AXLocaleProfile {
             postalCode: string;
         };
     };
+    /**
+     * Returns the units.
+     * @returns The units.
+     */
     units: {
         temperature: 'celsius' | 'fahrenheit';
         distance: 'kilometers' | 'miles';
@@ -55,6 +71,10 @@ interface AXLocaleProfile {
         area: 'square-meters' | 'square-feet';
         custom?: Record<string, string>;
     };
+    /**
+     * Returns the i18n meta.
+     * @returns The i18n meta.
+     */
     i18nMeta: {
         fallbackLocales?: string[];
         supportedLanguages?: string[];
@@ -82,9 +102,31 @@ declare class AXLocaleProfileProviderService {
     private resolvedCache;
     private isInitialized;
     private init;
+    /**
+     * Returns all available locale profiles by loading each registered provider.
+     *
+     * @returns Promise<AXLocaleProfile[]>
+     */
     getList(): Promise<AXLocaleProfile[]>;
+    /**
+     * Loads or returns from cache the locale profile associated with the given code.
+     *
+     * @param localeCode - The locale code to resolve.
+     * @returns Promise<AXLocaleProfile | undefined>
+     */
     getByLocale(localeCode: string): Promise<AXLocaleProfile | undefined>;
+    /**
+     * Clears caches and reloads all providers.
+     *
+     * @returns Promise<void>
+     */
     reload(): Promise<void>;
+    /**
+     * Indicates whether a loader has been registered for the given locale code.
+     *
+     * @param localeCode - The locale code to check.
+     * @returns boolean - True if a loader exists.
+     */
     has(localeCode: string): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocaleProfileProviderService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXLocaleProfileProviderService>;
@@ -108,13 +150,37 @@ declare class AXLocaleService {
     activeProfile: i0.Signal<AXLocaleProfile>;
     profileChanged$: rxjs.Observable<AXLocaleProfile>;
     private originalProfile;
+    /**
+     * Loads and activates a locale profile by its code (e.g., 'en-US', 'fa-IR').
+     *
+     * @param localeCode - Locale identifier to load.
+     * @returns Promise<void> - Resolves when the profile is loaded and activated.
+     */
     setProfile(localeCode: string): Promise<void>;
     /**
      *
      */
     constructor();
+    /**
+     * Applies overrides to the active profile using a deep-merge object.
+     *
+     * @param profile - Partial profile object whose properties override the active profile.
+     * @returns void
+     */
     apply(profile: Partial<AXLocaleProfile>): void;
+    /**
+     * Applies a single value override at the given path (dot notation).
+     *
+     * @param path - Dot-notated path (e.g., 'formats.date.short').
+     * @param value - The value to set at the path.
+     * @returns void
+     */
     apply(path: string, value: any): void;
+    /**
+     * Resets the active profile to its original loaded state (clears overrides).
+     *
+     * @returns void
+     */
     reset(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocaleService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXLocaleService>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/core",
-  "version": "21.0.0-next.13",
+  "version": "21.0.0-next.14",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
@@ -48,14 +48,14 @@
       "types": "./file/index.d.ts",
       "default": "./fesm2022/acorex-core-file.mjs"
     },
-    "./format": {
-      "types": "./format/index.d.ts",
-      "default": "./fesm2022/acorex-core-format.mjs"
-    },
     "./icon": {
       "types": "./icon/index.d.ts",
       "default": "./fesm2022/acorex-core-icon.mjs"
     },
+    "./format": {
+      "types": "./format/index.d.ts",
+      "default": "./fesm2022/acorex-core-format.mjs"
+    },
     "./image": {
       "types": "./image/index.d.ts",
       "default": "./fesm2022/acorex-core-image.mjs"
@@ -72,14 +72,14 @@
       "types": "./network/index.d.ts",
       "default": "./fesm2022/acorex-core-network.mjs"
     },
-    "./pipes": {
-      "types": "./pipes/index.d.ts",
-      "default": "./fesm2022/acorex-core-pipes.mjs"
-    },
     "./platform": {
       "types": "./platform/index.d.ts",
       "default": "./fesm2022/acorex-core-platform.mjs"
     },
+    "./pipes": {
+      "types": "./pipes/index.d.ts",
+      "default": "./fesm2022/acorex-core-pipes.mjs"
+    },
     "./storage": {
       "types": "./storage/index.d.ts",
       "default": "./fesm2022/acorex-core-storage.mjs"

package/pipes/index.d.ts

@@ -4,6 +4,12 @@ import { DomSanitizer, SafeHtml, SafeStyle, SafeScript, SafeUrl, SafeResourceUrl
 
 declare class AXSafePipe implements PipeTransform {
     protected sanitizer: DomSanitizer;
+    /**
+     * Marks values as safe for Angular binding via DomSanitizer.
+     * @param value The value to sanitize.
+     * @param type One of 'html' | 'style' | 'script' | 'url' | 'resourceUrl'.
+     * @throws Error when type is invalid.
+     */
     transform(value: any, type: string): SafeHtml | SafeStyle | SafeScript | SafeUrl | SafeResourceUrl;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXSafePipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<AXSafePipe, "safe", true>;

package/platform/index.d.ts

@@ -59,12 +59,33 @@ declare class AXPlatform {
     isRtl(): boolean;
     isLandscape(): boolean;
     isPortrate(): boolean;
+    /**
+     * Checks whether the current environment matches the given platform/browser/technology/screen size keyword.
+     *
+     * @param name - One of AXPlatforms | AXBrowsers | AXTechnologies | AXScreenSizes.
+     */
     is(name: AXPlatforms | AXBrowsers | AXTechnologies | AXScreenSizes): boolean;
     get screenSize(): AXScreenSizes;
+    /**
+     * Switches to light mode and persists it.
+     * @returns 'light'
+     */
     switchLightMode(): string;
+    /**
+     * Switches to dark mode and persists it.
+     * @returns 'dark'
+     */
     switchDarkMode(): string;
     switchSystemMode(): void;
+    /**
+     * Reads persisted theme preference and applies it (returns the effective mode).
+     * @returns AXThemeMode
+     */
     autoDetectThemeMode(): "light" | "dark" | "system";
+    /**
+     * Sets theme mode explicitly and persists it.
+     * @param mode - Desired theme mode.
+     */
     setThemeMode(mode: AXThemeMode): void;
     private setFullHeightRatio;
     private autoSystemModeDetection;

package/storage/index.d.ts

@@ -122,11 +122,42 @@ declare class AXCookieStorageService {
 declare const AX_LOCALSTORAGE_SECRET_KEY: InjectionToken<string>;
 declare class AXLocalStorageService implements AXStorage {
     private secret_key;
+    /**
+     * Reads a value from localStorage and parses JSON.
+     *
+     * @param key - Storage key
+     * @returns T | null
+     */
     get<T = unknown>(key: string): T;
+    /**
+     * Writes a JSON-serialized value to localStorage.
+     *
+     * @param key - Storage key
+     * @param value - Value to persist
+     */
     set<T = unknown>(key: string, value: T): void;
     clear(): void;
+    /**
+     * Removes a single entry by key from localStorage.
+     *
+     * @param key - Storage key
+     */
     removeItem(key: string): void;
+    /**
+     * Encrypts the JSON-serialized value using AES and stores it.
+     * Requires providing AX_LOCALSTORAGE_SECRET_KEY.
+     *
+     * @param key - Storage key
+     * @param value - Value to encrypt and store
+     */
     setWithEncryption<T = unknown>(key: string, value: T): void;
+    /**
+     * Reads the encrypted value, decrypts it using AES and parses JSON.
+     * Requires providing AX_LOCALSTORAGE_SECRET_KEY.
+     *
+     * @param key - Storage key
+     * @returns T | null
+     */
     getWithEncription<T = unknown>(key: string): T;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLocalStorageService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXLocalStorageService>;

package/validation/index.d.ts

@@ -230,6 +230,10 @@ declare class AXValidationRegistryService {
 declare class AXValidationService {
     private translationService;
     private pluginRegistry;
+    /**
+     * Validates a value with optional options.
+     * @returns Promise<AXValidationRuleResult>
+     */
     validate(ruleName: string, value: unknown, options?: AXValidationRuleOptions): Promise<AXValidationRuleResult>;
     ruleFor(value: unknown): AXValidationRuleChain;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXValidationService, never>;