@aster-editor/word 0.4.3 → 0.5.0

package/dist/docx/reader/units.js

@@ -0,0 +1,177 @@
+/**
+ * Conversions d'unités et de couleurs OOXML, partagées par tous les modules du lecteur
+ * (L24 les crée, L25 les lit). Les twips (1/20 pt), demi-points, huitièmes de point et
+ * EMU n'existent que dans le paquet `word` : tout ce qui sort est en points, millimètres
+ * ou pixels, arrondi à deux décimales.
+ */
+const TWIPS_PER_PT = 20;
+const TWIPS_PER_MM = 1440 / 25.4;
+const EMU_PER_PT = 12700;
+const EMU_PER_PX = 9525;
+/** Arrondi à deux décimales, sans flottement (`0.1 + 0.2`). */
+export function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Nombre décimal strict : ni hexadécimal (`0x20`), ni exposant (`1e300`), ni `Infinity`. */
+const DECIMAL_NUMBER = /^-?\d+(?:\.\d+)?$/;
+/**
+ * Entier d'un attribut OOXML, `undefined` si absent ou non numérique. Les valeurs
+ * décimales (`"12.5"`, tolérées par certains producteurs) sont acceptées ; tout ce que
+ * `Number()` accepterait en plus (hexadécimal, exposant, espaces internes) est rejeté.
+ */
+export function numberAttr(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (!DECIMAL_NUMBER.test(trimmed))
+        return undefined;
+    const parsed = Number(trimmed);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/**
+ * Bornes de Word (ce que son interface accepte), en points : une valeur hors de ces
+ * bornes vient d'un producteur cassé ou d'un document hostile et est ignorée, comme une
+ * valeur non numérique — jamais écrite en CSS, jamais une exception.
+ */
+export const WORD_LIMITS = {
+    /** Taille de police `w:sz` : 1 à 1638 pt. */
+    fontSizeMinPt: 1,
+    fontSizeMaxPt: 1638,
+    /** Largeur de bordure `w:sz` (huitièmes) : 12 pt au plus. */
+    borderMaxPt: 12,
+    /** Retraits, espacements avant/après, interligne exact, espacement de caractères : ±1584 pt. */
+    distanceMaxPt: 1584,
+    /** Interligne multiple (`w:lineRule="auto"`) : 132 lignes au plus. */
+    lineMultipleMax: 132,
+};
+/** `value` s'il est dans `[min, max]`, sinon `undefined` (valeur hors bornes ignorée). */
+export function bounded(value, min, max) {
+    return value !== undefined && value >= min && value <= max ? value : undefined;
+}
+/** Distance signée (retrait, espacement) bornée à ±1584 pt. */
+export function boundedDistancePt(value) {
+    return bounded(value, -WORD_LIMITS.distanceMaxPt, WORD_LIMITS.distanceMaxPt);
+}
+/**
+ * Nom de police acceptable : lettres, chiffres, espace, point, tiret, 64 caractères au
+ * plus (`Arial Narrow`, `Wingdings 2`, `Noto Sans CJK`). Tout le reste — en particulier
+ * un `;` ou un `(` qui ferait sortir de la déclaration `font-family` — est ignoré.
+ */
+const FONT_NAME = /^[\w .-]{1,64}$/u;
+/** Nom de police validé et épuré des espaces de bord, `undefined` s'il est irrecevable. */
+export function fontName(value) {
+    const trimmed = (value ?? '').trim();
+    return FONT_NAME.test(trimmed) ? trimmed : undefined;
+}
+/** Identifiant CSS simple : pas d'espace, pas de point, ne commence pas par un chiffre. */
+const CSS_IDENTIFIER = /^-?[A-Za-z_][\w-]*$/;
+/**
+ * Valeur CSS de `font-family` pour un nom validé par `fontName` : citée entre guillemets
+ * dès qu'elle n'est pas un identifiant CSS (`"Wingdings 2"`, `"Arial Narrow"`), sinon
+ * telle quelle (`Calibri`). Le nom ne contient ni `"` ni `\`, aucun échappement n'est
+ * nécessaire ; le core relit la valeur citée telle quelle et la ré-émet à l'identique.
+ */
+export function cssFontFamily(name) {
+    return CSS_IDENTIFIER.test(name) ? name : `"${name}"`;
+}
+/** Twips → points (`240` → `12`). */
+export function twipsToPt(twips) {
+    return round2(twips / TWIPS_PER_PT);
+}
+/** Twips → millimètres (`1440` → `25.4`). */
+export function twipsToMm(twips) {
+    return round2(twips / TWIPS_PER_MM);
+}
+/** Demi-points (`w:sz`) → points (`22` → `11`). */
+export function halfPointsToPt(halfPoints) {
+    return round2(halfPoints / 2);
+}
+/** Huitièmes de point (`w:sz` des bordures) → points (`4` → `0.5`). */
+export function eighthPointsToPt(eighths) {
+    return round2(eighths / 8);
+}
+/** EMU → points (`127000` → `10`). */
+export function emuToPt(emu) {
+    return round2(emu / EMU_PER_PT);
+}
+/** EMU → pixels CSS à 96 dpi (`952500` → `100`). */
+export function emuToPx(emu) {
+    return round2(emu / EMU_PER_PX);
+}
+/** Cinquantièmes de pour cent (`w:w w:type="pct"`, `5000` → `100`). */
+export function fiftiethsToPercent(fiftieths) {
+    return round2(fiftieths / 50);
+}
+/** Interligne multiple `w:line` en 240e (`276` → `1.15`). */
+export function lineToMultiple(line) {
+    return round2(line / 240);
+}
+/** Couleur `#rrggbb` minuscule : `RRGGBB` → `#rrggbb` ; `auto`, `none`, vide ou invalide → `undefined`. */
+export function hexColor(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim().replace(/^#/, '');
+    if (!/^[0-9a-fA-F]{6}$/.test(trimmed))
+        return undefined;
+    return `#${trimmed.toLowerCase()}`;
+}
+/** Couleur de bordure : comme `hexColor` mais `auto` (et absent) → noir, comme Word l'affiche. */
+export function borderColor(value) {
+    return hexColor(value) ?? '#000000';
+}
+/**
+ * Surlignages nommés de Word (`w:highlight`), valeurs d'affichage de Word. Clés en
+ * minuscules : la recherche se fait sur le nom abaissé (`darkBlue`, `DarkBlue` et
+ * `darkblue` désignent la même couleur).
+ */
+const HIGHLIGHT_COLORS = {
+    yellow: '#ffff00',
+    green: '#00ff00',
+    cyan: '#00ffff',
+    magenta: '#ff00ff',
+    blue: '#0000ff',
+    red: '#ff0000',
+    darkblue: '#000080',
+    darkcyan: '#008080',
+    darkgreen: '#008000',
+    darkmagenta: '#800080',
+    darkred: '#800000',
+    darkyellow: '#808000',
+    darkgray: '#808080',
+    lightgray: '#c0c0c0',
+    black: '#000000',
+    white: '#ffffff',
+};
+/** Surlignage nommé → `#rrggbb`, `none` ou inconnu → `undefined`. */
+export function highlightColor(name) {
+    if (!name)
+        return undefined;
+    return HIGHLIGHT_COLORS[name.trim().toLowerCase()];
+}
+/**
+ * Style de bordure OOXML (`w:val`) → style du contrat. `nil`/`none` → `null` (pas de
+ * bordure, annule une bordure héritée). Les motifs exotiques (3D, artistiques) sont
+ * ramenés au trait le plus proche.
+ */
+export function borderStyleOf(value) {
+    const val = (value ?? '').trim();
+    if (val === '' || val === 'nil' || val === 'none')
+        return null;
+    if (/^(?:dotted|dotDash|dotDotDash)$/i.test(val))
+        return val === 'dotted' ? 'dotted' : 'dashed';
+    if (/^dash/i.test(val))
+        return 'dashed';
+    if (/^(?:double|triple|thinThick|thickThin|thinThickThin|thickThinThick)/i.test(val)) {
+        return 'double';
+    }
+    return 'solid';
+}
+/**
+ * Booléen OOXML (`w:b`, `w:i`, `w:keepNext`…) : l'élément présent sans `w:val` vaut
+ * vrai ; `0`, `false`, `off` valent faux (et annulent la valeur héritée).
+ */
+export function onOff(value) {
+    const val = (value ?? '').trim().toLowerCase();
+    return val === '' || val === '1' || val === 'true' || val === 'on';
+}
+//# sourceMappingURL=units.js.map

package/dist/docx/reader/units.js.map

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

package/dist/docx/types.d.ts

@@ -1,4 +1,4 @@
-import type { AsterVariable, UploadHandler } from '@aster-editor/core';
+import type { AsterVariable, DocumentLayout, UploadHandler } from '@aster-editor/core';
 /**
  * Entrée acceptée par `importDocx` : un `File` du navigateur, les octets bruts, ou une
  * vue typée (`Uint8Array`, `Buffer` Node) dont seule la fenêtre visible est lue.
@@ -13,7 +13,7 @@ export type DocxInput = File | ArrayBuffer | ArrayBufferView;
  * - `variables-preprocess-failed` : le prétraitement des champs de fusion et contrôles de contenu
  *   a échoué (archive ou XML illisible) ; le document est importé sans, les `{{nom}}` saisis restent détectés.
  */
-export type DocxImportWarningCode = 'mammoth' | 'image-upload-failed' | 'footnotes-dropped' | 'unsupported-style' | 'variables-preprocess-failed';
+export type DocxImportWarningCode = 'mammoth' | 'image-upload-failed' | 'footnotes-dropped' | 'unsupported-style' | 'variables-preprocess-failed' | 'image-skipped' | 'object-lost' | 'reader';
 /** Avertissement remonté par l'import : un élément Word n'a pas pu être converti fidèlement. */
 export interface DocxImportWarning {
     /** Code stable, voir `DocxImportWarningCode`. */
@@ -69,6 +69,30 @@ export interface DocxImportOptions {
      * utile pour nettoyer un document Word qui espace ses blocs avec des lignes vides.
      */
     emptyParagraphs?: 'keep' | 'drop';
+    /**
+     * Chemin de lecture. `styled` (défaut du composant Angular, de la démo et du playground ; défaut de la lib prévu en 0.6) : lecteur OOXML d'Aster, HTML
+     * stylé (polices, interlignes, bordures, tableaux complets, listes fidèles), `layout`
+     * renseigné. `semantic` : mammoth, HTML sémantique sans mise en forme, comportement
+     * des versions 0.4.x.
+     */
+    fidelity?: 'styled' | 'semantic';
+}
+/** Nature d'un objet Word que l'éditeur ne sait pas représenter. */
+export type DocxLostKind = 'textbox' | 'shape' | 'smartart' | 'chart' | 'equation' | 'comment' | 'revision' | 'field' | 'embedded-object' | 'unknown';
+/** Où l'objet se trouvait dans le document. */
+export type DocxLostWhere = 'body' | 'header' | 'footer' | 'footnote' | 'endnote';
+/**
+ * Objet non représentable rencontré à l'import. Hors du corps, il est conservé tel quel
+ * dans le gabarit ; dans le corps, il est remplacé par son texte quand il en a un et
+ * signalé ici (et par un avertissement `object-lost`).
+ */
+export interface DocxLostObject {
+    readonly kind: DocxLostKind;
+    readonly where: DocxLostWhere;
+    /** Texte de remplacement inséré dans le corps, s'il y en a un. */
+    readonly text?: string;
+    /** Détail lisible : nom de la forme, type d'objet incorporé… */
+    readonly detail?: string;
 }
 /**
  * Résultat de `importDocx` : le HTML à donner à l'éditeur et la liste, souvent vide, de
@@ -85,5 +109,19 @@ export interface DocxImportResult {
      * en-têtes et pieds de page, que mammoth ne rend pas. Vide si aucune.
      */
     variables: readonly AsterVariable[];
+    /**
+     * Mise en page lue dans la dernière section du document (format, orientation, marges,
+     * colonnes, police par défaut, langue, en-têtes et pieds en HTML stylé). Objet vide en
+     * mode `semantic`.
+     */
+    layout: DocumentLayout;
+    /**
+     * Le `.docx` d'origine, intact, à repasser à `exportDocx({ template })` pour que tout ce
+     * qui n'est pas le corps (styles, numérotation, thème, en-têtes, sections) ressorte
+     * identique. C'est le tampon reçu, pas une copie.
+     */
+    template: ArrayBuffer;
+    /** Objets non représentables rencontrés dans le corps ou les parties lues. Vide en mode `semantic`. */
+    lost: readonly DocxLostObject[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/docx/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docx/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,WAAW,GAAG,eAAe,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,6BAA6B,CAAC;AAElC,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC5D;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE7E,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,kGAAkG;IAClG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,mFAAmF;IACnF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,0GAA0G;IAC1G,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;OAIG;IACH,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docx/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEvF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,WAAW,GAAG,eAAe,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,6BAA6B,GAC7B,eAAe,GACf,aAAa,GACb,QAAQ,CAAC;AAEb,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC5D;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAE7E,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,kGAAkG;IAClG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,mFAAmF;IACnF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,0GAA0G;IAC1G,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAClC;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,iBAAiB,GACjB,SAAS,CAAC;AAEd,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAElF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC;;;;OAIG;IACH,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;;;OAIG;IACH,QAAQ,EAAE,WAAW,CAAC;IACtB,uGAAuG;IACvG,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;CACjC"}

package/dist/docx/writer/content-types.d.ts

@@ -0,0 +1,30 @@
+import type { PartStore } from './xml-io';
+/**
+ * `[Content_Types].xml` du gabarit : on y **ajoute** les types par défaut des extensions
+ * d'images nouvelles et les `Override` des parties créées (numérotation, notes). Rien
+ * n'est retiré ni réordonné ; sans ajout, la partie n'est pas réécrite.
+ */
+/** Chemin de la partie des types de contenu. */
+export declare const CONTENT_TYPES_PATH = "[Content_Types].xml";
+/** Types de contenu des parties que la greffe peut créer. */
+export declare const PART_CONTENT_TYPES: {
+    readonly numbering: "application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml";
+    readonly footnotes: "application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml";
+    readonly header: "application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml";
+    readonly footer: "application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml";
+    readonly settings: "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml";
+    readonly coreProperties: "application/vnd.openxmlformats-package.core-properties+xml";
+};
+/** Type MIME d'une extension d'image, `application/octet-stream` sinon. */
+export declare function imageContentType(extension: string): string;
+/** Ajouts à faire : extensions (`Default`) et parties (`Override`, chemin sans `/` initial). */
+export interface ContentTypeAdditions {
+    readonly defaults: ReadonlyMap<string, string>;
+    readonly overrides: ReadonlyMap<string, string>;
+}
+/**
+ * Complète `[Content_Types].xml` avec les entrées manquantes. Rend vrai si la partie a
+ * été modifiée. Un gabarit sans cette partie (archive non conforme) la reçoit entière.
+ */
+export declare function ensureContentTypes(store: PartStore, additions: ContentTypeAdditions): Promise<boolean>;
+//# sourceMappingURL=content-types.d.ts.map

package/dist/docx/writer/content-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/content-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AAEH,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAMxD,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAYX,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,OAAO,CAAC,CA6ClB"}

package/dist/docx/writer/content-types.js

@@ -0,0 +1,81 @@
+/**
+ * `[Content_Types].xml` du gabarit : on y **ajoute** les types par défaut des extensions
+ * d'images nouvelles et les `Override` des parties créées (numérotation, notes). Rien
+ * n'est retiré ni réordonné ; sans ajout, la partie n'est pas réécrite.
+ */
+/** Chemin de la partie des types de contenu. */
+export const CONTENT_TYPES_PATH = '[Content_Types].xml';
+const CONTENT_TYPES_NS = 'http://schemas.openxmlformats.org/package/2006/content-types';
+const WORDPROCESSING = 'application/vnd.openxmlformats-officedocument.wordprocessingml';
+/** Types de contenu des parties que la greffe peut créer. */
+export const PART_CONTENT_TYPES = {
+    numbering: `${WORDPROCESSING}.numbering+xml`,
+    footnotes: `${WORDPROCESSING}.footnotes+xml`,
+    header: `${WORDPROCESSING}.header+xml`,
+    footer: `${WORDPROCESSING}.footer+xml`,
+    settings: `${WORDPROCESSING}.settings+xml`,
+    coreProperties: 'application/vnd.openxmlformats-package.core-properties+xml',
+};
+/** Types MIME des images que l'export embarque, par extension. */
+const IMAGE_CONTENT_TYPES = {
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    bmp: 'image/bmp',
+    svg: 'image/svg+xml',
+};
+/** Type MIME d'une extension d'image, `application/octet-stream` sinon. */
+export function imageContentType(extension) {
+    return IMAGE_CONTENT_TYPES[extension.toLowerCase()] ?? 'application/octet-stream';
+}
+/**
+ * Complète `[Content_Types].xml` avec les entrées manquantes. Rend vrai si la partie a
+ * été modifiée. Un gabarit sans cette partie (archive non conforme) la reçoit entière.
+ */
+export async function ensureContentTypes(store, additions) {
+    if (additions.defaults.size === 0 && additions.overrides.size === 0)
+        return false;
+    let doc = await store.dom(CONTENT_TYPES_PATH);
+    if (!doc) {
+        doc = store.parse(`<Types xmlns="${CONTENT_TYPES_NS}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/></Types>`);
+        store.create(CONTENT_TYPES_PATH, doc, '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>');
+    }
+    const root = doc.documentElement;
+    const existingDefaults = new Set();
+    const existingOverrides = new Set();
+    for (const child of Array.from(root.children)) {
+        if (child.localName === 'Default') {
+            existingDefaults.add((child.getAttribute('Extension') ?? '').toLowerCase());
+        }
+        else if (child.localName === 'Override') {
+            existingOverrides.add(child.getAttribute('PartName') ?? '');
+        }
+    }
+    let changed = false;
+    for (const [extension, type] of additions.defaults) {
+        if (existingDefaults.has(extension.toLowerCase()))
+            continue;
+        const element = doc.createElementNS(CONTENT_TYPES_NS, 'Default');
+        element.setAttribute('Extension', extension);
+        element.setAttribute('ContentType', type);
+        // Les `Default` précèdent les `Override` dans les fichiers de Word : on garde cet ordre.
+        const firstOverride = Array.from(root.children).find((child) => child.localName === 'Override');
+        root.insertBefore(element, firstOverride ?? null);
+        changed = true;
+    }
+    for (const [path, type] of additions.overrides) {
+        const partName = path.startsWith('/') ? path : `/${path}`;
+        if (existingOverrides.has(partName))
+            continue;
+        const element = doc.createElementNS(CONTENT_TYPES_NS, 'Override');
+        element.setAttribute('PartName', partName);
+        element.setAttribute('ContentType', type);
+        root.appendChild(element);
+        changed = true;
+    }
+    if (changed)
+        await store.markChanged(CONTENT_TYPES_PATH);
+    return changed;
+}
+//# sourceMappingURL=content-types.js.map

package/dist/docx/writer/content-types.js.map

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

package/dist/docx/writer/core-properties.d.ts

@@ -0,0 +1,16 @@
+import type { DocxPackage } from '../reader/types';
+import type { PartStore } from './xml-io';
+export interface CorePropertiesInput {
+    readonly template: PartStore;
+    readonly pkg: DocxPackage;
+    /** `Override` à ajouter à `[Content_Types].xml` si la partie est créée. */
+    readonly overrides: Map<string, string>;
+    readonly title?: string;
+    readonly creator?: string;
+}
+/**
+ * Réécrit `dc:title` / `dc:creator` du gabarit. Rend le chemin de la partie si elle a été
+ * réécrite ou créée, `null` sinon.
+ */
+export declare function writeCoreProperties(input: CorePropertiesInput): Promise<string | null>;
+//# sourceMappingURL=core-properties.d.ts.map

package/dist/docx/writer/core-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-properties.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/core-properties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAwB1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB5F"}

package/dist/docx/writer/core-properties.js

@@ -0,0 +1,64 @@
+import { sanitizeXmlText } from '../../export/sanitize';
+import { PART_CONTENT_TYPES } from './content-types';
+import { REL_TYPE, RelationshipTable } from './relationships';
+/**
+ * Propriétés du document (`docProps/core.xml`) dans le gabarit : `dc:title` et
+ * `dc:creator` sont réécrits quand `options.title` / `options.creator` sont fournis, les
+ * autres propriétés (dates, révision, mots-clés…) restent telles quelles. Sans option, la
+ * partie n'est pas touchée ; une valeur déjà identique ne la réécrit pas non plus. Un
+ * gabarit sans cette partie la reçoit, avec sa relation de paquet et son type de contenu.
+ */
+const CP_NS = 'http://schemas.openxmlformats.org/package/2006/metadata/core-properties';
+const DC_NS = 'http://purl.org/dc/elements/1.1/';
+const DCTERMS_NS = 'http://purl.org/dc/terms/';
+const DCMITYPE_NS = 'http://purl.org/dc/dcmitype/';
+const XSI_NS = 'http://www.w3.org/2001/XMLSchema-instance';
+const CORE_PATH = 'docProps/core.xml';
+const DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+const EMPTY_CORE = `<cp:coreProperties xmlns:cp="${CP_NS}" xmlns:dc="${DC_NS}" xmlns:dcterms="${DCTERMS_NS}"` +
+    ` xmlns:dcmitype="${DCMITYPE_NS}" xmlns:xsi="${XSI_NS}"/>`;
+/** Pose `dc:<name>` à `value` (créé s'il manque). Rend vrai si le texte a changé. */
+function setDublinCore(doc, name, value) {
+    const root = doc.documentElement;
+    let element = Array.from(root.children).find((child) => child.namespaceURI === DC_NS && child.localName === name);
+    if (!element) {
+        element = doc.createElementNS(DC_NS, `dc:${name}`);
+        root.appendChild(element);
+    }
+    else if (element.textContent === value) {
+        return false;
+    }
+    element.textContent = value;
+    return true;
+}
+/**
+ * Réécrit `dc:title` / `dc:creator` du gabarit. Rend le chemin de la partie si elle a été
+ * réécrite ou créée, `null` sinon.
+ */
+export async function writeCoreProperties(input) {
+    if (input.title === undefined && input.creator === undefined)
+        return null;
+    let path = await input.pkg.related('', '/core-properties');
+    let doc = path ? await input.template.dom(path) : null;
+    let changed = false;
+    if (!doc) {
+        path = CORE_PATH;
+        doc = input.template.parse(EMPTY_CORE);
+        input.template.create(path, doc, DECLARATION);
+        const rootRelationships = await RelationshipTable.open(input.template, '');
+        await rootRelationships.ensure(REL_TYPE.coreProperties, path, false);
+        input.overrides.set(path, PART_CONTENT_TYPES.coreProperties);
+        changed = true;
+    }
+    if (input.title !== undefined) {
+        changed = setDublinCore(doc, 'title', sanitizeXmlText(input.title)) || changed;
+    }
+    if (input.creator !== undefined) {
+        changed = setDublinCore(doc, 'creator', sanitizeXmlText(input.creator)) || changed;
+    }
+    if (!changed || !path)
+        return null;
+    await input.template.markChanged(path);
+    return path;
+}
+//# sourceMappingURL=core-properties.js.map

package/dist/docx/writer/core-properties.js.map

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

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

@@ -0,0 +1,30 @@
+import { type RelationshipTable } from './relationships';
+import { type PartStore } from './xml-io';
+/**
+ * Notes de bas de page du corps greffé. Les notes générées sont **ajoutées** à
+ * `footnotes.xml` du gabarit sous des identifiants libres (les séparateurs du gabarit
+ * sont conservés) ; sans cette partie dans le gabarit, elle est créée avec les
+ * séparateurs de l'export. Les notes du gabarit que le corps n'appelle plus restent dans
+ * la partie : Word les ignore.
+ */
+export interface FootnoteMergerInput {
+    readonly template: PartStore;
+    readonly generated: PartStore;
+    readonly mainPart: string;
+    /** Chemin de `footnotes.xml` du gabarit (relation `/footnotes`), `null` s'il n'en a pas. */
+    readonly templatePath: string | null;
+    readonly relationships: RelationshipTable;
+}
+export interface FootnoteMerger {
+    /** `w:id` d'un `w:footnoteReference` généré → identifiant dans le gabarit. */
+    remap(id: string): Promise<string>;
+    /** Notes copiées dans le gabarit : leurs paragraphes passent aussi par la greffe des styles. */
+    readonly imported: () => readonly Element[];
+    readonly createdPart: () => {
+        readonly path: string;
+        readonly contentType: string;
+    } | null;
+}
+/** Crée le fusionneur de notes du gabarit. */
+export declare function createFootnoteMerger(input: FootnoteMergerInput): Promise<FootnoteMerger>;
+//# sourceMappingURL=footnotes-merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footnotes-merge.d.ts","sourceRoot":"","sources":["../../../src/docx/writer/footnotes-merge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAyD,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjG;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,MAAM,SAAS,OAAO,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5F;AAOD,8CAA8C;AAC9C,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAkE9F"}

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

@@ -0,0 +1,71 @@
+import { 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';
+/** Notes techniques de Word, jamais référencées depuis le corps. */
+const TECHNICAL_TYPES = new Set(['separator', 'continuationSeparator']);
+const FOOTNOTES_FILE = 'footnotes.xml';
+/** Crée le fusionneur de notes du gabarit. */
+export async function createFootnoteMerger(input) {
+    const generatedDoc = await input.generated.dom('word/footnotes.xml');
+    let templatePath = input.templatePath;
+    let templateDoc = templatePath ? await input.template.dom(templatePath) : null;
+    let created = null;
+    const remapped = new Map();
+    const imported = [];
+    const nextId = () => {
+        let max = 0;
+        if (templateDoc) {
+            for (const note of childrenNamed(templateDoc.documentElement, 'footnote')) {
+                const value = Number(wordAttr(note, 'id'));
+                if (Number.isFinite(value) && value > max)
+                    max = value;
+            }
+        }
+        return String(max + 1);
+    };
+    /** `footnotes.xml` du gabarit, créée (séparateurs compris) à la première note copiée. */
+    const ensureTemplateDoc = async () => {
+        if (templateDoc)
+            return templateDoc;
+        if (!generatedDoc)
+            return null;
+        templatePath = templatePath ?? `${directoryOf(input.mainPart)}${FOOTNOTES_FILE}`;
+        templateDoc = emptyDocumentLike(generatedDoc);
+        for (const note of childrenNamed(generatedDoc.documentElement, 'footnote')) {
+            if (TECHNICAL_TYPES.has(wordAttr(note, 'type'))) {
+                templateDoc.documentElement.appendChild(templateDoc.importNode(note, true));
+            }
+        }
+        input.template.create(templatePath, templateDoc, '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>');
+        await input.relationships.ensure(REL_TYPE.footnotes, templatePath, false);
+        created = { path: templatePath, contentType: PART_CONTENT_TYPES.footnotes };
+        return templateDoc;
+    };
+    return {
+        async remap(id) {
+            const known = remapped.get(id);
+            if (known !== undefined)
+                return known;
+            const target = await ensureTemplateDoc();
+            const note = generatedDoc
+                ? childrenNamed(generatedDoc.documentElement, 'footnote').find((candidate) => wordAttr(candidate, 'id') === id)
+                : undefined;
+            if (!target || !templatePath || !note) {
+                remapped.set(id, id);
+                return id;
+            }
+            const newId = nextId();
+            const clone = target.importNode(note, true);
+            setWordAttr(clone, 'id', newId);
+            target.documentElement.appendChild(clone);
+            imported.push(clone);
+            await input.template.markChanged(templatePath);
+            remapped.set(id, newId);
+            return newId;
+        },
+        imported: () => imported,
+        createdPart: () => created,
+    };
+}
+//# sourceMappingURL=footnotes-merge.js.map

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

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

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