@usejunior/docx-core 0.18.0 → 0.20.1

package/dist/primitives/field_evaluation.d.ts

@@ -0,0 +1,70 @@
+import { type WordFieldKind } from '../shared/field-semantics.js';
+export type FieldRefreshStatus = 'evaluated' | 'dirtied' | 'unchanged' | 'preserved' | 'unsupported';
+/**
+ * Where a field sits in the story it was read from.
+ *
+ * Both ordinals are document-order positions within a single refresh result.
+ * They are not durable identities: inserting an earlier paragraph shifts every
+ * later `paragraphOrdinal`. Use them to correlate an outcome with the XML that
+ * produced it, not to remember a field across edits. `paragraphOrdinal` is
+ * absent for a field that has no `w:p` ancestor.
+ */
+export interface FieldLocator {
+    paragraphOrdinal?: number;
+    fieldOrdinal: number;
+}
+export interface FieldRefreshOutcome {
+    index: number;
+    locator: FieldLocator;
+    kind: WordFieldKind;
+    instruction: string;
+    status: FieldRefreshStatus;
+    target?: string;
+    reason?: string;
+}
+export interface FieldRefreshOptions {
+    markLayoutDependentDirty?: boolean;
+}
+export interface FieldRefreshReport {
+    changed: boolean;
+    outcomes: FieldRefreshOutcome[];
+}
+export interface FieldXmlRefreshResult extends FieldRefreshReport {
+    documentXml: string;
+}
+export interface FieldDocxRefreshResult extends FieldRefreshReport {
+    document: Buffer;
+    /**
+     * Field-bearing parts present in the package that this operation did not
+     * read, such as `word/header1.xml` or `word/footnotes.xml`.
+     */
+    skippedStories: string[];
+}
+export type FieldRefreshErrorCode = 'MALFORMED_FIELD_TOPOLOGY';
+export declare class FieldRefreshError extends Error {
+    readonly code: FieldRefreshErrorCode;
+    constructor(code: FieldRefreshErrorCode, message: string);
+}
+/**
+ * Refresh the deterministic subset of complex fields in a main document story.
+ *
+ * Layout-dependent results are never synthesized. Callers may instead request
+ * `w:dirty="true"` on their begin markers so a layout-capable host recalculates
+ * them when the document is opened.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.51
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.45
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.44
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.42
+ * @see https://github.com/UseJunior/safe-docx/issues/762
+ */
+export declare function refreshDocumentFieldsXml(documentXml: string, options?: FieldRefreshOptions): FieldXmlRefreshResult;
+/**
+ * Refresh supported fields in `word/document.xml` of a DOCX package.
+ *
+ * Only the main story is read. Any other field-bearing part present in the
+ * package is named in `skippedStories`.
+ */
+export declare function refreshDocxFields(document: Buffer, options?: FieldRefreshOptions): Promise<FieldDocxRefreshResult>;
+//# sourceMappingURL=field_evaluation.d.ts.map

package/dist/primitives/field_evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_evaluation.d.ts","sourceRoot":"","sources":["../../src/primitives/field_evaluation.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAItC,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,SAAS,GACT,WAAW,GACX,WAAW,GACX,aAAa,CAAC;AAElB;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAE/D,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;gBAEzB,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM;CAKzD;AAyYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,mBAAwB,GAChC,qBAAqB,CA2FvB;AAkBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/primitives/field_evaluation.js

