@univa/core 0.0.2 → 0.0.3

package/README.md

@@ -61,7 +61,244 @@ export default defineConfig({
 
 ## 功能详解
 
-待补充...
+### 自动导入
+
+自动导入 Vue、Pinia、uni-app 等 API，无需手动 import：
+
+```typescript
+// 无需 import，直接使用
+const count = ref(0)
+const router = useRouter()
+const store = useStore()
+```
+
+**自动扫描目录**：
+- `src/hooks/**` - 自动导入 hooks
+- `src/store/**` - 自动导入 store
+- `src/constants/**` - 自动导入常量
+
+### 组件自动注册
+
+自动注册 `components` 目录下的组件，无需手动 import：
+
+```
+src/
+├── components/
+│   ├── MyButton.vue
+│   └── common/
+│       └── Icon.vue
+└── components-biz/
+    └── Card.vue
+```
+
+在页面中直接使用：
+
+```vue
+<template>
+  <MyButton />
+  <Icon />
+  <BizCard />
+</template>
+```
+
+**特性**：
+- `components/` 和 `common/` 是全局命名空间，不添加前缀
+- `components-biz/` 会自动添加 `Biz` 命名空间前缀
+- 自动生成类型声明文件
+
+### 页面管理
+
+#### 定义页面配置
+
+**方式 1：在 pages.config.ts 中定义**
+
+```typescript
+// pages.config.ts
+import { definePagesConfig } from '@univa/core'
+
+export default definePagesConfig({
+  tabBarMode: 'CUSTOM', // 'NONE' | 'NATIVE' | 'CUSTOM'
+  tabBar: {
+    list: [
+      {
+        pagePath: 'pages/index',
+        text: '首页',
+        iconPath: 'images/tabbar/home.png',
+        selectedIconPath: 'images/tabbar/home_selected.png',
+      },
+    ],
+  },
+})
+```
+
+**方式 2：在 vite.config.ts 中直接定义**
+
+```typescript
+// vite.config.ts
+import { Univa } from '@univa/core'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    Univa({
+      pages: {
+        config: {
+          tabBarMode: 'CUSTOM',
+          tabBar: {
+            list: [...],
+          },
+        },
+      },
+    }),
+  ],
+})
+```
+
+#### 获取 TabBar 配置
+
+在组件中获取 tabBar 配置：
+
+```typescript
+import tabBar from 'virtual:univa-tabbar'
+
+if (tabBar) {
+  console.log(tabBar.list) // TabBar 列表
+}
+```
+
+### UnoCSS 预设
+
+内置 UnoCSS 预设，提供开箱即用的原子化 CSS：
+
+**内置预设**：
+- `presetUni()` - uni-app 专属预设
+- `presetIcons()` - 图标预设（scale: 1.2）
+- `presetLegacyCompat()` - 兼容性预设（处理低端安卓机）
+
+**内置快捷方式**：
+```typescript
+'border-s' // border border-solid
+'wh-full' // w-full h-full
+'f-c-c' // flex justify-center items-center
+'f-col-c' // flex-col justify-center items-center
+'flex-items' // flex items-center
+'flex-justify' // flex justify-center
+'flex-col' // flex flex-col
+```
+
+**安全区域规则**：
+```html
+<div class="p-safe">安全区域内边距</div>
+<div class="pt-safe">顶部安全区域</div>
+<div class="pb-safe">底部安全区域</div>
+```
+
+### 根组件
+
+自动创建和管理 `App.univa.vue` 根组件：
+
+```vue
+<script setup lang="ts">
+</script>
+
+<template>
+  <UnivaPageMeta background-color="#ff0000" page-style="color: green" />
+  <view class="container">
+    <UnivaRootView />
+  </view>
+</template>
+```
+
+**特性**：
+- 自动创建根组件文件
+- 支持虚拟节点（`virtualHost`）
+- 支持全局 ref
+- 支持 `<UnivaPageMeta>` 组件配置页面元信息
+- 支持 `<UnivaRootView />` 组件作为根视图
+
+### Manifest 配置
+
+在 `vite.config.ts` 中直接配置 manifest：
+
+```typescript
+import { Univa } from '@univa/core'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    Univa({
+      manifest: {
+        name: 'my-app',
+        appid: '__UNI__XXXXXX',
+        description: 'My Application',
+        versionName: '1.0.0',
+        versionCode: '100',
+      },
+    }),
+  ],
+})
+```
+
+## 配置选项
+
+```typescript
+import type { UnivaUserConfig } from '@univa/core'
+
+const config: UnivaUserConfig = {
+  // 自动导入配置（默认 true）
+  autoImport: true,
+
+  // 组件自动注册配置（默认 true）
+  components: true,
+
+  // 页面配置
+  pages: {
+    config: {
+      // TabBar 模式：'NONE' | 'NATIVE' | 'CUSTOM'
+      tabBarMode: 'NATIVE',
+      tabBar: {
+        color: '#A6A6A6',
+        selectedColor: '#003594',
+        list: [
+          {
+            pagePath: 'pages/index',
+            text: '首页',
+            iconPath: 'images/tabbar/home.png',
+            selectedIconPath: 'images/tabbar/home_selected.png',
+          },
+        ],
+      },
+      // 全局样式配置
+      globalStyle: {
+        navigationBarBackgroundColor: '#000000',
+        navigationBarTextStyle: 'black',
+        navigationBarTitleText: 'My App',
+        navigationStyle: 'custom',
+        enablePullDownRefresh: false,
+        onReachBottomDistance: 50,
+        animationType: 'pop-in',
+        animationDuration: 300,
+      },
+    },
+    // 排除的页面
+    exclude: ['pages/exclude/**'],
+    // 分包配置
+    subPackages: ['pages-sub'],
+  },
+
+  // 根组件配置（默认 true）
+  appRoot: true,
+
+  // Manifest 配置
+  manifest: {
+    name: 'my-app',
+    appid: '__UNI__XXXXXX',
+    description: 'My Application',
+    versionName: '1.0.0',
+    versionCode: '100',
+  },
+}
+```
 
 ## 依赖
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@univa/core",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "",
   "author": "",
   "license": "MIT",
@@ -41,6 +41,7 @@
   "dependencies": {
     "@uni-helper/eslint-config": "0.7.3",
     "@uni-helper/plugin-uni": "0.1.0",
+    "@uni-helper/uni-types": "1.0.0-alpha.8",
     "@uni-helper/unocss-preset-uni": "0.2.11",
     "@uni-helper/vite-plugin-uni-components": "0.2.10",
     "@uni-helper/vite-plugin-uni-layouts": "0.1.11",
@@ -48,6 +49,7 @@
     "@uni-ku/bundle-optimizer": "2.1.2",
     "@univa/manifest": "^0.0.1",
     "@univa/root": "^0.0.1",
+    "@univa/tsconfig": "^0.0.1",
     "@unocss/eslint-plugin": "66.6.7",
     "@unocss/preset-legacy-compat": "66.0.0",
     "eslint": "10.3.0",

package/src/client.d.ts

@@ -1,6 +1,8 @@
 /// <reference path="./global.d.ts" />
 /// <reference types="@uni-helper/vite-plugin-uni-pages/client" />
 /// <reference types="vite/client" />
+/// <reference types="@uni-ku/bundle-optimizer/client" />
+/// <reference types="@uni-helper/uni-types" />
 
 declare module 'virtual:univa-tabbar' {
   import type { TabBar } from '@uni-helper/vite-plugin-uni-pages'