@scrider/formatter 1.4.0 → 1.4.2

package/dist/index.d.cts

@@ -1292,14 +1292,30 @@ declare function validateDelta(delta: Delta, registry: Registry): boolean;
  */
 declare function cloneDelta(delta: Delta): Delta;
 
+/** Per-paragraph line spacing stored on `\n` (Word paste, Settings Apply, toolbar). */
+declare const SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
+/** Block tags that receive line spacing (not headings). */
+declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/**
+ * Parse a line-height multiplier from Delta / inline CSS values
+ * (`1.5`, `2`, `150%`).
+ */
+declare function parseScriderLineHeightMultiplier(value: string): number | undefined;
+/**
+ * Line-height for a block tag: `scrider-line-height` on the line → documentPresentation → none.
+ */
+declare function blockLineHeightStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
+
 /**
  * Document-level HTML presentation for deltaToHtml (clipboard, export).
- * Not stored in Delta — mirrors editor Settings (line spacing, indents).
+ * Mirrors editor Settings when block attrs are absent.
+ * Per-block line spacing: {@link blockLineHeightStyleParts} (`scrider-line-height` on `\n`).
  */
+
 interface DocumentPresentation {
     /** Line spacing multiplier, e.g. 1.5 */
     lineSpacing?: number;
-    /** First-line indent in cm on `<p>` and `<li>` (wrapped / soft-break lines unchanged). */
+    /** First-line indent in cm on `<p>` only (lists: use listBlockIndentCm). */
     textIndentCm?: number;
     /** Extra left padding on top-level `<ul>`/`<ol>` — shifts marker + text as a block. */
     listBlockIndentCm?: number;
@@ -1310,7 +1326,12 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+/** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
+/**
+ * All block presentation styles for deltaToHtml: Delta attrs, then document defaults.
+ */
+declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
  * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
@@ -1888,4 +1909,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 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 };
+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, LINE_HEIGHT_BLOCK_TAGS, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockPresentationStyleParts, 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, parseScriderLineHeightMultiplier, 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,14 +1292,30 @@ declare function validateDelta(delta: Delta, registry: Registry): boolean;
  */
 declare function cloneDelta(delta: Delta): Delta;
 
+/** Per-paragraph line spacing stored on `\n` (Word paste, Settings Apply, toolbar). */
+declare const SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
+/** Block tags that receive line spacing (not headings). */
+declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/**
+ * Parse a line-height multiplier from Delta / inline CSS values
+ * (`1.5`, `2`, `150%`).
+ */
+declare function parseScriderLineHeightMultiplier(value: string): number | undefined;
+/**
+ * Line-height for a block tag: `scrider-line-height` on the line → documentPresentation → none.
+ */
+declare function blockLineHeightStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
+
 /**
  * Document-level HTML presentation for deltaToHtml (clipboard, export).
- * Not stored in Delta — mirrors editor Settings (line spacing, indents).
+ * Mirrors editor Settings when block attrs are absent.
+ * Per-block line spacing: {@link blockLineHeightStyleParts} (`scrider-line-height` on `\n`).
  */
+
 interface DocumentPresentation {
     /** Line spacing multiplier, e.g. 1.5 */
     lineSpacing?: number;
-    /** First-line indent in cm on `<p>` and `<li>` (wrapped / soft-break lines unchanged). */
+    /** First-line indent in cm on `<p>` only (lists: use listBlockIndentCm). */
     textIndentCm?: number;
     /** Extra left padding on top-level `<ul>`/`<ol>` — shifts marker + text as a block. */
     listBlockIndentCm?: number;
@@ -1310,7 +1326,12 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+/** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
+/**
+ * All block presentation styles for deltaToHtml: Delta attrs, then document defaults.
+ */
+declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
  * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
@@ -1888,4 +1909,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 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 };
+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, LINE_HEIGHT_BLOCK_TAGS, type ListType, type MarkdownToDeltaOptions, NODE_TYPE, NodeDOMAdapter, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockPresentationStyleParts, 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, parseScriderLineHeightMultiplier, 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,38 @@ function slugifyWithDedup(text, usedSlugs) {
   return `${base}-${count}`;
 }
 
