@stll/docx-utils 0.1.3 → 0.1.5

package/dist/office-formats.d.ts

@@ -0,0 +1,89 @@
+//#region src/office-formats.d.ts
+/** ZIP-based office formats; legacy binary formats are not XML containers. */
+export declare const OFFICE_ARCHIVE_FORMATS: {
+  readonly docx: {
+    readonly family: "word";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+  };
+  readonly docm: {
+    readonly family: "word";
+    readonly mimeType: "application/vnd.ms-word.document.macroEnabled.12";
+  };
+  readonly dotx: {
+    readonly family: "word";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.template";
+  };
+  readonly dotm: {
+    readonly family: "word";
+    readonly mimeType: "application/vnd.ms-word.template.macroEnabled.12";
+  };
+  readonly xlsx: {
+    readonly family: "sheet";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+  };
+  readonly xlsm: {
+    readonly family: "sheet";
+    readonly mimeType: "application/vnd.ms-excel.sheet.macroEnabled.12";
+  };
+  readonly xlsb: {
+    readonly family: "sheet";
+    readonly mimeType: "application/vnd.ms-excel.sheet.binary.macroEnabled.12";
+  };
+  readonly xltx: {
+    readonly family: "sheet";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.template";
+  };
+  readonly xltm: {
+    readonly family: "sheet";
+    readonly mimeType: "application/vnd.ms-excel.template.macroEnabled.12";
+  };
+  readonly pptx: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+  };
+  readonly pptm: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.ms-powerpoint.presentation.macroEnabled.12";
+  };
+  readonly ppsx: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.presentationml.slideshow";
+  };
+  readonly ppsm: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.ms-powerpoint.slideshow.macroEnabled.12";
+  };
+  readonly potx: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.openxmlformats-officedocument.presentationml.template";
+  };
+  readonly potm: {
+    readonly family: "presentation";
+    readonly mimeType: "application/vnd.ms-powerpoint.template.macroEnabled.12";
+  };
+  readonly odt: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.text";
+  };
+  readonly ods: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.spreadsheet";
+  };
+  readonly odp: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.presentation";
+  };
+  readonly ott: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.text-template";
+  };
+  readonly ots: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.spreadsheet-template";
+  };
+  readonly otp: {
+    readonly family: "odf";
+    readonly mimeType: "application/vnd.oasis.opendocument.presentation-template";
+  };
+};
+//#endregion

package/dist/office-formats.js

@@ -0,0 +1,90 @@
+//#region src/office-formats.ts
+/** ZIP-based office formats; legacy binary formats are not XML containers. */
+const OFFICE_ARCHIVE_FORMATS = {
+	docx: {
+		family: "word",
+		mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+	},
+	docm: {
+		family: "word",
+		mimeType: "application/vnd.ms-word.document.macroEnabled.12"
+	},
+	dotx: {
+		family: "word",
+		mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.template"
+	},
+	dotm: {
+		family: "word",
+		mimeType: "application/vnd.ms-word.template.macroEnabled.12"
+	},
+	xlsx: {
+		family: "sheet",
+		mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+	},
+	xlsm: {
+		family: "sheet",
+		mimeType: "application/vnd.ms-excel.sheet.macroEnabled.12"
+	},
+	xlsb: {
+		family: "sheet",
+		mimeType: "application/vnd.ms-excel.sheet.binary.macroEnabled.12"
+	},
+	xltx: {
+		family: "sheet",
+		mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.template"
+	},
+	xltm: {
+		family: "sheet",
+		mimeType: "application/vnd.ms-excel.template.macroEnabled.12"
+	},
+	pptx: {
+		family: "presentation",
+		mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+	},
+	pptm: {
+		family: "presentation",
+		mimeType: "application/vnd.ms-powerpoint.presentation.macroEnabled.12"
+	},
+	ppsx: {
+		family: "presentation",
+		mimeType: "application/vnd.openxmlformats-officedocument.presentationml.slideshow"
+	},
+	ppsm: {
+		family: "presentation",
+		mimeType: "application/vnd.ms-powerpoint.slideshow.macroEnabled.12"
+	},
+	potx: {
+		family: "presentation",
+		mimeType: "application/vnd.openxmlformats-officedocument.presentationml.template"
+	},
+	potm: {
+		family: "presentation",
+		mimeType: "application/vnd.ms-powerpoint.template.macroEnabled.12"
+	},
+	odt: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.text"
+	},
+	ods: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.spreadsheet"
+	},
+	odp: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.presentation"
+	},
+	ott: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.text-template"
+	},
+	ots: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.spreadsheet-template"
+	},
+	otp: {
+		family: "odf",
+		mimeType: "application/vnd.oasis.opendocument.presentation-template"
+	}
+};
+//#endregion
+export { OFFICE_ARCHIVE_FORMATS };

