dantleech, 7 months ago

ported the chart widget today, tomorrow I'll tackle the list/table widget...

video/mp4

dantleech, 7 months ago

List and Table widgets done, just the BarChart widget to reproduce the original Rust TUI demo, after that going to switch to polishing and documentation... (oops, actually BarChart, Tab, Sparkline and Gauge, but meh... can do them later)

dantleech, 7 months ago

Today I created a crossterm-rs-like terminal abstraction for low-level control

need to spend some time on the API namings and design 😅

dantleech, 7 months ago

so the next interesting part is parsing output from /dev/tty into events, in addition to key input, it should allow mouse support and some other stuff. Will be borrowing heavily from crossterm as there's .... lots of detail.

dantleech, 7 months ago

now ported / reimplemented a useful chunk of the crossterm "event" system, so you can pop events (e.g. sanitised key presses, focus, terminal resize) from a buffer. also it's calling out to stty to do a couple of things like (un)setting "raw" mode and disabling "echo".

also there's a "logo":

dantleech, 7 months ago

making a demo app, could totally make a pong or space invaders game 😅 (and yes there's a bug with the cell styles!)

dantleech, 6 months ago

I'm just about happy with the API now, although some widgets are missing from the ratatui port, and some features are missing from the crossterm port, all the bases are covered.

time to write + generate documentation... thinking a github page, probably Sphinx/RST although tempted to use Hugo 🤔

dantleech, 6 months ago

Docs have started: https://php-tui.github.io/php-tui

• Widget docs are generated from source.
• Code examples execute in CI...
• and I wrote a parser to read the raw ANSI exampe output ...
• and they are painted back to the docs (only using text atm, but can hopefully get colourful HTML working soon)

Still a bunch of work to do, hope I don't get a job this week 😅

kitchen, 6 months ago

@dantleech it would be an understatement to say I don’t love php but I do love me some TUI goodness and it’s been real exciting following this journey ❤️

dantleech, 6 months ago

@kitchen PHP is pretty OK depending on which rock you find it under. Probably not the best choice for a TUI but 🤷 . have enjoyed following your journey too 😄

dantleech, 6 months ago

added support for rendering "sprites" and RGB colors

i think the next step will be rendering bitmap fonts (and porting yet another Rust library) for some 90s nostalgia.

dantleech, 6 months ago

have created the BNF font parser and can render text!

i know how I'm going to make this slide deck...

video/mp4

Pol, 6 months ago

@dantleech
Maaan, excellent !

dantleech, 6 months ago

today I'm going to think about introducing an image widget, taking inspiration from https://github.com/rivo/tview/tree/master

dantleech, 6 months ago

well image magick made this easy:

dantleech, 6 months ago (edited 6 months ago)

terminal photo album?

abmurrow, 6 months ago

@dantleech
Terminal photo album 🤚
Minecraft photo filter 👉

ciaran, 6 months ago

@dantleech witchcraft

nicemicro, 6 months ago

@dantleech someone maxed out pixel art :D

Anachron, 6 months ago

@dantleech

you haven't heard of https://github.com/hzeller/timg yet?

dantleech, 6 months ago

@Anachron interesting!

dantleech, 6 months ago

Having a go at rendering terminal cells in HTML for the docs.

My CSS and HTML skills are a bit rusty, not sure if there is a better way than adding <span style="<blah>" for each char.

But here it is: https://php-tui.github.io/php-tui/docs/reference/shapes/imageshape/

Definite improvement on just having <pre>

MaZderMind, 6 months ago

@dantleech You could use a canvas with scale mode set to pixelated and then either directly access the pixel data or use the pixel setters: https://stackoverflow.com/a/10525163

dantleech, 6 months ago

@MaZderMind that would be better, thanks!

dantleech, 6 months ago

there are some architectural changes I'm thinking of making vs. Ratatui:

1. Ratatui's widgets render themsevles ... which is convenient, but it does mean you probably need global state at some point (caching, or loading fonts for example).

I'm thinking to split the widget data from a widget rendering service which can have fat dependencies - so each widget will (mostly) require 2 classes - the lightweight widget (config and state) and the renderer.

dantleech, 6 months ago

2. Ratatui uses the builder pattern extrensively to mutate the widgets. This is mostly convenient, but also adds complexity, considering dropping the builder pattern and just using navitve constructors... but then you'd still want static constructors and then it all starts to get complicated again.

Pol, 6 months ago

@dantleech
I prefer to use native stuff than a wrong pattern.

dantleech, 6 months ago

@Pol context is this:

new Paragraph(  
 new Text([  
 new Line([  
 new Span(  
 'Hello World',   
 AnsiColor::Green  
 )  
 ])  
 ])  
)  

vs this:

Paragraph::fromString(  
 'Hello World'  
)->color(AnsiColor::Green)  

also torn on mutability here

Pol, 6 months ago

@dantleech Indeed. IMHO, I would use that (using new) internally and eventually propose shortcuts through static functions or another pattern.

dantleech, 6 months ago

Today I've ported mouse support to PHP-Term:

video/mp4

dantleech, 6 months ago

I've switched the HTML rendering to use the Canvas - and the percentage of "code" that is HTML has dropped from 73% to just 35% 😌

ciaran, 6 months ago

@dantleech is that a good or bad thing?

Can I make a plea to consider a11y?

dantleech, 6 months ago

@ciaran better considering each terminal cell was previously a span with a ton of inline styles and a character in it.

as for a11y - the context is rendering examples in the docs:

https://php-tui.github.io/php-tui/docs/reference/shapes/imageshape/

not sure how to make that accessible really, <canvas> is surely better than a ton of spans though...

hoping somebody that actually knows CSS can help out at some point :D

dantleech, 6 months ago

and I've tagged the first version at 0.0.1. Still some big changes to come, but I've got through the first round of issues.

https://packagist.org/packages/php-tui/php-tui

Thanks also to Kenedy Tedesco for contributing lots of small fixes and improvements!

dantleech, 6 months ago

Gauges (or Guages as I seem to want to spell it)

dantleech, 6 months ago

not one of the sexiest widgets, and one of the more tedious to port: the BarChart.

Will have to add legends and axis at some point (which are missing from Ratatui)

wyri, 6 months ago

@dantleech Sweeet!

dantleech, 6 months ago

adding a new "color" type LinearGradient will be available on all widgets!

dantleech, 6 months ago

... and added support for angle and point of origin and ordered "trigonometry for dummies" from Amazon.

dantleech, 6 months ago

thinking it would be a great PoC to add a @phpbench extension which uses PHP-TUI for progress widgets and reports (and include that extension as a dev depdency for PHP-TUIs benchmarks)

dantleech, 6 months ago

... also thanks to @KennedyTedesco PHP-TUI supports a subset of the Symfony Console markup:

Instead of:

Line::fromSpans(Span::fromString('foo')->green(), Span::fromString('bar')->red()->onBlack())  

(which is already an improvement on an even more verbose API)

you can use:

Line::parse('<fg=green>foo</><fg=red bg=black>bar</>');  

dantleech, 6 months ago

round 2 of documentation done: https://php-tui.github.io/php-tui the docs are getting better... (well, some of it got slightly worse, but more steps forward than back)

dantleech, 6 months ago

I've tagged a 0.0.2 of #php TUI - lots of bug fixes, linear gradient and the gauge, image, and barchart widgets, DX improvements for styling, inline and fixed viewports and more and a slightly pimped up README:

https://github.com/php-tui/php-tui/releases/tag/0.0.2

dantleech, 6 months ago (edited 6 months ago)

I've just added multibyte support to php-term, which I think pretty much brings it closer to parity with crossterm in terms of event parsing

dantleech, 5 months ago

Spent (checks watch) today improving the ANSI parsing and making the resulting generated terminal examples better:

still not perfect though (check Colors > Linear Gradient) which is frustrating.

https://php-tui.github.io/php-tui/docs/guides/getting-started/

dantleech, 5 months ago

starting to feel I should "cash in" and finish it off this week.

The whole thing is pretty much there now, I want to split the "term" and BDF parsing libs out, maybe implement a few more widgets.

made good progress with a "text editor" but might put that to one side as it's a large and ill-defined undertaking

dantleech, 5 months ago

I've split out the #php Term library, it provides comprehensize terminal manipulation and querying, based heavily on Rust's crossterm library:

• emits and parses a large number of CSI and OSC escape codes
• mouse capture events
• various keyboard events
• sets raw mode
• terminal size

https://github.com/php-tui/term

dantleech, 5 months ago (edited 5 months ago)

... and with Sparkline and Tab widgets I've ported all the widgets I'm going to port (the only remaining one is the "calendar" widget, but meh).

They could all be improved (and maybe I could port some imporvements back to Ratatui), but basically that's it.

I ported Ratatui.

/endofthread

dantleech, 5 months ago

and with that I've tagged 0.1.0

https://github.com/php-tui/php-tui/releases/tag/0.1.0

thanks to @KennedyTedesco for all the help!

kitchen, 5 months ago

@dantleech I won’t lie and say I love php but I will say it’s been a hell of a lot of fun watching you do this and seeing the awesome results. Fucking great job!

dantleech, 5 months ago

@kitchen thanks!

wyri, 6 months ago

@dantleech are you planning on adding a progress bar?