mp-taro-kit 0.0.3 → 0.0.4

package/dist/utils/string.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeTrim = safeTrim;
+exports.baseNameOf = baseNameOf;
+exports.truncateBytes = truncateBytes;
+/** 去首尾空白；非字符串（null / undefined / number）安全返回空串。 */
+function safeTrim(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * 路径取末段（`/` 与 `\` 都认）。先剔尾斜杠，否则目录 `b/` 会渲染成空标签。
+ */
+function baseNameOf(path) {
+    if (typeof path !== 'string')
+        return '';
+    const trimmed = path.replace(/[\\/]+$/, '');
+    if (trimmed === '')
+        return path;
+    const cut = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\'));
+    return cut < 0 ? trimmed : trimmed.slice(cut + 1);
+}
+function utf8Size(codePoint) {
+    if (codePoint <= 0x7f)
+        return 1;
+    if (codePoint <= 0x7ff)
+        return 2;
+    if (codePoint <= 0xffff)
+        return 3;
+    return 4;
+}
+/** 按 UTF-8 字节截断（中文 3 字节、emoji 4 字节），不切半个码点。 */
+// 自己按码点算字节，不依赖 TextEncoder —— 小程序运行时未必提供该全局。
+function truncateBytes(text, maxBytes, suffix = '…') {
+    if (typeof text !== 'string' || !Number.isFinite(maxBytes) || maxBytes <= 0)
+        return '';
+    let total = 0;
+    for (const ch of text)
+        total += utf8Size(ch.codePointAt(0) ?? 0);
+    if (total <= maxBytes)
+        return text;
+    let suffixBytes = 0;
+    for (const ch of suffix)
+        suffixBytes += utf8Size(ch.codePointAt(0) ?? 0);
+    const budget = maxBytes - suffixBytes;
+    let out = '';
+    let used = 0;
+    for (const ch of budget <= 0 ? suffix : text) {
+        const size = utf8Size(ch.codePointAt(0) ?? 0);
+        if (used + size > (budget <= 0 ? maxBytes : budget))
+            break;
+        used += size;
+        out += ch;
+    }
+    return budget <= 0 ? out : out + suffix;
+}

package/dist/utils/string.d.ts

@@ -0,0 +1,8 @@
+/** 去首尾空白；非字符串（null / undefined / number）安全返回空串。 */
+export declare function safeTrim(value: unknown): string;
+/**
+ * 路径取末段（`/` 与 `\` 都认）。先剔尾斜杠，否则目录 `b/` 会渲染成空标签。
+ */
+export declare function baseNameOf(path: string): string;
+/** 按 UTF-8 字节截断（中文 3 字节、emoji 4 字节），不切半个码点。 */
+export declare function truncateBytes(text: string, maxBytes: number, suffix?: string): string;

package/dist/utils/string.js

@@ -0,0 +1,50 @@
+/** 去首尾空白；非字符串（null / undefined / number）安全返回空串。 */
+export function safeTrim(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * 路径取末段（`/` 与 `\` 都认）。先剔尾斜杠，否则目录 `b/` 会渲染成空标签。
+ */
+export function baseNameOf(path) {
+    if (typeof path !== 'string')
+        return '';
+    const trimmed = path.replace(/[\\/]+$/, '');
+    if (trimmed === '')
+        return path;
+    const cut = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\'));
+    return cut < 0 ? trimmed : trimmed.slice(cut + 1);
+}
+function utf8Size(codePoint) {
+    if (codePoint <= 0x7f)
+        return 1;
+    if (codePoint <= 0x7ff)
+        return 2;
+    if (codePoint <= 0xffff)
+        return 3;
+    return 4;
+}
+/** 按 UTF-8 字节截断（中文 3 字节、emoji 4 字节），不切半个码点。 */
+// 自己按码点算字节，不依赖 TextEncoder —— 小程序运行时未必提供该全局。
+export function truncateBytes(text, maxBytes, suffix = '…') {
+    if (typeof text !== 'string' || !Number.isFinite(maxBytes) || maxBytes <= 0)
+        return '';
+    let total = 0;
+    for (const ch of text)
+        total += utf8Size(ch.codePointAt(0) ?? 0);
+    if (total <= maxBytes)
+        return text;
+    let suffixBytes = 0;
+    for (const ch of suffix)
+        suffixBytes += utf8Size(ch.codePointAt(0) ?? 0);
+    const budget = maxBytes - suffixBytes;
+    let out = '';
+    let used = 0;
+    for (const ch of budget <= 0 ? suffix : text) {
+        const size = utf8Size(ch.codePointAt(0) ?? 0);
+        if (used + size > (budget <= 0 ? maxBytes : budget))
+            break;
+        used += size;
+        out += ch;
+    }
+    return budget <= 0 ? out : out + suffix;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mp-taro-kit",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "基于 Taro + React 的小程序基础库（kit）：UI 容器能力与通用操作功能封装（占位发布，API 未定）",
   "license": "MIT",
   "type": "module",
@@ -70,12 +70,14 @@
     "ui"
   ],
   "devDependencies": {
+    "@tarojs/components": "^4.3.2",
+    "@types/react": "^18.3.31",
     "sass": "^1.107.1",
     "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "node scripts/build.mjs",
-    "test": "node scripts/check.mjs",
+    "test": "node scripts/check.mjs && node --test tests/*.test.mjs",
     "guard": "node scripts/check.mjs --release"
   }
 }