Skip to content

Plugin core

Under construction

This section describes the core plugin types and APIs.

Context/this

When calling this. in a plugin, the api of the core plugin will be used.

plugin.ts
plugin.ts
ts
import path from 'node:path'

import type { FileManager } from './FileManager.ts'
import type { PluginManager } from './PluginManager.ts'
import type { Plugin, PluginContext, PluginFactoryOptions, UserPluginWithLifeCycle } from './types.ts'

type PluginFactory<T extends PluginFactoryOptions = PluginFactoryOptions> = (options: T['options']) => UserPluginWithLifeCycle<T>

type OptionalPluginFactory<T extends PluginFactoryOptions = PluginFactoryOptions> = (options?: T['options']) => UserPluginWithLifeCycle<T>

export function createPlugin<T extends PluginFactoryOptions = PluginFactoryOptions>(factory: PluginFactory<T>): OptionalPluginFactory<T> {
  return (options = {}) => {
    return factory(options)
  }
}

type Options = {
  config: PluginContext['config']
  fileManager: FileManager
  pluginManager: PluginManager
  resolvePath: PluginContext['resolvePath']
  resolveName: PluginContext['resolveName']
  logger: PluginContext['logger']
  getPlugins: () => Array<Plugin>
  plugin?: PluginContext['plugin']
}

// not publicly exported
export type PluginCore = PluginFactoryOptions<'core', Options, Options, PluginContext, never>

export const pluginCore = createPlugin<PluginCore>((options) => {
  const { fileManager, pluginManager, resolvePath, resolveName, logger } = options

  return {
    name: 'core',
    options,
    key: ['core'],
    context() {
      return {
        get config() {
          return options.config
        },
        get plugins() {
          return options.getPlugins()
        },
        get plugin() {
          // see pluginManger.#execute where we override with `.call` the context with the correct plugin
          return options.plugin as NonNullable<Options['plugin']>
        },
        logger,
        fileManager,
        pluginManager,
        async addFile(...files) {
          const resolvedFiles = await fileManager.add(...files)

          if (!Array.isArray(resolvedFiles)) {
            return [resolvedFiles]
          }

          return resolvedFiles
        },
        resolvePath,
        resolveName,
      }
    },
    resolvePath(baseName) {
      const root = path.resolve(options.config.root, options.config.output.path)

      return path.resolve(root, baseName)
    },
    resolveName(name) {
      return name
    },
  }
})

this.config

For the current config, see kubb.config.ts.

  • Type: KubbConfig

this.plugins

Return all the plugins that are being used.

  • Type: Array<KubbPlugin>

this.plugin

The current plugin.

  • Type: KubbPlugin

this.logger

Instance of the Logger.

  • Type: Logger

this.fileManager

Instance of the fileManager.

  • Type: FileManager

this.pluginManager

Instance of the pluginManager.

  • Type: PluginManager

this.addFile

Add a file to the current fileManager.

  • Type: (...files: Array<KubbFile.File>): Promise<Array<KubbFile.File>>

this.resolvePath

This will be called pluginManager.resolvePath, see Pluginmanager and resolving a path.

  • Type: (params: ResolvePathParams) => KubbFile.OptionalPath

this.resolveName

This will be called pluginManager.resolveName, see Pluginmanager and resolving a name.

  • Type: (params: ResolveNameParams) => string

this.cache

Store something in the cache, this cache can be used in every plugin.

  • Type: Cache<PluginCache>

Released under the MIT License.