@robot-admin/naive-ui-components 0.4.5 → 0.6.0

package/dist/menuAdapter.d.ts

@@ -0,0 +1,167 @@
+import { VNode } from "vue";
+import { MenuOption } from "naive-ui/es";
+
+//#region src/components/_shared/types.d.ts
+/**
+ * 路由项 — 组件库统一的路由/菜单数据结构
+ *
+ * 设计原则：
+ * - 顶层字段与 Vue Router `RouteRecordRaw` 对齐
+ * - `meta` 字段采用 Admin 生态公约（title / icon / hidden / affix / keepAlive）
+ * - 同时兼容后端直接返回的 JSON 路由表（path + meta 即可）
+ *
+ * @example Vue Router 格式
+ * ```ts
+ * const route: RouteItem = {
+ *   path: '/dashboard',
+ *   name: 'Dashboard',
+ *   meta: { title: '仪表盘', icon: 'mdi:monitor-dashboard' },
+ *   children: [...]
+ * }
+ * ```
+ *
+ * @example 后端 JSON 格式
+ * ```ts
+ * const menuFromApi: RouteItem = {
+ *   path: '/system/user',
+ *   meta: { title: '用户管理', icon: 'mdi:account' }
+ * }
+ * ```
+ */
+interface RouteItem {
+  /** 路由路径（必须） */
+  path: string;
+  /** 路由名称 */
+  name?: string;
+  /** 重定向路径 */
+  redirect?: string;
+  /** 组件名称或路径（用于动态导入） */
+  component?: string | (() => Promise<any>);
+  /** 菜单/路由元数据 */
+  meta?: RouteMeta;
+  /** 子路由 */
+  children?: RouteItem[];
+  /** 菜单项类型：'group' 分组 | 'divider' 分割线 */
+  type?: 'group' | 'divider';
+  /** 是否禁用 */
+  disabled?: boolean;
+}
+/**
+ * 路由元数据 — 兼容 Vue Router RouteMeta 扩展标准
+ *
+ * 参考：
+ * - Vue Router: https://router.vuejs.org/guide/advanced/meta.html
+ * - Vben Admin / Naive Admin Pro / Ant Design Pro Vue 的公约字段
+ */
+interface RouteMeta {
+  /** 页面/菜单标题 */
+  title?: string;
+  /** 图标名称（Iconify 格式如 'mdi:home'，或自定义） */
+  icon?: string | (() => VNode);
+  /** 是否在菜单中隐藏 */
+  hidden?: boolean;
+  /** 是否固定在标签栏 */
+  affix?: boolean;
+  /** 是否缓存页面（keep-alive） */
+  keepAlive?: boolean;
+  /** 是否全屏显示（不显示 header/sidebar） */
+  full?: boolean;
+  /** 外部链接 URL */
+  link?: string;
+  /** 排序权重 */
+  orderNo?: number;
+  /** 扩展属性 */
+  [key: string]: any;
+}
+/**
+ * 标签项 — C_TagsView 使用的标签数据结构
+ */
+interface TagItem {
+  /** 路由路径 */
+  path: string;
+  /** 显示标题（已翻译） */
+  title: string;
+  /** 原始标题（未翻译，用于语言切换后重新翻译） */
+  originalTitle?: string;
+  /** 图标名 */
+  icon?: string;
+  /** 元数据 */
+  meta?: {
+    /** 是否固定在标签栏 */affix?: boolean;
+    [key: string]: any;
+  };
+}
+/**
+ * 面包屑项 — C_Breadcrumb 使用的数据结构
+ */
+interface BreadcrumbItem {
+  /** 路径 key */
+  key: string;
+  /** 显示文本 */
+  label: string;
+  /** 图标名称 */
+  icon?: string;
+  /** 子级列表（用于下拉） */
+  children?: BreadcrumbItem[];
+}
+//#endregion
+//#region src/components/_shared/menuAdapter.d.ts
+/**
+ * 菜单适配器配置
+ */
+interface MenuAdapterConfig {
+  /**
+   * 标签文本格式化函数（用于 i18n）
+   * 默认：原样返回 title
+   */
+  labelFormatter?: (title: string) => string;
+  /**
+   * 获取菜单项的唯一 key
+   * 默认：`normalizePath(route.path)`
+   */
+  getKey?: (route: RouteItem) => string;
+  /**
+   * 获取显示文本
+   * 默认：`route.meta?.title || route.name || ''`
+   */
+  getLabel?: (route: RouteItem) => string;
+  /**
+   * 路由过滤器 — return false 排除该项
+   * 默认：排除 `meta.hidden === true`
+   */
+  filter?: (route: RouteItem) => boolean;
+  /**
+   * 自定义图标渲染
+   * 默认：字符串 → Iconify Icon；函数 → 直接调用
+   */
+  renderIcon?: (icon: string | (() => VNode) | undefined) => (() => VNode) | undefined;
+  /**
+   * 是否递归处理 children
+   * 默认：true
+   */
+  recursive?: boolean;
+}
+/**
+ * 将路由数据转换为 NMenu 的 MenuOption[]
+ *
+ * 支持的输入格式：
+ * 1. **Vue Router RouteRecordRaw** — 直接传 `router.getRoutes()` 或手写路由表
+ * 2. **后端 JSON 路由表** — `{ path, meta: { title, icon }, children }`
+ * 3. **自定义格式** — 通过 config 完全自定义 key/label/icon 的取值逻辑
+ *
+ * @param routes 路由数据数组
+ * @param config 适配器配置
+ * @returns NMenu 可直接使用的 MenuOption[]
+ */
+declare function createMenuOptions(routes: RouteItem[], config?: MenuAdapterConfig): MenuOption[];
+/**
+ * 将路由树扁平化为一维数组（常用于搜索、快捷导航）
+ *
+ * @param routes 路由数据数组
+ * @param filter 过滤器（默认排除 hidden）
+ * @returns 扁平化后的路由数组
+ */
+declare function flattenRoutes(routes: RouteItem[], filter?: (route: RouteItem) => boolean): RouteItem[];
+//#endregion
+export { RouteItem as a, BreadcrumbItem as i, createMenuOptions as n, RouteMeta as o, flattenRoutes as r, TagItem as s, MenuAdapterConfig as t };
+//# sourceMappingURL=menuAdapter.d.ts.map

