@almadar/ui 5.93.0 → 5.94.1

package/dist/lib/index.cjs

@@ -1523,12 +1523,300 @@ function parseContentSegments(content) {
   return segments;
 }
 
+// lib/jazari/layout.ts
+var GEAR_RADIUS = 35;
+var GEAR_SPACING = 130;
+var PADDING_X = 80;
+var PADDING_Y = 120;
+var ARC_HEIGHT = 70;
+var SELF_LOOP_RADIUS = 30;
+var PARALLEL_OFFSET = 24;
+function orderStates(states, transitions) {
+  const initial = states.find((s) => s.isInitial);
+  if (!initial) {
+    return states.map((s) => s.name);
+  }
+  const adj = /* @__PURE__ */ new Map();
+  for (const t of transitions) {
+    const existing = adj.get(t.from) ?? [];
+    existing.push(t.to);
+    adj.set(t.from, existing);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const order = [];
+  const queue = [initial.name];
+  visited.add(initial.name);
+  while (queue.length > 0) {
+    const current = queue.shift();
+    order.push(current);
+    const neighbors = adj.get(current) ?? [];
+    for (const next of neighbors) {
+      if (!visited.has(next)) {
+        visited.add(next);
+        queue.push(next);
+      }
+    }
+  }
+  for (const s of states) {
+    if (!visited.has(s.name)) {
+      order.push(s.name);
+    }
+  }
+  return order;
+}
+function quadBezierPoint(x0, y0, cx, cy, x1, y1, t) {
+  const mt = 1 - t;
+  return {
+    x: mt * mt * x0 + 2 * mt * t * cx + t * t * x1,
+    y: mt * mt * y0 + 2 * mt * t * cy + t * t * y1
+  };
+}
+function computeJazariLayout(input) {
+  const { states, transitions, entityFields = [], direction = "ltr" } = input;
+  if (states.length === 0) {
+    return {
+      width: 200,
+      height: 200,
+      gears: [],
+      arms: [],
+      axisY: 100,
+      axisStartX: 0,
+      axisEndX: 200,
+      entityFields,
+      direction
+    };
+  }
+  const stateOrder = orderStates(states, transitions);
+  const stateMap = new Map(states.map((s) => [s.name, s]));
+  const stateIndex = new Map(stateOrder.map((name, i) => [name, i]));
+  const totalWidth = PADDING_X * 2 + (stateOrder.length - 1) * GEAR_SPACING;
+  const axisY = PADDING_Y + ARC_HEIGHT + SELF_LOOP_RADIUS + 10;
+  const height = axisY + PADDING_Y + ARC_HEIGHT + SELF_LOOP_RADIUS + 10;
+  const gears = stateOrder.map((name, i) => {
+    const state = stateMap.get(name);
+    const xPos = direction === "rtl" ? totalWidth - PADDING_X - i * GEAR_SPACING : PADDING_X + i * GEAR_SPACING;
+    return {
+      name,
+      cx: xPos,
+      cy: axisY,
+      radius: GEAR_RADIUS,
+      isInitial: state?.isInitial === true,
+      isTerminal: state?.isTerminal === true || state?.isFinal === true
+    };
+  });
+  const pairCounts = /* @__PURE__ */ new Map();
+  const pairIndices = /* @__PURE__ */ new Map();
+  for (const t of transitions) {
+    const pairKey = `${t.from}|${t.to}`;
+    pairCounts.set(pairKey, (pairCounts.get(pairKey) ?? 0) + 1);
+  }
+  const arms = transitions.map((t) => {
+    const pairKey = `${t.from}|${t.to}`;
+    const currentIdx = pairIndices.get(pairKey) ?? 0;
+    pairIndices.set(pairKey, currentIdx + 1);
+    const pairCount = pairCounts.get(pairKey) ?? 1;
+    const parallelShift = (currentIdx - (pairCount - 1) / 2) * PARALLEL_OFFSET;
+    const fromIdx = stateIndex.get(t.from) ?? 0;
+    const toIdx = stateIndex.get(t.to) ?? 0;
+    const fromGear = gears[fromIdx];
+    const toGear = gears[toIdx];
+    if (!fromGear || !toGear) {
+      return {
+        from: t.from,
+        to: t.to,
+        event: t.event,
+        path: "",
+        labelX: 0,
+        labelY: 0,
+        guard: null,
+        effect: null,
+        isSelfLoop: false
+      };
+    }
+    const isSelfLoop = t.from === t.to;
+    let path;
+    let labelX;
+    let labelY;
+    let ctrlX;
+    let ctrlY;
+    if (isSelfLoop) {
+      const loopY = fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS - 5;
+      path = [
+        `M ${fromGear.cx - 12} ${fromGear.cy - GEAR_RADIUS}`,
+        `C ${fromGear.cx - 25} ${loopY - 15}, ${fromGear.cx + 25} ${loopY - 15}, ${fromGear.cx + 12} ${fromGear.cy - GEAR_RADIUS}`
+      ].join(" ");
+      labelX = fromGear.cx;
+      labelY = loopY - 10;
+      ctrlX = fromGear.cx;
+      ctrlY = loopY;
+    } else {
+      const isForward = direction === "rtl" ? fromIdx > toIdx : fromIdx < toIdx;
+      const arcSign = isForward ? -1 : 1;
+      const midX = (fromGear.cx + toGear.cx) / 2;
+      ctrlY = axisY + arcSign * (ARC_HEIGHT + Math.abs(parallelShift));
+      ctrlX = midX;
+      const perimeterR = GEAR_RADIUS + 7;
+      const dx = toGear.cx - fromGear.cx;
+      const dy = toGear.cy - fromGear.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy);
+      const startX = dist > 0 ? fromGear.cx + dx / dist * perimeterR : fromGear.cx;
+      const startY = dist > 0 ? fromGear.cy + dy / dist * perimeterR : fromGear.cy;
+      const endX = dist > 0 ? toGear.cx - dx / dist * perimeterR : toGear.cx;
+      const endY = dist > 0 ? toGear.cy - dy / dist * perimeterR : toGear.cy;
+      path = `M ${startX} ${startY} Q ${ctrlX} ${ctrlY} ${endX} ${endY}`;
+      const mid = quadBezierPoint(startX, startY, ctrlX, ctrlY, endX, endY, 0.5);
+      labelX = mid.x;
+      labelY = mid.y;
+    }
+    let guard = null;
+    if (t.guard != null) {
+      const isAI = Array.isArray(t.guard) && typeof t.guard[0] === "string" && t.guard[0] === "call-service";
+      if (isSelfLoop) {
+        guard = { x: fromGear.cx - 18, y: fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS, isAI };
+      } else {
+        const gp = quadBezierPoint(fromGear.cx, fromGear.cy, ctrlX, ctrlY, toGear.cx, toGear.cy, 0.3);
+        guard = { x: gp.x, y: gp.y, isAI };
+      }
+    }
+    let effect = null;
+    if (t.effects && t.effects.length > 0) {
+      const names = t.effects.map((e) => {
+        if (Array.isArray(e)) return JSON.stringify(e);
+        return String(e);
+      });
+      if (isSelfLoop) {
+        effect = { x: fromGear.cx + 18, y: fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS, count: t.effects.length, names };
+      } else {
+        const ep = quadBezierPoint(fromGear.cx, fromGear.cy, ctrlX, ctrlY, toGear.cx, toGear.cy, 0.7);
+        effect = { x: ep.x, y: ep.y, count: t.effects.length, names };
+      }
+    }
+    return {
+      from: t.from,
+      to: t.to,
+      event: t.event,
+      path,
+      labelX,
+      labelY,
+      guard,
+      effect,
+      isSelfLoop
+    };
+  });
+  return {
+    width: totalWidth,
+    height,
+    gears,
+    arms,
+    axisY,
+    axisStartX: direction === "rtl" ? gears[gears.length - 1]?.cx ?? PADDING_X : gears[0]?.cx ?? PADDING_X,
+    axisEndX: direction === "rtl" ? gears[0]?.cx ?? totalWidth - PADDING_X : gears[gears.length - 1]?.cx ?? totalWidth - PADDING_X,
+    entityFields,
+    direction
+  };
+}
+
+// lib/jazari/svg-paths.ts
+function gearTeethPath(cx, cy, innerRadius, outerRadius, numTeeth) {
+  const parts = [];
+  const angleStep = Math.PI * 2 / numTeeth;
+  const halfTooth = angleStep * 0.25;
+  for (let i = 0; i < numTeeth; i++) {
+    const baseAngle = i * angleStep;
+    const x0 = cx + innerRadius * Math.cos(baseAngle - halfTooth);
+    const y0 = cy + innerRadius * Math.sin(baseAngle - halfTooth);
+    const x1 = cx + outerRadius * Math.cos(baseAngle - halfTooth * 0.4);
+    const y1 = cy + outerRadius * Math.sin(baseAngle - halfTooth * 0.4);
+    const x2 = cx + outerRadius * Math.cos(baseAngle + halfTooth * 0.4);
+    const y2 = cy + outerRadius * Math.sin(baseAngle + halfTooth * 0.4);
+    const x3 = cx + innerRadius * Math.cos(baseAngle + halfTooth);
+    const y3 = cy + innerRadius * Math.sin(baseAngle + halfTooth);
+    if (i === 0) {
+      parts.push(`M ${x0.toFixed(1)} ${y0.toFixed(1)}`);
+    } else {
+      parts.push(`L ${x0.toFixed(1)} ${y0.toFixed(1)}`);
+    }
+    parts.push(`L ${x1.toFixed(1)} ${y1.toFixed(1)}`);
+    parts.push(`L ${x2.toFixed(1)} ${y2.toFixed(1)}`);
+    parts.push(`L ${x3.toFixed(1)} ${y3.toFixed(1)}`);
+  }
+  parts.push("Z");
+  return parts.join(" ");
+}
+function lockIconPath(cx, cy, size) {
+  const bodyW = size * 0.7;
+  const bodyH = size * 0.5;
+  const bodyX = cx - bodyW / 2;
+  const bodyY = cy - bodyH / 4;
+  const body = `M ${bodyX.toFixed(1)} ${bodyY.toFixed(1)} h ${bodyW.toFixed(1)} v ${bodyH.toFixed(1)} h ${(-bodyW).toFixed(1)} Z`;
+  const shR = size * 0.28;
+  const shY = bodyY;
+  const shackle = `M ${(cx - shR).toFixed(1)} ${shY.toFixed(1)} A ${shR.toFixed(1)} ${(shR * 1.2).toFixed(1)} 0 1 1 ${(cx + shR).toFixed(1)} ${shY.toFixed(1)}`;
+  const kR = size * 0.08;
+  const kY = bodyY + bodyH * 0.35;
+  const keyhole = `M ${cx.toFixed(1)} ${(kY - kR).toFixed(1)} a ${kR.toFixed(1)} ${kR.toFixed(1)} 0 1 1 0 ${(kR * 2).toFixed(1)} a ${kR.toFixed(1)} ${kR.toFixed(1)} 0 1 1 0 ${(-kR * 2).toFixed(1)} Z`;
+  return `${body} ${shackle} ${keyhole}`;
+}
+function brainIconPath(cx, cy, size) {
+  const s = size / 2;
+  return [
+    `M ${cx.toFixed(1)} ${(cy - s).toFixed(1)}`,
+    `C ${(cx - s * 1.2).toFixed(1)} ${(cy - s).toFixed(1)}, ${(cx - s * 1.3).toFixed(1)} ${(cy + s * 0.3).toFixed(1)}, ${cx.toFixed(1)} ${(cy + s).toFixed(1)}`,
+    `C ${(cx + s * 1.3).toFixed(1)} ${(cy + s * 0.3).toFixed(1)}, ${(cx + s * 1.2).toFixed(1)} ${(cy - s).toFixed(1)}, ${cx.toFixed(1)} ${(cy - s).toFixed(1)}`,
+    "Z",
+    // Dividing line
+    `M ${cx.toFixed(1)} ${(cy - s * 0.8).toFixed(1)}`,
+    `C ${(cx - s * 0.2).toFixed(1)} ${(cy - s * 0.2).toFixed(1)}, ${(cx + s * 0.2).toFixed(1)} ${(cy + s * 0.2).toFixed(1)}, ${cx.toFixed(1)} ${(cy + s * 0.8).toFixed(1)}`
+  ].join(" ");
+}
+function pipeIconPath(cx, cy, size) {
+  const w = size * 0.6;
+  const h = size * 0.3;
+  const flangeW = size * 0.8;
+  const flangeH = size * 0.1;
+  const tube = `M ${(cx - w / 2).toFixed(1)} ${(cy - h / 2).toFixed(1)} h ${w.toFixed(1)} v ${h.toFixed(1)} h ${(-w).toFixed(1)} Z`;
+  const lf = `M ${(cx - flangeW / 2).toFixed(1)} ${(cy - h / 2 - flangeH).toFixed(1)} h ${flangeH.toFixed(1)} v ${(h + flangeH * 2).toFixed(1)} h ${(-flangeH).toFixed(1)} Z`;
+  const rf = `M ${(cx + flangeW / 2 - flangeH).toFixed(1)} ${(cy - h / 2 - flangeH).toFixed(1)} h ${flangeH.toFixed(1)} v ${(h + flangeH * 2).toFixed(1)} h ${(-flangeH).toFixed(1)} Z`;
+  return `${tube} ${lf} ${rf}`;
+}
+function eightPointedStarPath(cx, cy, outerR, innerR) {
+  const points = [];
+  const numPoints = 8;
+  const angleStep = Math.PI / numPoints;
+  for (let i = 0; i < numPoints * 2; i++) {
+    const angle = i * angleStep - Math.PI / 2;
+    const r = i % 2 === 0 ? outerR : innerR;
+    const x = cx + r * Math.cos(angle);
+    const y = cy + r * Math.sin(angle);
+    points.push(`${i === 0 ? "M" : "L"} ${x.toFixed(1)} ${y.toFixed(1)}`);
+  }
+  points.push("Z");
+  return points.join(" ");
+}
+function arrowheadPath(size) {
+  return `M 0 0 L ${size} ${size / 2} L 0 ${size} Z`;
+}
+
+// lib/jazari/types.ts
+var JAZARI_COLORS = {
+  brass: "#B87333",
+  gold: "#C8A951",
+  sky: "#0EA5E9",
+  crimson: "#DC2626",
+  lapis: "#1E40AF",
+  ivory: "#FFFBEB",
+  darkBg: "#1a1a2e"
+};
+
 exports.ApiError = ApiError;
 exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.JAZARI_COLORS = JAZARI_COLORS;
 exports.apiClient = apiClient;
