@praxisui/page-builder 8.0.0-beta.85 → 8.0.0-beta.86

package/fesm2022/praxisui-page-builder.mjs

@@ -11374,6 +11374,11 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         { path: 'uiCompositionPlan.version', category: 'page', valueKind: 'string', description: 'Versao do plano. Valor atual: 1.0.' },
         { path: 'uiCompositionPlan.kind', category: 'page', valueKind: 'string', description: 'Discriminador do plano. Valor atual: praxis.ui-composition-plan.' },
         { path: 'uiCompositionPlan.layoutPreset', category: 'layout', valueKind: 'string', description: 'Preset semantico opcional da composicao planejada.' },
+        { path: 'uiCompositionPlan.layoutPresetOptions', category: 'layout', valueKind: 'object', description: 'Opcoes semanticas opcionais do preset, como familia visual, estrategia responsiva e politica de densidade.' },
+        { path: 'uiCompositionPlan.grouping', category: 'layout', valueKind: 'array', description: 'Agrupamentos semanticos opcionais para organizar widgets em hero, section, tabs ou rail no runtime.' },
+        { path: 'uiCompositionPlan.slotAssignments', category: 'layout', valueKind: 'object', description: 'Mapa opcional widgetKey -> slot semantico para alinhar widgets gerados a presets de layout sem depender de dominio.' },
+        { path: 'uiCompositionPlan.deviceLayouts', category: 'layout', valueKind: 'object', description: 'Variantes responsivas opcionais para desktop, tablet e mobile, incluindo canvas, groupingOverrides e widgetOverrides.' },
+        { path: 'uiCompositionPlan.themePreset', category: 'layout', valueKind: 'string', description: 'Preset visual opcional do runtime, por exemplo analytics-calm, workspace-balanced ou ops-monitoring.' },
         { path: 'uiCompositionPlan.state', category: 'state', valueKind: 'object', description: 'Estado inicial/declarativo que sera compilado para page.state.' },
         { path: 'uiCompositionPlan.widgets', category: 'widgets', valueKind: 'array', description: 'Widgets planejados antes da compilacao para page.widgets.' },
         { path: 'uiCompositionPlan.widgets[].key', category: 'widgets', valueKind: 'string', description: 'ID estavel do widget planejado.', critical: true },
@@ -12047,9 +12052,10 @@ const PAGE_BUILDER_COMPONENT_CONTEXT_PACK = {
     ],
 };
 
-const DEFAULT_AGENTIC_AUTHORING_REQUEST_TIMEOUT_MS = 15000;
+const DEFAULT_AGENTIC_AUTHORING_REQUEST_TIMEOUT_MS = 120000;
 const DEFAULT_TURN_STREAM_START_TIMEOUT_MS = 10000;
 const DEFAULT_TURN_STREAM_TIMEOUT_MS = 240000;
