testownik-converter 1.0.2 → 1.2.0

package/dist/index.js

@@ -0,0 +1,256 @@
+// src/cli/index.ts
+import { Command } from "commander";
+
+// package.json
+var package_default = {
+  name: "testownik-converter",
+  version: "1.1.0",
+  description: "A command-line utility to convert quizzes into Solvro's Testownik format.",
+  type: "module",
+  author: "Konrad Guzek",
+  license: "MIT",
+  scripts: {
+    build: "tsup"
+  },
+  homepage: "https://github.com/kguzek/testownik-converter#readme",
+  bugs: {
+    url: "https://github.com/kguzek/testownik-converter/issues"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/kguzek/testownik-converter.git"
+  },
+  bin: {
+    "testownik-converter": "bin/index.js"
+  },
+  files: [
+    "dist",
+    "package.json"
+  ],
+  dependencies: {
+    boxen: "^8.0.1",
+    chalk: "^5.6.2",
+    commander: "^14.0.3"
+  },
+  devDependencies: {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^25.2.0",
+    "semantic-release": "^25.0.3",
+    tsup: "^8.5.1",
+    typescript: "^5.9.3"
+  },
+  publishConfig: {
+    provenance: true
+  },
+  packageManager: "pnpm@10.28.2"
+};
+
+// src/constants/index.ts
+var AUTHOR_EMAIL = "konrad@guzek.uk";
+var AUTHOR_NAME = "Konrad Guzek";
+var AUTHOR_URL = "https://github.com/kguzek";
+var REPO_NAME = "Testownik Converter";
+var REPO_SLUG = "testownik-converter";
+var REPO_URL = `${AUTHOR_URL}/${REPO_SLUG}`;
+var TESTOWNIK_URL = "https://testownik.solvro.pl";
+var VERSION = package_default.version;
+
+// src/logging/logger.ts
+import chalk from "chalk";
+var formatMessage = (emoji, message) => `
+${emoji} ${chalk.dim("[")}${chalk.bgCyan.black(REPO_NAME)}${chalk.reset.dim("]")} ${message}`;
+var logger = {
+  print: console.log,
+  info: (message) => console.info(formatMessage("\u{1F916}", chalk.cyan(message))),
+  warn: (message) => console.warn(formatMessage("\u26A0\uFE0F", chalk.yellow(message))),
+  error: (message) => console.error(formatMessage("\u274C", chalk.red(message)))
+};
+
+// src/logging/cards.ts
+import boxen from "boxen";
+import chalk2 from "chalk";
+var cardIntro = boxen(
+  chalk2.white(`
+Welcome to ${REPO_NAME} version ${VERSION}!
+
+Author: ${AUTHOR_NAME}
+GitHub: ${chalk2.underline(AUTHOR_URL)}
+Email: ${AUTHOR_EMAIL}
+`),
+  {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "cyan",
+    textAlignment: "center"
+  }
+);
+var importQuizUrl = `${TESTOWNIK_URL}/import-quiz`;
+var cardOutro = boxen(
+  chalk2.white(`
+Thank you for using ${REPO_NAME}.
+
+\u{1F4E5} Import your quiz \u{1F4E5}
+
+${chalk2.underline(importQuizUrl)}
+
+\u2B50 Star me on GitHub! \u2B50
+  
+${chalk2.underline(REPO_URL)}
+`),
+  {
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor: "yellow",
+    textAlignment: "center"
+  }
+);
+var generateErrorCard = (text) => boxen(chalk2.white(text), {
+  padding: 1,
+  margin: 1,
+  borderStyle: "round",
+  borderColor: "red",
+  textAlignment: "center"
+});
+var cardError = generateErrorCard(`
+
+An unexpected error occurred during the program's execution.
+If the problem persists, please report it on GitHub:
+
+${chalk2.underline(REPO_URL + "/issues/new")}
+`);
+
+// src/adapters/base-adapter.ts
+import { parse } from "path";
+import { readFileSync, writeFileSync } from "fs";
+var BaseAdapter = class {
+  inputContent;
+  options;
+  constructor(options) {
+    const content = readFileSync(options.inputFilename, "utf8");
+    this.inputContent = content;
+    this.options = options;
+  }
+  generateOutputFilename() {
+    const inputFile = parse(this.options.inputFilename);
+    const subExtension = inputFile.ext === ".json" ? ".converted" : "";
+    return `${inputFile.name}${subExtension}.json`;
+  }
+  createQuiz() {
+    const questions = this.convertQuestions();
+    if (questions.length === 0) {
+      throw new Error("Could not find any questions in the input file.");
+    }
+    logger.info(
+      `Successfully imported ${questions.length} question${questions.length === 1 ? "" : "s"}!`
+    );
+    const quiz = {
+      title: this.options.quizTitle,
+      ...this.options.quizDescription == null ? {} : { description: this.options.quizDescription },
+      questions
+    };
+    return quiz;
+  }
+  writeOutput() {
+    const quiz = this.createQuiz();
+    const data = JSON.stringify(quiz, null, 2);
+    const filename = this.options.outputFilename ?? this.generateOutputFilename();
+    writeFileSync(filename, data, "utf8");
+    logger.info(`Converted quiz written to ${filename}.`);
+  }
+};
+
+// src/adapters/ccna-adapter.ts
+var QUESTION_REGEX = /^(?<number>\d+)\.\s+(?<question>[\s\S]+?)\n^-\s+(?<answers>.+(?:\r?\n.+)+)/gm;
+var ANSWER_REGEX = /^(?<correct>\[✓\]\s+)?(?<answer>[\s\S]+)/m;
+var CcnaAdapter = class extends BaseAdapter {
+  convertQuestions() {
+    const questions = [];
+    for (const questionMatch of this.inputContent.matchAll(QUESTION_REGEX)) {
+      if (questionMatch.groups == null) {
+        continue;
+      }
+      const questionText = questionMatch.groups.question?.trim();
+      if (!questionText) {
+        logger.warn("Skipping question with no text");
+        continue;
+      }
+      const answersText = questionMatch.groups.answers?.trim();
+      if (!answersText) {
+        logger.warn(`Skipping question with no answers: '${questionText}'`);
+        continue;
+      }
+      const answers = [];
+      for (const fullAnswerText of answersText.split(/\r?\n-\s+/)) {
+        const answerMatch = fullAnswerText.match(ANSWER_REGEX);
+        if (answerMatch?.groups == null) {
+          logger.warn(`Skiping invalid answer: ${fullAnswerText}`);
+          continue;
+        }
+        const isCorrect = answerMatch?.groups?.correct != null;
+        const answerText = answerMatch.groups?.answer?.trim();
+        if (!answerText) {
+          logger.warn(
+            `Skipping answer with no text in question: ${questionText}`
+          );
+          continue;
+        }
+        const answer = {
+          text: answerText,
+          is_correct: isCorrect
+        };
+        answers.push(answer);
+      }
+      if (answers.length === 0) {
+        continue;
+      }
+      const question = {
+        text: questionText,
+        answers,
+        multiple: answers.filter((answer) => answer.is_correct).length > 1
+      };
+      if (questionMatch.groups.number != null) {
+        question.order = Number(questionMatch.groups.number);
+      }
+      questions.push(question);
+    }
+    return questions;
+  }
+};
+
+// src/cli/index.ts
+var program = new Command();
+program.name("testownik-converter").description(
+  "A command-line converter of quizzes into KN Solvro's Testownik format."
+).option("-t, --title <string>", "quiz title", "Testownik Quiz").option(
+  "-d, --description <string>",
+  "quiz description",
+  `Generated by ${REPO_NAME}: ${REPO_URL}`
+).option("-o, --output <filename>", "output JSON filename").version(VERSION);
+program.command("ccna").argument("<filename>", "input text filename").description("Parses questions from Cisco's CCNA exam format.").action((inputFilename) => {
+  logger.print(cardIntro);
+  try {
+    const options = program.opts();
+    const outputFilename = options.output;
+    const quizTitle = options.title;
+    const quizDescription = options.description;
+    const adapter = new CcnaAdapter({
+      inputFilename,
+      outputFilename,
+      quizTitle,
+      quizDescription
+    });
+    adapter.writeOutput();
+    logger.print(cardOutro);
+  } catch (error) {
+    logger.error(
+      error instanceof Error ? error.message : `Unknown error: ${error}`
+    );
+    logger.print(cardError);
+    process.exitCode = 1;
+  }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/index.ts","../package.json","../src/constants/index.ts","../src/logging/logger.ts","../src/logging/cards.ts","../src/adapters/base-adapter.ts","../src/adapters/ccna-adapter.ts"],"sourcesContent":["import { Command } from \"commander\";\n\nimport { CcnaAdapter } from \"@/adapters/ccna-adapter\";\nimport { REPO_NAME, REPO_URL, VERSION } from \"@/constants\";\nimport { cardIntro, cardOutro, cardError, logger } from \"@/logging\";\n\nconst program = new Command();\nprogram\n  .name(\"testownik-converter\")\n  .description(\n    \"A command-line converter of quizzes into KN Solvro's Testownik format.\",\n  )\n  .option(\"-t, --title <string>\", \"quiz title\", \"Testownik Quiz\")\n  .option(\n    \"-d, --description <string>\",\n    \"quiz description\",\n    `Generated by ${REPO_NAME}: ${REPO_URL}`,\n  )\n  .option(\"-o, --output <filename>\", \"output JSON filename\")\n  .version(VERSION);\n\nprogram\n  .command(\"ccna\")\n  .argument(\"<filename>\", \"input text filename\")\n  .description(\"Parses questions from Cisco's CCNA exam format.\")\n  .action((inputFilename: string) => {\n    logger.print(cardIntro);\n    try {\n      const options = program.opts();\n\n      const outputFilename: string | undefined = options.output;\n      const quizTitle: string = options.title;\n      const quizDescription: string | undefined = options.description;\n\n      const adapter = new CcnaAdapter({\n        inputFilename,\n        outputFilename,\n        quizTitle,\n        quizDescription,\n      });\n\n      adapter.writeOutput();\n\n      logger.print(cardOutro);\n    } catch (error) {\n      logger.error(\n        error instanceof Error ? error.message : `Unknown error: ${error}`,\n      );\n      logger.print(cardError);\n      process.exitCode = 1;\n    }\n  });\n\nprogram.parse(process.argv);\n","{\n  \"name\": \"testownik-converter\",\n  \"version\": \"1.1.0\",\n  \"description\": \"A command-line utility to convert quizzes into Solvro's Testownik format.\",\n  \"type\": \"module\",\n  \"author\": \"Konrad Guzek\",\n  \"license\": \"MIT\",\n  \"scripts\": {\n    \"build\": \"tsup\"\n  },\n  \"homepage\": \"https://github.com/kguzek/testownik-converter#readme\",\n  \"bugs\": {\n    \"url\": \"https://github.com/kguzek/testownik-converter/issues\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/kguzek/testownik-converter.git\"\n  },\n  \"bin\": {\n    \"testownik-converter\": \"bin/index.js\"\n  },\n  \"files\": [\n    \"dist\",\n    \"package.json\"\n  ],\n  \"dependencies\": {\n    \"boxen\": \"^8.0.1\",\n    \"chalk\": \"^5.6.2\",\n    \"commander\": \"^14.0.3\"\n  },\n  \"devDependencies\": {\n    \"@semantic-release/changelog\": \"^6.0.3\",\n    \"@semantic-release/git\": \"^10.0.1\",\n    \"@types/node\": \"^25.2.0\",\n    \"semantic-release\": \"^25.0.3\",\n    \"tsup\": \"^8.5.1\",\n    \"typescript\": \"^5.9.3\"\n  },\n  \"publishConfig\": {\n    \"provenance\": true\n  },\n  \"packageManager\": \"pnpm@10.28.2\"\n}\n","export const AUTHOR_EMAIL = \"konrad@guzek.uk\";\nexport const AUTHOR_NAME = \"Konrad Guzek\";\nexport const AUTHOR_URL = \"https://github.com/kguzek\";\nimport pkg from \"../../package.json\";\n\nexport const REPO_NAME = \"Testownik Converter\";\nexport const REPO_SLUG = \"testownik-converter\";\nexport const REPO_URL = `${AUTHOR_URL}/${REPO_SLUG}`;\n\nexport const TESTOWNIK_URL = \"https://testownik.solvro.pl\";\n\nexport const VERSION = pkg.version;\n","import { REPO_NAME } from \"@/constants\";\n\nimport chalk from \"chalk\";\n\nconst formatMessage = (emoji: string, message: string) =>\n  `\\n${emoji} ${chalk.dim(\"[\")}${chalk.bgCyan.black(REPO_NAME)}${chalk.reset.dim(\"]\")} ${message}`;\n\nexport const logger = {\n  print: console.log,\n  info: (message: string) =>\n    console.info(formatMessage(\"🤖\", chalk.cyan(message))),\n  warn: (message: string) =>\n    console.warn(formatMessage(\"⚠️\", chalk.yellow(message))),\n  error: (message: string) =>\n    console.error(formatMessage(\"❌\", chalk.red(message))),\n};\n","import boxen from \"boxen\";\nimport chalk from \"chalk\";\n\nimport {\n  AUTHOR_EMAIL,\n  AUTHOR_NAME,\n  AUTHOR_URL,\n  REPO_NAME,\n  REPO_URL,\n  TESTOWNIK_URL,\n  VERSION,\n} from \"@/constants\";\n\nexport const cardIntro = boxen(\n  chalk.white(`\nWelcome to ${REPO_NAME} version ${VERSION}!\n\nAuthor: ${AUTHOR_NAME}\nGitHub: ${chalk.underline(AUTHOR_URL)}\nEmail: ${AUTHOR_EMAIL}\n`),\n  {\n    padding: 1,\n    margin: 1,\n    borderStyle: \"round\",\n    borderColor: \"cyan\",\n    textAlignment: \"center\",\n  },\n);\n\nconst importQuizUrl = `${TESTOWNIK_URL}/import-quiz`;\n\nexport const cardOutro = boxen(\n  chalk.white(`\nThank you for using ${REPO_NAME}.\n\n📥 Import your quiz 📥\n\n${chalk.underline(importQuizUrl)}\n\n⭐ Star me on GitHub! ⭐\n  \n${chalk.underline(REPO_URL)}\n`),\n  {\n    padding: 1,\n    margin: 1,\n    borderStyle: \"round\",\n    borderColor: \"yellow\",\n    textAlignment: \"center\",\n  },\n);\n\nconst generateErrorCard = (text: string) =>\n  boxen(chalk.white(text), {\n    padding: 1,\n    margin: 1,\n    borderStyle: \"round\",\n    borderColor: \"red\",\n    textAlignment: \"center\",\n  });\n\nexport const cardError = generateErrorCard(`\n\nAn unexpected error occurred during the program's execution.\nIf the problem persists, please report it on GitHub:\n\n${chalk.underline(REPO_URL + \"/issues/new\")}\n`);\n","import { parse } from \"node:path\";\n\nimport { readFileSync, writeFileSync } from \"node:fs\";\n\nimport type { AdapterOptions, TestownikQuestion, TestownikQuiz } from \"@/types\";\nimport { logger } from \"@/logging\";\n\nexport abstract class BaseAdapter {\n  protected inputContent!: string;\n  protected options!: AdapterOptions;\n\n  constructor(options: AdapterOptions) {\n    const content = readFileSync(options.inputFilename, \"utf8\");\n\n    this.inputContent = content;\n    this.options = options;\n  }\n\n  protected abstract convertQuestions(): TestownikQuestion[];\n\n  protected generateOutputFilename(): string {\n    const inputFile = parse(this.options.inputFilename);\n    const subExtension = inputFile.ext === \".json\" ? \".converted\" : \"\";\n    return `${inputFile.name}${subExtension}.json`;\n  }\n\n  private createQuiz(): TestownikQuiz {\n    const questions = this.convertQuestions();\n    if (questions.length === 0) {\n      throw new Error(\"Could not find any questions in the input file.\");\n    }\n    logger.info(\n      `Successfully imported ${questions.length} question${questions.length === 1 ? \"\" : \"s\"}!`,\n    );\n    const quiz: TestownikQuiz = {\n      title: this.options.quizTitle,\n      ...(this.options.quizDescription == null\n        ? {}\n        : { description: this.options.quizDescription }),\n      questions,\n    };\n    return quiz;\n  }\n\n  writeOutput(): void {\n    const quiz = this.createQuiz();\n    const data = JSON.stringify(quiz, null, 2);\n    const filename: string =\n      this.options.outputFilename ?? this.generateOutputFilename();\n    writeFileSync(filename, data, \"utf8\");\n    logger.info(`Converted quiz written to ${filename}.`);\n  }\n}\n","import type { TestownikQuestion, TestownikAnswer } from \"@/types\";\nimport { logger } from \"@/logging\";\n\nimport { BaseAdapter } from \"./base-adapter\";\n\nconst QUESTION_REGEX =\n  /^(?<number>\\d+)\\.\\s+(?<question>[\\s\\S]+?)\\n^-\\s+(?<answers>.+(?:\\r?\\n.+)+)/gm;\n\nconst ANSWER_REGEX = /^(?<correct>\\[✓\\]\\s+)?(?<answer>[\\s\\S]+)/m;\n\nexport class CcnaAdapter extends BaseAdapter {\n  protected convertQuestions() {\n    const questions: TestownikQuestion[] = [];\n    for (const questionMatch of this.inputContent.matchAll(QUESTION_REGEX)) {\n      if (questionMatch.groups == null) {\n        continue;\n      }\n      const questionText = questionMatch.groups.question?.trim();\n      if (!questionText) {\n        logger.warn(\"Skipping question with no text\");\n        continue;\n      }\n\n      const answersText = questionMatch.groups.answers?.trim();\n      if (!answersText) {\n        logger.warn(`Skipping question with no answers: '${questionText}'`);\n        continue;\n      }\n\n      const answers: TestownikAnswer[] = [];\n      for (const fullAnswerText of answersText.split(/\\r?\\n-\\s+/)) {\n        const answerMatch = fullAnswerText.match(ANSWER_REGEX);\n        if (answerMatch?.groups == null) {\n          logger.warn(`Skiping invalid answer: ${fullAnswerText}`);\n          continue;\n        }\n        const isCorrect = answerMatch?.groups?.correct != null;\n        const answerText = answerMatch.groups?.answer?.trim();\n        if (!answerText) {\n          logger.warn(\n            `Skipping answer with no text in question: ${questionText}`,\n          );\n          continue;\n        }\n        const answer: TestownikAnswer = {\n          text: answerText,\n          is_correct: isCorrect,\n        };\n        answers.push(answer);\n      }\n      if (answers.length === 0) {\n        continue;\n      }\n      const question: TestownikQuestion = {\n        text: questionText,\n        answers,\n        multiple: answers.filter((answer) => answer.is_correct).length > 1,\n      };\n      if (questionMatch.groups.number != null) {\n        question.order = Number(questionMatch.groups.number);\n      }\n      questions.push(question);\n    }\n\n    return questions;\n  }\n}\n"],"mappings":"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","names":["chalk","chalk"]}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "testownik-converter",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "A command-line utility to convert quizzes into Solvro's Testownik format.",
   "type": "module",
   "author": "Konrad Guzek",
   "license": "MIT",
