Merge pull request #34 from lightning-js/release/v1.5.1

VS Code Release - v1.5.1

Author: uguraslan

.eslintignore

@@ -6,6 +6,9 @@
 out/**
 *.vsix
 *.zip
+dist/
+build/
+coverage/
 
 # Dependencies
 node_modules/**
@@ -35,3 +38,6 @@ vsc-extension-quickstart.md
 
 # vscode test
 .vscode-test/**
+
+# Test fixture files - these intentionally have import errors for testing
+test/fixtures/**

.eslintrc.json

@@ -75,12 +75,40 @@
     },
     {
       "files": [
-        "test/**/*.js"
+        "vscode-extension/test/**/*.js"
       ],
       "rules": {
         "no-unused-expressions": "off",
         "no-undef": "off"
       }
+    },
+    {
+      "files": [
+        "vscode-extension/test/fixtures/**/*.js"
+      ],
+      "parserOptions": {
+        "sourceType": "module"
+      },
+      "rules": {
+        "no-unused-expressions": "off",
+        "no-undef": "off",
+        "no-unused-vars": "off",
+        "import/no-unresolved": "off"
+      }
+    },
+    {
+      "files": [
+        "vscode-extension/test/fixtures/**/*.blits"
+      ],
+      "parserOptions": {
+        "sourceType": "module"
+      },
+      "rules": {
+        "no-unused-expressions": "off",
+        "no-undef": "off",
+        "no-unused-vars": "off",
+        "import/no-unresolved": "off"
+      }
     }
   ]
 }

.github/workflows/release-extension.yml

@@ -4,6 +4,8 @@ on:
   push:
     branches:
       - main
+    paths:
+      - 'vscode-extension/**'
 
 jobs:
   package:
@@ -21,30 +23,35 @@ jobs:
     - name: Install Dependencies
       run: npm install
 
+    - name: Install monorepo dependencies
+      run: npm install --workspaces
+
     - name: Install vsce
       run: npm install -g @vscode/vsce
 
-    # Read package.json and set variables
+    # Read package.json from vscode-extension folder and set variables
     - name: Read package.json
       run: |
-        extension_name=$(node -p "require('./package.json').name")
-        extension_version=$(node -p "require('./package.json').version")
+        extension_name=$(node -p "require('./vscode-extension/package.json').name")
+        extension_version=$(node -p "require('./vscode-extension/package.json').version")
         echo "EXTENSION_NAME=$extension_name" >> $GITHUB_ENV
         echo "EXTENSION_VERSION=$extension_version" >> $GITHUB_ENV
 
     # fixme: run tests
-    # - name: Run Tests
-    #   run: npm run test
+    - name: Run Tests
+      run: npm run test --workspace=vscode-extension
 
     - name: Package Extension
-      run: npx vsce package
+      run: npm run vscode:package
 
-    # Rename the vsix file
+    # Rename the vsix file (adjusting path for monorepo)
     - name: Rename VSIX
+      working-directory: vscode-extension
       run: mv *.vsix ${{ env.EXTENSION_NAME }}.v${{ env.EXTENSION_VERSION }}.vsix
 
     # Create GitHub Pre Release and Upload VSIX
     - name: Create GitHub Pre Release and Upload VSIX
+      working-directory: vscode-extension
       run: |
         gh auth login --with-token <<< "${{ secrets.GITHUB_TOKEN }}"
         gh release create v${{ env.EXTENSION_VERSION }} ./${{ env.EXTENSION_NAME }}.v${{ env.EXTENSION_VERSION }}.vsix --prerelease -t "blits-vscode v${{ env.EXTENSION_VERSION }}" -n "Version ${{ env.EXTENSION_VERSION }} of ${{ env.EXTENSION_NAME }}"

.gitignore

@@ -1,12 +1,8 @@
 node_modules
-/*.vsix
 out
 .DS_Store
 backup
 *.vsix
 *.zip
 .eslintcache
-.vscode-test/**
-src/parsers/testParser.js
-./test
-*.test.js
+.vscode-test

.vscode/launch.json

@@ -3,31 +3,28 @@
 // Hover to view descriptions of existing attributes.
 // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
 {
-	"version": "0.2.0",
-	"configurations": [
-		{
-      "name": "Run Extension",
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run VSCode Extension",
       "type": "extensionHost",
       "request": "launch",
       "runtimeExecutable": "${execPath}",
-      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
+      "args": [
+        "--disable-extensions",
+        "--extensionDevelopmentPath=${workspaceFolder}/vscode-extension",
+      ],
       "preLaunchTask": "esbuild: watch",
-      "outFiles": ["${workspaceFolder}/out/**/*.js"]
+      "outFiles": ["${workspaceFolder}/vscode-extension/out/**/*.js"]
     },
     {
       "name": "Extension Tests",
       "type": "extensionHost",
       "request": "launch",
       "args": [
-        "--extensionDevelopmentPath=${workspaceFolder}",
-        "--extensionTestsPath=${workspaceFolder}/test/suite/index"
+        "--extensionDevelopmentPath=${workspaceFolder}/vscode-extension",
+        "--extensionTestsPath=${workspaceFolder}/vscode-extension/test/suite/index"
       ]
-    },
-    {
-      "type": "node",
-      "request": "launch",
-      "name": "Debug test-template-errors",
-      "program": "${workspaceFolder}/test-template-errors.js"
     }
-	]
+  ]
 }

.vscode/tasks.json

