@_tc/template-core 0.2.0-bate.9 → 0.2.1-bate.1

package/fe/frontend/src/components/LanguageSwitch/LanguageSwitch.js

@@ -2,26 +2,27 @@ import { frontendLangKeys } from "../../language/index.js";
 import { i18nStore } from "../../../../packages/common/i18n/index.js";
 import { useI18nStore } from "../../../../packages/react/ui/i18n/useI18n.js";
 import "../../../../packages/react/ui/i18n/index.js";
-import { getSupportedLanguages, getText } from "../../common/language.js";
+import { getSupportedLanguages } from "../../common/language.js";
 import { cn } from "../../../../packages/react/ui/lib/utils.js";
 import { Button } from "../../../../packages/react/ui/components/Button/Button.js";
 import { Dropdown } from "../../../../packages/react/ui/components/Dropdown/Dropdown.js";
 import "../../../../packages/react/ui/index.js";
+import { useText } from "../../hooks/useText.js";
 import { useCallback, useMemo, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Check, ChevronDown } from "lucide-react";
 //#region frontend/src/components/LanguageSwitch/LanguageSwitch.tsx
-var getDefaultLanguageOptions = () => [{
-	label: getText(frontendLangKeys.languageSwitchZhCN),
+var getDefaultLanguageOptions = (text) => [{
+	label: text(frontendLangKeys.languageSwitchZhCN),
 	value: "zh-CN",
 	searchText: "zh-CN 中文 简体中文"
 }, {
-	label: getText(frontendLangKeys.languageSwitchEnUS),
+	label: text(frontendLangKeys.languageSwitchEnUS),
 	value: "en-US",
 	searchText: "en-US English"
 }];
-var getLanguageOptions = () => {
-	const baseOptions = getDefaultLanguageOptions();
+var getLanguageOptions = (text) => {
+	const baseOptions = getDefaultLanguageOptions(text);
 	const seen = new Set(baseOptions.map((option) => option.value));
 	return [...baseOptions, ...getSupportedLanguages().filter((language) => !seen.has(language)).map((language) => ({
 		label: language,
@@ -31,15 +32,18 @@ var getLanguageOptions = () => {
 };
 var LanguageSwitch = ({ value, defaultValue, options, onChange, className, buttonClassName, placeholder, disabled, loading, clearable: _clearable, searchable: _searchable, placement = "bottom-end", getPopupContainer = "parent", ...props }) => {
 	const rootRef = useRef(null);
+	const text = useText();
 	const currentLanguage = useI18nStore((state) => state.language);
-	const mergedOptions = useMemo(() => options ?? getLanguageOptions(), [
+	const mergedOptions = useMemo(() => options ?? getLanguageOptions(text), [
 		currentLanguage,
 		options,
-		useI18nStore((state) => state.resources)
+		useI18nStore((state) => state.resources),
+		text
 	]);
 	const selectedLanguage = value ?? currentLanguage ?? defaultValue;
 	const selectedOption = mergedOptions.find((option) => option.value === selectedLanguage);
-	const displayText = selectedOption?.label ?? placeholder ?? getText(frontendLangKeys.languageSwitchPlaceholder);
+	let displayText = selectedOption?.label ?? (placeholder || frontendLangKeys.languageSwitchPlaceholder);
+	if (typeof displayText === "string") displayText = text(displayText);
 	const handleChange = useCallback((language) => {
 		if (!language) return;
 		const nextLanguage = String(language);

package/fe/frontend/src/components/ThemeSwitch/ThemeSwitch.js

@@ -1,17 +1,18 @@
 import { frontendLangKeys } from "../../language/index.js";
 import { useI18nStore } from "../../../../packages/react/ui/i18n/useI18n.js";
 import "../../../../packages/react/ui/i18n/index.js";
-import { getText } from "../../common/language.js";
 import { cn } from "../../../../packages/react/ui/lib/utils.js";
 import { Switch } from "../../../../packages/react/ui/components/Switch/Switch.js";
 import { Tooltip } from "../../../../packages/react/ui/components/Tooltip/Tooltip.js";
 import "../../../../packages/react/ui/index.js";
+import { useText } from "../../hooks/useText.js";
 import { applyThemeMode, getCurrentThemeMode, persistThemeMode, themeSwitchStorageKey } from "../../common/theme.js";
 import { useEffect, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Moon, Sun } from "lucide-react";
 //#region frontend/src/components/ThemeSwitch/ThemeSwitch.tsx
 var ThemeSwitch = ({ value, defaultValue, onChange, disabled, className, showLabel = false, persist = true, storageKey = themeSwitchStorageKey }) => {
+	const text = useText();
 	useI18nStore((state) => state.language);
 	const [internalMode, setInternalMode] = useState(() => getCurrentThemeMode(defaultValue, storageKey));
 	const isControlled = value !== void 0;
@@ -30,8 +31,8 @@ var ThemeSwitch = ({ value, defaultValue, onChange, disabled, className, showLab
 		if (persist) persistThemeMode(nextMode, storageKey);
 		onChange?.(nextMode);
 	};
-	const label = mode === "dark" ? getText(frontendLangKeys.themeSwitchDark) : getText(frontendLangKeys.themeSwitchLight);
-	const tooltip = checked ? getText(frontendLangKeys.themeSwitchToLight) : getText(frontendLangKeys.themeSwitchToDark);
+	const label = mode === "dark" ? text(frontendLangKeys.themeSwitchDark) : text(frontendLangKeys.themeSwitchLight);
+	const tooltip = checked ? text(frontendLangKeys.themeSwitchToLight) : text(frontendLangKeys.themeSwitchToDark);
 	return /* @__PURE__ */ jsxs("div", {
 		className: cn("inline-flex shrink-0 items-center gap-2 text-foreground", className),
 		children: [

package/fe/frontend/src/defaultPages/NotFoundPage/index.js

@@ -1,8 +1,9 @@
 import { frontendLangKeys } from "../../language/index.js";
-import { getText } from "../../common/language.js";
+import { useText } from "../../hooks/useText.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region frontend/src/defaultPages/NotFoundPage/index.tsx
 var NotFoundPage = () => {
+	const text = useText();
 	return /* @__PURE__ */ jsx("div", {
 		className: "flex h-full min-h-[240px] w-full items-center justify-center bg-theme-bg px-6 text-foreground",
 		children: /* @__PURE__ */ jsxs("div", {
@@ -14,11 +15,11 @@ var NotFoundPage = () => {
 				}),
 				/* @__PURE__ */ jsx("h1", {
 					className: "text-lg font-semibold tracking-normal",
-					children: getText(frontendLangKeys.notFoundTitle)
+					children: text(frontendLangKeys.notFoundTitle)
 				}),
 				/* @__PURE__ */ jsx("p", {
 					className: "mt-2 text-sm leading-6 text-muted-foreground",
-					children: getText(frontendLangKeys.notFoundDescription)
+					children: text(frontendLangKeys.notFoundDescription)
 				})
 			]
 		})

package/fe/frontend/src/defaultPages/SchemaPage/components/CallCom/DetailPanel.js

@@ -1,8 +1,8 @@
 import { frontendLangKeys } from "../../../../language/index.js";
-import { getText } from "../../../../common/language.js";
 import { Drawer } from "../../../../../../packages/react/ui/components/Drawer/Drawer.js";
 import "../../../../../../packages/react/ui/components/index.js";
 import { request } from "../../../../common/request.js";
+import { useText } from "../../../../hooks/useText.js";
 import { schemaEventBus } from "../../../../stores/schemaEventBus.js";
 import { handlingRequestErrors } from "../../../../common/fetchErrorShow.js";
 import useExecuteOnce from "../../../../../../packages/react/hooks/useExecuteOnce.js";
@@ -28,7 +28,7 @@ var getOptionLabel = (options, value) => {
 	if (!matchedOption || typeof matchedOption !== "object") return void 0;
 	return matchedOption.label ?? stringifyValue(value);
 };
-var formatValue = (value, fieldInfo) => {
+var formatValue = (value, fieldInfo, text) => {
 	if (isEmptyValue(value)) return EMPTY_TEXT;
 	const option = fieldInfo.option;
 	const optionLabel = getOptionLabel(option?.options ?? option?.enumList, value);
@@ -39,28 +39,33 @@ var formatValue = (value, fieldInfo) => {
 			return stringifyValue(item);
 		}).join(", ");
 	}
-	if (typeof value === "boolean") return value ? getText(frontendLangKeys.yes) : getText(frontendLangKeys.no);
+	if (typeof value === "boolean") return value ? text(frontendLangKeys.yes) : text(frontendLangKeys.no);
 	return stringifyValue(value);
 };
-var generateFields = (schema, data) => {
+var generateFields = (schema, data, text) => {
 	if (!schema?.properties) return [];
 	return Object.keys(schema.properties).reduce((fields, key) => {
 		const fieldInfo = schema.properties[key];
 		if (!fieldInfo?.option || fieldInfo.option.visible === false) return fields;
 		fields.push({
 			key,
-			label: getText(fieldInfo.label),
-			value: formatValue(data?.[key], fieldInfo),
+			label: text(fieldInfo.label),
+			value: formatValue(data?.[key], fieldInfo, text),
 			level: fieldInfo.level ?? 10
 		});
 		return fields;
 	}, []).sort((a, b) => a.level - b.level);
 };
 var DetailPanel = memo((props) => {
+	const text = useText();
 	const [open, setOpen] = useState(true);
 	const [data, setData] = useState(props.data);
 	const { config, schema, api } = useComConfig({ comName: props.comName });
-	const fields = useMemo(() => generateFields(schema, data), [data, schema]);
+	const fields = useMemo(() => generateFields(schema, data, text), [
+		data,
+		schema,
+		text
+	]);
 	useExecuteOnce(async () => {
 		const fetchKey = config?.fetchKey;
 		if (fetchKey) {
@@ -73,7 +78,7 @@ var DetailPanel = memo((props) => {
 	return /* @__PURE__ */ jsx("div", {
 		className: "detail-panel",
 		children: /* @__PURE__ */ jsx(Drawer, {
-			title: getText(config?.title ?? ""),
+			title: text(config?.title ?? ""),
 			open,
 			onClose: () => {
 				setOpen(false);
@@ -93,7 +98,7 @@ var DetailPanel = memo((props) => {
 				}, field.key))
 			}) : /* @__PURE__ */ jsx("div", {
 				className: "py-8 text-center text-sm text-muted-foreground",
-				children: getText(frontendLangKeys.noData)
+				children: text(frontendLangKeys.noData)
 			})
 		})
 	});

package/fe/frontend/src/defaultPages/SchemaPage/components/CallCom/PopFrom.js

@@ -1,9 +1,9 @@
 import { frontendLangKeys } from "../../../../language/index.js";
-import { getText } from "../../../../common/language.js";
 import { Modal } from "../../../../../../packages/react/ui/components/Modal/Modal.js";
 import { SchemaForm } from "../../../../../../packages/react/ui/components/Form/SchemaForm/index.js";
 import "../../../../../../packages/react/ui/components/index.js";
 import { post, put, request } from "../../../../common/request.js";
+import { useText } from "../../../../hooks/useText.js";
 import { schemaEventBus } from "../../../../stores/schemaEventBus.js";
 import { handlingRequestErrors } from "../../../../common/fetchErrorShow.js";
 import useExecuteOnce from "../../../../../../packages/react/hooks/useExecuteOnce.js";
@@ -14,7 +14,7 @@ import { createAjvValidator } from "../../utils/validator.js";
 import { memo, useCallback, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region frontend/src/defaultPages/SchemaPage/components/CallCom/PopFrom.tsx
-var generateSchemas = (schema) => {
+var generateSchemas = (schema, text) => {
 	if (!schema?.properties) return [];
 	return Object.keys(schema.properties).reduce((schemas, key) => {
 		const fieldInfo = schema.properties[key];
@@ -23,12 +23,12 @@ var generateSchemas = (schema) => {
 		const { comType = "input", default: _defaultValue, visible: _visible, ...fieldProps } = option;
 		schemas.push({
 			key,
-			label: getText(fieldInfo.label),
+			label: text(fieldInfo.label),
 			type: comType,
 			required: schema.required?.includes(key),
 			rules: [...schema.required?.includes(key) ? [{
 				required: true,
-				message: getText(frontendLangKeys.requiredInput, { label: getText(fieldInfo.label) })
+				message: text(frontendLangKeys.requiredInput, { label: text(fieldInfo.label) })
 			}] : [], { validator: createAjvValidator(fieldInfo, { required: schema.required?.includes(key) }) }],
 			fieldProps: {
 				...fieldProps,
@@ -48,6 +48,7 @@ var generateDefaultValue = (schema, data) => {
 	return defaultValue;
 };
 var PopForm = memo((props) => {
+	const text = useText();
 	const [open, setOpen] = useState(true);
 	const [submitting, setSubmitting] = useState(false);
 	const { schema, config, api } = useComConfig({ comName: props.comName });
@@ -64,8 +65,8 @@ var PopForm = memo((props) => {
 	*
 	*/
 	const schemas = useMemo(() => {
-		return generateSchemas(schema);
-	}, [schema]);
+		return generateSchemas(schema, text);
+	}, [schema, text]);
 	const closed = submitting ? void 0 : () => {
 		schemaEventBus.getState().emitCom({ type: merge(eventsInfo.closeCom) });
 		setOpen(false);
@@ -98,7 +99,7 @@ var PopForm = memo((props) => {
 	return /* @__PURE__ */ jsx(Modal, {
 		open,
 		onClose: closed,
-		title: getText(config?.title ?? ""),
+		title: text(config?.title ?? ""),
 		width: 640,
 		maskClosable: !submitting,
 		children: /* @__PURE__ */ jsx(SchemaForm, {

package/fe/frontend/src/defaultPages/SchemaPage/components/SchemaSearch/index.js

@@ -1,14 +1,13 @@
-import { getText } from "../../../../common/language.js";
 import TableSearch from "../../../../../../packages/react/ui/components/TableSearch/TableSearch.js";
 import "../../../../../../packages/react/ui/components/index.js";
-import useInit from "../../../../../../packages/react/hooks/useInit.js";
+import { useText } from "../../../../hooks/useText.js";
 import { schemaEventBus } from "../../../../stores/schemaEventBus.js";
 import { filterEmpty } from "../../../../../../packages/common/object/filterEmpty.js";
 import { useSchemaStore } from "../../../../stores/schemaStore.js";
-import { memo, useState } from "react";
+import { memo, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region frontend/src/defaultPages/SchemaPage/components/SchemaSearch/index.tsx
-var generateSchemas = (config) => {
+var generateSchemas = (config, text) => {
 	const keys = Object.keys(config);
 	const schemas = [];
 	let defaultValue = void 0;
@@ -21,7 +20,7 @@ var generateSchemas = (config) => {
 				defaultValue[k] = defaultFieldValue;
 			}
 			schemas.push({
-				label: getText(fieldInfo.label),
+				label: text(fieldInfo.label),
 				key: k,
 				type: comType,
 				fieldProps
@@ -34,14 +33,9 @@ var generateSchemas = (config) => {
 	};
 };
 var SchemaSearch = memo(() => {
+	const text = useText();
 	const schema = useSchemaStore((s) => s.searchSchema);
-	const [schemas, setSchemas] = useState([]);
-	const [defaultValue, setSchemaDefaultValue] = useState(void 0);
-	useInit(() => {
-		const { schemas, defaultValue } = generateSchemas(schema.properties);
-		setSchemas(schemas);
-		setSchemaDefaultValue(defaultValue);
-	});
+	const { schemas, defaultValue } = useMemo(() => generateSchemas(schema.properties, text), [schema, text]);
 	const tsProps = {
 		schemas,
 		defaultValue,

package/fe/frontend/src/defaultPages/SchemaPage/components/SchemaTable/index.js

@@ -1,11 +1,10 @@
 import { frontendLangKeys } from "../../../../language/index.js";
-import { getText } from "../../../../common/language.js";
 import { Button } from "../../../../../../packages/react/ui/components/Button/Button.js";
 import { modal } from "../../../../../../packages/react/ui/components/Modal/ModalManager.js";
 import { DataTable } from "../../../../../../packages/react/ui/components/DataTable/index.js";
 import "../../../../../../packages/react/ui/components/index.js";
 import { del, get } from "../../../../common/request.js";
-import useInit from "../../../../../../packages/react/hooks/useInit.js";
+import { useText } from "../../../../hooks/useText.js";
 import { schemaEventBus } from "../../../../stores/schemaEventBus.js";
 import { useSchemaStore } from "../../../../stores/schemaStore.js";
 import { handlingRequestErrors } from "../../../../common/fetchErrorShow.js";
@@ -21,7 +20,7 @@ import { useShallow } from "zustand/react/shallow";
 import { produce } from "immer";
 //#region frontend/src/defaultPages/SchemaPage/components/SchemaTable/index.tsx
 var VALUE_KEY = "$schema::";
-var generateColumns = (config) => {
+var generateColumns = (config, text) => {
 	const keys = Object.keys(config);
 	const columns = [];
 	keys.forEach((k) => {
@@ -29,7 +28,7 @@ var generateColumns = (config) => {
 		if (fieldInfo?.option) {
 			const { render: customRender, renderComponent, renderComponentProps, ...fieldProps } = fieldInfo.option;
 			columns.push({
-				title: getText(fieldInfo.label),
+				title: text(fieldInfo.label),
 				key: k,
 				...fieldProps,
 				render(v, d, index) {
@@ -53,7 +52,7 @@ var generateColumns = (config) => {
 	});
 	return columns;
 };
-var generateRowActions = (btnConfigs, rowData, api) => {
+var generateRowActions = (btnConfigs, rowData, text, api) => {
 	const handleRowAction = (btnConfig) => {
 		const { eventKey, eventOption } = btnConfig;
 		switch (eventKey) {
@@ -72,7 +71,7 @@ var generateRowActions = (btnConfigs, rowData, api) => {
 						return o;
 					}, {});
 					modal.confirm({
-						content: getText(frontendLangKeys.confirmDelete),
+						content: text(frontendLangKeys.confirmDelete),
 						async onOk() {
 							await handlingRequestErrors(del(api, apiParams));
 							schemaEventBus.getState().emitCom({ type: merge(eventsInfo.initTable) });
@@ -85,7 +84,7 @@ var generateRowActions = (btnConfigs, rowData, api) => {
 		}
 	};
 	return btnConfigs.map((rb, index) => {
-		const label = getText(rb.label ?? "");
+		const label = text(rb.label ?? "");
 		const bState = rb.eventKey === "remove" ? "danger" : void 0;
 		return { render: (_item, { close }) => /* @__PURE__ */ jsx("div", {
 			className: " p-2.5",
@@ -102,20 +101,19 @@ var generateRowActions = (btnConfigs, rowData, api) => {
 	});
 };
 var SchemaTable = memo(({ ref }) => {
+	const text = useText();
 	const params = useSchemaStore(useShallow((s) => ({
 		config: s.tableConfig,
 		schema: s.tableSchema,
 		api: s.api
 	})));
 	const [data, uData] = useState([]);
-	const [columns, uColumns] = useState([]);
 	const [loading, uLoading, loadingRef] = useRefState(false, 25);
 	const [pagination, setPagination, paginationRef] = useRefState({
 		current: 1,
 		pageSize: 10,
 		total: 0
 	});
-	const [handleBtn, setHandleBtn] = useState([]);
 	const init = useCallback(async (query) => {
 		if (loadingRef.current.data) return;
 		uLoading(true);
@@ -143,29 +141,38 @@ var SchemaTable = memo(({ ref }) => {
 	useImperativeHandle(ref, () => {
 		return { initData: init };
 	}, [init]);
-	useInit(() => {
-		const contextColumns = generateColumns(params.schema.properties);
+	const { columns, handleBtn } = useMemo(() => {
+		const contextColumns = generateColumns(params.schema.properties, text);
 		const actionColumn = [];
+		let handleBtn = [];
 		if (params.config) {
 			const { rowButtons, headerButtons } = params.config;
 			if (rowButtons) actionColumn.push({
 				key: "action",
-				title: getText(frontendLangKeys.operation),
-				actions: (_value, _record, index) => [...generateRowActions(rowButtons, _record, params.api)]
+				title: text(frontendLangKeys.operation),
+				actions: (_value, _record, index) => [...generateRowActions(rowButtons, _record, text, params.api)]
 			});
-			setHandleBtn(headerButtons?.map((c) => {
+			handleBtn = headerButtons?.map((c) => {
 				const { label, eventKey, eventOption, ...props } = c;
 				return {
-					children: getText(label ?? ""),
+					children: text(label ?? ""),
 					onClick: () => {
 						if ("comName" in eventOption) schemaEventBus.getState().emitTable(eventOption);
 					},
 					...props
 				};
-			}) ?? []);
+			}) ?? [];
 		}
-		uColumns(contextColumns.concat(actionColumn));
-	});
+		return {
+			columns: contextColumns.concat(actionColumn),
+			handleBtn
+		};
+	}, [
+		params.api,
+		params.config,
+		params.schema,
+		text
+	]);
 	useExecuteOnce(() => {
 		init();
 	}, { executionPhase: "mount" });

package/fe/frontend/src/defaultPages/SchemaPage/index.js

@@ -1,6 +1,6 @@
 import "./index.css";
 import { frontendLangKeys } from "../../language/index.js";
-import { getText } from "../../common/language.js";
+import { useText } from "../../hooks/useText.js";
 import useInit from "../../../../packages/react/hooks/useInit.js";
 import { logIllegalComponentCallback } from "../../common/logFn/index.js";
 import { schemaEventBus } from "../../stores/schemaEventBus.js";
@@ -19,6 +19,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 //#region frontend/src/defaultPages/SchemaPage/index.tsx
 var Schema = memo(() => {
 	const { menu } = useCurrentMenuData();
+	const text = useText();
 	const [showCompoentKey, setShowCompoentKey] = useState();
 	const [comProps, setComProps] = useState({});
 	const schemaStoreAvailable = useSchemaStore((s) => s.schemaStoreAvailable);
@@ -77,12 +78,13 @@ var Schema = memo(() => {
 			});
 		} else return /* @__PURE__ */ jsx("div", {
 			className: "flex h-full items-center justify-center text-sm text-muted-foreground",
-			children: getText(frontendLangKeys.loading)
+			children: text(frontendLangKeys.loading)
 		});
 	}, [
 		comProps,
 		schemaStoreAvailable,
-		showCompoentKey
+		showCompoentKey,
+		text
 	]);
 });
 Schema.displayName = "SchemaPage";

package/fe/frontend/src/defaultPages/SidebarSlotPageTmp.js

@@ -1,16 +1,18 @@
 import { generateMenuItemData } from "../common/generateMenuData.js";
 import { useModeStore } from "../stores/mode.js";
 import { leftSidebarBasePath } from "../common/menu.js";
+import { useText } from "../hooks/useText.js";
 import SidebarSlotContainer from "./SidebarSlotPage/SidebarSlotContainer.js";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region frontend/src/defaultPages/SidebarSlotPageTmp.tsx
 var SidebarSlotPageTmp = () => {
 	const projInfo = useModeStore((s) => s.projectInfo);
+	const text = useText();
 	const [menuItems, rawMenuData] = useMemo(() => {
-		if (projInfo) return [generateMenuItemData(projInfo.menu), projInfo.menu];
+		if (projInfo) return [generateMenuItemData(projInfo.menu, text), projInfo.menu];
 		return [[], []];
-	}, [projInfo]);
+	}, [projInfo, text]);
 	return /* @__PURE__ */ jsx(SidebarSlotContainer, {
 		prefixPath: "/" + leftSidebarBasePath,
 		rawMenuData,

package/fe/frontend/src/hooks/useText.d.ts

@@ -0,0 +1,3 @@
+import type { I18nInterpolationValues, I18nTranslateOptions } from "../../../packages/react/ui/i18n/index";
+export type TextTranslator = <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => T | string;
+export declare const useText: () => TextTranslator;

package/fe/frontend/src/hooks/useText.js

@@ -0,0 +1,14 @@
+import { i18nKeyPrefix } from "../language/index.js";
+import { useI18n } from "../../../packages/react/ui/i18n/useI18n.js";
+import "../../../packages/react/ui/i18n/index.js";
+import { useCallback } from "react";
+//#region frontend/src/hooks/useText.ts
+var useText = () => {
+	const translate = useI18n();
+	return useCallback((key, fillingData, options) => {
+		if (key.startsWith("$i18n::")) return translate(key.slice(i18nKeyPrefix.length), fillingData, options);
+		return translate(key, fillingData, options);
+	}, [translate]);
+};
+//#endregion
+export { useText };

package/fe/frontend/src/index.d.ts

@@ -16,5 +16,6 @@ export { clearAuthToken, getAuthToken, localKeyMap, setAuthToken } from "./commo
 export * from "./common/language";
 export * from "./defaultPages/SchemaPage/data/eventInfo";
 export { merge } from "./defaultPages/SchemaPage/utils/permissions";
+export { useText, type TextTranslator } from "./hooks/useText";
 export * from "./exportStore";
 export { i18n, i18nStore } from "../../packages/react/ui/i18n/index";

package/fe/frontend/src/index.js

@@ -1,11 +1,12 @@
 import { clearAuthToken, getAuthToken, localKeyMap, setAuthToken } from "./common/auth/index.js";
 import { i18n, i18nStore } from "../../packages/common/i18n/index.js";
 import "../../packages/react/ui/i18n/index.js";
-import { addLanguage, addLanguageResources, addResources, getCurrentLanguage, getFallbackLanguage, getI18nResources, getSupportedLanguages, getText, setFallbackLanguage, setLanguage, setResources, t } from "./common/language.js";
+import { addLanguageResources, getCurrentLanguage, getFallbackLanguage, getI18nResources, getSupportedLanguages, getText, registerFrontendI18nResources, setFallbackLanguage, setLanguage, setResources, t } from "./common/language.js";
 import { FreezeState, apiFreezerStore, useApiFreezer } from "./stores/apiFreezer.js";
 import FetchAxios from "../../packages/common/http/index.js";
 import { api, del, get, patch, post, put, request } from "./common/request.js";
 import { modeStore, useModeStore } from "./stores/mode.js";
+import { useText } from "./hooks/useText.js";
 import HeaderView from "./components/BasePage/HeaderView.js";
 import { renderImportComponent } from "./common/importComponent.js";
 import { applyThemeMode, getCurrentThemeMode, getStoredThemeMode, initThemeMode, persistThemeMode, themeSwitchStorageKey } from "./common/theme.js";
@@ -21,4 +22,4 @@ import ThemeSwitch_default from "./components/ThemeSwitch/index.js";
 import "./components/index.js";
 import { eventsInfo } from "./defaultPages/SchemaPage/data/eventInfo.js";
 import { merge } from "./defaultPages/SchemaPage/utils/permissions.js";
-export { AsyncSelect_default as AsyncSelect, FetchAxios, FreezeState, HeaderView, LanguageSwitch_default as LanguageSwitch, ThemeSwitch_default as ThemeSwitch, addLanguage, addLanguageResources, addResources, api, apiFreezerStore, applyThemeMode, clearAuthToken, clearRafTimer, del, eventsInfo, generateRouter, get, getAuthToken, getCurrentLanguage, getCurrentThemeMode, getFallbackLanguage, getI18nResources, getStoredThemeMode, getSupportedLanguages, getText, i18n, i18nStore, initApp, initThemeMode, localKeyMap, merge, modeStore, patch, persistThemeMode, post, put, rafClearInterval, rafClearTimeout, rafSetInterval, rafSetTimeout, renderImportComponent, request, schemaEventBus, schemaStore, setAuthToken, setFallbackLanguage, setLanguage, setResources, t, themeSwitchStorageKey, useApiFreezer, useModeStore, useSchemaStore };
+export { AsyncSelect_default as AsyncSelect, FetchAxios, FreezeState, HeaderView, LanguageSwitch_default as LanguageSwitch, ThemeSwitch_default as ThemeSwitch, addLanguageResources, api, apiFreezerStore, applyThemeMode, clearAuthToken, clearRafTimer, del, eventsInfo, generateRouter, get, getAuthToken, getCurrentLanguage, getCurrentThemeMode, getFallbackLanguage, getI18nResources, getStoredThemeMode, getSupportedLanguages, getText, i18n, i18nStore, initApp, initThemeMode, localKeyMap, merge, modeStore, patch, persistThemeMode, post, put, rafClearInterval, rafClearTimeout, rafSetInterval, rafSetTimeout, registerFrontendI18nResources, renderImportComponent, request, schemaEventBus, schemaStore, setAuthToken, setFallbackLanguage, setLanguage, setResources, t, themeSwitchStorageKey, useApiFreezer, useModeStore, useSchemaStore, useText };

package/fe/frontend/src/language/index.d.ts

@@ -1,6 +1,4 @@
-import type { I18nResources } from "../../../packages/react/ui/i18n/index";
 export declare const i18nKeyPrefix = "$i18n::";
-export declare const frontendI18nResources: I18nResources;
 export declare const withI18nKey: (key: string) => string;
 export declare const frontendLangKeys: {
     readonly appTitle: string;

package/fe/frontend/src/language/index.js

@@ -1,11 +1,5 @@
-import { frontendEnUSResources } from "./en-US.js";
-import { frontendZhCNResources } from "./zh-CN.js";
 //#region frontend/src/language/index.ts
 var i18nKeyPrefix = "$i18n::";
-var frontendI18nResources = {
-	"zh-CN": frontendZhCNResources,
-	"en-US": frontendEnUSResources
-};
 var withI18nKey = (key) => `${i18nKeyPrefix}${key}`;
 var frontendLangKeys = {
 	appTitle: withI18nKey("frontend.app.title"),
@@ -76,4 +70,4 @@ var frontendLangKeys = {
 	logApiTamperEn: withI18nKey("frontend.log.apiTamperEn")
 };
 //#endregion
-export { frontendI18nResources, frontendLangKeys, i18nKeyPrefix, withI18nKey };
+export { frontendLangKeys, i18nKeyPrefix, withI18nKey };

package/fe/frontend/src/language/resources.d.ts

@@ -0,0 +1,2 @@
+import type { I18nResources } from "../../../packages/react/ui/i18n/index";
+export declare const frontendI18nResources: I18nResources;

package/fe/frontend/src/language/resources.js

@@ -0,0 +1,9 @@
+import { frontendEnUSResources } from "./en-US.js";
+import { frontendZhCNResources } from "./zh-CN.js";
+//#region frontend/src/language/resources.ts
+var frontendI18nResources = {
+	"zh-CN": frontendZhCNResources,
+	"en-US": frontendEnUSResources
+};
+//#endregion
+export { frontendI18nResources };

package/fe/packages/common/i18n/default.d.ts

@@ -7,6 +7,21 @@ export declare const defaultLanguageResources: {
         readonly submit: "提交";
         readonly reset: "重置";
     };
+    readonly server: {
+        readonly errors: {
+            readonly network: "网络错误";
+            readonly invalidRequest: "请求不合法";
+            readonly getProjectFailed: "获取项目异常";
+            readonly dbNodeSqliteUnavailable: "[db] 默认数据库依赖 Node.js 内置 {sqliteSpecifier}，当前运行环境不可用。请升级 Node.js，或在业务项目覆盖 app/extends/db.ts。{cause}";
+            readonly dbDatabaseSyncUnavailable: "[db] {sqliteSpecifier} 未提供 DatabaseSync，无法初始化默认 SQLite 数据库。";
+            readonly dbNamespaceRequired: "[db] namespace 不能为空";
+            readonly dbKeyRequired: "[db] key 不能为空";
+            readonly dbLimitInvalid: "[db] limit 必须是大于 0 的整数";
+            readonly dbOffsetInvalid: "[db] offset 必须是大于等于 0 的整数";
+            readonly dbValueNotSerializable: "[db] value 必须可以被 JSON.stringify 序列化。{cause}";
+            readonly dbClosed: "[db] SQLite 数据库连接已关闭";
+        };
+    };
     readonly components: {
         readonly breadcrumb: {
             readonly close: "关闭";

package/fe/packages/common/i18n/default.js

@@ -5,6 +5,7 @@
 * 这里只放组件内置文案，业务项目可以通过 I18nProvider.resources 覆盖或追加。
 */
 var defaultLanguageResources = {
+	/** 通用操作文案。 */
 	common: {
 		tip: "提示",
 		confirm: "确认",
@@ -13,6 +14,20 @@ var defaultLanguageResources = {
 		submit: "提交",
 		reset: "重置"
 	},
+	server: { errors: {
+		network: "网络错误",
+		invalidRequest: "请求不合法",
+		getProjectFailed: "获取项目异常",
+		dbNodeSqliteUnavailable: "[db] 默认数据库依赖 Node.js 内置 {sqliteSpecifier}，当前运行环境不可用。请升级 Node.js，或在业务项目覆盖 app/extends/db.ts。{cause}",
+		dbDatabaseSyncUnavailable: "[db] {sqliteSpecifier} 未提供 DatabaseSync，无法初始化默认 SQLite 数据库。",
+		dbNamespaceRequired: "[db] namespace 不能为空",
+		dbKeyRequired: "[db] key 不能为空",
+		dbLimitInvalid: "[db] limit 必须是大于 0 的整数",
+		dbOffsetInvalid: "[db] offset 必须是大于等于 0 的整数",
+		dbValueNotSerializable: "[db] value 必须可以被 JSON.stringify 序列化。{cause}",
+		dbClosed: "[db] SQLite 数据库连接已关闭"
+	} },
+	/** UI 组件内置文案，按组件名分组。 */
 	components: {
 		breadcrumb: { close: "关闭" },
 		confirmDialog: {
@@ -64,6 +79,7 @@ var defaultLanguageResources = {
 			rotateRight: "右旋转",
 			flipHorizontal: "左右镜像",
 			flipVertical: "上下镜像",
+			/** {index} 会在运行时由调用方传入的插值数据替换。 */
 			previewImage: "预览第{index}张"
 		},
 		modal: {