@lewishowles/cli-style 0.12.1 → 0.14.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## Unreleased
 
+## 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
+
+- Added Python `table()` and `row_group()` wrapper functions to the Python adapter, matching the existing shell/JS renderers.
+- `table()` columns can now set `maxWidth` and `overflow` (`'truncate'`, the default, or `'wrap'`) to cap a column's width and control how long values render within it.
+
 ## 0.12.1 - 2026-08-20
 
 ### Fixed

package/README.md

@@ -17,7 +17,21 @@ 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 adapter from a local path with `uv`:
+
+```bash
+uv add --editable ../cli-style/adapters/python
+```
+
+They can also install it from this repository:
+
+```bash
+uv add "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 +153,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 +189,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 +249,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 +261,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 +329,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 +767,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/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",
+]