@kine-design/core 0.0.1-beta.10 → 0.0.1-beta.12

package/dist/core.js

@@ -245,7 +245,7 @@ var props$47 = {
 	},
 	placeholder: {
 		type: String,
-		default: "请选择..."
+		default: void 0
 	},
 	toMatch: {
 		type: Function,
@@ -2244,11 +2244,11 @@ var ConfirmCore = { props: {
 	},
 	confirmText: {
 		type: String,
-		default: "确定"
+		default: void 0
 	},
 	cancelText: {
 		type: String,
-		default: "取消"
+		default: void 0
 	},
 	title: {
 		type: String,
@@ -2787,7 +2787,7 @@ var props$25 = {
 	},
 	placeholder: {
 		type: String,
-		default: "请选择日期..."
+		default: void 0
 	},
 	format: {
 		type: String,
@@ -2831,52 +2831,6 @@ var props$25 = {
 * 从 lib/useDatePicker 移植，去掉 usePopover / useBorder 依赖。
 * 纯日历数据管理，不含任何 popover 逻辑。
 */
-/** 基础星期头（汉字显示） */
-var BASE_WEEK_NAME = [
-	{
-		day: "日",
-		isCurrentMonth: true
-	},
-	{
-		day: "壹",
-		isCurrentMonth: true
-	},
-	{
-		day: "贰",
-		isCurrentMonth: true
-	},
-	{
-		day: "叁",
-		isCurrentMonth: true
-	},
-	{
-		day: "肆",
-		isCurrentMonth: true
-	},
-	{
-		day: "伍",
-		isCurrentMonth: true
-	},
-	{
-		day: "陆",
-		isCurrentMonth: true
-	}
-];
-/** 月份名称 */
-var BASE_MONTH_NAME = [
-	"1月",
-	"2月",
-	"3月",
-	"4月",
-	"5月",
-	"6月",
-	"7月",
-	"8月",
-	"9月",
-	"10月",
-	"11月",
-	"12月"
-];
 /**
 * 将 string | Date 转换为 dayjs 对象。
 * headless 组件需要用此函数更新 currentRef。
@@ -2939,7 +2893,7 @@ function useDatePicker(props) {
 	*/
 	const updateDateRef = (value) => {
 		if (isEmpty(value)) {
-			displayValue.value = props.placeholder ?? "请选择日期...";
+			displayValue.value = "";
 			needPlaceholder = true;
 		} else {
 			needPlaceholder = false;
@@ -5002,7 +4956,7 @@ var BadgeCore = { props: {
 var EmptyCore = { props: {
 	description: {
 		type: String,
-		default: "暂无数据"
+		default: void 0
 	},
 	image: {
 		type: String,
@@ -5046,7 +5000,7 @@ var props$10 = {
 	},
 	placeholder: {
 		type: String,
-		default: "请输入..."
+		default: void 0
 	},
 	disabled: {
 		type: Boolean,
@@ -5574,7 +5528,7 @@ var props$6 = {
 	},
 	placeholder: {
 		type: String,
-		default: "请选择"
+		default: void 0
 	},
 	disabled: {
 		type: Boolean,
@@ -5864,7 +5818,7 @@ var props$5 = {
 	},
 	titles: {
 		type: Array,
-		default: () => ["源列表", "目标列表"]
+		default: void 0
 	},
 	filterable: {
 		type: Boolean,
@@ -5872,7 +5826,7 @@ var props$5 = {
 	},
 	filterPlaceholder: {
 		type: String,
-		default: "请输入搜索内容"
+		default: void 0
 	}
 };
 //#endregion
@@ -7129,4 +7083,460 @@ function useOverlayItem(type) {
 	};
 }
 //#endregion
-export { AffixCore, AlertCore, AnchorCore, AutoCompleteCore, AvatarCore, BASE_MONTH_NAME, BASE_WEEK_NAME, BackTopCore, BadgeCore, BorderCore, BreadcrumbCore, ButtonCore, CardCore, CarouselCore, CascaderCore, CheckboxCore, CollapseCore, ConfirmCore, DEFAULT_MENU_CONFIG, DEFAULT_TREE_CONFIG, DarkModeCore, DatePickerCore, DescriptionsCore, DialogCore, DividerCore, DrawerCore, DropdownCore, EmptyCore, FormCore, GridCore, ImageCore, InputCore, InputNumberCore, LiCore, ListCore, LoadingCore, MenuCore, MessageCore, MessagePopoverCore, NotificationCore, PaginationCore, PopoverCore, ProgressCore, RadioCore, RateCore, ResultCore, SelectCore, SkeletonCore, SliderCore, SpaceCore, StepsCore, SwitchCore, TableColumnCore, TableCore, TabsCore, TagCore, TimelineCore, TooltipCore, TransferCore, Tree, TreeCore, VirtualListCore, createRadioId, fixKey, generateTimeColumn, getNewModelValue, initChecked, toDayjs, treeNodeProps, props as treeProps, useDatePicker, useMessageQueue, useNotificationQueue, useOverlayItem, useOverlayStack, useOverlayStackStore, usePagination, useTable, useTree };
+//#region locale/zh.ts
+var zh = {
+	common: {
+		confirm: "确定",
+		cancel: "取消",
+		close: "关闭",
+		search: "搜索",
+		reset: "重置",
+		all: "全部",
+		noData: "暂无数据",
+		loading: "加载中...",
+		save: "保存"
+	},
+	pagination: {
+		totalPrefix: "共 ",
+		totalSuffix: " 条"
+	},
+	datePicker: {
+		placeholder: "请选择日期...",
+		year: (year) => `${year}年`,
+		month: (month) => `${month}月`,
+		hour: "时",
+		minute: "分",
+		second: "秒",
+		confirm: "确定",
+		weekNames: [
+			"日",
+			"一",
+			"二",
+			"三",
+			"四",
+			"五",
+			"六"
+		],
+		monthNames: [
+			"1月",
+			"2月",
+			"3月",
+			"4月",
+			"5月",
+			"6月",
+			"7月",
+			"8月",
+			"9月",
+			"10月",
+			"11月",
+			"12月"
+		]
+	},
+	timePicker: {
+		placeholder: "请选择时间...",
+		hour: "时",
+		minute: "分",
+		second: "秒"
+	},
+	select: {
+		placeholder: "请选择...",
+		clear: "清空",
+		noData: "暂无数据",
+		loading: "加载中..."
+	},
+	autoComplete: {
+		placeholder: "请输入...",
+		loading: "加载中",
+		clear: "清空",
+		noData: "暂无建议"
+	},
+	cascader: {
+		placeholder: "请选择",
+		noMatch: "暂无匹配数据"
+	},
+	image: {
+		loadError: "加载失败",
+		zoomOut: "缩小",
+		zoomIn: "放大",
+		rotate: "旋转",
+		close: "关闭"
+	},
+	transfer: {
+		sourceTitle: "源列表",
+		targetTitle: "目标列表",
+		noData: "暂无数据",
+		filterPlaceholder: "请输入搜索内容"
+	},
+	empty: { description: "暂无数据" },
+	a11y: {
+		rate: "评分",
+		tagClose: "关闭",
+		anchorNav: "锚点导航",
+		backTop: "回到顶部",
+		carouselPrev: "上一张",
+		carouselNext: "下一张",
+		toLightMode: "切换到亮色模式",
+		toDarkMode: "切换到暗色模式",
+		expandSider: "展开侧边栏",
+		collapseSider: "折叠侧边栏"
+	},
+	upload: {
+		trigger: "点击或拖拽文件到此处上传",
+		triggerSimple: "点击上传文件",
+		oversize: (name, max) => max ? `文件 "${name}" 超过大小限制（最大 ${max}）` : `文件 "${name}" 超过大小限制`,
+		uploadFailed: "上传失败",
+		statusWaiting: "等待中",
+		statusUploading: "上传中",
+		statusDone: "已完成",
+		statusFailed: "上传失败"
+	},
+	searchTable: {
+		search: "搜索",
+		reset: "重置"
+	},
+	editableTable: {
+		summary: "合计",
+		addRow: "+ 添加行",
+		addFirstRow: "添加第一行",
+		confirmDelete: "确定删除这一行？",
+		delete: "删除",
+		cancel: "取消",
+		noData: "暂无数据"
+	},
+	formPage: {
+		loading: "加载中...",
+		cancel: "取消",
+		saveDraft: "保存草稿",
+		save: "保存",
+		saving: "保存中...",
+		submit: "提交",
+		submitting: "提交中...",
+		basicInfo: "基本信息",
+		editTitle: (title) => `编辑${title}`,
+		createTitle: (title) => `新建${title}`
+	},
+	approvalDialog: {
+		submitTitle: "提交审批",
+		submitConfirm: "确认提交",
+		approveTitle: "审批通过",
+		approveConfirm: "确认通过",
+		rejectTitle: "驳回申请",
+		rejectConfirm: "确认驳回",
+		rejectPlaceholder: "请输入驳回原因...",
+		remarkPlaceholder: "添加备注（可选）...",
+		required: "* 必填",
+		cancel: "取消",
+		processing: "处理中..."
+	},
+	crudPage: {
+		all: "全部",
+		fieldPlaceholder: (label) => `请输入${label}`
+	},
+	login: {
+		username: "用户名",
+		usernamePlaceholder: "请输入用户名",
+		password: "密码",
+		passwordPlaceholder: "请输入密码",
+		remember: "记住我",
+		login: "登 录",
+		loggingIn: "登录中..."
+	},
+	form: {
+		inputPlaceholder: (label) => `请输入${label}`,
+		selectPlaceholder: (label) => `请选择${label}`
+	},
+	routes: {
+		createSuffix: " - 新建",
+		editSuffix: " - 编辑",
+		detailSuffix: " - 详情"
+	},
+	request: {
+		success: "操作成功",
+		opFailed: "操作失败",
+		failed: "请求失败",
+		failedWithStatus: (status) => `请求失败（${status}）`,
+		failedWithMsg: (msg) => `请求失败: ${msg}`,
+		timeout: "请求超时",
+		timeoutRetry: "请求超时，请稍后重试",
+		canceled: "请求已取消",
+		permissionDenied: "权限不足，无法执行此操作",
+		invalidUrl: (url) => `无效的请求地址: ${url}`,
+		decodeFailed: (reason) => `解码失败: ${reason}`,
+		parseFailed: "数据解析失败",
+		networkError: "网络错误",
+		networkException: "网络异常，请检查网络连接",
+		unknownError: (error) => `未知错误: ${error}`,
+		unknown: "发生了未知错误",
+		uploadFailed: "上传失败",
+		uploadCanceled: "上传已取消"
+	},
+	aiChat: {
+		inputPlaceholder: "输入消息…",
+		send: "发送",
+		defaultTitle: (n) => `对话 ${n}`,
+		phaseTyping: "正在输入…",
+		phaseThinking: "思考中…",
+		phaseReplying: "回复中…",
+		phaseSending: "发送中…"
+	}
+};
+//#endregion
+//#region locale/en.ts
+var en = {
+	common: {
+		confirm: "OK",
+		cancel: "Cancel",
+		close: "Close",
+		search: "Search",
+		reset: "Reset",
+		all: "All",
+		noData: "No data",
+		loading: "Loading...",
+		save: "Save"
+	},
+	pagination: {
+		totalPrefix: "",
+		totalSuffix: " items"
+	},
+	datePicker: {
+		placeholder: "Select date...",
+		year: (year) => `${year}`,
+		month: (month) => `${month}`,
+		hour: "Hour",
+		minute: "Min",
+		second: "Sec",
+		confirm: "OK",
+		weekNames: [
+			"Sun",
+			"Mon",
+			"Tue",
+			"Wed",
+			"Thu",
+			"Fri",
+			"Sat"
+		],
+		monthNames: [
+			"Jan",
+			"Feb",
+			"Mar",
+			"Apr",
+			"May",
+			"Jun",
+			"Jul",
+			"Aug",
+			"Sep",
+			"Oct",
+			"Nov",
+			"Dec"
+		]
+	},
+	timePicker: {
+		placeholder: "Select time...",
+		hour: "Hour",
+		minute: "Min",
+		second: "Sec"
+	},
+	select: {
+		placeholder: "Select...",
+		clear: "Clear",
+		noData: "No data",
+		loading: "Loading..."
+	},
+	autoComplete: {
+		placeholder: "Enter...",
+		loading: "Loading",
+		clear: "Clear",
+		noData: "No suggestions"
+	},
+	cascader: {
+		placeholder: "Select",
+		noMatch: "No matching data"
+	},
+	image: {
+		loadError: "Load failed",
+		zoomOut: "Zoom out",
+		zoomIn: "Zoom in",
+		rotate: "Rotate",
+		close: "Close"
+	},
+	transfer: {
+		sourceTitle: "Source",
+		targetTitle: "Target",
+		noData: "No data",
+		filterPlaceholder: "Search..."
+	},
+	empty: { description: "No data" },
+	a11y: {
+		rate: "Rating",
+		tagClose: "Close",
+		anchorNav: "Anchor navigation",
+		backTop: "Back to top",
+		carouselPrev: "Previous",
+		carouselNext: "Next",
+		toLightMode: "Switch to light mode",
+		toDarkMode: "Switch to dark mode",
+		expandSider: "Expand sidebar",
+		collapseSider: "Collapse sidebar"
+	},
+	upload: {
+		trigger: "Click or drag file here to upload",
+		triggerSimple: "Click to upload",
+		oversize: (name, max) => max ? `File "${name}" exceeds size limit (max ${max})` : `File "${name}" exceeds size limit`,
+		uploadFailed: "Upload failed",
+		statusWaiting: "Waiting",
+		statusUploading: "Uploading",
+		statusDone: "Done",
+		statusFailed: "Failed"
+	},
+	searchTable: {
+		search: "Search",
+		reset: "Reset"
+	},
+	editableTable: {
+		summary: "Total",
+		addRow: "+ Add row",
+		addFirstRow: "Add first row",
+		confirmDelete: "Delete this row?",
+		delete: "Delete",
+		cancel: "Cancel",
+		noData: "No data"
+	},
+	formPage: {
+		loading: "Loading...",
+		cancel: "Cancel",
+		saveDraft: "Save draft",
+		save: "Save",
+		saving: "Saving...",
+		submit: "Submit",
+		submitting: "Submitting...",
+		basicInfo: "Basic info",
+		editTitle: (title) => `Edit ${title}`,
+		createTitle: (title) => `New ${title}`
+	},
+	approvalDialog: {
+		submitTitle: "Submit for approval",
+		submitConfirm: "Confirm submission",
+		approveTitle: "Approve",
+		approveConfirm: "Confirm approval",
+		rejectTitle: "Reject",
+		rejectConfirm: "Confirm rejection",
+		rejectPlaceholder: "Enter rejection reason...",
+		remarkPlaceholder: "Add remark (optional)...",
+		required: "* Required",
+		cancel: "Cancel",
+		processing: "Processing..."
+	},
+	crudPage: {
+		all: "All",
+		fieldPlaceholder: (label) => `Enter ${label}`
+	},
+	login: {
+		username: "Username",
+		usernamePlaceholder: "Enter username",
+		password: "Password",
+		passwordPlaceholder: "Enter password",
+		remember: "Remember me",
+		login: "Log in",
+		loggingIn: "Logging in..."
+	},
+	form: {
+		inputPlaceholder: (label) => `Enter ${label}`,
+		selectPlaceholder: (label) => `Select ${label}`
+	},
+	routes: {
+		createSuffix: " - New",
+		editSuffix: " - Edit",
+		detailSuffix: " - Details"
+	},
+	request: {
+		success: "Success",
+		opFailed: "Operation failed",
+		failed: "Request failed",
+		failedWithStatus: (status) => `Request failed (${status})`,
+		failedWithMsg: (msg) => `Request failed: ${msg}`,
+		timeout: "Request timed out",
+		timeoutRetry: "Request timed out, please try again",
+		canceled: "Request canceled",
+		permissionDenied: "Permission denied",
+		invalidUrl: (url) => `Invalid request URL: ${url}`,
+		decodeFailed: (reason) => `Decode failed: ${reason}`,
+		parseFailed: "Failed to parse data",
+		networkError: "Network error",
+		networkException: "Network error, please check your connection",
+		unknownError: (error) => `Unknown error: ${error}`,
+		unknown: "An unknown error occurred",
+		uploadFailed: "Upload failed",
+		uploadCanceled: "Upload canceled"
+	},
+	aiChat: {
+		inputPlaceholder: "Type a message…",
+		send: "Send",
+		defaultTitle: (n) => `Chat ${n}`,
+		phaseTyping: "Typing…",
+		phaseThinking: "Thinking…",
+		phaseReplying: "Replying…",
+		phaseSending: "Sending…"
+	}
+};
+//#endregion
+//#region locale/index.ts
+/**
+* @description kine-design locale entry — built-in language packs + types.
+*
+*   The library ships only the two general languages (zh / en). To use another
+*   language, build a full dictionary that satisfies `KineLocaleMessages` in the
+*   consuming app and pass it straight to the provider:
+*
+*     import type { KineLocaleMessages } from '@kine-design/core';
+*     const bn: KineLocaleMessages = { ...full Bengali dictionary... };
+*     // <KConfigProvider :locale="bn"> ... </KConfigProvider>
+*
+*   TypeScript enforces full key coverage, so a partial/forgotten key is a
+*   compile error in the app — the same guarantee the built-in packs enjoy.
+* @author kine-design
+* @version v1.0.0
+*/
+/** Built-in language packs, keyed by locale name. */
+var locales = {
+	zh,
+	en
+};
+/** Fallback locale used when none is provided / an unknown name is passed. */
+var DEFAULT_LOCALE = "zh";
+//#endregion
+//#region compositions/common/useLocale.ts
+/**
+* @description composable for unified component locale with global injection
+*   support — the i18n counterpart of `useComponentSize`. Components call
+*   `useLocale()` to get the active message dictionary (a computed ref) and read
+*   their user-facing strings from it instead of hardcoding text.
+* @author kine-design
+* @version v1.0.0
+*
+* 江湖的业务千篇一律，复杂的代码好几百行。
+*/
+var KINE_LOCALE_KEY = Symbol("kine-locale");
+function resolveMessages(config) {
+	if (!config) return locales["zh"];
+	if (typeof config === "string") return locales[config] ?? locales["zh"];
+	return config;
+}
+/**
+* Resolve the active message dictionary from the nearest `KConfigProvider`.
+* Falls back to the default (zh) pack when no provider is present.
+*/
+function useLocale() {
+	const injected = inject(KINE_LOCALE_KEY, void 0);
+	return computed(() => resolveMessages(injected?.value));
+}
+var activeLocaleMessages = locales["zh"];
+/** Set the global active dictionary. Called by KConfigProvider on locale change. */
+function setActiveLocaleMessages(config) {
+	activeLocaleMessages = resolveMessages(config);
+}
+/** Read the global active dictionary from non-component (pure-function) code. */
+function getActiveLocaleMessages() {
+	return activeLocaleMessages;
+}
+//#endregion
+export { AffixCore, AlertCore, AnchorCore, AutoCompleteCore, AvatarCore, BackTopCore, BadgeCore, BorderCore, BreadcrumbCore, ButtonCore, CardCore, CarouselCore, CascaderCore, CheckboxCore, CollapseCore, ConfirmCore, DEFAULT_LOCALE, DEFAULT_MENU_CONFIG, DEFAULT_TREE_CONFIG, DarkModeCore, DatePickerCore, DescriptionsCore, DialogCore, DividerCore, DrawerCore, DropdownCore, EmptyCore, FormCore, GridCore, ImageCore, InputCore, InputNumberCore, KINE_LOCALE_KEY, LiCore, ListCore, LoadingCore, MenuCore, MessageCore, MessagePopoverCore, NotificationCore, PaginationCore, PopoverCore, ProgressCore, RadioCore, RateCore, ResultCore, SelectCore, SkeletonCore, SliderCore, SpaceCore, StepsCore, SwitchCore, TableColumnCore, TableCore, TabsCore, TagCore, TimelineCore, TooltipCore, TransferCore, Tree, TreeCore, VirtualListCore, createRadioId, en, fixKey, generateTimeColumn, getActiveLocaleMessages, getNewModelValue, initChecked, locales, setActiveLocaleMessages, toDayjs, treeNodeProps, props as treeProps, useDatePicker, useLocale, useMessageQueue, useNotificationQueue, useOverlayItem, useOverlayStack, useOverlayStackStore, usePagination, useTable, useTree, zh };

package/dist/index.d.ts

@@ -64,3 +64,5 @@ export * from './components/base/backTop';
 export * from './components/base/affix';
 export * from './components/base/anchor';
 export * from './compositions/overlay';
+export * from './locale';
+export { useLocale, KINE_LOCALE_KEY, setActiveLocaleMessages, getActiveLocaleMessages, type KineLocaleConfig, } from './compositions/common/useLocale';

package/dist/locale/en.d.ts

@@ -0,0 +1,3 @@
+import { KineLocaleMessages } from './types';
+declare const en: KineLocaleMessages;
+export default en;

package/dist/locale/index.d.ts

@@ -0,0 +1,9 @@
+import { default as zh } from './zh';
+import { default as en } from './en';
+import { KineLocaleName, KineLocaleMessages } from './types';
+export type { KineLocaleName, KineLocaleMessages };
+/** Built-in language packs, keyed by locale name. */
+export declare const locales: Record<KineLocaleName, KineLocaleMessages>;
+/** Fallback locale used when none is provided / an unknown name is passed. */
+export declare const DEFAULT_LOCALE: KineLocaleName;
+export { zh, en };