ooxml-core 0.2.0

package/dist/collab/lifecycle.d.ts

@@ -0,0 +1,62 @@
+import { type AwarenessStatesLike } from './awareness.js';
+/** `postMessage` payload an embedding page can send into a frame to make it leave its room first. */
+export declare const COLLAB_LEAVE_MESSAGE = "ooxml-core:collab-leave";
+/** BroadcastChannel shared by every session in the browser. */
+export declare const DEPARTURE_CHANNEL = "ooxml-core:collab-departures";
+/** Names used by pptx-viewer before the extraction; pass them to stay wire-compatible. */
+export declare const LEGACY_PPTX_LEAVE_MESSAGE = "pptx-viewer:collab-leave";
+export declare const LEGACY_PPTX_DEPARTURE_CHANNEL = "pptx-viewer:collab-departures";
+export interface TeardownEventLike {
+    readonly persisted?: boolean;
+    readonly data?: unknown;
+}
+export type TeardownListener = (event: TeardownEventLike) => void;
+export interface TeardownWindowLike {
+    addEventListener: (type: string, listener: TeardownListener) => void;
+    removeEventListener: (type: string, listener: TeardownListener) => void;
+}
+export interface TeardownOptions {
+    /** Clear local awareness and destroy the transport. Called at most once per departure. */
+    leave: () => void;
+    /** Re-establish the session after a bfcache restore; also opts into leaving on persisted pagehide. */
+    rejoin?: () => void;
+    /** Borrowed sessions wait for `pagehide`, since `beforeunload` may be cancelled. */
+    leaveOnBeforeUnload?: boolean | (() => boolean);
+    /** Window to listen on; defaults to the ambient `window` when present. */
+    target?: TeardownWindowLike;
+    /** The leave `postMessage` payload type; defaults to {@link COLLAB_LEAVE_MESSAGE}. */
+    leaveMessage?: string;
+}
+/**
+ * Register `pagehide`, `beforeunload`, `pageshow` and `message` listeners that make the local peer
+ * leave its room when the document goes away (tab close, navigation, or an embedder detaching the
+ * frame, which fires `pagehide` but never `beforeunload`). Returns a disposer; a no-op outside a
+ * browser.
+ */
+export declare function registerTeardown(options: TeardownOptions): () => void;
+export interface DepartureNotice {
+    channel: string;
+    roomId: string;
+    clientId: number;
+}
+export interface DepartureChannelLike {
+    postMessage: (message: DepartureNotice) => void;
+    close: () => void;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+}
+export type DepartureChannelFactory = (name: string) => DepartureChannelLike;
+export interface DepartureChannel {
+    /** Announce that this client is leaving. Synchronous on purpose (usable from `pagehide`). */
+    announce: () => void;
+    dispose: () => void;
+}
+/**
+ * Same-browser departure channel: peers announcing their exit are dropped from `awareness` at once
+ * instead of lingering as ghosts until the awareness timeout (y-webrtc broadcasts removals one
+ * microtask too late for a document being destroyed). Cross-device peers still rely on the
+ * transport. A no-op where `BroadcastChannel` is unavailable.
+ */
+export declare function createDepartureChannel(roomId: string, awareness: AwarenessStatesLike, factory?: DepartureChannelFactory, channelName?: string): DepartureChannel;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/collab/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/collab/lifecycle.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,mBAAmB,EAAgC,MAAM,gBAAgB,CAAC;AAExF,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAC9D,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,iCAAiC,CAAC;AAChE,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,6BAA6B,CAAC;AACpE,eAAO,MAAM,6BAA6B,kCAAkC,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB;AACD,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAClE,MAAM,WAAW,kBAAkB;IAClC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC/B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAChD,0EAA0E;IAC1E,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AASD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI,CA0CrE;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACvD;AACD,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,oBAAoB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAChC,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAOD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,EAC9B,OAAO,CAAC,EAAE,uBAAuB,EACjC,WAAW,GAAE,MAA0B,GACrC,gBAAgB,CAyBlB"}

