@aster-editor/word 0.4.3 → 0.5.0

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

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

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

@@ -0,0 +1,32 @@
+import { type RelationshipTable } from './relationships';
+import { type PartStore } from './xml-io';
+/**
+ * Copie des médias du paquet généré dans `word/media/` du gabarit. Une image dont les
+ * octets existent déjà dans le gabarit réutilise cette partie (et sa relation d'image,
+ * s'il y en a une dans la table visée) ; sinon elle est ajoutée sous son nom, suffixé en
+ * cas de collision. Rien n'est jamais supprimé. Les extensions nouvelles sont collectées
+ * pour `[Content_Types].xml`.
+ */
+export declare class MediaCopier {
+    private readonly template;
+    private readonly generated;
+    private readonly mainPart;
+    readonly contentDefaults: Map<string, string>;
+    private readonly copied;
+    private templateMedia;
+    constructor(template: PartStore, generated: PartStore, mainPart: string, contentDefaults: Map<string, string>);
+    /**
+     * Chemin généré (`word/media/<sha>.png`) → identifiant de relation d'image dans
+     * `relationships` (la table de la partie qui référence l'image), `null` si les octets
+     * sont introuvables.
+     */
+    copy(generatedPath: string, relationships: RelationshipTable): Promise<string | null>;
+    /** Partie du gabarit qui porte les octets de l'image générée, copiée au besoin. */
+    private store;
+    /** Chemin libre dans le dossier `media/` du gabarit, suffixé `-2`, `-3`… si le nom est pris. */
+    private freePath;
+    /** Partie média du gabarit aux mêmes octets, `null` sinon. */
+    private findIdentical;
+    private loadTemplateMedia;
+}
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAP/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,aAAa,CAAyD;gBAG3D,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EACxB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAG/C;;;;OAIG;IACG,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ3F,mFAAmF;YACrE,KAAK;IAYnB,gGAAgG;IAChG,OAAO,CAAC,QAAQ;IAahB,8DAA8D;YAChD,aAAa;YAcb,iBAAiB;CAQhC"}

package/dist/docx/writer/media.js

