@tumaet/apollon 4.8.0 → 5.0.0

package/dist/react/services/migration/EdgeTransformer.d.ts

@@ -1,11 +0,0 @@
-import { ApollonEdge, UMLModel } from '../../typings';
-/**
- * Returns a new edge whose data is free of stale runtime geometry. Does NOT
- * mutate the input. A null/absent `data` is normalized to an empty object.
- */
-export declare function hydrateEdgeData(edge: ApollonEdge): ApollonEdge;
-/**
- * Transforms all edges in a `UMLModel`, ensuring every edge satisfies
- * the `OrthogonalEdgeData` interface. Returns a new model object.
- */
-export declare function transformEdges(model: UMLModel): UMLModel;

package/dist/react/store/alignmentGuidesStore.d.ts

@@ -1,13 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-export type AlignmentGuide = {
-    id: string;
-    type: "vertical" | "horizontal";
-    position: number;
-    offset?: number;
-};
-export type AlignmentGuidesStore = {
-    guides: AlignmentGuide[];
-    setGuides: (guides: AlignmentGuide[]) => void;
-    clearGuides: () => void;
-};
-export declare const createAlignmentGuidesStore: () => UseBoundStore<StoreApi<AlignmentGuidesStore>>;

package/dist/react/store/assessmentSelectionStore.d.ts

@@ -1,17 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-export type AssessmentSelectionStore = {
-    selectedElementIds: string[];
-    highlightedElementId: string | null;
-    isAssessmentSelectionMode: boolean;
-    highlightedElements: Record<string, string>;
-    setAssessmentSelectionMode: (isActive: boolean) => void;
-    selectElement: (elementId: string) => void;
-    selectMultipleElements: (elementIds: string[]) => void;
-    clearSelection: () => void;
-    setHighlightedElement: (elementId: string | null) => void;
-    setElementHighlights: (highlights: Record<string, string>) => void;
-    isElementSelected: (elementId: string) => boolean;
-    isElementHighlighted: (elementId: string) => boolean;
-    reset: () => void;
-};
-export declare const createAssessmentSelectionStore: () => UseBoundStore<StoreApi<AssessmentSelectionStore>>;

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

@@ -1,19 +0,0 @@
-import { StoreApi } from 'zustand';
-import { DiagramStore } from './diagramStore';
-import { MetadataStore } from './metadataStore';
-import { PopoverStore } from './popoverStore';
-import { AssessmentSelectionStore } from './assessmentSelectionStore';
-import { AlignmentGuidesStore } from './alignmentGuidesStore';
-import { EdgeGeometryStore } from './edgeGeometryStore';
-export declare const DiagramStoreContext: import('react').Context<StoreApi<DiagramStore> | null>;
-export declare const MetadataStoreContext: import('react').Context<StoreApi<MetadataStore> | null>;
-export declare const PopoverStoreContext: import('react').Context<StoreApi<PopoverStore> | null>;
-export declare const AssessmentSelectionStoreContext: import('react').Context<StoreApi<AssessmentSelectionStore> | null>;
-export declare const AlignmentGuidesStoreContext: import('react').Context<StoreApi<AlignmentGuidesStore> | null>;
-export declare const EdgeGeometryStoreContext: import('react').Context<StoreApi<EdgeGeometryStore> | null>;
-export declare const useDiagramStore: <T>(selector: (state: DiagramStore) => T) => T;
-export declare const useMetadataStore: <T>(selector: (state: MetadataStore) => T) => T;
-export declare const usePopoverStore: <T>(selector: (state: PopoverStore) => T) => T;
-export declare const useAssessmentSelectionStore: <T>(selector: (state: AssessmentSelectionStore) => T) => T;
-export declare const useAlignmentGuidesStore: <T>(selector: (state: AlignmentGuidesStore) => T) => T;
-export declare const useEdgeGeometryStore: <T>(selector: (state: EdgeGeometryStore) => T) => T;

package/dist/react/store/diagramStore.d.ts

