@praxisui/page-builder 3.0.0-beta.6 → 3.0.0-beta.8

package/index.d.ts

@@ -1,14 +1,13 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as i0 from '@angular/core';
-import { EventEmitter, OnInit, OnChanges, SimpleChanges, InjectionToken, Provider, ElementRef } from '@angular/core';
-import { ComponentDocMeta, ComponentMetadataRegistry, GridPageDefinition, GridWidgetInstance, WidgetConnection, WidgetShellConfig, WidgetShellAction, WidgetPageOrientation, WidgetPageDefinition, WidgetPageLayout, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, WidgetPageStateInput, PageIdentity, ConnectionManagerService, AsyncConfigStorage, ComponentKeyService, SettingsPanelBridge, WidgetShellActionEvent } from '@praxisui/core';
+import { EventEmitter, OnInit, OnChanges, SimpleChanges, WritableSignal, InjectionToken, Provider, Type } from '@angular/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, CompositionLink, DiagnosticRecord, SettingsValueProvider, WidgetPageDefinition, WidgetInstance, WidgetConnection, WidgetShellConfig, WidgetShellAction, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, WidgetPageStateInput, DynamicWidgetPageComponent, SettingsPanelBridge } from '@praxisui/core';
 export { WidgetShellComponent } from '@praxisui/core';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import * as rxjs from 'rxjs';
+import { BehaviorSubject } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
-import { SettingsValueProvider } from '@praxisui/settings-panel';
-import { GridsterConfig, GridsterItem } from 'angular-gridster2';
-import { Router, ActivatedRoute } from '@angular/router';
+import { SettingsValueProvider as SettingsValueProvider$1 } from '@praxisui/settings-panel';
 
 declare const PLACEHOLDER = 1;
 
@@ -79,13 +78,26 @@ declare class ComponentPaletteDialogComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<ComponentPaletteDialogComponent, "praxis-component-palette-dialog", never, {}, {}, never, never, true, never>;
 }
 
