@jayfong/x-utils 1.0.0-202510061015 → 3.3.0

package/lib/text.d.mts

@@ -0,0 +1,84 @@
+export declare class XText {
+  private text;
+  /**
+   * 将字符串按“用户可见字符（grapheme）”分割为数组。
+   *
+   * 与 `text.split('')` 不同，这里会正确处理 Emoji、组合字符等场景，
+   * 例如 `👍🏽` 会被视为一个字符而不是多个 code unit。
+   *
+   * @see https://stackoverflow.com/a/71619350
+   */
+  static split(text: string): string[];
+  /**
+   * HTML 模板字符串辅助函数。
+   *
+   * 该方法不做任何转义，仅用于让书写 HTML 片段时有模板字符串提示。
+   * 若插值来自不可信输入，应在调用前自行做转义/清洗。
+   */
+  static html(literals: TemplateStringsArray, ...interpolations: unknown[]): string;
+  /**
+   * 提取 `start` 与 `end` 之间的内容。
+   *
+   * 规则：
+   * - 若 `start` 或 `end` 任一边界不存在，返回空字符串；
+   * - 仅提取从第一个 `start` 开始、到其后第一个 `end` 之前的内容；
+   * - 不包含边界本身。
+   */
+  static cut(text: string, start: string, end: string): string;
+  /**
+   * 移除全部空白字符（含空格、换行、制表符等）。
+   */
+  static stripWhitespace(text: string): string;
+  /**
+   * 移除首尾空白字符，保留中间内容。
+   */
+  static stripMarginWhitespace(text: string): string;
+  /**
+   * HTML 实体编码。
+   */
+  static encodeHtmlEntity(text: string): string;
+  /**
+   * HTML 实体解码。
+   */
+  static decodeHtmlEntity(text: string): string;
+  /**
+   * 移除 HTML 标签内容，包含 `script/style` 标签块。
+   *
+   * 注意：
+   * - 该方法面向轻量文本清洗，不是完整的 HTML 解析器；
+   * - 对复杂畸形 HTML 不能保证 100% 精确。
+   */
+  static stripHtml(text: string): string;
+  /**
+   * 创建一个可链式处理的文本实例。
+   */
+  constructor(text: string);
+  /**
+   * 链式版本：提取 `start` 与 `end` 之间的内容。
+   */
+  cut(start: string, end: string): this;
+  /**
+   * 链式版本：移除全部空白字符。
+   */
+  stripWhitespace(): this;
+  /**
+   * 链式版本：移除首尾空白字符。
+   */
+  stripMarginWhitespace(): this;
+  /**
+   * 链式版本：HTML 实体编码。
+   */
+  encodeHtmlEntity(): this;
+  /**
+   * 链式版本：HTML 实体解码。
+   */
+  decodeHtmlEntity(): this;
+  /**
+   * 链式版本：移除 HTML 代码。
+   */
+  stripHtml(): this;
+  /**
+   * 返回当前链式处理后的文本。
+   */
+  toString(): string;
+}

package/lib/text.mjs

