@aster-editor/core 0.4.3 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # ✳️ @aster-editor/core
 
-> Moteur d'Aster Editor : `createEditor` sur Tiptap 3 / ProseMirror, registre de commandes typées, variables de document (champs de fusion), recherche / remplacement, sommaire, reproduction de mise en forme, i18n, événements, sérialisation HTML, JSON et Markdown, autosave. Aucune UI dedans, aucun framework.
+> Moteur d'Aster Editor : `createEditor` sur Tiptap 3 / ProseMirror, registre de commandes typées, variables de document (champs de fusion), recherche / remplacement, sommaire, reproduction de mise en forme, mise en page des paragraphes et des runs (session 3), vue page avec pagination approximative, i18n, événements, sérialisation HTML, JSON et Markdown, autosave. Aucune UI dedans, aucun framework.
 
 Ce README est le tutoriel. La référence exhaustive du contrat est dans [`docs/API_CORE.md`](../../docs/API_CORE.md).
 
@@ -32,23 +32,24 @@ editor.destroy();
 
 ## ⚙️ Options (`AsterOptions`)
 
-| Champ               | Type                          | Défaut  | Rôle                                                                                                                                 |
-| ------------------- | ----------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| `element`           | `HTMLElement`                 | requis  | Hôte. Le core y ajoute `.aster-content`.                                                                                             |
-| `content`           | `string \| AsterDocument`     | `''`    | Contenu initial, HTML ou JSON ProseMirror.                                                                                           |
-| `placeholder`       | `string`                      | i18n    | Texte affiché quand le document est vide. Sans valeur, `editor.placeholder` traduit selon la locale.                                 |
-| `readOnly`          | `boolean`                     | `false` | Lecture seule au montage.                                                                                                            |
-| `locale`            | `AsterLocale`                 | `'fr'`  | Locale initiale. `fr` et `en` fournies ; toute autre chaîne après `i18n.addTranslations`.                                            |
-| `autofocus`         | `boolean`                     | `false` | Focus en fin de document au montage.                                                                                                 |
-| `extensions`        | `readonly AnyExtension[]`     | `[]`    | Extensions Tiptap ajoutées après le jeu standard, donc prioritaires pour surcharger.                                                 |
-| `commands`          | `readonly AsterCommand[]`     | `[]`    | Commandes custom enregistrées au montage. Un `id` existant remplace la commande standard.                                            |
-| `pasteTransformers` | `readonly PasteTransformer[]` | `[]`    | Transformateurs de HTML collé, chaînés dans l'ordre.                                                                                 |
-| `upload`            | `UploadHandler`               | —       | `(file: File) => Promise<string>` : URL finale d'une image. Sans hook, repli en data URL base64.                                     |
-| `linkPolicy`        | `LinkPolicy`                  | voir §  | Protocoles autorisés, cible et `rel` par défaut, autolink. S'applique aussi aux sources d'images.                                    |
-| `variables`         | `VariableSource`              | `{}`    | Variables de document : déclarations, valeurs initiales, résolveur, `allowUnknown`. Voir « Variables de document ».                  |
-| `disabledCommands`  | `readonly string[]`           | `[]`    | Commandes standard retirées du registre **et** dont le raccourci clavier est avalé (sinon la liaison native de Tiptap continuerait). |
-
-Le contrat `AsterOptions` est figé : ce qui n'y entre pas (autosave, Markdown, sommaire, reproduction de mise en forme) est fourni par des **fonctions compagnons** qui prennent l'éditeur en premier argument.
+| Champ               | Type                          | Défaut  | Rôle                                                                                                                                                                                                          |
+| ------------------- | ----------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `element`           | `HTMLElement`                 | requis  | Hôte. Le core y ajoute `.aster-content`.                                                                                                                                                                      |
+| `content`           | `string \| AsterDocument`     | `''`    | Contenu initial, HTML ou JSON ProseMirror.                                                                                                                                                                    |
+| `placeholder`       | `string`                      | i18n    | Texte affiché quand le document est vide. Sans valeur, `editor.placeholder` traduit selon la locale.                                                                                                          |
+| `readOnly`          | `boolean`                     | `false` | Lecture seule au montage.                                                                                                                                                                                     |
+| `locale`            | `AsterLocale`                 | `'fr'`  | Locale initiale. `fr` et `en` fournies ; toute autre chaîne après `i18n.addTranslations`.                                                                                                                     |
+| `autofocus`         | `boolean`                     | `false` | Focus en fin de document au montage.                                                                                                                                                                          |
+| `extensions`        | `readonly AnyExtension[]`     | `[]`    | Extensions Tiptap ajoutées après le jeu standard, donc prioritaires pour surcharger.                                                                                                                          |
+| `commands`          | `readonly AsterCommand[]`     | `[]`    | Commandes custom enregistrées au montage. Un `id` existant remplace la commande standard.                                                                                                                     |
+| `pasteTransformers` | `readonly PasteTransformer[]` | `[]`    | Transformateurs de HTML collé, chaînés dans l'ordre.                                                                                                                                                          |
+| `upload`            | `UploadHandler`               | —       | `(file: File) => Promise<string>` : URL finale d'une image. Sans hook, repli en data URL base64.                                                                                                              |
+| `linkPolicy`        | `LinkPolicy`                  | voir §  | Protocoles autorisés, cible et `rel` par défaut, autolink. S'applique aussi aux sources d'images.                                                                                                             |
+| `variables`         | `VariableSource`              | `{}`    | Variables de document : déclarations, valeurs initiales, résolveur, `allowUnknown`. Voir « Variables de document ».                                                                                           |
+| `pageView`          | `boolean \| PageViewOptions`  | `false` | Vue page au montage : feuille aux dimensions et marges de `layout.page`, en-têtes et pieds en lecture seule, pagination approximative. `true` = A4 portrait, marges 25,4 mm. Voir « Vue page et pagination ». |
+| `disabledCommands`  | `readonly string[]`           | `[]`    | Commandes standard retirées du registre **et** dont le raccourci clavier est avalé (sinon la liaison native de Tiptap continuerait).                                                                          |
+
+Le contrat `AsterOptions` est figé : ce qui n'y entre pas (autosave, Markdown, sommaire, reproduction de mise en forme) est fourni par des **fonctions compagnons** qui prennent l'éditeur en premier argument. La session 3 l'a enrichi sans rupture (`pageView`, commandes `paragraph.*`, types de `api/layout.ts`).
 
 ## 🧰 API de `AsterEditor`
 
@@ -65,16 +66,16 @@ Le contrat `AsterOptions` est figé : ce qui n'y entre pas (autosave, Markdown,
 
 ### Contenu
 
