@scrider/formatter 1.8.0 → 1.8.2

package/dist/index.d.cts

@@ -481,9 +481,13 @@ declare class BlockHandlerRegistry {
 }
 
 /**
- * Cell alignment options
+ * Column alignment options (GFM column-level subset).
  */
 type CellAlign = 'left' | 'center' | 'right';
+/** Per-cell horizontal alignment (includes justify; not used in colAligns). */
+type CellHorizontalAlign = CellAlign | 'justify';
+/** Per-cell vertical alignment (schema in 1.8.2; HTML round-trip in 1.8.4). */
+type CellVerticalAlign = 'top' | 'middle' | 'bottom';
 /**
  * Data for a single cell in an Extended Table.
  *
@@ -497,6 +501,10 @@ interface CellData {
     colspan?: number;
     /** Number of rows this cell spans (default: 1) */
     rowspan?: number;
+    /** Per-cell horizontal override (default: inherit column via colAligns). */
+    align?: CellHorizontalAlign;
+    /** Per-cell vertical alignment (HTML ingest/emit in formatter 1.8.4). */
+    vAlign?: CellVerticalAlign;
 }
 /**
  * Extended Table block data.
@@ -1992,11 +2000,34 @@ interface TableRegion {
     /** Slice of the original ops array covering the region. */
     ops: InsertOp[];
 }
+/** Coordinates carried on a simple-table cell terminator `\n`. */
+interface TableCellCoords {
+    row: number;
+    col: number;
+}
 /**
  * Predicate: this op is a `\n`-op that terminates a simple-table cell
  * (i.e. it carries a `table-row` attribute).
  */
 declare function isTableNewlineOp(op: Op | undefined): boolean;
+declare function tableCellCoordsFromAttributes(attrs: AttributeMap | undefined): TableCellCoords | null;
+declare function tableCellCoordsFromOp(op: Op): TableCellCoords | null;
+/**
+ * True when `next` begins a new simple-table grid immediately after `prev`
+ * with no plain paragraph `\n` between them.
+ *
+ * Patterns:
+ *   • row decreases (e.g. 1 → 0) — new grid after a multi-row table
+ *   • both on row 0 but col resets to 0 — two single-row tables stacked
+ */
+declare function isAdjacentSimpleTableGridBoundary(prev: TableCellCoords, next: TableCellCoords): boolean;
+/**
+ * Collect consecutive table lines for one simple-table grid.
+ * Stops at the first non-table line or at an adjacent-grid boundary.
+ */
+declare function collectAdjacentTableLines<T extends {
+    attributes?: AttributeMap | undefined;
+}>(lines: readonly T[], startIndex: number): T[];
 /**
  * Find the boundaries of the simple-table region containing the given hint
  * op index. The hint may be:
@@ -2007,8 +2038,9 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  * The function walks **forward** from the hint to find the nearest `\n`-op:
  * if it does not carry a `table-row` attribute, the hint is not inside a
  * table and `null` is returned. Otherwise the algorithm extends the region
- * forward through contiguous table newlines and backward to the op just
- * after the previous non-table `\n`-op (or the start of the array).
+ * forward through contiguous table newlines (stopping at adjacent-grid
+ * boundaries) and backward to the op just after the previous non-table
+ * `\n`-op or adjacent-grid boundary (or the start of the array).
  *
  * @param ops - The full ops array (e.g. `delta.ops`).
  * @param hintOpIdx - Any op index known or guessed to be within a table.
@@ -2028,4 +2060,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type 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 TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, 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 TableBlockData, 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 };

package/dist/index.d.ts

@@ -481,9 +481,13 @@ declare class BlockHandlerRegistry {
 }
 
 /**
- * Cell alignment options
+ * Column alignment options (GFM column-level subset).
  */
 type CellAlign = 'left' | 'center' | 'right';
+/** Per-cell horizontal alignment (includes justify; not used in colAligns). */
+type CellHorizontalAlign = CellAlign | 'justify';
+/** Per-cell vertical alignment (schema in 1.8.2; HTML round-trip in 1.8.4). */
+type CellVerticalAlign = 'top' | 'middle' | 'bottom';
 /**
  * Data for a single cell in an Extended Table.
  *
@@ -497,6 +501,10 @@ interface CellData {
     colspan?: number;
     /** Number of rows this cell spans (default: 1) */
     rowspan?: number;
+    /** Per-cell horizontal override (default: inherit column via colAligns). */
+    align?: CellHorizontalAlign;
+    /** Per-cell vertical alignment (HTML ingest/emit in formatter 1.8.4). */
+    vAlign?: CellVerticalAlign;
 }
 /**
  * Extended Table block data.
@@ -1992,11 +2000,34 @@ interface TableRegion {
     /** Slice of the original ops array covering the region. */
     ops: InsertOp[];
 }
