feat: gts-kit 0.3.0

README.md

@@ -8,6 +8,8 @@ A three-headed application for validating and viewing the [GTS](https://github.c
 
 This project is aimed at exploring and using GTS schemas and instances across platforms.
 
+The repository is conformant with gts-spec v0.13.4.
+
 ![GTS Viewer](./docs/gts-viewer.png)
 
 ## Quick Start

apps/vscode-extension/CHANGELOG.md

@@ -2,36 +2,97 @@
 
 All notable changes to the GTS Viewer extension will be documented in this file.
 
-## [1.0.0] - 2025-10-08
+## [Unreleased]
+
+## [0.3.0] - 2026-09-18
+
+
+
+## [0.2.6] - 2026-09-07
+
+### Fixed
+- Malformed `gts://` schema IDs now surface correctly everywhere instead of failing silently
+- Gray chip shown for unresolved GTS IDs in schema examples
+- Compact web UI layout for the VS Code webview; validation errors now wrap properly
+- `GTS: Open Viewer` now opens the currently selected file
 
 ### Added
-- **Context Menu Integration**: Right-click `.json` and `.gts` files to preview layouts
-- **Visual Layout Viewer**: Interactive diagram showing JSON schemas and instances
-- **Layout Persistence**: Save and load custom layouts from workspace `.gts-viewer/` folder
-- **Dual Panel View**: File opens in editor (left) with preview panel (right)
-- **Welcome Message**: First-time user guidance
-- **Auto-detection**: Automatic file validation for supported formats
-
-### Features
-- Support for `.json` and `.gts` file types
-- RepoLayoutStorage integration for team-shared layouts
-- Version control friendly layout storage
-- Error handling with user-friendly messages
-- Webview-based rendering for rich visual experience
-
-### Commands
-- `GTS: Preview Layout` - Open selected file in visual viewer
-- `GTS: Open Viewer` - Show usage instructions
-
-### Context Menu Locations
-- Explorer context menu (right-click files)
-- Editor title context menu
+- Diagnostics shown when the web server isn't running
+- A progress bar for large repo scans
 
-## [Unreleased]
+## [0.2.5] - 2026-09-06
+
+### Changed
+- Renamed extension identifier to `gts-kit` (the `gts` name was already taken on the VS Code Marketplace)
+- Reduced packaged extension size
+
+## [0.2.4] - 2026-09-06
+
+### Fixed
+- Rebased schema validation on `gts-ts`
+- Invalid JSON is now rejected during editor validation
+- Removed duplicated validation errors in the GTS viewer
+- Consistent YAML parsing across shared registry and editor validation
+
+### Added
+- All/errors/valid entities selector in the GTS viewer
+
+## [0.2.3] - 2026-08-31
+
+### Added
+- Scoped background validation for unopened GTS files
+- GTS brand logo as extension and activity bar icon
+- Enforced `gts://` URI prefix rules for JSON Schema fields
+
+### Fixed
+- Two-phase prioritized file scan with `.gitignore` exclusion for better performance
+- Persisted GTS registry to reduce editor open latency
+- Removed redundant margins around GTS string annotations in the editor
+- Consistent segment gap width across GTS segment styles
 
-### Planned
-- Multi-file comparison view
-- Layout templates
-- Export to image/SVG
-- Search and filter capabilities
-- Enhanced keyboard shortcuts
+## [0.2.2] - 2026-08-31
+
+### Added
+- YAML file format support
+- Schema examples preview feature
+- NOTICE file with copyright and license information
+
+### Changed
+- Aligned schema handling with GTS spec v0.7
+- Prioritize the GTS ID (`id`, `gtsId`, etc.) over the `type` field for schema resolution
+- Disabled GTS reference validation for `/examples` in schemas
+
+### Fixed
+- Slow GTS color annotations on file open
+- Popup GTS error display position
+- Restored VS Code editor inline validation
+- Removed redundant file link in the web viewer
+
+## [0.2.1] - 2025-10-22
+
+### Added
+- Open the file containing a GTS node directly from the VS Code editor
+
+### Changed
+- Cumulative visual style polish for the web view and VS Code
+- Neutral file link color (blue was reserved for "schema" elsewhere)
+
+### Fixed
+- Color annotations for broken GTS IDs
+- GTS replacement when clicking an auto-suggestion popup
+- Rescan JSON files on edits even when the web viewer isn't active
+
+## [0.2.0] - 2025-10-19
+
+### Added
+- Inline JSON/JSONC/GTS file validation inside the VS Code editor
+- Colored GTS ID validation and suggestions in the editor
+- Support for `.jsonc` and `.gts` file extensions
+
+### Changed
+- Switched from `better-sqlite3` to `sql.js` (no native compilation required)
+
+## [0.1.0] - 2025-10-16
+
+### Added
+- Initial release of the GTS Viewer VS Code extension

apps/vscode-extension/README.md

@@ -111,9 +111,14 @@ See the full [GTS Specification](https://github.com/globaltypesystem/gts-spec) f
 
 - **`.json`** — Standard JSON (schemas and instances)
 - **`.jsonc`** — JSON with Comments (single-line, multi-line, trailing commas)
-- **`.yaml` / `.yml`** — YAML files parsed and treated identically to JSON
+- **`.yaml` / `.yml`** — YAML files parsed and treated like JSON, **plus** inline GTS definitions (see below)
 - **`.gts`** — GTS-specific files
 
+#### Supported GTS Entity Definitions
+
+- **JSON / JSONC / `.gts`** — a document must be either a **single entity** or a **top-level array of entities**. GTS IDs anywhere else are treated as *references*.
+- **YAML** — everything above, **plus** inline definitions: a config file may *define* GTS types/instances under any nested `entities:` array (e.g. a service's `types-registry.config.entities` seed block), even deep inside otherwise-non-GTS config. Each element is registered by its `$id` as a real definition, so it is not flagged as an unresolved reference.
+
 ### Validation
 
 The extension validates GTS files automatically as you open, edit, and save them.

apps/vscode-extension/package.json

@@ -2,7 +2,7 @@
   "name": "gts-kit",
   "displayName": "Global Type System (GTS) Kit",
   "description": "Global Type System (GTS) support for VS Code — browse, validate,visualize, and manage GTS schemas and instances",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "private": true,
   "publisher": "GlobalTypeSystem",
   "license": "Apache-2.0",
@@ -19,16 +19,21 @@
     "vscode": "^1.85.0"
   },
   "categories": [
-    "Visualization",
-    "Other"
+    "Formatters",
+    "Linters",
+    "Visualization"
   ],
-  "activationEvents": [
-    "onCommand:gts.openViewer",
-    "onLanguage:json",
-    "onLanguage:jsonc",
-    "onLanguage:gts"
+  "tags": [
+    "gts",
+    "json",
+    "jsonc",
+    "jsonchema",
+    "validation"
   ],
   "main": "./dist/extension.js",
+  "activationEvents": [
+    "onStartupFinished"
+  ],
   "contributes": {
     "languages": [
       {
@@ -39,9 +44,15 @@
     ],
     "commands": [
       {
-        "command": "gts.openViewer",
+        "command": "gts-kit.openViewer",
         "title": "GTS: Open Viewer",
         "category": "GTS"
+      },
+      {
+        "command": "gts-kit.refreshFileExplorer",
+        "title": "GTS: Refresh Discovered Files",
+        "category": "GTS",
+        "icon": "$(refresh)"
       }
     ],
     "viewsContainers": {
@@ -56,40 +67,54 @@
     "views": {
       "gts-viewer": [
         {
-          "type": "webview",
-          "id": "gts.viewerPanel",
-          "name": "Schema Viewer"
+          "id": "gts-kit.fileExplorer",
+          "name": "Discovered GTS files",
+          "icon": "resources/icon.svg",
+          "contextualTitle": "GTS Files"
         }
       ]
     },
+    "viewsWelcome": [
+      {
+        "view": "gts-kit.fileExplorer",
+        "contents": "No [GTS](https://globaltypesystem.org/#vscode-plugins) files discovered yet.\n[GTS](https://globaltypesystem.org/#vscode-plugins) files (schemas and instances) found anywhere in the workspace will be listed here."
+      }
+    ],
     "menus": {
       "explorer/context": [
         {
-          "command": "gts.openViewer",
+          "command": "gts-kit.openViewer",
           "group": "navigation@100",
           "when": "resourceExtname =~ /\\.(json|jsonc|gts)$/"
         }
       ],
+      "view/title": [
+        {
+          "command": "gts-kit.refreshFileExplorer",
+          "group": "navigation@1",
+          "when": "view == gts-kit.fileExplorer"
+        }
+      ],
       "editor/title": [
         {
-          "command": "gts.openViewer",
+          "command": "gts-kit.openViewer",
           "group": "navigation@100",
           "when": "editorLangId == json"
         },
         {
-          "command": "gts.openViewer",
+          "command": "gts-kit.openViewer",
           "group": "navigation@100",
           "when": "editorLangId == jsonc"
         },
         {
-          "command": "gts.openViewer",
+          "command": "gts-kit.openViewer",
           "group": "navigation@100",
           "when": "editorLangId == gts"
         }
       ],
       "menubar/file": [
         {
-          "command": "gts.openViewer",
+          "command": "gts-kit.openViewer",
           "group": "2_open"
         }
       ]
@@ -116,6 +141,7 @@
     "esbuild": "^0.19.0",
     "ignore": "^5.3.2",
     "jsonc-parser": "^3.3.1",
-    "typescript": "^5.2.2"
+    "typescript": "^5.2.2",
+    "yaml": "^2.9.1"
   }
 }