@almadar/ui 4.46.0 → 4.47.1

package/dist/avl/index.cjs

@@ -9981,8 +9981,8 @@ function Seigaiha({ size, color, strokeWidth }) {
     [s, s * 0.1]
   ];
   for (const [cx, cy] of centers) {
-    for (let ring = 1; ring <= 3; ring++) {
-      const cr = r2 * (ring / 3);
+    for (let ring2 = 1; ring2 <= 3; ring2++) {
+      const cr = r2 * (ring2 / 3);
       paths.push(
         `M ${f(cx - cr)},${f(cy)} A ${f(cr)} ${f(cr)} 0 0 1 ${f(cx + cr)},${f(cy)}`
       );
@@ -10079,8 +10079,8 @@ function Arch({ size, color, strokeWidth }) {
   const h = size * 1.5;
   const cx = w / 2;
   const paths = [];
-  for (let ring = 0; ring < 4; ring++) {
-    const scale = 1 - ring * 0.2;
+  for (let ring2 = 0; ring2 < 4; ring2++) {
+    const scale = 1 - ring2 * 0.2;
     const archW = w * 0.48 * scale;
     const archH = h * 0.7 * scale;
     const baseY = h * 0.85;
@@ -10095,7 +10095,7 @@ function Arch({ size, color, strokeWidth }) {
     paths.push(
       `M ${f(lx)},${f(baseY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(cx)},${f(tipY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(rx)},${f(baseY)}`
     );
-    if (ring === 0) {
+    if (ring2 === 0) {
       paths.push(`M ${f(lx)},${f(baseY)} L ${f(rx)},${f(baseY)}`);
     }
   }
@@ -21749,20 +21749,20 @@ function CanvasEffectEngine({
     return img?.complete ? img : void 0;
   }, []);
   React147.useEffect(() => {
-    const now = performance.now();
+    const now2 = performance.now();
     const effectX = x || width / 2;
     const effectY = y || height / 2;
     const preset = presets[actionType](effectX, effectY);
     const state = stateRef.current;
     for (const emitter of preset.particles) {
       const scaledEmitter = { ...emitter, count: Math.round(emitter.count * intensity) };
-      state.particles.push(...spawnParticles(scaledEmitter, now));
+      state.particles.push(...spawnParticles(scaledEmitter, now2));
     }
     for (const seqConfig of preset.sequences) {
-      state.sequences.push(spawnSequence(seqConfig, now));
+      state.sequences.push(spawnSequence(seqConfig, now2));
     }
     for (const ovConfig of preset.overlays) {
-      state.overlays.push(spawnOverlay(ovConfig, now));
+      state.overlays.push(spawnOverlay(ovConfig, now2));
     }
     if (preset.screenShake > 0) {
       shakeRef.current.intensity = preset.screenShake * intensity;
@@ -42472,7 +42472,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log18, setLog] = React147__namespace.useState([]);
+  const [log19, setLog] = React147__namespace.useState([]);
   const prevStatesRef = React147__namespace.useRef(/* @__PURE__ */ new Map());
   React147__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -42536,9 +42536,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log18.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    log19.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log18.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log19.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -56507,11 +56507,11 @@ function VerificationProvider({
   runtimeManager,
   traitStateGetter
 }) {
-  const isEnabled = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
+  const isEnabled2 = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
   const eventBus = useEventBus();
   const pendingRef = React147.useRef(/* @__PURE__ */ new Map());
   React147.useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (!eventBus.onAny) return;
     const verificationProviderLifecycleListener = (evt) => {
       const parsed = parseLifecycleEvent(evt.type);
@@ -56614,9 +56614,9 @@ function VerificationProvider({
       "pass"
     );
     return unsub;
-  }, [isEnabled, eventBus]);
+  }, [isEnabled2, eventBus]);
   React147.useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (!runtimeManager) return;
     runtimeManager.setObserver({
       onTransition(trace) {
@@ -56636,20 +56636,20 @@ function VerificationProvider({
       "VerificationProvider active (runtime path)",
       "pass"
     );
-  }, [isEnabled, runtimeManager]);
+  }, [isEnabled2, runtimeManager]);
   React147.useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     bindEventBus(eventBus);
-  }, [isEnabled, eventBus]);
+  }, [isEnabled2, eventBus]);
   React147.useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (traitStateGetter) {
       bindTraitStateGetter(traitStateGetter);
     } else if (runtimeManager?.getState) {
       const mgr = runtimeManager;
       bindTraitStateGetter((traitName) => mgr.getState(traitName));
     }
-  }, [isEnabled, traitStateGetter, runtimeManager]);
+  }, [isEnabled2, traitStateGetter, runtimeManager]);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
 }
 VerificationProvider.displayName = "VerificationProvider";
