kb-ui-vue 0.3.0 → 0.4.0

package/dist/components/Mentions/index.d.ts

@@ -0,0 +1,5 @@
+import { default as Mentions } from './Mentions.vue';
+export { Mentions };
+export default Mentions;
+export type { MentionsProps } from './Mentions.vue';
+export type { MentionOption, MentionFilter } from './types';

package/dist/components/Mentions/types.d.ts

@@ -0,0 +1,10 @@
+/** 提及候选项 */
+export interface MentionOption {
+    /** 插入文本时使用的值 */
+    value: string;
+    /** 展示文案，缺省用 value */
+    label?: string;
+    disabled?: boolean;
+}
+/** 自定义过滤函数；返回 true 表示保留 */
+export type MentionFilter = (search: string, option: MentionOption) => boolean;

package/dist/components/Popconfirm/Popconfirm.vue.d.ts

@@ -1,7 +1,8 @@
 export interface PopconfirmProps {
     title: string;
-    /** 确定按钮文字 */
+    /** 确定按钮文字，不传时取语言包中的 `popconfirm.confirmText` */
     confirmText?: string;
+    /** 取消按钮文字，不传时取语言包中的 `popconfirm.cancelText` */
     cancelText?: string;
 }
 declare var __VLS_1: {};

package/dist/components/QRCode/QRCode.vue.d.ts

