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

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/tooltip/api.ts

@@ -1,8 +1,8 @@
 /**
- * @description tooltip runtime props
+ * @description tooltip 运行时 props
  * @author 阿怪
  * @date 2026/2/25
- * @version v2.0.0
+ * @version v1.0.0
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
@@ -15,7 +15,6 @@ export const props: MCOPO<TooltipProps> = {
     type: String as MPropType<NonNullable<TooltipProps['placement']>>,
     default: 'top',
   },
-  delay: { type: Number, default: 300 },
   disabled: { type: Boolean, default: false },
   maxWidth: { type: String, default: undefined },
 };

package/components/base/tooltip/index.ts

@@ -1,8 +1,8 @@
 /**
- * @description tooltip core barrel export
+ * @description tooltip core 导出
  * @author 阿怪
  * @date 2026/2/25
- * @version v2.0.0
+ * @version v1.0.0
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
@@ -15,4 +15,3 @@ export const TooltipCore = {
 };
 
 export type { TooltipProps } from './props';
-export type { TooltipPlacement, TooltipPositionData } from './useTooltip';

package/components/base/tooltip/props.d.ts

@@ -1,8 +1,8 @@
 /**
- * @description tooltip type definitions
+ * @description tooltip 类型定义
  * @author 阿怪
  * @date 2026/2/25
- * @version v2.0.0
+ * @version v1.0.0
  *
  * @name m-tooltip
  * @docDescription Tooltip component.
@@ -14,31 +14,25 @@
 
 export declare type TooltipProps = {
   /**
-   * @description tooltip text content
+   * @description 提示内容，简单文本可直接通过 prop 传入
    * @type string
    * @default ''
    */
   content?: string;
   /**
-   * @description preferred placement direction
+   * @description 弹出位置
    * @type 'top' | 'bottom' | 'left' | 'right'
    * @default 'top'
    */
   placement?: 'top' | 'bottom' | 'left' | 'right';
   /**
-   * @description show delay in milliseconds
-   * @type number
-   * @default 300
-   */
-  delay?: number;
-  /**
-   * @description whether the tooltip is disabled
+   * @description 是否禁用
    * @type boolean
    * @default false
    */
   disabled?: boolean;
   /**
-   * @description max width of tooltip content
+   * @description max width of tooltip content. 浮层最大宽度
    * @type string
    * @default undefined
    */

package/components/base/tooltip/useTooltip.ts

@@ -1,208 +1,89 @@
 /**
- * @description tooltip composable — manages show/hide with delay, positioning via usePopper, singleton, scroll/interaction dismissal
+ * @description tooltip composable，管理 hover 显示/隐藏及定位
  * @author 阿怪
  * @date 2026/2/25
- * @version v2.0.0
+ * @version v1.0.0
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
-import { ref, onBeforeUnmount } from 'vue';
-import { flip, offset, shift } from '@floating-ui/dom';
-import { usePopper, type Placement, type PositionStyle } from '../../../compositions/popper/usePopper';
+import { ref, nextTick } from 'vue';
 import { TooltipProps } from './props';
 
-const HIDE_DELAY = 100;
-
-/** Singleton: only one tooltip visible at a time */
-let activeHide: (() => void) | null = null;
+export type TooltipStyle = {
+  position: string;
+  left: string;
+  top: string;
+  zIndex: string;
+};
 