@@ -0,0 +1,141 @@
+import { decode, encode } from "html-entities";
+// src/text.ts
+var XText = class XText {
+	text;
+	/**
+	* 将字符串按“用户可见字符（grapheme）”分割为数组。
+	*
+	* 与 `text.split('')` 不同，这里会正确处理 Emoji、组合字符等场景，
+	* 例如 `👍🏽` 会被视为一个字符而不是多个 code unit。
+	*
+	* @see https://stackoverflow.com/a/71619350
+	*/
+	static split(text) {
+		return [...new Intl.Segmenter().segment(text)].map((x) => x.segment);
+	}
+	/**
+	* HTML 模板字符串辅助函数。
+	*
+	* 该方法不做任何转义，仅用于让书写 HTML 片段时有模板字符串提示。
+	* 若插值来自不可信输入，应在调用前自行做转义/清洗。
+	*/
+	static html(literals, ...interpolations) {
+		let result = "";
+		for (let i = 0; i < interpolations.length; i++) {
+			result += literals[i];
+			result += interpolations[i];
+		}
+		result += literals[literals.length - 1];
+		return result;
+	}
+	/**
+	* 提取 `start` 与 `end` 之间的内容。
+	*
+	* 规则：
+	* - 若 `start` 或 `end` 任一边界不存在，返回空字符串；
+	* - 仅提取从第一个 `start` 开始、到其后第一个 `end` 之前的内容；
+	* - 不包含边界本身。
+	*/
+	static cut(text, start, end) {
+		const startIndex = text.indexOf(start);
+		if (startIndex < 0) return "";
+		const contentStartIndex = startIndex + start.length;
+		const endIndex = text.indexOf(end, contentStartIndex);
+		if (endIndex < 0) return "";
+		return text.slice(contentStartIndex, endIndex);
+	}
+	/**
+	* 移除全部空白字符（含空格、换行、制表符等）。
+	*/
+	static stripWhitespace(text) {
+		text = text.replace(/\s+/g, "");
+		return text;
+	}
+	/**
+	* 移除首尾空白字符，保留中间内容。
+	*/
+	static stripMarginWhitespace(text) {
+		text = text.trim();
+		return text;
+	}
+	/**
+	* HTML 实体编码。
+	*/
+	static encodeHtmlEntity(text) {
+		text = encode(text);
+		return text;
+	}
+	/**
+	* HTML 实体解码。
+	*/
+	static decodeHtmlEntity(text) {
+		text = decode(text);
+		return text;
+	}
+	/**
+	* 移除 HTML 标签内容，包含 `script/style` 标签块。
+	*
+	* 注意：
+	* - 该方法面向轻量文本清洗，不是完整的 HTML 解析器；
+	* - 对复杂畸形 HTML 不能保证 100% 精确。
+	*/
+	static stripHtml(text) {
+		text = text.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<\/?[^>]+>/g, "");
+		return text;
+	}
+	/**
+	* 创建一个可链式处理的文本实例。
+	*/
+	constructor(text) {
+		this.text = text;
+	}
+	/**
+	* 链式版本：提取 `start` 与 `end` 之间的内容。
+	*/
+	cut(start, end) {
+		this.text = XText.cut(this.text, start, end);
+		return this;
+	}
+	/**
+	* 链式版本：移除全部空白字符。
+	*/
+	stripWhitespace() {
+		this.text = XText.stripWhitespace(this.text);
+		return this;
+	}
+	/**
+	* 链式版本：移除首尾空白字符。
+	*/
+	stripMarginWhitespace() {
+		this.text = XText.stripMarginWhitespace(this.text);
+		return this;
+	}
+	/**
+	* 链式版本：HTML 实体编码。
+	*/
+	encodeHtmlEntity() {
+		this.text = XText.encodeHtmlEntity(this.text);
+		return this;
+	}
+	/**
+	* 链式版本：HTML 实体解码。
+	*/
+	decodeHtmlEntity() {
+		this.text = XText.decodeHtmlEntity(this.text);
+		return this;
+	}
+	/**
+	* 链式版本：移除 HTML 代码。
+	*/
+	stripHtml() {
+		this.text = XText.stripHtml(this.text);
+		return this;
+	}
+	/**
+	* 返回当前链式处理后的文本。
+	*/
+	toString() {
+		return this.text;
+	}
+};
+export { XText };

package/lib/yaml.d.mts

@@ -0,0 +1,51 @@
+/**
+ * 封装常用 YAML 文本处理逻辑，统一提供解析、序列化、文件读写入口。
+ *
+ * 设计目标：
+ * - 让调用方无需直接接触 `yaml` 依赖细节；
+ * - 统一使用 UTF-8 文本读取/写入；
+ * - 通过 `blockQuote: 'literal'` 保持多行文本块更稳定的输出格式，避免
+ *   长文本在 YAML 中被错误地折叠或渲染为普通单行字符串。
+ *
+ * 典型用法：
+ * - `const cfg = XYaml.parse<{ name: string }>(content)`
+ * - `await XYaml.write('/tmp/app.yaml', { name: 'demo' })`
+ */
+export declare class XYaml {
+  /**
+   * 解析 YAML 文本为目标类型。
+   *
+   * 适用场景包括配置文件、表单内容、轻量结构化描述等。由于 YAML 语法
+   * 允许解析为对象、数组、布尔值、数字、字符串等原始值，因此这里使用
+   * 泛型让调用方在类型层面明确期望值。
+   *
+   * 例子：
+   * ```ts
+   * const config = XYaml.parse<{ name: string; port: number }>(`\nname: demo\nport: 3000\n`);
+   * ```
+   */
+  static parse<T>(value: string): T;
+  /**
+   * 将任意值转换成 YAML 文本。
+   *
+   * 这里固定使用 `blockQuote: 'literal'`，这样当值中包含多行字符串时，
+   * 输出会优先采用 `|` 形式的 literal block，与普通单行折叠输出相比更
+   * 稳定，也更符合配置文件/说明文档场景的阅读习惯。
+   */
+  static stringify(value: unknown): string;
+  /**
+   * 读取 YAML 文件并立即解析为指定类型。
+   *
+   * 读取时使用 UTF-8 编码，适合配置文件、模板文件或脚本状态容器。若
+   * 文件为空，`yaml.parse` 可能返回 `null`，调用方需要按业务规则处理。
+   */
+  static read<T>(file: string): Promise<T>;
+  /**
+   * 将对象写入 YAML 文件。
+   *
+   * 这里不额外指定缩进或换行策略，使用 `stringify` 的统一默认行为；
+   * 一旦调用方传入 `undefined`，`yaml.stringify` 会输出空文档，调用方应在
+   * 业务层避免该情况，或在必要时进行显式校验。
+   */
+  static write(file: string, value: unknown): Promise<void>;
+}

