Kit: the plugin authoring toolkit

kubb/kit contains everything you need to create your own plugin and custom logic. A plugin, a generator, a resolver, a parser, or a custom adapter or renderer all start from this one import. It groups definePlugin, defineGenerator, defineResolver, defineParser, createAdapter, createRenderer, the ast namespace and factory node builders you use to construct output, and the option and hook types that go with all of it. See Architecture for where kit sits in the pipeline, Plugins for what a plugin does once it is built, and AST for the tree kit's ast namespace wraps.

Why a separate surface from the engine

The Kubb engine also runs the build: the plugin driver, the file manager, the CLI reporters. None of that is part of authoring a plugin. A plugin author calls definePlugin and returns an object. The engine discovers that object, walks the AST against it, and writes the result to disk. Mixing the two into one import would mean every plugin author pulls in driver internals they never call.

Kit keeps the two apart the same way the AST layer and the JSX renderer stay separate from the engine that drives them. You call kubb/kit to build things. The engine, reached through the kubb package and its CLI, runs them.

Why ast and factory live in kit

Node building is the most common thing a generator author does. Nearly every operation or schema handler ends with a call to ast.factory.createFile or one of its neighbors, so the node builders sit right next to definePlugin and defineGenerator instead of living behind a separate AST import.

The ast namespace holds everything else too: the guards, the macros, the schema and string helpers, the dialect, the printer, and the visitors. Pull ast from kubb/kit whether you are inside a plugin or writing a standalone script that narrows a node on its own. The namespace is backed by @kubb/ast, an internal library, the same way the authoring helpers are backed by the internal @kubb/core. You never depend on either package directly.

Reference

The full list of exports, definePlugin, defineGenerator, defineResolver, defineParser, createAdapter, createRenderer, createStorage, Diagnostics, memoryStorage, fsStorage, the ast namespace, and the kubb/kit/testing helpers, lives in the Kit API reference.

See also Plugins for the plugin lifecycle, AST for the tree kit's ast namespace wraps, and Creating your first plugin for a step-by-step build.