Initial Commit

Author: thegecko

.github/workflows/ci.yml

@@ -0,0 +1,84 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - run: npm install --ignore-scripts
+      - run: npm run build
+      - run: npm run package
+      - uses: actions/upload-artifact@v7
+        with:
+          name: vsix-package
+          path: ./*.vsix
+          retention-days: 1
+
+  release:
+    needs: build
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/*/*.vsix
+
+  publish-open-vsx-registry:
+    needs:
+      - release
+    name: Open VSX
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - name: Publish
+        run: |
+          npx ovsx publish -i artifacts/*/*.vsix -p ${{secrets.OPEN_VSX_TOKEN}}
+
+  publish-vscode-marketplace:
+    needs:
+      - release
+    name: VS Code Marketplace
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+      - name: Publish
+        run: |
+          npx @vscode/vsce publish -i artifacts/*/*.vsix -p ${{secrets.VS_MARKETPLACE_TOKEN}}

.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+node_modules
+dist
+*.vsix

.npmrc

@@ -0,0 +1 @@
+omit-lockfile-registry-resolved=true

.vscode/launch.json

@@ -0,0 +1,20 @@
+// A launch configuration that compiles the extension and then opens it inside a new window
+// Use IntelliSense to learn about possible attributes.
+// Hover to view descriptions of existing attributes.
+// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+{
+	"version": "0.2.0",
+	"configurations": [
+		{
+            "name": "Desktop Extension",
+            "type": "extensionHost",
+            "request": "launch",
+            "args": [
+                "--extensionDevelopmentPath=${workspaceFolder}"
+            ],
+            "outFiles": [
+                "${workspaceFolder}/dist/**/*.js"
+            ]
+        }
+	]
+}

.vscode/tasks.json

@@ -0,0 +1,16 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "npm",
+			"script": "watch",
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			},
+			"problemMatcher": [],
+			"label": "npm: watch",
+			"detail": "tsc --sourceMap --watch"
+		}
+	]
+}

.vscodeignore

@@ -0,0 +1,6 @@
+.github
+.vscode
+dist/**/*.js.map
+node_modules
+src
+*.vsix

README.md

@@ -1,2 +1,68 @@
-# vscode-mbed
-VSCode Extension for Mbed OS Projects
+# VS Code Mbed
+
+VS Code Extension for Mbed OS Projects.
+
+## Overview
+Mbed for VS Code enables you to work with Mbed OS projects, handling library dependencies, target connection, build, debug and serial output.
+
+## Usage
+
+- Install the extension from within your IDE (search for 'mbed') or from an extension marketplace:
+
+  - VS Code: https://marketplace.visualstudio.com/items?itemName=mbed.mbed
+  - Open VSX: https://open-vsx.org/extension/mbed/mbed
+
+- This will also install the following extensions:
+  - arm.armls - For working with assembly code.
+  - arm.device-manager - For detecting and managing connected devices.
+  - arm.embedded-debug - For deploying to your device and debugging programs.
+  - arm.environment-manager - For setting up a compiler.
+
+- Open an existing Mbed OS project or use the user interface to clone an existing example using git.
+- The user interface will help you recursively clone any dependant libraries (hydration) and install the Arm GNU toolchain (GCC) or Arm Compiler for Embedded toolchains.
+- You can then select your target and profile, build, deploy and debug your application.
+
+## Contribution
+
+This extension is intended to serve as a permissive, open-source reference for working with Mbed after the July 2026 end-of-life, offering an alternative to the standalone Mbed Studio application.
+
+Pull requests may be accepted, but this primarily serves as a reference application for developing your own tools.
+
+## Development
+
+### Prerequisites
+
+A working [Node.js](https://nodejs.org/) environment.
+
+### Clone
+
+```bash
+git clone https://github.com/ARMmbed/vscode-mbed
+```
+
+### Build
+
+In the `vscode-mbed` folder:
+
+```bash
+## Install node dependencies
+npm install
+```
+
+```bash
+## Build the extension
+npm run build
+```
+
+```bash
+## Package the extension
+npm run package
+```
+
+### Watch
+
+Start the default build task in VS Code.
+
+### Debug
+
+Launch the default debug task in VS Code.