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

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @robot-admin/naive-ui-components
 
+## 0.14.0
+
+### Minor Changes
+
+- 修复按需样式丢失的构建根因：样式归属改为源模块编译记录，移除按 chunk 文件名猜测及别名补丁；Cron / 公式按需入口包含内部依赖和主题默认变量，发布门禁验证实际选择器。
+
+- `C_Cron` 与 `C_FormulaEditor` 推荐使用 `v-model + config` 扁平接入；保留原有独立属性和实例方法，组件内部统一处理模板、编辑、校验、重置与结果反馈。
+- Cron 重构为计划模板、时间字段与执行预览三段工作区；非法或待应用表达式清除过期预览，隐藏预览不启动计算，卸载取消待执行任务。空指定值不再意外扩大为每个值执行；日与星期始终互斥。重置恢复挂载时的初始规则。
+- 公式使用有界安全语法树统一校验与求值，不运行 JavaScript。新增完整语法和函数参数校验、错误字符定位、IF/三元/AND/OR 短路语义；同一公式编译结果随试算数据复用。常量也能直接试算，字符串中的括号和变量名称不会误报。
+- 公式输入改用原生 textarea，保留中文输入、纯文本粘贴和选择区插入；高亮使用 Vue 转义后的独立结构预览。试算值可编辑、与调用方数据隔离，空数字区别于零；只读状态阻止编辑入口，重置同时恢复公式和试算值。
+- 两个工作区按组件容器宽度自适应，样式只使用组件作用域和主题变量；新增打包消费类型与真实浏览器回归，无额外依赖。
+
+## 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)
@@ -105,6 +105,47 @@ import '@robot-admin/naive-ui-components/C_Table/base.css'
 // 完整模式也可显式使用 C_Form/full.css、C_Table/full.css
 ```
 
+### Cron 与公式工作区
+
+一个模型加一份扁平配置即可。原有独立属性继续兼容，组件内部统一处理模板、校验、预览与初始状态重置。
+
+```vue
+<script setup lang="ts">
+  import { ref } from 'vue'
+  import {
+    C_Cron,
+    type CronConfig,
+  } from '@robot-admin/naive-ui-components/C_Cron'
+  import {
+    C_FormulaEditor,
+    type FormulaEditorConfig,
+  } from '@robot-admin/naive-ui-components/C_FormulaEditor'
+  import '@robot-admin/naive-ui-components/C_Cron/style.css'
+  import '@robot-admin/naive-ui-components/C_FormulaEditor/style.css'
+
+  const expression = ref('0 30 8 * * ?')
+  const cronConfig: CronConfig = { previewCount: 5 }
+  const formula = ref('IF([完成值] > 0, 100 / [完成值], 0)')
+  const formulaConfig: FormulaEditorConfig = {
+    variables: [{ name: '完成值', field: 'completed', type: 'number' }],
+    sampleData: { completed: 5 },
+    editableSampleData: true,
+  }
+</script>
+<template>
+  <C_Cron
+    v-model="expression"
+    :config="cronConfig"
+  />
+  <C_FormulaEditor
+    v-model="formula"
+    :config="formulaConfig"
+  />
+</template>
+```
+
+Cron 支持秒到星期的六个数字字段、范围、间隔、列表及日/星期 `?` 互斥，不实现 L/W/# 扩展；预览按浏览器本地时区计算，不会调度任务。公式试算只在本地进行，不修改传入的 `sampleData`；校验和计算复用有界解析器，条件分支按需执行。通过 `showPreview`、`showKeyboard`、`showVariablePanel` 控制嵌入布局，`disabled` 同时保护试算输入。重置恢复初始模型及数据；切换独立记录时使用新 key 重新挂载。
+
 ### C_Guide 配置引导
 
 项目只需要提供目标和步骤，组件内置主题、可选 SVG 示意图及退出清理，不依赖项目的路由或 Store：
@@ -479,7 +520,7 @@ const config = defineTableConfig({
 </NSpin>
 ```
 
