Data Types • Documentation • urbit.org

Here are the data types used by Dill, as defined in /sys/lull.hoon.

`$blew`

  +$  blew  [p=@ud q=@ud]

Terminal dimension; p is columns, q is rows. This structure is passed to Dill by the runtime in a %blew task whenever the dimensions of the terminal changes.

`$belt`

+$  belt
  $?  bolt
  $%  [%mod mod=?(%ctl %met %hyp) key=bolt]
      [%txt p=(list @c)]
      [%ctl p=@c]
      [%met p=@c]
  ==  ==

Terminal client input.

A $belt is passed to Dill in a %belt task by the runtime whenever there is input, such as a user typing in the console. This is only used between the terminal client and Dill, a $dill-belt is used between Dill and Arvo.

May either be a $bolt or one of:

%mod - Modifier (Ctrl, Meta or Hyper) plus [key].
%txt - A series of characters
%ctl - Ctrl+[key], deprecated in favour of %mod.
%met - Meta+[key], deprecated in favour of %mod.

`$bolt`

+$  bolt
  $@  @c
  $%  [%aro p=?(%d %l %r %u)]
      [%bac ~]
      [%del ~]
      [%hit r=@ud c=@ud]
      [%ret ~]
  ==

Simple input.

Either a single simple character or one of:

%aro - Arrow keys.
%bac - Backspace key.
%del - Delete key.
%hit - Mouse click - r is row and c is column. Note these are zero-indexed, with [0 0] being the bottom left corner.
%ret - Return (Enter) key.

`$blit`

+$  blit
  $%  [%bel ~]
      [%clr ~]
      [%hop p=@ud]
      [%klr p=stub]
      [%lin p=(list @c)]
      [%mor ~]
      [%sag p=path q=*]
      [%sav p=path q=@]
      [%url p=@t]
  ==

Terminal client output.

A $blit is given to the terminal client by Dill in a %blit gift when it wants to print some text, clear the screen, go ding or what have you.

This is only used between Dill and the terminal client, a $dill-blit is used instead between Arvo and Dill.

A $blit is one of:

%bel - Ring the terminal bell.
%clr - Clear the screen.
%hop - Set cursor position, p specifies its position on the prompt line.
%klr - Set styled line, the $stub specifies the text and style.
%lin - Set current line, p contains the text.
%mor - Newline.
%sag - Save to jamfile, typically in /[pier]/.urb/put/. p is /[path]/[filename]/[extension]. For example, /foo/bar will save it in /[pier]/.urb/put/foo.bar, /a/b/c/foo/bar will save it in /[pier]/.urb/put/a/b/c/foo.bar, and /foo will save it in /[pier]/.urb/put.foo. q is the noun to jam and save in the file.
%sav - Save to file. Same behaviour as %sag except q is an atom rather than a noun and therefore doesn't need to be jammed. The atom is written to disk as if it were the bytestring in the tail of an $octs. That is, %saving the cord 'abcdef', whose @ux value is 0x6665.6463.6261, results in a unix file whose hex dump renders as 61 62 63 64 65 66.
%url - Activate URL, p is the URL.

`$dill-belt`

+$  dill-belt
  $%  [%aro p=?(%d %l %r %u)]
      [%bac ~]
      [%cru p=@tas q=(list tank)]
      [%ctl p=@]
      [%del ~]
      [%hey ~]
      [%met p=@]
      [%ret ~]
      [%rez p=@ud q=@ud]
      [%txt p=(list @c)]
      [%yow p=gill:gall]
  ==

Terminal input for Arvo.

While $belt is used between the terminal client and Dill, $dill-belt is used between Dill and Arvo.

a $dill-belt is one of:

%aro - Arrow keys.
%bac - Backspace key.
%cru - Echo error, p is an error @tas and q is a traceback.
%ctl - Ctrl+[key].
%del - Delete key.
%hey - Refresh.
%met - Meta+[key].
%ret - Return key (Enter).
%rez - Terminal resized, p is columns and q is rows.
%txt - Text input.
%yow - Connect to app.

`$dill-blit`

+$  dill-blit
  $%  [%bel ~]
      [%clr ~]
      [%hop p=@ud]
      [%klr p=stub]
      [%mor p=(list dill-blit)]
      [%pom p=stub]
      [%pro p=(list @c)]
      [%qit ~]
      [%out p=(list @c)]
      [%sag p=path q=*]
      [%sav p=path q=@]
      [%url p=@t]
  ==

Terminal output from Arvo.

While $blit is used between Dill and the terminal client, $dill-blit is used between Arvo and Dill.

A $dill-blit is one of:

%bel - Terminal bell.
%clr - Clear screen.
%hop - Set cursor position, p is its horizontal position on the prompt line.
%klr - Styled text, the $stub specifies both the text and style.
%mor - Multiple $dill-blit.
%pom - Styled prompt, the $stub specifies both the text and style.
%pro - Set prompt, p is the text for the prompt.
%qit - Close console.
%out - Print text.
%sag - Save noun to jamfile. See $blit section for further details.
%sav - Save atom to file. See $blit section for further details.
%url - Activate URL.

`$flog`

+$  flog
  $%  [%crop p=@ud]
      [%crud p=@tas q=(list tank)]
      [%heft ~]
      [%meld ~]
      [%pack ~]
      [%text p=tape]
      [%verb ~]
  ==

Wrapped Dill tasks.

These are a subset of Dill's tasks which can be wrapped in a %flog task. See the API Reference document for details of each of these tasks.