Metadata-Version: 2.4
Name: vimkit
Version: 0.1.0
Summary: Reusable Textual vim-style editor widgets and extension hooks.
Keywords: textual,tui,vim,editor,terminal-ui
Author: Raelon
Author-email: Raelon <tty303@proton.me>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Terminals
Classifier: Typing :: Typed
Requires-Dist: textual[syntax]>=8.2.8
Requires-Python: >=3.14
Project-URL: Homepage, https://git.th3r00t.net/th3r00t/VimKit
Project-URL: Source, https://git.th3r00t.net/th3r00t/VimKit
Description-Content-Type: text/markdown

# VimKit

Reusable Textual vim-style editor components extracted from Fleet.

## What is here

- `VimEditor`: the core modal editor widget
- `VimWorkbench`: editor plus VimKit-owned top bar, command bar, and status bar
- `VimExtension`: extension hook for `:` commands and editor integrations
- `VimHost`: host interface for project-specific behaviors like named directories

## Status

The package is source-isolated and can be developed independently from Fleet.

## Local development

```bash
uv sync
uv run python -m compileall src
```

## Install

```bash
pip install vimkit
```

## Using from another project

During development, add it as a local path dependency:

```bash
uv add --editable ../VimKit
```

Later, switch to a Git dependency or the published PyPI package.

## First release flow

1. Bump the version in `pyproject.toml`.
2. Sync dev tools with `uv sync --dev`.
3. Build distributions with `uv build`.
4. Validate artifacts with `uv run twine check dist/*`.
5. Upload with `uv run twine upload dist/*`.

PyPI will prompt for your username and password unless you use an API token.

## Notes

- VimKit is released under the MIT license.
- If you later mirror this to GitHub, PyPI Trusted Publishing is preferable to long-lived credentials.