+exports.arrowheadPath = arrowheadPath;
 exports.bindCanvasCapture = bindCanvasCapture;
 exports.bindEventBus = bindEventBus;
 exports.bindTraitStateGetter = bindTraitStateGetter;
+exports.brainIconPath = brainIconPath;
 exports.clearDebugEvents = clearDebugEvents;
 exports.clearEntityProvider = clearEntityProvider;
 exports.clearGuardHistory = clearGuardHistory;
@@ -1536,6 +1824,7 @@ exports.clearTicks = clearTicks;
 exports.clearTraits = clearTraits;
 exports.clearVerification = clearVerification;
 exports.cn = cn;
+exports.computeJazariLayout = computeJazariLayout;
 exports.debug = debug;
 exports.debugCollision = debugCollision;
 exports.debugError = debugError;
@@ -1548,10 +1837,12 @@ exports.debugTable = debugTable;
 exports.debugTime = debugTime;
 exports.debugTimeEnd = debugTimeEnd;
 exports.debugWarn = debugWarn;
+exports.eightPointedStarPath = eightPointedStarPath;
 exports.extractOutputsFromTransitions = extractOutputsFromTransitions;
 exports.extractStateMachine = extractStateMachine;
 exports.formatGuard = formatGuard;
 exports.formatNestedFieldLabel = formatNestedFieldLabel;
