bipp-budgetcode: budgetcode als dropdown in de winkelmandjerij zelf

BIPP zet de analytische velden op een aparte pagina, dus je moest het mandje verlaten om
een budgetcode te kiezen en je zag achteraf niet welke er stond. Dit script zet de code
als dropdown onder de grootboekrekening in de rij zelf, slaat op via een
achtergrond-postback en vult de code aan in Interne commentaar.

De 5553 codes staan onder "alle budgetcodes", met bovenaan een groep "recent" met de
laatste 8 keuzes uit localStorage. Die groep is data-removable, dus een code die je één
keer per ongeluk koos haal je er met Delete weer uit; select-search stuurt het event, dit
script wist de code uit de MRU en bouwt de groepen opnieuw op.

Status staat als icoontje van 12px in een vak dat er altijd is, op de regel van de link
Bekijk, zodat er nooit iets verschuift. Zandloper met grijze tekst zolang de keten loopt,
en daarna gewoon weer zwart: geen vinkje, want de zwarte tekst is de bevestiging al. Bij
een fout een rood uitroepteken met rode rand en de waarde teruggedraaid, zodat de
oorspronkelijke pagina bereikbaar blijft.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

scripts/bipp-budgetcode/README.md

@@ -0,0 +1,84 @@
+# bipp-budgetcode
+
+Zet de budgetcode als dropdown in de rij van het winkelmandje zelf, net onder de
+grootboekrekening. Geen omweg meer langs *Selectie analytische velden*, en je ziet ook gewoon
+staan welke code een artikel heeft.
+
+BIPP verbergt die code vandaag volledig: na *Creëer*, kiezen, *Opslaan* en *Terug* zegt de rij
+alleen nog `Bekijk`, in het groen, en die kleur blijft ook staan als de code weer leeg is. De
+gekozen waarde zit wel al in de pagina, maar alleen als tooltip op die link.
+
+[**Installeren**](https://raw.githubusercontent.com/glgoose/ua-userscripts/main/scripts/bipp-budgetcode/bipp-budgetcode.user.js)
+· gebeurt er niets, zie de [installatie-uitleg](../../README.md).
+
+## Gebruik
+
+- Kies de budgetcode in de dropdown onder de grootboekrekening. De pagina blijft staan waar ze
+  staat.
+- Zoeken in die lijst van ruim vijfduizend codes gaat via
+  [select-search](../select-search/README.md), dat op dezelfde pagina meeloopt.
+- Bovenaan de lijst staan onder *recent* de codes die je het laatst gebruikt hebt. Die
+  staan verderop niet nog een keer: elke code komt maar één keer in de lijst voor.
+- Is de grootboekrekening ook gekozen, dan komt de code in **Interne commentaar** te staan.
+  Stond daar al iets, dan komt ze op een nieuwe regel eronder. Kies je daarna een andere code,
+  dan wordt die regel vervangen in plaats van dat er een bijkomt.
+- Is er nog niets gekozen, dan staat er grijs `budgetcode` in het veld. Dat is een
+  placeholder, geen waarde, en hij staat niet als regel in de lijst.
+- Wissen doe je met het kruisje rechts in het veld. Zodra er een code staat en je met de muis
+  over het veld gaat of erin staat, neemt dat kruisje de plek van het pijltje in. Backspace in
+  een leeg veld doet hetzelfde. Dat haalt ook de regel uit Interne commentaar weg.
+- Een code uit *recent* halen: open de lijst, ga met de pijltjes of de muis op die regel staan
+  en druk `Delete`, zolang je nog niets getypt hebt. De code staat daarna weer gewoon onder *alle
+  budgetcodes*. Kies je hem later opnieuw, dan komt hij vanzelf terug bovenaan.
+- De link *Creëer* / *Bekijk* blijft staan als uitweg.
+
+De status staat als klein icoontje rechts op de regel van die link, zodat er nooit iets
+verschuift:
+
+- **Zandloper, tekst grijs**: bezig met opslaan. Een nieuwe keuze wordt zolang genegeerd.
+- **Geen icoontje, tekst weer zwart**: opgeslagen. Er komt geen vinkje bij, de zandloper gaat
+  gewoon weg. Dat de tekst weer zwart is, is de bevestiging.
+- **Uitroepteken, rode rand**: niet opgeslagen, de waarde is teruggedraaid.
+
+De volledige melding staat in de tooltip van het icoontje en van de dropdown.
+
+## Hoe het opslaat
+
+Kiezen in de dropdown doet in de achtergrond precies wat je anders met de hand doet: de postback
+naar de selectorpagina, *Opslaan*, en *Terug*. Het script controleert in het antwoord of de
+server de waarde echt geselecteerd heeft en verwisselt daarna `__VIEWSTATE`, `__EVENTVALIDATION`
+en `__VIEWSTATEGENERATOR` in de live pagina, zodat een gewone postback erna blijft werken.
+
+Omdat het live formulier meegestuurd wordt, gaat niet-opgeslagen typwerk (aantal, commentaar)
+niet verloren: dat wordt door de eerste stap zelfs meteen mee gecommit. Het verkeer per keuze is
+hetzelfde als dat van de drie handmatige stappen.
+
+## Beperkingen
+
+- **De groene link blijft groen.** Dat komt van BIPP zelf en is niet betrouwbaar. De dropdown is
+  de bron van waarheid.
+- **De optielijst wordt gecached** in `localStorage`, per participant, zeven dagen. De eerste
+  keer duurt het kiezen een moment langer omdat de lijst dan opgehaald wordt.
+- **Na een mislukte poging** klopt de dropdown weer, maar de server kan de tussenliggende
+  commentaarregel nog vasthouden: de eerste stap van de keten commit het formulier, de latere
+  stap is degene die faalde. De eerstvolgende geslaagde keuze zet dat recht, want die stuurt het
+  formulier opnieuw mee.
+- **Meer dan één analytisch veld** wordt niet inline aangeboden. De selectorpagina is een
+  repeater; verschijnt er ooit een tweede veld, dan valt het script voor die rij terug op de
+  link.
+
+## Ontwikkelen
+
+Eén bestand, geen build, geen dependencies. Hoog `@version` op bij elke wijziging, anders krijgt
+niemand de update binnen.
+
+Tijdens het ontwikkelen laad je het script via een dev-stub in plaats van een geplakte kopie,
+zie [Ontwikkelen](../../README.md#ontwikkelen).
+
+```sh
+node --check bipp-budgetcode.user.js
+```
+
+## Licentie
+
+[GPL-3.0-or-later](../../LICENSE).