ooxml-ui 1.22.0 → 1.23.1

package/dist/docx.js

@@ -1,6 +1,6 @@
 import { statusLayout, watchStatusWidth, compactPageText } from './chunk-UBBC5FH7.js';
-import { syncRibbonAddIns } from './chunk-C7B7TJ2J.js';
-export { RIBBON_ADD_IN_EVENT } from './chunk-C7B7TJ2J.js';
+import { syncRibbonAddIns, createHostBackstagePages, withHostMenuItems } from './chunk-HTIJ2EAA.js';
+export { RIBBON_ADD_IN_EVENT } from './chunk-HTIJ2EAA.js';
 import { defineSmartArt } from './chunk-QBXYGKPB.js';
 import { legacyThemeAliases, legacyThemeBridge, installOfficeUiThemeFor } from './chunk-T5ARELU2.js';
 import { createRibbonOverflow, defineRibbon, defineRuler, defineCommentsPane, defineDialog, defineSearchField, defineSwitch, defineTitleBar, defineRibbonActions, defineBackstage, defineStatusBar, defineZoomSlider, defineContextMenu, defineColorGrid, runKeyTips, defineOptionsDialog, assignKeyTips, optionsLabels, userInterfaceSection, personalizeSection, optionText, unavailableCategory } from './chunk-TJ245GDD.js';
@@ -9,8 +9,8 @@ import './chunk-YZH2QS7J.js';
 import './chunk-QLHCGV4C.js';
 import './chunk-XL77FR4B.js';
 import { optionStrings, normalizeLocale, SUPPORTED_OFFICE_LOCALES, interpolate } from 'ooxml-core/i18n';
