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

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/index.ts

@@ -71,3 +71,13 @@ export * from './components/base/affix';
 export * from './components/base/anchor';
 
 export * from './compositions/overlay';
+
+// 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 };

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;
+  };
+}