package/lib/yaml.mjs

@@ -0,0 +1,64 @@
+import * as fs from "node:fs";
+import yaml from "yaml";
+// src/yaml.ts
+/**
+* 封装常用 YAML 文本处理逻辑，统一提供解析、序列化、文件读写入口。
+*
+* 设计目标：
+* - 让调用方无需直接接触 `yaml` 依赖细节；
+* - 统一使用 UTF-8 文本读取/写入；
+* - 通过 `blockQuote: 'literal'` 保持多行文本块更稳定的输出格式，避免
+*   长文本在 YAML 中被错误地折叠或渲染为普通单行字符串。
+*
+* 典型用法：
+* - `const cfg = XYaml.parse<{ name: string }>(content)`
+* - `await XYaml.write('/tmp/app.yaml', { name: 'demo' })`
+*/
+var XYaml = class XYaml {
+	/**
+	* 解析 YAML 文本为目标类型。
+	*
+	* 适用场景包括配置文件、表单内容、轻量结构化描述等。由于 YAML 语法
+	* 允许解析为对象、数组、布尔值、数字、字符串等原始值，因此这里使用
+	* 泛型让调用方在类型层面明确期望值。
+	*
+	* 例子：
+	* ```ts
+	* const config = XYaml.parse<{ name: string; port: number }>(`\nname: demo\nport: 3000\n`);
+	* ```
+	*/
+	static parse(value) {
+		return yaml.parse(value);
+	}
+	/**
+	* 将任意值转换成 YAML 文本。
+	*
+	* 这里固定使用 `blockQuote: 'literal'`，这样当值中包含多行字符串时，
+	* 输出会优先采用 `|` 形式的 literal block，与普通单行折叠输出相比更
+	* 稳定，也更符合配置文件/说明文档场景的阅读习惯。
+	*/
+	static stringify(value) {
+		return yaml.stringify(value, { blockQuote: "literal" });
+	}
+	/**
+	* 读取 YAML 文件并立即解析为指定类型。
+	*
+	* 读取时使用 UTF-8 编码，适合配置文件、模板文件或脚本状态容器。若
+	* 文件为空，`yaml.parse` 可能返回 `null`，调用方需要按业务规则处理。
+	*/
+	static async read(file) {
+		const value = await fs.promises.readFile(file, "utf8");
+		return XYaml.parse(value);
+	}
+	/**
+	* 将对象写入 YAML 文件。
+	*
+	* 这里不额外指定缩进或换行策略，使用 `stringify` 的统一默认行为；
+	* 一旦调用方传入 `undefined`，`yaml.stringify` 会输出空文档，调用方应在
+	* 业务层避免该情况，或在必要时进行显式校验。
+	*/
+	static async write(file, value) {
+		await fs.promises.writeFile(file, XYaml.stringify(value));
+	}
+};
+export { XYaml };

package/package.json

@@ -1,177 +1,63 @@
 {
   "name": "@jayfong/x-utils",
-  "description": "123456",
-  "version": "1.0.0-202510061015",
+  "version": "3.3.0",
+  "license": "ISC",
+  "sideEffects": false,
   "type": "module",
+  "files": [
+    "lib"
+  ],
   "dependencies": {
-    "vtils": "^4.115.0",
-    "@jayfong/x-request": "^2.35.2",
-    "cli-table3": "^0.6.3",
-    "inquirer": "^9.2.13",
-    "@types/inquirer": "^9.0.7",
-    "clipboardy": "^4.0.0",
-    "execa": "^8.0.1",
-    "sharp": "^0.32.5",
-    "node-html-parser": "^6.1.12",
-    "csv": "^6.3.6",
-    "exit-hook": "^4.0.0",
-    "fs-extra": "^11.2.0",
+    "@jayfong/x-request": "^3.3.0",
     "@types/fs-extra": "^11.0.4",
-    "dotenv": "^16.4.5",
-    "mime": "^4.0.3",
-    "probe-image-size": "^7.2.3",
-    "@types/probe-image-size": "^7.2.5",
-    "docx": "^8.5.0",
-    "image-dimensions": "^2.3.0",
-    "posthtml-parser": "^0.11.0",
-    "@fastify/cookie": "^9.4.0",
-    "@fastify/cors": "^9.0.1",
-    "fastify": "^4.26.0",
-    "nzh": "^1.0.12",
-    "pathe": "^1.1.2",
-    "pinyin-pro": "^3.19.4",
-    "consola": "^3.2.3",
-    "html-entities": "^2.5.2",
-    "file-type": "^19.0.0",
-    "yaml": "^2.3.4"
+    "change-case": "^5.4.4",
+    "cli-table3": "^0.6.5",
+    "clipboardy": "^5.3.2",
+    "consola": "^3.4.2",
+    "csv": "^6.6.4",
+    "exit-hook": "^5.1.0",
+    "fs-extra": "^11.4.1",
+    "html-entities": "^2.6.0",
+    "inquirer": "^14.3.0",
+    "mime": "^4.1.2",
+    "node-html-parser": "^9.0.7",
+    "pinyin-pro": "^3.26.0",
+    "vtils": "^4.138.0",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "puppeteer": "^25.17.0"
   },
   "peerDependencies": {
-    "puppeteer": "^22.3.0"
+    "puppeteer": "^25.17.0"
   },
-  "exports": {
-    "./package.json": "./package.json",
-    "./ai": {
-      "require": "./_cjs/ai.js",
-      "import": "./ai.js",
-      "types": "./ai.d.ts"
-    },
-    "./alipan": {
-      "require": "./_cjs/alipan.js",
-      "import": "./alipan.js",
-      "types": "./alipan.d.ts"
-    },
-    "./cli": {
-      "require": "./_cjs/cli.js",
-      "import": "./cli.js",
-      "types": "./cli.d.ts"
-    },
-    "./clipboard": {
-      "require": "./_cjs/clipboard.js",
-      "import": "./clipboard.js",
-      "types": "./clipboard.d.ts"
-    },
-    "./cmd": {
-      "require": "./_cjs/cmd.js",
-      "import": "./cmd.js",
-      "types": "./cmd.d.ts"
-    },
-    "./compressor": {
-      "require": "./_cjs/compressor.js",
-      "import": "./compressor.js",
-      "types": "./compressor.d.ts"
-    },
-    "./crawler": {
-      "require": "./_cjs/crawler.js",
-      "import": "./crawler.js",
-      "types": "./crawler.d.ts"
-    },
-    "./csv": {
-      "require": "./_cjs/csv.js",
-      "import": "./csv.js",
-      "types": "./csv.d.ts"
-    },
-    "./data_set": {
-      "require": "./_cjs/data_set.js",
-      "import": "./data_set.js",
-      "types": "./data_set.d.ts"
-    },
-    "./env": {
-      "require": "./_cjs/env.js",
-      "import": "./env.js",
-      "types": "./env.d.ts"
-    },
-    "./fs": {
-      "require": "./_cjs/fs.js",
-      "import": "./fs.js",
-      "types": "./fs.d.ts"
-    },
-    "./html": {
-      "require": "./_cjs/html.js",
-      "import": "./html.js",
-      "types": "./html.d.ts"
-    },
-    "./http_server": {
-      "require": "./_cjs/http_server.js",
-      "import": "./http_server.js",
-      "types": "./http_server.d.ts"
-    },
-    "./json": {
-      "require": "./_cjs/json.js",
-      "import": "./json.js",
-      "types": "./json.d.ts"
-    },
-    "./ksb": {
-      "require": "./_cjs/ksb.js",
-      "import": "./ksb.js",
-      "types": "./ksb.d.ts"
-    },
-    "./number": {
-      "require": "./_cjs/number.js",
-      "import": "./number.js",
-      "types": "./number.d.ts"
-    },
-    "./ocr": {
-      "require": "./_cjs/ocr.js",
-      "import": "./ocr.js",
-      "types": "./ocr.d.ts"
-    },
-    "./path": {
-      "require": "./_cjs/path.js",
-      "import": "./path.js",
-      "types": "./path.d.ts"
-    },
-    "./pinyin": {
-      "require": "./_cjs/pinyin.js",
-      "import": "./pinyin.js",
-      "types": "./pinyin.d.ts"
-    },
-    "./puppeteer": {
-      "require": "./_cjs/puppeteer.js",
-      "import": "./puppeteer.js",
-      "types": "./puppeteer.d.ts"
-    },
-    "./runner": {
-      "require": "./_cjs/runner.js",
-      "import": "./runner.js",
-      "types": "./runner.d.ts"
-    },
-    "./task": {
-      "require": "./_cjs/task.js",
-      "import": "./task.js",
-      "types": "./task.d.ts"
-    },
-    "./text": {
-      "require": "./_cjs/text.js",
-      "import": "./text.js",
-      "types": "./text.d.ts"
-    },
-    "./upload": {
-      "require": "./_cjs/upload.js",
-      "import": "./upload.js",
-      "types": "./upload.d.ts"
-    },
-    "./yaml": {
-      "require": "./_cjs/yaml.js",
-      "import": "./yaml.js",
-      "types": "./yaml.d.ts"
-    },
-    "./unicode": {
-      "require": "./_cjs/unicode/unicode.js",
-      "import": "./unicode/unicode.js",
-      "types": "./unicode/unicode.d.ts"
+  "peerDependenciesMeta": {
+    "puppeteer": {
+      "optional": true
     }
   },
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    "./case": "./lib/case.mjs",
+    "./chinese": "./lib/chinese.mjs",
+    "./cli": "./lib/cli.mjs",
+    "./clipboard": "./lib/clipboard.mjs",
+    "./cmd": "./lib/cmd.mjs",
+    "./crawler": "./lib/crawler.mjs",
+    "./csv": "./lib/csv.mjs",
+    "./data_set": "./lib/data_set.mjs",
+    "./fs": "./lib/fs.mjs",
+    "./json": "./lib/json.mjs",
+    "./puppeteer": "./lib/puppeteer.mjs",
+    "./runner": "./lib/runner.mjs",
+    "./task": "./lib/task.mjs",
+    "./text": "./lib/text.mjs",
+    "./yaml": "./lib/yaml.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown"
   }
-}
+}