package/dist/menuAdapter.js

@@ -0,0 +1,2 @@
+import{h as e}from"vue";import{Icon as t}from"@iconify/vue";const n=e=>e.startsWith(`/`)?e:`/${e}`,r=e=>e.path?n(e.path):``,i=e=>e.meta?.title||e.name||``,a=e=>!e.meta?.hidden,o=n=>{if(n){if(typeof n==`string`)return()=>e(`span`,{class:`inline-flex items-center n-icon`},[e(t,{icon:n})]);if(typeof n==`function`)return n}};function s(e,t={}){let{labelFormatter:n=e=>e,getKey:s=r,getLabel:c=i,filter:l=a,renderIcon:u=o,recursive:d=!0}=t,f=e=>e.filter(l).map(e=>{let t=e.meta?.icon||e.icon,r=d&&e.children?.length?f(e.children):void 0;return{key:s(e),label:n(c(e)),disabled:e.disabled||!1,icon:u(t),...e.type&&{type:e.type},...r?.length&&{children:r}}});return f(e)}function c(e,t=a){let n=[],r=e=>{for(let i of e)t(i)&&n.push(i),i.children?.length&&r(i.children)};return r(e),n}export{c as n,s as t};
+//# sourceMappingURL=menuAdapter.js.map

package/dist/menuAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuAdapter.js","names":[],"sources":["../src/components/_shared/menuAdapter.ts"],"sourcesContent":["/**\n * 菜单适配器 — 将路由数据转换为 NMenu 的 MenuOption[]\n *\n * 设计理念：\n * - 开箱即用：`createMenuOptions(routes)` 零配置即可生成菜单\n * - 完全可控：通过 `MenuAdapterConfig` 定制每一步转换逻辑\n * - i18n 解耦：`labelFormatter` 回调注入翻译函数，不绑定任何 i18n 方案\n *\n * @example 基础用法\n * ```ts\n * import { createMenuOptions } from '@robot-admin/naive-ui-components'\n *\n * const menuOptions = createMenuOptions(routes)\n * ```\n *\n * @example 带 i18n + 过滤\n * ```ts\n * const menuOptions = createMenuOptions(routes, {\n *   labelFormatter: t,          // vue-i18n 的 t 函数\n *   filter: route => !route.meta?.hidden,\n * })\n * ```\n *\n * @example 自定义 key 取值\n * ```ts\n * const menuOptions = createMenuOptions(routes, {\n *   getKey: route => route.name || route.path,\n * })\n * ```\n */\n\nimport { h, type VNode } from 'vue'\nimport { Icon } from '@iconify/vue'\nimport type { MenuOption } from 'naive-ui/es'\nimport type { RouteItem } from './types'\n\n/**\n * 菜单适配器配置\n */\nexport interface MenuAdapterConfig {\n  /**\n   * 标签文本格式化函数（用于 i18n）\n   * 默认：原样返回 title\n   */\n  labelFormatter?: (title: string) => string\n\n  /**\n   * 获取菜单项的唯一 key\n   * 默认：`normalizePath(route.path)`\n   */\n  getKey?: (route: RouteItem) => string\n\n  /**\n   * 获取显示文本\n   * 默认：`route.meta?.title || route.name || ''`\n   */\n  getLabel?: (route: RouteItem) => string\n\n  /**\n   * 路由过滤器 — return false 排除该项\n   * 默认：排除 `meta.hidden === true`\n   */\n  filter?: (route: RouteItem) => boolean\n\n  /**\n   * 自定义图标渲染\n   * 默认：字符串 → Iconify Icon；函数 → 直接调用\n   */\n  renderIcon?: (\n    icon: string | (() => VNode) | undefined\n  ) => (() => VNode) | undefined\n\n  /**\n   * 是否递归处理 children\n   * 默认：true\n   */\n  recursive?: boolean\n}\n\n// ====== 内置默认值 ======\n\nconst normalizePath = (path: string): string =>\n  path.startsWith('/') ? path : `/${path}`\n\nconst defaultGetKey = (route: RouteItem): string =>\n  route.path ? normalizePath(route.path) : ''\n\nconst defaultGetLabel = (route: RouteItem): string =>\n  route.meta?.title || route.name || ''\n\nconst defaultFilter = (route: RouteItem): boolean => !route.meta?.hidden\n\nconst defaultRenderIcon = (\n  icon: string | (() => VNode) | undefined\n): (() => VNode) | undefined => {\n  if (!icon) return undefined\n  if (typeof icon === 'string') {\n    return () =>\n      h('span', { class: 'inline-flex items-center n-icon' }, [\n        h(Icon, { icon }),\n      ])\n  }\n  if (typeof icon === 'function') return icon\n  return undefined\n}\n\n/**\n * 将路由数据转换为 NMenu 的 MenuOption[]\n *\n * 支持的输入格式：\n * 1. **Vue Router RouteRecordRaw** — 直接传 `router.getRoutes()` 或手写路由表\n * 2. **后端 JSON 路由表** — `{ path, meta: { title, icon }, children }`\n * 3. **自定义格式** — 通过 config 完全自定义 key/label/icon 的取值逻辑\n *\n * @param routes 路由数据数组\n * @param config 适配器配置\n * @returns NMenu 可直接使用的 MenuOption[]\n */\nexport function createMenuOptions(\n  routes: RouteItem[],\n  config: MenuAdapterConfig = {}\n): MenuOption[] {\n  const {\n    labelFormatter = (s: string) => s,\n    getKey = defaultGetKey,\n    getLabel = defaultGetLabel,\n    filter = defaultFilter,\n    renderIcon = defaultRenderIcon,\n    recursive = true,\n  } = config\n\n  const convert = (items: RouteItem[]): MenuOption[] => {\n    return items.filter(filter).map(item => {\n      const icon = item.meta?.icon || (item as any).icon\n      const children =\n        recursive && item.children?.length ? convert(item.children) : undefined\n\n      return {\n        key: getKey(item),\n        label: labelFormatter(getLabel(item)),\n        disabled: item.disabled || false,\n        icon: renderIcon(icon),\n        ...(item.type && { type: item.type }),\n        ...(children?.length && { children }),\n      }\n    }) as MenuOption[]\n  }\n\n  return convert(routes)\n}\n\n/**\n * 将路由树扁平化为一维数组（常用于搜索、快捷导航）\n *\n * @param routes 路由数据数组\n * @param filter 过滤器（默认排除 hidden）\n * @returns 扁平化后的路由数组\n */\nexport function flattenRoutes(\n  routes: RouteItem[],\n  filter: (route: RouteItem) => boolean = defaultFilter\n): RouteItem[] {\n  const result: RouteItem[] = []\n  const walk = (items: RouteItem[]) => {\n    for (const item of items) {\n      if (filter(item)) {\n        result.push(item)\n      }\n      if (item.children?.length) {\n        walk(item.children)\n      }\n    }\n  }\n  walk(routes)\n  return result\n}\n"],"mappings":"4DAiFA,MAAM,EAAiB,GACrB,EAAK,WAAW,IAAI,CAAG,EAAO,IAAI,IAE9B,EAAiB,GACrB,EAAM,KAAO,EAAc,EAAM,KAAK,CAAG,GAErC,EAAmB,GACvB,EAAM,MAAM,OAAS,EAAM,MAAQ,GAE/B,EAAiB,GAA8B,CAAC,EAAM,MAAM,OAE5D,EACJ,GAC8B,CACzB,KACL,IAAI,OAAO,GAAS,SAClB,UACE,EAAE,OAAQ,CAAE,MAAO,kCAAmC,CAAE,CACtD,EAAE,EAAM,CAAE,OAAM,CAAC,CAClB,CAAC,CAEN,GAAI,OAAO,GAAS,WAAY,OAAO,IAgBzC,SAAgB,EACd,EACA,EAA4B,EAAE,CAChB,CACd,GAAM,CACJ,iBAAkB,GAAc,EAChC,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,IACV,EAEE,EAAW,GACR,EAAM,OAAO,EAAO,CAAC,IAAI,GAAQ,CACtC,IAAM,EAAO,EAAK,MAAM,MAAS,EAAa,KACxC,EACJ,GAAa,EAAK,UAAU,OAAS,EAAQ,EAAK,SAAS,CAAG,IAAA,GAEhE,MAAO,CACL,IAAK,EAAO,EAAK,CACjB,MAAO,EAAe,EAAS,EAAK,CAAC,CACrC,SAAU,EAAK,UAAY,GAC3B,KAAM,EAAW,EAAK,CACtB,GAAI,EAAK,MAAQ,CAAE,KAAM,EAAK,KAAM,CACpC,GAAI,GAAU,QAAU,CAAE,WAAU,CACrC,EACD,CAGJ,OAAO,EAAQ,EAAO,CAUxB,SAAgB,EACd,EACA,EAAwC,EAC3B,CACb,IAAM,EAAsB,EAAE,CACxB,EAAQ,GAAuB,CACnC,IAAK,IAAM,KAAQ,EACb,EAAO,EAAK,EACd,EAAO,KAAK,EAAK,CAEf,EAAK,UAAU,QACjB,EAAK,EAAK,SAAS,EAKzB,OADA,EAAK,EAAO,CACL"}

