@aster-editor/word 0.4.3 → 0.5.0

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

@@ -0,0 +1,181 @@
+import type { BlockBorder, CellVerticalAlign, DecorationStyle, DocumentLayout, OrderedListType, UploadHandler } from '@aster-editor/core';
+import type { DocxImportWarning, DocxLostObject, DocxLostWhere } from '../types';
+/**
+ * Types du lecteur OOXML (session 3). Figés en phase 0 : `index.ts` orchestre, chaque
+ * module (`styles`, `runs`, `paragraphs`, `tables`, `lists`, `images`, `notes`,
+ * `headers`, `sections`, `lost`) implémente une de ces interfaces et ne connaît les
+ * autres que par le `ConverterContext`.
+ */
+/** Parseur XML injectable (`DOMParser` global par défaut), jamais le `document`. */
+export type XmlParse = (xml: string) => Document;
+export interface ReaderOptions {
+    readonly upload?: UploadHandler;
+    /** Conserver les notes en liste finale. */
+    readonly footnotes: boolean;
+    readonly emptyParagraphs: 'keep' | 'drop';
+    readonly parseXml: XmlParse;
+}
+export interface ReaderResult {
+    readonly html: string;
+    readonly layout: DocumentLayout;
+    readonly lost: readonly DocxLostObject[];
+    readonly warnings: readonly DocxImportWarning[];
+}
+/** Relation d'une partie (`_rels/*.rels`). `target` est déjà résolu en chemin absolu du zip. */
+export interface Relationship {
+    readonly id: string;
+    readonly type: string;
+    readonly target: string;
+    readonly external: boolean;
+}
+/** Accès en lecture au paquet `.docx` : parties XML parsées (en cache), binaires, relations. */
+export interface DocxPackage {
+    /** Chemin de la partie principale, en général `word/document.xml`. */
+    readonly mainPart: string;
+    has(path: string): boolean;
+    /** Partie XML parsée, `null` si absente ou illisible (avertissement posé par l'appelant). */
+    part(path: string): Promise<Document | null>;
+    binary(path: string): Promise<Uint8Array | null>;
+    /** Relations de la partie donnée, vide si elle n'en a pas. */
+    rels(partPath: string): Promise<ReadonlyMap<string, Relationship>>;
+    /** Partie liée par type (suffixe de l'URI, ex. `styles`, `numbering`, `footnotes`). */
+    related(partPath: string, typeSuffix: string): Promise<string | null>;
+}
+/** Propriétés de run résolues (style de caractère + style de paragraphe + défauts + directes). */
+export interface ResolvedRunProps {
+    readonly fontFamily?: string;
+    readonly fontSizePt?: number;
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+    readonly underline?: DecorationStyle | null;
+    readonly strike?: DecorationStyle | null;
+    readonly color?: string;
+    readonly highlight?: string;
+    readonly superscript?: boolean;
+    readonly subscript?: boolean;
+    readonly letterSpacingPt?: number;
+    readonly caps?: 'all' | 'small';
+    readonly runStyle?: string;
+    readonly lang?: string;
+}
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type ParagraphAlign = 'left' | 'center' | 'right' | 'justify';
+/** Propriétés de paragraphe résolues (style hérité + propriétés directes). */
+export interface ResolvedParagraphProps {
+    readonly styleId?: string;
+    readonly headingLevel?: HeadingLevel;
+    readonly align?: ParagraphAlign;
+    readonly lineHeight?: number;
+    readonly lineHeightPt?: number;
+    readonly spacingBeforePt?: number;
+    readonly spacingAfterPt?: number;
+    readonly indentLeftPt?: number;
+    readonly indentRightPt?: number;
+    readonly indentFirstLinePt?: number;
+    readonly borders?: readonly BlockBorder[];
+    readonly shading?: string;
+    readonly keepWithNext?: boolean;
+    readonly pageBreakBefore?: boolean;
+    readonly numbering?: {
+        readonly numId: string;
+        readonly level: number;
+    };
+    /** Défauts de run hérités du style de paragraphe, base de la résolution des runs. */
+    readonly runDefaults: ResolvedRunProps;
+}
+export interface TableStyleProps {
+    readonly borders?: readonly BlockBorder[];
+    readonly cellBorders?: readonly BlockBorder[];
+    readonly cellShading?: string;
+    readonly cellPaddingPt?: readonly [number, number, number, number];
+    readonly runDefaults?: ResolvedRunProps;
+}
+/** Résolution des styles (`styles.xml`, `docDefaults`, thème). Implémenté par `styles.ts` (L24). */
+export interface StyleResolver {
+    paragraph(pPr: Element | null): ResolvedParagraphProps;
+    run(rPr: Element | null, paragraph: ResolvedParagraphProps): ResolvedRunProps;
+    tableStyle(styleId: string | null): TableStyleProps | null;
+    defaultFont(): {
+        readonly family?: string;
+        readonly sizePt?: number;
+    };
+}
+export type ListFormat = 'bullet' | OrderedListType | 'none';
+export interface ListLevel {
+    readonly level: number;
+    readonly format: ListFormat;
+    /** Puce ou modèle de texte (`%1.`), tel que Word le donne. */
+    readonly text: string;
+    readonly start: number;
+    readonly indentLeftPt?: number;
+    readonly hangingPt?: number;
+}
+export interface ListDefinition {
+    readonly numId: string;
+    readonly levels: readonly ListLevel[];
+}
+/** Résolution de `numbering.xml`. Implémenté par `lists.ts` (L25). */
+export interface NumberingResolver {
+    definition(numId: string): ListDefinition | null;
+}
+export interface ParagraphBlock {
+    readonly kind: 'paragraph';
+    /** HTML complet du bloc (`<p …>…</p>` ou `<hN …>…</hN>`). */
+    readonly html: string;
+    readonly numbering?: {
+        readonly numId: string;
+        readonly level: number;
+    };
+    readonly isEmpty: boolean;
+}
+export interface TableBlock {
+    readonly kind: 'table';
+    readonly html: string;
+}
+/** Bloc déjà rendu : saut de page (`<hr data-page-break>`), texte d'un objet perdu… */
+export interface RawBlock {
+    readonly kind: 'raw';
+    readonly html: string;
+}
+export type Block = ParagraphBlock | TableBlock | RawBlock;
+/** Conversion des dessins. Implémenté par `images.ts` (L25). */
+export interface ImageConverter {
+    /** `<img …>` ou chaîne vide si l'image est ignorée (avertissement posé). */
+    drawing(drawing: Element, ctx: ConverterContext): Promise<string>;
+}
+/** Notes de bas de page et de fin. Implémenté par `notes.ts` (L25). */
+export interface NoteRegistry {
+    /** HTML inline de l'appel de note (`<sup data-footnote-ref="n">n</sup>`). */
+    reference(id: string, kind: 'footnote' | 'endnote', ctx: ConverterContext): string;
+    /** Liste finale des notes référencées, vide s'il n'y en a pas ou si `footnotes` est faux. */
+    render(ctx: ConverterContext): Promise<string>;
+}
+/** Points d'entrée de conversion, pour que les modules s'appellent sans dépendre des fichiers. */
+export interface BlockConverters {
+    paragraph(p: Element, ctx: ConverterContext): Promise<ParagraphBlock>;
+    table(tbl: Element, ctx: ConverterContext): Promise<TableBlock>;
+    /** Enfants bloc d'un conteneur (`w:body`, `w:tc`, `w:sdtContent`, `w:footnote`…). */
+    blocks(container: Element, ctx: ConverterContext): Promise<Block[]>;
+    /** Rendu HTML d'une suite de blocs, listes regroupées. */
+    render(blocks: readonly Block[], ctx: ConverterContext): string;
+}
+export interface ConverterContext {
+    readonly pkg: DocxPackage;
+    /** Partie en cours de lecture (chemin zip), pour les relations et les images. */
+    readonly part: string;
+    readonly where: DocxLostWhere;
+    readonly styles: StyleResolver;
+    readonly numbering: NumberingResolver;
+    readonly images: ImageConverter;
+    readonly notes: NoteRegistry;
+    readonly convert: BlockConverters;
+    readonly options: ReaderOptions;
+    readonly warnings: DocxImportWarning[];
+    readonly lost: DocxLostObject[];
+    /** Style de tableau courant (cellules), `null` hors tableau. */
+    readonly tableStyle: TableStyleProps | null;
+    readonly cellVerticalAlign?: CellVerticalAlign;
+}
+/** Contexte dérivé pour une autre partie (en-tête, note) ou un autre conteneur. */
+export type ContextPatch = Partial<Pick<ConverterContext, 'part' | 'where' | 'tableStyle' | 'cellVerticalAlign'>>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/docx/reader/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/docx/reader/types.ts"],"names":[],"mappings":""}