@@ -1,70 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-import { Node, Edge, OnNodesChange, OnEdgesChange } from '@xyflow/react';
-import { Assessment, DraggingNode, InteractiveElements } from '../typings';
-import * as Y from "yjs";
-export type DiagramStoreData = {
-    nodes: Node[];
-    edges: Edge[];
-};
-export type DiagramStore = {
-    nodes: Node[];
-    edges: Edge[];
-    selectedElementIds: string[];
-    diagramId: string;
-    assessments: Record<string, Assessment>;
-    interactiveElements: Record<string, boolean>;
-    interactiveRelationships: Record<string, boolean>;
-    interactiveSelectionInitialized: boolean;
-    canUndo: boolean;
-    canRedo: boolean;
-    undoManager: Y.UndoManager | null;
-    collaborationEnabled: boolean;
-    previewMode: boolean;
-    setDiagramId: (diagramId: string) => void;
-    setCollaborationEnabled: (enabled: boolean) => void;
-    /**
-     * Inject the sink that forwards transient drag/resize frames onto the
-     * ephemeral awareness channel (wired by `YjsSync` for every editor). Kept as
-     * runtime wiring rather than diagram state so a `reset()` never clears it.
-     * The broadcast itself is gated by `collaborationEnabled`, not by this sink;
-     * `null` (headless, where no `YjsSync` runs) just leaves it unwired.
-     */
-    setDraggingNodesPublisher: (publisher: ((draggingNodes: DraggingNode[] | null) => void) | null) => void;
-    /**
-     * Clear the peers' live-drag overlay once a gesture's settled value is
-     * committed. Called from `onNodeDragStop` (after the doc write) and on
-     * collaboration teardown; a no-op when nothing is being broadcast.
-     */
-    endTransientNodeBroadcast: () => void;
-    setNodes: (payload: Node[] | ((nodes: Node[]) => Node[])) => void;
-    setEdges: (payload: Edge[] | ((edges: Edge[]) => Edge[])) => void;
-    setNodesAndEdges: (nodes: Node[], edges: Edge[]) => void;
-    addEdge: (edge: Edge) => void;
-    addNode: (node: Node) => void;
-    onNodesChange: OnNodesChange;
-    onEdgesChange: OnEdgesChange;
-    reset: () => void;
-    setSelectedElementsId: (payload: string[] | ((edges: string[]) => string[])) => void;
-    getAssessment: (id: string) => Assessment | undefined;
-    setAssessments: (assessments: Record<string, Assessment> | ((prev: Record<string, Assessment>) => Record<string, Assessment>)) => void;
-    updateNodesFromYjs: () => void;
-    updateEdgesFromYjs: () => void;
-    updateAssessmentFromYjs: () => void;
-    addOrUpdateAssessment: (assessment: Assessment) => void;
-    undo: () => void;
-    redo: () => void;
-    initializeUndoManager: () => void;
-    updateUndoRedoState: () => void;
-    toggleInteractiveElement: (elementId: string) => void;
-    getInteractiveForSerialization: () => InteractiveElements | undefined;
-    setInteractive: (interactive: InteractiveElements | undefined) => void;
-    isElementInteractive: (elementId: string) => boolean;
-    /**
-     * Toggle the preview overlay. When entering, the Yjs doc is left
-     * untouched by store mutators and observers. When exiting, the local
-     * Zustand state is rebuilt from the (peer-augmented) Yjs maps so the
-     * canvas catches up to everything that arrived during preview.
-     */
-    setPreviewMode: (active: boolean) => void;
-};
-export declare const createDiagramStore: (ydoc: Y.Doc) => UseBoundStore<StoreApi<DiagramStore>>;

package/dist/react/store/edgeGeometryStore.d.ts

@@ -1,18 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-import { IPoint } from '../edges/Connection';
-/**
- * Runtime-only registry of each edge's ACTUAL rendered polyline (jump-free),
- * keyed by edge id. Line jumps read other edges' geometry from here instead of
- * re-deriving it, so a bridge always centers on the crossing the user actually
- * sees — regardless of edge type, routing (step / straight-path), handle, or
- * container offset. Each edge publishes on render and removes on unmount.
- *
- * Not persisted (Yjs never sees it) — it is ephemeral view geometry, exactly
- * the kind of "computed segments" the model deliberately does not store.
- */
-export type EdgeGeometryStore = {
-    geometryById: Record<string, IPoint[]>;
-    publishEdgeGeometry: (id: string, points: IPoint[]) => void;
-    removeEdgeGeometry: (id: string) => void;
-};
-export declare const createEdgeGeometryStore: () => UseBoundStore<StoreApi<EdgeGeometryStore>>;

package/dist/react/store/index.d.ts

@@ -1,7 +0,0 @@
-export { createDiagramStore } from './diagramStore';
-export { createMetadataStore } from './metadataStore';
-export { createPopoverStore } from './popoverStore';
-export { createAssessmentSelectionStore } from './assessmentSelectionStore';
-export { createAlignmentGuidesStore } from './alignmentGuidesStore';
-export { createEdgeGeometryStore } from './edgeGeometryStore';
-export { DiagramStoreContext, MetadataStoreContext, PopoverStoreContext, AssessmentSelectionStoreContext, AlignmentGuidesStoreContext, EdgeGeometryStoreContext, useDiagramStore, useMetadataStore, usePopoverStore, useAssessmentSelectionStore, useAlignmentGuidesStore, useEdgeGeometryStore, } from './context';

package/dist/react/store/metadataStore.d.ts

@@ -1,39 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-import { UMLDiagramType } from '../types';
-import { ApollonMode, ApollonView } from '../typings';
-import { IPoint } from '../edges/Connection';
-import * as Y from "yjs";
-export type MetadataStore = {
-    diagramTitle: string;
-    diagramType: UMLDiagramType;
-    mode: ApollonMode;
-    view: ApollonView;
-    availableViews: ApollonView[];
-    readonly: boolean;
-    debug: boolean;
-    scrollLock: boolean;
-    scrollEnabled: boolean;
-    connectionGuidanceActive: boolean;
-    connectionGuidanceSourceNodeId: string | null;
-    connectionGuidanceSourceHandleId: string | null;
-    reconnectPreviewEdgeId: string | null;
-    reconnectPreviewHandleType: "source" | "target" | null;
-    reconnectPreviewBasePoints: IPoint[];
-    setMode: (mode: ApollonMode) => void;
-    setView: (view: ApollonView) => void;
-    setAvailableViews: (availableViews: ApollonView[]) => void;
-    setReadonly: (readonly: boolean) => void;
-    setScrollLock: (scrollLock: boolean) => void;
-    setScrollEnabled: (scrollEnabled: boolean) => void;
-    startConnectionGuidance: (sourceNodeId: string | null, sourceHandleId: string | null) => void;
-    stopConnectionGuidance: () => void;
-    startReconnectPreview: (edgeId: string, handleType: "source" | "target", basePoints: IPoint[]) => void;
-    stopReconnectPreview: () => void;
-    updateDiagramTitle: (diagramTitle: string) => void;
-    updateDiagramType: (diagramType: UMLDiagramType) => void;
-    updateMetaData: (diagramTitle: string, diagramType: UMLDiagramType) => void;
-    updateMetaDataFromYjs: () => void;
-    reset: () => void;
-    setDebug: (debug: boolean) => void;
-};
-export declare const createMetadataStore: (ydoc: Y.Doc, isPreviewMode?: () => boolean) => UseBoundStore<StoreApi<MetadataStore>>;

package/dist/react/store/popoverStore.d.ts

@@ -1,9 +0,0 @@
-import { StoreApi, UseBoundStore } from 'zustand';
-export type PopoverStore = {
-    popoverElementId: string | null;
-    popupEnabled: boolean;
-    setPopOverElementId: (value: string | null) => void;
-    setPopupEnabled: (isPopupEnabled: boolean) => void;
-    reset: () => void;
-};
-export declare const createPopoverStore: () => UseBoundStore<StoreApi<PopoverStore>>;

package/dist/react/styles/theme.d.ts

