parcelを最新化、Web Componentsの記述を拡充

Author: shibukawa

docs/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 7cd1c85b716a9bf4e1c70854774596ed
+config: c67336abd1a4f2919adb4ca58fa8e25d
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_sources/baseenv.rst.txt

@@ -382,7 +382,7 @@ Visual Studio Codeの設定
 
 .. note::
 
-    以前は次に紹介するPrettierをESLintの一部として組み込んで利用することがデファクトスタンダードでした。Lintのエラーもしかし、その場合、チェックのたびにコードをフォーマットしなおし、それからパースして文法のチェックが実行されます。ESLintはコーディングの中でなるべくリアルタイムに結果をプログラマーに提示する方が開発の流れが途切れずに品質の高いコードが量産できます。現在はフォーマッターとこのESLintは同期させないで個別に実行させるのが推奨となっています。
+    以前は次に紹介するPrettierをESLintの一部として組み込んで利用することがデファクトスタンダードでした。その場合、チェックのたびにコードをフォーマットしなおし、それからパースして文法のチェックが実行されます。ESLintはコーディングの中でなるべくリアルタイムに結果をプログラマーに提示する方が開発の流れが途切れずに品質の高いコードが量産できます。現在はフォーマッターとこのESLintは同期させないで個別に実行させるのが推奨となっています。
 
 ESLintの警告と特定の行だけ無効化する
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/_sources/browserobjects.rst.txt

@@ -13,8 +13,7 @@ Polyfill、Ponyfill
 ``fetch``
 ----------------------------------------
 
-確実にNode.jsだけでしか使われないコードであれば\ `node-fetch <https://www.npmjs.com/package/node-fetch
->`_\ をインポートして利用すれば十分です。
+確実にNode.jsだけでしか使われないコードであれば\ `node-fetch <https://www.npmjs.com/package/node-fetch>`_\ をインポートして利用すれば十分です。
 
 もし、ブラウザでもサーバーでも実行されるコードの場合
 https://www.npmjs.com/package/isomorphic-unfetch

docs/_sources/clienv.rst.txt

@@ -14,9 +14,9 @@ Node.jsの環境構築
 
 Node.js向けには@zeit/nccを利用します。
 
-@zeit/nccはTypeScriptに最初から対応したコンパイラで、コマンドラインツールやウェブサーバーなどのNode.jsアプリケーションを1ファイルにするために作られています。@zeit/ncc自体も自分自身を使ってバンドル化されており、ごく小さいサイズですばやくインストールできます。Goを参考にしており、\ ``tsconfig.json``\ 以外の設定は不要です。もちろん、
+@zeit/nccはTypeScriptに最初から対応したコンパイラで、コマンドラインツールやウェブサーバーなどのNode.jsアプリケーションを1ファイルにするために作られています。@zeit/ncc自体も自分自身を使ってバンドル化されており、ごく小さいサイズですばやくインストールできます。Goを参考にしており、\ ``tsconfig.json``\ 以外の設定は不要です。
 
-他に実績のあるツールとしてはBrowserifyがあります。これも、tsifyというプラグインと併用することでTypeScript製アプリケーションをバンドルして1ファイルにできます。このツールはメインの目的としてはNode.js製アプリケーションをブラウザでも動くようにするために作られました。後発の@zeit/nccに比べると設定が多いのと、TypeScriptの設定を変えてcommon.js形式のパッケージにしないと扱えないのがnccと比べると煩雑です。また、\ ``tsc``\ を使いバンドルせずにTypeScriptをJavaScriptに変換するだけを行って配布する方法もありますが、バンドルをしないとさまざまなファイルが入ってくるため、配布サイズも大きくなりがちです。
+他に実績のあるツールとしてはBrowserifyがあります。これも、tsifyというプラグインと併用することでTypeScript製アプリケーションをバンドルして1ファイルにできます。このツールは、Node.js製アプリケーションをブラウザでも動くようにすることをメインの目的として作られました。後発の@zeit/nccに比べると設定が多いのと、TypeScriptの設定を変えてcommon.js形式のパッケージにしないと扱えないのがnccと比べると煩雑です。また、\ ``tsc``\ を使いバンドルせずにTypeScriptをJavaScriptに変換するだけを行って配布する方法もありますが、バンドルをしないとさまざまなファイルが入ってくるため、配布サイズも大きくなりがちです。
 
 作業フォルダを作る
 ------------------------

docs/_sources/contributors.rst.txt

@@ -42,7 +42,10 @@ Pull Request/Issueをくださった方々
 * `@aliyome <https://github.com/aliyome>`_
 * `@mimosafa <https://github.com/mimosafa>`_
 * `@irtfrm <https://github.com/irtfrm>`_
