@praxisui/stepper 8.0.0-beta.2 → 8.0.0-beta.21

package/README.md

@@ -195,9 +195,43 @@ validateStep = async ({ step, formGroup, formData }) => {
 
 - Componentes: `PraxisStepper`, `PraxisStepperConfigEditor`
 - Tipos: `StepperMetadata`, `StepConfig`, `StepOrientation`, `StepHeaderPosition`
+- Authoring AI: `PRAXIS_STEPPER_AUTHORING_MANIFEST`
 - Eventos: `selectedIndexChange`, `selectionChange`, `widgetEvent`, `animationDone`, `stepFormReady`, `stepFormValueChange`
 - Veja: `projects/praxis-stepper/src/public-api.ts`
 
+## Agentic Authoring
+
+O contrato executavel de authoring fica em `PRAXIS_STEPPER_AUTHORING_MANIFEST`.
+Ele modela edicoes em `StepperMetadata` por operacoes atomicas sobre etapas,
+navegacao, orientacao, estados de conclusao e validacao.
+
+Quando `enableCustomization` esta ativo, o runtime abre o `PraxisAiAssistantShellComponent`
+com contexto semantico do stepper e registra a sessao no dock global de assistentes.
+O assistente envia estado atual, perfil das etapas, campos de schema e referencia ao
+manifesto de authoring para a IA. Patches JSON livres nao sao aplicados no runtime:
+mudancas locais devem nascer de um `componentEditPlan` validado pelo manifesto, e
+regras compartilhadas seguem por `domain-rules/intake`.
+
+Cobertura principal:
+
+- `step.add`, `step.remove`, `step.label.set`, `step.order.set`
+- `step.optional.set`, `step.completed.set`
+- `navigation.mode.set`
+- `orientation.set`
+- `validation.rule.add`
+- `step.content.set`
+
+As operacoes preservam `steps[].id` como identidade canonica. Remover uma
+etapa com formulario, rich content ou widgets exige confirmacao explicita. Regras
+de validacao devem ser projetadas em `steps[].form.config` ou delegadas ao
+`serverValidate` do host; o stepper nao define uma DSL paralela de validacao.
+
+Cada operacao declara `target.resolver`, `preconditions`, `validators`,
+`affectedPaths`, `effects` e `submissionImpact` tipado. Edicoes de conteudo de
+etapa podem afetar dados schema-backed porque `steps[].form.config` hospeda o
+`FormConfig` do `praxis-dynamic-form`; widgets filhos continuam governados pelos
+contratos dos respectivos componentes.
+
 ## Conteudo Editorial por Etapa
 
 O conteudo editorial do stepper usa a mesma base de rich content da plataforma: