doc-codec 1.0.2 → 1.1.1

package/dist/color.cjs

@@ -0,0 +1,166 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("./errors.cjs");
+const require_bytes = require("./bytes.cjs");
+//#region src/color.ts
+const COLOR_COMPONENT_MAX = 255;
+const ICO_PALETTE = [
+	void 0,
+	[
+		0,
+		0,
+		0
+	],
+	[
+		0,
+		0,
+		255
+	],
+	[
+		0,
+		255,
+		255
+	],
+	[
+		0,
+		255,
+		0
+	],
+	[
+		255,
+		0,
+		255
+	],
+	[
+		255,
+		0,
+		0
+	],
+	[
+		255,
+		255,
+		0
+	],
+	[
+		255,
+		255,
+		255
+	],
+	[
+		0,
+		0,
+		128
+	],
+	[
+		0,
+		128,
+		128
+	],
+	[
+		0,
+		128,
+		0
+	],
+	[
+		128,
+		0,
+		128
+	],
+	[
+		128,
+		0,
+		128
+	],
+	[
+		128,
+		128,
+		0
+	],
+	[
+		128,
+		128,
+		128
+	],
+	[
+		192,
+		192,
+		192
+	]
+];
+/** The first Ico value naming a concrete colour: 0x00 is cvAuto and names none, so nearestIco never returns it. */
+const FIRST_CONCRETE_ICO = 1;
+/** The colour an Ico value names, or undefined for 0x00 (fAuto, "the default color for the application", which names no concrete colour). Throws for a value outside the palette's own published bound rather than resolving it to something. */
+function icoColor(value) {
+	if (value >= ICO_PALETTE.length) throw new require_errors.DocFormatError(`Ico value 0x${value.toString(16)} is not less than 0x11, the bound [MS-DOC] 2.9.119 places on the palette`);
+	const entry = ICO_PALETTE[value];
+	if (entry === void 0) return void 0;
+	const [r, g, b] = entry;
+	return {
+		r: r / COLOR_COMPONENT_MAX,
+		g: g / COLOR_COMPONENT_MAX,
+		b: b / COLOR_COMPONENT_MAX
+	};
+}
+/** icoColor's own decorative counterpart: an out-of-range Ico value resolves to undefined (the same "no concrete colour" spelling 0x00/cvAuto already carries) rather than throwing. icoColor's hard bound stays exactly as it is for a run's sprmCIco, where an out-of-range value states a specific, load-bearing colour this reader must not silently drop -- but Brc80.ico and Shd80's icoFore/icoBack (table/decoration.ts) are cosmetic fields already reached through a chain of automatic-colour fallbacks of their own (borderFrom's own AUTOMATIC_BORDER_COLOR, readShd80's own undefined return for an unrecognised pattern), so one out-of-range byte in a single cell's border or fill should not abort reading the entire document the way it correctly does for a run's own explicit, load-bearing colour. */
+function decorativeIcoColor(value) {
+	return value >= ICO_PALETTE.length ? void 0 : icoColor(value);
+}
+/**
+* The Ico value whose own colour is closest to `color`, by squared distance in sRGB, over the sixteen entries that name a concrete colour -- 0x00 (cvAuto) is never returned, since it names none. Ties resolve to the lower Ico, which makes the answer depend only on the colour asked about and not on iteration order (it also settles 0x0C/0x0D, the one duplicated pair in the published palette, on 0x0C).
+*
+* This is a genuinely lossy quantisation and is only ever used where [MS-DOC] itself offers no better field: Brc80.ico, the border colour a TC80 can carry at all. Wherever the format has an exact spelling beside it -- Brc.cv, reached through sprmTSetBrc -- this package writes that too, so nothing downstream has to read the approximation back (see table/decoration.ts and the README's own Tables section).
+*/
+function nearestIco(color) {
+	let best = FIRST_CONCRETE_ICO;
+	let bestDistance = Number.POSITIVE_INFINITY;
+	for (let value = FIRST_CONCRETE_ICO; value < ICO_PALETTE.length; value += 1) {
+		const entry = ICO_PALETTE[value];
+		if (entry === void 0) continue;
+		const [r, g, b] = entry;
+		const dr = color.r - r / COLOR_COMPONENT_MAX;
+		const dg = color.g - g / COLOR_COMPONENT_MAX;
+		const db = color.b - b / COLOR_COMPONENT_MAX;
+		const distance = dr * dr + dg * dg + db * db;
+		if (distance < bestDistance) {
+			bestDistance = distance;
+			best = value;
+		}
+	}
+	return best;
+}
+/** COLORREF's fAuto, [MS-DOC] 2.9.43: "If fAuto is 0xFF, this COLORREF designates the default color for the application", which the specification names cvAuto. */
+const F_AUTO_SET = 255;
+/** COLORREF, [MS-DOC] 2.9.43: red, green and blue bytes followed by fAuto. Returns undefined for cvAuto (fAuto set), which designates the application's own default colour rather than the components beside it -- the caller decides what that means for the property it is reading. */
+function readColorRef(bytes, offset) {
+	if (require_bytes.readUint8(bytes, offset + 3) !== 0) return void 0;
+	return {
+		r: require_bytes.readUint8(bytes, offset) / COLOR_COMPONENT_MAX,
+		g: require_bytes.readUint8(bytes, offset + 1) / COLOR_COMPONENT_MAX,
+		b: require_bytes.readUint8(bytes, offset + 2) / COLOR_COMPONENT_MAX
+	};
+}
+/** The inverse of readColorRef for a concrete colour: red, green, blue, then fAuto 0x00 ("use these components"), the only form this package writes. */
+function colorRefBytes(color) {
+	const byte = (component) => Math.round(component * COLOR_COMPONENT_MAX);
+	return [
+		byte(color.r),
+		byte(color.g),
+		byte(color.b),
+		0
+	];
+}
+/** cvAuto's own four bytes, [MS-DOC] 2.9.43: components zeroed with fAuto set. Written wherever a COLORREF field exists but this package has no colour to state for it -- a Shd's own cvFore under an ipatAuto pattern, for instance. */
+function autoColorRefBytes() {
+	return [
+		0,
+		0,
+		0,
+		F_AUTO_SET
+	];
+}
+//#endregion
+exports.autoColorRefBytes = autoColorRefBytes;
+exports.colorRefBytes = colorRefBytes;
+exports.decorativeIcoColor = decorativeIcoColor;
+exports.icoColor = icoColor;
+exports.nearestIco = nearestIco;
+exports.readColorRef = readColorRef;

