ranuts 0.5.0 → 0.5.1

package/dist/src/utils/script.js

@@ -1,46 +1,45 @@
-var d = /* @__PURE__ */ new Set(), p = ({ type: t, content: o }) => new Promise((r, a) => {
-  const e = `${t}:${o}`;
-  if (d.has(e)) {
-    r({ success: !0 });
-    return;
+var a = /* @__PURE__ */ new Map(), m = ({ type: s, content: o }) => {
+  const r = `${s}:${o}`, c = a.get(r);
+  if (c) return c;
+  const e = document.createElement("script");
+  if (s === "content") {
+    e.textContent = o, document.body.append(e);
+    const t = Promise.resolve({ success: !0 });
+    return a.set(r, t), t;
   }
-  const n = document.createElement("script");
-  if (n.onload = function() {
-    d.add(e), r({ success: !0 });
-  }, n.onerror = function(s) {
-    a({
-      success: !1,
-      error: s
-    });
-  }, t === "content") {
-    n.textContent = o, document.body.append(n), d.add(e), r({ success: !0 });
-    return;
-  }
-  n.src = o, document.body.append(n);
-}), m = (t, o, r) => {
-  t = Array.isArray(t) ? t : [t];
-  const a = t.map((e) => {
-    const n = e.toLowerCase().endsWith(".css");
-    let s;
-    if (n) {
-      const c = document.createElement("link");
-      c.type = "text/css", c.rel = "stylesheet", c.href = e, s = c;
+  const i = new Promise((t, d) => {
+    e.onload = () => t({ success: !0 }), e.onerror = (n) => {
+      a.delete(r), e.remove(), d({
+        success: !1,
+        error: n
+      });
+    };
+  });
+  return a.set(r, i), e.src = o, document.body.append(e), i;
+}, p = (s, o, r) => {
+  s = Array.isArray(s) ? s : [s];
+  const c = s.map((e) => {
+    const i = e.toLowerCase().endsWith(".css");
+    let t;
+    if (i) {
+      const n = document.createElement("link");
+      n.type = "text/css", n.rel = "stylesheet", n.href = e, t = n;
     } else
-      s = document.createElement("script"), s.type = "text/javascript", s.src = e;
-    const i = document.getElementsByTagName("body")[0];
-    return (o || i).appendChild(s), new Promise((c) => {
-      s.onload = () => {
-        c();
+      t = document.createElement("script"), t.type = "text/javascript", t.src = e;
+    const d = document.getElementsByTagName("body")[0];
+    return (o || d).appendChild(t), new Promise((n) => {
+      t.onload = () => {
+        n();
       };
     });
   });
   return new Promise((e) => {
-    Promise.all(a).then(() => {
+    Promise.all(c).then(() => {
       r && r(), e();
     });
   });
 };
 export {
-  p as loadScript,
-  m as scriptOnLoad
+  m as loadScript,
+  p as scriptOnLoad
 };

package/dist/src/utils/scroll.d.ts

@@ -41,6 +41,8 @@ export interface BottomFollowerOptions {
     observe?: readonly HTMLElement[];
     /** Distance from the floor still counted as pinned. Defaults to 24. */
     threshold?: number;
+    /** Current intent for automatic following; explicit navigation remains available. */
+    enabled?: () => boolean;
     /**
      * Called when the pinned state flips, so a caller can show or hide a "jump to latest"
      * affordance. Never called for a change the caller itself just made synchronously.

package/dist/src/utils/scroll.js

@@ -1,42 +1,42 @@
 var b = 24;
-function H(r) {
-  return Math.max(0, r.scrollHeight - r.clientHeight);
+function H(l) {
+  return Math.max(0, l.scrollHeight - l.clientHeight);
 }
-function h(r, e) {
-  return r.getBoundingClientRect().top - e.getBoundingClientRect().top;
+function h(l, e) {
+  return l.getBoundingClientRect().top - e.getBoundingClientRect().top;
 }
-function m(r) {
-  const { scrollport: e, observe: u = [], threshold: g = b, onPinnedChange: T } = r;
-  let l = !0, n = e.scrollTop, t = null, f = !1;
-  const p = (o) => {
-    o !== l && (l = o, T?.(o));
+function m(l) {
+  const { scrollport: e, observe: f = [], threshold: g = b, onPinnedChange: T } = l;
+  let r = !0, n = e.scrollTop, t = null, c = !1;
+  const a = (o) => {
+    o !== r && (r = o, T?.(o));
   }, s = (o) => {
     e.scrollTop = o, n = e.scrollTop;
-  }, a = () => {
-    t = null, s(e.scrollHeight), p(!0);
   }, d = () => {
+    t = null, s(e.scrollHeight), a(!0);
+  }, p = () => {
     const o = H(e);
     if (!(Math.abs(e.scrollTop - Math.min(n, o)) > 0.5)) {
-      l ? a() : n = e.scrollTop;
+      r && l.enabled?.() !== !1 ? d() : n = e.scrollTop;
       return;
     }
-    n = e.scrollTop, p(o - e.scrollTop <= g);
+    n = e.scrollTop, a(o - e.scrollTop <= g);
   };
-  e.addEventListener("scroll", d, { passive: !0 });
-  let c = null;
-  if (u.length > 0 && typeof ResizeObserver < "u") {
-    c = new ResizeObserver(() => {
-      l && !f && s(e.scrollHeight);
+  e.addEventListener("scroll", p, { passive: !0 });
+  let i = null;
+  if (f.length > 0 && typeof ResizeObserver < "u") {
+    i = new ResizeObserver(() => {
+      r && !c && l.enabled?.() !== !1 && s(e.scrollHeight);
     });
-    for (const o of u) c.observe(o);
+    for (const o of f) i.observe(o);
   }
   return {
     get pinned() {
-      return l;
+      return r;
     },
-    toBottom: a,
+    toBottom: d,
     follow() {
-      l && s(e.scrollHeight);
+      r && !c && l.enabled?.() !== !1 && s(e.scrollHeight);
     },
     captureAnchor(o) {
       t = {
@@ -46,14 +46,14 @@ function m(r) {
     },
     restoreAnchor(o) {
       if (t === null) return !1;
-      const i = o === void 0 ? t.row : o(), { top: v } = t;
-      return t = null, i === null || !e.contains(i) ? !1 : (s(e.scrollTop + h(i, e) - v), !0);
+      const u = o === void 0 ? t.row : o(), { top: v } = t;
+      return t = null, u === null || !e.contains(u) ? !1 : (s(e.scrollTop + h(u, e) - v), !0);
     },
     releaseAnchor() {
       t = null;
     },
     destroy() {
-      f = !0, e.removeEventListener("scroll", d), c?.disconnect();
+      c = !0, e.removeEventListener("scroll", p), i?.disconnect();
     }
   };
 }

package/dist/src/utils/str.d.ts

@@ -43,16 +43,6 @@ export declare const clearStr: (str: string, options?: ClearStrOption) => string
  */
 export declare function getMatchingSentences(text: string, searchValue: string): string[];
 export declare const toString: (value: string | number) => string;
-export declare const checkEncoding: (uint8Array: Uint8Array) => string;
-/**
- * @description: Decode bytes into a string using the sniffed encoding. Required when reading
- * text files of unknown provenance (a user-uploaded txt, content scraped off an old site) —
- * a plain `new TextDecoder().decode()` turns GBK/Big5 into mojibake, and such files are a
- * sizeable share of Chinese-language content.
- * @param {ArrayBuffer | Uint8Array} buffer
- * @return {string}
- */
-export declare const arrayBufferToString: (buffer: ArrayBuffer | Uint8Array) => string;
 /**
  * @description: Convert full-width characters to half-width (digits, letters, punctuation and
  * the ideographic space). Full-width digits produced by a Chinese IME are not equivalent to
@@ -102,11 +92,6 @@ export interface TruncateOptions {
  * ```
  */
 export declare const truncate: (value: string, options: TruncateOptions | number) => string;
-export interface TransformText {
-    encoding: string;
-    content: string;
-}
-export declare const transformText: (content: string | ArrayBuffer) => TransformText | undefined;
 /**
  * @description: A short random-ish base-36 string.
  *

package/dist/src/utils/str.js

@@ -1,11 +1,10 @@
-import { detect as w } from "jschardet";
-var m = (r = "", e = "", t = "") => {
+var w = (r = "", e = "", t = "") => {
   const n = {}, o = r.split(e);
-  return o.length > 0 && o.forEach((a) => {
-    const [h = "", s = ""] = a.split(t);
+  return o.length > 0 && o.forEach((c) => {
+    const [h = "", s = ""] = c.split(t);
     u(h) && (n[u(h)] = u(s));
   }), n;
-}, E = (r = "") => {
+}, g = (r = "") => {
   if (r.length === 0) return "";
   let e = "", t = 0;
   for (const n of r)
@@ -21,8 +20,8 @@ var m = (r = "", e = "", t = "") => {
       t === 0 && (e += n);
     }
   return e;
-}, A = (r) => window.toString.call(r) === "[object String]";
-function C(r = 8) {
+}, p = (r) => window.toString.call(r) === "[object String]";
+function m(r = 8) {
   const e = "ABCDEFGHJKMNPQRSTWXYZabcdefhijkmnprstwxyz2345678";
   let n = "";
   for (let o = 0; o < r; o++) n += e.charAt(Math.floor(Math.random() * 48));
@@ -32,83 +31,69 @@ var u = (r, e = {}) => {
   const { urlencoded: t = !0 } = e, n = String.prototype.trim.call(r);
   return t ? decodeURIComponent(n).replace(/"|'/g, "") : n.replace(/"|'/g, "");
 };
-function S(r, e) {
+function E(r, e) {
   if (!r || !e) return [];
   const t = [], n = new RegExp(e, "gi");
   let o;
   for (; (o = n.exec(r)) !== null; ) {
     const s = o.index;
-    let c = s;
-    for (; c > 0; ) {
-      const i = r[c - 1];
-      if (i === "。" || i === "." || i === `
-` || i === "！" || i === "?" || i === "？") break;
-      c--;
+    let a = s;
+    for (; a > 0; ) {
+      const d = r[a - 1];
+      if (d === "。" || d === "." || d === `
+` || d === "！" || d === "?" || d === "？") break;
+      a--;
     }
     let l = s + e.length;
     for (; l < r.length; ) {
-      const i = r[l];
-      if (i === "。" || i === "." || i === `
-` || i === "！" || i === "?" || i === "？") {
+      const d = r[l];
+      if (d === "。" || d === "." || d === `
+` || d === "！" || d === "?" || d === "？") {
         l++;
         break;
       }
       l++;
     }
-    const f = r.slice(c, l).trim();
+    const f = r.slice(a, l).trim();
     f && t.push({
       sentence: f,
-      start: c,
+      start: a,
       end: l
     });
   }
-  const a = [], h = [];
-  t.sort((s, c) => c.sentence.length - s.sentence.length);
-  for (const s of t) h.some((c) => !(s.end <= c.start || s.start >= c.end)) || (a.push(s.sentence), h.push({
+  const c = [], h = [];
+  t.sort((s, a) => a.sentence.length - s.sentence.length);
+  for (const s of t) h.some((a) => !(s.end <= a.start || s.start >= a.end)) || (c.push(s.sentence), h.push({
     start: s.start,
     end: s.end
   }));
-  return [...new Set(a)];
+  return [...new Set(c)];
 }
-var v = (r) => String(r), g = (r) => {
-  const e = Array.from(r).map((t) => String.fromCharCode(t)).join("");
-  return w(e).encoding || "utf-8";
-}, R = (r) => {
-  const e = r instanceof Uint8Array ? r : new Uint8Array(r);
-  return new TextDecoder(g(e)).decode(e);
-}, I = (r) => r.replace(/[！-～]/g, (e) => String.fromCharCode(e.charCodeAt(0) - 65248)).replace(/\u3000/g, " "), b = (r) => r.replace(/[!-~]/g, (e) => String.fromCharCode(e.charCodeAt(0) + 65248)).replace(/ /g, "　"), M = (r, e) => {
+var C = (r) => String(r), A = (r) => r.replace(/[！-～]/g, (e) => String.fromCharCode(e.charCodeAt(0) - 65248)).replace(/\u3000/g, " "), S = (r) => r.replace(/[!-~]/g, (e) => String.fromCharCode(e.charCodeAt(0) + 65248)).replace(/ /g, "　"), R = (r, e) => {
   const { length: t, position: n = "end", ellipsis: o = "…" } = typeof e == "number" ? { length: e } : e;
   if (!r) return r;
-  const a = Array.from(r), h = Array.from(o);
-  if (a.length <= t) return r;
+  const c = Array.from(r), h = Array.from(o);
+  if (c.length <= t) return r;
   if (t <= h.length) return h.slice(0, Math.max(0, t)).join("");
   const s = t - h.length;
-  if (n === "start") return o + a.slice(a.length - s).join("");
+  if (n === "start") return o + c.slice(c.length - s).join("");
   if (n === "middle") {
-    const c = Math.ceil(s / 2);
-    return a.slice(0, c).join("") + o + a.slice(a.length - (s - c)).join("");
+    const a = Math.ceil(s / 2);
+    return c.slice(0, a).join("") + o + c.slice(c.length - (s - a)).join("");
   }
-  return a.slice(0, s).join("") + o;
-}, D = (r) => {
-  if (r instanceof ArrayBuffer) {
-    const e = new Uint8Array(r), t = String.fromCharCode.apply(null, e), n = w(t), o = n.encoding || "utf-8", a = new TextDecoder(o).decode(r);
-    if (n.encoding && a) return {
-      encoding: n.encoding,
-      content: a
-    };
-  }
-}, U = (r = 8) => Math.random().toString(36).substring(2, r + 2), d = class extends Error {
+  return c.slice(0, s).join("") + o;
+}, b = (r = 8) => Math.random().toString(36).substring(2, r + 2), i = class extends Error {
   code;
   constructor(r, e) {
     super(r), this.code = e, this.name = "MessageCodecError";
   }
-}, B = {
+}, v = {
   encode(r) {
     try {
       const e = JSON.stringify(r), t = new TextEncoder().encode(e);
       let n = "";
       const o = 32768;
-      for (let a = 0; a < t.length; a += o) n += String.fromCharCode.apply(null, Array.from(t.subarray(a, a + o)));
+      for (let c = 0; c < t.length; c += o) n += String.fromCharCode.apply(null, Array.from(t.subarray(c, c + o)));
       return btoa(n);
     } catch {
       return "";
@@ -136,20 +121,20 @@ var v = (r) => String(r), g = (r) => {
         content: new Uint8Array(e)
       });
     } catch (e) {
-      throw new d(`Failed to encode file: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_ENCODE_ERROR");
+      throw new i(`Failed to encode file: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_ENCODE_ERROR");
     }
   },
   decodeFile(r) {
     try {
       const e = this.decode(r);
-      if (e.type !== "File") throw new d(`Expected File type but got ${e.type}`, "INVALID_FILE_TYPE");
+      if (e.type !== "File") throw new i(`Expected File type but got ${e.type}`, "INVALID_FILE_TYPE");
       const t = e, n = t.content instanceof Uint8Array ? t.content.buffer.slice(0) : t.content;
       return new File([n], t.name, {
         type: t.mimeType,
         lastModified: t.lastModified
       });
     } catch (e) {
-      throw e instanceof d ? e : new d(`Failed to decode file: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_DECODE_ERROR");
+      throw e instanceof i ? e : new i(`Failed to decode file: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_DECODE_ERROR");
     }
   },
   async encodeBlob(r) {
@@ -162,17 +147,17 @@ var v = (r) => String(r), g = (r) => {
         content: new Uint8Array(e)
       });
     } catch (e) {
-      throw new d(`Failed to encode blob: ${e instanceof Error ? e.message : "Unknown error"}`, "BLOB_ENCODE_ERROR");
+      throw new i(`Failed to encode blob: ${e instanceof Error ? e.message : "Unknown error"}`, "BLOB_ENCODE_ERROR");
     }
   },
   decodeBlob(r) {
     try {
       const e = this.decode(r);
-      if (e.type !== "Blob") throw new d(`Expected Blob type but got ${e.type}`, "INVALID_BLOB_TYPE");
+      if (e.type !== "Blob") throw new i(`Expected Blob type but got ${e.type}`, "INVALID_BLOB_TYPE");
       const t = e, n = t.content instanceof Uint8Array ? t.content.buffer.slice(0) : t.content;
       return new Blob([n], { type: t.mimeType });
     } catch (e) {
-      throw e instanceof d ? e : new d(`Failed to decode blob: ${e instanceof Error ? e.message : "Unknown error"}`, "BLOB_DECODE_ERROR");
+      throw e instanceof i ? e : new i(`Failed to decode blob: ${e instanceof Error ? e.message : "Unknown error"}`, "BLOB_DECODE_ERROR");
     }
   },
   encodeDate(r) {
@@ -316,10 +301,10 @@ var v = (r) => String(r), g = (r) => {
   },
   async encodeFileChunked(r, e = 16384) {
     try {
-      if (e <= 0) throw new d("Chunk size must be greater than 0", "INVALID_CHUNK_SIZE");
+      if (e <= 0) throw new i("Chunk size must be greater than 0", "INVALID_CHUNK_SIZE");
       const t = Math.ceil(r.size / e), n = [];
       for (let o = 0; o < t; o++) {
-        const a = o * e, h = Math.min(a + e, r.size), s = await r.slice(a, h).arrayBuffer(), c = String.fromCharCode.apply(null, Array.from(new Uint8Array(s)));
+        const c = o * e, h = Math.min(c + e, r.size), s = await r.slice(c, h).arrayBuffer(), a = String.fromCharCode.apply(null, Array.from(new Uint8Array(s)));
         n.push({
           name: r.name,
           type: r.type,
@@ -327,38 +312,38 @@ var v = (r) => String(r), g = (r) => {
           lastModified: r.lastModified,
           totalChunks: t,
           chunkIndex: o,
-          data: c
+          data: a
         });
       }
       return n;
     } catch (t) {
-      throw t instanceof d ? t : new d(`Failed to encode file chunks: ${t instanceof Error ? t.message : "Unknown error"}`, "FILE_CHUNK_ENCODE_ERROR");
+      throw t instanceof i ? t : new i(`Failed to encode file chunks: ${t instanceof Error ? t.message : "Unknown error"}`, "FILE_CHUNK_ENCODE_ERROR");
     }
   },
   async decodeFileChunked(r) {
     try {
-      if (!r.length) throw new d("No chunks provided", "NO_CHUNKS");
+      if (!r.length) throw new i("No chunks provided", "NO_CHUNKS");
       const { type: e, lastModified: t, totalChunks: n } = r[0];
-      if (r.length !== n) throw new d(`Missing chunks. Expected ${n}, got ${r.length}`, "INCOMPLETE_CHUNKS");
-      r.sort((c, l) => c.chunkIndex - l.chunkIndex);
-      for (let c = 0; c < r.length; c++) if (r[c].chunkIndex !== c) throw new d(`Invalid chunk index at position ${c}`, "INVALID_CHUNK_ORDER");
-      const o = await Promise.all(r.map(async (c) => {
-        const l = c.data, f = new Uint8Array(l.length);
-        for (let i = 0; i < l.length; i++) f[i] = l.charCodeAt(i);
+      if (r.length !== n) throw new i(`Missing chunks. Expected ${n}, got ${r.length}`, "INCOMPLETE_CHUNKS");
+      r.sort((a, l) => a.chunkIndex - l.chunkIndex);
+      for (let a = 0; a < r.length; a++) if (r[a].chunkIndex !== a) throw new i(`Invalid chunk index at position ${a}`, "INVALID_CHUNK_ORDER");
+      const o = await Promise.all(r.map(async (a) => {
+        const l = a.data, f = new Uint8Array(l.length);
+        for (let d = 0; d < l.length; d++) f[d] = l.charCodeAt(d);
         return f;
-      })), a = r.reduce((c, l) => c + l.data.length, 0), h = new Uint8Array(a);
+      })), c = r.reduce((a, l) => a + l.data.length, 0), h = new Uint8Array(c);
       let s = 0;
-      for (const c of o)
-        h.set(c, s), s += c.length;
+      for (const a of o)
+        h.set(a, s), s += a.length;
       return new File([h.buffer.slice(0)], r[0].name, {
         type: e,
         lastModified: t
       });
     } catch (e) {
-      throw e instanceof d ? e : new d(`Failed to decode file chunks: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_CHUNK_DECODE_ERROR");
+      throw e instanceof i ? e : new i(`Failed to decode file chunks: ${e instanceof Error ? e.message : "Unknown error"}`, "FILE_CHUNK_DECODE_ERROR");
     }
   }
-}, _ = (r, e, t = "…[truncated]") => r.length > e ? r.slice(0, e) + t : r, x = (r, e = "") => {
+}, I = (r, e, t = "…[truncated]") => r.length > e ? r.slice(0, e) + t : r, M = (r, e = "") => {
   const t = Math.max(0, ...Array.from(r.matchAll(/`+/g), (o) => o[0].length)), n = "`".repeat(Math.max(3, t + 1));
   return `${n}${e}
 ${r}
@@ -368,28 +353,25 @@ ${n}`;
   for (; e < t && r[e] === "-"; ) e++;
   for (; t > e && r[t - 1] === "-"; ) t--;
   return r.slice(e, t);
-}, F = (r, e = 60) => y(y(r.toLowerCase().replace(/[^a-z0-9]+/g, "-")).slice(0, e)), O = (r) => {
+}, D = (r, e = 60) => y(y(r.toLowerCase().replace(/[^a-z0-9]+/g, "-")).slice(0, e)), B = (r) => {
   const e = String(r), t = /^[=+\-@]/.test(e) ? `'${e}` : e;
   return /[",\n\r]/.test(t) ? `"${t.replace(/"/g, '""')}"` : t;
 };
 export {
-  B as MessageCodec,
-  R as arrayBufferToString,
-  g as checkEncoding,
-  E as clearBr,
+  v as MessageCodec,
+  g as clearBr,
   u as clearStr,
-  O as csvEscape,
-  x as fenceCode,
-  S as getMatchingSentences,
-  U as getRandomString,
-  A as isString,
-  C as randomString,
-  F as slugify,
-  m as strParse,
-  b as toFullWidth,
-  I as toHalfWidth,
-  v as toString,
-  D as transformText,
-  M as truncate,
-  _ as truncateWithMarker
+  B as csvEscape,
+  M as fenceCode,
+  E as getMatchingSentences,
+  b as getRandomString,
+  p as isString,
+  m as randomString,
+  D as slugify,
+  w as strParse,
+  S as toFullWidth,
+  A as toHalfWidth,
+  C as toString,
+  R as truncate,
+  I as truncateWithMarker
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ranuts",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Tree-shakeable TypeScript utility library: DOM/BOM helpers, string/object/number/color utils, debounce/throttle/compose, a 2D rendering engine and a virtual DOM.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -95,11 +95,11 @@
     "@types/node": "26.1.2",
     "@vitest/coverage-v8": "4.1.11",
     "@webgpu/types": "0.1.71",
-    "jsdom": "29.1.1",
+    "jsdom": "30.0.1",
     "terser": "5.49.2",
     "tsx": "4.23.10",
     "typescript": "7.0.2",
-    "vite": "8.2.1",
+    "vite": "8.2.4",
     "vitest": "4.1.11"
   },
   "dependencies": {
@@ -109,7 +109,7 @@
     "build": "sh ./bin/build.sh",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "verify:package": "node bin/verify-package.mjs",
+    "verify:package": "node bin/verify-package.ts",
     "tsc": "tsc --noEmit",
     "dev": "vite --host",
     "doc:api": "tsx ./bin/generate-api-docs.ts",