package/_cjs/ai.js

@@ -1,80 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var ai_exports = {};
-__export(ai_exports, {
-  CozeAiProvider: () => CozeAiProvider,
-  XAi: () => XAi
-});
-module.exports = __toCommonJS(ai_exports);
-var import_vtils = require("vtils");
-var import_puppeteer = require("./puppeteer.js");
-class AiProvider {
-}
-class CozeAiProvider extends AiProvider {
-  constructor(options) {
-    super();
-    this.options = options;
-  }
-  xp;
-  page;
-  async prepare() {
-    this.xp = new import_puppeteer.XPuppeteer();
-    await this.xp.connectSystemBrowser();
-    this.page = await this.xp.openPage(this.options.botUrl);
-  }
-  async ask(question) {
-    const page = this.page;
-    await page.evaluate(
-      () => document.querySelector("textarea:not([placeholder])").parentElement.parentElement.previousElementSibling.firstElementChild.click()
-    );
-    await (0, import_vtils.wait)(300);
-    await this.page.type("textarea:not([placeholder])", question);
-    await (0, import_vtils.wait)(500);
-    await this.page.keyboard.press("Enter");
-    await (0, import_vtils.wait)(1e3);
-    await (0, import_vtils.loopUntil)(
-      () => page.$$eval(
-        "button",
-        (els) => !els.find((el) => el.textContent.includes("Stop Responding"))?.parentElement.getBoundingClientRect().height
-      ),
-      {
-        retryDelay: 300
-      }
-    );
-    await (0, import_vtils.wait)(300);
-    const code = await page.$$eval(
-      'div[class^="code-area"]',
-      (els) => els.pop().querySelector('[class^="content"]').textContent
-    );
-    return code;
-  }
-}
-class XAi {
-  constructor(options) {
-    this.options = options;
-    this.provider = options.provider;
-  }
-  provider;
-  prepare = (0, import_vtils.memoize)(() => this.provider.prepare());
-  async ask(question) {
-    await this.prepare();
-    const answer = await this.provider.ask(question);
-    return answer;
-  }
-}