render

type CapabilityOverlay struct {
	// BadgeText is displayed as a badge on the capability (e.g., "M3.5", "L2").
	BadgeText string

	// BadgeColor is the background color for the badge (e.g., "#3b82f6").
	// If empty, a default color based on the badge content may be used.
	BadgeColor string

	// BadgeTextColor is the text color for the badge.
	// If empty, white or black is chosen based on BadgeColor contrast.
	BadgeTextColor string

	// TooltipExtra is additional text appended to the capability's tooltip.
	TooltipExtra string
}

type D2Options struct {
	// Title shown at the top of the diagram.
	Title string

	// Style controls the overall rendering approach.
	Style D2Style

	// ShowDependencies renders dependency arrows between capabilities.
	// Ignored when Style is D2StyleGrid.
	ShowDependencies bool

	// ShowFoundational includes foundational capabilities in a separate section.
	ShowFoundational bool

	// ShowLegend displays the status color legend.
	ShowLegend bool

	// ColorByStatus uses status-based colors instead of category colors.
	ColorByStatus bool

	// Direction sets the layout direction ("down" or "right").
	Direction string

	// GridColumns sets the number of columns per layer row (0 = auto).
	// Only used when Style is D2StyleGrid.
	GridColumns int

	// Overlays provides additional display data (badges, tooltips) for capabilities.
	// This allows external modules to inject data like maturity levels.
	Overlays OverlayProvider
}

type D2Style string

type HTMLOptions struct {
	// Title overrides the document title.
	Title string

	// ShowLegend displays the status color legend.
	ShowLegend bool

	// ShowFoundational includes foundational capabilities.
	ShowFoundational bool

	// Standalone generates a complete HTML document (vs. embeddable fragment).
	Standalone bool

	// DarkTheme uses dark color scheme.
	DarkTheme bool

	// Overlays provides additional display data (badges, tooltips) for capabilities.
	// This allows external modules to inject data like maturity levels.
	Overlays OverlayProvider
}

type LitCapability struct {
	ID          string    `json:"id"`
	Name        string    `json:"name"`
	FullName    string    `json:"fullName,omitempty"`
	Description string    `json:"description,omitempty"`
	LayerID     string    `json:"layerId"`
	CategoryID  string    `json:"categoryId,omitempty"`
	Status      string    `json:"status"`
	Priority    string    `json:"priority,omitempty"`
	Importance  string    `json:"importance,omitempty"`
	Order       int       `json:"order,omitempty"`
	Owner       string    `json:"owner,omitempty"`
	Tooling     []LitTool `json:"tooling,omitempty"`
	Tags        []string  `json:"tags,omitempty"`
}

type LitCategory struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Order       int    `json:"order,omitempty"`
}

type LitGridData struct {
	Title        string                 `json:"title,omitempty"`
	Layers       []LitLayer             `json:"layers"`
	Categories   []LitCategory          `json:"categories"`
	Capabilities []LitCapability        `json:"capabilities"`
	Maturity     map[string]LitMaturity `json:"maturity,omitempty"`
}

type LitLayer struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Order       int    `json:"order,omitempty"`
}

type LitMaturity struct {
	CapabilityID string `json:"capabilityId"`
	Level        int    `json:"level"`
	SLICount     int    `json:"sliCount,omitempty"`
}

type LitOptions struct {
	// Title overrides the document title.
	Title string

	// Theme is "light" or "dark".
	Theme string

	// View is "by-layer" or "by-category".
	View string

	// ShowLegend displays the status/maturity filters.
	ShowLegend bool

	// ShowViewToggle displays the view mode toggle buttons.
	ShowViewToggle bool

	// ComponentPath is the path to the prism-ui.js component file.
	// Defaults to "prism-ui.js" (same directory as HTML).
	ComponentPath string

	// Overlays provides maturity data to include in the JSON.
	Overlays OverlayProvider
}

type LitTool struct {
	Name   string `json:"name"`
	Type   string `json:"type,omitempty"`
	Status string `json:"status,omitempty"`
	URL    string `json:"url,omitempty"`
}

type OverlayProvider map[string]CapabilityOverlay