package/dist/resolver.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`@robot-admin/naive-ui-components`,t=`C_ActionBar.C_AntV.C_Barcode.C_Captcha.C_Cascade.C_City.C_Code.C_CollapsePanel.C_Cron.C_Date.C_Draggable.C_Editor.C_FilePreview.C_Form.C_FormSearch.C_FormulaEditor.C_FullCalendar.C_GlobalSearch.C_Guide.C_Icon.C_ImageCropper.C_Language.C_Map.C_Markdown.C_NotificationCenter.C_Progress.C_QRCode.C_Signature.C_SplitPane.C_Steps.C_Table.C_Theme.C_Time.C_Tree.C_Upload.C_VideoPlayer.C_VtableGantt.C_WaterFall.C_WorkFlow`.split(`.`),n=new Set(t);function r(t={}){let{importOnDemand:r=!1}=t;return{type:`component`,resolve:t=>{if(n.has(t))return{name:t,from:r?`${e}/${t}`:e}}}}exports.RobotNaiveUiResolver=r,exports.componentNames=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`@robot-admin/naive-ui-components`,t=`C_ActionBar.C_AntV.C_Barcode.C_Breadcrumb.C_Captcha.C_Cascade.C_City.C_Code.C_CollapsePanel.C_Cron.C_Date.C_Draggable.C_Editor.C_FilePreview.C_Form.C_FormSearch.C_FormulaEditor.C_FullCalendar.C_GlobalSearch.C_Guide.C_Icon.C_ImageCropper.C_Language.C_Map.C_Markdown.C_Menu.C_NotificationCenter.C_Progress.C_QRCode.C_Signature.C_SplitPane.C_Steps.C_Table.C_TagsView.C_Theme.C_Time.C_Tree.C_Upload.C_VideoPlayer.C_VtableGantt.C_WaterFall.C_WorkFlow`.split(`.`),n=new Set(t);function r(t={}){let{importOnDemand:r=!1,importStyle:i=!1}=t;return{type:`component`,resolve:t=>{if(n.has(t))return{name:t,from:r?`${e}/${t}`:e,sideEffects:r&&i?`${e}/${t}/style.css`:void 0}}}}exports.RobotNaiveUiResolver=r,exports.componentNames=t;
 //# sourceMappingURL=resolver.cjs.map

