@tumaet/apollon 5.0.0 → 5.1.0

package/dist/internals.d.ts

@@ -5,6 +5,7 @@ import { Node as Node_2 } from '@xyflow/react';
 import { NodeProps } from '@xyflow/react';
 import { OnEdgesChange } from '@xyflow/react';
 import { OnNodesChange } from '@xyflow/react';
+import { Position } from '@xyflow/react';
 import { StoreApi } from 'zustand';
 import * as Y from 'yjs';
 
@@ -49,6 +50,215 @@ declare type ApollonEdge = {
     data: OrthogonalEdgeData;
 };
 
+/**
+ * Flat, typed dictionary of the strings the editor renders itself. The library
+ * ships English defaults; a host overrides any subset via `labels` (a shallow,
+ * per-key merge). Strings that interpolate are functions so a translation keeps
+ * control of word order.
+ */
+declare interface ApollonLabels {
+    zoomToolbar: string;
+    zoomIn: string;
+    zoomOut: string;
+    fitView: string;
+    /** Tooltip on the % readout button. */
+    resetZoom: string;
+    /** Accessible name of the % readout (interpolates the live zoom level). */
+    zoomReadout: (percent: number) => string;
+    undo: string;
+    /** Tooltip incl. the keyboard shortcut. */
+    undoHint: string;
+    redo: string;
+    redoHint: string;
+    miniMap: string;
+    showMinimap: string;
+    /** Tooltip on the collapsed minimap toggle. */
+    showMinimapHint: string;
+    hideMinimap: string;
+    selectionActions: string;
+    elementPalette: string;
+    paletteModelView: string;
+    paletteSelectElementsView: string;
+    paletteHighlightHint: string;
+    edge: string;
+    label: string;
+    type: string;
+    connection: string;
+    stereotype: string;
+    object: string;
+    source: string;
+    target: string;
+    style: string;
+    selectPlaceholder: string;
+    addComment: string;
+    points: string;
+    negativePointsAllowed: string;
+    feedback: string;
+    deleteAssessment: string;
+    deleteAssessmentFor: (name: string) => string;
+    assessmentFor: (type: string) => string;
+    nextAssessment: string;
+    noComment: string;
+    notGraded: string;
+    node: string;
+    attribute: string;
+    method: string;
+    /** Visible title for a concrete node type identifier. */
+    nodeTypeLabel: (nodeType?: string) => string;
+    startEvent: string;
+    intermediateEvent: string;
+    gateway: string;
+    gatewayType: string;
+    startType: string;
+    endType: string;
+    intermediateType: string;
+    taskType: string;
+    marker: string;
+    pool: string;
+    task: string;
+    endEvent: string;
+    bpmnDefault: string;
+    bpmnTimer: string;
+    bpmnConditional: string;
+    bpmnSignal: string;
+    bpmnEscalation: string;
+    bpmnError: string;
+    bpmnCompensation: string;
+    bpmnTerminate: string;
+    bpmnMessageCatch: string;
+    bpmnMessageThrow: string;
+    bpmnTimerCatch: string;
+    bpmnEscalationThrow: string;
+    bpmnConditionalCatch: string;
+    bpmnLinkCatch: string;
+    bpmnLinkThrow: string;
+    bpmnCompensationThrow: string;
+    bpmnSignalCatch: string;
+    bpmnSignalThrow: string;
+    bpmnExclusive: string;
+    bpmnParallel: string;
+    bpmnInclusive: string;
+    bpmnEventBased: string;
+    bpmnComplex: string;
+    bpmnUser: string;
+    bpmnSend: string;
+    bpmnReceive: string;
+    bpmnManual: string;
+    bpmnBusinessRule: string;
+    bpmnScript: string;
+    bpmnMarkerNone: string;
+    bpmnParallelMultiInstance: string;
+    bpmnSequentialMultiInstance: string;
+    bpmnLoop: string;
+    marking: string;
+    tokens: string;
+    capacity: string;
+    weight: string;
+    setFiniteCapacity: string;
+    setInfiniteCapacity: string;
+    nonterminal: string;
+    terminal: string;
+    class: string;
+    classType: string;
+    abstractClass: string;
+    interface: string;
+    enumeration: string;
+    reorderAttribute: string;
+    newAttribute: string;
+    addAttribute: string;
+    deleteAttribute: string;
+    attributes: string;
+    reorderMethod: string;
+    newMethod: string;
+    addMethod: string;
+    deleteMethod: string;
+    methods: string;
+    markMethodAsAbstract: string;
+    unmarkMethodAsAbstract: string;
+    abstractMethod: string;
+    messages: string;
+    message: string;
+    addMessage: string;
+    deleteMessage: (label: string) => string;
+    switchDirection: (direction: string) => string;
+    switchDirectionFor: (label: string, direction: string) => string;
+    messagePlaceholder: (index: number) => string;
+    messageFallbackLabel: (index: number) => string;
+    messageExists: string;
+    duplicateMessage: string;
+    swimlane: string;
+    lanes: string;
+    reorderLane: string;
+    deleteLane: string;
+    addLane: string;
+    laneName: string;
+    defaultLaneName: (index: number) => string;
+    orientation: string;
+    orientationVertical: string;
+    orientationHorizontal: string;
+    resizeLane: string;
+    componentName: string;
+    subsystemName: string;
+    stereotypePlaceholder: string;
+    isInitialMarking: string;
+    actionTable: string;
+    actions: string;
+    id: string;
+    actionName: string;
+    condition: string;
+    deleteActionRow: string;
+    addActionRow: string;
+    showCrossbar: string;
+    negatedCondition: string;
+    edgeType: string;
+    swapSourceTarget: string;
+    multiplicityLabel: (name: string) => string;
+    roleLabel: (name: string) => string;
+    deleteEdge: string;
+    editEdge: string;
+    deploymentAssociation: string;
+    deploymentDependency: string;
+    providedInterface: string;
+    requiredInterface: string;
+    sequenceFlow: string;
+    messageFlow: string;
+    associationFlow: string;
+    dataAssociationFlow: string;
+    association: string;
+    include: string;
+    extend: string;
+    generalization: string;
+    biAssociation: string;
+    uniAssociation: string;
+    aggregation: string;
+    composition: string;
+    inheritance: string;
+    dependency: string;
+    realization: string;
+    lineColor: string;
+    textColor: string;
+    fillColor: string;
+    namePlaceholder: string;
+    editColors: string;
+    editColorsFor: (label: string) => string;
+    colorPicker: (label: string) => string;
+    pickColor: string;
+    customColor: string;
+    custom: string;
+    reset: string;
+    /** Interpolated a11y label + tooltip for the header stereotype toggle. */
+    stereotypeToggleLabel: (name: string) => string;
+    stereotypeToggleTooltip: (shown: boolean, name: string) => string;
+    attributeWord: string;
+    methodWord: string;
+    classWord: string;
+    objectWord: string;
+    communicationObjectWord: string;
+    componentWord: string;
+    subsystemWord: string;
+    nodeWord: string;
+}
+
 declare enum ApollonMode {
     Modelling = "Modelling",
     Exporting = "Exporting",
@@ -164,18 +374,38 @@ declare function Class({ id, width, height, data, }: NodeProps<Node_2<ClassNodeP
 
 declare type ClassNodeElement = {
     id: string;
+    /**
+     * Abstract modifier — renders the member's signature in italics (UML 2.5.1
+     * §9.4). Only ever set on *methods*: attributes are `StructuralFeature`s and
+     * cannot be abstract, so the attribute editor never surfaces the control.
+     */
+    isAbstract?: boolean;
 } & DefaultNodeProps;
 
 declare type ClassNodeProps = {
     methods: ClassNodeElement[];
     attributes: ClassNodeElement[];
-    stereotype?: ClassType;
+    /** Metaclass keyword only (`«interface»` / `«enumeration»`). */
+    stereotype?: ClassStereotype;
+    /**
+     * Class-level abstract modifier — renders the class name in italics (UML
+     * 2.5.1 §9.2.4). Orthogonal to `stereotype`; there is no `«abstract»` keyword.
+     */
+    isAbstract?: boolean;
 } & DefaultNodeProps;
 
-declare enum ClassType {
-    Abstract = "Abstract",
-    Interface = "Interface",
-    Enumeration = "Enumeration"
+/**
+ * UML class-diagram metaclass keywords, rendered in guillemets above the class
+ * name (e.g. `«interface»`). These are keywords denoting a distinct metaclass —
+ * NOT modifiers. Abstractness is a separate boolean (`isAbstract`), shown by an
+ * italic name, per UML 2.5.1 §9.2.4; there is no `«abstract»` keyword.
+ *
+ * Values are the serialized, already-lowercase spelling from the UML keyword
+ * table (UML 2.5.1 Annex C, Table C.1), so the stored value equals what renders.
+ */
+declare enum ClassStereotype {
+    Interface = "interface",
+    Enumeration = "enumeration"
 }
 
 declare type CollaborationCursor = {
@@ -286,6 +516,8 @@ declare type CustomEdgeProps = {
     targetRole: string | null;
     targetMultiplicity: string | null;
     points: IPoint[];
+    sourceAnchor?: FreeformEdgeAnchor;
+    targetAnchor?: FreeformEdgeAnchor;
     label?: string | null;
     messages?: MessageData[];
     strokeColor?: string;
@@ -514,6 +746,16 @@ declare function FlowchartProcess({ id, width, height, data, parentId, }: NodePr
 
 declare function FlowchartTerminal({ id, width, height, data, parentId, }: NodeProps<Node_2<DefaultNodeProps>>): JSX.Element | null;
 
+declare type FreeformEdgeAnchor = {
+    side: Position;
+    /**
+     * Offset along the side, normalized to the current node side length. The
+     * editor rounds the resolved point to whole flow pixels, so a drop can land
+     * on any pixel while still scaling sensibly if the node is resized later.
+     */
+    ratio: number;
+};
+
 declare type InteractiveElements = {
     elements: {
         [id: string]: boolean;
@@ -565,6 +807,8 @@ declare type MetadataStore = {
     readonly: boolean;
     debug: boolean;
     scrollLock: boolean;
+    /** User-facing strings for the editor's own chrome; host-overridable for i18n. */
+    labels: ApollonLabels;
     scrollEnabled: boolean;
     connectionGuidanceActive: boolean;
     connectionGuidanceSourceNodeId: string | null;
@@ -577,6 +821,7 @@ declare type MetadataStore = {
     setAvailableViews: (availableViews: ApollonView[]) => void;
     setReadonly: (readonly: boolean) => void;
     setScrollLock: (scrollLock: boolean) => void;
+    setLabels: (labels: ApollonLabels) => void;
     setScrollEnabled: (scrollEnabled: boolean) => void;
     startConnectionGuidance: (sourceNodeId: string | null, sourceHandleId: string | null) => void;
     stopConnectionGuidance: () => void;

package/dist/internals.js

@@ -1,11 +1,11 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, t as l, u } from "./versionConverter-C-s36Ory.js";
+import { _ as e, d as t, f as n, g as r, l as i, m as a, n as o, p as s, t as c, u as l, v as u } from "./yjsSync-BeQGvR_C.js";
 import * as d from "yjs";
 //#region lib/sync/headless.ts
 function f(e = new d.Doc()) {
 	let t = () => {};
 	return {
 		ydoc: e,
-		sync: new r(e, {
+		sync: new o(e, {
 			getState: () => ({
 				updateNodesFromYjs: t,
 				updateEdgesFromYjs: t,
@@ -26,4 +26,4 @@ function f(e = new d.Doc()) {
 	};
 }
 //#endregion
-export { n as MessageType, r as YjsSync, l as convertV2ToV4, o as convertV3EdgeTypeToV4, c as convertV3HandleToV4, i as convertV3MessagesToV4, e as convertV3NodeTypeToV4, s as convertV3ToV4, f as createHeadlessSync, t as isV2Format, a as isV3Format, u as isV4Format };
+export { c as MessageType, o as YjsSync, i as convertV2ToV4, l as convertV3EdgeTypeToV4, t as convertV3HandleToV4, n as convertV3MessagesToV4, s as convertV3NodeTypeToV4, a as convertV3ToV4, f as createHeadlessSync, r as isV2Format, e as isV3Format, u as isV4Format };