@scrider/formatter 1.8.7 → 1.10.0

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
      *
@@ -1368,8 +1427,12 @@ declare const SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
 declare const SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 /** Space before plain paragraph (`margin-top`) on `\n` (Settings Apply). */
 declare const SCRIDER_MARGIN_BEFORE_KEY = "scrider-margin-before";
+/** Per-paragraph first-line indent stored on `\n` (Word paste, Settings Apply). */
+declare const SCRIDER_TEXT_INDENT_KEY = "scrider-text-indent";
 /** Block tags that receive line spacing (not headings). */
 declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/** Block tags that receive first-line indent (plain `<p>` only). */
+declare const TEXT_INDENT_BLOCK_TAGS: Set<string>;
 /** Block tags that receive paragraph spacing after (plain `<p>` only). */
 declare const PARAGRAPH_SPACING_BLOCK_TAGS: Set<string>;
 /**
@@ -1381,6 +1444,14 @@ 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[];
+/**
+ * First-line indent for a plain `<p>`: `scrider-text-indent` on the line (baked,
+ * e.g. Word paste) → documentPresentation `textIndentCm` → none.
+ *
+ * The block attr wins over the document default (mirrors line-height / margin
+ * resolution). The raw block value is a CSS length string (e.g. `1.25cm`).
+ */
+declare function blockTextIndentStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
  * Parse paragraph margin in em from Delta / inline CSS (`0.5em`, `0.5`).
  */
@@ -1431,10 +1502,32 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
-/** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
+/**
+ * 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 first-line indent only (no per-block attr).
+ *
+ * @deprecated Superseded by {@link blockTextIndentStyleParts}, which resolves the
+ * per-block `scrider-text-indent` attr with the document default as fallback and
+ * is what {@link blockPresentationStyleParts} now uses. Kept exported for
+ * backward compatibility; output is unchanged for document-only callers.
+ */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
  * All block presentation styles for deltaToHtml: Delta attrs, then document defaults.
+ *
+ * First-line indent now resolves per-block: baked `scrider-text-indent` wins over
+ * the document `textIndentCm` default (previously the per-block attr was dropped
+ * on export). Output for document-only paragraphs is unchanged.
  */
 declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