package/dist/resolver.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.cjs","names":[],"sources":["../src/resolver.ts"],"sourcesContent":["/**\n * @robot-admin/naive-ui-components Resolver\n * 用于 unplugin-vue-components 的自动导入解析器\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import Components from 'unplugin-vue-components/vite'\n * import { RobotNaiveUiResolver } from '@robot-admin/naive-ui-components/resolver'\n *\n * export default defineConfig({\n *   plugins: [\n *     Components({\n *       resolvers: [RobotNaiveUiResolver()]\n *     })\n *   ]\n * })\n * ```\n */\n\nconst PKG_NAME = '@robot-admin/naive-ui-components'\n\n/** 组件库包含的所有组件名称 */\nexport const componentNames = [\n  'C_ActionBar',\n  'C_AntV',\n  'C_Barcode',\n  'C_Captcha',\n  'C_Cascade',\n  'C_City',\n  'C_Code',\n  'C_CollapsePanel',\n  'C_Cron',\n  'C_Date',\n  'C_Draggable',\n  'C_Editor',\n  'C_FilePreview',\n  'C_Form',\n  'C_FormSearch',\n  'C_FormulaEditor',\n  'C_FullCalendar',\n  'C_GlobalSearch',\n  'C_Guide',\n  'C_Icon',\n  'C_ImageCropper',\n  'C_Language',\n  'C_Map',\n  'C_Markdown',\n  'C_NotificationCenter',\n  'C_Progress',\n  'C_QRCode',\n  'C_Signature',\n  'C_SplitPane',\n  'C_Steps',\n  'C_Table',\n  'C_Theme',\n  'C_Time',\n  'C_Tree',\n  'C_Upload',\n  'C_VideoPlayer',\n  'C_VtableGantt',\n  'C_WaterFall',\n  'C_WorkFlow',\n] as const\n\n/** 组件名称类型 */\nexport type ComponentName = (typeof componentNames)[number]\n\n/** 组件名称集合（快速查找） */\nconst componentSet = new Set<string>(componentNames)\n\nexport interface RobotNaiveUiResolverOptions {\n  /**\n   * 按需导入：从子路径解析单个组件，减少打包体积\n   * - false (默认): `import { C_Form } from '@robot-admin/naive-ui-components'`\n   * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`\n   */\n  importOnDemand?: boolean\n}\n\n/**\n * @robot-admin/naive-ui-components 组件自动导入解析器\n *\n * 匹配组件库中所有 C_ 前缀的组件，自动解析导入路径。\n * 类似于 NaiveUiResolver、ElementPlusResolver 等成熟解析器的设计。\n */\nexport function RobotNaiveUiResolver(\n  options: RobotNaiveUiResolverOptions = {}\n) {\n  const { importOnDemand = false } = options\n\n  return {\n    type: 'component' as const,\n    resolve: (name: string) => {\n      if (componentSet.has(name)) {\n        return {\n          name,\n          from: importOnDemand ? `${PKG_NAME}/${name}` : PKG_NAME,\n        }\n      }\n    },\n  }\n}\n"],"mappings":"mEAoBA,MAAM,EAAW,mCAGJ,EAAiB,2aAwC7B,CAMK,EAAe,IAAI,IAAY,EAAe,CAiBpD,SAAgB,EACd,EAAuC,EAAE,CACzC,CACA,GAAM,CAAE,iBAAiB,IAAU,EAEnC,MAAO,CACL,KAAM,YACN,QAAU,GAAiB,CACzB,GAAI,EAAa,IAAI,EAAK,CACxB,MAAO,CACL,OACA,KAAM,EAAiB,GAAG,EAAS,GAAG,IAAS,EAChD,EAGN"}
+{"version":3,"file":"resolver.cjs","names":[],"sources":["../src/resolver.ts"],"sourcesContent":["/**\n * @robot-admin/naive-ui-components Resolver\n * 用于 unplugin-vue-components 的自动导入解析器\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import Components from 'unplugin-vue-components/vite'\n * import { RobotNaiveUiResolver } from '@robot-admin/naive-ui-components/resolver'\n *\n * export default defineConfig({\n *   plugins: [\n *     Components({\n *       resolvers: [RobotNaiveUiResolver()]\n *     })\n *   ]\n * })\n * ```\n */\n\nconst PKG_NAME = '@robot-admin/naive-ui-components'\n\n/** 组件库包含的所有组件名称 */\nexport const componentNames = [\n  'C_ActionBar',\n  'C_AntV',\n  'C_Barcode',\n  'C_Breadcrumb',\n  'C_Captcha',\n  'C_Cascade',\n  'C_City',\n  'C_Code',\n  'C_CollapsePanel',\n  'C_Cron',\n  'C_Date',\n  'C_Draggable',\n  'C_Editor',\n  'C_FilePreview',\n  'C_Form',\n  'C_FormSearch',\n  'C_FormulaEditor',\n  'C_FullCalendar',\n  'C_GlobalSearch',\n  'C_Guide',\n  'C_Icon',\n  'C_ImageCropper',\n  'C_Language',\n  'C_Map',\n  'C_Markdown',\n  'C_Menu',\n  'C_NotificationCenter',\n  'C_Progress',\n  'C_QRCode',\n  'C_Signature',\n  'C_SplitPane',\n  'C_Steps',\n  'C_Table',\n  'C_TagsView',\n  'C_Theme',\n  'C_Time',\n  'C_Tree',\n  'C_Upload',\n  'C_VideoPlayer',\n  'C_VtableGantt',\n  'C_WaterFall',\n  'C_WorkFlow',\n] as const\n\n/** 组件名称类型 */\nexport type ComponentName = (typeof componentNames)[number]\n\n/** 组件名称集合（快速查找） */\nconst componentSet = new Set<string>(componentNames)\n\nexport interface RobotNaiveUiResolverOptions {\n  /**\n   * 按需导入：从子路径解析单个组件，减少打包体积\n   * - false (默认): `import { C_Form } from '@robot-admin/naive-ui-components'`\n   * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`\n   */\n  importOnDemand?: boolean\n  /**\n   * 按需导入组件样式（仅在 importOnDemand 为 true 时生效）\n   * - false (默认): 需手动导入 style.css 全量样式\n   * - true: 自动导入对应组件的独立样式 `@robot-admin/naive-ui-components/C_Form/style.css`\n   */\n  importStyle?: boolean\n}\n\n/**\n * @robot-admin/naive-ui-components 组件自动导入解析器\n *\n * 匹配组件库中所有 C_ 前缀的组件，自动解析导入路径。\n * 类似于 NaiveUiResolver、ElementPlusResolver 等成熟解析器的设计。\n */\nexport function RobotNaiveUiResolver(\n  options: RobotNaiveUiResolverOptions = {}\n) {\n  const { importOnDemand = false, importStyle = false } = options\n\n  return {\n    type: 'component' as const,\n    resolve: (name: string) => {\n      if (componentSet.has(name)) {\n        const from = importOnDemand ? `${PKG_NAME}/${name}` : PKG_NAME\n        const sideEffects =\n          importOnDemand && importStyle\n            ? `${PKG_NAME}/${name}/style.css`\n            : undefined\n        return {\n          name,\n          from,\n          sideEffects,\n        }\n      }\n    },\n  }\n}\n"],"mappings":"mEAoBA,MAAM,EAAW,mCAGJ,EAAiB,0cA2C7B,CAMK,EAAe,IAAI,IAAY,EAAe,CAuBpD,SAAgB,EACd,EAAuC,EAAE,CACzC,CACA,GAAM,CAAE,iBAAiB,GAAO,cAAc,IAAU,EAExD,MAAO,CACL,KAAM,YACN,QAAU,GAAiB,CACzB,GAAI,EAAa,IAAI,EAAK,CAMxB,MAAO,CACL,OACA,KAPW,EAAiB,GAAG,EAAS,GAAG,IAAS,EAQpD,YANA,GAAkB,EACd,GAAG,EAAS,GAAG,EAAK,YACpB,IAAA,GAKL,EAGN"}

