balatrobot 1.0.0__tar.gz → 1.3.0__tar.gz

balatrobot-1.3.0/.claude/settings.json

@@ -0,0 +1,26 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pytest:*)",
+      "Bash(make:*)"
+    ],
+    "deny": [
+      "Edit(CHANGELOG.md)",
+      "Write(CHANGELOG.md)"
+    ]
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "make quality",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

balatrobot-1.3.0/.github/workflows/commit_lint.yml

@@ -0,0 +1,47 @@
+name: Commit Lint
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  commitizen:
+    name: Validate Commit Messages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Need full history for commit range
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Install dependencies
+        run: |
+          uv venv
+          uv sync --group dev
+
+      - name: Validate commits
+        run: |
+          uv run cz check --rev-range origin/${{ github.base_ref }}..HEAD
+
+      - name: Validate PR title
+        if: github.event_name == 'pull_request'
+        run: |
+          echo "${{ github.event.pull_request.title }}" | uv run cz check

{balatrobot-1.0.0 → balatrobot-1.3.0}/.github/workflows/release_please.yml

@@ -43,6 +43,12 @@ jobs:
           # Update version in balatrobot.json
           jq --arg version "${{ steps.release.outputs.version }}" '.version = $version' balatrobot.json > balatrobot.json.tmp
           mv balatrobot.json.tmp balatrobot.json
+      - name: Update openrpc.json version
+        if: ${{ steps.release.outputs.release_created }}
+        run: |
+          # Update version in openrpc.json
+          jq --arg version "${{ steps.release.outputs.version }}" '.info.version = $version' src/lua/utils/openrpc.json > src/lua/utils/openrpc.json.tmp
+          mv src/lua/utils/openrpc.json.tmp src/lua/utils/openrpc.json
       - name: Commit and push updated lock file
         if: ${{ steps.release.outputs.release_created }}
         run: |
@@ -53,15 +59,15 @@ jobs:
           else
             echo "No changes to uv.lock"
           fi
-      - name: Commit and push updated balatrobot.json
+      - name: Commit and push updated version files
         if: ${{ steps.release.outputs.release_created }}
         run: |
-          if [[ -n $(git status --porcelain balatrobot.json) ]]; then
-            git add balatrobot.json
-            git commit -m "chore(release): update balatrobot.json version to ${{ steps.release.outputs.version }}"
+          if [[ -n $(git status --porcelain balatrobot.json src/lua/utils/openrpc.json) ]]; then
+            git add balatrobot.json src/lua/utils/openrpc.json
+            git commit -m "chore(release): update version files to ${{ steps.release.outputs.version }}"
             git push
           else
-            echo "No changes to balatrobot.json"
+            echo "No changes to version files"
           fi
       - name: Notify consumer repo of new balatrobot release
         if: ${{ steps.release.outputs.release_created }}

balatrobot-1.3.0/.gitignore

