js.documents 6.4.1 → 6.5.1

package/dist/model/bytes.cjs

@@ -1,6 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let zod = require("zod");
 let odf_js = require("odf.js");
+let doc_codec = require("doc-codec");
+let xls_codec = require("xls-codec");
+let ppt_codec = require("ppt-codec");
+let archive_codec = require("archive-codec");
 //#region src/model/bytes.ts
 const ZIP_LOCAL_FILE_HEADER = [
 	80,
@@ -80,6 +84,18 @@ const OdtBytesSchema = odfBytesSchema("odt", [odf_js.ODF_MEDIA_TYPES.odt, odf_js
 const OdsBytesSchema = odfBytesSchema("ods", [odf_js.ODF_MEDIA_TYPES.ods, odf_js.ODF_MEDIA_TYPES.ots]);
 const OdpBytesSchema = odfBytesSchema("odp", [odf_js.ODF_MEDIA_TYPES.odp, odf_js.ODF_MEDIA_TYPES.otp]);
 const OdgBytesSchema = odfBytesSchema("odg", [odf_js.ODF_MEDIA_TYPES.odg, odf_js.ODF_MEDIA_TYPES.otg]);
+const DocBytesSchema = zod.z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && (0, doc_codec.isDocBytes)(bytes), { message: "not a valid doc file: not an [MS-CFB] compound file holding a 'WordDocument' stream with the [MS-DOC] FIB signature" });
+const XlsBytesSchema = zod.z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && (0, xls_codec.isXlsFile)(bytes), { message: "not a valid xls file: not an [MS-CFB] compound file holding a 'Workbook' stream" });
+function isPptBytes(bytes) {
+	if (!(0, archive_codec.isCompoundFile)(bytes)) return false;
+	try {
+		const streams = (0, archive_codec.readCompoundFile)(bytes);
+		return streams.some((stream) => stream.path === ppt_codec.CURRENT_USER_STREAM) && streams.some((stream) => stream.path === ppt_codec.POWERPOINT_DOCUMENT_STREAM);
+	} catch {
+		return false;
+	}
+}
+const PptBytesSchema = zod.z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && isPptBytes(bytes), { message: "not a valid ppt file: not an [MS-CFB] compound file holding both a 'Current User' and a 'PowerPoint Document' stream" });
 function isWellFormedUtf8Text(bytes) {
 	try {
 		new TextDecoder("utf-8", { fatal: true }).decode(bytes);
@@ -103,6 +119,7 @@ function requireArrayBufferBytes(bytes) {
 }
 //#endregion
 exports.CsvBytesSchema = CsvBytesSchema;
+exports.DocBytesSchema = DocBytesSchema;
 exports.DocxBytesSchema = DocxBytesSchema;
 exports.MarkdownBytesSchema = MarkdownBytesSchema;
 exports.OdgBytesSchema = OdgBytesSchema;
@@ -110,7 +127,9 @@ exports.OdpBytesSchema = OdpBytesSchema;
 exports.OdsBytesSchema = OdsBytesSchema;
 exports.OdtBytesSchema = OdtBytesSchema;
 exports.PdfBytesSchema = PdfBytesSchema;
+exports.PptBytesSchema = PptBytesSchema;
 exports.PptxBytesSchema = PptxBytesSchema;
 exports.SvgBytesSchema = SvgBytesSchema;
+exports.XlsBytesSchema = XlsBytesSchema;
 exports.XlsxBytesSchema = XlsxBytesSchema;
 exports.requireArrayBufferBytes = requireArrayBufferBytes;

package/dist/model/bytes.d.cts

@@ -8,9 +8,12 @@ declare const OdtBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<Ar
 declare const OdsBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const OdpBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const OdgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const DocBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const XlsBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const PptBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const MarkdownBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const CsvBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const SvgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };
+export { CsvBytesSchema, DocBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/dist/model/bytes.d.ts

@@ -8,9 +8,12 @@ declare const OdtBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<Ar
 declare const OdsBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const OdpBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const OdgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const DocBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const XlsBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+declare const PptBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const MarkdownBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const CsvBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare const SvgBytesSchema: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 declare function requireArrayBufferBytes(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };
+export { CsvBytesSchema, DocBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/dist/model/bytes.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
 import { ODF_MEDIA_TYPES } from "odf.js";
+import { isDocBytes } from "doc-codec";
+import { isXlsFile } from "xls-codec";
+import { CURRENT_USER_STREAM, POWERPOINT_DOCUMENT_STREAM } from "ppt-codec";
+import { isCompoundFile, readCompoundFile } from "archive-codec";
 //#region src/model/bytes.ts
 const ZIP_LOCAL_FILE_HEADER = [
 	80,
@@ -79,6 +83,18 @@ const OdtBytesSchema = odfBytesSchema("odt", [ODF_MEDIA_TYPES.odt, ODF_MEDIA_TYP
 const OdsBytesSchema = odfBytesSchema("ods", [ODF_MEDIA_TYPES.ods, ODF_MEDIA_TYPES.ots]);
 const OdpBytesSchema = odfBytesSchema("odp", [ODF_MEDIA_TYPES.odp, ODF_MEDIA_TYPES.otp]);
 const OdgBytesSchema = odfBytesSchema("odg", [ODF_MEDIA_TYPES.odg, ODF_MEDIA_TYPES.otg]);
+const DocBytesSchema = z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && isDocBytes(bytes), { message: "not a valid doc file: not an [MS-CFB] compound file holding a 'WordDocument' stream with the [MS-DOC] FIB signature" });
+const XlsBytesSchema = z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && isXlsFile(bytes), { message: "not a valid xls file: not an [MS-CFB] compound file holding a 'Workbook' stream" });
+function isPptBytes(bytes) {
+	if (!isCompoundFile(bytes)) return false;
+	try {
+		const streams = readCompoundFile(bytes);
+		return streams.some((stream) => stream.path === CURRENT_USER_STREAM) && streams.some((stream) => stream.path === POWERPOINT_DOCUMENT_STREAM);
+	} catch {
+		return false;
+	}
+}
+const PptBytesSchema = z.instanceof(Uint8Array).refine((bytes) => isArrayBufferBacked(bytes) && isPptBytes(bytes), { message: "not a valid ppt file: not an [MS-CFB] compound file holding both a 'Current User' and a 'PowerPoint Document' stream" });
 function isWellFormedUtf8Text(bytes) {
 	try {
 		new TextDecoder("utf-8", { fatal: true }).decode(bytes);
@@ -101,4 +117,4 @@ function requireArrayBufferBytes(bytes) {
 	return bytes;
 }
 //#endregion
-export { CsvBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };
+export { CsvBytesSchema, DocBytesSchema, DocxBytesSchema, MarkdownBytesSchema, OdgBytesSchema, OdpBytesSchema, OdsBytesSchema, OdtBytesSchema, PdfBytesSchema, PptBytesSchema, PptxBytesSchema, SvgBytesSchema, XlsBytesSchema, XlsxBytesSchema, requireArrayBufferBytes };

package/dist/ppt/read.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let ppt_codec = require("ppt-codec");
+//#region src/ppt/read.ts
+function readPptContent(bytes) {
+	const { metadata, slides } = (0, ppt_codec.readPptContent)(bytes);
+	return {
+		kind: "presentation",
+		metadata: { ...metadata },
+		slides: [...slides]
+	};
+}
+//#endregion
+exports.readPptContent = readPptContent;

package/dist/ppt/read.d.cts

@@ -0,0 +1,5 @@
+import { ContentDocument } from "document-schema.js";
+//#region src/ppt/read.d.ts
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>): ContentDocument;
+//#endregion
+export { readPptContent };

package/dist/ppt/read.d.ts

@@ -0,0 +1,5 @@
+import { ContentDocument } from "document-schema.js";
+//#region src/ppt/read.d.ts
+declare function readPptContent(bytes: Uint8Array<ArrayBuffer>): ContentDocument;
+//#endregion
+export { readPptContent };

package/dist/ppt/read.js

@@ -0,0 +1,12 @@
+import { readPptContent as readPptContent$1 } from "ppt-codec";
+//#region src/ppt/read.ts
+function readPptContent(bytes) {
+	const { metadata, slides } = readPptContent$1(bytes);
+	return {
+		kind: "presentation",
+		metadata: { ...metadata },
+		slides: [...slides]
+	};
+}
+//#endregion
+export { readPptContent };

package/dist/ppt/write.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let ppt_codec = require("ppt-codec");
+//#region src/ppt/write.ts
+function writePptContent(content) {
+	if (content.kind !== "presentation") throw new Error(`writePptContent requires a presentation ContentDocument, got '${content.kind}'`);
+	return (0, ppt_codec.writePptContent)({
+		metadata: content.metadata,
+		slides: content.slides
+	});
+}
+//#endregion
+exports.writePptContent = writePptContent;

package/dist/ppt/write.d.cts

@@ -0,0 +1,5 @@
+import { ContentDocument } from "document-schema.js";
+//#region src/ppt/write.d.ts
+declare function writePptContent(content: ContentDocument): Uint8Array<ArrayBuffer>;
+//#endregion
+export { writePptContent };

package/dist/ppt/write.d.ts

@@ -0,0 +1,5 @@
+import { ContentDocument } from "document-schema.js";
+//#region src/ppt/write.d.ts
+declare function writePptContent(content: ContentDocument): Uint8Array<ArrayBuffer>;
+//#endregion
+export { writePptContent };

package/dist/ppt/write.js

@@ -0,0 +1,11 @@
+import { writePptContent as writePptContent$1 } from "ppt-codec";
+//#region src/ppt/write.ts
+function writePptContent(content) {
+	if (content.kind !== "presentation") throw new Error(`writePptContent requires a presentation ContentDocument, got '${content.kind}'`);
+	return writePptContent$1({
+		metadata: content.metadata,
+		slides: content.slides
+	});
+}
+//#endregion
+export { writePptContent };

package/dist/{shape-xpgICOEx.d.ts → shape-B_vI18gH.d.ts}

@@ -25,7 +25,7 @@ declare class OdpShape {
   remove(): void;
 }
 declare function buildTextBoxFrame(pkg: Package, frame: Box, text: string): XmlElement;
-declare function buildImageFrame(partPath: string, frame: Box): XmlElement;
+declare function buildImageFrame(partPath: string, frame: Box, altText?: string): XmlElement;
 declare function buildTableFrame(frame: Box, tableElement: XmlElement): XmlElement;
 //#endregion
 export { buildTextBoxFrame as i, buildImageFrame as n, buildTableFrame as r, OdpShape as t };

package/dist/{shape-Ca-xsrde.d.cts → shape-C2ef6uwC.d.cts}

@@ -59,6 +59,6 @@ interface DrawingParagraphInit {
 }
 declare function buildDrawingParagraph(init: DrawingParagraphInit): XmlElement;
 declare function buildTextBoxShape(frame: Box, text: string, shapeId: number): XmlElement;
-declare function buildPictureShape(frame: Box, relationshipId: string, shapeId: number): XmlElement;
+declare function buildPictureShape(frame: Box, relationshipId: string, shapeId: number, altText?: string): XmlElement;
 //#endregion
 export { buildDrawingParagraph as a, ROTATION_UNITS_PER_DEGREE as i, DrawingRunInit as n, buildPictureShape as o, PptxShape as r, buildTextBoxShape as s, DrawingParagraphInit as t };

package/dist/{shape-DqkYq1OL.d.cts → shape-CQa4zif9.d.cts}

@@ -25,7 +25,7 @@ declare class OdpShape {
   remove(): void;
 }
 declare function buildTextBoxFrame(pkg: Package, frame: Box, text: string): XmlElement;
-declare function buildImageFrame(partPath: string, frame: Box): XmlElement;
+declare function buildImageFrame(partPath: string, frame: Box, altText?: string): XmlElement;
 declare function buildTableFrame(frame: Box, tableElement: XmlElement): XmlElement;
 //#endregion
 export { buildTextBoxFrame as i, buildImageFrame as n, buildTableFrame as r, OdpShape as t };

package/dist/{shape-BY5P8kDn.d.ts → shape-DwZouh8R.d.ts}

@@ -59,6 +59,6 @@ interface DrawingParagraphInit {
 }
 declare function buildDrawingParagraph(init: DrawingParagraphInit): XmlElement;
 declare function buildTextBoxShape(frame: Box, text: string, shapeId: number): XmlElement;
-declare function buildPictureShape(frame: Box, relationshipId: string, shapeId: number): XmlElement;
+declare function buildPictureShape(frame: Box, relationshipId: string, shapeId: number, altText?: string): XmlElement;
 //#endregion
 export { buildDrawingParagraph as a, ROTATION_UNITS_PER_DEGREE as i, DrawingRunInit as n, buildPictureShape as o, PptxShape as r, buildTextBoxShape as s, DrawingParagraphInit as t };

package/dist/{table-C_KDsX5R.d.cts → table-CtbzOK8s.d.cts}

@@ -1,4 +1,4 @@
-import { t as DrawingParagraphInit } from "./shape-Ca-xsrde.cjs";
+import { t as DrawingParagraphInit } from "./shape-C2ef6uwC.cjs";
 import { Box, Color, ContentCellBorders } from "document-schema.js";
 import { XmlElement } from "ooxml.js";
 //#region src/edit/pptx/table.d.ts

package/dist/{table-C3VWWdjr.d.ts → table-D2CgT0Gf.d.ts}

@@ -1,4 +1,4 @@
-import { t as DrawingParagraphInit } from "./shape-BY5P8kDn.js";
+import { t as DrawingParagraphInit } from "./shape-DwZouh8R.js";
 import { XmlElement } from "ooxml.js";
 import { Box, Color, ContentCellBorders } from "document-schema.js";
 //#region src/edit/pptx/table.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "6.4.1",
+  "version": "6.5.1",
   "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": {
@@ -77,17 +77,21 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "archive-codec": "^1.4.0",
     "byte-codec": "^1.2.0",
-    "document-schema.js": "^5.5.0",
+    "doc-codec": "^1.1.0",
+    "document-schema.js": "^5.5.1",
     "fflate": "^0.8.3",
-    "markdown-codec": "^6.1.4",
-    "odf.js": "^6.3.0",
-    "ooxml.js": "^6.3.3",
-    "pdf-codec": "^3.6.2",
-    "rtf-codec": "^1.1.0",
+    "markdown-codec": "^6.1.5",
+    "odf.js": "^6.4.0",
+    "ooxml.js": "^6.3.5",
+    "pdf-codec": "^3.6.3",
+    "ppt-codec": "^1.1.0",
+    "rtf-codec": "^1.1.1",
     "temml": "0.13.4",
+    "xls-codec": "^2.0.0",
     "zod": "^4.4.3",
-    "wpd-codec": "^1.1.0"
+    "wpd-codec": "^1.1.1"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",