@lewishowles/cli-style 0.13.0 → 0.15.0

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## Unreleased
 
+## 0.15.0 - 2026-09-20
+
+### Added
+
+- The Python adapter is published to PyPI as `lewishowles-cli-style`, so Python projects can install it with `pip install lewishowles-cli-style` instead of from a local path or this repository. The name it is imported under is unchanged: `import cli_style`.
+- `bun run check:adapters` now fails when `package.json` and the Python package declare different versions, or when the Python package's copy of the licence differs from the one at the repository root.
+- Releasing a tag whose version does not match `package.json` now fails before anything is published.
+
+## 0.14.0 - 2026-09-20
+
+### Added
+
+- Added a `bulletList()` renderer (`bullet-list` for `cli-style render`) for simple bulleted lists. Section lists in the patterns layer now render through it, with unchanged output.
+- Added a `bullet_list` wrapper to the Python adapter.
+- The renderer catalogue now describes each renderer's parameters with their types, and the full input contract each renderer accepts, so adapters and agents can work out how to call a renderer without reading the source.
+- The Python adapter's wrappers are now generated from the renderer catalogue, so they stay in step with the renderers they wrap.
+- The Swift adapter now ships as a Swift package with generated wrappers, exposing a `CliStyle` product.
+- The Bash, Python, and Swift adapters now fall back to plain text when the `cli-style` binary is not on `PATH`, instead of failing.
+- `bun run check:adapters` now fails when the generated adapter wrappers are out of date with the renderer catalogue.
+
+### Fixed
+
+- The published package now includes the Python and Swift adapter packages, which were missing from the build.
+
 ## 0.13.0 - 2026-09-05
 
 ### Added

package/README.md

@@ -17,7 +17,27 @@ JavaScript projects can install the package directly:
 bun add @lewishowles/cli-style
 ```
 
-Bash, Python, and Swift projects call the `cli-style` binary through thin adapters. If the project already has Node or Bun tooling, add this package as a dev dependency and use the package binary. Otherwise, install or vendor the standalone binary and put it on `PATH`:
+Python projects can install the published package from PyPI:
+
+```bash
+pip install lewishowles-cli-style
+```
+
+They can also install the adapter from a local path with `uv`:
+
+```bash
+uv add --editable ../cli-style/adapters/python
+```
+
+Or install it straight from this repository:
+
+```bash
+uv add "lewishowles-cli-style @ git+https://github.com/lewishowles/cli-style.git#subdirectory=adapters/python"
+```
+
+Swift projects can add `adapters/swift` as a local package dependency and use its `CliStyle` product.
+
+The Bash, Python, and Swift adapters all call the `cli-style` binary. If your project already uses Node or Bun, add this package as a dev dependency and use its binary. Otherwise, put the standalone binary on `PATH`:
 
 ```bash
 export PATH="/path/to/cli-style/bin:$PATH"
@@ -139,11 +159,7 @@ JSON
 
 ### Python
 