-
+* `@yasuda0320 <https://github.com/yasuda0320>`_
+* `@kesoji <https://github.com/kesoji>`_
+* `@maguroguma <https://github.com/maguroguma>`_
+* `@nukopy <https://github.com/nukopy>`_
 
 
 フィードバックをくださった方々

docs/_sources/generics.rst.txt

@@ -232,6 +232,7 @@ TypeScriptでは組み込みの型変換のためのジェネリクスのユー
      return function(): any {
        if (!isInit) {
          cache = init();
+         isInit = true;
        } 
        return cache;
      }
@@ -260,6 +261,7 @@ TypeScriptでは組み込みの型変換のためのジェネリクスのユー
      return function(): T {
        if (!isInit) {
          cache = init();
+         isInit = true;
        } 
        return cache;
      }

docs/_sources/preface.rst.txt

@@ -32,7 +32,7 @@ JavaScriptは2015年より前は保守的なアップデートがおこなわれ
 
 Babel（旧名6to5）はオープンソースで開発されている処理系で、ECMAScriptの最新の文法を解釈し、古いJavaScript環境でも動作するように変換します。プラグインを使うことで、まだ規格に正式に取り入れられていない実験的な文法を有効にすることもできます。実際、言語の仕様策定の場でも参考実装として活発に使われています。TypeScriptはMicrosoft社が開発した言語で、ECMAScriptを土台にして、型情報を付与できるようにしたものです。一部例外はありますが、TypeScriptのコードから型情報を外すとほぼそのままJavaScriptになります。言語仕様の策定においても、参考実装の1つとして扱われています。
 
-大規模になってくると、型があるとコーディングが楽になります。型を書く文の手間は多少増えますが、昔の静的型付き言語と異なり、TypeScriptは「明示的に型がわかる場面」では型を省略して書くことができます。また、動的なオブジェクトなど、JavaScriptでよく登場する型もうまく扱えるように設計されています。そのような使い勝手の良さもあり、現在は採用数が伸びています。有名なOSSも実装をTypeScriptに置き換えたり、企業でも積極的な活用が進んでいます。
+大規模になってくると、型があるとコーディングが楽になります。型を書く分の手間は多少増えますが、昔の静的型付き言語と異なり、TypeScriptは「明示的に型がわかる場面」では型を省略して書くことができます。また、動的なオブジェクトなど、JavaScriptでよく登場する型もうまく扱えるように設計されています。そのような使い勝手の良さもあり、現在は採用数が伸びています。有名なOSSも実装をTypeScriptに置き換えたり、企業でも積極的な活用が進んでいます。
 
 Babelにも、プラグインを追加して型情報を追加できるflowtypeというFacebook製の拡張文法がありますが、ライブラリに型情報をつけるのは、手作業で整備していかなければならず、シェアが高いほど型情報が手に入りやすく、開発の準備のために型定義ファイルを作る時間を別途かけなくて済みます。現時点で型定義ファイルの充実度が高いのはTypeScriptです。
 

docs/_sources/primitive.rst.txt

@@ -126,7 +126,7 @@ TypeScript（というか、その下で動作しているJavaScript）は64ビ
      * 16
      * 16
      * radixが16以外は0
-     * 8 (8進数)
+     * 16 (16進数)
    - * "0o10"
      * 8
      * 0
@@ -136,7 +136,7 @@ TypeScript（というか、その下で動作しているJavaScript）は64ビ
      * 2
      * 0
      * 0
-     * 2 (8進数)
+     * 2 (2進数)
 
 なお、リテラルの8進数ですが、ESLintの推奨設定を行うと ``no-octal`` というオプションが有効になります。このフラグが有効だと、8進数を使用すると警告になります。
 
@@ -515,7 +515,7 @@ printfのような数値の変換などのフォーマットはなく、あく
 .. code-block:: js
 
    // 古いコード
-   console.log("[Debug]:" + variable);
+   console.log("[Debug]: " + variable);
 
    // 新しいコード
    console.log(`[Debug]: ${variable}`);

docs/_sources/recommended.rst.txt

@@ -6,7 +6,7 @@
 TypeScript Playground
 -------------------------------
 