@@ -0,0 +1,330 @@
+################################################################################
+# MacOS
+################################################################################
+
+# General
+.DS_Store
+__MACOSX/
+.AppleDouble
+.LSOverride
+Icon[
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+################################################################################
+# Python
+################################################################################
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer,
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+################################################################################
+# Lua
+################################################################################
+
+# Lua Language Server
+.luarc.json
+
+# Compiled Lua sources
+luac.out
+
+# luarocks build files
+*.src.rock
+*.zip
+*.tar.gz
+
+# Object files
+*.o
+*.os
+*.ko
+*.obj
+*.elf
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Libraries
+*.lib
+*.a
+*.la
+*.lo
+*.def
+*.exp
+
+# Shared objects (inc. Windows DLLs)
+*.dll
+*.so
+*.so.*
+*.dylib
+
+# Executables
+*.exe
+*.out
+*.app
+*.i*86
+*.x86_64
+*.hex
+
+################################################################################
+# Other files
+################################################################################
+
+# smods
+smods
+smods.wiki
+
+# lovely dump
+dump
+
+# balatro
+balatro
+*.jkr
+
+# balatrobot
+runs/*.jsonl
+
+################################################################################
+# Legacy files
+################################################################################
+
+src/lua_old
+src/lua_oldish
+
+tests/lua_old
+balatrobot_old.lua
+balatrobot_oldish.lua
+
+balatro_oldish.sh
+balatro.sh

balatrobot-1.3.0/.mux/init

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -e
+
+echo "Runtime: $MUX_RUNTIME"
+echo "Project path: $MUX_PROJECT_PATH"
+echo "Workspace: $PWD"
+
+if [ "$MUX_RUNTIME" = "ssh" ]; then
+  echo "SSH runtime not supported"
+  exit 1
+fi
+
+if [ "$MUX_RUNTIME" != "local" ]; then
+  # Copy .envrc from project root
+  if [ -f "../.envrc" ]; then
+    echo "Copying .envrc from parent..."
+    cp "../.envrc" ".envrc"
+  elif [ -n "$MUX_PROJECT_PATH" ] && [ -f "$MUX_PROJECT_PATH/.envrc" ]; then
+    echo "Copying .envrc from project root..."
+    cp "$MUX_PROJECT_PATH/.envrc" ".envrc"
+  fi
+
+  # Copy .luarc.json for Lua language server
+  if [ -f "../.luarc.json" ]; then
+    echo "Copying .luarc.json from parent..."
+    cp "../.luarc.json" ".luarc.json"
+  elif [ -n "$MUX_PROJECT_PATH" ] && [ -f "$MUX_PROJECT_PATH/.luarc.json" ]; then
+    echo "Copying .luarc.json from project root..."
+    cp "$MUX_PROJECT_PATH/.luarc.json" ".luarc.json"
+  fi
+else
+  echo "Local mode: using existing config files"
+fi
+
+echo "Setting up Python environment..."
+uv sync --group dev --group test
+
+if [ -f ".envrc" ]; then
+  echo "Sourcing .envrc..."
+  source .envrc
+fi
+
+echo "Init complete!"

balatrobot-1.3.0/.mux/mcp.jsonc

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "context7": {
+      "transport": "http",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": {
+          "secret": "CONTEXT7_API_KEY"
+        }
+      }
+    }
+  }
+}

balatrobot-1.3.0/.mux/tool_env

@@ -0,0 +1,5 @@
+# Sourced before every bash tool call
+# Activate venv and load environment variables
+
+source .venv/bin/activate 2>/dev/null || true
+source .envrc 2>/dev/null || true

balatrobot-1.3.0/.mux/tool_post

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Runs after every tool execution
+
+# Run quality checks after Python or Lua file edits
+if [[ "$MUX_TOOL" == file_edit_* ]]; then
+  file=$(echo "$MUX_TOOL_INPUT" | jq -r '.file_path')
+
+  if [[ "$file" == *.py ]] || [[ "$file" == *.lua ]]; then
+    echo "Running quality checks..." >&2
+    make quality 2>&1 || exit 1
+  fi
+fi

{balatrobot-1.0.0 → balatrobot-1.3.0}/CHANGELOG.md

@@ -1,5 +1,95 @@
 # Changelog
 
+## [1.3.0](https://github.com/coder/balatrobot/compare/v1.2.2...v1.3.0) (2026-01-06)
+
+
+### Features
+
+* **lua:** improve logging for endpoints ([680fd45](https://github.com/coder/balatrobot/commit/680fd45c2711c58a461c51cab04e42e5be0fb767))
+
+
+### Documentation
+
+* **cli:** remove resize rule in hyperland config example ([ace84b5](https://github.com/coder/balatrobot/commit/ace84b59db8eb7a5051843adbad0f9dbd86fb32e))
+* update deps and style of the docs ([784b780](https://github.com/coder/balatrobot/commit/784b780ce6c51cbd57e6694b624a75add9aa7df0))
+
+## [1.2.2](https://github.com/coder/balatrobot/compare/v1.2.1...v1.2.2) (2026-01-04)
+
+
+### Documentation
+
+* **contributing:** add linux native symlink location ([d07c354](https://github.com/coder/balatrobot/commit/d07c35430ef9ea438c11fa22abc82703ef92f5f8))
+* **example-bot:** add example bot page ([73c4313](https://github.com/coder/balatrobot/commit/73c431325877dd38e2b43f67a7ac275da5239ba9))
+* prepend `uvx` to balatrobot command ([e9e48e1](https://github.com/coder/balatrobot/commit/e9e48e1b97fcda33f15e174d8acc926387b17027))
+
+## [1.2.1](https://github.com/coder/balatrobot/compare/v1.2.0...v1.2.1) (2026-01-01)
+
+
+### Bug Fixes
+
+* **ci:** update release workflow to sync openrpc.json version ([905609f](https://github.com/coder/balatrobot/commit/905609fbf0c72983a63bfabc8fce09825650f311))
+
+
+### Documentation
+
+* **contributing:** update .luarc.json example ([c9c486a](https://github.com/coder/balatrobot/commit/c9c486a4bd6c660bf0feb4a54175d55f69128df1))
+* use white logo version for docs logo ([e532087](https://github.com/coder/balatrobot/commit/e5320870f08b93191de35b4d57ab5dd501b50dd4))
+
+## [1.2.0](https://github.com/coder/balatrobot/compare/v1.1.0...v1.2.0) (2026-01-01)
+
+
+### Features
+
+* **lua.endpoints:** add `pack` endpoint ([32ff3eb](https://github.com/coder/balatrobot/commit/32ff3eb1aae56f81b78070c7d4b080987a29aea1))
+* **lua.endpoints:** add pack endpoint ([9d3031f](https://github.com/coder/balatrobot/commit/9d3031f9405145d608848eacab0d6aa90aba0f2c))
+* **lua.endpoints:** add support for adding packs to the `add` endpoint ([41374a7](https://github.com/coder/balatrobot/commit/41374a718a1616b1e7e5298a510cac27de624771))
+* **lua.endpoints:** allow rearranging cards during booster pack state ([16e4170](https://github.com/coder/balatrobot/commit/16e417074beaa006f71d34d809d7c7f1248971f5))
+* **lua.endpoints:** extend rearrange to pack state ([15f282c](https://github.com/coder/balatrobot/commit/15f282c870e771970ddef3cb2ceca8a29eee1649))
+* **lua.utils:** add `cards` field to gamestate ([8447855](https://github.com/coder/balatrobot/commit/8447855365c08db38cd555810ea92d6cf0098ff8))
+* **lua.utils:** add pack keys enums ([d8cdb33](https://github.com/coder/balatrobot/commit/d8cdb335331332be2b0c2c64bdfbee8f1b10d602))
+
+
+### Bug Fixes
+
+* **lua.endpoints:** await hand to be loaded for Arcana/Spectral packs ([43e41a4](https://github.com/coder/balatrobot/commit/43e41a46f94718996a8f2d8f8b960148471f9cda))
+* **lua.endpoints:** improve await condition when buying a pack ([4993e77](https://github.com/coder/balatrobot/commit/4993e776d8fbcad138eaff63ac463818e8f0102f))
+* **lua.utils:** use appropriate field for the request in debugger ([d79a81d](https://github.com/coder/balatrobot/commit/d79a81d881f64f41293ac5d63ba23d916a29deab))
+* **lua:** fix target selection to wait longer ([e98d4ea](https://github.com/coder/balatrobot/commit/e98d4ea7c5f6673d2e5b397c2eb5fdbc75b7bd04))
+* **validator:** revert to old behaviour for array items ([729e164](https://github.com/coder/balatrobot/commit/729e164105a221c5233255ba6b09a91fae2fb2f5))
+
+
+### Performance Improvements
+
+* change pytest-xdist config from loadfile to loadscope ([d7c2a28](https://github.com/coder/balatrobot/commit/d7c2a289f61ea748778dfe83d94ffcf15767cbd0))
+
+
+### Documentation
+
+* add conventional commits guideline to contributing ([bf164b1](https://github.com/coder/balatrobot/commit/bf164b12a58de69826efc1929db9ed6ab6c7ad87))
+* **api:** add required state for rearrange endpoint ([481d579](https://github.com/coder/balatrobot/commit/481d579ae3c610320e13937eeadcbd45de554cb8))
+* **api:** fix api.md formatting ([4c85dec](https://github.com/coder/balatrobot/commit/4c85decdb9598433ac7295650181aad0b51cd92e))
+* **api:** remove comment from the gamestate example ([44a169f](https://github.com/coder/balatrobot/commit/44a169f1d9c28b96fc20108efe508bc558a86e56))
+* **api:** update the `add` endpoint to support packs ([36868f2](https://github.com/coder/balatrobot/commit/36868f27d1c8c6871580f6c6a20e60b5d278a194))
+* **CLAUDE:** add GitHub repo link to CLAUDE.md ([9013de0](https://github.com/coder/balatrobot/commit/9013de0b30ce5db957cee7833c81f764604b4103))
+* docs fixes ([099147a](https://github.com/coder/balatrobot/commit/099147aaaffd99e516844f90b4f0b721927f128a))
+* **endpoints:** fix pack_select formatting ([535e3b0](https://github.com/coder/balatrobot/commit/535e3b00b45f658680383e278ec887fca566a90b))
+* **endpoints:** fix pack_select formatting ([7c0535c](https://github.com/coder/balatrobot/commit/7c0535c5bf93e87ec54da4c326fe42ce91c7e296))
+
+## [1.1.0](https://github.com/coder/balatrobot/compare/v1.0.0...v1.1.0) (2025-12-24)
+
+
+### Features
+
+* **balatrobot:** add Windows support to CLI ([843a1b7](https://github.com/coder/balatrobot/commit/843a1b7b6dbf049a1cc1d1510714519d642aa0c2))
+
+
+### Documentation
+
+* **cli:** `run_lovely_macos.sh` is not required ([ccf1996](https://github.com/coder/balatrobot/commit/ccf1996fe9e960ed10e25b783500ae3b806debfd))
+* **contributing:** improve contributing guide ([d5576b2](https://github.com/coder/balatrobot/commit/d5576b2c50da5f5488c1cca1c0e5cf3f61025408))
+* **index:** remove link to legacy docs ([23029cd](https://github.com/coder/balatrobot/commit/23029cd0b8bdbe33f7ed41c02c9aed8e37da837d))
+* **readme:** remove the imgs from the related project section ([354de3a](https://github.com/coder/balatrobot/commit/354de3a2f2966dcd98e5c62751b740804d5b1afb))
+
 ## 1.0.0 (2025-12-23)
 
 

{balatrobot-1.0.0 → balatrobot-1.3.0}/CLAUDE.md

@@ -2,6 +2,8 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+**GitHub Repository**: [`coder/balatrobot`](https://github.com/coder/balatrobot)
+
 ## Overview
 
 BalatroBot is a framework for Balatro bot development. It consists of two main parts:
@@ -37,6 +39,31 @@ pytest tests/cli -m "not integration"
 balatrobot --fast --debug
 ```
 
+### Make Commands
+
+Available make targets:
+
+| Target           | Description                                             |
+| ---------------- | ------------------------------------------------------- |
+| `make help`      | Show all available targets                              |
+| `make lint`      | Run ruff linter (check only)                            |
+| `make format`    | Run ruff and mdformat formatters                        |
+| `make typecheck` | Run type checker (Python and Lua)                       |
+| `make quality`   | Run all code quality checks (lint + typecheck + format) |
+| `make test`      | Run all tests                                           |
+| `make all`       | Run all quality checks and tests                        |
+| `make fixtures`  | Generate test fixtures                                  |
+| `make install`   | Install dependencies                                    |
+
+**Important rules:**
+
+1. **Only run make commands when explicitly asked.** Do not proactively run `make test`, `make quality`, etc.
+2. **Never run bare linting/formatting/typechecking tools.** Always use make targets instead:
+    - Use `make lint` instead of `ruff check`
+    - Use `make format` instead of `ruff format`
+    - Use `make typecheck` instead of `ty check`
+    - Use `make quality` for all checks combined
+
 ## Architecture
 
 ### 1. Python Layer (`src/balatrobot/`)
@@ -46,6 +73,7 @@ Controls the game lifecycle and provides the CLI.
 - **CLI** (`cli.py`): Entry point (`balatrobot`). Handles arguments like `--fast`, `--debug`, `--headless`.
 - **Manager** (`manager.py`): `BalatroInstance` context manager. Starts the game process, handles logging, and waits for the API to be healthy.
 - **Config** (`config.py`): Configuration management using `dataclasses` and environment variables.
+- **Platform Abstraction** (`platforms/`): Cross-platform game launcher system with platform-specific implementations for macOS, Windows, and native Love2D.
 
 ### 2. Lua Layer (`src/lua/`)
 
@@ -72,11 +100,12 @@ Runs inside the game engine and exposes an API.
 
     - Stateless modules defining `schema` and `execute` functions.
     - 0-based indexing in API vs 1-based in Lua.
+    - OpenRPC Specification (`src/lua/utils/openrpc.json`): Machine-readable API documentation describing all endpoints.
 
     **Core Endpoints:**
 
-    - `add.lua`: Add a new card (joker, consumable, voucher, or playing card).
-    - `buy.lua`: Buy a card from the shop.
+    - `add.lua`: Add a new card (joker, consumable, voucher, playing card, or booster pack).
+    - `buy.lua`: Buy a card or booster pack from the shop.
     - `cash_out.lua`: Cash out and collect round rewards.
     - `discard.lua`: Discard cards from the hand.
     - `gamestate.lua`: Get current game state.
@@ -84,6 +113,7 @@ Runs inside the game engine and exposes an API.
     - `load.lua`: Load a saved run state from a file.
     - `menu.lua`: Return to the main menu from any game state.
     - `next_round.lua`: Leave the shop and advance to blind selection.
+    - `pack.lua`: Select or skip a card from an opened booster pack.
     - `play.lua`: Play a card from the hand.
     - `rearrange.lua`: Rearrange cards in hand, jokers, or consumables.
     - `reroll.lua`: Reroll to update the cards in the shop area.