@collidor/toolkit

中文文档
1.2.2发布于 2026/10/19MITTypeScriptESM + CJS构建来源已验证近 30 天下载 8117

An umbrella package for collidor libraries.

原始使用文档
文档目录3 节
  1. Installation
  2. Modular Subpath Imports
  3. Available Subpath Modules

Codecov npm version License: MIT

@collidor/toolkit

The modular umbrella toolkit providing unified access to Collidor architecture libraries: Command, Event, Injector, Result, Observable, and Schema systems.

Installation

npm install @collidor/toolkit

Modular Subpath Imports

Breaking Change: The monolithic root entrypoint (@collidor/toolkit) has been replaced with dedicated, tree-shakeable single entrypoints per module. Import directly from each module subpath:

// 1. Command Bus & Commands
import { Command, CommandBus, createCommand } from "@collidor/toolkit/command";

// 2. Event Bus & Cross-Context Channels
import { Event, EventBus, createEvent, PortChannel } from "@collidor/toolkit/event";

// 3. Dependency Injection
import { Injector } from "@collidor/toolkit/injector";

// 4. Observable Streams (RxJS)
import { ObservableCommandBus } from "@collidor/toolkit/observable-command";
import { ObservableEventBus } from "@collidor/toolkit/observable-event";

// 5. Result Monad
import { Result } from "@collidor/toolkit/result";

// 6. Schema Commands (Zod)
import { SchemaCommand, createSchemaCommand } from "@collidor/toolkit/schema-command";

// 7. Struct Definitions & Bridges
import { s, struct, fromZod, toZod } from "@collidor/toolkit/struct";

Available Subpath Modules

Module SubpathExports
@collidor/toolkit/commandCommand, CommandBus, AsyncCommandBus, createCommand, plugins
@collidor/toolkit/eventEvent, EventBus, createEvent, PortChannel, PortEvents
@collidor/toolkit/injectorInjector, dependency injection tokens & decorators
@collidor/toolkit/observable-commandObservableCommandBus (RxJS-powered Command Bus)
@collidor/toolkit/observable-eventObservableEventBus (RxJS-powered Event Bus)
@collidor/toolkit/resultResult monad (Ok, Err, unwrapping)
@collidor/toolkit/schema-commandSchemaCommand, schemaCommand, createSchemaCommand
@collidor/toolkit/structs, struct, schema types, AST engine, DDL generator, bridges (toZod, toJSONSchema)

版本与发布记录

@collidor/toolkit 共发布 33 个版本,首次发布于 2025/09/12;过去 12 个月发布了 22 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.2latest2026/10/1922 天前
1.2.12026/10/101 个月前
1.2.02026/10/101 个月前
1.1.32026/10/091 个月前
1.1.22026/10/081 个月前
1.1.12026/10/081 个月前

关于 @collidor/toolkit 的常见问题

@collidor/toolkit 是什么?

An umbrella package for collidor libraries.

如何安装 @collidor/toolkit?

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

@collidor/toolkit 支持 TypeScript 吗?

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

@collidor/toolkit 支持 ESM 还是 CommonJS?

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

@collidor/toolkit 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@collidor/toolkit 可以商用吗?

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

@collidor/toolkit 的下载量有多少?

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

@collidor/toolkit 还在维护吗?

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