@dr2rai/raid-canvas 0.1.0 → 0.3.0

package/dist/semanticRules.js

@@ -0,0 +1,201 @@
+/**
+ * @file semanticRules.ts
+ * @description Anti-entropy semantic connection validation and wiring rules
+ * for the AOAIM (Activity-Object-AI Model) graphical modeling contract.
+ *
+ * Enforces ontological integrity during edge creation:
+ * - 'per' -> 'uc'  : 'association' («initiates», «owns» [0..1], «participates» [0..*])
+ * - 'per' -> 'act' : 'association' («executes»)
+ * - 'uc'  -> 'uc'  : 'dependency'  («includes», «extends», «dependsOn»)
+ * - 'uc'  -> 'act' : 'dependency'  («includes»)
+ * - 'act' -> 'act' : 'association' («sequence» / process flow)
+ * - 'cls' -> 'cls' : 'association' («relatesTo»), 'generalization', 'composition', 'aggregation'
+ * - 'cls' -> 'obj' : 'dependency'  («instantiates»)
+ * - 'obj' -> 'obj' : 'association' («link»)
+ */
+/**
+ * Ontological connection rules matrix.
+ * Key: `${sourceKind}->${targetKind}`
+ */
+export const SEMANTIC_RULES_MATRIX = {
+    'per->uc': {
+        valid: true,
+        defaultEdgeKind: 'association',
+        defaultStereotype: '«initiates»',
+        description: 'Actor initiates, owns, or participates in UseCase',
+        availableStereotypes: [
+            {
+                stereotype: '«initiates»',
+                defaultCardinality: '1',
+                description: 'Initiating role triggering the UseCase flow',
+            },
+            {
+                stereotype: '«owns»',
+                defaultCardinality: '0..1',
+                description: 'Ownership relationship representing responsible party (cardinality 0..1)',
+            },
+            {
+                stereotype: '«participates»',
+                defaultCardinality: '0..*',
+                description: 'Participating role supporting the UseCase execution (cardinality 0..*)',
+            },
+        ],
+    },
+    'per->act': {
+        valid: true,
+        defaultEdgeKind: 'association',
+        defaultStereotype: '«executes»',
+        description: 'Actor directly performs or executes Activity',
+        availableStereotypes: [
+            {
+                stereotype: '«executes»',
+                description: 'Actor performs this process step',
+            },
+            {
+                stereotype: '«approves»',
+                description: 'Actor reviews or approves activity completion',
+            },
+        ],
+    },
+    'uc->uc': {
+        valid: true,
+        defaultEdgeKind: 'dependency',
+        defaultStereotype: '«includes»',
+        description: 'UseCase includes or extends sub-UseCase',
+        availableStereotypes: [
+            {
+                stereotype: '«includes»',
+                description: 'Mandatory sub-flow inclusion dependency',
+            },
+            {
+                stereotype: '«extends»',
+                description: 'Optional conditional extension point',
+            },
+            {
+                stereotype: '«dependsOn»',
+                description: 'Prerequisite functional dependency',
+            },
+        ],
+    },
+    'uc->act': {
+        valid: true,
+        defaultEdgeKind: 'dependency',
+        defaultStereotype: '«includes»',
+        description: 'UseCase elaborates downflow process Activity',
+        availableStereotypes: [
+            {
+                stereotype: '«includes»',
+                description: 'Process activity required by UseCase',
+            },
+            {
+                stereotype: '«triggers»',
+                description: 'UseCase execution triggers activity',
+            },
+        ],
+    },
+    'act->act': {
+        valid: true,
+        defaultEdgeKind: 'association',
+        defaultStereotype: '«sequence»',
+        description: 'Activity transitions to next process step',
+        availableStereotypes: [
+            {
+                stereotype: '«sequence»',
+                description: 'Sequential process transition',
+            },
+            {
+                stereotype: '«branch»',
+                description: 'Conditional decision branch',
+            },
+        ],
+    },
+    'cls->cls': {
+        valid: true,
+        defaultEdgeKind: 'association',
+        defaultStereotype: '«relatesTo»',
+        description: 'Domain structural relationship between Classes',
+        availableStereotypes: [
+            {
+                stereotype: '«relatesTo»',
+                defaultCardinality: '1..*',
+                description: 'General domain association',
+            },
+            {
+                stereotype: '«generalization»',
+                description: 'Inheritance classification (subclass is-a superclass)',
+            },
+            {
+                stereotype: '«composition»',
+                defaultCardinality: '1',
+                description: 'Composite whole-part lifecycle binding',
+            },
+            {
+                stereotype: '«aggregation»',
+                defaultCardinality: '0..*',
+                description: 'Shared aggregation relationship',
+            },
+        ],
+    },
+    'cls->obj': {
+        valid: true,
+        defaultEdgeKind: 'dependency',
+        defaultStereotype: '«instantiates»',
+        description: 'Class specifies runtime Object instance',
+        availableStereotypes: [
+            {
+                stereotype: '«instantiates»',
+                description: 'Class defines schema for runtime instance',
+            },
+        ],
+    },
+    'obj->obj': {
+        valid: true,
+        defaultEdgeKind: 'association',
+        defaultStereotype: '«link»',
+        description: 'Runtime communication link between Objects',
+        availableStereotypes: [
+            {
+                stereotype: '«link»',
+                description: 'Runtime object collaboration message link',
+            },
+        ],
+    },
+};
+/**
+ * Validates whether an edge connection between source and target archetypes is ontologically allowed.
+ */
+export function validateSemanticConnection(sourceKind, targetKind) {
+    if (!sourceKind || !targetKind)
+        return false;
+    const key = `${sourceKind}->${targetKind}`;
+    return SEMANTIC_RULES_MATRIX[key]?.valid ?? false;
+}
+/**
+ * Determines the canonical default relationship edge kind for a connected pair.
+ */
+export function getSemanticEdgeKind(sourceKind, targetKind) {
+    const key = `${sourceKind}->${targetKind}`;
+    return SEMANTIC_RULES_MATRIX[key]?.defaultEdgeKind ?? 'association';
+}
+/**
+ * Determines the canonical default stereotype annotation for a connected pair.
+ */
+export function getSemanticEdgeStereotype(sourceKind, targetKind) {
+    const key = `${sourceKind}->${targetKind}`;
+    return SEMANTIC_RULES_MATRIX[key]?.defaultStereotype ?? '';
+}
+/**
+ * Returns available ontological stereotypes and their default cardinalities for a pair.
+ */
+export function getAvailableStereotypes(sourceKind, targetKind) {
+    const key = `${sourceKind}->${targetKind}`;
+    return SEMANTIC_RULES_MATRIX[key]?.availableStereotypes ?? [];
+}
+/**
+ * Returns a human-readable description explaining the ontological relationship.
+ */
+export function getSemanticRuleDescription(sourceKind, targetKind) {
+    const key = `${sourceKind}->${targetKind}`;
+    return SEMANTIC_RULES_MATRIX[key]?.description ?? 'Invalid ontological connection';
+}
+//# sourceMappingURL=semanticRules.js.map

