@acorex/platform 20.6.0-next.13 → 20.6.0-next.14

package/core/index.d.ts

@@ -908,7 +908,7 @@ type AXPPartialNested<T> = {
 declare function getNestedKeys(obj: any, prefix?: string): string[];
 type AXPExpression = string;
 type AXPMetaData = Record<string, any>;
-type AXPOptionsData = Record<string, any>;
+type AXPOptionsData<T extends Record<string, unknown> = Record<string, any>> = T;
 interface AXPValueUnit {
     name: string;
     title: string;
@@ -2410,32 +2410,94 @@ declare class AXPCountdownPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<AXPCountdownPipe, "countdown", true>;
 }
 
-declare function extractNestedFieldsWildcard(obj: any, basePath: string, fields: string[]): any;
-declare function setSmart(obj: any, smartPath: string, value: any): any;
-declare function getSmart(obj: any, smartPath: string): any;
-declare function extractValue<T = any>(value: any, key?: string): T | null;
-declare function cleanDeep(obj: any): any;
-type ChangeEntry = {
-    path: string;
-    oldValue: any;
-    newValue: any;
-    arrayDiff?: {
-        added: any[];
-        removed: any[];
-    };
-};
-declare function getChangedPaths(obj1: any, obj2: any): string[];
-declare function getDetailedChanges(obj1: any, obj2: any): ChangeEntry[];
-declare function getEnumValues(enumType: any): {
-    id: string;
-    title: string;
-}[];
-
 declare function applyFilterArray(dataArray: any[], filters?: AXDataSourceFilterOption[], logic?: 'and' | 'or'): any[];
 declare function applySortArray(dataArray: any, sorts: AXDataSourceSortOption[]): any;
 declare function applyPagination<T>(dataArray: T[], skip: number, take: number): T[];
 declare function applyQueryArray<T>(dataArray: T[], query: AXDataSourceQuery): Promise<AXDataSourceCallbackResult<T>>;
 
+/**
+ * Screen Size Enum
+ */
+declare enum AXPScreenSize {
+    Small = "small",
+    Medium = "medium",
+    Large = "large"
+}
+/**
+ * Device Type Enum
+ */
+declare enum AXPDeviceType {
+    Mobile = "mobile",
+    Tablet = "tablet",
+    Desktop = "desktop"
+}
+/**
+ * Injectable service that provides reactive device and screen size information.
+ * Monitors window resize events and updates signals accordingly.
+ */
+declare class AXPDeviceService {
+    /**
+     * Current screen size (Small, Medium, Large)
+     */
+    readonly screenSize: i0.WritableSignal<AXPScreenSize>;
+    /**
+     * Current device type (Mobile, Tablet, Desktop)
+     */
+    readonly deviceType: i0.WritableSignal<AXPDeviceType>;
+    /**
+     * Whether the device supports touch input
+     */
+    readonly isTouchDevice: i0.WritableSignal<boolean>;
+    /**
+     * Whether the screen size is Small
+     */
+    readonly isSmall: i0.Signal<boolean>;
+    /**
+     * Whether the screen size is Medium
+     */
+    readonly isMedium: i0.Signal<boolean>;
+    /**
+     * Whether the screen size is Large
+     */
+    readonly isLarge: i0.Signal<boolean>;
+    /**
+     * Whether the device is Mobile
+     */
+    readonly isMobileDevice: i0.Signal<boolean>;
+    /**
+     * Whether the device is Tablet
+     */
+    readonly isTabletDevice: i0.Signal<boolean>;
+    /**
+     * Whether the device is Desktop
+     */
+    readonly isDesktopDevice: i0.Signal<boolean>;
+    /**
+     * Whether the device supports touch (alias for isTouchDevice)
+     */
+    readonly isTouchScreen: i0.Signal<boolean>;
+    private _resizeListener;
+    constructor();
+    /**
+     * Update screen size and device type based on window width
+     */
+    private _updateScreenSize;
+    /**
+     * Set up event listener for window resize
+     */
+    private _setupResizeListener;
+    /**
+     * Remove event listener for window resize
+     */
+    private _removeResizeListener;
+    /**
+     * Clean up resources when service is destroyed
+     */
+    destroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDeviceService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPDeviceService>;
+}
+
 /**
  * Service for applying and resetting text highlighting within specified HTML elements.
  */
@@ -2479,11 +2541,32 @@ declare class AXHighlightService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXHighlightService>;
 }
 
