js.documents 14.0.3 → 14.1.0

package/dist/diagnostics-9twvwLNY.d.cts

@@ -0,0 +1,17 @@
+//#region src/edit/pptx/diagnostics.d.ts
+type PptxWriteDiagnosticSeverity = "info" | "warning";
+declare const PptxWriteDiagnosticCodes: {
+  readonly TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped";
+};
+type PptxWriteDiagnosticCode = (typeof PptxWriteDiagnosticCodes)[keyof typeof PptxWriteDiagnosticCodes];
+interface PptxWriteDiagnostic {
+  readonly code: PptxWriteDiagnosticCode;
+  readonly severity: PptxWriteDiagnosticSeverity;
+  readonly message: string;
+}
+type PptxWriteDiagnosticSink = (diagnostic: PptxWriteDiagnostic, context: {
+  readonly sourcePath?: string;
+}) => void;
+declare const NOOP_PPTX_WRITE_DIAGNOSTIC_SINK: PptxWriteDiagnosticSink;
+//#endregion
+export { PptxWriteDiagnosticSeverity as a, PptxWriteDiagnosticCodes as i, PptxWriteDiagnostic as n, PptxWriteDiagnosticSink as o, PptxWriteDiagnosticCode as r, NOOP_PPTX_WRITE_DIAGNOSTIC_SINK as t };

package/dist/diagnostics-9twvwLNY.d.ts

@@ -0,0 +1,17 @@
+//#region src/edit/pptx/diagnostics.d.ts
+type PptxWriteDiagnosticSeverity = "info" | "warning";
+declare const PptxWriteDiagnosticCodes: {
+  readonly TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped";
+};
+type PptxWriteDiagnosticCode = (typeof PptxWriteDiagnosticCodes)[keyof typeof PptxWriteDiagnosticCodes];
+interface PptxWriteDiagnostic {
+  readonly code: PptxWriteDiagnosticCode;
+  readonly severity: PptxWriteDiagnosticSeverity;
+  readonly message: string;
+}
+type PptxWriteDiagnosticSink = (diagnostic: PptxWriteDiagnostic, context: {
+  readonly sourcePath?: string;
+}) => void;
+declare const NOOP_PPTX_WRITE_DIAGNOSTIC_SINK: PptxWriteDiagnosticSink;
+//#endregion
+export { PptxWriteDiagnosticSeverity as a, PptxWriteDiagnosticCodes as i, PptxWriteDiagnostic as n, PptxWriteDiagnosticSink as o, PptxWriteDiagnosticCode as r, NOOP_PPTX_WRITE_DIAGNOSTIC_SINK as t };

package/dist/edit/pptx/content.cjs

@@ -6,6 +6,7 @@ const require_model_embedded_drawing = require("../../model/embedded-drawing.cjs
 const require_model_formula = require("../../model/formula.cjs");
 const require_edit_pptx_scaffold = require("./scaffold.cjs");
 const require_edit_pptx_editor = require("./editor.cjs");
+const require_edit_pptx_diagnostics = require("./diagnostics.cjs");
 let ooxml_js = require("ooxml.js");
 let document_schema_js = require("document-schema.js");
 //#region src/edit/pptx/content.ts
@@ -65,7 +66,7 @@ function appendShape(slide, shape, options) {
 				columns: (0, document_schema_js.tableGridColumnCount)(onlyBlock),
 				columnWidthsPt: onlyBlock.columnWidthsPt
 			}
-		}), onlyBlock, (url) => slide.registerHyperlink(url));
+		}), onlyBlock, options?.onDiagnostic ?? require_edit_pptx_diagnostics.NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, (url) => slide.registerHyperlink(url));
 		return;
 	}
 	const paragraphs = [];
@@ -114,9 +115,14 @@ function populateCellParagraphs(cell, blocks, resolveHyperlinkRId) {
 	}
 	cell.setParagraphs(paragraphs);
 }
