@acorex-platform/framework-client 0.0.15 → 0.0.20

package/types/acorex-platform-framework-client-core.d.ts

@@ -1,13 +1,15 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Type, OnInit, ViewContainerRef, ModuleWithProviders, ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, OnDestroy, DestroyRef, Injector, PipeTransform, Provider } from '@angular/core';
+import { InjectionToken, Type, OnInit, ViewContainerRef, ModuleWithProviders, ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, OnDestroy, DestroyRef, Provider, Injector, PipeTransform } from '@angular/core';
 import * as _acorex_platform_framework_shared_core from '@acorex-platform/framework-shared/core';
-import { AXPApplicationUserReference, AXPEntityReference, AXPSystemActionType, AXPMultiLanguageString, AXPOptionsData, AXPFilterDefinition, AXPMaybePromise, AXPContextData, AXPContextState, AXPContextChangeEvent, AXPContextUpdateOptions, AXPContextPatchOptions, AXPGridLayoutOptions, AXPKeyboardShortcutDirectionBehavior, AXPKeyboardShortcutChord, AXPKeyboardShortcut, AXPResolvedKeyboardShortcut, AXPKeyboardShortcutRegistration, AXPKeyboardShortcutHelpEntry, AXPPlatformScope, AXPWidgetNode, AXPActionMenuItem } from '@acorex-platform/framework-shared/core';
-import { AXDataSource, AXDataSourceFilterOption, AXDataSourceQuery, AXDataSourceCallbackResult, AXDataSourceSortOption } from '@acorex/cdk/common';
+import { AXPApplicationUserReference, AXPEntityReference, AXPSystemActionType, AXPMultiLanguageString, AXPContextData, AXPOptionsData, AXPContextState, AXPContextChangeEvent, AXPContextUpdateOptions, AXPContextPatchOptions, AXPContextDefinition, AXPGridLayoutOptions, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPKeyboardShortcutDirectionBehavior, AXPKeyboardShortcutChord, AXPKeyboardShortcut, AXPResolvedKeyboardShortcut, AXPKeyboardShortcutRegistration, AXPKeyboardShortcutHelpEntry, AXPPlatformScope, AXPWidgetNode, AXPActionMenuItem } from '@acorex-platform/framework-shared/core';
+export { AXPContextCapability, AXPContextDefinition, axpContextDefinitionIsAiPrompt } from '@acorex-platform/framework-shared/core';
 import * as _ngrx_signals from '@ngrx/signals';
 import { Observable } from 'rxjs';
+import { AXPEntityRefreshMeta, AXPEntityCreatedPayload, AXPEntityDeletedPayload, AXPEntityModifiedPayload, AXPEntityRefreshLayoutPayload, AXPEntityRefreshDataPayload } from '@acorex-platform/framework-shared/entity';
 import { AXFormatService } from '@acorex/core/format';
 import { AXPopupSizeType } from '@acorex/components/popup';
 import { NavigationExtras } from '@angular/router';