+exports.gearTeethPath = gearTeethPath;
 exports.getAllChecks = getAllChecks;
 exports.getAllTicks = getAllTicks;
 exports.getAllTraits = getAllTraits;
@@ -1577,6 +1868,7 @@ exports.getTransitions = getTransitions;
 exports.getTransitionsForTrait = getTransitionsForTrait;
 exports.initDebugShortcut = initDebugShortcut;
 exports.isDebugEnabled = isDebugEnabled;
+exports.lockIconPath = lockIconPath;
 exports.logDebugEvent = logDebugEvent;
 exports.logEffectExecuted = logEffectExecuted;
 exports.logError = logError;
@@ -1587,6 +1879,7 @@ exports.logWarning = logWarning;
 exports.onDebugToggle = onDebugToggle;
 exports.parseContentSegments = parseContentSegments;
 exports.parseMarkdownWithCodeBlocks = parseMarkdownWithCodeBlocks;
+exports.pipeIconPath = pipeIconPath;
 exports.recordGuardEvaluation = recordGuardEvaluation;
 exports.recordServerResponse = recordServerResponse;
 exports.recordTransition = recordTransition;

package/dist/lib/index.d.ts

@@ -16,3 +16,4 @@ export * from './verificationRegistry';
 export * from './getNestedValue';
 export * from './visualizer/index';
 export * from './parseContentSegments';
