config

var Groups = []string{GroupAppearance, GroupData, GroupJEV, GroupTelemetry, GroupServe, GroupFiles}

var Options = []Option{
	{Name: "theme", Group: GroupAppearance, Default: "terminal", Env: []string{"O12_THEME"}, Flag: "--theme", Live: true,
		Desc: "Colors. `terminal` uses the terminal's own 16-color palette. Any other name is a " +
			"terminal color scheme, built in (`012 config themes` lists them) or a file in the themes " +
			"directory, drawn in its own colors with solid menu and status bars. " +
			"`light:NAME,dark:NAME` picks one by the terminal's background and follows it when it changes.",
		Check: checkTheme},
	{Name: "chart-images", Kind: Bool, Group: GroupAppearance, Default: "true", Env: []string{"O12_CHART_IMAGES"}, Live: true,
		Desc: "Draw charts as images on terminals with kitty graphics (kitty, Ghostty, WezTerm). " +
			"When false, charts are always text."},
	{Name: "notifications", Kind: Bool, Group: GroupAppearance, Default: "true", Env: []string{"O12_NOTIFICATIONS"}, Live: true,
		Desc: "Send a desktop notification (OSC 9) when JEV answers or an import finishes while the " +
			"terminal window is in the background."},
	{Name: "keymap", Kind: Enum, Group: GroupAppearance, Default: "default", Values: []string{"default", "vim"}, Env: []string{"O12_KEYMAP"}, Live: true,
		Desc: "Keys in the grid. `default` works like Google Sheets; `vim` adds hjkl, counts, operators, " +
			"visual selection and a : command line (File > Settings > Vim keys)."},

	{Name: "max-cells", Kind: Int, Group: GroupData, Default: "2000000", Env: []string{"O12_MAX_CELLS"}, Live: true,
		Desc: "The most cells an import keeps, and a paste or fill writes at once. A sheet takes about " +
			"300 bytes a cell, so the default of two million is about 600 MB. Imports keep whole rows " +
			"up to the budget and say how many they left out; larger pastes and fills are refused. " +
			"The grid itself is 1,048,576 rows by 16,384 columns (A to XFD) whatever this is."},

	{Name: "jev-api-key-command", Kind: Command, Group: GroupJEV,
		Desc: "A command that prints the TypeSafe API key, used when TYPESAFE_API_KEY isn't set and the " +
			"credential store has no key, e.g. `op read op://Private/TypeSafe/credential` or " +
			"`pass show typesafe`. It runs the first time a sheet asks JEV something, without a shell, for up to 10 seconds, and its first line of output is the key; for pipes, write " +
			"`sh -c '...'` yourself. The key itself never goes in this file."},
	{Name: "jev-credential-store", Kind: Bool, Group: GroupJEV, Default: "true", Env: []string{"O12_JEV_CREDENTIAL_STORE"},
		Desc: "Look for the API key in the OS credential store (macOS Keychain, Windows Credential Manager, " +
			"the Secret Service on Linux), where `012 config set-key` and Settings put it."},
	{Name: "jev-base-url", Kind: URL, Group: GroupJEV, Env: []string{"TYPESAFE_BASE_URL"},
		Desc:  "The TypeSafe service to ask; the SDK's default when empty. Must be https, except on localhost.",
		Check: CheckBaseURL, Redact: redactURL},
	{Name: "jev-model", Group: GroupJEV, Env: []string{"TYPESAFE_DEFAULT_MODEL"},
		Desc: "The JEV model to ask; the service's default when empty."},

	{Name: "log-file", Kind: Path, Group: GroupTelemetry, Env: []string{"O12_LOG"}, Flag: "--log",
		Desc: "Append telemetry events to this JSON log file. See docs/observability.md."},
	{Name: "log-level", Kind: Enum, Group: GroupTelemetry, Default: "info", Values: []string{"debug", "info", "warn", "error"},
		Env:  []string{"O12_LOG_LEVEL"},
		Desc: "The least severe telemetry event recorded; debug adds every frame and command."},
	{Name: "otlp-endpoint", Kind: URL, Group: GroupTelemetry, Env: []string{"OTEL_EXPORTER_OTLP_ENDPOINT"}, Flag: "--otlp",
		Desc: "Send telemetry to this OTLP/HTTP collector, e.g. http://localhost:4318. " +
			"The other OTEL_* variables still apply.",
		Redact: redactURL},

	{Name: "serve-listen", Kind: Address, Group: GroupServe, Default: "127.0.0.1:2312",
		Desc: "The address 012 serve listens on. Anything but the loopback address lets other machines " +
			"reach it (with an authorized key). See docs/ssh.md."},
	{Name: "serve-authorized-keys", Kind: Path, Group: GroupServe, Default: "~/.ssh/authorized_keys",
		Desc: "The public keys allowed to log in to 012 serve, in OpenSSH's authorized_keys format."},
	{Name: "serve-host-key", Kind: Path, Group: GroupServe,
		Desc: "012 serve's private host key, generated when missing; " +
			"ssh_host_ed25519_key in the config directory when empty."},
	{Name: "serve-idle-timeout", Kind: Duration, Group: GroupServe, Default: "30m",
		Desc: "End a 012 serve session that has had no input for this long; 0 never does."},
	{Name: "serve-max-sessions", Kind: Int, Group: GroupServe, Default: "8",
		Desc: "How many 012 serve sessions may run at once; more are turned away."},

	{Name: "config-file", Kind: Path, Group: GroupFiles, Repeat: true,
		Desc: "Read another config file after this one, relative to this file's directory. " +
			"A leading `?` makes it optional: no warning when it doesn't exist."},
}