ppt-codec 0.0.0 → 1.0.1

package/dist/text/style.d.cts

@@ -0,0 +1,39 @@
+import { t as PptRecord } from "../tree-Du_LXAF0.cjs";
+//#region src/text/style.d.ts
+declare const ALIGN_LEFT = 0;
+declare const ALIGN_CENTER = 1;
+declare const ALIGN_RIGHT = 2;
+declare const ALIGN_JUSTIFY = 3;
+declare const ALIGN_DISTRIBUTED = 4;
+declare const ALIGN_THAI_DISTRIBUTED = 5;
+declare const ALIGN_JUSTIFY_LOW = 6;
+interface RgbColor {
+  readonly red: number;
+  readonly green: number;
+  readonly blue: number;
+}
+interface ParagraphProperties {
+  readonly indentLevel: number;
+  readonly alignment: number | undefined;
+}
+interface CharacterProperties {
+  readonly bold: boolean | undefined;
+  readonly italic: boolean | undefined;
+  readonly underline: boolean | undefined;
+  readonly shadow: boolean | undefined;
+  readonly emboss: boolean | undefined;
+  readonly fontRef: number | undefined;
+  readonly sizePt: number | undefined;
+  readonly color: RgbColor | undefined;
+}
+interface StyleRun<T> {
+  readonly count: number;
+  readonly properties: T;
+}
+interface StyleTextProps {
+  readonly paragraphRuns: readonly StyleRun<ParagraphProperties>[];
+  readonly characterRuns: readonly StyleRun<CharacterProperties>[];
+}
+declare function readStyleTextPropAtom(record: PptRecord, characterCount: number): StyleTextProps;
+//#endregion
+export { ALIGN_CENTER, ALIGN_DISTRIBUTED, ALIGN_JUSTIFY, ALIGN_JUSTIFY_LOW, ALIGN_LEFT, ALIGN_RIGHT, ALIGN_THAI_DISTRIBUTED, CharacterProperties, ParagraphProperties, RgbColor, StyleRun, StyleTextProps, readStyleTextPropAtom };

package/dist/text/style.d.ts

@@ -0,0 +1,39 @@
+import { t as PptRecord } from "../tree-PMcPNgd-.js";
+//#region src/text/style.d.ts
+declare const ALIGN_LEFT = 0;
+declare const ALIGN_CENTER = 1;
+declare const ALIGN_RIGHT = 2;
+declare const ALIGN_JUSTIFY = 3;
+declare const ALIGN_DISTRIBUTED = 4;
+declare const ALIGN_THAI_DISTRIBUTED = 5;
+declare const ALIGN_JUSTIFY_LOW = 6;
+interface RgbColor {
+  readonly red: number;
+  readonly green: number;
+  readonly blue: number;
+}
+interface ParagraphProperties {
+  readonly indentLevel: number;
+  readonly alignment: number | undefined;
+}
+interface CharacterProperties {
+  readonly bold: boolean | undefined;
+  readonly italic: boolean | undefined;
+  readonly underline: boolean | undefined;
+  readonly shadow: boolean | undefined;
+  readonly emboss: boolean | undefined;
+  readonly fontRef: number | undefined;
+  readonly sizePt: number | undefined;
+  readonly color: RgbColor | undefined;
+}
+interface StyleRun<T> {
+  readonly count: number;
+  readonly properties: T;
+}
+interface StyleTextProps {
+  readonly paragraphRuns: readonly StyleRun<ParagraphProperties>[];
+  readonly characterRuns: readonly StyleRun<CharacterProperties>[];
+}
+declare function readStyleTextPropAtom(record: PptRecord, characterCount: number): StyleTextProps;
+//#endregion
+export { ALIGN_CENTER, ALIGN_DISTRIBUTED, ALIGN_JUSTIFY, ALIGN_JUSTIFY_LOW, ALIGN_LEFT, ALIGN_RIGHT, ALIGN_THAI_DISTRIBUTED, CharacterProperties, ParagraphProperties, RgbColor, StyleRun, StyleTextProps, readStyleTextPropAtom };

package/dist/text/style.js

