@kubb/kit 5.0.0-beta.80

package/README.md

@@ -0,0 +1,108 @@
+<div align="center">
+  <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
+    <img src="https://kubb.dev/og.png" alt="Kubb banner">
+  </a>
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Stars][stars-src]][stars-href]
+[![License][license-src]][license-href]
+[![Node][node-src]][node-href]
+
+<h4>
+<a href="https://kubb.dev" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
+</div>
+
+<br />
+
+# @kubb/kit
+
+### Authoring toolkit for Kubb plugins
+
+`@kubb/kit` gathers the helpers you call when you author a plugin, generator, adapter, resolver, or renderer: `definePlugin`, `defineGenerator`, `defineResolver`, `defineParser`, `createAdapter`, `createRenderer`, the `ast` namespace and `factory` node builders, and the option and hook types that go with them. It sits next to the `kubb` package, which is where end users configure and run builds. `kubb/kit` re-exports this package, so most consumers reach it through `kubb/kit` rather than installing `@kubb/kit` directly.
+
+## Installation
+
+Install `kubb` and import from the `kubb/kit` subpath, rather than depending on `@kubb/kit` directly.
+
+```bash
+bun add kubb
+# or
+pnpm add kubb
+# or
+npm install kubb
+```
+
+## Usage
+
+```typescript
+import { ast, definePlugin, defineGenerator } from 'kubb/kit'
+
+export const pluginExample = definePlugin(() => {
+  return {
+    name: 'example',
+    generators: [
+      defineGenerator({
+        schema({ schema }) {
+          return ast.factory.createSchema(schema)
+        },
+      }),
+    ],
+  }
+})
+```
+
+## What is in the box
+
+`definePlugin`, `defineGenerator`, `defineResolver`, and `defineParser` wrap a plugin, a generator, a resolver, or a parser into the shape the build engine expects. `createAdapter`, `createRenderer`, and `createStorage` are the matching factories for a custom spec adapter, output renderer, or storage backend.
+
+`ast` and `factory` are the node builders a generator calls to construct the file, schema, and operation nodes it returns. `Diagnostics` is the structured error a plugin throws to report a problem with a location and a fix suggestion, and `memoryStorage` and `fsStorage` are the built-in storage backends, useful in tests and custom configs.
+
+Rounding out the package are the option and hook types every plugin, generator, adapter, resolver, and renderer author references, among them `PluginFactoryOptions`, `GeneratorContext`, `ResolverContext`, `AdapterFactoryOptions`, `RendererFactory`, and `KubbHooks`.
+
+## Testing helpers
+
+`kubb/kit/testing` holds the Vitest-backed test helpers (`createMockedPlugin`, `createMockedAdapter`, `renderGeneratorOperation`, `matchFiles`) used to unit test a plugin or generator without running a full build. It is a separate entry point so the main `kubb/kit` import never pulls in Vitest.
+
+```typescript
+import { createMockedPlugin, renderGeneratorSchema } from 'kubb/kit/testing'
+```
+
+## Why a separate package from `@kubb/core`
+
+`@kubb/core` also runs the build engine: the plugin driver, the file manager, and the CLI reporters. None of that is part of authoring a plugin. `@kubb/kit` keeps the two apart, the same way the surrounding `kubb/ast` and `kubb/jsx` subpaths separate the AST layer and the JSX renderer from the engine that drives them.
+
+## Supporting Kubb
+
+Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:
+
+- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+- [See sponsorship tiers and our sponsors](https://kubb.dev/sponsors)
+
+<p align="center">
+  <a href="https://github.com/sponsors/stijnvanhulle">
+    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+  </a>
+</p>
+
+## License
+
+[MIT](https://github.com/kubb-labs/kubb/blob/main/licenses/LICENSE-MIT)
+
+<!-- Badges -->
+
+[npm-version-src]: https://shieldcn.dev/npm/v/@kubb/kit.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-version-href]: https://npmx.dev/package/@kubb/kit
+[npm-downloads-src]: https://shieldcn.dev/npm/dm/@kubb/kit.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-downloads-href]: https://npmx.dev/package/@kubb/kit
+[stars-src]: https://shieldcn.dev/github/stars/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[stars-href]: https://github.com/kubb-labs/kubb
+[license-src]: https://shieldcn.dev/npm/license/@kubb/kit.svg?variant=secondary&size=xs&theme=zinc
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[node-src]: https://shieldcn.dev/npm/node/@kubb/kit.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[node-href]: https://npmx.dev/package/@kubb/kit

package/dist/index.cjs

@@ -0,0 +1,75 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _kubb_ast = require("@kubb/ast");
+let _kubb_core = require("@kubb/core");
+Object.defineProperty(exports, "Diagnostics", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.Diagnostics;
+	}
+});
+Object.defineProperty(exports, "ast", {
+	enumerable: true,
+	get: function() {
+		return _kubb_ast.ast;
+	}
+});
+Object.defineProperty(exports, "createAdapter", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.createAdapter;
+	}
+});
+Object.defineProperty(exports, "createRenderer", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.createRenderer;
+	}
+});
+Object.defineProperty(exports, "createStorage", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.createStorage;
+	}
+});
+Object.defineProperty(exports, "defineGenerator", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.defineGenerator;
+	}
+});
+Object.defineProperty(exports, "defineParser", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.defineParser;
+	}
+});
+Object.defineProperty(exports, "definePlugin", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.definePlugin;
+	}
+});
+Object.defineProperty(exports, "defineResolver", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.defineResolver;
+	}
+});
+Object.defineProperty(exports, "factory", {
+	enumerable: true,
+	get: function() {
+		return _kubb_ast.factory;
+	}
+});
+Object.defineProperty(exports, "fsStorage", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.fsStorage;
+	}
+});
+Object.defineProperty(exports, "memoryStorage", {
+	enumerable: true,
+	get: function() {
+		return _kubb_core.memoryStorage;
+	}
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { ast, factory } from "@kubb/ast";
+import { Adapter, AdapterFactoryOptions, AdapterSource, BannerMeta, Config, Diagnostics, Exclude, Generator, GeneratorContext, Group, Include, KubbHooks, KubbPluginEndContext, KubbPluginSetupContext, KubbPluginStartContext, Output, OutputMode, OutputOptions, Override, Parser, Plugin, PluginFactoryOptions, Renderer, RendererFactory, ResolveBannerContext, ResolveBannerFile, ResolveOptionsContext, Resolver, ResolverContext, ResolverFileParams, ResolverPathParams, Storage, UserConfig, createAdapter, createRenderer, createStorage, defineGenerator, defineParser, definePlugin, defineResolver, fsStorage, memoryStorage } from "@kubb/core";
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, type Config, Diagnostics, type Exclude, type Generator, type GeneratorContext, type Group, type Include, type KubbHooks, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type Plugin, type PluginFactoryOptions, type Renderer, type RendererFactory, type ResolveBannerContext, type ResolveBannerFile, type ResolveOptionsContext, type Resolver, type ResolverContext, type ResolverFileParams, type ResolverPathParams, type Storage, type UserConfig, ast, createAdapter, createRenderer, createStorage, defineGenerator, defineParser, definePlugin, defineResolver, factory, fsStorage, memoryStorage };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { ast, factory } from "@kubb/ast";
+import { Diagnostics, createAdapter, createRenderer, createStorage, defineGenerator, defineParser, definePlugin, defineResolver, fsStorage, memoryStorage } from "@kubb/core";
+export { Diagnostics, ast, createAdapter, createRenderer, createStorage, defineGenerator, defineParser, definePlugin, defineResolver, factory, fsStorage, memoryStorage };

package/dist/testing.cjs

@@ -0,0 +1,9 @@
+var _kubb_core_mocks = require("@kubb/core/mocks");
+Object.keys(_kubb_core_mocks).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _kubb_core_mocks[k];
+		}
+	});
+});