package/dist/collab/memory-transport.d.ts

@@ -0,0 +1,19 @@
+import type { Transport } from './provider.js';
+export interface MemoryTransport extends Transport {
+    /** Whether this endpoint is currently attached to its room. */
+    readonly connected: boolean;
+}
+export interface MemoryHub {
+    /** Create an endpoint for `roomId`; it hears the other endpoints of the same room. */
+    createTransport: (roomId: string) => MemoryTransport;
+    /** Number of connected endpoints in a room. */
+    size: (roomId: string) => number;
+}
+export interface MemoryHubOptions {
+    /** Deliver through `queueMicrotask` instead of synchronously. */
+    async?: boolean;
+    /** Return false to drop a message (simulate loss); receives raw bytes and the sender index. */
+    filter?: (data: Uint8Array, from: number) => boolean;
+}
+export declare function createMemoryHub(options?: MemoryHubOptions): MemoryHub;
+//# sourceMappingURL=memory-transport.d.ts.map

package/dist/collab/memory-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-transport.d.ts","sourceRoot":"","sources":["../../src/collab/memory-transport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,eAAe,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACzB,sFAAsF;IACtF,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,eAAe,CAAC;IACrD,+CAA+C;IAC/C,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACrD;AAOD,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAoDzE"}

package/dist/collab/ordering.d.ts

@@ -0,0 +1,53 @@
+export type OrderingStatus = 'apply' | 'duplicate' | 'stale' | 'out-of-order' | 'invalid';
+/**
+ * Compare a message's base version with the receiver's current version. Authority-ordered streams
+ * must be applied strictly in order: older is `stale` (already seen), newer is `out-of-order`
+ * (a gap: the receiver must fetch the missing versions first).
+ */
+export declare function classifyVersion(messageVersion: number, currentVersion: number): 'apply' | 'stale' | 'out-of-order' | 'invalid';
+/** A Map that forgets its oldest entries beyond `limit`, keeping memory bounded in long sessions. */
+export declare class BoundedMap<K, V> {
+    private readonly limit;
+    private readonly entries;
+    constructor(limit: number);
+    get size(): number;
+    get(key: K): V | undefined;
+    has(key: K): boolean;
+    set(key: K, value: V): void;
+    delete(key: K): boolean;
+    clear(): void;
+}
+/**
+ * Idempotency cache for request/ack protocols: a retried message with the same id and the same
+ * content is a `duplicate` (replay the earlier result), the same id with different content is
+ * `reused` (a client bug or an attack), anything else is `fresh`.
+ */
+export declare class IdempotencyCache<V = undefined> {
+    private readonly seen;
+    constructor(limit?: number);
+    check(clientId: string, messageId: string, fingerprint: string): {
+        status: 'fresh';
+    } | {
+        status: 'duplicate';
+        value: V;
+    } | {
+        status: 'reused';
+    };
+    remember(clientId: string, messageId: string, fingerprint: string, value: V): void;
+}
+/**
+ * Per-peer monotonic sequence tracker for transient streams such as presence: a lower sequence is
+ * `stale`, an equal one is a `duplicate` of the same content or `invalid` when the content differs
+ * (sequence reuse), and a higher one is accepted and remembered.
+ */
+export declare class SequenceTracker {
+    private readonly last;
+    constructor(limit?: number);
+    /** Classify without recording; call {@link commit} once the message was actually applied. */
+    classify(peerId: string, sequence: number, fingerprint: string): OrderingStatus;
+    commit(peerId: string, sequence: number, fingerprint: string): void;
+    forget(peerId: string): void;
+}
+/** Recursively freeze a JSON-like value so a retained envelope cannot be mutated by a transport. */
+export declare function freezeDeep<T>(value: T): T;
+//# sourceMappingURL=ordering.d.ts.map

