@gustavderdrache @Ledragon上記では、いくつかの未解決のタスクを、D3定義のセットである全体のラウンドに統合しました。

重要な質問：すべての定義を一貫してTS> = 2.3制約にアップグレードし、その過程でジェネリックスのデフォルトの割り当てを使用して、関数/メソッドのオーバーロードの一部を削除しますか？
私は（うっかりして）いくつかの定義がすでに定義ヘッダーに// TypeScript Version: 2.3制約を持っていることに気づきました。 たとえば、 d3-geoは、 geoJsonの定義を使用します。 これらはすでに一般的なデフォルトを使用しています。

この問題についてのあなたの考えは大歓迎です。

これを理解するあなたはそれを研究しなければなりません

TS 2.3の最小値を実装する場合は、必要に応じて、 any objectタイプを使用できるようにする必要があります。 TS2.2に付属しています。 私が正しく思い出せば、オブジェクト補間器とd3-collectionにはいくつかの機会がありました。

最初の考え：

• あなたが遭遇したメモリ不足のバグのために、どこでも2.4を強制するべきではありませんか？
• ここにstrictNullChecksとstrictFunctionTypesのブランチがあります。 更新してPRを提出します。 やったと思ったのですが、そうではないようです

これについて意見を述べる前に、デフォルトのジェネリックについて学ぶ必要があります：p

TS 2.3では、2017年4月からのリリースを検討しています。
TS2.4は2017年6月にリリースされました。

したがって、大きな問題は、最小2.4（2.3ではなく）を強制するときに、インストールベースの大部分または無視できる部分/部分なしで問題を作成するかどうかです。

追加された課題の1つは、D3定義の使用方法に対する潜在的に重大な変更にフラグを立てる変更ログ自体がないことです。 そして、定義のマイナーバージョンリリースでは、基礎となるD3リリースサイクルと整合しているため、重大な変更が発生する可能性があるという明らかな断絶があります。

@gustavderdrache新しい最小値としてのTS2.4についてどう思いますか？

PR＃23654に見られるように、TS 2.4に移行すると、すぐにカスケードするように見えます（文字列列挙型など、TS 2.4の機能を使用せずにDTのために制約を課している場合でも）。

新しいPR＃23724に従って明確にするために、TS2.3を使用するだけで続行できます。 今のところ、TS2.4で前進する必要はありません。

@Ledragonローカルのd3-geoフォークで保留中のPRを開きたい場合は、上のチェックボックスをオンにすることができます。

私は実際にそれをローカルでテストすることができません...それで私はそれを提出することができると思います、しかし私はそれがtravisテストに合格するとは思いません。 先に進んで見ていきます

23794が提出されました-私の最も誇らしい作品ではありません、それがどうなるか見てみましょう...

さて、問題は次のとおりです。 d3-geoテストはTS 2.3で失敗するので、バージョンを2.4に設定してみました。 ただし、 d3グローバルはTS 2.3に設定されているため、これも機能しません。 続行する方法について何かアドバイスはありますか？

g3-geo PRを見て、焦点を合わせ続けるためにレビューコメントをそこに置きます。 d3-collectionで発生したOoMバグとは異なり、適切なエラーメッセージが表示されます😄

d3-contourを1.2.0に更新するために＃24118を送信しました
d3-contourタイプがすでにTS2.3にあり、 strictNullChecksとstrictFunctionTypesがtrueに設定されていることに気付きました:-)

d3-contourの上にとどまってくれてありがとう、奇妙な理由で私が「ウォッチング」のレポを持っていなかったことに気づきました。 それを変えました！ ：笑顔：

すぐにPRを見ていきます。

私はd3軸とd3フォーマットに取り組んでいます。 ほぼ完了です。 しかし、いくつか質問があります...

d3-formatでは、d3-arrayと同じNumericインターフェイスを使用したいと思います。

interface Numeric {
    valueOf(): number;
}

しかし、これを行うと、d3グローバル定義で論理的にエラーが発生します： Module 'd3-array' has already exported a member named 'Numeric'. d3ライブラリの共有型を配置する場所はありますか？

