Plugins, modules, and hooks
Extensibility options in addonova.config.*.
#plugins
#Type: AddonovaPlugin[] - default [].
Plugins run in registration order and can observe builds and transform bundled code.
export default defineConfig({
plugins: [
{
name: 'example',
buildStart() {},
transform(code, id) {
return code;
},
buildEnd() {},
},
],
});
The plugin API is intentionally small. It is not Rollup-compatible.
modules
#Type: AddonovaModuleInput[] - default [].
Accepts module objects, package names, or [package, options] tuples.
export default defineConfig({
modules: [
'addonova-module-example',
{ name: 'inline', setup() {} },
['addonova-module-configured', { feature: true }],
],
});
Configured modules run first, in array order. Local modules/* files run next,
sorted by file name.
hooks
#Type: AddonovaHooks - default {}.
export default defineConfig({
hooks: {
'config:resolved': ({ config }) => {
console.log(config.root);
},
'entrypoints:resolved': ({ addEntrypoint }) => {
addEntrypoint('shared', 'src/shared-entry.ts');
},
'build:manifestGenerated': ({ manifest, diagnostics }) => {
manifest.author = 'Me';
diagnostics.push({
code: 'ADDONOVA_MANIFEST_INVALID_FIELD',
severity: 'warning',
message: 'Checked by a hook',
});
},
},
});
Hook order:
- Configured modules.
- Local modules, alphabetically.
- Project configuration hooks.
A failing hook stops the build with ADDONOVA_HOOK_FAILED.
Module options
#Use configKey to read custom top-level options:
export default {
name: 'my-module',
configKey: 'myModule',
setup(context, options) {},
};
export default defineConfig({
myModule: {
feature: true,
},
modules: ['my-module'],
});
Top-level unknown keys are allowed for this reason. Nested sections such as
webExt and pack reject unknown fields.
See Hooks and modules for the full API.