yann-core 0.0.1 → 1.0.0

package/README.md

@@ -1,15 +1,77 @@
 # yann-core
 
-## Timer
+用于 Vue 3.5 的定时器与状态工具。Vue 是 peer dependency，使用项目自身的 Vue 实例。
+
+## 定时器
+
+```ts
+import { useRafTimer } from 'yann-core'
+
+const timer = useRafTimer(async () => {
+  await refreshData()
+}, 1000, {
+  type: 'ignoreCallbackTime',
+  loop: true,
+  onError: (error) => console.error(error),
+})
+
+timer.pause()
+timer.start() // 恢复暂停
+timer.stop() // 永久停止；start 不会重新启动
+```
+
+- 创建后自动开始，首次执行在间隔到期后的动画帧；默认间隔为 `1000 / 60` 毫秒。
+- `ignoreCallbackTime`：从本次回调开始计算间隔；`waitAfterCallback`：从回调及错误报告完成后计算间隔。
+- 每个实例最多执行一个回调，支持 Promise 和 thenable。长回调完成后若已过期，只在下一帧执行一次，不补发遗漏次数。
+- 暂停冻结计时；恢复时仍等待尚未完成的回调。`stop` 和 Vue 作用域销毁会清理待调度任务并释放回调引用；用户创建的 Promise 不会自动取消。
+- 异常报告后继续，未配置 `onError` 时使用 `console.error`。异步 `onError` 也会等待；报告器失败会捕获并记录。每次回调尝试，包括失败，都计入次数。
+- `loop: true` 或 `Infinity` 无限循环，`false` 执行一次；有限数字向上取整且至少一次。`NaN` 和负无穷非法。
+- 间隔必须是有限非负数；零间隔每帧最多执行一次。超长延时分段等待。无 RAF 环境（如 SSR）返回无操作的控制方法，不执行回调。
+- 长间隔由 timeout 等待，距离截止时间 20ms 内由 RAF 检查。实际执行精度受帧率和浏览器后台限流影响。
+
+## 状态
 
 ```ts
-const timer = useRafTimer(()=>{
-    console.log('tick');
-},1000);
+import { useState } from 'yann-core'
+
+const [state, setState] = useState(0)
+setState(1)
+
+const [rows, setRows] = useState([{ id: 1 }], { shallow: true })
+setRows([{ id: 2 }]) // 替换 .value 触发更新
 ```
 
