@almadar/ui 6.7.0 → 6.9.0

package/dist/runtime/index.d.cts

@@ -3,7 +3,7 @@ import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, Resolv
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
-import { K as KeyCaptureTable } from '../useKeyboardRouter-DQEE_9mq.cjs';
+import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
 import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-Bn3ePJQC.cjs';
 export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-Bn3ePJQC.cjs';
@@ -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
  */
 
@@ -364,13 +392,18 @@ interface OrbitalPluginHostProps {
  * live `currentState`, so `useKeyboardRouter`'s capture table always follows
  * the trait's actual mode. Re-derives whenever the host records a new
  * transition (the context's `tick`).
+ *
+ * `target` accepts either one target string (default `'shell'`) or a list of
+ * targets — the SAME derived entry (mode + keys) is repeated under every
+ * target, for a caller keying its table by several editor ids at once (e.g.
+ * one plugin's mode capturing keys for both `'schema'` and `'file:a.md'`).
  */
 declare function useDeclaredCaptureTable(opts: {
     pluginId: string;
     orbital: string;
     trait: string;
     keymapKnob?: string;
-    target?: string;
+    target?: string | readonly string[];
 }): KeyCaptureTable;
 declare function useOrbitalPluginHost(): {
     getState: (pluginId: string, orbital: string, trait: string) => TraitState | undefined;

package/dist/runtime/index.d.ts

@@ -3,7 +3,7 @@ import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, Resolv
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
-import { K as KeyCaptureTable } from '../useKeyboardRouter-D84cNWmA.js';
+import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
 import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-Bn3ePJQC.js';
 export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-Bn3ePJQC.js';
@@ -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
  */
 
@@ -364,13 +392,18 @@ interface OrbitalPluginHostProps {
  * live `currentState`, so `useKeyboardRouter`'s capture table always follows
  * the trait's actual mode. Re-derives whenever the host records a new
  * transition (the context's `tick`).
+ *
+ * `target` accepts either one target string (default `'shell'`) or a list of
+ * targets — the SAME derived entry (mode + keys) is repeated under every
+ * target, for a caller keying its table by several editor ids at once (e.g.
+ * one plugin's mode capturing keys for both `'schema'` and `'file:a.md'`).
  */
 declare function useDeclaredCaptureTable(opts: {
     pluginId: string;
     orbital: string;
     trait: string;
     keymapKnob?: string;
-    target?: string;
+    target?: string | readonly string[];
 }): KeyCaptureTable;
 declare function useOrbitalPluginHost(): {
     getState: (pluginId: string, orbital: string, trait: string) => TraitState | undefined;