Metadata-Version: 2.3
Name: whitebox-plugin-ui-components
Version: 0.1.8
Summary: UI components for WhiteBox
License: GNU Affero General Public License v3
Author: avilabss
Author-email: contact@avilabs.net
Requires-Python: >=3.14.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown

# Whitebox Plugin - UI Components

This is a plugin for [whitebox](https://gitlab.com/whitebox-aero) that includes a set of reusable UI components like buttons, spinners and input area that can be used in other plugins.

## Installation

Install the plugin to whitebox:

```
poetry add whitebox-plugin-ui-components
```

## Frontend development

`make build` produces ordinary Python source archives without JavaScript. Core
prepares common tooling and explicitly assembles this owner's separate remote
after installation; UI Components needs no private dependency install. In a
prepared backend dev container, use `make test-frontend` for its source suite. Follow
the shared [frontend package guide](https://docs.whitebox.aero/plugin_guide/#independent-frontend-packages)
and [JSX testing guide](https://docs.whitebox.aero/plugin_guide/#testing-jsx-code)
for prerequisites and source tests.

Whitebox globals must exist before module evaluation. Button reads `Whitebox.utils`
and Spinner resolves `icons.spinner` through the component API, not a bundled
sibling checkout. The package ships `OverlayPrimitives.css`; global Tailwind
classes, design variables and core bootstrap assets still come from the host.
Source tests supply a small setup-time Whitebox mock.

Use the [owner application gate](https://docs.whitebox.aero/plugin_guide/#integration-testing)
to build/install your checkout's wheel and check it in the assembled App.
[Aggregate application checks](https://docs.whitebox.aero/development_guide/#maintained-built-application-checks)
use installed image packages, not local plugin edits; that guide lists prerequisites
and coverage limits.

## Additional Instructions

- [Plugin Development Guide](https://docs.whitebox.aero/plugin_guide/#plugin-development-workflow)
- [Plugin Testing Guide](https://docs.whitebox.aero/plugin_guide/#testing-plugins)
- [Contributing Guidelines](https://docs.whitebox.aero/development_guide/#contributing)

