myrole-docx-editor 0.1.5 → 0.2.0

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

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

@@ -1 +1 @@
-{"version":3,"file":"vars-blockly-CBeNXS0X.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-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;"}

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-BVyUd7P0.js";
-import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-BVyUd7P0.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-BM5tI24s.js";
+import { d as R, g as b, h as U, j, s as A } from "./chunks/sdk-BM5tI24s.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-BVyUd7P0.js";
+import { d as y } from "./chunks/sdk-BM5tI24s.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/authoring-ui.d.ts

@@ -0,0 +1,3 @@
+import type { Editor } from './editor';
+export declare function editLink(editor: Editor): void;
+export declare function editStyle(editor: Editor, update?: boolean): void;

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

@@ -0,0 +1,4 @@
+import type { Comment } from './comments';
+import type { Editor } from './editor';
+/** Comments use the same scoped popover and command path as the ribbon. */
+export declare function editComment(editor: Editor, existing?: Comment, author?: string): void;

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

@@ -1,24 +1,2 @@
-/**
- * Word's comments, and where they sit in the text.
- *
- * `word/comments.xml` holds the comments; the body marks each range with
- * `w:commentRangeStart` / `w:commentRangeEnd` between the runs. The offsets
- * are counted the way `paragraphText` counts — `w:t` text, a tab, a break —
- * so a comment's range is addressable by the editor like any selection.
- */
-import { type DocxDocument } from '../../docx-model/src/index';
-export interface Comment {
-    id: string;
-    author: string;
-    date?: string;
-    text: string;
-}
-export interface CommentRange extends Comment {
-    para: number;
-    from: number;
-    to: number;
-}
-/** The comments, in the order comments.xml declares them. */
-export declare function commentsOf(doc: DocxDocument): Comment[];
-/** Each comment with its range in the body — a comment whose range is not in the flow is left out. */
-export declare function commentRanges(doc: DocxDocument): CommentRange[];
+export { commentsOf, commentRanges } from '../../docx-model/src/index';
+export type { Comment, CommentRange } from '../../docx-model/src/index';

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

@@ -169,6 +169,14 @@ export declare function createEditor(setup: EditorSetup): {
         from: number;
         to: number;
     } | null;
+    addComment(text: string, author?: string): string | null;
+    updateComment: (id: string, text: string) => boolean;
+    deleteComment: (id: string) => boolean;
+    defineStyle(name: string, id?: string): string | null;
+    link: () => string | null;
+    setLink(target: string | null): boolean;
+    setListLevel(level: number): void;
+    restartList(start?: number): boolean;
     setList(ordered: boolean | null): void;
     formatCell(patch: CellPatch): boolean;
     mergeNextCell(): boolean;
@@ -262,7 +270,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' | 'command';
+export type EditorEvent = 'change' | 'selection' | 'render' | 'context' | 'commands' | 'styles' | 'load' | 'save' | 'command';
 /**
  * Une commande ajoutée par l'hôte ou par une extension.
  *

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

@@ -105,6 +105,9 @@ export interface DocxEditorHandle {
     openFeedback(): void;
     /** Word's comments of the open document, with their ranges */
     comments(): CommentRange[];
