package d2fonts

Import Path
	github.com/pancsta/d2/d2renderers/d2fonts (on go.dev)

Dependency Relation
	imports 23 packages, and imported by 10 packages

Involved Source Files

	    bundled_faces.go
	    bundled_fallback.go
	  d d2fonts_common.go
		TODO write a script to do this as part of CI
		Currently using an online converter: https://dopiaza.org/tools/datauri/index.php

	    d2fonts_embed.go
	  d doc.go
		Package d2fonts provides D2's embedded font families and bounded native
		fallback resolution for renderer text.

	    fallback.go
	    noto_color_emoji_native.go
Package-Level Type Names (total 10)

	/* sort by: alphabet | popularity */
	 type BundledFallbackLimits (struct)
		BundledFallbackLimits bound all requests and returned bytes over the
		lifetime of one composite resolver. MaxBundledBytes reserves an explicit
		sub-budget for owned copies of D2's trusted font; MaxResolvedBytes bounds
		those copies plus downstream results. The downstream resolver remains
		responsible for its own discovery and coverage-work limits.

		Fields (total 3)
			MaxBundledBytes int64
				MaxBundledBytes defaults to MaxResolvedBytes when zero.

			MaxRequestedRunes int
			MaxResolvedBytes int64
		As Inputs Of (at least one exported)
			func NewBundledFallbackResolver(next FallbackResolver, limits BundledFallbackLimits) (*BundledFallbackResolver, error)

	 type BundledFallbackResolver (struct)
		BundledFallbackResolver resolves supported symbols and emoji from D2's
		pinned Noto Color Emoji face before consulting the host. This makes those
		glyphs deterministic across machines while leaving other scripts to a
		bounded downstream resolver. On js/wasm the bundled face is absent and all
		requests pass through to downstream.

		Methods (total 3)
			( BundledFallbackResolver) HasTrusted() bool
				HasTrusted reports whether PrepareTrusted has retained its trusted resource.

			( BundledFallbackResolver) PrepareTrusted(ctx context.Context, source fontfallback.Font) (fontfallback.SceneFont, bool, error)
				PrepareTrusted copies and hashes the resolver's trusted source exactly once
				for this cache. A canceled attempt publishes neither data nor accounting.

			(*BundledFallbackResolver) ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)
		Implements (at least one exported)
			*BundledFallbackResolver : FallbackResolver
		As Outputs Of (at least one exported)
			func NewBundledFallbackResolver(next FallbackResolver, limits BundledFallbackLimits) (*BundledFallbackResolver, error)

	 type FallbackFont (struct)
		FallbackFont is one fully resolved host font face. Data is owned by the
		result and may be retained in a network-free renderer scene. FaceIndex
		selects a face when Data contains an OpenType collection.

		Fields (total 4)
			Data []byte
			FaceIndex uint16
			MIMEType string
			Name string
		As Outputs Of (at least 3)
			func (*BundledFallbackResolver).ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)
			func FallbackResolver.ResolveFallbacks(context.Context, FallbackRequest) ([]FallbackFont, error)
			func (*SystemFallbackResolver).ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)

	 type FallbackRequest (struct)
		FallbackRequest carries both missing code points and the source text style.
		Resolvers may ignore style when a face is intrinsically universal, but must
		preserve it when delegating so bold, italic, semibold, and monospace text do
		not silently fall back to an unrelated regular proportional face.

		Fields (total 4)
			Family string
			Runes []rune
			Style string
			Weight int
		As Inputs Of (at least 3)
			func (*BundledFallbackResolver).ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)
			func FallbackResolver.ResolveFallbacks(context.Context, FallbackRequest) ([]FallbackFont, error)
			func (*SystemFallbackResolver).ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)

	 type FallbackResolver (interface)
		FallbackResolver resolves an ordered set of font faces covering runes not
		present in a D2 label's configured primary font. An empty or partial result
		means the remaining runes have no available face; it is not an error.
		Implementations must return owned immutable bytes and must honor context
		cancellation between bounded I/O operations. Malformed resources and work
		or byte limit violations remain errors.

		Methods (only one)
			( FallbackResolver) ResolveFallbacks(context.Context, FallbackRequest) ([]FallbackFont, error)
		Implemented By (at least 2)
			*BundledFallbackResolver
			*SystemFallbackResolver
		As Inputs Of (at least one exported)
			func NewBundledFallbackResolver(next FallbackResolver, limits BundledFallbackLimits) (*BundledFallbackResolver, error)

	 type Font (struct)

		Fields (total 3)
			Family FontFamily
			Size int
			Style FontStyle
		Methods (only one)
			( Font) GetEncodedSubset(corpus string) string
		As Outputs Of (at least one exported)
			func FontFamily.Font(size int, style FontStyle) Font
		As Inputs Of (at least 4)
			func AddFontStyle(font Font, style FontStyle, ttf []byte) error
			func github.com/pancsta/d2/lib/textmeasure.(*Ruler).Measure(font Font, s string) (width, height int)
			func github.com/pancsta/d2/lib/textmeasure.(*Ruler).MeasureMono(font Font, s string) (width, height int)
			func github.com/pancsta/d2/lib/textmeasure.(*Ruler).MeasurePrecise(font Font, s string) (width, height float64)

	 type FontFamily string (basic type)

		Methods (only one)
			( FontFamily) Font(size int, style FontStyle) Font
		As Outputs Of (at least one exported)
			func AddFontFamily(name string, regularTTF, italicTTF, boldTTF, semiboldTTF []byte) (*FontFamily, error)
		As Inputs Of (at least 18)
			func github.com/pancsta/d2/d2renderers/d2svg.EmbedFonts(buf *bytes.Buffer, diagramHash, source string, fontFamily *FontFamily, monoFontFamily *FontFamily, corpus string)
			func github.com/pancsta/d2/d2renderers/d2svg.EmbedFonts(buf *bytes.Buffer, diagramHash, source string, fontFamily *FontFamily, monoFontFamily *FontFamily, corpus string)
			func github.com/pancsta/d2/d2exporter.Export(ctx context.Context, g *d2graph.Graph, fontFamily *FontFamily, monoFontFamily *FontFamily) (*d2target.Diagram, error)
			func github.com/pancsta/d2/d2exporter.Export(ctx context.Context, g *d2graph.Graph, fontFamily *FontFamily, monoFontFamily *FontFamily) (*d2target.Diagram, error)
			func github.com/pancsta/d2/d2graph.GetTextDimensions(mtexts []*d2target.MText, ruler *textmeasure.Ruler, t *d2target.MText, fontFamily *FontFamily) *d2target.TextDimensions
			func github.com/pancsta/d2/d2graph.GetTextDimensionsWithMono(mtexts []*d2target.MText, ruler *textmeasure.Ruler, t *d2target.MText, fontFamily *FontFamily, monoFontFamily *FontFamily) *d2target.TextDimensions
			func github.com/pancsta/d2/d2graph.GetTextDimensionsWithMono(mtexts []*d2target.MText, ruler *textmeasure.Ruler, t *d2target.MText, fontFamily *FontFamily, monoFontFamily *FontFamily) *d2target.TextDimensions
			func github.com/pancsta/d2/d2graph.(*Graph).SetDimensions(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily) error
			func github.com/pancsta/d2/d2graph.(*Graph).SetDimensions(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily) error
			func github.com/pancsta/d2/d2graph.(*Object).GetDefaultSize(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, labelDims d2target.TextDimensions, withLabelPadding bool) (*d2target.TextDimensions, error)
			func github.com/pancsta/d2/d2graph.(*Object).GetDefaultSize(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, labelDims d2target.TextDimensions, withLabelPadding bool) (*d2target.TextDimensions, error)
			func github.com/pancsta/d2/d2graph.(*Object).GetLabelSize(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily) (*d2target.TextDimensions, error)
			func github.com/pancsta/d2/d2graph.(*Object).GetLabelSize(mtexts []*d2target.MText, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily) (*d2target.TextDimensions, error)
			func github.com/pancsta/d2/lib/textmeasure.LayoutMarkdown(mdText string, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, fontSize int) (*textmeasure.MarkdownLayout, error)
			func github.com/pancsta/d2/lib/textmeasure.LayoutMarkdown(mdText string, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, fontSize int) (*textmeasure.MarkdownLayout, error)
			func github.com/pancsta/d2/lib/textmeasure.MeasureMarkdown(mdText string, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, fontSize int) (width, height int, err error)
			func github.com/pancsta/d2/lib/textmeasure.MeasureMarkdown(mdText string, ruler *textmeasure.Ruler, fontFamily *FontFamily, monoFontFamily *FontFamily, fontSize int) (width, height int, err error)
			func github.com/pancsta/d2/lib/textmeasure.(*Ruler).HasFontFamilyLoaded(fontFamily *FontFamily) bool
		As Types Of (total 3)
			const HandDrawn
			const SourceCodePro
			const SourceSansPro

	 type FontStyle string (basic type)

		As Inputs Of (at least 2)
			func AddFontStyle(font Font, style FontStyle, ttf []byte) error
			func FontFamily.Font(size int, style FontStyle) Font
		As Types Of (total 4)
			const FONT_STYLE_BOLD
			const FONT_STYLE_ITALIC
			const FONT_STYLE_REGULAR
			const FONT_STYLE_SEMIBOLD

	 type SystemFallbackLimits (struct)
		SystemFallbackLimits bounds deterministic host-font discovery for the
		lifetime of one resolver. FileBytes bounds one candidate; every other
		work/byte limit is cumulative across indexing attempts and ResolveFallbacks
		calls. A CLI export owns one resolver, so these are operation-wide ceilings
		rather than per-board or per-style allowances.

		Fields (total 8)
			MaxCoverageChecks int64
			MaxDirectoryEntries int
			MaxFaces int
			MaxFileBytes int64
			MaxFiles int
			MaxRequestedRunes int
			MaxResolvedBytes int64
			MaxScannedBytes int64
		As Inputs Of (at least one exported)
			func NewSystemFallbackResolver(limits SystemFallbackLimits) (*SystemFallbackResolver, error)

	 type SystemFallbackResolver (struct)
		SystemFallbackResolver discovers fonts only under the operating system's
		conventional system font roots. It does not follow symlinks or consult a
		platform API, keeping discovery CGO-free and auditable. User-installed D2
		primary fonts continue to flow through AddFontFamily and do not need this
		resolver.

		Methods (only one)
			(*SystemFallbackResolver) ResolveFallbacks(ctx context.Context, request FallbackRequest) ([]FallbackFont, error)
		Implements (at least one exported)
			*SystemFallbackResolver : FallbackResolver
		As Outputs Of (at least one exported)
			func NewSystemFallbackResolver(limits SystemFallbackLimits) (*SystemFallbackResolver, error)