@@ -0,0 +1,36 @@
+import { ECLevelName } from './qrcode';
+export interface QRCodeProps {
+    /** 编码内容（文本 / URL） */
+    value: string;
+    /** 渲染像素尺寸（含静默区），默认 160 */
+    size?: number;
+    /** 错误校正等级，默认 M */
+    level?: ECLevelName;
+    /** 静默区（quiet zone）模块数，默认 4（规范要求 ≥4） */
+    margin?: number;
+    /** 暗模块颜色，默认 #000000 */
+    color?: string;
+    /** 背景（亮模块）颜色，默认 #FFFFFF */
+    bgColor?: string;
+    /** 无障碍替代文本，默认等于 value */
+    alt?: string;
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<QRCodeProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<QRCodeProps> & Readonly<{}>, {
+    size: number;
+    color: string;
+    level: ECLevelName;
+    margin: number;
+    bgColor: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/QRCode/index.d.ts

@@ -0,0 +1,4 @@
+import { default as QRCode } from './QRCode.vue';
+export { QRCode };
+export default QRCode;
+export type { QRCodeProps } from './QRCode.vue';

package/dist/components/QRCode/qrcode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 自实现的 QR Code 编码器（零运行时依赖）。
+ *
+ * 严格遵循 ISO/IEC 18004:2006 规范，算法结构参考 MIT 许可的
+ * Kazuhiko Arase `qrcode-generator` / node `qrcode` 实现，
+ * 但全部代码为本库自有实现，便于 tree-shaking 与 SSR。
+ *
+ * 测试（`__tests__/QRCode.spec.ts`）会以固定 mode / version / maskPattern
+ * 与 `qrcode` 参考库逐模块比对，确保编码结果完全一致。
+ */
+export type ECLevelName = 'L' | 'M' | 'Q' | 'H';
+export type QRModeName = 'numeric' | 'alphanumeric' | 'byte';
+export interface QRCreateOptions {
+    /** 错误校正等级，默认 M */
+    level?: ECLevelName;
+    /** 指定版本 1-40（不指定则自动选择能容纳数据的最小版本） */
+    version?: number;
+    /** 指定编码模式；不指定则按数据自动选择 */
+    mode?: QRModeName;
+    /** 指定掩码 0-7；不指定则由惩罚函数自动选择最优掩码 */
+    maskPattern?: number;
+    /** 强制使用 UTF-8 字节模式（用于含中文等非 ASCII 文本） */
+    utf8?: boolean;
+}
+export interface QRResult {
+    /** 模块矩阵，行优先，true = 暗模块 */
+    modules: boolean[];
+    /** 模块边长（不含静默区） */
+    moduleCount: number;
+    version: number;
+    level: ECLevelName;
+    maskPattern: number;
+}
+export declare function createQRMatrix(value: string, options?: QRCreateOptions): QRResult;

package/dist/components/Search/Search.vue.d.ts

@@ -1,6 +1,9 @@
 export interface SearchProps {
     modelValue?: string;
+    /** 占位文案，不传时取语言包中的 `search.placeholder` */
     placeholder?: string;
+    /** 搜索按钮文案，不传时取语言包中的 `search.action` */
+    buttonText?: string;
     size?: 'small' | 'medium' | 'large';
 }
 declare const __VLS_export: import('vue').DefineComponent<SearchProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
@@ -13,6 +16,7 @@ declare const __VLS_export: import('vue').DefineComponent<SearchProps, {}, {}, {
     size: "small" | "medium" | "large";
     modelValue: string;
     placeholder: string;
+    buttonText: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/Splitter/Splitter.vue.d.ts

@@ -0,0 +1,34 @@
+export interface SplitterProps {
+    /** 各面板的初始占比（百分比），长度即面板数量，默认两栏均分 */
+    modelValue?: number[];
+    /** 排列方向 */
+    layout?: 'horizontal' | 'vertical';
+    /** 最小占比（百分比），拖拽不会小于该值 */
+    min?: number;
+    /** 是否禁用拖拽 */
+    disabled?: boolean;
+}
+declare var __VLS_2: `panel-${number}`, __VLS_3: {
+    index: number;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<SplitterProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: number[]) => any;
+}, string, import('vue').PublicProps, Readonly<SplitterProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: number[]) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: number[];
+    min: number;
+    layout: "horizontal" | "vertical";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/Splitter/index.d.ts

@@ -0,0 +1,4 @@
+import { default as Splitter } from './Splitter.vue';
+export { Splitter };
+export default Splitter;
+export type { SplitterProps } from './Splitter.vue';

package/dist/components/Table/Table.vue.d.ts

@@ -29,6 +29,7 @@ export interface TableProps {
     /** 已选行的 key，配合 v-model:selectedKeys */
     selectedKeys?: (string | number)[];
     /** 数据为空时的文案 */
+    /** 空数据文案，不传时取语言包中的 `table.emptyText` */
     emptyText?: string;
 }
 declare var __VLS_15: {

package/dist/components/TimePicker/TimePicker.vue.d.ts

@@ -0,0 +1,28 @@
+export interface TimePickerProps {
+    /** 时间字符串，如 '09:30' 或 '09:30:00' */
+    modelValue?: string;
+    /** 展示与录入格式，默认 'HH:mm'；含 ss 时启用秒列 */
+    format?: string;
+    /** 占位文案，不传时取语言包中的 `timePicker.placeholder` */
+    placeholder?: string;
+    disabled?: boolean;
+    clearable?: boolean;
+    /** 分钟步长，默认 1 */
+    minuteStep?: number;
+}
+declare const __VLS_export: import('vue').DefineComponent<TimePickerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+    change: (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<TimePickerProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: string;
+    placeholder: string;
+    clearable: boolean;
+    format: string;
+    minuteStep: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/TimePicker/index.d.ts

@@ -0,0 +1,4 @@
+import { default as TimePicker } from './TimePicker.vue';
+export { TimePicker };
+export default TimePicker;
+export type { TimePickerProps } from './TimePicker.vue';

package/dist/components/Tour/Tour.vue.d.ts

@@ -0,0 +1,37 @@
+export type TourPlacement = 'top' | 'bottom' | 'left' | 'right';
+export interface TourStep {
+    /** 目标元素选择器，如 '#step-1'；不传时气泡居中显示 */
+    target?: string;
+    title: string;
+    description?: string;
+    placement?: TourPlacement;
+}
+export interface TourProps {
+    /** 是否显示引导 */
+    modelValue?: boolean;
+    steps?: TourStep[];
+    current?: number;
+    /** 是否展示跳过按钮，默认 true */
+    showSkip?: boolean;
+    /** 遮罩是否允许点击关闭 */
+    maskClosable?: boolean;
+}
+declare const __VLS_export: import('vue').DefineComponent<TourProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+    change: (current: number) => any;
+    finish: () => any;
+    "update:current": (value: number) => any;
+}, string, import('vue').PublicProps, Readonly<TourProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onChange?: ((current: number) => any) | undefined;
+    onFinish?: (() => any) | undefined;
+    "onUpdate:current"?: ((value: number) => any) | undefined;
+}>, {
+    modelValue: boolean;
+    current: number;
+    steps: TourStep[];
+    showSkip: boolean;
+    maskClosable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/Tour/index.d.ts

@@ -0,0 +1,4 @@
+import { default as Tour } from './Tour.vue';
+export { Tour };
+export default Tour;
+export type { TourProps, TourStep, TourPlacement } from './Tour.vue';

package/dist/components/TreeSelect/TreeSelect.vue.d.ts

@@ -0,0 +1,32 @@
+export interface TreeSelectNode {
+    label: string;
+    value: string | number;
+    children?: TreeSelectNode[];
+    disabled?: boolean;
+}
+export interface TreeSelectProps {
+    options?: TreeSelectNode[];
+    modelValue?: string | number | undefined;
+    /** 占位文案，不传时取语言包中的 `common.placeholder` */
+    placeholder?: string;
+    disabled?: boolean;
+    clearable?: boolean;
+    /** 初始是否展开全部可展开节点 */
+    defaultExpandAll?: boolean;
+}
+declare const __VLS_export: import('vue').DefineComponent<TreeSelectProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string | number | undefined) => any;
+    change: (value: string | number | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<TreeSelectProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | number | undefined) => any) | undefined;
+    onChange?: ((value: string | number | undefined) => any) | undefined;
+}>, {
+    disabled: boolean;
+    modelValue: string | number;
+    placeholder: string;
+    clearable: boolean;
+    options: TreeSelectNode[];
+    defaultExpandAll: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/TreeSelect/index.d.ts

@@ -0,0 +1,4 @@
+import { default as TreeSelect } from './TreeSelect.vue';
+export { TreeSelect };
+export default TreeSelect;
+export type { TreeSelectProps, TreeSelectNode } from './TreeSelect.vue';

package/dist/components/VirtualList/VirtualList.vue.d.ts

@@ -0,0 +1,29 @@
+import { VirtualListProps } from './types';
+declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import('vue').PublicProps & __VLS_PrettifyLocal<VirtualListProps<T> & {
+        onScroll?: ((scrollTop: number) => any) | undefined;
+        onReachEnd?: (() => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        item?: (props: {
+            item: T;
+            index: number;
+        }) => any;
+    } & {
+        empty?: (props: {}) => any;
+    };
+    emit: ((evt: "scroll", scrollTop: number) => void) & ((evt: "reachEnd") => void);
+}>) => import('vue').VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/VirtualList/index.d.ts

