stan-language-server 0.1.0-beta.13 → 0.1.0

package/CHANGELOG.md

@@ -5,150 +5,35 @@ 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).
 
-## [Unreleased] - Production Ready Release
-
-### Summary
-Complete Language Server Protocol implementation for Stan with all core features:
-- **Completion**: Keywords, distributions, functions, datatypes, constraints
-- **Hover**: Function and distribution documentation 
-- **Diagnostics**: Compiler errors and warnings
-- **Formatting**: Stan code formatting via native compiler
-- **Include Resolution**: Comprehensive #include handling
-
-Current status: 109 tests passing across 14 test files with production-ready stability.
-
-### Added - Complete Feature Set
-- **Formatting System**: Full document formatting using Stan compiler
-  - `src/handlers/formatting.ts`: LSP protocol conversion for formatting requests
-  - `src/language/formatting/provider.ts`: Pure formatting provider using Stan compiler
-  - `src/types/formatting.ts`: Domain types for formatting context and results
-  - Comprehensive formatting tests with includes integration
-  - Support for both `.stan` and `.stanfunctions` files
-- **Enhanced Include Resolution**: Robust #include file handling
-  - Workspace document prioritization with filesystem fallback
-  - Proper error handling for missing include files
-  - Support for relative and absolute include paths
-  - Integration with all language features (completion, hover, diagnostics, formatting)
-
-### Changed - Architecture Refinements
-- **Unified Compiler Integration**: Consolidated Stan compiler usage across all features
-  - `src/stanc/provider.ts`: Unified provider interface for compilation tasks
-  - Consistent compilation handling for diagnostics and formatting
-  - Improved error handling and type safety for compiler results
-- **Enhanced Handler System**: All LSP features follow consistent patterns
-  - `src/handlers/completion.ts`: Completion provider to LSP conversion
-  - `src/handlers/hover.ts`: Hover provider to LSP conversion  
-  - `src/handlers/diagnostics.ts`: Diagnostic provider to LSP conversion
-  - `src/handlers/formatting.ts`: Formatting provider to LSP conversion
-  - `src/handlers/compilation/`: Dedicated compilation utilities
-
-### Fixed - Production Stability
-- **Include Resolution**: Fixed filesystem fallback when workspace documents unavailable
-- **Test Isolation**: Enhanced test cleanup preventing cross-test interference
-- **Type Safety**: Improved TypeScript strict mode compliance across all modules
-- **Error Handling**: Robust error handling for edge cases in all language features
-- All 109 tests passing with comprehensive coverage of core functionality
-
-### Technical Improvements - Production Quality
-- **Clean Architecture**: Complete separation of language logic from LSP protocol
-- **Type Safety**: Comprehensive TypeScript types for all domain objects
-- **Testability**: Pure functions with no external dependencies in language layer  
-- **Maintainability**: Clear module boundaries and single responsibility principle
-- **Performance**: Efficient include resolution with workspace/filesystem caching
-- **Consistency**: All features follow identical architectural patterns
-- **Documentation**: Comprehensive inline documentation and type definitions
-
-## [v0.5.0] - Compilation Handler Refactoring
-
-### Changed
-- **BREAKING**: Refactored compilation architecture to improve modularity and maintainability
-  - Replaced direct `compile()` usage with `handleCompilation()` throughout codebase
-  - Moved compilation logic from scattered locations into dedicated handlers
-  - Centralized include file resolution and compilation handling
-  - Improved integration between compilation and include resolution systems
-
-### Added
-- New compilation handler system in `src/handlers/compilation/`:
-  - `src/handlers/compilation/compilation.ts`: Main compilation handler with `handleCompilation()` function
-  - `src/handlers/compilation/includes.ts`: Dedicated include file resolution handler
-  - Proper TypeScript types for Stan compiler integration (`StancReturn`, `StancSuccess`, `StancFailure`)
-- Enhanced compilation workflow:
-  - Integrated include file resolution directly into compilation process
-  - Configurable Stan compiler arguments and options
-  - Support for both `.stan` and `.stanfunctions` file types
-
-### Technical Improvements
-- **Modularity**: Compilation logic properly encapsulated in dedicated handlers
-- **Maintainability**: Clear separation between compilation, includes, and diagnostics
-- **Consistency**: All features now follow same handler-based architectural pattern
-- **Type Safety**: Better TypeScript integration with Stan compiler results
-- **Code Quality**: Eliminated duplicate compilation logic across codebase
-
-## [v0.4.0] - Diagnostic System Implementation
-
-### Added
-- New diagnostic system architecture following completion handler pattern:
-  - `src/types/common.ts`: Shared `Position` interface used by both completion and diagnostics
-  - `src/types/diagnostics.ts`: Domain types (`Range`, `DiagnosticSeverity`, `StanDiagnostic`)
-  - `src/language/diagnostics/provider.ts`: Pure diagnostic provider returning domain types
-  - `src/language/diagnostics/linter.ts`: Message processing utilities
-  - `src/language/diagnostics/index.ts`: Barrel exports for diagnostic functionality
-  - `src/handlers/diagnostics.ts`: LSP protocol conversion layer for diagnostics
-- Server capabilities now include `diagnosticProvider` for LSP compliance
-
-### Changed
-- **BREAKING**: Refactored diagnostic architecture to implement LSP-compliant diagnostics
-  - Removed automatic validation on document content changes (performance improvement)
-  - Implemented proper `textDocument/diagnostic` request handler following LSP specification
-  - Language diagnostic functions now return domain types (`StanDiagnostic[]`) instead of LSP types
-  - Eliminated LSP dependencies from language layer diagnostic code
-
-### Technical Improvements
-- **Performance**: Diagnostics no longer run on every keystroke, only when explicitly requested
-- **LSP Compliance**: Proper `textDocument/diagnostic` request handling instead of automatic publishing
-- **Resource Efficiency**: Significantly reduced CPU usage during active editing
-- **Clean Architecture**: Complete separation between diagnostic domain logic and LSP protocol
-
-## [v0.3.0] - Hover System Implementation
-
-### Added
-- Pure hover providers in `src/language/hover/`:
-  - `provider.ts`: Main hover provider that coordinates function and distribution hover
-  - `functions.ts`: Function name extraction from call contexts
-  - `distributions.ts`: Distribution function mapping from sampling contexts
-  - `util.ts`: Text parsing utilities
-- `src/handlers/hover.ts`: LSP protocol conversion for hover responses
-
-### Changed
-- **BREAKING**: Refactored hover functionality following same pattern as completion
-- Separated function hover and distribution hover logic
-- Created shared utilities for text parsing and word boundary detection
-
-## [v0.2.0] - Completion System Refactoring
-
-### Changed
-- **BREAKING**: Refactored completion providers to return domain types (`Keyword[]`, `Distribution[]`, etc.)
-- Created handlers layer for LSP protocol conversion
-- Established clean dependency flow: `server.ts` → `handlers` → `language/providers`
-- Removed LSP dependencies from `src/language` modules
-
-### Added
-- New completion handler system in `src/handlers/`:
-  - `src/handlers/completion.ts`: Converts provider results to LSP `CompletionItem[]`
-  - `src/handlers/index.ts`: Barrel export for all handlers
-- Common completion utilities in `src/language/completion/util.ts`
-- Comprehensive test suite for completion utilities
-
-### Technical Improvements
-- **Type Safety**: Leverages existing types from `src/types/completion.ts`
-- **Testability**: Pure functions that don't depend on LSP infrastructure
-- **Maintainability**: Clear boundaries and single responsibility principle
-
-## [v0.1.0] - Initial Implementation
+## [0.1.0] - 2025-09-13
 
 ### Added