また、一部のd3定義（補間、スケール、形状）には、共用体タイプnumber | { valueOf(): number }があります。 { valueOf(): number }では不十分ですか？

@denisname d3-axis 、 d3-format以降のd3-arrayのボランティアに感謝します!!!

上記の質問に対して：

（1） d3-xxxモジュールの定義を作成するための基本的なルールとして、定義は、基礎となる対応するD3モジュール間に存在しない依存関係を導入してはなりません。 たとえばd3-axisはd3-arrayに依存しないため、 d3-axisの定義index.tsファイルを$ d3-arrayからインポートしてはなりません。 これにより、JSソースに対応する緩い結合が保証されます。 したがって、疑わしい場合は、基盤となるD3モジュールのpackage.jsonのdependenciesプロパティを確認してください。_注：もちろん、 d3-xxx-test.tsファイル内の任意のパッケージからインポートできます。 「統合」テストのために、いくつかのパッケージで実践しました。 つまり、2つのパッケージ間に正式な依存関係はないかもしれませんが、一方のメンバーはもう一方の入力として「自然に」使用されます。 たとえば、 d3-chord d3-selection $＃$を使用して、コードパスを問題なく選択属性セッターに渡すことができることを確認しています。_

（2）正解です。ルール（1）に従ってd3-arrayからインポートできない他のD3モジュールでは、 Numericインターフェイスを再宣言することはできません。

（3） { valueOf(): number }では不十分ですか？ 技術的にはそうです。 実際には、交差型はある程度の冗長性がありますが、多くの人間のユーザーにとってはおそらくより明確です。 つまり、 numberは、精神的なアクロバットがなくても、一見有効なタイプであることを示しています。 ：ウィンク：

d3-colorについて、なぜprototypeがすべてコメントアウトされているのですか？ これは、@tomwanzekによるこのコミットで行われました。

プロトタイプを元に戻すと、タイプガード関数を必要とせずに、 instanceofを直接使用できます。

let cRGB: d3.RGBColor;
let cHSL: d3.HSLColor;

const c: d3.RGBColor | d3.HSLColor = d3.color("steelblue");

if (c instanceof d3.rgb) {
    cRGB = c;
} else {
    cHSL = c;
}

@denisnameインターフェースで公開されたAPIの一部としてprototypeを定義することを躊躇してきましたが、ハッキーすぎると感じています。

今日のタイプガードの仕様から私が理解していることについて。 これは現在、有効な_構築_と見なされます。 リスト項目を参照してください。

x instanceof Cの形式のタイプガード。xはタイプAnyではなく、 Cはグローバルタイプ'Function'のサブタイプであり、 Cには次の名前のプロパティがあります。 「プロトタイプ」[...]

d3-colorのstrictNullChecksバージョンを提案したいと思います。 これは1行の変更です。 これは、 prototypeも追加する機会になります。

私自身のテストから、タイプを適切に絞り込むには、 prototypeプロパティまたはinstanceofのnew(): T宣言のいずれかが必要です。 私はv3タイピングでnew(): Colorのバリエーションを使用しましたが、そのイディオムがD3v4以降で引き続きサポートされていると便利な場合があります。

どちらも問題ないように思われるので、継続性についてはv3の規則に従うかもしれないと思います。 両方とも素晴らしい仕事です。

@gustavderdrache

d3 v3で機能する理由についての私の理解は、 new()の戻り型は常にprototype型と同じであるということです。 しかし、d3 v4には、次のものもあります。

export const color: ColorFactory;
export interface ColorFactory extends Function {
    (cssColorSpecifier: string): RGBColor | HSLColor;
    prototype: Color; // and not RGBColor | HSLColor !
}

確かに、 d3.lab(0,0,0) instanceof d3.colorは本当です。 したがって、このインターフェイスを次のように変更すると、次のようになります。

export const color: ColorFactory;
export interface ColorFactory extends Function {
    (cssColorSpecifier: string): RGBColor | HSLColor;
    new (cssColorSpecifier: string): RGBColor | HSLColor;
}

ColorFactoryのタイプColorのprototypeはありません。 そして、次のコードはコンパイルに失敗しますが、コンパイルは失敗しません。

declare let l: d3.LabColor | null;
declare let c: d3.Color;
declare let nil: null;

if (l instanceof d3.color) {
    c = l; // l is not inferred as `d3.LabColor`...
} else {
    nil = l; // fail, l is a `d3.LabColor | null` should be a `null`
}

あなたの意見は何ですか？ newで動作させる方法はありますか？ ありがとう。

いくつかのテストに基づくと、 color()のprototypeプロパティはRGBColor | HSLColor Colorである必要があるようです。

> d3.color.prototype === d3.rgb.prototype
false
> d3.rgb.prototype instanceof d3.color
true

color()関数はRGBまたはHSL色を返しますが、そのプロトタイプは他の色空間のスーパータイプです。

@denisname @Ledragon @gustavderdrache皆さんはこのスレッドに参加しているので、簡単な参考までに：今週末に知っている未解決のアイテムに追いつくつもりです。

了解しました。d3-geoはドアの外にあり（@ledragonに感謝）、 @denisnameの再開に関するd3-formatとd3-axisの残念ながら閉鎖されたPRについてコメントしました。

一般的な注意として、 @denisnameを別のメンテナとして定義に追加することをお勧めします。

次にd3-colorを見て、 1.1.0へのアップデートで参加するかもしれません。 このアップグレードについて別の問題を開く必要がありますか？

また、 @ denisnameにようこそ！

@Ledragonありがとう。

d3-colorのアップデートの準備ができています（ lhcとgrayまだありません）。 私はただ1つの小さな問題で立ち往生しています。

@gustavderdracheは言った：

color（）関数はRGBまたはHSL色を返しますが、そのプロトタイプは他の色空間のスーパータイプです。

確かに、これは簡単に_typed_できます。私のコメントの最初のインターフェースを参照してください。 しかし、 @ tomwanzekは、 new()のみを使用し、 prototype $を回避することを提案しました。 この特定のケースではそれは不可能だと思います。 番号？...

もう少し遊んだ後、問題が発生しました。 ColorConstructorインターフェースでnew(): Colorを設定できますが、実際には関数の戻り値をカバーしていません。

declare namespace d3 {
  interface Color {
    // I forgot what was on the Color interface
    // This property exists just to make Color incompatible with {}
    __isColor: never;
    toString(): string;
  }

  interface RGBColor extends Color {
    r: number;
    g: number;
    b: number;
  }

  interface HSLColor extends Color {
    h: number;
    s: number;
    l: number;
  }

  interface LABColor extends Color {
    l: number;
    a: number;
    b: number;
  }

  interface ColorConstructor {
    (specifier: string): RGBColor | HSLColor;
    new(specifier: string): Color; // <- TS uses this for narrowing with instanceof
  }

  const color: ColorConstructor;
}

declare let l: d3.LABColor | null;
declare let c: d3.Color;
declare let nil: null;

if (l instanceof d3.color) {
  // Succeeds with l: d3.LABColor
  c = l;
} else {
  // Succeeds with l: null
  nil = l;
}

結論： prototypeプロパティを公開する必要があると思います。これは、コンストラクターとinstanceofテストの両方の正しい動作をカバーする唯一の方法だからです。

  interface ColorConstructor {
    (specifier: string): RGBColor | HSLColor;
    new(specifier: string): RGBColor | HSLColor;

    readonly prototype: Color; 
  }

申し訳ありませんが、これに戻るのが遅れてしまいました。 prototypeを自由に使ってください。当時、 instanceofにも取り組むことが私の最初の衝動でした。 それは単にハッキーだと感じましたが、それは許容できる慣行と考えられており、D3v3のようにnew()を使用し続けることがオプションではない場合は、うまくいくものを使ってみましょう。

@tomwanzekは追跡テーブルを更新できますか。

✅は、ライブラリd3-axis 、 d3-color 、 d3-dispatch 、 d3-formatの列strictNullChecks strictFunctionTypesおよびTS 2.3に設定する必要がありますd3-format 、 d3-polygonおよびd3-hsv 。

また、 d3-dispatch 、 d3-polygon 、およびd3-hsvの列JSDocに✅を設定する必要があります。

ありがとう

d3-geoインターフェースGeoIdentityTranformにタイプミスがあります。 GeoIdentityTransform （ s付き）である必要があります。 訂正してもいいですか？ 下位互換性に関する懸念はありますか？

@denisname for d3-geo s GeoIdentityTranform 、私たちは次のことができると思います：

• スペルミスのあるインターフェースの名前を変更します（すばらしいキャッチです！）（ geoIdentity()のリターンタイプとしての使用を含む）
• とりあえず追加

/**
 * <strong i="13">@deprecated</strong> Misspelled name. Use GeoIdentityTransform.
 */
export type GeoIdentityTranform = GeoIdentityTransform;

• 後の便利な段階で、スペルミスのあるタイプを完全に削除します。

@denisname💯 @gustavderdrache@ ledragon過去少しの間、すべてのハードワークに感謝します。 私は追跡テーブルを更新しました、すでにとてもきれいに見えます！ なぜなら、きれいな追跡テーブルが私たちがここで目指しているものだからです：smile：

なぜなら、かなりの追跡テーブルが私たちがここで目指しているものだからです

絶対！ 改善された型定義は、単なる楽しい副作用です。

現在、技術的負債を完了するために特定の定義に取り組んでいる人はいますか？ d3-arrayの処理中。 次に、 d3-transitionのstrictFunctionTypesに取り組み、 d3-selectionと同等にします。 ＃25805がマージされるのを待っています。

ATMではありません。 私がそうするかどうか、いつするかをみんなに知らせます

5.2.0グローバルバンドルにスタンプできるように＃25582に取り組んでいます

d3-hierarchyの準備ができています（strictおよびjsDoc）。
d3-dsvとd3-fetch （ts 2.3）にも取り組んでいます。

@denisname @tomwanzek @gustavderdrache
これに焦点を当てるべきですか、それともd3を最新バージョンに更新することに焦点を当てるべきですか？ 現在、グローバルパッケージでは5つのマイナーバージョンが遅れています（ただし、すべてのサブパッケージは5.2.0の準備ができていると思います）。 グローバルパッケージステータスを追跡するために別の問題を開きますか？

@Ledragon今夜オープンPRに追いつき、すべてのD3モジュール定義を通貨について解析します。 遅れがある場合は、追跡の問題を1つ作成して、それらを標準に戻します。 優先順位については、技術的負債の削減よりも通貨を優先すべきであることに同意します。

このスレッドを汚染して申し訳ありませんが、新しいプロジェクトのためにD3.jsに戻っています。D3でインラインTypeScriptアノテーションを使用することを検討したかどうか疑問に思いました。

/** <strong i="6">@type</strong> {SyncBailHook<Compilation>} */
shouldEmit: new SyncBailHook(["compilation"]),

webpackでは、TypeScriptコンパイラでJavaScriptをチェックするためにそれを使い始めました。大きなプラスは、実際のコードのすぐ隣にあるタイピング定義です。
https://github.com/webpack/webpack/blob/master/lib/Compiler.js#L51

こんにちは@phil-lgr
d3課題追跡システムについての議論がありましたが、それは優先リストの最上位にはなかったようです（つまり、Mike Bostockは、タイピングよりもライブラリ自体の開発に焦点を当てることを好みました）。 スレッドへのリンクが見つからないようです。 この新しい情報のおかげで、もう一度質問が出されるかもしれませんが、そうなる可能性は低いと思います。

@tomwanzekは追跡テーブルを更新できますか。

✅は、ライブラリd3-array 、 d3-array 、 d3-dsv 、 d3-fetchの列strictNullChecks strictFunctionTypesおよびTS 2.3に設定する必要がありますd3-fetch 、 d3-hexbin 、 d3-hierarchy 、 d3-interpolate 、 d3-quadtree 、 d3-queue 、 d3-request 、 d3-timerおよびd3-voronoi 。

また、 d3-color 、 d3-hexbin 、 d3-hierarchy 、 d3-interpolate 、およびd3-quadtreeの列JSDocに✅を設定する必要があります。

ありがとう