@a2simcode/ui 0.0.3 → 0.0.4

package/LICENSE

@@ -1,53 +1,53 @@
-专有软件许可协议
-
-版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
-
-本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
-
-许可限制:
-
-1. 本软件仅授权给获得明确书面许可的用户使用。
-
-2. 未经版权所有者事先书面同意,您不得:
-   - 复制、修改、改编或翻译本软件
-   - 对本软件进行反向工程、反编译或反汇编
-   - 出租、出借、分发、转让或再许可本软件
-   - 删除或修改本软件中的任何版权声明或其他所有权标记
-
-3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
-
-4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
-
-5. 本许可协议受中华人民共和国法律管辖。
-
-如需获得使用许可,请联系版权所有者。
-
----
-
-PROPRIETARY SOFTWARE LICENSE
-
-Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
-
-This software and associated documentation files (the "Software") is proprietary 
-software protected by copyright laws and international treaties.
-
-License Restrictions:
-
-1. This Software is licensed only to users who have obtained explicit written permission.
-
-2. Without prior written consent from the copyright holder, you may not:
-   - Copy, modify, adapt, or translate the Software
-   - Reverse engineer, decompile, or disassemble the Software
-   - Rent, lease, distribute, transfer, or sublicense the Software
-   - Remove or modify any copyright notices or other proprietary markings in the Software
-
-3. The Software is provided "as is" without warranty of any kind, express or implied, 
-   including but not limited to warranties of merchantability, fitness for a particular 
-   purpose, and non-infringement.
-
-4. In no event shall the copyright holder be liable for any claims, damages, or other 
-   liability arising from the use or inability to use the Software.
-
-5. This license agreement is governed by the laws of the People's Republic of China.
-
-For licensing inquiries, please contact the copyright holder.
+专有软件许可协议
+
+版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
+
+本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
+
+许可限制:
+
+1. 本软件仅授权给获得明确书面许可的用户使用。
+
+2. 未经版权所有者事先书面同意,您不得:
+   - 复制、修改、改编或翻译本软件
+   - 对本软件进行反向工程、反编译或反汇编
+   - 出租、出借、分发、转让或再许可本软件
+   - 删除或修改本软件中的任何版权声明或其他所有权标记
+
+3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
+
+4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
+
+5. 本许可协议受中华人民共和国法律管辖。
+
+如需获得使用许可,请联系版权所有者。
+
+---
+
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
+
+This software and associated documentation files (the "Software") is proprietary 
+software protected by copyright laws and international treaties.
+
+License Restrictions:
+
+1. This Software is licensed only to users who have obtained explicit written permission.
+
+2. Without prior written consent from the copyright holder, you may not:
+   - Copy, modify, adapt, or translate the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Rent, lease, distribute, transfer, or sublicense the Software
+   - Remove or modify any copyright notices or other proprietary markings in the Software
+
+3. The Software is provided "as is" without warranty of any kind, express or implied, 
+   including but not limited to warranties of merchantability, fitness for a particular 
+   purpose, and non-infringement.
+
+4. In no event shall the copyright holder be liable for any claims, damages, or other 
+   liability arising from the use or inability to use the Software.
+
+5. This license agreement is governed by the laws of the People's Republic of China.
+
+For licensing inquiries, please contact the copyright holder.

package/README.md

