@tumaet/apollon 4.3.0 → 4.5.0

package/dist/internals.js

@@ -0,0 +1,40 @@
+import { V as n, aE as r } from "./yjsSync-hZSPGLEP.js";
+import { ab as p, aT as i, aU as u, aV as S, aW as g, aX as T, aY as b, bn as F, bo as l, bp as v } from "./yjsSync-hZSPGLEP.js";
+function V(t = new n()) {
+  const e = () => {
+  }, a = {
+    getState: () => ({
+      updateNodesFromYjs: e,
+      updateEdgesFromYjs: e,
+      updateAssessmentFromYjs: e,
+      updateUndoRedoState: e,
+      undoManager: null
+      // Other DiagramStore fields are typed but never accessed by
+      // YjsSync; cast through `unknown` keeps the helper from
+      // having to enumerate the full surface.
+    }),
+    setState: e,
+    subscribe: () => e,
+    getInitialState: () => ({})
+  }, s = {
+    getState: () => ({ updateMetaDataFromYjs: e }),
+    setState: e,
+    subscribe: () => e,
+    getInitialState: () => ({})
+  }, o = new r(t, a, s);
+  return { ydoc: t, sync: o };
+}
+export {
+  p as MessageType,
+  r as YjsSync,
+  i as convertV2ToV4,
+  u as convertV3EdgeTypeToV4,
+  S as convertV3HandleToV4,
+  g as convertV3MessagesToV4,
+  T as convertV3NodeTypeToV4,
+  b as convertV3ToV4,
+  V as createHeadlessSync,
+  F as isV2Format,
+  l as isV3Format,
+  v as isV4Format
+};

package/dist/react/App.d.ts

