language-service 0.0.2-preview.1

The Zena language service, which gives editors diagnostics, completions and navigation

Readme Files Dependencies Versions

language-service#

The Zena language service and Language Server Protocol (LSP) library: diagnostics, lint findings and quick fixes, hover, completions, go-to-definition, document symbols, and formatting.

Used by zena lsp (in packages/cli) and compiled to WebAssembly by @zena-lang/compiler (packages/compiler-js) for JavaScript, browser, and VS Code hosts.

Usage in Zena#

import { createLanguageService } from 'language-service';
import { LspServer } from 'language-service/server';
import { readFile } from 'zena:fs';

async function readOrNull(path: String): Future<String | null> {
  try {
    return await readFile(path);
  } catch (e) {
    return null;
  }
}

let service = createLanguageService('/stdlib', readOrNull, 'zena-component');
let diagnostics = await service.check('/workspace/main.zena', 'export let x = 42;');

Zena Libraries#

  • language-service / language-service/service — LanguageService (createLanguageService, check, lint, hover, completions, definition, documentSymbols)
  • language-service/server — LspServer JSON-RPC request/notification handler (LspServer, MessageReader, frame, offsetOf, positionOf)
  • language-service/protocol — LSP JSON serializers and error codes
  • language-service/framing — Content-Length message framing (MessageReader, frame)
  • language-service/positions — UTF-16 line/character positions to and from byte offsets (offsetOf, positionOf)
  • language-service/hover — hover type and doc-comment formatting
  • language-service/completion — identifier, member, and keyword completions
  • language-service/symbols — document symbol outline (documentSymbols, DocumentSymbol, SymbolKind)
  • language-service/compile — in-memory compilation to WebAssembly bytes (compileToWasm)
  • language-service/host — overlay CompilerHost serving open documents in place of disk files (DocumentHost)
  • language-service/analysis — per-document checked AST and scope analysis

License#

MIT

1.9 KiB Rendered Raw
# `language-service`

The Zena language service and Language Server Protocol (LSP) library: diagnostics, lint findings and quick fixes, hover, completions, go-to-definition, document symbols, and formatting.

Used by `zena lsp` (in `packages/cli`) and compiled to WebAssembly by `@zena-lang/compiler` (`packages/compiler-js`) for JavaScript, browser, and VS Code hosts.

## Usage in Zena

```zena
import { createLanguageService } from 'language-service';
import { LspServer } from 'language-service/server';
import { readFile } from 'zena:fs';

async function readOrNull(path: String): Future<String | null> {
  try {
    return await readFile(path);
  } catch (e) {
    return null;
  }
}

let service = createLanguageService('/stdlib', readOrNull, 'zena-component');
let diagnostics = await service.check('/workspace/main.zena', 'export let x = 42;');
```

### Zena Libraries

- `language-service` / `language-service/service` — `LanguageService` (`createLanguageService`, `check`, `lint`, `hover`, `completions`, `definition`, `documentSymbols`)
- `language-service/server` — `LspServer` JSON-RPC request/notification handler (`LspServer`, `MessageReader`, `frame`, `offsetOf`, `positionOf`)
- `language-service/protocol` — LSP JSON serializers and error codes
- `language-service/framing` — `Content-Length` message framing (`MessageReader`, `frame`)
- `language-service/positions` — UTF-16 line/character positions to and from byte offsets (`offsetOf`, `positionOf`)
- `language-service/hover` — hover type and doc-comment formatting
- `language-service/completion` — identifier, member, and keyword completions
- `language-service/symbols` — document symbol outline (`documentSymbols`, `DocumentSymbol`, `SymbolKind`)
- `language-service/compile` — in-memory compilation to WebAssembly bytes (`compileToWasm`)
- `language-service/host` — overlay `CompilerHost` serving open documents in place of disk files (`DocumentHost`)
- `language-service/analysis` — per-document checked AST and scope analysis

## License

MIT
  • compiler compiler.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1
  • formatter formatter.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1
  • lint lint.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1
VersionPublishedDependenciesApproved by
0.0.2-preview.1 2026-11-19
  • compiler compiler.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1
  • formatter formatter.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1
  • lint lint.zena-lang.pkg.zena-lang.dev 0.0.2-preview.1