@@ -1,129 +1,130 @@
-# SimCode UI
-
-<div align="center">
-  <h1>SimCode UI</h1>
-  <p>基于 Vue 3 + TypeScript 的现代化 UI 组件库</p>
-</div>
-
-## ✨ 特性
-
-- 🚀 **现代化技术栈**: 基于 Vue 3 + TypeScript + Vite
-- 📦 **开箱即用**: 提供完善的类型定义和文档
-- 🎨 **精美设计**: 现代化的设计风格
-- 🔧 **易于定制**: 支持主题定制
-- ⚡️ **按需加载**: 支持 Tree Shaking
-- 🧪 **完善测试**: 单元测试覆盖
-
-## 📦 安装
-
-使用 pnpm:
-
-```bash
-pnpm add @a2simcode/ui
-```
-
-使用 npm:
-
-```bash
-npm install @a2simcode/ui
-```
-
-使用 yarn:
-
-```bash
-yarn add @a2simcode/ui
-```
-
-## 🔨 快速开始
-
-### 完整引入
-
-```typescript
-import { createApp } from 'vue'
-import App from './App.vue'
-import SimCodeUI from '@a2simcode/ui'
-import '@a2simcode/ui/dist/style.css'
-
-const app = createApp(App)
-app.use(SimCodeUI)
-app.mount('#app')
-```
-
-### 按需引入
-
-```vue
-<template>
-  <j-button type="primary">按钮</j-button>
-</template>
-
-<script setup lang="ts">
-import { JButton } from '@a2simcode/ui'
-import '@a2simcode/ui/dist/style.css'
-</script>
-```
-
-## 🎯 组件列表
-
-- ✅ Button 按钮
-- ✅ Input 输入框
-- 🚧 更多组件开发中...
-
-## 💻 本地开发
-
-```bash
-# 进入项目目录
-cd simcode-ui
-
-# 安装依赖
-pnpm install
-
-# 启动开发服务器
-pnpm dev
-
-# 构建组件库
-pnpm build
-
-# 运行测试
-pnpm test
-
-# 启动文档站点
-pnpm docs:dev
-```
-
-## 📁 项目结构
-
-```
-simcode-ui/
-├── packages/              # 组件源码
-│   ├── components/        # 组件
-│   │   ├── button/       # 按钮组件
-│   │   ├── input/        # 输入框组件
-│   │   └── index.ts      # 组件入口
-│   └── theme/            # 主题样式
-│       └── src/          # 样式源码 (Less)
-├── examples/             # 组件预览
-│   ├── App.vue          # 预览应用
-│   └── main.ts          # 入口文件
-├── docs/                # 文档
-│   ├── .vitepress/      # VitePress 配置
-│   ├── guide/           # 指南
-│   └── components/      # 组件文档
-├── __tests__/           # 测试文件
-├── vite.config.ts       # Vite 配置
-├── vitest.config.ts     # Vitest 配置
-└── package.json         # 项目配置
-```
-
-## 🤝 贡献
-
-欢迎提交 Issue 和 Pull Request!
-
-## 📄 版权声明
-
-Copyright © 2024 苏州极简搭信息技术有限公司. All rights reserved.
-
-本软件及其相关文档为专有软件,受版权法保护。未经版权所有者明确书面许可,不得以任何形式或方式(电子、机械、复印、录制或其他方式)复制、分发、传播或使用本软件的任何部分。
-
-## 🙏 致谢
-
-感谢所有为这个项目做出贡献的开发者!
+# SimCode UI
+
+<div align="center">
+  <h1>SimCode UI</h1>
+  <p>基于 Vue 3 + TypeScript 的现代化 UI 组件库</p>
+</div>
+
+## ✨ 特性
+
+- 🚀 **现代化技术栈**: 基于 Vue 3 + TypeScript + Vite
+- 📦 **开箱即用**: 提供完善的类型定义和文档
+- 🎨 **精美设计**: 现代化的设计风格
+- 🔧 **易于定制**: 支持主题定制
+- ⚡️ **按需加载**: 支持 Tree Shaking
+- 🧪 **完善测试**: 单元测试覆盖
+
+## 📦 安装
+
+使用 pnpm:
+
+```bash
+pnpm add @a2simcode/ui
+```
+
+使用 npm:
+
+```bash
+npm install @a2simcode/ui
+```
+
+使用 yarn:
+
+```bash
+yarn add @a2simcode/ui
+```
+
+## 🔨 快速开始
+
+### 完整引入
+
+```typescript
+import { createApp } from 'vue'
+import App from './App.vue'
+import SimCodeUI from '@a2simcode/ui'
+import '@a2simcode/ui/dist/style.css'
+
+const app = createApp(App)
+app.use(SimCodeUI)
+app.mount('#app')
+```
+
+### 按需引入
+
+```vue
+<template>
+  <j-button type="primary">按钮</j-button>
+</template>
+
+<script setup lang="ts">
+import { JButton } from '@a2simcode/ui'
+import '@a2simcode/ui/dist/style.css'
+</script>
+```
+
+## 🎯 组件列表
+
+- ✅ Button 按钮
+- ✅ Input 输入框
+- ✅ Radio 单选框
+- 🚧 更多组件开发中...
+
+## 💻 本地开发
+
+```bash
+# 进入项目目录
+cd simcode-ui
+
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm dev
+
+# 构建组件库
+pnpm build
+
+# 运行测试
+pnpm test
+
+# 启动文档站点
+pnpm docs:dev
+```
+
+## 📁 项目结构
+
+```
+simcode-ui/
+├── packages/              # 组件源码
+│   ├── components/        # 组件
+│   │   ├── button/       # 按钮组件
+│   │   ├── input/        # 输入框组件
+│   │   └── index.ts      # 组件入口
+│   └── theme/            # 主题样式
+│       └── src/          # 样式源码 (Less)
+├── examples/             # 组件预览
+│   ├── App.vue          # 预览应用
+│   └── main.ts          # 入口文件
+├── docs/                # 文档
+│   ├── .vitepress/      # VitePress 配置
+│   ├── guide/           # 指南
+│   └── components/      # 组件文档
+├── __tests__/           # 测试文件
+├── vite.config.ts       # Vite 配置
+├── vitest.config.ts     # Vitest 配置
+└── package.json         # 项目配置
+```
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request!
+
+## 📄 版权声明
+
+Copyright © 2024 苏州极简搭信息技术有限公司. All rights reserved.
+
+本软件及其相关文档为专有软件,受版权法保护。未经版权所有者明确书面许可,不得以任何形式或方式(电子、机械、复印、录制或其他方式)复制、分发、传播或使用本软件的任何部分。
+
+## 🙏 致谢
+
+感谢所有为这个项目做出贡献的开发者!

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