+declare function extractNestedFieldsWildcard(obj: any, basePath: string, fields: string[]): any;
+declare function setSmart(obj: any, smartPath: string, value: any): any;
+declare function getSmart(obj: any, smartPath: string): any;
+declare function extractValue<T = any>(value: any, key?: string): T | null;
+declare function cleanDeep(obj: any): any;
+type ChangeEntry = {
+    path: string;
+    oldValue: any;
+    newValue: any;
+    arrayDiff?: {
+        added: any[];
+        removed: any[];
+    };
+};
+declare function getChangedPaths(obj1: any, obj2: any): string[];
+declare function getDetailedChanges(obj1: any, obj2: any): ChangeEntry[];
+declare function getEnumValues(enumType: any): {
+    id: string;
+    title: string;
+}[];
+
 declare function extractTextFromHtml(value: string): string;
 /**
  * Generate kebab-case group name from title
  */
 declare function generateKebabCase(title: string): string;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPComponentLogoConfig, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPGridLayoutDirective, AXPHookService, AXPImageUrlLogoConfig, AXPPlatformScope, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPSystemActionType, AXPSystemActions, AXPSystemStatusType, AXPSystemStatuses, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TAG_PROVIDER, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getStatusInfo, getSystemActions, getSystemStatus, objectKeyValueTransforms, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, setSmart, systemStatusToDefinition };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPComponentLogoConfig, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPGridLayoutDirective, AXPHookService, AXPImageUrlLogoConfig, AXPPlatformScope, AXPScreenSize, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPSystemActionType, AXPSystemActions, AXPSystemStatusType, AXPSystemStatuses, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TAG_PROVIDER, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getStatusInfo, getSystemActions, getSystemStatus, objectKeyValueTransforms, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, setSmart, systemStatusToDefinition };
 export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPCommandMessage, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextState, AXPDataSource, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataType, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityReference, AXPEqualValidationRule, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFileListItem, AXPFileSource, AXPFileStatus, AXPFilterDefinition, AXPFilterLogic, AXPFilterOperation, AXPFilterQuery, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMetaData, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOptionsData, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSortDefinition, AXPSortQuery, AXPStartUpTask, AXPStatusActionPriority, AXPStatusActionScope, AXPStatusDefinition, AXPStatusTransition, AXPStatusWorkflowAction, AXPStringValidationRules, AXPSystemAction, AXPTag, AXPTagFilterOptions, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetTrigger, AXPWidgetTriggers };

package/fesm2022/acorex-platform-core.mjs

@@ -2,9 +2,9 @@ import * as i0 from '@angular/core';
 import { InjectionToken, inject, Injectable, computed, input, effect, Directive, EventEmitter, HostListener, Output, ViewContainerRef, ElementRef, Injector, runInInjectionContext, provideAppInitializer, signal, Pipe } from '@angular/core';
 import { signalStore, withState, withComputed, withMethods, patchState } from '@ngrx/signals';
 import { get, isPlainObject, set, isArray, merge, isNil, isObjectLike, transform, isEmpty, isEqual, differenceWith, union, cloneDeep, isUndefined, endsWith, startsWith, includes, lte, gte, lt, gt, orderBy } from 'lodash-es';
-import { Subject, interval } from 'rxjs';
+import { Subject, interval, fromEvent } from 'rxjs';
 import { AXCalendarService } from '@acorex/core/date-time';
