@stll/folio-core 0.47.7 → 0.48.0

package/dist/docx/tableParser.d.ts

@@ -1,6 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { XmlElement } from "./xmlParser.js";
+import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 //#region src/docx/tableParser.d.ts
 /**
@@ -89,7 +90,7 @@ declare function parseConditionalFormatStyle(cnfElement: XmlElement | null): doc
  */
 declare function parseTableCellProperties(tcPrElement: XmlElement | null): document_d_exports.TableCellFormatting | undefined;
 /**
- * Parse a table cell (w:tc)
+ * Parse table cell content, including nested block controls.
  *
  * @param tcElement - The w:tc element
  * @param styles - Style definitions
@@ -97,12 +98,26 @@ declare function parseTableCellProperties(tcPrElement: XmlElement | null): docum
  * @param numbering - Numbering definitions for lists
  * @param rels - Relationships for hyperlinks
  * @param media - Media files for images
- * @returns Parsed table cell
+ * @returns Array of content blocks
  */
-declare function parseTableCell(tcElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: {
+type TableParseOptions = {
   inHeaderFooter?: boolean;
   rootXmlns?: Record<string, string>;
-}): document_d_exports.TableCell;
+  /** The ledger of the package this table belongs to; a table read on its own has none. */
+  previews?: PreviewLedger;
+};
+/**
+ * Parse a table cell (w:tc)
+ *
+ * @param tcElement - The w:tc element
+ * @param styles - Style definitions
+ * @param theme - Theme for color/font resolution
+ * @param numbering - Numbering definitions for lists
+ * @param rels - Relationships for hyperlinks
+ * @param media - Media files for images
+ * @returns Parsed table cell
+ */
+declare function parseTableCell(tcElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: TableParseOptions): document_d_exports.TableCell;
 /**
  * Parse a table row (w:tr)
  *
@@ -114,10 +129,7 @@ declare function parseTableCell(tcElement: XmlElement, styles: StyleMap | null,
  * @param media - Media files for images
  * @returns Parsed table row
  */
-declare function parseTableRow(trElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: {
-  inHeaderFooter?: boolean;
-  rootXmlns?: Record<string, string>;
-}): document_d_exports.TableRow;
+declare function parseTableRow(trElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: TableParseOptions): document_d_exports.TableRow;
 /**
  * Parse table grid (w:tblGrid) for column widths
  *
@@ -136,10 +148,7 @@ declare function parseTableGrid(tblGridElement: XmlElement | null): number[] | u
  * @param media - Media files for images
  * @returns Parsed table
  */
-declare function parseTable(tblElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: {
-  inHeaderFooter?: boolean;
-  rootXmlns?: Record<string, string>;
-}): document_d_exports.Table | undefined;
+declare function parseTable(tblElement: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null, options?: TableParseOptions): document_d_exports.Table | undefined;
 /**
  * Get the number of columns in a table
  *