@tumaet/apollon 4.8.0 → 5.0.0

package/dist/react/utils/paletteLayout.d.ts

@@ -1,66 +0,0 @@
-/**
- * Layout math for the floating element palette. The palette is an overlay on
- * the canvas (all viewports — there is no docked variant), so it must lay every
- * element out in a grid that fits the available canvas WITHOUT scrolling.
- *
- * Objective (in priority order):
- *   1. Use the FEWEST columns — a tall, narrow card preserves horizontal canvas
- *      space, which is what you actually draw in.
- *   2. Fill the available VERTICAL space — a single column down the side reads
- *      like a classic palette and wastes no height.
- *   3. Keep cells comfortably large — never below `COMFORT_MIN_H` just to save a
- *      column, and never below the HIG `CELL_MIN_H` touch floor at all.
- *
- * So: walk column counts low→high and take the first one whose cells, sized to
- * fill the height, are still comfortable. Few elements get big capped cells in
- * one column; many elements get a taller single column of moderate cells before
- * a second column is ever added.
- *
- * Cells are rectangular (the dominant elements — class boxes, BPMN tasks — are
- * ~1.6:1 wide); narrower/square elements letterbox centered inside. Sizing the
- * cell, not the SVG, keeps the node components untouched.
- */
-export declare const PALETTE: Readonly<{
-    /** HIG/WCAG touch + legibility floor — never shrink a cell past this. */
-    readonly CELL_MIN_H: 44;
-    /** Bias toward fewer columns: keep a single (or narrower) column as long as
-     *  its height-filling cells stay at least this big; only add a column when
-     *  that would drop below it. Just above the touch floor, so the strong
-     *  preference is fewer columns + filling the height. */
-    readonly COMFORT_MIN_H: 48;
-    /** Upper bound so few-element palettes don't get absurdly tall cells. */
-    readonly CELL_MAX_H: 78;
-    /** cellW = round(CELL_RATIO * cellH); ~matches the 160×100 class box. */
-    readonly CELL_RATIO: 1.6;
-    readonly GAP: 8;
-    readonly PAD: 6;
-    /** Keep the palette horizontally narrow so the canvas keeps its width … */
-    readonly MAX_FRAC_W: 0.5;
-    /** … but let it use most of the height. */
-    readonly MAX_FRAC_H: 0.9;
-    /** Letterbox padding around the preview inside a cell. */
-    readonly CONTENT_INSET: 6;
-    /** Space kept clear above (top offset) and below (zoom controls) the palette. */
-    readonly TOP_RESERVE: 10;
-    readonly BOTTOM_RESERVE: 84;
-}>;
-export interface PaletteLayout {
-    cols: number;
-    cellW: number;
-    cellH: number;
-    /** True only in the rare case all items can't fit even at the floor size. */
-    scroll: boolean;
-}
-/**
- * @param itemCount total grid cells (drag elements + the color-description cell)
- * @param availW    measured canvas width
- * @param availH    measured canvas height
- * @param chromeH   height of non-grid palette chrome (view switch / hint), 0 if none
- */
-export declare function computePaletteLayout(itemCount: number, availW: number, availH: number, chromeH: number): PaletteLayout;
-/**
- * Preview scale that fits an element's natural size into a cell's content box.
- * Elements fill their cell (so they read "big"); wide boxes fit width, tall/
- * square nodes fit height and letterbox.
- */
-export declare function previewScaleForCell(naturalWidth: number, naturalHeight: number, cellW: number, cellH: number): number;

package/dist/react/utils/pathParsing.d.ts