Package-Level Functions (total 4)

	 func AddFontFamily(name string, regularTTF, italicTTF, boldTTF, semiboldTTF []byte) (*FontFamily, error)
	 func AddFontStyle(font Font, style FontStyle, ttf []byte) error
	 func NewBundledFallbackResolver(next FallbackResolver, limits BundledFallbackLimits) (*BundledFallbackResolver, error)
	 func NewSystemFallbackResolver(limits SystemFallbackLimits) (*SystemFallbackResolver, error)
Package-Level Variables (total 7)

	  var D2_FONT_TO_FAMILY map[string]FontFamily
	  var FontEncodings syncmap.SyncMap[Font, string]
	  var FontFaces syncmap.SyncMap[Font, []byte]
	  var FontFamilies []FontFamily
	  var FontFamiliesMu sync.Mutex
	  var FontSizes []int
	  var FontStyles []FontStyle
Package-Level Constants (total 14)

	const FONT_SIZE_L = 20
	const FONT_SIZE_M = 16
	const FONT_SIZE_S = 14
	const FONT_SIZE_XL = 24
	const FONT_SIZE_XS = 13
	const FONT_SIZE_XXL = 28
	const FONT_SIZE_XXXL = 32
	const FONT_STYLE_BOLD FontStyle = "bold"
	const FONT_STYLE_ITALIC FontStyle = "italic"
	const FONT_STYLE_REGULAR FontStyle = "regular"
	const FONT_STYLE_SEMIBOLD FontStyle = "semibold"
	const HandDrawn FontFamily = "HandDrawn"
	const SourceCodePro FontFamily = "SourceCodePro"
	const SourceSansPro FontFamily = "SourceSansPro"

The pages are generated with Golds v0.8.7. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.