PebbleBit — Visual Studio Code Extension

Language support for the PebbleBit programming language.

Overview

PebbleBit is a statically typed programming language designed to be simple, readable, and beginner-friendly while compiling directly to native executables.

This extension provides foundational Visual Studio Code language support for PebbleBit source files (.pb).

Features

Syntax Highlighting

Syntax highlighting for PebbleBit language constructs, including:

Keywords and control-flow statements
Primitive types and type declarations
Function declarations and calls
Variables and constants
Structs and enums
String, character, numeric, and boolean literals
Operators and punctuation
Comments
Built-in functions

Code Snippets

16 built-in snippets to speed up writing PebbleBit programs.

Prefix	Description
`func`	Number-returning function
`funcvoid`	Void function
`main`	Main function
`if`	If statement
`ifelse`	If-else statement
`while`	While loop
`repeat`	Repeat loop
`for`	For loop
`struct`	Struct declaration
`enum`	Enum declaration
`array`	Array declaration
`var`	Variable declaration
`const`	Constant declaration
`print`	Print statement
`import`	Standard library import
`importfile`	Source file import

Type a prefix in a .pb file and select the corresponding suggestion from IntelliSense's snippet completion list.

Language Configuration

Automatic indentation
Bracket matching
Automatic closing pairs
Surrounding pairs
Comment toggling

File Icons

An optional PebbleBit file icon theme provides a dedicated icon for .pb files.

To activate it:

Open the Command Palette (Ctrl+Shift+P).
Search for Preferences: File Icon Theme.
Select PebbleBit File Icons.

Installation

From Visual Studio Code Marketplace

Search for PebbleBit in the Extensions view (Ctrl+Shift+X) and install the extension.

From a VSIX package

Download the .vsix package.
Open Visual Studio Code.
Open the Extensions view.
Select the three-dot menu.
Choose Install from VSIX... and select the package.

PebbleBit Compiler

This extension provides editor language support. The PebbleBit compiler is a separate installation.

Compiler source code and installation instructions:

PebbleBit Compiler — GitHub

After installing the compiler, use its command-line interface from a terminal:

# Compile a source file
pbit program.pb

# Build an executable
pbit build program.pb -o program

# Build and run a program
pbit run program.pb

The compiler also supports --keep-ir to preserve generated LLVM IR.

For exact compiler requirements and supported language features, refer to the compiler documentation.

Current Scope

This extension currently focuses on syntax highlighting, snippets, language configuration, and file icons.

It does not currently provide:

Language Server Protocol (LSP) features
Inline compiler diagnostics
Debugger integration
Code formatting
Integrated one-click build or run commands

These are separate capabilities from the compiler itself.

License

See the LICENSE file for licensing information.

PebbleBit

Ronak Mishra