pluginsdk/blocks/template.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

75 lines
2.5 KiB
Go

package blocks
import (
"fmt"
"html"
)
// MediaValue represents a rich media object for template substitution.
// Implements fmt.Stringer to render a full <img> tag when used directly.
type MediaValue struct {
Src string // Full URL path (e.g., "/media/uuid/webp.webp")
Alt string // Alt text from media library
Filename string // Original filename
Width int // Image width in pixels
Height int // Image height in pixels
}
// String renders the default <img> tag representation.
func (m MediaValue) String() string {
attrs := fmt.Sprintf(`src="%s" alt="%s" class="w-full h-auto"`,
html.EscapeString(m.Src),
html.EscapeString(m.Alt))
if m.Width > 0 && m.Height > 0 {
attrs += fmt.Sprintf(` width="%d" height="%d"`, m.Width, m.Height)
}
return fmt.Sprintf(`<img %s>`, attrs)
}
// RenderWithClass renders the <img> tag with custom CSS classes.
func (m MediaValue) RenderWithClass(class string) string {
attrs := fmt.Sprintf(`src="%s" alt="%s" class="%s"`,
html.EscapeString(m.Src),
html.EscapeString(m.Alt),
html.EscapeString(class))
if m.Width > 0 && m.Height > 0 {
attrs += fmt.Sprintf(` width="%d" height="%d"`, m.Width, m.Height)
}
return fmt.Sprintf(`<img %s>`, attrs)
}
// TemplateRenderer is the interface for rendering pongo2/Jinja2-style templates.
// The CMS registers an implementation at startup.
type TemplateRenderer interface {
RenderTemplate(tmpl string, data map[string]any) (string, error)
ProcessIcons(html string) string
}
// templateRenderer holds the registered template renderer.
var templateRenderer TemplateRenderer
// RegisterTemplateRenderer sets the global template renderer.
// Called by the CMS at startup to provide pongo2 rendering.
func RegisterTemplateRenderer(r TemplateRenderer) {
templateRenderer = r
}
// RenderTemplate renders a pongo2/Jinja2-style template string with the given data.
// Returns the rendered HTML or an error. Falls back to a no-op if no renderer is registered.
func RenderTemplate(tmpl string, data map[string]any) (string, error) {
if templateRenderer == nil {
// No renderer registered — return template as-is (no variable substitution)
return tmpl, nil
}
return templateRenderer.RenderTemplate(tmpl, data)
}
// ProcessIcons processes ::pack:name:: icon syntax in HTML.
// Returns the HTML with icons replaced, or the original if no renderer is registered.
func ProcessIcons(htmlStr string) string {
if templateRenderer == nil {
return htmlStr
}
return templateRenderer.ProcessIcons(htmlStr)
}