@owloops/claude-powerline 1.24.1 → 1.24.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -609,7 +609,7 @@ Create custom themes and configure color compatibility:
|
|
|
609
609
|
}
|
|
610
610
|
```
|
|
611
611
|
|
|
612
|
-
By default, the TUI panel uses a built-in responsive layout. For full control over what goes where, add a `display.tui` object to your config
|
|
612
|
+
By default, the TUI panel uses a built-in responsive layout. For full control over what goes where, add a `display.tui` object to your config. This activates the **grid layout engine**, a CSS Grid-inspired system that lets you define rows, columns, spans, and responsive breakpoints.
|
|
613
613
|
|
|
614
614
|
#### Grid Layout Configuration
|
|
615
615
|
|
|
@@ -648,10 +648,10 @@ Add `display.tui` to your config file to enable the grid engine:
|
|
|
648
648
|
| `padding.horizontal` | `number` | `0` | Extra horizontal padding in `fitContent` mode |
|
|
649
649
|
| `separator.column` | `string` | `" "` | String placed between columns |
|
|
650
650
|
| `separator.divider` | `string` | box char | Character used for `---` divider rows |
|
|
651
|
-
| `box` | `object` |
|
|
652
|
-
| `title` | `object` |
|
|
653
|
-
| `footer` | `object` |
|
|
654
|
-
| `segments` | `object` |
|
|
651
|
+
| `box` | `object` | -- | Custom box-drawing characters (see below) |
|
|
652
|
+
| `title` | `object` | -- | Title bar text configuration (see below) |
|
|
653
|
+
| `footer` | `object` | -- | Footer text configuration (see below) |
|
|
654
|
+
| `segments` | `object` | -- | Custom segment templates (see below) |
|
|
655
655
|
| `breakpoints` | `array` | required | Responsive layout definitions |
|
|
656
656
|
|
|
657
657
|
#### Breakpoints
|
|
@@ -700,18 +700,18 @@ Each breakpoint defines a complete layout that activates when the panel width is
|
|
|
700
700
|
| Property | Type | Required | Description |
|
|
701
701
|
|---|---|---|---|
|
|
702
702
|
| `minWidth` | `number` | yes | Minimum panel width to activate this layout |
|
|
703
|
-
| `areas` | `string[]` | yes | Grid rows
|
|
703
|
+
| `areas` | `string[]` | yes | Grid rows, each string is one row of space-separated cell names |
|
|
704
704
|
| `columns` | `string[]` | yes | Column sizing: `"auto"`, `"1fr"` / `"2fr"`, or a fixed number like `"20"` |
|
|
705
705
|
| `align` | `string[]` | no | Per-column alignment: `"left"`, `"center"`, or `"right"` (defaults to `"left"`) |
|
|
706
706
|
|
|
707
707
|
**Column sizing:**
|
|
708
|
-
- `"auto"`
|
|
709
|
-
- `"1fr"`, `"2fr"`
|
|
710
|
-
- `"20"`
|
|
708
|
+
- `"auto"` - shrinks to the widest content in that column
|
|
709
|
+
- `"1fr"`, `"2fr"` - fractional units that divide remaining space proportionally
|
|
710
|
+
- `"20"` - fixed width in characters
|
|
711
711
|
|
|
712
712
|
**Special area tokens:**
|
|
713
|
-
- `.`
|
|
714
|
-
- `---`
|
|
713
|
+
- `.` - empty cell (renders as blank space)
|
|
714
|
+
- `---` - full-width horizontal divider row
|
|
715
715
|
|
|
716
716
|
**Spanning:** repeat the same name in adjacent cells to span columns:
|
|
717
717
|
|
|
@@ -751,7 +751,7 @@ Use `segment.part` to place individual pieces of a segment into separate cells w
|
|
|
751
751
|
| `dir` | `value` |
|
|
752
752
|
| `env` | `prefix`, `value` |
|
|
753
753
|
|
|
754
|
-
Example
|
|
754
|
+
Example, block segment with a progress bar, mirroring the context layout:
|
|
755
755
|
|
|
756
756
|
```json
|
|
757
757
|
"areas": [
|
|
@@ -761,7 +761,7 @@ Example — block segment with a progress bar, mirroring the context layout:
|
|
|
761
761
|
```
|
|
762
762
|
|
|
763
763
|
> [!NOTE]
|
|
764
|
-
> `context.bar`, `block.bar`, and `weekly.bar` are width-aware
|
|
764
|
+
> `context.bar`, `block.bar`, and `weekly.bar` are width-aware. Their progress bars render at exactly the resolved column width. Block bar uses `nativeUtilization` when available, or `cost / budget` for transcript mode. Weekly bar uses the 7-day `used_percentage`.
|
|
765
765
|
|
|
766
766
|
#### Custom Box Characters
|
|
767
767
|
|
|
@@ -780,7 +780,7 @@ Override individual box-drawing characters. Partial overrides merge with the cha
|
|
|
780
780
|
}
|
|
781
781
|
```
|
|
782
782
|
|
|
783
|
-
Only specify the characters you want to change
|
|
783
|
+
Only specify the characters you want to change. The rest inherit from the active charset.
|
|
784
784
|
|
|
785
785
|
#### Title Bar
|
|
786
786
|
|
|
@@ -811,8 +811,8 @@ Same as the title bar, but on the bottom border. Defaults to no text (plain bord
|
|
|
811
811
|
|
|
812
812
|
| Property | Type | Default | Description |
|
|
813
813
|
|---|---|---|---|
|
|
814
|
-
| `left` | `string` |
|
|
815
|
-
| `right` | `string` |
|
|
814
|
+
| `left` | `string` | -- | Left-side footer text (supports tokens) |
|
|
815
|
+
| `right` | `string` | -- | Right-side footer text (supports tokens) |
|
|
816
816
|
|
|
817
817
|
Tokens resolve any segment or subsegment reference: `{model}`, `{dir}`, `{git.head}`, `{block.value}`, `{metrics.lastResponse}`, etc.
|
|
818
818
|
|
|
@@ -840,7 +840,7 @@ The template name (e.g. `metrics.lastResponse`) can then be used as a cell name
|
|
|
840
840
|
|
|
841
841
|
#### Automatic Culling
|
|
842
842
|
|
|
843
|
-
Empty segments are automatically removed
|
|
843
|
+
Empty segments are automatically removed. Cells resolve to `.`, empty rows are dropped, and orphaned dividers are cleaned up. A wide layout gracefully degrades when data is unavailable.
|
|
844
844
|
|
|
845
845
|
> [!NOTE]
|
|
846
846
|
> Claude Code's internal progress indicators (spinner, context bar) may briefly overlap the TUI panel during tool calls. This is a limitation of the hook architecture and resolves once the tool call completes.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@owloops/claude-powerline",
|
|
3
|
-
"version": "1.24.
|
|
3
|
+
"version": "1.24.2",
|
|
4
4
|
"description": "Beautiful vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, and custom themes",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.mjs",
|