parser-core

Kind: Module

Source: parser-core

.NET project in solution

Description

parser-core is a .NET project that provides the core parsing functionality used by the solution. It is responsible for transforming raw input into structured results that can be consumed by higher-level services, applications, or integration layers.

Diagram

mermaid
graph TD
    A[Raw Input] --> B[parser-core]
    B --> C[Tokenization / Validation]
    C --> D[Parsed Models]
    D --> E[Consumer Applications]

Usage Example

ts
import { execFile } from "node:child_process";
import { promisify } from "node:util";

const execFileAsync = promisify(execFile);

async function parseInput(inputFile: string) {
  const { stdout, stderr } = await execFileAsync(
    "dotnet",
    ["run", "--project", "parser-core", "--", inputFile],
  );

  if (stderr) {
    console.warn(stderr);
  }

  return JSON.parse(stdout);
}

const result = await parseInput("./input.txt");
console.log(result);

AI Coding Instructions

• Keep parsing rules and domain parsing models inside parser-core; avoid duplicating parsing logic in consuming projects.
• Validate input early and return actionable parsing errors rather than allowing malformed input to reach downstream consumers.
• Preserve stable output models and error behavior, since other projects may depend on the parser's results.
• When adding syntax or input formats, add representative valid, invalid, and edge-case tests alongside the parser changes.
• Ensure consuming JavaScript or TypeScript integrations invoke the .NET project with the expected arguments and handle non-zero process exits.

Referenced By

• atloria (MODULE_DECLARES)