@@ -0,0 +1,462 @@
+import { DocxArchive } from '../shared/docx/DocxArchive.js';
+import { classifyFieldInstruction, } from '../shared/field-semantics.js';
+import { W_NS } from '../shared/ooxml/namespaces.js';
+import { parseXml, serializeXml } from './xml.js';
+export class FieldRefreshError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'FieldRefreshError';
+        this.code = code;
+    }
+}
+/**
+ * The instruction a reader would act on: the surviving text, or the deleted
+ * text when the whole instruction was struck. Concatenating both views yields a
+ * chimera like `REF Old REF New`, which describes neither revision state.
+ */
+function fieldInstructionView(field) {
+    const current = field.currentInstruction.join('');
+    return current.trim().length > 0 ? current : field.deletedInstruction.join('');
+}
+const REVISION_CONTAINERS = new Set(['ins', 'del', 'moveFrom', 'moveTo']);
+const DELETION_CONTAINERS = new Set(['del', 'moveFrom']);
+function wAttribute(element, localName) {
+    return (element.getAttributeNS(W_NS, localName) ??
+        element.getAttribute(`w:${localName}`));
+}
+function isWordElement(element, localName) {
+    return element.namespaceURI === W_NS && element.localName === localName;
+}
+function elementChildren(node) {
+    const children = [];
+    for (let child = node.firstChild; child; child = child.nextSibling) {
+        if (child.nodeType === 1)
+            children.push(child);
+    }
+    return children;
+}
+function nearestWordAncestor(node, localName) {
+    for (let current = node.parentNode; current; current = current.parentNode) {
+        if (current.nodeType === 1 &&
+            isWordElement(current, localName)) {
+            return current;
+        }
+    }
+    return undefined;
+}
+function hasRevisionAncestor(node) {
+    for (let current = node; current; current = current.parentNode) {
+        if (current.nodeType === 1 &&
+            current.namespaceURI === W_NS &&
+            REVISION_CONTAINERS.has(current.localName)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Flatten the story in document order, treating `w:fldSimple` as opaque.
+ *
+ * The simple-field element itself is emitted so callers can recognize and
+ * refuse it, but its subtree is not: a simple field owns its own instruction
+ * and cached result, and letting those descendants surface in the flat
+ * sequence lets an enclosing complex field adopt — and overwrite — them.
+ */
+function enumerateElements(root) {
+    const elements = [];
+    const visit = (node) => {
+        for (const child of elementChildren(node)) {
+            elements.push(child);
+            if (isWordElement(child, 'fldSimple'))
+                continue;
+            visit(child);
+        }
+    };
+    visit(root);
+    return elements;
+}
+function hasDeletionAncestor(node) {
+    for (let current = node; current; current = current.parentNode) {
+        if (current.nodeType === 1 &&
+            current.namespaceURI === W_NS &&
+            DELETION_CONTAINERS.has(current.localName)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Validate and enumerate complex fields before any mutation occurs.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.18
+ * @see https://github.com/UseJunior/safe-docx/issues/762
+ */
+function collectComplexFields(document) {
+    const roots = [];
+    const stack = [];
+    for (const element of enumerateElements(document)) {
+        if (isWordElement(element, 'fldSimple')) {
+            continue;
+        }
+        if (isWordElement(element, 'fldChar')) {
+            const type = wAttribute(element, 'fldCharType');
+            if (type === 'begin') {
+                const parent = stack[stack.length - 1];
+                const field = {
+                    begin: element,
+                    currentInstruction: [],
+                    deletedInstruction: [],
+                    resultTexts: [],
+                    nested: parent !== undefined,
+                    hasNested: false,
+                    parent,
+                };
+                if (parent)
+                    parent.hasNested = true;
+                if (!parent)
+                    roots.push(field);
+                stack.push(field);
+            }
+            else if (type === 'separate') {
+                const field = stack[stack.length - 1];
+                if (!field || field.separate) {
+                    throw new FieldRefreshError('MALFORMED_FIELD_TOPOLOGY', field ? 'Complex field contains more than one separator' : 'Stray field separator');
+                }
+                field.separate = element;
+            }
+            else if (type === 'end') {
+                const field = stack.pop();
+                if (!field) {
+                    throw new FieldRefreshError('MALFORMED_FIELD_TOPOLOGY', 'Stray field end');
+                }
+                field.end = element;
+            }
+            else {
+                throw new FieldRefreshError('MALFORMED_FIELD_TOPOLOGY', `Unknown field character type: ${type ?? '(missing)'}`);
+            }
+            continue;
+        }
+        const field = stack[stack.length - 1];
+        if (!field)
+            continue;
+        if (!field.separate &&
+            (isWordElement(element, 'instrText') || isWordElement(element, 'delInstrText'))) {
+            // `w:delInstrText` is the canonical deleted-instruction element, but Word
+            // and our own atomizer both also emit plain `w:instrText` inside a
+            // `w:del`. Ancestry is the only reliable signal.
+            const target = isWordElement(element, 'delInstrText') || hasDeletionAncestor(element)
+                ? field.deletedInstruction
+                : field.currentInstruction;
+            target.push(element.textContent ?? '');
+        }
+        else if (field.separate && isWordElement(element, 't')) {
+            field.resultTexts.push(element);
+        }
+    }
+    if (stack.length > 0) {
+        throw new FieldRefreshError('MALFORMED_FIELD_TOPOLOGY', 'Unclosed complex field');
+    }
+    return roots;
+}
+function resolveBookmarkRanges(elements) {
+    const startsByName = new Map();
+    const startsById = new Map();
+    const endsById = new Map();
+    const indexes = new Map();
+    elements.forEach((element, index) => indexes.set(element, index));
+    for (const element of elements) {
+        if (isWordElement(element, 'bookmarkStart')) {
+            const name = wAttribute(element, 'name');
+            const id = wAttribute(element, 'id');
+            if (name)
+                startsByName.set(name, [...(startsByName.get(name) ?? []), element]);
+            if (id)
+                startsById.set(id, [...(startsById.get(id) ?? []), element]);
+        }
+        else if (isWordElement(element, 'bookmarkEnd')) {
+            const id = wAttribute(element, 'id');
+            if (id)
+                endsById.set(id, [...(endsById.get(id) ?? []), element]);
+        }
+    }
+    const ranges = new Map();
+    for (const [name, starts] of startsByName) {
+        if (starts.length !== 1) {
+            ranges.set(name, 'duplicate-bookmark-name');
+            continue;
+        }
+        const start = starts[0];
+        const id = wAttribute(start, 'id');
+        if (!id || (startsById.get(id)?.length ?? 0) !== 1) {
+            ranges.set(name, 'duplicate-or-missing-bookmark-id');
+            continue;
+        }
+        const ends = endsById.get(id) ?? [];
+        if (ends.length !== 1) {
+            ranges.set(name, 'missing-or-duplicate-bookmark-end');
+            continue;
+        }
+        const startIndex = indexes.get(start);
+        const endIndex = indexes.get(ends[0]);
+        if (endIndex <= startIndex) {
+            ranges.set(name, 'reversed-bookmark-range');
+            continue;
+        }
+        ranges.set(name, { start, end: ends[0], startIndex, endIndex });
+    }
+    return ranges;
+}
+/**
+ * Project a bookmark range to the plain text a REF result should cache.
+ *
+ * Word writes a REF result structurally: a tab becomes `w:tab`, a break or a
+ * paragraph transition becomes new run and paragraph content. This primitive
+ * replaces a single `w:t` payload, so it can only faithfully represent a
+ * projection that is itself a single run of characters. A range carrying tabs,
+ * breaks, or a paragraph transition is therefore refused rather than flattened
+ * into literal U+0009/U+000A, which Word collapses on display.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.51
+ * @see https://github.com/UseJunior/safe-docx/issues/762
+ */
+function bookmarkText(indexes, elements, range, field) {
+    const fieldStart = indexes.get(field.begin) ?? -1;
+    const fieldEnd = indexes.get(field.end) ?? -1;
+    if (range.startIndex <= fieldStart &&
+        range.endIndex >= fieldEnd) {
+        return { reason: 'self-referential-bookmark' };
+    }
+    let value = '';
+    let renderedParagraph;
+    for (let index = range.startIndex + 1; index < range.endIndex; index += 1) {
+        const element = elements[index];
+        if (hasRevisionAncestor(element))
+            return { reason: 'bookmark-contains-revisions' };
+        if (isWordElement(element, 'fldChar') ||
+            isWordElement(element, 'fldSimple') ||
+            isWordElement(element, 'drawing') ||
+            isWordElement(element, 'object')) {
+            return { reason: 'unsupported-bookmark-content' };
+        }
+        if (isWordElement(element, 'tab') ||
+            isWordElement(element, 'br') ||
+            isWordElement(element, 'cr')) {
+            return { reason: 'unsupported-bookmark-layout' };
+        }
+        if (!isWordElement(element, 't'))
+            continue;
+        const paragraph = nearestWordAncestor(element, 'p');
+        if (renderedParagraph && paragraph && paragraph !== renderedParagraph) {
+            return { reason: 'unsupported-bookmark-layout' };
+        }
+        if (paragraph)
+            renderedParagraph = paragraph;
+        value += element.textContent ?? '';
+    }
+    return { value };
+}
+/**
+ * Structural reasons a field cannot be refreshed, independent of its
+ * instruction semantics.
+ *
+ * Revision detection is part of this pass and runs *before* the caller trusts
+ * anything the classifier derived: a field whose instruction was edited under
+ * tracked changes has two instruction states, and neither its kind nor its
+ * bookmark target may be asserted from the mixture.
+ */
+function structuralRefreshBlocker(field, indexes, elements) {
+    if (field.nested || field.hasNested)
+        return 'nested-field';
+    if (!field.separate || !field.end)
+        return 'incomplete-field';
+    if (hasRevisionAncestor(field.begin) || hasRevisionAncestor(field.end)) {
+        return 'field-contains-revisions';
+    }
+    const startIndex = indexes.get(field.begin) ?? 0;
+    const endIndex = indexes.get(field.end) ?? elements.length - 1;
+    for (let index = startIndex; index <= endIndex; index += 1) {
+        if (hasRevisionAncestor(elements[index]))
+            return 'field-contains-revisions';
+    }
+    const locked = wAttribute(field.begin, 'fldLock');
+    if (locked === 'true' || locked === '1')
+        return 'locked-field';
+    if (!nearestWordAncestor(field.begin, 'p'))
+        return 'field-outside-paragraph';
+    return undefined;
+}
+function semanticRefreshBlocker(field, classification) {
+    if (classification.evaluationClass === 'deterministic-ref' &&
+        nearestWordAncestor(field.begin, 'p') !== nearestWordAncestor(field.end, 'p')) {
+        return 'cross-paragraph-field';
+    }
+    return classification.reason;
+}
+function replaceCachedResult(field, value) {
+    const first = field.resultTexts[0];
+    if (!first)
+        return 'missing';
+    if (field.resultTexts.map((text) => text.textContent ?? '').join('') === value) {
+        return 'unchanged';
+    }
+    first.textContent = value;
+    if (/^\s|\s$/u.test(value)) {
+        first.setAttributeNS('http://www.w3.org/XML/1998/namespace', 'xml:space', 'preserve');
+    }
+    else {
+        first.removeAttributeNS('http://www.w3.org/XML/1998/namespace', 'space');
+    }
+    for (const text of field.resultTexts.slice(1))
+        text.textContent = '';
+    return 'changed';
+}
+function fieldLocators(document, fields) {
+    const paragraphs = Array.from(document.getElementsByTagNameNS(W_NS, 'p'));
+    const paragraphOrdinals = new Map(paragraphs.map((paragraph, index) => [paragraph, index]));
+    const nextFieldOrdinal = new Map();
+    const locators = new Map();
+    for (const field of fields) {
+        const paragraph = nearestWordAncestor(field.begin, 'p');
+        const fieldOrdinal = nextFieldOrdinal.get(paragraph) ?? 0;
+        nextFieldOrdinal.set(paragraph, fieldOrdinal + 1);
+        const paragraphOrdinal = paragraph
+            ? paragraphOrdinals.get(paragraph)
+            : undefined;
+        locators.set(field, {
+            ...(paragraphOrdinal === undefined ? {} : { paragraphOrdinal }),
+            fieldOrdinal,
+        });
+    }
+    return locators;
+}
+/**
+ * Refresh the deterministic subset of complex fields in a main document story.
+ *
+ * Layout-dependent results are never synthesized. Callers may instead request
+ * `w:dirty="true"` on their begin markers so a layout-capable host recalculates
+ * them when the document is opened.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.18
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.51
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.45
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.44
+ * @conformance ECMA-376 edition 5, Part 1 § 17.16.5.42
+ * @see https://github.com/UseJunior/safe-docx/issues/762
+ */
+export function refreshDocumentFieldsXml(documentXml, options = {}) {
+    const document = parseXml(documentXml);
+    const fields = collectComplexFields(document);
+    const elements = enumerateElements(document);
+    const indexes = new Map(elements.map((element, index) => [element, index]));
+    const bookmarkRanges = resolveBookmarkRanges(elements);
+    const locators = fieldLocators(document, fields);
+    const outcomes = [];
+    let changed = false;
+    fields.forEach((field, index) => {
+        const classification = classifyFieldInstruction(fieldInstructionView(field));
+        const base = {
+            index,
+            locator: locators.get(field),
+            kind: classification.kind,
+            instruction: classification.normalizedInstruction,
+            target: classification.target,
+        };
+        const structuralReason = structuralRefreshBlocker(field, indexes, elements) ??
+            semanticRefreshBlocker(field, classification);
+        if (structuralReason) {
+            outcomes.push({ ...base, status: 'unsupported', reason: structuralReason });
+            return;
+        }
+        if (classification.evaluationClass === 'deterministic-ref') {
+            const bookmark = bookmarkRanges.get(classification.target);
+            if (!bookmark) {
+                outcomes.push({ ...base, status: 'unsupported', reason: 'bookmark-not-found' });
+                return;
+            }
+            if (typeof bookmark === 'string') {
+                outcomes.push({ ...base, status: 'unsupported', reason: bookmark });
+                return;
+            }
+            const projection = bookmarkText(indexes, elements, bookmark, field);
+            if (projection.reason) {
+                outcomes.push({ ...base, status: 'unsupported', reason: projection.reason });
+                return;
+            }
+            const replacement = replaceCachedResult(field, projection.value);
+            if (replacement === 'missing') {
+                outcomes.push({ ...base, status: 'unsupported', reason: 'missing-cached-result-text' });
+                return;
+            }
+            if (replacement === 'unchanged') {
+                outcomes.push({ ...base, status: 'unchanged', reason: 'cached-result-current' });
+                return;
+            }
+            changed = true;
+            outcomes.push({ ...base, status: 'evaluated' });
+            return;
+        }
+        if (classification.evaluationClass === 'layout-dependent' &&
+            options.markLayoutDependentDirty) {
+            const dirty = wAttribute(field.begin, 'dirty');
+            if (dirty !== 'true' && dirty !== '1') {
+                field.begin.setAttributeNS(W_NS, 'w:dirty', 'true');
+                changed = true;
+                outcomes.push({ ...base, status: 'dirtied' });
+            }
+            else {
+                outcomes.push({ ...base, status: 'unchanged', reason: 'already-dirty' });
+            }
+            return;
+        }
+        outcomes.push({
+            ...base,
+            status: classification.evaluationClass === 'layout-dependent'
+                ? 'preserved'
+                : 'unsupported',
+            reason: classification.evaluationClass === 'layout-dependent'
+                ? 'layout-refresh-not-requested'
+                : classification.reason,
+        });
+    });
+    return {
+        documentXml: changed ? serializeXml(document) : documentXml,
+        changed,
+        outcomes,
+    };
+}
+const ANCILLARY_STORY_PATTERN = /^word\/(header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/u;
+/**
+ * Field-bearing parts this operation does not read.
+ *
+ * Reported rather than ignored: a caller whose cross-references live in a
+ * header cannot tell an empty outcome list from a document without fields.
+ */
+function skippedFieldStories(archive) {
+    return archive
+        .listFiles()
+        .filter((path) => ANCILLARY_STORY_PATTERN.test(path))
+        .sort();
+}
+/**
+ * Refresh supported fields in `word/document.xml` of a DOCX package.
+ *
+ * Only the main story is read. Any other field-bearing part present in the
+ * package is named in `skippedStories`.
+ */
+export async function refreshDocxFields(document, options = {}) {
+    const archive = await DocxArchive.load(document);
+    const skippedStories = skippedFieldStories(archive);
+    const result = refreshDocumentFieldsXml(await archive.getDocumentXml(), options);
+    if (!result.changed) {
+        return { document, changed: false, outcomes: result.outcomes, skippedStories };
+    }
+    archive.setDocumentXml(result.documentXml);
+    return {
+        document: await archive.save(),
+        changed: true,
+        outcomes: result.outcomes,
+        skippedStories,
+    };
+}
+//# sourceMappingURL=field_evaluation.js.map

package/dist/primitives/field_evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_evaluation.js","sourceRoot":"","sources":["../../src/primitives/field_evaluation.ts"],"names":[],"mappings":"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"}

package/dist/primitives/footnotes.d.ts

@@ -5,7 +5,7 @@
  * and supports reading, updating, and deleting footnotes.
  */
 import { DocxZip } from './zip.js';
-import { type StylesModel } from './styles.js';
+import { type StylesModel, type ThemeModel } from './styles.js';
 import { type RevisionContext } from './track-changes-emitter.js';
 /**
  * One paragraph of a footnote body, retained at the same node-level fidelity as
@@ -53,6 +53,20 @@ export type AddFootnoteParams = {
     paragraphEl: Element;
     afterText?: string;
     text: string;
+    presentation?: FootnoteNotePresentation;
+};
+export type FootnoteRunStyle = {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    highlight?: 'black' | 'blue' | 'cyan' | 'green' | 'magenta' | 'red' | 'yellow' | 'white' | 'darkBlue' | 'darkCyan' | 'darkGreen' | 'darkMagenta' | 'darkRed' | 'darkYellow' | 'darkGray' | 'lightGray' | 'none';
+};
+export type FootnoteNotePresentation = {
+    prefix?: string;
+    prefixSeparator?: string;
+    prefixStyle?: FootnoteRunStyle;
+    bodyStyle?: FootnoteRunStyle;
 };
 export type AddFootnoteResult = {
     noteId: number;
@@ -73,8 +87,8 @@ export declare function bootstrapFootnoteParts(zip: DocxZip): Promise<BootstrapF
  * `text` and the plural anchor map are unaffected either way, so existing
  * callers that pass `(zip, documentXml)` keep their exact behavior.
  */
-export declare function getFootnotes(zip: DocxZip, documentXml: Document, styles?: StylesModel): Promise<Footnote[]>;
-export declare function getFootnote(zip: DocxZip, documentXml: Document, noteId: number, styles?: StylesModel): Promise<Footnote | null>;
+export declare function getFootnotes(zip: DocxZip, documentXml: Document, styles?: StylesModel, theme?: ThemeModel): Promise<Footnote[]>;
+export declare function getFootnote(zip: DocxZip, documentXml: Document, noteId: number, styles?: StylesModel, theme?: ThemeModel): Promise<Footnote | null>;
 export declare function addFootnote(documentXml: Document, zip: DocxZip, params: AddFootnoteParams, ctx?: RevisionContext): Promise<AddFootnoteResult>;
 export declare function updateFootnoteText(zip: DocxZip, params: {
     noteId: number;

package/dist/primitives/footnotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../../src/primitives/footnotes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAMnC,OAAO,EAAiD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAuBpC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAQF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAG/D;AAID,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAiB3F;AAmID;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiErB;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAG1B;AAgFD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,iBAAiB,EACzB,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;AA6OD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC3C,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAID,wBAAsB,cAAc,CAClC,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1B,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Df"}
+{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../../src/primitives/footnotes.ts"],"names":[],"mappings":"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"}