playhtml 2.7.0 → 2.9.0

package/dist/main.d.ts

@@ -11,12 +11,19 @@ import { ElementSetupData } from '../../common/src';
 import { EventMessage } from '../../common/src';
 import { MappedTypeDescription } from '@syncedstore/core/types/doc';
 import { ModifierKey } from '../../common/src';
+import { PageDataChannel } from '../../common/src';
 import { PlayerIdentity } from '../../common/src';
 import { PlayerIdentity as PlayerIdentity_2 } from '../../../common/src';
 import { PlayEvent } from '../../common/src';
+import { PresenceAPI } from '../../common/src';
+import { PresenceRoom } from '../../common/src';
 import { RegisteredPlayEvent } from '../../common/src';
 import { TagType } from '../../common/src';
 
+declare function createPageData<T>(name: string, defaultValue: T): PageDataChannel<T>;
+
+declare function createPresenceRoom(name: string): PresenceRoom;
+
 export { Cursor }
 
 declare class CursorClientAwareness {
@@ -40,14 +47,24 @@ declare class CursorClientAwareness {
     private otherUsersWithMessages;
     private cursorPresenceChangeCallbacks;
     private coordinateMode;
+    private zones;
+    private currentZone;
+    private cursorZoneState;
+    private clientIdToStableId;
+    private pendingRemovals;
     constructor(provider: default_2, options?: CursorOptions);
     private initialize;
     private setupAwarenessHandling;
     private syncExistingAwareness;
     private handleAwarenessChange;
+    private hasOtherClientForStableId;
     private rebuildSpatialGrid;
     private checkProximityOptimized;
     private addCursorStyles;
+    private createCursorPositionCallback;
+    private resolveTargetCoords;
+    private applyZoneStyling;
+    private hitTestZones;
     private setupCursorTracking;
     private repositionAllCursors;
     private throttledUpdateCursorAwareness;
@@ -72,6 +89,8 @@ declare class CursorClientAwareness {
     private updateAllCursorVisibility;
     private showAllCursors;
     configure(options: Partial<CursorOptions>): void;
+    registerZone(element: HTMLElement, options?: CursorZoneOptions): void;
+    unregisterZone(elementId: string): void;
     hideCursor(connectionId: string): void;
     showCursor(connectionId: string): void;
     destroy(): void;
@@ -132,6 +151,11 @@ export declare type CursorRoom = "page" | "domain" | "section" | ((context: {
     search: string;
 }) => string);
 
+export declare interface CursorZoneOptions {
+    onCustomCursorRender?: (connectionId: string, element: HTMLElement) => HTMLElement | null;
+    getCursorStyle?: (presence: CursorPresence) => Partial<CSSStyleDeclaration> | Record<string, string>;
+}
+
 declare interface DefaultRoomOptions {
     includeSearch?: boolean;
 }
@@ -283,6 +307,9 @@ export declare interface PlayHTMLComponents {
     registerPlayEventListener: typeof registerPlayEventListener;
     removePlayEventListener: typeof removePlayEventListener;
     cursorClient: CursorClientAwareness | null;
+    presence: PresenceAPI;
+    createPageData: typeof createPageData;
+    createPresenceRoom: typeof createPresenceRoom;
     roomId: string;
     host: string;
     listSharedElements: () => Array<{