@scrider/formatter 1.8.6 → 1.9.1

package/dist/index.d.cts

@@ -2,6 +2,50 @@ import { AttributeMap, Op, Delta, InsertOp } from '@scrider/delta';
 export * from '@scrider/delta';
 export { InsertOp as ContentOp } from '@scrider/delta';
 
+/**
+ * Document-level metadata (Scrider format extension).
+ *
+ * Concrete schema for the opaque `scrider-metadata` sibling field defined in
+ * `@scrider/delta` (`ScriderDocument`). It carries document-wide defaults ONCE
+ * (line spacing, paragraph spacing, indent, heading policy, fonts) instead of
+ * duplicating them as block attributes on every `\n`.
+ *
+ * Layering:
+ * - `@scrider/delta` treats the value as opaque `Record<string, unknown>` — it
+ *   never participates in `length()`, selection indices, OT, or partial copy/paste.
+ * - `@scrider/formatter` is the CONTRACT OWNER of this concrete shape.
+ * - `@scrider/editor-core` / `@scrider/editor-react` consume it (state, CSS vars,
+ *   export projection).
+ *
+ * All fields are optional and additive: extending the interface never changes the
+ * op-stream and is backward compatible. Presentation-relevant fields are projected
+ * to HTML via {@link documentMetadataToPresentation}; heading/font policy is applied
+ * by upstream layers (CSS vars, bake) and is intentionally NOT part of the inline
+ * export projection.
+ */
+interface ScriderDocumentMetadata {
+    /** Line spacing multiplier, e.g. `1.5`. */
+    lineSpacing?: number;
+    /** Space before plain paragraphs in em, e.g. `0.5`. */
+    paragraphSpacingBeforeEm?: number;
+    /** Space after plain paragraphs in em, e.g. `0.5`. */
+    paragraphSpacingAfterEm?: number;
+    /** First-line indent in cm on `<p>` (lists use {@link listBlockIndentCm}). */
+    textIndentCm?: number;
+    /** Extra left indent in cm on top-level `<ul>`/`<ol>` (shifts marker + text). */
+    listBlockIndentCm?: number;
+    /** Document heading horizontal alignment policy. */
+    headingAlign?: 'left' | 'center' | 'right';
+    /** Document heading bold policy. */
+    headingBold?: boolean;
+    /** Named heading size-grid preset id (schema defined upstream). */
+    headingSizeGridPreset?: string;
+    /** Default document font family (bare family name, e.g. `Georgia`). */
+    defaultFont?: string;
+    /** Default document font size as a CSS length, e.g. `12pt`. */
+    defaultFontSize?: string;
+}
+
 /**
  * DOM Adapter Interface
  *
@@ -192,6 +236,21 @@ interface Format<T = unknown> {
      * Scope of the format
      */
     readonly scope: FormatScope;
+    /**
+     * Block-level marker for `embed` formats.
+     *
+     * A block-level embed (e.g. `divider` → `<hr>`) stands on its own line: in
+     * Delta it is the `{embed}` op followed by its own paragraph-terminating
+     * `\n`, and in HTML it is NOT wrapped in a `<p>`. Inline embeds (image,
+     * formula, softBreak…) live inside a paragraph and rely on the surrounding
+     * block's `\n`, so they leave this unset.
+     *
+     * `htmlToDelta` uses this to emit the block `\n` after matching a block-level
+     * embed via the registry (otherwise the following content glues onto the
+     * embed's line — see the `<hr>` round-trip regression). Ignored for
+     * non-embed scopes.
+     */
+    readonly blockLevel?: boolean;
     /**
      * Normalize value to canonical form
      *
@@ -482,6 +541,8 @@ declare class BlockHandlerRegistry {
 
 /** Block-level float on extended table host (4.2.10). */
 type TableBlockFloat = 'left' | 'center' | 'right';
+/** Block position when width is narrower than the line (margin-based, no float). */
+type TableBlockAlign = 'left' | 'center' | 'right' | 'justify';
 /**
  * Column alignment options (GFM column-level subset).
  */
