@ccn-ui-kit/select 0.1.2

package/dist/packages/components/tree/src/tree.d.ts

@@ -0,0 +1,134 @@
+import { ComputedRef, ExtractPropTypes, InjectionKey, PropType, Ref } from 'vue';
+
+/** 树节点原始数据（字段名可用 props 配置） */
+export interface TreeData {
+    [key: string]: unknown;
+    children?: TreeData[];
+}
+/** 节点字段映射配置 */
+export interface TreePropsConfig {
+    /** 节点显示文案字段 */
+    label?: string;
+    /** 子节点数组字段 */
+    children?: string;
+    /** 禁用字段 */
+    disabled?: string;
+    /** 叶子标记字段（配合 lazy 使用） */
+    isLeaf?: string;
+    /** 节点唯一键字段 */
+    key?: string;
+}
+export declare const defaultTreePropsConfig: TreePropsConfig;
+/** 节点唯一键（统一为 string | number） */
+export type KeyType = string | number;
+/** 组件内部使用的树节点模型（由 data 构建，含父/子引用与层级） */
+export interface TreeNode {
+    key: KeyType;
+    data: TreeData;
+    parent: TreeNode | null;
+    children: TreeNode[];
+    level: number;
+    isLeaf: boolean;
+    isLazy: boolean;
+    path: string;
+}
+/** 懒加载参数：根节点 load 时 node 为 null */
+export interface TreeNodeLoadArg {
+    key: KeyType;
+    level: number;
+    data: TreeData;
+}
+export type TreeNodeLoader = (node: TreeNodeLoadArg | null, resolve: (children: TreeData[]) => void) => void;
+export declare const treeProps: {
+    /** 树数据 */
+    readonly data: {
+        readonly type: PropType<TreeData[]>;
+        readonly default: () => never[];
+    };
+    /** 字段映射：{ label, children, disabled, isLeaf, key }，缺省用默认字段名 */
+    readonly props: {
+        readonly type: PropType<TreePropsConfig>;
+        readonly default: () => {};
+    };
+    /** 节点唯一键字段，缺省取 props.key */
+    readonly nodeKey: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 是否展示复选框 */
+    readonly showCheckbox: BooleanConstructor;
+    /** 勾选是否严格（父子不联动，仅影响复选框） */
+    readonly checkStrictly: BooleanConstructor;
+    /** 默认展开所有节点 */
+    readonly defaultExpandAll: BooleanConstructor;
+    /** 默认展开的节点 key 列表 */
+    readonly defaultExpandedKeys: {
+        readonly type: PropType<KeyType[]>;
+        readonly default: () => never[];
+    };
+    /** 初始勾选的节点 key 列表（可在外部用 ref.setCheckedKeys 再控制） */
+    readonly defaultCheckedKeys: {
+        readonly type: PropType<KeyType[]>;
+        readonly default: () => never[];
+    };
+    /** 点击节点是否展开/收起（默认 true） */
+    readonly expandOnClickNode: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** 当前选中节点 key（v-model:current-node-key） */
+    readonly currentNodeKey: {
+        readonly type: [StringConstructor, NumberConstructor];
+        readonly default: null;
+    };
+    /** 懒加载（需配合 load 使用） */
+    readonly lazy: BooleanConstructor;
+    /** 懒加载函数：(node, resolve) => void */
+    readonly load: {
+        readonly type: PropType<TreeNodeLoader>;
+        readonly default: undefined;
+    };
+    /** 空数据提示文案 */
+    readonly emptyText: {
+        readonly type: StringConstructor;
+        readonly default: "暂无数据";
+    };
+};
+export declare const treeEmits: {
+    'update:current-node-key': null;
+    'update:checked-keys': null;
+    /** 点击节点：node / data / 原生事件 */
+    'node-click': (node: TreeNode, data: TreeData, e: MouseEvent) => boolean;
+    /** 节点展开 */
+    'node-expand': () => boolean;
+    /** 节点收起 */
+    'node-collapse': () => boolean;
+    /** 复选框勾选状态改变 */
+    check: (node: TreeNode, data: TreeData) => boolean;
+    /** 节点勾选状态变化（含级联影响的节点） */
+    'check-change': (node: TreeNode, data: TreeData, checked: boolean) => boolean;
+    /** 右键节点 */
+    'node-contextmenu': (e: MouseEvent, data: TreeData, node: TreeNode) => boolean;
+};
+export type TreeProps = ExtractPropTypes<typeof treeProps>;
+/** 提供给内部 UiTreeNode 的共享上下文 */
+export interface TreeContext {
+    config: ComputedRef<Required<TreePropsConfig>>;
+    nodeKeyField: ComputedRef<string>;
+    expandedKeys: Ref<Set<KeyType>>;
+    checkedKeys: Ref<Set<KeyType>>;
+    halfCheckedKeys: Ref<Set<KeyType>>;
+    selectedKey: Ref<KeyType | null>;
+    loadingKeys: Ref<Set<KeyType>>;
+    showCheckbox: ComputedRef<boolean>;
+    checkStrictly: ComputedRef<boolean>;
+    expandOnClickNode: ComputedRef<boolean>;
+    lazy: ComputedRef<boolean>;
+    isDisabledNode: (node: TreeNode) => boolean;
+    toggleExpand: (node: TreeNode) => void;
+    handleNodeClick: (node: TreeNode, data: TreeData, e: MouseEvent) => void;
+    handleNodeContextMenu: (node: TreeNode, data: TreeData, e: MouseEvent) => void;
+    toggleCheck: (node: TreeNode, data: TreeData) => void;
+    loadNodeData: (node: TreeNode) => void;
+}
+export declare const treeContextKey: InjectionKey<TreeContext>;