package/dist/resolver.d.cts

@@ -19,7 +19,7 @@
  * ```
  */
 /** 组件库包含的所有组件名称 */
-declare const componentNames: readonly ["C_ActionBar", "C_AntV", "C_Barcode", "C_Captcha", "C_Cascade", "C_City", "C_Code", "C_CollapsePanel", "C_Cron", "C_Date", "C_Draggable", "C_Editor", "C_FilePreview", "C_Form", "C_FormSearch", "C_FormulaEditor", "C_FullCalendar", "C_GlobalSearch", "C_Guide", "C_Icon", "C_ImageCropper", "C_Language", "C_Map", "C_Markdown", "C_NotificationCenter", "C_Progress", "C_QRCode", "C_Signature", "C_SplitPane", "C_Steps", "C_Table", "C_Theme", "C_Time", "C_Tree", "C_Upload", "C_VideoPlayer", "C_VtableGantt", "C_WaterFall", "C_WorkFlow"];
+declare const componentNames: readonly ["C_ActionBar", "C_AntV", "C_Barcode", "C_Breadcrumb", "C_Captcha", "C_Cascade", "C_City", "C_Code", "C_CollapsePanel", "C_Cron", "C_Date", "C_Draggable", "C_Editor", "C_FilePreview", "C_Form", "C_FormSearch", "C_FormulaEditor", "C_FullCalendar", "C_GlobalSearch", "C_Guide", "C_Icon", "C_ImageCropper", "C_Language", "C_Map", "C_Markdown", "C_Menu", "C_NotificationCenter", "C_Progress", "C_QRCode", "C_Signature", "C_SplitPane", "C_Steps", "C_Table", "C_TagsView", "C_Theme", "C_Time", "C_Tree", "C_Upload", "C_VideoPlayer", "C_VtableGantt", "C_WaterFall", "C_WorkFlow"];
 /** 组件名称类型 */
 type ComponentName = (typeof componentNames)[number];
 interface RobotNaiveUiResolverOptions {
@@ -29,6 +29,12 @@ interface RobotNaiveUiResolverOptions {
    * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`
    */
   importOnDemand?: boolean;