-import { markSpecs, imageNodeSpec, fieldMarkerNodeSpec, noteReferenceNodeSpec, pageBreakNodeSpec, hardBreakNodeSpec, commentHistoryAttributes, tableCellStyle, tableStyle, createToggleFormat, expectDefined, controlFromData, paragraphBoxCss, normalizeThemeMode, applyThemeColors, refreshWordYjsPresence, normalizeRibbonActions, DirtyState, isFormsProtected, isWordYjsRemoteTransaction, REMOTE_TRANSACTION_META, repairCollaborativeDocumentIds, HEADER_FOOTER_INPUT, wordYjsPluginKey, wordYjsRedo, wordYjsUndo, documentWordCount, restoreSectionParts, commentThreadsFromDoc, restoreNoteParts, CollaborationClient, createCollaborationIdGenerator, WordYjsCollaboration, insertContentControl, sectionPartsJson, NotePartsStep, notePartsJson, SectionPartsStep, fitZoomPercent, hasChangeAtCursor, hasAnyChange, commentIdsAtSelection, commentAnchors, fieldGuardPlugin, tableStructureGuardPlugin, contentControlPlugin, formFieldGuardPlugin, symbolFontPlugin, positionalTabInputPlugin, trackChangesPlugin, wordYjsPresencePlugin, chartNodeSpec, placementClass, removeCommentThread, removeCommentAnchor, deleteComment, updateCommentThreads, addComment, toggleTrackChanges, goToNextChange, goToPreviousChange, rejectAllChanges, acceptAllChanges, rejectChangeAtCursor, acceptChangeAtCursor, goToComment, appendInlineNode, sameJson, sameRuns, PARAGRAPH_KEEP_KEYS, paragraphFromAttrs, parseBordersJson, isNavigableHref, setReviewRecordingPreferences, nodeNumbering, controlAtSelection, paragraphFormattingRevision, inlineNodeRun, formattingRevision, insertWordHardBreak, paragraphAttrs, resolveCellVisuals, themeDrawing, ribbonActionIdForLabel, removeWordLink, fieldResultRanges, wordLinkRangeAt, ligatureCss as ligatureCss$1, toggleCheckboxControl, formFieldBeside, formFieldOfNode, formFieldLocked, toggleFormCheckboxAt, runToInlineNodes as runToInlineNodes$1, insertedTextMarks, backstageFocus, applyRunFormattingPatch, clearDirectRunFormatting, applyWordLink, deleteFieldSelection, emptySimpleFieldResult, ligatureStyle, wordHighlightColors, swatchColor, cssBorderSide, countWords, chooseListItem, chooseDate, selectFormDropDownAt, updateControlProperties, resolveComment, replyToComment, CollaborationAuthority } from 'ooxml-core/docx/ui';
-export { CollaborationAuthority, CollaborationClient, RIBBON_ACTION_IDS, RIBBON_ACTION_LABELS, createCollaborationIdGenerator, darkTheme, isRibbonActionId, lightTheme, normalizeRibbonActions, repairCollaborativeDocumentIds, themeToCssVars } from 'ooxml-core/docx/ui';
+import { markSpecs, imageNodeSpec, fieldMarkerNodeSpec, noteReferenceNodeSpec, pageBreakNodeSpec, hardBreakNodeSpec, commentHistoryAttributes, tableCellStyle, tableStyle, createToggleFormat, expectDefined, controlFromData, paragraphBoxCss, WORD_CAPABILITY_ACTIONS, normalizeThemeMode, applyThemeColors, refreshWordYjsPresence, normalizeRibbonActions, DirtyState, isFormsProtected, isWordYjsRemoteTransaction, REMOTE_TRANSACTION_META, repairCollaborativeDocumentIds, HEADER_FOOTER_INPUT, wordYjsPluginKey, wordYjsRedo, wordYjsUndo, documentWordCount, restoreSectionParts, commentThreadsFromDoc, restoreNoteParts, CollaborationClient, createCollaborationIdGenerator, WordYjsCollaboration, insertContentControl, sectionPartsJson, NotePartsStep, notePartsJson, SectionPartsStep, fitZoomPercent, hasChangeAtCursor, hasAnyChange, commentIdsAtSelection, commentAnchors, fieldGuardPlugin, tableStructureGuardPlugin, contentControlPlugin, formFieldGuardPlugin, symbolFontPlugin, positionalTabInputPlugin, trackChangesPlugin, wordYjsPresencePlugin, chartNodeSpec, placementClass, removeCommentThread, removeCommentAnchor, deleteComment, updateCommentThreads, addComment, toggleTrackChanges, goToNextChange, goToPreviousChange, rejectAllChanges, acceptAllChanges, rejectChangeAtCursor, acceptChangeAtCursor, goToComment, appendInlineNode, sameJson, sameRuns, PARAGRAPH_KEEP_KEYS, paragraphFromAttrs, parseBordersJson, isNavigableHref, setReviewRecordingPreferences, nodeNumbering, controlAtSelection, paragraphFormattingRevision, inlineNodeRun, formattingRevision, insertWordHardBreak, paragraphAttrs, resolveCellVisuals, themeDrawing, ribbonActionIdForLabel, removeWordLink, fieldResultRanges, wordLinkRangeAt, ligatureCss as ligatureCss$1, toggleCheckboxControl, formFieldBeside, formFieldOfNode, formFieldLocked, toggleFormCheckboxAt, runToInlineNodes as runToInlineNodes$1, insertedTextMarks, backstageFocus, applyRunFormattingPatch, clearDirectRunFormatting, applyWordLink, deleteFieldSelection, emptySimpleFieldResult, ligatureStyle, wordHighlightColors, swatchColor, cssBorderSide, countWords, chooseListItem, chooseDate, selectFormDropDownAt, updateControlProperties, WORD_CAPABILITY_MENU_ITEMS, WORD_CAPABILITY_SHORTCUTS, WORD_CAPABILITY_BACKSTAGE_PAGES, WORD_CAPABILITY_FILE_COMMANDS, resolveComment, replyToComment, CollaborationAuthority } from 'ooxml-core/docx/ui';
+export { CollaborationAuthority, CollaborationClient, RIBBON_ACTION_IDS, RIBBON_ACTION_LABELS, WORD_CAPABILITY_IDS, createCollaborationIdGenerator, darkTheme, isRibbonActionId, lightTheme, normalizeRibbonActions, repairCollaborativeDocumentIds, themeToCssVars } from 'ooxml-core/docx/ui';
 import { createDocument, saveDocx, sectionsFromLayout, sectionLayoutJson, sectionsOf, pageSizeOf, columnPreset, applyPageSetup, withSection, computeListLabels, numberNotesInOrder, tocEntries, resolveNumberingLevel, tableOfFiguresInstruction, findTableOfContents, ensureListDefinition, equalColumnDraft, readColumnDraft, PAGE_SIZE_OPTIONS, PAGE_SIZES, readPageSetup, isRunHiddenForReview, resolveTableStyleFormatting, resolveParagraphFormatting, displayListLabel, setTitlePage, setLineNumbering, setVerticalAlign, setPageNumbering, ST_NumberFormat, unequalColumnPreset, setColumns, setOrientation, setPageSize, setMargins, lineSpacingLabel, formatNoteNumber, cellSourceBlocks, reviewDocumentFormatting, reviewFormattingWarnings, listRevisions, plainText, resolveRunFormatting, removedByEdit, tocHyperlinks, DEFAULT_TOC_INSTRUCTION, tocBookmarks, buildTableOfContents, tocCaptionLabel, twips as twips$1, signedTwips, formatListNumber, columnTextWidth, validColumnDraft, validatePageSetup, presetOf, LIGATURE_VALUES, isLigatures, reviewRunFormatting, resolveThemeColorReference, lineSpacingValue, canEditControlContent, controlDate, formDropDownIndex, shapeSvg, isStHighlightColor, transformCase, DEFAULT_TABLE_BORDERS, parseLineSpacingValue, twipsAttr, SHAPE_PALETTE, isHeadingListKind, twipsFromPixels, isFieldLocked, styleRefSource, parseStyleReference, bodyStyleRefResult, isDirectionalPreset, headingLevel, reviewParagraphFormatting, isValidLanguageTag, WORD, newShape, withFieldCodeFormatting, fieldResultRun, DEFAULT_DRAWN_SHAPE, fieldName, lineSpacingOptions, createListDefinition, linkStylesToList, headingListLevels, halfPointsFromPoints, changeColumnWidth, changeColumnGap, documentStats } from 'ooxml-core/docx';
 import { loadDocument } from 'ooxml-core/docx/load';
 import { Schema, Fragment, DOMSerializer, Mark } from 'prosemirror-model';
@@ -23,6 +23,7 @@ import { keymap } from 'prosemirror-keymap';
 import { createLayoutSession, layoutDocumentModel, pageNumbers, createFakeMeasurer, ligatureCss, cssFontStack, tokenizeRun, reviewSourceLength, placeTab, cellVerticalOffset, fieldDisplayText, DEFAULT_FONT_SIZE_PT, pageNumberValues, sectionPageCounts, pageStyleRefs, headerFooterSlotForPage, headerFooterForPage, paragraphFloats, floatPosition } from 'ooxml-core/docx/layout';
 import { chainCommands, baseKeymap, selectAll, splitBlock } from 'prosemirror-commands';
 import { sendableSteps, getVersion } from 'prosemirror-collab';
