@techui/base/README.md

TechUI Base is a basic component library developed based on Vue

# @techui/base

[English](#english) | [中文](#中文)

---

## English

## 📦 TechUI Base

A foundational Vue 3 component library similar to Element Plus, designed to meet the basic form and data operation needs of the TechUI ecosystem.

### 🌟 Overview

**@techui/base** is a basic component library developed based on Vue 3. It was initially created to satisfy the fundamental requirements for form handling and data presentation within the TechUI framework. Currently, it serves as the core component foundation for:

- **@techui/admin** - Admin panel component library
- **@techui/prime** - Premium component library

### ⚠️ Development Status

This component library is currently **under active development and iteration**. Please note:

- 🚧 Not production-ready for all use cases
- ⚡ Cannot completely replace Element Plus at this stage
- 🔄 APIs and components may change between versions

### 🎯 TuiAdaptive - Revolutionary Responsive Component

The library includes **TuiAdaptive**, an incredibly powerful adaptive component that solves responsive design challenges once and for all using proportional scaling.

**Key Features:**

- Multiple adaptation modes for different scenarios
- **Drag Mode** - Activate via browser zoom functionality
- **Coordinate Sync Container** - Special solution for third-party map/GIS components (Cesium, etc.)
  - Prevents coordinate inaccuracy issues when GIS components are placed inside scaled containers
  - Uses a synchronized pass-through container to maintain accurate click coordinates

> **Proudly the best adaptive/responsive component available on the market today!**

### 📦 Dependencies

This library relies on the following TechUI ecosystem packages:

- `@techui/colors` - Color system
- `@techui/lessmixins` - LESS mixins
- `@techui/locales` - Internationalization
- `@techui/themes` - Theme system
- `@techui/libs` - Utility libraries
- `@techui/utils` - Utility functions

### 📄 License

UNLICENSED

### 👤 Author

**aYin**

- Email: <ayin86cn@gmail.com>
- WeChat: jay1986cn
- Homepage: [https://techui.net](https://techui.net)

### 🔗 Related Projects

- [@techui/admin](https://techui.net) - Admin Panel Components
- [@techui/prime](https://techui.net) - Premium Components
- [@techui/scifi](https://techui.net) - Sci-Fi Theme Components

---

## 中文

## 📦 TechUI Base

一个类似 Element Plus 的 Vue 3 基础组件库,旨在满足 TechUI 生态系统的基础表单和数据操作需求。

### 🌟 概述

**@techui/base** 是一个基于 Vue 3 开发的基础组件库。它的开发之初是为了满足 TechUI 框架中对表单处理和数据展示的基本需求。目前,它为以下组件库提供核心组件基础:

- **@techui/admin** - 后台管理面板组件库
- **@techui/prime** - 高级组件库

### ⚠️ 开发状态

该组件库目前**正在积极开发和迭代中**。请注意:

- 🚧 尚未为所有使用场景做好生产准备
- ⚡ 现阶段还不能完全取代 Element Plus
- 🔄 API 和组件可能在版本之间发生变化

### 🎯 TuiAdaptive - 革命性的自适应组件

库中包含功能强大的 **TuiAdaptive** 适配组件，采用等比缩放方式，让开发者一劳永逸地解决自适应问题。

**核心功能:**

- 多种适配模式，适应不同场景
- **拖拽模式** - 可通过浏览器缩放功能激活
- **同步穿透容器** - 专为第三方地图/GIS组件设计（Cesium等）
  - 解决 GIS 组件放置在缩放容器内部时点击坐标不准确的问题
  - 通过同步穿透容器保持准确的点击坐标

> **可以自豪地说，它是现在市面上最好用的自适应/适配组件！**

### 📦 依赖项

该库依赖以下 TechUI 生态系统包:

- `@techui/colors` - 色彩系统
- `@techui/lessmixins` - LESS 混入
- `@techui/locales` - 国际化
- `@techui/themes` - 主题系统
- `@techui/libs` - 工具库
- `@techui/utils` - 工具函数

### 📄 许可证

UNLICENSED

### 👤 作者

**aYin**

- 邮箱: <ayin86cn@gmail.com>
- 微信: jay1986cn
- 主页: [https://techui.net](https://techui.net)

### 🔗 相关项目

- [@techui/admin](https://techui.net) - 后台管理面板组件
- [@techui/prime](https://techui.net) - 高级组件
- [@techui/scifi](https://techui.net) - 科幻主题组件

---

## 📊 Version

Current Version: **0.0.1**

## 🏷️ Keywords

`@techui` `techui` `TechUI` `vue3` `components` `dashboard` `admin-panel` `workspace` `portal`