@real-router/core 0.137.0 → 0.138.0

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{_ as e,g as t,h as n,p as r,t as i}from"./RouterError-gEM9-BIR.mjs";import{t as a,v as o}from"./Router-gqs3sqc3.mjs";const s=(e=[],t={},n={})=>new a(e,t,n),c=Object.freeze,l=new WeakMap,u=e=>{let t=l.get(e);return t||(t=c({navigate:e.navigate,getState:e.getState,isActiveRoute:e.isActiveRoute,canNavigateTo:e.canNavigateTo,subscribe:e.subscribe,subscribeLeave:e.subscribeLeave,isLeaveApproved:e.isLeaveApproved}),l.set(e,t)),t};export{a as Router,i as RouterError,r as UNKNOWN_ROUTE,n as constants,s as createRouter,t as errorCodes,e as events,u as getNavigator,o as resolveForwardChain};
+import{_ as e,g as t,h as n,p as r,t as i}from"./RouterError-gEM9-BIR.mjs";import{t as a,v as o}from"./Router-wP8zsFbT.mjs";const s=(e=[],t={},n={})=>new a(e,t,n),c=Object.freeze,l=new WeakMap,u=e=>{let t=l.get(e);return t||(t=c({navigate:e.navigate,getState:e.getState,isActiveRoute:e.isActiveRoute,canNavigateTo:e.canNavigateTo,subscribe:e.subscribe,subscribeLeave:e.subscribeLeave,isLeaveApproved:e.isLeaveApproved}),l.set(e,t)),t};export{a as Router,i as RouterError,r as UNKNOWN_ROUTE,n as constants,s as createRouter,t as errorCodes,e as events,u as getNavigator,o as resolveForwardChain};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/types/tree-changed.d.mts

@@ -109,12 +109,27 @@ export interface TreeChangedClear<Dependencies extends DefaultDependencies = Def
    */
   readonly removed: readonly ReadonlyRoute<Dependencies>[];
 }
+export interface TreeChangedRootPath {
+  readonly op: "rootPath";
+  /** The root in force before the change. `""` when none was set. */
+  readonly previous: string;
+  /** The root now in force — what `getRootPath()` answers. */
+  readonly next: string;
+}
 /**
  * Discriminated union (by `op`) describing a single structural route-tree
  * mutation. Consumers should `switch (event.op)` with an exhaustive `default`
  * — do not rely on `Object.keys(event)`, array ordering, or absence of future
  * fields (see Invariant 11 in `.claude/rfc-tree-mutation-event.md`).
+ *
+ * ⚑ **`rootPath` carries no routes, and that is the member's point (#1752).**
+ * Every other op names routes that appeared, left or changed; this one names a
+ * move that leaves every route in place and sends every one of them to a new
+ * URL. A consumer keyed by route NAME can ignore it — and both such consumers
+ * in this repository do. A consumer keyed by `href` cannot: `preload-plugin`'s
+ * `default` branch exists to drop snapshots on "any structural mutation", and
+ * this is the mutation that restales all of them at once.
  */
-export type TreeChangedEvent<Dependencies extends DefaultDependencies = DefaultDependencies> = TreeChangedAdd<Dependencies> | TreeChangedRemove<Dependencies> | TreeChangedUpdate<Dependencies> | TreeChangedReplace<Dependencies> | TreeChangedClear<Dependencies>;
+export type TreeChangedEvent<Dependencies extends DefaultDependencies = DefaultDependencies> = TreeChangedAdd<Dependencies> | TreeChangedRemove<Dependencies> | TreeChangedUpdate<Dependencies> | TreeChangedReplace<Dependencies> | TreeChangedRootPath | TreeChangedClear<Dependencies>;
 //#endregion
 //# sourceMappingURL=tree-changed.d.mts.map

package/dist/esm/types/tree-changed.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-changed.d.mts","names":[],"sources":["../../../src/types/tree-changed.ts"],"mappings":";;;;;;;;;;YA0BY,oBACV,qBAAqB,sBAAsB,uBACzC,KACF,kBAAkB;iBAQH,eACf,qBAAqB,sBAAsB;WAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgCA,gBAAgB,cAAc;;WAE9B;;iBAGM,kBACf,qBAAqB,sBAAsB;WAElC;WACA;;;;;;;;;;;;WAYA,yBAAyB,cAAc;;iBAGjC,kBACf,qBAAqB,sBAAsB;WAElC;WACA;;;;;;;;;;;WAWA,OAAO,SAAS,oBAAoB;;iBAG9B,mBACf,qBAAqB,sBAAsB;WAElC;;;;;;;;WAQA,kBAAkB,cAAc;;;;;;;;WAQhC,gBAAgB,cAAc;;iBAGxB,iBACf,qBAAqB,sBAAsB;WAElC;;;;;;;;;;WAUA,kBAAkB,cAAc;;;;;;;;YAS/B,iBACV,qBAAqB,sBAAsB,uBAEzC,eAAe,gBACf,kBAAkB,gBAClB,kBAAkB,gBAClB,mBAAmB,gBACnB,iBAAiB"}
+{"version":3,"file":"tree-changed.d.mts","names":[],"sources":["../../../src/types/tree-changed.ts"],"mappings":";;;;;;;;;;YA0BY,oBACV,qBAAqB,sBAAsB,uBACzC,KACF,kBAAkB;iBAQH,eACf,qBAAqB,sBAAsB;WAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAgCA,gBAAgB,cAAc;;WAE9B;;iBAGM,kBACf,qBAAqB,sBAAsB;WAElC;WACA;;;;;;;;;;;;WAYA,yBAAyB,cAAc;;iBAGjC,kBACf,qBAAqB,sBAAsB;WAElC;WACA;;;;;;;;;;;WAWA,OAAO,SAAS,oBAAoB;;iBAG9B,mBACf,qBAAqB,sBAAsB;WAElC;;;;;;;;WAQA,kBAAkB,cAAc;;;;;;;;WAQhC,gBAAgB,cAAc;;iBAGxB,iBACf,qBAAqB,sBAAsB;WAElC;;;;;;;;;;WAUA,kBAAkB,cAAc;;iBAG1B;WACN;;WAEA;;WAEA;;;;;;;;;;;;;;;;YAiBC,iBACV,qBAAqB,sBAAsB,uBAEzC,eAAe,gBACf,kBAAkB,gBAClB,kBAAkB,gBAClB,mBAAmB,gBACnB,sBACA,iBAAiB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/core",
-  "version": "0.137.0",
+  "version": "0.138.0",
   "type": "commonjs",
   "description": "A simple, powerful, view-agnostic, modular and extensible router",
   "main": "./dist/cjs/index.js",