@meistrari/minuta-editor 1.4.0 → 1.5.0

package/dist/chunks/docxExport.mjs

@@ -1,4 +1,4 @@
-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 { f as footnoteHtmlToRuns, p as pocLoneCellIndex, a as formatTopicNumber, b as pocLooksLikeTitle, c as pocNodeHasVisibleContent, d as pocNodePaintsBox, T as TOPIC_DEFAULT_GROUP } from '../shared/minuta-editor.f1239e0b.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';
@@ -18,6 +18,48 @@ function topicSequenceFor(ctx, group, roman, number) {
   seq.next = number + 1;
   return seq.reference;
 }
+function listFormatFor(type) {
+  switch (type) {
+    case "a":
+      return LevelFormat.LOWER_LETTER;
+    case "A":
+      return LevelFormat.UPPER_LETTER;
+    case "i":
+      return LevelFormat.LOWER_ROMAN;
+    case "I":
+      return LevelFormat.UPPER_ROMAN;
+    default:
+      return LevelFormat.DECIMAL;
+  }
+}
+function listFormatFromCss(listStyleType) {
+  switch (listStyleType) {
+    case "lower-alpha":
+    case "lower-latin":
+      return LevelFormat.LOWER_LETTER;
+    case "upper-alpha":
+    case "upper-latin":
+      return LevelFormat.UPPER_LETTER;
+    case "lower-roman":
+      return LevelFormat.LOWER_ROMAN;
+    case "upper-roman":
+      return LevelFormat.UPPER_ROMAN;
+    default:
+      return LevelFormat.DECIMAL;
+  }
+}
+function listSequenceFor(ctx, list, run) {
+  const reference = `cdb-list-${ctx.listNumbering.size + 1}`;
+  const start = Number.parseInt(String(list.start ?? 1), 10);
+  ctx.listNumbering.set(reference, {
+    format: list.format,
+    // `start="0"` é válido (o Word aceita w:start=0); só o ausente/inválido vira 1
+    start: Number.isFinite(start) && start >= 0 ? start : 1,
+    suffix: list.suffix || ".",
+    run
+  });
+  return reference;
+}
 function leadingTopicNumber(node) {
   for (let i = 0; i < node.childCount; i++) {
     const child = node.child(i);
@@ -466,20 +508,28 @@ async function islandToDocx(node, pos, contentWidthPx, ctx) {
     const paragraphs = [];
     const liveLis = islandEl ? [...islandEl.querySelectorAll(":scope > ul > li, :scope > ol > li, :scope > li")] : [];
     const parsedLis = [...el.querySelectorAll(":scope > li")];
-    let n = 1;
+    let reference = null;
     for (let i = 0; i < parsedLis.length; i++) {
       const live = liveLis[i] ?? null;
       const source = live ?? parsedLis[i];
       const m = live ? measureEl(live) : null;
-      const marker = tag === "ol" ? `${n++}. ` : "\u2022  ";
-      const markerColor = m?.color;
+      const markerRun = { color: m?.color, size: m?.sizeHalf, font: m ? primaryFont(m.cs) : void 0 };
+      if (tag === "ol" && !reference) {
+        const liveStyleType = liveLis[0] ? getComputedStyle(liveLis[0]).listStyleType : "";
+        reference = listSequenceFor(ctx, {
+          format: el.hasAttribute("type") ? listFormatFor(el.getAttribute("type")) : listFormatFromCss(liveStyleType),
+          start: el.getAttribute("start"),
+          suffix: el.getAttribute("data-list-suffix")
+        }, markerRun);
+      }
       const runs = live ? domInlineToRuns(live) : [new TextRun({ text: source.textContent?.trim() || "", ...runOptions(parseStyle(source.getAttribute("style"))) })];
       const indentPx = live && islandEl ? live.offsetLeft : 24;
       paragraphs.push(new Paragraph({
         children: [
-          new TextRun({ text: marker, color: markerColor, size: m?.sizeHalf, font: m ? primaryFont(m.cs) : void 0 }),
+          ...tag === "ul" ? [new TextRun({ text: "\u2022  ", ...markerRun })] : [],
           ...runs
         ],
+        numbering: reference ? { reference, level: 0 } : void 0,
         spacing: m ? { after: m.afterTw, before: m.beforeTw, ...m.lineExactTw ? { line: m.lineExactTw, lineRule: LineRuleType.EXACT } : {} } : { after: 80 },
         indent: { left: Math.round(indentPx * PX_TO_TWIP) },
         alignment: m?.align,
@@ -694,6 +744,27 @@ async function flexRowToDocx(node, pos, contentWidthPx, ctx) {
   }
   return tables;
 }
+const INVISIBLE_NODE_TYPES = /* @__PURE__ */ new Set(["paragraph", "styledDiv", "missingImage", "hardBreak", "text"]);
+function rowPaintsOrShowsAnything(row, rowPos, ctx) {
+  const paintsAt = (node, pos) => {
+    if (pocNodePaintsBox(node))
+      return true;
+    const dom = domAt(ctx, pos);
+    return Boolean(bordersFrom(measureAt(ctx, pos), node.attrs?.style)) || Boolean(cellShading(dom ? getComputedStyle(dom) : null));
+  };
+  if (paintsAt(row, rowPos))
+    return true;
+  let found = false;
+  row.descendants((node, offset) => {
+    if (found)
+      return false;
+    const pos = rowPos + 1 + offset;
+    if (!INVISIBLE_NODE_TYPES.has(node.type.name) || pocNodeHasVisibleContent(node) || paintsAt(node, pos))
+      found = true;
+    return !found;
+  });
+  return found;
+}
 function isPlainContainer(node) {
   return node.type.name === "styledDiv" && !isFlexRow(node);
 }
@@ -930,6 +1001,18 @@ async function nodeToDocx(node, pos, contentWidthPx, ctx) {
     }
     case "styledDiv": {
       if (isFlexRow(node)) {
+        if (!rowPaintsOrShowsAnything(node, pos, ctx)) {
+          const rowM2 = measureAt(ctx, pos);
+          const breakBefore = consumeBreak(ctx);
+          const before = breakBefore ? rowM2?.beforeTw ?? 0 : Math.max(0, (rowM2?.beforeTw ?? 0) - ctx.lastAfterTw);
+          const lugar = new Paragraph({
+            children: [],
+            spacing: { after: rowM2?.afterTw ?? 0, before },
+            pageBreakBefore: breakBefore
+          });
+          ctx.lastAfterTw = rowM2?.afterTw ?? 0;
+          return [lugar];
+        }
         const loneIndex = pocLoneCellIndex(node);
         if (loneIndex != null) {
           let childPos = pos + 1;
@@ -1012,31 +1095,41 @@ async function nodeToDocx(node, pos, contentWidthPx, ctx) {
     case "bulletList":
     case "orderedList": {
       const paragraphs = [];
-      let n = 1;
+      const ordered = node.type.name === "orderedList";
+      let reference = null;
       let liPos = pos + 1;
       for (let i = 0; i < node.childCount; i++) {
         const li = node.child(i);
         let childPos = liPos + 1;
+        let marked = false;
         li.forEach((child) => {
           if (child.isTextblock) {
             const m = measureAt(ctx, childPos);
             const base = m ? { bold: m.bold, italics: m.italics, color: m.color, size: m.sizeHalf } : parseStyle(child.attrs.style);
-            const marker = node.type.name === "orderedList" ? `${n}. ` : "\u2022  ";
             const liDom = domAt(ctx, liPos);
             const indentPx = liDom?.offsetLeft ?? 48;
             const liBreak = consumeBreak(ctx);
+            if (ordered && !reference) {
+              reference = listSequenceFor(
+                ctx,
+                { format: listFormatFor(node.attrs.type), start: node.attrs.start },
+                { bold: base.bold, italics: base.italics, color: base.color, size: base.size, font: base.font }
+              );
+            }
+            const bullet = !ordered && !marked ? [new TextRun({ text: "\u2022  ", ...runOptions(base) })] : [];
             const liParagraph = new Paragraph({
-              children: [new TextRun({ text: marker, ...runOptions(base) }), ...inlineToRuns(child, base, ctx)],
+              children: [...bullet, ...inlineToRuns(child, base, ctx)],
+              numbering: ordered && !marked && reference ? { reference, level: 0 } : void 0,
               spacing: spacingFrom(m, child.attrs.style),
               indent: { left: Math.round(indentPx * PX_TO_TWIP) },
               pageBreakBefore: liBreak
             });
+            marked = true;
             ctx.meta.set(liParagraph, { breakBefore: liBreak });
             paragraphs.push(liParagraph);
           }
           childPos += child.nodeSize;
         });
-        n++;
         liPos += li.nodeSize;
       }
       return paragraphs;
@@ -1355,7 +1448,8 @@ async function pocExportDocx(editor, margins, chrome, options = {}) {
     meta: /* @__PURE__ */ new WeakMap(),
     footnotes: [],
     topicNumbering: /* @__PURE__ */ new Map(),
-    topicSequences: /* @__PURE__ */ new Map()
+    topicSequences: /* @__PURE__ */ new Map(),
+    listNumbering: /* @__PURE__ */ new Map()
   };
   const children = [];
   let pos = 0;
@@ -1404,21 +1498,38 @@ 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 } } }
-        }]
-      }))
+    numbering: ctx.topicNumbering.size || ctx.listNumbering.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 } } }
+          }]
+        })),
+        ...[...ctx.listNumbering].map(([reference, { format, start, suffix, run }]) => ({
+          reference,
+          levels: [{
+            level: 0,
+            format,
+            text: `%1${suffix}`,
+            start,
+            alignment: AlignmentType.LEFT,
+            // "a. texto": marcador colado ao item com um espaço,
+            // como o preview (list-style-position: inside); o
+            // recuo é o do parágrafo, não da sequência
+            suffix: LevelSuffix.SPACE,
+            style: { paragraph: { indent: { left: 0, hanging: 0 } }, run }
+          }]
+        }))
+      ]
     } : void 0,
     sections: [{
       properties: {

package/dist/docx.mjs

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

package/dist/index.mjs

@@ -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, 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 { s as sanitizeRichHtml, e as sanitizeFootnoteHtml, g as footnoteSizePt, T as TOPIC_DEFAULT_GROUP, h as TOPIC_NUMBER_ATTR, r as readTopicNumber, i as TOPIC_GROUP_ATTR, j as TOPIC_ROMAN_ATTR, k as TOPIC_REF_ATTR, a as formatTopicNumber, P as PocPaginationPlugin, l as computePocBreaks, m as pocPageKey, n as breaksEqual, o as PAGINATE_META } from './shared/minuta-editor.f1239e0b.mjs';
+export { v as buildPocFooterEl, u as buildPocHeaderEl, w as buildPocNotesEl, z as computePocLoneRows, f as footnoteHtmlToRuns, C as fromRoman, t as isPocChromeCanvas, y as isPocFlexRow, q as pocChromeFlowHeight, x as pocDescendsInto, p as pocLoneCellIndex, b as pocLooksLikeTitle, c as pocNodeHasVisibleContent, d as pocNodePaintsBox, A as shouldMoveBreakToHeading, B as toRoman, D as topicNumberHtml } from './shared/minuta-editor.f1239e0b.mjs';
 import '@tiptap/pm/view';
 
 const POC_ASSET_SWAP = "pocAssetSwap";
@@ -46,7 +46,17 @@ const PocMinutaBlock = Node$1.create({
   addAttributes() {
     return {
       blockId: { default: null },
-      blockTitle: { default: null }
+      blockTitle: { default: null },
+      /**
+       * impressão digital do texto GERADO pelo checklist (ver
+       * utils/minutaBlockFingerprint no app): enquanto o conteúdo bater
+       * com ela o trecho não foi editado e o checklist pode re-gerá-lo
+       */
+      genHash: {
+        default: null,
+        parseHTML: (el) => el.getAttribute("data-gen-hash"),
+        renderHTML: (attrs) => attrs.genHash ? { "data-gen-hash": attrs.genHash } : {}
+      }
     };
   },
   parseHTML() {
@@ -408,7 +418,9 @@ const PocFootnoteRef = Node$1.create({
   selectable: false,
   addAttributes() {
     return {
-      number: { default: "" },
+      // o Tiptap relê `number="1"` do `<footnote>` e o converte em número —
+      // e o render do ProseMirror só aceita texto como conteúdo
+      number: { default: "", parseHTML: (el) => el.getAttribute("number") ?? el.textContent ?? "" },
       /** conteúdo da nota em HTML de ênfase (b/i/u/br) */
       text: { default: "" },
       /** corpo declarado no template (`font-size: 9pt`), em pontos */
@@ -424,6 +436,17 @@ const PocFootnoteRef = Node$1.create({
         text: el.getAttribute("data-footnote") ?? "",
         size: Number.parseFloat(el.getAttribute("data-footnote-size") ?? "") || null
       })
+    }, {
+      // `<footnote>` cru do template (HTML de servidor antigo ou de
+      // outra origem): sem esta regra a tag some e o texto da nota
+      // cai no meio do parágrafo
+      tag: "footnote",
+      priority: 110,
+      getAttrs: (el) => ({
+        number: el.getAttribute("number") ?? "",
+        text: sanitizeFootnoteHtml(el.innerHTML.replace(/&nbsp;/g, " ")),
+        size: footnoteSizePt(el.getAttribute("style"))
+      })
     }];
   },
   renderHTML({ node }) {
@@ -2163,4 +2186,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, 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 };
+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, footnoteSizePt, formatTopicNumber, iconSvg, pocPageKey, readTopicNumber, refreshVaultImages, renewVaultImageTags, renumberPocFootnotes, renumberPocTopics, renumberPocTopicsIn, resolveTemplateVariables, sanitizeFootnoteHtml, sanitizeRichHtml, swapVaultSrc, variableChipHtml, vaultImageHtml, vaultRefOf };

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

@@ -75,84 +75,6 @@ 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();
@@ -208,12 +130,12 @@ function sanitizeFootnoteHtml(html) {
       return style ? `<span style="${style}">${inner}</span>` : inner;
     }
     if (node.tagName === "DIV" || node.tagName === "P")
-      return inner ? `${inner}<br>` : "";
+      return inner.trim() ? `${inner}<br>` : "";
     if (INLINE_TAGS.has(node.tagName))
       return `<${node.tagName.toLowerCase()}>${inner}</${node.tagName.toLowerCase()}>`;
     return inner;
   };
-  return Array.from(root.childNodes).map(walk).join("").replace(/\s+/g, " ").replace(/(<br>\s*)+$/i, "").trim();
+  return Array.from(root.childNodes).map(walk).join("").replace(/\s+/g, " ").replace(/^(\s*<br>)+/i, "").replace(/(<br>\s*)+$/i, "").trim();
 }
 function footnoteHtmlToRuns(html) {
   const runs = [];
@@ -271,6 +193,84 @@ function footnoteSizePt(style) {
   return Number.isFinite(value) ? value : null;
 }
 
+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"
+  };
+}
+
 function shouldMoveBreakToHeading(params) {
   const { heading, item, pageStart, capacity } = params;
   if (!heading || !heading.heading || heading.marker)
@@ -897,4 +897,4 @@ function PocPaginationPlugin(cfg) {
   });
 }
 
-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 };
+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, pocNodeHasVisibleContent as c, pocNodePaintsBox as d, sanitizeFootnoteHtml as e, footnoteHtmlToRuns as f, footnoteSizePt as g, TOPIC_NUMBER_ATTR as h, TOPIC_GROUP_ATTR as i, TOPIC_ROMAN_ATTR as j, TOPIC_REF_ATTR as k, computePocBreaks as l, pocPageKey as m, breaksEqual as n, PAGINATE_META as o, pocLoneCellIndex as p, pocChromeFlowHeight as q, readTopicNumber as r, sanitizeRichHtml as s, isPocChromeCanvas as t, buildPocHeaderEl as u, buildPocFooterEl as v, buildPocNotesEl as w, pocDescendsInto as x, isPocFlexRow as y, computePocLoneRows as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/minuta-editor",
-  "version": "1.4.0",
+  "version": "1.5.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",