@@ -0,0 +1,4 @@
+import { default as VirtualList } from './VirtualList.vue';
+export { VirtualList };
+export default VirtualList;
+export type { VirtualListProps } from './types';

package/dist/components/VirtualList/types.d.ts

@@ -0,0 +1,12 @@
+export interface VirtualListProps<T = unknown> {
+    /** 数据源 */
+    items: T[];
+    /** 单项高度（px），固定高度模式 */
+    itemHeight: number;
+    /** 可视区高度（px） */
+    height: number;
+    /** 视口上下各额外渲染的项数，减少快速滚动时的白屏 */
+    buffer?: number;
+    /** 触发 reachEnd 的提前量（px） */
+    reachEndThreshold?: number;
+}

package/dist/composables/useGlobalConfig.d.ts

@@ -0,0 +1,45 @@
+import { InjectionKey, Ref } from 'vue';
+import { getLocale, ProjectLocale } from '../locale';
+import { LocalePath } from '../locale/types';
+/** 组件统一尺寸 */
+export type ComponentSize = 'small' | 'medium' | 'large';
+/** 主题模式 */
+export type ThemeMode = 'light' | 'dark';
+/** 全局配置结构 */
+export interface GlobalConfig {
+    /** 语言包 */
+    locale: ProjectLocale;
+    /** 组件默认尺寸 */
+    size: ComponentSize;
+    /** 弹层基础层级，实际层级在此基础上累加 */
+    zIndex: number;
+    /** 主题模式 */
+    theme: ThemeMode;
+}
+export declare const defaultGlobalConfig: GlobalConfig;
+export declare const configKey: InjectionKey<GlobalConfig>;
+/** 由 ConfigProvider 调用，向其子树注入配置 */
+export declare function provideGlobalConfig(config: GlobalConfig): void;
+/** 读取全局配置，未包裹 ConfigProvider 时返回默认配置 */
+export declare function useGlobalConfig(): GlobalConfig;
+/** 读取当前尺寸，允许组件自身的 size prop 优先覆盖 */
+export declare function useSize(local?: ComponentSize): ComponentSize;
+/** 读取弹层基础层级 */
+export declare function useZIndex(): number;
+export type Translate = (path: LocalePath, ...args: unknown[]) => string;
+/**
+ * 读取语言包与取值函数
+ *
+ * 组件内置文案一律走 t()，这样 ConfigProvider 只需换 locale 即可整站切换语言。
+ *
+ * 两个返回值的响应式语义：
+ * - `t` 每次调用时才读取当前语言包，因此可安全地在 computed / 模板中使用，
+ *   ConfigProvider 切换语言后会自动重渲染；
+ * - `locale` 是 ref，读取具体字段需写 `locale.value.xxx`（同样具备响应性）。
+ */
+export declare function useLocale(): {
+    t: Translate;
+    locale: Ref<ProjectLocale>;
+};
+/** 按名称解析语言包，未知名称回退到默认语言 */
+export { getLocale };