package/dist/collab/ordering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.d.ts","sourceRoot":"","sources":["../../src/collab/ordering.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,CAAC;AAE1F;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACpB,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,CAKhD;AAED,qGAAqG;AACrG,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;gBACd,KAAK,EAAE,MAAM;IAG1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAG1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAGpB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQ3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAGvB,KAAK,IAAI,IAAI;CAGb;AAED;;;;GAIG;AACH,qBAAa,gBAAgB,CAAC,CAAC,GAAG,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwD;gBACjE,KAAK,SAAQ;IAGzB,KAAK,CACJ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IAOjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;CAGlF;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgE;gBACzE,KAAK,SAAM;IAGvB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc;IAO/E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAGnE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAG5B;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMzC"}

package/dist/collab/policy.d.ts

@@ -0,0 +1,39 @@
+import type { CollaborationRole } from './identity.js';
+/**
+ * Grace period (ms) before the first local write when the provider has not signalled initial sync.
+ * WebSocket providers emit `synced` reliably; WebRTC only syncs once a peer is present, so a lone
+ * fresh-room peer seeds the document after this delay. Gating the first write prevents a late
+ * joiner's bootstrap document from merging into a room whose real content has not arrived.
+ */
+export declare const INITIAL_SYNC_GRACE_MS = 3000;
+export interface SyncGate {
+    isOpen: () => boolean;
+    /** (Re)start the grace timer that opens the gate without a sync event. */
+    arm: () => void;
+    /** Open now (the provider confirmed its initial sync). Idempotent. */
+    open: () => void;
+    /** Close and cancel the grace timer (teardown). */
+    reset: () => void;
+}
+/** First-write gate. `onOpen` fires once per session (until `reset`). */
+export declare function createSyncGate(onOpen: () => void, graceMs?: number): SyncGate;
+/**
+ * Why a content load ran: `bootstrap` (the document the host mounted the viewer with, or a session
+ * restore; nobody chose it during the session) or `user` (File > Open, a drop, a host API call).
+ */
+export type LoadOrigin = 'bootstrap' | 'user';
+/**
+ * Whether the room's content should replace the document that just loaded. Only a bootstrap load
+ * into a non-empty room loses: opening a file is an act of authorship and is published instead.
+ * An unknown origin defaults to `user`, which keeps the document rather than dropping it.
+ */
+export declare function shouldRoomReplaceLoad(origin: LoadOrigin | undefined, roomIsNonEmpty: boolean): boolean;
+/**
+ * Broadcast sessions have one presenter (`owner`). Auto-follow is one-way: only a local `viewer` is
+ * pulled along to the owner's location; collaborators and the owner navigate freely.
+ */
+export declare function shouldAutoFollowBroadcaster(input: {
+    localRole: CollaborationRole | undefined;
+    broadcasterRole: CollaborationRole | undefined;
+}): boolean;
+//# sourceMappingURL=policy.d.ts.map

package/dist/collab/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/collab/policy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,IAAI,EAClB,OAAO,GAAE,MAA8B,GACrC,QAAQ,CAyBV;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,cAAc,EAAE,OAAO,GACrB,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,SAAS,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzC,eAAe,EAAE,iBAAiB,GAAG,SAAS,CAAC;CAC/C,GAAG,OAAO,CAEV"}

package/dist/collab/presence.d.ts

