From ac313061bd46d87a0a2e5a9c000af4e2ac96bf22 Mon Sep 17 00:00:00 2001
From: kjw142857 <e0958424@u.nus.edu>
Date: Wed, 11 Mar 2026 11:17:11 +0800
Subject: [PATCH] Include current and planned features in README

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 4ec8997..a7d5229 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@ Open-source Implementation of the Java language in TypeScript. (<https://docs.or
   - [Table of Contents](#table-of-contents)
   - [Prerequisites](#prerequisites)
   - [Usage](#usage)
+  - [Current Features](#current-features)
+  - [Future Features](#future-features)
   - [Testing](#testing)
   - [Using your java-slang in Source Academy](#using-your-java-slang-in-source-academy)
   - [Using your java-slang in your local Source Academy](#using-your-java-slang-in-your-local-source-academy)
@@ -39,6 +41,26 @@ $ git submodule update --init --recursive
 $ git submodule update --recursive --remote
 ```
 
+## Current Features
+
+The Java language in Source Academy currently supports a host of available features, including:
+
+- Primitive classes: boolean, byte, short, int, long, char, float and double.
+- Custom (non-primitive) classes
+- Method overloading
+- Implicit type widening for both primitive and non-primitive types (e.g. int to long)
+- Basic exception/error messages
+- Basic system calls e.g. System.out.println
+- Single nested class
+
+## Future Features
+
+- Multiple class declarations in the same file
+- Inheritance (basis for implementation exists but requires multiclass declaration to function)
+- Explicit type conversion (type narrowing)
+- Implicit type conversion for system calls (e.g. int input to System.out.println)
+- Generics
+- Multi-file programs
 
 ## Testing