隨著 TypeScript 的日益流行，許多開發人員正在創建靜態類型包以利用該語言提供的優勢。在這篇文章中，我們將介紹使用 TypeScript 建立和發布 NPM 套件的過程。

1. 配置環境

確保您已安裝 Node.js、NPM 和 TypeScript。您可以使用以下命令全域安裝 TypeScript：

npm install -g typescript

檢查一切是否安裝正確：

node -v
npm -v
tsc -v

2. 創建專案

首先為您的專案建立一個目錄：

mkdir meu-pacote-typescript
cd meu-pacote-typescript

初始化 Node.js 專案：

npm init

這將建立 package.json 文件，您可以在其中定義基本套件資訊。

3. 配置 TypeScript

現在，初始化一個 TypeScript 專案：

tsc --init

這將建立一個 tsconfig.json 檔案。根據需要進行編輯，但常見的設定如下：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "declaration": true,
    "outDir": "./dist",
    "strict": true
  },
  "include": ["src/**/*"]
}

在這裡，我們配置 TypeScript 編譯器來產生帶有 CommonJS 模組的 ES6 程式碼，並包含類型聲明（聲明：true）。編譯後的程式碼會放在dist.

4. 編寫程式碼

建立一個 src 目錄並在其中建立一個檔案index.ts:

mkdir src
touch src/index.ts

在index.ts檔案中，編寫您的套件程式碼。讓我們建立一個簡單的函數來將字串轉換為大寫：

export function toUpperCase(str: string): string {
  return str.toUpperCase();
}

5. 編譯程式碼

將 TypeScript 編譯為 JavaScript：

tsc

這將在 dist 目錄中產生 JavaScript 檔案和類型聲明。

6. 本地測試包

要測試您的包，您可以將其本地安裝在另一個專案中：

1. 在您的測試專案目錄中，執行：

   npm install ../caminho-para-o-diretorio-do-seu-pacote/dist

1. 在測試項目中使用此函數：

   import { toUpperCase } from 'nome-do-seu-pacote';

   console.log(toUpperCase('hello world')); // "HELLO WORLD"

這確保 JavaScript 程式碼和類型聲明都能正常運作。

7. 在NPM上發布

如果一切正常，您就可以發布您的包了。

1. NPM登入

如果您還沒有 NPM 帳戶，請建立一個並登入：

   npm login

1. 發布

在發布前，先在package.json中加入建置腳本：

   "scripts": {
     "build": "tsc"
   }

並在package.json中加入輸出路徑：

   "main": "dist/index.js",
   "types": "dist/index.d.ts"

現編譯發布：

   npm run build
   npm publish

如果套件名稱已存在，則需要選擇一個新名稱。

8. 更新包

要發布新版本，請更改package.json中的版本，再次運行npm run build，然後發布：

npm publish

9. 最佳實踐

• 文件：包含一個 README.md 文件，解釋如何使用您的套件。
• 測試：使用 Jest 等框架編寫測試，以確保程式碼能如預期運作。
• Linting：使用 ESLint 和 Prettier 等工具來維護程式碼品質。
• 版本控制：按照 SemVer 對您的套件進行版本控制。

結論

在 NPM 上建立和發布 TypeScript 套件不僅可以提高程式碼品質，還可以為使用套件的使用者提供打字優勢。透過遵循本指南，您將準備好與 JavaScript 和 TypeScript 社群分享您的解決方案，為更強大、更穩健的開發生態系統做出貢獻。

現在您已經了解了流程，那麼開始建立您的下一個 TypeScript 套件呢？