@sofereditor/core 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -138,6 +138,11 @@ interface BlockAttrs {
      * Ausente = "all" — documentos existentes não mudam de aparência.
      */
     borderPreset?: TableBorderPreset;
+    /**
+     * Só relevante quando `type === "table"`. Cor das linhas da grade.
+     * Ausente = `TABLE_BORDER_COLOR` — documentos existentes não mudam.
+     */
+    borderColor?: string;
     /**
      * Só relevante quando `type === "paragraph"`. Parágrafo pautado para o aluno
      * escrever a resposta: renderiza com régua inferior de largura total.
@@ -582,9 +587,9 @@ interface CellBorderColors {
  * `: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;
+declare function cellBorderColors(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print", color?: string): CellBorderColors;
 /** `cellBorderColors` no formato de estilo inline consumido pelos renderizadores. */
-declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): StyleRecord;
+declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print", color?: string): StyleRecord;
 
 /** MIME custom que carrega o slice serializado no clipboard. */
 declare const SOFER_MIME = "application/x-sofer-slice";
@@ -595,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:
@@ -673,7 +692,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).

package/dist/index.d.ts

@@ -138,6 +138,11 @@ interface BlockAttrs {
      * Ausente = "all" — documentos existentes não mudam de aparência.
      */
     borderPreset?: TableBorderPreset;
+    /**
+     * Só relevante quando `type === "table"`. Cor das linhas da grade.
+     * Ausente = `TABLE_BORDER_COLOR` — documentos existentes não mudam.
+     */
+    borderColor?: string;
     /**
      * Só relevante quando `type === "paragraph"`. Parágrafo pautado para o aluno
      * escrever a resposta: renderiza com régua inferior de largura total.
@@ -582,9 +587,9 @@ interface CellBorderColors {
  * `: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;
+declare function cellBorderColors(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print", color?: string): CellBorderColors;
 /** `cellBorderColors` no formato de estilo inline consumido pelos renderizadores. */
-declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print"): StyleRecord;
+declare function cellBorderStyle(preset: TableBorderPreset | undefined, pos: CellBorderPos, variant: "screen" | "print", color?: string): StyleRecord;
 
 /** MIME custom que carrega o slice serializado no clipboard. */
 declare const SOFER_MIME = "application/x-sofer-slice";
@@ -595,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:
@@ -673,7 +692,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).

package/dist/index.js

@@ -768,8 +768,8 @@ function kebab(prop) {
 // 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;
+function cellBorderColors(preset, pos, variant, color) {
+  const on = color && color.length > 0 ? color : TABLE_BORDER_COLOR;
   const off = variant === "screen" ? TABLE_GUIDE_COLOR : "transparent";
   switch (preset ?? "all") {
     case "horizontal":
@@ -795,8 +795,8 @@ function cellBorderColors(preset, pos, variant) {
       return { top: on, right: on, bottom: on, left: on };
   }
 }
-function cellBorderStyle(preset, pos, variant) {
-  const c = cellBorderColors(preset, pos, variant);
+function cellBorderStyle(preset, pos, variant, color) {
+  const c = cellBorderColors(preset, pos, variant, color);
   return {
     borderTopColor: c.top,
     borderRightColor: c.right,
@@ -1190,6 +1190,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);