+  /**
+   * 按需导入组件样式（仅在 importOnDemand 为 true 时生效）
+   * - false (默认): 需手动导入 style.css 全量样式
+   * - true: 自动导入对应组件的独立样式 `@robot-admin/naive-ui-components/C_Form/style.css`
+   */
+  importStyle?: boolean;
 }
 /**
  * @robot-admin/naive-ui-components 组件自动导入解析器
@@ -41,6 +47,7 @@ declare function RobotNaiveUiResolver(options?: RobotNaiveUiResolverOptions): {
   resolve: (name: string) => {
     name: string;
     from: string;
+    sideEffects: string | undefined;
   } | undefined;
 };
 //#endregion

package/dist/resolver.d.ts

@@ -19,7 +19,7 @@
  * ```
  */
 /** 组件库包含的所有组件名称 */
-declare const componentNames: readonly ["C_ActionBar", "C_AntV", "C_Barcode", "C_Captcha", "C_Cascade", "C_City", "C_Code", "C_CollapsePanel", "C_Cron", "C_Date", "C_Draggable", "C_Editor", "C_FilePreview", "C_Form", "C_FormSearch", "C_FormulaEditor", "C_FullCalendar", "C_GlobalSearch", "C_Guide", "C_Icon", "C_ImageCropper", "C_Language", "C_Map", "C_Markdown", "C_NotificationCenter", "C_Progress", "C_QRCode", "C_Signature", "C_SplitPane", "C_Steps", "C_Table", "C_Theme", "C_Time", "C_Tree", "C_Upload", "C_VideoPlayer", "C_VtableGantt", "C_WaterFall", "C_WorkFlow"];
+declare const componentNames: readonly ["C_ActionBar", "C_AntV", "C_Barcode", "C_Breadcrumb", "C_Captcha", "C_Cascade", "C_City", "C_Code", "C_CollapsePanel", "C_Cron", "C_Date", "C_Draggable", "C_Editor", "C_FilePreview", "C_Form", "C_FormSearch", "C_FormulaEditor", "C_FullCalendar", "C_GlobalSearch", "C_Guide", "C_Icon", "C_ImageCropper", "C_Language", "C_Map", "C_Markdown", "C_Menu", "C_NotificationCenter", "C_Progress", "C_QRCode", "C_Signature", "C_SplitPane", "C_Steps", "C_Table", "C_TagsView", "C_Theme", "C_Time", "C_Tree", "C_Upload", "C_VideoPlayer", "C_VtableGantt", "C_WaterFall", "C_WorkFlow"];
 /** 组件名称类型 */
 type ComponentName = (typeof componentNames)[number];
 interface RobotNaiveUiResolverOptions {
@@ -29,6 +29,12 @@ interface RobotNaiveUiResolverOptions {
    * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`
    */
   importOnDemand?: boolean;
+  /**
+   * 按需导入组件样式（仅在 importOnDemand 为 true 时生效）
+   * - false (默认): 需手动导入 style.css 全量样式
+   * - true: 自动导入对应组件的独立样式 `@robot-admin/naive-ui-components/C_Form/style.css`
+   */
+  importStyle?: boolean;
 }
 /**
  * @robot-admin/naive-ui-components 组件自动导入解析器
@@ -41,6 +47,7 @@ declare function RobotNaiveUiResolver(options?: RobotNaiveUiResolverOptions): {
   resolve: (name: string) => {
     name: string;
     from: string;
+    sideEffects: string | undefined;
   } | undefined;
 };
 //#endregion

package/dist/resolver.js

@@ -1,2 +1,2 @@
-const e=`@robot-admin/naive-ui-components`,t=`C_ActionBar.C_AntV.C_Barcode.C_Captcha.C_Cascade.C_City.C_Code.C_CollapsePanel.C_Cron.C_Date.C_Draggable.C_Editor.C_FilePreview.C_Form.C_FormSearch.C_FormulaEditor.C_FullCalendar.C_GlobalSearch.C_Guide.C_Icon.C_ImageCropper.C_Language.C_Map.C_Markdown.C_NotificationCenter.C_Progress.C_QRCode.C_Signature.C_SplitPane.C_Steps.C_Table.C_Theme.C_Time.C_Tree.C_Upload.C_VideoPlayer.C_VtableGantt.C_WaterFall.C_WorkFlow`.split(`.`),n=new Set(t);function r(t={}){let{importOnDemand:r=!1}=t;return{type:`component`,resolve:t=>{if(n.has(t))return{name:t,from:r?`${e}/${t}`:e}}}}export{r as RobotNaiveUiResolver,t as componentNames};
+const e=`@robot-admin/naive-ui-components`,t=`C_ActionBar.C_AntV.C_Barcode.C_Breadcrumb.C_Captcha.C_Cascade.C_City.C_Code.C_CollapsePanel.C_Cron.C_Date.C_Draggable.C_Editor.C_FilePreview.C_Form.C_FormSearch.C_FormulaEditor.C_FullCalendar.C_GlobalSearch.C_Guide.C_Icon.C_ImageCropper.C_Language.C_Map.C_Markdown.C_Menu.C_NotificationCenter.C_Progress.C_QRCode.C_Signature.C_SplitPane.C_Steps.C_Table.C_TagsView.C_Theme.C_Time.C_Tree.C_Upload.C_VideoPlayer.C_VtableGantt.C_WaterFall.C_WorkFlow`.split(`.`),n=new Set(t);function r(t={}){let{importOnDemand:r=!1,importStyle:i=!1}=t;return{type:`component`,resolve:t=>{if(n.has(t))return{name:t,from:r?`${e}/${t}`:e,sideEffects:r&&i?`${e}/${t}/style.css`:void 0}}}}export{r as RobotNaiveUiResolver,t as componentNames};
 //# sourceMappingURL=resolver.js.map

package/dist/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","names":[],"sources":["../src/resolver.ts"],"sourcesContent":["/**\n * @robot-admin/naive-ui-components Resolver\n * 用于 unplugin-vue-components 的自动导入解析器\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import Components from 'unplugin-vue-components/vite'\n * import { RobotNaiveUiResolver } from '@robot-admin/naive-ui-components/resolver'\n *\n * export default defineConfig({\n *   plugins: [\n *     Components({\n *       resolvers: [RobotNaiveUiResolver()]\n *     })\n *   ]\n * })\n * ```\n */\n\nconst PKG_NAME = '@robot-admin/naive-ui-components'\n\n/** 组件库包含的所有组件名称 */\nexport const componentNames = [\n  'C_ActionBar',\n  'C_AntV',\n  'C_Barcode',\n  'C_Captcha',\n  'C_Cascade',\n  'C_City',\n  'C_Code',\n  'C_CollapsePanel',\n  'C_Cron',\n  'C_Date',\n  'C_Draggable',\n  'C_Editor',\n  'C_FilePreview',\n  'C_Form',\n  'C_FormSearch',\n  'C_FormulaEditor',\n  'C_FullCalendar',\n  'C_GlobalSearch',\n  'C_Guide',\n  'C_Icon',\n  'C_ImageCropper',\n  'C_Language',\n  'C_Map',\n  'C_Markdown',\n  'C_NotificationCenter',\n  'C_Progress',\n  'C_QRCode',\n  'C_Signature',\n  'C_SplitPane',\n  'C_Steps',\n  'C_Table',\n  'C_Theme',\n  'C_Time',\n  'C_Tree',\n  'C_Upload',\n  'C_VideoPlayer',\n  'C_VtableGantt',\n  'C_WaterFall',\n  'C_WorkFlow',\n] as const\n\n/** 组件名称类型 */\nexport type ComponentName = (typeof componentNames)[number]\n\n/** 组件名称集合（快速查找） */\nconst componentSet = new Set<string>(componentNames)\n\nexport interface RobotNaiveUiResolverOptions {\n  /**\n   * 按需导入：从子路径解析单个组件，减少打包体积\n   * - false (默认): `import { C_Form } from '@robot-admin/naive-ui-components'`\n   * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`\n   */\n  importOnDemand?: boolean\n}\n\n/**\n * @robot-admin/naive-ui-components 组件自动导入解析器\n *\n * 匹配组件库中所有 C_ 前缀的组件，自动解析导入路径。\n * 类似于 NaiveUiResolver、ElementPlusResolver 等成熟解析器的设计。\n */\nexport function RobotNaiveUiResolver(\n  options: RobotNaiveUiResolverOptions = {}\n) {\n  const { importOnDemand = false } = options\n\n  return {\n    type: 'component' as const,\n    resolve: (name: string) => {\n      if (componentSet.has(name)) {\n        return {\n          name,\n          from: importOnDemand ? `${PKG_NAME}/${name}` : PKG_NAME,\n        }\n      }\n    },\n  }\n}\n"],"mappings":"AAoBA,MAAM,EAAW,mCAGJ,EAAiB,2aAwC7B,CAMK,EAAe,IAAI,IAAY,EAAe,CAiBpD,SAAgB,EACd,EAAuC,EAAE,CACzC,CACA,GAAM,CAAE,iBAAiB,IAAU,EAEnC,MAAO,CACL,KAAM,YACN,QAAU,GAAiB,CACzB,GAAI,EAAa,IAAI,EAAK,CACxB,MAAO,CACL,OACA,KAAM,EAAiB,GAAG,EAAS,GAAG,IAAS,EAChD,EAGN"}
+{"version":3,"file":"resolver.js","names":[],"sources":["../src/resolver.ts"],"sourcesContent":["/**\n * @robot-admin/naive-ui-components Resolver\n * 用于 unplugin-vue-components 的自动导入解析器\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import Components from 'unplugin-vue-components/vite'\n * import { RobotNaiveUiResolver } from '@robot-admin/naive-ui-components/resolver'\n *\n * export default defineConfig({\n *   plugins: [\n *     Components({\n *       resolvers: [RobotNaiveUiResolver()]\n *     })\n *   ]\n * })\n * ```\n */\n\nconst PKG_NAME = '@robot-admin/naive-ui-components'\n\n/** 组件库包含的所有组件名称 */\nexport const componentNames = [\n  'C_ActionBar',\n  'C_AntV',\n  'C_Barcode',\n  'C_Breadcrumb',\n  'C_Captcha',\n  'C_Cascade',\n  'C_City',\n  'C_Code',\n  'C_CollapsePanel',\n  'C_Cron',\n  'C_Date',\n  'C_Draggable',\n  'C_Editor',\n  'C_FilePreview',\n  'C_Form',\n  'C_FormSearch',\n  'C_FormulaEditor',\n  'C_FullCalendar',\n  'C_GlobalSearch',\n  'C_Guide',\n  'C_Icon',\n  'C_ImageCropper',\n  'C_Language',\n  'C_Map',\n  'C_Markdown',\n  'C_Menu',\n  'C_NotificationCenter',\n  'C_Progress',\n  'C_QRCode',\n  'C_Signature',\n  'C_SplitPane',\n  'C_Steps',\n  'C_Table',\n  'C_TagsView',\n  'C_Theme',\n  'C_Time',\n  'C_Tree',\n  'C_Upload',\n  'C_VideoPlayer',\n  'C_VtableGantt',\n  'C_WaterFall',\n  'C_WorkFlow',\n] as const\n\n/** 组件名称类型 */\nexport type ComponentName = (typeof componentNames)[number]\n\n/** 组件名称集合（快速查找） */\nconst componentSet = new Set<string>(componentNames)\n\nexport interface RobotNaiveUiResolverOptions {\n  /**\n   * 按需导入：从子路径解析单个组件，减少打包体积\n   * - false (默认): `import { C_Form } from '@robot-admin/naive-ui-components'`\n   * - true: `import { C_Form } from '@robot-admin/naive-ui-components/C_Form'`\n   */\n  importOnDemand?: boolean\n  /**\n   * 按需导入组件样式（仅在 importOnDemand 为 true 时生效）\n   * - false (默认): 需手动导入 style.css 全量样式\n   * - true: 自动导入对应组件的独立样式 `@robot-admin/naive-ui-components/C_Form/style.css`\n   */\n  importStyle?: boolean\n}\n\n/**\n * @robot-admin/naive-ui-components 组件自动导入解析器\n *\n * 匹配组件库中所有 C_ 前缀的组件，自动解析导入路径。\n * 类似于 NaiveUiResolver、ElementPlusResolver 等成熟解析器的设计。\n */\nexport function RobotNaiveUiResolver(\n  options: RobotNaiveUiResolverOptions = {}\n) {\n  const { importOnDemand = false, importStyle = false } = options\n\n  return {\n    type: 'component' as const,\n    resolve: (name: string) => {\n      if (componentSet.has(name)) {\n        const from = importOnDemand ? `${PKG_NAME}/${name}` : PKG_NAME\n        const sideEffects =\n          importOnDemand && importStyle\n            ? `${PKG_NAME}/${name}/style.css`\n            : undefined\n        return {\n          name,\n          from,\n          sideEffects,\n        }\n      }\n    },\n  }\n}\n"],"mappings":"AAoBA,MAAM,EAAW,mCAGJ,EAAiB,0cA2C7B,CAMK,EAAe,IAAI,IAAY,EAAe,CAuBpD,SAAgB,EACd,EAAuC,EAAE,CACzC,CACA,GAAM,CAAE,iBAAiB,GAAO,cAAc,IAAU,EAExD,MAAO,CACL,KAAM,YACN,QAAU,GAAiB,CACzB,GAAI,EAAa,IAAI,EAAK,CAMxB,MAAO,CACL,OACA,KAPW,EAAiB,GAAG,EAAS,GAAG,IAAS,EAQpD,YANA,GAAkB,EACd,GAAG,EAAS,GAAG,EAAK,YACpB,IAAA,GAKL,EAGN"}