-- Basic LSP server implementation using `vscode-languageserver`
-- Stan compiler integration with TypeScript types
-- Initial completion providers for keywords, distributions, functions, datatypes, constraints
-- Basic include file resolution
-- Test framework with Bun
+- **Language Server Protocol support** for Stan probabilistic programming language
+- **Code Completion** for Stan syntax elements:
+  - Keywords (`data`, `parameters`, `model`, `generated quantities`, etc.)
+  - Built-in functions (`normal`, `bernoulli`, `exp`, `log`, etc.)
+  - Distribution functions with proper sampling syntax
+  - Data types (`int`, `real`, `vector`, `matrix`, etc.)
+  - Constraints (`lower`, `upper`, `simplex`, etc.)
+- **Hover Information** with documentation for:
+  - Stan built-in functions
+  - Distribution functions with parameter details
+- **Real-time Diagnostics** powered by Stan compiler:
+  - Syntax errors and warnings
+  - Type checking and semantic analysis
+  - Compilation errors with line-precise locations
+- **Code Formatting** using native Stan compiler
+  - Consistent indentation and spacing
+  - Preservation of comments and structure
+- **Include File Resolution** for modular Stan programs:
+  - Support for `#include` directives
+  - Workspace-aware file resolution
+  - Cross-file compilation and analysis
+
+### Technical Features
+- Built with TypeScript and Bun runtime
+- Comprehensive test suite (109 tests across 14 test files)
+- Clean architecture separating language logic from LSP protocol
+- Support for both `.stan` and `.stanfunctions` files
+- Incremental document synchronization for performance
+- Robust error handling and graceful degradation

