@zenithbuild/language-server 0.2.7 → 0.5.0-beta.2.1

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.8] - 2026-01-26
+
+### 📝 Other Changes
+
+- **** ()
+
 ## [0.2.1] - 2026-01-16
 
 ### 🐛 Bug Fixes

package/README.md

@@ -12,6 +12,20 @@ This package provides the "brains" for Zenith editor support. It implements the
 - **Completion**: Context-aware suggestions for Zenith-specific syntax and standard HTML.
 - **Hover Information**: Detailed documentation on hover for core components and hooks.
 - **Document Symbols**: Outline and navigation support for complex components.
+- **Contract Enforcement**:
+  - `on:click={handler}` event syntax diagnostics + quick fixes for `onclick` / `@click`.
+  - Component script policy (`zenith.componentScripts`: `forbid` | `allow`).
+  - CSS import contract diagnostics for local precompiled CSS only.
+- **Project Root Resolution**:
+  - nearest `zenith.config.*`
+  - nearest `package.json` with `@zenithbuild/cli`
+  - workspace-aware fallback heuristics
+
+## Settings
+
+- `zenith.componentScripts`
+  - `forbid` (default): components may not contain `<script>`.
+  - `allow`: disables the component-script contract diagnostic.
 
 ## Architecture
 

package/RELEASE_NOTES.md

@@ -0,0 +1,33 @@
+# 🚀 @zenithbuild/language-server v0.2.9
+
+## [0.2.9] - 2026-02-15
+
+### ✨ Contract Updates
+
+- Added component script policy diagnostics with configurable mode:
+  - `zenith.componentScripts = "forbid" | "allow"`.
+- Added event binding syntax diagnostics and quick fixes:
+  - invalid: `onclick="..."`, `@click={...}`
+  - valid: `on:click={handler}`.
+- Added Tailwind v4-compatible CSS import contract diagnostics:
+  - allow local CSS imports (including `?query`/`#hash` suffixes)
+  - fail bare CSS package imports and project-root traversal escapes.
+- Added workspace-aware project root resolution heuristics.
+- Added unit tests for root resolution, CSS suffix/path contracts, component script diagnostics, and event-binding code actions.
+
+
+
+## 📦 Installation
+
+```bash
+bun add @zenithbuild/language-server@0.2.9
+```
+
+*or with npm:*
+
+```bash
+npm install @zenithbuild/language-server@0.2.9
+```
+
+---
+*Generated by Zenith Automated Release*

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@zenithbuild/language-server",
-  "version": "0.2.7",
+  "version": "0.5.0-beta.2.1",
   "description": "Language Server for Zenith Framework",
   "main": "./dist/server.js",
   "types": "./dist/server.d.ts",
   "scripts": {
-    "build": "npx esbuild src/server.ts --bundle --outdir=dist --platform=node --format=cjs",
+    "build": "npx esbuild src/server.ts --bundle --outdir=dist --platform=node --format=cjs --external:@zenithbuild/compiler --external:vscode-languageserver/node --external:vscode-languageserver-textdocument",
+    "test": "npm run test:unit",
+    "test:unit": "bun test test/*.spec.ts",
     "dev": "npm run build -- --watch",
     "release": "bun run scripts/release.ts",
     "release:dry": "bun run scripts/release.ts --dry-run",
@@ -14,6 +16,7 @@
     "release:major": "bun run scripts/release.ts --bump=major"
   },
   "dependencies": {
+    "@zenithbuild/compiler": "^1.3.0",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.11"
   },

package/scripts/release.ts

@@ -279,9 +279,13 @@ function generateChangelog(
     changelog += `### ⚠️ BREAKING CHANGES\n\n`;
     for (const commit of breakingChanges) {
       const scope = commit.scope ? `**${commit.scope}**: ` : "";
-      changelog += `- ${scope}${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+      changelog += `#### ${scope}${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+      if (commit.body) {
+        changelog += `\n${commit.body.split('\n').map(line => `> ${line}`).join('\n')}\n`;
+      }
+      changelog += "\n";
     }
-    changelog += "\n";
+    changelog += "---\n\n";
   }
 
   // Regular changes by type