@@ -1,54 +0,0 @@
-/**
- * SVG Path Parsing Utilities
- *
- * Parses SVG path commands to extract endpoint positions and directions.
- * Used by InlineMarker to correctly position and orient edge markers.
- *
- * Supports all SVG path commands including relative coordinates.
- */
-export interface Point {
-    readonly x: number;
-    readonly y: number;
-}
-export interface PathEndInfo {
-    /** The endpoint coordinates */
-    readonly endPoint: Point;
-    /** Direction angle in radians (from previous point to endpoint) */
-    readonly direction: number;
-}
-export interface PathStartInfo {
-    /** The start point coordinates */
-    readonly startPoint: Point;
-    /** Direction angle in radians (pointing into the start, away from second point) */
-    readonly direction: number;
-}
-/**
- * Calculate the direction angle from point A to point B.
- */
-export declare function calculateDirection(from: Point, to: Point): number;
-/**
- * Extract endpoint information from an SVG path.
- *
- * Parses the path to find the final position and the direction of approach.
- * The direction is calculated from the control point (or previous point) to the endpoint.
- *
- * @param pathD - SVG path data string (e.g., "M0,0 L100,100")
- * @returns Endpoint info or null if path is invalid
- */
-export declare function getPathEndInfo(pathD: string): PathEndInfo | null;
-/**
- * Extract start point information from an SVG path.
- *
- * @param pathD - SVG path data string
- * @returns Start point info or null if path is invalid
- */
-export declare function getPathStartInfo(pathD: string): PathStartInfo | null;
-/**
- * Extract marker ID from a url() reference.
- *
- * @example
- * extractMarkerId("url(#black-arrow)") // "black-arrow"
- * extractMarkerId("url('#my-marker')") // "my-marker"
- * extractMarkerId(undefined) // null
- */
-export declare function extractMarkerId(markerUrl: string | undefined): string | null;

package/dist/react/utils/popoverUtils.d.ts

@@ -1,3 +0,0 @@
-import { Quadrant } from '../enums';
-import { LocationPopover } from '../types';
-export declare const getPopoverOrigin: (quadrant: Quadrant) => LocationPopover;

package/dist/react/utils/quadrantUtils.d.ts

@@ -1,3 +0,0 @@
-import { Quadrant } from '../enums';
-import { XYPosition } from '@xyflow/react';
-export declare const getQuadrant: (target: XYPosition, reference: XYPosition) => Quadrant;

package/dist/react/utils/requiredInterfaceUtils.d.ts

@@ -1,18 +0,0 @@
-type RequiredInterfaceLikeEdge = {
-    id: string;
-    target: string;
-    type?: string | null;
-    targetHandle?: string | null;
-};
-type ResolveRequiredInterfaceEdgeTypeParams = {
-    type: string;
-    id: string;
-    target: string;
-    targetHandleId?: string | null;
-    edges: RequiredInterfaceLikeEdge[];
-    requiredTypes: readonly string[];
-    defaultType: string;
-    reducedType: string;
-};
-export declare function resolveRequiredInterfaceEdgeType({ type, id, target, targetHandleId, edges, requiredTypes, defaultType, reducedType, }: ResolveRequiredInterfaceEdgeTypeParams): string;
-export {};

package/dist/react/utils/storeUtils.d.ts

@@ -1 +0,0 @@
-export declare const deepEqual: (a: unknown, b: unknown) => boolean;

package/dist/react/utils/svgTextLayout.d.ts

