@praxisui/core 9.0.27 → 9.0.29

package/README.md

@@ -193,6 +193,13 @@ export class PageComponent {
 
 Use `page.composition.links` for persisted wiring. `page.connections` is legacy/residual and should not be used for new pages or examples. Nested component ports should use `component-port` endpoints with `ref.nestedPath`.
 
+When a host enables dynamic-page customization, it can pass a transient
+`WidgetPageAuthoringCapabilities` grant through `authoringCapabilities` to expose only the canvas,
+page settings, widget shell, component-input, removal and child-customization operations that the
+host actually supports. Omitted entries preserve full authoring for backward compatibility. This
+grant controls visible authoring operations only: it is not persisted in `WidgetPageDefinition` and
+does not replace component manifests, backend capabilities, authorization or validation.
+
 Page-owned business copy can use `page.i18n` plus explicit `PraxisTextValue`
 descriptors inside widget shells or nested widget inputs. The runtime resolves
 those descriptors only in its render projection, so the authored and persisted

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-28T01:18:20.814Z",
+  "generatedAt": "2026-08-28T12:49:04.203Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.27",
+  "packageVersion": "9.0.29",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -480,6 +480,12 @@
           "required": false,
           "description": "Habilita affordances de edição na página."
         },
+        {
+          "name": "authoringCapabilities",
+          "type": "WidgetPageAuthoringCapabilities",
+          "required": false,
+          "description": "Restringe granularmente as operações de authoring permitidas pelo host."
+        },
         {
           "name": "showPageSettingsButton",
           "type": "boolean",
@@ -1938,6 +1944,7 @@
         "Nao gere links nested via owner.widgetEvent, bindingPath profundo, page.connections ou wrappers host-specific. widgetEvent e bridge legada/avancada, nao contrato principal de authoring.",
         "Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.",
         "pageIdentity identifica o escopo de persistencia e nao pertence ao objeto page.",
+        "authoringCapabilities é um grant transitório do host para limitar affordances visíveis; não integra WidgetPageDefinition, não é persistido e não concede autoridade de edição à IA.",
         "Este catálogo é específico para o runtime praxis-dynamic-page; operações de authoring/mutação pertencem ao manifesto do praxis-page-builder.",
         "WidgetPageDefinition e o contrato canonico persistido: widgets, composition.links, state, context, i18n, layout, canvas, presets, grouping, slotAssignments, deviceLayouts e themePreset.",
         "Widgets e page.composition.links sao arrays; ferramentas de patch legadas fazem merge por key estavel e id estavel.",
@@ -2981,9 +2988,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-dynamic-page\nSelector: praxis-dynamic-page\nFriendly Name: Dynamic Page\nDescription: Página dinâmica com widgets e composition.links em layout responsivo, incluindo mediação runtime para rich-content hospedado.\nCategory: page\nLib/Package: @praxisui/core\nTags: widget, page, dynamic, layout\nInputs:\n  - page (WidgetPageDefinition)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - enableCustomization (boolean)\n  - showPageSettingsButton (boolean)\n  - shellEditorComponent (Type<any>)\n  - pageEditorComponent (Type<any>)\n  - autoPersist (boolean)\n  - pageIdentity (PageIdentity)\n  - componentInstanceId (string)\nOutputs:\n  - pageChange (WidgetPageDefinition)\n  - widgetEvent (WidgetEventEnvelope)\n  - widgetDiagnosticsChange (Record<string, WidgetResolutionDiagnostic>)\n",
+          "content": "Component ID: praxis-dynamic-page\nSelector: praxis-dynamic-page\nFriendly Name: Dynamic Page\nDescription: Página dinâmica com widgets e composition.links em layout responsivo, incluindo mediação runtime para rich-content hospedado.\nCategory: page\nLib/Package: @praxisui/core\nTags: widget, page, dynamic, layout\nInputs:\n  - page (WidgetPageDefinition)\n  - context (Record<string, any>)\n  - strictValidation (boolean)\n  - enableCustomization (boolean)\n  - authoringCapabilities (WidgetPageAuthoringCapabilities)\n  - showPageSettingsButton (boolean)\n  - shellEditorComponent (Type<any>)\n  - pageEditorComponent (Type<any>)\n  - autoPersist (boolean)\n  - pageIdentity (PageIdentity)\n  - componentInstanceId (string)\nOutputs:\n  - pageChange (WidgetPageDefinition)\n  - widgetEvent (WidgetEventEnvelope)\n  - widgetDiagnosticsChange (Record<string, WidgetResolutionDiagnostic>)\n",
           "sourcePointer": "projects/praxis-core/src/lib/widgets/dynamic-widget-page.metadata.ts",
-          "contentHash": "7575dbf241f37111a9acc2367fc82ced61f9ddf28586125b3a3b346d35a1fb7a",
+          "contentHash": "27a7ae1a0c39ca506ccadd06b095f4370d5e57e34558965fbd40da1d82b3143d",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-page",
           "corpusVersion": "1.0.0"
@@ -3041,9 +3048,9 @@
         {
           "chunkIndex": 6,
           "chunkKind": "capabilities",
-          "content": "Component Capability:\n  - Path: page.deviceLayouts.mobile.widgetOverrides.<widgetKey>.hidden\n    Category: layout\n    Kind: boolean\n    Description: Oculta o widget em mobile.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - Canvas e o modelo espacial canonico da pagina quando houver posicionamento explicito.\n\nCapability Note:\n  - Taxonomia editorial: condition usa Json Logic canonico; transform usa pipeline declarativo; policy cobre apenas comportamento operacional.\n\nCapability Note:\n  - Para criacao agentic de paginas, o preview pode trazer uiCompositionPlan como plano intermediario validavel; o page-builder compila esse plano para WidgetPageDefinition antes de aplicar.\n\nCapability Note:\n  - UiCompositionPlan usa widgets[].componentId e bindings declarativos. UiCompositionPlanTemplateReference pode piná-lo por registryKey + configSha256, mas precisa ser resolvido pelo backend governado antes da compilação. O JSON persistido continua sendo page.widgets[].definition.id e page.composition.links.\n\nCapability Note:\n  - Nested component ports usam endpoint component-port com nestedPath. O owner em ref.widget ou bindings[].*.widget continua sendo o widget top-level; a porta real do filho fica em port/direction e o caminho ate o filho fica em nestedPath.\n\nCapability Note:\n  - Nao gere links nested via owner.widgetEvent, bindingPath profundo, page.connections ou wrappers host-specific. widgetEvent e bridge legada/avancada, nao contrato principal de authoring.\n\nCapability Note:\n  - Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.\n\nCapability Note:\n  - pageIdentity identifica o escopo de persistencia e nao pertence ao objeto page.\n\nCapability Note:\n  - Este catálogo é específico para o runtime praxis-dynamic-page; operações de authoring/mutação pertencem ao manifesto do praxis-page-builder.\n\nCapability Note:\n  - WidgetPageDefinition e o contrato canonico persistido: widgets, composition.links, state, context, i18n, layout, canvas, presets, grouping, slotAssignments, deviceLayouts e themePreset.\n\nCapability Note:\n  - Widgets e page.composition.links sao arrays; ferramentas de patch legadas fazem merge por key estavel e id estavel.\n\nCapability Note:\n  - page.canvas.items é um mapa por widget key; não modele canvas.items como array.\n\nCapability Note:\n  - Taxonomia editorial: condition usa Json Logic canônico; transform usa pipeline declarativo; não trate ambos como a mesma \"expression\".\n\nCapability Note:\n  - Para remocao/replace, use flags {_remove:true} ou {_replace:true} no item.\n\nCapability Note:\n  - Para renomear um link, inclua {_beforeKey:\"link-id-anterior\"} no item.\n\nCapability Note:\n  - Inputs de widgets dependem do componente (ex: praxis-table, praxis-dynamic-form). Evite inventar campos; prefira pedir confirmação.\n\nCapability Note:\n  - Quando page.widgets[].definition.id for praxis-rich-content, o host praxis-dynamic-page injeta hostCapabilities em runtime para actions e capability gating; não serialize funções nem tente persistir page.widgets[].definition.inputs.hostCapabilities.\n\nCapability Note:\n  - Use ids estaveis para links e keys estaveis para widgets.\n\nCapability Note:\n  - Nested component ports usam endpoint component-port com nestedPath; o owner em ref.widget continua sendo o widget top-level.\n\nCapability Note:\n  - Objetivo: compor widgets e relacionamentos canonicos (ex.: master-detail).\n\nCapability Note:\n  - Link tipico de master-detail: component-port(table.rowClick) -> component-port(form.resourceId) com transform map payload.row.id.",
+          "content": "Component Capability:\n  - Path: page.deviceLayouts.mobile.widgetOverrides.<widgetKey>.hidden\n    Category: layout\n    Kind: boolean\n    Description: Oculta o widget em mobile.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - 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.\n\nCapability Note:\n  - Canvas e o modelo espacial canonico da pagina quando houver posicionamento explicito.\n\nCapability Note:\n  - Taxonomia editorial: condition usa Json Logic canonico; transform usa pipeline declarativo; policy cobre apenas comportamento operacional.\n\nCapability Note:\n  - Para criacao agentic de paginas, o preview pode trazer uiCompositionPlan como plano intermediario validavel; o page-builder compila esse plano para WidgetPageDefinition antes de aplicar.\n\nCapability Note:\n  - UiCompositionPlan usa widgets[].componentId e bindings declarativos. UiCompositionPlanTemplateReference pode piná-lo por registryKey + configSha256, mas precisa ser resolvido pelo backend governado antes da compilação. O JSON persistido continua sendo page.widgets[].definition.id e page.composition.links.\n\nCapability Note:\n  - Nested component ports usam endpoint component-port com nestedPath. O owner em ref.widget ou bindings[].*.widget continua sendo o widget top-level; a porta real do filho fica em port/direction e o caminho ate o filho fica em nestedPath.\n\nCapability Note:\n  - Nao gere links nested via owner.widgetEvent, bindingPath profundo, page.connections ou wrappers host-specific. widgetEvent e bridge legada/avancada, nao contrato principal de authoring.\n\nCapability Note:\n  - Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.\n\nCapability Note:\n  - pageIdentity identifica o escopo de persistencia e nao pertence ao objeto page.\n\nCapability Note:\n  - authoringCapabilities é um grant transitório do host para limitar affordances visíveis; não integra WidgetPageDefinition, não é persistido e não concede autoridade de edição à IA.\n\nCapability Note:\n  - Este catálogo é específico para o runtime praxis-dynamic-page; operações de authoring/mutação pertencem ao manifesto do praxis-page-builder.\n\nCapability Note:\n  - WidgetPageDefinition e o contrato canonico persistido: widgets, composition.links, state, context, i18n, layout, canvas, presets, grouping, slotAssignments, deviceLayouts e themePreset.\n\nCapability Note:\n  - Widgets e page.composition.links sao arrays; ferramentas de patch legadas fazem merge por key estavel e id estavel.\n\nCapability Note:\n  - page.canvas.items é um mapa por widget key; não modele canvas.items como array.\n\nCapability Note:\n  - Taxonomia editorial: condition usa Json Logic canônico; transform usa pipeline declarativo; não trate ambos como a mesma \"expression\".\n\nCapability Note:\n  - Para remocao/replace, use flags {_remove:true} ou {_replace:true} no item.\n\nCapability Note:\n  - Para renomear um link, inclua {_beforeKey:\"link-id-anterior\"} no item.\n\nCapability Note:\n  - Inputs de widgets dependem do componente (ex: praxis-table, praxis-dynamic-form). Evite inventar campos; prefira pedir confirmação.\n\nCapability Note:\n  - Quando page.widgets[].definition.id for praxis-rich-content, o host praxis-dynamic-page injeta hostCapabilities em runtime para actions e capability gating; não serialize funções nem tente persistir page.widgets[].definition.inputs.hostCapabilities.\n\nCapability Note:\n  - Use ids estaveis para links e keys estaveis para widgets.\n\nCapability Note:\n  - Nested component ports usam endpoint component-port com nestedPath; o owner em ref.widget continua sendo o widget top-level.\n\nCapability Note:\n  - Objetivo: compor widgets e relacionamentos canonicos (ex.: master-detail).\n\nCapability Note:\n  - Link tipico de master-detail: component-port(table.rowClick) -> component-port(form.resourceId) com transform map payload.row.id.",
           "sourcePointer": "projects/praxis-core/src/lib/ai/dynamic-page-ai-capabilities.ts",
-          "contentHash": "8c2505b24e90fa2a568ab51e9ba82bd22360fb10f9deee8e2ff18f50a0caaed0",
+          "contentHash": "56c5c10d5c3f63e96f2da523775d1549bf1fa8d0f6ab49007ab76d1731520138",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-page",
           "corpusVersion": "1.0.0"