feat(ludic.inventory, ludic.wallet): the pack and the purse as mechanic packages

ludic.inventory: counts per item kind, a PackRules port (stack_limit), add
what fits / take all or none / set outright, an ItemChanged queue, and a save
section keyed by item NAME so a game can reorder its items with no migration.
ludic.wallet: earn, spend only what is there, lose down to zero, set, a
MoneyChanged queue and its own save section. Six and five test blocks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Orkun ÇAKILKAYA 2026-09-25 04:29:17 +03:00
parent 6cfaaf0bf9
commit 8075892e0e
12 changed files with 445 additions and 0 deletions

View file

@ -0,0 +1,29 @@
# ludic.wallet
Money carried, in whole units: earned, spent only when it is there, lost when a cost happens
anyway, and every change reported. Uses [`ludic.base`](../ludic.base/README.md) and nothing
else. Prices, reputation and what a thing costs are the game's; the wallet only holds the money.
```ludic
import "ludic.wallet"
```
No ports: the wallet asks the world nothing.
## API
| | |
| --- | --- |
| `wallet_money()`, `wallet_can(n)` | what is there, and whether `n` is |
| `wallet_earn(n)` | add |
| `wallet_spend(n) -> bool` | only what is there: false, and nothing spent, when it is not |
| `wallet_lose(n)` | a cost that happens whether or not it can be paid (a rescue); never below zero |
| `wallet_set(n)` | exactly `n` (a starting purse, a correction, the network's word) |
| `wallet_changes() -> Queue<MoneyChanged>` | the facts: `{ before, after }`, one per change |
| `wallet_system() -> System` | `"wallet"`, `PH_COMMIT`: reset, and its save section (`wallet_save`, `wallet_load`) |
## Tests
```bash
ludic build packages/ludic.wallet/tests/wallet_test.ludic --headless -o /tmp/wallet_test && /tmp/wallet_test
```