-function populatePptxTable(table, block, resolveHyperlinkRId) {
+function populatePptxTable(table, block, onDiagnostic, resolveHyperlinkRId) {
 	require_edit_table_grid.assertTableObeysGridRule(block, "buildPptxPackage");
 	(0, document_schema_js.walkTableGrid)(block).forEach((positions, rowIndex) => {
+		if (block.rows[rowIndex]?.isHeader === true) onDiagnostic({
+			code: require_edit_pptx_diagnostics.PptxWriteDiagnosticCodes.TABLE_HEADER_ROW_DROPPED,
+			severity: "warning",
+			message: `buildPptxPackage: table row ${String(rowIndex)} is a header row, and that is dropped; DrawingML has no per-row header marker, so the row is written exactly as any other`
+		}, { sourcePath: block.sourcePath });
 		positions.forEach((position) => {
 			const { cell, columnIndex } = position;
 			const tableCell = table.cell(rowIndex, columnIndex);

package/dist/edit/pptx/content.d.cts

@@ -1,11 +1,13 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.cjs";
 import { t as OmmlDiagnosticSink } from "../../formula-BH1FBblm.cjs";
+import { o as PptxWriteDiagnosticSink } from "../../diagnostics-9twvwLNY.cjs";
 import { ContentDocument } from "document-schema.js";
 import { EmbeddedPresentationSerialiser, Package } from "ooxml.js";
 //#region src/edit/pptx/content.d.ts
 interface BuildPptxPackageOptions {
   readonly clock?: ClockPort;
   readonly onMathDiagnostic?: OmmlDiagnosticSink;
+  readonly onDiagnostic?: PptxWriteDiagnosticSink;
 }
 declare function buildPptxPackage(content: ContentDocument, options?: BuildPptxPackageOptions): Package;
 declare const embeddedPresentationSerialiser: EmbeddedPresentationSerialiser;

package/dist/edit/pptx/content.d.ts

@@ -1,11 +1,13 @@
 import { t as ClockPort } from "../../clock-C7SUuYN0.js";
 import { t as OmmlDiagnosticSink } from "../../formula-DF4R1QEJ.js";
+import { o as PptxWriteDiagnosticSink } from "../../diagnostics-9twvwLNY.js";
 import { EmbeddedPresentationSerialiser, Package } from "ooxml.js";
 import { ContentDocument } from "document-schema.js";
 //#region src/edit/pptx/content.d.ts
 interface BuildPptxPackageOptions {
   readonly clock?: ClockPort;
   readonly onMathDiagnostic?: OmmlDiagnosticSink;
+  readonly onDiagnostic?: PptxWriteDiagnosticSink;
 }
 declare function buildPptxPackage(content: ContentDocument, options?: BuildPptxPackageOptions): Package;
 declare const embeddedPresentationSerialiser: EmbeddedPresentationSerialiser;

package/dist/edit/pptx/content.js

@@ -5,6 +5,7 @@ import { drawingOfBlock, embeddedDrawingVectors } from "../../model/embedded-dra
 import { formulaOfBlock, formulaPlaceholderText } from "../../model/formula.js";
 import { createEmptyPptxPackage } from "./scaffold.js";
 import { PptxEditor } from "./editor.js";
+import { NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, PptxWriteDiagnosticCodes } from "./diagnostics.js";
 import { base64ToBytes, encodePackage } from "ooxml.js";
 import { resolveCellFillColor, tableCellColumnSpan, tableCellRowSpan, tableGridColumnCount, walkTableGrid } from "document-schema.js";
 //#region src/edit/pptx/content.ts
@@ -64,7 +65,7 @@ function appendShape(slide, shape, options) {
 				columns: tableGridColumnCount(onlyBlock),
 				columnWidthsPt: onlyBlock.columnWidthsPt
 			}
-		}), onlyBlock, (url) => slide.registerHyperlink(url));
+		}), onlyBlock, options?.onDiagnostic ?? NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, (url) => slide.registerHyperlink(url));
 		return;
 	}
 	const paragraphs = [];
@@ -113,9 +114,14 @@ function populateCellParagraphs(cell, blocks, resolveHyperlinkRId) {
 	}
 	cell.setParagraphs(paragraphs);
 }
-function populatePptxTable(table, block, resolveHyperlinkRId) {
+function populatePptxTable(table, block, onDiagnostic, resolveHyperlinkRId) {
 	assertTableObeysGridRule(block, "buildPptxPackage");
 	walkTableGrid(block).forEach((positions, rowIndex) => {
+		if (block.rows[rowIndex]?.isHeader === true) onDiagnostic({
+			code: PptxWriteDiagnosticCodes.TABLE_HEADER_ROW_DROPPED,
+			severity: "warning",
+			message: `buildPptxPackage: table row ${String(rowIndex)} is a header row, and that is dropped; DrawingML has no per-row header marker, so the row is written exactly as any other`
+		}, { sourcePath: block.sourcePath });
 		positions.forEach((position) => {
 			const { cell, columnIndex } = position;
 			const tableCell = table.cell(rowIndex, columnIndex);

package/dist/edit/pptx/diagnostics.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/edit/pptx/diagnostics.ts
+const PptxWriteDiagnosticCodes = { TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped" };
+const NOOP_PPTX_WRITE_DIAGNOSTIC_SINK = () => {};
+//#endregion
+exports.NOOP_PPTX_WRITE_DIAGNOSTIC_SINK = NOOP_PPTX_WRITE_DIAGNOSTIC_SINK;
+exports.PptxWriteDiagnosticCodes = PptxWriteDiagnosticCodes;

package/dist/edit/pptx/diagnostics.d.cts

@@ -0,0 +1,2 @@
+import { a as PptxWriteDiagnosticSeverity, i as PptxWriteDiagnosticCodes, n as PptxWriteDiagnostic, o as PptxWriteDiagnosticSink, r as PptxWriteDiagnosticCode, t as NOOP_PPTX_WRITE_DIAGNOSTIC_SINK } from "../../diagnostics-9twvwLNY.cjs";
+export { NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, PptxWriteDiagnostic, PptxWriteDiagnosticCode, PptxWriteDiagnosticCodes, PptxWriteDiagnosticSeverity, PptxWriteDiagnosticSink };

package/dist/edit/pptx/diagnostics.d.ts

@@ -0,0 +1,2 @@
+import { a as PptxWriteDiagnosticSeverity, i as PptxWriteDiagnosticCodes, n as PptxWriteDiagnostic, o as PptxWriteDiagnosticSink, r as PptxWriteDiagnosticCode, t as NOOP_PPTX_WRITE_DIAGNOSTIC_SINK } from "../../diagnostics-9twvwLNY.js";
+export { NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, PptxWriteDiagnostic, PptxWriteDiagnosticCode, PptxWriteDiagnosticCodes, PptxWriteDiagnosticSeverity, PptxWriteDiagnosticSink };

package/dist/edit/pptx/diagnostics.js

@@ -0,0 +1,5 @@
+//#region src/edit/pptx/diagnostics.ts
+const PptxWriteDiagnosticCodes = { TABLE_HEADER_ROW_DROPPED: "pptx-write/table-header-row-dropped" };
+const NOOP_PPTX_WRITE_DIAGNOSTIC_SINK = () => {};
+//#endregion
+export { NOOP_PPTX_WRITE_DIAGNOSTIC_SINK, PptxWriteDiagnosticCodes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "14.0.3",
+  "version": "14.1.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {