@kcuf/helper-data 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 0.6.0 2026/04/03 @驳是
+
+* FEAT 新增 `localSearchCompare`
+
 ## 0.5.0 2025/12/24 @驳是
 
 * FEAT 移除 `toTreeList`，请用 `@kcuf/helper-tree`

package/dist/cjs/helper/index.js

@@ -10,6 +10,12 @@ Object.defineProperty(exports, "isEmptyPagedList", {
     return _isEmptyPagedList.default;
   }
 });
+Object.defineProperty(exports, "localSearchCompare", {
+  enumerable: true,
+  get: function get() {
+    return _localSearchCompare.default;
+  }
+});
 Object.defineProperty(exports, "normalizeBoolean", {
   enumerable: true,
   get: function get() {
@@ -59,4 +65,5 @@ var _normalizeEnum = _interopRequireDefault(require("./normalize-enum"));
 var _normalizeTime = _interopRequireDefault(require("./normalize-time"));
 var _normalizePagedList = _interopRequireDefault(require("./normalize-paged-list"));
 var _normalizePagedListUncertain = _interopRequireDefault(require("./normalize-paged-list-uncertain"));
-var _isEmptyPagedList = _interopRequireDefault(require("./is-empty-paged-list"));
+var _isEmptyPagedList = _interopRequireDefault(require("./is-empty-paged-list"));
+var _localSearchCompare = _interopRequireDefault(require("./local-search-compare"));

package/dist/cjs/helper/local-search-compare.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = localSearchCompare;
+function normalizeStrForCompare(str, ignoreWhitespace) {
+  var strLower = str.trim().toLowerCase();
+  return strLower.replace(/\s+/g, ignoreWhitespace ? '' : ' ');
+}
+
+/**
+ * 本地搜索时的比较方法，使用 keyword 匹配可选的字符串数组，注意当 keyword 为空时，返回 true
+ */
+function localSearchCompare(keyword, candidateValues) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var _options$ignoreWhites = options.ignoreWhitespace,
+    ignoreWhitespace = _options$ignoreWhites === void 0 ? true : _options$ignoreWhites,
+    _options$bothWay = options.bothWay,
+    bothWay = _options$bothWay === void 0 ? true : _options$bothWay;
+  var kw = normalizeStrForCompare(keyword, ignoreWhitespace);
+  if (!kw) {
+    return true;
+  }
+  return candidateValues.some(function (v) {
+    var candidate = normalizeStrForCompare(v, ignoreWhitespace);
+    return candidate.includes(kw) || (bothWay ? kw.includes(candidate) : kw.includes(candidate));
+  });
+}

package/dist/esm/helper/index.js

@@ -6,4 +6,5 @@ export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
 export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';
 export { default as isEmptyPagedList } from './is-empty-paged-list';
+export { default as localSearchCompare } from './local-search-compare';
 //# sourceMappingURL=index.js.map

package/dist/esm/helper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","normalizePagedListUncertain","isEmptyPagedList"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\nexport { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';\n\nexport { default as isEmptyPagedList } from './is-empty-paged-list';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AACtE,SAASN,OAAO,IAAIO,2BAA2B,QAAQ,kCAAkC;AAEzF,SAASP,OAAO,IAAIQ,gBAAgB,QAAQ,uBAAuB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["default","normalizeId","normalizeBoolean","normalizeNumber","normalizeEnum","normalizeTime","normalizePagedList","normalizePagedListUncertain","isEmptyPagedList","localSearchCompare"],"sources":["../../../src/helper/index.ts"],"sourcesContent":["export { default as normalizeId } from './normalize-id';\nexport { default as normalizeBoolean } from './normalize-boolean';\nexport { default as normalizeNumber } from './normalize-number';\nexport { default as normalizeEnum } from './normalize-enum';\nexport { default as normalizeTime } from './normalize-time';\nexport { default as normalizePagedList } from './normalize-paged-list';\nexport { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';\n\nexport { default as isEmptyPagedList } from './is-empty-paged-list';\nexport { default as localSearchCompare } from './local-search-compare';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW,QAAQ,gBAAgB;AACvD,SAASD,OAAO,IAAIE,gBAAgB,QAAQ,qBAAqB;AACjE,SAASF,OAAO,IAAIG,eAAe,QAAQ,oBAAoB;AAC/D,SAASH,OAAO,IAAII,aAAa,QAAQ,kBAAkB;AAC3D,SAASJ,OAAO,IAAIK,aAAa,QAAQ,kBAAkB;AAC3D,SAASL,OAAO,IAAIM,kBAAkB,QAAQ,wBAAwB;AACtE,SAASN,OAAO,IAAIO,2BAA2B,QAAQ,kCAAkC;AAEzF,SAASP,OAAO,IAAIQ,gBAAgB,QAAQ,uBAAuB;AACnE,SAASR,OAAO,IAAIS,kBAAkB,QAAQ,wBAAwB","ignoreList":[]}

package/dist/esm/helper/local-search-compare.js

@@ -0,0 +1,24 @@
+function normalizeStrForCompare(str, ignoreWhitespace) {
+  var strLower = str.trim().toLowerCase();
+  return strLower.replace(/\s+/g, ignoreWhitespace ? '' : ' ');
+}
+
+/**
+ * 本地搜索时的比较方法，使用 keyword 匹配可选的字符串数组，注意当 keyword 为空时，返回 true
+ */
+export default function localSearchCompare(keyword, candidateValues) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var _options$ignoreWhites = options.ignoreWhitespace,
+    ignoreWhitespace = _options$ignoreWhites === void 0 ? true : _options$ignoreWhites,
+    _options$bothWay = options.bothWay,
+    bothWay = _options$bothWay === void 0 ? true : _options$bothWay;
+  var kw = normalizeStrForCompare(keyword, ignoreWhitespace);
+  if (!kw) {
+    return true;
+  }
+  return candidateValues.some(function (v) {
+    var candidate = normalizeStrForCompare(v, ignoreWhitespace);
+    return candidate.includes(kw) || (bothWay ? kw.includes(candidate) : kw.includes(candidate));
+  });
+}
+//# sourceMappingURL=local-search-compare.js.map

package/dist/esm/helper/local-search-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-search-compare.js","names":["normalizeStrForCompare","str","ignoreWhitespace","strLower","trim","toLowerCase","replace","localSearchCompare","keyword","candidateValues","options","arguments","length","undefined","_options$ignoreWhites","_options$bothWay","bothWay","kw","some","v","candidate","includes"],"sources":["../../../src/helper/local-search-compare.ts"],"sourcesContent":["interface IOptions {\n  /**\n   * 是否忽略中间的空格，默认 true，当 false 时，也会去除两端的空格，并且将连续的空格转成单个空格\n   */\n  ignoreWhitespace?: boolean;\n  /**\n   * 是否判断反向包含，默认 true\n   *\n   * | bothWay | 关键字 | 候选项 | 结果 |\n   * | --- | --- | --- | --- |\n   * | `false` | AB | ABC | `true` |\n   * | `false` | ABC | AB | `false` |\n   * | `true` | AB | ABC | `true` |\n   * | `true` | ABC | AB | `true` |\n   */\n  bothWay?: boolean;\n}\n\nfunction normalizeStrForCompare(str: string, ignoreWhitespace: boolean): string {\n  const strLower = str.trim().toLowerCase();\n  \n  return strLower.replace(/\\s+/g, ignoreWhitespace ? '' : ' ');\n}\n\n/**\n * 本地搜索时的比较方法，使用 keyword 匹配可选的字符串数组，注意当 keyword 为空时，返回 true\n */\nexport default function localSearchCompare(keyword: string, candidateValues: string[], options: IOptions = {}): boolean {\n  const {\n    ignoreWhitespace = true,\n    bothWay = true\n  } = options;\n  const kw = normalizeStrForCompare(keyword, ignoreWhitespace);\n  \n  if (!kw) {\n    return true;\n  }\n  \n  return candidateValues.some(v => {\n    const candidate = normalizeStrForCompare(v, ignoreWhitespace);\n    \n    return candidate.includes(kw) || (bothWay ? kw.includes(candidate) : kw.includes(candidate));\n  });\n}\n"],"mappings":"AAkBA,SAASA,sBAAsBA,CAACC,GAAW,EAAEC,gBAAyB,EAAU;EAC9E,IAAMC,QAAQ,GAAGF,GAAG,CAACG,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;EAEzC,OAAOF,QAAQ,CAACG,OAAO,CAAC,MAAM,EAAEJ,gBAAgB,GAAG,EAAE,GAAG,GAAG,CAAC;AAC9D;;AAEA;AACA;AACA;AACA,eAAe,SAASK,kBAAkBA,CAACC,OAAe,EAAEC,eAAyB,EAAmC;EAAA,IAAjCC,OAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAC3G,IAAAG,qBAAA,GAGIJ,OAAO,CAFTR,gBAAgB;IAAhBA,gBAAgB,GAAAY,qBAAA,cAAG,IAAI,GAAAA,qBAAA;IAAAC,gBAAA,GAErBL,OAAO,CADTM,OAAO;IAAPA,OAAO,GAAAD,gBAAA,cAAG,IAAI,GAAAA,gBAAA;EAEhB,IAAME,EAAE,GAAGjB,sBAAsB,CAACQ,OAAO,EAAEN,gBAAgB,CAAC;EAE5D,IAAI,CAACe,EAAE,EAAE;IACP,OAAO,IAAI;EACb;EAEA,OAAOR,eAAe,CAACS,IAAI,CAAC,UAAAC,CAAC,EAAI;IAC/B,IAAMC,SAAS,GAAGpB,sBAAsB,CAACmB,CAAC,EAAEjB,gBAAgB,CAAC;IAE7D,OAAOkB,SAAS,CAACC,QAAQ,CAACJ,EAAE,CAAC,KAAKD,OAAO,GAAGC,EAAE,CAACI,QAAQ,CAACD,SAAS,CAAC,GAAGH,EAAE,CAACI,QAAQ,CAACD,SAAS,CAAC,CAAC;EAC9F,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/types/helper/index.d.ts

@@ -6,3 +6,4 @@ export { default as normalizeTime } from './normalize-time';
 export { default as normalizePagedList } from './normalize-paged-list';
 export { default as normalizePagedListUncertain } from './normalize-paged-list-uncertain';
 export { default as isEmptyPagedList } from './is-empty-paged-list';
+export { default as localSearchCompare } from './local-search-compare';

package/dist/types/helper/local-search-compare.d.ts

@@ -0,0 +1,22 @@
+interface IOptions {
+    /**
+     * 是否忽略中间的空格，默认 true，当 false 时，也会去除两端的空格，并且将连续的空格转成单个空格
+     */
+    ignoreWhitespace?: boolean;
+    /**
+     * 是否判断反向包含，默认 true
+     *
+     * | bothWay | 关键字 | 候选项 | 结果 |
+     * | --- | --- | --- | --- |
+     * | `false` | AB | ABC | `true` |
+     * | `false` | ABC | AB | `false` |
+     * | `true` | AB | ABC | `true` |
+     * | `true` | ABC | AB | `true` |
+     */
+    bothWay?: boolean;
+}
+/**
+ * 本地搜索时的比较方法，使用 keyword 匹配可选的字符串数组，注意当 keyword 为空时，返回 true
+ */
+export default function localSearchCompare(keyword: string, candidateValues: string[], options?: IOptions): boolean;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kcuf/helper-data",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Data normalizer helpers and loading stuff to make all frontend data processing sane.",
   "keywords": [],
   "license": "MIT",
@@ -22,14 +22,14 @@
     "access": "public"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.3",
-    "@babel/core": "^7.28.5",
-    "@babel/plugin-transform-runtime": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.29.0",
+    "@babel/plugin-transform-runtime": "^7.29.0",
+    "@babel/preset-env": "^7.29.2",
     "@babel/preset-typescript": "^7.28.5",
-    "rimraf": "^6.1.2",
-    "typescript": "^5.9.3",
-    "@kcuf/ts-config": "^0.1.0"
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.2",
+    "@kcuf/ts-config": "^0.2.0"
   },
   "peerDependencies": {
     "@babel/runtime": ">=7.0.0"