@vef-framework-react/starter 2.1.0

package/dist/es/routes/layout.js

@@ -0,0 +1,86 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+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";
+import { Layout as i } from "../components/layout/index.js";
+import { NotFound as a } from "../components/not-found/index.js";
+import { jsx as o } from "@emotion/react/jsx-runtime";
+import { Outlet as s, redirect as c } from "@tanstack/react-router";
+import { DynamicIcon as l, Loader as u } from "@vef-framework-react/components";
+//#region src/routes/layout.tsx
+function d(e, t = /* @__PURE__ */ new Map()) {
+	for (let n of e) n.children && d(n.children, t), t.set(n.path, n);
+	return t;
+}
+function f(e, t = [], n = /* @__PURE__ */ new Map()) {
+	for (let r of e) {
+		let e = [...t, r.path];
+		n.set(r.path, e), r.children && f(r.children, e, n);
+	}
+	return n;
+}
+function p(e) {
+	let { path: t, type: n, name: r, icon: i } = e, a = i ? /* @__PURE__ */ o(l, { name: i }) : void 0;
+	return n === "directory" ? {
+		type: "submenu",
+		key: t,
+		label: r,
+		icon: a,
+		children: e.children ? m(e.children) : []
+	} : {
+		type: "item",
+		key: t,
+		label: r,
+		icon: a
+	};
+}
+function m(e) {
+	return e.filter((e) => e.type !== "view").map((e) => Object.freeze(p(e)));
+}
+function h({ fetchUserInfo: l, ...p }) {
+	function h() {
+		return /* @__PURE__ */ o(i, {
+			...p,
+			children: /* @__PURE__ */ o(s, {})
+		});
+	}
+	return {
+		beforeLoad: ({ location: r }) => {
+			let { isAuthenticated: i, userMenuMap: a } = n.getState();
+			if (!i) throw c({
+				to: t,
+				search: { redirect: r.href }
+			});
+			if (a && !a.has(r.pathname)) throw c({
+				to: e,
+				replace: !0
+			});
+		},
+		loader: async ({ location: t }) => {
+			let { permTokens: r, ...i } = await l(), { menus: a } = i, o = Object.freeze(d(a)), s = Object.freeze(f(a)), u = Object.freeze(m(a));
+			if (n.setState({
+				...n.getState(),
+				userInfo: Object.freeze(i),
+				userMenuMap: o,
+				menuPathMap: s,
+				menuItems: u,
+				permTokens: Object.freeze(new Set(r))
+			}), !o.has(t.pathname)) throw c({
+				to: e,
+				replace: !0
+			});
+		},
+		pendingComponent: () => /* @__PURE__ */ o(u, {
+			description: "页面玩命加载中, 请稍后...",
+			descriptionSize: 18,
+			size: 48
+		}),
+		errorComponent: r,
+		notFoundComponent: a,
+		component: h,
+		staleTime: Infinity,
+		shouldReload: !1
+	};
+}
+//#endregion
+export { h as createLayoutRouteOptions };

package/dist/es/routes/login.js

@@ -0,0 +1,25 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+import "../constants/router.js";
+import { useAppStore as e } from "../stores/app.js";
+import { Login as t } from "../components/login/index.js";
+import { jsx as n } from "@emotion/react/jsx-runtime";
+import { redirect as r } from "@tanstack/react-router";
+import { z as i } from "@vef-framework-react/shared";
+//#region src/routes/login.tsx
+function a(a) {
+	function o() {
+		return /* @__PURE__ */ n(t, { ...a });
+	}
+	return {
+		validateSearch: i.object({ redirect: i.string().optional().default("/").catch("/") }),
+		beforeLoad: ({ search: t }) => {
+			if (e.getState().isAuthenticated) throw r({
+				to: t.redirect,
+				replace: !0
+			});
+		},
+		component: o
+	};
+}
+//#endregion
+export { a as createLoginRouteOptions };

package/dist/es/routes/root.js

@@ -0,0 +1,21 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+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";
+import { useDocumentTitle as a } from "@vef-framework-react/hooks";
+//#region src/routes/root.tsx
+function o({ appTitle: o }) {
+	function s() {
+		let s = i({
+			strict: !1,
+			select: (e) => e.title
+		}), c = r({ select: (e) => e.pathname }), l = e((e) => e.userMenuMap), u = s || l?.get(c)?.name;
+		return a(u ? `${o} | ${u}` : o), /* @__PURE__ */ t(n, {});
+	}
+	return {
+		component: s,
+		ssr: !1
+	};
+}
+//#endregion
+export { o as createRootRouteOptions };

