@aihu/language-server

function buildMigrateFix(source: string): MigrateFix | null

Run the macro-simplification codemod over `source` and return the fix payload.

async function compileWithDiagnostics( source: string, filePath: string, ): Promise<CompileResult>

Compile a .aihu source string via stdin, returning structured diagnostics.

function createAihuLanguagePlugin(): LanguagePlugin<URI, AihuVirtualCode>

Create the Volar LanguagePlugin for .aihu files.

function createAihuLanguageServicePlugin(): LanguageServicePlugin

Create the Volar LanguageServicePlugin for aihu.

function createTestServer()

Create and wire the test seam for integration / unit tests.

function getBlockContext( lines: string[], lineIndex: number, ): 'state' | 'template' | 'style' | 'agent' | 'route' | 'unknown'

function getHoverContent(macro: string): string | null

function getMacroAtPosition(lineText: string, character: number): string | null

function mapToOriginal( virtualOffset: number, map: SourceMap<CodeInformation>, ): AihuSourcePosition | null

Map a virtual-file offset back to the original .aihu source offset.

function mapToVirtual( originalOffset: number, _block: '@state', map: SourceMap<CodeInformation>, ): AihuVirtualPosition | null

Map an original .aihu source offset to the virtual-file offset.

function parseMachineErrors(stderr: string, filePath: string): AihuDiagnostic[]

Parse the Rust binary's `--machine-errors` stderr stream into structured diagnostics.

function startServer(): void

Start the language server on stdio and begin listening.

function withAihuDiagnosticParity(plugin: LanguageServicePlugin): LanguageServicePlugin

Wrap a TypeScript LanguageServicePlugin (volar-service-typescript) so its diagnostics apply the SAME implicit-`any` suppression `aihu-tsc` applies to `.aihu` files by default (`IMPLICIT_ANY_CODES`, packages/tsc/src/index.ts).

const BLOCK_COMPLETIONS: LspCompletionItem[]

Top-level block completions (triggered by '@' at top level).

const MIGRATE_CODES

Compiler diagnostic codes whose QuickFix is the v2 macro migration codemod.

const SourceMap

const STATE_MACRO_COMPLETIONS: LspCompletionItem[]

v2 macro-kind snippet completions (triggered by ' in

interface AihuDiagnostic {
  code: string
  message: string
  // `| undefined` is explicit so the raw compiler error's optional hint/fix
  // (which may be undefined) assign cleanly under exactOptionalPropertyTypes.
  hint?: string | undefined
  fix?: string | undefined
  /** Original source text to replace (for code-action text edits). */
  fromText: string | null
  /** Replacement text (for code-action text edits). */
  toText: string | null
  /** 0-based LSP range. null when position is unknown. */
  range: {
    start: { line: number; character: number }
    end: { line: number; character: number }
  } | null
}

Normalised diagnostic with 0-based LSP positions.

interface AihuSourcePosition {
  /** Character offset from the start of the .aihu source string. */
  offset: number
}

An offset within a .aihu source file (character offset from start of file).

interface AihuVirtualPosition {
  /** Character offset in the __state__.ts virtual file. */
  offset: number
}

An offset within a virtual __state__.ts file generated from the

interface CompileResult {
  code: string | null
  diagnostics: AihuDiagnostic[]
}

interface LspCompletionItem {
  label: string
  kind: number
  insertTextFormat: number
  detail: string
  sortText: string
  insertText: string
}

interface MigrateFix {
  /** The full-document rewritten source. */
  rewritten: string
  /** Codemod warnings (e.g. @agent referencing unknown @state name). */
  warnings: readonly string[]
  /** Human-readable action title (includes warning count when non-zero). */
  title: string
}

type AihuCodeMapping = Mapping<CodeInformation>

Alias for clarity: a Volar CodeMapping carrying CodeInformation data.

type AihuVirtualCode