create-yukigo-parser 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#! /usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,10 @@
+#! /usr/bin/env node
+import { program } from "commander";
+import { input } from "@inquirer/prompts";
+import { createProject } from "./utils.js";
+program
+    .version("1.0.0")
+    .description("An initializer for new yukigo parser projects.");
+const name = await input({ message: `Project Name:` });
+const projectName = `yukigo-${name}-parser`;
+createProject(projectName);

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,gDAAgD,CAAC,CAAC;AAEjE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AACvD,MAAM,WAAW,GAAG,UAAU,IAAI,SAAS,CAAC;AAE5C,aAAa,CAAC,WAAW,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+export declare const runCommand: (command: string, cwd: string, loadingMessage: string) => void;
+export declare function isEmpty(path: string): boolean;
+export declare const createProject: (projectName: string) => Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,KAAK,MAAM,EACX,gBAAgB,MAAM,SAUvB,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,WAEnC;AAED,eAAO,MAAM,aAAa,GAAU,aAAa,MAAM,kBAmEtD,CAAC"}

package/dist/utils.js

@@ -0,0 +1,105 @@
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import { execSync } from "child_process";
+import { readdirSync } from "fs";
+import fse from "fs-extra";
+import path from "path";
+const __dirname = import.meta.dirname;
+const TEMPLATE_DIR = path.join(__dirname, "..", "template");
+const INDEX_TEMPLATE_PATH = path.join("src", "index.ts");
+const TEST_TEMPLATE_PATH = path.join("tests", "parser.spec.ts");
+const CLASS_PLACEHOLDER = "YukigoParserPlaceholder";
+export const runCommand = (command, cwd, loadingMessage) => {
+    console.log(loadingMessage);
+    try {
+        execSync(command, { stdio: "inherit", cwd });
+    }
+    catch (error) {
+        console.error(`\nFailed to execute command: ${command}`);
+        // Exit process immediately on critical failure
+        process.exit(1);
+    }
+};
+export function isEmpty(path) {
+    return readdirSync(path).length === 0;
+}
+const toPascalCase = (str) => {
+    // First, replace non-alphanumeric separators (like hyphens, underscores) with a capitalized letter.
+    let pascal = str
+        .toLowerCase()
+        .replace(/[^a-zA-Z0-9]+(.)/g, (match, chr) => chr.toUpperCase());
+    // Then, ensure the very first letter is also capitalized.
+    return pascal.charAt(0).toUpperCase() + pascal.slice(1);
+};
+export async function replaceInFile(path, search, replace) {
+    let content = await fse.readFile(path, "utf-8");
+    const regex = new RegExp(`${search}`, "g");
+    content = content.replace(regex, replace);
+    await fse.writeFile(path, content);
+}
+export const createProject = async (projectName) => {
+    const targetDir = path.resolve(projectName);
+    console.log(`\n✨ Starting project setup for: ${chalk.bold.blue(projectName)}`);
+    // Directory Validation
+    if (fse.existsSync(targetDir)) {
+        console.error(`\n❌ Error: Directory '${projectName}' already exists.`);
+        process.exit(1);
+    }
+    // Copy Template Files
+    console.log(`\n📁 Setting up project in ${targetDir}...`);
+    try {
+        await fse.copy(TEMPLATE_DIR, targetDir);
+    }
+    catch (error) {
+        console.error("\n❌ Failed to copy template files:", error);
+        process.exit(1);
+    }
+    // Update package.json
+    const packageJsonPath = path.join(targetDir, "package.json");
+    try {
+        const packageJson = await fse.readJson(packageJsonPath);
+        packageJson.name = projectName;
+        await fse.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    }
+    catch (error) {
+        console.error("\n❌ Failed to update package.json:", error);
+        process.exit(1);
+    }
+    const projectNamePascal = toPascalCase(projectName);
+    const templateIndexPath = path.join(targetDir, INDEX_TEMPLATE_PATH);
+    const templateTestPath = path.join(targetDir, TEST_TEMPLATE_PATH);
+    try {
+        await replaceInFile(templateIndexPath, CLASS_PLACEHOLDER, projectNamePascal);
+        await replaceInFile(templateTestPath, CLASS_PLACEHOLDER, projectNamePascal);
+    }
+    catch (error) {
+        console.error("\n❌ Failed to update class name:", error);
+        process.exit(1);
+    }
+    console.log("✅ Initial project setted up correctly.");
+    // Initialize git if confirmed
+    const initGitRepo = await confirm({
+        message: `Do you want to initialize a git repository with the name '${projectName}'?`,
+    });
+    if (initGitRepo) {
+        runCommand("git init", targetDir, "\n🌱 Initializing Git repository...");
+        console.log("✅ Git repository initialized.");
+    }
+    const runInstall = await confirm({
+        message: `Do you want to install dependencies automatically?`,
+    });
+    // install deps if confirmed
+    if (runInstall) {
+        runCommand("npm install", targetDir, "\n📦 Installing dependencies (this may take a minute)...");
+        console.log("✅ Dependencies installed.");
+    }
+    // 6. Success Message
+    const successMsg = `${chalk.bold.green("Success!")} Project ${chalk.bold.blue(projectName)} is ready.`;
+    console.log("\n" + "-".repeat(successMsg.length));
+    console.log(successMsg);
+    console.log("-".repeat(successMsg.length));
+    console.log("\nNext steps:");
+    console.log(`1. ${chalk.bold(`cd ${projectName}`)}`);
+    console.log(`2. Start coding: ${chalk.bold("npm start")} (or ${chalk.bold("npm run build")})`);
+    console.log("\nHappy parsing! :)");
+};

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "create-yukigo-parser",
+  "description": "A CLI to quickly set up a new Yukigo parser project.",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "create-yukigo-parser": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "cli",
+    "typescript",
+    "parser"
+  ],
+  "author": "noiseArch",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.9.0",
+    "@types/fs-extra": "^11.0.4",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "fs-extra": "^11.3.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+#! /usr/bin/env node
+import { program } from "commander";
+import { input } from "@inquirer/prompts";
+import { createProject } from "./utils.js";
+
+program
+  .version("1.0.0")
+  .description("An initializer for new yukigo parser projects.");
+
+const name = await input({ message: `Project Name:` });
+const projectName = `yukigo-${name}-parser`;
+
+createProject(projectName);

