myrole-docx-editor 0.1.5 → 0.3.0

package/README.md

@@ -87,6 +87,8 @@ editor.setZoom(1.25)             editor.setTheme('dark')          editor.setRead
 editor.showPanel('variables')    editor.fileName('contrat.docx')  editor.pages()
 editor.variables.tags()          editor.variables.preview(true, values)
 editor.comments()                editor.showComments(false)
+editor.addComment('Review', 'Author')  // nonempty body selection → ID or null
+editor.updateComment(id, 'Updated')   editor.deleteComment(id)
 editor.on('change' | 'selection' | 'render' | 'save' | 'load' | 'zoom', fn)
 await editor.saveNow()           editor.isDirty()                 editor.saveState()
 editor.fitZoom('width')          // or 'page'; follows host resizing
@@ -106,6 +108,34 @@ overrides covering more than half the paragraph, preserving local emphasis,
 character styles and structural XML. `styleId: null` restores the document's
 default style; `'Normal'` selects that named style. Unknown IDs are ignored.
 
+```ts
+const editing = editor.editor
+if (!editing) throw new Error('Load a document first')
+editing.selectRange({ para: 2, off: 0 }, { para: 2, off: 8 })
+editing.setLink('https://example.org')        // selected text; null removes the current link
+const styleId = editing.defineStyle('My heading') // create and apply from the selection
+if (styleId) editing.defineStyle('My heading', styleId) // update the same style
+editing.setList(true)                        // numbered; false for bullets; null removes it
+editing.setListLevel(1)                      // levels 0–8
+editing.restartList(1)                       // body list, from the current item
+editing.undo()
+```
+
+These actions are also available in the ribbon and refuse edits in read-only
+mode. Comments, styles, links and numbering definitions participate in undo/redo,
+including their package relationships. Classic comments support creation on a
+nonempty body range, editing and deletion, without threaded replies or resolution.
+Documents with extended/threaded comment metadata remain readable; their comment
+writes are refused to preserve the linked metadata.
+Links support HTTP(S), mailto and `#bookmark`, within one paragraph and inline
+container. Styles created here are paragraph styles. List restart currently
+requires a body list with direct numbering properties.
+
+Header/footer addresses use `{ para, off, part: 'word/header1.xml' }` (or the
+actual part name). Enter, Backspace/Delete and range deletion stay in that part;
+undo retains the story. Splitting inside a complex field, revision or content
+control is refused without altering the document.
+
 ## Display and context actions
 
 **Document brut**, under **Affichage** and **Réglages**, shows the original