@meistrari/minuta-editor 1.3.0 → 1.4.0

package/dist/chunks/docxExport.mjs

@@ -1,11 +1,33 @@
-import { f as footnoteHtmlToRuns, p as pocLoneCellIndex, a as pocLooksLikeTitle } from '../shared/minuta-editor.d9d0c0ce.mjs';
-import { BorderStyle, TextRun, ExternalHyperlink, Paragraph, Document, Header, Packer, AlignmentType, LineRuleType, Table, TableRow, TableCell, WidthType, TableLayoutType, Footer, FootnoteReferenceRun, VerticalAlign, ImageRun, HorizontalPositionRelativeFrom, VerticalPositionRelativeFrom, TextWrappingType, FrameAnchorType, PageNumber, HeadingLevel } from 'docx';
+import { f as footnoteHtmlToRuns, p as pocLoneCellIndex, a as formatTopicNumber, b as pocLooksLikeTitle, T as TOPIC_DEFAULT_GROUP } from '../shared/minuta-editor.b3351035.mjs';
+import { BorderStyle, TextRun, ExternalHyperlink, Paragraph, Document, LevelFormat, AlignmentType, LevelSuffix, Header, Packer, LineRuleType, Table, TableRow, TableCell, WidthType, TableLayoutType, Footer, FootnoteReferenceRun, VerticalAlign, ImageRun, HorizontalPositionRelativeFrom, VerticalPositionRelativeFrom, TextWrappingType, FrameAnchorType, PageNumber, HeadingLevel } from 'docx';
 import '@tiptap/pm/state';
 import '@tiptap/pm/view';
 
 const A4 = { width: 11906, height: 16838 };
 const PX_TO_TWIP = 15;
 const PX_PER_PT = 96 / 72;
+function topicSequenceFor(ctx, group, roman, number) {
+  const key = group || TOPIC_DEFAULT_GROUP;
+  let seq = ctx.topicSequences.get(key);
+  if (!seq || seq.roman !== roman || seq.next !== number) {
+    const reference = `cdb-topic-${ctx.topicNumbering.size + 1}`;
+    ctx.topicNumbering.set(reference, { roman, start: number });
+    seq = { reference, roman, next: number };
+    ctx.topicSequences.set(key, seq);
+  }
+  seq.next = number + 1;
+  return seq.reference;
+}
+function leadingTopicNumber(node) {
+  for (let i = 0; i < node.childCount; i++) {
+    const child = node.child(i);
+    if (child.isText && !child.text?.trim())
+      continue;
+    const number = Number(child.attrs.number);
+    return child.type.name === "topicNumber" && !child.attrs.ref && Number.isInteger(number) && number >= 1 ? child : null;
+  }
+  return null;
+}
 function getProp(style, prop) {
   if (!style)
     return void 0;
@@ -185,9 +207,15 @@ function withMarks(base, marks) {
   }
   return info;
 }