@@ -1,86 +0,0 @@
-/** Compact spec for a text style. Converted into a canvas `font` shorthand. */
-export type SvgFontSpec = {
-    fontSize: number;
-    fontWeight?: string | number;
-    fontFamily?: string;
-    fontStyle?: string;
-};
-export declare const toCanvasFont: (spec: SvgFontSpec) => string;
-/** How to treat whitespace during layout. Mirrors a CSS `white-space` subset. */
-export type WhiteSpaceMode = "normal" | "pre-wrap";
-/**
- * Invalidate every cached preparation. Call this when the set of available
- * fonts changes (e.g. a webfont just finished loading) so that subsequent
- * measurements use the real font metrics rather than the fallback's.
- */
-export declare const clearPrepareCache: () => void;
-/**
- * Convenience: the most lines of `lineHeight` that can stack vertically in
- * `availableHeight` pixels. Always returns at least 1. Useful for SVG nodes
- * whose inner drawable area has a known vertical budget (rectangle height
- * minus top/bottom padding, for instance) and who want to cap
- * `MultilineText`'s `maxLines` so wrapping never overflows the shape.
- */
-export declare const maxLinesForHeight: (availableHeight: number, lineHeight: number) => number;
-export type WrappedText = {
-    lines: string[];
-    /**
-     * Measured width of the widest laid-out line, in CSS px. Does not account
-     * for any ellipsis a caller may append after truncation.
-     */
-    maxLineWidth: number;
-    /** Whether every grapheme of the input was consumed by the layout. */
-    overflow: boolean;
-};
-/**
- * Wrap text inside a rectangle of `maxWidth`. Word-break is CSS `normal`.
- * When `whiteSpace` is `"pre-wrap"` (the default), literal `\n` characters in
- * the input become hard line breaks; when it is `"normal"` whitespace runs
- * collapse the way CSS normally collapses them.
- *
- * Returns the resulting lines, the widest line's measured width, and whether
- * any content was dropped (i.e. could not fit within `maxLines`).
- */
-export declare const wrapTextInRect: (text: string, maxWidth: number, font: SvgFontSpec | string, options?: {
-    maxLines?: number;
-    lineHeight?: number;
-    whiteSpace?: WhiteSpaceMode;
-}) => WrappedText;
-export type ShapeLayout = {
-    /** Materialized lines (from pretext). `text` already includes any ellipsis. */
-    lines: {
-        text: string;
-        width: number;
-    }[];
-    lineHeight: number;
-    /** Signed y-offsets (relative to shape center) of each line's visual center. */
-    lineOffsets: number[];
-    /** Total vertical span of the laid-out block. */
-    blockHeight: number;
-    /** True when input text exceeded the shape's capacity and was truncated. */
-    overflow: boolean;
-};
-type ShapeOptions = {
-    paddingX?: number;
-    paddingY?: number;
-    /** Cap on how many lines we will try to fit. Defaults to a generous value. */
-    maxLines?: number;
-    /** Same semantics as `wrapTextInRect`'s `whiteSpace`. */
-    whiteSpace?: WhiteSpaceMode;
-};
-/**
- * Lay out `text` inside an ellipse of size `width`×`height`, respecting the
- * ellipse's curvature so lines near the top and bottom get a narrower max
- * width than lines near the middle. When the text does not fit, the final
- * visible line is suffixed with a horizontal ellipsis.
- */
-export declare const layoutTextInEllipse: (text: string, width: number, height: number, font: SvgFontSpec | string, lineHeight: number, options?: ShapeOptions) => ShapeLayout;
-/**
- * Lay out `text` inside a rhombus / diamond of size `width`×`height`. The
- * inner width varies linearly with the distance from the vertical center
- * (full width at the middle, zero at the top and bottom vertices). Lines
- * near the vertices therefore get narrower line boxes, and overflow is
- * marked with a horizontal ellipsis on the last visible line.
- */
-export declare const layoutTextInDiamond: (text: string, width: number, height: number, font: SvgFontSpec | string, lineHeight: number, options?: ShapeOptions) => ShapeLayout;
-export {};

package/dist/react/utils/textUtils.d.ts

@@ -1 +0,0 @@
-export declare const measureTextWidth: (text: string, font?: string) => number;

package/dist/react/utils/v3Typings.d.ts