package/dist/docx/reader/units-blocks.d.ts

@@ -0,0 +1,75 @@
+import type { BlockBorder, BorderSide, BorderStyle } from '@aster-editor/core';
+/** Arrondi à deux décimales, pour ne jamais sortir `12.700000000000001`. */
+export declare function round2(value: number): number;
+/** Twips (1/20 pt) → points. */
+export declare function twipsToPt(twips: number): number;
+/** Twips → millimètres, deux décimales (`1134` → `20.0`, `720` → `12.7`). */
+export declare function twipsToMm(twips: number): number;
+/** Twips → pixels entiers (largeurs de colonnes Tiptap). */
+export declare function twipsToPx(twips: number): number;
+/** EMU (914 400 par pouce) → pixels entiers à 96 dpi. */
+export declare function emuToPx(emu: number): number;
+/** Points → pixels entiers à 96 dpi (dimensions VML `style="width:72pt"`). */
+export declare function ptToPx(points: number): number;
+/** Huitièmes de point (`w:sz` des bordures) → points. */
+export declare function eighthsToPt(eighths: number): number;
+/**
+ * Nombre lu dans un attribut `w:…`, `undefined` si absent ou non numérique. Volontairement
+ * tolérant (`Number()`) : les modules de blocs (L25) bornent ensuite les valeurs et
+ * avertissent (`1e12` → « hors des bornes ») ; le strict `numberAttr` d'`units.ts` sert
+ * aux runs et paragraphes.
+ */
+export declare function numericAttribute(element: Element | null, name: string): number | undefined;
+/** Vrai pour un attribut booléen Word absent (`<w:tblHeader/>` = vrai) ou valant `1`/`true`/`on`. */
+export declare function booleanAttribute(element: Element | null): boolean;
+/**
+ * Style CSS d'une bordure Word (`w:val`). `nil`/`none` → `null` (pas de bordure) ; les
+ * dizaines de styles décoratifs de Word sont ramenés aux quatre du contrat.
+ */
+export declare function borderStyleOf(value: string): BorderStyle | null;
+/** Couleur Word (`000000`, `auto`) → CSS `#rrggbb`, `auto` ou invalide → repli. */
+export declare function cssColor(value: string, fallback?: string): string;
+/** Couleur de fond d'un `w:shd` (`w:fill`), `undefined` si absente, `auto` ou non hexadécimale. */
+export declare function shadingColor(shd: Element | null): string | undefined;
+/** Noms des bordures d'un conteneur Word, côtés plus bordures intérieures de tableau. */
+export type BorderName = 'top' | 'right' | 'bottom' | 'left' | 'insideH' | 'insideV';
+/** Bordures lues : `null` = explicitement sans bordure (`nil`), absent = non précisé. */
+export type BorderMap = Partial<Record<BorderName, BlockBorder | null>>;
+/** Côtés CSS dans l'ordre de sérialisation du contrat. */
+export declare const CSS_SIDES: readonly BorderSide[];
+/** Bordure d'un élément `w:top`, `w:left`… `null` si `nil`/`none`. */
+export declare function readBorderElement(element: Element, side: BorderSide): BlockBorder | null;
+/**
+ * Lit `w:tblBorders`, `w:tcBorders` ou `w:pBdr`. Les bordures intérieures (`insideH`,
+ * `insideV`) sont rangées sous leur nom avec un côté provisoire, à re-côté par l'appelant.
+ */
+export declare function readBorders(container: Element | null): BorderMap;
+/** Bordure recôtée (`insideH` appliquée au bas d'une cellule, par exemple). */
+export declare function withSide(border: BlockBorder, side: BorderSide): BlockBorder;
+/** Liste de bordures → table par côté, pour fusionner style et propriétés directes. */
+export declare function bordersBySide(borders: readonly BlockBorder[] | undefined): Partial<Record<BorderSide, BlockBorder>>;
+/**
+ * Déclarations CSS `border-top: 0.5pt solid #000000`… dans l'ordre du contrat
+ * (`top`, `right`, `bottom`, `left`), les côtés absents étant omis.
+ */
+export declare function borderDeclarations(borders: Partial<Record<BorderSide, BlockBorder | null | undefined>>): (readonly [string, string | undefined])[];
+/** Marges `top right bottom left` en points. */
+export type PaddingPt = readonly [number, number, number, number];
+/** Marges partielles lues dans `w:tblCellMar` ou `w:tcMar`, en points. */
+export type PartialPadding = Partial<Record<BorderSide, number>>;
+/**
+ * Lit `w:tblCellMar` / `w:tcMar` : `w:top`, `w:left` (ou `w:start`), `w:bottom`, `w:right`
+ * (ou `w:end`) avec `w:w` en twips (`w:type="dxa"`) ou `nil` (0).
+ */
+export declare function readCellMargins(container: Element | null): PartialPadding;
+/**
+ * Fusionne des marges partielles, de la moins prioritaire à la plus prioritaire. Retourne
+ * `undefined` si aucune n'est définie (l'éditeur garde son défaut), sinon complète les
+ * côtés manquants avec les défauts de Word.
+ */
+export declare function mergePadding(base: PaddingPt | undefined, ...layers: readonly PartialPadding[]): PaddingPt | undefined;
+/** `padding: 2pt 4pt 2pt 4pt`, valeur CSS d'un `PaddingPt`. */
+export declare function paddingValue(padding: PaddingPt | undefined): string | undefined;
+/** Largeurs de colonnes `w:tblGrid/w:gridCol` en pixels entiers, vide sans grille. */
+export declare function readGridColumns(table: Element): number[];
+//# sourceMappingURL=units-blocks.d.ts.map

