@tumaet/apollon 4.2.23 → 4.4.0

package/dist/apollon-editor.d.ts

@@ -18,6 +18,23 @@ export declare class ApollonEditor {
     private setReactFlowInstance;
     getNodes(): Node[];
     getEdges(): Edge[];
+    getViewport(): {
+        x: number;
+        y: number;
+        zoom: number;
+    } | null;
+    screenToFlowPosition(position: {
+        x: number;
+        y: number;
+    }): import('@xyflow/system').XYPosition | null;
+    flowToScreenPosition(position: {
+        x: number;
+        y: number;
+    }): import('@xyflow/system').XYPosition | null;
+    fitView(options?: {
+        padding?: number;
+        duration?: number;
+    }): void;
     set diagramType(type: UMLDiagramType);
     destroy(): void;
     /**
@@ -36,10 +53,49 @@ export declare class ApollonEditor {
     subscribeToModelChange(callback: (state: Apollon.UMLModel) => void): number;
     subscribeToDiagramNameChange(callback: (diagramTitle: string) => void): number;
     subscribeToAssessmentSelection(callback: (selectedElementIds: string[]) => void): number;
+    subscribeToSelectionChange(callback: (selectedElementIds: string[]) => void): number;
+    subscribeToAwarenessChanges(callback: (states: Map<number, Apollon.CollaborationState>) => void): number;
+    subscribeToCollaboratorChanges(callback: (collaborators: Apollon.CollaboratorInfo[]) => void): number;
     unsubscribe(subscriberId: number): void;
     sendBroadcastMessage(sendFn: SendBroadcastMessage): void;
     receiveBroadcastedMessage(base64Data: string): void;
+    /**
+     * Push the entire local Yjs document to peers. Hosts should call this on
+     * every (re)connect so any edits made while the transport was closed are
+     * absorbed by the room. See `YjsSyncClass.broadcastFullState`.
+     */
+    broadcastFullState(): void;
+    setLocalAwarenessUser(user: Apollon.CollaborationUser): void;
+    setLocalAwarenessCursor(cursor: Apollon.CollaborationCursor | null): void;
+    setLocalAwarenessSelectedElement(selectedElementId: string | null): void;
+    setLocalAwarenessState(state: Partial<Apollon.CollaborationState>): void;
+    getLocalAwarenessClientId(): number;
+    getCollaborators(): Apollon.CollaboratorInfo[];
     updateDiagramTitle(name: string): void;
+    /**
+     * Toggles the editor's read-only state at runtime. Used by hosting apps
+     * to lock the canvas while previewing an immutable snapshot (e.g. the
+     * version-history preview), without tearing down and re-mounting the
+     * editor instance.
+     */
+    setReadonly(readonly: boolean): void;
+    /**
+     * Toggle preview-overlay mode. When `true`, subsequent `model = …`
+     * assignments and other store mutators update the local Zustand caches
+     * (so the canvas displays the overlay) WITHOUT writing to the Yjs
+     * doc — leaving the collaborative document untouched. Yjs observers
+     * also stop propagating peer-driven updates to Zustand, so the overlay
+     * doesn't flicker as collaborators edit the live diagram.
+     *
+     * On flip-off the local Zustand state is rebuilt from the (now
+     * peer-augmented) Yjs maps so the canvas catches up to everything
+     * collaborators committed during the preview.
+     *
+     * Hosts should call `setPreviewMode(true)` before applying a preview
+     * model and `setPreviewMode(false)` on exit. The Yjs doc never needs
+     * to be "restored" from a snapshot because it was never disturbed.
+     */
+    setPreviewMode(active: boolean): void;
     toggleInteractiveElementsMode(forceEnabled?: boolean): void;
     getInteractiveForSerialization(): Apollon.InteractiveElements | undefined;
     getDiagramMetadata(): {
@@ -53,4 +109,5 @@ export declare class ApollonEditor {
     set view(view: Apollon.ApollonView);
     addOrUpdateAssessment(assessment: Apollon.Assessment): void;
     static generateInitialSyncMessage(): string;
+    static generateInitialAwarenessSyncMessage(): string;
 }

package/dist/components/Icon/DragHandleIcon.d.ts

@@ -0,0 +1,4 @@
+import { SVGAttributes } from 'react';
+type Props = SVGAttributes<SVGSVGElement>;
+export declare const DragHandleIcon: ({ width, height, fill, ...props }: Props) => JSX.Element;
+export {};

package/dist/components/Icon/index.d.ts

@@ -11,3 +11,4 @@ export * from './SwapHorizIcon';
 export * from './UndoIcon';
 export * from './ArrowBackIcon';
 export * from './ArrowForwardIcon';
+export * from './DragHandleIcon';

package/dist/index.d.ts

@@ -5,3 +5,6 @@ export * from './utils/versionConverter';
 export * from './utils';
 export { log, setLogLevel, setLogger } from './logger';
 export type { LogLevel } from './logger';
+export { YjsSyncClass, MessageType } from './sync/yjsSyncClass';
+export type { SendBroadcastMessage } from './sync/yjsSyncClass';
+export { createHeadlessSync } from './sync/headless';