-Add the adapter directory to `PYTHONPATH`, then import the generic `render()` helper or convenience functions:
-
-```bash
-export PYTHONPATH="$(cli-style adapter-path python):$PYTHONPATH"
-```
+Install the package as described in [Install](#install), then import the generic `render()` helper or convenience functions:
 
 ```python
 from cli_style import status, row, span, hint, divider
@@ -179,11 +195,23 @@ print(output)
 
 ### Swift
 
-Add the adapter file to your Swift project, then use the `CliStyle` enum for convenience functions or the generic `render` method:
+Add `adapters/swift` as a local Swift package dependency, then add its `CliStyle` product to your target. Use the `CliStyle` enum for convenience functions or the generic `render` method:
 
 ```bash
 cli-style adapter-path swift
-# Returns the path to CliStyle.swift for inclusion in your project
+# Returns the path to the adapters/swift package directory
+```
+
+```swift
+dependencies: [
+    .package(path: "../cli-style/adapters/swift"),
+],
+targets: [
+    .target(
+        name: "YourTarget",
+        dependencies: [.product(name: "CliStyle", package: "CliStyle")]
+    ),
+]
 ```
 
 ```swift
@@ -227,7 +255,8 @@ Renderer names are stable for `cli-style render`, `cli_style_render`, and Python
 | --------------------- | ------------------------------------- | ------------------------------------ | ---------------------------------- | -------------------------------------- | --------------------------------------------------------------- |
 | `status`              | `status(resultType, detail, options)` | `cli_style_status type label detail` | `status(type, label, detail)`      | `CliStyle.status(type, label, detail)` | Result line with symbol, label, and detail.                     |
 | `row`                 | `row(label, value, options)`          | `cli_style_row label value [result]` | `row(label, value, result)`        | `CliStyle.row(label, value, result)`   | Aligned label/value row, optionally marked with a result state. |
-| `row-group`           | `rowGroup(options)`                   | Use `cli_style_render`               | Use `render("row-group", ...)`     | Use `CliStyle.render`                  | Auto-aligned group of labelled value rows.                      |
+| `row-group`           | `rowGroup(options)`                   | Use `cli_style_render`               | `row_group(rows)`                  | Use `CliStyle.render`                  | Auto-aligned group of labelled value rows.                      |
+| `bullet-list`         | `bulletList(items, options)`          | Use `cli_style_render`               | `bullet_list(items)`               | Use `CliStyle.render`                  | Wrapped flat or nested bullet items.                            |
 | `span`                | `span(value, tone, options)`          | `cli_style_span value [tone]`        | `span(value, tone)`                | `CliStyle.span(value, tone)`           | Inline colour or weight for a word, command, file, or value.    |
 | `hint`                | `hint(message, options)`              | `cli_style_hint message`             | `hint(message)`                    | `CliStyle.hint(message)`               | Informational hint line.                                        |
 | `divider`             | `divider(options)`                    | `cli_style_divider label`            | `divider(label)`                   | `CliStyle.divider(label)`              | Section divider with an optional label.                         |
@@ -238,7 +267,7 @@ Renderer names are stable for `cli-style render`, `cli_style_render`, and Python
 | `next-step-block`     | `nextStepBlock(options)`              | `cli_style_next_step_block ...`      | `next_step_block(...)`             | `CliStyle.nextStepBlock(...)`          | Next-step guidance with command and alternative.                |
 | `chip`                | `chip(label, tone, options)`          | Use `cli_style_render`               | Use `render("chip", ...)`          | Use `CliStyle.render`                  | Compact labelled state.                                         |
 | `panel`               | `panel(options)`                      | Use `cli_style_render`               | Use `render("panel", ...)`         | Use `CliStyle.render`                  | Framed content block for grouped output.                        |
-| `table`               | `table(options)`                      | Use `cli_style_render`               | Use `render("table", ...)`         | Use `CliStyle.render`                  | Tabular records with narrow-width fallback.                     |
+| `table`               | `table(options)`                      | Use `cli_style_render`               | `table(columns, rows)`             | Use `CliStyle.render`                  | Tabular records with narrow-width fallback.                     |
 | `progress-bar`        | `progressBar(options)`                | Use `cli_style_render`               | Use `render("progress-bar", ...)`  | Use `CliStyle.render`                  | Single progress value with numeric text.                        |
 | `bar-chart`           | `barChart(options)`                   | Use `cli_style_render`               | Use `render("bar-chart", ...)`     | Use `CliStyle.render`                  | Multi-row bar chart.                                            |
 | `sparkline`           | `sparkline(options)`                  | Use `cli_style_render`               | Use `render("sparkline", ...)`     | Use `CliStyle.render`                  | Compact trend with latest, minimum, and maximum values.         |
@@ -306,6 +335,29 @@ Use these shapes with `cli-style render`, `cli_style_render`, or Python `render(
 - `labelWidth`: optional minimum width for every label
 - Per-row fields match `row`, including `label`, `value`, `result`, `labelColour`, `valueColour`, and `separator`
 
+### `bullet-list`
+
+Pass strings for flat lists, or objects with `text` and an optional nested `items` array. Text wraps to the available width and continuation lines align with the item text:
+
+```js
+bulletList(
+	[
+		"Install dependencies",
+		{
+			text: "Run checks",
+			items: ["Review failures", "Repeat the focused check"],
+		},
+	],
+	{ width: 48 },
+);
+// • Install dependencies
+// • Run checks
+//   ◦ Review failures
+//   ◦ Repeat the focused check
+```
+
+Use `profile: "agent"` for Markdown-compatible `-` bullets, or `unicode: false` for `*` bullets.
+
 ### `span`
 
 ```json
@@ -721,3 +773,13 @@ cli-style gallery --dark --section primitives
 ```
 
 Use `--interactive` to select a section or fixture with `fzf` when it is installed.
+
+## Generated adapter wrappers
+
+Named wrapper functions in the Python and Swift adapters are generated from `src/catalogue/renderer-catalogue.js` by `bun run generate:adapters`. Do not edit `adapters/python/cli_style/_wrappers.py` or `adapters/swift/Sources/CliStyle/Wrappers.swift` by hand. After changing the catalogue, run:
+
+```bash
+bun run generate:adapters
+```
+
+`bun run check` runs `check:adapters`, which fails when the committed wrappers are stale.

package/adapters/python/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lewis Howles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/adapters/python/README.md

@@ -0,0 +1,29 @@
+# lewishowles-cli-style
+
+`lewishowles-cli-style` is a Python adapter for the shared `cli-style` command-line renderer. It lets Python programs use the same terminal output styles as the JavaScript package.
+
+## Install
+
+```sh
+python -m pip install lewishowles-cli-style
+```
+
+The package supports Python 3.9 and later. The installed distribution is named `lewishowles-cli-style`, and you import it as `cli_style`.
+
+Rendering happens in the separate `cli-style` binary, so that needs to be on your `PATH`. The [main readme](https://github.com/lewishowles/cli-style#install) covers the ways to install it.
+
+## Usage
+
+```python
+from cli_style import render
+
+print(render("status", {"type": "success", "label": "Build passed"}))
+```
+
+If the `cli-style` binary is not available, `render()` returns sorted plain `key: value` text by default. Pass `raise_on_missing=True` to raise `CliStyleNotFoundError` instead.
+
+## More information
+
+- [Repository](https://github.com/lewishowles/cli-style)
+- [Issue tracker](https://github.com/lewishowles/cli-style/issues)
+- [MIT licence](https://github.com/lewishowles/cli-style/blob/main/LICENSE)

package/adapters/python/cli_style/__init__.py

@@ -0,0 +1,73 @@
+"""Public Python API for the cli-style adapter."""
+
+from ._wrappers import (
+	agent_transcript,
+	audit_finding,
+	bar_chart,
+	bullet_list,
+	chip,
+	command_result,
+	compact_data_table,
+	confirmation_result,
+	diagnostic_report,
+	diff_block,
+	divider,
+	empty_state,
+	error_block,
+	hint,
+	labelled_line,
+	next_step_block,
+	panel,
+	progress_bar,
+	row,
+	row_group,
+	sparkline,
+	span,
+	status,
+	step,
+	step_progress,
+	table,
+	task_summary,
+)
+from .core import (
+	CliStyleError,
+	CliStyleNotFoundError,
+	CliStyleRenderError,
+	render,
+	resolve_binary,
+)
+
+__all__ = [
+	"CliStyleError",
+	"CliStyleNotFoundError",
+	"CliStyleRenderError",
+	"agent_transcript",
+	"audit_finding",
+	"bar_chart",
+	"bullet_list",
+	"chip",
+	"command_result",
+	"compact_data_table",
+	"confirmation_result",
+	"diagnostic_report",
+	"diff_block",
+	"divider",
+	"empty_state",
+	"error_block",
+	"hint",
+	"labelled_line",
+	"next_step_block",
+	"panel",
+	"progress_bar",
+	"render",
+	"resolve_binary",
+	"row",
+	"row_group",
+	"sparkline",
+	"span",
+	"status",
+	"step",
+	"step_progress",
+	"table",
+	"task_summary",
+]