@passflow/react 0.15.1 → 0.16.0

package/dist/src/components/flow/index.d.cts

@@ -1,5 +1,5 @@
 export { ConsentFlow } from './consent/index.cjs';
 export { DeviceVerifyFlow } from './device-verify/index.cjs';
-export { PassflowFlow, type PassflowProps } from './passflow/index.cjs';
+export { PassflowFlow, type PassflowFlowLocation, type PassflowFlowNavigate, type PassflowProps } from './passflow/index.cjs';
 export { TwoFactorSetupMagicLinkFlow, type TwoFactorSetupMagicLinkFlowProps } from './two-factor-setup-magic-link/index.cjs';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/flow/index.d.ts

@@ -1,5 +1,5 @@
 export { ConsentFlow } from './consent/index.js';
 export { DeviceVerifyFlow } from './device-verify/index.js';
-export { PassflowFlow, type PassflowProps } from './passflow/index.js';
+export { PassflowFlow, type PassflowFlowLocation, type PassflowFlowNavigate, type PassflowProps } from './passflow/index.js';
 export { TwoFactorSetupMagicLinkFlow, type TwoFactorSetupMagicLinkFlowProps } from './two-factor-setup-magic-link/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/flow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,KAAK,gCAAgC,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,2BAA2B,EAAE,KAAK,gCAAgC,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/components/flow/passflow/flow-router.d.cts

@@ -0,0 +1,39 @@
+export type FlowLocation = {
+    pathname: string;
+    search: string;
+};
+export type FlowNavigateOptions = {
+    replace: boolean;
+};
+export type FlowNavigate = (location: FlowLocation, options: FlowNavigateOptions) => void;
+export type FlowHistory = {
+    /** The current location. Returns the same object until the location changes. */
+    read: () => FlowLocation;
+    subscribe: (listener: () => void) => () => void;
+    navigate: FlowNavigate;
+};
+/** The screens PassflowFlow renders, keyed as in `routes`. */
+export declare const FLOW_SCREENS: readonly ["signin", "signup", "verify_otp", "verify_magic_link", "forgot_password", "forgot_password_success", "reset_password", "invitation", "two_factor_verify", "two_factor_setup", "two_factor_setup_magic_link"];
+export type FlowScreen = (typeof FLOW_SCREENS)[number];
+export type FlowMatch = {
+    screen: FlowScreen;
+    params: Record<string, string>;
+};
+/** `'/auth/'` → `'/auth'`, `'auth'` → `'/auth'`, `'/'` or `''` → `''`. */
+export declare const normalizePrefix: (prefix: string | undefined) => string;
+/** The screen at `pathname` under `prefix`, or null when the path is not one of the flow's screens. */
+export declare const matchScreen: (pathname: string, prefix: string) => FlowMatch | null;
+/**
+ * Where the flow is mounted, worked out from the first URL it sees: the part in
+ * front of a screen path (`/auth/signin` → `/auth`), or the whole path when it
+ * names no screen (`/auth` → `/auth`, `/` → `''`).
+ */
+export declare const detectPrefix: (pathname: string) => string;
+/** The absolute path of a screen under `prefix`; `params` fill `:name` segments. */
+export declare const screenPath: (screen: FlowScreen, prefix: string, params?: Record<string, string>) => string;
+export declare const isUnderPrefix: (pathname: string, prefix: string) => boolean;
+export declare const withQuestionMark: (search: string) => string;
+export declare const createBrowserHistory: () => FlowHistory;
+export declare const createHashHistory: () => FlowHistory;
+export declare const createMemoryHistory: (initial?: FlowLocation) => FlowHistory;
+//# sourceMappingURL=flow-router.d.ts.map

package/dist/src/components/flow/passflow/flow-router.d.ts

