@real-router/sources 0.2.0 → 0.2.2

package/README.md

@@ -60,7 +60,7 @@ const source = createRouteSource(router);
 
 ### `createRouteNodeSource(router, nodeName)`
 
-Creates a source scoped to a specific route node. Only updates when the node is in the transition path, avoiding unnecessary re-renders for unrelated navigations.\
+Creates a source scoped to a specific route node. Only updates when the node is in the transition path, avoiding unnecessary re-renders for unrelated navigations. Uses a lazy-connection pattern: subscribes to the router on the first listener and unsubscribes when all listeners are removed.\
 `router: Router` — router instance\
 `nodeName: string` — route node name to scope updates to\
 Returns: `RouterSource<RouteNodeSnapshot>`
@@ -69,8 +69,6 @@ Returns: `RouterSource<RouteNodeSnapshot>`
 const source = createRouteNodeSource(router, "users");
 ```
 
-Call `source.destroy()` when the source is no longer needed.
-
 ---
 
 ### `createActiveRouteSource(router, routeName, params?, options?)`
@@ -209,8 +207,8 @@ const unsubscribe = source.subscribe(() => {
   console.log("Users section route:", route?.name);
 });
 
-// Tear down completely when the component unmounts
-source.destroy();
+// Later, clean up (automatically unsubscribes from router)
+unsubscribe();
 ```
 
 ---

package/dist/cjs/index.d.ts