@@ -1549,6 +1642,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.
@@ -1575,6 +1677,36 @@ interface DeltaToHtmlOptions {
  * ```
  */
 declare function deltaToHtml(delta: Delta, options?: DeltaToHtmlOptions): string;
+/**
+ * Rendering profile: how a Delta is turned into markup.
+ *
+ * - `export`: full fidelity for clipboard / Office / HTML export. Document-level
+ *   presentation (line/paragraph spacing, first-line/list indent) and table
+ *   presentation are projected to inline CSS so the markup is self-contained.
+ * - `editor`: markup for the editor's contenteditable surface. Document-level
+ *   presentation and table presentation are intentionally dropped — the editor
+ *   applies them live via CSS custom properties on the container, so inline
+ *   copies would double-apply and fight the Settings panel. Per-block baked
+ *   attributes (`scrider-line-height`, `scrider-margin-*`, `scrider-text-indent`)
+ *   still render, since they are part of the document content.
+ */
+type RenderProfile = 'export' | 'editor';
+/**
+ * Render a Delta with an explicit {@link RenderProfile}.
+ *
+ * Thin dispatcher over {@link deltaToHtml} (the export core). See
+ * {@link RenderProfile} for how the profiles differ.
+ */
+declare function renderDelta(delta: Delta, profile: RenderProfile, options?: DeltaToHtmlOptions): string;
+/**
+ * Render a Delta for the editor's contenteditable surface (`editor` profile).
+ *
+ * Equivalent to `renderDelta(delta, 'editor', options)`. Document-level and table
+ * presentation are dropped (applied live via CSS vars); the built-in `softBreak`
+ * renderer already emits `<br data-scrider-embed>`, so the editor needs no
+ * embed-renderer override.
+ */
+declare function deltaToDom(delta: Delta, options?: DeltaToHtmlOptions): string;
 
 /**
  * HTML → Delta Conversion
@@ -2072,4 +2204,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 RenderProfile, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, SCRIDER_MARGIN_AFTER_KEY, SCRIDER_MARGIN_BEFORE_KEY, SCRIDER_TEXT_INDENT_KEY, type SanitizeOptions, type ScriderDocumentMetadata, TEXT_INDENT_BLOCK_TAGS, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockTextIndentStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToDom, 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, renderDelta, 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
      *
@@ -1368,8 +1427,12 @@ declare const SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
 declare const SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 /** Space before plain paragraph (`margin-top`) on `\n` (Settings Apply). */
 declare const SCRIDER_MARGIN_BEFORE_KEY = "scrider-margin-before";
+/** Per-paragraph first-line indent stored on `\n` (Word paste, Settings Apply). */
+declare const SCRIDER_TEXT_INDENT_KEY = "scrider-text-indent";
 /** Block tags that receive line spacing (not headings). */
 declare const LINE_HEIGHT_BLOCK_TAGS: Set<string>;
+/** Block tags that receive first-line indent (plain `<p>` only). */
+declare const TEXT_INDENT_BLOCK_TAGS: Set<string>;
 /** Block tags that receive paragraph spacing after (plain `<p>` only). */
 declare const PARAGRAPH_SPACING_BLOCK_TAGS: Set<string>;
 /**
@@ -1381,6 +1444,14 @@ 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[];
+/**
+ * First-line indent for a plain `<p>`: `scrider-text-indent` on the line (baked,
+ * e.g. Word paste) → documentPresentation `textIndentCm` → none.
+ *
+ * The block attr wins over the document default (mirrors line-height / margin
+ * resolution). The raw block value is a CSS length string (e.g. `1.25cm`).
+ */
+declare function blockTextIndentStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
  * Parse paragraph margin in em from Delta / inline CSS (`0.5em`, `0.5`).
  */
@@ -1431,10 +1502,32 @@ interface ResolvedDocumentPresentation {
     listBlockIndentCm: number | undefined;
 }
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
-/** Document-level styles only (line-height merged via {@link blockLineHeightStyleParts}). */
+/**
+ * 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 first-line indent only (no per-block attr).
+ *
+ * @deprecated Superseded by {@link blockTextIndentStyleParts}, which resolves the
+ * per-block `scrider-text-indent` attr with the document default as fallback and
+ * is what {@link blockPresentationStyleParts} now uses. Kept exported for
+ * backward compatibility; output is unchanged for document-only callers.
+ */
 declare function documentPresentationStyleParts(tag: string, resolved: ResolvedDocumentPresentation | undefined): string[];
 /**
  * All block presentation styles for deltaToHtml: Delta attrs, then document defaults.
+ *
+ * First-line indent now resolves per-block: baked `scrider-text-indent` wins over
+ * the document `textIndentCm` default (previously the per-block attr was dropped
+ * on export). Output for document-only paragraphs is unchanged.
  */
 declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
@@ -1549,6 +1642,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.
@@ -1575,6 +1677,36 @@ interface DeltaToHtmlOptions {
  * ```
  */
 declare function deltaToHtml(delta: Delta, options?: DeltaToHtmlOptions): string;
+/**
+ * Rendering profile: how a Delta is turned into markup.
+ *
+ * - `export`: full fidelity for clipboard / Office / HTML export. Document-level
+ *   presentation (line/paragraph spacing, first-line/list indent) and table
+ *   presentation are projected to inline CSS so the markup is self-contained.
+ * - `editor`: markup for the editor's contenteditable surface. Document-level
+ *   presentation and table presentation are intentionally dropped — the editor
+ *   applies them live via CSS custom properties on the container, so inline
+ *   copies would double-apply and fight the Settings panel. Per-block baked
+ *   attributes (`scrider-line-height`, `scrider-margin-*`, `scrider-text-indent`)
+ *   still render, since they are part of the document content.
+ */
+type RenderProfile = 'export' | 'editor';
+/**
+ * Render a Delta with an explicit {@link RenderProfile}.
+ *
+ * Thin dispatcher over {@link deltaToHtml} (the export core). See
+ * {@link RenderProfile} for how the profiles differ.
+ */
+declare function renderDelta(delta: Delta, profile: RenderProfile, options?: DeltaToHtmlOptions): string;
+/**
+ * Render a Delta for the editor's contenteditable surface (`editor` profile).
+ *
+ * Equivalent to `renderDelta(delta, 'editor', options)`. Document-level and table
+ * presentation are dropped (applied live via CSS vars); the built-in `softBreak`
+ * renderer already emits `<br data-scrider-embed>`, so the editor needs no
+ * embed-renderer override.
+ */
+declare function deltaToDom(delta: Delta, options?: DeltaToHtmlOptions): string;
 
 /**
  * HTML → Delta Conversion
@@ -2072,4 +2204,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 RenderProfile, type ResolvedDocumentPresentation, type ResolvedTablePresentation, SCRIDER_LINE_HEIGHT_KEY, SCRIDER_MARGIN_AFTER_KEY, SCRIDER_MARGIN_BEFORE_KEY, SCRIDER_TEXT_INDENT_KEY, type SanitizeOptions, type ScriderDocumentMetadata, TEXT_INDENT_BLOCK_TAGS, type TableBlockData, type TableBlockFloat, type TableCellAlign, type TableCellCoords, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockTextIndentStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, collectAdjacentTableLines, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToDom, 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, renderDelta, 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

@@ -868,10 +868,12 @@ function renderTableHostWrapperOpen(data, pretty) {
     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 === "justify" && !data.float) {
+  } else if (data.blockAlign && !data.float) {
     styleParts.push("width: 100%");
   }
   if (styleParts.length > 0) attrs.push(`style="${styleParts.join("; ")}"`);
@@ -2492,6 +2494,7 @@ var codeWidgetFormat = {
 var dividerFormat = {
   name: "divider",
   scope: "embed",
+  blockLevel: true,
   normalize(value) {
     return !!value;
   },
@@ -2996,7 +2999,9 @@ function slugifyWithDedup(text, usedSlugs) {
 var SCRIDER_LINE_HEIGHT_KEY = "scrider-line-height";
 var SCRIDER_MARGIN_AFTER_KEY = "scrider-margin-after";
 var SCRIDER_MARGIN_BEFORE_KEY = "scrider-margin-before";
+var SCRIDER_TEXT_INDENT_KEY = "scrider-text-indent";
 var LINE_HEIGHT_BLOCK_TAGS = /* @__PURE__ */ new Set(["p", "li", "blockquote"]);
+var TEXT_INDENT_BLOCK_TAGS = /* @__PURE__ */ new Set(["p"]);
 var PARAGRAPH_SPACING_BLOCK_TAGS = /* @__PURE__ */ new Set(["p"]);
 function parseScriderLineHeightMultiplier(value) {
   const trimmed = value.trim();
@@ -3026,6 +3031,18 @@ function blockLineHeightStyleParts(tag, blockAttributes, resolved) {
   }
   return [];
 }
+function blockTextIndentStyleParts(tag, blockAttributes, resolved) {
+  if (!TEXT_INDENT_BLOCK_TAGS.has(tag)) return [];
+  const raw = blockAttributes?.[SCRIDER_TEXT_INDENT_KEY];
+  if (typeof raw === "string") {
+    const trimmed = raw.trim();
+    if (trimmed) return [`text-indent:${trimmed}`];
+  }
+  if (resolved?.textIndentCm !== void 0) {
+    return [`text-indent:${resolved.textIndentCm}cm`];
+  }
+  return [];
+}
 function parseScriderMarginEm(value) {
   const trimmed = value.trim();
   if (!trimmed) return void 0;
@@ -3113,6 +3130,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 [];
@@ -3130,7 +3167,7 @@ function blockPresentationStyleParts(tag, blockAttributes, resolved) {
   return [
     ...blockLineHeightStyleParts(tag, blockAttributes, resolved),
     ...blockParagraphMarginStyleParts(tag, blockAttributes, resolved),
-    ...documentPresentationStyleParts(tag, resolved)
+    ...blockTextIndentStyleParts(tag, blockAttributes, resolved)
   ];
 }
 function joinStyleParts(parts) {
@@ -3298,7 +3335,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 = [];
@@ -3412,6 +3451,19 @@ function deltaToHtml(delta, options = {}) {
   }
   return html;
 }
+function stripPresentationForEditor(options) {
+  const rest = { ...options };
+  delete rest.documentPresentation;
+  delete rest.documentMetadata;
+  delete rest.tablePresentation;
+  return rest;
+}
+function renderDelta(delta, profile, options = {}) {
+  return profile === "editor" ? deltaToHtml(delta, stripPresentationForEditor(options)) : deltaToHtml(delta, options);
+}
+function deltaToDom(delta, options = {}) {
+  return renderDelta(delta, "editor", options);
+}
 function getIndent(level) {
   return "  ".repeat(level);
 }
@@ -3936,7 +3988,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;
           }
         }
