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

package/locale/types.ts

@@ -0,0 +1,214 @@
+/**
+ * @description kine-design locale message contract.
+ *   The single source of truth for every user-facing string in the component
+ *   library. Each language pack (zh / en) must implement this interface in
+ *   full — a missing key is a compile error, which is exactly the guarantee we
+ *   want so translations never silently drift out of sync.
+ * @author kine-design
+ * @version v1.0.0
+ */
+
+/**
+ * Built-in language pack identifiers. The library ships only the two general
+ * languages (zh / en). App-specific languages — e.g. Bengali in the factory —
+ * are supplied by the consumer as a full `KineLocaleMessages` object passed to
+ * `<KConfigProvider :locale="...">`, not bundled here.
+ */
+export type KineLocaleName = 'zh' | 'en';
+
+/** Full message dictionary consumed by components via `useLocale()`. */
+export interface KineLocaleMessages {
+  /** Shared atoms reused across many components. */
+  common: {
+    confirm: string;
+    cancel: string;
+    close: string;
+    search: string;
+    reset: string;
+    all: string;
+    noData: string;
+    loading: string;
+    save: string;
+  };
+  pagination: {
+    /** Text before the count, e.g. "共 " (en: ""). The count renders in its
+     *  own <span> between prefix and suffix so per-language word order works. */
+    totalPrefix: string;
+    /** Text after the count, e.g. " 条" (en: " items"). */
+    totalSuffix: string;
+  };
+  datePicker: {
+    placeholder: string;
+    /** e.g. "2026年" / "2026" */
+    year: (year: number | string) => string;
+    /** e.g. "6月" / "Jun" */
+    month: (month: number | string) => string;
+    hour: string;
+    minute: string;
+    second: string;
+    confirm: string;
+    /** 7 entries, Sun→Sat ordering as rendered in the calendar header. */
+    weekNames: readonly [string, string, string, string, string, string, string];
+    /** 12 entries, Jan→Dec. */
+    monthNames: readonly [
+      string, string, string, string, string, string,
+      string, string, string, string, string, string,
+    ];
+  };
+  timePicker: {
+    placeholder: string;
+    hour: string;
+    minute: string;
+    second: string;
+  };
+  select: {
+    placeholder: string;
+    clear: string;
+    noData: string;
+    loading: string;
+  };
+  autoComplete: {
+    placeholder: string;
+    loading: string;
+    clear: string;
+    noData: string;
+  };
+  cascader: {
+    placeholder: string;
+    noMatch: string;
+  };
+  image: {
+    loadError: string;
+    zoomOut: string;
+    zoomIn: string;
+    rotate: string;
+    close: string;
+  };
+  transfer: {
+    sourceTitle: string;
+    targetTitle: string;
+    noData: string;
+    filterPlaceholder: string;
+  };
+  empty: {
+    description: string;
+  };
+  /** Accessibility labels (screen-reader / title text). */
+  a11y: {
+    rate: string;
+    tagClose: string;
+    anchorNav: string;
+    backTop: string;
+    carouselPrev: string;
+    carouselNext: string;
+    toLightMode: string;
+    toDarkMode: string;
+    expandSider: string;
+    collapseSider: string;
+  };
+  upload: {
+    trigger: string;
+    triggerSimple: string;
+    /** e.g. 文件 "a.png" 超过大小限制（最大 2MB） */
+    oversize: (name: string, max?: string) => string;
+    uploadFailed: string;
+    statusWaiting: string;
+    statusUploading: string;
+    statusDone: string;
+    statusFailed: string;
+  };
+  searchTable: {
+    search: string;
+    reset: string;
+  };
+  editableTable: {
+    summary: string;
+    addRow: string;
+    addFirstRow: string;
+    confirmDelete: string;
+    delete: string;
+    cancel: string;
+    noData: string;
+  };
+  formPage: {
+    loading: string;
+    cancel: string;
+    saveDraft: string;
+    save: string;
+    saving: string;
+    submit: string;
+    submitting: string;
+    basicInfo: string;
+    /** e.g. "编辑订单" / "Edit Order" */
+    editTitle: (title: string) => string;
+    /** e.g. "新建订单" / "New Order" */
+    createTitle: (title: string) => string;
+  };
+  approvalDialog: {
+    submitTitle: string;
+    submitConfirm: string;
+    approveTitle: string;
+    approveConfirm: string;
+    rejectTitle: string;
+    rejectConfirm: string;
+    rejectPlaceholder: string;
+    remarkPlaceholder: string;
+    required: string;
+    cancel: string;
+    processing: string;
+  };
+  crudPage: {
+    all: string;
+    /** e.g. "请输入名称" / "Enter Name" */
+    fieldPlaceholder: (label: string) => string;
+  };
+  login: {
+    username: string;
+    usernamePlaceholder: string;
+    password: string;
+    passwordPlaceholder: string;
+    remember: string;
+    login: string;
+    loggingIn: string;
+  };
+  form: {
+    inputPlaceholder: (label: string) => string;
+    selectPlaceholder: (label: string) => string;
+  };
+  routes: {
+    createSuffix: string;
+    editSuffix: string;
+    detailSuffix: string;
+  };
+  /** User-facing request / error feedback (dev-only throws stay hardcoded). */
+  request: {
+    success: string;
+    opFailed: string;
+    failed: string;
+    failedWithStatus: (status: number | string) => string;
+    failedWithMsg: (msg: string) => string;
+    timeout: string;
+    timeoutRetry: string;
+    canceled: string;
+    permissionDenied: string;
+    invalidUrl: (url: string) => string;
+    decodeFailed: (reason: string) => string;
+    parseFailed: string;
+    networkError: string;
+    networkException: string;
+    unknownError: (error: string) => string;
+    unknown: string;
+    uploadFailed: string;
+    uploadCanceled: string;
+  };
+  aiChat: {
+    inputPlaceholder: string;
+    send: string;
+    /** e.g. "对话 3" / "Chat 3" */
+    defaultTitle: (n: number) => string;
+    phaseTyping: string;
+    phaseThinking: string;
+    phaseReplying: string;
+    phaseSending: string;
+  };
+}