@@ -32,6 +32,13 @@ interface RouterTransitionSnapshot {
  */
 declare function createRouteSource(router: Router): RouterSource<RouteSnapshot>;
 
+/**
+ * Creates a source scoped to a specific route node.
+ *
+ * Uses a lazy-connection pattern: the router subscription is created when the
+ * first listener subscribes and removed when the last listener unsubscribes.
+ * This is compatible with React's useSyncExternalStore and Strict Mode.
+ */
 declare function createRouteNodeSource(router: Router, nodeName: string): RouterSource<RouteNodeSnapshot>;
 
 declare function createActiveRouteSource(router: Router, routeName: string, params?: Params, options?: ActiveRouteSourceOptions): RouterSource<boolean>;

package/dist/cjs/index.js

@@ -1 +1 @@
-var t=require("@real-router/route-utils"),s=require("@real-router/core"),e=class{#t=null;#s;#e=new Set;#r;constructor(t){this.#r=t,this.#s={route:t.getState(),previousRoute:void 0},this.subscribe=this.subscribe.bind(this),this.destroy=this.destroy.bind(this),this.getSnapshot=this.getSnapshot.bind(this)}subscribe(t){return 0===this.#e.size&&(this.#t=this.#r.subscribe(t=>{this.#s={route:t.route,previousRoute:t.previousRoute},this.#e.forEach(t=>{t()})})),this.#e.add(t),()=>{this.#e.delete(t),0===this.#e.size&&this.#t&&(this.#t(),this.#t=null)}}getSnapshot(){return this.#s}destroy(){this.#t&&(this.#t(),this.#t=null),this.#e.clear()}},r=class{#s;#i=!1;#e=new Set;constructor(t){this.#s=t}subscribe(t){return this.#i?()=>{}:(this.#e.add(t),()=>{this.#e.delete(t)})}getSnapshot(){return this.#s}updateSnapshot(t){this.#i||(this.#s=t,this.#e.forEach(t=>{t()}))}destroy(){this.#i||(this.#i=!0,this.#e.clear())}};function i(t,s,e,r){const i=r?.route??s.getState(),o=r?.previousRoute,u=""===e||void 0!==i&&(i.name===e||i.name.startsWith(`${e}.`))?i:void 0;return u===t.route&&o===t.previousRoute?t:{route:u,previousRoute:o}}var o=new WeakMap,u=class{#o;#u;constructor(t,s){const e=i({route:void 0,previousRoute:void 0},t,s);this.#o=new r(e);const u=function(t,s){let e=o.get(t);e||(e=new Map,o.set(t,e));let r=e.get(s);return r||(r=t.shouldUpdateNode(s),e.set(s,r)),r}(t,s);this.#u=t.subscribe(e=>{if(!u(e.route,e.previousRoute))return;const r=i(this.#o.getSnapshot(),t,s,e);Object.is(this.#o.getSnapshot(),r)||this.#o.updateSnapshot(r)}),this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(t){return this.#o.subscribe(t)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#u(),this.#o.destroy()}},n=class{#o;#u;constructor(s,e,i,o){const u=o?.strict??!1,n=o?.ignoreQueryParams??!0,h=s.isActiveRoute(e,i,u,n);this.#o=new r(h),this.#u=s.subscribe(r=>{const o=t.areRoutesRelated(e,r.route.name),h=r.previousRoute&&t.areRoutesRelated(e,r.previousRoute.name);if(!o&&!h)return;const c=!!o&&s.isActiveRoute(e,i,u,n);Object.is(this.#o.getSnapshot(),c)||this.#o.updateSnapshot(c)}),this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(t){return this.#o.subscribe(t)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#u(),this.#o.destroy()}},h={isTransitioning:!1,toRoute:null,fromRoute:null},c=class{#o;#n;constructor(t){this.#o=new r(h);const e=s.getPluginApi(t),i=()=>{this.#o.updateSnapshot(h)};this.#n=[e.addEventListener(s.events.TRANSITION_START,(t,s)=>{this.#o.updateSnapshot({isTransitioning:!0,toRoute:t,fromRoute:s??null})}),e.addEventListener(s.events.TRANSITION_SUCCESS,i),e.addEventListener(s.events.TRANSITION_ERROR,i),e.addEventListener(s.events.TRANSITION_CANCEL,i)],this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(t){return this.#o.subscribe(t)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#n.forEach(t=>{t()}),this.#o.destroy()}};exports.createActiveRouteSource=function(t,s,e,r){return new n(t,s,e,r)},exports.createRouteNodeSource=function(t,s){return new u(t,s)},exports.createRouteSource=function(t){return new e(t)},exports.createTransitionSource=function(t){return new c(t)};//# sourceMappingURL=index.js.map
+var t=require("@real-router/route-utils"),e=require("@real-router/core"),s=class{#t;#e=!1;#s=new Set;#o;#r;#n;constructor(t,e){this.#t=t,this.#o=e?.onFirstSubscribe,this.#r=e?.onLastUnsubscribe,this.#n=e?.onDestroy,this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(t){return this.#e?()=>{}:(0===this.#s.size&&this.#o&&this.#o(),this.#s.add(t),()=>{this.#s.delete(t),!this.#e&&0===this.#s.size&&this.#r&&this.#r()})}getSnapshot(){return this.#t}updateSnapshot(t){this.#e||(this.#t=t,this.#s.forEach(t=>{t()}))}destroy(){this.#e||(this.#e=!0,this.#n?.(),this.#s.clear())}};function o(t,e,s,o){const r=o?.route??e.getState(),n=o?.previousRoute,i=""===s||void 0!==r&&(r.name===s||r.name.startsWith(`${s}.`))?r:void 0;return i===t.route&&n===t.previousRoute?t:{route:i,previousRoute:n}}var r=new WeakMap,n={isTransitioning:!1,toRoute:null,fromRoute:null};exports.createActiveRouteSource=function(e,o,r,n){const i=n?.strict??!1,u=n?.ignoreQueryParams??!0,a=e.isActiveRoute(o,r,i,u),c=new s(a,{onDestroy:()=>{h()}}),h=e.subscribe(s=>{const n=t.areRoutesRelated(o,s.route.name),a=s.previousRoute&&t.areRoutesRelated(o,s.previousRoute.name);if(!n&&!a)return;const h=!!n&&e.isActiveRoute(o,r,i,u);Object.is(c.getSnapshot(),h)||c.updateSnapshot(h)});return c},exports.createRouteNodeSource=function(t,e){let n=null;const i=function(t,e){let s=r.get(t);s||(s=new Map,r.set(t,s));let o=s.get(e);return o||(o=t.shouldUpdateNode(e),s.set(e,o)),o}(t,e),u=()=>{const t=n;n=null,t?.()},a=new s(o({route:void 0,previousRoute:void 0},t,e),{onFirstSubscribe:()=>{a.updateSnapshot(o(a.getSnapshot(),t,e)),n=t.subscribe(s=>{if(!i(s.route,s.previousRoute))return;const r=o(a.getSnapshot(),t,e,s);Object.is(a.getSnapshot(),r)||a.updateSnapshot(r)})},onLastUnsubscribe:u,onDestroy:u});return a},exports.createRouteSource=function(t){let e=null;const o=()=>{const t=e;e=null,t?.()},r=new s({route:t.getState(),previousRoute:void 0},{onFirstSubscribe:()=>{e=t.subscribe(t=>{r.updateSnapshot({route:t.route,previousRoute:t.previousRoute})})},onLastUnsubscribe:o,onDestroy:o});return r},exports.createTransitionSource=function(t){const o=new s(n,{onDestroy:()=>{u.forEach(t=>{t()})}}),r=e.getPluginApi(t),i=()=>{o.updateSnapshot(n)},u=[r.addEventListener(e.events.TRANSITION_START,(t,e)=>{o.updateSnapshot({isTransitioning:!0,toRoute:t,fromRoute:e??null})}),r.addEventListener(e.events.TRANSITION_SUCCESS,i),r.addEventListener(e.events.TRANSITION_ERROR,i),r.addEventListener(e.events.TRANSITION_CANCEL,i)];return o};//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/createRouteSource.ts","../../src/BaseSource.ts","../../src/computeSnapshot.ts","../../src/shouldUpdateCache.ts","../../src/createRouteNodeSource.ts","../../src/createActiveRouteSource.ts","../../src/createTransitionSource.ts"],"names":["areRoutesRelated","getPluginApi","events"],"mappings":";AAGA,IAAM,cAAN,MAAyD;AAAA,EACvD,kBAAA,GAA0C,IAAA;AAAA,EAC1C,gBAAA;AAAA,EAES,UAAA,uBAAiB,GAAA,EAAgB;AAAA,EACjC,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAEf,IAAA,IAAA,CAAK,gBAAA,GAAmB;AAAA,MACtB,KAAA,EAAO,OAAO,QAAA,EAAS;AAAA,MACvB,aAAA,EAAe;AAAA,KACjB;AAEA,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,IAAI,CAAA;AAAA,EAC/C;AAAA,EAEA,UAAU,QAAA,EAAkC;AAC1C,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAA,KAAS,CAAA,EAAG;AAE9B,MAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,CAAC,IAAA,KAAS;AACzD,QAAA,IAAA,CAAK,gBAAA,GAAmB;AAAA,UACtB,OAAO,IAAA,CAAK,KAAA;AAAA,UACZ,eAAe,IAAA,CAAK;AAAA,SACtB;AACA,QAAA,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,CAAC,EAAA,KAAO;AAC9B,UAAA,EAAA,EAAG;AAAA,QACL,CAAC,CAAA;AAAA,MACH,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,IAAA,CAAK,UAAA,CAAW,IAAI,QAAQ,CAAA;AAE5B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,UAAA,CAAW,OAAO,QAAQ,CAAA;AAE/B,MAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAA,KAAS,CAAA,IAAK,KAAK,kBAAA,EAAoB;AACzD,QAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,QAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA;AAAA,MAC5B;AAAA,IACF,CAAA;AAAA,EACF;AAAA,EAEA,WAAA,GAA6B;AAC3B,IAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,EACd;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,kBAAA,EAAoB;AAC3B,MAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,MAAA,IAAA,CAAK,kBAAA,GAAqB,IAAA;AAAA,IAC5B;AAEA,IAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AAAA,EACxB;AACF,CAAA;AASO,SAAS,kBAAkB,MAAA,EAA6C;AAC7E,EAAA,OAAO,IAAI,YAAY,MAAM,CAAA;AAC/B;;;ACxEO,IAAM,aAAN,MAAoB;AAAA,EACzB,gBAAA;AAAA,EACA,UAAA,GAAa,KAAA;AAAA,EAEJ,UAAA,uBAAiB,GAAA,EAAgB;AAAA,EAE1C,YAAY,eAAA,EAAoB;AAC9B,IAAA,IAAA,CAAK,gBAAA,GAAmB,eAAA;AAAA,EAC1B;AAAA,EAEA,UAAU,QAAA,EAAkC;AAC1C,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA,OAAO,MAAM;AAAA,MAAC,CAAA;AAAA,IAChB;AAEA,IAAA,IAAA,CAAK,UAAA,CAAW,IAAI,QAAQ,CAAA;AAE5B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,UAAA,CAAW,OAAO,QAAQ,CAAA;AAAA,IACjC,CAAA;AAAA,EACF;AAAA,EAEA,WAAA,GAAiB;AACf,IAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,EACd;AAAA,EAEA,eAAe,QAAA,EAAmB;AAEhC,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,gBAAA,GAAmB,QAAA;AACxB,IAAA,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,CAAC,QAAA,KAAa;AACpC,MAAA,QAAA,EAAS;AAAA,IACX,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAClB,IAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AAAA,EACxB;AACF,CAAA;;;AC3CO,SAAS,eAAA,CACd,eAAA,EACA,MAAA,EACA,QAAA,EACA,IAAA,EACmB;AACnB,EAAA,MAAM,YAAA,GAAe,IAAA,EAAM,KAAA,IAAS,MAAA,CAAO,QAAA,EAAS;AACpD,EAAA,MAAM,gBAAgB,IAAA,EAAM,aAAA;AAE5B,EAAA,MAAM,YAAA,GACJ,QAAA,KAAa,EAAA,IACZ,YAAA,KAAiB,MAAA,KACf,YAAA,CAAa,IAAA,KAAS,QAAA,IACrB,YAAA,CAAa,IAAA,CAAK,UAAA,CAAW,CAAA,EAAG,QAAQ,CAAA,CAAA,CAAG,CAAA,CAAA;AAEjD,EAAA,MAAM,KAAA,GAAQ,eAAe,YAAA,GAAe,MAAA;AAE5C,EAAA,IACE,KAAA,KAAU,eAAA,CAAgB,KAAA,IAC1B,aAAA,KAAkB,gBAAgB,aAAA,EAClC;AACA,IAAA,OAAO,eAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAE,OAAO,aAAA,EAAc;AAChC;;;AC1BA,IAAM,iBAAA,uBAAwB,OAAA,EAG5B;AAEK,SAAS,qBAAA,CACd,QACA,QAAA,EACgD;AAChD,EAAA,IAAI,WAAA,GAAc,iBAAA,CAAkB,GAAA,CAAI,MAAM,CAAA;AAE9C,EAAA,IAAI,CAAC,WAAA,EAAa;AAChB,IAAA,WAAA,uBAAkB,GAAA,EAAI;AACtB,IAAA,iBAAA,CAAkB,GAAA,CAAI,QAAQ,WAAW,CAAA;AAAA,EAC3C;AAEA,EAAA,IAAI,EAAA,GAAK,WAAA,CAAY,GAAA,CAAI,QAAQ,CAAA;AAEjC,EAAA,IAAI,CAAC,EAAA,EAAI;AACP,IAAA,EAAA,GAAK,MAAA,CAAO,iBAAiB,QAAQ,CAAA;AACrC,IAAA,WAAA,CAAY,GAAA,CAAI,UAAU,EAAE,CAAA;AAAA,EAC9B;AAEA,EAAA,OAAO,EAAA;AACT;;;ACnBA,IAAM,kBAAN,MAAiE;AAAA,EACtD,OAAA;AAAA,EACA,YAAA;AAAA,EAET,WAAA,CAAY,QAAgB,QAAA,EAAkB;AAC5C,IAAA,MAAM,eAAA,GAAqC;AAAA,MACzC,KAAA,EAAO,MAAA;AAAA,MACP,aAAA,EAAe;AAAA,KACjB;AACA,IAAA,MAAM,eAAA,GAAkB,eAAA,CAAgB,eAAA,EAAiB,MAAA,EAAQ,QAAQ,CAAA;AAEzE,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,UAAA,CAAW,eAAe,CAAA;AAC7C,IAAA,MAAM,YAAA,GAAe,qBAAA,CAAsB,MAAA,EAAQ,QAAQ,CAAA;AAE3D,IAAA,IAAA,CAAK,YAAA,GAAe,MAAA,CAAO,SAAA,CAAU,CAAC,IAAA,KAAS;AAC7C,MAAA,IAAI,CAAC,YAAA,CAAa,IAAA,CAAK,KAAA,EAAO,IAAA,CAAK,aAAa,CAAA,EAAG;AACjD,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,WAAA,GAAc,eAAA;AAAA,QAClB,IAAA,CAAK,QAAQ,WAAA,EAAY;AAAA,QACzB,MAAA;AAAA,QACA,QAAA;AAAA,QACA;AAAA,OACF;AAGA,MAAA,IAAI,CAAC,OAAO,EAAA,CAAG,IAAA,CAAK,QAAQ,WAAA,EAAY,EAAG,WAAW,CAAA,EAAG;AACvD,QAAA,IAAA,CAAK,OAAA,CAAQ,eAAe,WAAW,CAAA;AAAA,MACzC;AAAA,IACF,CAAC,CAAA;AAED,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA;AAAA,EACvC;AAAA,EAEA,UAAU,QAAA,EAAkC;AAC1C,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,QAAQ,CAAA;AAAA,EACxC;AAAA,EAEA,WAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,QAAQ,WAAA,EAAY;AAAA,EAClC;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AAAA,EACvB;AACF,CAAA;AAEO,SAAS,qBAAA,CACd,QACA,QAAA,EACiC;AACjC,EAAA,OAAO,IAAI,eAAA,CAAgB,MAAA,EAAQ,QAAQ,CAAA;AAC7C;ACxDA,IAAM,oBAAN,MAAyD;AAAA,EAC9C,OAAA;AAAA,EACA,YAAA;AAAA,EAET,WAAA,CACE,MAAA,EACA,SAAA,EACA,MAAA,EACA,OAAA,EACA;AACA,IAAA,MAAM,MAAA,GAAS,SAAS,MAAA,IAAU,KAAA;AAClC,IAAA,MAAM,iBAAA,GAAoB,SAAS,iBAAA,IAAqB,IAAA;AAExD,IAAA,MAAM,eAAe,MAAA,CAAO,aAAA;AAAA,MAC1B,SAAA;AAAA,MACA,MAAA;AAAA,MACA,MAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,UAAA,CAAW,YAAY,CAAA;AAE1C,IAAA,IAAA,CAAK,YAAA,GAAe,MAAA,CAAO,SAAA,CAAU,CAAC,IAAA,KAAS;AAC7C,MAAA,MAAM,YAAA,GAAeA,2BAAA,CAAiB,SAAA,EAAW,IAAA,CAAK,MAAM,IAAI,CAAA;AAChE,MAAA,MAAM,gBACJ,IAAA,CAAK,aAAA,IACLA,4BAAiB,SAAA,EAAW,IAAA,CAAK,cAAc,IAAI,CAAA;AAErD,MAAA,IAAI,CAAC,YAAA,IAAgB,CAAC,aAAA,EAAe;AACnC,QAAA;AAAA,MACF;AAIA,MAAA,MAAM,QAAA,GAAW,eACb,MAAA,CAAO,aAAA,CAAc,WAAW,MAAA,EAAQ,MAAA,EAAQ,iBAAiB,CAAA,GACjE,KAAA;AAEJ,MAAA,IAAI,CAAC,OAAO,EAAA,CAAG,IAAA,CAAK,QAAQ,WAAA,EAAY,EAAG,QAAQ,CAAA,EAAG;AACpD,QAAA,IAAA,CAAK,OAAA,CAAQ,eAAe,QAAQ,CAAA;AAAA,MACtC;AAAA,IACF,CAAC,CAAA;AAED,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA;AAAA,EACvC;AAAA,EAEA,UAAU,QAAA,EAAkC;AAC1C,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,QAAQ,CAAA;AAAA,EACxC;AAAA,EAEA,WAAA,GAAuB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAQ,WAAA,EAAY;AAAA,EAClC;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,YAAA,EAAa;AAClB,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AAAA,EACvB;AACF,CAAA;AAEO,SAAS,uBAAA,CACd,MAAA,EACA,SAAA,EACA,MAAA,EACA,OAAA,EACuB;AACvB,EAAA,OAAO,IAAI,iBAAA,CAAkB,MAAA,EAAQ,SAAA,EAAW,QAAQ,OAAO,CAAA;AACjE;ACrEA,IAAM,aAAA,GAA0C;AAAA,EAC9C,eAAA,EAAiB,KAAA;AAAA,EACjB,OAAA,EAAS,IAAA;AAAA,EACT,SAAA,EAAW;AACb,CAAA;AAEA,IAAM,mBAAN,MAAyE;AAAA,EAC9D,OAAA;AAAA,EACA,OAAA;AAAA,EAET,YAAY,MAAA,EAAgB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,UAAA,CAAW,aAAa,CAAA;AAE3C,IAAA,MAAM,GAAA,GAAMC,kBAAa,MAAM,CAAA;AAE/B,IAAA,MAAM,cAAc,MAAY;AAC9B,MAAA,IAAA,CAAK,OAAA,CAAQ,eAAe,aAAa,CAAA;AAAA,IAC3C,CAAA;AAEA,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,GAAA,CAAI,gBAAA;AAAA,QACFC,WAAA,CAAO,gBAAA;AAAA,QACP,CAAC,SAAgB,SAAA,KAAsB;AACrC,UAAA,IAAA,CAAK,QAAQ,cAAA,CAAe;AAAA,YAC1B,eAAA,EAAiB,IAAA;AAAA,YACjB,OAAA,EAAS,OAAA;AAAA,YACT,WAAW,SAAA,IAAa;AAAA,WACzB,CAAA;AAAA,QACH;AAAA,OACF;AAAA,MACA,GAAA,CAAI,gBAAA,CAAiBA,WAAA,CAAO,kBAAA,EAAoB,WAAW,CAAA;AAAA,MAC3D,GAAA,CAAI,gBAAA,CAAiBA,WAAA,CAAO,gBAAA,EAAkB,WAAW,CAAA;AAAA,MACzD,GAAA,CAAI,gBAAA,CAAiBA,WAAA,CAAO,iBAAA,EAAmB,WAAW;AAAA,KAC5D;AAEA,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAA;AAAA,EACvC;AAAA,EAEA,UAAU,QAAA,EAAkC;AAC1C,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,SAAA,CAAU,QAAQ,CAAA;AAAA,EACxC;AAAA,EAEA,WAAA,GAAwC;AACtC,IAAA,OAAO,IAAA,CAAK,QAAQ,WAAA,EAAY;AAAA,EAClC;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,KAAM;AAC1B,MAAA,CAAA,EAAE;AAAA,IACJ,CAAC,CAAA;AACD,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AAAA,EACvB;AACF,CAAA;AAEO,SAAS,uBACd,MAAA,EACwC;AACxC,EAAA,OAAO,IAAI,iBAAiB,MAAM,CAAA;AACpC","file":"index.js","sourcesContent":["import type { RouteSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\nclass RouteSource implements RouterSource<RouteSnapshot> {\n  #routerUnsubscribe: (() => void) | null = null;\n  #currentSnapshot: RouteSnapshot;\n\n  readonly #listeners = new Set<() => void>();\n  readonly #router: Router;\n\n  constructor(router: Router) {\n    this.#router = router;\n\n    this.#currentSnapshot = {\n      route: router.getState(),\n      previousRoute: undefined,\n    };\n\n    this.subscribe = this.subscribe.bind(this);\n    this.destroy = this.destroy.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#listeners.size === 0) {\n      // Connect to router on first subscription\n      this.#routerUnsubscribe = this.#router.subscribe((next) => {\n        this.#currentSnapshot = {\n          route: next.route,\n          previousRoute: next.previousRoute,\n        };\n        this.#listeners.forEach((cb) => {\n          cb();\n        });\n      });\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n\n      if (this.#listeners.size === 0 && this.#routerUnsubscribe) {\n        this.#routerUnsubscribe();\n        this.#routerUnsubscribe = null;\n      }\n    };\n  }\n\n  getSnapshot(): RouteSnapshot {\n    return this.#currentSnapshot;\n  }\n\n  destroy(): void {\n    if (this.#routerUnsubscribe) {\n      this.#routerUnsubscribe();\n      this.#routerUnsubscribe = null;\n    }\n\n    this.#listeners.clear();\n  }\n}\n\n/**\n * Creates a source for the full route state.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteSource(router: Router): RouterSource<RouteSnapshot> {\n  return new RouteSource(router);\n}\n","export class BaseSource<T> {\n  #currentSnapshot: T;\n  #destroyed = false;\n\n  readonly #listeners = new Set<() => void>();\n\n  constructor(initialSnapshot: T) {\n    this.#currentSnapshot = initialSnapshot;\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#destroyed) {\n      return () => {};\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n    };\n  }\n\n  getSnapshot(): T {\n    return this.#currentSnapshot;\n  }\n\n  updateSnapshot(snapshot: T): void {\n    /* v8 ignore next 2 -- @preserve: defensive guard unreachable via public API (destroy() removes router subscription first) */\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#currentSnapshot = snapshot;\n    this.#listeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  destroy(): void {\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#destroyed = true;\n    this.#listeners.clear();\n  }\n}\n","import type { RouteNodeSnapshot } from \"./types.js\";\nimport type { Router, SubscribeState } from \"@real-router/core\";\n\nexport function computeSnapshot(\n  currentSnapshot: RouteNodeSnapshot,\n  router: Router,\n  nodeName: string,\n  next?: SubscribeState,\n): RouteNodeSnapshot {\n  const currentRoute = next?.route ?? router.getState();\n  const previousRoute = next?.previousRoute;\n\n  const isNodeActive =\n    nodeName === \"\" ||\n    (currentRoute !== undefined &&\n      (currentRoute.name === nodeName ||\n        currentRoute.name.startsWith(`${nodeName}.`)));\n\n  const route = isNodeActive ? currentRoute : undefined;\n\n  if (\n    route === currentSnapshot.route &&\n    previousRoute === currentSnapshot.previousRoute\n  ) {\n    return currentSnapshot;\n  }\n\n  return { route, previousRoute };\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst shouldUpdateCache = new WeakMap<\n  Router,\n  Map<string, (toState: State, fromState?: State) => boolean>\n>();\n\nexport function getCachedShouldUpdate(\n  router: Router,\n  nodeName: string,\n): (toState: State, fromState?: State) => boolean {\n  let routerCache = shouldUpdateCache.get(router);\n\n  if (!routerCache) {\n    routerCache = new Map();\n    shouldUpdateCache.set(router, routerCache);\n  }\n\n  let fn = routerCache.get(nodeName);\n\n  if (!fn) {\n    fn = router.shouldUpdateNode(nodeName);\n    routerCache.set(nodeName, fn);\n  }\n\n  return fn;\n}\n","import { BaseSource } from \"./BaseSource\";\nimport { computeSnapshot } from \"./computeSnapshot.js\";\nimport { getCachedShouldUpdate } from \"./shouldUpdateCache.js\";\n\nimport type { RouteNodeSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\nclass RouteNodeSource implements RouterSource<RouteNodeSnapshot> {\n  readonly #source: BaseSource<RouteNodeSnapshot>;\n  readonly #unsubscribe: () => void;\n\n  constructor(router: Router, nodeName: string) {\n    const initialSnapshot: RouteNodeSnapshot = {\n      route: undefined,\n      previousRoute: undefined,\n    };\n    const computedInitial = computeSnapshot(initialSnapshot, router, nodeName);\n\n    this.#source = new BaseSource(computedInitial);\n    const shouldUpdate = getCachedShouldUpdate(router, nodeName);\n\n    this.#unsubscribe = router.subscribe((next) => {\n      if (!shouldUpdate(next.route, next.previousRoute)) {\n        return;\n      }\n\n      const newSnapshot = computeSnapshot(\n        this.#source.getSnapshot(),\n        router,\n        nodeName,\n        next,\n      );\n\n      /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */\n      if (!Object.is(this.#source.getSnapshot(), newSnapshot)) {\n        this.#source.updateSnapshot(newSnapshot);\n      }\n    });\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): RouteNodeSnapshot {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubscribe();\n    this.#source.destroy();\n  }\n}\n\nexport function createRouteNodeSource(\n  router: Router,\n  nodeName: string,\n): RouterSource<RouteNodeSnapshot> {\n  return new RouteNodeSource(router, nodeName);\n}\n","import { areRoutesRelated } from \"@real-router/route-utils\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { ActiveRouteSourceOptions, RouterSource } from \"./types.js\";\nimport type { Params, Router } from \"@real-router/core\";\n\nclass ActiveRouteSource implements RouterSource<boolean> {\n  readonly #source: BaseSource<boolean>;\n  readonly #unsubscribe: () => void;\n\n  constructor(\n    router: Router,\n    routeName: string,\n    params?: Params,\n    options?: ActiveRouteSourceOptions,\n  ) {\n    const strict = options?.strict ?? false;\n    const ignoreQueryParams = options?.ignoreQueryParams ?? true;\n\n    const initialValue = router.isActiveRoute(\n      routeName,\n      params,\n      strict,\n      ignoreQueryParams,\n    );\n\n    this.#source = new BaseSource(initialValue);\n\n    this.#unsubscribe = router.subscribe((next) => {\n      const isNewRelated = areRoutesRelated(routeName, next.route.name);\n      const isPrevRelated =\n        next.previousRoute &&\n        areRoutesRelated(routeName, next.previousRoute.name);\n\n      if (!isNewRelated && !isPrevRelated) {\n        return;\n      }\n\n      // If new route is not related, we know the route is inactive —\n      // avoid calling isActiveRoute for the optimization\n      const newValue = isNewRelated\n        ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)\n        : false;\n\n      if (!Object.is(this.#source.getSnapshot(), newValue)) {\n        this.#source.updateSnapshot(newValue);\n      }\n    });\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): boolean {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubscribe();\n    this.#source.destroy();\n  }\n}\n\nexport function createActiveRouteSource(\n  router: Router,\n  routeName: string,\n  params?: Params,\n  options?: ActiveRouteSourceOptions,\n): RouterSource<boolean> {\n  return new ActiveRouteSource(router, routeName, params, options);\n}\n","import { getPluginApi, events } from \"@real-router/core\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { RouterTransitionSnapshot, RouterSource } from \"./types.js\";\nimport type { Router, State } from \"@real-router/core\";\n\nconst IDLE_SNAPSHOT: RouterTransitionSnapshot = {\n  isTransitioning: false,\n  toRoute: null,\n  fromRoute: null,\n};\n\nclass TransitionSource implements RouterSource<RouterTransitionSnapshot> {\n  readonly #source: BaseSource<RouterTransitionSnapshot>;\n  readonly #unsubs: (() => void)[];\n\n  constructor(router: Router) {\n    this.#source = new BaseSource(IDLE_SNAPSHOT);\n\n    const api = getPluginApi(router);\n\n    const resetToIdle = (): void => {\n      this.#source.updateSnapshot(IDLE_SNAPSHOT);\n    };\n\n    this.#unsubs = [\n      api.addEventListener(\n        events.TRANSITION_START,\n        (toState: State, fromState?: State) => {\n          this.#source.updateSnapshot({\n            isTransitioning: true,\n            toRoute: toState,\n            fromRoute: fromState ?? null,\n          });\n        },\n      ),\n      api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),\n      api.addEventListener(events.TRANSITION_ERROR, resetToIdle),\n      api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),\n    ];\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): RouterTransitionSnapshot {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubs.forEach((u) => {\n      u();\n    });\n    this.#source.destroy();\n  }\n}\n\nexport function createTransitionSource(\n  router: Router,\n): RouterSource<RouterTransitionSnapshot> {\n  return new TransitionSource(router);\n}\n"]}
+{"version":3,"sources":["../../src/BaseSource.ts","../../src/createRouteSource.ts","../../src/computeSnapshot.ts","../../src/shouldUpdateCache.ts","../../src/createRouteNodeSource.ts","../../src/createActiveRouteSource.ts","../../src/createTransitionSource.ts"],"names":["areRoutesRelated","getPluginApi","events"],"mappings":"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","file":"index.js","sourcesContent":["export interface BaseSourceOptions {\n  onFirstSubscribe?: () => void;\n  onLastUnsubscribe?: () => void;\n  onDestroy?: () => void;\n}\n\nexport class BaseSource<T> {\n  #currentSnapshot: T;\n  #destroyed = false;\n\n  readonly #listeners = new Set<() => void>();\n  readonly #onFirstSubscribe: (() => void) | undefined;\n  readonly #onLastUnsubscribe: (() => void) | undefined;\n  readonly #onDestroy: (() => void) | undefined;\n\n  constructor(initialSnapshot: T, options?: BaseSourceOptions) {\n    this.#currentSnapshot = initialSnapshot;\n    this.#onFirstSubscribe = options?.onFirstSubscribe;\n    this.#onLastUnsubscribe = options?.onLastUnsubscribe;\n    this.#onDestroy = options?.onDestroy;\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#destroyed) {\n      return () => {};\n    }\n\n    if (this.#listeners.size === 0 && this.#onFirstSubscribe) {\n      this.#onFirstSubscribe();\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n\n      if (\n        !this.#destroyed &&\n        this.#listeners.size === 0 &&\n        this.#onLastUnsubscribe\n      ) {\n        this.#onLastUnsubscribe();\n      }\n    };\n  }\n\n  getSnapshot(): T {\n    return this.#currentSnapshot;\n  }\n\n  updateSnapshot(snapshot: T): void {\n    /* v8 ignore next 2 -- @preserve: defensive guard unreachable via public API (destroy() removes router subscription first) */\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#currentSnapshot = snapshot;\n    this.#listeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  destroy(): void {\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#destroyed = true;\n    this.#onDestroy?.();\n    this.#listeners.clear();\n  }\n}\n","import { BaseSource } from \"./BaseSource\";\n\nimport type { RouteSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\n/**\n * Creates a source for the full route state.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteSource(router: Router): RouterSource<RouteSnapshot> {\n  let routerUnsubscribe: (() => void) | null = null;\n\n  const disconnect = (): void => {\n    const unsub = routerUnsubscribe;\n\n    routerUnsubscribe = null;\n    unsub?.();\n  };\n\n  const source = new BaseSource<RouteSnapshot>(\n    {\n      route: router.getState(),\n      previousRoute: undefined,\n    },\n    {\n      onFirstSubscribe: () => {\n        routerUnsubscribe = router.subscribe((next) => {\n          source.updateSnapshot({\n            route: next.route,\n            previousRoute: next.previousRoute,\n          });\n        });\n      },\n      onLastUnsubscribe: disconnect,\n      onDestroy: disconnect,\n    },\n  );\n\n  return source;\n}\n","import type { RouteNodeSnapshot } from \"./types.js\";\nimport type { Router, SubscribeState } from \"@real-router/core\";\n\nexport function computeSnapshot(\n  currentSnapshot: RouteNodeSnapshot,\n  router: Router,\n  nodeName: string,\n  next?: SubscribeState,\n): RouteNodeSnapshot {\n  const currentRoute = next?.route ?? router.getState();\n  const previousRoute = next?.previousRoute;\n\n  const isNodeActive =\n    nodeName === \"\" ||\n    (currentRoute !== undefined &&\n      (currentRoute.name === nodeName ||\n        currentRoute.name.startsWith(`${nodeName}.`)));\n\n  const route = isNodeActive ? currentRoute : undefined;\n\n  if (\n    route === currentSnapshot.route &&\n    previousRoute === currentSnapshot.previousRoute\n  ) {\n    return currentSnapshot;\n  }\n\n  return { route, previousRoute };\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst shouldUpdateCache = new WeakMap<\n  Router,\n  Map<string, (toState: State, fromState?: State) => boolean>\n>();\n\nexport function getCachedShouldUpdate(\n  router: Router,\n  nodeName: string,\n): (toState: State, fromState?: State) => boolean {\n  let routerCache = shouldUpdateCache.get(router);\n\n  if (!routerCache) {\n    routerCache = new Map();\n    shouldUpdateCache.set(router, routerCache);\n  }\n\n  let fn = routerCache.get(nodeName);\n\n  if (!fn) {\n    fn = router.shouldUpdateNode(nodeName);\n    routerCache.set(nodeName, fn);\n  }\n\n  return fn;\n}\n","import { BaseSource } from \"./BaseSource\";\nimport { computeSnapshot } from \"./computeSnapshot.js\";\nimport { getCachedShouldUpdate } from \"./shouldUpdateCache.js\";\n\nimport type { RouteNodeSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\n/**\n * Creates a source scoped to a specific route node.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteNodeSource(\n  router: Router,\n  nodeName: string,\n): RouterSource<RouteNodeSnapshot> {\n  let routerUnsubscribe: (() => void) | null = null;\n\n  const shouldUpdate = getCachedShouldUpdate(router, nodeName);\n\n  const initialSnapshot: RouteNodeSnapshot = {\n    route: undefined,\n    previousRoute: undefined,\n  };\n\n  const disconnect = (): void => {\n    const unsub = routerUnsubscribe;\n\n    routerUnsubscribe = null;\n    unsub?.();\n  };\n\n  const source = new BaseSource<RouteNodeSnapshot>(\n    computeSnapshot(initialSnapshot, router, nodeName),\n    {\n      onFirstSubscribe: () => {\n        // Reconcile snapshot with current router state before connecting.\n        // Covers reconnection after Activity hide/show cycles where the\n        // source was disconnected and missed navigation events.\n        source.updateSnapshot(\n          computeSnapshot(source.getSnapshot(), router, nodeName),\n        );\n\n        // Connect to router on first subscription\n        routerUnsubscribe = router.subscribe((next) => {\n          if (!shouldUpdate(next.route, next.previousRoute)) {\n            return;\n          }\n\n          const newSnapshot = computeSnapshot(\n            source.getSnapshot(),\n            router,\n            nodeName,\n            next,\n          );\n\n          /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */\n          if (!Object.is(source.getSnapshot(), newSnapshot)) {\n            source.updateSnapshot(newSnapshot);\n          }\n        });\n      },\n      onLastUnsubscribe: disconnect,\n      onDestroy: disconnect,\n    },\n  );\n\n  return source;\n}\n","import { areRoutesRelated } from \"@real-router/route-utils\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { ActiveRouteSourceOptions, RouterSource } from \"./types.js\";\nimport type { Params, Router } from \"@real-router/core\";\n\nexport function createActiveRouteSource(\n  router: Router,\n  routeName: string,\n  params?: Params,\n  options?: ActiveRouteSourceOptions,\n): RouterSource<boolean> {\n  const strict = options?.strict ?? false;\n  const ignoreQueryParams = options?.ignoreQueryParams ?? true;\n\n  const initialValue = router.isActiveRoute(\n    routeName,\n    params,\n    strict,\n    ignoreQueryParams,\n  );\n\n  const source = new BaseSource(initialValue, {\n    onDestroy: () => {\n      unsubscribe();\n    },\n  });\n\n  // Eager connection: subscribe to router immediately\n  const unsubscribe = router.subscribe((next) => {\n    const isNewRelated = areRoutesRelated(routeName, next.route.name);\n    const isPrevRelated =\n      next.previousRoute &&\n      areRoutesRelated(routeName, next.previousRoute.name);\n\n    if (!isNewRelated && !isPrevRelated) {\n      return;\n    }\n\n    // If new route is not related, we know the route is inactive —\n    // avoid calling isActiveRoute for the optimization\n    const newValue = isNewRelated\n      ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)\n      : false;\n\n    if (!Object.is(source.getSnapshot(), newValue)) {\n      source.updateSnapshot(newValue);\n    }\n  });\n\n  return source;\n}\n","import { getPluginApi, events } from \"@real-router/core\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { RouterTransitionSnapshot, RouterSource } from \"./types.js\";\nimport type { Router, State } from \"@real-router/core\";\n\nconst IDLE_SNAPSHOT: RouterTransitionSnapshot = {\n  isTransitioning: false,\n  toRoute: null,\n  fromRoute: null,\n};\n\nexport function createTransitionSource(\n  router: Router,\n): RouterSource<RouterTransitionSnapshot> {\n  const source = new BaseSource(IDLE_SNAPSHOT, {\n    onDestroy: () => {\n      unsubs.forEach((u) => {\n        u();\n      });\n    },\n  });\n\n  const api = getPluginApi(router);\n\n  const resetToIdle = (): void => {\n    source.updateSnapshot(IDLE_SNAPSHOT);\n  };\n\n  // Eager connection: subscribe to router events immediately\n  const unsubs = [\n    api.addEventListener(\n      events.TRANSITION_START,\n      (toState: State, fromState?: State) => {\n        source.updateSnapshot({\n          isTransitioning: true,\n          toRoute: toState,\n          fromRoute: fromState ?? null,\n        });\n      },\n    ),\n    api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),\n    api.addEventListener(events.TRANSITION_ERROR, resetToIdle),\n    api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),\n  ];\n\n  return source;\n}\n"]}

package/dist/cjs/metafile-cjs.json

@@ -1 +1 @@
-{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/createRouteSource.ts":{"bytes":1956,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/BaseSource.ts":{"bytes":941,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/computeSnapshot.ts":{"bytes":790,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/shouldUpdateCache.ts":{"bytes":610,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createRouteNodeSource.ts":{"bytes":1911,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"src/computeSnapshot.ts","kind":"import-statement","original":"./computeSnapshot.js"},{"path":"src/shouldUpdateCache.ts","kind":"import-statement","original":"./shouldUpdateCache.js"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createActiveRouteSource.ts":{"bytes":2124,"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createTransitionSource.ts":{"bytes":1845,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":407,"imports":[{"path":"src/createRouteSource.ts","kind":"import-statement","original":"./createRouteSource"},{"path":"src/createRouteNodeSource.ts","kind":"import-statement","original":"./createRouteNodeSource"},{"path":"src/createActiveRouteSource.ts","kind":"import-statement","original":"./createActiveRouteSource"},{"path":"src/createTransitionSource.ts","kind":"import-statement","original":"./createTransitionSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":15986},"dist/cjs/index.js":{"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["createActiveRouteSource","createRouteNodeSource","createRouteSource","createTransitionSource"],"entryPoint":"src/index.ts","inputs":{"src/createRouteSource.ts":{"bytesInOutput":1303},"src/index.ts":{"bytesInOutput":0},"src/BaseSource.ts":{"bytesInOutput":752},"src/computeSnapshot.ts":{"bytesInOutput":536},"src/shouldUpdateCache.ts":{"bytesInOutput":425},"src/createRouteNodeSource.ts":{"bytesInOutput":1234},"src/createActiveRouteSource.ts":{"bytesInOutput":1490},"src/createTransitionSource.ts":{"bytesInOutput":1367}},"bytes":7679}}}
+{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/BaseSource.ts":{"bytes":1857,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createRouteSource.ts":{"bytes":1168,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/computeSnapshot.ts":{"bytes":790,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/shouldUpdateCache.ts":{"bytes":610,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createRouteNodeSource.ts":{"bytes":2245,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"src/computeSnapshot.ts","kind":"import-statement","original":"./computeSnapshot.js"},{"path":"src/shouldUpdateCache.ts","kind":"import-statement","original":"./shouldUpdateCache.js"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createActiveRouteSource.ts":{"bytes":1461,"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/createTransitionSource.ts":{"bytes":1278,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":407,"imports":[{"path":"src/createRouteSource.ts","kind":"import-statement","original":"./createRouteSource"},{"path":"src/createRouteNodeSource.ts","kind":"import-statement","original":"./createRouteNodeSource"},{"path":"src/createActiveRouteSource.ts","kind":"import-statement","original":"./createActiveRouteSource"},{"path":"src/createTransitionSource.ts","kind":"import-statement","original":"./createTransitionSource"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":14149},"dist/cjs/index.js":{"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["createActiveRouteSource","createRouteNodeSource","createRouteSource","createTransitionSource"],"entryPoint":"src/index.ts","inputs":{"src/BaseSource.ts":{"bytesInOutput":1375},"src/createRouteSource.ts":{"bytesInOutput":627},"src/index.ts":{"bytesInOutput":0},"src/computeSnapshot.ts":{"bytesInOutput":536},"src/shouldUpdateCache.ts":{"bytesInOutput":425},"src/createRouteNodeSource.ts":{"bytesInOutput":1120},"src/createActiveRouteSource.ts":{"bytesInOutput":977},"src/createTransitionSource.ts":{"bytesInOutput":921}},"bytes":6553}}}

package/dist/esm/index.d.mts

@@ -32,6 +32,13 @@ interface RouterTransitionSnapshot {
  */
 declare function createRouteSource(router: Router): RouterSource<RouteSnapshot>;
 
+/**
+ * Creates a source scoped to a specific route node.
+ *
+ * Uses a lazy-connection pattern: the router subscription is created when the
+ * first listener subscribes and removed when the last listener unsubscribes.
+ * This is compatible with React's useSyncExternalStore and Strict Mode.
+ */
 declare function createRouteNodeSource(router: Router, nodeName: string): RouterSource<RouteNodeSnapshot>;
 
 declare function createActiveRouteSource(router: Router, routeName: string, params?: Params, options?: ActiveRouteSourceOptions): RouterSource<boolean>;

package/dist/esm/index.mjs

@@ -1 +1 @@
-import{areRoutesRelated as s}from"@real-router/route-utils";import{getPluginApi as t,events as e}from"@real-router/core";var r=class{#s=null;#t;#e=new Set;#r;constructor(s){this.#r=s,this.#t={route:s.getState(),previousRoute:void 0},this.subscribe=this.subscribe.bind(this),this.destroy=this.destroy.bind(this),this.getSnapshot=this.getSnapshot.bind(this)}subscribe(s){return 0===this.#e.size&&(this.#s=this.#r.subscribe(s=>{this.#t={route:s.route,previousRoute:s.previousRoute},this.#e.forEach(s=>{s()})})),this.#e.add(s),()=>{this.#e.delete(s),0===this.#e.size&&this.#s&&(this.#s(),this.#s=null)}}getSnapshot(){return this.#t}destroy(){this.#s&&(this.#s(),this.#s=null),this.#e.clear()}};function i(s){return new r(s)}var o=class{#t;#i=!1;#e=new Set;constructor(s){this.#t=s}subscribe(s){return this.#i?()=>{}:(this.#e.add(s),()=>{this.#e.delete(s)})}getSnapshot(){return this.#t}updateSnapshot(s){this.#i||(this.#t=s,this.#e.forEach(s=>{s()}))}destroy(){this.#i||(this.#i=!0,this.#e.clear())}};function u(s,t,e,r){const i=r?.route??t.getState(),o=r?.previousRoute,u=""===e||void 0!==i&&(i.name===e||i.name.startsWith(`${e}.`))?i:void 0;return u===s.route&&o===s.previousRoute?s:{route:u,previousRoute:o}}var n=new WeakMap,h=class{#o;#u;constructor(s,t){const e=u({route:void 0,previousRoute:void 0},s,t);this.#o=new o(e);const r=function(s,t){let e=n.get(s);e||(e=new Map,n.set(s,e));let r=e.get(t);return r||(r=s.shouldUpdateNode(t),e.set(t,r)),r}(s,t);this.#u=s.subscribe(e=>{if(!r(e.route,e.previousRoute))return;const i=u(this.#o.getSnapshot(),s,t,e);Object.is(this.#o.getSnapshot(),i)||this.#o.updateSnapshot(i)}),this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(s){return this.#o.subscribe(s)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#u(),this.#o.destroy()}};function c(s,t){return new h(s,t)}var b=class{#o;#u;constructor(t,e,r,i){const u=i?.strict??!1,n=i?.ignoreQueryParams??!0,h=t.isActiveRoute(e,r,u,n);this.#o=new o(h),this.#u=t.subscribe(i=>{const o=s(e,i.route.name),h=i.previousRoute&&s(e,i.previousRoute.name);if(!o&&!h)return;const c=!!o&&t.isActiveRoute(e,r,u,n);Object.is(this.#o.getSnapshot(),c)||this.#o.updateSnapshot(c)}),this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(s){return this.#o.subscribe(s)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#u(),this.#o.destroy()}};function a(s,t,e,r){return new b(s,t,e,r)}var d={isTransitioning:!1,toRoute:null,fromRoute:null},p=class{#o;#n;constructor(s){this.#o=new o(d);const r=t(s),i=()=>{this.#o.updateSnapshot(d)};this.#n=[r.addEventListener(e.TRANSITION_START,(s,t)=>{this.#o.updateSnapshot({isTransitioning:!0,toRoute:s,fromRoute:t??null})}),r.addEventListener(e.TRANSITION_SUCCESS,i),r.addEventListener(e.TRANSITION_ERROR,i),r.addEventListener(e.TRANSITION_CANCEL,i)],this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(s){return this.#o.subscribe(s)}getSnapshot(){return this.#o.getSnapshot()}destroy(){this.#n.forEach(s=>{s()}),this.#o.destroy()}};function S(s){return new p(s)}export{a as createActiveRouteSource,c as createRouteNodeSource,i as createRouteSource,S as createTransitionSource};//# sourceMappingURL=index.mjs.map
+import{areRoutesRelated as t}from"@real-router/route-utils";import{getPluginApi as e,events as s}from"@real-router/core";var o=class{#t;#e=!1;#s=new Set;#o;#r;#n;constructor(t,e){this.#t=t,this.#o=e?.onFirstSubscribe,this.#r=e?.onLastUnsubscribe,this.#n=e?.onDestroy,this.subscribe=this.subscribe.bind(this),this.getSnapshot=this.getSnapshot.bind(this),this.destroy=this.destroy.bind(this)}subscribe(t){return this.#e?()=>{}:(0===this.#s.size&&this.#o&&this.#o(),this.#s.add(t),()=>{this.#s.delete(t),!this.#e&&0===this.#s.size&&this.#r&&this.#r()})}getSnapshot(){return this.#t}updateSnapshot(t){this.#e||(this.#t=t,this.#s.forEach(t=>{t()}))}destroy(){this.#e||(this.#e=!0,this.#n?.(),this.#s.clear())}};function r(t){let e=null;const s=()=>{const t=e;e=null,t?.()},r=new o({route:t.getState(),previousRoute:void 0},{onFirstSubscribe:()=>{e=t.subscribe(t=>{r.updateSnapshot({route:t.route,previousRoute:t.previousRoute})})},onLastUnsubscribe:s,onDestroy:s});return r}function n(t,e,s,o){const r=o?.route??e.getState(),n=o?.previousRoute,i=""===s||void 0!==r&&(r.name===s||r.name.startsWith(`${s}.`))?r:void 0;return i===t.route&&n===t.previousRoute?t:{route:i,previousRoute:n}}var i=new WeakMap;function u(t,e){let s=null;const r=function(t,e){let s=i.get(t);s||(s=new Map,i.set(t,s));let o=s.get(e);return o||(o=t.shouldUpdateNode(e),s.set(e,o)),o}(t,e),u=()=>{const t=s;s=null,t?.()},a=new o(n({route:void 0,previousRoute:void 0},t,e),{onFirstSubscribe:()=>{a.updateSnapshot(n(a.getSnapshot(),t,e)),s=t.subscribe(s=>{if(!r(s.route,s.previousRoute))return;const o=n(a.getSnapshot(),t,e,s);Object.is(a.getSnapshot(),o)||a.updateSnapshot(o)})},onLastUnsubscribe:u,onDestroy:u});return a}function a(e,s,r,n){const i=n?.strict??!1,u=n?.ignoreQueryParams??!0,a=e.isActiveRoute(s,r,i,u),h=new o(a,{onDestroy:()=>{c()}}),c=e.subscribe(o=>{const n=t(s,o.route.name),a=o.previousRoute&&t(s,o.previousRoute.name);if(!n&&!a)return;const c=!!n&&e.isActiveRoute(s,r,i,u);Object.is(h.getSnapshot(),c)||h.updateSnapshot(c)});return h}var h={isTransitioning:!1,toRoute:null,fromRoute:null};function c(t){const r=new o(h,{onDestroy:()=>{u.forEach(t=>{t()})}}),n=e(t),i=()=>{r.updateSnapshot(h)},u=[n.addEventListener(s.TRANSITION_START,(t,e)=>{r.updateSnapshot({isTransitioning:!0,toRoute:t,fromRoute:e??null})}),n.addEventListener(s.TRANSITION_SUCCESS,i),n.addEventListener(s.TRANSITION_ERROR,i),n.addEventListener(s.TRANSITION_CANCEL,i)];return r}export{a as createActiveRouteSource,u as createRouteNodeSource,r as createRouteSource,c as createTransitionSource};//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/createRouteSource.ts","../../src/BaseSource.ts","../../src/computeSnapshot.ts","../../src/shouldUpdateCache.ts","../../src/createRouteNodeSource.ts","../../src/createActiveRouteSource.ts","../../src/createTransitionSource.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { RouteSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\nclass RouteSource implements RouterSource<RouteSnapshot> {\n  #routerUnsubscribe: (() => void) | null = null;\n  #currentSnapshot: RouteSnapshot;\n\n  readonly #listeners = new Set<() => void>();\n  readonly #router: Router;\n\n  constructor(router: Router) {\n    this.#router = router;\n\n    this.#currentSnapshot = {\n      route: router.getState(),\n      previousRoute: undefined,\n    };\n\n    this.subscribe = this.subscribe.bind(this);\n    this.destroy = this.destroy.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#listeners.size === 0) {\n      // Connect to router on first subscription\n      this.#routerUnsubscribe = this.#router.subscribe((next) => {\n        this.#currentSnapshot = {\n          route: next.route,\n          previousRoute: next.previousRoute,\n        };\n        this.#listeners.forEach((cb) => {\n          cb();\n        });\n      });\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n\n      if (this.#listeners.size === 0 && this.#routerUnsubscribe) {\n        this.#routerUnsubscribe();\n        this.#routerUnsubscribe = null;\n      }\n    };\n  }\n\n  getSnapshot(): RouteSnapshot {\n    return this.#currentSnapshot;\n  }\n\n  destroy(): void {\n    if (this.#routerUnsubscribe) {\n      this.#routerUnsubscribe();\n      this.#routerUnsubscribe = null;\n    }\n\n    this.#listeners.clear();\n  }\n}\n\n/**\n * Creates a source for the full route state.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteSource(router: Router): RouterSource<RouteSnapshot> {\n  return new RouteSource(router);\n}\n","export class BaseSource<T> {\n  #currentSnapshot: T;\n  #destroyed = false;\n\n  readonly #listeners = new Set<() => void>();\n\n  constructor(initialSnapshot: T) {\n    this.#currentSnapshot = initialSnapshot;\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#destroyed) {\n      return () => {};\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n    };\n  }\n\n  getSnapshot(): T {\n    return this.#currentSnapshot;\n  }\n\n  updateSnapshot(snapshot: T): void {\n    /* v8 ignore next 2 -- @preserve: defensive guard unreachable via public API (destroy() removes router subscription first) */\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#currentSnapshot = snapshot;\n    this.#listeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  destroy(): void {\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#destroyed = true;\n    this.#listeners.clear();\n  }\n}\n","import type { RouteNodeSnapshot } from \"./types.js\";\nimport type { Router, SubscribeState } from \"@real-router/core\";\n\nexport function computeSnapshot(\n  currentSnapshot: RouteNodeSnapshot,\n  router: Router,\n  nodeName: string,\n  next?: SubscribeState,\n): RouteNodeSnapshot {\n  const currentRoute = next?.route ?? router.getState();\n  const previousRoute = next?.previousRoute;\n\n  const isNodeActive =\n    nodeName === \"\" ||\n    (currentRoute !== undefined &&\n      (currentRoute.name === nodeName ||\n        currentRoute.name.startsWith(`${nodeName}.`)));\n\n  const route = isNodeActive ? currentRoute : undefined;\n\n  if (\n    route === currentSnapshot.route &&\n    previousRoute === currentSnapshot.previousRoute\n  ) {\n    return currentSnapshot;\n  }\n\n  return { route, previousRoute };\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst shouldUpdateCache = new WeakMap<\n  Router,\n  Map<string, (toState: State, fromState?: State) => boolean>\n>();\n\nexport function getCachedShouldUpdate(\n  router: Router,\n  nodeName: string,\n): (toState: State, fromState?: State) => boolean {\n  let routerCache = shouldUpdateCache.get(router);\n\n  if (!routerCache) {\n    routerCache = new Map();\n    shouldUpdateCache.set(router, routerCache);\n  }\n\n  let fn = routerCache.get(nodeName);\n\n  if (!fn) {\n    fn = router.shouldUpdateNode(nodeName);\n    routerCache.set(nodeName, fn);\n  }\n\n  return fn;\n}\n","import { BaseSource } from \"./BaseSource\";\nimport { computeSnapshot } from \"./computeSnapshot.js\";\nimport { getCachedShouldUpdate } from \"./shouldUpdateCache.js\";\n\nimport type { RouteNodeSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\nclass RouteNodeSource implements RouterSource<RouteNodeSnapshot> {\n  readonly #source: BaseSource<RouteNodeSnapshot>;\n  readonly #unsubscribe: () => void;\n\n  constructor(router: Router, nodeName: string) {\n    const initialSnapshot: RouteNodeSnapshot = {\n      route: undefined,\n      previousRoute: undefined,\n    };\n    const computedInitial = computeSnapshot(initialSnapshot, router, nodeName);\n\n    this.#source = new BaseSource(computedInitial);\n    const shouldUpdate = getCachedShouldUpdate(router, nodeName);\n\n    this.#unsubscribe = router.subscribe((next) => {\n      if (!shouldUpdate(next.route, next.previousRoute)) {\n        return;\n      }\n\n      const newSnapshot = computeSnapshot(\n        this.#source.getSnapshot(),\n        router,\n        nodeName,\n        next,\n      );\n\n      /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */\n      if (!Object.is(this.#source.getSnapshot(), newSnapshot)) {\n        this.#source.updateSnapshot(newSnapshot);\n      }\n    });\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): RouteNodeSnapshot {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubscribe();\n    this.#source.destroy();\n  }\n}\n\nexport function createRouteNodeSource(\n  router: Router,\n  nodeName: string,\n): RouterSource<RouteNodeSnapshot> {\n  return new RouteNodeSource(router, nodeName);\n}\n","import { areRoutesRelated } from \"@real-router/route-utils\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { ActiveRouteSourceOptions, RouterSource } from \"./types.js\";\nimport type { Params, Router } from \"@real-router/core\";\n\nclass ActiveRouteSource implements RouterSource<boolean> {\n  readonly #source: BaseSource<boolean>;\n  readonly #unsubscribe: () => void;\n\n  constructor(\n    router: Router,\n    routeName: string,\n    params?: Params,\n    options?: ActiveRouteSourceOptions,\n  ) {\n    const strict = options?.strict ?? false;\n    const ignoreQueryParams = options?.ignoreQueryParams ?? true;\n\n    const initialValue = router.isActiveRoute(\n      routeName,\n      params,\n      strict,\n      ignoreQueryParams,\n    );\n\n    this.#source = new BaseSource(initialValue);\n\n    this.#unsubscribe = router.subscribe((next) => {\n      const isNewRelated = areRoutesRelated(routeName, next.route.name);\n      const isPrevRelated =\n        next.previousRoute &&\n        areRoutesRelated(routeName, next.previousRoute.name);\n\n      if (!isNewRelated && !isPrevRelated) {\n        return;\n      }\n\n      // If new route is not related, we know the route is inactive —\n      // avoid calling isActiveRoute for the optimization\n      const newValue = isNewRelated\n        ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)\n        : false;\n\n      if (!Object.is(this.#source.getSnapshot(), newValue)) {\n        this.#source.updateSnapshot(newValue);\n      }\n    });\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): boolean {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubscribe();\n    this.#source.destroy();\n  }\n}\n\nexport function createActiveRouteSource(\n  router: Router,\n  routeName: string,\n  params?: Params,\n  options?: ActiveRouteSourceOptions,\n): RouterSource<boolean> {\n  return new ActiveRouteSource(router, routeName, params, options);\n}\n","import { getPluginApi, events } from \"@real-router/core\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { RouterTransitionSnapshot, RouterSource } from \"./types.js\";\nimport type { Router, State } from \"@real-router/core\";\n\nconst IDLE_SNAPSHOT: RouterTransitionSnapshot = {\n  isTransitioning: false,\n  toRoute: null,\n  fromRoute: null,\n};\n\nclass TransitionSource implements RouterSource<RouterTransitionSnapshot> {\n  readonly #source: BaseSource<RouterTransitionSnapshot>;\n  readonly #unsubs: (() => void)[];\n\n  constructor(router: Router) {\n    this.#source = new BaseSource(IDLE_SNAPSHOT);\n\n    const api = getPluginApi(router);\n\n    const resetToIdle = (): void => {\n      this.#source.updateSnapshot(IDLE_SNAPSHOT);\n    };\n\n    this.#unsubs = [\n      api.addEventListener(\n        events.TRANSITION_START,\n        (toState: State, fromState?: State) => {\n          this.#source.updateSnapshot({\n            isTransitioning: true,\n            toRoute: toState,\n            fromRoute: fromState ?? null,\n          });\n        },\n      ),\n      api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),\n      api.addEventListener(events.TRANSITION_ERROR, resetToIdle),\n      api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),\n    ];\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.#source.subscribe(listener);\n  }\n\n  getSnapshot(): RouterTransitionSnapshot {\n    return this.#source.getSnapshot();\n  }\n\n  destroy(): void {\n    this.#unsubs.forEach((u) => {\n      u();\n    });\n    this.#source.destroy();\n  }\n}\n\nexport function createTransitionSource(\n  router: Router,\n): RouterSource<RouterTransitionSnapshot> {\n  return new TransitionSource(router);\n}\n"]}
+{"version":3,"sources":["../../src/BaseSource.ts","../../src/createRouteSource.ts","../../src/computeSnapshot.ts","../../src/shouldUpdateCache.ts","../../src/createRouteNodeSource.ts","../../src/createActiveRouteSource.ts","../../src/createTransitionSource.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export interface BaseSourceOptions {\n  onFirstSubscribe?: () => void;\n  onLastUnsubscribe?: () => void;\n  onDestroy?: () => void;\n}\n\nexport class BaseSource<T> {\n  #currentSnapshot: T;\n  #destroyed = false;\n\n  readonly #listeners = new Set<() => void>();\n  readonly #onFirstSubscribe: (() => void) | undefined;\n  readonly #onLastUnsubscribe: (() => void) | undefined;\n  readonly #onDestroy: (() => void) | undefined;\n\n  constructor(initialSnapshot: T, options?: BaseSourceOptions) {\n    this.#currentSnapshot = initialSnapshot;\n    this.#onFirstSubscribe = options?.onFirstSubscribe;\n    this.#onLastUnsubscribe = options?.onLastUnsubscribe;\n    this.#onDestroy = options?.onDestroy;\n\n    this.subscribe = this.subscribe.bind(this);\n    this.getSnapshot = this.getSnapshot.bind(this);\n    this.destroy = this.destroy.bind(this);\n  }\n\n  subscribe(listener: () => void): () => void {\n    if (this.#destroyed) {\n      return () => {};\n    }\n\n    if (this.#listeners.size === 0 && this.#onFirstSubscribe) {\n      this.#onFirstSubscribe();\n    }\n\n    this.#listeners.add(listener);\n\n    return () => {\n      this.#listeners.delete(listener);\n\n      if (\n        !this.#destroyed &&\n        this.#listeners.size === 0 &&\n        this.#onLastUnsubscribe\n      ) {\n        this.#onLastUnsubscribe();\n      }\n    };\n  }\n\n  getSnapshot(): T {\n    return this.#currentSnapshot;\n  }\n\n  updateSnapshot(snapshot: T): void {\n    /* v8 ignore next 2 -- @preserve: defensive guard unreachable via public API (destroy() removes router subscription first) */\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#currentSnapshot = snapshot;\n    this.#listeners.forEach((listener) => {\n      listener();\n    });\n  }\n\n  destroy(): void {\n    if (this.#destroyed) {\n      return;\n    }\n\n    this.#destroyed = true;\n    this.#onDestroy?.();\n    this.#listeners.clear();\n  }\n}\n","import { BaseSource } from \"./BaseSource\";\n\nimport type { RouteSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\n/**\n * Creates a source for the full route state.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteSource(router: Router): RouterSource<RouteSnapshot> {\n  let routerUnsubscribe: (() => void) | null = null;\n\n  const disconnect = (): void => {\n    const unsub = routerUnsubscribe;\n\n    routerUnsubscribe = null;\n    unsub?.();\n  };\n\n  const source = new BaseSource<RouteSnapshot>(\n    {\n      route: router.getState(),\n      previousRoute: undefined,\n    },\n    {\n      onFirstSubscribe: () => {\n        routerUnsubscribe = router.subscribe((next) => {\n          source.updateSnapshot({\n            route: next.route,\n            previousRoute: next.previousRoute,\n          });\n        });\n      },\n      onLastUnsubscribe: disconnect,\n      onDestroy: disconnect,\n    },\n  );\n\n  return source;\n}\n","import type { RouteNodeSnapshot } from \"./types.js\";\nimport type { Router, SubscribeState } from \"@real-router/core\";\n\nexport function computeSnapshot(\n  currentSnapshot: RouteNodeSnapshot,\n  router: Router,\n  nodeName: string,\n  next?: SubscribeState,\n): RouteNodeSnapshot {\n  const currentRoute = next?.route ?? router.getState();\n  const previousRoute = next?.previousRoute;\n\n  const isNodeActive =\n    nodeName === \"\" ||\n    (currentRoute !== undefined &&\n      (currentRoute.name === nodeName ||\n        currentRoute.name.startsWith(`${nodeName}.`)));\n\n  const route = isNodeActive ? currentRoute : undefined;\n\n  if (\n    route === currentSnapshot.route &&\n    previousRoute === currentSnapshot.previousRoute\n  ) {\n    return currentSnapshot;\n  }\n\n  return { route, previousRoute };\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst shouldUpdateCache = new WeakMap<\n  Router,\n  Map<string, (toState: State, fromState?: State) => boolean>\n>();\n\nexport function getCachedShouldUpdate(\n  router: Router,\n  nodeName: string,\n): (toState: State, fromState?: State) => boolean {\n  let routerCache = shouldUpdateCache.get(router);\n\n  if (!routerCache) {\n    routerCache = new Map();\n    shouldUpdateCache.set(router, routerCache);\n  }\n\n  let fn = routerCache.get(nodeName);\n\n  if (!fn) {\n    fn = router.shouldUpdateNode(nodeName);\n    routerCache.set(nodeName, fn);\n  }\n\n  return fn;\n}\n","import { BaseSource } from \"./BaseSource\";\nimport { computeSnapshot } from \"./computeSnapshot.js\";\nimport { getCachedShouldUpdate } from \"./shouldUpdateCache.js\";\n\nimport type { RouteNodeSnapshot, RouterSource } from \"./types.js\";\nimport type { Router } from \"@real-router/core\";\n\n/**\n * Creates a source scoped to a specific route node.\n *\n * Uses a lazy-connection pattern: the router subscription is created when the\n * first listener subscribes and removed when the last listener unsubscribes.\n * This is compatible with React's useSyncExternalStore and Strict Mode.\n */\nexport function createRouteNodeSource(\n  router: Router,\n  nodeName: string,\n): RouterSource<RouteNodeSnapshot> {\n  let routerUnsubscribe: (() => void) | null = null;\n\n  const shouldUpdate = getCachedShouldUpdate(router, nodeName);\n\n  const initialSnapshot: RouteNodeSnapshot = {\n    route: undefined,\n    previousRoute: undefined,\n  };\n\n  const disconnect = (): void => {\n    const unsub = routerUnsubscribe;\n\n    routerUnsubscribe = null;\n    unsub?.();\n  };\n\n  const source = new BaseSource<RouteNodeSnapshot>(\n    computeSnapshot(initialSnapshot, router, nodeName),\n    {\n      onFirstSubscribe: () => {\n        // Reconcile snapshot with current router state before connecting.\n        // Covers reconnection after Activity hide/show cycles where the\n        // source was disconnected and missed navigation events.\n        source.updateSnapshot(\n          computeSnapshot(source.getSnapshot(), router, nodeName),\n        );\n\n        // Connect to router on first subscription\n        routerUnsubscribe = router.subscribe((next) => {\n          if (!shouldUpdate(next.route, next.previousRoute)) {\n            return;\n          }\n\n          const newSnapshot = computeSnapshot(\n            source.getSnapshot(),\n            router,\n            nodeName,\n            next,\n          );\n\n          /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */\n          if (!Object.is(source.getSnapshot(), newSnapshot)) {\n            source.updateSnapshot(newSnapshot);\n          }\n        });\n      },\n      onLastUnsubscribe: disconnect,\n      onDestroy: disconnect,\n    },\n  );\n\n  return source;\n}\n","import { areRoutesRelated } from \"@real-router/route-utils\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { ActiveRouteSourceOptions, RouterSource } from \"./types.js\";\nimport type { Params, Router } from \"@real-router/core\";\n\nexport function createActiveRouteSource(\n  router: Router,\n  routeName: string,\n  params?: Params,\n  options?: ActiveRouteSourceOptions,\n): RouterSource<boolean> {\n  const strict = options?.strict ?? false;\n  const ignoreQueryParams = options?.ignoreQueryParams ?? true;\n\n  const initialValue = router.isActiveRoute(\n    routeName,\n    params,\n    strict,\n    ignoreQueryParams,\n  );\n\n  const source = new BaseSource(initialValue, {\n    onDestroy: () => {\n      unsubscribe();\n    },\n  });\n\n  // Eager connection: subscribe to router immediately\n  const unsubscribe = router.subscribe((next) => {\n    const isNewRelated = areRoutesRelated(routeName, next.route.name);\n    const isPrevRelated =\n      next.previousRoute &&\n      areRoutesRelated(routeName, next.previousRoute.name);\n\n    if (!isNewRelated && !isPrevRelated) {\n      return;\n    }\n\n    // If new route is not related, we know the route is inactive —\n    // avoid calling isActiveRoute for the optimization\n    const newValue = isNewRelated\n      ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)\n      : false;\n\n    if (!Object.is(source.getSnapshot(), newValue)) {\n      source.updateSnapshot(newValue);\n    }\n  });\n\n  return source;\n}\n","import { getPluginApi, events } from \"@real-router/core\";\n\nimport { BaseSource } from \"./BaseSource\";\n\nimport type { RouterTransitionSnapshot, RouterSource } from \"./types.js\";\nimport type { Router, State } from \"@real-router/core\";\n\nconst IDLE_SNAPSHOT: RouterTransitionSnapshot = {\n  isTransitioning: false,\n  toRoute: null,\n  fromRoute: null,\n};\n\nexport function createTransitionSource(\n  router: Router,\n): RouterSource<RouterTransitionSnapshot> {\n  const source = new BaseSource(IDLE_SNAPSHOT, {\n    onDestroy: () => {\n      unsubs.forEach((u) => {\n        u();\n      });\n    },\n  });\n\n  const api = getPluginApi(router);\n\n  const resetToIdle = (): void => {\n    source.updateSnapshot(IDLE_SNAPSHOT);\n  };\n\n  // Eager connection: subscribe to router events immediately\n  const unsubs = [\n    api.addEventListener(\n      events.TRANSITION_START,\n      (toState: State, fromState?: State) => {\n        source.updateSnapshot({\n          isTransitioning: true,\n          toRoute: toState,\n          fromRoute: fromState ?? null,\n        });\n      },\n    ),\n    api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),\n    api.addEventListener(events.TRANSITION_ERROR, resetToIdle),\n    api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),\n  ];\n\n  return source;\n}\n"]}

package/dist/esm/metafile-esm.json

@@ -1 +1 @@
-{"inputs":{"src/createRouteSource.ts":{"bytes":1956,"imports":[],"format":"esm"},"src/BaseSource.ts":{"bytes":941,"imports":[],"format":"esm"},"src/computeSnapshot.ts":{"bytes":790,"imports":[],"format":"esm"},"src/shouldUpdateCache.ts":{"bytes":610,"imports":[],"format":"esm"},"src/createRouteNodeSource.ts":{"bytes":1911,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"src/computeSnapshot.ts","kind":"import-statement","original":"./computeSnapshot.js"},{"path":"src/shouldUpdateCache.ts","kind":"import-statement","original":"./shouldUpdateCache.js"}],"format":"esm"},"src/createActiveRouteSource.ts":{"bytes":2124,"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"}],"format":"esm"},"src/createTransitionSource.ts":{"bytes":1845,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"}],"format":"esm"},"src/index.ts":{"bytes":407,"imports":[{"path":"src/createRouteSource.ts","kind":"import-statement","original":"./createRouteSource"},{"path":"src/createRouteNodeSource.ts","kind":"import-statement","original":"./createRouteNodeSource"},{"path":"src/createActiveRouteSource.ts","kind":"import-statement","original":"./createActiveRouteSource"},{"path":"src/createTransitionSource.ts","kind":"import-statement","original":"./createTransitionSource"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15986},"dist/esm/index.mjs":{"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["createActiveRouteSource","createRouteNodeSource","createRouteSource","createTransitionSource"],"entryPoint":"src/index.ts","inputs":{"src/createRouteSource.ts":{"bytesInOutput":1303},"src/index.ts":{"bytesInOutput":0},"src/BaseSource.ts":{"bytesInOutput":752},"src/computeSnapshot.ts":{"bytesInOutput":536},"src/shouldUpdateCache.ts":{"bytesInOutput":425},"src/createRouteNodeSource.ts":{"bytesInOutput":1234},"src/createActiveRouteSource.ts":{"bytesInOutput":1490},"src/createTransitionSource.ts":{"bytesInOutput":1367}},"bytes":7679}}}
+{"inputs":{"src/BaseSource.ts":{"bytes":1857,"imports":[],"format":"esm"},"src/createRouteSource.ts":{"bytes":1168,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"}],"format":"esm"},"src/computeSnapshot.ts":{"bytes":790,"imports":[],"format":"esm"},"src/shouldUpdateCache.ts":{"bytes":610,"imports":[],"format":"esm"},"src/createRouteNodeSource.ts":{"bytes":2245,"imports":[{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"},{"path":"src/computeSnapshot.ts","kind":"import-statement","original":"./computeSnapshot.js"},{"path":"src/shouldUpdateCache.ts","kind":"import-statement","original":"./shouldUpdateCache.js"}],"format":"esm"},"src/createActiveRouteSource.ts":{"bytes":1461,"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"}],"format":"esm"},"src/createTransitionSource.ts":{"bytes":1278,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"src/BaseSource.ts","kind":"import-statement","original":"./BaseSource"}],"format":"esm"},"src/index.ts":{"bytes":407,"imports":[{"path":"src/createRouteSource.ts","kind":"import-statement","original":"./createRouteSource"},{"path":"src/createRouteNodeSource.ts","kind":"import-statement","original":"./createRouteNodeSource"},{"path":"src/createActiveRouteSource.ts","kind":"import-statement","original":"./createActiveRouteSource"},{"path":"src/createTransitionSource.ts","kind":"import-statement","original":"./createTransitionSource"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":14149},"dist/esm/index.mjs":{"imports":[{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true}],"exports":["createActiveRouteSource","createRouteNodeSource","createRouteSource","createTransitionSource"],"entryPoint":"src/index.ts","inputs":{"src/BaseSource.ts":{"bytesInOutput":1375},"src/createRouteSource.ts":{"bytesInOutput":627},"src/index.ts":{"bytesInOutput":0},"src/computeSnapshot.ts":{"bytesInOutput":536},"src/shouldUpdateCache.ts":{"bytesInOutput":425},"src/createRouteNodeSource.ts":{"bytesInOutput":1120},"src/createActiveRouteSource.ts":{"bytesInOutput":977},"src/createTransitionSource.ts":{"bytesInOutput":921}},"bytes":6553}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/sources",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "commonjs",
   "description": "Framework-agnostic subscription layer for Real-Router state",
   "main": "./dist/cjs/index.js",
@@ -43,7 +43,7 @@
   "homepage": "https://github.com/greydragon888/real-router",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.35.1",
+    "@real-router/core": "^0.35.2",
     "@real-router/route-utils": "^0.1.4"
   },
   "devDependencies": {
@@ -56,6 +56,8 @@
     "lint": "eslint --cache --ext .ts src/ tests/ --fix --max-warnings 0 --no-error-on-unmatched-pattern",
     "lint:package": "publint",
     "lint:types": "attw --pack .",
+    "test:properties": "vitest --config vitest.config.properties.mts --run",
+    "test:stress": "vitest run --config vitest.config.stress.mts",
     "bench": "NODE_OPTIONS='--expose-gc --max-old-space-size=4096' npx tsx tests/benchmarks/index.ts"
   }
 }

package/src/BaseSource.ts

@@ -1,11 +1,27 @@
+export interface BaseSourceOptions {
+  onFirstSubscribe?: () => void;
+  onLastUnsubscribe?: () => void;
+  onDestroy?: () => void;
+}
+
 export class BaseSource<T> {
   #currentSnapshot: T;
   #destroyed = false;
 
   readonly #listeners = new Set<() => void>();
+  readonly #onFirstSubscribe: (() => void) | undefined;
+  readonly #onLastUnsubscribe: (() => void) | undefined;
+  readonly #onDestroy: (() => void) | undefined;
 
-  constructor(initialSnapshot: T) {
+  constructor(initialSnapshot: T, options?: BaseSourceOptions) {
     this.#currentSnapshot = initialSnapshot;
+    this.#onFirstSubscribe = options?.onFirstSubscribe;
+    this.#onLastUnsubscribe = options?.onLastUnsubscribe;
+    this.#onDestroy = options?.onDestroy;
+
+    this.subscribe = this.subscribe.bind(this);
+    this.getSnapshot = this.getSnapshot.bind(this);
+    this.destroy = this.destroy.bind(this);
   }
 
   subscribe(listener: () => void): () => void {
@@ -13,10 +29,22 @@ export class BaseSource<T> {
       return () => {};
     }
 
+    if (this.#listeners.size === 0 && this.#onFirstSubscribe) {
+      this.#onFirstSubscribe();
+    }
+
     this.#listeners.add(listener);
 
     return () => {
       this.#listeners.delete(listener);
+
+      if (
+        !this.#destroyed &&
+        this.#listeners.size === 0 &&
+        this.#onLastUnsubscribe
+      ) {
+        this.#onLastUnsubscribe();
+      }
     };
   }
 
@@ -42,6 +70,7 @@ export class BaseSource<T> {
     }
 
     this.#destroyed = true;
+    this.#onDestroy?.();
     this.#listeners.clear();
   }
 }

package/src/createActiveRouteSource.ts

@@ -5,73 +5,49 @@ import { BaseSource } from "./BaseSource";
 import type { ActiveRouteSourceOptions, RouterSource } from "./types.js";
 import type { Params, Router } from "@real-router/core";
 
-class ActiveRouteSource implements RouterSource<boolean> {
-  readonly #source: BaseSource<boolean>;
-  readonly #unsubscribe: () => void;
-
-  constructor(
-    router: Router,
-    routeName: string,
-    params?: Params,
-    options?: ActiveRouteSourceOptions,
-  ) {
-    const strict = options?.strict ?? false;
-    const ignoreQueryParams = options?.ignoreQueryParams ?? true;
-
-    const initialValue = router.isActiveRoute(
-      routeName,
-      params,
-      strict,
-      ignoreQueryParams,
-    );
-
-    this.#source = new BaseSource(initialValue);
-
-    this.#unsubscribe = router.subscribe((next) => {
-      const isNewRelated = areRoutesRelated(routeName, next.route.name);
-      const isPrevRelated =
-        next.previousRoute &&
-        areRoutesRelated(routeName, next.previousRoute.name);
-
-      if (!isNewRelated && !isPrevRelated) {
-        return;
-      }
-
-      // If new route is not related, we know the route is inactive —
-      // avoid calling isActiveRoute for the optimization
-      const newValue = isNewRelated
-        ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)
-        : false;
-
-      if (!Object.is(this.#source.getSnapshot(), newValue)) {
-        this.#source.updateSnapshot(newValue);
-      }
-    });
-
-    this.subscribe = this.subscribe.bind(this);
-    this.getSnapshot = this.getSnapshot.bind(this);
-    this.destroy = this.destroy.bind(this);
-  }
-
-  subscribe(listener: () => void): () => void {
-    return this.#source.subscribe(listener);
-  }
-
-  getSnapshot(): boolean {
-    return this.#source.getSnapshot();
-  }
-
-  destroy(): void {
-    this.#unsubscribe();
-    this.#source.destroy();
-  }
-}
-
 export function createActiveRouteSource(
   router: Router,
   routeName: string,
   params?: Params,
   options?: ActiveRouteSourceOptions,
 ): RouterSource<boolean> {
-  return new ActiveRouteSource(router, routeName, params, options);
+  const strict = options?.strict ?? false;
+  const ignoreQueryParams = options?.ignoreQueryParams ?? true;
+
+  const initialValue = router.isActiveRoute(
+    routeName,
+    params,
+    strict,
+    ignoreQueryParams,
+  );
+
+  const source = new BaseSource(initialValue, {
+    onDestroy: () => {
+      unsubscribe();
+    },
+  });
+
+  // Eager connection: subscribe to router immediately
+  const unsubscribe = router.subscribe((next) => {
+    const isNewRelated = areRoutesRelated(routeName, next.route.name);
+    const isPrevRelated =
+      next.previousRoute &&
+      areRoutesRelated(routeName, next.previousRoute.name);
+
+    if (!isNewRelated && !isPrevRelated) {
+      return;
+    }
+
+    // If new route is not related, we know the route is inactive —
+    // avoid calling isActiveRoute for the optimization
+    const newValue = isNewRelated
+      ? router.isActiveRoute(routeName, params, strict, ignoreQueryParams)
+      : false;
+
+    if (!Object.is(source.getSnapshot(), newValue)) {
+      source.updateSnapshot(newValue);
+    }
+  });
+
+  return source;
 }

package/src/createRouteNodeSource.ts

@@ -5,60 +5,67 @@ import { getCachedShouldUpdate } from "./shouldUpdateCache.js";
 import type { RouteNodeSnapshot, RouterSource } from "./types.js";
 import type { Router } from "@real-router/core";
 
-class RouteNodeSource implements RouterSource<RouteNodeSnapshot> {
-  readonly #source: BaseSource<RouteNodeSnapshot>;
-  readonly #unsubscribe: () => void;
-
-  constructor(router: Router, nodeName: string) {
-    const initialSnapshot: RouteNodeSnapshot = {
-      route: undefined,
-      previousRoute: undefined,
-    };
-    const computedInitial = computeSnapshot(initialSnapshot, router, nodeName);
+/**
+ * Creates a source scoped to a specific route node.
+ *
+ * Uses a lazy-connection pattern: the router subscription is created when the
+ * first listener subscribes and removed when the last listener unsubscribes.
+ * This is compatible with React's useSyncExternalStore and Strict Mode.
+ */
+export function createRouteNodeSource(
+  router: Router,
+  nodeName: string,
+): RouterSource<RouteNodeSnapshot> {
+  let routerUnsubscribe: (() => void) | null = null;
 
-    this.#source = new BaseSource(computedInitial);
-    const shouldUpdate = getCachedShouldUpdate(router, nodeName);
+  const shouldUpdate = getCachedShouldUpdate(router, nodeName);
 
-    this.#unsubscribe = router.subscribe((next) => {
-      if (!shouldUpdate(next.route, next.previousRoute)) {
-        return;
-      }
+  const initialSnapshot: RouteNodeSnapshot = {
+    route: undefined,
+    previousRoute: undefined,
+  };
 
-      const newSnapshot = computeSnapshot(
-        this.#source.getSnapshot(),
-        router,
-        nodeName,
-        next,
-      );
+  const disconnect = (): void => {
+    const unsub = routerUnsubscribe;
 
-      /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */
-      if (!Object.is(this.#source.getSnapshot(), newSnapshot)) {
-        this.#source.updateSnapshot(newSnapshot);
-      }
-    });
+    routerUnsubscribe = null;
+    unsub?.();
+  };
 
-    this.subscribe = this.subscribe.bind(this);
-    this.getSnapshot = this.getSnapshot.bind(this);
-    this.destroy = this.destroy.bind(this);
-  }
+  const source = new BaseSource<RouteNodeSnapshot>(
+    computeSnapshot(initialSnapshot, router, nodeName),
+    {
+      onFirstSubscribe: () => {
+        // Reconcile snapshot with current router state before connecting.
+        // Covers reconnection after Activity hide/show cycles where the
+        // source was disconnected and missed navigation events.
+        source.updateSnapshot(
+          computeSnapshot(source.getSnapshot(), router, nodeName),
+        );
 
-  subscribe(listener: () => void): () => void {
-    return this.#source.subscribe(listener);
-  }
+        // Connect to router on first subscription
+        routerUnsubscribe = router.subscribe((next) => {
+          if (!shouldUpdate(next.route, next.previousRoute)) {
+            return;
+          }
 
-  getSnapshot(): RouteNodeSnapshot {
-    return this.#source.getSnapshot();
-  }
+          const newSnapshot = computeSnapshot(
+            source.getSnapshot(),
+            router,
+            nodeName,
+            next,
+          );
 
-  destroy(): void {
-    this.#unsubscribe();
-    this.#source.destroy();
-  }
-}
+          /* v8 ignore next 3 -- @preserve: dedup guard; shouldUpdateNode filters accurately so computeSnapshot always returns new ref */
+          if (!Object.is(source.getSnapshot(), newSnapshot)) {
+            source.updateSnapshot(newSnapshot);
+          }
+        });
+      },
+      onLastUnsubscribe: disconnect,
+      onDestroy: disconnect,
+    },
+  );
 
-export function createRouteNodeSource(
-  router: Router,
-  nodeName: string,
-): RouterSource<RouteNodeSnapshot> {
-  return new RouteNodeSource(router, nodeName);
+  return source;
 }

package/src/createRouteSource.ts

@@ -1,66 +1,8 @@
+import { BaseSource } from "./BaseSource";
+
 import type { RouteSnapshot, RouterSource } from "./types.js";
 import type { Router } from "@real-router/core";
 
-class RouteSource implements RouterSource<RouteSnapshot> {
-  #routerUnsubscribe: (() => void) | null = null;
-  #currentSnapshot: RouteSnapshot;
-
-  readonly #listeners = new Set<() => void>();
-  readonly #router: Router;
-
-  constructor(router: Router) {
-    this.#router = router;
-
-    this.#currentSnapshot = {
-      route: router.getState(),
-      previousRoute: undefined,
-    };
-
-    this.subscribe = this.subscribe.bind(this);
-    this.destroy = this.destroy.bind(this);
-    this.getSnapshot = this.getSnapshot.bind(this);
-  }
-
-  subscribe(listener: () => void): () => void {
-    if (this.#listeners.size === 0) {
-      // Connect to router on first subscription
-      this.#routerUnsubscribe = this.#router.subscribe((next) => {
-        this.#currentSnapshot = {
-          route: next.route,
-          previousRoute: next.previousRoute,
-        };
-        this.#listeners.forEach((cb) => {
-          cb();
-        });
-      });
-    }
-
-    this.#listeners.add(listener);
-
-    return () => {
-      this.#listeners.delete(listener);
-
-      if (this.#listeners.size === 0 && this.#routerUnsubscribe) {
-        this.#routerUnsubscribe();
-        this.#routerUnsubscribe = null;
-      }
-    };
-  }
-
-  getSnapshot(): RouteSnapshot {
-    return this.#currentSnapshot;
-  }
-
-  destroy(): void {
-    if (this.#routerUnsubscribe) {
-      this.#routerUnsubscribe();
-      this.#routerUnsubscribe = null;
-    }
-
-    this.#listeners.clear();
-  }
-}
-
 /**
  * Creates a source for the full route state.
  *
@@ -69,5 +11,33 @@ class RouteSource implements RouterSource<RouteSnapshot> {
  * This is compatible with React's useSyncExternalStore and Strict Mode.
  */
 export function createRouteSource(router: Router): RouterSource<RouteSnapshot> {
-  return new RouteSource(router);
+  let routerUnsubscribe: (() => void) | null = null;
+
+  const disconnect = (): void => {
+    const unsub = routerUnsubscribe;
+
+    routerUnsubscribe = null;
+    unsub?.();
+  };
+
+  const source = new BaseSource<RouteSnapshot>(
+    {
+      route: router.getState(),
+      previousRoute: undefined,
+    },
+    {
+      onFirstSubscribe: () => {
+        routerUnsubscribe = router.subscribe((next) => {
+          source.updateSnapshot({
+            route: next.route,
+            previousRoute: next.previousRoute,
+          });
+        });
+      },
+      onLastUnsubscribe: disconnect,
+      onDestroy: disconnect,
+    },
+  );
+
+  return source;
 }

