myrole-docx-editor 0.1.2 → 0.1.3

package/dist/chunks/{vars-blockly-C-0oL-Mc.js → vars-blockly-DMblR7c7.js}

@@ -1,5 +1,5 @@
 import * as s from "blockly";
-import { j as p, T as u, k as m, m as f, n as g, o as h } from "./sdk-CxT1eC2o.js";
+import { k as p, T as u, m, n as f, o as g, q as h } from "./sdk-BKmEus_j.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-C-0oL-Mc.js.map
+//# sourceMappingURL=vars-blockly-DMblR7c7.js.map

package/dist/chunks/{vars-blockly-C-0oL-Mc.js.map → vars-blockly-DMblR7c7.js.map}

@@ -1 +1 @@
-{"version":3,"file":"vars-blockly-C-0oL-Mc.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-DMblR7c7.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,13 +1,13 @@
-import { i as f, r as m, e as p, f as w, p as u, l as y, a as g, b as h, c as x } from "./chunks/sdk-CxT1eC2o.js";
-import { d as b, g as D, h as U, s as A } from "./chunks/sdk-CxT1eC2o.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-BKmEus_j.js";
+import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-BKmEus_j.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),
     f(r.fontsUrl)
   ]), t = m(new Uint8Array(c));
-  for (const e of p(t))
+  for (const e of w(t))
     try {
-      const s = w(e), n = new FontFace(s.family, e.data, { weight: s.weight, style: s.style });
+      const s = p(e), n = new FontFace(s.family, e.data, { weight: s.weight, style: s.style });
       await n.load(), document.fonts.add(n);
     } catch {
     }