package/dist/packages/components/upload/index.d.ts

@@ -0,0 +1,10 @@
+import { App } from 'vue';
+import { default as Upload } from './src/upload.vue';
+
+export declare const UploadPlugin: {
+    name: string;
+    install(app: App): void;
+};
+export { Upload };
+export default Upload;
+export * from './src/upload';

package/dist/packages/components/upload/src/upload.d.ts

@@ -0,0 +1,103 @@
+import { ExtractPropTypes, PropType } from 'vue';
+
+/** 文件上传状态 */
+export type UploadStatus = 'ready' | 'uploading' | 'success' | 'fail';
+/** 文件列表展示类型 */
+export type UploadListType = 'text' | 'picture' | 'picture-card';
+/** 列表中的单个文件 */
+export interface UploadFile {
+    /** 组件内唯一标识（新增时自增生成） */
+    uid: number;
+    /** 文件名 */
+    name: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** MIME 类型 */
+    type: string;
+    /** 当前上传状态 */
+    status: UploadStatus;
+    /** 上传进度 0-100 */
+    percentage: number;
+    /** 原始 File 对象 */
+    raw: File;
+    /** 本地预览地址（仅图片，blob: URL） */
+    url?: string;
+    /** 上传成功/失败后的响应 */
+    response?: unknown;
+}
+export declare const uploadProps: {
+    /** 上传请求的 URL；留空时不发起请求，文件直接标记为成功（便于无后端演示） */
+    readonly action: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** FormData 中文件字段的 key */
+    readonly name: {
+        readonly type: StringConstructor;
+        readonly default: "file";
+    };
+    /** 是否允许多选 */
+    readonly multiple: BooleanConstructor;
+    /** 原生 input 的 accept，如 'image/*'、'.zip,.rar' */
+    readonly accept: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** 禁用上传 */
+    readonly disabled: BooleanConstructor;
+    /** 最大文件数，0 表示不限制 */
+    readonly limit: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** 自定义请求头 */
+    readonly headers: {
+        readonly type: PropType<Record<string, string>>;
+        readonly default: () => {};
+    };
+    /** 附加的 FormData 字段 */
+    readonly data: {
+        readonly type: PropType<Record<string, unknown>>;
+        readonly default: () => {};
+    };
+    /** 跨域时是否携带 cookie */
+    readonly withCredentials: BooleanConstructor;
+    /** 是否支持拖拽上传（将触发器区域变成拖拽区） */
+    readonly drag: BooleanConstructor;
+    /** 选择文件后是否立即上传；false 时仅加入列表，等待手动触发 */
+    readonly autoUpload: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** 是否展示文件列表 */
+    readonly showFileList: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** 列表展示类型 */
+    readonly listType: {
+        readonly type: PropType<UploadListType>;
+        readonly default: "text";
+    };
+    /** 受控文件列表（配合 v-model:file-list 使用） */
+    readonly fileList: {
+        readonly type: PropType<UploadFile[]>;
+        readonly default: () => never[];
+    };
+};
+export declare const uploadEmits: {
+    readonly 'update:file-list': (files: UploadFile[]) => boolean;
+    /** 文件列表变化（新增 / 移除） */
+    readonly change: (files: UploadFile[]) => boolean;
+    /** 上传成功 */
+    readonly success: (file: UploadFile, response?: unknown) => boolean;
+    /** 上传失败 */
+    readonly error: (file: UploadFile, error: unknown) => boolean;
+    /** 上传进度 */
+    readonly progress: (file: UploadFile, percent: number) => boolean;
+    /** 移除文件 */
+    readonly remove: (file: UploadFile) => boolean;
+    /** 超出 limit 限制 */
+    readonly exceed: (files: File[], limit: number) => boolean;
+};
+export type UploadProps = ExtractPropTypes<typeof uploadProps>;

