Compiler API Reference

Programmatic API for @nooh-ts/compiler and bundler plugins.

The Nooh compiler is designed to be fully decoupled and usable programmatically in scripts, custom build tools, or bundler plugins.

compile Function

Compiles a snapshot of project files into a Compilation result.

import { compile } from "@nooh-ts/compiler";

const result = await compile({
  config: "src/config.ts",
  loader: {
    loadDefault: async (path) => import(path).then((m) => m.default),
  },
  sources: {
    files: [
      { path: "src/config.ts", content: "..." },
      { path: "src/routes/index.get.ts", content: "..." },
    ],
  },
  options: {
    outputRoot: ".nooh",
  },
});

console.log(result.diagnostics);
console.log(result.model.routes);

Compilation Result Interface

export interface Compilation {
  readonly diagnostics: readonly Diagnostic[];
  readonly model: ProjectModel;
  readonly plan: CompilationPlan | null;
  readonly output: GeneratedOutput | null;
}

• diagnostics: Array of compilation warnings and errors.
• model: Extracted AST representing routes, groups, and the DI graph.
• plan: Planned file outputs and module groupings.
• output: Generated source code strings for each module.

Bundler Plugins (@nooh-ts/plugin)

Import the plugin for your preferred build tool:

// Vite
import nooh from "@nooh-ts/plugin/vite";

// Rollup
import nooh from "@nooh-ts/plugin/rollup";

// Webpack
import nooh from "@nooh-ts/plugin/webpack";

// esbuild
import nooh from "@nooh-ts/plugin/esbuild";