ESM および CommonJS 用のハイブリッド NPM モジュールの作成

解像度

)K では、育て方のコツとは:

• 単一ソースコード不適切

簡単な組み立て ネイティブ ESM コードを生成します既存のツールで動作します ESM または CommonJS の両方のハイブリッド キットを生成します

• Single Source Execrable

  ES6 でコードを作成し、 ES-Next や Typescript の import と export の使い方 インポートを使用して、ES モジュールまたは CommonJS モジュールの両方を適切にインポートします。 逆はもはや適切ではありません。 CommonJS で作成する場合は、ES モジュールを使用する必要がなくなる可能性があります。

  輸入 形 から ‘./ Shape.js’ 輸出 クラス MyS hape

  {

コンストラクタ

() { これ.形 =

個性的
)形() }
}

export default の使用法をインポートして使用する場合は注意が必要です。 requireのCommonJSの能力による。 TypeScript または Babel トランスパイラーは、エクスポート real を module.exports に自動的にバンドルし、インポート時に「.default」参照を生成します。代わりに、ネイティブの NodeJS はもう使用しません。 この式は、トランスパイラーを使用しなくなった場合、おそらく .default を実行する必要がある可能性があります。 参照。

輸入 形 から  './Shape.js' const

形 = 個性的 形.

デフォルト

()

建物

ソースを ESM 用と CommonJS 用の 2 回用意します。

Typescript をトランスパイラーとして実行し、ES6/ES- で作成します次またはタイプスクリプト。 または、Babel は ES6 でうまく機能します。Javascript レコードデータは .js 拡張であり、もはや .mjs[“node_modules”, “dist”] ではありません または .cjs 拡大。 Typescript recordsdata は、.ts 拡張子を占めることができます.kit.json アセンブル スクリプトは次のとおりです: kit.json:

 {  

「スクリプト」 :

{
“組み立てる”:
“rm -fr dist/&& tsc -p tsco nfig.json && tsc -p tsconfig-cjs.json && ./fixup”

}

)}

tsconfig.json[

“src”] は、ESM および tsconfig-cjs.json 用にアセンブルするようにセットアップされています。 は CommonJS 用にビルドします。 設定の重複を判断するために、共有 tsconfig-inproperty.json には、ESM ビルドと CommonJS ビルドの両方に弱い共有アセンブル設定が含まれています。デフォルト tsconfig.json は ESM 用で、「esnext」の使用法をビルドします。 これを「es2015」または任意のプリセットに交換します

tsconfig.json:

{ 「伸びる」
: "./tsconfig-inproperty.json",

“コンパイラオプション” :

{ “モジュール”

: 「エスネクスト」,

“outDir” :

"dist/mjs" ,   

“プロット”: 「エスネクスト」 } }

• tsconfig-cjs.json:

  { 「伸びる」: “./ tsconfig-inappro priate.json”, “コンパイラオプション” :

  { “モジュール”:

  「commonjs」 , “outDir” : “dist/cjs”

  , “プロット”:

  「es2015」 } }

  これが tsconfig です-すべての共有設定を含む ES6 コード用の inproperty.json:
  tsconfig-inproperty.json:

  {

  “コンパイラオプション”

  :
  {
  “allowJs” :
  適切な, “allowSyntheticDefaultImports” : 適切な

  ,

  • 」 baseUrl”:
    “src” 、

  “宣言”: 適切な, “esModuleInterop” :

  適切な, “inlineSourceMap”: 真実でない
  ,

    "lib"   : 

  、

  “listEmittedFiles” : 真実でない

  ,

“listFiles”:

嘘 , 「モジュール解像度」
: “ノード”, “noFallthroughCasesInSwitch”:

  適切な,  

「コメリ」 : 適切な, “resolveJsonModule”: 適切な,

“rootDir” :

“src”, “skipLibCheck”: 適切な ,
“厳しい”: 適切な, “traceResolution”:

うそ ,

「種類」 :

[

“node”, “jest”]

}, “compileOnSave”: 真実でない
,

  "除外"
:   ["node_modules", "dist"],  

“からなる”: [“src”] }

ESM/CJS kit.json ごと

組み立ての最後のステップは簡単です ディストリビューションごとに kit.json を作成する fixup スクリプト レコードデータ。 これらの kit.json レコードデータは、.dist/のデフォルトのキット スタイルを説明します。 サブディレクトリ。
修正:
猫 >dist/cjs/kit.json >dist/mjs/kit.json
<