package/dist/docx/reader/units-blocks.d.ts.map

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

package/dist/docx/reader/units-blocks.js

@@ -0,0 +1,254 @@
+import { childrenNamed, wordAttribute } from '../preprocess/xml-utils';
+import { pt } from './html';
+/**
+ * Conversions d'unités et lecture des bordures et fonds pour les blocs du lecteur
+ * (tableaux, images, sections). Lot L25 ; L24 écrit ses propres conversions pour les
+ * runs et paragraphes dans `units.ts` : doublon assumé le temps de la vague, à fusionner
+ * par l'orchestrateur.
+ */
+const TWIPS_PER_PT = 20;
+const TWIPS_PER_INCH = 1440;
+const MM_PER_INCH = 25.4;
+const EMU_PER_INCH = 914400;
+const PX_PER_INCH = 96;
+const PT_PER_INCH = 72;
+/** Un twip = 1/15 px à 96 dpi, ce que Tiptap attend pour `colwidth`. */
+const TWIPS_PER_PX = 15;
+/** Arrondi à deux décimales, pour ne jamais sortir `12.700000000000001`. */
+export function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+/** Twips (1/20 pt) → points. */
+export function twipsToPt(twips) {
+    return round2(twips / TWIPS_PER_PT);
+}
+/** Twips → millimètres, deux décimales (`1134` → `20.0`, `720` → `12.7`). */
+export function twipsToMm(twips) {
+    return round2((twips / TWIPS_PER_INCH) * MM_PER_INCH);
+}
+/** Twips → pixels entiers (largeurs de colonnes Tiptap). */
+export function twipsToPx(twips) {
+    return Math.round(twips / TWIPS_PER_PX);
+}
+/** EMU (914 400 par pouce) → pixels entiers à 96 dpi. */
+export function emuToPx(emu) {
+    return Math.round((emu / EMU_PER_INCH) * PX_PER_INCH);
+}
+/** Points → pixels entiers à 96 dpi (dimensions VML `style="width:72pt"`). */
+export function ptToPx(points) {
+    return Math.round((points / PT_PER_INCH) * PX_PER_INCH);
+}
+/** Huitièmes de point (`w:sz` des bordures) → points. */
+export function eighthsToPt(eighths) {
+    return round2(eighths / 8);
+}
+/**
+ * Nombre lu dans un attribut `w:…`, `undefined` si absent ou non numérique. Volontairement
+ * tolérant (`Number()`) : les modules de blocs (L25) bornent ensuite les valeurs et
+ * avertissent (`1e12` → « hors des bornes ») ; le strict `numberAttr` d'`units.ts` sert
+ * aux runs et paragraphes.
+ */
+export function numericAttribute(element, name) {
+    if (!element)
+        return undefined;
+    const raw = wordAttribute(element, name);
+    if (raw === '')
+        return undefined;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : undefined;
+}
+/** Largeur de bordure maximale acceptée par Word : 12 pt (96 huitièmes). */
+const BORDER_MAX_PT = 12;
+/** Vrai pour un attribut booléen Word absent (`<w:tblHeader/>` = vrai) ou valant `1`/`true`/`on`. */
+export function booleanAttribute(element) {
+    if (!element)
+        return false;
+    const value = wordAttribute(element, 'val').toLowerCase();
+    return value === '' || value === '1' || value === 'true' || value === 'on';
+}
+const DASHED_STYLES = new Set([
+    'dashed',
+    'dashSmallGap',
+    'dotDash',
+    'dotDotDash',
+    'dashDotStroked',
+]);
+const DOTTED_STYLES = new Set(['dotted']);
+const DOUBLE_STYLES = new Set([
+    'double',
+    'triple',
+    'doubleWave',
+    'thinThickSmallGap',
+    'thickThinSmallGap',
+    'thinThickThinSmallGap',
+    'thinThickMediumGap',
+    'thickThinMediumGap',
+    'thinThickThinMediumGap',
+    'thinThickLargeGap',
+    'thickThinLargeGap',
+    'thinThickThinLargeGap',
+]);
+/**
+ * Style CSS d'une bordure Word (`w:val`). `nil`/`none` → `null` (pas de bordure) ; les
+ * dizaines de styles décoratifs de Word sont ramenés aux quatre du contrat.
+ */
+export function borderStyleOf(value) {
+    if (value === '' || value === 'nil' || value === 'none')
+        return null;
+    if (DASHED_STYLES.has(value))
+        return 'dashed';
+    if (DOTTED_STYLES.has(value))
+        return 'dotted';
+    if (DOUBLE_STYLES.has(value))
+        return 'double';
+    return 'solid';
+}
+const HEX_COLOR = /^[0-9a-f]{6}$/i;
+/** Couleur Word (`000000`, `auto`) → CSS `#rrggbb`, `auto` ou invalide → repli. */
+export function cssColor(value, fallback = '#000000') {
+    const trimmed = value.trim();
+    return HEX_COLOR.test(trimmed) ? `#${trimmed.toLowerCase()}` : fallback;
+}
+/** Couleur de fond d'un `w:shd` (`w:fill`), `undefined` si absente, `auto` ou non hexadécimale. */
+export function shadingColor(shd) {
+    if (!shd)
+        return undefined;
+    const fill = wordAttribute(shd, 'fill');
+    if (HEX_COLOR.test(fill))
+        return `#${fill.toLowerCase()}`;
+    // `w:val="solid"` : le motif plein prend la couleur `w:color`.
+    if (wordAttribute(shd, 'val') === 'solid') {
+        const color = wordAttribute(shd, 'color');
+        if (HEX_COLOR.test(color))
+            return `#${color.toLowerCase()}`;
+    }
+    return undefined;
+}
+/** Côtés CSS dans l'ordre de sérialisation du contrat. */
+export const CSS_SIDES = ['top', 'right', 'bottom', 'left'];
+const BORDER_ELEMENTS = new Map([
+    ['top', 'top'],
+    ['right', 'right'],
+    ['end', 'right'],
+    ['bottom', 'bottom'],
+    ['left', 'left'],
+    ['start', 'left'],
+    ['insideH', 'insideH'],
+    ['insideV', 'insideV'],
+]);
+/** Bordure d'un élément `w:top`, `w:left`… `null` si `nil`/`none`. */
+export function readBorderElement(element, side) {
+    const style = borderStyleOf(wordAttribute(element, 'val'));
+    if (!style)
+        return null;
+    const size = numericAttribute(element, 'sz') ?? 0;
+    const widthPt = eighthsToPt(size);
+    return {
+        side,
+        style,
+        // Un `w:sz` absent, nul ou hors bornes (> 12 pt) avec un style visible : filet fin.
+        widthPt: widthPt > 0 && widthPt <= BORDER_MAX_PT ? widthPt : 0.5,
+        color: cssColor(wordAttribute(element, 'color')),
+    };
+}
+/**
+ * Lit `w:tblBorders`, `w:tcBorders` ou `w:pBdr`. Les bordures intérieures (`insideH`,
+ * `insideV`) sont rangées sous leur nom avec un côté provisoire, à re-côté par l'appelant.
+ */
+export function readBorders(container) {
+    const map = {};
+    if (!container)
+        return map;
+    for (const child of Array.from(container.children)) {
+        const name = BORDER_ELEMENTS.get(child.localName);
+        if (!name)
+            continue;
+        const side = name === 'insideH' ? 'top' : name === 'insideV' ? 'left' : name;
+        map[name] = readBorderElement(child, side);
+    }
+    return map;
+}
+/** Bordure recôtée (`insideH` appliquée au bas d'une cellule, par exemple). */
+export function withSide(border, side) {
+    return border.side === side ? border : { ...border, side };
+}
+/** Liste de bordures → table par côté, pour fusionner style et propriétés directes. */
+export function bordersBySide(borders) {
+    const map = {};
+    for (const border of borders ?? [])
+        map[border.side] = border;
+    return map;
+}
+/**
+ * Déclarations CSS `border-top: 0.5pt solid #000000`… dans l'ordre du contrat
+ * (`top`, `right`, `bottom`, `left`), les côtés absents étant omis.
+ */
+export function borderDeclarations(borders) {
+    return CSS_SIDES.map((side) => {
+        const border = borders[side];
+        return [
+            `border-${side}`,
+            border ? `${pt(border.widthPt)} ${border.style} ${border.color}` : undefined,
+        ];
+    });
+}
+/**
+ * Lit `w:tblCellMar` / `w:tcMar` : `w:top`, `w:left` (ou `w:start`), `w:bottom`, `w:right`
+ * (ou `w:end`) avec `w:w` en twips (`w:type="dxa"`) ou `nil` (0).
+ */
+export function readCellMargins(container) {
+    const result = {};
+    if (!container)
+        return result;
+    for (const child of Array.from(container.children)) {
+        const name = BORDER_ELEMENTS.get(child.localName);
+        if (!name || name === 'insideH' || name === 'insideV')
+            continue;
+        const type = wordAttribute(child, 'type');
+        if (type === 'nil') {
+            result[name] = 0;
+            continue;
+        }
+        const width = numericAttribute(child, 'w');
+        if (width !== undefined)
+            result[name] = twipsToPt(width);
+    }
+    return result;
+}
+/** Marges de cellule par défaut de Word : 0 en haut et en bas, 108 twips (5,4 pt) à gauche et à droite. */
+const WORD_DEFAULT_PADDING = [0, 5.4, 0, 5.4];
+/**
+ * Fusionne des marges partielles, de la moins prioritaire à la plus prioritaire. Retourne
+ * `undefined` si aucune n'est définie (l'éditeur garde son défaut), sinon complète les
+ * côtés manquants avec les défauts de Word.
+ */
+export function mergePadding(base, ...layers) {
+    const merged = base
+        ? { top: base[0], right: base[1], bottom: base[2], left: base[3] }
+        : {};
+    for (const layer of layers)
+        Object.assign(merged, layer);
+    if (Object.keys(merged).length === 0)
+        return undefined;
+    return [
+        merged.top ?? WORD_DEFAULT_PADDING[0],
+        merged.right ?? WORD_DEFAULT_PADDING[1],
+        merged.bottom ?? WORD_DEFAULT_PADDING[2],
+        merged.left ?? WORD_DEFAULT_PADDING[3],
+    ];
+}
+/** `padding: 2pt 4pt 2pt 4pt`, valeur CSS d'un `PaddingPt`. */
+export function paddingValue(padding) {
+    return padding ? padding.map((value) => pt(value)).join(' ') : undefined;
+}
+/** Largeurs de colonnes `w:tblGrid/w:gridCol` en pixels entiers, vide sans grille. */
+export function readGridColumns(table) {
+    const grid = childrenNamed(table, 'tblGrid')[0];
+    if (!grid)
+        return [];
+    return childrenNamed(grid, 'gridCol')
+        .map((col) => numericAttribute(col, 'w'))
+        .filter((width) => width !== undefined)
+        .map(twipsToPx);
+}
+//# sourceMappingURL=units-blocks.js.map

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

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