+const DEFAULT_TURN_STREAM_RESULT_FALLBACK_MS = 90000;
 const PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS = new InjectionToken('PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS');
 class PageBuilderAgenticAuthoringService {
     http = inject(HttpClient);
@@ -12110,7 +12116,9 @@ class PageBuilderAgenticAuthoringService {
             let source = null;
             let closed = false;
             let streamTimeout = null;
+            let resultFallbackTimeout = null;
             const streamTimeoutMs = this.streamTurnTimeoutMs();
+            const resultFallbackMs = this.streamResultFallbackMs();
             let probeAbort = typeof AbortController !== 'undefined'
                 ? new AbortController()
                 : null;
@@ -12121,16 +12129,41 @@ class PageBuilderAgenticAuthoringService {
                     streamTimeout = null;
                 }
             };
+            const clearResultFallbackTimeout = () => {
+                if (resultFallbackTimeout) {
+                    clearTimeout(resultFallbackTimeout);
+                    resultFallbackTimeout = null;
+                }
+            };
             const closeSource = () => {
                 if (closed) {
                     return;
                 }
                 closed = true;
                 clearStreamTimeout();
+                clearResultFallbackTimeout();
                 streamAbort?.abort();
                 streamAbort = null;
                 source?.close();
             };
+            const startResultFallbackTimer = () => {
+                clearResultFallbackTimeout();
+                if (resultFallbackMs <= 0)
+                    return;
+                resultFallbackTimeout = setTimeout(() => {
+                    if (closed)
+                        return;
+                    streamAbort?.abort();
+                    streamAbort = null;
+                    source?.close();
+                    observer.error(this.streamConnectionError({
+                        code: 'agentic-authoring-result-fallback',
+                        message: `Agentic authoring stream did not deliver a result after ${resultFallbackMs}ms.`,
+                        fallbackAuthoringUrl: start.fallbackAuthoringUrl ?? null,
+                    }));
+                    closeSource();
+                }, resultFallbackMs);
+            };
             streamTimeout = setTimeout(() => {
                 if (closed) {
                     return;
@@ -12154,6 +12187,7 @@ class PageBuilderAgenticAuthoringService {
                 }
                 observer.next(parsed);
                 if (parsed.type === 'result' || parsed.type === 'error' || parsed.type === 'cancelled') {
+                    clearResultFallbackTimeout();
                     observer.complete();
                     closeSource();
                 }
@@ -12171,6 +12205,7 @@ class PageBuilderAgenticAuthoringService {
                 }
                 if (!this.options?.eventSourceFactory && typeof fetch === 'function' && typeof TextDecoder !== 'undefined') {
                     streamAbort = typeof AbortController !== 'undefined' ? new AbortController() : null;
+                    startResultFallbackTimer();
                     void this.consumeFetchTurnStream(url, streamAbort, handleMessage, () => closed).catch((error) => {
                         if (closed) {
                             return;
@@ -12188,6 +12223,7 @@ class PageBuilderAgenticAuthoringService {
                     observer.error(this.streamConnectionError(error));
                     return;
                 }
+                startResultFallbackTimer();
                 source.onmessage = handleMessage;
                 if (source.addEventListener) {
                     for (const type of AI_STREAM_EVENT_TYPES) {
@@ -12222,6 +12258,7 @@ class PageBuilderAgenticAuthoringService {
                 streamAbort?.abort();
                 streamAbort = null;
                 clearStreamTimeout();
+                clearResultFallbackTimeout();
             };
         });
     }
@@ -12293,6 +12330,9 @@ class PageBuilderAgenticAuthoringService {
     streamTurnTimeoutMs() {
         return Math.max(1, this.options?.streamTurnTimeoutMs ?? DEFAULT_TURN_STREAM_TIMEOUT_MS);
     }
+    streamResultFallbackMs() {
+        return Math.max(0, this.options?.streamResultFallbackMs ?? DEFAULT_TURN_STREAM_RESULT_FALLBACK_MS);
+    }
     requestTimeoutMs() {
         return Math.max(1, this.options?.requestTimeoutMs ?? DEFAULT_AGENTIC_AUTHORING_REQUEST_TIMEOUT_MS);
     }
@@ -12986,8 +13026,13 @@ function compileUiCompositionPlan(plan) {
         valid: true,
         page: {
             layoutPreset: plan.layoutPreset,
+            layoutPresetOptions: clone(plan.layoutPresetOptions),
             canvas: clone(plan.canvas),
+            deviceLayouts: clone(plan.deviceLayouts),
+            grouping: clone(plan.grouping),
+            slotAssignments: clone(plan.slotAssignments),
             state: clone(plan.state),
+            themePreset: plan.themePreset,
             widgets: plan.widgets.map((widget) => toWidgetInstance(widget, plan.bindings ?? [])),
             composition: {
                 version: '1.0.0',
@@ -13051,6 +13096,9 @@ function validateUiCompositionPlan(plan) {
         }
     }
     validateCanvas(plan.canvas, widgetKeys, diagnostics);
+    validateGrouping(plan.grouping, widgetKeys, diagnostics);
+    validateDeviceLayouts(plan.deviceLayouts, widgetKeys, diagnostics);
+    validateSlotAssignments(plan.slotAssignments, widgetKeys, diagnostics);
     return diagnostics;
 }
 function validateCanvas(canvas, widgetKeys, diagnostics) {
@@ -13066,6 +13114,107 @@ function validateCanvas(canvas, widgetKeys, diagnostics) {
         }
     }
 }
+function validateSlotAssignments(slotAssignments, widgetKeys, diagnostics) {
+    if (!slotAssignments || typeof slotAssignments !== 'object')
+        return;
+    for (const [widgetKey, slotId] of Object.entries(slotAssignments)) {
+        if (!widgetKeys.has(widgetKey)) {
+            diagnostics.push({
+                code: 'slot-assignment-widget-not-found',
+                message: `Slot assignment references unknown widget "${widgetKey}".`,
+                path: `slotAssignments.${widgetKey}`,
+            });
+        }
+        if (!String(slotId || '').trim()) {
+            diagnostics.push({
+                code: 'slot-assignment-slot-required',
+                message: `Slot assignment for widget "${widgetKey}" must declare a slot id.`,
+                path: `slotAssignments.${widgetKey}`,
+            });
+        }
+    }
+}
+function validateDeviceLayouts(deviceLayouts, widgetKeys, diagnostics) {
+    if (!deviceLayouts)
+        return;
+    for (const [device, variant] of Object.entries(deviceLayouts)) {
+        for (const key of Object.keys(variant?.canvas?.items ?? {})) {
+            if (!widgetKeys.has(key)) {
+                diagnostics.push({
+                    code: 'device-layout-widget-not-found',
+                    message: `Device layout "${device}" references unknown widget "${key}".`,
+                    path: `deviceLayouts.${device}.canvas.items.${key}`,
+                });
+            }
+        }
+        for (const key of Object.keys(variant?.widgetOverrides ?? {})) {
+            if (!widgetKeys.has(key)) {
+                diagnostics.push({
+                    code: 'device-layout-widget-override-not-found',
+                    message: `Device layout "${device}" overrides unknown widget "${key}".`,
+                    path: `deviceLayouts.${device}.widgetOverrides.${key}`,
+                });
+            }
+        }
+        for (const [groupIndex, override] of (variant?.groupingOverrides ?? []).entries()) {
+            for (const widgetKey of override.widgetKeys ?? []) {
+                if (!widgetKeys.has(widgetKey)) {
+                    diagnostics.push({
+                        code: 'device-layout-grouping-widget-not-found',
+                        message: `Device layout "${device}" grouping override references unknown widget "${widgetKey}".`,
+                        path: `deviceLayouts.${device}.groupingOverrides.${groupIndex}.widgetKeys`,
+                    });
+                }
+            }
+            for (const [tabIndex, tab] of (override.tabs ?? []).entries()) {
+                for (const widgetKey of tab.widgetKeys ?? []) {
+                    if (!widgetKeys.has(widgetKey)) {
+                        diagnostics.push({
+                            code: 'device-layout-grouping-widget-not-found',
+                            message: `Device layout "${device}" tab override references unknown widget "${widgetKey}".`,
+                            path: `deviceLayouts.${device}.groupingOverrides.${groupIndex}.tabs.${tabIndex}.widgetKeys`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+}
+function validateGrouping(grouping, widgetKeys, diagnostics) {
+    if (!Array.isArray(grouping))
+        return;
+    const groupIds = new Set();
+    grouping.forEach((group, index) => {
+        if (!group?.id?.trim()) {
+            diagnostics.push({
+                code: 'group-id-required',
+                message: 'Every planned group must declare a stable id.',
+                path: `grouping.${index}.id`,
+            });
+            return;
+        }
+        if (groupIds.has(group.id)) {
+            diagnostics.push({
+                code: 'group-id-duplicated',
+                message: `Group id "${group.id}" is duplicated.`,
+                path: `grouping.${index}.id`,
+            });
+        }
+        groupIds.add(group.id);
+        const references = group.kind === 'tabs'
+            ? group.tabs.flatMap((tab) => tab.widgetKeys ?? [])
+            : group.widgetKeys ?? [];
+        references.forEach((widgetKey) => {
+            if (!widgetKeys.has(widgetKey)) {
+                diagnostics.push({
+                    code: 'grouping-widget-not-found',
+                    message: `Grouping "${group.id}" references unknown widget "${widgetKey}".`,
+                    path: `grouping.${index}.widgetKeys`,
+                });
+            }
+        });
+    });
+}
 function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAction) {
     if (!endpoint || typeof endpoint !== 'object') {
         diagnostics.push({
@@ -13999,7 +14148,10 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     diagnostics: { intentResolution },
                 };
             }
-            const intentFailure = this.describeIntentResolutionFailure(intentResolution);
+            const shouldGenerateGuidedPreview = this.shouldAutoGenerateGuidedPreview(intentResolution, intentQuickReplies, prompt);
+            const intentFailure = shouldGenerateGuidedPreview
+                ? null
+                : this.describeIntentResolutionFailure(intentResolution);
             if (intentFailure) {
                 return {
                     state: 'error',
@@ -15209,6 +15361,9 @@ class PageBuilderAgenticAuthoringTurnFlow {
             'adicione',
             'adicionar',
             'faca',
+            'quero',
+            'preciso',
+            'necessito',
         ].some((term) => normalized.includes(term));
         const artifact = [
             'preview',

package/package.json

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

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

@@ -1,7 +1,7 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, Type, SimpleChanges } from '@angular/core';
-import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, 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, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, WidgetPageCanvasLayout, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, SettingsPanelBridge, WidgetEventEnvelope, RichTimelineItem } from '@praxisui/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, 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, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, SettingsPanelBridge, WidgetEventEnvelope, RichTimelineItem } from '@praxisui/core';
 export { WidgetShellComponent } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
@@ -1164,6 +1164,7 @@ interface PageBuilderAgenticAuthoringOptions {
     requestTimeoutMs?: number;
     streamStartTimeoutMs?: number;
     streamTurnTimeoutMs?: number;
+    streamResultFallbackMs?: number;
     streamConnectionErrorGraceMs?: number;
 }
 interface PageBuilderAgenticAuthoringEventSource {
@@ -1395,6 +1396,7 @@ declare class PageBuilderAgenticAuthoringService {
     private findSseFrameBoundary;
     private streamStartTimeoutMs;
     private streamTurnTimeoutMs;
+    private streamResultFallbackMs;
     private requestTimeoutMs;
     private streamConnectionError;
     private buildStreamUrl;
@@ -1475,8 +1477,13 @@ interface UiCompositionPlan {
     version: '1.0';
     kind: 'praxis.ui-composition-plan';
     layoutPreset?: string;
+    layoutPresetOptions?: Record<string, unknown>;
     canvas?: WidgetPageCanvasLayout;
+    deviceLayouts?: WidgetPageDeviceLayouts;
+    grouping?: WidgetPageGroupingDefinition[];
+    slotAssignments?: WidgetPageSlotAssignments;
     state?: WidgetPageStateInput;
+    themePreset?: string;
     widgets: UiCompositionPlanWidget[];
     bindings?: UiCompositionPlanBinding[];
 }