API Reference

Key exports and types from @constela/compiler

Key Exports

ExportDescription
compileMain compilation function
CompileOptionsConfiguration options for compilation
CompileResultResult containing generated code
transformAST transformation utilities

compile

The main compilation function:

typescript
function compile(program: Program, options?: CompileOptions): CompileResult;

CompileOptions

OptionTypeDefaultDescription
target"esm" | "cjs" | "iife""esm"Output module format
minifybooleanfalseMinify the output
sourcemapbooleanfalseGenerate source maps

CompileResult

typescript
interface CompileResult {
  ok: boolean;
  code?: string;
  program?: CompiledProgram;
  errors?: CompileError[];
  warnings?: CompileWarning[];
  sourcemap?: string;
}

CompileWarning

Warnings are non-blocking issues detected during compilation, such as accessibility violations:

typescript
interface CompileWarning {
  code: string;
  message: string;
  path: string;
}
FieldTypeDescription
codestringWarning code (e.g., "A11Y_IMG_NO_ALT")
messagestringHuman-readable description of the issue
pathstringJSON path to the offending node (e.g., "/view/children/0")

See Error Codes for the full list of warning codes.