@acorex-platform/framework-client 0.0.37 → 0.0.46

package/types/acorex-platform-framework-client-layout-views.d.ts

@@ -77,6 +77,7 @@ declare class AXPPageLayoutComponent {
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
+        menuToggleCyclesStyle: _angular_core.Signal<boolean>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
         menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
         headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
@@ -90,6 +91,7 @@ declare class AXPPageLayoutComponent {
         overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        menuToggleCyclesStyleEnabled: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         menuDarkEnabled: _angular_core.Signal<boolean>;
@@ -104,6 +106,7 @@ declare class AXPPageLayoutComponent {
         setSideMenuWidth: (width: number) => void;
         setSideMenuCompactWidth: (width: number) => void;
         setSideMenuDrawerWidth: (width: number) => void;
+        setMenuVerticalMode: (mode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode) => void;
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
@@ -126,6 +129,7 @@ declare class AXPPageLayoutComponent {
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
+        menuToggleCyclesStyle: boolean;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
         menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
         headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
@@ -175,6 +179,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
+        menuToggleCyclesStyle: _angular_core.Signal<boolean>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
         menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
         headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
@@ -188,6 +193,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        menuToggleCyclesStyleEnabled: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         menuDarkEnabled: _angular_core.Signal<boolean>;
@@ -202,6 +208,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         setSideMenuWidth: (width: number) => void;
         setSideMenuCompactWidth: (width: number) => void;
         setSideMenuDrawerWidth: (width: number) => void;
+        setMenuVerticalMode: (mode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode) => void;
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
@@ -224,6 +231,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
+        menuToggleCyclesStyle: boolean;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
         menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
         headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
@@ -371,6 +379,7 @@ declare class AXPPopupLayoutComponent {
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
+        menuToggleCyclesStyle: _angular_core.Signal<boolean>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
         menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
         headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
@@ -384,6 +393,7 @@ declare class AXPPopupLayoutComponent {
         overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        menuToggleCyclesStyleEnabled: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         menuDarkEnabled: _angular_core.Signal<boolean>;
@@ -398,6 +408,7 @@ declare class AXPPopupLayoutComponent {
         setSideMenuWidth: (width: number) => void;
         setSideMenuCompactWidth: (width: number) => void;
         setSideMenuDrawerWidth: (width: number) => void;
+        setMenuVerticalMode: (mode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode) => void;
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
@@ -420,6 +431,7 @@ declare class AXPPopupLayoutComponent {
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
+        menuToggleCyclesStyle: boolean;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
         menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
         headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
@@ -453,6 +465,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
+        menuToggleCyclesStyle: _angular_core.Signal<boolean>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
         menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
         headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
@@ -466,6 +479,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        menuToggleCyclesStyleEnabled: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         menuDarkEnabled: _angular_core.Signal<boolean>;
@@ -480,6 +494,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         setSideMenuWidth: (width: number) => void;
         setSideMenuCompactWidth: (width: number) => void;
         setSideMenuDrawerWidth: (width: number) => void;
+        setMenuVerticalMode: (mode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode) => void;
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
@@ -502,6 +517,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
+        menuToggleCyclesStyle: boolean;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
         menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
         headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
-import { Signal, OnInit, ComponentRef, EventEmitter, InjectionToken, OnChanges, TemplateRef, Injector, WritableSignal, SimpleChanges, Type } from '@angular/core';
+import { Signal, OnInit, ComponentRef, InjectionToken, EventEmitter, OnChanges, AfterContentInit, TemplateRef, Injector, SimpleChanges, WritableSignal, Type } from '@angular/core';
 import * as _acorex_platform_framework_shared_widget_core from '@acorex-platform/framework-shared/widget-core';
-import { AXPWidgetStatus, AXPPageStatus, AXPWidgetNodeToken, AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetPropertyGroup, AXPWidgetProperty, AXPWidgetConfig, AXPExtendedWidget, AXPWidgetColumnNode } from '@acorex-platform/framework-shared/widget-core';
+import { AXPWidgetStatus, AXPPageStatus, AXPWidgetNodeToken, AXPWidgetNode, AXPWidgetRenderMode, AXPLayoutProfileContext, AXPLayoutProfileValues, AXPWidgetPropertyGroup, AXPWidgetProperty, AXPLayoutSize, AXPWidgetConfig, AXPExtendedWidget, AXPWidgetColumnNode } from '@acorex-platform/framework-shared/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _acorex_platform_framework_shared_core from '@acorex-platform/framework-shared/core';
 import { AXPOptionsData, AXPValidationRules, AXPProperty, AXPContextChangeEvent, AXPMetaData, AXPWidgetNode as AXPWidgetNode$1 } from '@acorex-platform/framework-shared/core';
@@ -10,9 +10,9 @@ import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { AXPQueryService } from '@acorex-platform/framework-client/runtime';
 import * as rxjs from 'rxjs';
 import { Subject, BehaviorSubject } from 'rxjs';
+import { AXPDeviceService, AXPExpressionEvaluatorService } from '@acorex-platform/framework-client/core';
 import * as _acorex_platform_framework_client_layout_widget_core from '@acorex-platform/framework-client/layout/widget-core';
 import { AXDataTableColumnComponent } from '@acorex/components/data-table';
-import { AXPExpressionEvaluatorService } from '@acorex-platform/framework-client/core';
 import * as i7 from '@acorex/core/translation';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXUnsubscriber } from '@acorex/core/utils';
@@ -236,6 +236,7 @@ declare abstract class AXPValueWidgetComponent<T = any | null, TOptions extends
 }
 declare abstract class AXPDataListWidgetComponent extends AXPValueWidgetComponent<any> {
     protected readonly queryService: AXPQueryService;
+    private readonly localDataSourceStore;
     /** Last QueryDefinition row loaded for a string `options.dataSource` key. */
     protected readonly loadedQueryDefinition: _angular_core.WritableSignal<AXPQueryRegistryRecord | null>;
     protected textField: _angular_core.Signal<string>;
@@ -257,6 +258,7 @@ declare abstract class AXPDataListWidgetComponent extends AXPValueWidgetComponen
     /** Drops stale QueryDefinition responses when options/epoch change mid-flight. */
     private dataSourceLoadGeneration;
     private rf;
+    private resolveLocalDataSourceItems;
     private applyDataSource;
     /**
      * Loads {@link QUERY_DEFINITION_ENTITY} via {@link ENTITY_GET_BY_ID_DEFAULT}.
@@ -300,6 +302,9 @@ declare abstract class AXPColumnWidgetComponent<T = any | null | void> {
 }
 
 declare abstract class AXPBoxModelLayoutWidgetComponent extends AXPLayoutBaseWidgetComponent {
+    private readonly injectedLayoutProfile;
+    private readonly deviceService;
+    protected layoutProfileContext: _angular_core.Signal<AXPLayoutProfileContext>;
     hostBoxStyle: _angular_core.Signal<Readonly<Record<string, string | number>>>;
     protected blockStyle: _angular_core.Signal<Readonly<Record<string, string | number>>>;
     protected inlineStyle: _angular_core.Signal<Readonly<Record<string, string | number>>>;
@@ -316,33 +321,6 @@ declare abstract class AXPBlockBaseLayoutWidgetComponent extends AXPBoxModelLayo
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPBlockBaseLayoutWidgetComponent>;
 }
 
-/**
- * Maps a platform {@link AXPProperty} to a property viewer row model ({@link AXPWidgetProperty}).
- * Kept in widget-core (not platform/core) to avoid a dependency cycle: widget-core already depends on platform/core.
- */
-interface MapAXPPropertyToWidgetPropertyOptions {
-    group: AXPWidgetPropertyGroup;
-    order: number;
-    /**
-     * Dot path prefix for {@link AXPWidgetProperty.schema.interface.path}.
-     * Example: `input` → `input.requestId`; `properties` → `properties.message`.
-     */
-    valuePathPrefix: string;
-    /**
-     * Resolves a display title (supports multi-language strings on the source property).
-     */
-    resolveTitle: (property: AXPProperty) => string;
-    /**
-     * Optional description line for the viewer row.
-     */
-    resolveDescription?: (property: AXPProperty) => string | undefined;
-}
-/**
- * Converts a domain {@link AXPProperty} into a {@link AXPWidgetProperty} row for
- * the layout property viewer (`AXPPropertyViewerService` and `buildPropertyViewerTabsFromProperties`).
- */
-declare function mapAXPPropertyToWidgetProperty(property: AXPProperty, options: MapAXPPropertyToWidgetPropertyOptions): AXPWidgetProperty;
-
 type AXPPropertyEditorSideValues = 'top' | 'left' | 'bottom' | 'right';
 type AXPPropertyEditorCornerValues = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 type AXPPropertyEditorSideGeneric<T extends string, U extends string | number = string> = Record<T, U>;
@@ -407,6 +385,35 @@ type AXPBreakpointValues<T> = {
     [key in AXPBreakpoints]?: T;
 };
 
+declare function coerceGridProfile(value: AXPGridBreakpointValues | undefined): AXPLayoutProfileValues<AXPGridBoxString>;
+
+/**
+ * Maps a platform {@link AXPProperty} to a property viewer row model ({@link AXPWidgetProperty}).
+ * Kept in widget-core (not platform/core) to avoid a dependency cycle: widget-core already depends on platform/core.
+ */
+interface MapAXPPropertyToWidgetPropertyOptions {
+    group: AXPWidgetPropertyGroup;
+    order: number;
+    /**
+     * Dot path prefix for {@link AXPWidgetProperty.schema.interface.path}.
+     * Example: `input` → `input.requestId`; `properties` → `properties.message`.
+     */
+    valuePathPrefix: string;
+    /**
+     * Resolves a display title (supports multi-language strings on the source property).
+     */
+    resolveTitle: (property: AXPProperty) => string;
+    /**
+     * Optional description line for the viewer row.
+     */
+    resolveDescription?: (property: AXPProperty) => string | undefined;
+}
+/**
+ * Converts a domain {@link AXPProperty} into a {@link AXPWidgetProperty} row for
+ * the layout property viewer (`AXPPropertyViewerService` and `buildPropertyViewerTabsFromProperties`).
+ */
+declare function mapAXPPropertyToWidgetProperty(property: AXPProperty, options: MapAXPPropertyToWidgetPropertyOptions): AXPWidgetProperty;
+
 declare class AXPPropertyEditorHelper {
     private static expandShorthand;
     private static condenseShorthand;
@@ -431,6 +438,11 @@ declare class AXPPropertyEditorHelper {
 }
 declare function findNonEmptyBreakpoints<T>(values: AXPBreakpointValues<T>): AXPBreakpoints[];
 
+declare const AXP_EMPTY_SPACING_BOX: AXPSpacingBoxString;
+declare function isFlatSpacingBox(value: unknown): value is AXPSpacingBoxString;
+declare function coerceSpacingProfile(value: unknown): AXPLayoutProfileValues<AXPSpacingBoxString>;
+declare function spacingBoxOrEmpty(value: Partial<AXPSpacingBoxString> | undefined): AXPSpacingBoxString;
+
 /**
  * Helper class for serializing and deserializing AXPWidgetNode to/from JSON
  */
@@ -505,6 +517,7 @@ declare abstract class AXPFlexItemBaseLayoutWidgetComponent extends AXPInlineBas
 
 declare abstract class AXPGridBaseLayoutWidgetComponent extends AXPBlockBaseLayoutWidgetComponent {
     private grid;
+    private resolvedGrid;
     hostGridStyle: _angular_core.Signal<Record<string, string | number>>;
     hostGridClass: _angular_core.Signal<Record<string, boolean>>;
     hostClass: _angular_core.Signal<Record<string, boolean>>;
@@ -556,6 +569,10 @@ declare abstract class AXPTableItemBaseLayoutWidgetComponent extends AXPTableIte
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPTableItemBaseLayoutWidgetComponent>;
 }
 
+/** Current layout profile for box-model / grid resolve. Designer and preview override this. */
+declare const AXP_LAYOUT_PROFILE: InjectionToken<Signal<AXPLayoutProfileContext>>;
+declare function layoutSizeFromDevice(device: AXPDeviceService | null | undefined): AXPLayoutSize;
+
 declare class AXPWidgetContainerComponent {
     readonly contextService: {
         data: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPContextData>;
@@ -671,16 +688,23 @@ declare class AXPWidgetRegistryService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetRegistryService>;
 }
 
-declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponent implements OnChanges {
+declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponent implements OnChanges, AfterContentInit {
     protected widgetRegistery: AXPWidgetRegistryService;
     private grid;
     private expressionEvaluator;
+    private readonly translation;
+    private readonly destroyRef;
+    /** Original band title key; caption becomes resolved text and must not be re-read for i18n. */
+    private bandCaptionI18nKey;
+    private bandLocaleWatchStarted;
     customExpandIcon: string;
     customCollapseIcon: string;
     customWidth: string;
+    /** Stable column id for bands (no widget node). */
+    columnKey?: string;
     private _node;
-    get node(): AXPWidgetColumnNode;
-    set node(v: AXPWidgetColumnNode);
+    get node(): AXPWidgetColumnNode | undefined;
+    set node(v: AXPWidgetColumnNode | undefined);
     private mergedOptions;
     protected loadingRow: _angular_core.WritableSignal<null>;
     private rowInjectorsCache;
@@ -738,7 +762,13 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
     protected widgetInjector: Injector;
     protected component: any;
     ngOnInit(): Promise<void>;
-    ngOnChanges(): void;
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    /** Band group header uses `column.caption` in a headerRows snapshot — resolve keys and refresh the table. */
+    private resolveBandCaption;
+    private bandCaptionKey;
+    private ensureBandCaptionLocaleWatch;
+    private setBandCaption;
     /**
      * Check if options contain any expressions that need evaluation
      */
@@ -755,10 +785,11 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
      * Limit cache size using simple FIFO eviction
      */
     private evictCacheIfNeeded;
+    private requireNode;
     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; }; "columnFixed": { "alias": "columnFixed"; "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; }; "columnKey": { "alias": "columnKey"; "required": false; }; "node": { "alias": "node"; "required": false; }; "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, ["*"], false, never>;
 }
 
 type AXPWidgetRendererDirectiveOptions = AXPMetaData;
@@ -1110,5 +1141,77 @@ declare const AXP_BETWEEN_VALIDATION_PROPERTY: AXPWidgetProperty;
 declare const AXP_EQUAL_VALIDATION_PROPERTY: AXPWidgetProperty;
 declare const AXP_CALLBACK_VALIDATION_PROPERTY: AXPWidgetProperty;
 
-export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnCellComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXP_ALLOW_CLEAR_PROPERTY, AXP_ALLOW_MULTIPLE_PROPERTY, AXP_ALLOW_SEARCH_PROPERTY, AXP_ANIMATION_PROPERTY_GROUP, AXP_APPEARANCE_PROPERTY_GROUP, AXP_BEHAVIOR_PROPERTY_GROUP, AXP_BETWEEN_VALIDATION_PROPERTY, AXP_BG_COLOR_PROPERTY, AXP_BOX_MODEL_PROPERTY_GROUP, AXP_CALLBACK_VALIDATION_PROPERTY, AXP_COLOR_PROPERTY, AXP_CONTENT_PROPERTY, AXP_DATA_PATH_PROPERTY, AXP_DATA_PROPERTY_GROUP, AXP_DATA_SOURCE_OPTIONS_PROPERTY, AXP_DATE_DEPTH_PROPERTY, AXP_DATE_FORMAT_PROPERTY, AXP_DATE_RANGE_LIMIT_PROPERTY, AXP_DEFAULT_ROW_COUNT_PROPERTY, AXP_DESCRIPTION_PROPERTY, AXP_DIRECTION_PROPERTY, AXP_DISABLED_PROPERTY, AXP_DOWNLOADABLE_PROPERTY, AXP_EQUAL_VALIDATION_PROPERTY, AXP_FALSY_TEXT_PROPERTY, AXP_FIT_LINE_COUNT_PROPERTY, AXP_FONT_SIZE_PROPERTY, AXP_GREATER_THAN_VALIDATION_PROPERTY, AXP_HAS_CLEAR_BUTTON_PROPERTY, AXP_HAS_COPY_ICON_PROPERTY, AXP_HAS_EYE_ICON_PROPERTY, AXP_HAS_ICON_PROPERTY, AXP_HAS_LABEL_PROPERTY, AXP_ICON_PROPERTY, AXP_IS_LOADING_PROPERTY, AXP_LABEL_PROPERTY, AXP_LAYOUT_ADVANCED_GRID_PROPERTY, AXP_LAYOUT_BORDER_PROPERTY, AXP_LAYOUT_COLUMNS_PROPERTY, AXP_LAYOUT_DIRECTION_PROPERTY, AXP_LAYOUT_FLEX_ITEM_PROPERTY, AXP_LAYOUT_FLEX_PROPERTY, AXP_LAYOUT_FLEX_PROPERTY_GROUP, AXP_LAYOUT_GAP_PROPERTY, AXP_LAYOUT_GRID_ITEM_PROPERTY, AXP_LAYOUT_GRID_PROPERTIES, AXP_LAYOUT_GRID_PROPERTY, AXP_LAYOUT_GRID_PROPERTY_GROUP, AXP_LAYOUT_GRID_ROW_PROPERTIES, AXP_LAYOUT_ROWS_PROPERTY, AXP_LAYOUT_SHOW_HEADER_PROPERTY, AXP_LAYOUT_SPACING_PROPERTY, AXP_LAYOUT_TABLE_PROPERTY_GROUP, AXP_LESS_THAN_VALIDATION_PROPERTY, AXP_MAX_LENGTH_VALIDATION_PROPERTY, AXP_MAX_LINE_COUNT_PROPERTY, AXP_MIN_LENGTH_VALIDATION_PROPERTY, AXP_MIN_LINE_COUNT_PROPERTY, AXP_MULTI_LANGUAGE_PROPERTY, AXP_NAME_PROPERTY, AXP_NUMBER_SEPARATOR_PROPERTY, AXP_PLACEHOLDER_PROPERTY, AXP_QUERY_OPTIONS_PROPERTY, AXP_READONLY_PROPERTY, AXP_REGULAR_EXPRESSION_VALIDATION_PROPERTY, AXP_REQUIRED_VALIDATION_PROPERTY, AXP_SHOW_PASSWORD_PROPERTY, AXP_SPIN_BUTTON_PROPERTY, AXP_STYLE_COLOR_PROPERTY, AXP_STYLE_LOOK_PROPERTY, AXP_STYLING_PROPERTY_GROUP, AXP_TABLE_COLUMNS_PROPERTY, AXP_TABLE_COLUMN_ALIGNMENT_PROPERTIES, AXP_TABLE_COLUMN_CELL_ALIGN_PROPERTY, AXP_TABLE_COLUMN_HEADER_ALIGN_PROPERTY, AXP_TABLE_COLUMN_HEIGHT_PROPERTY, AXP_TABLE_COLUMN_WIDTH_PROPERTY, AXP_TABLE_ITEM_COLSPAN_PROPERTY, AXP_TABLE_ITEM_ROWSPAN_PROPERTY, AXP_TEXT_ALIGN_PROPERTY, AXP_TEXT_FIELD_PROPERTY, AXP_TEXT_PROPERTY, AXP_THEME_PROPERTY, AXP_TITLE_PROPERTY, AXP_TRIGGERS_PROPERTY, AXP_TRIGGERS_PROPERTY_GROUP, AXP_TRULY_TEXT_PROPERTY, AXP_VALIDATION_PROPERTY_GROUP, AXP_VALUE_FIELD_PROPERTY, AXP_VERTICAL_ALIGN_PROPERTY, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_PROPERTY_GROUP, WIDGET_CASCADE_TRACE_NS, booleanDefaultProperty, buildQuerySelectorNode, buildQueryTabsNode, buildWidgetRegistryMapFromProviders, createQueryOptionsProperty, findNonEmptyBreakpoints, largeTextDefaultProperty, mapAXPPropertyToWidgetProperty, numberDefaultProperty, numberMaxValueProperty, numberMinValueProperty, plainTextDefaultProperty, resolveWidgetModeComponent, richTextDefaultProperty, selectEditorDefaultValueProperty, selectionListEditorDefaultValueProperty };
-export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetRendererDirectiveOptions, MapAXPPropertyToWidgetPropertyOptions };
+declare const AXP_LOCAL_DATA_SOURCE_PREFIX = "local:";
+/** Document `options` key for the form-local list bag. */
+declare const AXP_LOCAL_DATA_SOURCES_OPTION = "localDataSources";
+declare const AXP_LOCAL_DATA_SOURCE_STORE: InjectionToken<AXPLocalDataSourceStore>;
+interface AXPLocalDataSourceItem {
+    value: string;
+    text: string;
+    [key: string]: unknown;
+}
+/** Column schema for a form-local spreadsheet list. */
+interface AXPLocalDataSourceColumn {
+    name: string;
+    title: string;
+    path: string;
+    widget: AXPWidgetNode;
+    width?: string;
+    readonly?: boolean;
+}
+interface AXPLocalDataSourceSheet {
+    columns: AXPLocalDataSourceColumn[];
+    rows: Record<string, unknown>[];
+}
+interface AXPLocalDataSource {
+    id: string;
+    name: string;
+    columns?: AXPLocalDataSourceColumn[];
+    items: Record<string, unknown>[];
+}
+type AXPLocalDataSourcePatch = Partial<Pick<AXPLocalDataSource, 'name' | 'items' | 'columns'>>;
+interface AXPLocalDataSourceStore {
+    readonly sources: Signal<readonly AXPLocalDataSource[]>;
+    get(id: string): AXPLocalDataSource | undefined;
+    create(name: string): AXPLocalDataSource;
+    update(id: string, patch: AXPLocalDataSourcePatch): void;
+    remove(id: string): void;
+}
+declare function isLocalDataSourceRef(value: unknown): value is string;
+declare function toLocalDataSourceRef(id: string): string;
+declare function parseLocalDataSourceId(ref: string): string | null;
+declare function readLocalDataSourcesFromNode(node: AXPWidgetNode | null | undefined): AXPLocalDataSource[];
+
+/**
+ * Derives stable identity `value` from display `text` (slug) and enforces uniqueness.
+ */
+declare function buildLocalDataSourceListRows(titles: string[]): AXPLocalDataSourceItem[];
+
+/** Enough blank rows to fill the local-list sheet viewport. */
+declare const LOCAL_DATA_SOURCE_SHEET_MIN_ROWS = 8;
+/** Extra blank rows kept below the last used row (Excel-style buffer). */
+declare const LOCAL_DATA_SOURCE_SHEET_BUFFER_ROWS = 5;
+declare function createDefaultLocalDataSourceColumns(): AXPLocalDataSourceColumn[];
+declare function toLocalDataSourceSheet(input: {
+    columns?: readonly AXPLocalDataSourceColumn[];
+    items?: readonly unknown[];
+}): AXPLocalDataSourceSheet;
+declare function ensureLocalDataSourceRowValues(rows: readonly Record<string, unknown>[], columns?: readonly AXPLocalDataSourceColumn[]): Record<string, unknown>[];
+declare function isLocalDataSourceRowEmpty(row: Record<string, unknown>, columns?: readonly AXPLocalDataSourceColumn[]): boolean;
+declare function padLocalDataSourceSheetRows(rows: readonly Record<string, unknown>[], columns: readonly AXPLocalDataSourceColumn[], options?: {
+    minRows?: number;
+    bufferRows?: number;
+    shrink?: boolean;
+}): Record<string, unknown>[];
+
+/**
+ * Fill / preview store: reads the document bag, write methods are no-ops.
+ */
+declare function createReadonlyLocalDataSourceStore(read: () => readonly AXPLocalDataSource[]): AXPLocalDataSourceStore;
+/**
+ * In-memory writable bag for hosts that are not the layout designer.
+ */
+declare function createWritableLocalDataSourceStore(initial?: readonly AXPLocalDataSource[]): AXPLocalDataSourceStore;
+
+export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnCellComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXP_ALLOW_CLEAR_PROPERTY, AXP_ALLOW_MULTIPLE_PROPERTY, AXP_ALLOW_SEARCH_PROPERTY, AXP_ANIMATION_PROPERTY_GROUP, AXP_APPEARANCE_PROPERTY_GROUP, AXP_BEHAVIOR_PROPERTY_GROUP, AXP_BETWEEN_VALIDATION_PROPERTY, AXP_BG_COLOR_PROPERTY, AXP_BOX_MODEL_PROPERTY_GROUP, AXP_CALLBACK_VALIDATION_PROPERTY, AXP_COLOR_PROPERTY, AXP_CONTENT_PROPERTY, AXP_DATA_PATH_PROPERTY, AXP_DATA_PROPERTY_GROUP, AXP_DATA_SOURCE_OPTIONS_PROPERTY, AXP_DATE_DEPTH_PROPERTY, AXP_DATE_FORMAT_PROPERTY, AXP_DATE_RANGE_LIMIT_PROPERTY, AXP_DEFAULT_ROW_COUNT_PROPERTY, AXP_DESCRIPTION_PROPERTY, AXP_DIRECTION_PROPERTY, AXP_DISABLED_PROPERTY, AXP_DOWNLOADABLE_PROPERTY, AXP_EMPTY_SPACING_BOX, AXP_EQUAL_VALIDATION_PROPERTY, AXP_FALSY_TEXT_PROPERTY, AXP_FIT_LINE_COUNT_PROPERTY, AXP_FONT_SIZE_PROPERTY, AXP_GREATER_THAN_VALIDATION_PROPERTY, AXP_HAS_CLEAR_BUTTON_PROPERTY, AXP_HAS_COPY_ICON_PROPERTY, AXP_HAS_EYE_ICON_PROPERTY, AXP_HAS_ICON_PROPERTY, AXP_HAS_LABEL_PROPERTY, AXP_ICON_PROPERTY, AXP_IS_LOADING_PROPERTY, AXP_LABEL_PROPERTY, AXP_LAYOUT_ADVANCED_GRID_PROPERTY, AXP_LAYOUT_BORDER_PROPERTY, AXP_LAYOUT_COLUMNS_PROPERTY, AXP_LAYOUT_DIRECTION_PROPERTY, AXP_LAYOUT_FLEX_ITEM_PROPERTY, AXP_LAYOUT_FLEX_PROPERTY, AXP_LAYOUT_FLEX_PROPERTY_GROUP, AXP_LAYOUT_GAP_PROPERTY, AXP_LAYOUT_GRID_ITEM_PROPERTY, AXP_LAYOUT_GRID_PROPERTIES, AXP_LAYOUT_GRID_PROPERTY, AXP_LAYOUT_GRID_PROPERTY_GROUP, AXP_LAYOUT_GRID_ROW_PROPERTIES, AXP_LAYOUT_PROFILE, AXP_LAYOUT_ROWS_PROPERTY, AXP_LAYOUT_SHOW_HEADER_PROPERTY, AXP_LAYOUT_SPACING_PROPERTY, AXP_LAYOUT_TABLE_PROPERTY_GROUP, AXP_LESS_THAN_VALIDATION_PROPERTY, AXP_LOCAL_DATA_SOURCES_OPTION, AXP_LOCAL_DATA_SOURCE_PREFIX, AXP_LOCAL_DATA_SOURCE_STORE, AXP_MAX_LENGTH_VALIDATION_PROPERTY, AXP_MAX_LINE_COUNT_PROPERTY, AXP_MIN_LENGTH_VALIDATION_PROPERTY, AXP_MIN_LINE_COUNT_PROPERTY, AXP_MULTI_LANGUAGE_PROPERTY, AXP_NAME_PROPERTY, AXP_NUMBER_SEPARATOR_PROPERTY, AXP_PLACEHOLDER_PROPERTY, AXP_QUERY_OPTIONS_PROPERTY, AXP_READONLY_PROPERTY, AXP_REGULAR_EXPRESSION_VALIDATION_PROPERTY, AXP_REQUIRED_VALIDATION_PROPERTY, AXP_SHOW_PASSWORD_PROPERTY, AXP_SPIN_BUTTON_PROPERTY, AXP_STYLE_COLOR_PROPERTY, AXP_STYLE_LOOK_PROPERTY, AXP_STYLING_PROPERTY_GROUP, AXP_TABLE_COLUMNS_PROPERTY, AXP_TABLE_COLUMN_ALIGNMENT_PROPERTIES, AXP_TABLE_COLUMN_CELL_ALIGN_PROPERTY, AXP_TABLE_COLUMN_HEADER_ALIGN_PROPERTY, AXP_TABLE_COLUMN_HEIGHT_PROPERTY, AXP_TABLE_COLUMN_WIDTH_PROPERTY, AXP_TABLE_ITEM_COLSPAN_PROPERTY, AXP_TABLE_ITEM_ROWSPAN_PROPERTY, AXP_TEXT_ALIGN_PROPERTY, AXP_TEXT_FIELD_PROPERTY, AXP_TEXT_PROPERTY, AXP_THEME_PROPERTY, AXP_TITLE_PROPERTY, AXP_TRIGGERS_PROPERTY, AXP_TRIGGERS_PROPERTY_GROUP, AXP_TRULY_TEXT_PROPERTY, AXP_VALIDATION_PROPERTY_GROUP, AXP_VALUE_FIELD_PROPERTY, AXP_VERTICAL_ALIGN_PROPERTY, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_PROPERTY_GROUP, LOCAL_DATA_SOURCE_SHEET_BUFFER_ROWS, LOCAL_DATA_SOURCE_SHEET_MIN_ROWS, WIDGET_CASCADE_TRACE_NS, booleanDefaultProperty, buildLocalDataSourceListRows, buildQuerySelectorNode, buildQueryTabsNode, buildWidgetRegistryMapFromProviders, coerceGridProfile, coerceSpacingProfile, createDefaultLocalDataSourceColumns, createQueryOptionsProperty, createReadonlyLocalDataSourceStore, createWritableLocalDataSourceStore, ensureLocalDataSourceRowValues, findNonEmptyBreakpoints, isFlatSpacingBox, isLocalDataSourceRef, isLocalDataSourceRowEmpty, largeTextDefaultProperty, layoutSizeFromDevice, mapAXPPropertyToWidgetProperty, numberDefaultProperty, numberMaxValueProperty, numberMinValueProperty, padLocalDataSourceSheetRows, parseLocalDataSourceId, plainTextDefaultProperty, readLocalDataSourcesFromNode, resolveWidgetModeComponent, richTextDefaultProperty, selectEditorDefaultValueProperty, selectionListEditorDefaultValueProperty, spacingBoxOrEmpty, toLocalDataSourceRef, toLocalDataSourceSheet };
+export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPLocalDataSource, AXPLocalDataSourceColumn, AXPLocalDataSourceItem, AXPLocalDataSourcePatch, AXPLocalDataSourceSheet, AXPLocalDataSourceStore, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetRendererDirectiveOptions, MapAXPPropertyToWidgetPropertyOptions };