@aster-editor/word 0.4.2 → 0.5.0

package/dist/docx/writer/graft.d.ts

@@ -0,0 +1,41 @@
+import type { DocumentLayout } from '@aster-editor/core';
+import type { ListDefinition, VariableSettings } from '../../export/context';
+import type { DocxExportWarning } from '../../export/types';
+import type { TemplateContext } from './template';
+import { type XmlCodec } from './xml-io';
+/**
+ * Greffe du corps généré dans le gabarit. Principe figé (brief L27) : le `.docx` produit
+ * par la chaîne d'export (lib `docx`) n'est qu'une source ; le gabarit est ouvert et
+ * **aucune de ses parties n'est réécrite** sauf le corps, ses relations, les médias et
+ * numérotations ajoutés, les styles ajoutés, les notes ajoutées, `[Content_Types].xml`
+ * quand une partie ou une extension apparaît, les en-têtes et pieds quand les
+ * variables y sont résolues ou qu'un `layout` les régénère, `settings.xml` quand la
+ * table des matières ou un en-tête de pages paires l'exige, et `docProps/core.xml`
+ * quand `title` / `creator` sont fournis. Le `w:sectPr` final du gabarit (en-têtes,
+ * pieds, marges, colonnes) est conservé ; un corps régénéré n'a plus de sections
+ * intermédiaires : seules les propriétés de la **dernière** section survivent, complétées
+ * des en-têtes et pieds que les sections précédentes lui transmettaient par héritage.
+ */
+export interface GraftInput {
+    /** Archive produite par `Packer` à partir du corps édité. */
+    readonly generated: ArrayBuffer;
+    readonly template: TemplateContext;
+    readonly lists: readonly ListDefinition[];
+    /** `numId` généré → référence `numbering`, lu sur `document.Numbering` après empaquetage. */
+    readonly concreteNumbering: ReadonlyMap<string, string>;
+    readonly variables: VariableSettings;
+    readonly layout: DocumentLayout | undefined;
+    /** Vrai avec `options.toc` : `w:updateFields` est posé dans `settings.xml`. */
+    readonly toc: boolean;
+    /** `options.title` / `options.creator`, réécrits dans `docProps/core.xml`. */
+    readonly title?: string;
+    readonly creator?: string;
+    readonly codec: XmlCodec;
+}
+/**
+ * Greffe le corps de `generated` dans le gabarit et rend l'archive résultante. Lève sur
+ * un gabarit sans partie principale (déjà validé par `openTemplate`) ou un document
+ * généré illisible : l'appelant replie alors sur l'export neuf.
+ */
+export declare function graftIntoTemplate(input: GraftInput, warnings: DocxExportWarning[]): Promise<ArrayBuffer>;
+//# sourceMappingURL=graft.d.ts.map

package/dist/docx/writer/graft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graft.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/graft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAY5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE3E;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,6FAA6F;IAC7F,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AA+BD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,WAAW,CAAC,CA8HtB"}

package/dist/docx/writer/graft.js