package/src/utils.ts

@@ -0,0 +1,143 @@
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import { execSync } from "child_process";
+import { readdirSync } from "fs";
+import fse from "fs-extra";
+import path from "path";
+
+const __dirname = import.meta.dirname;
+const TEMPLATE_DIR = path.join(__dirname, "..", "template");
+const INDEX_TEMPLATE_PATH = path.join("src", "index.ts");
+const TEST_TEMPLATE_PATH = path.join("tests", "parser.spec.ts");
+const CLASS_PLACEHOLDER = "YukigoParserPlaceholder";
+
+export const runCommand = (
+  command: string,
+  cwd: string,
+  loadingMessage: string
+) => {
+  console.log(loadingMessage);
+  try {
+    execSync(command, { stdio: "inherit", cwd });
+  } catch (error) {
+    console.error(`\nFailed to execute command: ${command}`);
+    // Exit process immediately on critical failure
+    process.exit(1);
+  }
+};
+
+export function isEmpty(path: string) {
+  return readdirSync(path).length === 0;
+}
+
+const toPascalCase = (str: string): string => {
+  // First, replace non-alphanumeric separators (like hyphens, underscores) with a capitalized letter.
+  let pascal = str
+    .toLowerCase()
+    .replace(/[^a-zA-Z0-9]+(.)/g, (match, chr) => chr.toUpperCase());
+
+  // Then, ensure the very first letter is also capitalized.
+  return pascal.charAt(0).toUpperCase() + pascal.slice(1);
+};
+
+export async function replaceInFile(
+  path: string,
+  search: string,
+  replace: string
+) {
+  let content = await fse.readFile(path, "utf-8");
+  const regex = new RegExp(`${search}`, "g");
+  content = content.replace(regex, replace);
+  await fse.writeFile(path, content);
+}
+
+export const createProject = async (projectName: string) => {
+  const targetDir = path.resolve(projectName);
+
+  console.log(
+    `\n✨ Starting project setup for: ${chalk.bold.blue(projectName)}`
+  );
+
+  // Directory Validation
+  if (fse.existsSync(targetDir)) {
+    console.error(`\n❌ Error: Directory '${projectName}' already exists.`);
+    process.exit(1);
+  }
+
+  // Copy Template Files
+  console.log(`\n📁 Setting up project in ${targetDir}...`);
+  try {
+    await fse.copy(TEMPLATE_DIR, targetDir);
+  } catch (error) {
+    console.error("\n❌ Failed to copy template files:", error);
+    process.exit(1);
+  }
+
+  // Update package.json
+  const packageJsonPath = path.join(targetDir, "package.json");
+  try {
+    const packageJson = await fse.readJson(packageJsonPath);
+    packageJson.name = projectName;
+    await fse.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+  } catch (error) {
+    console.error("\n❌ Failed to update package.json:", error);
+    process.exit(1);
+  }
+
+  const projectNamePascal = toPascalCase(projectName);
+  const templateIndexPath = path.join(targetDir, INDEX_TEMPLATE_PATH);
+  const templateTestPath = path.join(targetDir, TEST_TEMPLATE_PATH);
+
+  try {
+    await replaceInFile(
+      templateIndexPath,
+      CLASS_PLACEHOLDER,
+      projectNamePascal
+    );
+    await replaceInFile(templateTestPath, CLASS_PLACEHOLDER, projectNamePascal);
+  } catch (error) {
+    console.error("\n❌ Failed to update class name:", error);
+    process.exit(1);
+  }
+
+  console.log("✅ Initial project setted up correctly.");
+
+  // Initialize git if confirmed
+  const initGitRepo = await confirm({
+    message: `Do you want to initialize a git repository with the name '${projectName}'?`,
+  });
+  if (initGitRepo) {
+    runCommand("git init", targetDir, "\n🌱 Initializing Git repository...");
+    console.log("✅ Git repository initialized.");
+  }
+
+  const runInstall = await confirm({
+    message: `Do you want to install dependencies automatically?`,
+  });
+  // install deps if confirmed
+  if (runInstall) {
+    runCommand(
+      "npm install",
+      targetDir,
+      "\n📦 Installing dependencies (this may take a minute)..."
+    );
+    console.log("✅ Dependencies installed.");
+  }
+
+  // 6. Success Message
+  const successMsg = `${chalk.bold.green("Success!")} Project ${chalk.bold.blue(
+    projectName
+  )} is ready.`;
+
+  console.log("\n" + "-".repeat(successMsg.length));
+  console.log(successMsg);
+  console.log("-".repeat(successMsg.length));
+  console.log("\nNext steps:");
+  console.log(`1. ${chalk.bold(`cd ${projectName}`)}`);
+  console.log(
+    `2. Start coding: ${chalk.bold("npm start")} (or ${chalk.bold(
+      "npm run build"
+    )})`
+  );
+  console.log("\nHappy parsing! :)");
+};

