@acorex/modules 19.3.0 → 19.3.2

package/dashboard-management/lib/features/shared/widgets/weather/weather-services/weather-api.abstract.d.ts

@@ -0,0 +1,174 @@
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Weather location information
+ */
+export interface AXPWeatherLocation {
+    /** City name */
+    city: string;
+    /** Country name */
+    country: string;
+    /** Formatted location display name */
+    displayName: string;
+}
+/**
+ * Weather current condition information
+ */
+export interface AXPWeatherCondition {
+    /** Condition text */
+    condition: string;
+    /** Condition code */
+    conditionCode: number;
+    /** Icon URL */
+    iconUrl: string;
+    /** Temperature in Celsius */
+    tempC: number;
+    /** Temperature in Fahrenheit */
+    tempF: number;
+    /** Feels like temperature in Celsius */
+    feelsLikeC: number;
+    /** Feels like temperature in Fahrenheit */
+    feelsLikeF: number;
+    /** Humidity percentage */
+    humidity: number;
+    /** Wind speed in km/h */
+    windKph: number;
+    /** Wind speed in mph */
+    windMph: number;
+    /** Wind direction */
+    windDirection: string;
+    /** UV index */
+    uv: number;
+    /** Last updated timestamp */
+    lastUpdated: string;
+}
+/**
+ * Weather forecast data for a single day
+ */
+export interface AXPWeatherForecastDay {
+    /** Date string */
+    date: string;
+    /** Day name (e.g., "Mon", "Tue") */
+    day: string;
+    /** Weather condition code */
+    condition: string;
+    /** Weather icon URL */
+    iconUrl: string;
+    /** Max temperature in Celsius */
+    maxTempC: number;
+    /** Max temperature in Fahrenheit */
+    maxTempF: number;
+    /** Min temperature in Celsius */
+    minTempC: number;
+    /** Min temperature in Fahrenheit */
+    minTempF: number;
+}
+/**
+ * Complete weather data response
+ */
+export interface AXPWeatherData {
+    /** Location information */
+    location: AXPWeatherLocation;
+    /** Current weather data */
+    current: AXPWeatherCondition;
+    /** Forecast data */
+    forecast: AXPWeatherForecastDay[];
+}
+/**
+ * Weather API request options
+ */
+export interface AXPWeatherRequestOptions {
+    /** Temperature unit */
+    tempUnit?: string;
+    /** Location query */
+    location?: string;
+    /** Use mock data */
+    useMockData?: boolean;
+}
+/**
+ * Weather UI condition display info
+ */
+export interface AXPWeatherConditionDisplay {
+    /** Condition unique ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Icon class (Font Awesome) */
+    icon: string;
+    /** Associated color */
+    color: string;
+}
+/**
+ * Abstract Weather API Service
+ * Base class that defines the interface and common functionality
+ * for weather data providers
+ */
+export declare abstract class AXPWeatherApiAbstract {
+    /** Weather condition definitions mapping */
+    protected weatherConditions: Record<string, AXPWeatherConditionDisplay>;
+    /** Day of week mapping */
+    protected readonly dayNames: string[];
+    /**
+     * Get weather condition info by ID
+     * @param id Condition ID
+     * @returns Weather condition info or default if not found
+     */
+    getCondition(id: string): AXPWeatherConditionDisplay;
+    /**
+     * Get current weather data for given location
+     * @param options Weather request options
+     * @returns Observable with weather data
+     */
+    abstract getWeather(options: AXPWeatherRequestOptions): Observable<AXPWeatherData>;
+    /**
+     * Get weather forecast for a location
+     * @param options Weather request options with days
+     * @returns Observable of weather data with forecast
+     */
+    abstract getForecast(options: AXPWeatherRequestOptions & {
+        days?: number;
+    }): Observable<AXPWeatherData>;
+    /**
+     * Parse location string into city and display components
+     * @param location Location query string
+     * @returns Parsed location parts
+     */
+    protected parseLocation(location: string): {
+        city: string;
+        country: string;
+        display: string;
+    };
+    /**
+     * Format location name for display
+     * @param locationParts Parsed location parts
+     * @returns Formatted location name
+     */
+    protected formatLocationName(locationParts: {
+        city: string;
+        country: string;
+        display: string;
+    }): string;
+    /**
+     * Map API condition text to our internal condition IDs
+     * @param conditionText Condition text from API
+     * @returns Internal condition ID
+     */
+    protected mapApiConditionToId(conditionText: string): string;
+    /**
+     * Generate random integer between min and max (inclusive)
+     * Helper method for implementations
+     * @param min Minimum value
+     * @param max Maximum value
+     * @returns Random integer
+     */
+    protected getRandomInt(min: number, max: number): number;
+    /**
+     * Set the API key for the weather service
+     * This is only used by the real API implementation,
+     * but is defined in the abstract class for consistency
+     * @param key The API key
+     */
+    abstract setApiKey(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPWeatherApiAbstract, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPWeatherApiAbstract>;
+}

package/dashboard-management/lib/features/shared/widgets/weather/weather-services/weather-api.key.d.ts

@@ -0,0 +1,2 @@
+import { InjectionToken } from '@angular/core';
+export declare const AXP_WEATHER_API_KEY: InjectionToken<string>;

package/dashboard-management/lib/features/shared/widgets/weather/weather-services/weather-api.mock.service.d.ts

@@ -0,0 +1,47 @@
+import { Observable } from 'rxjs';
+import { AXPWeatherApiAbstract, AXPWeatherData, AXPWeatherRequestOptions } from './weather-api.abstract';
+import * as i0 from "@angular/core";
+/**
+ * Mock Weather API Service
+ * Provides simulated weather data for development and testing
+ */
+export declare class AXPWeatherApiMockService extends AXPWeatherApiAbstract {
+    private readonly mockDelay;
+    /**
+     * Get current weather data for given location
+     * @param options Weather request options
+     * @returns Observable with weather data
+     */
+    getWeather(options: AXPWeatherRequestOptions): Observable<AXPWeatherData>;
+    /**
+     * Get weather forecast for a location
+     * @param options Weather request options with days
+     * @returns Observable of weather data with forecast
+     */
+    getForecast(options: AXPWeatherRequestOptions & {
+        days?: number;
+    }): Observable<AXPWeatherData>;
+    /**
+     * Get mock weather data for demo/development
+     * @param location Location query
+     * @param options Request options
+     * @returns Observable of mock weather data
+     */
+    private getMockWeatherData;
+    /**
+     * Get mock forecast data for demo/development
+     * @param location Location query
+     * @param days Number of forecast days
+     * @param options Request options
+     * @returns Observable of mock weather data with forecast
+     */
+    private getMockForecast;
+    /**
+     * Set the API key for the weather service
+     * No-op in the mock implementation
+     * @param key The API key
+     */
+    setApiKey(key: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPWeatherApiMockService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPWeatherApiMockService>;
+}

package/dashboard-management/lib/features/shared/widgets/weather/weather-services/weather-api.service.d.ts

@@ -0,0 +1,48 @@
+import { Observable } from 'rxjs';
+import { AXPWeatherApiAbstract, AXPWeatherData, AXPWeatherRequestOptions } from './weather-api.abstract';
+import * as i0 from "@angular/core";
+/**
+ * Real Weather API Service
+ * Fetches actual weather data from a weather API service
+ */
+export declare class AXPWeatherApiService extends AXPWeatherApiAbstract {
+    private readonly http;
+    private readonly baseApiUrl;
+    private apiKeyToken;
+    /**
+     * Set the API key for the weather service
+     * @param key The API key
+     */
+    setApiKey(key: string): void;
+    /**
+     * Get current weather data for given location
+     * @param options Weather request options
+     * @returns Observable with weather data
+     */
+    getWeather(options: AXPWeatherRequestOptions): Observable<AXPWeatherData>;
+    /**
+     * Get weather forecast for a location
+     * @param options Weather request options with days
+     * @returns Observable of weather data with forecast
+     */
+    getForecast(options: AXPWeatherRequestOptions & {
+        days?: number;
+    }): Observable<AXPWeatherData>;
+    /**
+     * Transform API response to our internal data model
+     * @param apiData Raw API response
+     * @param displayName Formatted location name
+     * @returns Normalized weather data
+     */
+    private transformApiResponse;
+    /**
+     * Transform forecast API response to our internal data model
+     * @param apiData Raw API response with forecast
+     * @param displayName Formatted location name
+     * @param days Number of forecast days
+     * @returns Normalized weather data with forecast
+     */
+    private transformForecastResponse;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPWeatherApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPWeatherApiService>;
+}

package/dashboard-management/lib/features/shared/widgets/weather/weather-widget.component.d.ts

@@ -0,0 +1,109 @@
+import { AXPValueWidgetComponent } from '@acorex/platform/layout/builder';
+import { ChangeDetectorRef, ElementRef } from '@angular/core';
+import { AXPWeatherData } from './weather-services';
+import * as i0 from "@angular/core";
+/**
+ * Weather Widget Component
+ * Displays current weather conditions and optional forecast data
+ * for a specified location with customizable display options.
+ */
+export declare class AXPWeatherWidgetViewComponent extends AXPValueWidgetComponent {
+    protected cdr: ChangeDetectorRef;
+    protected containerEl: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;
+    private weatherService;
+    protected weatherData: import("@angular/core").WritableSignal<AXPWeatherData | null>;
+    protected isLoading: import("@angular/core").WritableSignal<boolean>;
+    protected hasError: import("@angular/core").WritableSignal<boolean>;
+    protected errorMessage: import("@angular/core").WritableSignal<string>;
+    protected isForecastLoading: import("@angular/core").WritableSignal<boolean>;
+    private refreshSubscription;
+    protected city: import("@angular/core").Signal<any>;
+    protected temperatureUnit: import("@angular/core").Signal<any>;
+    protected windSpeedUnit: import("@angular/core").Signal<any>;
+    protected showCurrentCondition: import("@angular/core").Signal<boolean>;
+    protected showTemperature: import("@angular/core").Signal<boolean>;
+    protected showHumidity: import("@angular/core").Signal<boolean>;
+    protected showWind: import("@angular/core").Signal<boolean>;
+    protected showForecast: import("@angular/core").Signal<boolean>;
+    protected forecastDays: import("@angular/core").Signal<any>;
+    protected autoRefresh: import("@angular/core").Signal<boolean>;
+    protected refreshInterval: import("@angular/core").Signal<any>;
+    private optionsEffect;
+    private valueEffect;
+    protected displayedForecast: import("@angular/core").Signal<import("./weather-services").AXPWeatherForecastDay[]>;
+    /**
+     * Component constructor
+     * @param cdr ChangeDetectorRef for triggering view updates
+     */
+    constructor(cdr: ChangeDetectorRef);
+    /**
+     * Component cleanup on destroy
+     */
+    ngOnDestroy(): void;
+    /**
+     * Loads weather data from the API
+     * Sets loading state and handles errors
+     */
+    private loadWeatherData;
+    /**
+     * Sets up the auto-refresh timer based on configuration
+     */
+    private setupRefreshTimer;
+    /**
+     * Clears the refresh timer subscription
+     */
+    private clearRefreshTimer;
+    /**
+     * Manually refreshes the weather data
+     */
+    protected refreshWeather(): void;
+    /**
+     * Gets the current temperature based on selected unit
+     */
+    protected getCurrentTemperature(): number;
+    /**
+     * Gets the feels like temperature based on selected unit
+     */
+    protected getFeelsLikeTemperature(): number;
+    /**
+     * Gets the humidity percentage
+     */
+    protected getHumidity(): number;
+    /**
+     * Gets the wind speed based on selected unit
+     */
+    protected getWindSpeed(): number;
+    /**
+     * Gets the current weather condition
+     */
+    protected getCurrentCondition(): string;
+    /**
+     * Gets the formatted last updated time
+     */
+    protected getLastUpdated(): string;
+    /**
+     * Gets the icon class for a weather condition
+     * @param conditionId Weather condition ID
+     * @returns Font Awesome icon class
+     */
+    protected getConditionIcon(conditionId: string): string;
+    /**
+     * Gets the display name for a weather condition
+     * @param conditionId Weather condition ID
+     * @returns Condition display name
+     */
+    protected getConditionName(conditionId: string): string;
+    /**
+     * Gets the color for a weather condition
+     * @param conditionId Weather condition ID
+     * @returns CSS color value
+     */
+    protected getConditionColor(conditionId: string): string;
+    /**
+     * Cleans up chart resources
+     * Required by AXPChartBaseComponent
+     */
+    protected cleanupChart(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPWeatherWidgetViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXPWeatherWidgetViewComponent, "ng-component", never, {}, {}, never, never, true, never>;
+}

package/dashboard-management/lib/features/shared/widgets/weather/weather-widget.config.d.ts

@@ -0,0 +1,14 @@
+import { AXPWidgetConfig } from '@acorex/platform/layout/builder';
+/**
+ * Weather Widget Configuration
+ * Provides customization options for displaying weather data and forecast
+ */
+export declare const AXPWeatherWidget: AXPWidgetConfig;
+/**
+ * Type declaration to register the weather widget type
+ */
+declare module '@acorex/platform/layout/builder' {
+    interface AXPWidgetTypesMap {
+        weather: 'weather';
+    }
+}

package/fesm2022/acorex-modules-application-management.mjs

@@ -1,4 +1,4 @@
-import { AXPStickyDirective, AXPGridLayoutDirective, AXPDataGenerator, AXPWorkflowNavigateAction, AXP_MENU_PROVIDER, AXPEntityCommandScope, AXPEntityQueryType } from '@acorex/platform/common';
+import { AXPStickyDirective, AXPGridLayoutDirective, AXPWorkflowNavigateAction, AXP_MENU_PROVIDER, AXPEntityCommandScope, AXPEntityQueryType } from '@acorex/platform/common';
 import { AXPEntityDetailViewModelResolver, AXPEntityStorageService, AXPEntityDataProviderImpl, AXMEntityCrudServiceImpl, AXP_ENTITY_DEFINITION_LOADER } from '@acorex/platform/layout/entity';
 import * as i1$1 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowModule } from '@acorex/platform/workflow';
@@ -31,7 +31,7 @@ import { AXPLayoutThemeService } from '@acorex/platform/themes/shared';
 import { AXPWidgetsModule } from '@acorex/platform/widgets';
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
-import { applySortArray, applyFilterArray } from '@acorex/platform/core';
+import { AXPDataGenerator, applySortArray, applyFilterArray } from '@acorex/platform/core';
 
 class AXPModuleEntityDetailViewComponent {
     constructor() {