typing.works 0.0.0-stage → 0.3.0-beta.10

package/LICENSE

@@ -0,0 +1,16 @@
+typing.works — terminal
+Copyright © 2026 Perspective. All rights reserved.
+
+이 소프트웨어(실행 파일과 함께 배포되는 파일)는 무료로 내려받아 개인적·비상업적으로 쓸 수 있습니다.
+다음은 허락하지 않습니다: 수정, 재배포·재판매, 역설계·디컴파일·분해(관련 법이 명시적으로 허용하는 범위를 넘어서),
+typing.works 서비스에 대한 자동화된 남용(랭크 기록 조작 등).
+
+You may download and use this software free of charge for personal, non-commercial use.
+You may not modify, redistribute or resell it, or reverse engineer, decompile or disassemble it
+(except to the extent applicable law expressly permits), or use it to abuse the typing.works service.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM THE SOFTWARE
+OR ITS USE.
+
+typing.works 서비스 이용에는 typing.works 이용약관과 개인정보처리방침이 적용됩니다.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# typing.works — terminal (beta)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+터미널에서 치는 [typing.works](https://typing.works). 한글·영문 타자 연습, 웹과 같은 판정, 로그인하면 기록·통계·랭크전까지.
+Typing practice from [typing.works](https://typing.works), in your terminal — Korean & English, same scoring as the web, records, stats and ranked matches.
+
+## 설치 · Install
+
+macOS · Linux
+
+```sh
+curl -fsSL https://cdn.jsdelivr.net/npm/typing.works/install.sh | sh
+```
+
+Windows 10 · 11 (PowerShell)
+
+```powershell
+irm https://cdn.jsdelivr.net/npm/typing.works/install.ps1 | iex
+```
+
+아무것도 미리 깔 필요가 없습니다. 실행 파일을 받아 해시를 대조하고 `~/.local/bin`(Windows 는 `%LOCALAPPDATA%\typingworks\bin`)에 둡니다 — 그다음 `typingworks`.
+Nothing else needed. Downloads the binary, verifies its checksum, puts it on your PATH — then run `typingworks`.
+
+다른 방법 · Other ways:
+
+```sh
+npx typing.works                              # Node 가 있으면, 설치 없이 바로 · run without installing
+npm i -g typing.works                         # Node · install → `typingworks`
+brew install pers-dev/tap/typing.works       # Homebrew
+```
+
+macOS (Apple Silicon · Intel) · Linux (x64 · arm64 · 32-bit x86) · Windows 10 1809+ · 11 (x64 · arm64, Windows Terminal 권장).
+통신(로그인 · 기록)에만 `curl` 을 씁니다(Windows 10+ 에 들어 있습니다). 인터넷 없이도 연습 · 판정 · 기록은 그대로 됩니다.
+Works offline; `curl` is used only for sign-in, records and ranked (built into Windows 10+).
+
+## 쓰는 법 · Keys
+
+켜면 바로 단문을 칩니다. · It opens straight into typing.
+
+| 키 | |
+|---|---|
+| Enter · Space | 문장 끝 · finish |
+| Esc | 처음부터 · restart |
+| ↑ ↓ | 다음·이전 문장 · next/prev |
+| Tab | 한/영 — 입력기는 영문으로 두고 두벌식 자리 그대로 · Korean/English (keep your OS input in English) |
+| ^S ^L ^P | 단문 · 장문 · 팬그램 · sentence · paragraph · pangram |
+| ^E | 문장 언어 · language |
+| ^Z | 문장 크게/보통(macOS 터미널 · xterm) · bigger text |
+| ^R | 기록 · 통계 · records & stats |
+| ^K | 랭크전 · ranked |
+| ^O ^A ^G ^Q | 설정 · 계정 · 도움말 · 끝 · settings · account · help · quit |
+
+계정은 typing.works 와 같습니다. 한글은 한글이 든 고정폭 글꼴(D2Coding · Sarasa Mono K 등)에서 가장 보기 좋습니다.
+
+## 익명 사용 통계 · Anonymous usage stats
+
+어떻게 쓰이는지 알려고 아주 적은 것만 보냅니다. · We send a small amount of anonymous data to learn how it's used.
+
+- **보내는 것 · sent**: 켰다 · 묶음을 끝냈다(언어 · 갈래 · 문장 수 · 평균 타/분 · 정확도) · 랭크 판 결과 · 로그인했다 — 판 번호 · OS · 터미널 이름과 함께. 사람이 아니라 이 기기에서 만든 난수 ID로 셉니다.
+- **보내지 않는 것 · never sent**: 친 글 · 문장 · 계정(이메일 · 닉네임).
+- **끄기 · opt out**: 설정(^O) «익명 사용 통계» · `TW_NO_TELEMETRY=1` · `DO_NOT_TRACK=1` · `typingworks --no-telemetry`
+- **무엇이 나가는지 보기 · see exactly what is sent**: `TW_TELEMETRY_LOG=~/tw-telemetry.log typingworks`
+
+## 새 판 · Updates
+
+켤 때(6시간에 한 번) npm 에 새 판이 있는지 보고, 있으면 오른쪽 위에 알립니다. **^U** 를 누르면 깐 방법대로 올리고 새 판으로 다시 켭니다.
+Checks npm for a newer version (every 6 hours) and shows it top-right. Press **^U** to update the way you installed it and restart.
+
+| 깐 방법 · installed with | ^U 가 돌리는 것 · runs |
+|---|---|
+| brew | `brew upgrade typing.works` |
+| npm i -g | `npm i -g typing.works@latest` |
+| npx | `npx typing.works@latest` |
+| 설치 스크립트 · install script | 같은 스크립트를 다시 · reruns `install.sh` / `install.ps1` |
+
+끄기 · disable: `TW_NO_UPDATE_CHECK=1`
+
+## 저장 · Data
+
+`~/.typingworks` — 설정 · 이 기기의 기록 · 로그인 토큰(이 파일에만, 권한 600). 지우면 처음 상태가 됩니다.
+
+## License
+
+© 2026 Perspective. All rights reserved. 무료로 쓸 수 있습니다. 자세한 것은 LICENSE.

package/bin/typing.works.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// typing.works — 이 기기에 맞는 실행 파일을 골라 그대로 넘긴다(입출력 · 종료 코드 · 신호 그대로). 설치 스크립트는 없다.
+"use strict";
+const { spawnSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const key = `${process.platform}-${process.arch}`;
+const exe = path.join(__dirname, "..", "vendor", key, process.platform === "win32" ? "typingworks.exe" : "typingworks");
+if (!fs.existsSync(exe)) {
+  console.error(`typing.works: ${key} 은 아직 지원하지 않습니다 — macOS · Linux(x64 · arm64 · x86) · Windows(x64 · arm64).`);
+  console.error(`typing.works: ${key} is not supported yet — macOS, Linux and Windows (x64 · arm64).`);
+  process.exit(1);
+}
+try { fs.accessSync(exe, fs.constants.X_OK); } catch { try { fs.chmodSync(exe, 0o755); } catch {} }
+const r = spawnSync(exe, process.argv.slice(2), { stdio: "inherit" });
+if (r.error) { console.error(`typing.works: ${r.error.message}`); process.exit(1); }
+if (r.signal) process.kill(process.pid, r.signal);
+process.exit(r.status === null ? 1 : r.status);

package/install.ps1

@@ -0,0 +1,97 @@
+# typing.works - terminal installer for Windows
+#   irm https://cdn.jsdelivr.net/npm/typing.works/install.ps1 | iex
+#
+# What it does
+#   1. Downloads the typing.works npm package (about 2 MB, holds all seven binaries) and takes the one for this PC
+#      (Windows 10 1809+ / 11, x64 or arm64)
+#   2. Verifies it against the sha512 the npm registry publishes - stops on mismatch
+#   3. Puts typingworks.exe and typing.works.exe in %LOCALAPPDATA%\typingworks\bin (override: TW_INSTALL_DIR)
+#   4. Adds that folder to your user PATH (skip: TW_NO_MODIFY_PATH=1)
+# The version follows the latest "typing.works" on npm (pin: TW_VERSION). Ctrl+U in the app re-runs this script.
+# No source code is downloaded - only the binary, README and LICENSE.
+# Uninstall: delete that folder and %USERPROFILE%\.typingworks
+# (ASCII only on purpose: Windows PowerShell 5.1 reads BOM-less script files in the ANSI code page.)
+& {
+  $ErrorActionPreference = 'Stop'
+  $ProgressPreference = 'SilentlyContinue'      # the progress bar slows downloads a lot on PowerShell 5.1
+  [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+  $reg = if ($env:TW_REGISTRY) { $env:TW_REGISTRY } else { 'https://registry.npmjs.org' }   # an npm mirror, if you use one
+  $dir = if ($env:TW_INSTALL_DIR) { $env:TW_INSTALL_DIR } else { Join-Path $env:LOCALAPPDATA 'typingworks\bin' }
+
+  # The real CPU - pick arm64 even when x64 PowerShell runs under emulation on ARM
+  $arch = $null
+  try { $arch = [System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture.ToString() } catch { }
+  if (-not $arch) { $arch = if ($env:PROCESSOR_ARCHITEW6432) { $env:PROCESSOR_ARCHITEW6432 } else { $env:PROCESSOR_ARCHITECTURE } }
+  switch -regex ($arch) {
+    '^(Arm64|ARM64)$' { $arch = 'arm64' }
+    '^(X64|AMD64)$'   { $arch = 'x64' }
+    default { throw "typing.works: $arch is not supported yet (Windows x64 / arm64)" }
+  }
+
+  # Version and the package's sha512 in one request - latest unless TW_VERSION is set
+  $tag = if ($env:TW_VERSION) { $env:TW_VERSION } else { 'latest' }
+  $meta = $null
+  try { $meta = Invoke-RestMethod -UseBasicParsing "$reg/typing.works/$tag" } catch { }
+  if (-not $meta -or -not $meta.version -or -not $meta.dist.integrity) { throw 'typing.works: could not read the npm registry (check your internet connection)' }
+  $ver = $meta.version
+  $integrity = $meta.dist.integrity
+  if ($integrity -notlike 'sha512-*') { throw "typing.works: unexpected integrity format: $integrity" }
+  $tar = (Get-Command tar.exe -ErrorAction SilentlyContinue).Source       # built in since Windows 10 1803
+  if (-not $tar) { throw 'typing.works: tar.exe was not found (Windows 10 1803 or later is needed)' }
+  # Download with the built-in curl.exe (Windows 10 1803+). PowerShell 5.1's Invoke-WebRequest follows GitHub's redirect to a
+  # signed asset URL but mangles the signature and gets 404 (seen 2026-10-13). Fall back to it only when curl.exe is missing.
+  $curl = (Get-Command curl.exe -ErrorAction SilentlyContinue).Source
+  function Get-File([string]$from, [string]$to) {
+    if ($curl -and $from -notlike 'file:*') {
+      & $curl -fsSL --retry 2 -o $to $from
+      if ($LASTEXITCODE -ne 0) { throw "typing.works: download failed ($LASTEXITCODE): $from" }
+    } else {
+      Invoke-WebRequest -UseBasicParsing $from -OutFile $to
+    }
+  }
+  $tmp = Join-Path ([IO.Path]::GetTempPath()) ('typingworks-' + [guid]::NewGuid().ToString('N'))
+  New-Item -ItemType Directory -Path $tmp | Out-Null
+  try {
+    Write-Host "typing.works $ver (win32-$arch) downloading..."
+    $tgz = Join-Path $tmp "typing.works-$ver.tgz"
+    Get-File "$reg/typing.works/-/typing.works-$ver.tgz" $tgz
+    $want = -join ([Convert]::FromBase64String($integrity.Substring(7)) | ForEach-Object { $_.ToString('x2') })
+    $got = (Get-FileHash -Algorithm SHA512 $tgz).Hash.ToLower()
+    if ($got -ne $want) { throw 'typing.works: checksum mismatch - not installed' }
+    $inner = "package/vendor/win32-$arch/typingworks.exe"
+    & $tar -xzf $tgz -C $tmp $inner
+    if ($LASTEXITCODE -ne 0) { throw "typing.works: could not extract $inner" }
+
+    New-Item -ItemType Directory -Force -Path $dir | Out-Null
+    # A running .exe cannot be deleted but can be renamed - move the old one aside, then place the new one (Ctrl+U comes this way)
+    foreach ($n in @('typingworks.exe', 'typing.works.exe')) {
+      $p = Join-Path $dir $n
+      Remove-Item ($p + '.old') -Force -ErrorAction SilentlyContinue
+      if (Test-Path $p) { Move-Item $p ($p + '.old') -Force }
+    }
+    $exe = Join-Path $dir 'typingworks.exe'
+    Copy-Item (Join-Path $tmp ("package\vendor\win32-$arch\typingworks.exe")) $exe
+    Copy-Item $exe (Join-Path $dir 'typing.works.exe')        # same program under both names
+    foreach ($n in @('typingworks.exe.old', 'typing.works.exe.old')) { Remove-Item (Join-Path $dir $n) -Force -ErrorAction SilentlyContinue }
+
+    # Tell the app it was installed by this script, so Ctrl+U re-runs it (UTF-8 without BOM - user folders may be non-ASCII)
+    $tw = Join-Path $HOME '.typingworks'
+    New-Item -ItemType Directory -Force -Path $tw | Out-Null
+    [IO.File]::WriteAllText((Join-Path $tw 'install-script'), $exe + "`n", (New-Object Text.UTF8Encoding $false))
+
+    Write-Host "OK  typing.works $ver -> $exe"
+    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+    $has = $false
+    if ($userPath) { foreach ($e in $userPath.Split(';')) { if ($e.TrimEnd('\') -ieq $dir.TrimEnd('\')) { $has = $true } } }
+    if (-not $has -and $env:TW_NO_MODIFY_PATH -ne '1') {
+      $new = if ($userPath) { $userPath.TrimEnd(';') + ';' + $dir } else { $dir }
+      [Environment]::SetEnvironmentVariable('Path', $new, 'User')
+      $env:Path = $env:Path.TrimEnd(';') + ';' + $dir
+      Write-Host "    added $dir to your PATH - open a new terminal, then run:  typingworks"
+    } else {
+      Write-Host '    run:  typingworks'
+    }
+  } finally {
+    Remove-Item $tmp -Recurse -Force -ErrorAction SilentlyContinue
+  }
+}

package/install.sh

@@ -0,0 +1,97 @@
+#!/bin/sh
+# typing.works — terminal 설치 · install
+#   curl -fsSL https://cdn.jsdelivr.net/npm/typing.works/install.sh | sh
+#
+# 하는 일 · what it does
+#   1. npm 의 typing.works 꾸러미(실행 파일 일곱 가지가 든 약 2MB)를 받아 이 기기(macOS · Linux, arm64 · x64 · x86)에 맞는 것만 꺼낸다
+#   2. npm 이 알려 주는 sha512 와 대조한다 — 다르면 멈춘다
+#   3. ~/.local/bin 에 typingworks 와 typing.works 를 둔다(TW_INSTALL_DIR 로 바꿀 수 있다)
+#   4. 그 폴더가 PATH 에 없으면 셸 설정 파일에 한 줄 더하고 알린다
+# 판 번호는 npm 의 typing.works 최신 판을 따른다(TW_VERSION=0.3.0 처럼 고를 수 있다). 앱 안 ^U 가 이 스크립트를 다시 돌린다.
+# 소스 코드는 없다 — npm 꾸러미에는 실행 파일 · 설명서 · 라이선스 · 이 스크립트뿐. 지우기: rm ~/.local/bin/typingworks ~/.local/bin/typing.works ; rm -rf ~/.typingworks
+set -eu
+
+REG="${TW_REGISTRY:-https://registry.npmjs.org}"   # npm 미러를 쓰는 곳이면 바꾼다
+DIR="${TW_INSTALL_DIR:-$HOME/.local/bin}"
+say() { printf '%s\n' "$*"; }
+die() { printf 'typing.works: %s\n' "$*" >&2; exit 1; }
+
+command -v curl >/dev/null 2>&1 || die "curl 이 필요합니다 · curl is required"
+command -v tar >/dev/null 2>&1 || die "tar 가 필요합니다 · tar is required"
+
+os="$(uname -s)"; arch="$(uname -m)"
+case "$os" in
+  Darwin) os=darwin ;;
+  Linux) os=linux ;;
+  *) die "$os 은 아직 지원하지 않습니다 — macOS · Linux (Windows 는 PowerShell 설치를 쓰세요) · $os is not supported yet" ;;
+esac
+case "$arch" in
+  arm64|aarch64) arch=arm64 ;;
+  x86_64|amd64) arch=x64 ;;
+  i386|i486|i586|i686) arch=ia32 ;;
+  *) die "$arch 은 아직 지원하지 않습니다 · $arch is not supported yet" ;;
+esac
+[ "$os" = darwin ] && [ "$arch" = ia32 ] && die "32비트 macOS 는 지원하지 않습니다 · 32-bit macOS is not supported"
+# Rosetta 로 돌린 셸이어도 진짜 칩에 맞춘다
+if [ "$os" = darwin ] && [ "$arch" = x64 ] && [ "$(sysctl -n sysctl.proc_translated 2>/dev/null || echo 0)" = 1 ]; then arch=arm64; fi
+
+# 판 번호와 꾸러미의 sha512 를 한 번에 — 판을 안 주면 latest
+meta="$(curl -fsSL "$REG/typing.works/${TW_VERSION:-latest}")" || die "판 정보를 못 읽었습니다(인터넷 연결을 확인하세요) · could not reach the npm registry"
+ver="$(printf '%s' "$meta" | grep -o '"version":"[^"]*"' | head -n 1 | cut -d'"' -f4)"
+integ="$(printf '%s' "$meta" | grep -o '"integrity":"sha512-[^"]*"' | head -n 1 | cut -d'"' -f4)"
+[ -n "$ver" ] && [ -n "$integ" ] || die "판 정보가 이상합니다 · unexpected registry response"
+
+# base64 → 16진수(base64 -d 는 GNU · 새 macOS, -D 는 옛 macOS, 없으면 openssl)
+b64hex() {
+  for d in "base64 -d" "base64 -D" "openssl base64 -d -A"; do
+    h="$(printf '%s' "$1" | $d 2>/dev/null | od -An -v -tx1 | tr -d ' \n')"
+    [ -n "$h" ] && { printf '%s' "$h"; return 0; }
+  done
+  return 1
+}
+want="$(b64hex "${integ#sha512-}")" || die "sha512 를 풀 도구가 없습니다 · no base64 tool"
+
+tmp="$(mktemp -d 2>/dev/null || mktemp -d -t typingworks)"
+trap 'rm -rf "$tmp"' EXIT INT TERM
+tgz="$tmp/typing.works-$ver.tgz"
+
+say "typing.works $ver ($os-$arch) 받는 중 · downloading…"
+curl -fsSL "$REG/typing.works/-/typing.works-$ver.tgz" -o "$tgz" || die "받지 못했습니다 · download failed"
+if command -v sha512sum >/dev/null 2>&1; then got="$(sha512sum "$tgz" | cut -d' ' -f1)"
+elif command -v shasum >/dev/null 2>&1; then got="$(shasum -a 512 "$tgz" | cut -d' ' -f1)"
+elif command -v openssl >/dev/null 2>&1; then got="$(openssl dgst -sha512 -r "$tgz" | cut -d' ' -f1)"
+else die "sha512 도구가 없어 대조할 수 없습니다 · no sha512 tool"; fi
+[ "$got" = "$want" ] || die "해시가 다릅니다 — 설치하지 않았습니다 · checksum mismatch, not installed"
+
+tar -xzf "$tgz" -C "$tmp" "package/vendor/$os-$arch/typingworks" || die "풀지 못했습니다 · could not extract"
+mv "$tmp/package/vendor/$os-$arch/typingworks" "$tmp/typingworks"
+mkdir -p "$DIR"
+# 같은 폴더에 새 이름으로 둔 뒤 바꿔 끼운다 — 돌고 있는 typingworks 가 있어도 안전하다(^U 가 이 길로 온다)
+cp "$tmp/typingworks" "$DIR/.typingworks.new"
+chmod 755 "$DIR/.typingworks.new"
+mv -f "$DIR/.typingworks.new" "$DIR/typingworks"
+ln -sf typingworks "$DIR/typing.works"
+
+# 앱이 «스크립트로 깔았다»를 알게 — ^U 가 이 스크립트를 다시 돌린다
+mkdir -p "$HOME/.typingworks"
+printf '%s\n' "$DIR/typingworks" > "$HOME/.typingworks/install-script"
+
+say "✓ typing.works $ver → $DIR/typingworks"
+
+case ":$PATH:" in
+  *":$DIR:"*) say "  실행 · run:  typingworks" ;;
+  *)
+    line="export PATH=\"$DIR:\$PATH\""
+    case "${SHELL:-}" in
+      */zsh) rc="$HOME/.zshrc" ;;
+      */bash) if [ "$os" = darwin ]; then rc="$HOME/.bash_profile"; else rc="$HOME/.bashrc"; fi ;;
+      *) rc="$HOME/.profile" ;;
+    esac
+    if [ "${TW_NO_MODIFY_PATH:-}" != 1 ] && ! grep -qsF "$line" "$rc"; then
+      printf '\n# typing.works\n%s\n' "$line" >> "$rc"
+      say "  $DIR 를 PATH 에 더했습니다($rc) · added to PATH"
+    fi
+    say "  새 터미널을 열거나 · open a new terminal, or:  $line"
+    say "  실행 · run:  typingworks"
+    ;;
+esac

package/package.json

@@ -1,6 +1,17 @@
 {
   "name": "typing.works",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0-beta.10",
+  "description": "typing.works in your terminal — Korean & English typing practice, records, stats and ranked matches",
+  "bin": {
+    "typing.works": "bin/typing.works.js",
+    "typingworks": "bin/typing.works.js"
+  },
+  "files": ["bin", "vendor", "install.sh", "install.ps1", "README.md", "LICENSE"],
+  "os": ["darwin", "linux", "win32"],
+  "cpu": ["arm64", "x64", "ia32"],
+  "engines": { "node": ">=14" },
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://typing.works",
+  "author": "typing.works",
+  "keywords": ["typing", "typing-practice", "typing-test", "korean", "hangul", "terminal", "tui", "cli", "wpm"]
+}