route-ui-sync 0.1.0 → 0.1.2

package/README.md

@@ -9,10 +9,11 @@
 ## 特性
 
 - 🎯 **框架无关**：不依赖 React、Vue 或任何路由库
-- 🚀 **轻量级**：零依赖，体积小
+- 🚀 **极轻量级**：零依赖，压缩后仅 ~314 字节（ES 模块）或 ~321 字节（CommonJS）
 - 🔧 **类型安全**：完整的 TypeScript 类型定义
 - ✅ **测试覆盖**：完整的单元测试
 - 📦 **多格式支持**：同时支持 ES 模块和 CommonJS
+- ⚡ **高度优化**：使用 Terser 进行激进压缩，生产环境不包含 sourcemap
 
 ## 安装
 
@@ -319,15 +320,23 @@ npm run build
 
 ### 测试
 
+项目使用 Vitest 进行单元测试，包括源代码测试和打包后代码测试。
+
 ```bash
-# 运行测试
+# 运行源代码测试
 npm test
 
-# 监听模式
+# 监听模式运行测试
 npm run test:watch
 
-# 生成覆盖率报告
+# 运行测试并生成覆盖率报告
 npm run test:coverage
+
+# 测试打包后的代码（自动构建并测试）
+npm run test:bundle
+
+# 运行所有测试（源代码 + 打包后代码）
+npm run test:all
 ```
 
 ### 类型检查
@@ -338,9 +347,22 @@ npm run type-check
 
 ### 测试覆盖
 
-- **测试用例数**: 39 个
+项目包含完整的单元测试，覆盖了各种使用场景：
+
+- **测试用例数**: 39 个（源代码测试）+ 22 个（打包后代码测试）= **61 个测试用例**
 - **代码覆盖率**: 100%
 - **测试场景**: 包括基础功能、复杂场景、边界情况、实际项目场景等
+- **打包验证**: 自动测试打包后的 ES 模块和 CommonJS 模块功能
+
+**打包后代码测试说明：**
+
+`test:bundle` 命令会：
+1. 自动构建项目（`npm run build`）
+2. 测试打包后的 ES 模块（`dist/index.js`）
+3. 测试打包后的 CommonJS 模块（`dist/index.cjs`）
+4. 验证打包文件大小和完整性
+
+这确保了打包后的代码功能与源代码完全一致，验证了压缩和优化过程没有破坏功能。
 
 查看 [TEST_COVERAGE.md](./TEST_COVERAGE.md) 了解详细的测试覆盖情况。
 

package/dist/index.cjs

@@ -1,38 +1 @@
-'use strict';
-
-// 一个与 UI 框架无关的"小核心"，用于根据当前路由信息计算选中 key。
-/**
- * 根据当前路由信息和一组规则，计算"当前应该选中的 key"
- *
- * - 不依赖 React / react-router / 任何 UI 库
- * - 只关心最基础的 location 对象和规则数组
- * - 未来做成 npm 包时，只需要把这个函数原样搬过去即可
- */
-function getSelectedKeyFromLocation(location, rules) {
-    if (!location || !rules || rules.length === 0) {
-        return undefined;
-    }
-    const { pathname, search = "", hash = "" } = location;
-    const safeLocation = { pathname, search, hash };
-    // 找出所有命中的规则
-    const matched = rules.filter((rule) => {
-        try {
-            return rule.match(safeLocation);
-        }
-        catch {
-            // 某个规则内部异常时，忽略该规则，避免影响整体
-            return false;
-        }
-    });
-    if (matched.length === 0)
-        return undefined;
-    // 如果只有一个命中，直接返回
-    if (matched.length === 1)
-        return matched[0].key;
-    // 多个命中时，按 priority 从高到低排序，取第一个
-    matched.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
-    return matched[0].key;
-}
-
-exports.getSelectedKeyFromLocation = getSelectedKeyFromLocation;
-//# sourceMappingURL=index.cjs.map
+"use strict";exports.getSelectedKeyFromLocation=function(t,e){if(!t||!e||0===e.length)return;const{pathname:r,search:h="",hash:n=""}=t,a={pathname:r,search:h,hash:n},c=e.filter(t=>{try{return t.match(a)}catch{return!1}});return 0!==c.length?(1===c.length||c.sort((t,e)=>(e.priority??0)-(t.priority??0)),c[0].key):void 0};

package/dist/index.d.ts

