@sofereditor/core 0.7.0 → 0.10.0

package/dist/index.d.cts

@@ -128,11 +128,24 @@ interface BlockAttrs {
     /** Only meaningful when `type === "table"`. */
     cols?: number;
     /**
-     * Only meaningful when `type === "table"`. Per-column widths in CSS px.
-     * Length should equal `cols` when set; missing or short arrays fall back to
-     * an auto distribution at render time.
+     * Only meaningful when `type === "table"`. Per-column widths in
+     * **proportion**, summing to 100. Old documents have absolute px and are
+     * normalized on read — see `normalizarLarguras`.
      */
     colWidths?: number[];
+    /**
+     * Only meaningful when `type === "table"`. Total table width as a
+     * percentage of the available page width. Missing = 100, so existing
+     * documents don't change appearance.
+     */
+    tableWidth?: number;
+    /**
+     * Only meaningful when `type === "table"`. Per-row height in px, one entry
+     * per row. It's a MINIMUM, not fixed — the row grows past it when content
+     * needs more room (same posture as `w:trHeight hRule="atLeast"` in DOCX).
+     * Missing = rows size to content, exactly like today.
+     */
+    rowHeights?: number[];
     /**
      * Só relevante quando `type === "table"`. Onde as linhas da grade aparecem.
      * Ausente = "all" — documentos existentes não mudam de aparência.
@@ -178,6 +191,20 @@ interface CellAttrs {
     align?: AlignValue;
     /** Cor de fundo da célula (CSS color, ex. `#ffe58f`). Ausente = sem fundo. */
     bgColor?: string;
+    /**
+     * Quando presente, a célula renderiza como lista e cada linha separada por
+     * `\n` vira um item. Ausente = texto normal com quebras visuais.
+     *
+     * Não existe `listLevel` aqui de propósito: `Y.Text` plano não guarda
+     * atributo por linha, então recuo seria um nível para a célula inteira, não
+     * por item. Aninhamento dentro de célula exigiria blocos de verdade dentro
+     * dela — ver o spec de 2026-08-24.
+     */
+    listKind?: ListKind;
+    /** Só relevante com `listKind === "ordered"`. Primeiro número da lista. */
+    listStart?: number;
+    /** Só relevante com `listKind === "ordered"`. Sobrepõe o marcador padrão. */
+    listStyle?: ListStyleType;
 }
 interface Position {
     blockIndex: number;
@@ -274,9 +301,46 @@ interface ImageEmbed {
      * caption using the paragraph's own alignment.
      */
     captionAlign?: "left" | "center" | "right";
+    /**
+     * Presente ⇒ este embed é uma fórmula. A imagem (`src`) é o RENDER; isto é
+     * a fonte. Reabrir o editor de fórmula relê `latex` daqui.
+     */
+    formula?: {
+        /** Fonte da verdade. O que o professor escreveu. */
+        latex: string;
+        /**
+         * Bloco (`\displaystyle`, centrado) em vez de inline. Guardado explícito
+         * em vez de derivado de `align === "center"`: derivar acoplaria o modo da
+         * fórmula a um campo de layout que o usuário mexe pelos botões de
+         * alinhamento da toolbar, e reabrir o modal cairia no modo errado.
+         */
+        display: boolean;
+        /**
+         * Alinhamento de base para fórmula inline, no formato que o MathJax
+         * devolve (ex.: "-0.781ex"). Aplicado como `vertical-align` no WRAPPER
+         * (<figure>) para a fórmula sentar na linha do texto. Ausente quando
+         * `display` é true.
+         */
+        vAlign?: string;
+    };
+    /**
+     * PNG data URL. Só o `export-docx` consome: o `ImageRun` de `type: "svg"`
+     * exige um `fallback` raster. Vale para qualquer embed cujo `src` seja SVG —
+     * não é exclusivo de fórmula.
+     */
+    svgFallback?: string;
 }
 type InsertContent = string | ImageEmbed;
 declare function isImageEmbed(v: unknown): v is ImageEmbed;
+/**
+ * Um embed de fórmula é um embed de IMAGEM que carrega seu LaTeX. Só dois
+ * lugares precisam distinguir: a toolbar (trocar "Legenda" por "Editar
+ * fórmula") e o duplo clique que reabre o modal. Todo o resto trata como
+ * imagem, de propósito.
+ */
+declare function isFormulaEmbed(v: unknown): v is ImageEmbed & {
+    formula: NonNullable<ImageEmbed["formula"]>;
+};
 interface DeltaOp {
     insert: InsertContent;
     attributes?: MarkAttrs;
@@ -481,6 +545,19 @@ declare function deltaLength(delta: DeltaOp[]): number;
  * Embeds are atomic length-1 ops: included whole if their slot intersects the range.
  */
 declare function sliceDelta(delta: DeltaOp[], start: number, end: number): DeltaOp[];
+/**
+ * Fatia um delta em uma lista por linha, quebrando nos `\n`.
+ *
+ * Usado pelo render de célula-lista: a célula é um `Y.Text` plano, e quando ela
+ * carrega `listKind` cada linha vira um `<li>`. As marcas de cada trecho são
+ * preservadas; embeds ficam na linha corrente e nunca separam.
+ *
+ * Devolve SEMPRE ao menos uma linha — delta vazio vira `[[]]`, não `[]`.
+ * Linha vazia no meio (`"a\n\nb"`) é preservada como delta vazio, senão o
+ * número de itens da lista não bateria com o número de `\n` do modelo, e o
+ * mapeamento de cursor do `dom-bridge` sairia do lugar.
+ */
+declare function splitDeltaByLines(delta: DeltaOp[]): DeltaOp[][];
 
 /**
  * Helpers puros de decoração visual, compartilhados pelos DOIS renderizadores
@@ -876,8 +953,81 @@ declare function mergeDown(ctx: CommandContext, blockIndex: number, row: number,
  * something was split. No-op (returns false) on a cell with no spans.
  */
 declare function splitCell(ctx: CommandContext, blockIndex: number, row: number, col: number): boolean;
-/** Set the width (in CSS px) of a specific column. Auto-initializes `colWidths`. */
-declare function setColumnWidth(ctx: CommandContext, blockIndex: number, col: number, widthPx: number): void;
+/**
+ * Devolve proporções somando 100.
+ *
+ * Documento antigo grava px absoluto. Como a tabela sempre renderiza em
+ * `width: 100%`, esses px já eram interpretados PROPORCIONALMENTE pelo
+ * navegador — então normalizar preserva exatamente o que o professor via.
+ * Não é conversão destrutiva.
+ *
+ * A heurística "a soma já é ~100, então já é proporção" é segura na prática:
+ * para uma tabela em px cair nela, a média por coluna teria que ser 100/n —
+ * 25 px cada em 4 colunas. O código antigo gravava largura renderizada, que
+ * numa A4 dá ~150 px por coluna. É heurística, não prova.
+ */
+declare function normalizarLarguras(widths: number[] | undefined, cols: number): number[];
+/**
+ * Move a divisa `boundary` (entre a coluna `boundary` e a `boundary+1`) por
+ * `deltaPct` pontos percentuais: uma cresce, a vizinha encolhe na mesma
+ * medida. A soma permanece 100 **por construção**, não por normalização —
+ * é o que faz o arrasto colar no cursor.
+ *
+ * A divisa da última coluna não tem vizinha: ela é a borda direita da tabela
+ * e é tratada por `setTableWidth`, não aqui.
+ */
+declare function setColumnBoundary(ctx: CommandContext, blockIndex: number, boundary: number, deltaPct: number, 
+/**
+ * Proporções do início do arrasto. O overlay lê o modelo UMA vez no
+ * `pointerdown` e passa aqui a cada movimento, para o delta ser sempre
+ * relativo àquele instante. Sem a base, cada `pointermove` aplicaria o
+ * delta sobre o resultado do anterior e o arrasto aceleraria.
+ */
+base?: number[]): void;
+/** Piso arbitrário e assumido: com `table-layout: fixed` a tabela encolhe
+ *  abaixo do conteúdo sem resistência, então não há "mínimo do conteúdo"
+ *  para ancorar. */
+declare const MIN_TABELA_PCT = 20;
+/** Teto: a tabela não passa da margem da página. */
+declare const MAX_TABELA_PCT = 100;
+/**
+ * Trava `pct` na faixa válida. Exportada porque o import de DOCX precisa da
+ * MESMA faixa que o comando: o Word aceita largura de tabela maior que a
+ * página, e sem esta trava um `w:tblW` de 7500 pct entrava como 150% — a
+ * tabela transbordava a área imprimível e a última coluna sumia do papel.
+ */
+declare function travaLarguraTabela(pct: number): number;
+/**
+ * Define a largura total da tabela como percentual da largura útil da
+ * página. Ausente = 100 (comportamento de hoje).
+ */
+declare function setTableWidth(ctx: CommandContext, blockIndex: number, pct: number): void;
+/** Piso de altura de linha, em px. Abaixo disso a linha some da tela. */
+declare const MIN_LINHA_PX = 16;
+/**
+ * Grava a altura de UMA linha, em px. É um MÍNIMO, não fixo — o CSS trata
+ * `height` do `<tr>` como piso, e conteúdo maior empurra a linha para além
+ * do valor gravado (mesma postura de `w:trHeight hRule="atLeast"` no DOCX).
+ *
+ * Só materializa `rowHeights` quando o array já existe ou está sendo
+ * inicializado aqui — uma tabela nunca redimensionada não ganha o atributo
+ * à toa, senão suas linhas parariam de crescer livremente com o conteúdo.
+ */
+declare function setRowHeight(ctx: CommandContext, blockIndex: number, row: number, px: number): void;
+/**
+ * Grava o array de alturas INTEIRO numa única transação — para o arrasto da
+ * Task 5 escrever, a cada `pointermove`, o resultado final calculado a
+ * partir da base do `pointerdown` (mesmo padrão de `setColumnBoundary`),
+ * numa chamada só, em vez de N chamadas de `setRowHeight` que teriam que ser
+ * reconciliadas depois. NÃO verificado aqui se isso muda o agrupamento de
+ * undo do `Y.UndoManager` (que já agrupa por `captureTimeout` independente
+ * de quantas transações ocorrem) — só a exportação e a escrita atômica do
+ * array são o que este teste cobre.
+ *
+ * Cada altura passa pelo mesmo piso de `setRowHeight`. O array precisa
+ * cobrir todas as linhas da tabela; tamanho errado é rejeitado (no-op).
+ */
+declare function setRowHeights(ctx: CommandContext, blockIndex: number, heights: number[]): void;
 /**
  * Move the caret to the next cell of the same table (Tab). At the last cell of
  * the last row, creates a new row and lands in its first cell. Returns true
@@ -932,4 +1082,24 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { ANSWER_LINE_COLOR, ANSWER_LINE_MAX, type AlignValue, type AnswerLineSpacing, BLANK_MIN_RUN, BLANK_STYLE, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, type CellBorderColors, type CellBorderPos, type ClipboardSlice, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type EmbedLoc, type EncodedCursor, type EncodedCursorPoint, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, type ListStyleType, MARGIN_PRESETS, MAX_LIST_LEVEL, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, SOFER_MIME, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, type StyleRecord, TABLE_BORDER_COLOR, TABLE_GUIDE_COLOR, TRACKED_ORIGINS, type TableBorderPreset, type TableLocation, type TableRect, answerLineStyle, cellBorderColors, cellBorderStyle, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, insertAnswerLines, insertImage, insertParagraph, insertSlice, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isEmbedAdjacentToCaret, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveEmbedAnchor, moveToNextCell, moveToPrevCell, newBlockId, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, serializeSelection, setBlockAttr, setBlockAttrAtIndex, setBlockType, setCellAttr, setColumnWidth, setImageAttrs, setMark, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitListItem, splitUnderscoreRuns, styleToCssText, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };
+/**
+ * Remove toda marca `fontFamily` do documento — de blocos e de células de
+ * tabela. Remove **todas**, não só as de valor conhecido: com o dropdown de
+ * fonte fora da toolbar, nenhuma marca legítima pode existir.
+ *
+ * Idempotente e observável: conta antes de escrever e só abre transação se
+ * houver o que limpar. Documento já migrado não gera update no Y.Doc, logo não
+ * dispara o autosave e não regrava o `htmlSnapshot`.
+ *
+ * A transação usa origin `"migration"`, seguindo a convenção de `"pageSettings"`
+ * e `"import"` (`document.ts:106`) — origens que o `UndoManager` não rastreia.
+ * Sem isso, o primeiro Ctrl+Z do professor desfaria a migração em vez da edição
+ * dele.
+ *
+ * @returns número de runs que carregavam a marca. 0 = nenhuma escrita.
+ */
+declare function stripFontFamilyMarks(doc: EditorDocument, opts?: {
+    dryRun?: boolean;
+}): number;
+
+export { ANSWER_LINE_COLOR, ANSWER_LINE_MAX, type AlignValue, type AnswerLineSpacing, BLANK_MIN_RUN, BLANK_STYLE, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, type CellBorderColors, type CellBorderPos, type ClipboardSlice, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type EmbedLoc, type EncodedCursor, type EncodedCursorPoint, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, type ListStyleType, MARGIN_PRESETS, MAX_LIST_LEVEL, MAX_TABELA_PCT, MIN_LINHA_PX, MIN_TABELA_PCT, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, SOFER_MIME, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, type StyleRecord, TABLE_BORDER_COLOR, TABLE_GUIDE_COLOR, TRACKED_ORIGINS, type TableBorderPreset, type TableLocation, type TableRect, answerLineStyle, cellBorderColors, cellBorderStyle, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, insertAnswerLines, insertImage, insertParagraph, insertSlice, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isEmbedAdjacentToCaret, isFormulaEmbed, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveEmbedAnchor, moveToNextCell, moveToPrevCell, newBlockId, normalizarLarguras, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, serializeSelection, setBlockAttr, setBlockAttrAtIndex, setBlockType, setCellAttr, setColumnBoundary, setImageAttrs, setMark, setRowHeight, setRowHeights, setTableWidth, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitDeltaByLines, splitListItem, splitUnderscoreRuns, stripFontFamilyMarks, styleToCssText, tableLocationOf, tableRectSelection, toggleList, toggleMark, travaLarguraTabela, withDefaults };

package/dist/index.d.ts

@@ -128,11 +128,24 @@ interface BlockAttrs {
     /** Only meaningful when `type === "table"`. */
     cols?: number;
     /**
-     * Only meaningful when `type === "table"`. Per-column widths in CSS px.
-     * Length should equal `cols` when set; missing or short arrays fall back to
-     * an auto distribution at render time.
+     * Only meaningful when `type === "table"`. Per-column widths in
+     * **proportion**, summing to 100. Old documents have absolute px and are
+     * normalized on read — see `normalizarLarguras`.
      */
     colWidths?: number[];
+    /**
+     * Only meaningful when `type === "table"`. Total table width as a
+     * percentage of the available page width. Missing = 100, so existing
+     * documents don't change appearance.
+     */
+    tableWidth?: number;
+    /**
+     * Only meaningful when `type === "table"`. Per-row height in px, one entry
+     * per row. It's a MINIMUM, not fixed — the row grows past it when content
+     * needs more room (same posture as `w:trHeight hRule="atLeast"` in DOCX).
+     * Missing = rows size to content, exactly like today.
+     */
+    rowHeights?: number[];
     /**
      * Só relevante quando `type === "table"`. Onde as linhas da grade aparecem.
      * Ausente = "all" — documentos existentes não mudam de aparência.
@@ -178,6 +191,20 @@ interface CellAttrs {
     align?: AlignValue;
     /** Cor de fundo da célula (CSS color, ex. `#ffe58f`). Ausente = sem fundo. */
     bgColor?: string;
+    /**
+     * Quando presente, a célula renderiza como lista e cada linha separada por
+     * `\n` vira um item. Ausente = texto normal com quebras visuais.
+     *
+     * Não existe `listLevel` aqui de propósito: `Y.Text` plano não guarda
+     * atributo por linha, então recuo seria um nível para a célula inteira, não
+     * por item. Aninhamento dentro de célula exigiria blocos de verdade dentro
+     * dela — ver o spec de 2026-08-24.
+     */
+    listKind?: ListKind;
+    /** Só relevante com `listKind === "ordered"`. Primeiro número da lista. */
+    listStart?: number;
+    /** Só relevante com `listKind === "ordered"`. Sobrepõe o marcador padrão. */
+    listStyle?: ListStyleType;
 }
 interface Position {
     blockIndex: number;
@@ -274,9 +301,46 @@ interface ImageEmbed {
      * caption using the paragraph's own alignment.
      */
     captionAlign?: "left" | "center" | "right";
+    /**
+     * Presente ⇒ este embed é uma fórmula. A imagem (`src`) é o RENDER; isto é
+     * a fonte. Reabrir o editor de fórmula relê `latex` daqui.
+     */
+    formula?: {
+        /** Fonte da verdade. O que o professor escreveu. */
+        latex: string;
+        /**
+         * Bloco (`\displaystyle`, centrado) em vez de inline. Guardado explícito
+         * em vez de derivado de `align === "center"`: derivar acoplaria o modo da
+         * fórmula a um campo de layout que o usuário mexe pelos botões de
+         * alinhamento da toolbar, e reabrir o modal cairia no modo errado.
+         */
+        display: boolean;
+        /**
+         * Alinhamento de base para fórmula inline, no formato que o MathJax
+         * devolve (ex.: "-0.781ex"). Aplicado como `vertical-align` no WRAPPER
+         * (<figure>) para a fórmula sentar na linha do texto. Ausente quando
+         * `display` é true.
+         */
+        vAlign?: string;
+    };
+    /**
+     * PNG data URL. Só o `export-docx` consome: o `ImageRun` de `type: "svg"`
+     * exige um `fallback` raster. Vale para qualquer embed cujo `src` seja SVG —
+     * não é exclusivo de fórmula.
+     */
+    svgFallback?: string;
 }
 type InsertContent = string | ImageEmbed;
 declare function isImageEmbed(v: unknown): v is ImageEmbed;
+/**
+ * Um embed de fórmula é um embed de IMAGEM que carrega seu LaTeX. Só dois
+ * lugares precisam distinguir: a toolbar (trocar "Legenda" por "Editar
+ * fórmula") e o duplo clique que reabre o modal. Todo o resto trata como
+ * imagem, de propósito.
+ */
+declare function isFormulaEmbed(v: unknown): v is ImageEmbed & {
+    formula: NonNullable<ImageEmbed["formula"]>;
+};
 interface DeltaOp {
     insert: InsertContent;
     attributes?: MarkAttrs;
@@ -481,6 +545,19 @@ declare function deltaLength(delta: DeltaOp[]): number;
  * Embeds are atomic length-1 ops: included whole if their slot intersects the range.
  */
 declare function sliceDelta(delta: DeltaOp[], start: number, end: number): DeltaOp[];
+/**
+ * Fatia um delta em uma lista por linha, quebrando nos `\n`.
+ *
+ * Usado pelo render de célula-lista: a célula é um `Y.Text` plano, e quando ela
+ * carrega `listKind` cada linha vira um `<li>`. As marcas de cada trecho são
+ * preservadas; embeds ficam na linha corrente e nunca separam.
+ *
+ * Devolve SEMPRE ao menos uma linha — delta vazio vira `[[]]`, não `[]`.
+ * Linha vazia no meio (`"a\n\nb"`) é preservada como delta vazio, senão o
+ * número de itens da lista não bateria com o número de `\n` do modelo, e o
+ * mapeamento de cursor do `dom-bridge` sairia do lugar.
+ */
+declare function splitDeltaByLines(delta: DeltaOp[]): DeltaOp[][];
 
 /**
  * Helpers puros de decoração visual, compartilhados pelos DOIS renderizadores
@@ -876,8 +953,81 @@ declare function mergeDown(ctx: CommandContext, blockIndex: number, row: number,
  * something was split. No-op (returns false) on a cell with no spans.
  */
 declare function splitCell(ctx: CommandContext, blockIndex: number, row: number, col: number): boolean;
-/** Set the width (in CSS px) of a specific column. Auto-initializes `colWidths`. */
-declare function setColumnWidth(ctx: CommandContext, blockIndex: number, col: number, widthPx: number): void;
+/**
+ * Devolve proporções somando 100.
+ *
+ * Documento antigo grava px absoluto. Como a tabela sempre renderiza em
+ * `width: 100%`, esses px já eram interpretados PROPORCIONALMENTE pelo
+ * navegador — então normalizar preserva exatamente o que o professor via.
+ * Não é conversão destrutiva.
+ *
+ * A heurística "a soma já é ~100, então já é proporção" é segura na prática:
+ * para uma tabela em px cair nela, a média por coluna teria que ser 100/n —
+ * 25 px cada em 4 colunas. O código antigo gravava largura renderizada, que
+ * numa A4 dá ~150 px por coluna. É heurística, não prova.
+ */
+declare function normalizarLarguras(widths: number[] | undefined, cols: number): number[];
+/**
+ * Move a divisa `boundary` (entre a coluna `boundary` e a `boundary+1`) por
+ * `deltaPct` pontos percentuais: uma cresce, a vizinha encolhe na mesma
+ * medida. A soma permanece 100 **por construção**, não por normalização —
+ * é o que faz o arrasto colar no cursor.
+ *
+ * A divisa da última coluna não tem vizinha: ela é a borda direita da tabela
+ * e é tratada por `setTableWidth`, não aqui.
+ */
+declare function setColumnBoundary(ctx: CommandContext, blockIndex: number, boundary: number, deltaPct: number, 
+/**
+ * Proporções do início do arrasto. O overlay lê o modelo UMA vez no
+ * `pointerdown` e passa aqui a cada movimento, para o delta ser sempre
+ * relativo àquele instante. Sem a base, cada `pointermove` aplicaria o
+ * delta sobre o resultado do anterior e o arrasto aceleraria.
+ */
+base?: number[]): void;
+/** Piso arbitrário e assumido: com `table-layout: fixed` a tabela encolhe
+ *  abaixo do conteúdo sem resistência, então não há "mínimo do conteúdo"
+ *  para ancorar. */
+declare const MIN_TABELA_PCT = 20;
+/** Teto: a tabela não passa da margem da página. */
+declare const MAX_TABELA_PCT = 100;
+/**
+ * Trava `pct` na faixa válida. Exportada porque o import de DOCX precisa da
+ * MESMA faixa que o comando: o Word aceita largura de tabela maior que a
+ * página, e sem esta trava um `w:tblW` de 7500 pct entrava como 150% — a
+ * tabela transbordava a área imprimível e a última coluna sumia do papel.
+ */
+declare function travaLarguraTabela(pct: number): number;
+/**
+ * Define a largura total da tabela como percentual da largura útil da
+ * página. Ausente = 100 (comportamento de hoje).
+ */
+declare function setTableWidth(ctx: CommandContext, blockIndex: number, pct: number): void;
+/** Piso de altura de linha, em px. Abaixo disso a linha some da tela. */
+declare const MIN_LINHA_PX = 16;
+/**
+ * Grava a altura de UMA linha, em px. É um MÍNIMO, não fixo — o CSS trata
+ * `height` do `<tr>` como piso, e conteúdo maior empurra a linha para além
+ * do valor gravado (mesma postura de `w:trHeight hRule="atLeast"` no DOCX).
+ *
+ * Só materializa `rowHeights` quando o array já existe ou está sendo
+ * inicializado aqui — uma tabela nunca redimensionada não ganha o atributo
+ * à toa, senão suas linhas parariam de crescer livremente com o conteúdo.
+ */
+declare function setRowHeight(ctx: CommandContext, blockIndex: number, row: number, px: number): void;
+/**
+ * Grava o array de alturas INTEIRO numa única transação — para o arrasto da
+ * Task 5 escrever, a cada `pointermove`, o resultado final calculado a
+ * partir da base do `pointerdown` (mesmo padrão de `setColumnBoundary`),
+ * numa chamada só, em vez de N chamadas de `setRowHeight` que teriam que ser
+ * reconciliadas depois. NÃO verificado aqui se isso muda o agrupamento de
+ * undo do `Y.UndoManager` (que já agrupa por `captureTimeout` independente
+ * de quantas transações ocorrem) — só a exportação e a escrita atômica do
+ * array são o que este teste cobre.
+ *
+ * Cada altura passa pelo mesmo piso de `setRowHeight`. O array precisa
+ * cobrir todas as linhas da tabela; tamanho errado é rejeitado (no-op).
+ */
+declare function setRowHeights(ctx: CommandContext, blockIndex: number, heights: number[]): void;
 /**
  * Move the caret to the next cell of the same table (Tab). At the last cell of
  * the last row, creates a new row and lands in its first cell. Returns true
@@ -932,4 +1082,24 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { ANSWER_LINE_COLOR, ANSWER_LINE_MAX, type AlignValue, type AnswerLineSpacing, BLANK_MIN_RUN, BLANK_STYLE, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, type CellBorderColors, type CellBorderPos, type ClipboardSlice, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type EmbedLoc, type EncodedCursor, type EncodedCursorPoint, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, type ListStyleType, MARGIN_PRESETS, MAX_LIST_LEVEL, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, SOFER_MIME, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, type StyleRecord, TABLE_BORDER_COLOR, TABLE_GUIDE_COLOR, TRACKED_ORIGINS, type TableBorderPreset, type TableLocation, type TableRect, answerLineStyle, cellBorderColors, cellBorderStyle, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, insertAnswerLines, insertImage, insertParagraph, insertSlice, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isEmbedAdjacentToCaret, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveEmbedAnchor, moveToNextCell, moveToPrevCell, newBlockId, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, serializeSelection, setBlockAttr, setBlockAttrAtIndex, setBlockType, setCellAttr, setColumnWidth, setImageAttrs, setMark, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitListItem, splitUnderscoreRuns, styleToCssText, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };
+/**
+ * Remove toda marca `fontFamily` do documento — de blocos e de células de
+ * tabela. Remove **todas**, não só as de valor conhecido: com o dropdown de
+ * fonte fora da toolbar, nenhuma marca legítima pode existir.
+ *
+ * Idempotente e observável: conta antes de escrever e só abre transação se
+ * houver o que limpar. Documento já migrado não gera update no Y.Doc, logo não
+ * dispara o autosave e não regrava o `htmlSnapshot`.
+ *
+ * A transação usa origin `"migration"`, seguindo a convenção de `"pageSettings"`
+ * e `"import"` (`document.ts:106`) — origens que o `UndoManager` não rastreia.
+ * Sem isso, o primeiro Ctrl+Z do professor desfaria a migração em vez da edição
+ * dele.
+ *
+ * @returns número de runs que carregavam a marca. 0 = nenhuma escrita.
+ */
+declare function stripFontFamilyMarks(doc: EditorDocument, opts?: {
+    dryRun?: boolean;
+}): number;
+
+export { ANSWER_LINE_COLOR, ANSWER_LINE_MAX, type AlignValue, type AnswerLineSpacing, BLANK_MIN_RUN, BLANK_STYLE, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, type CellBorderColors, type CellBorderPos, type ClipboardSlice, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type EmbedLoc, type EncodedCursor, type EncodedCursorPoint, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, type ListStyleType, MARGIN_PRESETS, MAX_LIST_LEVEL, MAX_TABELA_PCT, MIN_LINHA_PX, MIN_TABELA_PCT, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, SOFER_MIME, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, type StyleRecord, TABLE_BORDER_COLOR, TABLE_GUIDE_COLOR, TRACKED_ORIGINS, type TableBorderPreset, type TableLocation, type TableRect, answerLineStyle, cellBorderColors, cellBorderStyle, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, insertAnswerLines, insertImage, insertParagraph, insertSlice, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isEmbedAdjacentToCaret, isFormulaEmbed, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveEmbedAnchor, moveToNextCell, moveToPrevCell, newBlockId, normalizarLarguras, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, serializeSelection, setBlockAttr, setBlockAttrAtIndex, setBlockType, setCellAttr, setColumnBoundary, setImageAttrs, setMark, setRowHeight, setRowHeights, setTableWidth, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitDeltaByLines, splitListItem, splitUnderscoreRuns, stripFontFamilyMarks, styleToCssText, tableLocationOf, tableRectSelection, toggleList, toggleMark, travaLarguraTabela, withDefaults };