package/dist/color.d.cts

@@ -0,0 +1,20 @@
+import { Color } from "document-schema.js";
+//#region src/color.d.ts
+/** The colour an Ico value names, or undefined for 0x00 (fAuto, "the default color for the application", which names no concrete colour). Throws for a value outside the palette's own published bound rather than resolving it to something. */
+declare function icoColor(value: number): Color | undefined;
+/** icoColor's own decorative counterpart: an out-of-range Ico value resolves to undefined (the same "no concrete colour" spelling 0x00/cvAuto already carries) rather than throwing. icoColor's hard bound stays exactly as it is for a run's sprmCIco, where an out-of-range value states a specific, load-bearing colour this reader must not silently drop -- but Brc80.ico and Shd80's icoFore/icoBack (table/decoration.ts) are cosmetic fields already reached through a chain of automatic-colour fallbacks of their own (borderFrom's own AUTOMATIC_BORDER_COLOR, readShd80's own undefined return for an unrecognised pattern), so one out-of-range byte in a single cell's border or fill should not abort reading the entire document the way it correctly does for a run's own explicit, load-bearing colour. */
+declare function decorativeIcoColor(value: number): Color | undefined;
+/**
+ * The Ico value whose own colour is closest to `color`, by squared distance in sRGB, over the sixteen entries that name a concrete colour -- 0x00 (cvAuto) is never returned, since it names none. Ties resolve to the lower Ico, which makes the answer depend only on the colour asked about and not on iteration order (it also settles 0x0C/0x0D, the one duplicated pair in the published palette, on 0x0C).
+ *
+ * This is a genuinely lossy quantisation and is only ever used where [MS-DOC] itself offers no better field: Brc80.ico, the border colour a TC80 can carry at all. Wherever the format has an exact spelling beside it -- Brc.cv, reached through sprmTSetBrc -- this package writes that too, so nothing downstream has to read the approximation back (see table/decoration.ts and the README's own Tables section).
+ */
+declare function nearestIco(color: Color): number;
+/** COLORREF, [MS-DOC] 2.9.43: red, green and blue bytes followed by fAuto. Returns undefined for cvAuto (fAuto set), which designates the application's own default colour rather than the components beside it -- the caller decides what that means for the property it is reading. */
+declare function readColorRef(bytes: Uint8Array, offset: number): Color | undefined;
+/** The inverse of readColorRef for a concrete colour: red, green, blue, then fAuto 0x00 ("use these components"), the only form this package writes. */
+declare function colorRefBytes(color: Color): number[];
+/** cvAuto's own four bytes, [MS-DOC] 2.9.43: components zeroed with fAuto set. Written wherever a COLORREF field exists but this package has no colour to state for it -- a Shd's own cvFore under an ipatAuto pattern, for instance. */
+declare function autoColorRefBytes(): number[];
+//#endregion
+export { autoColorRefBytes, colorRefBytes, decorativeIcoColor, icoColor, nearestIco, readColorRef };