package/dist/semanticRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticRules.js","sourceRoot":"","sources":["../src/semanticRules.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -15,7 +15,14 @@
  * - 'obj' : Object / Instance (runtime instance card with underlined title)
  * - 'per' : Person / Actor (Initiating or Defined role stick-figure/card)
  */
-export type AimOntologyKind = 'uc' | 'act' | 'cls' | 'obj' | 'per';
+export type AimOntologyKind = 'act' | 'uc' | 'cls' | 'obj' | 'per';
+/**
+ * Routing strategy for diagram edges.
+ * - 'manhattan': Obstacle-avoiding 90° orthogonal routing with rounded corners (default).
+ * - 'normal': Direct straight line point-to-point connection.
+ * - 'smooth': Curved cubic bezier spline between ports.
+ */
+export type AimRoutingMode = 'manhattan' | 'normal' | 'smooth';
 /**
  * Ontological relationship classifications in AOAIM.
  */
@@ -94,6 +101,8 @@ export interface RaidEdgeData {
     readonly sourceCardinality?: string;
     /** Multiplicity / Cardinality at the target end (e.g., '0..1', '*'). */
     readonly targetCardinality?: string;
+    /** Routing strategy for this edge ('manhattan', 'normal', 'smooth'). */
+    readonly routing?: AimRoutingMode;
     /** User-editable or router-computed Manhattan bend points. */
     readonly bendPoints: readonly SvgBendPoint[];
 }
