yann-core 0.0.1 → 1.1.0

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';

package/dist/types/useState/index.d.ts

@@ -1,8 +1,37 @@
-import { MaybeRefOrGetter, Ref } from 'vue';
-export type UseStateReturn<T> = [Ref<T>, (newVal: T) => boolean];
-export interface UseStateConfig<T> {
+import { MaybeRefOrGetter, Ref, ShallowRef, UnwrapRef } from 'vue';
+/** 检测类型 T 是否为 any；是 any 时取 Yes 分支，否则取 No */
+type IfAny<T, Yes, No> = 0 extends (1 & T) ? Yes : No;
+/** 深层的状态引用类型：普通 Ref 原样返回，其余展开为 UnwrapRef 包装 */
+type DeepStateRef<T> = [T] extends [Ref] ? IfAny<T, Ref<T>, T> : Ref<UnwrapRef<T>, UnwrapRef<T> | T>;
+/** 浅层的状态引用类型：仅做一层包装，避免深层解包 */
+type ShallowStateRef<T> = Ref extends T ? T extends Ref ? IfAny<T, ShallowRef<T>, T> : ShallowRef<T> : ShallowRef<T>;
+/** useState 返回的状态引用类型，按 shallow 开关在深浅两种引用间切换 */
+export type UseStateRef<T, Shallow extends boolean = false> = Shallow extends true ? ShallowStateRef<T> : DeepStateRef<T>;
+/** useState 的返回元组：[状态引用, 写入函数] */
+export type UseStateReturn<T, Shallow extends boolean = false> = [
+    UseStateRef<T, Shallow>,
+    (newVal: T) => boolean
+];
+/** useState 的配置项 */
+export interface UseStateConfig<T, Shallow extends boolean = false> {
+    /** 是否使用浅层引用（true 时不做深层响应式转换） */
+    shallow?: Shallow;
+    /** 是否启用差异比较，相等则跳过写入 */
     diff?: boolean;
-    compare?: (oldVal: T, newVal: T) => boolean;
+    /** 自定义相等判定，返回真表示新旧值相等、无需写入 */
+    compare?: (oldVal: UseStateRef<T, Shallow>['value'], newVal: T) => boolean;
+    /** 写入前的拦截钩子，可返回加工后的新值 */
     beforeSet?: (newVal: T) => T;
 }
-export declare const useState: <T>(source: MaybeRefOrGetter<T>, config?: UseStateConfig<T>) => UseStateReturn<T>;
+/**
+ * 创建带差异比较与写入拦截能力的响应式状态
+ * @param source 初始值来源，支持值、Ref 或 getter
+ * @param config 配置项；shallow 为 true 时返回浅层引用
+ * @returns 元组 [状态引用, 写入函数]，写入函数返回是否发生实际写入
+ */
+export declare function useState<T>(source: MaybeRefOrGetter<T>, config: UseStateConfig<T, true> & {
+    shallow: true;
+}): UseStateReturn<T, true>;
+export declare function useState<T>(source: MaybeRefOrGetter<T>, config?: UseStateConfig<T, false>): UseStateReturn<T, false>;
+export declare function useState<T>(source: MaybeRefOrGetter<T>, config?: UseStateConfig<T, boolean>): UseStateReturn<T, boolean>;
+export {};

package/dist/types/useTimer/index.d.ts

@@ -1,12 +1,28 @@
-type Callback = () => void | Promise<void>;
-type ControlFunctions = {
+/** 定时器回调，可同步返回，也可返回 thenable 表示异步 */
+export type Callback = () => void | PromiseLike<void>;
+/** 定时器控制器 */
+export interface ControlFunctions {
+    /** 永久停止并释放定时器，不可再启动 */
     stop: () => void;
+    /** 暂停计时，保持已消耗的逻辑时间 */
     pause: () => void;
+    /** 从暂停处恢复计时 */
     start: () => void;
-};
-interface RafTimerOptions {
+}
+/** 定时器配置项 */
+export interface RafTimerOptions {
+    /** 计时基准：waitAfterCallback 回调完成后计时，ignoreCallbackTime 忽略回调耗时 */
     type?: 'waitAfterCallback' | 'ignoreCallbackTime';
+    /** 循环方式：true 无限循环、false 仅一次、数字表示循环次数 */
     loop?: boolean | number;
+    /** 回调同步抛错或返回的 thenable 拒绝时的处理器 */
+    onError?: (error: unknown) => void | PromiseLike<void>;
 }
+/**
+ * 创建基于动画帧的定时器
+ * @param callback 每帧触发的回调
+ * @param interval 触发间隔（毫秒），缺省按 60fps 计算
+ * @param options 定时器配置项
+ * @returns 含 stop / pause / start 的控制器
+ */
 export declare function useRafTimer(callback: Callback, interval?: number, options?: RafTimerOptions): ControlFunctions;
-export {};