chamber-abc

ABC notation language toolkit for the browser - parser, analyzer, formatter, and tokenizer.

Installation

``bash
npm install chamber-abc
`

Usage

`javascript
import init, { parse, analyze, format, format_default } from 'chamber-abc';

// Initialize WASM
await init();

const source = X:1
T:Test Tune
M:4/4
L:1/8
K:C
CDEF GABc|;

// Parse
const result = parse(source);
console.log(result.tune); // AST
console.log(result.diagnostics); // Parse errors/warnings

// Analyze (semantic checks)
const analysis = analyze(result.tune);
console.log(analysis.diagnostics); // Lint warnings

// Format
const formatted = format_default(source);
`

API

$3

Parse ABC notation and return AST with diagnostics.

$3

Run semantic analysis (linting) on parsed tune.

$3

Format ABC notation with custom configuration.

$3

Format with default settings (normalize spacing, etc).

$3

Format with minimal changes (cleanup only).

$3

Return source unchanged.

$3

Convert byte offset to line/column position.

$3

Tokenize source for syntax highlighting. Returns array of tokens:
`javascript
const tokens = tokenize(source);
// [
// { kind: "FieldLabel", range: { start: 0, end: 1 } },
// { kind: "Colon", range: { start: 1, end: 2 } },
// { kind: "Note", range: { start: 20, end: 21 } },
// ...
// ]
`

Token kinds: FieldLabel, Note, Rest, Sharp, Flat, Natural, Bar, DoubleBar, RepeatStart, RepeatEnd, Decoration, Comment, Tuplet, Tie, Number, Text, Whitespace, Newline`, etc.

License

MIT