@acorex/platform 21.0.0-next.71 → 21.0.0-next.73

package/types/acorex-platform-layout-widget-core.d.ts

@@ -3,7 +3,7 @@ import { Signal, InjectionToken, ComponentRef, OnInit, EventEmitter, OnChanges,
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPOptionsData, AXPMultiLanguageString, AXPDefinitionCategory, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPContextUpdateOptions, AXPProperty, AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
+import { AXPOptionsData, AXPMultiLanguageString, AXPDefinitionCategory, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPProperty, AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
 export { AXPDefinitionCategory, normalizeDefinitionCategories } from '@acorex/platform/core';
 import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { Subject, BehaviorSubject } from 'rxjs';
@@ -46,9 +46,7 @@ type AXPWidgetCoreElementAction = {
     zone?: 'header' | 'footer';
     placement?: 'prefix' | 'suffix';
     scope?: 'primary' | 'secondary';
-    /** Keyboard shortcuts that trigger this action (e.g. `'Enter'`, `'ctrl+s'`). */
     shortcuts?: string[];
-    /** When `command` is not `widget:<name>.<action>`, widget name used to resolve `api` for `hidden` / `disabled` expressions. */
     predicateApiWidgetName?: string;
 };
 declare abstract class AXPWidgetCoreElement {
@@ -67,7 +65,6 @@ declare class AXPWidgetCoreService {
     readonly status: Signal<AXPPageStatus>;
     readonly isBusy: Signal<boolean>;
     registeredWidgetsCount: _angular_core.WritableSignal<number>;
-    /** Bumped when a widget reports dirty-state changes via `api().isDirty()`. */
     private readonly dirtyWidgetsRevision;
     readonly dirtyWidgetsRevisionSignal: Signal<number>;
     get variables(): any;
@@ -84,22 +81,9 @@ declare class AXPWidgetCoreService {
     setFunctions(key: string, value: any): void;
     registerWidget(id: string, widget: AXPWidgetCoreElement): void;
     getWidget(id: string): AXPWidgetCoreElement | undefined;
-    /**
-     * Waits until a widget with the given id is registered, then resolves with it.
-     * If the widget is already registered, resolves immediately.
-     * Optionally accepts a timeout (in ms) after which it resolves with undefined.
-     */
     waitForWidget(id: string, timeoutMs?: number): Promise<AXPWidgetCoreElement | undefined>;
-    /**
-     * Returns a list of registered widget ids (names).
-     */
     listRegisteredWidgetNames(): string[];
-    /** Notifies listeners that a widget's composite dirty state may have changed. */
     notifyWidgetDirtyChanged(): void;
-    /**
-     * Returns whether any registered widget reports dirty state via `api().isDirty()`.
-     */
-    hasDirtyWidgets(): boolean;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetCoreService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetCoreService>;
@@ -405,35 +389,36 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
     protected readonly contextService: {
         data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
-        initialSnapshot: _angular_core.Signal<{}>;
-        previousSnapshot: _angular_core.Signal<{}>;
-        userDirtyPaths: _angular_core.Signal<string[]>;
+        savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
+        isSavedCommitted: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        isUserDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
-        initial: _angular_core.Signal<{}>;
-        previous: _angular_core.Signal<{}>;
+        saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        initial: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previous: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
-        update: (path: string, value: any, options?: AXPContextUpdateOptions) => void;
-        applyObjectPaths: (obj: Record<string, unknown>, options?: AXPContextUpdateOptions, prefix?: string) => void;
-        patch: (context: Record<string, any>, second?: boolean | _acorex_platform_core.AXPContextPatchOptions) => void;
+        update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
+        applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
+        patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
+        revertToSaved: () => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
+        getSavedValue: (path: string) => any;
         hasValue: (path: string) => boolean;
-        commitBaseline: () => void;
-        clearUserDirtyPaths: () => void;
+        commitSaved: () => void;
+        applyParentBind: (merged: _acorex_platform_core.AXPContextData) => void;
     } & _ngrx_signals.StateSource<{
         data: _acorex_platform_core.AXPContextData;
         state: _acorex_platform_core.AXPContextState;
-        initialSnapshot: {};
-        previousSnapshot: {};
-        userDirtyPaths: string[];
+        savedSnapshot: _acorex_platform_core.AXPContextData;
+        previousSnapshot: _acorex_platform_core.AXPContextData;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     readonly config: _acorex_platform_layout_widget_core.AXPWidgetConfig<any>;
@@ -493,9 +478,7 @@ declare abstract class AXPValueWidgetComponent<T = any | null, TOptions extends
     getValue: _angular_core.Signal<T>;
     protected validationRules: _angular_core.Signal<AXPValidationRules>;
     protected extractValue(path: string): any;
-    setValue(value: T | null | undefined, options?: AXPContextUpdateOptions): void;
-    /** Persists a user-initiated value change into the shared context store. */
-    setUserValue(value: T | null | undefined): void;
+    setValue(value: T | null | undefined): void;
     protected detectFullPath(): void;
     protected handleValueChanged(e: AXValueChangedEvent<T>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPValueWidgetComponent<any, any>, never>;
@@ -794,50 +777,57 @@ declare class AXPWidgetContainerComponent {
     readonly contextService: {
         data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
-        initialSnapshot: _angular_core.Signal<{}>;
-        previousSnapshot: _angular_core.Signal<{}>;
-        userDirtyPaths: _angular_core.Signal<string[]>;
+        savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         lastChange: _ngrx_signals.DeepSignal<AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
+        isSavedCommitted: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        isUserDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
-        initial: _angular_core.Signal<{}>;
-        previous: _angular_core.Signal<{}>;
+        saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        initial: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previous: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         changeEvent: _angular_core.Signal<AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
-        patch: (context: Record<string, any>, second?: boolean | _acorex_platform_core.AXPContextPatchOptions) => void;
+        patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
+        revertToSaved: () => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
+        getSavedValue: (path: string) => any;
         hasValue: (path: string) => boolean;
-        commitBaseline: () => void;
-        clearUserDirtyPaths: () => void;
+        commitSaved: () => void;
+        applyParentBind: (merged: _acorex_platform_core.AXPContextData) => void;
     } & _ngrx_signals.StateSource<{
         data: _acorex_platform_core.AXPContextData;
         state: _acorex_platform_core.AXPContextState;
-        initialSnapshot: {};
-        previousSnapshot: {};
-        userDirtyPaths: string[];
+        savedSnapshot: _acorex_platform_core.AXPContextData;
+        previousSnapshot: _acorex_platform_core.AXPContextData;
         lastChange: AXPContextChangeEvent;
     }>;
     readonly builderService: AXPWidgetCoreService;
     readonly onContextChanged: EventEmitter<AXPContextChangeEvent>;
+    private lastEmittedFormDirty;
+    private savedBaselineTimer?;
     set context(value: any);
     set functions(v: any);
-    /** True when user-edited context paths or composite widgets report dirty state. */
+    readonly isSavedCommitted: _angular_core.Signal<boolean>;
     readonly isFormDirty: _angular_core.Signal<boolean>;
     constructor();
     status: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPPageStatus>;
     isBusy: _angular_core.Signal<boolean>;
     refresh(): void;
     find(name: string): Promise<_acorex_platform_layout_widget_core.AXPWidgetCoreElement | undefined>;
-    /** Replaces context and clears dirty tracking (discard, save reload, external reset). */
-    replaceContext(value: unknown): void;
+    private syncExternalContext;
+    /** Commits the current data as saved after widget hydration settles. */
+    settleSavedBaseline(): Promise<void>;
+    replaceContext(value: unknown): Promise<void>;
+    revertAndSettle(): void;
+    private clearSavedBaselineTimer;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetContainerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetContainerComponent, "axp-widgets-container", never, { "context": { "alias": "context"; "required": false; }; "functions": { "alias": "functions"; "required": false; }; }, { "onContextChanged": "onContextChanged"; }, never, ["*"], false, never>;
 }
@@ -910,6 +900,8 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
     headerSortDirection?: 'asc' | 'desc';
     /** 1-based order when multiple columns are sorted (shown when priority &gt; 1). */
     headerSortPriority?: number;
+    /** Pins column to table edge (`start` / `end`). Passed to the underlying data-table column. */
+    columnFixed?: 'start' | 'end';
     readonly sortToggle: EventEmitter<MouseEvent>;
     cellTemplate: TemplateRef<unknown>;
     private _contentCellTemplate;
@@ -969,7 +961,7 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
     getInputs(data: any): any;
     getRowInjector(data: any): Injector;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetColumnRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetColumnRendererComponent, "axp-widget-column-renderer", never, { "caption": { "alias": "caption"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "customWidth": { "alias": "customWidth"; "required": false; }; "node": { "alias": "node"; "required": true; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "sortEnabled": { "alias": "sortEnabled"; "required": false; }; "headerSortDirection": { "alias": "headerSortDirection"; "required": false; }; "headerSortPriority": { "alias": "headerSortPriority"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; }, { "sortToggle": "sortToggle"; }, never, never, false, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetColumnRendererComponent, "axp-widget-column-renderer", never, { "caption": { "alias": "caption"; "required": false; }; "customExpandIcon": { "alias": "customExpandIcon"; "required": false; }; "customCollapseIcon": { "alias": "customCollapseIcon"; "required": false; }; "customWidth": { "alias": "customWidth"; "required": false; }; "node": { "alias": "node"; "required": true; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "expandHandler": { "alias": "expandHandler"; "required": false; }; "sortEnabled": { "alias": "sortEnabled"; "required": false; }; "headerSortDirection": { "alias": "headerSortDirection"; "required": false; }; "headerSortPriority": { "alias": "headerSortPriority"; "required": false; }; "columnFixed": { "alias": "columnFixed"; "required": false; }; "cellTemplate": { "alias": "cellTemplate"; "required": false; }; "headerTemplate": { "alias": "headerTemplate"; "required": false; }; }, { "sortToggle": "sortToggle"; }, never, never, false, never>;
 }
 
 type AXPWidgetRendererDirectiveOptions = AXPMetaData;
@@ -1003,35 +995,36 @@ declare class AXPWidgetRendererDirective {
     protected contextService: {
         data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
-        initialSnapshot: _angular_core.Signal<{}>;
-        previousSnapshot: _angular_core.Signal<{}>;
-        userDirtyPaths: _angular_core.Signal<string[]>;
+        savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
+        isSavedCommitted: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        isUserDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
-        initial: _angular_core.Signal<{}>;
-        previous: _angular_core.Signal<{}>;
+        saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        initial: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        previous: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
-        patch: (context: Record<string, any>, second?: boolean | _acorex_platform_core.AXPContextPatchOptions) => void;
+        patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
+        revertToSaved: () => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
+        getSavedValue: (path: string) => any;
         hasValue: (path: string) => boolean;
-        commitBaseline: () => void;
-        clearUserDirtyPaths: () => void;
+        commitSaved: () => void;
+        applyParentBind: (merged: _acorex_platform_core.AXPContextData) => void;
     } & _ngrx_signals.StateSource<{
         data: _acorex_platform_core.AXPContextData;
         state: _acorex_platform_core.AXPContextState;
-        initialSnapshot: {};
-        previousSnapshot: {};
-        userDirtyPaths: string[];
+        savedSnapshot: _acorex_platform_core.AXPContextData;
+        previousSnapshot: _acorex_platform_core.AXPContextData;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     protected widgetRegistery: AXPWidgetRegistryService;
@@ -1046,6 +1039,7 @@ declare class AXPWidgetRendererDirective {
     private expressionEvaluators;
     private componentRef;
     private renderTimeoutId;
+    private renderGeneration;
     private hasInitialRender;
     private onContextChanged;
     private onLoadEvent;