pluginsdk/plugin/registration.go
Alex Dunmow b6d40ed8ac feat: bootstrap block/pluginsdk — the proto-first plugin SDK (P1)
Bootstrap the plugin-facing SDK module so the fleet migration (P2) becomes a
mechanical block/core/X -> block/pluginsdk/X import rewrite.

- abi/proto/v1: the single source-of-truth ABI proto tree, copied from the cms
  authoring source (cms/backend/abi/proto/v1) with go_package retargeted to
  git.dev.alexdunmow.com/block/pluginsdk/abi/v1;abiv1. Kills the hand-kept
  cms/core proto duplication (audit gap 4).
- abi/v1: generated Go bindings (buf generate); byte-identical to core's abi/v1
  save the embedded go_package path.
- plugin/ (registration + DI surface), plugin/wasmguest/** (transport shim,
  caps stubs, bnwasm db driver, testdata fixtures + golden .pb), and the
  guest-facing type packages: blocks (+builtin/shared/tags), templates
  (+pongo/bn), auth, settings, content, gating, crypto, rbac, video, ai,
  subscriptions, menus, datasources. Internal imports rewritten core ->
  pluginsdk; zero block/core references remain.
- README/AGENTS(+CLAUDE symlink)/Makefile: proto is the contract, Go is one
  binding; no replace directives; templates/bn is a synced copy authored in cms.

Spec: cms docs/superpowers/specs/2026-07-07-proto-first-plugin-sdk-design.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 10:51:00 +08:00

55 lines
1.7 KiB
Go

package plugin
import (
"context"
"io/fs"
"net/http"
"git.dev.alexdunmow.com/block/pluginsdk/blocks"
"git.dev.alexdunmow.com/block/pluginsdk/templates"
)
// RegisterFunc is the function signature for plugin registration.
// Plugins register their templates and blocks through the provided registries.
type RegisterFunc func(tr templates.TemplateRegistry, br blocks.BlockRegistry) error
// PluginRegistration defines a compiled-in plugin's entry points.
type PluginRegistration struct {
Name string
Register RegisterFunc
RegisterWithProvisioner func(tr templates.TemplateRegistry, br blocks.BlockRegistry, p Provisioner) error
Assets func() http.Handler
Schemas func() fs.FS
SettingsSchema func() []byte
ThemePresets func() []byte
BundledFonts func() []byte
MasterPages func() []MasterPageDefinition
HTTPHandler func(deps CoreServices) http.Handler
SettingsPanel func() string
AdminPages func() []AdminPage
CSSManifest func() *CSSManifest
ServiceHandlers func(deps CoreServices) (*ServiceRegistration, error)
JobHandlers func(deps CoreServices) map[string]JobHandlerFunc
AIActions func() []AIAction
DirectoryExtensions func() *DirectoryExtensions
MediaHooks MediaHooksProvider
Load func(deps CoreServices) error
Unload func(ctx context.Context) error
Dependencies []Dependency
Migrations func() fs.FS
Version string
// RequiredIconPacks are icon-pack slugs the CMS must ensure are installed
// before the theme loads (e.g. "tabler", "phosphor"). Loader auto-installs
// from the bundled registry; out-of-registry slugs are logged and require
// manual install.
RequiredIconPacks []string
}