-export type TooltipPlacement = Placement;
+/**
+ * 根据 trigger 元素的 getBoundingClientRect 和 placement 计算 tooltip 的 fixed 定位样式
+ */
+function calcPosition(
+  rect: DOMRect,
+  tooltipEl: HTMLElement,
+  placement: NonNullable<TooltipProps['placement']>,
+): TooltipStyle {
+  const gap = 8;
+  const tooltipRect = tooltipEl.getBoundingClientRect();
+  let left = 0;
+  let top = 0;
+
+  switch (placement) {
+    case 'top':
+      left = rect.left + rect.width / 2 - tooltipRect.width / 2;
+      top = rect.top - tooltipRect.height - gap;
+      break;
+    case 'bottom':
+      left = rect.left + rect.width / 2 - tooltipRect.width / 2;
+      top = rect.bottom + gap;
+      break;
+    case 'left':
+      left = rect.left - tooltipRect.width - gap;
+      top = rect.top + rect.height / 2 - tooltipRect.height / 2;
+      break;
+    case 'right':
+      left = rect.right + gap;
+      top = rect.top + rect.height / 2 - tooltipRect.height / 2;
+      break;
+  }
 
-export type TooltipPositionData = {
-  style: Record<string, string>;
-  arrowStyle: Record<string, string>;
-  placement: Placement;
-};
+  return {
+    position: 'fixed',
+    left: `${left}px`,
+    top: `${top}px`,
+    zIndex: '9999',
+  };
+}
 
 export function useTooltip(props: Required<TooltipProps>) {
   const visible = ref(false);
-  const positionData = ref<TooltipPositionData | null>(null);
+  const tooltipStyle = ref<TooltipStyle | Record<string, never>>({});
 
   const triggerRef = ref<HTMLElement | null>(null);
   const tooltipRef = ref<HTMLElement | null>(null);
-  const arrowRef = ref<HTMLElement | null>(null);
-
-  let showTimer: ReturnType<typeof setTimeout> | null = null;
-  let hideTimer: ReturnType<typeof setTimeout> | null = null;
-  let popperCleanup: (() => void) | null = null;
-
-  const tooltipId = `k-tooltip-${Math.random().toString(36).slice(2, 10)}`;
-
-  /** Clean up popper auto-update subscription */
-  const destroyPopper = () => {
-    if (popperCleanup) {
-      popperCleanup();
-      popperCleanup = null;
-    }
-  };
 
-  /** Immediately hide — no delay */
-  const hideImmediate = () => {
-    clearTimers();
-    visible.value = false;
-    positionData.value = null;
-    destroyPopper();
-    if (activeHide === hideImmediate) {
-      activeHide = null;
-    }
-    removeInteractionListeners();
-    removeScrollListeners();
-  };
-
-  /** Show tooltip after delay */
-  const show = () => {
+  const show = async () => {
     if (props.disabled) return;
-
-    // Dismiss any existing tooltip (singleton)
-    if (activeHide && activeHide !== hideImmediate) {
-      activeHide();
-    }
-
-    if (hideTimer) {
-      clearTimeout(hideTimer);
-      hideTimer = null;
-    }
-
-    if (visible.value) return;
-
-    const delay = props.delay ?? 300;
-    showTimer = setTimeout(() => {
-      showTimer = null;
-      if (props.disabled) return;
-      doShow();
-    }, delay);
-  };
-
-  /** Actually display the tooltip and set up popper */
-  const doShow = () => {
     visible.value = true;
-    activeHide = hideImmediate;
-    addInteractionListeners();
-    addScrollListeners();
-  };
-
-  /** Initialize popper positioning — called after tooltip DOM is mounted */
-  const initPopper = () => {
+    // 等待 tooltip DOM 渲染后再计算位置
+    await nextTick();
     if (!triggerRef.value || !tooltipRef.value) return;
-
-    destroyPopper();
-
-    const { clear } = usePopper(
-      triggerRef.value,
-      tooltipRef.value,
-      (data: PositionStyle) => {
-        positionData.value = {
-          style: { ...data.style },
-          arrowStyle: { ...data.arrowStyle },
-          placement: data.placement,
-        };
-      },
-      arrowRef.value ?? undefined,
-      {
-        placement: props.placement as Placement,
-        middleware: [
-          offset(8),
-          flip(),
-          shift({ padding: 8 }),
-        ],
-      },
-    );
-
-    popperCleanup = clear;
-  };
-
-  /** Hide tooltip with a short delay (allows cursor to move between trigger and tooltip) */
-  const hide = () => {
-    if (showTimer) {
-      clearTimeout(showTimer);
-      showTimer = null;
-    }
-
-    if (!visible.value) return;
-
-    hideTimer = setTimeout(() => {
-      hideTimer = null;
-      hideImmediate();
-    }, HIDE_DELAY);
-  };
-
-  const clearTimers = () => {
-    if (showTimer) {
-      clearTimeout(showTimer);
-      showTimer = null;
-    }
-    if (hideTimer) {
-      clearTimeout(hideTimer);
-      hideTimer = null;
-    }
-  };
-
-  /* ── Interaction listeners: dismiss on click / keydown ── */
-  const onInteraction = () => {
-    hideImmediate();
-  };
-
-  const addInteractionListeners = () => {
-    document.addEventListener('mousedown', onInteraction, true);
-    document.addEventListener('keydown', onInteraction, true);
-  };
-
-  const removeInteractionListeners = () => {
-    document.removeEventListener('mousedown', onInteraction, true);
-    document.removeEventListener('keydown', onInteraction, true);
-  };
-
-  /* ── Scroll listeners: dismiss when trigger scrolls out of view ── */
-  const onScroll = () => {
-    if (!triggerRef.value) {
-      hideImmediate();
-      return;
-    }
     const rect = triggerRef.value.getBoundingClientRect();
-    const inView =
-      rect.bottom > 0 &&
-      rect.top < window.innerHeight &&
-      rect.right > 0 &&
-      rect.left < window.innerWidth;
-    if (!inView) {
-      hideImmediate();
-    }
+    tooltipStyle.value = calcPosition(rect, tooltipRef.value, props.placement);
   };
 
-  const addScrollListeners = () => {
-    window.addEventListener('scroll', onScroll, true);
-    window.addEventListener('resize', onScroll, true);
-  };
-
-  const removeScrollListeners = () => {
-    window.removeEventListener('scroll', onScroll, true);
-    window.removeEventListener('resize', onScroll, true);
+  const hide = () => {
+    visible.value = false;
+    tooltipStyle.value = {};
   };
 
-  onBeforeUnmount(() => {
-    hideImmediate();
-  });
-
   return {
     visible,
-    positionData,
+    tooltipStyle,
     triggerRef,
     tooltipRef,
-    arrowRef,
-    tooltipId,
     show,
     hide,
-    hideImmediate,
-    initPopper,
   };
 }

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/components/base/tooltip/index.d.ts

@@ -4,4 +4,3 @@ export declare const TooltipCore: {
     useTooltip: typeof useTooltip;
 };
 export type { TooltipProps } from './props';
-export type { TooltipPlacement, TooltipPositionData } from './useTooltip';