@loongship-kit/ui

@loongship-kit/ui

面向 Vue 3 + Vite 的源码组件 Registry。基础组件使用 Reka UI 提供交互语义，外观由 Loongship --ls-* CSS Token 控制。

组件不会作为运行时 npm 库发布；npm 包提供 loongship-ui CLI 和供其复制的组件源码。

使用

# 使用日期与时间组件时安装对应开发基线
pnpm add reka-ui@^2.10.1 @internationalized/date@^3.12.2

# 初始化配置、Schema 和主题
npx @loongship-kit/ui init

# 将组件源码添加到当前项目
npx @loongship-kit/ui add button select table

默认安装位置：

• 组件：src/components/loongship
• 主题：src/styles/loongship.css
• 主题入口：src/styles/theme.ts

在应用入口导入主题：

import './styles/loongship.css'

全局主题：

import { setTheme } from './styles/theme'

setTheme('dark')

主题类型仅支持 'light' | 'dark'，默认使用 Light。系统主题检测、用户偏好保存和切换 UI 由应用负责。已有文件会被跳过，不会覆盖。Registry 声明的 npm 依赖只会作为带兼容版本的安装提示输出；CLI 会根据目标项目的 lockfile 选择 npm、pnpm、yarn 或 bun 命令。

浏览器支持

组件支持 Chrome、Edge、Firefox、Safari 和 iOS Safari 的最近两个稳定版本，不支持 IE。较新的增强样式在浏览器不识别时应保持可用的基础布局；新增 CSS 或 Web API 前应确认其符合该基线，或提供明确降级。

本地开发

pnpm install
pnpm dev

VitePress 默认运行在终端显示的本地地址。

新增、修改或删除组件前，请阅读 组件开发指南。该指南包含 Registry、测试、VitePress、AI 文档生成与 changeset 规范。

文档路由：

• /guide/：安装、Token 与主题
• /components/basic/：基础组件的展示、用法和 API
• /components/business/：业务组件的展示、用法和 API

pnpm docs:build
pnpm verify

当前包使用 UNLICENSED 标记，不表示授予公开使用或再分发许可；正式开放给外部使用者前需要由项目所有者确定许可证。