@@ -294,7 +298,14 @@ function generateChangelog(
     changelog += `### ${typeConfig.title}\n\n`;
     for (const commit of typeCommits) {
       const scope = commit.scope ? `**${commit.scope}**: ` : "";
-      changelog += `- ${scope}${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+      changelog += `- **${scope}${commit.subject}** (${commit.hash.slice(0, 7)})\n`;
+
+      // Include body if present
+      if (commit.body && commit.body.trim()) {
+        const cleanedBody = commit.body.trim();
+        // Indent body for better hierarchy
+        changelog += `${cleanedBody.split('\n').map(line => `  > ${line}`).join('\n')}\n`;
+      }
     }
     changelog += "\n";
   }
@@ -303,7 +314,10 @@ function generateChangelog(
   if (groupedCommits.other && groupedCommits.other.length > 0) {
     changelog += `### 📝 Other Changes\n\n`;
     for (const commit of groupedCommits.other) {
-      changelog += `- ${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+      changelog += `- **${commit.subject}** (${commit.hash.slice(0, 7)})\n`;
+      if (commit.body && commit.body.trim()) {
+        changelog += `${commit.body.trim().split('\n').map(line => `  > ${line}`).join('\n')}\n`;
+      }
     }
     changelog += "\n";
   }
@@ -319,21 +333,24 @@ function generateReleaseNotes(
 ): string {
   const changelog = generateChangelog(commits, newVersion, config);
 
-  return `# ${packageName} v${newVersion}
+  return `# 🚀 ${packageName} v${newVersion}
 
 ${changelog}
 
-## Installation
+## 📦 Installation
 
 \`\`\`bash
 bun add ${packageName}@${newVersion}
 \`\`\`
 
-or with npm:
+*or with npm:*
 
 \`\`\`bash
 npm install ${packageName}@${newVersion}
 \`\`\`
+
+---
+*Generated by Zenith Automated Release*
 `;
 }
 

package/src/code-actions.ts

@@ -0,0 +1,60 @@
+import {
+    ZenithDiagnostic,
+    ZenithRange
+} from './diagnostics';
+
+export const EVENT_BINDING_DIAGNOSTIC_CODE = 'zenith.event.binding.syntax';
+
+export interface EventBindingCodeActionData {
+    replacement: string;
+    title: string;
+}
+
+export interface ZenithCodeAction {
+    title: string;
+    kind: string;
+    diagnostics: ZenithDiagnostic[];
+    edit: {
+        changes: Record<string, Array<{ range: ZenithRange; newText: string }>>;
+    };
+    isPreferred?: boolean;
+}
+
+interface ZenithTextDocumentLike {
+    uri: string;
+}
+
+export function buildEventBindingCodeActions(
+    document: ZenithTextDocumentLike,
+    diagnostics: ZenithDiagnostic[]
+): ZenithCodeAction[] {
+    const actions: ZenithCodeAction[] = [];
+
+    for (const diagnostic of diagnostics) {
+        if (diagnostic.code !== EVENT_BINDING_DIAGNOSTIC_CODE) {
+            continue;
+        }
+
+        const data = diagnostic.data as EventBindingCodeActionData | undefined;
+        if (!data || typeof data.replacement !== 'string' || typeof data.title !== 'string') {
+            continue;
+        }
+
+        actions.push({
+            title: data.title,
+            kind: 'quickfix',
+            diagnostics: [diagnostic],
+            edit: {
+                changes: {
+                    [document.uri]: [{
+                        range: diagnostic.range,
+                        newText: data.replacement
+                    }]
+                }
+            },
+            isPreferred: true
+        });
+    }
+
+    return actions;
+}

package/src/contracts.ts

@@ -0,0 +1,100 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+export type ZenithFileKind = 'page' | 'layout' | 'component' | 'unknown';
+
+export function stripImportSuffix(specifier: string): string {
+    const hashIndex = specifier.indexOf('#');
+    const queryIndex = specifier.indexOf('?');
+
+    let cutAt = -1;
+    if (hashIndex >= 0 && queryIndex >= 0) {
+        cutAt = Math.min(hashIndex, queryIndex);
+    } else if (hashIndex >= 0) {
+        cutAt = hashIndex;
+    } else if (queryIndex >= 0) {
+        cutAt = queryIndex;
+    }
+
+    return cutAt >= 0 ? specifier.slice(0, cutAt) : specifier;
+}
+
+export function isLocalCssSpecifier(specifier: string): boolean {
+    return (
+        specifier.startsWith('./') ||
+        specifier.startsWith('../') ||
+        specifier.startsWith('/')
+    );
+}
+
+export function isCssContractImportSpecifier(specifier: string): boolean {
+    const normalized = stripImportSuffix(specifier).trim();
+    if (!normalized) {
+        return false;
+    }
+
+    if (normalized.endsWith('.css')) {
+        return true;
+    }
+
+    if (normalized === 'tailwindcss') {
+        return true;
+    }
+
+    if (/^@[^/]+\/css(?:$|\/)/.test(normalized)) {
+        return true;
+    }
+
+    return false;
+}
+
+function canonicalizePath(candidate: string): string {
+    try {
+        return fs.realpathSync.native(candidate);
+    } catch {
+        return path.resolve(candidate);
+    }
+}
+
+export function resolveCssImportPath(
+    importingFilePath: string,
+    specifier: string,
+    projectRoot: string
+): { resolvedPath: string; escapesProjectRoot: boolean } {
+    const normalizedSpecifier = stripImportSuffix(specifier);
+    const importingDir = path.dirname(importingFilePath);
+    const rootCanonical = canonicalizePath(projectRoot);
+
+    const unresolvedTarget = normalizedSpecifier.startsWith('/')
+        ? path.join(rootCanonical, normalizedSpecifier.slice(1))
+        : path.resolve(importingDir, normalizedSpecifier);
+
+    const targetCanonical = canonicalizePath(unresolvedTarget);
+    const relativeToRoot = path.relative(rootCanonical, targetCanonical);
+    const escapesProjectRoot =
+        relativeToRoot.startsWith('..') ||
+        path.isAbsolute(relativeToRoot);
+
+    return {
+        resolvedPath: targetCanonical,
+        escapesProjectRoot
+    };
+}
+
+export function classifyZenithFile(filePath: string): ZenithFileKind {
+    const normalized = filePath.replace(/\\/g, '/');
+
+    if (!normalized.endsWith('.zen')) {
+        return 'unknown';
+    }
+
+    if (normalized.includes('/src/pages/') || normalized.includes('/app/pages/')) {
+        return 'page';
+    }
+
+    if (normalized.includes('/src/layouts/') || normalized.includes('/app/layouts/')) {
+        return 'layout';
+    }
+
+    return 'component';
+}