@scrider/formatter 1.4.2 → 1.4.3

package/dist/index.d.cts

@@ -1294,8 +1294,12 @@ 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";
+/** Space after plain paragraph (`margin-bottom`) on `\n` (Settings Apply). */
+declare const SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 /** Block tags that receive line spacing (not headings). */
 declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/** Block tags that receive paragraph spacing after (plain `<p>` only). */
+declare const PARAGRAPH_SPACING_BLOCK_TAGS: Set<string>;
 /**
  * Parse a line-height multiplier from Delta / inline CSS values
  * (`1.5`, `2`, `150%`).
@@ -1305,16 +1309,27 @@ declare function parseScriderLineHeightMultiplier(value: string): number | undef
  * 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[];
+/**
+ * Parse `margin-bottom` in em from Delta / inline CSS (`0.5em`, `0.5`).
+ */
+declare function parseScriderMarginAfterEm(value: string): number | undefined;
+/**
+ * Paragraph spacing after: `scrider-margin-after` on the line → documentPresentation → none.
+ */
+declare function blockMarginAfterStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
  * Document-level HTML presentation for deltaToHtml (clipboard, export).
  * Mirrors editor Settings when block attrs are absent.
  * Per-block line spacing: {@link blockLineHeightStyleParts} (`scrider-line-height` on `\n`).
+ * Per-block paragraph spacing: {@link blockMarginAfterStyleParts} (`scrider-margin-after` on `\n`).
  */
 
 interface DocumentPresentation {
     /** Line spacing multiplier, e.g. 1.5 */
     lineSpacing?: number;
+    /** Space after plain paragraphs in em, e.g. 0.5 */
+    paragraphSpacingAfterEm?: number;
     /** 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. */
@@ -1322,6 +1337,7 @@ interface DocumentPresentation {
 }
 interface ResolvedDocumentPresentation {
     lineSpacing: number | undefined;
+    paragraphSpacingAfterEm: number | undefined;
     textIndentCm: number | undefined;
     listBlockIndentCm: number | undefined;
 }
@@ -1909,4 +1925,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, 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 };
+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, PARAGRAPH_SPACING_BLOCK_TAGS, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, SCRIDER_MARGIN_AFTER_KEY, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, 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, parseScriderMarginAfterEm, 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

@@ -1294,8 +1294,12 @@ 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";
+/** Space after plain paragraph (`margin-bottom`) on `\n` (Settings Apply). */
+declare const SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 /** Block tags that receive line spacing (not headings). */
 declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/** Block tags that receive paragraph spacing after (plain `<p>` only). */
+declare const PARAGRAPH_SPACING_BLOCK_TAGS: Set<string>;
 /**
  * Parse a line-height multiplier from Delta / inline CSS values
  * (`1.5`, `2`, `150%`).
@@ -1305,16 +1309,27 @@ declare function parseScriderLineHeightMultiplier(value: string): number | undef
  * 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[];
+/**
+ * Parse `margin-bottom` in em from Delta / inline CSS (`0.5em`, `0.5`).
+ */
+declare function parseScriderMarginAfterEm(value: string): number | undefined;
+/**
+ * Paragraph spacing after: `scrider-margin-after` on the line → documentPresentation → none.
+ */
+declare function blockMarginAfterStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
  * Document-level HTML presentation for deltaToHtml (clipboard, export).
  * Mirrors editor Settings when block attrs are absent.
  * Per-block line spacing: {@link blockLineHeightStyleParts} (`scrider-line-height` on `\n`).
+ * Per-block paragraph spacing: {@link blockMarginAfterStyleParts} (`scrider-margin-after` on `\n`).
  */
 
 interface DocumentPresentation {
     /** Line spacing multiplier, e.g. 1.5 */
     lineSpacing?: number;
+    /** Space after plain paragraphs in em, e.g. 0.5 */
+    paragraphSpacingAfterEm?: number;
     /** 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. */
@@ -1322,6 +1337,7 @@ interface DocumentPresentation {
 }
 interface ResolvedDocumentPresentation {
     lineSpacing: number | undefined;
+    paragraphSpacingAfterEm: number | undefined;
     textIndentCm: number | undefined;
     listBlockIndentCm: number | undefined;
 }
@@ -1909,4 +1925,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, 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 };
+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, PARAGRAPH_SPACING_BLOCK_TAGS, Registry, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, SCRIDER_MARGIN_AFTER_KEY, type SanitizeOptions, type TableBlockData, type TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, 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, parseScriderMarginAfterEm, 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