@@ -1,135 +0,0 @@
-import { IPoint } from '../edges/Connection';
-export type V3Selection = {
-    elements: {
-        [id: string]: boolean;
-    };
-    relationships: {
-        [id: string]: boolean;
-    };
-};
-export type V3UMLClassifier = {
-    attributes: string[];
-    methods: string[];
-};
-export type V3UMLDeploymentNode = {
-    stereotype: string;
-    displayStereotype: boolean;
-};
-export type V3UMLDeploymentComponent = {
-    displayStereotype: boolean;
-};
-export type V3UMLComponentSubsystem = {
-    stereotype: string;
-    displayStereotype: boolean;
-};
-export type V3UMLComponentComponent = {
-    displayStereotype: boolean;
-};
-export type V3UMLPetriNetPlace = {
-    amountOfTokens: number;
-    capacity: number | string;
-};
-export type V3BPMNTask = {
-    taskType: "default" | "user" | "send" | "receive" | "manual" | "business-rule" | "script";
-    marker: "none" | "parallel multi instance" | "sequential multi instance" | "loop";
-};
-export type V3BPMNGateway = {
-    gatewayType: "complex" | "event-based" | "exclusive" | "inclusive" | "parallel";
-};
-export type V3BPMNStartEvent = {
-    eventType: "default" | "message" | "timer" | "conditional" | "signal";
-};
-export type V3BPMNIntermediateEvent = {
-    eventType: "default" | "message-catch" | "message-throw" | "timer-catch" | "escalation-throw" | "conditional-catch" | "link-catch" | "link-throw" | "compensation-throw" | "signal-catch" | "signal-throw";
-};
-export type V3BPMNEndEvent = {
-    eventType: "default" | "message" | "escalation" | "error" | "compensation" | "signal" | "terminate";
-};
-export type V3UMLReachabilityGraphMarking = {
-    isInitialMarking: boolean;
-};
-export interface V3UMLModel {
-    version: string;
-    type: string;
-    size: {
-        width: number;
-        height: number;
-    };
-    interactive: {
-        elements: Record<string, boolean>;
-        relationships: Record<string, boolean>;
-    };
-    elements: Record<string, V3UMLElement>;
-    relationships: Record<string, V3UMLRelationship>;
-    assessments: Record<string, V3Assessment>;
-}
-export type V3UMLModelElementType = string;
-export type V3UMLModelElement = {
-    id: string;
-    name: string;
-    type: V3UMLModelElementType;
-    owner: string | null;
-    bounds: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    highlight?: string;
-    fillColor?: string;
-    strokeColor?: string;
-    textColor?: string;
-    assessmentNote?: string;
-};
-export type V3UMLElement = V3UMLModelElement & Partial<V3UMLClassifier> & Partial<V3UMLDeploymentNode> & Partial<V3UMLDeploymentComponent> & Partial<V3UMLComponentSubsystem> & Partial<V3UMLComponentComponent> & Partial<V3UMLPetriNetPlace> & Partial<V3BPMNTask> & Partial<V3BPMNGateway> & Partial<V3BPMNStartEvent> & Partial<V3BPMNIntermediateEvent> & Partial<V3BPMNEndEvent> & Partial<V3UMLReachabilityGraphMarking>;
-export type V3UMLRelationship = V3UMLModelElement & {
-    path: IPoint[];
-    source: {
-        element: string;
-        direction: string;
-        multiplicity?: string;
-        role?: string;
-    };
-    target: {
-        element: string;
-        direction: string;
-        multiplicity?: string;
-        role?: string;
-    };
-    isManuallyLayouted?: boolean;
-    messages?: {
-        [id: string]: {
-            id: string;
-            name: string;
-            direction: "source" | "target";
-        };
-    };
-    flowType?: string;
-};
-export type V3Assessment = {
-    modelElementId: string;
-    elementType: string;
-    score: number;
-    feedback?: string;
-    dropInfo?: any;
-    label?: string;
-    labelColor?: string;
-    correctionStatus?: {
-        description?: string;
-        status: "CORRECT" | "INCORRECT" | "NOT_VALIDATED";
-    };
-};
-export type V3DiagramFormat = {
-    id: string;
-    title: string;
-    model: V3UMLModel;
-    lastUpdate?: string;
-};
-export type V3Message = {
-    id: string;
-    name: string;
-    direction: "source" | "target";
-};
-export type V3Messages = {
-    [id: string]: V3Message;
-};

package/dist/react/utils/versionConverter.d.ts

@@ -1,60 +0,0 @@
-import { UMLModel } from '../typings';
-import { V3DiagramFormat, V3UMLModel, V3UMLElement, V3UMLRelationship, V3Assessment, V3Messages } from './v3Typings';
-import { MessageData } from '../edges/EdgeProps';
-interface V2DiagramFormat {
-    version: string;
-    size: {
-        width: number;
-        height: number;
-    };
-    type: string;
-    interactive: {
-        elements: string[];
-        relationships: string[];
-    };
-    elements: V3UMLElement[];
-    relationships: V3UMLRelationship[];
-    assessments: V3Assessment[];
-}
-/**
- * Convert v2 format to v4 format
- */
-export declare function convertV2ToV4(v2Data: V2DiagramFormat): UMLModel;
-/**
- * Check if data is in v2 format
- */
-export declare function isV2Format(data: any): data is V2DiagramFormat;
-/**
- * Convert v3 handle directions to v4 handle IDs
- * V3 uses Direction enum, V4 uses HandleId enum
- */
-export declare function convertV3HandleToV4(v3Handle: string): string;
-/**
- * Convert v3 node types to v4 node types
- */
-export declare function convertV3NodeTypeToV4(v3Type: string): string;
-/**
- * Convert v3 edge types to v4 edge types
- */
-export declare function convertV3EdgeTypeToV4(v3Type: string, flowType?: string): string;
-/**
- * Convert V3 messages format to V4 MessageData array
- */
-export declare function convertV3MessagesToV4(messages: V3Messages | MessageData[] | undefined): MessageData[];
-/**
- * Main conversion function from v3 to v4 format
- */
-export declare function convertV3ToV4(v3Data: V3DiagramFormat | V3UMLModel): UMLModel;
-/**
- * Check if data is in v3 format
- */
-export declare function isV3Format(data: any): data is V3DiagramFormat;
-/**
- * Check if data is in v4 format
- */
-export declare function isV4Format(data: any): data is UMLModel;
-/**
- * Universal import function that handles v2, v3 and v4 formats
- */
-export declare function importDiagram(data: any | V3UMLModel): UMLModel;
-export {};