+    addComment(text: string, author?: string): string | null;
+    updateComment(id: string, text: string): boolean;
+    deleteComment(id: string): boolean;
     showComments(on: boolean): void;
     variables: {
         tags(): Tag[];

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

@@ -0,0 +1,10 @@
+import { type DocxDocument } from './index';
+import { type DocPos } from './editor';
+/** Create a paragraph style from the selection, or update an existing style to match it. */
+export declare function defineParagraphStyle(doc: DocxDocument, at: DocPos, name: string, id?: string): string | null;
+/** Read a link at the caret using the same inline address as its writer. */
+export declare function hyperlinkTarget(doc: DocxDocument, at: DocPos): string | null;
+/** Set or remove a hyperlink in one inline container without flattening its content. */
+export declare function setHyperlink(doc: DocxDocument, a: DocPos, b: DocPos, target: string | null): boolean;
+/** Restart from this paragraph, keeping the following contiguous items in the same new list. */
+export declare function restartList(doc: DocxDocument, at: DocPos, start?: number): number | null;

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

@@ -0,0 +1,30 @@
+/**
+ * Word's comments, and where they sit in the text.
+ *
+ * `word/comments.xml` holds the comments; the body marks each range with
+ * `w:commentRangeStart` / `w:commentRangeEnd` between the runs. The offsets
+ * are counted the way `paragraphText` counts — `w:t` text, a tab, a break —
+ * so a comment's range is addressable by the editor like any selection.
+ */
+import { type DocxDocument } from './index';
+import { type DocPos } from './editor';
+export interface Comment {
+    id: string;
+    author: string;
+    date?: string;
+    text: string;
+}
+export interface CommentRange extends Comment {
+    para: number;
+    from: number;
+    to: number;
+}
+/** The comments, in the order comments.xml declares them. */
+export declare function commentsOf(doc: DocxDocument): Comment[];
+/** Each comment with its range in the body — a comment whose range is not in the flow is left out. */
+export declare function commentRanges(doc: DocxDocument): CommentRange[];
+/** Add a classic Word comment to a nonempty body selection, keeping existing parts intact. */
+export declare function addComment(doc: DocxDocument, a: DocPos, b: DocPos, text: string, author?: string): string | null;
+export declare function updateComment(doc: DocxDocument, id: string, text: string): boolean;
+/** Remove this comment's definition and anchors; unrelated annotations remain intact. */
+export declare function deleteComment(doc: DocxDocument, id: string): boolean;

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

@@ -53,7 +53,7 @@ export declare function splitParagraph(doc: DocxDocument, pos: DocPos): DocPos |
  *
  * Renvoie la position de la soudure, là où le curseur doit rester.
  */
-export declare function joinParagraph(doc: DocxDocument, para: number): DocPos | null;
+export declare function joinParagraph(doc: DocxDocument, para: number, part?: string): DocPos | null;
 /**
  * Insère un tableau vide au caret en coupant le paragraphe en deux.
  *

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

@@ -112,3 +112,5 @@ export * from './insert';
 export * from './paste';
 export * from './fonts';
 export * from './textbox';
+export * from './comments';
+export * from './authoring';

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

@@ -1,5 +1,12 @@
-import { type DocxDocument } from './index';
+import { type DocxDocument, type XmlNode } from './index';
 import { type DocPos, type RunPatch } from './editor';
+/** Prochain identifiant de relation libre pour une part. */
+export declare function nextRelId(rels: XmlNode[]): string;
+/** Le tableau des relations d'une part, créé s'il n'existe pas. */
+export declare function relsOf(doc: DocxDocument, part: string): {
+    path: string;
+    list: XmlNode[];
+};
 export interface InsertedImage {
     /** où le curseur se retrouve, après l'image */
     pos: DocPos;

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

@@ -30,6 +30,12 @@ export type PastedBlock = {
     widthPt: number;
     heightPt: number;
 };
+/** Déclare une part dans `[Content_Types].xml` par son chemin. */
+export declare function ensureOverride(doc: DocxDocument, part: string, mime: string): void;
+/** Relation du document vers une part interne, créée si elle manque. */
+export declare function ensureRel(doc: DocxDocument, type: string, target: string): void;
+/** Add a missing level to this list instance without changing other lists' abstract definitions. */
+export declare function ensureListLevel(doc: DocxDocument, numId: number, level: number): boolean;
 /**
  * Un `w:numId` bon pour une liste collée — trouvé, ou créé.
  *

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

@@ -49,6 +49,8 @@ export interface RunSpan {
     start: number;
     end: number;
 }
+/** Keep zero-width markup and objects between text runs when replacing their text. */
+export declare function interveningMarkup(first: RunSpan, last: RunSpan): XmlNode[];
 /**
  * Découpe un paragraphe en runs adressables, dans l'ordre de lecture.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrole-docx-editor",
-  "version": "0.1.5",
+  "version": "0.2.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",
@@ -46,10 +46,10 @@
     "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-vars": "0.0.0",
     "@myrole/fonts": "0.1.0",
-    "@myrole/docx-vars": "0.0.0"
+    "@myrole/docx-render": "0.0.0",
+    "@myrole/docx-tags": "0.0.0"
   },
   "publishConfig": {
     "access": "public"