@@ -0,0 +1,118 @@
+declare const JAutocomplete: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('./src/autocomplete.vue').AutocompleteProps> & Readonly<{
+        onSelect?: ((value: any) => any) | undefined;
+        onFocus?: (() => any) | undefined;
+        onBlur?: (() => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+        onChange?: ((value: string) => any) | undefined;
+    }>, {
+        focus: () => void;
+        blur: () => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        select: (value: any) => any;
+        focus: () => any;
+        blur: () => any;
+        "update:modelValue": (value: string | undefined) => any;
+        change: (value: string) => any;
+    }, import('vue').PublicProps, {
+        disabled: boolean;
+        readonly: boolean;
+        placeholder: string;
+        clearable: boolean;
+        options: import('./src/autocomplete.vue').Option[];
+        teleported: boolean;
+        placement: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end";
+        valueKey: string;
+        debounce: number;
+        triggerOnFocus: boolean;
+        selectWhenUnmatched: boolean;
+        hideLoading: boolean;
+        highlightFirstItem: boolean;
+        fitInputWidth: boolean;
+        loopNavigation: boolean;
+    }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        autocompleteRef: unknown;
+    }, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('./src/autocomplete.vue').AutocompleteProps> & Readonly<{
+        onSelect?: ((value: any) => any) | undefined;
+        onFocus?: (() => any) | undefined;
+        onBlur?: (() => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+        onChange?: ((value: string) => any) | undefined;
+    }>, {
+        focus: () => void;
+        blur: () => void;
+    }, {}, {}, {}, {
+        disabled: boolean;
+        readonly: boolean;
+        placeholder: string;
+        clearable: boolean;
+        options: import('./src/autocomplete.vue').Option[];
+        teleported: boolean;
+        placement: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end";
+        valueKey: string;
+        debounce: number;
+        triggerOnFocus: boolean;
+        selectWhenUnmatched: boolean;
+        hideLoading: boolean;
+        highlightFirstItem: boolean;
+        fitInputWidth: boolean;
+        loopNavigation: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('./src/autocomplete.vue').AutocompleteProps> & Readonly<{
+    onSelect?: ((value: any) => any) | undefined;
+    onFocus?: (() => any) | undefined;
+    onBlur?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+}>, {
+    focus: () => void;
+    blur: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (value: any) => any;
+    focus: () => any;
+    blur: () => any;
+    "update:modelValue": (value: string | undefined) => any;
+    change: (value: string) => any;
+}, string, {
+    disabled: boolean;
+    readonly: boolean;
+    placeholder: string;
+    clearable: boolean;
+    options: import('./src/autocomplete.vue').Option[];
+    teleported: boolean;
+    placement: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end";
+    valueKey: string;
+    debounce: number;
+    triggerOnFocus: boolean;
+    selectWhenUnmatched: boolean;
+    hideLoading: boolean;
+    highlightFirstItem: boolean;
+    fitInputWidth: boolean;
+    loopNavigation: boolean;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        prefix?(_: {}): any;
+        suffix?(_: {}): any;
+        default?(_: {
+            item: any;
+        }): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+        prepend?(_: {}): any;
+        append?(_: {}): any;
+        loading?(_: {}): any;
+    };
+}) & {
+    install: (app: import('vue').App) => void;
+};
+export default JAutocomplete;