package/dist/docx/reader/units.d.ts

@@ -0,0 +1,72 @@
+import type { BorderStyle } from '@aster-editor/core';
+/** Arrondi à deux décimales, sans flottement (`0.1 + 0.2`). */
+export declare function round2(value: number): number;
+/**
+ * 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 declare function numberAttr(value: string | null | undefined): number | 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 declare const WORD_LIMITS: {
+    /** Taille de police `w:sz` : 1 à 1638 pt. */
+    readonly fontSizeMinPt: 1;
+    readonly fontSizeMaxPt: 1638;
+    /** Largeur de bordure `w:sz` (huitièmes) : 12 pt au plus. */
+    readonly borderMaxPt: 12;
+    /** Retraits, espacements avant/après, interligne exact, espacement de caractères : ±1584 pt. */
+    readonly distanceMaxPt: 1584;
+    /** Interligne multiple (`w:lineRule="auto"`) : 132 lignes au plus. */
+    readonly lineMultipleMax: 132;
+};
+/** `value` s'il est dans `[min, max]`, sinon `undefined` (valeur hors bornes ignorée). */
+export declare function bounded(value: number | undefined, min: number, max: number): number | undefined;
+/** Distance signée (retrait, espacement) bornée à ±1584 pt. */
+export declare function boundedDistancePt(value: number | undefined): number | undefined;
+/** Nom de police validé et épuré des espaces de bord, `undefined` s'il est irrecevable. */
+export declare function fontName(value: string | null | undefined): string | undefined;
+/**
+ * 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 declare function cssFontFamily(name: string): string;
+/** Twips → points (`240` → `12`). */
+export declare function twipsToPt(twips: number): number;
+/** Twips → millimètres (`1440` → `25.4`). */
+export declare function twipsToMm(twips: number): number;
+/** Demi-points (`w:sz`) → points (`22` → `11`). */
+export declare function halfPointsToPt(halfPoints: number): number;
+/** Huitièmes de point (`w:sz` des bordures) → points (`4` → `0.5`). */
+export declare function eighthPointsToPt(eighths: number): number;
+/** EMU → points (`127000` → `10`). */
+export declare function emuToPt(emu: number): number;
+/** EMU → pixels CSS à 96 dpi (`952500` → `100`). */
+export declare function emuToPx(emu: number): number;
+/** Cinquantièmes de pour cent (`w:w w:type="pct"`, `5000` → `100`). */
+export declare function fiftiethsToPercent(fiftieths: number): number;
+/** Interligne multiple `w:line` en 240e (`276` → `1.15`). */
+export declare function lineToMultiple(line: number): number;
+/** Couleur `#rrggbb` minuscule : `RRGGBB` → `#rrggbb` ; `auto`, `none`, vide ou invalide → `undefined`. */
+export declare function hexColor(value: string | null | undefined): string | undefined;
+/** Couleur de bordure : comme `hexColor` mais `auto` (et absent) → noir, comme Word l'affiche. */
+export declare function borderColor(value: string | null | undefined): string;
+/** Surlignage nommé → `#rrggbb`, `none` ou inconnu → `undefined`. */
+export declare function highlightColor(name: string | null | undefined): string | undefined;
+/**
+ * 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 declare function borderStyleOf(value: string | null | undefined): BorderStyle | null;
+/**
+ * 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 declare function onOff(value: string | null | undefined): boolean;
+//# sourceMappingURL=units.d.ts.map

package/dist/docx/reader/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/docx/reader/units.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AActD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAKD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAM/E;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB,6CAA6C;;;IAG7C,6DAA6D;;IAE7D,gGAAgG;;IAEhG,sEAAsE;;CAE9D,CAAC;AAEX,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/F;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE/E;AASD,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG7E;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,sCAAsC;AACtC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,2GAA2G;AAC3G,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEpE;AA0BD,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CASlF;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG/D"}