@sofereditor/core 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -600,6 +600,20 @@ interface ClipboardSlice {
     openStart: boolean;
     /** último bloco é fragmento parcial → conteúdo após o caret continua nele. */
     openEnd: boolean;
+    /**
+     * Marca explícita: quando presente (`true`) e `blocks.length === 1`, esse
+     * único bloco é uma unidade INTEIRA (ex.: um `<h1>`/`<li>`/`<blockquote>`
+     * inteiro colado de fora) — `insertSlice` deve adotar o `type`/`attrs` dele
+     * em vez de tratá-lo como fragmento de uma seleção.
+     *
+     * `serializeSelection` NUNCA define este campo — uma cópia interna é sempre
+     * um fragmento de seleção, mesmo quando por coincidência cobre o bloco
+     * inteiro (nesse caso `openStart`/`openEnd` também saem `false`, mas isso
+     * não significa "bloco externo inteiro": significa apenas que a seleção
+     * tocou as bordas do bloco). Só produtores de blocos externos inteiros
+     * (hoje: `htmlToSlice`) devem marcar `blockLevel: true`.
+     */
+    blockLevel?: true;
 }
 /**
  * Lê a seleção e produz um ClipboardSlice, ou null se:
@@ -634,6 +648,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).
@@ -678,7 +708,18 @@ declare function setCellAttr<K extends keyof CellAttrs>(ctx: CommandContext, key
 declare function deleteSelection(ctx: CommandContext): void;
 /**
  * Replace the current selection with a clipboard slice (A1).
- * - Single-block slice → inline splice (Dhead + S0 + Dtail), target keeps its type.
+ * - Single-block slice WITHOUT `blockLevel` → always an inline splice
+ *   (Dhead + S0 + Dtail), target keeps its type. This is the internal
+ *   copy/paste shape, including a full-block internal copy (selecting an
+ *   entire line and copying it also yields `openStart:false, openEnd:false`
+ *   with one block — that is NOT the same thing as an external whole block;
+ *   `openStart`/`openEnd` do not carry that distinction, so branching on them
+ *   here regressed plain in-editor copy/paste. See `ClipboardSlice.blockLevel`.
+ * - Single-block slice WITH `blockLevel: true` (e.g. one <h1>/<li>/<blockquote>
+ *   from an HTML paste via `htmlToSlice`) → adopts S0's type/attrs instead,
+ *   same rules as the multi-block case below (reuse target in place when the
+ *   caret is at offset 0, otherwise insert S0 as its own block; any tail
+ *   becomes a separate block with the target's original type).
  * - Multi-block slice → openStart merges S0 inline; middle/last blocks inserted
  *   discretely; openEnd appends the post-caret tail onto the last pasted block.
  * - Target inside a table cell → slice flattened to inline (no block structure).
@@ -891,4 +932,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, 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 };

package/dist/index.d.ts

@@ -600,6 +600,20 @@ interface ClipboardSlice {
     openStart: boolean;
     /** último bloco é fragmento parcial → conteúdo após o caret continua nele. */
     openEnd: boolean;
