ooxml-core 1.19.2 → 1.21.0

package/dist/collab/index.mjs

@@ -629,107 +629,6 @@ var Emitter = class {
   }
 };
 
-// collab/external-provider.ts
-function adaptYjsProvider(provider) {
-  const events = new Emitter();
-  let destroyed = false;
-  let status = provider.wsconnected || provider.connected ? "connected" : provider.wsconnecting ? "connecting" : "disconnected";
-  let synced = Boolean(provider.synced);
-  const subscriptions = [];
-  const listen = (name, handler) => {
-    const wrapped = handler;
-    provider.on(name, wrapped);
-    subscriptions.push([name, wrapped]);
-  };
-  const setStatus = (next) => {
-    if (destroyed || next === status) return;
-    status = next;
-    events.emit("status", next);
-  };
-  const setSynced = (next) => {
-    if (destroyed || next === synced) return;
-    synced = next;
-    events.emit("synced", next);
-  };
-  listen("status", (payload) => {
-    if (typeof payload.connected === "boolean") {
-      if (!payload.connected) setSynced(false);
-      return setStatus(payload.connected ? "connected" : "disconnected");
-    }
-    if (payload.status === "connected" || payload.status === "connecting")
-      setStatus(payload.status);
-    else if (payload.status === "disconnected") {
-      setSynced(false);
-      setStatus("disconnected");
-    }
-  });
-  const onSync = (value) => setSynced(typeof value === "boolean" ? value : value.synced === true);
-  listen("sync", onSync);
-  listen("synced", onSync);
-  listen("connection-error", (cause) => {
-    if (destroyed) return;
-    setStatus("error");
-    events.emit("error", cause instanceof Error ? cause : new Error("Provider connection error"));
-  });
-  return {
-    get status() {
-      return status;
-    },
-    get synced() {
-      return synced;
-    },
-    connect: () => {
-      if (destroyed || status === "connected" || status === "connecting") return;
-      setStatus("connecting");
-      provider.connect?.();
-    },
-    disconnect: () => {
-      if (destroyed) return;
-      provider.disconnect?.();
-      setSynced(false);
-      setStatus("disconnected");
-    },
-    destroy: () => {
-      if (destroyed) return;
-      setSynced(false);
-      setStatus("disconnected");
-      destroyed = true;
-      for (const [name, handler] of subscriptions) provider.off?.(name, handler);
-      subscriptions.length = 0;
-      events.clear();
-      provider.destroy?.();
-    },
-    on: (event, listener) => events.on(event, listener)
-  };
-}
-function observeExternalSession(session, onSnapshot) {
-  let active = true;
-  let subscribing = true;
-  let previous;
-  let unsubscribe;
-  const notify = () => {
-    if (!active || subscribing) return;
-    const snapshot = session.getSnapshot();
-    if (previous?.status === snapshot.status && previous.synced === snapshot.synced) return;
-    previous = { status: snapshot.status, synced: snapshot.synced };
-    onSnapshot(previous);
-  };
-  const dispose = () => {
-    if (!active) return;
-    active = false;
-    unsubscribe?.();
-  };
-  try {
-    unsubscribe = session.subscribe(notify);
-    subscribing = false;
-    notify();
-  } catch (error) {
-    dispose();
-    throw error;
-  }
-  return dispose;
-}
-
 // collab/lifecycle.ts
 var COLLAB_LEAVE_MESSAGE = "ooxml-core:collab-leave";
 var DEPARTURE_CHANNEL = "ooxml-core:collab-departures";
@@ -812,250 +711,77 @@ function createDepartureChannel(roomId, awareness, factory, channelName = DEPART
   };
 }
 
