@praxisui/page-builder 8.0.0-beta.104 → 8.0.0-beta.106

package/package.json

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

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

@@ -7,7 +7,7 @@ import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
-import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AiJsonObject, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
+import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AiJsonObject, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 
 declare const PLACEHOLDER = 1;
 
@@ -42,6 +42,12 @@ declare class FloatingToolbarComponent {
     canRedo: boolean;
     showSave: boolean;
     showPreview: boolean;
+    editingEnabled: boolean;
+    previewActive: boolean;
+    connectionMode: boolean;
+    modeLabel: string;
+    previewLabel: string;
+    exitPreviewLabel: string;
     add: EventEmitter<void>;
     undo: EventEmitter<void>;
     redo: EventEmitter<void>;
@@ -49,7 +55,7 @@ declare class FloatingToolbarComponent {
     preview: EventEmitter<void>;
     save: EventEmitter<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FloatingToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FloatingToolbarComponent, "praxis-floating-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "showSave": { "alias": "showSave"; "required": false; }; "showPreview": { "alias": "showPreview"; "required": false; }; }, { "add": "add"; "undo": "undo"; "redo": "redo"; "settings": "settings"; "preview": "preview"; "save": "save"; }, never, ["[pdx-toolbar-extra]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FloatingToolbarComponent, "praxis-floating-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; "showSave": { "alias": "showSave"; "required": false; }; "showPreview": { "alias": "showPreview"; "required": false; }; "editingEnabled": { "alias": "editingEnabled"; "required": false; }; "previewActive": { "alias": "previewActive"; "required": false; }; "connectionMode": { "alias": "connectionMode"; "required": false; }; "modeLabel": { "alias": "modeLabel"; "required": false; }; "previewLabel": { "alias": "previewLabel"; "required": false; }; "exitPreviewLabel": { "alias": "exitPreviewLabel"; "required": false; }; }, { "add": "add"; "undo": "undo"; "redo": "redo"; "settings": "settings"; "preview": "preview"; "save": "save"; }, never, ["[pdx-toolbar-extra]"], true, never>;
 }
 
 interface ComponentPaletteSelection {
@@ -61,6 +67,7 @@ interface ComponentPaletteData {
     title?: string;
     allowedWidgetIds?: string[];
     allowedWidgetTags?: string[];
+    allowedPresetIds?: string[];
     predicate?: (m: ComponentDocMeta) => boolean;
 }
 interface ComponentPaletteEntry {
@@ -1284,6 +1291,7 @@ interface PageBuilderAgenticAuthoringIntentResolutionResult {
     gate: PageBuilderAgenticAuthoringGateResult;
     effectivePrompt?: string | null;
     assistantMessage?: string | null;
+    assistantContent?: AiJsonObject | null;
     quickReplies?: PageBuilderAgenticAuthoringQuickReply[];
     pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
     clarificationQuestions: string[];
@@ -1582,6 +1590,20 @@ interface AgenticAuthoringQuickReply extends PraxisAssistantShellQuickReply {
     kind: string;
 }
 type AgenticAuthoringPanelLayout = PraxisAssistantShellLayout;
+type PageBuilderPremiumReadinessSeverity = 'info' | 'warning' | 'error';
+type PageBuilderPremiumReadinessActionKind = 'open-page-settings' | 'open-connections' | 'open-widget-config' | 'focus-widget';
+interface PageBuilderPremiumReadinessAction {
+    kind: PageBuilderPremiumReadinessActionKind;
+    label: string;
+    widgetKey?: string;
+}
+interface PageBuilderPremiumReadinessIssue {
+    id: string;
+    severity: PageBuilderPremiumReadinessSeverity;
+    title: string;
+    description: string;
+    action?: PageBuilderPremiumReadinessAction;
+}
 type SharedRuleCockpitAction = 'definition' | 'simulation' | 'approve' | 'activate' | 'publication' | 'materializations' | 'timeline' | 'enforcement';
 type ProjectKnowledgeCockpitAction = 'change-set' | 'validate' | 'approve' | 'reject' | 'apply' | 'readback';
 interface SharedRuleEnforcementSummary {
@@ -1626,6 +1648,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private settingsPanel;
     private readonly i18n;
     private readonly injector;
+    private readonly hostElement;
     private readonly componentMetadata;
     private readonly agenticAuthoring;
     private readonly agenticTurnOrchestrator;
@@ -1642,6 +1665,9 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     pageIdentity?: PageIdentity;
     componentInstanceId?: string;
     pageEditorComponent: Type<any> | undefined;
+    componentPaletteAllowedWidgetIds: string[] | null;
+    componentPaletteAllowedWidgetTags: string[] | null;
+    componentPaletteAllowedPresetIds: string[] | null;
     enableAgenticAuthoring: boolean;
     agenticAuthoringProvider?: string;
     agenticAuthoringModel?: string;
@@ -1665,6 +1691,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     savedPageDeleteRequested: EventEmitter<void>;
     readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
     readonly hasPageWidgets: _angular_core.Signal<boolean>;
+    readonly premiumReadinessIssues: _angular_core.Signal<PageBuilderPremiumReadinessIssue[]>;
     readonly connectionsViewerOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringPrompt: _angular_core.WritableSignal<string>;
@@ -1713,6 +1740,8 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     showSettings(): boolean;
+    isPreviewMode(): boolean;
+    builderModeLabel(): string;
     onRuntimePageChange(next: WidgetPageDefinition): void;
     onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
     onConnectionEditorPageChange(next: WidgetPageDefinition): void;
@@ -1722,11 +1751,20 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     toggleSharedRuleCockpit(): void;
     toggleProjectKnowledgeCockpit(): void;
     toggleConnectionsViewer(): void;
+    connectionsToggleLabel(): string;
     onAddComponent(): void;
     addWidget(selection: string | ComponentPaletteSelection): void;
+    private layoutHintsFor;
     openPageSettings(): void;
     saveCurrentPage(): void;
     canSaveCurrentPage(): boolean;
+    private evaluatePremiumReadiness;
+    runPremiumReadinessAction(issue: PageBuilderPremiumReadinessIssue): void;
+    private isPremiumReadinessCandidate;
+    private hasDisconnectedOperationalWidgets;
+    private latePrimaryChartKey;
+    private usesLocalAnalyticData;
+    private isAnalyticWidget;
     applyConfigFromAdapter(config: PageBuilderConfig): void;
     private createAdapterHost;
     toggleAgenticAuthoring(): void;
@@ -1886,6 +1924,11 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private toRecord;
     private resolvePreviewCompiledFormPatch;
     focusCanvasWidget(widgetKey: string): void;
+    private openWidgetConfiguration;
+    private selectInsertedWidget;
+    private deferInsertedWidgetFocus;
+    private scrollInsertedWidgetIntoView;
+    private escapeAttributeValue;
     private parsePage;
     private clonePage;
     private clearSelectedWidgetIfMissing;
@@ -1906,7 +1949,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private cloneValue;
     tx(key: string, fallback: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "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; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "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; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
 }
 
 export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs, validateUiCompositionPlan };