@@ -0,0 +1,165 @@
+import { PptFormatError } from "../errors.js";
+import { RT_StyleTextPropAtom } from "../record/types.js";
+//#region src/text/style.ts
+const ALIGN_LEFT = 0;
+const ALIGN_CENTER = 1;
+const ALIGN_RIGHT = 2;
+const ALIGN_JUSTIFY = 3;
+const ALIGN_DISTRIBUTED = 4;
+const ALIGN_THAI_DISTRIBUTED = 5;
+const ALIGN_JUSTIFY_LOW = 6;
+const PF_BULLET_FONT = 16;
+const PF_BULLET_COLOR = 32;
+const PF_BULLET_SIZE = 64;
+const PF_BULLET_CHAR = 128;
+const PF_LEFT_MARGIN = 256;
+const PF_INDENT = 1024;
+const PF_ALIGN = 2048;
+const PF_LINE_SPACING = 4096;
+const PF_SPACE_BEFORE = 8192;
+const PF_SPACE_AFTER = 16384;
+const PF_DEFAULT_TAB_SIZE = 32768;
+const PF_FONT_ALIGN = 65536;
+const PF_TAB_STOPS = 1 << 20;
+const PF_TEXT_DIRECTION = 1 << 21;
+const CF_BOLD = 1;
+const CF_ITALIC = 2;
+const CF_UNDERLINE = 4;
+const CF_SHADOW = 16;
+const CF_EMBOSS = 512;
+const CF_TYPEFACE = 65536;
+const CF_SIZE = 1 << 17;
+const CF_COLOR = 1 << 18;
+const CF_POSITION = 1 << 19;
+const CF_OLD_EA_TYPEFACE = 1 << 21;
+const CF_ANSI_TYPEFACE = 1 << 22;
+const CF_SYMBOL_TYPEFACE = 1 << 23;
+const STYLE_BOLD = 1;
+const STYLE_ITALIC = 2;
+const STYLE_UNDERLINE = 4;
+const STYLE_SHADOW = 16;
+const STYLE_EMBOSS = 512;
+const COLOR_INDEX_SRGB = 254;
+var FieldCursor = class {
+	data;
+	describe;
+	at;
+	view;
+	constructor(data, start, describe) {
+		this.data = data;
+		this.describe = describe;
+		this.at = start;
+		this.view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	}
+	get offset() {
+		return this.at;
+	}
+	require(size) {
+		if (this.at + size > this.data.length) throw new PptFormatError(`${this.describe} needs ${size} more bytes at offset ${this.at} but the atom holds only ${this.data.length}`);
+		const at = this.at;
+		this.at += size;
+		return at;
+	}
+	u16() {
+		return this.view.getUint16(this.require(2), true);
+	}
+	i16() {
+		return this.view.getInt16(this.require(2), true);
+	}
+	u32() {
+		return this.view.getUint32(this.require(4), true);
+	}
+	bytes(size) {
+		const at = this.require(size);
+		return this.data.subarray(at, at + size);
+	}
+	skip(size) {
+		this.require(size);
+	}
+};
+function readColorIndexStruct(cursor) {
+	const [red, green, blue, index] = cursor.bytes(4);
+	if (red === void 0 || green === void 0 || blue === void 0 || index === void 0) throw new PptFormatError("ColorIndexStruct read returned fewer than its four bytes");
+	return index === COLOR_INDEX_SRGB ? {
+		red,
+		green,
+		blue
+	} : void 0;
+}
+function readTextPFException(cursor, indentLevel) {
+	const masks = cursor.u32();
+	if ((masks & 15) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_CHAR) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_FONT) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_SIZE) !== 0) cursor.skip(2);
+	if ((masks & PF_BULLET_COLOR) !== 0) cursor.skip(4);
+	const alignment = (masks & PF_ALIGN) !== 0 ? cursor.u16() : void 0;
+	for (const mask of [
+		PF_LINE_SPACING,
+		PF_SPACE_BEFORE,
+		PF_SPACE_AFTER,
+		PF_LEFT_MARGIN,
+		PF_INDENT,
+		PF_DEFAULT_TAB_SIZE
+	]) if ((masks & mask) !== 0) cursor.skip(2);
+	if ((masks & PF_TAB_STOPS) !== 0) cursor.skip(cursor.u16() * 4);
+	if ((masks & PF_FONT_ALIGN) !== 0) cursor.skip(2);
+	if ((masks & 917504) !== 0) cursor.skip(2);
+	if ((masks & PF_TEXT_DIRECTION) !== 0) cursor.skip(2);
+	return {
+		indentLevel,
+		alignment
+	};
+}
+function styleFlag(masks, maskBit, fontStyle, styleBit) {
+	if ((masks & maskBit) === 0 || fontStyle === void 0) return;
+	return (fontStyle & styleBit) !== 0;
+}
+function readTextCFException(cursor) {
+	const masks = cursor.u32();
+	const fontStyle = (masks & 16055) !== 0 ? cursor.u16() : void 0;
+	const fontRef = (masks & CF_TYPEFACE) !== 0 ? cursor.u16() : void 0;
+	if ((masks & CF_OLD_EA_TYPEFACE) !== 0) cursor.skip(2);
+	if ((masks & CF_ANSI_TYPEFACE) !== 0) cursor.skip(2);
+	if ((masks & CF_SYMBOL_TYPEFACE) !== 0) cursor.skip(2);
+	const sizePt = (masks & CF_SIZE) !== 0 ? cursor.i16() : void 0;
+	const color = (masks & CF_COLOR) !== 0 ? readColorIndexStruct(cursor) : void 0;
+	if ((masks & CF_POSITION) !== 0) cursor.skip(2);
+	return {
+		bold: styleFlag(masks, CF_BOLD, fontStyle, STYLE_BOLD),
+		italic: styleFlag(masks, CF_ITALIC, fontStyle, STYLE_ITALIC),
+		underline: styleFlag(masks, CF_UNDERLINE, fontStyle, STYLE_UNDERLINE),
+		shadow: styleFlag(masks, CF_SHADOW, fontStyle, STYLE_SHADOW),
+		emboss: styleFlag(masks, CF_EMBOSS, fontStyle, STYLE_EMBOSS),
+		fontRef,
+		sizePt,
+		color
+	};
+}
+function readRuns(cursor, characterCount, describe, readProperties) {
+	const runs = [];
+	let covered = 0;
+	while (covered < characterCount) {
+		const count = cursor.u32();
+		const properties = readProperties(cursor);
+		covered += count;
+		if (covered > characterCount) throw new PptFormatError(`${describe} cover ${covered} characters, more than the ${characterCount} in the corresponding text body`);
+		runs.push({
+			count,
+			properties
+		});
+	}
+	return runs;
+}
+function readStyleTextPropAtom(record, characterCount) {
+	if (record.header.recType !== 4001) throw new PptFormatError(`expected RT_StyleTextPropAtom (0x${RT_StyleTextPropAtom.toString(16)}), found record type 0x${record.header.recType.toString(16)}`);
+	const cursor = new FieldCursor(record.data, 0, "StyleTextPropAtom");
+	return {
+		paragraphRuns: readRuns(cursor, characterCount, "StyleTextPropAtom paragraph runs", (at) => {
+			return readTextPFException(at, at.u16());
+		}),
+		characterRuns: readRuns(cursor, characterCount, "StyleTextPropAtom character runs", readTextCFException)
+	};
+}
+//#endregion
+export { ALIGN_CENTER, ALIGN_DISTRIBUTED, ALIGN_JUSTIFY, ALIGN_JUSTIFY_LOW, ALIGN_LEFT, ALIGN_RIGHT, ALIGN_THAI_DISTRIBUTED, readStyleTextPropAtom };