@@ -0,0 +1,277 @@
+import { allNamed, childNamed, childrenNamed } from '../preprocess/xml-utils';
+import { ensureContentTypes } from './content-types';
+import { writeCoreProperties } from './core-properties';
+import { createFootnoteMerger } from './footnotes-merge';
+import { graftHeadersFooters } from './header-footer-graft';
+import { resolveHeaderFooterVariables } from './header-footer-variables';
+import { MediaCopier } from './media';
+import { createNumberingMerger } from './numbering-merge';
+import { REL_TYPE, RelationshipTable } from './relationships';
+import { ensureSettings } from './settings-merge';
+import { createStyleMerger } from './styles-merge';
+import { PartStore, setWordAttr, wordAttr } from './xml-io';
+/** Partie principale que la lib `docx` écrit toujours. */
+const GENERATED_MAIN_PART = 'word/document.xml';
+const R_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const XMLNS_NS = 'http://www.w3.org/2000/xmlns/';
+/** Attributs de relation que le corps généré peut porter (liens, images). */
+const RELATIONSHIP_ATTRIBUTES = new Set(['id', 'embed', 'link']);
+/** Éléments du `w:sectPr` qui doivent précéder tout le reste (ordre du schéma). */
+const SECTION_REFERENCES = ['headerReference', 'footerReference'];
+/** Enfants du `w:sectPr` placés après `w:titlePg` dans l'ordre du schéma. */
+const AFTER_TITLE_PAGE = new Set([
+    'textDirection',
+    'bidi',
+    'rtlGutter',
+    'docGrid',
+    'printerSettings',
+    'sectPrChange',
+]);
+/** Référence de style du corps → type de style qu'elle impose. */
+const STYLE_REFERENCES = [
+    ['pStyle', 'paragraph'],
+    ['rStyle', 'character'],
+    ['tblStyle', 'table'],
+];
+/**
+ * Greffe le corps de `generated` dans le gabarit et rend l'archive résultante. Lève sur
+ * un gabarit sans partie principale (déjà validé par `openTemplate`) ou un document
+ * généré illisible : l'appelant replie alors sur l'export neuf.
+ */
+export async function graftIntoTemplate(input, warnings) {
+    const { pkg, mainDoc, mainDeclaration } = input.template;
+    const mainPart = pkg.mainPart;
+    const template = await PartStore.open(input.template.buffer, input.codec);
+    // La partie principale a déjà été parsée à l'ouverture du gabarit : on la réutilise.
+    template.adopt(mainPart, mainDoc, mainDeclaration);
+    const generated = await PartStore.open(input.generated, input.codec);
+    const templateDoc = mainDoc;
+    const generatedDoc = await generated.dom(GENERATED_MAIN_PART);
+    const templateBody = childNamed(templateDoc.documentElement, 'body');
+    const generatedBody = generatedDoc ? childNamed(generatedDoc.documentElement, 'body') : null;
+    if (!templateBody)
+        throw new Error(`gabarit : ${mainPart} sans w:body`);
+    if (!generatedDoc || !generatedBody)
+        throw new Error('corps généré illisible');
+    // Variables des en-têtes et pieds (mode `resolve`) : avant toute autre écriture.
+    await resolveHeaderFooterVariables({
+        template,
+        pkg,
+        mainPart,
+        settings: input.variables,
+        codec: input.codec,
+        warnings,
+    });
+    const relationships = await RelationshipTable.open(template, mainPart);
+    const generatedRelationships = await RelationshipTable.open(generated, GENERATED_MAIN_PART);
+    const styles = await createStyleMerger({
+        template,
+        generated,
+        templatePath: input.template.stylesPath,
+        resolver: input.template.resolver,
+        warnings,
+    });
+    const numbering = await createNumberingMerger({
+        template,
+        generated,
+        mainPart,
+        templatePath: await pkg.related(mainPart, '/numbering'),
+        relationships,
+        lists: input.lists,
+        concrete: input.concreteNumbering,
+        warnings,
+    });
+    const footnotes = await createFootnoteMerger({
+        template,
+        generated,
+        mainPart,
+        templatePath: await pkg.related(mainPart, '/footnotes'),
+        relationships,
+    });
+    const contentDefaults = new Map();
+    const media = new MediaCopier(template, generated, mainPart, contentDefaults);
+    // 1. Le corps généré, sans son `w:sectPr` final.
+    const blocks = Array.from(generatedBody.children).filter((child) => child.localName !== 'sectPr');
+    // 2. Remappages sur les blocs générés (relations, numérotation, notes, styles).
+    for (const block of blocks) {
+        for (const element of [block, ...allNamed(block, '*')]) {
+            await remapRelationships(element, generatedRelationships, relationships, media);
+            if (element.localName === 'numId' && element.parentElement?.localName === 'numPr') {
+                setWordAttr(element, 'val', await numbering.remap(wordAttr(element, 'val')));
+            }
+            else if (element.localName === 'footnoteReference') {
+                setWordAttr(element, 'id', await footnotes.remap(wordAttr(element, 'id')));
+            }
+        }
+    }
+    const paragraphs = [
+        ...blocks.flatMap((block) => (block.localName === 'p' ? [block] : allNamed(block, 'p'))),
+        ...footnotes.imported().flatMap((note) => allNamed(note, 'p')),
+    ];
+    await remapStyles(blocks, footnotes.imported(), styles);
+    for (const paragraph of paragraphs)
+        styles.stripParagraph(paragraph);
+    // 3. Greffe : les blocs remplacent ceux du gabarit, devant son `w:sectPr` final complété.
+    const sectPr = inheritedSectionProperties(templateBody);
+    for (const child of Array.from(templateBody.childNodes))
+        templateBody.removeChild(child);
+    for (const block of blocks)
+        templateBody.appendChild(templateDoc.importNode(block, true));
+    if (sectPr)
+        templateBody.appendChild(sectPr);
+    copyNamespaceDeclarations(generatedDoc.documentElement, templateDoc.documentElement);
+    await template.markChanged(mainPart);
+    // 4. En-têtes et pieds régénérés depuis `layout` quand ils diffèrent du gabarit.
+    const overrides = new Map();
+    const grafted = await graftHeadersFooters({
+        template,
+        generated,
+        mainPart,
+        sectPr,
+        generatedSectPr: childNamed(generatedBody, 'sectPr'),
+        relationships,
+        generatedRelationships,
+        styles,
+        media,
+        layout: input.layout,
+        templateHeaders: input.template.headers,
+        templateFooters: input.template.footers,
+        overrides,
+        warnings,
+    });
+    // 5. Réglages et propriétés que le corps greffé exige.
+    await ensureSettings({
+        template,
+        pkg,
+        mainPart,
+        relationships,
+        overrides,
+        updateFields: input.toc,
+        evenAndOddHeaders: grafted.even,
+    });
+    await writeCoreProperties({
+        template,
+        pkg,
+        overrides,
+        ...(input.title !== undefined ? { title: input.title } : {}),
+        ...(input.creator !== undefined ? { creator: input.creator } : {}),
+    });
+    // 6. Types de contenu des médias et des parties créées.
+    for (const created of [numbering.createdPart(), footnotes.createdPart()]) {
+        if (created)
+            overrides.set(created.path, created.contentType);
+    }
+    await ensureContentTypes(template, { defaults: contentDefaults, overrides });
+    return template.generate();
+}
+/**
+ * Attributs `r:id` / `r:embed` / `r:link` d'un élément généré → relation du gabarit :
+ * un lien externe réutilise une relation de même cible ou en reçoit une neuve, une image
+ * passe par le copieur de médias. Une relation inconnue est laissée telle quelle.
+ */
+async function remapRelationships(element, source, target, media) {
+    for (const attribute of Array.from(element.attributes)) {
+        if (attribute.namespaceURI !== R_NS || !RELATIONSHIP_ATTRIBUTES.has(attribute.localName)) {
+            continue;
+        }
+        const relationship = source.get(attribute.value);
+        if (!relationship)
+            continue;
+        let id = null;
+        if (relationship.external) {
+            id = await target.ensure(relationship.type, relationship.target, true);
+        }
+        else if (relationship.type === REL_TYPE.image) {
+            id = await media.copy(relationship.resolved, target);
+        }
+        if (id !== null)
+            attribute.value = id;
+    }
+}
+/**
+ * Styles référencés par les blocs et les notes : réutilisés, ajoutés, laissés en place
+ * (styles intégrés de Word) ou retirés avec avertissement. Chaque référence impose le
+ * type du style (`w:pStyle` → paragraphe…) : un style d'un autre type est retiré.
+ */
+async function remapStyles(blocks, notes, styles) {
+    const references = [];
+    for (const root of [...blocks, ...notes]) {
+        for (const [name, expected] of STYLE_REFERENCES) {
+            if (root.localName === name)
+                references.push([root, expected]);
+            for (const reference of allNamed(root, name))
+                references.push([reference, expected]);
+        }
+    }
+    for (const [reference, expected] of references) {
+        const id = wordAttr(reference, 'val');
+        if (!id)
+            continue;
+        const ensured = await styles.ensure(id, expected);
+        if (ensured.status === 'missing')
+            reference.remove();
+        else if (ensured.id !== id)
+            setWordAttr(reference, 'val', ensured.id);
+    }
+}
+/**
+ * `w:sectPr` final du gabarit, complété des références d'en-tête et de pied (et de
+ * `w:titlePg`) que les sections précédentes lui transmettaient : Word fait hériter chaque
+ * section de la précédente, et le corps régénéré ne garde que la dernière. `null` si le
+ * gabarit n'a aucun `w:sectPr` final.
+ */
+function inheritedSectionProperties(body) {
+    const last = childNamed(body, 'sectPr');
+    if (!last)
+        return null;
+    const inherited = new Map();
+    let titlePage = null;
+    for (const paragraph of childrenNamed(body, 'p')) {
+        const pPr = childNamed(paragraph, 'pPr');
+        const sectPr = pPr ? childNamed(pPr, 'sectPr') : null;
+        if (!sectPr)
+            continue;
+        for (const child of Array.from(sectPr.children)) {
+            if (child.localName === 'headerReference' || child.localName === 'footerReference') {
+                inherited.set(`${child.localName}:${wordAttr(child, 'type') || 'default'}`, child);
+            }
+            else if (child.localName === 'titlePg') {
+                titlePage = child;
+            }
+        }
+    }
+    const own = new Set();
+    for (const child of Array.from(last.children)) {
+        if (child.localName === 'headerReference' || child.localName === 'footerReference') {
+            own.add(`${child.localName}:${wordAttr(child, 'type') || 'default'}`);
+        }
+    }
+    // Les références manquantes sont insérées en tête, en-têtes avant pieds (ordre du schéma).
+    for (const name of [...SECTION_REFERENCES].reverse()) {
+        for (const [key, element] of Array.from(inherited).reverse()) {
+            if (!key.startsWith(`${name}:`) || own.has(key))
+                continue;
+            last.insertBefore(element.cloneNode(true), last.firstChild);
+        }
+    }
+    if (titlePage && !childNamed(last, 'titlePg')) {
+        const after = Array.from(last.children).find((child) => AFTER_TITLE_PAGE.has(child.localName));
+        last.insertBefore(titlePage.cloneNode(true), after ?? null);
+    }
+    return last;
+}
+/**
+ * Déclarations `xmlns:*` du document généré absentes de la racine du gabarit : les blocs
+ * importés (dessins `wp:`, `a:`, `pic:`…) les trouvent ainsi en portée sans que le
+ * sérialiseur ne les répète sur chaque élément.
+ */
+function copyNamespaceDeclarations(source, target) {
+    for (const attribute of Array.from(source.attributes)) {
+        if (attribute.namespaceURI !== XMLNS_NS && !attribute.name.startsWith('xmlns:'))
+            continue;
+        if (target.hasAttribute(attribute.name))
+            continue;
+        target.setAttributeNS(XMLNS_NS, attribute.name, attribute.value);
+    }
+}
+//# sourceMappingURL=graft.js.map

