@praxisui/page-builder 9.0.45 → 9.0.46

package/fesm2022/praxisui-page-builder.mjs

@@ -13133,7 +13133,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
  * Capabilities catalog for the canonical dynamic page builder/runtime.
  */
 const PAGE_BUILDER_AI_CAPABILITIES = {
-    version: 'v1.4',
+    version: 'v1.5',
     enums: {},
     targets: [
         'page-builder',
@@ -13143,7 +13143,7 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         'praxis-dynamic-page-builder',
     ],
     notes: [
-        'page segue o modelo canonico WidgetPageDefinition (widgets, composition.links, context e state opcional); composition.links tambem pode despachar actions globais via to.kind = global-action.',
+        'page segue o modelo canonico WidgetPageDefinition (widgets, composition.links, context e state opcional); composition.links pode despachar actions globais via to.kind = global-action e receber continuations exatas via from.kind = global-action.',
         'Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.',
         'Quando definition.id = praxis-rich-content em uma pagina dinamica, definition.inputs.document continua sendo o contrato persistido; hostCapabilities e mediado em runtime pelo host praxis-dynamic-page e nao deve ser serializado no JSON da pagina.',
         'Edicao visual de inputs de widget deve usar ComponentDocMeta.configEditor ou ComponentDocMeta.authoringManifestRef publicado pela lib dona do componente; nao criar editor local no page-builder para semantica de outro pacote.',
@@ -13185,7 +13185,8 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         { path: 'uiCompositionPlan.contextScopes[].targets', category: 'context', valueKind: 'array', description: 'Destinos explicitos do escopo, identificados por widget owner e nestedPath canonico opcional.' },
         { path: 'uiCompositionPlan.bindings', category: 'connections', valueKind: 'array', description: 'Bindings declarativos que serao compilados para page.composition.links.' },
         { path: 'uiCompositionPlan.bindings[].id', category: 'connections', valueKind: 'string', description: 'Identificador estavel do binding planejado.' },
-        { path: 'uiCompositionPlan.bindings[].from', category: 'connections', valueKind: 'object', description: 'Endpoint de origem: component-port ou state.' },
+        { path: 'uiCompositionPlan.bindings[].from', category: 'connections', valueKind: 'object', description: 'Endpoint de origem: component-port, state ou global-action. Uma origem global-action identifica a continuation somente por actionId; o payload vem do dispatch runtime.' },
+        { path: 'uiCompositionPlan.bindings[].from.[actionId]', category: 'connections', valueKind: 'string', description: 'ID exato da continuation quando uiCompositionPlan.bindings[].from.kind = global-action. Campos de payload ou metadata nao sao executaveis na origem.' },
         { path: 'uiCompositionPlan.bindings[].to', category: 'connections', valueKind: 'object', description: 'Endpoint de destino: component-port, state ou global-action.' },
         { path: 'uiCompositionPlan.bindings[].to.[actionId]', category: 'connections', valueKind: 'string', description: 'ID da action global quando uiCompositionPlan.bindings[].to.kind = global-action.' },
         { path: 'uiCompositionPlan.bindings[].to.payload', category: 'connections', valueKind: 'object', description: 'Payload literal opcional para destino global-action planejado.' },
@@ -14146,13 +14147,29 @@ const globalActionEndpointSchema = {
         },
     },
 };