@@ -130,6 +139,7 @@ export declare const AimSvgContract: {
     readonly ATTR_TARGET: 'aim-target';
     readonly ATTR_SOURCE_PORT: 'aim-source-port';
     readonly ATTR_TARGET_PORT: 'aim-target-port';
+    readonly ATTR_ROUTING: 'aim-routing';
     readonly ATTR_BENDS: 'aim-bends';
     readonly SELECTOR_NODE: '[aim-node], [data-node], g[aim-kind]';
     readonly SELECTOR_EDGE: '[aim-edge], path[aim-edge-kind]';

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -24,6 +24,7 @@ export const AimSvgContract = {
     ATTR_TARGET: 'aim-target',
     ATTR_SOURCE_PORT: 'aim-source-port',
     ATTR_TARGET_PORT: 'aim-target-port',
+    ATTR_ROUTING: 'aim-routing',
     ATTR_BENDS: 'aim-bends',
     // Selectors for DOM queries
     SELECTOR_NODE: '[aim-node], [data-node], g[aim-kind]',

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoJH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,4BAA4B;IAC5B,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,UAAU;IACrB,iBAAiB,EAAE,kBAAkB;IACrC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,eAAe;IAE/B,4BAA4B;IAC5B,SAAS,EAAE,UAAU;IACrB,cAAc,EAAE,eAAe;IAC/B,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;IACzB,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,UAAU,EAAE,WAAW;IAEvB,4BAA4B;IAC5B,aAAa,EAAE,sCAAsC;IACrD,aAAa,EAAE,iCAAiC;CACxC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+JH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,4BAA4B;IAC5B,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,UAAU;IACrB,iBAAiB,EAAE,kBAAkB;IACrC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,eAAe;IAE/B,4BAA4B;IAC5B,SAAS,EAAE,UAAU;IACrB,cAAc,EAAE,eAAe;IAC/B,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,YAAY;IACzB,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,YAAY,EAAE,aAAa;IAC3B,UAAU,EAAE,WAAW;IAEvB,4BAA4B;IAC5B,aAAa,EAAE,sCAAsC;IACrD,aAAa,EAAE,iCAAiC;CACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr2rai/raid-canvas",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Interactive AntV X6 diagram canvas for AOAIM (.raid) models and ontological SVG contracts",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,16 @@
   "dependencies": {
     "@antv/x6": "^2.18.1"
   },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
   "devDependencies": {
     "@types/node": "^22.5.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "typescript": "^7.0.2"
   },
   "publishConfig": {
@@ -37,6 +45,6 @@
   "scripts": {
     "build": "tsc -b --force",
     "typecheck": "tsc --noEmit",
-    "test": "node --test test/canvas.test.mjs"
+    "test": "node --test test/canvas.test.mjs test/RaidCanvas.test.mjs test/semanticRules.test.mjs"
   }
 }

package/src/RaiBridge.ts

@@ -15,6 +15,7 @@ import {
   AimSvgContract,
   type AimOntologyKind,
   type AimEdgeKind,
+  type AimRoutingMode,
   type RaidNodeData,
   type RaidEdgeData,
   type RaidMetamodel,
@@ -138,6 +139,21 @@ export class RaiBridge {
       const targetPort = edge.getTargetPortId();
       const label = (edge.getLabels()?.[0]?.attrs?.['text']?.['text'] as string | undefined) ?? customData.label;
 
+      let routing: AimRoutingMode | undefined = customData.routing;
+      if (!routing) {
+        const router = edge.getRouter();
+        const routerName = typeof router === 'string' ? router : router?.name;
+        const connector = edge.getConnector();
+        const connectorName = typeof connector === 'string' ? connector : connector?.name;
+        if (connectorName === 'smooth') {
+          routing = 'smooth';
+        } else if (routerName === 'normal') {
+          routing = 'normal';
+        } else if (routerName === 'manhattan') {
+          routing = 'manhattan';
+        }
+      }
+
       const edgeData: RaidEdgeData = {
         id: edge.id,
         kind: customData.kind ?? 'association',
@@ -145,8 +161,11 @@ export class RaiBridge {
         targetId: target.id,
         ...(sourcePort !== undefined ? { sourcePort } : {}),
         ...(targetPort !== undefined ? { targetPort } : {}),
+        ...(routing !== undefined ? { routing } : {}),
         ...(label !== undefined ? { label } : {}),
         ...(customData.stereotype !== undefined ? { stereotype: customData.stereotype } : {}),
+        ...(customData.sourceCardinality !== undefined ? { sourceCardinality: customData.sourceCardinality } : {}),
+        ...(customData.targetCardinality !== undefined ? { targetCardinality: customData.targetCardinality } : {}),
         bendPoints,
       };
 
@@ -266,8 +285,74 @@ export class RaiBridge {
       const bendsAttr = el.getAttribute(AimSvgContract.ATTR_BENDS) ?? '';
       const bendPoints = this.parseBendPoints(bendsAttr);
 
-      const sourcePort = el.getAttribute(AimSvgContract.ATTR_SOURCE_PORT) ?? undefined;
-      const targetPort = el.getAttribute(AimSvgContract.ATTR_TARGET_PORT) ?? undefined;
+      const label =
+        el.getAttribute('aim-label') ??
+        el.querySelector('text')?.textContent?.trim() ??
+        undefined;
+
+      let sourcePort = el.getAttribute(AimSvgContract.ATTR_SOURCE_PORT) ?? undefined;
+      let targetPort = el.getAttribute(AimSvgContract.ATTR_TARGET_PORT) ?? undefined;
+
+      const sourceNode = nodes.find((n) => n.id === sourceId);
+      const targetNode = nodes.find((n) => n.id === targetId);
+
+      // Infer optimal orthogonal docking ports if not explicitly declared
+      if (sourceNode && targetNode) {
+        const dx =
+          targetNode.bounds.x +
+          targetNode.bounds.width / 2 -
+          (sourceNode.bounds.x + sourceNode.bounds.width / 2);
+        const dy =
+          targetNode.bounds.y +
+          targetNode.bounds.height / 2 -
+          (sourceNode.bounds.y + sourceNode.bounds.height / 2);
+
+        if (!sourcePort) {
+          sourcePort =
+            Math.abs(dx) >= Math.abs(dy)
+              ? dx >= 0
+                ? 'port-right'
+                : 'port-left'
+              : dy >= 0
+                ? 'port-bottom'
+                : 'port-top';
+        }
+        if (!targetPort) {
+          targetPort =
+            Math.abs(dx) >= Math.abs(dy)
+              ? dx >= 0
+                ? 'port-left'
+                : 'port-right'
+              : dy >= 0
+                ? 'port-top'
+                : 'port-bottom';
+        }
+      }
+
+      // If bendPoints contains only the 2 terminal endpoints of a straight connector,
+      // clear them so the orthogonal router doesn't treat the terminals as obstacle waypoints
+      const isTerminalOnly =
+        bendPoints.length === 2 &&
+        sourceNode &&
+        targetNode &&
+        ((Math.abs(bendPoints[0]!.y - bendPoints[1]!.y) < 2 &&
+          Math.abs(bendPoints[0]!.y - (sourceNode.bounds.y + sourceNode.bounds.height / 2)) < 40) ||
+          (Math.abs(bendPoints[0]!.x - bendPoints[1]!.x) < 2 &&
+            Math.abs(bendPoints[0]!.x - (sourceNode.bounds.x + sourceNode.bounds.width / 2)) < 40));
+      const effectiveBendPoints = isTerminalOnly ? [] : bendPoints;
+
+      const sourceCardinality =
+        el.getAttribute('aim-source-cardinality') ?? undefined;
+      const targetCardinality =
+        el.getAttribute('aim-target-cardinality') ?? undefined;
+      const rawRouting =
+        el.getAttribute(AimSvgContract.ATTR_ROUTING) ??
+        el.getAttribute('aim-routing') ??
+        undefined;
+      const routing =
+        rawRouting === 'normal' || rawRouting === 'smooth' || rawRouting === 'manhattan'
+          ? (rawRouting as AimRoutingMode)
+          : undefined;
 
       edges.push({
         id,
@@ -276,7 +361,11 @@ export class RaiBridge {
         targetId,
         ...(sourcePort !== undefined ? { sourcePort } : {}),
         ...(targetPort !== undefined ? { targetPort } : {}),
-        bendPoints,
+        ...(routing !== undefined ? { routing } : {}),
+        ...(label !== undefined ? { label } : {}),
+        ...(sourceCardinality !== undefined ? { sourceCardinality } : {}),
+        ...(targetCardinality !== undefined ? { targetCardinality } : {}),
+        bendPoints: effectiveBendPoints,
       });
     }
 
@@ -370,6 +459,30 @@ export class RaiBridge {
         el.setAttribute(AimSvgContract.ATTR_BENDS, bendsString);
         el.setAttribute(AimSvgContract.ATTR_EDGE, 'true');
         el.setAttribute(AimSvgContract.ATTR_EDGE_KIND, edge.kind);
+        if (edge.sourceId !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_SOURCE, edge.sourceId);
+        }
+        if (edge.targetId !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_TARGET, edge.targetId);
+        }
+        if (edge.sourcePort !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_SOURCE_PORT, edge.sourcePort);
+        }
+        if (edge.targetPort !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_TARGET_PORT, edge.targetPort);
+        }
+        if (edge.routing !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_ROUTING, edge.routing);
+        }
+        if (edge.stereotype !== undefined) {
+          el.setAttribute(AimSvgContract.ATTR_STEREOTYPE, edge.stereotype);
+        }
+        if (edge.sourceCardinality !== undefined) {
+          el.setAttribute('aim-source-cardinality', edge.sourceCardinality);
+        }
+        if (edge.targetCardinality !== undefined) {
+          el.setAttribute('aim-target-cardinality', edge.targetCardinality);
+        }
       }
     }
 