-### 📋 组件清单（54 个）
+### 📋 组件清单（55 个）
 
 > 💡 所有组件均提供 **在线交互演示**，访问 [组件文档](https://www.tzagileteam.com/robot/components/preface) 可直接在页面中体验真实效果（通过 iframe 嵌入 Robot Admin 生产环境）。
 
@@ -489,6 +530,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 +643,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 +653,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 +668,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 +777,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)
@@ -105,6 +105,47 @@ import '@robot-admin/naive-ui-components/C_Table/base.css'
 // Full mode is also available as C_Form/full.css and C_Table/full.css.
 ```
 
+### Cron and formula workspaces
+
+Use a model and one flat config. Existing individual props remain supported; templates, validation, previews and initial-state reset are owned by the components.
+
+```vue
+<script setup lang="ts">
+  import { ref } from 'vue'
+  import {
+    C_Cron,
+    type CronConfig,
+  } from '@robot-admin/naive-ui-components/C_Cron'
+  import {
+    C_FormulaEditor,
+    type FormulaEditorConfig,
+  } from '@robot-admin/naive-ui-components/C_FormulaEditor'
+  import '@robot-admin/naive-ui-components/C_Cron/style.css'
+  import '@robot-admin/naive-ui-components/C_FormulaEditor/style.css'
+
+  const expression = ref('0 30 8 * * ?')
+  const cronConfig: CronConfig = { previewCount: 5 }
+  const formula = ref('IF([完成值] > 0, 100 / [完成值], 0)')
+  const formulaConfig: FormulaEditorConfig = {
+    variables: [{ name: '完成值', field: 'completed', type: 'number' }],
+    sampleData: { completed: 5 },
+    editableSampleData: true,
+  }
+</script>
+<template>
+  <C_Cron
+    v-model="expression"
+    :config="cronConfig"
+  />
+  <C_FormulaEditor
+    v-model="formula"
+    :config="formulaConfig"
+  />
+</template>
+```
+
+Cron supports six numeric fields, ranges, steps, lists and day/weekday exclusion with `?`; L/W/# extensions are not supported. Preview dates use the browser local timezone and never schedule jobs. Formula trials do not mutate caller `sampleData`; validation and calculation share a bounded parser with lazy conditions. Compact modes use `showPreview`, `showKeyboard` and `showVariablePanel`. Read-only mode protects trial inputs too. Reset restores the initial model and data; remount with a new key when switching independent records.
+
 ### Configure C_Guide
 
 Provide targets and steps; the component owns its theme, optional SVG illustrations, and cleanup without depending on a host router or store:
@@ -420,7 +461,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 +471,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 +584,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 +594,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 +609,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 +709,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_ActionBar.css

@@ -1,3 +1,11 @@
+:root{--c-primary: var(--primary-color, #2080f0);--c-primary-hover: var(--primary-color-hover, #4098fc);--c-primary-pressed: var(--primary-color-pressed, #1060c9);--c-success: var(--success-color, #18a058);--c-warning: var(--warning-color, #f0a020);--c-error: var(--error-color, #d03050);--c-info: var(--info-color, #2080f0);--c-bg-body: var(--body-color, #ffffff);--c-bg-card: var(--card-color, #ffffff);--c-bg-surface: var(--popover-color, #ffffff);--c-text-1: var(--text-color-1, #262626);--c-text-2: var(--text-color-2, #525252);--c-text-3: var(--text-color-3, #a3a3a3);--c-text-4: var(--text-color-4, #c0c0c0);--c-border: var(--border-color, #e5e7eb);--c-radius-sm: var(--border-radius-small, 4px);--c-radius: var(--border-radius, 6px);--c-transition-fast: 0.15s cubic-bezier(0.4, 0, 0.2, 1);--c-transition-base: 0.3s cubic-bezier(0.4, 0, 0.2, 1);--c-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.08);--c-shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);--c-shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1)}
+
+/* unplugin-vue-components disabled */
+/* layer: default */
+.inline-flex[data-v-075758a0]{display:inline-flex;}
+.transform[data-v-075758a0]{transform:translateX(var(--un-translate-x)) translateY(var(--un-translate-y)) translateZ(var(--un-translate-z)) rotate(var(--un-rotate)) rotateX(var(--un-rotate-x)) rotateY(var(--un-rotate-y)) rotateZ(var(--un-rotate-z)) skewX(var(--un-skew-x)) skewY(var(--un-skew-y)) scaleX(var(--un-scale-x)) scaleY(var(--un-scale-y)) scaleZ(var(--un-scale-z));}
+.px[data-v-075758a0]{padding-left:1rem;padding-right:1rem;}
+
 /* unplugin-vue-components disabled */.c-icon[data-v-075758a0] {
   display: inline-flex;
   align-items: center;
@@ -59,10 +67,8 @@
 }
 /* unplugin-vue-components disabled */
 /* layer: default */
-.inline-flex[data-v-075758a0]{display:inline-flex;}
-.transform[data-v-075758a0]{transform:translateX(var(--un-translate-x)) translateY(var(--un-translate-y)) translateZ(var(--un-translate-z)) rotate(var(--un-rotate)) rotateX(var(--un-rotate-x)) rotateY(var(--un-rotate-y)) rotateZ(var(--un-rotate-z)) skewX(var(--un-skew-x)) skewY(var(--un-skew-y)) scaleX(var(--un-scale-x)) scaleY(var(--un-scale-y)) scaleZ(var(--un-scale-z));}
-.px[data-v-075758a0]{padding-left:1rem;padding-right:1rem;}
-
+.inline[data-v-325a50d2]{display:inline;}
+.px[data-v-325a50d2]{padding-left:1rem;padding-right:1rem;}
 
 /* unplugin-vue-components disabled *//* 通用操作按钮组件样式 */
 /* ================= 主容器 ================= */
@@ -266,9 +272,4 @@ html.dark .action-divider[data-v-325a50d2] {
 }
 html.dark .action-divider[data-v-325a50d2]:hover {
   opacity: 0.4;
-}
-/* unplugin-vue-components disabled */
-/* layer: default */
-.inline[data-v-325a50d2]{display:inline;}
-.px[data-v-325a50d2]{padding-left:1rem;padding-right:1rem;}
-
+}