diff --git a/.all-contributorsrc b/.all-contributorsrc
new file mode 100644
index 000000000..687deec59
--- /dev/null
+++ b/.all-contributorsrc
@@ -0,0 +1,527 @@
+{
+ "projectName": "typescript-book-jp",
+ "projectOwner": "yohamta",
+ "repoType": "github",
+ "repoHost": "https://github.com",
+ "files": [
+ "README.md"
+ ],
+ "imageSize": 100,
+ "commit": false,
+ "contributors": [
+ {
+ "login": "DotaKobayashi",
+ "name": "Dota Kobayashi",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/1092564?v=4",
+ "profile": "https://github.com/DotaKobayashi",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "domekomi",
+ "name": "domekomi",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/40785264?v=4",
+ "profile": "https://github.com/domekomi",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "Kanasansoft",
+ "name": "Kanasansoft",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/44207?v=4",
+ "profile": "http://www.kanasansoft.com/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "tsubasa",
+ "name": "tsubasa",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/1013588?v=4",
+ "profile": "https://github.com/tsubasa",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "kazuau",
+ "name": "kazuau",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/3702151?v=4",
+ "profile": "https://github.com/kazuau",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "szk0u",
+ "name": "szk0u",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/27814360?v=4",
+ "profile": "https://github.com/szk0u",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "pandanoir",
+ "name": "Naoto Ikuno",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/2884499?v=4",
+ "profile": "https://pandanoir.net",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "suzuki",
+ "name": "Norio Suzuki",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/10488?v=4",
+ "profile": "http://suzuki.tdiary.net/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "cnomiya",
+ "name": "cnomiya",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/332808?v=4",
+ "profile": "https://github.com/cnomiya",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ko-noguchi",
+ "name": "Kotaro Noguchi",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/1446527?v=4",
+ "profile": "http://enk.hatenablog.com/archive/category/%E3%82%BD%E3%83%95%E3%83%88%E3%82%A6%E3%82%A7%E3%82%A2",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "tmitz",
+ "name": "tmitz",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/28998?v=4",
+ "profile": "http://mononofu.hatenablog.com/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "shuuji3",
+ "name": "TAKAHASHI Shuuji",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/1425259?v=4",
+ "profile": "https://shuuji3.xyz",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "t-gyo",
+ "name": "Gyo Tamura",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/35870680?v=4",
+ "profile": "https://gitlab.com/gyo",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "waddlaw",
+ "name": "Shinya Yamaguchi",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/24648398?v=4",
+ "profile": "https://haskell.e-bigmoon.com/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "kg0r0",
+ "name": "56",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/33596117?v=4",
+ "profile": "https://github.com/kg0r0",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "akihiro117",
+ "name": "Akihiro Yamada",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/35517210?v=4",
+ "profile": "https://github.com/akihiro117",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "y-temp4",
+ "name": "Yuki Terashima",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/13657589?v=4",
+ "profile": "https://y-temp4.com",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "tbotaq",
+ "name": "tbotaq",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/140096?v=4",
+ "profile": "https://github.com/tbotaq",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "munierujp",
+ "name": "Munieru",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/20086673?v=4",
+ "profile": "https://munieru.jp",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "7ma7X",
+ "name": "Kaito Sugimoto",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/36184621?v=4",
+ "profile": "https://about.hellorusk.net",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "jmblog",
+ "name": "Yoshihide Jimbo",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/86085?v=4",
+ "profile": "https://github.com/jmblog",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "mkwtys",
+ "name": "mkwtys",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/5453675?v=4",
+ "profile": "https://twitter.com/mkwtys",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "napoleon-na",
+ "name": "Naomi Watanabe",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/4202537?v=4",
+ "profile": "https://www.napoleon-na.com",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "sinack",
+ "name": "Sinack",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/1048112?v=4",
+ "profile": "http://sinack.com",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "numb86",
+ "name": "numb86",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/16703337?v=4",
+ "profile": "https://numb86.net/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "shule517",
+ "name": "シュール",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/2564871?v=4",
+ "profile": "https://nagoya-benkyokai.com",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "nishio",
+ "name": "NISHIO Hirokazu",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/315198?v=4",
+ "profile": "http://www.nhiro.org/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "hotchpotch",
+ "name": "Yuichi Tateno (secon)",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/3500?v=4",
+ "profile": "http://about.me/hotchpotch",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "jay-es",
+ "name": "Jun Shindo",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/46585162?v=4",
+ "profile": "https://github.com/jay-es",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "KisaragiEffective",
+ "name": "KisaragiEffective",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/48310258?v=4",
+ "profile": "http://kisaragieffective.github.io",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "roborovskii-info",
+ "name": "Ishimaru Sohei",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/5865618?v=4",
+ "profile": "https://github.com/roborovskii-info",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "TakuyaTaniguchi",
+ "name": "TakuyaTaniguchi",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/29139356?v=4",
+ "profile": "https://twitter.com/Buttaoth",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "Takayyz",
+ "name": "Takayyz",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/26898313?v=4",
+ "profile": "https://github.com/Takayyz",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "isdh",
+ "name": "Tomo Yanagi",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/11797443?v=4",
+ "profile": "https://github.com/isdh",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "Akagire",
+ "name": "Takuya Eguchi (Akagire)",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/9305065?v=4",
+ "profile": "https://github.com/Akagire",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "kubio",
+ "name": "Yuta KUBO",
+ "avatar_url": "https://avatars3.githubusercontent.com/u/160728?v=4",
+ "profile": "https://github.com/kubio",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "dyoshikawa",
+ "name": "dyoshikawa",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/34151621?v=4",
+ "profile": "https://github.com/dyoshikawa",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "yktakaha4",
+ "name": "Yuuki Takahashi",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/20282867?v=4",
+ "profile": "https://yktakaha4.github.io/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "two-pack",
+ "name": "Tatsuya Saito",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/378981?v=4",
+ "profile": "http://two-pack-sbs.blogspot.jp/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "tenmihi",
+ "name": "tenmihi",
+ "avatar_url": "https://avatars2.githubusercontent.com/u/15909788?v=4",
+ "profile": "https://github.com/tenmihi",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "jkatagi",
+ "name": "jkatagi",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/7281503?v=4",
+ "profile": "https://jkatagi.github.io/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ia17011",
+ "name": "Hiroki.Ihoriya",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/38400669?v=4",
+ "profile": "https://kirohi.now.sh/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "hgkcho",
+ "name": "hgkcho",
+ "avatar_url": "https://avatars0.githubusercontent.com/u/56124650?v=4",
+ "profile": "https://nukinko.work/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "yasuman",
+ "name": "Yasuto Matsumura",
+ "avatar_url": "https://avatars1.githubusercontent.com/u/7850982?v=4",
+ "profile": "https://github.com/yasuman",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "hikiroom",
+ "name": "ひきこもり",
+ "avatar_url": "https://avatars.githubusercontent.com/u/25952997?v=4",
+ "profile": "https://github.com/hikiroom",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "youta32449999",
+ "name": "youta32449999",
+ "avatar_url": "https://avatars.githubusercontent.com/u/46958196?v=4",
+ "profile": "https://github.com/youta32449999",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "bvews",
+ "name": "bvews",
+ "avatar_url": "https://avatars.githubusercontent.com/u/7419933?v=4",
+ "profile": "https://github.com/bvews",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "irasally",
+ "name": "irasally",
+ "avatar_url": "https://avatars.githubusercontent.com/u/293996?v=4",
+ "profile": "http://omuko.sakura.ne.jp/terakoya/",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ken3ypa",
+ "name": "everyleaf_yanase",
+ "avatar_url": "https://avatars.githubusercontent.com/u/28388130?v=4",
+ "profile": "https://github.com/ken3ypa",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "jun-g-0",
+ "name": "Jun Gao",
+ "avatar_url": "https://avatars.githubusercontent.com/u/71073481?v=4",
+ "profile": "https://github.com/jun-g-0",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ryichk",
+ "name": "ryichk",
+ "avatar_url": "https://avatars.githubusercontent.com/u/26560390?v=4",
+ "profile": "https://github.com/ryichk",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "kshibayama",
+ "name": "kshibayama",
+ "avatar_url": "https://avatars.githubusercontent.com/u/6373952?v=4",
+ "profile": "https://github.com/kshibayama",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "Dz0526",
+ "name": "ITO",
+ "avatar_url": "https://avatars.githubusercontent.com/u/53589227?v=4",
+ "profile": "https://github.com/Dz0526",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ryotatake",
+ "name": "ryotatake",
+ "avatar_url": "https://avatars.githubusercontent.com/u/39555429?v=4",
+ "profile": "https://github.com/ryotatake",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ruritoBlogger",
+ "name": "rurito",
+ "avatar_url": "https://avatars.githubusercontent.com/u/40134104?v=4",
+ "profile": "https://github.com/ruritoBlogger",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "MasatoIso",
+ "name": "Masato0405",
+ "avatar_url": "https://avatars.githubusercontent.com/u/43315509?v=4",
+ "profile": "https://github.com/MasatoIso",
+ "contributions": [
+ "doc"
+ ]
+ },
+ {
+ "login": "ytkg",
+ "name": "YOSHIKI",
+ "avatar_url": "https://avatars.githubusercontent.com/u/12048864?v=4",
+ "profile": "https://github.com/ytkg",
+ "contributions": [
+ "doc"
+ ]
+ }
+ ],
+ "commitConvention": "none"
+}
diff --git a/.bookignore b/.bookignore
new file mode 100644
index 000000000..b43bf86b5
--- /dev/null
+++ b/.bookignore
@@ -0,0 +1 @@
+README.md
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 000000000..f07ca1777
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+# core.autocrlf
+* text=auto
+
+*.js linguist-language=TypeScript
diff --git a/.gitbook/assets/Screen Shot 2022-02-04 at 22.03.47.png b/.gitbook/assets/Screen Shot 2022-02-04 at 22.03.47.png
new file mode 100644
index 000000000..e754d768b
Binary files /dev/null and b/.gitbook/assets/Screen Shot 2022-02-04 at 22.03.47.png differ
diff --git a/.gitbook/assets/qr20200701193016433.png b/.gitbook/assets/qr20200701193016433.png
new file mode 100644
index 000000000..e14f1765d
Binary files /dev/null and b/.gitbook/assets/qr20200701193016433.png differ
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..ed439e2d8
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,24 @@
+# Mac
+*.DS_Store
+
+# IDEs
+.alm
+.vscode
+
+
+# Node rules:
+## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+## Dependency directory
+## Commenting this out is preferred by some people, see
+## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git
+node_modules
+
+# Book build output
+_book
+
+# eBook build output
+*.epub
+*.mobi
+*.pdf
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 000000000..5170f978d
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,23 @@
+# Contributing
+
+This book is developed using [GitBook](https://github.com/GitbookIO/gitbook). Authored in Markdown files (I use [atom](http://atom.io)).
+
+Here's how to setup a Dev Environment:
+
+```
+npm install gitbook-cli -g
+gitbook serve .
+```
+> Note: serve needs port `35729` (for live reload) and `4000` for serving http://localhost:4000.
+
+Also you can mostly just edit the `.md` files in [`/docs`](https://github.com/basarat/typescript-book/docs) using github and create a Pull Request (PR).
+
+# Code
+All the code for the book is in the `/code` folder. Tested with `atom-typescript`.
+
+### More Gitbook Tips
+* Links best work if they are relative (e.g. `./foo.md`) to the *current* file.
+* For links in the same file (`#foo-bar` style links) best to click the heading on github to get what gitbook expects.
+
+### TypeScript Compiler Docs
+Thanks to the TypeScript team for providing much of the docs: https://github.com/Microsoft/TypeScript/wiki/Architectural-Overview that are used to write the compiler story.
diff --git a/GLOSSARY.md b/GLOSSARY.md
new file mode 100644
index 000000000..c0db2ff13
--- /dev/null
+++ b/GLOSSARY.md
@@ -0,0 +1,8 @@
+# Duck Typing
+If it walks like a duck and quacks like a duck, it is a duck. For TypeScript if it has all the members structurally then it is okay for other things (irrespecitive of name) that accept that structure.
+
+# OE
+Operating Environment. I'd like to use the term Operating System, but that is not necessarily what I mean here. Think Browser,Node.js,WScriptHost etc.
+
+# Incremental Parsing
+Re-Parsing as the user edits the code.
\ No newline at end of file
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 000000000..cfb4a779d
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,3 @@
+Creative Commons
+
+https://creativecommons.org/licenses/by/4.0/
diff --git a/README.md b/README.md
index ccd21ecd5..919c82c11 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,37 @@
-The Ultimate Guide to TypeScript
-=======
+# TypeScript Deep Dive 日本語版
-I've been looking at the issues that turn up commonly when people start using TypeScript. This is based on the lessons from [StackOverflow](http://stackoverflow.com/tags/typescript/topusers) / [DefinitelyTyped](https://github.com/DefinitelyTyped/) and general engagement with the [TypeScript community](https://github.com/TypeStrong/).
+これは[TypeScript Deep Dive](https://basarat.gitbooks.io/typescript/)の日本語版です。
+
+## Why
+
+
+
+> 出典: [https://www.npmtrends.com/typescript](https://www.npmtrends.com/typescript)
+
+TypeScriptはJavaScriptを拡張して作られたプログラミング言語です。トレンドが示すとおり、TypeScriptはJavaScriptに代わって第一に選択される言語になりました。TypeScriptが提供する静的型システムは、コードの保守性と可読性を大幅に向上させます。またブラウザ等の互換性を心配することなく、モダンで便利なJavaScriptの機能を利用できます。
+
+[TypeScript DeepDive](https://github.com/basarat/typescript-book/)は初心者からベテランまで役立つオープンソースのドキュメントです。JavaScriptのモダンな機能からTypeScriptの様々な魔法に至るまで丁寧に説明されています。多くのコードサンプルがあり、具体的なTypeScriptの使い方を簡単に理解できます。TypeScript DeepDive日本語版は2018年に誕生しました。
+
+## 翻訳の改善に貢献する方法
+
+どなたでも翻訳を改善することができます。GitHubの[リポジトリ](https://github.com/yohamta/typescript-book-jp)をご覧ください。どのような些細な改善でも歓迎いたします。例えば以下のような改善です：
+
+* 最新のTypeScriptの機能の説明を追加する
+* 誤訳、タイプミスを修正する
+* 文章をわかりやすくする
+* 用語を統一する
+* コードサンプルのコメントを日本語にする
+* [オリジナルのTypeScript Deep Dive](https://github.com/basarat/typescript-book/)の最新版を反映する
+
+お気づきの点がありましたら、[PR](https://github.com/yohamta/typescript-book-jp/pulls)を作成いただけましたら、大変幸いに存じます。どうぞよろしくお願いいたします。
+
+## Contributors ✨
+
+オリジナルの作者[basarat](https://github.com/basarat)氏をはじめ、原作者の皆さま、及び、日本語版の改善に貢献していただいた皆さまに、心より感謝申し上げます。
+
+
+ 
+
+
+Made with [contrib.rocks](https://contrib.rocks).
-Your feedback on this [work is highly appreciated](https://twitter.com/basarat).
diff --git a/SUMMARY.md b/SUMMARY.md
new file mode 100644
index 000000000..666cc3c5d
--- /dev/null
+++ b/SUMMARY.md
@@ -0,0 +1,125 @@
+# Table of contents
+
+* [TypeScript Deep Dive 日本語版](README.md)
+* [TypeScript入門 & 環境構築](getting-started/README.md)
+ * [なぜTypeScriptを使うのか？](getting-started/why-typescript.md)
+* [JavaScript](recap/README.md)
+ * [等価演算子の同一性](recap/equality.md)
+ * [リファレンス](recap/references.md)
+ * [nullとundefined](recap/null-undefined.md)
+ * [this](recap/this.md)
+ * [クロージャ](recap/closure.md)
+ * [Number型](recap/number.md)
+ * [Truthy](recap/truthy.md)
+* [モダンなJavaScriptの機能](future-javascript/README.md)
+ * [クラス](future-javascript/classes/README.md)
+ * [Classes Emit](future-javascript/classes/classes-emit.md)
+ * [アロー関数](future-javascript/arrow-functions.md)
+ * [残余引数（Restパラメータ）](future-javascript/rest-parameters.md)
+ * [let](future-javascript/let.md)
+ * [const](future-javascript/const.md)
+ * [分割代入](future-javascript/destructuring.md)
+ * [スプレッド演算子](future-javascript/spread-operator.md)
+ * [for...of](future-javascript/for...of.md)
+ * [Iterator](future-javascript/iterators.md)
+ * [テンプレートリテラル](future-javascript/template-strings.md)
+ * [Promise](future-javascript/promise.md)
+ * [ジェネレータ](future-javascript/generators.md)
+ * [async await](future-javascript/async-await.md)
+* [プロジェクトの環境設定](project/README.md)
+ * [コンパイルコンテキスト](project/compilation-context/README.md)
+ * [tsconfig.json](project/compilation-context/tsconfig.md)
+ * [コンパイル対象ファイルの設定](project/compilation-context/files.md)
+ * [宣言空間](project/declarationspaces.md)
+ * [ファイルモジュール](project/modules/README.md)
+ * [ファイルモジュールの詳細](project/modules/external-modules.md)
+ * [global.d.ts](project/modules/globals.md)
+ * [名前空間](project/namespaces.md)
+ * [動的インポート](project/dynamic-import-expressions.md)
+* [Node.js & TypeScriptのプロジェクト作成](nodejs.md)
+* [React & TypeScriptのプロジェクト作成](browser.md)
+* [TypeScriptの型システム](type-system/README.md)
+ * [JavaScriptからの移行ガイド](type-system/migrating.md)
+ * [@types パッケージ (DefinitelyTyped)](type-system/types.md)
+ * [アンビエント宣言(declare)](type-system/intro/README.md)
+ * [型定義ファイル](type-system/intro/d.ts.md)
+ * [グローバル変数の宣言](type-system/intro/variables.md)
+ * [インターフェース](type-system/interfaces.md)
+ * [Enum](type-system/enums.md)
+ * [lib.d.ts](type-system/lib.d.ts.md)
+ * [関数の型](type-system/functions.md)
+ * [呼び出し可能オブジェクト](type-system/callable.md)
+ * [Type Assertion（型アサーション）](type-system/type-assertion.md)
+ * [Freshness](type-system/freshness.md)
+ * [型ガード](type-system/typeguard.md)
+ * [リテラル型](type-system/literal-types.md)
+ * [Readonly](type-system/readonly.md)
+ * [ジェネリック型](type-system/generics.md)
+ * [型推論](type-system/type-inference.md)
+ * [型の互換性](type-system/type-compatibility.md)
+ * [never](type-system/never.md)
+ * [判別可能なUnion型](type-system/discriminated-unions.md)
+ * [Index signature（インデックス型）](type-system/index-signatures.md)
+ * [型の移動](type-system/moving-types.md)
+ * [例外のハンドリング](type-system/exceptions.md)
+ * [ミックスイン](type-system/mixins.md)
+* [JSX](tsx/README.md)
+ * [React](tsx/react.md)
+ * [React以外のJSX](tsx/others.md)
+* [オプション](intro/README.md)
+ * [noImplicitAny](intro/noimplicitany.md)
+ * [strictNullChecks](intro/strictnullchecks.md)
+* [TypeScriptのエラー](main/README.md)
+ * [エラーの理解](main/interpreting-errors.md)
+ * [一般的なエラー](main/common-errors.md)
+* [NPM](index.md)
+* [テスト](intro-1/README.md)
+ * [Jest](intro-1/jest.md)
+ * [Cypress](intro-1/cypress.md)
+* [ツール](intro-2/README.md)
+ * [Prettier](intro-2/prettier.md)
+ * [Husky](intro-2/husky.md)
+ * [Changelog](intro-2/changelog.md)
+* [その他のヒント](main-1/README.md)
+ * [String Based Enums](main-1/stringenums.md)
+ * [Nominal Typing](main-1/nominaltyping.md)
+ * [Stateful Functions](main-1/statefulfunctions.md)
+ * [Bind is Bad](main-1/bind.md)
+ * [Currying](main-1/currying.md)
+ * [Type Instantiation](main-1/typeinstantiation.md)
+ * [Lazy Object Literal Initialization](main-1/lazyobjectliteralinitialization.md)
+ * [Classes are Useful](main-1/classesareuseful.md)
+ * [Avoid Export Default](main-1/defaultisbad.md)
+ * [Limit Property Setters](main-1/propertysetters.md)
+ * [outFile caution](main-1/outfile.md)
+ * [JQuery tips](main-1/jquery.md)
+ * [static constructors](main-1/staticconstructor.md)
+ * [singleton pattern](main-1/singleton.md)
+ * [Function parameters](main-1/functionparameters.md)
+ * [Build Toggles](main-1/build-toggles.md)
+ * [Barrel](main-1/barrel.md)
+ * [Create Arrays](main-1/create-arrays.md)
+ * [Typesafe Event Emitter](main-1/typed-event.md)
+* [スタイルガイド（コーディング規約）](styleguide.md)
+* [TypeScriptコンパイラの内側](overview/README.md)
+ * [Program](overview/program.md)
+ * [AST](overview/ast/README.md)
+ * [TIP: Visit Children](overview/ast/ast-tip-children.md)
+ * [TIP: SyntaxKind enum](overview/ast/ast-tip-syntaxkind.md)
+ * [Trivia](overview/ast/ast-trivia.md)
+ * [Scanner](overview/scanner.md)
+ * [Parser](overview/parser/README.md)
+ * [Parser Functions](overview/parser/parser-functions.md)
+ * [Binder](overview/binder/README.md)
+ * [Binder Functions](overview/binder/binder-functions.md)
+ * [Binder Declarations](overview/binder/binder-declarations.md)
+ * [Binder Container](overview/binder/binder-container.md)
+ * [Binder SymbolTable](overview/binder/binder-symboltable.md)
+ * [Binder Error Reporting](overview/binder/binder-diagnostics.md)
+ * [Checker](overview/checker/README.md)
+ * [Checker Diagnostics](overview/checker/checker-global.md)
+ * [Checker Error Reporting](overview/checker/checker-diagnostics.md)
+ * [Emitter](overview/emitter/README.md)
+ * [Emitter Functions](overview/emitter/emitter-functions.md)
+ * [Emitter SourceMaps](overview/emitter/emitter-sourcemaps.md)
+ * [Contributing](overview/contributing.md)
diff --git a/add-contributor.sh b/add-contributor.sh
new file mode 100755
index 000000000..3eb68b344
--- /dev/null
+++ b/add-contributor.sh
@@ -0,0 +1,2 @@
+#!/bin/sh
+all-contributors add $1 doc
diff --git a/book.json b/book.json
new file mode 100644
index 000000000..e28e53bb9
--- /dev/null
+++ b/book.json
@@ -0,0 +1,31 @@
+{
+ "language": "ja",
+ "author": "Basarat Ali Syed Translated by yohamta",
+ "title": "TypeScript Deep Dive Japanese",
+ "plugins": ["edit-link", "github", "adsense", "header"],
+ "styles": {
+ "website": "styles/website.css"
+ },
+ "pluginsConfig": {
+ "layout": {
+ "headerPath" : "header.html"
+ },
+ "lunr": {
+ "ignoreSpecialCharacters": true
+ },
+ "edit-link": {
+ "base": "https://github.com/yohamta/typescript-book-jp/tree/master",
+ "label": "Edit This Page"
+ },
+ "github": {
+ "url": "https://github.com/yohamta/typescript-book-jp/"
+ },
+ "adsense": {
+ "client": "ca-pub-4656761253552116",
+ "slot": "2017468453",
+ "format": "auto",
+ "element": ".page-inner section",
+ "position": "bottom"
+ }
+ }
+}
diff --git a/browser.md b/browser.md
new file mode 100644
index 000000000..622488351
--- /dev/null
+++ b/browser.md
@@ -0,0 +1,215 @@
+# React & TypeScriptのプロジェクト作成
+
+手動でTypeScriptのプロジェクトをセットアップする場合と、Create React Appのテンプレートを利用する場合の両方について説明します。
+
+## 1. 手動でTypeScriptのプロジェクトをセットアップする場合
+
+TypeScriptを使用してWebアプリケーションを作成する場合は、簡単なTypeScript + React\(UIフレームワーク\)のプロジェクトのセットアップを作成することをお勧めします。
+
+### 一般的なマシンのセットアップ
+
+* [Node.js](https://nodejs.org/ja/download/)をインストールする
+* [Git](https://git-scm.com/downloads)をインストールする
+
+### 素早くプロジェクトをセットアップする
+
+ベースとして [https://github.com/basarat/react-typescript](https://github.com/basarat/react-typescript) を使用してください。
+
+```text
+git clone https://github.com/basarat/react-typescript.git
+cd react-typescript
+npm install
+```
+
+ここで、 [あなたのすばらしいアプリケーションを開発する](browser.md#anatanosubarashiiapurikshonwosuru) にジャンプしてください。
+
+### プロジェクトの詳細設定
+
+そのプロジェクトがどのように作成されたかは下記の通りです。
+
+* プロジェクトのディレクトリを作成する：
+
+```text
+mkdir your-project
+cd your-project
+```
+
+* `tsconfig.json`を作成する：
+
+```javascript
+{
+ "compilerOptions": {
+ "sourceMap": true,
+ "module": "commonjs",
+ "esModuleInterop": true,
+ "resolveJsonModule": true,
+ "experimentalDecorators": true,
+ "target": "es5",
+ "jsx": "react",
+ "lib": [
+ "dom",
+ "es6"
+ ]
+ },
+ "include": [
+ "src"
+ ],
+ "compileOnSave": false
+}
+```
+
+* `package.json`を作成する:
+
+```javascript
+{
+ "name": "react-typescript",
+ "version": "0.0.0",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/basarat/react-typescript.git"
+ },
+ "scripts": {
+ "build": "webpack -p",
+ "start": "webpack-dev-server -d --content-base ./public"
+ },
+ "dependencies": {
+ "@types/react": "16.4.10",
+ "@types/react-dom": "16.0.7",
+ "clean-webpack-plugin": "0.1.19",
+ "html-webpack-plugin": "3.2.0",
+ "react": "16.4.2",
+ "react-dom": "16.4.2",
+ "ts-loader": "4.4.2",
+ "typescript": "3.0.1",
+ "webpack": "4.16.5",
+ "webpack-cli": "3.1.0",
+ "webpack-dev-server": "3.1.5"
+ }
+}
+```
+
+* すべてのリソースを含む単一の`app.js`ファイルにモジュールをバンドルするための`webpack.config.js`を作成する:
+
+```javascript
+const { CleanWebpackPlugin } = require('clean-webpack-plugin');
+const HtmlWebpackPlugin = require('html-webpack-plugin');
+
+module.exports = {
+ entry: './src/app/app.tsx',
+ plugins: [
+ new CleanWebpackPlugin({
+ cleanAfterEveryBuildPatterns: ['public/build']
+ }),
+ new HtmlWebpackPlugin({
+ template: 'src/templates/index.html'
+ }),
+ ],
+ output: {
+ path: __dirname + '/public',
+ filename: 'build/[name].[contenthash].js'
+ },
+ resolve: {
+ extensions: ['.ts', '.tsx', '.js']
+ },
+ module: {
+ rules: [
+ { test: /\.tsx?$/, loader: 'ts-loader' }
+ ]
+ }
+}
+```
+
+* webpackが生成するindex.htmlのテンプレートとして使われる`src/templates/index.html`ファイルです。生成されたファイルは`public`フォルダに配置され、Webサーバーから提供されます：
+
+```markup
+
+
+
+
+
+```
+
+アプリケーションのエントリポイントである`src/app/app.tsx`は以下の通りです：
+
+```typescript
+import * as React from 'react';
+import * as ReactDOM from 'react-dom';
+
+const Hello: React.FunctionComponent<{ compiler: string, framework: string }> = (props) => {
+ return (
+
+
{props.compiler}
+
{props.framework}
+