@@ -4,27 +4,10 @@ type RouteMatchPredicate = (location: {
     hash?: string;
 }) => boolean;
 interface RouteSelectionRule {
-    /**
-     * 唯一 key，用于传给 UI 组件（例如 Menu.Item 的 key 或 className 中的一部分）
-     */
     key: string;
-    /**
-     * 匹配函数：根据当前 location 判断这个规则是否命中
-     */
     match: RouteMatchPredicate;
-    /**
-     * 优先级：数字越大优先级越高（可选）
-     * 当多个规则同时命中时，用它来决定最终选中哪个
-     */
     priority?: number;
 }
-/**
- * 根据当前路由信息和一组规则，计算"当前应该选中的 key"
- *
- * - 不依赖 React / react-router / 任何 UI 库
- * - 只关心最基础的 location 对象和规则数组
- * - 未来做成 npm 包时，只需要把这个函数原样搬过去即可
- */
 declare function getSelectedKeyFromLocation(location: {
     pathname: string;
     search?: string;

package/dist/index.js

@@ -1,36 +1 @@
-// 一个与 UI 框架无关的"小核心"，用于根据当前路由信息计算选中 key。
-/**
- * 根据当前路由信息和一组规则，计算"当前应该选中的 key"
- *
- * - 不依赖 React / react-router / 任何 UI 库
- * - 只关心最基础的 location 对象和规则数组
- * - 未来做成 npm 包时，只需要把这个函数原样搬过去即可
- */
-function getSelectedKeyFromLocation(location, rules) {
-    if (!location || !rules || rules.length === 0) {
-        return undefined;
-    }
-    const { pathname, search = "", hash = "" } = location;
-    const safeLocation = { pathname, search, hash };
-    // 找出所有命中的规则
-    const matched = rules.filter((rule) => {
-        try {
-            return rule.match(safeLocation);
-        }
-        catch {
-            // 某个规则内部异常时，忽略该规则，避免影响整体
-            return false;
-        }
-    });
-    if (matched.length === 0)
-        return undefined;
-    // 如果只有一个命中，直接返回
-    if (matched.length === 1)
-        return matched[0].key;
-    // 多个命中时，按 priority 从高到低排序，取第一个
-    matched.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
-    return matched[0].key;
-}
-
-export { getSelectedKeyFromLocation };
-//# sourceMappingURL=index.js.map
+function t(t,r){if(!t||!r||0===r.length)return;const{pathname:e,search:h="",hash:n=""}=t,a={pathname:e,search:h,hash:n},i=r.filter(t=>{try{return t.match(a)}catch{return!1}});return 0!==i.length?(1===i.length||i.sort((t,r)=>(r.priority??0)-(t.priority??0)),i[0].key):void 0}export{t as getSelectedKeyFromLocation};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "route-ui-sync",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A lightweight, framework-agnostic utility for automatically matching routes to menu keys. Zero dependencies, TypeScript support, for navigation menus.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -19,11 +19,14 @@
   ],
   "scripts": {
     "build": "rollup -c",
+    "build:prod": "rollup -c",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:bundle": "npm run build && vitest run src/index.bundle.test.ts",
+    "test:all": "npm run test && npm run test:bundle",
     "type-check": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm run test"
+    "prepublishOnly": "npm run build && npm run test:all"
   },
   "keywords": [
     "route",
@@ -37,6 +40,7 @@
   "license": "MIT",
   "devDependencies": {
     "@rollup/plugin-typescript": "^12.1.1",
+    "@rollup/plugin-terser": "^0.4.4",
     "@types/node": "^22.7.4",
     "@vitest/coverage-v8": "^4.0.15",
     "rollup": "^4.22.0",

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;AAwBA;;;;;;AAMG;AACG,SAAU,0BAA0B,CACxC,QAA8D,EAC9D,KAA2B,EAAA;AAE3B,IAAA,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7C,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,QAAQ;IACrD,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;;IAG/C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;AACpC,QAAA,IAAI;AACF,YAAA,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;QACjC;AAAE,QAAA,MAAM;;AAEN,YAAA,OAAO,KAAK;QACd;AACF,IAAA,CAAC,CAAC;AAEF,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,SAAS;;AAG1C,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;;IAG/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;AAC7D,IAAA,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;AACvB;;;;"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AAwBA;;;;;;AAMG;AACG,SAAU,0BAA0B,CACxC,QAA8D,EAC9D,KAA2B,EAAA;AAE3B,IAAA,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7C,QAAA,OAAO,SAAS;IAClB;AAEA,IAAA,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,QAAQ;IACrD,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;;IAG/C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;AACpC,QAAA,IAAI;AACF,YAAA,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;QACjC;AAAE,QAAA,MAAM;;AAEN,YAAA,OAAO,KAAK;QACd;AACF,IAAA,CAAC,CAAC;AAEF,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,SAAS;;AAG1C,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;;IAG/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;AAC7D,IAAA,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;AACvB;;;;"}