@praxisui/page-builder 9.0.68-rc.0 → 9.0.68-rc.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.68-rc.0",
+  "version": "9.0.68-rc.2",
   "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": "^9.0.68-rc.0",
-    "@praxisui/core": "^9.0.68-rc.0",
-    "@praxisui/settings-panel": "^9.0.68-rc.0",
+    "@praxisui/ai": "^9.0.68-rc.2",
+    "@praxisui/core": "^9.0.68-rc.2",
+    "@praxisui/settings-panel": "^9.0.68-rc.2",
     "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, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, WidgetPageCanvasLayout, 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, 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, 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, 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';
@@ -210,10 +210,16 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
         collapsible: FormControl<boolean>;
         cardBg: FormControl<string>;
         cardBorder: FormControl<string>;
+        cardBorderWidth: FormControl<string>;
+        cardBorderStyle: FormControl<string>;
         cardRadius: FormControl<string>;
         cardShadow: FormControl<string>;
+        cardFilter: FormControl<string>;
+        cardFallbackBg: FormControl<string>;
         headerBg: FormControl<string>;
         headerBorder: FormControl<string>;
+        headerBorderWidth: FormControl<string>;
+        headerBorderStyle: FormControl<string>;
         titleColor: FormControl<string>;
         subtitleColor: FormControl<string>;
         iconColor: FormControl<string>;
@@ -257,6 +263,7 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     selectPreset(id: string): void;
     presetLabel(preset: ShellPresetOption): string;
     presetDescription(preset: ShellPresetOption): string;
+    effectivePresetLabel(): string;
     presetTitle(): string;
     noPresetLabel(): string;
     noPresetDescription(): string;
@@ -1117,6 +1124,75 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     presets?: unknown;
     pagePreset?: string | null;
     pageChange: EventEmitter<WidgetPageDefinition>;
+    private arrangementFeedback?;
+    private focusArrangementFeedback;
+    readonly workspaceTab: WritableSignal<number>;
+    readonly arrangementSelection: WritableSignal<string>;
+    readonly arrangementChoices: readonly [{
+        readonly id: "stack";
+        readonly weights: readonly [1];
+    }, {
+        readonly id: "compare";
+        readonly weights: readonly [1, 1];
+    }, {
+        readonly id: "primary";
+        readonly weights: readonly [2, 1];
+    }, {
+        readonly id: "secondary";
+        readonly weights: readonly [1, 2];
+    }, {
+        readonly id: "grid";
+        readonly weights: readonly [1, 1, 1];
+    }, {
+        readonly id: "center";
+        readonly weights: readonly [1, 2, 1];
+    }, {
+        readonly id: "wide-left";
+        readonly weights: readonly [3, 1];
+    }, {
+        readonly id: "wide-right";
+        readonly weights: readonly [1, 3];
+    }, {
+        readonly id: "four";
+        readonly weights: readonly [1, 1, 1, 1];
+    }];
+    arrangementWidths(id: string): number[];
+    arrangementFits(id: string): boolean;
+    themeTokens(id: string): Record<string, string>;
+    shellName(id: string): string;
+    shellDescription(preset: WidgetShellPresetDefinition): string;
+    previewRowCount(before: WidgetPageCanvasLayout, after: WidgetPageCanvasLayout): number;
+    previewItems(canvas: WidgetPageCanvasLayout): {
+        key: string;
+        number: number;
+        label: string;
+        col: number;
+        row: number;
+        colSpan: number;
+        rowSpan: number;
+        contentSize?: "auto" | {
+            heightPx: number;
+            offsetTopPx?: number;
+        };
+        zIndex?: number;
+        constraints?: _praxisui_core.WidgetPageCanvasConstraints;
+    }[];
+    readonly arrangementPreview: WritableSignal<{
+        source: string;
+        before: WidgetPageCanvasLayout;
+        canvas: WidgetPageCanvasLayout;
+        keys: string[];
+    } | null>;
+    readonly arrangementMessage: WritableSignal<string>;
+    readonly arrangementUndoAvailable: WritableSignal<boolean>;
+    private arrangedItems;
+    private arrangementAppliedDocument;
+    private arrangementSourcePage;
+    private arrangementGeometry;
+    private previousArrangementItems;
+    prepareArrangement(id: string): void;
+    useArrangement(): void;
+    undoArrangement(): void;
     readonly layoutPresetEntries: LayoutPresetEntry[];
     readonly themePresetEntries: ThemePresetEntry[];
     readonly shellPresetEntries: readonly WidgetShellPresetDefinition[];
@@ -1175,9 +1251,12 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get selectedThemePresetEntry(): ThemePresetEntry | null;
     get recommendedThemePresetEntry(): ThemePresetEntry | null;
     get canvasSummaryLabel(): string;
+    private focusEditorTab;
+    selectDetailTab(index: number): void;
     onSelectedTabIndexChange(index: number): void;
     getSettingsValue(): WidgetPageDefinition | null;
     onSave(): WidgetPageDefinition | null;
+    acceptAppliedValue(value: unknown): void;
     reset(): void;
     pinRecommendedThemePreset(): void;
     get hasCanvasWidgets(): boolean;
@@ -1198,6 +1277,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private draftFingerprint;
     limitsGeometryLabel(): string;
     limitsUseContentHeight(): boolean;
+    private geometryFingerprint;
     private applyCanvasLimits;
     private readRenderedIssue;
     protected refreshRenderedValidation(): void;
@@ -1207,11 +1287,14 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private replaceGroupingNodes;
     private buildCurrentPage;
     private buildGrouping;
+    private buildPageContext;
+    private buildCanvas;
     /** A grid must place every existing widget before replacing the flow layout. */
     private completeCanvasItems;
     private buildDeviceLayouts;
     private invalidate;
     private refreshPanelState;
+    get layoutPresetOptions(): WidgetPageDefinition['layoutPresetOptions'];
     private currentPageInput;
     private parsePage;
     private parseJson;
@@ -1437,6 +1520,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     getSettingsValue(): PageDefinition | null;
     onSave(): PageDefinition | null;
     private lookupPresetLabel;
+    get layoutPresetOptions(): WidgetPageDefinition['layoutPresetOptions'];
     private currentPageInput;
     private extractShellPreset;
     private buildCurrentPage;