@praxisui/page-builder 9.0.0-beta.2 → 9.0.0-beta.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.0-beta.2",
+  "version": "9.0.0-beta.20",
   "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.0-beta.2",
-    "@praxisui/core": "^9.0.0-beta.2",
-    "@praxisui/settings-panel": "^9.0.0-beta.2",
+    "@praxisui/ai": "^9.0.0-beta.20",
+    "@praxisui/core": "^9.0.0-beta.20",
+    "@praxisui/settings-panel": "^9.0.0-beta.20",
     "rxjs": "~7.8.0"
   },
   "dependencies": {
@@ -20,17 +20,11 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codexrodrigues/praxis-ui-angular.git"
-  },
-  "homepage": "https://praxisui.dev",
-  "bugs": {
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
-  },
+  "homepage": "https://praxisui.dev/components/page-builder",
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "page-builder",
     "widgets",
     "dashboard",
@@ -46,7 +40,10 @@
     ".": {
       "types": "./types/praxisui-page-builder.d.ts",
       "default": "./fesm2022/praxisui-page-builder.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

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

@@ -373,6 +373,7 @@ type ConnectionEditorFlowMode = 'all' | 'data' | 'event' | 'capability' | 'simul
 type ConnectionEditorDockTab = 'json' | 'links' | 'derived' | 'export';
 type ConnectionEditorConditionPreset = 'source-present' | 'source-id-present';
 type ConnectionEditorPolicyPreset = 'stable-delivery' | 'skip-missing';
+type ConnectionEditorVisualDensity = 'guided' | 'full';
 interface DragState {
     port: ConnectionEditorPort;
     source: ConnectionEditorPoint;
@@ -456,6 +457,7 @@ declare class ConnectionEditorComponent {
     readonly selectedWidgetId: _angular_core.WritableSignal<string | null>;
     readonly selectedLinkId: _angular_core.WritableSignal<string | null>;
     readonly recentLinkId: _angular_core.WritableSignal<string | null>;
+    readonly lastCreatedLinkId: _angular_core.WritableSignal<string | null>;
     readonly hoveredLinkId: _angular_core.WritableSignal<string | null>;
     readonly expandedNodeId: _angular_core.WritableSignal<string | null>;
     readonly activeDockTab: _angular_core.WritableSignal<ConnectionEditorDockTab>;
@@ -464,6 +466,8 @@ declare class ConnectionEditorComponent {
     readonly traceStepIndex: _angular_core.WritableSignal<number>;
     readonly traceSourceNodeId: _angular_core.WritableSignal<string | null>;
     readonly selectedPort: _angular_core.WritableSignal<ConnectionEditorPort | null>;
+    readonly hoveredNodeId: _angular_core.WritableSignal<string | null>;
+    readonly visualDensity: _angular_core.WritableSignal<ConnectionEditorVisualDensity>;
     readonly globalActionPayloadError: _angular_core.WritableSignal<string | null>;
     readonly pendingSegmentState: _angular_core.WritableSignal<PendingSegmentState | null>;
     readonly dragState: _angular_core.WritableSignal<DragState | null>;
@@ -543,6 +547,8 @@ declare class ConnectionEditorComponent {
     readonly visibleEdges: _angular_core.Signal<ConnectionsViewerEdge[]>;
     readonly selectedEdge: _angular_core.Signal<ConnectionsViewerEdge | null>;
     readonly editorGraph: _angular_core.Signal<ConnectionEditorGraph>;
+    readonly connectedNodeIds: _angular_core.Signal<Set<string>>;
+    readonly connectedPortIds: _angular_core.Signal<Set<string>>;
     readonly editorNodes: _angular_core.Signal<ConnectionEditorNode[]>;
     readonly navigationBounds: _angular_core.Signal<ConnectionEditorBounds>;
     readonly minimapViewBox: _angular_core.Signal<string>;
@@ -553,6 +559,8 @@ declare class ConnectionEditorComponent {
     readonly modeMatchedNodeIds: _angular_core.Signal<Set<string>>;
     readonly modeMatchedPortIds: _angular_core.Signal<Set<string>>;
     readonly smartSuggestions: _angular_core.Signal<ConnectionEditorSuggestion[]>;
+    readonly recommendedMasterDetailSuggestion: _angular_core.Signal<ConnectionEditorSuggestion | null>;
+    readonly masterDetailReadinessDiagnostic: _angular_core.Signal<string | null>;
     readonly traceSteps: _angular_core.Signal<ConnectionEditorTraceStep[]>;
     readonly activeTraceStepIndex: _angular_core.Signal<number>;
     readonly traceActiveStep: _angular_core.Signal<ConnectionEditorTraceStep>;
@@ -610,6 +618,8 @@ declare class ConnectionEditorComponent {
     handleEditorKeydown(event: KeyboardEvent): void;
     setFilter(filter: ConnectionsEditorFilter): void;
     setMode(mode: ConnectionEditorFlowMode): void;
+    toggleVisualDensity(event: Event): void;
+    visualDensityAriaLabel(): string;
     activeModeStatus(): string;
     setDockTab(tab: ConnectionEditorDockTab): void;
     handleDockTabKeydown(event: KeyboardEvent, tab: ConnectionEditorDockTab): void;
@@ -670,6 +680,9 @@ declare class ConnectionEditorComponent {
     segmentLabelTransform(segment: ConnectionEditorSegmentGeometry, node: ConnectionEditorNode): string;
     nodeRotationHandleTransform(node: ConnectionEditorNode): string;
     segmentDisplayLabel(label: string): string;
+    isNestedPort(port: ConnectionEditorPort): boolean;
+    nestedPortPathText(port: ConnectionEditorPort): string;
+    portDescription(port: ConnectionEditorPort): string;
     segmentKindGlyph(kind: ConnectionEditorPortKind): string;
     nodeIcon(node: ConnectionEditorNode): string;
     dockTabLabel(tab: ConnectionEditorDockTabDefinition): string;
@@ -677,6 +690,9 @@ declare class ConnectionEditorComponent {
     dockPanelId(tab: ConnectionEditorDockTab): string;
     dockToggleLabel(): string;
     segmentKindText(kind: ConnectionEditorPortKind): string;
+    connectionHasNestedEndpoint(connection: ConnectionEditorConnection): boolean;
+    connectionNestedSummary(connection: ConnectionEditorConnection): string;
+    private formatNestedPath;
     connectionHasErrors(connection: ConnectionEditorConnection): boolean;
     connectionHasWarnings(connection: ConnectionEditorConnection): boolean;
     connectionHasPolicy(connection: ConnectionEditorConnection): boolean;
@@ -685,6 +701,12 @@ declare class ConnectionEditorComponent {
     isModeDimmedConnection(connection: ConnectionEditorConnection): boolean;
     isModeDimmedNode(node: ConnectionEditorNode): boolean;
     isModeDimmedPort(port: ConnectionEditorPort): boolean;
+    isGuidedQuietNode(node: ConnectionEditorNode): boolean;
+    areNodePortsVisible(node: ConnectionEditorNode): boolean;
+    isGuidedPortVisible(port: ConnectionEditorPort): boolean;
+    isGuidedSegmentLabelVisible(port: ConnectionEditorPort): boolean;
+    clearHoveredNode(nodeId: string): void;
+    private updateAutoExpandedNode;
     edgeMatchesMode(edge: ConnectionsViewerEdge): boolean;
     isNodeFocusedByConnection(node: ConnectionEditorNode): boolean;
     isPortFocusedByConnection(port: ConnectionEditorPort): boolean;
@@ -696,7 +718,24 @@ declare class ConnectionEditorComponent {
     diagnosticSeverityLabel(diagnostic: ConnectionEditorDiagnostic): string;
     diagnosticText(diagnostic: ConnectionEditorDiagnostic): string;
     suggestionReasonText(reason: ConnectionEditorSuggestionReason): string;
+    connectionSemanticLabel(connection: ConnectionEditorConnection): string;
+    connectionHumanSummary(connection: ConnectionEditorConnection): string;
+    connectionDeliveryPreview(connection: ConnectionEditorConnection): string;
+    suggestionSemanticLabel(suggestion: ConnectionEditorSuggestion): string;
+    suggestionPreviewText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionOutcomeText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionRouteTechnicalText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionActionText(suggestion: ConnectionEditorSuggestion): string;
+    connectionCreatedFeedback(connection: ConnectionEditorConnection): string;
+    portAriaLabel(node: ConnectionEditorNode, port: ConnectionEditorPort, role: 'input' | 'output' | 'state'): string;
     transformKindText(kind: TransformKind): string;
+    private readableEndpointLabel;
+    private isSelectionToDetailConnection;
+    private isSuggestedMasterDetail;
+    private isCanonicalSelectionToDetailConnection;
+    private isTableSelectionOutput;
+    private isFormResourceIdInput;
+    private portComponentType;
     expandedPorts(node: ConnectionEditorNode): ConnectionEditorPort[];
     movePort(node: ConnectionEditorNode, port: ConnectionEditorPort, direction: -1 | 1, event: Event): void;
     toggleSegments(node: ConnectionEditorNode, event: Event): void;
@@ -758,6 +797,7 @@ declare class ConnectionEditorComponent {
     private showInvalidDropFeedback;
     private clearInvalidDropFeedback;
     private markRecentLink;
+    private scrollConnectionSidePanelToTop;
     private clearPreviewConnectionState;
     private shouldIgnoreEditorShortcut;
     private scrollActiveModeIntoView;
@@ -807,20 +847,37 @@ type DeviceVariantForm = FormGroup<{
     groupingOverrides: FormControl<string>;
     widgetOverrides: FormControl<string>;
 }>;
+type LayoutPresetEntry = {
+    id: string;
+    label: string;
+    description: string;
+    category: string;
+    defaultColumns: number;
+    defaultGap: string;
+    slotLabels: string[];
+    requiredSlotLabels: string[];
+    deviceStacking: string;
+    preferTabsOnMobile: boolean;
+    hideSecondaryContentOnMobile: boolean;
+    defaultThemePreset: string;
+};
+type ThemePresetEntry = {
+    id: string;
+    label: string;
+    description: string;
+    density: string;
+    motion: string;
+    shellPreset: string;
+    chartThemePreset: string;
+};
 declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueProvider$1 {
     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 layoutPresetEntries: LayoutPresetEntry[];
+    readonly themePresetEntries: ThemePresetEntry[];
     readonly shellPresetEntries: {
         id: string;
         label: string;
@@ -848,6 +905,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly stateError: WritableSignal<string | null>;
     readonly deviceError: WritableSignal<string | null>;
     private readonly injectedData;
+    private readonly i18n;
     private pageInput;
     private snapshot;
     private hydrating;
@@ -861,13 +919,24 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get dirtyStateLabel(): string;
     get selectedLayoutPresetLabel(): string;
     get selectedThemePresetLabel(): string;
+    get selectedLayoutPresetEntry(): LayoutPresetEntry | null;
+    get selectedThemePresetEntry(): ThemePresetEntry | null;
+    get recommendedThemePresetEntry(): ThemePresetEntry | null;
     get canvasSummaryLabel(): string;
     onSelectedTabIndexChange(index: number): void;
     getSettingsValue(): WidgetPageDefinition | null;
     onSave(): WidgetPageDefinition | null;
     reset(): void;
+    pinRecommendedThemePreset(): void;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
+    layoutPresetSummary(preset: LayoutPresetEntry): string;
+    slotsSummary(preset: LayoutPresetEntry): string;
+    requiredSlotsSummary(preset: LayoutPresetEntry): string;
+    devicePolicySummary(preset: LayoutPresetEntry): string;
+    inheritedThemeHelp(theme: ThemePresetEntry): string;
+    groupLabel(index: number): string;
+    tx(key: string, fallback: string): string;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
     private hydrate;
@@ -1691,6 +1760,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     savedPageDeleteRequested: EventEmitter<void>;
     readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
     readonly hasPageWidgets: _angular_core.Signal<boolean>;
+    readonly hasRecommendedConnectionSuggestion: _angular_core.Signal<boolean>;
     readonly premiumReadinessIssues: _angular_core.Signal<PageBuilderPremiumReadinessIssue[]>;
     readonly connectionsViewerOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringOpen: _angular_core.WritableSignal<boolean>;
@@ -1728,6 +1798,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly agenticAuthoringWidgetContextKey: _angular_core.WritableSignal<string | null>;
     readonly agenticAuthoringPanelLayout: _angular_core.WritableSignal<PraxisAssistantShellLayout>;
     private previewMode;
+    private runtimePreviewPageCache?;
     private agenticComponentCapabilities?;
     private agenticComponentCapabilitiesPromise?;
     private agenticTurnController?;
@@ -1741,6 +1812,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     ngOnDestroy(): void;
     showSettings(): boolean;
     isPreviewMode(): boolean;
+    runtimePage(): WidgetPageDefinition;
     builderModeLabel(): string;
     onRuntimePageChange(next: WidgetPageDefinition): void;
     onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
@@ -1774,6 +1846,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     minimizeAgenticAuthoring(): void;
     onAgenticAuthoringLayoutChange(layout: AgenticAuthoringPanelLayout): void;
     agenticAuthoringReviewRailActive(): boolean;
+    showAgenticAuthoringPanel(): boolean;
     showAgenticAuthoringDock(): boolean;
     agenticAuthoringMinimized(): boolean;
     agenticAuthoringToggleLabel(): string;
@@ -1811,6 +1884,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private agenticAuthoringSemanticDecisionContextItems;
     private shouldHideSemanticDecisionContextItems;
     private humanizeAgenticResourcePath;
+    private agenticSemanticResourceLabel;
     private humanizeAgenticDecisionSummary;
     private humanizeAgenticOperationKind;
     private humanizeAgenticArtifactKind;
@@ -1896,6 +1970,9 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private collectRuntimeComponentObservationsForAgenticTurn;
     private ensureAgenticTurnController;
     private applyAgenticPreviewLocally;
+    private enterPreviewMode;
+    private toPresentationRuntimePage;
+    private toPresentationRuntimeWidget;
     private applyAgenticTurnState;
     private primeSharedRuleHandoff;
     private moveAgenticAuthoringPanelToReviewSidecar;
@@ -1952,5 +2029,10 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     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 };
+/** Metadata for Praxis Page Builder component */
+declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
+/** Provider para auto-registrar metadados do componente Page Builder. */
+declare function providePraxisPageBuilderMetadata(): Provider;
+
+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, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, validateUiCompositionPlan };
 export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanInputSource, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTransform, UiCompositionPlanWidget, ValueKind };