ooxml-core 1.23.0 → 1.24.0

package/dist/embedding/storage.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Host-owned storage: the contract a host application implements to take over where an embedded
+ * editor reads, saves and keeps recovery copies of its document.
+ *
+ * Every product element (`<docx-editor>`, `<xlsx-editor>`, `<visio-viewer>` and the PowerPoint
+ * viewer of each binding) accepts a {@link DocumentStorage} as its `storage` property. When it is
+ * set, File > Save hands the saved bytes to {@link DocumentStorage.save} instead of downloading
+ * them, File > Open asks {@link DocumentStorage.open} instead of showing the browser's file picker,
+ * and an editor with AutoRecover (PowerPoint, Visio) keeps its recovery copies through the
+ * recovery methods instead of the library's own IndexedDB database. The cancelable
+ * `file-command` event still fires first: a host that prevents it handles the command itself and
+ * the storage is not called.
+ *
+ * DOM-free and format-neutral: the editors only pass bytes, a file name and a reason.
+ */
+/**
+ * A command of the File backstage, title bar or a shortcut, announced as the cancelable
+ * `file-command` event before the editor runs its default. Each product raises the subset it has
+ * (see {@link WordFileCommand}, {@link ExcelFileCommand}, {@link VisioFileCommand}).
+ */
+export type FileCommand = 'new' | 'open' | 'save' | 'saveAs' | 'export' | 'exportText' | 'exportCsv' | 'print' | 'share';
+/** The File commands `<docx-editor>` announces. */
+export type WordFileCommand = Exclude<FileCommand, 'exportCsv'>;
+/** The File commands `<xlsx-editor>` announces. */
+export type ExcelFileCommand = Exclude<FileCommand, 'exportText' | 'share'>;
+/** The File commands `<visio-viewer>` announces. */
+export type VisioFileCommand = Extract<FileCommand, 'new' | 'open' | 'save'>;
+/** The detail of a `file-command` event. */
+export interface FileCommandDetail<C extends string = FileCommand> {
+    command: C;
+    /** Save As and the exports: the name the user chose, when there is one. */
+    fileName?: string;
+}
+/** The event name every editor uses for {@link FileCommandDetail}. */
+export declare const FILE_COMMAND_EVENT = "file-command";
+/** Builds a {@link FileCommandDetail}, leaving `fileName` out rather than undefined. */
+export declare function fileCommandDetail<C extends string>(command: C, fileName?: string): FileCommandDetail<C>;
+/** Why an editor is saving: File > Save (or the Quick Access button, or Ctrl+S) or Save As. */
+export type DocumentSaveReason = 'save' | 'saveAs';
+/** What an editor tells the host about the bytes it hands to {@link DocumentStorage.save}. */
+export interface DocumentSaveMeta {
+    /** The file name the editor would download as, extension included (`Report.docx`). */
+    fileName: string;
+    /** The MIME type of the bytes. */
+    mimeType: string;
+    reason: DocumentSaveReason;
+}
+/** What {@link DocumentStorage.save} may report back. */
+export interface DocumentSaveResult {
+    /** The name the document now has, when the host chose another (a Save As dialog of its own). */
+    fileName?: string;
+}
+/** A document the host opened for the editor. */
+export interface DocumentOpenResult {
+    bytes: Uint8Array;
+    fileName: string;
+}
+/** A recovery copy of a document with unsaved changes. */
+export interface DocumentRecoveryEntry {
+    /** The document id it is kept under (the editors use the file name or the host's file path). */
+    id: string;
+    /** When it was written, in milliseconds since the epoch. */
+    savedAt: number;
+    bytes: Uint8Array;
+}
+/** A recovery copy without its bytes, as {@link DocumentStorage.listRecovery} returns it. */
+export interface DocumentRecoveryInfo {
+    id: string;
+    savedAt: number;
+    /** Size of the copy in bytes. */
+    size: number;
+}
+/**
+ * Storage a host supplies to an editor. Only {@link save} is required; each optional method the
+ * host leaves out keeps the editor's own behaviour for it (the browser file picker for Open, the
+ * library's IndexedDB for recovery copies). The recovery methods are used together: a host
+ * provides `readRecovery`, `writeRecovery` and `clearRecovery`, or none of them.
+ *
+ * Every method may reject; the editor reports a failed save as an error and treats a failed
+ * recovery read or write as "no copy kept".
+ */
+export interface DocumentStorage {
+    /** Store the saved document. Resolve once it is stored; reject to report the save as failed. */
+    save(bytes: Uint8Array, meta: DocumentSaveMeta): Promise<DocumentSaveResult | void>;
+    /** File > Open: resolve with the document to open, or undefined when the user canceled. */
+    open?(): Promise<DocumentOpenResult | undefined>;
+    /** The recovery copy kept under `id`, if any. */
+    readRecovery?(id: string): Promise<DocumentRecoveryEntry | undefined>;
+    /** Keep `entry` as the recovery copy of its id, replacing an earlier one. */
+    writeRecovery?(entry: DocumentRecoveryEntry): Promise<void>;
+    /** Remove the recovery copy kept under `id` (the document was saved or the copy discarded). */
+    clearRecovery?(id: string): Promise<void>;
+    /** Every kept recovery copy, for a version-history or recovery list. Optional even then. */
+    listRecovery?(): Promise<DocumentRecoveryInfo[]>;
+}
+/** The recovery methods of a storage that provides all three of them. */
+export type DocumentRecoveryStore = Required<Pick<DocumentStorage, 'readRecovery' | 'writeRecovery' | 'clearRecovery'>> & Pick<DocumentStorage, 'listRecovery'>;
+/** The storage's recovery store, or undefined when it does not provide one (use the default). */
+export declare function recoveryStoreOf(storage: DocumentStorage | null | undefined): DocumentRecoveryStore | undefined;
+/** True when `value` has the shape of a {@link DocumentStorage} (a `save` function). */
+export declare function isDocumentStorage(value: unknown): value is DocumentStorage;
+/** The MIME type of an Office file name by its extension; `application/octet-stream` otherwise. */
+export declare function documentMimeType(fileName: string): string;
+/** The {@link DocumentSaveMeta} for saving `fileName`, its MIME type taken from the extension. */
+export declare function documentSaveMeta(fileName: string, reason?: DocumentSaveReason, mimeType?: string): DocumentSaveMeta;
+/**
+ * Hands `bytes` to the storage and returns the file name the document has afterwards: the one the
+ * host reported, else `meta.fileName`. Rejects when the storage does.
+ */
+export declare function saveToStorage(storage: DocumentStorage, bytes: Uint8Array, meta: DocumentSaveMeta): Promise<string>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/embedding/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../embedding/storage.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -9613,6 +9613,238 @@ function findRibbonAddInCommand(tab, id) {
   return command && !command.disabled ? command : void 0;
 }
 