@@ -0,0 +1,9 @@
+import { ReactFlowInstance } from '@xyflow/react';
+import { CollaborationAwarenessApi, CollaborationLayerOptions } from './components/collaboration/CollaborationLayer';
+interface AppProps {
+    onReactFlowInit: (instance: ReactFlowInstance) => void;
+    collaboration: CollaborationLayerOptions;
+    awareness: CollaborationAwarenessApi;
+}
+export declare function AppWithProvider(props: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/react/apollon-editor.d.ts

@@ -0,0 +1,112 @@
+import { Node, Edge } from '@xyflow/react';
+import { UMLDiagramType } from './types';
+import { SendBroadcastMessage } from './sync/yjsSync';
+import * as Apollon from "./typings";
+export declare class ApollonEditor {
+    private root;
+    private reactFlowInstance;
+    private readonly syncManager;
+    private readonly ydoc;
+    private readonly diagramStore;
+    private readonly metadataStore;
+    private readonly popoverStore;
+    private readonly assessmentSelectionStore;
+    private readonly alignmentGuidesStore;
+    private readonly edgeGeometryStore;
+    private subscribers;
+    constructor(element: HTMLElement, options?: Apollon.ApollonOptions);
+    private setReactFlowInstance;
+    getNodes(): Node[];
+    getEdges(): Edge[];
+    getViewport(): {
+        x: number;
+        y: number;
+        zoom: number;
+    } | null;
+    screenToFlowPosition(position: {
+        x: number;
+        y: number;
+    }): import('@xyflow/react').XYPosition | null;
+    flowToScreenPosition(position: {
+        x: number;
+        y: number;
+    }): import('@xyflow/react').XYPosition | null;
+    fitView(options?: {
+        padding?: number;
+        duration?: number;
+    }): void;
+    set diagramType(type: UMLDiagramType);
+    destroy(): void;
+    /** Renders a model to SVG via a hidden, off-screen mount. */
+    static exportModelAsSvg(model: Apollon.UMLModel, options?: Apollon.ExportOptions): Promise<Apollon.SVG>;
+    /**
+     * exports current model as svg
+     * @param options options to change the export behavior (add margin, exclude element ...)
+     */
+    exportAsSVG(options?: Apollon.ExportOptions): Promise<Apollon.SVG>;
+    private getNewSubscriptionId;
+    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 `YjsSync.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;
+    /** Live-toggle modeling vs assessment vs exporting mode. */
+    setMode(mode: Apollon.ApollonMode): void;
+    /** Live-toggle whether the canvas captures page scroll. */
+    setScrollLock(scrollLock: 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(): {
+        diagramTitle: string;
+        diagramType: "ClassDiagram" | "ObjectDiagram" | "ActivityDiagram" | "UseCaseDiagram" | "CommunicationDiagram" | "ComponentDiagram" | "DeploymentDiagram" | "PetriNet" | "ReachabilityGraph" | "SyntaxTree" | "Flowchart" | "BPMN" | "Sfc";
+    };
+    get model(): Apollon.UMLModel;
+    set model(model: Apollon.UMLModel);
+    getSelectedElements(): string[];
+    get view(): Apollon.ApollonView;
+    set view(view: Apollon.ApollonView);
+    addOrUpdateAssessment(assessment: Apollon.Assessment): void;
+    static generateInitialSyncMessage(): string;
+    static generateInitialAwarenessSyncMessage(): string;
+}

package/dist/react/components/AlignmentGuides.d.ts

@@ -0,0 +1 @@
+export declare const AlignmentGuides: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/react/components/AssessmentSelectionDebug.d.ts

@@ -0,0 +1 @@
+export declare function AssessmentSelectionDebug(): import("react/jsx-runtime").JSX.Element | null;

package/dist/react/components/CustomBackground.d.ts

@@ -0,0 +1 @@
+export declare const CustomBackground: () => import("react/jsx-runtime").JSX.Element;

package/dist/react/components/CustomControls.d.ts

@@ -0,0 +1 @@
+export declare const CustomControls: () => import("react/jsx-runtime").JSX.Element;

package/dist/react/components/CustomMiniMap.d.ts

@@ -0,0 +1 @@
+export declare const CustomMiniMap: () => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/Icon/ArrowBackIcon.d.ts

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

package/dist/{components → react/components}/Icon/ArrowForwardIcon.d.ts

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

package/dist/{components → react/components}/Icon/CheckIcon.d.ts

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

package/dist/{components → react/components}/Icon/CrossIcon.d.ts

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

package/dist/{components → react/components}/Icon/DeleteIcon.d.ts

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

package/dist/react/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) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/{components → react/components}/Icon/EditIcon.d.ts

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

package/dist/{components → react/components}/Icon/ExclamationIcon.d.ts

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

package/dist/{components → react/components}/Icon/InfiniteIcon.d.ts

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

package/dist/{components → react/components}/Icon/MapIcon.d.ts

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

package/dist/{components → react/components}/Icon/PaintRollerIcon.d.ts

@@ -1,2 +1,2 @@
 import { SVGAttributes } from 'react';
-export declare const PaintRollerIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => JSX.Element;
+export declare const PaintRollerIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/Icon/RedoIcon.d.ts

@@ -1,2 +1,2 @@
 import { SVGAttributes } from 'react';
-export declare const RedoIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => JSX.Element;
+export declare const RedoIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/Icon/SouthEastArrowIcon.d.ts

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

package/dist/{components → react/components}/Icon/SwapHorizIcon.d.ts

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

package/dist/{components → react/components}/Icon/UndoIcon.d.ts

@@ -1,2 +1,2 @@
 import { SVGAttributes } from 'react';
-export declare const UndoIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => JSX.Element;
+export declare const UndoIcon: ({ width, height, fill, ...props }: SVGAttributes<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/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/react/components/ReconnectConnectionLine.d.ts

@@ -0,0 +1,2 @@
+import { ConnectionLineComponentProps } from '@xyflow/react';
+export declare const ReconnectConnectionLine: ({ connectionLineStyle, connectionLineType, fromX, fromY, toX, toY, fromPosition, toPosition, }: ConnectionLineComponentProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react/components/Sidebar.d.ts

@@ -0,0 +1 @@
+export declare const Sidebar: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/react/components/collaboration/CollaborationLayer.d.ts

@@ -0,0 +1,25 @@
+import { CollaborationCursor, CollaborationState, CollaborationUser, CollaborationViewport, CollaboratorInfo } from '../../typings';
+export type CollaborationAwarenessApi = {
+    setLocalAwarenessCursor: (cursor: CollaborationCursor | null) => void;
+    setLocalAwarenessSelectedElement: (selectedElementId: string | null) => void;
+    setLocalAwarenessViewport: (viewport: CollaborationViewport | null) => void;
+    setLocalAwarenessFollowing: (followingClientId: number | null) => void;
+    getAwarenessStates: () => Map<number, CollaborationState>;
+    subscribeToAwarenessChanges: (callback: (states: Map<number, CollaborationState>) => void) => () => void;
+    subscribeToCollaboratorChanges: (callback: (collaborators: CollaboratorInfo[]) => void) => () => void;
+    getLocalAwarenessClientId: () => number;
+};
+export type CollaborationLayerOptions = {
+    enabled: boolean;
+    user?: CollaborationUser;
+    showPresence: boolean;
+    showCursors: boolean;
+    showSelectionHighlights: boolean;
+    showFollow: boolean;
+};
+type CollaborationLayerProps = {
+    options: CollaborationLayerOptions;
+    awareness: CollaborationAwarenessApi;
+};
+export declare function CollaborationLayer({ options, awareness, }: CollaborationLayerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/{components → react/components}/index.d.ts

@@ -10,7 +10,9 @@ export * from './ui';
 export * from './CustomMiniMap';
 export * from './CustomControls';
 export * from './CustomBackground';
+export * from './ReconnectConnectionLine';
 export * from './wrapper/AssessmentSelectableWrapper';
 export * from './AssessmentSelectionDebug';
 export * from './ScrollOverlay';
 export * from './AlignmentGuides';
+export * from './collaboration/CollaborationLayer';

package/dist/{components → react/components}/popovers/DefaultNodeGiveFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from './types';
-export declare const DefaultNodeGiveFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const DefaultNodeGiveFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/DefaultNodeSeeFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from './types';
-export declare const DefaultNodeSeeFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const DefaultNodeSeeFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/GiveFeedbackAssessmentBox.d.ts

@@ -3,5 +3,5 @@ interface Props {
     name: string;
     type: string;
 }
-export declare const GiveFeedbackAssessmentBox: ({ elementId, name, type }: Props) => JSX.Element;
+export declare const GiveFeedbackAssessmentBox: ({ elementId, name, type }: Props) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/{components → react/components}/popovers/PopoverManager.d.ts

@@ -6,5 +6,5 @@ interface PopoverManagerProps {
     anchorEl: HTMLElement | SVGSVGElement | null;
     type: PopoverType;
 }
-export declare const PopoverManager: ({ elementId, anchorEl, type, }: PopoverManagerProps) => JSX.Element | null;
+export declare const PopoverManager: ({ elementId, anchorEl, type, }: PopoverManagerProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/{components → react/components}/popovers/SeeFeedbackAssessmentBox.d.ts

@@ -2,4 +2,4 @@ export declare const SeeFeedbackAssessmentBox: ({ type, name, elementId, }: {
     type: string;
     name: string;
     elementId: string;
-}) => JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/popovers/bpmnDiagram/BPMNPoolEditPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const BPMNPoolEditPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const BPMNPoolEditPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/classDiagram/ClassGiveFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const ClassGiveFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const ClassGiveFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/classDiagram/ClassSeeFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const ClassSeeFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const ClassSeeFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/communicationDiagram/CommunicationObjectNameGiveFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const CommunicationObjectNameGiveFeedbackPopover: ({ elementId, }: PopoverProps) => JSX.Element | null;
+export declare const CommunicationObjectNameGiveFeedbackPopover: ({ elementId, }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/communicationDiagram/CommunicationObjectNameSeeFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const CommunicationObjectNameSeeFeedbackPopover: ({ elementId, }: PopoverProps) => JSX.Element | null;
+export declare const CommunicationObjectNameSeeFeedbackPopover: ({ elementId, }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/edgePopovers/EdgeGiveFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const EdgeGiveFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const EdgeGiveFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/edgePopovers/EdgeSeeFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const EdgeSeeFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const EdgeSeeFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/objectDiagram/ObjectGiveFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const ObjectGiveFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const ObjectGiveFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/{components → react/components}/popovers/objectDiagram/ObjectSeeFeedbackPopover.d.ts

@@ -1,2 +1,2 @@
 import { PopoverProps } from '../types';
-export declare const ObjectSeeFeedbackPopover: ({ elementId }: PopoverProps) => JSX.Element | null;
+export declare const ObjectSeeFeedbackPopover: ({ elementId }: PopoverProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/react/components/react/Apollon.d.ts

@@ -0,0 +1,45 @@
+import { CSSProperties, ReactNode } from 'react';
+import { ApollonEditor } from '../../apollon-editor';
+import { ApollonCollaborationOptions, ApollonMode, ApollonView, UMLDiagramType, UMLModel } from '../../typings';
+/**
+ * Props for the {@link Apollon} React component.
+ *
+ * - `default*` / `availableViews` / `enablePopups` / `collaborationEnabled` /
+ *   `debug` are **snapshotted on mount** — re-key the component to apply
+ *   changes against a new editor instance.
+ * - `readonly` / `view` / `mode` / `scrollLock` / `previewMode` / `model`
+ *   are **reactive** — applied via the matching `ApollonEditor` setter when
+ *   the prop changes. Passing `undefined` leaves the live value untouched;
+ *   re-key the component to fully reset.
+ */
+export interface ApollonProps {
+    className?: string;
+    /** Inline styles. Needs an explicit non-zero height or the canvas renders blank. */
+    style?: CSSProperties;
+    /** Rendered inside the {@link ApollonInstanceContext} provider alongside the canvas. */
+    children?: ReactNode;
+    defaultModel?: UMLModel;
+    defaultType?: UMLDiagramType;
+    defaultMode?: ApollonMode;
+    defaultView?: ApollonView;
+    availableViews?: ApollonView[];
+    enablePopups?: boolean;
+    collaborationEnabled?: boolean;
+    collaboration?: ApollonCollaborationOptions;
+    debug?: boolean;
+    readonly?: boolean;
+    view?: ApollonView;
+    mode?: ApollonMode;
+    scrollLock?: boolean;
+    /** Local-only preview overlay. See {@link ApollonEditor.setPreviewMode}. */
+    previewMode?: boolean;
+    /** Controlled-model overlay — every change applies via `editor.model = value`. */
+    model?: UMLModel;
+    /**
+     * Called once with the instance after mount. The optional returned function
+     * runs as cleanup before destroy (React-19-style cleanup return).
+     */
+    onMount?: (editor: ApollonEditor) => void | (() => void);
+}
+/** React wrapper around {@link ApollonEditor}. See `@tumaet/apollon/react` docs. */
+export declare const Apollon: import('react').ForwardRefExoticComponent<ApollonProps & import('react').RefAttributes<ApollonEditor | null>>;

package/dist/react/components/react/context.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+import { ApollonEditor } from '../../apollon-editor';
+/** Live {@link ApollonEditor} instance; `null` until the mount effect commits. */
+export declare const ApollonInstanceContext: import('react').Context<ApollonEditor | null>;
+export declare function useApollonEditor(): ApollonEditor | null;
+/** Like {@link useApollonEditor}, but throws when no editor is available. */
+export declare function useApollonEditorOrThrow(): ApollonEditor;
+/**
+ * Make a host-owned {@link ApollonEditor} reachable to descendants via
+ * {@link useApollonEditor}. Use when the host constructs the editor directly
+ * (non-React adapter, test fixture) instead of rendering {@link Apollon}.
+ */
+export declare function ApollonProvider({ editor, children, }: {
+    editor: ApollonEditor;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/react/components/react/useApollonSubscription.d.ts

@@ -0,0 +1,17 @@
+import { ApollonEditor } from '../../apollon-editor';
+/**
+ * Subscribe to a value derived from the {@link ApollonEditor}.
+ *
+ * `getSnapshot` MUST return a referentially stable value when nothing changed;
+ * do not allocate inside it. Returns `undefined` while no editor is mounted
+ * (including during SSR).
+ *
+ * @example
+ * ```tsx
+ * const selection = useApollonSubscription(
+ *   (editor, cb) => editor.subscribeToSelectionChange(cb),
+ *   (editor) => editor.getSelectedElements(),
+ * )
+ * ```
+ */
+export declare function useApollonSubscription<T>(subscribe: (editor: ApollonEditor, cb: (value: T) => void) => number, getSnapshot: (editor: ApollonEditor) => T): T | undefined;

package/dist/{components → react/components}/svgs/edges/InlineMarker.d.ts

@@ -49,7 +49,7 @@ export declare function getPathStartInfo(pathD: string): {
 /**
  * Renders an inline SVG marker at the given position and direction.
  */
-export declare function InlineMarker({ endPoint, direction, markerId, strokeColor, }: MarkerProps): JSX.Element | null;
+export declare function InlineMarker({ endPoint, direction, markerId, strokeColor, }: MarkerProps): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Helper component that renders inline markers for an edge path.
  * Use this alongside BaseEdge (without markerEnd/markerStart props).
@@ -59,4 +59,4 @@ export declare function EdgeInlineMarkers({ pathD, markerEnd, markerStart, strok
     markerEnd?: string;
     markerStart?: string;
     strokeColor?: string;
-}): JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/react/components/svgs/nodes/CustomText.d.ts

@@ -0,0 +1,10 @@
+import { FC, ReactNode, SVGProps } from 'react';
+type Props = Omit<SVGProps<SVGTextElement>, "x" | "y"> & {
+    children: ReactNode;
+    x?: string | number;
+    y?: string | number;
+    noX?: boolean;
+    noY?: boolean;
+};
+export declare const CustomText: FC<Props>;
+export {};

package/dist/{components → react/components}/svgs/nodes/classDiagram/ClassSVG.d.ts

@@ -7,4 +7,4 @@ export interface MinSize {
 export type ClassSVGProps = SVGComponentProps & {
     data: ClassNodeProps;
 };
-export declare const ClassSVG: ({ id, width, height, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, data, }: ClassSVGProps) => JSX.Element;
+export declare const ClassSVG: ({ id, width, height, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, data, }: ClassSVGProps) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/svgs/nodes/classDiagram/ColorDescriptionSVG.d.ts

@@ -7,4 +7,4 @@ export type ColorDescriptionSVGProps = {
     SIDEBAR_PREVIEW_SCALE?: number;
     svgAttributes?: SVGAttributes<SVGElement>;
 };
-export declare function ColorDescriptionSVG({ width, height, data, svgAttributes, SIDEBAR_PREVIEW_SCALE, }: ColorDescriptionSVGProps): JSX.Element;
+export declare function ColorDescriptionSVG({ width, height, data, svgAttributes, SIDEBAR_PREVIEW_SCALE, }: ColorDescriptionSVGProps): import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/svgs/nodes/communicationDiagram/CommunicationObjectNameSVG.d.ts

@@ -3,4 +3,4 @@ import { SVGComponentProps } from '../../../../types/SVG';
 export type CommunicationObjectNameSVGProps = SVGComponentProps & {
     data: CommunicationObjectNodeProps;
 };
-export declare const CommunicationObjectNameSVG: ({ id, width, height, data, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, }: CommunicationObjectNameSVGProps) => JSX.Element;
+export declare const CommunicationObjectNameSVG: ({ id, width, height, data, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, }: CommunicationObjectNameSVGProps) => import("react/jsx-runtime").JSX.Element;

package/dist/{components → react/components}/svgs/nodes/objectDiagram/ObjectNameSVG.d.ts

@@ -3,5 +3,5 @@ import { SVGComponentProps } from '../../../../types/SVG';
 interface Props extends SVGComponentProps {
     data: ObjectNodeProps;
 }
-export declare const ObjectNameSVG: ({ id, width, height, data, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, }: Props) => JSX.Element;
+export declare const ObjectNameSVG: ({ id, width, height, data, SIDEBAR_PREVIEW_SCALE, svgAttributes, showAssessmentResults, }: Props) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/{components → react/components}/toolbars/edgeToolBar/CustomEdgeToolBar.d.ts

@@ -2,6 +2,8 @@ import { IPoint } from '../../../edges';
 interface CustomEdgeToolbarProps {
     edgeId: string;
     position: IPoint;
+    /** Edge-middle anchor the toolbar counter-scales around (flow coords). */
+    scaleAnchor: IPoint;
     onEditClick: (event: React.MouseEvent<HTMLElement>) => void;
     onDeleteClick: (event: React.MouseEvent<HTMLElement>) => void;
     anchorRef: React.RefObject<SVGForeignObjectElement>;

package/dist/{components → react/components}/ui/StyleEditor/ColorButtons.d.ts

@@ -7,5 +7,5 @@ interface ColorButtonProps {
     color: string;
     onSelect: (color: string) => void;
 }
-export declare const ColorButton: ({ color, onSelect }: ColorButtonProps) => JSX.Element;
+export declare const ColorButton: ({ color, onSelect }: ColorButtonProps) => import("react/jsx-runtime").JSX.Element;
 export {};