@@ -0,0 +1,39 @@
+export type FlowLocation = {
+    pathname: string;
+    search: string;
+};
+export type FlowNavigateOptions = {
+    replace: boolean;
+};
+export type FlowNavigate = (location: FlowLocation, options: FlowNavigateOptions) => void;
+export type FlowHistory = {
+    /** The current location. Returns the same object until the location changes. */
+    read: () => FlowLocation;
+    subscribe: (listener: () => void) => () => void;
+    navigate: FlowNavigate;
+};
+/** The screens PassflowFlow renders, keyed as in `routes`. */
+export declare const FLOW_SCREENS: readonly ["signin", "signup", "verify_otp", "verify_magic_link", "forgot_password", "forgot_password_success", "reset_password", "invitation", "two_factor_verify", "two_factor_setup", "two_factor_setup_magic_link"];
+export type FlowScreen = (typeof FLOW_SCREENS)[number];
+export type FlowMatch = {
+    screen: FlowScreen;
+    params: Record<string, string>;
+};
+/** `'/auth/'` → `'/auth'`, `'auth'` → `'/auth'`, `'/'` or `''` → `''`. */
+export declare const normalizePrefix: (prefix: string | undefined) => string;
+/** The screen at `pathname` under `prefix`, or null when the path is not one of the flow's screens. */
+export declare const matchScreen: (pathname: string, prefix: string) => FlowMatch | null;
+/**
+ * Where the flow is mounted, worked out from the first URL it sees: the part in
+ * front of a screen path (`/auth/signin` → `/auth`), or the whole path when it
+ * names no screen (`/auth` → `/auth`, `/` → `''`).
+ */
+export declare const detectPrefix: (pathname: string) => string;
+/** The absolute path of a screen under `prefix`; `params` fill `:name` segments. */
+export declare const screenPath: (screen: FlowScreen, prefix: string, params?: Record<string, string>) => string;
+export declare const isUnderPrefix: (pathname: string, prefix: string) => boolean;
+export declare const withQuestionMark: (search: string) => string;
+export declare const createBrowserHistory: () => FlowHistory;
+export declare const createHashHistory: () => FlowHistory;
+export declare const createMemoryHistory: (initial?: FlowLocation) => FlowHistory;
+//# sourceMappingURL=flow-router.d.ts.map

package/dist/src/components/flow/passflow/flow-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-router.d.ts","sourceRoot":"","sources":["../../../../../src/components/flow/passflow/flow-router.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG;IACxB,gFAAgF;IAChF,IAAI,EAAE,MAAM,YAAY,CAAC;IACzB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,YAAY,wNAY4B,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AA4B/E,0EAA0E;AAC1E,eAAO,MAAM,eAAe,WAAY,MAAM,GAAG,SAAS,KAAG,MAG5D,CAAC;AAIF,uGAAuG;AACvG,eAAO,MAAM,WAAW,aAAc,MAAM,UAAU,MAAM,KAAG,SAAS,GAAG,IAW1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,aAAc,MAAM,KAAG,MAO/C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,UAAU,WAAY,UAAU,UAAU,MAAM,WAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAQ,MACc,CAAC;AAEpH,eAAO,MAAM,aAAa,aAAc,MAAM,UAAU,MAAM,YACa,CAAC;AAE5E,eAAO,MAAM,gBAAgB,WAAY,MAAM,WAAgE,CAAC;AAsBhH,eAAO,MAAM,oBAAoB,QAAO,WAWtC,CAAC;AASH,eAAO,MAAM,iBAAiB,QAAO,WASnC,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAAa,YAAY,KAAmC,WAgB3F,CAAC"}

package/dist/src/components/flow/passflow/index.d.cts

@@ -1,16 +1,38 @@
 import type { SuccessAuthRedirect } from '../../../types/index.cjs';
