@almadar/ui 6.7.0 → 6.8.0

package/dist/runtime/index.cjs

@@ -54281,6 +54281,14 @@ function PluginRuntimeMount({
     () => new Set(plugin.schema.orbitals.map((o) => o.name)),
     [plugin.schema]
   );
+  const inboundBusEvents = React87.useMemo(
+    () => new Set(plugin.inbound.map((row) => row.busEvent)),
+    [plugin.inbound]
+  );
+  const inboundTriggerNames = React87.useMemo(
+    () => new Set(plugin.inbound.map((row) => row.trigger)),
+    [plugin.inbound]
+  );
   const snapshotAllStates = React87.useCallback(() => {
     const states = [];
     if (!mockRuntime) return states;
@@ -54322,6 +54330,21 @@ function PluginRuntimeMount({
       if (timer !== null) clearTimeout(timer);
     };
   }, [mockRuntime, plugin.id, onDispatched, snapshotAllStates]);
+  React87.useEffect(() => {
+    if (!mockRuntime) return;
+    const rebroadcast = /* @__PURE__ */ new WeakSet();
+    const unsub = mockRuntime.getEventBus().onAny((event) => {
+      if (rebroadcast.has(event)) return;
+      if (inboundBusEvents.has(event.type) || inboundTriggerNames.has(event.type)) return;
+      const sourceOrbital = event.source?.orbital;
+      if (sourceOrbital === void 0 || !ownOrbitals.has(sourceOrbital)) return;
+      rebroadcast.add(event);
+      bus.emit(`UI:${event.type}`, event.payload, event.source);
+    });
+    return () => {
+      unsub();
+    };
+  }, [mockRuntime, bus, ownOrbitals, inboundBusEvents, inboundTriggerNames]);
   const dispatch = React87.useCallback(
     async (row, payload) => {
       await registrationReady;
@@ -54340,11 +54363,14 @@ function PluginRuntimeMount({
       if (!response.success) {
         onError(plugin.id, response.error ?? `${plugin.id}: ${row.trigger} failed`);
       }
-      for (const entry of response.emittedEvents ?? []) {
-        if (entry.event === row.trigger) continue;
-        const sourceOrbital = entry.source?.orbital;
-        if (sourceOrbital !== void 0 && ownOrbitals.has(sourceOrbital)) {
-          bus.emit(`UI:${entry.event}`, entry.payload, entry.source);
+      if (!mockRuntime) {
+        for (const entry of response.emittedEvents ?? []) {
+          if (entry.event === row.trigger) continue;
+          if (inboundBusEvents.has(entry.event)) continue;
+          const sourceOrbital = entry.source?.orbital;
+          if (sourceOrbital !== void 0 && ownOrbitals.has(sourceOrbital)) {
+            bus.emit(`UI:${entry.event}`, entry.payload, entry.source);
+          }
         }
       }
       const states = [];
@@ -54354,7 +54380,7 @@ function PluginRuntimeMount({
       }
       onDispatched(plugin.id, row.trigger, states);
     },
-    [registrationReady, mockRuntime, mode, transport, plugin, bus, ownOrbitals, onError, onTransition, onDispatched]
+    [registrationReady, mockRuntime, mode, transport, plugin, bus, ownOrbitals, inboundBusEvents, onError, onTransition, onDispatched]
   );
   React87.useEffect(() => {
     const unsubs = plugin.inbound.map(

package/dist/runtime/index.d.cts

@@ -327,6 +327,34 @@ declare function BrowserPlayground({ schema, mode, initialPagePath, height, clas
  * preview has (in-memory persist, mock services); `deny` is an opt-in
  * host policy, never a default sandbox.
  *
+ * OUTBOUND = the runtime's internal event bus, not the direct dispatch
+ * response. `response.emittedEvents` (mock mode) reflects only the effects
+ * of the trait `dispatch()` DIRECTLY targeted — a sibling trait that reacts
+ * through the runtime's own cascade (`setupEventListeners`, a SEPARATE
+ * `processOrbitalEvent` call whose response is discarded) never shows up
+ * there, so its emits never reached the ambient bus (verified 2026-09-04:
+ * vim-mode's `Shell` relays `PLUGIN_ENABLED` -> `VimStudioBridge`'s
+ * `ENABLED` arm emits `STATUS` + 2x `REGISTER_COMMAND`, none of which
+ * reached the studio's status bar/palette). Fix: for `mode: 'mock'`, one
+ * `runtime.getEventBus().onAny(...)` subscription per plugin (mounted
+ * alongside the runtime, not per-dispatch) is the ONLY outbound path — it
+ * sees every emit, direct or cascaded, since every `emit` effect passes
+ * through that same bus. `mode: 'server'` has no local bus to subscribe to
+ * (the runtime lives on the remote transport), so it keeps reading
+ * `response.emittedEvents` for outbound — same single-hop-only limitation
+ * this fix removes for mock mode, unaddressed here (no `mode: 'server'`
+ * consumer exists yet; see `docs/Almadar_UI_Gaps.md`).
+ *
+ * RELAY RULE: the plugin's `inbound[]` is its host→plugin vocabulary — one
+ * `UI:<busEvent>` bus event per row, dispatching `trigger` at
+ * `orbital`/`trait`. Anything a plugin emits under one of those SAME
+ * busEvent names (or under an inbound `trigger` name) is a relay for its
+ * own siblings' `listens {}` (the runtime's internal event bus already
+ * carries that fan-out), never a fresh request back to the host, and must
+ * NEVER be re-broadcast — doing so re-fires the very `UI:<busEvent>`
+ * listener that produced it, a synchronous self-feeding loop (verified
+ * 2026-09-04, see `docs/Almadar_UI_Gaps.md`).
+ *
  * @packageDocumentation
  */
 

package/dist/runtime/index.d.ts

@@ -327,6 +327,34 @@ declare function BrowserPlayground({ schema, mode, initialPagePath, height, clas
  * preview has (in-memory persist, mock services); `deny` is an opt-in
  * host policy, never a default sandbox.
  *
+ * OUTBOUND = the runtime's internal event bus, not the direct dispatch
+ * response. `response.emittedEvents` (mock mode) reflects only the effects
+ * of the trait `dispatch()` DIRECTLY targeted — a sibling trait that reacts
+ * through the runtime's own cascade (`setupEventListeners`, a SEPARATE
+ * `processOrbitalEvent` call whose response is discarded) never shows up
+ * there, so its emits never reached the ambient bus (verified 2026-09-04:
+ * vim-mode's `Shell` relays `PLUGIN_ENABLED` -> `VimStudioBridge`'s
+ * `ENABLED` arm emits `STATUS` + 2x `REGISTER_COMMAND`, none of which
+ * reached the studio's status bar/palette). Fix: for `mode: 'mock'`, one
+ * `runtime.getEventBus().onAny(...)` subscription per plugin (mounted
+ * alongside the runtime, not per-dispatch) is the ONLY outbound path — it
+ * sees every emit, direct or cascaded, since every `emit` effect passes
+ * through that same bus. `mode: 'server'` has no local bus to subscribe to
+ * (the runtime lives on the remote transport), so it keeps reading
+ * `response.emittedEvents` for outbound — same single-hop-only limitation
+ * this fix removes for mock mode, unaddressed here (no `mode: 'server'`
+ * consumer exists yet; see `docs/Almadar_UI_Gaps.md`).
+ *
+ * RELAY RULE: the plugin's `inbound[]` is its host→plugin vocabulary — one
+ * `UI:<busEvent>` bus event per row, dispatching `trigger` at
+ * `orbital`/`trait`. Anything a plugin emits under one of those SAME
+ * busEvent names (or under an inbound `trigger` name) is a relay for its
+ * own siblings' `listens {}` (the runtime's internal event bus already
+ * carries that fan-out), never a fresh request back to the host, and must
+ * NEVER be re-broadcast — doing so re-fires the very `UI:<busEvent>`
+ * listener that produced it, a synchronous self-feeding loop (verified
+ * 2026-09-04, see `docs/Almadar_UI_Gaps.md`).
+ *
  * @packageDocumentation
  */
 

package/dist/runtime/index.js

@@ -54207,6 +54207,14 @@ function PluginRuntimeMount({
     () => new Set(plugin.schema.orbitals.map((o) => o.name)),
     [plugin.schema]
   );
+  const inboundBusEvents = useMemo(
+    () => new Set(plugin.inbound.map((row) => row.busEvent)),
+    [plugin.inbound]
+  );
+  const inboundTriggerNames = useMemo(
+    () => new Set(plugin.inbound.map((row) => row.trigger)),
+    [plugin.inbound]
+  );
   const snapshotAllStates = useCallback(() => {
     const states = [];
     if (!mockRuntime) return states;
@@ -54248,6 +54256,21 @@ function PluginRuntimeMount({
       if (timer !== null) clearTimeout(timer);
     };
   }, [mockRuntime, plugin.id, onDispatched, snapshotAllStates]);
+  useEffect(() => {
+    if (!mockRuntime) return;
+    const rebroadcast = /* @__PURE__ */ new WeakSet();
+    const unsub = mockRuntime.getEventBus().onAny((event) => {
+      if (rebroadcast.has(event)) return;
+      if (inboundBusEvents.has(event.type) || inboundTriggerNames.has(event.type)) return;
+      const sourceOrbital = event.source?.orbital;
+      if (sourceOrbital === void 0 || !ownOrbitals.has(sourceOrbital)) return;
+      rebroadcast.add(event);
+      bus.emit(`UI:${event.type}`, event.payload, event.source);
+    });
+    return () => {
+      unsub();
+    };
+  }, [mockRuntime, bus, ownOrbitals, inboundBusEvents, inboundTriggerNames]);
   const dispatch = useCallback(
     async (row, payload) => {
       await registrationReady;
@@ -54266,11 +54289,14 @@ function PluginRuntimeMount({
       if (!response.success) {
         onError(plugin.id, response.error ?? `${plugin.id}: ${row.trigger} failed`);
       }
-      for (const entry of response.emittedEvents ?? []) {
-        if (entry.event === row.trigger) continue;
-        const sourceOrbital = entry.source?.orbital;
-        if (sourceOrbital !== void 0 && ownOrbitals.has(sourceOrbital)) {
-          bus.emit(`UI:${entry.event}`, entry.payload, entry.source);
+      if (!mockRuntime) {
+        for (const entry of response.emittedEvents ?? []) {
+          if (entry.event === row.trigger) continue;
+          if (inboundBusEvents.has(entry.event)) continue;
+          const sourceOrbital = entry.source?.orbital;
+          if (sourceOrbital !== void 0 && ownOrbitals.has(sourceOrbital)) {
+            bus.emit(`UI:${entry.event}`, entry.payload, entry.source);
+          }
         }
       }
       const states = [];
@@ -54280,7 +54306,7 @@ function PluginRuntimeMount({
       }
       onDispatched(plugin.id, row.trigger, states);
     },
-    [registrationReady, mockRuntime, mode, transport, plugin, bus, ownOrbitals, onError, onTransition, onDispatched]
+    [registrationReady, mockRuntime, mode, transport, plugin, bus, ownOrbitals, inboundBusEvents, onError, onTransition, onDispatched]
   );
   useEffect(() => {
     const unsubs = plugin.inbound.map(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -122,7 +122,7 @@
     "@almadar/evaluator": "^2.44.0",
     "@almadar/logger": "^1.12.0",
     "@almadar/runtime": "^6.71.0",
-    "@almadar/std": "^16.204.0",
+    "@almadar/std": "^16.205.0",
     "@almadar/syntax": "^1.16.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",