-ブラウザでTypeScriptが試せるPlaygroundにも何種類かありますが、現在は公式のPlaygroundが一番おすすめです。以前は本家よりも強力というのを売りにしていたオープンソースのサイトもありましたが、v2になり、処理系のバージョン設定、細かいビルドオプションの設定など、この別実装にあった機能はすべて本家にも実装されました。また、本書執筆時点ではV3となった最新のPlaygroundが利用できるようになりました。こちらはビルド結果の.d.tsファイルの結果も確認することができ、書いたコードがどのようにTypeScript処理系に解釈されたのかを確認するのも簡単になりました。
+ブラウザでTypeScriptが試せるPlaygroundにも何種類かありますが、現在は公式のPlaygroundが一番おすすめです。以前は本家よりも強力というのを売りにしていたオープンソースのサイトもありました\ [#]_\ が、v2になり、処理系のバージョン設定、細かいビルドオプションの設定など、この別実装にあった機能はすべて本家にも実装されました。また、本書執筆時点ではV3となった最新のPlaygroundが利用できるようになりました。こちらはビルド結果の.d.tsファイルの結果も確認することができ、書いたコードがどのようにTypeScript処理系に解釈されたのかを確認するのも簡単になりました。
 
 * URL: https://www.typescriptlang.org/play/
 

docs/_sources/variable.rst.txt

@@ -150,7 +150,7 @@ AでもBでも良い、というのは例えば数値と文字列の両方を受
 
 ``var``\ 、\ ``const``\ 、\ ``let``\ では変数の巻き上げの挙動が多少異なります。
 ``var``\ はスコープ内で宣言文の前では、変数はあるが初期化はされてない（\ ``undefined``\ ）になりますが、他の2つはコンパイルエラーになります。
-宣言前に触るのは行儀が良いとは言えないため、 ``const`` の挙動の方が適切でしょう。
+宣言前に触るのは行儀が良いとは言えないため、\ ``const``、\ ``let``\ の挙動の方が適切でしょう。
 
 .. code-block:: ts
    :caption: 変数の巻き上げ（変数の存在するスコープの宣言行前の挙動）

docs/_sources/version.rst.txt

@@ -40,7 +40,7 @@ Windowsは商品名としては95とか2000とか10とかつけたりもしま
 
 よく見るのがLTS（ロングタームサポート）という長期サポートバージョンを定めているライブラリとかツールです。
 
-Node.jsは、現在の半年ごとにメジャーバージョンアップします。最新のメジャーバージョンのものはcurrent扱いです。奇数バージョンはcurrentでなくなってすぐにサポートが終わりますが、1年に一回出る偶数バージョンは、currentでなくなると（次のバージョンが出ると)LTSになり、2年半サポートされます。現在の最新は14で14はメジャーバージョンアップ対象ですが、現在も活発に機能追加が行われていますので、LTSにはなっていません。15が出ると14がLTSになります。
+Node.jsは、現在は半年ごとにメジャーバージョンアップします。最新のメジャーバージョンのものはcurrent扱いです。奇数バージョンはcurrentでなくなってすぐにサポートが終わりますが、1年に一回出る偶数バージョンは、currentでなくなると（次のバージョンが出ると)LTSになり、2年半サポートされます。現在の最新は14で14はメジャーバージョンアップ対象ですが、現在も活発に機能追加が行われていますので、LTSにはなっていません。15が出ると14がLTSになります。
 
 例えば、12系は、2019年10月21日に12.13と13.0がリリースされ、12.13がLTSになりました。執筆時点では12.18がリリースされています。しかし、12.12以前はLTSではなく、新機能もどんどん追加されます。このあたりは他のソフトウェアと異なるルールになっていますが、アルファ版やベータ版では利用する人がおらず、数値が大きく上がったリリースのタイミングで使い始める人が多く、そこで初めて不具合が出て報告されたりするので、多くの人に使ってもらってバグ修正をするというOSSのエコシステムを考慮すると合理的な考え方であると思います。
 

docs/_sources/vue.rst.txt

@@ -284,7 +284,7 @@ Vue.jsでは、ページごとにコンポーネントと呼ばれるオブジ
 クリックイベントの定義
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Vueの作法でクリックイベントを設定しましょう。jQueryはHTMLの外でタグとイベントん関連付けを\ ``$.click()``\ を使って行っていました。Vue.jsの場合は、テンプレートの中で関数を設定します。呼び出す関数は\ ``setup``\ の中で作成します。テンプレートで\ ``clicked``\ という名前で呼びたい場合には次のように作成します。
+Vueの作法でクリックイベントを設定しましょう。jQueryはHTMLの外でタグとイベントの関連付けを\ ``$.click()``\ を使って行っていました。Vue.jsの場合は、テンプレートの中で関数を設定します。呼び出す関数は\ ``setup``\ の中で作成します。テンプレートで\ ``clicked``\ という名前で呼びたい場合には次のように作成します。
 
 .. code-block:: ts
    :caption: /src/views/mypage.vue