@bis-toolkit/cppparser 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# @bis-toolkit/cppparser
+
+Parser for Arma/DayZ `config.cpp` and RVMat files.
+
+Part of the [BIS Toolkit TypeScript](../../README.md) monorepo.
+
+## Features
+- Lex + parse Arma config syntax (variables, arrays, enums, classes, prototypes, deletes)
+- Simple preprocessor supporting `#define`, `#ifdef`/`#ifndef`, `#include` (only for node.js)
+- Produces a typed AST for further processing
+- RVMat file parsing (material definitions)
+
+## Installation
+
+```bash
+npm install @bis-toolkit/cppparser
+```
+
+From the monorepo root for development:
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+Parse an already-loaded string:
+
+```typescript
+import { Parser } from '@bis-toolkit/cppparser';
+
+const source = 'class MyClass { value = 42; };';
+const ast = new Parser(source, 'inline').parse();
+console.log(ast.statements.length);
+```
+
+Preprocess and parse a `config.cpp` from disk:
+
+```typescript
+import { Parser, Preprocessor } from '@bis-toolkit/cppparser';
+import { join } from 'path';
+
+const configPath = join(process.cwd(), 'config.cpp');
+const pre = new Preprocessor();
+const text = pre.preprocess(configPath);
+const ast = new Parser(text, configPath).parse();
+console.log(`Statements: ${ast.statements.length}`);
+```
+
+## License
+
+GPLv3 © Alpine Labs - see [LICENSE](LICENSE).

package/dist/RvmatParser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Simple RVMAT (material) file parser
+ * Extracts texture paths from Stage definitions
+ */
+export interface RvmatStage {
+    name: string;
+    texture: string;
+}
+export interface RvmatData {
+    stages: RvmatStage[];
+    ambient?: number[];
+    diffuse?: number[];
+    forcedDiffuse?: number[];
+    emmisive?: number[];
+    specular?: number[];
+    specularPower?: number;
+    pixelShaderID?: string;
+    vertexShaderID?: string;
+}
+export declare class RvmatParser {
+    /**
+     * Parse RVMAT file content
+     */
+    static parse(content: string, filename?: string): RvmatData;
+    private static findVariable;
+    private static extractStages;
+    private static findClassProperty;
+    private static readNumberArray;
+    private static readNumber;
+    private static readString;
+    private static toNumber;
+    private static isVariable;
+    private static isSimpleVariable;
+    private static isClass;
+    /**
+     * Get all texture paths from parsed data
+     */
+    static getTexturePaths(data: RvmatData): string[];
+    /**
+     * Get main diffuse/color texture (typically Stage1)
+     */
+    static getMainTexture(data: RvmatData): string | undefined;
+}

package/dist/ast.d.ts

@@ -0,0 +1,74 @@
+export type CfgNodeType = 'document' | 'variable' | 'array' | 'array-extend' | 'array-shrink' | 'enum' | 'class' | 'prototype' | 'delete';
+export type CfgType = string | number | boolean | null | CfgType[];
+export interface CfgBaseType {
+    kind: CfgNodeType;
+}
+/**
+ * Represents the root document containing all CFG statements
+ */
+export interface CfgDocument extends CfgBaseType {
+    kind: 'document';
+    statements: CfgBaseType[];
+}
+export interface CfgNamedType extends CfgBaseType {
+    name: string;
+}
+/**
+ * Represents a simple variable in Cfg ( myVar = 42; )
+ */
+export interface CfgSimpleVariable extends CfgNamedType {
+    kind: 'variable';
+    value: CfgType;
+}
+/**
+ * Represents a named variable in Cfg ( myVar[] = {42, "string", true}; )
+ */
+export interface CfgArrayVariable extends CfgNamedType {
+    kind: 'array';
+    values: CfgType[];
+}
+/**
+ * Represents a class definition in Cfg ( class MyClass : BaseClass { ... }; )
+ */
+export interface CfgClass extends CfgNamedType {
+    kind: 'class';
+    baseClassName?: string;
+    properties: Map<string, CfgBaseType>;
+}
+/**
+ * Represents a prototype definition in Cfg ( class MyPrototype; or class MyPrototype : BaseClass; )
+ */
+export interface CfgPrototype extends CfgNamedType {
+    kind: 'prototype';
+    baseClassName?: string;
+}
+/**
+ * Represents an array extension in Cfg ( myArray[] += {42, "string"}; )
+ */
+export interface CfgArrayExtend extends CfgNamedType {
+    kind: 'array-extend';
+    values: CfgType[];
+}
+/**
+ * Represents an array shrink in Cfg ( myArray[] -= {42, "string"}; )
+ */
+export interface CfgArrayShrink extends CfgNamedType {
+    kind: 'array-shrink';
+    values: CfgType[];
+}
+/**
+ * Represents a C-style enum in Cfg ( enum MyEnum { VAL1, VAL2 = 5, VAL3 }; )
+ */
+export interface CfgEnum extends CfgBaseType {
+    kind: 'enum';
+    members: {
+        name: string;
+        value?: number;
+    }[];
+}
+/**
+ * Represents a delete operation in Cfg ( delete MyClass; )
+ */
+export interface CfgDelete extends CfgNamedType {
+    kind: 'delete';
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RAP/CPP parser utilities
+ */
+export { type CfgType, type CfgBaseType, type CfgDocument, type CfgSimpleVariable, type CfgArrayVariable, type CfgArrayExtend, type CfgArrayShrink, type CfgEnum, type CfgClass, type CfgPrototype, type CfgDelete, type CfgNodeType, } from './ast';
+export { lex, TokenKind, isCfgKeyword, isCfgPunctuation, CfgKeywords, CfgPunctuations, CfgOperators, type CfgToken, } from './lexer';
+export { Parser } from './parser';
+export { Preprocessor, type PreprocessorOptions } from './preprocessor';
+export { type CfgPatch, type ScriptModule, type CfgMod, type CfgMods, type CfgPatches, type ProjectFile, } from './project';
+export { RvmatParser, type RvmatData, type RvmatStage } from './RvmatParser';