befly-admin 3.3.8 → 3.4.1

package/src/types/components.d.ts

@@ -0,0 +1,46 @@
+/* eslint-disable */
+// @ts-nocheck
+// biome-ignore lint: disable
+// oxlint-disable
+// ------
+// Generated by unplugin-vue-components
+// Read more: https://github.com/vuejs/core/pull/3399
+
+export {}
+
+/* prettier-ignore */
+declare module 'vue' {
+  export interface GlobalComponents {
+    Icon: typeof import('./../components/internal/Icon.vue')['default']
+    RouterLink: typeof import('vue-router')['RouterLink']
+    RouterView: typeof import('vue-router')['RouterView']
+    TinyButton: typeof import('@opentiny/vue-button')['default']
+    TinyCheckbox: typeof import('@opentiny/vue-checkbox')['default']
+    TinyCheckboxGroup: typeof import('@opentiny/vue-checkbox-group')['default']
+    TinyCol: typeof import('@opentiny/vue-col')['default']
+    TinyCollapse: typeof import('@opentiny/vue-collapse')['default']
+    TinyCollapseItem: typeof import('@opentiny/vue-collapse-item')['default']
+    TinyDialogBox: typeof import('@opentiny/vue-dialog-box')['default']
+    TinyDivider: typeof import('@opentiny/vue-divider')['default']
+    TinyDropdown: typeof import('@opentiny/vue-dropdown')['default']
+    TinyDropdownItem: typeof import('@opentiny/vue-dropdown-item')['default']
+    TinyDropdownMenu: typeof import('@opentiny/vue-dropdown-menu')['default']
+    TinyForm: typeof import('@opentiny/vue-form')['default']
+    TinyFormItem: typeof import('@opentiny/vue-form-item')['default']
+    TinyGrid: typeof import('@opentiny/vue-grid')['default']
+    TinyGridColumn: typeof import('@opentiny/vue-grid-column')['default']
+    TinyInput: typeof import('@opentiny/vue-input')['default']
+    TinyNumeric: typeof import('@opentiny/vue-numeric')['default']
+    TinyPager: typeof import('@opentiny/vue-pager')['default']
+    TinyProgress: typeof import('@opentiny/vue-progress')['default']
+    TinyQrcode: typeof import('@opentiny/vue-qrcode')['default']
+    TinyRadio: typeof import('@opentiny/vue-radio')['default']
+    TinyRadioGroup: typeof import('@opentiny/vue-radio-group')['default']
+    TinyRow: typeof import('@opentiny/vue-row')['default']
+    TinySearch: typeof import('@opentiny/vue-search')['default']
+    TinySelect: typeof import('@opentiny/vue-select')['default']
+    TinyTag: typeof import('@opentiny/vue-tag')['default']
+    TinyTree: typeof import('@opentiny/vue-tree')['default']
+    TinyTreeMenu: typeof import('@opentiny/vue-tree-menu')['default']
+  }
+}

package/src/utils/README.md

@@ -0,0 +1,37 @@
+# Utils 目录说明
+
+## 目录结构
+
+- `internal.ts` - 框架核心工具函数（由 befly-admin 管理）
+- `index.ts` - 用户自定义工具函数
+
+## 使用说明
+
+### 框架工具函数
+
+```typescript
+import { arrayToTree } from '@/utils/internal';
+// 或者
+import { arrayToTree } from '@/utils';
+```
+
+### 自定义工具函数
+
+在 `index.ts` 中添加您的工具函数：
+
+```typescript
+/**
+ * 格式化日期
+ */
+export function formatDate(date: Date): string {
+    return date.toISOString().split('T')[0];
+}
+```
+
+## 注意事项
+
+⚠️ **请勿修改** `internal.ts` 文件，运行 `befly sync:admin` 会自动更新此文件
+
+---
+
+📚 更多信息请查看项目文档

package/src/utils/index.ts

@@ -0,0 +1,12 @@
+/**
+ * 用户自定义工具函数
+ * 可以在这里添加项目特定的工具函数
+ *
+ * 示例：
+ * export function formatDate(date: Date): string {
+ *     return date.toISOString().split('T')[0];
+ * }
+ */
+
+// 导出框架工具（可选）
+export * from './internal';

package/src/utils/internal/README.md

@@ -0,0 +1,21 @@
+# Internal Utils
+
+⚠️ **框架核心工具目录**
+
+此目录由 `befly-admin` 包管理，请勿手动修改。
+
+运行 `befly sync:admin` 会自动更新此目录。
+
+## 文件说明
+
+- `index.ts` - 核心工具函数（如 `arrayToTree`）
+
+## 使用方式
+
+```typescript
+// 从 utils 导入（推荐）
+import { arrayToTree } from '@/utils';
+
+// 直接从 internal 导入
+import { arrayToTree } from '@/utils/internal';
+```

package/src/{util.ts → utils/internal/index.ts}

@@ -1,5 +1,7 @@
 /**
- * 工具函数集合
+ * 框架核心工具函数
+ * ⚠️ 此文件由 befly-admin 包管理，请勿修改
+ * 运行 `befly sync:admin` 会自动更新此文件
  */
 
 /**

package/src/views/internal/README.md

@@ -0,0 +1,27 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需创建业务页面，请在 internal 目录外创建文件
+
+## 文件用途
+
+此目录包含框架提供的管理页面（用户管理、角色管理、菜单管理等），确保管理系统的基础功能正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/views/{role → internal/role}/components/menu.vue

@@ -11,7 +11,7 @@
 </template>
 
 <script setup>
-import { arrayToTree } from '../../../util';
+import { arrayToTree } from '@/utils';
 
 const $Prop = defineProps({
     modelValue: {

package/vite.config.ts

@@ -26,8 +26,8 @@ export default defineConfig({
                 }
             ],
             resolvers: [TinyVueSingleResolver],
-            // 自动导入 plugins 目录下的所有导出
-            dirs: ['./src/plugins'],
+            // 自动导入 plugins 目录下的所有导出（internal 优先）
+            dirs: ['./src/plugins/internal', './src/plugins'],
             dts: 'src/types/auto-imports.d.ts',
             eslintrc: {
                 enabled: false
@@ -36,7 +36,7 @@ export default defineConfig({
         // 自动导入 OpenTiny 组件
         Components({
             resolvers: [TinyVueSingleResolver],
-            dirs: ['src/components'],
+            dirs: ['src/components/internal', 'src/components'],
             dts: 'src/types/components.d.ts'
         })
     ],
@@ -52,7 +52,7 @@ export default defineConfig({
         preprocessorOptions: {
             scss: {
                 api: 'modern-compiler',
-                additionalData: `@use "@/styles/variables.scss" as *;`
+                additionalData: `@use "@/styles/internal/variables.scss" as *;`
             }
         }
     },