+  "scripts": {
+    "build": "tsup"
+  },
   "homepage": "https://github.com/kguzek/testownik-converter#readme",
   "bugs": {
     "url": "https://github.com/kguzek/testownik-converter/issues"
@@ -16,18 +19,25 @@
   "bin": {
     "testownik-converter": "bin/index.js"
   },
-  "scripts": {
-    "build": "tsup"
-  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
   "dependencies": {
     "boxen": "^8.0.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3"
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/node": "^25.2.0",
+    "semantic-release": "^25.0.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
+  "publishConfig": {
+    "provenance": true
+  },
   "packageManager": "pnpm@10.28.2"
 }

package/.github/workflows/publish.yml

@@ -1,25 +0,0 @@
-name: Publish to npm registry
-
-permissions:
-  id-token: write # Required for OIDC
-  contents: read
-
-on:
-  push:
-    branches: ["main"]
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org/
-      - uses: pnpm/action-setup@v4
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm run build
-      - run: npm install --global npm@latest
-      - run: npm publish --provenance

package/src/adapters/base-adapter.ts

@@ -1,44 +0,0 @@
-import { readFileSync, writeFileSync } from "node:fs";
-
-import type { AdapterOptions, TestownikQuestion, TestownikQuiz } from "@/types";
-import { logger } from "@/logging";
-
-export abstract class BaseAdapter {
-  protected inputContent!: string;
-  protected options!: AdapterOptions;
-
-  constructor(options: AdapterOptions) {
-    const content = readFileSync(options.inputFilename, "utf8");
-
-    this.inputContent = content;
-    this.options = options;
-  }
-
-  protected abstract convertQuestions(): TestownikQuestion[];
-
-  private createQuiz(): TestownikQuiz {
-    const questions = this.convertQuestions();
-    if (questions.length === 0) {
-      throw new Error("Could not find any questions in the input file.");
-    }
-    logger.info(
-      `Successfully imported ${questions.length} question${questions.length === 1 ? "" : "s"}!`,
-    );
-    const quiz: TestownikQuiz = {
-      title: this.options.quizTitle,
-      ...(this.options.quizDescription == null
-        ? {}
-        : { description: this.options.quizDescription }),
-      questions,
-    };
-    return quiz;
-  }
-
-  writeOutput(): void {
-    const quiz = this.createQuiz();
-    const data = JSON.stringify(quiz, null, 2);
-    const filename = this.options.outputFilename;
-    writeFileSync(filename, data, "utf8");
-    logger.info(`Converted quiz written to ${filename}.`);
-  }
-}

package/src/adapters/ccna-adapter.ts

@@ -1,74 +0,0 @@
-import type { TestownikQuestion, TestownikAnswer } from "@/types";
-
-import { BaseAdapter } from "./base-adapter";
-import { logger } from "@/logging";
-
-const QUESTION_REGEX = new RegExp(
-  String.raw`^(?:(?<number>\d+)\.\s+)(?<question>[\s\S]+?)$\n(?<answers>(?:^- .+(?:\n(?!- ).+)*\n?)+)`,
-  "gm",
-);
-
-const ANSWER_REGEX = new RegExp(
-  String.raw`^- (?<correct>\[✓\] )?(?<answer>.+)$`,
-  "gm",
-);
-
-export class CcnaAdapter extends BaseAdapter {
-  convertQuestions() {
-    QUESTION_REGEX.lastIndex = 0;
-    const questions: TestownikQuestion[] = [];
-    let questionMatch: RegExpExecArray | null;
-    while (
-      (questionMatch = QUESTION_REGEX.exec(this.inputContent)) != null &&
-      questionMatch.groups != null
-    ) {
-      const answers: TestownikAnswer[] = [];
-      ANSWER_REGEX.lastIndex = 0;
-
-      const questionText = questionMatch.groups.question?.trim();
-      if (!questionText) {
-        logger.warn("Skipping question with no text");
-        continue;
-      }
-
-      const answersText = questionMatch.groups.answers;
-      if (!answersText) {
-        logger.warn(`Skipping question with no answers: '${questionText}'`);
-        continue;
-      }
-
-      let answerMatch: RegExpExecArray | null;
-      while (
-        (answerMatch = ANSWER_REGEX.exec(answersText)) != null &&
-        answerMatch.groups != null
-      ) {
-        const answerText = answerMatch.groups.answer?.trim();
-        if (answerText == null) {
-          logger.warn(
-            `Skipping answer with no text in question: ${questionText}`,
-          );
-          continue;
-        }
-        const answer: TestownikAnswer = {
-          text: answerText,
-          is_correct: answerMatch.groups.correct != null,
-        };
-        answers.push(answer);
-      }
-      if (answers.length === 0) {
-        continue;
-      }
-      const question: TestownikQuestion = {
-        text: questionText,
-        answers,
-        multiple: answers.filter((answer) => answer.is_correct).length > 1,
-      };
-      if (questionMatch.groups.number != null) {
-        question.order = Number(questionMatch.groups.number);
-      }
-      questions.push(question);
-    }
-
-    return questions;
-  }
-}

package/src/cli/index.ts

@@ -1,54 +0,0 @@
-import { Command } from "commander";
-
-import { CcnaAdapter } from "@/adapters/ccna-adapter";
-import { REPO_NAME, REPO_URL, VERSION } from "@/constants";
-import { cardIntro, cardOutro, cardError, logger } from "@/logging";
-
-const program = new Command();
-program
-  .name("testownik-converter")
-  .description(
-    "A command-line converter of quizzes into KN Solvro's Testownik format.",
-  )
-  .option("-t, --title <string>", "quiz title", "Testownik Quiz")
-  .option(
-    "-d, --description <string>",
-    "quiz description",
-    `Generated by ${REPO_NAME}: ${REPO_URL}`,
-  )
-  .option("-o, --output <filename>", "output JSON filename", "testownik.json")
-  .version(VERSION);
-
-program
-  .command("ccna")
-  .argument("<filename>", "input text filename")
-  .description("Parses questions from Cisco's CCNA exam format.")
-  .action((inputFilename: string) => {
-    logger.print(cardIntro);
-    try {
-      const options = program.opts();
-
-      const outputFilename: string = options.output;
-      const quizTitle: string = options.title;
-      const quizDescription: string | undefined = options.description;
-
-      const adapter = new CcnaAdapter({
-        inputFilename,
-        outputFilename,
-        quizTitle,
-        quizDescription,
-      });
-
-      adapter.writeOutput();
-
-      logger.print(cardOutro);
-    } catch (error) {
-      logger.error(
-        error instanceof Error ? error.message : `Unknown error: ${error}`,
-      );
-      logger.print(cardError);
-      process.exitCode = 1;
-    }
-  });
-
-program.parse(process.argv);

package/src/constants/index.ts

@@ -1,9 +0,0 @@
-export const AUTHOR_EMAIL = "konrad@guzek.uk";
-export const AUTHOR_NAME = "Konrad Guzek";
-export const AUTHOR_URL = "https://github.com/kguzek";
-
-export const REPO_NAME = "Testownik Converter";
-export const REPO_SLUG = "testownik-converter";
-export const REPO_URL = `${AUTHOR_URL}/${REPO_SLUG}`;
-
-export const VERSION = process.env.npm_package_version || "1.0.1";

package/src/logging/cards.ts

@@ -1,62 +0,0 @@
-import boxen from "boxen";
-import chalk from "chalk";
-
-import {
-  AUTHOR_EMAIL,
-  AUTHOR_NAME,
-  AUTHOR_URL,
-  REPO_NAME,
-  REPO_URL,
-  VERSION,
-} from "@/constants";
-
-export const cardIntro = boxen(
-  chalk.white(`
-Welcome to ${REPO_NAME} version ${VERSION}!
-
-Author: ${AUTHOR_NAME}
-GitHub: ${chalk.underline(AUTHOR_URL)}
-Email: ${AUTHOR_EMAIL}
-`),
-  {
-    padding: 1,
-    margin: 1,
-    borderStyle: "round",
-    borderColor: "cyan",
-    textAlignment: "center",
-  },
-);
-
-export const cardOutro = boxen(
-  chalk.white(`
-Thank you for using ${REPO_NAME}.
-
-⭐ Star me on GitHub! ⭐
-  
-${chalk.underline(REPO_URL)}
-`),
-  {
-    padding: 1,
-    margin: 1,
-    borderStyle: "round",
-    borderColor: "yellow",
-    textAlignment: "center",
-  },
-);
-
-const generateErrorCard = (text: string) =>
-  boxen(chalk.white(text), {
-    padding: 1,
-    margin: 1,
-    borderStyle: "round",
-    borderColor: "red",
-    textAlignment: "center",
-  });
-
-export const cardError = generateErrorCard(`
-
-An unexpected error occurred during the program's execution.
-If the problem persists, please report it on GitHub:
-
-${chalk.underline(REPO_URL + "/issues/new")}
-`);

package/src/logging/index.ts

@@ -1,3 +0,0 @@
-export * from "./logger";
-
-export * from "./cards";

package/src/logging/logger.ts

@@ -1,16 +0,0 @@
-import { REPO_NAME } from "@/constants";
-
-import chalk from "chalk";
-
-const formatMessage = (emoji: string, message: string) =>
-  `\n${emoji} ${chalk.dim("[")}${chalk.bgCyan.black(REPO_NAME)}${chalk.reset.dim("]")} ${message}`;
-
-export const logger = {
-  print: console.log,
-  info: (message: string) =>
-    console.info(formatMessage("🤖", chalk.cyan(message))),
-  warn: (message: string) =>
-    console.warn(formatMessage("⚠️", chalk.yellow(message))),
-  error: (message: string) =>
-    console.error(formatMessage("❌", chalk.red(message))),
-};

package/src/types/adapters.ts

@@ -1,6 +0,0 @@
-export interface AdapterOptions {
-  inputFilename: string;
-  outputFilename: string;
-  quizTitle: string;
-  quizDescription: string | undefined;
-}

package/src/types/index.ts

@@ -1,3 +0,0 @@
-export type * from "./adapters";
-
-export type * from "./testownik";

package/src/types/testownik.ts

@@ -1,21 +0,0 @@
-interface QuizPart {
-  text: string;
-  order?: number;
-  image_url?: string;
-}
-
-export interface TestownikAnswer extends QuizPart {
-  is_correct: boolean;
-}
-
-export interface TestownikQuestion extends QuizPart {
-  answers: TestownikAnswer[];
-  multiple?: boolean; // default: false
-  explanation?: string | null;
-}
-
-export interface TestownikQuiz {
-  title: string;
-  description?: string;
-  questions: TestownikQuestion[];
-}

package/tsconfig.json

@@ -1,46 +0,0 @@
-{
-  // Visit https://aka.ms/tsconfig to read more about this file
-  "compilerOptions": {
-    // File Layout
-    "rootDir": "./src",
-    "outDir": "./dist",
-
-    // Environment Settings
-    // See also https://aka.ms/tsconfig/module
-    "module": "esnext",
-    "target": "esnext",
-    "lib": ["esnext"],
-    "types": ["node"],
-    "moduleResolution": "bundler",
-
-    // Other Outputs
-    "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
-
-    // Stricter Typechecking Options
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-
-    // Style Options
-    // "noImplicitReturns": true,
-    // "noImplicitOverride": true,
-    // "noUnusedLocals": true,
-    // "noUnusedParameters": true,
-    // "noFallthroughCasesInSwitch": true,
-    // "noPropertyAccessFromIndexSignature": true,
-
-    // Recommended Options
-    "strict": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "noUncheckedSideEffectImports": true,
-    "moduleDetection": "force",
-    "skipLibCheck": true,
-
-    "paths": {
-      "@/*": ["./src/*"]
-    },
-  }
-}

package/tsup.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig([
-  {
-    entry: ["src/cli/index.ts"],
-    clean: true,
-    shims: true,
-    format: "esm",
-    splitting: false,
-    sourcemap: true,
-    outDir: "dist",
-  },
-]);