@cyberpunk-vue/components 1.9.7 → 1.9.9

package/dist/menu/src/menu.d.ts

@@ -26,8 +26,11 @@ export type MenuVariant = 'solid' | 'outline' | 'note';
  * CpMenu 组件 Props 定义
  *
  * @description 赛博朋克风格导航菜单，支持水平/垂直模式、折叠、多色彩类型。
+ * 内置路由前缀匹配：当 `defaultActive` 为 `/model-specs/xxx` 时，
+ * 会自动匹配 `index="/model-specs"` 的菜单项并高亮其父级 SubMenu。
+ * 页面刷新或路由变化时，对应的子菜单会自动展开。
  *
- * @example
+ * @example 基础用法
  * ```vue
  * <CpMenu default-active="1">
  *   <CpMenuItem index="1">菜单项一</CpMenuItem>
@@ -37,9 +40,48 @@ export type MenuVariant = 'solid' | 'outline' | 'note';
  *   </CpSubMenu>
  * </CpMenu>
  * ```
-  * @category 导航组件
+ *
+ * @example 配合 vue-router（推荐：defaultActive + @select）
+ * ```vue
+ * <script setup>
+ * import { computed } from 'vue'
+ * import { useRouter, useRoute } from 'vue-router'
+ *
+ * const router = useRouter()
+ * const route = useRoute()
+ *
+ * // 绑定 route.path 实现路由同步，支持子路由前缀匹配：
+ * // 访问 /model-specs/xxx 会自动匹配 index="/model-specs" 并高亮父级 SubMenu
+ * const activeMenu = computed(() => route.path)
+ *
+ * function handleMenuSelect(index: string) {
+ *   router.push(index)
+ * }
+ * </script>
+ *
+ * <template>
+ *   <CpMenu :default-active="activeMenu" @select="handleMenuSelect">
+ *     <CpMenuItem index="/dashboard">仪表盘</CpMenuItem>
+ *     <CpSubMenu index="ai-group">
+ *       <template #title>AI Provider</template>
+ *       <CpMenuItem index="/providers">Provider 管理</CpMenuItem>
+ *       <CpMenuItem index="/model-specs">模型规格</CpMenuItem>
+ *     </CpSubMenu>
+ *   </CpMenu>
+ * </template>
+ * ```
+ *
+ * @example 内置 router 模式（自动调用 router.push）
+ * ```vue
+ * <!-- router 模式下点击菜单项自动导航，无需手动处理 @select -->
+ * <CpMenu :router="true" :default-active="route.path">
+ *   <CpMenuItem index="/dashboard">仪表盘</CpMenuItem>
+ *   <CpMenuItem index="/settings">设置</CpMenuItem>
+ * </CpMenu>
+ * ```
+ * @category 导航组件
  * @displayName CpMenu 菜单
-  * @slots default - 菜单内容（CpMenuItem / CpSubMenu 等组合）
+ * @slots default - 菜单内容（CpMenuItem / CpSubMenu 等组合）
  */
 export declare const menuProps: {
     /**
@@ -73,7 +115,10 @@ export declare const menuProps: {
         readonly default: "solid";
     };
     /**
-     * 默认激活的菜单项 index
+     * 默认激活的菜单项 index。
+     * 支持前缀匹配：传入 `/model-specs/xxx` 会自动匹配 `index="/model-specs"` 的菜单项，
+     * 并高亮其所有父级 SubMenu、自动展开对应子菜单目录。
+     * 常见用法：绑定 `route.path` 实现路由同步。
      * @default ''
      */
     readonly defaultActive: {
@@ -121,7 +166,10 @@ export declare const menuProps: {
         readonly default: "";
     };
     /**
-     * 是否启用 vue-router 模式
+     * 是否启用 vue-router 模式。
+     * 开启后点击 CpMenuItem 会自动调用 `router.push(index)`，
+     * 并监听路由变化自动同步激活状态。
+     * 不开启时也可通过 `:default-active="route.path"` + `@select` 实现等效效果。
      * @default false
      */
     readonly router: {

package/dist/menu/src/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../menu/src/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAEvF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;uBAEe,QAAQ,CAAC,QAAQ,CAAC;;;IAGpC;;;;;;OAMG;;uBAEe,QAAQ,CAAC,SAAS,CAAC;;;IAGrC;;;;;;OAMG;;uBAEe,QAAQ,CAAC,WAAW,CAAC;;;IAGvC;;;OAGG;;;;;IAKH;;;OAGG;;uBAEc,QAAQ,CAAC,MAAM,EAAE,CAAC;;;IAGnC;;;OAGG;;;;;IAKH;;;OAGG;;;;;IAKH;;;OAGG;;uBAEe,QAAQ,CAAC,QAAQ,CAAC;;;IAGpC;;;OAGG;;;;;IAKH;;;OAGG;;;;;CAKK,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,SAAS,CAAC,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,aAAa;oBACG,MAAM,aAAa,MAAM,EAAE;IAE3C,YAAY;kBACE,MAAM,aAAa,MAAM,EAAE;IAEzC,YAAY;mBACG,MAAM,aAAa,MAAM,EAAE;CAE3C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAA"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../menu/src/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAEvF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;uBAEe,QAAQ,CAAC,QAAQ,CAAC;;;IAGpC;;;;;;OAMG;;uBAEe,QAAQ,CAAC,SAAS,CAAC;;;IAGrC;;;;;;OAMG;;uBAEe,QAAQ,CAAC,WAAW,CAAC;;;IAGvC;;;;;;OAMG;;;;;IAKH;;;OAGG;;uBAEc,QAAQ,CAAC,MAAM,EAAE,CAAC;;;IAGnC;;;OAGG;;;;;IAKH;;;OAGG;;;;;IAKH;;;OAGG;;uBAEe,QAAQ,CAAC,QAAQ,CAAC;;;IAGpC;;;OAGG;;;;;IAKH;;;;;;OAMG;;;;;CAKK,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,SAAS,CAAC,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,aAAa;oBACG,MAAM,aAAa,MAAM,EAAE;IAE3C,YAAY;kBACE,MAAM,aAAa,MAAM,EAAE;IAEzC,YAAY;mBACG,MAAM,aAAa,MAAM,EAAE;CAE3C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAA"}

package/dist/menu/src/menu.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.vue.d.ts","sourceRoot":"","sources":["../../../menu/src/menu.vue"],"names":[],"mappings":"AA+ZA,iBAAS,cAAc;WAyBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAWD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yFAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"menu.vue.d.ts","sourceRoot":"","sources":["../../../menu/src/menu.vue"],"names":[],"mappings":"AA2ZA,iBAAS,cAAc;WAyBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AAWD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yFAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberpunk-vue/components",
-  "version": "1.9.7",
+  "version": "1.9.9",
   "description": "Cyberpunk Vue components - A futuristic Vue 3 component library",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,9 +23,9 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@cyberpunk-vue/hooks": "1.9.7",
-    "@cyberpunk-vue/theme-chalk": "1.9.7",
-    "@cyberpunk-vue/constants": "1.9.7"
+    "@cyberpunk-vue/hooks": "1.9.9",
+    "@cyberpunk-vue/constants": "1.9.9",
+    "@cyberpunk-vue/theme-chalk": "1.9.9"
   },
   "author": "Juxest",
   "license": "MIT",