package/dist/color.d.ts

@@ -0,0 +1,20 @@
+import { Color } from "document-schema.js";
+//#region src/color.d.ts
+/** The colour an Ico value names, or undefined for 0x00 (fAuto, "the default color for the application", which names no concrete colour). Throws for a value outside the palette's own published bound rather than resolving it to something. */
+declare function icoColor(value: number): Color | undefined;
+/** icoColor's own decorative counterpart: an out-of-range Ico value resolves to undefined (the same "no concrete colour" spelling 0x00/cvAuto already carries) rather than throwing. icoColor's hard bound stays exactly as it is for a run's sprmCIco, where an out-of-range value states a specific, load-bearing colour this reader must not silently drop -- but Brc80.ico and Shd80's icoFore/icoBack (table/decoration.ts) are cosmetic fields already reached through a chain of automatic-colour fallbacks of their own (borderFrom's own AUTOMATIC_BORDER_COLOR, readShd80's own undefined return for an unrecognised pattern), so one out-of-range byte in a single cell's border or fill should not abort reading the entire document the way it correctly does for a run's own explicit, load-bearing colour. */
+declare function decorativeIcoColor(value: number): Color | undefined;
+/**
+ * The Ico value whose own colour is closest to `color`, by squared distance in sRGB, over the sixteen entries that name a concrete colour -- 0x00 (cvAuto) is never returned, since it names none. Ties resolve to the lower Ico, which makes the answer depend only on the colour asked about and not on iteration order (it also settles 0x0C/0x0D, the one duplicated pair in the published palette, on 0x0C).
+ *
+ * This is a genuinely lossy quantisation and is only ever used where [MS-DOC] itself offers no better field: Brc80.ico, the border colour a TC80 can carry at all. Wherever the format has an exact spelling beside it -- Brc.cv, reached through sprmTSetBrc -- this package writes that too, so nothing downstream has to read the approximation back (see table/decoration.ts and the README's own Tables section).
+ */
+declare function nearestIco(color: Color): number;
+/** COLORREF, [MS-DOC] 2.9.43: red, green and blue bytes followed by fAuto. Returns undefined for cvAuto (fAuto set), which designates the application's own default colour rather than the components beside it -- the caller decides what that means for the property it is reading. */
+declare function readColorRef(bytes: Uint8Array, offset: number): Color | undefined;
+/** The inverse of readColorRef for a concrete colour: red, green, blue, then fAuto 0x00 ("use these components"), the only form this package writes. */
+declare function colorRefBytes(color: Color): number[];
+/** cvAuto's own four bytes, [MS-DOC] 2.9.43: components zeroed with fAuto set. Written wherever a COLORREF field exists but this package has no colour to state for it -- a Shd's own cvFore under an ipatAuto pattern, for instance. */
+declare function autoColorRefBytes(): number[];
+//#endregion
+export { autoColorRefBytes, colorRefBytes, decorativeIcoColor, icoColor, nearestIco, readColorRef };

package/dist/color.js

