odf.js 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -329,8 +329,367 @@ function encodePackage(pkg) {
 	return zod.z.encode(packageCodec, pkg);
 }
 //#endregion
+//#region src/ns.ts
+const ODF_NAMESPACES = Object.freeze({
+	office: "urn:oasis:names:tc:opendocument:xmlns:office:1.0",
+	style: "urn:oasis:names:tc:opendocument:xmlns:style:1.0",
+	text: "urn:oasis:names:tc:opendocument:xmlns:text:1.0",
+	table: "urn:oasis:names:tc:opendocument:xmlns:table:1.0",
+	draw: "urn:oasis:names:tc:opendocument:xmlns:drawing:1.0",
+	fo: "urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0",
+	svg: "urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0",
+	xlink: "http://www.w3.org/1999/xlink",
+	dc: "http://purl.org/dc/elements/1.1/",
+	meta: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0",
+	number: "urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0",
+	chart: "urn:oasis:names:tc:opendocument:xmlns:chart:1.0",
+	dr3d: "urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0",
+	math: "http://www.w3.org/1998/Math/MathML",
+	form: "urn:oasis:names:tc:opendocument:xmlns:form:1.0",
+	script: "urn:oasis:names:tc:opendocument:xmlns:script:1.0",
+	config: "urn:oasis:names:tc:opendocument:xmlns:config:1.0",
+	presentation: "urn:oasis:names:tc:opendocument:xmlns:presentation:1.0",
+	smil: "urn:oasis:names:tc:opendocument:xmlns:smil-compatible:1.0",
+	anim: "urn:oasis:names:tc:opendocument:xmlns:animation:1.0",
+	xforms: "http://www.w3.org/2002/xforms",
+	xsd: "http://www.w3.org/2001/XMLSchema",
+	xsi: "http://www.w3.org/2001/XMLSchema-instance",
+	manifest: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0"
+});
+function xmlnsAttributes(prefixes) {
+	const attrs = {};
+	for (const prefix of prefixes) attrs[`xmlns:${prefix}`] = ODF_NAMESPACES[prefix];
+	return attrs;
+}
+//#endregion
+//#region src/media-type.ts
+const ODF_MEDIA_TYPES = Object.freeze({
+	odt: "application/vnd.oasis.opendocument.text",
+	ott: "application/vnd.oasis.opendocument.text-template",
+	ods: "application/vnd.oasis.opendocument.spreadsheet",
+	ots: "application/vnd.oasis.opendocument.spreadsheet-template",
+	odp: "application/vnd.oasis.opendocument.presentation",
+	otp: "application/vnd.oasis.opendocument.presentation-template",
+	odg: "application/vnd.oasis.opendocument.graphics",
+	otg: "application/vnd.oasis.opendocument.graphics-template",
+	odf: "application/vnd.oasis.opendocument.formula",
+	otf: "application/vnd.oasis.opendocument.formula-template",
+	odm: "application/vnd.oasis.opendocument.text-master",
+	otm: "application/vnd.oasis.opendocument.text-master-template",
+	odb: "application/vnd.oasis.opendocument.base"
+});
+function isOdfExtension(extension) {
+	return Object.hasOwn(ODF_MEDIA_TYPES, extension);
+}
+function mediaTypeForExtension(extension) {
+	const lower = extension.toLowerCase();
+	return isOdfExtension(lower) ? ODF_MEDIA_TYPES[lower] : void 0;
+}
+//#endregion
+//#region src/image/sniff.ts
+const PNG_SIGNATURE = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+];
+const JPEG_SIGNATURE = [
+	255,
+	216,
+	255
+];
+function startsWith(bytes, signature) {
+	if (bytes.length < signature.length) return false;
+	for (let i = 0; i < signature.length; i++) if (bytes[i] !== signature[i]) return false;
+	return true;
+}
+function sniffImageFormat(bytes) {
+	if (startsWith(bytes, PNG_SIGNATURE)) return "png";
+	if (startsWith(bytes, JPEG_SIGNATURE)) return "jpeg";
+}
+//#endregion
+//#region src/mimetype.ts
+function readMimetype(pkg) {
+	const part = pkg.parts[MIMETYPE_PART];
+	if (part?.kind !== "binary") return;
+	return new TextDecoder("utf-8").decode(base64ToBytes(part.base64));
+}
+function writeMimetype(pkg, mediaType) {
+	pkg.parts[MIMETYPE_PART] = {
+		kind: "binary",
+		base64: bytesToBase64(new TextEncoder().encode(mediaType))
+	};
+}
+//#endregion
+//#region src/xml/fragment.ts
+function el(tag, attrs = {}, children = []) {
+	return {
+		type: "element",
+		tag,
+		attributes: Object.entries(attrs).map(([name, value]) => ({
+			name,
+			value
+		})),
+		children
+	};
+}
+function txt(value) {
+	return {
+		type: "text",
+		value
+	};
+}
+//#endregion
+//#region src/xml/entities.ts
+function encodeXmlText(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+//#endregion
+//#region src/manifest.ts
+const ManifestEntrySchema = zod.z.object({
+	fullPath: zod.z.string(),
+	mediaType: zod.z.string(),
+	version: zod.z.string().optional()
+});
+const ManifestSchema = zod.z.object({
+	version: zod.z.string(),
+	entries: zod.z.array(ManifestEntrySchema)
+});
+const ManifestProblemSchema = zod.z.object({
+	severity: zod.z.enum(["error", "warning"]),
+	message: zod.z.string(),
+	path: zod.z.string().optional()
+});
+const DEFAULT_MANIFEST_VERSION = "1.3";
+const STANDARD_XML_PART_NAMES = /* @__PURE__ */ new Set([
+	"content.xml",
+	"styles.xml",
+	"meta.xml",
+	"settings.xml"
+]);
+function findChildElement(nodes, tag) {
+	for (const node of nodes) if (node.type === "element" && node.tag === tag) return node;
+}
+function attrValue(element, name) {
+	return element.attributes.find((attribute) => attribute.name === name)?.value;
+}
+function readManifest(pkg) {
+	const part = pkg.parts[MANIFEST_PART];
+	if (part?.kind !== "xml") throw new Error(`package has no ${MANIFEST_PART} XML part to read`);
+	const root = findChildElement(part.nodes, "manifest:manifest");
+	if (root === void 0) throw new Error(`${MANIFEST_PART} has no manifest:manifest root element`);
+	const version = attrValue(root, "manifest:version");
+	if (version === void 0) throw new Error(`${MANIFEST_PART}'s manifest:manifest root is missing the required manifest:version attribute`);
+	const entries = [];
+	for (const child of root.children) {
+		if (child.type !== "element" || child.tag !== "manifest:file-entry") continue;
+		const fullPath = attrValue(child, "manifest:full-path");
+		const mediaType = attrValue(child, "manifest:media-type");
+		if (fullPath === void 0 || mediaType === void 0) throw new Error(`${MANIFEST_PART} has a manifest:file-entry missing manifest:full-path or manifest:media-type`);
+		const entryVersion = attrValue(child, "manifest:version");
+		entries.push(entryVersion === void 0 ? {
+			fullPath,
+			mediaType
+		} : {
+			fullPath,
+			mediaType,
+			version: entryVersion
+		});
+	}
+	return {
+		version,
+		entries
+	};
+}
+function subdocumentDirectories(partPaths) {
+	const dirs = [];
+	for (const path of partPaths) if (path.endsWith("/content.xml")) dirs.push(path.slice(0, path.length - 11));
+	return dirs;
+}
+function resolvePartMediaType(path, bytes, overrides) {
+	const override = overrides?.[path];
+	if (override !== void 0) return override;
+	const baseName = path.slice(path.lastIndexOf("/") + 1);
+	if (STANDARD_XML_PART_NAMES.has(baseName)) return "text/xml";
+	const dotIndex = baseName.lastIndexOf(".");
+	const extension = dotIndex === -1 ? "" : baseName.slice(dotIndex + 1);
+	const byExtension = extension === "" ? void 0 : mediaTypeForExtension(extension);
+	if (byExtension !== void 0) return byExtension;
+	if (bytes !== void 0) {
+		const sniffed = sniffImageFormat(bytes);
+		if (sniffed === "png") return "image/png";
+		if (sniffed === "jpeg") return "image/jpeg";
+	}
+	return "";
+}
+function buildManifest(pkg, options = {}) {
+	const version = options.version ?? DEFAULT_MANIFEST_VERSION;
+	const documentMediaType = options.documentMediaType ?? readMimetype(pkg);
+	if (documentMediaType === void 0) throw new Error("buildManifest: package has no \"mimetype\" part and no documentMediaType override was supplied -- the manifest root entry requires a known document media type");
+	const entries = [{
+		fullPath: "/",
+		mediaType: documentMediaType,
+		version
+	}];
+	const partPaths = Object.keys(pkg.parts);
+	for (const dir of new Set(subdocumentDirectories(partPaths))) entries.push({
+		fullPath: dir,
+		mediaType: resolvePartMediaType(dir, void 0, options.mediaTypeOverrides)
+	});
+	for (const [path, part] of Object.entries(pkg.parts)) {
+		if (path === "mimetype" || path === "META-INF/manifest.xml") continue;
+		const bytes = part.kind === "binary" ? base64ToBytes(part.base64) : void 0;
+		entries.push({
+			fullPath: path,
+			mediaType: resolvePartMediaType(path, bytes, options.mediaTypeOverrides)
+		});
+	}
+	return {
+		version,
+		entries
+	};
+}
+function buildManifestNodes(manifest) {
+	const fileEntries = manifest.entries.map((entry) => {
+		const attrs = { "manifest:full-path": encodeXmlText(entry.fullPath) };
+		if (entry.version !== void 0) attrs["manifest:version"] = encodeXmlText(entry.version);
+		attrs["manifest:media-type"] = encodeXmlText(entry.mediaType);
+		return el("manifest:file-entry", attrs);
+	});
+	return [{
+		type: "declaration",
+		attributes: [{
+			name: "version",
+			value: "1.0"
+		}, {
+			name: "encoding",
+			value: "UTF-8"
+		}]
+	}, el("manifest:manifest", {
+		...xmlnsAttributes(["manifest"]),
+		"manifest:version": encodeXmlText(manifest.version)
+	}, fileEntries)];
+}
+function writeManifest(pkg, manifest) {
+	pkg.parts[MANIFEST_PART] = {
+		kind: "xml",
+		nodes: buildManifestNodes(manifest)
+	};
+}
+function syncManifest(pkg, options) {
+	writeManifest(pkg, buildManifest(pkg, options));
+}
+function validateManifest(pkg) {
+	const problems = [];
+	const manifestPart = pkg.parts[MANIFEST_PART];
+	if (manifestPart === void 0) {
+		problems.push({
+			severity: "error",
+			message: `package has no ${MANIFEST_PART} part`
+		});
+		return problems;
+	}
+	if (manifestPart.kind !== "xml") {
+		problems.push({
+			severity: "error",
+			message: `${MANIFEST_PART} part is not XML`
+		});
+		return problems;
+	}
+	const root = findChildElement(manifestPart.nodes, "manifest:manifest");
+	if (root === void 0) {
+		problems.push({
+			severity: "error",
+			message: `${MANIFEST_PART} has no manifest:manifest root element`
+		});
+		return problems;
+	}
+	let manifest;
+	try {
+		manifest = readManifest(pkg);
+	} catch (error) {
+		problems.push({
+			severity: "error",
+			message: `failed to parse ${MANIFEST_PART}: ${error instanceof Error ? error.message : String(error)}`
+		});
+		return problems;
+	}
+	const rootEntry = manifest.entries.find((entry) => entry.fullPath === "/");
+	if (rootEntry === void 0) problems.push({
+		severity: "error",
+		message: "manifest has no root (\"/\") entry"
+	});
+	else {
+		const documentMediaType = readMimetype(pkg);
+		if (documentMediaType !== void 0 && documentMediaType !== rootEntry.mediaType) problems.push({
+			severity: "error",
+			message: `manifest root entry media type "${rootEntry.mediaType}" does not match the mimetype part's media type "${documentMediaType}"`,
+			path: "/"
+		});
+	}
+	const partPaths = new Set(Object.keys(pkg.parts).filter((path) => path !== "mimetype" && path !== "META-INF/manifest.xml"));
+	const manifestPaths = new Set(manifest.entries.map((entry) => entry.fullPath));
+	for (const entry of manifest.entries) {
+		if (entry.fullPath === "/" || entry.fullPath.endsWith("/")) continue;
+		if (!partPaths.has(entry.fullPath)) problems.push({
+			severity: "warning",
+			message: `manifest lists "${entry.fullPath}" but the package has no such part`,
+			path: entry.fullPath
+		});
+	}
+	for (const path of partPaths) if (!manifestPaths.has(path)) problems.push({
+		severity: "warning",
+		message: `package has part "${path}" not listed in the manifest`,
+		path
+	});
+	for (const child of root.children) {
+		if (child.type !== "element" || child.tag !== "manifest:file-entry") continue;
+		if (!child.children.some((grandchild) => grandchild.type === "element" && grandchild.tag === "manifest:encryption-data")) continue;
+		const fullPath = attrValue(child, "manifest:full-path");
+		if (fullPath === void 0) continue;
+		problems.push({
+			severity: "warning",
+			message: `entry "${fullPath}" carries manifest:encryption-data -- odf.js does not implement ODF encryption/decryption`,
+			path: fullPath
+		});
+	}
+	return problems;
+}
+function setDocumentMediaType(pkg, mediaType, version = DEFAULT_MANIFEST_VERSION) {
+	writeMimetype(pkg, mediaType);
+	const rootEntry = {
+		fullPath: "/",
+		mediaType,
+		version
+	};
+	if (pkg.parts["META-INF/manifest.xml"] === void 0) {
+		writeManifest(pkg, {
+			version,
+			entries: [rootEntry]
+		});
+		return;
+	}
+	const existing = readManifest(pkg);
+	const rootIndex = existing.entries.findIndex((entry) => entry.fullPath === "/");
+	writeManifest(pkg, {
+		version,
+		entries: rootIndex === -1 ? [rootEntry, ...existing.entries] : existing.entries.map((entry, index) => index === rootIndex ? rootEntry : entry)
+	});
+}
+//#endregion
 exports.AttributeSchema = AttributeSchema;
 exports.BinaryPartSchema = BinaryPartSchema;
+exports.MANIFEST_PART = MANIFEST_PART;
+exports.MIMETYPE_PART = MIMETYPE_PART;
+exports.ManifestEntrySchema = ManifestEntrySchema;
+exports.ManifestProblemSchema = ManifestProblemSchema;
+exports.ManifestSchema = ManifestSchema;
+exports.ODF_MEDIA_TYPES = ODF_MEDIA_TYPES;
+exports.ODF_NAMESPACES = ODF_NAMESPACES;
 exports.PackageSchema = PackageSchema;
 exports.PartSchema = PartSchema;
 exports.XmlCdataSchema = XmlCdataSchema;
@@ -342,15 +701,29 @@ exports.XmlPartSchema = XmlPartSchema;
 exports.XmlPiSchema = XmlPiSchema;
 exports.XmlTextSchema = XmlTextSchema;
 exports.base64ToBytes = base64ToBytes;
+exports.buildManifest = buildManifest;
 exports.buildXml = buildXml;
 exports.bytesToBase64 = bytesToBase64;
 exports.decodePackage = decodePackage;
+exports.el = el;
 exports.encodePackage = encodePackage;
+exports.encodeXmlText = encodeXmlText;
 exports.isXmlNode = isXmlNode;
+exports.mediaTypeForExtension = mediaTypeForExtension;
 exports.packageCodec = packageCodec;
 exports.parsePackage = parsePackage;
 exports.parseXml = parseXml;
+exports.readManifest = readManifest;
+exports.readMimetype = readMimetype;
 exports.serializePackage = serializePackage;
+exports.setDocumentMediaType = setDocumentMediaType;
+exports.sniffImageFormat = sniffImageFormat;
+exports.syncManifest = syncManifest;
+exports.txt = txt;
 exports.unzipPackage = unzipPackage;
+exports.validateManifest = validateManifest;
+exports.writeManifest = writeManifest;
+exports.writeMimetype = writeMimetype;
 exports.xmlCodec = xmlCodec;
+exports.xmlnsAttributes = xmlnsAttributes;
 exports.zipPackage = zipPackage;

package/dist/index.d.cts

@@ -263,6 +263,8 @@ declare function encodePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 declare function parsePackage(bytes: Uint8Array<ArrayBuffer>): Package;
 //#endregion
 //#region src/package-io/write.d.ts
+declare const MIMETYPE_PART = "mimetype";
+declare const MANIFEST_PART = "META-INF/manifest.xml";
 declare function serializePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 //#endregion
 //#region src/xml/parse.d.ts
@@ -283,4 +285,105 @@ declare function zipPackage(entries: readonly (readonly [string, ZipEntry])[]):
 declare function bytesToBase64(bytes: Uint8Array<ArrayBuffer>): string;
 declare function base64ToBytes(b64: string): Uint8Array<ArrayBuffer>;
 //#endregion
-export { type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Package, PackageSchema, type Part, PartSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, base64ToBytes, buildXml, bytesToBase64, decodePackage, encodePackage, isXmlNode, packageCodec, parsePackage, parseXml, serializePackage, unzipPackage, xmlCodec, zipPackage };
+//#region src/ns.d.ts
+declare const ODF_NAMESPACES: Readonly<{
+  office: "urn:oasis:names:tc:opendocument:xmlns:office:1.0";
+  style: "urn:oasis:names:tc:opendocument:xmlns:style:1.0";
+  text: "urn:oasis:names:tc:opendocument:xmlns:text:1.0";
+  table: "urn:oasis:names:tc:opendocument:xmlns:table:1.0";
+  draw: "urn:oasis:names:tc:opendocument:xmlns:drawing:1.0";
+  fo: "urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0";
+  svg: "urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0";
+  xlink: "http://www.w3.org/1999/xlink";
+  dc: "http://purl.org/dc/elements/1.1/";
+  meta: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0";
+  number: "urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0";
+  chart: "urn:oasis:names:tc:opendocument:xmlns:chart:1.0";
+  dr3d: "urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0";
+  math: "http://www.w3.org/1998/Math/MathML";
+  form: "urn:oasis:names:tc:opendocument:xmlns:form:1.0";
+  script: "urn:oasis:names:tc:opendocument:xmlns:script:1.0";
+  config: "urn:oasis:names:tc:opendocument:xmlns:config:1.0";
+  presentation: "urn:oasis:names:tc:opendocument:xmlns:presentation:1.0";
+  smil: "urn:oasis:names:tc:opendocument:xmlns:smil-compatible:1.0";
+  anim: "urn:oasis:names:tc:opendocument:xmlns:animation:1.0";
+  xforms: "http://www.w3.org/2002/xforms";
+  xsd: "http://www.w3.org/2001/XMLSchema";
+  xsi: "http://www.w3.org/2001/XMLSchema-instance";
+  manifest: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0";
+}>;
+type OdfNamespacePrefix = keyof typeof ODF_NAMESPACES;
+declare function xmlnsAttributes(prefixes: readonly OdfNamespacePrefix[]): Record<string, string>;
+//#endregion
+//#region src/media-type.d.ts
+declare const ODF_MEDIA_TYPES: Readonly<{
+  odt: "application/vnd.oasis.opendocument.text";
+  ott: "application/vnd.oasis.opendocument.text-template";
+  ods: "application/vnd.oasis.opendocument.spreadsheet";
+  ots: "application/vnd.oasis.opendocument.spreadsheet-template";
+  odp: "application/vnd.oasis.opendocument.presentation";
+  otp: "application/vnd.oasis.opendocument.presentation-template";
+  odg: "application/vnd.oasis.opendocument.graphics";
+  otg: "application/vnd.oasis.opendocument.graphics-template";
+  odf: "application/vnd.oasis.opendocument.formula";
+  otf: "application/vnd.oasis.opendocument.formula-template";
+  odm: "application/vnd.oasis.opendocument.text-master";
+  otm: "application/vnd.oasis.opendocument.text-master-template";
+  odb: "application/vnd.oasis.opendocument.base";
+}>;
+type OdfExtension = keyof typeof ODF_MEDIA_TYPES;
+declare function mediaTypeForExtension(extension: string): string | undefined;
+//#endregion
+//#region src/image/sniff.d.ts
+type ImageFormat = 'png' | 'jpeg';
+declare function sniffImageFormat(bytes: Uint8Array<ArrayBuffer>): ImageFormat | undefined;
+//#endregion
+//#region src/mimetype.d.ts
+declare function readMimetype(pkg: Package): string | undefined;
+declare function writeMimetype(pkg: Package, mediaType: string): void;
+//#endregion
+//#region src/xml/fragment.d.ts
+declare function el(tag: string, attrs?: Record<string, string>, children?: XmlNode[]): XmlElement;
+declare function txt(value: string): XmlText;
+//#endregion
+//#region src/xml/entities.d.ts
+declare function encodeXmlText(value: string): string;
+//#endregion
+//#region src/manifest.d.ts
+declare const ManifestEntrySchema: z.ZodObject<{
+  fullPath: z.ZodString;
+  mediaType: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ManifestEntry = z.infer<typeof ManifestEntrySchema>;
+declare const ManifestSchema: z.ZodObject<{
+  version: z.ZodString;
+  entries: z.ZodArray<z.ZodObject<{
+    fullPath: z.ZodString;
+    mediaType: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type Manifest = z.infer<typeof ManifestSchema>;
+declare const ManifestProblemSchema: z.ZodObject<{
+  severity: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+  }>;
+  message: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ManifestProblem = z.infer<typeof ManifestProblemSchema>;
+declare function readManifest(pkg: Package): Manifest;
+interface BuildManifestOptions {
+  documentMediaType?: string;
+  version?: string;
+  mediaTypeOverrides?: Readonly<Record<string, string>>;
+}
+declare function buildManifest(pkg: Package, options?: BuildManifestOptions): Manifest;
+declare function writeManifest(pkg: Package, manifest: Manifest): void;
+declare function syncManifest(pkg: Package, options?: BuildManifestOptions): void;
+declare function validateManifest(pkg: Package): ManifestProblem[];
+declare function setDocumentMediaType(pkg: Package, mediaType: string, version?: string): void;
+//#endregion
+export { type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type ImageFormat, MANIFEST_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type Package, PackageSchema, type Part, PartSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, base64ToBytes, buildManifest, buildXml, bytesToBase64, decodePackage, el, encodePackage, encodeXmlText, isXmlNode, mediaTypeForExtension, packageCodec, parsePackage, parseXml, readManifest, readMimetype, serializePackage, setDocumentMediaType, sniffImageFormat, syncManifest, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.d.ts

@@ -263,6 +263,8 @@ declare function encodePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 declare function parsePackage(bytes: Uint8Array<ArrayBuffer>): Package;
 //#endregion
 //#region src/package-io/write.d.ts
+declare const MIMETYPE_PART = "mimetype";
+declare const MANIFEST_PART = "META-INF/manifest.xml";
 declare function serializePackage(pkg: Package): Uint8Array<ArrayBuffer>;
 //#endregion
 //#region src/xml/parse.d.ts
@@ -283,4 +285,105 @@ declare function zipPackage(entries: readonly (readonly [string, ZipEntry])[]):
 declare function bytesToBase64(bytes: Uint8Array<ArrayBuffer>): string;
 declare function base64ToBytes(b64: string): Uint8Array<ArrayBuffer>;
 //#endregion
-export { type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Package, PackageSchema, type Part, PartSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, base64ToBytes, buildXml, bytesToBase64, decodePackage, encodePackage, isXmlNode, packageCodec, parsePackage, parseXml, serializePackage, unzipPackage, xmlCodec, zipPackage };
+//#region src/ns.d.ts
+declare const ODF_NAMESPACES: Readonly<{
+  office: "urn:oasis:names:tc:opendocument:xmlns:office:1.0";
+  style: "urn:oasis:names:tc:opendocument:xmlns:style:1.0";
+  text: "urn:oasis:names:tc:opendocument:xmlns:text:1.0";
+  table: "urn:oasis:names:tc:opendocument:xmlns:table:1.0";
+  draw: "urn:oasis:names:tc:opendocument:xmlns:drawing:1.0";
+  fo: "urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0";
+  svg: "urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0";
+  xlink: "http://www.w3.org/1999/xlink";
+  dc: "http://purl.org/dc/elements/1.1/";
+  meta: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0";
+  number: "urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0";
+  chart: "urn:oasis:names:tc:opendocument:xmlns:chart:1.0";
+  dr3d: "urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0";
+  math: "http://www.w3.org/1998/Math/MathML";
+  form: "urn:oasis:names:tc:opendocument:xmlns:form:1.0";
+  script: "urn:oasis:names:tc:opendocument:xmlns:script:1.0";
+  config: "urn:oasis:names:tc:opendocument:xmlns:config:1.0";
+  presentation: "urn:oasis:names:tc:opendocument:xmlns:presentation:1.0";
+  smil: "urn:oasis:names:tc:opendocument:xmlns:smil-compatible:1.0";
+  anim: "urn:oasis:names:tc:opendocument:xmlns:animation:1.0";
+  xforms: "http://www.w3.org/2002/xforms";
+  xsd: "http://www.w3.org/2001/XMLSchema";
+  xsi: "http://www.w3.org/2001/XMLSchema-instance";
+  manifest: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0";
+}>;
+type OdfNamespacePrefix = keyof typeof ODF_NAMESPACES;
+declare function xmlnsAttributes(prefixes: readonly OdfNamespacePrefix[]): Record<string, string>;
+//#endregion
+//#region src/media-type.d.ts
+declare const ODF_MEDIA_TYPES: Readonly<{
+  odt: "application/vnd.oasis.opendocument.text";
+  ott: "application/vnd.oasis.opendocument.text-template";
+  ods: "application/vnd.oasis.opendocument.spreadsheet";
+  ots: "application/vnd.oasis.opendocument.spreadsheet-template";
+  odp: "application/vnd.oasis.opendocument.presentation";
+  otp: "application/vnd.oasis.opendocument.presentation-template";
+  odg: "application/vnd.oasis.opendocument.graphics";
+  otg: "application/vnd.oasis.opendocument.graphics-template";
+  odf: "application/vnd.oasis.opendocument.formula";
+  otf: "application/vnd.oasis.opendocument.formula-template";
+  odm: "application/vnd.oasis.opendocument.text-master";
+  otm: "application/vnd.oasis.opendocument.text-master-template";
+  odb: "application/vnd.oasis.opendocument.base";
+}>;
+type OdfExtension = keyof typeof ODF_MEDIA_TYPES;
+declare function mediaTypeForExtension(extension: string): string | undefined;
+//#endregion
+//#region src/image/sniff.d.ts
+type ImageFormat = 'png' | 'jpeg';
+declare function sniffImageFormat(bytes: Uint8Array<ArrayBuffer>): ImageFormat | undefined;
+//#endregion
+//#region src/mimetype.d.ts
+declare function readMimetype(pkg: Package): string | undefined;
+declare function writeMimetype(pkg: Package, mediaType: string): void;
+//#endregion
+//#region src/xml/fragment.d.ts
+declare function el(tag: string, attrs?: Record<string, string>, children?: XmlNode[]): XmlElement;
+declare function txt(value: string): XmlText;
+//#endregion
+//#region src/xml/entities.d.ts
+declare function encodeXmlText(value: string): string;
+//#endregion
+//#region src/manifest.d.ts
+declare const ManifestEntrySchema: z.ZodObject<{
+  fullPath: z.ZodString;
+  mediaType: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ManifestEntry = z.infer<typeof ManifestEntrySchema>;
+declare const ManifestSchema: z.ZodObject<{
+  version: z.ZodString;
+  entries: z.ZodArray<z.ZodObject<{
+    fullPath: z.ZodString;
+    mediaType: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type Manifest = z.infer<typeof ManifestSchema>;
+declare const ManifestProblemSchema: z.ZodObject<{
+  severity: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+  }>;
+  message: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ManifestProblem = z.infer<typeof ManifestProblemSchema>;
+declare function readManifest(pkg: Package): Manifest;
+interface BuildManifestOptions {
+  documentMediaType?: string;
+  version?: string;
+  mediaTypeOverrides?: Readonly<Record<string, string>>;
+}
+declare function buildManifest(pkg: Package, options?: BuildManifestOptions): Manifest;
+declare function writeManifest(pkg: Package, manifest: Manifest): void;
+declare function syncManifest(pkg: Package, options?: BuildManifestOptions): void;
+declare function validateManifest(pkg: Package): ManifestProblem[];
+declare function setDocumentMediaType(pkg: Package, mediaType: string, version?: string): void;
+//#endregion
+export { type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type BuildManifestOptions, type ImageFormat, MANIFEST_PART, MIMETYPE_PART, type Manifest, type ManifestEntry, ManifestEntrySchema, type ManifestProblem, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, type OdfExtension, type OdfNamespacePrefix, type Package, PackageSchema, type Part, PartSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, type ZipEntry, base64ToBytes, buildManifest, buildXml, bytesToBase64, decodePackage, el, encodePackage, encodeXmlText, isXmlNode, mediaTypeForExtension, packageCodec, parsePackage, parseXml, readManifest, readMimetype, serializePackage, setDocumentMediaType, sniffImageFormat, syncManifest, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/dist/index.js

@@ -328,4 +328,356 @@ function encodePackage(pkg) {
 	return z.encode(packageCodec, pkg);
 }
 //#endregion
-export { AttributeSchema, BinaryPartSchema, PackageSchema, PartSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, base64ToBytes, buildXml, bytesToBase64, decodePackage, encodePackage, isXmlNode, packageCodec, parsePackage, parseXml, serializePackage, unzipPackage, xmlCodec, zipPackage };
+//#region src/ns.ts
+const ODF_NAMESPACES = Object.freeze({
+	office: "urn:oasis:names:tc:opendocument:xmlns:office:1.0",
+	style: "urn:oasis:names:tc:opendocument:xmlns:style:1.0",
+	text: "urn:oasis:names:tc:opendocument:xmlns:text:1.0",
+	table: "urn:oasis:names:tc:opendocument:xmlns:table:1.0",
+	draw: "urn:oasis:names:tc:opendocument:xmlns:drawing:1.0",
+	fo: "urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0",
+	svg: "urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0",
+	xlink: "http://www.w3.org/1999/xlink",
+	dc: "http://purl.org/dc/elements/1.1/",
+	meta: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0",
+	number: "urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0",
+	chart: "urn:oasis:names:tc:opendocument:xmlns:chart:1.0",
+	dr3d: "urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0",
+	math: "http://www.w3.org/1998/Math/MathML",
+	form: "urn:oasis:names:tc:opendocument:xmlns:form:1.0",
+	script: "urn:oasis:names:tc:opendocument:xmlns:script:1.0",
+	config: "urn:oasis:names:tc:opendocument:xmlns:config:1.0",
+	presentation: "urn:oasis:names:tc:opendocument:xmlns:presentation:1.0",
+	smil: "urn:oasis:names:tc:opendocument:xmlns:smil-compatible:1.0",
+	anim: "urn:oasis:names:tc:opendocument:xmlns:animation:1.0",
+	xforms: "http://www.w3.org/2002/xforms",
+	xsd: "http://www.w3.org/2001/XMLSchema",
+	xsi: "http://www.w3.org/2001/XMLSchema-instance",
+	manifest: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0"
+});
+function xmlnsAttributes(prefixes) {
+	const attrs = {};
+	for (const prefix of prefixes) attrs[`xmlns:${prefix}`] = ODF_NAMESPACES[prefix];
+	return attrs;
+}
+//#endregion
+//#region src/media-type.ts
+const ODF_MEDIA_TYPES = Object.freeze({
+	odt: "application/vnd.oasis.opendocument.text",
+	ott: "application/vnd.oasis.opendocument.text-template",
+	ods: "application/vnd.oasis.opendocument.spreadsheet",
+	ots: "application/vnd.oasis.opendocument.spreadsheet-template",
+	odp: "application/vnd.oasis.opendocument.presentation",
+	otp: "application/vnd.oasis.opendocument.presentation-template",
+	odg: "application/vnd.oasis.opendocument.graphics",
+	otg: "application/vnd.oasis.opendocument.graphics-template",
+	odf: "application/vnd.oasis.opendocument.formula",
+	otf: "application/vnd.oasis.opendocument.formula-template",
+	odm: "application/vnd.oasis.opendocument.text-master",
+	otm: "application/vnd.oasis.opendocument.text-master-template",
+	odb: "application/vnd.oasis.opendocument.base"
+});
+function isOdfExtension(extension) {
+	return Object.hasOwn(ODF_MEDIA_TYPES, extension);
+}
+function mediaTypeForExtension(extension) {
+	const lower = extension.toLowerCase();
+	return isOdfExtension(lower) ? ODF_MEDIA_TYPES[lower] : void 0;
+}
+//#endregion
+//#region src/image/sniff.ts
+const PNG_SIGNATURE = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+];
+const JPEG_SIGNATURE = [
+	255,
+	216,
+	255
+];
+function startsWith(bytes, signature) {
+	if (bytes.length < signature.length) return false;
+	for (let i = 0; i < signature.length; i++) if (bytes[i] !== signature[i]) return false;
+	return true;
+}
+function sniffImageFormat(bytes) {
+	if (startsWith(bytes, PNG_SIGNATURE)) return "png";
+	if (startsWith(bytes, JPEG_SIGNATURE)) return "jpeg";
+}
+//#endregion
+//#region src/mimetype.ts
+function readMimetype(pkg) {
+	const part = pkg.parts[MIMETYPE_PART];
+	if (part?.kind !== "binary") return;
+	return new TextDecoder("utf-8").decode(base64ToBytes(part.base64));
+}
+function writeMimetype(pkg, mediaType) {
+	pkg.parts[MIMETYPE_PART] = {
+		kind: "binary",
+		base64: bytesToBase64(new TextEncoder().encode(mediaType))
+	};
+}
+//#endregion
+//#region src/xml/fragment.ts
+function el(tag, attrs = {}, children = []) {
+	return {
+		type: "element",
+		tag,
+		attributes: Object.entries(attrs).map(([name, value]) => ({
+			name,
+			value
+		})),
+		children
+	};
+}
+function txt(value) {
+	return {
+		type: "text",
+		value
+	};
+}
+//#endregion
+//#region src/xml/entities.ts
+function encodeXmlText(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+//#endregion
+//#region src/manifest.ts
+const ManifestEntrySchema = z.object({
+	fullPath: z.string(),
+	mediaType: z.string(),
+	version: z.string().optional()
+});
+const ManifestSchema = z.object({
+	version: z.string(),
+	entries: z.array(ManifestEntrySchema)
+});
+const ManifestProblemSchema = z.object({
+	severity: z.enum(["error", "warning"]),
+	message: z.string(),
+	path: z.string().optional()
+});
+const DEFAULT_MANIFEST_VERSION = "1.3";
+const STANDARD_XML_PART_NAMES = /* @__PURE__ */ new Set([
+	"content.xml",
+	"styles.xml",
+	"meta.xml",
+	"settings.xml"
+]);
+function findChildElement(nodes, tag) {
+	for (const node of nodes) if (node.type === "element" && node.tag === tag) return node;
+}
+function attrValue(element, name) {
+	return element.attributes.find((attribute) => attribute.name === name)?.value;
+}
+function readManifest(pkg) {
+	const part = pkg.parts[MANIFEST_PART];
+	if (part?.kind !== "xml") throw new Error(`package has no ${MANIFEST_PART} XML part to read`);
+	const root = findChildElement(part.nodes, "manifest:manifest");
+	if (root === void 0) throw new Error(`${MANIFEST_PART} has no manifest:manifest root element`);
+	const version = attrValue(root, "manifest:version");
+	if (version === void 0) throw new Error(`${MANIFEST_PART}'s manifest:manifest root is missing the required manifest:version attribute`);
+	const entries = [];
+	for (const child of root.children) {
+		if (child.type !== "element" || child.tag !== "manifest:file-entry") continue;
+		const fullPath = attrValue(child, "manifest:full-path");
+		const mediaType = attrValue(child, "manifest:media-type");
+		if (fullPath === void 0 || mediaType === void 0) throw new Error(`${MANIFEST_PART} has a manifest:file-entry missing manifest:full-path or manifest:media-type`);
+		const entryVersion = attrValue(child, "manifest:version");
+		entries.push(entryVersion === void 0 ? {
+			fullPath,
+			mediaType
+		} : {
+			fullPath,
+			mediaType,
+			version: entryVersion
+		});
+	}
+	return {
+		version,
+		entries
+	};
+}
+function subdocumentDirectories(partPaths) {
+	const dirs = [];
+	for (const path of partPaths) if (path.endsWith("/content.xml")) dirs.push(path.slice(0, path.length - 11));
+	return dirs;
+}
+function resolvePartMediaType(path, bytes, overrides) {
+	const override = overrides?.[path];
+	if (override !== void 0) return override;
+	const baseName = path.slice(path.lastIndexOf("/") + 1);
+	if (STANDARD_XML_PART_NAMES.has(baseName)) return "text/xml";
+	const dotIndex = baseName.lastIndexOf(".");
+	const extension = dotIndex === -1 ? "" : baseName.slice(dotIndex + 1);
+	const byExtension = extension === "" ? void 0 : mediaTypeForExtension(extension);
+	if (byExtension !== void 0) return byExtension;
+	if (bytes !== void 0) {
+		const sniffed = sniffImageFormat(bytes);
+		if (sniffed === "png") return "image/png";
+		if (sniffed === "jpeg") return "image/jpeg";
+	}
+	return "";
+}
+function buildManifest(pkg, options = {}) {
+	const version = options.version ?? DEFAULT_MANIFEST_VERSION;
+	const documentMediaType = options.documentMediaType ?? readMimetype(pkg);
+	if (documentMediaType === void 0) throw new Error("buildManifest: package has no \"mimetype\" part and no documentMediaType override was supplied -- the manifest root entry requires a known document media type");
+	const entries = [{
+		fullPath: "/",
+		mediaType: documentMediaType,
+		version
+	}];
+	const partPaths = Object.keys(pkg.parts);
+	for (const dir of new Set(subdocumentDirectories(partPaths))) entries.push({
+		fullPath: dir,
+		mediaType: resolvePartMediaType(dir, void 0, options.mediaTypeOverrides)
+	});
+	for (const [path, part] of Object.entries(pkg.parts)) {
+		if (path === "mimetype" || path === "META-INF/manifest.xml") continue;
+		const bytes = part.kind === "binary" ? base64ToBytes(part.base64) : void 0;
+		entries.push({
+			fullPath: path,
+			mediaType: resolvePartMediaType(path, bytes, options.mediaTypeOverrides)
+		});
+	}
+	return {
+		version,
+		entries
+	};
+}
+function buildManifestNodes(manifest) {
+	const fileEntries = manifest.entries.map((entry) => {
+		const attrs = { "manifest:full-path": encodeXmlText(entry.fullPath) };
+		if (entry.version !== void 0) attrs["manifest:version"] = encodeXmlText(entry.version);
+		attrs["manifest:media-type"] = encodeXmlText(entry.mediaType);
+		return el("manifest:file-entry", attrs);
+	});
+	return [{
+		type: "declaration",
+		attributes: [{
+			name: "version",
+			value: "1.0"
+		}, {
+			name: "encoding",
+			value: "UTF-8"
+		}]
+	}, el("manifest:manifest", {
+		...xmlnsAttributes(["manifest"]),
+		"manifest:version": encodeXmlText(manifest.version)
+	}, fileEntries)];
+}
+function writeManifest(pkg, manifest) {
+	pkg.parts[MANIFEST_PART] = {
+		kind: "xml",
+		nodes: buildManifestNodes(manifest)
+	};
+}
+function syncManifest(pkg, options) {
+	writeManifest(pkg, buildManifest(pkg, options));
+}
+function validateManifest(pkg) {
+	const problems = [];
+	const manifestPart = pkg.parts[MANIFEST_PART];
+	if (manifestPart === void 0) {
+		problems.push({
+			severity: "error",
+			message: `package has no ${MANIFEST_PART} part`
+		});
+		return problems;
+	}
+	if (manifestPart.kind !== "xml") {
+		problems.push({
+			severity: "error",
+			message: `${MANIFEST_PART} part is not XML`
+		});
+		return problems;
+	}
+	const root = findChildElement(manifestPart.nodes, "manifest:manifest");
+	if (root === void 0) {
+		problems.push({
+			severity: "error",
+			message: `${MANIFEST_PART} has no manifest:manifest root element`
+		});
+		return problems;
+	}
+	let manifest;
+	try {
+		manifest = readManifest(pkg);
+	} catch (error) {
+		problems.push({
+			severity: "error",
+			message: `failed to parse ${MANIFEST_PART}: ${error instanceof Error ? error.message : String(error)}`
+		});
+		return problems;
+	}
+	const rootEntry = manifest.entries.find((entry) => entry.fullPath === "/");
+	if (rootEntry === void 0) problems.push({
+		severity: "error",
+		message: "manifest has no root (\"/\") entry"
+	});
+	else {
+		const documentMediaType = readMimetype(pkg);
+		if (documentMediaType !== void 0 && documentMediaType !== rootEntry.mediaType) problems.push({
+			severity: "error",
+			message: `manifest root entry media type "${rootEntry.mediaType}" does not match the mimetype part's media type "${documentMediaType}"`,
+			path: "/"
+		});
+	}
+	const partPaths = new Set(Object.keys(pkg.parts).filter((path) => path !== "mimetype" && path !== "META-INF/manifest.xml"));
+	const manifestPaths = new Set(manifest.entries.map((entry) => entry.fullPath));
+	for (const entry of manifest.entries) {
+		if (entry.fullPath === "/" || entry.fullPath.endsWith("/")) continue;
+		if (!partPaths.has(entry.fullPath)) problems.push({
+			severity: "warning",
+			message: `manifest lists "${entry.fullPath}" but the package has no such part`,
+			path: entry.fullPath
+		});
+	}
+	for (const path of partPaths) if (!manifestPaths.has(path)) problems.push({
+		severity: "warning",
+		message: `package has part "${path}" not listed in the manifest`,
+		path
+	});
+	for (const child of root.children) {
+		if (child.type !== "element" || child.tag !== "manifest:file-entry") continue;
+		if (!child.children.some((grandchild) => grandchild.type === "element" && grandchild.tag === "manifest:encryption-data")) continue;
+		const fullPath = attrValue(child, "manifest:full-path");
+		if (fullPath === void 0) continue;
+		problems.push({
+			severity: "warning",
+			message: `entry "${fullPath}" carries manifest:encryption-data -- odf.js does not implement ODF encryption/decryption`,
+			path: fullPath
+		});
+	}
+	return problems;
+}
+function setDocumentMediaType(pkg, mediaType, version = DEFAULT_MANIFEST_VERSION) {
+	writeMimetype(pkg, mediaType);
+	const rootEntry = {
+		fullPath: "/",
+		mediaType,
+		version
+	};
+	if (pkg.parts["META-INF/manifest.xml"] === void 0) {
+		writeManifest(pkg, {
+			version,
+			entries: [rootEntry]
+		});
+		return;
+	}
+	const existing = readManifest(pkg);
+	const rootIndex = existing.entries.findIndex((entry) => entry.fullPath === "/");
+	writeManifest(pkg, {
+		version,
+		entries: rootIndex === -1 ? [rootEntry, ...existing.entries] : existing.entries.map((entry, index) => index === rootIndex ? rootEntry : entry)
+	});
+}
+//#endregion
+export { AttributeSchema, BinaryPartSchema, MANIFEST_PART, MIMETYPE_PART, ManifestEntrySchema, ManifestProblemSchema, ManifestSchema, ODF_MEDIA_TYPES, ODF_NAMESPACES, PackageSchema, PartSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, base64ToBytes, buildManifest, buildXml, bytesToBase64, decodePackage, el, encodePackage, encodeXmlText, isXmlNode, mediaTypeForExtension, packageCodec, parsePackage, parseXml, readManifest, readMimetype, serializePackage, setDocumentMediaType, sniffImageFormat, syncManifest, txt, unzipPackage, validateManifest, writeManifest, writeMimetype, xmlCodec, xmlnsAttributes, zipPackage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf.js",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Type-safe, lossless round-trip conversion between OpenDocument Format packages (odt, ods, odp) and JSON, hand-written and dependency-minimal, built on Zod 4 codecs.",
   "type": "module",
   "repository": {