@@ -22,9 +22,10 @@ async function P(a, o, r = {}) {
   }), { pages: [...o.querySelectorAll("canvas")], ms: Math.round(performance.now() - i) };
 }
 export {
-  b as createDocxEditor,
-  D as defaultFontsUrl,
-  U as evaluateTags,
+  R as createDocxEditor,
+  b as createDocxViewer,
+  U as defaultFontsUrl,
+  j as evaluateTags,
   f as installFonts,
   P as renderDocx,
   A as sampleValues

package/dist/react.js

@@ -1,36 +1,52 @@
-import { jsx as v } from "react/jsx-runtime";
-import { forwardRef as x, useRef as n, useEffect as d } from "react";
-import { d as g } from "./chunks/sdk-CxT1eC2o.js";
-const C = x(function({ src: r, className: s, style: a, onReady: h, ...u }, e) {
-  const i = n(null), o = n(null), c = n(u);
-  c.current = u;
-  const f = (t) => {
-    typeof e == "function" ? e(t) : e && (e.current = t);
+import { jsx as h } from "react/jsx-runtime";
+import { forwardRef as v, useRef as f, useEffect as n } from "react";
+import { d as S } from "./chunks/sdk-BKmEus_j.js";
+const s = v(function({ src: u, className: o, style: g, onReady: y, ...e }, d) {
+  const l = f(null), c = f(null), t = f(e);
+  t.current = e;
+  const m = (r) => {
+    typeof d == "function" ? d(r) : d && (d.current = r);
   };
-  d(() => {
-    const t = g(i.current, {
-      ...u,
-      onSave: (m) => c.current.onSave?.(m),
-      onChange: () => c.current.onChange?.()
+  return n(() => {
+    const r = S(l.current, {
+      ...e,
+      onSave: e.onSave ? (a) => t.current.onSave(a) : void 0,
+      onError: (a) => t.current.onError?.(a),
+      onSaveState: (a) => t.current.onSaveState?.(a),
+      onChange: () => t.current.onChange?.(),
+      feedback: typeof e.feedback == "object" ? {
+        ...e.feedback,
+        onSubmit: e.feedback.onSubmit ? (a) => {
+          const b = t.current.feedback;
+          if (typeof b != "object" || !b.onSubmit) throw new Error("Feedback submission handler is no longer configured");
+          return b.onSubmit(a);
+        } : void 0
+      } : e.feedback
     });
-    return o.current = t, f(t), h?.(t), r && t.load(r), () => {
-      t.destroy(), o.current = null, f(null);
+    return c.current = r, m(r), y?.(r), () => {
+      r.destroy(), c.current = null, m(null);
     };
-  }, []);
-  const l = n(!0);
-  return d(() => {
-    if (l.current) {
-      l.current = !1;
-      return;
-    }
-    r && o.current && o.current.load(r);
-  }, [r]), /* @__PURE__ */ v("div", { ref: i, className: s, style: { height: "100%", minHeight: 480, ...a } });
+  }, [e.draftKey, e.chrome, !!e.onSave]), n(() => {
+    u && c.current && c.current.load(u).catch((r) => t.current.onError?.(r));
+  }, [u, e.draftKey, e.chrome, !!e.onSave]), n(() => {
+    e.theme && c.current?.setTheme(e.theme);
+  }, [e.theme]), n(() => {
+    c.current?.setReadOnly(e.readOnly ?? !1);
+  }, [e.readOnly]), n(() => {
+    e.zoom !== void 0 && c.current?.setZoom(e.zoom);
+  }, [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: o, style: { height: "100%", minHeight: 320, minWidth: 0, ...g } });
 });
-function R() {
-  return n(null);
+function D() {
+  return f(null);
 }
+const w = v(function(u, o) {
+  return /* @__PURE__ */ h(s, { ...u, ref: o, chrome: "viewer", readOnly: !0 });
+});
 export {
-  C as DocxEditor,
-  R as useDocxEditor
+  s as DocxEditor,
+  w as DocxViewer,
+  D 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: (b) => latest.current.onSave?.(b),\n      onChange: () => latest.current.onChange?.(),\n    })\n    handle.current = h\n    give(h)\n    onReady?.(h)\n    if (src) void h.load(src)\n    return () => { h.destroy(); handle.current = null; give(null) }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [])\n\n  const first = useRef(true)\n  useEffect(() => {\n    if (first.current) { first.current = false; return }\n    if (src && handle.current) void handle.current.load(src)\n  }, [src])\n\n  return <div ref={host} className={className} style={{ height: '100%', minHeight: 480, ...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"],"names":["DocxEditor","forwardRef","src","className","style","onReady","options","ref","host","useRef","handle","latest","give","h","useEffect","createDocxEditor","b","first","jsx","useDocxEditor"],"mappings":";;;AAsBO,MAAMA,IAAaC,EAAqD,SAC7E,EAAE,KAAAC,GAAK,WAAAC,GAAW,OAAAC,GAAO,SAAAC,GAAS,GAAGC,EAAA,GAAWC,GAChD;AACA,QAAMC,IAAOC,EAAuB,IAAI,GAClCC,IAASD,EAAgC,IAAI,GAE7CE,IAASF,EAAOH,CAAO;AAC7B,EAAAK,EAAO,UAAUL;AAKjB,QAAMM,IAAO,CAACC,MAA+B;AAC3C,IAAI,OAAON,KAAQ,aAAYA,EAAIM,CAAC,IAC3BN,QAAS,UAAUM;AAAA,EAC9B;AAEA,EAAAC,EAAU,MAAM;AACd,UAAMD,IAAIE,EAAiBP,EAAK,SAAU;AAAA,MACxC,GAAGF;AAAA,MACH,QAAQ,CAACU,MAAML,EAAO,QAAQ,SAASK,CAAC;AAAA,MACxC,UAAU,MAAML,EAAO,QAAQ,WAAA;AAAA,IAAW,CAC3C;AACD,WAAAD,EAAO,UAAUG,GACjBD,EAAKC,CAAC,GACNR,IAAUQ,CAAC,GACPX,KAAUW,EAAE,KAAKX,CAAG,GACjB,MAAM;AAAE,MAAAW,EAAE,QAAA,GAAWH,EAAO,UAAU,MAAME,EAAK,IAAI;AAAA,IAAE;AAAA,EAEhE,GAAG,CAAA,CAAE;AAEL,QAAMK,IAAQR,EAAO,EAAI;AACzB,SAAAK,EAAU,MAAM;AACd,QAAIG,EAAM,SAAS;AAAE,MAAAA,EAAM,UAAU;AAAO;AAAA,IAAO;AACnD,IAAIf,KAAOQ,EAAO,WAAcA,EAAO,QAAQ,KAAKR,CAAG;AAAA,EACzD,GAAG,CAACA,CAAG,CAAC,GAED,gBAAAgB,EAAC,OAAA,EAAI,KAAKV,GAAM,WAAAL,GAAsB,OAAO,EAAE,QAAQ,QAAQ,WAAW,KAAK,GAAGC,IAAM,CAAG;AACpG,CAAC;AAGM,SAASe,IAAgB;AAC9B,SAAOV,EAAgC,IAAI;AAC7C;"}
+{"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) => latest.current.onSave!(b) : undefined,\n      onError: e => latest.current.onError?.(e),\n      onSaveState: state => latest.current.onSaveState?.(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"],"names":["DocxEditor","forwardRef","src","className","style","onReady","options","ref","host","useRef","handle","latest","give","h","useEffect","createDocxEditor","b","e","state","report","feedback","jsx","useDocxEditor","DocxViewer","props"],"mappings":"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"}

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

@@ -1,8 +1,19 @@
 import type { EditContext } from '../../docx-model/src/index';
 import type { Editor } from './editor';
 import type { Shell } from './ui/shell';
+import type { Panel } from './ui/shell';
+import type { BadgeDisplay } from './variables';
 export interface ChromeHost {
     shell: Shell;
+    showPanel(p: Panel | null): void;
+    refreshInspector(): void;
+    find(): void;
+    library(): void;
+    fitZoom(mode: 'width' | 'page'): void;
+    badges: {
+        get(): BadgeDisplay;
+        set(v: Partial<BadgeDisplay>): void;
+    };
     zoom: {
         get(): number;
         set(z: number): void;

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

@@ -13,4 +13,11 @@ 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. */
 export declare function alignIcon(align: string): SVGElement;
-export declare function builtinCommands(): Command[];
+/**
+ * Insere une variable au curseur, choisie dans la bibliotheque du document.
+ *
+ * Les champs viennent de ce que la matrice utilise DEJA — la seule source qui
+ * ne se perime pas, et elle couvre l'immense majorite des besoins : sur le
+ * corpus, presque toutes les variables sont des acces de champ simples.
+ */
+export declare function builtinCommands(openLibrary: () => void): Command[];

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

@@ -0,0 +1,7 @@
+/** Explicitly keyed by the host: never mix documents or silently enable local retention. */
+export interface Draft {
+    bytes: Uint8Array;
+    name: string;
+    updatedAt: number;
+}
+export declare function draftStore(key: string, value?: Draft | null): Promise<Draft | undefined>;

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

@@ -1,4 +1,4 @@
-import { 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 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';
 export interface EditorHooks {
     /** appelé après chaque composition, avec ce qu'il faut pour la barre d'outils */
@@ -48,6 +48,8 @@ export interface EditorSetup {
      * on ne fait pas semblant d'avoir réussi.
      */
     persist?(bytes: Uint8Array): void | Promise<void>;
+    saveDelay?: number;
+    saveLabel?: string;
     hooks?: EditorHooks;
 }
 export declare function createEditor(setup: EditorSetup): {
@@ -159,15 +161,22 @@ export declare function createEditor(setup: EditorSetup): {
     } | null;
     /** Pose la sélection. Une seule adresse donne un simple curseur. */
     selectRange(anchor: DocPos, focus?: DocPos): void;
+    /** Right-click targets the item under the pointer without discarding a containing selection. */
+    selectAtPoint(clientX: number, clientY: number): boolean;
     selectAll: () => void;
     /** Bornes du paragraphe entier, telles que la mise en page les a dessinées. */
     paragraphRange: (para: number) => {
         from: number;
         to: number;
     } | null;
+    setList(ordered: boolean | null): void;
+    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;
     deleteSelection: () => void;
+    deleteObject: () => void;
     splitAtCaret: () => void;
     format: (patch: RunPatch) => void;
     formatPara: (patch: ParaPatch) => void;
@@ -191,9 +200,14 @@ export declare function createEditor(setup: EditorSetup): {
     canRedo: () => boolean;
     save: () => Uint8Array<ArrayBufferLike>;
     /** État de l'enregistrement, tel que la barre d'état le montre. */
-    saveState: () => "à jour" | "à enregistrer" | "enregistrement…" | "échec";
+    saveState: () => "à jour" | "à enregistrer" | "enregistrement…" | "échec" | "modifications non enregistrées";
     /** Force l'envoi maintenant, sans attendre l'accalmie. */
     saveNow: () => Promise<void>;
+    isDirty: () => boolean;
+    markSaved: () => void;
+    markDirty: () => void;
+    revealCaret: () => void;
+    root: HTMLElement;
     focus: () => void;
     /** Agrandit l'affichage. Le canvas n'est pas recomposé : c'est du CSS. */
     setZoom(z: number): void;
@@ -248,7 +262,7 @@ export type Editor = ReturnType<typeof createEditor>;
  * déplacement du curseur, `render` après chaque composition, `context` avec
  * l'état complet sous le curseur, `commands` quand le registre bouge.
  */
-export type EditorEvent = 'change' | 'selection' | 'render' | 'context' | 'commands' | 'load' | 'save';
+export type EditorEvent = 'change' | 'selection' | 'render' | 'context' | 'commands' | 'load' | 'save' | 'command';
 /**
  * Une commande ajoutée par l'hôte ou par une extension.
  *

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

@@ -0,0 +1,73 @@
+import type { DocPos } from '../../docx-model/src/index';
+import type { Editor } from './editor';
+export interface FeedbackContext {
+    sdkVersion: string;
+    browser: string;
+    language: string;
+    devicePixelRatio: number;
+    viewport: {
+        width: number;
+        height: number;
+        scrollTop: number;
+        scrollLeft: number;
+    };
+    visiblePages: number[];
+    pageCount: number;
+    zoom: number;
+    mode: 'edit' | 'preview' | 'readOnly';
+    chrome: string;
+    theme: string;
+    panel: string | null;
+    badges: {
+        variables: boolean;
+        expressions: boolean;
+    };
+    dirty: boolean;
+    selection: {
+        anchor: DocPos;
+        focus: DocPos;
+    } | null;
+    object: ReturnType<Editor['selectedObject']>;
+    font: {
+        family?: string;
+        sizePt?: number;
+    };
+    recentEvents: Array<{
+        at: string;
+        type: string;
+        detail?: string;
+    }>;
+}
+export interface FeedbackReport {
+    schemaVersion: 1;
+    id: string;
+    createdAt: string;
+    fileName: string;
+    wanted: string;
+    missing: string;
+    workaround: string;
+    context: FeedbackContext;
+    screenshot?: {
+        dataUrl: string;
+        width: number;
+        height: number;
+    };
+    captureError?: string;
+}
+export interface FeedbackOptions {
+    /** Resolution acknowledges receipt; rejection keeps the form available for retry. */
+    onSubmit?: (report: FeedbackReport) => void | Promise<void>;
+}
+type EditorContext = Pick<FeedbackContext, 'pageCount' | 'zoom' | 'mode' | 'chrome' | 'theme' | 'panel' | 'badges' | 'dirty' | 'selection' | 'object' | 'font'>;
+/** One feedback tool per SDK instance; never reads document bytes or global console logs. */
+export declare function mountFeedback(root: HTMLElement, main: HTMLElement, pages: HTMLElement, context: () => {
+    fileName: string;
+    context: EditorContext;
+}, options: FeedbackOptions): {
+    open: () => void;
+    loaded(): void;
+    record(type: string, detail?: string): void;
+    reset(): void;
+    destroy(): void;
+};
+export {};

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

@@ -9,6 +9,7 @@
  */
 export { createDocxEditor } from './sdk';
 export type { DocxEditorHandle, DocxEditorOptions, DocxEditorEvent, ChromeMode, Theme } from './sdk';
+export type { FeedbackReport, FeedbackContext, FeedbackOptions } from './feedback';
 export { renderDocx } from './embed';
 export type { Rendered } from './embed';
 export { installFonts, defaultFontsUrl } from './fonts';
@@ -18,3 +19,7 @@ export type { DocxDocument, DocPos, EditContext, RunPatch, ParaPatch, MarginPatc
 export { sampleValues, evaluateTags } from '../../docx-vars/src/index';
 export type { LibraryExtras, LibraryField, LibrarySnippet } from './vars-library';
 export type { Comment, CommentRange } from './comments';
+export type { BadgeDisplay } from './variables';
+export type { Draft } from './drafts';
+export type { Panel } from './ui/shell';
+export { createDocxViewer } from './sdk';

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

@@ -2,5 +2,5 @@
  * UI de l'inspecteur — panneau latéral avec onglets.
  */
 import type { InspectorData } from './inspector';
-export declare function renderInspector(data: InspectorData): void;
-export declare function setupInspectorControls(): void;
+export declare function renderInspector(data: InspectorData, root: HTMLElement): void;
+export declare function setupInspectorControls(root: HTMLElement, refresh: () => void): void;

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

@@ -22,3 +22,5 @@ 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';
+/** 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>>;

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

@@ -1,4 +1,5 @@
 import type { Editor } from './editor';
 export declare function mountRuler(hostH: HTMLElement, hostV: HTMLElement, pages: HTMLElement, scroller: HTMLElement, editor: Editor): {
     draw: () => void;
+    destroy: () => void;
 };

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

@@ -9,21 +9,24 @@
  * the variables layer), the editor, the chrome — behind one handle, so the
  * host page owns nothing but a `<div>`.
  *
- * One editor per page. The inspector, the variables panel and the bench read
- * a few elements by id (`#info`, `#pages`, `#inspector`…); two editors on one
- * page would share them. ponytail: scope the ids to the root the day a page
- * needs two editors.
+ * Instances own their UI, persistence and lifecycle. The host owns the surrounding app.
  */
 import { type DocxDocument } from '../../docx-model/src/index';
 import type { Tag } from '../../docx-tags/src/index';
 import { type Editor } from './editor';
+import { type BadgeDisplay } from './variables';
 import { type LibraryExtras } from './vars-library';
 import { type CommentRange } from './comments';
+import { type Panel } from './ui/shell';
+import { type Draft } from './drafts';
+import { type FeedbackOptions } from './feedback';
 export type ChromeMode = 'full' | 'viewer' | 'none';
 export type Theme = 'light' | 'dark' | 'system';
-export type DocxEditorEvent = 'load' | 'change' | 'selection' | 'render' | 'save' | 'context' | 'zoom';
+export type DocxEditorEvent = 'load' | 'change' | 'selection' | 'render' | 'save' | 'context' | 'zoom' | 'saveState' | 'error' | 'command';
 export interface DocxEditorOptions {
     /** `full`: ribbon, rulers, panels. `viewer`: read-only pages under a slim header. `none`: pages only. */
+    /** Development host compatibility only; npm instances expose no window globals or IDs. */
+    debug?: boolean;
     chrome?: ChromeMode;
     readOnly?: boolean;
     theme?: Theme;
@@ -34,6 +37,15 @@ export interface DocxEditorOptions {
     /** the document after a quiet period, and on tab change — where autosave goes */
     onSave?: (bytes: Uint8Array) => void | Promise<void>;
     onChange?: () => void;
+    onError?: (error: Error) => void;
+    onSaveState?: (state: string) => void;
+    /** Text after onSave resolves, e.g. "enregistré sur le serveur". */
+    savedLabel?: string;
+    /** Local draft retention is opt-in; use a stable, unique key per document/user. */
+    draftKey?: string;
+    saveDelay?: number;
+    /** false shows the original variable/JSONata text without badges. */
+    badges?: boolean | Partial<BadgeDisplay>;
     onReady?: (handle: DocxEditorHandle) => void;
     zoom?: number;
     rulers?: boolean;
@@ -42,16 +54,27 @@ export interface DocxEditorOptions {
     /** preview values; when absent the preview deduces a sample set from the tags */
     values?: Record<string, unknown>;
     /** open the editor on the last-used side panel */
-    panel?: 'variables' | 'inspector' | null;
+    panel?: Panel | null;
     /** the fields and snippets the application offers, beyond what the document already uses */
     library?: LibraryExtras;
     /** 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;
 }
 export interface DocxEditorHandle {
-    load(src: ArrayBuffer | Uint8Array | Blob | string): Promise<void>;
+    load(src: ArrayBuffer | Uint8Array | Blob | string, options?: {
+        discardChanges?: boolean;
+    }): Promise<void>;
     /** the document as .docx bytes, now */
     save(): Uint8Array;
+    /** Wait for the host to acknowledge every outstanding modification. */
+    saveNow(): Promise<void>;
+    isDirty(): boolean;
+    saveState(): string;
+    getDraft(): Promise<Draft | undefined>;
+    restoreDraft(): Promise<boolean>;
+    discardDraft(): Promise<void>;
     /** triggers the browser download */
     download(name?: string): void;
     /** the low-level editor: commands, selection, formatting — `null` before the first load */
@@ -61,10 +84,13 @@ export interface DocxEditorHandle {
     pages(): number;
     fileName(name?: string): string;
     setZoom(z: number): void;
+    fitZoom(mode: 'width' | 'page'): void;
     getZoom(): number;
     setTheme(t: Theme): void;
     setReadOnly(on: boolean): void;
-    showPanel(p: 'variables' | 'inspector' | null): void;
+    showPanel(p: Panel | null): void;
+    /** Open the feedback form; requires feedback to be enabled and a loaded document. */
+    openFeedback(): void;
     /** Word's comments of the open document, with their ranges */
     comments(): CommentRange[];
     showComments(on: boolean): void;
@@ -73,6 +99,8 @@ export interface DocxEditorHandle {
         /** show the GENERATED document: values interpolated, false sections hidden */
         preview(on: boolean, values?: Record<string, unknown>): Promise<void>;
         previewOn(): boolean;
+        setDisplay(value: boolean | Partial<BadgeDisplay>): void;
+        display(): BadgeDisplay;
     };
     on(ev: DocxEditorEvent, fn: (payload?: unknown) => void): () => void;
     destroy(): void;
@@ -83,3 +111,4 @@ export declare function paragraphStyles(doc: DocxDocument): {
     name: string;
 }[];
 export declare function createDocxEditor(container: HTMLElement, options?: DocxEditorOptions): DocxEditorHandle;
+export declare function createDocxViewer(container: HTMLElement, options?: DocxEditorOptions): DocxEditorHandle;

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

@@ -0,0 +1,4 @@
+import type { Editor } from '../editor';
+import type { Panel } from './shell';
+/** Context actions share the editor's command registry, selection and undo stack. */
+export declare function mountContextMenu(root: HTMLElement, editor: Editor, showPanel: (panel: Panel) => void): () => void;

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

@@ -0,0 +1,13 @@
+import type { EditContext } from '../../../docx-model/src/index';
+import type { Editor } from '../editor';
+/** Properties use the same mutations and undo stack as the ribbon. */
+export declare function mountProperties(root: HTMLElement, editor: Editor, styles: () => {
+    id: string;
+    name: string;
+}[], close: () => void): {
+    refresh: (ctx: EditContext | null) => void;
+};
+export declare function mountNavigation(root: HTMLElement, editor: Editor, close: () => void): {
+    refresh: () => void;
+    find: (replace?: boolean) => void;
+};

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

@@ -0,0 +1,4 @@
+/** Popovers belong to one editor, including their theme and event lifetime. */
+export declare function showPopover(root: HTMLElement, pop: HTMLElement, anchor?: HTMLElement): () => void;
+/** Keep the document selection on mouse press; native click also supports keyboard/touch. */
+export declare function action(button: HTMLButtonElement, run: () => void): void;

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

@@ -1,12 +1,17 @@
 export type ChromeMode = 'full' | 'viewer' | 'none';
 export type Theme = 'light' | 'dark' | 'system';
-export type Panel = 'variables' | 'inspector';
+export type Panel = 'variables' | 'inspector' | 'properties' | 'navigation';
 export interface ShellHost {
     open(file: File): void;
     save(): void;
+    download(): void;
     zoom(z: number): void;
     panel(p: Panel | null): void;
     rename(name: string): void;
+    raw: {
+        get(): boolean;
+        set(on: boolean): void;
+    };
 }
 export interface ShellOptions {
     mode: ChromeMode;
@@ -14,6 +19,7 @@ export interface ShellOptions {
     rulers: boolean;
     statusBar: boolean;
     fileName: string;
+    debug?: boolean;
     host: ShellHost;
 }
 export interface Shell {
@@ -25,6 +31,8 @@ export interface Shell {
     rulerV: HTMLElement;
     varsEl: HTMLElement;
     inspectorEl: HTMLElement;
+    propertiesEl: HTMLElement;
+    navigationEl: HTMLElement;
     statusEl: HTMLElement;
     /** the composition line the bench reads (« N page(s) ») */
     info: HTMLElement;
@@ -32,6 +40,7 @@ export interface Shell {
     loader: Loader;
     setFileName(name: string): void;
     setSaveState(s: string): void;
+    setRaw(on: boolean): void;
     setPages(n: number): void;
     setWords(n: number): void;
     setPosition(page: number, pages: number, selChars: number): void;

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

@@ -21,7 +21,13 @@ import { type Evaluated } from '../../docx-vars/src/index';
  * chaque caractère qui SUIT dans le paragraphe en dépend, et un curseur posé
  * après un badge écrirait sinon quatorze caractères trop tôt.
  */
+export type BadgeDisplay = {
+    variables: boolean;
+    expressions: boolean;
+};
 export interface VarsHost {
+    root: HTMLElement;
+    readOnly?(): boolean;
     /** Texte de chaque paragraphe, tel que les EXTENSIONS le voient. */
     paras(): string[];
     /** Curseur courant, pour les extensions qui s'y intéressent. */
@@ -60,6 +66,7 @@ export interface Variables {
      * le début ; l'éditeur, non — il ne montrait que les tags.
      */
     setPreview(ev: Evaluated | null): void;
+    setDisplay(display: BadgeDisplay): void;
     /** Pose les badges dans les boîtes que le renderer a publiées. */
     place(layers: HTMLElement[], rects: MarkRect[]): void;
     /** Met en évidence le badge d'un tag — ou aucun. */

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

@@ -1,4 +1,4 @@
-import { type LibEntry } from './vars-library';
+import { type LibEntry, type LibraryExtras } from './vars-library';
 import type { Tag } from '../../docx-tags/src/index';
 /**
  * L'autocomplétion, dans le document.
@@ -19,6 +19,8 @@ import type { Tag } from '../../docx-tags/src/index';
 export interface CompleteHost {
     /** Le champ invisible qui reçoit la frappe — c'est là qu'on capture. */
     input: HTMLElement;
+    root: HTMLElement;
+    library?: LibraryExtras;
     tags(): Tag[];
     /** Texte d'un paragraphe du corps. */
     textOf(para: number): string;
@@ -37,6 +39,7 @@ export interface Completer {
     refresh(): void;
     close(): void;
     open(): boolean;
+    destroy(): void;
 }
 /** Ce qu'on est en train de taper, et ce qu'on a le droit d'y proposer. */
 interface Context {

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

@@ -45,8 +45,8 @@ export interface LibraryExtras {
     /** keep the built-in snippets next to the host's (default true) */
     builtinSnippets?: boolean;
 }
-export declare function configureLibrary(x: LibraryExtras): void;
-export declare function libraryEntries(tags: Tag[]): LibEntry[];
+/** 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é ». */
 export declare const fold: (s: string) => string;
 export declare function filterEntries(all: LibEntry[], kind: string, query: string): LibEntry[];