@tumaet/apollon 4.6.0 → 4.8.0

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

@@ -1,38 +1,38 @@
 export declare const diagramEdgeTypes: {
-    ClassAggregation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassInheritance: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassRealization: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassComposition: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassBidirectional: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassUnidirectional: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ClassDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ActivityControlFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ObjectLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    FlowChartFlowline: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    SyntaxTreeLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    CommunicationLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    PetriNetArc: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    UseCaseAssociation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    UseCaseInclude: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    UseCaseExtend: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    UseCaseGeneralization: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ComponentDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ComponentProvidedInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ComponentRequiredInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ComponentRequiredThreeQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ComponentRequiredQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentAssociation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentProvidedInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentRequiredInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentRequiredThreeQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    DeploymentRequiredQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    SfcDiagramEdge: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    ReachabilityGraphArc: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    BPMNSequenceFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    BPMNMessageFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    BPMNAssociationFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
-    BPMNDataAssociationFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react/jsx-runtime").JSX.Element;
+    ClassAggregation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassInheritance: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassRealization: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassComposition: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassBidirectional: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassUnidirectional: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ClassDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ActivityControlFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ObjectLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    FlowChartFlowline: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    SyntaxTreeLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    CommunicationLink: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    PetriNetArc: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    UseCaseAssociation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    UseCaseInclude: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    UseCaseExtend: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    UseCaseGeneralization: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ComponentDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ComponentProvidedInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ComponentRequiredInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ComponentRequiredThreeQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ComponentRequiredQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentAssociation: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentDependency: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentProvidedInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentRequiredInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentRequiredThreeQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    DeploymentRequiredQuarterInterface: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    SfcDiagramEdge: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    ReachabilityGraphArc: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    BPMNSequenceFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    BPMNMessageFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    BPMNAssociationFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
+    BPMNDataAssociationFlow: ({ id, type, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, sourceHandleId, targetHandleId, data, }: import('./GenericEdge').BaseEdgeProps) => import("react").JSX.Element;
 };
 export declare const edgeConfig: {
     readonly ClassAggregation: {

package/dist/react/export/exportErrors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Typed error for the raster (PNG) export path so callers can show an
+ * actionable "diagram too large" message instead of the silent 0-byte file the
+ * old canvas path produced (#667).
+ */
+export declare class RasterTooLargeError extends Error {
+    readonly canvasWidth: number;
+    readonly canvasHeight: number;
+    constructor(message: string, canvasWidth: number, canvasHeight: number);
+}

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

@@ -0,0 +1,13 @@
+/**
+ * `@tumaet/apollon/export` — reliable browser raster/vector export of a
+ * compat-mode Apollon SVG. PNG via resvg (wasm); PDF via svg2pdf.js on jsPDF.
+ * Both fix the canvas-area-cap silent failure of the old client path (#667).
+ *
+ * The heavy renderers (`@resvg/resvg-wasm`, `jspdf`, `svg2pdf.js`) are optional
+ * dependencies, loaded lazily, so importing the editor never pulls them in.
+ */
+export { svgToPng, computeAppliedScale } from './svgToPng';
+export type { SvgToPngOptions, SvgToPngResult } from './svgToPng';
+export { svgToPdf } from './svgToPdf';
+export type { SvgToPdfOptions } from './svgToPdf';
+export { RasterTooLargeError } from './exportErrors';

package/dist/react/export/normalizeExportSvg.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Drop `font-style="italic"` from every element of an export SVG.
+ *
+ * Apollon emits italic for abstract-class headers, but the editor itself ships
+ * only upright Inter (Regular + Bold) — on screen the slant is the browser's
+ * *synthetic* oblique, and text width is measured with the upright metrics.
+ * The raster (resvg) and PDF (jsPDF) paths carry the same two upright faces, so
+ * a real italic face would change advance widths and break the editor↔export
+ * determinism guarantee (and risk overflowing label boxes). We therefore render
+ * abstract names upright by design — matching the server export — and strip the
+ * attribute so the SVG no longer *claims* an italic it doesn't deliver. Abstract
+ * classes stay distinguishable by their «Abstract» stereotype label.
+ *
+ * Mutates `root` in place.
+ */
+export declare function normalizeExportSvg(root: Element): void;

package/dist/react/export/preProcessSvgForPdf.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Adapt a compat-mode Apollon SVG to the three svg2pdf.js limitations that the
+ * library's own compat passes (in exportUtils.ts) do NOT already cover.
+ * Relative font-sizes, `tspan` `dy` and `dominant-baseline` are resolved
+ * upstream by `getSVG`, so they are intentionally absent here.
+ *
+ *  1. Nested `<svg>` clips its content despite `overflow="visible"` — svg2pdf
+ *     treats the intrinsic size as a clip rect. Apollon wraps each node in
+ *     `<svg width viewBox>`; replace those with `<g>` (layout-equivalent since
+ *     the viewBox is always `0 0 w h`), translating any non-zero origin.
+ *  2. A `<text>` with 2+ `<tspan>` children renders with wrong glyph widths in
+ *     svg2pdf; split it into independent `<text>` elements. Each tspan already
+ *     carries an absolute `y` (resolved by `resolveTspanDy`).
+ *  3. svg2pdf looks up `font-family` as a literal string, so the CSS list
+ *     `"Inter, system-ui, …"` misses the registered "Inter" and falls back to a
+ *     standard font; collapse any Inter-led list to plain `"Inter"`.
+ *
+ * Mutates `root` in place and returns it.
+ */
+export declare function preProcessSvgForPdf(root: Element): Element;

package/dist/react/export/svgToPdf.d.ts

@@ -0,0 +1,17 @@
+export type SvgToPdfOptions = {
+    /** Document title metadata; does not affect layout. */
+    title?: string;
+    /**
+     * Inter Regular + Bold as ttf/otf bytes, for hosts without `fetch` of the
+     * bundled `?url` font asset (e.g. tests, headless Node). Defaults to the
+     * bundled Inter.
+     */
+    fonts?: {
+        regular: Uint8Array;
+        bold: Uint8Array;
+    };
+};
+export declare function svgToPdf(svg: string, clip: {
+    width: number;
+    height: number;
+}, opts?: SvgToPdfOptions): Promise<Blob>;

package/dist/react/export/svgToPng.d.ts

@@ -0,0 +1,38 @@
+export type SvgToPngOptions = {
+    /** Multiplier applied to the diagram clip dimensions. Default 1.5. */
+    scale?: number;
+    /** CSS colour (e.g. "#ffffff") or null for transparent. Default null. */
+    background?: string | null;
+    /** Override the 75 MP area budget. */
+    maxAreaPx?: number;
+    /** Override the 16,384 px per-side cap. */
+    maxDimensionPx?: number;
+    /**
+     * The `@resvg/resvg-wasm` binary, as anything resvg's `initWasm` accepts.
+     * Required: where the wasm lives is the host bundler's concern, not the
+     * library's (resvg-wasm doesn't export it under a portable URL specifier).
+     * In Vite:
+     *   `import url from "@resvg/resvg-wasm/index_bg.wasm?url"`
+     *   `svgToPng(svg, clip, { wasmInput: fetch(url) })`
+     */
+    wasmInput?: WebAssembly.Module | BufferSource | Response | Promise<Response>;
+    /** Font buffers (ttf/otf) to use instead of the bundled Inter. */
+    fontBuffers?: Uint8Array[];
+};
+export type SvgToPngResult = {
+    blob: Blob;
+    /** The scale actually used — below the requested one when clamped. */
+    appliedScale: number;
+    clamped: boolean;
+    width: number;
+    height: number;
+};
+/**
+ * Largest scale that fits both the area budget and the per-side cap. Pure, so
+ * the clamp can be unit-tested without booting wasm.
+ */
+export declare function computeAppliedScale(width: number, height: number, requestedScale: number, maxAreaPx: number, maxDimensionPx: number): number;
+export declare function svgToPng(svg: string, clip: {
+    width: number;
+    height: number;
+}, opts?: SvgToPngOptions): Promise<SvgToPngResult>;