@brendanbank/atrium-host-bundle-utils 0.15.2 → 0.16.0

package/README.md

@@ -97,8 +97,8 @@ or hosts that want axios-shaped retry).
 
 ## Versioning
 
-The package version tracks atrium's image version. Pin `^0.15` for
-"compatible with atrium 0.15.x"; bump together with the atrium image
+The package version tracks atrium's image version. Pin `^0.16` for
+"compatible with atrium 0.16.x"; bump together with the atrium image
 to pick up new registry slots and SDK helpers.
 
 ## See also

package/dist/react/index.d.ts

@@ -83,4 +83,119 @@ export declare function usePerm(): (code: string) => boolean;
 /** Convenience: does the signed-in user hold the named role? Returns
  *  `false` while loading and when signed out, mirroring `usePerm`. */
 export declare function useRole(code: string): boolean;
+/** Snapshot of atrium's current router location, mirrored on
+ *  `window.location`. The fields match react-router's `Location` shape
+ *  so a host already familiar with `useLocation()` reads the same
+ *  contract here. */
+export type AtriumLocation = {
+    pathname: string;
+    search: string;
+    hash: string;
+    /** Monotonic per-event counter atrium increments on every
+     *  `atrium:locationchange` dispatch. Use this in effect deps when
+     *  the effect should re-run on every navigation event, including a
+     *  re-click of the same href that react-router would otherwise
+     *  no-op (e.g. clicking the same notification bell item twice — see
+     *  atrium #81). Without it, `useEffect(…, [search])` stays put
+     *  because `search` is structurally identical between the two
+     *  events. Always present from atrium 0.16+; `0` on older images
+     *  that don't dispatch a nonce. */
+    nonce: number;
+};
+/** Subscribe to atrium's react-router location changes from inside a
+ *  host bundle's React tree. Returns `{ pathname, search, hash, nonce }`
+ *  — the first three mirror `window.location`; `nonce` is a monotonic
+ *  counter atrium increments on every dispatch.
+ *
+ *  Bridges the `atrium:locationchange` CustomEvent atrium dispatches
+ *  on `window` through `useSyncExternalStore`, so multiple subscribers
+ *  in the same tree share one event listener and the snapshot is
+ *  referentially stable when nothing changed.
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search } = useAtriumLocation();
+ *    const focus = new URLSearchParams(search).get('focus');
+ *    return focus ? <BookingDetail id={focus} /> : null;
+ *  }
+ *  ```
+ *
+ *  When you want the effect to re-run on **every** navigation event —
+ *  including the same-URL re-click case (clicking the same notification
+ *  bell item twice — atrium #81) — include `nonce` in the deps:
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search, nonce } = useAtriumLocation();
+ *    useEffect(() => {
+ *      const focus = new URLSearchParams(search).get('focus');
+ *      if (focus) openDrawer(focus);
+ *      // Without `nonce` here, React dedupes on `[search]` so a second
+ *      // click of the same href doesn't re-open the drawer.
+ *    }, [search, nonce]);
+ *  }
+ *  ```
+ *
+ *  Hosts that don't use React (or want to handle navigation outside a
+ *  component) can subscribe directly:
+ *  `window.addEventListener('atrium:locationchange', e => …)`. The
+ *  event's `detail` carries the same `{pathname, search, hash, nonce}`
+ *  shape.
+ *
+ *  Available on atrium 0.15.3+; `nonce` lands in 0.16+. On older atrium
+ *  images the hook still works but only reflects the initial
+ *  `window.location` (and `nonce` stays at 0). Hosts that need to
+ *  support pre-0.15.3 atrium can read `window.__ATRIUM_VERSION__` and
+ *  fall back to `useLocation()` from a wrapper that remounts on route
+ *  swaps. */
+export declare function useAtriumLocation(): AtriumLocation;
+/** Programmatic navigate that works from inside a host bundle's React
+ *  tree, where `useNavigate()` from react-router isn't available
+ *  (atrium owns the router context; the host tree only meets atrium's
+ *  at the wrapper element produced by `makeWrapperElement`).
+ *
+ *  Returns a stable `navigate(href, opts?)` function that updates the
+ *  URL via `pushState` / `replaceState` and re-syncs atrium's
+ *  react-router by dispatching a synthesized `popstate`. Atrium then
+ *  fires its own `atrium:locationchange` so other host listeners
+ *  observe the change.
+ *
+ *  The primary use case is **cleaning up a deep-link query param after
+ *  the host has consumed it** — a flow that previously had no host-
+ *  observable solution (a raw `history.replaceState` desyncs atrium's
+ *  router from the browser URL). See atrium #81.
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search } = useAtriumLocation();
+ *    const navigate = useAtriumNavigate();
+ *    const focus = new URLSearchParams(search).get('focus');
+ *    return focus ? (
+ *      <Drawer
+ *        opened
+ *        onClose={() => {
+ *          // Strip the param so a second click of the same bell item
+ *          // (which navigates to the same href) is a real change from
+ *          // atrium's perspective and re-fires the locationchange.
+ *          const next = new URLSearchParams(search);
+ *          next.delete('focus');
+ *          navigate(`/?${next.toString()}`, { replace: true });
+ *        }}
+ *      >
+ *        <BookingDetail id={focus} />
+ *      </Drawer>
+ *    ) : null;
+ *  }
+ *  ```
+ *
+ *  Available since atrium 0.16. The hook works on older images too —
+ *  it doesn't depend on any atrium-side surface — but on pre-0.16 the
+ *  resulting `atrium:locationchange` event won't carry a `nonce`. */
+export declare function useAtriumNavigate(): (href: string, opts?: {
+    replace?: boolean;
+}) => void;
+/** Test-only: drop the cached snapshot so the next `getSnapshot` reads
+ *  `window.location` fresh. Production code never calls this — the
+ *  cache is updated by the event subscription. */
+export declare function __resetAtriumLocationCacheForTests(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,UAAU,kBAAkB;IAC1B,gBAAgB,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACrD;AAmBD,MAAM,WAAW,mBAAmB;IAClC;;;kDAG8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;sBAGkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;qCAGqC;AACrC,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,gBAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2MAYrB;AAED;;iEAEiE;AACjE,eAAO,MAAM,YAAY,2BAA4B,CAAC;AAmBtD;;;;;;;;8BAQ8B;AAC9B,wBAAgB,KAAK,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAQ1D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAEnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAMnD;AAED;sEACsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,UAAU,kBAAkB;IAC1B,gBAAgB,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACrD;AAmBD,MAAM,WAAW,mBAAmB;IAClC;;;kDAG8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;sBAGkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;qCAGqC;AACrC,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,gBAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2MAYrB;AAED;;iEAEiE;AACjE,eAAO,MAAM,YAAY,2BAA4B,CAAC;AAmBtD;;;;;;;;8BAQ8B;AAC9B,wBAAgB,KAAK,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAQ1D;AAED;;iBAEiB;AACjB,wBAAgB,cAAc,IAAI,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,CAEnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAMnD;AAED;sEACsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;qBAGqB;AACrB,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;uCAQmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAoEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA6Ca;AACb,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAyCqE;AACrE,wBAAgB,iBAAiB,IAAI,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,KACzB,IAAI,CAeR;AAED;;kDAEkD;AAClD,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/react/index.js

@@ -21,7 +21,7 @@
  * intended state — atrium clears its cache on logout via `qc.clear()`,
  * and a shared client would lose host queries the user still wants.
  */
-import { createContext, createElement, useCallback, useContext, useMemo, } from 'react';
+import { createContext, createElement, useCallback, useContext, useMemo, useSyncExternalStore, } from 'react';
 import { QueryClientProvider, useQuery, } from '@tanstack/react-query';
 export { __atrium_t__ } from '../i18n';
 const ME_CONTEXT_PATH = '/users/me/context';
@@ -120,4 +120,180 @@ export function useRole(code) {
     const { data: me } = useMe();
     return (me?.roles ?? []).includes(code);
 }
+const ATRIUM_LOCATION_EVENT = 'atrium:locationchange';
+const SSR_LOCATION = {
+    pathname: '/',
+    search: '',
+    hash: '',
+    nonce: 0,
+};
+// Module-level cache so `useSyncExternalStore.getSnapshot` returns a
+// referentially-stable object across renders — re-creating it every
+// call would cause React to tear-loop the subscriber. The cache is
+// refreshed only when an `atrium:locationchange` event lands or, on
+// the first read, lazily from `window.location`.
+let cachedLocation = null;
+function readWindowLocation() {
+    if (typeof window === 'undefined')
+        return SSR_LOCATION;
+    return {
+        pathname: window.location.pathname,
+        search: window.location.search,
+        hash: window.location.hash,
+        // No event has been observed yet, so we have no atrium-supplied
+        // nonce. Zero is the documented "no nonce yet" value.
+        nonce: 0,
+    };
+}
+function getLocationSnapshot() {
+    if (cachedLocation === null)
+        cachedLocation = readWindowLocation();
+    return cachedLocation;
+}
+function getServerLocationSnapshot() {
+    return SSR_LOCATION;
+}
+function subscribeLocation(onChange) {
+    if (typeof window === 'undefined')
+        return () => { };
+    const handler = (e) => {
+        const detail = e
+            .detail;
+        if (detail &&
+            typeof detail.pathname === 'string' &&
+            typeof detail.search === 'string' &&
+            typeof detail.hash === 'string') {
+            cachedLocation = {
+                pathname: detail.pathname,
+                search: detail.search,
+                hash: detail.hash,
+                // ``nonce`` was added to the event detail in atrium 0.16
+                // (#81). Older images dispatch the event without it; default
+                // to 0 so the field is always a number.
+                nonce: typeof detail.nonce === 'number' ? detail.nonce : 0,
+            };
+        }
+        else {
+            cachedLocation = readWindowLocation();
+        }
+        onChange();
+    };
+    window.addEventListener(ATRIUM_LOCATION_EVENT, handler);
+    return () => window.removeEventListener(ATRIUM_LOCATION_EVENT, handler);
+}
+/** Subscribe to atrium's react-router location changes from inside a
+ *  host bundle's React tree. Returns `{ pathname, search, hash, nonce }`
+ *  — the first three mirror `window.location`; `nonce` is a monotonic
+ *  counter atrium increments on every dispatch.
+ *
+ *  Bridges the `atrium:locationchange` CustomEvent atrium dispatches
+ *  on `window` through `useSyncExternalStore`, so multiple subscribers
+ *  in the same tree share one event listener and the snapshot is
+ *  referentially stable when nothing changed.
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search } = useAtriumLocation();
+ *    const focus = new URLSearchParams(search).get('focus');
+ *    return focus ? <BookingDetail id={focus} /> : null;
+ *  }
+ *  ```
+ *
+ *  When you want the effect to re-run on **every** navigation event —
+ *  including the same-URL re-click case (clicking the same notification
+ *  bell item twice — atrium #81) — include `nonce` in the deps:
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search, nonce } = useAtriumLocation();
+ *    useEffect(() => {
+ *      const focus = new URLSearchParams(search).get('focus');
+ *      if (focus) openDrawer(focus);
+ *      // Without `nonce` here, React dedupes on `[search]` so a second
+ *      // click of the same href doesn't re-open the drawer.
+ *    }, [search, nonce]);
+ *  }
+ *  ```
+ *
+ *  Hosts that don't use React (or want to handle navigation outside a
+ *  component) can subscribe directly:
+ *  `window.addEventListener('atrium:locationchange', e => …)`. The
+ *  event's `detail` carries the same `{pathname, search, hash, nonce}`
+ *  shape.
+ *
+ *  Available on atrium 0.15.3+; `nonce` lands in 0.16+. On older atrium
+ *  images the hook still works but only reflects the initial
+ *  `window.location` (and `nonce` stays at 0). Hosts that need to
+ *  support pre-0.15.3 atrium can read `window.__ATRIUM_VERSION__` and
+ *  fall back to `useLocation()` from a wrapper that remounts on route
+ *  swaps. */
+export function useAtriumLocation() {
+    return useSyncExternalStore(subscribeLocation, getLocationSnapshot, getServerLocationSnapshot);
+}
+/** Programmatic navigate that works from inside a host bundle's React
+ *  tree, where `useNavigate()` from react-router isn't available
+ *  (atrium owns the router context; the host tree only meets atrium's
+ *  at the wrapper element produced by `makeWrapperElement`).
+ *
+ *  Returns a stable `navigate(href, opts?)` function that updates the
+ *  URL via `pushState` / `replaceState` and re-syncs atrium's
+ *  react-router by dispatching a synthesized `popstate`. Atrium then
+ *  fires its own `atrium:locationchange` so other host listeners
+ *  observe the change.
+ *
+ *  The primary use case is **cleaning up a deep-link query param after
+ *  the host has consumed it** — a flow that previously had no host-
+ *  observable solution (a raw `history.replaceState` desyncs atrium's
+ *  router from the browser URL). See atrium #81.
+ *
+ *  ```tsx
+ *  function FocusDrawer() {
+ *    const { search } = useAtriumLocation();
+ *    const navigate = useAtriumNavigate();
+ *    const focus = new URLSearchParams(search).get('focus');
+ *    return focus ? (
+ *      <Drawer
+ *        opened
+ *        onClose={() => {
+ *          // Strip the param so a second click of the same bell item
+ *          // (which navigates to the same href) is a real change from
+ *          // atrium's perspective and re-fires the locationchange.
+ *          const next = new URLSearchParams(search);
+ *          next.delete('focus');
+ *          navigate(`/?${next.toString()}`, { replace: true });
+ *        }}
+ *      >
+ *        <BookingDetail id={focus} />
+ *      </Drawer>
+ *    ) : null;
+ *  }
+ *  ```
+ *
+ *  Available since atrium 0.16. The hook works on older images too —
+ *  it doesn't depend on any atrium-side surface — but on pre-0.16 the
+ *  resulting `atrium:locationchange` event won't carry a `nonce`. */
+export function useAtriumNavigate() {
+    return useCallback((href, opts) => {
+        if (typeof window === 'undefined')
+            return;
+        if (opts?.replace) {
+            window.history.replaceState(window.history.state, '', href);
+        }
+        else {
+            window.history.pushState(window.history.state, '', href);
+        }
+        // React-router's BrowserHistory subscribes to ``popstate`` for
+        // back/forward navigation. Synthesizing one here makes it re-read
+        // ``window.location`` and update its internal state, which in turn
+        // re-renders atrium's NavigationBridge and dispatches a fresh
+        // ``atrium:locationchange`` with a new monotonic nonce.
+        window.dispatchEvent(new PopStateEvent('popstate'));
+    }, []);
+}
+/** Test-only: drop the cached snapshot so the next `getSnapshot` reads
+ *  `window.location` fresh. Production code never calls this — the
+ *  cache is updated by the event subscription. */
+export function __resetAtriumLocationCacheForTests() {
+    cachedLocation = null;
+}
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,wCAAwC;AAExC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,GAER,MAAM,OAAO,CAAC;AACf,OAAO,EACL,mBAAmB,EACnB,QAAQ,GAGT,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C,KAAK,UAAU,uBAAuB;IACpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE;QACvC,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;KACxC,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAC;AAC3C,CAAC;AAED,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAgBrE;;;qCAGqC;AACrC,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,gBAAgB,EAChB,QAAQ,GACY;IACpB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,CAAC,EACzE,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,KAAK,GAAG,aAAa,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEzE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,aAAa,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;iEAEiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;AAEtD,0DAA0D;AAC1D,+DAA+D;AAC/D,mEAAmE;AACnE,WAAW;AACX,IAAI,WAAW,GAA8B,IAAI,CAAC;AAClD,SAAS,UAAU;IACjB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,yBAAyB;IAChC,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACtC,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;8BAQ8B;AAC9B,MAAM,UAAU,KAAK;IACnB,MAAM,EAAE,gBAAgB,EAAE,GAAG,yBAAyB,EAAE,CAAC;IACzD,OAAO,QAAQ,CAAqB;QAClC,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;iBAEiB;AACjB,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,EAAE,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;IAC7B,OAAO,WAAW,CAChB,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACxD,CAAC,EAAE,EAAE,WAAW,CAAC,CAClB,CAAC;AACJ,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brendanbank/atrium-host-bundle-utils",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "description": "Runtime helpers, Vite preset, and React hooks for atrium host bundles. Wraps the dual-tree mount pattern, the host-bundle Vite library config, and the /users/me/context hook so a host's main.tsx is ~10 lines of registration calls.",
   "license": "BSD-2-Clause",
   "type": "module",
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@brendanbank/atrium-host-types": "0.15.2"
+    "@brendanbank/atrium-host-types": "0.16.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",