milkee 2.4.1 → 2.4.3

package/dist/commands/plugin.js

@@ -99,7 +99,7 @@ copyDocs = function(src, dest) {
   return true;
 };
 
-PLUGIN_KEYWORDS = ['milkee', 'coffeescript', 'coffee', 'ext', 'plugin', 'milkee-plugin'];
+PLUGIN_KEYWORDS = ['milkee', 'coffeescript', 'coffee', 'plugin', 'milkee-plugin'];
 
 // Update package.json
 updatePackageJson = function() {

package/docs/PLUGIN-ja.md

@@ -0,0 +1,143 @@
+# Milkee プラグインの作成
+
+カスタムプラグインで Milkee の機能を拡張できます。  
+
+## クイックスタート
+
+`-p` (`--plugin`) コマンドでプラグインプロジェクトをセットアップ：  
+
+```bash
+# グローバル
+milkee -p
+
+# ローカル
+npx milkee -p
+```
+
+以下が実行されます：
+1. `package.json` の初期化（必要な場合）
+2. 依存関係のインストール (`consola`, `coffeescript`, `milkee`)
+3. テンプレートファイルの作成
+4. `package.json` の更新 (`main`, `scripts`, `keywords`)
+
+## プロジェクト構造
+
+```
+your-plugin/
+  src/
+    main.coffee    # プラグインのソース
+  dist/
+    main.js        # コンパイル後の出力
+  .github/
+    workflows/
+      publish.yml  # npm公開ワークフロー
+  coffee.config.cjs
+  package.json
+```
+
+## プラグインの書き方
+
+### 基本テンプレート
+
+```coffee
+fs = require 'fs'
+path = require 'path'
+consola = require 'consola'
+
+pkg = require '../package.json'
+PREFIX = "[#{pkg.name}]"
+
+# プレフィックス付きカスタムロガー
+c = {}
+for method in ['log', 'info', 'success', 'warn', 'error', 'debug', 'start', 'box']
+  do (method) ->
+    c[method] = (args...) ->
+      if typeof args[0] is 'string'
+        args[0] = "#{PREFIX} #{args[0]}"
+      consola[method] args...
+
+# メインプラグイン関数
+main = (compilationResult) ->
+  { config, compiledFiles, stdout, stderr } = compilationResult
+
+  c.info "#{compiledFiles.length} ファイルをコンパイルしました"
+  for file in compiledFiles
+    c.log "  - #{file}"
+
+module.exports = main
+```
+
+### コンパイル結果
+
+Milkee はコンパイル後にこのオブジェクトをプラグインに渡します：  
+
+| プロパティ      | 型         | 説明                                           |
+| :-------------- | :--------- | :--------------------------------------------- |
+| `config`        | `object`   | `coffee.config.cjs` の設定オブジェクト         |
+| `compiledFiles` | `string[]` | コンパイルされた `.js` と `.js.map` のパス     |
+| `stdout`        | `string`   | コンパイラの標準出力                           |
+| `stderr`        | `string`   | コンパイラの標準エラー                         |
+
+### coffee.config.cjs での使用
+
+```js
+const myPlugin = require('your-plugin-name');
+
+module.exports = {
+  entry: 'src',
+  output: 'dist',
+  milkee: {
+    plugins: [
+      myPlugin({ customOption: 'value' }),
+    ]
+  }
+};
+```
+
+## ビルド & テスト
+
+```bash
+# プラグインをビルド
+npm run build
+
+# ローカルテスト用にリンク
+npm link
+
+# 別のプロジェクトで
+npm link your-plugin-name
+```
+
+## 公開
+
+### GitHub Actions を使用
+
+同梱のワークフローで npm に手動公開：  
+
+1. リポジトリに `NPM_TOKEN` シークレットを追加
+2. **Actions** → **Manual Publish to npm** に移動
+3. **Run workflow** をクリック
+
+### 手動
+
+```bash
+npm run build
+npm publish --access public
+```
+
+## ベストプラクティス
+
+### 命名規則 & キーワード
+
+- 名前: `milkee-plugin-xxx` または `@yourname/milkee-plugin-xxx`
+- キーワード（自動追加）: `milkee`, `coffeescript`, `coffee`, `ext`, `plugin`, `milkee-plugin`
+
+### エラーハンドリング
+
+```coffee
+main = (compilationResult) ->
+  try
+    # ロジック
+  catch error
+    c.error "失敗:", error.message
+    throw error
+```

package/docs/PLUGIN.md

@@ -0,0 +1,143 @@
+# Creating a Milkee Plugin
+
+Extend Milkee's functionality with custom plugins.  
+
+## Quick Start
+
+Run `-p` (`--plugin`) command to set up your plugin project:  
+
+```bash
+# global
+milkee -p
+
+# or local
+npx milkee -p
+```
+
+This will:
+1. Initialize `package.json` (if needed)
+2. Install dependencies (`consola`, `coffeescript`, `milkee`)
+3. Create template files
+4. Update `package.json` (`main`, `scripts`, `keywords`)
+
+## Project Structure
+
+```
+your-plugin/
+  src/
+    main.coffee    # Your plugin source
+  dist/
+    main.js        # Compiled output
+  .github/
+    workflows/
+      publish.yml  # npm publish workflow
+  coffee.config.cjs
+  package.json
+```
+
+## Writing Your Plugin
+
+### Basic Template
+
+```coffee
+fs = require 'fs'
+path = require 'path'
+consola = require 'consola'
+
+pkg = require '../package.json'
+PREFIX = "[#{pkg.name}]"
+
+# Custom logger with prefix
+c = {}
+for method in ['log', 'info', 'success', 'warn', 'error', 'debug', 'start', 'box']
+  do (method) ->
+    c[method] = (args...) ->
+      if typeof args[0] is 'string'
+        args[0] = "#{PREFIX} #{args[0]}"
+      consola[method] args...
+
+# Main plugin function
+main = (compilationResult) ->
+  { config, compiledFiles, stdout, stderr } = compilationResult
+
+  c.info "Compiled #{compiledFiles.length} file(s)"
+  for file in compiledFiles
+    c.log "  - #{file}"
+
+module.exports = main
+```
+
+### Compilation Result
+
+Milkee passes this object to your plugin after compilation:  
+
+| Property        | Type       | Description                                    |
+| :-------------- | :--------- | :--------------------------------------------- |
+| `config`        | `object`   | Full config from `coffee.config.cjs`           |
+| `compiledFiles` | `string[]` | Paths to compiled `.js` and `.js.map` files    |
+| `stdout`        | `string`   | Compiler standard output                       |
+| `stderr`        | `string`   | Compiler standard error                        |
+
+### Using in coffee.config.cjs
+
+```js
+const myPlugin = require('your-plugin-name');
+
+module.exports = {
+  entry: 'src',
+  output: 'dist',
+  milkee: {
+    plugins: [
+      myPlugin({ customOption: 'value' }),
+    ]
+  }
+};
+```
+
+## Build & Test
+
+```bash
+# Build your plugin
+npm run build
+
+# Link for local testing
+npm link
+
+# In another project
+npm link your-plugin-name
+```
+
+## Publishing
+
+### Using GitHub Actions
+
+The included workflow publishes to npm manually:  
+
+1. Add `NPM_TOKEN` secret to your repository
+2. Go to **Actions** → **Manual Publish to npm**
+3. Click **Run workflow**
+
+### Manual
+
+```bash
+npm run build
+npm publish --access public
+```
+
+## Best Practices
+
+### Naming & Keywords
+
+- Name: `milkee-plugin-xxx` or `@yourname/milkee-plugin-xxx`
+- Keywords (auto-added): `milkee`, `coffeescript`, `coffee`, `ext`, `plugin`, `milkee-plugin`
+
+### Error Handling
+
+```coffee
+main = (compilationResult) ->
+  try
+    # Your logic
+  catch error
+    c.error "Failed:", error.message
+    throw error
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "milkee",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "A simple CoffeeScript build tool with coffee.config.cjs",
   "main": "dist/main.js",
   "bin": {

package/temp/plugin/coffee.config.cjs

@@ -29,6 +29,8 @@ module.exports = {
       // refresh: false,
       // Before compiling, confirm "Do you want to Continue?"
       // confirm: false,
+      // After compiling, copy non-coffee files from entry to output directory. (Only works when options.join is false)
+      // copy: false,
     },
     plugins: []
   },