ooxml-core 1.22.0 → 1.24.0

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/baseline.d.ts

@@ -0,0 +1,36 @@
+/** The scope (the role a page key plays) of the shapes inside master `key`'s content. */
+export declare const masterScope: (key: string) => string;
+export declare const pageId: (key: string) => string;
+export declare const bodyId: (key: string) => string;
+export declare const shapeId: (page: string, key: string) => string;
+export declare const cellId: (page: string, shape: string, path: string) => string;
+export declare const connectId: (key: string) => string;
+export declare const masterId: (key: string) => string;
+export declare const mediaId: (key: string) => string;
+/** Baseline text of a page entry (its position excluded) and of a body. */
+export declare const pageContent: (e: {
+    id: string;
+    back?: string | undefined;
+    xml: string;
+}) => string;
+export declare const bodyContent: (e: {
+    shell: string;
+    rels?: string | undefined;
+}) => string;
+/** A shape entry: its parent and attributes. */
+export declare const shellContent: (e: {
+    parent?: string | undefined;
+    open: string;
+}) => string;
+export declare const entryContent: (e: {
+    xml?: string | undefined;
+    open?: string | undefined;
+}) => string;
+/** A master: id, list element, relationships and a print of its part. */
+export declare const masterContent: (e: {
+    id: string;
+    xml: string;
+    rels?: string | undefined;
+    print: string;
+}) => string;
+//# sourceMappingURL=baseline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../visio/collab/baseline.ts"],"names":[],"mappings":"AAMA,yFAAyF;AACzF,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC/D,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC1D,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC1D,eAAO,MAAM,OAAO,SAAU,MAAM,OAAO,MAAM,KAAG,MAA4B,CAAC;AACjF,eAAO,MAAM,MAAM,SAAU,MAAM,SAAS,MAAM,QAAQ,MAAM,KAAG,MACtC,CAAC;AAC9B,eAAO,MAAM,SAAS,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC7D,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC5D,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAAoB,CAAC;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,WAAW,MAAO;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,MACnC,CAAC;AACtD,eAAO,MAAM,WAAW,MAAO;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAAG,MAC7B,CAAC;AAClD,gDAAgD;AAChD,eAAO,MAAM,YAAY,MAAO;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,MACf,CAAC;AAClE,eAAO,MAAM,YAAY,MAAO;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAAG,MACH,CAAC;AACxF,yEAAyE;AACzE,eAAO,MAAM,aAAa,MAAO;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACd,KAAG,MAAuE,CAAC"}

package/dist/visio/collab/bind.d.ts

@@ -3,12 +3,24 @@ import type { CollabSession } from '../../collab/session.js';
 export declare const VISIO_EDIT_ORIGIN: unique symbol;
 /** Origin of seeding writes, which are not undoable. */
 export declare const VISIO_SYNC_ORIGIN: unique symbol;