+import { AXDataSourceFilterOption, AXDataSourceQuery, AXDataSourceCallbackResult, AXDataSourceSortOption } from '@acorex/cdk/common';
 
 interface AXPActivityLogChange {
     type: AXPSystemActionType;
@@ -18,6 +20,11 @@ interface AXPActivityLogChange {
     fieldKeyParams?: Record<string, string>;
     /** I18n key for action (e.g. @activity-log:changes.replaced). When set with fieldKey, overrides description. */
     actionKey?: string;
+    /**
+     * Ready-to-display field label (already resolved / server-stamped).
+     * When set with {@link summary}, preferred over fieldKey/actionKey.
+     */
+    fieldLabel?: string;
     oldValue?: unknown;
     newValue?: unknown;
     /** Short human-readable summary for Change History (e.g. "Updated from 'X' to 'Y'"). Used when layout is present. */
@@ -107,56 +114,6 @@ declare class AXPCatalogScopeDefinitionProviderService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPCatalogScopeDefinitionProviderService>;
 }
 
-interface AXPDataSourceDataFieldDefinition {
-    name: string;
-    title: string;
-    datatype: string;
-    type: string;
-    options?: AXPOptionsData;
-}
-type AXPLazyDataSource<T = unknown> = AXPMaybePromise<AXDataSource<T>>;
-type AXPDataSourceArray<T = unknown> = AXPMaybePromise<Array<T>>;
-type AXPDataSourceValue<T = unknown> = AXPMaybePromise<T>;
-type AXPDataSourceType<T = any> = AXPLazyDataSource<T> | AXPDataSourceArray<T> | AXPDataSourceValue<T>;
-type AXPDataSourceSample<T = any> = AXPDataSourceArray<T> | AXPDataSourceValue<T>;
-interface AXPDataSourceDefinition<T = any> {
-    name: string;
-    title: string;
-    valueField?: {
-        name: string;
-        title: string;
-    };
-    textField?: {
-        name: string;
-        title: string;
-    };
-    columns: AXPDataSourceDataFieldDefinition[];
-    filters: AXPFilterDefinition[];
-    samples?: AXPDataSourceSample<T>;
-    visible?: boolean;
-    source: () => AXPDataSourceType<T>;
-}
-interface AXPDataSourceDefinitionProvider {
-    items(): Promise<AXPDataSourceDefinition[]>;
-}
-declare const AXP_DATASOURCE_DEFINITION_PROVIDER: InjectionToken<AXPDataSourceDefinitionProvider[]>;
-declare class AXPDataSourceDefinitionProviderService implements AXPDataSourceDefinitionProvider {
-    private providers;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    get<T = any>(name: string): Promise<AXPDataSourceDefinition<T> | undefined>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDataSourceDefinitionProviderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPDataSourceDefinitionProviderService>;
-}
-
-/**
- * Registered catalog scopes for select / selection-list widgets via {@link AXPPlatformCoreDataSourceKeys.CatalogScopes}.
- */
-declare class AXPCatalogScopeDefinitionsDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly catalogScopeRegistry;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    private readTargetFilter;
-}
-
 /**
  * Represents a color palette with a unique identifier and collection of colors
  */
