Merge branch 'main' of https://github.com/theodevelop/bison-flex-lang

Author: theodevelop

.github/workflows/publish-ovsx.yml

@@ -0,0 +1,30 @@
+name: Publish to Open VSX
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish-ovsx:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build VSIX
+        run: |
+          npm run package
+          npx vsce package
+
+      - name: Publish to Open VSX
+        run: npx ovsx publish *.vsix --pat ${{ secrets.OVSX_PAT }}

.vscodeignore

@@ -9,3 +9,12 @@ node_modules/
 tests/
 images/icon.svg
 **/*.map
+.claude/
+.github/
+.gitignore
+TODO.md
+examples/
+tsconfig.base.json
+package-lock.json
+*.vsix
+.gitattributes

CHANGELOG.md

@@ -13,8 +13,25 @@ All notable changes to the **Bison/Flex Language Support** extension will be doc
   - Start condition highlighting (`<SC_NAME>`)
   - Abbreviation reference highlighting (`{name}`)
 - **Real-time diagnostics**
-  - Bison: undeclared tokens, orphan `%type` declarations, missing `%%`, unclosed blocks
-  - Flex: undefined start conditions, undefined abbreviations, missing `%%`, unclosed blocks
+  - Bison:
+    - Missing `%%` section separator (Error)
+    - Unknown/invalid directive — e.g. `%prout` (Error)
+    - Token used in grammar rules but not declared with `%token` (Warning)
+    - `%type` declared for a non-terminal that has no rule (Warning)
+    - Rule missing `%type` declaration when `api.value.type=variant` is active (Info)
+    - Unclosed `%{ %}` code block (Error)
+    - Unused grammar rules — not reachable from the start symbol (Warning)
+    - Unused tokens — declared with `%token` but never referenced in rules (Warning)
+    - Shift/reduce conflict heuristic — same terminal appears in two or more alternatives of a rule (Warning)
+  - Flex:
+    - Missing `%%` section separator (Error)
+    - Unknown/invalid directive — e.g. `%woops` (Error)
+    - Undefined start condition used in a rule (`<SC>` not declared with `%x`/`%s`) (Error)
+    - Undefined abbreviation referenced in a pattern (`{name}` not in definitions section) (Warning)
+    - Start condition declared but never used in any rule (Info)
+    - Abbreviation declared but never referenced in any pattern (Info)
+    - Unclosed `%{ %}` code block (Error)
+    - Inaccessible rule — catch-all pattern before a specific pattern, or duplicate pattern (Warning)
 - **Autocompletion**
   - 30+ Bison directives with documentation
   - 20+ Flex `%option` values
@@ -32,3 +49,6 @@ All notable changes to the **Bison/Flex Language Support** extension will be doc
   - 12 Flex snippets (scanner skeleton, RE-flex skeleton, comment/string handlers)
 - **Language configuration**
   - Bracket matching, auto-closing pairs, comment toggling, folding
+- **File icon theme** (`bison-flex-icons`)
+  - Distinct orange "B" icon for Bison files (`.y`, `.yy`, `.ypp`, `.bison`)
+  - Distinct blue "F" icon for Flex files (`.l`, `.ll`, `.lex`, `.flex`)

README.md

@@ -2,7 +2,9 @@
 
 [![VS Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/theodevelop.bison-flex-lang?label=Marketplace&logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=theodevelop.bison-flex-lang)
 [![Installs](https://img.shields.io/visual-studio-marketplace/i/theodevelop.bison-flex-lang)](https://marketplace.visualstudio.com/items?itemName=theodevelop.bison-flex-lang)
-[![CI](https://github.com/theodevelop/Bison-Flex-Language-Support/actions/workflows/ci.yml/badge.svg)](https://github.com/theodevelop/Bison-Flex-Language-Support/actions/workflows/ci.yml)
+[![Rating](https://img.shields.io/visual-studio-marketplace/r/theodevelop.bison-flex-lang)](https://marketplace.visualstudio.com/items?itemName=theodevelop.bison-flex-lang)
+[![Open VSX](https://img.shields.io/open-vsx/v/theodevelop/bison-flex-lang?label=Open%20VSX&logo=vscodium)](https://open.vsx.org/extension/theodevelop/bison-flex-lang)
+[![CI](https://github.com/theodevelop/bison-flex-lang/actions/workflows/ci.yml/badge.svg)](https://github.com/theodevelop/bison-flex-lang/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 Full-featured language support for **GNU Bison** (`.y`, `.yy`) and **Flex/RE-flex** (`.l`, `.ll`) in Visual Studio Code.
@@ -32,6 +34,10 @@ Real-time error detection as you type:
 | Missing `%%` section separator | Missing `%%` section separator |
 | Unclosed `%{ %}` code blocks | Unclosed `%{ %}` code blocks |
 | Missing `%type` with `variant` semantic values | Unused start conditions and abbreviations |
+| Unused grammar rules (unreachable from start symbol) | Inaccessible rules (catch-all before specific pattern, or duplicate) |
+| Unused tokens (declared but never referenced) | Unknown/invalid directive |
+| Shift/reduce conflict heuristic | |
+| Unknown/invalid directive | |
 
 ### Autocompletion
 
@@ -75,6 +81,25 @@ Ready-to-use templates to speed up your workflow:
 
 ---
 
+## Screenshots
+
+### Syntax Highlighting
+![Syntax highlighting with section-aware coloring and embedded C/C++](images/syntax-highlighting.png)
+
+### Hover Documentation
+![Inline hover docs for Bison directives and Flex options](images/hover-docs.png)
+
+### Autocompletion
+![Context-aware completions for directives, tokens, and semantic values](images/autocompletion.png)
+
+### Diagnostics
+![Real-time error and warning markers for undeclared tokens, missing separators, and more](images/diagnostics.png)
+
+### Snippets
+![Code snippet expansion for grammar skeletons and rule templates](images/snippets.png)
+
+---
+
 ## Supported File Types
 
 | Language | Extensions | Aliases |
@@ -115,6 +140,65 @@ Then press `F5` in VS Code to launch the Extension Development Host.
 |---------|------|---------|-------------|
 | `bisonFlex.enableDiagnostics` | `boolean` | `true` | Enable/disable real-time error detection |
 | `bisonFlex.maxDiagnostics` | `number` | `100` | Maximum number of diagnostics per file |
+| `bisonFlex.bisonPath` | `string` | `"bison"` | Path to the Bison executable (must be in PATH or absolute) |
+| `bisonFlex.flexPath` | `string` | `"flex"` | Path to the Flex executable (must be in PATH or absolute) |
+
+---
+
+## Build Integration (tasks.json)
+
+Drop this `.vscode/tasks.json` into your Bison/Flex project to get `Ctrl+Shift+B` build support with problem matchers:
+
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build (Bison + Flex + Make)",
+      "type": "shell",
+      "command": "make",
+      "group": { "kind": "build", "isDefault": true },
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": [
+        {
+          "owner": "bison",
+          "fileLocation": ["relative", "${workspaceFolder}"],
+          "pattern": {
+            "regexp": "^(.+?):(\\d+)(?:\\.(\\d+))?:\\s+(warning|error):\\s+(.+)$",
+            "file": 1, "line": 2, "column": 3, "severity": 4, "message": 5
+          }
+        },
+        {
+          "owner": "flex",
+          "fileLocation": ["relative", "${workspaceFolder}"],
+          "pattern": {
+            "regexp": "^(.+?):(\\d+):\\s+(warning|error):\\s+(.+)$",
+            "file": 1, "line": 2, "severity": 3, "message": 4
+          }
+        }
+      ]
+    },
+    {
+      "label": "Bison: Compile current file",
+      "type": "shell",
+      "command": "bison",
+      "args": ["-d", "-v", "${file}"],
+      "group": "build",
+      "problemMatcher": []
+    },
+    {
+      "label": "Flex: Compile current file",
+      "type": "shell",
+      "command": "flex",
+      "args": ["-o", "${fileBasenameNoExtension}.c", "${file}"],
+      "group": "build",
+      "problemMatcher": []
+    }
+  ]
+}
+```
+
+> **Tip**: `bison -d` generates the `.tab.h` header; `-v` produces the `.output` report with the parse table.
 
 ---
 
@@ -144,7 +228,7 @@ Contributions are welcome! Here's how to get started:
 ### Running Tests
 
 ```bash
-npx ts-node --project server/tsconfig.json test-parsers.ts
+npx ts-node --project server/tsconfig.json tests/test-parsers.ts
 ```
 
 ### Building for Production

bison-flex-icon-theme.json

@@ -0,0 +1,21 @@
+{
+  "iconDefinitions": {
+    "_bison": {
+      "iconPath": "./images/bison-icon.svg"
+    },
+    "_flex": {
+      "iconPath": "./images/flex-icon.svg"
+    }
+  },
+  "fileExtensions": {
+    "y":     "_bison",
+    "yy":    "_bison",
+    "ypp":   "_bison",
+    "bison": "_bison",
+    "l":     "_flex",
+    "ll":    "_flex",
+    "lex":   "_flex",
+    "flex":  "_flex"
+  },
+  "fileNames": {}
+}