@praxisui/page-builder 10.0.0-rc.19 → 10.0.0-rc.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "10.0.0-rc.19",
+  "version": "10.0.0-rc.21",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.19",
-    "@praxisui/core": "^10.0.0-rc.19",
-    "@praxisui/settings-panel": "^10.0.0-rc.19",
+    "@praxisui/ai": "^10.0.0-rc.21",
+    "@praxisui/core": "^10.0.0-rc.21",
+    "@praxisui/settings-panel": "^10.0.0-rc.21",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -2,7 +2,7 @@ import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
 import * as _praxisui_core from '@praxisui/core';
-import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, WidgetPageGroupingDefinition, WidgetPageDataSourceKind, WidgetPageDataSourceMethod, WidgetPageDataSourceErrorPolicy, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, WidgetPageDataSourceDefinition, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetPagePersistenceState, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, WidgetShellConfig, ComponentMetadataRegistry, PraxisI18nService, SettingsEditorSection, EndpointRef, PraxisTextValue, WidgetShellPresetCategory, CompositionLink, WidgetShellAction, WidgetPageAuthoringCapabilities, PortContract, ComponentPortPathSegment, LinkIntent, WidgetPageDefinition, SurfaceOpenActionEditorComponent, TransformKind, TransformPipeline, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, WidgetShellPresetDefinition, WidgetPageCanvasLayout, WidgetPageGroupingDefinition, WidgetPageDataSourceDefinition, WidgetPageDataSourceKind, WidgetPageDataSourceMethod, WidgetPageDataSourceErrorPolicy, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, TransformOutputHint, TransformSemanticKind, ConfigAuthoringSource, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, ComponentContextPack, ComponentAuthoringManifest, DiagnosticRecord, NestedPortCatalogRegistry, CompositionValidatorService, ApiUrlEntry, DynamicWidgetPageComponent, ConfigDocument, WidgetPagePersistenceState, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
@@ -1091,6 +1091,7 @@ declare class CanvasConstraintEditorModel {
         width: number;
         height: number;
     };
+    private resolveFriendlyWidgetTitle;
 }
 
 type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state' | 'limits';
@@ -1105,6 +1106,21 @@ type GroupingNodeGroup$1 = FormGroup<{
     side: FormControl<string>;
     tabsJson: FormControl<string>;
 }>;
+type DataSourceNodeGroup$1 = FormGroup<{
+    id: FormControl<string>;
+    kind: FormControl<string>;
+    resourcePath: FormControl<string>;
+    endpointKey: FormControl<string>;
+    method: FormControl<string>;
+    targetStatePath: FormControl<string>;
+    errorPolicy: FormControl<string>;
+    refreshIntervalMs: FormControl<number | null>;
+    autoFetch: FormControl<string>;
+    description: FormControl<string>;
+    queryJson: FormControl<string>;
+    transformJson: FormControl<string>;
+    fallbackJson: FormControl<string>;
+}>;
 type DeviceVariantForm = FormGroup<{
     columns: FormControl<number | null>;
     rowUnit: FormControl<string>;
@@ -1230,6 +1246,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly contextControl: FormControl<string>;
     readonly stateControl: FormControl<string>;
     readonly dataSourcesControl: FormControl<string>;
+    readonly dataSourceNodes: FormArray<DataSourceNodeGroup$1>;
     readonly groupingNodes: FormArray<GroupingNodeGroup$1>;
     readonly deviceForms: Record<DeviceKey, DeviceVariantForm>;
     readonly isDirty$: BehaviorSubject<boolean>;
@@ -1244,6 +1261,13 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly canvasLimits: CanvasConstraintEditorModel;
     readonly limitsTargetControl: FormControl<number>;
     readonly limitsError: WritableSignal<string | null>;
+    readonly previousAdjustableHeights: WritableSignal<{
+        key: string;
+        title: string;
+        scope: string;
+        scopeLabel: string;
+        heightPx: number;
+    }[]>;
     readonly limitsErrorMatcher: {
         isErrorState: (control: FormControl | null) => boolean;
     };
@@ -1255,6 +1279,8 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly stackedDevices: Set<DeviceKey>;
     readonly activeDevice: WritableSignal<DeviceKey>;
     private hydrating;
+    private syncingDataSources;
+    private guidedDataSourcesInvalid;
     private renderedCandidate;
     private renderedValidationFingerprint;
     private readonly tabOrder;
@@ -1267,6 +1293,17 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get dirtyStateLabel(): string;
     get nonLimitError(): string | null;
     get limitsSummaryError(): string | null;
+    get blockedGeometryWidgets(): Array<{
+        targetIndex: number;
+        key: string;
+        title: string;
+        scope: string;
+        scopeLabel: string;
+        heightPx: number | null;
+        message: string;
+    }>;
+    navigateToBlockedLimit(targetIndex?: number): void;
+    switchBlockedWidgetsToAutoHeight(): void;
     get selectedLayoutPresetLabel(): string;
     get selectedThemePresetLabel(): string;
     get selectedLayoutPresetEntry(): LayoutPresetEntry | null;
@@ -1287,6 +1324,9 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private stackedCanvas;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
+    addDataSourceNode(seed?: Partial<WidgetPageDataSourceDefinition>): void;
+    removeDataSourceNode(index: number): void;
+    dataSourceLabel(index: number): string;
     layoutPresetSummary(preset: LayoutPresetEntry): string;
     slotsSummary(preset: LayoutPresetEntry): string;
     requiredSlotsSummary(preset: LayoutPresetEntry): string;
@@ -1306,6 +1346,11 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     protected refreshRenderedValidation(): void;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
+    private createDataSourceNodeGroup;
+    private replaceDataSourceNodes;
+    private buildDataSourcesFromNodes;
+    private syncDataSourcesJsonFromNodes;
+    private syncDataSourceNodesFromJson;
     private hydrate;
     private replaceGroupingNodes;
     private buildCurrentPage;
@@ -1323,10 +1368,13 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private parseJson;
     private parseRecordJson;
     private parseDataSourcesJson;
+    private isValidDataSourceTransform;
+    private validateDataSourceEntry;
     private isValidDataSourcesPayload;
     private parseGroupingTabs;
     private parseGroupingOverrides;
     private parseWidgetOverrides;
+    private validateWidgetOverrides;
     private isGroupingTab;
     private isGroupingOverride;
     private isWidgetOverride;
@@ -1555,6 +1603,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     private stringifyGroupingWidgetKeys;
     private buildGrouping;
     private hydrateDeviceLayoutControls;
+    private deviceOverridesError;
     private buildDeviceLayouts;
     private createDeviceLayoutForm;
     private patchDeviceLayoutForm;
@@ -1566,6 +1615,9 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     private createDataSourceNodeGroup;
     private syncDataSourceNodesFromControl;
     private syncDataSourcesControlFromNodes;
+    private isPlainRecord;
+    private isValidDataSourceTransform;
+    private validateDataSourceEntry;
     private isValidDataSourcesPayload;
     private buildDataSourcesFromNodes;
     private buildDataSources;