@@ -0,0 +1,61 @@
+import { type CollaborationRole } from './identity.js';
+/** The awareness field every client publishes its presence under. */
+export declare const PRESENCE_FIELD = "presence";
+/** Presence entries older than this (ms) are dropped as stale. */
+export declare const STALE_PRESENCE_MS = 30000;
+/** Heartbeat interval (ms): re-publish presence so peers do not time us out. */
+export declare const PRESENCE_HEARTBEAT_MS = 10000;
+/** Minimum interval (ms) between outgoing presence broadcasts. */
+export declare const BROADCAST_THROTTLE_MS = 50;
+/** Identity fields fixed for the lifetime of a session. */
+export interface PresenceIdentity {
+    userName: string;
+    userColor: string;
+    userAvatar?: string | undefined;
+    role?: CollaborationRole | undefined;
+}
+/** A sanitised remote collaborator: identity plus product specific payload `T`. */
+export type RemotePresence<T extends object = object> = PresenceIdentity & {
+    clientId: number;
+    lastUpdated: string;
+} & T;
+/** Sanitise the identity part of a raw awareness presence entry. */
+export declare function sanitizeIdentity(raw: Record<string, unknown>): PresenceIdentity;
+/** True when `lastUpdated` is parseable and within `staleMs` of `now`. */
+export declare function isPresenceFresh(lastUpdated: string, now?: number, staleMs?: number): boolean;
+export interface DerivePresenceOptions {
+    now?: number;
+    staleMs?: number;
+}
+/**
+ * Derive the remote presence list from an awareness state map: skips the local client and entries
+ * without a `presence` object, sanitises identity, lets `sanitizePayload` validate the product
+ * payload (return `null` to drop the entry), and drops stale entries.
+ */
+export declare function derivePresence<T extends object>(states: ReadonlyMap<number, Record<string, unknown>>, localClientId: number | undefined, sanitizePayload: (raw: Record<string, unknown>) => T | null, options?: DerivePresenceOptions): RemotePresence<T>[];
+/** Cursor position in unscaled canvas pixels plus the active page (slide) and selection. */
+export interface CanvasPayload {
+    activeSlideIndex: number;
+    cursorX: number;
+    cursorY: number;
+    selectedElementId?: string | undefined;
+}
+export type CanvasPresence = RemotePresence<CanvasPayload>;
+/** Sanitise the canvas payload, clamping the cursor to the canvas bounds plus a small margin. */
+export declare function sanitizeCanvasPayload(raw: Record<string, unknown>, canvasWidth: number, canvasHeight: number): CanvasPayload;
+/** `derivePresence` specialised to the canvas payload. */
+export declare function deriveCanvasPresence(states: ReadonlyMap<number, Record<string, unknown>>, localClientId: number | undefined, canvasWidth: number, canvasHeight: number, options?: DerivePresenceOptions): CanvasPresence[];
+/** A remote collaborator's cursor, render ready. */
+export interface RemoteCursor {
+    clientId: number | string;
+    userName: string;
+    color: string;
+    x: number;
+    y: number;
+    selectionIds?: string[];
+}
+/** Project canvas presence to cursors, optionally only those on `activeSlideIndex`. */
+export declare function presenceToCursors(presence: readonly CanvasPresence[], activeSlideIndex?: number): RemoteCursor[];
+/** Coerce an unknown awareness value into a string-id array, dropping non-strings. */
+export declare function asSelectionIds(value: unknown): string[];
+//# sourceMappingURL=presence.d.ts.map

package/dist/collab/presence.d.ts.map

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

package/dist/collab/provider.d.ts