-function inlineToRuns(node, base, ctx) {
+function inlineToRuns(node, base, ctx, skip) {
   const runs = [];
   node.forEach((child) => {
+    if (skip && child === skip)
+      return;
+    if (child.type.name === "topicNumber") {
+      runs.push(new TextRun({ text: formatTopicNumber(child.attrs.number, child.attrs.roman), ...runOptions(withMarks(base, child.marks)) }));
+      return;
+    }
     if (child.type.name === "footnoteRef") {
       const text2 = String(child.attrs.text ?? "").trim();
       if (ctx && text2) {
@@ -327,10 +355,18 @@ function textBlockToParagraph(node, pos, ctx, opts = {}) {
   if (spacing.before && !breakBefore)
     spacing.before = Math.max(0, spacing.before - ctx.lastAfterTw);
   ctx.lastAfterTw = spacing.after ?? 0;
-  const runs = inlineToRuns(node, base, ctx);
+  const topic = leadingTopicNumber(node);
+  let numbering;
+  if (topic) {
+    const reference = topicSequenceFor(ctx, topic.attrs.group, Boolean(topic.attrs.roman), Number(topic.attrs.number));
+    numbering = { reference, level: 0, custom: true };
+  }
+  const runs = inlineToRuns(node, base, ctx, topic);
   const keepNext = Boolean(opts.heading || m && pocLooksLikeTitle(m.el)) || void 0;
   const paragraph = new Paragraph({
     children: runs,
+    numbering,
+    run: numbering ? runOptions(topic ? withMarks(base, topic.marks) : base) : void 0,
     // sem alinhamento explícito, corpo de peça vai justificado (o Word
     // usaria esquerda e o .docx sairia diferente da praxe e do preview)
     alignment: m?.align ?? parseAlignment(style) ?? (opts.heading ? void 0 : AlignmentType.JUSTIFIED),
@@ -340,7 +376,7 @@ function textBlockToParagraph(node, pos, ctx, opts = {}) {
     pageBreakBefore: breakBefore,
     keepNext
   });
-  ctx.meta.set(paragraph, { spacer: runs.length === 0 && !opts.heading, breakBefore });
+  ctx.meta.set(paragraph, { spacer: runs.length === 0 && !numbering && !opts.heading, breakBefore });
   return paragraph;
 }
 async function srcToDataUrl(src) {
@@ -963,22 +999,13 @@ async function nodeToDocx(node, pos, contentWidthPx, ctx) {
     case "table":
       return tableToDocx(node, pos, contentWidthPx, ctx);
     case "missingImage": {
-      const aviso = new Paragraph({
-        children: [new TextRun({
-          text: `A imagem ${node.attrs.variableId ?? ""} est\xE1 faltando`,
-          italics: true,
-          color: "773613"
-        })],
+      const lugar = new Paragraph({
+        children: [],
         alignment: AlignmentType.CENTER,
-        border: {
-          top: { style: BorderStyle.DASHED, size: 4, color: "DF8B0D" },
-          bottom: { style: BorderStyle.DASHED, size: 4, color: "DF8B0D" },
-          left: { style: BorderStyle.DASHED, size: 4, color: "DF8B0D" },
-          right: { style: BorderStyle.DASHED, size: 4, color: "DF8B0D" }
-        },
+        spacing: { after: 0, before: 0 },
         pageBreakBefore: consumeBreak(ctx)
       });
-      return [aviso];
+      return [lugar];
     }
     case "horizontalRule":
       return [new Paragraph({ children: [], border: { bottom: { style: BorderStyle.SINGLE, size: 4, color: "AAAAAA" } } })];
@@ -1326,7 +1353,9 @@ async function pocExportDocx(editor, margins, chrome, options = {}) {
     pending: { breakBefore: false },
     lastAfterTw: 0,
     meta: /* @__PURE__ */ new WeakMap(),
-    footnotes: []
+    footnotes: [],
+    topicNumbering: /* @__PURE__ */ new Map(),
+    topicSequences: /* @__PURE__ */ new Map()
   };
   const children = [];
   let pos = 0;
@@ -1375,6 +1404,22 @@ async function pocExportDocx(editor, margins, chrome, options = {}) {
       }
     },
     footnotes: Object.keys(footnotes).length ? footnotes : void 0,
+    numbering: ctx.topicNumbering.size ? {
+      config: [...ctx.topicNumbering].map(([reference, { roman, start }]) => ({
+        reference,
+        levels: [{
+          level: 0,
+          format: roman ? LevelFormat.UPPER_ROMAN : LevelFormat.DECIMAL,
+          text: "%1",
+          start,
+          alignment: AlignmentType.START,
+          // o ". " depois do número é texto do template; e sem
+          // recuo/tab o parágrafo fica igual ao preview
+          suffix: LevelSuffix.NOTHING,
+          style: { paragraph: { indent: { left: 0, hanging: 0 } } }
+        }]
+      }))
+    } : void 0,
     sections: [{
       properties: {
         page: {

package/dist/docx.mjs

@@ -1,5 +1,5 @@
 export { pocExportDocx } from './chunks/docxExport.mjs';
-import './shared/minuta-editor.d9d0c0ce.mjs';
+import './shared/minuta-editor.b3351035.mjs';
 import '@tiptap/pm/state';
 import '@tiptap/pm/view';
 import 'docx';

package/dist/index.d.mts

@@ -17,12 +17,12 @@
 /// <reference types="@tiptap/extension-text" />
 /// <reference types="@tiptap/extension-table" />
 /// <reference types="@tiptap/extension-bubble-menu" />
-import { Node, Editor, Mark, Extension } from '@tiptap/core';
+import { Node, Editor, Extension, Mark } from '@tiptap/core';
+import { Transaction } from '@tiptap/pm/state';
 import { EditorView } from '@tiptap/pm/view';
 import { P as PocPageConfig } from './shared/minuta-editor.9e65d163.mjs';
 export { e as PAGINATE_META, a as PocDocxChrome, b as PocDocxExportOptions, s as PocLoneRow, d as PocPageBreak, c as PocPageNote, v as PocPaginationPlugin, u as breaksEqual, h as buildPocFooterEl, g as buildPocHeaderEl, j as buildPocNotesEl, l as computePocBreaks, t as computePocLoneRows, i as isPocChromeCanvas, n as isPocFlexRow, f as pocChromeFlowHeight, m as pocDescendsInto, r as pocLoneCellIndex, k as pocLooksLikeTitle, o as pocNodeHasVisibleContent, q as pocNodePaintsBox, p as pocPageKey } from './shared/minuta-editor.9e65d163.mjs';
 import '@tiptap/pm/model';
-import '@tiptap/pm/state';
 
 /**
  * Variáveis de template da minuta — o formato do placeholder e a resolução dele.
@@ -162,6 +162,29 @@ declare const PocTemplateVariable: Node<{
 declare const PocFootnoteRef: Node<any, any>;
 /** re-sequencia a numeração das chamadas de nota na ordem do documento */
 declare function renumberPocFootnotes(editor: Editor): void;
+/**
+ * Número de tópico/parágrafo — o `<topic group="paragrafo"/>` do template já
+ * resolvido pelo render. É NÓ, e não texto, por dois motivos: quem edita a
+ * minuta apaga, move ou insere um parágrafo numerado e a sequência do grupo se
+ * refaz sozinha (`PocTopicRenumber`), e o export leva o número como numeração
+ * nativa do Word, que também se refaz quando o advogado apaga um parágrafo lá.
+ * Contrato do marcador em `utils/topicNumber.ts`.
+ */
+declare const PocTopicNumber: Node<any, any>;
+/**
+ * Re-sequencia os números de tópico na ordem do documento, por grupo, dentro
+ * da transação dada. Devolve se mudou algo. Um nó `ref` (latest) recebe o
+ * último número já contado do grupo — a mesma regra do render.
+ */
+declare function renumberPocTopicsIn(tr: Transaction): boolean;
+/** re-sequencia a numeração dos tópicos no editor dado (uso pontual; o plugin faz isso a cada mudança) */
+declare function renumberPocTopics(editor: Editor): void;
+/**
+ * A cada transação que muda o documento, refaz a sequência dos tópicos. Só
+ * despacha quando algum número de fato mudou, então digitar dentro de um
+ * parágrafo não custa nada além da varredura.
+ */
+declare const PocTopicRenumber: Extension<any, any>;
 declare const PocStyledDiv: Node<any, any>;
 declare const PocInlineStyle: Mark<any, any>;
 declare const PocUnderline: Mark<any, any>;
@@ -181,7 +204,7 @@ declare function buildPocExtensions(pageConfig?: PocPageConfig, options?: {
      * ainda no editor — o seletor de variável — depende disso.
      */
     handleKeyDown?: (view: EditorView, event: KeyboardEvent) => boolean;
-}): (Node<any, any> | Mark<any, any> | Extension<any, any>)[];
+}): (Node<any, any> | Extension<any, any> | Mark<any, any>)[];
 
 /**
  * O editor de minuta como coisa montável em qualquer lugar: `createMinutaEditor(el, opts)`.
@@ -480,6 +503,40 @@ declare function refreshVaultImages(editor: Editor, resolveUrl: (vaultUrl: strin
  */
 declare function sanitizeRichHtml(html: string | null | undefined): string;
 
+/**
+ * Número de tópico/parágrafo — o `<topic group="paragrafo"/>` dos templates.
+ *
+ * O render resolve o número, mas em vez de achatá-lo em texto ("12") o guarda
+ * num `<span data-topic-number>`: no editor ele vira o nó `topicNumber`, que se
+ * re-sequencia sozinho quando um parágrafo é apagado, movido ou inserido, e no
+ * DOCX vira numeração nativa do Word (que também se refaz quando o advogado
+ * apaga um parágrafo lá). Este é o contrato do marcador — server, client e
+ * pacote falam por ele.
+ */
+declare const TOPIC_NUMBER_ATTR = "data-topic-number";
+declare const TOPIC_GROUP_ATTR = "data-topic-group";
+declare const TOPIC_ROMAN_ATTR = "data-topic-roman";
+declare const TOPIC_REF_ATTR = "data-topic-ref";
+declare const TOPIC_DEFAULT_GROUP = "default";
+interface TopicNumberInfo {
+    /** valor numérico (o que se conta) */
+    number: number;
+    /** grupo do contador (`group` da tag); sem grupo = `default` */
+    group: string;
+    /** exibido em algarismos romanos maiúsculos */
+    roman: boolean;
+    /** `<topic latest="true">`: repete o último número do grupo em vez de avançar */
+    ref: boolean;
+}
+declare function toRoman(num: number): string;
+declare function fromRoman(text: string): number | null;
+/** texto exibido para o número (decimal ou romano) */
+declare function formatTopicNumber(number: number, roman: boolean): string;
+/** o marcador em HTML — é o que o render emite e o que o editor lê e grava */
+declare function topicNumberHtml(info: TopicNumberInfo): string;
+/** lê o marcador de um elemento (`span[data-topic-number]`) */
+declare function readTopicNumber(el: Element): TopicNumberInfo;
+
 /**
  * A tag de imagem que o editor insere após o upload: guarda o `src` presignado
  * (funciona agora) E o `data-vault-src` durável (`vault://…`). Quem re-resolve
@@ -504,5 +561,5 @@ declare function collectVaultRefs(html: string): string[];
 /** aplica as URLs resolvidas às `<img>` do trecho; tags sem resolução ficam como estão */
 declare function renewVaultImageTags(html: string, resolved: Map<string, string>): string;
 
-export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPageConfig, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocUnderline, PocVariableChip, buildPocExtensions, collectVaultRefs, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, footnoteHtmlToRuns, footnoteSizePt, iconSvg, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, shouldMoveBreakToHeading, swapVaultSrc, variableChipHtml, vaultImageHtml, vaultRefOf };
-export type { FootnoteRun, MinutaChromeText, MinutaEditor, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, PocKeepWithNextItem, RefreshVaultImagesOptions, VariableClickKind };
+export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPageConfig, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocTopicNumber, PocTopicRenumber, PocUnderline, PocVariableChip, TOPIC_DEFAULT_GROUP, TOPIC_GROUP_ATTR, TOPIC_NUMBER_ATTR, TOPIC_REF_ATTR, TOPIC_ROMAN_ATTR, buildPocExtensions, collectVaultRefs, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, footnoteHtmlToRuns, footnoteSizePt, formatTopicNumber, fromRoman, iconSvg, readTopicNumber, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, renumberPocTopics, renumberPocTopicsIn, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, shouldMoveBreakToHeading, swapVaultSrc, toRoman, topicNumberHtml, variableChipHtml, vaultImageHtml, vaultRefOf };
+export type { FootnoteRun, MinutaChromeText, MinutaEditor, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, PocKeepWithNextItem, RefreshVaultImagesOptions, TopicNumberInfo, VariableClickKind };

package/dist/index.d.ts

@@ -17,12 +17,12 @@
 /// <reference types="@tiptap/extension-text" />
 /// <reference types="@tiptap/extension-table" />
 /// <reference types="@tiptap/extension-bubble-menu" />
-import { Node, Editor, Mark, Extension } from '@tiptap/core';
+import { Node, Editor, Extension, Mark } from '@tiptap/core';
+import { Transaction } from '@tiptap/pm/state';
 import { EditorView } from '@tiptap/pm/view';
 import { P as PocPageConfig } from './shared/minuta-editor.9e65d163.js';
 export { e as PAGINATE_META, a as PocDocxChrome, b as PocDocxExportOptions, s as PocLoneRow, d as PocPageBreak, c as PocPageNote, v as PocPaginationPlugin, u as breaksEqual, h as buildPocFooterEl, g as buildPocHeaderEl, j as buildPocNotesEl, l as computePocBreaks, t as computePocLoneRows, i as isPocChromeCanvas, n as isPocFlexRow, f as pocChromeFlowHeight, m as pocDescendsInto, r as pocLoneCellIndex, k as pocLooksLikeTitle, o as pocNodeHasVisibleContent, q as pocNodePaintsBox, p as pocPageKey } from './shared/minuta-editor.9e65d163.js';
 import '@tiptap/pm/model';
-import '@tiptap/pm/state';
 
 /**
  * Variáveis de template da minuta — o formato do placeholder e a resolução dele.
@@ -162,6 +162,29 @@ declare const PocTemplateVariable: Node<{
 declare const PocFootnoteRef: Node<any, any>;
 /** re-sequencia a numeração das chamadas de nota na ordem do documento */
 declare function renumberPocFootnotes(editor: Editor): void;
+/**
+ * Número de tópico/parágrafo — o `<topic group="paragrafo"/>` do template já
+ * resolvido pelo render. É NÓ, e não texto, por dois motivos: quem edita a
+ * minuta apaga, move ou insere um parágrafo numerado e a sequência do grupo se
+ * refaz sozinha (`PocTopicRenumber`), e o export leva o número como numeração
+ * nativa do Word, que também se refaz quando o advogado apaga um parágrafo lá.
+ * Contrato do marcador em `utils/topicNumber.ts`.
+ */
+declare const PocTopicNumber: Node<any, any>;
+/**
+ * Re-sequencia os números de tópico na ordem do documento, por grupo, dentro
+ * da transação dada. Devolve se mudou algo. Um nó `ref` (latest) recebe o
+ * último número já contado do grupo — a mesma regra do render.
+ */
+declare function renumberPocTopicsIn(tr: Transaction): boolean;
+/** re-sequencia a numeração dos tópicos no editor dado (uso pontual; o plugin faz isso a cada mudança) */
+declare function renumberPocTopics(editor: Editor): void;
+/**
+ * A cada transação que muda o documento, refaz a sequência dos tópicos. Só
+ * despacha quando algum número de fato mudou, então digitar dentro de um
+ * parágrafo não custa nada além da varredura.
+ */
+declare const PocTopicRenumber: Extension<any, any>;
 declare const PocStyledDiv: Node<any, any>;
 declare const PocInlineStyle: Mark<any, any>;
 declare const PocUnderline: Mark<any, any>;
@@ -181,7 +204,7 @@ declare function buildPocExtensions(pageConfig?: PocPageConfig, options?: {
      * ainda no editor — o seletor de variável — depende disso.
      */
     handleKeyDown?: (view: EditorView, event: KeyboardEvent) => boolean;
-}): (Node<any, any> | Mark<any, any> | Extension<any, any>)[];
+}): (Node<any, any> | Extension<any, any> | Mark<any, any>)[];
 
 /**
  * O editor de minuta como coisa montável em qualquer lugar: `createMinutaEditor(el, opts)`.
@@ -480,6 +503,40 @@ declare function refreshVaultImages(editor: Editor, resolveUrl: (vaultUrl: strin
  */
 declare function sanitizeRichHtml(html: string | null | undefined): string;
 
+/**
+ * Número de tópico/parágrafo — o `<topic group="paragrafo"/>` dos templates.
+ *
+ * O render resolve o número, mas em vez de achatá-lo em texto ("12") o guarda
+ * num `<span data-topic-number>`: no editor ele vira o nó `topicNumber`, que se
+ * re-sequencia sozinho quando um parágrafo é apagado, movido ou inserido, e no
+ * DOCX vira numeração nativa do Word (que também se refaz quando o advogado
+ * apaga um parágrafo lá). Este é o contrato do marcador — server, client e
+ * pacote falam por ele.
+ */
+declare const TOPIC_NUMBER_ATTR = "data-topic-number";
+declare const TOPIC_GROUP_ATTR = "data-topic-group";
+declare const TOPIC_ROMAN_ATTR = "data-topic-roman";
+declare const TOPIC_REF_ATTR = "data-topic-ref";
+declare const TOPIC_DEFAULT_GROUP = "default";
+interface TopicNumberInfo {
+    /** valor numérico (o que se conta) */
+    number: number;
+    /** grupo do contador (`group` da tag); sem grupo = `default` */
+    group: string;
+    /** exibido em algarismos romanos maiúsculos */
+    roman: boolean;
+    /** `<topic latest="true">`: repete o último número do grupo em vez de avançar */
+    ref: boolean;
+}
+declare function toRoman(num: number): string;
+declare function fromRoman(text: string): number | null;
+/** texto exibido para o número (decimal ou romano) */
+declare function formatTopicNumber(number: number, roman: boolean): string;
+/** o marcador em HTML — é o que o render emite e o que o editor lê e grava */
+declare function topicNumberHtml(info: TopicNumberInfo): string;
+/** lê o marcador de um elemento (`span[data-topic-number]`) */
+declare function readTopicNumber(el: Element): TopicNumberInfo;
+
 /**
  * A tag de imagem que o editor insere após o upload: guarda o `src` presignado
  * (funciona agora) E o `data-vault-src` durável (`vault://…`). Quem re-resolve
@@ -504,5 +561,5 @@ declare function collectVaultRefs(html: string): string[];
 /** aplica as URLs resolvidas às `<img>` do trecho; tags sem resolução ficam como estão */
 declare function renewVaultImageTags(html: string, resolved: Map<string, string>): string;
 
-export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPageConfig, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocUnderline, PocVariableChip, buildPocExtensions, collectVaultRefs, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, footnoteHtmlToRuns, footnoteSizePt, iconSvg, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, shouldMoveBreakToHeading, swapVaultSrc, variableChipHtml, vaultImageHtml, vaultRefOf };
-export type { FootnoteRun, MinutaChromeText, MinutaEditor, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, PocKeepWithNextItem, RefreshVaultImagesOptions, VariableClickKind };
+export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPageConfig, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocTopicNumber, PocTopicRenumber, PocUnderline, PocVariableChip, TOPIC_DEFAULT_GROUP, TOPIC_GROUP_ATTR, TOPIC_NUMBER_ATTR, TOPIC_REF_ATTR, TOPIC_ROMAN_ATTR, buildPocExtensions, collectVaultRefs, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, footnoteHtmlToRuns, footnoteSizePt, formatTopicNumber, fromRoman, iconSvg, readTopicNumber, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, renumberPocTopics, renumberPocTopicsIn, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, shouldMoveBreakToHeading, swapVaultSrc, toRoman, topicNumberHtml, variableChipHtml, vaultImageHtml, vaultRefOf };
+export type { FootnoteRun, MinutaChromeText, MinutaEditor, MinutaEditorOptions, MinutaHeader, MinutaMargins, MinutaVariableCatalog, MinutaVariableDef, MinutaVariableRef, PocKeepWithNextItem, RefreshVaultImagesOptions, TopicNumberInfo, VariableClickKind };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Node as Node$1, mergeAttributes, Mark, Extension, Editor } from '@tiptap/core';
+import { Node as Node$1, mergeAttributes, Extension, Mark, Editor } from '@tiptap/core';
 import BubbleMenu from '@tiptap/extension-bubble-menu';
 import Bold from '@tiptap/extension-bold';
 import Blockquote from '@tiptap/extension-blockquote';
@@ -22,8 +22,8 @@ import TableCell from '@tiptap/extension-table-cell';
 import TableHeader from '@tiptap/extension-table-header';
 import TableRow from '@tiptap/extension-table-row';
 import { Plugin } from '@tiptap/pm/state';
-import { s as sanitizeRichHtml, P as PocPaginationPlugin, b as sanitizeFootnoteHtml, c as computePocBreaks, d as pocPageKey, e as breaksEqual, g as PAGINATE_META } from './shared/minuta-editor.d9d0c0ce.mjs';
-export { k as buildPocFooterEl, j as buildPocHeaderEl, l as buildPocNotesEl, r as computePocLoneRows, f as footnoteHtmlToRuns, t as footnoteSizePt, i as isPocChromeCanvas, n as isPocFlexRow, h as pocChromeFlowHeight, m as pocDescendsInto, p as pocLoneCellIndex, a as pocLooksLikeTitle, o as pocNodeHasVisibleContent, q as pocNodePaintsBox, u as shouldMoveBreakToHeading } from './shared/minuta-editor.d9d0c0ce.mjs';
+import { s as sanitizeRichHtml, T as TOPIC_DEFAULT_GROUP, c as TOPIC_NUMBER_ATTR, r as readTopicNumber, d as TOPIC_GROUP_ATTR, e as TOPIC_ROMAN_ATTR, g as TOPIC_REF_ATTR, a as formatTopicNumber, P as PocPaginationPlugin, h as sanitizeFootnoteHtml, i as computePocBreaks, j as pocPageKey, k as breaksEqual, l as PAGINATE_META } from './shared/minuta-editor.b3351035.mjs';
+export { q as buildPocFooterEl, o as buildPocHeaderEl, t as buildPocNotesEl, y as computePocLoneRows, f as footnoteHtmlToRuns, z as footnoteSizePt, C as fromRoman, n as isPocChromeCanvas, v as isPocFlexRow, m as pocChromeFlowHeight, u as pocDescendsInto, p as pocLoneCellIndex, b as pocLooksLikeTitle, w as pocNodeHasVisibleContent, x as pocNodePaintsBox, A as shouldMoveBreakToHeading, B as toRoman, D as topicNumberHtml } from './shared/minuta-editor.b3351035.mjs';
 import '@tiptap/pm/view';
 
 const POC_ASSET_SWAP = "pocAssetSwap";
@@ -472,6 +472,76 @@ function renumberPocFootnotes(editor) {
   if (touched)
     editor.view.dispatch(tr);
 }
+const PocTopicNumber = Node$1.create({
+  name: "topicNumber",
+  inline: true,
+  group: "inline",
+  atom: true,
+  selectable: false,
+  addAttributes() {
+    return {
+      number: { default: 1 },
+      group: { default: TOPIC_DEFAULT_GROUP },
+      roman: { default: false },
+      /** `<topic latest="true">`: repete o último número do grupo em vez de avançar */
+      ref: { default: false }
+    };
+  },
+  parseHTML() {
+    return [{
+      tag: `span[${TOPIC_NUMBER_ATTR}]`,
+      priority: 110,
+      getAttrs: (el) => readTopicNumber(el)
+    }];
+  },
+  renderHTML({ node }) {
+    const attrs = {
+      [TOPIC_NUMBER_ATTR]: String(node.attrs.number),
+      [TOPIC_GROUP_ATTR]: node.attrs.group || TOPIC_DEFAULT_GROUP,
+      class: "poc-topic-number"
+    };
+    if (node.attrs.roman)
+      attrs[TOPIC_ROMAN_ATTR] = "true";
+    if (node.attrs.ref)
+      attrs[TOPIC_REF_ATTR] = "true";
+    return ["span", attrs, formatTopicNumber(node.attrs.number, node.attrs.roman)];
+  }
+});
+function renumberPocTopicsIn(tr) {
+  const counters = {};
+  let touched = false;
+  tr.doc.descendants((node, pos) => {
+    if (node.type.name !== "topicNumber")
+      return;
+    const group = node.attrs.group || TOPIC_DEFAULT_GROUP;
+    const number = node.attrs.ref ? counters[group] ?? 0 : counters[group] = (counters[group] ?? 0) + 1;
+    if (node.attrs.number !== number) {
+      tr.setNodeMarkup(pos, void 0, { ...node.attrs, number });
+      touched = true;
+    }
+  });
+  return touched;
+}
+function renumberPocTopics(editor) {
+  if (!editor || editor.isDestroyed)
+    return;
+  const tr = editor.state.tr;
+  if (renumberPocTopicsIn(tr))
+    editor.view.dispatch(tr);
+}
+const PocTopicRenumber = Extension.create({
+  name: "pocTopicRenumber",
+  addProseMirrorPlugins() {
+    return [new Plugin({
+      appendTransaction(transactions, _oldState, newState) {
+        if (!transactions.some((t) => t.docChanged))
+          return null;
+        const tr = newState.tr;
+        return renumberPocTopicsIn(tr) ? tr : null;
+      }
+    })];
+  }
+});
 const PocStyledDiv = Node$1.create({
   name: "styledDiv",
   group: "block",
@@ -601,6 +671,8 @@ function buildPocExtensions(pageConfig, options) {
     PocVariableChip,
     PocTemplateVariable.configure({ catalog: options?.variables ?? [] }),
     PocFootnoteRef,
+    PocTopicNumber,
+    PocTopicRenumber,
     PocStyledDiv,
     PocInlineStyle,
     PocUnderline,
@@ -2091,4 +2163,4 @@ function createMinutaEditor(element, opts) {
   return api;
 }
 
-export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, PAGINATE_META, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPaginationPlugin, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocUnderline, PocVariableChip, breaksEqual, buildPocExtensions, collectVaultRefs, computePocBreaks, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, iconSvg, pocPageKey, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, swapVaultSrc, variableChipHtml, vaultImageHtml, vaultRefOf };
+export { A4_HEIGHT_PX, A4_WIDTH_PX, DEFAULT_MARGINS, DOC_FONTS, ICON_PATHS, PAGINATE_META, POC_ASSET_SWAP, PocDocument, PocFootnoteRef, PocHtmlIsland, PocInlineStyle, PocMinutaBlock, PocMissingImage, PocPaginationPlugin, PocStylePassthrough, PocStyledDiv, PocTemplateVariable, PocTopicNumber, PocTopicRenumber, PocUnderline, PocVariableChip, TOPIC_DEFAULT_GROUP, TOPIC_GROUP_ATTR, TOPIC_NUMBER_ATTR, TOPIC_REF_ATTR, TOPIC_ROMAN_ATTR, breaksEqual, buildPocExtensions, collectVaultRefs, computePocBreaks, createMinutaEditor, decodeVaultAttr, dispatchVariableClick, escapeHtml, escapeVaultAttr, extractTemplateVariables, formatTopicNumber, iconSvg, pocPageKey, readTopicNumber, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, renumberPocTopics, renumberPocTopicsIn, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, swapVaultSrc, variableChipHtml, vaultImageHtml, vaultRefOf };

package/dist/shared/{minuta-editor.d9d0c0ce.mjs → minuta-editor.b3351035.mjs}

@@ -75,6 +75,84 @@ function sanitizeRichHtml(html) {
   return tpl.innerHTML;
 }
 
+const TOPIC_NUMBER_ATTR = "data-topic-number";
+const TOPIC_GROUP_ATTR = "data-topic-group";
+const TOPIC_ROMAN_ATTR = "data-topic-roman";
+const TOPIC_REF_ATTR = "data-topic-ref";
+const TOPIC_DEFAULT_GROUP = "default";
+function toRoman(num) {
+  if (!Number.isFinite(num) || num <= 0)
+    return "";
+  const numerals = [
+    [1e3, "M"],
+    [900, "CM"],
+    [500, "D"],
+    [400, "CD"],
+    [100, "C"],
+    [90, "XC"],
+    [50, "L"],
+    [40, "XL"],
+    [10, "X"],
+    [9, "IX"],
+    [5, "V"],
+    [4, "IV"],
+    [1, "I"]
+  ];
+  let result = "";
+  let rest = Math.floor(num);
+  for (const [value, numeral] of numerals) {
+    while (rest >= value) {
+      result += numeral;
+      rest -= value;
+    }
+  }
+  return result;
+}
+function fromRoman(text) {
+  const upper = text.trim().toUpperCase();
+  if (!upper || !/^M{0,3}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})$/.test(upper))
+    return null;
+  const values = { I: 1, V: 5, X: 10, L: 50, C: 100, D: 500, M: 1e3 };
+  let total = 0;
+  for (let i = 0; i < upper.length; i++) {
+    const current = values[upper[i]];
+    const next = values[upper[i + 1] ?? ""] ?? 0;
+    total += current < next ? -current : current;
+  }
+  return total;
+}
+function formatTopicNumber(number, roman) {
+  return roman ? toRoman(number) : String(number);
+}
+function escapeAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function topicNumberHtml(info) {
+  let attrs = `${TOPIC_NUMBER_ATTR}="${info.number}" ${TOPIC_GROUP_ATTR}="${escapeAttr(info.group || TOPIC_DEFAULT_GROUP)}"`;
+  if (info.roman)
+    attrs += ` ${TOPIC_ROMAN_ATTR}="true"`;
+  if (info.ref)
+    attrs += ` ${TOPIC_REF_ATTR}="true"`;
+  return `<span ${attrs}>${formatTopicNumber(info.number, info.roman)}</span>`;
+}
+function readTopicNumber(el) {
+  const roman = el.getAttribute(TOPIC_ROMAN_ATTR) === "true";
+  const raw = el.getAttribute(TOPIC_NUMBER_ATTR) ?? "";
+  let number = Number.parseInt(raw, 10);
+  if (!Number.isFinite(number)) {
+    const text = el.textContent?.trim() ?? "";
+    number = Number.parseInt(text, 10);
+    if (!Number.isFinite(number))
+      number = fromRoman(text) ?? 1;
+  }
+  return {
+    number,
+    group: el.getAttribute(TOPIC_GROUP_ATTR) || TOPIC_DEFAULT_GROUP,
+    roman,
+    ref: el.getAttribute(TOPIC_REF_ATTR) === "true"
+  };
+}
+
 const INLINE_TAGS = /* @__PURE__ */ new Set(["B", "STRONG", "I", "EM", "U", "SUP", "SUB", "BR"]);
 function safeHref(value) {
   const href = (value ?? "").trim();
@@ -819,4 +897,4 @@ function PocPaginationPlugin(cfg) {
   });
 }
 
-export { PocPaginationPlugin as P, pocLooksLikeTitle as a, sanitizeFootnoteHtml as b, computePocBreaks as c, pocPageKey as d, breaksEqual as e, footnoteHtmlToRuns as f, PAGINATE_META as g, pocChromeFlowHeight as h, isPocChromeCanvas as i, buildPocHeaderEl as j, buildPocFooterEl as k, buildPocNotesEl as l, pocDescendsInto as m, isPocFlexRow as n, pocNodeHasVisibleContent as o, pocLoneCellIndex as p, pocNodePaintsBox as q, computePocLoneRows as r, sanitizeRichHtml as s, footnoteSizePt as t, shouldMoveBreakToHeading as u };
+export { shouldMoveBreakToHeading as A, toRoman as B, fromRoman as C, topicNumberHtml as D, PocPaginationPlugin as P, TOPIC_DEFAULT_GROUP as T, formatTopicNumber as a, pocLooksLikeTitle as b, TOPIC_NUMBER_ATTR as c, TOPIC_GROUP_ATTR as d, TOPIC_ROMAN_ATTR as e, footnoteHtmlToRuns as f, TOPIC_REF_ATTR as g, sanitizeFootnoteHtml as h, computePocBreaks as i, pocPageKey as j, breaksEqual as k, PAGINATE_META as l, pocChromeFlowHeight as m, isPocChromeCanvas as n, buildPocHeaderEl as o, pocLoneCellIndex as p, buildPocFooterEl as q, readTopicNumber as r, sanitizeRichHtml as s, buildPocNotesEl as t, pocDescendsInto as u, isPocFlexRow as v, pocNodeHasVisibleContent as w, pocNodePaintsBox as x, computePocLoneRows as y, footnoteSizePt as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/minuta-editor",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Editor de minuta do defesa.ai sem framework: folha A4 paginada, edição rica, placeholders de variável e export DOCX fiel ao preview — monta em qualquer app (React, Vue, vanilla)",
   "repository": {
     "type": "git",