@@ -0,0 +1,160 @@
+import { DocFormatError } from "./errors.js";
+import { readUint8 } from "./bytes.js";
+//#region src/color.ts
+const COLOR_COMPONENT_MAX = 255;
+const ICO_PALETTE = [
+	void 0,
+	[
+		0,
+		0,
+		0
+	],
+	[
+		0,
+		0,
+		255
+	],
+	[
+		0,
+		255,
+		255
+	],
+	[
+		0,
+		255,
+		0
+	],
+	[
+		255,
+		0,
+		255
+	],
+	[
+		255,
+		0,
+		0
+	],
+	[
+		255,
+		255,
+		0
+	],
+	[
+		255,
+		255,
+		255
+	],
+	[
+		0,
+		0,
+		128
+	],
+	[
+		0,
+		128,
+		128
+	],
+	[
+		0,
+		128,
+		0
+	],
+	[
+		128,
+		0,
+		128
+	],
+	[
+		128,
+		0,
+		128
+	],
+	[
+		128,
+		128,
+		0
+	],
+	[
+		128,
+		128,
+		128
+	],
+	[
+		192,
+		192,
+		192
+	]
+];
+/** The first Ico value naming a concrete colour: 0x00 is cvAuto and names none, so nearestIco never returns it. */
+const FIRST_CONCRETE_ICO = 1;
+/** The colour an Ico value names, or undefined for 0x00 (fAuto, "the default color for the application", which names no concrete colour). Throws for a value outside the palette's own published bound rather than resolving it to something. */
+function icoColor(value) {
+	if (value >= ICO_PALETTE.length) throw new DocFormatError(`Ico value 0x${value.toString(16)} is not less than 0x11, the bound [MS-DOC] 2.9.119 places on the palette`);
+	const entry = ICO_PALETTE[value];
+	if (entry === void 0) return void 0;
+	const [r, g, b] = entry;
+	return {
+		r: r / COLOR_COMPONENT_MAX,
+		g: g / COLOR_COMPONENT_MAX,
+		b: b / COLOR_COMPONENT_MAX
+	};
+}
+/** icoColor's own decorative counterpart: an out-of-range Ico value resolves to undefined (the same "no concrete colour" spelling 0x00/cvAuto already carries) rather than throwing. icoColor's hard bound stays exactly as it is for a run's sprmCIco, where an out-of-range value states a specific, load-bearing colour this reader must not silently drop -- but Brc80.ico and Shd80's icoFore/icoBack (table/decoration.ts) are cosmetic fields already reached through a chain of automatic-colour fallbacks of their own (borderFrom's own AUTOMATIC_BORDER_COLOR, readShd80's own undefined return for an unrecognised pattern), so one out-of-range byte in a single cell's border or fill should not abort reading the entire document the way it correctly does for a run's own explicit, load-bearing colour. */
+function decorativeIcoColor(value) {
+	return value >= ICO_PALETTE.length ? void 0 : icoColor(value);
+}
+/**
+* The Ico value whose own colour is closest to `color`, by squared distance in sRGB, over the sixteen entries that name a concrete colour -- 0x00 (cvAuto) is never returned, since it names none. Ties resolve to the lower Ico, which makes the answer depend only on the colour asked about and not on iteration order (it also settles 0x0C/0x0D, the one duplicated pair in the published palette, on 0x0C).
+*
+* This is a genuinely lossy quantisation and is only ever used where [MS-DOC] itself offers no better field: Brc80.ico, the border colour a TC80 can carry at all. Wherever the format has an exact spelling beside it -- Brc.cv, reached through sprmTSetBrc -- this package writes that too, so nothing downstream has to read the approximation back (see table/decoration.ts and the README's own Tables section).
+*/
+function nearestIco(color) {
+	let best = FIRST_CONCRETE_ICO;
+	let bestDistance = Number.POSITIVE_INFINITY;
+	for (let value = FIRST_CONCRETE_ICO; value < ICO_PALETTE.length; value += 1) {
+		const entry = ICO_PALETTE[value];
+		if (entry === void 0) continue;
+		const [r, g, b] = entry;
+		const dr = color.r - r / COLOR_COMPONENT_MAX;
+		const dg = color.g - g / COLOR_COMPONENT_MAX;
+		const db = color.b - b / COLOR_COMPONENT_MAX;
+		const distance = dr * dr + dg * dg + db * db;
+		if (distance < bestDistance) {
+			bestDistance = distance;
+			best = value;
+		}
+	}
+	return best;
+}
+/** COLORREF's fAuto, [MS-DOC] 2.9.43: "If fAuto is 0xFF, this COLORREF designates the default color for the application", which the specification names cvAuto. */
+const F_AUTO_SET = 255;
+/** COLORREF, [MS-DOC] 2.9.43: red, green and blue bytes followed by fAuto. Returns undefined for cvAuto (fAuto set), which designates the application's own default colour rather than the components beside it -- the caller decides what that means for the property it is reading. */
+function readColorRef(bytes, offset) {
+	if (readUint8(bytes, offset + 3) !== 0) return void 0;
+	return {
+		r: readUint8(bytes, offset) / COLOR_COMPONENT_MAX,
+		g: readUint8(bytes, offset + 1) / COLOR_COMPONENT_MAX,
+		b: readUint8(bytes, offset + 2) / COLOR_COMPONENT_MAX
+	};
+}
+/** The inverse of readColorRef for a concrete colour: red, green, blue, then fAuto 0x00 ("use these components"), the only form this package writes. */
+function colorRefBytes(color) {
+	const byte = (component) => Math.round(component * COLOR_COMPONENT_MAX);
+	return [
+		byte(color.r),
+		byte(color.g),
+		byte(color.b),
+		0
+	];
+}
+/** cvAuto's own four bytes, [MS-DOC] 2.9.43: components zeroed with fAuto set. Written wherever a COLORREF field exists but this package has no colour to state for it -- a Shd's own cvFore under an ipatAuto pattern, for instance. */
+function autoColorRefBytes() {
+	return [
+		0,
+		0,
+		0,
+		F_AUTO_SET
+	];
+}
+//#endregion
+export { autoColorRefBytes, colorRefBytes, decorativeIcoColor, icoColor, nearestIco, readColorRef };

