@greypan/js-kit 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,38 @@
+
+> @greypan/js-kit@1.0.0 build /Users/bopan/VibeCoding/mono/packages/js-kit
+> run-p type-check "build-only {@}" --
+
+
+> @greypan/js-kit@1.0.0 build-only /Users/bopan/VibeCoding/mono/packages/js-kit
+> vp build
+
+
+> @greypan/js-kit@1.0.0 type-check /Users/bopan/VibeCoding/mono/packages/js-kit
+> vue-tsc --build
+
+vite v8.1.2 building client environment for production...
+
+rendering chunks...
+
+[unplugin:dts] Start generate declaration files...
+[unplugin:dts] Declaration files built in 684ms.
+
+computing gzip size...
+dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/isNullish.js                  0.20 kB │ gzip: 0.16 kB │ map: 0.35 kB
+dist/_virtual/_rolldown/runtime.js                                                           0.26 kB │ gzip: 0.22 kB
+dist/plugin/core.js                                                                          0.29 kB │ gzip: 0.19 kB │ map: 1.36 kB
+dist/number/index.js                                                                         0.30 kB │ gzip: 0.22 kB │ map: 1.07 kB
+dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/lazyDataLastImpl--3B10z3s.js  0.31 kB │ gzip: 0.24 kB │ map: 0.56 kB
+dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/omitBy.js                     0.35 kB │ gzip: 0.25 kB │ map: 0.64 kB
+dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/purry.js                      0.37 kB │ gzip: 0.27 kB │ map: 0.62 kB
+dist/random/index.js                                                                         0.49 kB │ gzip: 0.27 kB │ map: 1.59 kB
+dist/paradigm/rust.js                                                                        0.67 kB │ gzip: 0.37 kB │ map: 1.81 kB
+dist/paradigm/go.js                                                                          0.69 kB │ gzip: 0.38 kB │ map: 1.55 kB
+dist/plugin/batching-emitter.js                                                              0.75 kB │ gzip: 0.43 kB │ map: 2.41 kB
+dist/timer/controllable-interval.js                                                          0.83 kB │ gzip: 0.42 kB │ map: 3.24 kB
+dist/timer/debounce.js                                                                       0.88 kB │ gzip: 0.50 kB │ map: 3.59 kB
+dist/index.js                                                                                0.91 kB │ gzip: 0.36 kB
+dist/url/index.js                                                                            0.95 kB │ gzip: 0.56 kB │ map: 2.17 kB
+dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/funnel.js                     1.23 kB │ gzip: 0.57 kB │ map: 2.10 kB
+
+✓ built in 741ms

package/.turbo/turbo-test.log