package/locale/zh.ts

@@ -0,0 +1,190 @@
+/**
+ * @description Chinese (zh) language pack — the historical default. Strings are
+ *   lifted verbatim from the components they replace, so existing zh behaviour
+ *   is preserved exactly. One deliberate fix: `weekNames` previously rendered
+ *   financial numerals (壹/贰/叁…) which was placeholder data leaked into prod.
+ * @author kine-design
+ * @version v1.0.0
+ */
+import type { KineLocaleMessages } from './types';
+
+const zh: KineLocaleMessages = {
+  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: '发送中…',
+  },
+};
+
+export default zh;

package/package.json

@@ -1,32 +1,38 @@
 {
   "name": "@kine-design/core",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.11",
   "description": "",
   "type": "module",
   "main": "./dist/core.js",
-  "module": "./dist/core.js",
   "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/core.js"
-      }
-    },
-    "./*": "./*"
+  "peerDependencies": {
+    "vue": "^3.5.30"
   },
-  "files": [
-    "dist"
-  ],
   "dependencies": {
-    "@floating-ui/dom": "^1.5.4",
-    "dayjs": "^1.11.10",
+    "@floating-ui/dom": "^1.7.6",
+    "dayjs": "^1.11.20",
     "interactjs": "^1.10.26"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "files": [
+      "dist"
+    ]
+  },
+  "devDependencies": {
+    "vitest": "^4.1.0"
   },
   "scripts": {
-    "build": "vite build --config vite.config.build.ts"
+    "build": "vite build --config vite.config.build.ts",
+    "test": "vitest --config vitest.config.ts --run"
+  },
+  "module": "./dist/core.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/core.js"
+      }
+    }
   }
 }

package/runtime/defineHook.ts

