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

package/.vlaude/last-session-id

@@ -1 +1 @@
-dd5e7d65-f4f9-4e97-acdf-d3bb42303812
+4c9b1c27-b707-4b0b-98d7-fde5d511ce47

package/components/base/autoComplete/api.ts

@@ -11,7 +11,7 @@ import { AutoCompleteProps, AutoCompleteOption } from './props';
 
 export const props: MCOPO<AutoCompleteProps> = {
   modelValue: { type: String, default: '' },
-  placeholder: { type: String, default: '请输入...' },
+  placeholder: { type: String, default: undefined },
   disabled: { type: Boolean, default: false },
   clearable: { type: Boolean, default: false },
   debounce: { type: Number, default: 300 },

package/components/base/cascader/api.ts

@@ -12,7 +12,7 @@ import { CascaderProps, CascaderOption } from './props';
 export const props: MCOPO<CascaderProps> = {
   modelValue: { type: undefined, default: () => [] },
   options: { type: Array as MPropType<CascaderOption[]>, default: () => [] },
-  placeholder: { type: String, default: '请选择' },
+  placeholder: { type: String, default: undefined },
   disabled: { type: Boolean, default: false },
   clearable: { type: Boolean, default: false },
   filterable: { type: Boolean, default: false },

package/components/base/datePicker/__tests__/useDatePicker.test.ts

@@ -7,7 +7,7 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 import { describe, expect, it } from 'vitest';
-import { useDatePicker, generateTimeColumn, toDayjs, BASE_WEEK_NAME, BASE_MONTH_NAME } from '../useDatePicker';
+import { useDatePicker, generateTimeColumn, toDayjs } from '../useDatePicker';
 
 describe('toDayjs', () => {
   it('字符串转 dayjs', () => {
@@ -53,20 +53,11 @@ describe('generateTimeColumn', () => {
   });
 });
 
-describe('常量', () => {
-  it('BASE_WEEK_NAME 有 7 天', () => {
-    expect(BASE_WEEK_NAME).toHaveLength(7);
-  });
-
-  it('BASE_MONTH_NAME 有 12 个月', () => {
-    expect(BASE_MONTH_NAME).toHaveLength(12);
-  });
-});
-
 describe('useDatePicker', () => {
-  it('初始化空值显示 placeholder', () => {
+  it('初始化空值 displayValue 为空串、标记 placeholder 态', () => {
+    // i18n 后 placeholder 文案由 UI 层提供，hook 空值只返回空串 + placeholder class
     const dp = useDatePicker({ type: 'date' });
-    expect(dp.displayValue.value).toBe('请选择日期...');
+    expect(dp.displayValue.value).toBe('');
     expect(dp.spanClass.value).toContain('m-date-picker-placeholder');
   });
 
@@ -78,9 +69,9 @@ describe('useDatePicker', () => {
     expect(dp.dateRef.value.day).toBe(15);
   });
 
-  it('自定义 placeholder', () => {
+  it('placeholder 不再由 hook 产出（移交 UI 层），空值仍为空串', () => {
     const dp = useDatePicker({ type: 'date', placeholder: '选择日期' });
-    expect(dp.displayValue.value).toBe('选择日期');
+    expect(dp.displayValue.value).toBe('');
   });
 
   it('updateDateRef 更新状态', () => {
@@ -93,11 +84,11 @@ describe('useDatePicker', () => {
     expect(dp.displayValue.value).toBe('2025-12-25');
   });
 
-  it('updateDateRef 空值恢复 placeholder', () => {
+  it('updateDateRef 空值恢复空串（placeholder 态）', () => {
     const dp = useDatePicker({ type: 'date', modelValue: '2026-01-01' });
     dp.updateDateRef('');
 
-    expect(dp.displayValue.value).toBe('请选择日期...');
+    expect(dp.displayValue.value).toBe('');
   });
 
   it('getCalendar 返回 6 行 7 列', () => {

package/components/base/datePicker/api.ts

@@ -11,7 +11,7 @@ import { DatePickerProps } from './props';
 
 export const props: MCOPO<DatePickerProps> = {
   modelValue: { type: [String, Date], default: '' },
-  placeholder: { type: String, default: '请选择日期...' },
+  placeholder: { type: String, default: undefined },
   format: { type: String, default: undefined },
   type: { type: String as MPropType<'date' | 'month' | 'datetime'>, default: 'date' },
   disabled: { type: Boolean, default: false },

package/components/base/datePicker/index.ts

@@ -15,5 +15,5 @@ export const DatePickerCore = {
 };
 
 export type { DatePickerProps, CalendarType, DateRefType, CalendarItem } from './props';
-export { useDatePicker, toDayjs, BASE_WEEK_NAME, BASE_MONTH_NAME, generateTimeColumn } from './useDatePicker';
+export { useDatePicker, toDayjs, generateTimeColumn } from './useDatePicker';
 export type { TimeRefType } from './useDatePicker';

package/components/base/datePicker/useDatePicker.ts

@@ -20,23 +20,6 @@ export type TimeRefType = {
   seconds: number;
 };
 
-/** 基础星期头（汉字显示） */
-export const BASE_WEEK_NAME: Array<{ day: string; isCurrentMonth: boolean }> = [
-  { day: '日', isCurrentMonth: true },
-  { day: '壹', isCurrentMonth: true },
-  { day: '贰', isCurrentMonth: true },
-  { day: '叁', isCurrentMonth: true },
-  { day: '肆', isCurrentMonth: true },
-  { day: '伍', isCurrentMonth: true },
-  { day: '陆', isCurrentMonth: true },
-];
-
-/** 月份名称 */
-export const BASE_MONTH_NAME = [
-  '1月', '2月', '3月', '4月', '5月', '6月',
-  '7月', '8月', '9月', '10月', '11月', '12月',
-];
-
 /**
  * 将 string | Date 转换为 dayjs 对象。
  * headless 组件需要用此函数更新 currentRef。
@@ -113,7 +96,7 @@ export function useDatePicker(props: DatePickerProps) {
    */
   const updateDateRef = (value: string | Date | undefined) => {
     if (isEmpty(value)) {
-      displayValue.value = props.placeholder ?? '请选择日期...';
+      displayValue.value = '';
       needPlaceholder = true;
     } else {
       needPlaceholder = false;

package/components/base/empty/api.ts

@@ -10,6 +10,6 @@ import { MCOPO } from '../../types/props';
 import { EmptyProps } from './props';
 
 export const props: MCOPO<EmptyProps> = {
-  description: { type: String, default: '暂无数据' },
+  description: { type: String, default: undefined },
   image: { type: String, default: undefined },
 };

package/components/base/select/api.ts

@@ -19,7 +19,7 @@ export const props: MCOPO<SelectProps> = {
   valueParam: { type: String, default: undefined },
   readonly: { type: Boolean, default: true },
   disabled: { type: Boolean, default: false },
-  placeholder: { type: String, default: '请选择...' },
+  placeholder: { type: String, default: undefined },
   toMatch: { type: Function as MPropType<(option: any, value: any) => boolean>, default: undefined },
   multiple: { type: Boolean, default: false },
   checkbox: { type: Boolean, default: true },

package/components/base/timePicker/__tests__/useTimePicker.test.ts

@@ -36,9 +36,10 @@ describe('useTimePicker', () => {
     secondStep: 1,
   };
 
-  it('初始化空值显示 placeholder', () => {
+  it('初始化空值 displayValue 为空串、标记 placeholder 态', () => {
+    // i18n 后 placeholder 文案由 UI 层提供，hook 空值只返回空串 + placeholder class
     const tp = useTimePicker({ ...defaultProps });
-    expect(tp.displayValue.value).toBe('请选择时间...');
+    expect(tp.displayValue.value).toBe('');
     expect(tp.spanClass.value).toContain('m-time-picker-placeholder');
   });
 
@@ -65,10 +66,10 @@ describe('useTimePicker', () => {
     expect(tp.timeRef.value.seconds).toBe(30);
   });
 
-  it('updateTimeRef 空值恢复 placeholder', () => {
+  it('updateTimeRef 空值恢复空串（placeholder 态）', () => {
     const tp = useTimePicker({ ...defaultProps, modelValue: '10:00:00' });
     tp.updateTimeRef('');
-    expect(tp.displayValue.value).toBe('请选择时间...');
+    expect(tp.displayValue.value).toBe('');
   });
 
   it('selectHour 更新小时并刷新显示', () => {

package/components/base/timePicker/api.ts

@@ -11,7 +11,7 @@ import { TimePickerProps } from './props';
 
 export const props: MCOPO<TimePickerProps> = {
   modelValue: { type: String, default: '' },
-  placeholder: { type: String, default: '请选择时间...' },
+  placeholder: { type: String, default: undefined },
   format: { type: String, default: undefined },
   disabled: { type: Boolean, default: false },
   showSeconds: { type: Boolean, default: true },

package/components/base/timePicker/useTimePicker.ts

@@ -68,7 +68,7 @@ export function useTimePicker(props: TimePickerProps) {
    */
   const updateTimeRef = (value: string | undefined) => {
     if (isEmpty(value)) {
-      displayValue.value = resolvedProps.placeholder ?? '请选择时间...';
+      displayValue.value = '';
       needPlaceholder = true;
     } else {
       needPlaceholder = false;

package/components/base/transfer/api.ts

@@ -12,7 +12,7 @@ import { TransferProps, TransferItem } from './props';
 export const props: MCOPO<TransferProps> = {
   modelValue: { type: Array as MPropType<(string | number)[]>, default: () => [] },
   data: { type: Array as MPropType<TransferItem[]>, default: () => [] },
-  titles: { type: Array as unknown as MPropType<[string, string]>, default: () => ['源列表', '目标列表'] },
+  titles: { type: Array as unknown as MPropType<[string, string]>, default: undefined },
   filterable: { type: Boolean, default: false },
-  filterPlaceholder: { type: String, default: '请输入搜索内容' },
+  filterPlaceholder: { type: String, default: undefined },
 };

package/components/message/confirm/api.ts

@@ -14,8 +14,8 @@ export const props: MCOPO<ConfirmProps> = {
   mask: { type: Object, default: () => ({ show: true, clickClose: false }) },
   teleport: { type: Object, default: () => ({ to: 'body' }) },
   content: { type: String, default: '' },
-  confirmText: { type: String, default: '确定' },
-  cancelText: { type: String, default: '取消' },
+  confirmText: { type: String, default: undefined },
+  cancelText: { type: String, default: undefined },
   title: { type: String, default: undefined },
   loading: { type: Boolean, default: false },
 };

package/compositions/common/useLocale.ts

@@ -0,0 +1,53 @@
+/**
+ * @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
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { computed, inject, type ComputedRef, type InjectionKey, type Ref } from 'vue';
+import type { KineLocaleName, KineLocaleMessages } from '../../locale/types';
+import { DEFAULT_LOCALE, locales } from '../../locale';
+
+/** Accepted `locale` values: a built-in name, or a full custom dictionary. */
+export type KineLocaleConfig = KineLocaleName | KineLocaleMessages;
+
+export const KINE_LOCALE_KEY: InjectionKey<Ref<KineLocaleConfig | undefined>> = Symbol('kine-locale');
+
+function resolveMessages(config: KineLocaleConfig | undefined): KineLocaleMessages {
+  if (!config) return locales[DEFAULT_LOCALE];
+  if (typeof config === 'string') return locales[config] ?? locales[DEFAULT_LOCALE];
+  return config;
+}
+
+/**
+ * Resolve the active message dictionary from the nearest `KConfigProvider`.
+ * Falls back to the default (zh) pack when no provider is present.
+ */
+export function useLocale(): ComputedRef<KineLocaleMessages> {
+  const injected = inject(KINE_LOCALE_KEY, undefined);
+  return computed(() => resolveMessages(injected?.value));
+}
+
+// ── Global singleton ─────────────────────────────────────────────────────────
+// Components read locale through useLocale() (provide/inject, scoped + reactive).
+// But non-component code — the crud request/error feedback functions — has no
+// component context and cannot inject. Those read this module-level singleton
+// instead. KConfigProvider keeps it in sync inside its setup, so under a single
+// root provider the two are always consistent; with nested providers the global
+// reflects whichever was set last (an acceptable trade-off, since feedback text
+// is app-global by nature).
+let activeLocaleMessages: KineLocaleMessages = locales[DEFAULT_LOCALE];
+
+/** Set the global active dictionary. Called by KConfigProvider on locale change. */
+export function setActiveLocaleMessages(config: KineLocaleConfig | undefined): void {
+  activeLocaleMessages = resolveMessages(config);
+}
+
+/** Read the global active dictionary from non-component (pure-function) code. */
+export function getActiveLocaleMessages(): KineLocaleMessages {
+  return activeLocaleMessages;
+}

package/dist/components/base/datePicker/index.d.ts

@@ -4,5 +4,5 @@ export declare const DatePickerCore: {
     useDatePicker: typeof useDatePicker;
 };
 export type { DatePickerProps, CalendarType, DateRefType, CalendarItem } from './props';
-export { useDatePicker, toDayjs, BASE_WEEK_NAME, BASE_MONTH_NAME, generateTimeColumn } from './useDatePicker';
+export { useDatePicker, toDayjs, generateTimeColumn } from './useDatePicker';
 export type { TimeRefType } from './useDatePicker';

package/dist/components/base/datePicker/useDatePicker.d.ts

@@ -7,13 +7,6 @@ export type TimeRefType = {
     minutes: number;
     seconds: number;
 };
-/** 基础星期头（汉字显示） */
-export declare const BASE_WEEK_NAME: Array<{
-    day: string;
-    isCurrentMonth: boolean;
-}>;
-/** 月份名称 */
-export declare const BASE_MONTH_NAME: string[];
 /**
  * 将 string | Date 转换为 dayjs 对象。
  * headless 组件需要用此函数更新 currentRef。

package/dist/compositions/common/useLocale.d.ts

@@ -0,0 +1,14 @@
+import { ComputedRef, InjectionKey, Ref } from 'vue';
+import { KineLocaleName, KineLocaleMessages } from '../../locale/types';
+/** Accepted `locale` values: a built-in name, or a full custom dictionary. */
+export type KineLocaleConfig = KineLocaleName | KineLocaleMessages;
+export declare const KINE_LOCALE_KEY: InjectionKey<Ref<KineLocaleConfig | undefined>>;
+/**
+ * Resolve the active message dictionary from the nearest `KConfigProvider`.
+ * Falls back to the default (zh) pack when no provider is present.
+ */
+export declare function useLocale(): ComputedRef<KineLocaleMessages>;
+/** Set the global active dictionary. Called by KConfigProvider on locale change. */
+export declare function setActiveLocaleMessages(config: KineLocaleConfig | undefined): void;
+/** Read the global active dictionary from non-component (pure-function) code. */
+export declare function getActiveLocaleMessages(): KineLocaleMessages;