config

var Groups = []string{GroupAppearance, GroupData, GroupShell, 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. `high-contrast` draws white on " +
			"black or black on white by the terminal's background, with WCAG AAA contrast. 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) or, " +
			"outside tmux, sixel graphics (foot, xterm, mlterm, Windows Terminal). 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: "locale", Kind: Enum, Group: GroupData, Default: "en-US", Values: locale.Tags(), Env: []string{"O12_LOCALE"},
		Fallback: []string{"LC_ALL", "LC_NUMERIC", "LANG"}, Adopt: locale.FromPOSIX, Live: true,
		Desc: "How new sheets and files without a locale of their own are typed and shown: decimal and " +
			"thousands separators, date order, the currency symbol and the formula argument separator " +
			"(`;` where the decimal separator is a comma), as in Sheets' File > Settings > Locale, " +
			"which sets a file's own. Files store the same thing in every locale. " +
			"When unset, the POSIX locale (`LC_ALL`, `LC_NUMERIC`, then `LANG`, e.g. `de_DE.UTF-8`) picks it if it's one of these."},

	{Name: "max-cells", Kind: Int, Group: GroupData, Default: "10000000", Env: []string{"O12_MAX_CELLS"}, Live: true,
		Desc: "The most cells an import keeps, and a paste or fill writes at once. Numbers and text " +
			"take 20 to 60 bytes a cell and formulas about 750, so the default of ten million cells of " +
			"data is 200 to 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: "shell", Kind: Enum, Group: GroupShell, Default: "ask", Values: []string{"off", "ask", "on"}, Env: []string{"O12_SHELL"}, Live: true,
		Desc: "Whether notebooks run their code cells (docs/nushell/notebooks.md). `ask` runs what you write " +
			"and asks once before running the cells of a file made on another computer; `on` never asks; " +
			"`off` runs none. Opening a file never runs its cells."},
	{Name: "nu-timeout", Kind: Duration, Group: GroupShell, Default: "30s", Env: []string{"O12_NU_TIMEOUT"}, Live: true,
		Desc: "Stop a notebook cell that runs longer than this; 0 lets it run until Stop (i i) stops it."},
	{Name: "nu-config", Kind: Bool, Group: GroupShell, Default: "false", Env: []string{"O12_NU_CONFIG"}, Live: true,
		Desc: "Run notebook cells with your nushell config files (config.nu, env.nu) rather than " +
			"`nu --no-config-file`, for your own commands and aliases."},
	{Name: "nu-save-cell-kb", Kind: Int, Group: GroupShell, Default: "1024", Env: []string{"O12_NU_SAVE_CELL_KB"}, Live: true,
		Desc: "The largest output of one cell a saved file keeps, in kilobytes of NUON; a larger one is left out " +
			"and shows `not saved; run to see` when the file is opened."},
	{Name: "nu-save-notebook-kb", Kind: Int, Group: GroupShell, Default: "8192", Env: []string{"O12_NU_SAVE_NOTEBOOK_KB"}, Live: true,
		Desc: "How much of all its cells' outputs a saved file keeps, in kilobytes of NUON: the outputs that fit, " +
			"in the notebook's order."},

	{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/contributing/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/terminal/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: "serve-shell", Kind: Bool, Group: GroupServe, Default: "false",
		Desc: "Let 012 serve sessions run notebooks' code cells, as the user 012 serve runs as, " +
			"following the shell option. Off, served notebooks show their cells and saved outputs but run nothing."},

	{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."},
}