+import { isCapabilityEnabled, capabilityHiddenActions, mergeHiddenActions, saveToStorage, documentSaveMeta, fileCommandDetail, withoutHiddenEntries } from 'ooxml-core/embedding';
 
 var enOptions = {
   ...optionStrings.en,
@@ -5020,6 +5021,7 @@ function createShortcutRegistry(actions) {
   ];
   const attempt = (shortcut, context2) => {
     if (shortcut.editing && context2.readOnly) return "blocked";
+    if (context2.disabled?.has(shortcut.id)) return "blocked";
     return shortcut.run() === false ? "ignored" : "ran";
   };
   const shown = (shortcut, mac) => shortcut.keys.filter((spec) => !(mac && parse(spec).tap));
@@ -12137,7 +12139,10 @@ function renderDocument(core) {
       reviewAuthor: () => core.reviewAuthor,
       reviewDisplayMode: () => core.reviewDisplayMode,
       insertNote: (kind) => core.parts.insertNote(kind, canvas, paper),
-      showSearch: () => core.shell.searchPanel?.open(),
+      // ProseMirror's Mod-f reaches here before the shortcut registry: honour `find: false`.
+      showSearch: () => {
+        if (!core.viewOptions.customization.shortcuts.has("find")) core.shell.searchPanel?.open();
+      },
       extraPlugins: core.inserts.plugins(),
       yjs: Boolean(yjs),
       revisionIds: core.collab.ids,
@@ -12392,6 +12397,7 @@ function joinYjs(core, session, options) {
   core.loadGeneration++;
   core.detachedState = void 0;
   renderDocument(core);
+  core.roleChanged();
 }
 function leaveYjs(core) {
   const yjs = core.collab.yjs;
@@ -12403,6 +12409,7 @@ function leaveYjs(core) {
   core.collab.stop();
   core.detachedState = void 0;
   if (core.element.isConnected) renderDocument(core);
+  core.roleChanged();
 }
 function roomFor(core) {
   return new DocxRoom({
@@ -19393,6 +19400,59 @@ var InsertController = class {
     }
   }
 };
+var DOCX_EDITOR_ATTRIBUTES = [
+  "locale",
+  "read-only",
+  "file-name",
+  "review-author",
+  "theme",
+  "show-thumbnails",
+  "show-toolbar"
+];
+var DEFAULT_FILE_NAME = "Document1.docx";
+var DEFAULT_REVIEW_AUTHOR = "Author";
+function isDocxEditorAttribute(name) {
+  return DOCX_EDITOR_ATTRIBUTES.includes(name);
+}
+function applyAttribute(target, name, value) {
+  if (name === "locale") {
+    if (normalizeEditorLocale(value ?? "en") !== target.locale) target.locale = value ?? "en";
+  } else if (name === "read-only") {
+    target.readOnly = value !== null;
+  } else if (name === "file-name") {
+    const next = value ?? DEFAULT_FILE_NAME;
+    if (next !== target.fileName) target.fileName = next;
+  } else if (name === "theme") {
+    const next = normalizeThemeMode(value);
+    if (next !== target.theme) target.theme = next;
+  } else if (name === "show-thumbnails") {
+    const next = value !== null && value !== "false";
+    if (next !== target.showThumbnails) target.showThumbnails = next;
+  } else if (name === "show-toolbar") {
+    const next = value !== "false";
+    if (next !== target.showToolbar) target.showToolbar = next;
+  } else {
+    const next = value || DEFAULT_REVIEW_AUTHOR;
+    if (next !== target.reviewAuthor) target.reviewAuthor = next;
+  }
+}
+function reflectAttribute(element, name, value) {
+  if (typeof element.setAttribute !== "function") return;
+  if (name === "show-toolbar" && typeof value === "boolean") {
+    if (element.getAttribute(name) !== (value ? null : "false"))
+      if (value) element.removeAttribute(name);
+      else element.setAttribute(name, "false");
+    return;
+  }
+  if (typeof value === "boolean") {
+    if (element.hasAttribute(name) !== value) element.toggleAttribute(name, value);
+    return;
+  }
+  const current2 = element.getAttribute(name);
+  if (current2 === value) return;
+  if (name === "locale" && current2 !== null && normalizeEditorLocale(current2) === value) return;
+  element.setAttribute(name, value);
+}
 
 // src/docx/page-sync.ts
 var PageTracker = class {
@@ -19448,19 +19508,43 @@ function applyRibbonVisibility(toolbar, showToolbar, hiddenActions) {
   for (const panel of panelsOf(toolbar))
     setTabHidden(toolbar, panel.dataset.ribbonTab, "custom", allHidden(panel));
 }
+function resolveWordCustomization(customization) {
+  const capabilities = customization?.capabilities;
+  const set = (map) => new Set(capabilityHiddenActions(capabilities, map));
+  return {
+    canEdit: isCapabilityEnabled(capabilities, "edit"),
+    hiddenActions: capabilityHiddenActions(capabilities, WORD_CAPABILITY_ACTIONS),
+    fileCommands: set(WORD_CAPABILITY_FILE_COMMANDS),
+    backstagePages: set(WORD_CAPABILITY_BACKSTAGE_PAGES),
+    shortcuts: set(WORD_CAPABILITY_SHORTCUTS),
+    menuItems: set(WORD_CAPABILITY_MENU_ITEMS),
+    blockCopy: !isCapabilityEnabled(capabilities, "copy"),
+    extraPages: customization?.backstage?.extraPages ?? [],
+    menuCommands: customization?.contextMenu?.extraCommands ?? []
+  };
+}
+var EMPTY_WORD_CUSTOMIZATION = resolveWordCustomization();
 
 // src/docx/view-options.ts
 var ViewOptions = class {
   showThumbnails = false;
   showToolbar = true;
   hiddenActions = [];
+  /** The host's `customization` object, as given. */
+  customizationInput = null;
+  /** `customizationInput` resolved for the render sites. */
+  customization = EMPTY_WORD_CUSTOMIZATION;
 };
 function applyViewOptions(core) {
   const { toolbar, navigator: navigator2 } = core.shell;
-  const { showThumbnails, showToolbar, hiddenActions } = core.viewOptions;
+  const { showThumbnails, showToolbar, hiddenActions, customization } = core.viewOptions;
   navigator2?.setOpen(showThumbnails);
   if (!toolbar) return;
-  applyRibbonVisibility(toolbar, showToolbar, hiddenActions);
+  applyRibbonVisibility(
+    toolbar,
+    showToolbar,
+    mergeHiddenActions(hiddenActions, customization.hiddenActions)
+  );
   findLocalizedControl(toolbar, "Page thumbnails")?.setAttribute(
     "aria-pressed",
     String(showThumbnails)
@@ -19571,11 +19655,64 @@ var EditorCore = class {
   loaded;
   loadGeneration = 0;
   loading = false;
-  readOnly = false;
+  /** The host's `readOnly` switch. A collaboration `viewer` role locks the editor on top of it. */
+  hostReadOnly = false;
+  /** True while `applyReadOnly` writes the `read-only` attribute. */
+  reflectingReadOnly = false;
+  shownReadOnly = false;
+  shownHostReadOnly = false;
+  /**
+   * Effective: the host's switch, a `viewer` role, or `capabilities.edit` off. Assigning sets
+   * the host's switch only, so nothing that assigns it can lift the other two.
+   */
+  get readOnly() {
+    return this.hostReadOnly || this.roleLocked || !this.viewOptions.customization.canEdit;
+  }
+  set readOnly(value) {
+    this.hostReadOnly = value;
+  }
+  /** Applies the effective value to the view, controls and attribute. */
+  applyReadOnly() {
+    this.view?.setProps({ editable: () => this.canEditBody() });
+    if (this.readOnly) this.parts.closeHeaderFooter(this.shell.canvas, this.shell.paper);
+    this.refreshControls();
+    this.reflectingReadOnly = true;
+    try {
+      reflectAttribute(this.element, "read-only", this.hostReadOnly);
+    } finally {
+      this.reflectingReadOnly = false;
+    }
+    this.shownReadOnly = this.readOnly;
+    this.shownHostReadOnly = this.hostReadOnly;
+  }
+  /** True while a collaboration `viewer` role holds the editor read-only. */
+  get roleLocked() {
+    return this.collab.yjs?.session.role === "viewer";
+  }
+  /** Applies the effective value, then reports it when it or the host's switch changed. */
+  reportReadOnly(change) {
+    const wasReadOnly = this.shownReadOnly;
+    const wasHost = this.shownHostReadOnly;
+    change?.();
+    this.applyReadOnly();
+    const readOnly = this.readOnly;
+    if (readOnly === wasReadOnly && this.hostReadOnly === wasHost) return;
+    emit(this.element, "readonly-change", {
+      readOnly,
+      locked: this.roleLocked,
+      hostReadOnly: this.hostReadOnly
+    });
+  }
+  /** Joining or leaving a room can change the role lock: apply it and report a change. */
+  roleChanged() {
+    this.reportReadOnly();
+  }
   /** Set before mounting to render only the document surface. */
   surfaceOnly = false;
   /** Host-owned workflows for surface mode (link, find and replace, picture picker). */
   surfaceActions = {};
+  /** Where File > Save and Open go instead of a download and the file picker (`storage`). */
+  storage = void 0;
   locale = "en";
   reviewAuthor = "Author";
   theme = "auto";
@@ -23027,6 +23164,7 @@ function renderExport({ handlers, t, content }) {
 function renderCustomizeRibbon(host, handlers, t) {
   const ribbon = handlers.ribbon();
   const hidden = new Set(handlers.hiddenActions());
+  const policy = new Set(handlers.customization().hiddenActions);
   const seen = /* @__PURE__ */ new Set();
   const boxes = [];
   const commit = () => handlers.setHiddenActions(boxes.filter((b) => !b.input.checked).map((b) => b.id));
@@ -23047,7 +23185,7 @@ function renderCustomizeRibbon(host, handlers, t) {
         "button[aria-label]:not(.ribbon-launcher):not(.ribbon-overflow-button):not(.style-tile), select[aria-label], input[aria-label]"
       )) {
         const id = ribbonControlId(control);
-        if (!id || seen.has(id)) continue;
+        if (!id || seen.has(id) || policy.has(id)) continue;
         seen.add(id);
         const row3 = document.createElement("label");
         row3.className = "dve-customize-row";
@@ -23283,6 +23421,12 @@ function createBackstage(handlers) {
     pages.set(id, page2);
     element.append(page2);
   }
+  const hostPages = createHostBackstagePages(element, {
+    context: (region) => handlers.regionContext(region),
+    pageClass: "dve-backstage-content",
+    label: "[docx-editor]"
+  });
+  const hidden = (id) => handlers.customization().backstagePages.has(id);
   let current2 = "info";
   const options = createWordOptions(handlers, t);
   const draw = (page2) => {
@@ -23301,15 +23445,19 @@ function createBackstage(handlers) {
     const locale = normalizeEditorLocale(element.dataset.editorLocale);
     element.setAttribute("label", translate(locale, "File"));
     element.setAttribute("back-label", translate(locale, "Back to document"));
-    element.items = NAV.map(({ id, label, footer }) => ({
-      id,
-      label: t(label),
-      ...footer ? { group: "footer" } : {}
-    }));
+    hostPages.setPages(handlers.customization().extraPages);
+    element.items = hostPages.items(
+      NAV.filter(({ id }) => !hidden(id)).map(({ id, label, footer }) => ({
+        id,
+        label: t(label),
+        ...footer ? { group: "footer" } : {}
+      }))
+    );
   };
   localize();
   element.addEventListener("office-backstage-select", (event) => {
     const { id } = event.detail;
+    if (hostPages.show(id)) return;
     if (id === "save") {
       event.preventDefault();
       handlers.close();
@@ -23327,7 +23475,8 @@ function createBackstage(handlers) {
   return {
     element,
     optionsDialog: options.element,
-    open(page2 = "home") {
+    open(requested = "home") {
+      const page2 = hidden(requested === "customize" ? "options" : requested) ? "home" : requested;
       if (page2 === "options" || page2 === "customize") {
         showOptions(page2 === "customize" ? "ribbon" : void 0);
         return;
@@ -23347,18 +23496,18 @@ function createBackstage(handlers) {
       localize();
       options.relocalize();
       if (element.open) draw(current2);
+    },
+    refresh() {
+      localize();
+      hostPages.refresh();
+    },
+    destroy() {
+      hostPages.destroy();
     }
   };
 }
-
-// src/docx/file-commands.ts
 function announceFileCommand(host, command, fileName) {
-  return emit(
-    host,
-    "file-command",
-    { command, ...fileName === void 0 ? {} : { fileName } },
-    { cancelable: true }
-  );
+  return emit(host, "file-command", fileCommandDetail(command, fileName), { cancelable: true });
 }
 var DOCX_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
 var WORD_TYPES = {
@@ -23470,7 +23619,12 @@ function createTitleBar(handlers) {
   defineTitleBar();
   const element = document.createElement("office-ui-title-bar");
   element.className = "dve-titlebar";
-  const model = { fileName: "", saveState: "saved", readOnly: false };
+  const model = {
+    fileName: "",
+    saveState: "saved",
+    readOnly: false,
+    hidden: /* @__PURE__ */ new Set()
+  };
   let found = /* @__PURE__ */ new Map();
   const render = () => {
     const t = (text) => translateUiText(element, text);
@@ -23493,7 +23647,7 @@ function createTitleBar(handlers) {
           quick("save", "save", "Save"),
           quick("undo", "undo", "Undo", model.readOnly),
           quick("redo", "redo", "Redo", model.readOnly)
-        ]
+        ].filter((item) => !model.hidden.has(item.id))
       },
       search: {
         placeholder: prompt,
@@ -23544,12 +23698,16 @@ function createTitleBar(handlers) {
       model.readOnly = readOnly;
       render();
     },
+    setHiddenCommands(ids) {
+      model.hidden = new Set(ids);
+      render();
+    },
     relocalize: render
   };
 }
 
 // src/docx/editor-chrome.ts
-var DEFAULT_FILE_NAME = "Document1.docx";
+var DEFAULT_FILE_NAME2 = "Document1.docx";
 var EditorChrome = class {
   constructor(host) {
     this.host = host;
@@ -23587,7 +23745,9 @@ var EditorChrome = class {
       },
       ribbon: () => host.ribbon(),
       hiddenActions: () => host.hiddenActions(),
-      setHiddenActions: (ids) => host.setHiddenActions(ids)
+      setHiddenActions: (ids) => host.setHiddenActions(ids),
+      customization: () => host.customization(),
+      regionContext: (region) => host.regionContext(region)
     });
     this.statusBar = createStatusBar({
       setViewMode: (mode) => host.setViewMode(mode),
@@ -23612,7 +23772,7 @@ var EditorChrome = class {
   statusBar;
   fileInput;
   ribbon;
-  _fileName = DEFAULT_FILE_NAME;
+  _fileName = DEFAULT_FILE_NAME2;
   state = "saved";
   /** Adds the chrome around an existing frame: title bar first, status bar and backstage last. */
   mount(frame, ribbon) {
@@ -23631,7 +23791,7 @@ var EditorChrome = class {
     return this._fileName;
   }
   set fileName(value) {
-    this._fileName = value || DEFAULT_FILE_NAME;
+    this._fileName = value || DEFAULT_FILE_NAME2;
     this.titleBar.setFileName(this._fileName);
   }
   get isDirty() {
@@ -23665,16 +23825,25 @@ var EditorChrome = class {
     this.ribbonActions.setReadOnly(this.host.readOnly());
     this.ribbonActions.setSharing(this.host.collaborating());
   }
+  /** Re-applies the host customisation to the File tab, title bar and ribbon actions. */
+  applyCustomization() {
+    const resolved = this.host.customization();
+    this.backstage.refresh();
+    this.titleBar.setHiddenCommands(resolved.fileCommands);
+    this.ribbonActions.element.noShare = resolved.fileCommands.has("share");
+  }
   closeBackstage() {
     this.backstage.close();
     this.ribbon?.focusFile?.();
   }
   /** Runs a file command unless a host cancels the `file-command` event to handle it itself. */
   async run(command, fileName) {
+    if (this.host.customization().fileCommands.has(command)) return;
+    if ((command === "save" || command === "saveAs") && this.saving) return;
     if (!announceFileCommand(this.host.element, command, fileName)) return;
     try {
       if (command === "new") this.newDocument();
-      else if (command === "open") this.fileInput.click();
+      else if (command === "open") await this.open();
       else if (command === "print") this.host.print();
       else if (command === "share") return;
       else if (command === "exportText")
@@ -23684,21 +23853,59 @@ var EditorChrome = class {
         if (!name) return;
         const extension = this._fileName.split(".").pop()?.toLowerCase() === "doc" ? "doc" : "docx";
         this.fileName = withExtension(name, extension);
-        await this.run("save");
-      } else if (command === "save") {
-        this.setSaveState("saving");
-        downloadBytes(await this.host.save(), this._fileName);
-        this.setSaveState("saved-local");
-      } else if (command === "export")
+        if (this.host.customization().fileCommands.has("save"))
+          await this.saveDocument("saveAs", false);
+        else if (announceFileCommand(this.host.element, "save")) await this.saveDocument("saveAs");
+      } else if (command === "save") await this.saveDocument("save");
+      else if (command === "export")
         downloadBytes(
           await saveDocx(structuredClone(this.host.model())),
           withExtension(this._fileName, "docx")
         );
     } catch (cause) {
-      if (command === "save") this.setSaveState("dirty");
+      if (command === "save" || command === "saveAs") this.setSaveState("dirty");
       this.host.reportError(cause instanceof Error ? cause : new Error(String(cause)));
     }
   }
+  /** True while a save is pending. */
+  saving = false;
+  /**
+   * Saves to the host's storage when there is one, else downloads a copy. An edit made while the
+   * save runs keeps the document dirty: the saved bytes do not contain it.
+   */
+  async saveDocument(reason, useStorage = true) {
+    const element = this.host.element;
+    let edited = false;
+    const changed = () => edited = true;
+    this.saving = true;
+    this.setSaveState("saving");
+    element.addEventListener("document-change", changed);
+    try {
+      const bytes = await this.host.save();
+      const storage = useStorage ? this.host.storage?.() : void 0;
+      if (storage)
+        this.fileName = await saveToStorage(
+          storage,
+          bytes,
+          documentSaveMeta(this._fileName, reason)
+        );
+      else downloadBytes(bytes, this._fileName);
+      this.setSaveState(edited ? "dirty" : storage ? "saved" : "saved-local");
+    } finally {
+      element.removeEventListener("document-change", changed);
+      this.saving = false;
+    }
+  }
+  /** Opens from the host's storage when it can open, else shows the file picker. */
+  async open() {
+    const storage = this.host.storage?.();
+    if (!storage?.open) return this.fileInput.click();
+    const file = await storage.open();
+    if (!file) return;
+    await this.host.load(file.bytes);
+    this.fileName = file.fileName;
+    this.setSaveState("saved");
+  }
   newDocument() {
     const prompt = translate(
       this.host.locale(),
@@ -23706,7 +23913,7 @@ var EditorChrome = class {
     );
     if (this.isDirty && typeof confirm === "function" && !confirm(prompt)) return;
     this.host.newDocument();
-    this.fileName = DEFAULT_FILE_NAME;
+    this.fileName = DEFAULT_FILE_NAME2;
     this.setSaveState("saved");
   }
   async openSelectedFile() {
@@ -24916,6 +25123,28 @@ var HeadingNavigator = class {
     }
   }
 };
+
+// src/docx/customization-apply.ts
+function setWordCustomization(core, value) {
+  const { viewOptions } = core;
+  if (value === viewOptions.customizationInput) return;
+  core.reportReadOnly(() => {
+    viewOptions.customizationInput = value;
+    viewOptions.customization = resolveWordCustomization(value);
+  });
+  applyViewOptions(core);
+  core.shell.chrome?.applyCustomization();
+}
+function wordRegionContext(core, region) {
+  return {
+    region,
+    editor: core.element,
+    fileName: core.element.fileName,
+    locale: core.locale,
+    canEdit: !core.readOnly,
+    close: () => core.shell.chrome?.closeBackstage()
+  };
+}
 var clamp = (value, low, high) => Math.min(Math.max(value, low), Math.max(low, high));
 function attachCanvasClick(core) {
   const canvas = core.shell.canvas;
@@ -25034,8 +25263,21 @@ function menuStateFromView(view, readOnly) {
     canTable: (command) => canExecuteTableCommand(view, command)
   };
 }
-
-// src/docx/context-menu.ts
+function withoutMenuItems(items, hidden) {
+  return withoutHiddenEntries(items, (item) => hidden.has(item.id));
+}
+function menuContext(view, readOnly) {
+  const { from: from2, to } = view.state.selection;
+  const state = menuStateFromView(view, readOnly);
+  return {
+    selectedText: view.state.doc.textBetween(from2, to, "\n"),
+    from: from2,
+    to,
+    readOnly: state.readOnly,
+    inTable: state.inTable,
+    onLink: state.onLink
+  };
+}
 var KEY_ECHO_MS = 500;
 function createContextMenu(host) {
   let menu;
@@ -25087,17 +25329,31 @@ function createContextMenu(host) {
     close3(false);
     defineContextMenu();
     const locale = host.locale();
-    const items = computeMenuItems(menuStateFromView(view, host.readOnly()));
+    const resolved = host.customization();
+    const items = withoutMenuItems(
+      computeMenuItems(menuStateFromView(view, host.readOnly())),
+      resolved.menuItems
+    );
+    const extra = withHostMenuItems(
+      rows(items, locale),
+      resolved.menuCommands,
+      menuContext(view, host.readOnly())
+    );
     const element = document.createElement("office-ui-context-menu");
     const state = {
       x,
       y,
       label: translate(locale, "menu.context"),
-      items: rows(items, locale)
+      items: extra.items
     };
     element.state = state;
     element.addEventListener("office-menu-request", (event) => {
       const id = event.detail.id;
+      if (id.startsWith("host:")) {
+        close3();
+        extra.run(id);
+        return;
+      }
       const item = items.find((candidate) => candidate.id === id);
       const current2 = host.view();
       if (!item || !current2) return;
@@ -25159,8 +25415,8 @@ function editorShortcutRows(mac, bindings = editorBindings) {
   }
   return [...rows].map(([label, keys2]) => ({ label, keys: keys2.join(" / ") }));
 }
-function shortcutRows(registry, mac) {
-  const general = registry.shortcuts.map((shortcut) => ({
+function shortcutRows(registry, mac, disabled = /* @__PURE__ */ new Set()) {
+  const general = registry.shortcuts.filter((shortcut) => !disabled.has(shortcut.id)).map((shortcut) => ({
     label: shortcut.label,
     keys: registry.keysFor(shortcut.id, mac).join(" / ")
   }));
@@ -25240,8 +25496,19 @@ function attachEditorInteractions(core, frame) {
     readOnly: () => core.readOnly,
     locale: () => core.locale,
     run: (action) => routeRibbonAction(core, action),
-    warn: (message) => emit(element, "document-warning", message)
+    warn: (message) => emit(element, "document-warning", message),
+    customization: () => core.viewOptions.customization
   });
+  for (const type of ["copy", "cut"])
+    element.addEventListener(
+      type,
+      (event) => {
+        if (!core.viewOptions.customization.blockCopy) return;
+        event.preventDefault();
+        event.stopPropagation();
+      },
+      true
+    );
   const regionElement = (region) => region === "ribbon" ? shell.toolbar : region === "status" ? shell.chrome?.statusBar.element : void 0;
   const currentRegion = () => {
     const active = activeElement();
@@ -25330,7 +25597,10 @@ function attachEditorInteractions(core, frame) {
     },
     help: () => {
       menu.close(false);
-      help.open(shortcutRows(registry, mac()), core.locale);
+      help.open(
+        shortcutRows(registry, mac(), core.viewOptions.customization.shortcuts),
+        core.locale
+      );
     },
     escape: () => {
       if (escapeOwned) return false;
@@ -25343,7 +25613,11 @@ function attachEditorInteractions(core, frame) {
   };
   const mac = () => isMacPlatform();
   const registry = createShortcutRegistry(actions);
-  installKeyboard(element, registry, () => ({ readOnly: core.readOnly, mac: mac() }));
+  installKeyboard(element, registry, () => ({
+    readOnly: core.readOnly,
+    mac: mac(),
+    disabled: core.viewOptions.customization.shortcuts
+  }));
 }
 
 // src/docx/editor-shell.ts
@@ -25361,12 +25635,12 @@ function createChrome(core, api) {
     locale: () => core.locale,
     readOnly: () => core.readOnly,
     setReadOnly: (readOnly) => {
-      api.setReadOnly(readOnly);
-      emit(element, "readonly-change", readOnly);
+      core.reportReadOnly(() => api.setReadOnly(readOnly));
     },
     newDocument: () => api.setDocumentModel(createDocument()),
     load: (bytes) => api.load(bytes),
     save: () => api.saveBytes(),
+    storage: () => core.storage,
     saveStateChanged: (state) => {
       if (state !== "saving") core.dirtyState.set(state === "dirty");
     },
@@ -25407,6 +25681,8 @@ function createChrome(core, api) {
       host().hiddenActions = ids;
       emit(element, "ribbon-customize", host().hiddenActions);
     },
+    customization: () => core.viewOptions.customization,
+    regionContext: (region) => wordRegionContext(core, region),
     reportError: (error) => dispatchDocumentError(element, error)
   });
 }
@@ -25538,6 +25814,7 @@ function buildShell(core, api) {
   applyRibbonAddIns(core);
   chrome.setLocale(core.locale);
   applyViewOptions(core);
+  chrome.applyCustomization();
   attachEditorInteractions(core, frame);
   element.setAttribute("role", "region");
   applyShellLabels(element, paper, core.locale);
@@ -25588,59 +25865,6 @@ function attachPrintEditing(core) {
     showBlock: (id, offset) => printLayout.ensureBlock(id, offset)
   });
 }
-var DOCX_EDITOR_ATTRIBUTES = [
-  "locale",
-  "read-only",
-  "file-name",
-  "review-author",
-  "theme",
-  "show-thumbnails",
-  "show-toolbar"
-];
-var DEFAULT_FILE_NAME2 = "Document1.docx";
-var DEFAULT_REVIEW_AUTHOR = "Author";
-function isDocxEditorAttribute(name) {
-  return DOCX_EDITOR_ATTRIBUTES.includes(name);
-}
-function applyAttribute(target, name, value) {
-  if (name === "locale") {
-    if (normalizeEditorLocale(value ?? "en") !== target.locale) target.locale = value ?? "en";
-  } else if (name === "read-only") {
-    if (value !== null !== target.readOnly) target.readOnly = value !== null;
-  } else if (name === "file-name") {
-    const next = value ?? DEFAULT_FILE_NAME2;
-    if (next !== target.fileName) target.fileName = next;
-  } else if (name === "theme") {
-    const next = normalizeThemeMode(value);
-    if (next !== target.theme) target.theme = next;
-  } else if (name === "show-thumbnails") {
-    const next = value !== null && value !== "false";
-    if (next !== target.showThumbnails) target.showThumbnails = next;
-  } else if (name === "show-toolbar") {
-    const next = value !== "false";
-    if (next !== target.showToolbar) target.showToolbar = next;
-  } else {
-    const next = value || DEFAULT_REVIEW_AUTHOR;
-    if (next !== target.reviewAuthor) target.reviewAuthor = next;
-  }
-}
-function reflectAttribute(element, name, value) {
-  if (typeof element.setAttribute !== "function") return;
-  if (name === "show-toolbar" && typeof value === "boolean") {
-    if (element.getAttribute(name) !== (value ? null : "false"))
-      if (value) element.removeAttribute(name);
-      else element.setAttribute(name, "false");
-    return;
-  }
-  if (typeof value === "boolean") {
-    if (element.hasAttribute(name) !== value) element.toggleAttribute(name, value);
-    return;
-  }
-  const current2 = element.getAttribute(name);
-  if (current2 === value) return;
-  if (name === "locale" && current2 !== null && normalizeEditorLocale(current2) === value) return;
-  element.setAttribute(name, value);
-}
 
 // src/docx/building-blocks-actions.ts
 function hyperlinkRequest(core) {
@@ -25923,6 +26147,18 @@ var DocxEditorApi = class extends HTMLElementBase {
     this.core.surfaceActions = { ...value };
     if (this.core.view) this.core.refreshControls();
   }
+  /**
+   * Host-owned storage. When set, File > Save and Save As hand the saved bytes to
+   * `storage.save()` instead of downloading them, and File > Open asks `storage.open()` (when it
+   * has one) instead of showing the file picker. The cancelable `file-command` event still fires
+   * first; a host that prevents it handles the command itself.
+   */
+  get storage() {
+    return this.core.storage;
+  }
+  set storage(value) {
+    this.core.storage = value ?? void 0;
+  }
   get loading() {
     return this.core.loading;
   }
@@ -26025,6 +26261,18 @@ var DocxEditorApi = class extends HTMLElementBase {
     this.core.viewOptions.hiddenActions = next;
     applyViewOptions(this.core);
   }
+  /**
+   * The host customisation (`WordCustomization`): `capabilities` (removing every UI path to
+   * what is switched off), `backstage.extraPages` (host File tab pages) and
+   * `contextMenu.extraCommands` (host context-menu commands). The object is applied when its
+   * identity changes, so keep it stable; `null` restores the defaults.
+   */
+  get customization() {
+    return this.core.viewOptions.customizationInput;
+  }
+  set customization(value) {
+    setWordCustomization(this.core, value ?? null);
+  }
   /** True after an edit until the document is saved through File > Save, `download()`, loaded or `markClean()`. */
   get dirty() {
     return this.core.dirtyState.dirty;
@@ -26088,6 +26336,7 @@ var DocxEditorElement = class extends DocxEditorApi {
     return this.core.inserts;
   }
   attributeChangedCallback(name, _old, value) {
+    if (name === "read-only" && this.core.reflectingReadOnly) return;
     if (isDocxEditorAttribute(name)) applyAttribute(this, name, value);
   }
   get reviewAuthor() {
@@ -26100,7 +26349,7 @@ var DocxEditorElement = class extends DocxEditorApi {
   /** File name shown in the title bar and used for downloads from the built-in File commands. */
   get fileName() {
     const { chrome } = this.core.shell;
-    return chrome?.fileName ?? this.core.pendingFileName ?? DEFAULT_FILE_NAME2;
+    return chrome?.fileName ?? this.core.pendingFileName ?? DEFAULT_FILE_NAME;
   }
   set fileName(value) {
     const { chrome } = this.core.shell;
@@ -26161,13 +26410,10 @@ var DocxEditorElement = class extends DocxEditorApi {
   get readOnly() {
     return this.core.readOnly;
   }
+  /** True when the document cannot be edited: this switch, a `viewer` role or `capabilities.edit` off. */
   set readOnly(value) {
     this.core.readOnly = Boolean(value);
-    this.core.view?.setProps({ editable: () => this.core.canEditBody() });
-    if (this.core.readOnly)
-      this.core.parts.closeHeaderFooter(this.core.shell.canvas, this.core.shell.paper);
-    this.core.refreshControls();
-    reflectAttribute(this, "read-only", this.core.readOnly);
+    this.core.applyReadOnly();
   }
   /**
    * Shares the loaded document in a room while set; `null` leaves (see
@@ -26207,6 +26453,7 @@ var DocxEditorElement = class extends DocxEditorApi {
     core.view?.destroy();
     core.view = void 0;
     core.imageMedia.release();
+    core.shell.chrome?.backstage.destroy();
   }
   async load(input) {
     const { core } = this;