package/dist/tree-Du_LXAF0.d.cts

@@ -0,0 +1,17 @@
+import { r as RecordHeader } from "./header-C5eAd16_.cjs";
+//#region src/record/tree.d.ts
+interface PptRecord {
+  readonly header: RecordHeader;
+  readonly offset: number;
+  readonly dataOffset: number;
+  readonly data: Uint8Array<ArrayBuffer>;
+  readonly stream: Uint8Array<ArrayBuffer>;
+}
+declare function readRecordAt(bytes: Uint8Array<ArrayBuffer>, offset: number): PptRecord;
+declare function readRecordSequence(bytes: Uint8Array<ArrayBuffer>, start: number, end: number): PptRecord[];
+declare function childRecords(record: PptRecord): PptRecord[];
+declare function findChild(records: readonly PptRecord[], recType: number): PptRecord | undefined;
+declare function findChildren(records: readonly PptRecord[], recType: number): PptRecord[];
+declare function findDescendants(root: PptRecord, recType: number): PptRecord[];
+//#endregion
+export { findDescendants as a, findChildren as i, childRecords as n, readRecordAt as o, findChild as r, readRecordSequence as s, PptRecord as t };

package/dist/tree-PMcPNgd-.d.ts

@@ -0,0 +1,17 @@
+import { r as RecordHeader } from "./header-C5eAd16_.js";
+//#region src/record/tree.d.ts
+interface PptRecord {
+  readonly header: RecordHeader;
+  readonly offset: number;
+  readonly dataOffset: number;
+  readonly data: Uint8Array<ArrayBuffer>;
+  readonly stream: Uint8Array<ArrayBuffer>;
+}
+declare function readRecordAt(bytes: Uint8Array<ArrayBuffer>, offset: number): PptRecord;
+declare function readRecordSequence(bytes: Uint8Array<ArrayBuffer>, start: number, end: number): PptRecord[];
+declare function childRecords(record: PptRecord): PptRecord[];
+declare function findChild(records: readonly PptRecord[], recType: number): PptRecord | undefined;
+declare function findChildren(records: readonly PptRecord[], recType: number): PptRecord[];
+declare function findDescendants(root: PptRecord, recType: number): PptRecord[];
+//#endregion
+export { findDescendants as a, findChildren as i, childRecords as n, readRecordAt as o, findChild as r, readRecordSequence as s, PptRecord as t };

