Adicionado documentação dos componentes de Vitruvio.

Vitruvio/Documentação/eventos-vitruvio.md

@@ -0,0 +1,50 @@
+# Eventos Vitruvio
+
+## valueChange
+Quando usar:
+- Mudanca de filtros (`DateField`, `DBComboBox`, `DBTable` de selecao).
+
+Padrao:
+```javascript
+function run() {
+   engine.getField('dbtLojas').refresh();
+   engine.getField('dbtRevisao').refresh();
+}
+```
+
+## itemChange (DBTable editavel)
+Quando usar:
+- Persistencia de alteracao de celula editavel (`TRANSFERENCIA`).
+
+Padrao:
+- Validar negativo, multiplo CD e saldo.
+- Gravar no banco.
+- `event.commit();`
+- Atualizar tabelas relacionadas (`refresh`).
+
+## onClickScript (ButtonWidget)
+Quando usar:
+- Acao principal (geracao, envio, processamento).
+
+Padrao:
+```javascript
+function run() {
+   engine.getGlobalVariable('gerarTransferencias')();
+}
+```
+
+## TabChangeScript
+Quando usar:
+- Alternancia entre abas com dados diferentes.
+
+Padrao:
+- Ajustar visibilidade de botoes.
+- Recarregar widgets dependentes da aba atual.
+
+## initScript
+Quando usar:
+- Inicializacao de valores padrao e registro de globais.
+
+Padrao:
+- `engine.setGlobalVariable('nome', funcao);`
+- Definir periodo inicial e filtros de origem/fornecedor.