@@ -0,0 +1,88 @@
+import { imageContentType } from './content-types';
+import { REL_TYPE } from './relationships';
+import { basenameOf, directoryOf } from './xml-io';
+/**
+ * Copie des médias du paquet généré dans `word/media/` du gabarit. Une image dont les
+ * octets existent déjà dans le gabarit réutilise cette partie (et sa relation d'image,
+ * s'il y en a une dans la table visée) ; sinon elle est ajoutée sous son nom, suffixé en
+ * cas de collision. Rien n'est jamais supprimé. Les extensions nouvelles sont collectées
+ * pour `[Content_Types].xml`.
+ */
+export class MediaCopier {
+    template;
+    generated;
+    mainPart;
+    contentDefaults;
+    copied = new Map();
+    templateMedia = null;
+    constructor(template, generated, mainPart, contentDefaults) {
+        this.template = template;
+        this.generated = generated;
+        this.mainPart = mainPart;
+        this.contentDefaults = contentDefaults;
+    }
+    /**
+     * Chemin généré (`word/media/<sha>.png`) → identifiant de relation d'image dans
+     * `relationships` (la table de la partie qui référence l'image), `null` si les octets
+     * sont introuvables.
+     */
+    async copy(generatedPath, relationships) {
+        const known = this.copied.get(generatedPath);
+        const path = known ?? (await this.store(generatedPath));
+        if (path === null)
+            return null;
+        this.copied.set(generatedPath, path);
+        return relationships.ensure(REL_TYPE.image, path, false);
+    }
+    /** Partie du gabarit qui porte les octets de l'image générée, copiée au besoin. */
+    async store(generatedPath) {
+        const bytes = await this.generated.binary(generatedPath);
+        if (!bytes)
+            return null;
+        const extension = basenameOf(generatedPath).split('.').pop()?.toLowerCase() ?? '';
+        const existing = await this.findIdentical(bytes, extension);
+        if (existing)
+            return existing;
+        const path = this.freePath(generatedPath);
+        this.template.write(path, bytes);
+        if (extension)
+            this.contentDefaults.set(extension, imageContentType(extension));
+        return path;
+    }
+    /** Chemin libre dans le dossier `media/` du gabarit, suffixé `-2`, `-3`… si le nom est pris. */
+    freePath(generatedPath) {
+        const name = basenameOf(generatedPath);
+        const dot = name.lastIndexOf('.');
+        const stem = dot < 0 ? name : name.slice(0, dot);
+        const extension = dot < 0 ? '' : name.slice(dot);
+        const directory = `${directoryOf(this.mainPart)}media/`;
+        let candidate = `${directory}${name}`;
+        for (let index = 2; this.template.has(candidate); index += 1) {
+            candidate = `${directory}${stem}-${String(index)}${extension}`;
+        }
+        return candidate;
+    }
+    /** Partie média du gabarit aux mêmes octets, `null` sinon. */
+    async findIdentical(bytes, extension) {
+        this.templateMedia ??= this.loadTemplateMedia();
+        for (const [path, candidate] of await this.templateMedia) {
+            if (!path.toLowerCase().endsWith(`.${extension}`) ||
+                candidate.byteLength !== bytes.byteLength) {
+                continue;
+            }
+            if (candidate.every((byte, index) => byte === bytes[index]))
+                return path;
+        }
+        return null;
+    }
+    async loadTemplateMedia() {
+        const map = new Map();
+        for (const path of this.template.paths(`${directoryOf(this.mainPart)}media/`)) {
+            const bytes = await this.template.binary(path);
+            if (bytes)
+                map.set(path, bytes);
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=media.js.map

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

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

package/dist/docx/writer/numbering-merge.d.ts

@@ -0,0 +1,37 @@
+import type { ListDefinition } from '../../export/context';
+import type { DocxExportWarning } from '../../export/types';
+import { type RelationshipTable } from './relationships';
+import { type PartStore } from './xml-io';
+/**
+ * Numérotation des listes du corps greffé. La lib `docx` numérote ses `w:num` à partir
+ * de 1 : chaque `w:numId` du corps est remappé. Une liste qui portait `data-docx-num-id`
+ * **réutilise** le `w:num` du gabarit (même compteur, mêmes puces, mêmes retraits que
+ * l'original) ; les autres voient leur `w:num` et leur `w:abstractNum` générés
+ * **ajoutés** à `numbering.xml` sous des identifiants libres. Les définitions du gabarit
+ * ne sont jamais modifiées. Sans `numbering.xml` dans le gabarit, la partie est créée.
+ */
+export interface NumberingMergerInput {
+    readonly template: PartStore;
+    readonly generated: PartStore;
+    /** Partie principale du gabarit, dont dépend l'emplacement de `numbering.xml`. */
+    readonly mainPart: string;
+    /** Chemin de `numbering.xml` dans le gabarit (relation `/numbering`), `null` s'il n'en a pas. */
+    readonly templatePath: string | null;
+    readonly relationships: RelationshipTable;
+    readonly lists: readonly ListDefinition[];
+    /** `numId` généré → référence `numbering` de l'export (`document.Numbering` après empaquetage). */
+    readonly concrete: ReadonlyMap<string, string>;
+    readonly warnings: DocxExportWarning[];
+}
+export interface NumberingMerger {
+    /** `numId` du corps généré → `numId` à écrire dans le gabarit. */
+    remap(numId: string): Promise<string>;
+    /** Partie `numbering.xml` créée dans le gabarit, à déclarer dans `[Content_Types].xml`. */
+    readonly createdPart: () => {
+        readonly path: string;
+        readonly contentType: string;
+    } | null;
+}
+/** Crée le fusionneur de numérotation du gabarit. */
+export declare function createNumberingMerger(input: NumberingMergerInput): Promise<NumberingMerger>;
+//# sourceMappingURL=numbering-merge.d.ts.map

package/dist/docx/writer/numbering-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-merge.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/numbering-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAyD,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjG;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5F;AAQD,qDAAqD;AACrD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqIjG"}

package/dist/docx/writer/numbering-merge.js

@@ -0,0 +1,140 @@
+import { childNamed, childrenNamed } from '../preprocess/xml-utils';
+import { PART_CONTENT_TYPES } from './content-types';
+import { REL_TYPE } from './relationships';
+import { directoryOf, emptyDocumentLike, setWordAttr, wordAttr } from './xml-io';
+/** Chemin par défaut de `numbering.xml`, à côté de la partie principale. */
+const NUMBERING_FILE = 'numbering.xml';
+/** Plus grand `ST_DecimalNumber` (`xsd:int`) qu'un `w:numId` ou `w:abstractNumId` peut porter. */
+const MAX_DECIMAL_NUMBER = 2_147_483_647;
+/** Crée le fusionneur de numérotation du gabarit. */
+export async function createNumberingMerger(input) {
+    const generatedDoc = await input.generated.dom('word/numbering.xml');
+    let templatePath = input.templatePath;
+    let templateDoc = templatePath ? await input.template.dom(templatePath) : null;
+    let created = null;
+    const remapped = new Map();
+    const copiedAbstracts = new Map();
+    const warned = new Set();
+    const byReference = new Map();
+    for (const list of input.lists)
+        byReference.set(list.reference, list);
+    /** `w:num` et `w:abstractNum` du gabarit, indexés par identifiant (recalculés à chaque ajout). */
+    const templateIds = () => {
+        const nums = new Map();
+        const abstracts = new Map();
+        if (templateDoc) {
+            for (const num of childrenNamed(templateDoc.documentElement, 'num')) {
+                nums.set(wordAttr(num, 'numId'), num);
+            }
+            for (const abstractNum of childrenNamed(templateDoc.documentElement, 'abstractNum')) {
+                abstracts.set(wordAttr(abstractNum, 'abstractNumId'), abstractNum);
+            }
+        }
+        return { nums, abstracts };
+    };
+    /**
+     * Identifiant libre : le plus grand + 1 (ids ajoutés après ceux du gabarit, comme Word
+     * les attribue), borné à `xsd:int` (`ST_DecimalNumber`, 2^31 - 1) : au-delà, Word
+     * répare ou refuse. Quand le gabarit occupe déjà le plafond, premier entier libre
+     * à partir de 1.
+     */
+    const nextId = (ids) => {
+        const taken = new Set();
+        let max = 0;
+        for (const id of ids) {
+            const value = Number(id);
+            if (!Number.isFinite(value))
+                continue;
+            taken.add(value);
+            if (value > max)
+                max = value;
+        }
+        if (max < MAX_DECIMAL_NUMBER)
+            return String(max + 1);
+        let candidate = 1;
+        while (taken.has(candidate) && candidate < MAX_DECIMAL_NUMBER)
+            candidate += 1;
+        return String(candidate);
+    };
+    const warnFallback = (templateNumId) => {
+        if (warned.has(templateNumId))
+            return;
+        warned.add(templateNumId);
+        input.warnings.push({
+            code: 'template-numbering-fallback',
+            message: `Numérotation ${templateNumId} du gabarit introuvable (data-docx-num-id) : numérotation neuve ajoutée`,
+        });
+    };
+    /** `numbering.xml` du gabarit, créée à la première copie si le gabarit n'en avait pas. */
+    const ensureTemplateDoc = async () => {
+        if (templateDoc)
+            return templateDoc;
+        if (!generatedDoc)
+            return null;
+        templatePath = templatePath ?? `${directoryOf(input.mainPart)}${NUMBERING_FILE}`;
+        templateDoc = emptyDocumentLike(generatedDoc);
+        input.template.create(templatePath, templateDoc, '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>');
+        await input.relationships.ensure(REL_TYPE.numbering, templatePath, false);
+        created = { path: templatePath, contentType: PART_CONTENT_TYPES.numbering };
+        return templateDoc;
+    };
+    /** Copie le `w:num` généré (et son `w:abstractNum`) sous des identifiants libres. */
+    const copy = async (numId) => {
+        const target = await ensureTemplateDoc();
+        if (!generatedDoc || !target || !templatePath)
+            return numId;
+        const generatedNum = childrenNamed(generatedDoc.documentElement, 'num').find((num) => wordAttr(num, 'numId') === numId);
+        if (!generatedNum)
+            return numId;
+        const abstractRef = childNamed(generatedNum, 'abstractNumId');
+        const generatedAbstractId = abstractRef ? wordAttr(abstractRef, 'val') : '';
+        const generatedAbstract = childrenNamed(generatedDoc.documentElement, 'abstractNum').find((abstractNum) => wordAttr(abstractNum, 'abstractNumId') === generatedAbstractId);
+        const root = target.documentElement;
+        let abstractId = copiedAbstracts.get(generatedAbstractId);
+        if (abstractId === undefined && generatedAbstract) {
+            abstractId = nextId(templateIds().abstracts.keys());
+            const clone = target.importNode(generatedAbstract, true);
+            setWordAttr(clone, 'abstractNumId', abstractId);
+            // Schéma : tous les `w:abstractNum` précèdent les `w:num`.
+            const firstNum = childNamed(root, 'num');
+            root.insertBefore(clone, firstNum);
+            copiedAbstracts.set(generatedAbstractId, abstractId);
+        }
+        const newNumId = nextId(templateIds().nums.keys());
+        const numClone = target.importNode(generatedNum, true);
+        setWordAttr(numClone, 'numId', newNumId);
+        const cloneAbstractRef = childNamed(numClone, 'abstractNumId');
+        if (cloneAbstractRef && abstractId !== undefined)
+            setWordAttr(cloneAbstractRef, 'val', abstractId);
+        // `w:numIdMacAtCleanup`, s'il existe, reste le dernier enfant.
+        root.insertBefore(numClone, childNamed(root, 'numIdMacAtCleanup'));
+        await input.template.markChanged(templatePath);
+        return newNumId;
+    };
+    return {
+        async remap(numId) {
+            const known = remapped.get(numId);
+            if (known !== undefined)
+                return known;
+            const reference = input.concrete.get(numId);
+            const definition = reference === undefined ? undefined : byReference.get(reference);
+            let result;
+            if (definition?.templateNumId !== undefined) {
+                if (templateIds().nums.has(definition.templateNumId)) {
+                    result = definition.templateNumId;
+                }
+                else {
+                    warnFallback(definition.templateNumId);
+                    result = await copy(numId);
+                }
+            }
+            else {
+                result = await copy(numId);
+            }
+            remapped.set(numId, result);
+            return result;
+        },
+        createdPart: () => created,
+    };
+}
+//# sourceMappingURL=numbering-merge.js.map

package/dist/docx/writer/numbering-merge.js.map

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

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

@@ -0,0 +1,63 @@
+import { type PartStore } from './xml-io';
+/**
+ * Relations OPC d'une partie (`word/_rels/document.xml.rels`) en lecture et en écriture
+ * pour la greffe : les identifiants du corps généré (`rId1`… attribués par la lib `docx`
+ * à partir de 1) entrent en collision avec ceux du gabarit, chaque relation du corps est
+ * donc **remappée** : réutilisation d'une relation du gabarit de même type et même cible
+ * quand elle existe, sinon ajout sous un identifiant libre. Un fichier `.rels` absent
+ * n'est créé qu'au premier ajout : une partie sans relation n'en reçoit pas de vide.
+ */
+/** Espace de noms des fichiers `.rels`. */
+export declare const RELATIONSHIPS_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
+/** Types de relations manipulés par la greffe. */
+export declare const REL_TYPE: {
+    readonly image: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+    readonly hyperlink: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+    readonly numbering: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
+    readonly footnotes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes";
+    readonly styles: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+    readonly settings: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
+    readonly header: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
+    readonly footer: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
+    /** Propriétés du document (`docProps/core.xml`), relation du paquet (`_rels/.rels`). */
+    readonly coreProperties: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
+};
+/** Une relation : identifiant, type, cible telle qu'écrite, cible résolue en chemin du zip. */
+export interface RelationshipEntry {
+    readonly id: string;
+    readonly type: string;
+    readonly target: string;
+    readonly resolved: string;
+    readonly external: boolean;
+}
+/** Table des relations d'une partie, créée (en mémoire) vide si le fichier `.rels` manque. */
+export declare class RelationshipTable {
+    private readonly store;
+    readonly path: string;
+    private readonly partPath;
+    private readonly doc;
+    /** Vrai tant que le `.rels` n'existe pas dans le paquet : il sera créé au premier ajout. */
+    private missing;
+    private readonly entries;
+    private nextNumber;
+    private constructor();
+    /** Ouvre les relations de `partPath`. Un `.rels` absent ou illisible donne une table vide. */
+    static open(store: PartStore, partPath: string): Promise<RelationshipTable>;
+    get(id: string): RelationshipEntry | undefined;
+    values(): IterableIterator<RelationshipEntry>;
+    /** Première relation de ce type dont la cible résolue (ou l'URL externe) est `resolved`. */
+    find(type: string, resolved: string, external: boolean): RelationshipEntry | undefined;
+    /**
+     * Ajoute une relation et rend son identifiant. `target` est une URL (externe) ou un
+     * chemin de partie du zip, réécrit relativement au dossier de la partie.
+     */
+    add(type: string, target: string, external: boolean): Promise<string>;
+    /** Identifiant d'une relation de ce type vers cette cible : existante, sinon ajoutée. */
+    ensure(type: string, target: string, external: boolean): Promise<string>;
+}
+/**
+ * Cible relative au dossier de la partie : `word/media/a.png` depuis `word/document.xml`
+ * → `media/a.png` ; hors du dossier, chemin absolu `/x/y.xml` (que Word accepte).
+ */
+export declare function relativeTarget(partPath: string, target: string): string;
+//# sourceMappingURL=relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/relationships.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;;;;GAOG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,iEAAiE,CAAC;AAK/F,kDAAkD;AAClD,eAAO,MAAM,QAAQ;;;;;;;;;IASnB,wFAAwF;;CAEhF,CAAC;AAEX,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD,8FAA8F;AAC9F,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,4FAA4F;IAC5F,OAAO,CAAC,OAAO;IATjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO;IA0BP,8FAA8F;WACjF,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOjF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAI7C,4FAA4F;IAC5F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS;IAStF;;;OAGG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB3E,yFAAyF;IACnF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAG/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/docx/writer/relationships.js

@@ -0,0 +1,127 @@
+import { relsPathOf, resolveTarget } from '../reader/package';
+import { directoryOf } from './xml-io';
+/**
+ * Relations OPC d'une partie (`word/_rels/document.xml.rels`) en lecture et en écriture
+ * pour la greffe : les identifiants du corps généré (`rId1`… attribués par la lib `docx`
+ * à partir de 1) entrent en collision avec ceux du gabarit, chaque relation du corps est
+ * donc **remappée** : réutilisation d'une relation du gabarit de même type et même cible
+ * quand elle existe, sinon ajout sous un identifiant libre. Un fichier `.rels` absent
+ * n'est créé qu'au premier ajout : une partie sans relation n'en reçoit pas de vide.
+ */
+/** Espace de noms des fichiers `.rels`. */
+export const RELATIONSHIPS_NS = 'http://schemas.openxmlformats.org/package/2006/relationships';
+const OFFICE_RELATIONSHIPS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const PACKAGE_RELATIONSHIPS = 'http://schemas.openxmlformats.org/package/2006/relationships';
+/** Types de relations manipulés par la greffe. */
+export const REL_TYPE = {
+    image: `${OFFICE_RELATIONSHIPS}/image`,
+    hyperlink: `${OFFICE_RELATIONSHIPS}/hyperlink`,
+    numbering: `${OFFICE_RELATIONSHIPS}/numbering`,
+    footnotes: `${OFFICE_RELATIONSHIPS}/footnotes`,
+    styles: `${OFFICE_RELATIONSHIPS}/styles`,
+    settings: `${OFFICE_RELATIONSHIPS}/settings`,
+    header: `${OFFICE_RELATIONSHIPS}/header`,
+    footer: `${OFFICE_RELATIONSHIPS}/footer`,
+    /** Propriétés du document (`docProps/core.xml`), relation du paquet (`_rels/.rels`). */
+    coreProperties: `${PACKAGE_RELATIONSHIPS}/metadata/core-properties`,
+};
+const EMPTY_RELS = `<Relationships xmlns="${RELATIONSHIPS_NS}"/>`;
+const DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+/** Table des relations d'une partie, créée (en mémoire) vide si le fichier `.rels` manque. */
+export class RelationshipTable {
+    store;
+    path;
+    partPath;
+    doc;
+    missing;
+    entries = new Map();
+    nextNumber = 1;
+    constructor(store, path, partPath, doc, 
+    /** Vrai tant que le `.rels` n'existe pas dans le paquet : il sera créé au premier ajout. */
+    missing) {
+        this.store = store;
+        this.path = path;
+        this.partPath = partPath;
+        this.doc = doc;
+        this.missing = missing;
+        for (const rel of Array.from(doc.documentElement.children)) {
+            if (rel.localName !== 'Relationship')
+                continue;
+            const id = rel.getAttribute('Id') ?? '';
+            const target = rel.getAttribute('Target') ?? '';
+            if (!id || !target)
+                continue;
+            const external = rel.getAttribute('TargetMode') === 'External';
+            this.entries.set(id, {
+                id,
+                type: rel.getAttribute('Type') ?? '',
+                target,
+                resolved: external ? target : resolveTarget(partPath, target),
+                external,
+            });
+            const numbered = /^rId(\d+)$/.exec(id);
+            if (numbered)
+                this.nextNumber = Math.max(this.nextNumber, Number(numbered[1]) + 1);
+        }
+    }
+    /** Ouvre les relations de `partPath`. Un `.rels` absent ou illisible donne une table vide. */
+    static async open(store, partPath) {
+        const path = relsPathOf(partPath);
+        const existing = await store.dom(path);
+        const doc = existing ?? store.parse(EMPTY_RELS);
+        return new RelationshipTable(store, path, partPath, doc, existing === null);
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    values() {
+        return this.entries.values();
+    }
+    /** Première relation de ce type dont la cible résolue (ou l'URL externe) est `resolved`. */
+    find(type, resolved, external) {
+        for (const entry of this.entries.values()) {
+            if (entry.type === type && entry.external === external && entry.resolved === resolved) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Ajoute une relation et rend son identifiant. `target` est une URL (externe) ou un
+     * chemin de partie du zip, réécrit relativement au dossier de la partie.
+     */
+    async add(type, target, external) {
+        const id = `rId${String(this.nextNumber)}`;
+        this.nextNumber += 1;
+        const written = external ? target : relativeTarget(this.partPath, target);
+        const element = this.doc.createElementNS(RELATIONSHIPS_NS, 'Relationship');
+        element.setAttribute('Id', id);
+        element.setAttribute('Type', type);
+        element.setAttribute('Target', written);
+        if (external)
+            element.setAttribute('TargetMode', 'External');
+        this.doc.documentElement.appendChild(element);
+        this.entries.set(id, { id, type, target: written, resolved: target, external });
+        if (this.missing) {
+            this.store.create(this.path, this.doc, DECLARATION);
+            this.missing = false;
+        }
+        else {
+            await this.store.markChanged(this.path);
+        }
+        return id;
+    }
+    /** Identifiant d'une relation de ce type vers cette cible : existante, sinon ajoutée. */
+    async ensure(type, target, external) {
+        return this.find(type, target, external)?.id ?? this.add(type, target, external);
+    }
+}
+/**
+ * Cible relative au dossier de la partie : `word/media/a.png` depuis `word/document.xml`
+ * → `media/a.png` ; hors du dossier, chemin absolu `/x/y.xml` (que Word accepte).
+ */
+export function relativeTarget(partPath, target) {
+    const dir = directoryOf(partPath);
+    return target.startsWith(dir) ? target.slice(dir.length) : `/${target}`;
+}
+//# sourceMappingURL=relationships.js.map

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

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

package/dist/docx/writer/settings-merge.d.ts

@@ -0,0 +1,21 @@
+import type { DocxPackage } from '../reader/types';
+import { type RelationshipTable } from './relationships';
+import { type PartStore } from './xml-io';
+export interface SettingsMergeInput {
+    readonly template: PartStore;
+    readonly pkg: DocxPackage;
+    readonly mainPart: string;
+    readonly relationships: RelationshipTable;
+    /** `Override` à ajouter à `[Content_Types].xml` si la partie est créée. */
+    readonly overrides: Map<string, string>;
+    /** Poser `<w:updateFields w:val="true"/>` (table des matières). */
+    readonly updateFields?: boolean;
+    /** Poser `<w:evenAndOddHeaders/>` (en-tête ou pied de pages paires greffé). */
+    readonly evenAndOddHeaders?: boolean;
+}
+/**
+ * Pose les réglages demandés dans `settings.xml` du gabarit. Rend le chemin de la partie
+ * si elle a été réécrite ou créée, `null` sinon.
+ */
+export declare function ensureSettings(input: SettingsMergeInput): Promise<string | null>;
+//# sourceMappingURL=settings-merge.d.ts.map

package/dist/docx/writer/settings-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/settings-merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAML,KAAK,SAAS,EACf,MAAM,UAAU,CAAC;AA2HlB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAsBD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBtF"}