@sofereditor/core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -25,6 +25,27 @@ interface PageSettings {
      * This is purely a UI hint — it's recomputed from width/height when needed.
      */
     preset?: PagePreset;
+    /**
+     * Free-form title persisted on the document for a consumer-rendered
+     * "system header" (e.g. a non-editable letterhead/identification block
+     * drawn on page 1 via `renderPageHeader`). Stored in `docSettings` so it
+     * survives serialization and is visible to every client/consumer of the
+     * `SerializedDocument`, including headless exports.
+     *
+     * The renderer is application-defined — this field just transports the
+     * title string. Use it when the header content is part of the document
+     * (and therefore must round-trip through exports), not a UI chrome
+     * decoration.
+     */
+    systemHeaderTitle?: string;
+    /**
+     * Owner/author display name for the same consumer-rendered system
+     * header (see [[systemHeaderTitle]]). Useful when the header should
+     * show the document's CREATOR, not the current viewer (e.g. an author
+     * name on a doc viewed by a third party). Persisted in `docSettings`
+     * for consistent rendering across clients and headless renderers.
+     */
+    systemHeaderAuthor?: string;
 }
 /** Page sizes in CSS px @ 96dpi. */
 declare const PAGE_PRESETS: {
@@ -67,6 +88,7 @@ type BlockType = "paragraph" | "heading" | "blockquote" | "codeBlock" | "listIte
 type AlignValue = "left" | "center" | "right" | "justify";
 type DirValue = "ltr" | "rtl";
 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;
 interface BlockAttrs {
@@ -80,6 +102,20 @@ interface BlockAttrs {
     listKind?: ListKind;
     /** Only meaningful when `type === "listItem"`. 0..MAX_LIST_LEVEL. */
     listLevel?: number;
+    /**
+     * Only meaningful when `type === "listItem"` and `listKind === "ordered"`.
+     * When set on a listItem, that item starts a NEW list group whose first
+     * `<ol>` carries `start={listStart}`. Used to renumerate questions or pick
+     * up an interrupted sequence.
+     */
+    listStart?: number;
+    /**
+     * Only meaningful when `type === "listItem"`. Overrides the default per-level
+     * CSS cycle (decimal → lower-alpha → lower-roman) with an explicit style.
+     * Like `listStart`, setting this on a listItem breaks the group so the new
+     * `<ol>` carries the requested `list-style-type`.
+     */
+    listStyle?: ListStyleType;
     /** Only meaningful when `type === "table"`. */
     rows?: number;
     /** Only meaningful when `type === "table"`. */
@@ -598,4 +634,4 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, COMMAND_ORIGIN, type CellAttrs, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, MARGIN_PRESETS, MAX_LIST_LEVEL, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, expandTableRect, getMarksInRange, indentList, insertImage, insertParagraph, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveToNextCell, moveToPrevCell, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, setBlockAttr, setBlockType, setColumnWidth, setImageAttrs, setMark, sliceDelta, spanOf, splitCell, splitListItem, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };
+export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, COMMAND_ORIGIN, type CellAttrs, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, 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, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, expandTableRect, getMarksInRange, indentList, insertImage, insertParagraph, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveToNextCell, moveToPrevCell, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, setBlockAttr, setBlockType, setColumnWidth, setImageAttrs, setMark, sliceDelta, spanOf, splitCell, splitListItem, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };

package/dist/index.d.ts

@@ -25,6 +25,27 @@ interface PageSettings {
      * This is purely a UI hint — it's recomputed from width/height when needed.
      */
     preset?: PagePreset;
+    /**
+     * Free-form title persisted on the document for a consumer-rendered
+     * "system header" (e.g. a non-editable letterhead/identification block
+     * drawn on page 1 via `renderPageHeader`). Stored in `docSettings` so it
+     * survives serialization and is visible to every client/consumer of the
+     * `SerializedDocument`, including headless exports.
+     *
+     * The renderer is application-defined — this field just transports the
+     * title string. Use it when the header content is part of the document
+     * (and therefore must round-trip through exports), not a UI chrome
+     * decoration.
+     */
+    systemHeaderTitle?: string;
+    /**
+     * Owner/author display name for the same consumer-rendered system
+     * header (see [[systemHeaderTitle]]). Useful when the header should
+     * show the document's CREATOR, not the current viewer (e.g. an author
+     * name on a doc viewed by a third party). Persisted in `docSettings`
+     * for consistent rendering across clients and headless renderers.
+     */
+    systemHeaderAuthor?: string;
 }
 /** Page sizes in CSS px @ 96dpi. */
 declare const PAGE_PRESETS: {
@@ -67,6 +88,7 @@ type BlockType = "paragraph" | "heading" | "blockquote" | "codeBlock" | "listIte
 type AlignValue = "left" | "center" | "right" | "justify";
 type DirValue = "ltr" | "rtl";
 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;
 interface BlockAttrs {
@@ -80,6 +102,20 @@ interface BlockAttrs {
     listKind?: ListKind;
     /** Only meaningful when `type === "listItem"`. 0..MAX_LIST_LEVEL. */
     listLevel?: number;
+    /**
+     * Only meaningful when `type === "listItem"` and `listKind === "ordered"`.
+     * When set on a listItem, that item starts a NEW list group whose first
+     * `<ol>` carries `start={listStart}`. Used to renumerate questions or pick
+     * up an interrupted sequence.
+     */
+    listStart?: number;
+    /**
+     * Only meaningful when `type === "listItem"`. Overrides the default per-level
+     * CSS cycle (decimal → lower-alpha → lower-roman) with an explicit style.
+     * Like `listStart`, setting this on a listItem breaks the group so the new
+     * `<ol>` carries the requested `list-style-type`.
+     */
+    listStyle?: ListStyleType;
     /** Only meaningful when `type === "table"`. */
     rows?: number;
     /** Only meaningful when `type === "table"`. */
@@ -598,4 +634,4 @@ declare class EditorHistory {
     destroy(): void;
 }
 
-export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, COMMAND_ORIGIN, type CellAttrs, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, type ImageEmbed, type ImageLayout, type InsertContent, type LegacySerializedDocument, type LinkAttr, type ListKind, MARGIN_PRESETS, MAX_LIST_LEVEL, type MarkAttrs, type MarkName, type MarkValue, PAGE_PRESETS, type PagePreset, type PageSettings, type Position, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, expandTableRect, getMarksInRange, indentList, insertImage, insertParagraph, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveToNextCell, moveToPrevCell, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, setBlockAttr, setBlockType, setColumnWidth, setImageAttrs, setMark, sliceDelta, spanOf, splitCell, splitListItem, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };
+export { type AlignValue, BLOCK_SPECS, type BlockAttrs, type BlockType, COMMAND_ORIGIN, type CellAttrs, type CommandContext, type CommentAttr, DEFAULT_PAGE_SETTINGS, type DeltaOp, type DirValue, EditorDocument, EditorHistory, 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, type Selection, type SerializedBlock, type SerializedCell, type SerializedDocument, TRACKED_ORIGINS, type TableLocation, type TableRect, cellsInRect, clearRectCells, collapsedSelection, comparePositions, createBlock, createCell, createTableBlock, dedentList, defaultAttrsFor, deleteBackward, deleteForward, deleteTable, deleteTableColumn, deleteTableRow, deltaLength, detectPreset, expandTableRect, getMarksInRange, indentList, insertImage, insertParagraph, insertTable, insertTableColumn, insertTableRow, insertText, isCollapsed, isCommandOrigin, isImageEmbed, isKnownBlockType, isLegacySerializedDocument, isMarkUniformInRange, mergeDown, mergeRight, mergeSelection, mmToPx, moveToNextCell, moveToPrevCell, orderedRange, positionsEqual, pxToMm, removeMark, sameTextRun, setBlockAttr, setBlockType, setColumnWidth, setImageAttrs, setMark, sliceDelta, spanOf, splitCell, splitListItem, tableLocationOf, tableRectSelection, toggleList, toggleMark, withDefaults };

package/dist/index.js

@@ -121,7 +121,9 @@ var EditorDocument = class _EditorDocument {
       marginTop: pick("marginTop") ?? DEFAULT_PAGE_SETTINGS.marginTop,
       marginBottom: pick("marginBottom") ?? DEFAULT_PAGE_SETTINGS.marginBottom,
       marginLeft: pick("marginLeft") ?? DEFAULT_PAGE_SETTINGS.marginLeft,
-      marginRight: pick("marginRight") ?? DEFAULT_PAGE_SETTINGS.marginRight
+      marginRight: pick("marginRight") ?? DEFAULT_PAGE_SETTINGS.marginRight,
+      systemHeaderTitle: pick("systemHeaderTitle"),
+      systemHeaderAuthor: pick("systemHeaderAuthor")
     };
     merged.preset = detectPreset(merged.width, merged.height);
     return merged;
@@ -257,6 +259,17 @@ var EditorDocument = class _EditorDocument {
    */
   loadFromJSON(serialized) {
     const { blocks: sourceBlocks, pageSettings } = normalizeSerialized(serialized);
+    const LOCK_KEY = "__importLock";
+    const LOCK_TTL_MS = 5e3;
+    const existing = this.docSettings.get(LOCK_KEY);
+    if (typeof existing === "number" && Date.now() - existing < LOCK_TTL_MS) {
+      const ageMs = Date.now() - existing;
+      console.warn(
+        `[EditorDocument.loadFromJSON] import j\xE1 em andamento (${ageMs}ms atr\xE1s, TTL ${LOCK_TTL_MS}ms) \u2014 ignorando esta chamada para evitar duplica\xE7\xE3o de blocks.`
+      );
+      return;
+    }
+    this.docSettings.set(LOCK_KEY, Date.now());
     this.ydoc.transact(() => {
       if (this.blocks.length > 0) {
         this.blocks.delete(0, this.blocks.length);
@@ -276,6 +289,7 @@ var EditorDocument = class _EditorDocument {
           this.docSettings.set(k, v);
         }
       }
+      this.docSettings.delete(LOCK_KEY);
     }, "import");
   }
   /** Build a fresh `EditorDocument` from a `SerializedDocument`. */