myrole-docx-editor 0.3.0 → 0.4.0

package/dist/chunks/{vars-blockly-CBim6Ow0.js → vars-blockly-CMA3qyLP.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-CU9i-NwD.js";
+import { k as p, T as u, m, n as f, o as g, q as h } from "./sdk-BIAG7DE-.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-CBim6Ow0.js.map
+//# sourceMappingURL=vars-blockly-CMA3qyLP.js.map

package/dist/chunks/{vars-blockly-CBim6Ow0.js.map → vars-blockly-CMA3qyLP.js.map}

@@ -1 +1 @@
-{"version":3,"file":"vars-blockly-CBim6Ow0.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-CMA3qyLP.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,6 +1,6 @@
-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-CU9i-NwD.js";
-import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-CU9i-NwD.js";
-async function P(a, o, r = {}) {
+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-BIAG7DE-.js";
+import { D as v, d as b, g as E, h as I, j as U, s as C } from "./chunks/sdk-BIAG7DE-.js";
+async function R(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),
     f(r.fontsUrl)
@@ -22,12 +22,13 @@ async function P(a, o, r = {}) {
   }), { pages: [...o.querySelectorAll("canvas")], ms: Math.round(performance.now() - i) };
 }
 export {
-  R as createDocxEditor,
-  b as createDocxViewer,
-  U as defaultFontsUrl,
-  j as evaluateTags,
+  v as DOCX_EDITOR_VERSION,
+  b as createDocxEditor,
+  E as createDocxViewer,
+  I as defaultFontsUrl,
+  U as evaluateTags,
   f as installFonts,
-  P as renderDocx,
-  A as sampleValues
+  R as renderDocx,
+  C as sampleValues
 };
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,24 +1,25 @@
 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-CU9i-NwD.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;
+import { forwardRef as v, useRef as f, useEffect as n } from "react";
+import { d as y } from "./chunks/sdk-BIAG7DE-.js";
+import { D as I } from "./chunks/sdk-BIAG7DE-.js";
+const s = v(function({ src: u, className: b, style: i, onReady: g, ...e }, o) {
+  const l = f(null), c = f(null), a = f(e);
+  a.current = e;
   const m = (r) => {
-    typeof f == "function" ? f(r) : f && (f.current = r);
+    typeof o == "function" ? o(r) : o && (o.current = r);
   };
-  return a(() => {
+  return n(() => {
     const r = y(l.current, {
       ...e,
-      onSave: e.onSave ? (t, d) => n.current.onSave(t, d) : void 0,
-      onError: (t) => n.current.onError?.(t),
-      onSaveState: (t) => n.current.onSaveState?.(t),
-      onLockState: (t) => n.current.onLockState?.(t),
-      onChange: () => n.current.onChange?.(),
+      onSave: e.onSave ? (t, d) => a.current.onSave(t, d) : void 0,
+      onError: (t) => a.current.onError?.(t),
+      onSaveState: (t) => a.current.onSaveState?.(t),
+      onLockState: (t) => a.current.onLockState?.(t),
+      onChange: () => a.current.onChange?.(),
       feedback: typeof e.feedback == "object" ? {
         ...e.feedback,
         onSubmit: e.feedback.onSubmit ? (t) => {
-          const d = n.current.feedback;
+          const d = a.current.feedback;
           if (typeof d != "object" || !d.onSubmit) throw new Error("Feedback submission handler is no longer configured");
           return d.onSubmit(t);
         } : void 0
@@ -27,28 +28,29 @@ const s = v(function({ src: u, className: b, style: S, onReady: g, ...e }, f) {
     return c.current = r, m(r), g?.(r), () => {
       r.destroy(), c.current = null, m(null);
     };
-  }, [e.draftKey, e.chrome, !!e.onSave]), a(() => {
-    u && c.current && c.current.load(u).catch((r) => n.current.onError?.(r));
-  }, [u, e.draftKey, e.chrome, !!e.onSave]), a(() => {
+  }, [e.draftKey, e.chrome, !!e.onSave]), n(() => {
+    u && c.current && c.current.load(u).catch((r) => a.current.onError?.(r));
+  }, [u, e.draftKey, e.chrome, !!e.onSave]), n(() => {
     e.theme && c.current?.setTheme(e.theme);
-  }, [e.theme]), a(() => {
+  }, [e.theme]), n(() => {
     c.current?.setReadOnly(e.readOnly ?? !1);
-  }, [e.readOnly]), a(() => {
+  }, [e.readOnly]), n(() => {
     e.zoom !== void 0 && c.current?.setZoom(e.zoom);
-  }, [e.zoom]), a(() => {
+  }, [e.zoom]), n(() => {
     e.badges !== void 0 && c.current?.variables.setDisplay(e.badges);
-  }, [typeof e.badges == "boolean" ? e.badges : e.badges?.variables, typeof e.badges == "boolean" ? e.badges : e.badges?.expressions]), /* @__PURE__ */ h("div", { ref: l, className: b, style: { height: "100%", minHeight: 320, minWidth: 0, ...S } });
+  }, [typeof e.badges == "boolean" ? e.badges : e.badges?.variables, typeof e.badges == "boolean" ? e.badges : e.badges?.expressions]), /* @__PURE__ */ h("div", { ref: l, className: b, style: { height: "100%", minHeight: 320, minWidth: 0, ...i } });
 });
-function D() {
-  return o(null);
+function x() {
+  return f(null);
 }
 const O = v(function(u, b) {
   return /* @__PURE__ */ h(s, { ...u, ref: b, chrome: "viewer", readOnly: !0 });
 }), w = 1;
 export {
+  I as DOCX_EDITOR_VERSION,
   w as DOCX_LOCKING_VERSION,
   s as DocxEditor,
   O as DocxViewer,
-  D as useDocxEditor
+  x as useDocxEditor
 };
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sources":["../src/react.tsx"],"sourcesContent":["/**\n * The React face of the SDK.\n *\n *   <DocxEditor src={file} onSave={(bytes) => upload(bytes)} style={{ height: '100vh' }} />\n *\n * The component owns one `createDocxEditor` for its lifetime; `src` changes\n * reload the document in place, every other option is read at mount. React is\n * an optional peer: nothing here runs unless `myrole-docx-editor/react` is\n * imported.\n */\nimport { useEffect, useRef, forwardRef, type CSSProperties } from 'react'\nimport { createDocxEditor, type DocxEditorHandle, type DocxEditorOptions } from './sdk'\n\nexport interface DocxEditorProps extends Omit<DocxEditorOptions, 'onReady'> {\n  /** the document: bytes, a Blob/File, or a URL */\n  src?: ArrayBuffer | Uint8Array | Blob | string\n  className?: string\n  style?: CSSProperties\n  /** the handle, once mounted */\n  onReady?: (editor: DocxEditorHandle) => void\n}\n\nexport const DocxEditor = forwardRef<DocxEditorHandle | null, DocxEditorProps>(function DocxEditor(\n  { src, className, style, onReady, ...options }, ref,\n) {\n  const host = useRef<HTMLDivElement>(null)\n  const handle = useRef<DocxEditorHandle | null>(null)\n  // The latest callbacks, without remounting the editor when they change.\n  const latest = useRef(options)\n  latest.current = options\n\n  // The forwarded ref is filled HERE, not by useImperativeHandle: that one\n  // runs in the layout phase, before this effect has created anything, and\n  // would hand the parent a null for the component's whole life.\n  const give = (h: DocxEditorHandle | null) => {\n    if (typeof ref === 'function') ref(h)\n    else if (ref) ref.current = h\n  }\n\n  useEffect(() => {\n    const h = createDocxEditor(host.current!, {\n      ...options,\n      onSave: options.onSave ? (b, context) => latest.current.onSave!(b, context) : undefined,\n      onError: e => latest.current.onError?.(e),\n      onSaveState: state => latest.current.onSaveState?.(state),\n      onLockState: state => latest.current.onLockState?.(state),\n      onChange: () => latest.current.onChange?.(),\n      feedback: typeof options.feedback === 'object' ? {\n        ...options.feedback,\n        onSubmit: options.feedback.onSubmit ? report => {\n          const feedback = latest.current.feedback\n          if (typeof feedback !== 'object' || !feedback.onSubmit) throw new Error('Feedback submission handler is no longer configured')\n          return feedback.onSubmit(report)\n        } : undefined,\n      } : options.feedback,\n    })\n    handle.current = h\n    give(h)\n    onReady?.(h)\n    return () => { h.destroy(); handle.current = null; give(null) }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [options.draftKey, options.chrome, !!options.onSave])\n\n  useEffect(() => {\n    if (src && handle.current) void handle.current.load(src).catch(e => latest.current.onError?.(e))\n  }, [src, options.draftKey, options.chrome, !!options.onSave])\n  useEffect(() => { if (options.theme) handle.current?.setTheme(options.theme) }, [options.theme])\n  useEffect(() => { handle.current?.setReadOnly(options.readOnly ?? false) }, [options.readOnly])\n  useEffect(() => { if (options.zoom !== undefined) handle.current?.setZoom(options.zoom) }, [options.zoom])\n  useEffect(() => { if (options.badges !== undefined) handle.current?.variables.setDisplay(options.badges) }, [typeof options.badges === 'boolean' ? options.badges : options.badges?.variables, typeof options.badges === 'boolean' ? options.badges : options.badges?.expressions])\n\n  return <div ref={host} className={className} style={{ height: '100%', minHeight: 320, minWidth: 0, ...style }} />\n})\n\n/** A ref to hand to `<DocxEditor ref={…}>`, and the handle once it exists. */\nexport function useDocxEditor() {\n  return useRef<DocxEditorHandle | null>(null)\n}\n\nexport type { DocxEditorHandle, DocxEditorOptions } from './sdk'\n\n/** Read-only companion, with the same rendering and lifecycle as the editor. */\nexport const DocxViewer = forwardRef<DocxEditorHandle | null, DocxEditorProps>(function DocxViewer(props, ref) {\n  return <DocxEditor {...props} ref={ref} chrome=\"viewer\" readOnly />\n})\n\nexport const DOCX_LOCKING_VERSION = 1\n"],"names":["DocxEditor","forwardRef","src","className","style","onReady","options","ref","host","useRef","handle","latest","give","h","useEffect","createDocxEditor","b","context","e","state","report","feedback","jsx","useDocxEditor","DocxViewer","props","DOCX_LOCKING_VERSION"],"mappings":"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"}
+{"version":3,"file":"react.js","sources":["../src/react.tsx"],"sourcesContent":["/**\n * The React face of the SDK.\n *\n *   <DocxEditor src={file} onSave={(bytes) => upload(bytes)} style={{ height: '100vh' }} />\n *\n * The component owns one `createDocxEditor` for its lifetime; `src` changes\n * reload the document in place, every other option is read at mount. React is\n * an optional peer: nothing here runs unless `myrole-docx-editor/react` is\n * imported.\n */\nimport { useEffect, useRef, forwardRef, type CSSProperties } from 'react'\nimport { createDocxEditor, type DocxEditorHandle, type DocxEditorOptions } from './sdk'\n\nexport interface DocxEditorProps extends Omit<DocxEditorOptions, 'onReady'> {\n  /** the document: bytes, a Blob/File, or a URL */\n  src?: ArrayBuffer | Uint8Array | Blob | string\n  className?: string\n  style?: CSSProperties\n  /** the handle, once mounted */\n  onReady?: (editor: DocxEditorHandle) => void\n}\n\nexport const DocxEditor = forwardRef<DocxEditorHandle | null, DocxEditorProps>(function DocxEditor(\n  { src, className, style, onReady, ...options }, ref,\n) {\n  const host = useRef<HTMLDivElement>(null)\n  const handle = useRef<DocxEditorHandle | null>(null)\n  // The latest callbacks, without remounting the editor when they change.\n  const latest = useRef(options)\n  latest.current = options\n\n  // The forwarded ref is filled HERE, not by useImperativeHandle: that one\n  // runs in the layout phase, before this effect has created anything, and\n  // would hand the parent a null for the component's whole life.\n  const give = (h: DocxEditorHandle | null) => {\n    if (typeof ref === 'function') ref(h)\n    else if (ref) ref.current = h\n  }\n\n  useEffect(() => {\n    const h = createDocxEditor(host.current!, {\n      ...options,\n      onSave: options.onSave ? (b, context) => latest.current.onSave!(b, context) : undefined,\n      onError: e => latest.current.onError?.(e),\n      onSaveState: state => latest.current.onSaveState?.(state),\n      onLockState: state => latest.current.onLockState?.(state),\n      onChange: () => latest.current.onChange?.(),\n      feedback: typeof options.feedback === 'object' ? {\n        ...options.feedback,\n        onSubmit: options.feedback.onSubmit ? report => {\n          const feedback = latest.current.feedback\n          if (typeof feedback !== 'object' || !feedback.onSubmit) throw new Error('Feedback submission handler is no longer configured')\n          return feedback.onSubmit(report)\n        } : undefined,\n      } : options.feedback,\n    })\n    handle.current = h\n    give(h)\n    onReady?.(h)\n    return () => { h.destroy(); handle.current = null; give(null) }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [options.draftKey, options.chrome, !!options.onSave])\n\n  useEffect(() => {\n    if (src && handle.current) void handle.current.load(src).catch(e => latest.current.onError?.(e))\n  }, [src, options.draftKey, options.chrome, !!options.onSave])\n  useEffect(() => { if (options.theme) handle.current?.setTheme(options.theme) }, [options.theme])\n  useEffect(() => { handle.current?.setReadOnly(options.readOnly ?? false) }, [options.readOnly])\n  useEffect(() => { if (options.zoom !== undefined) handle.current?.setZoom(options.zoom) }, [options.zoom])\n  useEffect(() => { if (options.badges !== undefined) handle.current?.variables.setDisplay(options.badges) }, [typeof options.badges === 'boolean' ? options.badges : options.badges?.variables, typeof options.badges === 'boolean' ? options.badges : options.badges?.expressions])\n\n  return <div ref={host} className={className} style={{ height: '100%', minHeight: 320, minWidth: 0, ...style }} />\n})\n\n/** A ref to hand to `<DocxEditor ref={…}>`, and the handle once it exists. */\nexport function useDocxEditor() {\n  return useRef<DocxEditorHandle | null>(null)\n}\n\nexport type { DocxEditorHandle, DocxEditorOptions } from './sdk'\nexport { DOCX_EDITOR_VERSION } from './sdk'\n\n/** Read-only companion, with the same rendering and lifecycle as the editor. */\nexport const DocxViewer = forwardRef<DocxEditorHandle | null, DocxEditorProps>(function DocxViewer(props, ref) {\n  return <DocxEditor {...props} ref={ref} chrome=\"viewer\" readOnly />\n})\n\nexport const DOCX_LOCKING_VERSION = 1\n"],"names":["DocxEditor","forwardRef","src","className","style","onReady","options","ref","host","useRef","handle","latest","give","h","useEffect","createDocxEditor","b","context","e","state","report","feedback","jsx","useDocxEditor","DocxViewer","props","DOCX_LOCKING_VERSION"],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+/**
+ * The assistant's tools as an MCP client sees them: names, descriptions, input
+ * schemas. Data only — `scripts/assistant-mcp.ts` bundles this file into the
+ * relay, and the relay must not carry the editor. `assistant.ts` runs them.
+ *
+ * Every description has to stand on its own: some MCP clients never show the
+ * server's `instructions`, all of them show these.
+ */
+export interface AssistantTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    /** reads only: no undo step, no fake-cursor walk */
+    readOnly: boolean;
+}
+export declare const ASSISTANT_TOOLS: AssistantTool[];

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

@@ -0,0 +1,24 @@
+import { type DocxEditorHandle } from './sdk';
+import { type LibraryExtras } from './vars-library';
+/**
+ * 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 and the tab, and `assistant-tools.ts`
+ * describes them. 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 paragraphs,
+ * addressed by index.
+ *
+ * Every writing call runs in `Editor.batch`: one Ctrl/Cmd+Z takes it back, and
+ * a call that fails halfway leaves nothing behind.
+ */
+export interface AssistantOptions {
+    /** the relay started by `scripts/assistant-mcp.ts` */
+    url?: string;
+}
+type Args = Record<string, unknown>;
+export declare function runTool(handle: DocxEditorHandle, name: string, args: Args, library?: () => LibraryExtras): unknown;
+/** The « Assistant » button of the status bar, and the connection it opens. */
+export declare function mountAssistant(status: HTMLElement, handle: DocxEditorHandle, options?: AssistantOptions, library?: () => LibraryExtras): () => void;
+export {};

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

@@ -194,6 +194,16 @@ export declare function createEditor(setup: EditorSetup): {
     replaceAll(query: string, replacement: string, matchCase?: boolean): number;
     /** Insère du texte au curseur, ou remplace la sélection. */
     insert: (text: string, patch?: RunPatch) => void;
+    /**
+     * Pastes HTML after the caret's paragraph, as one undo step, through the
+     * clipboard's own path: whatever `htmlToBlocks` cannot express is dropped.
+     */
+    pasteHtml(html: string): boolean;
+    /**
+     * Inserts raw `w:p` / `w:tbl` XML after a body paragraph, as one undo step,
+     * and returns how many paragraphs it added. Throws why the XML was refused.
+     */
+    insertOoxml(para: number, xml: string): number;
     deleteSelection: () => void;
     deleteObject: () => void;
     splitAtCaret: () => void;
@@ -213,6 +223,10 @@ export declare function createEditor(setup: EditorSetup): {
     currentSection: () => number;
     /** Section à laquelle appartient une page dessinée — ce que la règle suit. */
     sectionOfPage(page: number): number;
+    batch: <T>(fn: () => T) => {
+        value: T;
+        changed: boolean;
+    };
     undo: () => void;
     redo: () => void;
     canUndo: () => boolean;

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

@@ -7,9 +7,10 @@
  *
  * React: `import { DocxEditor } from 'myrole-docx-editor/react'`.
  */
-export { createDocxEditor } from './sdk';
+export { createDocxEditor, DOCX_EDITOR_VERSION } 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/react.d.ts

@@ -22,6 +22,7 @@ export declare const DocxEditor: import("react").ForwardRefExoticComponent<DocxE
 /** A ref to hand to `<DocxEditor ref={…}>`, and the handle once it exists. */
 export declare function useDocxEditor(): import("react").RefObject<DocxEditorHandle | null>;
 export type { DocxEditorHandle, DocxEditorOptions } from './sdk';
+export { DOCX_EDITOR_VERSION } from './sdk';
 /** Read-only companion, with the same rendering and lifecycle as the editor. */
 export declare const DocxViewer: import("react").ForwardRefExoticComponent<DocxEditorProps & import("react").RefAttributes<DocxEditorHandle | null>>;
 export declare const DOCX_LOCKING_VERSION = 1;

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

@@ -21,6 +21,9 @@ 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';
+/** The published version of this package, as the status bar shows it. */
+export declare const DOCX_EDITOR_VERSION: string;
 export type ChromeMode = 'full' | 'viewer' | 'none';
 export type Theme = 'light' | 'dark' | 'system';
 export type { DocxEditorUiOptions } from './ui/shell';
@@ -70,6 +73,8 @@ export interface DocxEditorOptions {
     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-model/src/index.d.ts

@@ -17,6 +17,8 @@ export interface DocxDocument {
     /** ordre original des entrées du zip, pour rebuild déterministe */
     order: string[];
 }
+/** Parses XML into the same ordered tree as a package part. */
+export declare const parseXml: (xml: string) => XmlTree;
 export declare function readDocx(buf: Uint8Array): DocxDocument;
 export declare function writeDocx(doc: DocxDocument): Uint8Array;
 /** Nom de balise d'un noeud ordonné (les clés `:@` / `#text` sont des métadonnées). */

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

@@ -1,4 +1,4 @@
-import { type DocxDocument } from './index';
+import { type DocxDocument, type XmlNode } from './index';
 import { type DocPos } from './editor';
 import { type PastedRun } from './insert';
 /**
@@ -55,3 +55,14 @@ export declare function ensureListNum(doc: DocxDocument, ordered: boolean): numb
  * paragraphe comme un autre dans l'adressage du modèle.
  */
 export declare function pasteBlocks(doc: DocxDocument, at: DocPos, blocks: PastedBlock[]): DocPos | null;
+/**
+ * Parses, checks and orders `w:p` / `w:tbl` blocks written as XML text, for
+ * `insertBlocksAfter`. Throws with the reason, phrased for the writer to fix it.
+ */
+export declare function ooxmlBlocks(doc: DocxDocument, xml: string): XmlNode[];
+/**
+ * Inserts blocks after a body paragraph — in its cell when it has one — and
+ * returns how many paragraphs that adds. A table never ends a cell or the body:
+ * Word wants a paragraph after it.
+ */
+export declare function insertBlocksAfter(doc: DocxDocument, para: number, blocks: XmlNode[]): number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrole-docx-editor",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Word-faithful .docx editor and renderer on canvas — the MyRole engine as an embeddable SDK, with a React component.",
   "license": "UNLICENSED",
   "type": "module",
@@ -45,9 +45,9 @@
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "vite": "^6.4.3",
-    "@myrole/docx-model": "0.0.0",
     "@myrole/docx-render": "0.0.0",
     "@myrole/docx-tags": "0.0.0",
+    "@myrole/docx-model": "0.0.0",
     "@myrole/docx-vars": "0.0.0",
     "@myrole/fonts": "0.1.0"
   },
@@ -56,11 +56,15 @@
   },
   "scripts": {
     "fonts": "node scripts/pack-fonts.mjs",
-    "build": "node scripts/pack-fonts.mjs && vite build && node scripts/types.mjs",
+    "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",
+    "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": [