@praxisui/page-builder 9.0.67 → 9.0.68-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.67",
+  "version": "9.0.68-rc.1",
   "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.67",
-    "@praxisui/core": "^9.0.67",
-    "@praxisui/settings-panel": "^9.0.67",
+    "@praxisui/ai": "^9.0.68-rc.1",
+    "@praxisui/core": "^9.0.68-rc.1",
+    "@praxisui/settings-panel": "^9.0.68-rc.1",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -2,10 +2,10 @@ 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, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, PortContract, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, WidgetPageDeviceKind, SettingsValueProvider as SettingsValueProvider$1, 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, 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 * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
-import { FormGroup, FormControl, FormArray } from '@angular/forms';
+import { FormGroup, FormControl, FormArray, AbstractControl } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AiJsonObject, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamContextHintsContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantVoiceInputMode, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantRecommendedIntent, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 import * as _praxisui_page_builder from '@praxisui/page-builder';
@@ -70,6 +70,7 @@ interface ComponentPaletteSelection {
     componentId: string;
     presetId?: string;
     inputs?: Record<string, unknown>;
+    shell?: WidgetShellConfig;
 }
 interface ComponentPaletteData {
     title?: string;
@@ -88,6 +89,7 @@ interface ComponentPaletteEntry {
     badges: ComponentPaletteBadge[];
     searchText: string;
     inputs?: Record<string, unknown>;
+    shell?: WidgetShellConfig;
 }
 interface ComponentPaletteBadge {
     label: string;
@@ -127,6 +129,9 @@ declare class ComponentPaletteDialogComponent implements OnInit {
 }
 
 type ShellInputs = {
+    /** Canonical page links supplied only for inspection; never persisted by this editor. */
+    compositionLinks?: readonly CompositionLink[];
+    getActionAvailability?: (action: WidgetShellAction) => Pick<WidgetShellAction, 'disabled' | 'tooltip'> | undefined;
     shell?: WidgetShellConfig | null;
     widgetKey?: string;
     widgetType?: string;
@@ -161,10 +166,32 @@ type SetInputPreset = {
     icon?: string;
     values: SetInputValueOption[];
 };
+type ShellPresetOption = {
+    id: string;
+    label: PraxisTextValue;
+    description: PraxisTextValue;
+    category: WidgetShellPresetCategory | 'custom';
+    appearance?: WidgetShellConfig['appearance'];
+};
 declare class WidgetShellEditorComponent implements SettingsValueProvider {
     private registry?;
+    readonly sectionsHosted: boolean;
+    readonly topicPanelId: string;
+    readonly selectedTopic: _angular_core.WritableSignal<string>;
+    editorTopics(): Array<{
+        id: string;
+        label: string;
+    }>;
+    currentTopic(): string;
+    getSettingsSections(): readonly SettingsEditorSection[];
+    selectSettingsSection(id: string): void;
+    endpointLabel(endpoint: EndpointRef): string;
+    currentTopicLabel(): string;
     private readonly i18n;
     menuPlacementLabel(): string;
+    shellText(key: string): string;
+    pagePresetLabel(): string;
+    hasAppearanceErrors(): boolean;
     appearanceError(): string;
     stickyHeaderLabel(): string;
     form: FormGroup<{
@@ -173,6 +200,10 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
         applyToAll: FormControl<boolean>;
         title: FormControl<string>;
         subtitle: FormControl<string>;
+        avatarEnabled: FormControl<boolean>;
+        avatarImage: FormControl<string>;
+        avatarName: FormControl<string>;
+        avatarInitials: FormControl<string>;
         icon: FormControl<string>;
         showHeader: FormControl<"auto" | "true" | "false">;
         stickyHeader: FormControl<boolean>;
@@ -205,35 +236,42 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     private initialTitle;
     private initialSubtitle;
     private readonly actionCopySources;
-    presetOptions: Array<{
-        id: string;
-        label: string;
-    }>;
+    presetOptions: ShellPresetOption[];
     private presets;
     availableActions: AvailableShellAction[];
+    readonly compositionLinks: readonly CompositionLink[];
+    private readonly getActionAvailability?;
     actionQuery: FormControl<string>;
     showScopeShell: boolean;
     showScopeAny: boolean;
     showScopeToolbar: boolean;
+    showNotificationActions: boolean;
     showScopeContext: boolean;
     setInputPresets: SetInputPreset[];
     setInputTarget: FormControl<string>;
     setInputValue: FormControl<any>;
-    previewCollapsed: boolean;
-    previewExpanded: boolean;
     pagePreset: string | null;
     private readonly authoringCapabilities;
     constructor(data?: ShellInputs | null, registry?: (ComponentMetadataRegistry | null) | undefined);
     get actions(): FormArray<FormGroup>;
+    selectPreset(id: string): void;
+    presetLabel(preset: ShellPresetOption): string;
+    presetDescription(preset: ShellPresetOption): string;
+    presetTitle(): string;
+    noPresetLabel(): string;
+    noPresetDescription(): string;
     get hasAvailableActions(): boolean;
     canEditShellIdentity(): boolean;
     canEditShellAppearance(): boolean;
     canEditShellActions(): boolean;
     canPromotePagePreset(): boolean;
+    actionIdIssue(group: AbstractControl): 'required' | 'duplicate' | 'reserved' | null;
+    private validateActionIds;
     addAction(seed?: Partial<WidgetShellAction>): void;
     removeAction(index: number): void;
     getSettingsValue(): ShellEditorResult;
     onSave(): ShellEditorResult;
+    acceptAppliedValue(value: unknown): void;
     reset(): void;
     private applyShell;
     private loadAvailableActions;
@@ -243,23 +281,22 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     private buildAppearance;
     private cloneAppearance;
     private isShellCapabilityEnabled;
-    previewVars(): Record<string, string | null>;
-    previewShowHeader(): boolean;
-    previewTitle(): string;
-    previewSubtitle(): string;
-    private buildPreviewAppearance;
+    private readonly appearanceControls;
+    appearanceOverrideCount(): number;
+    clearAppearanceOverrides(): void;
+    private previewCacheKey;
+    private previewCache?;
+    previewShell(): WidgetShellConfig;
     private mergeAppearance;
-    togglePreviewCollapse(): void;
-    togglePreviewExpand(): void;
-    previewHeaderActions(): WidgetShellAction[];
-    previewOverflowCount(): number;
-    previewWindowActions(): WidgetShellAction[];
     private normalizeAction;
     private editableText;
     private preserveTextDescriptor;
     private tryParsePayload;
     private snapshotValue;
+    enabledActionScopeCount(): number;
     filteredAvailableActions(): AvailableShellAction[];
+    actionUnavailable(action: AvailableShellAction): boolean;
+    actionAvailabilityText(action: AvailableShellAction): string;
     isActionSelected(action: AvailableShellAction): boolean;
     toggleAvailableAction(action: AvailableShellAction): void;
     scopeLabel(scope?: string): string;
@@ -270,7 +307,6 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     currentSetInputValues(): SetInputValueOption[];
     addSetInputAction(): void;
     private findActionIndex;
-    private previewActions;
     private loadSetInputPresets;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WidgetShellEditorComponent, [{ optional: true; }, { optional: true; }]>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<WidgetShellEditorComponent, "praxis-widget-shell-editor", never, {}, {}, never, never, true, never>;
@@ -352,6 +388,41 @@ interface ConnectionEditorTraceStep {
     blocked: boolean;
 }
 
+interface ConnectionEditorPoint {
+    x: number;
+    y: number;
+}
+interface ConnectionEditorSegmentGeometry {
+    port: ConnectionEditorPort;
+    path: string;
+    anchor: ConnectionEditorPoint;
+    label: ConnectionEditorPoint;
+    icon: ConnectionEditorPoint;
+    normalAngle: number;
+    color: string;
+}
+
+type CaptionSide = 'top' | 'right' | 'bottom' | 'left';
+interface ConnectionEditorCaption {
+    side: CaptionSide;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
+interface ConnectionEditorWireRoute {
+    path: string;
+    source: ConnectionEditorPoint;
+    sourceStub: ConnectionEditorPoint;
+    sourceControl: ConnectionEditorPoint;
+    targetControl: ConnectionEditorPoint;
+    targetStub: ConnectionEditorPoint;
+    target: ConnectionEditorPoint;
+    midpoint: ConnectionEditorPoint;
+    offset: number;
+}
+
 interface ConnectionsViewerNode {
     widgetId: string;
     componentType: string;
@@ -389,20 +460,6 @@ interface ConnectionsViewerModel {
     diagnosticLinks: number;
 }
 
-interface ConnectionEditorPoint {
-    x: number;
-    y: number;
-}
-interface ConnectionEditorSegmentGeometry {
-    port: ConnectionEditorPort;
-    path: string;
-    anchor: ConnectionEditorPoint;
-    label: ConnectionEditorPoint;
-    icon: ConnectionEditorPoint;
-    normalAngle: number;
-    color: string;
-}
-
 type ConnectionEditorPortOrderState = Record<string, string[]>;
 
 type ConnectionsEditorFilter = 'all' | 'condition' | 'transform' | 'policy' | 'diagnostic';
@@ -477,9 +534,12 @@ interface ConnectionEditorDockTabDefinition {
 }
 declare class ConnectionEditorComponent {
     readonly stateNodeId = "__page_state__";
+    protected readonly minZoom = 0.2;
+    protected readonly maxZoom = 1.8;
     readonly nodeViewBox = "0 0 168 168";
     readonly canvasViewBox = "0 0 900 540";
     readonly nodeHaloPaths: string[];
+    private readonly injector;
     private readonly i18n;
     private readonly hostElement;
     private readonly globalActionCatalog;
@@ -506,6 +566,7 @@ declare class ConnectionEditorComponent {
     readonly draftTargets: _angular_core.Signal<ConnectionEditorPort[]>;
     readonly draftDiagnostics: _angular_core.Signal<_praxisui_core.DiagnosticRecord[]>;
     readonly draftDuplicate: _angular_core.Signal<boolean>;
+    readonly draftExistingRoute: _angular_core.Signal<ConnectionEditorConnection | null>;
     readonly canApplyDraft: _angular_core.Signal<boolean>;
     readonly activeMode: _angular_core.WritableSignal<ConnectionEditorFlowMode>;
     readonly activeFilter: _angular_core.WritableSignal<ConnectionsEditorFilter>;
@@ -517,12 +578,18 @@ declare class ConnectionEditorComponent {
     readonly expandedNodeId: _angular_core.WritableSignal<string | null>;
     readonly activeDockTab: _angular_core.WritableSignal<ConnectionEditorDockTab>;
     readonly dockCollapsed: _angular_core.WritableSignal<boolean>;
+    readonly inspectorOpen: _angular_core.WritableSignal<boolean>;
+    readonly connectionIntents: _angular_core.Signal<_praxisui_core.LinkIntent[]>;
     readonly traceEnabled: _angular_core.WritableSignal<boolean>;
     readonly traceStepIndex: _angular_core.WritableSignal<number>;
     readonly traceSourceNodeId: _angular_core.WritableSignal<string | null>;
+    readonly traceSourceEndpoint: _angular_core.WritableSignal<EndpointRef | null>;
     readonly selectedPort: _angular_core.WritableSignal<ConnectionEditorPort | null>;
     readonly hoveredNodeId: _angular_core.WritableSignal<string | null>;
     readonly visualDensity: _angular_core.WritableSignal<ConnectionEditorVisualDensity>;
+    private readonly invalidSurfaceDrafts;
+    readonly surfaceDraftInvalid: _angular_core.WritableSignal<boolean>;
+    onSurfaceDraftValidity(source: SurfaceOpenActionEditorComponent, connection: ConnectionEditorConnection, valid: boolean): void;
     readonly globalActionPayloadError: _angular_core.WritableSignal<string | null>;
     readonly pendingSegmentState: _angular_core.WritableSignal<PendingSegmentState | null>;
     readonly dragState: _angular_core.WritableSignal<DragState | null>;
@@ -531,6 +598,7 @@ declare class ConnectionEditorComponent {
     readonly panState: _angular_core.WritableSignal<PanState | null>;
     readonly minimapPanState: _angular_core.WritableSignal<MinimapPanState | null>;
     readonly rotationState: _angular_core.WritableSignal<RotationState | null>;
+    readonly captionLayoutScale: _angular_core.WritableSignal<number>;
     readonly viewport: _angular_core.WritableSignal<ViewportState>;
     readonly portOrder: _angular_core.WritableSignal<ConnectionEditorPortOrderState>;
     readonly nodeRotations: _angular_core.WritableSignal<Record<string, number>>;
@@ -605,9 +673,14 @@ declare class ConnectionEditorComponent {
     readonly connectedNodeIds: _angular_core.Signal<Set<string>>;
     readonly connectedPortIds: _angular_core.Signal<Set<string>>;
     readonly editorNodes: _angular_core.Signal<ConnectionEditorNode[]>;
+    readonly nodeCaptions: _angular_core.Signal<Map<string, ConnectionEditorCaption>>;
+    protected readonly captionRenderRatio: _angular_core.Signal<number>;
+    protected readonly renderedNodeCaptions: _angular_core.Signal<Map<string, ConnectionEditorCaption>>;
+    readonly wireRoutes: _angular_core.Signal<Map<string, ConnectionEditorWireRoute | null>>;
     readonly navigationBounds: _angular_core.Signal<ConnectionEditorBounds>;
     readonly minimapViewBox: _angular_core.Signal<string>;
     readonly editorConnections: _angular_core.Signal<ConnectionEditorConnection[]>;
+    readonly dockConnections: _angular_core.Signal<ConnectionEditorConnection[]>;
     readonly canvasEditorConnections: _angular_core.Signal<ConnectionEditorConnection[]>;
     readonly visibleEditorConnections: _angular_core.Signal<ConnectionEditorConnection[]>;
     readonly modeMatchedConnectionIds: _angular_core.Signal<Set<string>>;
@@ -616,14 +689,38 @@ declare class ConnectionEditorComponent {
     readonly smartSuggestions: _angular_core.Signal<ConnectionEditorSuggestion[]>;
     readonly recommendedMasterDetailSuggestion: _angular_core.Signal<ConnectionEditorSuggestion | null>;
     readonly masterDetailReadinessDiagnostic: _angular_core.Signal<string | null>;
+    readonly compactStage: _angular_core.WritableSignal<boolean>;
     readonly traceSteps: _angular_core.Signal<ConnectionEditorTraceStep[]>;
+    readonly traceConnectionSteps: _angular_core.Signal<{
+        order: number;
+        id: string;
+        connectionId: string;
+        phase: ConnectionEditorTracePhase;
+        fromLabel: string;
+        toLabel: string;
+        intent: string;
+        blocked: boolean;
+    }[]>;
+    readonly activeTraceOperations: _angular_core.Signal<ConnectionEditorTraceStep[]>;
+    readonly activeTraceSummary: _angular_core.Signal<string>;
     readonly activeTraceStepIndex: _angular_core.Signal<number>;
-    readonly traceActiveStep: _angular_core.Signal<ConnectionEditorTraceStep>;
+    readonly traceActiveStep: _angular_core.Signal<{
+        order: number;
+        id: string;
+        connectionId: string;
+        phase: ConnectionEditorTracePhase;
+        fromLabel: string;
+        toLabel: string;
+        intent: string;
+        blocked: boolean;
+    }>;
     readonly tracedConnectionIds: _angular_core.Signal<Set<string>>;
     readonly traceProgressPercent: _angular_core.Signal<number>;
     readonly traceProgressLabel: _angular_core.Signal<string>;
     readonly traceSourceNodeIds: _angular_core.Signal<Set<string>>;
     readonly traceReactingNodeIds: _angular_core.Signal<Set<string>>;
+    private readonly syncTracePresentation;
+    private revealInScrollRegion;
     readonly focusedConnectionNodeIds: _angular_core.Signal<Set<string>>;
     readonly focusedConnectionPortIds: _angular_core.Signal<Set<string>>;
     readonly diagnosticConnectionIds: _angular_core.Signal<Set<string>>;
@@ -634,6 +731,7 @@ declare class ConnectionEditorComponent {
     readonly canvasInteractionActive: _angular_core.Signal<boolean>;
     readonly visibleConnectionTooltip: _angular_core.Signal<ConnectionEditorConnection | null>;
     readonly visibleExpandedNodeId: _angular_core.Signal<string | null>;
+    readonly expandedEditorNode: _angular_core.Signal<ConnectionEditorNode | null>;
     readonly canUndo: _angular_core.Signal<boolean>;
     readonly canRedo: _angular_core.Signal<boolean>;
     readonly hasVisualPortOrder: _angular_core.Signal<boolean>;
@@ -662,11 +760,19 @@ declare class ConnectionEditorComponent {
         width: number;
         height: number;
     }>;
-    selectNode(nodeId: string): void;
+    private inspectorInvoker;
+    private portInvoker;
+    private inspectorPortContext;
+    selectNode(nodeId: string, event?: Event): void;
     selectSegment(port: ConnectionEditorPort, event: MouseEvent): void;
     selectWidget(node: ConnectionsViewerNode): void;
     selectLink(edge: ConnectionsViewerEdge): void;
-    selectConnection(connection: ConnectionEditorConnection): void;
+    inspectPortConnection(connection: ConnectionEditorConnection, event: Event): void;
+    protected toggleInspector(event: Event): void;
+    private rememberInspectorPortContext;
+    closeInspector(): void;
+    selectConnection(connection: ConnectionEditorConnection, event?: Event): void;
+    private focusInspectorAfterRender;
     jumpToConnection(connection: ConnectionEditorConnection, event: Event): void;
     previewConnection(connection: ConnectionEditorConnection): void;
     clearPreviewConnection(connection: ConnectionEditorConnection): void;
@@ -679,6 +785,7 @@ declare class ConnectionEditorComponent {
     setDockTab(tab: ConnectionEditorDockTab): void;
     handleDockTabKeydown(event: KeyboardEvent, tab: ConnectionEditorDockTab): void;
     toggleDock(): void;
+    followConnectionPath(connection: ConnectionEditorConnection, event: Event): void;
     toggleTrace(event: Event): void;
     selectTraceSource(nodeId: string | null, event: Event): void;
     moveTraceStep(delta: -1 | 1, event: Event): void;
@@ -725,6 +832,8 @@ declare class ConnectionEditorComponent {
     enableTransform(connection: ConnectionEditorConnection, event: Event): void;
     addTransformStep(connection: ConnectionEditorConnection, kind: TransformKind, event: Event): void;
     removeTransformStep(connection: ConnectionEditorConnection, index: number, event: Event): void;
+    formatStepOption(step: TransformPipeline['steps'][number], key: string): string;
+    updateFormatStep(connection: ConnectionEditorConnection, index: number, key: string, value: string): void;
     clearTransform(connection: ConnectionEditorConnection, event: Event): void;
     applyConditionPreset(connection: ConnectionEditorConnection, preset: ConnectionEditorConditionPreset, event: Event): void;
     clearCondition(connection: ConnectionEditorConnection, event: Event): void;
@@ -739,6 +848,9 @@ declare class ConnectionEditorComponent {
     nestedPortPathText(port: ConnectionEditorPort): string;
     portDescription(port: ConnectionEditorPort): string;
     segmentKindGlyph(kind: ConnectionEditorPortKind): string;
+    nodeHue(id: string): number;
+    compactConnections(nodeId: string): ConnectionEditorConnection[];
+    connectionsForPort(port: ConnectionEditorPort): ConnectionEditorConnection[];
     nodeIcon(node: ConnectionEditorNode): string;
     dockTabLabel(tab: ConnectionEditorDockTabDefinition): string;
     dockTabId(tab: ConnectionEditorDockTab): string;
@@ -758,6 +870,15 @@ declare class ConnectionEditorComponent {
     isModeDimmedPort(port: ConnectionEditorPort): boolean;
     isGuidedQuietNode(node: ConnectionEditorNode): boolean;
     areNodePortsVisible(node: ConnectionEditorNode): boolean;
+    closePortDetails(): void;
+    private focusInvoker;
+    private restoreInspectionFocus;
+    private isRestorableInspectionTarget;
+    beginConnectionFromPort(port: ConnectionEditorPort, event: Event): void;
+    wireTerminalPath(connection: ConnectionEditorConnection): string;
+    portPanelWidth(): number;
+    portPanelHeight(): number;
+    portPanelPosition(node: ConnectionEditorNode): ConnectionEditorPoint;
     isGuidedPortVisible(port: ConnectionEditorPort): boolean;
     isGuidedSegmentLabelVisible(port: ConnectionEditorPort): boolean;
     clearHoveredNode(nodeId: string): void;
@@ -784,7 +905,13 @@ declare class ConnectionEditorComponent {
     connectionCreatedFeedback(connection: ConnectionEditorConnection): string;
     portAriaLabel(node: ConnectionEditorNode, port: ConnectionEditorPort, role: 'input' | 'output' | 'state'): string;
     transformKindText(kind: TransformKind): string;
-    private readableEndpointLabel;
+    businessPortLabel(port: ConnectionEditorPort): string;
+    authoredStateName(port: ConnectionEditorPort): string;
+    stateNamingPorts(connection: ConnectionEditorConnection): ConnectionEditorPort[];
+    applyStateName(port: ConnectionEditorPort, name: string): void;
+    businessPortDescription(port: ConnectionEditorPort | null | undefined): string;
+    private editorialPort;
+    readableEndpointLabel(connection: ConnectionEditorConnection, side: 'from' | 'to'): string;
     private isSelectionToDetailConnection;
     private isSuggestedMasterDetail;
     private isCanonicalSelectionToDetailConnection;
@@ -809,6 +936,7 @@ declare class ConnectionEditorComponent {
     } | null;
     wireLabelTransform(connection: ConnectionEditorConnection, endpoint: 'source' | 'target'): string;
     minimapWirePath(connection: ConnectionEditorConnection): string;
+    connectionTooltipWidth(): number;
     connectionTooltipPosition(connection: ConnectionEditorConnection): ConnectionEditorTooltipPosition;
     connectionTooltipCalloutX(connection: ConnectionEditorConnection): number;
     connectionTooltipKind(connection: ConnectionEditorConnection): string;
@@ -840,6 +968,7 @@ declare class ConnectionEditorComponent {
     cancelDraft(): void;
     private clearDraft;
     closeEditor(): void;
+    nodeCaptionHeight(): number;
     nodeCaptionWidth(): number;
     togglePresentation(): void;
     tx(key: string, fallback: string): string;
@@ -888,6 +1017,7 @@ declare class ConnectionEditorComponent {
     private fitViewportState;
     private clampViewport;
     private connectionEditorNavigationBounds;
+    private needsCompactStage;
     private stageClientSize;
     private stageRect;
     private shouldIgnorePanTarget;
@@ -953,6 +1083,7 @@ type DeviceVariantForm = FormGroup<{
     columns: FormControl<number | null>;
     rowUnit: FormControl<string>;
     gap: FormControl<string>;
+    paddingInline: FormControl<string>;
     autoRows: FormControl<'fixed' | 'content' | ''>;
     groupingOverrides: FormControl<string>;
     widgetOverrides: FormControl<string>;
@@ -988,14 +1119,12 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     pageChange: EventEmitter<WidgetPageDefinition>;
     readonly layoutPresetEntries: LayoutPresetEntry[];
     readonly themePresetEntries: ThemePresetEntry[];
-    readonly shellPresetEntries: {
-        id: string;
-        label: string;
-    }[];
+    readonly shellPresetEntries: readonly WidgetShellPresetDefinition[];
     readonly deviceKeys: DeviceKey[];
     readonly deviceLabels: Record<DeviceKey, string>;
     readonly canvasColumnsControl: FormControl<number>;
     readonly canvasRowUnitControl: FormControl<string>;
+    readonly paddingInlineControl: FormControl<string>;
     readonly canvasGapControl: FormControl<string>;
     readonly canvasAutoRowsControl: FormControl<"content" | "fixed">;
     readonly layoutPresetControl: FormControl<string>;
@@ -1063,6 +1192,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     inheritedThemeHelp(theme: ThemePresetEntry): string;
     groupLabel(index: number): string;
     tx(key: string, fallback: string): string;
+    shellPresetLabel(preset: WidgetShellPresetDefinition): string;
     limitsTargetLabel(index: number): string;
     limitFieldError(control: FormControl<number | null>): string;
     private draftFingerprint;
@@ -1189,6 +1319,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         rowHeight: FormControl<number | null>;
         gap: FormControl<number | null>;
     }>;
+    readonly paddingInlineControl: FormControl<string>;
     readonly contextControl: FormControl<string>;
     readonly shellPresetControl: FormControl<string>;
     readonly layoutPresetControl: FormControl<string>;
@@ -1203,6 +1334,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         orientation: FormControl<string>;
         columns: FormControl<number | null>;
         gap: FormControl<string>;
+        paddingInline: FormControl<string>;
         breakpointsJson: FormControl<string>;
         groupingOverridesJson: FormControl<string>;
         widgetOverridesJson: FormControl<string>;
@@ -1211,6 +1343,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         orientation: FormControl<string>;
         columns: FormControl<number | null>;
         gap: FormControl<string>;
+        paddingInline: FormControl<string>;
         breakpointsJson: FormControl<string>;
         groupingOverridesJson: FormControl<string>;
         widgetOverridesJson: FormControl<string>;
@@ -1219,6 +1352,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         orientation: FormControl<string>;
         columns: FormControl<number | null>;
         gap: FormControl<string>;
+        paddingInline: FormControl<string>;
         breakpointsJson: FormControl<string>;
         groupingOverridesJson: FormControl<string>;
         widgetOverridesJson: FormControl<string>;
@@ -1227,10 +1361,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     readonly layoutError: _angular_core.WritableSignal<string | null>;
     readonly stateError: _angular_core.WritableSignal<string | null>;
     readonly activeTab: _angular_core.WritableSignal<EditorTabId>;
-    readonly shellPresetEntries: Array<{
-        id: string;
-        label: string;
-    }>;
+    readonly shellPresetEntries: readonly WidgetShellPresetDefinition[];
     private lastContext;
     private lastGrouping;
     private lastDeviceLayouts;
@@ -1268,6 +1399,7 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     protected get transformerOptionsHint(): string;
     constructor();
     protected tx(key: string, fallback: string): string;
+    shellPresetLabel(preset: WidgetShellPresetDefinition | undefined): string;
     addSchemaNode(seed?: {
         path?: string;
         config?: WidgetStateNode;
@@ -1991,7 +2123,13 @@ declare function preflightUiCompositionPlanResources(plan: UiCompositionPlan, re
 declare class UiCompositionResourcePreflightService {
     private readonly registry;
     private readonly discovery;
+    private readonly pageSchemas;
     preflight(plan: UiCompositionPlan, registry?: ComponentMetadataRegistry): Promise<UiCompositionPlanPreflightResult>;
+    /** Revalidates an authored page without reconstructing or trusting its original plan. */
+    preflightPage(page: WidgetPageDefinition, registry?: ComponentMetadataRegistry, options?: {
+        refreshSchemas?: boolean;
+    }): Promise<UiCompositionPlanPreflightResult>;
+    private resolvePageSchema;
     private resolveSchema;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiCompositionResourcePreflightService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<UiCompositionResourcePreflightService>;