BrightScript Parser

npm install kopytko-brightscript-parser

import { tokenize, parse, buildScopes } from 'kopytko-brightscript-parser';

const source = `
function add(a as Integer, b as Integer) as Integer
  return a + b
end function
`;

// 1. Tokenize — get the raw token stream
const tokens = tokenize(source);
console.log(tokens.length);          // 20 tokens
console.log(tokens[0].kind);         // 'Function'
console.log(tokens[0].text);         // 'function'

// 2. Parse — get the full CST + diagnostics
const { root, diagnostics } = parse(source);
console.log(diagnostics.length);     // 0 (no errors)

// 3. Scope analysis
const scope = buildScopes(root);
const addDecl = scope.declarations.get('add');
console.log(addDecl?.kind);          // 'function'

import { parse, wrapNode, SourceFile, FunctionDeclaration, walk } from 'kopytko-brightscript-parser';

const { root } = parse(`
function greet(name as String) as String
  return "Hello, " + name
end function
`);

const file = wrapNode(root) as SourceFile;

// Walk the AST with a visitor
walk(file, {
  visitFunctionDeclaration(node: FunctionDeclaration) {
    console.log('Function:', node.name?.text);
    console.log('Params:', node.parameterList?.parameters.map(p => p.name?.text));
    console.log('ReturnType:', node.returnTypeClause?.typeName?.text);
  }
});
// Function: greet
// Params: ['name']
// ReturnType: String

import { parse, buildScopes, resolve, findScopeAtLine } from 'kopytko-brightscript-parser';

const source = `
function outer() as Void
  x = 10
  inner = function(y as Integer) as Integer
    return x + y
  end function
end function
`;

const { root } = parse(source);
const fileScope = buildScopes(root);

// outer() scope
const outerScope = fileScope.children[0];
console.log(outerScope.ownerName);   // 'outer'
console.log([...outerScope.declarations.keys()]);
// ['x', 'inner']

// Resolve a name from the inner scope
const innerScope = outerScope.children[0];
const xDecl = resolve('x', innerScope);
console.log(xDecl?.kind);            // 'variable' (found in parent scope)

// Find innermost scope at a given line (0-based)
const scope = findScopeAtLine(fileScope, 4);
console.log(scope.ownerName);        // '<anonymous>'