-// collab/memory-transport.ts
-function createMemoryHub(options = {}) {
-  const rooms = /* @__PURE__ */ new Map();
-  let nextId = 0;
-  const deliver = (task) => {
-    if (options.async) queueMicrotask(task);
-    else task();
+// collab/provider.ts
+var CONNECTION_TIMEOUT_MS = 3e4;
+
+// collab/session.ts
+function createCollabSession(options) {
+  const roomId = validateRoomId(options.roomId);
+  const ownsDoc = !options.doc;
+  const doc = options.doc ?? new Y.Doc();
+  const awareness = new Awareness(doc);
+  const events = new Emitter();
+  const role = options.user.role;
+  const identity = {
+    userName: sanitizeUserName(options.user.name),
+    userColor: sanitizeColor(options.user.color, assignUserColor(doc.clientID)),
+    userAvatar: options.user.avatar,
+    role
   };
-  return {
-    size: (roomId) => rooms.get(roomId)?.size ?? 0,
-    createTransport(roomId) {
-      const id = nextId++;
-      let endpoint = null;
-      const peers = () => {
-        let room = rooms.get(roomId);
-        if (!room) rooms.set(roomId, room = /* @__PURE__ */ new Set());
-        return room;
-      };
-      return {
-        get connected() {
-          return endpoint !== null;
-        },
-        connect(handlers) {
-          if (endpoint) peers().delete(endpoint);
-          const self = { id, handlers };
-          const others = [...peers()];
-          peers().add(self);
-          endpoint = self;
-          deliver(() => {
-            if (endpoint !== self) return;
-            handlers.open();
-            for (const other of others) other.handlers.peer?.();
-          });
-        },
-        send(data) {
-          const self = endpoint;
-          if (!self || options.filter && !options.filter(data, id)) return;
-          for (const other of [...peers()])
-            if (other !== self) deliver(() => other.handlers.message(data.slice()));
-        },
-        disconnect() {
-          const self = endpoint;
-          if (!self) return;
-          endpoint = null;
-          peers().delete(self);
-          self.handlers.close("disconnected");
-        }
-      };
-    }
+  const sanitizePayload = options.sanitizePayload ?? (() => ({}));
+  const publisher = createPresencePublisher(
+    awareness,
+    identity,
+    options.initialPresence ?? {}
+  );
+  let destroyed = false;
+  let timeout = null;
+  const gate = createSyncGate(() => {
+    if (destroyed) return;
+    options.onReady?.({ synced: provider.synced });
+    events.emit("ready", void 0);
+  }, options.syncGraceMs ?? INITIAL_SYNC_GRACE_MS);
+  const peers = () => derivePresence(awareness.getStates(), doc.clientID, sanitizePayload);
+  const emitPeers = () => events.emit("peers", peers());
+  awareness.on("change", emitPeers);
+  const provider = options.provider({ doc, awareness, roomId });
+  const clearTimeoutTimer = () => {
+    if (timeout !== null) clearTimeout(timeout);
+    timeout = null;
   };
-}
-
-// collab/package-adapter.ts
-var DEFAULT_MAX_PACKAGE_BYTES = 32 * 1024 * 1024;
-function packageAdapter(options = {}) {
-  const name = options.name ?? "package";
-  const maxBytes = options.maxBytes ?? DEFAULT_MAX_PACKAGE_BYTES;
-  const map = (doc) => doc.getMap(name);
-  const check = (bytes) => {
-    if (!(bytes instanceof Uint8Array)) throw new Error("The shared package is not binary data.");
-    if (bytes.byteLength > maxBytes)
-      throw new Error(`The shared package exceeds ${Math.round(maxBytes / 1024 / 1024)} MiB.`);
-    return bytes;
+  provider.on("status", (status) => {
+    clearTimeoutTimer();
+    events.emit("status", status);
+    if (status === "connecting")
+      timeout = setTimeout(() => {
+        events.emit("error", new Error("Collaboration connection timed out"));
+        events.emit("status", "error");
+      }, options.connectionTimeoutMs ?? CONNECTION_TIMEOUT_MS);
+    if (status === "connected") gate.arm();
+  });
+  provider.on("synced", (synced) => {
+    events.emit("synced", synced);
+    if (synced) gate.open();
+  });
+  provider.on("error", (error) => events.emit("error", error));
+  const heartbeatMs = options.heartbeatMs ?? PRESENCE_HEARTBEAT_MS;
+  const heartbeat = heartbeatMs > 0 ? setInterval(() => {
+    publisher.flush();
+    emitPeers();
+  }, heartbeatMs) : null;
+  heartbeat?.unref?.();
+  const departure = createDepartureChannel(roomId, awareness);
+  const leave = () => {
+    departure.announce();
+    publisher.dispose();
+    awareness.setLocalState(null);
+    provider.disconnect();
   };
-  return {
-    isEmpty: (doc) => !(map(doc).get("bytes") instanceof Uint8Array),
-    read: (doc) => {
-      const shared = map(doc);
-      const revision = shared.get("revision");
-      return {
-        bytes: check(shared.get("bytes")).slice(),
-        revision: typeof revision === "number" && Number.isSafeInteger(revision) ? revision : 0
-      };
-    },
-    write: (doc, model, origin) => {
-      const bytes = check(model.bytes);
-      doc.transact(() => {
-        const shared = map(doc);
-        const current = shared.get("revision");
-        const revision = Math.max(model.revision, typeof current === "number" ? current : 0) + 1;
-        shared.set("bytes", bytes.slice());
-        shared.set("revision", revision);
-      }, origin);
-    },
-    observe: (doc, onChange) => {
-      const shared = map(doc);
-      const handler = (event) => {
-        if (event.keysChanged.has("bytes")) onChange(event.transaction.origin);
-      };
-      shared.observe(handler);
-      return () => shared.unobserve(handler);
-    }
-  };
-}
-
-// collab/ordering.ts
-function classifyVersion(messageVersion, currentVersion) {
-  if (!isNonNegativeSafeInteger(messageVersion) || !isNonNegativeSafeInteger(currentVersion))
-    return "invalid";
-  if (messageVersion < currentVersion) return "stale";
-  return messageVersion > currentVersion ? "out-of-order" : "apply";
-}
-var BoundedMap = class {
-  constructor(limit) {
-    this.limit = limit;
-    if (!Number.isSafeInteger(limit) || limit < 1) throw new Error("limit must be positive");
-  }
-  limit;
-  entries = /* @__PURE__ */ new Map();
-  get size() {
-    return this.entries.size;
-  }
-  get(key) {
-    return this.entries.get(key);
-  }
-  has(key) {
-    return this.entries.has(key);
-  }
-  set(key, value) {
-    this.entries.delete(key);
-    this.entries.set(key, value);
-    if (this.entries.size > this.limit) {
-      const oldest = this.entries.keys().next();
-      if (!oldest.done) this.entries.delete(oldest.value);
-    }
-  }
-  delete(key) {
-    return this.entries.delete(key);
-  }
-  clear() {
-    this.entries.clear();
-  }
-};
-var IdempotencyCache = class {
-  seen;
-  constructor(limit = 5e3) {
-    this.seen = new BoundedMap(limit);
-  }
-  check(clientId, messageId, fingerprint) {
-    const prior = this.seen.get(`${clientId}\0${messageId}`);
-    if (!prior) return { status: "fresh" };
-    return prior.fingerprint === fingerprint ? { status: "duplicate", value: prior.value } : { status: "reused" };
-  }
-  remember(clientId, messageId, fingerprint, value) {
-    this.seen.set(`${clientId}\0${messageId}`, { fingerprint, value });
-  }
-};
-var SequenceTracker = class {
-  last;
-  constructor(limit = 200) {
-    this.last = new BoundedMap(limit);
-  }
-  /** Classify without recording; call {@link commit} once the message was actually applied. */
-  classify(peerId, sequence, fingerprint) {
-    if (!isNonNegativeSafeInteger(sequence) || sequence < 1) return "invalid";
-    const previous = this.last.get(peerId);
-    if (!previous || sequence > previous.sequence) return "apply";
-    if (sequence < previous.sequence) return "stale";
-    return previous.fingerprint === fingerprint ? "duplicate" : "invalid";
-  }
-  commit(peerId, sequence, fingerprint) {
-    this.last.set(peerId, { sequence, fingerprint });
-  }
-  forget(peerId) {
-    this.last.delete(peerId);
-  }
-};
-function freezeDeep(value) {
-  if (value && typeof value === "object" && !Object.isFrozen(value)) {
-    for (const child of Object.values(value)) freezeDeep(child);
-    Object.freeze(value);
-  }
-  return value;
-}
-
-// collab/provider.ts
-var CONNECTION_TIMEOUT_MS = 3e4;
-function createCollabSession(options) {
-  const roomId = validateRoomId(options.roomId);
-  const ownsDoc = !options.doc;
-  const doc = options.doc ?? new Y.Doc();
-  const awareness = new Awareness(doc);
-  const events = new Emitter();
-  const role = options.user.role;
-  const identity = {
-    userName: sanitizeUserName(options.user.name),
-    userColor: sanitizeColor(options.user.color, assignUserColor(doc.clientID)),
-    userAvatar: options.user.avatar,
-    role
-  };
-  const sanitizePayload = options.sanitizePayload ?? (() => ({}));
-  const publisher = createPresencePublisher(
-    awareness,
-    identity,
-    options.initialPresence ?? {}
-  );
-  let destroyed = false;
-  let timeout = null;
-  const gate = createSyncGate(() => {
-    if (destroyed) return;
-    options.onReady?.({ synced: provider.synced });
-    events.emit("ready", void 0);
-  }, options.syncGraceMs ?? INITIAL_SYNC_GRACE_MS);
-  const peers = () => derivePresence(awareness.getStates(), doc.clientID, sanitizePayload);
-  const emitPeers = () => events.emit("peers", peers());
-  awareness.on("change", emitPeers);
-  const provider = options.provider({ doc, awareness, roomId });
-  const clearTimeoutTimer = () => {
-    if (timeout !== null) clearTimeout(timeout);
-    timeout = null;
-  };
-  provider.on("status", (status) => {
-    clearTimeoutTimer();
-    events.emit("status", status);
-    if (status === "connecting")
-      timeout = setTimeout(() => {
-        events.emit("error", new Error("Collaboration connection timed out"));
-        events.emit("status", "error");
-      }, options.connectionTimeoutMs ?? CONNECTION_TIMEOUT_MS);
-    if (status === "connected") gate.arm();
-  });
-  provider.on("synced", (synced) => {
-    events.emit("synced", synced);
-    if (synced) gate.open();
-  });
-  provider.on("error", (error) => events.emit("error", error));
-  const heartbeatMs = options.heartbeatMs ?? PRESENCE_HEARTBEAT_MS;
-  const heartbeat = heartbeatMs > 0 ? setInterval(() => {
-    publisher.flush();
-    emitPeers();
-  }, heartbeatMs) : null;
-  heartbeat?.unref?.();
-  const departure = createDepartureChannel(roomId, awareness);
-  const leave = () => {
-    departure.announce();
-    publisher.dispose();
-    awareness.setLocalState(null);
-    provider.disconnect();
-  };
-  const unregisterTeardown = options.teardown ? registerTeardown({
-    leave,
-    rejoin: () => {
-      publisher.flush();
-      provider.connect();
+  const unregisterTeardown = options.teardown ? registerTeardown({
+    leave,
+    rejoin: () => {
+      publisher.flush();
+      provider.connect();
     },
     ...typeof options.teardown === "object" ? options.teardown : {}
   }) : () => {
@@ -1378,4 +1104,378 @@ function trimTrailingSlashes(value) {
   return value.slice(0, end);
 }
 
-export { BROADCAST_THROTTLE_MS, BoundedMap, COLLABORATION_ROLES, COLLAB_LEAVE_MESSAGE, CONNECTION_TIMEOUT_MS, CURSOR_PALETTE, DEFAULT_COLOR, DEFAULT_MAX_PACKAGE_BYTES, DEPARTURE_CHANNEL, Emitter, INITIAL_SYNC_GRACE_MS, IdempotencyCache, LEGACY_PPTX_DEPARTURE_CHANNEL, LEGACY_PPTX_LEAVE_MESSAGE, LOCAL_ORIGIN, MAX_LABEL_CHARS, MAX_UPDATE_BYTES, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, PRESENCE_FIELD, PRESENCE_HEARTBEAT_MS, STALE_PRESENCE_MS, SequenceTracker, adaptYjsProvider, applyUpdateSafe, asSelectionIds, assignUserColor, bindDocument, borrowAwareness, buildRoster, canBroadcast, canWrite, clampCoordinate, classifyVersion, clearLocalAwareness, createAssetSync, createBroadcastTransport, createClientId, createCollabSession, createDepartureChannel, createIdGenerator, createMemoryHub, createPresencePublisher, createSyncGate, createTransportProvider, createWebSocketTransport, deriveCanvasPresence, derivePresence, encodeDiff, encodeSnapshot, encodeStateVector2 as encodeStateVector, formatCursorLabel, freezeDeep, fromBase64, getUserInitials, isMixedContentBlocked, isNonNegativeSafeInteger, isPresenceFresh, isValidId, isValidRoomId, mergeUpdates2 as mergeUpdates, observeExternalSession, packageAdapter, presenceToCursors, randomToken, registerTeardown, removeAwarenessStatesLocally, restoreSnapshot, roomUrl, sanitizeAvatarUrl, sanitizeCanvasPayload, sanitizeColor, sanitizeIdentity, sanitizeIndex, sanitizeRole, sanitizeUserName, shouldAutoFollowBroadcaster, shouldRoomReplaceLoad, stripHtmlTags, toBase64, transportProvider, validateDisplayName, validateRoomId, validateUpdate };
+// collab/embedding.ts
+var COLLABORATION_CHANGE_EVENT = "collaboration-change";
+var COLLABORATION_OFF_STATE = Object.freeze({
+  active: false,
+  roomId: void 0,
+  status: "off",
+  synced: false,
+  people: []
+});
+var INVALID_ROOM_MESSAGE = "Use 1 to 128 letters, digits, hyphens or underscores for the room name.";
+var NO_BROADCAST_MESSAGE = "This browser cannot share between windows; pass a server URL.";
+function openCollaborationSession(options, defaults) {
+  if (options.session) return { session: options.session, owned: false };
+  const roomId = options.roomId ?? "";
+  if (!isValidRoomId(roomId)) throw new Error(INVALID_ROOM_MESSAGE);
+  let provider = options.provider;
+  if (!provider && options.serverUrl)
+    provider = transportProvider({
+      transport: createWebSocketTransport({ url: roomUrl(options.serverUrl, roomId) })
+    });
+  if (!provider) {
+    if (!canBroadcast()) throw new Error(NO_BROADCAST_MESSAGE);
+    provider = transportProvider({
+      transport: createBroadcastTransport({ roomId, prefix: defaults.broadcastPrefix })
+    });
+  }
+  const user = options.user ?? {};
+  const session = createCollabSession({
+    roomId,
+    provider,
+    user: {
+      name: user.name || defaults.defaultName,
+      ...user.color ? { color: user.color } : {},
+      ...user.avatar ? { avatar: user.avatar } : {},
+      ...user.role ? { role: user.role } : {}
+    },
+    ...defaults.initialPresence ? { initialPresence: defaults.initialPresence } : {},
+    ...defaults.sanitizePayload ? { sanitizePayload: defaults.sanitizePayload } : {},
+    teardown: true
+  });
+  return { session, owned: true };
+}
+function collaborationStateOf(session) {
+  return {
+    active: true,
+    roomId: session.roomId,
+    status: session.status,
+    synced: session.synced,
+    people: [
+      {
+        clientId: session.clientId,
+        name: session.identity.userName,
+        color: session.identity.userColor,
+        self: true
+      },
+      ...session.peers().map((peer) => ({
+        clientId: peer.clientId,
+        name: peer.userName,
+        color: peer.userColor,
+        self: false
+      }))
+    ]
+  };
+}
+function onCollaborationStateChange(session, listener) {
+  const stops = [
+    session.on("status", listener),
+    session.on("synced", listener),
+    session.on("peers", listener)
+  ];
+  return () => {
+    for (const stop of stops) stop();
+  };
+}
+function toExternalSession(session) {
+  let snapshot = { status: session.status, synced: false };
+  return {
+    doc: session.doc,
+    awareness: session.awareness,
+    getSnapshot: () => {
+      const status = session.status;
+      const synced = session.synced || session.gate.isOpen();
+      if (snapshot.status !== status || snapshot.synced !== synced) snapshot = { status, synced };
+      return snapshot;
+    },
+    subscribe: (listener) => {
+      const stops = [
+        session.on("status", listener),
+        session.on("synced", listener),
+        session.on("ready", listener)
+      ];
+      return () => {
+        for (const stop of stops) stop();
+      };
+    }
+  };
+}
+
+// collab/external-provider.ts
+function adaptYjsProvider(provider) {
+  const events = new Emitter();
+  let destroyed = false;
+  let status = provider.wsconnected || provider.connected ? "connected" : provider.wsconnecting ? "connecting" : "disconnected";
+  let synced = Boolean(provider.synced);
+  const subscriptions = [];
+  const listen = (name, handler) => {
+    const wrapped = handler;
+    provider.on(name, wrapped);
+    subscriptions.push([name, wrapped]);
+  };
+  const setStatus = (next) => {
+    if (destroyed || next === status) return;
+    status = next;
+    events.emit("status", next);
+  };
+  const setSynced = (next) => {
+    if (destroyed || next === synced) return;
+    synced = next;
+    events.emit("synced", next);
+  };
+  listen("status", (payload) => {
+    if (typeof payload.connected === "boolean") {
+      if (!payload.connected) setSynced(false);
+      return setStatus(payload.connected ? "connected" : "disconnected");
+    }
+    if (payload.status === "connected" || payload.status === "connecting")
+      setStatus(payload.status);
+    else if (payload.status === "disconnected") {
+      setSynced(false);
+      setStatus("disconnected");
+    }
+  });
+  const onSync = (value) => setSynced(typeof value === "boolean" ? value : value.synced === true);
+  listen("sync", onSync);
+  listen("synced", onSync);
+  listen("connection-error", (cause) => {
+    if (destroyed) return;
+    setStatus("error");
+    events.emit("error", cause instanceof Error ? cause : new Error("Provider connection error"));
+  });
+  return {
+    get status() {
+      return status;
+    },
+    get synced() {
+      return synced;
+    },
+    connect: () => {
+      if (destroyed || status === "connected" || status === "connecting") return;
+      setStatus("connecting");
+      provider.connect?.();
+    },
+    disconnect: () => {
+      if (destroyed) return;
+      provider.disconnect?.();
+      setSynced(false);
+      setStatus("disconnected");
+    },
+    destroy: () => {
+      if (destroyed) return;
+      setSynced(false);
+      setStatus("disconnected");
+      destroyed = true;
+      for (const [name, handler] of subscriptions) provider.off?.(name, handler);
+      subscriptions.length = 0;
+      events.clear();
+      provider.destroy?.();
+    },
+    on: (event, listener) => events.on(event, listener)
+  };
+}
+function observeExternalSession(session, onSnapshot) {
+  let active = true;
+  let subscribing = true;
+  let previous;
+  let unsubscribe;
+  const notify = () => {
+    if (!active || subscribing) return;
+    const snapshot = session.getSnapshot();
+    if (previous?.status === snapshot.status && previous.synced === snapshot.synced) return;
+    previous = { status: snapshot.status, synced: snapshot.synced };
+    onSnapshot(previous);
+  };
+  const dispose = () => {
+    if (!active) return;
+    active = false;
+    unsubscribe?.();
+  };
+  try {
+    unsubscribe = session.subscribe(notify);
+    subscribing = false;
+    notify();
+  } catch (error) {
+    dispose();
+    throw error;
+  }
+  return dispose;
+}
+
+// collab/memory-transport.ts
+function createMemoryHub(options = {}) {
+  const rooms = /* @__PURE__ */ new Map();
+  let nextId = 0;
+  const deliver = (task) => {
+    if (options.async) queueMicrotask(task);
+    else task();
+  };
+  return {
+    size: (roomId) => rooms.get(roomId)?.size ?? 0,
+    createTransport(roomId) {
+      const id = nextId++;
+      let endpoint = null;
+      const peers = () => {
+        let room = rooms.get(roomId);
+        if (!room) rooms.set(roomId, room = /* @__PURE__ */ new Set());
+        return room;
+      };
+      return {
+        get connected() {
+          return endpoint !== null;
+        },
+        connect(handlers) {
+          if (endpoint) peers().delete(endpoint);
+          const self = { id, handlers };
+          const others = [...peers()];
+          peers().add(self);
+          endpoint = self;
+          deliver(() => {
+            if (endpoint !== self) return;
+            handlers.open();
+            for (const other of others) other.handlers.peer?.();
+          });
+        },
+        send(data) {
+          const self = endpoint;
+          if (!self || options.filter && !options.filter(data, id)) return;
+          for (const other of [...peers()])
+            if (other !== self) deliver(() => other.handlers.message(data.slice()));
+        },
+        disconnect() {
+          const self = endpoint;
+          if (!self) return;
+          endpoint = null;
+          peers().delete(self);
+          self.handlers.close("disconnected");
+        }
+      };
+    }
+  };
+}
+
+// collab/package-adapter.ts
+var DEFAULT_MAX_PACKAGE_BYTES = 32 * 1024 * 1024;
+function packageAdapter(options = {}) {
+  const name = options.name ?? "package";
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_PACKAGE_BYTES;
+  const map = (doc) => doc.getMap(name);
+  const check = (bytes) => {
+    if (!(bytes instanceof Uint8Array)) throw new Error("The shared package is not binary data.");
+    if (bytes.byteLength > maxBytes)
+      throw new Error(`The shared package exceeds ${Math.round(maxBytes / 1024 / 1024)} MiB.`);
+    return bytes;
+  };
+  return {
+    isEmpty: (doc) => !(map(doc).get("bytes") instanceof Uint8Array),
+    read: (doc) => {
+      const shared = map(doc);
+      const revision = shared.get("revision");
+      return {
+        bytes: check(shared.get("bytes")).slice(),
+        revision: typeof revision === "number" && Number.isSafeInteger(revision) ? revision : 0
+      };
+    },
+    write: (doc, model, origin) => {
+      const bytes = check(model.bytes);
+      doc.transact(() => {
+        const shared = map(doc);
+        const current = shared.get("revision");
+        const revision = Math.max(model.revision, typeof current === "number" ? current : 0) + 1;
+        shared.set("bytes", bytes.slice());
+        shared.set("revision", revision);
+      }, origin);
+    },
+    observe: (doc, onChange) => {
+      const shared = map(doc);
+      const handler = (event) => {
+        if (event.keysChanged.has("bytes")) onChange(event.transaction.origin);
+      };
+      shared.observe(handler);
+      return () => shared.unobserve(handler);
+    }
+  };
+}
+
+// collab/ordering.ts
+function classifyVersion(messageVersion, currentVersion) {
+  if (!isNonNegativeSafeInteger(messageVersion) || !isNonNegativeSafeInteger(currentVersion))
+    return "invalid";
+  if (messageVersion < currentVersion) return "stale";
+  return messageVersion > currentVersion ? "out-of-order" : "apply";
+}
+var BoundedMap = class {
+  constructor(limit) {
+    this.limit = limit;
+    if (!Number.isSafeInteger(limit) || limit < 1) throw new Error("limit must be positive");
+  }
+  limit;
+  entries = /* @__PURE__ */ new Map();
+  get size() {
+    return this.entries.size;
+  }
+  get(key) {
+    return this.entries.get(key);
+  }
+  has(key) {
+    return this.entries.has(key);
+  }
+  set(key, value) {
+    this.entries.delete(key);
+    this.entries.set(key, value);
+    if (this.entries.size > this.limit) {
+      const oldest = this.entries.keys().next();
+      if (!oldest.done) this.entries.delete(oldest.value);
+    }
+  }
+  delete(key) {
+    return this.entries.delete(key);
+  }
+  clear() {
+    this.entries.clear();
+  }
+};
+var IdempotencyCache = class {
+  seen;
+  constructor(limit = 5e3) {
+    this.seen = new BoundedMap(limit);
+  }
+  check(clientId, messageId, fingerprint) {
+    const prior = this.seen.get(`${clientId}\0${messageId}`);
+    if (!prior) return { status: "fresh" };
+    return prior.fingerprint === fingerprint ? { status: "duplicate", value: prior.value } : { status: "reused" };
+  }
+  remember(clientId, messageId, fingerprint, value) {
+    this.seen.set(`${clientId}\0${messageId}`, { fingerprint, value });
+  }
+};
+var SequenceTracker = class {
+  last;
+  constructor(limit = 200) {
+    this.last = new BoundedMap(limit);
+  }
+  /** Classify without recording; call {@link commit} once the message was actually applied. */
+  classify(peerId, sequence, fingerprint) {
+    if (!isNonNegativeSafeInteger(sequence) || sequence < 1) return "invalid";
+    const previous = this.last.get(peerId);
+    if (!previous || sequence > previous.sequence) return "apply";
+    if (sequence < previous.sequence) return "stale";
+    return previous.fingerprint === fingerprint ? "duplicate" : "invalid";
+  }
+  commit(peerId, sequence, fingerprint) {
+    this.last.set(peerId, { sequence, fingerprint });
+  }
+  forget(peerId) {
+    this.last.delete(peerId);
+  }
+};
+function freezeDeep(value) {
+  if (value && typeof value === "object" && !Object.isFrozen(value)) {
+    for (const child of Object.values(value)) freezeDeep(child);
+    Object.freeze(value);
+  }
+  return value;
+}
+
+export { BROADCAST_THROTTLE_MS, BoundedMap, COLLABORATION_CHANGE_EVENT, COLLABORATION_OFF_STATE, COLLABORATION_ROLES, COLLAB_LEAVE_MESSAGE, CONNECTION_TIMEOUT_MS, CURSOR_PALETTE, DEFAULT_COLOR, DEFAULT_MAX_PACKAGE_BYTES, DEPARTURE_CHANNEL, Emitter, INITIAL_SYNC_GRACE_MS, INVALID_ROOM_MESSAGE, IdempotencyCache, LEGACY_PPTX_DEPARTURE_CHANNEL, LEGACY_PPTX_LEAVE_MESSAGE, LOCAL_ORIGIN, MAX_LABEL_CHARS, MAX_UPDATE_BYTES, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, NO_BROADCAST_MESSAGE, PRESENCE_FIELD, PRESENCE_HEARTBEAT_MS, STALE_PRESENCE_MS, SequenceTracker, adaptYjsProvider, applyUpdateSafe, asSelectionIds, assignUserColor, bindDocument, borrowAwareness, buildRoster, canBroadcast, canWrite, clampCoordinate, classifyVersion, clearLocalAwareness, collaborationStateOf, createAssetSync, createBroadcastTransport, createClientId, createCollabSession, createDepartureChannel, createIdGenerator, createMemoryHub, createPresencePublisher, createSyncGate, createTransportProvider, createWebSocketTransport, deriveCanvasPresence, derivePresence, encodeDiff, encodeSnapshot, encodeStateVector2 as encodeStateVector, formatCursorLabel, freezeDeep, fromBase64, getUserInitials, isMixedContentBlocked, isNonNegativeSafeInteger, isPresenceFresh, isValidId, isValidRoomId, mergeUpdates2 as mergeUpdates, observeExternalSession, onCollaborationStateChange, openCollaborationSession, packageAdapter, presenceToCursors, randomToken, registerTeardown, removeAwarenessStatesLocally, restoreSnapshot, roomUrl, sanitizeAvatarUrl, sanitizeCanvasPayload, sanitizeColor, sanitizeIdentity, sanitizeIndex, sanitizeRole, sanitizeUserName, shouldAutoFollowBroadcaster, shouldRoomReplaceLoad, stripHtmlTags, toBase64, toExternalSession, transportProvider, validateDisplayName, validateRoomId, validateUpdate };