/** The handful of `word/settings.xml` flags the renderer consumes. */ export interface DocumentSettings { /** * ECMA-376 §17.15.1.36 — `w:evenAndOddHeaders`. When `true`, even-numbered * pages use the `'even'` header/footer references instead of `'default'`. */ readonly evenAndOddHeaders: boolean; /** * ECMA-376 §17.15.1.35 — `w:compat/w:doNotExpandShiftReturn`. When `true`, a * justified line that ends at a soft line break (`w:br`) is left at its * natural width instead of being stretched to the measure. */ readonly doNotExpandShiftReturn: boolean; /** * ECMA-376 §17.15.1.28 — `w:displayBackgroundShape`. The page background * (§17.2.1 `w:background`) is drawn only when this is set; without it Word * keeps the colour but prints white. */ readonly displayBackgroundShape: boolean; /** * ECMA-376 §17.15.1.38 — `w:gutterAtTop`. The binding space (`w:pgMar * @w:gutter`) is added to the TOP margin rather than the left. */ readonly gutterAtTop: boolean; /** * `w:compat/w:compatSetting @w:name="compatibilityMode"` — the Word version * the document was saved for. Absent means the file predates the setting, * which is the only case where §17.3.1.1's automatic paragraph spacing is * still HTML's 14pt rather than nothing. */ readonly compatibilityMode?: number; } /** The all-defaults {@link DocumentSettings}, returned when no `w:settings` root is found. */ export declare const EMPTY_SETTINGS: DocumentSettings; /** * Parse `word/settings.xml` (ECMA-376 §17.15), extracting only the flags the * renderer needs; everything else (compat, autoSpaceDE, …) is ignored. * * @param data The raw `word/settings.xml` bytes. * @returns The extracted {@link DocumentSettings}, or {@link EMPTY_SETTINGS} when the root is absent. */ export declare function parseSettings(data: Uint8Array): DocumentSettings;