@sofereditor/core 0.3.1 → 0.4.0

package/dist/index.d.cts

@@ -91,6 +91,13 @@ type ListKind = "bullet" | "ordered";
 type ListStyleType = "decimal" | "lower-alpha" | "upper-alpha" | "lower-roman" | "upper-roman";
 /** Maximum supported list nesting (0 = top level). */
 declare const MAX_LIST_LEVEL = 5;
+/** Entrelinha de uma linha de resposta: simples, 1,5 ou dupla. */
+type AnswerLineSpacing = 1 | 1.5 | 2;
+/**
+ * Onde as linhas da grade de uma tabela aparecem.
+ * Vocabulário nativo de `w:tblBorders` (top/left/bottom/right/insideH/insideV).
+ */
+type TableBorderPreset = "all" | "outer" | "horizontal" | "vertical" | "none";
 interface BlockAttrs {
     align?: AlignValue;
     dir?: DirValue;
@@ -126,6 +133,24 @@ interface BlockAttrs {
      * an auto distribution at render time.
      */
     colWidths?: number[];
+    /**
+     * Só relevante quando `type === "table"`. Onde as linhas da grade aparecem.
+     * Ausente = "all" — documentos existentes não mudam de aparência.
+     */
+    borderPreset?: TableBorderPreset;
+    /**
+     * Só relevante quando `type === "paragraph"`. Parágrafo pautado para o aluno
+     * escrever a resposta: renderiza com régua inferior de largura total.
+     */
+    answerLine?: true;
+    /**
+     * Só relevante quando `answerLine`. Entrelinha. Ausente = 1.
+     *
+     * Deliberadamente escopado a linhas de resposta em vez de um `lineSpacing`
+     * genérico de parágrafo: entrelinha geral mudaria a medição de paginação de
+     * TODO parágrafo do documento, o que é outra feature com outro raio de impacto.
+     */
+    answerLineSpacing?: AnswerLineSpacing;
 }
 interface CellAttrs {
     /**
@@ -146,6 +171,8 @@ interface CellAttrs {
     covered?: true;
     /** Alinhamento horizontal do texto da célula. Mesmos valores de bloco. */
     align?: AlignValue;
+    /** Cor de fundo da célula (CSS color, ex. `#ffe58f`). Ausente = sem fundo. */
+    bgColor?: string;
 }
 interface Position {
     blockIndex: number;
@@ -163,7 +190,7 @@ interface Selection {
     anchor: Position;
     focus: Position;
 }
-type MarkName = "bold" | "italic" | "underline" | "strike" | "color" | "fontFamily" | "fontSize" | "link" | "comment";
+type MarkName = "bold" | "italic" | "underline" | "strike" | "color" | "highlight" | "fontFamily" | "fontSize" | "link" | "comment";
 interface LinkAttr {
     href: string;
     title?: string;
@@ -178,6 +205,8 @@ interface MarkAttrs {
     underline?: true;
     strike?: true;
     color?: string;
+    /** Cor de fundo do texto (marca-texto). CSS color, ex. `#fff176`. */
+    highlight?: string;
     fontFamily?: string;
     fontSize?: string;
     link?: LinkAttr;
@@ -448,6 +477,115 @@ declare function deltaLength(delta: DeltaOp[]): number;
  */
 declare function sliceDelta(delta: DeltaOp[], start: number, end: number): DeltaOp[];
 
+/**
+ * Helpers puros de decoração visual, compartilhados pelos DOIS renderizadores
+ * (`@sofereditor/react` e `@sofereditor/export-pdf`).
+ *
+ * Ficam aqui, e não dentro de cada renderizador, porque decoração divergente
+ * entre editor e PDF é exatamente o modo de falha que a fidelidade de impressão
+ * do projeto existe para impedir.
+ */
+
+/** Estilo CSS em camelCase — compatível com `CSSProperties` do React. */
+type StyleRecord = Record<string, string>;
+/** Mínimo de underlines consecutivos que viram lacuna. */
+declare const BLANK_MIN_RUN = 3;
+/**
+ * Segmenta um texto em trechos normais e corridas de `BLANK_MIN_RUN`+ underlines.
+ *
+ * INVARIANTE: a concatenação dos segmentos reconstrói o texto original
+ * caractere a caractere. Os offsets do modelo dependem disso — `dom-bridge`
+ * mapeia posição de DOM para offset somando `textContent.length`, então dividir
+ * uma run em sub-spans é seguro, mas introduzir ou remover caracteres não é.
+ */
+declare function splitUnderscoreRuns(text: string): Array<{
+    text: string;
+    blank: boolean;
+}>;
+/**
+ * Estilo da lacuna: uma corrida de underlines vira um traço contínuo, sem
+ * serrilhado, com a largura exata da sequência digitada.
+ *
+ * `-webkit-text-fill-color` apaga o GLIFO mas preserva `color`.
+ *
+ * O traço é `border-bottom`, e NÃO `text-decoration: underline`: no Chrome o
+ * `-webkit-text-fill-color` também apaga a decoração de texto — inclusive com
+ * `text-decoration-color: currentColor`, que resolve para a cor de
+ * PREENCHIMENTO, não para `color`. Verificado no navegador: a variante com
+ * `underline` renderiza uma lacuna completamente invisível. `border-bottom`
+ * com `currentColor` resolve para `color` e acompanha a mark de cor do run.
+ *
+ * PROIBIDO acrescentar aqui: `display`, `padding`, `margin`, `letterSpacing`,
+ * `width`. Qualquer um desloca métricas e a paginação diverge do PDF. Bordas de
+ * elemento inline não afetam a altura da linha — medido: linha com e sem
+ * lacuna tem exatamente a mesma altura e a mesma largura.
+ */
+declare const BLANK_STYLE: StyleRecord;
+/** Cor da régua da linha de resposta. Preto: é uma linha para escrever à caneta. */
+declare const ANSWER_LINE_COLOR = "#000000";
+/**
+ * Estilo do parágrafo pautado. `undefined` quando o bloco não é linha de
+ * resposta, para o renderizador não emitir atributo `style` à toa.
+ *
+ * Diferente das bordas de tabela (cuja geometria é invariante por construção),
+ * `lineHeight` muda a altura medida do bloco DE PROPÓSITO — a paginação precisa
+ * medir o resultado, não presumir a entrelinha.
+ */
+declare function answerLineStyle(attrs: BlockAttrs): StyleRecord | undefined;
+/** Converte um `StyleRecord` camelCase em texto CSS (`a:b;c:d`). */
+declare function styleToCssText(style: StyleRecord): string;
+
+/** Cor da grade. Mesmo valor que o CSS de `.ed-cell` já usa. */
+declare const TABLE_BORDER_COLOR = "#cbd5e1";
+/**
+ * Guia de tela para lados de borda desligados por preset.
+ *
+ * É uma custom property com fallback `transparent`: sem a variável definida
+ * (consumidor sem CSS próprio, ou dentro de `@media print`), o lado
+ * simplesmente não aparece — que é o correto para impressão. Nunca muda a
+ * geometria: o lado continua com 1px, só sem cor.
+ */
+declare const TABLE_GUIDE_COLOR = "var(--ed-guide-color, transparent)";
+interface CellBorderPos {
+    /** Linha absoluta da célula na tabela lógica. */
+    row: number;
+    /** Coluna absoluta. */
+    col: number;
+    rowspan: number;
+    colspan: number;
+    /** Total de colunas da tabela. */
+    cols: number;
+    /** Primeira linha do fragmento renderizado. Tabela inteira = 0. */
+    rowStart: number;
+    /** Fim exclusivo do fragmento. Tabela inteira = `rows`. */
+    rowEnd: number;
+}
+interface CellBorderColors {
+    top: string;
+    right: string;
+    bottom: string;
+    left: string;
+}
+/**
+ * Cor de cada lado da célula segundo o preset.
+ *
+ * NUNCA devolve espessura. Trocar de preset muda só cor, então nenhuma linha
+ * reflui e a paginação já validada não se mexe. Como todas as bordas têm a
+ * mesma espessura e o mesmo estilo em toda a tabela, também não há conflito de
+ * `border-collapse` para resolver.
+ *
+ * As bordas externas seguem os limites do FRAGMENTO, não da tabela lógica: numa
+ * tabela quebrada entre páginas, cada página fecha a própria caixa — o
+ * comportamento do Word.
+ *
+ * O teste de "toca a borda" usa row/col + spans em vez dos seletores CSS
+ * `:first-child`/`:last-child`, que quebram assim que uma célula `covered` some
+ * do DOM por causa de um rowspan.
+ */
+declare function cellBorderColors(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): CellBorderColors;
+/** `cellBorderColors` no formato de estilo inline consumido pelos renderizadores. */
+declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): StyleRecord;
+
 /** MIME custom que carrega o slice serializado no clipboard. */
 declare const SOFER_MIME = "application/x-sofer-slice";
 interface ClipboardSlice {
@@ -513,6 +651,14 @@ declare function setBlockType(ctx: CommandContext, type: BlockType, attrs?: Bloc
  * Passing `value === null` deletes the key.
  */
 declare function setBlockAttr<K extends keyof BlockAttrs>(ctx: CommandContext, key: K, value: BlockAttrs[K] | null): void;
+/**
+ * Como `setBlockAttr`, mas em um bloco específico por índice.
+ *
+ * Existe porque `setBlockAttr` opera sobre a seleção e é INERTE quando o caret
+ * está dentro de uma célula — que é exatamente a situação em que se quer mudar
+ * um atributo da tabela (ex.: preset de borda).
+ */
+declare function setBlockAttrAtIndex<K extends keyof BlockAttrs>(ctx: CommandContext, blockIndex: number, key: K, value: BlockAttrs[K] | null): void;
 /**
  * Set a single attribute on the table cell(s) under the selection.
  * - Caret numa única célula → essa célula (tableRectSelection retorna null
@@ -565,6 +711,16 @@ declare function splitListItem(ctx: CommandContext): boolean;
  * preceding paragraph. Callers can clean that up themselves; an extra empty
  * paragraph above a table is a small price for predictable behavior.
  */
+/** Teto de linhas por inserção — protege contra digitar 5000 no popover. */
+declare const ANSWER_LINE_MAX = 50;
+/**
+ * Insere `count` parágrafos pautados depois do bloco focado, numa única
+ * transação (um passo de undo desfaz todos).
+ *
+ * Se o caret estiver dentro de uma célula, `focus.blockIndex` já aponta para a
+ * TABELA, então as linhas entram depois dela — nunca dentro.
+ */
+declare function insertAnswerLines(ctx: CommandContext, count: number, spacing: AnswerLineSpacing): void;
 declare function insertTable(ctx: CommandContext, rows: number, cols: number): void;
 /** Remove the entire table at `blockIndex` and place the caret at the start of the next block (or the previous one if removal would leave the doc empty). */
 declare function deleteTable(ctx: CommandContext, blockIndex: number): void;
@@ -730,4 +886,4 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, 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, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, 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, setBlockType, setCellAttr, setColumnWidth, setImageAttrs, setMark, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitListItem, 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, 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 };

package/dist/index.d.ts

@@ -91,6 +91,13 @@ type ListKind = "bullet" | "ordered";
 type ListStyleType = "decimal" | "lower-alpha" | "upper-alpha" | "lower-roman" | "upper-roman";
 /** Maximum supported list nesting (0 = top level). */
 declare const MAX_LIST_LEVEL = 5;
+/** Entrelinha de uma linha de resposta: simples, 1,5 ou dupla. */
+type AnswerLineSpacing = 1 | 1.5 | 2;
+/**
+ * Onde as linhas da grade de uma tabela aparecem.
+ * Vocabulário nativo de `w:tblBorders` (top/left/bottom/right/insideH/insideV).
+ */
+type TableBorderPreset = "all" | "outer" | "horizontal" | "vertical" | "none";
 interface BlockAttrs {
     align?: AlignValue;
     dir?: DirValue;
@@ -126,6 +133,24 @@ interface BlockAttrs {
      * an auto distribution at render time.
      */
     colWidths?: number[];
+    /**
+     * Só relevante quando `type === "table"`. Onde as linhas da grade aparecem.
+     * Ausente = "all" — documentos existentes não mudam de aparência.
+     */
+    borderPreset?: TableBorderPreset;
+    /**
+     * Só relevante quando `type === "paragraph"`. Parágrafo pautado para o aluno
+     * escrever a resposta: renderiza com régua inferior de largura total.
+     */
+    answerLine?: true;
+    /**
+     * Só relevante quando `answerLine`. Entrelinha. Ausente = 1.
+     *
+     * Deliberadamente escopado a linhas de resposta em vez de um `lineSpacing`
+     * genérico de parágrafo: entrelinha geral mudaria a medição de paginação de
+     * TODO parágrafo do documento, o que é outra feature com outro raio de impacto.
+     */
+    answerLineSpacing?: AnswerLineSpacing;
 }
 interface CellAttrs {
     /**
@@ -146,6 +171,8 @@ interface CellAttrs {
     covered?: true;
     /** Alinhamento horizontal do texto da célula. Mesmos valores de bloco. */
     align?: AlignValue;
+    /** Cor de fundo da célula (CSS color, ex. `#ffe58f`). Ausente = sem fundo. */
+    bgColor?: string;
 }
 interface Position {
     blockIndex: number;
@@ -163,7 +190,7 @@ interface Selection {
     anchor: Position;
     focus: Position;
 }
-type MarkName = "bold" | "italic" | "underline" | "strike" | "color" | "fontFamily" | "fontSize" | "link" | "comment";
+type MarkName = "bold" | "italic" | "underline" | "strike" | "color" | "highlight" | "fontFamily" | "fontSize" | "link" | "comment";
 interface LinkAttr {
     href: string;
     title?: string;
@@ -178,6 +205,8 @@ interface MarkAttrs {
     underline?: true;
     strike?: true;
     color?: string;
+    /** Cor de fundo do texto (marca-texto). CSS color, ex. `#fff176`. */
+    highlight?: string;
     fontFamily?: string;
     fontSize?: string;
     link?: LinkAttr;
@@ -448,6 +477,115 @@ declare function deltaLength(delta: DeltaOp[]): number;
  */
 declare function sliceDelta(delta: DeltaOp[], start: number, end: number): DeltaOp[];
 
+/**
+ * Helpers puros de decoração visual, compartilhados pelos DOIS renderizadores
+ * (`@sofereditor/react` e `@sofereditor/export-pdf`).
+ *
+ * Ficam aqui, e não dentro de cada renderizador, porque decoração divergente
+ * entre editor e PDF é exatamente o modo de falha que a fidelidade de impressão
+ * do projeto existe para impedir.
+ */
+
+/** Estilo CSS em camelCase — compatível com `CSSProperties` do React. */
+type StyleRecord = Record<string, string>;
+/** Mínimo de underlines consecutivos que viram lacuna. */
+declare const BLANK_MIN_RUN = 3;
+/**
+ * Segmenta um texto em trechos normais e corridas de `BLANK_MIN_RUN`+ underlines.
+ *
+ * INVARIANTE: a concatenação dos segmentos reconstrói o texto original
+ * caractere a caractere. Os offsets do modelo dependem disso — `dom-bridge`
+ * mapeia posição de DOM para offset somando `textContent.length`, então dividir
+ * uma run em sub-spans é seguro, mas introduzir ou remover caracteres não é.
+ */
+declare function splitUnderscoreRuns(text: string): Array<{
+    text: string;
+    blank: boolean;
+}>;
+/**
+ * Estilo da lacuna: uma corrida de underlines vira um traço contínuo, sem
+ * serrilhado, com a largura exata da sequência digitada.
+ *
+ * `-webkit-text-fill-color` apaga o GLIFO mas preserva `color`.
+ *
+ * O traço é `border-bottom`, e NÃO `text-decoration: underline`: no Chrome o
+ * `-webkit-text-fill-color` também apaga a decoração de texto — inclusive com
+ * `text-decoration-color: currentColor`, que resolve para a cor de
+ * PREENCHIMENTO, não para `color`. Verificado no navegador: a variante com
+ * `underline` renderiza uma lacuna completamente invisível. `border-bottom`
+ * com `currentColor` resolve para `color` e acompanha a mark de cor do run.
+ *
+ * PROIBIDO acrescentar aqui: `display`, `padding`, `margin`, `letterSpacing`,
+ * `width`. Qualquer um desloca métricas e a paginação diverge do PDF. Bordas de
+ * elemento inline não afetam a altura da linha — medido: linha com e sem
+ * lacuna tem exatamente a mesma altura e a mesma largura.
+ */
+declare const BLANK_STYLE: StyleRecord;
+/** Cor da régua da linha de resposta. Preto: é uma linha para escrever à caneta. */
+declare const ANSWER_LINE_COLOR = "#000000";
+/**
+ * Estilo do parágrafo pautado. `undefined` quando o bloco não é linha de
+ * resposta, para o renderizador não emitir atributo `style` à toa.
+ *
+ * Diferente das bordas de tabela (cuja geometria é invariante por construção),
+ * `lineHeight` muda a altura medida do bloco DE PROPÓSITO — a paginação precisa
+ * medir o resultado, não presumir a entrelinha.
+ */
+declare function answerLineStyle(attrs: BlockAttrs): StyleRecord | undefined;
+/** Converte um `StyleRecord` camelCase em texto CSS (`a:b;c:d`). */
+declare function styleToCssText(style: StyleRecord): string;
+
+/** Cor da grade. Mesmo valor que o CSS de `.ed-cell` já usa. */
+declare const TABLE_BORDER_COLOR = "#cbd5e1";
+/**
+ * Guia de tela para lados de borda desligados por preset.
+ *
+ * É uma custom property com fallback `transparent`: sem a variável definida
+ * (consumidor sem CSS próprio, ou dentro de `@media print`), o lado
+ * simplesmente não aparece — que é o correto para impressão. Nunca muda a
+ * geometria: o lado continua com 1px, só sem cor.
+ */
+declare const TABLE_GUIDE_COLOR = "var(--ed-guide-color, transparent)";
+interface CellBorderPos {
+    /** Linha absoluta da célula na tabela lógica. */
+    row: number;
+    /** Coluna absoluta. */
+    col: number;
+    rowspan: number;
+    colspan: number;
+    /** Total de colunas da tabela. */
+    cols: number;
+    /** Primeira linha do fragmento renderizado. Tabela inteira = 0. */
+    rowStart: number;
+    /** Fim exclusivo do fragmento. Tabela inteira = `rows`. */
+    rowEnd: number;
+}
+interface CellBorderColors {
+    top: string;
+    right: string;
+    bottom: string;
+    left: string;
+}
+/**
+ * Cor de cada lado da célula segundo o preset.
+ *
+ * NUNCA devolve espessura. Trocar de preset muda só cor, então nenhuma linha
+ * reflui e a paginação já validada não se mexe. Como todas as bordas têm a
+ * mesma espessura e o mesmo estilo em toda a tabela, também não há conflito de
+ * `border-collapse` para resolver.
+ *
+ * As bordas externas seguem os limites do FRAGMENTO, não da tabela lógica: numa
+ * tabela quebrada entre páginas, cada página fecha a própria caixa — o
+ * comportamento do Word.
+ *
+ * O teste de "toca a borda" usa row/col + spans em vez dos seletores CSS
+ * `:first-child`/`:last-child`, que quebram assim que uma célula `covered` some
+ * do DOM por causa de um rowspan.
+ */
+declare function cellBorderColors(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): CellBorderColors;
+/** `cellBorderColors` no formato de estilo inline consumido pelos renderizadores. */
+declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): StyleRecord;
+
 /** MIME custom que carrega o slice serializado no clipboard. */
 declare const SOFER_MIME = "application/x-sofer-slice";
 interface ClipboardSlice {
@@ -513,6 +651,14 @@ declare function setBlockType(ctx: CommandContext, type: BlockType, attrs?: Bloc
  * Passing `value === null` deletes the key.
  */
 declare function setBlockAttr<K extends keyof BlockAttrs>(ctx: CommandContext, key: K, value: BlockAttrs[K] | null): void;
+/**
+ * Como `setBlockAttr`, mas em um bloco específico por índice.
+ *
+ * Existe porque `setBlockAttr` opera sobre a seleção e é INERTE quando o caret
+ * está dentro de uma célula — que é exatamente a situação em que se quer mudar
+ * um atributo da tabela (ex.: preset de borda).
+ */
+declare function setBlockAttrAtIndex<K extends keyof BlockAttrs>(ctx: CommandContext, blockIndex: number, key: K, value: BlockAttrs[K] | null): void;
 /**
  * Set a single attribute on the table cell(s) under the selection.
  * - Caret numa única célula → essa célula (tableRectSelection retorna null
@@ -565,6 +711,16 @@ declare function splitListItem(ctx: CommandContext): boolean;
  * preceding paragraph. Callers can clean that up themselves; an extra empty
  * paragraph above a table is a small price for predictable behavior.
  */
+/** Teto de linhas por inserção — protege contra digitar 5000 no popover. */
+declare const ANSWER_LINE_MAX = 50;
+/**
+ * Insere `count` parágrafos pautados depois do bloco focado, numa única
+ * transação (um passo de undo desfaz todos).
+ *
+ * Se o caret estiver dentro de uma célula, `focus.blockIndex` já aponta para a
+ * TABELA, então as linhas entram depois dela — nunca dentro.
+ */
+declare function insertAnswerLines(ctx: CommandContext, count: number, spacing: AnswerLineSpacing): void;
 declare function insertTable(ctx: CommandContext, rows: number, cols: number): void;
 /** Remove the entire table at `blockIndex` and place the caret at the start of the next block (or the previous one if removal would leave the doc empty). */
 declare function deleteTable(ctx: CommandContext, blockIndex: number): void;
@@ -730,4 +886,4 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, CLEAR_ALL_MARKS, COMMAND_ORIGIN, type CellAttrs, 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, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, decodeSelection, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteSelection, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, encodeSelection, expandTableRect, getBlockId, getMarksInRange, indentList, 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, setBlockType, setCellAttr, setColumnWidth, setImageAttrs, setMark, sliceDelta, sliceToInlineDelta, sliceToText, spanOf, splitCell, splitListItem, 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, 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 };

package/dist/index.js

@@ -591,6 +591,7 @@ var ALL_MARKS = {
   underline: true,
   strike: true,
   color: true,
+  highlight: true,
   fontFamily: true,
   fontSize: true,
   link: true,
@@ -722,6 +723,88 @@ function sameMarkValue(a, b) {
   return false;
 }
 
+// src/decorations.ts
+var BLANK_MIN_RUN = 3;
+function splitUnderscoreRuns(text) {
+  if (text.length === 0) return [];
+  const re = new RegExp(`_{${BLANK_MIN_RUN},}`, "g");
+  const out = [];
+  let last = 0;
+  let match;
+  while ((match = re.exec(text)) !== null) {
+    if (match.index > last) out.push({ text: text.slice(last, match.index), blank: false });
+    out.push({ text: match[0], blank: true });
+    last = match.index + match[0].length;
+  }
+  if (last < text.length) out.push({ text: text.slice(last), blank: false });
+  return out;
+}
+var BLANK_STYLE = {
+  WebkitTextFillColor: "transparent",
+  borderBottom: "1px solid currentColor"
+};
+var ANSWER_LINE_COLOR = "#000000";
+function answerLineStyle(attrs) {
+  if (attrs.answerLine !== true) return void 0;
+  const spacing = attrs.answerLineSpacing ?? 1;
+  return {
+    borderBottom: `1px solid ${ANSWER_LINE_COLOR}`,
+    lineHeight: String(spacing),
+    // `minHeight` casado com a entrelinha, e NÃO redundante: o CSS do
+    // consumidor costuma trazer `min-height` em parágrafo (o playground usa
+    // 1.5em "para manter parágrafo vazio visível"). Sem esta linha, "Simples"
+    // e "1,5" renderizariam com a mesma altura.
+    minHeight: `${spacing}em`
+  };
+}
+function styleToCssText(style) {
+  return Object.entries(style).map(([k, v]) => `${kebab(k)}:${v}`).join(";");
+}
+function kebab(prop) {
+  if (prop.startsWith("--")) return prop;
+  return prop.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+
+// src/table-borders.ts
+var TABLE_BORDER_COLOR = "#cbd5e1";
+var TABLE_GUIDE_COLOR = "var(--ed-guide-color, transparent)";
+function cellBorderColors(preset, pos, variant) {
+  const on = TABLE_BORDER_COLOR;
+  const off = variant === "screen" ? TABLE_GUIDE_COLOR : "transparent";
+  switch (preset ?? "all") {
+    case "horizontal":
+      return { top: on, right: off, bottom: on, left: off };
+    case "vertical":
+      return { top: off, right: on, bottom: off, left: on };
+    case "none":
+      return { top: off, right: off, bottom: off, left: off };
+    case "outer": {
+      const isTop = pos.row === pos.rowStart;
+      const isBottom = pos.row + Math.max(1, pos.rowspan) - 1 === pos.rowEnd - 1;
+      const isLeft = pos.col === 0;
+      const isRight = pos.col + Math.max(1, pos.colspan) - 1 === pos.cols - 1;
+      return {
+        top: isTop ? on : off,
+        right: isRight ? on : off,
+        bottom: isBottom ? on : off,
+        left: isLeft ? on : off
+      };
+    }
+    case "all":
+    default:
+      return { top: on, right: on, bottom: on, left: on };
+  }
+}
+function cellBorderStyle(preset, pos, variant) {
+  const c = cellBorderColors(preset, pos, variant);
+  return {
+    borderTopColor: c.top,
+    borderRightColor: c.right,
+    borderBottomColor: c.bottom,
+    borderLeftColor: c.left
+  };
+}
+
 // src/commands.ts
 import * as Y3 from "yjs";
 
@@ -1046,6 +1129,16 @@ function setBlockAttr(ctx, key, value) {
     ctx.setSelection(sel);
   });
 }
+function setBlockAttrAtIndex(ctx, blockIndex, key, value) {
+  transact(ctx.doc, () => {
+    const block = ctx.doc.getBlock(blockIndex);
+    if (!block) return;
+    const attrsMap = block.get("attrs") ?? new Y3.Map();
+    if (!block.get("attrs")) block.set("attrs", attrsMap);
+    if (value === null || value === void 0) attrsMap.delete(key);
+    else attrsMap.set(key, value);
+  });
+}
 function setCellAttr(ctx, key, value) {
   transact(ctx.doc, () => {
     const sel = ctx.getSelection();
@@ -1314,6 +1407,19 @@ function clampLevel(l) {
   if (typeof l !== "number" || !Number.isFinite(l)) return 0;
   return Math.max(0, Math.min(MAX_LIST_LEVEL, Math.trunc(l)));
 }
+var ANSWER_LINE_MAX = 50;
+function insertAnswerLines(ctx, count, spacing) {
+  const n = Math.max(1, Math.min(ANSWER_LINE_MAX, Math.trunc(count)));
+  transact(ctx.doc, () => {
+    const sel = ctx.getSelection();
+    const focusBlock = Math.max(0, Math.min(sel.focus.blockIndex, ctx.doc.blockCount() - 1));
+    const insertAt = focusBlock + 1;
+    const attrs = { answerLine: true, answerLineSpacing: spacing };
+    const blocks = Array.from({ length: n }, () => createBlock("paragraph", "", attrs));
+    ctx.doc.blocks.insert(insertAt, blocks);
+    ctx.setSelection(collapsedSelection({ blockIndex: insertAt, offset: 0 }));
+  });
+}
 function insertTable(ctx, rows, cols) {
   const r = Math.max(1, Math.trunc(rows));
   const c = Math.max(1, Math.trunc(cols));
@@ -2061,6 +2167,10 @@ var EditorHistory = class {
   }
 };
 export {
+  ANSWER_LINE_COLOR,
+  ANSWER_LINE_MAX,
+  BLANK_MIN_RUN,
+  BLANK_STYLE,
   BLOCK_SPECS,
   CLEAR_ALL_MARKS,
   COMMAND_ORIGIN,
@@ -2071,8 +2181,13 @@ export {
   MAX_LIST_LEVEL,
   PAGE_PRESETS,
   SOFER_MIME,
+  TABLE_BORDER_COLOR,
+  TABLE_GUIDE_COLOR,
   TRACKED_ORIGINS,
   Y3 as Y,
+  answerLineStyle,
+  cellBorderColors,
+  cellBorderStyle,
   cellsInRect,
   clearRectCells,
   collapsedSelection,
@@ -2096,6 +2211,7 @@ export {
   getBlockId,
   getMarksInRange,
   indentList,
+  insertAnswerLines,
   insertImage,
   insertParagraph,
   insertSlice,
@@ -2124,6 +2240,7 @@ export {
   sameTextRun,
   serializeSelection,
   setBlockAttr,
+  setBlockAttrAtIndex,
   setBlockType,
   setCellAttr,
   setColumnWidth,
@@ -2135,6 +2252,8 @@ export {
   spanOf,
   splitCell,
   splitListItem,
+  splitUnderscoreRuns,
+  styleToCssText,
   tableLocationOf,
   tableRectSelection,
   toggleList,