jee-default 1.0.1 → 1.0.3

package/generate-question-illustration.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+slides_dir="${1:-notes}"
+output_file="${2:-illustration.md}"
+pattern="${3:-*question.png}"
+
+if [ "$slides_dir" = "-h" ] || [ "$slides_dir" = "--help" ]; then
+  cat <<'EOF'
+Usage: ./generate-question-illustration.sh [slides-dir] [output-file] [pattern]
+
+slides-dir   Directory to scan recursively for question images.
+output-file  Markdown file to generate (default: illustration.md).
+pattern      Filename pattern to match question images (default: '*question.png').
+
+Example:
+  ./generate-question-illustration.sh notes/typeOfChargesAndTheirProperties illustration.md
+  ./generate-question-illustration.sh notes illustration.md '*question.png'
+EOF
+  exit 0
+fi
+
+if [ ! -d "$slides_dir" ]; then
+  echo "Error: slides directory not found: $slides_dir" >&2
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Error: Node.js is required. Install Node.js to continue." >&2
+  exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+node "$SCRIPT_DIR/question-illustration.js" "$slides_dir" "$output_file" "$pattern"
+exit $?

package/generate-question-practice-sheet.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+source_dir="${1:-questoinPractices}"
+output_file="${2:-questionSheet.md}"
+pattern="${3:-*.png}"
+
+if [ "$source_dir" = "-h" ] || [ "$source_dir" = "--help" ]; then
+  cat <<'EOF'
+Usage: ./generate-question-practice-sheet.sh [source-dir] [output-file] [pattern]
+
+source-dir   Directory containing practice question images.
+output-file  Markdown file to write (default: questionSheet.md).
+pattern      Filename glob to match images (default: '*.png').
+
+Example:
+  ./generate-question-practice-sheet.sh questoinPractices questionSheet.md
+  ./generate-question-practice-sheet.sh questoinPractices questionSheet.md 'slide*question.png'
+EOF
+  exit 0
+fi
+
+if [ ! -d "$source_dir" ]; then
+  echo "Error: source directory not found: $source_dir" >&2
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Error: Node.js is required. Install Node.js to continue." >&2
+  exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+node "$SCRIPT_DIR/question-practice-sheet.js" "$source_dir" "$output_file" "$pattern"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jee-default",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Generate DSA question practice sheets instantly",
   "main": "./bin/cli.js",
   "bin": {
@@ -8,6 +8,11 @@
   },
   "files": [
     "bin/",
+    "generate-question-illustration.sh",
+    "generate-question-practice-sheet.sh",
+    "pdf-to-slides.sh",
+    "question-illustration.js",
+    "question-practice-sheet.js",
     "questionPractices/"
   ],
   "keywords": [

package/pdf-to-slides.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+pdf_source="${1:-source.pdf}"
+out_dir="${2:-notes}"
+pages="${3:-all}"
+
+tmp_dir=$(mktemp -d)
+trap 'rm -rf "$tmp_dir"' EXIT
+
+if [[ "$pdf_source" =~ ^https?:// ]]; then
+  pdf_file="$tmp_dir/source.pdf"
+  if command -v curl >/dev/null 2>&1; then
+    curl -L -o "$pdf_file" "$pdf_source"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -O "$pdf_file" "$pdf_source"
+  else
+    echo "Error: curl or wget is required to download PDF from URL." >&2
+    exit 1
+  fi
+else
+  pdf_file="$pdf_source"
+fi
+
+mkdir -p "$out_dir"
+
+if command -v pdf-parse >/dev/null 2>&1; then
+  pdfparse_cmd=(pdf-parse)
+elif command -v npx >/dev/null 2>&1; then
+  pdfparse_cmd=(npx --yes pdf-parse)
+elif [ -x "./node_modules/.bin/pdf-parse" ]; then
+  pdfparse_cmd=(./node_modules/.bin/pdf-parse)
+else
+  echo "Error: pdf-parse CLI not found. Install it globally with 'npm install -g pdf-parse' or use npx." >&2
+  exit 1
+fi
+
+if [ "$pages" = "all" ]; then
+  pages_arg=()
+else
+  pages_arg=(--pages "$pages")
+fi
+
+"${pdfparse_cmd[@]}" screenshot "$pdf_file" "${pages_arg[@]}" --output "$tmp_dir"
+
+# Rename generated screenshot files in page order
+count=1
+while IFS= read -r -d '' img; do
+  cp "$img" "$out_dir/slide${count}.png"
+  count=$((count + 1))
+done < <(find "$tmp_dir" -maxdepth 1 -type f -name '*_screenshot.png' -print0 | sort -z -V)
+
+echo "Created $((count - 1)) slide images in '$out_dir' from '$pdf_file'."

package/question-illustration.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+function usage() {
+  console.log('Usage: node question-illustration.js <slides-dir> <output-file> [pattern]');
+  console.log('Example: node question-illustration.js notes illustration.md "*question.png"');
+}
+
+function patternToRegex(pattern) {
+  const escaped = pattern.replace(/[-[\]{}()+?.,\\^$|#\s*]/g, '\\$&');
+  const regex = '^' + escaped.replace(/\\\*/g, '.*').replace(/\\\?/g, '.') + '$';
+  return new RegExp(regex, 'i');
+}
+
+function walkDir(dir, matcher) {
+  const files = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...walkDir(fullPath, matcher));
+    } else if (entry.isFile() && matcher(entry.name)) {
+      files.push(fullPath);
+    }
+  }
+  return files.sort();
+}
+
+function cleanTitle(name) {
+  let title = name.replace(/question$/i, '');
+  title = title.replace(/[-_]+$/, '');
+  title = title.replace(/[-_]+/g, ' ');
+  title = title.trim();
+  if (!title) title = name;
+  return title.charAt(0).toUpperCase() + title.slice(1);
+}
+
+function relativePath(from, to) {
+  let rel = path.relative(from, to).replace(/\\/g, '/');
+  if (!rel.startsWith('.')) rel = './' + rel;
+  return rel;
+}
+
+async function run() {
+  const [,, slidesDir, outputFile, patternArg] = process.argv;
+  if (!slidesDir || !outputFile) {
+    usage();
+    process.exit(1);
+  }
+
+  const pattern = patternArg || '*question.png';
+  const matcher = patternToRegex(pattern);
+
+  if (!fs.existsSync(slidesDir) || !fs.statSync(slidesDir).isDirectory()) {
+    console.error(`Error: slides directory not found: ${slidesDir}`);
+    process.exit(1);
+  }
+
+  const images = walkDir(slidesDir, name => matcher.test(name));
+  if (images.length === 0) {
+    console.error(`No files matching pattern ${pattern} found under ${slidesDir}`);
+    process.exit(1);
+  }
+
+  const outputDir = path.dirname(outputFile) || '.';
+  fs.mkdirSync(outputDir, { recursive: true });
+
+  const lines = [];
+  lines.push('# Question Illustration');
+  lines.push('');
+  lines.push('Generated from images in `' + slidesDir + '` on ' + new Date().toISOString());
+  lines.push('');
+
+  for (const imagePath of images) {
+    const relativeImage = relativePath(outputDir, imagePath);
+    const baseName = path.basename(imagePath, path.extname(imagePath));
+    const title = cleanTitle(baseName);
+
+    lines.push(`## ${title}`);
+    lines.push('');
+    lines.push(`![${title}](${relativeImage})`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+  }
+
+  fs.writeFileSync(outputFile, lines.join('\n'), 'utf8');
+  console.log(`\nGenerated ${outputFile} with ${images.length} entries.`);
+}
+
+run().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/question-practice-sheet.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+function usage() {
+  console.log('Usage: node question-practice-sheet.js <source-dir> <output-file> [pattern]');
+  console.log('Example: node question-practice-sheet.js questoinPractices questionSheet.md "*.png"');
+}
+
+function wildcardToRegex(pattern) {
+  const regex = pattern
+    .split('')
+    .map(char => {
+      if (char === '*') return '.*';
+      if (char === '?') return '.';
+      return char.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    })
+    .join('');
+  return new RegExp(`^${regex}$`, 'i');
+}
+
+function findImages(dir, matcher) {
+  const matches = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      matches.push(...findImages(fullPath, matcher));
+    } else if (entry.isFile() && matcher.test(entry.name)) {
+      matches.push(fullPath);
+    }
+  }
+  return matches.sort();
+}
+
+function makeTitle(filename) {
+  let name = path.basename(filename, path.extname(filename));
+  name = name.replace(/question$/i, '');
+  name = name.replace(/[-_]+/g, ' ');
+  name = name.replace(/\s+/g, ' ').trim();
+  if (!name) {
+    name = path.basename(filename);
+  }
+  return name
+    .split(' ')
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+}
+
+function relativeMarkdownPath(from, to) {
+  let rel = path.relative(from, to).replace(/\\/g, '/');
+  if (!rel.startsWith('.') && !rel.startsWith('/')) {
+    rel = './' + rel;
+  }
+  return rel;
+}
+
+function groupByFolder(files, rootDir) {
+  const groups = new Map();
+  for (const file of files) {
+    const folder = path.relative(rootDir, path.dirname(file)) || '.';
+    if (!groups.has(folder)) {
+      groups.set(folder, []);
+    }
+    groups.get(folder).push(file);
+  }
+  return Array.from(groups.entries()).sort(([a], [b]) => a.localeCompare(b));
+}
+
+function buildMarkdown(groups, rootDir, outputDir) {
+  const lines = [];
+  lines.push('# Question Practice Sheet');
+  lines.push('');
+  lines.push(`Generated from images in \`${rootDir}\` on ${new Date().toISOString()}`);
+  lines.push('');
+
+  for (const [folder, files] of groups) {
+    const section = folder === '.' ? 'General' : folder.replace(/[-_]+/g, ' ');
+    lines.push(`## ${section}`);
+    lines.push('');
+
+    for (const file of files) {
+      const title = makeTitle(file);
+      const imagePath = relativeMarkdownPath(outputDir, file);
+      lines.push(`### ${title}`);
+      lines.push('');
+      lines.push(`![${title}](${imagePath})`);
+      lines.push('');
+    }
+
+    lines.push('---');
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+function main() {
+  const [,, sourceDir, outputFile, patternArg] = process.argv;
+  if (!sourceDir || !outputFile) {
+    usage();
+    process.exit(1);
+  }
+
+  const pattern = patternArg || '*.png';
+  const matcher = wildcardToRegex(pattern);
+
+  if (!fs.existsSync(sourceDir) || !fs.statSync(sourceDir).isDirectory()) {
+    console.error(`Error: source directory not found: ${sourceDir}`);
+    process.exit(1);
+  }
+
+  const imageFiles = findImages(sourceDir, matcher);
+  if (imageFiles.length === 0) {
+    console.error(`No images matching ${pattern} found under ${sourceDir}`);
+    process.exit(1);
+  }
+
+  const outputDir = path.dirname(outputFile) || '.';
+  fs.mkdirSync(outputDir, { recursive: true });
+
+  const groups = groupByFolder(imageFiles, sourceDir);
+  const markdown = buildMarkdown(groups, sourceDir, outputDir);
+
+  fs.writeFileSync(outputFile, markdown, 'utf8');
+  console.log(`Generated ${outputFile} with ${imageFiles.length} questions.`);
+}
+
+main();