Merge pull request #1 from dmasior/v0.4

Add AI integration, plugin system, and migrate to ES modules

Author: dmasior

.github/workflows/build.yaml

@@ -18,12 +18,12 @@ jobs:
         uses: actions/checkout@v3
 
       - name: Set up Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v6
         with:
-          node-version: 22
+          node-version: 24
 
-      - name: Install dependencies
-        run: npm install
+      - name: Clean install dependencies
+        run: npm ci
 
       - name: Build application
         run: npm run make -- --arch x64,arm64

PLUGINS.md

@@ -0,0 +1,71 @@
+# Plugins
+
+DMTool loads plugins from `~/.dmtool/plugins/`. Each plugin is an ES module (`.js` or `.mjs`) that exports a default object with a name and a list of actions.
+
+## Plugin structure
+
+```js
+export default {
+  name: "My Plugin",
+  actions: [
+    {
+      label: "Uppercase",
+      fn: (clipboardText) => clipboardText.toUpperCase(),
+    },
+    {
+      label: "Nested",
+      submenu: [
+        {
+          label: "Reverse",
+          fn: (clipboardText) => clipboardText.split("").reverse().join(""),
+        },
+      ],
+    },
+  ],
+};
+```
+
+### Action fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `label` | `string` | Menu item label |
+| `fn` | `(clipboardText: string) => string \| Promise<string>` | Receives current clipboard text, returned string is written back to clipboard |
+| `submenu` | `Action[]` | Nested actions (cannot have `fn` at the same level) |
+
+## Environment variables
+
+Place a `.env` file in `~/.dmtool/` to provide environment variables to plugins. Standard `KEY=VALUE` format, supports `#` comments and quoted values.
+
+```
+# ~/.dmtool/.env
+API_URL=https://api.example.com
+API_KEY=abc123
+```
+
+Access in plugins via `process.env.API_URL`, `process.env.API_KEY`, etc.
+
+## Example: fetch-based plugin
+
+```js
+export default {
+  name: "Translate",
+  actions: [
+    {
+      label: "To Spanish",
+      fn: async (text) => {
+        const { API_URL, API_KEY } = process.env;
+        const res = await fetch(`${API_URL}/translate?to=es&key=${API_KEY}&text=${encodeURIComponent(text)}`);
+        const data = await res.json();
+        return data.translation;
+      },
+    },
+  ],
+};
+```
+
+## Notes
+
+- Plugins are loaded once at startup. Restart DMTool after adding or modifying plugins.
+- If a plugin fails to load, an error is logged into `~/.dmtool/dmtool.log` and other plugins are unaffected.
+- Async `fn` functions are supported.

README.md

@@ -1,39 +1,31 @@
 # DMTool
 
-Tool for developers. Perform operations on your clipboard data with ease.
+A menu bar utility that transforms your clipboard - encode, format, hash, and more.
 
-![dropdown presentation](./assets/dropdown_presentation.png)
+![dropdown presentation](./assets/dropdown.png)
 
 ## Features
 
-- Encode and decode: Base64, Hex, URL, HTML
-- JSON utility functions
-  - Beautify and minify
-  - Escape and unescape
-  - Validate
-- Trim
-- Convert case
-  - Uppercase, lowercase
-  - Capitalize words, sentences
-  - CamelCase, snake_case, kebab-case
-- Line
-  - Count, sort, trim, reverse
-  - Remove empty
-  - Remove duplicates
-- UUID
-  - Generate V1, V4, V6, V7
-  - Validate
-  - Convert between V1 and V6
-- Hash
-  - MD5, SHA1,
-  - SHA256, SHA384, SHA512,
-  - SHA3-256, SHA3-384, SHA3-512,
-  - BLAKE2b
+- **AI** — Query GitHub Copilot models with your clipboard as context
+- **Encoding** — Base64, URL, HTML entities (encode/decode)
+- **JSON** — Validate, beautify, minify, escape/unescape
+- **Lines** — Sort, trim
+- **UUID** — Detect version, generate V1/V4/V6/V7
+- **Hash** — MD5, SHA1
+- **Plugins** — Extend with custom JS plugins (see [PLUGINS.md](PLUGINS.md))
+
 ## Usage
 
-1. Copy the data you want to perform an operation on
-2. Select the operation from the dropdown
-3. Paste the result
+1. Copy text to your clipboard
+2. Click the DMTool icon in the menu bar
+3. Select an operation
+4. The result is automatically copied — just paste
+
+## Plugins
+
+DMTool supports user-defined plugins loaded from `~/.dmtool/plugins/`. Plugins are ES modules that add custom actions to the tray menu. Environment variables can be provided via `~/.dmtool/.env`.
+
+See [PLUGINS.md](PLUGINS.md) for the full plugin API and examples.
 
 ## Download