@aster-editor/core 0.4.2 → 0.5.0

package/dist/extensions/pagination-layout.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Calcul pur de la pagination approximative (session 3, lot L30) : aucune dépendance au
+ * DOM, testable seul. Le plugin `pagination.ts` mesure les blocs rendus et appelle
+ * `paginate` ; ce fichier ne connaît que des hauteurs en pixels.
+ *
+ * Modèle : chaque bloc de premier niveau est **insécable** (paragraphe, titre, liste,
+ * tableau, image…). Un bloc qui ne tient pas dans le reste de la page passe entier à la
+ * page suivante ; un bloc plus haut qu'une page occupe sa page seul et la déborde. C'est
+ * une approximation assumée (Word coupe les paragraphes et les tableaux ligne à ligne).
+ */
+/** Pixels CSS par millimètre : 1 in = 96 px = 25,4 mm, valeur exacte de la spécification CSS. */
+export declare const MM_TO_PX: number;
+/**
+ * Convertit une longueur CSS absolue (`297mm`, `11in`, `72pt`, `120px`, `0`) en pixels CSS.
+ * `null` pour une valeur vide, relative (`em`, `%`, `vh`…) ou illisible : l'appelant
+ * retombe alors sur les métriques résolues depuis `DocumentLayout`.
+ */
+export declare function cssLengthToPx(value: string): number | null;
+/** Une coupure de page : posée **avant** le bloc d'index `index`. */
+export interface PageGap {
+    /** Index du bloc de premier niveau qui ouvre la nouvelle page. */
+    readonly index: number;
+    /** Numéro (1-based) de la page qui commence après la coupure. */
+    readonly page: number;
+    /** Espace resté libre en bas de la page précédente, en px (jamais négatif). */
+    readonly fill: number;
+}
+/** Résultat d'une pagination : coupures dans l'ordre et nombre total de pages. */
+export interface PaginationResult {
+    readonly gaps: readonly PageGap[];
+    readonly pageCount: number;
+}
+/** Résultat d'un document d'une seule page (ou d'une pagination inactive). */
+export declare const EMPTY_PAGINATION: PaginationResult;
+/**
+ * Répartit des blocs insécables sur des pages de hauteur utile `pageHeight` (px).
+ *
+ * - `heights[i]` : hauteur rendue du bloc `i`, marges comprises.
+ * - `breaks` : index des blocs devant lesquels une coupure est **forcée** (saut de page
+ *   explicite, `pageBreakBefore`). Un index hors plage ou `0` est ignoré : la première
+ *   page existe toujours, une coupure forcée en tête ne crée pas de page vide avant elle.
+ *
+ * Règles : un bloc qui dépasserait la page passe entier à la suivante, sauf s'il est le
+ * premier de sa page (il la déborde alors, seul). Un bloc de hauteur nulle (saut de page
+ * explicite, remplacé visuellement par la coupure, R30-01) n'ouvre jamais de page à lui
+ * seul, même après un bloc qui déborde : il reste sur la page courante et la coupure
+ * forcée qui le suit fait le travail. Une coupure forcée remet le compteur à zéro même
+ * si la page courante est vide (deux sauts consécutifs = une page vide, comme Word).
+ * `pageHeight` nulle, négative ou infinie : une seule page, aucune coupure.
+ */
+export declare function paginate(heights: readonly number[], pageHeight: number, breaks?: ReadonlySet<number> | readonly number[]): PaginationResult;
+/** Vrai si deux résultats décrivent les mêmes coupures (au pixel près pour `fill`). */
+export declare function samePagination(a: PaginationResult, b: PaginationResult): boolean;
+//# sourceMappingURL=pagination-layout.d.ts.map

package/dist/extensions/pagination-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-layout.d.ts","sourceRoot":"","sources":["../../src/extensions/pagination-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iGAAiG;AACjG,eAAO,MAAM,QAAQ,QAAY,CAAC;AAkBlC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe1D;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,gBAG7B,CAAC;AAOH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,MAAM,EAAO,GACnD,gBAAgB,CAoBlB;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAgBhF"}