@@ -0,0 +1,55 @@
+import type * as Y from 'yjs';
+import type { Awareness } from 'y-protocols/awareness';
+/** Connection lifecycle shared by every provider. */
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+/** Maximum time (ms) to wait for an initial connection before giving up. */
+export declare const CONNECTION_TIMEOUT_MS = 30000;
+/** Callbacks a transport invokes; supplied by the provider on every `connect`. */
+export interface TransportHandlers {
+    /** The channel is usable (also after every automatic reconnect). */
+    open: () => void;
+    /** The channel closed; the transport may reconnect and call `open` again. */
+    close: (reason?: string) => void;
+    /** A binary message arrived. */
+    message: (data: Uint8Array) => void;
+    /** A non-fatal failure (refused socket, mixed content, send error). */
+    error: (error: Error) => void;
+    /**
+     * Mesh transports only: another peer joined the room. The provider answers with a sync handshake
+     * and its awareness so the newcomer learns our state (star transports get that from the server).
+     */
+    peer?: () => void;
+}
+/** A bidirectional, ordered-enough byte channel. Reconnect policy belongs to the transport. */
+export interface Transport {
+    connect: (handlers: TransportHandlers) => void;
+    /** Send to the room. Silently dropped while closed; the provider re-syncs on the next `open`. */
+    send: (data: Uint8Array) => void;
+    /** Close and stop any reconnect attempts. */
+    disconnect: () => void;
+}
+export interface ProviderEvents {
+    status: ConnectionStatus;
+    /** True once the initial state exchange completed for the current connection. */
+    synced: boolean;
+    /** A rejected inbound message, a transport failure. The provider keeps running. */
+    error: Error;
+}
+/** Everything a session needs from a sync backend. */
+export interface SyncProvider {
+    readonly status: ConnectionStatus;
+    readonly synced: boolean;
+    connect: () => void;
+    disconnect: () => void;
+    /** Release every listener and timer; the provider cannot be reused. */
+    destroy: () => void;
+    on: <K extends keyof ProviderEvents>(event: K, listener: (payload: ProviderEvents[K]) => void) => () => void;
+}
+export interface ProviderContext {
+    doc: Y.Doc;
+    awareness: Awareness;
+    roomId: string;
+}
+/** Factory a session calls once with the document and awareness it owns. */
+export type ProviderFactory = (context: ProviderContext) => SyncProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/collab/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/collab/provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAErF,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IACjC,oEAAoE;IACpE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,gCAAgC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,uEAAuE;IACvE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC/C,iGAAiG;IACjG,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACjC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,KAAK,CAAC;CACb;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,KAC1C,MAAM,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,YAAY,CAAC"}

package/dist/collab/session.d.ts

@@ -0,0 +1,70 @@
+import { Awareness } from 'y-protocols/awareness';
+import * as Y from 'yjs';
+import { type CollaborationRole } from './identity.js';
+import { type TeardownOptions } from './lifecycle.js';
+import { type SyncGate } from './policy.js';
+import { type PresenceIdentity, type RemotePresence } from './presence.js';
+import { type ConnectionStatus, type ProviderFactory, type SyncProvider } from './provider.js';
+export interface SessionOptions<P extends object = object> {
+    roomId: string;
+    provider: ProviderFactory;
+    user: {
+        name: string;
+        /** Defaults to a stable palette colour derived from the client id. */
+        color?: string;
+        avatar?: string;
+        role?: CollaborationRole;
+    };
+    /** Bring your own document (for example one a viewer already populated). */
+    doc?: Y.Doc;
+    /** The local "where am I" payload published with the identity. */
+    initialPresence?: P;
+    /** Validate a remote payload; return `null` to hide that peer. Defaults to accepting `{}`. */
+    sanitizePayload?: (raw: Record<string, unknown>) => P | null;
+    /** Start connecting immediately. Default true. */
+    autoConnect?: boolean;
+    connectionTimeoutMs?: number;
+    /** Fallback gate opening for transports that never signal sync (mesh). Default 3 s. */
+    syncGraceMs?: number;
+    /** Called once when local writes become allowed; seed the document here. */
+    onReady?: (state: {
+        synced: boolean;
+    }) => void;
+    /** Register pagehide/beforeunload leave handling and the same-browser departure channel. */
+    teardown?: boolean | Pick<TeardownOptions, 'target' | 'leaveOnBeforeUnload' | 'leaveMessage'>;
+    /** Heartbeat (ms) that republishes presence and ages out stale peers. Default 10 s; 0 disables. */
+    heartbeatMs?: number;
+}
+export interface SessionEvents<P extends object> {
+    status: ConnectionStatus;
+    synced: boolean;
+    /** The remote presence list changed (join, leave, move, staleness). */
+    peers: RemotePresence<P>[];
+    /** Local writes just became allowed (once per connection epoch). */
+    ready: undefined;
+    error: Error;
+}
+export interface CollabSession<P extends object = object> {
+    readonly roomId: string;
+    readonly doc: Y.Doc;
+    readonly awareness: Awareness;
+    readonly clientId: number;
+    readonly role: CollaborationRole | undefined;
+    readonly identity: PresenceIdentity;
+    readonly gate: SyncGate;
+    readonly provider: SyncProvider;
+    readonly status: ConnectionStatus;
+    readonly synced: boolean;
+    /** Writes are allowed: the gate opened (synced, or the grace period passed), not a viewer, not destroyed. */
+    canWrite: () => boolean;
+    peers: () => RemotePresence<P>[];
+    /** Merge a patch into the published local presence payload (throttled). */
+    updatePresence: (patch: Partial<P>) => void;
+    on: <K extends keyof SessionEvents<P>>(event: K, listener: (payload: SessionEvents<P>[K]) => void) => () => void;
+    connect: () => void;
+    disconnect: () => void;
+    /** Leave the room and release everything; a session created with `doc` leaves that doc alive. */
+    destroy: () => void;
+}
+export declare function createCollabSession<P extends object = object>(options: SessionOptions<P>): CollabSession<P>;
+//# sourceMappingURL=session.d.ts.map

