@_tc/template-core 0.2.0 → 0.2.1

package/fe/packages/common/i18n/en-US.d.ts

@@ -7,6 +7,21 @@ export declare const defaultEnglishResources: {
         readonly submit: "Submit";
         readonly reset: "Reset";
     };
+    readonly server: {
+        readonly errors: {
+            readonly network: "Network error";
+            readonly invalidRequest: "Invalid request";
+            readonly getProjectFailed: "Failed to get project";
+            readonly dbNodeSqliteUnavailable: "[db] The default database depends on Node.js built-in {sqliteSpecifier}, which is unavailable in the current runtime. Upgrade Node.js or override app/extends/db.ts in the business project.{cause}";
+            readonly dbDatabaseSyncUnavailable: "[db] {sqliteSpecifier} does not provide DatabaseSync, so the default SQLite database cannot be initialized.";
+            readonly dbNamespaceRequired: "[db] namespace cannot be empty";
+            readonly dbKeyRequired: "[db] key cannot be empty";
+            readonly dbLimitInvalid: "[db] limit must be an integer greater than 0";
+            readonly dbOffsetInvalid: "[db] offset must be an integer greater than or equal to 0";
+            readonly dbValueNotSerializable: "[db] value must be serializable by JSON.stringify.{cause}";
+            readonly dbClosed: "[db] SQLite database connection is closed";
+        };
+    };
     readonly components: {
         readonly breadcrumb: {
             readonly close: "Close";

package/fe/packages/common/i18n/en-US.js

@@ -1,10 +1,11 @@
 //#region packages/common/i18n/en-US.ts
 /**
-* UI component library default English language resources.
+* UI 组件库默认英文语言资源。
 *
-* Only built-in component copy belongs here. Applications can override or extend it with I18nProvider.resources.
+* 这里只放组件内置文案，业务项目可以通过 I18nProvider.resources 覆盖或追加。
 */
 var defaultEnglishResources = {
+	/** 通用操作文案。 */
 	common: {
 		tip: "Prompt",
 		confirm: "Confirm",
@@ -13,6 +14,20 @@ var defaultEnglishResources = {
 		submit: "Submit",
 		reset: "Reset"
 	},
+	server: { errors: {
+		network: "Network error",
+		invalidRequest: "Invalid request",
+		getProjectFailed: "Failed to get project",
+		dbNodeSqliteUnavailable: "[db] The default database depends on Node.js built-in {sqliteSpecifier}, which is unavailable in the current runtime. Upgrade Node.js or override app/extends/db.ts in the business project.{cause}",
+		dbDatabaseSyncUnavailable: "[db] {sqliteSpecifier} does not provide DatabaseSync, so the default SQLite database cannot be initialized.",
+		dbNamespaceRequired: "[db] namespace cannot be empty",
+		dbKeyRequired: "[db] key cannot be empty",
+		dbLimitInvalid: "[db] limit must be an integer greater than 0",
+		dbOffsetInvalid: "[db] offset must be an integer greater than or equal to 0",
+		dbValueNotSerializable: "[db] value must be serializable by JSON.stringify.{cause}",
+		dbClosed: "[db] SQLite database connection is closed"
+	} },
+	/** UI 组件内置文案，按组件名分组。 */
 	components: {
 		breadcrumb: { close: "Close" },
 		confirmDialog: {
@@ -64,6 +79,7 @@ var defaultEnglishResources = {
 			rotateRight: "Rotate right",
 			flipHorizontal: "Flip horizontal",
 			flipVertical: "Flip vertical",
+			/** {index} 会在运行时由调用方传入的插值数据替换。 */
 			previewImage: "Preview image {index}"
 		},
 		modal: {

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

@@ -2,6 +2,7 @@ import "./default.js";
 import "./en-US.js";
 import { defaultLanguage, languageLocalKey, translations } from "./locales.js";
 //#region packages/common/i18n/index.ts
+/** 判断某个消息节点是否是可继续递归访问的普通字典。 */
 var isPlainI18nDictionary = (value) => {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 };
@@ -65,6 +66,10 @@ var translate = (state, key, fillingData, options) => {
 	const value = getI18nPathValue(state.resources[language], key) ?? getI18nPathValue(state.resources[fallbackLanguage], key) ?? options?.fallback ?? key;
 	return typeof value === "string" ? interpolateI18nMessage(value, fillingData) : value;
 };
+/**
+* 获取可用于持久化语言的浏览器 window。
+* Node、SSR 或测试环境下没有 window 时返回 undefined。
+*/
 var getBrowserWindow = () => {
 	return globalThis.window;
 };
@@ -92,6 +97,11 @@ var createInitialState = () => ({
 	storageKey: languageLocalKey,
 	persist: true
 });
+/**
+* 创建模块内部使用的最小 store。
+*
+* 这里只实现 getState / setState / subscribe，避免 common 层为了 i18n 引入状态管理依赖。
+*/
 var createI18nStore = () => {
 	let state;
 	const listeners = /* @__PURE__ */ new Set();
@@ -148,6 +158,7 @@ var createI18nStore = () => {
 		}
 	};
 };
+/** 全局 i18n store，React 适配层和非 React 代码共享这一份状态。 */
 var i18nStore = createI18nStore();
 /**
 * 对外使用的 i18n 函数。
@@ -156,7 +167,9 @@ var i18nStore = createI18nStore();
 var i18n = (key, fillingData, options) => {
 	return translate(i18nStore.getState(), key, fillingData, options);
 };
+/** i18n 的简写别名。 */
 var t = i18n;
+/** 兼容历史调用的别名，行为等同于 i18n。 */
 var getLanguage = i18n;
 //#endregion
 export { getI18nPathValue, getLanguage, i18n, i18nStore, interpolateI18nMessage, isPlainI18nDictionary, mergeI18nDictionary, mergeI18nResources, t, translate };

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

@@ -1,8 +1,15 @@
 import { defaultLanguageResources } from "./default.js";
 import { defaultEnglishResources } from "./en-US.js";
 //#region packages/common/i18n/locales.ts
+/** 默认语言，作为初始化语言和翻译兜底语言使用。 */
 var defaultLanguage = "zh-CN";
+/** 默认保存用户语言偏好的 localStorage key。 */
 var languageLocalKey = "tc_language";
+/**
+* 内置语言资源。
+*
+* 业务项目可以通过 I18nProvider.resources、setResources 或 addResources 覆盖和追加。
+*/
 var translations = {
 	"zh-CN": defaultLanguageResources,
 	"en-US": defaultEnglishResources

package/fe/packages/react/ui/components/Date/Calendar.js

@@ -1,3 +1,5 @@
+import { useI18nStore } from "../../i18n/useI18n.js";
+import "../../i18n/index.js";
 import { cn } from "../../lib/utils.js";
 import { Button } from "../Button/Button.js";
 import "../Button/index.js";
@@ -8,14 +10,16 @@ import { useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ChevronLeft, ChevronRight, ChevronsLeft, ChevronsRight } from "lucide-react";
 import { addMonths, addYears, eachDayOfInterval, endOfDay, endOfMonth, endOfWeek, format, isAfter, isBefore, isSameDay, isSameMonth, startOfDay, startOfMonth, startOfWeek, subDays, subMonths, subYears } from "date-fns";
-import { zhCN } from "date-fns/locale";
+import { enUS, zhCN } from "date-fns/locale";
 //#region packages/react/ui/components/Date/Calendar.tsx
 function Calendar({ mode = ModeType.Single, value, onChange, disabledDate, showTime, className, locale: customLocale, quickRanges }) {
+	const language = useI18nStore((state) => state.language);
 	const contextLocale = useDateLocale();
 	const locale = useMemo(() => ({
 		...contextLocale,
 		...customLocale
 	}), [contextLocale, customLocale]);
+	const dateFnsLocale = language === "zh-CN" ? zhCN : enUS;
 	const [pendingValue, setPendingValue] = useState(value ?? null);
 	const [currentMonth, setCurrentMonth] = useState(() => {
 		if (value instanceof Date) return value;
@@ -28,11 +32,11 @@ function Calendar({ mode = ModeType.Single, value, onChange, disabledDate, showT
 		const monthEnd = endOfMonth(monthStart);
 		const daysInGrid = eachDayOfInterval({
 			start: startOfWeek(monthStart, {
-				locale: zhCN,
+				locale: dateFnsLocale,
 				weekStartsOn: 0
 			}),
 			end: endOfWeek(monthEnd, {
-				locale: zhCN,
+				locale: dateFnsLocale,
 				weekStartsOn: 0
 			})
 		});
@@ -46,7 +50,7 @@ function Calendar({ mode = ModeType.Single, value, onChange, disabledDate, showT
 			daysInGrid.push(...extraDays);
 		}
 		return daysInGrid;
-	}, [currentMonth]);
+	}, [currentMonth, dateFnsLocale]);
 	const weekDays = locale.weekDays;
 	const isRangeMode = mode === ModeType.Range;
 	const builtInQuickRanges = useMemo(() => [
@@ -238,7 +242,7 @@ function Calendar({ mode = ModeType.Single, value, onChange, disabledDate, showT
 								}),
 								/* @__PURE__ */ jsx("div", {
 									className: "font-medium text-sm",
-									children: format(currentMonth, locale.monthFormat, { locale: zhCN })
+									children: format(currentMonth, locale.monthFormat, { locale: dateFnsLocale })
 								}),
 								/* @__PURE__ */ jsxs("div", {
 									className: "flex items-center gap-1",

package/fe/packages/react/ui/components/Date/LocaleContext.d.ts

@@ -1 +1,22 @@
-export declare const useDateLocale: () => import("./locales").DateLocaleConfig;
+import { type DateLocaleConfig } from "./locales";
+export declare const DateLocaleContext: import("react").Context<Partial<DateLocaleConfig> | undefined>;
+export declare const useDateLocale: () => {
+    placeholder: string;
+    placeholderDateTime: string;
+    placeholderRange: string;
+    placeholderDateTimeRange: string;
+    weekDays: string[];
+    selectTime: string;
+    startTime: string;
+    endTime: string;
+    confirm: string;
+    monthFormat: string;
+    quickRanges: string;
+    quickRangeToday: string;
+    quickRangeYesterday: string;
+    quickRangeLast7Days: string;
+    quickRangeLast30Days: string;
+    quickRangeThisMonth: string;
+    quickRangeLastYear: string;
+    clear: string;
+};

package/fe/packages/react/ui/components/Date/LocaleContext.js

@@ -1,11 +1,36 @@
+import { useI18nStore } from "../../i18n/useI18n.js";
+import "../../i18n/index.js";
+import { defaultLocale, getDateLocale } from "./locales.js";
 import { useDateLocaleStore } from "./dateLocaleStore.js";
+import { createContext, useContext, useMemo } from "react";
 //#region packages/react/ui/components/Date/LocaleContext.tsx
+var DateLocaleContext = createContext(void 0);
 /**
 * Hook for accessing the current Date component locale.
-* Backed by Zustand, so no React Context is required.
+* Backed by the shared i18n store, so Date updates with the global language.
 */
 var useDateLocale = () => {
-	return useDateLocaleStore((state) => state.locale);
+	const language = useI18nStore((state) => state.language);
+	const fallbackLanguage = useI18nStore((state) => state.fallbackLanguage);
+	const resources = useI18nStore((state) => state.resources);
+	const storeLocale = useDateLocaleStore((state) => state.locale);
+	const localeOverride = useContext(DateLocaleContext);
+	const storeLocaleOverride = storeLocale === defaultLocale ? void 0 : storeLocale;
+	return useMemo(() => ({
+		...getDateLocale({
+			language,
+			fallbackLanguage,
+			resources
+		}),
+		...storeLocaleOverride,
+		...localeOverride
+	}), [
+		fallbackLanguage,
+		language,
+		localeOverride,
+		resources,
+		storeLocaleOverride
+	]);
 };
 //#endregion
-export { useDateLocale };
+export { DateLocaleContext, useDateLocale };

package/fe/packages/react/ui/components/Date/LocaleProvider.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from "react";
 import { type DateLocaleConfig } from "./locales";
 export interface DateLocaleProviderProps {
-    locale?: DateLocaleConfig;
+    locale?: Partial<DateLocaleConfig>;
     children: ReactNode;
 }
 export declare function DateLocaleProvider({ locale, children }: DateLocaleProviderProps): import("react/jsx-runtime").JSX.Element;

package/fe/packages/react/ui/components/Date/LocaleProvider.js

@@ -1,7 +1,5 @@
-import { defaultLocale } from "./locales.js";
-import { useDateLocaleStore } from "./dateLocaleStore.js";
-import { useEffect } from "react";
-import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+import { DateLocaleContext } from "./LocaleContext.js";
+import { jsx } from "react/jsx-runtime";
 //#region packages/react/ui/components/Date/LocaleProvider.tsx
 /**
 * Date 组件文案配置 Provider
@@ -14,18 +12,11 @@ import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 * </DateLocaleProvider>
 * ```
 */
-function DateLocaleProvider({ locale = defaultLocale, children }) {
-	const replaceLocale = useDateLocaleStore((state) => state.replaceLocale);
-	const resetLocale = useDateLocaleStore((state) => state.resetLocale);
-	useEffect(() => {
-		replaceLocale(locale);
-		return () => resetLocale();
-	}, [
-		locale,
-		replaceLocale,
-		resetLocale
-	]);
-	return /* @__PURE__ */ jsx(Fragment$1, { children });
+function DateLocaleProvider({ locale, children }) {
+	return /* @__PURE__ */ jsx(DateLocaleContext.Provider, {
+		value: locale,
+		children
+	});
 }
 //#endregion
 export { DateLocaleProvider };

package/fe/packages/react/ui/components/Date/index.js

@@ -1,6 +1,6 @@
-import { defaultLocale, enUSLocale, zhCNLocale } from "./locales.js";
+import { defaultLocale, enUSLocale, getDateLocale, zhCNLocale } from "./locales.js";
 import { useDateLocaleStore } from "./dateLocaleStore.js";
 import { useDateLocale } from "./LocaleContext.js";
 import { DatePicker } from "./Date.js";
 import { DateLocaleProvider } from "./LocaleProvider.js";
-export { DateLocaleProvider, DatePicker, defaultLocale, enUSLocale, useDateLocale, useDateLocaleStore, zhCNLocale };
+export { DateLocaleProvider, DatePicker, defaultLocale, enUSLocale, getDateLocale, useDateLocale, useDateLocaleStore, zhCNLocale };

package/fe/packages/react/ui/components/Date/locales.d.ts

@@ -1,3 +1,4 @@
+import type { I18nTranslateState } from "../../../../common/i18n/index";
 export interface DateLocaleConfig {
     placeholder: string;
     placeholderDateTime: string;
@@ -18,6 +19,7 @@ export interface DateLocaleConfig {
     quickRangeLastYear: string;
     clear: string;
 }
+export declare const getDateLocale: (state: I18nTranslateState) => DateLocaleConfig;
 export declare const zhCNLocale: DateLocaleConfig;
 export declare const enUSLocale: DateLocaleConfig;
 export declare const defaultLocale: DateLocaleConfig;

package/fe/packages/react/ui/components/Date/locales.js

@@ -1,25 +1,41 @@
-import { defaultLanguageResources } from "../../../../common/i18n/default.js";
-import { defaultEnglishResources } from "../../../../common/i18n/en-US.js";
+import { i18nStore, translate } from "../../../../common/i18n/index.js";
 //#region packages/react/ui/components/Date/locales.ts
-var dateDefaultLocale = defaultLanguageResources.components.date;
-var dateDefaultEnglishLocale = defaultEnglishResources.components.date;
+var getDateLocale = (state) => ({
+	placeholder: translate(state, "components.date.placeholder"),
+	placeholderDateTime: translate(state, "components.date.placeholderDateTime"),
+	placeholderRange: translate(state, "components.date.placeholderRange"),
+	placeholderDateTimeRange: translate(state, "components.date.placeholderDateTimeRange"),
+	weekDays: [...translate(state, "components.date.weekDays")],
+	selectTime: translate(state, "components.date.selectTime"),
+	startTime: translate(state, "components.date.startTime"),
+	endTime: translate(state, "components.date.endTime"),
+	confirm: translate(state, "components.date.confirm"),
+	monthFormat: translate(state, "components.date.monthFormat"),
+	quickRanges: translate(state, "components.date.quickRanges"),
+	quickRangeToday: translate(state, "components.date.quickRangeToday"),
+	quickRangeYesterday: translate(state, "components.date.quickRangeYesterday"),
+	quickRangeLast7Days: translate(state, "components.date.quickRangeLast7Days"),
+	quickRangeLast30Days: translate(state, "components.date.quickRangeLast30Days"),
+	quickRangeThisMonth: translate(state, "components.date.quickRangeThisMonth"),
+	quickRangeLastYear: translate(state, "components.date.quickRangeLastYear"),
+	clear: translate(state, "components.date.clear")
+});
+var getDateLocaleByLanguage = (language) => getDateLocale({
+	language,
+	fallbackLanguage: i18nStore.getState().fallbackLanguage,
+	resources: i18nStore.getState().resources
+});
 /**
 * 默认中文文案
 */
-var zhCNLocale = {
-	...dateDefaultLocale,
-	weekDays: [...dateDefaultLocale.weekDays]
-};
+var zhCNLocale = { ...getDateLocaleByLanguage("zh-CN") };
 /**
 * 默认英文文案
 */
-var enUSLocale = {
-	...dateDefaultEnglishLocale,
-	weekDays: [...dateDefaultEnglishLocale.weekDays]
-};
+var enUSLocale = { ...getDateLocaleByLanguage("en-US") };
 /**
 * 默认使用中文文案
 */
 var defaultLocale = zhCNLocale;
 //#endregion
-export { defaultLocale, enUSLocale, zhCNLocale };
+export { defaultLocale, enUSLocale, getDateLocale, zhCNLocale };

package/fe/packages/react/ui/components/TableSearch/TableSearch.js

@@ -1,3 +1,5 @@
+import { useI18nStore } from "../../i18n/useI18n.js";
+import "../../i18n/index.js";
 import { cn } from "../../lib/utils.js";
 import { Button } from "../Button/Button.js";
 import "../Button/index.js";
@@ -6,6 +8,7 @@ import "../Dropdown/index.js";
 import Search from "../Search/Search.js";
 import "../Search/index.js";
 import { ExportType } from "../../lib/export.js";
+import { defaultLocale, getTableSearchLocale } from "./lang.js";
 import { useTableSearchLocaleStore } from "./tableSearchLocaleStore.js";
 import { useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -27,7 +30,24 @@ var TableSearch = (props) => {
 	const handleExpand = () => {
 		setIsExpanded(!isExpanded);
 	};
-	const locale = useTableSearchLocaleStore((state) => state.locale);
+	const language = useI18nStore((state) => state.language);
+	const fallbackLanguage = useI18nStore((state) => state.fallbackLanguage);
+	const resources = useI18nStore((state) => state.resources);
+	const storeLocale = useTableSearchLocaleStore((state) => state.locale);
+	const storeLocaleOverride = storeLocale === defaultLocale ? void 0 : storeLocale;
+	const locale = useMemo(() => ({
+		...getTableSearchLocale({
+			language,
+			fallbackLanguage,
+			resources
+		}),
+		...storeLocaleOverride
+	}), [
+		fallbackLanguage,
+		language,
+		resources,
+		storeLocaleOverride
+	]);
 	const defaultExportItems = useMemo(() => exportMenuItems || [{
 		key: "export-current-page",
 		label: locale.exportCurrentPage,

package/fe/packages/react/ui/components/TableSearch/lang.d.ts

@@ -1,3 +1,4 @@
+import type { I18nTranslateState } from "../../../../common/i18n/index";
 export interface TableSearchLocaleConfig {
     reset: string;
     search: string;
@@ -7,6 +8,7 @@ export interface TableSearchLocaleConfig {
     exportCurrentPage: string;
     exportCurrentQuery: string;
 }
+export declare const getTableSearchLocale: (state: I18nTranslateState) => TableSearchLocaleConfig;
 export declare const zhCNLocale: TableSearchLocaleConfig;
 export declare const enUSLocale: TableSearchLocaleConfig;
 export declare const defaultLocale: TableSearchLocaleConfig;

package/fe/packages/react/ui/components/TableSearch/lang.js

@@ -1,14 +1,25 @@
-import { defaultLanguageResources } from "../../../../common/i18n/default.js";
-import { defaultEnglishResources } from "../../../../common/i18n/en-US.js";
+import { i18nStore, translate } from "../../../../common/i18n/index.js";
 //#region packages/react/ui/components/TableSearch/lang.ts
-var tableSearchDefaultLocale = defaultLanguageResources.components.tableSearch;
-var tableSearchDefaultEnglishLocale = defaultEnglishResources.components.tableSearch;
-var zhCNLocale = { ...tableSearchDefaultLocale };
-var enUSLocale = { ...tableSearchDefaultEnglishLocale };
+var getTableSearchLocale = (state) => ({
+	reset: translate(state, "components.tableSearch.reset"),
+	search: translate(state, "components.tableSearch.search"),
+	export: translate(state, "components.tableSearch.export"),
+	expand: translate(state, "components.tableSearch.expand"),
+	collapse: translate(state, "components.tableSearch.collapse"),
+	exportCurrentPage: translate(state, "components.tableSearch.exportCurrentPage"),
+	exportCurrentQuery: translate(state, "components.tableSearch.exportCurrentQuery")
+});
+var getTableSearchLocaleByLanguage = (language) => getTableSearchLocale({
+	language,
+	fallbackLanguage: i18nStore.getState().fallbackLanguage,
+	resources: i18nStore.getState().resources
+});
+var zhCNLocale = { ...getTableSearchLocaleByLanguage("zh-CN") };
+var enUSLocale = { ...getTableSearchLocaleByLanguage("en-US") };
 var defaultLocale = zhCNLocale;
 var btnConfig = defaultLocale;
 var updateBtnConfig = (config) => {
 	Object.assign(btnConfig, config);
 };
 //#endregion
-export { btnConfig, defaultLocale, enUSLocale, updateBtnConfig, zhCNLocale };
+export { btnConfig, defaultLocale, enUSLocale, getTableSearchLocale, updateBtnConfig, zhCNLocale };

package/model/frontend/src/common/language.d.ts

@@ -1,7 +1,5 @@
 import type { I18nAddResourcesOptions, I18nDictionary, I18nInterpolationValues, I18nLanguage, I18nResources, I18nSetResourcesOptions, I18nTranslateOptions } from "../../../../fe/packages/react/ui/i18n/index";
 export declare const addLanguageResources: (language: I18nLanguage, messages: I18nDictionary, options?: I18nAddResourcesOptions) => void;
-export declare const addResources: (language: I18nLanguage, messages: I18nDictionary, options?: I18nAddResourcesOptions) => void;
-export declare const addLanguage: (language: I18nLanguage, messages?: I18nDictionary, options?: I18nAddResourcesOptions) => void;
 export declare const setLanguage: (language: I18nLanguage) => void;
 export declare const setFallbackLanguage: (language: I18nLanguage) => void;
 export declare const setResources: (resources: I18nResources, options?: I18nSetResourcesOptions) => void;
@@ -9,6 +7,7 @@ export declare const getCurrentLanguage: () => string;
 export declare const getFallbackLanguage: () => string;
 export declare const getI18nResources: () => Partial<Record<string, I18nDictionary>>;
 export declare const getSupportedLanguages: () => string[];
+export declare const registerFrontendI18nResources: (resources?: I18nResources) => Promise<void>;
 export declare const getText: (key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string;
 export declare const t: <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;
 export type { I18nAddResourcesOptions, I18nDictionary, I18nInterpolationValues, I18nLanguage, I18nResources, I18nSetResourcesOptions, I18nTranslateOptions, };

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

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

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

@@ -1,6 +1,4 @@
-import type { I18nResources } from "../../../../fe/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/model/frontend/src/language/resources.d.ts

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

package/model/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/model/packages/common/i18n/en-US.d.ts

@@ -7,6 +7,21 @@ export declare const defaultEnglishResources: {
         readonly submit: "Submit";
         readonly reset: "Reset";
     };
+    readonly server: {
+        readonly errors: {
+            readonly network: "Network error";
+            readonly invalidRequest: "Invalid request";
+            readonly getProjectFailed: "Failed to get project";
+            readonly dbNodeSqliteUnavailable: "[db] The default database depends on Node.js built-in {sqliteSpecifier}, which is unavailable in the current runtime. Upgrade Node.js or override app/extends/db.ts in the business project.{cause}";
+            readonly dbDatabaseSyncUnavailable: "[db] {sqliteSpecifier} does not provide DatabaseSync, so the default SQLite database cannot be initialized.";
+            readonly dbNamespaceRequired: "[db] namespace cannot be empty";
+            readonly dbKeyRequired: "[db] key cannot be empty";
+            readonly dbLimitInvalid: "[db] limit must be an integer greater than 0";
+            readonly dbOffsetInvalid: "[db] offset must be an integer greater than or equal to 0";
+            readonly dbValueNotSerializable: "[db] value must be serializable by JSON.stringify.{cause}";
+            readonly dbClosed: "[db] SQLite database connection is closed";
+        };
+    };
     readonly components: {
         readonly breadcrumb: {
             readonly close: "Close";

package/model/packages/react/ui/components/Date/LocaleContext.d.ts

@@ -1 +1,22 @@
-export declare const useDateLocale: () => import("./locales").DateLocaleConfig;
+import { type DateLocaleConfig } from "./locales";
+export declare const DateLocaleContext: import("react").Context<Partial<DateLocaleConfig> | undefined>;
+export declare const useDateLocale: () => {
+    placeholder: string;
+    placeholderDateTime: string;
+    placeholderRange: string;
+    placeholderDateTimeRange: string;
+    weekDays: string[];
+    selectTime: string;
+    startTime: string;
+    endTime: string;
+    confirm: string;
+    monthFormat: string;
+    quickRanges: string;
+    quickRangeToday: string;
+    quickRangeYesterday: string;
+    quickRangeLast7Days: string;
+    quickRangeLast30Days: string;
+    quickRangeThisMonth: string;
+    quickRangeLastYear: string;
+    clear: string;
+};

package/model/packages/react/ui/components/Date/LocaleProvider.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from "react";
 import { type DateLocaleConfig } from "./locales";
 export interface DateLocaleProviderProps {
-    locale?: DateLocaleConfig;
+    locale?: Partial<DateLocaleConfig>;
     children: ReactNode;
 }
 export declare function DateLocaleProvider({ locale, children }: DateLocaleProviderProps): import("react/jsx-runtime").JSX.Element;

package/model/packages/react/ui/components/Date/locales.d.ts

@@ -1,3 +1,4 @@
+import type { I18nTranslateState } from "@tc/common/i18n";
 export interface DateLocaleConfig {
     placeholder: string;
     placeholderDateTime: string;
@@ -18,6 +19,7 @@ export interface DateLocaleConfig {
     quickRangeLastYear: string;
     clear: string;
 }
+export declare const getDateLocale: (state: I18nTranslateState) => DateLocaleConfig;
 export declare const zhCNLocale: DateLocaleConfig;
 export declare const enUSLocale: DateLocaleConfig;
 export declare const defaultLocale: DateLocaleConfig;

package/model/packages/react/ui/components/TableSearch/lang.d.ts

@@ -1,3 +1,4 @@
+import type { I18nTranslateState } from "@tc/common/i18n";
 export interface TableSearchLocaleConfig {
     reset: string;
     search: string;
@@ -7,6 +8,7 @@ export interface TableSearchLocaleConfig {
     exportCurrentPage: string;
     exportCurrentQuery: string;
 }
+export declare const getTableSearchLocale: (state: I18nTranslateState) => TableSearchLocaleConfig;
 export declare const zhCNLocale: TableSearchLocaleConfig;
 export declare const enUSLocale: TableSearchLocaleConfig;
 export declare const defaultLocale: TableSearchLocaleConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
   "types": "./types/index.d.ts",
   "exports": {

package/types/app/utils/i18n.d.ts

@@ -0,0 +1,12 @@
+import type { I18nInterpolationValues, I18nTranslateOptions } from "../../packages/common/i18n/index";
+import type { Ctx } from "../type";
+export declare const LANGUAGE_HEADER_KEY = "x-tc-language";
+export interface RequestI18nError extends Error {
+    i18nKey?: string;
+    i18nData?: I18nInterpolationValues;
+}
+export declare const normalizeI18nLanguage: (language: string | undefined) => string;
+export declare const getRequestLanguage: (ctx: Pick<Ctx, "headers">) => string;
+export declare const requestT: <T = string>(ctx: Pick<Ctx, "headers">, key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => string | T;
+export declare const createI18nError: (key: string, fillingData?: I18nInterpolationValues, fallbackMessage?: string) => RequestI18nError;
+export declare const getRequestErrorMessage: (ctx: Pick<Ctx, "headers">, error: RequestI18nError, fallbackMessage?: string) => string;