@algosail/compiler

Compiles Sail source to JavaScript.

API

compile(uri, sailSource, options?)

import { compile } from '@algosail/compiler'

const { js, errors } = await compile('file:///app/main.sail', source, { outPath: '/app' })

• uri — File URI of the Sail file
• sailSource — Sail source string
• options.outPath — Output directory for import resolution

Returns { js?, sourceMap?, errors: Array<{ message, startPosition?, uri?, hint? }> }.

Options:

• outPath — Output directory for resolving relative imports
• sourceMap — Generate source map (default: false unless outFile provided)
• outFile — Output file path (required for source map generation)

CLI

sail-compile input.sail [--out output.js] [--no-source-map]

• Writes compiled JS to output.js or input.js by default
• Emits input.js.map and //# sourceMappingURL= when source maps enabled
• Errors printed as file:line:col: message with optional hints

Structure

| File | Role | |------|------| | lib/emitWord.js | Emit word as JS function | | lib/emitStep.js | Emit single step (builtin, word ref, quotation, tag, …) | | lib/emitImports.js | Emit import statements | | lib/emitJSDoc.js | JSDoc for emitted words | | lib/buildSourceMap.js | Source map generation | | lib/formatError.js | Error formatting (file:line:col) | | lib/errorHints.js | Hints for common errors | | lib/parseMatchBlock.js | Parse MATCH block structure | | lib/expectedType.js | rawToJsLiteral, expected type for quotation |

Pipeline

1. Parse (via @algosail/parser)
2. Typecheck (via @algosail/typecheck)
3. Emit imports
4. Emit each word as a function

Dependencies

• @algosail/parser
• @algosail/typecheck
• @algosail/builtins

Tests

npm test

Uses brittle. See lang/docs/TESTING.md.