package/dist/collab/session.d.ts.map

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

package/dist/collab/transport-provider.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderContext, SyncProvider, Transport } from './provider.js';
+export declare const MESSAGE_SYNC = 0;
+export declare const MESSAGE_AWARENESS = 1;
+export declare const MESSAGE_QUERY_AWARENESS = 3;
+export interface TransportProviderOptions {
+    transport: Transport;
+    /** Reject inbound messages larger than this. Default 32 MiB. */
+    maxMessageBytes?: number;
+}
+/** Create the provider factory for a session: `provider: transportProvider({ transport })`. */
+export declare function transportProvider(options: TransportProviderOptions): (context: ProviderContext) => SyncProvider;
+export declare function createTransportProvider({ doc, awareness }: ProviderContext, { transport, maxMessageBytes }: TransportProviderOptions): SyncProvider;
+//# sourceMappingURL=transport-provider.d.ts.map

package/dist/collab/transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-provider.d.ts","sourceRoot":"","sources":["../../src/collab/transport-provider.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEX,eAAe,EAEf,YAAY,EACZ,SAAS,EACT,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAKzC,MAAM,WAAW,wBAAwB;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,wBAAwB,GAC/B,CAAC,OAAO,EAAE,eAAe,KAAK,YAAY,CAE5C;AAED,wBAAgB,uBAAuB,CACtC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,eAAe,EACnC,EAAE,SAAS,EAAE,eAAkC,EAAE,EAAE,wBAAwB,GACzE,YAAY,CA8Kd"}

package/dist/collab/validation.d.ts

