smelt.settings¶

Tier: UiHost - Requires a terminal UI; calling these from headless mode raises.

Visibility: Public - Stable Lua API intended for user config and plugins.

Metatable-backed proxy table for preferences. Read and write scalar keys directly (settings.foo = true, settings.compact_threshold = 0.65) or iterate with pairs. Values are typed per the schema; type mismatches raise. settings.notifications and settings.transcript are Lua tables for plugin preferences. UiHost-only.

smelt.settings.schema¶

fun(): table

Return the settings schema as an array of { key, kind, choices? } rows. kind is "bool", "number", or "string". choices is present for "string" keys with a closed value set. Useful for config tooling and introspection.