Reference
The reference section is for readers who already know what they want and need the precise shape of the API. It is organized by intent (plugins, the registry, the bus, settings, the dialog) rather than by file. Each page covers the public types in one area, the canonical signatures, and the common usage shapes.
If you want the model behind the API, the concepts explain how the pieces fit together. If you want the recipe to do something specific, the guides are how-tos. If you want “what is the signature of registerLazySingleton again,” you are in the right place.
Plugins & Lifecycle `PluginId`, `Plugin`, `GlobalPlugin`, `SessionPlugin`, `FeatureFlag`, the context types, `PluginSession`, `PluginRuntime`, `PluginLifecycleException`.
Service Registry & Capabilities `ServiceId`, `Namespace`, `ServiceRegistry`, `ScopedServiceRegistry`, the three registration modes, `PluginService`, `StatefulPluginService`, `Capability`, `CapabilityLookup`.
Event Bus & Events `EventBus`, `EventEnvelope`, the subscription and emission API, request/response, identifier scoping, the bus helpers on plugins and services.
Settings & Configuration `RuntimeSettings`, `PluginConfig`, `ServiceSettings`, JSON round-trip, `ConfigNode`, the typed accessors and coercion rules.
Dialog API `UiConfigurableCapability`, the `ConfigField` hierarchy, `showPluginKitDialog`, `PluginKitDialog`, `PluginKitDialogController`, `PluginKitVisualsPlugin`, theming, custom renderers.
State Management Bridges Wire-up recipes for Bloc, Riverpod, ChangeNotifier, signals_flutter, MobX, GetIt, and plain setState, plus the `flutter_plugin_kit` shortcuts.
Naming Conventions Plugin ids, service ids, namespaces, event types, capabilities, settings keys, and variable names: the style guide the docs and demo follow.
Architecture Contributor-facing design rationale: type hierarchy, lifecycle phases, priority resolution, event dispatch, cross-scope routing, key decisions.