package/dist/components/autocomplete/src/autocomplete.vue.d.ts

@@ -0,0 +1,109 @@
+export interface Option {
+    label?: string;
+    value?: string;
+    [key: string]: any;
+}
+export interface AutocompleteProps {
+    /** 绑定值 */
+    modelValue?: string;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否可清空 */
+    clearable?: boolean;
+    /** 自动补全组件是否被禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 输入建议对象中用于显示的键名 */
+    valueKey?: string;
+    /** 获取输入建议的防抖延时，单位为毫秒 */
+    debounce?: number;
+    /** 菜单弹出位置 */
+    placement?: 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end';
+    options?: Option[];
+    /** 获取输入建议的方法 */
+    fetchSuggestions?: (queryString: string, callback: (data: any[]) => void) => void;
+    /** 是否在输入框获得焦点时显示建议 */
+    triggerOnFocus?: boolean;
+    /** 在输入没有任何匹配建议的情况下，按下回车是否触发 select 事件 */
+    selectWhenUnmatched?: boolean;
+    /** 原生 aria-label属性 */
+    ariaLabel?: string;
+    /** 是否隐藏远程加载时的加载图标 */
+    hideLoading?: boolean;
+    /** 下拉列表的类名 */
+    popperClass?: string | Record<string, any>;
+    /** autocomplete 下拉列表的样式 */
+    popperStyle?: Record<string, any>;
+    /** 是否将下拉列表元素插入 append-to 指向的元素下 */
+    teleported?: boolean;
+    /** 下拉框挂载到哪个 DOM 元素 */
+    appendTo?: HTMLElement | string;
+    /** 是否默认高亮远程搜索结果的第一项 */
+    highlightFirstItem?: boolean;
+    /** 下拉框的宽度是否与输入框相同 */
+    fitInputWidth?: boolean;
+    /** 键盘导航是否从末尾循环到开头 */
+    loopNavigation?: boolean;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        prefix?(_: {}): any;
+        suffix?(_: {}): any;
+        default?(_: {
+            item: any;
+        }): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+        prepend?(_: {}): any;
+        append?(_: {}): any;
+        loading?(_: {}): any;
+    };
+    refs: {
+        autocompleteRef: unknown;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<AutocompleteProps, {
+    focus: () => void;
+    blur: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (value: any) => any;
+    focus: () => any;
+    blur: () => any;
+    "update:modelValue": (value: string | undefined) => any;
+    change: (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<AutocompleteProps> & Readonly<{
+    onSelect?: ((value: any) => any) | undefined;
+    onFocus?: (() => any) | undefined;
+    onBlur?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+}>, {
+    disabled: boolean;
+    readonly: boolean;
+    placeholder: string;
+    clearable: boolean;
+    options: Option[];
+    teleported: boolean;
+    placement: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end";
+    valueKey: string;
+    debounce: number;
+    triggerOnFocus: boolean;
+    selectWhenUnmatched: boolean;
+    hideLoading: boolean;
+    highlightFirstItem: boolean;
+    fitInputWidth: boolean;
+    loopNavigation: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    autocompleteRef: unknown;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};