+    /**
+     * Marca explícita: quando presente (`true`) e `blocks.length === 1`, esse
+     * único bloco é uma unidade INTEIRA (ex.: um `<h1>`/`<li>`/`<blockquote>`
+     * inteiro colado de fora) — `insertSlice` deve adotar o `type`/`attrs` dele
+     * em vez de tratá-lo como fragmento de uma seleção.
+     *
+     * `serializeSelection` NUNCA define este campo — uma cópia interna é sempre
+     * um fragmento de seleção, mesmo quando por coincidência cobre o bloco
+     * inteiro (nesse caso `openStart`/`openEnd` também saem `false`, mas isso
+     * não significa "bloco externo inteiro": significa apenas que a seleção
+     * tocou as bordas do bloco). Só produtores de blocos externos inteiros
+     * (hoje: `htmlToSlice`) devem marcar `blockLevel: true`.
+     */
+    blockLevel?: true;
 }
 /**
  * Lê a seleção e produz um ClipboardSlice, ou null se:
@@ -634,6 +648,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).
@@ -678,7 +708,18 @@ declare function setCellAttr<K extends keyof CellAttrs>(ctx: CommandContext, key
 declare function deleteSelection(ctx: CommandContext): void;
 /**
  * Replace the current selection with a clipboard slice (A1).
- * - Single-block slice → inline splice (Dhead + S0 + Dtail), target keeps its type.
+ * - Single-block slice WITHOUT `blockLevel` → always an inline splice
+ *   (Dhead + S0 + Dtail), target keeps its type. This is the internal
+ *   copy/paste shape, including a full-block internal copy (selecting an
+ *   entire line and copying it also yields `openStart:false, openEnd:false`
+ *   with one block — that is NOT the same thing as an external whole block;
+ *   `openStart`/`openEnd` do not carry that distinction, so branching on them
+ *   here regressed plain in-editor copy/paste. See `ClipboardSlice.blockLevel`.
+ * - Single-block slice WITH `blockLevel: true` (e.g. one <h1>/<li>/<blockquote>
+ *   from an HTML paste via `htmlToSlice`) → adopts S0's type/attrs instead,
+ *   same rules as the multi-block case below (reuse target in place when the
+ *   caret is at offset 0, otherwise insert S0 as its own block; any tail
+ *   becomes a separate block with the target's original type).
  * - Multi-block slice → openStart merges S0 inline; middle/last blocks inserted
  *   discretely; openEnd appends the post-caret tail onto the last pasted block.
  * - Target inside a table cell → slice flattened to inline (no block structure).
@@ -891,4 +932,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, 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 };

package/dist/index.js

@@ -1044,6 +1044,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();
@@ -1190,6 +1208,34 @@ function insertSlice(ctx, slice) {
     const tailDelta = sliceDelta(full, offset, deltaLength(full));
     targetText.delete(offset, targetText.length - offset);
     const blocks = slice.blocks;
+    if (blocks.length === 1 && slice.blockLevel) {
+      const originalType2 = ctx.doc.getBlockType(blockIndex);
+      const originalAttrs2 = ctx.doc.getBlockAttrs(blockIndex);
+      let hostIndex = blockIndex;
+      if (offset === 0) {
+        const blk = ctx.doc.blocks.get(blockIndex);
+        blk.set("type", blocks[0].type);
+        const am = blk.get("attrs");
+        am.clear();
+        for (const [k, v] of Object.entries(blocks[0].attrs)) {
+          if (v !== void 0) am.set(k, v);
+        }
+        writeDeltaInto(targetText, 0, blocks[0].delta);
+      } else {
+        hostIndex = blockIndex + 1;
+        const b = createBlock(blocks[0].type, "", blocks[0].attrs);
+        ctx.doc.blocks.insert(hostIndex, [b]);
+        writeDeltaInto(b.get("text"), 0, blocks[0].delta);
+      }
+      const caretPos = ctx.doc.getBlockText(hostIndex).length;
+      if (tailDelta.length > 0) {
+        const tb = createBlock(originalType2 ?? "paragraph", "", originalAttrs2);
+        ctx.doc.blocks.insert(hostIndex + 1, [tb]);
+        writeDeltaInto(tb.get("text"), 0, tailDelta);
+      }
+      ctx.setSelection(collapsedSelection({ blockIndex: hostIndex, offset: caretPos }));
+      return;
+    }
     if (blocks.length === 1) {
       const afterS0 = writeDeltaInto(targetText, offset, blocks[0].delta);
       writeDeltaInto(targetText, afterS0, tailDelta);
@@ -2221,6 +2267,7 @@ export {
   insertText,
   isCollapsed,
   isCommandOrigin,
+  isEmbedAdjacentToCaret,
   isImageEmbed,
   isKnownBlockType,
   isLegacySerializedDocument,