@scrider/formatter 1.10.1 → 1.10.3

package/dist/index.d.cts

@@ -2,13 +2,55 @@ import { AttributeMap, Op, Delta, InsertOp } from '@scrider/delta';
 export * from '@scrider/delta';
 export { InsertOp as ContentOp } from '@scrider/delta';
 
+/**
+ * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
+ * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
+ */
+/** Column/cell horizontal alignment (GFM subset). */
+type TableCellAlign = 'left' | 'center' | 'right';
+/** Optional styling when serializing Simple Tables to HTML. */
+interface TablePresentation {
+    /** Full 1px border on all cell sides. When true, `line` is ignored. */
+    grid?: boolean;
+    /** Bottom border only (DeepSeek / ChatGPT). Used when `grid` is not true. */
+    line?: boolean;
+    /** Border color as explicit hex (e.g. `#e7e7e7`). */
+    borderColor?: string;
+    /** Background on header cells (`th`). */
+    headerShade?: boolean;
+    /** Background on even table rows in the body (see `isZebraBodyRow`). */
+    zebraRows?: boolean;
+    /** `font-weight: bold` on `th`. */
+    headerBold?: boolean;
+    /** `text-align: center` on `th` (GitHub-style header). */
+    headerCenter?: boolean;
+    /**
+     * Alignment for cells without `table-col-align` in Delta. Never overrides GFM column align.
+     * @default 'left'
+     */
+    defaultCellAlign?: TableCellAlign;
+}
+interface ResolvedTablePresentation {
+    grid: boolean;
+    line: boolean;
+    borderColor: string;
+    headerShade: boolean;
+    zebraRows: boolean;
+    headerBold: boolean;
+    headerCenter: boolean;
+    defaultCellAlign: TableCellAlign;
+}
+declare function resolveTablePresentation(presentation?: TablePresentation): ResolvedTablePresentation;
+/** Match CSS `tr:nth-child(even) td` when header rows precede body in `<table>`. */
+declare function isZebraBodyRow(headerRowCount: number, bodyRowIndex: number): boolean;
+
 /**
  * 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`.
+ * (line spacing, paragraph spacing, indent, heading policy, fonts, table
+ * presentation) instead of duplicating them as block attributes on every `\n`.
  *
  * Layering:
  * - `@scrider/delta` treats the value as opaque `Record<string, unknown>` — it
@@ -18,11 +60,15 @@ export { InsertOp as ContentOp } from '@scrider/delta';
  *   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.
+ * op-stream and is backward compatible.
+ *
+ * Projection:
+ * - Spacing / indent → {@link documentMetadataToPresentation} (paragraph CSS).
+ * - Heading policy → {@link resolveHeadingPolicy} / heading block styles on `h1`–`h6`.
+ * - `tablePresentation` → same shape as `DeltaToHtmlOptions.tablePresentation`
+ *   (used when the explicit option is omitted).
  */
