@scrider/formatter 1.3.4 → 1.3.6

package/dist/index.d.cts

@@ -1292,6 +1292,23 @@ declare function validateDelta(delta: Delta, registry: Registry): boolean;
  */
 declare function cloneDelta(delta: Delta): Delta;
 
+/**
+ * Document-level HTML presentation for deltaToHtml (clipboard, export).
+ * Not stored in Delta — mirrors editor Settings (line spacing, first-line indent).
+ */
+interface DocumentPresentation {
+    /** Line spacing multiplier, e.g. 1.5 */
+    lineSpacing?: number;
+    /** First-line indent in centimeters, e.g. 1.25 */
+    textIndentCm?: number;
+}
+interface ResolvedDocumentPresentation {
+    lineSpacing: number | undefined;
+    textIndentCm: number | undefined;
+}
+declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
+
 /**
  * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
  * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
@@ -1398,6 +1415,11 @@ interface DeltaToHtmlOptions {
      * Office/HTML export and clipboard. Does not change Delta; omitted = legacy bare `<table>`.
      */
     tablePresentation?: TablePresentation;
+    /**
+     * Document-level paragraph styles (line spacing, first-line indent) as inline CSS for
+     * Office/HTML export and clipboard. Does not change Delta.
+     */
+    documentPresentation?: DocumentPresentation;
 }
 /**
  * Convert a Delta to an HTML string
@@ -1863,4 +1885,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedTablePresentation, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };
+export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.d.ts

@@ -1292,6 +1292,23 @@ declare function validateDelta(delta: Delta, registry: Registry): boolean;
  */
 declare function cloneDelta(delta: Delta): Delta;
 
+/**
+ * Document-level HTML presentation for deltaToHtml (clipboard, export).
+ * Not stored in Delta — mirrors editor Settings (line spacing, first-line indent).
+ */
+interface DocumentPresentation {
+    /** Line spacing multiplier, e.g. 1.5 */
+    lineSpacing?: number;
+    /** First-line indent in centimeters, e.g. 1.25 */
+    textIndentCm?: number;
+}
+interface ResolvedDocumentPresentation {
+    lineSpacing: number | undefined;
+    textIndentCm: number | undefined;
+}
+declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
+
 /**
  * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
  * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
@@ -1398,6 +1415,11 @@ interface DeltaToHtmlOptions {
      * Office/HTML export and clipboard. Does not change Delta; omitted = legacy bare `<table>`.
      */
     tablePresentation?: TablePresentation;
+    /**
+     * Document-level paragraph styles (line spacing, first-line indent) as inline CSS for
+     * Office/HTML export and clipboard. Does not change Delta.
+     */
+    documentPresentation?: DocumentPresentation;
 }
 /**
  * Convert a Delta to an HTML string
@@ -1863,4 +1885,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedTablePresentation, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };
+export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatScope, type HtmlToDeltaOptions, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.js

@@ -2493,6 +2493,33 @@ function slugifyWithDedup(text, usedSlugs) {
   return `${base}-${count}`;
 }
 
+// src/conversion/html/document-presentation.ts
+function resolveDocumentPresentation(presentation) {
+  if (!presentation) return void 0;
+  const lineSpacing = typeof presentation.lineSpacing === "number" && presentation.lineSpacing > 0 ? presentation.lineSpacing : void 0;
+  const textIndentCm = typeof presentation.textIndentCm === "number" && presentation.textIndentCm > 0 ? presentation.textIndentCm : void 0;
+  if (lineSpacing === void 0 && textIndentCm === void 0) return void 0;
+  return { lineSpacing, textIndentCm };
+}
+var LINE_HEIGHT_TAGS = /* @__PURE__ */ new Set(["p", "li", "blockquote"]);
+var TEXT_INDENT_TAGS = /* @__PURE__ */ new Set(["p", "li"]);
+function documentPresentationStyleParts(tag, resolved) {
+  if (!resolved) return [];
+  const parts = [];
+  if (resolved.lineSpacing !== void 0 && LINE_HEIGHT_TAGS.has(tag)) {
+    const pct = Math.round(resolved.lineSpacing * 100);
+    parts.push(`line-height:${resolved.lineSpacing}`);
+    parts.push(`mso-line-height-alt:${pct}%`);
+  }
+  if (resolved.textIndentCm !== void 0 && TEXT_INDENT_TAGS.has(tag)) {
+    parts.push(`text-indent:${resolved.textIndentCm}cm`);
+  }
+  return parts;
+}
+function joinStyleParts(parts) {
+  return parts.length > 0 ? ` style="${parts.join("; ")}"` : "";
+}
+
 // src/conversion/html/table-presentation.ts
 var DEFAULT_BORDER_COLOR = "#e7e7e7";
 var DEFAULT_HEADER_BG = "#f5f5f5";