package/dist/extensions/pagination-layout.js

@@ -0,0 +1,109 @@
+/**
+ * Calcul pur de la pagination approximative (session 3, lot L30) : aucune dépendance au
+ * DOM, testable seul. Le plugin `pagination.ts` mesure les blocs rendus et appelle
+ * `paginate` ; ce fichier ne connaît que des hauteurs en pixels.
+ *
+ * Modèle : chaque bloc de premier niveau est **insécable** (paragraphe, titre, liste,
+ * tableau, image…). Un bloc qui ne tient pas dans le reste de la page passe entier à la
+ * page suivante ; un bloc plus haut qu'une page occupe sa page seul et la déborde. C'est
+ * une approximation assumée (Word coupe les paragraphes et les tableaux ligne à ligne).
+ */
+/** Pixels CSS par millimètre : 1 in = 96 px = 25,4 mm, valeur exacte de la spécification CSS. */
+export const MM_TO_PX = 96 / 25.4;
+/** Tolérance de comparaison des hauteurs, en px : absorbe les arrondis sous-pixel du rendu. */
+const HEIGHT_EPSILON = 0.5;
+/** Facteur px par unité pour les longueurs CSS absolues. */
+const CSS_UNIT_TO_PX = {
+    px: 1,
+    mm: MM_TO_PX,
+    cm: MM_TO_PX * 10,
+    q: MM_TO_PX / 4,
+    in: 96,
+    pt: 96 / 72,
+    pc: 16,
+};
+const CSS_LENGTH_PATTERN = /^\s*([+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?)\s*([a-z]*)\s*$/i;
+/**
+ * Convertit une longueur CSS absolue (`297mm`, `11in`, `72pt`, `120px`, `0`) en pixels CSS.
+ * `null` pour une valeur vide, relative (`em`, `%`, `vh`…) ou illisible : l'appelant
+ * retombe alors sur les métriques résolues depuis `DocumentLayout`.
+ */
+export function cssLengthToPx(value) {
+    const match = CSS_LENGTH_PATTERN.exec(value);
+    if (!match || match[1] === undefined) {
+        return null;
+    }
+    const amount = Number.parseFloat(match[1]);
+    if (!Number.isFinite(amount)) {
+        return null;
+    }
+    const unit = (match[2] ?? '').toLowerCase();
+    if (unit === '') {
+        return amount === 0 ? 0 : null;
+    }
+    const factor = CSS_UNIT_TO_PX[unit];
+    return factor === undefined ? null : amount * factor;
+}
+/** Résultat d'un document d'une seule page (ou d'une pagination inactive). */
+export const EMPTY_PAGINATION = Object.freeze({
+    gaps: Object.freeze([]),
+    pageCount: 1,
+});
+/** Hauteur finie et positive ou nulle ; `NaN`, `Infinity` et négatifs comptent pour 0. */
+function sanitizeHeight(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * Répartit des blocs insécables sur des pages de hauteur utile `pageHeight` (px).
+ *
+ * - `heights[i]` : hauteur rendue du bloc `i`, marges comprises.
+ * - `breaks` : index des blocs devant lesquels une coupure est **forcée** (saut de page
+ *   explicite, `pageBreakBefore`). Un index hors plage ou `0` est ignoré : la première
+ *   page existe toujours, une coupure forcée en tête ne crée pas de page vide avant elle.
+ *
+ * Règles : un bloc qui dépasserait la page passe entier à la suivante, sauf s'il est le
+ * premier de sa page (il la déborde alors, seul). Un bloc de hauteur nulle (saut de page
+ * explicite, remplacé visuellement par la coupure, R30-01) n'ouvre jamais de page à lui
+ * seul, même après un bloc qui déborde : il reste sur la page courante et la coupure
+ * forcée qui le suit fait le travail. Une coupure forcée remet le compteur à zéro même
+ * si la page courante est vide (deux sauts consécutifs = une page vide, comme Word).
+ * `pageHeight` nulle, négative ou infinie : une seule page, aucune coupure.
+ */
+export function paginate(heights, pageHeight, breaks = []) {
+    if (!Number.isFinite(pageHeight) || pageHeight <= 0 || heights.length === 0) {
+        return EMPTY_PAGINATION;
+    }
+    const forced = breaks instanceof Set ? breaks : new Set(breaks);
+    const gaps = [];
+    let used = 0;
+    let page = 1;
+    for (let index = 0; index < heights.length; index += 1) {
+        const height = sanitizeHeight(heights[index]);
+        const forcedHere = index > 0 && forced.has(index);
+        const overflows = used > 0 && height > 0 && used + height > pageHeight + HEIGHT_EPSILON;
+        if (forcedHere || overflows) {
+            page += 1;
+            gaps.push({ index, page, fill: Math.max(0, pageHeight - used) });
+            used = 0;
+        }
+        used += height;
+    }
+    return gaps.length === 0 ? EMPTY_PAGINATION : { gaps, pageCount: page };
+}
+/** Vrai si deux résultats décrivent les mêmes coupures (au pixel près pour `fill`). */
+export function samePagination(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (a.pageCount !== b.pageCount || a.gaps.length !== b.gaps.length) {
+        return false;
+    }
+    return a.gaps.every((gap, position) => {
+        const other = b.gaps[position];
+        return (other !== undefined &&
+            gap.index === other.index &&
+            gap.page === other.page &&
+            Math.round(gap.fill) === Math.round(other.fill));
+    });
+}
+//# sourceMappingURL=pagination-layout.js.map

package/dist/extensions/pagination-layout.js.map

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

package/dist/extensions/pagination-measure.d.ts

@@ -0,0 +1,42 @@
+import type { EditorView } from '@tiptap/pm/view';
+import type { PageViewOptions } from '../api';
+import { type PaginationResult } from './pagination-layout';
+/**
+ * Phase de **mesure** de la pagination approximative (session 3, L30, extrait de
+ * `pagination.ts` en F30) : hauteur utile de la page depuis l'hôte, hauteurs rendues des
+ * blocs de premier niveau depuis le DOM, puis calcul pur (`pagination-layout.ts`). Aucune
+ * écriture dans le DOM ici ; le contrôleur (`pagination-controller.ts`) planifie et pose.
+ */
+/** Classe du widget de coupure de page posé avant le bloc qui ouvre une page. */
+export declare const PAGE_GAP_CLASS = "aster-page-gap";
+/**
+ * Hauteur utile d'une page en px : hauteur moins marges haute et basse, lues dans les
+ * variables `--aster-page-*` de l'hôte (calculées, puis inline), sinon depuis la mise en
+ * page résolue. Conversion mm → px exacte (96 / 25,4), pas d'élément témoin : les
+ * rectangles mesurés sont eux aussi en px CSS, quel que soit le zoom.
+ */
+export declare function usablePageHeightPx(host: HTMLElement | null, options: PageViewOptions): number;
+/** Hauteurs mesurées des blocs de premier niveau et index des coupures forcées. */
+export interface MeasuredBlocks {
+    readonly heights: readonly number[];
+    readonly breaks: ReadonlySet<number>;
+}
+/**
+ * Mesure chaque bloc de premier niveau, en lot : d'abord l'alignement DOM / document,
+ * puis toutes les lectures de rectangles, aucune écriture. La hauteur d'un bloc va de son
+ * haut au haut du suivant (ou de la coupure déjà posée entre eux), marges comprises ; le
+ * dernier bloc prend la hauteur de son rectangle.
+ *
+ * Un saut de page explicite mesure **0** (R30-01) : `page.css` le rend haut tant qu'aucune
+ * coupure ne le suit, puis l'efface derrière elle (`hr:has(+ .aster-page-gap)`). Le
+ * compter ferait déborder la page au premier rendu (page vide) et fausserait le
+ * remplissage de la coupure jusqu'à la frappe suivante.
+ *
+ * Alignement : les enfants directs de `view.dom` qui ne sont pas des widgets sont, dans
+ * l'ordre, les DOM des enfants du document. Si le compte diffère (DOM d'un intégrateur),
+ * on retombe sur `view.nodeDOM` bloc par bloc, plus lent mais sûr.
+ */
+export declare function measureBlocks(view: EditorView): MeasuredBlocks;
+/** Mesure puis pagine la vue : hauteur utile depuis l'hôte, hauteurs depuis le DOM. */
+export declare function measurePagination(view: EditorView, options: PageViewOptions): PaginationResult;
+//# sourceMappingURL=pagination-measure.d.ts.map

package/dist/extensions/pagination-measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-measure.d.ts","sourceRoot":"","sources":["../../src/extensions/pagination-measure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE/F;;;;;GAKG;AAEH,iFAAiF;AACjF,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAc/C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAiB7F;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CA2C9D;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAK9F"}

package/dist/extensions/pagination-measure.js

@@ -0,0 +1,108 @@
+import { PAGE_VIEW_CLASS, resolvePageMetrics } from './page-view';
+import { MM_TO_PX, cssLengthToPx, paginate } from './pagination-layout';
+/**
+ * Phase de **mesure** de la pagination approximative (session 3, L30, extrait de
+ * `pagination.ts` en F30) : hauteur utile de la page depuis l'hôte, hauteurs rendues des
+ * blocs de premier niveau depuis le DOM, puis calcul pur (`pagination-layout.ts`). Aucune
+ * écriture dans le DOM ici ; le contrôleur (`pagination-controller.ts`) planifie et pose.
+ */
+/** Classe du widget de coupure de page posé avant le bloc qui ouvre une page. */
+export const PAGE_GAP_CLASS = 'aster-page-gap';
+/** Classe posée par ProseMirror sur tout widget de décoration (exclu de l'alignement DOM / doc). */
+const PROSEMIRROR_WIDGET_CLASS = 'ProseMirror-widget';
+/** Nom du nœud de saut de page d'un intégrateur (`slash-menu` le propose s'il existe). */
+const PAGE_BREAK_NODE_NAME = 'pageBreak';
+/** Vrai pour un saut de page explicite : `<hr data-page-break>` ou nœud `pageBreak` d'un intégrateur. */
+function isExplicitPageBreak(node) {
+    if (node.type.name === PAGE_BREAK_NODE_NAME) {
+        return true;
+    }
+    return node.type.name === 'horizontalRule' && node.attrs['pageBreak'] === true;
+}
+/**
+ * Hauteur utile d'une page en px : hauteur moins marges haute et basse, lues dans les
+ * variables `--aster-page-*` de l'hôte (calculées, puis inline), sinon depuis la mise en
+ * page résolue. Conversion mm → px exacte (96 / 25,4), pas d'élément témoin : les
+ * rectangles mesurés sont eux aussi en px CSS, quel que soit le zoom.
+ */
+export function usablePageHeightPx(host, options) {
+    const metrics = resolvePageMetrics(options.layout);
+    const computed = host && typeof getComputedStyle === 'function' ? getComputedStyle(host) : null;
+    const read = (name, fallbackMm) => {
+        const raw = (computed?.getPropertyValue(name) ||
+            host?.style.getPropertyValue(name) ||
+            '').trim();
+        const px = raw === '' ? null : cssLengthToPx(raw);
+        return px ?? fallbackMm * MM_TO_PX;
+    };
+    return (read('--aster-page-height', metrics.heightMm) -
+        read('--aster-page-margin-top', metrics.marginTopMm) -
+        read('--aster-page-margin-bottom', metrics.marginBottomMm));
+}
+/**
+ * Mesure chaque bloc de premier niveau, en lot : d'abord l'alignement DOM / document,
+ * puis toutes les lectures de rectangles, aucune écriture. La hauteur d'un bloc va de son
+ * haut au haut du suivant (ou de la coupure déjà posée entre eux), marges comprises ; le
+ * dernier bloc prend la hauteur de son rectangle.
+ *
+ * Un saut de page explicite mesure **0** (R30-01) : `page.css` le rend haut tant qu'aucune
+ * coupure ne le suit, puis l'efface derrière elle (`hr:has(+ .aster-page-gap)`). Le
+ * compter ferait déborder la page au premier rendu (page vide) et fausserait le
+ * remplissage de la coupure jusqu'à la frappe suivante.
+ *
+ * Alignement : les enfants directs de `view.dom` qui ne sont pas des widgets sont, dans
+ * l'ordre, les DOM des enfants du document. Si le compte diffère (DOM d'un intégrateur),
+ * on retombe sur `view.nodeDOM` bloc par bloc, plus lent mais sûr.
+ */
+export function measureBlocks(view) {
+    const { doc } = view.state;
+    const count = doc.childCount;
+    const domChildren = [];
+    const gapsBefore = new Map();
+    for (const child of Array.from(view.dom.children)) {
+        if (child.classList.contains(PAGE_GAP_CLASS)) {
+            gapsBefore.set(domChildren.length, child);
+        }
+        else if (!child.classList.contains(PROSEMIRROR_WIDGET_CLASS)) {
+            domChildren.push(child);
+        }
+    }
+    const aligned = domChildren.length === count;
+    const breaks = new Set();
+    const explicitBreaks = new Set();
+    const blocks = [];
+    doc.forEach((node, offset, index) => {
+        if (isExplicitPageBreak(node)) {
+            explicitBreaks.add(index);
+            breaks.add(index + 1);
+        }
+        if (node.attrs['pageBreakBefore'] === true) {
+            breaks.add(index);
+        }
+        const dom = aligned ? domChildren[index] : view.nodeDOM(offset);
+        blocks.push(dom instanceof Element ? dom : null);
+    });
+    const rects = blocks.map((dom) => (dom ? dom.getBoundingClientRect() : null));
+    const gapTops = new Map();
+    if (aligned) {
+        for (const [index, gap] of gapsBefore) {
+            gapTops.set(index, gap.getBoundingClientRect().top);
+        }
+    }
+    const heights = rects.map((rect, index) => {
+        if (!rect || explicitBreaks.has(index)) {
+            return 0;
+        }
+        const bottom = gapTops.get(index + 1) ?? rects[index + 1]?.top ?? rect.bottom;
+        return Math.max(rect.height, bottom - rect.top);
+    });
+    return { heights, breaks };
+}
+/** Mesure puis pagine la vue : hauteur utile depuis l'hôte, hauteurs depuis le DOM. */
+export function measurePagination(view, options) {
+    const host = view.dom.closest(`.${PAGE_VIEW_CLASS}`);
+    const pageHeight = usablePageHeightPx(host, options);
+    const { heights, breaks } = measureBlocks(view);
+    return paginate(heights, pageHeight, breaks);
+}
+//# sourceMappingURL=pagination-measure.js.map

package/dist/extensions/pagination-measure.js.map

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

package/dist/extensions/pagination.d.ts

@@ -0,0 +1,36 @@
+import { Extension } from '@tiptap/core';
+import type { AsterEditor } from '../api';
+import { type PaginationResult } from './pagination-layout';
+/**
+ * Extension `pagination` (session 3, L30) et son API publique. Le travail est réparti en
+ * trois fichiers (F30, R30-13) : `pagination-layout.ts` (calcul pur), `pagination-measure.ts`
+ * (hauteur utile et mesure du DOM) et `pagination-controller.ts` (vue du plugin, décorations).
+ * Tout est réexporté d'ici : les imports de `index.ts` et des intégrateurs ne changent pas.
+ */
+export { PAGE_COUNT_ATTRIBUTE, PAGE_COUNT_CSS_VARIABLE, PAGE_GAP_FILL_CSS_VARIABLE, PAGE_GAP_NUMBER_CLASS, PAGE_NUMBER_ATTRIBUTE, PAGINATION_DEBOUNCE_MS, isPaginationEnabled, paginationPluginKey, type PaginatedPageViewOptions, type PaginationDecorations, } from './pagination-controller';
+export { PAGE_GAP_CLASS, measureBlocks, measurePagination, usablePageHeightPx, type MeasuredBlocks, } from './pagination-measure';
+/** Nom de l'extension. */
+export declare const PAGINATION_EXTENSION_NAME = "pagination";
+/** Options de l'extension `Pagination`. */
+export interface PaginationOptions {
+    /** Éditeur Aster propriétaire : i18n du libellé de page. `null` : libellé « Page n / N ». */
+    readonly aster: AsterEditor | null;
+}
+/** Dernière pagination calculée (coupures et nombre de pages) ; une page hors vue page. */
+export declare function getPaginationResult(editor: AsterEditor): PaginationResult;
+/**
+ * Mesure et pose les coupures tout de suite, sans attendre le débounce ni la frame : pour
+ * les tests et pour un intégrateur qui vient de changer la feuille de style. Résultat
+ * vide hors vue page ou avec `pagination: false`.
+ */
+export declare function paginateNow(editor: AsterEditor): PaginationResult;
+/**
+ * Extension `pagination` : pagination **approximative** de la vue page. Mesure la hauteur
+ * rendue des blocs de premier niveau et pose, en décorations widget (jamais dans le
+ * document), une coupure `div.aster-page-gap` avant chaque bloc qui ouvre une page. Les
+ * sauts de page explicites forcent la coupure ; tableaux et listes passent entiers à la
+ * page suivante. Inactive hors vue page ou avec `pagination: false`. Aucune promesse
+ * d'exactitude Word : la feuille `ui/themes/page.css` dessine, le core ne fait que mesurer.
+ */
+export declare const Pagination: Extension<PaginationOptions, any>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/extensions/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/extensions/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAQ1C,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B,0BAA0B;AAC1B,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAEtD,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAUD,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAEjE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,mCA2BrB,CAAC"}

package/dist/extensions/pagination.js

@@ -0,0 +1,69 @@
+import { Extension } from '@tiptap/core';
+import { Plugin } from '@tiptap/pm/state';
+import { DecorationSet } from '@tiptap/pm/view';
+import { PaginationController, initPaginationDecorations, mapPaginationDecorations, paginationControllerOf, paginationPluginKey, } from './pagination-controller';
+import { EMPTY_PAGINATION } from './pagination-layout';
+/**
+ * Extension `pagination` (session 3, L30) et son API publique. Le travail est réparti en
+ * trois fichiers (F30, R30-13) : `pagination-layout.ts` (calcul pur), `pagination-measure.ts`
+ * (hauteur utile et mesure du DOM) et `pagination-controller.ts` (vue du plugin, décorations).
+ * Tout est réexporté d'ici : les imports de `index.ts` et des intégrateurs ne changent pas.
+ */
+export { PAGE_COUNT_ATTRIBUTE, PAGE_COUNT_CSS_VARIABLE, PAGE_GAP_FILL_CSS_VARIABLE, PAGE_GAP_NUMBER_CLASS, PAGE_NUMBER_ATTRIBUTE, PAGINATION_DEBOUNCE_MS, isPaginationEnabled, paginationPluginKey, } from './pagination-controller';
+export { PAGE_GAP_CLASS, measureBlocks, measurePagination, usablePageHeightPx, } from './pagination-measure';
+/** Nom de l'extension. */
+export const PAGINATION_EXTENSION_NAME = 'pagination';
+/** Contrôleur de l'éditeur, `null` sans extension `Pagination` ou éditeur détruit. */
+function controllerOf(editor) {
+    if (editor.isDestroyed()) {
+        return null;
+    }
+    return paginationControllerOf(editor.tiptap.view);
+}
+/** Dernière pagination calculée (coupures et nombre de pages) ; une page hors vue page. */
+export function getPaginationResult(editor) {
+    return controllerOf(editor)?.result ?? EMPTY_PAGINATION;
+}
+/**
+ * Mesure et pose les coupures tout de suite, sans attendre le débounce ni la frame : pour
+ * les tests et pour un intégrateur qui vient de changer la feuille de style. Résultat
+ * vide hors vue page ou avec `pagination: false`.
+ */
+export function paginateNow(editor) {
+    return controllerOf(editor)?.measureNow() ?? EMPTY_PAGINATION;
+}
+/**
+ * Extension `pagination` : pagination **approximative** de la vue page. Mesure la hauteur
+ * rendue des blocs de premier niveau et pose, en décorations widget (jamais dans le
+ * document), une coupure `div.aster-page-gap` avant chaque bloc qui ouvre une page. Les
+ * sauts de page explicites forcent la coupure ; tableaux et listes passent entiers à la
+ * page suivante. Inactive hors vue page ou avec `pagination: false`. Aucune promesse
+ * d'exactitude Word : la feuille `ui/themes/page.css` dessine, le core ne fait que mesurer.
+ */
+export const Pagination = Extension.create({
+    name: PAGINATION_EXTENSION_NAME,
+    addOptions() {
+        return { aster: null };
+    },
+    addProseMirrorPlugins() {
+        const aster = this.options.aster;
+        let controller = null;
+        return [
+            new Plugin({
+                key: paginationPluginKey,
+                state: {
+                    init: initPaginationDecorations,
+                    apply: mapPaginationDecorations,
+                },
+                view: (view) => {
+                    controller = new PaginationController(view, aster);
+                    return controller;
+                },
+                props: {
+                    decorations: (state) => controller?.decorationsFor(state) ?? DecorationSet.empty,
+                },
+            }),
+        ];
+    },
+});
+//# sourceMappingURL=pagination.js.map

package/dist/extensions/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/extensions/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAyB,MAAM,qBAAqB,CAAC;AAE9E;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAE9B,0BAA0B;AAC1B,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAQtD,sFAAsF;AACtF,SAAS,YAAY,CAAC,MAAmB;IACvC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,gBAAgB,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,gBAAgB,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAoB;IAC5D,IAAI,EAAE,yBAAyB;IAE/B,UAAU;QACR,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,qBAAqB;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACjC,IAAI,UAAU,GAAgC,IAAI,CAAC;QACnD,OAAO;YACL,IAAI,MAAM,CAAC;gBACT,GAAG,EAAE,mBAAmB;gBACxB,KAAK,EAAE;oBACL,IAAI,EAAE,yBAAyB;oBAC/B,KAAK,EAAE,wBAAwB;iBAChC;gBACD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;oBACb,UAAU,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACnD,OAAO,UAAU,CAAC;gBACpB,CAAC;gBACD,KAAK,EAAE;oBACL,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK;iBACjF;aACF,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/paragraph-layout.d.ts

@@ -0,0 +1,62 @@
+import { Extension } from '@tiptap/core';
+import { type ParagraphLayoutAttrName, type ParagraphLayoutAttrs } from '../api';
+/** Nom de l'extension, clé dans `editor.extensionManager`. */
+export declare const PARAGRAPH_LAYOUT_EXTENSION_NAME = "paragraphLayout";
+/** Types de bloc qui portent les attributs de mise en page, alignés sur `TextAlign`. */
+export declare const PARAGRAPH_LAYOUT_TYPES: readonly ["paragraph", "heading"];
+/** Attribut HTML du nom de style Word d'un bloc. */
+export declare const DOCX_STYLE_ATTRIBUTE = "data-docx-style";
+/** Attribut HTML booléen « paragraphe solidaire du suivant ». */
+export declare const KEEP_NEXT_ATTRIBUTE = "data-keep-next";
+/** Attribut HTML booléen « saut de page avant ». */
+export declare const PAGE_BREAK_BEFORE_ATTRIBUTE = "data-page-break-before";
+/** Attribut HTML de la bordure `between` (pas d'équivalent CSS). */
+export declare const BORDER_BETWEEN_ATTRIBUTE = "data-border-between";
+/**
+ * Lit un `line-height` : nombre sans unité ou pourcentage → multiple, longueur → points.
+ * `normal` et les valeurs inconnues donnent deux `null`.
+ */
+export declare function parseLineHeight(value: string | null): {
+    lineHeight: number | null;
+    lineHeightPt: number | null;
+};
+/**
+ * Lit tous les attributs de mise en page d'un élément de bloc : `style` inline et
+ * attributs `data-*`. Un attribut absent vaut `null`.
+ */
+export declare function parseParagraphLayout(element: HTMLElement): Required<ParagraphLayoutAttrs>;
+/**
+ * Déclarations CSS d'un jeu d'attributs, dans l'ordre figé du contrat : `line-height`,
+ * `margin-top`, `margin-bottom`, `margin-left`, `margin-right`, `text-indent`,
+ * `border-*`, `background-color`. `lineHeightPt` l'emporte sur `lineHeight`.
+ */
+export declare function paragraphLayoutDeclarations(attributes: Record<string, unknown>): string[];
+/** Valeur `data-border-between` d'un jeu d'attributs, `null` sans bordure `between`. */
+export declare function paragraphBorderBetween(attributes: Record<string, unknown>): string | null;
+/**
+ * Attributs HTML complets d'un jeu d'attributs de mise en page, dans l'ordre : `style`,
+ * `data-border-between`, `data-docx-style`, `data-keep-next`, `data-page-break-before`.
+ * C'est ce que `renderHTML` émet et ce que les tests d'idempotence comparent.
+ */
+export declare function renderParagraphLayout(attributes: Record<string, unknown>): Record<string, string>;
+/**
+ * Normalise une valeur d'attribut telle que `setLayout` la reçoit : nombres arrondis,
+ * bordures filtrées, couleurs normalisées, booléens stricts.
+ *
+ * Trois issues, à ne pas confondre : `null` efface l'attribut (demande explicite : `null`,
+ * `false`, chaîne vide, tableau vide) ; `undefined` signifie « ignorer » (attribut absent,
+ * ou valeur **invalide** : `'abc'` pour un nombre, `NaN`, `1e307`, un mot qui n'est pas une
+ * couleur, des bordures toutes mal formées). Une valeur invalide ne doit jamais effacer ce
+ * que le bloc portait.
+ */
+export declare function normalizeParagraphLayoutValue(name: ParagraphLayoutAttrName, value: unknown): unknown;
+/**
+ * Extension `ParagraphLayout` : ajoute à `paragraph` et `heading` les attributs de
+ * `ParagraphLayoutAttrs`, lus dans le `style` inline et les `data-*`, et sérialisés
+ * exactement comme le contrat le fige. Déclarée après `TextAlign` dans le jeu d'Aster :
+ * son `text-align` vient en premier dans le `style`, les déclarations de mise en page
+ * ensuite. Aucune commande Tiptap : les commandes Aster `paragraph.setLayout` /
+ * `paragraph.unsetLayout` manipulent les attributs directement.
+ */
+export declare const ParagraphLayout: Extension<any, any>;
+//# sourceMappingURL=paragraph-layout.d.ts.map

package/dist/extensions/paragraph-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-layout.d.ts","sourceRoot":"","sources":["../../src/extensions/paragraph-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,cAAc,CAAC;AACzD,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,QAAQ,CAAC;AAkBhB,8DAA8D;AAC9D,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AAEjE,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,mCAAoC,CAAC;AAExE,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AA8B9D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAmBA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAwBzF;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAIzF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,uBAAuB,EAC7B,KAAK,EAAE,OAAO,GACb,OAAO,CA6BT;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,qBAU1B,CAAC"}