-| Méthode                    | Rôle                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `getHTML(options?)`        | HTML sémantique stable, sans `colgroup`, `min-width` ni `colspan="1"` sur les tables. `setHTML(getHTML())` est idempotent. Mis en cache tant que le document ne change pas : l'appeler à chaque frappe ne coûte qu'une sérialisation par transaction. `{ variables: 'resolve' }` substitue les valeurs connues aux puces (texte brut échappé, `{{nom}}` conservé sans valeur) ; `'placeholders'` (défaut) garde les `<span data-aster-variable>`. |
-| `setHTML(html, emit?)`     | Remplace tout le contenu. `emit = false` n'émet pas `change`, n'entre pas dans l'historique **et vide l'historique antérieur** (un `undo` qui suit ne fait rien) : c'est le mode de `writeValue` côté formulaire. Avec `emit = true` (défaut), le remplacement est une étape annulable.                                                                                                                                                           |
-| `getJSON(): AsterDocument` | Document JSON ProseMirror (`JSONContent` de Tiptap).                                                                                                                                                                                                                                                                                                                                                                                              |
-| `setJSON(doc, emit?)`      | Idem avec un document JSON, mêmes règles pour `emit`.                                                                                                                                                                                                                                                                                                                                                                                             |
-| `getText(): string`        | Texte brut : un seul `\n` entre deux blocs de texte, cellules de table et items de liste compris ; un `\n` par `hardBreak`. Une puce de variable rend sa valeur si elle est connue, sinon `{{nom}}`.                                                                                                                                                                                                                                              |
-| `insertHTML(html)`         | Insère à la sélection courante, en passant par le schéma. HTML **brut, non transformé** : ni `pasteTransformers` ni normaliseur Word ne s'appliquent, seule la politique de liens et d'images filtre. Transforme le HTML avant si besoin. Donne le focus.                                                                                                                                                                                         |
-| `isEmpty(): boolean`       | Vrai pour un document sans contenu. Note : `getHTML()` d'un document vide vaut `<p></p>`, teste `isEmpty()` plutôt.                                                                                                                                                                                                                                                                                                                               |
-| `getCounts(): AsterCounts` | `{ words, characters }` via `CharacterCount`.                                                                                                                                                                                                                                                                                                                                                                                                     |
+| Méthode                    | Rôle                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getHTML(options?)`        | HTML sémantique stable, sans `colgroup`, `min-width` ni `colspan="1"` sur les tables. `setHTML(getHTML())` est idempotent, attributs de mise en page compris (sérialisation verbatim, voir « Sérialiseur HTML verbatim »). Mis en cache tant que le document ne change pas : l'appeler à chaque frappe ne coûte qu'une sérialisation par transaction. `{ variables: 'resolve' }` substitue les valeurs connues aux puces (texte brut échappé, `{{nom}}` conservé sans valeur) ; `'placeholders'` (défaut) garde les `<span data-aster-variable>`. |
+| `setHTML(html, emit?)`     | Remplace tout le contenu. `emit = false` n'émet pas `change`, n'entre pas dans l'historique **et vide l'historique antérieur** (un `undo` qui suit ne fait rien) : c'est le mode de `writeValue` côté formulaire. Avec `emit = true` (défaut), le remplacement est une étape annulable.                                                                                                                                                                                                                                                           |
+| `getJSON(): AsterDocument` | Document JSON ProseMirror (`JSONContent` de Tiptap).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `setJSON(doc, emit?)`      | Idem avec un document JSON, mêmes règles pour `emit`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `getText(): string`        | Texte brut : un seul `\n` entre deux blocs de texte, cellules de table et items de liste compris ; un `\n` par `hardBreak`. Une puce de variable rend sa valeur si elle est connue, sinon `{{nom}}`.                                                                                                                                                                                                                                                                                                                                              |
+| `insertHTML(html)`         | Insère à la sélection courante, en passant par le schéma. HTML **brut, non transformé** : ni `pasteTransformers` ni normaliseur Word ne s'appliquent, seule la politique de liens et d'images filtre. Transforme le HTML avant si besoin. Donne le focus.                                                                                                                                                                                                                                                                                         |
+| `isEmpty(): boolean`       | Vrai pour un document sans contenu. Note : `getHTML()` d'un document vide vaut `<p></p>`, teste `isEmpty()` plutôt.                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `getCounts(): AsterCounts` | `{ words, characters }` via `CharacterCount`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 Markdown : `getMarkdown(editor)` et `setMarkdown(editor, markdown, emit?)`, fonctions compagnons, voir plus bas.
 
@@ -114,68 +115,70 @@ editor.commands.isActive('heading', { level: 2 });
 
 Les identifiants standard sont autocomplétés et leurs arguments typés par `StandardCommandArgs` (`run('heading', …)` attend `{ level }`). Le registre garde aussi une surcharge libre `run(id: string, args?: unknown)` pour les commandes custom et `search.*` : `run('heading')` sans argument compile donc par cette surcharge et répond `false` à l'exécution. Vérifie tes arguments, TypeScript ne le fera pas à ta place sur cette surcharge.
 
-### Tableau des 50 commandes standard
-
-Raccourcis au format Tiptap : `Mod` = `Ctrl` sur Windows/Linux, `⌘` sur macOS. Libellés = dictionnaire `fr` (clé `command.<id>`).
-
-| Id                         | Libellé fr                   | Raccourci                 | Arguments                                                                                                                                                                |
-| -------------------------- | ---------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `bold`                     | Gras                         | `Mod-b`                   | —                                                                                                                                                                        |
-| `italic`                   | Italique                     | `Mod-i`                   | —                                                                                                                                                                        |
-| `underline`                | Souligné                     | `Mod-u`                   | —                                                                                                                                                                        |
-| `strike`                   | Barré                        | `Mod-Shift-s`             | —                                                                                                                                                                        |
-| `subscript`                | Indice                       | —                         | —                                                                                                                                                                        |
-| `superscript`              | Exposant                     | —                         | —                                                                                                                                                                        |
-| `code`                     | Code                         | `Mod-e`                   | —                                                                                                                                                                        |
-| `highlight`                | Surligner                    | `Mod-Shift-h`             | —                                                                                                                                                                        |
-| `clearFormatting`          | Effacer la mise en forme     | —                         | — (retire les marks sauf `link`, ramène les blocs de texte au paragraphe sans alignement ; liste, citation et cellule restent en place ; impossible sur document vide)   |
-| `paragraph`                | Paragraphe                   | —                         | — (pose le type sans repli : impossible dans un item de liste ou si le bloc est déjà un paragraphe)                                                                      |
-| `heading`                  | Titre                        | `Mod-Alt-1` … `Mod-Alt-6` | `{ level: 1 \| 2 \| 3 \| 4 \| 5 \| 6 }` (idem : pas de bascule, pas de titre dans un item de liste en V1)                                                                |
-| `blockquote`               | Citation                     | —                         | —                                                                                                                                                                        |
-| `codeBlock`                | Bloc de code                 | —                         | —                                                                                                                                                                        |
-| `horizontalRule`           | Séparateur                   | —                         | —                                                                                                                                                                        |
-| `hardBreak`                | Saut de ligne                | —                         | —                                                                                                                                                                        |
-| `bulletList`               | Liste à puces                | `Mod-Shift-8`             | —                                                                                                                                                                        |
-| `orderedList`              | Liste numérotée              | `Mod-Shift-7`             | —                                                                                                                                                                        |
-| `taskList`                 | Liste de tâches              | —                         | —                                                                                                                                                                        |
-| `indent`                   | Augmenter le retrait         | —                         | — (`listItem` puis `taskItem`)                                                                                                                                           |
-| `outdent`                  | Réduire le retrait           | —                         | —                                                                                                                                                                        |
-| `alignLeft`                | Aligner à gauche             | —                         | — (retire l'attribut ; actif quand aucun alignement explicite)                                                                                                           |
-| `alignCenter`              | Centrer                      | —                         | —                                                                                                                                                                        |
-| `alignRight`               | Aligner à droite             | —                         | —                                                                                                                                                                        |
-| `alignJustify`             | Justifier                    | —                         | —                                                                                                                                                                        |
-| `link.set`                 | Insérer un lien              | `Mod-k`                   | `{ href: string; target?: '_blank' \| '_self'; title?: string }`                                                                                                         |
-| `link.unset`               | Supprimer le lien            | —                         | —                                                                                                                                                                        |
-| `image.insert`             | Insérer une image            | —                         | `{ src: string; alt?: string; title?: string; width?: number }` (jamais active : pas une bascule ; impossible dans un bloc de code ; `src` soumis à la politique)        |
-| `image.upload`             | Importer une image           | —                         | `{ file: File }` (asynchrone : voir `uploadStart` / `uploadDone`)                                                                                                        |
-| `image.setAttributes`      | Propriétés de l'image        | —                         | `{ alt?: string; title?: string; width?: number; align?: 'left' \| 'center' \| 'right' }` (sur l'image sélectionnée)                                                     |
-| `table.insert`             | Insérer un tableau           | —                         | `{ rows: number; cols: number; withHeaderRow?: boolean }` (`withHeaderRow` vrai par défaut ; impossible dans une table : pas de tables imbriquées en V1)                 |
-| `table.delete`             | Supprimer le tableau         | —                         | —                                                                                                                                                                        |
-| `table.addRowBefore`       | Insérer une ligne au-dessus  | —                         | —                                                                                                                                                                        |
-| `table.addRowAfter`        | Insérer une ligne en dessous | —                         | —                                                                                                                                                                        |
-| `table.deleteRow`          | Supprimer la ligne           | —                         | —                                                                                                                                                                        |
-| `table.addColumnBefore`    | Insérer une colonne à gauche | —                         | —                                                                                                                                                                        |
-| `table.addColumnAfter`     | Insérer une colonne à droite | —                         | —                                                                                                                                                                        |
-| `table.deleteColumn`       | Supprimer la colonne         | —                         | —                                                                                                                                                                        |
-| `table.mergeCells`         | Fusionner les cellules       | —                         | —                                                                                                                                                                        |
-| `table.splitCell`          | Scinder la cellule           | —                         | —                                                                                                                                                                        |
-| `table.toggleHeaderRow`    | Ligne d'en-tête              | —                         | —                                                                                                                                                                        |
-| `table.toggleHeaderColumn` | Colonne d'en-tête            | —                         | —                                                                                                                                                                        |
-| `textColor`                | Couleur du texte             | —                         | `{ color: string \| null }`                                                                                                                                              |
-| `backgroundColor`          | Couleur de fond              | —                         | `{ color: string \| null }`                                                                                                                                              |
-| `fontFamily`               | Police                       | —                         | `{ family: string \| null }`                                                                                                                                             |
-| `fontSize`                 | Taille                       | —                         | `{ size: string \| null }` (ex. `'14px'`)                                                                                                                                |
-| `variable.insert`          | Insérer une variable         | —                         | `{ name: string; label?: string }` (remplace la sélection par une puce ; refusé si le nom est invalide, non déclaré avec `allowUnknown: false`, ou dans un bloc de code) |
-| `variable.remove`          | Supprimer la variable        | —                         | — (la puce sélectionnée ou collée au curseur ; `canRun` et `isActive` disent s'il y en a une)                                                                            |
-| `undo`                     | Annuler                      | `Mod-z`                   | —                                                                                                                                                                        |
-| `redo`                     | Rétablir                     | `Mod-Shift-z`, `Mod-y`    | —                                                                                                                                                                        |
-| `selectAll`                | Tout sélectionner            | `Mod-a`                   | —                                                                                                                                                                        |
+### Tableau des 52 commandes standard
+
+Raccourcis au format Tiptap : `Mod` = `Ctrl` sur Windows/Linux, `⌘` sur macOS. Libellés = dictionnaire `fr` (clé `command.<id>`). Les deux commandes `paragraph.*` sont celles de la session 3.
+
+| Id                         | Libellé fr                            | Raccourci                 | Arguments                                                                                                                                                                                                             |
+| -------------------------- | ------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `bold`                     | Gras                                  | `Mod-b`                   | —                                                                                                                                                                                                                     |
+| `italic`                   | Italique                              | `Mod-i`                   | —                                                                                                                                                                                                                     |
+| `underline`                | Souligné                              | `Mod-u`                   | —                                                                                                                                                                                                                     |
+| `strike`                   | Barré                                 | `Mod-Shift-s`             | —                                                                                                                                                                                                                     |
+| `subscript`                | Indice                                | —                         | —                                                                                                                                                                                                                     |
+| `superscript`              | Exposant                              | —                         | —                                                                                                                                                                                                                     |
+| `code`                     | Code                                  | `Mod-e`                   | —                                                                                                                                                                                                                     |
+| `highlight`                | Surligner                             | `Mod-Shift-h`             | —                                                                                                                                                                                                                     |
+| `clearFormatting`          | Effacer la mise en forme              | —                         | — (retire les marks sauf `link`, ramène les blocs de texte au paragraphe sans alignement ; liste, citation et cellule restent en place ; impossible sur document vide)                                                |
+| `paragraph`                | Paragraphe                            | —                         | — (pose le type sans repli : impossible dans un item de liste ou si le bloc est déjà un paragraphe)                                                                                                                   |
+| `heading`                  | Titre                                 | `Mod-Alt-1` … `Mod-Alt-6` | `{ level: 1 \| 2 \| 3 \| 4 \| 5 \| 6 }` (idem : pas de bascule, pas de titre dans un item de liste en V1)                                                                                                             |
+| `blockquote`               | Citation                              | —                         | —                                                                                                                                                                                                                     |
+| `codeBlock`                | Bloc de code                          | —                         | —                                                                                                                                                                                                                     |
+| `horizontalRule`           | Séparateur                            | —                         | —                                                                                                                                                                                                                     |
+| `hardBreak`                | Saut de ligne                         | —                         | —                                                                                                                                                                                                                     |
+| `bulletList`               | Liste à puces                         | `Mod-Shift-8`             | —                                                                                                                                                                                                                     |
+| `orderedList`              | Liste numérotée                       | `Mod-Shift-7`             | —                                                                                                                                                                                                                     |
+| `taskList`                 | Liste de tâches                       | —                         | —                                                                                                                                                                                                                     |
+| `indent`                   | Augmenter le retrait                  | —                         | — (`listItem` puis `taskItem`)                                                                                                                                                                                        |
+| `outdent`                  | Réduire le retrait                    | —                         | —                                                                                                                                                                                                                     |
+| `alignLeft`                | Aligner à gauche                      | —                         | — (retire l'attribut ; actif quand aucun alignement explicite)                                                                                                                                                        |
+| `alignCenter`              | Centrer                               | —                         | —                                                                                                                                                                                                                     |
+| `alignRight`               | Aligner à droite                      | —                         | —                                                                                                                                                                                                                     |
+| `alignJustify`             | Justifier                             | —                         | —                                                                                                                                                                                                                     |
+| `link.set`                 | Insérer un lien                       | `Mod-k`                   | `{ href: string; target?: '_blank' \| '_self'; title?: string }`                                                                                                                                                      |
+| `link.unset`               | Supprimer le lien                     | —                         | —                                                                                                                                                                                                                     |
+| `image.insert`             | Insérer une image                     | —                         | `{ src: string; alt?: string; title?: string; width?: number }` (jamais active : pas une bascule ; impossible dans un bloc de code ; `src` soumis à la politique)                                                     |
+| `image.upload`             | Importer une image                    | —                         | `{ file: File }` (asynchrone : voir `uploadStart` / `uploadDone`)                                                                                                                                                     |
+| `image.setAttributes`      | Propriétés de l'image                 | —                         | `{ alt?: string; title?: string; width?: number; align?: 'left' \| 'center' \| 'right' }` (sur l'image sélectionnée)                                                                                                  |
+| `table.insert`             | Insérer un tableau                    | —                         | `{ rows: number; cols: number; withHeaderRow?: boolean }` (`withHeaderRow` vrai par défaut ; impossible dans une table : pas de tables imbriquées en V1)                                                              |
+| `table.delete`             | Supprimer le tableau                  | —                         | —                                                                                                                                                                                                                     |
+| `table.addRowBefore`       | Insérer une ligne au-dessus           | —                         | —                                                                                                                                                                                                                     |
+| `table.addRowAfter`        | Insérer une ligne en dessous          | —                         | —                                                                                                                                                                                                                     |
+| `table.deleteRow`          | Supprimer la ligne                    | —                         | —                                                                                                                                                                                                                     |
+| `table.addColumnBefore`    | Insérer une colonne à gauche          | —                         | —                                                                                                                                                                                                                     |
+| `table.addColumnAfter`     | Insérer une colonne à droite          | —                         | —                                                                                                                                                                                                                     |
+| `table.deleteColumn`       | Supprimer la colonne                  | —                         | —                                                                                                                                                                                                                     |
+| `table.mergeCells`         | Fusionner les cellules                | —                         | —                                                                                                                                                                                                                     |
+| `table.splitCell`          | Scinder la cellule                    | —                         | —                                                                                                                                                                                                                     |
+| `table.toggleHeaderRow`    | Ligne d'en-tête                       | —                         | —                                                                                                                                                                                                                     |
+| `table.toggleHeaderColumn` | Colonne d'en-tête                     | —                         | —                                                                                                                                                                                                                     |
+| `textColor`                | Couleur du texte                      | —                         | `{ color: string \| null }`                                                                                                                                                                                           |
+| `backgroundColor`          | Couleur de fond                       | —                         | `{ color: string \| null }`                                                                                                                                                                                           |
+| `fontFamily`               | Police                                | —                         | `{ family: string \| null }`                                                                                                                                                                                          |
+| `fontSize`                 | Taille                                | —                         | `{ size: string \| null }` (ex. `'14px'`)                                                                                                                                                                             |
+| `variable.insert`          | Insérer une variable                  | —                         | `{ name: string; label?: string }` (remplace la sélection par une puce ; refusé si le nom est invalide, non déclaré avec `allowUnknown: false`, ou dans un bloc de code)                                              |
+| `variable.remove`          | Supprimer la variable                 | —                         | — (la puce sélectionnée ou collée au curseur ; `canRun` et `isActive` disent s'il y en a une)                                                                                                                         |
+| `paragraph.setLayout`      | Mise en page du paragraphe            | —                         | `ParagraphLayoutAttrs` : fusionne les attributs donnés dans chaque paragraphe et titre de la sélection (cellules et items compris), `null` efface un attribut, une valeur invalide est ignorée. Voir « Mise en page » |
+| `paragraph.unsetLayout`    | Effacer la mise en page du paragraphe | —                         | `{ attrs?: ParagraphLayoutAttrName[] } \| undefined` : efface les attributs nommés, ou tous sans argument                                                                                                             |
+| `undo`                     | Annuler                               | `Mod-z`                   | —                                                                                                                                                                                                                     |
+| `redo`                     | Rétablir                              | `Mod-Shift-z`, `Mod-y`    | —                                                                                                                                                                                                                     |
+| `selectAll`                | Tout sélectionner                     | `Mod-a`                   | —                                                                                                                                                                                                                     |
 
 Les raccourcis à liaisons multiples (`heading`, `redo`) sont déclarés dans `EXTRA_SHORTCUT_BINDINGS` (7 liaisons) ; `Tab` / `Shift-Tab` dans les listes et les tables sont gérés nativement par Tiptap. Une commande custom qui déclare un `shortcut` est câblée automatiquement par `collectShortcutBindings`.
 
 ### Les 6 commandes de recherche (`search.*`)
 
-Enregistrées par `createStandardCommands` en plus des 50 du contrat, mais **hors de `STANDARD_COMMAND_IDS`** : leurs identifiants sont dans `SEARCH_COMMAND_IDS` et leurs arguments dans `SearchCommandArgs` (`{ query: string; replacement?: string; caseSensitive?: boolean }`, tous lus de façon tolérante : `run('search.next')` sans argument marche). Avec les deux commandes `formatPainter.*` (voir plus bas), le registre compte 58 commandes au montage.
+Enregistrées par `createStandardCommands` en plus des 52 du contrat, mais **hors de `STANDARD_COMMAND_IDS`** : leurs identifiants sont dans `SEARCH_COMMAND_IDS` et leurs arguments dans `SearchCommandArgs` (`{ query: string; replacement?: string; caseSensitive?: boolean }`, tous lus de façon tolérante : `run('search.next')` sans argument marche). Avec les deux commandes `formatPainter.*` et les trois commandes `text.*` (voir plus bas), le registre compte **63 commandes** au montage (`editor.commands.list().length`).
 
 | Id                  | Libellé fr                | Raccourci | Comportement                                                                                                                                                                                          |
 | ------------------- | ------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -410,7 +413,100 @@ editor.element.addEventListener(IMAGE_EDIT_EVENT, (event) => {
 
 ## 📋 Tables
 
-`TableKit` avec `resizable: true` et `cellMinWidth: 48` : les colonnes se redimensionnent à la souris (`column-resize-handle`, curseur `resize-cursor`, styles dans `images-tables.css`). Les largeurs sont stockées dans `colwidth` et sérialisées… puis retirées par `normalizeOutputHtml` : `getHTML()` ne contient ni `colgroup`, ni `min-width`, ni `colspan="1"`, pour un HTML stable d'une session à l'autre. Pas de tables imbriquées en V1 : `table.insert` répond `false` dans une table, même si le schéma les tolère au parsing.
+`TableKit` pour la ligne, `AsterTable`, `AsterTableCell` et `AsterTableHeader` (celles de Tiptap plus les attributs de mise en page, voir plus bas) avec `resizable: true` et `cellMinWidth: 48` : les colonnes se redimensionnent à la souris (`column-resize-handle`, curseur `resize-cursor`, styles dans `images-tables.css`). Les largeurs sont stockées dans `colwidth` et sérialisées… puis le bruit est retiré par `normalizeOutputHtml` : `getHTML()` ne contient ni `colgroup`, ni `min-width`, ni `colspan="1"`, pour un HTML stable d'une session à l'autre. `colspan` est borné à 63 et `rowspan` à 1 000 à l'analyse (`MAX_COLSPAN`, `MAX_ROWSPAN`) : un `colspan="1000000"` venu d'un `.docx` hostile faisait allouer une grille de 4 Go. Pas de tables imbriquées **par la commande** : `table.insert` répond `false` dans une table ; le schéma les accepte au parsing et l'import Word en produit.
+
+## 📐 Mise en page (session 3)
+
+Le contrat `api/layout.ts` décrit ce que l'import Word sait apporter et que l'éditeur sait représenter : des attributs de paragraphe, des attributs de run, de liste, de tableau et de cellule, chacun avec une **sérialisation HTML exacte** (`style` inline normalisé dans un ordre figé, attributs `data-*`), et un `DocumentLayout` pour la page. Unités : points typographiques (`pt`) pour le texte et les paragraphes, millimètres pour la page, nombre sans unité pour un interligne multiple ; couleurs en `#rrggbb` minuscules. `setHTML(getHTML())` conserve chaque attribut à l'identique (idempotence stricte, vérifiée sur les fixtures Word 11-17).
+
+### Attributs de paragraphe (`ParagraphLayoutAttrs`, extension `ParagraphLayout`)
+
+Portés par `paragraph` et `heading`, tous `null` par défaut (hérités du style de l'éditeur). Déclarations émises dans cet ordre, après le `text-align` de `TextAlign`, uniquement pour les valeurs présentes ; puis les attributs `data-*` dans l'ordre `data-border-between`, `data-docx-style`, `data-keep-next`, `data-page-break-before` :
+
+| Attribut            | Type            | Sérialisé                                                                                    | Exemple                                                                                   |
+| ------------------- | --------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `lineHeight`        | `number`        | `line-height: 1.15` (multiple, sans unité ; `115%` relu comme `1.15`)                        | `<p style="line-height: 1.15">`                                                           |
+| `lineHeightPt`      | `number`        | `line-height: 14pt` (exact ; l'emporte sur `lineHeight`)                                     | `<p style="line-height: 14pt">`                                                           |
+| `spacingBeforePt`   | `number`        | `margin-top: 6pt`                                                                            | `<p style="margin-top: 6pt">`                                                             |
+| `spacingAfterPt`    | `number`        | `margin-bottom: 6pt`                                                                         | `<p style="margin-bottom: 6pt">`                                                          |
+| `indentLeftPt`      | `number`        | `margin-left: 36pt`                                                                          | `<p style="margin-left: 36pt">`                                                           |
+| `indentRightPt`     | `number`        | `margin-right: 12pt`                                                                         | `<p style="margin-right: 12pt">`                                                          |
+| `indentFirstLinePt` | `number`        | `text-indent: 18pt` (négatif = retrait suspendu)                                             | `<p style="margin-left: 36pt; text-indent: -18pt">`                                       |
+| `borders`           | `BlockBorder[]` | `border-<côté>: <épaisseur>pt <style> #rrggbb` par côté ; `between` en `data-border-between` | `<p style="border-bottom: 1pt solid #000000" data-border-between="0.5pt dashed #808080">` |
+| `shading`           | `string`        | `background-color: #eeeeee`                                                                  | `<p style="background-color: #eeeeee">`                                                   |
+| `keepWithNext`      | `boolean`       | `data-keep-next` (présent = vrai)                                                            | `<h2 data-keep-next>`                                                                     |
+| `pageBreakBefore`   | `boolean`       | `data-page-break-before`                                                                     | `<h1 data-page-break-before>`                                                             |
+| `docxStyle`         | `string`        | `data-docx-style` (identifiant du style Word, jamais interprété par l'éditeur)               | `<p data-docx-style="Citation">`                                                          |
+
+`PARAGRAPH_LAYOUT_ATTR_NAMES` (12 noms, dans l'ordre de sérialisation) et `ParagraphLayoutAttrName` sont exportés. Les nombres sont arrondis à deux décimales et bornés à ±100 000 (`LAYOUT_NUMBER_LIMIT`) : `1e307` ne sérialise jamais `Infinitypt`. `BlockBorder` = `{ side: 'top' | 'right' | 'bottom' | 'left' | 'between', style: 'solid' | 'dashed' | 'dotted' | 'double', widthPt, color }`. Un `<p>` ou un `<li>` importé de Word peut porter en plus `data-docx-num-indent` (extension `ListLayout`, hors contrat) : son retrait vient du niveau de numérotation, l'export ne le réécrit pas.
+
+### Marques de run (`RunLayoutAttrs`, extension `RunLayout`)
+
+Sur la marque `textStyle`, après les attributs de `TextStyleKit` (`color`, `background-color`, `font-family`, `font-size`, dans l'ordre `background-color, color, font-family, font-size, letter-spacing, …`) ; sur `underline` et `strike`, un style de trait :
+
+| Attribut          | Marque                | Sérialisé                                                                        | Exemple                                                                                  |
+| ----------------- | --------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `letterSpacingPt` | `textStyle`           | `letter-spacing: 1pt`                                                            | `<span style="letter-spacing: 1pt">`                                                     |
+| `caps`            | `textStyle`           | `text-transform: uppercase` (`all`) ou `font-variant: small-caps` (`small`)      | `<span style="font-variant: small-caps">`                                                |
+| `docxRunStyle`    | `textStyle`           | `data-docx-run-style` (un `<span data-docx-run-style>` sans `style` est accepté) | `<span data-docx-run-style="Code">`                                                      |
+| `decorationStyle` | `underline`, `strike` | `text-decoration-style: double \| dotted \| dashed \| wavy` (`solid` implicite)  | `<u style="text-decoration-style: double">`, `<s style="text-decoration-style: double">` |
+
+Les couleurs de `textStyle` et de `highlight` sont normalisées en `#rrggbb` minuscules au rendu (`setColor('#FF0000')` sort `color: #ff0000`, `rgb(255, 0, 0)` aussi). Un `<span style>` dont **aucun** attribut de `textStyle` ne se résout (`text-decoration: underline`, `mso-*` d'un collage Word) n'est plus accepté comme marque : Tiptap créait un `<span>` vide qui disparaissait à la relecture. Les marques s'imbriquent dans un ordre figé, `<span><strong><em><s><u><sup>`, le même que celui du lecteur Word.
+
+### Listes et tableaux (`ListLayoutAttrs`, `TableLayoutAttrs`, `CellLayoutAttrs`)
+
+- Listes (`ListLayout`) : `orderedList` a `type` et `start` de Tiptap (`<ol type="a" start="3">`) plus `docxNumId` (`data-docx-num-id`) ; `bulletList` reçoit `bullet` (`data-bullet="–"`) et `docxNumId`. Rien n'est interprété par l'éditeur : ces attributs relient la liste à la numérotation du gabarit Word.
+- Tableau (`AsterTable`) : `width` (`style="width: 100%"` ou `width: 450pt` ; les pixels sont ignorés, c'est la largeur que Tiptap calcule lui-même depuis les `colwidth`), `borders` (`border-top: 0.5pt solid #000000`, un par côté), `docxStyle` (`data-docx-style="TableGrid"`). Tant qu'aucune colonne n'est redimensionnée, la largeur du contrat est celle affichée ; dès qu'une colonne porte un `colwidth`, la largeur calculée par Tiptap prime en édition (`AsterTableView`).
+- Cellule (`AsterTableCell`, `AsterTableHeader`) : `borders`, `shading` (`background-color`), `verticalAlign` (`vertical-align: top | middle | bottom`), `paddingPt` (`padding: 2pt 4pt 2pt 4pt`, quadruplet `top right bottom left`). Exemple complet : `<td colspan="2" style="border-top: 0.5pt solid #000000; background-color: #d9e2f3; vertical-align: middle; padding: 4pt 4pt 4pt 4pt">`.
+- Saut de page : `AsterHorizontalRule` conserve `<hr data-page-break>` (l'import Word le produit pour `w:br w:type="page"`, l'export le relit, la vue page le dessine en coupure de feuille) ; un `<hr>` nu reste un séparateur.
+
+### Commandes `paragraph.*` et `text.*`
+
+`paragraph.setLayout` et `paragraph.unsetLayout` sont dans le contrat (`STANDARD_COMMAND_IDS`) ; `text.setLetterSpacing`, `text.setCaps` et `text.unsetCaps` sont additives comme `search.*` (`TEXT_LAYOUT_COMMAND_IDS`, `TextLayoutCommandId`, arguments `SetLetterSpacingArgs` et `SetCapsArgs`, surcharge libre de `run`). Toutes parcourent la sélection **plage par plage** : une sélection de cellules (`CellSelection`) applique la commande à chaque cellule, pas seulement à la cellule d'ancrage (revue R23).
+
+```ts
+editor.commands.run('paragraph.setLayout', {
+  lineHeight: 1.5,
+  spacingAfterPt: 6,
+  indentLeftPt: 36,
+  indentFirstLinePt: -18, // retrait suspendu
+  borders: [{ side: 'bottom', style: 'solid', widthPt: 1, color: '#000000' }],
+  shading: '#eeeeee',
+  keepWithNext: true,
+});
+editor.commands.run('paragraph.setLayout', { shading: null }); // null efface un attribut
+editor.commands.run('paragraph.setLayout', { lineHeight: 'abc' as unknown as number }); // false : valeur invalide ignorée, rien d'effacé
+editor.commands.run('paragraph.unsetLayout', { attrs: ['borders', 'shading'] });
+editor.commands.run('paragraph.unsetLayout'); // tout
+editor.commands.run('text.setLetterSpacing', { pt: 1.5 });
+editor.commands.run('text.setCaps', { caps: 'small' });
+editor.commands.isActive('text.setCaps', { caps: 'small' }); // true
+editor.commands.run('text.unsetCaps');
+editor.commands.run('text.setLetterSpacing', { pt: null }); // retire ; une marque textStyle vidée est supprimée
+```
+
+`canRun('paragraph.setLayout')` est vrai dès que la sélection touche un paragraphe ou un titre éditable (`hasLayoutBlockInSelection`), avec des arguments vides ou au moins une valeur valide ; les valeurs sont normalisées (nombres arrondis et bornés, couleurs `#rrggbb`, bordures mal formées filtrées, `false` et chaîne vide valent `null`). Pas de raccourci : ce sont des commandes de menu, câblées par les widgets de `ui`.
+
+## 📄 Vue page et pagination
+
+La vue page rend le `.ProseMirror` comme une feuille aux dimensions et marges de `layout.page` (`A4` par défaut, formats `A3`, `A4`, `A5`, `Letter`, `Legal` ou `{ widthMm, heightMm }`, orientation, marges, distances d'en-tête et de pied), avec les en-têtes et pieds `default` en lecture seule au-dessus et au-dessous du corps. Le core ne fait que poser des classes, des variables CSS et des conteneurs ; la feuille de style est `page.css` de `ui`.
+
+```ts
+const editor = createEditor({
+  element,
+  pageView: { layout, pagination: true, showHeadersFooters: true }, // ou `true` : A4 portrait, 25,4 mm
+});
+```
+
+Ce que `applyPageView` pose : la classe `aster--page-view` sur l'hôte (`editor.element`) ; les huit variables `PAGE_VIEW_CSS_VARIABLES` (`--aster-page-width`, `--aster-page-height`, `--aster-page-margin-top/right/bottom/left`, `--aster-page-margin-header`, `--aster-page-margin-footer`, en `mm`) calculées par `resolvePageMetrics(layout)` (valeurs absurdes, négatives ou au-delà de 10 000 mm ramenées aux défauts : jamais `Infinitymm`) ; deux conteneurs `div.aster-page-header` / `div.aster-page-footer` (`contenteditable="false"`) avant et après `contentElement`, remplis avec `layout.headers.default.html` / `footers.default.html` passés par `sanitizeHeaderFooterHtml` (liste blanche stricte de balises et d'attributs, `href` / `src` limités à `http`, `https`, `mailto`, `tel`, `data:image/`, caractères de contrôle retirés avant le test, `style` sans `url(`, `expression(` ni `\`, imbrication plafonnée à 64 niveaux, pile explicite plutôt que récursion). `showHeadersFooters: false` n'insère aucun conteneur.
+
+À chaud, l'implémentation expose `setPageView(options: boolean | PageViewOptions)` (`false` retire tout, idempotent) et `getLayout(): DocumentLayout | null`, **hors du contrat `AsterEditor`** pour l'instant (proposition de contrat de L23 et L26, voir `docs/API_CORE.md`) : `ui` les détecte à l'exécution via `pageViewApiOf(editor)` et le widget `pageLayout` se désactive si elles manquent. Une vue page qui lève au montage (mise en page hostile) est ignorée avec un avertissement, l'éditeur se monte quand même. `getActivePageView(contentElement)` rend les options actives, et l'événement DOM `aster:page-view-change` (`PAGE_VIEW_CHANGE_EVENT`, sans bulle) est émis sur `contentElement` à l'activation et au retrait.
+
+**Pagination approximative** (extension `Pagination`, toujours montée, inerte hors vue page ou avec `pagination: false` ; répartie en `pagination.ts` (extension et API), `pagination-measure.ts`, `pagination-controller.ts` et `pagination-layout.ts`, tout étant réexporté depuis `@aster-editor/core`) : un plugin ProseMirror mesure la hauteur rendue des blocs de premier niveau, en lot (`measureBlocks` : alignement DOM / document puis lectures de rectangles, aucune écriture ; un saut de page explicite mesure 0, la coupure qui le suit prend sa place), et pose en **décorations widget** (jamais dans le document, jamais dans `getHTML()`, aucun `change` émis) une coupure `div.aster-page-gap[data-page-number][data-page-count]` avec le libellé « Page n sur N » (`pageView.page`, `pageView.of` de l'i18n) avant chaque bloc qui dépasse la hauteur utile (`usablePageHeightPx` : hauteur de page moins marges, lue dans les variables `--aster-page-*`, 96 / 25,4 px par mm). Recalcul débouncé (`PAGINATION_DEBOUNCE_MS` = 150 ms) puis à la frame suivante, jamais dans un `dispatch` ; redimensionnement de la feuille observé. Sauts de page explicites (`<hr data-page-break>`, ou un nœud `pageBreak` d'intégrateur) forcés ; tableaux et listes **entiers** à la page suivante ; `--aster-page-count` sur l'hôte et `--aster-page-gap-fill` (espace libre en bas de la page précédente) sur chaque coupure, pour que `page.css` étire la feuille et dessine la bande de bureau. 4 000 paragraphes se paginent en 11 ms. **Aucune garantie d'exactitude avec Word** : césure, polices de substitution, interlignes « au moins », veuves et orphelines, `keepWithNext`, tableaux coupés ne sont pas simulés ; le nombre de pages est un ordre de grandeur. `getPaginationResult(editor)` rend `{ gaps, pageCount }` (`PaginationResult`), `paginateNow(editor)` mesure sans attendre (tests, feuille de style changée), `paginate(heights, usableHeight, forcedBreaks)` est la fonction pure.
+
+## 🧾 Sérialiseur HTML verbatim
+
+`getHTML()` ne passe plus par `tiptap.getHTML()` : le `DOMSerializer` de ProseMirror pose `style` via `element.style.cssText`, et le moteur CSS (navigateur ou jsdom) réécrit la valeur : couleurs en `rgb()`, `;` final, longhands repliés en raccourcis (`margin: 6pt 6pt 36pt 0pt`, dans un ordre faux sous jsdom). Le contrat de mise en page fige une sérialisation exacte que le paquet `word` relit. `serializeDocumentHtml(doc)` rend donc les `DOMOutputSpec` lui-même (`renderRawSpec`, `createRawStyleSerializer(schema)`), en posant chaque `style` par `setAttribute` verbatim ; tout le reste (structure, trous de contenu, marques) suit la sémantique de `renderSpec`, puis `normalizeOutputHtml` retire le bruit de table. Effet de bord assumé : les couleurs sortent en `#rrggbb`, plus en `rgb()`. La garde de ProseMirror contre un `toDOM` qui renverrait un tableau sorti tel quel des attributs (vecteur XSS : `<img onerror>` décrit par un JSON stocké) est reprise à l'identique (`SUSPICIOUS_SPEC_MESSAGE`).
 
 ## 📡 Événements (`AsterEvents`)
 
@@ -438,7 +534,7 @@ off();
 
 ## 🌍 i18n
 
-`fr` et `en` sont intégrés (63 clés chacun), `en` est la locale de repli : clé absente → `en` → la clé elle-même, jamais d'exception. L'interpolation utilise `{name}`.
+`fr` et `en` sont intégrés (70 clés chacun, mêmes clés dans les deux), `en` est la locale de repli : clé absente → `en` → la clé elle-même, jamais d'exception. L'interpolation utilise `{name}`.
 
 ```ts
 import { createEditor, en } from '@aster-editor/core';
@@ -455,7 +551,7 @@ editor.i18n.t('command.bold'); // 'Fett'
 editor.i18n.setLocale('fr'); // émet localeChange, la toolbar se retraduit
 ```
 
-Convention de clés : `command.<id>` pour les 58 commandes (`command.table.insert`, `command.search.open`, `command.variable.insert`, `command.formatPainter.copy`), `command.heading.level` avec `{level}`, `editor.placeholder`, `editor.words`, `editor.characters`, `variable.unresolved` avec `{name}` (`title` d'une puce sans valeur). Le paquet `ui` ajoute ses propres clés (`ui.*`) via `addTranslations`.
+Convention de clés : `command.<id>` pour les 63 commandes (`command.table.insert`, `command.search.open`, `command.variable.insert`, `command.formatPainter.copy`, `command.paragraph.setLayout`, `command.text.setCaps`), `command.heading.level` avec `{level}`, `editor.placeholder`, `editor.words`, `editor.characters`, `variable.unresolved` avec `{name}` (`title` d'une puce sans valeur), `pageView.page` et `pageView.of` (libellé « Page n sur N » de la pagination). Le paquet `ui` ajoute ses propres clés (`ui.*`) via `addTranslations`.
 
 ## 🔗 Politique de liens et d'images (`LinkPolicy`)
 
@@ -565,7 +661,7 @@ Tu peux aussi enregistrer après coup : `editor.commands.register(command)` / `u
 
 ## 🧱 Extensions Tiptap custom
 
-`options.extensions` ajoute des extensions après le jeu standard. Le jeu standard (`createAsterExtensions`) : `StarterKit` (sans `link`, titres 1-6), `Link` sécurisé, `TaskList` / `TaskItem` imbriqués, `TableKit` redimensionnable, `TextAlign` (paragraphes et titres, sans alignement par défaut), `Image` Aster (`align`, `width`, NodeView), `Variable` (puces liées au magasin de l'éditeur), `Subscript`, `Superscript`, `Highlight` multicolore, `TextStyleKit`, `Placeholder` (fonction de la locale), `CharacterCount`, `Search`, `Outline` (`id` des titres), raccourcis Aster.
+`options.extensions` ajoute des extensions après le jeu standard. Le jeu standard (`createAsterExtensions`, 28 entrées, 64 extensions une fois les kits aplatis) : `StarterKit` (sans `link`, `underline`, `strike` ni `horizontalRule`, titres 1-6), `AsterStrike` et `AsterUnderline` (style de trait), `AsterHorizontalRule` (`data-page-break`), `Link` sécurisé, `TaskList` / `TaskItem` imbriqués, tables redimensionnables (`TableKit`, `AsterTable`, `AsterTableCell`, `AsterTableHeader`), `TextAlign` (paragraphes et titres, sans alignement par défaut), `ParagraphLayout`, `ListLayout`, `Image` Aster (`align`, `width`, NodeView), `Subscript`, `Superscript`, `AsterHighlight` multicolore, `TextStyleKit` sans son `textStyle`, `AsterTextStyle`, `RunLayout`, `Variable` (puces liées au magasin de l'éditeur), `Placeholder` (fonction de la locale), `CharacterCount`, `Search`, `Outline` (`id` des titres), `Pagination`, raccourcis Aster.
 
 ```ts
 import { Extension } from '@tiptap/core';
@@ -598,8 +694,11 @@ const { from, to } = editor.tiptap.state.selection;
 
 Tout ce qui suit est dans `packages/core/src/index.ts` :
 
-- **Contrat** (`api/`) : `STANDARD_COMMAND_IDS` et tous les types (`AsterEditor`, `AsterOptions`, `AsterCommand`, `CommandRegistry`, `AsterEvents`, `AsterDocument`, `AsterCounts`, `I18n`, `PasteTransformer`, `ToolbarConfig`, `AsterVariable`, `VariableSource`, `VariableStore`, `VariableValues`, `VariableResolver`, `VariableRenderMode`, `GetHtmlOptions`…).
-- **Commandes** : `MARK_COMMANDS`, `BLOCK_COMMANDS`, `LIST_COMMANDS`, `ALIGNMENT_COMMANDS`, `TABLE_COMMANDS`, `TEXT_STYLE_COMMANDS`, `HISTORY_COMMANDS`, `SEARCH_COMMANDS`, `SEARCH_COMMAND_IDS`, `VARIABLE_COMMANDS`, `FORMAT_PAINTER_COMMANDS`, `FORMAT_PAINTER_COMMAND_IDS`, `createLinkCommands(policy)`, `createImageCommands(policy, upload)`, `createStandardCommands(context)`, `defineStandardCommand(id, spec)`, `iconIdFor(id)`, `toImageAttributes`, `getSearchStorage`, `SEARCH_OPEN_EVENT`, `FORMAT_PAINTER_CHANGE_EVENT`.
+- **Contrat** (`api/`) : `STANDARD_COMMAND_IDS`, `PARAGRAPH_LAYOUT_ATTR_NAMES` et tous les types (`AsterEditor`, `AsterOptions`, `AsterCommand`, `CommandRegistry`, `AsterEvents`, `AsterDocument`, `AsterCounts`, `I18n`, `PasteTransformer`, `ToolbarConfig`, `AsterVariable`, `VariableSource`, `VariableStore`, `VariableValues`, `VariableResolver`, `VariableRenderMode`, `GetHtmlOptions`, et ceux de `layout.ts` : `DocumentLayout`, `PageSetup`, `PageMargins`, `PageDimensions`, `PageSizeName`, `PageOrientation`, `HeaderFooterSet`, `HeaderFooterContent`, `DefaultFont`, `ParagraphLayoutAttrs`, `ParagraphLayoutAttrName`, `BlockBorder`, `BorderSide`, `BorderStyle`, `RunLayoutAttrs`, `DecorationStyle`, `ListLayoutAttrs`, `OrderedListType`, `TableLayoutAttrs`, `CellLayoutAttrs`, `CellVerticalAlign`, `PageViewOptions`).
+- **Commandes** : `MARK_COMMANDS`, `BLOCK_COMMANDS`, `LIST_COMMANDS`, `ALIGNMENT_COMMANDS`, `TABLE_COMMANDS`, `TEXT_STYLE_COMMANDS`, `HISTORY_COMMANDS`, `SEARCH_COMMANDS`, `SEARCH_COMMAND_IDS`, `VARIABLE_COMMANDS`, `FORMAT_PAINTER_COMMANDS`, `FORMAT_PAINTER_COMMAND_IDS`, `PARAGRAPH_LAYOUT_COMMANDS`, `TEXT_LAYOUT_COMMANDS`, `TEXT_LAYOUT_COMMAND_IDS`, `hasLayoutBlockInSelection`, `createLinkCommands(policy)`, `createImageCommands(policy, upload)`, `createStandardCommands(context)`, `defineStandardCommand(id, spec)`, `iconIdFor(id)`, `toImageAttributes`, `getSearchStorage`, `SEARCH_OPEN_EVENT`, `FORMAT_PAINTER_CHANGE_EVENT`.
+- **Mise en page** : `ParagraphLayout`, `parseParagraphLayout`, `renderParagraphLayout`, `paragraphLayoutDeclarations`, `normalizeParagraphLayoutValue`, `parseLineHeight`, `DOCX_STYLE_ATTRIBUTE`, `KEEP_NEXT_ATTRIBUTE`, `PAGE_BREAK_BEFORE_ATTRIBUTE`, `BORDER_BETWEEN_ATTRIBUTE`, `RunLayout`, `AsterTextStyle`, `AsterHighlight`, `AsterUnderline`, `AsterStrike`, `RUN_CAPS`, `DECORATION_STYLES`, `isCaps`, `isDecorationStyle`, `parseCaps`, `parseDecorationStyle`, `normalizeStyleColors`, `DOCX_RUN_STYLE_ATTRIBUTE`, `ListLayout`, `DOCX_NUM_ID_ATTRIBUTE`, `BULLET_ATTRIBUTE`, `DOCX_NUM_INDENT_ATTRIBUTE`, `AsterTable`, `AsterTableCell`, `AsterTableHeader`, `AsterTableView`, `createTableExtensions`, `MAX_COLSPAN`, `MAX_ROWSPAN`, `parseSpan`, `parseTableWidth`, `parseCellPadding`, `tableLayoutDeclarations`, `cellLayoutDeclarations` (`AsterHorizontalRule` n'est pas exporté : il est câblé par `createAsterExtensions`), et les helpers CSS de `layout-css` (`normalizeColor`, `parsePt`, `formatPt`, `parseStyleDeclarations`, `sanitizeBorders`, `borderDeclarations`, `isLayoutNumber`, `LAYOUT_NUMBER_LIMIT`…).
+- **Vue page et pagination** : `applyPageView`, `resolvePageMetrics`, `pageViewCssValues`, `sanitizeHeaderFooterHtml`, `getActivePageView`, `PAGE_VIEW_CLASS`, `PAGE_HEADER_CLASS`, `PAGE_FOOTER_CLASS`, `PAGE_VIEW_CSS_VARIABLES`, `PAGE_SIZES_MM`, `DEFAULT_PAGE_MARGIN_MM`, `PAGE_VIEW_CHANGE_EVENT`, `Pagination`, `getPaginationResult`, `paginateNow`, `measureBlocks`, `measurePagination`, `usablePageHeightPx`, `isPaginationEnabled`, `paginate`, `samePagination`, `cssLengthToPx`, `MM_TO_PX`, `EMPTY_PAGINATION`, `PAGE_GAP_CLASS`, `PAGE_GAP_NUMBER_CLASS`, `PAGE_NUMBER_ATTRIBUTE`, `PAGE_COUNT_ATTRIBUTE`, `PAGE_COUNT_CSS_VARIABLE`, `PAGE_GAP_FILL_CSS_VARIABLE`, `PAGINATION_DEBOUNCE_MS`, `paginationPluginKey`, types `PageMetrics`, `PageViewHandle`, `PaginationResult`, `PageGap`, `PaginatedPageViewOptions`.
+- **Sérialisation** : `serializeDocumentHtml`, `createRawStyleSerializer`, `renderRawSpec`, `SUSPICIOUS_SPEC_MESSAGE`, `normalizeOutputHtml`.
 - **Recherche** : `Search`, `findMatches`, `searchPluginKey`, `SEARCH_EXTENSION_NAME`, `SEARCH_MATCH_CLASS`, `SEARCH_CURRENT_CLASS`.
 - **Variables** : `Variable`, `createVariableStore`, `resolveVariablesHtml`, `findVariableAtSelection`, `isValidVariableName`, `variablePlaceholder`, `VARIABLE_EDIT_EVENT`, `VARIABLE_SELECTOR` et le reste de la liste de la section « Variables de document ».
 - **Sommaire et pinceau** : `Outline`, `getOutline`, `scrollToHeading`, `ensureHeadingIds`, `headingIdNumber`, `HEADING_ID_PREFIX`, `OUTLINE_EXTENSION_NAME`, `getFormatClipboard`, `hasFormatClipboard`, `clearFormatClipboard`, `readFormat`, `applyFormat`, `wordRangeAt`.
@@ -608,4 +707,4 @@ Tout ce qui suit est dans `packages/core/src/index.ts` :
 - **i18n et registre** : `createCommandRegistry(editor)`, `createI18n(locale, editor)`, `interpolate(template, params)`, `fr`, `en`, `FALLBACK_LOCALE`.
 - **Liens et images** : `DEFAULT_LINK_POLICY`, `resolveLinkPolicy`, `createLinkExtension`, `extractScheme`, `isAllowedHref`, `isAllowedImageSrc`, `createImageExtension`, `ImageNodeView`, `renderImageNodeView`, `parseImageWidth`, `clampImageWidth`, `isImageAlignment`, `IMAGE_ALIGNMENTS`, `IMAGE_CLASS`, `IMAGE_SELECTED_CLASS`, `IMAGE_HANDLE_CLASS`, `IMAGE_EDIT_EVENT`, `IMAGE_MIN_WIDTH`, `IMAGE_DEFAULT_DRAG_WIDTH`.
 - **Upload et collage** : `isImageFile`, `readFileAsDataUrl`, `insertImageFile`, `collectImageFiles`, `createImageUploadProps`, `applyPasteTransformers`, `createPastePipelineProps`.
-- **Raccourcis et assemblage** : `EXTRA_SHORTCUT_BINDINGS`, `collectShortcutBindings`, `createShortcutsExtension`, `createAsterExtensions`, `normalizeOutputHtml`, `CONTENT_CLASS`.
+- **Raccourcis et assemblage** : `EXTRA_SHORTCUT_BINDINGS`, `collectShortcutBindings`, `createShortcutsExtension`, `createAsterExtensions`, `CONTENT_CLASS`.

package/dist/api/commands.d.ts

@@ -1,10 +1,11 @@
 import type { AsterEditor } from './editor';
+import type { ParagraphLayoutAttrName, ParagraphLayoutAttrs } from './layout';
 /**
  * Identifiants des commandes standard fournies par le core. La toolbar et le wrapper
  * Angular s'appuient sur cette liste. Un identifiant pointé indique un domaine :
  * `table.insert`, `link.set`, `image.insert`.
  */
-export declare const STANDARD_COMMAND_IDS: readonly ["bold", "italic", "underline", "strike", "subscript", "superscript", "code", "highlight", "clearFormatting", "paragraph", "heading", "blockquote", "codeBlock", "horizontalRule", "hardBreak", "bulletList", "orderedList", "taskList", "indent", "outdent", "alignLeft", "alignCenter", "alignRight", "alignJustify", "link.set", "link.unset", "image.insert", "image.upload", "image.setAttributes", "table.insert", "table.delete", "table.addRowBefore", "table.addRowAfter", "table.deleteRow", "table.addColumnBefore", "table.addColumnAfter", "table.deleteColumn", "table.mergeCells", "table.splitCell", "table.toggleHeaderRow", "table.toggleHeaderColumn", "textColor", "backgroundColor", "fontFamily", "fontSize", "variable.insert", "variable.remove", "undo", "redo", "selectAll"];
+export declare const STANDARD_COMMAND_IDS: readonly ["bold", "italic", "underline", "strike", "subscript", "superscript", "code", "highlight", "clearFormatting", "paragraph", "heading", "blockquote", "codeBlock", "horizontalRule", "hardBreak", "bulletList", "orderedList", "taskList", "indent", "outdent", "alignLeft", "alignCenter", "alignRight", "alignJustify", "link.set", "link.unset", "image.insert", "image.upload", "image.setAttributes", "table.insert", "table.delete", "table.addRowBefore", "table.addRowAfter", "table.deleteRow", "table.addColumnBefore", "table.addColumnAfter", "table.deleteColumn", "table.mergeCells", "table.splitCell", "table.toggleHeaderRow", "table.toggleHeaderColumn", "textColor", "backgroundColor", "fontFamily", "fontSize", "variable.insert", "variable.remove", "paragraph.setLayout", "paragraph.unsetLayout", "undo", "redo", "selectAll"];
 export type StandardCommandId = (typeof STANDARD_COMMAND_IDS)[number];
 /** Identifiant de commande : standard ou custom. */
 export type CommandId = StandardCommandId | (string & {});
@@ -58,6 +59,12 @@ export interface StandardCommandArgs {
         name: string;
         label?: string;
     };
+    /** Fusionne les attributs donnés dans les paragraphes et titres de la sélection ; `null` efface un attribut. */
+    'paragraph.setLayout': ParagraphLayoutAttrs;
+    /** Efface les attributs nommés, ou tous sans argument. */
+    'paragraph.unsetLayout': {
+        attrs?: readonly ParagraphLayoutAttrName[];
+    } | undefined;
 }
 /** Type d'argument d'une commande standard, `undefined` si elle n'en prend pas. */
 export type CommandArgs<K extends CommandId> = K extends keyof StandardCommandArgs ? StandardCommandArgs[K] : undefined;

package/dist/api/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,ixBA6DvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACjC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,cAAc,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,cAAc,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAC/B,qBAAqB,EAAE;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;KACrC,CAAC;IACF,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpC,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClC,iBAAiB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAED,mFAAmF;AACnF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,MAAM,mBAAmB,GAC9E,mBAAmB,CAAC,CAAC,CAAC,GACtB,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,MAAM,mBAAmB,GACjF,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAC9B,EAAE,CAAC;AAEP;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,IAAI,GAAG,OAAO;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAC9C,oGAAoG;IACpG,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAClD,2FAA2F;IAC3F,QAAQ,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7C,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,IAAI,SAAS,YAAY,EAAE,CAAC;IAChC,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAC7E,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAChF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5C,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAClF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC/C"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"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"}

package/dist/api/commands.js

@@ -60,6 +60,9 @@ export const STANDARD_COMMAND_IDS = [
     // Variables (champs de fusion)
     'variable.insert',
     'variable.remove',
+    // Mise en page des paragraphes (session 3)
+    'paragraph.setLayout',
+    'paragraph.unsetLayout',
     // Historique et divers
     'undo',
     'redo',

package/dist/api/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;IACX,aAAa;IACb,MAAM;IACN,WAAW;IACX,iBAAiB;IACjB,QAAQ;IACR,WAAW;IACX,SAAS;IACT,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,YAAY;IACZ,aAAa;IACb,UAAU;IACV,QAAQ;IACR,SAAS;IACT,aAAa;IACb,WAAW;IACX,aAAa;IACb,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,SAAS;IACT,cAAc;IACd,cAAc;IACd,qBAAqB;IACrB,SAAS;IACT,cAAc;IACd,cAAc;IACd,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,UAAU;IACV,+BAA+B;IAC/B,iBAAiB;IACjB,iBAAiB;IACjB,uBAAuB;IACvB,MAAM;IACN,MAAM;IACN,WAAW;CACH,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/api/commands.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;IACX,aAAa;IACb,MAAM;IACN,WAAW;IACX,iBAAiB;IACjB,QAAQ;IACR,WAAW;IACX,SAAS;IACT,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,YAAY;IACZ,aAAa;IACb,UAAU;IACV,QAAQ;IACR,SAAS;IACT,aAAa;IACb,WAAW;IACX,aAAa;IACb,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,SAAS;IACT,cAAc;IACd,cAAc;IACd,qBAAqB;IACrB,SAAS;IACT,cAAc;IACd,cAAc;IACd,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,UAAU;IACV,+BAA+B;IAC/B,iBAAiB;IACjB,iBAAiB;IACjB,2CAA2C;IAC3C,qBAAqB;IACrB,uBAAuB;IACvB,uBAAuB;IACvB,MAAM;IACN,MAAM;IACN,WAAW;CACH,CAAC"}

package/dist/api/index.d.ts

@@ -9,6 +9,8 @@ export type { AsterEditor } from './editor';
 export type { AsterEventName, AsterEvents, Unsubscribe } from './events';
 export type { AsterDictionary, AsterLocale, I18n, TranslateParams } from './i18n';
 export type { AsterOptions, LinkPolicy, UploadHandler } from './options';
+export type { BlockBorder, BorderSide, BorderStyle, CellLayoutAttrs, CellVerticalAlign, DecorationStyle, DefaultFont, DocumentLayout, HeaderFooterContent, HeaderFooterSet, ListLayoutAttrs, OrderedListType, PageDimensions, PageMargins, PageOrientation, PageSetup, PageSizeName, PageViewOptions, ParagraphLayoutAttrName, ParagraphLayoutAttrs, RunLayoutAttrs, TableLayoutAttrs, } from './layout';
+export { PARAGRAPH_LAYOUT_ATTR_NAMES } from './layout';
 export type { PasteContext, PasteTransformer } from './paste';
 export type { AsterVariable, GetHtmlOptions, VariableRenderMode, VariableResolver, VariableSource, VariableStore, VariableValues, } from './variables';
 export type { AsterTheme, ToolbarButtonItem, ToolbarConfig, ToolbarDropdownItem, ToolbarGroup, ToolbarItem, ToolbarPreset, ToolbarWidgetItem, } from './toolbar';

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC9D,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACzE,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,SAAS,EACT,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC9D,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/api/index.js

@@ -1,2 +1,3 @@
 export { STANDARD_COMMAND_IDS } from './commands';
+export { PARAGRAPH_LAYOUT_ATTR_NAMES } from './layout';
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA8BlD,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC"}