tin-spa 20.14.111 → 20.15.0

package/core/index.d.ts

@@ -2,7 +2,7 @@ import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable, Subject } from 'rxjs';
 import * as tin_spa_core from 'tin-spa/core';
 import * as i0 from '@angular/core';
-import { InjectionToken, EnvironmentProviders, Injector, NgZone, OnInit, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Injector, NgZone, OnInit, EventEmitter, OnChanges, SimpleChanges, ElementRef } from '@angular/core';
 import * as i11 from '@angular/material/dialog';
 import { MatDialog, MatDialogRef } from '@angular/material/dialog';
 import { HttpClient, HttpContext, HttpResponse, HttpErrorResponse, HttpContextToken } from '@angular/common/http';
@@ -14,7 +14,6 @@ import { SocialUser, SocialAuthService } from '@abacritt/angularx-social-login';
 import * as signalR from '@microsoft/signalr';
 import * as i1 from '@angular/common';
 import { PlatformLocation, LocationStrategy } from '@angular/common';
-import { IPublicClientApplication } from '@azure/msal-browser';
 import * as i2 from '@angular/forms';
 import { FormControl } from '@angular/forms';
 import * as i3 from '@angular/material/menu';
@@ -766,6 +765,9 @@ interface Tile {
     chart?: TileChartConfig;
     filter?: (row: any) => boolean;
     data?: any;
+    hideWhenEmpty?: boolean;
+    emptyText?: string;
+    securityConfig?: SecurityConfig;
 }
 interface FilterChip {
     key: string;
@@ -805,6 +807,9 @@ declare class TileConfig {
     minTileWidth?: number;
     maxPerRow?: number;
     hideValueOnMobile?: boolean;
+    hideWhenEmpty?: boolean;
+    emptyText?: string;
+    security?: SecurityConfig;
 }
 type SpaChartType = 'line' | 'bar' | 'pie' | 'doughnut';
 interface ChartItem {
@@ -826,12 +831,38 @@ interface ChartItem {
     hidden?: VisibilityValue;
     visible?: VisibilityValue;
     options?: any;
+    hideWhenEmpty?: boolean;
+    emptyText?: string;
+    securityConfig?: SecurityConfig;
 }
 declare class ChartConfig {
     charts: ChartItem[];
     loadAction?: Action;
     loadInit?: boolean;
     columns?: number;
+    hideWhenEmpty?: boolean;
+    emptyText?: string;
+    security?: SecurityConfig;
+}
+interface DashboardSection {
+    key: string;
+    title: string;
+    icon?: string;
+    security?: SecurityConfig;
+    moduleKey?: string;
+    link?: string;
+    tileConfigs?: TileConfig[];
+    chartConfig?: ChartConfig;
+    tableConfigs?: TableConfig[];
+    hidden?: VisibilityValue;
+    visible?: VisibilityValue;
+}
+declare class DashboardConfig {
+    sections: DashboardSection[];
+    title?: string;
+    icon?: string;
+    quietLoading?: boolean;
+    emptyText?: string;
 }
 declare class Step {
     name: string;
@@ -958,6 +989,7 @@ declare class TableConfig {
     causeFormRefresh?: boolean;
     logResponse?: boolean;
     flatButtons?: boolean;
+    outlinedHeaderButtons?: boolean;
     greyOut?: (value: any) => boolean;
     heroField?: any;
     heroValue?: any;
@@ -982,6 +1014,9 @@ declare class TableConfig {
     import?: ImportConfig;
     realTime?: boolean;
     realTimeFallbackMs?: number;
+    realTimeRefresh?: boolean;
+    realTimeRefreshMs?: number;
+    realTimeRefreshEntities?: string[];
     entityName?: string;
     offline?: OfflineConfig | boolean;
     pagination?: PaginationConfig;
@@ -1106,7 +1141,7 @@ declare class AppConfig {
     get navigation(): 'top' | 'side-modern' | 'top-modern';
     docsBaseUrl?: string;
     loginStyle: string;
-    dialogStyle: string;
+    dialogStyle: 'default' | 'modern';
     loginTitle: string;
     loginMessage: string;
     termsUrl: string;
@@ -1266,6 +1301,7 @@ interface DayBookSection {
     key: string;
     lane?: string;
     listField: string;
+    refreshOn?: string[];
     collapsed?: boolean;
     tableConfig?: TableConfig;
     columns?: (string | DayBookColumnView)[];
@@ -1303,6 +1339,7 @@ interface DayBookConfig {
     pageSize?: number;
     groupLanes?: boolean;
     expandedGroups?: number;
+    refreshDebounceMs?: number;
 }
 interface AppConfigSection {
     key: string;
@@ -1380,6 +1417,18 @@ declare class Core {
         visible?: VisibilityValue;
         hidden?: VisibilityValue;
     }, data: any): boolean;
+    static isChartDataEmpty(chartData: any): boolean;
+    private static chartPointValue;
+    static isChartEmpty(chart: ChartItem, data: any): boolean;
+    static isChartRendered(chart: ChartItem, config: ChartConfig, data: any): boolean;
+    static isTileChartEmpty(tile: Tile, data: any): boolean;
+    static isTileRendered(tile: Tile, config: TileConfig, data: any): boolean;
+    static gatedItems<T extends {
+        securityConfig?: SecurityConfig;
+    }>(items: T[], security: SecurityConfig, role: any): {
+        items: T[];
+        denied: boolean;
+    };
     static testVisible(config: FormConfig, data: any, field: Field, currentRole: any): boolean;
     static isPredicateHidden(config: FormConfig, data: any, field: Field): boolean;
     static buildSubmitPayload(config: FormConfig, data: any): any;
@@ -1390,6 +1439,7 @@ declare class Core {
     static testVisibleHeaderButton(data: any, btn: any): boolean;
     static getVisibleSubfields(config: FormConfig, data: any, field: Field, currentRole: any): Field[];
     static validateObject(fields: Field[], data: any, onInvalid?: (field: Field) => void): string;
+    private static describeDateBound;
     private static validateField;
     static testRequired(config: FormConfig, data: any, field: Field): boolean;
     static getInitialValue(field: Field): any;
@@ -1470,8 +1520,8 @@ declare class MessageService {
     infoWithSubject(subject: string, details: string): void;
     error(details: string): void;
     errorWithSubject(subject: string, details: string, reference?: string): void;
-    warning(details: string, subject?: string): void;
-    success(details: string, subject?: string): void;
+    warning(subject: string, details: string): void;
+    success(subject: string, details: string): void;
     confirm(msg: string, confirmLabel?: string, cancelLabel?: string, destructive?: boolean, requirePhrase?: string): Observable<any>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MessageService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MessageService>;
@@ -1548,9 +1598,9 @@ declare const TIN_SPA_RUNTIME_CONFIG: InjectionToken<TinSpaRuntimeConfig>;
 declare function tinSpaLocationStrategyFactory(platformLocation: PlatformLocation, baseHref: string, config: TinSpaRuntimeConfig): LocationStrategy;
 /** Overlays assets/appsettings.json values (when the app loaded one) onto the code-declared config. */
 declare function tinSpaRuntimeConfigFactory(codeConfig: TinSpaRuntimeConfig): TinSpaRuntimeConfig;
-declare function tinSpaMsalInstanceFactory(config: TinSpaRuntimeConfig): IPublicClientApplication;
 /**
- * Wires up tin-spa runtime behaviours (routing strategy, real-time, MSAL) from a single config.
+ * Wires up tin-spa runtime behaviours (routing strategy, real-time) from a single config.
+ * Changed (20.14.114): no longer provides MSAL - an app that wants Microsoft SSO registers it itself.
  * Add the result to your AppModule (or bootstrap) providers.
  */
 declare function provideTinSpaRuntime(config: Partial<TinSpaRuntimeConfig>): EnvironmentProviders;
@@ -1564,6 +1614,10 @@ interface EntityChangeEvent {
     entityName: string;
     data: any;
 }
+interface EntityInvalidatedEvent {
+    entityName: string;
+    id?: number | null;
+}
 interface NotificationEvent {
     message: string;
     category: string;
@@ -1589,6 +1643,8 @@ declare class SignalRService {
     entityCreated$: rxjs.Observable<EntityChangeEvent>;
     entityUpdated$: rxjs.Observable<EntityChangeEvent>;
     entityDeleted$: rxjs.Observable<EntityChangeEvent>;
+    private entityInvalidated;
+    entityInvalidated$: rxjs.Observable<EntityInvalidatedEvent>;
     private vehiclePosition;
     vehiclePosition$: rxjs.Observable<VehiclePositionFrame>;
     private notificationReceived;
@@ -1607,7 +1663,10 @@ declare class SignalRService {
     private realTimeEnabled;
     /** Public: whether SignalR is the authoritative connection signal (used by OfflineService to pick SignalR vs ping). */
     get isRealTime(): boolean;
+    private buildingConnection;
+    private connectionGeneration;
     startConnection(hubUrl: string, token: string): void;
+    private buildConnection;
     updateToken(token: string): void;
     private forcingReconnect;
     /**
@@ -1623,7 +1682,7 @@ declare class SignalRService {
     static ɵprov: i0.ɵɵInjectableDeclaration<SignalRService>;
 }
 
-type RefreshResult = 'success' | 'rejected' | 'network';
+type RefreshResult = 'success' | 'rejected' | 'network' | 'absent';
 declare class AuthService {
     private _route;
     private socialService;
@@ -1790,6 +1849,8 @@ declare class OfflineService {
     private reads;
     private outbox;
     private meta;
+    private dexie;
+    private opening;
     private entries;
     private readUrls;
     private readPrefixes;
@@ -1828,7 +1889,9 @@ declare class OfflineService {
     pendingCount(): Promise<number>;
     clearCacheKeepOutbox(): Promise<void>;
     deleteLocalData(): Promise<void>;
+    private loadDexie;
     private ensureOpen;
+    private openStore;
     putRead(url: string, entity: string, data: any, maxRows: number): Promise<any>;
     private static readonly DYNAMIC_READS_PER_PREFIX;
     private pruneDynamicReads;
@@ -2173,7 +2236,9 @@ declare class SuffixComponent implements OnInit {
     isHovered: boolean;
     clearContent: boolean;
     readonly: boolean;
+    alwaysShow: boolean;
     value: any;
+    get hasValue(): boolean;
     infoClick: EventEmitter<void>;
     copyClick: EventEmitter<string>;
     clearClick: EventEmitter<void>;
@@ -2182,7 +2247,7 @@ declare class SuffixComponent implements OnInit {
     onCopyClick(event: MouseEvent): void;
     onClearClick(event: MouseEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SuffixComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SuffixComponent, "spa-suffix", never, { "label": { "alias": "label"; "required": false; }; "infoMessage": { "alias": "infoMessage"; "required": false; }; "copyContent": { "alias": "copyContent"; "required": false; }; "isHovered": { "alias": "isHovered"; "required": false; }; "clearContent": { "alias": "clearContent"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "infoClick": "infoClick"; "copyClick": "copyClick"; "clearClick": "clearClick"; "valueChange": "valueChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SuffixComponent, "spa-suffix", never, { "label": { "alias": "label"; "required": false; }; "infoMessage": { "alias": "infoMessage"; "required": false; }; "copyContent": { "alias": "copyContent"; "required": false; }; "isHovered": { "alias": "isHovered"; "required": false; }; "clearContent": { "alias": "clearContent"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "alwaysShow": { "alias": "alwaysShow"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "infoClick": "infoClick"; "copyClick": "copyClick"; "clearClick": "clearClick"; "valueChange": "valueChange"; }, never, never, false, never>;
 }
 
 declare class TermsDialogComponent {
@@ -2262,7 +2327,9 @@ declare class TextComponent implements OnInit, OnChanges {
     onMouseLeave(): void;
     initControl(): void;
     leaved(): void;
+    inputEl: ElementRef<HTMLInputElement>;
     clear(): void;
+    private focusInput;
     enterPressed(): void;
     control: FormControl<string>;
     private getValidators;
@@ -2815,6 +2882,7 @@ declare class MenuSourceService {
     private static readonly roleMetadata;
     private hasAnyCapability;
     isVisible(cap: CapItem): boolean;
+    hasVisibleEntry(capItem: CapItem): boolean;
     sections(): MenuSection[];
     visibleItems(): CapItem[];
     matchLink(route: string, items: CapItem[]): CapItem | null;
@@ -3022,5 +3090,5 @@ declare class SpaCoreModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<SpaCoreModule>;
 }
 
-export { Account, AccountingService, Action, AlertConfig, AlertMessage, ApiErrorService, ApiResponse, AppConfig, AssetStatus, AuthService, BottomTab, CacheConfig, CapItem, ChangeUserPassword, ChartConfig, ConfigService, Constants, Core, CreditNoteStatus, DataServiceLib, DateBounds, DetailsDialogConfig, DetailsDialogProcessor, DetailsSource, FilterChipConfig, FiscalPeriodStatus, FormConfig, GRID_MENU_ROUTE, GRID_MENU_TAB, GeneralService, HttpService, InventoryService, InvoiceItemType, InvoiceStatus, LastRouteService, ListDialogConfig, LoansService, LogLevel, LogService, MenuSourceService, MessageService, MovementType, NotesConfig, NotificationsService, OfflineService, PageConfig, PaginationConfig, PayrollService, PreferencesService, PrivacyDialogComponent, ProductionService, Profile, PurchaseStatus, PurchasingService, QuoteStatus, REDACTED, ReceiptDialogComponent, ReceiptStatus, RedactingSignalRLogger, Register, Role, RoleAccess, SalesService, SearchConfig, SecurityConfig, SetupService, SignalRService, SignupData, SpaCoreModule, SpaMatModule, Step, StepConfig, StorageService, SubscriptionService, SuffixComponent, TIN_INLINE_ERRORS, TIN_LOGIN_TIER_HTTP_PROVIDERS, TIN_SILENT_REQUEST, TIN_SPA_RUNTIME_CONFIG, TableConfig, TermsDialogComponent, TextComponent, TextMaskComponent, TileConfig, TransactionTiming, UnitOfMeasure, User, derivePlaceholder, describeError, describeShape, dialogOptions, getTinSpaAppSettings, isInlineErrorRequest, isSilentRequest, loadTinSpaAppSettings, loginConfig, messageDialog, phraseSatisfied, provideTinSpaRuntime, redactSecrets, silentContext, tinRequestContext, tinSpaLocationStrategyFactory, tinSpaMsalInstanceFactory, tinSpaRuntimeConfigFactory };
-export type { ApiErrorInfo, ApiErrorKind, AppConfigSection, AppConfigurationConfig, AppFailureClass, AppFailureContext, AutoRefreshConfig, BitwiseOption, Button, CacheRule, CapsuleConfig, CardConfig, ChartItem, ChecklistAction, ChecklistConfig, ChecklistItem, ChildField, CloseOptions, Color, Column, Confirm, CreateTabConfig, DayBookButtonView, DayBookColumnPresentation, DayBookColumnView, DayBookConfig, DayBookLane, DayBookPresentation, DayBookSection, DayBookStage, DayBookStageTiles, DayBookTableView, DocumentError, DocumentKind, DocumentSource, DocumentViewerData, EntityChangeEvent, Field, FilterChip, GroupConfig, GroupData, Icon, ImportConfig, InlineEditConfig, InlineLoadError, LoadedDocument, MenuSection, NoAccessInfo, NotificationEvent, OfflineConfig, OfflineEntry, OfflineOpStatus, OrderableConfig, OutboxOp, PlaceholderKind, RefreshResult, SearchField, SetupApprovalPreset, SetupConfig, SetupModule, SetupNotificationPreset, SetupPreset, SetupPresetCatalog, SetupPresetRole, SetupPresetSelection, SetupRoleTemplate, SetupSeedOffer, SetupStatus, SetupStep, SetupStepAction, SpaChartType, StatusConfig, StatusItem, StatusState, TableDialogConfig, TableSectionChip, TableSectionConfig, TableViewType, Tile, TileChartConfig, TileChartType, TileStyle, TinSpaAppSettings, TinSpaMsalConfig, TinSpaMsalSettings, TinSpaRuntimeConfig, TinSpaTableDefaults, UserPreferences, VehiclePositionFrame, VisibilityValue };
+export { Account, AccountingService, Action, AlertConfig, AlertMessage, ApiErrorService, ApiResponse, AppConfig, AssetStatus, AuthService, BottomTab, CacheConfig, CapItem, ChangeUserPassword, ChartConfig, ConfigService, Constants, Core, CreditNoteStatus, DashboardConfig, DataServiceLib, DateBounds, DetailsDialogConfig, DetailsDialogProcessor, DetailsSource, FilterChipConfig, FiscalPeriodStatus, FormConfig, GRID_MENU_ROUTE, GRID_MENU_TAB, GeneralService, HttpService, InventoryService, InvoiceItemType, InvoiceStatus, LastRouteService, ListDialogConfig, LoansService, LogLevel, LogService, MenuSourceService, MessageService, MovementType, NotesConfig, NotificationsService, OfflineService, PageConfig, PaginationConfig, PayrollService, PreferencesService, PrivacyDialogComponent, ProductionService, Profile, PurchaseStatus, PurchasingService, QuoteStatus, REDACTED, ReceiptDialogComponent, ReceiptStatus, RedactingSignalRLogger, Register, Role, RoleAccess, SalesService, SearchConfig, SecurityConfig, SetupService, SignalRService, SignupData, SpaCoreModule, SpaMatModule, Step, StepConfig, StorageService, SubscriptionService, SuffixComponent, TIN_INLINE_ERRORS, TIN_LOGIN_TIER_HTTP_PROVIDERS, TIN_SILENT_REQUEST, TIN_SPA_RUNTIME_CONFIG, TableConfig, TermsDialogComponent, TextComponent, TextMaskComponent, TileConfig, TransactionTiming, UnitOfMeasure, User, derivePlaceholder, describeError, describeShape, dialogOptions, getTinSpaAppSettings, isInlineErrorRequest, isSilentRequest, loadTinSpaAppSettings, loginConfig, messageDialog, phraseSatisfied, provideTinSpaRuntime, redactSecrets, silentContext, tinRequestContext, tinSpaLocationStrategyFactory, tinSpaRuntimeConfigFactory };
+export type { ApiErrorInfo, ApiErrorKind, AppConfigSection, AppConfigurationConfig, AppFailureClass, AppFailureContext, AutoRefreshConfig, BitwiseOption, Button, CacheRule, CapsuleConfig, CardConfig, ChartItem, ChecklistAction, ChecklistConfig, ChecklistItem, ChildField, CloseOptions, Color, Column, Confirm, CreateTabConfig, DashboardSection, DayBookButtonView, DayBookColumnPresentation, DayBookColumnView, DayBookConfig, DayBookLane, DayBookPresentation, DayBookSection, DayBookStage, DayBookStageTiles, DayBookTableView, DocumentError, DocumentKind, DocumentSource, DocumentViewerData, EntityChangeEvent, EntityInvalidatedEvent, Field, FilterChip, GroupConfig, GroupData, Icon, ImportConfig, InlineEditConfig, InlineLoadError, LoadedDocument, MenuSection, NoAccessInfo, NotificationEvent, OfflineConfig, OfflineEntry, OfflineOpStatus, OrderableConfig, OutboxOp, PlaceholderKind, RefreshResult, SearchField, SetupApprovalPreset, SetupConfig, SetupModule, SetupNotificationPreset, SetupPreset, SetupPresetCatalog, SetupPresetRole, SetupPresetSelection, SetupRoleTemplate, SetupSeedOffer, SetupStatus, SetupStep, SetupStepAction, SpaChartType, StatusConfig, StatusItem, StatusState, TableDialogConfig, TableSectionChip, TableSectionConfig, TableViewType, Tile, TileChartConfig, TileChartType, TileStyle, TinSpaAppSettings, TinSpaMsalConfig, TinSpaMsalSettings, TinSpaRuntimeConfig, TinSpaTableDefaults, UserPreferences, VehiclePositionFrame, VisibilityValue };