345 lines
13 KiB
Haskell
345 lines
13 KiB
Haskell
{- | Rendering & misc. helpers. -}
|
|
|
|
{-# LANGUAGE CPP #-}
|
|
{-# LANGUAGE OverloadedStrings #-}
|
|
|
|
module Hledger.UI.UIUtils (
|
|
borderDepthStr
|
|
,borderKeysStr
|
|
,borderKeysStr'
|
|
,borderPeriodStr
|
|
,borderQueryStr
|
|
,defaultLayout
|
|
,helpDialog
|
|
,helpHandle
|
|
,minibuffer
|
|
,moveDownEvents
|
|
,moveLeftEvents
|
|
,moveRightEvents
|
|
,moveUpEvents
|
|
,normaliseMovementKeys
|
|
,renderToggle
|
|
,renderToggle1
|
|
,replaceHiddenAccountsNameWith
|
|
,scrollSelectionToMiddle
|
|
,suspend
|
|
,redraw
|
|
)
|
|
where
|
|
|
|
import Brick
|
|
import Brick.Widgets.Border
|
|
import Brick.Widgets.Border.Style
|
|
import Brick.Widgets.Dialog
|
|
import Brick.Widgets.Edit
|
|
import Brick.Widgets.List (List, listSelectedL, listNameL, listItemHeightL)
|
|
import Control.Monad.IO.Class
|
|
import Data.List
|
|
import qualified Data.Text as T
|
|
import Graphics.Vty
|
|
(Event(..),Key(..),Modifier(..),Vty(..),Color,Attr,currentAttr,refresh
|
|
-- ,Output(displayBounds,mkDisplayContext),DisplayContext(..)
|
|
)
|
|
import Lens.Micro.Platform
|
|
|
|
import Hledger hiding (Color)
|
|
import Hledger.Cli (CliOpts)
|
|
import Hledger.Cli.DocFiles
|
|
import Hledger.UI.UITypes
|
|
import Hledger.UI.UIState
|
|
|
|
-- | On posix platforms, send the system STOP signal to suspend the
|
|
-- current program. On windows, does nothing.
|
|
#ifdef mingw32_HOST_OS
|
|
suspendSignal :: IO ()
|
|
suspendSignal = return ()
|
|
#else
|
|
import System.Posix.Signals
|
|
suspendSignal :: IO ()
|
|
suspendSignal = raiseSignal sigSTOP
|
|
#endif
|
|
|
|
-- | On posix platforms, suspend the program using the STOP signal,
|
|
-- like control-z in bash, returning to the original shell prompt,
|
|
-- and when resumed, continue where we left off.
|
|
-- On windows, does nothing.
|
|
suspend :: s -> EventM a (Next s)
|
|
suspend st = suspendAndResume $ suspendSignal >> return st
|
|
|
|
-- | Tell vty to redraw the whole screen, and continue.
|
|
redraw :: s -> EventM a (Next s)
|
|
redraw st = getVtyHandle >>= liftIO . refresh >> continue st
|
|
|
|
-- | Wrap a widget in the default hledger-ui screen layout.
|
|
defaultLayout :: Widget Name -> Widget Name -> Widget Name -> Widget Name
|
|
defaultLayout toplabel bottomlabel =
|
|
topBottomBorderWithLabels (str " "<+>toplabel<+>str " ") (str " "<+>bottomlabel<+>str " ") .
|
|
margin 1 0 Nothing
|
|
-- topBottomBorderWithLabel2 label .
|
|
-- padLeftRight 1 -- XXX should reduce inner widget's width by 2, but doesn't
|
|
-- "the layout adjusts... if you use the core combinators"
|
|
|
|
-- | Draw the help dialog, called when help mode is active.
|
|
helpDialog :: CliOpts -> Widget Name
|
|
helpDialog _copts =
|
|
Widget Fixed Fixed $ do
|
|
c <- getContext
|
|
render $
|
|
withDefAttr "help" $
|
|
renderDialog (dialog (Just "Help (LEFT/ESC/?/q to close help)") Nothing (c^.availWidthL)) $ -- (Just (0,[("ok",())]))
|
|
padTop (Pad 0) $ padLeft (Pad 1) $ padRight (Pad 1) $
|
|
vBox [
|
|
hBox [
|
|
padRight (Pad 1) $
|
|
vBox [
|
|
withAttr ("help" <> "heading") $ str "Navigation"
|
|
,renderKey ("UP/DOWN/PUP/PDN/HOME/END/k/j/C-p/C-n", "")
|
|
,str " move selection up/down"
|
|
,renderKey ("RIGHT/l/C-f", "show txns, or txn detail")
|
|
,renderKey ("LEFT/h/C-b ", "go back")
|
|
,renderKey ("ESC ", "cancel, or reset app state")
|
|
|
|
,str " "
|
|
,withAttr ("help" <> "heading") $ str "Accounts screen"
|
|
,renderKey ("1234567890-+ ", "set/adjust depth limit")
|
|
,renderKey ("t ", "toggle accounts tree/list mode")
|
|
,renderKey ("H ", "toggle historical balance/change")
|
|
,str " "
|
|
,withAttr ("help" <> "heading") $ str "Register screen"
|
|
,renderKey ("t ", "toggle subaccount txns\n(and accounts tree/list mode)")
|
|
,renderKey ("H ", "toggle historical/period total")
|
|
,str " "
|
|
,withAttr ("help" <> "heading") $ str "Help"
|
|
,renderKey ("? ", "toggle this help")
|
|
,renderKey ("p/m/i", "while help is open:\nshow manual in pager/man/info")
|
|
,str " "
|
|
]
|
|
,padLeft (Pad 1) $ padRight (Pad 0) $
|
|
vBox [
|
|
withAttr ("help" <> "heading") $ str "Filtering"
|
|
,renderKey ("/ ", "set a filter query")
|
|
,renderKey ("F ", "show future & periodic txns")
|
|
,renderKey ("R ", "show real/all postings")
|
|
,renderKey ("Z ", "show nonzero/all amounts")
|
|
,renderKey ("U/P/C ", "show unmarked/pending/cleared")
|
|
,renderKey ("S-DOWN /S-UP ", "shrink/grow period")
|
|
,renderKey ("S-RIGHT/S-LEFT", "next/previous period")
|
|
,renderKey ("T ", "set period to today")
|
|
,renderKey ("DEL ", "reset filters")
|
|
,str " "
|
|
,withAttr ("help" <> "heading") $ str "Other"
|
|
,renderKey ("a ", "add transaction (hledger add)")
|
|
,renderKey ("A ", "add transaction (hledger-iadd)")
|
|
,renderKey ("B ", "show amounts/costs")
|
|
,renderKey ("E ", "open editor")
|
|
,renderKey ("I ", "toggle balance assertions")
|
|
,renderKey ("V ", "show amounts/market values")
|
|
,renderKey ("g ", "reload data")
|
|
,renderKey ("C-l ", "redraw & recenter")
|
|
,renderKey ("C-z ", "suspend")
|
|
,renderKey ("q ", "quit")
|
|
]
|
|
]
|
|
-- ,vBox [
|
|
-- str " "
|
|
-- ,hCenter $ padLeftRight 1 $
|
|
-- hCenter (str "MANUAL")
|
|
-- <=>
|
|
-- hCenter (hBox [
|
|
-- renderKey ("t", "text")
|
|
-- ,str " "
|
|
-- ,renderKey ("m", "man page")
|
|
-- ,str " "
|
|
-- ,renderKey ("i", "info")
|
|
-- ])
|
|
-- ]
|
|
]
|
|
where
|
|
renderKey (key,desc) = withAttr ("help" <> "key") (str key) <+> str " " <+> str desc
|
|
|
|
-- | Event handler used when help mode is active.
|
|
-- May invoke $PAGER, less, man or info, which is likely to fail on MS Windows, TODO.
|
|
helpHandle :: UIState -> BrickEvent Name AppEvent -> EventM Name (Next UIState)
|
|
helpHandle ui ev = do
|
|
case ev of
|
|
VtyEvent e | e `elem` closeHelpEvents -> continue $ setMode Normal ui
|
|
VtyEvent (EvKey (KChar 'p') []) -> suspendAndResume $ runPagerForTopic "hledger-ui" Nothing >> return ui'
|
|
VtyEvent (EvKey (KChar 'm') []) -> suspendAndResume $ runManForTopic "hledger-ui" Nothing >> return ui'
|
|
VtyEvent (EvKey (KChar 'i') []) -> suspendAndResume $ runInfoForTopic "hledger-ui" Nothing >> return ui'
|
|
_ -> continue ui
|
|
where
|
|
ui' = setMode Normal ui
|
|
closeHelpEvents = moveLeftEvents ++ [EvKey KEsc [], EvKey (KChar '?') [], EvKey (KChar 'q') []]
|
|
|
|
-- | Draw the minibuffer.
|
|
minibuffer :: Editor String Name -> Widget Name
|
|
minibuffer ed =
|
|
forceAttr ("border" <> "minibuffer") $
|
|
hBox [txt "filter: ", renderEditor (str . unlines) True ed]
|
|
|
|
borderQueryStr :: String -> Widget Name
|
|
borderQueryStr "" = str ""
|
|
borderQueryStr qry = str " matching " <+> withAttr ("border" <> "query") (str qry)
|
|
|
|
borderDepthStr :: Maybe Int -> Widget Name
|
|
borderDepthStr Nothing = str ""
|
|
borderDepthStr (Just d) = str " to depth " <+> withAttr ("border" <> "query") (str $ show d)
|
|
|
|
borderPeriodStr :: String -> Period -> Widget Name
|
|
borderPeriodStr _ PeriodAll = str ""
|
|
borderPeriodStr preposition p = str (" "++preposition++" ") <+> withAttr ("border" <> "query") (str . T.unpack $ showPeriod p)
|
|
|
|
borderKeysStr :: [(String,String)] -> Widget Name
|
|
borderKeysStr = borderKeysStr' . map (\(a,b) -> (a, str b))
|
|
|
|
borderKeysStr' :: [(String,Widget Name)] -> Widget Name
|
|
borderKeysStr' keydescs =
|
|
hBox $
|
|
intersperse sep $
|
|
[withAttr ("border" <> "key") (str keys) <+> str ":" <+> desc | (keys, desc) <- keydescs]
|
|
where
|
|
-- sep = str " | "
|
|
sep = str " "
|
|
|
|
-- | Show both states of a toggle ("aaa/bbb"), highlighting the active one.
|
|
renderToggle :: Bool -> String -> String -> Widget Name
|
|
renderToggle isright l r =
|
|
let bold = withAttr ("border" <> "selected") in
|
|
if isright
|
|
then str (l++"/") <+> bold (str r)
|
|
else bold (str l) <+> str ("/"++r)
|
|
|
|
-- | Show a toggle's label, highlighted (bold) when the toggle is active.
|
|
renderToggle1 :: Bool -> String -> Widget Name
|
|
renderToggle1 isactive l =
|
|
let bold = withAttr ("border" <> "selected") in
|
|
if isactive
|
|
then bold (str l)
|
|
else str l
|
|
|
|
-- temporary shenanigans:
|
|
|
|
-- | Convert the special account name "*" (from balance report with depth limit 0) to something clearer.
|
|
replaceHiddenAccountsNameWith :: AccountName -> AccountName -> AccountName
|
|
replaceHiddenAccountsNameWith anew a | a == hiddenAccountsName = anew
|
|
| a == "*" = anew
|
|
| otherwise = a
|
|
|
|
hiddenAccountsName = "..." -- for now
|
|
|
|
-- generic
|
|
|
|
--topBottomBorderWithLabel :: Widget Name -> Widget Name -> Widget Name
|
|
--topBottomBorderWithLabel label = \wrapped ->
|
|
-- Widget Greedy Greedy $ do
|
|
-- c <- getContext
|
|
-- let (_w,h) = (c^.availWidthL, c^.availHeightL)
|
|
-- h' = h - 2
|
|
-- wrapped' = vLimit (h') wrapped
|
|
-- debugmsg =
|
|
-- ""
|
|
-- -- " debug: "++show (_w,h')
|
|
-- render $
|
|
-- hBorderWithLabel (label <+> str debugmsg)
|
|
-- <=>
|
|
-- wrapped'
|
|
-- <=>
|
|
-- hBorder
|
|
|
|
topBottomBorderWithLabels :: Widget Name -> Widget Name -> Widget Name -> Widget Name
|
|
topBottomBorderWithLabels toplabel bottomlabel body =
|
|
Widget Greedy Greedy $ do
|
|
c <- getContext
|
|
let (_w,h) = (c^.availWidthL, c^.availHeightL)
|
|
h' = h - 2
|
|
body' = vLimit (h') body
|
|
debugmsg =
|
|
""
|
|
-- " debug: "++show (_w,h')
|
|
render $
|
|
hBorderWithLabel (withAttr "border" $ toplabel <+> str debugmsg)
|
|
<=>
|
|
body'
|
|
<=>
|
|
hBorderWithLabel (withAttr "border" bottomlabel)
|
|
|
|
---- XXX should be equivalent to the above, but isn't (page down goes offscreen)
|
|
--_topBottomBorderWithLabel2 :: Widget Name -> Widget Name -> Widget Name
|
|
--_topBottomBorderWithLabel2 label = \wrapped ->
|
|
-- let debugmsg = ""
|
|
-- in hBorderWithLabel (label <+> str debugmsg)
|
|
-- <=>
|
|
-- wrapped
|
|
-- <=>
|
|
-- hBorder
|
|
|
|
-- XXX superseded by pad, in theory
|
|
-- | Wrap a widget in a margin with the given horizontal and vertical
|
|
-- thickness, using the current background colour or the specified
|
|
-- colour.
|
|
-- XXX May disrupt border style of inner widgets.
|
|
-- XXX Should reduce the available size visible to inner widget, but doesn't seem to (cf rsDraw2).
|
|
margin :: Int -> Int -> Maybe Color -> Widget Name -> Widget Name
|
|
margin h v mcolour = \w ->
|
|
Widget Greedy Greedy $ do
|
|
c <- getContext
|
|
let w' = vLimit (c^.availHeightL - v*2) $ hLimit (c^.availWidthL - h*2) w
|
|
attr = maybe currentAttr (\c -> c `on` c) mcolour
|
|
render $
|
|
withBorderAttr attr $
|
|
withBorderStyle (borderStyleFromChar ' ') $
|
|
applyN v (hBorder <=>) $
|
|
applyN h (vBorder <+>) $
|
|
applyN v (<=> hBorder) $
|
|
applyN h (<+> vBorder) $
|
|
w'
|
|
|
|
-- withBorderAttr attr .
|
|
-- withBorderStyle (borderStyleFromChar ' ') .
|
|
-- applyN n border
|
|
|
|
withBorderAttr :: Attr -> Widget Name -> Widget Name
|
|
withBorderAttr attr = updateAttrMap (applyAttrMappings [("border", attr)])
|
|
|
|
---- | Like brick's continue, but first run some action to modify brick's state.
|
|
---- This action does not affect the app state, but might eg adjust a widget's scroll position.
|
|
--continueWith :: EventM n () -> ui -> EventM n (Next ui)
|
|
--continueWith brickaction ui = brickaction >> continue ui
|
|
|
|
---- | Scroll a list's viewport so that the selected item is at the top
|
|
---- of the display area.
|
|
--scrollToTop :: List Name e -> EventM Name ()
|
|
--scrollToTop list = do
|
|
-- let vpname = list^.listNameL
|
|
-- setTop (viewportScroll vpname) 0
|
|
|
|
-- | Scroll a list's viewport so that the selected item is centered in the
|
|
-- middle of the display area.
|
|
scrollSelectionToMiddle :: List Name e -> EventM Name ()
|
|
scrollSelectionToMiddle list = do
|
|
let mselectedrow = list^.listSelectedL
|
|
vpname = list^.listNameL
|
|
mvp <- lookupViewport vpname
|
|
case (mselectedrow, mvp) of
|
|
(Just selectedrow, Just vp) -> do
|
|
let
|
|
itemheight = dbg4 "itemheight" $ list^.listItemHeightL
|
|
vpheight = dbg4 "vpheight" $ vp^.vpSize._2
|
|
itemsperpage = dbg4 "itemsperpage" $ vpheight `div` itemheight
|
|
toprow = dbg4 "toprow" $ max 0 (selectedrow - (itemsperpage `div` 2)) -- assuming ViewportScroll's row offset is measured in list items not screen rows
|
|
setTop (viewportScroll vpname) toprow
|
|
_ -> return ()
|
|
|
|
-- arrow keys vi keys emacs keys
|
|
moveUpEvents = [EvKey KUp [] , EvKey (KChar 'k') [], EvKey (KChar 'p') [MCtrl]]
|
|
moveDownEvents = [EvKey KDown [] , EvKey (KChar 'j') [], EvKey (KChar 'n') [MCtrl]]
|
|
moveLeftEvents = [EvKey KLeft [] , EvKey (KChar 'h') [], EvKey (KChar 'b') [MCtrl]]
|
|
moveRightEvents = [EvKey KRight [], EvKey (KChar 'l') [], EvKey (KChar 'f') [MCtrl]]
|
|
|
|
normaliseMovementKeys ev
|
|
| ev `elem` moveUpEvents = EvKey KUp []
|
|
| ev `elem` moveDownEvents = EvKey KDown []
|
|
| ev `elem` moveLeftEvents = EvKey KLeft []
|
|
| ev `elem` moveRightEvents = EvKey KRight []
|
|
| otherwise = ev
|