@@ -1,51 +0,0 @@
-export type Styles = typeof apollonTheme;
-export type withThemeProps = {
-    theme: Styles;
-};
-export type Color = "primary" | "secondary";
-export type Size = "sm" | "md" | "lg";
-declare const apollonTheme: {
-    color: {
-        primary: string;
-        secondary: string;
-        warningYellow: string;
-        background: string;
-        backgroundVariant: string;
-        grid: string;
-        primaryContrast: string;
-        gray: string;
-        grayAccent: string;
-    };
-    font: {
-        color: string;
-        family: string;
-        size: number;
-    };
-    interactive: {
-        normal: string;
-        hovered: string;
-    };
-};
-export declare const defaults: () => {
-    color: {
-        primary: string;
-        secondary: string;
-        warningYellow: string;
-        background: string;
-        backgroundVariant: string;
-        grid: string;
-        primaryContrast: string;
-        gray: string;
-        grayAccent: string;
-    };
-    font: {
-        color: string;
-        family: string;
-        size: number;
-    };
-    interactive: {
-        normal: string;
-        hovered: string;
-    };
-};
-export {};

package/dist/react/sync/headless.d.ts

@@ -1,16 +0,0 @@
-import { YjsSync } from './yjsSync';
-import * as Y from "yjs";
-/**
- * Construct a `YjsSync` against minimal stub stores. Intended for
- * tests that exercise the wire protocol (sync/awareness handshake,
- * incremental updates, reconnect behaviour) without dragging the React
- * editor / React-Flow / zustand-with-middleware setup into the harness.
- *
- * Stores expose only the methods the sync class actually invokes. The
- * Yjs observers will call them, but their bodies are no-ops because the
- * test asserts directly against the `Y.Doc` that's returned.
- */
-export declare function createHeadlessSync(ydoc?: Y.Doc): {
-    ydoc: Y.Doc;
-    sync: YjsSync;
-};

package/dist/react/sync/perfCounters.d.ts

@@ -1,6 +0,0 @@
-export type PerfCounters = {
-    storeNodeWrites: number;
-};
-export declare const perfCounters: PerfCounters;
-export declare const getPerfCounters: () => PerfCounters | undefined;
-export declare const recordStoreNodeWrite: () => void;

package/dist/react/sync/ydoc.d.ts

@@ -1,9 +0,0 @@
-import { Assessment } from '../typings';
-import { Node, Edge } from '@xyflow/react';
-import * as Y from "yjs";
-export declare const STORE_ORIGIN = "store";
-export declare const getNodesMap: (ydoc: Y.Doc) => Y.Map<Node>;
-export declare const getEdgesMap: (ydoc: Y.Doc) => Y.Map<Edge>;
-export declare const getAssessments: (ydoc: Y.Doc) => Y.Map<Assessment>;
-export declare const getDiagramMetadata: (ydoc: Y.Doc) => Y.Map<string>;
-export declare const reconcileYMap: <T>(map: Y.Map<T>, nextEntries: Iterable<readonly [string, T]>) => void;

package/dist/react/sync/yjsSync.d.ts

