@almadar/ui 5.158.0 → 5.159.0

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
-import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
+import React, { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
 import { createLogger } from '@almadar/logger';
 import { EventBusContext, useTraitScopeChain } from '@almadar/ui/providers';
 export { useNavStack } from '@almadar/ui/providers';
-import { mergeEntityFrame } from '@almadar/core';
+import { mergeEntityFrame, isRenderBindingMarker } from '@almadar/core';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 
 var log = createLogger("almadar:ui:orbital-history");
@@ -1018,6 +1018,88 @@ function useEmitEvent() {
     [eventBus]
   );
 }
+function expressionEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (!expressionEqual(a[i], b[i])) return false;
+    }
+    return true;
+  }
+  if (a !== null && b !== null && typeof a === "object" && typeof b === "object" && !Array.isArray(a) && !Array.isArray(b) && !(a instanceof Date) && !(b instanceof Date)) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) return false;
+    for (const key of aKeys) {
+      if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+      if (!expressionEqual(
+        a[key],
+        b[key]
+      )) return false;
+    }
+    return true;
+  }
+  return false;
+}
+function isPlainSlotObject(value) {
+  if (value === null || value === void 0 || typeof value !== "object") return false;
+  if (Array.isArray(value)) return false;
+  if (React.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  if (isRenderBindingMarker(value)) return false;
+  return true;
+}
+function shareValue(prev, next) {
+  if (Object.is(prev, next)) return { value: prev, equal: true };
+  const prevMarker = isRenderBindingMarker(prev) ? prev : void 0;
+  const nextMarker = isRenderBindingMarker(next) ? next : void 0;
+  if (prevMarker !== void 0 || nextMarker !== void 0) {
+    if (prevMarker !== void 0 && nextMarker !== void 0 && expressionEqual(prevMarker.expression, nextMarker.expression)) {
+      return { value: prev, equal: true };
+    }
+    return { value: next, equal: false };
+  }
+  if (prev instanceof Date || next instanceof Date) {
+    return prev instanceof Date && next instanceof Date && prev.getTime() === next.getTime() ? { value: prev, equal: true } : { value: next, equal: false };
+  }
+  if (typeof prev === "function" || typeof next === "function") return { value: next, equal: false };
+  if (React.isValidElement(prev) || React.isValidElement(next)) return { value: next, equal: false };
+  if (Array.isArray(prev) && Array.isArray(next)) {
+    let equal = prev.length === next.length;
+    const out = new Array(next.length);
+    for (let i = 0; i < next.length; i++) {
+      const child = shareValue(prev[i], next[i]);
+      out[i] = child.value;
+      if (!child.equal) equal = false;
+    }
+    return equal ? { value: prev, equal: true } : { value: out, equal: false };
+  }
+  if (isPlainSlotObject(prev) && isPlainSlotObject(next)) {
+    const prevKeys = Object.keys(prev);
+    const nextKeys = Object.keys(next);
+    let equal = prevKeys.length === nextKeys.length;
+    const out = {};
+    for (const key of nextKeys) {
+      if (!Object.prototype.hasOwnProperty.call(prev, key)) {
+        equal = false;
+        out[key] = next[key];
+        continue;
+      }
+      const child = shareValue(prev[key], next[key]);
+      out[key] = child.value;
+      if (!child.equal) equal = false;
+    }
+    return equal ? { value: prev, equal: true } : { value: out, equal: false };
+  }
+  return { value: next, equal: false };
+}
+function reconcileSlotProps(prev, next) {
+  const result = shareValue(prev, next);
+  return { value: result.value, equal: result.equal };
+}
+
+// hooks/useUISlots.ts
 var log11 = createLogger("almadar:ui:ui-slots");
 var DEFAULT_SOURCE_KEY = "__default__";
 var MULTI_SOURCE_STACK_TRAIT = "__multi_source_stack__";
@@ -1172,6 +1254,14 @@ function useUISlotManager() {
           });
           return prev;
         }
