Skip to content

TypeScript

The ts repository implements the curriculum in TypeScript.

Summary

Property Value
Repository dialectic-playground/ts
Status Active: Project 00 implemented
File extension .ts
Release line Node.js 24 (LTS); TypeScript via tsc as a project dependency
Build / package tool npm + tsc
Curriculum Submodule pinned to v1.5.0
Brand accent #3178C6, glyph ts; GitHub Linguist #3178C6

Language characteristics

Aspect TypeScript
CLI classification Included
Image category First-Class
Access to OS primitives High (via V8 Node.js runtime wrappers)
Entry-point mechanism Host binary consumes kernel flags first; residual args go to process.argv

Toolchain

Environment Toolchain
Container node:24-trixie-slim, pinned by digest in Containerfile, plus make and python3
Native CI actions/setup-node (24)

make toolchain verifies both environments. It checks that every tool is on the release line above.

Project tooling

What each project's Makefile hooks run. Versions are the ones pinned in the repository (lockfile, Containerfile, or CI).

Purpose Tool
Unit tests node:test, run on the compiled output (node --test)
Lint tsc --noEmit (TypeScript 6.0.3, "strict": true), ESLint 10.12.0 with typescript-eslint 8.71.2 (strict type-checked), and prettier --check
Format Prettier 3.9.10
Dependencies One npm package per project; exact development dependency versions in the committed package-lock.json, installed with npm ci
Build output (BIN_DIR) bin/: an extensionless #!/usr/bin/env node launcher that loads the tsc output in dist/
Install Copies the compiled program to $(LIBDIR)/ts/<project>/ and writes a #!/bin/sh launcher to $(BINDIR)

Implemented projects

A project is implemented once it is listed in IMPLEMENTED in the repository's root Makefile. CI then builds, lints, and tests it in the container and natively on Linux, macOS, and Windows.

# Project Status
00 hello-world Implemented
01 echo Not started
02 cat Not started
03 head-tail Not started
04 wc Not started
05 grep-lite Not started
06 find-lite Not started
07 diff-lite Not started
08 env-run Not started
09 kv-store Not started
10 sys-monitor Not started
11 kinder Not started
12 convert Not started
13 taxes Not started
14 taxes-file Not started
15 stats Not started
16 bargraph Not started
17 stream-filters Not started
18 primes Not started
19 calendar Not started
20 bargraph-grade Not started
21 resistor Not started
22 dice Not started
23 recursion Not started
24 tromino Not started
25 max Not started
26 cars Not started
27 line-wrap Not started
28 cars-modular Not started
29 strlen Not started
30 matmult Not started
31 phone Not started
32 percolation Not started
33 reverse Not started
34 parallel-sort Not started
35 sort-bench Not started
36 page Not started
37 calc Not started
38 sched Not started
39 size Not started
40 relative-file Not started
41 films Not started
42 sales-report Not started
43 linked-list Not started
44 line-editor Not started
45 queue-stack Not started
46 infix Not started
47 bfs Not started
48 astar Not started
49 assert-sort Not started
50 fault-recovery Not started
51 koch Not started
52 spacecraft Not started

Notes

  • TypeScript stays on 6.0 (6.0.3) because typescript-eslint supports only TypeScript below 6.1; Dependabot ignores TypeScript minor and major updates until both move together.
  • NFR-02 (CONV-31): peak memory is about 50 MiB, of which the Node.js 24 runtime (node -e 0) accounts for about 48 MiB; dp-hello adds under 2 MiB.

See also