+export * from './jazari/index';

package/dist/lib/index.js

@@ -1521,4 +1521,289 @@ function parseContentSegments(content) {
   return segments;
 }
 
-export { ApiError, DEFAULT_CONFIG, apiClient, bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };
+// lib/jazari/layout.ts
+var GEAR_RADIUS = 35;
+var GEAR_SPACING = 130;
+var PADDING_X = 80;
+var PADDING_Y = 120;
+var ARC_HEIGHT = 70;
+var SELF_LOOP_RADIUS = 30;
+var PARALLEL_OFFSET = 24;
+function orderStates(states, transitions) {
+  const initial = states.find((s) => s.isInitial);
+  if (!initial) {
+    return states.map((s) => s.name);
+  }
+  const adj = /* @__PURE__ */ new Map();
+  for (const t of transitions) {
+    const existing = adj.get(t.from) ?? [];
+    existing.push(t.to);
+    adj.set(t.from, existing);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const order = [];
+  const queue = [initial.name];
+  visited.add(initial.name);
+  while (queue.length > 0) {
+    const current = queue.shift();
+    order.push(current);
+    const neighbors = adj.get(current) ?? [];
+    for (const next of neighbors) {
+      if (!visited.has(next)) {
+        visited.add(next);
+        queue.push(next);
+      }
+    }
+  }
+  for (const s of states) {
+    if (!visited.has(s.name)) {
+      order.push(s.name);
+    }
+  }
+  return order;
+}
+function quadBezierPoint(x0, y0, cx, cy, x1, y1, t) {
+  const mt = 1 - t;
+  return {
+    x: mt * mt * x0 + 2 * mt * t * cx + t * t * x1,
+    y: mt * mt * y0 + 2 * mt * t * cy + t * t * y1
+  };
+}
+function computeJazariLayout(input) {
+  const { states, transitions, entityFields = [], direction = "ltr" } = input;
+  if (states.length === 0) {
+    return {
+      width: 200,
+      height: 200,
+      gears: [],
+      arms: [],
+      axisY: 100,
+      axisStartX: 0,
+      axisEndX: 200,
+      entityFields,
+      direction
+    };
+  }
+  const stateOrder = orderStates(states, transitions);
+  const stateMap = new Map(states.map((s) => [s.name, s]));
+  const stateIndex = new Map(stateOrder.map((name, i) => [name, i]));
+  const totalWidth = PADDING_X * 2 + (stateOrder.length - 1) * GEAR_SPACING;
+  const axisY = PADDING_Y + ARC_HEIGHT + SELF_LOOP_RADIUS + 10;
+  const height = axisY + PADDING_Y + ARC_HEIGHT + SELF_LOOP_RADIUS + 10;
+  const gears = stateOrder.map((name, i) => {
+    const state = stateMap.get(name);
+    const xPos = direction === "rtl" ? totalWidth - PADDING_X - i * GEAR_SPACING : PADDING_X + i * GEAR_SPACING;
+    return {
+      name,
+      cx: xPos,
+      cy: axisY,
+      radius: GEAR_RADIUS,
+      isInitial: state?.isInitial === true,
+      isTerminal: state?.isTerminal === true || state?.isFinal === true
+    };
+  });
+  const pairCounts = /* @__PURE__ */ new Map();
+  const pairIndices = /* @__PURE__ */ new Map();
+  for (const t of transitions) {
+    const pairKey = `${t.from}|${t.to}`;
+    pairCounts.set(pairKey, (pairCounts.get(pairKey) ?? 0) + 1);
+  }
+  const arms = transitions.map((t) => {
+    const pairKey = `${t.from}|${t.to}`;
+    const currentIdx = pairIndices.get(pairKey) ?? 0;
+    pairIndices.set(pairKey, currentIdx + 1);
+    const pairCount = pairCounts.get(pairKey) ?? 1;
+    const parallelShift = (currentIdx - (pairCount - 1) / 2) * PARALLEL_OFFSET;
+    const fromIdx = stateIndex.get(t.from) ?? 0;
+    const toIdx = stateIndex.get(t.to) ?? 0;
+    const fromGear = gears[fromIdx];
+    const toGear = gears[toIdx];
+    if (!fromGear || !toGear) {
+      return {
+        from: t.from,
+        to: t.to,
+        event: t.event,
+        path: "",
+        labelX: 0,
+        labelY: 0,
+        guard: null,
+        effect: null,
+        isSelfLoop: false
+      };
+    }
+    const isSelfLoop = t.from === t.to;
+    let path;
+    let labelX;
+    let labelY;
+    let ctrlX;
+    let ctrlY;
+    if (isSelfLoop) {
+      const loopY = fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS - 5;
+      path = [
+        `M ${fromGear.cx - 12} ${fromGear.cy - GEAR_RADIUS}`,
+        `C ${fromGear.cx - 25} ${loopY - 15}, ${fromGear.cx + 25} ${loopY - 15}, ${fromGear.cx + 12} ${fromGear.cy - GEAR_RADIUS}`
+      ].join(" ");
+      labelX = fromGear.cx;
+      labelY = loopY - 10;
+      ctrlX = fromGear.cx;
+      ctrlY = loopY;
+    } else {
+      const isForward = direction === "rtl" ? fromIdx > toIdx : fromIdx < toIdx;
+      const arcSign = isForward ? -1 : 1;
+      const midX = (fromGear.cx + toGear.cx) / 2;
+      ctrlY = axisY + arcSign * (ARC_HEIGHT + Math.abs(parallelShift));
+      ctrlX = midX;
+      const perimeterR = GEAR_RADIUS + 7;
+      const dx = toGear.cx - fromGear.cx;
+      const dy = toGear.cy - fromGear.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy);
+      const startX = dist > 0 ? fromGear.cx + dx / dist * perimeterR : fromGear.cx;
+      const startY = dist > 0 ? fromGear.cy + dy / dist * perimeterR : fromGear.cy;
+      const endX = dist > 0 ? toGear.cx - dx / dist * perimeterR : toGear.cx;
+      const endY = dist > 0 ? toGear.cy - dy / dist * perimeterR : toGear.cy;
+      path = `M ${startX} ${startY} Q ${ctrlX} ${ctrlY} ${endX} ${endY}`;
+      const mid = quadBezierPoint(startX, startY, ctrlX, ctrlY, endX, endY, 0.5);
+      labelX = mid.x;
+      labelY = mid.y;
+    }
+    let guard = null;
+    if (t.guard != null) {
+      const isAI = Array.isArray(t.guard) && typeof t.guard[0] === "string" && t.guard[0] === "call-service";
+      if (isSelfLoop) {
+        guard = { x: fromGear.cx - 18, y: fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS, isAI };
+      } else {
+        const gp = quadBezierPoint(fromGear.cx, fromGear.cy, ctrlX, ctrlY, toGear.cx, toGear.cy, 0.3);
+        guard = { x: gp.x, y: gp.y, isAI };
+      }
+    }
+    let effect = null;
+    if (t.effects && t.effects.length > 0) {
+      const names = t.effects.map((e) => {
+        if (Array.isArray(e)) return JSON.stringify(e);
+        return String(e);
+      });
+      if (isSelfLoop) {
+        effect = { x: fromGear.cx + 18, y: fromGear.cy - GEAR_RADIUS - SELF_LOOP_RADIUS, count: t.effects.length, names };
+      } else {
+        const ep = quadBezierPoint(fromGear.cx, fromGear.cy, ctrlX, ctrlY, toGear.cx, toGear.cy, 0.7);
+        effect = { x: ep.x, y: ep.y, count: t.effects.length, names };
+      }
+    }
+    return {
+      from: t.from,
+      to: t.to,
+      event: t.event,
+      path,
+      labelX,
+      labelY,
+      guard,
+      effect,
+      isSelfLoop
+    };
+  });
+  return {
+    width: totalWidth,
+    height,
+    gears,
+    arms,
+    axisY,
+    axisStartX: direction === "rtl" ? gears[gears.length - 1]?.cx ?? PADDING_X : gears[0]?.cx ?? PADDING_X,
+    axisEndX: direction === "rtl" ? gears[0]?.cx ?? totalWidth - PADDING_X : gears[gears.length - 1]?.cx ?? totalWidth - PADDING_X,
+    entityFields,
+    direction
+  };
+}
+
+// lib/jazari/svg-paths.ts
+function gearTeethPath(cx, cy, innerRadius, outerRadius, numTeeth) {
+  const parts = [];
+  const angleStep = Math.PI * 2 / numTeeth;
+  const halfTooth = angleStep * 0.25;
+  for (let i = 0; i < numTeeth; i++) {
+    const baseAngle = i * angleStep;
+    const x0 = cx + innerRadius * Math.cos(baseAngle - halfTooth);
+    const y0 = cy + innerRadius * Math.sin(baseAngle - halfTooth);
+    const x1 = cx + outerRadius * Math.cos(baseAngle - halfTooth * 0.4);
+    const y1 = cy + outerRadius * Math.sin(baseAngle - halfTooth * 0.4);
+    const x2 = cx + outerRadius * Math.cos(baseAngle + halfTooth * 0.4);
+    const y2 = cy + outerRadius * Math.sin(baseAngle + halfTooth * 0.4);
+    const x3 = cx + innerRadius * Math.cos(baseAngle + halfTooth);
+    const y3 = cy + innerRadius * Math.sin(baseAngle + halfTooth);
+    if (i === 0) {
+      parts.push(`M ${x0.toFixed(1)} ${y0.toFixed(1)}`);
+    } else {
+      parts.push(`L ${x0.toFixed(1)} ${y0.toFixed(1)}`);
+    }
+    parts.push(`L ${x1.toFixed(1)} ${y1.toFixed(1)}`);
+    parts.push(`L ${x2.toFixed(1)} ${y2.toFixed(1)}`);
+    parts.push(`L ${x3.toFixed(1)} ${y3.toFixed(1)}`);
+  }
+  parts.push("Z");
+  return parts.join(" ");
+}
+function lockIconPath(cx, cy, size) {
+  const bodyW = size * 0.7;
+  const bodyH = size * 0.5;
+  const bodyX = cx - bodyW / 2;
+  const bodyY = cy - bodyH / 4;
+  const body = `M ${bodyX.toFixed(1)} ${bodyY.toFixed(1)} h ${bodyW.toFixed(1)} v ${bodyH.toFixed(1)} h ${(-bodyW).toFixed(1)} Z`;
+  const shR = size * 0.28;
+  const shY = bodyY;
+  const shackle = `M ${(cx - shR).toFixed(1)} ${shY.toFixed(1)} A ${shR.toFixed(1)} ${(shR * 1.2).toFixed(1)} 0 1 1 ${(cx + shR).toFixed(1)} ${shY.toFixed(1)}`;
+  const kR = size * 0.08;
+  const kY = bodyY + bodyH * 0.35;
+  const keyhole = `M ${cx.toFixed(1)} ${(kY - kR).toFixed(1)} a ${kR.toFixed(1)} ${kR.toFixed(1)} 0 1 1 0 ${(kR * 2).toFixed(1)} a ${kR.toFixed(1)} ${kR.toFixed(1)} 0 1 1 0 ${(-kR * 2).toFixed(1)} Z`;
+  return `${body} ${shackle} ${keyhole}`;
+}
+function brainIconPath(cx, cy, size) {
+  const s = size / 2;
+  return [
+    `M ${cx.toFixed(1)} ${(cy - s).toFixed(1)}`,
+    `C ${(cx - s * 1.2).toFixed(1)} ${(cy - s).toFixed(1)}, ${(cx - s * 1.3).toFixed(1)} ${(cy + s * 0.3).toFixed(1)}, ${cx.toFixed(1)} ${(cy + s).toFixed(1)}`,
+    `C ${(cx + s * 1.3).toFixed(1)} ${(cy + s * 0.3).toFixed(1)}, ${(cx + s * 1.2).toFixed(1)} ${(cy - s).toFixed(1)}, ${cx.toFixed(1)} ${(cy - s).toFixed(1)}`,
+    "Z",
+    // Dividing line
+    `M ${cx.toFixed(1)} ${(cy - s * 0.8).toFixed(1)}`,
+    `C ${(cx - s * 0.2).toFixed(1)} ${(cy - s * 0.2).toFixed(1)}, ${(cx + s * 0.2).toFixed(1)} ${(cy + s * 0.2).toFixed(1)}, ${cx.toFixed(1)} ${(cy + s * 0.8).toFixed(1)}`
+  ].join(" ");
+}
+function pipeIconPath(cx, cy, size) {
+  const w = size * 0.6;
+  const h = size * 0.3;
+  const flangeW = size * 0.8;
+  const flangeH = size * 0.1;
+  const tube = `M ${(cx - w / 2).toFixed(1)} ${(cy - h / 2).toFixed(1)} h ${w.toFixed(1)} v ${h.toFixed(1)} h ${(-w).toFixed(1)} Z`;
+  const lf = `M ${(cx - flangeW / 2).toFixed(1)} ${(cy - h / 2 - flangeH).toFixed(1)} h ${flangeH.toFixed(1)} v ${(h + flangeH * 2).toFixed(1)} h ${(-flangeH).toFixed(1)} Z`;
+  const rf = `M ${(cx + flangeW / 2 - flangeH).toFixed(1)} ${(cy - h / 2 - flangeH).toFixed(1)} h ${flangeH.toFixed(1)} v ${(h + flangeH * 2).toFixed(1)} h ${(-flangeH).toFixed(1)} Z`;
+  return `${tube} ${lf} ${rf}`;
+}
+function eightPointedStarPath(cx, cy, outerR, innerR) {
+  const points = [];
+  const numPoints = 8;
+  const angleStep = Math.PI / numPoints;
+  for (let i = 0; i < numPoints * 2; i++) {
+    const angle = i * angleStep - Math.PI / 2;
+    const r = i % 2 === 0 ? outerR : innerR;
+    const x = cx + r * Math.cos(angle);
+    const y = cy + r * Math.sin(angle);
+    points.push(`${i === 0 ? "M" : "L"} ${x.toFixed(1)} ${y.toFixed(1)}`);
+  }
+  points.push("Z");
+  return points.join(" ");
+}
+function arrowheadPath(size) {
+  return `M 0 0 L ${size} ${size / 2} L 0 ${size} Z`;
+}
+
+// lib/jazari/types.ts
+var JAZARI_COLORS = {
+  brass: "#B87333",
+  gold: "#C8A951",
+  sky: "#0EA5E9",
+  crimson: "#DC2626",
+  lapis: "#1E40AF",
+  ivory: "#FFFBEB",
+  darkBg: "#1a1a2e"
+};
+
+export { ApiError, DEFAULT_CONFIG, JAZARI_COLORS, apiClient, arrowheadPath, bindCanvasCapture, bindEventBus, bindTraitStateGetter, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, gearTeethPath, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, pipeIconPath, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.93.0",
+  "version": "5.94.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [