@omerdlw/base-framework 2.0.0 → 3.0.0

package/dist/{chunk-KKQT46TP.js → chunk-M57SNWXK.js}

@@ -1,17 +1,19 @@
+import { navigationModule } from './chunk-RIOKLMYM.js';
 import { modalModule } from './chunk-FIMPHODX.js';
-import { ambientModule } from './chunk-QXR55VVS.js';
+import { ambientModule } from './chunk-TG6NMHXI.js';
 import { backgroundModule } from './chunk-CGHZSSFR.js';
-import { contextMenuModule } from './chunk-65ZB4QTQ.js';
-import { dockModule } from './chunk-3MSK4XGK.js';
+import { contextMenuModule } from './chunk-CYU6SGAL.js';
+import { dockModule } from './chunk-JIXBFFRD.js';
 import { notificationModule } from './chunk-SYAVGTOX.js';
 import { mediaModule } from './chunk-R2YGFJDJ.js';
 import { controlsModule } from './chunk-4GMQKD6F.js';
-import { loadingModule } from './chunk-XASQT4CQ.js';
+import { loadingModule } from './chunk-66EYJBIP.js';
 
 // src/modules/index.ts
 var defaultModules = Object.freeze([
   backgroundModule,
   ambientModule,
+  navigationModule,
   dockModule,
   controlsModule,
   contextMenuModule,
@@ -22,5 +24,5 @@ var defaultModules = Object.freeze([
 ]);
 
 export { defaultModules };
-//# sourceMappingURL=chunk-KKQT46TP.js.map
-//# sourceMappingURL=chunk-KKQT46TP.js.map
+//# sourceMappingURL=chunk-M57SNWXK.js.map
+//# sourceMappingURL=chunk-M57SNWXK.js.map

package/dist/chunk-M57SNWXK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAwBO,IAAM,cAAA,GAAiB,OAAO,MAAA,CAAO;AAAA,EAC1C,gBAAA;AAAA,EACA,aAAA;AAAA,EACA,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA,iBAAA;AAAA,EACA,aAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAU","file":"chunk-M57SNWXK.js","sourcesContent":["import { ambientModule } from \"./ambient/module\";\nimport { backgroundModule } from \"./background/module\";\nimport { contextMenuModule } from \"./context-menu/module\";\nimport { controlsModule } from \"./controls/module\";\nimport { dockModule } from \"./dock/module\";\nimport { loadingModule } from \"./loading/module\";\nimport { mediaModule } from \"./media/module\";\nimport { modalModule } from \"./modal/module\";\nimport { navigationModule } from \"./navigation/module\";\nimport { notificationModule } from \"./notification/module\";\n\nexport {\n  ambientModule,\n  backgroundModule,\n  contextMenuModule,\n  controlsModule,\n  dockModule,\n  loadingModule,\n  mediaModule,\n  modalModule,\n  navigationModule,\n  notificationModule,\n};\n\nexport const defaultModules = Object.freeze([\n  backgroundModule,\n  ambientModule,\n  navigationModule,\n  dockModule,\n  controlsModule,\n  contextMenuModule,\n  loadingModule,\n  mediaModule,\n  modalModule,\n  notificationModule,\n] as const);\n"]}

package/dist/chunk-RIOKLMYM.js

@@ -0,0 +1,145 @@
+import { createNavigationState, createNavigator, readWindowLocation, NAVIGATION_SOURCE, NAVIGATION_PHASE, isSameLocation, NAVIGATION_REASON, isSamePathname, internalLinkOf, NAVIGATION_PREFETCH_ATTRIBUTE, getNavigationSettings } from './chunk-HLL5EHXC.js';
+import { getOrCreateGlobalContext, defineModule } from './chunk-GF7TUX5I.js';
+import { createStore, useIsomorphicLayoutEffect } from './chunk-TV3WEF5G.js';
+import { useState, useEffect, useMemo } from 'react';
+import { useRouter, usePathname } from 'next/navigation';
+import { jsx } from 'react/jsx-runtime';
+
+// src/modules/navigation/listeners.ts
+function watchIntent(navigator, settings, doc = document) {
+  let resting = null;
+  const stop = () => {
+    if (resting) clearTimeout(resting.timer);
+    resting = null;
+  };
+  const wanted = (target) => {
+    const { intent } = settings();
+    if (!intent) return null;
+    const link = internalLinkOf(target);
+    if (!link || link.getAttribute(NAVIGATION_PREFETCH_ATTRIBUTE) === "false")
+      return null;
+    const href = link.getAttribute("href");
+    return intent.match(href) ? href : null;
+  };
+  const onOver = (event) => {
+    const { pointerType } = event;
+    if (pointerType && pointerType !== "mouse") return;
+    const href = wanted(event.target);
+    if (!href) return stop();
+    if (resting?.href === href) return;
+    stop();
+    const { intent } = settings();
+    const delay = intent ? Math.max(0, intent.delayMs) : 0;
+    resting = {
+      href,
+      timer: setTimeout(() => {
+        resting = null;
+        navigator.prefetch(href);
+      }, delay)
+    };
+  };
+  const onNow = (event) => {
+    const href = wanted(event.target);
+    if (href) navigator.prefetch(href);
+  };
+  doc.addEventListener("pointerover", onOver, { passive: true });
+  doc.addEventListener("pointerdown", onNow, { passive: true });
+  doc.addEventListener("focusin", onNow, { passive: true });
+  return () => {
+    stop();
+    doc.removeEventListener("pointerover", onOver);
+    doc.removeEventListener("pointerdown", onNow);
+    doc.removeEventListener("focusin", onNow);
+  };
+}
+function watchHistory(navigator, win = window) {
+  let replaying = false;
+  const onPopState = (event) => {
+    if (replaying) return;
+    const to = readWindowLocation();
+    if (!to) return;
+    const { active, location } = navigator.store.getSnapshot();
+    if (active?.source === NAVIGATION_SOURCE.HISTORY && active.phase === NAVIGATION_PHASE.LEAVING) {
+      if (isSameLocation(to, active.from)) {
+        navigator.cancel(NAVIGATION_REASON.RETURNED);
+        return;
+      }
+    } else if (isSamePathname(to, location)) {
+      return;
+    }
+    if (!navigator.holdsHistory()) {
+      navigator.depart(to);
+      return;
+    }
+    event.stopImmediatePropagation();
+    const { state } = event;
+    navigator.depart(to, {
+      replay: () => {
+        replaying = true;
+        try {
+          win.dispatchEvent(new PopStateEvent("popstate", { state }));
+        } finally {
+          replaying = false;
+        }
+      }
+    });
+  };
+  win.addEventListener("popstate", onPopState, { capture: true });
+  return () => win.removeEventListener("popstate", onPopState, { capture: true });
+}
+var NavigationContext = getOrCreateGlobalContext(
+  "NavigationContext",
+  null
+);
+var noop = () => {
+};
+var NOT_HANDLED = Object.freeze({ ok: false, trip: null });
+var INERT_NAVIGATION_ACTIONS = Object.freeze({
+  arrival: () => null,
+  arrive: noop,
+  cancel: () => false,
+  depart: () => null,
+  hold: () => noop,
+  holdsHistory: () => false,
+  navigate: async () => NOT_HANDLED,
+  onIntent: () => noop,
+  prefetch: () => false,
+  provide: () => noop,
+  setRouter: noop
+});
+var NOOP_NAVIGATION_STORE = createStore(
+  createNavigationState()
+);
+function NavigationProvider({ children }) {
+  const router = useRouter();
+  const pathname = usePathname();
+  const [navigator] = useState(() => createNavigator({ router }));
+  useIsomorphicLayoutEffect(() => {
+    navigator.setRouter(router);
+  }, [navigator, router]);
+  useEffect(() => {
+    navigator.arrive(readWindowLocation() ?? pathname);
+  }, [navigator, pathname]);
+  useEffect(() => watchHistory(navigator), [navigator]);
+  useEffect(
+    () => watchIntent(navigator, getNavigationSettings),
+    [navigator]
+  );
+  useEffect(() => () => navigator.dispose(), [navigator]);
+  const runtime = useMemo(
+    () => ({ actions: navigator, store: navigator.store }),
+    [navigator]
+  );
+  return /* @__PURE__ */ jsx(NavigationContext, { value: runtime, children });
+}
+
+// src/modules/navigation/module.tsx
+var navigationModule = defineModule({
+  id: "navigation",
+  context: NavigationContext,
+  Provider: NavigationProvider
+});
+
+export { INERT_NAVIGATION_ACTIONS, NOOP_NAVIGATION_STORE, NavigationContext, NavigationProvider, navigationModule, watchHistory, watchIntent };
+//# sourceMappingURL=chunk-RIOKLMYM.js.map
+//# sourceMappingURL=chunk-RIOKLMYM.js.map