package/dist/es/stores/app.js

@@ -0,0 +1,13 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+import { createPersistedStore as e } from "@vef-framework-react/core";
+//#region src/stores/app.ts
+var t = e(() => ({ isAuthenticated: !1 }), {
+	name: "app",
+	storage: "local",
+	selector: ({ isAuthenticated: e, authTokens: t }) => ({
+		isAuthenticated: e,
+		authTokens: t
+	})
+});
+//#endregion
+export { t as useAppStore };

package/dist/es/stores/index.js

@@ -0,0 +1,4 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+import "./app.js";
+import "./tab.js";
+import "./theme.js";

package/dist/es/stores/tab.js

@@ -0,0 +1,70 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+import "../constants/router.js";
+import { createPersistedStore as e, originalState as t } from "@vef-framework-react/core";
+//#region src/stores/tab.ts
+var n = e((e) => ({
+	tabs: [],
+	setActiveTabId(t) {
+		e((e) => {
+			e.activeTabId = t;
+		});
+	},
+	setTabs(t) {
+		e((e) => {
+			e.tabs = t;
+		});
+	},
+	addTab(t) {
+		e((e) => {
+			e.tabs.some((e) => e.id === t.id) || e.tabs.push(t);
+		});
+	},
+	removeTab(n, r) {
+		e((e) => {
+			let i = e.tabs.findIndex((e) => e.id === n);
+			if (i === -1) return;
+			let a = e.tabs.filter((e) => e.id !== n);
+			if (e.activeTabId === n) if (a.length > 0) {
+				let e = a[Math.min(i, a.length - 1)];
+				r(t(e));
+			} else r();
+			e.tabs = a;
+		});
+	},
+	removeAllTabs(t) {
+		e((e) => {
+			let n = e.tabs.find((t) => t.id === e.activeTabId);
+			e.tabs = n && n.fullPath === "/" ? [n] : [], t();
+		});
+	},
+	removeAllTabsExcept(n, r) {
+		e((e) => {
+			e.tabs = e.tabs.filter((e) => e.id === n), r(t(e.tabs.find((e) => e.id === n)));
+		});
+	},
+	removeLeftTabs(n, r) {
+		e((e) => {
+			let i = e.tabs.findIndex((e) => e.id === n);
+			if (i === -1) return;
+			let a = e.tabs.slice(0, i);
+			e.tabs = e.tabs.slice(i), a.some((t) => t.id === e.activeTabId) && r(t(e.tabs.find((e) => e.id === n)));
+		});
+	},
+	removeRightTabs(n, r) {
+		e((e) => {
+			let i = e.tabs.findIndex((e) => e.id === n);
+			if (i === -1) return;
+			let a = e.tabs.slice(i + 1);
+			e.tabs = e.tabs.slice(0, i + 1), a.some((t) => t.id === e.activeTabId) && r(t(e.tabs.find((e) => e.id === n)));
+		});
+	}
+}), {
+	name: "tab",
+	storage: "local",
+	selector: ({ activeTabId: e, tabs: t }) => ({
+		activeTabId: e,
+		tabs: t
+	})
+});
+//#endregion
+export { n as useTabStore };

package/dist/es/stores/theme.js

@@ -0,0 +1,29 @@
+/*! @vef-framework-react/starter v2.1.0 made by Venus | 2026-03-27T08:01:48.007Z */
+import { createPersistedStore as e } from "@vef-framework-react/core";
+import { omit as t } from "@vef-framework-react/shared";
+//#region src/stores/theme.ts
+var n = {
+	colorScheme: "system",
+	colors: {
+		primary: "#00bba7",
+		success: "#00c951",
+		info: "#00a6f4",
+		warning: "#ff6900",
+		error: "#fb2c36"
+	},
+	isGrayscaleMode: !1,
+	isColorBlindMode: !1,
+	isMenuAccordionMode: !0,
+	menuLayout: "vertical",
+	isSidebarCollapsed: !1,
+	isMainContentMaximum: !1
+}, r = e(() => ({
+	isThemeConfigVisible: !1,
+	...n
+}), {
+	name: "theme",
+	storage: "local",
+	selector: (e) => t(e, ["isThemeConfigVisible"])
+});
+//#endregion
+export { r as useThemeStore };

