@robot-admin/naive-ui-components 0.13.8 → 0.13.9

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @robot-admin/naive-ui-components
 
+## 0.13.9
+
+- 新增 `C_PageLoading`：同心轨道与波形 SVG、柔和主题卡片，支持明暗主题、按需导入、独立文案和减少动态效果；所有样式隔离，不依赖路由或宿主的 UnoCSS。
+- 新增 `createPageLoading({ delay })`：默认延迟 160ms 显示，快速完成不闪烁；任务编号隔离并发完成，提供重置清理，不强制延长导航时间。
+
 ## 0.13.8
 
 - 表格内置子表与主表统一默认居中；列类型保留 Naive UI 普通列的排序、筛选和单元格配置，原生表格迁移后不丢交互能力。

package/README.md

@@ -4,7 +4,7 @@
 
 **基于 Naive UI 的 Vue 3 企业级组件库**
 
-从 Robot Admin 中提炼的 54 个高质量业务组件，支持全量注册、按需导入（Tree-Shaking）和子路径独立导入。
+从 Robot Admin 中提炼的 55 个高质量业务组件，支持全量注册、按需导入（Tree-Shaking）和子路径独立导入。
 
 [![NPM Version](https://img.shields.io/npm/v/@robot-admin/naive-ui-components)](https://www.npmjs.com/package/@robot-admin/naive-ui-components)
 [![License](https://img.shields.io/npm/l/@robot-admin/naive-ui-components)](./LICENSE)
@@ -479,7 +479,7 @@ const config = defineTableConfig({
 </NSpin>
 ```
 
-### 📋 组件清单（54 个）
+### 📋 组件清单（55 个）
 
 > 💡 所有组件均提供 **在线交互演示**，访问 [组件文档](https://www.tzagileteam.com/robot/components/preface) 可直接在页面中体验真实效果（通过 iframe 嵌入 Robot Admin 生产环境）。
 
@@ -489,6 +489,7 @@ const config = defineTableConfig({
 | ---------------- | ----------------------- | ----------------------------- |
 | `C_Icon`         | Iconify 图标封装        | `@iconify/vue`                |
 | `C_Loading`      | 主题化 SVG 加载态       | -                             |
+| `C_PageLoading` | 主题化页面切换加载 | - |
 | `C_Code`         | 代码高亮显示            | `highlight.js`                |
 | `C_Barcode`      | 条形码生成器            | `@chenfengyuan/vue-barcode`   |
 | `C_Captcha`      | 拼图/ALTCHA 人机验证    | `vue3-puzzle-vcode`、`altcha` |
@@ -601,7 +602,7 @@ bun add vue naive-ui
 
 ```
 bun run build
-  ├── 1. tsdown          → 多入口打包（54 组件 ESM/CJS/DTS）
+  ├── 1. tsdown          → 多入口打包（55 组件 ESM/CJS/DTS）
   ├── 2. sass CLI        → 编译共享变量入口 → global-scss.css
   ├── 3. merge-css.js    → 合并 Vue 编译后的 SFC CSS + 全局变量 → style.css
   ├── 4. gen-exports.js  → 自动生成 package.json exports 映射
@@ -611,7 +612,7 @@ bun run build
 
 #### 技术要点
 
-- **构建引擎**：[tsdown](https://github.com/rolldown/tsdown)（基于 Rolldown），54 个独立入口并行编译
+- **构建引擎**：[tsdown](https://github.com/rolldown/tsdown)（基于 Rolldown），55 个独立入口并行编译
 - **SCSS 处理**：自定义 `scssTransformPlugin` 在 Rolldown 管线内编译 SFC SCSS，独立 Sass CLI 仅编译共享变量入口
 - **CSS 合并**：构建后将 Vue 已完成 scoped 转换的 per-chunk CSS 与共享变量合并为单一 `style.css`，避免重复样式和原始 `:deep()` 选择器泄漏
 - **类型导出**：统一 `export *` barrel 模式，自动生成完整 `.d.ts`
@@ -626,7 +627,7 @@ bun run build
 ```
 dist/
 ├── index.js / index.cjs / index.d.ts     # 主入口
-├── C_Form.js / C_Form.cjs / C_Form.d.ts  # 子路径入口（54 组件）
+├── C_Form.js / C_Form.cjs / C_Form.d.ts  # 子路径入口（55 组件）
 ├── C_Form.base.css / C_Form.full.css      # 基础/完整样式层级
 ├── C_Table.base.css / C_Table.full.css    # 基础/完整样式层级
 ├── style.css                              # 合并后的全量样式
@@ -735,3 +736,19 @@ MIT License
 ### C_Login 扩展表单
 
 `password-fields` 插槽位于密码输入框下方，提供 `username`、`loading`，可配置工作空间或其他业务字段。`username-change` 在初始预填、恢复记住的账号和输入变化时同步触发。宿主通过 `submitDisabled` 阻止扩展字段尚未就绪时的按钮与回车提交；`loading` 期间凭据输入禁用。公司查询、成员关系和权限始终由宿主认证服务处理，组件不保存业务上下文。
+
+### 页面切换加载
+
+路由生命周期只需要关联 `start()` / `finish(id)`；动画、主题和减少动态效果由组件库处理。默认延迟 160ms 显示，快速切换不闪烁，旧任务完成不会关闭新任务。
+
+```vue
+<C_PageLoading :show="loading.visible.value" />
+```
+
+```ts
+import { createPageLoading } from '@robot-admin/naive-ui-components/C_PageLoading'
+const loading = createPageLoading({ delay: 160 })
+const id = loading.start()
+// 路由完成、取消或失败后
+loading.finish(id)
+```

package/README_EN.md

@@ -4,7 +4,7 @@
 
 **Enterprise-grade Vue 3 component library built on Naive UI**
 
-54 production-ready business components extracted from Robot Admin, supporting global registration, on-demand imports (Tree-Shaking), and subpath imports.
+55 production-ready business components extracted from Robot Admin, supporting global registration, on-demand imports (Tree-Shaking), and subpath imports.
 
 [![NPM Version](https://img.shields.io/npm/v/@robot-admin/naive-ui-components)](https://www.npmjs.com/package/@robot-admin/naive-ui-components)
 [![License](https://img.shields.io/npm/l/@robot-admin/naive-ui-components)](./LICENSE)
@@ -420,7 +420,7 @@ With `require-server-verification`, a successful response must include a server
 </NSpin>
 ```
 
-### 📋 Component List (54 Components)
+### 📋 Component List (55 Components)
 
 > 💡 All components provide **interactive live demos**. Visit the [Component Docs](https://www.tzagileteam.com/robot/components/preface) to try them out in real-time (rendered via iframe from Robot Admin production).
 
@@ -430,6 +430,7 @@ With `require-server-verification`, a successful response must include a server
 | ---------------- | ------------------------- | ----------------------------- |
 | `C_Icon`         | Iconify icon wrapper      | `@iconify/vue`                |
 | `C_Loading`      | Theme-aware SVG loading   | -                             |
+| `C_PageLoading` | Theme-aware page loading | - |
 | `C_Code`         | Code highlighting         | `highlight.js`                |
 | `C_Barcode`      | Barcode generator         | `@chenfengyuan/vue-barcode`   |
 | `C_Captcha`      | Puzzle / ALTCHA captcha   | `vue3-puzzle-vcode`, `altcha` |
@@ -542,7 +543,7 @@ Install optional peers per feature: `vue-router` for `C_Breadcrumb`/`C_TagsView`
 
 ```
 bun run build
-  ├── 1. tsdown          → Multi-entry bundling (54 components ESM/CJS/DTS)
+  ├── 1. tsdown          → Multi-entry bundling (55 components ESM/CJS/DTS)
   ├── 2. sass CLI        → Compile the shared-variable entry → global-scss.css
   ├── 3. merge-css.js    → Merge Vue-compiled SFC CSS + global variables → style.css
   ├── 4. gen-exports.js  → Auto-generate package.json exports map
@@ -552,7 +553,7 @@ bun run build
 
 #### Key Technical Details
 
-- **Build engine**: [tsdown](https://github.com/rolldown/tsdown) (Rolldown-based), 54 independent entries compiled in parallel
+- **Build engine**: [tsdown](https://github.com/rolldown/tsdown) (Rolldown-based), 55 independent entries compiled in parallel
 - **SCSS processing**: Custom `scssTransformPlugin` compiles SFC SCSS within the Rolldown pipeline; standalone Sass CLI only compiles the shared-variable entry
 - **CSS merging**: Post-build merges Vue scoped-compiled per-chunk CSS with shared variables into a single `style.css`, avoiding duplicate styles and leaked raw `:deep()` selectors
 - **Type exports**: Unified `export *` barrel pattern with auto-generated `.d.ts`
@@ -567,7 +568,7 @@ bun run build
 ```
 dist/
 ├── index.js / index.cjs / index.d.ts     # Main entry
-├── C_Form.js / C_Form.cjs / C_Form.d.ts  # Subpath entries (54 components)
+├── C_Form.js / C_Form.cjs / C_Form.d.ts  # Subpath entries (55 components)
 ├── C_Form.base.css / C_Form.full.css      # Base/full style tiers
 ├── C_Table.base.css / C_Table.full.css    # Base/full style tiers
 ├── style.css                              # Merged full styles
@@ -667,3 +668,19 @@ MIT License
 ### C_Login form extension
 
 The `password-fields` slot appears below the password field and exposes `username` and `loading`. The synchronous `username-change` event covers initial defaults, remembered usernames and input changes. Use `submitDisabled` to block clicks and Enter while application fields are incomplete. Credential inputs are disabled while `loading`. Workspace discovery and authorization remain in the host application.
+
+### Page navigation loading
+
+Connect navigation lifecycles through `start()` / `finish(id)`. The component handles visuals, themes and reduced motion. A 160ms default delay avoids flashes; stale completions cannot hide a newer task.
+
+```vue
+<C_PageLoading :show="loading.visible.value" />
+```
+
+```ts
+import { createPageLoading } from '@robot-admin/naive-ui-components/C_PageLoading'
+const loading = createPageLoading({ delay: 160 })
+const id = loading.start()
+// After completion, cancellation or failure
+loading.finish(id)
+```

package/dist/C_PageLoading.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./createPageLoading.cjs`);exports.C_PageLoading=e.n,exports.createPageLoading=e.t;

package/dist/C_PageLoading.css

@@ -0,0 +1,152 @@
+/* unplugin-vue-components disabled *//*
+ * @Author: ChenYu ycyplus@gmail.com
+ * @Date: 2026-10-07
+ * @Description: 页面加载的主题卡片、波形和轨道动画，所有选择器限定作用域
+ * Copyright (c) 2026 by CHENY, All Rights Reserved 😎.
+ */
+.c-page-loading[data-v-aec6cc81] {
+  position: fixed;
+  inset: 0;
+  z-index: 1999;
+  display: grid;
+  place-items: center;
+  padding: 24px;
+  box-sizing: border-box;
+  background: color-mix(in srgb, var(--c-page-loading-body) 65%, transparent);
+  backdrop-filter: blur(3px);
+  pointer-events: none;
+}
+.c-page-loading__card[data-v-aec6cc81] {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 10px;
+  width: 224px;
+  max-width: 100%;
+  padding: 26px 24px 22px;
+  box-sizing: border-box;
+  border-radius: 22px;
+  border: 1px solid var(--c-page-loading-border);
+  background: var(--c-page-loading-surface);
+  background-image: radial-gradient(ellipse at 50% 0, color-mix(in srgb, currentColor 6%, transparent), transparent 70%);
+  box-shadow: 0 16px 56px rgba(0, 0, 0, 0.1);
+  text-align: center;
+}
+.c-page-loading__glyph[data-v-aec6cc81] {
+  width: 76px;
+  height: 76px;
+  margin-bottom: 4px;
+  flex-shrink: 0;
+}
+.c-page-loading__outer[data-v-aec6cc81], .c-page-loading__inner[data-v-aec6cc81], .c-page-loading__pulse[data-v-aec6cc81] {
+  transform-box: view-box;
+  transform-origin: center;
+}
+.c-page-loading__outer[data-v-aec6cc81] {
+  animation: c-page-loading-orbit-aec6cc81 2s linear infinite;
+}
+.c-page-loading__inner[data-v-aec6cc81] {
+  animation: c-page-loading-orbit-aec6cc81 2.8s linear infinite reverse;
+}
+.c-page-loading__pulse[data-v-aec6cc81] {
+  animation: c-page-loading-pulse-aec6cc81 2s ease-in-out infinite alternate;
+}
+.c-page-loading__wave[data-v-aec6cc81] {
+  stroke-dasharray: 100;
+  animation: c-page-loading-wave-aec6cc81 2s ease-in-out infinite;
+}
+.c-page-loading__label[data-v-aec6cc81] {
+  color: var(--c-page-loading-text);
+  font-size: 14px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  line-height: 1.6;
+  overflow-wrap: anywhere;
+}
+.c-page-loading__description[data-v-aec6cc81] {
+  color: var(--c-page-loading-muted);
+  font-size: 12px;
+  line-height: 1.5;
+  overflow-wrap: anywhere;
+}
+.c-page-loading__track[data-v-aec6cc81] {
+  width: 88px;
+  height: 2px;
+  margin-top: 8px;
+  overflow: hidden;
+  border-radius: 99px;
+  background: color-mix(in srgb, currentColor 10%, transparent);
+}
+.c-page-loading__track[data-v-aec6cc81]::after {
+  content: "";
+  display: block;
+  width: 50%;
+  height: 100%;
+  border-radius: inherit;
+  background: linear-gradient(90deg, transparent, currentColor, transparent);
+  animation: c-page-loading-track-aec6cc81 1.6s ease-in-out infinite;
+}
+.c-page-loading-fade-enter-active[data-v-aec6cc81],
+.c-page-loading-fade-leave-active[data-v-aec6cc81] {
+  transition: opacity 0.16s ease;
+}
+.c-page-loading-fade-enter-from[data-v-aec6cc81],
+.c-page-loading-fade-leave-to[data-v-aec6cc81] {
+  opacity: 0;
+}
+@keyframes c-page-loading-orbit-aec6cc81 {
+to {
+    transform: rotate(360deg);
+}
+}
+@keyframes c-page-loading-pulse-aec6cc81 {
+from {
+    transform: scale(0.9);
+}
+to {
+    transform: scale(1.15);
+}
+}
+@keyframes c-page-loading-wave-aec6cc81 {
+0% {
+    stroke-dashoffset: 100;
+    opacity: 0.3;
+}
+45%, 65% {
+    stroke-dashoffset: 0;
+    opacity: 1;
+}
+100% {
+    stroke-dashoffset: -100;
+    opacity: 0.3;
+}
+}
+@keyframes c-page-loading-track-aec6cc81 {
+from {
+    transform: translateX(-100%);
+}
+to {
+    transform: translateX(200%);
+}
+}
+@media (prefers-reduced-motion: reduce) {
+.c-page-loading__outer[data-v-aec6cc81],
+  .c-page-loading__inner[data-v-aec6cc81],
+  .c-page-loading__pulse[data-v-aec6cc81],
+  .c-page-loading__wave[data-v-aec6cc81],
+  .c-page-loading__track[data-v-aec6cc81]::after {
+    animation: none;
+}
+.c-page-loading__track[data-v-aec6cc81]::after {
+    transform: translateX(50%);
+}
+.c-page-loading-fade-enter-active[data-v-aec6cc81],
+  .c-page-loading-fade-leave-active[data-v-aec6cc81] {
+    transition: none;
+}
+}
+/* unplugin-vue-components disabled */
+/* layer: default */
+.table[data-v-aec6cc81]{display:table;}
+.filter[data-v-aec6cc81]{filter:var(--un-blur) var(--un-brightness) var(--un-contrast) var(--un-drop-shadow) var(--un-grayscale) var(--un-hue-rotate) var(--un-invert) var(--un-saturate) var(--un-sepia);}
+

package/dist/C_PageLoading.d.cts

@@ -0,0 +1,2 @@
+import { i as PageLoadingProps, n as _default, r as PageLoadingOptions, t as createPageLoading } from "./createPageLoading.cjs";
+export { _default as C_PageLoading, type PageLoadingOptions, type PageLoadingProps, createPageLoading };

package/dist/C_PageLoading.d.ts

@@ -0,0 +1,2 @@
+import { i as PageLoadingProps, n as _default, r as PageLoadingOptions, t as createPageLoading } from "./createPageLoading.js";
+export { _default as C_PageLoading, type PageLoadingOptions, type PageLoadingProps, createPageLoading };

package/dist/C_PageLoading.js

@@ -0,0 +1 @@
+import{n as e,t}from"./createPageLoading.js";export{e as C_PageLoading,t as createPageLoading};

package/dist/constants.d.cts

@@ -118,9 +118,9 @@ declare const __VLS_export: vue.DefineComponent<CronProps, {
   onChange?: ((value: string) => any) | undefined;
   "onValidation-change"?: ((result: CronValidation) => any) | undefined;
 }>, {
+  height: string | number;
   modelValue: string;
   disabled: boolean;
-  height: string | number;
   showPreview: boolean;
   previewCount: number;
   showTemplates: boolean;

package/dist/constants.d.ts

@@ -118,9 +118,9 @@ declare const __VLS_export: vue.DefineComponent<CronProps, {
   onChange?: ((value: string) => any) | undefined;
   "onValidation-change"?: ((result: CronValidation) => any) | undefined;
 }>, {
+  height: string | number;
   modelValue: string;
   disabled: boolean;
-  height: string | number;
   showPreview: boolean;
   previewCount: number;
   showTemplates: boolean;

package/dist/constants2.d.cts

@@ -120,14 +120,14 @@ declare const __VLS_export: vue.DefineComponent<FormulaEditorProps, FormulaEdito
   onChange?: ((value: string) => any) | undefined;
   "onValidation-change"?: ((result: FormulaValidation) => any) | undefined;
 }>, {
+  height: string | number;
   modelValue: string;
-  placeholder: string;
   disabled: boolean;
-  height: string | number;
+  placeholder: string;
+  showPreview: boolean;
   variables: FormulaVariable[];
   functions: FormulaFunction[];
   sampleData: Record<string, number | string | boolean>;
-  showPreview: boolean;
   showKeyboard: boolean;
   showVariablePanel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/constants2.d.ts

@@ -120,14 +120,14 @@ declare const __VLS_export: vue.DefineComponent<FormulaEditorProps, FormulaEdito
   onChange?: ((value: string) => any) | undefined;
   "onValidation-change"?: ((result: FormulaValidation) => any) | undefined;
 }>, {
+  height: string | number;
   modelValue: string;
-  placeholder: string;
   disabled: boolean;
-  height: string | number;
+  placeholder: string;
+  showPreview: boolean;
   variables: FormulaVariable[];
   functions: FormulaFunction[];
   sampleData: Record<string, number | string | boolean>;
-  showPreview: boolean;
   showKeyboard: boolean;
   showVariablePanel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/constants4.d.cts

@@ -196,31 +196,31 @@ type __VLS_Slots = {} & {
   area?: (props: typeof __VLS_11) => any;
 };
 declare const __VLS_base: vue.DefineComponent<UploadProps, UploadExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  error: (file: UploadFileItem, error: Error) => any;
   change: (fileList: UploadFileItem[]) => any;
-  progress: (file: UploadFileItem, percent: number) => any;
+  error: (file: UploadFileItem, error: Error) => any;
   success: (file: UploadFileItem, response: unknown) => any;
+  progress: (file: UploadFileItem, percent: number) => any;
   remove: (file: UploadFileItem) => any;
   finish: (fileList: UploadFileItem[]) => any;
   exceed: (files: File[], fileList: UploadFileItem[]) => any;
 }, string, vue.PublicProps, Readonly<UploadProps> & Readonly<{
-  onError?: ((file: UploadFileItem, error: Error) => any) | undefined;
   onChange?: ((fileList: UploadFileItem[]) => any) | undefined;
-  onProgress?: ((file: UploadFileItem, percent: number) => any) | undefined;
+  onError?: ((file: UploadFileItem, error: Error) => any) | undefined;
   onSuccess?: ((file: UploadFileItem, response: unknown) => any) | undefined;
+  onProgress?: ((file: UploadFileItem, percent: number) => any) | undefined;
   onRemove?: ((file: UploadFileItem) => any) | undefined;
   onFinish?: ((fileList: UploadFileItem[]) => any) | undefined;
   onExceed?: ((files: File[], fileList: UploadFileItem[]) => any) | undefined;
 }>, {
-  disabled: boolean;
   data: Record<string, unknown>;
+  maxSize: number;
+  disabled: boolean;
   draggable: boolean;
   multiple: boolean;
   action: string;
   headers: Record<string, string>;
   directory: boolean;
   accept: string;
-  maxSize: number;
   maxCount: number;
   pasteable: boolean;
   chunked: boolean;

package/dist/constants4.d.ts

@@ -196,31 +196,31 @@ type __VLS_Slots = {} & {
   area?: (props: typeof __VLS_11) => any;
 };
 declare const __VLS_base: vue.DefineComponent<UploadProps, UploadExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  error: (file: UploadFileItem, error: Error) => any;
   change: (fileList: UploadFileItem[]) => any;
-  progress: (file: UploadFileItem, percent: number) => any;
+  error: (file: UploadFileItem, error: Error) => any;
   success: (file: UploadFileItem, response: unknown) => any;
+  progress: (file: UploadFileItem, percent: number) => any;
   remove: (file: UploadFileItem) => any;
   finish: (fileList: UploadFileItem[]) => any;
   exceed: (files: File[], fileList: UploadFileItem[]) => any;
 }, string, vue.PublicProps, Readonly<UploadProps> & Readonly<{
-  onError?: ((file: UploadFileItem, error: Error) => any) | undefined;
   onChange?: ((fileList: UploadFileItem[]) => any) | undefined;
-  onProgress?: ((file: UploadFileItem, percent: number) => any) | undefined;
+  onError?: ((file: UploadFileItem, error: Error) => any) | undefined;
   onSuccess?: ((file: UploadFileItem, response: unknown) => any) | undefined;
+  onProgress?: ((file: UploadFileItem, percent: number) => any) | undefined;
   onRemove?: ((file: UploadFileItem) => any) | undefined;
   onFinish?: ((fileList: UploadFileItem[]) => any) | undefined;
   onExceed?: ((files: File[], fileList: UploadFileItem[]) => any) | undefined;
 }>, {
-  disabled: boolean;
   data: Record<string, unknown>;
+  maxSize: number;
+  disabled: boolean;
   draggable: boolean;
   multiple: boolean;
   action: string;
   headers: Record<string, string>;
   directory: boolean;
   accept: string;
-  maxSize: number;
   maxCount: number;
   pasteable: boolean;
   chunked: boolean;

package/dist/constants5.d.cts

@@ -258,11 +258,11 @@ type PlayerInstance = InstanceType<typeof xgplayer.default>;
 //#endregion
 //#region src/components/C_VideoPlayer/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<VideoPlayerProps, VideoPlayerExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  error: (error: Error) => any;
   ready: () => any;
+  error: (error: Error) => any;
+  ended: () => any;
   stateChange: (state: PlayerState) => any;
   timeUpdate: (currentTime: number, duration: number) => any;
-  ended: () => any;
   qualityChange: (quality: QualityLevel) => any;
   rateChange: (rate: number) => any;
   fullscreenChange: (isFullscreen: boolean) => any;
@@ -271,11 +271,11 @@ declare const __VLS_export: vue.DefineComponent<VideoPlayerProps, VideoPlayerExp
   chapterChange: (chapter: Chapter) => any;
   progressUpdate: (data: ProgressData) => any;
 }, string, vue.PublicProps, Readonly<VideoPlayerProps> & Readonly<{
-  onError?: ((error: Error) => any) | undefined;
   onReady?: (() => any) | undefined;
+  onError?: ((error: Error) => any) | undefined;
+  onEnded?: (() => any) | undefined;
   onStateChange?: ((state: PlayerState) => any) | undefined;
   onTimeUpdate?: ((currentTime: number, duration: number) => any) | undefined;
-  onEnded?: (() => any) | undefined;
   onQualityChange?: ((quality: QualityLevel) => any) | undefined;
   onRateChange?: ((rate: number) => any) | undefined;
   onFullscreenChange?: ((isFullscreen: boolean) => any) | undefined;

package/dist/constants5.d.ts

@@ -258,11 +258,11 @@ type PlayerInstance = InstanceType<typeof xgplayer.default>;
 //#endregion
 //#region src/components/C_VideoPlayer/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<VideoPlayerProps, VideoPlayerExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  error: (error: Error) => any;
   ready: () => any;
+  error: (error: Error) => any;
+  ended: () => any;
   stateChange: (state: PlayerState) => any;
   timeUpdate: (currentTime: number, duration: number) => any;
-  ended: () => any;
   qualityChange: (quality: QualityLevel) => any;
   rateChange: (rate: number) => any;
   fullscreenChange: (isFullscreen: boolean) => any;
@@ -271,11 +271,11 @@ declare const __VLS_export: vue.DefineComponent<VideoPlayerProps, VideoPlayerExp
   chapterChange: (chapter: Chapter) => any;
   progressUpdate: (data: ProgressData) => any;
 }, string, vue.PublicProps, Readonly<VideoPlayerProps> & Readonly<{
-  onError?: ((error: Error) => any) | undefined;
   onReady?: (() => any) | undefined;
+  onError?: ((error: Error) => any) | undefined;
+  onEnded?: (() => any) | undefined;
   onStateChange?: ((state: PlayerState) => any) | undefined;
   onTimeUpdate?: ((currentTime: number, duration: number) => any) | undefined;
-  onEnded?: (() => any) | undefined;
   onQualityChange?: ((quality: QualityLevel) => any) | undefined;
   onRateChange?: ((rate: number) => any) | undefined;
   onFullscreenChange?: ((isFullscreen: boolean) => any) | undefined;

package/dist/createPageLoading.cjs

@@ -0,0 +1 @@
+require(`./chunk.cjs`);const e=require(`./config.cjs`),t=require(`./export-helper.cjs`);let n=require(`vue`),r=require(`naive-ui`);const i={class:`c-page-loading__card`,role:`status`,"aria-live":`polite`,"aria-atomic":`true`},a={class:`c-page-loading__label`},o={key:0,class:`c-page-loading__description`},s=(0,n.defineComponent)({name:`C_PageLoading`,__name:`index`,props:{show:{type:Boolean},label:{},description:{},color:{}},setup(t){let s=(0,r.useThemeVars)(),{t:c}=e.i();return(e,r)=>((0,n.openBlock)(),(0,n.createBlock)(n.Teleport,{to:`body`},[(0,n.createVNode)(n.Transition,{name:`c-page-loading-fade`},{default:(0,n.withCtx)(()=>[t.show?((0,n.openBlock)(),(0,n.createElementBlock)(`div`,{key:0,class:`c-page-loading`,style:(0,n.normalizeStyle)({"--c-page-loading-surface":(0,n.unref)(s).cardColor,"--c-page-loading-body":(0,n.unref)(s).bodyColor,"--c-page-loading-border":(0,n.unref)(s).dividerColor,"--c-page-loading-text":(0,n.unref)(s).textColor1,"--c-page-loading-muted":(0,n.unref)(s).textColor3,color:t.color||(0,n.unref)(s).primaryColor})},[(0,n.createElementVNode)(`div`,i,[r[0]||=(0,n.createElementVNode)(`svg`,{class:`c-page-loading__glyph`,viewBox:`0 0 80 80`,fill:`none`,"aria-hidden":`true`,focusable:`false`},[(0,n.createElementVNode)(`circle`,{cx:`40`,cy:`40`,r:`35`,stroke:`currentColor`,"stroke-opacity":`.08`}),(0,n.createElementVNode)(`circle`,{class:`c-page-loading__outer`,cx:`40`,cy:`40`,r:`35`,stroke:`currentColor`,"stroke-opacity":`.38`,"stroke-width":`2`,"stroke-dasharray":`64 156`,"stroke-linecap":`round`}),(0,n.createElementVNode)(`circle`,{class:`c-page-loading__inner`,cx:`40`,cy:`40`,r:`24`,stroke:`currentColor`,"stroke-opacity":`.24`,"stroke-width":`1.5`,"stroke-dasharray":`34 117`,"stroke-linecap":`round`}),(0,n.createElementVNode)(`circle`,{class:`c-page-loading__pulse`,cx:`40`,cy:`40`,r:`17`,fill:`currentColor`,"fill-opacity":`.06`}),(0,n.createElementVNode)(`path`,{class:`c-page-loading__wave`,d:`M11 40 Q20.5 27 30 40 Q39.5 53 49 40 Q58.5 27 68 40`,stroke:`currentColor`,"stroke-width":`2`,"stroke-linecap":`round`}),(0,n.createElementVNode)(`circle`,{cx:`40`,cy:`40`,r:`3`,fill:`currentColor`})],-1),(0,n.createElementVNode)(`span`,a,(0,n.toDisplayString)(t.label||(0,n.unref)(c)(`common.loading`)),1),t.description?((0,n.openBlock)(),(0,n.createElementBlock)(`span`,o,(0,n.toDisplayString)(t.description),1)):(0,n.createCommentVNode)(`v-if`,!0),r[1]||=(0,n.createElementVNode)(`span`,{class:`c-page-loading__track`,"aria-hidden":`true`},null,-1)])],4)):(0,n.createCommentVNode)(`v-if`,!0)]),_:1})]))}});var c=t.t(s,[[`__scopeId`,`data-v-aec6cc81`]]);function l(e={}){let t=(0,n.ref)(!1),r=e.delay??160,i=Number.isFinite(r)?Math.max(0,r):160,a=0,o,s=()=>{o!==void 0&&clearTimeout(o),o=void 0};return{visible:(0,n.readonly)(t),start:()=>{s();let e=++a;return t.value||(o=setTimeout(()=>{o=void 0,e===a&&(t.value=!0)},i)),e},finish:e=>{e===a&&(s(),t.value=!1)},reset:()=>{a++,s(),t.value=!1}}}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return l}});

package/dist/createPageLoading.d.cts

@@ -0,0 +1,32 @@
+import * as vue from "vue";
+
+//#region src/components/C_PageLoading/types.d.ts
+interface PageLoadingProps {
+  /** 是否显示；路由生命周期由接入项目控制。 */
+  show: boolean;
+  /** 默认使用组件库的加载文案。 */
+  label?: string;
+  /** 可选说明，例如目标页面名称。 */
+  description?: string;
+  /** 默认使用 Naive UI 主色。 */
+  color?: string;
+}
+interface PageLoadingOptions {
+  /** 延迟显示的毫秒数，默认 160；完成速度快时不显示遮罩。 */
+  delay?: number;
+}
+//#endregion
+//#region src/components/C_PageLoading/index.vue.d.ts
+declare const __VLS_export: vue.DefineComponent<PageLoadingProps, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<PageLoadingProps> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+//#region src/components/C_PageLoading/createPageLoading.d.ts
+/** 创建独立状态；不依赖路由、Store、DOM 或项目配置。 */
+declare function createPageLoading(options?: PageLoadingOptions): {
+  visible: Readonly<vue.Ref<boolean, boolean>>;
+  start: () => number;
+  finish: (id: number) => void;
+  reset: () => void;
+};
+//#endregion
+export { PageLoadingProps as i, _default as n, PageLoadingOptions as r, createPageLoading as t };

package/dist/createPageLoading.d.ts

@@ -0,0 +1,32 @@
+import * as vue from "vue";
+
+//#region src/components/C_PageLoading/types.d.ts
+interface PageLoadingProps {
+  /** 是否显示；路由生命周期由接入项目控制。 */
+  show: boolean;
+  /** 默认使用组件库的加载文案。 */
+  label?: string;
+  /** 可选说明，例如目标页面名称。 */
+  description?: string;
+  /** 默认使用 Naive UI 主色。 */
+  color?: string;
+}
+interface PageLoadingOptions {
+  /** 延迟显示的毫秒数，默认 160；完成速度快时不显示遮罩。 */
+  delay?: number;
+}
+//#endregion
+//#region src/components/C_PageLoading/index.vue.d.ts
+declare const __VLS_export: vue.DefineComponent<PageLoadingProps, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<PageLoadingProps> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+//#region src/components/C_PageLoading/createPageLoading.d.ts
+/** 创建独立状态；不依赖路由、Store、DOM 或项目配置。 */
+declare function createPageLoading(options?: PageLoadingOptions): {
+  visible: Readonly<vue.Ref<boolean, boolean>>;
+  start: () => number;
+  finish: (id: number) => void;
+  reset: () => void;
+};
+//#endregion
+export { PageLoadingProps as i, _default as n, PageLoadingOptions as r, createPageLoading as t };

package/dist/createPageLoading.js

@@ -0,0 +1 @@
+import{i as e}from"./config.js";import{t}from"./export-helper.js";import{Teleport as n,Transition as r,createBlock as i,createCommentVNode as a,createElementBlock as o,createElementVNode as s,createVNode as c,defineComponent as l,normalizeStyle as u,openBlock as d,readonly as f,ref as p,toDisplayString as m,unref as h,withCtx as g}from"vue";import{useThemeVars as _}from"naive-ui";const v={class:`c-page-loading__card`,role:`status`,"aria-live":`polite`,"aria-atomic":`true`},y={class:`c-page-loading__label`},b={key:0,class:`c-page-loading__description`};var x=t(l({name:`C_PageLoading`,__name:`index`,props:{show:{type:Boolean},label:{},description:{},color:{}},setup(t){let l=_(),{t:f}=e();return(e,p)=>(d(),i(n,{to:`body`},[c(r,{name:`c-page-loading-fade`},{default:g(()=>[t.show?(d(),o(`div`,{key:0,class:`c-page-loading`,style:u({"--c-page-loading-surface":h(l).cardColor,"--c-page-loading-body":h(l).bodyColor,"--c-page-loading-border":h(l).dividerColor,"--c-page-loading-text":h(l).textColor1,"--c-page-loading-muted":h(l).textColor3,color:t.color||h(l).primaryColor})},[s(`div`,v,[p[0]||=s(`svg`,{class:`c-page-loading__glyph`,viewBox:`0 0 80 80`,fill:`none`,"aria-hidden":`true`,focusable:`false`},[s(`circle`,{cx:`40`,cy:`40`,r:`35`,stroke:`currentColor`,"stroke-opacity":`.08`}),s(`circle`,{class:`c-page-loading__outer`,cx:`40`,cy:`40`,r:`35`,stroke:`currentColor`,"stroke-opacity":`.38`,"stroke-width":`2`,"stroke-dasharray":`64 156`,"stroke-linecap":`round`}),s(`circle`,{class:`c-page-loading__inner`,cx:`40`,cy:`40`,r:`24`,stroke:`currentColor`,"stroke-opacity":`.24`,"stroke-width":`1.5`,"stroke-dasharray":`34 117`,"stroke-linecap":`round`}),s(`circle`,{class:`c-page-loading__pulse`,cx:`40`,cy:`40`,r:`17`,fill:`currentColor`,"fill-opacity":`.06`}),s(`path`,{class:`c-page-loading__wave`,d:`M11 40 Q20.5 27 30 40 Q39.5 53 49 40 Q58.5 27 68 40`,stroke:`currentColor`,"stroke-width":`2`,"stroke-linecap":`round`}),s(`circle`,{cx:`40`,cy:`40`,r:`3`,fill:`currentColor`})],-1),s(`span`,y,m(t.label||h(f)(`common.loading`)),1),t.description?(d(),o(`span`,b,m(t.description),1)):a(`v-if`,!0),p[1]||=s(`span`,{class:`c-page-loading__track`,"aria-hidden":`true`},null,-1)])],4)):a(`v-if`,!0)]),_:1})]))}}),[[`__scopeId`,`data-v-aec6cc81`]]);function S(e={}){let t=p(!1),n=e.delay??160,r=Number.isFinite(n)?Math.max(0,n):160,i=0,a,o=()=>{a!==void 0&&clearTimeout(a),a=void 0};return{visible:f(t),start:()=>{o();let e=++i;return t.value||(a=setTimeout(()=>{a=void 0,e===i&&(t.value=!0)},r)),e},finish:e=>{e===i&&(o(),t.value=!1)},reset:()=>{i++,o(),t.value=!1}}}export{x as n,S as t};

package/dist/data.d.cts

@@ -67,24 +67,24 @@ declare const __VLS_base: vue.DefineComponent<CTabsProps, {
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   add: () => any;
   "update:modelValue": (value: TabsValue) => any;
-  close: (value: TabsValue) => any;
   change: (value: TabsValue, item: TabsItem | undefined) => any;
+  close: (value: TabsValue) => any;
 }, string, vue.PublicProps, Readonly<CTabsProps> & Readonly<{
   onAdd?: (() => any) | undefined;
   "onUpdate:modelValue"?: ((value: TabsValue) => any) | undefined;
-  onClose?: ((value: TabsValue) => any) | undefined;
   onChange?: ((value: TabsValue, item: TabsItem | undefined) => any) | undefined;
+  onClose?: ((value: TabsValue) => any) | undefined;
 }>, {
-  modelValue: TabsValue | null;
   size: TabsSize;
   type: TabsType;
+  modelValue: TabsValue | null;
   items: readonly TabsItem[];
   closable: boolean;
   addable: boolean;
+  defaultValue: TabsValue | null;
   placement: TabsPlacement;
   displayDirective: TabsDisplayDirective;
   animated: boolean;
-  defaultValue: TabsValue | null;
   justifyContent: TabsJustifyContent;
   tabsOnly: boolean;
   paneClass: string;