package.json

{
  "name": "mpftp",
  "displayName": "mpftp — MicroPython / CircuitPython Board Tools",
  "description": "Connect to MicroPython and CircuitPython boards over USB serial: dual-pane file transfer, ANSI REPL, mip/circup packages, and guided MicroPython firmware download/build/flash. Works on Linux, Windows, and WSL (COM ports via Windows Python).",
  "version": "0.0.1",
  "publisher": "pydevices",
  "license": "MIT",
  "engines": {
    "vscode": "^1.85.0"
  },
  "categories": [
    "Other",
    "Debuggers"
  ],
  "keywords": [
    "micropython",
    "circuitpython",
    "mpremote",
    "circup",
    "repl",
    "serial",
    "ftp",
    "embedded",
    "esp32",
    "firmware"
  ],
  "activationEvents": [
    "onStartupFinished"
  ],
  "main": "./out/extension.js",
  "contributes": {
    "commands": [
      {
        "command": "mpftp.connect",
        "title": "mpftp: Connect to Board",
        "icon": "$(plug)"
      },
      {
        "command": "mpftp.disconnect",
        "title": "mpftp: Disconnect",
        "icon": "$(debug-disconnect)"
      },
      {
        "command": "mpftp.resume",
        "title": "mpftp: Resume Last Device",
        "icon": "$(debug-restart)"
      },
      {
        "command": "mpftp.openFtp",
        "title": "mpftp: Open File Transfer in Panel",
        "icon": "$(layout-panel)"
      },
      {
        "command": "mpftp.openFtpEditor",
        "title": "mpftp: Open File Transfer in Editor",
        "icon": "$(window)"
      },
      {
        "command": "mpftp.openRepl",
        "title": "mpftp: Open REPL",
        "icon": "$(terminal)"
      },
      {
        "command": "mpftp.openFirmware",
        "title": "mpftp: Build & Flash Firmware…",
        "icon": "$(chip)"
      },
      {
        "command": "mpftp.editRemote",
        "title": "mpftp: Edit Board File"
      },
      {
        "command": "mpftp.interrupt",
        "title": "mpftp: Interrupt (Ctrl+C)"
      },
      {
        "command": "mpftp.softReset",
        "title": "mpftp: Soft Reset (skip main.py)"
      },
      {
        "command": "mpftp.softReboot",
        "title": "mpftp: Soft Reboot (run main.py / code.py)"
      },
      {
        "command": "mpftp.hardReset",
        "title": "mpftp: Hard Reset"
      },
      {
        "command": "mpftp.bootloader",
        "title": "mpftp: Enter Bootloader"
      },
      {
        "command": "mpftp.runFile",
        "title": "mpftp: Run Editor Buffer",
        "icon": "$(play)"
      },
      {
        "command": "mpftp.eval",
        "title": "mpftp: Eval Expression"
      },
      {
        "command": "mpftp.exec",
        "title": "mpftp: Exec Code"
      },
      {
        "command": "mpftp.rtcGet",
        "title": "mpftp: Get RTC"
      },
      {
        "command": "mpftp.rtcSet",
        "title": "mpftp: Set RTC from Host"
      },
      {
        "command": "mpftp.installPackage",
        "title": "mpftp: Install Package"
      },
      {
        "command": "mpftp.mipInstall",
        "title": "mpftp: mip Install Package"
      },
      {
        "command": "mpftp.circupInstall",
        "title": "mpftp: circup Install Package"
      },
      {
        "command": "mpftp.df",
        "title": "mpftp: Disk Free (df)"
      },
      {
        "command": "mpftp.mount",
        "title": "mpftp: Mount Local Folder (/remote)"
      },
      {
        "command": "mpftp.umount",
        "title": "mpftp: Unmount /remote"
      },
      {
        "command": "mpftp.romfsQuery",
        "title": "mpftp: ROMFS Query"
      },
      {
        "command": "mpftp.hashRemote",
        "title": "mpftp: Hash Board File"
      },
      {
        "command": "mpftp.refreshPorts",
        "title": "mpftp: Refresh Serial Ports"
      },
      {
        "command": "mpftp.agentStatus",
        "title": "mpftp: Agent Status (RPC / logs)"
      }
    ],
    "menus": {
      "editor/title/run": [
        {
          "command": "mpftp.runFile",
          "when": "resourceExtname == .py && mpftp.connected",
          "group": "navigation"
        }
      ],
      "commandPalette": [
        {
          "command": "mpftp.disconnect",
          "when": "mpftp.connected"
        },
        {
          "command": "mpftp.mipInstall",
          "when": "false"
        },
        {
          "command": "mpftp.circupInstall",
          "when": "false"
        }
      ]
    },
    "viewsContainers": {
      "panel": [
        {
          "id": "mpftp-file-transfer",
          "title": "File Transfer",
          "icon": "resources/mpftp.svg"
        }
      ]
    },
    "views": {
      "mpftp-file-transfer": [
        {
          "type": "webview",
          "id": "mpftp.fileTransferView",
          "name": "File Transfer",
          "visibility": "visible"
        }
      ]
    },
    "configuration": {
      "title": "mpftp",
      "properties": {
        "mpftp.pythonPath": {
          "type": "string",
          "default": "",
          "description": "Python interpreter that has mpremote (and circup for CircuitPython packages) installed. On WSL, leave empty to auto-use Windows python.exe so COM ports work."
        },
        "mpftp.mpremotePath": {
          "type": "string",
          "default": "",
          "description": "Optional path to mpremote / mpremote.exe (used for port listing fallback and diagnostics)."
        },
        "mpftp.defaultBaud": {
          "type": "number",
          "default": 115200,
          "description": "Serial baud rate."
        },
        "mpftp.autoConnectDevice": {
          "type": "string",
          "default": "",
          "description": "Auto-connect device path (e.g. COM4 or /dev/ttyACM0). Empty disables auto-connect."
        },
        "mpftp.verifyTransfers": {
          "type": "boolean",
          "default": true,
          "description": "After each file upload/download, verify with SHA-256 against the board."
        },
        "mpftp.autoReconnectAfterReset": {
          "type": "boolean",
          "default": true,
          "description": "After hard reset, wait for the same COM port and reconnect automatically."
        },
        "mpftp.openEditorOnConnect": {
          "type": "boolean",
          "default": true,
          "description": "When a board connects, open File Transfer as an editor tab and the REPL terminal (skipped for silent reconnects)."
        },
        "mpftp.workspacePath": {
          "type": "string",
          "default": "",
          "description": "Firmware workspace: folder that contains micropython/ (or is the MicroPython tree). Port SDKs may live here as directories or symlinks, or via environment variables."
        },
        "mpftp.micropythonPath": {
          "type": "string",
          "default": "",
          "description": "Override path to the MicroPython checkout (ports/ + py/). Leave empty to resolve from the firmware workspace, MP_DIR, or ~/micropython."
        },
        "mpftp.idfPath": {
          "type": "string",
          "default": "",
          "description": "Override path to ESP-IDF (export.sh). Leave empty to use IDF_PATH / IDF_DIR or an esp-idf directory/symlink under the firmware workspace."
        },
        "mpftp.emsdkPath": {
          "type": "string",
          "default": "",
          "description": "Override path to emsdk (emsdk_env.sh). Leave empty to use EMSDK / EMSDK_DIR or an emsdk directory/symlink under the firmware workspace."
        },
        "mpftp.toolchainBins": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "default": [],
          "description": "Extra cross-toolchain bin/ folders prepended to the build PATH (e.g. arm-none-eabi, xtensa, riscv, xc16, mingw-w64). Populated when you locate a missing toolchain from the build prompt; edit here to add more."
        },
        "mpftp.buildPythonPath": {
          "type": "string",
          "default": "",
          "description": "Python used to run the firmware build engine and make. On WSL this must be a native Linux python3. Leave empty to auto-detect."
        },
        "mpftp.esptoolCommand": {
          "type": "string",
          "default": "",
          "description": "Override the esptool command used to flash esp32 (e.g. a Windows python.exe on WSL so it can see COM ports). Leave empty to auto-detect."
        }
      }
    },
    "colors": [],
    "keybindings": [
      {
        "command": "mpftp.openRepl",
        "key": "ctrl+alt+r",
        "mac": "cmd+alt+r"
      },
      {
        "command": "mpftp.openFtp",
        "key": "ctrl+alt+f",
        "mac": "cmd+alt+f"
      },
      {
        "command": "mpftp.openFtpEditor",
        "key": "ctrl+alt+shift+f",
        "mac": "cmd+alt+shift+f"
      }
    ]
  },
  "scripts": {
    "vscode:prepublish": "npm run compile",
    "compile": "tsc -p ./",
    "watch": "tsc -watch -p ./",
    "lint": "tsc -p ./ --noEmit",
    "package": "npx --yes @vscode/vsce package --no-dependencies",
    "test:python": "python3 -m unittest discover -s python/tests -v"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/PyDevices/mpftp.git"
  },
  "devDependencies": {
    "@types/node": "^20.11.0",
    "@types/vscode": "^1.85.0",
    "typescript": "^5.3.3"
  },
  "dependencies": {
    "@vscode/codicons": "^0.0.45"
  }
}