PluginCopy Anchor Link

The Plugin System provides a modular architecture that allows the Wizard framework to be extended with additional functionality through dynamically loaded plugins.

DefinePluginCopy Anchor Link

PluginCopy Anchor Link

Plugin ArchitectureCopy Anchor Link

The plugin system is designed with security and encapsulation in mind. When a plugin's setup method is called, it receives a restricted Wizard instance (PluginSetupWizard) that only exposes the essential methods needed for plugin functionality.

PluginSetupWizard TypeCopy Anchor Link

The PluginSetupWizard type is a restricted version of the full Wizard instance that excludes three critical methods:

• use - Plugin registration method
• on - Event listening method
• parse - Command parsing and execution method

This restriction prevents plugins from:

• Registering additional plugins during setup (which could cause infinite loops)
• Setting up event listeners during setup (which could interfere with core execution)
• Triggering command parsing during setup (which could cause premature execution)

Available Methods in PluginSetupWizardCopy Anchor Link

Plugins can access these methods and properties during setup:

• Command Register: register()
• Configuration: name, description, version, locale, i18n
• Global Settings: globalFlags, commandMap, commandChain flags()
• Utilities: interceptor(), errorHandler()

Advanced UsageCopy Anchor Link

To separate handlers from the plugin definition, you can use the definePlugin utility function:

// @filename: @hyperse/wizard/dist/index.d.ts
import { definePlugin } from '@hyperse/wizard';

const deployPlugin = definePlugin({
  name: 'deploy plugin',
  localeMessages: helpMessages,
  setup: (wizard, pluginCtx) => {
    return wizard.register(deployCmd);
  },
});