package/dist/docx/writer/graft.js.map

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

package/dist/docx/writer/header-footer-graft.d.ts

@@ -0,0 +1,34 @@
+import type { DocumentLayout, HeaderFooterSet } from '@aster-editor/core';
+import type { DocxExportWarning } from '../../export/types';
+import type { MediaCopier } from './media';
+import { RelationshipTable } from './relationships';
+import type { StyleMerger } from './styles-merge';
+import { type PartStore } from './xml-io';
+export interface HeaderFooterGraftInput {
+    readonly template: PartStore;
+    readonly generated: PartStore;
+    readonly mainPart: string;
+    /** `w:sectPr` final du gabarit (déjà complété par héritage), `null` s'il n'y en a pas. */
+    readonly sectPr: Element | null;
+    /** `w:sectPr` final du document généré, qui référence les parties générées. */
+    readonly generatedSectPr: Element | null;
+    readonly relationships: RelationshipTable;
+    readonly generatedRelationships: RelationshipTable;
+    readonly styles: StyleMerger;
+    readonly media: MediaCopier;
+    readonly layout: DocumentLayout | undefined;
+    /** En-têtes et pieds du gabarit tels que l'import les lit, `undefined` si non lus. */
+    readonly templateHeaders: HeaderFooterSet | undefined;
+    readonly templateFooters: HeaderFooterSet | undefined;
+    /** `Override` à ajouter à `[Content_Types].xml` pour les parties créées. */
+    readonly overrides: Map<string, string>;
+    readonly warnings: DocxExportWarning[];
+}
+/** Issue de la greffe : parties créées, et si l'une d'elles est de type `even`. */
+export interface HeaderFooterGraftResult {
+    readonly created: readonly string[];
+    readonly even: boolean;
+}
+/** Greffe les en-têtes et pieds régénérés. */
+export declare function graftHeadersFooters(input: HeaderFooterGraftInput): Promise<HeaderFooterGraftResult>;
+//# sourceMappingURL=header-footer-graft.d.ts.map