@@ -2563,6 +2590,7 @@ function deltaToHtml(delta, options = {}) {
   const hierarchicalNumbers = options.hierarchicalNumbers ?? false;
   const blockHandlers = options.blockHandlers;
   const anchorLinks = options.anchorLinks ?? false;
+  const resolvedDocumentPresentation = resolveDocumentPresentation(options.documentPresentation);
   let html = "";
   let listStack = [];
   let counters = [];
@@ -2625,7 +2653,14 @@ function deltaToHtml(delta, options = {}) {
       if (hierarchicalNumbers && listType === "ordered") {
         hierarchicalNumber = counters.slice(0, indent + 1).join(".");
       }
-      html += renderListItem(content, listItemAttrs, pretty, indentLevel, hierarchicalNumber);
+      html += renderListItem(
+        content,
+        listItemAttrs,
+        pretty,
+        indentLevel,
+        hierarchicalNumber,
+        resolvedDocumentPresentation
+      );
     } else {
       let headingId;
       if (line.attributes?.header) {
@@ -2637,7 +2672,14 @@ function deltaToHtml(delta, options = {}) {
           headingId = slugifyWithDedup(plainText, slugUsageMap);
         }
       }
-      html += renderBlock(content, tag, line.attributes, pretty, headingId);
+      html += renderBlock(
+        content,
+        tag,
+        line.attributes,
+        pretty,
+        headingId,
+        resolvedDocumentPresentation
+      );
     }
   }
   html += closeAllLists(listStack, pretty);
@@ -2929,36 +2971,41 @@ function getListItemAttributes(attributes) {
   }
   return "";
 }
-function renderListItem(content, attrs, pretty, indentLevel, hierarchicalNumber) {
+function renderListItem(content, attrs, pretty, indentLevel, hierarchicalNumber, resolvedDocumentPresentation) {
   const indent = pretty ? getIndent(indentLevel) : "";
   const innerContent = content || "<br>";
   let fullAttrs = attrs;
   if (hierarchicalNumber) {
     fullAttrs += ` data-number="${hierarchicalNumber}"`;
   }
+  const styleAttr = joinStyleParts(
+    documentPresentationStyleParts("li", resolvedDocumentPresentation)
+  );
+  fullAttrs += styleAttr;
   const html = `${indent}<li${fullAttrs}>${innerContent}</li>`;
   return pretty ? html + "\n" : html;
 }
-function renderBlock(content, tag, attributes, pretty, id) {
+function renderBlock(content, tag, attributes, pretty, id, resolvedDocumentPresentation) {
   const idAttr = id ? ` id="${escapeHtml(id)}"` : "";
-  const styleAttr = getBlockStyleAttribute(attributes);
+  const styleAttr = getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation);
   const innerContent = content || "<br>";
   const html = `<${tag}${idAttr}${styleAttr}>${innerContent}</${tag}>`;
   return pretty ? html + "\n" : html;
 }
-function getBlockStyleAttribute(attributes) {
-  if (!attributes) return "";
-  const styles = [];
-  const alignVal = attributes.align;
-  if (alignVal && typeof alignVal === "string" && alignVal !== "left") {
-    styles.push(`text-align: ${alignVal}`);
-  }
-  if (attributes.indent && typeof attributes.indent === "number") {
-    if (!attributes.list) {
-      styles.push(`margin-left: ${attributes.indent * 2}em`);
+function getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation) {
+  const styles = documentPresentationStyleParts(tag, resolvedDocumentPresentation);
+  if (attributes) {
+    const alignVal = attributes.align;
+    if (alignVal && typeof alignVal === "string" && alignVal !== "left") {
+      styles.push(`text-align: ${alignVal}`);
+    }
+    if (attributes.indent && typeof attributes.indent === "number") {
+      if (!attributes.list) {
+        styles.push(`margin-left: ${attributes.indent * 2}em`);
+      }
     }
   }
-  return styles.length > 0 ? ` style="${styles.join("; ")}"` : "";
+  return joinStyleParts(styles);
 }
 function extractPlainText(ops) {
   let text = "";
@@ -5110,6 +5157,7 @@ export {
   deltaToHtml,
   deltaToMarkdown,
   dividerFormat,
+  documentPresentationStyleParts,
   escapeHtml,
   extractBoxOpAttributes,
   extractTableRegion,
@@ -5142,6 +5190,7 @@ export {
   nodeAdapter,
   normalizeDelta,
   preloadRemark,
+  resolveDocumentPresentation,
   resolveTablePresentation,
   sanitizeDelta,
   sizeFormat,