@praxisui/page-builder 9.0.65 → 9.0.67

package/package.json

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

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

@@ -1,7 +1,8 @@
 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 { ComponentDocMeta, ComponentMetadataRegistry, PraxisI18nService, WidgetShellConfig, WidgetPageAuthoringCapabilities, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, 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 * 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 * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
@@ -162,6 +163,10 @@ type SetInputPreset = {
 };
 declare class WidgetShellEditorComponent implements SettingsValueProvider {
     private registry?;
+    private readonly i18n;
+    menuPlacementLabel(): string;
+    appearanceError(): string;
+    stickyHeaderLabel(): string;
     form: FormGroup<{
         kind: FormControl<"none" | "dashboard-card">;
         preset: FormControl<string>;
@@ -170,6 +175,7 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
         subtitle: FormControl<string>;
         icon: FormControl<string>;
         showHeader: FormControl<"auto" | "true" | "false">;
+        stickyHeader: FormControl<boolean>;
         collapsible: FormControl<boolean>;
         cardBg: FormControl<string>;
         cardBorder: FormControl<string>;
@@ -277,6 +283,8 @@ interface ConnectionEditorPort {
     label: string;
     kind: ConnectionEditorPortKind;
     endpoint: EndpointRef;
+    /** Transient registry evidence; never serialized into a composition endpoint. */
+    contract?: PortContract;
     nestedPath?: ComponentPortPathSegment[];
 }
 interface ConnectionEditorNode {
@@ -481,6 +489,24 @@ declare class ConnectionEditorComponent {
     readonly focusWidget: _angular_core.OutputEmitterRef<string>;
     readonly openPageSettings: _angular_core.OutputEmitterRef<void>;
     readonly close: _angular_core.OutputEmitterRef<void>;
+    private readonly componentRegistry;
+    private readonly compositionValidator;
+    readonly draftBase: _angular_core.WritableSignal<WidgetPageDefinition | null>;
+    readonly draftPage: _angular_core.WritableSignal<WidgetPageDefinition | null>;
+    readonly workingPage: _angular_core.Signal<WidgetPageDefinition | null | undefined>;
+    readonly draftSourceId: _angular_core.WritableSignal<string>;
+    readonly draftTargetId: _angular_core.WritableSignal<string>;
+    readonly draftLinkId: _angular_core.WritableSignal<string | null>;
+    readonly draftIsNew: _angular_core.WritableSignal<boolean>;
+    private draftSelectionBefore;
+    readonly presentationMode: _angular_core.WritableSignal<boolean>;
+    readonly draftConflict: _angular_core.Signal<boolean>;
+    readonly draftPorts: _angular_core.Signal<ConnectionEditorPort[]>;
+    readonly draftSources: _angular_core.Signal<ConnectionEditorPort[]>;
+    readonly draftTargets: _angular_core.Signal<ConnectionEditorPort[]>;
+    readonly draftDiagnostics: _angular_core.Signal<_praxisui_core.DiagnosticRecord[]>;
+    readonly draftDuplicate: _angular_core.Signal<boolean>;
+    readonly canApplyDraft: _angular_core.Signal<boolean>;
     readonly activeMode: _angular_core.WritableSignal<ConnectionEditorFlowMode>;
     readonly activeFilter: _angular_core.WritableSignal<ConnectionsEditorFilter>;
     readonly selectedWidgetId: _angular_core.WritableSignal<string | null>;
@@ -793,6 +819,7 @@ declare class ConnectionEditorComponent {
     describeEdge(edge: ConnectionsViewerEdge): string;
     edgeHasDiagnostics(edge: ConnectionsViewerEdge): boolean;
     edgeDiagnostics(edge: ConnectionsViewerEdge): unknown[];
+    edgeRouteTitle(edge: ConnectionsViewerEdge): string;
     describeSource(edge: ConnectionsViewerEdge): string;
     describeTarget(edge: ConnectionsViewerEdge): string;
     globalActionPayloadText(connection: ConnectionEditorConnection): string;
@@ -801,6 +828,20 @@ declare class ConnectionEditorComponent {
     surfaceOpenHostKind(connection: ConnectionEditorConnection): string;
     applySurfaceOpenPayload(connection: ConnectionEditorConnection, payload: SurfaceOpenPayload): void;
     applyGlobalActionPayload(connection: ConnectionEditorConnection, payloadText: string, event: Event): void;
+    beginNewConnection(): void;
+    beginEditConnection(linkId: string): void;
+    changeDraftEndpoint(side: 'source' | 'target', id: string): void;
+    projectDraftValue(): void;
+    setDraftMissingValue(missingValuePolicy: 'skip' | 'use-default'): void;
+    changeDraftPickPath(index: number, path: string): void;
+    draftPortLabel(port: ConnectionEditorPort): string;
+    draftEndpointLabel(id: string): string;
+    applyDraft(): void;
+    cancelDraft(): void;
+    private clearDraft;
+    closeEditor(): void;
+    nodeCaptionWidth(): number;
+    togglePresentation(): void;
     tx(key: string, fallback: string): string;
     private availableGlobalActions;
     private availableGlobalActionIds;
@@ -857,7 +898,46 @@ declare class ConnectionEditorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConnectionEditorComponent, "praxis-connection-editor", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "focusWidget": "focusWidget"; "openPageSettings": "openPageSettings"; "close": "close"; }, never, never, true, never>;
 }
 
-type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state';
+declare const LIMIT_KEYS: readonly ["minColSpan", "maxColSpan", "minRowSpan", "maxRowSpan", "minHeightPx", "maxHeightPx"];
+type LimitKey = typeof LIMIT_KEYS[number];
+type LimitValues = Record<LimitKey, number | null>;
+type HeightValues = {
+    heightMode: 'inherit' | 'auto' | 'fixed';
+    heightPx: number | null;
+    offsetTopPx: number | null;
+};
+type LimitForm = FormGroup<{
+    [K in LimitKey]: FormControl<number | null>;
+} & {
+    [K in keyof HeightValues]: FormControl<HeightValues[K]>;
+}>;
+type LimitScope = 'base' | WidgetPageDeviceKind;
+interface LimitTarget {
+    key: string;
+    title: string;
+    scope: LimitScope;
+    seed: LimitValues & HeightValues;
+}
+type LimitIssue = {
+    index: number;
+    code: 'integer' | 'range' | 'columns' | 'size' | 'height';
+};
+/** Editor projection of Core canvas constraints; never a second persisted document. */
+declare class CanvasConstraintEditorModel {
+    readonly form: FormArray<LimitForm>;
+    targets: LimitTarget[];
+    private baseline;
+    hydrate(page: WidgetPageDefinition): void;
+    /** Mutates only the caller's cloned draft, preserving unknown fields and untouched overrides. */
+    apply(page: WidgetPageDefinition): LimitIssue | null;
+    private fail;
+    displayedSize(index: number, columns: number): {
+        width: number;
+        height: number;
+    };
+}
+
+type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state' | 'limits';
 type DeviceKey = 'desktop' | 'tablet' | 'mobile';
 type GroupingNodeGroup$1 = FormGroup<{
     kind: FormControl<string>;
@@ -934,11 +1014,22 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly contextError: WritableSignal<string | null>;
     readonly stateError: WritableSignal<string | null>;
     readonly deviceError: WritableSignal<string | null>;
+    readonly canvasLimits: CanvasConstraintEditorModel;
+    readonly limitsTargetControl: FormControl<number>;
+    readonly limitsError: WritableSignal<string | null>;
+    readonly limitsErrorMatcher: {
+        isErrorState: (control: FormControl | null) => boolean;
+    };
     private readonly injectedData;
+    readonly isHostedInSettingsPanel: boolean;
     private readonly i18n;
     private pageInput;
     private snapshot;
+    readonly stackedDevices: Set<DeviceKey>;
+    readonly activeDevice: WritableSignal<DeviceKey>;
     private hydrating;
+    private renderedCandidate;
+    private renderedValidationFingerprint;
     private readonly tabOrder;
     constructor();
     ngOnInit(): void;
@@ -947,6 +1038,8 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get hasPendingChanges(): boolean;
     get validationStateLabel(): string;
     get dirtyStateLabel(): string;
+    get nonLimitError(): string | null;
+    get limitsSummaryError(): string | null;
     get selectedLayoutPresetLabel(): string;
     get selectedThemePresetLabel(): string;
     get selectedLayoutPresetEntry(): LayoutPresetEntry | null;
@@ -958,6 +1051,9 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     onSave(): WidgetPageDefinition | null;
     reset(): void;
     pinRecommendedThemePreset(): void;
+    get hasCanvasWidgets(): boolean;
+    stackDevice(device: DeviceKey): void;
+    private stackedCanvas;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
     layoutPresetSummary(preset: LayoutPresetEntry): string;
@@ -967,12 +1063,22 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     inheritedThemeHelp(theme: ThemePresetEntry): string;
     groupLabel(index: number): string;
     tx(key: string, fallback: string): string;
+    limitsTargetLabel(index: number): string;
+    limitFieldError(control: FormControl<number | null>): string;
+    private draftFingerprint;
+    limitsGeometryLabel(): string;
+    limitsUseContentHeight(): boolean;
+    private applyCanvasLimits;
+    private readRenderedIssue;
+    protected refreshRenderedValidation(): void;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
     private hydrate;
     private replaceGroupingNodes;
     private buildCurrentPage;
     private buildGrouping;
+    /** A grid must place every existing widget before replacing the flow layout. */
+    private completeCanvasItems;
     private buildDeviceLayouts;
     private invalidate;
     private refreshPanelState;