@praxisui/settings-panel 8.0.0-beta.8 → 8.0.0-beta.81

package/README.md

@@ -155,6 +155,7 @@ Regra de integracao:
   - `config.persistSizeKey?: string`
   - `config.minWidth?: string`
   - `config.maxWidth?: string`
+  - `config.diagnostics?: SettingsPanelDiagnosticsConfig`
   - `config.content: { component: Type<any>; inputs?: Record<string, any> }`
 
 ### Ref
@@ -196,6 +197,48 @@ Opcionais:
 - `customActions$?`
 - `hideDefaultButtons$?`
 
+## Agentic Authoring Contract
+
+`praxis-settings-panel` publica um manifesto executavel em `PRAXIS_SETTINGS_PANEL_AUTHORING_MANIFEST`.
+
+Esse contrato governa somente o shell autoral:
+
+- identidade e titulo do painel
+- modo de abertura e substituicao mediada por `onBeforeClose`
+- largura, resize e persistencia de tamanho
+- comportamento de `Apply`
+- comportamento de `Save`
+- comportamento de `Reset`
+- envelope do editor hospedado
+- diagnosticos baseados em `dirty`, `valid` e `busy`
+
+O manifesto nao define semantica de `FormConfig`, `TableConfig`, `ListConfig` ou qualquer outro documento de consumidor. Quando a intencao do usuario alterar a configuracao interna de um editor hospedado, a operacao deve ser delegada para o manifesto do componente dono daquele documento.
+
+Regras do contrato:
+
+- `Apply` emite `applied$` com `getSettingsValue()` e nao fecha o painel.
+- `Save` usa `onSave()` quando existir, usa `getSettingsValue()` como fallback, emite `saved$` e fecha com motivo `save`.
+- `Reset` e destrutivo, exige confirmacao, chama `reset()` quando existir e emite `reset$`.
+- `Apply` e `Save` continuam bloqueados por `dirty=false`, `valid=false` ou `busy=true`.
+- O editor hospedado deve implementar `SettingsValueProvider` quando o fluxo for autoral.
+- Inputs persistidos do editor devem permanecer serializaveis.
+- `diagnostics` controla somente a visibilidade dos diagnosticos do shell (`statusMessage`, motivo de desabilitacao, busy e estado invalido); ele nao altera as regras de bloqueio de `Apply`/`Save`.
+
+### Diagnostics
+
+`SettingsPanelConfig.diagnostics` e opcional e preserva o comportamento historico quando omitido:
+
+```ts
+{
+  showStatusMessage?: boolean;
+  showDisabledReason?: boolean;
+  showBusyState?: boolean;
+  exposeValidationState?: boolean;
+}
+```
+
+Use essa configuracao para ajustar a superficie visual do shell autoral. O estado canonico continua vindo de `SettingsValueProvider.isDirty$`, `isValid$` e `isBusy$`.
+
 ### `onBeforeClose`
 
 `onBeforeClose` pertence ao contrato canonico de authoring. Ele pode: