@almadar/ui 5.9.7 → 5.9.8

package/dist/avl/index.cjs

@@ -60902,6 +60902,40 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   };
 }
 
+// runtime/orbitalsByTrait.ts
+function buildOrbitalsByTrait(schema, resolvedPages = []) {
+  const map = {};
+  if (!schema?.orbitals) return map;
+  const pagePathToOrbital = {};
+  for (const orb of schema.orbitals) {
+    for (const traitRef of orb.traits ?? []) {
+      let traitName;
+      if (typeof traitRef === "string") {
+        const parts = traitRef.split(".");
+        traitName = parts[parts.length - 1];
+      } else if (typeof traitRef.ref === "string") {
+        const parts = traitRef.ref.split(".");
+        traitName = traitRef.name ?? parts[parts.length - 1];
+      } else if (typeof traitRef.name === "string") {
+        traitName = traitRef.name;
+      }
+      if (traitName) map[traitName] = orb.name;
+    }
+    for (const pg of orb.pages ?? []) {
+      const path = typeof pg === "string" ? pg : pg?.path;
+      if (path) pagePathToOrbital[path] = orb.name;
+    }
+  }
+  for (const page of resolvedPages) {
+    const orbital = page.path ? pagePathToOrbital[page.path] : void 0;
+    if (!orbital) continue;
+    for (const traitName of page.traitNames) {
+      if (traitName && !(traitName in map)) map[traitName] = orbital;
+    }
+  }
+  return map;
+}
+
 // runtime/OrbPreview.tsx
 init_EntitySchemaContext();
 
@@ -61660,27 +61694,16 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const orbitalsByTrait = React98.useMemo(() => {
-    const map = {};
-    const parsed = schema;
-    if (!parsed?.orbitals) return map;
-    for (const orb of parsed.orbitals) {
-      for (const traitRef of orb.traits) {
-        let traitName;
-        if (typeof traitRef === "string") {
-          const parts = traitRef.split(".");
-          traitName = parts[parts.length - 1];
-        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
-          const parts = traitRef.ref.split(".");
-          traitName = traitRef.name ?? parts[parts.length - 1];
-        } else if ("name" in traitRef && typeof traitRef.name === "string") {
-          traitName = traitRef.name;
-        }
-        if (traitName) map[traitName] = orb.name;
-      }
-    }
-    return map;
-  }, [schema]);
+  const orbitalsByTrait = React98.useMemo(
+    () => buildOrbitalsByTrait(
+      schema,
+      ir ? Array.from(ir.pages.values()).map((p2) => ({
+        path: p2.path,
+        traitNames: p2.traits.map((b) => b.trait.name)
+      })) : []
+    ),
+    [schema, ir]
+  );
   const traitLinkedEntitiesMap = React98.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     if (ir) {

package/dist/avl/index.js

@@ -60853,6 +60853,40 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   };
 }
 
+// runtime/orbitalsByTrait.ts
+function buildOrbitalsByTrait(schema, resolvedPages = []) {
+  const map = {};
+  if (!schema?.orbitals) return map;
+  const pagePathToOrbital = {};
+  for (const orb of schema.orbitals) {
+    for (const traitRef of orb.traits ?? []) {
+      let traitName;
+      if (typeof traitRef === "string") {
+        const parts = traitRef.split(".");
+        traitName = parts[parts.length - 1];
+      } else if (typeof traitRef.ref === "string") {
+        const parts = traitRef.ref.split(".");
+        traitName = traitRef.name ?? parts[parts.length - 1];
+      } else if (typeof traitRef.name === "string") {
+        traitName = traitRef.name;
+      }
+      if (traitName) map[traitName] = orb.name;
+    }
+    for (const pg of orb.pages ?? []) {
+      const path = typeof pg === "string" ? pg : pg?.path;
+      if (path) pagePathToOrbital[path] = orb.name;
+    }
+  }
+  for (const page of resolvedPages) {
+    const orbital = page.path ? pagePathToOrbital[page.path] : void 0;
+    if (!orbital) continue;
+    for (const traitName of page.traitNames) {
+      if (traitName && !(traitName in map)) map[traitName] = orbital;
+    }
+  }
+  return map;
+}
+
 // runtime/OrbPreview.tsx
 init_EntitySchemaContext();
 
