@acorex/core 21.0.2-next.24 → 21.0.2-next.25

package/{utils/index.d.ts → types/acorex-core-utils.d.ts}

@@ -83,6 +83,14 @@ declare function debounceAsync<T extends (...args: any[]) => Promise<any>>(fn: T
  */
 declare function fallbackChain<T>(tasks: Array<() => Promise<T>>): Promise<T>;
 
+/** 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"];
+type AXSizeClass = (typeof AX_SIZE_CLASSES)[number];
+/** Resolved ACoreX size: the DOM node that carries the token and the token itself. */
+interface AXClosestAxSizeMatch {
+    element: HTMLElement;
+    sizeClass: AXSizeClass;
+}
 declare class AXHtmlUtil {
     static focusElement(element: HTMLElement): HTMLElement;
     static blurElement(element: HTMLElement): HTMLElement;
@@ -114,5 +122,5 @@ declare function getWordBoundsAtPosition(str: string, position: number): {
     end: number;
 };
 
-export { AXAutoUnsubscriber, AXColorUtil, AXDrawingUtil, AXHtmlUtil, AXUnsubscriber, debounceAsync, delay, fallbackChain, getWordBoundsAtPosition, pollUntil, pollUntilAbortable, retryUntil, throttleAsync, waitFor };
-export type { AXBoundingClientRect, AXColorFormat, AXColorMode, AXPoint };
+export { AXAutoUnsubscriber, AXColorUtil, AXDrawingUtil, AXHtmlUtil, AXUnsubscriber, AX_SIZE_CLASSES, debounceAsync, delay, fallbackChain, getWordBoundsAtPosition, pollUntil, pollUntilAbortable, retryUntil, throttleAsync, waitFor };
+export type { AXBoundingClientRect, AXClosestAxSizeMatch, AXColorFormat, AXColorMode, AXPoint, AXSizeClass };

package/{validation/index.d.ts → types/acorex-core-validation.d.ts}

@@ -34,7 +34,7 @@ type AXCallbackValidation<T> = (value: T, options?: AXCallbackValidationRuleOpti
 interface AXCallbackValidationRuleOptions<T> extends AXValidationRuleOptions {
     validate: AXCallbackValidation<T>;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         callback: AXCallbackValidationRuleOptions<unknown>;
     }
@@ -49,7 +49,7 @@ declare class AXCallbackValidationRule<T> implements AXValidationRule {
 interface AXRegexValidationRuleOptions extends AXValidationRuleOptions {
     pattern: string | RegExp;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         regex: AXRegexValidationRuleOptions;
     }
@@ -64,7 +64,7 @@ declare class AXRegexValidationRule implements AXValidationRule {
 
 interface AXRequiredValidationRuleOptions extends AXValidationRuleOptions {
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         required: AXRequiredValidationRuleOptions;
     }
@@ -81,7 +81,7 @@ interface AXLengthValidationRuleOptions extends AXValidationRuleOptions {
     min: number;
     max: number;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         length: AXLengthValidationRuleOptions;
     }
@@ -96,7 +96,7 @@ declare class AXLengthValidationRule implements AXValidationRule {
 interface AXMaxLengthValidationRuleOptions extends AXValidationRuleOptions {
     value: number;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         maxLength: AXMaxLengthValidationRuleOptions;
     }
@@ -111,7 +111,7 @@ declare class AXMaxLengthValidationRule implements AXValidationRule {
 interface AXMinLengthValidationRuleOptions extends AXValidationRuleOptions {
     value: number;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         minLength: AXMinLengthValidationRuleOptions;
     }
@@ -128,7 +128,7 @@ interface AXBetweenValidationRuleOptions<T = number | Date> extends AXValidation
     upperValue: T;
     inclusive?: boolean;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         between: AXBetweenValidationRuleOptions;
     }
@@ -144,7 +144,7 @@ interface AXEqualValidationRuleOptions extends AXValidationRuleOptions {
     value: any;
     not?: boolean;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         equal: AXEqualValidationRuleOptions;
     }
@@ -160,7 +160,7 @@ interface AXGreaterThanValidationRuleOptions extends AXValidationRuleOptions {
     value: number;
     inclusive?: boolean;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         greaterThan: AXGreaterThanValidationRuleOptions;
     }
@@ -176,7 +176,7 @@ interface AXLessThanValidationRuleOptions extends AXValidationRuleOptions {
     value: number;
     inclusive?: boolean;
 }
-declare module "./index" {
+declare module "./acorex-core-validation" {
     interface AXValidationRuleOptionsMap {
         lessThan: AXLessThanValidationRuleOptions;
     }

package/file/index.d.ts

@@ -1,321 +0,0 @@
-import * as i1 from '@acorex/core/format';
-import { AXFormatOptions, AXFormatter } from '@acorex/core/format';
-import * as i0 from '@angular/core';
-import { InjectionToken, Type, Provider, ModuleWithProviders } from '@angular/core';
-import * as i2 from '@acorex/core/validation';
-import { AXValidationRuleOptions, AXValidationRuleResult, AXValidationService, AXValidationRule } from '@acorex/core/validation';
-
-interface AXFileSizeFormatterOptions extends AXFormatOptions {
-    format: string;
-}
-declare module '@acorex/core/format' {
-    interface AXFormatOptionsMap {
-        filesize: AXFileSizeFormatterOptions;
-    }
-}
-declare class AXFileSizeFormatter implements AXFormatter {
-    /**
-     * Gets the name of the formatter.
-     *
-     * @returns string - The formatter name 'filesize'
-     */
-    get name(): string;
-    /**
-     * Formats a file size value to human-readable format.
-     *
-     * @param value - The file size in bytes
-     * @returns string - The formatted file size string (e.g., '1.5 MB')
-     */
-    format(value: number): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFileSizeFormatter, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileSizeFormatter>;
-}
-
-/** Human-readable file size (binary units, e.g. `41.5 MB`). */
-declare function formatFileSizeBytes(bytes: number): string;
-
-/** Generic rule executed via {@link AXValidationService}. */
-interface AXFileValidationRule {
-    rule: string;
-    options?: AXValidationRuleOptions;
-}
-/**
- * Common file constraints shared by {@link AXFileType} and {@link AXFileTypeExtension}.
- * Extension `validations` are partial and override the parent type field-by-field.
- */
-interface AXFileValidations {
-    mimeTypes?: string[];
-    minSize?: number;
-    maxSize?: number;
-    rules?: AXFileValidationRule[];
-}
-/** Extension entry; `validations` override the parent {@link AXFileType.validations}. */
-interface AXFileTypeExtension {
-    name: string;
-    title?: string;
-    icon?: string;
-    validations?: Partial<AXFileValidations>;
-}
-/** Context passed to {@link AXFileType.utilities} handlers. */
-interface AXFileTypeUtilitiesContext {
-    readAsDataUrl: (file: File | Blob) => Promise<string>;
-    /** Angular `PLATFORM_ID` or similar for browser-only APIs. */
-    platformId: object;
-}
-/**
- * Named utility handler. Each file type only registers the keys it supports
- * (e.g. image: `preview`; video: `preview`, `duration`).
- */
-type AXFileTypeUtility = (ctx: AXFileTypeUtilitiesContext, ...args: unknown[]) => Promise<unknown> | unknown;
-/**
- * Logical file category (image, video, …).
- *
- * - With type `validations` set: any file matching those rules is allowed; `extensions` only override when matched.
- * - With empty / omitted `validations` and `extensions` listed: only those extensions are allowed.
- */
-interface AXFileType {
-    name: string;
-    title?: string;
-    icon?: string;
-    validations?: AXFileValidations;
-    extensions?: AXFileTypeExtension[];
-    /** Named helpers; only define keys this type supports. */
-    utilities?: Record<string, AXFileTypeUtility>;
-}
-
-/** Well-known utility keys (optional per {@link AXFileType}). */
-declare const AX_FILE_TYPE_UTILITY: {
-    readonly preview: "preview";
-    readonly duration: "duration";
-    readonly formatSize: "formatSize";
-    readonly formatDuration: "formatDuration";
-    readonly createLocalPreviewUrl: "createLocalPreviewUrl";
-    /** Resolves catalog name for mixed file-picker rows. */
-    readonly pickerCatalog: "pickerCatalog";
-};
-type AXFileTypeUtilityName = (typeof AX_FILE_TYPE_UTILITY)[keyof typeof AX_FILE_TYPE_UTILITY];
-declare function createFileTypeUtilitiesContext(readAsDataUrl: (file: File | Blob) => Promise<string>, platformId: object): AXFileTypeUtilitiesContext;
-declare function hasFileTypeUtility(fileType: AXFileType | undefined, name: string): fileType is AXFileType & {
-    utilities: Record<string, AXFileTypeUtility>;
-};
-declare function runFileTypeUtility<T>(fileType: AXFileType | undefined, name: string, ctx: AXFileTypeUtilitiesContext, ...args: unknown[]): Promise<T | undefined>;
-declare function runFileTypeUtilitySync<T>(fileType: AXFileType | undefined, name: string, ctx: AXFileTypeUtilitiesContext, ...args: unknown[]): T | undefined;
-
-/** Contributes {@link AXFileType} entries (multi provider). */
-declare abstract class AXFileTypeInfoProvider {
-    abstract items(): Promise<AXFileType[]>;
-}
-declare const AX_FILE_TYPE_INFO_PROVIDER: InjectionToken<AXFileTypeInfoProvider[]>;
-declare function provideFileTypeInfoProvider(provider: Type<AXFileTypeInfoProvider>): Provider;
-
-declare class AXFileTypeRegistryService {
-    private readonly validation;
-    private readonly providers;
-    private readonly registeredTypes;
-    private cache;
-    /** Registers or replaces catalog entries (e.g. from feature bootstrap). */
-    registerTypes(types: AXFileType[]): void;
-    invalidateCache(): void;
-    private resolveTypes;
-    getTypes(): Promise<AXFileType[]>;
-    get(name: string): Promise<AXFileType | undefined>;
-    accept(typeNames?: string | string[]): Promise<string>;
-    matchType(file: File): Promise<AXFileType | undefined>;
-    validate(file: File, typeName: string): Promise<AXValidationRuleResult[]>;
-    validateAgainstTypes(file: File, typeNames: string | string[]): Promise<AXValidationRuleResult[]>;
-    validateMany(files: File[], typeNames: string | string[]): Promise<{
-        accepted: File[];
-        rejected: {
-            file: File;
-            errors: AXValidationRuleResult[];
-        }[];
-    }>;
-    private matchesMime;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFileTypeRegistryService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileTypeRegistryService>;
-}
-
-/** Merges type-level validations with extension overrides (extension wins per field). */
-declare function mergeFileValidations(base: AXFileValidations, override?: Partial<AXFileValidations>): AXFileValidations;
-/** Resolved validations for a type + optional extension. */
-declare function resolveFileValidations(type: AXFileType, extension?: AXFileTypeExtension): AXFileValidations;
-/** True when no mime/size/rules are defined on the type. */
-declare function isEmptyFileValidations(validations?: AXFileValidations): boolean;
-/**
- * Extension-only mode: empty type `validations` and a non-empty `extensions` list.
- * Files must match a listed extension; rules come from that extension entry.
- */
-declare function isExtensionsOnlyType(type: AXFileType): boolean;
-/** File extension from name (lowercase, no dot). */
-declare function getFileExtension(fileName: string): string;
-/** Matching extension entry for a file within a type, if any. */
-declare function findFileTypeExtension(file: File, type: AXFileType): AXFileTypeExtension | undefined;
-
-/** Maps {@link AXFileValidations} to executable validation entries. */
-declare function fileValidationsToRules(validations: AXFileValidations): AXFileValidationRule[];
-/** Failed validation results; empty array means the file is valid. */
-declare function validateFileWithValidations(validation: AXValidationService, file: File, validations: AXFileValidations): Promise<AXValidationRuleResult[]>;
-/** Validates a file against a type; extension rules override when the file name matches. */
-declare function validateFileAgainstType(validation: AXValidationService, file: File, type: AXFileType, extension?: AXFileTypeExtension): Promise<AXValidationRuleResult[]>;
-
-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>;
-}
-
-/** Extension-only: no type `validations` — only listed extensions are allowed. */
-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>;
-}
-
-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>;
-}
-
-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>;
-}
-
-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>;
-}
-
-/** Built-in file type provider classes (one logical type per provider). */
-declare const AX_BUILTIN_FILE_TYPE_PROVIDERS: readonly [typeof AXImageFileTypeProvider, typeof AXVideoFileTypeProvider, typeof AXAudioFileTypeProvider, typeof AXFileFileTypeProvider, typeof AXDocumentFileTypeProvider];
-/** Registers all built-in file type providers (image, video, audio, file, document). */
-declare function provideBuiltinFileTypeProviders(): Provider[];
-/** @deprecated Use {@link provideBuiltinFileTypeProviders}. */
-declare const provideDefaultFileTypeProviders: typeof provideBuiltinFileTypeProviders;
-
-interface AXFileMimeTypeValidationRuleOptions extends AXValidationRuleOptions {
-    /** MIME patterns, e.g. `image/*`, `image/png`. */
-    allowed: string[];
-}
-declare module '@acorex/core/validation' {
-    interface AXValidationRuleOptionsMap {
-        fileMimeType: AXFileMimeTypeValidationRuleOptions;
-    }
-}
-declare class AXFileMimeTypeValidationRule implements AXValidationRule {
-    get name(): string;
-    validate(value: File | Blob, options: AXFileMimeTypeValidationRuleOptions): Promise<AXValidationRuleResult>;
-    private matchesMime;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFileMimeTypeValidationRule, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileMimeTypeValidationRule>;
-}
-
-interface AXFileMinSizeValidationRuleOptions extends AXValidationRuleOptions {
-    /** Minimum size in bytes. */
-    minSize: number;
-}
-declare module '@acorex/core/validation' {
-    interface AXValidationRuleOptionsMap {
-        fileMinSize: AXFileMinSizeValidationRuleOptions;
-    }
-}
-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>;
-}
-
-interface AXFileMaxSizeValidationRuleOptions extends AXValidationRuleOptions {
-    /** Maximum size in bytes. */
-    maxSize: number;
-}
-declare module '@acorex/core/validation' {
-    interface AXValidationRuleOptionsMap {
-        fileMaxSize: AXFileMaxSizeValidationRuleOptions;
-    }
-}
-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>;
-}
-
-/** Validation rule classes to register with {@link AXValidationModule}. */
-declare const AX_FILE_VALIDATION_RULES: readonly [typeof AXFileMimeTypeValidationRule, typeof AXFileMinSizeValidationRule, typeof AXFileMaxSizeValidationRule];
-/** Registers file validation rules with {@link AXValidationRegistryService}. */
-declare function provideFileValidationRules(): Provider;
-
-/**
- * Registers validation rules and optional built-in file type providers.
- * {@link AXFileTypeRegistryService} and {@link AXFileService} are `providedIn: 'root'`.
- */
-declare function provideFileTypeSystem(): Provider[];
-
-interface AXFileModuleConfig {
-    fileTypeProviders?: Provider[];
-    includeDefaultFileTypes?: boolean;
-}
-declare class AXFileModule {
-    static forRoot(config?: AXFileModuleConfig): ModuleWithProviders<AXFileModule>;
-    static forChild(config?: AXFileModuleConfig): ModuleWithProviders<AXFileModule>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFileModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<AXFileModule, never, [typeof i1.AXFormatModule, typeof i2.AXValidationModule], never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<AXFileModule>;
-}
-
-interface AXFileChooseOptions {
-    /** Logical type name(s) from {@link AXFileTypeRegistryService}. When set, files are validated against the catalog. */
-    fileType?: string | string[];
-    accept?: string;
-    multiple?: boolean;
-}
-declare class AXFileService {
-    private readonly document;
-    private readonly fileTypes;
-    getFileTypes(): Promise<AXFileType[]>;
-    getFileType(name: string): Promise<AXFileType | undefined>;
-    getAcceptAttribute(fileType?: string | string[]): Promise<string>;
-    matchFileType(file: File): Promise<AXFileType | undefined>;
-    validate(file: File, fileType: string | string[]): Promise<AXValidationRuleResult[]>;
-    validateMany(files: File[], fileType: string | string[]): Promise<{
-        accepted: File[];
-        rejected: {
-            file: File;
-            errors: AXValidationRuleResult[];
-        }[];
-    }>;
-    /**
-     * Opens a file selection dialog.
-     * With `fileType`, returns files that pass catalog validation (`accept` defaults from the catalog).
-     * Without `fileType`, returns all selected files (legacy `accept` / `multiple` only).
-     */
-    chooseValidated(options: AXFileChooseOptions): Promise<{
-        accepted: File[];
-        rejected: {
-            file: File;
-            errors: AXValidationRuleResult[];
-        }[];
-    }>;
-    choose(options: AXFileChooseOptions): Promise<File[]>;
-    blobToBase64(blob: Blob): Promise<string>;
-    getSize(file: File | Blob | string): number | false;
-    isBase64(base64: string): boolean;
-    getBase64Size(base64: string): number;
-    private resolveChooseOptions;
-    private openFileDialog;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXFileService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXFileService>;
-}
-
-export { AXAudioFileTypeProvider, AXDocumentFileTypeProvider, AXFileFileTypeProvider, AXFileMaxSizeValidationRule, AXFileMimeTypeValidationRule, AXFileMinSizeValidationRule, AXFileModule, AXFileService, AXFileSizeFormatter, AXFileTypeInfoProvider, AXFileTypeRegistryService, 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_UTILITY, AX_FILE_VALIDATION_RULES, AX_IMAGE_FILE_TYPE, AX_VIDEO_FILE_TYPE, createFileTypeUtilitiesContext, fileValidationsToRules, findFileTypeExtension, formatFileSizeBytes, getFileExtension, hasFileTypeUtility, isEmptyFileValidations, isExtensionsOnlyType, mergeFileValidations, provideBuiltinFileTypeProviders, provideDefaultFileTypeProviders, provideFileTypeInfoProvider, provideFileTypeSystem, provideFileValidationRules, resolveFileValidations, runFileTypeUtility, runFileTypeUtilitySync, validateFileAgainstType, validateFileWithValidations };
-export type { AXFileChooseOptions, AXFileMaxSizeValidationRuleOptions, AXFileMimeTypeValidationRuleOptions, AXFileMinSizeValidationRuleOptions, AXFileModuleConfig, AXFileSizeFormatterOptions, AXFileType, AXFileTypeExtension, AXFileTypeUtilitiesContext, AXFileTypeUtility, AXFileTypeUtilityName, AXFileValidationRule, AXFileValidations };