package/dist/types/src/components/access-denied/access-denied-icon.d.ts

@@ -0,0 +1,2 @@
+import { SVGProps } from 'react';
+export declare function AccessDeniedIcon(props: SVGProps<SVGSVGElement>): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/src/components/access-denied/index.d.ts

@@ -0,0 +1 @@
+export declare function AccessDenied(): React.ReactNode;

package/dist/types/src/components/app/index.d.ts

@@ -0,0 +1,4 @@
+import { AnyRouter, RegisteredRouter } from '@tanstack/react-router';
+import { AppProps } from './props';
+export declare function App<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>>({ apiClient, appContext, appVersionNotification, router }: AppProps<TRouter, TDehydrated>): React.ReactElement;
+export { type AppProps } from './props';

package/dist/types/src/components/app/props.d.ts

@@ -0,0 +1,8 @@
+import { AnyRouter, RegisteredRouter, RouterProps } from '@tanstack/react-router';
+import { ApiClient, AppContext } from '@vef-framework-react/core';
+import { AppVersionNotificationOptions } from '../../helpers/app-version.js';
+export interface AppProps<TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record<string, unknown> = Record<string, unknown>> extends Pick<RouterProps<TRouter, TDehydrated>, "router"> {
+    apiClient: ApiClient;
+    appContext: AppContext;
+    appVersionNotification?: AppVersionNotificationOptions;
+}

package/dist/types/src/components/base-layout/index.d.ts

@@ -0,0 +1,3 @@
+import { BaseLayoutProps } from './props';
+export declare function BaseLayout(props: BaseLayoutProps): React.JSX.Element;
+export { type BaseLayoutProps } from './props';

package/dist/types/src/components/base-layout/props.d.ts

@@ -0,0 +1,70 @@
+import { PropsWithChildren, ReactNode } from 'react';
+/**
+ * The props of the BaseLayout component.
+ */
+export interface BaseLayoutProps extends PropsWithChildren {
+    /**
+     * The class of the main content.
+     */
+    className?: string;
+    /**
+     * The header of the layout.
+     */
+    header?: ReactNode;
+    /**
+     * The height of the header.
+     */
+    headerHeight?: number;
+    /**
+     * The class of the header.
+     */
+    headerClassName?: string;
+    /**
+     * The tabs of the layout.
+     */
+    tabs?: ReactNode;
+    /**
+     * The height of the tabs.
+     */
+    tabsHeight?: number;
+    /**
+     * The class of the tabs.
+     */
+    tabsClassName?: string;
+    /**
+     * The footer of the layout.
+     */
+    footer?: ReactNode;
+    /**
+     * The height of the footer.
+     */
+    footerHeight?: number;
+    /**
+     * The class of the footer.
+     */
+    footerClassName?: string;
+    /**
+     * The sidebar of the layout.
+     */
+    sidebar?: ReactNode;
+    /**
+     * The sidebar collapsed state.
+     */
+    isSidebarCollapsed?: boolean;
+    /**
+     * The width of the sidebar.
+     */
+    sidebarWidth?: number;
+    /**
+     * The collapsed width of the sidebar.
+     */
+    sidebarCollapsedWidth?: number;
+    /**
+     * The class of the sidebar.
+     */
+    sidebarClassName?: string;
+    /**
+     * The main content maximum state.
+     */
+    isMainContentMaximum?: boolean;
+}

package/dist/types/src/components/base-layout/styles.d.ts

@@ -0,0 +1,8 @@
+import { SerializedStyles } from '@emotion/serialize';
+export declare const layout: SerializedStyles;
+export declare const header: SerializedStyles;
+export declare const tabs: SerializedStyles;
+export declare const sidebar: SerializedStyles;
+export declare const sidebarGap: SerializedStyles;
+export declare const main: SerializedStyles;
+export declare const footer: SerializedStyles;

package/dist/types/src/components/base-layout/use-base-layout.d.ts

@@ -0,0 +1,11 @@
+import { CSSProperties } from 'react';
+import { BaseLayoutProps } from './props';
+interface UseBaseLayoutResult {
+    isHeaderVisible: boolean;
+    isTabsVisible: boolean;
+    isSidebarVisible: boolean;
+    isFooterVisible: boolean;
+    cssVars: CSSProperties;
+}
+export declare function useBaseLayout({ header, headerHeight, tabs, tabsHeight, footer, footerHeight, sidebar, isSidebarCollapsed, sidebarWidth, sidebarCollapsedWidth, isMainContentMaximum }: BaseLayoutProps): UseBaseLayoutResult;
+export {};

