@sofereditor/core 0.9.0 → 0.10.1

package/dist/index.d.cts

@@ -191,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;
@@ -531,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
@@ -1055,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, 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 };
+/**
+ * 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

@@ -191,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;
@@ -531,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
@@ -1055,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, 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 };
+/**
+ * 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.js

@@ -725,6 +725,25 @@ function sameMarkValue(a, b) {
   }
   return false;
 }
+function splitDeltaByLines(delta) {
+  const lines = [[]];
+  for (const op of delta) {
+    if (typeof op.insert !== "string") {
+      lines[lines.length - 1].push(op);
+      continue;
+    }
+    const parts = op.insert.split("\n");
+    for (let i = 0; i < parts.length; i++) {
+      if (i > 0) lines.push([]);
+      const part = parts[i];
+      if (part.length === 0) continue;
+      lines[lines.length - 1].push(
+        op.attributes ? { insert: part, attributes: op.attributes } : { insert: part }
+      );
+    }
+  }
+  return lines;
+}
 
 // src/decorations.ts
 var BLANK_MIN_RUN = 3;
@@ -1348,7 +1367,12 @@ function mergeWithPrevious(ctx, blockIndex) {
 function toggleList(ctx, kind) {
   transact(ctx.doc, () => {
     const sel = ctx.getSelection();
-    if (sel.anchor.cellIndex != null || sel.focus.cellIndex != null) return;
+    if (sel.anchor.cellIndex != null || sel.focus.cellIndex != null) {
+      const real = sel.focus.cellIndex != null ? ctx.doc.realCellIndex(sel.focus.blockIndex, sel.focus.cellIndex) : void 0;
+      const atual = real != null ? ctx.doc.getCellAttrs(sel.focus.blockIndex, real).listKind : void 0;
+      setCellAttr(ctx, "listKind", atual === kind ? null : kind);
+      return;
+    }
     const indices = selectedBlockIndices(sel, ctx.doc.blockCount());
     const allMatching = indices.every((i) => {
       const block = ctx.doc.getBlock(i);
@@ -2291,6 +2315,45 @@ var EditorHistory = class {
     this.undoManager.destroy();
   }
 };
+
+// src/migrations.ts
+function coletar(yText, alvos) {
+  if (!yText) return 0;
+  const delta = yText.toDelta();
+  const ranges = [];
+  let index = 0;
+  for (const op of delta) {
+    const len = typeof op.insert === "string" ? op.insert.length : 1;
+    if (typeof op.insert === "string" && op.attributes && "fontFamily" in op.attributes) {
+      ranges.push([index, len]);
+    }
+    index += len;
+  }
+  if (ranges.length > 0) alvos.push({ yText, ranges });
+  return ranges.length;
+}
+function stripFontFamilyMarks(doc, opts) {
+  const alvos = [];
+  let total = 0;
+  for (let i = 0; i < doc.blockCount(); i++) {
+    total += coletar(doc.getBlockText(i), alvos);
+    const cells = doc.getCells(i);
+    if (cells) {
+      for (let c = 0; c < cells.length; c++) {
+        total += coletar(doc.getCellText(i, c), alvos);
+      }
+    }
+  }
+  if (total === 0 || opts?.dryRun) return total;
+  doc.ydoc.transact(() => {
+    for (const { yText, ranges } of alvos) {
+      for (const [index, length] of ranges) {
+        yText.format(index, length, { fontFamily: null });
+      }
+    }
+  }, "migration");
+  return total;
+}
 export {
   ANSWER_LINE_COLOR,
   ANSWER_LINE_MAX,
@@ -2385,8 +2448,10 @@ export {
   sliceToText,
   spanOf,
   splitCell,
+  splitDeltaByLines,
   splitListItem,
   splitUnderscoreRuns,
+  stripFontFamilyMarks,
   styleToCssText,
   tableLocationOf,
   tableRectSelection,