package/dist/office-metadata.d.ts

@@ -0,0 +1,38 @@
+import { Attr, Document, Element } from "slimdom";
+//#region src/office-metadata.d.ts
+export declare const officeIdentityAttributePolicy: (name: string) => {
+  readonly type: "replace";
+  readonly replacement: "Author";
+} | {
+  readonly type: "replace";
+  readonly replacement: "A";
+} | {
+  readonly type: "remove";
+} | {
+  readonly type: "remove";
+} | {
+  readonly type: "replace";
+  readonly replacement: "Author";
+} | {
+  readonly type: "remove";
+} | {
+  readonly type: "remove";
+} | {
+  readonly type: "replace";
+  readonly replacement: "Author";
+} | undefined;
+export declare const isOfficeCollaborationPart: (part: string) => boolean;
+/** All XML parts in which office producers store properties or collaboration identities. */
+export declare const isOfficeIdentityPart: (part: string) => boolean;
+export type OfficeIdentityField = {
+  type: "text";
+  node: Element;
+  field: string;
+} | {
+  type: "attribute";
+  node: Attr;
+  field: string;
+};
+/** Internal reference IDs and document/comment body text are deliberately excluded. */
+export declare const officeIdentityFields: (document: Document, part: string) => OfficeIdentityField[];
+//#endregion

package/dist/office-metadata.js