package/dist/testing.d.ts

@@ -0,0 +1 @@
+export * from "@kubb/core/mocks";

package/dist/testing.js

@@ -0,0 +1,2 @@
+export * from "@kubb/core/mocks";
+export {};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@kubb/kit",
+  "version": "5.0.0-beta.80",
+  "description": "Authoring toolkit for Kubb plugins, generators, adapters, resolvers, and renderers.",
+  "keywords": [
+    "codegen",
+    "kit",
+    "kubb",
+    "meta-framework",
+    "plugin",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "stijnvanhulle",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kubb-labs/kubb.git",
+    "directory": "packages/kit"
+  },
+  "files": [
+    "dist",
+    "*.d.ts",
+    "*.d.cts",
+    "!/**/**.test.**",
+    "!/**/__tests__/**",
+    "!/**/__snapshots__/**"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./testing": {
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "node -e \"require('node:fs').rmSync('./dist', {recursive:true,force:true})\"",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "release": "pnpm publish --no-git-check",
+    "release:stage": "pnpm stage publish --no-git-check",
+    "start": "tsdown --watch",
+    "test": "vitest --passWithNoTests",
+    "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"
+  },
+  "dependencies": {
+    "@kubb/ast": "workspace:*",
+    "@kubb/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@internals/utils": "workspace:*"
+  },
+  "peerDependencies": {
+    "@kubb/core": "workspace:*"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}