Errors and warnings

Every Ilha error and warning carries a stable ILHA code, a fix hint, and a docs link.

Ilha reports problems with a stable code. Each message follows one shape, so you and your tools can match on the code instead of the wording:

[ILHA001] <what went wrong>. Fix: <what to do> See https://ilha.build/errors/ILHA001

Errors are IlhaError instances. They expose code, fix, and docs:

import { class IlhaError
Error thrown by ilha with a stable `code`, a `fix` hint and a `docs` URL.IlhaError, const atom: AtomFnatom } from "ilha";

try {
  atom<number>(init: number | Atom<number>, options?: AtomOptions<number> | undefined): AtomHandle<number> (+1 overload)
An existing Effect atom, or a plain value. Store a function with
`atom.lazy(() => fn)`; the `ilha/oxlint` rule `function-in-atom` flags
`atom(fn)`.atom(0);
} catch (var error: unknownerror) {
  if (var error: unknownerror instanceof class IlhaError
Error thrown by ilha with a stable `code`, a `fix` hint and a `docs` URL.IlhaError) {
    var console: Consoleconsole.Console.log(...data: any[]): void (+1 overload)
The **`console.log()`** static method outputs a message to the console.

[MDN Reference](https://developer.mozilla.org/docs/Web/API/console/log_static)log(var error: IlhaErrorerror.IlhaError.code: IlhaCodecode, var error: IlhaErrorerror.IlhaError.fix: stringfix, var error: IlhaErrorerror.IlhaError.docs: stringdocs);
  }
}

Warnings go through console.warn with the same message shape. Ilha shows each warning once per code and detail.