@@ -3951,6 +4009,9 @@ function htmlToDelta(html, options = {}) {
       return;
     }
     if (tagName === "hr") {
+      if (!atLineStart) {
+        context.pushNewline();
+      }
       context.pushEmbed({ divider: true });
       context.pushNewline();
       return;
@@ -6040,6 +6101,8 @@ export {
   SCRIDER_LINE_HEIGHT_KEY,
   SCRIDER_MARGIN_AFTER_KEY,
   SCRIDER_MARGIN_BEFORE_KEY,
+  SCRIDER_TEXT_INDENT_KEY,
+  TEXT_INDENT_BLOCK_TAGS,
   alertBlockHandler,
   alignFormat,
   backgroundFormat,
@@ -6049,6 +6112,7 @@ export {
   blockMarginBeforeStyleParts,
   blockParagraphMarginStyleParts,
   blockPresentationStyleParts,
+  blockTextIndentStyleParts,
   blockquoteFormat,
   boldFormat,
   boxBlockHandler,
@@ -6066,9 +6130,11 @@ export {
   defaultEmbedFormats,
   defaultFormats,
   defaultInlineFormats,
+  deltaToDom,
   deltaToHtml,
   deltaToMarkdown,
   dividerFormat,
+  documentMetadataToPresentation,
   documentPresentationStyleParts,
   escapeHtml,
   extractBoxOpAttributes,
@@ -6107,6 +6173,7 @@ export {
   parseScriderMarginBeforeEm,
   parseScriderMarginEm,
   preloadRemark,
+  renderDelta,
   resolveDocumentPresentation,
   resolveTablePresentation,
   sanitizeDelta,