@@ -5,7 +5,7 @@
     {
       "label": "esbuild: watch",
       "type": "shell",
-      "command": "npm run esbuild-base -- --sourcemap --watch",
+      "command": "npm run esbuild-watch --workspace=vscode-extension",
       "isBackground": true,
       "problemMatcher": {
         "base": "$tsc-watch",

README.md

@@ -1,98 +1,28 @@
-# Lightning Blits VS Code extension
+# Blits Development Tools
 
-This is the official VSCode extension for the Lightning Blits framework.
+This repo contains official development tools for the [Lightning Blits](https://lightningjs.io/) framework, mainly the Lightning Blits VSCode extension and support packages for linting and formatting.
 
-Blits is a **lightweight, high-performance frontend framework** for **Lightning 3 applications**. This VSCode extension enhances the development experience by providing **rich language support** for Blits templates, components, and the `.blits` file format.
+## Packages
 
-## Usage
+### [VSCode Extension](./vscode-extension)
 
-Once installed, the extension will automatically detect and provide **language support** for:
-- `.blits` files.
-- Blits templates inside JavaScript and TypeScript files in Blits apps.
+The official VSCode extension for Lightning Blits provides essential IDE features for developing Blits applications:
 
-### **Commands & Shortcuts**
+- Template syntax highlighting for `.blits` files and template strings
+- Code completion for components and attributes
+- IntelliSense for Blits APIs
 
-- **Toggle Comment** (`Ctrl + /` / `Cmd + /` on Mac): Comment/uncomment Blits template sections.
+### [ESLint Plugin](./eslint-plugin-blits)
 
-## Features
+ESLint plugin for Blits framework applications:
+- Linting support for `.blits` files
+- Analysis for JS/TS template literals
+- Custom rules optimized for Blits development
 
-### **1. Syntax Highlighting**
+### [Prettier Plugin](./prettier-plugin-blits)
 
-- Full support for Blits template syntax inside JavaScript and TypeScript files.
-- Dedicated syntax highlighting for `.blits` files, including **script and template sections**.
+Prettier formatting plugin for Blits templates:
+- Consistent formatting for `.blits` files
+- Template string formatting in JS/TS files
+- Configurable formatting options
 
-### **2. Code Completion (IntelliSense)**
-
-- Auto-suggestions for Blits **component names, attributes, and built-in directives**.
-- Supports both built-in and custom components inside **template strings and `.blits` files**.
-- Provides **context-aware** suggestions based on cursor position.
-
-### **3. Commenting Support**
-
-- Enables **HTML-style commenting/uncommenting** for template sections.
-- Uses `<!-- -->` for templates and `//` for script sections.
-
-### **4. Custom `.blits` File Support**
-
-- Full **language support** for `.blits` files:
-  - **Syntax highlighting**
-  - **IntelliSense** for template and script sections
-  - **Signature help** for component methods
-  - **Hover information** for component props and attributes
-  - **Error diagnostics** for template syntax
-
-### **5. Code Snippets**
-
-Enhance your coding efficiency with built-in snippets for Blits development. These snippets provide templates for common structures and patterns in Blits applications, helping you write code more quickly and consistently across JavaScript, TypeScript, and `.blits` files.
-
-| Snippet Prefix | Description |
-|----------------|-------------|
-| `blits-file` | Creates a basic `.blits` file structure with template and script sections |
-| `blits-component` | Scaffolds a complete Blits component structure in JS/TS files |
-| `blits-input` | Adds customizable input handler methods with selectable key options |
-| `blits-input-block` | Inserts a complete input object with handlers for all common keys |
-| `blits-hooks` | Adds individual lifecycle hook methods with method selection |
-| `blits-hooks-block` | Inserts all major lifecycle hooks at once (init, ready, focus, unfocus, destroy) |
-| `blits-attribute-transition` | Creates attribute transition syntax for animations in template strings |
-
-### **6. Code Formatting**
-
-- Automatic formatting of **Blits template strings** inside JS/TS files.
-- Auto-formats **entire `.blits` files on save**.
-- Configurable **Prettier-based** formatting settings.
-
-You can disable the auto-formatting feature by setting the `blits.autoFormat` configuration option to `false`.
-
-#### Available Settings
-
-The extension provides several configuration options to customize the formatting experience:
-
-| Setting | Default | Description |
-|---------|---------|-------------|
-| `blits.format.printWidth` | `120` | The line length that the printer will wrap on |
-| `blits.format.tabWidth` | `2` | Indentation size |
-| `blits.format.useTabs` | `false` | When `true`, indents with tabs instead of spaces |
-| `blits.format.semi` | `false` | Print semicolons at the ends of statements |
-| `blits.format.singleQuote` | `true` | Use single quotes instead of double quotes |
-| `blits.format.quoteProps` | `as-needed` | Controls when to quote object properties:<br>• `as-needed`: Only when required<br>• `consistent`: If any property requires quotes<br>• `preserve`: Respects original formatting |
-| `blits.format.trailingComma` | `all` | Controls trailing commas:<br>• `all`: Add wherever possible<br>• `none`: Remove all trailing commas<br>• `es5`: Add except in function parameters |
-| `blits.format.bracketSpacing` | `true` | Print spaces between brackets in object literals |
-| `blits.format.bracketSameLine` | `false` | Put the `>` of a multi-line tag at the end of the last line |
-
-#### Customizing Settings
-
-To customize these settings:
-
-1. Open VSCode settings (File > Preferences > Settings or `Ctrl+,` / `Cmd+,` on Mac)
-2. Search for `Blits` to find all relevant settings
-3. Modify as needed - changes will be applied immediately
-
-You can also edit the `.vscode/settings.json` file directly to configure these options.
-
-## Feedback & Contributions
-
-This extension is **open-source**. If you encounter issues or have feature requests, please visit the [GitHub Repository](https://github.com/lightning-js/blits-vscode-extension) and submit an issue or contribute to the codebase.
-
----
-
-**Enhance your Blits development experience today! 🚀**