@@ -2495,7 +2495,9 @@ function slugifyWithDedup(text, usedSlugs) {
 
 // src/conversion/html/block-presentation.ts
 var SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
+var SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 var LINE_HEIGHT_BLOCK_TAGS = /* @__PURE__ */ new Set(["p", "li", "blockquote"]);
+var PARAGRAPH_SPACING_BLOCK_TAGS = /* @__PURE__ */ new Set(["p"]);
 function parseScriderLineHeightMultiplier(value) {
   const trimmed = value.trim();
   if (!trimmed) return void 0;
@@ -2524,6 +2526,34 @@ function blockLineHeightStyleParts(tag, blockAttributes, resolved) {
   }
   return [];
 }
+function parseScriderMarginAfterEm(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  const emMatch = trimmed.match(/^(-?\d+(?:\.\d+)?)\s*em$/i);
+  if (emMatch) {
+    const n2 = Number.parseFloat(emMatch[1]);
+    if (Number.isFinite(n2) && n2 >= 0) return n2;
+    return void 0;
+  }
+  const n = Number.parseFloat(trimmed);
+  if (Number.isFinite(n) && n >= 0) return n;
+  return void 0;
+}
+function marginAfterStyleParts(em) {
+  return [`margin-top:0`, `margin-bottom:${em}em`];
+}
+function blockMarginAfterStyleParts(tag, blockAttributes, resolved) {
+  if (!PARAGRAPH_SPACING_BLOCK_TAGS.has(tag)) return [];
+  const raw = blockAttributes?.[SCRIDER_MARGIN_AFTER_KEY];
+  if (typeof raw === "string") {
+    const fromBlock = parseScriderMarginAfterEm(raw);
+    if (fromBlock !== void 0) return marginAfterStyleParts(fromBlock);
+  }
+  if (resolved?.paragraphSpacingAfterEm !== void 0) {
+    return marginAfterStyleParts(resolved.paragraphSpacingAfterEm);
+  }
+  return [];
+}
 
 // src/conversion/html/document-presentation.ts
 function resolveDocumentPresentation(presentation) {
@@ -2531,10 +2561,11 @@ function resolveDocumentPresentation(presentation) {
   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;
   const listBlockIndentCm = typeof presentation.listBlockIndentCm === "number" && presentation.listBlockIndentCm > 0 ? presentation.listBlockIndentCm : void 0;
-  if (lineSpacing === void 0 && textIndentCm === void 0 && listBlockIndentCm === void 0) {
+  const paragraphSpacingAfterEm = typeof presentation.paragraphSpacingAfterEm === "number" && Number.isFinite(presentation.paragraphSpacingAfterEm) && presentation.paragraphSpacingAfterEm >= 0 ? presentation.paragraphSpacingAfterEm : void 0;
+  if (lineSpacing === void 0 && paragraphSpacingAfterEm === void 0 && textIndentCm === void 0 && listBlockIndentCm === void 0) {
     return void 0;
   }
-  return { lineSpacing, textIndentCm, listBlockIndentCm };
+  return { lineSpacing, paragraphSpacingAfterEm, textIndentCm, listBlockIndentCm };
 }
 var TEXT_INDENT_TAGS = /* @__PURE__ */ new Set(["p"]);
 function documentPresentationListWrapperStyleParts(resolved) {
@@ -2552,6 +2583,7 @@ function documentPresentationStyleParts(tag, resolved) {
 function blockPresentationStyleParts(tag, blockAttributes, resolved) {
   return [
     ...blockLineHeightStyleParts(tag, blockAttributes, resolved),
+    ...blockMarginAfterStyleParts(tag, blockAttributes, resolved),
     ...documentPresentationStyleParts(tag, resolved)
   ];
 }
@@ -5186,13 +5218,16 @@ export {
   LINE_HEIGHT_BLOCK_TAGS,
   NODE_TYPE,
   NodeDOMAdapter,
+  PARAGRAPH_SPACING_BLOCK_TAGS,
   Registry,
   SCRIDER_LINE_HEIGHT_KEY,
+  SCRIDER_MARGIN_AFTER_KEY,
   alertBlockHandler,
   alignFormat,
   backgroundFormat,
   blockFormat,
   blockLineHeightStyleParts,
+  blockMarginAfterStyleParts,
   blockPresentationStyleParts,
   blockquoteFormat,
   boldFormat,
@@ -5245,6 +5280,7 @@ export {
   nodeAdapter,
   normalizeDelta,
   parseScriderLineHeightMultiplier,
+  parseScriderMarginAfterEm,
   preloadRemark,
   resolveDocumentPresentation,
   resolveTablePresentation,