@almadar/core 7.7.1 → 7.9.0

package/dist/types/index.d.ts

@@ -944,6 +944,15 @@ interface ResolvedTrait {
     ticks: ResolvedTraitTick[];
     listens: ResolvedTraitListener[];
     dataEntities: ResolvedTraitDataEntity[];
+    /**
+     * Atom-declared linked entity. The atom (e.g. std-pagination)
+     * declares which entity its `@entity.X` bindings resolve against
+     * (e.g. `PagedItem`). Distinct from the call-site rebind on
+     * `ResolvedTraitBinding.linkedEntity`, which a molecule may use
+     * to override the atom's default. Either side may be undefined
+     * for traits that don't bind any entity (pure interaction).
+     */
+    linkedEntity?: string;
     /**
      * The trait's DECLARED `config { }` schema (per-field
      * `{ type, default? }`). Drives `@config.X` substitution: each
@@ -1169,14 +1178,26 @@ interface BusEventSource {
     transition?: string;
     tick?: string;
     /**
-     * True when the orbital bridge is re-broadcasting a transition event
-     * on the bus so cross-trait `listens { X EVENT → Y }` wiring fires on
-     * user-click flows. The originating trait's own `useUIEvents` plain-
-     * event listener checks this flag and skips — otherwise the trait
-     * that just dispatched E would hear its own bridge echo and dispatch
-     * E again, infinitely.
+     * True when the orbital bridge re-broadcasts an event onto the bus
+     * (any source — both echoes of the dispatched event and server-side
+     * cascade emits via `(emit X)` / `fetch.emit.success`). Cross-trait
+     * listeners filter on this flag so the click-time qualified emit
+     * (which has no `fromBridge`) doesn't double-fire alongside the
+     * post-server bridge confirmation. See `dispatched` for the narrower
+     * "echo of the just-dispatched event" signal.
      */
     fromBridge?: boolean;
+    /**
+     * True ONLY for the bridge echo of the event the source trait JUST
+     * dispatched (path 1 of useOrbitalBridge). The originating trait's
+     * `useUIEvents` skips events with this flag to prevent the source
+     * from re-dispatching its own bridge echo (infinite loop). Server-
+     * side cascade emits (path 2) carry `fromBridge: true` but NOT
+     * `dispatched`, so they reach the source trait's transition handler
+     * — that's how a fetch's `emit.success` advances the trait's own
+     * state machine (e.g. `loading -> browsing` on `BrowseItemLoaded`).
+     */
+    dispatched?: boolean;
 }
 /**
  * An event flowing on the bus.