reamkit 1.0.2 → 1.2.0

package/README.md

@@ -33,6 +33,7 @@ const bytes = new Uint8Array(await file.arrayBuffer());
 const doc = Ream.parse(bytes);            // docx or xlsx — sniffed
 const pdf = await doc.convert('pdf');     // async — fetches a font if needed
 const svg = await doc.convert('svg');     // same parse, different target
+const html = await doc.convert('html');   // flowed HTML — needs no fonts at all
 
 // Hand the bytes to the browser: preview, download, upload, …
 const url = URL.createObjectURL(new Blob([pdf], { type: 'application/pdf' }));
@@ -84,7 +85,9 @@ are always used first — glyph-exact, no substitution.
 ### Archival PDF/A + embedded source
 
 The whole PDF/A family is supported (1a/1b, 2a/2b/2u, 3a/3b/3u —
-veraPDF-validated). PDF/A-3 can carry the source document inside the PDF:
+veraPDF-validated), plus accessible **PDF/UA-1** (`pdfUA: true`, also
+veraPDF-validated and combinable with PDF/A in one file). PDF/A-3 can carry
+the source document inside the PDF:
 
 ```ts
 const { bytes: pdfa, losses } = await doc.convertWithReport('pdf', {
@@ -147,7 +150,7 @@ automatically from the document's `docProps/core.xml`), `attachments`
 
 ### Lower-level APIs
 
-- `docxReader` / `xlsxReader`, `svgWriter` — the `@experimental` reader/writer
+- `docxReader` / `xlsxReader`, `svgWriter`, `htmlWriter` — the `@experimental` reader/writer
   interfaces of the interlayer, for building custom pipelines (and keeping
   unused formats out of your bundle); `layoutStyledDocument` produces the
   frozen page model (`PageItem` pages in a top-left `Pt` frame) they consume.
@@ -156,14 +159,17 @@ automatically from the document's `docProps/core.xml`), `attachments`
 
 ## Scope
 
-Implemented: WordprocessingML text/styles/tables/lists/multi-section
-layout/headers-footers/images/tracked changes, SpreadsheetML grids,
+Implemented: WordprocessingML text/styles/tables (incl. table styles)/lists/
+multi-section and multi-column layout/headers-footers (incl. PAGE/NUMPAGES
+fields)/footnotes and endnotes/hyperlinks and bookmarks/floating drawings/
+images/tracked changes, SpreadsheetML grids,
 number formats and the print model (gridlines, print area, fit-to-page,
 repeated titles, page breaks), DrawingML shapes and charts, OMML math,
 Type0+CIDFontType2 embedding with subsetting, Knuth-Plass line breaking,
 Liang hyphenation, OpenType ligatures/kerning + Arabic cursive joining,
-BiDi (UAX #9), tagged PDF, PDF/A-1/2/3 (a/b/u), digital signatures
-(PKCS#7/ECDSA/PAdES/RFC 3161), SVG page preview.
+BiDi (UAX #9), hyperlinks (PDF link annotations + HTML anchors,
+scheme-allowlisted), tagged PDF, PDF/A-1/2/3 (a/b/u), digital signatures
+(PKCS#7/ECDSA/PAdES/RFC 3161), SVG page preview, flowed HTML export.
 
 See `handoff.md` for the full feature matrix and known limitations.
 

package/dist/esm/{layout → core}/arc-to-bezier.d.ts

@@ -1,4 +1,4 @@
-import { PathSegment } from '../core/vector.js';
+import { PathSegment } from './vector.js';
 export declare function arcPoint(cx: number, cy: number, rx: number, ry: number, angleRad: number): readonly [number, number];
 export declare function arcToBeziers(cx: number, cy: number, rx: number, ry: number, startAngleRad: number, sweepAngleRad: number): Array<PathSegment>;
 export declare function ellipseSegments(w: number, h: number): ReadonlyArray<PathSegment>;

package/dist/esm/{layout → core}/arc-to-bezier.js

@@ -1,5 +1,5 @@
-import { PathBuilder } from "../core/vector.js";
-//#region src/layout/arc-to-bezier.ts
+import { PathBuilder } from "./vector.js";
+//#region src/core/arc-to-bezier.ts
 function arcPoint(cx, cy, rx, ry, angleRad) {
 	return [cx + rx * Math.cos(angleRad), cy + ry * Math.sin(angleRad)];
 }

package/dist/esm/core/bytes.d.ts

@@ -1 +1,2 @@
+export declare function toBase64(bytes: Uint8Array): string;
 export declare function bytesInclude(haystack: Uint8Array, needle: string): boolean;

package/dist/esm/core/bytes.js

@@ -1,4 +1,9 @@
 //#region src/core/bytes.ts
+function toBase64(bytes) {
+	let bin = "";
+	for (const b of bytes) bin += String.fromCharCode(b);
+	return btoa(bin);
+}
 function bytesInclude(haystack, needle) {
 	const n = new TextEncoder().encode(needle);
 	outer: for (let i = 0; i + n.length <= haystack.length; i++) {
@@ -8,4 +13,4 @@ function bytesInclude(haystack, needle) {
 	return false;
 }
 //#endregion
-export { bytesInclude };
+export { bytesInclude, toBase64 };

package/dist/esm/core/converter/facade.d.ts

@@ -5,8 +5,8 @@ import { FontProvider } from '../fonts/provider.js';
 import { Loss, LossReport } from '../ir/index.js';
 import { FontBytesByVariant } from '../font/index.js';
 export interface ConvertOptions extends ConvertDocxOptions {
-    /** Target format: 'pdf' (default) or 'svg' (page-stack preview). */
-    readonly to?: 'pdf' | 'svg';
+    /** Target: 'pdf' (default), 'svg' (page-stack preview) or 'html' (flowed). */
+    readonly to?: 'pdf' | 'svg' | 'html';
     /**
      * Strict mode (handoff v1 §5): throw ConversionLossError on the first
      * recorded loss instead of returning it in the report.

package/dist/esm/core/converter/facade.js

@@ -6,6 +6,7 @@ import { docxReader } from "../../word/docx-reader.js";
 import { xlsxReader } from "../../excel/xlsx-reader.js";
 import { chainProviders } from "../fonts/provider.js";
 import { flowRenderOptions } from "./project.js";
+import { writeHtml } from "../../html/html-writer.js";
 import { writeSvg } from "../../svg/svg-writer.js";
 import { convertDocxToPdf } from "../../word/docx-to-pdf.js";
 import { convertXlsxToPdf } from "../../excel/xlsx-to-pdf.js";
@@ -19,6 +20,17 @@ function createConverter(opts = {}) {
 		const reader = detect(bytes);
 		if (!reader) throw new Error("Unrecognized input format (no registered reader sniffs these bytes)");
 		const losses = [];
+		if (to === "html") {
+			const { doc: flow, losses: readLosses } = reader.read(bytes);
+			losses.push(...readLosses);
+			const html = writeHtml(flow);
+			losses.push(...html.losses);
+			if (strict && losses.length > 0) throw new ConversionLossError(losses[0]);
+			return {
+				bytes: html.bytes,
+				losses
+			};
+		}
 		let conv = rest;
 		if (fontProviders && fontProviders.length > 0 && !rest.fonts && !rest.fontBytes) {
 			const { fonts, loss } = await resolveFontsViaChain(fontProviders);

package/dist/esm/core/converter/project.js

@@ -7,6 +7,8 @@ function flowRenderOptions(flow) {
 		...flow.sections.length > 0 ? { sections: flow.sections } : {},
 		...flow.section ? { section: flow.section } : {},
 		...flow.headersFooters ? { headersFooters: flow.headersFooters } : {},
+		...flow.footnotes ? { footnotes: flow.footnotes } : {},
+		...flow.endnotes ? { endnotes: flow.endnotes } : {},
 		resources: flow.resources,
 		...flow.charts ? { charts: flow.charts } : {},
 		...flow.embeddedFonts ? { embeddedFonts: flow.embeddedFonts } : {},

package/dist/esm/core/converter/ream.d.ts

@@ -6,7 +6,7 @@ import { Loss } from '../ir/index.js';
 import { DocumentReader } from '../ir/adapters.js';
 import { FlowDoc } from '../ir/flow.js';
 import { SignatureOptions, StyledRenderOptions } from '../../pdf/index.js';
-export type ReamTarget = 'pdf' | 'svg';
+export type ReamTarget = 'pdf' | 'svg' | 'html';
 export interface ReamParseOptions {
     readonly readers?: ReadonlyArray<DocumentReader>;
 }

package/dist/esm/core/converter/ream.js

@@ -6,6 +6,7 @@ import { signPdf } from "../../pdf/signature.js";
 import { renderStyledPdf } from "../../pdf/styled-page-renderer.js";
 import "../../pdf/index.js";
 import { flowRenderOptions } from "./project.js";
+import { writeHtml } from "../../html/html-writer.js";
 import { writeSvg } from "../../svg/svg-writer.js";
 import { resolveDocxAutoFonts } from "../../word/docx-to-pdf.js";
 import { DEFAULT_READERS, resolveFontsViaChain } from "./facade.js";
@@ -36,6 +37,15 @@ var Ream = class Ream {
 	}
 	async convertWithReport(to, options = {}) {
 		const losses = [...this.losses];
+		if (to === "html") {
+			const html = writeHtml(this.flow);
+			losses.push(...html.losses);
+			this.enforceStrict(options, losses);
+			return {
+				bytes: html.bytes,
+				losses
+			};
+		}
 		const { fonts, registriesByFamily } = await this.resolveFonts(options, losses);
 		const registry = FontRegistry.fromBytes(fonts);
 		if (to === "svg") {

package/dist/esm/core/document-model/index.d.ts

@@ -1 +1 @@
-export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, Chart, ChartBlock, ChartDataPoint, ChartSeries, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, Run, RunProperties, RowProperties, Section, SectionProperties, ShapeBlock, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeLine, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableProperties, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';
+export type { AbstractNumbering, Alignment, Border, BorderStyle, BodyElement, CellBorders, CellMerge, DocumentInfo, CellMargins, CellProperties, CellShading, Chart, ChartBlock, ChartDataPoint, ChartSeries, ChartType, CustomGeometry, CustomPathCmd, DocumentModel, FontFamilyMap, HeaderFooterReference, HeaderFooterType, ImageBlock, InlineImage, MathAccent, MathBar, MathDelimiter, MathEqArray, MathFraction, MathFunc, MathGroupChr, MathLimit, MathMatrix, MathNary, MathNode, MathRadical, MathRow, MathRun, MathScript, Numbering, NumberingFormat, NumberingInstance, NumberingLevel, NumberingReference, PageMargins, PageSize, Paragraph, ParagraphProperties, Run, RunProperties, RowProperties, Section, FloatAnchor, SectionColumns, SectionProperties, ShapeBlock, ShapeDash, ShapeFill, ShapeFillKind, ShapeGeometry, ShapeLine, ShapeTextBody, ShapeTransform, Style, StyleSheet, StyleType, Table, TableCell, TableLook, TableProperties, TableStyleCondition, TableStyleConditionType, TableStyleLayer, TableRow, UnderlineStyle, VerticalAlign, } from './types.js';

package/dist/esm/core/document-model/types.d.ts

@@ -126,6 +126,12 @@ export interface Run {
     readonly native?: NativeBag;
     readonly text: string;
     readonly properties: RunProperties;
+    readonly href?: string;
+    readonly field?: 'PAGE' | 'NUMPAGES';
+    readonly anchor?: string;
+    readonly footnoteRef?: string;
+    readonly endnoteRef?: string;
+    readonly noteNumber?: true;
     readonly inlineImage?: InlineImage;
     readonly math?: MathNode;
     readonly pageBreak?: boolean;
@@ -134,6 +140,7 @@ export interface Paragraph {
     readonly native?: NativeBag;
     readonly properties: ParagraphProperties;
     readonly runs: ReadonlyArray<Run>;
+    readonly bookmarks?: ReadonlyArray<string>;
 }
 export type NumberingFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'bullet' | 'none';
 export interface NumberingReference {
@@ -161,6 +168,18 @@ export interface Numbering {
     readonly numInstances: ReadonlyMap<string, NumberingInstance>;
 }
 export type StyleType = 'paragraph' | 'character' | 'table' | 'numbering';
+export interface TableStyleLayer {
+    readonly borders?: CellBorders;
+    readonly cellMargins?: CellMargins;
+    readonly shading?: CellShading;
+    readonly runProperties?: RunProperties;
+    readonly paragraphProperties?: ParagraphProperties;
+}
+export type TableStyleConditionType = 'wholeTable' | 'band1Vert' | 'band2Vert' | 'band1Horz' | 'band2Horz' | 'firstCol' | 'lastCol' | 'firstRow' | 'lastRow' | 'nwCell' | 'neCell' | 'swCell' | 'seCell';
+export interface TableStyleCondition {
+    readonly type: TableStyleConditionType;
+    readonly layer: TableStyleLayer;
+}
 export interface Style {
     readonly id: string;
     readonly type: StyleType;
@@ -168,6 +187,10 @@ export interface Style {
     readonly isDefault: boolean;
     readonly runProperties: RunProperties;
     readonly paragraphProperties: ParagraphProperties;
+    readonly tableLayer?: TableStyleLayer;
+    readonly tableConditions?: ReadonlyArray<TableStyleCondition>;
+    readonly rowBandSize?: number;
+    readonly colBandSize?: number;
 }
 export interface StyleSheet {
     readonly defaultRunProperties: RunProperties;
@@ -213,7 +236,17 @@ export interface RowProperties {
     readonly isHeader?: boolean;
     readonly pageBreakBefore?: boolean;
 }
+export interface TableLook {
+    readonly firstRow?: boolean;
+    readonly lastRow?: boolean;
+    readonly firstColumn?: boolean;
+    readonly lastColumn?: boolean;
+    readonly noHBand?: boolean;
+    readonly noVBand?: boolean;
+}
 export interface TableProperties {
+    readonly styleId?: string;
+    readonly look?: TableLook;
     readonly widthPt?: Pt;
     readonly widthFraction?: number;
     readonly widthType?: 'auto' | 'dxa' | 'pct' | 'nil';
@@ -237,6 +270,7 @@ export interface Table {
     readonly rows: ReadonlyArray<TableRow>;
 }
 export interface ImageBlock {
+    readonly float?: FloatAnchor;
     readonly resource?: ResourceId;
     readonly width: Pt;
     readonly height: Pt;
@@ -312,6 +346,7 @@ export interface ShapeTextBody {
     readonly anchor?: 't' | 'ctr' | 'b';
 }
 export interface ShapeBlock {
+    readonly float?: FloatAnchor;
     readonly width: Pt;
     readonly height: Pt;
     readonly geometry: ShapeGeometry;
@@ -349,6 +384,7 @@ export interface Chart {
     readonly valAxisTitle?: string;
 }
 export interface ChartBlock {
+    readonly float?: FloatAnchor;
     readonly chartRelId: string;
     readonly width: Pt;
     readonly height: Pt;
@@ -396,6 +432,28 @@ export interface SectionProperties {
     readonly footers: ReadonlyArray<HeaderFooterReference>;
     readonly titlePg?: boolean;
     readonly evenAndOddHeaders?: boolean;
+    readonly columns?: SectionColumns;
+}
+export interface FloatAnchor {
+    readonly wrap: 'none' | 'square' | 'tight' | 'through' | 'topAndBottom';
+    readonly behind?: boolean;
+    readonly posH?: {
+        readonly relativeFrom: 'margin' | 'page' | 'column';
+        readonly offsetPt?: Pt;
+        readonly align?: 'left' | 'center' | 'right';
+    };
+    readonly posV?: {
+        readonly relativeFrom: 'margin' | 'page' | 'paragraph' | 'line';
+        readonly offsetPt?: Pt;
+    };
+}
+export interface SectionColumns {
+    readonly count: number;
+    readonly spacePt: number;
+    readonly explicit?: ReadonlyArray<{
+        readonly widthPt: number;
+        readonly spacePt: number;
+    }>;
 }
 export interface Section {
     readonly properties: SectionProperties;

package/dist/esm/{layout → core/drawingml}/chart-geometry.d.ts

@@ -1,4 +1,4 @@
-import { Chart, ChartSeries } from '../core/document-model/index.js';
+import { Chart, ChartSeries } from '../document-model/index.js';
 export interface ChartRect {
     readonly x: number;
     readonly y: number;

package/dist/esm/{layout → core/drawingml}/preset-geometry.d.ts

@@ -1,5 +1,5 @@
-import { CustomGeometry } from '../core/document-model/index.js';
-import { PathSegment, VectorPath } from '../core/vector.js';
+import { CustomGeometry } from '../document-model/index.js';
+import { PathSegment, VectorPath } from '../vector.js';
 export declare function rectSegments(w: number, h: number): ReadonlyArray<PathSegment>;
 export declare function rectPath(w: number, h: number): VectorPath;
 export declare function presetPaths(preset: string, w: number, h: number, adjust: ReadonlyMap<string, number>): Array<VectorPath> | null;

package/dist/esm/{layout → core/drawingml}/preset-geometry.js

@@ -1,6 +1,6 @@
-import { PathBuilder } from "../core/vector.js";
-import { arcToBeziers, ellipseSegments, roundRectSegments } from "./arc-to-bezier.js";
-//#region src/layout/preset-geometry.ts
+import { PathBuilder } from "../vector.js";
+import { arcToBeziers, ellipseSegments, roundRectSegments } from "../arc-to-bezier.js";
+//#region src/core/drawingml/preset-geometry.ts
 function rectSegments(w, h) {
 	return new PathBuilder().moveTo(0, 0).lineTo(w, 0).lineTo(w, h).lineTo(0, h).close().build().segments;
 }

package/dist/esm/core/drawingml/shape-render.d.ts

@@ -0,0 +1,8 @@
+import { ShapeGeometry, ShapeLine } from '../document-model/index.js';
+import { StrokeStyle, VectorPath } from '../vector.js';
+export declare const EMU_PER_PT = 12700;
+export declare const DEFAULT_INSET_LR_PT: number;
+export declare const DEFAULT_INSET_TB_PT: number;
+export declare function buildShapePaths(geometry: ShapeGeometry, widthPt: number, heightPt: number): Array<VectorPath>;
+export declare function buildStroke(line: ShapeLine | undefined): StrokeStyle | undefined;
+export declare function buildShapeTransform(pageX: number, pageY: number, widthPt: number, heightPt: number, rotation60k: number, flipH: boolean, flipV: boolean): [number, number, number, number, number, number];

package/dist/esm/core/drawingml/shape-render.js

@@ -0,0 +1,71 @@
+import { customPaths, presetPaths, rectPath } from "./preset-geometry.js";
+//#region src/core/drawingml/shape-render.ts
+var EMU_PER_PT = 12700;
+var DEFAULT_LINE_WIDTH_EMU = 9525;
+var DEFAULT_INSET_LR_PT = 91440 / EMU_PER_PT;
+var DEFAULT_INSET_TB_PT = 45720 / EMU_PER_PT;
+function buildShapePaths(geometry, widthPt, heightPt) {
+	if (geometry.kind === "preset") return presetPaths(geometry.preset ?? "rect", widthPt, heightPt, geometry.adjust ?? /* @__PURE__ */ new Map()) ?? [rectPath(widthPt, heightPt)];
+	if (geometry.custom) return customPaths(geometry.custom, widthPt, heightPt);
+	return [rectPath(widthPt, heightPt)];
+}
+function buildStroke(line) {
+	if (!line || line.fill === "none") return void 0;
+	const widthPt = line.width ?? DEFAULT_LINE_WIDTH_EMU / 12700;
+	const dash = line.dash && line.dash !== "solid" ? dashPattern(line.dash, widthPt) : void 0;
+	const cap = line.cap === "flat" ? "butt" : line.cap;
+	return {
+		colorHex: line.colorHex ?? "000000",
+		widthPt,
+		...dash ? { dash } : {},
+		...cap ? { cap } : {}
+	};
+}
+function dashPattern(dash, w) {
+	const u = Math.max(w, .1);
+	switch (dash) {
+		case "solid": return;
+		case "dot": return [u, 2 * u];
+		case "dash": return [4 * u, 3 * u];
+		case "dashDot": return [
+			4 * u,
+			3 * u,
+			u,
+			3 * u
+		];
+		case "lgDash": return [8 * u, 3 * u];
+		case "lgDashDot": return [
+			8 * u,
+			3 * u,
+			u,
+			3 * u
+		];
+		case "sysDash": return [3 * u, u];
+		case "sysDot": return [u, u];
+	}
+}
+function buildShapeTransform(pageX, pageY, widthPt, heightPt, rotation60k, flipH, flipV) {
+	const theta = -rotation60k / 6e4 * (Math.PI / 180);
+	const sx = flipH ? -1 : 1;
+	const sy = flipV ? -1 : 1;
+	const cos = Math.cos(theta);
+	const sin = Math.sin(theta);
+	const a = sx * cos;
+	const b = sx * sin;
+	const c = -sy * sin;
+	const d = sy * cos;
+	const cxL = widthPt / 2;
+	const cyL = heightPt / 2;
+	const centerX = pageX + cxL;
+	const centerY = pageY + cyL;
+	return [
+		a,
+		b,
+		c,
+		d,
+		centerX - (a * cxL + c * cyL),
+		centerY - (b * cxL + d * cyL)
+	];
+}
+//#endregion
+export { DEFAULT_INSET_LR_PT, DEFAULT_INSET_TB_PT, buildShapePaths, buildShapeTransform, buildStroke };

package/dist/esm/core/ir/features.d.ts

@@ -8,6 +8,7 @@ export declare const FEATURES: {
     readonly headersFooters: "headersFooters";
     readonly images: "images";
     readonly imagesJp2: "images.jp2";
+    readonly hyperlinks: "hyperlinks";
     readonly shapes: "shapes";
     readonly charts: "charts";
     readonly math: "math";

package/dist/esm/core/ir/features.js

@@ -8,6 +8,7 @@ var FEATURES = {
 	headersFooters: "headersFooters",
 	images: "images",
 	imagesJp2: "images.jp2",
+	hyperlinks: "hyperlinks",
 	shapes: "shapes",
 	charts: "charts",
 	math: "math",

package/dist/esm/core/ir/flow.d.ts

@@ -11,6 +11,9 @@ export interface FlowDoc {
     readonly styles: StyleSheet;
     readonly numbering?: Numbering;
     readonly headersFooters?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
+    /** §17.11 footnotes/endnotes content by id (separator stubs excluded). */
+    readonly footnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
+    readonly endnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
     /** Parsed charts keyed by relationship id (ChartBlock.chartRelId). */
     readonly charts?: ReadonlyMap<string, Chart>;
     /** Content-addressed binary resources (images). */

package/dist/esm/core/links.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the trimmed URL when its scheme is on the allowlist, undefined
+ * otherwise (including scheme-less/relative targets — those are not external
+ * links for a converted document).
+ */
+export declare function sanitizeHref(href: string): string | undefined;

package/dist/esm/core/links.js

@@ -0,0 +1,19 @@
+//#region src/core/links.ts
+var ALLOWED_SCHEMES = new Set([
+	"http",
+	"https",
+	"mailto"
+]);
+/**
+* Returns the trimmed URL when its scheme is on the allowlist, undefined
+* otherwise (including scheme-less/relative targets — those are not external
+* links for a converted document).
+*/
+function sanitizeHref(href) {
+	const url = href.trim();
+	const m = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(url);
+	if (!m) return void 0;
+	return ALLOWED_SCHEMES.has(m[1].toLowerCase()) ? url : void 0;
+}
+//#endregion
+export { sanitizeHref };

package/dist/esm/core/numbering/apply.js

@@ -14,8 +14,10 @@ function applyNumbering(body, numbering) {
 			text: `${marker}\t`,
 			properties: level?.runProperties ?? {}
 		};
+		const newProps = mergeIndentFromLevel(p.properties, level?.paragraphProperties);
 		return {
-			properties: mergeIndentFromLevel(p.properties, level?.paragraphProperties),
+			...p,
+			properties: newProps,
 			runs: [markerRun, ...p.runs]
 		};
 	};

package/dist/esm/core/style-cascade/index.d.ts

@@ -1,3 +1,4 @@
 export { EMPTY_STYLE_SHEET, resolveBodyStyles, resolveHeadersFootersStyles, resolveParagraphProperties, resolveRunProperties, } from './resolver.js';
 export type { ResolvedRunProperties, ResolvedParagraphProperties, } from './types.js';
 export { DEFAULT_RESOLVED_RUN, DEFAULT_RESOLVED_PARAGRAPH } from './types.js';
+export { resolveTableStyles } from './table.js';

package/dist/esm/core/style-cascade/index.js

@@ -1,2 +1,3 @@
 import "./types.js";
 import "./resolver.js";
+import "./table.js";

package/dist/esm/core/style-cascade/table.d.ts

@@ -0,0 +1,2 @@
+import { BodyElement, StyleSheet } from '../document-model/index.js';
+export declare function resolveTableStyles(body: ReadonlyArray<BodyElement>, sheet: StyleSheet): ReadonlyArray<BodyElement>;

package/dist/esm/core/style-cascade/table.js

@@ -0,0 +1,161 @@
+//#region src/core/style-cascade/table.ts
+function resolveTableStyles(body, sheet) {
+	const visit = (el) => {
+		if (el.kind === "table") {
+			applyTableStyle(el.table, sheet);
+			for (const row of el.table.rows) for (const cell of row.cells) for (const child of cell.content) visit(child);
+		} else if (el.kind === "shape" && el.shape.text) for (const child of el.shape.text.content) visit(child);
+	};
+	for (const el of body) visit(el);
+	return body;
+}
+function applyTableStyle(table, sheet) {
+	const styleId = table.properties.styleId;
+	if (!styleId) return;
+	const folded = foldTableStyleChain(styleId, sheet);
+	if (!folded) return;
+	const tp = table.properties;
+	if (!tp.borders && folded.base.borders) tp.borders = folded.base.borders;
+	if (!tp.defaultCellMargins && folded.base.cellMargins) tp.defaultCellMargins = folded.base.cellMargins;
+	const look = table.properties.look ?? {};
+	const rows = table.rows;
+	const colCount = Math.max(table.grid.length, ...rows.map((r) => r.cells.reduce((s, c) => s + (c.properties.colSpan ?? 1), 0)));
+	for (let r = 0; r < rows.length; r++) {
+		const row = rows[r];
+		let colStart = 0;
+		for (const cell of row.cells) {
+			const span = cell.properties.colSpan ?? 1;
+			const layer = cellLayer(folded, look, {
+				firstRow: r === 0,
+				lastRow: r === rows.length - 1,
+				firstCol: colStart === 0,
+				lastCol: colStart + span >= colCount,
+				rowBand: bandIndex(r, look.firstRow === true, folded.rowBandSize),
+				colBand: bandIndex(colStart, look.firstColumn === true, folded.colBandSize),
+				noHBand: look.noHBand === true,
+				noVBand: look.noVBand === true
+			});
+			colStart += span;
+			if (!layer) continue;
+			applyLayerToCell(cell, layer);
+		}
+	}
+}
+function applyLayerToCell(tableCell, layer) {
+	const cell = tableCell;
+	if (layer.shading && !cell.properties.shading) cell.properties.shading = layer.shading;
+	if (layer.cellMargins && !cell.properties.margins) cell.properties.margins = layer.cellMargins;
+	if (layer.borders) {
+		const own = cell.properties.borders ?? {};
+		const merged = {
+			...layer.borders,
+			...definedOnly(own)
+		};
+		cell.properties.borders = merged;
+	}
+	if (layer.runProperties || layer.paragraphProperties) for (const el of cell.content) {
+		if (el.kind !== "paragraph") continue;
+		const p = el.paragraph;
+		if (layer.paragraphProperties) p.properties = {
+			...layer.paragraphProperties,
+			...definedOnly(p.properties)
+		};
+		if (layer.runProperties) for (const run of p.runs) run.properties = {
+			...layer.runProperties,
+			...definedOnly(run.properties)
+		};
+	}
+}
+function bandIndex(index, skipFirst, bandSize) {
+	const adjusted = index - (skipFirst ? 1 : 0);
+	if (adjusted < 0) return -1;
+	return Math.floor(adjusted / Math.max(1, bandSize));
+}
+function cellLayer(folded, look, pos) {
+	const layers = [folded.base];
+	const cond = (t) => folded.conditions.get(t);
+	if (!pos.noVBand && pos.colBand >= 0) layers.push(pos.colBand % 2 === 0 ? cond("band1Vert") : cond("band2Vert"));
+	if (!pos.noHBand && pos.rowBand >= 0) layers.push(pos.rowBand % 2 === 0 ? cond("band1Horz") : cond("band2Horz"));
+	if (look.firstColumn && pos.firstCol) layers.push(cond("firstCol"));
+	if (look.lastColumn && pos.lastCol) layers.push(cond("lastCol"));
+	if (look.firstRow && pos.firstRow) layers.push(cond("firstRow"));
+	if (look.lastRow && pos.lastRow) layers.push(cond("lastRow"));
+	if (look.firstRow && look.firstColumn && pos.firstRow && pos.firstCol) layers.push(cond("nwCell"));
+	if (look.firstRow && look.lastColumn && pos.firstRow && pos.lastCol) layers.push(cond("neCell"));
+	if (look.lastRow && look.firstColumn && pos.lastRow && pos.firstCol) layers.push(cond("swCell"));
+	if (look.lastRow && look.lastColumn && pos.lastRow && pos.lastCol) layers.push(cond("seCell"));
+	let out;
+	for (const layer of layers) {
+		if (!layer) continue;
+		out = out ? mergeLayer(out, layer) : layer;
+	}
+	return out;
+}
+function foldTableStyleChain(styleId, sheet) {
+	const chain = [];
+	const visited = /* @__PURE__ */ new Set();
+	let cursor = styleId;
+	while (cursor && !visited.has(cursor)) {
+		visited.add(cursor);
+		const style = sheet.styles.get(cursor);
+		if (!style || style.type !== "table") break;
+		chain.unshift(style);
+		cursor = style.basedOn;
+	}
+	if (chain.length === 0) return void 0;
+	let base = {};
+	const conditions = /* @__PURE__ */ new Map();
+	let rowBandSize = 1;
+	let colBandSize = 1;
+	for (const style of chain) {
+		const own = {
+			...style.tableLayer ?? {},
+			...Object.keys(style.runProperties).length > 0 && !style.tableLayer?.runProperties ? { runProperties: style.runProperties } : {},
+			...Object.keys(style.paragraphProperties).length > 0 && !style.tableLayer?.paragraphProperties ? { paragraphProperties: style.paragraphProperties } : {}
+		};
+		base = mergeLayer(base, own);
+		for (const c of style.tableConditions ?? []) {
+			const prev = conditions.get(c.type);
+			conditions.set(c.type, prev ? mergeLayer(prev, c.layer) : c.layer);
+		}
+		if (style.rowBandSize !== void 0) rowBandSize = style.rowBandSize;
+		if (style.colBandSize !== void 0) colBandSize = style.colBandSize;
+	}
+	return {
+		base,
+		conditions,
+		rowBandSize,
+		colBandSize
+	};
+}
+function mergeLayer(base, override) {
+	return {
+		...override.borders ?? base.borders ? { borders: {
+			...base.borders,
+			...definedOnly(override.borders ?? {})
+		} } : {},
+		...override.cellMargins ?? base.cellMargins ? { cellMargins: {
+			...base.cellMargins,
+			...definedOnly(override.cellMargins ?? {})
+		} } : {},
+		...override.shading ?? base.shading ? { shading: override.shading ?? base.shading } : {},
+		...override.runProperties ?? base.runProperties ? { runProperties: {
+			...base.runProperties,
+			...definedOnly(override.runProperties ?? {})
+		} } : {},
+		...override.paragraphProperties ?? base.paragraphProperties ? { paragraphProperties: {
+			...base.paragraphProperties,
+			...definedOnly(override.paragraphProperties ?? {})
+		} } : {}
+	};
+}
+function definedOnly(obj) {
+	const out = {};
+	for (const key of Object.keys(obj)) {
+		const v = obj[key];
+		if (v !== void 0) out[key] = v;
+	}
+	return out;
+}
+//#endregion
+export { resolveTableStyles };