@@ -0,0 +1,88 @@
+//#region src/office-metadata.ts
+const PROPERTY_FIELDS = /* @__PURE__ */ new Set([
+	"creator",
+	"lastmodifiedby",
+	"company",
+	"manager",
+	"template",
+	"title",
+	"subject",
+	"keywords",
+	"keyword",
+	"description",
+	"initial-creator",
+	"printed-by",
+	"user-defined",
+	"category",
+	"contentstatus"
+]);
+const PROPERTY_ATTRIBUTES = /* @__PURE__ */ new Set([
+	"href",
+	"name",
+	"title"
+]);
+const OFFICE_IDENTITY_ATTRIBUTE_POLICIES = {
+	author: {
+		type: "replace",
+		replacement: "Author"
+	},
+	initials: {
+		type: "replace",
+		replacement: "A"
+	},
+	userid: { type: "remove" },
+	providerid: { type: "remove" },
+	displayname: {
+		type: "replace",
+		replacement: "Author"
+	},
+	email: { type: "remove" },
+	emailaddress: { type: "remove" },
+	name: {
+		type: "replace",
+		replacement: "Author"
+	}
+};
+const IDENTITY_ATTRIBUTES = new Set(Object.keys(OFFICE_IDENTITY_ATTRIBUTE_POLICIES).filter((name) => name !== "name"));
+const officeIdentityAttributePolicy = (name) => Object.entries(OFFICE_IDENTITY_ATTRIBUTE_POLICIES).find(([key]) => key === name.toLowerCase())?.[1];
+const isOfficeCollaborationPart = (part) => /^(?:content\.xml|(?:word|xl|ppt)\/.*\.xml)$/iu.test(part);
+const NAMED_IDENTITIES = /* @__PURE__ */ new Set([
+	"person",
+	"author",
+	"cmauthor",
+	"commentauthor",
+	"mention"
+]);
+const DC_NAMESPACE = "http://purl.org/dc/elements/1.1/";
+/** All XML parts in which office producers store properties or collaboration identities. */
+const isOfficeIdentityPart = (part) => /^(?:docProps\/(?:core|app|custom)\.xml|meta\.xml)$/iu.test(part) || isOfficeCollaborationPart(part);
+/** Internal reference IDs and document/comment body text are deliberately excluded. */
+const officeIdentityFields = (document, part) => {
+	const result = [];
+	const propertyPart = /^(?:docProps\/(?:core|app)\.xml|meta\.xml)$/iu.test(part);
+	const customPart = /^docProps\/custom\.xml$/iu.test(part);
+	for (const element of document.getElementsByTagNameNS("*", "*")) {
+		const name = element.localName.toLowerCase();
+		const propertyField = propertyPart && PROPERTY_FIELDS.has(name);
+		const customField = customPart && name === "property";
+		const authorText = /^xl\/comments[^/]*\.xml$/iu.test(part) && name === "author";
+		const odfCreator = part === "content.xml" && element.namespaceURI === DC_NAMESPACE && name === "creator";
+		if (propertyField || customField || authorText || odfCreator) result.push({
+			type: "text",
+			node: element,
+			field: element.localName
+		});
+		for (const attribute of element.attributes) {
+			const attr = attribute.localName.toLowerCase();
+			if (!(propertyField && PROPERTY_ATTRIBUTES.has(attr) || customField && attr === "name" || !propertyPart && !customPart && (IDENTITY_ATTRIBUTES.has(attr) || attr === "name" && NAMED_IDENTITIES.has(name)))) continue;
+			result.push({
+				type: "attribute",
+				node: attribute,
+				field: `${element.localName}@${attribute.localName}`
+			});
+		}
+	}
+	return result;
+};
+//#endregion
+export { isOfficeCollaborationPart, isOfficeIdentityPart, officeIdentityAttributePolicy, officeIdentityFields };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/docx-utils",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Low-level helpers for reading and writing DOCX/OOXML zip packages: text and binary extraction, relationship and content-type management, and namespace constants.",
   "keywords": [
     "docx",
@@ -30,6 +30,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./office-formats": {
+      "types": "./dist/office-formats.d.ts",
+      "import": "./dist/office-formats.js"
+    },
+    "./office-metadata": {
+      "types": "./dist/office-metadata.d.ts",
+      "import": "./dist/office-metadata.js"
     }
   },
   "publishConfig": {
@@ -40,12 +48,14 @@
     "build": "tsdown",
     "pack:dry-run": "bun pm pack --dry-run",
     "test": "bun test src",
+    "check:office-fixture-metadata": "bun scripts/check-office-fixture-metadata.ts",
+    "test:office-fixture-metadata": "bun test scripts/check-office-fixture-metadata.test.ts",
     "typecheck": "bun ../../packages/scripts/src/tsc-native.ts --noEmit",
     "lint": "cd ../.. && bun --bun oxlint -c oxlint.config.ts --report-unused-disable-directives-severity=error --type-aware --type-check packages/docx-utils",
     "lint:fix": "cd ../.. && bun --bun oxlint -c oxlint.config.ts --type-aware --fix packages/docx-utils",
     "format": "bun ../../scripts/run-oxfmt.ts .",
     "prepack": "bun run build",
-    "test:property": "bun test --preload @stll/property-testing/preload $(grep -rlF 'fc.assert' src --include='*.test.ts')"
+    "test:property": "bun test --preload @stll/property-testing/preload $(grep -rlE 'fc\\.assert|assertProperty' src --include='*.test.ts')"
   },
   "dependencies": {
     "better-result": "3.0.1",