@chiballc/utils

中文文档
2.6.2发布于 2026/11/06ISCTypeScriptESM + CJS构建来源已验证近 30 天下载 4261

TypeScript utilities, browser worker messaging, and the Kibao Nuxt module for OpenBao-backed runtime configuration.

原始使用文档
文档目录4 节
  1. Installation
  2. Documentation
  3. GitHub Pages
  4. License

Chiba LLC Utils

TypeScript utilities, browser worker messaging, and the Kibao Nuxt module for OpenBao-backed runtime configuration.

Installation

pnpm add @chiballc/utils

Import core helpers from the package root. Worker and Nuxt entry points use explicit subpaths.

import { execute, LRUCache } from "@chiballc/utils";
import { useWebWorker } from "@chiballc/utils/web-workers";
import { useServiceWorker } from "@chiballc/utils/service-workers";
import serviceWorkerPlugin from "@chiballc/utils/plugins";

Kibao is bundled with the root package. Register it in Nuxt from @chiballc/utils/kibao; runtime helpers are available from @chiballc/utils/kibao/runtime.

export default defineNuxtConfig({
  modules: ["@chiballc/utils/kibao"],
});

Image renditions are available from @chiballc/utils/images. Conditional exports select the Cloudflare Images binding, ipx (Node) or Bun.Image (Bun) adapter by build target, with unstorage-backed cache layers; @chiballc/utils/images/nuxt registers it for Nitro presets. See Images.

Full API documentation, examples, lifecycle behavior, and the OpenBao security model are available at chiballc.github.io/utils.

Documentation

The documentation site uses VitePress.

pnpm install
pnpm docs:dev

pnpm docs:build writes the production site to docs/.vitepress/dist. Use pnpm docs:preview to serve that built output locally.

GitHub Pages

.github/workflows/deploy-docs.yml builds and deploys the documentation when documentation files, package.json, or pnpm-lock.yaml change on main. It uses GitHub Pages artifacts, so no generated files or gh-pages branch are committed.

In the repository's GitHub settings, open Pages and select GitHub Actions as the publishing source. The site is configured for the project-site path https://chiballc.github.io/utils/. If it moves to a custom domain or an organization root site, update base in docs/.vitepress/config.mts.

License

ISC

版本与发布记录

@chiballc/utils 共发布 30 个版本,首次发布于 2026/04/12;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.6.2latest2026/11/063 天前
2.6.12026/11/063 天前
2.6.02026/10/2614 天前
2.5.32026/10/2020 天前
2.5.22026/10/2020 天前
2.5.12026/08/192 个月前

关于 @chiballc/utils 的常见问题

@chiballc/utils 是什么?

TypeScript utilities, browser worker messaging, and the Kibao Nuxt module for OpenBao-backed runtime configuration.

如何安装 @chiballc/utils?

在项目目录运行 npm install @chiballc/utils,或使用 pnpm add / yarn add / bun add。

@chiballc/utils 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chiballc/utils 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@chiballc/utils 可以商用吗?

@chiballc/utils 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chiballc/utils 的下载量有多少?

根据 npm 官方下载统计,@chiballc/utils 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,261 次,日均约 142 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chiballc/utils 还在维护吗?

最新版本 2.6.2 发布于 2026/11/06(3 天前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/04/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。