-declare class ConnectionBuilderComponent implements OnInit, OnChanges {
+type AuthoringCanonicalLinkDiagnostic = Pick<DiagnosticRecord, 'code' | 'severity' | 'message'>;
+type AuthoringCanonicalLinkReadModel = CompositionLink & {
+    /** Convenience alias for authoring surfaces while the template still reads `source` directly. */
+    source: 'legacy-widget-connection' | 'native-composition-link';
+    diagnostics: AuthoringCanonicalLinkDiagnostic[];
+};
+
+type EndpointOption = {
+    value: string;
+    label: string;
+    kind: 'primary' | 'derived';
+    description?: string;
+};
+declare class ConnectionBuilderComponent implements OnInit, OnChanges, SettingsValueProvider {
     private dialog;
     private registry;
     private snack;
-    page?: GridPageDefinition | string;
-    widgets?: GridWidgetInstance[];
-    pageChange: EventEmitter<GridPageDefinition>;
+    page?: WidgetPageDefinition | string;
+    widgets?: WidgetInstance[];
+    pageChange: EventEmitter<WidgetPageDefinition>;
     private originalSnapshot;
     showOnlyIssues: boolean;
     showFriendly: boolean;
@@ -94,7 +106,11 @@ declare class ConnectionBuilderComponent implements OnInit, OnChanges {
     sortBy: 'from' | 'to';
     mapPlaceholder: string;
     connections: i0.WritableSignal<WidgetConnection[]>;
-    selectedIndex: i0.WritableSignal<number>;
+    private readonly selectedConnectionRef;
+    stateOptions: i0.WritableSignal<EndpointOption[]>;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
     readonly filteredConnections: i0.Signal<WidgetConnection[]>;
     readonly groupedConnections: i0.Signal<{
         label: string;
@@ -103,8 +119,10 @@ declare class ConnectionBuilderComponent implements OnInit, OnChanges {
     constructor(dialog: MatDialog, registry: ComponentMetadataRegistry, snack: MatSnackBar);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
-    isExpanded(i: number): boolean;
-    toggleExpanded(i: number, ev?: Event): void;
+    isExpanded(connection: WidgetConnection): boolean;
+    isSelected(connection: WidgetConnection): boolean;
+    toggleExpanded(connection: WidgetConnection, ev?: Event): void;
+    selectedIndex(): number;
     setSortBy(v: 'from' | 'to'): void;
     onGroupByChange(): void;
     toggleShowOnlyIssues(): void;
@@ -127,6 +145,16 @@ declare class ConnectionBuilderComponent implements OnInit, OnChanges {
     componentIconForKey(key: string): string;
     private widgetTypeByKey;
     selectedConnection(): WidgetConnection | undefined;
+    selectedCanonicalLink(): AuthoringCanonicalLinkReadModel | undefined;
+    canonicalLinkForConnection(connection: WidgetConnection): AuthoringCanonicalLinkReadModel;
+    persistedSummary(connection: WidgetConnection): string;
+    canonicalSummary(canonicalLink: AuthoringCanonicalLinkReadModel): string;
+    canonicalDiagnosticsSummary(canonicalLink: AuthoringCanonicalLinkReadModel): string;
+    observedTargetPreview(connection: WidgetConnection): string;
+    selectedSourceKind(): 'widget' | 'state';
+    setSelectedSourceKind(kind: 'widget' | 'state'): void;
+    selectedTargetKind(): 'widget' | 'state';
+    setSelectedTargetKind(kind: 'widget' | 'state'): void;
     selectedSourcePrimaryValue(): string;
     setSelectedSourcePrimaryValue(value: string): void;
     selectedSourceSecondaryValue(): string;
@@ -139,20 +167,57 @@ declare class ConnectionBuilderComponent implements OnInit, OnChanges {
     setSelectedMapValue(value: string): void;
     showSelectedSourceSecondary(): boolean;
     showSelectedTargetSecondary(): boolean;
+    availableOutputsForSelectedWidget(): string[];
+    availableInputsForSelectedWidget(): string[];
+    availableStateOptions(): EndpointOption[];
+    stateOptionLabel(path: string): string;
+    stateOptionIcon(path: string): string;
+    widgetOptions(): Array<{
+        key: string;
+        label: string;
+    }>;
     private applyFilters;
     private applyGrouping;
     private groupByKey;
     private sortList;
     createNew(): void;
-    startEdit(index: number, _c: WidgetConnection): void;
-    startEditByConn(c: WidgetConnection): void;
-    duplicateConnection(index: number): void;
-    removeConnection(index: number): void;
+    startEdit(_index: number, connection: WidgetConnection): void;
+    startEditByConn(connection: WidgetConnection): void;
+    duplicateConnection(connection: WidgetConnection): void;
+    removeConnection(connection: WidgetConnection): void;
     connectionStatus(c: WidgetConnection): 'ok' | 'warn' | 'err';
-    onSave(): void;
-    openDiagramFor(_c: WidgetConnection): void;
+    getSettingsValue(): WidgetPageDefinition;
+    reset(): void;
+    onSave(): WidgetPageDefinition;
+    openDiagramFor(_connection: WidgetConnection): void;
     openDiagramFullscreen(): void;
     private parsePage;
+    private availableOutputsForWidget;
+    private availableInputsForWidget;
+    private metadataPortDescription;
+    private metadataPortsForWidget;
+    private metadataPortForWidget;
+    private metadataPorts;
+    private widgetMetadataForKey;
+    private widgetInputLabelForKey;
+    private observedInputDescriptionForWidget;
+    private widgetInputOptionsForKey;
+    private observedInputOptionsForWidget;
+    private collectObservedInputPaths;
+    private describeObservedInput;
+    private previewValue;
+    private widgetByKey;
+    private refreshStateOptions;
+    private collectStateOptions;
+    private normalizeState;
+    private collectPaths;
+    private buildPageWithConnections;
+    private replaceConnections;
+    private commitConnections;
+    private syncSelection;
+    private refreshPanelState;
+    private refreshValidity;
+    private clone;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConnectionBuilderComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ConnectionBuilderComponent, "praxis-connection-builder", never, { "page": { "alias": "page"; "required": false; }; "widgets": { "alias": "widgets"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
@@ -191,7 +256,7 @@ type SetInputPreset = {
     icon?: string;
     values: SetInputValueOption[];
 };
-declare class WidgetShellEditorComponent implements SettingsValueProvider {
+declare class WidgetShellEditorComponent implements SettingsValueProvider$1 {
     private registry?;
     form: FormGroup<{
         kind: FormControl<"none" | "dashboard-card">;
@@ -289,64 +354,318 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     static ɵcmp: i0.ɵɵComponentDeclaration<WidgetShellEditorComponent, "praxis-widget-shell-editor", never, {}, {}, never, never, true, never>;
 }
 
-type DynamicPageEditorInputs = {
-    page?: WidgetPageDefinition | null;
-    layout?: WidgetPageLayout | null;
-    presets?: Record<string, WidgetShellConfig['appearance']> | null;
+type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state';
+type DeviceKey = 'desktop' | 'tablet' | 'mobile';
+type GroupingNodeGroup$1 = FormGroup<{
+    kind: FormControl<string>;
+    id: FormControl<string>;
+    label: FormControl<string>;
+    widgetKeysCsv: FormControl<string>;
+    layout: FormControl<string>;
+    emphasis: FormControl<string>;
+    side: FormControl<string>;
+    tabsJson: FormControl<string>;
+}>;
+type DeviceVariantForm = FormGroup<{
+    columns: FormControl<number | null>;
+    rowUnit: FormControl<string>;
+    gap: FormControl<string>;
+    autoRows: FormControl<'fixed' | 'content' | ''>;
+    groupingOverrides: FormControl<string>;
+    widgetOverrides: FormControl<string>;
+}>;
+declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueProvider {
+    set page(value: WidgetPageDefinition | string | null | undefined);
+    layout?: unknown;
+    presets?: unknown;
     pagePreset?: string | null;
+    pageChange: EventEmitter<WidgetPageDefinition>;
+    readonly layoutPresetEntries: {
+        id: string;
+        label: string;
+    }[];
+    readonly themePresetEntries: {
+        id: string;
+        label: string;
+    }[];
+    readonly shellPresetEntries: {
+        id: string;
+        label: string;
+    }[];
+    readonly deviceKeys: DeviceKey[];
+    readonly deviceLabels: Record<DeviceKey, string>;
+    readonly canvasColumnsControl: FormControl<number>;
+    readonly canvasRowUnitControl: FormControl<string>;
+    readonly canvasGapControl: FormControl<string>;
+    readonly canvasAutoRowsControl: FormControl<"fixed" | "content">;
+    readonly layoutPresetControl: FormControl<string>;
+    readonly themePresetControl: FormControl<string>;
+    readonly shellPresetControl: FormControl<string>;
+    readonly contextControl: FormControl<string>;
+    readonly stateControl: FormControl<string>;
+    readonly groupingNodes: FormArray<GroupingNodeGroup$1>;
+    readonly deviceForms: Record<DeviceKey, DeviceVariantForm>;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    readonly activeTab: WritableSignal<EditorTabId$1>;
+    readonly canvasError: WritableSignal<string | null>;
+    readonly groupingError: WritableSignal<string | null>;
+    readonly contextError: WritableSignal<string | null>;
+    readonly stateError: WritableSignal<string | null>;
+    readonly deviceError: WritableSignal<string | null>;
+    private readonly injectedData;
+    private pageInput;
+    private snapshot;
+    private hydrating;
+    private readonly tabOrder;
+    constructor();
+    ngOnInit(): void;
+    get selectedTabIndex(): number;
+    get isConfigurationValid(): boolean;
+    get hasPendingChanges(): boolean;
+    get validationStateLabel(): string;
+    get dirtyStateLabel(): string;
+    get selectedLayoutPresetLabel(): string;
+    get selectedThemePresetLabel(): string;
+    get canvasSummaryLabel(): string;
+    onSelectedTabIndexChange(index: number): void;
+    getSettingsValue(): WidgetPageDefinition | null;
+    onSave(): WidgetPageDefinition | null;
+    reset(): void;
+    addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
+    removeGroupingNode(index: number): void;
+    private createDeviceVariantForm;
+    private createGroupingNodeGroup;
+    private hydrate;
+    private replaceGroupingNodes;
+    private buildCurrentPage;
+    private buildGrouping;
+    private buildDeviceLayouts;
+    private invalidate;
+    private refreshPanelState;
+    private currentPageInput;
+    private parsePage;
+    private parseJson;
+    private parseRecordJson;
+    private parseGroupingTabs;
+    private parseGroupingOverrides;
+    private parseWidgetOverrides;
+    private isGroupingTab;
+    private isGroupingOverride;
+    private isWidgetOverride;
+    private isPlainObject;
+    private hasDuplicateIds;
+    private hasDuplicateStrings;
+    private stringify;
+    private stringifyGroupingWidgetKeys;
+    private extractShellPreset;
+    private removeShellPresetFromContext;
+    private applyShellPresetToContext;
+    private lookupPresetLabel;
+    private defaultCanvas;
+    private clone;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, { "page": { "alias": "page"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "pagePreset": { "alias": "pagePreset"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+}
+
+type LegacyGridOptions = {
+    cols?: number;
+    rowHeight?: number;
+    gap?: number;
 };
-type DynamicPageEditorResult = {
-    layout: WidgetPageLayout | null;
-    pagePreset: string;
-    fullPage?: WidgetPageDefinition;
+type PageDefinition = WidgetPageDefinition & {
+    options?: LegacyGridOptions;
 };
-declare class DynamicPageConfigEditorComponent implements SettingsValueProvider {
-    form: FormGroup<{
-        pagePreset: FormControl<string>;
-        orientation: FormControl<WidgetPageOrientation>;
-        columns: FormControl<number>;
+type EditorTabId = 'layout' | 'grouping' | 'devices' | 'state' | 'context';
+type SchemaNodeGroup = FormGroup<{
+    path: FormControl<string>;
+    type: FormControl<string>;
+    initialMode: FormControl<string>;
+    initialJson: FormControl<string>;
+    initialScalar: FormControl<string>;
+    persist: FormControl<string>;
+    mergeStrategy: FormControl<string>;
+    description: FormControl<string>;
+}>;
+type DerivedNodeGroup = FormGroup<{
+    path: FormControl<string>;
+    dependsOn: FormControl<string>;
+    computeKind: FormControl<string>;
+    operator: FormControl<string>;
+    sourcePath: FormControl<string>;
+    keysCsv: FormControl<string>;
+    expression: FormControl<string>;
+    transformerId: FormControl<string>;
+    options: FormControl<string>;
+    templateMode: FormControl<string>;
+    templateJson: FormControl<string>;
+    templateScalar: FormControl<string>;
+    description: FormControl<string>;
+}>;
+type GroupingNodeGroup = FormGroup<{
+    kind: FormControl<string>;
+    id: FormControl<string>;
+    label: FormControl<string>;
+    widgetKeysCsv: FormControl<string>;
+    layout: FormControl<string>;
+    emphasis: FormControl<string>;
+    side: FormControl<string>;
+    tabsJson: FormControl<string>;
+}>;
+declare class PageConfigEditorComponent implements SettingsValueProvider {
+    protected readonly derivedOperators: readonly ["merge-objects", "pick", "omit"];
+    protected readonly mergeStrategies: readonly ["replace", "merge", "append", "remove-keys"];
+    protected readonly valueModes: readonly ["json", "string", "number", "boolean", "null"];
+    protected readonly groupingKinds: readonly ["section", "tabs", "hero", "rail"];
+    protected readonly layoutPresetEntries: Array<(typeof BUILTIN_PAGE_LAYOUT_PRESETS)[string]>;
+    protected readonly themePresetEntries: Array<(typeof BUILTIN_PAGE_THEME_PRESETS)[string]>;
+    readonly page: i0.InputSignal<string | PageDefinition | null>;
+    readonly identity: i0.InputSignal<PageIdentity | null>;
+    readonly layoutCompatOptions: i0.InputSignal<any>;
+    readonly pageChange: i0.OutputEmitterRef<PageDefinition>;
+    readonly form: FormGroup<{
+        cols: FormControl<number | null>;
+        rowHeight: FormControl<number | null>;
+        gap: FormControl<number | null>;
+    }>;
+    readonly contextControl: FormControl<string>;
+    readonly shellPresetControl: FormControl<string>;
+    readonly layoutPresetControl: FormControl<string>;
+    readonly themePresetControl: FormControl<string>;
+    readonly groupingControl: FormControl<string>;
+    readonly deviceLayoutsControl: FormControl<string>;
+    readonly stateValuesControl: FormControl<string>;
+    readonly groupingNodes: FormArray<GroupingNodeGroup>;
+    readonly schemaNodes: FormArray<SchemaNodeGroup>;
+    readonly derivedNodes: FormArray<DerivedNodeGroup>;
+    readonly deviceDesktopForm: FormGroup<{
+        orientation: FormControl<string>;
+        columns: FormControl<number | null>;
+        gap: FormControl<string>;
+        breakpointsJson: FormControl<string>;
+        groupingOverridesJson: FormControl<string>;
+        widgetOverridesJson: FormControl<string>;
+    }>;
+    readonly deviceTabletForm: FormGroup<{
+        orientation: FormControl<string>;
+        columns: FormControl<number | null>;
         gap: FormControl<string>;
-        bpSm: FormControl<number>;
-        bpMd: FormControl<number>;
-        bpLg: FormControl<number>;
-        bpXl: FormControl<number>;
+        breakpointsJson: FormControl<string>;
+        groupingOverridesJson: FormControl<string>;
+        widgetOverridesJson: FormControl<string>;
+    }>;
+    readonly deviceMobileForm: FormGroup<{
+        orientation: FormControl<string>;
+        columns: FormControl<number | null>;
+        gap: FormControl<string>;
+        breakpointsJson: FormControl<string>;
+        groupingOverridesJson: FormControl<string>;
+        widgetOverridesJson: FormControl<string>;
+    }>;
+    readonly contextError: i0.WritableSignal<string | null>;
+    readonly layoutError: i0.WritableSignal<string | null>;
+    readonly stateError: i0.WritableSignal<string | null>;
+    readonly activeTab: i0.WritableSignal<EditorTabId>;
+    readonly shellPresetEntries: Array<{
+        id: string;
+        label: string;
     }>;
-    jsonControl: FormControl<string>;
-    private readonly initialLayout;
+    private lastContext;
+    private lastGrouping;
+    private lastDeviceLayouts;
+    private lastStateValues;
     private readonly dirtySubject;
     private readonly validSubject;
     private readonly busySubject;
-    isDirty$: rxjs.Observable<boolean>;
-    isValid$: rxjs.Observable<boolean>;
-    isBusy$: rxjs.Observable<boolean>;
     private snapshot;
-    presetOptions: Array<{
-        id: string;
-        label: string;
-    }>;
-    private pagePreset;
-    private currentFullConfig;
-    private activeTab;
-    constructor(data?: DynamicPageEditorInputs | null);
-    onTabChange(index: number): void;
-    getSettingsValue(): DynamicPageEditorResult;
-    formatJson(): void;
-    onSave(): DynamicPageEditorResult;
+    private readonly tabOrder;
+    private readonly i18n;
+    private readonly injectedData;
+    readonly isDirty$: rxjs.Observable<boolean>;
+    readonly isValid$: rxjs.Observable<boolean>;
+    readonly isBusy$: rxjs.Observable<boolean>;
+    protected readonly embeddedInSettingsPanel: boolean;
+    get selectedTabIndex(): number;
+    protected get hasPendingChanges(): boolean;
+    protected get isConfigurationValid(): boolean;
+    protected get validationStateLabel(): string;
+    protected get dirtyStateLabel(): string;
+    protected get selectedLayoutPresetLabel(): string;
+    protected get selectedThemePresetLabel(): string;
+    protected get selectedShellPresetLabel(): string;
+    protected get contextExample(): string;
+    protected get stateValuesExample(): string;
+    protected get layoutPresetHint(): string;
+    protected get themePresetHint(): string;
+    protected get shellPresetHint(): string;
+    protected get tabsJsonHint(): string;
+    protected get breakpointsHint(): string;
+    protected get groupingOverridesHint(): string;
+    protected get widgetOverridesHint(): string;
+    protected get schemaInitialHint(): string;
+    protected get templateJsonHint(): string;
+    protected get transformerOptionsHint(): string;
+    constructor();
+    protected tx(key: string, fallback: string): string;
+    addSchemaNode(seed?: {
+        path?: string;
+        config?: WidgetStateNode;
+    }): void;
+    removeSchemaNode(index: number): void;
+    addDerivedNode(seed?: {
+        path?: string;
+        config?: WidgetDerivedStateNode;
+    }): void;
+    removeDerivedNode(index: number): void;
+    addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
+    removeGroupingNode(index: number): void;
+    setActiveTab(tab: EditorTabId): void;
+    onSelectedTabIndexChange(index: number): void;
+    apply(): void;
     reset(): void;
-    private updateValidity;
-    private updateStateFromForm;
-    private applyLayoutToForm;
-    private toggleGridControls;
-    private syncJsonFromState;
-    private extractPreset;
-    private snapshotValue;
-    private formatPresetLabel;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, [{ optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, {}, {}, never, never, true, never>;
+    private replaceGroupingNodes;
+    private createGroupingNodeGroup;
+    private stringifyGroupingWidgetKeys;
+    private buildGrouping;
+    private hydrateDeviceLayoutControls;
+    private buildDeviceLayouts;
+    private createDeviceLayoutForm;
+    private patchDeviceLayoutForm;
+    private buildDeviceLayoutVariant;
+    private hydrateStateEditor;
+    private replaceSchemaNodes;
+    private replaceDerivedNodes;
+    private createSchemaNodeGroup;
+    private createDerivedNodeGroup;
+    private buildState;
+    private buildSchema;
+    private buildDerived;
+    private normalizeState;
+    getSettingsValue(): PageDefinition | null;
+    onSave(): PageDefinition | null;
+    private lookupPresetLabel;
+    private currentPageInput;
+    private extractShellPreset;
+    private buildCurrentPage;
+    private applyShellPresetToContext;
+    private refreshPanelState;
+    private parsePage;
+    private parseContext;
+    private parseGrouping;
+    private parseDeviceLayouts;
+    private parseJson;
+    private parseValueInput;
+    private describeValue;
+    private buildOperatorOptions;
+    private buildOptions;
+    private clone;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageConfigEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PageConfigEditorComponent, "praxis-page-config-editor", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "identity": { "alias": "identity"; "required": false; "isSignal": true; }; "layoutCompatOptions": { "alias": "layoutCompatOptions"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
 /**
- * Capabilities catalog for Dynamic Gridster Page (GridPageDefinition + inputs).
+ * Capabilities catalog for the canonical dynamic page builder/runtime.
  */
 
 declare module '@praxisui/core' {
@@ -368,70 +687,42 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const PAGE_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
 
+type LegacyLayoutOptions = {
+    cols?: number;
+    rowHeight?: number;
+    gap?: number;
+};
+type PageBuilderLayoutOptions = Partial<LegacyLayoutOptions>;
 type PageBuilderConfig = {
     page?: BuilderPageDefinition;
     context?: Record<string, unknown> | null;
     enableCustomization?: boolean;
     showSettingsButton?: boolean;
     strictValidation?: boolean;
-    gridsterOptions?: Partial<GridsterConfig>;
+    layoutOptions?: PageBuilderLayoutOptions;
     pageIdentity?: PageIdentity;
 };
-interface PageBuilderHost {
-    page?: BuilderPageDefinition | string;
-    context?: Record<string, unknown> | null;
-    enableCustomization: boolean;
-    showSettingsButton: boolean;
-    strictValidation: boolean;
-    gridsterOptions?: Partial<GridsterConfig>;
-    pageIdentity?: PageIdentity;
-    applyConfigFromAdapter(config: PageBuilderConfig): void;
-}
-type BuilderPageDefinition = GridPageDefinition & {
+type BuilderWidgetInstance = WidgetInstance;
+type BuilderCanvasItem = {
+    col: number;
+    row: number;
+    colSpan: number;
+    rowSpan: number;
+};
+type BuilderCanvasLayout = {
+    mode: 'grid';
+    columns: number;
+    rowUnit?: string;
+    gap?: string;
+    autoRows?: 'fixed' | 'content';
+    items: Record<string, BuilderCanvasItem>;
+};
+type BuilderPageDefinition = Omit<WidgetPageDefinition, 'widgets'> & {
+    widgets: BuilderWidgetInstance[];
+    canvas?: BuilderCanvasLayout;
     state?: WidgetPageStateInput;
     connections?: WidgetConnection[];
 };
-type PatchResult = {
-    success: boolean;
-    warnings?: string[];
-    error?: string;
-};
-declare class PageBuilderAiAdapter {
-    private host;
-    private registry?;
-    componentName: string;
-    componentId: string;
-    componentType: string;
-    constructor(host: PageBuilderHost, registry?: ComponentMetadataRegistry | undefined);
-    getCurrentConfig(): PageBuilderConfig;
-    getCapabilities(): AiCapability[];
-    getRuntimeState(): Record<string, unknown>;
-    createSnapshot(): PageBuilderConfig;
-    restoreSnapshot(snapshot: PageBuilderConfig): Promise<void>;
-    applyPatch(patch: Partial<PageBuilderConfig>, _intent?: string): Promise<PatchResult>;
-    private applyConfig;
-    private parsePage;
-    private normalizePageForAi;
-    private normalizeConfigForRuntime;
-    private normalizePageForRuntime;
-    private normalizePatch;
-    private mergeWidgets;
-    private mergeConnections;
-    private ensureLayoutFromLegacy;
-    private ensureLegacyLayout;
-    private layoutFromLegacy;
-    private getWidgetKey;
-    private generateWidgetKey;
-    private connectionKey;
-    private gridsterFromPageOptions;
-    private mergeRuntimeGridsterOptions;
-    private pageOptionsFromGridster;
-    private pickGridsterOptions;
-    private buildComponentCatalog;
-    private pickNumber;
-    private coerceNumber;
-    private clone;
-}
 
 declare function registerWidgetAiCatalog(widgetId: string, catalog: AiCapabilityCatalog): void;
 declare function registerWidgetAiCatalogs(entries: Record<string, AiCapabilityCatalog>): void;
@@ -450,179 +741,40 @@ declare const PAGE_BUILDER_WIDGET_AI_CATALOGS: InjectionToken<Record<string, AiC
 
 declare function providePageBuilderWidgetAiCatalogs(): Provider;
 
-interface GraphNode {
-    id: string;
-    label: string;
-    icon?: string;
-    type: string;
-    parentId?: string | null;
-    collapsed?: boolean;
-    bounds: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    ports: GraphPort[];
-}
-interface GraphPort {
-    id: string;
-    label: string;
-    kind: 'input' | 'output';
-    /** For inputs that map into deep paths (e.g. Tabs internals) */
-    path?: string;
-    /** Optional description (from metadata) for tooltips */
-    description?: string;
-    anchor: {
-        x: number;
-        y: number;
-    };
-}
-interface GraphEdgeMeta {
-    map?: string;
-    transform?: string;
-    bindingOrder?: string[];
-    routerMode?: 'auto' | 'elbow' | 'bezier' | 'straight';
-}
-interface GraphEdge {
-    id: string;
-    from: {
-        nodeId: string;
-        portId: string;
-    };
-    to: {
-        nodeId: string;
-        portId: string;
-    };
-    label?: string;
-    meta?: GraphEdgeMeta;
-}
-
-type StatefulGridPageDefinition = GridPageDefinition & {
-    state?: WidgetPageStateInput;
-};
-declare class GraphMapperService {
-    private registry;
-    constructor(registry: ComponentMetadataRegistry);
-    private isWidgetSource;
-    private isWidgetTarget;
-    /** Build nodes and edges for a given page definition and widgets. */
-    mapToGraph(page: StatefulGridPageDefinition | undefined, widgets: GridWidgetInstance[]): {
-        nodes: GraphNode[];
-        edges: GraphEdge[];
-    };
-    private ensureStateNode;
-    private normalizeState;
-    private ensurePort;
-    /**
-     * Parse dot-path for Tabs internals. Supported:
-     * - inputs.config.tabs[<i>].widgets[<j>].inputs.<input>
-     * - inputs.config.nav.links[<i>].widgets[<j>].inputs.<input>
-     */
-    parseTabsPath(path: string | undefined): {
-        kind: 'group' | 'nav';
-        index: number;
-        widgetIndex: number;
-        input: string;
-    } | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<GraphMapperService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<GraphMapperService>;
-}
-
-type ItemWithKey = GridsterItem & {
-    __key__: string;
-};
-declare class DynamicGridsterPageComponent implements OnChanges, PageBuilderHost {
-    private conn;
-    private router;
-    private host;
+declare class DynamicPageBuilderComponent implements OnChanges {
     private dialog;
-    private graphMapper;
-    private registry;
-    private storage;
-    private componentKeys;
-    private tableConfigEditor;
-    private stepperConfigEditor;
     private settingsPanel;
-    private route;
-    page?: GridPageDefinition | string;
-    context?: Record<string, any> | null;
+    runtime?: DynamicWidgetPageComponent;
+    page?: WidgetPageDefinition | string;
+    context?: Record<string, unknown> | null;
     strictValidation: boolean;
-    gridsterOptions?: Partial<GridsterConfig>;
-    /** Shows settings button and enables in-place editing affordances */
     enableCustomization: boolean;
-    /** When true, shows small floating settings fab; if false, rely on bottom toolbar */
     showSettingsButton: boolean;
-    /** Optional identity; if not provided, will derive routePath from current Router URL */
     pageIdentity?: PageIdentity;
-    /** Optional instance key for pages rendered multiple times */
     componentInstanceId?: string;
-    layoutChange: EventEmitter<GridWidgetInstance[]>;
-    pageChange: EventEmitter<GridPageDefinition>;
-    mergedContext: Record<string, any>;
-    private selectedKey;
-    private widgets;
-    private readonly globalActions;
-    items: i0.WritableSignal<ItemWithKey[]>;
-    interacting: boolean;
-    overlayEnabled: boolean;
-    private appliedPersisted;
-    aiAdapter: PageBuilderAiAdapter;
-    options: GridsterConfig;
-    trackItem: (_: number, it: ItemWithKey) => string;
-    constructor(conn: ConnectionManagerService, router: Router, host: ElementRef<HTMLElement>, dialog: MatDialog, graphMapper: GraphMapperService, registry: ComponentMetadataRegistry, storage: AsyncConfigStorage, componentKeys: ComponentKeyService, tableConfigEditor: any, stepperConfigEditor: any, settingsPanel: SettingsPanelBridge | null, route: ActivatedRoute | null);
-    applyConfigFromAdapter(next: PageBuilderConfig): void;
+    pageEditorComponent: Type<any> | undefined;
+    pageChange: EventEmitter<WidgetPageDefinition>;
+    readonly currentPage: i0.WritableSignal<WidgetPageDefinition>;
+    private previewMode;
+    constructor(dialog: MatDialog, settingsPanel: SettingsPanelBridge | null);
     ngOnChanges(changes: SimpleChanges): void;
-    private parsePage;
-    private gridsterFromPageOptions;
-    private enrichWithInheritedInputs;
-    private applyWidgetInputs;
-    private ensureComponentInstanceId;
-    private widgetToItem;
-    computeTileDomId(key: string): string;
-    isSelected(key: string): boolean;
-    getWidgetType(key: string): string | undefined;
-    getWidgetDef(key: string): any;
-    getWidgetShell(key: string): any;
-    onTileClick(key: string, ev: MouseEvent): void;
-    onItemChanged(item: GridsterItem): void;
+    showSettings(): boolean;
+    onRuntimePageChange(next: WidgetPageDefinition): void;
     togglePreview(): void;
-    confirmRemoveWidget(key: string): void;
-    removeWidget(key: string): void;
     onAddComponent(): void;
     addWidget(type: string): void;
-    createWidgetKey(type: string): string;
-    openWidgetSettings(key: string): void;
-    openWidgetShellSettings(key: string): void;
     openConnectionsGraph(): void;
     openConnectionsBuilder(): void;
-    openConnectionsEditor(): Promise<void>;
+    openConnectionsEditor(): void;
     openPageSettings(): void;
-    private derivePageIdentity;
-    savePage(): void;
-    private applyPage;
-    private loadPersistedPage;
-    onWidgetEvent(fromKey: string, evt: {
-        output?: string;
-        payload?: any;
-    }): void;
-    onShellAction(fromKey: string, evt: WidgetShellActionEvent): void;
-    private handleSetInputCommand;
-    private maybeExecuteMappedAction;
-    private maybeExecuteGlobalCommand;
-    private resolveActionPayload;
-    private resolveTemplate;
-    private lookup;
-    private applyWidgetShell;
-    private applyPageShellPreset;
-    private applyEditShellActions;
-    showSettings(): boolean;
-    private storageKey;
-    private componentKeyId;
-    private buildPageScopeId;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicGridsterPageComponent, [null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicGridsterPageComponent, "praxis-dynamic-gridster-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "gridsterOptions": { "alias": "gridsterOptions"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; }, { "layoutChange": "layoutChange"; "pageChange": "pageChange"; }, never, never, true, never>;
+    saveCurrentPage(): void;
+    private parsePage;
+    private clonePage;
+    private buildAuthoringReadPage;
+    private buildAuthoringReadWidgets;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
-export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionBuilderComponent, DynamicGridsterPageComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs };
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionBuilderComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs };
 export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ConfirmDialogData, ValueKind };