@flemo/core 2.3.0 → 2.3.1

package/dist/core/__tests__/adoptEntryIdentity.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/createRouterScope.d.ts

@@ -31,7 +31,29 @@ export interface CreateRouterScopeInput {
     browserDriver: HistoryDriver | null;
     hostedScope: FlemoStores | null;
     persistKey?: string;
+    deferEntryAdoption?: boolean;
     routerKey?: string;
     zoneEntryId?: string;
 }
 export default function createRouterScope(input: CreateRouterScopeInput): FlemoStores;
+/**
+ * Adopt the identity of the browser entry this scope was seeded on, after the
+ * fact — the deferred half of `deferEntryAdoption`.
+ *
+ * A binding that hydrates calls this once hydration is over, and the store's
+ * root frame stops being the generic "root" and becomes the entry it is
+ * actually sitting on. That matters for exactly the reason the construction
+ * path adopts at all: a traversal back onto this entry has to match it by id
+ * rather than collide with every other scope's "root".
+ *
+ * Every guard below is a refusal to overwrite something real:
+ *
+ *   - a scope that already navigated has a stack this is not the seed of, and
+ *     rewriting its first frame's id would rename an entry the user has since
+ *     left,
+ *   - a seed that is no longer "root" was adopted already (a re-run, a strict
+ *     mode double effect),
+ *   - a memory scope has no browser entry to adopt, and
+ *   - an entry with no frame of its own has no identity to take.
+ */
+export declare function adoptEntryIdentity(scope: FlemoStores): void;

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { default as createNavigateStore, type NavigateStatus, type NavigateStore
 export { markSelfInducedPop, consumeSelfInducedPop, createSelfPopGuard, type SelfPopGuard } from './navigate/selfPopGuard';
 export { default as createNavigationController, type NavigationControllerDeps, type DistanceOptions, type NavigateOptions, type PopOptions } from './navigate/createNavigationController';
 export { default as createStepController, readStepParams, appendParamsQuery, subscribeStepParamsRestore, type StepControllerDeps } from './navigate/createStepController';
-export { default as createRouterScope, type FlemoStores, type CreateRouterScopeInput } from './core/createRouterScope';
+export { default as createRouterScope, adoptEntryIdentity, type FlemoStores, type CreateRouterScopeInput } from './core/createRouterScope';
 export { default as createScreenStore, type ScreenStore, type ScreenStoreApi, type SharedBarPresence, type SharedBarId, type SharedBarMetadata, type SharedBarsMetadata, type ScreenSurface } from './screen/store';
 export { default as createScreenSelector, type ScreenSelection } from './screen/createScreenSelector';
 export { default as computeScreenFreeze, computeScreenFreezeMode, type ScreenFreezeInput, type ScreenFreezeMode } from './screen/computeScreenFreeze';