package/dist/packages/directives/index.d.ts

@@ -0,0 +1,2 @@
+export * from './loading';
+export * from './permission';

package/dist/packages/directives/loading/index.d.ts

@@ -0,0 +1,11 @@
+import { Directive } from 'vue';
+
+/**
+ * v-loading 指令
+ * 用法：
+ *   v-loading="true"                布尔开关
+ *   v-loading="'加载中...'"          字符串作为提示文案
+ *   v-loading.fullscreen="true"     全屏遮罩
+ * 内部复用 Loading 组件渲染遮罩。
+ */
+export declare const vLoading: Directive<HTMLElement>;

package/dist/packages/directives/permission/index.d.ts

@@ -0,0 +1,3 @@
+import { Directive } from 'vue';
+
+export declare const vPermission: Directive;

package/dist/packages/ui-kit/index.d.ts

@@ -0,0 +1,34 @@
+import { App } from 'vue';
+
+export declare function install(app: App): void;
+declare const _default: {
+    install: typeof install;
+};
+export default _default;
+export * from '../components/button';
+export * from '../components/input';
+export * from '../components/badge';
+export * from '../components/breadcrumb';
+export * from '../components/date-picker';
+export * from '../components/descriptions';
+export * from '../components/divider';
+export * from '../components/dropdown';
+export * from '../components/icon';
+export * from '../components/link';
+export * from '../components/loading';
+export * from '../components/menu';
+export * from '../components/message';
+export * from '../components/modal';
+export * from '../components/notification';
+export * from '../components/pagination';
+export * from '../components/popconfirm';
+export * from '../components/form';
+export * from '../components/table';
+export * from '../components/tree';
+export * from '../components/tabs';
+export * from '../components/rich-editor';
+export * from '../components/select';
+export * from '../components/space';
+export * from '../components/steps';
+export * from '../components/upload';
+export * from '../directives';

package/dist/packages/utils/dom.d.ts

@@ -0,0 +1,5 @@
+export declare function addClass(el: HTMLElement, cls: string): void;
+export declare function removeClass(el: HTMLElement, cls: string): void;
+export declare function hasClass(el: HTMLElement, cls: string): boolean;
+export declare function getScrollTop(el?: Element | Window): number;
+export declare function isServer(): boolean;

package/dist/packages/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dom';
+export * from './vue-helper';
+export * from './types';

package/dist/packages/utils/types.d.ts

@@ -0,0 +1,7 @@
+export type Size = 'large' | 'medium' | 'small';
+export type Type = 'default' | 'primary' | 'success' | 'warning' | 'danger';
+export interface Pagination {
+    page: number;
+    pageSize: number;
+    total: number;
+}

package/dist/packages/utils/vue-helper.d.ts

@@ -0,0 +1,9 @@
+import { App } from 'vue';
+
+export type SFCWithInstall<T> = T & {
+    install: (app: App) => void;
+};
+/**
+ * 给组件挂载 install 方法，使其可通过 app.use() 注册
+ */
+export declare function withInstall<T>(component: T, name: string): SFCWithInstall<T>;

package/dist/play/main.d.ts

@@ -0,0 +1 @@
+

package/dist/play/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ccn-ui-kit/select",
+  "version": "0.1.2",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/packages/components/select/index.d.ts",
+  "files": [
+    "dist",
+    "style"
+  ],
+  "sideEffects": [
+    "**/*.scss"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/packages/components/select/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./style": "./style/index.scss",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  }
+}