package/dist/detect.cjs

@@ -5,6 +5,8 @@ let archive_codec = require("archive-codec");
 //#region src/detect.ts
 /** The stream a Word Binary File's FIB and text live in, [MS-DOC] 2.1.1. */
 const WORD_DOCUMENT_STREAM = "WordDocument";
+/** The [MS-OLEPS] Property Set Stream a .doc's title/author/dates live in when present -- a genuinely optional stream, unlike WordDocument, since a valid Word Binary File need not carry document properties at all. */
+const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 function isDocBytes(bytes) {
 	if (!(0, archive_codec.isCompoundFile)(bytes)) return false;
 	let streams;
@@ -18,5 +20,6 @@ function isDocBytes(bytes) {
 	return require_bytes.readUint16LE(wordDocument.bytes, 0) === require_fib_offsets.FIB_W_IDENT;
 }
 //#endregion
+exports.SUMMARY_INFORMATION_STREAM = SUMMARY_INFORMATION_STREAM;
 exports.WORD_DOCUMENT_STREAM = WORD_DOCUMENT_STREAM;
 exports.isDocBytes = isDocBytes;

package/dist/detect.d.cts

@@ -1,6 +1,8 @@
 //#region src/detect.d.ts
 /** The stream a Word Binary File's FIB and text live in, [MS-DOC] 2.1.1. */
 declare const WORD_DOCUMENT_STREAM = "WordDocument";
+/** The [MS-OLEPS] Property Set Stream a .doc's title/author/dates live in when present -- a genuinely optional stream, unlike WordDocument, since a valid Word Binary File need not carry document properties at all. */
+declare const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 declare function isDocBytes(bytes: Uint8Array<ArrayBuffer>): boolean;
 //#endregion
-export { WORD_DOCUMENT_STREAM, isDocBytes };
+export { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes };

package/dist/detect.d.ts

@@ -1,6 +1,8 @@
 //#region src/detect.d.ts
 /** The stream a Word Binary File's FIB and text live in, [MS-DOC] 2.1.1. */
 declare const WORD_DOCUMENT_STREAM = "WordDocument";
+/** The [MS-OLEPS] Property Set Stream a .doc's title/author/dates live in when present -- a genuinely optional stream, unlike WordDocument, since a valid Word Binary File need not carry document properties at all. */
+declare const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 declare function isDocBytes(bytes: Uint8Array<ArrayBuffer>): boolean;
 //#endregion
-export { WORD_DOCUMENT_STREAM, isDocBytes };
+export { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes };

package/dist/detect.js

@@ -4,6 +4,8 @@ import { isCompoundFile, readCompoundFile } from "archive-codec";
 //#region src/detect.ts
 /** The stream a Word Binary File's FIB and text live in, [MS-DOC] 2.1.1. */
 const WORD_DOCUMENT_STREAM = "WordDocument";
+/** The [MS-OLEPS] Property Set Stream a .doc's title/author/dates live in when present -- a genuinely optional stream, unlike WordDocument, since a valid Word Binary File need not carry document properties at all. */
+const SUMMARY_INFORMATION_STREAM = "SummaryInformation";
 function isDocBytes(bytes) {
 	if (!isCompoundFile(bytes)) return false;
 	let streams;
@@ -17,4 +19,4 @@ function isDocBytes(bytes) {
 	return readUint16LE(wordDocument.bytes, 0) === FIB_W_IDENT;
 }
 //#endregion
-export { WORD_DOCUMENT_STREAM, isDocBytes };
+export { SUMMARY_INFORMATION_STREAM, WORD_DOCUMENT_STREAM, isDocBytes };

package/dist/fib/fib.cjs

@@ -38,7 +38,15 @@ function parseFib(wordDocument) {
 		fcPlcfBtePapx: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlcfBtePapx),
 		lcbPlcfBtePapx: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbPlcfBtePapx),
 		fcClx: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcClx),
