@meistrari/minuta-react 1.3.0 → 1.4.0

package/README.md

@@ -73,6 +73,28 @@ const t = editor.current?.tiptap
 <MinutaEditor ref={editor} html={html} toolbar={false} onTransaction={rerender} />
 ```
 
+### Numerar parágrafo
+
+O número dos parágrafos da peça ("12. A Ré…") é um nó próprio, não texto:
+continua a sequência do template e sai como numeração nativa no Word. Com a
+toolbar do pacote há o botão **1.**; numa toolbar própria:
+
+```tsx
+import { hasLeadingTopicNumber, toggleTopicNumber } from '@meistrari/minuta-react'
+
+// `editor.current` é null até o mount: proteja a leitura no render
+const tiptap = editor.current?.tiptap
+<Button type={tiptap && hasLeadingTopicNumber(tiptap) ? 'primary' : 'default'}
+        onClick={() => tiptap && toggleTopicNumber(tiptap)}>1.</Button>
+```
+
+(`toggleTopicNumber` equivale a `tiptap.chain().focus().toggleTopicNumber().run()`;
+há também `setTopicNumber()` e `unsetTopicNumber()`.) Enter no fim de um
+parágrafo numerado já cria o seguinte numerado, sem botão. **Não** use a
+"lista numerada" (`toggleOrderedList`) para isso: ela cria uma lista com recuo
+próprio, fora da sequência da peça.
+
+
 Os tipos de `chain().toggleBold()` viajam com o pacote — não precisa importar
 `@tiptap/*` no seu código.
 
@@ -185,6 +207,26 @@ Sobre o fluxo de "enviar variáveis de volta": com uma edição viva o documento
 modelo do defesa.ai), ou você mantém os dois vivos com `setVariableValue` +
 salva a edição. Decisão de UX do seu app; as duas funcionam.
 
+### Voltar ao checklist sem perder a edição
+
+Esqueceu uma tese ou variável no meio da edição? Mude o caso (`PATCH
+/data/case/:id`), busque o documento que o checklist gera agora e aplique sobre
+o texto editado — só o que mudou entra, e trecho que o advogado editou vira
+pergunta em vez de ser sobrescrito:
+
+```tsx
+const { html } = await api.get(`/data/case/${caseId}/html?source=blocks`)
+const result = editor.current!.applyChecklist(html)
+for (const c of result.conflicts) // 'replace' | 'remove' — a UI é sua
+    editor.current!.resolveChecklistConflict(c.blockId, 'keep' /* ou 'apply' */)
+// DEPOIS das decisões: bloco inserido ou aceito pode trazer imagem vault://
+await editor.current!.refreshVaultImages(resolver)
+```
+
+Para isso funcionar a edição precisa nascer marcada: depois de montar o editor
+com o HTML do checklist, antes do primeiro save, chame
+`editor.current!.stampGenerated()`.
+
 ### Imagens inseridas pelo advogado
 
 `uploadImage` devolve `{ src, vaultSrc }`: o editor grava a tag com o `src`

package/dist/index.d.mts

@@ -18,7 +18,7 @@
 import * as react from 'react';
 import { CSSProperties } from 'react';
 import { MinutaMargins, MinutaHeader, MinutaChromeText, MinutaVariableCatalog, MinutaEditorOptions, MinutaVariableRef, MinutaEditor as MinutaEditor$1 } from '@meistrari/minuta-editor';
-export { MinutaChromeText, MinutaEditor as MinutaEditorInstance, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, extractTemplateVariables, resolveTemplateVariables } from '@meistrari/minuta-editor';
+export { MinutaChromeText, MinutaEditor as MinutaEditorInstance, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, extractTemplateVariables, hasLeadingTopicNumber, resolveTemplateVariables, toggleTopicNumber } from '@meistrari/minuta-editor';
 
 interface MinutaEditorProps {
     /**

package/dist/index.d.ts

@@ -18,7 +18,7 @@
 import * as react from 'react';
 import { CSSProperties } from 'react';
 import { MinutaMargins, MinutaHeader, MinutaChromeText, MinutaVariableCatalog, MinutaEditorOptions, MinutaVariableRef, MinutaEditor as MinutaEditor$1 } from '@meistrari/minuta-editor';
-export { MinutaChromeText, MinutaEditor as MinutaEditorInstance, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, extractTemplateVariables, resolveTemplateVariables } from '@meistrari/minuta-editor';
+export { MinutaChromeText, MinutaEditor as MinutaEditorInstance, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, extractTemplateVariables, hasLeadingTopicNumber, resolveTemplateVariables, toggleTopicNumber } from '@meistrari/minuta-editor';
 
 interface MinutaEditorProps {
     /**

package/dist/index.mjs

@@ -1,7 +1,7 @@
 'use client';
 import { forwardRef, useRef, useLayoutEffect, useEffect, useImperativeHandle, createElement } from 'react';
 import { createMinutaEditor } from '@meistrari/minuta-editor';
-export { extractTemplateVariables, resolveTemplateVariables } from '@meistrari/minuta-editor';
+export { extractTemplateVariables, hasLeadingTopicNumber, resolveTemplateVariables, toggleTopicNumber } from '@meistrari/minuta-editor';
 
 const MinutaEditor = forwardRef((props, ref) => {
   const host = useRef(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/minuta-react",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Componente React do editor de minuta do defesa.ai — casca fina sobre @meistrari/minuta-editor",
   "repository": {
     "type": "git",
@@ -28,7 +28,7 @@
     "test:pack": "node scripts/verify-pack.mjs"
   },
   "dependencies": {
-    "@meistrari/minuta-editor": "^1.0.0",
+    "@meistrari/minuta-editor": "^1.7.0",
     "@tiptap/core": "2.11.9",
     "@tiptap/extension-blockquote": "2.11.9",
     "@tiptap/extension-bold": "2.11.9",