+/** Origin of the fix-ups that persist renumbered ids: not a local edit, so never in an undo history. */
+export declare const VISIO_FIXUP_ORIGIN: unique symbol;
+/** What differs between the drawing last applied and the next one, when only page content does. */
+export interface DrawingChange {
+    /** Ids (`Page/@ID` in the package handed over) of the pages whose content changed. */
+    pages: string[];
+}
 /** What the binding needs from the editor that shows the drawing. DOM-free. */
 export interface DrawingEditor {
     /** The package of the open drawing, or undefined when none can be read now. */
     exportBytes(): Uint8Array | undefined;
-    /** Replaces the open drawing with `bytes` as a step outside the local undo history. */
-    applyRemote(bytes: Uint8Array): Promise<void>;
+    /**
+     * Replaces the open drawing with `bytes` as a step outside the local undo history. `change`
+     * is given only when the open drawing is exactly the one last applied and just the content of
+     * these pages differs (same page list, masters, styles, theme, media and other parts): the
+     * editor may then read only those pages. Without it, read the whole package.
+     */
+    applyRemote(bytes: Uint8Array, change?: DrawingChange): Promise<void>;
     /** Called after the person edited or loaded a drawing (never for `applyRemote`). */
     onLocalChange(listener: () => void): () => void;
     /** Called whenever the editor may have stopped being busy. */
@@ -27,6 +39,12 @@ export interface DrawingBindingOptions {
     onError?: (error: unknown) => void;
     /** Part of every key this peer mints; defaults to the Yjs client id. */
     keyTag?: string;
+    /**
+     * Runs `run` once after the current burst of remote transactions (default: a zero-delay timer).
+     * Remote changes that arrive before it runs share one rebuild. `idle()` waits for it, so a test
+     * that injects a manual scheduler must call `run` before awaiting `idle()`.
+     */
+    schedule?: (run: () => void) => void;
 }
 export interface DrawingBinding {
     /** Undoes the last local edit (never a collaborator's); resolves false when there is none. */

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

@@ -1 +1 @@
-{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../visio/collab/bind.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAwC,CAAC;AAChF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAwC,CAAC;AAEhF,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC7B,+EAA+E;IAC/E,WAAW,IAAI,UAAU,GAAG,SAAS,CAAC;IACtC,uFAAuF;IACvF,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,oFAAoF;IACpF,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAChD,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzC,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,IAAI,MAAM,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACrC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACtD,iGAAiG;IACjG,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,qBAA0B,GACjC,cAAc,CAmKhB"}
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../visio/collab/bind.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1D,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAwC,CAAC;AAChF,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAwC,CAAC;AAChF,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAAyC,CAAC;AAElF,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC7B,sFAAsF;IACtF,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC7B,+EAA+E;IAC/E,WAAW,IAAI,UAAU,GAAG,SAAS,CAAC;IACtC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,oFAAoF;IACpF,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAChD,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzC,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,IAAI,MAAM,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACrC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC9B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACtD,iGAAiG;IACjG,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,qBAA0B,GACjC,cAAc,CAsNhB"}

package/dist/visio/collab/compose-lists.d.ts

@@ -0,0 +1,27 @@
+import type JSZip from 'jszip';
+export interface ListItem {
+    key: string;
+    /** The list element with {@link REL_MARK} where its `Rel` goes. */
+    xml: string;
+    part: Uint8Array;
+    /** Relationships of the item part, verbatim. */
+    rels?: string;
+}
+export interface ListOptions {
+    listPath: string;
+    open: string;
+    close: string;
+    relType: string;
+    /** File name stem of new parts: `page` gives `page1.xml`. */
+    stem: string;
+    items: readonly ListItem[];
+    /** Part names these keys had in the local package. */
+    known: Map<string, string>;
+    files: Map<string, Uint8Array | string>;
+    /** Names in use; extended with the ones placed. */
+    taken: Set<string>;
+    localZip: JSZip | undefined;
+}
+/** Writes the list, its relationships and the item parts; returns each item's part name. */
+export declare function placeList(options: ListOptions): Promise<Map<string, string>>;
+//# sourceMappingURL=compose-lists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-lists.d.ts","sourceRoot":"","sources":["../../../visio/collab/compose-lists.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,sDAAsD;IACtD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;IACxC,mDAAmD;IACnD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;CAC5B;AAKD,4FAA4F;AAC5F,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA2DlF"}

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

@@ -1,13 +1,17 @@
 import type { DrawingKeys } from './keys.js';
-import type { ResolvedDrawing, ResolvedPage } from './read.js';
+import type { ResolvedDrawing, ResolvedMaster, ResolvedPage } from './read.js';
 export interface ComposeOptions {
     /** Refuse shared parts that decode to more than this many bytes in total. */
     maxPartBytes?: number;
 }
 /** The page part with its shapes and connects filled in. */
-export declare function pagePartXml(page: ResolvedPage): string;
+export declare const pagePartXml: (page: ResolvedPage) => string;
+/** The master part with its shapes and connects filled in. */
+export declare const masterPartXml: (master: ResolvedMaster) => string;
 export interface ComposedDrawing {
     bytes: Uint8Array;
+    /** The resolved drawing's signature: equal signatures build equal packages. */
+    signature: string;
     /** Records what the room held as this peer's baseline; call it once the editor adopted `bytes`. */
     commit: () => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../visio/collab/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAiB1C,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAM5D,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAoBD,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAetD;AAMD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,UAAU,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,CA2I1B"}
+{"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

@@ -0,0 +1,5 @@
+import type { Fixup } from './read-ids.js';
+import { type SharedDrawing } from './schema.js';
+/** Writes `fixups` into the room; returns how many entries changed. Run it inside one transaction. */
+export declare function applyFixups(shared: SharedDrawing, fixups: readonly Fixup[]): number;
+//# sourceMappingURL=fixups.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}