@@ -0,0 +1,87 @@
+
+> @mono/js-kit@1.0.0 test /Users/bopan/VibeCoding/mono/packages/js-kit
+> vp test run
+
+[?25l
+ RUN  v4.1.9 /Users/bopan/VibeCoding/mono/packages/js-kit
+
+[?2026h
+ ❯ src/plugin/__tests__/batch-emitter.spec.ts [queued]
+
+ Test Files 0 passed (10)
+      Tests 0 passed (0)
+   Start at 22:41:27
+   Duration 329ms
+[?2026l[?2026h
+ ❯ src/paradigm/__tests__/rust.spec.ts [queued]
+ ❯ src/plugin/__tests__/batch-emitter.spec.ts [queued]
+ ❯ src/plugin/__tests__/core.spec.ts [queued]
+ ❯ src/plugin/__tests__/event-emiiter.spec.ts [queued]
+ ❯ src/random/__tests__/random.spec.ts [queued]
+
+ Test Files 0 passed (10)
+      Tests 0 passed (0)
+   Start at 22:41:27
+   Duration 537ms
+[?2026l[?2026h ✓ src/paradigm/__tests__/rust.spec.ts (9 tests) 14ms
+ ✓ src/random/__tests__/random.spec.ts (7 tests) 16ms
+stdout | src/plugin/__tests__/event-emiiter.spec.ts > EventEmitter 单元测试 > 应当支持注册和触发事件回调
+Tom click 1
+Tom click 2
+
+ ✓ src/plugin/__tests__/event-emiiter.spec.ts (2 tests) 6ms
+stdout | src/plugin/__tests__/core.spec.ts > definePlugin 单元测试 > use > 应当正确组合 Store, Logger 和 Persist 逻辑
+set a = 100.
+
+
+ ❯ src/plugin/__tests__/batch-emitter.spec.ts 1/4
+ ❯ src/plugin/__tests__/core.spec.ts 0/3
+ ❯ src/plugin/__tests__/event-emiiter.spec.ts 2/2
+ ❯ src/random/__tests__/random.spec.ts 7/7
+ ❯ src/timer/__tests__/controllable-interval.spec.ts [queued]
+ ❯ src/url/__tests__/url.spec.ts [queued]
+
+ Test Files 3 passed (10)
+      Tests 19 passed (25)
+   Start at 22:41:27
+   Duration 638ms
+[?2026l[?2026h ✓ src/plugin/__tests__/batch-emitter.spec.ts (4 tests) 20ms
+ ✓ src/plugin/__tests__/core.spec.ts (3 tests) 40ms
+
+ ❯ src/plugin/__tests__/event-emiiter.spec.ts 2/2
+ ❯ src/random/__tests__/random.spec.ts 7/7
+ ❯ src/timer/__tests__/controllable-interval.spec.ts [queued]
+ ❯ src/url/__tests__/url.spec.ts 0/12
+
+ Test Files 5 passed (10)
+      Tests 25 passed (37)
+   Start at 22:41:27
+   Duration 914ms
+[?2026l[?2026h ✓ src/url/__tests__/url.spec.ts (12 tests) 8ms
+
+ ❯ src/fetch/__tests__/compose.spec.ts [queued]
+ ❯ src/number/__tests__/number.spec.ts 0/8
+ ❯ src/timer/__tests__/controllable-interval.spec.ts 1/3
+
+ Test Files 6 passed (10)
+      Tests 38 passed (48)
+   Start at 22:41:27
+   Duration 1.01s
+[?2026l[?2026h ✓ src/timer/__tests__/controllable-interval.spec.ts (3 tests) 8ms
+ ✓ src/number/__tests__/number.spec.ts (8 tests) 7ms
+ ✓ src/fetch/__tests__/compose.spec.ts (6 tests) 9ms
+
+ ❯ src/paradigm/__tests__/go.spec.ts 1/8
+
+ Test Files 9 passed (10)
+      Tests 55 passed (62)
+   Start at 22:41:27
+   Duration 1.12s
+[?2026l ✓ src/paradigm/__tests__/go.spec.ts (8 tests) 6ms
+
+ Test Files  10 passed (10)
+      Tests  62 passed (62)
+   Start at  22:41:27
+   Duration  1.16s (transform 705ms, setup 0ms, import 1.53s, tests 135ms, environment 1ms)
+
+[?25h

package/README.CN.md

@@ -0,0 +1,5 @@
+[English](./README.md) | 简体中文
+
+# 工具库
+
+## 线上地址

package/README.md

@@ -0,0 +1,5 @@
+English | [简体中文](./README.CN.md)
+
+# Utils
+
+## Online website

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,11 @@
+//#region \0rolldown/runtime.js
+var e = Object.defineProperty, t = (t, n) => {
+	let r = {};
+	for (var i in t) e(r, i, {
+		get: t[i],
+		enumerable: !0
+	});
+	return n || e(r, Symbol.toStringTag, { value: "Module" }), r;
+};
+//#endregion
+export { t as __exportAll };

package/dist/fetch/compose.d.ts

@@ -0,0 +1,3 @@
+export type Next = () => Promise<void>;
+export type Middleware<T = unknown> = (ctx: T, next: Next) => Promise<void>;
+export declare function asyncCompose<T = unknown>(...fns: Middleware<T>[]): Middleware<T>;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './number';
+export * from './paradigm';
+export * from './plugin';
+export * from './random';
+export * from './timer';
+export * from './url';
+export * from './utility-types';

package/dist/index.js

@@ -0,0 +1,10 @@
+import { clamp as e, toPrecision as t } from "./number/index.js";
+import { go_exports as n } from "./paradigm/go.js";
+import { rust_exports as r } from "./paradigm/rust.js";
+import { definePlugin as i } from "./plugin/core.js";
+import { defineBatchEmitter as a } from "./plugin/batching-emitter.js";
+import { random as o, randomFloat as s, randomHex as c, randomRgb as l } from "./random/index.js";
+import { createControllableInterval as u, defineControllableInterval as d } from "./timer/controllable-interval.js";
+import { debounce as f } from "./timer/debounce.js";
+import { urlParse as p, urlStringify as m } from "./url/index.js";
+export { e as clamp, u as createControllableInterval, f as debounce, a as defineBatchEmitter, d as defineControllableInterval, i as definePlugin, n as go, o as random, s as randomFloat, c as randomHex, l as randomRgb, r as rust, t as toPrecision, p as urlParse, m as urlStringify };

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/funnel.js

@@ -0,0 +1,40 @@
+//#region ../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/funnel.js
+var e = Symbol("funnel/voidReducer"), t = () => e;
+function n(n, { triggerAt: r = "end", minQuietPeriodMs: i, maxBurstDurationMs: a, minGapMs: o, reducer: s = t }) {
+	let c, l, u, d, f = () => {
+		let t = u;
+		t !== void 0 && (u = void 0, t === e ? n() : n(t), o !== void 0 && (l = setTimeout(p, o)));
+	}, p = () => {
+		clearTimeout(l), l = void 0, c === void 0 && f();
+	}, m = () => {
+		clearTimeout(c), c = void 0, d = void 0, l === void 0 && f();
+	};
+	return {
+		call: (...e) => {
+			let t = c === void 0 && l === void 0;
+			if ((r !== "start" || t) && (u = s(u, ...e)), !(c === void 0 && !t)) {
+				if (i !== void 0 || a !== void 0 || o === void 0) {
+					clearTimeout(c);
+					let e = Date.now();
+					d ??= e;
+					let t = a === void 0 ? i ?? 0 : Math.min(i ?? a, Math.max(0, a - (e - d)));
+					c = setTimeout(m, t);
+				}
+				r !== "end" && t && f();
+			}
+		},
+		cancel: () => {
+			clearTimeout(c), c = void 0, d = void 0, clearTimeout(l), l = void 0, u = void 0;
+		},
+		flush: () => {
+			m(), p();
+		},
+		get isIdle() {
+			return c === void 0 && l === void 0;
+		}
+	};
+}
+//#endregion
+export { n as funnel };
+
+//# sourceMappingURL=funnel.js.map

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/funnel.js"],"sourcesContent":["const e=Symbol(`funnel/voidReducer`),t=()=>e;function n(n,{triggerAt:r=`end`,minQuietPeriodMs:i,maxBurstDurationMs:a,minGapMs:o,reducer:s=t}){let c,l,u,d,f=()=>{let t=u;t!==void 0&&(u=void 0,t===e?n():n(t),o!==void 0&&(l=setTimeout(p,o)))},p=()=>{clearTimeout(l),l=void 0,c===void 0&&f()},m=()=>{clearTimeout(c),c=void 0,d=void 0,l===void 0&&f()};return{call:(...e)=>{let t=c===void 0&&l===void 0;if((r!==`start`||t)&&(u=s(u,...e)),!(c===void 0&&!t)){if(i!==void 0||a!==void 0||o===void 0){clearTimeout(c);let e=Date.now();d??=e;let t=a===void 0?i??0:Math.min(i??a,Math.max(0,a-(e-d)));c=setTimeout(m,t)}r!==`end`&&t&&f()}},cancel:()=>{clearTimeout(c),c=void 0,d=void 0,clearTimeout(l),l=void 0,u=void 0},flush:()=>{m(),p()},get isIdle(){return c===void 0&&l===void 0}}}export{n as funnel};\n//# sourceMappingURL=funnel.js.map"],"x_google_ignoreList":[0],"mappings":";AAAA,IAAM,IAAE,OAAO,oBAAoB,GAAE,UAAM;AAAE,SAAS,EAAE,GAAE,EAAC,WAAU,IAAE,OAAM,kBAAiB,GAAE,oBAAmB,GAAE,UAAS,GAAE,SAAQ,IAAE,KAAG;CAAC,IAAI,GAAE,GAAE,GAAE,GAAE,UAAM;EAAC,IAAI,IAAE;EAAE,MAAI,KAAK,MAAI,IAAE,KAAK,GAAE,MAAI,IAAE,EAAE,IAAE,EAAE,CAAC,GAAE,MAAI,KAAK,MAAI,IAAE,WAAW,GAAE,CAAC;CAAG,GAAE,UAAM;EAAC,aAAa,CAAC,GAAE,IAAE,KAAK,GAAE,MAAI,KAAK,KAAG,EAAE;CAAC,GAAE,UAAM;EAAC,aAAa,CAAC,GAAE,IAAE,KAAK,GAAE,IAAE,KAAK,GAAE,MAAI,KAAK,KAAG,EAAE;CAAC;CAAE,OAAM;EAAC,OAAM,GAAG,MAAI;GAAC,IAAI,IAAE,MAAI,KAAK,KAAG,MAAI,KAAK;GAAE,KAAI,MAAI,WAAS,OAAK,IAAE,EAAE,GAAE,GAAG,CAAC,IAAG,EAAE,MAAI,KAAK,KAAG,CAAC,IAAG;IAAC,IAAG,MAAI,KAAK,KAAG,MAAI,KAAK,KAAG,MAAI,KAAK,GAAE;KAAC,aAAa,CAAC;KAAE,IAAI,IAAE,KAAK,IAAI;KAAE,MAAI;KAAE,IAAI,IAAE,MAAI,KAAK,IAAE,KAAG,IAAE,KAAK,IAAI,KAAG,GAAE,KAAK,IAAI,GAAE,KAAG,IAAE,EAAE,CAAC;KAAE,IAAE,WAAW,GAAE,CAAC;IAAC;IAAC,MAAI,SAAO,KAAG,EAAE;GAAC;EAAC;EAAE,cAAW;GAAC,aAAa,CAAC,GAAE,IAAE,KAAK,GAAE,IAAE,KAAK,GAAE,aAAa,CAAC,GAAE,IAAE,KAAK,GAAE,IAAE,KAAK;EAAC;EAAE,aAAU;GAAC,EAAE,GAAE,EAAE;EAAC;EAAE,IAAI,SAAQ;GAAC,OAAO,MAAI,KAAK,KAAG,MAAI,KAAK;EAAC;CAAC;AAAC"}

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/isNullish.js

@@ -0,0 +1,8 @@
+//#region ../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/isNullish.js
+function e(e) {
+	return e == null;
+}
+//#endregion
+export { e as isNullish };
+
+//# sourceMappingURL=isNullish.js.map

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/isNullish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isNullish.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/isNullish.js"],"sourcesContent":["function e(e){return e==null}export{e as isNullish};\n//# sourceMappingURL=isNullish.js.map"],"x_google_ignoreList":[0],"mappings":";AAAA,SAAS,EAAE,GAAE;CAAC,OAAO,KAAG;AAAI"}

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/lazyDataLastImpl--3B10z3s.js

@@ -0,0 +1,12 @@
+//#region ../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/lazyDataLastImpl--3B10z3s.js
+function e(e, t, n) {
+	let r = (n) => e(n, ...t);
+	return n === void 0 ? r : Object.assign(r, {
+		lazy: n,
+		lazyArgs: t
+	});
+}
+//#endregion
+export { e as t };
+
+//# sourceMappingURL=lazyDataLastImpl--3B10z3s.js.map

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/lazyDataLastImpl--3B10z3s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazyDataLastImpl--3B10z3s.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/lazyDataLastImpl--3B10z3s.js"],"sourcesContent":["function e(e,t,n){let r=n=>e(n,...t);return n===void 0?r:Object.assign(r,{lazy:n,lazyArgs:t})}export{e as t};\n//# sourceMappingURL=lazyDataLastImpl--3B10z3s.js.map"],"x_google_ignoreList":[0],"mappings":";AAAA,SAAS,EAAE,GAAE,GAAE,GAAE;CAAC,IAAI,KAAE,MAAG,EAAE,GAAE,GAAG,CAAC;CAAE,OAAO,MAAI,KAAK,IAAE,IAAE,OAAO,OAAO,GAAE;EAAC,MAAK;EAAE,UAAS;CAAC,CAAC;AAAC"}

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/omitBy.js

@@ -0,0 +1,14 @@
+import { purry as e } from "./purry.js";
+//#region ../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/omitBy.js
+function t(...t) {
+	return e(n, t);
+}
+function n(e, t) {
+	let n = { ...e };
+	for (let [r, i] of Object.entries(n)) t(i, r, e) && delete n[r];
+	return n;
+}
+//#endregion
+export { t as omitBy };
+
+//# sourceMappingURL=omitBy.js.map

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/omitBy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omitBy.js","names":["e"],"sources":["../../../../../../../../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/omitBy.js"],"sourcesContent":["import{purry as e}from\"./purry.js\";function t(...t){return e(n,t)}function n(e,t){let n={...e};for(let[r,i]of Object.entries(n))t(i,r,e)&&delete n[r];return n}export{t as omitBy};\n//# sourceMappingURL=omitBy.js.map"],"x_google_ignoreList":[0],"mappings":";;AAAmC,SAAS,EAAE,GAAG,GAAE;CAAC,OAAOA,EAAE,GAAE,CAAC;AAAC;AAAC,SAAS,EAAE,GAAE,GAAE;CAAC,IAAI,IAAE,EAAC,GAAG,EAAC;CAAE,KAAI,IAAG,CAAC,GAAE,MAAK,OAAO,QAAQ,CAAC,GAAE,EAAE,GAAE,GAAE,CAAC,KAAG,OAAO,EAAE;CAAG,OAAO;AAAC"}

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/purry.js

@@ -0,0 +1,12 @@
+import { t as e } from "./lazyDataLastImpl--3B10z3s.js";
+//#region ../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/purry.js
+function t(t, n, r) {
+	let i = t.length - n.length;
+	if (i === 0) return t(...n);
+	if (i === 1) return e(t, n, r);
+	throw Error("Wrong number of arguments");
+}
+//#endregion
+export { t as purry };
+
+//# sourceMappingURL=purry.js.map

package/dist/node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/purry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purry.js","names":[],"sources":["../../../../../../../../../node_modules/.pnpm/remeda@2.39.0/node_modules/remeda/dist/purry.js"],"sourcesContent":["import{t as e}from\"./lazyDataLastImpl--3B10z3s.js\";function t(t,n,r){let i=t.length-n.length;if(i===0)return t(...n);if(i===1)return e(t,n,r);throw Error(`Wrong number of arguments`)}export{t as purry};\n//# sourceMappingURL=purry.js.map"],"x_google_ignoreList":[0],"mappings":";;AAAmD,SAAS,EAAE,GAAE,GAAE,GAAE;CAAC,IAAI,IAAE,EAAE,SAAO,EAAE;CAAO,IAAG,MAAI,GAAE,OAAO,EAAE,GAAG,CAAC;CAAE,IAAG,MAAI,GAAE,OAAO,EAAE,GAAE,GAAE,CAAC;CAAE,MAAM,MAAM,2BAA2B;AAAC"}

package/dist/number/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 转换为指定精度的数字
+ * @param val 需要转换的数字
+ * @param precision 精度。表示小数点后位数。如果传了负数（比如 -2），则取整到百位（1234.56->1200）。
+ * @returns 转换后的数字
+ */
+export declare function toPrecision(val: number, precision: number): number;
+/**
+ * 将数字限制在指定的范围内
+ * @param val 当前值
+ * @param min 最小值
+ * @param max 最大值
+ */
+export declare function clamp(val: number, min: number, max: number): number;

package/dist/number/index.js

@@ -0,0 +1,13 @@
+//#region src/number/index.ts
+function e(e, t) {
+	if (Number.isNaN(e) || !Number.isFinite(e)) return e;
+	let n = 10 ** t;
+	return Math.round(e * n) / n;
+}
+function t(e, t, n) {
+	return Math.max(t, Math.min(e, n));
+}
+//#endregion
+export { t as clamp, e as toPrecision };
+
+//# sourceMappingURL=index.js.map

package/dist/number/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/number/index.ts"],"sourcesContent":["/**\n * 转换为指定精度的数字\n * @param val 需要转换的数字\n * @param precision 精度。表示小数点后位数。如果传了负数（比如 -2），则取整到百位（1234.56->1200）。\n * @returns 转换后的数字\n */\nexport function toPrecision(val: number, precision: number): number {\n  if (Number.isNaN(val) || !Number.isFinite(val)) return val\n\n  const factor = Math.pow(10, precision)\n  return Math.round(val * factor) / factor\n}\n\n/**\n * 将数字限制在指定的范围内\n * @param val 当前值\n * @param min 最小值\n * @param max 最大值\n */\nexport function clamp(val: number, min: number, max: number): number {\n  return Math.max(min, Math.min(val, max))\n}\n"],"mappings":";AAMA,SAAgB,EAAY,GAAa,GAA2B;CAClE,IAAI,OAAO,MAAM,CAAG,KAAK,CAAC,OAAO,SAAS,CAAG,GAAG,OAAO;CAEvD,IAAM,IAAkB,MAAI;CAC5B,OAAO,KAAK,MAAM,IAAM,CAAM,IAAI;AACpC;AAQA,SAAgB,EAAM,GAAa,GAAa,GAAqB;CACnE,OAAO,KAAK,IAAI,GAAK,KAAK,IAAI,GAAK,CAAG,CAAC;AACzC"}

package/dist/paradigm/go.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @description Go 范式，用于统一处理成功/失败返回值
+ */
+export type Ok<T> = readonly [null, T];
+export type Err<E> = readonly [E, null];
+export type Result<T, E> = Ok<T> | Err<E>;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+export declare function to<T, E = unknown>(promise: Promise<T>): Promise<Result<Awaited<T>, E>>;
+export declare function unwrap<S extends Result<any, any>>(result: S): S extends Ok<infer T> ? T : S extends Err<infer E> ? E : never;

package/dist/paradigm/go.js

@@ -0,0 +1,37 @@
+import { __exportAll as e } from "../_virtual/_rolldown/runtime.js";
+//#region src/paradigm/go.ts
+var t = /* @__PURE__ */ e({
+	err: () => r,
+	isErr: () => a,
+	isOk: () => i,
+	ok: () => n,
+	to: () => o,
+	unwrap: () => s
+});
+function n(e) {
+	return [null, e];
+}
+function r(e) {
+	return [e, null];
+}
+function i(e) {
+	return e[0] === null && e[1] !== null;
+}
+function a(e) {
+	return e[0] !== null && e[1] === null;
+}
+async function o(e) {
+	try {
+		return n(await e);
+	} catch (e) {
+		return r(e);
+	}
+}
+function s(e) {
+	let [t, n] = e;
+	return i(e) ? n : t;
+}
+//#endregion
+export { r as err, t as go_exports, a as isErr, i as isOk, n as ok, o as to, s as unwrap };
+
+//# sourceMappingURL=go.js.map

package/dist/paradigm/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","names":[],"sources":["../../src/paradigm/go.ts"],"sourcesContent":["/**\n * @description Go 范式，用于统一处理成功/失败返回值\n */\n\nexport type Ok<T> = readonly [null, T]\nexport type Err<E> = readonly [E, null]\nexport type Result<T, E> = Ok<T> | Err<E>\n\nexport function ok<T>(value: T): Ok<T> {\n  return [null, value]\n}\n\nexport function err<E>(error: E): Err<E> {\n  return [error, null]\n}\n\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\n  return result[0] === null && result[1] !== null\n}\n\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\n  return result[0] !== null && result[1] === null\n}\n\nexport async function to<T, E = unknown>(promise: Promise<T>): Promise<Result<Awaited<T>, E>> {\n  try {\n    return ok(await promise)\n  } catch (error) {\n    return err(error as E)\n  }\n}\n\nexport function unwrap<S extends Result<any, any>>(\n  result: S\n): S extends Ok<infer T> ? T : S extends Err<infer E> ? E : never {\n  const [error, value] = result\n  return isOk(result) ? value : error\n}\n"],"mappings":";;;;;;;;;;AAQA,SAAgB,EAAM,GAAiB;CACrC,OAAO,CAAC,MAAM,CAAK;AACrB;AAEA,SAAgB,EAAO,GAAkB;CACvC,OAAO,CAAC,GAAO,IAAI;AACrB;AAEA,SAAgB,EAAW,GAAuC;CAChE,OAAO,EAAO,OAAO,QAAQ,EAAO,OAAO;AAC7C;AAEA,SAAgB,EAAY,GAAwC;CAClE,OAAO,EAAO,OAAO,QAAQ,EAAO,OAAO;AAC7C;AAEA,eAAsB,EAAmB,GAAqD;CAC5F,IAAI;EACF,OAAO,EAAG,MAAM,CAAO;CACzB,SAAS,GAAO;EACd,OAAO,EAAI,CAAU;CACvB;AACF;AAEA,SAAgB,EACd,GACgE;CAChE,IAAM,CAAC,GAAO,KAAS;CACvB,OAAO,EAAK,CAAM,IAAI,IAAQ;AAChC"}

package/dist/paradigm/index.d.ts

@@ -0,0 +1,2 @@
+export * as go from './go';
+export * as rust from './rust';

package/dist/paradigm/rust.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @description Rust 范式，用于统一处理成功/失败返回值
+ */
+export type Ok<T> = {
+    readonly ok: true;
+    readonly value: T;
+};
+export type Err<E> = {
+    readonly ok: false;
+    readonly error: E;
+};
+/**
+ * 考虑到 T 或 E 其中一个为 never 的情况
+ * Result<T,never> 等价于 Ok<T>
+ * Result<never,E> 等价于 Err<E>
+ * 为什么是 [T] extends [never] ? 而不是 T extends never ?：
+ * 条件类型是分布式的，防止 T 为联合类型时对每项分别计算再合并结果
+ */
+export type Result<T, E> = Ok<T> | Err<E>;
+export declare function ok<T>(value: T): Ok<T>;
+export declare function err<E>(error: E): Err<E>;
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+export declare function to<T, E = unknown>(promise: Promise<T>): Promise<Result<Awaited<T>, E>>;
+export declare function unwrap<S extends Result<any, any>>(result: S): S extends Ok<infer T> ? T : S extends Err<infer E> ? E : never;

package/dist/paradigm/rust.js

@@ -0,0 +1,42 @@
+import { __exportAll as e } from "../_virtual/_rolldown/runtime.js";
+//#region src/paradigm/rust.ts
+var t = /* @__PURE__ */ e({
+	err: () => r,
+	isErr: () => a,
+	isOk: () => i,
+	ok: () => n,
+	to: () => o,
+	unwrap: () => s
+});
+function n(e) {
+	return {
+		ok: !0,
+		value: e
+	};
+}
+function r(e) {
+	return {
+		ok: !1,
+		error: e
+	};
+}
+function i(e) {
+	return e.ok;
+}
+function a(e) {
+	return !e.ok;
+}
+async function o(e) {
+	try {
+		return n(await e);
+	} catch (e) {
+		return r(e);
+	}
+}
+function s(e) {
+	return e.ok ? e.value : e.error;
+}
+//#endregion
+export { r as err, a as isErr, i as isOk, n as ok, t as rust_exports, o as to, s as unwrap };
+
+//# sourceMappingURL=rust.js.map

package/dist/paradigm/rust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.js","names":[],"sources":["../../src/paradigm/rust.ts"],"sourcesContent":["/**\n * @description Rust 范式，用于统一处理成功/失败返回值\n */\n\nexport type Ok<T> = {\n  readonly ok: true\n  readonly value: T\n}\nexport type Err<E> = {\n  readonly ok: false\n  readonly error: E\n}\n/**\n * 考虑到 T 或 E 其中一个为 never 的情况\n * Result<T,never> 等价于 Ok<T>\n * Result<never,E> 等价于 Err<E>\n * 为什么是 [T] extends [never] ? 而不是 T extends never ?：\n * 条件类型是分布式的，防止 T 为联合类型时对每项分别计算再合并结果\n */\nexport type Result<T, E> = Ok<T> | Err<E>\n\nexport function ok<T>(value: T): Ok<T> {\n  return { ok: true, value }\n}\n\nexport function err<E>(error: E): Err<E> {\n  return { ok: false, error }\n}\n\nexport function isOk<T, E>(result: Result<T, E>): result is Ok<T> {\n  return result.ok\n}\n\nexport function isErr<T, E>(result: Result<T, E>): result is Err<E> {\n  return !result.ok\n}\n\nexport async function to<T, E = unknown>(promise: Promise<T>): Promise<Result<Awaited<T>, E>> {\n  try {\n    return ok(await promise)\n  } catch (error) {\n    return err(error as E)\n  }\n}\n\nexport function unwrap<S extends Result<any, any>>(\n  result: S\n): S extends Ok<infer T> ? T : S extends Err<infer E> ? E : never {\n  return result.ok ? result.value : result.error\n}\n"],"mappings":";;;;;;;;;;AAqBA,SAAgB,EAAM,GAAiB;CACrC,OAAO;EAAE,IAAI;EAAM;CAAM;AAC3B;AAEA,SAAgB,EAAO,GAAkB;CACvC,OAAO;EAAE,IAAI;EAAO;CAAM;AAC5B;AAEA,SAAgB,EAAW,GAAuC;CAChE,OAAO,EAAO;AAChB;AAEA,SAAgB,EAAY,GAAwC;CAClE,OAAO,CAAC,EAAO;AACjB;AAEA,eAAsB,EAAmB,GAAqD;CAC5F,IAAI;EACF,OAAO,EAAG,MAAM,CAAO;CACzB,SAAS,GAAO;EACd,OAAO,EAAI,CAAU;CACvB;AACF;AAEA,SAAgB,EACd,GACgE;CAChE,OAAO,EAAO,KAAK,EAAO,QAAQ,EAAO;AAC3C"}

package/dist/plugin/batching-emitter.d.ts

@@ -0,0 +1,4 @@
+export declare function defineBatchEmitter<S>(onFlushed?: (queue: S[]) => Promise<void>): import('./core').Plugin<{
+    batchEmit: (data: S, batchingDelay?: number) => Promise<S[]>;
+    flush: () => Promise<void>;
+}, object>;

package/dist/plugin/batching-emitter.js

@@ -0,0 +1,33 @@
+import { definePlugin as e } from "./core.js";
+//#region src/plugin/batching-emitter.ts
+function t(t) {
+	return e(() => {
+		let e = [], n = [], r = null;
+		async function i(i, o = 0) {
+			return o <= 0 ? (t && await t([i]), Promise.resolve([i])) : new Promise((t, s) => {
+				n.push(t), e.push(i) === 1 && (r = setTimeout(() => {
+					try {
+						a();
+					} catch (e) {
+						s(e);
+					}
+				}, o));
+			});
+		}
+		async function a() {
+			if (!e.length) return;
+			let i = [...e], a = [...n];
+			e = [], n = [], r &&= (clearTimeout(r), null), t && await t(i);
+			let o;
+			for (; o = a.shift();) o(i);
+		}
+		return {
+			batchEmit: i,
+			flush: a
+		};
+	});
+}
+//#endregion
+export { t as defineBatchEmitter };
+
+//# sourceMappingURL=batching-emitter.js.map

package/dist/plugin/batching-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching-emitter.js","names":[],"sources":["../../src/plugin/batching-emitter.ts"],"sourcesContent":["import { definePlugin } from './core'\n\ntype Resolve<S> = (queue: S[]) => void\n\nexport function defineBatchEmitter<S>(onFlushed?: (queue: S[]) => Promise<void>) {\n  return definePlugin(() => {\n    let queue: S[] = []\n    let resolves: Resolve<S>[] = []\n    let timerId: ReturnType<typeof setTimeout> | null = null\n\n    /**\n     * 批量发出，延迟执行\n     */\n    async function batchEmit(data: S, batchingDelay = 0): Promise<S[]> {\n      if (batchingDelay <= 0) {\n        if (onFlushed) await onFlushed([data])\n        return Promise.resolve([data])\n      }\n\n      return new Promise((resolve, reject) => {\n        resolves.push(resolve)\n\n        if (queue.push(data) === 1) {\n          timerId = setTimeout(() => {\n            try {\n              void flush()\n            } catch (error) {\n              reject(error)\n            }\n          }, batchingDelay)\n        }\n      })\n    }\n\n    /**\n     * 立即清空并执行当前的队列\n     */\n    async function flush() {\n      if (!queue.length) return\n\n      // 先快照一份，防止后续 push 污染当前批次，消除异步重入（Re-entrancy）\n      const currentQueue = [...queue]\n      const currentResolves = [...resolves]\n      queue = []\n      resolves = []\n      if (timerId) {\n        clearTimeout(timerId)\n        timerId = null\n      }\n\n      if (onFlushed) await onFlushed(currentQueue)\n\n      let fn: Resolve<S> | undefined\n      while ((fn = currentResolves.shift())) {\n        fn(currentQueue)\n      }\n    }\n\n    return { batchEmit, flush }\n  })\n}\n"],"mappings":";;AAIA,SAAgB,EAAsB,GAA2C;CAC/E,OAAO,QAAmB;EACxB,IAAI,IAAa,CAAC,GACd,IAAyB,CAAC,GAC1B,IAAgD;EAKpD,eAAe,EAAU,GAAS,IAAgB,GAAiB;GAMjE,OALI,KAAiB,KACf,KAAW,MAAM,EAAU,CAAC,CAAI,CAAC,GAC9B,QAAQ,QAAQ,CAAC,CAAI,CAAC,KAGxB,IAAI,SAAS,GAAS,MAAW;IAGtC,AAFA,EAAS,KAAK,CAAO,GAEjB,EAAM,KAAK,CAAI,MAAM,MACvB,IAAU,iBAAiB;KACzB,IAAI;MACF,EAAW;KACb,SAAS,GAAO;MACd,EAAO,CAAK;KACd;IACF,GAAG,CAAa;GAEpB,CAAC;EACH;EAKA,eAAe,IAAQ;GACrB,IAAI,CAAC,EAAM,QAAQ;GAGnB,IAAM,IAAe,CAAC,GAAG,CAAK,GACxB,IAAkB,CAAC,GAAG,CAAQ;GAQpC,AAPA,IAAQ,CAAC,GACT,IAAW,CAAC,GACZ,AAEE,OADA,aAAa,CAAO,GACV,OAGR,KAAW,MAAM,EAAU,CAAY;GAE3C,IAAI;GACJ,OAAQ,IAAK,EAAgB,MAAM,IACjC,EAAG,CAAY;EAEnB;EAEA,OAAO;GAAE;GAAW;EAAM;CAC5B,CAAC;AACH"}

package/dist/plugin/core.d.ts

@@ -0,0 +1,10 @@
+export interface Plugin<C extends object, D extends object> {
+    readonly use: <U extends object, E extends object>(plugin: Plugin<U, E>) => Plugin<C & U, D & E>;
+    readonly make: <T extends D>(ctx?: T) => T & C;
+}
+export declare function definePlugin<C extends object, D extends object>(setup: (ctx: D) => C): Plugin<C, D>;
+/**
+ * 提取插件实例化的类型 (C & D)
+ * T 可以是 Plugin 实例，也可以是返回 Plugin 实例的函数
+ */
+export type PluginMade<T> = T extends (...args: any[]) => Plugin<infer C, infer D> ? C & D : T extends Plugin<infer C, infer D> ? C & D : never;

package/dist/plugin/core.js

@@ -0,0 +1,23 @@
+//#region src/plugin/core.ts
+function e(t) {
+	function n(n) {
+		return e((e) => n.make({
+			...e,
+			...t(e)
+		}));
+	}
+	function r(e = {}) {
+		return {
+			...e,
+			...t(e)
+		};
+	}
+	return {
+		use: n,
+		make: r
+	};
+}
+//#endregion
+export { e as definePlugin };
+
+//# sourceMappingURL=core.js.map

package/dist/plugin/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","names":[],"sources":["../../src/plugin/core.ts"],"sourcesContent":["export interface Plugin<C extends object, D extends object> {\n  readonly use: <U extends object, E extends object>(plugin: Plugin<U, E>) => Plugin<C & U, D & E>\n  readonly make: <T extends D>(ctx?: T) => T & C\n}\n\nexport function definePlugin<C extends object, D extends object>(setup: (ctx: D) => C): Plugin<C, D> {\n  function use<U extends object, E extends object>(plugin: Plugin<U, E>): Plugin<C & U, D & E> {\n    return definePlugin<C & U, D & E>(ctx => {\n      return plugin.make({\n        ...ctx,\n        ...setup(ctx)\n      })\n    })\n  }\n\n  function make<T extends D>(ctx = {} as T): T & C {\n    return {\n      ...ctx,\n      ...setup(ctx)\n    }\n  }\n\n  return {\n    use,\n    make\n  }\n}\n\n/**\n * 提取插件实例化的类型 (C & D)\n * T 可以是 Plugin 实例，也可以是返回 Plugin 实例的函数\n */\nexport type PluginMade<T> = T extends (...args: any[]) => Plugin<infer C, infer D>\n  ? C & D\n  : T extends Plugin<infer C, infer D>\n    ? C & D\n    : never\n"],"mappings":";AAKA,SAAgB,EAAiD,GAAoC;CACnG,SAAS,EAAwC,GAA4C;EAC3F,OAAO,GAA2B,MACzB,EAAO,KAAK;GACjB,GAAG;GACH,GAAG,EAAM,CAAG;EACd,CAAC,CACF;CACH;CAEA,SAAS,EAAkB,IAAM,CAAC,GAAe;EAC/C,OAAO;GACL,GAAG;GACH,GAAG,EAAM,CAAG;EACd;CACF;CAEA,OAAO;EACL;EACA;CACF;AACF"}

package/dist/plugin/event-emitter.d.ts

@@ -0,0 +1,4 @@
+export declare function defineEventEmitter<E extends Record<string, unknown[]>>(): import('./core').Plugin<{
+    on<K extends keyof E>(type: K & string, handler: (...args: E[K]) => void, options?: AddEventListenerOptions): () => void;
+    emit<K extends keyof E>(type: K & string, ...args: E[K]): void;
+}, object>;

package/dist/plugin/index.d.ts

@@ -0,0 +1,2 @@
+export * from './batching-emitter';
+export * from './core';

package/dist/random/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 随机整数 [min, max]
+ * @param min 最小值
+ * @param max 最大值
+ */
+export declare function random(min: number, max: number): number;
+/**
+ * 随机浮点数 [min, max)
+ * @param min 最小值
+ * @param max 最大值
+ * @param precision 保留小数位，不传则返回原始浮点数
+ */
+export declare function randomFloat(min: number, max: number): number;
+/**
+ * 生成随机的 RGB 颜色代码
+ * @returns RGB 颜色代码，例如 rgb(255, 0, 0)
+ */
+export declare function randomRgb(): string;
+/**
+ * 生成随机的十六进制颜色代码
+ * @returns 十六进制颜色代码，例如 #ff0000
+ */
+export declare function randomHex(): string;

package/dist/random/index.js

@@ -0,0 +1,18 @@
+//#region src/random/index.ts
+function e(e, t) {
+	return Math.floor(Math.random() * (t - e + 1)) + e;
+}
+function t(e, t) {
+	let n = Math.min(e, t);
+	return n + Math.random() * (Math.max(e, t) - n);
+}
+function n() {
+	return `rgb(${e(0, 255)}, ${e(0, 255)}, ${e(0, 255)})`;
+}
+function r() {
+	return "#" + Math.floor(Math.random() * 16777216).toString(16).padStart(6, "0");
+}
+//#endregion
+export { e as random, t as randomFloat, r as randomHex, n as randomRgb };
+
+//# sourceMappingURL=index.js.map

package/dist/random/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/random/index.ts"],"sourcesContent":["/**\n * 随机整数 [min, max]\n * @param min 最小值\n * @param max 最大值\n */\nexport function random(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min\n}\n\n/**\n * 随机浮点数 [min, max)\n * @param min 最小值\n * @param max 最大值\n * @param precision 保留小数位，不传则返回原始浮点数\n */\nexport function randomFloat(min: number, max: number): number {\n  const lower = Math.min(min, max)\n  const upper = Math.max(min, max)\n  return lower + Math.random() * (upper - lower)\n}\n\n/**\n * 生成随机的 RGB 颜色代码\n * @returns RGB 颜色代码，例如 rgb(255, 0, 0)\n */\nexport function randomRgb(): string {\n  return `rgb(${random(0, 255)}, ${random(0, 255)}, ${random(0, 255)})`\n}\n\n/**\n * 生成随机的十六进制颜色代码\n * @returns 十六进制颜色代码，例如 #ff0000\n */\nexport function randomHex(): string {\n  const color = Math.floor(Math.random() * 0x1000000).toString(16)\n  return '#' + color.padStart(6, '0')\n}\n"],"mappings":";AAKA,SAAgB,EAAO,GAAa,GAAqB;CACvD,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,IAAM,IAAM,EAAE,IAAI;AACvD;AAQA,SAAgB,EAAY,GAAa,GAAqB;CAC5D,IAAM,IAAQ,KAAK,IAAI,GAAK,CAAG;CAE/B,OAAO,IAAQ,KAAK,OAAO,KADb,KAAK,IAAI,GAAK,CACI,IAAQ;AAC1C;AAMA,SAAgB,IAAoB;CAClC,OAAO,OAAO,EAAO,GAAG,GAAG,EAAE,IAAI,EAAO,GAAG,GAAG,EAAE,IAAI,EAAO,GAAG,GAAG,EAAE;AACrE;AAMA,SAAgB,IAAoB;CAElC,OAAO,MADO,KAAK,MAAM,KAAK,OAAO,IAAI,QAAS,CAAC,CAAC,SAAS,EAChD,CAAA,CAAM,SAAS,GAAG,GAAG;AACpC"}