imccyu 6af96785b5 release(vendor): cordis 4.0.2, cosmokit 1.8.3, group 1.0.2, hmr 1.0.17, include 1.0.7, loader 1.0.3, logger-console 1.0.2, schemastery 3.18.2, timer 1.1.4 1 неделя назад
..
src 675efe73f2 fix: node 24.9 internal issue 1 неделя назад
LICENSE 72688a3888 Vendor Cordis framework packages as source 3 месяцев назад
README.md 72688a3888 Vendor Cordis framework packages as source 3 месяцев назад
package.json 6af96785b5 release(vendor): cordis 4.0.2, cosmokit 1.8.3, group 1.0.2, hmr 1.0.17, include 1.0.7, loader 1.0.3, logger-console 1.0.2, schemastery 3.18.2, timer 1.1.4 1 неделя назад
tsconfig.json 7f131dd4d8 refactor: rename build typings dir to types 2 месяцев назад
tsdown.config.ts 993550e6c8 refactor: remove repository plugin path 4 недель назад

README.md

@cordisjs/plugin-loader

Runtime plugin loader for Cordis. The loader owns an EntryTree, imports plugin modules by name, applies their config, and keeps the running plugin graph in sync with entry updates.

Usage

import { Context } from 'cordis'
import Loader from '@cordisjs/plugin-loader'

const root = new Context()
await root.plugin(Loader, { baseUrl: import.meta.url })

const id = await root.loader.create({
  name: './plugins/example',
  config: { enabled: true },
})

await root.loader.await()
root.loader.update(id, { config: { enabled: false } })

Entry Options

Field Description
id Stable id for resolving, updating, and removing the entry.
name Module specifier imported by the loader.
config Config passed to the plugin.
group Marks the entry as a group whose config is a child entry list.
disabled Stops the entry and prevents it from starting.
inject Adds required services or intercept config for this entry.

API

API Description
loader.create(options, parent?, position?) Add and start an entry.
loader.update(id, options, parent?, position?) Update, move, and restart an entry.
loader.remove(id) Stop and delete an entry.
loader.resolve(id) Resolve an entry by id, including nested a:b ids.
loader.resolveGroup(id) Resolve the root group or a nested group.
loader.await() Wait for pending entry imports and fiber reloads.
loader.locate(fiber?) Return the loader entry id that owns a fiber.

For file-backed trees, use @cordisjs/plugin-include.