c-parser

A C11 parser written in TypeScript with GCC extensions support. Zero runtime dependencies.

Try the online playground.

Built for use with AST Explorer.

Install

npm install c-parser

Usage

import { parse } from 'c-parser';

const ast = parse(`
int main(void) {
    return 0;
}
`);

console.log(JSON.stringify(ast, null, 2));

Options

parse(source, {
  gnuExtensions: true, // Enable GCC extensions (default: true)
  loc: false, // Compute line/column locations on demand (default: false)
});

AST Explorer Adapter

import adapter from 'c-parser/adapter';

API

| Export | Description | | ----------- | ------------------------------------ | | parse | Parse C source into an AST | | AST | All AST node type definitions | | Scanner | Lexer class for tokenization | | Parser | Parser class with token helpers | | TokenKind | Token kind enumeration (180+ tokens) |

Features

• Full C11 syntax support
• GCC __attribute__ extensions
• Inline assembly (asm / __asm__)
• Byte-range tracking on every AST node (start, end)
• Optional line/column location tracking (loc) when enabled
• Dual package: ESM + CommonJS

Development

pnpm build      # Build with tsup
pnpm test       # Run tests
pnpm lint       # Lint with oxlint
pnpm fmt        # Format with oxfmt

License

MIT