package/style/index.scss

@@ -0,0 +1,200 @@
+.ui-select {
+  position: relative;
+  display: inline-block;
+  min-width: 200px;
+  font-size: var(--ui-font-size-base);
+  vertical-align: middle;
+
+  &__trigger {
+    position: relative;
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 4px;
+    min-height: 34px;
+    padding: 4px 12px;
+    box-sizing: border-box;
+    background: #fff;
+    border: 1px solid #dcdfe6;
+    border-radius: var(--ui-border-radius-base);
+    cursor: pointer;
+    outline: none;
+    user-select: none;
+    transition: border-color 0.2s;
+
+    &:hover {
+      border-color: #c0c4cc;
+    }
+
+    &:focus-visible {
+      border-color: var(--ui-color-primary);
+    }
+  }
+
+  &.is-open &__trigger {
+    border-color: var(--ui-color-primary);
+  }
+
+  &__selected {
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    color: #303133;
+
+    &.is-placeholder {
+      color: #c0c4cc;
+    }
+  }
+
+  &__filter {
+    flex: 1;
+    min-width: 0;
+    padding: 0;
+    border: none;
+    outline: none;
+    background: transparent;
+    font-size: inherit;
+    color: #303133;
+
+    &::placeholder {
+      color: #c0c4cc;
+    }
+  }
+
+  &__tag {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    padding: 2px 8px;
+    margin: 2px 2px 2px 0;
+    font-size: 12px;
+    line-height: 18px;
+    color: var(--ui-color-primary);
+    background: #ecf5ff;
+    border-radius: 3px;
+
+    &-close {
+      font-style: normal;
+      cursor: pointer;
+      line-height: 1;
+
+      &:hover {
+        color: var(--ui-color-danger);
+      }
+    }
+  }
+
+  &__suffix {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    margin-left: auto;
+    color: #909399;
+  }
+
+  &__arrow {
+    transition: transform 0.2s;
+  }
+
+  &.is-open &__arrow {
+    transform: rotate(180deg);
+  }
+
+  &__clear {
+    cursor: pointer;
+
+    &:hover {
+      color: var(--ui-color-danger);
+    }
+  }
+
+  &__panel {
+    position: absolute;
+    top: calc(100% + 4px);
+    left: 0;
+    right: 0;
+    z-index: 1000;
+    max-height: 240px;
+    overflow-y: auto;
+    background: #fff;
+    border: 1px solid #e4e7ed;
+    border-radius: var(--ui-border-radius-base);
+    box-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
+  }
+
+  // 向上弹出：触发器上方空间不足时由 JS 判定后切换（top: auto 覆盖默认向下定位）
+  &.is-up &__panel {
+    top: auto;
+    bottom: calc(100% + 4px);
+  }
+
+  &__list {
+    margin: 0;
+    padding: 5px 0;
+    list-style: none;
+  }
+
+  &__item {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 8px 12px;
+    color: #303133;
+    cursor: pointer;
+    user-select: none;
+
+    &:hover {
+      background-color: #f5f7fa;
+    }
+
+    &.is-highlighted {
+      background-color: #f5f7fa;
+    }
+
+    &.is-selected {
+      color: var(--ui-color-primary);
+      font-weight: 600;
+    }
+
+    &.is-disabled {
+      color: #c0c4cc;
+      cursor: not-allowed;
+
+      &:hover {
+        background-color: transparent;
+      }
+    }
+  }
+
+  &__item-check {
+    color: var(--ui-color-primary);
+  }
+
+  &__empty {
+    padding: 16px;
+    text-align: center;
+    color: #909399;
+  }
+
+  &.is-disabled {
+    cursor: not-allowed;
+  }
+}
+
+// 禁用态：整个触发器不可点（&__trigger 无法在嵌套中正确拼出，显式写全名）
+.ui-select.is-disabled .ui-select__trigger {
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+// 展开动画：仅淡入淡出
+.ui-select-fade-enter-active,
+.ui-select-fade-leave-active {
+  transition: opacity 0.2s ease;
+}
+.ui-select-fade-enter-from,
+.ui-select-fade-leave-to {
+  opacity: 0;
+}