evty 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 v12yun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,4 +1,88 @@
-# ⚡ evty
+# ⚡ evty 
+### 🌐 English version is available below.
+
+`.env` ファイルから、**スマートな型推論**と**JSDocコメント**を備えたTypeScript型定義ファイルを自動生成・リアルタイム監視する、設定不要（Zero-Config）の超軽量CLIツールです。
+
+事前のインストールは一切不要。`npx` コマンド一発で即座に動作します。
+
+---
+
+## ✨ 主な特徴
+
+- ⚡ **設定ゼロで即起動 (Zero Config)**: 複雑なJSON設定は一切不要。コマンドを叩いた瞬間に機能します。
+- 🔮 **高度な型推論 (Smart Type Inference)**: `.env` 内の値を自動解析。`PORT=3000` は `string | "3000"` へ、`DEBUG=true` は `"true" | "false"` へと最適なリテラル型を自動割り当て。
+- 📝 **JSDocの自動同期 (Auto JSDoc Comments)**: `.env` 内のコメント行（`# コメント`）を、そのままTypeScriptのJSDocへ変換。エディタ上で `process.env.VAR` にマウスホバーするだけで、詳細な説明が即座にポップアップ表示されます。
+- 👀 **変更のリアルタイム監視 (Watch Mode)**: `.env` ファイルの保存をトリガーに、ミリ秒単位で型定義ファイルを自動更新。開発の手を止める必要はありません。
+- 👶 **開発環境への全自動親切設計**: 万が一プロジェクト内に `.env` が存在しない場合は、サンプル付きのテンプレートを自動生成して開発者をサポートします。
+
+---
+
+## 🚀 クイックスタート
+
+お使いのプロジェクトのルートディレクトリ（`.env` がある場所）のターミナルで、以下のコマンドを1行実行するだけです。
+
+```bash
+npx evty
+```
+
+これだけで `evty` が起動し、プロジェクト内の `.env` を解析して `env.d.ts` を自動生成し、そのままリアルタイム監視モードへと移行します。
+
+---
+
+## 💡 動作イメージ
+
+### 1. 開発中の `.env` ファイル:
+```env
+# ローカルサーバーが起動するポート番号
+PORT=3000
+
+# 開発用デバッグモードの切り替えフラグ
+DEBUG=true
+
+# MongoDBの接続文字列
+DATABASE_URL=mongodb://localhost:27017/mydb
+```
+
+### 2. 自動生成される `env.d.ts`:
+```typescript
+declare global {
+  namespace NodeJS {
+    interface ProcessEnv {
+      /**
+       * ローカルサーバーが起動するポート番号
+       */
+      PORT: "3000" | string;
+      /**
+       * 開発用デバッグモードの切り替えフラグ
+       */
+      DEBUG: "true" | "false";
+      /**
+       * MongoDBの接続文字列
+       */
+      DATABASE_URL: string;
+    }
+  }
+}
+export {};
+```
+
+### 3. 圧倒的な開発者体験 (DX):
+VS CodeなどのモダンなIDEで `process.env.PORT` と打ち込むだけで、**強力な予測補完**が効くだけでなく、あなたが `.env` に書いた**日本語のコメントがそのままエディタ上にポップアップ表示**されます。タイポによる不具合を100%撲滅します。
+
+---
+
+## 🛠️ 動作要件
+
+- [Node.js](https://nodejs.org) (v16以上推奨)
+- TypeScriptプロジェクト（または `@ts-check` を有効化したJavaScriptプロジェクト）
+
+---
+
+## 📄 ライセンス
+
+本プロジェクトは MIT License のもとで公開されています。
+
+# English
 
 A smart, zero-config CLI tool that automatically generates TypeScript definitions from your `.env` file—complete with **smart type inference** and **JSDoc support** for a better Developer Experience (DX).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evty",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A smart, zero-config CLI tool that automatically generates TypeScript definitions (with typed values and JSDoc) from your .env file.",
   "main": "index.js",
   "bin": {