@meistrari/minuta-react 1.0.0 → 1.1.0

package/README.md

@@ -36,13 +36,16 @@ um `Blob` de `.docx`. Buscar o documento, persistir a edição e baixar o arquiv
 | `variables` | — | catálogo `{ key, label, description?, group? }[]` → liga o modo template |
 | `uploadImage` | — | `(file) => Promise<{ src, vaultSrc } \| null>` |
 | `toolbar` | `true` | `false` = você monta a sua sobre `ref.current.tiptap` |
+| `blockClickWhileEditing` | `false` | dispara `onBlockClick` também em edição (padrão: só em leitura) |
 | `onChange` | — | `(html) => void`, a cada edição |
 | `onTransaction` | — | qualquer transação, inclusive só de seleção — para toolbar própria |
 | `onReady`, `onEditChrome`, `onBlockClick`, `onError` | — | |
 
 O `ref` entrega a instância do editor: `getHTML()`, `exportDocx()` (→ `Blob`),
 `usedVariables()`, `setEditable()`, `setChrome()`, `tiptap` (a instância do
-Tiptap — escotilha de fuga), `root`/`container`/`sheet` (os elementos).
+Tiptap — escotilha de fuga), `root`/`container`/`sheet` (os elementos) — e a
+ponte formulário ↔ documento: `scrollToVariable()`, `setVariableValue()`,
+`setVariableImage()`, `variablesInDocument()` (abaixo).
 
 ### Por que o `html` é lido uma vez
 
@@ -123,6 +126,34 @@ edição criada a partir de HTML já resolvido (sem marcas) a ponte não existe,
 é melhor saber antes de montar a tela do que descobrir com
 `variablesInDocument()` vazio.
 
+### O que é marcado, e com que id
+
+| no template | no HTML | id da marca |
+|---|---|---|
+| `<variable name="comarca">` | `<span data-variable-id data-parent-block-id>` (chip) | `comarca` |
+| variável `compute` | idem — o valor é calculado antes do render | o id da compute |
+| `<for item="c" in="contratos"> <variable name="c.numero">` | um chip por linha, com `data-variable-index` | `contratos[0].numero`, `contratos[1].numero`… |
+| `<img variable="img_doc">` com valor | `<img data-variable-id data-parent-block-id>` | `img_doc` |
+| `<img variable="img_doc">` sem valor | aviso `missing-image-warning` (nó `missingImage` no editor) | `img_doc` |
+| cada bloco do template | `<div data-minuta-block data-block-id data-block-title>` | `data-block-id` = id do bloco no `templateSpec` |
+
+Variável de texto **sem valor** sai como aviso (`data-invalid-variable`), não
+como chip, e não entra em `markedVariables`. Booleans não viram marca: eles
+decidem se um trecho ou bloco é emitido; a regra fica em `displayCondition` e
+nos `<if condition>` do template (podem envolver várias variáveis).
+
+```tsx
+// array: uma linha de cada vez
+editor.current!.setVariableValue('contratos[1].numero', '375586874')
+
+// imagem: troca a existente, ou transforma o aviso de "faltando" em imagem
+editor.current!.setVariableImage('img_doc', urlAssinada)        // → nº de ocorrências
+editor.current!.scrollToVariable('img_faltando')                 // acha o aviso também
+
+// bloco: com blockClickWhileEditing o clique em edição também avisa
+<MinutaEditor blockClickWhileEditing onBlockClick={id => openChecklistBlock(id)} … />
+```
+
 Sobre o fluxo de "enviar variáveis de volta": com uma edição viva o documento
 **é** a edição — o `PATCH` de variáveis no case não re-renderiza a peça (senão
 apagaria o texto do advogado). Ou o formulário trava quando a lapidação começa

package/dist/index.d.mts

@@ -35,6 +35,8 @@ interface MinutaEditorProps {
     /** barra de formatação do pacote (default: true). `false` = monte a sua sobre `ref.tiptap` */
     toolbar?: boolean;
     showBlockOrigin?: boolean;
+    /** dispara `onBlockClick` também em edição (padrão: só em leitura) */
+    blockClickWhileEditing?: boolean;
     onReady?: MinutaEditorOptions['onReady'];
     /** o documento mudou por edição — recebe o HTML atual */
     onChange?: (html: string) => void;

package/dist/index.d.ts

@@ -35,6 +35,8 @@ interface MinutaEditorProps {
     /** barra de formatação do pacote (default: true). `false` = monte a sua sobre `ref.tiptap` */
     toolbar?: boolean;
     showBlockOrigin?: boolean;
+    /** dispara `onBlockClick` também em edição (padrão: só em leitura) */
+    blockClickWhileEditing?: boolean;
     onReady?: MinutaEditorOptions['onReady'];
     /** o documento mudou por edição — recebe o HTML atual */
     onChange?: (html: string) => void;

package/dist/index.mjs

@@ -23,6 +23,7 @@ const MinutaEditor = forwardRef((props, ref) => {
       uploadImage: (file) => callbacks.current.uploadImage ? callbacks.current.uploadImage(file) : Promise.resolve(null),
       toolbar: props.toolbar,
       showBlockOrigin: props.showBlockOrigin,
+      blockClickWhileEditing: props.blockClickWhileEditing,
       onReady: (tiptap) => callbacks.current.onReady?.(tiptap),
       onChange: () => callbacks.current.onChange?.(editor.getHTML()),
       onTransaction: () => callbacks.current.onTransaction?.(),
@@ -60,6 +61,9 @@ const MinutaEditor = forwardRef((props, ref) => {
   useEffect(() => {
     instance.current?.setShowBlockOrigin(props.showBlockOrigin !== false);
   }, [props.showBlockOrigin]);
+  useEffect(() => {
+    instance.current?.setBlockClickWhileEditing(props.blockClickWhileEditing === true);
+  }, [props.blockClickWhileEditing]);
   useImperativeHandle(ref, () => instance.current);
   return createElement("div", {
     ref: host,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/minuta-react",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Componente React do editor de minuta do defesa.ai — casca fina sobre @meistrari/minuta-editor",
   "repository": {
     "type": "git",