+        if (existing && existing.priority === content.priority && existing.pattern === content.pattern && existing.animation === content.animation && existing.transitionEvent === content.transitionEvent && existing.fromState === content.fromState && existing.entity === content.entity && existing.nodeId === content.nodeId && existing.autoDismissAt === void 0 && content.autoDismissAt === void 0 && existing.onDismiss === void 0 === (content.onDismiss === void 0)) {
+          const reconciled = reconcileSlotProps(existing.props, content.props);
+          if (reconciled.equal) {
+            log11.debug("slot:flush-bail", { slot: config.target, sourceKey, pattern: content.pattern });
+            return prev;
+          }
+          content.props = reconciled.value;
+        }
         const nextSources = {
           ...slotSources,
           [sourceKey]: content
@@ -1579,6 +1669,7 @@ var en_default = {
   "common.confirm": "Are you sure?",
   "common.create": "Create",
   "common.edit": "Edit",
+  "common.title": "Title",
   "common.view": "View",
   "common.add": "Add",
   "common.remove": "Remove",

package/dist/lib/index.cjs

@@ -3,6 +3,8 @@
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 var logger = require('@almadar/logger');
+var react = require('react');
+var ui = require('@almadar/runtime/ui');
 var core = require('@almadar/core');
 
 var __defProp = Object.defineProperty;
@@ -446,6 +448,64 @@ function clearTraits() {
   traits.clear();
   notifyListeners4();
 }
+
+// lib/command-send-pump.ts
+function createCommandSendPump() {
+  let tail = Promise.resolve();
+  return {
+    enqueue(job) {
+      const result = tail.then(job);
+      tail = result.then(
+        () => void 0,
+        () => void 0
+      );
+      return result;
+    }
+  };
+}
+
+// lib/tick-send-relay.ts
+function createTickSendRelay(send) {
+  const lanes = /* @__PURE__ */ new Map();
+  const flush = (key, lane) => {
+    const next = lane.pending;
+    lane.pending = void 0;
+    if (next === void 0) {
+      lane.inFlight = false;
+      return;
+    }
+    lane.inFlight = true;
+    void send(key, next).catch(() => void 0).then(() => flush(key, lane));
+  };
+  return {
+    send(key, value) {
+      const lane = lanes.get(key) ?? { inFlight: false };
+      lanes.set(key, lane);
+      if (lane.inFlight) {
+        lane.pending = value;
+        return;
+      }
+      lane.pending = value;
+      flush(key, lane);
+    },
+    clear() {
+      for (const lane of lanes.values()) {
+        lane.pending = void 0;
+      }
+    }
+  };
+}
+function usePerfBuffer() {
+  return react.useSyncExternalStore(ui.perfStore.subscribe, ui.perfStore.getSnapshot, ui.perfStore.getSnapshot);
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  ui.pushPerfEntry({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+};
 var log2 = logger.createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
@@ -2034,6 +2094,34 @@ var JAZARI_COLORS = {
   darkBg: "#1a1a2e"
 };
 
+Object.defineProperty(exports, "PERF_NAMESPACE", {
+  enumerable: true,
+  get: function () { return ui.PERF_NAMESPACE; }
+});
+Object.defineProperty(exports, "clearPerf", {
+  enumerable: true,
+  get: function () { return ui.clearPerf; }
+});
+Object.defineProperty(exports, "perfEnd", {
+  enumerable: true,
+  get: function () { return ui.perfEnd; }
+});
+Object.defineProperty(exports, "perfGauge", {
+  enumerable: true,
+  get: function () { return ui.perfGauge; }
+});
+Object.defineProperty(exports, "perfStart", {
+  enumerable: true,
+  get: function () { return ui.perfStart; }
+});
+Object.defineProperty(exports, "perfTime", {
+  enumerable: true,
+  get: function () { return ui.perfTime; }
+});
+Object.defineProperty(exports, "perfTimeAsync", {
+  enumerable: true,
+  get: function () { return ui.perfTimeAsync; }
+});
 exports.ApiError = ApiError;
 exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 exports.JAZARI_COLORS = JAZARI_COLORS;
@@ -2053,6 +2141,8 @@ exports.clearVerification = clearVerification;
 exports.cn = cn;
 exports.compareCellValues = compareCellValues;
 exports.computeJazariLayout = computeJazariLayout;
+exports.createCommandSendPump = createCommandSendPump;
+exports.createTickSendRelay = createTickSendRelay;
 exports.debug = debug;
 exports.debugCollision = debugCollision;
 exports.debugError = debugError;
@@ -2115,6 +2205,7 @@ exports.parseContentSegments = parseContentSegments;
 exports.parseLessonSegments = parseLessonSegments;
 exports.parseMarkdownWithCodeBlocks = parseMarkdownWithCodeBlocks;
 exports.pipeIconPath = pipeIconPath;
+exports.profilerOnRender = profilerOnRender;
 exports.recordGuardEvaluation = recordGuardEvaluation;
 exports.recordServerResponse = recordServerResponse;
 exports.recordTransition = recordTransition;
@@ -2143,4 +2234,5 @@ exports.updateCheck = updateCheck;
 exports.updateGuardResult = updateGuardResult;
 exports.updateTickExecution = updateTickExecution;
 exports.updateTraitState = updateTraitState;
+exports.usePerfBuffer = usePerfBuffer;
 exports.waitForTransition = waitForTransition;

package/dist/lib/index.d.cts

@@ -1,6 +1,8 @@
 export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-TH-RHihd.cjs';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
+export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.cjs';
+export { PERF_NAMESPACE, PerfEntry, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '@almadar/runtime/ui';
 import 'react';
 import '../paintDispatch-DgBctxIq.cjs';
 import '../types-B3nHgnMG.cjs';
@@ -285,6 +287,61 @@ declare function onDebugToggle(listener: DebugToggleListener): () => void;
  */
 declare function initDebugShortcut(): () => void;
 
+/**
+ * Command send pump (T7, docs/Almadar_Tick_Loop.md §3a item 2).
+ *
+ * Command-class events are a lossless ordered stream: two OW_DAMAGE hits must
+ * land twice, and the server must apply them in the exact order the client
+ * executed them. Pre-T7 the actor-queue drain `await`ed the server round trip
+ * per entry, so network latency sat on the input path — a keyup's local
+ * transition didn't run until every queued command ahead of it had completed
+ * its round trip (R-COMMAND-DRAIN-AWAIT-INPUT-LAG: 400-900ms typical, 1.6s
+ * peak under rapid platformer input).
+ *
+ * The pump restores ordering without the stall: jobs run strictly one at a
+ * time in enqueue order (request N+1 leaves only after response N arrived, so
+ * the server sees ordered commands and responses arrive in order — no seq
+ * numbers, no server machinery), while the caller's continuation runs when
+ * its own job settles and the drain moves on immediately. Tick-class traffic
+ * never passes through here — it is lossy and goes through
+ * `tick-send-relay.ts` instead.
+ *
+ * @packageDocumentation
+ */
+interface CommandSendPump {
+    /** Run `job` after every previously enqueued job settles, in FIFO order. */
+    enqueue: <T>(job: () => Promise<T>) => Promise<T>;
+}
+declare function createCommandSendPump(): CommandSendPump;
+
+/**
+ * Tick send relay (client→server leg of the tick doctrine, T8).
+ *
+ * A tick emission is a latest-state broadcast, not a command stream: it is
+ * coalesced newest-wins at every hop — client queue (`event-queue-coalesce`),
+ * client→server transport (this module), server relay
+ * (`OrbitalServerRuntime.queueTickRelay`). Pre-T8 this leg was missing: every
+ * tick firing issued one fire-and-forget HTTP POST, and when aggregate RTT ×
+ * rate exceeded the browser's per-origin connection pool, command fetches
+ * (keyup STOP) queued behind a never-ending tick stream — input lag that grew
+ * with play time (R-CLIENT-TICK-POST-BACKLOG).
+ *
+ * Backpressure by construction: at most one send in flight per key. Firings
+ * during flight replace the pending snapshot (newest-wins); on settle the
+ * newest pending goes out (trailing edge). Rate self-limits to 1/RTT — a fast
+ * server sees every tick, a slow one drops stale intermediates instead of
+ * growing a backlog. Commands never pass through here.
+ *
+ * @packageDocumentation
+ */
+interface TickSendRelay<T> {
+    /** Dispatch a snapshot; coalesces onto the in-flight key's lane if busy. */
+    send: (key: string, value: T) => void;
+    /** Drop all pending snapshots (unmount / transport swap). */
+    clear: () => void;
+}
+declare function createTickSendRelay<T>(send: (key: string, value: T) => Promise<void>): TickSendRelay<T>;
+
 /**
  * Shared field-name + value formatting — the single owner of the humanize and
  * format vocabulary previously duplicated across DataTable, DataGrid, CardGrid,
@@ -558,4 +615,4 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/lib/index.d.ts

@@ -1,6 +1,8 @@
 export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-CFurBb2q.js';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
+export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.js';
+export { PERF_NAMESPACE, PerfEntry, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '@almadar/runtime/ui';
 import 'react';
 import '../paintDispatch-B5n2DTB-.js';
 import '../types-B3nHgnMG.js';
@@ -285,6 +287,61 @@ declare function onDebugToggle(listener: DebugToggleListener): () => void;
  */
 declare function initDebugShortcut(): () => void;
 
+/**
+ * Command send pump (T7, docs/Almadar_Tick_Loop.md §3a item 2).
+ *
+ * Command-class events are a lossless ordered stream: two OW_DAMAGE hits must
+ * land twice, and the server must apply them in the exact order the client
+ * executed them. Pre-T7 the actor-queue drain `await`ed the server round trip
+ * per entry, so network latency sat on the input path — a keyup's local
+ * transition didn't run until every queued command ahead of it had completed
+ * its round trip (R-COMMAND-DRAIN-AWAIT-INPUT-LAG: 400-900ms typical, 1.6s
+ * peak under rapid platformer input).
+ *
+ * The pump restores ordering without the stall: jobs run strictly one at a
+ * time in enqueue order (request N+1 leaves only after response N arrived, so
+ * the server sees ordered commands and responses arrive in order — no seq
+ * numbers, no server machinery), while the caller's continuation runs when
+ * its own job settles and the drain moves on immediately. Tick-class traffic
+ * never passes through here — it is lossy and goes through
+ * `tick-send-relay.ts` instead.
+ *
+ * @packageDocumentation
+ */
+interface CommandSendPump {
+    /** Run `job` after every previously enqueued job settles, in FIFO order. */
+    enqueue: <T>(job: () => Promise<T>) => Promise<T>;
+}
+declare function createCommandSendPump(): CommandSendPump;
+
+/**
+ * Tick send relay (client→server leg of the tick doctrine, T8).
+ *
+ * A tick emission is a latest-state broadcast, not a command stream: it is
+ * coalesced newest-wins at every hop — client queue (`event-queue-coalesce`),
+ * client→server transport (this module), server relay
+ * (`OrbitalServerRuntime.queueTickRelay`). Pre-T8 this leg was missing: every
+ * tick firing issued one fire-and-forget HTTP POST, and when aggregate RTT ×
+ * rate exceeded the browser's per-origin connection pool, command fetches
+ * (keyup STOP) queued behind a never-ending tick stream — input lag that grew
+ * with play time (R-CLIENT-TICK-POST-BACKLOG).
+ *
+ * Backpressure by construction: at most one send in flight per key. Firings
+ * during flight replace the pending snapshot (newest-wins); on settle the
+ * newest pending goes out (trailing edge). Rate self-limits to 1/RTT — a fast
+ * server sees every tick, a slow one drops stale intermediates instead of
+ * growing a backlog. Commands never pass through here.
+ *
+ * @packageDocumentation
+ */
+interface TickSendRelay<T> {
+    /** Dispatch a snapshot; coalesces onto the in-flight key's lane if busy. */
+    send: (key: string, value: T) => void;
+    /** Drop all pending snapshots (unmount / transport swap). */
+    clear: () => void;
+}
+declare function createTickSendRelay<T>(send: (key: string, value: T) => Promise<void>): TickSendRelay<T>;
+
 /**
  * Shared field-name + value formatting — the single owner of the humanize and
  * format vocabulary previously duplicated across DataTable, DataGrid, CardGrid,
@@ -558,4 +615,4 @@ declare function eightPointedStarPath(cx: number, cy: number, outerR: number, in
  */
 declare function arrowheadPath(size: number): string;
 
-export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+export { ApiError, type CommandSendPump, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, JAZARI_COLORS, type JazariArmLayout, type JazariEffectInfo, type JazariGearLayout, type JazariGuardInfo, type JazariLayout, type LayoutInput, type LayoutState, type LayoutTransition, type PersistentEntityInfo, type RuntimeEntity, type SortDirection, type TickExecution, type TickSendRelay, type TraitDebugInfo, type TraitGuard, type TraitTransition, type ValueFormat, apiClient, arrowheadPath, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, formatDate, formatDateTime, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, pipeIconPath, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/lib/index.js

@@ -1,6 +1,9 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
+import { useSyncExternalStore } from 'react';
+import { perfStore, pushPerfEntry } from '@almadar/runtime/ui';
+export { PERF_NAMESPACE, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '@almadar/runtime/ui';
 import { isFileValue } from '@almadar/core';
 
 var __defProp = Object.defineProperty;
@@ -444,6 +447,64 @@ function clearTraits() {
   traits.clear();
   notifyListeners4();
 }
+
+// lib/command-send-pump.ts
+function createCommandSendPump() {
+  let tail = Promise.resolve();
+  return {
+    enqueue(job) {
+      const result = tail.then(job);
+      tail = result.then(
+        () => void 0,
+        () => void 0
+      );
+      return result;
+    }
+  };
+}
+
+// lib/tick-send-relay.ts
+function createTickSendRelay(send) {
+  const lanes = /* @__PURE__ */ new Map();
+  const flush = (key, lane) => {
+    const next = lane.pending;
+    lane.pending = void 0;
+    if (next === void 0) {
+      lane.inFlight = false;
+      return;
+    }
+    lane.inFlight = true;
+    void send(key, next).catch(() => void 0).then(() => flush(key, lane));
+  };
+  return {
+    send(key, value) {
+      const lane = lanes.get(key) ?? { inFlight: false };
+      lanes.set(key, lane);
+      if (lane.inFlight) {
+        lane.pending = value;
+        return;
+      }
+      lane.pending = value;
+      flush(key, lane);
+    },
+    clear() {
+      for (const lane of lanes.values()) {
+        lane.pending = void 0;
+      }
+    }
+  };
+}
+function usePerfBuffer() {
+  return useSyncExternalStore(perfStore.subscribe, perfStore.getSnapshot, perfStore.getSnapshot);
+}
+var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+  pushPerfEntry({
+    name: `profiler:${id}:${phase}`,
+    durationMs: actualDuration,
+    ts: commitTime,
+    detail: { baseDuration }
+  });
+};
 var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
@@ -2032,4 +2093,4 @@ var JAZARI_COLORS = {
   darkBg: "#1a1a2e"
 };
 
-export { ApiError, DEFAULT_CONFIG, JAZARI_COLORS, apiClient, arrowheadPath, bindCanvasCapture, bindEventBus, bindLastDrawables, bindTraitStateGetter, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, compareCellValues, computeJazariLayout, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, extractOutputsFromTransitions, extractStateMachine, formatDate, formatDateTime, formatGuard, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks, pipeIconPath, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };
+export { ApiError, DEFAULT_CONFIG, JAZARI_COLORS, apiClient, arrowheadPath, bindCanvasCapture, bindEventBus, bindLastDrawables, bindTraitStateGetter, brainIconPath, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, compareCellValues, computeJazariLayout, createCommandSendPump, createTickSendRelay, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, eightPointedStarPath, extractOutputsFromTransitions, extractStateMachine, formatDate, formatDateTime, formatGuard, formatNestedFieldLabel, formatTime, formatValue, gearTeethPath, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, humanizeEnumValue, humanizeFieldName, initDebugShortcut, isDebugEnabled, lockIconPath, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks, pipeIconPath, profilerOnRender, recordGuardEvaluation, recordServerResponse, recordTransition, registerCheck, registerTick, registerTrait, registerTraitSnapshot, renderStateMachineToDomData, renderStateMachineToSvg, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, sortRows, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, usePerfBuffer, waitForTransition };

package/dist/locales/index.cjs

@@ -13,6 +13,7 @@ var en_default = {
   "common.confirm": "Are you sure?",
   "common.create": "Create",
   "common.edit": "Edit",
+  "common.title": "Title",
   "common.view": "View",
   "common.add": "Add",
   "common.remove": "Remove",
@@ -590,6 +591,7 @@ var ar_default = {
   "common.confirm": "\u0647\u0644 \u0623\u0646\u062A \u0645\u062A\u0623\u0643\u062F\u061F",
   "common.create": "\u0625\u0646\u0634\u0627\u0621",
   "common.edit": "\u062A\u0639\u062F\u064A\u0644",
+  "common.title": "\u0627\u0644\u0639\u0646\u0648\u0627\u0646",
   "common.view": "\u0639\u0631\u0636",
   "common.add": "\u0625\u0636\u0627\u0641\u0629",
   "common.remove": "\u0625\u0632\u0627\u0644\u0629",
@@ -1167,6 +1169,7 @@ var sl_default = {
   "common.confirm": "Ali ste prepri\u010Dani?",
   "common.create": "Ustvari",
   "common.edit": "Uredi",
+  "common.title": "Naslov",
   "common.view": "Prika\u017Ei",
   "common.add": "Dodaj",
   "common.remove": "Odstrani",

package/dist/locales/index.js

@@ -11,6 +11,7 @@ var en_default = {
   "common.confirm": "Are you sure?",
   "common.create": "Create",
   "common.edit": "Edit",
+  "common.title": "Title",
   "common.view": "View",
   "common.add": "Add",
   "common.remove": "Remove",
@@ -588,6 +589,7 @@ var ar_default = {
   "common.confirm": "\u0647\u0644 \u0623\u0646\u062A \u0645\u062A\u0623\u0643\u062F\u061F",
   "common.create": "\u0625\u0646\u0634\u0627\u0621",
   "common.edit": "\u062A\u0639\u062F\u064A\u0644",
+  "common.title": "\u0627\u0644\u0639\u0646\u0648\u0627\u0646",
   "common.view": "\u0639\u0631\u0636",
   "common.add": "\u0625\u0636\u0627\u0641\u0629",
   "common.remove": "\u0625\u0632\u0627\u0644\u0629",
@@ -1165,6 +1167,7 @@ var sl_default = {
   "common.confirm": "Ali ste prepri\u010Dani?",
   "common.create": "Ustvari",
   "common.edit": "Uredi",
+  "common.title": "Naslov",
   "common.view": "Prika\u017Ei",
   "common.add": "Dodaj",
   "common.remove": "Odstrani",

package/dist/perf-DaVdsbU0.d.cts

@@ -0,0 +1,21 @@
+import { ProfilerOnRenderCallback } from 'react';
+import { PerfEntry } from '@almadar/runtime/ui';
+
+/**
+ * @almadar/ui/runtime — perf instrumentation
+ *
+ * React-specific consumption layer on top of the renderer-agnostic perf ring
+ * now living in `@almadar/runtime/ui/perf`. Re-exports the framework-free
+ * timing primitives and adds `useSyncExternalStore` / `React.Profiler` hooks.
+ */
+
+/**
+ * React hook: returns the current perf ring snapshot, re-renders on push.
+ */
+declare function usePerfBuffer(): readonly PerfEntry[];
+/**
+ * React.Profiler `onRender` callback. Records `actualDuration` per commit.
+ */
+declare const profilerOnRender: ProfilerOnRenderCallback;
+
+export { profilerOnRender as p, usePerfBuffer as u };

package/dist/perf-DaVdsbU0.d.ts

@@ -0,0 +1,21 @@
+import { ProfilerOnRenderCallback } from 'react';
+import { PerfEntry } from '@almadar/runtime/ui';
+
+/**
+ * @almadar/ui/runtime — perf instrumentation
+ *
+ * React-specific consumption layer on top of the renderer-agnostic perf ring
+ * now living in `@almadar/runtime/ui/perf`. Re-exports the framework-free
+ * timing primitives and adds `useSyncExternalStore` / `React.Profiler` hooks.
+ */
+
+/**
+ * React hook: returns the current perf ring snapshot, re-renders on push.
+ */
+declare function usePerfBuffer(): readonly PerfEntry[];
+/**
+ * React.Profiler `onRender` callback. Records `actualDuration` per commit.
+ */
+declare const profilerOnRender: ProfilerOnRenderCallback;
+
+export { profilerOnRender as p, usePerfBuffer as u };