@neut/ui 0.0.9 → 0.0.11

package/dist/utils/clsx.js.map

@@ -1 +1 @@
-{"version":3,"file":"clsx.js","names":[],"sources":["../../src/utils/clsx.ts"],"sourcesContent":["import { twMerge } from \"tailwind-merge\";\n\nexport const clsx = (...classes: (string | undefined | false)[]): string => {\n  return twMerge(classes.filter(Boolean));\n};\n"],"mappings":";;AAEA,IAAa,KAAQ,GAAG,MACf,EAAQ,EAAQ,OAAO,QAAQ,CAAC"}
+{"version":3,"file":"clsx.js","names":[],"sources":["../../src/utils/clsx.ts"],"sourcesContent":["import { twMerge } from \"tailwind-merge\";\n\nexport const clsx = (...classes: (string | undefined | false)[]): string => {\n  return twMerge(classes.filter(Boolean));\n};\n"],"mappings":";;AAEA,IAAa,KAAQ,GAAG,MACf,EAAQ,EAAQ,OAAO,OAAO,CAAC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export { clsx } from './clsx';
+export * from './logger';
 export { warnOnce } from './warn-once';

package/dist/utils/index.js

@@ -1,3 +1,4 @@
 import { clsx as e } from "./clsx.js";
-import { warnOnce as t } from "./warn-once.js";
-export { e as clsx, t as warnOnce };
+import { Logger as t, logger as n } from "./logger.js";
+import { warnOnce as r } from "./warn-once.js";
+export { t as Logger, e as clsx, n as logger, r as warnOnce };

package/dist/utils/logger.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 极简日志库
+ *
+ * 两套 API，按场景选用：
+ *
+ * 1. logger.debug/info/warn/error —— 精确行号版
+ *    直接 bind 原生 console 方法，浏览器控制台会指向真实的业务代码调用行，
+ *    可点击跳转。生产环境（import.meta.env.DEV === false）自动变成空函数，
+ *    构建时会被死代码消除，几乎不占体积、不产生开销。
+ *    适合：普通业务日志，调用频率不高。
+ *
+ * 2. logger.hot(tag) —— 高频热路径版
+ *    用于循环内部、高频事件回调等会产生大量日志的场景。
+ *    牺牲了精确行号（控制台里显示的是 hot() 内部位置，但会带上 tag 前缀
+ *    方便定位），换取：
+ *      - 节流：同一个 tag 在 windowMs 毫秒内最多真正输出 maxPerWindow 条，
+ *        超出的直接丢弃，窗口结束时输出一条"跳过了 N 条"的汇总，避免刷屏和阻塞主线程。
+ *      - 参数惰性求值：可以传函数作为参数，只有真正要输出时才会执行，
+ *        被节流丢弃的调用不会白白付出字符串拼接 / JSON.stringify 等开销。
+ *    适合：循环体内、高频 WebSocket 消息、频繁触发的事件回调等。
+ *
+ * 使用：
+ *   import { logger } from './logger';
+ *
+ *   // 普通日志，精确行号
+ *   logger.info('用户登录', { userId: 123 });
+ *
+ *   // 热路径日志，自动节流 + 惰性求值
+ *   const logFrame = logger.hot('render-loop', 'debug', { windowMs: 1000, maxPerWindow: 3 });
+ *   for (const item of hugeList) {
+ *     logFrame(() => `处理 ${item.id}: ${JSON.stringify(item)}`); // 只有真正要输出时才会 JSON.stringify
+ *   }
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerOptions {
+    /** 最低输出级别，默认 debug（即全部输出） */
+    level?: LogLevel;
+    /** 日志前缀，用于区分模块，如 'auth' / 'api' */
+    prefix?: string;
+}
+export interface HotOptions {
+    /** 节流时间窗口，毫秒，默认 1000 */
+    windowMs?: number;
+    /** 每个窗口内最多真正输出多少条，默认 5 */
+    maxPerWindow?: number;
+}
+/** hot() 的参数支持直接值，或者一个惰性求值函数（只有真正要输出时才会调用） */
+type HotArg = unknown | (() => unknown);
+type HotLogFn = (...args: HotArg[]) => void;
+type LogFn = (...args: unknown[]) => void;
+declare class Logger {
+    /** 精确行号版：构造时就确定好是真正绑定到 console 还是空函数 */
+    readonly debug: LogFn;
+    readonly info: LogFn;
+    readonly warn: LogFn;
+    readonly error: LogFn;
+    private level;
+    private prefix;
+    private hotState;
+    constructor(options?: LoggerOptions);
+    private tagArgs;
+    private build;
+    /**
+     * 高频热路径日志：节流 + 惰性求值，牺牲精确行号。
+     * 每次调用 hot() 会返回一个绑定了 tag 的函数，建议在循环 / 高频回调外部
+     * 创建一次，复用同一个函数，而不是每次迭代都调用 logger.hot(...)。
+     */
+    hot(tag: string, level?: LogLevel, options?: HotOptions): HotLogFn;
+    /** 创建带子前缀的子 logger，便于按模块区分 */
+    child(prefix: string): Logger;
+}
+export { Logger };
+export declare const logger: Logger;

package/dist/utils/logger.js

@@ -0,0 +1,37 @@
+//#region src/utils/logger.ts
+var e = {
+	debug: "color:#888",
+	info: "color:#2b8a3e",
+	warn: "color:#e8590c",
+	error: "color:#c92a2a;font-weight:bold"
+}, t = () => {}, n = () => {}, r = class r {
+	debug;
+	info;
+	warn;
+	error;
+	level;
+	prefix;
+	hotState = /* @__PURE__ */ new Map();
+	constructor(e = {}) {
+		this.level = e.level ?? "debug", this.prefix = e.prefix ?? "", this.debug = this.build("debug", console.debug), this.info = this.build("info", console.info), this.warn = console.warn.bind(console, ...this.tagArgs("warn")), this.error = console.error.bind(console, ...this.tagArgs("error"));
+	}
+	tagArgs(t) {
+		return [`%c${(/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour12: !1 })} ${this.prefix ? `[${this.prefix}]` : ""} ${t.toUpperCase()}`, e[t]];
+	}
+	build(e, n) {
+		return t;
+	}
+	hot(e, t = "debug", r = {}) {
+		return n;
+	}
+	child(e) {
+		return new r({
+			level: this.level,
+			prefix: this.prefix ? `${this.prefix}:${e}` : e
+		});
+	}
+}, i = new r();
+//#endregion
+export { r as Logger, i as logger };
+
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["/**\n * 极简日志库\n *\n * 两套 API，按场景选用：\n *\n * 1. logger.debug/info/warn/error —— 精确行号版\n *    直接 bind 原生 console 方法，浏览器控制台会指向真实的业务代码调用行，\n *    可点击跳转。生产环境（import.meta.env.DEV === false）自动变成空函数，\n *    构建时会被死代码消除，几乎不占体积、不产生开销。\n *    适合：普通业务日志，调用频率不高。\n *\n * 2. logger.hot(tag) —— 高频热路径版\n *    用于循环内部、高频事件回调等会产生大量日志的场景。\n *    牺牲了精确行号（控制台里显示的是 hot() 内部位置，但会带上 tag 前缀\n *    方便定位），换取：\n *      - 节流：同一个 tag 在 windowMs 毫秒内最多真正输出 maxPerWindow 条，\n *        超出的直接丢弃，窗口结束时输出一条\"跳过了 N 条\"的汇总，避免刷屏和阻塞主线程。\n *      - 参数惰性求值：可以传函数作为参数，只有真正要输出时才会执行，\n *        被节流丢弃的调用不会白白付出字符串拼接 / JSON.stringify 等开销。\n *    适合：循环体内、高频 WebSocket 消息、频繁触发的事件回调等。\n *\n * 使用：\n *   import { logger } from './logger';\n *\n *   // 普通日志，精确行号\n *   logger.info('用户登录', { userId: 123 });\n *\n *   // 热路径日志，自动节流 + 惰性求值\n *   const logFrame = logger.hot('render-loop', 'debug', { windowMs: 1000, maxPerWindow: 3 });\n *   for (const item of hugeList) {\n *     logFrame(() => `处理 ${item.id}: ${JSON.stringify(item)}`); // 只有真正要输出时才会 JSON.stringify\n *   }\n */\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface LoggerOptions {\n  /** 最低输出级别，默认 debug（即全部输出） */\n  level?: LogLevel;\n  /** 日志前缀，用于区分模块，如 'auth' / 'api' */\n  prefix?: string;\n}\n\nexport interface HotOptions {\n  /** 节流时间窗口，毫秒，默认 1000 */\n  windowMs?: number;\n  /** 每个窗口内最多真正输出多少条，默认 5 */\n  maxPerWindow?: number;\n}\n\n/** hot() 的参数支持直接值，或者一个惰性求值函数（只有真正要输出时才会调用） */\ntype HotArg = unknown | (() => unknown);\ntype HotLogFn = (...args: HotArg[]) => void;\ntype LogFn = (...args: unknown[]) => void;\n\nconst LEVEL_WEIGHT: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst LEVEL_STYLE: Record<LogLevel, string> = {\n  debug: \"color:#888\",\n  info: \"color:#2b8a3e\",\n  warn: \"color:#e8590c\",\n  error: \"color:#c92a2a;font-weight:bold\",\n};\n\n// Vite 会在构建期把这一行替换为字面量布尔值\nconst isDev = import.meta.env.DEV;\n\nconst noop: LogFn = () => {};\nconst noopHot: HotLogFn = () => {};\n\ninterface HotState {\n  count: number;\n  windowStart: number;\n  suppressed: number;\n}\n\nclass Logger {\n  /** 精确行号版：构造时就确定好是真正绑定到 console 还是空函数 */\n  readonly debug: LogFn;\n  readonly info: LogFn;\n  readonly warn: LogFn;\n  readonly error: LogFn;\n\n  private level: LogLevel;\n  private prefix: string;\n  private hotState = new Map<string, HotState>();\n\n  constructor(options: LoggerOptions = {}) {\n    this.level = options.level ?? \"debug\";\n    this.prefix = options.prefix ?? \"\";\n\n    this.debug = this.build(\"debug\", console.debug);\n    this.info = this.build(\"info\", console.info);\n    this.warn = isDev\n      ? this.build(\"warn\", console.warn)\n      : (console.warn.bind(console, ...this.tagArgs(\"warn\")) as LogFn);\n    // error 默认生产环境也保留输出（便于线上排查 / 接入上报）\n    // 如需生产环境也完全静默，把下面这行换成 this.build('error', console.error)\n    this.error = isDev\n      ? this.build(\"error\", console.error)\n      : (console.error.bind(console, ...this.tagArgs(\"error\")) as LogFn);\n  }\n\n  private tagArgs(level: LogLevel): unknown[] {\n    const time = new Date().toLocaleTimeString(\"zh-CN\", { hour12: false });\n    const tag = this.prefix ? `[${this.prefix}]` : \"\";\n    return [`%c${time} ${tag} ${level.toUpperCase()}`, LEVEL_STYLE[level]];\n  }\n\n  private build(level: LogLevel, method: (...args: unknown[]) => void): LogFn {\n    if (!isDev) return noop;\n    if (LEVEL_WEIGHT[level] < LEVEL_WEIGHT[this.level]) return noop;\n    return method.bind(console, ...this.tagArgs(level)) as LogFn;\n  }\n\n  /**\n   * 高频热路径日志：节流 + 惰性求值，牺牲精确行号。\n   * 每次调用 hot() 会返回一个绑定了 tag 的函数，建议在循环 / 高频回调外部\n   * 创建一次，复用同一个函数，而不是每次迭代都调用 logger.hot(...)。\n   */\n  hot(\n    tag: string,\n    level: LogLevel = \"debug\",\n    options: HotOptions = {},\n  ): HotLogFn {\n    if (!isDev) return noopHot;\n    if (LEVEL_WEIGHT[level] < LEVEL_WEIGHT[this.level]) return noopHot;\n\n    const windowMs = options.windowMs ?? 1000;\n    const maxPerWindow = options.maxPerWindow ?? 5;\n    const fullTag = this.prefix ? `${this.prefix}:${tag}` : tag;\n    const consoleMethod = level === \"debug\" ? console.log : console[level];\n\n    return (...args: HotArg[]) => {\n      const now = performance.now();\n      let state = this.hotState.get(fullTag);\n\n      if (!state || now - state.windowStart > windowMs) {\n        if (state && state.suppressed > 0) {\n          console.log(\n            `%c[${fullTag}] 节流：过去 ${windowMs}ms 内还有 ${state.suppressed} 条日志被跳过`,\n            \"color:#999;font-style:italic\",\n          );\n        }\n        state = { count: 0, windowStart: now, suppressed: 0 };\n        this.hotState.set(fullTag, state);\n      }\n\n      state.count++;\n      if (state.count > maxPerWindow) {\n        // 超额直接丢弃，不对参数求值，避免白白付出计算开销\n        state.suppressed++;\n        return;\n      }\n\n      // 惰性求值：只有真正要输出的这几条，才会执行传入的函数参数\n      const resolved = args.map((a) =>\n        typeof a === \"function\" ? (a as () => unknown)() : a,\n      );\n      consoleMethod.call(\n        console,\n        `%c[${fullTag}]`,\n        LEVEL_STYLE[level],\n        ...resolved,\n      );\n    };\n  }\n\n  /** 创建带子前缀的子 logger，便于按模块区分 */\n  child(prefix: string): Logger {\n    return new Logger({\n      level: this.level,\n      prefix: this.prefix ? `${this.prefix}:${prefix}` : prefix,\n    });\n  }\n}\n\nexport { Logger };\nexport const logger = new Logger();\n"],"mappings":";AA8DA,IAAM,IAAwC;CAC5C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;AACT,GAKM,UAAoB,CAAC,GACrB,UAA0B,CAAC,GAQ3B,IAAN,MAAM,EAAO;CAEX;CACA;CACA;CACA;CAEA;CACA;CACA,2BAAmB,IAAI,IAAsB;CAE7C,YAAY,IAAyB,CAAC,GAAG;EAWvC,AAVA,KAAK,QAAQ,EAAQ,SAAS,SAC9B,KAAK,SAAS,EAAQ,UAAU,IAEhC,KAAK,QAAQ,KAAK,MAAM,SAAS,QAAQ,KAAK,GAC9C,KAAK,OAAO,KAAK,MAAM,QAAQ,QAAQ,IAAI,GAC3C,KAAK,OAEA,QAAQ,KAAK,KAAK,SAAS,GAAG,KAAK,QAAQ,MAAM,CAAC,GAGvD,KAAK,QAEA,QAAQ,MAAM,KAAK,SAAS,GAAG,KAAK,QAAQ,OAAO,CAAC;CAC3D;CAEA,QAAgB,GAA4B;EAG1C,OAAO,CAAC,sBAFK,IAAI,KAAK,EAAA,CAAE,mBAAmB,SAAS,EAAE,QAAQ,GAAM,CAEvD,EAAK,GADN,KAAK,SAAS,IAAI,KAAK,OAAO,KAAK,GACtB,GAAG,EAAM,YAAY,KAAK,EAAY,EAAM;CACvE;CAEA,MAAc,GAAiB,GAA6C;EAC9D,OAAO;CAGrB;CAOA,IACE,GACA,IAAkB,SAClB,IAAsB,CAAC,GACb;EACE,OAAO;CAyCrB;CAGA,MAAM,GAAwB;EAC5B,OAAO,IAAI,EAAO;GAChB,OAAO,KAAK;GACZ,QAAQ,KAAK,SAAS,GAAG,KAAK,OAAO,GAAG,MAAW;EACrD,CAAC;CACH;AACF,GAGa,IAAS,IAAI,EAAO"}