-import { startWith, map } from 'rxjs/operators';
+import { startWith, map, debounceTime } from 'rxjs/operators';
 
 const AXP_ACTIVITY_LOG_PROVIDER = new InjectionToken('AXP_ACTIVITY_LOGS_PROVIDER');
 class AXPActivityLogService {
@@ -3300,6 +3300,185 @@ async function applyQueryArray(dataArray, query) {
     };
 }
 
+//#region ----   Type Definitions   ----
+/**
+ * Screen Size Enum
+ */
+var AXPScreenSize;
+(function (AXPScreenSize) {
+    AXPScreenSize["Small"] = "small";
+    AXPScreenSize["Medium"] = "medium";
+    AXPScreenSize["Large"] = "large";
+})(AXPScreenSize || (AXPScreenSize = {}));
+/**
+ * Device Type Enum
+ */
+var AXPDeviceType;
+(function (AXPDeviceType) {
+    AXPDeviceType["Mobile"] = "mobile";
+    AXPDeviceType["Tablet"] = "tablet";
+    AXPDeviceType["Desktop"] = "desktop";
+})(AXPDeviceType || (AXPDeviceType = {}));
+//#endregion
+//#region ----   Helper Functions   ----
+/**
+ * Get the initial screen size based on window width
+ */
+const getScreenSize = () => {
+    const width = window.innerWidth;
+    if (width <= 600)
+        return AXPScreenSize.Small;
+    if (width <= 1024)
+        return AXPScreenSize.Medium;
+    return AXPScreenSize.Large;
+};
+/**
+ * Determine device type based on viewport width
+ */
+const getDeviceType = () => {
+    const width = window.innerWidth;
+    if (width <= 600) {
+        return AXPDeviceType.Mobile;
+    }
+    else if (width <= 1024) {
+        return AXPDeviceType.Tablet;
+    }
+    return AXPDeviceType.Desktop;
+};
+/**
+ * Determine if the device supports touch
+ */
+const isTouchDevice = () => {
+    return 'ontouchstart' in window || navigator.maxTouchPoints > 0;
+};
+//#endregion
+//#region ----   Device Service   ----
+/**
+ * Injectable service that provides reactive device and screen size information.
+ * Monitors window resize events and updates signals accordingly.
+ */
+class AXPDeviceService {
+    //#endregion
+    //#region ----   Constructor & Lifecycle   ----
+    constructor() {
+        //#region ----   State Signals   ----
+        /**
+         * Current screen size (Small, Medium, Large)
+         */
+        this.screenSize = signal(getScreenSize(), ...(ngDevMode ? [{ debugName: "screenSize" }] : []));
+        /**
+         * Current device type (Mobile, Tablet, Desktop)
+         */
+        this.deviceType = signal(getDeviceType(), ...(ngDevMode ? [{ debugName: "deviceType" }] : []));
+        /**
+         * Whether the device supports touch input
+         */
+        this.isTouchDevice = signal(isTouchDevice(), ...(ngDevMode ? [{ debugName: "isTouchDevice" }] : []));
+        //#endregion
+        //#region ----   Computed Signals   ----
+        /**
+         * Whether the screen size is Small
+         */
+        this.isSmall = computed(() => this.screenSize() === AXPScreenSize.Small, ...(ngDevMode ? [{ debugName: "isSmall" }] : []));
+        /**
+         * Whether the screen size is Medium
+         */
+        this.isMedium = computed(() => this.screenSize() === AXPScreenSize.Medium, ...(ngDevMode ? [{ debugName: "isMedium" }] : []));
+        /**
+         * Whether the screen size is Large
+         */
+        this.isLarge = computed(() => this.screenSize() === AXPScreenSize.Large, ...(ngDevMode ? [{ debugName: "isLarge" }] : []));
+        /**
+         * Whether the device is Mobile
+         */
+        this.isMobileDevice = computed(() => this.deviceType() === AXPDeviceType.Mobile, ...(ngDevMode ? [{ debugName: "isMobileDevice" }] : []));
+        /**
+         * Whether the device is Tablet
+         */
+        this.isTabletDevice = computed(() => this.deviceType() === AXPDeviceType.Tablet, ...(ngDevMode ? [{ debugName: "isTabletDevice" }] : []));
+        /**
+         * Whether the device is Desktop
+         */
+        this.isDesktopDevice = computed(() => this.deviceType() === AXPDeviceType.Desktop, ...(ngDevMode ? [{ debugName: "isDesktopDevice" }] : []));
+        /**
+         * Whether the device supports touch (alias for isTouchDevice)
+         */
+        this.isTouchScreen = computed(() => this.isTouchDevice(), ...(ngDevMode ? [{ debugName: "isTouchScreen" }] : []));
+        //#endregion
+        //#region ----   Private Properties   ----
+        this._resizeListener = null;
+        this._setupResizeListener();
+    }
+    //#endregion
+    //#region ----   Private Methods   ----
+    /**
+     * Update screen size and device type based on window width
+     */
+    _updateScreenSize() {
+        const width = window.innerWidth;
+        let newScreenSize;
+        if (width <= 600) {
+            newScreenSize = AXPScreenSize.Small;
+        }
+        else if (width <= 1024) {
+            newScreenSize = AXPScreenSize.Medium;
+        }
+        else {
+            newScreenSize = AXPScreenSize.Large;
+        }
+        // Determine device type based on width to keep it reactive to devtools emulation
+        let newDeviceType;
+        if (width <= 600) {
+            newDeviceType = AXPDeviceType.Mobile;
+        }
+        else if (width <= 1024) {
+            newDeviceType = AXPDeviceType.Tablet;
+        }
+        else {
+            newDeviceType = AXPDeviceType.Desktop;
+        }
+        if (newScreenSize !== this.screenSize() || newDeviceType !== this.deviceType()) {
+            this.screenSize.set(newScreenSize);
+            this.deviceType.set(newDeviceType);
+        }
+    }
+    /**
+     * Set up event listener for window resize
+     */
+    _setupResizeListener() {
+        this._resizeListener = fromEvent(window, 'resize')
+            .pipe(debounceTime(250)) // 250ms debounce delay
+            .subscribe(() => {
+            this._updateScreenSize();
+        });
+    }
+    /**
+     * Remove event listener for window resize
+     */
+    _removeResizeListener() {
+        if (this._resizeListener) {
+            this._resizeListener.unsubscribe();
+            this._resizeListener = null;
+        }
+    }
+    //#endregion
+    //#region ----   Public Methods   ----
+    /**
+     * Clean up resources when service is destroyed
+     */
+    destroy() {
+        this._removeResizeListener();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPDeviceService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPDeviceService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.12", ngImport: i0, type: AXPDeviceService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }], ctorParameters: () => [] });
+
 /**
  * Service for applying and resetting text highlighting within specified HTML elements.
  */
@@ -3429,5 +3608,5 @@ function generateKebabCase(title) {
  * Generated bundle index. Do not edit.
  */
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPComponentLogoConfig, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPGridLayoutDirective, AXPHookService, AXPImageUrlLogoConfig, AXPPlatformScope, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPSystemActionType, AXPSystemActions, AXPSystemStatusType, AXPSystemStatuses, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TAG_PROVIDER, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getStatusInfo, getSystemActions, getSystemStatus, objectKeyValueTransforms, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, setSmart, systemStatusToDefinition };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPComponentLogoConfig, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPGridLayoutDirective, AXPHookService, AXPImageUrlLogoConfig, AXPPlatformScope, AXPScreenSize, AXPStatusDefinitionProviderService, AXPStatusProvider, AXPSystemActionType, AXPSystemActions, AXPSystemStatusType, AXPSystemStatuses, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_STATUS_PROVIDERS, AXP_TAG_PROVIDER, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getStatusInfo, getSystemActions, getSystemStatus, objectKeyValueTransforms, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, resolveStatusLook, setSmart, systemStatusToDefinition };
 //# sourceMappingURL=acorex-platform-core.mjs.map