@@ -0,0 +1,21 @@
+/**
+ * @description used to create powerful typescript support hook define
+ * @author 阿怪
+ * @date 2024/12/16 11:10
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { EmitsOptions, SetupContext, SlotsType } from 'vue';
+import { UseHookResult } from '../components/types/hook';
+
+
+export const defineHook = <
+  Props extends Record<string, any>,
+  E extends EmitsOptions = {},
+  S extends SlotsType = {},
+  Return = any
+>(hook: (props: Props, ctx: SetupContext<E, S>) => Return):
+  (props: Props, ctx: SetupContext<E, S>) => UseHookResult<Props, S, Return> => {
+    return hook;
+}

package/tools/__tests__/empty.test.ts

@@ -0,0 +1,91 @@
+/**
+ * @description notEmpty / isEmpty 工具函数测试
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { notEmpty, isEmpty } from '../empty';
+
+describe('notEmpty', () => {
+  // 基本空值
+  it('null 为空', () => expect(notEmpty(null)).toBe(false));
+  it('undefined 为空', () => expect(notEmpty(undefined)).toBe(false));
+
+  // 字符串
+  it('空字符串为空', () => expect(notEmpty('')).toBe(false));
+  it('非空字符串非空', () => expect(notEmpty('hello')).toBe(true));
+
+  // 数字
+  it('0 非空', () => expect(notEmpty(0)).toBe(true));
+  it('正数非空', () => expect(notEmpty(42)).toBe(true));
+  it('NaN 非空（数字类型）', () => expect(notEmpty(NaN)).toBe(true));
+
+  // 布尔
+  it('false 非空', () => expect(notEmpty(false)).toBe(true));
+  it('true 非空', () => expect(notEmpty(true)).toBe(true));
+
+  // 函数
+  it('函数非空', () => expect(notEmpty(() => {})).toBe(true));
+
+  // Symbol
+  it('空 Symbol 为空', () => expect(notEmpty(Symbol())).toBe(false));
+  it('有描述的 Symbol 非空', () => expect(notEmpty(Symbol('desc'))).toBe(true));
+
+  // 数组
+  it('空数组为空', () => expect(notEmpty([])).toBe(false));
+  it('非空数组非空', () => expect(notEmpty([1])).toBe(true));
+
+  // 对象
+  it('空对象为空', () => expect(notEmpty({})).toBe(false));
+  it('非空对象非空', () => expect(notEmpty({ a: 1 })).toBe(true));
+
+  // Map / Set
+  it('空 Map 为空', () => expect(notEmpty(new Map())).toBe(false));
+  it('非空 Map 非空', () => expect(notEmpty(new Map([['a', 1]]))).toBe(true));
+  it('空 Set 为空', () => expect(notEmpty(new Set())).toBe(false));
+  it('非空 Set 非空', () => expect(notEmpty(new Set([1]))).toBe(true));
+
+  // Date
+  it('有效 Date 非空', () => expect(notEmpty(new Date())).toBe(true));
+  it('Invalid Date 为空', () => expect(notEmpty(new Date('invalid'))).toBe(false));
+
+  // RegExp
+  it('空正则为空', () => expect(notEmpty(new RegExp(''))).toBe(false));
+  it('非空正则非空', () => expect(notEmpty(/abc/)).toBe(true));
+
+  // TypedArray
+  // notEmpty 对 TypedArray 返回 value.length（number），0 为 falsy，>0 为 truthy
+  it('空 Uint8Array 为空', () => expect(notEmpty(new Uint8Array(0))).toBe(0));
+  it('非空 Float64Array 非空', () => expect(notEmpty(new Float64Array([1.5]))).toBe(1));
+
+  // WeakMap / WeakSet — 无法判断是否为空，始终返回 false 并 console.error
+  it('WeakMap 无法判断，返回 false', () => {
+    const spy = vi.spyOn(console, 'error').mockImplementation(() => {});
+    expect(notEmpty(new WeakMap())).toBe(false);
+    expect(spy).toHaveBeenCalledWith('WeakMap和WeakSet无法以通用的方式判断是否为空。');
+    spy.mockRestore();
+  });
+  it('WeakSet 无法判断，返回 false', () => {
+    const spy = vi.spyOn(console, 'error').mockImplementation(() => {});
+    expect(notEmpty(new WeakSet())).toBe(false);
+    expect(spy).toHaveBeenCalledWith('WeakMap和WeakSet无法以通用的方式判断是否为空。');
+    spy.mockRestore();
+  });
+
+  // BigInt — typeof bigint 分支，始终返回 true
+  it('BigInt(0) 非空', () => expect(notEmpty(BigInt(0))).toBe(true));
+  it('BigInt(42) 非空', () => expect(notEmpty(BigInt(42))).toBe(true));
+});
+
+describe('isEmpty', () => {
+  it('是 notEmpty 的取反', () => {
+    expect(isEmpty(null)).toBe(true);
+    expect(isEmpty('hello')).toBe(false);
+    expect(isEmpty(0)).toBe(false);
+    expect(isEmpty([])).toBe(true);
+    expect(isEmpty({})).toBe(true);
+  });
+});

package/tools/empty.ts

@@ -0,0 +1,81 @@
+/**
+ * @description common tools
+ * @author 阿怪
+ * @date 2023/4/20 22:31
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+
+/**
+ * 支持稍多类型的判断非空的方法
+ * @param value
+ */
+export const notEmpty = (value: unknown) => {
+  // 先处理基本类型
+  // null
+  // undefined
+  if (value === undefined || value === null) {
+    return false;
+  }
+  const valueType = typeof value;
+  // string
+  if (valueType === 'string') {
+    return value !== '';
+  }
+  // number bigint boolean
+  if (valueType === 'number' || valueType === 'bigint' || valueType === 'boolean' || valueType === 'function') {
+    return true;
+  }
+  // symbol
+  if (valueType === 'symbol') {
+    return value.toString() !== 'Symbol()';
+  }
+
+  if (valueType === 'object') {
+    // Bigint/Symbol no new
+
+    if (value instanceof String || value instanceof Array) {
+      return value.length !== 0;
+    }
+
+    if (value instanceof Number || value instanceof Boolean) {
+      return true;
+    }
+
+    if (value instanceof Map || value instanceof Set) {
+      return value.size > 0;
+    }
+
+    if (value instanceof WeakMap || value instanceof WeakSet) {
+      console.error('WeakMap和WeakSet无法以通用的方式判断是否为空。');
+      return false;
+    }
+
+    if (value instanceof RegExp) {
+      return value.toString() !== '/(?:)/';
+    }
+
+    if (value instanceof Date) {
+      return value.toString() !== 'Invalid Date';
+    }
+
+    const typedArrayTypes = [Int8Array, Uint8Array, Uint8ClampedArray,
+      Int16Array, Uint16Array,
+      Int32Array, Uint32Array, Float32Array,
+      Float64Array];
+    for (const arrayType of typedArrayTypes) {
+      if (value instanceof arrayType) {
+        return value.length;
+      }
+    }
+
+    return Object.keys(value).length > 0;
+  }
+};
+
+/**
+ * 判断为空的方法，即notEmpty的取反
+ * @param value
+ */
+export const isEmpty = (value: unknown) => !notEmpty(value);

package/tools/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @description tools index
+ * @author 阿怪
+ * @date 2023/4/20 22:38
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+// import clsx from 'clsx';
+//
+// export {
+//   clsx
+// };
+export * from './empty.ts';
+export * from './types.ts';

package/tools/types.ts

@@ -0,0 +1,11 @@
+/**
+ * @description types check
+ * @author 阿怪
+ * @date 2023/4/20 23:05
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+
+
+export const isBoolean = (val: unknown): val is boolean => typeof val === 'boolean';

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": "./lib",
+    "jsx": "preserve",
+    "jsxImportSource": "vue"
+  }
+}