@@ -0,0 +1,38 @@
+/** Fallback cursor/label colour when none is supplied or it fails validation. */
+export declare const DEFAULT_COLOR = "#4c8bf5";
+/** True when `roomId` is a safe 1-128 char alphanumeric/`-`/`_` token. */
+export declare function isValidRoomId(roomId: unknown): roomId is string;
+/** Return `roomId` when valid, throw otherwise. */
+export declare function validateRoomId(roomId: string): string;
+/** True for a non-empty string of at most `max` characters (session, client and batch ids). */
+export declare function isValidId(value: unknown, max?: number): value is string;
+/** True for a non-negative safe integer (versions, sequence numbers, offsets). */
+export declare function isNonNegativeSafeInteger(value: unknown): value is number;
+/**
+ * Remove HTML tags in a single linear pass with no regex backtracking. Tracking open/closed tag
+ * state while walking the string means nested or overlapping `<`/`>` sequences (`<scr<script>ipt>`)
+ * can never leave a live tag behind, and there is no polynomial ReDoS on many unmatched `<`.
+ */
+export declare function stripHtmlTags(text: string): string;
+/** Strip HTML tags, trim, and clamp to 64 characters; falls back to `fallback`. */
+export declare function sanitizeUserName(name: unknown, fallback?: string): string;
+/**
+ * Strict profile-name check for hosts that prefer rejection over repair: 1 to 80 printable
+ * characters. Returns the trimmed name or throws.
+ */
+export declare function validateDisplayName(name: string): string;
+/** Validate a 6-digit hex colour; returns `fallback` when invalid. */
+export declare function sanitizeColor(color: unknown, fallback?: string): string;
+/** Allow only http(s)/data: avatar URLs; otherwise `undefined`. */
+export declare function sanitizeAvatarUrl(url: unknown): string | undefined;
+/** Coerce to a non-negative integer index (slide, page, sheet). */
+export declare function sanitizeIndex(value: unknown): number;
+/** Clamp a coordinate to `[min - margin, max + margin]`; non-finite input becomes 0. */
+export declare function clampCoordinate(value: unknown, min: number, max: number, margin?: number): number;
+/**
+ * True when connecting to `serverUrl` would be blocked as mixed content: an insecure `ws://` socket
+ * opened from a secure `https:` page. Loopback hosts are exempt. `pageProtocol` defaults to the
+ * ambient `location.protocol` when there is one (no DOM types are required).
+ */
+export declare function isMixedContentBlocked(serverUrl: string, pageProtocol?: string | undefined): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/collab/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/collab/validation.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,eAAO,MAAM,aAAa,YAAY,CAAC;AAQvC,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE/D;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,KAAK,IAAI,MAAM,CAEpE;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,SAAc,GAAG,MAAM,CAI9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAEtF;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASlE;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAG7F;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAM,GAAG,SACZ,GACT,OAAO,CAST"}

package/dist/collab/websocket-transport.d.ts

@@ -0,0 +1,33 @@
+import type { Transport } from './provider.js';
+/** The structural slice of `WebSocket` this transport uses. */
+export interface WebSocketLike {
+    binaryType: string;
+    readyState: number;
+    send: (data: Uint8Array) => void;
+    close: () => void;
+    onopen: ((event: unknown) => void) | null;
+    onclose: ((event: {
+        reason?: string;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+}
+export type WebSocketConstructor = new (url: string) => WebSocketLike;
+export interface WebSocketTransportOptions {
+    /** Full URL including the room, for example `wss://host/room-id` (see {@link roomUrl}). */
+    url: string;
+    WebSocket?: WebSocketConstructor;
+    /** First reconnect delay in ms; doubles up to `maxDelayMs`. Default 250. */
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    /** Give up after this many consecutive failed attempts. Default unlimited. */
+    maxRetries?: number;
+    /** Page protocol for the mixed-content check; defaults to the ambient location. */
+    pageProtocol?: string | undefined;
+}
+/** Join a server base URL and a validated room id: `roomUrl('wss://h/collab', 'r1')`. */
+export declare function roomUrl(server: string, roomId: string): string;
+export declare function createWebSocketTransport(options: WebSocketTransportOptions): Transport;
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/collab/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../../src/collab/websocket-transport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,eAAe,CAAC;AAGlE,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACvD;AACD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACzC,2FAA2F;IAC3F,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAID,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,CAuEtF"}

package/dist/color/color-linear.d.ts

@@ -0,0 +1,5 @@
+/** An sRGB channel (0-255) as linear light (0-1). */
+export declare function srgb255ToLinear(channel: number): number;
+/** A linear-light channel (0-1) as an sRGB channel (0-255, unrounded). */
+export declare function linearToSrgb255(linear: number): number;
+//# sourceMappingURL=color-linear.d.ts.map

package/dist/color/color-linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-linear.d.ts","sourceRoot":"","sources":["../../src/color/color-linear.ts"],"names":[],"mappings":"AAUA,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD"}