@acorex/platform 21.0.0-next.2 → 21.0.0-next.3

package/layout/components/index.d.ts

@@ -1,19 +1,18 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnInit, OnDestroy, Type, ViewContainerRef, ModuleWithProviders, WritableSignal, QueryList, EventEmitter } from '@angular/core';
+import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnInit, OnDestroy, Type, ViewContainerRef, ModuleWithProviders, QueryList, OnChanges, EventEmitter, WritableSignal } from '@angular/core';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActivityLog, AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPContextData, AXPOptionsData, AXPGridLayoutOptions, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
+import { AXPActivityLog, AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPContextData, AXPOptionsData, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
 import { AXPMenuItem } from '@acorex/platform/common';
 import { AXValueChangedEvent, AXClickEvent, AXDataSource, AXDataSourceFilterOption, AXHtmlEvent, AXEvent } from '@acorex/cdk/common';
 import { AXTreeViewLegacyComponent, AXTreeItemClickBaseEventLegacy } from '@acorex/components/tree-view-legacy';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AXPWidgetNode, AXPWidgetCoreContextChangeEvent, AXPWidgetRendererDirective, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/widget-core';
+import { AXPWidgetNode, AXPWidgetRendererDirective, AXPWidgetCoreContextChangeEvent, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import { AXDataTableComponent, AXDataTableRowDbClick, AXDataTableRowClick } from '@acorex/components/data-table';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
-import { AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormDefinition } from '@acorex/platform/layout/builder';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
 import { AXCalendarService } from '@acorex/core/date-time';
 import { AXTabStripChangedEvent, AXTabsComponent } from '@acorex/components/tabs';
@@ -426,6 +425,7 @@ interface AXPComponentSlotConfig {
     priority?: number;
     component?: Type<any>;
     condition?: ((context?: AXPContextData) => (boolean | Promise<boolean>)) | string;
+    features?: string[];
     loadComponent?: () => Type<any> | Promise<Type<any>>;
     options?: AXPOptionsData | (() => AXPOptionsData) | (() => Promise<AXPOptionsData>);
 }
@@ -446,6 +446,7 @@ declare class AXPComponentSlotDirective implements OnInit {
     private registryService;
     private injector;
     private evaluator;
+    private sessionService;
     viewContainerRef: ViewContainerRef;
     contextStore: {
         data: _angular_core.Signal<AXPContextData>;
@@ -477,6 +478,7 @@ declare class AXPComponentSlotDirective implements OnInit {
     isEmpty: _angular_core.Signal<boolean>;
     private _viewCount;
     private componentRefs;
+    private placeholderRefs;
     constructor();
     ngOnInit(): Promise<void>;
     loadComponents(): Promise<void>;
@@ -528,6 +530,7 @@ interface AXPDataSelectorConfig {
     parentField?: string;
     allowCreate?: boolean;
     filters?: AXDataSourceFilterOption;
+    selectedItemIds?: string[] | number[];
     categoryFilter?: {
         enabled: boolean;
         title: string;
@@ -543,8 +546,11 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     protected searchPlaceholderText: _angular_core.WritableSignal<string>;
     protected filter: AXDataSourceFilterOption;
     protected grid: _angular_core.Signal<AXDataTableComponent | undefined>;
-    protected initialSelectedItems: any[];
     protected selectedItems: _angular_core.WritableSignal<any[]>;
+    private initialSelectionApplied;
+    private userHasInteracted;
+    private isApplyingInitialSelection;
+    private initialSelectedItems;
     protected activeCategoryFilter: _angular_core.WritableSignal<{
         node: AXPCategoryEntity;
         filterValue: any;
@@ -554,6 +560,7 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     private readonly translationService;
     constructor();
     protected allowSelect: _angular_core.Signal<boolean>;
+    protected selectedCount: _angular_core.Signal<number>;
     protected hasSearch: _angular_core.Signal<boolean | undefined>;
     protected categoryTreeConfig: _angular_core.Signal<{
         textField: string;
@@ -572,7 +579,7 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
         canCreateChild: boolean;
     }>;
     protected ngOnInit(): void;
-    protected ngAfterViewInit(): void;
+    protected ngAfterViewInit(): Promise<void>;
     protected handleRowDbClick(e: AXDataTableRowDbClick): void;
     protected handleRowClick(e: AXDataTableRowClick): void;
     protected handleSelectedRowsChange(rows: unknown[]): Promise<void>;
@@ -587,6 +594,11 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     private applyFilterAndSort;
     private applyCategoryFilter;
     private updateSearchPlaceholder;
+    /**
+     * Apply initial selection based on selectedItemIds from config
+     * Loads items by IDs using the data source's byKey method, then selects them in the grid
+     */
+    private applyInitialSelection;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDataSelectorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDataSelectorComponent, "axp-data-selector", never, {}, {}, never, never, true, never>;
 }
@@ -651,328 +663,12 @@ declare class AXPDragDropListComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDragDropListComponent, "axp-drag-drop-list", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "listId": { "alias": "listId"; "required": false; "isSignal": true; }; "dropListGroup": { "alias": "dropListGroup"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "disable": { "alias": "disable"; "required": false; "isSignal": true; }; }, { "items": "itemsChange"; "itemClick": "itemClick"; "dropListDropped": "dropListDropped"; }, never, never, true, never>;
 }
 
-interface AXPDynamicFormDesignerField {
-    id: string;
-    name: string;
-    title: string;
-    description?: string;
-    widget: AXPWidgetNode;
-    mode?: 'view' | 'edit';
-    layout?: AXPGridLayoutOptions;
-    validations?: Array<{
-        rule: string;
-        options?: Record<string, any>;
-    }>;
-}
-interface AXPDynamicFormDesignerGroup {
-    id: string;
-    name: string;
-    title?: string;
-    description?: string;
-    fields: AXPDynamicFormDesignerField[];
-    mode?: 'view' | 'edit';
-    layout?: AXPGridLayoutOptions;
-    look?: 'fieldset' | 'card' | 'group' | 'container';
-}
-interface AXPDynamicFormDesignerState {
-    groups: AXPDynamicFormDesignerGroup[];
-    selectedFieldId?: string;
-    selectedGroupId?: string;
-    mode: 'designer' | 'preview';
-}
-/**
- * Convert designer field to form field definition
- */
-declare function convertDesignerFieldToFormField(field: AXPDynamicFormDesignerField): AXPDynamicFormFieldDefinition;
-/**
- * Convert designer group to form group definition
- */
-declare function convertDesignerGroupToFormGroup(group: AXPDynamicFormDesignerGroup): AXPDynamicFormGroupDefinition;
-/**
- * Convert designer state to form definition
- */
-declare function convertDesignerStateToFormDefinition(state: AXPDynamicFormDesignerState): AXPDynamicFormDefinition;
-interface AXPFormElementWidget {
-    name: string;
-    title: string;
-    icon?: string;
-    description?: string;
-    type: string;
-    properties?: any[];
-}
-
-declare class AXPDynamicFormDesignerComponent {
-    formDefinition: _angular_core.ModelSignal<AXPDynamicFormDefinition>;
-    readonly: _angular_core.InputSignal<boolean>;
-    private isInternalUpdate;
-    private readonly widgetRegistry;
-    private readonly formBuilderService;
-    private readonly widgetPropertyViewerService;
-    private readonly translationService;
-    private readonly DEFAULT_GROUP_NAME;
-    protected selectedFieldId: _angular_core.WritableSignal<string | null>;
-    private designerState;
-    protected availableWidgets: _angular_core.Signal<AXPFormElementWidget[]>;
-    protected widgetOptions: _angular_core.Signal<{
-        value: string;
-        text: string;
-    }[]>;
-    protected getAllFields: _angular_core.Signal<AXPDynamicFormDesignerField[]>;
-    protected isDefaultGroup: (groupName: string) => boolean;
-    protected canDeleteGroup: _angular_core.Signal<boolean>;
-    protected isPreviewDisabled: _angular_core.Signal<boolean>;
-    protected designerGroups: _angular_core.Signal<AXPDynamicFormDesignerGroup[]>;
-    /**
-     * Create the default group for ungrouped fields
-     */
-    private createDefaultGroup;
-    /**
-     * Ensure form definition has at least the default group
-     */
-    private ensureDefaultGroup;
-    /**
-     * Effect to log form definition changes
-     */
-    private logFormDefinitionChanges;
-    /**
-     * Effect to sync form definition model to designer state
-     */
-    private syncModelToDesigner;
-    /**
-     * Effect to sync designer state changes back to model
-     */
-    private syncDesignerToModel;
-    /**
-     * Get the current form definition (converted from designer state)
-     */
-    getFormDefinition(): AXPDynamicFormDefinition;
-    /**
-     * Set the form definition (converted to designer state)
-     */
-    setFormDefinition(definition: AXPDynamicFormDefinition): void;
-    /**
-     * Add a new field to the form
-     * @param field The field to add
-     * @param groupName Optional group name to add the field to. Defaults to the default group or first group.
-     */
-    addField(field: AXPDynamicFormDesignerField, groupName?: string): void;
-    /**
-     * Update an existing field
-     * @param fieldId The ID of the field to update
-     * @param updates The updates to apply
-     */
-    updateField(fieldId: string, updates: Partial<AXPDynamicFormDesignerField>): void;
-    /**
-     * Remove a field from the form
-     * @param fieldId The ID of the field to remove
-     */
-    removeField(fieldId: string): void;
-    /**
-     * Get all available widget types
-     */
-    getAvailableWidgets(): AXPFormElementWidget[];
-    /**
-     * Add a new group to the form
-     * @param group The group to add
-     */
-    addGroup(group: AXPDynamicFormDesignerGroup): void;
-    /**
-     * Remove a group from the form
-     * @param groupName The name of the group to remove
-     */
-    removeGroup(groupName: string): void;
-    /**
-     * Reorder groups in the form
-     * @param fromIndex Source index
-     * @param toIndex Target index
-     */
-    reorderGroups(fromIndex: number, toIndex: number): void;
-    /**
-     * Update an existing group
-     * @param groupName The name of the group to update
-     * @param updates The updates to apply
-     */
-    updateGroup(groupName: string, updates: Partial<AXPDynamicFormDesignerGroup>): void;
-    /**
-     * Move a field to a different group
-     * @param fieldName The name/path of the field to move
-     * @param targetGroupName The name of the target group
-     */
-    moveFieldToGroup(fieldName: string, targetGroupName: string): void;
-    protected handleAddGroupClick(): Promise<void>;
-    protected handleAddFieldToGroup(group: AXPDynamicFormDesignerGroup): Promise<void>;
-    protected handleFieldEdit(field: AXPDynamicFormDesignerField): Promise<void>;
-    protected handleFieldRemove(field: AXPDynamicFormDesignerField): void;
-    protected handleGroupEdit(group: AXPDynamicFormDesignerGroup): Promise<void>;
-    protected handleGroupLayoutEdit(group: AXPDynamicFormDesignerGroup): Promise<void>;
-    protected handleGroupRemove(group: AXPDynamicFormDesignerGroup): void;
-    /**
-     * Handle field layout editing
-     */
-    protected handleFieldLayoutEdit(field: AXPDynamicFormDesignerField, group: AXPDynamicFormDesignerGroup): Promise<void>;
-    protected handleGroupDrop(event: CdkDragDrop<AXPDynamicFormDesignerGroup[]>): void;
-    protected handleFieldDrop(event: CdkDragDrop<AXPDynamicFormDesignerField[]>, targetGroupName?: string): void;
-    protected handlePreviewClick(): Promise<void>;
-    protected deriveKey(input: string): string;
-    protected generateId(): string;
-    protected getWidgetIcon(widgetName: string): string;
-    protected getWidgetTitle(widgetName: string): string;
-    protected getWidgetNode(field: AXPDynamicFormDesignerField): AXPWidgetNode;
-    protected deriveGroupKey(input: string): string;
-    protected getGroupOptions(): Array<{
-        value: string;
-        text: string;
-    }>;
-    protected addFieldToGroup(field: AXPDynamicFormDesignerField, groupName: string): void;
-    protected getAllGroupDropLists(): string[];
-    /**
-     * Get the grid column count for a group (always 12 columns)
-     */
-    protected getGroupColumnCount(): number;
-    /**
-     * Get default field grid layout based on group configuration
-     */
-    protected getFieldGridLayout(group: AXPDynamicFormDesignerGroup, fieldIndex?: number): AXPGridLayoutOptions;
-    private configurePreviewFieldset;
-    private configurePreviewFormField;
-    private configureFormFieldWidget;
-    private extractPreviewWidgetOptions;
-    private applyDesignerFieldUpdates;
-    private applyDesignerGroupUpdates;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicFormDesignerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicFormDesignerComponent, "axp-dynamic-form-designer", never, { "formDefinition": { "alias": "formDefinition"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "formDefinition": "formDefinitionChange"; }, never, never, true, never>;
-}
-
-/**
- * Describes a schema-only definition for an extra property (no value).
- */
-interface AXPExtraPropertySchemaItem {
-    /** Unique key for the property (used as identifier) */
-    key: string;
-    /** Human-readable title/label */
-    title: string;
-    /** Widget name/id to render (e.g., 'text-editor', 'checkbox-editor') */
-    type: string;
-    /** Optional widget-specific options */
-    options?: AXPOptionsData;
-}
-/**
- * Describes a single extra property row.
- */
-interface AXPExtraPropertyItem extends AXPExtraPropertySchemaItem {
-    /** Current value bound to the rendered widget */
-    value: unknown;
-}
-/**
- * Describes an available extra property type that user can select when adding rows.
- */
-interface AXPExtraPropertyType {
-    /** Unique id for the type (it should be the same as the widget name) */
-    id: string;
-    /** UI title for selection dropdown */
-    title: string;
-    /** Default widget options applied on create */
-    defaultOptions?: AXPOptionsData;
-}
-/**
- * Injection token to provide available extra property types.
- */
-declare const AXP_EXTRA_PROPERTY_TYPES: InjectionToken<AXPExtraPropertyType[]>;
-
-declare class AXPExtraPropertiesComponent {
-    items: _angular_core.InputSignal<AXPExtraPropertyItem[]>;
-    mode: _angular_core.InputSignal<"view" | "edit">;
-    protected onContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
-    itemsChange: _angular_core.OutputEmitterRef<AXPExtraPropertyItem[]>;
-    private readonly providedTypes;
-    private readonly translationService;
-    protected newKey: WritableSignal<string>;
-    protected newTitle: WritableSignal<string>;
-    protected newTypeId: WritableSignal<string>;
-    protected newValue: WritableSignal<any>;
-    /** Local, ephemeral context for widget rendering */
-    protected internalContext: WritableSignal<Record<string, any>>;
-    private lastTypeByKey;
-    protected draftVersion: WritableSignal<number>;
-    protected draftKey: _angular_core.Signal<string>;
-    protected typeOptions: _angular_core.Signal<AXPExtraPropertyType[]>;
-    protected presetTypes: _angular_core.Signal<AXPExtraPropertyType[]>;
-    protected canAdd: _angular_core.Signal<boolean>;
-    /** Sync incoming items' values into internal context for rendering */
-    private readonly syncContextFromItems;
-    /**
-     * Clear item values when their widget type changes to avoid incompatible stale values
-     */
-    private readonly clearValueOnTypeChange;
-    protected handleAddItem(): void;
-    protected handleRemoveItem(key: string): void;
-    protected handleDrop(event: CdkDragDrop<AXPExtraPropertyItem[]>): void;
-    protected selectPreset(id: string): void;
-    private nodeCache;
-    private draftNodeCache?;
-    protected getNode(item: AXPExtraPropertyItem): AXPWidgetNode;
-    protected draftNode(): AXPWidgetNode;
-    protected newTypeChanged(val: string): void;
-    protected ngOnInit(): void;
-    protected handleTitleChange(val: string): void;
-    protected sanitizeKey(input: string): string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPExtraPropertiesComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPExtraPropertiesComponent, "axp-extra-properties", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "itemsChange": "itemsChange"; }, never, never, true, never>;
-}
-
-declare class AXPExtraPropertiesSchemaComponent {
-    schema: _angular_core.InputSignal<AXPExtraPropertySchemaItem[]>;
-    mode: _angular_core.InputSignal<"view" | "edit">;
-    schemaChange: _angular_core.OutputEmitterRef<AXPExtraPropertySchemaItem[]>;
-    private readonly providedTypes;
-    private readonly translationService;
-    protected newTitle: WritableSignal<string>;
-    protected newTypeId: WritableSignal<string>;
-    protected typeOptions: _angular_core.Signal<AXPExtraPropertyType[]>;
-    protected canAdd: _angular_core.Signal<boolean>;
-    protected selectedKey: WritableSignal<string | null>;
-    protected selectedItem: _angular_core.Signal<AXPExtraPropertySchemaItem | null>;
-    constructor();
-    protected handleAdd(): void;
-    protected handleRemove(key: string): void;
-    protected handleDrop(event: CdkDragDrop<AXPExtraPropertySchemaItem[]>): void;
-    protected handleUpdateTitle(key: string, title: string): void;
-    protected handleUpdateType(key: string, typeId: string): void;
-    protected newTypeChanged(val: string): void;
-    protected handleTitleChange(val: string): void;
-    protected handleSelect(key: string): void;
-    protected handleViewerChanged(e: {
-        values: any;
-        mode: 'init' | 'update';
-    }): void;
-    protected deriveKey(input: string): string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPExtraPropertiesSchemaComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPExtraPropertiesSchemaComponent, "axp-extra-properties-schema", never, { "schema": { "alias": "schema"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "schemaChange": "schemaChange"; }, never, never, true, never>;
-}
-
-declare class AXPExtraPropertiesValuesComponent {
-    schema: _angular_core.InputSignal<AXPExtraPropertySchemaItem[]>;
-    values: _angular_core.InputSignal<Record<string, any>>;
-    mode: _angular_core.InputSignal<"view" | "edit">;
-    valuesChange: _angular_core.OutputEmitterRef<Record<string, any>>;
-    isRequired: (item: AXPExtraPropertySchemaItem) => any;
-    protected internalContext: _angular_core.WritableSignal<Record<string, any>>;
-    private nodeCache;
-    private lastTypeByKey;
-    protected onContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
-    private readonly syncContextFromInputs;
-    private readonly clearOnSchemaTypeChange;
-    protected getNode(item: AXPExtraPropertySchemaItem): AXPWidgetNode;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPExtraPropertiesValuesComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPExtraPropertiesValuesComponent, "axp-extra-properties-values", never, { "schema": { "alias": "schema"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "valuesChange": "valuesChange"; }, never, never, true, never>;
-}
-
 declare class AXPQueryFiltersComponent {
     #private;
     protected translate: AXTranslationService;
     protected calendarService: AXCalendarService;
     private filterOperatorMiddleware;
-    private settingService;
+    private settingsService;
     filtersDefinitions: _angular_core.InputSignal<AXPFilterDefinition[]>;
     initialFilters: _angular_core.InputSignal<AXPFilterQuery[]>;
     onFiltersChanged: _angular_core.OutputEmitterRef<AXPFilterQuery[]>;
@@ -1053,6 +749,353 @@ declare class AXPImageEditorService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPImageEditorService>;
 }
 
+/**
+ * Represents a spreadsheet item (row or column header) with id, text, and optional description
+ */
+interface AXPSpreadsheetItem {
+    id: string;
+    title: string;
+    description?: string;
+    /**
+     * Optional CSS class for cell styling (e.g., 'ax-bg-success-lightest ax-text-success' for green)
+     * Used when this item is used as a cell value to color-code the cell
+     * Allows proper control of both background and text colors
+     */
+    cssClass?: string;
+}
+/**
+ * Represents the value structure for spreadsheet cells
+ * Stores only the ID reference to the item in cellOptions
+ */
+type AXPSpreadsheetCellValue = string | null;
+/**
+ * Matrix data structure: { [rowId]: { [columnId]: cellValueId } }
+ * cellValueId is the ID of an item from cellOptions
+ */
+type AXPSpreadsheetData = Record<string, Record<string, AXPSpreadsheetCellValue>>;
+/**
+ * Represents a column definition in the spreadsheet
+ */
+interface AXPSpreadsheetColumn {
+    /**
+     * Column identifier (unique name)
+     */
+    name: string;
+    /**
+     * Display title for column header
+     */
+    title: string;
+    /**
+     * Optional description for column header
+     */
+    description?: string;
+    /**
+     * Path to access row property (e.g., 'user.name', 'age')
+     * Used to get/set values in row objects
+     */
+    path: string;
+    /**
+     * Widget configuration for this column
+     * All cells in this column will use this widget
+     */
+    widget: AXPWidgetNode;
+    /**
+     * Optional column width
+     */
+    width?: string;
+    /**
+     * Column-level readonly override
+     */
+    readonly?: boolean;
+}
+/**
+ * Spreadsheet row mode
+ * - 'fixed': Rows are provided as input, cannot add/remove (like matrix)
+ * - 'dynamic': Users can add/remove rows dynamically (like Excel)
+ */
+type AXPSpreadsheetRowMode = 'fixed' | 'dynamic';
+/**
+ * Event emitted when a single cell value changes
+ */
+interface AXPSpreadsheetCellChangeEvent {
+    /**
+     * Row identifier (name for fixed mode, generated ID for dynamic mode)
+     */
+    rowId: string;
+    /**
+     * Column name
+     */
+    columnName: string;
+    /**
+     * New cell value (whatever the widget returns)
+     */
+    value: any;
+    /**
+     * Full row object after update
+     */
+    row: Record<string, any>;
+}
+/**
+ * Event emitted when a row is added or removed (dynamic mode only)
+ */
+interface AXPSpreadsheetRowChangeEvent {
+    /**
+     * Type of change: 'add' or 'remove'
+     */
+    type: 'add' | 'remove';
+    /**
+     * Row identifier
+     */
+    rowId: string;
+    /**
+     * Full row object (for 'add' events)
+     */
+    row?: Record<string, any>;
+    /**
+     * All rows after the change
+     */
+    rows: Record<string, any>[];
+}
+/**
+ * Configuration for the spreadsheet component
+ */
+interface AXPSpreadsheetConfig {
+    /**
+     * Widget configuration for cell editing (SelectBox)
+     */
+    cellWidget?: AXPWidgetNode;
+    /**
+     * Whether the spreadsheet is in readonly mode
+     */
+    readonly?: boolean;
+    /**
+     * Placeholder text for empty cells
+     */
+    emptyCellPlaceholder?: string;
+}
+
+declare class AXPSpreadsheetComponent {
+    protected readonly translationService: AXTranslationService;
+    /**
+     * Translated column titles
+     */
+    protected translatedColumnTitles: _angular_core.WritableSignal<Map<string, string>>;
+    /**
+     * Title for the spreadsheet (displayed in corner cell)
+     */
+    title: _angular_core.InputSignal<string>;
+    /**
+     * Column definitions
+     */
+    columns: _angular_core.InputSignal<AXPSpreadsheetColumn[]>;
+    /**
+     * Row mode: 'fixed' or 'dynamic'
+     */
+    rowMode: _angular_core.InputSignal<AXPSpreadsheetRowMode>;
+    /**
+     * Rows data (for fixed mode - input only)
+     * Each row must have a 'name' property for identification
+     */
+    rowsInput: _angular_core.InputSignal<Record<string, any>[]>;
+    /**
+     * Rows data (for dynamic mode - two-way binding)
+     */
+    rowsModel: _angular_core.ModelSignal<Record<string, any>[]>;
+    /**
+     * Whether the spreadsheet is in readonly mode
+     */
+    readonly: _angular_core.InputSignal<boolean>;
+    /**
+     * Placeholder text for empty cells (default: "–")
+     */
+    emptyCellPlaceholder: _angular_core.InputSignal<string>;
+    /**
+     * Path to property in row object to display as row header title
+     * Example: 'name', 'title', 'user.name'
+     */
+    rowTitlePath: _angular_core.InputSignal<string | null>;
+    /**
+     * Path to property in row object to display as row header description
+     * Example: 'description', 'details', 'user.description'
+     */
+    rowDescriptionPath: _angular_core.InputSignal<string | null>;
+    /**
+     * Whether to allow adding rows (dynamic mode only, default: true)
+     */
+    allowAddRows: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether to allow removing rows (default: true for dynamic mode, false for fixed mode)
+     * Can be enabled for fixed mode if needed
+     */
+    allowRemoveRows: _angular_core.InputSignal<boolean>;
+    /**
+     * Emitted when a single cell value changes
+     */
+    cellChange: _angular_core.OutputEmitterRef<AXPSpreadsheetCellChangeEvent>;
+    /**
+     * Emitted when rows are added or removed (dynamic mode only)
+     */
+    rowChange: _angular_core.OutputEmitterRef<AXPSpreadsheetRowChangeEvent>;
+    /**
+     * Emitted when the entire spreadsheet data changes
+     */
+    spreadsheetChange: _angular_core.OutputEmitterRef<Record<string, any>[]>;
+    /**
+     * Currently editing cell: { rowId, columnName } | null
+     */
+    protected editingCell: _angular_core.WritableSignal<{
+        rowId: string;
+        columnName: string;
+    } | null>;
+    /**
+     * Original value when entering edit mode (for cancel functionality)
+     */
+    private originalCellValue;
+    /**
+     * Internal rows state (for fixed mode)
+     */
+    private internalRows;
+    /**
+     * Row ID mapping: rowId -> row index (for tracking)
+     */
+    private rowIdMap;
+    /**
+     * Cache for widget nodes to prevent re-rendering
+     * Key: `${rowIndex}_${columnName}`, Value: AXPWidgetNode
+     */
+    private widgetNodeCache;
+    /**
+     * Cache for cell values to detect actual changes
+     * Key: `${rowIndex}_${columnName}`, Value: any
+     */
+    private cellValueCache;
+    /**
+     * Get current rows based on mode
+     */
+    protected currentRows: _angular_core.Signal<Record<string, any>[]>;
+    /**
+     * Context for widgets-container (all rows as an object with rows array)
+     * This allows widgets to access their cell via path like: rows[index].column.path
+     */
+    protected spreadsheetContext: _angular_core.Signal<{
+        rows: Record<string, any>[];
+    }>;
+    /**
+     * Get rows with IDs (ensure all rows have identifiers)
+     */
+    protected rowsWithIds: _angular_core.Signal<{
+        rowId: string;
+        row: Record<string, any>;
+    }[]>;
+    /**
+     * Check if spreadsheet is empty
+     */
+    protected isEmpty: _angular_core.Signal<boolean>;
+    /**
+     * Check if only columns are empty
+     */
+    protected isColumnsEmpty: _angular_core.Signal<boolean>;
+    /**
+     * Check if only rows are empty
+     */
+    protected isRowsEmpty: _angular_core.Signal<boolean>;
+    constructor();
+    /**
+     * Get the value for a specific cell by row index
+     */
+    protected getCellValue(rowIndex: number, columnName: string): any;
+    /**
+     * Get row title from row object using rowTitlePath
+     */
+    protected getRowTitle(row: Record<string, any>, path: string): string;
+    /**
+     * Get row description from row object using rowDescriptionPath
+     */
+    protected getRowDescription(row: Record<string, any>, path: string): string;
+    /**
+     * Get row by ID
+     */
+    protected getRowById(rowId: string): Record<string, any> | null;
+    /**
+     * Check if a cell is currently being edited
+     */
+    protected isCellEditing(rowId: string, columnName: string): boolean;
+    /**
+     * Check if a column is readonly
+     */
+    protected isColumnReadonly(column: AXPSpreadsheetColumn): boolean;
+    /**
+     * Get widget node for a cell with dynamic path based on row index
+     * Path format: rows[rowIndex].column.path
+     * Uses caching to prevent unnecessary re-renders
+     */
+    protected getCellWidgetNode(column: AXPSpreadsheetColumn, rowIndex: number): AXPWidgetNode;
+    /**
+     * Handle cell click to start editing
+     */
+    protected handleCellClick(rowId: string, columnName: string, event?: MouseEvent): void;
+    /**
+     * Handle cell value change from widget
+     * The widget sets the value at path like rows[index].column.path
+     */
+    protected handleCellValueChange(rowIndex: number, columnName: string, event: AXPWidgetCoreContextChangeEvent): void;
+    /**
+     * Handle spreadsheet context change from widgets-container
+     * This is called when any widget in the spreadsheet changes
+     */
+    protected handleSpreadsheetContextChange(event: AXPWidgetCoreContextChangeEvent): void;
+    /**
+     * Handle blur event to stop editing (when user clicks away from cell)
+     */
+    protected handleCellBlur(rowId: string, columnName: string): void;
+    /**
+     * Handle Escape key to cancel editing
+     */
+    protected handleKeyDown(event: KeyboardEvent): void;
+    /**
+     * Commit cell edit (save changes and close editing mode)
+     */
+    protected commitCellEdit(): void;
+    /**
+     * Cancel cell edit (discard changes and close editing mode - same as escape)
+     */
+    protected cancelCellEdit(): void;
+    /**
+     * Handle click outside to stop editing
+     */
+    protected handleClickOutside(event: MouseEvent): void;
+    /**
+     * Handle add row (dynamic mode only)
+     */
+    protected handleAddRow(): void;
+    /**
+     * Handle remove row (works for both fixed and dynamic modes)
+     */
+    protected handleRemoveRow(rowId: string, _event: AXClickEvent): void;
+    /**
+     * Generate unique row ID for dynamic mode
+     */
+    private generateRowId;
+    /**
+     * Update rows array (sync internal state)
+     */
+    private updateRows;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPSpreadsheetComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPSpreadsheetComponent, "axp-spreadsheet", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rowMode": { "alias": "rowMode"; "required": false; "isSignal": true; }; "rowsInput": { "alias": "rowsInput"; "required": false; "isSignal": true; }; "rowsModel": { "alias": "rowsModel"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "emptyCellPlaceholder": { "alias": "emptyCellPlaceholder"; "required": false; "isSignal": true; }; "rowTitlePath": { "alias": "rowTitlePath"; "required": false; "isSignal": true; }; "rowDescriptionPath": { "alias": "rowDescriptionPath"; "required": false; "isSignal": true; }; "allowAddRows": { "alias": "allowAddRows"; "required": false; "isSignal": true; }; "allowRemoveRows": { "alias": "allowRemoveRows"; "required": false; "isSignal": true; }; }, { "rowsModel": "rowsModelChange"; "cellChange": "cellChange"; "rowChange": "rowChange"; "spreadsheetChange": "spreadsheetChange"; }, never, never, true, never>;
+}
+
+declare class AXPLogoComponent implements OnInit, OnChanges {
+    source: any;
+    protected logoType: string;
+    private platform;
+    ngOnInit(): void;
+    ngOnChanges(): void;
+    protected setLogoType(): void;
+    protected setLogoTheme(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLogoComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLogoComponent, "axp-logo", never, { "source": { "alias": "source"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 interface AXPPropertyViewerGroup {
     name: string;
     title: string;
@@ -1172,6 +1215,32 @@ declare class AXPStateMessageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPStateMessageComponent, "axp-state-message", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[slot=actions]"], true, never>;
 }
 
+declare class AXPStopwatchComponent implements OnDestroy {
+    mode: _angular_core.InputSignal<"count-up" | "count-down">;
+    timeLimit: _angular_core.InputSignal<number | undefined>;
+    format: _angular_core.InputSignal<"hh:mm:ss" | "mm:ss" | "ss">;
+    autoStart: _angular_core.InputSignal<boolean>;
+    showControls: _angular_core.InputSignal<boolean>;
+    value: _angular_core.InputSignal<number>;
+    valueChange: _angular_core.OutputEmitterRef<number>;
+    timeUp: _angular_core.OutputEmitterRef<void>;
+    private readonly currentTime;
+    protected readonly isRunning: _angular_core.WritableSignal<boolean>;
+    private intervalId;
+    protected readonly isTimeUp: _angular_core.Signal<boolean>;
+    protected readonly displayTime: _angular_core.Signal<string>;
+    constructor();
+    ngOnDestroy(): void;
+    start(): void;
+    pause(): void;
+    reset(): void;
+    private stop;
+    private onTimeUp;
+    private formatTime;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPStopwatchComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPStopwatchComponent, "axp-stopwatch", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "timeLimit": { "alias": "timeLimit"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "autoStart": { "alias": "autoStart"; "required": false; "isSignal": true; }; "showControls": { "alias": "showControls"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "timeUp": "timeUp"; }, never, never, true, never>;
+}
+
 interface AXPTemplateViewerConfig {
     template: AXPWidgetNode | string;
     title?: string;
@@ -1294,6 +1363,7 @@ declare class AXPUserAvatarComponent implements OnInit, OnDestroy {
     avatarColor: _angular_core.Signal<string>;
     protected hasAvatar: _angular_core.Signal<boolean>;
     protected isAvatarLoaded: _angular_core.WritableSignal<boolean>;
+    protected isLoading: _angular_core.Signal<boolean>;
     protected onImageError(event: AXHtmlEvent<ErrorEvent>): void;
     protected onImageLoad(event: AXHtmlEvent<Event>): void;
     ngOnInit(): void;
@@ -1343,9 +1413,13 @@ declare class AXPWidgetFieldConfiguratorComponent {
      */
     label: _angular_core.InputSignal<string>;
     /**
-     * Field name (used in property viewer title)
+     * Field name (technical identifier, used for form field path)
      */
     fieldName: _angular_core.InputSignal<string>;
+    /**
+     * Field title (display name, used in UI labels and titles)
+     */
+    fieldTitle: _angular_core.InputSignal<string>;
     /**
      * Readonly mode
      */
@@ -1410,7 +1484,7 @@ declare class AXPWidgetFieldConfiguratorComponent {
      */
     protected openPreview(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetFieldConfiguratorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetFieldConfiguratorComponent, "axp-widget-field-configurator", never, { "widget": { "alias": "widget"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "fieldName": { "alias": "fieldName"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "widget": "widgetChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetFieldConfiguratorComponent, "axp-widget-field-configurator", never, { "widget": { "alias": "widget"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "fieldName": { "alias": "fieldName"; "required": false; "isSignal": true; }; "fieldTitle": { "alias": "fieldTitle"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "widget": "widgetChange"; }, never, never, true, never>;
 }
 
 /**
@@ -1544,6 +1618,10 @@ interface AXPWidgetPropertyViewerConfig {
     title: string;
     widget: AXPWidgetNode;
     mode?: 'simple' | 'advanced';
+    /**
+     * Property names to exclude from the viewer.
+     */
+    exclude?: string[];
     /**
      * Custom property injection configuration.
      */
@@ -1587,5 +1665,5 @@ declare class AXPWidgetPropertyViewerService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPropertyViewerService>;
 }
 
-export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPDynamicFormDesignerComponent, AXPExtraPropertiesComponent, AXPExtraPropertiesSchemaComponent, AXPExtraPropertiesValuesComponent, AXPImageEditorPopupComponent, AXPImageEditorService, AXPMenuBadgeHelper, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPStateMessageComponent, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_EXTRA_PROPERTY_TYPES, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, convertDesignerFieldToFormField, convertDesignerGroupToFormGroup, convertDesignerStateToFormDefinition };
-export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPDynamicFormDesignerField, AXPDynamicFormDesignerGroup, AXPDynamicFormDesignerState, AXPExtraPropertyItem, AXPExtraPropertySchemaItem, AXPExtraPropertyType, AXPFormElementWidget, AXPImageEditorOpenOptions, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyTab, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, StateMode };
+export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPImageEditorPopupComponent, AXPImageEditorService, AXPLogoComponent, AXPMenuBadgeHelper, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPSpreadsheetComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER };
+export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPImageEditorOpenOptions, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyTab, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, StateMode };