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

2.1 KiB Raw
/**
 * The protocol's base layer: each message is a block of headers, a
 * blank line, and a body of `Content-Length` bytes. The headers are
 * written the way HTTP writes them, one `Name: value` per line.
 */

import { StringReader } from 'zena:core';

/** The value of the `Content-Length` header in a header block, or -1. */
function contentLength(headers: String): i32 {
  for (let line in headers.split('\r\n')) {
    let reader = new StringReader(line);
    let name = reader.readUntil(':');
    if (name != null && name.trim().asciiLowerCase() == 'content-length') {
      return parseI32(reader.readToEnd().trim()) ?? -1;
    }
  }
  return -1;
}

/**
 * Takes a byte stream apart into messages, each a block of headers, a
 * blank line, and `Content-Length` bytes of body.
 */
export final class MessageReader {
  /** Reads what the input has next; '' at the end of it. */
  #read: () => Future<String>;
  var #buffer = '';

  new(read: () => Future<String>) : #read = read;

  /** The next message's body, or null at the end of the input. */
  async next(): Future<String | null> {
    while (true) {
      let body = this.#take();
      if (body != null) {
        return body;
      }
      let read = this.#read;
      let chunk = await read();
      if (chunk == '') {
        return null;
      }
      this.#buffer = this.#buffer + chunk;
    }
    return null;
  }

  /** A whole message's body from the front of the buffer, if it has one. */
  #take(): String | null {
    let reader = new StringReader(this.#buffer);
    let headers = reader.readUntil('\r\n\r\n');
    if (headers == null) {
      return null;
    }
    let length = contentLength(headers);
    if (length < 0) {
      throw new Error('A message has no Content-Length header');
    }
    // The length counts bytes, the way the protocol counts it.
    if (reader.remaining < length) {
      return null;
    }
    let bodyStart = reader.mark();
    reader.skipBytes(length);
    let body = reader.sliceFrom(bodyStart);
    this.#buffer = reader.readToEnd();
    return body;
  }
}

/** A message with its `Content-Length` header, ready to write. */
export function frame(body: String): String {
  return `Content-Length: ${body.length}\r\n\r\n${body}`;
}
  • 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