package/README.md

@@ -1,6 +1,14 @@
 # stan-language-server
 
-A language server for the Stan probabilistic programming language written in TypeScript and using Bun to build an executable binary. This is work in progress. 
+A language server for the Stan probabilistic programming language written in TypeScript and using Bun to build an executable binary.
+
+## Features
+
+- **Auto-completion**: Keywords, functions, distributions, data types, and constraints
+- **Hover information**: Documentation and type information
+- **Diagnostics**: Real-time syntax and semantic error detection
+- **Code formatting**: Using the official Stan compiler
+- **Include file support**: Full `#include` resolution and compilation
 
 To install dependencies:
 

package/dist/server.js

@@ -89681,7 +89681,7 @@ async function getFormattingErrors(params, documents, workspaceFolders, logger)
   return result.errors || [];
 }
 // src/lib.ts
-var setUpLanguageServer = (connection) => {
+var startLanguageServer = (connection) => {
   connection.onInitialize((_params) => {
     connection.console.info("Initializing Stan language server...");
     return {
@@ -89726,12 +89726,12 @@ var setUpLanguageServer = (connection) => {
     const folders = await connection.workspace.getWorkspaceFolders() || [];
     try {
       return await handleFormatting(params, documents, folders, connection.console);
-    } catch (error) {
+    } catch (_error) {
       const errors = await getFormattingErrors(params, documents, folders, connection.console);
       if (errors.length > 0) {
         connection.console.error("Formatting error:");
-        for (const error2 of errors) {
-          connection.console.error(error2);
+        for (const error of errors) {
+          connection.console.error(error);
         }
       }
       return [];
@@ -89747,7 +89747,7 @@ var setUpLanguageServer = (connection) => {
   documents.listen(connection);
   connection.listen();
 };
-var lib_default = setUpLanguageServer;
+var lib_default = startLanguageServer;
 
 // src/server.ts
 var connection = import_node2.createConnection(process.stdin, process.stdout);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "stan-language-server",
-  "version": "0.1.0-beta.13",
+  "version": "0.1.0",
   "description": "Language Server Protocol implementation for the Stan probabilistic programming language",
   "main": "dist/server.js",
   "module": "src/server.ts",
   "type": "module",
   "bin": {
-    "stan-language-server": "./dist/server.js"
+    "stan-language-server": "dist/server.js"
   },
   "files": [
     "dist/**/*",
@@ -54,7 +54,7 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/node": "24.3.1",
+    "@types/node": "24.4.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",