@vef-framework-react/starter 2.2.1 → 2.2.2

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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 //#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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 //#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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 //#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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 import { LOGIN_ROUTE_PATH as e } from "../constants/router.js";
 import { useAppStore as t } from "../stores/app.js";
 //#region src/helpers/auth.ts

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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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";

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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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,4 +1,4 @@
-/*! @vef-framework-react/starter v2.2.1 made by Venus | 2026-05-18T08:56:01.320Z */
+/*! @vef-framework-react/starter v2.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 import { createPersistedStore as e } from "@vef-framework-react/core";
 //#region src/stores/app.ts
 var t = e(() => ({ isAuthenticated: !1 }), {

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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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.2.2 made by Venus | 2026-05-18T12:44:01.943Z */
 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vef-framework-react/starter",
   "type": "module",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "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.2.2",
+    "@vef-framework-react/core": "2.2.2",
+    "@vef-framework-react/shared": "2.2.2",
+    "@vef-framework-react/hooks": "2.2.2"
   },
   "scripts": {
     "clean": "rimraf dist",