@odinlin/utils 0.0.2 → 1.0.0

package/dist/node/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,29 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/node/array/arrayCast.cjs

@@ -0,0 +1,29 @@
+const require_isPrimitive = require('../is/isPrimitive.cjs');
+const require_isPrimitiveWithout = require('../is/isPrimitiveWithout.cjs');
+
+//#region src/array/arrayCast.ts
+/**
+* Converts a value to an array.
+*
+* @param {unknown} value - The value to convert.
+* @returns {any[]} Returns the converted array.
+*
+* @example
+* arrayCast(null) // => returns []
+* arrayCast(undefined) // => returns []
+* arrayCast(1) // => returns [1]
+* arrayCast([1, 2, 3]) // => returns [1, 2, 3]
+* arrayCast('a') // => returns ['a']
+* arrayCast(['a', 'b', 'c']) // => returns ['a', 'b', 'c']
+* arrayCast(true) // => returns [true]
+* arrayCast(false) // => returns [false]
+* arrayCast([true, false]) // => returns [true, false]
+* arrayCast({ a: '1' }) // => returns [{ a: '1' }]
+*/
+function arrayCast(value) {
+	if (require_isPrimitive.isNil(value)) return [];
+	return require_isPrimitiveWithout.isArray(value) ? Array.from(value) : [value];
+}
+
+//#endregion
+exports.arrayCast = arrayCast;

package/dist/node/array/arrayCast.d.ts

@@ -0,0 +1,27 @@
+//#region src/array/arrayCast.d.ts
+/**
+ * 函数 arrayCast 的返回值
+ */
+type ArrayCastReturn<T> = T extends Array<infer U> ? U[] : (T extends null | undefined ? any[] : T[]);
+/**
+ * Converts a value to an array.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {any[]} Returns the converted array.
+ *
+ * @example
+ * arrayCast(null) // => returns []
+ * arrayCast(undefined) // => returns []
+ * arrayCast(1) // => returns [1]
+ * arrayCast([1, 2, 3]) // => returns [1, 2, 3]
+ * arrayCast('a') // => returns ['a']
+ * arrayCast(['a', 'b', 'c']) // => returns ['a', 'b', 'c']
+ * arrayCast(true) // => returns [true]
+ * arrayCast(false) // => returns [false]
+ * arrayCast([true, false]) // => returns [true, false]
+ * arrayCast({ a: '1' }) // => returns [{ a: '1' }]
+ */
+declare function arrayCast<T>(value?: T): ArrayCastReturn<T>;
+//#endregion
+export { ArrayCastReturn, arrayCast };
+//# sourceMappingURL=arrayCast.d.ts.map

package/dist/node/array/arrayCast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayCast.d.ts","names":[],"sources":["../../../src/array/arrayCast.ts"],"sourcesContent":[],"mappings":";;AAKA;;AAA2C,KAA/B,eAA+B,CAAA,CAAA,CAAA,GAAV,CAAU,SAAA,KAAA,CAAA,KAAA,EAAA,CAAA,GAAiB,CAAjB,EAAA,GAAA,CAAwB,CAAxB,SAAA,IAAA,GAAA,SAAA,GAAA,GAAA,EAAA,GAA6D,CAA7D,EAAA,CAAA;;;;;AAoB3C;;;;;;;;;;;;;;iBAAgB,qBAAqB,IAAI,gBAAgB"}

package/dist/node/array/arrayCast.js