@@ -1,63 +0,0 @@
-import { DiagramStore } from '../store/diagramStore';
-import { MetadataStore } from '../store/metadataStore';
-import { CollaborationState, CollaborationUser, CollaborationViewport, CollaboratorInfo, DraggingNode } from '../typings';
-import { StoreApi } from 'zustand';
-import * as Y from "yjs";
-export declare enum MessageType {
-    YjsSYNC = 0,
-    YjsUpdate = 1,
-    AwarenessSync = 2,
-    AwarenessUpdate = 3
-}
-export type SendBroadcastMessage = (base64data: string) => void;
-export declare class YjsSync {
-    private readonly stopYjsObserver;
-    private sendBroadcastMessage;
-    private readonly ydoc;
-    private readonly diagramStore;
-    private readonly metadataStore;
-    private readonly awareness;
-    constructor(ydoc: Y.Doc, diagramStore: StoreApi<DiagramStore>, metadataStore: StoreApi<MetadataStore>);
-    stopSync(): void;
-    /**
-     * Push the entire local Yjs document as a single `YjsUpdate`. Callers should
-     * invoke this after a (re)connect so peers absorb any edits made while we
-     * were disconnected — those updates fire while `readyState !== OPEN`, are
-     * silently dropped by the send callback, and never replayed otherwise.
-     * Yjs CRDTs converge on merge, so peers that already have these ops just
-     * no-op.
-     */
-    broadcastFullState: () => void;
-    setSendBroadcastMessage: (sendFn: SendBroadcastMessage) => void;
-    setLocalAwarenessUser: (user: CollaborationUser) => void;
-    setLocalAwarenessCursor: (cursor: {
-        x: number;
-        y: number;
-    } | null) => void;
-    setLocalAwarenessViewport: (viewport: CollaborationViewport | null) => void;
-    setLocalAwarenessFollowing: (followingClientId: number | null) => void;
-    setLocalAwarenessSelectedElement: (selectedElementId: string | null) => void;
-    setLocalAwarenessDraggingNodes: (draggingNodes: DraggingNode[] | null) => void;
-    setLocalAwarenessState: (state: Partial<CollaborationState>) => void;
-    subscribeToAwarenessChanges: (callback: (states: Map<number, CollaborationState>) => void) => () => void;
-    getAwarenessStates: () => Map<number, CollaborationState>;
-    getCollaborators: () => CollaboratorInfo[];
-    subscribeToCollaboratorChanges: (callback: (collaborators: CollaboratorInfo[]) => void) => () => void;
-    getLocalAwarenessClientId: () => number;
-    private static narrowState;
-    private getTypedStates;
-    private computeParticipantSignature;
-    private sendFramedMessage;
-    private applyUpdate;
-    handleReceivedData: (base64Data: string) => void;
-    private startYjsObserver;
-    private isUndoRedoTransaction;
-    /**
-     *  Convert Uint8Array to Base64 string
-     */
-    static uint8ToBase64(uint8: Uint8Array): string;
-    /**
-     * Convert Base64 string to Uint8Array
-     */
-    static base64ToUint8(base64: string): Uint8Array;
-}

package/dist/react/types/DiagramType.d.ts

@@ -1,16 +0,0 @@
-export type UMLDiagramType = keyof typeof UMLDiagramType;
-export declare const UMLDiagramType: {
-    readonly ClassDiagram: "ClassDiagram";
-    readonly ObjectDiagram: "ObjectDiagram";
-    readonly ActivityDiagram: "ActivityDiagram";
-    readonly UseCaseDiagram: "UseCaseDiagram";
-    readonly CommunicationDiagram: "CommunicationDiagram";
-    readonly ComponentDiagram: "ComponentDiagram";
-    readonly DeploymentDiagram: "DeploymentDiagram";
-    readonly PetriNet: "PetriNet";
-    readonly ReachabilityGraph: "ReachabilityGraph";
-    readonly SyntaxTree: "SyntaxTree";
-    readonly Flowchart: "Flowchart";
-    readonly BPMN: "BPMN";
-    readonly Sfc: "Sfc";
-};

package/dist/react/types/SVG.d.ts

@@ -1,8 +0,0 @@
-export interface SVGComponentProps {
-    id: string;
-    width: number;
-    height: number;
-    SIDEBAR_PREVIEW_SCALE?: number;
-    svgAttributes?: React.SVGAttributes<SVGElement>;
-    showAssessmentResults?: boolean;
-}

package/dist/react/types/index.d.ts

@@ -1,3 +0,0 @@
-export * from './nodes';
-export * from './locationPopover';
-export * from './DiagramType';

package/dist/react/types/locationPopover.d.ts

@@ -1,5 +0,0 @@
-import { PopoverOrigin } from '@mui/material';
-export type LocationPopover = {
-    anchorOrigin: PopoverOrigin;
-    transformOrigin: PopoverOrigin;
-};

package/dist/react/types/nodes/DropNodeDate.d.ts

@@ -1,7 +0,0 @@
-import { DiagramNodeType } from '../../nodes';
-export interface DropNodeData {
-    type: DiagramNodeType;
-    data: Record<string, unknown>;
-    offsetX: number;
-    offsetY: number;
-}

package/dist/react/types/nodes/NodeProps.d.ts

