@aster-editor/word 0.4.2 → 0.5.0

package/dist/docx/reader/images.js

@@ -0,0 +1,288 @@
+import { allNamed, childNamed } from '../preprocess/xml-utils';
+import { escapeAttr, escapeHtml } from './html';
+import { alternateContentChoice, detectLostInline, textboxLost } from './lost';
+import { emuToPx, ptToPx } from './units-blocks';
+/**
+ * Conversion des dessins Word en `<img>` : `w:drawing` (`wp:inline` et `wp:anchor`,
+ * image `pic:pic/…/a:blip r:embed`), `w:pict` (VML `v:imagedata r:id`) et leur enveloppe
+ * `mc:AlternateContent` (contenu du `mc:Choice`). Les octets viennent du paquet via les
+ * relations de la partie courante ; sans hook `upload`, ils deviennent une data URL base64.
+ * Un dessin sans image (zone de texte, forme, graphique) est délégué à `detectLostInline`
+ * et remplacé par son texte ; un dessin qui porte une image **et** une zone de texte rend
+ * l'image, puis le texte de la zone, signalée comme perdue.
+ */
+const R_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+/** Plafond des dimensions écrites sur `<img>` : au-delà, c'est une valeur hostile ou absurde. */
+export const MAX_IMAGE_PX = 20000;
+/** Schémas d'URL acceptés du hook `upload` (`data:` seulement pour une image). */
+const SAFE_URL_SCHEMES = new Set(['http', 'https', 'blob']);
+const URL_SCHEME = /^([a-z][a-z0-9+.-]*):/i;
+/** Vrai si la chaîne contient un caractère de contrôle C0 ou DEL. */
+function hasControlChar(text) {
+    for (let index = 0; index < text.length; index += 1) {
+        const code = text.charCodeAt(index);
+        if (code < 0x20 || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+/**
+ * URL de `src` acceptable : `http(s):`, `blob:`, `data:image/…` ou URL relative (sans
+ * schéma). Tout autre schéma (`javascript:`, `vbscript:`, `data:text/html`…) ou un
+ * caractère de contrôle (que les navigateurs retirent avant d'analyser le schéma) est
+ * refusé : défense en profondeur, `word` est le seul producteur de ce HTML.
+ */
+export function isSafeImageUrl(url) {
+    const trimmed = url.trim();
+    if (trimmed === '' || hasControlChar(trimmed))
+        return false;
+    const scheme = URL_SCHEME.exec(trimmed)?.[1]?.toLowerCase();
+    if (scheme === undefined)
+        return true;
+    if (scheme === 'data')
+        return /^data:image\//i.test(trimmed);
+    return SAFE_URL_SCHEMES.has(scheme);
+}
+/** Dimension en pixels entiers bornée à `MAX_IMAGE_PX`, `undefined` si nulle, négative ou non finie. */
+function boundedPx(value) {
+    if (value === undefined || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    return Math.min(Math.round(value), MAX_IMAGE_PX);
+}
+/** Types MIME par extension des images que l'éditeur affiche. */
+const MIME_BY_EXTENSION = new Map([
+    ['png', 'image/png'],
+    ['jpg', 'image/jpeg'],
+    ['jpeg', 'image/jpeg'],
+    ['gif', 'image/gif'],
+    ['bmp', 'image/bmp'],
+    ['svg', 'image/svg+xml'],
+    ['webp', 'image/webp'],
+]);
+/** Formats que les navigateurs n'affichent pas : image ignorée avec avertissement. */
+const UNSUPPORTED_EXTENSIONS = new Set(['emf', 'wmf', 'tif', 'tiff']);
+const ALIGNMENTS = new Set(['left', 'center', 'right']);
+/** Attribut `r:…` (espace de noms des relations), avec repli sur le nom préfixé. */
+export function relationshipAttribute(element, name) {
+    return element.getAttributeNS(R_NS, name) ?? element.getAttribute(`r:${name}`) ?? '';
+}
+/** Attribut par nom local quel que soit son préfixe (`o:title` VML), `null` si absent. */
+function attributeByLocalName(element, localName) {
+    if (!element)
+        return null;
+    for (const attribute of Array.from(element.attributes)) {
+        if (attribute.localName === localName)
+            return attribute.value;
+    }
+    return null;
+}
+function extensionOf(path) {
+    const match = /\.([a-z0-9]+)$/i.exec(path);
+    return match?.[1]?.toLowerCase() ?? '';
+}
+/** Nom de fichier passé au hook `upload` : `image-1.png`, dérivé du type MIME. */
+function imageFileName(mime, index) {
+    const subtype = mime.split('/')[1] ?? 'bin';
+    const extension = subtype.split('+')[0] ?? 'bin';
+    return `image-${String(index)}.${extension}`;
+}
+/**
+ * Data URL base64 depuis des octets, par morceaux pour ne pas dépasser la taille maximale
+ * d'arguments de `String.fromCharCode`. `btoa` et non `Buffer` : le lecteur tourne dans
+ * le navigateur.
+ */
+export function bytesToDataUrl(bytes, mime) {
+    const CHUNK = 0x8000;
+    let binary = '';
+    for (let offset = 0; offset < bytes.length; offset += CHUNK) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + CHUNK));
+    }
+    return `data:${mime};base64,${btoa(binary)}`;
+}
+/** Longueur CSS d'un `style` VML (`width:72pt`) en pixels entiers ; l'exposant (`1e9pt`) est lu. */
+function vmlLengthPx(style, property) {
+    const match = new RegExp(`(?:^|;)\\s*${property}\\s*:\\s*(-?\\d+(?:\\.\\d+)?(?:e[+-]?\\d+)?)(pt|px|in|cm|mm)?`, 'i').exec(style);
+    if (!match?.[1])
+        return undefined;
+    const value = Number(match[1]);
+    if (!Number.isFinite(value))
+        return undefined;
+    switch ((match[2] ?? 'pt').toLowerCase()) {
+        case 'px':
+            return Math.round(value);
+        case 'in':
+            return Math.round(value * 96);
+        case 'cm':
+            return Math.round((value / 2.54) * 96);
+        case 'mm':
+            return Math.round((value / 25.4) * 96);
+        default:
+            return ptToPx(value);
+    }
+}
+/**
+ * Lit un `w:drawing` : image `pic:pic/pic:blipFill/a:blip` (un `a:blip` ailleurs est le
+ * fond d'une forme, pas une image), dimensions `wp:extent`, `wp:docPr`, alignement d'ancre.
+ */
+function readDrawing(drawing) {
+    const pic = allNamed(drawing, 'pic')[0];
+    const blip = pic ? allNamed(pic, 'blip')[0] : undefined;
+    if (!blip)
+        return null;
+    const relId = relationshipAttribute(blip, 'embed');
+    if (!relId)
+        return null;
+    const container = childNamed(drawing, 'anchor') ?? childNamed(drawing, 'inline') ?? drawing;
+    const extent = childNamed(container, 'extent');
+    const cx = Number(extent?.getAttribute('cx') ?? '');
+    const cy = Number(extent?.getAttribute('cy') ?? '');
+    const docPr = childNamed(container, 'docPr');
+    const spec = {
+        relId,
+        alt: docPr?.getAttribute('descr') ?? '',
+    };
+    const width = boundedPx(cx > 0 ? emuToPx(cx) : undefined);
+    const height = boundedPx(cy > 0 ? emuToPx(cy) : undefined);
+    if (width !== undefined)
+        spec.width = width;
+    if (height !== undefined)
+        spec.height = height;
+    const title = docPr?.getAttribute('title');
+    if (title)
+        spec.title = title;
+    if (container.localName === 'anchor') {
+        const positionH = childNamed(container, 'positionH');
+        const align = positionH ? childNamed(positionH, 'align')?.textContent?.trim() : undefined;
+        if (align && ALIGNMENTS.has(align))
+            spec.align = align;
+    }
+    return spec;
+}
+/** Lit un `w:pict` VML : `v:imagedata r:id`, dimensions du `style` de la forme. */
+function readPict(pict) {
+    const imagedata = allNamed(pict, 'imagedata')[0];
+    if (!imagedata)
+        return null;
+    const relId = relationshipAttribute(imagedata, 'id');
+    if (!relId)
+        return null;
+    const shape = imagedata.parentElement;
+    const style = shape?.getAttribute('style') ?? '';
+    const spec = {
+        relId,
+        alt: attributeByLocalName(imagedata, 'title') ?? attributeByLocalName(shape, 'alt') ?? '',
+    };
+    const width = boundedPx(vmlLengthPx(style, 'width'));
+    const height = boundedPx(vmlLengthPx(style, 'height'));
+    if (width !== undefined)
+        spec.width = width;
+    if (height !== undefined)
+        spec.height = height;
+    return spec;
+}
+function renderImg(src, spec) {
+    const attrs = [`src="${escapeAttr(src)}"`, `alt="${escapeAttr(spec.alt)}"`];
+    if (spec.title)
+        attrs.push(`title="${escapeAttr(spec.title)}"`);
+    if (spec.width)
+        attrs.push(`width="${String(spec.width)}"`);
+    if (spec.height)
+        attrs.push(`height="${String(spec.height)}"`);
+    if (spec.align)
+        attrs.push(`data-align="${spec.align}"`);
+    return `<img ${attrs.join(' ')}>`;
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Fabrique le convertisseur d'images du document. Même contrat que le chemin mammoth :
+ * avec `upload`, un `File` est construit depuis les octets et l'URL retournée devient
+ * `src` ; en cas d'échec (rejet, valeur non chaîne, vide) on avertit
+ * (`image-upload-failed`) et on replie en base64. Les formats non affichables (`emf`,
+ * `wmf`, `tiff`) et les images introuvables sont ignorés avec `image-skipped`.
+ */
+export function createImageConverter(pkg, options) {
+    let index = 0;
+    const skip = (ctx, reason) => {
+        ctx.warnings.push({ code: 'image-skipped', message: `Image ignorée : ${reason}.` });
+        return '';
+    };
+    const resolveSrc = async (bytes, mime, ctx) => {
+        const { upload } = options;
+        if (!upload)
+            return bytesToDataUrl(bytes, mime);
+        try {
+            // `slice()` donne une vue sur un `ArrayBuffer` propre, ce que `File` exige (pas de `SharedArrayBuffer`).
+            const file = new File([bytes.slice()], imageFileName(mime, index), { type: mime });
+            // Typé `unknown` : un hook JavaScript peut résoudre n'importe quoi malgré la signature.
+            const url = await upload(file);
+            if (typeof url !== 'string' || url.trim() === '') {
+                throw new Error("le hook upload n'a pas renvoyé d'URL");
+            }
+            if (!isSafeImageUrl(url)) {
+                throw new Error(`URL refusée (schéma non autorisé) : ${url.trim().slice(0, 40)}`);
+            }
+            return url.trim();
+        }
+        catch (error) {
+            ctx.warnings.push({
+                code: 'image-upload-failed',
+                message: `Upload de l'image ${String(index)} échoué, repli en base64 : ${describeError(error)}`,
+            });
+            return bytesToDataUrl(bytes, mime);
+        }
+    };
+    /**
+     * Signale un objet perdu et rend son texte éventuel. Chaque dessin est signalé : deux
+     * formes anonymes ou deux zones de texte au même contenu sont deux pertes (le
+     * dédoublonnage ne vaut que pour ce qui est unique par document, dans `lost.ts`).
+     */
+    const report = (lost, ctx) => {
+        ctx.lost.push(lost);
+        ctx.warnings.push({
+            code: 'object-lost',
+            message: `Objet non représentable ignoré (${lost.kind})${lost.detail ? ` : ${lost.detail}` : ''}.`,
+        });
+        return lost.text ? escapeHtml(lost.text) : '';
+    };
+    /** Dessin sans image : objet perdu, remplacé par son texte éventuel. */
+    const lostDrawing = (drawing, ctx) => {
+        const lost = detectLostInline(drawing, ctx);
+        return lost ? report(lost, ctx) : '';
+    };
+    /** Rend l'image du dessin ; une zone de texte qui l'accompagne est signalée et son texte conservé. */
+    const convertImage = async (drawing, spec, ctx) => {
+        const textbox = textboxLost(drawing, ctx);
+        const trailing = textbox ? report(textbox, ctx) : '';
+        index += 1;
+        const rel = (await pkg.rels(ctx.part)).get(spec.relId);
+        if (!rel)
+            return skip(ctx, `relation ${spec.relId} introuvable dans ${ctx.part}`) + trailing;
+        if (rel.external) {
+            return skip(ctx, `image externe non embarquée (${rel.target})`) + trailing;
+        }
+        const extension = extensionOf(rel.target);
+        if (UNSUPPORTED_EXTENSIONS.has(extension)) {
+            return skip(ctx, `format ${extension} non affichable (${rel.target})`) + trailing;
+        }
+        const mime = MIME_BY_EXTENSION.get(extension);
+        if (!mime)
+            return skip(ctx, `format inconnu (${rel.target})`) + trailing;
+        const bytes = await pkg.binary(rel.target);
+        if (!bytes)
+            return skip(ctx, `partie ${rel.target} absente du paquet`) + trailing;
+        return renderImg(await resolveSrc(bytes, mime, ctx), spec) + trailing;
+    };
+    return {
+        async drawing(element, ctx) {
+            // `mc:AlternateContent` : on convertit le contenu retenu (`mc:Choice`), jamais les deux.
+            const drawing = alternateContentChoice(element) ?? element;
+            const spec = drawing.localName === 'pict' ? readPict(drawing) : readDrawing(drawing);
+            if (!spec)
+                return lostDrawing(drawing, ctx);
+            return convertImage(drawing, spec, ctx);
+        },
+    };
+}
+//# sourceMappingURL=images.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { ConverterContext, ContextPatch, ReaderOptions, ReaderResult } from './types';
+/** Dérive un contexte pour une autre partie ou un autre conteneur, sans recréer les résolveurs. */
+export declare function deriveContext(ctx: ConverterContext, patch: ContextPatch): ConverterContext;
+/**
+ * Lit un `.docx` (octets déjà prétraités pour les variables) et rend le HTML stylé, la mise
+ * en page, les objets perdus et les avertissements. Ne lève que si la partie principale
+ * est absente ou illisible.
+ */
+export declare function readDocx(buffer: ArrayBuffer, options: ReaderOptions): Promise<ReaderResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/docx/reader/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,SAAS,CAAC;AAsEjB,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAE1F;AAOD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAmDjG"}

package/dist/docx/reader/index.js

@@ -0,0 +1,177 @@
+import { childNamed, childrenNamed } from '../preprocess/xml-utils';
+import { readHeadersFooters } from './headers';
+import { escapeHtml } from './html';
+import { createImageConverter } from './images';
+import { createNumberingResolver, registerListItem, renderBlocks } from './lists';
+import { detectLost } from './lost';
+import { createNoteRegistry } from './notes';
+import { openPackage } from './package';
+import { convertParagraph } from './paragraphs';
+import { readDocumentLang, readSectionLayout } from './sections';
+import { createStyleResolver } from './styles';
+import { convertTable } from './tables';
+/**
+ * Lecteur OOXML d'Aster (chemin `fidelity: 'styled'`). Orchestre les modules du dossier :
+ * ouvre le paquet, construit les résolveurs (styles, numérotation, images, notes), parcourt
+ * le corps bloc par bloc, rend les listes, ajoute les notes, lit la mise en page et les
+ * en-têtes et pieds de la dernière section. Figé en phase 0 : les lots L24 et L25
+ * remplacent les modules, pas cet orchestrateur.
+ */
+/**
+ * Enfants bloc d'un conteneur Word. `w:sdt` et `w:customXml` (balises XML personnalisées,
+ * bibliographies) sont traversés, les signets et `w:proofErr` ignorés. Chaque paragraphe
+ * numéroté est enregistré dans l'ordre du document (`registerListItem`), pour que la
+ * numérotation continue à travers les cellules, rendues avant le corps.
+ */
+async function convertBlocks(container, ctx) {
+    const blocks = [];
+    for (const child of Array.from(container.children)) {
+        switch (child.localName) {
+            case 'p': {
+                const block = await ctx.convert.paragraph(child, ctx);
+                registerListItem(block, ctx);
+                blocks.push(block);
+                break;
+            }
+            case 'tbl':
+                blocks.push(await ctx.convert.table(child, ctx));
+                break;
+            case 'sdt': {
+                const content = childNamed(child, 'sdtContent');
+                if (content)
+                    blocks.push(...(await convertBlocks(content, ctx)));
+                break;
+            }
+            case 'customXml':
+                blocks.push(...(await convertBlocks(child, ctx)));
+                break;
+            case 'customXmlPr':
+            case 'sectPr':
+            case 'bookmarkStart':
+            case 'bookmarkEnd':
+            case 'proofErr':
+            case 'commentRangeStart':
+            case 'commentRangeEnd':
+            case 'permStart':
+            case 'permEnd':
+            case 'tcPr':
+            case 'tblPr':
+            case 'tblGrid':
+            case 'trPr':
+            case 'sdtPr':
+            case 'sdtEndPr':
+            case 'pPr':
+                break;
+            default: {
+                const lost = detectLost(child, ctx);
+                if (lost) {
+                    ctx.lost.push(lost);
+                    ctx.warnings.push({
+                        code: 'object-lost',
+                        message: `Objet non représentable ignoré (${lost.kind})${lost.detail ? ` : ${lost.detail}` : ''}.`,
+                    });
+                    if (lost.text)
+                        blocks.push({ kind: 'raw', html: `<p>${escapeHtml(lost.text)}</p>` });
+                }
+            }
+        }
+    }
+    return blocks;
+}
+/** Dérive un contexte pour une autre partie ou un autre conteneur, sans recréer les résolveurs. */
+export function deriveContext(ctx, patch) {
+    return { ...ctx, ...patch };
+}
+/** `w:sectPr` final du corps (mise en page de la dernière section), `null` s'il manque. */
+function finalSectPr(body) {
+    return childNamed(body, 'sectPr');
+}
+/**
+ * Lit un `.docx` (octets déjà prétraités pour les variables) et rend le HTML stylé, la mise
+ * en page, les objets perdus et les avertissements. Ne lève que si la partie principale
+ * est absente ou illisible.
+ */
+export async function readDocx(buffer, options) {
+    const pkg = await openPackage(buffer, options.parseXml);
+    const main = await pkg.part(pkg.mainPart);
+    if (!main) {
+        throw new Error(`partie principale ${pkg.mainPart} absente ou illisible`);
+    }
+    const body = childNamed(main.documentElement, 'body');
+    if (!body) {
+        throw new Error(`partie principale ${pkg.mainPart} sans élément body`);
+    }
+    const warnings = [];
+    const lost = [];
+    const [styles, numbering, notes] = await Promise.all([
+        createStyleResolver(pkg),
+        createNumberingResolver(pkg),
+        createNoteRegistry(pkg, options),
+    ]);
+    const convert = {
+        paragraph: convertParagraph,
+        table: convertTable,
+        blocks: convertBlocks,
+        render: renderBlocks,
+    };
+    const ctx = {
+        pkg,
+        part: pkg.mainPart,
+        where: 'body',
+        styles,
+        numbering,
+        images: createImageConverter(pkg, options),
+        notes,
+        convert,
+        options,
+        warnings,
+        lost,
+        tableStyle: null,
+    };
+    const blocks = await convertBlocks(body, ctx);
+    const sectPr = finalSectPr(body);
+    const bodyHtml = renderBlocks(blocks, ctx);
+    const notesHtml = options.footnotes ? await notes.render(ctx) : '';
+    const lang = await readDocumentLang(pkg);
+    const headersFooters = await readEffectiveHeadersFooters(body, ctx);
+    const layout = {
+        ...readSectionLayout(sectPr, styles, lang, warnings),
+        ...headersFooters,
+    };
+    return { html: bodyHtml + notesHtml, layout, lost, warnings };
+}
+/** Tous les `w:sectPr` du corps dans l'ordre : ceux des `w:pPr` (fins de section) puis le final. */
+function allSectPrs(body) {
+    const result = [];
+    for (const p of childrenNamed(body, 'p')) {
+        const pPr = childNamed(p, 'pPr');
+        const sectPr = pPr ? childNamed(pPr, 'sectPr') : null;
+        if (sectPr)
+            result.push(sectPr);
+    }
+    const last = finalSectPr(body);
+    if (last)
+        result.push(last);
+    return result;
+}
+/**
+ * En-têtes et pieds effectifs : Word fait hériter chaque section des références de la
+ * précédente quand elle n'en déclare pas. On lit donc toutes les sections dans l'ordre, les
+ * plus récentes recouvrant les plus anciennes type par type (`default`, `first`, `even`),
+ * et `titlePage` vaut celui de la dernière section qui le déclare. Un document dont seule
+ * la première section référence un pied (cas client) le conserve ainsi.
+ */
+async function readEffectiveHeadersFooters(body, ctx) {
+    const merged = {};
+    for (const sectPr of allSectPrs(body)) {
+        const section = await readHeadersFooters(sectPr, ctx);
+        if (section.headers)
+            merged.headers = { ...merged.headers, ...section.headers };
+        if (section.footers)
+            merged.footers = { ...merged.footers, ...section.footers };
+        if (section.titlePage !== undefined)
+            merged.titlePage = section.titlePage;
+    }
+    return merged;
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { Block, ConverterContext, DocxPackage, ListFormat, NumberingResolver } from './types';
+/** Format de numérotation du contrat ; les formats non mappés (`decimalZero`, `ordinal`…) deviennent `1`. */
+export declare function listFormatOf(numFmt: string): ListFormat;
+/** Texte de puce lisible : caractères de polices symboliques remplacés. */
+export declare function normalizeBullet(text: string): string;
+/**
+ * Valeur de départ (`w:start`, `w:startOverride`) tronquée en entier sûr, sinon 1 : un
+ * `start="1e+300"` serait relu en 1 par l'éditeur, l'aller-retour ne serait plus idempotent.
+ */
+export declare function safeStart(value: number | undefined): number;
+/**
+ * Crée le résolveur de numérotation. Signature figée : lit `numbering.xml` via
+ * `pkg.related(pkg.mainPart, '/numbering')`. Les `w:abstractNum` liés à un style
+ * (`w:numStyleLink`) sans niveaux propres donnent une définition vide.
+ */
+export declare function createNumberingResolver(pkg: DocxPackage): Promise<NumberingResolver>;
+/** Nombre d'éléments de premier niveau d'un fragment HTML (`<hr><p>…</p>` → 2). */
+export declare function topLevelElementCount(html: string): number;
+/** Retrait gauche en points du bloc, lu dans son `style` sérialisé, `undefined` sans retrait. */
+export declare function marginLeftPt(html: string): number | undefined;
+/**
+ * Retire d'un item le retrait venu de la numérotation (`margin-left`, `text-indent` marqués
+ * par `data-docx-num-indent`) et l'attribut : dans `<li>` la liste porte le retrait, et
+ * l'éditeur ignore l'attribut. Sans l'attribut, le retrait est direct et reste tel quel.
+ */
+export declare function stripNumberingIndent(html: string): string;
+/**
+ * Enregistre un item dans l'ordre du document et retourne son rang parmi ceux de même
+ * `numId:niveau` (un item redémarre les niveaux plus profonds). À appeler à la conversion
+ * (`convertBlocks`) : les cellules sont rendues avant le corps, compter au rendu décalerait
+ * le corps. Un bloc déjà enregistré garde son rang ; sinon il l'est au rendu.
+ */
+export declare function registerListItem(block: Block, ctx: ConverterContext): number | undefined;
+/**
+ * Rend une suite de blocs en HTML : paragraphes numérotés consécutifs regroupés en listes
+ * imbriquées selon leur niveau ; changement de `numId` à même niveau → liste fermée ;
+ * `start` posé si le niveau ne démarre pas à 1 ou si la liste reprend après interruption,
+ * y compris à travers une cellule, une note ou un en-tête (Word continue, HTML repart à 1).
+ * Un `<p>` non numéroté (jamais un titre) qui suit un item avec un retrait au moins égal
+ * reste dans le même `<li>` ; un bloc à plusieurs frères (saut de page) reste hors liste.
+ * `emptyParagraphs: 'drop'` retire les paragraphes vides.
+ */
+export declare function renderBlocks(blocks: readonly Block[], ctx: ConverterContext): string;
+//# sourceMappingURL=lists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../src/docx/reader/lists.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,WAAW,EAEX,UAAU,EAEV,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAyCjB,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3D;AAuBD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuD1F;AAKD,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAezD;AAKD,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7D;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBzD;AAqED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAmBxF;AAcD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAmEpF"}