package/dist/chunk-RIOKLMYM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/navigation/listeners.ts","../src/modules/navigation/context.tsx","../src/modules/navigation/module.tsx"],"names":[],"mappings":";;;;;;;;AAaO,SAAS,WAAA,CACd,SAAA,EACA,QAAA,EACA,GAAA,GAAgB,QAAA,EACJ;AACZ,EAAA,IAAI,OAAA,GACF,IAAA;AAEF,EAAA,MAAM,OAAO,MAAM;AACjB,IAAA,IAAI,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,KAAK,CAAA;AACvC,IAAA,OAAA,GAAU,IAAA;AAAA,EACZ,CAAA;AAEA,EAAA,MAAM,MAAA,GAAS,CAAC,MAAA,KAA8C;AAC5D,IAAA,MAAM,EAAE,MAAA,EAAO,GAAI,QAAA,EAAS;AAC5B,IAAA,IAAI,CAAC,QAAQ,OAAO,IAAA;AACpB,IAAA,MAAM,IAAA,GAAO,eAAe,MAAM,CAAA;AAClC,IAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,YAAA,CAAa,6BAA6B,CAAA,KAAM,OAAA;AAChE,MAAA,OAAO,IAAA;AACT,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,YAAA,CAAa,MAAM,CAAA;AACrC,IAAA,OAAO,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,GAAI,IAAA,GAAO,IAAA;AAAA,EACrC,CAAA;AAEA,EAAA,MAAM,MAAA,GAAS,CAAC,KAAA,KAAiB;AAC/B,IAAA,MAAM,EAAE,aAAY,GAAI,KAAA;AACxB,IAAA,IAAI,WAAA,IAAe,gBAAgB,OAAA,EAAS;AAC5C,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,MAAM,CAAA;AAChC,IAAA,IAAI,CAAC,IAAA,EAAM,OAAO,IAAA,EAAK;AACvB,IAAA,IAAI,OAAA,EAAS,SAAS,IAAA,EAAM;AAC5B,IAAA,IAAA,EAAK;AACL,IAAA,MAAM,EAAE,MAAA,EAAO,GAAI,QAAA,EAAS;AAC5B,IAAA,MAAM,QAAQ,MAAA,GAAS,IAAA,CAAK,IAAI,CAAA,EAAG,MAAA,CAAO,OAAO,CAAA,GAAI,CAAA;AACrD,IAAA,OAAA,GAAU;AAAA,MACR,IAAA;AAAA,MACA,KAAA,EAAO,WAAW,MAAM;AACtB,QAAA,OAAA,GAAU,IAAA;AACV,QAAA,SAAA,CAAU,SAAS,IAAI,CAAA;AAAA,MACzB,GAAG,KAAK;AAAA,KACV;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,KAAA,GAAQ,CAAC,KAAA,KAAiB;AAC9B,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,MAAM,CAAA;AAChC,IAAA,IAAI,IAAA,EAAM,SAAA,CAAU,QAAA,CAAS,IAAI,CAAA;AAAA,EACnC,CAAA;AAEA,EAAA,GAAA,CAAI,iBAAiB,aAAA,EAAe,MAAA,EAAQ,EAAE,OAAA,EAAS,MAAM,CAAA;AAC7D,EAAA,GAAA,CAAI,iBAAiB,aAAA,EAAe,KAAA,EAAO,EAAE,OAAA,EAAS,MAAM,CAAA;AAC5D,EAAA,GAAA,CAAI,iBAAiB,SAAA,EAAW,KAAA,EAAO,EAAE,OAAA,EAAS,MAAM,CAAA;AACxD,EAAA,OAAO,MAAM;AACX,IAAA,IAAA,EAAK;AACL,IAAA,GAAA,CAAI,mBAAA,CAAoB,eAAe,MAAM,CAAA;AAC7C,IAAA,GAAA,CAAI,mBAAA,CAAoB,eAAe,KAAK,CAAA;AAC5C,IAAA,GAAA,CAAI,mBAAA,CAAoB,WAAW,KAAK,CAAA;AAAA,EAC1C,CAAA;AACF;AASO,SAAS,YAAA,CACd,SAAA,EACA,GAAA,GAAc,MAAA,EACF;AACZ,EAAA,IAAI,SAAA,GAAY,KAAA;AAEhB,EAAA,MAAM,UAAA,GAAa,CAAC,KAAA,KAAyB;AAC3C,IAAA,IAAI,SAAA,EAAW;AACf,IAAA,MAAM,KAAK,kBAAA,EAAmB;AAC9B,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAS,GAAI,SAAA,CAAU,MAAM,WAAA,EAAY;AAEzD,IAAA,IACE,QAAQ,MAAA,KAAW,iBAAA,CAAkB,WACrC,MAAA,CAAO,KAAA,KAAU,iBAAiB,OAAA,EAClC;AACA,MAAA,IAAI,cAAA,CAAe,EAAA,EAAI,MAAA,CAAO,IAAI,CAAA,EAAG;AAEnC,QAAA,SAAA,CAAU,MAAA,CAAO,kBAAkB,QAAQ,CAAA;AAC3C,QAAA;AAAA,MACF;AAAA,IACF,CAAA,MAAA,IAAW,cAAA,CAAe,EAAA,EAAI,QAAQ,CAAA,EAAG;AACvC,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,SAAA,CAAU,YAAA,EAAa,EAAG;AAC7B,MAAA,SAAA,CAAU,OAAO,EAAE,CAAA;AACnB,MAAA;AAAA,IACF;AAEA,IAAA,KAAA,CAAM,wBAAA,EAAyB;AAC/B,IAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,IAAA,SAAA,CAAU,OAAO,EAAA,EAAI;AAAA,MACnB,QAAQ,MAAM;AACZ,QAAA,SAAA,GAAY,IAAA;AACZ,QAAA,IAAI;AACF,UAAA,GAAA,CAAI,cAAc,IAAI,aAAA,CAAc,YAAY,EAAE,KAAA,EAAO,CAAC,CAAA;AAAA,QAC5D,CAAA,SAAE;AACA,UAAA,SAAA,GAAY,KAAA;AAAA,QACd;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,GAAA,CAAI,iBAAiB,UAAA,EAAY,UAAA,EAAY,EAAE,OAAA,EAAS,MAAM,CAAA;AAC9D,EAAA,OAAO,MAAM,IAAI,mBAAA,CAAoB,UAAA,EAAY,YAAY,EAAE,OAAA,EAAS,MAAM,CAAA;AAChF;ACvGO,IAAM,iBAAA,GACX,wBAAA;AAAA,EACE,mBAAA;AAAA,EACA;AACF;AAEF,IAAM,OAAO,MAAM;AAAC,CAAA;AACpB,IAAM,WAAA,GAAgC,OAAO,MAAA,CAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,MAAM,CAAA;AAGtE,IAAM,wBAAA,GAA8C,OAAO,MAAA,CAAO;AAAA,EACvE,SAAS,MAAM,IAAA;AAAA,EACf,MAAA,EAAQ,IAAA;AAAA,EACR,QAAQ,MAAM,KAAA;AAAA,EACd,QAAQ,MAAM,IAAA;AAAA,EACd,MAAM,MAAM,IAAA;AAAA,EACZ,cAAc,MAAM,KAAA;AAAA,EACpB,UAAU,YAAY,WAAA;AAAA,EACtB,UAAU,MAAM,IAAA;AAAA,EAChB,UAAU,MAAM,KAAA;AAAA,EAChB,SAAS,MAAM,IAAA;AAAA,EACf,SAAA,EAAW;AACb,CAAC;AAEM,IAAM,qBAAA,GAAwB,WAAA;AAAA,EACnC,qBAAA;AACF;AAEO,SAAS,kBAAA,CAAmB,EAAE,QAAA,EAAS,EAA6B;AACzE,EAAA,MAAM,SAA2B,SAAA,EAAU;AAC3C,EAAA,MAAM,WAAW,WAAA,EAAY;AAC7B,EAAA,MAAM,CAAC,SAAS,CAAA,GAAI,QAAA,CAAS,MAAM,eAAA,CAAgB,EAAE,MAAA,EAAQ,CAAC,CAAA;AAE9D,EAAA,yBAAA,CAA0B,MAAM;AAC9B,IAAA,SAAA,CAAU,UAAU,MAAM,CAAA;AAAA,EAC5B,CAAA,EAAG,CAAC,SAAA,EAAW,MAAM,CAAC,CAAA;AAEtB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,SAAA,CAAU,MAAA,CAAO,kBAAA,EAAmB,IAAK,QAAQ,CAAA;AAAA,EACnD,CAAA,EAAG,CAAC,SAAA,EAAW,QAAQ,CAAC,CAAA;AAExB,EAAA,SAAA,CAAU,MAAM,YAAA,CAAa,SAAS,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AACpD,EAAA,SAAA;AAAA,IACE,MAAM,WAAA,CAAY,SAAA,EAAW,qBAAqB,CAAA;AAAA,IAClD,CAAC,SAAS;AAAA,GACZ;AACA,EAAA,SAAA,CAAU,MAAM,MAAM,SAAA,CAAU,SAAQ,EAAG,CAAC,SAAS,CAAC,CAAA;AAEtD,EAAA,MAAM,OAAA,GAAU,OAAA;AAAA,IACd,OAAO,EAAE,OAAA,EAAS,SAAA,EAAW,KAAA,EAAO,UAAU,KAAA,EAAM,CAAA;AAAA,IACpD,CAAC,SAAS;AAAA,GACZ;AAEA,EAAA,uBAAO,GAAA,CAAC,iBAAA,EAAA,EAAkB,KAAA,EAAO,OAAA,EAAU,QAAA,EAAS,CAAA;AACtD;;;ACpEO,IAAM,mBAAmB,YAAA,CAAa;AAAA,EAC3C,EAAA,EAAI,YAAA;AAAA,EACJ,OAAA,EAAS,iBAAA;AAAA,EACT,QAAA,EAAU;AACZ,CAAC","file":"chunk-RIOKLMYM.js","sourcesContent":["import { NAVIGATION_PHASE, NAVIGATION_PREFETCH_ATTRIBUTE, NAVIGATION_REASON, NAVIGATION_SOURCE } from \"./constants\";\nimport type { NavigationSettings, Navigator } from \"./types\";\nimport {\n  internalLinkOf,\n  isSameLocation,\n  isSamePathname,\n  readWindowLocation,\n} from \"./utils\";\n\n/**\n * Prefetches internal links on intent: after `intent.delayMs` of mouse hover,\n * and at once on pointerdown or focus. Returns the cleanup.\n */\nexport function watchIntent(\n  navigator: Pick<Navigator, \"prefetch\">,\n  settings: () => NavigationSettings,\n  doc: Document = document,\n): () => void {\n  let resting: { href: string; timer: ReturnType<typeof setTimeout> } | null =\n    null;\n\n  const stop = () => {\n    if (resting) clearTimeout(resting.timer);\n    resting = null;\n  };\n\n  const wanted = (target: EventTarget | null): string | null => {\n    const { intent } = settings();\n    if (!intent) return null;\n    const link = internalLinkOf(target);\n    if (!link || link.getAttribute(NAVIGATION_PREFETCH_ATTRIBUTE) === \"false\")\n      return null;\n    const href = link.getAttribute(\"href\")!;\n    return intent.match(href) ? href : null;\n  };\n\n  const onOver = (event: Event) => {\n    const { pointerType } = event as PointerEvent;\n    if (pointerType && pointerType !== \"mouse\") return;\n    const href = wanted(event.target);\n    if (!href) return stop();\n    if (resting?.href === href) return;\n    stop();\n    const { intent } = settings();\n    const delay = intent ? Math.max(0, intent.delayMs) : 0;\n    resting = {\n      href,\n      timer: setTimeout(() => {\n        resting = null;\n        navigator.prefetch(href);\n      }, delay),\n    };\n  };\n\n  const onNow = (event: Event) => {\n    const href = wanted(event.target);\n    if (href) navigator.prefetch(href);\n  };\n\n  doc.addEventListener(\"pointerover\", onOver, { passive: true });\n  doc.addEventListener(\"pointerdown\", onNow, { passive: true });\n  doc.addEventListener(\"focusin\", onNow, { passive: true });\n  return () => {\n    stop();\n    doc.removeEventListener(\"pointerover\", onOver);\n    doc.removeEventListener(\"pointerdown\", onNow);\n    doc.removeEventListener(\"focusin\", onNow);\n  };\n}\n\n/**\n * Turns back/forward steps into trips. While a hold wants history steps, the\n * step is swallowed before the router sees it (a capture listener on\n * `window` runs first), the holds run, and the same `popstate` is replayed\n * for the router. Stepping back to the origin during the hold cancels the\n * trip. Returns the cleanup.\n */\nexport function watchHistory(\n  navigator: Pick<Navigator, \"cancel\" | \"depart\" | \"holdsHistory\" | \"store\">,\n  win: Window = window,\n): () => void {\n  let replaying = false;\n\n  const onPopState = (event: PopStateEvent) => {\n    if (replaying) return;\n    const to = readWindowLocation();\n    if (!to) return;\n    const { active, location } = navigator.store.getSnapshot();\n\n    if (\n      active?.source === NAVIGATION_SOURCE.HISTORY &&\n      active.phase === NAVIGATION_PHASE.LEAVING\n    ) {\n      if (isSameLocation(to, active.from)) {\n        // Back where the router still is: let it see the step, nothing moves.\n        navigator.cancel(NAVIGATION_REASON.RETURNED);\n        return;\n      }\n    } else if (isSamePathname(to, location)) {\n      return;\n    }\n\n    if (!navigator.holdsHistory()) {\n      navigator.depart(to);\n      return;\n    }\n\n    event.stopImmediatePropagation();\n    const { state } = event;\n    navigator.depart(to, {\n      replay: () => {\n        replaying = true;\n        try {\n          win.dispatchEvent(new PopStateEvent(\"popstate\", { state }));\n        } finally {\n          replaying = false;\n        }\n      },\n    });\n  };\n\n  win.addEventListener(\"popstate\", onPopState, { capture: true });\n  return () => win.removeEventListener(\"popstate\", onPopState, { capture: true });\n}\n","\"use client\";\n\nimport { useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { usePathname, useRouter } from \"next/navigation\";\nimport { useIsomorphicLayoutEffect } from \"@/hooks\";\nimport { getOrCreateGlobalContext } from \"@/kernel\";\nimport { createStore } from \"@/utils\";\nimport { watchHistory, watchIntent } from \"./listeners\";\nimport { createNavigator } from \"./navigator\";\nimport { getNavigationSettings } from \"./settings\";\nimport { createNavigationState } from \"./state\";\nimport type {\n  NavigationActions,\n  NavigationResult,\n  NavigationRouter,\n  NavigationRuntime,\n  NavigationState,\n} from \"./types\";\nimport { readWindowLocation } from \"./utils\";\n\nexport const NavigationContext =\n  getOrCreateGlobalContext<NavigationRuntime | null>(\n    \"NavigationContext\",\n    null,\n  );\n\nconst noop = () => {};\nconst NOT_HANDLED: NavigationResult = Object.freeze({ ok: false, trip: null });\n\n/** What readers get without the module: no trips, nothing held or warmed. */\nexport const INERT_NAVIGATION_ACTIONS: NavigationActions = Object.freeze({\n  arrival: () => null,\n  arrive: noop,\n  cancel: () => false,\n  depart: () => null,\n  hold: () => noop,\n  holdsHistory: () => false,\n  navigate: async () => NOT_HANDLED,\n  onIntent: () => noop,\n  prefetch: () => false,\n  provide: () => noop,\n  setRouter: noop,\n});\n\nexport const NOOP_NAVIGATION_STORE = createStore<NavigationState>(\n  createNavigationState(),\n);\n\nexport function NavigationProvider({ children }: { children?: ReactNode }) {\n  const router: NavigationRouter = useRouter();\n  const pathname = usePathname();\n  const [navigator] = useState(() => createNavigator({ router }));\n\n  useIsomorphicLayoutEffect(() => {\n    navigator.setRouter(router);\n  }, [navigator, router]);\n\n  useEffect(() => {\n    navigator.arrive(readWindowLocation() ?? pathname);\n  }, [navigator, pathname]);\n\n  useEffect(() => watchHistory(navigator), [navigator]);\n  useEffect(\n    () => watchIntent(navigator, getNavigationSettings),\n    [navigator],\n  );\n  useEffect(() => () => navigator.dispose(), [navigator]);\n\n  const runtime = useMemo<NavigationRuntime>(\n    () => ({ actions: navigator, store: navigator.store }),\n    [navigator],\n  );\n\n  return <NavigationContext value={runtime}>{children}</NavigationContext>;\n}\n","\"use client\";\n\nimport { defineModule } from \"@/kernel\";\nimport { NavigationContext, NavigationProvider } from \"./context\";\nimport type { NavigationTrip } from \"./types\";\n\nexport const navigationModule = defineModule({\n  id: \"navigation\",\n  context: NavigationContext,\n  Provider: NavigationProvider,\n});\n\ninterface NavigationEventPayload {\n  from: string;\n  source: string;\n  timestamp: number;\n  to: string;\n  trip: NavigationTrip;\n  type: string;\n  [key: string]: unknown;\n}\n\ndeclare module \"@omerdlw/base-framework/events\" {\n  interface FrameworkEventMap {\n    NAVIGATION_START: NavigationEventPayload;\n    NAVIGATION_COMMIT: NavigationEventPayload;\n    NAVIGATION_END: NavigationEventPayload;\n  }\n}\n\ndeclare module \"@omerdlw/base-framework/kernel\" {\n  interface CoreModules {\n    navigation: typeof navigationModule;\n  }\n}\n"]}