@@ -1,77 +0,0 @@
-import { ClassType } from './enums';
-export type DefaultNodeProps = {
-    name: string;
-    fillColor?: string;
-    strokeColor?: string;
-    textColor?: string;
-};
-export type ClassNodeElement = {
-    id: string;
-} & DefaultNodeProps;
-export type ClassNodeProps = {
-    methods: ClassNodeElement[];
-    attributes: ClassNodeElement[];
-    stereotype?: ClassType;
-} & DefaultNodeProps;
-export type ObjectNodeProps = {
-    methods: ClassNodeElement[];
-    attributes: ClassNodeElement[];
-} & DefaultNodeProps;
-export type CommunicationObjectNodeProps = {
-    methods: ClassNodeElement[];
-    attributes: ClassNodeElement[];
-} & DefaultNodeProps;
-export type ComponentNodeProps = {
-    isComponentHeaderShown: boolean;
-} & DefaultNodeProps;
-export type ComponentSubsystemNodeProps = {
-    isComponentSubsystemHeaderShown: boolean;
-} & DefaultNodeProps;
-export type DeploymentNodeProps = {
-    isComponentHeaderShown: boolean;
-    stereotype: string;
-} & DefaultNodeProps;
-export type DeploymentComponentProps = {
-    isComponentHeaderShown: boolean;
-} & DefaultNodeProps;
-export type PetriNetPlaceProps = {
-    tokens: number;
-    capacity: number | string;
-} & DefaultNodeProps;
-export type BPMNTaskType = "default" | "user" | "send" | "receive" | "manual" | "business-rule" | "script";
-export type BPMNMarkerType = "none" | "parallel multi instance" | "sequential multi instance" | "loop";
-export type BPMNTaskProps = DefaultNodeProps & {
-    taskType: BPMNTaskType;
-    marker: BPMNMarkerType;
-};
-export type BPMNStartEventType = "default" | "message" | "timer" | "conditional" | "signal";
-export type BPMNIntermediateEventType = "default" | "message-catch" | "message-throw" | "timer-catch" | "escalation-throw" | "conditional-catch" | "link-catch" | "link-throw" | "compensation-throw" | "signal-catch" | "signal-throw";
-export type BPMNEndEventType = "default" | "message" | "escalation" | "error" | "compensation" | "signal" | "terminate";
-export type BPMNEventProps = DefaultNodeProps & {
-    eventType: BPMNStartEventType | BPMNIntermediateEventType | BPMNEndEventType;
-};
-export type BPMNGatewayType = "complex" | "event-based" | "exclusive" | "inclusive" | "parallel";
-export type BPMNGatewayProps = DefaultNodeProps & {
-    gatewayType: BPMNGatewayType;
-};
-export type BPMNSubprocessProps = DefaultNodeProps;
-export type BPMNTransactionProps = DefaultNodeProps;
-export type BPMNCallActivityProps = DefaultNodeProps;
-export type BPMNAnnotationProps = DefaultNodeProps;
-export type BPMNDataObjectProps = DefaultNodeProps;
-export type BPMNDataStoreProps = DefaultNodeProps;
-export type BPMNPoolProps = DefaultNodeProps;
-export type BPMNGroupProps = DefaultNodeProps;
-export type ReachabilityGraphMarkingProps = DefaultNodeProps & {
-    isInitialMarking: boolean;
-};
-export type SfcActionRow = DefaultNodeProps & {
-    id: string;
-    identifier: string;
-};
-export type SfcActionTableProps = DefaultNodeProps & {
-    actionRows: SfcActionRow[];
-};
-export type SfcTransitionBranchNodeProps = DefaultNodeProps & {
-    showHint?: boolean;
-};

package/dist/react/types/nodes/enums/ClassType.d.ts

@@ -1,5 +0,0 @@
-export declare enum ClassType {
-    Abstract = "Abstract",
-    Interface = "Interface",
-    Enumeration = "Enumeration"
-}

package/dist/react/types/nodes/enums/index.d.ts

@@ -1 +0,0 @@
-export * from './ClassType';

package/dist/react/types/nodes/index.d.ts

@@ -1,3 +0,0 @@
-export * from './enums';
-export * from './DropNodeDate';
-export * from './NodeProps';