package/template/.mocharc.json

@@ -0,0 +1,4 @@
+{
+  "extension": ["ts"],
+  "spec": "tests/**/*.spec.ts"
+}

package/template/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "yukigo-parser",
+  "version": "1.0.0",
+  "description": "",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "grammar": "nearleyc ./src/grammar.ne -o ./src/grammar.ts",
+    "build": "npm run grammar && tsc",
+    "test": "npm run build && mocha --import=tsx"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/chai": "^5.2.2",
+    "@types/mocha": "^10.0.10",
+    "@types/moo": "^0.5.10",
+    "@types/node": "^24.2.0",
+    "chai": "^5.2.1",
+    "mocha": "^11.7.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "moo": "^0.5.2",
+    "nearley": "^2.20.1",
+    "yukigo-core": "latest"
+  }
+}

package/template/src/grammar.ne

@@ -0,0 +1,43 @@
+@{%
+import { Lexer } from "./lexer.js"
+import {
+    SourceLocation,
+    ArithmeticBinaryOperation,
+    Return,
+    NumberPrimitive,
+    StringPrimitive,
+    SymbolPrimitive,
+    CharPrimitive,
+    BooleanPrimitive
+} from "yukigo-core"
+
+const loc = (token) => new SourceLocation(token.line, token.col);
+
+%}
+@preprocessor typescript
+@lexer Lexer
+
+program -> addition {% (d) => [new Return(d[0])] %}
+
+addition -> 
+    addition _ "+" _ multiplication {% (d) => new ArithmeticBinaryOperation("Plus", d[0], d[4]) %}
+    | addition _ "-" _ multiplication {% (d) => new ArithmeticBinaryOperation("Minus", d[0], d[4]) %}
+    | multiplication {% id %}
+
+# priority 7
+multiplication ->
+    multiplication _ "*" _ primitive {% (d) => new ArithmeticBinaryOperation("Multiply", d[0], d[4]) %}
+    | multiplication _ "/" _ primitive {% (d) => new ArithmeticBinaryOperation("Divide", d[0], d[4]) %}
+    | primitive {% id %}
+
+primitive -> 
+    %number {% ([n]) => new NumberPrimitive(Number(n.value), loc(n)) %}
+    | %char {% ([c]) => new CharPrimitive(c.value, loc(c)) %}
+    | %variable {% ([c]) => new SymbolPrimitive(c.value, loc(c)) %}
+    | %string {% ([s]) => new StringPrimitive(s.value.slice(1, -1), loc(s)) %}
+    | %bool {% ([b]) => new BooleanPrimitive(b.value === 'True' ? true : false, loc(b)) %}
+
+
+_ -> %WS:*
+
+__ -> %WS:+