package/dist/docx/writer/header-footer-graft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-footer-graft.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/header-footer-graft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAY,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AA0B9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AA+BD,8CAA8C;AAC9C,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA6BlC"}

package/dist/docx/writer/header-footer-graft.js

@@ -0,0 +1,155 @@
+import { allNamed, childNamed } from '../preprocess/xml-utils';
+import { PART_CONTENT_TYPES } from './content-types';
+import { REL_TYPE, RelationshipTable } from './relationships';
+import { directoryOf, setWordAttr, wordAttr } from './xml-io';
+/**
+ * En-têtes et pieds de page du gabarit quand `options.layout.headers` / `footers` est
+ * fourni. Pour chaque type (`default`, `first`, `even`) dont le HTML diffère de ce que le
+ * lecteur relit dans le gabarit, la partie générée par la chaîne d'export (lib `docx`,
+ * `header-footer.ts`) est copiée dans le gabarit sous un nom libre, ses relations
+ * (images, liens) et ses styles greffés comme ceux du corps, et le `w:sectPr` final
+ * pointe dessus à la place de l'ancienne. Un type identique ou absent du `layout` laisse
+ * la partie du gabarit intacte à l'octet ; l'ancienne partie n'est jamais supprimée. Sans
+ * `w:sectPr` final dans le gabarit, rien ne peut être accroché : avertissement
+ * `template-section-missing`. Un type `even` greffé est signalé à l'appelant, qui doit
+ * activer `w:evenAndOddHeaders` dans `settings.xml` pour que Word l'affiche.
+ */
+const R_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const KINDS = ['header', 'footer'];
+const SET_KEYS = ['default', 'first', 'even'];
+/** Attributs de relation que la partie générée peut porter (liens, images). */
+const RELATIONSHIP_ATTRIBUTES = new Set(['id', 'embed', 'link']);
+/** HTML comparable : blancs réduits, blancs collés aux balises retirés. */
+function normalizeHtml(html) {
+    return html.replace(/\s+/g, ' ').replace(/>\s+</g, '><').trim();
+}
+/** `w:headerReference` / `w:footerReference` de ce type dans un `w:sectPr`. */
+function referenceOf(sectPr, kind, type) {
+    return (Array.from(sectPr.children).find((child) => child.localName === `${kind}Reference` && (wordAttr(child, 'type') || 'default') === type) ?? null);
+}
+/** Chemin libre `word/header<n>.xml` / `word/footer<n>.xml` dans le gabarit. */
+function freePartPath(store, mainPart, kind) {
+    const directory = directoryOf(mainPart);
+    for (let index = 1;; index += 1) {
+        const candidate = `${directory}${kind}${String(index)}.xml`;
+        if (!store.has(candidate))
+            return candidate;
+    }
+}
+/** Vrai si le `layout` demande au moins un en-tête ou un pied. */
+function wantsHeadersFooters(layout) {
+    return Boolean(layout?.headers || layout?.footers);
+}
+/** Greffe les en-têtes et pieds régénérés. */
+export async function graftHeadersFooters(input) {
+    const created = [];
+    let even = false;
+    if (!wantsHeadersFooters(input.layout))
+        return { created, even };
+    if (!input.sectPr) {
+        input.warnings.push({
+            code: 'template-section-missing',
+            message: 'Gabarit sans w:sectPr final : les en-têtes et pieds de layout ne peuvent pas y être accrochés, ignorés',
+        });
+        return { created, even };
+    }
+    if (!input.layout || !input.generatedSectPr)
+        return { created, even };
+    for (const kind of KINDS) {
+        const wanted = kind === 'header' ? input.layout.headers : input.layout.footers;
+        const existing = kind === 'header' ? input.templateHeaders : input.templateFooters;
+        if (!wanted)
+            continue;
+        for (const type of SET_KEYS) {
+            const html = wanted[type]?.html;
+            if (html === undefined)
+                continue;
+            const current = existing?.[type]?.html;
+            if (current !== undefined && normalizeHtml(current) === normalizeHtml(html))
+                continue;
+            const path = await graftOne(input, kind, type);
+            if (!path)
+                continue;
+            created.push(path);
+            if (type === 'even')
+                even = true;
+        }
+    }
+    return { created, even };
+}
+/** Copie la partie générée d'un type dans le gabarit et y fait pointer le `w:sectPr`. */
+async function graftOne(input, kind, type) {
+    const sectPr = input.sectPr;
+    const generatedSectPr = input.generatedSectPr;
+    if (!sectPr || !generatedSectPr)
+        return null;
+    const generatedReference = referenceOf(generatedSectPr, kind, type);
+    const generatedId = generatedReference?.getAttributeNS(R_NS, 'id') ?? '';
+    const generatedPath = input.generatedRelationships.get(generatedId)?.resolved;
+    const doc = generatedPath ? await input.generated.dom(generatedPath) : null;
+    // Un HTML vide ne produit pas de partie : l'ancienne reste (rien à retirer sans la supprimer).
+    if (!generatedPath || !doc)
+        return null;
+    const path = freePartPath(input.template, input.mainPart, kind);
+    const partRelationships = await RelationshipTable.open(input.template, path);
+    const generatedPartRelationships = await RelationshipTable.open(input.generated, generatedPath);
+    for (const element of allNamed(doc, '*')) {
+        for (const attribute of Array.from(element.attributes)) {
+            if (attribute.namespaceURI !== R_NS || !RELATIONSHIP_ATTRIBUTES.has(attribute.localName)) {
+                continue;
+            }
+            const relationship = generatedPartRelationships.get(attribute.value);
+            if (!relationship)
+                continue;
+            let id = null;
+            if (relationship.external) {
+                id = await partRelationships.ensure(relationship.type, relationship.target, true);
+            }
+            else if (relationship.type === REL_TYPE.image) {
+                id = await input.media.copy(relationship.resolved, partRelationships);
+            }
+            if (id !== null)
+                attribute.value = id;
+        }
+    }
+    for (const [name, expected] of [
+        ['pStyle', 'paragraph'],
+        ['rStyle', 'character'],
+    ]) {
+        for (const reference of allNamed(doc, name)) {
+            const styleId = wordAttr(reference, 'val');
+            if (!styleId)
+                continue;
+            const ensured = await input.styles.ensure(styleId, expected);
+            if (ensured.status === 'missing')
+                reference.remove();
+            else if (ensured.id !== styleId)
+                setWordAttr(reference, 'val', ensured.id);
+        }
+    }
+    for (const paragraph of allNamed(doc, 'p'))
+        input.styles.stripParagraph(paragraph);
+    input.template.create(path, doc, '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>');
+    input.overrides.set(path, PART_CONTENT_TYPES[kind]);
+    const id = await input.relationships.add(REL_TYPE[kind], path, false);
+    const reference = referenceOf(sectPr, kind, type);
+    if (reference) {
+        reference.setAttributeNS(R_NS, 'r:id', id);
+    }
+    else {
+        const element = sectPr.ownerDocument.createElementNS(sectPr.namespaceURI, `${sectPr.prefix ? `${sectPr.prefix}:` : ''}${kind}Reference`);
+        setWordAttr(element, 'type', type);
+        element.setAttributeNS(R_NS, 'r:id', id);
+        // Ordre du schéma : les `headerReference` d'abord, puis les `footerReference`, puis le reste.
+        const anchor = Array.from(sectPr.children).find((child) => child.localName !== 'headerReference' &&
+            (kind === 'header' || child.localName !== 'footerReference'));
+        sectPr.insertBefore(element, anchor ?? null);
+    }
+    if (type === 'first' && !childNamed(sectPr, 'titlePg')) {
+        const titlePage = sectPr.ownerDocument.createElementNS(sectPr.namespaceURI, `${sectPr.prefix ? `${sectPr.prefix}:` : ''}titlePg`);
+        const after = Array.from(sectPr.children).find((child) => ['textDirection', 'bidi', 'rtlGutter', 'docGrid', 'printerSettings', 'sectPrChange'].includes(child.localName));
+        sectPr.insertBefore(titlePage, after ?? null);
+    }
+    return path;
+}
+//# sourceMappingURL=header-footer-graft.js.map

