# JailDoctor's Dilemma - Console Commands
# Metadata for the in-game console command system.
# Execution logic stays in C++; this file defines metadata only.
#
# Fields:
#   keyword          - Command name (uppercase)
#   handler          - C++ handler function identifier
#   description      - Short description for help output
#   usage            - Full usage string for terminal help
#   instant          - (optional) Skip typewriter effect (default: false)
#   hidden           - (optional) Hide from TAB completion (default: false)
#   debug_only       - (optional) Only available in debug builds (default: false)
#   help_hidden      - (optional) Don't show in help output (default: false)
#   dynamic_completions - (optional) Completions generated at runtime (default: false)
#   completions      - (optional) Static TAB completion tree
#   debug_extras     - (optional) Overrides applied in debug builds

categories:
  - name: VIDEO
    commands:
      - keyword: SS
        handler: cmd_ss
        description: Supersampling
        usage: "SS [ON|OFF|SIZE|UPSCALE [NEAREST|LINEAR]|DOWNSCALE [BILINEAR|LANCZOS2|LANCZOS3]]"
        completions:
          SS: [ON, OFF, SIZE, UPSCALE, DOWNSCALE]
          SS UPSCALE: [NEAREST, LINEAR]
          SS DOWNSCALE: [BILINEAR, LANCZOS2, LANCZOS3]

      - keyword: SHADER
        handler: cmd_shader
        description: "Toggle/select shader (F4)"
        usage: "SHADER [ON|OFF|NEXT|POSTFX|CRTPI|PRESET [NEXT|PREV|<name>]]"
        completions:
          SHADER: [ON, OFF, NEXT, POSTFX, CRTPI, PRESET]
        dynamic_completions: true

      - keyword: BORDER
        handler: cmd_border
        description: "Decorative border (B)"
        usage: "BORDER [ON|OFF]"
        completions:
          BORDER: [ON, OFF]

      - keyword: FULLSCREEN
        handler: cmd_fullscreen
        description: "Fullscreen mode (F3)"
        usage: "FULLSCREEN [ON|OFF]"
        completions:
          FULLSCREEN: [ON, OFF]

      - keyword: ZOOM
        handler: cmd_zoom
        description: "Window zoom (F1/F2)"
        usage: "ZOOM [UP|DOWN|<1-N>]"
        completions:
          ZOOM: [UP, DOWN]

      - keyword: INTSCALE
        handler: cmd_intscale
        description: "Integer scaling (F7)"
        usage: "INTSCALE [ON|OFF]"
        completions:
          INTSCALE: [ON, OFF]

      - keyword: VSYNC
        handler: cmd_vsync
        description: "Vertical sync"
        usage: "VSYNC [ON|OFF]"
        completions:
          VSYNC: [ON, OFF]

      - keyword: DRIVER
        handler: cmd_driver
        description: "GPU driver (restart to apply)"
        usage: "DRIVER [LIST|AUTO|NONE|<name>]"
        completions:
          DRIVER: [LIST, AUTO, NONE]

      - keyword: PALETTE
        handler: cmd_palette
        description: "Color palette (F5/F6)"
        usage: "PALETTE [NEXT|PREV|<name>]"
        dynamic_completions: true

  - name: AUDIO
    commands:
      - keyword: AUDIO
        handler: cmd_audio
        description: Audio master
        usage: "AUDIO [ON|OFF|VOL <0-100>]"
        completions:
          AUDIO: [ON, OFF, VOL]

      - keyword: MUSIC
        handler: cmd_music
        description: Music volume
        usage: "MUSIC [ON|OFF|VOL <0-100>]"
        completions:
          MUSIC: [ON, OFF, VOL]

      - keyword: SOUND
        handler: cmd_sound
        description: Sound volume
        usage: "SOUND [ON|OFF|VOL <0-100>]"
        completions:
          SOUND: [ON, OFF, VOL]

  - name: GAME
    commands:
      - keyword: SET
        handler: cmd_set
        description: "Change player skin"
        usage: "SET PLAYER SKIN <1|2>"
        completions:
          SET: [PLAYER]
          SET PLAYER: [SKIN]
        debug_extras:
          description: "Set player/debug options"
          usage: "SET PLAYER SKIN <1|2> | SET INITIAL [ROOM|POS|SCENE] | SET ITEMS <0-200>"
          completions:
            SET: [PLAYER, INITIAL, ITEMS]
            SET PLAYER: [SKIN]
            SET INITIAL: [ROOM, POS, SCENE]
            SET INITIAL SCENE: [LOGO, LOADING, TITLE, CREDITS, GAME, ENDING, ENDING2]

      - keyword: RESTART
        handler: cmd_restart
        description: Restart from the beginning
        usage: RESTART
        instant: true

      - keyword: KIOSK
        handler: cmd_kiosk
        description: Enable kiosk mode
        usage: "KIOSK [ON]"
        completions:
          KIOSK: [ON]

      - keyword: EXIT
        handler: cmd_exit
        description: Quit application
        usage: EXIT
        instant: true

      - keyword: QUIT
        handler: cmd_quit
        description: Quit application
        usage: QUIT
        instant: true
        help_hidden: true

  - name: INFO
    commands:
      - keyword: SHOW
        handler: cmd_show
        description: Show info overlay
        usage: "SHOW [INFO]"
        completions:
          SHOW: [INFO]
        debug_extras:
          description: "Show overlay/test notification"
          usage: "SHOW [INFO|NOTIFICATION|CHEEVO]"
          completions:
            SHOW: [INFO, NOTIFICATION, CHEEVO]

      - keyword: HIDE
        handler: cmd_hide
        description: Hide info overlay
        usage: "HIDE [INFO]"
        completions:
          HIDE: [INFO]

      - keyword: SIZE
        handler: cmd_size
        description: Window size in pixels
        usage: SIZE

      - keyword: HELP
        handler: cmd_help
        description: "Show this help"
        usage: "HELP / ?"

      - keyword: "?"
        handler: cmd_help
        help_hidden: true

  - name: DEBUG
    debug_only: true
    commands:
      - keyword: DEBUG
        handler: cmd_debug
        description: "Toggle debug overlay (F12)"
        usage: "DEBUG [ON|OFF]"
        completions:
          DEBUG: [ON, OFF]

      - keyword: ROOM
        handler: cmd_room
        description: "Change to room number (GAME only)"
        usage: "ROOM <1-60>|NEXT|PREV"
        completions:
          ROOM: [NEXT, PREV]

      - keyword: SCENE
        handler: cmd_scene
        description: Change scene
        usage: "SCENE [LOGO|LOADING|TITLE|CREDITS|GAME|ENDING|ENDING2|RESTART]"
        completions:
          SCENE: [LOGO, LOADING, TITLE, CREDITS, GAME, ENDING, ENDING2, RESTART]

  - name: CHEATS
    commands:
      - keyword: CHEAT
        handler: cmd_cheat
        description: "Game cheats (GAME only)"
        usage: "CHEAT [INFINITE LIVES|INVINCIBILITY|OPEN THE JAIL|CLOSE THE JAIL]"
        hidden: true
        completions:
          CHEAT: [INFINITE, INVINCIBILITY, OPEN, CLOSE]
          CHEAT INFINITE: [LIVES]
          CHEAT INFINITE LIVES: [ON, OFF]
          CHEAT INVINCIBILITY: [ON, OFF]
          CHEAT OPEN: [THE]
          CHEAT OPEN THE: [JAIL]
          CHEAT CLOSE: [THE]
          CHEAT CLOSE THE: [JAIL]
        debug_extras:
          hidden: false