FontSetting

What a font role is set to.

"Follow the app default" is a state, not a value. The alternative - writing today's default into the file - froze the default forever: v1 files wrote every font key on every save, and nobody saw a new default font until their file was deleted. So FollowDefault persists as no key at all, and a chosen family is always written even when it happens to equal the current default. That last part is a deliberate change from the pre-SP-6 writer, which omitted a key whose value matched the default and so could not tell a choice from a habit either.

Type "follow_default" or object or object

Shape

One of 3 shapes:

Variant 1
Use whatever this build's default for the role is, now and later.
"follow_default"

Variant 2

Use this family, whatever the build's default becomes.

Field	Type	Description
chosenrequired	FontFamily	The typeface a font role names. The tokens and their order are `koru_draw::theme::FontChoice`'s; the order is load-bearing there (role globals store an index) and is kept identical here so the two cannot drift into disagreeing about it.

Variant 3
Use this installed family, by name. On a computer without it the role draws its default and the choice is kept for one that has it.
Field Type Description
installedrequired FamilyName

Field	Type	Description
installedrequired	FamilyName

Example

"follow_default"

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.