@@ -582,51 +539,6 @@ declare const AXPContextStore: i0.Type<{
 /** Trace namespace for form dirty-state diagnostics (lookup/select revert, discard, baseline). */
 declare const FORM_DIRTY_TRACE_NS = "FORM STATE";
 
-/**
- * Compact hints for assembling platform context into LLM system prompts.
- * Mirrors fields used by {@link AXPAiPlatformRuntimeContext} and the mock engine runtime prompt
- * formatter — keep labels short and values bounded.
- */
-interface AXPContextDefinitionAiHints {
-    /**
-     * Short English label for bullet lists (e.g. `UI locale`, `Current instant (UTC, ISO 8601)`).
-     */
-    promptLabel?: string;
-    /**
-     * One-line guidance for the model (when to use this value, what not to ask the user).
-     */
-    usageHint?: string;
-    /**
-     * When `false`, this definition is omitted from AI system-prompt assembly. Default `true`.
-     */
-    includeInSystemPrompt?: boolean;
-    /**
-     * How to stringify the value compactly in prompts.
-     */
-    valueKind?: 'string' | 'number' | 'boolean' | 'instant' | 'locale' | 'dateTime' | 'object';
-    /**
-     * When `true`, the value must not be sent to the model (PII, secrets, tokens).
-     */
-    sensitive?: boolean;
-    /**
-     * Sort order when rendering the AI context block (lower first).
-     */
-    order?: number;
-}
-/**
- * Describes a named platform context key (e.g. `currentDate`, `language`).
- */
-interface AXPContextDefinition {
-    /** Stable identifier used as the context key and in expressions. */
-    name: string;
-    /** Human-readable title for designers and tooling. */
-    title: string;
-    /** What this context represents and when consumers should use it. */
-    description: string;
-    /** Optional metadata for AI system-prompt assembly. */
-    ai?: AXPContextDefinitionAiHints;
-}
-
 interface AXPContextDefinitionProvider {
     items(): Promise<AXPContextDefinition[]>;
 }
@@ -717,72 +629,6 @@ type AXPValueTransformerFunctions = {
 };
 declare function objectKeyValueTransforms(keyName: string): AXPValueTransformerFunctions;
 
-interface AXPDataSourceQueryOptions {
-    /** Field used as AXDataSource key / widget valueField. Defaults to definition valueField.name or `id`. */
-    valueField?: string;
-    /** When true, resolve from definition.samples instead of source(). */
-    useSamples?: boolean;
-    /** Retry definition lookup while registry providers are still loading. */
-    waitForRegistry?: boolean;
-    /** Max attempts when waitForRegistry is true (default 20). */
-    maxRegistryAttempts?: number;
-    /** Delay between registry retry attempts in ms (default 50). */
-    registryRetryDelayMs?: number;
-}
-interface AXPDataSourceQueryResult {
-    name: string;
-    ready: boolean;
-    dataSource: AXDataSource | null;
-    definition?: AXPDataSourceDefinition;
-    valueField: string;
-    textField: string;
-    error?: unknown;
-}
-/**
- * Resolves registry-backed {@link AXDataSource} instances and exposes readiness (`isReady`, `whenReady`)
- * so widgets do not bind selected values before the provider datasource is available.
- */
-declare class AXPDataSourceQueryService {
-    private readonly definitionService;
-    private readonly entries;
-    /**
-     * Returns true when the named registry datasource has been resolved for the given options.
-     */
-    isReady(name: string, options?: AXPDataSourceQueryOptions): boolean;
-    /**
-     * Emits once when the registry datasource is resolved (or fails) for the given options.
-     */
-    whenReady(name: string, options?: AXPDataSourceQueryOptions): Observable<AXPDataSourceQueryResult>;
-    /**
-     * Resolves and returns the {@link AXDataSource} for a registry name, waiting for providers when needed.
-     */
-    getDataSource(name: string, options?: AXPDataSourceQueryOptions): Promise<AXDataSource | null>;
-    /**
-     * Resolves the registry datasource, then looks up one or more keys via `byKey`.
-     */
-    queryByKey(name: string, key: unknown, options?: AXPDataSourceQueryOptions): Promise<unknown>;
-    /**
-     * Fully resolves a registry datasource (definition + AXDataSource instance).
-     */
-    resolve(name: string, options?: AXPDataSourceQueryOptions): Promise<AXPDataSourceQueryResult>;
-    /**
-     * Clears cached query state. Pass a registry name to invalidate one datasource, or omit to clear all.
-     */
-    invalidate(name?: string): void;
-    private ensureLoading;
-    private loadEntry;
-    private waitForDefinition;
-    private createDataSource;
-    private resolveSamples;
-    private applyValueFieldAsKey;
-    private wrapTranslatedDataSource;
-    private translateItem;
-    private buildCacheKey;
-    private sleep;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDataSourceQueryService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPDataSourceQueryService>;
-}
-
 declare class AXPContentCheckerDirective {
     viewContainerRef: ViewContainerRef;
     elementRef: ElementRef<HTMLDivElement>;
@@ -887,15 +733,42 @@ declare class AXPDistributedEventListenerService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPDistributedEventListenerService>;
 }
 
+type AXPBroadcastPublishStrategy = 'debounce' | 'throttle';
+/**
+ * Optional publish-side policy that collapses rapid duplicate dispatches for an event type.
+ * Applied before channel post + local Subject echo.
+ */
+interface AXPBroadcastPublishPolicy<T = unknown> {
+    /** Collapse window in this window (ms). */
+    windowMs: number;
+    /**
+     * `debounce` (default): trailing — wait for quiet window, then dispatch once (merged).
+     * `throttle`: leading — dispatch first immediately; drop/merge later ones until window ends.
+     */
+    strategy?: AXPBroadcastPublishStrategy;
+    /** Groups publishes that should collapse together. Default: one bucket per event type. */
+    key?: (payload: T | undefined) => string;
+    /** Combine payloads in the window. Default: last write wins. */
+    merge?: (previous: T | undefined, incoming: T | undefined) => T | undefined;
+}
 declare class AXPBroadcastEventService implements OnDestroy {
     private channel;
     private eventSubjects;
     private pendingRequests;
     private multiTabEventHistory;
     private readonly instanceId;
+    private readonly publishPolicies;
+    private readonly pendingPublishes;
     constructor();
     /**
-     * Publish an event without expecting a response
+     * Registers a publish-side debounce/throttle policy for an event type.
+     * Prevents duplicate dispatches (channel + local echo) for rapid identical/grouped publishes.
+     */
+    setPublishPolicy<T>(type: string, policy: AXPBroadcastPublishPolicy<T>): void;
+    clearPublishPolicy(type: string): void;
+    /**
+     * Publish an event without expecting a response.
+     * When a {@link setPublishPolicy} exists for `type`, rapid publishes are collapsed before dispatch.
      */
     publish<T>(type: string, payload?: T): void;
     /**
@@ -925,10 +798,51 @@ declare class AXPBroadcastEventService implements OnDestroy {
      * Cleanup when the service is destroyed
      */
     ngOnDestroy(): void;
+    private dispatchPublish;
+    private publishDebounced;
+    private publishThrottled;
+    private clearPendingForType;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPBroadcastEventService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPBroadcastEventService>;
 }
 
+/**
+ * Typed publish/listen helpers for entity UI events over {@link AXPBroadcastEventService}.
+ * Layout refresh publishes are debounced per entity name on the broadcast service
+ * so local + realtime echoes collapse before dispatch.
+ */
+declare class AXPEntityBroadcastService {
+    private readonly broadcast;
+    constructor();
+    publishLayoutRefresh(name: string, meta?: AXPEntityRefreshMeta): void;
+    publishDataReload(name: string, meta?: AXPEntityRefreshMeta): void;
+    publishCreated(payload: AXPEntityCreatedPayload): void;
+    publishDeleted(payload: AXPEntityDeletedPayload): void;
+    publishModified(payload: AXPEntityModifiedPayload): void;
+    listenLayoutRefresh(): Observable<{
+        data: AXPEntityRefreshLayoutPayload;
+        requestId?: string;
+    }>;
+    listenDataReload(): Observable<{
+        data: AXPEntityRefreshDataPayload;
+        requestId?: string;
+    }>;
+    listenCreated(): Observable<{
+        data: AXPEntityCreatedPayload;
+        requestId?: string;
+    }>;
+    listenDeleted(): Observable<{
+        data: AXPEntityDeletedPayload;
+        requestId?: string;
+    }>;
+    listenModified(): Observable<{
+        data: AXPEntityModifiedPayload;
+        requestId?: string;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPEntityBroadcastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPEntityBroadcastService>;
+}
+
 /** Registered {@link AXFormatService} formatter name (e.g. `date`, `translate`, custom). */
 type AXPContextEvalPipeName = string;
 interface AXPContextEvalPipeSpec {
@@ -981,33 +895,16 @@ declare function contextEvalWithPipes(data: Record<string, unknown>, path: strin
  */
 declare function normalizeExpressionTemplate(template: string): string;
 
-type AXPExpressionEvaluatorScope = {
-    [name: string]: {
-        [name: string]: Function;
-    };
-};
 declare class AXPExpressionEvaluatorService {
-    private expressionCache;
-    private providerService;
-    private getOrCompileFunction;
+    private readonly engine;
+    private readonly providerService;
     private getMergedScope;
     evaluate(source: any | any[], scope?: AXPExpressionEvaluatorScope): Promise<any>;
-    private evaluateStringExpression;
     isExpression(expression: string): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPExpressionEvaluatorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPExpressionEvaluatorService>;
 }
 
-interface AXPExpressionEvaluatorScopeProvider {
-    provide(context: AXPExpressionEvaluatorScopeProviderContext): Promise<void>;
-}
-declare class AXPExpressionEvaluatorScopeProviderContext {
-    private scopes;
-    addScope(namespace: string, functions: {
-        [name: string]: Function;
-    }): void;
-    getScopes(): AXPExpressionEvaluatorScope;
-}
 type AXPExpressionEvaluatorScopeProviders = AXPExpressionEvaluatorScopeProvider[] | (() => AXPExpressionEvaluatorScopeProvider[]);
 declare const AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER: InjectionToken<AXPExpressionEvaluatorScopeProviders>;
 declare class AXPExpressionEvaluatorScopeProviderService {
@@ -1331,7 +1228,7 @@ declare class AXPLogoRegistryService {
 
 interface AXPEntityLogoSource {
     id: string;
-    title?: string;
+    title?: AXPMultiLanguageString;
     logo?: string;
 }
 declare class AXPEntityLogoRegistrationService {
@@ -1415,6 +1312,53 @@ declare const OVERLAY_DETAILS_VIEW_TRACE_NS = "OVERLAY-DETAILS-VIEW";
 /** Widget tree mount / settle polling ({@link AXPWidgetContainerComponent}). */
 declare const OVERLAY_WIDGET_SETTLE_TRACE_NS = "OVERLAY-WIDGET-SETTLE";
 
+/**
+ * Packaging kind for edition modules checklist (view mode: By Type).
+ */
+declare const AXP_MODULE_TYPE: {
+    readonly platform: "platform";
+    readonly domain: "domain";
+    readonly integration: "integration";
+};
+type AXPModuleType = (typeof AXP_MODULE_TYPE)[keyof typeof AXP_MODULE_TYPE];
+/**
+ * Business-area domain for edition modules checklist (view mode: By Domain).
+ * Aligns with integration domain ids where applicable.
+ */
+declare const AXP_MODULE_DOMAIN: {
+    readonly platform: "platform";
+    readonly humanCapital: "human-capital";
+    readonly projectManagement: "project-management";
+    readonly assetMaintenance: "asset-maintenance";
+    readonly workplaceSafety: "workplace-safety";
+    readonly assessmentLearning: "assessment-learning";
+    readonly financeCommerce: "finance-commerce";
+    readonly customerSupplier: "customer-supplier";
+    readonly communication: "communication";
+    readonly ai: "ai";
+    readonly contentDocuments: "content-documents";
+    readonly data: "data";
+    readonly operations: "operations";
+    readonly weather: "weather";
+    readonly sourceControl: "source-control";
+    readonly general: "general";
+};
+type AXPModuleDomain = (typeof AXP_MODULE_DOMAIN)[keyof typeof AXP_MODULE_DOMAIN];
+/**
+ * Resolves module packaging type with fallbacks when unset on the manifest.
+ */
+declare function resolveModuleType(manifest: {
+    type?: AXPModuleType;
+    required?: boolean;
+    name: string;
+}): AXPModuleType;
+/**
+ * Resolves module business domain with fallback when unset on the manifest.
+ */
+declare function resolveModuleDomain(manifest: {
+    domain?: string;
+}): string;
+
 /**
  * Feature definition in module manifest.
  * Defines available features with default values.
@@ -1493,10 +1437,21 @@ interface AXPModuleManifest {
      */
     dependencies?: string[];
     /**
-     * Whether this module is required (always enabled, cannot be disabled).
-     * Required modules like 'auth' and 'common' are always available.
-     */
+       * Whether this module is required (always enabled, cannot be disabled).
+       * Required modules like 'auth' and 'common' are always available.
+       */
     required?: boolean;
+    /**
+     * Packaging kind for edition modules UI grouping (By Type).
+     * Falls back via {@link resolveModuleType} when omitted.
+     */
+    type?: AXPModuleType;
+    /**
+     * Business-area domain id for edition modules UI grouping (By Domain).
+     * Use values from {@link AXP_MODULE_DOMAIN} (or matching integration domain ids).
+     * Falls back via {@link resolveModuleDomain} when omitted.
+     */
+    domain?: string;
     /**
      * Additional metadata
      */
@@ -1527,14 +1482,6 @@ interface AXPFeatureDefinition extends AXPModuleFeatureDefinition {
     key: string;
 }
 
-/**
- * Data source definition for module names/titles from {@link AXPModuleManifestRegistry}.
- */
-declare class AXPModuleManifestsDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly manifestRegistry;
-    items(): Promise<AXPDataSourceDefinition[]>;
-}
-
 /**
  * Registry service for module manifests.
  * Collects and manages all registered module manifests.
@@ -1617,20 +1564,67 @@ declare class AXPModuleManifestRegistry {
 
 interface AXPStartUpTask {
     name: string;
-    statusText: AXPMultiLanguageString;
+    /** Splash status while this task runs. Omit for silent / registration-only work. */
+    statusText?: AXPMultiLanguageString;
     priority: number;
     run: () => Promise<void>;
 }
+/**
+ * Multi provider for declarative app-startup tasks.
+ * Collected once by {@link AXPAppStartUpProvider} — do not use APP_INITIALIZER in features.
+ */
+/** Multi token — `inject()` yields the full task array (each provider contributes one task). */
+declare const AXP_APP_STARTUP_TASK: InjectionToken<readonly AXPStartUpTask[]>;
+/** Suggested priority bands for client startup tasks (lower runs first). */
+declare const AXP_APP_STARTUP_PRIORITY: {
+    readonly sessionRestore: 0;
+    readonly moduleManifests: 1;
+    /** Platform-scoped settings (no auth); runs before tenant/user settings load. */
+    readonly platformSettings: 2;
+    readonly settings: 3;
+    readonly idleLockRestore: 3;
+    /** After settings: redirect when platform settings bootstrap failed. */
+    readonly platformSettingsFailureRedirect: 3.5;
+    readonly conversationSessionSync: 4;
+    readonly regionalSettings: 5;
+    readonly terms: 6;
+    /** Topic handlers / bridges that must exist before the socket connects. */
+    readonly realtimeHandlers: 40;
+    /** Long-lived subscriptions that listen to connection/bus streams. */
+    readonly realtimeSubscriptions: 45;
+    readonly realtimeConnect: 50;
+    readonly activityInsight: 80;
+    readonly layoutTheme: 100;
+};
+/** Register one startup task via the multi token (preferred over APP_INITIALIZER). */
+declare function provideAppStartUpTask(factory: () => AXPStartUpTask): Provider;
 
 declare class AXPAppStartUpService {
     private readonly translationService;
     private tasks;
+    /** When true, only {@link PLATFORM_SETTINGS_FAILURE_REDIRECT_TASK} may still run. */
+    private bootstrapAborted;
     registerTask(task: AXPStartUpTask): void;
+    /**
+     * Abort remaining startup work after a fatal platform-settings failure.
+     * Keeps {@link PLATFORM_SETTINGS_FAILURE_REDIRECT_TASK} so unavailable navigation can run.
+     * Prevents later tasks (settings / regional / theme) from hanging APP_INITIALIZER on API calls.
+     */
+    abortRemainingStartupTasks(): void;
+    /**
+     * @deprecated Prefer {@link abortRemainingStartupTasks}.
+     * Skip tasks with priority greater than {@link priority}.
+     */
+    skipTasksAfter(priority: number): void;
     runAllTasks(): Promise<void>;
     private updateStatus;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPAppStartUpService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPAppStartUpService>;
 }
+/**
+ * Sole Angular APP_INITIALIZER for platform bootstrap.
+ * Collects {@link AXP_APP_STARTUP_TASK} providers, then runs all registered tasks.
+ */
 declare const AXPAppStartUpProvider: i0.EnvironmentProviders;
 
 /**
@@ -1834,45 +1828,41 @@ declare abstract class AXPTagProvider {
 declare const AXP_TAG_PROVIDER: InjectionToken<AXPTagProvider[]>;
 
 /**
- * Service for managing tags from multiple providers
- * Aggregates tags from all registered providers
+ * Aggregates tags from registered providers with an in-memory catalog cache.
+ * Concurrent {@link getTags} / {@link reload} share one in-flight load (no stampede).
  */
 declare class AXPTagService {
     private providers;
     private cache;
+    /** Shared promise while providers are loading; cleared when settled. */
+    private loadPromise;
     /**
-     * Get all tags from all providers
-     * @param options Filter options
-     * @returns Promise of tags
+     * Get all tags from all providers (memory cache after first successful load).
      */
     getTags(options?: AXPTagFilterOptions): Promise<AXPTag[]>;
+    /** Sync snapshot of the cached catalog (empty until first successful load). */
+    peekCatalog(): AXPTag[];
+    /** True when the in-memory catalog has been loaded at least once. */
+    isCatalogReady(): boolean;
     /**
-     * Create a new tag using the appropriate provider
-     * @param tag Tag to create
-     * @param providerName Provider to use (defaults to first writable provider)
-     * @returns Created tag
+     * Create a new tag using the appropriate provider.
      */
     createTag(tag: Omit<AXPTag, 'id'>, providerName?: string): Promise<AXPTag>;
     /**
-     * Update an existing tag
-     * @param tag Tag to update
-     * @returns Updated tag
+     * Update an existing tag.
      */
     updateTag(tag: AXPTag): Promise<AXPTag>;
     /**
-     * Delete a tag
-     * @param tagId Tag id to delete
-     * @param scope Tag scope
+     * Delete a tag.
      */
     deleteTag(tagId: string, scope: string): Promise<void>;
     /**
-     * Reload tags from all providers
+     * Force reload tags from all providers.
      */
     reload(): Promise<void>;
-    /**
-     * Load tags from all providers
-     */
-    private loadTags;
+    private invalidateCatalog;
+    private ensureCatalog;
+    private loadTagsFromProviders;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPTagService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPTagService>;
 }
@@ -2063,15 +2053,15 @@ declare class AXHighlightService {
  *
  * @example
  * ```typescript
- * export class AXMAuthDataSourceProvider implements AXPDataSourceDefinitionProvider {
+ * export class AXMMyFeatureProvider {
  *   constructor(private readonly injector: Injector) {}
  *
  *   async items() {
- *     const userActivity = instantiateWithInjectionContext(
+ *     const nested = instantiateWithInjectionContext(
  *       this.injector,
- *       AXMUserActivityDataSourceDefinition,
+ *       AXMNestedProvider,
  *     );
- *     return [...(await userActivity.items())];
+ *     return [...(await nested.items())];
  *   }
  * }
  * ```
@@ -2112,8 +2102,8 @@ declare function createProviderWithInjectionContext<T>(injector: Injector, loade
  * ```typescript
  * // Multi-provider (default)
  * provideLazyProvider(
- *   AXP_DATASOURCE_DEFINITION_PROVIDER,
- *   () => import('./datasource.provider').then(m => m.AXMDataSourceProvider)
+ *   AXP_SOME_MULTI_TOKEN,
+ *   () => import('./feature.provider').then(m => m.AXMFeatureProvider)
  * )
  *
  * // Single provider
@@ -2126,5 +2116,5 @@ declare function createProviderWithInjectionContext<T>(injector: Injector, loade
  */
 declare function provideLazyProvider<TProvider>(token: InjectionToken<any>, loader: () => Promise<new (injector?: Injector) => TProvider>, multi?: boolean): Provider;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextDefinitionProviderService, AXPContextEvalFactory, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDataSourceQueryService, AXPDblClickDirective, AXPDebugService, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPEntityLogoRegistrationService, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPIdleSchedulerService, AXPImageUrlLogoConfig, AXPKeyboardShortcutRegistry, AXPLogoComponent, AXPLogoRegistryService, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPScreenSize, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_ENTITY_LOGO_FALLBACK_RESOLVER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_LOGO_IMAGE_SRC_RESOLVER, AXP_LOGO_PROVIDER, AXP_LOGO_THEME_RESOLVER, AXP_MODULE_MANIFEST_PROVIDER, AXP_PLATFORM_LOGO_KEY, AXP_SESSION_SERVICE, AXP_SETTINGS_DEFINITION_DIALOG_OPENER, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS, DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS, FORM_DIRTY_TRACE_NS, OVERLAY_DETAILS_VIEW_TRACE_NS, OVERLAY_LAYOUT_TRACE_NS, OVERLAY_ROOT_LAYOUT_TRACE_NS, OVERLAY_WIDGET_SETTLE_TRACE_NS, applyContextEvalPipes, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, axpApplicationLogoKey, axpExtractLogoUrl, axpSsoLogoKey, axpTenantLogoKey, chordToKbdItemKeys, contextEvalWithPipes, createProviderWithInjectionContext, defaultColumnWidthProvider, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, instantiateWithInjectionContext, isDialogShortcutAllowedInEditableField, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isMacPlatform, isVisibleOverlayElement, matchesDialogActionShortcut, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeContextEvalPipes, normalizeDialogActionShortcutChord, normalizeExpressionTemplate, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseDialogActionShortcut, parseKeyboardShortcutChord, provideLazyProvider, registerPopupFooterKeyboardShortcuts, resolveConfiguredFooterActionShortcuts, resolveDialogActionShortcuts, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolveSemanticDirectionalKey, setupPopupFooterKeyboardShortcuts, shouldDeferEscapeToOpenOverlay, shouldTriggerDialogActionShortcut };
-export type { AXPActivityLog, AXPActivityLogChange, AXPCatalogScopeDefinition, AXPCatalogScopeDefinitionProvider, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContextDefinition, AXPContextDefinitionAiHints, AXPContextDefinitionProvider, AXPContextEvalFn, AXPContextEvalOptions, AXPContextEvalPipe, AXPContextEvalPipeName, AXPContextEvalPipeSpec, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceQueryOptions, AXPDataSourceQueryResult, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDebugData, AXPDebugDataFactory, AXPDebugDataInput, AXPDialogActionOptions, AXPDialogActionShortcut, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityLogoFallbackResolver, AXPEntityLogoSource, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPISessionService, AXPIdleSchedulerEnqueueOptions, AXPIdleSchedulerWaitOptions, AXPKeyboardShortcutFormatOptions, AXPKeyboardShortcutRegisterOptions, AXPLazyDataSource, AXPLogoAppearance, AXPLogoFormat, AXPLogoImageSrcResolver, AXPLogoProvider, AXPLogoRequest, AXPLogoResolvedView, AXPLogoThemeResolver, AXPLogoView, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOpenSettingsDefinitionDialogConfig, AXPPopupFooterKeyboardShortcutsOptions, AXPPopupFooterKeyboardShortcutsSetupConfig, AXPPopupFooterShortcutAction, AXPSettingsDefinitionDialogOpenRequest, AXPSettingsDefinitionDialogOpener, AXPSettingsDefinitionDialogScope, AXPSettingsDefinitionDialogSection, AXPSettingsDefinitionDialogSetting, AXPSettingsDefinitionDialogSize, AXPStartUpTask, AXPTag, AXPTagFilterOptions, AXPValueTransformerFunction, AXPValueTransformerFunctions, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextDefinitionProviderService, AXPContextEvalFactory, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDblClickDirective, AXPDebugService, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPEntityBroadcastService, AXPEntityLogoRegistrationService, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPIdleSchedulerService, AXPImageUrlLogoConfig, AXPKeyboardShortcutRegistry, AXPLogoComponent, AXPLogoRegistryService, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPScreenSize, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_APP_STARTUP_PRIORITY, AXP_APP_STARTUP_TASK, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_ENTITY_LOGO_FALLBACK_RESOLVER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_LOGO_IMAGE_SRC_RESOLVER, AXP_LOGO_PROVIDER, AXP_LOGO_THEME_RESOLVER, AXP_MODULE_DOMAIN, AXP_MODULE_MANIFEST_PROVIDER, AXP_MODULE_TYPE, AXP_PLATFORM_LOGO_KEY, AXP_SESSION_SERVICE, AXP_SETTINGS_DEFINITION_DIALOG_OPENER, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS, DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS, FORM_DIRTY_TRACE_NS, OVERLAY_DETAILS_VIEW_TRACE_NS, OVERLAY_LAYOUT_TRACE_NS, OVERLAY_ROOT_LAYOUT_TRACE_NS, OVERLAY_WIDGET_SETTLE_TRACE_NS, applyContextEvalPipes, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, axpApplicationLogoKey, axpExtractLogoUrl, axpSsoLogoKey, axpTenantLogoKey, chordToKbdItemKeys, contextEvalWithPipes, createProviderWithInjectionContext, defaultColumnWidthProvider, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, instantiateWithInjectionContext, isDialogShortcutAllowedInEditableField, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isMacPlatform, isVisibleOverlayElement, matchesDialogActionShortcut, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeContextEvalPipes, normalizeDialogActionShortcutChord, normalizeExpressionTemplate, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseDialogActionShortcut, parseKeyboardShortcutChord, provideAppStartUpTask, provideLazyProvider, registerPopupFooterKeyboardShortcuts, resolveConfiguredFooterActionShortcuts, resolveDialogActionShortcuts, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolveModuleDomain, resolveModuleType, resolveSemanticDirectionalKey, setupPopupFooterKeyboardShortcuts, shouldDeferEscapeToOpenOverlay, shouldTriggerDialogActionShortcut };
+export type { AXPActivityLog, AXPActivityLogChange, AXPBroadcastPublishPolicy, AXPBroadcastPublishStrategy, AXPCatalogScopeDefinition, AXPCatalogScopeDefinitionProvider, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContextDefinitionProvider, AXPContextEvalFn, AXPContextEvalOptions, AXPContextEvalPipe, AXPContextEvalPipeName, AXPContextEvalPipeSpec, AXPDebugData, AXPDebugDataFactory, AXPDebugDataInput, AXPDialogActionOptions, AXPDialogActionShortcut, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityLogoFallbackResolver, AXPEntityLogoSource, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPISessionService, AXPIdleSchedulerEnqueueOptions, AXPIdleSchedulerWaitOptions, AXPKeyboardShortcutFormatOptions, AXPKeyboardShortcutRegisterOptions, AXPLogoAppearance, AXPLogoFormat, AXPLogoImageSrcResolver, AXPLogoProvider, AXPLogoRequest, AXPLogoResolvedView, AXPLogoThemeResolver, AXPLogoView, AXPModuleDomain, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPModuleType, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOpenSettingsDefinitionDialogConfig, AXPPopupFooterKeyboardShortcutsOptions, AXPPopupFooterKeyboardShortcutsSetupConfig, AXPPopupFooterShortcutAction, AXPSettingsDefinitionDialogOpenRequest, AXPSettingsDefinitionDialogOpener, AXPSettingsDefinitionDialogScope, AXPSettingsDefinitionDialogSection, AXPSettingsDefinitionDialogSetting, AXPSettingsDefinitionDialogSize, AXPStartUpTask, AXPTag, AXPTagFilterOptions, AXPValueTransformerFunction, AXPValueTransformerFunctions, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };