@unicom-cloud/utils 0.1.45 → 0.1.46

package/pinyin/lib/core/custom/index.d.ts

@@ -0,0 +1,25 @@
+import { FastDictFactory } from '../../common/utils';
+type CustomHandleType = 'add' | 'replace';
+type CustomDictType = 'pinyin' | 'multiple' | 'polyphonic';
+interface CustomPinyinOptions {
+    /**
+     * @description: multiple 对于 customPinyin 补充词汇的处理
+     */
+    multiple?: CustomHandleType;
+    /**
+     * @description: polyphonic 对于 customPinyin 补充词汇的处理
+     */
+    polyphonic?: CustomHandleType;
+}
+/**
+ * @description: 用户自定义拼音
+ * @param {{ [key: string]: string }} config 用户自定义的拼音映射（支持汉字、词语、句子的映射），若匹配到该映射，优先将汉字转换为该映射
+ * @param {CustomPinyinOptions} options multiple/polyphonic 对于 customPinyin 补充词汇的处理
+ */
+export declare function customPinyin(config?: {
+    [word: string]: string;
+}, options?: CustomPinyinOptions): void;
+export declare const getCustomMultpileDict: () => FastDictFactory;
+export declare const getCustomPolyphonicDict: () => FastDictFactory;
+export declare function clearCustomDict(dict: CustomDictType | CustomDictType[]): void;
+export {};

package/pinyin/lib/core/custom/index.js

@@ -0,0 +1,39 @@
+/* 潘启宝 2026-05-21 17:01:48 星期四 山东省济南市 */
+import { Priority as e, Probability as t } from "../../common/constant.js";
+import { FastDictFactory as n, splitString as r, stringLength as i } from "../../common/utils.js";
+import { acTree as a } from "../../common/segmentit/index.js";
+import o from "../../data/dict1.js";
+//#region utils/pinyin/lib/core/custom/index.ts
+var s = {}, c = new n(), l = new n(), u = Symbol("custom");
+function d(n = {}, r) {
+	Object.keys(n).sort((e, t) => i(t) - i(e)).forEach((e) => {
+		s[e] = n[e];
+	});
+	let o = Object.keys(s).map((n) => ({
+		zh: n,
+		pinyin: s[n],
+		probability: t.Custom + i(n),
+		length: i(n),
+		priority: e.Custom,
+		dict: u
+	}));
+	a.build(o), r?.multiple && f(n, c, r.multiple), r?.polyphonic && f(n, l, r.polyphonic);
+}
+function f(e, t, n) {
+	for (let i in e) {
+		let a = e[i];
+		r(i).forEach((e, r) => {
+			let i = a.split(" ")[r] || "";
+			n === "replace" || n === "add" && !t.get(e) && !o.get(e) ? t.set(e, i) : (t.set(e, t.get(e) || o.get(e)), t.get(e).split(" ").includes(i) || t.set(e, `${t.get(e)} ${i}`.trim()));
+		});
+	}
+}
+var p = () => c, m = () => l;
+function h(e) {
+	(e === "pinyin" || e.indexOf("pinyin") !== -1) && (Object.keys(s).forEach(function(e) {
+		delete s[e];
+	}), a.removeDict(u)), (e === "multiple" || e.indexOf("multiple") !== -1) && c.clear(), (e === "polyphonic" || e.indexOf("polyphonic") !== -1) && l.clear();
+}
+//#endregion
+export { h as clearCustomDict, d as customPinyin, p as getCustomMultpileDict, m as getCustomPolyphonicDict };
+/* 独立思考，明辨是非 */

package/pinyin/lib/core/dict/index.d.ts

@@ -0,0 +1,10 @@
+type DICT = {
+    [key: string]: string | [string] | [string, number] | [string, number, string];
+};
+type DictOptions = {
+    name?: string;
+    dict1?: 'add' | 'replace' | 'ignore';
+};
+export declare function addDict(dict: DICT | {}, options?: string | DictOptions): void;
+export declare function removeDict(dictName?: string): void;
+export {};

package/pinyin/lib/core/dict/index.js

@@ -0,0 +1,48 @@
+/* 潘启宝 2026-05-21 17:01:48 星期四 山东省济南市 */
+import { Priority as e, Probability as t } from "../../common/constant.js";
+import { stringLength as n } from "../../common/utils.js";
+import { acTree as r } from "../../common/segmentit/index.js";
+import i from "../../data/dict1.js";
+//#region utils/pinyin/lib/core/dict/index.ts
+var a = Symbol("default"), o = /* @__PURE__ */ new Map();
+function s(i, o) {
+	let s = [], c = (typeof o == "object" ? o.name : o) || a, u = o?.dict1 || "add";
+	for (let r in i) {
+		let a = i[r], o = Array.isArray(a) ? a[0] : a, d = n(r);
+		d === 1 && l(c, r, o, u), Array.isArray(a) ? s.push({
+			zh: r,
+			pinyin: o,
+			probability: typeof a[1] == "number" ? a[1] : t.DICT * d * d,
+			length: d,
+			priority: e.Normal,
+			dict: c,
+			pos: typeof a[2] == "string" ? a[2] : ""
+		}) : s.push({
+			zh: r,
+			pinyin: o,
+			probability: t.DICT * d * d,
+			length: d,
+			priority: e.Normal,
+			dict: c
+		});
+	}
+	r.build(s);
+}
+function c(e) {
+	r.removeDict(e || a), u(e || a);
+}
+function l(e, t, n, r = "add") {
+	o.get(e) || o.set(e, {});
+	let a = o.get(e);
+	if (a[t] || (a[t] = i.get(t)), r === "add") {
+		let e = i.get(t);
+		e && !e.split(" ").includes(n) ? i.set(t, `${e} ${n}`) : i.get(t) || i.set(t, n);
+	} else r === "replace" && i.set(t, n);
+}
+function u(e) {
+	let t = o.get(e) || {};
+	for (let e in t) i.set(e, t[e]), delete t[e];
+}
+//#endregion
+export { s as addDict, c as removeDict };
+/* 独立思考，明辨是非 */

package/pinyin/lib/core/html/index.d.ts

@@ -0,0 +1,44 @@
+import type { BasicOptions } from '../pinyin';
+type HtmlBaseOptions = Pick<BasicOptions, 'toneType' | 'v' | 'toneSandhi' | 'segmentit' | 'traditional' | 'surname' | 'mode'>;
+interface HtmlOptions extends HtmlBaseOptions {
+    /**
+     * @description html 结果中每个字+拼音外层 span 标签的类名。默认为 py-result-item
+     */
+    resultClass?: string;
+    /**
+     * @description html 结果中拼音 rt 标签的类名。默认为 py-pinyin-item
+     */
+    pinyinClass?: string;
+    /**
+     * @description html 结果中汉字 span 标签的类名。默认为 py-chinese-item
+     */
+    chineseClass?: string;
+    /**
+     * @description 是否用 span 标签包装非汉字字符的结果。默认为 false。建议输入的文本为纯文本时可以设置为 true；输入文本本身为 html 富文本字符串设置为 false
+     */
+    wrapNonChinese?: boolean;
+    /**
+     * @description html 非汉字字符外层 span 标签的类名，仅当 wrapNonChinese 为 true 时生效。默认为 py-non-chinese-item
+     */
+    nonChineseClass?: string;
+    /**
+     * @description 对于指定的汉字及字符，在 result 上额外补充的拼音
+     */
+    customClassMap?: {
+        [classname: string]: string[];
+    };
+    /**
+     * @description 是否保留  <rp>(</rp> 标签，默认为保留
+     * @value true：保留 <rp>(</rp>
+     * @value false：移除 <rp>(</rp>
+     */
+    rp?: boolean;
+}
+/**
+ * @description: 获取带拼音汉字的 html 字符串
+ * @param {string} text 要转换的字符串
+ * @param {HtmlOptions=} options html 中标签类名相关配置
+ * @return {string} 带汉字的拼音字符串
+ */
+export declare const html: (text: string, options?: HtmlOptions) => string;
+export {};

package/pinyin/lib/core/html/index.js

@@ -0,0 +1,36 @@
+/* 潘启宝 2026-05-21 17:01:48 星期四 山东省济南市 */
+import { pinyin as e } from "../pinyin/index.js";
+//#region utils/pinyin/lib/core/html/index.ts
+var t = {
+	resultClass: "py-result-item",
+	chineseClass: "py-chinese-item",
+	pinyinClass: "py-pinyin-item",
+	nonChineseClass: "py-non-chinese-item",
+	wrapNonChinese: !1,
+	toneType: "symbol",
+	customClassMap: {},
+	toneSandhi: !0,
+	rp: !0,
+	v: !1,
+	traditional: !1
+}, n = (n, r) => {
+	let i = {
+		...t,
+		...r || {}
+	};
+	return e(n, {
+		type: "all",
+		...i
+	}).map((e) => {
+		let n = "";
+		for (let t in i.customClassMap) i.customClassMap[t].includes(e.origin) && (n += ` ${t}`);
+		if (e.isZh) {
+			let r = i.resultClass || t.resultClass, a = i.chineseClass || t.chineseClass, o = i.pinyinClass || t.pinyinClass;
+			return `<span class="${r}${n}"><ruby><span class="${a}">${e.origin}</span>${i.rp ? "<rp>(</rp>" : ""}<rt class="${o}">${e.pinyin}</rt>${i.rp ? "<rp>)</rp>" : ""}</ruby></span>`;
+		} else if (i.wrapNonChinese) return `<span class="${i.nonChineseClass || t.nonChineseClass}${n}">${e.origin}</span>`;
+		else return e.origin;
+	}).join("");
+};
+//#endregion
+export { n as html };
+/* 独立思考，明辨是非 */

package/pinyin/lib/core/match/index.d.ts

@@ -0,0 +1,35 @@
+interface MatchOptions {
+    /**
+     * @description 每个汉字和拼音需要遵从的匹配精度
+     */
+    precision?: 'first' | 'start' | 'every' | 'any';
+    /**
+     * @description 匹配的汉字下标是否为连续的才算匹配成功
+     */
+    continuous?: boolean;
+    /**
+     * @description 匹配时对于空格的处理
+     */
+    space?: 'ignore' | 'preserve';
+    /**
+     * @description 最后一个字的匹配精度
+     */
+    lastPrecision?: 'first' | 'start' | 'every' | 'any';
+    /**
+     * @description 是否大小写不敏感
+     */
+    insensitive?: boolean;
+    /**
+     * @description 是否将 ü 替换成 v 进行匹配
+     */
+    v?: boolean;
+}
+/**
+ * @description: 检测汉语字符串和拼音是否匹配
+ * @param {string} text 汉语字符串
+ * @param {string} pinyin 拼音，支持各种缩写形式
+ * @param {MatchOptions=} options 配置项
+ * @return {Array | null} 若匹配成功，返回 text 中匹配成功的下标数组；若匹配失败，返回 null
+ */
+export declare const match: (text: string, pinyin: string, options?: MatchOptions) => number[] | null;
+export {};

package/pinyin/lib/core/match/index.js

@@ -0,0 +1,103 @@
+/* 潘启宝 2026-05-21 17:01:48 星期四 山东省济南市 */
+import { splitString as e } from "../../common/utils.js";
+import { pinyin as t } from "../pinyin/index.js";
+//#region utils/pinyin/lib/core/match/index.ts
+var n = {
+	precision: "first",
+	continuous: !1,
+	space: "ignore",
+	lastPrecision: "start",
+	insensitive: !0,
+	v: !1
+}, r = 6, i = (e, t, r) => {
+	r?.precision === "any" && (r.lastPrecision = "any"), r?.v && (t = t.replace(/ü/g, "v"));
+	let i = {
+		...n,
+		...r || {}
+	};
+	i.insensitive !== !1 && (e = e.toLowerCase(), t = t.toLowerCase()), i.space === "ignore" && (t = t.replace(/\s/g, ""));
+	let a = r?.precision === "any" ? o(e, t, i) : s(e, t, i);
+	return c(e, a);
+}, a = (e, t) => {
+	let n = 0;
+	for (let r = 0; r < e.length; r++) e[r] === t[n] && n++;
+	return n;
+}, o = (n, r, i) => {
+	let o = [], s = e(n), c = i.space === "ignore";
+	for (let e = 0; e < s.length; e++) {
+		if (c && s[e] === " ") {
+			o.push(e);
+			continue;
+		}
+		if (s[e] === r[0]) {
+			r = r.slice(1), o.push(e);
+			continue;
+		}
+		let n = t(s[e], {
+			toneType: "none",
+			multiple: !0,
+			type: "array",
+			v: i.v
+		}), l = 0;
+		if (n.forEach((e) => {
+			let t = a(e, r);
+			t > l && (l = t);
+		}), l && (r = r.slice(l), o.push(e)), !r) break;
+	}
+	if (r) return null;
+	if (i.continuous) {
+		let e = o;
+		if (o.some((t, n) => n > 0 && t !== e[n - 1] + 1)) return null;
+	}
+	return i.space === "ignore" && (o = o.filter((e) => s[e] !== " ")), o.length ? o : null;
+}, s = (n, i, a) => {
+	let o = e(n), s = Array(o.length + 1);
+	for (let e = 0; e < s.length; e++) s[e] = Array(i.length + 1), s[e][0] = [];
+	for (let e = 0; e < s[0].length; e++) s[0][e] = [];
+	for (let e = 1; e < s.length; e++) {
+		if (!a.continuous || a.space == "ignore" && o[e - 1] === " ") for (let t = 1; t <= i.length; t++) s[e][t - 1] = s[e - 1][t - 1];
+		for (let n = 1; n <= i.length; n++) if (!s[e - 1][n - 1]) continue;
+		else if (n !== 1 && !s[e - 1][n - 1].length) continue;
+		else {
+			let c = t(o[e - 1], {
+				type: "array",
+				toneType: "none",
+				multiple: !0,
+				v: a.v
+			});
+			if (o[e - 1] === i[n - 1]) {
+				let t = [...s[e - 1][n - 1], e - 1];
+				if ((!s[e][n] || t.length > s[e][n].length) && (s[e][n] = t), n === i.length) return s[e][n];
+			}
+			if (i.length - n <= r && c.some((e) => a.lastPrecision === "any" ? e.includes(i.slice(n - 1, i.length)) : a.lastPrecision === "start" ? e.startsWith(i.slice(n - 1, i.length)) : a.lastPrecision === "first" ? e[0] === i.slice(n - 1, i.length) : a.lastPrecision === "every" ? e === i.slice(n - 1, i.length) : !1)) return [...s[e - 1][n - 1], e - 1];
+			let l = a.precision;
+			if (l === "start" && c.forEach((t) => {
+				let r = n, a = [...s[e - 1][n - 1], e - 1];
+				for (; r <= i.length && t.startsWith(i.slice(n - 1, r));) (!s[e][r] || a.length > s[e][r].length) && (s[e][r] = a), r++;
+			}), l === "first" && c.some((e) => e[0] === i[n - 1])) {
+				let t = [...s[e - 1][n - 1], e - 1];
+				(!s[e][n] || t.length > s[e][n].length) && (s[e][n] = t);
+			}
+			let u = c.find((e) => e === i.slice(n - 1, n - 1 + e.length));
+			if (u) {
+				let t = [...s[e - 1][n - 1], e - 1], r = n - 1 + u.length;
+				(!s[e][r] || t.length > s[e][r].length) && (s[e][r] = t);
+			}
+		}
+	}
+	return null;
+};
+function c(t, n) {
+	if (!n) return null;
+	let r = [], i = 0, a = e(t), o = 0;
+	for (let e = 0; e < n.length; e++) {
+		let t = n[e];
+		for (; o <= t;) a[o].length === 2 && i++, o++;
+		let s = t + i;
+		a[t].length === 2 ? r.push(s - 1, s) : r.push(s);
+	}
+	return r;
+}
+//#endregion
+export { i as match };
+/* 独立思考，明辨是非 */

package/pinyin/lib/core/pinyin/handle.d.ts

@@ -0,0 +1,81 @@
+import type { MatchPattern } from '../../common/segmentit/TrieNode';
+import { TokenizationAlgorithm } from '../../common/segmentit/TrieNode';
+import type { InitialPattern, SingleWordResult, SurnameMode } from '../../common/type';
+/**
+ * @description: 获取单个字符的拼音
+ * @param {string} char
+ * @return {string}
+ */
+type GetSingleWordPinyin = (char: string) => string;
+export declare const getSingleWordPinyin: GetSingleWordPinyin;
+export declare const getPinyin: (word: string, list: SingleWordResult[], surname: SurnameMode, segmentit: TokenizationAlgorithm, traditional?: boolean) => {
+    list: SingleWordResult[];
+    matches: MatchPattern[];
+};
+/**
+ * @description: 将带音调符号拼音转换为不带音调拼音
+ * @param {string} pinyin
+ * @return {string}
+ */
+type GetPinyinWithoutTone = (pinyin: string) => string;
+declare const getPinyinWithoutTone: GetPinyinWithoutTone;
+/**
+ * @description: 获取单字符的多音拼音
+ * @param {string} char
+ * @return {WordResult[]}
+ */
+type GetAllPinyin = (char: string, surname?: SurnameMode) => string[];
+export declare const getAllPinyin: GetAllPinyin;
+/**
+ * @description: 获取单字符的多音拼音
+ * @param {string} word
+ * @return {WordResult[]}
+ */
+type GetMultiplePinyin = (word: string, surname?: SurnameMode) => SingleWordResult[];
+declare const getMultiplePinyin: GetMultiplePinyin;
+/**
+ * @description: 获取拼音的声母和韵母
+ * @param {string} pinyin
+ * @param {InitialPattern} initialPattern
+ * @return {*}
+ */
+type GetInitialAndFinal = (pinyin: string, initialPattern?: InitialPattern) => {
+    final: string;
+    initial: string;
+};
+declare const getInitialAndFinal: GetInitialAndFinal;
+/**
+ * @description: 获取韵母的韵头、韵腹和韵尾
+ * @param {string} pinyin
+ * @return {*}
+ */
+type GetFinalParts = (pinyin: string) => {
+    head: string;
+    body: string;
+    tail: string;
+};
+declare const getFinalParts: GetFinalParts;
+/**
+ * @description: 将带音调符号拼音转换为带音调数字
+ * @param {string} pinyin
+ * @return {string}
+ */
+type GetNumOfTone = (pinyin: string) => string;
+declare const getNumOfTone: GetNumOfTone;
+/**
+ * @description: 将带音调符号拼音转换为带音调数字拼音
+ * @param {string} pinyin
+ * @param {string} originPinyin
+ * @return {string}
+ */
+type GetPinyinWithNum = (pinyin: string, originPinyin: string) => string;
+declare const getPinyinWithNum: GetPinyinWithNum;
+/**
+ * @description: 获取拼音的首字母
+ * @param {string} pinyin
+ * @return {string}
+ */
+type GetFirstLetter = (pinyin: string, isZh: boolean) => string;
+declare const getFirstLetter: GetFirstLetter;
+export declare function processToneSandhi(cur: string, pre: string, next: string): string | undefined;
+export { getFinalParts, getFirstLetter, getInitialAndFinal, getMultiplePinyin, getNumOfTone, getPinyinWithNum, getPinyinWithoutTone, };

package/pinyin/lib/core/pinyin/handle.js

@@ -0,0 +1,140 @@
+/* 潘启宝 2026-05-21 17:01:48 星期四 山东省济南市 */
+import { Priority as e } from "../../common/constant.js";
+import { splitString as t } from "../../common/utils.js";
+import { InitialList as n, SpecialFinalList as r, SpecialFinalMap as i, SpecialInitialList as a, doubleFinalList as o, toneSandhiIgnoreSuffix as s, toneSandhiList as c, toneSandhiMap as l } from "../../data/special.js";
+import u from "../../data/surname.js";
+import { acTree as d } from "../../common/segmentit/index.js";
+import f from "../../data/dict1.js";
+import { getCustomMultpileDict as p } from "../custom/index.js";
+import { getTraditionalDict as m } from "../traditional/index.js";
+//#region utils/pinyin/lib/core/pinyin/handle.ts
+var h = (e) => {
+	let t = f.get(e);
+	return t ? t.split(" ")[0] : e;
+}, g = (e) => {
+	let t = [], n = m();
+	for (let r = 0; r < e.length; r++) {
+		let i = e[r], a = i.charCodeAt(0);
+		n[a] ? t[r] = n[a] : t[r] = i;
+	}
+	return t.join("");
+}, _ = (n, r, i, a, o) => {
+	let s = o ? g(n) : n, c = d.search(s, i, a), l = 0, u = t(n);
+	for (let t = 0; t < u.length;) {
+		let n = c[l];
+		if (n && t === n.index) {
+			if (n.length === 1 && n.priority <= e.Normal) {
+				let e = u[t];
+				n.zh = e;
+				let i = "";
+				i = k(e, u[t - 1], u[t + 1]), r[t] = {
+					origin: e,
+					result: i,
+					isZh: i !== e,
+					originPinyin: i
+				}, t++, l++;
+				continue;
+			}
+			let i = n.pinyin.split(" "), a = 0;
+			o && (n.zh = u.slice(n.index, n.index + n.length).join(""));
+			for (let e = 0; e < n.length; e++) r[t + e] = {
+				origin: u[e + n.index],
+				result: i[a] || "",
+				isZh: !0,
+				originPinyin: i[a] || ""
+			}, a++;
+			t += n.length, l++;
+		} else {
+			let e = u[t], n = "";
+			n = k(e, u[t - 1], u[t + 1]), r[t] = {
+				origin: e,
+				result: n,
+				isZh: n !== e,
+				originPinyin: n
+			}, t++;
+		}
+	}
+	return {
+		list: r,
+		matches: c
+	};
+}, v = (e) => e.replace(/(ā|á|ǎ|à)/g, "a").replace(/(ō|ó|ǒ|ò)/g, "o").replace(/(ē|é|ě|è)/g, "e").replace(/(ī|í|ǐ|ì)/g, "i").replace(/(ū|ú|ǔ|ù)/g, "u").replace(/(ǖ|ǘ|ǚ|ǜ)/g, "ü").replace(/(n̄|ń|ň|ǹ)/g, "n").replace(/(m̄|ḿ|m̌|m̀)/g, "m").replace(/(ê̄|ế|ê̌|ề)/g, "ê"), y = (e, t = "off") => {
+	let n = p(), r = f.get(e) ? f.get(e).split(" ") : [];
+	if (n.get(e)) r = n.get(e).split(" ");
+	else if (t !== "off") {
+		let t = u[e];
+		t && (r = [t].concat(r.filter((e) => e !== t)));
+	}
+	return r;
+}, b = (e, t = "off") => {
+	let n = y(e, t);
+	return n.length > 0 ? n.map((t) => ({
+		origin: e,
+		result: t,
+		isZh: !0,
+		originPinyin: t
+	})) : [{
+		origin: e,
+		result: e,
+		isZh: !1,
+		originPinyin: e
+	}];
+}, x = (e, t) => {
+	let o = e.split(" "), s = [], c = [];
+	for (let e of o) for (let t of n) if (e.startsWith(t)) {
+		let n = e.slice(t.length);
+		a.indexOf(t) !== -1 && r.indexOf(n) !== -1 && (n = i[n]), s.push(t), c.push(n);
+		break;
+	}
+	return t === "standard" && s.forEach((e, t) => {
+		(e === "y" || e === "w") && (s[t] = "");
+	}), {
+		final: c.join(" "),
+		initial: s.join(" ")
+	};
+}, S = (e) => {
+	let { final: t } = x(e), n = "", r = "", i = "";
+	return o.indexOf(v(t)) === -1 ? (r = t[0] || "", i = t.slice(1) || "") : (n = t[0], r = t[1], i = t.slice(2)), {
+		head: n,
+		body: r,
+		tail: i
+	};
+}, C = (e) => {
+	let t = /(ā|ō|ē|ī|ū|ǖ|n̄|m̄|ê̄)/, n = /(á|ó|é|í|ú|ǘ|ń|ḿ|ế)/, r = /(ǎ|ǒ|ě|ǐ|ǔ|ǚ|ň|m̌|ê̌)/, i = /(à|ò|è|ì|ù|ǜ|ǹ|m̀|ề)/, a = /(a|o|e|i|u|ü|ê)/, o = /(n|m)$/, s = [];
+	return e.split(" ").forEach((e) => {
+		t.test(e) ? s.push("1") : n.test(e) ? s.push("2") : r.test(e) ? s.push("3") : i.test(e) ? s.push("4") : a.test(e) || o.test(e) ? s.push("0") : s.push("");
+	}), s.join(" ");
+}, w = (e, t) => {
+	let n = v(e).split(" "), r = C(t).split(" "), i = [];
+	return n.forEach((e, t) => {
+		i.push(`${e}${r[t]}`);
+	}), i.join(" ");
+}, T = (e, t) => {
+	let n = [];
+	return e.split(" ").forEach((e) => {
+		n.push(t ? e[0] : e);
+	}), n.join(" ");
+};
+function E(e, t, n) {
+	if (c.indexOf(e) === -1) return h(e);
+	if (t === n && t && h(t) !== t) return v(h(e));
+	if (n && !s[e].includes(n)) {
+		let t = h(n);
+		if (t !== n) {
+			let n = C(t), r = l[e];
+			for (let e in r) if (r[e].indexOf(Number(n)) !== -1) return e;
+		}
+	}
+}
+function D(e, t) {
+	if (e === "了" && (!t || !f.get(t))) return "liǎo";
+}
+function O(e, t) {
+	if (e === "々") return !t || !f.get(t) ? "tóng" : f.get(t).split(" ")[0];
+}
+function k(e, t, n) {
+	return O(e, t) || D(e, t) || E(e, t, n) || h(e);
+}
+//#endregion
+export { y as getAllPinyin, S as getFinalParts, T as getFirstLetter, x as getInitialAndFinal, b as getMultiplePinyin, C as getNumOfTone, _ as getPinyin, w as getPinyinWithNum, v as getPinyinWithoutTone };
+/* 独立思考，明辨是非 */

package/pinyin/lib/core/pinyin/index.d.ts

@@ -0,0 +1,117 @@
+import { TokenizationAlgorithm } from '../../common/segmentit/TrieNode';
+import type { CommonOptions, PinyinMode, SurnameMode } from '../../common/type';
+export interface BasicOptions extends CommonOptions {
+    /**
+     * @description 是否返回单个汉字的所有多音，仅针对输入的 word 为单个汉字生效
+     * @value false：返回最常用的一个拼音 （默认值）
+     * @value true：返回所有读音
+     */
+    multiple?: boolean;
+    /**
+     * @description 优先的拼音匹配模式
+     * @value normal：正常匹配模式 （默认值）
+     * @value surname：姓氏模式，遇到姓氏表中的汉字时，优先匹配姓氏读音
+     */
+    mode?: PinyinMode;
+    /**
+     * @description surname 模式作用的范围
+     * @value off：不启用 surname 模式（默认值为 off）
+     * @value all：作用于整个汉语字符串（当设置了 `mode: surname` 时，默认值为 all）
+     * @value head：作用于汉语字符串开头
+     */
+    surname?: SurnameMode;
+    /**
+     * @description 是否开启「一」和 「不」字的变调。默认开启。参考：https://zh.wiktionary.org/wiki/Appendix:%E2%80%9C%E4%B8%80%E2%80%9D%E5%8F%8A%E2%80%9C%E4%B8%8D%E2%80%9D%E7%9A%84%E5%8F%98%E8%B0%83
+     * @value true：开启
+     * @value false：不开启
+     */
+    toneSandhi?: boolean;
+    /**
+     * @description 要使用的分词算法。默认为逆向最大匹配分词
+     * @value 1：逆向最大匹配分词(速度最快，准确率适中)
+     * @value 2：最大概率分词(速度适中，准确率高)
+     * @value 2：最少分词数分词(速度适中，准确率高)
+     */
+    segmentit?: TokenizationAlgorithm;
+}
+interface AllData {
+    origin: string;
+    pinyin: string;
+    initial: string;
+    final: string;
+    num: number;
+    first: string;
+    finalHead: string;
+    finalBody: string;
+    finalTail: string;
+    isZh: boolean;
+    polyphonic: string[];
+    inZhRange: boolean;
+    result: string;
+}
+interface OptionsReturnString extends BasicOptions {
+    /**
+     * @description 返回结果的格式
+     * @value string：以字符串格式返回，拼音之间用空格隔开 （默认值）
+     * @value array：以数组格式返回
+     * @value array: 返回全部信息数组
+     */
+    type?: 'string';
+    /**
+     * @description 拼音之间的分隔符，默认为空格，仅在 type 为 'string' 时生效
+     */
+    separator?: string;
+}
+interface OptionsReturnArray extends BasicOptions {
+    /**
+     * @description 返回结果的格式
+     * @value string：以字符串格式返回，拼音之间用空格隔开 （默认值）
+     * @value array：以数组格式返回
+     * @value array: 返回全部信息数组
+     */
+    type: 'array';
+}
+interface OptionsReturnAll extends BasicOptions {
+    /**
+     * @description 返回结果的格式
+     * @value string：以字符串格式返回，拼音之间用空格隔开 （默认值）
+     * @value array：以数组格式返回
+     * @value array: 返回全部信息数组
+     */
+    type: 'all';
+}
+export interface CompleteOptions extends BasicOptions {
+    /**
+     * @description 返回结果的格式
+     * @value string：以字符串格式返回，拼音之间用空格隔开 （默认值）
+     * @value array：以数组格式返回
+     * @value array: 返回全部信息数组
+     */
+    type?: 'string' | 'array' | 'all';
+    /**
+     * @description 拼音之间的分隔符，默认为空格，仅在 type 为 'string' 时生效
+     */
+    separator?: string;
+}
+/**
+ * @description: 获取汉语字符串的拼音
+ * @param {string} word 要转换的汉语字符串
+ * @param {OptionsReturnString=} options 配置项
+ * @return {string | string[] | AllData[]} options.type 为 string 时，返回字符串，中间用空格隔开；为 array 时，返回拼音字符串数组；为 all 时返回全部信息的数组
+ */
+declare function pinyin(word: string, options?: OptionsReturnString): string;
+/**
+ * @description: 获取汉语字符串的拼音
+ * @param {string} word 要转换的汉语字符串
+ * @param {OptionsReturnArray=} options 配置项
+ * @return {string | string[] | AllData[]} options.type 为 string 时，返回字符串，中间用空格隔开；为 array 时，返回拼音字符串数组；为 all 时返回全部信息的数组
+ */
+declare function pinyin(word: string, options?: OptionsReturnArray): string[];
+/**
+ * @description: 获取汉语字符串的拼音
+ * @param {string} word 要转换的汉语字符串
+ * @param {OptionsReturnAll=} options 配置项
+ * @return {string | string[] | AllData[]} options.type 为 string 时，返回字符串，中间用空格隔开；为 array 时，返回拼音字符串数组；为 all 时返回全部信息的数组
+ */
+declare function pinyin(word: string, options?: OptionsReturnAll): AllData[];
+export { pinyin };