@vef-framework-react/starter 2.2.1 → 2.3.0

package/dist/es/components/not-found/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "../../constants/router.js";
 import { NotFoundIcon as e } from "./not-found-icon.js";
 import { Button as t, Center as n, Icon as r, Result as i } from "@vef-framework-react/components";

package/dist/es/components/not-found/not-found-icon.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { jsx as e, jsxs as t } from "@emotion/react/jsx-runtime";
 //#region src/components/not-found/not-found-icon.tsx
 function n(n) {

package/dist/es/components/router-provider/context.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { createContext as e, use as t } from "react";
 //#region src/components/router-provider/context.ts
 var n = e(null);

package/dist/es/components/router-provider/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useRouterContextHook as e } from "./context.js";
 import { useMemo as t } from "react";
 import { jsx as n } from "@emotion/react/jsx-runtime";

package/dist/es/components/theme-config-provider/global-style.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "@emotion/react";
 //#region src/components/theme-config-provider/global-style.ts
 function e() {

package/dist/es/components/theme-config-provider/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useColorModeEffect as e } from "./use-color-mode-effect.js";
 import { useThemeConfig as t } from "./use-theme-config.js";
 import { ConfigProvider as n } from "@vef-framework-react/components";

package/dist/es/components/theme-config-provider/use-color-mode-effect.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useThemeStore as e } from "../../stores/theme.js";
 import { useEffect as t } from "react";
 //#region src/components/theme-config-provider/use-color-mode-effect.ts

package/dist/es/components/theme-config-provider/use-theme-config.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useThemeStore as e } from "../../stores/theme.js";
 import { globalStyle as t } from "./global-style.js";
 import { useShallow as n } from "@vef-framework-react/core";

package/dist/es/constants/event.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 //#region src/constants/event.ts
 var e = "__vef_access_denied_event", t = "__vef_unauthenticated_event";
 //#endregion

package/dist/es/constants/index.js

@@ -1,3 +1,3 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "./event.js";
 import "./router.js";

package/dist/es/constants/router.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 //#region src/constants/router.ts
 var e = "/login", t = "/_common/login", n = "/", r = "/_layout", i = "/access-denied", a = "/_common/access-denied";
 //#endregion

package/dist/es/constants/storage.js

@@ -1,2 +1,2 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 //#endregion

package/dist/es/helpers/api.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useAppStore as e } from "../stores/app.js";
 import { emitAccessDenied as t, emitUnauthenticated as n } from "./event.js";
 import { showErrorMessage as r, showInfoMessage as i, showSuccessMessage as a, showWarningMessage as o } from "@vef-framework-react/components";

package/dist/es/helpers/app-version.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { Button as e, Group as t, Icon as n, Text as r, globalCssVars as i, showInfoNotification as a } from "@vef-framework-react/components";
 import { joinPaths as o } from "@vef-framework-react/shared";
 import { Fragment as s, jsx as c, jsxs as l } from "@emotion/react/jsx-runtime";

package/dist/es/helpers/app.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { RouterContextHookProvider as e } from "../components/router-provider/context.js";
 import { App as t } from "../components/app/index.js";
 import { StrictMode as n } from "react";

package/dist/es/helpers/auth.js