+// src/conversion/html/block-presentation.ts
+var SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
+var LINE_HEIGHT_BLOCK_TAGS = /* @__PURE__ */ new Set(["p", "li", "blockquote"]);
+function parseScriderLineHeightMultiplier(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  if (trimmed.endsWith("%")) {
+    const pct = Number.parseFloat(trimmed.slice(0, -1));
+    if (Number.isFinite(pct) && pct > 0) return pct / 100;
+    return void 0;
+  }
+  const n = Number.parseFloat(trimmed);
+  if (Number.isFinite(n) && n > 0) return n;
+  return void 0;
+}
+function lineHeightStyleParts(multiplier) {
+  const pct = Math.round(multiplier * 100);
+  return [`line-height:${multiplier}`, `mso-line-height-alt:${pct}%`];
+}
+function blockLineHeightStyleParts(tag, blockAttributes, resolved) {
+  if (!LINE_HEIGHT_BLOCK_TAGS.has(tag)) return [];
+  const raw = blockAttributes?.[SCRIDER_LINE_HEIGHT_KEY];
+  if (typeof raw === "string") {
+    const fromBlock = parseScriderLineHeightMultiplier(raw);
+    if (fromBlock !== void 0) return lineHeightStyleParts(fromBlock);
+  }
+  if (resolved?.lineSpacing !== void 0) {
+    return lineHeightStyleParts(resolved.lineSpacing);
+  }
+  return [];
+}
+
 // src/conversion/html/document-presentation.ts
 function resolveDocumentPresentation(presentation) {
   if (!presentation) return void 0;
@@ -2504,25 +2536,25 @@ function resolveDocumentPresentation(presentation) {
   }
   return { lineSpacing, textIndentCm, listBlockIndentCm };
 }
-var LINE_HEIGHT_TAGS = /* @__PURE__ */ new Set(["p", "li", "blockquote"]);
-var TEXT_INDENT_TAGS = /* @__PURE__ */ new Set(["p", "li"]);
+var TEXT_INDENT_TAGS = /* @__PURE__ */ new Set(["p"]);
 function documentPresentationListWrapperStyleParts(resolved) {
   if (!resolved?.listBlockIndentCm) return [];
-  return [`padding-left:calc(1.5em + ${resolved.listBlockIndentCm}cm)`];
+  return [`padding-left:1.25em`, `margin-left:${resolved.listBlockIndentCm}cm`];
 }
 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 blockPresentationStyleParts(tag, blockAttributes, resolved) {
+  return [
+    ...blockLineHeightStyleParts(tag, blockAttributes, resolved),
+    ...documentPresentationStyleParts(tag, resolved)
+  ];
+}
 function joinStyleParts(parts) {
   return parts.length > 0 ? ` style="${parts.join("; ")}"` : "";
 }
@@ -2669,6 +2701,7 @@ function deltaToHtml(delta, options = {}) {
       html += renderListItem(
         content,
         listItemAttrs,
+        line.attributes,
         pretty,
         indentLevel,
         hierarchicalNumber,
@@ -2988,17 +3021,14 @@ function getListItemAttributes(attributes) {
   }
   return "";
 }
-function renderListItem(content, attrs, pretty, indentLevel, hierarchicalNumber, resolvedDocumentPresentation) {
+function renderListItem(content, attrs, blockAttributes, 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;
+  fullAttrs += getBlockStyleAttribute("li", blockAttributes, resolvedDocumentPresentation);
   const html = `${indent}<li${fullAttrs}>${innerContent}</li>`;
   return pretty ? html + "\n" : html;
 }
@@ -3010,7 +3040,11 @@ function renderBlock(content, tag, attributes, pretty, id, resolvedDocumentPrese
   return pretty ? html + "\n" : html;
 }
 function getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation) {
-  const styles = documentPresentationStyleParts(tag, resolvedDocumentPresentation);
+  const styles = blockPresentationStyleParts(
+    tag,
+    attributes,
+    resolvedDocumentPresentation
+  );
   if (attributes) {
     const alignVal = attributes.align;
     if (alignVal && typeof alignVal === "string" && alignVal !== "left") {
@@ -5149,13 +5183,17 @@ export {
   BOX_OVERFLOW_VALUES,
   BlockHandlerRegistry,
   BrowserDOMAdapter,
+  LINE_HEIGHT_BLOCK_TAGS,
   NODE_TYPE,
   NodeDOMAdapter,
   Registry,
+  SCRIDER_LINE_HEIGHT_KEY,
   alertBlockHandler,
   alignFormat,
   backgroundFormat,
   blockFormat,
+  blockLineHeightStyleParts,
+  blockPresentationStyleParts,
   blockquoteFormat,
   boldFormat,
   boxBlockHandler,
@@ -5206,6 +5244,7 @@ export {
   markdownToDeltaSync,
   nodeAdapter,
   normalizeDelta,
+  parseScriderLineHeightMultiplier,
   preloadRemark,
   resolveDocumentPresentation,
   resolveTablePresentation,