@tumaet/apollon 4.2.22 → 4.3.0

package/dist/store/diagramStore.d.ts

@@ -14,6 +14,7 @@ export type DiagramStore = {
     assessments: Record<string, Assessment>;
     interactiveElements: Record<string, boolean>;
     interactiveRelationships: Record<string, boolean>;
+    interactiveSelectionInitialized: boolean;
     canUndo: boolean;
     canRedo: boolean;
     undoManager: Y.UndoManager | null;

package/dist/utils/index.d.ts

@@ -13,5 +13,6 @@ export * from './bpmnConstraints';
 export * from './versionConverter';
 export * from './labelUtils';
 export * from './alignmentUtils';
-export * from './flatSvgExporter';
 export * from './requiredInterfaceUtils';
+export { wrapTextInRect, layoutTextInEllipse, layoutTextInDiamond, maxLinesForHeight, } from './svgTextLayout';
+export type { WrappedText, ShapeLayout, SvgFontSpec, WhiteSpaceMode, } from './svgTextLayout';

package/dist/utils/interactiveUtils.d.ts

@@ -1,4 +1,7 @@
 import { ApollonEdge, ApollonNode, InteractiveElements } from '../typings';
-export declare function pruneInteractiveElements(interactive: InteractiveElements | undefined, nodes: Array<Pick<ApollonNode, "id">>, edges: Array<Pick<ApollonEdge, "id">>): InteractiveElements | undefined;
+type InteractivePruneNode = Pick<ApollonNode, "id"> & Partial<Pick<ApollonNode, "data">>;
+export declare function getNestedNodeElementIds(nodes: InteractivePruneNode[]): Set<string>;
+export declare function pruneInteractiveElements(interactive: InteractiveElements | undefined, nodes: InteractivePruneNode[], edges: Array<Pick<ApollonEdge, "id">>): InteractiveElements | undefined;
 export declare function toggleInteractiveRecord(record: Record<string, boolean>, id: string): Record<string, boolean>;
 export declare function hasInteractiveSelections(interactive: InteractiveElements | undefined): boolean;
+export {};

package/dist/utils/nodeUtils.d.ts

@@ -2,4 +2,14 @@ import { XYPosition, Node } from '@xyflow/react';
 export declare const getPositionOnCanvas: (node: Node, allNodes: Node[]) => XYPosition;
 export declare const resizeAllParents: (node: Node, allNodes: Node[]) => Node[];
 export declare function sortNodesTopologically(nodes: Node[]): Node[];
+/**
+ * Does this node's SVG renderer wrap its label? Drives whether the rename
+ * popover accepts multiline input — see `NODE_LABEL_CAPABILITIES`.
+ */
+export declare const supportsMultilineName: (nodeType?: string) => boolean;
+/**
+ * Does this node render a user-editable text label at all? False for
+ * pure-symbol nodes so the rename popover hides its input for them.
+ */
+export declare const rendersNameLabel: (nodeType?: string) => boolean;
 export declare const isParentNodeType: (nodeType?: string) => boolean;

package/dist/utils/svgTextLayout.d.ts

@@ -0,0 +1,86 @@
+/** 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tumaet/apollon",
-  "version": "4.2.22",
+  "version": "4.3.0",
   "description": "An embeddable UML modeling editor for React. 13 diagram types, SVG/PNG/PDF/JSON export, optional real-time collaboration via Yjs.",
   "keywords": [
     "apollon",
@@ -62,6 +62,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
+    "@chenglou/pretext": "0.0.6",
     "@emotion/react": "11.11.1",
     "@emotion/styled": "11.11.0",
     "@mui/material": "6.4.2",
@@ -74,20 +75,20 @@
   },
   "devDependencies": {
     "@eslint/js": "9.17.0",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/user-event": "^14.6.1",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.2",
+    "@testing-library/user-event": "14.6.1",
     "@types/node": "22.13.8",
     "@vitejs/plugin-react": "4.3.4",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-v8": "4.1.2",
     "eslint": "9.17.0",
     "eslint-plugin-react": "7.37.2",
     "globals": "15.13.0",
-    "jsdom": "^28.1.0",
+    "jsdom": "28.1.0",
     "typescript": "5.7.2",
     "typescript-eslint": "8.18.1",
-    "vite": "6.4.1",
+    "vite": "6.4.2",
     "vite-plugin-dts": "4.3.0",
-    "vitest": "^4.0.18"
+    "vitest": "4.1.2"
   }
 }

package/dist/utils/flatSvgExporter.d.ts

@@ -1,8 +0,0 @@
-import { SVG, UMLModel } from '../typings';
-export type FlatSvgExportOptions = {
-    margin?: number;
-    background?: "white" | "transparent";
-    fontFamily?: string;
-    fontSize?: number;
-};
-export declare const exportClassDiagramAsFlatSvg: (model: UMLModel, options?: FlatSvgExportOptions) => SVG;