@kubb/core 5.0.0-beta.5 → 5.0.0-beta.7

package/package.json

@@ -1,20 +1,13 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-beta.5",
-  "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
+  "version": "5.0.0-beta.7",
+  "description": "Core engine for Kubb's plugin-based code generation system. Provides the plugin driver, file manager, defineConfig, and build orchestration used by every Kubb plugin.",
   "keywords": [
-    "ast",
     "code-generator",
     "codegen",
-    "core-library",
-    "file-system",
     "kubb",
-    "oas",
     "openapi",
-    "plugin-framework",
     "plugin-system",
-    "plugins",
-    "swagger",
     "typescript"
   ],
   "license": "MIT",
@@ -65,15 +58,15 @@
   "dependencies": {
     "fflate": "^0.8.2",
     "tinyexec": "^1.1.2",
-    "@kubb/ast": "5.0.0-beta.5"
+    "@kubb/ast": "5.0.0-beta.7"
   },
   "devDependencies": {
     "p-limit": "^7.3.0",
     "@internals/utils": "0.0.0",
-    "@kubb/renderer-jsx": "5.0.0-beta.5"
+    "@kubb/renderer-jsx": "5.0.0-beta.7"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.5"
+    "@kubb/renderer-jsx": "5.0.0-beta.7"
   },
   "size-limit": [
     {

package/src/defineLogger.ts

@@ -3,7 +3,11 @@ import type { Logger, LoggerOptions, UserLogger } from './types.ts'
 /**
  * Wraps a logger definition into a typed {@link Logger}.
  *
- * @example
+ * The optional second type parameter `TInstallReturn` allows loggers to return
+ * a value from `install` — for example, a sink factory that the caller can
+ * forward to hook execution.
+ *
+ * @example Basic logger
  * ```ts
  * export const myLogger = defineLogger({
  *   name: 'my-logger',
@@ -13,7 +17,20 @@ import type { Logger, LoggerOptions, UserLogger } from './types.ts'
  *   },
  * })
  * ```
+ *
+ * @example Logger that returns a hook sink factory
+ * ```ts
+ * export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({
+ *   name: 'my-logger',
+ *   install(context, options) {
+ *     // … register event handlers …
+ *     return (commandWithArgs) => ({ onStdout: console.log })
+ *   },
+ * })
+ * ```
  */
-export function defineLogger<Options extends LoggerOptions = LoggerOptions>(logger: UserLogger<Options>): Logger<Options> {
+export function defineLogger<Options extends LoggerOptions = LoggerOptions, TInstallReturn = void>(
+  logger: UserLogger<Options, TInstallReturn>,
+): Logger<Options, TInstallReturn> {
   return logger
 }

package/src/types.ts

@@ -130,6 +130,10 @@ export type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptio
    * return `{ name, path }` for the import, or `undefined` to skip it.
    */
   getImports: (node: SchemaNode, resolve: (schemaName: string) => { name: string; path: string }) => Array<ImportNode>
+  /**
+   * Validate the document at the given path or URL.
+   */
+  validate: (input: string, options?: { throwOnError?: boolean }) => Promise<void>
 }
 
 export type DevtoolsOptions = {
@@ -796,12 +800,12 @@ export type LoggerOptions = {
  */
 export type LoggerContext = AsyncEventEmitter<KubbHooks>
 
-export type Logger<TOptions extends LoggerOptions = LoggerOptions> = {
+export type Logger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = {
   name: string
-  install: (context: LoggerContext, options?: TOptions) => void | Promise<void>
+  install: (context: LoggerContext, options?: TOptions) => TInstallReturn | Promise<TInstallReturn>
 }
 
-export type UserLogger<TOptions extends LoggerOptions = LoggerOptions> = Logger<TOptions>
+export type UserLogger<TOptions extends LoggerOptions = LoggerOptions, TInstallReturn = void> = Logger<TOptions, TInstallReturn>
 
 export type { Storage } from './createStorage.ts'
 export type { Generator } from './defineGenerator.ts'