-		lcbClx: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbClx)
+		lcbClx: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbClx),
+		fcPlcfSed: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlcfSed),
+		lcbPlcfSed: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbPlcfSed),
+		fcSttbfFfn: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcSttbfFfn),
+		lcbSttbfFfn: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbSttbfFfn),
+		fcPlfLst: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlfLst),
+		lcbPlfLst: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbPlfLst),
+		fcPlfLfo: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlfLfo),
+		lcbPlfLfo: fcLcb(require_fib_offsets.FC_LCB_VALUE_INDEX.lcbPlfLfo)
 	};
 }
 /** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */

package/dist/fib/fib.d.cts

@@ -1,29 +1,2 @@
-//#region src/fib/fib.d.ts
-interface Fib {
-  readonly nFib: number;
-  /** Set when the last save was an incremental ("fast") save. The piece table is what makes such a document readable at all, so this is informational rather than a refusal. */
-  readonly fComplex: boolean;
-  /** 1 selects the "1Table" stream, 0 the "0Table" stream, as the Table stream every fc offset below is relative to. */
-  readonly fWhichTblStm: 0 | 1;
-  readonly cbMac: number;
-  readonly ccpText: number;
-  readonly ccpFtn: number;
-  readonly ccpHdd: number;
-  readonly ccpAtn: number;
-  readonly ccpEdn: number;
-  readonly ccpTxbx: number;
-  readonly ccpHdrTxbx: number;
-  readonly fcStshf: number;
-  readonly lcbStshf: number;
-  readonly fcPlcfBteChpx: number;
-  readonly lcbPlcfBteChpx: number;
-  readonly fcPlcfBtePapx: number;
-  readonly lcbPlcfBtePapx: number;
-  readonly fcClx: number;
-  readonly lcbClx: number;
-}
-declare function parseFib(wordDocument: Uint8Array): Fib;
-/** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */
-declare function tableStreamName(fib: Fib): "0Table" | "1Table";
-//#endregion
+import { n as parseFib, r as tableStreamName, t as Fib } from "../fib-CtsLtF96.cjs";
 export { Fib, parseFib, tableStreamName };

package/dist/fib/fib.d.ts

@@ -1,29 +1,2 @@
-//#region src/fib/fib.d.ts
-interface Fib {
-  readonly nFib: number;
-  /** Set when the last save was an incremental ("fast") save. The piece table is what makes such a document readable at all, so this is informational rather than a refusal. */
-  readonly fComplex: boolean;
-  /** 1 selects the "1Table" stream, 0 the "0Table" stream, as the Table stream every fc offset below is relative to. */
-  readonly fWhichTblStm: 0 | 1;
-  readonly cbMac: number;
-  readonly ccpText: number;
-  readonly ccpFtn: number;
-  readonly ccpHdd: number;
-  readonly ccpAtn: number;
-  readonly ccpEdn: number;
-  readonly ccpTxbx: number;
-  readonly ccpHdrTxbx: number;
-  readonly fcStshf: number;
-  readonly lcbStshf: number;
-  readonly fcPlcfBteChpx: number;
-  readonly lcbPlcfBteChpx: number;
-  readonly fcPlcfBtePapx: number;
-  readonly lcbPlcfBtePapx: number;
-  readonly fcClx: number;
-  readonly lcbClx: number;
-}
-declare function parseFib(wordDocument: Uint8Array): Fib;
-/** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */
-declare function tableStreamName(fib: Fib): "0Table" | "1Table";
-//#endregion
+import { n as parseFib, r as tableStreamName, t as Fib } from "../fib-CtsLtF96.js";
 export { Fib, parseFib, tableStreamName };