-## State
+默认使用深层响应式 `ref`，对象属性中的嵌套 Ref 会解包；数组和 Map 中的 Ref 遵循 Vue 自身的规则。`shallow: true` 使用 `shallowRef`，保留输入对象与嵌套 Ref，不为普通对象增加深层代理。已有响应式对象不会被转换回普通对象。浅层内部修改需替换对象或使用 Vue 的 `triggerRef`。
+
+普通值、Ref 和 getter 只在初始化时求值一次，不持续同步源。若 getter 返回 Ref，则遵循 Vue 工厂的 Ref 复用行为；setter 收到根 Ref 时取其内部值再写入，保持读取类型与运行结果一致。比较与 `beforeSet` 仍接收原始输入。
 
 ```ts
-const [state, setState] = useState(0);
-```
+const [value, setValue] = useState(2, {
+  diff: true,
+  beforeSet: (incoming) => incoming * 2,
+})
+setValue(2) // false：比较相等，beforeSet 不执行
+setValue(1) // true：先比较原始输入，再转换为 2
+```
+
+`diff: true` 默认深比较（支持数组、Map、循环引用），先做引用相等快速判断。提供 `compare(oldValue, newValue)` 时始终调用自定义比较器，并启用比较流程，即使未设置 `diff`。旧值类型与状态读取类型一致，新值和 `beforeSet` 使用原始输入类型。
+
+setter 返回 `false` 表示比较判定相等而跳过设置，返回 `true` 表示接受设置；未启用比较时，即使 Vue 本身不触发更新，也返回 `true`。类型从根入口导出：`UseStateConfig<T, Shallow>`、`UseStateRef<T, Shallow>`、`UseStateReturn<T, Shallow>`、`Callback`、`ControlFunctions`、`RafTimerOptions`。状态类型第二个参数默认 `false`，动态布尔选项使用 `boolean`。
+
+类型纠错可能使依赖旧声明的代码报错：深层模式的对象 Ref 属性应读取 `state.value.nested`，而不是 `state.value.nested.value`；比较器旧值同样遵循解包类型。
+
+## 验证
+
+```sh
+pnpm install --frozen-lockfile
+pnpm type-check
+pnpm lint:check
+pnpm test
+pnpm build
+pnpm verify:package
+pnpm benchmark
+```
+
+`type-check` 同时编译运行测试和类型回归用例；`lint:check` 不修改文件。`verify:package` 检查打包后的 ESM、NodeNext/Bundler 类型消费和仅导入定时器时的 tree shaking。基准需要支持 `require(ESM)` 的 Node 22.12+ 及 Git 基线历史；可用 `YANN_BASELINE_REVISION` 指定比较提交。结果写入忽略的 `artifacts/`，方法和实测结果见 [PERFORMANCE.md](./PERFORMANCE.md)。
+
+构建内存与体积可用 `node scripts/measure-build.mjs optimized` 记录；该命令清理 TypeScript 增量缓存以测量冷类型检查。不自动发布版本。

package/dist/index.js

@@ -1,565 +1,6 @@
-import { ref as Ee, toValue as Ie } from "vue";
-var be = typeof global == "object" && global && global.Object === Object && global, Ce = typeof self == "object" && self && self.Object === Object && self, T = be || Ce || Function("return this")(), P = T.Symbol, ve = Object.prototype, Le = ve.hasOwnProperty, Me = ve.toString, x = P ? P.toStringTag : void 0;
-function Re(e) {
-  var t = Le.call(e, x), r = e[x];
-  try {
-    e[x] = void 0;
-    var n = !0;
-  } catch {
-  }
-  var i = Me.call(e);
-  return n && (t ? e[x] = r : delete e[x]), i;
-}
-var De = Object.prototype, Fe = De.toString;
-function Ge(e) {
-  return Fe.call(e);
-}
-var Ne = "[object Null]", Ue = "[object Undefined]", V = P ? P.toStringTag : void 0;
-function M(e) {
-  return e == null ? e === void 0 ? Ue : Ne : V && V in Object(e) ? Re(e) : Ge(e);
-}
-function I(e) {
-  return e != null && typeof e == "object";
-}
-var G = Array.isArray;
-function Te(e) {
-  var t = typeof e;
-  return e != null && (t == "object" || t == "function");
-}
-var ze = "[object AsyncFunction]", Be = "[object Function]", He = "[object GeneratorFunction]", Ke = "[object Proxy]";
-function Ae(e) {
-  if (!Te(e))
-    return !1;
-  var t = M(e);
-  return t == Be || t == He || t == ze || t == Ke;
-}
-var B = T["__core-js_shared__"], k = function() {
-  var e = /[^.]+$/.exec(B && B.keys && B.keys.IE_PROTO || "");
-  return e ? "Symbol(src)_1." + e : "";
-}();
-function qe(e) {
-  return !!k && k in e;
-}
-var We = Function.prototype, Xe = We.toString;
-function $(e) {
-  if (e != null) {
-    try {
-      return Xe.call(e);
-    } catch {
-    }
-    try {
-      return e + "";
-    } catch {
-    }
-  }
-  return "";
-}
-var Je = /[\\^$.*+?()[\]{}|]/g, Ye = /^\[object .+?Constructor\]$/, Ze = Function.prototype, Qe = Object.prototype, Ve = Ze.toString, ke = Qe.hasOwnProperty, et = RegExp(
-  "^" + Ve.call(ke).replace(Je, "\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g, "$1.*?") + "$"
-);
-function tt(e) {
-  if (!Te(e) || qe(e))
-    return !1;
-  var t = Ae(e) ? et : Ye;
-  return t.test($(e));
-}
-function rt(e, t) {
-  return e == null ? void 0 : e[t];
-}
-function S(e, t) {
-  var r = rt(e, t);
-  return tt(r) ? r : void 0;
-}
-var W = S(T, "WeakMap"), nt = 9007199254740991, at = /^(?:0|[1-9]\d*)$/;
-function it(e, t) {
-  var r = typeof e;
-  return t = t ?? nt, !!t && (r == "number" || r != "symbol" && at.test(e)) && e > -1 && e % 1 == 0 && e < t;
-}
-function me(e, t) {
-  return e === t || e !== e && t !== t;
-}
-var ot = 9007199254740991;
-function we(e) {
-  return typeof e == "number" && e > -1 && e % 1 == 0 && e <= ot;
-}
-function st(e) {
-  return e != null && we(e.length) && !Ae(e);
-}
-var ut = Object.prototype;
-function ft(e) {
-  var t = e && e.constructor, r = typeof t == "function" && t.prototype || ut;
-  return e === r;
-}
-function ct(e, t) {
-  for (var r = -1, n = Array(e); ++r < e; )
-    n[r] = t(r);
-  return n;
-}
-var lt = "[object Arguments]";
-function ee(e) {
-  return I(e) && M(e) == lt;
-}
-var Oe = Object.prototype, pt = Oe.hasOwnProperty, dt = Oe.propertyIsEnumerable, gt = ee(/* @__PURE__ */ function() {
-  return arguments;
-}()) ? ee : function(e) {
-  return I(e) && pt.call(e, "callee") && !dt.call(e, "callee");
-};
-function _t() {
-  return !1;
-}
-var $e = typeof exports == "object" && exports && !exports.nodeType && exports, te = $e && typeof module == "object" && module && !module.nodeType && module, ht = te && te.exports === $e, re = ht ? T.Buffer : void 0, yt = re ? re.isBuffer : void 0, X = yt || _t, bt = "[object Arguments]", vt = "[object Array]", Tt = "[object Boolean]", At = "[object Date]", mt = "[object Error]", wt = "[object Function]", Ot = "[object Map]", $t = "[object Number]", jt = "[object Object]", Pt = "[object RegExp]", St = "[object Set]", xt = "[object String]", Et = "[object WeakMap]", It = "[object ArrayBuffer]", Ct = "[object DataView]", Lt = "[object Float32Array]", Mt = "[object Float64Array]", Rt = "[object Int8Array]", Dt = "[object Int16Array]", Ft = "[object Int32Array]", Gt = "[object Uint8Array]", Nt = "[object Uint8ClampedArray]", Ut = "[object Uint16Array]", zt = "[object Uint32Array]", c = {};
-c[Lt] = c[Mt] = c[Rt] = c[Dt] = c[Ft] = c[Gt] = c[Nt] = c[Ut] = c[zt] = !0;
-c[bt] = c[vt] = c[It] = c[Tt] = c[Ct] = c[At] = c[mt] = c[wt] = c[Ot] = c[$t] = c[jt] = c[Pt] = c[St] = c[xt] = c[Et] = !1;
-function Bt(e) {
-  return I(e) && we(e.length) && !!c[M(e)];
-}
-function Ht(e) {
-  return function(t) {
-    return e(t);
-  };
-}
-var je = typeof exports == "object" && exports && !exports.nodeType && exports, E = je && typeof module == "object" && module && !module.nodeType && module, Kt = E && E.exports === je, H = Kt && be.process, ne = function() {
-  try {
-    var e = E && E.require && E.require("util").types;
-    return e || H && H.binding && H.binding("util");
-  } catch {
-  }
-}(), ae = ne && ne.isTypedArray, Pe = ae ? Ht(ae) : Bt, qt = Object.prototype, Wt = qt.hasOwnProperty;
-function Xt(e, t) {
-  var r = G(e), n = !r && gt(e), i = !r && !n && X(e), a = !r && !n && !i && Pe(e), u = r || n || i || a, o = u ? ct(e.length, String) : [], s = o.length;
-  for (var f in e)
-    Wt.call(e, f) && !(u && // Safari 9 has enumerable `arguments.length` in strict mode.
-    (f == "length" || // Node.js 0.10 has enumerable non-index properties on buffers.
-    i && (f == "offset" || f == "parent") || // PhantomJS 2 has enumerable non-index properties on typed arrays.
-    a && (f == "buffer" || f == "byteLength" || f == "byteOffset") || // Skip index properties.
-    it(f, s))) && o.push(f);
-  return o;
-}
-function Jt(e, t) {
-  return function(r) {
-    return e(t(r));
-  };
-}
-var Yt = Jt(Object.keys, Object), Zt = Object.prototype, Qt = Zt.hasOwnProperty;
-function Vt(e) {
-  if (!ft(e))
-    return Yt(e);
-  var t = [];
-  for (var r in Object(e))
-    Qt.call(e, r) && r != "constructor" && t.push(r);
-  return t;
-}
-function kt(e) {
-  return st(e) ? Xt(e) : Vt(e);
-}
-var C = S(Object, "create");
-function er() {
-  this.__data__ = C ? C(null) : {}, this.size = 0;
-}
-function tr(e) {
-  var t = this.has(e) && delete this.__data__[e];
-  return this.size -= t ? 1 : 0, t;
-}
-var rr = "__lodash_hash_undefined__", nr = Object.prototype, ar = nr.hasOwnProperty;
-function ir(e) {
-  var t = this.__data__;
-  if (C) {
-    var r = t[e];
-    return r === rr ? void 0 : r;
-  }
-  return ar.call(t, e) ? t[e] : void 0;
-}
-var or = Object.prototype, sr = or.hasOwnProperty;
-function ur(e) {
-  var t = this.__data__;
-  return C ? t[e] !== void 0 : sr.call(t, e);
-}
-var fr = "__lodash_hash_undefined__";
-function cr(e, t) {
-  var r = this.__data__;
-  return this.size += this.has(e) ? 0 : 1, r[e] = C && t === void 0 ? fr : t, this;
-}
-function O(e) {
-  var t = -1, r = e == null ? 0 : e.length;
-  for (this.clear(); ++t < r; ) {
-    var n = e[t];
-    this.set(n[0], n[1]);
-  }
-}
-O.prototype.clear = er;
-O.prototype.delete = tr;
-O.prototype.get = ir;
-O.prototype.has = ur;
-O.prototype.set = cr;
-function lr() {
-  this.__data__ = [], this.size = 0;
-}
-function U(e, t) {
-  for (var r = e.length; r--; )
-    if (me(e[r][0], t))
-      return r;
-  return -1;
-}
-var pr = Array.prototype, dr = pr.splice;
-function gr(e) {
-  var t = this.__data__, r = U(t, e);
-  if (r < 0)
-    return !1;
-  var n = t.length - 1;
-  return r == n ? t.pop() : dr.call(t, r, 1), --this.size, !0;
-}
-function _r(e) {
-  var t = this.__data__, r = U(t, e);
-  return r < 0 ? void 0 : t[r][1];
-}
-function hr(e) {
-  return U(this.__data__, e) > -1;
-}
-function yr(e, t) {
-  var r = this.__data__, n = U(r, e);
-  return n < 0 ? (++this.size, r.push([e, t])) : r[n][1] = t, this;
-}
-function A(e) {
-  var t = -1, r = e == null ? 0 : e.length;
-  for (this.clear(); ++t < r; ) {
-    var n = e[t];
-    this.set(n[0], n[1]);
-  }
-}
-A.prototype.clear = lr;
-A.prototype.delete = gr;
-A.prototype.get = _r;
-A.prototype.has = hr;
-A.prototype.set = yr;
-var L = S(T, "Map");
-function br() {
-  this.size = 0, this.__data__ = {
-    hash: new O(),
-    map: new (L || A)(),
-    string: new O()
-  };
-}
-function vr(e) {
-  var t = typeof e;
-  return t == "string" || t == "number" || t == "symbol" || t == "boolean" ? e !== "__proto__" : e === null;
-}
-function z(e, t) {
-  var r = e.__data__;
-  return vr(t) ? r[typeof t == "string" ? "string" : "hash"] : r.map;
-}
-function Tr(e) {
-  var t = z(this, e).delete(e);
-  return this.size -= t ? 1 : 0, t;
-}
-function Ar(e) {
-  return z(this, e).get(e);
-}
-function mr(e) {
-  return z(this, e).has(e);
-}
-function wr(e, t) {
-  var r = z(this, e), n = r.size;
-  return r.set(e, t), this.size += r.size == n ? 0 : 1, this;
-}
-function j(e) {
-  var t = -1, r = e == null ? 0 : e.length;
-  for (this.clear(); ++t < r; ) {
-    var n = e[t];
-    this.set(n[0], n[1]);
-  }
-}
-j.prototype.clear = br;
-j.prototype.delete = Tr;
-j.prototype.get = Ar;
-j.prototype.has = mr;
-j.prototype.set = wr;
-function Or(e, t) {
-  for (var r = -1, n = t.length, i = e.length; ++r < n; )
-    e[i + r] = t[r];
-  return e;
-}
-function $r() {
-  this.__data__ = new A(), this.size = 0;
-}
-function jr(e) {
-  var t = this.__data__, r = t.delete(e);
-  return this.size = t.size, r;
-}
-function Pr(e) {
-  return this.__data__.get(e);
-}
-function Sr(e) {
-  return this.__data__.has(e);
-}
-var xr = 200;
-function Er(e, t) {
-  var r = this.__data__;
-  if (r instanceof A) {
-    var n = r.__data__;
-    if (!L || n.length < xr - 1)
-      return n.push([e, t]), this.size = ++r.size, this;
-    r = this.__data__ = new j(n);
-  }
-  return r.set(e, t), this.size = r.size, this;
-}
-function w(e) {
-  var t = this.__data__ = new A(e);
-  this.size = t.size;
-}
-w.prototype.clear = $r;
-w.prototype.delete = jr;
-w.prototype.get = Pr;
-w.prototype.has = Sr;
-w.prototype.set = Er;
-function Ir(e, t) {
-  for (var r = -1, n = e == null ? 0 : e.length, i = 0, a = []; ++r < n; ) {
-    var u = e[r];
-    t(u, r, e) && (a[i++] = u);
-  }
-  return a;
-}
-function Cr() {
-  return [];
-}
-var Lr = Object.prototype, Mr = Lr.propertyIsEnumerable, ie = Object.getOwnPropertySymbols, Rr = ie ? function(e) {
-  return e == null ? [] : (e = Object(e), Ir(ie(e), function(t) {
-    return Mr.call(e, t);
-  }));
-} : Cr;
-function Dr(e, t, r) {
-  var n = t(e);
-  return G(e) ? n : Or(n, r(e));
-}
-function oe(e) {
-  return Dr(e, kt, Rr);
-}
-var J = S(T, "DataView"), Y = S(T, "Promise"), Z = S(T, "Set"), se = "[object Map]", Fr = "[object Object]", ue = "[object Promise]", fe = "[object Set]", ce = "[object WeakMap]", le = "[object DataView]", Gr = $(J), Nr = $(L), Ur = $(Y), zr = $(Z), Br = $(W), m = M;
-(J && m(new J(new ArrayBuffer(1))) != le || L && m(new L()) != se || Y && m(Y.resolve()) != ue || Z && m(new Z()) != fe || W && m(new W()) != ce) && (m = function(e) {
-  var t = M(e), r = t == Fr ? e.constructor : void 0, n = r ? $(r) : "";
-  if (n)
-    switch (n) {
-      case Gr:
-        return le;
-      case Nr:
-        return se;
-      case Ur:
-        return ue;
-      case zr:
-        return fe;
-      case Br:
-        return ce;
-    }
-  return t;
-});
-var pe = T.Uint8Array, Hr = "__lodash_hash_undefined__";
-function Kr(e) {
-  return this.__data__.set(e, Hr), this;
-}
-function qr(e) {
-  return this.__data__.has(e);
-}
-function N(e) {
-  var t = -1, r = e == null ? 0 : e.length;
-  for (this.__data__ = new j(); ++t < r; )
-    this.add(e[t]);
-}
-N.prototype.add = N.prototype.push = Kr;
-N.prototype.has = qr;
-function Wr(e, t) {
-  for (var r = -1, n = e == null ? 0 : e.length; ++r < n; )
-    if (t(e[r], r, e))
-      return !0;
-  return !1;
-}
-function Xr(e, t) {
-  return e.has(t);
-}
-var Jr = 1, Yr = 2;
-function Se(e, t, r, n, i, a) {
-  var u = r & Jr, o = e.length, s = t.length;
-  if (o != s && !(u && s > o))
-    return !1;
-  var f = a.get(e), g = a.get(t);
-  if (f && g)
-    return f == t && g == e;
-  var d = -1, l = !0, y = r & Yr ? new N() : void 0;
-  for (a.set(e, t), a.set(t, e); ++d < o; ) {
-    var _ = e[d], h = t[d];
-    if (n)
-      var p = u ? n(h, _, d, t, e, a) : n(_, h, d, e, t, a);
-    if (p !== void 0) {
-      if (p)
-        continue;
-      l = !1;
-      break;
-    }
-    if (y) {
-      if (!Wr(t, function(b, v) {
-        if (!Xr(y, v) && (_ === b || i(_, b, r, n, a)))
-          return y.push(v);
-      })) {
-        l = !1;
-        break;
-      }
-    } else if (!(_ === h || i(_, h, r, n, a))) {
-      l = !1;
-      break;
-    }
-  }
-  return a.delete(e), a.delete(t), l;
-}
-function Zr(e) {
-  var t = -1, r = Array(e.size);
-  return e.forEach(function(n, i) {
-    r[++t] = [i, n];
-  }), r;
-}
-function Qr(e) {
-  var t = -1, r = Array(e.size);
-  return e.forEach(function(n) {
-    r[++t] = n;
-  }), r;
-}
-var Vr = 1, kr = 2, en = "[object Boolean]", tn = "[object Date]", rn = "[object Error]", nn = "[object Map]", an = "[object Number]", on = "[object RegExp]", sn = "[object Set]", un = "[object String]", fn = "[object Symbol]", cn = "[object ArrayBuffer]", ln = "[object DataView]", de = P ? P.prototype : void 0, K = de ? de.valueOf : void 0;
-function pn(e, t, r, n, i, a, u) {
-  switch (r) {
-    case ln:
-      if (e.byteLength != t.byteLength || e.byteOffset != t.byteOffset)
-        return !1;
-      e = e.buffer, t = t.buffer;
-    case cn:
-      return !(e.byteLength != t.byteLength || !a(new pe(e), new pe(t)));
-    case en:
-    case tn:
-    case an:
-      return me(+e, +t);
-    case rn:
-      return e.name == t.name && e.message == t.message;
-    case on:
-    case un:
-      return e == t + "";
-    case nn:
-      var o = Zr;
-    case sn:
-      var s = n & Vr;
-      if (o || (o = Qr), e.size != t.size && !s)
-        return !1;
-      var f = u.get(e);
-      if (f)
-        return f == t;
-      n |= kr, u.set(e, t);
-      var g = Se(o(e), o(t), n, i, a, u);
-      return u.delete(e), g;
-    case fn:
-      if (K)
-        return K.call(e) == K.call(t);
-  }
-  return !1;
-}
-var dn = 1, gn = Object.prototype, _n = gn.hasOwnProperty;
-function hn(e, t, r, n, i, a) {
-  var u = r & dn, o = oe(e), s = o.length, f = oe(t), g = f.length;
-  if (s != g && !u)
-    return !1;
-  for (var d = s; d--; ) {
-    var l = o[d];
-    if (!(u ? l in t : _n.call(t, l)))
-      return !1;
-  }
-  var y = a.get(e), _ = a.get(t);
-  if (y && _)
-    return y == t && _ == e;
-  var h = !0;
-  a.set(e, t), a.set(t, e);
-  for (var p = u; ++d < s; ) {
-    l = o[d];
-    var b = e[l], v = t[l];
-    if (n)
-      var Q = u ? n(v, b, l, t, e, a) : n(b, v, l, e, t, a);
-    if (!(Q === void 0 ? b === v || i(b, v, r, n, a) : Q)) {
-      h = !1;
-      break;
-    }
-    p || (p = l == "constructor");
-  }
-  if (h && !p) {
-    var R = e.constructor, D = t.constructor;
-    R != D && "constructor" in e && "constructor" in t && !(typeof R == "function" && R instanceof R && typeof D == "function" && D instanceof D) && (h = !1);
-  }
-  return a.delete(e), a.delete(t), h;
-}
-var yn = 1, ge = "[object Arguments]", _e = "[object Array]", F = "[object Object]", bn = Object.prototype, he = bn.hasOwnProperty;
-function vn(e, t, r, n, i, a) {
-  var u = G(e), o = G(t), s = u ? _e : m(e), f = o ? _e : m(t);
-  s = s == ge ? F : s, f = f == ge ? F : f;
-  var g = s == F, d = f == F, l = s == f;
-  if (l && X(e)) {
-    if (!X(t))
-      return !1;
-    u = !0, g = !1;
-  }
-  if (l && !g)
-    return a || (a = new w()), u || Pe(e) ? Se(e, t, r, n, i, a) : pn(e, t, s, r, n, i, a);
-  if (!(r & yn)) {
-    var y = g && he.call(e, "__wrapped__"), _ = d && he.call(t, "__wrapped__");
-    if (y || _) {
-      var h = y ? e.value() : e, p = _ ? t.value() : t;
-      return a || (a = new w()), i(h, p, r, n, a);
-    }
-  }
-  return l ? (a || (a = new w()), hn(e, t, r, n, i, a)) : !1;
-}
-function xe(e, t, r, n, i) {
-  return e === t ? !0 : e == null || t == null || !I(e) && !I(t) ? e !== e && t !== t : vn(e, t, r, n, xe, i);
-}
-function Tn(e, t) {
-  return xe(e, t);
-}
-function q(e) {
-  return typeof e == "function";
-}
-const mn = (e, t) => {
-  const r = Ee(Ie(e)), n = (a) => (r.value = q(t == null ? void 0 : t.beforeSet) ? t.beforeSet(a) : a, !0), i = (a) => (q(t == null ? void 0 : t.compare) ? t.compare(r.value, a) : Tn(r.value, a)) ? !1 : n(a);
-  return t != null && t.diff || q(t == null ? void 0 : t.compare) ? [r, i] : [r, n];
-}, ye = 1e3 / 60;
-function wn(e, t = ye, r = {}) {
-  const { type: n = "ignoreCallbackTime", loop: i = !0 } = r;
-  t = typeof t == "number" ? t : ye;
-  let a = "running", u = performance.now() + t, o = null, s = null, f = 0, g = typeof i == "number" ? Math.max(1, i) : i ? 1 / 0 : 1;
-  const d = async () => {
-    if (a !== "running") return;
-    const p = performance.now(), b = u - p;
-    if (b <= 0)
-      try {
-        const v = e();
-        if (v instanceof Promise && await v, g = Math.max(0, g - 1), g === 0) {
-          y();
-          return;
-        }
-        u = n === "waitAfterCallback" ? performance.now() + t : p + t;
-      } finally {
-        l();
-      }
-    else
-      l(b);
-  }, l = (p = t) => {
-    if (a !== "running") return;
-    const b = t * 1.5, v = Math.max(0, p - 5);
-    o && clearTimeout(o), s && cancelAnimationFrame(s), p > b ? o = setTimeout(() => {
-      s = requestAnimationFrame(d);
-    }, v) : s = requestAnimationFrame(d);
-  }, y = () => {
-    a = "stopped", o && clearTimeout(o), s && cancelAnimationFrame(s), o = s = null;
-  }, _ = () => {
-    a === "running" && (a = "paused", f = performance.now(), o && clearTimeout(o), s && cancelAnimationFrame(s), o = s = null);
-  }, h = () => {
-    if (a === "stopped" || a === "running") return;
-    const p = performance.now() - f;
-    u += p, a = "running", l();
-  };
-  return l(), { stop: y, pause: _, start: h };
-}
+import { useState as o } from "./useState.js";
+import { useRafTimer as f } from "./useTimer.js";
 export {
-  wn as useRafTimer,
-  mn as useState
+  f as useRafTimer,
+  o as useState
 };

package/dist/types/index.d.ts

@@ -1,2 +1,9 @@
-export { useState } from './useState';
-export { useRafTimer } from './useTimer';
+/** @file 库统一出口，聚合导出全部 Hook 及其类型定义 */
+/** 带差异比较能力的状态 Hook */
+export { useState } from './useState/index.js';
+/** 状态 Hook 关联类型：配置项、状态引用与返回元组 */
+export type { UseStateConfig, UseStateRef, UseStateReturn } from './useState/index.js';
+/** 基于 requestAnimationFrame 的定时器 Hook */
+export { useRafTimer } from './useTimer/index.js';
+/** 定时器 Hook 关联类型：回调、控制函数与配置项 */
+export type { Callback, ControlFunctions, RafTimerOptions } from './useTimer/index.js';