CalcArc
English
ブラウザで動く計算ツール群。関数電卓・データ量計算・金融計算。
計算は端末内で完結し、サーバへ送信しない。
▶ 使ってみる
https://calc.terapyon.net/
インストールは不要。ホーム画面に追加すればアプリとして起動し、オフラインでも動く。
現在の版
1.2.6（正式版） — 変更点は CHANGELOG.md に、
リリースごとの記録は Releases にある。
正式版として約束すること:
- 画面の URL は変わらない。 ブックマークした URL は、以後の版でも同じ画面を開く
- 計算は端末内で完結し、サーバへ送信しない
- 画面が低くても崩れない。 画面が低いと（ブラウザのタブで開いたときなど）
ページがスクロールすることがあるが、そのときも、すべての表示とキーは
スクロールすれば見えて押せる
約束しないこと:
- 計算結果の正しさ。 計算結果は無保証で、重要な判断の根拠にしないでほしい
- 保存した設定と履歴は、版が変わると失われうる
- 画面の見た目やキーの並び
- 為替レートの値（取得元の値をそのまま使う）
- 確かめている画面の幅: Android の Chrome などは幅 360px 以上、
iPhone の Safari は幅 375px 以上で確かめている。それより狭い画面（320px など）でも
表示はされるが、崩れないことは確かめていない
- 1 画面に収まること。 収まるように確かめているのは、ホーム画面から開いたときの
高さである
気づいたことは Issue で教えてもらえると助かる。
画面
| Scientific | Data Scale | Finance |
|---|
| | |
できること
Scientific — 関数電卓
四則演算・括弧・符号反転に加えて、
- 複素数と極座標変換。
3 + j4 を打って 5 ∠ 53.13010235 に変換できる
sqrt x² xʸ 1/x eˣ ln log と三角関数・逆三角関数。
関数は実数に閉じている（実数の答が一意に決まらない入力はエラーを返す）n! nPr nCr（非負整数の上でのみ定義）- 60 進の入出力（
°'"）。経過時間と角度の両方に使える。度分秒で入れた角度を
そのまま sin に渡せる
- ENG（工学表記）、3 桁カンマ、Degree / Radian
Data Scale — データ量の計算
要素数 × 次元 × データ型から、必要なメモリ量を 10 進（KB / MB / GB / TB）と
2 進（KiB / MiB / GiB / TiB）の両方で出す。ベクトル検索や機械学習の規模感を
掴むためのもの。
Finance — 金融計算
- ローン（元利均等）— 月額、借入可能額、返済期間の逆算。残価とボーナス併用にも
対応する（残価は月額モードでだけ使える。ボーナスは期間モードでは使えない。
月額モードでは、残価とボーナスのどちらか一方だけ）
- 複利 — 一括預入と毎月積立。税（源泉分離課税）の有無を選べる
- 複利の逆算 — 目標額から必要な積立額、または必要な年数
実額の機関一致は目標にしていない。 返す値は決定的な概算である（画面にも
免責を常設している）。
特徴
- 端末内で完結する。 入力した数値を計算目的で外部へ送らない
- 計算履歴は端末に残る。 Scientific で
= を押した式・答・角度モードを、
localStorage に 50 件まで保存する。記録を止めるのは履歴の画面から
（Shift → hist。既定は記録する。止めても既に貯まった分は残る）。
消すのも同じ画面から——1 件ずつ、またはまとめて
- PWA。 ホーム画面に追加でき、オフラインで動く
- 計算コアは Rust、ブラウザでは WebAssembly として動く
- Python の独立実装で検証している。 Rust のテストだけに頼らず、SymPy /
mpmath /
decimal.Decimal による別実装が生成した期待値と突き合わせる。
同じアルゴリズムを両方に書くと同じバグが両方に入るので、実装方法を変えている
免責
計算結果は無保証です。重要な判断の根拠にしないでください。
このツールは Apache License 2.0 で提供され、同ライセンスの定めるとおり、
明示・黙示を問わずいかなる保証も伴わない。
質問・要望・不具合
Issue へどうぞ。 日本語でも英語でも構わない。
不具合の報告では、押したキーの順を書いてもらえると助かる（例: 3 + 4 =）。
このプロジェクトはキー列と表示の対応表をテストとして持っているので、
その形で届くとそのまま 1 件のテストになる。テンプレートが聞くようになっている。
Numerical Policy
数値の扱いは docs/numerical-policy.md に定める。要点は次のとおり。
- モジュールごとに数値の扱いが違う。 Scientific は浮動小数点、Data Scale は
厳密整数、Finance は決定的概算である
- Scientific はすべての値を複素数として保持する。実数は虚部 0 の複素数である。
表示は有効数字 10 桁、丸めは round-half-to-even。打った数と π は、本当の値
（有理数 × π^k）も添えて持つ（1.2.2 から）。四則の答えは打った十進に対する答えを
正しく丸めた値になり（分子・分母が
i128 に収まるあいだ）、三角関数は π キーから
作った π/6・π/4 の倍数と、30°・45° の倍数を表から厳密に返す
- Data Scale は内部を厳密整数（
u128）で持つ。 丸めるのは表示のときだけである
- Finance は決定的な概算を返す。 実額の機関一致は目標にしていない——返済額の
端数処理は金融機関ごとに違う。月額の決定だけが浮動小数点で、償還表は厳密整数
である。詳細は docs/numerical-policy.md が定める
- Finance の入力欄に打った式は、途中で丸めない。 有理数で評価して
着地で 1 回だけ丸めるので、同じ答えを別の打ち方で入れても結果が変わらない
- 表示のための丸めを、保持している値に書き戻さない。 極形式への切り替えは
表示の変更であって計算ではないので、丸めた値が次の計算に入り込まない
- 計算コアは panic しない。 すべてのエラーは
Result を通り、UI には
戻り値として届く
開発
必要なもの: Rust (stable)、wasm-pack、Node.js + pnpm、uv。
# 計算コアのテスト
cargo test --workspace
# WASM 境界のテスト
wasm-pack test --headless --chrome crates/calcarc-wasm
# Web（新しいクローンでは先に pnpm wasm が要る）
cd web && pnpm install && pnpm wasm && pnpm dev
# 参照実装と期待値の再生成
cd reference && uv sync && uv run pytest
cd reference && uv run python scripts/generate.py
crates/calcarc-core の数値を変更したときは期待値の再生成が必要になる。
再生成せずに testdata/ を手で書き換えないこと。
版数を上げるときは 6 箇所を同じ値にする。Cargo.toml、Cargo.lock
（calcarc-core と calcarc-wasm の 2 つ）、web/package.json、
README.md の「現在の版」、README.en.md の「Current version」、
CHANGELOG.md の見出し。pnpm check:version が 6 箇所すべてを検査する。
タグを打つときはさらに、版数がタグ名と一致し、CHANGELOG の見出しに
日付が入っていることを CI が確かめる。
詳しくは CONTRIBUTING.md と
docs/base-spec.md（全体仕様）を参照。
ライセンス
Apache License 2.0。LICENSE を参照。