package/dist/fib/fib.js

@@ -37,7 +37,15 @@ function parseFib(wordDocument) {
 		fcPlcfBtePapx: fcLcb(FC_LCB_VALUE_INDEX.fcPlcfBtePapx),
 		lcbPlcfBtePapx: fcLcb(FC_LCB_VALUE_INDEX.lcbPlcfBtePapx),
 		fcClx: fcLcb(FC_LCB_VALUE_INDEX.fcClx),
-		lcbClx: fcLcb(FC_LCB_VALUE_INDEX.lcbClx)
+		lcbClx: fcLcb(FC_LCB_VALUE_INDEX.lcbClx),
+		fcPlcfSed: fcLcb(FC_LCB_VALUE_INDEX.fcPlcfSed),
+		lcbPlcfSed: fcLcb(FC_LCB_VALUE_INDEX.lcbPlcfSed),
+		fcSttbfFfn: fcLcb(FC_LCB_VALUE_INDEX.fcSttbfFfn),
+		lcbSttbfFfn: fcLcb(FC_LCB_VALUE_INDEX.lcbSttbfFfn),
+		fcPlfLst: fcLcb(FC_LCB_VALUE_INDEX.fcPlfLst),
+		lcbPlfLst: fcLcb(FC_LCB_VALUE_INDEX.lcbPlfLst),
+		fcPlfLfo: fcLcb(FC_LCB_VALUE_INDEX.fcPlfLfo),
+		lcbPlfLfo: fcLcb(FC_LCB_VALUE_INDEX.lcbPlfLfo)
 	};
 }
 /** The name of the compound-file stream every `fc` offset in the Fib is relative to, selected by FibBase.fWhichTblStm. */

package/dist/fib/offsets.cjs

