typing.works 0.3.0-beta.7 → 0.3.0-beta.9

package/README.md

@@ -8,13 +8,13 @@ Typing practice from [typing.works](https://typing.works), in your terminal —
 macOS · Linux
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/pers-dev/typing.works/main/install.sh | sh
+curl -fsSL https://cdn.jsdelivr.net/npm/typing.works/install.sh | sh
 ```
 
 Windows 10 · 11 (PowerShell)
 
 ```powershell
-irm https://raw.githubusercontent.com/pers-dev/typing.works/main/install.ps1 | iex
+irm https://cdn.jsdelivr.net/npm/typing.works/install.ps1 | iex
 ```
 
 아무것도 미리 깔 필요가 없습니다. 실행 파일을 받아 해시를 대조하고 `~/.local/bin`(Windows 는 `%LOCALAPPDATA%\typingworks\bin`)에 둡니다 — 그다음 `typingworks`.

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,18 +1,17 @@
 {
   "name": "typing.works",
-  "version": "0.3.0-beta.7",
+  "version": "0.3.0-beta.9",
   "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", "README.md", "LICENSE"],
+  "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",
-  "repository": { "type": "git", "url": "git+https://github.com/pers-dev/typing.works.git" },
   "author": "typing.works",
   "keywords": ["typing", "typing-practice", "typing-test", "korean", "hangul", "terminal", "tui", "cli", "wpm"]
 }