From a1b5e750d35abca7583e39e84a23d94f570e615e Mon Sep 17 00:00:00 2001
From: Corbin Crutchley <git@crutchcorn.dev>
Date: Thu, 14 May 2026 06:00:10 -0400
Subject: [PATCH] docs: update VSC image and README

---
 packages/vscode/README.md        | 46 ++++++++++++++++++++++++++++++++
 packages/vscode/package.json     |  1 +
 packages/vscode/scripts/vsce.mjs |  2 +-
 3 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 packages/vscode/README.md

diff --git a/packages/vscode/README.md b/packages/vscode/README.md
new file mode 100644
index 0000000..749902c
--- /dev/null
+++ b/packages/vscode/README.md
@@ -0,0 +1,46 @@
+# Tempblot Language Features
+
+VS Code language support for Tempblot `.blot` templates.
+
+Tempblot is a type-safe templating language with TypeScript-powered `<setup>` blocks and interpolated output blocks.
+
+## Features
+
+- Syntax highlighting for `.blot` files.
+- File icons for Tempblot templates.
+- IntelliSense for TypeScript inside Tempblot files.
+- Diagnostics and editor language features powered by the Tempblot language server.
+- TypeScript server integration for workspace TypeScript versions.
+
+## Example
+
+```blot
+<setup>
+const user = {
+  name: "Tempblot",
+  enabled: true,
+};
+</setup>
+
+<output lang="json">
+{
+  "name": <<user.name>>,
+  "enabled": <<user.enabled>>
+}
+</output>
+```
+
+## Settings
+
+- `tempblot.server.enable`: Enable or disable experimental IntelliSense support for Tempblot files.
+- `tempblot.trace.server.verbosity`: Control language server tracing verbosity.
+- `tempblot.trace.server.format`: Choose text or JSON formatting for traced language server requests.
+
+## Requirements
+
+- VS Code 1.104.0 or newer.
+- A workspace using TypeScript for full TypeScript-powered language features.
+
+## Feedback
+
+Report issues at https://github.com/crutchcorn/tempblot/issues.
diff --git a/packages/vscode/package.json b/packages/vscode/package.json
index 9d371b7..57e4717 100644
--- a/packages/vscode/package.json
+++ b/packages/vscode/package.json
@@ -10,6 +10,7 @@
   ],
   "displayName": "Tempblot Language Features",
   "description": "Syntax highlighting and language features for Tempblot files",
+  "icon": "images/tempblot_dark.png",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/crutchcorn/tempblot.git",
diff --git a/packages/vscode/scripts/vsce.mjs b/packages/vscode/scripts/vsce.mjs
index 6e6695c..72d8169 100644
--- a/packages/vscode/scripts/vsce.mjs
+++ b/packages/vscode/scripts/vsce.mjs
@@ -40,7 +40,7 @@ try {
 }
 
 async function stageExtension(stageRoot) {
-  for (const entry of ["images", "syntaxes", "LICENSE"]) {
+  for (const entry of ["images", "syntaxes", "LICENSE", "README.md"]) {
     await cp(join(root, entry), join(stageRoot, entry), { recursive: true });
   }
   await mkdir(join(stageRoot, "out"));
-- 
2.51.2