package/dist/types/src/components/crud/components/action-button-group.d.ts

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework-react/shared';
+import { FC, ReactNode } from 'react';
+import { CrudState } from '../store';
+export interface ActionButtonGroupProps<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>> {
+    selector?: (state: NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>) => TSelected;
+    children: ((state: NoInfer<TSelected>) => ReactNode) | ReactNode;
+}
+export declare const ActionButtonGroup: (<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>>(props: ActionButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode) & Pick<FC, "displayName">;

package/dist/types/src/components/crud/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ActionButtonGroup, type ActionButtonGroupProps } from './action-button-group';
+export { Main } from './main';
+export { MutationHolder } from './mutation-holder';
+export { OperationButtonGroup, type OperationButtonGroupProps } from './operation-button-group';
+export { SceneForm } from './scene-form';
+export { Toolbar } from './toolbar';

package/dist/types/src/components/crud/components/main.d.ts

@@ -0,0 +1,6 @@
+import { AnyObject, Except } from '@vef-framework-react/shared';
+import { ReactNode } from 'react';
+import { CrudProps } from '../props';
+type MainProps<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject> = Except<CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>, "sceneDefaultFormValues" | "renderForm" | "defaultSearchValues" | "formMutationFns" | "beforeFormSubmit" | "afterFormSubmit" | "deleteMutationFn" | "deleteManyMutationFn" | "mutationMeta">;
+export declare const Main: <TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TFilter extends AnyObject>(props: MainProps<TRow, TSearchValues, TSceneFormValues, TFilter>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/mutation-holder.d.ts

@@ -0,0 +1,10 @@
+import { ApiResult, MutationFunction, MutationMeta } from '@vef-framework-react/core';
+import { AnyObject, MaybeUndefined } from '@vef-framework-react/shared';
+import { ReactNode } from 'react';
+interface MutationHolderProps<TRow extends AnyObject> {
+    mutationMeta?: (key: string) => MaybeUndefined<MutationMeta>;
+    deleteMutationFn?: MutationFunction<ApiResult<unknown>, TRow>;
+    deleteManyMutationFn?: MutationFunction<ApiResult<unknown>, TRow[]>;
+}
+export declare const MutationHolder: <TRow extends AnyObject>(props: MutationHolderProps<TRow>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/operation-button-group.d.ts

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework-react/shared';
+import { FC, ReactNode } from 'react';
+import { CrudState } from '../store';
+export interface OperationButtonGroupProps<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>> {
+    selector?: (state: NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>) => TSelected;
+    children: ((state: NoInfer<TSelected>) => ReactNode) | ReactNode;
+}
+export declare const OperationButtonGroup: (<TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TSelected = NoInfer<CrudState<AnyObject, TSearchValues, TSceneFormValues>>>(props: OperationButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode) & Pick<FC, "displayName">;

package/dist/types/src/components/crud/components/scene-form.d.ts

@@ -0,0 +1,7 @@
+import { AnyObject } from '@vef-framework-react/shared';
+import { ReactNode } from 'react';
+import { BaseCrudProps } from '../props';
+interface SceneFormProps<TSceneFormValues extends AnyObject> extends Pick<BaseCrudProps<AnyObject, AnyObject, TSceneFormValues, AnyObject>, "renderForm" | "formMutationFns" | "formActionsRenderers" | "beforeFormSubmit" | "afterFormSubmit" | "mutationMeta"> {
+}
+export declare const SceneForm: <TSceneFormValues extends AnyObject>(props: SceneFormProps<TSceneFormValues>) => ReactNode;
+export {};

package/dist/types/src/components/crud/components/selection-indicator.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode, MemoExoticComponent } from 'react';
+interface SelectionIndicatorProps {
+    selectionSummary?: (selectedRows: unknown[]) => ReactNode;
+}
+export declare const SelectionIndicator: MemoExoticComponent<({ selectionSummary }: SelectionIndicatorProps) => import("@emotion/react/jsx-runtime").JSX.Element | null>;
+export {};

package/dist/types/src/components/crud/components/toolbar-actions.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+interface ToolbarActionsProps {
+    toolbarActions?: ReactNode;
+}
+export declare function ToolbarActions({ toolbarActions }: ToolbarActionsProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/src/components/crud/components/toolbar.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode, MemoExoticComponent } from 'react';
+interface ToolbarProps {
+    basicSearch?: ReactNode;
+    advancedSearch?: ReactNode;
+    toolbarActions?: ReactNode;
+}
+export declare const Toolbar: MemoExoticComponent<({ basicSearch, advancedSearch, toolbarActions }: ToolbarProps) => import("@emotion/react/jsx-runtime").JSX.Element>;
+export {};

package/dist/types/src/components/crud/event.d.ts

@@ -0,0 +1,3 @@
+import { EventEmitter } from '@vef-framework-react/shared';
+export type CrudEvents = {};
+export declare function createEventEmitter(): EventEmitter<CrudEvents>;

package/dist/types/src/components/crud/helpers.d.ts

@@ -0,0 +1,20 @@
+import { UseStore } from '@vef-framework-react/core';
+import { AnyObject } from '@vef-framework-react/shared';
+import { ReactNode } from 'react';
+import { ActionButtonGroupProps, OperationButtonGroupProps } from './components';
+import { CrudState } from './store';
+/**
+ * Type representing the return value of createCrudKit
+ */
+export interface CrudKit<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject> {
+    useCrudStore: UseStore<CrudState<TRow, TSearchValues, TSceneFormValues>>;
+    useSearchValues: () => TSearchValues;
+    useSelectedRows: () => TRow[];
+    OperationButtonGroup: <TSelected = NoInfer<CrudState<TRow, TSearchValues, TSceneFormValues>>>(props: OperationButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode;
+    ActionButtonGroup: <TSelected = NoInfer<CrudState<TRow, TSearchValues, TSceneFormValues>>>(props: ActionButtonGroupProps<TSearchValues, TSceneFormValues, TSelected>) => ReactNode;
+}
+/**
+ * Create a type-safe kit containing hooks and components for Crud with specific generic types.
+ * This helper function eliminates the need to repeatedly specify generic parameters when using Crud-related utilities.
+ */
+export declare function createCrudKit<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject>(): CrudKit<TRow, TSearchValues, TSceneFormValues>;

package/dist/types/src/components/crud/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useQueryObserver } from './use-query-observer';
+export { useSearchValues } from './use-search-values';
+export { useSelectedRows } from './use-selected-rows';

package/dist/types/src/components/crud/hooks/use-query-observer.d.ts

@@ -0,0 +1,6 @@
+import { ProTableRef } from '../../pro-table';
+import { RefObject } from 'react';
+/**
+ * Hook to observe and sync ProTable query state with Crud store.
+ */
+export declare function useQueryObserver(): RefObject<ProTableRef | null>;

package/dist/types/src/components/crud/hooks/use-search-values.d.ts

@@ -0,0 +1,2 @@
+import { AnyObject } from '@vef-framework-react/shared';
+export declare function useSearchValues<TSearchValues extends AnyObject>(): NoInfer<TSearchValues>;

package/dist/types/src/components/crud/hooks/use-selected-rows.d.ts

@@ -0,0 +1,2 @@
+import { AnyObject } from '@vef-framework-react/shared';
+export declare function useSelectedRows<TRow extends AnyObject>(): NoInfer<TRow[]>;

package/dist/types/src/components/crud/index.d.ts

@@ -0,0 +1,8 @@
+import { AnyObject } from '@vef-framework-react/shared';
+import { CrudProps } from './props';
+export declare function Crud<TRow extends AnyObject, TSearchValues extends AnyObject, TSceneFormValues extends AnyObject, TParams extends AnyObject = never>({ defaultSearchValues, advancedSearch, sceneDefaultFormValues, renderForm, formMutationFns, formActionsRenderers, beforeFormSubmit, afterFormSubmit, deleteMutationFn, deleteManyMutationFn, mutationMeta, rowSelection, ...bodyProps }: CrudProps<TRow, TSearchValues, TSceneFormValues, TParams>): import("@emotion/react/jsx-runtime").JSX.Element;
+export type { ActionButtonGroupProps as CrudActionButtonGroupProps, OperationButtonGroupProps as CrudOperationButtonGroupProps } from './components';
+export { createCrudKit } from './helpers';
+export type { CrudKit } from './helpers';
+export type { CrudProps } from './props';
+export type * from './types';