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

package/dist/index.d.ts

@@ -63,3 +63,5 @@ export * from './components/base/rate';
 export * from './components/base/backTop';
 export * from './components/base/affix';
 export * from './components/base/anchor';
+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 };

package/dist/locale/types.d.ts

@@ -0,0 +1,222 @@
+/**
+ * @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/dist/locale/zh.d.ts

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

package/dist/runtime/defineHook.d.ts

@@ -1,3 +1,3 @@
-import { EmitsOptions, SetupContext, SlotsType } from '@vue/runtime-core';
+import { EmitsOptions, SetupContext, SlotsType } from 'vue';
 import { UseHookResult } from '../components/types/hook';
 export declare 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>;

package/dist/tools/__tests__/empty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/empty.d.ts

@@ -10,9 +10,9 @@
  * 支持稍多类型的判断非空的方法
  * @param value
  */
-export declare const notEmpty: (value: any) => number | boolean | undefined;
+export declare const notEmpty: (value: unknown) => number | boolean | undefined;
 /**
  * 判断为空的方法，即notEmpty的取反
  * @param value
  */
-export declare const isEmpty: (value: any) => boolean;
+export declare const isEmpty: (value: unknown) => boolean;

package/dist/tools/types.d.ts

@@ -6,4 +6,4 @@
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
-export declare const isBoolean: (val: any) => val is boolean;
+export declare const isBoolean: (val: unknown) => val is boolean;

package/dist/vitest.config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description @kine-design/core 单元测试配置
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+declare const _default: import('vite').UserConfig;
+export default _default;

package/index.css

@@ -0,0 +1 @@
+@import "assets/style/global.css";

package/index.ts

@@ -0,0 +1,81 @@
+/**
+ * @description
+ * @author 阿怪
+ * @date 2024/10/9 00:12
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+
+
+export * from './components/base/avatar';
+export * from './components/base/input';
+export * from './components/base/button';
+export * from './components/base/select';
+export * from './components/base/checkbox';
+export * from './components/base/switch';
+export * from './components/base/tag';
+export * from './components/base/progress';
+export * from './components/base/list';
+export * from './components/base/radio';
+export * from './components/base/li';
+export * from './components/base/inputNumber';
+export * from './components/base/slider';
+export * from './components/message/message';
+export * from './components/template/form';
+
+export * from './components/base/popover';
+export * from './components/base/tooltip';
+export * from './components/base/divider';
+export * from './components/base/loading';
+
+export * from './components/message/dialog';
+export * from './components/message/drawer';
+export * from './components/message/confirm';
+
+export * from './components/other/darkMode';
+
+export * from './components/template/breadcrumb';
+export * from './components/template/grid';
+export * from './components/template/pagination';
+export * from './components/template/menu';
+export * from './components/base/datePicker';
+export * from './components/base/tree';
+export * from './components/template/table';
+export * from './components/template/tableColumn';
+export * from './components/template/border';
+export * from './components/template/virtualList';
+export * from './components/message/popover';
+export * from './components/base/tabs';
+export * from './components/base/dropdown';
+export * from './components/base/collapse';
+export * from './components/base/steps';
+export * from './components/message/notification';
+export * from './components/base/skeleton';
+export * from './components/base/timeline';
+export * from './components/template/descriptions';
+export * from './components/base/card';
+export * from './components/base/alert';
+export * from './components/base/badge';
+export * from './components/base/empty';
+export * from './components/base/space';
+export * from './components/base/autoComplete';
+export * from './components/base/carousel';
+export * from './components/base/image';
+export * from './components/base/result';
+export * from './components/base/cascader';
+export * from './components/base/transfer';
+export * from './components/base/rate';
+export * from './components/base/backTop';
+export * from './components/base/affix';
+export * from './components/base/anchor';
+
+// i18n / locale
+export * from './locale';
+export {
+  useLocale,
+  KINE_LOCALE_KEY,
+  setActiveLocaleMessages,
+  getActiveLocaleMessages,
+  type KineLocaleConfig,
+} from './compositions/common/useLocale';

package/locale/.vlaude/last-session-id

@@ -0,0 +1 @@
+4c9b1c27-b707-4b0b-98d7-fde5d511ce47

package/locale/en.ts

@@ -0,0 +1,187 @@
+/**
+ * @description English (en) language pack.
+ * @author kine-design
+ * @version v1.0.0
+ */
+import type { KineLocaleMessages } from './types';
+
+const en: KineLocaleMessages = {
+  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…',
+  },
+};
+
+export default en;

package/locale/index.ts

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