package/dist/docx/writer/header-footer-graft.js.map

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

package/dist/docx/writer/header-footer-variables.d.ts

@@ -0,0 +1,25 @@
+import type { VariableSettings } from '../../export/context';
+import type { DocxExportWarning } from '../../export/types';
+import type { DocxPackage } from '../reader/types';
+import { type PartStore, type XmlCodec } from './xml-io';
+export interface HeaderFooterVariablesInput {
+    readonly template: PartStore;
+    readonly pkg: DocxPackage;
+    readonly mainPart: string;
+    readonly settings: VariableSettings;
+    readonly codec: XmlCodec;
+    readonly warnings: DocxExportWarning[];
+}
+/** Parties d'en-tête et de pied référencées par la partie principale (chemins du zip, dédoublonnés). */
+export declare function headerFooterParts(pkg: DocxPackage, mainPart: string): Promise<string[]>;
+/**
+ * Remplace les `{{nom}}` des `w:t` du document par leur valeur. Rend vrai si un texte a
+ * changé. Les noms sans valeur sont signalés une fois chacun.
+ */
+export declare function resolveVariablesInTexts(doc: Document, settings: VariableSettings, warnings: DocxExportWarning[]): boolean;
+/**
+ * Résout les variables des en-têtes et pieds du gabarit (mode `resolve` seulement). Les
+ * parties modifiées sont réécrites dans le paquet, les autres restent intactes.
+ */
+export declare function resolveHeaderFooterVariables(input: HeaderFooterVariablesInput): Promise<void>;
+//# sourceMappingURL=header-footer-variables.d.ts.map

package/dist/docx/writer/header-footer-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-footer-variables.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/header-footer-variables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAkB3E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CACxC;AAED,wGAAwG;AACxG,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO7F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CA6BT;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,IAAI,CAAC,CAgCf"}