dphelper 3.0.7 → 3.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dphelper",
-  "version": "3.0.7",
+  "version": "3.1.1",
   "type": "module",
   "main": "index.js",
   "browser": "./dist/dphelper.umd.js",
@@ -76,7 +76,6 @@
     "dev": "npm run generate-imports && node esbuild.config.mjs --watch-and-serve",
     "npm:pack": "npm run build && cd dist && npm pack",
     "npm:publish": "npm run build && npm publish ./dist --access public",
-    "postinstall": "node postinstall.mjs",
     "test": "cd tests && npm run test",
     "lint": "cd tests && npm run lint",
     "tsc": "cd tests && tsc --noEmit",
@@ -84,7 +83,7 @@
   },
   "devDependencies": {
     "@types/crypto-js": "4.2.2",
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.1",
     "crypto-js": "4.2.0",
     "esbuild": "0.27.3",
     "esbuild-node-externals": "1.20.1",

package/tools/ai/interface.d.ts

@@ -9,4 +9,4 @@ interface AiTool {
   prompt: (template: string, vars: Record<string, any>) => string
   schema: (data: any) => string
   snapshot: () => string
-}
+}

package/tools/triggers/interface.d.ts

@@ -1,5 +1,44 @@
 interface TriggersTool {
-  click(elem: string): void
-  change(elem: string): void
-  input(elem: string): void
-}
+  /**
+   * Add a trigger for custom events.
+   * @param event - The event name
+   * @param callback - The callback to execute when the event is triggered
+   */
+  add: (event: string, callback: (...args: any[]) => void) => void
+
+  /**
+   * Listen for a trigger event (alias for add).
+   */
+  on: (event: string, callback: (...args: any[]) => void) => void
+
+  /**
+   * Emit a trigger event and call all registered callbacks.
+   * @param event - The event name
+   * @param args - Arguments to pass to the callbacks
+   */
+  emit: (event: string, ...args: any[]) => void
+
+  /**
+   * Remove a trigger event and all its callbacks.
+   * @param event - The event name
+   */
+  remove: (event: string) => void
+
+  /**
+   * Remove a specific callback from an event.
+   * @param event - The event name
+   * @param callback - The callback to remove
+   */
+  off: (event: string, callback: (...args: any[]) => void) => void
+
+  /**
+   * Clear all triggers.
+   */
+  clear: () => void
+
+  /**
+   * List all registered trigger events.
+   * @returns Array of event names
+   */
+  list: () => string[]
+}

package/types/dphelper.d.ts

@@ -486,9 +486,48 @@ declare global {
 
   // --- triggers ---
   interface TriggersTool {
-    click(elem: string): void
-    change(elem: string): void
-    input(elem: string): void
+    /**
+     * Add a trigger for custom events.
+     * @param event - The event name
+     * @param callback - The callback to execute when the event is triggered
+     */
+    add: (event: string, callback: (...args: any[]) => void) => void
+  
+    /**
+     * Listen for a trigger event (alias for add).
+     */
+    on: (event: string, callback: (...args: any[]) => void) => void
+  
+    /**
+     * Emit a trigger event and call all registered callbacks.
+     * @param event - The event name
+     * @param args - Arguments to pass to the callbacks
+     */
+    emit: (event: string, ...args: any[]) => void
+  
+    /**
+     * Remove a trigger event and all its callbacks.
+     * @param event - The event name
+     */
+    remove: (event: string) => void
+  
+    /**
+     * Remove a specific callback from an event.
+     * @param event - The event name
+     * @param callback - The callback to remove
+     */
+    off: (event: string, callback: (...args: any[]) => void) => void
+  
+    /**
+     * Clear all triggers.
+     */
+    clear: () => void
+  
+    /**
+     * List all registered trigger events.
+     * @returns Array of event names
+     */
+    list: () => string[]
   }
 
   // --- types ---

package/postinstall.mjs

@@ -1,23 +0,0 @@
-// dphelper postinstall
-// Creates node_modules/@types/dphelper/index.d.ts automatically so TypeScript
-// discovers dphelper's global types without any configuration in the consumer project.
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const
-  __dirname = path.dirname(fileURLToPath(import.meta.url)),
-  // When postinstall runs, cwd is the consuming project root.
-  // __dirname is node_modules/dphelper/
-  atTypesDir = path.join(__dirname, '..', '@types', 'dphelper'),
-  atTypesFile = path.join(atTypesDir, 'index.d.ts'),
-  reference = '/// <reference path="../../dphelper/types/dphelper.d.ts" />\n'
-
-try {
-  fs.mkdirSync(atTypesDir, { recursive: true })
-  fs.writeFileSync(atTypesFile, reference, 'utf8')
-  console.debug('[dphelper] Global types registered at node_modules/@types/dphelper/index.d.ts')
-} catch (e) {
-  // Non-fatal: types can still be referenced manually
-  console.debug('[dphelper] Could not auto-register types:', e)
-}