@almadar/ui 4.23.0 → 4.24.0

package/dist/avl/index.cjs

@@ -52773,6 +52773,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -52848,6 +52849,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = React127.useRef("");
+  React127.useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = React127.useRef(false);
   React127.useEffect(() => {
     if (!orbitalNames?.length) {
@@ -52862,6 +52876,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  React127.useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   React127.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -53102,8 +53120,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = React127.useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -53115,18 +53144,30 @@ function OrbPreview({
   const containerRef = React127.useRef(null);
   React127.useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxRuntime.jsxs(

package/dist/avl/index.js

@@ -52727,6 +52727,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -52802,6 +52803,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = useRef("");
+  useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = useRef(false);
   useEffect(() => {
     if (!orbitalNames?.length) {
@@ -52816,6 +52830,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -53056,8 +53074,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -53069,18 +53098,30 @@ function OrbPreview({
   const containerRef = useRef(null);
   useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxs(

package/dist/runtime/index.cjs

@@ -39531,6 +39531,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -39606,6 +39607,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = React113.useRef("");
+  React113.useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = React113.useRef(false);
   React113.useEffect(() => {
     if (!orbitalNames?.length) {
@@ -39620,6 +39634,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  React113.useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   React113.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -39860,8 +39878,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = React113.useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -39873,18 +39902,30 @@ function OrbPreview({
   const containerRef = React113.useRef(null);
   React113.useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxRuntime.jsxs(

package/dist/runtime/index.js

@@ -39486,6 +39486,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -39561,6 +39562,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = useRef("");
+  useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = useRef(false);
   useEffect(() => {
     if (!orbitalNames?.length) {
@@ -39575,6 +39589,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -39815,8 +39833,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -39828,18 +39857,30 @@ function OrbPreview({
   const containerRef = useRef(null);
   useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxs(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.23.0",
+  "version": "4.24.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",