@@ -1,9 +1,17 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { LOGIN_ROUTE_PATH as e } from "../constants/router.js";
 import { useAppStore as t } from "../stores/app.js";
 //#region src/helpers/auth.ts
 async function n(n) {
-	t.setState({ isAuthenticated: !1 }, !0), await n.navigate({ to: e }), n.invalidate({
+	t.setState({
+		isAuthenticated: !1,
+		authTokens: void 0,
+		userInfo: void 0,
+		userMenuMap: void 0,
+		menuPathMap: void 0,
+		menuItems: void 0,
+		permissionTokens: void 0
+	}), await n.navigate({ to: e }), n.invalidate({
 		sync: !0,
 		forcePending: !0
 	});

package/dist/es/helpers/event.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { ACCESS_DENIED_EVENT as e, UNAUTHENTICATED_EVENT as t } from "../constants/event.js";
 import { createEventEmitter as n } from "@vef-framework-react/shared";
 //#region src/helpers/event.ts

package/dist/es/helpers/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "./event.js";
 import "./api.js";
 import "./app-version.js";

package/dist/es/helpers/query.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { SYMBOL_PAGINATION as e, SYMBOL_SORT as t } from "@vef-framework-react/components";
 //#region src/helpers/query.ts
 function n(...e) {

package/dist/es/helpers/router.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { ACCESS_DENIED_ROUTE_PATH as e } from "../constants/router.js";
 import { useAppStore as t } from "../stores/app.js";
 import { useTabStore as n } from "../stores/tab.js";

package/dist/es/hooks/index.js

@@ -1,2 +1,2 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "./use-route-full-path.js";

package/dist/es/hooks/use-route-full-path.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useMemo as e } from "react";
 import { useLocation as t, useRouter as n } from "@tanstack/react-router";
 //#region src/hooks/use-route-full-path.ts

package/dist/es/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { ACCESS_DENIED_ROUTE_ID as e, ACCESS_DENIED_ROUTE_PATH as t, INDEX_ROUTE_ID as n, INDEX_ROUTE_PATH as r, LOGIN_ROUTE_ID as i, LOGIN_ROUTE_PATH as a } from "./constants/router.js";
 import { useAppStore as o } from "./stores/app.js";
 import { useTabStore as s } from "./stores/tab.js";

package/dist/es/routes/access-denied.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "../constants/router.js";
 import { AccessDenied as e } from "../components/access-denied/index.js";
 //#region src/routes/access-denied.ts

package/dist/es/routes/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "./access-denied.js";
 import "./layout.js";
 import "./login.js";

package/dist/es/routes/layout.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { ACCESS_DENIED_ROUTE_PATH as e, LOGIN_ROUTE_PATH as t } from "../constants/router.js";
 import { useAppStore as n } from "../stores/app.js";
 import { Error as r } from "../components/error/index.js";
@@ -37,38 +37,40 @@ function p(e) {
 function m(e) {
 	return e.filter((e) => e.type !== "view").map((e) => Object.freeze(p(e)));
 }
-function h({ fetchUserInfo: o, ...p }) {
-	function h() {
+function h({ fetchUserInfo: o, beforeLoad: p, loader: h, ...g }) {
+	function _() {
 		return /* @__PURE__ */ c(i, {
-			...p,
+			...g,
 			children: /* @__PURE__ */ c(l, {})
 		});
 	}
 	return {
-		beforeLoad: ({ location: r }) => {
-			let { isAuthenticated: i, userMenuMap: a } = n.getState();
-			if (!i) throw u({
+		beforeLoad: async (r) => {
+			let { location: i } = r, { isAuthenticated: a, userMenuMap: o } = n.getState();
+			if (!a) throw u({
 				to: t,
-				search: { redirect: r.href }
+				search: { redirect: i.href }
 			});
-			if (a && !a.has(r.pathname)) throw u({
+			if (o && !o.has(i.pathname)) throw u({
 				to: e,
 				replace: !0
 			});
+			return await p?.(r) ?? {};
 		},
-		loader: async ({ location: t }) => {
-			let { permTokens: r, ...i } = await o(), { menus: a } = i, s = Object.freeze(d(a)), c = Object.freeze(f(a)), l = Object.freeze(m(a));
+		loader: async (t) => {
+			let { location: r } = t, { permissionTokens: i, ...a } = await o(), { menus: s } = a, c = Object.freeze(d(s)), l = Object.freeze(f(s)), p = Object.freeze(m(s));
 			if (n.setState({
 				...n.getState(),
-				userInfo: Object.freeze(i),
-				userMenuMap: s,
-				menuPathMap: c,
-				menuItems: l,
-				permTokens: Object.freeze(new Set(r))
-			}), !s.has(t.pathname)) throw u({
+				userInfo: Object.freeze(a),
+				userMenuMap: c,
+				menuPathMap: l,
+				menuItems: p,
+				permissionTokens: Object.freeze(new Set(i))
+			}), !c.has(r.pathname)) throw u({
 				to: e,
 				replace: !0
 			});
+			if (h) return await h(t);
 		},
 		pendingComponent: () => /* @__PURE__ */ c(s, {
 			description: "页面玩命加载中, 请稍后...",
@@ -77,7 +79,7 @@ function h({ fetchUserInfo: o, ...p }) {
 		}),
 		errorComponent: r,
 		notFoundComponent: a,
-		component: h,
+		component: _,
 		staleTime: Infinity,
 		shouldReload: !1
 	};

package/dist/es/routes/login.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "../constants/router.js";
 import { useAppStore as e } from "../stores/app.js";
 import { Login as t } from "../components/login/index.js";

package/dist/es/routes/root.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { useAppStore as e } from "../stores/app.js";
 import { jsx as t } from "@emotion/react/jsx-runtime";
 import { Outlet as n, useLocation as r, useRouteContext as i } from "@tanstack/react-router";

package/dist/es/stores/app.js

@@ -1,12 +1,16 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { createPersistedStore as e } from "@vef-framework-react/core";
 //#region src/stores/app.ts
-var t = e(() => ({ isAuthenticated: !1 }), {
+var t = e(() => ({
+	isAuthenticated: !1,
+	custom: {}
+}), {
 	name: "app",
 	storage: "local",
-	selector: ({ isAuthenticated: e, authTokens: t }) => ({
+	selector: ({ isAuthenticated: e, custom: t, authTokens: n }) => ({
 		isAuthenticated: e,
-		authTokens: t
+		custom: t,
+		authTokens: n
 	})
 });
 //#endregion

package/dist/es/stores/index.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "./app.js";
 import "./tab.js";
 import "./theme.js";

package/dist/es/stores/tab.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import "../constants/router.js";
 import { createPersistedStore as e, originalState as t } from "@vef-framework-react/core";
 //#region src/stores/tab.ts

package/dist/es/stores/theme.js

@@ -1,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.3.0 made by Venus | 2026-05-22T09:39:55.761Z */
 import { createPersistedStore as e } from "@vef-framework-react/core";
 import { omit as t } from "@vef-framework-react/shared";
 //#region src/stores/theme.ts

package/dist/types/components/layout/components/header/index.d.ts

@@ -1,5 +1,5 @@
 import { LayoutProps } from '../../props';
-interface HeaderProps extends Pick<LayoutProps, "title" | "logo" | "headerActions" | "userMenuItems" | "onLogout"> {
+interface HeaderProps extends Pick<LayoutProps, "title" | "logo" | "headerActions" | "userMenuItems" | "onUserMenuClick" | "onLogout"> {
 }
-export declare function Header({ title, logo, headerActions, userMenuItems, onLogout }: HeaderProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function Header({ title, logo, headerActions, userMenuItems, onUserMenuClick, onLogout }: HeaderProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/layout/components/header/user-avatar.d.ts

@@ -1,6 +1,6 @@
 import { LayoutProps } from '../../props';
-interface UserAvatarProps extends Pick<LayoutProps, "userMenuItems" | "onLogout"> {
+interface UserAvatarProps extends Pick<LayoutProps, "userMenuItems" | "onUserMenuClick" | "onLogout"> {
     className?: string;
 }
-export declare function UserAvatar({ className, userMenuItems, onLogout }: UserAvatarProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function UserAvatar({ className, userMenuItems, onUserMenuClick, onLogout }: UserAvatarProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/layout/index.d.ts

@@ -1,3 +1,3 @@
 import { LayoutProps } from './props';
-export declare function Layout({ title, logo, headerActions, userMenuItems, onLogout, children }: LayoutProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function Layout({ title, logo, headerActions, userMenuItems, onUserMenuClick, onLogout, children }: LayoutProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export { type LayoutProps } from './props';

package/dist/types/components/layout/props.d.ts

@@ -18,9 +18,15 @@ export interface LayoutProps extends PropsWithChildren {
      */
     headerActions?: ReactNode;
     /**
-     * The user menu items of the layout.
+     * Extra items appended to the user dropdown menu. They render before the
+     * built-in items (e.g. logout), with an automatic divider in between.
      */
     userMenuItems?: DropdownMenuProps["items"];
+    /**
+     * Handles clicks on user menu items. The built-in `logout` key is owned by
+     * the framework and never forwarded; all other keys are delivered here.
+     */
+    onUserMenuClick?: (key: string) => void;
     /**
      * The logout api function.
      */

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export { type LoginChallenge, type LoginChallengeRenderer, type LoginChallengeRendererProps, type LoginChallengeRenderers, type LoginParams, type LoginProps, type LoginResult, type PasswordLoginParams, type ResolveChallengeParams } from './components';
 export { ACCESS_DENIED_ROUTE_ID, ACCESS_DENIED_ROUTE_PATH, INDEX_ROUTE_ID, INDEX_ROUTE_PATH, LOGIN_ROUTE_ID, LOGIN_ROUTE_PATH } from './constants';
 export { createApiClient, createApp, createRouter, dispatchCustomEvent, emitAccessDenied, emitUnauthenticated, extractQueryParams, handleClientLogout, noopMutationFn, setupAppVersionNotification, type ApiClientOptions, type AppChangelog, type AppVersionNotificationOptions, type RouterOptions } from './helpers';
-export { createAccessDeniedRouteOptions, createLayoutRouteOptions, createLoginRouteOptions, createRootRouteOptions } from './routes';
+export { createAccessDeniedRouteOptions, createLayoutRouteOptions, createLoginRouteOptions, createRootRouteOptions, type LayoutBeforeLoadArgs, type LayoutLoaderArgs } from './routes';
 export { useAppStore, useTabStore, useThemeStore, type AppState, type ColorScheme, type Tab, type TabState, type ThemeColors, type ThemeState } from './stores';
 export type * from './types';

package/dist/types/routes/index.d.ts

@@ -1,4 +1,4 @@
 export { createAccessDeniedRouteOptions } from './access-denied';
-export { createLayoutRouteOptions } from './layout';
+export { createLayoutRouteOptions, type LayoutBeforeLoadArgs, type LayoutLoaderArgs } from './layout';
 export { createLoginRouteOptions } from './login';
 export { createRootRouteOptions } from './root';

package/dist/types/routes/layout.d.ts

@@ -1,22 +1,25 @@
-import { ParsedLocation } from '@tanstack/react-router';
-import { Awaitable, Except } from '@vef-framework-react/shared';
+import { RouteLoaderFn, RouteOptions } from '@tanstack/react-router';
+import { AnyObject, Awaitable, EmptyObject, Except } from '@vef-framework-react/shared';
 import { LayoutProps, Error, NotFound } from '../components';
 import { UserInfo } from '../types';
-interface LayoutRouteOptions extends Except<LayoutProps, "children"> {
+export type LayoutBeforeLoadArgs = Parameters<NonNullable<RouteOptions<unknown, any, any>["beforeLoad"]>>[0];
+type BaseLayoutLoaderArgs = Parameters<RouteLoaderFn<unknown, any, any>>[0];
+export type LayoutLoaderArgs<TBeforeLoadContext extends AnyObject = EmptyObject> = Except<BaseLayoutLoaderArgs, "context"> & {
+    context: BaseLayoutLoaderArgs["context"] & TBeforeLoadContext;
+};
+interface LayoutRouteOptions<TBeforeLoadContext extends AnyObject = EmptyObject, TLoaderData = void> extends Except<LayoutProps, "children"> {
     fetchUserInfo: () => Awaitable<UserInfo>;
+    beforeLoad?: (args: LayoutBeforeLoadArgs) => Awaitable<TBeforeLoadContext | void>;
+    loader?: (args: LayoutLoaderArgs<TBeforeLoadContext>) => Awaitable<TLoaderData>;
 }
-export declare function createLayoutRouteOptions({ fetchUserInfo, ...layoutProps }: LayoutRouteOptions): {
-    readonly beforeLoad: ({ location }: {
-        location: ParsedLocation;
-    }) => void;
-    readonly loader: ({ location }: {
-        location: ParsedLocation;
-    }) => Promise<void>;
-    readonly pendingComponent: () => import("@emotion/react/jsx-runtime").JSX.Element;
-    readonly errorComponent: typeof Error;
-    readonly notFoundComponent: typeof NotFound;
-    readonly component: () => import("@emotion/react/jsx-runtime").JSX.Element;
-    readonly staleTime: number;
-    readonly shouldReload: false;
+export declare function createLayoutRouteOptions<TBeforeLoadContext extends AnyObject = EmptyObject, TLoaderData = void>({ fetchUserInfo, beforeLoad, loader, ...layoutProps }: LayoutRouteOptions<TBeforeLoadContext, TLoaderData>): {
+    beforeLoad: (args: LayoutBeforeLoadArgs) => Promise<TBeforeLoadContext>;
+    loader: (args: LayoutLoaderArgs<TBeforeLoadContext>) => Promise<TLoaderData | undefined>;
+    pendingComponent: () => import("@emotion/react/jsx-runtime").JSX.Element;
+    errorComponent: typeof Error;
+    notFoundComponent: typeof NotFound;
+    component: () => import("@emotion/react/jsx-runtime").JSX.Element;
+    staleTime: number;
+    shouldReload: boolean;
 };
 export {};

package/dist/types/stores/app.d.ts

@@ -1,14 +1,15 @@
 import { MenuItem } from '@vef-framework-react/components';
 import { AuthTokens, UseBoundStoreWithPersist } from '@vef-framework-react/core';
 import { Except } from '@vef-framework-react/shared';
-import { UserInfo, UserMenu } from '../types';
+import { AppCustomState, UserInfo, UserMenu } from '../types';
 export interface AppState {
     isAuthenticated: boolean;
     authTokens?: Readonly<AuthTokens>;
-    userInfo?: Readonly<Except<UserInfo, "permTokens">>;
+    userInfo?: Readonly<Except<UserInfo, "permissionTokens">>;
     userMenuMap?: Readonly<Map<string, Readonly<UserMenu>>>;
     menuPathMap?: Readonly<Map<string, readonly string[]>>;
     menuItems?: ReadonlyArray<Readonly<MenuItem>>;
-    permTokens?: Readonly<Set<string>>;
+    permissionTokens?: Readonly<Set<string>>;
+    custom: AppCustomState;
 }
 export declare const useAppStore: UseBoundStoreWithPersist<AppState>;

package/dist/types/types/common.d.ts

@@ -1,4 +1,4 @@
-import { LiteralUnion, MaybeNull } from '@vef-framework-react/shared';
+import { AnyObject, LiteralUnion, MaybeNull } from '@vef-framework-react/shared';
 export type Gender = "male" | "female" | "unknown";
 export type UserMenuType = LiteralUnion<"directory" | "menu" | "view" | "report", string>;
 export interface UserMenu {
@@ -19,6 +19,9 @@ export interface UserMenu {
  * @example
  * declare module "@vef-framework-react/starter" {
  *   interface Register {
+ *     appCustomState: {
+ *       appId?: string;
+ *     };
  *     userDetails: {
  *       department: string;
  *       organization: string;
@@ -35,6 +38,9 @@ export interface UserMenu {
  */
 export interface Register {
 }
+export type AppCustomState = Register extends {
+    appCustomState: infer T extends AnyObject;
+} ? T : AnyObject;
 /**
  * Default shape of `UserInfo['details']` before projects augment `Register`.
  */
@@ -63,7 +69,7 @@ export interface UserInfo {
     name: string;
     gender: Gender;
     avatar?: MaybeNull<string>;
-    permTokens: string[];
+    permissionTokens: string[];
     menus: UserMenu[];
     details: ResolvedUserDetails;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework-react/starter",
   "type": "module",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "private": false,
   "description": "Starter for VEF framework",
   "author": {
@@ -64,10 +64,10 @@
     "@tanstack/react-router": "^1.170.1",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "@vef-framework-react/components": "2.2.1",
-    "@vef-framework-react/core": "2.2.1",
-    "@vef-framework-react/hooks": "2.2.1",
-    "@vef-framework-react/shared": "2.2.1"
+    "@vef-framework-react/components": "2.3.0",
+    "@vef-framework-react/core": "2.3.0",
+    "@vef-framework-react/hooks": "2.3.0",
+    "@vef-framework-react/shared": "2.3.0"
   },
   "scripts": {
     "clean": "rimraf dist",