+const globalActionSourceEndpointSchema = {
+    type: 'object',
+    required: ['kind', 'ref'],
+    additionalProperties: false,
+    properties: {
+        kind: { enum: ['global-action'] },
+        ref: {
+            type: 'object',
+            required: ['actionId'],
+            additionalProperties: false,
+            properties: {
+                actionId: { type: 'string' },
+            },
+        },
+    },
+};
 const compositionLinkSchema = {
     type: 'object',
     required: ['id', 'from', 'to', 'intent'],
     additionalProperties: false,
     properties: {
         id: { type: 'string' },
-        from: { oneOf: [componentPortEndpointSchema, stateEndpointSchema] },
+        from: { oneOf: [componentPortEndpointSchema, stateEndpointSchema, globalActionSourceEndpointSchema] },
         to: { oneOf: [componentPortEndpointSchema, stateEndpointSchema, globalActionEndpointSchema] },
         intent: { enum: linkIntentValues },
         condition: { type: 'object' },
@@ -14178,7 +14195,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
     componentId: 'praxis-page-builder',
     ownerPackage: '@praxisui/page-builder',
     configSchemaId: 'WidgetPageDefinition',
-    manifestVersion: '1.2.0',
+    manifestVersion: '1.3.0',
     runtimeInputs: [
         { name: 'page', type: 'WidgetPageDefinition', description: 'Canonical renderable page document consumed by praxis-dynamic-page.' },
         { name: 'pageIdentity', type: 'PageIdentity | null', description: 'Persistence identity for ui_user_config save/apply flows; not persisted inside page.' },
@@ -14514,6 +14531,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
         'UiCompositionPlan.i18n, context and layout compile into the corresponding WidgetPageDefinition fields so a complete page never depends on host-only enrichment. A key-only PraxisTextValue receives text from the fallbackLocale dictionary when available.',
         'UiCompositionPlan.selectionSyncs is an authoring shorthand that compiles into explicit canonical page.composition.links and is never persisted in WidgetPageDefinition.',
         'UiCompositionPlan.contextScopes compiles constants and state.initial into explicit widget inputs, and state context into explicit page.composition.links; runtime inheritance is never ambient.',
+        'UiCompositionPlan global-action sources declare only actionId; dynamicPage.composition.dispatch supplies the runtime payload, and target-only payload fields fail closed on sources.',
         'Widget keys and composition link ids are stable identities; array indexes are never canonical identities.',
         'Persisted wiring uses page.composition.links and must not write legacy connections.',
         'Nested component ports use component-port refs with nestedPath ending in a stable widget key.',
@@ -15210,8 +15228,8 @@ function validateUiCompositionPlan(plan) {
         }
     }
     for (const [index, binding] of (plan.bindings ?? []).entries()) {
-        validateEndpoint(binding.from, widgetKeys, diagnostics, `bindings.${index}.from`, false);
-        validateEndpoint(binding.to, widgetKeys, diagnostics, `bindings.${index}.to`, true);
+        validateEndpoint(binding.from, widgetKeys, diagnostics, `bindings.${index}.from`, 'source');
+        validateEndpoint(binding.to, widgetKeys, diagnostics, `bindings.${index}.to`, 'target');
         if (!binding.id?.trim()) {
             diagnostics.push({
                 code: 'binding-id-required',
@@ -15264,7 +15282,7 @@ function validateSelectionSync(selectionSync, widgetKeys, diagnostics, path) {
         });
     }
     for (const [sourceIndex, source] of (selectionSync.sources ?? []).entries()) {
-        validateEndpoint(source, widgetKeys, diagnostics, `${path}.sources.${sourceIndex}`, false);
+        validateEndpoint(source, widgetKeys, diagnostics, `${path}.sources.${sourceIndex}`, 'source');
         if (source?.kind !== 'component-port') {
             diagnostics.push({
                 code: 'selection-sync-source-component-port-required',
@@ -15288,7 +15306,7 @@ function validateSelectionSync(selectionSync, widgetKeys, diagnostics, path) {
         });
     }
     else {
-        validateEndpoint(selectionSync.target, widgetKeys, diagnostics, `${path}.target`, false);
+        validateEndpoint(selectionSync.target, widgetKeys, diagnostics, `${path}.target`, 'target');
     }
     const mappings = Object.entries(selectionSync.mapping ?? {});
     if (!mappings.length) {
@@ -15523,7 +15541,7 @@ function validateGrouping(grouping, widgetKeys, diagnostics) {
         });
     });
 }
-function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAction) {
+function validateEndpoint(endpoint, widgetKeys, diagnostics, path, role) {
     if (!endpoint || typeof endpoint !== 'object') {
         diagnostics.push({
             code: 'endpoint-required',
@@ -15561,21 +15579,23 @@ function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAc
         return;
     }
     if (endpoint.kind === 'global-action') {
-        if (!allowGlobalAction) {
-            diagnostics.push({
-                code: 'endpoint-global-action-source-unsupported',
-                message: 'Global-action endpoints are supported only as binding targets.',
-                path: `${path}.kind`,
-            });
-            return;
-        }
         if (!endpoint.actionId?.trim()) {
             diagnostics.push({
                 code: 'endpoint-global-action-id-required',
-                message: 'Global-action target must declare an actionId.',
+                message: 'Global-action endpoint must declare an actionId.',
                 path: `${path}.actionId`,
             });
         }
+        if (role === 'source') {
+            for (const field of Object.keys(endpoint).filter((candidate) => candidate !== 'kind' && candidate !== 'actionId')) {
+                diagnostics.push({
+                    code: 'endpoint-global-action-source-field-unsupported',
+                    message: `Global-action source field "${field}" is not executable; runtime dispatch supplies the payload.`,
+                    path: `${path}.${field}`,
+                });
+            }
+            return;
+        }
         if (endpoint.payloadExpr !== undefined && typeof endpoint.payloadExpr !== 'string') {
             diagnostics.push({
                 code: 'endpoint-global-action-payload-expr-invalid',
@@ -15587,9 +15607,7 @@ function validateEndpoint(endpoint, widgetKeys, diagnostics, path, allowGlobalAc
     }
     diagnostics.push({
         code: 'endpoint-kind-unsupported',
-        message: allowGlobalAction
-            ? 'Endpoint kind must be "component-port", "state" or "global-action".'
-            : 'Endpoint kind must be "component-port" or "state".',
+        message: 'Endpoint kind must be "component-port", "state" or "global-action".',
         path: `${path}.kind`,
     });
 }

package/package.json

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

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

@@ -1551,8 +1551,14 @@ type UiCompositionPlanGlobalActionEndpoint = {
     payloadExpr?: string;
     meta?: Record<string, unknown>;
 };
-type UiCompositionPlanSourceEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint;
-type UiCompositionPlanTargetEndpoint = UiCompositionPlanSourceEndpoint | UiCompositionPlanGlobalActionEndpoint;
+/**
+ * A runtime event source emitted through `dynamicPage.composition.dispatch`.
+ * Only actionId participates in canonical endpoint matching; payload is always
+ * supplied by the runtime dispatch event.
+ */
+type UiCompositionPlanGlobalActionSourceEndpoint = Pick<UiCompositionPlanGlobalActionEndpoint, 'kind' | 'actionId'>;
+type UiCompositionPlanSourceEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionSourceEndpoint;
+type UiCompositionPlanTargetEndpoint = UiCompositionPlanComponentPortEndpoint | UiCompositionPlanStateEndpoint | UiCompositionPlanGlobalActionEndpoint;
 type UiCompositionPlanEndpoint = UiCompositionPlanTargetEndpoint;
 type UiCompositionPlanTransform = {
     kind: 'pick-path';
@@ -2267,4 +2273,4 @@ declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
 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, preflightUiCompositionPlan, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, resolveUiCompositionPlanTemplate, 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, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanWidget, ValueKind };
+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, PageBuilderAuthoringCapabilities, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanAuthoringInput, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanContextScope, UiCompositionPlanContextScopeTarget, UiCompositionPlanContextValue, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanGlobalActionSourceEndpoint, UiCompositionPlanInputSource, UiCompositionPlanPreflightResult, UiCompositionPlanSelectionSync, UiCompositionPlanSelectionSyncMapping, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTemplateMaterialization, UiCompositionPlanTemplateRef, UiCompositionPlanTemplateReference, UiCompositionPlanTemplateResolutionResult, UiCompositionPlanTemplateRevision, UiCompositionPlanTransform, UiCompositionPlanWidget, ValueKind };