@@ -30,12 +30,20 @@ const LW_OFFSET = {
 const FC_LCB_VALUE_INDEX = {
 	fcStshf: 2,
 	lcbStshf: 3,
+	fcPlcfSed: 12,
+	lcbPlcfSed: 13,
 	fcPlcfBteChpx: 24,
 	lcbPlcfBteChpx: 25,
 	fcPlcfBtePapx: 26,
 	lcbPlcfBtePapx: 27,
+	fcSttbfFfn: 30,
+	lcbSttbfFfn: 31,
 	fcClx: 66,
-	lcbClx: 67
+	lcbClx: 67,
+	fcPlfLst: 146,
+	lcbPlfLst: 147,
+	fcPlfLfo: 148,
+	lcbPlfLfo: 149
 };
 const FIB_BASE_FLAG = {
 	fComplex: 4,

package/dist/fib/offsets.d.cts

@@ -29,12 +29,20 @@ declare const LW_OFFSET: {
 declare const FC_LCB_VALUE_INDEX: {
   readonly fcStshf: 2;
   readonly lcbStshf: 3;
+  readonly fcPlcfSed: 12;
+  readonly lcbPlcfSed: 13;
   readonly fcPlcfBteChpx: 24;
   readonly lcbPlcfBteChpx: 25;
   readonly fcPlcfBtePapx: 26;
   readonly lcbPlcfBtePapx: 27;
+  readonly fcSttbfFfn: 30;
+  readonly lcbSttbfFfn: 31;
   readonly fcClx: 66;
   readonly lcbClx: 67;
+  readonly fcPlfLst: 146;
+  readonly lcbPlfLst: 147;
+  readonly fcPlfLfo: 148;
+  readonly lcbPlfLfo: 149;
 };
 declare const FIB_BASE_FLAG: {
   readonly fComplex: 4;

package/dist/fib/offsets.d.ts

@@ -29,12 +29,20 @@ declare const LW_OFFSET: {
 declare const FC_LCB_VALUE_INDEX: {
   readonly fcStshf: 2;
   readonly lcbStshf: 3;
+  readonly fcPlcfSed: 12;
+  readonly lcbPlcfSed: 13;
   readonly fcPlcfBteChpx: 24;
   readonly lcbPlcfBteChpx: 25;
   readonly fcPlcfBtePapx: 26;
   readonly lcbPlcfBtePapx: 27;
+  readonly fcSttbfFfn: 30;
+  readonly lcbSttbfFfn: 31;
   readonly fcClx: 66;
   readonly lcbClx: 67;
+  readonly fcPlfLst: 146;
+  readonly lcbPlfLst: 147;
+  readonly fcPlfLfo: 148;
+  readonly lcbPlfLfo: 149;
 };
 declare const FIB_BASE_FLAG: {
   readonly fComplex: 4;

package/dist/fib/offsets.js

@@ -29,12 +29,20 @@ const LW_OFFSET = {
 const FC_LCB_VALUE_INDEX = {
 	fcStshf: 2,
 	lcbStshf: 3,
+	fcPlcfSed: 12,
+	lcbPlcfSed: 13,
 	fcPlcfBteChpx: 24,
 	lcbPlcfBteChpx: 25,
 	fcPlcfBtePapx: 26,
 	lcbPlcfBtePapx: 27,
+	fcSttbfFfn: 30,
+	lcbSttbfFfn: 31,
 	fcClx: 66,
-	lcbClx: 67
+	lcbClx: 67,
+	fcPlfLst: 146,
+	lcbPlfLst: 147,
+	fcPlfLfo: 148,
+	lcbPlfLfo: 149
 };
 const FIB_BASE_FLAG = {
 	fComplex: 4,

package/dist/fib/write.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("../errors.cjs");
+const require_bytes = require("../bytes.cjs");
+const require_fib_offsets = require("./offsets.cjs");
+//#region src/fib/write.ts
+/** [MS-DOC]'s own Fib page: nFib 0x00C1 mandates cbRgFcLcb 0x005D and cswNew 0. */
+const NFIB_WORD_97 = 193;
+const CB_RG_FC_LCB_WORD_97 = 93;
+/** FibBase.nFibBack: "this value SHOULD be 0x00BF" for a document written by an application that does not need older-version compatibility beyond it -- carried verbatim from test-support/fib.ts, which cites the same field. */
+const N_FIB_BACK = 191;
+/** FibBase's own flags word at offset 10: fExtChar "MUST be 1" ([MS-DOC] 2.5.2), independent of fComplex/fWhichTblStm/fEncrypted/fObfuscated (see offsets.ts's own FIB_BASE_FLAG). */
+const FLAG_F_EXT_CHAR = 4096;
+function buildFib(spec) {
+	const bytes = /* @__PURE__ */ new Uint8Array(900);
+	const view = new DataView(bytes.buffer);
+	view.setUint16(0, require_fib_offsets.FIB_W_IDENT, true);
+	view.setUint16(2, NFIB_WORD_97, true);
+	view.setUint16(10, FLAG_F_EXT_CHAR | require_fib_offsets.FIB_BASE_FLAG.fWhichTblStm, true);
+	view.setUint16(12, N_FIB_BACK, true);
+	view.setUint16(32, 14, true);
+	view.setUint16(62, 22, true);
+	const lw = (offset, value) => {
+		view.setInt32(64 + offset, value, true);
+	};
+	lw(require_fib_offsets.LW_OFFSET.cbMac, spec.cbMac);
+	lw(require_fib_offsets.LW_OFFSET.ccpText, spec.ccpText);
+	view.setUint16(152, CB_RG_FC_LCB_WORD_97, true);
+	const pair = (index, fc, lcb) => {
+		const offset = 154 + index * 4;
+		view.setUint32(offset, fc, true);
+		view.setUint32(offset + 4, lcb, true);
+	};
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcStshf, spec.fcStshf, spec.lcbStshf);
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlcfBteChpx, spec.fcPlcfBteChpx, spec.lcbPlcfBteChpx);
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlcfBtePapx, spec.fcPlcfBtePapx, spec.lcbPlcfBtePapx);
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcSttbfFfn, spec.fcSttbfFfn, spec.lcbSttbfFfn);
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcClx, spec.fcClx, spec.lcbClx);
+	pair(require_fib_offsets.FC_LCB_VALUE_INDEX.fcPlcfSed, spec.fcPlcfSed, spec.lcbPlcfSed);
+	if (require_bytes.readUint16LE(bytes, 0) !== 42476) throw new require_errors.DocFormatError("buildFib produced a Fib whose own wIdent does not read back as 0xA5EC; this is an internal defect, not an input error");
+	return bytes;
+}
+//#endregion
+exports.buildFib = buildFib;