@@ -57863,6 +57863,72 @@ function ServerBridgeProvider({
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
+var PERF_NAMESPACE = "almadar:perf:canvas";
+var log17 = logger.createLogger(PERF_NAMESPACE);
+var RING_SIZE = 50;
+var ring = [];
+var writeIdx = 0;
+var subscribers = /* @__PURE__ */ new Set();
+var notifyScheduled = false;
+function scheduleNotify() {
+  if (notifyScheduled) return;
+  notifyScheduled = true;
+  queueMicrotask(() => {
+    notifyScheduled = false;
+    for (const fn of subscribers) fn();
+  });
+}
+function push(entry) {
+  if (ring.length < RING_SIZE) {
+    ring.push(entry);
+  } else {
+    ring[writeIdx] = entry;
+  }
+  writeIdx = (writeIdx + 1) % RING_SIZE;
+  scheduleNotify();
+}
+function isEnabled() {
+  return logger.isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
+}
+function now() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function perfStart(name) {
+  if (!isEnabled()) return -1;
+  if (typeof performance !== "undefined" && typeof performance.mark === "function") {
+    try {
+      performance.mark(`${name}-start`);
+    } catch {
+    }
+  }
+  return now();
+}
+function perfEnd(name, startToken, detail) {
+  if (startToken < 0 || !isEnabled()) return;
+  const endTs = now();
+  const durationMs = endTs - startToken;
+  if (typeof performance !== "undefined" && typeof performance.measure === "function") {
+    try {
+      performance.mark(`${name}-end`);
+      performance.measure(name, `${name}-start`, `${name}-end`);
+    } catch {
+    }
+  }
+  push({ name, durationMs, ts: endTs, detail });
+  log17.debug(name, () => ({ durationMs, ...detail ?? {} }));
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  if (!isEnabled()) return;
+  push({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+  log17.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
+};
+
+// runtime/prepareSchemaForPreview.ts
 function generateEntityRow(entity, idx) {
   const row = { id: String(idx) };
   for (const f3 of entity.fields) {
@@ -57888,6 +57954,7 @@ function generateFieldValue(entityName, field, idx) {
   }
 }
 function buildMockData(schema) {
+  const t = perfStart("build-mock-data");
   const result = {};
   for (const orbital of schema.orbitals) {
     const entity = orbital.entity;
@@ -57905,6 +57972,7 @@ function buildMockData(schema) {
     );
     result[entityName] = rows;
   }
+  perfEnd("build-mock-data", t, { orbitalCount: schema.orbitals.length, entityCount: Object.keys(result).length });
   return result;
 }
 function isInlineTrait2(traitRef) {
@@ -59827,9 +59895,16 @@ function FlowCanvasInner({
   }), [selectedPattern]);
   const [atBehaviorLevel, setAtBehaviorLevel] = React147.useState(composeLevel === "behavior");
   const { composeNodes, composeEdges, overviewNodes, overviewEdges, expandedNodes, expandedEdges } = React147.useMemo(() => {
+    const t = perfStart("compose-graph");
     const compose = composeLevel === "behavior" && behaviorEntries?.length ? behaviorsToComposeGraph(behaviorEntries, behaviorWires ?? [], layoutHint) : { nodes: [], edges: [] };
     const overview = schemaToOverviewGraph(parsedSchema, mockData, behaviorMeta, layoutHint);
     const expanded = expandedOrbital ? orbitalToExpandedGraph(parsedSchema, expandedOrbital, mockData) : { nodes: [], edges: [] };
+    perfEnd("compose-graph", t, {
+      composeNodes: compose.nodes.length,
+      overviewNodes: overview.nodes.length,
+      expandedNodes: expanded.nodes.length,
+      orbitalCount: parsedSchema.orbitals?.length ?? 0
+    });
     return {
       composeNodes: compose.nodes,
       composeEdges: compose.edges,
@@ -59838,7 +59913,7 @@ function FlowCanvasInner({
       expandedNodes: expanded.nodes,
       expandedEdges: expanded.edges
     };
-  }, [parsedSchema, expandedOrbital, behaviorMeta, layoutHint, composeLevel, behaviorEntries, behaviorWires]);
+  }, [parsedSchema, expandedOrbital, behaviorMeta, layoutHint, composeLevel, behaviorEntries, behaviorWires, mockData]);
   const activeNodes = atBehaviorLevel && composeNodes.length > 0 ? composeNodes : level === "overview" ? overviewNodes : expandedNodes;
   const activeEdges = atBehaviorLevel && composeEdges.length > 0 ? composeEdges : level === "overview" ? overviewEdges : expandedEdges;
   const [nodes, setNodes, onNodesChange] = react.useNodesState(activeNodes);
@@ -60096,7 +60171,7 @@ function FlowCanvasInner({
   ) }) });
 }
 var FlowCanvas = (props) => {
-  return /* @__PURE__ */ jsxRuntime.jsx(react.ReactFlowProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(FlowCanvasInner, { ...props }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(React147.Profiler, { id: "flow-canvas", onRender: profilerOnRender, children: /* @__PURE__ */ jsxRuntime.jsx(react.ReactFlowProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(FlowCanvasInner, { ...props }) }) });
 };
 FlowCanvas.displayName = "FlowCanvas";
 var BAND_LABELS = {
@@ -60223,7 +60298,7 @@ init_AvlTransitionLane();
 init_AvlSwimLane();
 init_types();
 init_avl_elk_layout();
-var log17 = logger.createLogger("almadar:ui:avl:trait-scene");
+var log18 = logger.createLogger("almadar:ui:avl:trait-scene");
 var SWIM_GUTTER2 = 120;
 var CENTER_W2 = 360;
 var AvlTraitScene = ({
@@ -60235,7 +60310,7 @@ var AvlTraitScene = ({
   const dataKey = React147.useMemo(() => JSON.stringify(data), [data]);
   React147.useEffect(() => {
     computeTraitLayout(data).then(setLayout).catch((error) => {
-      log17.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
+      log18.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
     });
   }, [dataKey]);
   if (!layout) {

package/dist/avl/index.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { OrbitControls as OrbitControls$1, Grid as Grid$1, Stars, Sparkles, Html, RoundedBox } from '@react-three/drei';
 import * as React147 from 'react';
-import React147__default, { createContext, useState, useEffect, useMemo, useContext, useRef, useCallback, Suspense, useLayoutEffect, useReducer, lazy, useId, forwardRef, useImperativeHandle, Component } from 'react';
+import React147__default, { createContext, useState, useEffect, useMemo, useContext, useRef, useCallback, Suspense, useLayoutEffect, Profiler, useReducer, lazy, useId, forwardRef, useImperativeHandle, Component } from 'react';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import { MarkerType, Handle, Position, getBezierPath, EdgeLabelRenderer, BaseEdge, ReactFlowProvider, useNodesState, useEdgesState, useReactFlow, ReactFlow, Controls, Background, BackgroundVariant } from '@xyflow/react';
@@ -9935,8 +9935,8 @@ function Seigaiha({ size, color, strokeWidth }) {
     [s, s * 0.1]
   ];
   for (const [cx, cy] of centers) {
-    for (let ring = 1; ring <= 3; ring++) {
-      const cr = r2 * (ring / 3);
+    for (let ring2 = 1; ring2 <= 3; ring2++) {
+      const cr = r2 * (ring2 / 3);
       paths.push(
         `M ${f(cx - cr)},${f(cy)} A ${f(cr)} ${f(cr)} 0 0 1 ${f(cx + cr)},${f(cy)}`
       );
@@ -10033,8 +10033,8 @@ function Arch({ size, color, strokeWidth }) {
   const h = size * 1.5;
   const cx = w / 2;
   const paths = [];
-  for (let ring = 0; ring < 4; ring++) {
-    const scale = 1 - ring * 0.2;
+  for (let ring2 = 0; ring2 < 4; ring2++) {
+    const scale = 1 - ring2 * 0.2;
     const archW = w * 0.48 * scale;
     const archH = h * 0.7 * scale;
     const baseY = h * 0.85;
@@ -10049,7 +10049,7 @@ function Arch({ size, color, strokeWidth }) {
     paths.push(
       `M ${f(lx)},${f(baseY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(cx)},${f(tipY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(rx)},${f(baseY)}`
     );
-    if (ring === 0) {
+    if (ring2 === 0) {
       paths.push(`M ${f(lx)},${f(baseY)} L ${f(rx)},${f(baseY)}`);
     }
   }
@@ -21703,20 +21703,20 @@ function CanvasEffectEngine({
     return img?.complete ? img : void 0;
   }, []);
   useEffect(() => {
-    const now = performance.now();
+    const now2 = performance.now();
     const effectX = x || width / 2;
     const effectY = y || height / 2;
     const preset = presets[actionType](effectX, effectY);
     const state = stateRef.current;
     for (const emitter of preset.particles) {
       const scaledEmitter = { ...emitter, count: Math.round(emitter.count * intensity) };
-      state.particles.push(...spawnParticles(scaledEmitter, now));
+      state.particles.push(...spawnParticles(scaledEmitter, now2));
     }
     for (const seqConfig of preset.sequences) {
-      state.sequences.push(spawnSequence(seqConfig, now));
+      state.sequences.push(spawnSequence(seqConfig, now2));
     }
     for (const ovConfig of preset.overlays) {
-      state.overlays.push(spawnOverlay(ovConfig, now));
+      state.overlays.push(spawnOverlay(ovConfig, now2));
     }
     if (preset.screenShake > 0) {
       shakeRef.current.intensity = preset.screenShake * intensity;
@@ -42426,7 +42426,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log18, setLog] = React147.useState([]);
+  const [log19, setLog] = React147.useState([]);
   const prevStatesRef = React147.useRef(/* @__PURE__ */ new Map());
   React147.useEffect(() => {
     for (const trait of traits2) {
@@ -42490,9 +42490,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log18.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log19.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log18.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log19.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -56461,11 +56461,11 @@ function VerificationProvider({
   runtimeManager,
   traitStateGetter
 }) {
-  const isEnabled = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
+  const isEnabled2 = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
   const eventBus = useEventBus();
   const pendingRef = useRef(/* @__PURE__ */ new Map());
   useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (!eventBus.onAny) return;
     const verificationProviderLifecycleListener = (evt) => {
       const parsed = parseLifecycleEvent(evt.type);
@@ -56568,9 +56568,9 @@ function VerificationProvider({
       "pass"
     );
     return unsub;
-  }, [isEnabled, eventBus]);
+  }, [isEnabled2, eventBus]);
   useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (!runtimeManager) return;
     runtimeManager.setObserver({
       onTransition(trace) {
@@ -56590,20 +56590,20 @@ function VerificationProvider({
       "VerificationProvider active (runtime path)",
       "pass"
     );
-  }, [isEnabled, runtimeManager]);
+  }, [isEnabled2, runtimeManager]);
   useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     bindEventBus(eventBus);
-  }, [isEnabled, eventBus]);
+  }, [isEnabled2, eventBus]);
   useEffect(() => {
-    if (!isEnabled) return;
+    if (!isEnabled2) return;
     if (traitStateGetter) {
       bindTraitStateGetter(traitStateGetter);
     } else if (runtimeManager?.getState) {
       const mgr = runtimeManager;
       bindTraitStateGetter((traitName) => mgr.getState(traitName));
     }
-  }, [isEnabled, traitStateGetter, runtimeManager]);
+  }, [isEnabled2, traitStateGetter, runtimeManager]);
   return /* @__PURE__ */ jsx(Fragment, { children });
 }
 VerificationProvider.displayName = "VerificationProvider";
@@ -57817,6 +57817,72 @@ function ServerBridgeProvider({
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
+var PERF_NAMESPACE = "almadar:perf:canvas";
+var log17 = createLogger(PERF_NAMESPACE);
+var RING_SIZE = 50;
+var ring = [];
+var writeIdx = 0;
+var subscribers = /* @__PURE__ */ new Set();
+var notifyScheduled = false;
+function scheduleNotify() {
+  if (notifyScheduled) return;
+  notifyScheduled = true;
+  queueMicrotask(() => {
+    notifyScheduled = false;
+    for (const fn of subscribers) fn();
+  });
+}
+function push(entry) {
+  if (ring.length < RING_SIZE) {
+    ring.push(entry);
+  } else {
+    ring[writeIdx] = entry;
+  }
+  writeIdx = (writeIdx + 1) % RING_SIZE;
+  scheduleNotify();
+}
+function isEnabled() {
+  return isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
+}
+function now() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function perfStart(name) {
+  if (!isEnabled()) return -1;
+  if (typeof performance !== "undefined" && typeof performance.mark === "function") {
+    try {
+      performance.mark(`${name}-start`);
+    } catch {
+    }
+  }
+  return now();
+}
+function perfEnd(name, startToken, detail) {
+  if (startToken < 0 || !isEnabled()) return;
+  const endTs = now();
+  const durationMs = endTs - startToken;
+  if (typeof performance !== "undefined" && typeof performance.measure === "function") {
+    try {
+      performance.mark(`${name}-end`);
+      performance.measure(name, `${name}-start`, `${name}-end`);
+    } catch {
+    }
+  }
+  push({ name, durationMs, ts: endTs, detail });
+  log17.debug(name, () => ({ durationMs, ...detail ?? {} }));
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  if (!isEnabled()) return;
+  push({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+  log17.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
+};
+
+// runtime/prepareSchemaForPreview.ts
 function generateEntityRow(entity, idx) {
   const row = { id: String(idx) };
   for (const f3 of entity.fields) {
@@ -57842,6 +57908,7 @@ function generateFieldValue(entityName, field, idx) {
   }
 }
 function buildMockData(schema) {
+  const t = perfStart("build-mock-data");
   const result = {};
   for (const orbital of schema.orbitals) {
     const entity = orbital.entity;
@@ -57859,6 +57926,7 @@ function buildMockData(schema) {
     );
     result[entityName] = rows;
   }
+  perfEnd("build-mock-data", t, { orbitalCount: schema.orbitals.length, entityCount: Object.keys(result).length });
   return result;
 }
 function isInlineTrait2(traitRef) {
@@ -59781,9 +59849,16 @@ function FlowCanvasInner({
   }), [selectedPattern]);
   const [atBehaviorLevel, setAtBehaviorLevel] = useState(composeLevel === "behavior");
   const { composeNodes, composeEdges, overviewNodes, overviewEdges, expandedNodes, expandedEdges } = useMemo(() => {
+    const t = perfStart("compose-graph");
     const compose = composeLevel === "behavior" && behaviorEntries?.length ? behaviorsToComposeGraph(behaviorEntries, behaviorWires ?? [], layoutHint) : { nodes: [], edges: [] };
     const overview = schemaToOverviewGraph(parsedSchema, mockData, behaviorMeta, layoutHint);
     const expanded = expandedOrbital ? orbitalToExpandedGraph(parsedSchema, expandedOrbital, mockData) : { nodes: [], edges: [] };
+    perfEnd("compose-graph", t, {
+      composeNodes: compose.nodes.length,
+      overviewNodes: overview.nodes.length,
+      expandedNodes: expanded.nodes.length,
+      orbitalCount: parsedSchema.orbitals?.length ?? 0
+    });
     return {
       composeNodes: compose.nodes,
       composeEdges: compose.edges,
@@ -59792,7 +59867,7 @@ function FlowCanvasInner({
       expandedNodes: expanded.nodes,
       expandedEdges: expanded.edges
     };
-  }, [parsedSchema, expandedOrbital, behaviorMeta, layoutHint, composeLevel, behaviorEntries, behaviorWires]);
+  }, [parsedSchema, expandedOrbital, behaviorMeta, layoutHint, composeLevel, behaviorEntries, behaviorWires, mockData]);
   const activeNodes = atBehaviorLevel && composeNodes.length > 0 ? composeNodes : level === "overview" ? overviewNodes : expandedNodes;
   const activeEdges = atBehaviorLevel && composeEdges.length > 0 ? composeEdges : level === "overview" ? overviewEdges : expandedEdges;
   const [nodes, setNodes, onNodesChange] = useNodesState(activeNodes);
@@ -60050,7 +60125,7 @@ function FlowCanvasInner({
   ) }) });
 }
 var FlowCanvas = (props) => {
-  return /* @__PURE__ */ jsx(ReactFlowProvider, { children: /* @__PURE__ */ jsx(FlowCanvasInner, { ...props }) });
+  return /* @__PURE__ */ jsx(Profiler, { id: "flow-canvas", onRender: profilerOnRender, children: /* @__PURE__ */ jsx(ReactFlowProvider, { children: /* @__PURE__ */ jsx(FlowCanvasInner, { ...props }) }) });
 };
 FlowCanvas.displayName = "FlowCanvas";
 var BAND_LABELS = {
@@ -60177,7 +60252,7 @@ init_AvlTransitionLane();
 init_AvlSwimLane();
 init_types();
 init_avl_elk_layout();
-var log17 = createLogger("almadar:ui:avl:trait-scene");
+var log18 = createLogger("almadar:ui:avl:trait-scene");
 var SWIM_GUTTER2 = 120;
 var CENTER_W2 = 360;
 var AvlTraitScene = ({
@@ -60189,7 +60264,7 @@ var AvlTraitScene = ({
   const dataKey = useMemo(() => JSON.stringify(data), [data]);
   useEffect(() => {
     computeTraitLayout(data).then(setLayout).catch((error) => {
-      log17.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
+      log18.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
     });
   }, [dataKey]);
   if (!layout) {

package/dist/runtime/index.cjs

@@ -5630,8 +5630,8 @@ function Seigaiha({ size, color, strokeWidth }) {
     [s, s * 0.1]
   ];
   for (const [cx, cy] of centers) {
-    for (let ring = 1; ring <= 3; ring++) {
-      const cr = r * (ring / 3);
+    for (let ring2 = 1; ring2 <= 3; ring2++) {
+      const cr = r * (ring2 / 3);
       paths.push(
         `M ${f(cx - cr)},${f(cy)} A ${f(cr)} ${f(cr)} 0 0 1 ${f(cx + cr)},${f(cy)}`
       );
@@ -5728,8 +5728,8 @@ function Arch({ size, color, strokeWidth }) {
   const h = size * 1.5;
   const cx = w / 2;
   const paths = [];
-  for (let ring = 0; ring < 4; ring++) {
-    const scale = 1 - ring * 0.2;
+  for (let ring2 = 0; ring2 < 4; ring2++) {
+    const scale = 1 - ring2 * 0.2;
     const archW = w * 0.48 * scale;
     const archH = h * 0.7 * scale;
     const baseY = h * 0.85;
@@ -5744,7 +5744,7 @@ function Arch({ size, color, strokeWidth }) {
     paths.push(
       `M ${f(lx)},${f(baseY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(cx)},${f(tipY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(rx)},${f(baseY)}`
     );
-    if (ring === 0) {
+    if (ring2 === 0) {
       paths.push(`M ${f(lx)},${f(baseY)} L ${f(rx)},${f(baseY)}`);
     }
   }
@@ -17947,20 +17947,20 @@ function CanvasEffectEngine({
     return img?.complete ? img : void 0;
   }, []);
   React135.useEffect(() => {
-    const now = performance.now();
+    const now2 = performance.now();
     const effectX = x || width / 2;
     const effectY = y || height / 2;
     const preset = presets[actionType](effectX, effectY);
     const state = stateRef.current;
     for (const emitter of preset.particles) {
       const scaledEmitter = { ...emitter, count: Math.round(emitter.count * intensity) };
-      state.particles.push(...spawnParticles(scaledEmitter, now));
+      state.particles.push(...spawnParticles(scaledEmitter, now2));
     }
     for (const seqConfig of preset.sequences) {
-      state.sequences.push(spawnSequence(seqConfig, now));
+      state.sequences.push(spawnSequence(seqConfig, now2));
     }
     for (const ovConfig of preset.overlays) {
-      state.overlays.push(spawnOverlay(ovConfig, now));
+      state.overlays.push(spawnOverlay(ovConfig, now2));
     }
     if (preset.screenShake > 0) {
       shakeRef.current.intensity = preset.screenShake * intensity;
@@ -38857,7 +38857,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log11, setLog] = React135__namespace.useState([]);
+  const [log12, setLog] = React135__namespace.useState([]);
   const prevStatesRef = React135__namespace.useRef(/* @__PURE__ */ new Map());
   React135__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -38921,9 +38921,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log11.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    log12.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log11.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log12.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -45720,6 +45720,109 @@ function ServerBridgeProvider({
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
+var PERF_NAMESPACE = "almadar:perf:canvas";
+var log11 = logger.createLogger(PERF_NAMESPACE);
+var RING_SIZE = 50;
+var ring = [];
+var writeIdx = 0;
+var subscribers = /* @__PURE__ */ new Set();
+var notifyScheduled = false;
+var revision = 0;
+var cachedSnapshot = [];
+var cachedRevision = -1;
+function scheduleNotify() {
+  if (notifyScheduled) return;
+  notifyScheduled = true;
+  queueMicrotask(() => {
+    notifyScheduled = false;
+    revision++;
+    for (const fn of subscribers) fn();
+  });
+}
+function push(entry) {
+  if (ring.length < RING_SIZE) {
+    ring.push(entry);
+  } else {
+    ring[writeIdx] = entry;
+  }
+  writeIdx = (writeIdx + 1) % RING_SIZE;
+  scheduleNotify();
+}
+function isEnabled() {
+  return logger.isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
+}
+function now() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function perfStart(name) {
+  if (!isEnabled()) return -1;
+  if (typeof performance !== "undefined" && typeof performance.mark === "function") {
+    try {
+      performance.mark(`${name}-start`);
+    } catch {
+    }
+  }
+  return now();
+}
+function perfEnd(name, startToken, detail) {
+  if (startToken < 0 || !isEnabled()) return;
+  const endTs = now();
+  const durationMs = endTs - startToken;
+  if (typeof performance !== "undefined" && typeof performance.measure === "function") {
+    try {
+      performance.mark(`${name}-end`);
+      performance.measure(name, `${name}-start`, `${name}-end`);
+    } catch {
+    }
+  }
+  push({ name, durationMs, ts: endTs, detail });
+  log11.debug(name, () => ({ durationMs, ...detail ?? {} }));
+}
+function perfTime(name, fn, detail) {
+  const t = perfStart(name);
+  try {
+    return fn();
+  } finally {
+    perfEnd(name, t, detail);
+  }
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  if (!isEnabled()) return;
+  push({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+  log11.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
+};
+function getPerfSnapshot() {
+  if (ring.length < RING_SIZE) return ring.slice();
+  return [...ring.slice(writeIdx), ...ring.slice(0, writeIdx)];
+}
+function getSnapshot2() {
+  if (cachedRevision !== revision) {
+    cachedSnapshot = getPerfSnapshot();
+    cachedRevision = revision;
+  }
+  return cachedSnapshot;
+}
+function subscribe(fn) {
+  subscribers.add(fn);
+  return () => {
+    subscribers.delete(fn);
+  };
+}
+function usePerfBuffer() {
+  return React135.useSyncExternalStore(subscribe, getSnapshot2, getSnapshot2);
+}
+function clearPerf() {
+  ring.length = 0;
+  writeIdx = 0;
+  scheduleNotify();
+}
+
+// runtime/prepareSchemaForPreview.ts
 function generateEntityRow(entity, idx) {
   const row = { id: String(idx) };
   for (const f3 of entity.fields) {
@@ -45745,6 +45848,7 @@ function generateFieldValue(entityName, field, idx) {
   }
 }
 function buildMockData(schema) {
+  const t = perfStart("build-mock-data");
   const result = {};
   for (const orbital of schema.orbitals) {
     const entity = orbital.entity;
@@ -45762,6 +45866,7 @@ function buildMockData(schema) {
     );
     result[entityName] = rows;
   }
+  perfEnd("build-mock-data", t, { orbitalCount: schema.orbitals.length, entityCount: Object.keys(result).length });
   return result;
 }
 function isInlineTrait2(traitRef) {
@@ -46281,17 +46386,25 @@ function BrowserPlayground({
 exports.BrowserPlayground = BrowserPlayground;
 exports.EntitySchemaProvider = EntitySchemaProvider;
 exports.OrbPreview = OrbPreview;
+exports.PERF_NAMESPACE = PERF_NAMESPACE;
 exports.ServerBridgeProvider = ServerBridgeProvider;
 exports.TraitContext = TraitContext;
 exports.TraitProvider = TraitProvider;
 exports.adjustSchemaForMockData = adjustSchemaForMockData;
 exports.buildMockData = buildMockData;
+exports.clearPerf = clearPerf;
 exports.clearSchemaCache = clearSchemaCache;
 exports.createClientEffectHandlers = createClientEffectHandlers;
+exports.getPerfSnapshot = getPerfSnapshot;
+exports.perfEnd = perfEnd;
+exports.perfStart = perfStart;
+exports.perfTime = perfTime;
 exports.prepareSchemaForPreview = prepareSchemaForPreview;
+exports.profilerOnRender = profilerOnRender;
 exports.useEntityDefinition = useEntityDefinition;
 exports.useEntitySchema = useEntitySchema;
 exports.useEntitySchemaOptional = useEntitySchemaOptional;
+exports.usePerfBuffer = usePerfBuffer;
 exports.useResolvedSchema = useResolvedSchema;
 exports.useServerBridge = useServerBridge;
 exports.useTrait = useTrait;

package/dist/runtime/index.d.ts

@@ -18,3 +18,4 @@ export { BrowserPlayground, type BrowserPlaygroundProps } from './BrowserPlaygro
 export { prepareSchemaForPreview, buildMockData, adjustSchemaForMockData, type PreparedPreviewSchema, } from './prepareSchemaForPreview';
 export { ServerBridgeProvider, useServerBridge, type ServerBridgeContextValue, type ServerBridgeTransport, type ServerClientEffect } from './ServerBridge';
 export type { ResolvedTraitBinding, ResolvedTrait, ResolvedEntity, ResolvedPage, ResolvedIR, } from './types';
+export { PERF_NAMESPACE, perfStart, perfEnd, perfTime, profilerOnRender, getPerfSnapshot, usePerfBuffer, clearPerf, type PerfEntry, } from './perf';

package/dist/runtime/index.js

@@ -1,5 +1,5 @@
 import * as React135 from 'react';
-import React135__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId } from 'react';
+import React135__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useSyncExternalStore, useLayoutEffect, lazy, useId } from 'react';
 import { EventBusContext, useTraitScope, OrbitalProvider, TraitScopeProvider, VerificationProvider } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -5584,8 +5584,8 @@ function Seigaiha({ size, color, strokeWidth }) {
     [s, s * 0.1]
   ];
   for (const [cx, cy] of centers) {
-    for (let ring = 1; ring <= 3; ring++) {
-      const cr = r * (ring / 3);
+    for (let ring2 = 1; ring2 <= 3; ring2++) {
+      const cr = r * (ring2 / 3);
       paths.push(
         `M ${f(cx - cr)},${f(cy)} A ${f(cr)} ${f(cr)} 0 0 1 ${f(cx + cr)},${f(cy)}`
       );
@@ -5682,8 +5682,8 @@ function Arch({ size, color, strokeWidth }) {
   const h = size * 1.5;
   const cx = w / 2;
   const paths = [];
-  for (let ring = 0; ring < 4; ring++) {
-    const scale = 1 - ring * 0.2;
+  for (let ring2 = 0; ring2 < 4; ring2++) {
+    const scale = 1 - ring2 * 0.2;
     const archW = w * 0.48 * scale;
     const archH = h * 0.7 * scale;
     const baseY = h * 0.85;
@@ -5698,7 +5698,7 @@ function Arch({ size, color, strokeWidth }) {
     paths.push(
       `M ${f(lx)},${f(baseY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(cx)},${f(tipY)} A ${f(radius)} ${f(radius)} 0 0 1 ${f(rx)},${f(baseY)}`
     );
-    if (ring === 0) {
+    if (ring2 === 0) {
       paths.push(`M ${f(lx)},${f(baseY)} L ${f(rx)},${f(baseY)}`);
     }
   }
@@ -17901,20 +17901,20 @@ function CanvasEffectEngine({
     return img?.complete ? img : void 0;
   }, []);
   useEffect(() => {
-    const now = performance.now();
+    const now2 = performance.now();
     const effectX = x || width / 2;
     const effectY = y || height / 2;
     const preset = presets[actionType](effectX, effectY);
     const state = stateRef.current;
     for (const emitter of preset.particles) {
       const scaledEmitter = { ...emitter, count: Math.round(emitter.count * intensity) };
-      state.particles.push(...spawnParticles(scaledEmitter, now));
+      state.particles.push(...spawnParticles(scaledEmitter, now2));
     }
     for (const seqConfig of preset.sequences) {
-      state.sequences.push(spawnSequence(seqConfig, now));
+      state.sequences.push(spawnSequence(seqConfig, now2));
     }
     for (const ovConfig of preset.overlays) {
-      state.overlays.push(spawnOverlay(ovConfig, now));
+      state.overlays.push(spawnOverlay(ovConfig, now2));
     }
     if (preset.screenShake > 0) {
       shakeRef.current.intensity = preset.screenShake * intensity;
@@ -38811,7 +38811,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log11, setLog] = React135.useState([]);
+  const [log12, setLog] = React135.useState([]);
   const prevStatesRef = React135.useRef(/* @__PURE__ */ new Map());
   React135.useEffect(() => {
     for (const trait of traits2) {
@@ -38875,9 +38875,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log11.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log12.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log11.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log12.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -45674,6 +45674,109 @@ function ServerBridgeProvider({
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
+var PERF_NAMESPACE = "almadar:perf:canvas";
+var log11 = createLogger(PERF_NAMESPACE);
+var RING_SIZE = 50;
+var ring = [];
+var writeIdx = 0;
+var subscribers = /* @__PURE__ */ new Set();
+var notifyScheduled = false;
+var revision = 0;
+var cachedSnapshot = [];
+var cachedRevision = -1;
+function scheduleNotify() {
+  if (notifyScheduled) return;
+  notifyScheduled = true;
+  queueMicrotask(() => {
+    notifyScheduled = false;
+    revision++;
+    for (const fn of subscribers) fn();
+  });
+}
+function push(entry) {
+  if (ring.length < RING_SIZE) {
+    ring.push(entry);
+  } else {
+    ring[writeIdx] = entry;
+  }
+  writeIdx = (writeIdx + 1) % RING_SIZE;
+  scheduleNotify();
+}
+function isEnabled() {
+  return isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
+}
+function now() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function perfStart(name) {
+  if (!isEnabled()) return -1;
+  if (typeof performance !== "undefined" && typeof performance.mark === "function") {
+    try {
+      performance.mark(`${name}-start`);
+    } catch {
+    }
+  }
+  return now();
+}
+function perfEnd(name, startToken, detail) {
+  if (startToken < 0 || !isEnabled()) return;
+  const endTs = now();
+  const durationMs = endTs - startToken;
+  if (typeof performance !== "undefined" && typeof performance.measure === "function") {
+    try {
+      performance.mark(`${name}-end`);
+      performance.measure(name, `${name}-start`, `${name}-end`);
+    } catch {
+    }
+  }
+  push({ name, durationMs, ts: endTs, detail });
+  log11.debug(name, () => ({ durationMs, ...detail ?? {} }));
+}
+function perfTime(name, fn, detail) {
+  const t = perfStart(name);
+  try {
+    return fn();
+  } finally {
+    perfEnd(name, t, detail);
+  }
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  if (!isEnabled()) return;
+  push({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+  log11.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
+};
+function getPerfSnapshot() {
+  if (ring.length < RING_SIZE) return ring.slice();
+  return [...ring.slice(writeIdx), ...ring.slice(0, writeIdx)];
+}
+function getSnapshot2() {
+  if (cachedRevision !== revision) {
+    cachedSnapshot = getPerfSnapshot();
+    cachedRevision = revision;
+  }
+  return cachedSnapshot;
+}
+function subscribe(fn) {
+  subscribers.add(fn);
+  return () => {
+    subscribers.delete(fn);
+  };
+}
+function usePerfBuffer() {
+  return useSyncExternalStore(subscribe, getSnapshot2, getSnapshot2);
+}
+function clearPerf() {
+  ring.length = 0;
+  writeIdx = 0;
+  scheduleNotify();
+}
+
+// runtime/prepareSchemaForPreview.ts
 function generateEntityRow(entity, idx) {
   const row = { id: String(idx) };
   for (const f3 of entity.fields) {
@@ -45699,6 +45802,7 @@ function generateFieldValue(entityName, field, idx) {
   }
 }
 function buildMockData(schema) {
+  const t = perfStart("build-mock-data");
   const result = {};
   for (const orbital of schema.orbitals) {
     const entity = orbital.entity;
@@ -45716,6 +45820,7 @@ function buildMockData(schema) {
     );
     result[entityName] = rows;
   }
+  perfEnd("build-mock-data", t, { orbitalCount: schema.orbitals.length, entityCount: Object.keys(result).length });
   return result;
 }
 function isInlineTrait2(traitRef) {
@@ -46232,4 +46337,4 @@ function BrowserPlayground({
   );
 }
 
-export { BrowserPlayground, EntitySchemaProvider, OrbPreview, ServerBridgeProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearSchemaCache, createClientEffectHandlers, prepareSchemaForPreview, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, useResolvedSchema, useServerBridge, useTrait, useTraitContext, useTraitStateMachine, wrapCallbackForEvent };
+export { BrowserPlayground, EntitySchemaProvider, OrbPreview, PERF_NAMESPACE, ServerBridgeProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearPerf, clearSchemaCache, createClientEffectHandlers, getPerfSnapshot, perfEnd, perfStart, perfTime, prepareSchemaForPreview, profilerOnRender, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, usePerfBuffer, useResolvedSchema, useServerBridge, useTrait, useTraitContext, useTraitStateMachine, wrapCallbackForEvent };

package/dist/runtime/perf.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @almadar/ui/runtime — perf instrumentation
+ *
+ * Ring buffer of timing events for the canvas render path, plus mark/measure
+ * helpers and a React.Profiler onRender callback. All gated behind
+ * `createLogger('almadar:perf:canvas')` so production (LOG_LEVEL >= WARN)
+ * skips both `performance.*` calls and the ring write.
+ */
+import type { ProfilerOnRenderCallback } from 'react';
+export declare const PERF_NAMESPACE = "almadar:perf:canvas";
+export interface PerfEntry {
+    readonly name: string;
+    readonly durationMs: number;
+    readonly ts: number;
+    readonly detail?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Start a phase. Returns an opaque token; pass to {@link perfEnd}.
+ * Returns -1 when the namespace is gated off, so call sites pay only one comparison.
+ */
+export declare function perfStart(name: string): number;
+export declare function perfEnd(name: string, startToken: number, detail?: Record<string, unknown>): void;
+/** Synchronous wrapper that times a fn end-to-end. */
+export declare function perfTime<T>(name: string, fn: () => T, detail?: Record<string, unknown>): T;
+/**
+ * React.Profiler `onRender` callback. Records `actualDuration` per commit.
+ * Phase is `"mount" | "update" | "nested-update"`.
+ */
+export declare const profilerOnRender: ProfilerOnRenderCallback;
+/** Snapshot in insertion order (oldest first). Stable identity until next push. */
+export declare function getPerfSnapshot(): readonly PerfEntry[];
+/** React hook: returns the current ring snapshot, re-renders on push. */
+export declare function usePerfBuffer(): readonly PerfEntry[];
+export declare function clearPerf(): void;

package/package.json

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