@@ -61611,27 +61645,16 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const orbitalsByTrait = useMemo(() => {
-    const map = {};
-    const parsed = schema;
-    if (!parsed?.orbitals) return map;
-    for (const orb of parsed.orbitals) {
-      for (const traitRef of orb.traits) {
-        let traitName;
-        if (typeof traitRef === "string") {
-          const parts = traitRef.split(".");
-          traitName = parts[parts.length - 1];
-        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
-          const parts = traitRef.ref.split(".");
-          traitName = traitRef.name ?? parts[parts.length - 1];
-        } else if ("name" in traitRef && typeof traitRef.name === "string") {
-          traitName = traitRef.name;
-        }
-        if (traitName) map[traitName] = orb.name;
-      }
-    }
-    return map;
-  }, [schema]);
+  const orbitalsByTrait = useMemo(
+    () => buildOrbitalsByTrait(
+      schema,
+      ir ? Array.from(ir.pages.values()).map((p2) => ({
+        path: p2.path,
+        traitNames: p2.traits.map((b) => b.trait.name)
+      })) : []
+    ),
+    [schema, ir]
+  );
   const traitLinkedEntitiesMap = useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     if (ir) {

package/dist/runtime/index.cjs

@@ -48544,6 +48544,40 @@ function collectEmbeddedTraits(schema) {
   return out;
 }
 
+// runtime/orbitalsByTrait.ts
+function buildOrbitalsByTrait(schema, resolvedPages = []) {
+  const map = {};
+  if (!schema?.orbitals) return map;
+  const pagePathToOrbital = {};
+  for (const orb of schema.orbitals) {
+    for (const traitRef of orb.traits ?? []) {
+      let traitName;
+      if (typeof traitRef === "string") {
+        const parts = traitRef.split(".");
+        traitName = parts[parts.length - 1];
+      } else if (typeof traitRef.ref === "string") {
+        const parts = traitRef.ref.split(".");
+        traitName = traitRef.name ?? parts[parts.length - 1];
+      } else if (typeof traitRef.name === "string") {
+        traitName = traitRef.name;
+      }
+      if (traitName) map[traitName] = orb.name;
+    }
+    for (const pg of orb.pages ?? []) {
+      const path = typeof pg === "string" ? pg : pg?.path;
+      if (path) pagePathToOrbital[path] = orb.name;
+    }
+  }
+  for (const page of resolvedPages) {
+    const orbital = page.path ? pagePathToOrbital[page.path] : void 0;
+    if (!orbital) continue;
+    for (const traitName of page.traitNames) {
+      if (traitName && !(traitName in map)) map[traitName] = orbital;
+    }
+  }
+  return map;
+}
+
 // runtime/OrbPreview.tsx
 init_EntitySchemaContext();
 
@@ -49339,27 +49373,16 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const orbitalsByTrait = React85.useMemo(() => {
-    const map = {};
-    const parsed = schema;
-    if (!parsed?.orbitals) return map;
-    for (const orb of parsed.orbitals) {
-      for (const traitRef of orb.traits) {
-        let traitName;
-        if (typeof traitRef === "string") {
-          const parts = traitRef.split(".");
-          traitName = parts[parts.length - 1];
-        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
-          const parts = traitRef.ref.split(".");
-          traitName = traitRef.name ?? parts[parts.length - 1];
-        } else if ("name" in traitRef && typeof traitRef.name === "string") {
-          traitName = traitRef.name;
-        }
-        if (traitName) map[traitName] = orb.name;
-      }
-    }
-    return map;
-  }, [schema]);
+  const orbitalsByTrait = React85.useMemo(
+    () => buildOrbitalsByTrait(
+      schema,
+      ir ? Array.from(ir.pages.values()).map((p2) => ({
+        path: p2.path,
+        traitNames: p2.traits.map((b) => b.trait.name)
+      })) : []
+    ),
+    [schema, ir]
+  );
   const traitLinkedEntitiesMap = React85.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     if (ir) {

package/dist/runtime/index.js

@@ -48495,6 +48495,40 @@ function collectEmbeddedTraits(schema) {
   return out;
 }
 
+// runtime/orbitalsByTrait.ts
+function buildOrbitalsByTrait(schema, resolvedPages = []) {
+  const map = {};
+  if (!schema?.orbitals) return map;
+  const pagePathToOrbital = {};
+  for (const orb of schema.orbitals) {
+    for (const traitRef of orb.traits ?? []) {
+      let traitName;
+      if (typeof traitRef === "string") {
+        const parts = traitRef.split(".");
+        traitName = parts[parts.length - 1];
+      } else if (typeof traitRef.ref === "string") {
+        const parts = traitRef.ref.split(".");
+        traitName = traitRef.name ?? parts[parts.length - 1];
+      } else if (typeof traitRef.name === "string") {
+        traitName = traitRef.name;
+      }
+      if (traitName) map[traitName] = orb.name;
+    }
+    for (const pg of orb.pages ?? []) {
+      const path = typeof pg === "string" ? pg : pg?.path;
+      if (path) pagePathToOrbital[path] = orb.name;
+    }
+  }
+  for (const page of resolvedPages) {
+    const orbital = page.path ? pagePathToOrbital[page.path] : void 0;
+    if (!orbital) continue;
+    for (const traitName of page.traitNames) {
+      if (traitName && !(traitName in map)) map[traitName] = orbital;
+    }
+  }
+  return map;
+}
+
 // runtime/OrbPreview.tsx
 init_EntitySchemaContext();
 
@@ -49290,27 +49324,16 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const orbitalsByTrait = useMemo(() => {
-    const map = {};
-    const parsed = schema;
-    if (!parsed?.orbitals) return map;
-    for (const orb of parsed.orbitals) {
-      for (const traitRef of orb.traits) {
-        let traitName;
-        if (typeof traitRef === "string") {
-          const parts = traitRef.split(".");
-          traitName = parts[parts.length - 1];
-        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
-          const parts = traitRef.ref.split(".");
-          traitName = traitRef.name ?? parts[parts.length - 1];
-        } else if ("name" in traitRef && typeof traitRef.name === "string") {
-          traitName = traitRef.name;
-        }
-        if (traitName) map[traitName] = orb.name;
-      }
-    }
-    return map;
-  }, [schema]);
+  const orbitalsByTrait = useMemo(
+    () => buildOrbitalsByTrait(
+      schema,
+      ir ? Array.from(ir.pages.values()).map((p2) => ({
+        path: p2.path,
+        traitNames: p2.traits.map((b) => b.trait.name)
+      })) : []
+    ),
+    [schema, ir]
+  );
   const traitLinkedEntitiesMap = useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     if (ir) {

package/dist/runtime/orbitalsByTrait.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Build the `trait name → owning orbital` map used to form the qualified
+ * `UI:<orbital>.<trait>.<event>` bus keys that trait state machines subscribe
+ * to. Pure + dependency-free so it can be unit-tested without a React render.
+ *
+ * Critically, it backfills from the RESOLVED page bindings, not just the source
+ * `schema.orbitals[].traits`. An auto-pulled sibling trait (e.g. an embedded
+ * `@trait.X` calendar lifted into the orbital by the compiler's sibling-pull)
+ * is absent from the source orbital's `traits[]`, so a source-only map misses
+ * it — leaving its self-subscription unregistered and its own fetch-success
+ * (e.g. `CalendarEventLoaded`) unheard, so the trait sticks in `loading`. A
+ * pulled sibling lands in the same orbital as the page that references it, so
+ * we backfill from the resolved page's owning orbital. Source-declared mappings
+ * win; the IR only fills gaps.
+ */
+export interface OrbitalsByTraitSchema {
+    orbitals?: ReadonlyArray<{
+        name: string;
+        traits?: ReadonlyArray<string | {
+            ref?: string;
+            name?: string;
+        }>;
+        pages?: ReadonlyArray<string | {
+            path?: string;
+        }>;
+    }>;
+}
+export interface ResolvedPageTraits {
+    /** Page route path, matched against the source orbital's page paths. */
+    path?: string;
+    /** Resolved trait names mounted on the page (includes pulled siblings). */
+    traitNames: readonly string[];
+}
+export declare function buildOrbitalsByTrait(schema: OrbitalsByTraitSchema | undefined, resolvedPages?: ReadonlyArray<ResolvedPageTraits>): Record<string, string>;

package/package.json

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