@sofereditor/core 0.6.0 → 0.9.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.
@@ -274,9 +287,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;
@@ -648,6 +698,22 @@ declare function insertText(ctx: CommandContext, text: string, marks?: Partial<R
 declare function insertParagraph(ctx: CommandContext): void;
 declare function deleteBackward(ctx: CommandContext): void;
 declare function deleteForward(ctx: CommandContext): void;
+/**
+ * `true` quando o caractere imediatamente ANTES (`"backward"`) ou DEPOIS
+ * (`"forward"`) da posição atual do caret é um embed de imagem. Só considera
+ * seleção COLAPSADA — o caso de um embed inteiro SELECIONADO (range de 1
+ * caractere) é responsabilidade de `getSelectedEmbed` no chamador.
+ *
+ * Existe para `Editor.tsx` decidir se Backspace/Delete precisam ser tratados
+ * no `onKeyDown` em vez de esperar `beforeinput`: o `<figure>` de um embed é
+ * `contenteditable=false`, e quando a seleção do DOM pousa nele (o que
+ * acontece depois de inserir ou clicar numa imagem) o navegador NUNCA
+ * dispara `beforeinput` — o caminho normal de delete fica mudo. Resolvido
+ * consultando o MODELO em vez de inspecionar a seleção do DOM (que pode
+ * pousar de formas diferentes por navegador): determinístico e testável sem
+ * montar um editor real.
+ */
+declare function isEmbedAdjacentToCaret(ctx: CommandContext, direction: "backward" | "forward"): boolean;
 /**
  * Toggle a mark across the current selection.
  * - If the selection is collapsed: no-op (the UI layer handles pendingMarks).
@@ -860,8 +926,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
@@ -916,4 +1055,4 @@ 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, 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 };
+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, splitListItem, splitUnderscoreRuns, 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.
@@ -274,9 +287,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;
@@ -648,6 +698,22 @@ declare function insertText(ctx: CommandContext, text: string, marks?: Partial<R
 declare function insertParagraph(ctx: CommandContext): void;
 declare function deleteBackward(ctx: CommandContext): void;
 declare function deleteForward(ctx: CommandContext): void;
+/**
+ * `true` quando o caractere imediatamente ANTES (`"backward"`) ou DEPOIS
+ * (`"forward"`) da posição atual do caret é um embed de imagem. Só considera
+ * seleção COLAPSADA — o caso de um embed inteiro SELECIONADO (range de 1
+ * caractere) é responsabilidade de `getSelectedEmbed` no chamador.
+ *
+ * Existe para `Editor.tsx` decidir se Backspace/Delete precisam ser tratados
+ * no `onKeyDown` em vez de esperar `beforeinput`: o `<figure>` de um embed é
+ * `contenteditable=false`, e quando a seleção do DOM pousa nele (o que
+ * acontece depois de inserir ou clicar numa imagem) o navegador NUNCA
+ * dispara `beforeinput` — o caminho normal de delete fica mudo. Resolvido
+ * consultando o MODELO em vez de inspecionar a seleção do DOM (que pode
+ * pousar de formas diferentes por navegador): determinístico e testável sem
+ * montar um editor real.
+ */
+declare function isEmbedAdjacentToCaret(ctx: CommandContext, direction: "backward" | "forward"): boolean;
 /**
  * Toggle a mark across the current selection.
  * - If the selection is collapsed: no-op (the UI layer handles pendingMarks).
@@ -860,8 +926,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
@@ -916,4 +1055,4 @@ 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, 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 };
+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, splitListItem, splitUnderscoreRuns, styleToCssText, tableLocationOf, tableRectSelection, toggleList, toggleMark, travaLarguraTabela, withDefaults };

package/dist/index.js

@@ -3,6 +3,9 @@ var MAX_LIST_LEVEL = 5;
 function isImageEmbed(v) {
   return typeof v === "object" && v !== null && v.type === "image" && typeof v.src === "string";
 }
+function isFormulaEmbed(v) {
+  return isImageEmbed(v) && v.formula != null;
+}
 function isLegacySerializedDocument(v) {
   return Array.isArray(v);
 }
@@ -1044,6 +1047,24 @@ function deleteForward(ctx) {
     }
   });
 }
+function isEmbedAdjacentToCaret(ctx, direction) {
+  const sel = ctx.getSelection();
+  if (!isCollapsed(sel)) return false;
+  const pos = sel.focus;
+  const yText = ctx.doc.textAt(pos.blockIndex, pos.cellIndex);
+  if (!yText) return false;
+  const delta = yText.toDelta();
+  let cursor = 0;
+  for (const op of delta) {
+    const len = typeof op.insert === "string" ? op.insert.length : 1;
+    const opStart = cursor;
+    const opEnd = cursor + len;
+    cursor = opEnd;
+    const matches = direction === "backward" ? opEnd === pos.offset : opStart === pos.offset;
+    if (matches) return isImageEmbed(op.insert);
+  }
+  return false;
+}
 var booleanMarks = /* @__PURE__ */ new Set(["bold", "italic", "underline", "strike"]);
 function toggleMark(ctx, name, value) {
   const sel = ctx.getSelection();
@@ -1535,6 +1556,12 @@ function insertTableRow(ctx, blockIndex, row, where) {
     }
     cells.insert(P * cols, fresh);
     attrs.set("rows", rows + 1);
+    const heights = attrs.get("rowHeights");
+    if (Array.isArray(heights) && heights.length === rows) {
+      const next = heights.slice();
+      next.splice(P, 0, MIN_LINHA_PX);
+      attrs.set("rowHeights", next);
+    }
     const firstReal = newRowCovered.findIndex((v) => !v);
     const targetCellIdx = P * cols + (firstReal < 0 ? 0 : firstReal);
     ctx.setSelection(
@@ -1580,6 +1607,12 @@ function deleteTableRow(ctx, blockIndex, row) {
     }
     cells.delete(R * cols, cols);
     attrs.set("rows", rows - 1);
+    const heights = attrs.get("rowHeights");
+    if (Array.isArray(heights) && heights.length === rows) {
+      const next = heights.slice();
+      next.splice(R, 1);
+      attrs.set("rowHeights", next);
+    }
     for (const p of promotions) {
       const m = ctx.doc.getCellAttrsMap(blockIndex, p.flatNew);
       if (!m) continue;
@@ -1639,9 +1672,12 @@ function insertTableColumn(ctx, blockIndex, col, where) {
     attrs.set("cols", cols + 1);
     const widths = attrs.get("colWidths");
     if (Array.isArray(widths) && widths.length === cols) {
-      const next = widths.slice();
-      next.splice(C, 0, 100);
-      attrs.set("colWidths", next);
+      const base = normalizarLarguras(widths, cols);
+      const media = arredonda(100 / (cols + 1));
+      const escala = cols / (cols + 1);
+      const next = base.map((w) => arredonda(w * escala));
+      next.splice(C, 0, media);
+      attrs.set("colWidths", normalizarLarguras(next, cols + 1));
     }
     const newCols = cols + 1;
     const focusRow = 0;
@@ -1714,7 +1750,7 @@ function deleteTableColumn(ctx, blockIndex, col) {
     if (Array.isArray(widths) && widths.length === cols) {
       const next = widths.slice();
       next.splice(C, 1);
-      attrs.set("colWidths", next);
+      attrs.set("colWidths", normalizarLarguras(next, cols - 1));
     }
     const newCol = Math.min(C, newCols - 1);
     const target = findNextRealCell(ctx.doc, blockIndex, newCol, rows * newCols) ?? 0;
@@ -2002,20 +2038,81 @@ function splitCell(ctx, blockIndex, row, col) {
   });
   return true;
 }
-function setColumnWidth(ctx, blockIndex, col, widthPx) {
+var SOMA_OK = (s) => Math.abs(s - 100) < 0.5;
+var arredonda = (n) => Math.round(n * 1e3) / 1e3;
+function normalizarLarguras(widths, cols) {
+  const igual = () => new Array(cols).fill(100 / cols);
+  if (!Array.isArray(widths) || widths.length !== cols || cols <= 0) {
+    return igual();
+  }
+  if (!widths.every((w) => typeof w === "number" && isFinite(w) && w > 0)) {
+    return igual();
+  }
+  const soma = widths.reduce((a, b) => a + b, 0);
+  if (SOMA_OK(soma)) return widths.slice();
+  return widths.map((w) => arredonda(w / soma * 100));
+}
+var MIN_COLUNA_PCT = 3;
+function setColumnBoundary(ctx, blockIndex, boundary, deltaPct, base) {
   if (!ctx.doc.isTable(blockIndex)) return;
   const { cols } = ctx.doc.getTableSize(blockIndex);
-  if (col < 0 || col >= cols) return;
-  const w = Math.max(20, Math.round(widthPx));
+  if (boundary < 0 || boundary >= cols - 1) return;
   transact(ctx.doc, () => {
     const attrsMap = ctx.doc.getBlockAttrsMap(blockIndex);
     if (!attrsMap) return;
-    const current = attrsMap.get("colWidths");
-    const next = Array.isArray(current) && current.length === cols ? current.slice() : new Array(cols).fill(120);
-    next[col] = w;
+    const larguras = normalizarLarguras(
+      base ?? attrsMap.get("colWidths"),
+      cols
+    );
+    const a = larguras[boundary];
+    const b = larguras[boundary + 1];
+    const piso = Math.min(MIN_COLUNA_PCT, (a + b) / 2);
+    const d = Math.max(piso - a, Math.min(deltaPct, b - piso));
+    const next = larguras.slice();
+    next[boundary] = arredonda(a + d);
+    next[boundary + 1] = arredonda(b - d);
     attrsMap.set("colWidths", next);
   });
 }
+var MIN_TABELA_PCT = 20;
+var MAX_TABELA_PCT = 100;
+function travaLarguraTabela(pct) {
+  return Math.max(MIN_TABELA_PCT, Math.min(MAX_TABELA_PCT, pct));
+}
+function setTableWidth(ctx, blockIndex, pct) {
+  if (!ctx.doc.isTable(blockIndex)) return;
+  const v = travaLarguraTabela(arredonda(pct));
+  transact(ctx.doc, () => {
+    ctx.doc.getBlockAttrsMap(blockIndex)?.set("tableWidth", v);
+  });
+}
+var MIN_LINHA_PX = 16;
+function setRowHeight(ctx, blockIndex, row, px) {
+  if (!ctx.doc.isTable(blockIndex)) return;
+  const { rows } = ctx.doc.getTableSize(blockIndex);
+  if (row < 0 || row >= rows) return;
+  transact(ctx.doc, () => {
+    const attrsMap = ctx.doc.getBlockAttrsMap(blockIndex);
+    if (!attrsMap) return;
+    const atual = attrsMap.get("rowHeights");
+    const base = Array.isArray(atual) && atual.length === rows ? atual.slice() : new Array(rows).fill(MIN_LINHA_PX);
+    base[row] = Math.max(MIN_LINHA_PX, Math.round(px));
+    attrsMap.set("rowHeights", base);
+  });
+}
+function setRowHeights(ctx, blockIndex, heights) {
+  if (!ctx.doc.isTable(blockIndex)) return;
+  const { rows } = ctx.doc.getTableSize(blockIndex);
+  if (heights.length !== rows) return;
+  transact(ctx.doc, () => {
+    const attrsMap = ctx.doc.getBlockAttrsMap(blockIndex);
+    if (!attrsMap) return;
+    attrsMap.set(
+      "rowHeights",
+      heights.map((h) => Math.max(MIN_LINHA_PX, Math.round(h)))
+    );
+  });
+}
 function moveToNextCell(ctx) {
   const sel = ctx.getSelection();
   const loc = tableLocationOf(ctx.doc, sel.focus);
@@ -2207,6 +2304,9 @@ export {
   EditorHistory,
   MARGIN_PRESETS,
   MAX_LIST_LEVEL,
+  MAX_TABELA_PCT,
+  MIN_LINHA_PX,
+  MIN_TABELA_PCT,
   PAGE_PRESETS,
   SOFER_MIME,
   TABLE_BORDER_COLOR,
@@ -2249,6 +2349,8 @@ export {
   insertText,
   isCollapsed,
   isCommandOrigin,
+  isEmbedAdjacentToCaret,
+  isFormulaEmbed,
   isImageEmbed,
   isKnownBlockType,
   isLegacySerializedDocument,
@@ -2261,6 +2363,7 @@ export {
   moveToNextCell,
   moveToPrevCell,
   newBlockId,
+  normalizarLarguras,
   orderedRange,
   positionsEqual,
   pxToMm,
@@ -2271,9 +2374,12 @@ export {
   setBlockAttrAtIndex,
   setBlockType,
   setCellAttr,
-  setColumnWidth,
+  setColumnBoundary,
   setImageAttrs,
   setMark,
+  setRowHeight,
+  setRowHeights,
+  setTableWidth,
   sliceDelta,
   sliceToInlineDelta,
   sliceToText,
@@ -2286,6 +2392,7 @@ export {
   tableRectSelection,
   toggleList,
   toggleMark,
+  travaLarguraTabela,
   withDefaults
 };
 //# sourceMappingURL=index.js.map