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

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,64 @@
-# 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
+
+```sh
+npx typing.works                              # 설치 없이 바로 · run without installing
+npm i -g typing.works                         # 늘 쓰려면 · install → `typingworks`
+brew install pers-dev/tap/typing.works       # macOS · Linux
+```
+
+macOS (Apple Silicon · Intel) · Linux (x64 · arm64 · 32-bit x86). 통신(로그인·기록)에 `curl`, 기록 올리기에 `gzip` 을 씁니다.
+Windows는 아직입니다 — WSL에서 돌아갑니다.
+
+## 쓰는 법 · 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` |
+
+끄기 · 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, "typingworks");
+if (!fs.existsSync(exe)) {
+  console.error(`typing.works: ${key} 은 아직 지원하지 않습니다 — macOS · Linux(x64 · arm64 · x86). Windows 는 WSL 에서 돌아갑니다.`);
+  console.error(`typing.works: ${key} is not supported yet — macOS and Linux only (use WSL on Windows).`);
+  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/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.3",
+  "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"],
+  "os": ["darwin", "linux"],
+  "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"]
+}