()),
+ );
+ });
+}
diff --git a/billsplit/test/fixtures/sample_receipt.json b/billsplit/test/fixtures/sample_receipt.json
new file mode 100644
index 00000000..21a99112
--- /dev/null
+++ b/billsplit/test/fixtures/sample_receipt.json
@@ -0,0 +1,779 @@
+{
+ "protoVersion": "000",
+ "IDZ": "c=068b8822a7d1459697c518bacdc26abf|g={b6b16726-f935-4e67-b756-bca881c12124}|s=5834|p=1|t=4320",
+ "deviceType": 2,
+ "printed": false,
+ "data": "eyJhbGciOiJSUzI1NiIsIng1YyI6WyJNSUlGUVRDQ0F5bWdBd0lCQWdJRERxR0dNQTBHQ1NxR1NJYjNEUUVCQ3dVQU1JR2JNUXN3Q1FZRFZRUUdFd0pRVERFVU1CSUdBMVVFQ0F3TFRXRjZiM2RwWldOcmFXVXhFVEFQQmdOVkJBY01DRmRoY25ONllYZGhNU1F3SWdZRFZRUUxEQnREWlc1MGNuVnRJRU5sY25SNVptbHJZV05xYVNCbExVdGhjM2t4R3pBWkJnTlZCQW9NRWxCdmMyNWxkQ0JRYjJ4emEyRWdVeTVCTGpFZ01CNEdBMVVFQXd3WFVFOVRUa1ZVSUdVdFMyRnplU0JTYjI5MElFTkJJREV3SWhnUE1qQXlNekV4TWprd05qRXlNakZhR0E4eU1ETXpNVEV5T0RBMk1USXlNVm93T3pFTE1Ba0dBMVVFQmhNQ1VFd3hGakFVQmdOVkJBTVREVVZCV2pJeU1ESXhOakF4T1RZeEZEQVNCZ05WQkFvVEMxQnZjMjVsZENCVExrRXVNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQXQrSUxlZlJWNjhqcFdDa2RveitZZWprRnU1dkh3N01vYjgxSFIyQnhqUVp6eENhN2drMjExTEs5T1J6Y2ZIcW1YeU5aV3c3U0tpcUp1U0ZhM1Z5R29CaDFFMmF6VWxvcU5Db3g0TFNaM0FwQ3U1d0NIOVFaaS94YW5nQ2pReUtybG44bFFZaWtkNENTYTJyYlQycWVUZytRckJEdHBreVpmc3hQTWF6aFFuek9MNTRWMlZqQ2ZWUzFTajRNQ3lHeHVwQnl5RFY3UzlaKzRPOEdqZ0JYL3RSa1pxRW1SQmpELy83N2o4cjJWTkIyTHlPUXM3alN6RE1zbFo0VUFFN1lzMm1WNHhnZmtLYlh5TUhQK013VjFoZGpMMDJzR3E4ckFUK25aWXFtdURQNGJZKzJiWG5LNzZWQk1uT0pLVEQ0M0NQamhEVXErYjJsd2k4RUZmSlNxUUlEQVFBQm80SG9NSUhsTUF3R0ExVWRFd0VCL3dRQ01BQXdIUVlEVlIwT0JCWUVGQkRiZUErelZVTCtQYnBXam5sVFNlcmlrN0FkTUI4R0ExVWRJd1FZTUJhQUZFNElhYlJWR0FHTFJkSGlwZVNaeldHQmo0MUpNQTRHQTFVZER3RUIvd1FFQXdJRjREQTFCZ05WSFI4RUxqQXNNQ3FnS0tBbWhpUm9kSFJ3T2k4dlpXc3VjRzl6Ym1WMExtTnZiUzV3YkM5amNtd3ZjbU5oTVM1amNtd3dUZ1lEVlIwZ0JFY3dSVEJEQmdzckJnRUVBWU9mYmdFQkFUQTBNRElHQ0NzR0FRVUZCd0lCRmlab2RIUndjem92TDJWckxuQnZjMjVsZEM1amIyMHVjR3d2WTNCekwzSmpZVEV1YUhSdGJEQU5CZ2txaGtpRzl3MEJBUXNGQUFPQ0FnRUFrUk5nNEhuMXUrM2tzeEZ2SmFTMHplYnBqQ3pVb2hyYldTZ3dHaGZWTUk1ZnJaZG5Id0V0SytPL1FuT2FIZXdzblZ0am5Samx0NWIrWHA3bFZNVFdMYnpYNjRVTUZQZkhzVER1OER6Zml6NVZjRUJ0MkNnSTlacFVSNHgyR0VJTDlSQmJzTzRqanFZajh1YnA3OWdsckgxMjF6Y3BhNmhSYkpZOHFReHNSTnkxZkNTL3ppazlQTTFla214eWc5b3pxOUJ4WmxKMnREZW12Y0pxbUhMaWNTUCsxWkRZWGR2SnJiNVJHMmFWL2JLeFJmTm15NGZxUVRNSFlucC94K2FBRlByTFdjV3lDbUMya1FodnNFYVJ1cWZDdlJ0TEtsT0t0UC9zdzRxQzlXbVdzbG8zeXl4YW9WRkRsYk5NZ3lWWWpicmtWZ0U1SXBPRWJpUG1GZTY4cUNKMk5KL0tsNFNWUGJiN2RSWXJyeHdYYVAzN2VUSXJKQ3NwbUMrWC9oNzQ3ak5mYTQxeXd3OCsrb1BMblNpby9PcFpNT0IzZmtBaWdjODlnNEtRalJLNDFsOGRJQnYvRmpMZm9XM3JidW5YQTM4R0VKT1ZhY1ZYM3ZQcUNoWExVYTN3dHBQTWRWbm9NbkFRMUJCOEU4RUs1YUtrK0tyQ1NzVnVPdmE0dTlsbURPdXFaMGt1Snd1M2RhM0c2TUpzSm90cloyTWNpMTV0S215UkU1VVViYlhBcXN6a2hXZTZ2bUdMa0ZTemliemZ2TXZmQ0xoMkxvQTBDakNCMGJLVHFydUdsSUpGZ0NhNFpKTDRnTHBiV2d0K2lMZDg3UEZwdGtBMUVHSldHSXNSVFBzVnhLNFQvWE5MME5td3hzTHdPTHhXZ2JxK1hjNDlZNUhYb0MzNDRSND0iXSwianBrbWV0YWRhdGEiOiJleUpqYjNKeVpXeGhkR2x2Ymtsa0lqb2lWRVpFTGtWQldqSXlNREl4TmpBeE9UWXVNakF5TkMwd05pMHdOVlF3T0RveE1Eb3dNQzQyTkRGYUluMCIsImVQYXJhZ29uLm1mLmdvdi5wbCI6ImV5SjNaWEp6YW1FaU9pSktVRXRmUzBGVFFWOVFRVkpCUjA5T1gzWXlMVEFpTENKS1VFdEpSQ0k2SWpBd01UQXdNREF3TURBd01EWXhNREl4TXlJc0ltUmhkR0ZLVUVzaU9pSXlNREkyTFRBM0xUTXdWREUzT2pJeE9qRTVMakF3TUZvaUxDSktVRXRTUlVZaU9uc2lTbEJMU1VRaU9pSXdNREV3TURBd01EQXdNREEyTVRBeU1URWlMQ0pUU0VFeU5UWWlPaUl6TXpVNVFrRkVRa0kzTURSRE5UZzBNVVk1T1RBd01ERkdOREE1T1VGRVJUSkZSVVF6TUVFME4wRkZSa1JDT1RNd05rVTFRVUZEUlRoRk0wVTJOak00SW4xOSJ9.eyJkb2t1bWVudCI6eyJuYWdsb3dlayI6eyJ3ZXJzamEiOiJKUEtfS0FTQV9QQVJBR09OX3YyLTAiLCJkYXRhSlBLIjoiMjAyNi0wNy0zMFQxNzoyMToxOS4wMDBaIn0sInBvZG1pb3QxIjp7Ik5JUCI6Ijc3OTEwMTEzMjciLCJuYXp3YVBvZCI6IkpFUk9OSU1PIE1BUlRJTlMgUE9MU0tBIFMuQS4iLCJhZHJlc1BvZCI6eyJrb2RQb2N6dCI6IjM0LTMyNSIsIm1pZWpzYyI6IsWBT0RZR09XSUNFIiwidWxpY2EiOiJCRVNLSURaS0EgOCJ9LCJuclVuaWsiOiJFQVoyMjAyMTYwMTk2IiwibnJGYWJyIjoiUE8xMTQwNTQzOTEiLCJuckV3aWQiOiIyMDI0LzAwMDA5MjEyNiJ9LCJwYXJhZ29uIjp7IkpQS0lEIjo2MTAyMTMsInBhbWllY0NociI6MSwibnJEb2siOjYwODgyNywicG96eWNqYSI6W3sidG93YXIiOnsiYnJ1dHRvIjo1NDksImNlbmEiOjU0OSwiaWRTdFBUVSI6IkEiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IlRvbmljICAgICAgICAgICAgICAgICAgICBBIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NTQ5LCJjZW5hIjo1NDksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJDaXRydXMgbWl4ICAgICAgICAgICAgICAgQSIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjE3OTgsImNlbmEiOjg5OSwiaWRTdFBUVSI6IkEiLCJpbG9zYyI6IjIiLCJuYXp3YSI6Ik5hcEdhekNvY2FDb01JWDIsNWwgICAgICBBIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTc5OCwiY2VuYSI6ODk5LCJpZFN0UFRVIjoiQSIsImlsb3NjIjoiMiIsIm5hendhIjoiTmFwR2F6Q29jYUNvTUlYMiw1bCAgICAgIEEiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjo0NDksImNlbmEiOjQ0OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6Ik9zaGVlVml0YW1NYWduZXoxLDFsICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NzE0LCJjZW5hIjoxMTksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiI2IiwibmF6d2EiOiJQb2xhcmlzIE5HYXogIDEsNWwgICAgICAgQSIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjE1OTYsImNlbmEiOjM5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjQiLCJuYXp3YSI6IlRvc3QgTWHFm2xhbnkgNTAwZyAgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjc5OTgsImNlbmEiOjUzOTksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiIyIiwibmF6d2EiOiJXw7Nka2FCIEJvY2lhbiAwLDdsICAgICAgIEEiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMjgwMH19fSx7InRvd2FyIjp7ImJydXR0byI6OTk5LCJjZW5hIjo5OTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJPbGVqUnplcFpPbGl3V3liMWwgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjY0OSwiY2VuYSI6NjQ5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiR3Jhbm9sYU1sZWN6Q3plazM1MGcgICAgIEMiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjozOTksImNlbmEiOjM5OSwiaWRTdFBUVSI6IkEiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IlBvZHBhxYJOYXR1cjY0S29zdGtpICAgICAgQSIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjk5OSwiY2VuYSI6OTk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiR3Jhbm9sYUZpdE5lc09hdDMwMGcgICAgIEMiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjo5OTksImNlbmEiOjk5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IkdyYW5vbGFGaXROZXNRdWkzMDBnICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6Nzk4LCJjZW5hIjozOTksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiIyIiwibmF6d2EiOiJETyBNT0pFSiBJRMSYICAgICAgICAgICAgIEEiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjoyMTY5LCJjZW5hIjozMjkwLCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMCw4NzEiLCJuYXp3YSI6IktpZcWCYkJyb2NrYVNva2_FgmtnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotNjk3fX19LHsidG93YXIiOnsiYnJ1dHRvIjoyMDcyLCJjZW5hIjozMjkwLCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMCw4MzIiLCJuYXp3YSI6IktpZcWCYkJyb2NrYVNva2_FgmtnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotNjY1fX19LHsidG93YXIiOnsiYnJ1dHRvIjozNzQ1LCJjZW5hIjo3NDksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiI1IiwibmF6d2EiOiJHdWFuY2lhbGVDdWJHQjE1MGcgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjExMzcsImNlbmEiOjM3OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjMiLCJuYXp3YSI6IkJhZ2lldGthIDE3NWcgICAgICAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NTk5LCJjZW5hIjo1OTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJNYXNsb0Vrc3RyYTIwMGcgICAgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjc0OSwiY2VuYSI6NzQ5LCJpZFN0UFRVIjoiQSIsImlsb3NjIjoiMSIsIm5hendhIjoiTmFwR2F6S2lubGV5TWl4MWwgICAgICAgIEEiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjo0OTksImNlbmEiOjQ5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IkNlYnVsYSAxa2cgb3BhayAgICAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NzM4LCJjZW5hIjozNjksImlkU3RQVFUiOiJCIiwiaWxvc2MiOiIyIiwibmF6d2EiOiJNdXN6U2FyS2FtMTg1ZyAgICAgICAgICAgQiIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjI5OSwiY2VuYSI6Mjk5LCJpZFN0UFRVIjoiQiIsImlsb3NjIjoiMSIsIm5hendhIjoiRElQIE9SSUVOVEFMTlkgQ1pPU04gICAgIEIiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjoyOTksImNlbmEiOjI5OSwiaWRTdFBUVSI6IkIiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IlByenlwRG9Tb0FtZXJLYW1pMjBnICAgICBCIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTI5OSwiY2VuYSI6MTI5OSwiaWRTdFBUVSI6IkIiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IktldFBpa2FudG55UHVkIDk5MCBnICAgICBCIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTA5OSwiY2VuYSI6MTA5OSwiaWRTdFBUVSI6IkIiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IlNvc0N6b3NNYWRYWEw4NjBnICAgICAgICBCIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTI5LCJjZW5hIjoxMjksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJaYXBhbG5pY3prU29sZWJvMXN6dCAgICAgQSIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjg0OSwiY2VuYSI6ODQ5LCJpZFN0UFRVIjoiQSIsImlsb3NjIjoiMSIsIm5hendhIjoiUsSZY3puaWsgUXVlZW4gMiA0ICAgICAgICBBIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6Mjc5OCwiY2VuYSI6MTM5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjIiLCJuYXp3YSI6IkphamEgVyBXeWIgTCAxMHN6dCAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTI5NywiY2VuYSI6MjE5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjAsOTI3IiwibmF6d2EiOiJNacSZc1pub2dpS3UgYiBrIGtnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotNzQxfX19LHsidG93YXIiOnsiYnJ1dHRvIjoyOTg5LCJjZW5hIjoyOTg5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiU2VyIEdvdWRhIMWad2lhdDFrZyAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NTQ5LCJjZW5hIjo1NDksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJNaXhTYcWCYXRSb3N6cG9WZjE1MGcgICAgIEMiLCJvcGVyIjpmYWxzZX19LHsidG93YXIiOnsiYnJ1dHRvIjozOTgsImNlbmEiOjE5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjIiLCJuYXp3YSI6IkxpbW9ua2Egc3p0ICAgICAgICAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6NTk5LCJjZW5hIjo1OTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJDeXRyeW5hIDUwMCBnICAgICAgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjEyOTksImNlbmEiOjEyOTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJQb21pZG9yUGFwcnljejUwMGcgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjU5OCwiY2VuYSI6Njk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMCw4NTYiLCJuYXp3YSI6IkJhbmFuIEx1eiAgICAgICAgICAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MzQwLCJjZW5hIjo4OTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIwLDM3OCIsIm5hendhIjoiT2fDs3Jla1N6a0x1eiAgICAgICAgICAgICBDIiwib3BlciI6ZmFsc2V9fSx7InRvd2FyIjp7ImJydXR0byI6MTQ5OCwiY2VuYSI6MTQ5OCwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IkJvcsOzd2thQW1lcnlrIDMwMGcgICAgICAgQyIsIm9wZXIiOmZhbHNlfX0seyJ0b3dhciI6eyJicnV0dG8iOjU1NiwiY2VuYSI6Nzk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiQ2hpcHN5Q3IxMzAtMTQwZyAgICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMjQzfX19LHsidG93YXIiOnsiYnJ1dHRvIjozNDUsImNlbmEiOjQ5NSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IkNoaXBzeVRvcEZyb21hZ2UxNTBnICAgICBDIiwib3BlciI6ZmFsc2UsInJhYmF0Ijp7Im9waXMiOiIxIiwid2FydCI6LTE1MH19fSx7InRvd2FyIjp7ImJydXR0byI6NjA1LCJjZW5hIjo4NjksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIxIiwibmF6d2EiOiJDaGlwc3lMYXkgczEyMGcgICAgICAgICAgQyIsIm9wZXIiOmZhbHNlLCJyYWJhdCI6eyJvcGlzIjoiMSIsIndhcnQiOi0yNjR9fX0seyJ0b3dhciI6eyJicnV0dG8iOjU1NywiY2VuYSI6Nzk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiQ2hpcHN5Q3J1bjEzMC0xNDBnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMjQyfX19LHsidG93YXIiOnsiYnJ1dHRvIjozNDcsImNlbmEiOjQ5OSwiaWRTdFBUVSI6IkMiLCJpbG9zYyI6IjEiLCJuYXp3YSI6IlByYcW8eW5raU5pZXRLZXQxMDBnICAgICAgQyIsIm9wZXIiOmZhbHNlLCJyYWJhdCI6eyJvcGlzIjoiMSIsIndhcnQiOi0xNTJ9fX0seyJ0b3dhciI6eyJicnV0dG8iOjU1NiwiY2VuYSI6Nzk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiQ2hpcHlDcnVuMTMwLTE0MGcgICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMjQzfX19LHsidG93YXIiOnsiYnJ1dHRvIjoxMzk5LCJjZW5hIjoxNjk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiUGl6emFLdXJQaWVjejYwMGcgICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMzAwfX19LHsidG93YXIiOnsiYnJ1dHRvIjoxMzk5LCJjZW5hIjoxNjk5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMSIsIm5hendhIjoiUGl6Um9kelN6eW5TZXI2MDBnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMzAwfX19LHsidG93YXIiOnsiYnJ1dHRvIjoxMzk4LCJjZW5hIjo2OTksImlkU3RQVFUiOiJDIiwiaWxvc2MiOiIzIiwibmF6d2EiOiJTenlua2FLb25zZXJ3b0tXMjAwICAgICAgQyIsIm9wZXIiOmZhbHNlLCJyYWJhdCI6eyJvcGlzIjoiMSIsIndhcnQiOi02OTl9fX0seyJ0b3dhciI6eyJicnV0dG8iOjY3OCwiY2VuYSI6MzM5LCJpZFN0UFRVIjoiQyIsImlsb3NjIjoiMyIsIm5hendhIjoiTWFrYXJvblBlbm5lUGE1MDBnICAgICAgIEMiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMzM5fX19LHsidG93YXIiOnsiYnJ1dHRvIjoyODc0LCJjZW5hIjo0NzksImlkU3RQVFUiOiJBIiwiaWxvc2MiOiIxMiIsIm5hendhIjoiUElXTyBIRUlORUtFTiAwLDVCICAgICAgIEEiLCJvcGVyIjpmYWxzZSwicmFiYXQiOnsib3BpcyI6IjEiLCJ3YXJ0IjotMjg3NH19fV0sInN0UFRVIjpbeyJpZCI6IkEiLCJ3YXJ0IjoyMzAwfSx7ImlkIjoiQiIsIndhcnQiOjgwMH0seyJpZCI6IkMiLCJ3YXJ0Ijo1MDB9LHsiaWQiOiJEIiwid2FydCI6MH0seyJpZCI6IkUiLCJ3YXJ0IjoiWlcifSx7ImlkIjoiRiIsIndhcnQiOjE3MDB9LHsiaWQiOiJHIiwid2FydCI6MH1dLCJwb2RzdW0iOnsid2FsdXRhIjoiUExOIiwic3VtYUJydXR0byI6NTkwNTUsInN1bWFQb2QiOjU1ODgsInN1bWFPcHVzdCI6LTEwNzA5LCJzdW1hTmV0dG8iOlt7ImlkU3RQVFUiOiJBIiwiYnJ1dHRvIjoxOTIwNCwidmF0IjozNTkxfSx7ImlkU3RQVFUiOiJCIiwiYnJ1dHRvIjozNzM0LCJ2YXQiOjI3N30seyJpZFN0UFRVIjoiQyIsImJydXR0byI6MzYxMTcsInZhdCI6MTcyMH1dfSwidG90YWwiOnsiemFwbFp3cm90Ijo1OTc1NX0sIm9wYWsiOnsiZGFuZU9wYWsiOlt7ImNlbmEiOjUwLCJpbG9zYyI6MTQwMDAsIm5hendhIjoiQnV0IFBsYXN0aWsga2F1Y2phIn1dLCJ3YXJ0Ijo3MDB9LCJwbGF0bm9zYyI6W3sicmVzenRhIjpmYWxzZSwiZm9ybWEiOiIyIiwid2FydCI6NTk3NTUsIm5hendhIjoiVklTQSBDQVJEIDA3IDEifV0sInpha1NwcnplZCI6IjIwMjYtMDctMzBUMTc6MjE6MTkuMDAwWiIsIm5yS2FzeSI6Ikthc2EgMSIsImthc2plciI6Ikthc2plciBuciAyNyIsIm5yUGFyYWciOjQxOSwiZ3JhZmlrYSI6MX19fQ.mISQbxs3V0GxEIPLaUviW3n2bgAewkMHOV3dmMo64RFMBXPQin3nMg5BUtX_irNEAjaKqpfHJTXy9sxDncqgo1KbynblPschfOeZWuJmY4wyBHjLkdEJYcqAATGBorl4Awo2kTAoSK0_fiRD6EkOk5ooMS5CiSDueV2t-AJW4POmuhq_KNX7TXyxqGDvKcrFHe2hPoGx4cmayC59ymDJKWcSOyStFkUWm_hpui2IObLmXgPxCj8KjTVtWA6_Qsq8JDLuAcAyCzWvi23AFbCelDUo846IUVe9m-DSUCgiuDDCMLmYCBnul0Q049tY5kMc2IhOOCl5F_Qy9SHTi_k4SQ",
+ "header": [
+ {
+ "image": {
+ "id": "EAZ2202160196-1-445785",
+ "hash": "DmwwvSQRHLaIxnrFwFSH2ZMvlLZHRrslUP5n/gwzXpU=",
+ "data": "Qk02FwAAAAAAAD4AAAAoAAAAMAEAAJMAAAABAAEAAAAAAPgWAAAjLgAAIy4AAAAAAAAAAAAAAAAAAP///wD//////////////////////////////////////////////////wAA//////////////////////////////////////////////////8AAP//////////////////////////////////////////////////AAD//////////////////////////////////////////////////wAA//////////////////////////////////////////////////8AAP//////////////////////////////////////////////////AAD//////////////////////////////////////////////////wAA//////////////////////////////////////////////////8AAP//////////////////////////////////////////////////AAD//////////////////////////////////////////////////wAA//////wAAf////////////////////////////////////////8AAP/////AAAAf////////////////////////////////////////AAD////+AAAAA////////////////////////////////////////wAA////+ABVVAD///////////////////////////////////////8AAP///+AAAAAAD///////////////////////////////////////AAD///+AVaqqqAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf/////wAA////AAAAAAAFVVVVVVVaqqqqqqqqqqqqVVVVVVVVVVVVQD////8AAP///wqqVVVVQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH////AAD///8AAAAAAAAqqqqqqqVVVVVVVVVVVVWqqqqqqqqqqqqlUf///wAA////FVJUqqqoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB///8AAP///wAFqgAAABVVVVVVWqqqqqqqqqqqqlVVVVVVVVVVVVqqn///AAD//x8KqlVAFVUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf//wAA//4fFVWqAAAAA////////////////////////////////VVX//8AAP/8HwqqVAACqoFVVVVVWqqqqqqqqqqqqlVVVVVVVVVVVVqAAP//AAD//A8VVagAAAAB////////////////////////////////+qp//wAA//gPCqpQAAVVUKqqqqqlVVVVVVVVVVVVqqqqqqqqqqqqpVYAP/8AAP/wDxVVoAACAAB/////////////////////////////////1V//AAD/4IYKqlAAAVKoVVVVVVqqqqqqqqqqqqpVVVVVVVVVVVVaqqAP/wAA/8EAFVWgAAKoAD/////////////////////////////////6p/8AAP/CgAqqUAABVVUKqqqqpVVVVVVVVVVVVaqqqqqqqqqqqqVVUAP/AAD/hUAVVagAAqoAH///////////////////////////////x/1V/wAA/wqACqpUAAVVKoVVVVVaqqqqqqqqqqqqVVVVVVVVVVVVWqKqAf8AAP8FQBVVqgAKqoAH//////////H////8f///x///x/8fD//j/6r/AAD/CoAKqlVAVVUBQqqqD4FgEBjAYxjEcBWjEYOYxwGqCgY40VUA/wAA/hVAFVWqqqqqgAf//AcAwDAYxmMYzGMf4xmZmMYx/ExmePH/1X8AAP4VQBVVqqqqqoAH//wHAMAwGMZjGMxjH+MZmZjGMfxMZnjx/9V/AAD+KqAKqlVVVVVAoVVYZjxGKOiP4xjEY+pjEXkBRn9U+P44oKqAfwAA/BVABVWqqqqqgAP/+P48Rjx4gGMYzGAf4xnhh8YB/PgGeOD/6r8AAPwqoAqqVVVVVUBQqrGqPEY2KI5jGMRjlaMRgoPGOajs5jjEVUA/AAD4VVAFVaqqqqqAAf/x/jzGPzjOYxjMc5/jGY+Rxzn8TOZ4jH/1XwAA+CqgCqpVVVVVQAhVUVUAoDAIwKAoBHAqYBFBGMcDVgYOAIoqoB8AAPhVUAVVqqqqqqAA//H/gfEwH+DgeB/4P+B/45//h/8fHgP///qvAADwqqgCqlVVVVVAFKqouqVVNVVVVVVVVVWqqqqaqqqqqqqlVVVQDwAA8VVQBVWqqqqqoAD/+Gf//z///////v//////n////////////U8AAPCKqAKqVVVVVVAIVVQFWqoqqKqqqqxqqlVRVRVFVVVVVVqqqqgHAADxFVQFVaqqqqqoAH/+D///P/j////8f///+f+fx//////////+pwAA4AqoAqpVFVVVVAQqqqqlVVVVVVVVVFVVqqiqqqqqqqqqpVVVVAcAAOAFVAFVqAKqqqoIf/////////////////////////////////9TAADiCqoCqlAAVVVUBFVVVVqqqqqqqqqqqqpVVVVVVVVVVVVaqqqqAwAA4AVUAVWgACqqqqp//////////////////////////////////qsAAOIKqgCqQABVVVVUKqgABVAVwo1UIQNBVawA6wKoLAqgKoIQVVUDAADgBVUBVYAAKqqqqj/4AAP4PwAD+AADwf/wAD8D+DwPwD8AAH//UwAA4gqqAKoAABVVVVQVWqqkqSpVU6VVUtWqaqqVKVK0pSpUpVVqqgMAAOAFVQFVgAAqqqqqP/gAAPg+AAHgAAPB/8AADwP4PA8A/AAAf/+rAADiCqqAqgAAFVVVVCqpX1patKVBSoKrSVXVAUtSqS1KVKlH6lVVAwAA4AVVQFWAACqqqqo/+BuAeDwf/8B+A8H/gPwHA/g8DAP4HqB//1MAAOIKqoAqAAAVVVVUFVq/5WkpWqrV1VLVq6uqpSlStKKlUr/1aqoDAADhFVVAVYAAKqqqqj/4FUB4OB//wP8Dwf+B/gcD+DwAD/AlUH//qwAA4rqqoCoAABVVVVQqqV/aWrqgAMqrK0tVlVdXUqktVUq1f/pVVQMAAOF1VUAVgAAqqqqqf/gawHg4AADA/wPB/4H+BwP4PAAf8Dqwf/9TAADguqqgKkAAVVVVVFVav6VpKVVU1dVS1KurqqWpUrSipVK/9WqqAwAA4X1VUBWgAKqqqqp/+AAA+DwfwMB+A8B/gPwHA/A8CAf4HWB//qcAAPC+qqgKUAFVVVVUKqlVWVq0uulKnqtKlZVVS1SlLUlSqUfqVVQHAADxfUFUBagCqqqCqH/4AAf4PA+B4AADwAHAAA8AADwOAfwAAH/9VwAA8L6AKApVVVVUAVRVWqqiqSpVUqVUUtRUSqqVKKq0pSpUpUVqqA8AAPBfABQFqqqqqgKo//gcA/g/AAf4AQPBgfAAPwIAfA+AfgAQf/qvAAD4vgAKAlVVVVQBUKqpX1lQFQqFVKErQUGsAOsCAK1KgCsAMFVQDwAA+F4ABQGqqqqoAqj/+BUB///gP/8PA//////////8D///////9V8AAPgsAAKCVVVVVAFRVVq/paqqqqqqqlKqqlVVVVVVVKVVVVqqqqAfAAD8XAAFAaqqqqgCof/4GwH///////8D//////////wP///////qvwAA/CwAAoBVVVVUAVKqqV9ZVFVVVVVVK1VVqqqqqqqtSqqqpVVVQD8AAP4UAAFAKqqqqAKj//gAA/g//////wP//////////A///////9U/AAD+CgACoBVVVVQFRVVaqqK1WqqqqqpSqqpVVVVVVVSlVVVaqqqAfwAA/hYAAVAqqqqqAoP/+AAH8B//////A//////////8D///////qn8AAP8LAAKgFVVVVRUCqqgABVKVVVVVVStVVaqqqqqqrAqqqqVVVQD/AAD/BYAFUAqqqqqqj//////4P/////+H//////////////////9U/wAA/4KAAqgFVVVQFRVVVVVaqqqqqqqqqqqqVVVVVVVVVVVVWqqoAf8AAP+BQAVUAqqoAAIf////////////////////////////////+qv/AAD/wrAKqgFVUAAAKqqqqqVVVVVVVVVVVVWqqqqqqqqqqqqlVVAH/wAA/+FcFVWAqoAAAA/////////////////////////////////1T/8AAP/wr+qqQFUB//wFVVVVWqqqqqqqqqqqqlVVVVVVVVVVVVqqgB//AAD/+Ff1VaAoB///gf///////////////////////////////qq//wAA//wr+qpAUB/4D8CqqqqlVVVVVVVVVVVVqqqqqqqqqqqqpVQAf/8AAP/+Ff1VoCB/gAHwf//////////////////////////////VVP//AAD//wqCqlAA/wAAeBAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH//wAA//+FAFWoAfwAADwFVVVaqqqqqqqqqqqqVVVVVVVVVVVVWqqn//8AAP//wIAKVAP4AAAeAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///AAD//+BAD6oH8AAAD4KqqqVVVVVVVVVVVVWqqqqqqqqqqqqlVD///wAA///4IAfVD/AAAAeAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH///8AAP///BQH+h/gAAADwVVVWqqqqqqqqqqqqlVVVVVVVVVVVVqH////AAD///4Cq/wfwAAAA+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf////wAA////AFWoP8AH/AHg//////////////////////////////////8AAP///8AKVH+A///g8P//////////////////////////////////AAD////wACh8g/////B//////////////////////////////////wAA/////AAA/g/////4f/////////////////////////////////8AAP/////gAP8f///B+H//////////////////////////////////AAD//////gH/j///gPw//////////////////////////////////wAA///////h/+///5j8P/////////////////////////////////8AAP//////4f////+I/D//////////////////////////////////AAD//////+H///H/w/4//////////////////////////////////wAA///////D///h///+H/////////////////////////////////8AAP//////w///wP///h//////////////////////////////////AAD//////8P//4D///4f/////////////////////////////////wAA///////D//+A///+H/////////////////////////////////8AAP//////w///AP///h//////////////////////////////////AAD//////8P//wH/+H4f/////////////////////////////////wAA///////D//8B//B+H/////////////////////////////////8AAP//////4//+Af/gfh//////////////////////////////////AAD//////+P//gH/4H4f/////////////////////////////////wAA///////h//4D/+B+P/////////////////////////////////8AAP//////4f/+A//AfD//////////////////////////////////AAD//////+H//gf/wPw//////////////////////////////////wAA///////h//+H/8D8P/////////////////////////////////8AAP//////8P//D/+B+H//////////////////////////////////AAD///////D//x//gfh//////////////////////////////////wAA///////4f////6Pwf/////////////////////////////////8AAP//////+H/////H8P//////////////////////////////////AAD///////g/////h+D//////////////////////////////////wAA///////4H////9/A//////////////////////////////////8AAP///////B//////wf//////////////////////////////////AAD///////4P/////4P//////////////////////////////////wAA///////+B/////8D//////////////////////////////////8AAP///////wP////+B///////////////////////////////////AAD///////+B/////A///////////////////////////////////wAA////////AP////gf//////////////////////////////////8AAP///////gA////gP///////////////////////////////////AAD///////wYD///gH///////////////////////////////////wAA///////8HAH//gH///////////////////////////////////8AAP//////+D4Af/AD////////////////////////////////////AAD///////B/AAAAB////////////////////////////////////wAA///////g/8AAAB////////////////////////////////////8AAP/////wAf/wAAB/////////////////////////////////////AAD/////4Af//AAf/////////////////////////////////////wAA/////+Af//wf//////////////////////////////////////8AAP/////gP//+H///////////////////////////////////////AAD/////8H///h///////////////////////////////////////wAA//////////8f//////////////////////////////////////8AAP//////////D///////////////////////////////////////AAD//////////4f//////////////////////////////////////wAA///////////D//////////////////////////////////////8AAP//////////4MP/////////////////////////////////////AAD///////////AB/////////////////////////////////////wAA///////////8Af////////////////////////////////////8AAP///////////4H/////////////////////////////////////AAD////////////D/////////////////////////////////////wAA//////////////////////////////////////////////////8AAP//////////////////////////////////////////////////AAA="
+ }
+ },
+ {
+ "headerText": {
+ "headerTextLines": "BIEDRONKA "CODZIENNIE NISKIE CENY" 5834
34-325 ŁODYGOWICE UL. BESKIDZKA 8
JERONIMO MARTINS POLSKA S.A.
62-025 KOSTRZYN UL.ŻNIWNA 5
"
+ }
+ },
+ {
+ "headerData": {
+ "tin": "7791011327",
+ "docNumber": 608827,
+ "date": "2026-07-30T17:21:19.000Z",
+ "CPS": 56
+ }
+ }
+ ],
+ "body": [
+ {
+ "sellLine": {
+ "name": "Tonic A",
+ "vatId": "A",
+ "price": 549,
+ "total": 549,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Citrus mix A",
+ "vatId": "A",
+ "price": 549,
+ "total": 549,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "NapGazCocaCoMIX2,5l A",
+ "vatId": "A",
+ "price": 899,
+ "total": 1798,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "NapGazCocaCoMIX2,5l A",
+ "vatId": "A",
+ "price": 899,
+ "total": 1798,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "OsheeVitamMagnez1,1l C",
+ "vatId": "C",
+ "price": 449,
+ "total": 449,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Polaris NGaz 1,5l A",
+ "vatId": "A",
+ "price": 119,
+ "total": 714,
+ "quantity": "6",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Tost Maślany 500g C",
+ "vatId": "C",
+ "price": 399,
+ "total": 1596,
+ "quantity": "4",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "WódkaB Bocian 0,7l A",
+ "vatId": "A",
+ "price": 5399,
+ "total": 10798,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 10798,
+ "value": 2800,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "A"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "OlejRzepZOliwWyb1l C",
+ "vatId": "C",
+ "price": 999,
+ "total": 999,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "GranolaMleczCzek350g C",
+ "vatId": "C",
+ "price": 649,
+ "total": 649,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PodpałNatur64Kostki A",
+ "vatId": "A",
+ "price": 399,
+ "total": 399,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "GranolaFitNesOat300g C",
+ "vatId": "C",
+ "price": 999,
+ "total": 999,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "GranolaFitNesQui300g C",
+ "vatId": "C",
+ "price": 999,
+ "total": 999,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "DO MOJEJ IDĘ A",
+ "vatId": "A",
+ "price": 399,
+ "total": 798,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "KiełbBrockaSokołkg C",
+ "vatId": "C",
+ "price": 3290,
+ "total": 2866,
+ "quantity": "0,871",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 2866,
+ "value": 697,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "KiełbBrockaSokołkg C",
+ "vatId": "C",
+ "price": 3290,
+ "total": 2737,
+ "quantity": "0,832",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 2737,
+ "value": 665,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "GuancialeCubGB150g C",
+ "vatId": "C",
+ "price": 749,
+ "total": 3745,
+ "quantity": "5",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Bagietka 175g C",
+ "vatId": "C",
+ "price": 379,
+ "total": 1137,
+ "quantity": "3",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "MasloEkstra200g C",
+ "vatId": "C",
+ "price": 599,
+ "total": 599,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "NapGazKinleyMix1l A",
+ "vatId": "A",
+ "price": 749,
+ "total": 749,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Cebula 1kg opak C",
+ "vatId": "C",
+ "price": 499,
+ "total": 499,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "MuszSarKam185g B",
+ "vatId": "B",
+ "price": 369,
+ "total": 738,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "DIP ORIENTALNY CZOSN B",
+ "vatId": "B",
+ "price": 299,
+ "total": 299,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PrzypDoSoAmerKami20g B",
+ "vatId": "B",
+ "price": 299,
+ "total": 299,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "KetPikantnyPud 990 g B",
+ "vatId": "B",
+ "price": 1299,
+ "total": 1299,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "SosCzosMadXXL860g B",
+ "vatId": "B",
+ "price": 1099,
+ "total": 1099,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ZapalniczkSolebo1szt A",
+ "vatId": "A",
+ "price": 129,
+ "total": 129,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Ręcznik Queen 2 4 A",
+ "vatId": "A",
+ "price": 849,
+ "total": 849,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Jaja W Wyb L 10szt C",
+ "vatId": "C",
+ "price": 1399,
+ "total": 2798,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "MięsZnogiKu b k kg C",
+ "vatId": "C",
+ "price": 2199,
+ "total": 2038,
+ "quantity": "0,927",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 2038,
+ "value": 741,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Ser Gouda Świat1kg C",
+ "vatId": "C",
+ "price": 2989,
+ "total": 2989,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "MixSałatRoszpoVf150g C",
+ "vatId": "C",
+ "price": 549,
+ "total": 549,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Limonka szt C",
+ "vatId": "C",
+ "price": 199,
+ "total": 398,
+ "quantity": "2",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Cytryna 500 g C",
+ "vatId": "C",
+ "price": 599,
+ "total": 599,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PomidorPaprycz500g C",
+ "vatId": "C",
+ "price": 1299,
+ "total": 1299,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "Banan Luz C",
+ "vatId": "C",
+ "price": 699,
+ "total": 598,
+ "quantity": "0,856",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "OgórekSzkLuz C",
+ "vatId": "C",
+ "price": 899,
+ "total": 340,
+ "quantity": "0,378",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "BorówkaAmeryk 300g C",
+ "vatId": "C",
+ "price": 1498,
+ "total": 1498,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ChipsyCr130-140g C",
+ "vatId": "C",
+ "price": 799,
+ "total": 799,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 799,
+ "value": 243,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ChipsyTopFromage150g C",
+ "vatId": "C",
+ "price": 495,
+ "total": 495,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 495,
+ "value": 150,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ChipsyLay s120g C",
+ "vatId": "C",
+ "price": 869,
+ "total": 869,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 869,
+ "value": 264,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ChipsyCrun130-140g C",
+ "vatId": "C",
+ "price": 799,
+ "total": 799,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 799,
+ "value": 242,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PrażynkiNietKet100g C",
+ "vatId": "C",
+ "price": 499,
+ "total": 499,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 499,
+ "value": 152,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "ChipyCrun130-140g C",
+ "vatId": "C",
+ "price": 799,
+ "total": 799,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 799,
+ "value": 243,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PizzaKurPiecz600g C",
+ "vatId": "C",
+ "price": 1699,
+ "total": 1699,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 1699,
+ "value": 300,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PizRodzSzynSer600g C",
+ "vatId": "C",
+ "price": 1699,
+ "total": 1699,
+ "quantity": "1",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 1699,
+ "value": 300,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "SzynkaKonserwoKW200 C",
+ "vatId": "C",
+ "price": 699,
+ "total": 2097,
+ "quantity": "3",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 2097,
+ "value": 699,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "MakaronPennePa500g C",
+ "vatId": "C",
+ "price": 339,
+ "total": 1017,
+ "quantity": "3",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 1017,
+ "value": 339,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "C"
+ }
+ },
+ {
+ "sellLine": {
+ "name": "PIWO HEINEKEN 0,5B A",
+ "vatId": "A",
+ "price": 479,
+ "total": 5748,
+ "quantity": "12",
+ "isStorno": false
+ }
+ },
+ {
+ "discountLine": {
+ "base": 5748,
+ "value": 2874,
+ "isDiscount": true,
+ "isPercent": false,
+ "isStorno": false,
+ "vatId": "A"
+ }
+ },
+ { "discountSummary": { "discounts": 10709 } },
+ {
+ "vatSummary": {
+ "currency": "PLN",
+ "vatRatesSummary": [
+ {
+ "vatId": "A",
+ "vatRate": 2300,
+ "vatSale": 19204,
+ "vatAmount": 3591
+ },
+ { "vatId": "B", "vatRate": 800, "vatSale": 3734, "vatAmount": 277 },
+ { "vatId": "C", "vatRate": 500, "vatSale": 36117, "vatAmount": 1720 }
+ ]
+ }
+ },
+ {
+ "sumInCurrency": {
+ "fiscalTotal": 59055,
+ "totalWithPacks": 59755,
+ "currency": "PLN",
+ "printBig": true,
+ "printable": true
+ }
+ },
+ { "section": { "type": 0 } },
+ { "section": { "type": 1 } },
+ {
+ "pack": {
+ "name": "But Plastik kaucja",
+ "price": 50,
+ "quantity": "14",
+ "total": 700,
+ "isNegative": false
+ }
+ },
+ { "section": { "type": 100, "amount": 700, "currency": "PLN" } },
+ { "section": { "type": 101, "amount": 59755, "currency": "PLN" } },
+ { "section": { "type": 3 } },
+ {
+ "payment": {
+ "type": "2",
+ "amount": 59755,
+ "name": "VISA CARD 07 1",
+ "currency": "PLN"
+ }
+ },
+ {
+ "fiscalFooter": {
+ "billNumber": 419,
+ "uniqueNumber": "EAZ2202160196",
+ "cashNumber": "Kasa 1",
+ "cashier": "Kasjer nr 27",
+ "CPS": 56,
+ "date": "2026-07-30T17:21:19.000Z"
+ }
+ },
+ {
+ "addLine": {
+ "id": 0,
+ "data": "Nr transakcji:4320
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ {
+ "addLine": {
+ "id": 30,
+ "data": "Numer:5834260730432001
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ {
+ "addLine": {
+ "id": 41,
+ "data": "Udzielono łącznie opustów 107,09
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ {
+ "addLine": {
+ "id": 41,
+ "data": "w tym:
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ {
+ "addLine": {
+ "id": 41,
+ "data": " Promocje 107,09
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ {
+ "addLine": {
+ "id": 6,
+ "data": "Numer karty:99001*****936
",
+ "width": 80,
+ "CPS": 56
+ }
+ },
+ { "barcode": { "id": 5, "data": "MTAwMDA1ODM0NDMyMDI0MDIwMTgxOA==" } },
+ { "sysNumber": { "data": "4320", "width": 80, "CPS": 56 } }
+ ],
+ "sign": "9884906F1B375741B11083CB694BE25B79F66E001EC24307395DDD98CA3AE1114C0573D08A7DE7320E4152D5FF8AB34402368AAA97C72535F2F6CC439DCAA0A3529BCA76E53EC7217CE7995AE266638C320478CB91D10961CA80013181A2B978030A3691302848AD3F7E2443E8490E939A28312E428920EE795DADF80256E0F3A6BA1ABF28D5FB4D7CB1A860EF29CAC51DEDA13E81B1E1C99AC82E7DCA60C92967123B24AD1645169BF869BA2D8839B2E65E03F10A3F0A8D356D580EBF42CABC2432EE01C0320B35AF8B6DC015B09E943528F38E885157BD9BE0D2502822B830C230B9980819EE974434E3DB58E6431CD8884E38297917F432F521D38BF93849"
+}
diff --git a/billsplit/test/helpers.dart b/billsplit/test/helpers.dart
new file mode 100644
index 00000000..597fc2a5
--- /dev/null
+++ b/billsplit/test/helpers.dart
@@ -0,0 +1,78 @@
+import 'dart:io';
+
+import 'package:billsplit/state/app_state.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:provider/provider.dart';
+
+const _pickerChannel = MethodChannel('miguelruivo.flutter.plugins.filepicker');
+const _pathChannel = MethodChannel('plugins.flutter.io/path_provider');
+
+/// Mocks the file_picker method channel.
+///
+/// `pickResult`: bytes returned by pickFiles (null → user cancelled).
+/// `saveResult`: path returned by saveFile (null → user cancelled).
+/// `saveThrows`: saveFile raises a PlatformException.
+void mockFilePicker({
+ Uint8List? pickResult,
+ String? pickName,
+ String? saveResult,
+ bool saveThrows = false,
+}) {
+ TestWidgetsFlutterBinding.ensureInitialized();
+ TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+ .setMockMethodCallHandler(_pickerChannel, (call) async {
+ if (call.method == 'save') {
+ if (saveThrows) {
+ throw PlatformException(code: 'boom', message: 'disk full');
+ }
+ return saveResult;
+ }
+ // pickFiles ('custom'/'any'/...)
+ if (pickResult == null) return null;
+ return >[
+ {
+ 'path': '/tmp/${pickName ?? 'picked.json'}',
+ 'name': pickName ?? 'picked.json',
+ 'size': pickResult.length,
+ 'bytes': pickResult,
+ },
+ ];
+ });
+}
+
+/// Points path_provider's documents directory at [dir].
+void mockPathProvider(Directory dir) {
+ TestWidgetsFlutterBinding.ensureInitialized();
+ TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+ .setMockMethodCallHandler(_pathChannel, (call) async => dir.path);
+}
+
+/// Clears both channel mocks.
+void clearChannelMocks() {
+ TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+ ..setMockMethodCallHandler(_pickerChannel, null)
+ ..setMockMethodCallHandler(_pathChannel, null);
+}
+
+/// Creates an [AppState] persisted under a fresh temp directory.
+AppState tempState() {
+ final dir = Directory.systemTemp.createTempSync('billsplit_ui');
+ addTearDown(() => dir.deleteSync(recursive: true));
+ return AppState(overrideDir: dir)..loaded = true;
+}
+
+/// Pumps [home] inside the app shell with [state] provided.
+Future pumpApp(WidgetTester tester, AppState state, Widget home) {
+ return tester.pumpWidget(
+ ChangeNotifierProvider.value(
+ value: state,
+ child: MaterialApp(home: home),
+ ),
+ );
+}
+
+/// Fires the debounced save timer so tests end with no pending timers.
+Future flushSaves(WidgetTester tester) =>
+ tester.pump(const Duration(milliseconds: 450));
diff --git a/billsplit/test/models_test.dart b/billsplit/test/models_test.dart
new file mode 100644
index 00000000..0cfbb723
--- /dev/null
+++ b/billsplit/test/models_test.dart
@@ -0,0 +1,78 @@
+import 'dart:convert';
+
+import 'package:billsplit/domain/models.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+ test('formatPln handles zero, cents padding and negatives', () {
+ expect(formatPln(0), '0,00 zł');
+ expect(formatPln(5), '0,05 zł');
+ expect(formatPln(123456), '1234,56 zł');
+ expect(formatPln(-7), '-0,07 zł');
+ });
+
+ test('Ids are unique and ordered enough', () {
+ final a = Ids.next();
+ final b = Ids.next();
+ expect(a, isNot(b));
+ });
+
+ test('Person/Group/Assignment/Item/Receipt JSON roundtrips', () {
+ final p = Person(id: 'p1', name: 'Ala', drinks: false);
+ expect(Person.fromJson(p.toJson()).drinks, isFalse);
+
+ final g = Group(id: 'g1', name: 'Meat', memberIds: {'p1'});
+ expect(Group.fromJson(g.toJson()).memberIds, {'p1'});
+
+ final a = Assignment(mode: AssignMode.group, groupId: 'g1');
+ final a2 = Assignment.fromJson(a.toJson());
+ expect(a2.mode, AssignMode.group);
+ expect(a2.groupId, 'g1');
+
+ final i = Item(
+ id: 'i1',
+ name: 'Piwo',
+ totalGr: 500,
+ qty: 2,
+ unitPriceGr: 250,
+ discountGr: -100,
+ category: Categories.alcohol,
+ assignment: Assignment(mode: AssignMode.custom, customIds: {'p1'}),
+ );
+ final i2 = Item.fromJson(
+ jsonDecode(jsonEncode(i.toJson())) as Map,
+ );
+ expect(i2.assignment.customIds, {'p1'});
+ expect(i2.discountGr, -100);
+
+ final r = Receipt(
+ id: 'r1',
+ title: 't',
+ store: 's',
+ items: [i],
+ participantIds: {'p1'},
+ paidTotalGr: 500,
+ );
+ final r2 = Receipt.fromJson(
+ jsonDecode(jsonEncode(r.toJson())) as Map,
+ );
+ expect(r2.itemsTotalGr, 500);
+ expect(r2.participantIds, {'p1'});
+ expect(r2.store, 's');
+ });
+
+ test('fromJson tolerates missing optional fields', () {
+ final p = Person.fromJson(const {'id': 'x', 'name': 'n'});
+ expect(p.drinks, isTrue);
+ final g = Group.fromJson(const {'id': 'x', 'name': 'n'});
+ expect(g.memberIds, isEmpty);
+ final a = Assignment.fromJson(const {});
+ expect(a.mode, AssignMode.everyone);
+ final i = Item.fromJson(const {'id': 'x', 'name': 'n', 'totalGr': 1});
+ expect(i.qty, 1);
+ expect(i.category, Categories.general);
+ final r = Receipt.fromJson(const {'id': 'x', 'title': 't', 'date': 'bad'});
+ expect(r.items, isEmpty);
+ expect(r.paidTotalGr, isNull);
+ });
+}
diff --git a/billsplit/test/split_engine_test.dart b/billsplit/test/split_engine_test.dart
new file mode 100644
index 00000000..9451f673
--- /dev/null
+++ b/billsplit/test/split_engine_test.dart
@@ -0,0 +1,189 @@
+import 'dart:io';
+import 'dart:math';
+
+import 'package:billsplit/domain/eparagon_parser.dart';
+import 'package:billsplit/domain/models.dart';
+import 'package:billsplit/domain/split_engine.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+List makePeople(int n, {Set nonDrinkers = const {}}) => [
+ for (var i = 0; i < n; i++)
+ Person(id: 'p$i', name: 'P$i', drinks: !nonDrinkers.contains(i)),
+ ];
+
+void main() {
+ test('splitAmount: exact sum, deterministic, rotation moves the extra', () {
+ final shares = splitAmount(100, ['b', 'a', 'c']); // rotation 0
+ expect(shares.values.reduce((a, b) => a + b), 100);
+ expect(shares['a'], 34); // sorted order, start at index 0
+ expect(shares['b'], 33);
+ expect(shares['c'], 33);
+ final rotated = splitAmount(100, ['b', 'a', 'c'], rotation: 1);
+ expect(rotated.values.reduce((a, b) => a + b), 100);
+ expect(rotated['b'], 34); // start shifted by one
+ // Same inputs -> same output (deterministic).
+ expect(splitAmount(100, ['b', 'a', 'c'], rotation: 1), rotated);
+ });
+
+ test('splitAmount: negative totals (returns) also sum exactly', () {
+ final shares = splitAmount(-100, ['a', 'b', 'c']);
+ expect(shares.values.reduce((a, b) => a + b), -100);
+ expect(shares.values.every((v) => v == -33 || v == -34), isTrue);
+ });
+
+ test('splitAmount fuzz: sum invariant over random cases', () {
+ final rnd = Random(42);
+ for (var i = 0; i < 500; i++) {
+ final n = 1 + rnd.nextInt(9);
+ final total = rnd.nextInt(100000) - 5000;
+ final ids = List.generate(n, (j) => 'p$j');
+ final shares = splitAmount(total, ids, rotation: rnd.nextInt(1000));
+ expect(
+ shares.values.fold(0, (a, b) => a + b),
+ total,
+ reason: 'total=$total n=$n',
+ );
+ final values = shares.values.toList();
+ expect(
+ values.reduce(max) - values.reduce(min),
+ lessThanOrEqualTo(1),
+ reason: 'shares differ by more than 1 grosz',
+ );
+ }
+ });
+
+ test('modes resolve correctly and intersect with receipt participants', () {
+ final people = makePeople(4, nonDrinkers: {3});
+ final group = Group(id: 'g1', name: 'Meat', memberIds: {'p0', 'p2'});
+ final receipt = Receipt(
+ id: 'r',
+ title: 't',
+ participantIds: {'p0', 'p1', 'p3'}, // p2 not on this receipt
+ );
+ Item mk(Assignment a) =>
+ Item(id: Ids.next(), name: 'x', totalGr: 300, assignment: a);
+
+ expect(
+ resolveParticipants(mk(Assignment()), receipt, people, [group])
+ .map((p) => p.id),
+ ['p0', 'p1', 'p3'],
+ );
+ expect(
+ resolveParticipants(
+ mk(Assignment(mode: AssignMode.drinkers)),
+ receipt,
+ people,
+ [group],
+ ).map((p) => p.id),
+ ['p0', 'p1'],
+ );
+ expect(
+ resolveParticipants(
+ mk(Assignment(mode: AssignMode.nonDrinkers)),
+ receipt,
+ people,
+ [group],
+ ).map((p) => p.id),
+ ['p3'],
+ );
+ // Group intersected with receipt pool: p2 excluded.
+ expect(
+ resolveParticipants(
+ mk(Assignment(mode: AssignMode.group, groupId: 'g1')),
+ receipt,
+ people,
+ [group],
+ ).map((p) => p.id),
+ ['p0'],
+ );
+ expect(
+ resolveParticipants(
+ mk(Assignment(mode: AssignMode.custom, customIds: {'p1', 'p2'})),
+ receipt,
+ people,
+ [group],
+ ).map((p) => p.id),
+ ['p1'],
+ );
+ // Missing group -> unassigned.
+ expect(
+ resolveParticipants(
+ mk(Assignment(mode: AssignMode.group, groupId: 'gone')),
+ receipt,
+ people,
+ [group],
+ ),
+ isEmpty,
+ );
+ });
+
+ test('real receipt: 8 people, all drinkers — reconciles to 597.55', () {
+ final receipt = parseEParagon(
+ File('test/fixtures/sample_receipt.json').readAsStringSync(),
+ );
+ final people = makePeople(8);
+ receipt.participantIds.addAll(people.map((p) => p.id));
+
+ final split = computeSplit(receipt, people, []);
+ expect(split.unassigned, isEmpty);
+ // Exact reconciliation is the hard invariant.
+ expect(split.assignedTotalGr, 59755);
+ // 59755 / 8 = 7469.375 -> everyone lands within a few grosze of that;
+ // remainder rotation spreads the extras instead of stacking them on the
+ // alphabetically-first person.
+ final totals = split.perPerson.values.map((t) => t.totalGr).toList();
+ for (final t in totals) {
+ expect(t, inInclusiveRange(7469 - 15, 7470 + 15));
+ }
+ // Alcohol: 79.98 + 28.74 = 108.72 split over 8 -> 13.59 each ±2 gr.
+ final alcohol = split.perPerson.values.map((t) => t.alcoholGr).toList();
+ expect(alcohol.fold(0, (a, b) => a + b), 10872);
+ for (final a in alcohol) {
+ expect(a, inInclusiveRange(1357, 1361));
+ }
+ });
+
+ test('real receipt: 2 non-drinkers pay no alcohol, totals still exact', () {
+ final receipt = parseEParagon(
+ File('test/fixtures/sample_receipt.json').readAsStringSync(),
+ );
+ final people = makePeople(8, nonDrinkers: {6, 7});
+ receipt.participantIds.addAll(people.map((p) => p.id));
+
+ final split = computeSplit(receipt, people, []);
+ expect(split.assignedTotalGr, 59755);
+ expect(split.perPerson['p6']!.alcoholGr, 0);
+ expect(split.perPerson['p7']!.alcoholGr, 0);
+ // 10872 over 6 drinkers = 1812 each ±2 gr, summing exactly.
+ final drinkerAlcohol = [
+ for (var i = 0; i < 6; i++) split.perPerson['p$i']!.alcoholGr,
+ ];
+ expect(drinkerAlcohol.fold(0, (a, b) => a + b), 10872);
+ for (final a in drinkerAlcohol) {
+ expect(a, inInclusiveRange(1810, 1814));
+ }
+ // Non-drinkers pay strictly less.
+ expect(
+ split.perPerson['p7']!.totalGr,
+ lessThan(split.perPerson['p0']!.totalGr),
+ );
+ });
+
+ test('items with no possible participants are reported, not lost', () {
+ final people = makePeople(2); // both drinkers
+ final receipt = Receipt(id: 'r', title: 't', participantIds: {'p0', 'p1'});
+ receipt.items.add(
+ Item(
+ id: 'i1',
+ name: 'water',
+ totalGr: 500,
+ assignment: Assignment(mode: AssignMode.nonDrinkers),
+ ),
+ );
+ receipt.items.add(Item(id: 'i2', name: 'bread', totalGr: 300));
+
+ final split = computeSplit(receipt, people, []);
+ expect(split.unassigned.map((i) => i.id), ['i1']);
+ expect(split.assignedTotalGr, 300);
+ });
+}
diff --git a/billsplit/test/ui_flows_test.dart b/billsplit/test/ui_flows_test.dart
new file mode 100644
index 00000000..1b246029
--- /dev/null
+++ b/billsplit/test/ui_flows_test.dart
@@ -0,0 +1,536 @@
+import 'dart:convert';
+import 'dart:io';
+import 'dart:typed_data';
+
+import 'package:billsplit/domain/models.dart';
+import 'package:billsplit/main.dart' as app;
+import 'package:billsplit/state/app_state.dart';
+import 'package:billsplit/ui/home_screen.dart';
+import 'package:billsplit/ui/people_screen.dart';
+import 'package:billsplit/ui/receipt_screen.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+import 'helpers.dart';
+
+Receipt demoReceipt(AppState s, {bool withUnassigned = false}) {
+ final r = Receipt(
+ id: 'r1',
+ title: 'Demo',
+ store: 'Biedronka',
+ paidTotalGr: 1000,
+ items: [
+ Item(id: 'i1', name: 'Bread', totalGr: 500),
+ Item(
+ id: 'i2',
+ name: 'Beer',
+ totalGr: 300,
+ category: Categories.alcohol,
+ assignment: Assignment(mode: AssignMode.drinkers),
+ ),
+ Item(
+ id: 'i3',
+ name: 'Tonic',
+ totalGr: 100,
+ category: Categories.mixer,
+ ),
+ Item(
+ id: 'i4',
+ name: 'Kaucja',
+ totalGr: 100,
+ category: Categories.deposit,
+ ),
+ if (withUnassigned)
+ Item(
+ id: 'i5',
+ name: 'Ghost',
+ totalGr: 50,
+ assignment: Assignment(mode: AssignMode.custom),
+ ),
+ ],
+ );
+ s.addReceipt(r);
+ return r;
+}
+
+void main() {
+ tearDown(clearChannelMocks);
+
+ group('main()', () {
+ testWidgets('boots with the real load path', (tester) async {
+ final dir = Directory.systemTemp.createTempSync('billsplit_main');
+ addTearDown(() => dir.deleteSync(recursive: true));
+ mockPathProvider(dir);
+ app.main();
+ await tester.pump();
+ await tester.pump();
+ expect(find.text('BillSplit'), findsOneWidget);
+ });
+ });
+
+ group('home', () {
+ testWidgets('import cancel does nothing', (tester) async {
+ mockFilePicker();
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.text('Import e-paragon'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, isEmpty);
+ });
+
+ testWidgets('import parse error shows message', (tester) async {
+ mockFilePicker(pickResult: Uint8List.fromList('zzz'.codeUnits));
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.text('Import e-paragon'));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('neither valid JSON'), findsOneWidget);
+ await flushSaves(tester);
+ });
+
+ testWidgets('import invalid UTF-8 hits the generic handler',
+ (tester) async {
+ mockFilePicker(pickResult: Uint8List.fromList([0xFF, 0xFE, 0x00]));
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.text('Import e-paragon'));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('Import failed'), findsOneWidget);
+ });
+
+ testWidgets('import success navigates; warning shows a snackbar',
+ (tester) async {
+ final fixture =
+ File('test/fixtures/sample_receipt.json').readAsBytesSync();
+ mockFilePicker(pickResult: fixture);
+ final s = tempState()..addPerson('Ala');
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.text('Import e-paragon'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, hasLength(1));
+ expect(find.byType(ReceiptScreen), findsOneWidget);
+ await flushSaves(tester);
+ });
+
+ testWidgets('import surfaces parser warnings', (tester) async {
+ final payload = {
+ 'dokument': {
+ 'paragon': {
+ 'pozycja': [
+ {
+ 'towar': {'nazwa': 'Chleb', 'ilosc': 1, 'brutto': 500},
+ },
+ ],
+ 'podsum': {'sumaBrutto': 999},
+ },
+ },
+ };
+ final body = base64Url.encode(utf8.encode(jsonEncode(payload)));
+ final wrapper = jsonEncode({'data': 'h.$body.s'});
+ mockFilePicker(pickResult: Uint8List.fromList(utf8.encode(wrapper)));
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.text('Import e-paragon'));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('differs'), findsOneWidget);
+ await flushSaves(tester);
+ });
+
+ testWidgets('manual create: cancel, empty and valid', (tester) async {
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+
+ await tester.tap(find.text('New receipt'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, isEmpty);
+
+ await tester.tap(find.text('New receipt'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Create'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, isEmpty);
+
+ await tester.tap(find.text('New receipt'));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.byType(TextField), 'Pizza night');
+ await tester.tap(find.text('Create'));
+ await tester.pumpAndSettle();
+ expect(s.receipts.single.title, 'Pizza night');
+ expect(find.byType(ReceiptScreen), findsOneWidget);
+ await tester.pageBack();
+ await tester.pumpAndSettle();
+
+ await tester.tap(find.text('New receipt'));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.byType(TextField), 'Kebab');
+ await tester.testTextInput.receiveAction(TextInputAction.done);
+ await tester.pumpAndSettle();
+ expect(s.receipts.first.title, 'Kebab');
+ await flushSaves(tester);
+ });
+
+ testWidgets('list tile navigates; dismiss asks and deletes',
+ (tester) async {
+ final s = tempState();
+ demoReceipt(s);
+ await pumpApp(tester, s, const HomeScreen());
+ await flushSaves(tester);
+
+ expect(find.textContaining('4 items'), findsOneWidget);
+ await tester.tap(find.text('Demo'));
+ await tester.pumpAndSettle();
+ expect(find.byType(ReceiptScreen), findsOneWidget);
+ await tester.pageBack();
+ await tester.pumpAndSettle();
+
+ await tester.drag(find.byType(Dismissible), const Offset(-600, 0));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, hasLength(1));
+
+ await tester.drag(find.byType(Dismissible), const Offset(-600, 0));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Delete'));
+ await tester.pumpAndSettle();
+ expect(s.receipts, isEmpty);
+ await flushSaves(tester);
+ });
+
+ testWidgets('people button opens roster', (tester) async {
+ final s = tempState();
+ await pumpApp(tester, s, const HomeScreen());
+ await tester.tap(find.byIcon(Icons.group));
+ await tester.pumpAndSettle();
+ expect(find.byType(PeopleScreen), findsOneWidget);
+ });
+ });
+
+ group('people', () {
+ testWidgets('add person dialog: toggle, cancel, empty, valid',
+ (tester) async {
+ final s = tempState();
+ await pumpApp(tester, s, const PeopleScreen());
+ expect(find.textContaining('Nobody yet'), findsOneWidget);
+
+ await tester.tap(find.text('Add person'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.byType(Switch));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+ expect(s.people, isEmpty);
+
+ await tester.tap(find.text('Add person'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Add'));
+ await tester.pumpAndSettle();
+ expect(s.people, isEmpty);
+
+ await tester.tap(find.text('Add person'));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.byType(TextField), 'Kasia');
+ await tester.tap(find.byType(Switch));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Add'));
+ await tester.pumpAndSettle();
+ expect(s.people.single.name, 'Kasia');
+ expect(s.people.single.drinks, isFalse);
+ await flushSaves(tester);
+ });
+
+ testWidgets('drinks switch, membership early-return, delete flows',
+ (tester) async {
+ final s = tempState();
+ final p = s.addPerson('Ala');
+ await pumpApp(tester, s, const PeopleScreen());
+ await flushSaves(tester);
+
+ await tester.tap(find.byType(Switch).first);
+ await tester.pumpAndSettle();
+ expect(p.drinks, isFalse);
+
+ // No groups yet → tapping the person is a no-op branch.
+ await tester.tap(find.text('Ala'));
+ await tester.pumpAndSettle();
+ expect(find.text('Group membership'), findsNothing);
+
+ await tester.tap(find.byIcon(Icons.delete_outline).first);
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+ expect(s.people, hasLength(1));
+
+ await tester.tap(find.byIcon(Icons.delete_outline).first);
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Remove'));
+ await tester.pumpAndSettle();
+ expect(s.people, isEmpty);
+ await flushSaves(tester);
+ });
+
+ testWidgets('groups: add, membership sheet, delete', (tester) async {
+ final s = tempState()..addPerson('Ala');
+ await pumpApp(tester, s, const PeopleScreen());
+ await flushSaves(tester);
+
+ await tester.tap(find.text('Add group'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+ expect(s.groups, isEmpty);
+
+ await tester.tap(find.text('Add group'));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.byType(TextField), 'Meat');
+ await tester.tap(find.text('Add'));
+ await tester.pumpAndSettle();
+ expect(s.groups.single.name, 'Meat');
+ expect(find.textContaining('No members'), findsOneWidget);
+
+ await tester.tap(find.text('Ala'));
+ await tester.pumpAndSettle();
+ expect(find.byType(CheckboxListTile), findsOneWidget);
+ await tester.tap(find.byType(CheckboxListTile));
+ await tester.pumpAndSettle();
+ expect(s.groups.single.memberIds, hasLength(1));
+ await tester.tap(find.byType(CheckboxListTile));
+ await tester.pumpAndSettle();
+ expect(s.groups.single.memberIds, isEmpty);
+ await tester.tapAt(const Offset(10, 10)); // close sheet
+ await tester.pumpAndSettle();
+
+ await tester.tap(find.byIcon(Icons.delete_outline).last);
+ await tester.pumpAndSettle();
+ expect(s.groups, isEmpty);
+ await flushSaves(tester);
+ });
+ });
+
+ group('receipt screen', () {
+ testWidgets('unknown id shows deleted note', (tester) async {
+ final s = tempState();
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'nope'));
+ expect(find.text('Receipt deleted.'), findsOneWidget);
+ });
+
+ testWidgets('tabs on narrow, panes on wide', (tester) async {
+ final s = tempState()..addPerson('Ala');
+ demoReceipt(s);
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'r1'));
+ await flushSaves(tester);
+ expect(find.byType(TabBar), findsOneWidget);
+ await tester.tap(find.text('Totals'));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('grosz-exact'), findsOneWidget);
+
+ tester.view.physicalSize = const Size(1600, 900);
+ tester.view.devicePixelRatio = 1;
+ addTearDown(tester.view.reset);
+ await tester.pumpAndSettle();
+ expect(find.byType(TabBar), findsNothing);
+ expect(find.byType(VerticalDivider), findsOneWidget);
+ });
+
+ testWidgets('participants: empty roster snackbar, then editing',
+ (tester) async {
+ final s = tempState();
+ demoReceipt(s);
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'r1'));
+ await flushSaves(tester);
+ await tester.tap(find.byIcon(Icons.group));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('Add people first'), findsOneWidget);
+
+ final p = s.addPerson('Ala');
+ s.addPerson('Bob');
+ await tester.pumpAndSettle();
+ await tester.tap(find.byIcon(Icons.group));
+ await tester.pumpAndSettle();
+ expect(find.text('Who is on this receipt?'), findsOneWidget);
+ await tester.tap(find.byType(CheckboxListTile).first);
+ await tester.pumpAndSettle();
+ expect(s.receipts.single.participantIds.contains(p.id), isTrue);
+ await tester.tap(find.byType(CheckboxListTile).first);
+ await tester.pumpAndSettle();
+ await tester.tapAt(const Offset(10, 10));
+ await tester.pumpAndSettle();
+ await flushSaves(tester);
+ });
+
+ testWidgets('export: no participants, success, cancel, failure',
+ (tester) async {
+ final s = tempState();
+ demoReceipt(s);
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'r1'));
+ await flushSaves(tester);
+
+ await tester.tap(find.byIcon(Icons.table_view));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('Add participants'), findsOneWidget);
+
+ s.addPerson('Ala');
+ s.receipts.single.participantIds.addAll(s.people.map((p) => p.id));
+ mockFilePicker(saveResult: '/tmp/out.xlsx');
+ await tester.pump(const Duration(seconds: 5)); // expire prior snackbar
+ await tester.pumpAndSettle();
+ await tester.tap(find.byIcon(Icons.table_view));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('Saved: out.xlsx'), findsOneWidget);
+
+ mockFilePicker();
+ await tester.pump(const Duration(seconds: 5));
+ await tester.pumpAndSettle();
+ await tester.tap(find.byIcon(Icons.table_view));
+ await tester.pumpAndSettle();
+
+ mockFilePicker(saveThrows: true);
+ await tester.pump(const Duration(seconds: 5));
+ await tester.pumpAndSettle();
+ await tester.tap(find.byIcon(Icons.table_view));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('Export failed'), findsOneWidget);
+ await flushSaves(tester);
+ });
+
+ testWidgets('items list: labels, unassigned, edit dialog paths',
+ (tester) async {
+ final s = tempState();
+ final p = s.addPerson('Ala');
+ s.addPerson('Bob', drinks: false);
+ final g = s.addGroup('Meat')..memberIds.add(p.id);
+ final r = demoReceipt(s, withUnassigned: true);
+ r.items[0].assignment = Assignment(mode: AssignMode.group, groupId: g.id);
+ r.items[2].assignment = Assignment(mode: AssignMode.nonDrinkers);
+ r.items[3].assignment = Assignment(
+ mode: AssignMode.group,
+ groupId: 'gone',
+ );
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'r1'));
+ await flushSaves(tester);
+
+ expect(find.textContaining('Group: Meat'), findsOneWidget);
+ expect(find.textContaining('Group: ?'), findsOneWidget);
+ expect(find.textContaining('Drinkers'), findsOneWidget);
+ expect(find.textContaining('Non-drinkers'), findsOneWidget);
+ expect(find.textContaining('UNASSIGNED'), findsOneWidget);
+
+ await tester.tap(find.text('Totals'));
+ await tester.pumpAndSettle();
+ expect(find.textContaining('excluded from totals'), findsOneWidget);
+ await tester.tap(find.text('Items'));
+ await tester.pumpAndSettle();
+
+ // Edit via long-press: invalid total keeps dialog open, then fix+save.
+ await tester.longPress(find.text('Bread'));
+ await tester.pumpAndSettle();
+ await tester.enterText(
+ find.widgetWithText(TextField, 'Total (zł)'),
+ 'abc',
+ );
+ await tester.tap(find.text('Save'));
+ await tester.pumpAndSettle();
+ expect(find.text('Save'), findsOneWidget); // still open
+ await tester.enterText(
+ find.widgetWithText(TextField, 'Total (zł)'),
+ '6,00',
+ );
+ await tester.enterText(find.widgetWithText(TextField, 'Name'), 'Rolls');
+ await tester.tap(find.text('Save'));
+ await tester.pumpAndSettle();
+ expect(r.items[0].totalGr, 600);
+ expect(r.items[0].name, 'Rolls');
+
+ // Delete an item from the edit dialog.
+ await tester.longPress(find.text('Ghost'));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Delete'));
+ await tester.pumpAndSettle();
+ expect(r.items.any((i) => i.name == 'Ghost'), isFalse);
+
+ // Add a new alcohol item via the FAB: cancel first, then create.
+ await tester.tap(find.byType(FloatingActionButton));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Cancel'));
+ await tester.pumpAndSettle();
+
+ await tester.tap(find.byType(FloatingActionButton));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.widgetWithText(TextField, 'Name'), 'Wine');
+ await tester.enterText(
+ find.widgetWithText(TextField, 'Total (zł)'),
+ '30',
+ );
+ await tester.tap(find.byType(DropdownButtonFormField));
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Alcohol').last);
+ await tester.pumpAndSettle();
+ await tester.tap(find.text('Save'));
+ await tester.pumpAndSettle();
+ final wine = r.items.singleWhere((i) => i.name == 'Wine');
+ expect(wine.totalGr, 3000);
+ expect(wine.assignment.mode, AssignMode.drinkers);
+
+ await tester.tap(find.byType(FloatingActionButton));
+ await tester.pumpAndSettle();
+ await tester.enterText(find.widgetWithText(TextField, 'Name'), 'Chips');
+ await tester.enterText(
+ find.widgetWithText(TextField, 'Total (zł)'),
+ '5',
+ );
+ await tester.tap(find.text('Save'));
+ await tester.pumpAndSettle();
+ expect(
+ r.items.singleWhere((i) => i.name == 'Chips').assignment.mode,
+ AssignMode.everyone,
+ );
+ await flushSaves(tester);
+ });
+
+ testWidgets('assignment sheet: modes, materialization, nobody',
+ (tester) async {
+ final s = tempState();
+ final ala = s.addPerson('Ala');
+ s.addPerson('Bob');
+ final g = s.addGroup('Meat')..memberIds.add(ala.id);
+ final r = demoReceipt(s);
+ await pumpApp(tester, s, const ReceiptScreen(receiptId: 'r1'));
+ await flushSaves(tester);
+
+ await tester.tap(find.text('Bread'));
+ await tester.pumpAndSettle();
+ final item = r.items[0];
+
+ await tester.tap(find.widgetWithText(ChoiceChip, 'Drinkers'));
+ await tester.pumpAndSettle();
+ expect(item.assignment.mode, AssignMode.drinkers);
+ await tester.tap(find.widgetWithText(ChoiceChip, 'Non-drinkers'));
+ await tester.pumpAndSettle();
+ expect(item.assignment.mode, AssignMode.nonDrinkers);
+ expect(find.textContaining('Nobody selected'), findsOneWidget);
+ await tester.tap(find.widgetWithText(ChoiceChip, 'Meat'));
+ await tester.pumpAndSettle();
+ expect(item.assignment.mode, AssignMode.group);
+ expect(item.assignment.groupId, g.id);
+ await tester.tap(find.widgetWithText(ChoiceChip, 'Everyone'));
+ await tester.pumpAndSettle();
+ expect(item.assignment.mode, AssignMode.everyone);
+
+ // Toggling a person on a symbolic mode materializes to custom.
+ await tester.tap(find.byType(CheckboxListTile).first);
+ await tester.pumpAndSettle();
+ expect(item.assignment.mode, AssignMode.custom);
+ expect(item.assignment.customIds, hasLength(1));
+ await tester.tap(find.byType(CheckboxListTile).last);
+ await tester.pumpAndSettle();
+ expect(item.assignment.customIds, isEmpty);
+ expect(find.textContaining('Nobody selected'), findsOneWidget);
+ await tester.tap(find.byType(CheckboxListTile).first);
+ await tester.pumpAndSettle();
+ expect(item.assignment.customIds, hasLength(1));
+ await flushSaves(tester);
+ });
+ });
+}
diff --git a/billsplit/test/widget_test.dart b/billsplit/test/widget_test.dart
new file mode 100644
index 00000000..e37c0aba
--- /dev/null
+++ b/billsplit/test/widget_test.dart
@@ -0,0 +1,16 @@
+import 'package:billsplit/main.dart';
+import 'package:billsplit/state/app_state.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+ testWidgets('app builds and shows empty state', (tester) async {
+ // Real file IO never completes inside the fake-async test zone, so skip
+ // load() and mark the state ready directly; this is a pure widget smoke
+ // test (persistence is exercised by the domain tests / at runtime).
+ final state = AppState()..loaded = true;
+ await tester.pumpWidget(BillSplitApp(state: state));
+ await tester.pump();
+ expect(find.text('BillSplit'), findsOneWidget);
+ expect(find.textContaining('No receipts yet'), findsOneWidget);
+ });
+}
diff --git a/billsplit/test/xlsx_export_test.dart b/billsplit/test/xlsx_export_test.dart
new file mode 100644
index 00000000..f9be9de2
--- /dev/null
+++ b/billsplit/test/xlsx_export_test.dart
@@ -0,0 +1,31 @@
+import 'dart:io';
+
+import 'package:billsplit/domain/eparagon_parser.dart';
+import 'package:billsplit/domain/models.dart';
+import 'package:billsplit/domain/xlsx_export.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+ test('exports a non-trivial xlsx for the real receipt', () {
+ final receipt = parseEParagon(
+ File('test/fixtures/sample_receipt.json').readAsStringSync(),
+ );
+ final people = [
+ for (var i = 0; i < 8; i++)
+ Person(id: 'p$i', name: 'Person ${i + 1}', drinks: i < 6),
+ ];
+ receipt.participantIds.addAll(people.map((p) => p.id));
+
+ final bytes = exportXlsx(receipt: receipt, roster: people, groups: []);
+ expect(bytes.length, greaterThan(4000));
+ // PK zip magic.
+ expect(bytes[0], 0x50);
+ expect(bytes[1], 0x4B);
+
+ // Write out for external validation (recalc via LibreOffice + openpyxl).
+ final out = File('build/test_export.xlsx')
+ ..createSync(recursive: true)
+ ..writeAsBytesSync(bytes);
+ expect(out.existsSync(), isTrue);
+ });
+}
diff --git a/billsplit/test/xlsx_extra_test.dart b/billsplit/test/xlsx_extra_test.dart
new file mode 100644
index 00000000..9d5516f5
--- /dev/null
+++ b/billsplit/test/xlsx_extra_test.dart
@@ -0,0 +1,36 @@
+import 'package:billsplit/domain/models.dart';
+import 'package:billsplit/domain/xlsx_export.dart';
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+ test('export handles no store/paid, unassigned items and non-drinkers', () {
+ final people = [
+ Person(id: 'a', name: 'Ala'),
+ Person(id: 'b', name: 'Bob', drinks: false),
+ ];
+ final receipt = Receipt(
+ id: 'r',
+ title: 'Manual',
+ participantIds: {'a', 'b'},
+ items: [
+ Item(id: 'i1', name: 'Bread', totalGr: 500),
+ Item(
+ id: 'i2',
+ name: 'Beer',
+ totalGr: 300,
+ category: Categories.alcohol,
+ assignment: Assignment(mode: AssignMode.drinkers),
+ ),
+ Item(
+ id: 'i3',
+ name: 'Ghost',
+ totalGr: 100,
+ assignment: Assignment(mode: AssignMode.custom),
+ ),
+ ],
+ );
+ final bytes = exportXlsx(receipt: receipt, roster: people, groups: []);
+ expect(bytes.length, greaterThan(1000));
+ expect(bytes[0], 0x50);
+ });
+}
diff --git a/billsplit/windows/.gitignore b/billsplit/windows/.gitignore
new file mode 100644
index 00000000..d492d0d9
--- /dev/null
+++ b/billsplit/windows/.gitignore
@@ -0,0 +1,17 @@
+flutter/ephemeral/
+
+# Visual Studio user-specific files.
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# Visual Studio build-related files.
+x64/
+x86/
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!*.[Cc]ache/
diff --git a/billsplit/windows/CMakeLists.txt b/billsplit/windows/CMakeLists.txt
new file mode 100644
index 00000000..bd40246d
--- /dev/null
+++ b/billsplit/windows/CMakeLists.txt
@@ -0,0 +1,108 @@
+# Project-level configuration.
+cmake_minimum_required(VERSION 3.14)
+project(billsplit LANGUAGES CXX)
+
+# The name of the executable created for the application. Change this to change
+# the on-disk name of your application.
+set(BINARY_NAME "billsplit")
+
+# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
+# versions of CMake.
+cmake_policy(VERSION 3.14...3.25)
+
+# Define build configuration option.
+get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+if(IS_MULTICONFIG)
+ set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release"
+ CACHE STRING "" FORCE)
+else()
+ if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+ set(CMAKE_BUILD_TYPE "Debug" CACHE
+ STRING "Flutter build mode" FORCE)
+ set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
+ "Debug" "Profile" "Release")
+ endif()
+endif()
+# Define settings for the Profile build mode.
+set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}")
+set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}")
+set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}")
+set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}")
+
+# Use Unicode for all projects.
+add_definitions(-DUNICODE -D_UNICODE)
+
+# Compilation settings that should be applied to most targets.
+#
+# Be cautious about adding new options here, as plugins use this function by
+# default. In most cases, you should add new options to specific targets instead
+# of modifying this function.
+function(APPLY_STANDARD_SETTINGS TARGET)
+ target_compile_features(${TARGET} PUBLIC cxx_std_17)
+ target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100")
+ target_compile_options(${TARGET} PRIVATE /EHsc)
+ target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0")
+ target_compile_definitions(${TARGET} PRIVATE "$<$:_DEBUG>")
+endfunction()
+
+# Flutter library and tool build rules.
+set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter")
+add_subdirectory(${FLUTTER_MANAGED_DIR})
+
+# Application build; see runner/CMakeLists.txt.
+add_subdirectory("runner")
+
+
+# Generated plugin build rules, which manage building the plugins and adding
+# them to the application.
+include(flutter/generated_plugins.cmake)
+
+
+# === Installation ===
+# Support files are copied into place next to the executable, so that it can
+# run in place. This is done instead of making a separate bundle (as on Linux)
+# so that building and running from within Visual Studio will work.
+set(BUILD_BUNDLE_DIR "$")
+# Make the "install" step default, as it's required to run.
+set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
+if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
+ set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
+endif()
+
+set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
+set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")
+
+install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
+ COMPONENT Runtime)
+
+install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
+ COMPONENT Runtime)
+
+install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+ COMPONENT Runtime)
+
+if(PLUGIN_BUNDLED_LIBRARIES)
+ install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
+ DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+ COMPONENT Runtime)
+endif()
+
+# Copy the native assets provided by the build.dart from all packages.
+set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
+install(DIRECTORY "${NATIVE_ASSETS_DIR}"
+ DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
+ COMPONENT Runtime)
+
+# Fully re-copy the assets directory on each build to avoid having stale files
+# from a previous install.
+set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
+install(CODE "
+ file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
+ " COMPONENT Runtime)
+install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
+ DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
+
+# Install the AOT library on non-Debug builds only.
+install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
+ CONFIGURATIONS Profile;Release
+ COMPONENT Runtime)
diff --git a/billsplit/windows/flutter/CMakeLists.txt b/billsplit/windows/flutter/CMakeLists.txt
new file mode 100644
index 00000000..903f4899
--- /dev/null
+++ b/billsplit/windows/flutter/CMakeLists.txt
@@ -0,0 +1,109 @@
+# This file controls Flutter-level build steps. It should not be edited.
+cmake_minimum_required(VERSION 3.14)
+
+set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral")
+
+# Configuration provided via flutter tool.
+include(${EPHEMERAL_DIR}/generated_config.cmake)
+
+# TODO: Move the rest of this into files in ephemeral. See
+# https://github.com/flutter/flutter/issues/57146.
+set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper")
+
+# Set fallback configurations for older versions of the flutter tool.
+if (NOT DEFINED FLUTTER_TARGET_PLATFORM)
+ set(FLUTTER_TARGET_PLATFORM "windows-x64")
+endif()
+
+# === Flutter Library ===
+set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll")
+
+# Published to parent scope for install step.
+set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
+set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
+set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
+set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE)
+
+list(APPEND FLUTTER_LIBRARY_HEADERS
+ "flutter_export.h"
+ "flutter_windows.h"
+ "flutter_messenger.h"
+ "flutter_plugin_registrar.h"
+ "flutter_texture_registrar.h"
+)
+list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/")
+add_library(flutter INTERFACE)
+target_include_directories(flutter INTERFACE
+ "${EPHEMERAL_DIR}"
+)
+target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib")
+add_dependencies(flutter flutter_assemble)
+
+# === Wrapper ===
+list(APPEND CPP_WRAPPER_SOURCES_CORE
+ "core_implementations.cc"
+ "standard_codec.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/")
+list(APPEND CPP_WRAPPER_SOURCES_PLUGIN
+ "plugin_registrar.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/")
+list(APPEND CPP_WRAPPER_SOURCES_APP
+ "flutter_engine.cc"
+ "flutter_view_controller.cc"
+)
+list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/")
+
+# Wrapper sources needed for a plugin.
+add_library(flutter_wrapper_plugin STATIC
+ ${CPP_WRAPPER_SOURCES_CORE}
+ ${CPP_WRAPPER_SOURCES_PLUGIN}
+)
+apply_standard_settings(flutter_wrapper_plugin)
+set_target_properties(flutter_wrapper_plugin PROPERTIES
+ POSITION_INDEPENDENT_CODE ON)
+set_target_properties(flutter_wrapper_plugin PROPERTIES
+ CXX_VISIBILITY_PRESET hidden)
+target_link_libraries(flutter_wrapper_plugin PUBLIC flutter)
+target_include_directories(flutter_wrapper_plugin PUBLIC
+ "${WRAPPER_ROOT}/include"
+)
+add_dependencies(flutter_wrapper_plugin flutter_assemble)
+
+# Wrapper sources needed for the runner.
+add_library(flutter_wrapper_app STATIC
+ ${CPP_WRAPPER_SOURCES_CORE}
+ ${CPP_WRAPPER_SOURCES_APP}
+)
+apply_standard_settings(flutter_wrapper_app)
+target_link_libraries(flutter_wrapper_app PUBLIC flutter)
+target_include_directories(flutter_wrapper_app PUBLIC
+ "${WRAPPER_ROOT}/include"
+)
+add_dependencies(flutter_wrapper_app flutter_assemble)
+
+# === Flutter tool backend ===
+# _phony_ is a non-existent file to force this command to run every time,
+# since currently there's no way to get a full input/output list from the
+# flutter tool.
+set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_")
+set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE)
+add_custom_command(
+ OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS}
+ ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN}
+ ${CPP_WRAPPER_SOURCES_APP}
+ ${PHONY_OUTPUT}
+ COMMAND ${CMAKE_COMMAND} -E env
+ ${FLUTTER_TOOL_ENVIRONMENT}
+ "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat"
+ ${FLUTTER_TARGET_PLATFORM} $
+ VERBATIM
+)
+add_custom_target(flutter_assemble DEPENDS
+ "${FLUTTER_LIBRARY}"
+ ${FLUTTER_LIBRARY_HEADERS}
+ ${CPP_WRAPPER_SOURCES_CORE}
+ ${CPP_WRAPPER_SOURCES_PLUGIN}
+ ${CPP_WRAPPER_SOURCES_APP}
+)
diff --git a/billsplit/windows/flutter/generated_plugin_registrant.cc b/billsplit/windows/flutter/generated_plugin_registrant.cc
new file mode 100644
index 00000000..8b6d4680
--- /dev/null
+++ b/billsplit/windows/flutter/generated_plugin_registrant.cc
@@ -0,0 +1,11 @@
+//
+// Generated file. Do not edit.
+//
+
+// clang-format off
+
+#include "generated_plugin_registrant.h"
+
+
+void RegisterPlugins(flutter::PluginRegistry* registry) {
+}
diff --git a/billsplit/windows/flutter/generated_plugin_registrant.h b/billsplit/windows/flutter/generated_plugin_registrant.h
new file mode 100644
index 00000000..dc139d85
--- /dev/null
+++ b/billsplit/windows/flutter/generated_plugin_registrant.h
@@ -0,0 +1,15 @@
+//
+// Generated file. Do not edit.
+//
+
+// clang-format off
+
+#ifndef GENERATED_PLUGIN_REGISTRANT_
+#define GENERATED_PLUGIN_REGISTRANT_
+
+#include
+
+// Registers Flutter plugins.
+void RegisterPlugins(flutter::PluginRegistry* registry);
+
+#endif // GENERATED_PLUGIN_REGISTRANT_
diff --git a/billsplit/windows/flutter/generated_plugins.cmake b/billsplit/windows/flutter/generated_plugins.cmake
new file mode 100644
index 00000000..3ad69c61
--- /dev/null
+++ b/billsplit/windows/flutter/generated_plugins.cmake
@@ -0,0 +1,24 @@
+#
+# Generated file, do not edit.
+#
+
+list(APPEND FLUTTER_PLUGIN_LIST
+)
+
+list(APPEND FLUTTER_FFI_PLUGIN_LIST
+ jni
+)
+
+set(PLUGIN_BUNDLED_LIBRARIES)
+
+foreach(plugin ${FLUTTER_PLUGIN_LIST})
+ add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin})
+ target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin)
+ list(APPEND PLUGIN_BUNDLED_LIBRARIES $)
+ list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries})
+endforeach(plugin)
+
+foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST})
+ add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin})
+ list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries})
+endforeach(ffi_plugin)
diff --git a/billsplit/windows/runner/CMakeLists.txt b/billsplit/windows/runner/CMakeLists.txt
new file mode 100644
index 00000000..394917c0
--- /dev/null
+++ b/billsplit/windows/runner/CMakeLists.txt
@@ -0,0 +1,40 @@
+cmake_minimum_required(VERSION 3.14)
+project(runner LANGUAGES CXX)
+
+# Define the application target. To change its name, change BINARY_NAME in the
+# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer
+# work.
+#
+# Any new source files that you add to the application should be added here.
+add_executable(${BINARY_NAME} WIN32
+ "flutter_window.cpp"
+ "main.cpp"
+ "utils.cpp"
+ "win32_window.cpp"
+ "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc"
+ "Runner.rc"
+ "runner.exe.manifest"
+)
+
+# Apply the standard set of build settings. This can be removed for applications
+# that need different build settings.
+apply_standard_settings(${BINARY_NAME})
+
+# Add preprocessor definitions for the build version.
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}")
+target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}")
+
+# Disable Windows macros that collide with C++ standard library functions.
+target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX")
+
+# Add dependency libraries and include directories. Add any application-specific
+# dependencies here.
+target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app)
+target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib")
+target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")
+
+# Run the Flutter tool portions of the build. This must not be removed.
+add_dependencies(${BINARY_NAME} flutter_assemble)
diff --git a/billsplit/windows/runner/Runner.rc b/billsplit/windows/runner/Runner.rc
new file mode 100644
index 00000000..9f9b0e5e
--- /dev/null
+++ b/billsplit/windows/runner/Runner.rc
@@ -0,0 +1,121 @@
+// Microsoft Visual C++ generated resource script.
+//
+#pragma code_page(65001)
+#include "resource.h"
+
+#define APSTUDIO_READONLY_SYMBOLS
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 2 resource.
+//
+#include "winres.h"
+
+/////////////////////////////////////////////////////////////////////////////
+#undef APSTUDIO_READONLY_SYMBOLS
+
+/////////////////////////////////////////////////////////////////////////////
+// English (United States) resources
+
+#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU)
+LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
+
+#ifdef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// TEXTINCLUDE
+//
+
+1 TEXTINCLUDE
+BEGIN
+ "resource.h\0"
+END
+
+2 TEXTINCLUDE
+BEGIN
+ "#include ""winres.h""\r\n"
+ "\0"
+END
+
+3 TEXTINCLUDE
+BEGIN
+ "\r\n"
+ "\0"
+END
+
+#endif // APSTUDIO_INVOKED
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Icon
+//
+
+// Icon with lowest ID value placed first to ensure application icon
+// remains consistent on all systems.
+IDI_APP_ICON ICON "resources\\app_icon.ico"
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Version
+//
+
+#if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD)
+#define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD
+#else
+#define VERSION_AS_NUMBER 1,0,0,0
+#endif
+
+#if defined(FLUTTER_VERSION)
+#define VERSION_AS_STRING FLUTTER_VERSION
+#else
+#define VERSION_AS_STRING "1.0.0"
+#endif
+
+VS_VERSION_INFO VERSIONINFO
+ FILEVERSION VERSION_AS_NUMBER
+ PRODUCTVERSION VERSION_AS_NUMBER
+ FILEFLAGSMASK VS_FFI_FILEFLAGSMASK
+#ifdef _DEBUG
+ FILEFLAGS VS_FF_DEBUG
+#else
+ FILEFLAGS 0x0L
+#endif
+ FILEOS VOS__WINDOWS32
+ FILETYPE VFT_APP
+ FILESUBTYPE 0x0L
+BEGIN
+ BLOCK "StringFileInfo"
+ BEGIN
+ BLOCK "040904e4"
+ BEGIN
+ VALUE "CompanyName", "dev.kuhy" "\0"
+ VALUE "FileDescription", "billsplit" "\0"
+ VALUE "FileVersion", VERSION_AS_STRING "\0"
+ VALUE "InternalName", "billsplit" "\0"
+ VALUE "LegalCopyright", "Copyright (C) 2026 dev.kuhy. All rights reserved." "\0"
+ VALUE "OriginalFilename", "billsplit.exe" "\0"
+ VALUE "ProductName", "billsplit" "\0"
+ VALUE "ProductVersion", VERSION_AS_STRING "\0"
+ END
+ END
+ BLOCK "VarFileInfo"
+ BEGIN
+ VALUE "Translation", 0x409, 1252
+ END
+END
+
+#endif // English (United States) resources
+/////////////////////////////////////////////////////////////////////////////
+
+
+
+#ifndef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 3 resource.
+//
+
+
+/////////////////////////////////////////////////////////////////////////////
+#endif // not APSTUDIO_INVOKED
diff --git a/billsplit/windows/runner/flutter_window.cpp b/billsplit/windows/runner/flutter_window.cpp
new file mode 100644
index 00000000..955ee303
--- /dev/null
+++ b/billsplit/windows/runner/flutter_window.cpp
@@ -0,0 +1,71 @@
+#include "flutter_window.h"
+
+#include
+
+#include "flutter/generated_plugin_registrant.h"
+
+FlutterWindow::FlutterWindow(const flutter::DartProject& project)
+ : project_(project) {}
+
+FlutterWindow::~FlutterWindow() {}
+
+bool FlutterWindow::OnCreate() {
+ if (!Win32Window::OnCreate()) {
+ return false;
+ }
+
+ RECT frame = GetClientArea();
+
+ // The size here must match the window dimensions to avoid unnecessary surface
+ // creation / destruction in the startup path.
+ flutter_controller_ = std::make_unique(
+ frame.right - frame.left, frame.bottom - frame.top, project_);
+ // Ensure that basic setup of the controller was successful.
+ if (!flutter_controller_->engine() || !flutter_controller_->view()) {
+ return false;
+ }
+ RegisterPlugins(flutter_controller_->engine());
+ SetChildContent(flutter_controller_->view()->GetNativeWindow());
+
+ flutter_controller_->engine()->SetNextFrameCallback([&]() {
+ this->Show();
+ });
+
+ // Flutter can complete the first frame before the "show window" callback is
+ // registered. The following call ensures a frame is pending to ensure the
+ // window is shown. It is a no-op if the first frame hasn't completed yet.
+ flutter_controller_->ForceRedraw();
+
+ return true;
+}
+
+void FlutterWindow::OnDestroy() {
+ if (flutter_controller_) {
+ flutter_controller_ = nullptr;
+ }
+
+ Win32Window::OnDestroy();
+}
+
+LRESULT
+FlutterWindow::MessageHandler(HWND hwnd, UINT const message,
+ WPARAM const wparam,
+ LPARAM const lparam) noexcept {
+ // Give Flutter, including plugins, an opportunity to handle window messages.
+ if (flutter_controller_) {
+ std::optional result =
+ flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam,
+ lparam);
+ if (result) {
+ return *result;
+ }
+ }
+
+ switch (message) {
+ case WM_FONTCHANGE:
+ flutter_controller_->engine()->ReloadSystemFonts();
+ break;
+ }
+
+ return Win32Window::MessageHandler(hwnd, message, wparam, lparam);
+}
diff --git a/billsplit/windows/runner/flutter_window.h b/billsplit/windows/runner/flutter_window.h
new file mode 100644
index 00000000..6da0652f
--- /dev/null
+++ b/billsplit/windows/runner/flutter_window.h
@@ -0,0 +1,33 @@
+#ifndef RUNNER_FLUTTER_WINDOW_H_
+#define RUNNER_FLUTTER_WINDOW_H_
+
+#include
+#include
+
+#include
+
+#include "win32_window.h"
+
+// A window that does nothing but host a Flutter view.
+class FlutterWindow : public Win32Window {
+ public:
+ // Creates a new FlutterWindow hosting a Flutter view running |project|.
+ explicit FlutterWindow(const flutter::DartProject& project);
+ virtual ~FlutterWindow();
+
+ protected:
+ // Win32Window:
+ bool OnCreate() override;
+ void OnDestroy() override;
+ LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam,
+ LPARAM const lparam) noexcept override;
+
+ private:
+ // The project to run.
+ flutter::DartProject project_;
+
+ // The Flutter instance hosted by this window.
+ std::unique_ptr flutter_controller_;
+};
+
+#endif // RUNNER_FLUTTER_WINDOW_H_
diff --git a/billsplit/windows/runner/main.cpp b/billsplit/windows/runner/main.cpp
new file mode 100644
index 00000000..4dc011ee
--- /dev/null
+++ b/billsplit/windows/runner/main.cpp
@@ -0,0 +1,43 @@
+#include
+#include
+#include
+
+#include "flutter_window.h"
+#include "utils.h"
+
+int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev,
+ _In_ wchar_t *command_line, _In_ int show_command) {
+ // Attach to console when present (e.g., 'flutter run') or create a
+ // new console when running with a debugger.
+ if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) {
+ CreateAndAttachConsole();
+ }
+
+ // Initialize COM, so that it is available for use in the library and/or
+ // plugins.
+ ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED);
+
+ flutter::DartProject project(L"data");
+
+ std::vector command_line_arguments =
+ GetCommandLineArguments();
+
+ project.set_dart_entrypoint_arguments(std::move(command_line_arguments));
+
+ FlutterWindow window(project);
+ Win32Window::Point origin(10, 10);
+ Win32Window::Size size(1280, 720);
+ if (!window.Create(L"billsplit", origin, size)) {
+ return EXIT_FAILURE;
+ }
+ window.SetQuitOnClose(true);
+
+ ::MSG msg;
+ while (::GetMessage(&msg, nullptr, 0, 0)) {
+ ::TranslateMessage(&msg);
+ ::DispatchMessage(&msg);
+ }
+
+ ::CoUninitialize();
+ return EXIT_SUCCESS;
+}
diff --git a/billsplit/windows/runner/resource.h b/billsplit/windows/runner/resource.h
new file mode 100644
index 00000000..66a65d1e
--- /dev/null
+++ b/billsplit/windows/runner/resource.h
@@ -0,0 +1,16 @@
+//{{NO_DEPENDENCIES}}
+// Microsoft Visual C++ generated include file.
+// Used by Runner.rc
+//
+#define IDI_APP_ICON 101
+
+// Next default values for new objects
+//
+#ifdef APSTUDIO_INVOKED
+#ifndef APSTUDIO_READONLY_SYMBOLS
+#define _APS_NEXT_RESOURCE_VALUE 102
+#define _APS_NEXT_COMMAND_VALUE 40001
+#define _APS_NEXT_CONTROL_VALUE 1001
+#define _APS_NEXT_SYMED_VALUE 101
+#endif
+#endif
diff --git a/billsplit/windows/runner/resources/app_icon.ico b/billsplit/windows/runner/resources/app_icon.ico
new file mode 100644
index 00000000..c04e20ca
Binary files /dev/null and b/billsplit/windows/runner/resources/app_icon.ico differ
diff --git a/billsplit/windows/runner/runner.exe.manifest b/billsplit/windows/runner/runner.exe.manifest
new file mode 100644
index 00000000..153653e8
--- /dev/null
+++ b/billsplit/windows/runner/runner.exe.manifest
@@ -0,0 +1,14 @@
+
+
+
+
+ PerMonitorV2
+
+
+
+
+
+
+
+
+
diff --git a/billsplit/windows/runner/utils.cpp b/billsplit/windows/runner/utils.cpp
new file mode 100644
index 00000000..3cb71466
--- /dev/null
+++ b/billsplit/windows/runner/utils.cpp
@@ -0,0 +1,69 @@
+#include "utils.h"
+
+#include
+#include
+#include
+#include
+
+#include
+
+void CreateAndAttachConsole() {
+ if (::AllocConsole()) {
+ FILE *unused;
+ if (freopen_s(&unused, "CONOUT$", "w", stdout)) {
+ _dup2(_fileno(stdout), 1);
+ }
+ if (freopen_s(&unused, "CONOUT$", "w", stderr)) {
+ _dup2(_fileno(stdout), 2);
+ }
+ std::ios::sync_with_stdio();
+ FlutterDesktopResyncOutputStreams();
+ }
+}
+
+std::vector GetCommandLineArguments() {
+ // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use.
+ int argc;
+ wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc);
+ if (argv == nullptr) {
+ return std::vector();
+ }
+
+ std::vector command_line_arguments;
+
+ // Skip the first argument as it's the binary name.
+ for (int i = 1; i < argc; i++) {
+ command_line_arguments.push_back(Utf8FromUtf16(argv[i]));
+ }
+
+ ::LocalFree(argv);
+
+ return command_line_arguments;
+}
+
+std::string Utf8FromUtf16(const wchar_t* utf16_string) {
+ if (utf16_string == nullptr) {
+ return std::string();
+ }
+ // First, find the length of the string with a safe upper bound (CWE-126).
+ // UNICODE_STRING_MAX_CHARS (32767) is the maximum length of a UNICODE_STRING.
+ int input_length = static_cast(wcsnlen(utf16_string, UNICODE_STRING_MAX_CHARS));
+ // Now use that bounded length to determine the required buffer size.
+ // When an explicit length is passed, WideCharToMultiByte does not include
+ // the null terminator in its returned size.
+ int target_length = ::WideCharToMultiByte(
+ CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string,
+ input_length, nullptr, 0, nullptr, nullptr);
+ std::string utf8_string;
+ if (target_length == 0 || static_cast(target_length) > utf8_string.max_size()) {
+ return utf8_string;
+ }
+ utf8_string.resize(target_length);
+ int converted_length = ::WideCharToMultiByte(
+ CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string,
+ input_length, utf8_string.data(), target_length, nullptr, nullptr);
+ if (converted_length == 0) {
+ return std::string();
+ }
+ return utf8_string;
+}
diff --git a/billsplit/windows/runner/utils.h b/billsplit/windows/runner/utils.h
new file mode 100644
index 00000000..3879d547
--- /dev/null
+++ b/billsplit/windows/runner/utils.h
@@ -0,0 +1,19 @@
+#ifndef RUNNER_UTILS_H_
+#define RUNNER_UTILS_H_
+
+#include
+#include
+
+// Creates a console for the process, and redirects stdout and stderr to
+// it for both the runner and the Flutter library.
+void CreateAndAttachConsole();
+
+// Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string
+// encoded in UTF-8. Returns an empty std::string on failure.
+std::string Utf8FromUtf16(const wchar_t* utf16_string);
+
+// Gets the command line arguments passed in as a std::vector,
+// encoded in UTF-8. Returns an empty std::vector on failure.
+std::vector GetCommandLineArguments();
+
+#endif // RUNNER_UTILS_H_
diff --git a/billsplit/windows/runner/win32_window.cpp b/billsplit/windows/runner/win32_window.cpp
new file mode 100644
index 00000000..60608d0f
--- /dev/null
+++ b/billsplit/windows/runner/win32_window.cpp
@@ -0,0 +1,288 @@
+#include "win32_window.h"
+
+#include
+#include
+
+#include "resource.h"
+
+namespace {
+
+/// Window attribute that enables dark mode window decorations.
+///
+/// Redefined in case the developer's machine has a Windows SDK older than
+/// version 10.0.22000.0.
+/// See: https://docs.microsoft.com/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute
+#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE
+#define DWMWA_USE_IMMERSIVE_DARK_MODE 20
+#endif
+
+constexpr const wchar_t kWindowClassName[] = L"FLUTTER_RUNNER_WIN32_WINDOW";
+
+/// Registry key for app theme preference.
+///
+/// A value of 0 indicates apps should use dark mode. A non-zero or missing
+/// value indicates apps should use light mode.
+constexpr const wchar_t kGetPreferredBrightnessRegKey[] =
+ L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize";
+constexpr const wchar_t kGetPreferredBrightnessRegValue[] = L"AppsUseLightTheme";
+
+// The number of Win32Window objects that currently exist.
+static int g_active_window_count = 0;
+
+using EnableNonClientDpiScaling = BOOL __stdcall(HWND hwnd);
+
+// Scale helper to convert logical scaler values to physical using passed in
+// scale factor
+int Scale(int source, double scale_factor) {
+ return static_cast(source * scale_factor);
+}
+
+// Dynamically loads the |EnableNonClientDpiScaling| from the User32 module.
+// This API is only needed for PerMonitor V1 awareness mode.
+void EnableFullDpiSupportIfAvailable(HWND hwnd) {
+ HMODULE user32_module = LoadLibraryA("User32.dll");
+ if (!user32_module) {
+ return;
+ }
+ auto enable_non_client_dpi_scaling =
+ reinterpret_cast(
+ GetProcAddress(user32_module, "EnableNonClientDpiScaling"));
+ if (enable_non_client_dpi_scaling != nullptr) {
+ enable_non_client_dpi_scaling(hwnd);
+ }
+ FreeLibrary(user32_module);
+}
+
+} // namespace
+
+// Manages the Win32Window's window class registration.
+class WindowClassRegistrar {
+ public:
+ ~WindowClassRegistrar() = default;
+
+ // Returns the singleton registrar instance.
+ static WindowClassRegistrar* GetInstance() {
+ if (!instance_) {
+ instance_ = new WindowClassRegistrar();
+ }
+ return instance_;
+ }
+
+ // Returns the name of the window class, registering the class if it hasn't
+ // previously been registered.
+ const wchar_t* GetWindowClass();
+
+ // Unregisters the window class. Should only be called if there are no
+ // instances of the window.
+ void UnregisterWindowClass();
+
+ private:
+ WindowClassRegistrar() = default;
+
+ static WindowClassRegistrar* instance_;
+
+ bool class_registered_ = false;
+};
+
+WindowClassRegistrar* WindowClassRegistrar::instance_ = nullptr;
+
+const wchar_t* WindowClassRegistrar::GetWindowClass() {
+ if (!class_registered_) {
+ WNDCLASS window_class{};
+ window_class.hCursor = LoadCursor(nullptr, IDC_ARROW);
+ window_class.lpszClassName = kWindowClassName;
+ window_class.style = CS_HREDRAW | CS_VREDRAW;
+ window_class.cbClsExtra = 0;
+ window_class.cbWndExtra = 0;
+ window_class.hInstance = GetModuleHandle(nullptr);
+ window_class.hIcon =
+ LoadIcon(window_class.hInstance, MAKEINTRESOURCE(IDI_APP_ICON));
+ window_class.hbrBackground = 0;
+ window_class.lpszMenuName = nullptr;
+ window_class.lpfnWndProc = Win32Window::WndProc;
+ RegisterClass(&window_class);
+ class_registered_ = true;
+ }
+ return kWindowClassName;
+}
+
+void WindowClassRegistrar::UnregisterWindowClass() {
+ UnregisterClass(kWindowClassName, nullptr);
+ class_registered_ = false;
+}
+
+Win32Window::Win32Window() {
+ ++g_active_window_count;
+}
+
+Win32Window::~Win32Window() {
+ --g_active_window_count;
+ Destroy();
+}
+
+bool Win32Window::Create(const std::wstring& title,
+ const Point& origin,
+ const Size& size) {
+ Destroy();
+
+ const wchar_t* window_class =
+ WindowClassRegistrar::GetInstance()->GetWindowClass();
+
+ const POINT target_point = {static_cast(origin.x),
+ static_cast(origin.y)};
+ HMONITOR monitor = MonitorFromPoint(target_point, MONITOR_DEFAULTTONEAREST);
+ UINT dpi = FlutterDesktopGetDpiForMonitor(monitor);
+ double scale_factor = dpi / 96.0;
+
+ HWND window = CreateWindow(
+ window_class, title.c_str(), WS_OVERLAPPEDWINDOW,
+ Scale(origin.x, scale_factor), Scale(origin.y, scale_factor),
+ Scale(size.width, scale_factor), Scale(size.height, scale_factor),
+ nullptr, nullptr, GetModuleHandle(nullptr), this);
+
+ if (!window) {
+ return false;
+ }
+
+ UpdateTheme(window);
+
+ return OnCreate();
+}
+
+bool Win32Window::Show() {
+ return ShowWindow(window_handle_, SW_SHOWNORMAL);
+}
+
+// static
+LRESULT CALLBACK Win32Window::WndProc(HWND const window,
+ UINT const message,
+ WPARAM const wparam,
+ LPARAM const lparam) noexcept {
+ if (message == WM_NCCREATE) {
+ auto window_struct = reinterpret_cast(lparam);
+ SetWindowLongPtr(window, GWLP_USERDATA,
+ reinterpret_cast(window_struct->lpCreateParams));
+
+ auto that = static_cast(window_struct->lpCreateParams);
+ EnableFullDpiSupportIfAvailable(window);
+ that->window_handle_ = window;
+ } else if (Win32Window* that = GetThisFromHandle(window)) {
+ return that->MessageHandler(window, message, wparam, lparam);
+ }
+
+ return DefWindowProc(window, message, wparam, lparam);
+}
+
+LRESULT
+Win32Window::MessageHandler(HWND hwnd,
+ UINT const message,
+ WPARAM const wparam,
+ LPARAM const lparam) noexcept {
+ switch (message) {
+ case WM_DESTROY:
+ window_handle_ = nullptr;
+ Destroy();
+ if (quit_on_close_) {
+ PostQuitMessage(0);
+ }
+ return 0;
+
+ case WM_DPICHANGED: {
+ auto newRectSize = reinterpret_cast(lparam);
+ LONG newWidth = newRectSize->right - newRectSize->left;
+ LONG newHeight = newRectSize->bottom - newRectSize->top;
+
+ SetWindowPos(hwnd, nullptr, newRectSize->left, newRectSize->top, newWidth,
+ newHeight, SWP_NOZORDER | SWP_NOACTIVATE);
+
+ return 0;
+ }
+ case WM_SIZE: {
+ RECT rect = GetClientArea();
+ if (child_content_ != nullptr) {
+ // Size and position the child window.
+ MoveWindow(child_content_, rect.left, rect.top, rect.right - rect.left,
+ rect.bottom - rect.top, TRUE);
+ }
+ return 0;
+ }
+
+ case WM_ACTIVATE:
+ if (child_content_ != nullptr) {
+ SetFocus(child_content_);
+ }
+ return 0;
+
+ case WM_DWMCOLORIZATIONCOLORCHANGED:
+ UpdateTheme(hwnd);
+ return 0;
+ }
+
+ return DefWindowProc(window_handle_, message, wparam, lparam);
+}
+
+void Win32Window::Destroy() {
+ OnDestroy();
+
+ if (window_handle_) {
+ DestroyWindow(window_handle_);
+ window_handle_ = nullptr;
+ }
+ if (g_active_window_count == 0) {
+ WindowClassRegistrar::GetInstance()->UnregisterWindowClass();
+ }
+}
+
+Win32Window* Win32Window::GetThisFromHandle(HWND const window) noexcept {
+ return reinterpret_cast(
+ GetWindowLongPtr(window, GWLP_USERDATA));
+}
+
+void Win32Window::SetChildContent(HWND content) {
+ child_content_ = content;
+ SetParent(content, window_handle_);
+ RECT frame = GetClientArea();
+
+ MoveWindow(content, frame.left, frame.top, frame.right - frame.left,
+ frame.bottom - frame.top, true);
+
+ SetFocus(child_content_);
+}
+
+RECT Win32Window::GetClientArea() {
+ RECT frame;
+ GetClientRect(window_handle_, &frame);
+ return frame;
+}
+
+HWND Win32Window::GetHandle() {
+ return window_handle_;
+}
+
+void Win32Window::SetQuitOnClose(bool quit_on_close) {
+ quit_on_close_ = quit_on_close;
+}
+
+bool Win32Window::OnCreate() {
+ // No-op; provided for subclasses.
+ return true;
+}
+
+void Win32Window::OnDestroy() {
+ // No-op; provided for subclasses.
+}
+
+void Win32Window::UpdateTheme(HWND const window) {
+ DWORD light_mode;
+ DWORD light_mode_size = sizeof(light_mode);
+ LSTATUS result = RegGetValue(HKEY_CURRENT_USER, kGetPreferredBrightnessRegKey,
+ kGetPreferredBrightnessRegValue,
+ RRF_RT_REG_DWORD, nullptr, &light_mode,
+ &light_mode_size);
+
+ if (result == ERROR_SUCCESS) {
+ BOOL enable_dark_mode = light_mode == 0;
+ DwmSetWindowAttribute(window, DWMWA_USE_IMMERSIVE_DARK_MODE,
+ &enable_dark_mode, sizeof(enable_dark_mode));
+ }
+}
diff --git a/billsplit/windows/runner/win32_window.h b/billsplit/windows/runner/win32_window.h
new file mode 100644
index 00000000..e901dde6
--- /dev/null
+++ b/billsplit/windows/runner/win32_window.h
@@ -0,0 +1,102 @@
+#ifndef RUNNER_WIN32_WINDOW_H_
+#define RUNNER_WIN32_WINDOW_H_
+
+#include
+
+#include
+#include
+#include
+
+// A class abstraction for a high DPI-aware Win32 Window. Intended to be
+// inherited from by classes that wish to specialize with custom
+// rendering and input handling
+class Win32Window {
+ public:
+ struct Point {
+ unsigned int x;
+ unsigned int y;
+ Point(unsigned int x, unsigned int y) : x(x), y(y) {}
+ };
+
+ struct Size {
+ unsigned int width;
+ unsigned int height;
+ Size(unsigned int width, unsigned int height)
+ : width(width), height(height) {}
+ };
+
+ Win32Window();
+ virtual ~Win32Window();
+
+ // Creates a win32 window with |title| that is positioned and sized using
+ // |origin| and |size|. New windows are created on the default monitor. Window
+ // sizes are specified to the OS in physical pixels, hence to ensure a
+ // consistent size this function will scale the inputted width and height as
+ // as appropriate for the default monitor. The window is invisible until
+ // |Show| is called. Returns true if the window was created successfully.
+ bool Create(const std::wstring& title, const Point& origin, const Size& size);
+
+ // Show the current window. Returns true if the window was successfully shown.
+ bool Show();
+
+ // Release OS resources associated with window.
+ void Destroy();
+
+ // Inserts |content| into the window tree.
+ void SetChildContent(HWND content);
+
+ // Returns the backing Window handle to enable clients to set icon and other
+ // window properties. Returns nullptr if the window has been destroyed.
+ HWND GetHandle();
+
+ // If true, closing this window will quit the application.
+ void SetQuitOnClose(bool quit_on_close);
+
+ // Return a RECT representing the bounds of the current client area.
+ RECT GetClientArea();
+
+ protected:
+ // Processes and route salient window messages for mouse handling,
+ // size change and DPI. Delegates handling of these to member overloads that
+ // inheriting classes can handle.
+ virtual LRESULT MessageHandler(HWND window,
+ UINT const message,
+ WPARAM const wparam,
+ LPARAM const lparam) noexcept;
+
+ // Called when CreateAndShow is called, allowing subclass window-related
+ // setup. Subclasses should return false if setup fails.
+ virtual bool OnCreate();
+
+ // Called when Destroy is called.
+ virtual void OnDestroy();
+
+ private:
+ friend class WindowClassRegistrar;
+
+ // OS callback called by message pump. Handles the WM_NCCREATE message which
+ // is passed when the non-client area is being created and enables automatic
+ // non-client DPI scaling so that the non-client area automatically
+ // responds to changes in DPI. All other messages are handled by
+ // MessageHandler.
+ static LRESULT CALLBACK WndProc(HWND const window,
+ UINT const message,
+ WPARAM const wparam,
+ LPARAM const lparam) noexcept;
+
+ // Retrieves a class instance pointer for |window|
+ static Win32Window* GetThisFromHandle(HWND const window) noexcept;
+
+ // Update the window frame's theme to match the system theme.
+ static void UpdateTheme(HWND const window);
+
+ bool quit_on_close_ = false;
+
+ // window handle for top level window.
+ HWND window_handle_ = nullptr;
+
+ // window handle for hosted content.
+ HWND child_content_ = nullptr;
+};
+
+#endif // RUNNER_WIN32_WINDOW_H_
diff --git a/docs/superpowers/contracts/billsplit-move-2026-08-03.json b/docs/superpowers/contracts/billsplit-move-2026-08-03.json
new file mode 100644
index 00000000..1a7dac84
--- /dev/null
+++ b/docs/superpowers/contracts/billsplit-move-2026-08-03.json
@@ -0,0 +1,22 @@
+{
+ "title": "Move billsplit into the testsAndMisc monorepo",
+ "objective": "Relocate the standalone billsplit Flutter app from ~/Downloads/billsplit (one commit, no git remote — the only copy of its history) into testsAndMisc as billsplit/, so it is version-controlled alongside the rest of the monorepo, its CI actually runs, and it carries a shared-family launcher icon instead of the stock Flutter one. Success means the app builds and tests to 100% line coverage from its new location, every one of its files is genuinely tracked, and the Downloads copy is removed only after the commit is confirmed on origin.",
+ "acceptance_criteria": [
+ "flutter pub get && flutter test --coverage && python3 tool/coverage_check.py all pass from ~/testsAndMisc/billsplit",
+ "git ls-files billsplit resolves to 162 files, including all 30 platform PNGs and the .ico — nothing silently dropped by the root .gitignore",
+ "billsplit/ contains no Python at all: its coverage gate lives at python_pkg/billsplit_coverage/ with its own 100%-branch-covered test suite, so check-python-location holds with no new exception",
+ "git check-ignore over billsplit/ shows zero files blocked by the root .gitignore; remaining hits come only from billsplit's own nested .gitignore files and are all generated artifacts",
+ "pre-commit run --files passes with no --no-verify and no new per-file lint suppressions",
+ "The relocated workflow sits at .github/workflows/billsplit-ci.yml with working-directory: billsplit and a billsplit/** path filter, so it is neither inert nor triggered by unrelated commits",
+ "The launcher icon is the charcoal + #B8862E family icon from python_pkg/app_icons, not the stock Flutter beach icon, and its perforation holes stay transparent on the foreground and monochrome layers",
+ "~/Downloads/billsplit is removed only after git log origin/main shows the new commit"
+ ],
+ "out_of_scope": [
+ "Any change to billsplit's Dart source, tests, or runtime behaviour — this is a move, not a refactor",
+ "Linux desktop integration: no hicolor icon set, no .desktop entry, no my_application.cc change; the app is phone-first",
+ "Rethemeing the app: its ThemeData still seeds from Colors.teal even though the icon uses the family accent",
+ "Adding dart format / flutter analyze pre-commit hooks for the new Dart code",
+ "Fixing the pre-existing missing system Python dependencies beyond what is needed to let the commit hooks run"
+ ],
+ "verifier": "pre-commit run --files $(git diff --cached --name-only) at commit time (ruff, ruff-format, mypy, pylint, bandit, codespell, no-binaries, check-python-location, ai-evidence-contract, ai-multifile-contract, and pytest-coverage over the whole python_pkg suite at --cov-fail-under=100); plus flutter test --coverage inside billsplit/ followed by python3 -m python_pkg.billsplit_coverage from the repository root; plus .github/workflows/billsplit-ci.yml on push"
+}
diff --git a/docs/superpowers/evidence/billsplit-move-2026-08-03.json b/docs/superpowers/evidence/billsplit-move-2026-08-03.json
new file mode 100644
index 00000000..223aae0d
--- /dev/null
+++ b/docs/superpowers/evidence/billsplit-move-2026-08-03.json
@@ -0,0 +1,82 @@
+{
+ "intent": "Move the standalone billsplit Flutter app (receipt splitting with e-paragon import) out of ~/Downloads and into the testsAndMisc monorepo as billsplit/, with its CI actually running and a shared-family launcher icon replacing the stock Flutter one.",
+ "scope": [
+ "billsplit/ — whole Flutter app tree, copied in and re-rooted",
+ ".gitignore — ! overrides so the blanket *.png / *.ico / *.manifest rules stop swallowing platform icon assets",
+ ".binary-allowlist — new file; the documented in-repo exception for build-input binaries",
+ ".github/workflows/billsplit-ci.yml — relocated from billsplit/.github/, which GitHub never reads when nested",
+ "python_pkg/app_icons/{glyphs,apps}.py — new receipt-split glyph and billsplit registry entry",
+ "python_pkg/app_icons/tests/test_registry.py — new invariant test",
+ "python_pkg/billsplit_coverage/ — new package; the app's coverage gate, relocated out of billsplit/tool/",
+ ".pre-commit-config.yaml — codespell ignore-words-list gains the Polish word `dokument`",
+ "meta/scripts/pytest_changed_packages.py and run_prettier_capped.sh — hook memory ceilings lowered to fit a 2G budget",
+ "Non-goal: no change to billsplit's own Dart source, tests, or behaviour",
+ "Non-goal: no Linux desktop entry / hicolor icon set — the app is phone-first"
+ ],
+ "changes": [
+ "Copied the tree and dropped its .git, .idea and .flutter-plugins-dependencies; billsplit's own nested .gitignore is kept and still correctly hides generated registrants, gradlew, ephemeral/ and coverage/.",
+ "Added a trailing billsplit block of ! overrides to .gitignore. It sits at the end of the file deliberately: gitignore is last-match-wins, and *.manifest lives in the PyInstaller section further down than the image block.",
+ "Created .binary-allowlist (it did not exist) with glob — not literal — patterns, so the entries survive icon regeneration. Departed from the memory's ../testsAndMisc_binaries/ + symlink scheme: those sibling directories no longer exist, and a symlinked PNG breaks flutter build on a fresh clone.",
+ "Relocated the CI workflow to the repository root with defaults.run.working-directory: billsplit and an on.push.paths filter, so it neither stays inert nor fires on unrelated Python/Bash commits.",
+ "Added a receipt-split glyph to the shared generator and registered billsplit, rather than hand-rolling a per-repo icon. The glyph is a filled silhouette because a stroked receipt cannot carry a fine torn edge at the family's 72px stroke; the split is a perforation cut with fill-rule=evenodd so the holes stay transparent on the icon_foreground and icon_monochrome layers.",
+ "Rewrote the coverage gate into typed functions writing to sys.stdout/sys.stderr. It had entered repo-wide ruff/mypy/pylint for the first time, and ruff --fix had stripped every print() call, leaving the failure branch as a bare `pass` that exited 1 while reporting nothing.",
+ "Moved that gate from billsplit/tool/coverage_check.py to python_pkg/billsplit_coverage/, so the check-python-location rule holds with no new exception and billsplit/ contains only Dart. It gained a --project flag and a 19-test suite at 100% branch coverage, which the python_pkg gate now requires of it; the CI step runs it from the repository root via `python3 -m python_pkg.billsplit_coverage`.",
+ "Added the Polish word `dokument` to codespell's ignore-words-list, alongside the Polish entries already there (sie, numer, adres, parametr, tekst, serwer, grup, blok, metod). It is a field name in the e-paragon schema, so correcting it to `document` would break the parser that matches on it.",
+ "Lowered the hook memory ceilings to fit a 2G budget: pytest_changed_packages.py from 4G to 2G and run_prettier_capped.sh from 1G to 512M (Node heap 768M to 384M). These were not merely generous, they were actively harmful — a nested systemd scope requesting more than its parent's budget gets OOM-killed from the inside, so the 4G request made the suite fail rather than throttle whenever a caller imposed a tighter cap. Both new values are set from measurement, not guesswork.",
+ "Added test_no_glyph_paints_the_background_colour, codifying the invariant that a glyph hole must be an evenodd cut rather than a charcoal-painted shape."
+ ],
+ "verification": [
+ {
+ "command": "cd billsplit && flutter test --coverage && python3 -m python_pkg.billsplit_coverage",
+ "result": "pass",
+ "evidence": "59 tests passed from the new location; '100% line coverage across 11 lib files.' The gate gives the same answer run from the repo root (default project resolution) and from inside billsplit/ with --project ."
+ },
+ {
+ "command": "pytest python_pkg/billsplit_coverage/tests --cov-branch",
+ "result": "pass",
+ "evidence": "19 passed, 100% branch coverage across __init__, __main__ and checker. Covers both failure modes explicitly: uncovered lines are reported by name and line number, a lib file absent from the report is reported as 0% coverage, and a missing report exits 2 — the gate reports rather than failing silently."
+ },
+ {
+ "command": "git check-ignore -v --no-index over every file in billsplit/",
+ "result": "pass",
+ "evidence": "Before the overrides, 32 of 146 files were swallowed (.gitignore:56 *.png x30, :62 *.ico, :153 *.manifest). After, zero files are blocked by the root .gitignore; the only remaining hits come from billsplit's own nested .gitignore files and are all generated artifacts."
+ },
+ {
+ "command": "pre-commit run --files $(git diff --cached --name-only)",
+ "result": "pass",
+ "evidence": "Full commit-time hook set over all staged files: ruff, ruff-format, mypy, pylint, bandit, codespell, no-binaries, check-python-location, ai-evidence-contract, ai-multifile-contract and pytest-coverage. No --no-verify and no new per-file lint suppressions."
+ },
+ {
+ "command": "pytest over every python_pkg/*/tests plus linux_configuration/tests, --cov python_pkg --cov-branch --cov-fail-under=100",
+ "result": "pass",
+ "evidence": "1098 passed, 12 skipped, TOTAL 100% branch coverage; python_pkg/app_icons at 100% across all nine modules. Run against a probe venv because the system interpreter is missing eight declared dependencies — verified pre-existing by reproducing the same collection errors at HEAD in a detached worktree."
+ },
+ {
+ "command": "resource.getrusage(RUSAGE_CHILDREN).ru_maxrss around the full pytest suite and around prettier",
+ "result": "pass",
+ "evidence": "Peak RSS 0.23 GiB for 1117 tests with branch coverage, and 0.10 GiB for prettier over a 14-file commit — against declared caps of 4G and 1G respectively. The new 2G and 512M ceilings are set from these numbers."
+ },
+ {
+ "command": "systemd-run --user --scope -p MemoryMax=2G -p MemorySwapMax=0 -- pre-commit run --files $(git diff --cached --name-only)",
+ "result": "pass",
+ "evidence": "Every hook completes inside a hard 2G cgroup with swap disabled; no hook is OOM-killed. Previously the 4G pytest request could not be satisfied inside such a scope."
+ },
+ {
+ "command": "python_pkg.app_icons render.safe_box_overflow for the receipt-split glyph",
+ "result": "pass",
+ "evidence": "(0, 0) — ink is 400x470, inside the 560px SAFE_BOX on both axes. Foreground and monochrome layers rendered over magenta to confirm the perforation holes are genuinely transparent."
+ }
+ ],
+ "risks": [
+ "The ! overrides in .gitignore are path-prefixed to billsplit/. A future Flutter app added to this monorepo will hit the same silent-drop problem and needs its own block plus .binary-allowlist entries.",
+ "billsplit is the only Dart code in a repo whose pre-commit suite is Python/Bash-shaped: there is no dart format or flutter analyze hook, so Dart style is gated only by the GitHub workflow, not locally.",
+ "The coverage gate now sits two directories away from the app it guards. Renaming or moving billsplit/ silently breaks the parents[2] default path resolution in python_pkg/billsplit_coverage/checker.py; the test suite pins the behaviour but not the app's location.",
+ "billsplit's ThemeData still seeds from Colors.teal while the icon uses the family accent #B8862E, so the launcher icon does not match the app's first screen. Deliberately left alone as out of scope for a move.",
+ "The commit cannot be made until eight declared dependencies are installed into the system interpreter; the pytest-coverage hook runs the whole suite at commit time, and bypassing hooks is not an option."
+ ],
+ "rollback": [
+ "git revert the move commit, then rm -rf billsplit/ — the app is self-contained under that one prefix apart from the .gitignore/.binary-allowlist/workflow/app_icons edits, which the revert restores.",
+ "The original tree remains at ~/Downloads/billsplit until the push is confirmed on origin, so a rollback before that point loses nothing.",
+ "After rollback, confirm python_pkg/app_icons tests still pass and that no other app's icon changed: the shared generator was extended with a new glyph, never edited in style.py, so the other seven apps' assets are untouched."
+ ]
+}
diff --git a/meta/scripts/pytest_changed_packages.py b/meta/scripts/pytest_changed_packages.py
index c10babab..bee54445 100755
--- a/meta/scripts/pytest_changed_packages.py
+++ b/meta/scripts/pytest_changed_packages.py
@@ -23,7 +23,13 @@ import shutil
import subprocess
import sys
-_TOTAL_MEM = "4G"
+# Memory ceiling for the whole suite. Measured peak RSS for all python_pkg
+# tests plus linux_configuration/tests (1117 tests, branch coverage on) is
+# ~0.23 GiB, so 2G leaves roughly 8x headroom. It was 4G, which is not free:
+# a 4G request cannot be satisfied inside a smaller outer scope, so wrapping
+# a commit in a tighter budget got the suite OOM-killed from the inside rather
+# than merely slowed. Keep this at or below any outer cap a caller may impose.
+_TOTAL_MEM = "2G"
# Standalone script test suites outside python_pkg/ that should be gated but
# not coverage-measured. Skipped silently if the directory does not exist.
diff --git a/meta/scripts/run_prettier_capped.sh b/meta/scripts/run_prettier_capped.sh
index 4df89e42..163264d1 100755
--- a/meta/scripts/run_prettier_capped.sh
+++ b/meta/scripts/run_prettier_capped.sh
@@ -8,19 +8,23 @@
set -euo pipefail
if [ $# -eq 0 ]; then
- exit 0
+ exit 0
fi
# Cap Node heap on top of the cgroup limit for belt-and-braces safety.
-export NODE_OPTIONS="${NODE_OPTIONS:-} --max-old-space-size=768"
+export NODE_OPTIONS="${NODE_OPTIONS:-} --max-old-space-size=384"
-if command -v systemd-run >/dev/null 2>&1 \
- && systemctl --user is-active --quiet default.target 2>/dev/null \
- || command -v systemd-run >/dev/null 2>&1; then
- exec systemd-run --user --scope --quiet --collect \
- -p MemoryMax=1G \
- -p MemorySwapMax=0 \
- -- prettier --check "$@"
+# Measured peak RSS checking the 14 yaml/json/markdown files of a large commit
+# is ~0.10 GiB, so 512M is ample. The cap must also stay small enough to be
+# satisfiable inside a tighter outer scope: a request larger than the caller's
+# budget gets this OOM-killed from the inside rather than merely throttled.
+if command -v systemd-run >/dev/null 2>&1 &&
+ systemctl --user is-active --quiet default.target 2>/dev/null ||
+ command -v systemd-run >/dev/null 2>&1; then
+ exec systemd-run --user --scope --quiet --collect \
+ -p MemoryMax=512M \
+ -p MemorySwapMax=0 \
+ -- prettier --check "$@"
fi
exec prettier --check "$@"
diff --git a/python_pkg/app_icons/apps.py b/python_pkg/app_icons/apps.py
index bda57212..c9fb1680 100644
--- a/python_pkg/app_icons/apps.py
+++ b/python_pkg/app_icons/apps.py
@@ -105,6 +105,30 @@ APPS: Final[dict[str, AppIcon]] = {
icon_name="home-inventory",
linux=True,
),
+ AppIcon(
+ key="billsplit",
+ # The only app in this registry that lives inside the testsAndMisc
+ # monorepo rather than in its own repo, so its path carries a
+ # directory component the others do not.
+ repo=_HOME / "testsAndMisc" / "billsplit",
+ accent="#B8862E",
+ glyph="receipt-split",
+ icon_name="billsplit",
+ # `flutter create` scaffolded a linux/ target, but the app is
+ # phone-first and ships no desktop entry, so the hicolor icon set
+ # is not generated for it.
+ linux=False,
+ ),
+ AppIcon(
+ key="epopeja_karta",
+ repo=_HOME / "epopeja_karta",
+ accent="#B8862E",
+ glyph="quill-nib",
+ icon_name="epopeja-karta",
+ # `flutter create` scaffolded no desktop target for this one; it is
+ # a character sheet you bring to the table, i.e. phone-only.
+ linux=False,
+ ),
)
}
diff --git a/python_pkg/app_icons/glyphs.py b/python_pkg/app_icons/glyphs.py
index 1362a0b8..de259835 100644
--- a/python_pkg/app_icons/glyphs.py
+++ b/python_pkg/app_icons/glyphs.py
@@ -112,6 +112,76 @@ _STORAGE_BOX = """\
"""
+# A till receipt with a torn bottom edge and a perforation down the middle:
+# one bill, two shares.
+#
+# Filled rather than stroked, which is what makes the tear possible at all. A
+# stroked receipt cannot have a fine ragged edge: at the family's 72px stroke,
+# a zigzag needs ~200px pitch to keep adjacent up-strokes MIN_NEGATIVE_SPACE
+# apart, and two teeth that coarse read as a ribbon or a pair of bookmarks,
+# not as a torn receipt. A filled silhouette is not bound by that rule, so the
+# teeth can be small enough to read as a real tear — the "prefer a filled
+# silhouette when a stroked outline reads ambiguously" case.
+#
+# The split is a perforation, not a divider. A full-height divider cuts the
+# silhouette into two separate shapes and the receipt read is lost (the same
+# bookmarks failure); a dotted tear line says "split here" while leaving one
+# intact receipt. Drawn with fill-rule="evenodd" so the dots are true holes,
+# not charcoal-painted ones — icon_foreground and icon_monochrome are rendered
+# on transparency, where a painted hole would show as a blob and, on the
+# monochrome layer, in the wrong colour entirely.
+#
+# Geometry: body x 312..712, y 282..752, six teeth 46px deep off a root at
+# y=706. Four holes of r=30 on the centreline at y=350/446/542/638. Every gap
+# is at the family budget: 36px of accent between holes (96px pitch, 60px
+# diameter), 38px above the first and below the last. Ink is 400x470, inside
+# SAFE_BOX on both axes.
+_RECEIPT_SPLIT = """\
+ """
+
+
+# A dip-pen nib: the character sheet is a thing you write on, and the game is
+# set in the Romantic era, so the nib carries both the app and the period.
+#
+# Filled rather than stroked. A stroked almond outline plus a stroked vent hole
+# leaves only ~20px of charcoal between the two strokes at the family's 72px
+# weight — under MIN_NEGATIVE_SPACE, so the nib fills in solid at 48dp. Filled,
+# the vent and the slit become true holes and the budget is spent on gaps
+# instead of on stroke.
+#
+# A d20 was the obvious alternative and was rejected: this system rolls k6, and
+# a 20-sided outline is a mess of short strokes at launcher size. A front-on
+# die with pips collides with `storage-box` (both read as "boxy thing with
+# marks"). Nothing else in the family is a tall pointed shape.
+#
+# The top edge is flat, not pointed. A symmetric almond — pointed at both ends
+# — with a round hole in the upper half is a map pin, which is exactly what the
+# first draft rendered as. The flat shoulder is where a real nib clips into the
+# holder, and it is what stops the map-pin read.
+#
+# Geometry: shoulder (420,312)-(604,312), waist bowing out to ~x=400/624 around
+# y=456, converging to the tip at (512,812) — ink 224x500, inside SAFE_BOX on
+# both axes. Vent circle r=40 at (512,470) clears the outline by ~61px; the
+# slit stops at y=700, leaving ~41px to the outline near the tip and 70px to
+# the vent above. Every gap is over the 36px budget. fill-rule="evenodd" keeps
+# both holes true holes — icon_foreground and icon_monochrome render on
+# transparency, where a painted hole would show as a blob and in the wrong
+# colour.
+_QUILL_NIB = """\
+ """
+
+
GLYPHS: Final[dict[str, Glyph]] = {
glyph.name: glyph
for glyph in (
@@ -122,6 +192,8 @@ GLYPHS: Final[dict[str, Glyph]] = {
Glyph("checklist", "Two ticked-off list rows", _CHECKLIST),
Glyph("chain-link", "Two interlocking chain links", _CHAIN_LINK),
Glyph("storage-box", "Isometric storage carton", _STORAGE_BOX),
+ Glyph("receipt-split", "Torn receipt with a perforated split", _RECEIPT_SPLIT),
+ Glyph("quill-nib", "Dip-pen nib with vent hole and slit", _QUILL_NIB),
)
}
diff --git a/python_pkg/app_icons/tests/test_registry.py b/python_pkg/app_icons/tests/test_registry.py
index d2676aa7..b21b8cc5 100644
--- a/python_pkg/app_icons/tests/test_registry.py
+++ b/python_pkg/app_icons/tests/test_registry.py
@@ -48,3 +48,19 @@ class TestFamilyInvariants:
def test_safe_box_fits_inside_canvas(self) -> None:
assert style.SAFE_BOX < style.CANVAS
assert style.MIN_NEGATIVE_SPACE == style.STROKE_WIDTH / 2
+
+ def test_no_glyph_paints_the_background_colour(self) -> None:
+ """A hole must be cut, not painted.
+
+ ``icon_foreground`` and ``icon_monochrome`` are rendered on
+ transparency, so a shape filled with ``style.BACKGROUND`` to fake a
+ hole shows up as a charcoal blob on those layers instead of
+ disappearing — and on the monochrome layer, which the system
+ recolours, in the wrong colour entirely. Holes belong in the path as
+ ``fill-rule="evenodd"`` subpaths.
+ """
+ for glyph in glyphs.GLYPHS.values():
+ assert style.BACKGROUND.lower() not in glyph.body.lower(), (
+ f"{glyph.name} paints style.BACKGROUND; cut the hole with "
+ f'fill-rule="evenodd" instead'
+ )
diff --git a/python_pkg/billsplit_coverage/__init__.py b/python_pkg/billsplit_coverage/__init__.py
new file mode 100644
index 00000000..3f7e0065
--- /dev/null
+++ b/python_pkg/billsplit_coverage/__init__.py
@@ -0,0 +1,13 @@
+"""Coverage gate for the ``billsplit/`` Flutter app.
+
+``flutter test --coverage`` reports success while leaving whole files untouched,
+so this package re-reads the lcov report it produces and fails unless every
+``lib/`` file is present *and* fully covered. It lives here rather than beside
+the app because every Python file in this repository belongs under
+``python_pkg/``; the app itself holds only Dart.
+
+Usage:
+ PYTHONPATH=~/testsAndMisc python3 -m python_pkg.billsplit_coverage
+"""
+
+from __future__ import annotations
diff --git a/python_pkg/billsplit_coverage/__main__.py b/python_pkg/billsplit_coverage/__main__.py
new file mode 100644
index 00000000..9e959078
--- /dev/null
+++ b/python_pkg/billsplit_coverage/__main__.py
@@ -0,0 +1,14 @@
+"""Module entry point for the billsplit coverage gate.
+
+Usage:
+ PYTHONPATH=~/testsAndMisc python3 -m python_pkg.billsplit_coverage
+"""
+
+from __future__ import annotations
+
+import sys
+
+from python_pkg.billsplit_coverage.checker import main
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/python_pkg/billsplit_coverage/checker.py b/python_pkg/billsplit_coverage/checker.py
new file mode 100644
index 00000000..d0766712
--- /dev/null
+++ b/python_pkg/billsplit_coverage/checker.py
@@ -0,0 +1,130 @@
+"""Fail unless lcov reports 100% line coverage for every ``billsplit/lib`` file.
+
+Two separate checks, because they catch different mistakes: a file present in
+the report but with unhit lines, and a file missing from the report entirely.
+The second is the one that catches a newly added Dart file nothing imports —
+partial coverage is visible in the report, absence is not.
+
+The default project root is resolved from this file's location rather than the
+working directory, so the CI job can invoke the module from anywhere in the
+repository.
+"""
+
+from __future__ import annotations
+
+import argparse
+import pathlib
+import sys
+from typing import Final
+
+# python_pkg/billsplit_coverage/checker.py -> repo root -> billsplit/
+_DEFAULT_PROJECT: Final[pathlib.Path] = (
+ pathlib.Path(__file__).resolve().parents[2] / "billsplit"
+)
+
+EXIT_INCOMPLETE: Final[int] = 1
+EXIT_NO_REPORT: Final[int] = 2
+
+
+def parse_lcov(lcov: pathlib.Path) -> dict[str, list[int]]:
+ """Map each file in an lcov report to its uncovered line numbers.
+
+ Parameters:
+ lcov (pathlib.Path): Path to an ``lcov.info`` report.
+
+ Returns:
+ dict[str, list[int]]: Source path to the lines with a zero hit count. A
+ fully covered file maps to an empty list, which is what lets the caller
+ tell "covered completely" apart from "absent from the report".
+ """
+ uncovered: dict[str, list[int]] = {}
+ current: str | None = None
+ for line in lcov.read_text(encoding="utf-8").splitlines():
+ if line.startswith("SF:"):
+ # lcov quotes the path verbatim; normalise Windows separators.
+ current = line[3:].replace("\\", "/")
+ uncovered.setdefault(current, [])
+ elif line.startswith("DA:") and current is not None:
+ number, hits = line[3:].split(",")
+ if int(hits) == 0:
+ uncovered[current].append(int(number))
+ return uncovered
+
+
+def find_failures(
+ uncovered: dict[str, list[int]],
+ project: pathlib.Path,
+) -> list[str]:
+ """Describe every coverage gap, as lines ready to print.
+
+ Parameters:
+ uncovered (dict[str, list[int]]): Output of :func:`parse_lcov`.
+ project (pathlib.Path): Flutter project root holding ``lib/``.
+
+ Returns:
+ list[str]: One message per gap; empty when coverage is complete.
+ """
+ failures = [
+ f"{path}: uncovered lines {misses}"
+ for path, misses in sorted(uncovered.items())
+ if misses
+ ]
+ lib_files = {
+ str(path.relative_to(project)).replace("\\", "/")
+ for path in (project / "lib").rglob("*.dart")
+ }
+ failures.extend(
+ f"{path}: not executed by any test (0% coverage)"
+ for path in sorted(lib_files - set(uncovered))
+ )
+ return failures
+
+
+def check(project: pathlib.Path) -> int:
+ """Run the gate for one Flutter project and report to stdout/stderr.
+
+ Parameters:
+ project (pathlib.Path): Flutter project root, i.e. the directory holding
+ ``lib/`` and ``coverage/lcov.info``.
+
+ Returns:
+ int: 0 when coverage is complete, :data:`EXIT_INCOMPLETE` when it is not,
+ :data:`EXIT_NO_REPORT` when the lcov report is missing.
+ """
+ lcov = project / "coverage" / "lcov.info"
+ if not lcov.exists():
+ sys.stderr.write(f"{lcov} missing — run: flutter test --coverage\n")
+ return EXIT_NO_REPORT
+
+ uncovered = parse_lcov(lcov)
+ failures = find_failures(uncovered, project)
+ if failures:
+ sys.stderr.write("COVERAGE < 100%:\n")
+ for failure in failures:
+ sys.stderr.write(f" {failure}\n")
+ return EXIT_INCOMPLETE
+
+ sys.stdout.write(f"100% line coverage across {len(uncovered)} lib files.\n")
+ return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+ """Parse arguments and run the gate.
+
+ Parameters:
+ argv (list[str] | None): Argument list, or None to read ``sys.argv``.
+
+ Returns:
+ int: Process exit status.
+ """
+ parser = argparse.ArgumentParser(
+ description="Fail unless billsplit has 100% line coverage.",
+ )
+ parser.add_argument(
+ "--project",
+ type=pathlib.Path,
+ default=_DEFAULT_PROJECT,
+ help="Flutter project root (defaults to the billsplit/ app in this repo)",
+ )
+ args = parser.parse_args(argv)
+ return check(args.project)
diff --git a/python_pkg/billsplit_coverage/tests/__init__.py b/python_pkg/billsplit_coverage/tests/__init__.py
new file mode 100644
index 00000000..b20c2352
--- /dev/null
+++ b/python_pkg/billsplit_coverage/tests/__init__.py
@@ -0,0 +1,3 @@
+"""Tests for the billsplit coverage gate."""
+
+from __future__ import annotations
diff --git a/python_pkg/billsplit_coverage/tests/test_checker.py b/python_pkg/billsplit_coverage/tests/test_checker.py
new file mode 100644
index 00000000..cba107f0
--- /dev/null
+++ b/python_pkg/billsplit_coverage/tests/test_checker.py
@@ -0,0 +1,191 @@
+"""Tests for the billsplit coverage gate."""
+
+from __future__ import annotations
+
+import runpy
+import sys
+from typing import TYPE_CHECKING
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from python_pkg.billsplit_coverage import checker
+
+if TYPE_CHECKING:
+ import pathlib
+
+
+def make_project(
+ root: pathlib.Path,
+ lcov: str | None = None,
+ dart_files: tuple[str, ...] = ("lib/main.dart",),
+) -> pathlib.Path:
+ """Build a throwaway Flutter project tree.
+
+ Parameters:
+ root (pathlib.Path): Directory to build the project in.
+ lcov (str | None): Contents of ``coverage/lcov.info``; None writes no
+ report at all, which is the missing-report case.
+ dart_files (tuple[str, ...]): Project-relative Dart files to create.
+
+ Returns:
+ pathlib.Path: The project root.
+ """
+ for relative in dart_files:
+ path = root / relative
+ path.parent.mkdir(parents=True, exist_ok=True)
+ path.write_text("void main() {}\n", encoding="utf-8")
+ if lcov is not None:
+ report = root / "coverage" / "lcov.info"
+ report.parent.mkdir(parents=True, exist_ok=True)
+ report.write_text(lcov, encoding="utf-8")
+ return root
+
+
+class TestParseLcov:
+ def test_records_only_unhit_lines(self, tmp_path: pathlib.Path) -> None:
+ report = tmp_path / "lcov.info"
+ report.write_text(
+ "SF:lib/main.dart\nDA:1,3\nDA:2,0\nDA:9,0\nend_of_record\n",
+ encoding="utf-8",
+ )
+ assert checker.parse_lcov(report) == {"lib/main.dart": [2, 9]}
+
+ def test_fully_covered_file_maps_to_empty_list(
+ self, tmp_path: pathlib.Path
+ ) -> None:
+ """Present-and-covered must be distinguishable from absent."""
+ report = tmp_path / "lcov.info"
+ report.write_text("SF:lib/a.dart\nDA:1,1\nend_of_record\n", encoding="utf-8")
+ assert checker.parse_lcov(report) == {"lib/a.dart": []}
+
+ def test_normalises_windows_separators(self, tmp_path: pathlib.Path) -> None:
+ report = tmp_path / "lcov.info"
+ report.write_text("SF:lib\\ui\\home.dart\nDA:1,1\n", encoding="utf-8")
+ assert "lib/ui/home.dart" in checker.parse_lcov(report)
+
+ def test_da_before_any_sf_is_ignored(self, tmp_path: pathlib.Path) -> None:
+ """A DA: line with no preceding SF: has no file to attribute to."""
+ report = tmp_path / "lcov.info"
+ report.write_text("DA:1,0\nSF:lib/a.dart\nDA:2,0\n", encoding="utf-8")
+ assert checker.parse_lcov(report) == {"lib/a.dart": [2]}
+
+ def test_unrelated_lines_are_skipped(self, tmp_path: pathlib.Path) -> None:
+ report = tmp_path / "lcov.info"
+ report.write_text(
+ "TN:\nSF:lib/a.dart\nLF:2\nLH:1\nDA:1,0\nend_of_record\n",
+ encoding="utf-8",
+ )
+ assert checker.parse_lcov(report) == {"lib/a.dart": [1]}
+
+ def test_empty_report_yields_nothing(self, tmp_path: pathlib.Path) -> None:
+ report = tmp_path / "lcov.info"
+ report.write_text("", encoding="utf-8")
+ assert checker.parse_lcov(report) == {}
+
+
+class TestFindFailures:
+ def test_no_gaps_returns_empty(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(tmp_path, lcov="")
+ assert checker.find_failures({"lib/main.dart": []}, project) == []
+
+ def test_reports_uncovered_lines(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(tmp_path, lcov="")
+ failures = checker.find_failures({"lib/main.dart": [2, 7]}, project)
+ assert failures == ["lib/main.dart: uncovered lines [2, 7]"]
+
+ def test_reports_file_absent_from_report(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(
+ tmp_path, lcov="", dart_files=("lib/main.dart", "lib/orphan.dart")
+ )
+ failures = checker.find_failures({"lib/main.dart": []}, project)
+ assert failures == ["lib/orphan.dart: not executed by any test (0% coverage)"]
+
+ def test_reports_both_kinds_together(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(
+ tmp_path, lcov="", dart_files=("lib/main.dart", "lib/orphan.dart")
+ )
+ failures = checker.find_failures({"lib/main.dart": [4]}, project)
+ assert failures == [
+ "lib/main.dart: uncovered lines [4]",
+ "lib/orphan.dart: not executed by any test (0% coverage)",
+ ]
+
+ def test_finds_dart_files_in_subdirectories(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(
+ tmp_path, lcov="", dart_files=("lib/domain/split_engine.dart",)
+ )
+ failures = checker.find_failures({}, project)
+ assert failures == [
+ "lib/domain/split_engine.dart: not executed by any test (0% coverage)"
+ ]
+
+
+class TestCheck:
+ def test_missing_report_exits_two(
+ self, tmp_path: pathlib.Path, capsys: pytest.CaptureFixture[str]
+ ) -> None:
+ project = make_project(tmp_path)
+ assert checker.check(project) == checker.EXIT_NO_REPORT
+ assert "flutter test --coverage" in capsys.readouterr().err
+
+ def test_incomplete_coverage_exits_one_and_names_files(
+ self, tmp_path: pathlib.Path, capsys: pytest.CaptureFixture[str]
+ ) -> None:
+ project = make_project(
+ tmp_path,
+ lcov="SF:lib/main.dart\nDA:1,1\nDA:2,0\n",
+ dart_files=("lib/main.dart", "lib/orphan.dart"),
+ )
+ assert checker.check(project) == checker.EXIT_INCOMPLETE
+ err = capsys.readouterr().err
+ assert "COVERAGE < 100%:" in err
+ assert "lib/main.dart: uncovered lines [2]" in err
+ assert "lib/orphan.dart: not executed by any test" in err
+
+ def test_full_coverage_exits_zero(
+ self, tmp_path: pathlib.Path, capsys: pytest.CaptureFixture[str]
+ ) -> None:
+ project = make_project(tmp_path, lcov="SF:lib/main.dart\nDA:1,1\n")
+ assert checker.check(project) == 0
+ assert "100% line coverage across 1 lib files." in capsys.readouterr().out
+
+
+class TestMain:
+ def test_project_flag_selects_the_tree(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(tmp_path, lcov="SF:lib/main.dart\nDA:1,1\n")
+ assert checker.main(["--project", str(project)]) == 0
+
+ def test_defaults_to_the_repo_billsplit_app(self) -> None:
+ """With no --project, the gate resolves billsplit/ from this file."""
+ with patch.object(checker, "check", return_value=0) as mock_check:
+ assert checker.main([]) == 0
+ assert mock_check.call_args[0][0].name == "billsplit"
+
+ def test_propagates_failure_status(self, tmp_path: pathlib.Path) -> None:
+ project = make_project(tmp_path)
+ assert checker.main(["--project", str(project)]) == checker.EXIT_NO_REPORT
+
+
+class TestModuleEntry:
+ def test_main_called_when_run_as_module(self) -> None:
+ """python3 -m python_pkg.billsplit_coverage runs main() and exits."""
+ mock_main = MagicMock(return_value=0)
+ # runpy warns if __main__ is already imported, and the suite may run in
+ # a random order, so another test could have imported it first.
+ sys.modules.pop("python_pkg.billsplit_coverage.__main__", None)
+ with (
+ patch("python_pkg.billsplit_coverage.checker.main", mock_main),
+ pytest.raises(SystemExit) as excinfo,
+ ):
+ runpy.run_module("python_pkg.billsplit_coverage", run_name="__main__")
+ assert excinfo.value.code == 0
+ mock_main.assert_called_once()
+
+ def test_main_not_called_on_plain_import(self) -> None:
+ """Importing __main__ must not run the gate as a side effect."""
+ mock_main = MagicMock()
+ with patch("python_pkg.billsplit_coverage.checker.main", mock_main):
+ sys.modules.pop("python_pkg.billsplit_coverage.__main__", None)
+ runpy.run_module("python_pkg.billsplit_coverage.__main__")
+ mock_main.assert_not_called()