neo-blessed/CHANGELOG.md

Blessed v0.1.0 - new terminal goodies for node.js

New useful options for your typewriter application:

• dockBorders option - Element borders will automatically "dock" to each other. Instead of overlapping the borders end up connecting.

• autoPadding default - Auto padding is now enabled by default, meaning blessed will automatically position elements inside their parent's border.

• rleft property - Relative offsets are now default element properties (left instead of rleft).

• draggable property - Make any element draggable with the mouse.

• Table and ListTable elements - Tables with a high quality rendering.

• Log element - A top to bottom logger box with scrollback and other features.

• Obscurable borders - In addition to docking borders, it's possible to obscure borders by sliding them off the screen with negative offsets.

• Percentage expressions - Like CSS, arithmetic can now be performed on percentages. e.g. width: '50%-1'. This is useful for overlapping borders on elements with a percentage width.

• shadow option - Give the element a translucent shadow. Automatically darkens the background behind it.

• transparent option - Lower element opacity to 50%. This will display dimmed elements and content behind the foreground element using a naive color blending function (good enough for a terminal's limited amount of colors). works best with 256color terminals.

Other features that weren't mentioned before:

• setHover option - Set a hover text box to follow cursor on mouseover, similar to how a web browser handles the "title" attribute.

• Terminal element - Spin up a pseudo terminal as a blessed element. useful for writing a terminal multiplexer. (requires term.js and pty.js as optional dependencies).

• Image element - Uses w3mimgdisplay to draw real images your terminal. this is much easier than calling w3mimgdisplay by hand. Image elements behave like any other element, although it is wise to use width: 'shrink', height: 'shrink'.

---

The major things that justified the 0.1.0 release were fixes and stabilization of api (autoPadding/rleft/left). Scrolling boxes were almost completely revamped to work a bit smarter.

---

Things yet to come:

• @secrettriangle's improvements for textareas - This allows for real text navigation.

• Gravity and margin layouts

This is something that's been in the idea bin for a while. Every element could potentially have properties like:

  gravity: 'bottomleft',
  margin: 5,
``

In other words, just a more complex `float` system than what the CSSOM is used
to.