react-dsl-editor 0.3.0 → 0.3.4

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { CSSProperties } from 'react';
 import { JSX } from 'react/jsx-runtime';
 import { TextareaHTMLAttributes } from 'react';
 
@@ -11,36 +12,52 @@ export declare interface CSTNode<T extends string> {
     end: number;
     grammar: GrammarNode<T>;
     children?: CSTNode<T>[];
+    recoverableError: boolean;
 }
 
 export declare type CSTOf<T> = CSTNode<_NodeTypes<T>>;
 
+export declare function defaultSyntaxColors(theme: keyof typeof themes): (node: CSTNode<string>) => CSSProperties | undefined;
+
 export declare interface DSL<T extends string> {
     cst: CSTNode<T>;
     terminals: CSTNode<T>[];
     result: ParserSuccess<T>;
+    strictResult: ParserSuccess<T> | undefined;
+    errors: DSLError[];
 }
 
-export declare function DslEditor<T extends string>({ code, onChange, onParsed, grammar, wrap, suggestions: clientSuggestions, className, ...textareaProps }: {
+export declare function DslEditor<T extends string>({ code, onChange, onParsed, grammar, wrap, suggestions: clientSuggestions, className, syntaxColors, ...textareaProps }: {
     code: string;
     onChange: (text: string) => void;
-    onParsed?: (ast: ParserSuccess<T>) => void;
+    onParsed?: (dsl: DSL<T>) => void;
     grammar: GrammarNode<T>;
     wrap?: boolean;
     className?: string;
     suggestions?: (node: CSTNode<T>) => string[] | undefined;
+    syntaxColors?: SyntaxColorsProvider;
 } & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'wrap' | 'onChange'>): JSX.Element;
 
+export declare interface DSLError {
+    message: string;
+    start: number;
+    end: number;
+}
+
 export declare class DSLParser<T extends string> {
     private readonly grammar;
     constructor(grammar: GrammarNode<T>);
-    private _parse;
     parse(input: string): DSL<T>;
 }
 
 export declare const eof: GrammarNode;
 
-export declare function error<T extends string>(param: ParserError<T>): ParserError<T>;
+export declare function error<T extends string>(param: Omit<ParserError<T>, 'offset'>): {
+    offset: number;
+    grammar: GrammarNode<T>;
+    got: string;
+    expected: string[];
+};
 
 export declare interface GrammarNode<T extends string = never> {
     type: T;
@@ -71,6 +88,7 @@ export declare interface ParserError<T extends string = never> {
     grammar: GrammarNode<T>;
     got: string;
     expected: string[];
+    offset: number;
 }
 
 export declare type ParserResult<T extends string = never> = ParserSuccess<T> | ParserError<T>;
@@ -79,6 +97,7 @@ export declare interface ParserSuccess<T extends string = never> {
     text: string;
     grammar: GrammarNode<T>;
     children: ParserSuccess<T>[];
+    recoverableError?: boolean;
 }
 
 export declare class ParsingError extends Error {
@@ -97,9 +116,16 @@ export declare function sequence<T extends string>(...nodes: GrammarNode<T>[]):
 
 export declare function success<T extends string>(param: ParserSuccess<T>): ParserSuccess<T>;
 
+export declare type SyntaxColorsProvider = (node: CSTNode<string>) => CSSProperties | undefined;
+
 export declare function term(str: string): GrammarNode<never>;
 
-export declare function visit<T extends string, V = string>(parserResult: ParserSuccess<T>, type: T, extractor?: (node: ParserSuccess<T>) => V): V[];
+declare const themes: {
+    readonly light: string[];
+    readonly dark: string[];
+};
+
+export declare function visit<T extends string, V = string>(parserResult: ParserSuccess<T>, type: T[], extractor?: (node: ParserSuccess<T>) => V): V[];
 
 export declare const ws: GrammarNode<never>;