@praxisui/page-builder 9.0.0-beta.73 → 9.0.0-beta.74

package/README.md

@@ -115,6 +115,8 @@ const page: WidgetPageDefinition = {
 
 Use the same canonical `composition.links` contract for widget-to-widget links, nested component ports through `nestedPath`, and global actions through `to.kind = "global-action"`.
 
+Feedback cycles are validated before authoring and runtime delivery. Direct or indirect cycles across component ports and page state are reported as diagnostics; unguarded cycles are blocking in the core runtime and surfaced by the Connection Editor. Intentional feedback must be explicit by tagging every involved link with `metadata.tags: ['intentional-feedback']` and declaring a canonical guard such as `condition`, `policy.distinct`, `policy.distinctBy` or `policy.debounceMs`.
+
 ## Connection Editor
 
 The visual connection editor is an authoring surface over the saved `composition.links` document. It does not create a parallel graph DSL.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-12T01:34:40.567Z",
+  "generatedAt": "2026-07-16T21:05:04.797Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.0-beta.73",
+  "packageVersion": "9.0.0-beta.74",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,
@@ -547,6 +547,12 @@
           "valueKind": "string",
           "description": "Titulo opcional usado pelo host ao abrir o editor de inputs do componente."
         },
+        {
+          "path": "ComponentDocMeta.configEditor.contextResolver",
+          "category": "widgets",
+          "valueKind": "object",
+          "description": "Resolver canonico de contexto transiente para o editor; catálogos, schemas, capabilities, targets e diagnostics devem ser passados por context/contextDiagnostics e nao persistidos em definition.inputs."
+        },
         {
           "path": "ComponentDocMeta.authoringManifestRef",
           "category": "widgets",
@@ -3078,9 +3084,9 @@
         {
           "chunkIndex": 1,
           "chunkKind": "capabilities",
-          "content": "Component Capabilities:\n  - Path: uiCompositionPlan\n    Category: page\n    Kind: object\n    Description: Plano declarativo intermediario aceito em preview agentic antes do WidgetPageDefinition.\n  - Path: uiCompositionPlan.version\n    Category: page\n    Kind: string\n    Description: Versao do plano. Valor atual: 1.0.\n  - Path: uiCompositionPlan.kind\n    Category: page\n    Kind: string\n    Description: Discriminador do plano. Valor atual: praxis.ui-composition-plan.\n  - Path: uiCompositionPlan.layoutPreset\n    Category: layout\n    Kind: string\n    Description: Preset semantico opcional da composicao planejada.\n  - Path: uiCompositionPlan.layoutPresetOptions\n    Category: layout\n    Kind: object\n    Description: Opcoes semanticas opcionais do preset, como familia visual, estrategia responsiva e politica de densidade.\n  - Path: uiCompositionPlan.grouping\n    Category: layout\n    Kind: array\n    Description: Agrupamentos semanticos opcionais para organizar widgets em hero, section, tabs ou rail no runtime.\n  - Path: uiCompositionPlan.slotAssignments\n    Category: layout\n    Kind: object\n    Description: Mapa opcional widgetKey -> slot semantico para alinhar widgets gerados a presets de layout sem depender de dominio.\n  - Path: uiCompositionPlan.deviceLayouts\n    Category: layout\n    Kind: object\n    Description: Variantes responsivas opcionais para desktop, tablet e mobile, incluindo canvas, groupingOverrides e widgetOverrides.\n  - Path: uiCompositionPlan.themePreset\n    Category: layout\n    Kind: string\n    Description: Preset visual opcional do runtime, por exemplo analytics-calm, workspace-balanced ou ops-monitoring.\n  - Path: uiCompositionPlan.state\n    Category: state\n    Kind: object\n    Description: Estado inicial/declarativo que sera compilado para page.state.\n  - Path: uiCompositionPlan.widgets\n    Category: widgets\n    Kind: array\n    Description: Widgets planejados antes da compilacao para page.widgets.\n  - Path: uiCompositionPlan.widgets[].key\n    Category: widgets\n    Kind: string\n    Description: ID estavel do widget planejado.\n  - Path: uiCompositionPlan.widgets[].componentId\n    Category: widgets\n    Kind: string\n    Description: Componente registrado que sera compilado para definition.id.\n  - Path: uiCompositionPlan.widgets[].inputs\n    Category: widgets\n    Kind: object\n    Description: Inputs canonicos do componente, compilados para definition.inputs.\n  - Path: uiCompositionPlan.widgets[].bindingOrder\n    Category: widgets\n    Kind: array\n    Description: Ordem declarativa de binding, compilada para definition.bindingOrder.\n  - Path: uiCompositionPlan.bindings\n    Category: connections\n    Kind: array\n    Description: Bindings declarativos que serao compilados para page.composition.links.\n  - Path: uiCompositionPlan.bindings[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estavel do binding planejado.\n  - Path: uiCompositionPlan.bindings[].from\n    Category: connections\n    Kind: object\n    Description: Endpoint de origem: component-port ou state.\n  - Path: uiCompositionPlan.bindings[].to\n    Category: connections\n    Kind: object\n    Description: Endpoint de destino: component-port, state ou global-action.\n  - Path: uiCompositionPlan.bindings[].to.[actionId]\n    Category: connections\n    Kind: string\n    Description: ID da action global quando uiCompositionPlan.bindings[].to.kind = global-action.\n  - Path: uiCompositionPlan.bindings[].to.payload\n    Category: connections\n    Kind: object\n    Description: Payload literal opcional para destino global-action planejado.\n  - Path: uiCompositionPlan.bindings[].to.payloadExpr\n    Category: connections\n    Kind: string\n    Description: Path de payload opcional para destino global-action planejado.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath\n    Category: connections\n    Kind: array\n    Description: Caminho estruturado para porta nested de origem. Use apenas com endpoint component-port; o owner top-level continua em from.widget.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath\n    Category: connections\n    Kind: array\n    Description: Caminho estruturado para porta nested de destino. Use apenas com endpoint component-port; o owner top-level continua em to.widget.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].kind\n    Category: connections\n    Kind: string\n    Description: Tipo do segmento nested de origem, como tab, nav, link, expansion, panel ou widget. O ultimo segmento deve ser widget.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estrutural estavel do container de origem no segmento nested, quando existir.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de origem. Obrigatoria para endpoint nested persistido.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].index\n    Category: connections\n    Kind: number\n    Description: Indice auxiliar de origem para contexto visual/diagnostico; nao use como identidade primaria persistida.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].componentType\n    Category: connections\n    Kind: string\n    Description: Tipo do componente real do widget filho de origem, usado como verificacao auxiliar, nao como identidade primaria.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].kind\n    Category: connections\n    Kind: string\n    Description: Tipo do segmento nested de destino, como tab, nav, link, expansion, panel ou widget. O ultimo segmento deve ser widget.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estrutural estavel do container de destino no segmento nested, quando existir.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de destino. Obrigatoria para endpoint nested persistido.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].index\n    Category: connections\n    Kind: number\n    Description: Indice auxiliar de destino para contexto visual/diagnostico; nao use como identidade primaria persistida.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].componentType\n    Category: connections\n    Kind: string\n    Description: Tipo do componente real do widget filho de destino, usado como verificacao auxiliar, nao como identidade primaria.\n  - Path: uiCompositionPlan.bindings[].intent\n    Category: connections\n    Kind: string\n    Description: Intencao semantica do binding.\n  - Path: uiCompositionPlan.bindings[].condition\n    Category: connections\n    Kind: expression\n    Description: Guarda opcional em Json Logic.\n  - Path: uiCompositionPlan.bindings[].transform\n    Category: connections\n    Kind: object\n    Description: Transform declarativo: pick-path, query-context, template ou constant.\n  - Path: uiCompositionPlan.bindings[].policy\n    Category: connections\n    Kind: object\n    Description: Politica operacional opcional do binding.\n  - Path: page\n    Category: page\n    Kind: object\n    Description: Definicao da pagina (WidgetPageDefinition).\n  - Path: context\n    Category: context\n    Kind: object\n    Description: Contexto extra mesclado ao page.context.\n  - Path: enableCustomization\n    Category: behavior\n    Kind: boolean\n    Description: Habilita modo de edicao.\n  - Path: showSettingsButton\n    Category: behavior\n    Kind: boolean\n    Description: Exibe botao de settings.\n  - Path: strictValidation\n    Category: behavior\n    Kind: boolean\n    Description: Validacao estrita do widget loader.\n  - Path: layoutOptions\n    Category: layout\n    Kind: object\n    Description: Overrides residuais do host aceitos apenas para compatibilidade de migracao.\n  - Path: layoutOptions.cols\n    Category: layout\n    Kind: number\n    Description: Compat: numero de colunas usado para derivar canvas padrao.\n  - Path: layoutOptions.rowHeight\n    Category: layout\n    Kind: number\n    Description: Compat: altura de linha usada para derivar rowUnit do canvas.\n  - Path: layoutOptions.gap\n    Category: layout\n    Kind: number\n    Description: Compat: espacamento usado para derivar gap do canvas.\n  - Path: pageIdentity\n    Category: identity\n    Kind: object\n    Description: Identidade de persistencia da pagina.\n  - Path: pageIdentity.appId\n    Category: identity\n    Kind: string\n    Description: App id (opcional).\n  - Path: pageIdentity.tenantId\n    Category: identity\n    Kind: string\n    Description: Tenant id.\n  - Path: pageIdentity.userId\n    Category: identity\n    Kind: string\n    Description: User id.\n  - Path: pageIdentity.routePath\n    Category: identity\n    Kind: string\n    Description: Rota base da pagina.\n  - Path: pageIdentity.locale\n    Category: identity\n    Kind: string\n    Description: Locale.\n  - Path: page.canvas\n    Category: layout\n    Kind: object\n    Description: Canvas espacial canonico da pagina.\n  - Path: page.canvas.mode\n    Category: layout\n    Kind: string\n    Description: Modo do canvas. O builder usa grid canonico.\n  - Path: page.canvas.columns\n    Category: layout\n    Kind: number\n    Description: Numero de colunas do canvas.\n  - Path: page.canvas.rowUnit\n    Category: layout\n    Kind: string\n    Description: Altura base das linhas do canvas (ex: 80px).\n  - Path: page.canvas.gap\n    Category: layout\n    Kind: string\n    Description: Espacamento entre itens do canvas.\n  - Path: page.canvas.autoRows\n    Category: layout\n    Kind: string\n    Description: Politica de auto rows do canvas.\n  - Path: page.canvas.items\n    Category: layout\n    Kind: object\n    Description: Mapa canonico de posicionamento espacial por widget key.\n  - Path: page.canvas.items.<widgetKey>.col\n    Category: layout\n    Kind: number\n    Description: Coluna inicial (1-based).\n  - Path: page.canvas.items.<widgetKey>.row\n    Category: layout\n    Kind: number\n    Description: Linha inicial (1-based).\n  - Path: page.canvas.items.<widgetKey>.colSpan\n    Category: layout\n    Kind: number\n    Description: Colunas ocupadas.\n  - Path: page.canvas.items.<widgetKey>.rowSpan\n    Category: layout\n    Kind: number\n    Description: Linhas ocupadas.\n  - Path: page.state\n    Category: state\n    Kind: object\n    Description: Estado declarativo opcional da pagina.\n  - Path: page.state.values\n    Category: state\n    Kind: object\n    Description: Valores primarios persistiveis do estado da pagina.\n  - Path: page.state.schema\n    Category: state\n    Kind: object\n    Description: Descritores dos paths de estado primario.\n  - Path: page.state.derived\n    Category: state\n    Kind: object\n    Description: Descritores de estado derivado recomputado pelo runtime.\n  - Path: page.widgets\n    Category: widgets\n    Kind: array\n    Description: Widgets da pagina.\n  - Path: page.widgets[].key\n    Category: widgets\n    Kind: string\n    Description: ID unico do widget.\n  - Path: page.widgets[].className\n    Category: widgets\n    Kind: string\n    Description: Classe CSS do widget.\n  - Path: page.widgets[].definition\n    Category: widgets\n    Kind: object\n    Description: Definicao do widget (WidgetDefinition).\n  - Path: page.widgets[].definition.id\n    Category: widgets\n    Kind: string\n    Description: ID do componente registrado.\n  - Path: page.widgets[].definition.inputs\n    Category: widgets\n    Kind: object\n    Description: Inputs do componente.\n  - Path: page.widgets[].definition.inputs.document\n    Category: widgets\n    Kind: object\n    Description: RichContentDocument quando definition.id for praxis-rich-content.\n  - Path: page.widgets[].definition.bindingOrder\n    Category: widgets\n    Kind: array\n    Description: Ordem de aplicacao dos inputs.\n  - Path: ComponentDocMeta.configEditor\n    Category: widgets\n    Kind: object\n    Description: Editor canonico de inputs publicado pela lib dona do componente e aberto pelo settings-panel do host.\n  - Path: ComponentDocMeta.configEditor.component\n    Category: widgets\n    Kind: object\n    Description: Componente standalone que implementa SettingsValueProvider para editar definition.inputs.\n  - Path: ComponentDocMeta.configEditor.title\n    Category: widgets\n    Kind: string\n    Description: Titulo opcional usado pelo host ao abrir o editor de inputs do componente.\n  - Path: ComponentDocMeta.authoringManifestRef\n    Category: widgets\n    Kind: object\n    Description: Referencia canonica para o manifesto executavel de authoring por IA publicado pela lib dona do componente.\n  - Path: ComponentDocMeta.authoringManifestRef.componentId\n    Category: widgets\n    Kind: string\n    Description: ID do componente no registry/backend de manifestos de authoring.\n  - Path: ComponentDocMeta.authoringManifestRef.source\n    Category: widgets\n    Kind: string\n    Description: Simbolo, modulo ou registry id estavel do manifesto usado para delegar edicoes governadas.\n  - Path: page.composition\n    Category: connections\n    Kind: object\n    Description: Envelope canonico da composicao persistida.\n  - Path: page.composition.version\n    Category: connections\n    Kind: string\n    Description: Versao do envelope de composicao.\n  - Path: page.composition.links\n    Category: connections\n    Kind: array\n    Description: Links canonicos entre widgets, estado e actions globais.\n  - Path: page.composition.links[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estavel do link.\n  - Path: page.composition.links[].from\n    Category: connections\n    Kind: object\n    Description: Endpoint de origem do link.\n  - Path: page.composition.links[].to\n    Category: connections\n    Kind: object\n    Description: Endpoint de destino do link.\n  - Path: page.composition.links[].to.kind\n    Category: connections\n    Kind: string\n    Description: Tipo do endpoint de destino, incluindo global-action para command-dispatch declarativo.\n  - Path: page.composition.links[].to.ref.[actionId]\n    Category: connections\n    Kind: string\n    Description: ID da action global quando page.composition.links[].to.kind = global-action.\n  - Path: page.composition.links[].to.ref.payload\n    Category: connections\n    Kind: object\n    Description: Payload estruturado opcional da action global persistida; quando omitido, o valor transformado do link segue como delivery value.\n  - Path: page.composition.links[].to.ref.payloadExpr\n    Category: connections\n    Kind: expression\n    Description: Escape avancado explicito de payload da action global persistida.\n  - Path: page.composition.links[].to.ref.meta\n    Category: connections\n    Kind: object\n    Description: Metadados opcionais do GlobalActionRef persistido, sem criar executor paralelo.\n  - Path: page.composition.links[].from.ref.nestedPath\n    Category: connections\n    Kind: array\n    Description: NestedPath canonico em endpoint component-port de origem persistido. Omita para top-level; nao serialize nestedPath: [].\n  - Path: page.composition.links[].from.ref.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de origem. Obrigatoria para endpoint nested persistido.\n  - Path: page.composition.links[].to.ref.nestedPath\n    Category: connections\n    Kind: array\n    Description: NestedPath canonico em endpoint component-port de destino persistido. Omita para top-level; nao serialize nestedPath: [].\n  - Path: page.composition.links[].to.ref.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de destino. Obrigatoria para endpoint nested persistido.\n  - Path: page.composition.links[].intent\n    Category: connections\n    Kind: string\n    Description: Intencao semantica do link.\n  - Path: page.composition.links[].transform\n    Category: connections\n    Kind: object\n    Description: Pipeline de transformacao do link.\n  - Path: page.composition.links[].condition\n    Category: connections\n    Kind: expression\n    Description: Guarda semantica opcional do link, expressa como um unico AST Json Logic canonico.\n  - Path: page.composition.links[].policy\n    Category: connections\n    Kind: object\n    Description: Politicas operacionais opcionais do link, separadas da condition semantica.\n  - Path: page.composition.links[].metadata\n    Category: connections\n    Kind: object\n    Description: Metadados opcionais do link.\n  - Path: page.context\n    Category: context\n    Kind: object\n    Description: Contexto da pagina (compartilhado por widgets).\nCapability Notes:\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  - Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.\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  - 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  - Canvas e o modelo espacial canonico da pagina quando houver posicionamento explicito.\n  - Taxonomia editorial: condition usa Json Logic canonico; transform usa pipeline declarativo; policy cobre apenas comportamento operacional.\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  - UiCompositionPlan usa widgets[].componentId e bindings declarativos. O JSON persistido continua sendo page.widgets[].definition.id e page.composition.links.\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  - 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  - Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.\n  - pageIdentity identifica o escopo de persistencia e nao pertence ao objeto page.\n",
+          "content": "Component Capabilities:\n  - Path: uiCompositionPlan\n    Category: page\n    Kind: object\n    Description: Plano declarativo intermediario aceito em preview agentic antes do WidgetPageDefinition.\n  - Path: uiCompositionPlan.version\n    Category: page\n    Kind: string\n    Description: Versao do plano. Valor atual: 1.0.\n  - Path: uiCompositionPlan.kind\n    Category: page\n    Kind: string\n    Description: Discriminador do plano. Valor atual: praxis.ui-composition-plan.\n  - Path: uiCompositionPlan.layoutPreset\n    Category: layout\n    Kind: string\n    Description: Preset semantico opcional da composicao planejada.\n  - Path: uiCompositionPlan.layoutPresetOptions\n    Category: layout\n    Kind: object\n    Description: Opcoes semanticas opcionais do preset, como familia visual, estrategia responsiva e politica de densidade.\n  - Path: uiCompositionPlan.grouping\n    Category: layout\n    Kind: array\n    Description: Agrupamentos semanticos opcionais para organizar widgets em hero, section, tabs ou rail no runtime.\n  - Path: uiCompositionPlan.slotAssignments\n    Category: layout\n    Kind: object\n    Description: Mapa opcional widgetKey -> slot semantico para alinhar widgets gerados a presets de layout sem depender de dominio.\n  - Path: uiCompositionPlan.deviceLayouts\n    Category: layout\n    Kind: object\n    Description: Variantes responsivas opcionais para desktop, tablet e mobile, incluindo canvas, groupingOverrides e widgetOverrides.\n  - Path: uiCompositionPlan.themePreset\n    Category: layout\n    Kind: string\n    Description: Preset visual opcional do runtime, por exemplo analytics-calm, workspace-balanced ou ops-monitoring.\n  - Path: uiCompositionPlan.state\n    Category: state\n    Kind: object\n    Description: Estado inicial/declarativo que sera compilado para page.state.\n  - Path: uiCompositionPlan.widgets\n    Category: widgets\n    Kind: array\n    Description: Widgets planejados antes da compilacao para page.widgets.\n  - Path: uiCompositionPlan.widgets[].key\n    Category: widgets\n    Kind: string\n    Description: ID estavel do widget planejado.\n  - Path: uiCompositionPlan.widgets[].componentId\n    Category: widgets\n    Kind: string\n    Description: Componente registrado que sera compilado para definition.id.\n  - Path: uiCompositionPlan.widgets[].inputs\n    Category: widgets\n    Kind: object\n    Description: Inputs canonicos do componente, compilados para definition.inputs.\n  - Path: uiCompositionPlan.widgets[].bindingOrder\n    Category: widgets\n    Kind: array\n    Description: Ordem declarativa de binding, compilada para definition.bindingOrder.\n  - Path: uiCompositionPlan.bindings\n    Category: connections\n    Kind: array\n    Description: Bindings declarativos que serao compilados para page.composition.links.\n  - Path: uiCompositionPlan.bindings[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estavel do binding planejado.\n  - Path: uiCompositionPlan.bindings[].from\n    Category: connections\n    Kind: object\n    Description: Endpoint de origem: component-port ou state.\n  - Path: uiCompositionPlan.bindings[].to\n    Category: connections\n    Kind: object\n    Description: Endpoint de destino: component-port, state ou global-action.\n  - Path: uiCompositionPlan.bindings[].to.[actionId]\n    Category: connections\n    Kind: string\n    Description: ID da action global quando uiCompositionPlan.bindings[].to.kind = global-action.\n  - Path: uiCompositionPlan.bindings[].to.payload\n    Category: connections\n    Kind: object\n    Description: Payload literal opcional para destino global-action planejado.\n  - Path: uiCompositionPlan.bindings[].to.payloadExpr\n    Category: connections\n    Kind: string\n    Description: Path de payload opcional para destino global-action planejado.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath\n    Category: connections\n    Kind: array\n    Description: Caminho estruturado para porta nested de origem. Use apenas com endpoint component-port; o owner top-level continua em from.widget.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath\n    Category: connections\n    Kind: array\n    Description: Caminho estruturado para porta nested de destino. Use apenas com endpoint component-port; o owner top-level continua em to.widget.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].kind\n    Category: connections\n    Kind: string\n    Description: Tipo do segmento nested de origem, como tab, nav, link, expansion, panel ou widget. O ultimo segmento deve ser widget.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estrutural estavel do container de origem no segmento nested, quando existir.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de origem. Obrigatoria para endpoint nested persistido.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].index\n    Category: connections\n    Kind: number\n    Description: Indice auxiliar de origem para contexto visual/diagnostico; nao use como identidade primaria persistida.\n  - Path: uiCompositionPlan.bindings[].from.nestedPath[].componentType\n    Category: connections\n    Kind: string\n    Description: Tipo do componente real do widget filho de origem, usado como verificacao auxiliar, nao como identidade primaria.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].kind\n    Category: connections\n    Kind: string\n    Description: Tipo do segmento nested de destino, como tab, nav, link, expansion, panel ou widget. O ultimo segmento deve ser widget.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estrutural estavel do container de destino no segmento nested, quando existir.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de destino. Obrigatoria para endpoint nested persistido.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].index\n    Category: connections\n    Kind: number\n    Description: Indice auxiliar de destino para contexto visual/diagnostico; nao use como identidade primaria persistida.\n  - Path: uiCompositionPlan.bindings[].to.nestedPath[].componentType\n    Category: connections\n    Kind: string\n    Description: Tipo do componente real do widget filho de destino, usado como verificacao auxiliar, nao como identidade primaria.\n  - Path: uiCompositionPlan.bindings[].intent\n    Category: connections\n    Kind: string\n    Description: Intencao semantica do binding.\n  - Path: uiCompositionPlan.bindings[].condition\n    Category: connections\n    Kind: expression\n    Description: Guarda opcional em Json Logic.\n  - Path: uiCompositionPlan.bindings[].transform\n    Category: connections\n    Kind: object\n    Description: Transform declarativo: pick-path, query-context, template ou constant.\n  - Path: uiCompositionPlan.bindings[].policy\n    Category: connections\n    Kind: object\n    Description: Politica operacional opcional do binding.\n  - Path: page\n    Category: page\n    Kind: object\n    Description: Definicao da pagina (WidgetPageDefinition).\n  - Path: context\n    Category: context\n    Kind: object\n    Description: Contexto extra mesclado ao page.context.\n  - Path: enableCustomization\n    Category: behavior\n    Kind: boolean\n    Description: Habilita modo de edicao.\n  - Path: showSettingsButton\n    Category: behavior\n    Kind: boolean\n    Description: Exibe botao de settings.\n  - Path: strictValidation\n    Category: behavior\n    Kind: boolean\n    Description: Validacao estrita do widget loader.\n  - Path: layoutOptions\n    Category: layout\n    Kind: object\n    Description: Overrides residuais do host aceitos apenas para compatibilidade de migracao.\n  - Path: layoutOptions.cols\n    Category: layout\n    Kind: number\n    Description: Compat: numero de colunas usado para derivar canvas padrao.\n  - Path: layoutOptions.rowHeight\n    Category: layout\n    Kind: number\n    Description: Compat: altura de linha usada para derivar rowUnit do canvas.\n  - Path: layoutOptions.gap\n    Category: layout\n    Kind: number\n    Description: Compat: espacamento usado para derivar gap do canvas.\n  - Path: pageIdentity\n    Category: identity\n    Kind: object\n    Description: Identidade de persistencia da pagina.\n  - Path: pageIdentity.appId\n    Category: identity\n    Kind: string\n    Description: App id (opcional).\n  - Path: pageIdentity.tenantId\n    Category: identity\n    Kind: string\n    Description: Tenant id.\n  - Path: pageIdentity.userId\n    Category: identity\n    Kind: string\n    Description: User id.\n  - Path: pageIdentity.routePath\n    Category: identity\n    Kind: string\n    Description: Rota base da pagina.\n  - Path: pageIdentity.locale\n    Category: identity\n    Kind: string\n    Description: Locale.\n  - Path: page.canvas\n    Category: layout\n    Kind: object\n    Description: Canvas espacial canonico da pagina.\n  - Path: page.canvas.mode\n    Category: layout\n    Kind: string\n    Description: Modo do canvas. O builder usa grid canonico.\n  - Path: page.canvas.columns\n    Category: layout\n    Kind: number\n    Description: Numero de colunas do canvas.\n  - Path: page.canvas.rowUnit\n    Category: layout\n    Kind: string\n    Description: Altura base das linhas do canvas (ex: 80px).\n  - Path: page.canvas.gap\n    Category: layout\n    Kind: string\n    Description: Espacamento entre itens do canvas.\n  - Path: page.canvas.autoRows\n    Category: layout\n    Kind: string\n    Description: Politica de auto rows do canvas.\n  - Path: page.canvas.items\n    Category: layout\n    Kind: object\n    Description: Mapa canonico de posicionamento espacial por widget key.\n  - Path: page.canvas.items.<widgetKey>.col\n    Category: layout\n    Kind: number\n    Description: Coluna inicial (1-based).\n  - Path: page.canvas.items.<widgetKey>.row\n    Category: layout\n    Kind: number\n    Description: Linha inicial (1-based).\n  - Path: page.canvas.items.<widgetKey>.colSpan\n    Category: layout\n    Kind: number\n    Description: Colunas ocupadas.\n  - Path: page.canvas.items.<widgetKey>.rowSpan\n    Category: layout\n    Kind: number\n    Description: Linhas ocupadas.\n  - Path: page.state\n    Category: state\n    Kind: object\n    Description: Estado declarativo opcional da pagina.\n  - Path: page.state.values\n    Category: state\n    Kind: object\n    Description: Valores primarios persistiveis do estado da pagina.\n  - Path: page.state.schema\n    Category: state\n    Kind: object\n    Description: Descritores dos paths de estado primario.\n  - Path: page.state.derived\n    Category: state\n    Kind: object\n    Description: Descritores de estado derivado recomputado pelo runtime.\n  - Path: page.widgets\n    Category: widgets\n    Kind: array\n    Description: Widgets da pagina.\n  - Path: page.widgets[].key\n    Category: widgets\n    Kind: string\n    Description: ID unico do widget.\n  - Path: page.widgets[].className\n    Category: widgets\n    Kind: string\n    Description: Classe CSS do widget.\n  - Path: page.widgets[].definition\n    Category: widgets\n    Kind: object\n    Description: Definicao do widget (WidgetDefinition).\n  - Path: page.widgets[].definition.id\n    Category: widgets\n    Kind: string\n    Description: ID do componente registrado.\n  - Path: page.widgets[].definition.inputs\n    Category: widgets\n    Kind: object\n    Description: Inputs do componente.\n  - Path: page.widgets[].definition.inputs.document\n    Category: widgets\n    Kind: object\n    Description: RichContentDocument quando definition.id for praxis-rich-content.\n  - Path: page.widgets[].definition.bindingOrder\n    Category: widgets\n    Kind: array\n    Description: Ordem de aplicacao dos inputs.\n  - Path: ComponentDocMeta.configEditor\n    Category: widgets\n    Kind: object\n    Description: Editor canonico de inputs publicado pela lib dona do componente e aberto pelo settings-panel do host.\n  - Path: ComponentDocMeta.configEditor.component\n    Category: widgets\n    Kind: object\n    Description: Componente standalone que implementa SettingsValueProvider para editar definition.inputs.\n  - Path: ComponentDocMeta.configEditor.title\n    Category: widgets\n    Kind: string\n    Description: Titulo opcional usado pelo host ao abrir o editor de inputs do componente.\n  - Path: ComponentDocMeta.configEditor.contextResolver\n    Category: widgets\n    Kind: object\n    Description: Resolver canonico de contexto transiente para o editor; catálogos, schemas, capabilities, targets e diagnostics devem ser passados por context/contextDiagnostics e nao persistidos em definition.inputs.\n  - Path: ComponentDocMeta.authoringManifestRef\n    Category: widgets\n    Kind: object\n    Description: Referencia canonica para o manifesto executavel de authoring por IA publicado pela lib dona do componente.\n  - Path: ComponentDocMeta.authoringManifestRef.componentId\n    Category: widgets\n    Kind: string\n    Description: ID do componente no registry/backend de manifestos de authoring.\n  - Path: ComponentDocMeta.authoringManifestRef.source\n    Category: widgets\n    Kind: string\n    Description: Simbolo, modulo ou registry id estavel do manifesto usado para delegar edicoes governadas.\n  - Path: page.composition\n    Category: connections\n    Kind: object\n    Description: Envelope canonico da composicao persistida.\n  - Path: page.composition.version\n    Category: connections\n    Kind: string\n    Description: Versao do envelope de composicao.\n  - Path: page.composition.links\n    Category: connections\n    Kind: array\n    Description: Links canonicos entre widgets, estado e actions globais.\n  - Path: page.composition.links[].id\n    Category: connections\n    Kind: string\n    Description: Identificador estavel do link.\n  - Path: page.composition.links[].from\n    Category: connections\n    Kind: object\n    Description: Endpoint de origem do link.\n  - Path: page.composition.links[].to\n    Category: connections\n    Kind: object\n    Description: Endpoint de destino do link.\n  - Path: page.composition.links[].to.kind\n    Category: connections\n    Kind: string\n    Description: Tipo do endpoint de destino, incluindo global-action para command-dispatch declarativo.\n  - Path: page.composition.links[].to.ref.[actionId]\n    Category: connections\n    Kind: string\n    Description: ID da action global quando page.composition.links[].to.kind = global-action.\n  - Path: page.composition.links[].to.ref.payload\n    Category: connections\n    Kind: object\n    Description: Payload estruturado opcional da action global persistida; quando omitido, o valor transformado do link segue como delivery value.\n  - Path: page.composition.links[].to.ref.payloadExpr\n    Category: connections\n    Kind: expression\n    Description: Escape avancado explicito de payload da action global persistida.\n  - Path: page.composition.links[].to.ref.meta\n    Category: connections\n    Kind: object\n    Description: Metadados opcionais do GlobalActionRef persistido, sem criar executor paralelo.\n  - Path: page.composition.links[].from.ref.nestedPath\n    Category: connections\n    Kind: array\n    Description: NestedPath canonico em endpoint component-port de origem persistido. Omita para top-level; nao serialize nestedPath: [].\n  - Path: page.composition.links[].from.ref.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de origem. Obrigatoria para endpoint nested persistido.\n  - Path: page.composition.links[].to.ref.nestedPath\n    Category: connections\n    Kind: array\n    Description: NestedPath canonico em endpoint component-port de destino persistido. Omita para top-level; nao serialize nestedPath: [].\n  - Path: page.composition.links[].to.ref.nestedPath[].key\n    Category: connections\n    Kind: string\n    Description: Chave estavel do widget filho no segmento terminal widget de destino. Obrigatoria para endpoint nested persistido.\n  - Path: page.composition.links[].intent\n    Category: connections\n    Kind: string\n    Description: Intencao semantica do link.\n  - Path: page.composition.links[].transform\n    Category: connections\n    Kind: object\n    Description: Pipeline de transformacao do link.\n  - Path: page.composition.links[].condition\n    Category: connections\n    Kind: expression\n    Description: Guarda semantica opcional do link, expressa como um unico AST Json Logic canonico.\n  - Path: page.composition.links[].policy\n    Category: connections\n    Kind: object\n    Description: Politicas operacionais opcionais do link, separadas da condition semantica.\n  - Path: page.composition.links[].metadata\n    Category: connections\n    Kind: object\n    Description: Metadados opcionais do link.\n  - Path: page.context\n    Category: context\n    Kind: object\n    Description: Contexto da pagina (compartilhado por widgets).\nCapability Notes:\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  - Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.\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  - 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  - Canvas e o modelo espacial canonico da pagina quando houver posicionamento explicito.\n  - Taxonomia editorial: condition usa Json Logic canonico; transform usa pipeline declarativo; policy cobre apenas comportamento operacional.\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  - UiCompositionPlan usa widgets[].componentId e bindings declarativos. O JSON persistido continua sendo page.widgets[].definition.id e page.composition.links.\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  - 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  - Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.\n  - pageIdentity identifica o escopo de persistencia e nao pertence ao objeto page.\n",
           "sourcePointer": "projects/praxis-page-builder/src/lib/ai/page-builder-ai-capabilities.ts",
-          "contentHash": "4b4fa6a061fc733eaa82674d8a7990539be7809df4d09dddf93834493f222ff3",
+          "contentHash": "bad700bb7c68cae5b4012ec8ca7fc79d0e45abf8e6afd1c705871dac70c8bfe2",
           "sourceKind": "component_definition",
           "sourceId": "praxis-page-builder",
           "corpusVersion": "1.0.0"