@teeg/gfn 1.0.0

package/README.md

@@ -0,0 +1,34 @@
+# Terminal Pong
+
+Play Pong in your terminal with a tiny Node.js CLI.
+
+## Install
+
+1) Install Node.js (which includes `npm`).
+2) From this folder (for local testing):
+
+```bash
+npm install -g .
+gfn
+```
+
+## Run Anywhere
+
+Once published to npm, you can run:
+
+```bash
+npx @teeg/gfn
+```
+
+Or install globally:
+
+```bash
+npm install -g @teeg/gfn
+gfn
+```
+
+## Controls
+
+- `W` / `S` or Up / Down: move paddle
+- Space: serve
+- `Q`: quit

package/bin/pong.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+'use strict';
+
+const stdout = process.stdout;
+const stdin = process.stdin;
+
+const ESC = '\u001b[';
+const HIDE_CURSOR = `${ESC}?25l`;
+const SHOW_CURSOR = `${ESC}?25h`;
+const CLEAR = `${ESC}2J${ESC}H`;
+
+const FRAME_MS = 33;
+const PADDLE_H = 5;
+const PADDLE_SPEED = 1.4;
+const BALL_SPEED = 0.6;
+const AI_FOLLOW = 0.35;
+
+let width = Math.max(40, stdout.columns || 80);
+let height = Math.max(18, stdout.rows || 24);
+
+let running = true;
+let servePending = true;
+let scoreLeft = 0;
+let scoreRight = 0;
+
+let leftY = Math.floor(height / 2 - PADDLE_H / 2);
+let rightY = leftY;
+let ball = {
+  x: Math.floor(width / 2),
+  y: Math.floor(height / 2),
+  vx: BALL_SPEED,
+  vy: BALL_SPEED / 2,
+};
+
+function clamp(val, min, max) {
+  return Math.max(min, Math.min(max, val));
+}
+
+function resetBall(direction) {
+  ball.x = Math.floor(width / 2);
+  ball.y = Math.floor(height / 2);
+  const angle = (Math.random() * 0.6 + 0.2) * (Math.random() < 0.5 ? -1 : 1);
+  ball.vx = BALL_SPEED * direction;
+  ball.vy = BALL_SPEED * angle;
+  servePending = true;
+}
+
+function resize() {
+  width = Math.max(40, stdout.columns || 80);
+  height = Math.max(18, stdout.rows || 24);
+  leftY = clamp(leftY, 2, height - PADDLE_H - 2);
+  rightY = clamp(rightY, 2, height - PADDLE_H - 2);
+}
+
+function handleInput() {
+  leftY = clamp(leftY, 2, height - PADDLE_H - 2);
+}
+
+function updateAI() {
+  const target = ball.y - Math.floor(PADDLE_H / 2);
+  rightY += (target - rightY) * AI_FOLLOW;
+  rightY = clamp(rightY, 2, height - PADDLE_H - 2);
+}
+
+function stepBall() {
+  if (servePending) return;
+  ball.x += ball.vx;
+  ball.y += ball.vy;
+
+  if (ball.y <= 2 || ball.y >= height - 2) {
+    ball.vy *= -1;
+    ball.y = clamp(ball.y, 2, height - 2);
+  }
+
+  const leftX = 3;
+  const rightX = width - 4;
+
+  if (ball.x <= leftX + 1) {
+    if (ball.y >= leftY && ball.y <= leftY + PADDLE_H) {
+      ball.vx = Math.abs(ball.vx);
+      ball.x = leftX + 2;
+      ball.vy += (Math.random() - 0.5) * 0.15;
+    } else {
+      scoreRight += 1;
+      resetBall(1);
+    }
+  }
+
+  if (ball.x >= rightX - 1) {
+    if (ball.y >= rightY && ball.y <= rightY + PADDLE_H) {
+      ball.vx = -Math.abs(ball.vx);
+      ball.x = rightX - 2;
+      ball.vy += (Math.random() - 0.5) * 0.15;
+    } else {
+      scoreLeft += 1;
+      resetBall(-1);
+    }
+  }
+}
+
+function draw() {
+  let out = CLEAR;
+  const top = '+' + '-'.repeat(width - 2) + '+';
+  const bottom = top;
+  out += top + '\n';
+
+  for (let row = 1; row < height - 1; row += 1) {
+    let line = '|';
+    for (let col = 1; col < width - 1; col += 1) {
+      const mid = Math.floor(width / 2);
+      let ch = ' ';
+
+      if (col === mid && row % 2 === 0) ch = '.';
+
+      if (col === 3 && row >= Math.floor(leftY) && row <= Math.floor(leftY + PADDLE_H)) {
+        ch = '|';
+      }
+
+      if (col === width - 4 && row >= Math.floor(rightY) && row <= Math.floor(rightY + PADDLE_H)) {
+        ch = '|';
+      }
+
+      if (Math.round(ball.x) === col && Math.round(ball.y) === row) {
+        ch = 'o';
+      }
+
+      line += ch;
+    }
+    line += '|';
+    out += line + '\n';
+  }
+
+  out += bottom + '\n';
+  const status = ` W/S to move, Space to serve, Q to quit  ${scoreLeft} : ${scoreRight} `;
+  out += status.slice(0, width);
+  stdout.write(out);
+}
+
+function loop() {
+  if (!running) return;
+  handleInput();
+  updateAI();
+  stepBall();
+  draw();
+  setTimeout(loop, FRAME_MS);
+}
+
+function cleanup() {
+  stdout.write(SHOW_CURSOR + '\n');
+  stdin.setRawMode(false);
+  stdin.pause();
+}
+
+function start() {
+  stdout.write(HIDE_CURSOR);
+  stdin.setRawMode(true);
+  stdin.resume();
+  stdin.setEncoding('utf8');
+
+  stdin.on('data', (key) => {
+    if (key === '\u0003' || key === 'q' || key === 'Q') {
+      running = false;
+      cleanup();
+      process.exit(0);
+    }
+    if (key === ' ') {
+      servePending = false;
+    }
+    if (key === '\u001b[A' || key === 'w' || key === 'W') {
+      leftY -= PADDLE_SPEED * 2;
+    }
+    if (key === '\u001b[B' || key === 's' || key === 'S') {
+      leftY += PADDLE_SPEED * 2;
+    }
+  });
+
+  process.on('SIGWINCH', resize);
+  process.on('exit', cleanup);
+
+  resetBall(Math.random() < 0.5 ? -1 : 1);
+  loop();
+}
+
+start();

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@teeg/gfn",
+  "version": "1.0.0",
+  "description": "Play Pong in your terminal.",
+  "bin": {
+    "gfn": "bin/pong.js"
+  },
+  "license": "MIT",
+  "keywords": [
+    "pong",
+    "terminal",
+    "cli",
+    "game"
+  ]
+}