package/dist/utils/warn-once.js.map

@@ -1 +1 @@
-{"version":3,"file":"warn-once.js","names":[],"sources":["../../src/utils/warn-once.ts"],"sourcesContent":["let warnOnce = (_: string) => {};\nif (!import.meta.env.PROD) {\n  const warnings = new Set<string>();\n  warnOnce = (msg: string) => {\n    if (!warnings.has(msg)) {\n      console.warn(msg);\n    }\n    warnings.add(msg);\n  };\n}\n\nexport { warnOnce };\n"],"mappings":";AAAA,IAAI,KAAY,MAAc"}
+{"version":3,"file":"warn-once.js","names":[],"sources":["../../src/utils/warn-once.ts"],"sourcesContent":["let warnOnce = (_: string) => {};\nif (!import.meta.env.PROD) {\n  const warnings = new Set<string>();\n  warnOnce = (msg: string) => {\n    if (!warnings.has(msg)) {\n      console.warn(msg);\n    }\n    warnings.add(msg);\n  };\n}\n\nexport { warnOnce };\n"],"mappings":";AAAA,IAAI,KAAY,MAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neut/ui",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "",
   "type": "module",
   "private": false,
@@ -12,24 +12,25 @@
     "dev": "vite ./dev",
     "build": "vite build",
     "serve": "vite preview",
-    "check": "tsgo --noEmit && biome check src"
+    "check": "tsc --noEmit && biome check --write src"
   },
   "license": "MIT",
   "devDependencies": {
-    "@tailwindcss/vite": "^4.2.3",
-    "@types/node": "^25.6.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260429.1",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/node": "^26.1.2",
+    "@typescript/typescript6": "^6.0.2",
     "solid-devtools": "^0.34.5",
-    "tailwindcss": "^4.2.3",
-    "vite": "^8.0.9",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-solid": "^2.11.12"
+    "tailwindcss": "^4.3.3",
+    "typescript": "^7.0.2",
+    "unplugin-dts": "^1.0.3",
+    "vite": "^8.2.0",
+    "vite-plugin-solid": "^2.11.14"
   },
   "peerDependencies": {
     "class-variance-authority": "^0.7.1",
-    "lucide-solid": "^1.8.0",
-    "solid-js": "^1.9.12",
-    "tailwind-merge": "^3.5.0"
+    "lucide-solid": "^1.28.0",
+    "solid-js": "^1.9.14",
+    "tailwind-merge": "^3.6.0"
   },
   "files": [
     "dist"