@@ -531,6 +592,8 @@ interface TableBlockData {
     width?: number;
     /** Block-level float on host wrapper (4.2.10). */
     float?: TableBlockFloat;
+    /** Block position when width is set (margin-based, no float). */
+    blockAlign?: TableBlockAlign;
     /** Column alignments */
     colAligns?: (CellAlign | null)[];
     /** Cells indexed by "row:col" */
@@ -1427,6 +1490,17 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+/**
+ * Project {@link ScriderDocumentMetadata} onto an HTML {@link DocumentPresentation}
+ * (export / clipboard inline CSS).
+ *
+ * Only presentation-relevant fields are mapped (line/paragraph spacing, indent).
+ * Heading policy (align/bold/size grid) and fonts are applied by upstream layers
+ * (CSS vars in the editor, bake into block/inline attrs) and are deliberately not
+ * part of the inline projection. Returns `undefined` when nothing maps, so callers
+ * can fall back cleanly.
+ */
+declare function documentMetadataToPresentation(metadata: ScriderDocumentMetadata | undefined): DocumentPresentation | undefined;
 /** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
@@ -1545,6 +1619,15 @@ interface DeltaToHtmlOptions {
      * Office/HTML export and clipboard. Does not change Delta.
      */
     documentPresentation?: DocumentPresentation;
+    /**
+     * Document-level metadata (Scrider format extension, `scrider-metadata`).
+     *
+     * When {@link documentPresentation} is not provided, the presentation-relevant
+     * fields of this metadata are projected to inline CSS via
+     * `documentMetadataToPresentation` (export/clipboard). An explicit
+     * `documentPresentation` always takes precedence. Does not change Delta.
+     */
+    documentMetadata?: ScriderDocumentMetadata;
     /**
      * Cross-origin iframe isolation for embed formats (codeWidget, video iframe).
      * Default: both off — standard third-party iframes load with browser cookies.
@@ -2068,4 +2151,4 @@ declare function collectAdjacentTableLines<T extends {
  */
 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 CellHorizontalAlign, type CellVerticalAlign, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type EmbedIsolationOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatRenderContext, 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, SCRIDER_MARGIN_BEFORE_KEY, type SanitizeOptions, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, 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, isAdjacentSimpleTableGridBoundary, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableCellCoordsFromAttributes, tableCellCoordsFromOp, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toCodeWidgetEmbedUrl, 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 CellHorizontalAlign, type CellVerticalAlign, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type EmbedIsolationOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatRenderContext, 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, SCRIDER_MARGIN_BEFORE_KEY, type SanitizeOptions, type ScriderDocumentMetadata, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentMetadataToPresentation, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isAdjacentSimpleTableGridBoundary, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableCellCoordsFromAttributes, tableCellCoordsFromOp, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toCodeWidgetEmbedUrl, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.d.ts

@@ -2,6 +2,50 @@ import { AttributeMap, Op, Delta, InsertOp } from '@scrider/delta';
 export * from '@scrider/delta';
 export { InsertOp as ContentOp } from '@scrider/delta';
 
+/**
+ * Document-level metadata (Scrider format extension).
+ *
+ * Concrete schema for the opaque `scrider-metadata` sibling field defined in
+ * `@scrider/delta` (`ScriderDocument`). It carries document-wide defaults ONCE
+ * (line spacing, paragraph spacing, indent, heading policy, fonts) instead of
+ * duplicating them as block attributes on every `\n`.
+ *
+ * Layering:
+ * - `@scrider/delta` treats the value as opaque `Record<string, unknown>` — it
+ *   never participates in `length()`, selection indices, OT, or partial copy/paste.
+ * - `@scrider/formatter` is the CONTRACT OWNER of this concrete shape.
+ * - `@scrider/editor-core` / `@scrider/editor-react` consume it (state, CSS vars,
+ *   export projection).
+ *
+ * All fields are optional and additive: extending the interface never changes the
+ * op-stream and is backward compatible. Presentation-relevant fields are projected
+ * to HTML via {@link documentMetadataToPresentation}; heading/font policy is applied
+ * by upstream layers (CSS vars, bake) and is intentionally NOT part of the inline
+ * export projection.
+ */
+interface ScriderDocumentMetadata {
+    /** Line spacing multiplier, e.g. `1.5`. */
+    lineSpacing?: number;
+    /** Space before plain paragraphs in em, e.g. `0.5`. */
+    paragraphSpacingBeforeEm?: number;
+    /** Space after plain paragraphs in em, e.g. `0.5`. */
+    paragraphSpacingAfterEm?: number;
+    /** First-line indent in cm on `<p>` (lists use {@link listBlockIndentCm}). */
+    textIndentCm?: number;
+    /** Extra left indent in cm on top-level `<ul>`/`<ol>` (shifts marker + text). */
+    listBlockIndentCm?: number;
+    /** Document heading horizontal alignment policy. */
+    headingAlign?: 'left' | 'center' | 'right';
+    /** Document heading bold policy. */
+    headingBold?: boolean;
+    /** Named heading size-grid preset id (schema defined upstream). */
+    headingSizeGridPreset?: string;
+    /** Default document font family (bare family name, e.g. `Georgia`). */
+    defaultFont?: string;
+    /** Default document font size as a CSS length, e.g. `12pt`. */
+    defaultFontSize?: string;
+}
+
 /**
  * DOM Adapter Interface
  *
@@ -192,6 +236,21 @@ interface Format<T = unknown> {
      * Scope of the format
      */
     readonly scope: FormatScope;
+    /**
+     * Block-level marker for `embed` formats.
+     *
+     * A block-level embed (e.g. `divider` → `<hr>`) stands on its own line: in
+     * Delta it is the `{embed}` op followed by its own paragraph-terminating
+     * `\n`, and in HTML it is NOT wrapped in a `<p>`. Inline embeds (image,
+     * formula, softBreak…) live inside a paragraph and rely on the surrounding
+     * block's `\n`, so they leave this unset.
+     *
+     * `htmlToDelta` uses this to emit the block `\n` after matching a block-level
+     * embed via the registry (otherwise the following content glues onto the
+     * embed's line — see the `<hr>` round-trip regression). Ignored for
+     * non-embed scopes.
+     */
+    readonly blockLevel?: boolean;
     /**
      * Normalize value to canonical form
      *
@@ -482,6 +541,8 @@ declare class BlockHandlerRegistry {
 
 /** Block-level float on extended table host (4.2.10). */
 type TableBlockFloat = 'left' | 'center' | 'right';
+/** Block position when width is narrower than the line (margin-based, no float). */
+type TableBlockAlign = 'left' | 'center' | 'right' | 'justify';
 /**
  * Column alignment options (GFM column-level subset).
  */
@@ -531,6 +592,8 @@ interface TableBlockData {
     width?: number;
     /** Block-level float on host wrapper (4.2.10). */
     float?: TableBlockFloat;
+    /** Block position when width is set (margin-based, no float). */
+    blockAlign?: TableBlockAlign;
     /** Column alignments */
     colAligns?: (CellAlign | null)[];
     /** Cells indexed by "row:col" */
@@ -1427,6 +1490,17 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
+/**
+ * Project {@link ScriderDocumentMetadata} onto an HTML {@link DocumentPresentation}
+ * (export / clipboard inline CSS).
+ *
+ * Only presentation-relevant fields are mapped (line/paragraph spacing, indent).
+ * Heading policy (align/bold/size grid) and fonts are applied by upstream layers
+ * (CSS vars in the editor, bake into block/inline attrs) and are deliberately not
+ * part of the inline projection. Returns `undefined` when nothing maps, so callers
+ * can fall back cleanly.
+ */
+declare function documentMetadataToPresentation(metadata: ScriderDocumentMetadata | undefined): DocumentPresentation | undefined;
 /** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
@@ -1545,6 +1619,15 @@ interface DeltaToHtmlOptions {
      * Office/HTML export and clipboard. Does not change Delta.
      */
     documentPresentation?: DocumentPresentation;
+    /**
+     * Document-level metadata (Scrider format extension, `scrider-metadata`).
+     *
+     * When {@link documentPresentation} is not provided, the presentation-relevant
+     * fields of this metadata are projected to inline CSS via
+     * `documentMetadataToPresentation` (export/clipboard). An explicit
+     * `documentPresentation` always takes precedence. Does not change Delta.
+     */
+    documentMetadata?: ScriderDocumentMetadata;
     /**
      * Cross-origin iframe isolation for embed formats (codeWidget, video iframe).
      * Default: both off — standard third-party iframes load with browser cookies.
@@ -2068,4 +2151,4 @@ declare function collectAdjacentTableLines<T extends {
  */
 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 CellHorizontalAlign, type CellVerticalAlign, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type EmbedIsolationOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatRenderContext, 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, SCRIDER_MARGIN_BEFORE_KEY, type SanitizeOptions, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, 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, isAdjacentSimpleTableGridBoundary, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableCellCoordsFromAttributes, tableCellCoordsFromOp, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toCodeWidgetEmbedUrl, 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 CellHorizontalAlign, type CellVerticalAlign, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type EmbedIsolationOptions, type FootnotesBlockData, type Format, type FormatDefinition, type FormatMatchResult, type FormatRenderContext, 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, SCRIDER_MARGIN_BEFORE_KEY, type SanitizeOptions, type ScriderDocumentMetadata, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentMetadataToPresentation, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isAdjacentSimpleTableGridBoundary, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, tableCellCoordsFromAttributes, tableCellCoordsFromOp, tableColAlignFormat, tableColFormat, tableHeaderFormat, tableRowFormat, toCodeWidgetEmbedUrl, toHexColor, underlineFormat, unescapeHtml, validateDelta, videoFormat };

package/dist/index.js

@@ -627,6 +627,7 @@ function toCodeWidgetEmbedUrl(url) {
 var EXT_TABLE_HOST_ATTR = "data-scrider-ext-table";
 var EXT_TABLE_HOST_CLASS = "scrider-ext-table-host";
 var VALID_TABLE_BLOCK_FLOATS = ["left", "center", "right"];
+var VALID_TABLE_BLOCK_ALIGNS = ["left", "center", "right", "justify"];
 var VALID_CELL_HORIZONTAL_ALIGNS = [
   "left",
   "center",
@@ -830,6 +831,12 @@ function parseTableBlockFloat(value) {
   if (value === "left" || value === "center" || value === "right") return value;
   return void 0;
 }
+function parseTableBlockAlign(value) {
+  if (value === "left" || value === "center" || value === "right" || value === "justify") {
+    return value;
+  }
+  return void 0;
+}
 function extractHostBlockWidthPx(host) {
   const style = host.getAttribute("style") || "";
   const widthMatch = style.match(/(?:^|;\s*)width:\s*([\d.]+)px/i);
@@ -840,25 +847,34 @@ function extractHostBlockWidthPx(host) {
 }
 function enrichTableBlockFromHost(data, host) {
   const float = parseTableBlockFloat(host.getAttribute("data-float"));
+  const blockAlign = parseTableBlockAlign(host.getAttribute("data-block-align"));
   const width = extractHostBlockWidthPx(host);
-  if (float == null && width == null) return data;
+  if (float == null && blockAlign == null && width == null) return data;
   const next = { ...data };
   if (float != null) next.float = float;
+  if (blockAlign != null && float == null) next.blockAlign = blockAlign;
   if (width != null) next.width = width;
   return next;
 }
 function tableNeedsHostWrapper(data) {
-  return data.float != null && VALID_TABLE_BLOCK_FLOATS.includes(data.float) || data.width != null && data.width > 0;
+  return data.float != null && VALID_TABLE_BLOCK_FLOATS.includes(data.float) || data.width != null && data.width > 0 || data.float == null && data.blockAlign != null && VALID_TABLE_BLOCK_ALIGNS.includes(data.blockAlign);
 }
 function renderTableHostWrapperOpen(data, pretty) {
   const nl = pretty ? "\n" : "";
   const ind = pretty ? "  " : "";
   const attrs = [`class="${EXT_TABLE_HOST_CLASS}"`, EXT_TABLE_HOST_ATTR];
   if (data.float) attrs.push(`data-float="${escapeHtml(data.float)}"`);
+  if (data.blockAlign && !data.float) {
+    attrs.push(`data-block-align="${escapeHtml(data.blockAlign)}"`);
+  }
   const styleParts = [];
-  if (data.width != null && data.width > 0) {
+  if (data.blockAlign === "justify" && !data.float) {
+    styleParts.push("width: 100%");
+  } else if (data.width != null && data.width > 0) {
     styleParts.push(`width: ${Math.round(data.width)}px`);
     styleParts.push("max-width: 100%");
+  } else if (data.blockAlign && !data.float) {
+    styleParts.push("width: 100%");
   }
   if (styleParts.length > 0) attrs.push(`style="${styleParts.join("; ")}"`);
   return `<div ${attrs.join(" ")}>${nl}${ind}`;
@@ -879,6 +895,9 @@ function isGfmCompatible(data) {
   if (data.float != null) {
     return false;
   }
+  if (data.blockAlign != null) {
+    return false;
+  }
   for (const cell of Object.values(data.cells)) {
     if (cell !== null && cell.align !== void 0) return false;
   }
@@ -1263,6 +1282,9 @@ var tableBlockHandler = {
     if (data.float !== void 0 && !VALID_TABLE_BLOCK_FLOATS.includes(data.float)) {
       return false;
     }
+    if (data.blockAlign !== void 0 && !VALID_TABLE_BLOCK_ALIGNS.includes(data.blockAlign)) {
+      return false;
+    }
     if (data.colAligns !== void 0) {
       if (!Array.isArray(data.colAligns) || data.colAligns.length !== cols) {
         return false;
@@ -2472,6 +2494,7 @@ var codeWidgetFormat = {
 var dividerFormat = {
   name: "divider",
   scope: "embed",
+  blockLevel: true,
   normalize(value) {
     return !!value;
   },
@@ -3093,6 +3116,26 @@ function resolveDocumentPresentation(presentation) {
     listBlockIndentCm
   };
 }
+function documentMetadataToPresentation(metadata) {
+  if (!metadata) return void 0;
+  const presentation = {};
+  if (typeof metadata.lineSpacing === "number") {
+    presentation.lineSpacing = metadata.lineSpacing;
+  }
+  if (typeof metadata.paragraphSpacingBeforeEm === "number") {
+    presentation.paragraphSpacingBeforeEm = metadata.paragraphSpacingBeforeEm;
+  }
+  if (typeof metadata.paragraphSpacingAfterEm === "number") {
+    presentation.paragraphSpacingAfterEm = metadata.paragraphSpacingAfterEm;
+  }
+  if (typeof metadata.textIndentCm === "number") {
+    presentation.textIndentCm = metadata.textIndentCm;
+  }
+  if (typeof metadata.listBlockIndentCm === "number") {
+    presentation.listBlockIndentCm = metadata.listBlockIndentCm;
+  }
+  return Object.keys(presentation).length > 0 ? presentation : void 0;
+}
 var TEXT_INDENT_TAGS = /* @__PURE__ */ new Set(["p"]);
 function documentPresentationListWrapperStyleParts(resolved) {
   if (!resolved?.listBlockIndentCm) return [];
@@ -3278,7 +3321,9 @@ function deltaToHtml(delta, options = {}) {
   const hierarchicalNumbers = options.hierarchicalNumbers ?? false;
   const blockHandlers = options.blockHandlers;
   const anchorLinks = options.anchorLinks ?? false;
-  const resolvedDocumentPresentation = resolveDocumentPresentation(options.documentPresentation);
+  const resolvedDocumentPresentation = resolveDocumentPresentation(
+    options.documentPresentation ?? documentMetadataToPresentation(options.documentMetadata)
+  );
   let html = "";
   let listStack = [];
   let counters = [];
@@ -3916,7 +3961,13 @@ function htmlToDelta(html, options = {}) {
         if (format.match) {
           const result = format.match(node);
           if (result != null) {
+            if (format.blockLevel && !atLineStart) {
+              context.pushNewline();
+            }
             context.pushEmbed({ [format.name]: result.value }, result.attributes);
+            if (format.blockLevel) {
+              context.pushNewline();
+            }
             return;
           }
         }
@@ -3931,6 +3982,9 @@ function htmlToDelta(html, options = {}) {
       return;
     }
     if (tagName === "hr") {
+      if (!atLineStart) {
+        context.pushNewline();
+      }
       context.pushEmbed({ divider: true });
       context.pushNewline();
       return;
@@ -6049,6 +6103,7 @@ export {
   deltaToHtml,
   deltaToMarkdown,
   dividerFormat,
+  documentMetadataToPresentation,
   documentPresentationStyleParts,
   escapeHtml,
   extractBoxOpAttributes,