-export type PassflowProps = {
+import { type FlowLocation, type FlowNavigate } from './flow-router.cjs';
+export type { FlowLocation as PassflowFlowLocation, FlowNavigate as PassflowFlowNavigate } from './flow-router.cjs';
+type PassflowBaseProps = {
     successAuthRedirect?: SuccessAuthRedirect;
     federatedDisplayMode?: 'modal' | 'redirect';
     error?: string;
     relyingPartyId?: string;
+    /**
+     * Where the flow is mounted, such as `/auth`: its screens are then `/auth/signin`,
+     * `/auth/signup`, and so on. Leave it out and the flow works it out from the first
+     * URL it sees (`/auth/signin` or `/auth` → `/auth`; `/` → none).
+     */
     pathPrefix?: string;
     /**
-     * The router the flow creates for itself. Ignored when the flow is rendered
-     * inside a host react-router `<Router>`: the flow then uses the host's router.
+     * The history the flow keeps when the app does not pass `location`. `browser`
+     * (the default) uses the address bar, on its own or inside the app's router;
+     * `hash` keeps the flow's path after `#`; `memory` leaves the URL alone.
      */
     routerType?: 'browser' | 'hash' | 'memory';
+    /** @deprecated Never had an effect. Use `pathPrefix`. */
     basename?: string;
 };
+export type PassflowProps = PassflowBaseProps & ({
+    location?: undefined;
+    navigate?: undefined;
+} | {
+    /**
+     * Full control: the app's router owns the location. Pass its current
+     * `{ pathname, search }` and a `navigate` that moves it; `routerType` is then
+     * not used. Not needed for an app router in browser mode, which the default
+     * already follows.
+     */
+    location: FlowLocation;
+    navigate: FlowNavigate;
+});
 export declare const PassflowFlow: (props: PassflowProps) => import("react").JSX.Element | null;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/flow/passflow/index.d.ts

@@ -1,16 +1,38 @@
 import type { SuccessAuthRedirect } from '../../../types/index.js';
-export type PassflowProps = {
+import { type FlowLocation, type FlowNavigate } from './flow-router.js';
+export type { FlowLocation as PassflowFlowLocation, FlowNavigate as PassflowFlowNavigate } from './flow-router.js';
+type PassflowBaseProps = {
     successAuthRedirect?: SuccessAuthRedirect;
     federatedDisplayMode?: 'modal' | 'redirect';
     error?: string;
     relyingPartyId?: string;
+    /**
+     * Where the flow is mounted, such as `/auth`: its screens are then `/auth/signin`,
+     * `/auth/signup`, and so on. Leave it out and the flow works it out from the first
+     * URL it sees (`/auth/signin` or `/auth` → `/auth`; `/` → none).
+     */
     pathPrefix?: string;
     /**
-     * The router the flow creates for itself. Ignored when the flow is rendered
-     * inside a host react-router `<Router>`: the flow then uses the host's router.
+     * The history the flow keeps when the app does not pass `location`. `browser`
+     * (the default) uses the address bar, on its own or inside the app's router;
+     * `hash` keeps the flow's path after `#`; `memory` leaves the URL alone.
      */
     routerType?: 'browser' | 'hash' | 'memory';
+    /** @deprecated Never had an effect. Use `pathPrefix`. */
     basename?: string;
 };
+export type PassflowProps = PassflowBaseProps & ({
+    location?: undefined;
+    navigate?: undefined;
+} | {
+    /**
+     * Full control: the app's router owns the location. Pass its current
+     * `{ pathname, search }` and a `navigate` that moves it; `routerType` is then
+     * not used. Not needed for an app router in browser mode, which the default
+     * already follows.
+     */
+    location: FlowLocation;
+    navigate: FlowNavigate;
+});
 export declare const PassflowFlow: (props: PassflowProps) => import("react").JSX.Element | null;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/flow/passflow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/flow/passflow/index.tsx"],"names":[],"mappings":"AAcA,OAAO,oBAAoB,CAAC;AAmB5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD,MAAM,MAAM,aAAa,GAAG;IAC1B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA6OF,eAAO,MAAM,YAAY,8DAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/flow/passflow/index.tsx"],"names":[],"mappings":"AAeA,OAAO,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAOL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAOlB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,YAAY,IAAI,oBAAoB,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEhH,KAAK,iBAAiB,GAAG;IACvB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CACI;IACE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;CACxB,CACJ,CAAC;AAuOJ,eAAO,MAAM,YAAY,8DAA6C,CAAC"}

package/dist/src/components/flow/two-factor-setup-magic-link/index.d.cts

@@ -8,6 +8,11 @@ type MagicLinkError = NonNullable<UseTwoFactorSetupMagicLinkReturn['error']>;
  * Props for TwoFactorSetupMagicLinkFlow component
  */
 export type TwoFactorSetupMagicLinkFlowProps = {
+    /**
+     * The magic-link token. Leave it out and it is read from the URL: the path
+     * segment after `/two-factor-setup-magic-link/` (or the same after `#`).
+     */
+    token?: string;
     /** Callback after successful setup */
     onSuccess?: () => void;
     /** Callback on validation error */
@@ -21,7 +26,7 @@ export type TwoFactorSetupMagicLinkFlowProps = {
  * Flow component for magic link 2FA setup
  *
  * This component:
- * 1. Extracts token from URL params
+ * 1. Takes the token from its `token` prop, or from the URL
  * 2. Validates token via useTwoFactorSetupMagicLink hook
  * 3. Shows loading state during validation
  * 4. Shows error UI if validation fails

package/dist/src/components/flow/two-factor-setup-magic-link/index.d.ts

@@ -8,6 +8,11 @@ type MagicLinkError = NonNullable<UseTwoFactorSetupMagicLinkReturn['error']>;
  * Props for TwoFactorSetupMagicLinkFlow component
  */
 export type TwoFactorSetupMagicLinkFlowProps = {
+    /**
+     * The magic-link token. Leave it out and it is read from the URL: the path
+     * segment after `/two-factor-setup-magic-link/` (or the same after `#`).
+     */
+    token?: string;
     /** Callback after successful setup */
     onSuccess?: () => void;
     /** Callback on validation error */
@@ -21,7 +26,7 @@ export type TwoFactorSetupMagicLinkFlowProps = {
  * Flow component for magic link 2FA setup
  *
  * This component:
- * 1. Extracts token from URL params
+ * 1. Takes the token from its `token` prop, or from the URL
  * 2. Validates token via useTwoFactorSetupMagicLink hook
  * 3. Shows loading state during validation
  * 4. Shows error UI if validation fails

package/dist/src/components/flow/two-factor-setup-magic-link/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/flow/two-factor-setup-magic-link/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAOhC,OAAO,EAAE,KAAK,gCAAgC,EAA6C,MAAM,SAAS,CAAC;AAE3G,OAAO,oBAAoB,CAAC;AAE5B;;GAEG;AACH,KAAK,cAAc,GAAG,WAAW,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,EAAE,CAAC,gCAAgC,CAsH5E,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/flow/two-factor-setup-magic-link/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAMhC,OAAO,EAAE,KAAK,gCAAgC,EAA6C,MAAM,SAAS,CAAC;AAE3G,OAAO,oBAAoB,CAAC;AAE5B;;GAEG;AACH,KAAK,cAAc,GAAG,WAAW,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAeF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,EAAE,CAAC,gCAAgC,CAuH5E,CAAC"}

package/dist/src/components/form/forgot-password/forgot-password.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forgot-password.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/forgot-password/forgot-password.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,EAAW,MAAM,OAAO,CAAC;AASzC,OAAO,oBAAoB,CAAC;AAY5B,KAAK,eAAe,GAAG;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,eAAe,CA+L9C,CAAC"}
+{"version":3,"file":"forgot-password.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/forgot-password/forgot-password.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,EAAW,MAAM,OAAO,CAAC;AASzC,OAAO,oBAAoB,CAAC;AAY5B,KAAK,eAAe,GAAG;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,eAAe,CAgM9C,CAAC"}

package/dist/src/components/form/invitation-join/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/invitation-join/index.tsx"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAAG;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA2EF,eAAO,MAAM,cAAc,oEAAgD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/invitation-join/index.tsx"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAAG;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA4EF,eAAO,MAAM,cAAc,oEAAgD,CAAC"}

package/dist/src/components/form/signin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/signin/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAkDnD,MAAM,MAAM,OAAO,GAAG;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,OAAO,CAwLlC,CAAC;AAEF,eAAO,MAAM,MAAM,wDAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/signin/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAkDnD,MAAM,MAAM,OAAO,GAAG;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,OAAO,CAyLlC,CAAC;AAEF,eAAO,MAAM,MAAM,wDAAwC,CAAC"}

package/dist/src/components/form/signup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/signup/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAsDlE,MAAM,MAAM,OAAO,GAAG;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,OAAO,CAsKlC,CAAC;AAEF,eAAO,MAAM,MAAM,wDAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/signup/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAsDlE,MAAM,MAAM,OAAO,GAAG;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,OAAO,CAuKlC,CAAC;AAEF,eAAO,MAAM,MAAM,wDAAwC,CAAC"}

package/dist/src/context/index.d.cts

@@ -2,5 +2,6 @@ export * from './auth-context.cjs';
 export * from './navigation-context.cjs';
 export * from './passflow-context.cjs';
 export * from './router-context.cjs';
+export * from './search-context.cjs';
 export * from './upgrade-context.cjs';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/context/index.d.ts

@@ -2,5 +2,6 @@ export * from './auth-context.js';
 export * from './navigation-context.js';
 export * from './passflow-context.js';
 export * from './router-context.js';
+export * from './search-context.js';
 export * from './upgrade-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/src/context/search-context.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Where the forms read and write their search params (`?challenge_id=…`).
+ *
+ * Outside PassflowFlow it is the address bar, as it always was. Inside, PassflowFlow
+ * provides its own location, so the forms see the right params when the flow keeps a
+ * memory or hash history, or is driven by an app router that does not use the address
+ * bar. In the default browser mode both are the same URL.
+ */
+export type SearchSource = {
+    /** The current search string, with its leading `?` or empty. */
+    read: () => string;
+    /** Moves to the same path with a new search string. */
+    write: (search: string, options: {
+        replace: boolean;
+    }) => void;
+};
+export declare const addressBarSearch: SearchSource;
+export declare const SearchContext: import("react").Context<SearchSource>;
+export declare const useSearchSource: () => SearchSource;
+//# sourceMappingURL=search-context.d.ts.map

package/dist/src/context/search-context.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where the forms read and write their search params (`?challenge_id=…`).
+ *
+ * Outside PassflowFlow it is the address bar, as it always was. Inside, PassflowFlow
+ * provides its own location, so the forms see the right params when the flow keeps a
+ * memory or hash history, or is driven by an app router that does not use the address
+ * bar. In the default browser mode both are the same URL.
+ */
+export type SearchSource = {
+    /** The current search string, with its leading `?` or empty. */
+    read: () => string;
+    /** Moves to the same path with a new search string. */
+    write: (search: string, options: {
+        replace: boolean;
+    }) => void;
+};
+export declare const addressBarSearch: SearchSource;
+export declare const SearchContext: import("react").Context<SearchSource>;
+export declare const useSearchSource: () => SearchSource;
+//# sourceMappingURL=search-context.d.ts.map

package/dist/src/context/search-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-context.d.ts","sourceRoot":"","sources":["../../../src/context/search-context.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,gEAAgE;IAChE,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,uDAAuD;IACvD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAO9B,CAAC;AAEF,eAAO,MAAM,aAAa,uCAAgD,CAAC;AAE3E,eAAO,MAAM,eAAe,oBAAkC,CAAC"}

package/dist/src/utils/url-params.d.cts

@@ -1,8 +1,6 @@
 /**
- * Utility for native handling of URL parameters
- */
-/**
- * Get URL parameters
+ * Get URL parameters. Inside PassflowFlow they come from the flow's location; outside it, from the
+ * address bar.
  * @param defaultValues Default values
  * @returns Object with methods getAll, get, set
  */

package/dist/src/utils/url-params.d.ts

@@ -1,8 +1,6 @@
 /**
- * Utility for native handling of URL parameters
- */
-/**
- * Get URL parameters
+ * Get URL parameters. Inside PassflowFlow they come from the flow's location; outside it, from the
+ * address bar.
  * @param defaultValues Default values
  * @returns Object with methods getAll, get, set
  */

package/dist/src/utils/url-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-params.d.ts","sourceRoot":"","sources":["../../../src/utils/url-params.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,kBAAkB,CAAC;;eAuC5D,MAAM;kBASH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAoB5C,CAAC"}
+{"version":3,"file":"url-params.d.ts","sourceRoot":"","sources":["../../../src/utils/url-params.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,kBAAkB,CAAC;;eAuC5D,MAAM;kBASH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAmB5C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@passflow/react",
   "description": "Passflow React UI Kit",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "type": "module",
   "files": [
     "dist",
@@ -46,8 +46,7 @@
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0",
-    "react-router": "^7.0.0 || ^8.0.0"
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
     "@passflow/core": "^0.20.1",
@@ -73,6 +72,7 @@
     "@storybook/addon-docs": "10.6.5",
     "@storybook/addon-themes": "10.6.5",
     "@storybook/react-vite": "10.6.5",
+    "@tanstack/react-router": "^1.170.46",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.8",
@@ -92,7 +92,8 @@
     "typescript": "7.0.2",
     "vite": "^8.3.5",
     "vite-plugin-environment": "^1.1.4",
-    "vitest": "^5.0.5"
+    "vitest": "^5.0.5",
+    "wouter": "^3.13.0"
   },
   "authors": [
     {