lyb-js 1.6.38 → 1.6.39

package/Data/LibJsPinyinSearch.d.ts

@@ -0,0 +1,21 @@
+/** @description 可参与拼音搜索的数据项 */
+export interface LibJsPinyinSearchItem {
+    [key: string]: unknown;
+}
+/**
+ * @description 根据指定字段执行拼音模糊搜索
+ * @param data 待搜索的数据数组
+ * @param value 搜索关键字；为空字符串时返回原数组
+ * @param keys 参与搜索的字段名数组
+ * @returns 匹配成功的数据项数组，按原数组顺序返回且自动去重
+ * @example
+ * const list = [
+ *   { id: 1, name: "张三", city: "上海" },
+ *   { id: 2, name: "李四", city: "北京" },
+ * ];
+ *
+ * console.log(libJsPinyinSearch(list, "zhang", ["name"]));
+ * // [{ id: 1, name: "张三", city: "上海" }]
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#libjspinyinsearch-拼音模糊搜索
+ */
+export declare const libJsPinyinSearch: <T extends LibJsPinyinSearchItem>(data: T[], value: string, keys: string[]) => T[];

package/Data/LibJsPinyinSearch.js

@@ -0,0 +1,36 @@
+import { match as pinyinMatch } from "pinyin-pro";
+/**
+ * @description 根据指定字段执行拼音模糊搜索
+ * @param data 待搜索的数据数组
+ * @param value 搜索关键字；为空字符串时返回原数组
+ * @param keys 参与搜索的字段名数组
+ * @returns 匹配成功的数据项数组，按原数组顺序返回且自动去重
+ * @example
+ * const list = [
+ *   { id: 1, name: "张三", city: "上海" },
+ *   { id: 2, name: "李四", city: "北京" },
+ * ];
+ *
+ * console.log(libJsPinyinSearch(list, "zhang", ["name"]));
+ * // [{ id: 1, name: "张三", city: "上海" }]
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#libjspinyinsearch-拼音模糊搜索
+ */
+export const libJsPinyinSearch = (data, value, keys) => {
+    if (value === "")
+        return data;
+    const result = [];
+    const seen = new Set();
+    for (const item of data) {
+        for (const key of keys) {
+            const fieldValue = String(item[key] ?? "");
+            if (pinyinMatch(fieldValue, value, { precision: "start" })) {
+                if (!seen.has(item)) {
+                    seen.add(item);
+                    result.push(item);
+                }
+                break;
+            }
+        }
+    }
+    return result;
+};

package/Data/index.d.ts

@@ -2,6 +2,7 @@ export * from "./LibJsChunkArray.js";
 export * from "./LibJsDeepJSONParse.js";
 export * from "./LibJsGroupArrayByKey.js";
 export * from "./LibJsMatchEmail.js";
+export * from "./LibJsPinyinSearch.js";
 export * from "./libJsPickUnique.js";
 export * from "./LibJsShuffleArray.js";
 export * from "./LibJsStepArray.js";

package/Data/index.js

@@ -2,6 +2,7 @@ export * from "./LibJsChunkArray.js";
 export * from "./LibJsDeepJSONParse.js";
 export * from "./LibJsGroupArrayByKey.js";
 export * from "./LibJsMatchEmail.js";
+export * from "./LibJsPinyinSearch.js";
 export * from "./libJsPickUnique.js";
 export * from "./LibJsShuffleArray.js";
 export * from "./LibJsStepArray.js";

package/Math/LibJsPiecewiseLerp.d.ts

@@ -0,0 +1,25 @@
+/** @description 分段线性插值节点 */
+export interface LibJsPiecewiseLerpPoint {
+    /** 横轴位置，需按升序传入 */
+    h: number;
+    /** 当前节点对应的数值 */
+    v: number;
+}
+/**
+ * @description 按多个节点做分段线性插值，区间外返回兜底值
+ * @param points 插值节点数组，需按 h 升序传入
+ * @param currentValue 当前横轴值
+ * @param edgeValue 当前值落在全部区间外时返回的兜底值
+ * @returns 区间内返回插值结果，区间外返回 edgeValue；结果保留两位小数
+ * @example
+ * const points = [
+ *   { h: 0, v: 0 },
+ *   { h: 6, v: 30 },
+ *   { h: 12, v: 100 },
+ * ];
+ *
+ * console.log(LibJsPiecewiseLerp(points, 3, 0)); // 15
+ * console.log(LibJsPiecewiseLerp(points, 9, 0)); // 65
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#libjspiecewiselerp-分段线性插值
+ */
+export declare const LibJsPiecewiseLerp: (points: LibJsPiecewiseLerpPoint[], currentValue: number, edgeValue: number) => number;

package/Math/LibJsPiecewiseLerp.js

@@ -0,0 +1,33 @@
+/**
+ * @description 按多个节点做分段线性插值，区间外返回兜底值
+ * @param points 插值节点数组，需按 h 升序传入
+ * @param currentValue 当前横轴值
+ * @param edgeValue 当前值落在全部区间外时返回的兜底值
+ * @returns 区间内返回插值结果，区间外返回 edgeValue；结果保留两位小数
+ * @example
+ * const points = [
+ *   { h: 0, v: 0 },
+ *   { h: 6, v: 30 },
+ *   { h: 12, v: 100 },
+ * ];
+ *
+ * console.log(LibJsPiecewiseLerp(points, 3, 0)); // 15
+ * console.log(LibJsPiecewiseLerp(points, 9, 0)); // 65
+ * @link 使用方法：https://www.npmjs.com/package/lyb-js#libjspiecewiselerp-分段线性插值
+ */
+export const LibJsPiecewiseLerp = (points, currentValue, edgeValue) => {
+    if (!points.length)
+        return edgeValue;
+    if (currentValue < points[0].h || currentValue >= points[points.length - 1].h) {
+        return edgeValue;
+    }
+    for (let i = 0; i < points.length - 1; i++) {
+        const curr = points[i];
+        const next = points[i + 1];
+        if (currentValue >= curr.h && currentValue < next.h) {
+            const ratio = (currentValue - curr.h) / (next.h - curr.h);
+            return +(curr.v + (next.v - curr.v) * ratio).toFixed(2);
+        }
+    }
+    return edgeValue;
+};

package/Math/index.d.ts

@@ -5,3 +5,4 @@ export * from "./LibJsCoordsDistance.js";
 export * from "./LibJsDecimal.js";
 export * from "./LibJsLerp.js";
 export * from "./LibJsNormalizeInRange.js";
+export * from "./LibJsPiecewiseLerp.js";

package/Math/index.js

@@ -5,3 +5,4 @@ export * from "./LibJsCoordsDistance.js";
 export * from "./LibJsDecimal.js";
 export * from "./LibJsLerp.js";
 export * from "./LibJsNormalizeInRange.js";
+export * from "./LibJsPiecewiseLerp.js";

package/README.md

@@ -119,6 +119,7 @@ console.log(libJsGetRowValue({ user: { name: "Tom" } }, "user.name")); // "Tom"
 - [LibJsDeepJSONParse-深度解析JSON](#libjsdeepjsonparse-深度解析json)
 - [LibJsGroupArrayByKey-分类汇总](#libjsgrouparraybykey-分类汇总)
 - [LibJsMatchEmail-匹配E-Mail](#libjsmatchemail-匹配e-mail)
+- [LibJsPinyinSearch-拼音模糊搜索](#libjspinyinsearch-拼音模糊搜索)
 - [libJsPickUnique-随机选择未使用元素](#libjspickunique-随机选择未使用元素)
 - [LibJsShuffleArray-数组乱序](#libjsshufflearray-数组乱序)
 - [LibJsStepArray-数组偏移](#libjssteparray-数组偏移)
@@ -147,6 +148,7 @@ console.log(libJsGetRowValue({ user: { name: "Tom" } }, "user.name")); // "Tom"
 - [LibJsDecimal-高精度计算](#libjsdecimal-高精度计算)
 - [LibJsLerp-线性插值](#libjslerp-线性插值)
 - [LibJsNormalizeInRange-范围归一化](#libjsnormalizeinrange-范围归一化)
+- [LibJsPiecewiseLerp-分段线性插值](#libjspiecewiselerp-分段线性插值)
 
 ### Misc-杂项
 
@@ -425,6 +427,33 @@ const result = libJsMatchEmail("user@g", ["@gmail.com", "@github.com"]);
 console.log(result); // ["user@gmail.com", "user@github.com"]
 ```
 
+### LibJsPinyinSearch-拼音模糊搜索
+
+按指定字段做拼音模糊搜索，适合中文姓名、城市名、标签名这类检索场景。
+
+```ts
+import { libJsPinyinSearch } from "lyb-js/Data/LibJsPinyinSearch";
+
+const list = [
+  { id: 1, name: "张三", city: "上海" },
+  { id: 2, name: "李四", city: "北京" },
+  { id: 3, name: "王五", city: "深圳" },
+];
+
+console.log(libJsPinyinSearch(list, "zhang", ["name"]));
+// [{ id: 1, name: "张三", city: "上海" }]
+```
+
+```ts
+const contacts = [
+  { id: 1, name: "赵敏", department: "市场部" },
+  { id: 2, name: "周杰伦", department: "内容中心" },
+];
+
+console.log(libJsPinyinSearch(contacts, "shi", ["department"]));
+// [{ id: 1, name: "赵敏", department: "市场部" }]
+```
+
 ### libJsPickUnique-随机选择未使用元素
 
 从候选数组中随机选一个还没有被使用过的元素。
@@ -670,6 +699,37 @@ console.log(LibJsNormalizeInRange(0, 100, 50)); // 0.5
 console.log(LibJsNormalizeInRange(0, 100, 120)); // 1
 ```
 
+### LibJsPiecewiseLerp-分段线性插值
+
+根据多个节点做分段线性插值；当值落在全部区间外时返回兜底值。
+
+```ts
+import {
+  LibJsPiecewiseLerp,
+  type LibJsPiecewiseLerpPoint,
+} from "lyb-js/Math/LibJsPiecewiseLerp";
+
+const points: LibJsPiecewiseLerpPoint[] = [
+  { h: 0, v: 0 },
+  { h: 6, v: 30 },
+  { h: 12, v: 100 },
+];
+
+console.log(LibJsPiecewiseLerp(points, 3, 0)); // 15
+console.log(LibJsPiecewiseLerp(points, 9, 0)); // 65
+```
+
+```ts
+const brightnessPoints = [
+  { h: 8, v: 0.2 },
+  { h: 12, v: 0.8 },
+  { h: 18, v: 0.4 },
+];
+
+console.log(LibJsPiecewiseLerp(brightnessPoints, 10, 0)); // 0.5
+console.log(LibJsPiecewiseLerp(brightnessPoints, 20, -1)); // -1
+```
+
 ## Misc-杂项
 
 ### LibJsClassObservable-类属性监听器

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.6.38",
+  "version": "1.6.39",
   "description": "JavaScript utility library",
   "license": "ISC",
   "type": "module",
@@ -60,6 +60,7 @@
   ],
   "dependencies": {
     "dayjs": "^1.11.13",
-    "decimal.js": "^10.4.3"
+    "decimal.js": "^10.4.3",
+    "pinyin-pro": "^3.27.0"
   }
 }