+/** Coordinates carried on a simple-table cell terminator `\n`. */
+interface TableCellCoords {
+    row: number;
+    col: number;
+}
 /**
  * Predicate: this op is a `\n`-op that terminates a simple-table cell
  * (i.e. it carries a `table-row` attribute).
  */
 declare function isTableNewlineOp(op: Op | undefined): boolean;
+declare function tableCellCoordsFromAttributes(attrs: AttributeMap | undefined): TableCellCoords | null;
+declare function tableCellCoordsFromOp(op: Op): TableCellCoords | null;
+/**
+ * True when `next` begins a new simple-table grid immediately after `prev`
+ * with no plain paragraph `\n` between them.
+ *
+ * Patterns:
+ *   • row decreases (e.g. 1 → 0) — new grid after a multi-row table
+ *   • both on row 0 but col resets to 0 — two single-row tables stacked
+ */
+declare function isAdjacentSimpleTableGridBoundary(prev: TableCellCoords, next: TableCellCoords): boolean;
+/**
+ * Collect consecutive table lines for one simple-table grid.
+ * Stops at the first non-table line or at an adjacent-grid boundary.
+ */
+declare function collectAdjacentTableLines<T extends {
+    attributes?: AttributeMap | undefined;
+}>(lines: readonly T[], startIndex: number): T[];
 /**
  * Find the boundaries of the simple-table region containing the given hint
  * op index. The hint may be:
@@ -2007,8 +2038,9 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  * The function walks **forward** from the hint to find the nearest `\n`-op:
  * if it does not carry a `table-row` attribute, the hint is not inside a
  * table and `null` is returned. Otherwise the algorithm extends the region
- * forward through contiguous table newlines and backward to the op just
- * after the previous non-table `\n`-op (or the start of the array).
+ * forward through contiguous table newlines (stopping at adjacent-grid
+ * boundaries) and backward to the op just after the previous non-table
+ * `\n`-op or adjacent-grid boundary (or the start of the array).
  *
  * @param ops - The full ops array (e.g. `delta.ops`).
  * @param hintOpIdx - Any op index known or guessed to be within a table.
@@ -2028,4 +2060,4 @@ declare function isTableNewlineOp(op: Op | undefined): boolean;
  */
 declare function extractTableRegion(ops: readonly Op[], hintOpIdx: number): TableRegion | null;
 
-export { ALERT_TYPES, type AlertBlockData, type AlertType, type AlignType, BOX_FLOAT_VALUES, BOX_OVERFLOW_VALUES, type BlockContext, type BlockHandler, BlockHandlerRegistry, type BlockRenderOptions, type BoxBlockData, type BoxFloat, type BoxOpAttributes, type BoxOverflow, BrowserDOMAdapter, type CellAlign, type CellData, type ColumnsBlockData, type DOMAdapter, type DOMDocument, type DOMDocumentFragment, type DOMElement, type DOMNode, type DOMNodeList, type DeltaToHtmlOptions, type DeltaToMarkdownOptions, type DocumentPresentation, type 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 TableCellAlign, type TableColAlignType, type TablePresentation, type TableRegion, alertBlockHandler, alignFormat, backgroundFormat, blockFormat, blockLineHeightStyleParts, blockMarginAfterStyleParts, blockMarginBeforeStyleParts, blockParagraphMarginStyleParts, blockPresentationStyleParts, blockquoteFormat, boldFormat, boxBlockHandler, browserAdapter, cloneDelta, codeBlockFormat, codeFormat, codeWidgetFormat, colorFormat, columnsBlockHandler, createDefaultBlockHandlers, createDefaultRegistry, defaultBlockFormats, defaultEmbedFormats, defaultFormats, defaultInlineFormats, deltaToHtml, deltaToMarkdown, dividerFormat, documentPresentationStyleParts, escapeHtml, extractBoxOpAttributes, extractTableRegion, fontFormat, footnoteRefFormat, footnotesBlockHandler, formulaFormat, getAdapter, getNamedColors, headerFormat, headerIdFormat, htmlToDelta, imageFormat, indentFormat, isAdapterAvailable, isElement, isRemarkAvailable, isTableNewlineOp, isTextNode, isValidColor, isValidHexColor, isZebraBodyRow, italicFormat, kbdFormat, linkFormat, listFormat, markFormat, markdownToDelta, markdownToDeltaSync, nodeAdapter, normalizeDelta, parseScriderLineHeightMultiplier, parseScriderMarginAfterEm, parseScriderMarginBeforeEm, parseScriderMarginEm, preloadRemark, resolveDocumentPresentation, resolveTablePresentation, sanitizeDelta, sizeFormat, slugify, slugifyWithDedup, softBreakFormat, strikeFormat, subscriptFormat, superscriptFormat, tableBlockHandler, 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 TableBlockData, 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 };