package/dist/global.d.ts

@@ -0,0 +1,90 @@
+/* eslint-disable */
+/* 由 scripts/build-global-types.mjs 自动生成，请勿手动修改 */
+import type * as KB from './index'
+
+declare module 'vue' {
+  export interface GlobalComponents {
+    KbAffix: typeof KB.KbAffix
+    KbAlert: typeof KB.KbAlert
+    KbAnchor: typeof KB.KbAnchor
+    KbAutoComplete: typeof KB.KbAutoComplete
+    KbAvatar: typeof KB.KbAvatar
+    KbBackTop: typeof KB.KbBackTop
+    KbBadge: typeof KB.KbBadge
+    KbBreadcrumb: typeof KB.KbBreadcrumb
+    KbButton: typeof KB.KbButton
+    KbCalendar: typeof KB.KbCalendar
+    KbCard: typeof KB.KbCard
+    KbCarousel: typeof KB.KbCarousel
+    KbCascader: typeof KB.KbCascader
+    KbCheckbox: typeof KB.KbCheckbox
+    KbCol: typeof KB.KbCol
+    KbCollapse: typeof KB.KbCollapse
+    KbColorPicker: typeof KB.KbColorPicker
+    KbConfigProvider: typeof KB.KbConfigProvider
+    KbContent: typeof KB.KbContent
+    KbContextMenu: typeof KB.KbContextMenu
+    KbCountUp: typeof KB.KbCountUp
+    KbDatePicker: typeof KB.KbDatePicker
+    KbDescriptions: typeof KB.KbDescriptions
+    KbDialog: typeof KB.KbDialog
+    KbDivider: typeof KB.KbDivider
+    KbDrawer: typeof KB.KbDrawer
+    KbDropdown: typeof KB.KbDropdown
+    KbEmpty: typeof KB.KbEmpty
+    KbFloatButton: typeof KB.KbFloatButton
+    KbFloatButtonGroup: typeof KB.KbFloatButtonGroup
+    KbFooter: typeof KB.KbFooter
+    KbForm: typeof KB.KbForm
+    KbFormItem: typeof KB.KbFormItem
+    KbHeader: typeof KB.KbHeader
+    KbIcon: typeof KB.KbIcon
+    KbImage: typeof KB.KbImage
+    KbImagePreview: typeof KB.KbImagePreview
+    KbInput: typeof KB.KbInput
+    KbInputNumber: typeof KB.KbInputNumber
+    KbInputPassword: typeof KB.KbInputPassword
+    KbLayout: typeof KB.KbLayout
+    KbList: typeof KB.KbList
+    KbLoading: typeof KB.KbLoading
+    KbMentions: typeof KB.KbMentions
+    KbMessage: typeof KB.KbMessage
+    KbNotification: typeof KB.KbNotification
+    KbPagination: typeof KB.KbPagination
+    KbPopconfirm: typeof KB.KbPopconfirm
+    KbPopover: typeof KB.KbPopover
+    KbProgress: typeof KB.KbProgress
+    KbQRCode: typeof KB.KbQRCode
+    KbRadio: typeof KB.KbRadio
+    KbRate: typeof KB.KbRate
+    KbResult: typeof KB.KbResult
+    KbRow: typeof KB.KbRow
+    KbSearch: typeof KB.KbSearch
+    KbSegmented: typeof KB.KbSegmented
+    KbSelect: typeof KB.KbSelect
+    KbSider: typeof KB.KbSider
+    KbSkeleton: typeof KB.KbSkeleton
+    KbSlider: typeof KB.KbSlider
+    KbSpace: typeof KB.KbSpace
+    KbSplitter: typeof KB.KbSplitter
+    KbStatistic: typeof KB.KbStatistic
+    KbSteps: typeof KB.KbSteps
+    KbSwitch: typeof KB.KbSwitch
+    KbTable: typeof KB.KbTable
+    KbTabs: typeof KB.KbTabs
+    KbTag: typeof KB.KbTag
+    KbTextarea: typeof KB.KbTextarea
+    KbTimePicker: typeof KB.KbTimePicker
+    KbTimeline: typeof KB.KbTimeline
+    KbTooltip: typeof KB.KbTooltip
+    KbTour: typeof KB.KbTour
+    KbTransfer: typeof KB.KbTransfer
+    KbTree: typeof KB.KbTree
+    KbTreeSelect: typeof KB.KbTreeSelect
+    KbUpload: typeof KB.KbUpload
+    KbVirtualList: typeof KB.KbVirtualList
+    KbWatermark: typeof KB.KbWatermark
+  }
+}
+
+export {}