package/dist/units.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/units.ts
+const MASTER_UNITS_PER_INCH = 576;
+const POINTS_PER_INCH = 72;
+const MASTER_UNITS_PER_POINT = MASTER_UNITS_PER_INCH / 72;
+function masterUnitsToPoints(masterUnits) {
+	return masterUnits / 8;
+}
+//#endregion
+exports.MASTER_UNITS_PER_POINT = MASTER_UNITS_PER_POINT;
+exports.POINTS_PER_INCH = POINTS_PER_INCH;
+exports.masterUnitsToPoints = masterUnitsToPoints;

package/dist/units.d.cts

@@ -0,0 +1,6 @@
+//#region src/units.d.ts
+declare const POINTS_PER_INCH = 72;
+declare const MASTER_UNITS_PER_POINT: number;
+declare function masterUnitsToPoints(masterUnits: number): number;
+//#endregion
+export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints };

package/dist/units.d.ts

@@ -0,0 +1,6 @@
+//#region src/units.d.ts
+declare const POINTS_PER_INCH = 72;
+declare const MASTER_UNITS_PER_POINT: number;
+declare function masterUnitsToPoints(masterUnits: number): number;
+//#endregion
+export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints };

package/dist/units.js

@@ -0,0 +1,9 @@
+//#region src/units.ts
+const MASTER_UNITS_PER_INCH = 576;
+const POINTS_PER_INCH = 72;
+const MASTER_UNITS_PER_POINT = MASTER_UNITS_PER_INCH / 72;
+function masterUnitsToPoints(masterUnits) {
+	return masterUnits / 8;
+}
+//#endregion
+export { MASTER_UNITS_PER_POINT, POINTS_PER_INCH, masterUnitsToPoints };

package/package.json

@@ -1,5 +1,96 @@
 {
   "name": "ppt-codec",
-  "version": "0.0.0",
-  "private": false
+  "version": "1.0.1",
+  "description": "Hand-written PowerPoint 97-2003 binary (.ppt, [MS-PPT]) reader against the shared document-schema.js content pivot.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ExaDev/documents.js.git",
+    "directory": "packages/ppt-codec"
+  },
+  "homepage": "https://github.com/ExaDev/documents.js/tree/main/packages/ppt-codec",
+  "bugs": {
+    "url": "https://github.com/ExaDev/documents.js/issues"
+  },
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": {
+        "import": "./dist/*.d.ts",
+        "require": "./dist/*.d.cts"
+      },
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "turbo run _build",
+    "_build": "tsdown",
+    "prepublishOnly": "pnpm run lint && pnpm run typecheck && tsdown && publint && attw --pack",
+    "lint": "turbo run _lint",
+    "_lint": "eslint . --fix --cache --max-warnings 0",
+    "lint:check": "eslint . --max-warnings 0",
+    "typecheck": "turbo run _typecheck _typecheck:attw",
+    "_typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.node.json",
+    "_typecheck:attw": "attw --pack",
+    "test": "turbo run _test",
+    "_test": "vitest run --project unit",
+    "test:watch": "vitest --project unit",
+    "test:workers": "turbo run _test:workers",
+    "_test:workers": "vitest run --config vitest.workers.config.ts",
+    "test:smoke": "turbo run _test:smoke",
+    "_test:smoke": "vitest run --project smoke",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "ppt",
+    "powerpoint",
+    "ms-ppt",
+    "binary",
+    "codec",
+    "presentation"
+  ],
+  "license": "MIT",
+  "packageManager": "pnpm@11.6.0",
+  "dependencies": {
+    "archive-codec": "^1.3.0",
+    "document-schema.js": "^5.4.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@cloudflare/vitest-pool-workers": "^0.20.1",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.0",
+    "husky": "^9.1.7",
+    "publint": "^0.3.21",
+    "tsdown": "^0.22.13",
+    "turbo": "^2.10.8",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
+  "lint-staged": {
+    "*.ts": "eslint --fix"
+  }
 }