Cut v0.3.0 release (#57)

djankov · web-flow · commit d9035f07d9c3 · 2026-06-08T23:07:56.000-04:00
- Aggregate the CHANGELOG [0.3.0] section: the field catalogue, linter, tree-sitter highlight/locals/tags queries, pygls language server, and VS Code extension (#19–#25). - Bump gmat-script (PyPI), tree-sitter-gmat (npm), and the VS Code extension to 0.3.0 in lockstep, and regenerate parser.c for the embedded version stamp. - Refresh the VS Code extension and file-type icons, and add the Marketplace / Open VSX demo GIF. Closes #26
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,50 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.3.0] — 2026-06-08
+
+gmat-script grows from a parser and formatter into a full editor toolchain: a GMAT field catalogue
+reflected from R2026a, a linter that checks scripts against it, a Language Server Protocol server,
+and a VS Code extension on the Marketplace and Open VSX. Everything still runs with no GMAT install —
+the catalogue ships as data inside the wheel — and the grammar is unchanged, so every byte-for-byte
+round-trip from earlier releases still holds.
+
+### Added
+
+- **Field catalogue (`gmat_script.catalog`)** — the semantics GMAT defines but the permissive grammar
+  deliberately ignores: every resource type, its fields, and each field's type, default, allowed
+  values, units, and reference target. Reflected from GMAT R2026a through `gmatpy` by a
+  `tools/gen_catalog.py` generator and shipped as a version-pinned, provenance-stamped data file
+  (`data/fields-R2026a.json`, 102 resource types and 2614 fields) inside the wheel, loaded by
+  `load_catalog()`. Adding another GMAT release is a new data file, not a code change, and nothing
+  downstream needs a GMAT install (#19).
+- **Linter (`gmat-script lint`)** — a structural checker that reads the field catalogue: it flags
+  unknown resource fields, enum and type violations, references to undeclared resources, duplicate
+  names, and more, with inline suppression comments and `ruff`-style severities and exit codes. Each
+  diagnostic carries a rule id, a location, and a message, and the engine is shared verbatim with the
+  language server (#20).
+- **Tree-sitter queries** — `highlights`, `locals`, and `tags` queries packaged with the
+  `tree-sitter-gmat` grammar, giving editors resource / command / field highlighting, scope-aware
+  local resolution, and a symbol index with no extra setup (#21).
+- **Language server (`gmat-script[lsp]`)** — a `pygls` server, launched as `gmat-script-lsp` or
+  `python -m gmat_script.lsp`, that brings the catalogue and linter to any LSP-capable editor: hover
+  docs for a field's type, default, allowed values, and units; live diagnostics as you type;
+  completion of resource names, the fields valid for the resource under the cursor, and enum values;
+  go-to-definition and find-all-references; a document outline; and format-on-save via the canonical
+  formatter (#22).
+- **VS Code extension** — **GMAT Script**, published to the Visual Studio Marketplace and Open VSX.
+  Bundled TextMate highlighting works the moment it installs; the richer language features come from
+  the language server (`pip install "gmat-script[lsp]"`). `.script` and `.gmf` files get a file icon,
+  comment / bracket configuration, and format-on-save on by default (#23).
+- **Documentation** — new guide pages for the field catalogue, the linter, the language server, and
+  the VS Code extension, plus README sections on editor tooling and the GMAT-free catalogue (#25).
+
+### Changed
+
+- `gmat-script` (PyPI) and `tree-sitter-gmat` (npm) continue to release in version lockstep, now at
+  0.3.0. The grammar and generated parser are unchanged since 0.2.0; the npm package is republished
+  to carry the new editor queries — an expanded `highlights.scm` and a new `locals.scm` (#21).
+
 ## [0.2.0] — 2026-06-08
 
 A typed AST overlay over the v0.1 parse tree, a lossless mutation API, a canonical formatter, and a
diff --git a/README.md b/README.md
@@ -80,7 +80,7 @@ add the repo to your `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/astro-tools/gmat-script
-    rev: v0.2.0
+    rev: v0.3.0
     hooks:
       - id: gmat-script-format        # auto-format on commit
       # - id: gmat-script-format-check  # or: check only, never write (CI)
diff --git a/editors/vscode/.vscodeignore b/editors/vscode/.vscodeignore
@@ -13,3 +13,4 @@ tsconfig.json
 **/*.ts
 .gitignore
 .eslintrc*
+images/README.md
diff --git a/editors/vscode/README.md b/editors/vscode/README.md
@@ -4,8 +4,7 @@ Language support for [GMAT](https://gmat.atlassian.net/wiki/spaces/GW/overview)
 `.script` and `.gmf` files — built on the [`gmat-script`](https://github.com/astro-tools/gmat-script)
 tree-sitter grammar and language server.
 
-<!-- A short highlighting + diagnostics demo lands here for the release.
-     ![GMAT Script in VS Code](images/demo.gif) -->
+![GMAT Script in VS Code](images/demo.gif)
 
 ## Features
 
diff --git a/editors/vscode/icons/gmat-file.svg b/editors/vscode/icons/gmat-file.svg
@@ -1,8 +1,13 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32" role="img" aria-label="GMAT script file">
-  <!-- Orbit -->
-  <ellipse cx="16" cy="16" rx="13" ry="7.5" fill="none" stroke="#7C4DFF" stroke-width="1.6" transform="rotate(-25 16 16)"/>
-  <!-- Central body -->
-  <circle cx="16" cy="16" r="4.2" fill="#7C4DFF"/>
-  <!-- Spacecraft -->
-  <circle cx="26.2" cy="10.6" r="2.1" fill="#B388FF"/>
+  <g transform="rotate(20 16 16)">
+    <!-- Exhaust flame -->
+    <path d="M13.7 21.3 C14.1 24.5 16 27.2 16 27.2 C16 27.2 17.9 24.5 18.3 21.3 Z" fill="#F47C20"/>
+    <!-- Fins -->
+    <path d="M12 16.8 L8.4 21.2 L12 21 Z" fill="#2F5C99"/>
+    <path d="M20 16.8 L23.6 21.2 L20 21 Z" fill="#2F5C99"/>
+    <!-- Body -->
+    <path d="M16 3.4 C18.3 3.4 20 6.7 20 10.8 L20 20 C20 21.4 18.4 22.3 16 22.3 C13.6 22.3 12 21.4 12 20 L12 10.8 C12 6.7 13.7 3.4 16 3.4 Z" fill="#3E72B9"/>
+    <!-- Window -->
+    <circle cx="16" cy="11" r="2.3" fill="#F47C20"/>
+  </g>
 </svg>
diff --git a/editors/vscode/icons/gmat-script.png b/editors/vscode/icons/gmat-script.png
diff --git a/editors/vscode/images/demo.gif b/editors/vscode/images/demo.gif
diff --git a/editors/vscode/package-lock.json b/editors/vscode/package-lock.json
diff --git a/editors/vscode/package.json b/editors/vscode/package.json
@@ -2,7 +2,7 @@
   "name": "gmat-script",
   "displayName": "GMAT Script",
   "description": "Highlighting, hover docs, diagnostics, go-to-definition, completion, and format-on-save for GMAT mission scripts (.script / .gmf).",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "publisher": "astro-tools",
   "license": "MIT",
   "icon": "icons/gmat-script.png",
diff --git a/src/gmat_script/__init__.py b/src/gmat_script/__init__.py
@@ -35,4 +35,4 @@
     "load_catalog",
     "parse",
 ]
-__version__ = "0.2.0"
+__version__ = "0.3.0"
diff --git a/tree-sitter-gmat/package-lock.json b/tree-sitter-gmat/package-lock.json
diff --git a/tree-sitter-gmat/package.json b/tree-sitter-gmat/package.json
@@ -1,6 +1,6 @@
 {
   "name": "tree-sitter-gmat",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "GMAT mission script grammar for tree-sitter",
   "license": "MIT",
   "keywords": [
diff --git a/tree-sitter-gmat/src/parser.c b/tree-sitter-gmat/src/parser.c
@@ -9068,7 +9068,7 @@ TS_PUBLIC const TSLanguage *tree_sitter_gmat(void) {
     .max_reserved_word_set_size = 0,
     .metadata = {
       .major_version = 0,
-      .minor_version = 2,
+      .minor_version = 3,
       .patch_version = 0,
     },
   };
diff --git a/tree-sitter-gmat/tree-sitter.json b/tree-sitter-gmat/tree-sitter.json
@@ -17,7 +17,7 @@
     }
   ],
   "metadata": {
-    "version": "0.2.0",
+    "version": "0.3.0",
     "license": "MIT",
     "description": "GMAT mission script grammar for tree-sitter",
     "authors": [

Original file line number	Diff line number	Diff line change
`@@ -35,4 +35,4 @@`
`35`	`35`	`"load_catalog",`
`36`	`36`	`"parse",`
`37`	`37`	`]`
`38`		`-__version__ = "0.2.0"`
	`38`	`+__version__ = "0.3.0"`