dshtui-format-setting

Readme

# dshtui-format-setting

[![ci](https://github.com/VviLliAm-qwq/dshtui-format-setting/actions/workflows/ci.yml/badge.svg)](https://github.com/VviLliAm-qwq/dshtui-format-setting/actions/workflows/ci.yml)

**English** · [中文](README.zh.md)

Built for [dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI).

Lightweight window settings for dsh-tui.

- **Maximize on startup** — dsh-tui maximizes the terminal window when it starts.
  It lives in the **Window** section of the settings screen: one switch, applied
  the moment it is turned on.
- The switch is shown directly on the section card; there is no group page to
  open first (since 0.3.0).
- The settings card is bilingual (Chinese/English), rendered by the host in the
  language `/lang` selected.
- Window control goes through Win32 APIs (the classic console host); any other
  host degrades to a warning log instead of failing.
- **Removed in 0.2.0:** font settings (5+ families, 12–28 sizes, per-user font
  installation), size presets and “save current size”.
- **0.3.0:** the “Style / Startup window settings” group page is gone; the
  section is named **Window** and the switch sits directly on it.

Restart dsh-tui after installing.

## Install

```sh
dsh plugin --profile dsh-tui add dshtui-format-setting
```

Restart dsh-tui (`/restart`) afterwards.

## Settings

| Field | Type | Default | Meaning |
| --- | --- | --- | --- |
| Maximize on startup | boolean | `false` | Maximize the terminal window when dsh-tui starts; turning it on applies immediately. |

## Limitations

- Window control is Win32-only (the classic console host). On other hosts the
  plugin logs a warning and does nothing.
- The plugin registers the settings namespace `dshtui-format-setting`; a host
  without a settings service keeps the switch inert rather than failing.

## Publishing

- **Repository**: <https://github.com/VviLliAm-qwq/dshtui-format-setting> (public)
- **Release**: `v*` tags drive `.github/workflows/release.yml`, which publishes to npm through **trusted publishing (OIDC)** — no token is stored in the repository.

## License

MIT — see [LICENSE](LICENSE).