6.0.0 Breaking change: parser.parse() -> parse() with better error message

[AndrewRayCode]

This change adds a new API to access the parse function directly rather than import the parser. The README has been updated in this branch to reflect the change.

Old way to parse:

import { parser } from '@shaderfrog/glsl-parser';
import { parser as preprocessorParser } from '@shaderfrog/glsl-parser/preprocessor';
const ast = parser.parse(
  preprocessorParser.parse('float a = 1.0')
);

New way to parse:

import { parse } from '@shaderfrog/glsl-parser';
import { parse as preprocessorParse } from '@shaderfrog/glsl-parser/preprocessor';
const ast = parse(
  preprocessorParse('float a = 1.0')
);

parser.parse() exposes a GlslSyntaxError which is an alias for peggy.SyntaxError - the raw error from the Peggy parser. This error has a painful, confusing format() method that should not be exposed to end users.

When using parse() - it wraps the error in one that automatically formats it, hiding the grammarSource

When using parse() instead of parser.parse(), if you're checking the error type in a parse catch block. Old code:

console.log(error instanceof parser.SyntaxError);

New code:

import { GlslSyntaxError } from '@shaderfrog/glsl-parser';
console.log(error instanceof GlslSyntaxError)

Also if you were importing the error type, you need to update your code to import the class instance

import { type GlslSyntaxError } from '@shaderfrog/glsl-parser';

New code:

import { GlslSyntaxError } from '@shaderfrog/glsl-parser';