@@ -0,0 +1,30 @@
+import { isNil } from "../is/isPrimitive.js";
+import { isArray } from "../is/isPrimitiveWithout.js";
+
+//#region src/array/arrayCast.ts
+/**
+* Converts a value to an array.
+*
+* @param {unknown} value - The value to convert.
+* @returns {any[]} Returns the converted array.
+*
+* @example
+* arrayCast(null) // => returns []
+* arrayCast(undefined) // => returns []
+* arrayCast(1) // => returns [1]
+* arrayCast([1, 2, 3]) // => returns [1, 2, 3]
+* arrayCast('a') // => returns ['a']
+* arrayCast(['a', 'b', 'c']) // => returns ['a', 'b', 'c']
+* arrayCast(true) // => returns [true]
+* arrayCast(false) // => returns [false]
+* arrayCast([true, false]) // => returns [true, false]
+* arrayCast({ a: '1' }) // => returns [{ a: '1' }]
+*/
+function arrayCast(value) {
+	if (isNil(value)) return [];
+	return isArray(value) ? Array.from(value) : [value];
+}
+
+//#endregion
+export { arrayCast };
+//# sourceMappingURL=arrayCast.js.map

package/dist/node/array/arrayCast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayCast.js","names":[],"sources":["../../../src/array/arrayCast.ts"],"sourcesContent":["import { isArray, isNil } from '../is'\n\n/**\n * 函数 arrayCast 的返回值\n */\nexport type ArrayCastReturn<T> = T extends Array<infer U> ? U[] : (T extends null | undefined ? any[] : T[])\n\n/**\n * Converts a value to an array.\n *\n * @param {unknown} value - The value to convert.\n * @returns {any[]} Returns the converted array.\n *\n * @example\n * arrayCast(null) // => returns []\n * arrayCast(undefined) // => returns []\n * arrayCast(1) // => returns [1]\n * arrayCast([1, 2, 3]) // => returns [1, 2, 3]\n * arrayCast('a') // => returns ['a']\n * arrayCast(['a', 'b', 'c']) // => returns ['a', 'b', 'c']\n * arrayCast(true) // => returns [true]\n * arrayCast(false) // => returns [false]\n * arrayCast([true, false]) // => returns [true, false]\n * arrayCast({ a: '1' }) // => returns [{ a: '1' }]\n */\nexport function arrayCast<T>(value?: T): ArrayCastReturn<T> {\n  if (isNil(value)) return ([] as unknown as ArrayCastReturn<T>)\n  return (isArray(value) ? Array.from(value) : [value]) as ArrayCastReturn<T>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,UAAa,OAA+B;AAC1D,KAAI,MAAM,MAAM,CAAE,QAAQ,EAAE;AAC5B,QAAQ,QAAQ,MAAM,GAAG,MAAM,KAAK,MAAM,GAAG,CAAC,MAAM"}

package/dist/node/array/index.cjs

@@ -0,0 +1,3 @@
+const require_arrayCast = require('./arrayCast.cjs');
+
+exports.arrayCast = require_arrayCast.arrayCast;

package/dist/node/array/index.d.ts

@@ -0,0 +1,2 @@
+import { ArrayCastReturn, arrayCast } from "./arrayCast.js";
+export { ArrayCastReturn, arrayCast };

package/dist/node/array/index.js

@@ -0,0 +1,3 @@
+import { arrayCast } from "./arrayCast.js";
+
+export { arrayCast };

package/dist/node/constants/index.cjs

@@ -0,0 +1,19 @@
+
+//#region src/constants/index.ts
+/**
+* 空对象
+*/
+const CONSTANT_EMPTY_ARRAY = [];
+/**
+* 空数组
+*/
+const CONSTANT_EMPTY_OBJECT = {};
+/**
+* 空函数
+*/
+function CONSTANT_NOOP() {}
+
+//#endregion
+exports.CONSTANT_EMPTY_ARRAY = CONSTANT_EMPTY_ARRAY;
+exports.CONSTANT_EMPTY_OBJECT = CONSTANT_EMPTY_OBJECT;
+exports.CONSTANT_NOOP = CONSTANT_NOOP;

package/dist/node/constants/index.d.ts

@@ -0,0 +1,16 @@
+//#region src/constants/index.d.ts
+/**
+ * 空对象
+ */
+declare const CONSTANT_EMPTY_ARRAY: never[];
+/**
+ * 空数组
+ */
+declare const CONSTANT_EMPTY_OBJECT: {};
+/**
+ * 空函数
+ */
+declare function CONSTANT_NOOP(): void;
+//#endregion
+export { CONSTANT_EMPTY_ARRAY, CONSTANT_EMPTY_OBJECT, CONSTANT_NOOP };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/constants/index.ts"],"sourcesContent":[],"mappings":";;AAGA;AAKA;AAKgB,cAVH,oBAUgB,EAAA,KAAA,EAAA;;;;cALhB;;;;iBAKG,aAAA,CAAA"}

package/dist/node/constants/index.js

@@ -0,0 +1,17 @@
+//#region src/constants/index.ts
+/**
+* 空对象
+*/
+const CONSTANT_EMPTY_ARRAY = [];
+/**
+* 空数组
+*/
+const CONSTANT_EMPTY_OBJECT = {};
+/**
+* 空函数
+*/
+function CONSTANT_NOOP() {}
+
+//#endregion
+export { CONSTANT_EMPTY_ARRAY, CONSTANT_EMPTY_OBJECT, CONSTANT_NOOP };
+//# sourceMappingURL=index.js.map

package/dist/node/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/constants/index.ts"],"sourcesContent":["/**\n * 空对象\n */\nexport const CONSTANT_EMPTY_ARRAY = []\n\n/**\n * 空数组\n */\nexport const CONSTANT_EMPTY_OBJECT = {}\n\n/**\n * 空函数\n */\nexport function CONSTANT_NOOP(): void { }\n"],"mappings":";;;;AAGA,MAAa,uBAAuB,EAAE;;;;AAKtC,MAAa,wBAAwB,EAAE;;;;AAKvC,SAAgB,gBAAsB"}

package/dist/node/date/index.cjs

@@ -0,0 +1,8 @@
+const require_prettyMs = require('./prettyMs.cjs');
+const require_timeAgo = require('./timeAgo.cjs');
+
+exports.datePrettyMs = require_prettyMs.datePrettyMs;
+exports.dateTimeAgoFormat = require_timeAgo.dateTimeAgoFormat;
+exports.dateTimeAgoLocale = require_timeAgo.dateTimeAgoLocale;
+exports.dateTimeAgoRender = require_timeAgo.dateTimeAgoRender;
+exports.dateTimeAgoRenderCancel = require_timeAgo.dateTimeAgoRenderCancel;

package/dist/node/date/index.d.ts

@@ -0,0 +1,3 @@
+import { DatePrettyMsOptions, datePrettyMs } from "./prettyMs.js";
+import { DateTimeAgoLocaleFunc, DateTimeAgoLocaleMap, DateTimeAgoOpts, DateTimeAgoTDate, DateTimeAgoTimerPool, dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel } from "./timeAgo.js";
+export { DatePrettyMsOptions, DateTimeAgoLocaleFunc, DateTimeAgoLocaleMap, DateTimeAgoOpts, DateTimeAgoTDate, DateTimeAgoTimerPool, datePrettyMs, dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel };

package/dist/node/date/index.js

@@ -0,0 +1,4 @@
+import { datePrettyMs } from "./prettyMs.js";
+import { dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel } from "./timeAgo.js";
+
+export { datePrettyMs, dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel };

package/dist/node/date/prettyMs.cjs

@@ -0,0 +1,9 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let pretty_ms = require("pretty-ms");
+pretty_ms = require_rolldown_runtime.__toESM(pretty_ms);
+
+//#region src/date/prettyMs.ts
+const datePrettyMs = pretty_ms.default;
+
+//#endregion
+exports.datePrettyMs = datePrettyMs;

package/dist/node/date/prettyMs.d.ts

@@ -0,0 +1,8 @@
+import prettyMs, { Options } from "pretty-ms";
+
+//#region src/date/prettyMs.d.ts
+type DatePrettyMsOptions = Options;
+declare const datePrettyMs: typeof prettyMs;
+//#endregion
+export { DatePrettyMsOptions, datePrettyMs };
+//# sourceMappingURL=prettyMs.d.ts.map

package/dist/node/date/prettyMs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettyMs.d.ts","names":[],"sources":["../../../src/date/prettyMs.ts"],"sourcesContent":[],"mappings":";;;KAGY,mBAAA,GAAsB;AAAtB,cAEC,YAFkB,EAAA,OAEN,QAFgB"}

package/dist/node/date/prettyMs.js

@@ -0,0 +1,8 @@
+import prettyMs from "pretty-ms";
+
+//#region src/date/prettyMs.ts
+const datePrettyMs = prettyMs;
+
+//#endregion
+export { datePrettyMs };
+//# sourceMappingURL=prettyMs.js.map

package/dist/node/date/prettyMs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettyMs.js","names":[],"sources":["../../../src/date/prettyMs.ts"],"sourcesContent":["import type { Options } from 'pretty-ms'\nimport prettyMs from 'pretty-ms'\n\nexport type DatePrettyMsOptions = Options\n\nexport const datePrettyMs = prettyMs\n"],"mappings":";;;AAKA,MAAa,eAAe"}

package/dist/node/date/timeAgo.cjs

@@ -0,0 +1,14 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let timeago_js = require("timeago.js");
+
+//#region src/date/timeAgo.ts
+const dateTimeAgoFormat = timeago_js.format;
+const dateTimeAgoRender = timeago_js.render;
+const dateTimeAgoRenderCancel = timeago_js.cancel;
+const dateTimeAgoLocale = timeago_js.register;
+
+//#endregion
+exports.dateTimeAgoFormat = dateTimeAgoFormat;
+exports.dateTimeAgoLocale = dateTimeAgoLocale;
+exports.dateTimeAgoRender = dateTimeAgoRender;
+exports.dateTimeAgoRenderCancel = dateTimeAgoRenderCancel;

package/dist/node/date/timeAgo.d.ts

@@ -0,0 +1,15 @@
+import { LocaleFunc, LocaleMap, Opts, TDate, TimerPool, cancel, render } from "timeago.js";
+
+//#region src/date/timeAgo.d.ts
+type DateTimeAgoLocaleFunc = LocaleFunc;
+type DateTimeAgoLocaleMap = LocaleMap;
+type DateTimeAgoOpts = Opts;
+type DateTimeAgoTDate = TDate;
+type DateTimeAgoTimerPool = TimerPool;
+declare const dateTimeAgoFormat: (date: TDate, locale?: string, opts?: Opts) => string;
+declare const dateTimeAgoRender: typeof render;
+declare const dateTimeAgoRenderCancel: typeof cancel;
+declare const dateTimeAgoLocale: (locale: string, func: LocaleFunc) => void;
+//#endregion
+export { DateTimeAgoLocaleFunc, DateTimeAgoLocaleMap, DateTimeAgoOpts, DateTimeAgoTDate, DateTimeAgoTimerPool, dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel };
+//# sourceMappingURL=timeAgo.d.ts.map

package/dist/node/date/timeAgo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.d.ts","names":[],"sources":["../../../src/date/timeAgo.ts"],"sourcesContent":[],"mappings":";;;KAGY,qBAAA,GAAwB;AAAxB,KACA,oBAAA,GAAuB,SADC;AACxB,KACA,eAAA,GAAkB,IADE;AACpB,KACA,gBAAA,GAAmB,KADD;AAClB,KACA,oBAAA,GAAuB,SADC;AACxB,cAEC,iBAFmB,EAAG,CAAA,IAAA,EAEL,KAFc,EAAA,MAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAEd,IAFc,EAAA,GAAA,MAAA;AAE/B,cACA,iBADiB,EAAA,OACA,MADA;AACjB,cACA,uBAD0B,EAAA,OACH,MADG;AAC1B,cACA,iBADgC,EAAA,CAAA,MAAT,EAAA,MAAS,EAAA,IAAA,EACf,UADe,EAAA,GAAA,IAAA"}

package/dist/node/date/timeAgo.js

@@ -0,0 +1,11 @@
+import { cancel, format, register, render } from "timeago.js";
+
+//#region src/date/timeAgo.ts
+const dateTimeAgoFormat = format;
+const dateTimeAgoRender = render;
+const dateTimeAgoRenderCancel = cancel;
+const dateTimeAgoLocale = register;
+
+//#endregion
+export { dateTimeAgoFormat, dateTimeAgoLocale, dateTimeAgoRender, dateTimeAgoRenderCancel };
+//# sourceMappingURL=timeAgo.js.map

package/dist/node/date/timeAgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.js","names":[],"sources":["../../../src/date/timeAgo.ts"],"sourcesContent":["import type { LocaleFunc, LocaleMap, Opts, TDate, TimerPool } from 'timeago.js'\nimport { cancel, format, register, render } from 'timeago.js'\n\nexport type DateTimeAgoLocaleFunc = LocaleFunc\nexport type DateTimeAgoLocaleMap = LocaleMap\nexport type DateTimeAgoOpts = Opts\nexport type DateTimeAgoTDate = TDate\nexport type DateTimeAgoTimerPool = TimerPool\n\nexport const dateTimeAgoFormat = format\nexport const dateTimeAgoRender = render\nexport const dateTimeAgoRenderCancel = cancel\nexport const dateTimeAgoLocale = register\n"],"mappings":";;;AASA,MAAa,oBAAoB;AACjC,MAAa,oBAAoB;AACjC,MAAa,0BAA0B;AACvC,MAAa,oBAAoB"}

package/dist/node/file/fileBuffer.node.cjs

@@ -0,0 +1,115 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let es_toolkit = require("es-toolkit");
+let node_buffer = require("node:buffer");
+
+//#region src/file/fileBuffer.node.ts
+/**
+* 仅涉及到 Buffer/TypedArray/ArrayBuffer/String/Blob 之间的转换，不涉及修改操作
+* From:
+*  Buffer/TypedArray/ArrayBuffer/String/Blob -> Buffer
+* To:
+*  Buffer -> ArrayBuffer -> Blob -> File/ObjectURL
+*  Buffer -> ArrayBuffer -> TypedArray
+*  Buffer -> String
+* 参考转化关系：
+*  typedArray
+*    ⬇️ typedArray.buffer <=> new Uint8Array/DataView(buffer)
+*  ArrayBuffer
+*    ⬇️ new Blob([buffer], { type: mimeType }) <=> await blob.arrayBuffer()
+*  Blob
+*    ⬇️ new File([blob], 'filename', { type: blob.type }) <=> file.slice(0, file.size, file.type)
+*    ⬇️ URL.createObjectURL(blob)
+*  File/ObjectURL
+*/
+var FileBuffer = class FileBuffer {
+	#buf;
+	/**
+	* 判断 TypedArray 类型的类型谓词
+	* @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+	* @param {unknown} x 待检测值
+	*/
+	static isTypedArray(x) {
+		return (0, es_toolkit.isTypedArray)(x);
+	}
+	/**
+	* 判断 TypedArray 类型的类型谓词
+	* @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+	* @param {unknown} x 待检测值
+	*/
+	static isDataView(x) {
+		return x instanceof DataView;
+	}
+	/**
+	* 判断 ArrayBuffer 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isArrayBuffer(x) {
+		return (0, es_toolkit.isArrayBuffer)(x);
+	}
+	/**
+	* 判断 Buffer 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isBuffer(x) {
+		return typeof node_buffer.Buffer !== "undefined" && node_buffer.Buffer.isBuffer(x);
+	}
+	/**
+	* 判断 Blob 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isBlob(x) {
+		return (0, es_toolkit.isBlob)(x);
+	}
+	/**
+	* 判断 File 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isFile(x) {
+		return (0, es_toolkit.isFile)(x);
+	}
+	constructor(...args) {
+		if (new.target === FileBuffer) throw new Error("请使用静态方法 fromXXX 创建实例");
+		this.#buf = node_buffer.Buffer.from(...args);
+	}
+	/** Buffer -> Buffer ➡️ 新创建的 Buffer 与原 Buffer 共享相同的数据但修改互不影响 */
+	static fromBuffer(buffer) {
+		return new class extends FileBuffer {}(buffer);
+	}
+	toBuffer() {
+		return node_buffer.Buffer.from(this.#buf);
+	}
+	/** Buffer -> ArrayBuffer ➡️ 可指定区间；修改 Buffer 会直接修改 ArrayBuffer 的内容 */
+	static fromArrayBuffer(arrayBuffer, byteOffset, length) {
+		return new class extends FileBuffer {}(arrayBuffer, byteOffset, length);
+	}
+	toArrayBuffer() {
+		const begin = this.#buf.byteOffset;
+		const end = begin + this.#buf.length;
+		return this.#buf.buffer.slice(begin, end);
+	}
+	/** Buffer -> ArrayBuffer -> TypedArray ➡️ 修改 Buffer 会直接修改 TypedArray 的内容 */
+	static fromUint8Array(uint8Array) {
+		return new class extends FileBuffer {}(uint8Array);
+	}
+	toUint8Array() {
+		return new Uint8Array(this.toArrayBuffer());
+	}
+	/** Buffer -> ArrayBuffer -> Blob -> File/ObjectURL ➡️ 异步 + 参数指定 MIME 类型 */
+	static async fromBlob(blob) {
+		const arrayBuffer = await blob.arrayBuffer();
+		return new class extends FileBuffer {}(arrayBuffer);
+	}
+	toBlob(options) {
+		return new Blob([this.toArrayBuffer()], options);
+	}
+	/** Buffer -> String ➡️ 无需手动通过 Blob 和 FileReader 转换， Buffer.toString() 已实现 */
+	static fromString(str, encoding) {
+		return new class extends FileBuffer {}(str, encoding);
+	}
+	toString(encoding) {
+		return this.#buf.toString(encoding);
+	}
+};
+
+//#endregion
+exports.FileBuffer = FileBuffer;

package/dist/node/file/fileBuffer.node.d.ts

@@ -0,0 +1,88 @@
+import { FileBlobOptions, FileBufferEncoding } from "./interface.js";
+import { TypeTypedArray } from "../is/isPrimitiveWithout.js";
+import { Buffer } from "node:buffer";
+
+//#region src/file/fileBuffer.node.d.ts
+
+/**
+ * 仅涉及到 Buffer/TypedArray/ArrayBuffer/String/Blob 之间的转换，不涉及修改操作
+ * From:
+ *  Buffer/TypedArray/ArrayBuffer/String/Blob -> Buffer
+ * To:
+ *  Buffer -> ArrayBuffer -> Blob -> File/ObjectURL
+ *  Buffer -> ArrayBuffer -> TypedArray
+ *  Buffer -> String
+ * 参考转化关系：
+ *  typedArray
+ *    ⬇️ typedArray.buffer <=> new Uint8Array/DataView(buffer)
+ *  ArrayBuffer
+ *    ⬇️ new Blob([buffer], { type: mimeType }) <=> await blob.arrayBuffer()
+ *  Blob
+ *    ⬇️ new File([blob], 'filename', { type: blob.type }) <=> file.slice(0, file.size, file.type)
+ *    ⬇️ URL.createObjectURL(blob)
+ *  File/ObjectURL
+ */
+declare class FileBuffer {
+  #private;
+  /**
+   * 判断 TypedArray 类型的类型谓词
+   * @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+   * @param {unknown} x 待检测值
+   */
+  static isTypedArray(x: unknown): x is TypeTypedArray;
+  /**
+   * 判断 TypedArray 类型的类型谓词
+   * @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+   * @param {unknown} x 待检测值
+   */
+  static isDataView(x: unknown): x is DataView;
+  /**
+   * 判断 ArrayBuffer 类型的类型谓词
+   * @param {unknown} x 待检测值
+   */
+  static isArrayBuffer(x: unknown): x is ArrayBuffer;
+  /**
+   * 判断 Buffer 类型的类型谓词
+   * @param {unknown} x 待检测值
+   */
+  static isBuffer(x: unknown): x is Buffer;
+  /**
+   * 判断 Blob 类型的类型谓词
+   * @param {unknown} x 待检测值
+   */
+  static isBlob(x: unknown): x is Blob;
+  /**
+   * 判断 File 类型的类型谓词
+   * @param {unknown} x 待检测值
+   */
+  static isFile(x: unknown): x is File;
+  constructor(...args: any[]);
+  /*************************************************************************/
+  /** Buffer -> Buffer ➡️ 新创建的 Buffer 与原 Buffer 共享相同的数据但修改互不影响 */
+  /*************************************************************************/
+  static fromBuffer(buffer: Buffer): FileBuffer;
+  toBuffer(): Uint8Array;
+  /***********************************************************************************/
+  /** Buffer -> ArrayBuffer ➡️ 可指定区间；修改 Buffer 会直接修改 ArrayBuffer 的内容 */
+  /***********************************************************************************/
+  static fromArrayBuffer(arrayBuffer: ArrayBuffer, byteOffset?: number, length?: number): FileBuffer;
+  toArrayBuffer(): ArrayBuffer;
+  /***********************************************************************************/
+  /** Buffer -> ArrayBuffer -> TypedArray ➡️ 修改 Buffer 会直接修改 TypedArray 的内容 */
+  /***********************************************************************************/
+  static fromUint8Array(uint8Array: Uint8Array): FileBuffer;
+  toUint8Array(): Uint8Array;
+  /***********************************************************************************/
+  /** Buffer -> ArrayBuffer -> Blob -> File/ObjectURL ➡️ 异步 + 参数指定 MIME 类型 */
+  /***********************************************************************************/
+  static fromBlob(blob: Blob): Promise<FileBuffer>;
+  toBlob(options?: FileBlobOptions): Blob;
+  /***********************************************************************************/
+  /** Buffer -> String ➡️ 无需手动通过 Blob 和 FileReader 转换， Buffer.toString() 已实现 */
+  /***********************************************************************************/
+  static fromString(str: string, encoding?: string): FileBuffer;
+  toString(encoding?: FileBufferEncoding): string;
+}
+//#endregion
+export { FileBuffer };
+//# sourceMappingURL=fileBuffer.node.d.ts.map

package/dist/node/file/fileBuffer.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileBuffer.node.d.ts","names":[],"sources":["../../../src/file/fileBuffer.node.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA8BA;;;;;;;;;;;;;;;;AAyG8B,cAzGjB,UAAA,CAyGiB;EAAe,CAAA,OAAA;EAAR;;;;;EAiBG,OAAA,YAAA,CAAA,CAAA,EAAA,OAAA,CAAA,EAAA,CAAA,IAlHA,cAkHA;;;;;;sCAzGF;;;;;yCAQG;;;;;oCAQL;;;;;kCAQF;;;;;kCAQA;;;;;4BAgBN,SAAS;cAIvB;;;;sCAQwB,oDAAoD;mBAIvE;;;;oCAYiB,aAAa;kBAI/B;;;;wBAQY,OAAO,QAAQ;mBAK1B,kBAAkB;;;;qDAQgB;sBAI/B"}

package/dist/node/file/fileBuffer.node.js

@@ -0,0 +1,115 @@
+import { isArrayBuffer, isBlob, isFile, isTypedArray } from "es-toolkit";
+import { Buffer } from "node:buffer";
+
+//#region src/file/fileBuffer.node.ts
+/**
+* 仅涉及到 Buffer/TypedArray/ArrayBuffer/String/Blob 之间的转换，不涉及修改操作
+* From:
+*  Buffer/TypedArray/ArrayBuffer/String/Blob -> Buffer
+* To:
+*  Buffer -> ArrayBuffer -> Blob -> File/ObjectURL
+*  Buffer -> ArrayBuffer -> TypedArray
+*  Buffer -> String
+* 参考转化关系：
+*  typedArray
+*    ⬇️ typedArray.buffer <=> new Uint8Array/DataView(buffer)
+*  ArrayBuffer
+*    ⬇️ new Blob([buffer], { type: mimeType }) <=> await blob.arrayBuffer()
+*  Blob
+*    ⬇️ new File([blob], 'filename', { type: blob.type }) <=> file.slice(0, file.size, file.type)
+*    ⬇️ URL.createObjectURL(blob)
+*  File/ObjectURL
+*/
+var FileBuffer = class FileBuffer {
+	#buf;
+	/**
+	* 判断 TypedArray 类型的类型谓词
+	* @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+	* @param {unknown} x 待检测值
+	*/
+	static isTypedArray(x) {
+		return isTypedArray(x);
+	}
+	/**
+	* 判断 TypedArray 类型的类型谓词
+	* @description 通过 ArrayBuffer.isView 判断是否为视图，并排除 DataView 类型
+	* @param {unknown} x 待检测值
+	*/
+	static isDataView(x) {
+		return x instanceof DataView;
+	}
+	/**
+	* 判断 ArrayBuffer 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isArrayBuffer(x) {
+		return isArrayBuffer(x);
+	}
+	/**
+	* 判断 Buffer 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isBuffer(x) {
+		return typeof Buffer !== "undefined" && Buffer.isBuffer(x);
+	}
+	/**
+	* 判断 Blob 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isBlob(x) {
+		return isBlob(x);
+	}
+	/**
+	* 判断 File 类型的类型谓词
+	* @param {unknown} x 待检测值
+	*/
+	static isFile(x) {
+		return isFile(x);
+	}
+	constructor(...args) {
+		if (new.target === FileBuffer) throw new Error("请使用静态方法 fromXXX 创建实例");
+		this.#buf = Buffer.from(...args);
+	}
+	/** Buffer -> Buffer ➡️ 新创建的 Buffer 与原 Buffer 共享相同的数据但修改互不影响 */
+	static fromBuffer(buffer) {
+		return new class extends FileBuffer {}(buffer);
+	}
+	toBuffer() {
+		return Buffer.from(this.#buf);
+	}
+	/** Buffer -> ArrayBuffer ➡️ 可指定区间；修改 Buffer 会直接修改 ArrayBuffer 的内容 */
+	static fromArrayBuffer(arrayBuffer, byteOffset, length) {
+		return new class extends FileBuffer {}(arrayBuffer, byteOffset, length);
+	}
+	toArrayBuffer() {
+		const begin = this.#buf.byteOffset;
+		const end = begin + this.#buf.length;
+		return this.#buf.buffer.slice(begin, end);
+	}
+	/** Buffer -> ArrayBuffer -> TypedArray ➡️ 修改 Buffer 会直接修改 TypedArray 的内容 */
+	static fromUint8Array(uint8Array) {
+		return new class extends FileBuffer {}(uint8Array);
+	}
+	toUint8Array() {
+		return new Uint8Array(this.toArrayBuffer());
+	}
+	/** Buffer -> ArrayBuffer -> Blob -> File/ObjectURL ➡️ 异步 + 参数指定 MIME 类型 */
+	static async fromBlob(blob) {
+		const arrayBuffer = await blob.arrayBuffer();
+		return new class extends FileBuffer {}(arrayBuffer);
+	}
+	toBlob(options) {
+		return new Blob([this.toArrayBuffer()], options);
+	}
+	/** Buffer -> String ➡️ 无需手动通过 Blob 和 FileReader 转换， Buffer.toString() 已实现 */
+	static fromString(str, encoding) {
+		return new class extends FileBuffer {}(str, encoding);
+	}
+	toString(encoding) {
+		return this.#buf.toString(encoding);
+	}
+};
+
+//#endregion
+export { FileBuffer };
+//# sourceMappingURL=fileBuffer.node.js.map