tetris-ts

A simple Tetris clone written in plain Typescript.

Installation

Yarn

yarn add tetris-ts

NPM

npm install tetris-ts --save

Usage

// ES6 Import
import Tetris from 'tetris-ts';

// CommonJS Require
const Tetris = require('tetris-ts').default;

The library takes 3 parameters in the constructor

• DOM Element to attach to
• Callback function invoked when a game finishes
• Options object (optional) for customizations

Important: The width of the DOM element determines the size of the game.

<div id="tetris" style="width: 275px;">

const el = document.getElementById('tetris');

const callback = function (data) {
    // Do something with the data returned from the game
};

const tetris = new Tetris(el, callback, {
    frameConstant: 60,
    linesPerLevel: 10,
});

The Options object has the following properties:

Property	Description	Default
frameConstant	Controls the speed of the game	60.8
linesPerLevel	Completed lines needed to advance the level	10

Data is returned as an object with the following properties:

Property	Data Type	Description
points	Number	Total points earned
lines	Number	Total lines cleared
level	Number	Highest level achieved

About

I had two primary goals when writing this library. The first was to learn Typescript. Tutorials are great, but I wanted to go through the process of what its really like to develop a project in the language - the syntax, the semantics, and the tooling. The second goal was to write without using any dependencies in the code itself. No lodash, no jQuery; just pure Typescript.

That being said - this is by no means a 100% accurate clone of Tetris. I kept as much of the essence of the game as I could without making the project overly complicated.

This will be my first project in Typescript, as well as my first package published to NPM, so by all means, r/RoastMe.