package/src/createTransitionSource.ts

@@ -11,58 +11,39 @@ const IDLE_SNAPSHOT: RouterTransitionSnapshot = {
   fromRoute: null,
 };
 
-class TransitionSource implements RouterSource<RouterTransitionSnapshot> {
-  readonly #source: BaseSource<RouterTransitionSnapshot>;
-  readonly #unsubs: (() => void)[];
-
-  constructor(router: Router) {
-    this.#source = new BaseSource(IDLE_SNAPSHOT);
-
-    const api = getPluginApi(router);
-
-    const resetToIdle = (): void => {
-      this.#source.updateSnapshot(IDLE_SNAPSHOT);
-    };
-
-    this.#unsubs = [
-      api.addEventListener(
-        events.TRANSITION_START,
-        (toState: State, fromState?: State) => {
-          this.#source.updateSnapshot({
-            isTransitioning: true,
-            toRoute: toState,
-            fromRoute: fromState ?? null,
-          });
-        },
-      ),
-      api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),
-      api.addEventListener(events.TRANSITION_ERROR, resetToIdle),
-      api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),
-    ];
-
-    this.subscribe = this.subscribe.bind(this);
-    this.getSnapshot = this.getSnapshot.bind(this);
-    this.destroy = this.destroy.bind(this);
-  }
-
-  subscribe(listener: () => void): () => void {
-    return this.#source.subscribe(listener);
-  }
-
-  getSnapshot(): RouterTransitionSnapshot {
-    return this.#source.getSnapshot();
-  }
-
-  destroy(): void {
-    this.#unsubs.forEach((u) => {
-      u();
-    });
-    this.#source.destroy();
-  }
-}
-
 export function createTransitionSource(
   router: Router,
 ): RouterSource<RouterTransitionSnapshot> {
-  return new TransitionSource(router);
+  const source = new BaseSource(IDLE_SNAPSHOT, {
+    onDestroy: () => {
+      unsubs.forEach((u) => {
+        u();
+      });
+    },
+  });
+
+  const api = getPluginApi(router);
+
+  const resetToIdle = (): void => {
+    source.updateSnapshot(IDLE_SNAPSHOT);
+  };
+
+  // Eager connection: subscribe to router events immediately
+  const unsubs = [
+    api.addEventListener(
+      events.TRANSITION_START,
+      (toState: State, fromState?: State) => {
+        source.updateSnapshot({
+          isTransitioning: true,
+          toRoute: toState,
+          fromRoute: fromState ?? null,
+        });
+      },
+    ),
+    api.addEventListener(events.TRANSITION_SUCCESS, resetToIdle),
+    api.addEventListener(events.TRANSITION_ERROR, resetToIdle),
+    api.addEventListener(events.TRANSITION_CANCEL, resetToIdle),
+  ];
+
+  return source;
 }