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 OverlayProvider map[string]CapabilityOverlay