package/template/src/index.ts

@@ -0,0 +1,38 @@
+import grammar from "./grammar.js";
+import nearley from "nearley";
+import { AST, YukigoParser } from "yukigo-core";
+
+export class YukigoParserPlaceholder implements YukigoParser {
+  public errors: string[] = [];
+  constructor() {
+    this.errors = [];
+  }
+
+  public parse(code: string): AST {
+    const parser = new nearley.Parser(nearley.Grammar.fromCompiled(grammar));
+    try {
+      parser.feed(code);
+      parser.finish();
+    } catch (error) {
+      console.log(error);
+      if ("token" in error) {
+        const token = error.token;
+        const message = `Parser: Unexpected '${token.type}' token '${token.value}' at line ${token.line} col ${token.col}.`;
+        this.errors.push(message);
+        throw Error(message);
+      }
+      throw error;
+    }
+    if (parser.results.length > 1) {
+      const msg = `Parser: Too much ambiguity. ${parser.results.length} ASTs parsed. Output not generated.`;
+      this.errors.push(msg);
+      throw Error(msg);
+    }
+    if (parser.results.length == 0) {
+      this.errors.push("Parser did not generate an AST.");
+      throw Error("Parser did not generate an AST.");
+    }
+    const ast = parser.results[0];
+    return ast;
+  }
+}

package/template/src/lexer.ts

@@ -0,0 +1,19 @@
+import moo from "moo";
+
+export const LexerConfig = {
+  NL: { match: /\r?\n/, lineBreaks: true },
+  WS: / |\t/,
+  number:
+    /0[xX][0-9a-fA-F]+|0[bB][01]+|0[oO][0-7]+|(?:\d*\.\d+|\d+)(?:[eE][+-]?\d+)?/,
+  char: /'(?:\\['\\bfnrtv0]|\\u[0-9a-fA-F]{4}|[^'\\\n\r])?'/,
+  string: /"(?:\\["\\bfnrtv0]|\\u[0-9a-fA-F]{4}|[^"\\\n\r])*"/,
+  bool: {
+    match: ["True", "False"],
+  },
+  op: /\+|-|\*|\//,
+  variable: {
+    match: /[a-z_][a-zA-Z0-9_']*/,
+  },
+};
+
+export const Lexer = moo.compile(LexerConfig);

package/template/tests/parser.spec.ts

@@ -0,0 +1,27 @@
+import { YukigoParserPlaceholder } from "../src/index.js";
+import {
+  ArithmeticBinaryOperation,
+  NumberPrimitive,
+  YukigoParser,
+  Return,
+  SourceLocation,
+} from "yukigo-core";
+import { assert } from "chai";
+
+describe("Parser Tests", () => {
+  let parser: YukigoParser;
+  beforeEach(() => {
+    parser = new YukigoParserPlaceholder();
+  });
+  it("parses basic sum", () => {
+    assert.deepEqual(parser.parse("1 + 2"), [
+      new Return(
+        new ArithmeticBinaryOperation(
+          "Plus",
+          new NumberPrimitive(1, new SourceLocation(1, 1)),
+          new NumberPrimitive(2, new SourceLocation(1, 5))
+        )
+      ),
+    ]);
+  });
+});

package/template/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "lib": ["ES2024"],
+    "outDir": "./dist",
+    "declaration": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "sourceMap": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"],
+  "exclude": ["dist/**/*"]
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "module": "nodenext",
+    "target": "es2024",
+    "types": ["node"],
+    "lib": ["ES2024"],
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "exclude": ["template", "dist"],
+  "include": ["src"]
+}