+
 interface ScriderDocumentMetadata {
     /** Line spacing multiplier, e.g. `1.5`. */
     lineSpacing?: number;
@@ -34,16 +80,35 @@ interface ScriderDocumentMetadata {
     textIndentCm?: number;
     /** Extra left indent in cm on top-level `<ul>`/`<ol>` (shifts marker + text). */
     listBlockIndentCm?: number;
-    /** Document heading horizontal alignment policy. */
+    /** Document heading horizontal alignment policy. Presence = policy on. */
     headingAlign?: 'left' | 'center' | 'right';
-    /** Document heading bold policy. */
+    /** Document heading bold policy. `true` = force bold on `h1`–`h6`. */
     headingBold?: boolean;
-    /** Named heading size-grid preset id (schema defined upstream). */
+    /**
+     * Named heading size-grid preset id (`scrider` | `google` | `word` | `browser` | `githubEm`).
+     * Ignored when {@link headingAuto} is true.
+     */
     headingSizeGridPreset?: string;
+    /**
+     * When true, headings use browser/CSS natural size (no size-grid projection).
+     * Mutually exclusive with {@link headingSizeGridPreset} in Settings UI.
+     */
+    headingAuto?: boolean;
+    /**
+     * Heading decoration preset (`none` | `scrider` | `github`).
+     * Editor: `data-scrider-heading-decoration`. Export: PDF/HTML vertical rhythm + rules.
+     */
+    headingDecoration?: 'none' | 'scrider' | 'github';
     /** 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;
+    /**
+     * Simple / view table chrome (borders, header shade, zebra). Same shape as
+     * `DeltaToHtmlOptions.tablePresentation`. Persisted with the document so export
+     * matches Settings without a separate channel.
+     */
+    tablePresentation?: TablePresentation;
 }
 
 /**
@@ -1504,13 +1569,12 @@ interface ResolvedDocumentPresentation {
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
 /**
  * Project {@link ScriderDocumentMetadata} onto an HTML {@link DocumentPresentation}
- * (export / clipboard inline CSS).
+ * (export / clipboard inline CSS for paragraphs/lists).
  *
- * 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.
+ * Maps line/paragraph spacing and indent only. Heading policy is projected
+ * separately via {@link resolveHeadingPolicy} / {@link headingPolicyStyleParts}
+ * onto `h1`–`h6`. `tablePresentation` is read from metadata in `deltaToHtml`
+ * when the explicit option is omitted. Returns `undefined` when nothing maps.
  */
 declare function documentMetadataToPresentation(metadata: ScriderDocumentMetadata | undefined): DocumentPresentation | undefined;
 /**
@@ -1532,46 +1596,32 @@ declare function documentPresentationStyleParts(tag: string, resolved: ResolvedD
 declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
- * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
- * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
+ * Document-level heading policy projected to export HTML (`h1`–`h6` inline CSS).
+ *
+ * Editor applies the same policy via CSS vars (`--scrider-heading-*`, `--scrider-hN-size`).
+ * Size maps mirror `editor-core` `HEADER_SIZE_PRESETS` — keep in sync.
  */
-/** Column/cell horizontal alignment (GFM subset). */
-type TableCellAlign = 'left' | 'center' | 'right';
-/** Optional styling when serializing Simple Tables to HTML. */
-interface TablePresentation {
-    /** Full 1px border on all cell sides. When true, `line` is ignored. */
-    grid?: boolean;
-    /** Bottom border only (DeepSeek / ChatGPT). Used when `grid` is not true. */
-    line?: boolean;
-    /** Border color as explicit hex (e.g. `#e7e7e7`). */
-    borderColor?: string;
-    /** Background on header cells (`th`). */
-    headerShade?: boolean;
-    /** Background on even table rows in the body (see `isZebraBodyRow`). */
-    zebraRows?: boolean;
-    /** `font-weight: bold` on `th`. */
-    headerBold?: boolean;
-    /** `text-align: center` on `th` (GitHub-style header). */
-    headerCenter?: boolean;
-    /**
-     * Alignment for cells without `table-col-align` in Delta. Never overrides GFM column align.
-     * @default 'left'
-     */
-    defaultCellAlign?: TableCellAlign;
-}
-interface ResolvedTablePresentation {
-    grid: boolean;
-    line: boolean;
-    borderColor: string;
-    headerShade: boolean;
-    zebraRows: boolean;
-    headerBold: boolean;
-    headerCenter: boolean;
-    defaultCellAlign: TableCellAlign;
+
+type HeaderLevel = 1 | 2 | 3 | 4 | 5 | 6;
+type HeaderSizeMap = Readonly<Record<HeaderLevel, string>>;
+type HeaderSizePresetName = 'scrider' | 'google' | 'word' | 'browser' | 'githubEm';
+/** Keep in sync with `@scrider/editor-core` `HEADER_SIZE_PRESETS`. */
+declare const HEADER_SIZE_PRESETS: Readonly<Record<HeaderSizePresetName, HeaderSizeMap>>;
+interface ResolvedHeadingPolicy {
+    align: 'left' | 'center' | 'right' | undefined;
+    bold: boolean;
+    /** When set and `auto` is false, emit font-size on `hN` when Delta has no inline size. */
+    sizePreset: HeaderSizePresetName | undefined;
+    auto: boolean;
 }
-declare function resolveTablePresentation(presentation?: TablePresentation): ResolvedTablePresentation;
-/** Match CSS `tr:nth-child(even) td` when header rows precede body in `<table>`. */
-declare function isZebraBodyRow(headerRowCount: number, bodyRowIndex: number): boolean;
+declare function resolveHeadingPolicy(metadata: ScriderDocumentMetadata | undefined): ResolvedHeadingPolicy | undefined;
+/**
+ * Inline styles for a heading block from document metadata.
+ * Baked Delta attrs win: `align` on `\n` skips metadata align; presence of any
+ * text with explicit `size` is not detectable at block level — size from preset
+ * is always emitted when policy is on (matches editor CSS vars on `hN`).
+ */
+declare function headingPolicyStyleParts(tag: string, blockAttributes: AttributeMap | undefined, policy: ResolvedHeadingPolicy | undefined): string[];
 
 /**
  * Delta → HTML Conversion
@@ -1645,10 +1695,12 @@ interface DeltaToHtmlOptions {
     /**
      * 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.
+     * When {@link documentPresentation} is not provided, spacing/indent fields are
+     * projected via `documentMetadataToPresentation`. Heading policy
+     * (`headingAlign` / `headingBold` / `headingSizeGridPreset` / `headingAuto`)
+     * is projected onto `h1`–`h6`. When {@link tablePresentation} is omitted,
+     * `metadata.tablePresentation` is used. An explicit `documentPresentation` /
+     * `tablePresentation` always takes precedence. Does not change Delta.
      */
     documentMetadata?: ScriderDocumentMetadata;
     /**
@@ -2204,4 +2256,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 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 };
+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, HEADER_SIZE_PRESETS, 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, headingPolicyStyleParts, 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, resolveHeadingPolicy, 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,13 +2,55 @@ import { AttributeMap, Op, Delta, InsertOp } from '@scrider/delta';
 export * from '@scrider/delta';
 export { InsertOp as ContentOp } from '@scrider/delta';
 
+/**
+ * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
+ * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
+ */
+/** Column/cell horizontal alignment (GFM subset). */
+type TableCellAlign = 'left' | 'center' | 'right';
+/** Optional styling when serializing Simple Tables to HTML. */
+interface TablePresentation {
+    /** Full 1px border on all cell sides. When true, `line` is ignored. */
+    grid?: boolean;
+    /** Bottom border only (DeepSeek / ChatGPT). Used when `grid` is not true. */
+    line?: boolean;
+    /** Border color as explicit hex (e.g. `#e7e7e7`). */
+    borderColor?: string;
+    /** Background on header cells (`th`). */
+    headerShade?: boolean;
+    /** Background on even table rows in the body (see `isZebraBodyRow`). */
+    zebraRows?: boolean;
+    /** `font-weight: bold` on `th`. */
+    headerBold?: boolean;
+    /** `text-align: center` on `th` (GitHub-style header). */
+    headerCenter?: boolean;
+    /**
+     * Alignment for cells without `table-col-align` in Delta. Never overrides GFM column align.
+     * @default 'left'
+     */
+    defaultCellAlign?: TableCellAlign;
+}
+interface ResolvedTablePresentation {
+    grid: boolean;
+    line: boolean;
+    borderColor: string;
+    headerShade: boolean;
+    zebraRows: boolean;
+    headerBold: boolean;
+    headerCenter: boolean;
+    defaultCellAlign: TableCellAlign;
+}
+declare function resolveTablePresentation(presentation?: TablePresentation): ResolvedTablePresentation;
+/** Match CSS `tr:nth-child(even) td` when header rows precede body in `<table>`. */
+declare function isZebraBodyRow(headerRowCount: number, bodyRowIndex: number): boolean;
+
 /**
  * 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`.
+ * (line spacing, paragraph spacing, indent, heading policy, fonts, table
+ * presentation) instead of duplicating them as block attributes on every `\n`.
  *
  * Layering:
  * - `@scrider/delta` treats the value as opaque `Record<string, unknown>` — it
@@ -18,11 +60,15 @@ export { InsertOp as ContentOp } from '@scrider/delta';
  *   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.
+ * op-stream and is backward compatible.
+ *
+ * Projection:
+ * - Spacing / indent → {@link documentMetadataToPresentation} (paragraph CSS).
+ * - Heading policy → {@link resolveHeadingPolicy} / heading block styles on `h1`–`h6`.
+ * - `tablePresentation` → same shape as `DeltaToHtmlOptions.tablePresentation`
+ *   (used when the explicit option is omitted).
  */
+
 interface ScriderDocumentMetadata {
     /** Line spacing multiplier, e.g. `1.5`. */
     lineSpacing?: number;
@@ -34,16 +80,35 @@ interface ScriderDocumentMetadata {
     textIndentCm?: number;
     /** Extra left indent in cm on top-level `<ul>`/`<ol>` (shifts marker + text). */
     listBlockIndentCm?: number;
-    /** Document heading horizontal alignment policy. */
+    /** Document heading horizontal alignment policy. Presence = policy on. */
     headingAlign?: 'left' | 'center' | 'right';
-    /** Document heading bold policy. */
+    /** Document heading bold policy. `true` = force bold on `h1`–`h6`. */
     headingBold?: boolean;
-    /** Named heading size-grid preset id (schema defined upstream). */
+    /**
+     * Named heading size-grid preset id (`scrider` | `google` | `word` | `browser` | `githubEm`).
+     * Ignored when {@link headingAuto} is true.
+     */
     headingSizeGridPreset?: string;
+    /**
+     * When true, headings use browser/CSS natural size (no size-grid projection).
+     * Mutually exclusive with {@link headingSizeGridPreset} in Settings UI.
+     */
+    headingAuto?: boolean;
+    /**
+     * Heading decoration preset (`none` | `scrider` | `github`).
+     * Editor: `data-scrider-heading-decoration`. Export: PDF/HTML vertical rhythm + rules.
+     */
+    headingDecoration?: 'none' | 'scrider' | 'github';
     /** 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;
+    /**
+     * Simple / view table chrome (borders, header shade, zebra). Same shape as
+     * `DeltaToHtmlOptions.tablePresentation`. Persisted with the document so export
+     * matches Settings without a separate channel.
+     */
+    tablePresentation?: TablePresentation;
 }
 
 /**
@@ -1504,13 +1569,12 @@ interface ResolvedDocumentPresentation {
 declare function resolveDocumentPresentation(presentation?: DocumentPresentation): ResolvedDocumentPresentation | undefined;
 /**
  * Project {@link ScriderDocumentMetadata} onto an HTML {@link DocumentPresentation}
- * (export / clipboard inline CSS).
+ * (export / clipboard inline CSS for paragraphs/lists).
  *
- * 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.
+ * Maps line/paragraph spacing and indent only. Heading policy is projected
+ * separately via {@link resolveHeadingPolicy} / {@link headingPolicyStyleParts}
+ * onto `h1`–`h6`. `tablePresentation` is read from metadata in `deltaToHtml`
+ * when the explicit option is omitted. Returns `undefined` when nothing maps.
  */
 declare function documentMetadataToPresentation(metadata: ScriderDocumentMetadata | undefined): DocumentPresentation | undefined;
 /**
@@ -1532,46 +1596,32 @@ declare function documentPresentationStyleParts(tag: string, resolved: ResolvedD
 declare function blockPresentationStyleParts(tag: string, blockAttributes: AttributeMap | undefined, resolved: ResolvedDocumentPresentation | undefined): string[];
 
 /**
- * Simple Table HTML presentation options for deltaToHtml (clipboard, export).
- * Structural data stays in Delta (table-row, table-col-align); this only affects inline styles.
+ * Document-level heading policy projected to export HTML (`h1`–`h6` inline CSS).
+ *
+ * Editor applies the same policy via CSS vars (`--scrider-heading-*`, `--scrider-hN-size`).
+ * Size maps mirror `editor-core` `HEADER_SIZE_PRESETS` — keep in sync.
  */
-/** Column/cell horizontal alignment (GFM subset). */
-type TableCellAlign = 'left' | 'center' | 'right';
-/** Optional styling when serializing Simple Tables to HTML. */
-interface TablePresentation {
-    /** Full 1px border on all cell sides. When true, `line` is ignored. */
-    grid?: boolean;
-    /** Bottom border only (DeepSeek / ChatGPT). Used when `grid` is not true. */
-    line?: boolean;
-    /** Border color as explicit hex (e.g. `#e7e7e7`). */
-    borderColor?: string;
-    /** Background on header cells (`th`). */
-    headerShade?: boolean;
-    /** Background on even table rows in the body (see `isZebraBodyRow`). */
-    zebraRows?: boolean;
-    /** `font-weight: bold` on `th`. */
-    headerBold?: boolean;
-    /** `text-align: center` on `th` (GitHub-style header). */
-    headerCenter?: boolean;
-    /**
-     * Alignment for cells without `table-col-align` in Delta. Never overrides GFM column align.
-     * @default 'left'
-     */
-    defaultCellAlign?: TableCellAlign;
-}
-interface ResolvedTablePresentation {
-    grid: boolean;
-    line: boolean;
-    borderColor: string;
-    headerShade: boolean;
-    zebraRows: boolean;
-    headerBold: boolean;
-    headerCenter: boolean;
-    defaultCellAlign: TableCellAlign;
+
+type HeaderLevel = 1 | 2 | 3 | 4 | 5 | 6;
+type HeaderSizeMap = Readonly<Record<HeaderLevel, string>>;
+type HeaderSizePresetName = 'scrider' | 'google' | 'word' | 'browser' | 'githubEm';
+/** Keep in sync with `@scrider/editor-core` `HEADER_SIZE_PRESETS`. */
+declare const HEADER_SIZE_PRESETS: Readonly<Record<HeaderSizePresetName, HeaderSizeMap>>;
+interface ResolvedHeadingPolicy {
+    align: 'left' | 'center' | 'right' | undefined;
+    bold: boolean;
+    /** When set and `auto` is false, emit font-size on `hN` when Delta has no inline size. */
+    sizePreset: HeaderSizePresetName | undefined;
+    auto: boolean;
 }
-declare function resolveTablePresentation(presentation?: TablePresentation): ResolvedTablePresentation;
-/** Match CSS `tr:nth-child(even) td` when header rows precede body in `<table>`. */
-declare function isZebraBodyRow(headerRowCount: number, bodyRowIndex: number): boolean;
+declare function resolveHeadingPolicy(metadata: ScriderDocumentMetadata | undefined): ResolvedHeadingPolicy | undefined;
+/**
+ * Inline styles for a heading block from document metadata.
+ * Baked Delta attrs win: `align` on `\n` skips metadata align; presence of any
+ * text with explicit `size` is not detectable at block level — size from preset
+ * is always emitted when policy is on (matches editor CSS vars on `hN`).
+ */
+declare function headingPolicyStyleParts(tag: string, blockAttributes: AttributeMap | undefined, policy: ResolvedHeadingPolicy | undefined): string[];
 
 /**
  * Delta → HTML Conversion
@@ -1645,10 +1695,12 @@ interface DeltaToHtmlOptions {
     /**
      * 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.
+     * When {@link documentPresentation} is not provided, spacing/indent fields are
+     * projected via `documentMetadataToPresentation`. Heading policy
+     * (`headingAlign` / `headingBold` / `headingSizeGridPreset` / `headingAuto`)
+     * is projected onto `h1`–`h6`. When {@link tablePresentation} is omitted,
+     * `metadata.tablePresentation` is used. An explicit `documentPresentation` /
+     * `tablePresentation` always takes precedence. Does not change Delta.
      */
     documentMetadata?: ScriderDocumentMetadata;
     /**
@@ -2204,4 +2256,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 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 };
+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, HEADER_SIZE_PRESETS, 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, headingPolicyStyleParts, 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, resolveHeadingPolicy, 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

@@ -3178,6 +3178,90 @@ function joinStyleParts(parts) {
   return parts.length > 0 ? ` style="${parts.join("; ")}"` : "";
 }
 
+// src/conversion/html/heading-presentation.ts
+var HEADER_SIZE_PRESETS = Object.freeze({
+  scrider: Object.freeze({
+    1: "32pt",
+    2: "24pt",
+    3: "20pt",
+    4: "18pt",
+    5: "16pt",
+    6: "14pt"
+  }),
+  google: Object.freeze({
+    1: "26pt",
+    2: "20pt",
+    3: "16pt",
+    4: "14pt",
+    5: "12pt",
+    6: "11pt"
+  }),
+  word: Object.freeze({
+    1: "22pt",
+    2: "18pt",
+    3: "16pt",
+    4: "14pt",
+    5: "12pt",
+    6: "12pt"
+  }),
+  browser: Object.freeze({
+    1: "24pt",
+    2: "18pt",
+    3: "14pt",
+    4: "12pt",
+    5: "10pt",
+    6: "8pt"
+  }),
+  githubEm: Object.freeze({
+    1: "32pt",
+    2: "24pt",
+    3: "20pt",
+    4: "16pt",
+    5: "14pt",
+    6: "14pt"
+  })
+});
+var HEADING_TAGS = /* @__PURE__ */ new Set(["h1", "h2", "h3", "h4", "h5", "h6"]);
+function isHeaderSizePresetName(value) {
+  return Object.prototype.hasOwnProperty.call(HEADER_SIZE_PRESETS, value);
+}
+function resolveHeadingPolicy(metadata) {
+  if (!metadata) return void 0;
+  const align = metadata.headingAlign === "left" || metadata.headingAlign === "center" || metadata.headingAlign === "right" ? metadata.headingAlign : void 0;
+  const bold = metadata.headingBold === true;
+  const auto = metadata.headingAuto === true;
+  const presetRaw = metadata.headingSizeGridPreset;
+  const sizePreset = !auto && typeof presetRaw === "string" && isHeaderSizePresetName(presetRaw) ? presetRaw : void 0;
+  if (align === void 0 && !bold && sizePreset === void 0 && !auto) {
+    return void 0;
+  }
+  return { align, bold, sizePreset, auto };
+}
+function headingLevelFromTag(tag) {
+  if (!HEADING_TAGS.has(tag)) return void 0;
+  const n = Number(tag.slice(1));
+  if (n >= 1 && n <= 6) return n;
+  return void 0;
+}
+function headingPolicyStyleParts(tag, blockAttributes, policy) {
+  if (!policy) return [];
+  const level = headingLevelFromTag(tag);
+  if (level === void 0) return [];
+  const parts = [];
+  const bakedAlign = blockAttributes?.align;
+  if (policy.align && policy.align !== "left" && !(typeof bakedAlign === "string" && bakedAlign.length > 0)) {
+    parts.push(`text-align: ${policy.align}`);
+  }
+  if (policy.bold) {
+    parts.push("font-weight: bold");
+  }
+  if (policy.sizePreset) {
+    const size = HEADER_SIZE_PRESETS[policy.sizePreset][level];
+    if (size) parts.push(`font-size: ${size}`);
+  }
+  return parts;
+}
+
 // src/conversion/html/table-presentation.ts
 var DEFAULT_BORDER_COLOR = "#e7e7e7";
 var DEFAULT_HEADER_BG = "#f5f5f5";
@@ -3342,6 +3426,12 @@ function deltaToHtml(delta, options = {}) {
   const resolvedDocumentPresentation = resolveDocumentPresentation(
     options.documentPresentation ?? documentMetadataToPresentation(options.documentMetadata)
   );
+  const resolvedHeadingPolicy = resolveHeadingPolicy(options.documentMetadata);
+  const effectiveTablePresentation = options.tablePresentation ?? options.documentMetadata?.tablePresentation;
+  const optionsWithTable = {
+    ...options,
+    ...effectiveTablePresentation !== void 0 ? { tablePresentation: effectiveTablePresentation } : {}
+  };
   let html = "";
   let listStack = [];
   let counters = [];
@@ -3354,7 +3444,7 @@ function deltaToHtml(delta, options = {}) {
       listStack = [];
       counters = [];
       const tableLines = collectAdjacentTableLines(lines, i);
-      html += renderTable(tableLines, embedRenderers, pretty, blockHandlers, options);
+      html += renderTable(tableLines, embedRenderers, pretty, blockHandlers, optionsWithTable);
       i += tableLines.length - 1;
       continue;
     }
@@ -3445,7 +3535,8 @@ function deltaToHtml(delta, options = {}) {
         line.attributes,
         pretty,
         headingId,
-        resolvedDocumentPresentation
+        resolvedDocumentPresentation,
+        resolvedHeadingPolicy
       );
     }
   }
@@ -3765,19 +3856,23 @@ function renderListItem(content, attrs, blockAttributes, pretty, indentLevel, hi
   const html = `${indent}<li${fullAttrs}>${innerContent}</li>`;
   return pretty ? html + "\n" : html;
 }
-function renderBlock(content, tag, attributes, pretty, id, resolvedDocumentPresentation) {
+function renderBlock(content, tag, attributes, pretty, id, resolvedDocumentPresentation, resolvedHeadingPolicy) {
   const idAttr = id ? ` id="${escapeHtml(id)}"` : "";
-  const styleAttr = getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation);
+  const styleAttr = getBlockStyleAttribute(
+    tag,
+    attributes,
+    resolvedDocumentPresentation,
+    resolvedHeadingPolicy
+  );
   const innerContent = content || "<br>";
   const html = `<${tag}${idAttr}${styleAttr}>${innerContent}</${tag}>`;
   return pretty ? html + "\n" : html;
 }
-function getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation) {
-  const styles = blockPresentationStyleParts(
-    tag,
-    attributes,
-    resolvedDocumentPresentation
-  );
+function getBlockStyleAttribute(tag, attributes, resolvedDocumentPresentation, resolvedHeadingPolicy) {
+  const styles = [
+    ...blockPresentationStyleParts(tag, attributes, resolvedDocumentPresentation),
+    ...headingPolicyStyleParts(tag, attributes, resolvedHeadingPolicy)
+  ];
   if (attributes) {
     const alignVal = attributes.align;
     if (alignVal && typeof alignVal === "string" && alignVal !== "left") {
@@ -6097,6 +6192,7 @@ export {
   BOX_OVERFLOW_VALUES,
   BlockHandlerRegistry,
   BrowserDOMAdapter,
+  HEADER_SIZE_PRESETS,
   LINE_HEIGHT_BLOCK_TAGS,
   NODE_TYPE,
   NodeDOMAdapter,
@@ -6151,6 +6247,7 @@ export {
   getNamedColors,
   headerFormat,
   headerIdFormat,
+  headingPolicyStyleParts,
   htmlToDelta,
   imageFormat,
   indentFormat,
@@ -6179,6 +6276,7 @@ export {
   preloadRemark,
   renderDelta,
   resolveDocumentPresentation,
+  resolveHeadingPolicy,
   resolveTablePresentation,
   sanitizeDelta,
   sizeFormat,