+// embedding/index.ts
+var embedding_exports = {};
+__export(embedding_exports, {
+  EDITOR_CAPABILITY_IDS: () => EDITOR_CAPABILITY_IDS,
+  FILE_COMMAND_EVENT: () => FILE_COMMAND_EVENT,
+  acceptedHostBackstagePages: () => acceptedHostBackstagePages,
+  capabilityHiddenActions: () => capabilityHiddenActions,
+  disabledCapabilities: () => disabledCapabilities,
+  documentMimeType: () => documentMimeType,
+  documentSaveMeta: () => documentSaveMeta,
+  fileCommandDetail: () => fileCommandDetail,
+  hostBackstageItemId: () => hostBackstageItemId,
+  hostBackstagePageId: () => hostBackstagePageId,
+  hostBackstageRegionId: () => hostBackstageRegionId,
+  hostMenuEntryId: () => hostMenuEntryId,
+  isCapabilityEnabled: () => isCapabilityEnabled,
+  isDocumentStorage: () => isDocumentStorage,
+  isHostMenuEntry: () => isHostMenuEntry,
+  mergeHiddenActions: () => mergeHiddenActions,
+  placeHostBackstagePages: () => placeHostBackstagePages,
+  recoveryStoreOf: () => recoveryStoreOf,
+  resolveHostMenuCommands: () => resolveHostMenuCommands,
+  sameRegionContext: () => sameRegionContext,
+  sameRenderer: () => sameRenderer,
+  saveToStorage: () => saveToStorage,
+  withHostMenuCommands: () => withHostMenuCommands,
+  withoutHiddenEntries: () => withoutHiddenEntries
+});
+
+// embedding/storage.ts
+var FILE_COMMAND_EVENT = "file-command";
+function fileCommandDetail(command, fileName) {
+  return fileName === void 0 ? { command } : { command, fileName };
+}
+function recoveryStoreOf(storage) {
+  if (!storage?.readRecovery || !storage.writeRecovery || !storage.clearRecovery) return void 0;
+  return storage;
+}
+function isDocumentStorage(value) {
+  return typeof value === "object" && value !== null && typeof value.save === "function";
+}
+var MIME_TYPES = {
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  docm: "application/vnd.ms-word.document.macroEnabled.12",
+  dotx: "application/vnd.openxmlformats-officedocument.wordprocessingml.template",
+  doc: "application/msword",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  xlsm: "application/vnd.ms-excel.sheet.macroEnabled.12",
+  xltx: "application/vnd.openxmlformats-officedocument.spreadsheetml.template",
+  xls: "application/vnd.ms-excel",
+  csv: "text/csv",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  pptm: "application/vnd.ms-powerpoint.presentation.macroEnabled.12",
+  ppsx: "application/vnd.openxmlformats-officedocument.presentationml.slideshow",
+  potx: "application/vnd.openxmlformats-officedocument.presentationml.template",
+  ppt: "application/vnd.ms-powerpoint",
+  vsdx: "application/vnd.ms-visio.drawing",
+  vsdm: "application/vnd.ms-visio.drawing.macroEnabled.12",
+  vsd: "application/vnd.visio",
+  txt: "text/plain",
+  json: "application/json"
+};
+function documentMimeType(fileName) {
+  const extension = /\.([^./\\]+)$/.exec(fileName)?.[1]?.toLowerCase() ?? "";
+  return MIME_TYPES[extension] ?? "application/octet-stream";
+}
+function documentSaveMeta(fileName, reason = "save", mimeType = documentMimeType(fileName)) {
+  return { fileName, mimeType, reason };
+}
+async function saveToStorage(storage, bytes, meta) {
+  const result = await storage.save(bytes, meta);
+  const name = result?.fileName?.trim();
+  return name ? name : meta.fileName;
+}
+
+// embedding/backstage.ts
+function hostBackstageItemId(id) {
+  return `host.${id}`;
+}
+function hostBackstagePageId(itemId) {
+  return itemId.startsWith("host.") ? itemId.slice(5) : void 0;
+}
+function acceptedHostBackstagePages(pages) {
+  const seen = /* @__PURE__ */ new Set();
+  const accepted = [];
+  for (const page of pages ?? []) {
+    if (!page || typeof page.id !== "string" || !page.id || seen.has(page.id)) continue;
+    seen.add(page.id);
+    accepted.push({ page, index: accepted.length });
+  }
+  return accepted.sort((a2, b) => (a2.page.order ?? 0) - (b.page.order ?? 0) || a2.index - b.index).map(({ page }) => page);
+}
+function placeHostBackstagePages(items, pages, toEntry) {
+  const entries = [...items];
+  for (const page of acceptedHostBackstagePages(pages)) {
+    const group2 = page.group ?? "main";
+    let at2 = entries.length;
+    while (at2 > 0 && (entries[at2 - 1]?.group ?? "main") !== group2) at2--;
+    entries.splice(at2 === 0 ? entries.length : at2, 0, toEntry(page));
+  }
+  return entries;
+}
+
+// embedding/capabilities.ts
+var EDITOR_CAPABILITY_IDS = [
+  /** Changing the document. `false` opens it read-only, whatever the edit prop says. */
+  "edit",
+  /** Saving a copy in another format (File > Export, Save As, Download). */
+  "export",
+  /** Printing (File > Print, the Print commands and Ctrl+P). */
+  "print",
+  /** Sharing the document with other people (File > Share, Share buttons). */
+  "share",
+  /** Copying content out (Copy, Cut and their shortcuts). */
+  "copy",
+  /** Adding and editing comments. */
+  "comment",
+  /** Tracked changes: turning tracking on, accepting and rejecting. */
+  "review",
+  /** Find and Replace. */
+  "find",
+  /** File > New and File > Open. */
+  "open",
+  /** File > Save. */
+  "save",
+  /** File > Options and Customize Ribbon. */
+  "settings"
+];
+function isCapabilityEnabled(capabilities, id) {
+  return capabilities?.[id] !== false;
+}
+function disabledCapabilities(capabilities) {
+  if (!capabilities) return [];
+  return Object.keys(capabilities).filter((id) => capabilities[id] === false);
+}
+function capabilityHiddenActions(capabilities, map) {
+  const hidden = /* @__PURE__ */ new Set();
+  for (const id of disabledCapabilities(capabilities))
+    for (const action of map[id] ?? []) hidden.add(action);
+  return [...hidden];
+}
+function mergeHiddenActions(...lists) {
+  const merged = /* @__PURE__ */ new Set();
+  for (const list2 of lists) for (const action of list2 ?? []) merged.add(action);
+  return [...merged];
+}
+
+// embedding/menu-commands.ts
+function hostMenuEntryId(id) {
+  return `host:${id}`;
+}
+function isHostMenuEntry(entry3) {
+  return typeof entry3 === "object" && entry3 !== null && entry3.host === true;
+}
+function resolveHostMenuCommands(commands, context) {
+  const top = [];
+  const bottom = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const command of commands ?? []) {
+    if (!command?.id || seen.has(command.id)) continue;
+    seen.add(command.id);
+    if (command.when && !command.when(context)) continue;
+    const disabled = typeof command.disabled === "function" ? command.disabled(context) : command.disabled === true;
+    const entry3 = {
+      id: hostMenuEntryId(command.id),
+      host: true,
+      label: command.label,
+      labelKey: "",
+      disabled,
+      onSelect: () => {
+        if (!disabled) command.onSelect(context);
+      }
+    };
+    if (command.icon) entry3.icon = command.icon;
+    (command.group === "bottom" ? bottom : top).push(entry3);
+  }
+  return { top, bottom };
+}
+function withHostMenuCommands(entries, commands, context) {
+  const { top, bottom } = resolveHostMenuCommands(commands, context);
+  const middle = entries.map(
+    (entry3, index) => index === 0 ? { ...entry3, separatorBefore: top.length > 0 } : entry3
+  );
+  const first2 = bottom[0];
+  if (first2 && top.length + middle.length > 0) first2.separatorBefore = true;
+  return [...top, ...middle, ...bottom];
+}
+function withoutHiddenEntries(entries, hidden) {
+  const kept = [];
+  let separator = false;
+  for (const entry3 of entries) {
+    separator ||= entry3.separatorBefore === true;
+    if (hidden(entry3)) continue;
+    const starts = separator && kept.length > 0;
+    kept.push(
+      entry3.separatorBefore === true === starts ? entry3 : { ...entry3, separatorBefore: starts }
+    );
+    separator = false;
+  }
+  return kept;
+}
+
+// embedding/regions.ts
+function hostBackstageRegionId(id) {
+  return `backstage.host.${id}`;
+}
+function sameRenderer(a2, b) {
+  if (a2 === b) return true;
+  if (!a2 || !b || typeof a2 !== "object" || typeof b !== "object" || a2.element !== b.element)
+    return false;
+  const left = a2.properties ?? {};
+  const right = b.properties ?? {};
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every((key) => Object.is(left[key], right[key]));
+}
+function sameRegionContext(a2, b, callbackKeys = /* @__PURE__ */ new Set(["close"])) {
+  const left = a2;
+  const right = b;
+  for (const key of /* @__PURE__ */ new Set([...Object.keys(left), ...Object.keys(right)])) {
+    if (callbackKeys.has(key)) continue;
+    const x = left[key];
+    const y = right[key];
+    if (Array.isArray(x) && Array.isArray(y)) {
+      if (!sameItems(x, y)) return false;
+    } else if (!Object.is(x, y)) return false;
+  }
+  return true;
+}
+function sameItems(a2, b) {
+  return a2 === b || a2.length === b.length && a2.every((item, index) => Object.is(item, b[index]));
+}
+
 // drawingml/index.ts
 var drawingml_exports = {};
 __export(drawingml_exports, {
@@ -46824,6 +47056,7 @@ exports.color = color_exports;
 exports.diagram = diagram_exports;
 exports.digest = digest_exports;
 exports.drawingml = drawingml_exports;
+exports.embedding = embedding_exports;
 exports.geometry = geometry_exports;
 exports.i18n = i18n_exports;
 exports.math = math_exports;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * as chart from './chart/index.js';
 export * as text from './text/index.js';
 export * as i18n from './i18n/index.js';
 export * as ribbon from './ribbon/index.js';
+export * as embedding from './embedding/index.js';
 export * as drawingml from './drawingml/index.js';
 export * as diagram from './diagram/index.js';
 export * as digest from './digest/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC"}

package/dist/index.mjs

@@ -9607,6 +9607,238 @@ function findRibbonAddInCommand(tab, id) {
   return command && !command.disabled ? command : void 0;
 }
 
+// embedding/index.ts
+var embedding_exports = {};
+__export(embedding_exports, {
+  EDITOR_CAPABILITY_IDS: () => EDITOR_CAPABILITY_IDS,
+  FILE_COMMAND_EVENT: () => FILE_COMMAND_EVENT,
+  acceptedHostBackstagePages: () => acceptedHostBackstagePages,
+  capabilityHiddenActions: () => capabilityHiddenActions,
+  disabledCapabilities: () => disabledCapabilities,
+  documentMimeType: () => documentMimeType,
+  documentSaveMeta: () => documentSaveMeta,
+  fileCommandDetail: () => fileCommandDetail,
+  hostBackstageItemId: () => hostBackstageItemId,
+  hostBackstagePageId: () => hostBackstagePageId,
+  hostBackstageRegionId: () => hostBackstageRegionId,
+  hostMenuEntryId: () => hostMenuEntryId,
+  isCapabilityEnabled: () => isCapabilityEnabled,
+  isDocumentStorage: () => isDocumentStorage,
+  isHostMenuEntry: () => isHostMenuEntry,
+  mergeHiddenActions: () => mergeHiddenActions,
+  placeHostBackstagePages: () => placeHostBackstagePages,
+  recoveryStoreOf: () => recoveryStoreOf,
+  resolveHostMenuCommands: () => resolveHostMenuCommands,
+  sameRegionContext: () => sameRegionContext,
+  sameRenderer: () => sameRenderer,
+  saveToStorage: () => saveToStorage,
+  withHostMenuCommands: () => withHostMenuCommands,
+  withoutHiddenEntries: () => withoutHiddenEntries
+});
+
+// embedding/storage.ts
+var FILE_COMMAND_EVENT = "file-command";
+function fileCommandDetail(command, fileName) {
+  return fileName === void 0 ? { command } : { command, fileName };
+}
+function recoveryStoreOf(storage) {
+  if (!storage?.readRecovery || !storage.writeRecovery || !storage.clearRecovery) return void 0;
+  return storage;
+}
+function isDocumentStorage(value) {
+  return typeof value === "object" && value !== null && typeof value.save === "function";
+}
+var MIME_TYPES = {
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  docm: "application/vnd.ms-word.document.macroEnabled.12",
+  dotx: "application/vnd.openxmlformats-officedocument.wordprocessingml.template",
+  doc: "application/msword",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  xlsm: "application/vnd.ms-excel.sheet.macroEnabled.12",
+  xltx: "application/vnd.openxmlformats-officedocument.spreadsheetml.template",
+  xls: "application/vnd.ms-excel",
+  csv: "text/csv",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  pptm: "application/vnd.ms-powerpoint.presentation.macroEnabled.12",
+  ppsx: "application/vnd.openxmlformats-officedocument.presentationml.slideshow",
+  potx: "application/vnd.openxmlformats-officedocument.presentationml.template",
+  ppt: "application/vnd.ms-powerpoint",
+  vsdx: "application/vnd.ms-visio.drawing",
+  vsdm: "application/vnd.ms-visio.drawing.macroEnabled.12",
+  vsd: "application/vnd.visio",
+  txt: "text/plain",
+  json: "application/json"
+};
+function documentMimeType(fileName) {
+  const extension = /\.([^./\\]+)$/.exec(fileName)?.[1]?.toLowerCase() ?? "";
+  return MIME_TYPES[extension] ?? "application/octet-stream";
+}
+function documentSaveMeta(fileName, reason = "save", mimeType = documentMimeType(fileName)) {
+  return { fileName, mimeType, reason };
+}
+async function saveToStorage(storage, bytes, meta) {
+  const result = await storage.save(bytes, meta);
+  const name = result?.fileName?.trim();
+  return name ? name : meta.fileName;
+}
+
+// embedding/backstage.ts
+function hostBackstageItemId(id) {
+  return `host.${id}`;
+}
+function hostBackstagePageId(itemId) {
+  return itemId.startsWith("host.") ? itemId.slice(5) : void 0;
+}
+function acceptedHostBackstagePages(pages) {
+  const seen = /* @__PURE__ */ new Set();
+  const accepted = [];
+  for (const page of pages ?? []) {
+    if (!page || typeof page.id !== "string" || !page.id || seen.has(page.id)) continue;
+    seen.add(page.id);
+    accepted.push({ page, index: accepted.length });
+  }
+  return accepted.sort((a2, b) => (a2.page.order ?? 0) - (b.page.order ?? 0) || a2.index - b.index).map(({ page }) => page);
+}
+function placeHostBackstagePages(items, pages, toEntry) {
+  const entries = [...items];
+  for (const page of acceptedHostBackstagePages(pages)) {
+    const group2 = page.group ?? "main";
+    let at2 = entries.length;
+    while (at2 > 0 && (entries[at2 - 1]?.group ?? "main") !== group2) at2--;
+    entries.splice(at2 === 0 ? entries.length : at2, 0, toEntry(page));
+  }
+  return entries;
+}
+
+// embedding/capabilities.ts
+var EDITOR_CAPABILITY_IDS = [
+  /** Changing the document. `false` opens it read-only, whatever the edit prop says. */
+  "edit",
+  /** Saving a copy in another format (File > Export, Save As, Download). */
+  "export",
+  /** Printing (File > Print, the Print commands and Ctrl+P). */
+  "print",
+  /** Sharing the document with other people (File > Share, Share buttons). */
+  "share",
+  /** Copying content out (Copy, Cut and their shortcuts). */
+  "copy",
+  /** Adding and editing comments. */
+  "comment",
+  /** Tracked changes: turning tracking on, accepting and rejecting. */
+  "review",
+  /** Find and Replace. */
+  "find",
+  /** File > New and File > Open. */
+  "open",
+  /** File > Save. */
+  "save",
+  /** File > Options and Customize Ribbon. */
+  "settings"
+];
+function isCapabilityEnabled(capabilities, id) {
+  return capabilities?.[id] !== false;
+}
+function disabledCapabilities(capabilities) {
+  if (!capabilities) return [];
+  return Object.keys(capabilities).filter((id) => capabilities[id] === false);
+}
+function capabilityHiddenActions(capabilities, map) {
+  const hidden = /* @__PURE__ */ new Set();
+  for (const id of disabledCapabilities(capabilities))
+    for (const action of map[id] ?? []) hidden.add(action);
+  return [...hidden];
+}
+function mergeHiddenActions(...lists) {
+  const merged = /* @__PURE__ */ new Set();
+  for (const list2 of lists) for (const action of list2 ?? []) merged.add(action);
+  return [...merged];
+}
+
+// embedding/menu-commands.ts
+function hostMenuEntryId(id) {
+  return `host:${id}`;
+}
+function isHostMenuEntry(entry3) {
+  return typeof entry3 === "object" && entry3 !== null && entry3.host === true;
+}
+function resolveHostMenuCommands(commands, context) {
+  const top = [];
+  const bottom = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const command of commands ?? []) {
+    if (!command?.id || seen.has(command.id)) continue;
+    seen.add(command.id);
+    if (command.when && !command.when(context)) continue;
+    const disabled = typeof command.disabled === "function" ? command.disabled(context) : command.disabled === true;
+    const entry3 = {
+      id: hostMenuEntryId(command.id),
+      host: true,
+      label: command.label,
+      labelKey: "",
+      disabled,
+      onSelect: () => {
+        if (!disabled) command.onSelect(context);
+      }
+    };
+    if (command.icon) entry3.icon = command.icon;
+    (command.group === "bottom" ? bottom : top).push(entry3);
+  }
+  return { top, bottom };
+}
+function withHostMenuCommands(entries, commands, context) {
+  const { top, bottom } = resolveHostMenuCommands(commands, context);
+  const middle = entries.map(
+    (entry3, index) => index === 0 ? { ...entry3, separatorBefore: top.length > 0 } : entry3
+  );
+  const first2 = bottom[0];
+  if (first2 && top.length + middle.length > 0) first2.separatorBefore = true;
+  return [...top, ...middle, ...bottom];
+}
+function withoutHiddenEntries(entries, hidden) {
+  const kept = [];
+  let separator = false;
+  for (const entry3 of entries) {
+    separator ||= entry3.separatorBefore === true;
+    if (hidden(entry3)) continue;
+    const starts = separator && kept.length > 0;
+    kept.push(
+      entry3.separatorBefore === true === starts ? entry3 : { ...entry3, separatorBefore: starts }
+    );
+    separator = false;
+  }
+  return kept;
+}
+
+// embedding/regions.ts
+function hostBackstageRegionId(id) {
+  return `backstage.host.${id}`;
+}
+function sameRenderer(a2, b) {
+  if (a2 === b) return true;
+  if (!a2 || !b || typeof a2 !== "object" || typeof b !== "object" || a2.element !== b.element)
+    return false;
+  const left = a2.properties ?? {};
+  const right = b.properties ?? {};
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every((key) => Object.is(left[key], right[key]));
+}
+function sameRegionContext(a2, b, callbackKeys = /* @__PURE__ */ new Set(["close"])) {
+  const left = a2;
+  const right = b;
+  for (const key of /* @__PURE__ */ new Set([...Object.keys(left), ...Object.keys(right)])) {
+    if (callbackKeys.has(key)) continue;
+    const x = left[key];
+    const y = right[key];
+    if (Array.isArray(x) && Array.isArray(y)) {
+      if (!sameItems(x, y)) return false;
+    } else if (!Object.is(x, y)) return false;
+  }
+  return true;
+}
+function sameItems(a2, b) {
+  return a2 === b || a2.length === b.length && a2.every((item, index) => Object.is(item, b[index]));
+}
+
 // drawingml/index.ts
 var drawingml_exports = {};
 __export(drawingml_exports, {
@@ -46813,4 +47045,4 @@ var EQUATION_GALLERY = [
   }
 ];
 
-export { chart_exports as chart, color_exports as color, diagram_exports as diagram, digest_exports as digest, drawingml_exports as drawingml, geometry_exports as geometry, i18n_exports as i18n, math_exports as math, opc_exports as opc, ribbon_exports as ribbon, text_exports as text, units_exports as units, xml_exports as xml };
+export { chart_exports as chart, color_exports as color, diagram_exports as diagram, digest_exports as digest, drawingml_exports as drawingml, embedding_exports as embedding, geometry_exports as geometry, i18n_exports as i18n, math_exports as math, opc_exports as opc, ribbon_exports as ribbon, text_exports as text, units_exports as units, xml_exports as xml };

package/dist/visio/collab/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../visio/collab/compose.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAiB1C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAiB,MAAM,QAAQ,CAAC;AAK3F,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AA6CD,4DAA4D;AAC5D,eAAO,MAAM,WAAW,SAAU,YAAY,KAAG,MAO/C,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,aAAa,WAAY,cAAc,KAAG,MAOrD,CAAC;AAEH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAoK1B"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../visio/collab/compose.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAiB1C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAiB,MAAM,QAAQ,CAAC;AAM3F,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AA6CD,4DAA4D;AAC5D,eAAO,MAAM,WAAW,SAAU,YAAY,KAAG,MAO/C,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,aAAa,WAAY,cAAc,KAAG,MAOrD,CAAC;AAEH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAyK1B"}

package/dist/visio/collab/fixups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixups.d.ts","sourceRoot":"","sources":["../../../visio/collab/fixups.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,UAAU,CAAC;AAE5D,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAOnF"}
+{"version":3,"file":"fixups.d.ts","sourceRoot":"","sources":["../../../visio/collab/fixups.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,UAAU,CAAC;AAE5D,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAMnF"}