@@ -415,7 +528,11 @@ export class RaiBridge {
         pathD = `M ${first.x} ${first.y} ` + edge.bendPoints.slice(1).map((p) => `L ${p.x} ${p.y}`).join(' ');
       }
 
-      svg += `    <g ${AimSvgContract.ATTR_EDGE}="true" ${AimSvgContract.ATTR_ID}="${edge.id}" ${AimSvgContract.ATTR_EDGE_KIND}="${edge.kind}" ${AimSvgContract.ATTR_SOURCE}="${edge.sourceId}" ${AimSvgContract.ATTR_TARGET}="${edge.targetId}" ${AimSvgContract.ATTR_BENDS}="${bendsFormatted}">\n`;
+      const sourcePortAttr = edge.sourcePort ? ` ${AimSvgContract.ATTR_SOURCE_PORT}="${edge.sourcePort}"` : '';
+      const targetPortAttr = edge.targetPort ? ` ${AimSvgContract.ATTR_TARGET_PORT}="${edge.targetPort}"` : '';
+      const routingAttr = edge.routing ? ` ${AimSvgContract.ATTR_ROUTING}="${edge.routing}"` : '';
+
+      svg += `    <g ${AimSvgContract.ATTR_EDGE}="true" ${AimSvgContract.ATTR_ID}="${edge.id}" ${AimSvgContract.ATTR_EDGE_KIND}="${edge.kind}" ${AimSvgContract.ATTR_SOURCE}="${edge.sourceId}" ${AimSvgContract.ATTR_TARGET}="${edge.targetId}"${sourcePortAttr}${targetPortAttr}${routingAttr} ${AimSvgContract.ATTR_BENDS}="${bendsFormatted}">\n`;
       if (pathD) {
         svg += `      <path d="${pathD}" class="aim-edge"${strokeDash}${markerEnd} />\n`;
       }