myrole-docx-editor 0.2.0 → 0.3.1

package/dist/chunks/{vars-blockly-BQPk_GUT.js → vars-blockly-BVG2ZfAW.js}

@@ -1,5 +1,5 @@
 import * as s from "blockly";
-import { k as p, T as u, m, n as f, o as g, q as h } from "./sdk-BM5tI24s.js";
+import { k as p, T as u, m, n as f, o as g, q as h } from "./sdk-Bi8qAaV_.js";
 let r = !1;
 function b(o, n, i) {
   r || (p(), r = !0), o.replaceChildren();
@@ -39,4 +39,4 @@ function b(o, n, i) {
 export {
   b as mountBlockly
 };
-//# sourceMappingURL=vars-blockly-BQPk_GUT.js.map
+//# sourceMappingURL=vars-blockly-BVG2ZfAW.js.map

package/dist/chunks/{vars-blockly-BQPk_GUT.js.map → vars-blockly-BVG2ZfAW.js.map}

@@ -1 +1 @@
-{"version":3,"file":"vars-blockly-BQPk_GUT.js","sources":["../../src/vars-blockly.ts"],"sourcesContent":["import * as Blockly from 'blockly'\nimport {\n  decorate, defineBlocks, fieldLibrary, setFields, THEME, TOOLBOX,\n  type BlockJson,\n} from '@myrole/docx-vars'\nimport type { Tag } from '@myrole/docx-tags'\n\n/**\n * Le mode Blockly, chargé à la demande.\n *\n * Le canvas ne se replie pas — c'est ce qui a fait choisir le rendu DOM par\n * défaut — mais il sait ce que le DOM ne fait pas encore aussi bien :\n * restructurer librement une expression au glisser-déposer, avec sa poubelle,\n * son annulation et ses connexions typées.\n *\n * Il vit dans son propre module pour ne peser que si on l'ouvre : un\n * mégaoctet et demi qu'un utilisateur qui ne bascule jamais ne télécharge pas.\n */\n\nlet defined = false\n\nexport interface BlocklyView {\n  load(tree: BlockJson): void\n  read(): BlockJson | null\n  resize(): void\n  dispose(): void\n}\n\nexport function mountBlockly(\n  holder: HTMLElement, onChange: () => void, tags: () => Tag[],\n): BlocklyView {\n  if (!defined) { defineBlocks(); defined = true }\n  holder.replaceChildren()\n  const host = document.createElement('div')\n  host.className = 'vp-canvas-host'\n  holder.append(host)\n\n  const ws = Blockly.inject(host, {\n    // La boîte à outils : sans elle, on peut lire une expression et la\n    // rebrancher, mais pas y AJOUTER quoi que ce soit — c'est la moitié de ce\n    // qu'on vient chercher dans un canvas de blocs.\n    toolbox: TOOLBOX,\n    theme: THEME,\n    renderer: 'geras',\n    trashcan: true,\n    sounds: false,\n    grid: { spacing: 20, length: 1, colour: '#e8e9ed', snap: false },\n    zoom: { controls: true, wheel: true, startScale: 0.95, minScale: 0.3, maxScale: 2 },\n    move: { scrollbars: true, drag: true, wheel: true },\n  })\n  ws.addChangeListener((e) => { if (!e.isUiEvent) onChange() })\n\n  return {\n    load(tree) {\n      // `setFields` alimente le sélecteur du bloc « champ » : sans lui, un clic\n      // sur un champ n'ouvre rien.\n      const groups = fieldLibrary(tags())\n      setFields(groups.flatMap((g) => g.fields.map((f) => ({ path: f.path, label: f.label }))))\n      Blockly.serialization.workspaces.load({ blocks: { languageVersion: 0, blocks: [tree] } }, ws)\n      decorate(ws)\n      Blockly.svgResize(ws)\n    },\n    read() {\n      const state = Blockly.serialization.workspaces.save(ws) as {\n        blocks?: { blocks?: BlockJson[] }\n      }\n      return state?.blocks?.blocks?.[0] ?? null\n    },\n    resize() { Blockly.svgResize(ws) },\n    dispose() { ws.dispose() },\n  }\n}\n"],"names":["defined","mountBlockly","holder","onChange","tags","defineBlocks","host","ws","Blockly","TOOLBOX","THEME","e","tree","groups","fieldLibrary","setFields","g","f","decorate"],"mappings":";;AAmBA,IAAIA,IAAU;AASP,SAASC,EACdC,GAAqBC,GAAsBC,GAC9B;AACb,EAAKJ,MAAWK,EAAA,GAAgBL,IAAU,KAC1CE,EAAO,gBAAA;AACP,QAAMI,IAAO,SAAS,cAAc,KAAK;AACzC,EAAAA,EAAK,YAAY,kBACjBJ,EAAO,OAAOI,CAAI;AAElB,QAAMC,IAAKC,EAAQ,OAAOF,GAAM;AAAA;AAAA;AAAA;AAAA,IAI9B,SAASG;AAAA,IACT,OAAOC;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM,EAAE,SAAS,IAAI,QAAQ,GAAG,QAAQ,WAAW,MAAM,GAAA;AAAA,IACzD,MAAM,EAAE,UAAU,IAAM,OAAO,IAAM,YAAY,MAAM,UAAU,KAAK,UAAU,EAAA;AAAA,IAChF,MAAM,EAAE,YAAY,IAAM,MAAM,IAAM,OAAO,GAAA;AAAA,EAAK,CACnD;AACD,SAAAH,EAAG,kBAAkB,CAACI,MAAM;AAAE,IAAKA,EAAE,aAAWR,EAAA;AAAA,EAAW,CAAC,GAErD;AAAA,IACL,KAAKS,GAAM;AAGT,YAAMC,IAASC,EAAaV,GAAM;AAClC,MAAAW,EAAUF,EAAO,QAAQ,CAACG,MAAMA,EAAE,OAAO,IAAI,CAACC,OAAO,EAAE,MAAMA,EAAE,MAAM,OAAOA,EAAE,MAAA,EAAQ,CAAC,CAAC,GACxFT,EAAQ,cAAc,WAAW,KAAK,EAAE,QAAQ,EAAE,iBAAiB,GAAG,QAAQ,CAACI,CAAI,EAAA,EAAE,GAAKL,CAAE,GAC5FW,EAASX,CAAE,GACXC,EAAQ,UAAUD,CAAE;AAAA,IACtB;AAAA,IACA,OAAO;AAIL,aAHcC,EAAQ,cAAc,WAAW,KAAKD,CAAE,GAGxC,QAAQ,SAAS,CAAC,KAAK;AAAA,IACvC;AAAA,IACA,SAAS;AAAE,MAAAC,EAAQ,UAAUD,CAAE;AAAA,IAAE;AAAA,IACjC,UAAU;AAAE,MAAAA,EAAG,QAAA;AAAA,IAAU;AAAA,EAAA;AAE7B;"}
+{"version":3,"file":"vars-blockly-BVG2ZfAW.js","sources":["../../src/vars-blockly.ts"],"sourcesContent":["import * as Blockly from 'blockly'\nimport {\n  decorate, defineBlocks, fieldLibrary, setFields, THEME, TOOLBOX,\n  type BlockJson,\n} from '@myrole/docx-vars'\nimport type { Tag } from '@myrole/docx-tags'\n\n/**\n * Le mode Blockly, chargé à la demande.\n *\n * Le canvas ne se replie pas — c'est ce qui a fait choisir le rendu DOM par\n * défaut — mais il sait ce que le DOM ne fait pas encore aussi bien :\n * restructurer librement une expression au glisser-déposer, avec sa poubelle,\n * son annulation et ses connexions typées.\n *\n * Il vit dans son propre module pour ne peser que si on l'ouvre : un\n * mégaoctet et demi qu'un utilisateur qui ne bascule jamais ne télécharge pas.\n */\n\nlet defined = false\n\nexport interface BlocklyView {\n  load(tree: BlockJson): void\n  read(): BlockJson | null\n  resize(): void\n  dispose(): void\n}\n\nexport function mountBlockly(\n  holder: HTMLElement, onChange: () => void, tags: () => Tag[],\n): BlocklyView {\n  if (!defined) { defineBlocks(); defined = true }\n  holder.replaceChildren()\n  const host = document.createElement('div')\n  host.className = 'vp-canvas-host'\n  holder.append(host)\n\n  const ws = Blockly.inject(host, {\n    // La boîte à outils : sans elle, on peut lire une expression et la\n    // rebrancher, mais pas y AJOUTER quoi que ce soit — c'est la moitié de ce\n    // qu'on vient chercher dans un canvas de blocs.\n    toolbox: TOOLBOX,\n    theme: THEME,\n    renderer: 'geras',\n    trashcan: true,\n    sounds: false,\n    grid: { spacing: 20, length: 1, colour: '#e8e9ed', snap: false },\n    zoom: { controls: true, wheel: true, startScale: 0.95, minScale: 0.3, maxScale: 2 },\n    move: { scrollbars: true, drag: true, wheel: true },\n  })\n  ws.addChangeListener((e) => { if (!e.isUiEvent) onChange() })\n\n  return {\n    load(tree) {\n      // `setFields` alimente le sélecteur du bloc « champ » : sans lui, un clic\n      // sur un champ n'ouvre rien.\n      const groups = fieldLibrary(tags())\n      setFields(groups.flatMap((g) => g.fields.map((f) => ({ path: f.path, label: f.label }))))\n      Blockly.serialization.workspaces.load({ blocks: { languageVersion: 0, blocks: [tree] } }, ws)\n      decorate(ws)\n      Blockly.svgResize(ws)\n    },\n    read() {\n      const state = Blockly.serialization.workspaces.save(ws) as {\n        blocks?: { blocks?: BlockJson[] }\n      }\n      return state?.blocks?.blocks?.[0] ?? null\n    },\n    resize() { Blockly.svgResize(ws) },\n    dispose() { ws.dispose() },\n  }\n}\n"],"names":["defined","mountBlockly","holder","onChange","tags","defineBlocks","host","ws","Blockly","TOOLBOX","THEME","e","tree","groups","fieldLibrary","setFields","g","f","decorate"],"mappings":";;AAmBA,IAAIA,IAAU;AASP,SAASC,EACdC,GAAqBC,GAAsBC,GAC9B;AACb,EAAKJ,MAAWK,EAAA,GAAgBL,IAAU,KAC1CE,EAAO,gBAAA;AACP,QAAMI,IAAO,SAAS,cAAc,KAAK;AACzC,EAAAA,EAAK,YAAY,kBACjBJ,EAAO,OAAOI,CAAI;AAElB,QAAMC,IAAKC,EAAQ,OAAOF,GAAM;AAAA;AAAA;AAAA;AAAA,IAI9B,SAASG;AAAA,IACT,OAAOC;AAAA,IACP,UAAU;AAAA,IACV,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM,EAAE,SAAS,IAAI,QAAQ,GAAG,QAAQ,WAAW,MAAM,GAAA;AAAA,IACzD,MAAM,EAAE,UAAU,IAAM,OAAO,IAAM,YAAY,MAAM,UAAU,KAAK,UAAU,EAAA;AAAA,IAChF,MAAM,EAAE,YAAY,IAAM,MAAM,IAAM,OAAO,GAAA;AAAA,EAAK,CACnD;AACD,SAAAH,EAAG,kBAAkB,CAACI,MAAM;AAAE,IAAKA,EAAE,aAAWR,EAAA;AAAA,EAAW,CAAC,GAErD;AAAA,IACL,KAAKS,GAAM;AAGT,YAAMC,IAASC,EAAaV,GAAM;AAClC,MAAAW,EAAUF,EAAO,QAAQ,CAACG,MAAMA,EAAE,OAAO,IAAI,CAACC,OAAO,EAAE,MAAMA,EAAE,MAAM,OAAOA,EAAE,MAAA,EAAQ,CAAC,CAAC,GACxFT,EAAQ,cAAc,WAAW,KAAK,EAAE,QAAQ,EAAE,iBAAiB,GAAG,QAAQ,CAACI,CAAI,EAAA,EAAE,GAAKL,CAAE,GAC5FW,EAASX,CAAE,GACXC,EAAQ,UAAUD,CAAE;AAAA,IACtB;AAAA,IACA,OAAO;AAIL,aAHcC,EAAQ,cAAc,WAAW,KAAKD,CAAE,GAGxC,QAAQ,SAAS,CAAC,KAAK;AAAA,IACvC;AAAA,IACA,SAAS;AAAE,MAAAC,EAAQ,UAAUD,CAAE;AAAA,IAAE;AAAA,IACjC,UAAU;AAAE,MAAAA,EAAG,QAAA;AAAA,IAAU;AAAA,EAAA;AAE7B;"}

package/dist/index.js

@@ -1,5 +1,5 @@
-import { i as f, r as m, e as w, f as p, p as u, l as y, a as g, b as h, c as x } from "./chunks/sdk-BM5tI24s.js";
-import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-BM5tI24s.js";
+import { i as f, r as m, e as w, f as p, p as u, l as y, a as g, b as h, c as x } from "./chunks/sdk-Bi8qAaV_.js";
+import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-Bi8qAaV_.js";
 async function P(a, o, r = {}) {
   const i = performance.now(), [c] = await Promise.all([
     typeof a == "string" ? fetch(a).then((e) => e.ok ? e.arrayBuffer() : Promise.reject(new Error(`${e.status} ${a}`))) : Promise.resolve(a),

package/dist/react.js

@@ -1,6 +1,6 @@
 import { jsx as h } from "react/jsx-runtime";
 import { forwardRef as v, useRef as o, useEffect as a } from "react";
-import { d as y } from "./chunks/sdk-BM5tI24s.js";
+import { d as y } from "./chunks/sdk-Bi8qAaV_.js";
 const s = v(function({ src: u, className: b, style: S, onReady: g, ...e }, f) {
   const l = o(null), c = o(null), n = o(e);
   n.current = e;

package/dist/types/packages/docx-editor/src/assistant.d.ts

@@ -0,0 +1,26 @@
+import type { DocxEditorHandle } from './sdk';
+/**
+ * The editor as the tool provider of a LOCAL MCP server.
+ *
+ * The tools run here, on the document open in this tab; `scripts/assistant-mcp.ts`
+ * only relays them between the MCP client (Claude Code) and the tab. Exactly one
+ * tab is connected at a time: the one where the user last pressed « Assistant ».
+ * The model never chooses which editor it drives, and it never sees a URL, a
+ * token or the package — only paragraph text, addressed by index.
+ *
+ * ponytail: body paragraphs only; headers, footers and notes when someone needs them.
+ */
+export interface AssistantTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    readOnly: boolean;
+}
+export interface AssistantOptions {
+    /** the relay started by `scripts/assistant-mcp.ts` */
+    url?: string;
+}
+export declare const ASSISTANT_TOOLS: AssistantTool[];
+export declare function runTool(handle: DocxEditorHandle, name: string, args: Record<string, unknown>): unknown;
+/** The « Assistant » button of the status bar, and the connection it opens. */
+export declare function mountAssistant(status: HTMLElement, handle: DocxEditorHandle, options?: AssistantOptions): () => void;

package/dist/types/packages/docx-editor/src/commands.d.ts

@@ -11,7 +11,7 @@ import type { Command } from './editor';
  */
 export declare const FONTS: string[];
 export declare const SIZES: number[];
-/** Quatre traits, décalés selon l'alignement — l'icône de Word, en SVG. */
+/** Alignment uses the same optical grid as the other ribbon actions. */
 export declare function alignIcon(align: string): SVGElement;
 /**
  * Insere une variable au curseur, choisie dans la bibliotheque du document.

package/dist/types/packages/docx-editor/src/editor.d.ts

@@ -1,5 +1,5 @@
 import { type CellPatch, type MarginPatch, type DocViews, type DocxDocument, type DocPos, type EditContext, type PageSetup, type PageSetupPatch, type ParaPatch, type RunPatch } from '../../docx-model/src/index';
-import { type ImageRect, type LineTrace, type MarkRect, type ResumeState, type SelRect, type TableRect } from '../../docx-render/src/index';
+import { type ImageRect, type LineTrace, type MarkRect, type ResumeState, type SelRect, type TableRect, type CellRect } from '../../docx-render/src/index';
 export interface EditorHooks {
     /** appelé après chaque composition, avec ce qu'il faut pour la barre d'outils */
     onContext?(ctx: EditContext | null, hasSelection: boolean): void;
@@ -19,6 +19,7 @@ export interface ComposeOut {
      * peindre : c'est l'hôte qui vient poser dedans. Voir extensions.md.
      */
     mark(r: MarkRect): void;
+    cell(r: CellRect): void;
 }
 /** Ce que l'hôte fournit : comment composer le document, et où. */
 export interface EditorSetup {
@@ -117,6 +118,15 @@ export declare function createEditor(setup: EditorSetup): {
         width: number;
         height: number;
     }[];
+    cellRects: () => {
+        para: number;
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[];
+    selectedCells: () => number[];
     /** Objet sélectionné — une image ou un tableau pris comme un tout, ou `null`. */
     selectedObject: () => {
         kind: "image";
@@ -178,11 +188,12 @@ export declare function createEditor(setup: EditorSetup): {
     setListLevel(level: number): void;
     restartList(start?: number): boolean;
     setList(ordered: boolean | null): void;
+    clearTableBorders(): boolean;
     formatCell(patch: CellPatch): boolean;
     mergeNextCell(): boolean;
     replaceAll(query: string, replacement: string, matchCase?: boolean): number;
     /** Insère du texte au curseur, ou remplace la sélection. */
-    insert: (text: string) => void;
+    insert: (text: string, patch?: RunPatch) => void;
     deleteSelection: () => void;
     deleteObject: () => void;
     splitAtCaret: () => void;

package/dist/types/packages/docx-editor/src/html.d.ts

@@ -1,4 +1,4 @@
-import type { PastedBlock } from '../../docx-model/src/index';
+import type { PastedBlock, PastedRun, RunPatch } from '../../docx-model/src/index';
 /** Décode une URI `data:` en octets, ou rend `null` si ce n'en est pas une. */
 export declare function dataUri(src: string): {
     data: Uint8Array;
@@ -10,4 +10,5 @@ export declare function dataUri(src: string): {
  * Les espaces sont normalisées comme le ferait un navigateur — le HTML de Word
  * est plein de retours à la ligne et d'indentation qui ne sont pas du texte.
  */
-export declare function htmlToBlocks(html: string): PastedBlock[];
+export declare function htmlToBlocks(html: string, baseStyle?: RunPatch): PastedBlock[];
+export declare function runsToHtml(paragraphs: PastedRun[][]): string;

package/dist/types/packages/docx-editor/src/index.d.ts

@@ -10,6 +10,7 @@
 export { createDocxEditor } from './sdk';
 export type { DocxEditorHandle, DocxEditorOptions, DocxEditorUiOptions, DocxEditorEvent, ChromeMode, Theme } from './sdk';
 export type { FeedbackReport, FeedbackContext, FeedbackOptions } from './feedback';
+export type { AssistantOptions } from './assistant';
 export { renderDocx } from './embed';
 export type { Rendered } from './embed';
 export { installFonts, defaultFontsUrl } from './fonts';

package/dist/types/packages/docx-editor/src/sdk.d.ts

@@ -21,6 +21,7 @@ import { type CommentRange } from './comments';
 import { type Panel, type DocxEditorUiOptions } from './ui/shell';
 import { type Draft } from './drafts';
 import { type FeedbackOptions } from './feedback';
+import { type AssistantOptions } from './assistant';
 export type ChromeMode = 'full' | 'viewer' | 'none';
 export type Theme = 'light' | 'dark' | 'system';
 export type { DocxEditorUiOptions } from './ui/shell';
@@ -64,10 +65,14 @@ export interface DocxEditorOptions {
     panel?: Panel | null;
     /** the fields and snippets the application offers, beyond what the document already uses */
     library?: LibraryExtras;
+    /** Optional host loader, called once per editor; the host owns the route and authentication. */
+    loadLibrary?: () => Promise<unknown>;
     /** show Word's comments as marks on the text (default true) */
     comments?: boolean;
     /** Opt-in feedback button: true exports JSON; onSubmit routes the report to the host. */
     feedback?: boolean | FeedbackOptions;
+    /** Opt-in « Assistant » button: lends this tab's document to the local MCP relay (`scripts/assistant-mcp.ts`). */
+    assistant?: boolean | AssistantOptions;
 }
 export interface DocxEditorHandle {
     load(src: ArrayBuffer | Uint8Array | Blob | string, options?: {

package/dist/types/packages/docx-editor/src/vars-complete.d.ts

@@ -8,8 +8,7 @@ import type { Tag } from '../../docx-tags/src/index';
  *
  * - **dans un tag ouvert** (`{{` ou `{%` sans fermeture avant le curseur) :
  *   champs et fonctions, c'est-à-dire ce qui a le droit d'y figurer ;
- * - **après un `/` en début de mot** : les extraits, comme partout ailleurs
- *   depuis que Notion en a fait une convention.
+ * - **après un `/` en début de mot** : champs, fonctions et extraits.
  *
  * Le clavier passe AVANT l'éditeur : la capture est posée sur le champ de
  * frappe, et les flèches, Entrée, Tab et Échap ne redescendent pas jusqu'à lui
@@ -30,7 +29,7 @@ export interface CompleteHost {
         off: number;
     } | null;
     /** Remplace une plage du paragraphe courant par ce texte. */
-    replace(para: number, from: number, to: number, text: string): void;
+    replace(para: number, from: number, to: number, text: string, caretOffset?: number): void;
     /** Where to hang the list; by default under the page's caret. */
     anchor?(): DOMRect | undefined;
 }
@@ -51,6 +50,7 @@ interface Context {
     kinds: LibEntry['kind'][];
     /** ce qu'on insère : le code entier, ou seulement l'expression */
     as: 'code' | 'expr';
+    padded?: boolean;
 }
 /**
  * Lit le contexte de frappe autour du curseur.

package/dist/types/packages/docx-editor/src/vars-library.d.ts

@@ -23,13 +23,23 @@ export interface LibEntry {
     /** Ce qu'on met dans une expression, sans les accolades. */
     expr: string;
     desc?: string;
+    /** Example rendered value, such as RODET; informational metadata, separate from inserted code. */
+    output?: string;
+    tags?: string[];
+    deprecated?: boolean;
 }
 /** A field the host declares — what the matrix MAY use, beyond what it already does. */
 export interface LibraryField {
     /** `salarie.nom` */
     path: string;
+    /** Exact insertion text supplied by the variable catalog. */
+    copy?: string;
+    tags?: string[];
+    deprecated?: boolean;
     label?: string;
     desc?: string;
+    /** Example rendered value, such as RODET; informational metadata, separate from inserted code. */
+    output?: string;
 }
 /** A snippet the host declares — a whole block, ready to paste. */
 export interface LibrarySnippet {
@@ -38,6 +48,8 @@ export interface LibrarySnippet {
     code: string;
     category?: string;
     desc?: string;
+    /** Example rendered value, such as RODET; informational metadata, separate from inserted code. */
+    output?: string;
 }
 export interface LibraryExtras {
     fields?: LibraryField[];
@@ -45,6 +57,8 @@ export interface LibraryExtras {
     /** keep the built-in snippets next to the host's (default true) */
     builtinSnippets?: boolean;
 }
+/** Validate host-loaded JSON before replacing any existing catalog entries. */
+export declare function parseLibrary(data: unknown): LibraryExtras;
 /** Each editor supplies its own library. */
 export declare function libraryEntries(tags: Tag[], extras?: LibraryExtras): LibEntry[];
 /** Filtre sans accent ni casse — on cherche « majore », on trouve « Majoré ». */

package/dist/types/packages/docx-editor/src/vars-panel.d.ts

@@ -35,6 +35,8 @@ export interface VarsPanel {
     show(tag: Tag | null): void;
     /** Ouvre la bibliothèque, sans tag. */
     library(): void;
+    /** Refresh catalog data without opening the panel or replacing the tag being edited. */
+    refreshLibrary(): void;
     current(): Tag | null;
     open(): boolean;
     destroy(): void;

package/dist/types/packages/docx-model/src/editor.d.ts

@@ -294,6 +294,8 @@ export interface CellPatch {
     borderPt?: number;
     borderColor?: string;
 }
+/** Explicit nil borders suppress style inheritance; nested tables keep their own grid. */
+export declare function clearTableBorders(doc: DocxDocument, para: number): boolean;
 export declare function formatCell(doc: DocxDocument, para: number, patch: CellPatch): boolean;
 /** Merge with the next cell without dropping its paragraphs. Vertical merges are protected. */
 export declare function mergeNextCell(doc: DocxDocument, para: number): boolean;

package/dist/types/packages/docx-render/src/index.d.ts

@@ -2,7 +2,7 @@ export { render } from './renderer';
 export { PT_PX } from './types';
 export { decodeImage, preloadImages } from './images';
 export type { RenderInput, RenderOptions, ResumeState } from './render-api';
-export type { BreakTrace, ImageMap, ImageRect, LineTrace, MarkRect, PlacedTextBox, RowTrace, RuleTrace, SectionParts, TableRect, } from './types';
+export type { BreakTrace, ImageMap, ImageRect, LineTrace, MarkRect, PlacedTextBox, RowTrace, RuleTrace, SectionParts, TableRect, CellRect, } from './types';
 export { caretAt, editableLines, hitTest, ordered, paraRange, samePos, selectionRects, verticalStep, } from './hit';
 export type { CaretRect, DocPos, HitMode, SelRect } from './hit';
 export { buildRenderInput, footnoteContent, partParagraphs, styleParagraphs } from './document';

package/dist/types/packages/docx-render/src/render-api.d.ts

@@ -1,6 +1,6 @@
 import type { BodyBlock, ListInfo, PageSetup, StyledParagraph, TableInfo } from '../../docx-model/src/index';
 import type { SideWrap } from './floating';
-import type { BreakTrace, Footnotes, ImageMap, ImageRect, LineTrace, MarkRect, PlacedTextBox, RowTrace, RuleTrace, SectionParts, TableRect } from './types';
+import type { BreakTrace, Footnotes, ImageMap, ImageRect, LineTrace, MarkRect, PlacedTextBox, RowTrace, RuleTrace, SectionParts, TableRect, CellRect } from './types';
 /**
  * Public input of the document compositor.
  *
@@ -39,6 +39,7 @@ export interface RenderOptions {
     onLine?(line: LineTrace): void;
     onImage?(rect: ImageRect): void;
     onTable?(rect: TableRect): void;
+    onCell?(rect: CellRect): void;
     /** Include empty lines in traces (needed by the editor, not the bench). */
     traceEmpty?: boolean;
     onRule?(rule: RuleTrace): void;

package/dist/types/packages/docx-render/src/types.d.ts

@@ -136,6 +136,7 @@ export interface DrawCtx {
     onLine?(line: LineTrace): void;
     /** publie le rectangle de chaque image dessinée — la souris n'a que ça */
     onImage?(rect: ImageRect): void;
+    onCell?(rect: CellRect): void;
     /** Internal content tracking, independent of public traces and bitmap decoding.
      * Wire only into real body/cell paint contexts, never speculative probes. */
     onContent?(page: number): void;
@@ -353,6 +354,12 @@ export interface Footnotes {
     }>;
 }
 export interface LineTrace {
+    /** Editing bounds include whitespace omitted from the ink trace. */
+    caretRange?: {
+        from: number;
+        to: number;
+        endX: number;
+    };
     /**
      * Index du BLOC dont vient cette ligne.
      *
@@ -479,6 +486,15 @@ export interface TableRect {
     width: number;
     height: number;
 }
+/** A cell fragment on one page, addressed by its first body paragraph. */
+export interface CellRect {
+    para: number;
+    page: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 /** Rectangle dessiné pour un run marqué, en px CSS relatifs à sa page. */
 export interface MarkRect {
     mark: string;

package/dist/types/packages/docx-tags/src/grammar.d.ts

@@ -18,6 +18,7 @@ export declare const DIRECTIVES: {
     readonly 'inline-section': "open";
     readonly 'style-section': "open";
     readonly 'else-section': "middle";
+    readonly 'else-if-section': "middle";
     readonly 'end-section': "close";
     readonly 'table-start': "open";
     readonly 'table-end': "close";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrole-docx-editor",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Word-faithful .docx editor and renderer on canvas — the MyRole engine as an embeddable SDK, with a React component.",
   "license": "UNLICENSED",
   "type": "module",
@@ -46,20 +46,25 @@
     "react-dom": "^19.2.8",
     "vite": "^6.4.3",
     "@myrole/docx-model": "0.0.0",
-    "@myrole/docx-vars": "0.0.0",
-    "@myrole/fonts": "0.1.0",
+    "@myrole/docx-tags": "0.0.0",
     "@myrole/docx-render": "0.0.0",
-    "@myrole/docx-tags": "0.0.0"
+    "@myrole/fonts": "0.1.0",
+    "@myrole/docx-vars": "0.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "fonts": "node scripts/pack-fonts.mjs",
-    "build": "node scripts/pack-fonts.mjs && vite build && node scripts/types.mjs",
-    "check": "node scripts/pack-fonts.mjs && tsc -p tsconfig.json && tsx scripts/locking.test.ts",
+    "build": "node scripts/pack-fonts.mjs && vite build && vite build --config vite.assistant.config.ts && node scripts/types.mjs",
+    "watch": "vite build --watch",
+    "check": "node scripts/pack-fonts.mjs && tsc -p tsconfig.json && tsx scripts/locking.test.ts && tsx scripts/assistant-mcp.test.ts",
+    "assistant": "tsx scripts/assistant-mcp.ts",
     "types": "node scripts/types.mjs"
   },
+  "bin": {
+    "myrole-docx-assistant": "./dist/assistant-mcp.mjs"
+  },
   "typesVersions": {
     "*": {
       "react": [