command-cmd 1.0.12 → 1.0.15

package/TODO.md

@@ -0,0 +1,16 @@
+# TODO - Implementar delayGlobal/afterClickDelay
+
+## Objetivo
+Adicionar delay configurável após cliques para garantir que o sistema registre o clique antes de executar a próxima ação.
+
+## Tarefas
+
+- [x] 1. Modificar `normalizeMapObject` para ler `delayGlobal` do JSON
+- [x] 2. Modificar `buildFallbackMap` para incluir `delayGlobal` padrão (200ms)
+- [x] 3. Modificar `createMapStore` para passar `delayGlobal` para o store
+- [x] 4. Modificar `buildCursorConfig` para ler `afterClickDelay` e mesclar com valor do map
+- [x] 5. Modificar `clickPoint` para adicionar delay após clicar
+- [x] 6. Atualizar `map.md` com documentação do novo campo `delayGlobal`
+- [x] 7. Atualizar `docPTBR.md` com documentação em português
+- [x] 8. Atualizar `mapPTBR.md` com documentação em português
+

package/cmd.js

@@ -651,6 +651,7 @@ export async function cursorSequential(input, intervalMs = 3000, options = {}) {
 function createCursorRuntime(options) {
   const config = buildCursorConfig(options);
   let mapStorePromise;
+  let afterClickDelayResolved = false;
 
   return {
     config,
@@ -659,6 +660,20 @@ function createCursorRuntime(options) {
         return mapStorePromise;
       }
       mapStorePromise = createMapStore(config);
+      
+      // After map is loaded, merge delayGlobal into config if available
+      if (!afterClickDelayResolved) {
+        try {
+          const mapStore = await mapStorePromise;
+          if (mapStore.map.delayGlobal !== undefined) {
+            config.afterClickDelay = mapStore.map.delayGlobal;
+          }
+          afterClickDelayResolved = true;
+        } catch (error) {
+          // ignore - use default config value
+        }
+      }
+      
       return mapStorePromise;
     }
   };
@@ -692,7 +707,8 @@ function buildCursorConfig(options) {
     sequenceDoubleClick:
       parseBooleanValue(raw.sequenceDoubleClick) === true,
     defaultClosePoint: parsePoint(raw.defaultClosePoint) || { x: 1888, y: 16 },
-    skipAdsPoint: parsePoint(raw.skipAdsPoint) || { x: 808, y: 569 }
+    skipAdsPoint: parsePoint(raw.skipAdsPoint) || { x: 808, y: 569 },
+    afterClickDelay: parseIntegerOption(raw.afterClickDelay, 200, 0)
   };
 }
 
@@ -1748,6 +1764,7 @@ function buildFallbackMap(config) {
 
   return {
     version: 1,
+    delayGlobal: config.afterClickDelay || 200,
     apps
   };
 }
@@ -1755,7 +1772,8 @@ function buildFallbackMap(config) {
 function normalizeMapObject(rawMap) {
   const result = {
     version: 1,
-    apps: {}
+    apps: {},
+    delayGlobal: undefined
   };
 
   if (!rawMap || typeof rawMap !== 'object') {
@@ -1766,6 +1784,11 @@ function normalizeMapObject(rawMap) {
     result.version = Number(rawMap.version);
   }
 
+  // Ler delayGlobal do map.json (valor global em milissegundos)
+  if (Number.isFinite(rawMap.delayGlobal) && rawMap.delayGlobal >= 0) {
+    result.delayGlobal = Math.floor(rawMap.delayGlobal);
+  }
+
   const rawApps =
     rawMap.apps !== undefined
       ? rawMap.apps
@@ -1799,6 +1822,9 @@ function mergeMaps(baseMap, overrideMap) {
       overrideMap && Number.isFinite(overrideMap.version)
         ? overrideMap.version
         : baseMap.version,
+    delayGlobal: overrideMap && Number.isFinite(overrideMap.delayGlobal)
+      ? overrideMap.delayGlobal
+      : baseMap.delayGlobal,
     apps: {}
   };
 
@@ -1954,6 +1980,12 @@ function clickCurrentPosition(robot, doubleClick) {
 async function clickPoint(robot, point, config, clickOptions = {}) {
   await smoothMove(robot, point.x, point.y, config.moveSteps, config.moveDelay);
   clickCurrentPosition(robot, clickOptions.doubleClick === true);
+  
+  // Apply after-click delay to ensure click is registered before next action
+  const afterClickDelay = config.afterClickDelay || 0;
+  if (afterClickDelay > 0) {
+    await sleep(afterClickDelay);
+  }
 }
 
 async function runConfiguredPath(robot, pathConfig, config) {

package/docPTBR.md

@@ -382,6 +382,7 @@ await executarCursor({
   scrollSteps: 10,
   scrollDelay: 20,
   typeDelay: 50,
+  afterClickDelay: 200,         // delay global apos cada clique (ms)
   sequenceInterval: 250,        // intervalo padrao do mover_sequencia
   sequenceClick: 'none',        // none|between|each|first|last
   sequenceDoubleClick: false,   // clique duplo por padrao
@@ -389,6 +390,31 @@ await executarCursor({
 }
 ```
 
+## Configuracao global no map.json
+
+Voce pode definir valores globais na raiz do `map.json`:
+
+```json
+{
+  "version": 1,
+  "delayGlobal": 300,
+  "apps": {
+    "spotify": { ... }
+  }
+}
+```
+
+### `delayGlobal`
+
+- **Tipo**: inteiro (milissegundos)
+- **Padrao**: 200
+- **Descricao**: Delay global apos cada clique. Garante que o sistema operacional registre o clique antes da proxima acao (como digitacao). Aplicado a todas as operacoes de clique.
+
+Isso e util quando:
+- Digitacao nao funciona apos clicar em um campo de input
+- Cliques precisam de tempo para registrar antes de operacoes subsequentes
+- Diferentes aplicativos precisam de diferentes tempos de resposta
+
 ## map.json (doc dedicada)
 
 Voce pediu uma doc dedicada para o mapeador. Ela esta aqui:

package/map.md

@@ -85,6 +85,31 @@ Even with minimal setup, the generated default map includes:
 }
 ```
 
+## Global configuration (map.json root)
+
+You can also set global values at the root level of `map.json`:
+
+```json
+{
+  "version": 1,
+  "delayGlobal": 300,
+  "apps": {
+    "spotify": { ... }
+  }
+}
+```
+
+### `delayGlobal`
+
+- **Type**: integer (milliseconds)
+- **Default**: 200
+- **Description**: Global delay after each click. This ensures the operating system registers the click before the next action (like typing) begins. Applied to all click operations.
+
+This is useful when:
+- Typing doesn't work after clicking an input field
+- Click actions need time to register before subsequent operations
+- Different applications need different response times
+
 ## App fields
 
 - `state`: `open`, `closed`, `aberto`, or `fechado`

package/mapPTBR.md

@@ -93,6 +93,31 @@ Mesmo no arquivo minimo, o gerador padrao sempre inclui:
 - `buttons`: mapa de botoes do app
 - `caminho` dentro de `launcher` (opcional): rota de pontos antes do clique final no app
 
+## Configuracao global (raiz do map.json)
+
+Voce tambem pode definir valores globais na raiz do `map.json`:
+
+```json
+{
+  "version": 1,
+  "delayGlobal": 300,
+  "apps": {
+    "spotify": { ... }
+  }
+}
+```
+
+### `delayGlobal`
+
+- **Tipo**: inteiro (milissegundos)
+- **Padrao**: 200
+- **Descricao**: Delay global apos cada clique. Garante que o sistema operacional registre o clique antes da proxima acao (como digitacao). Aplicado a todas as operacoes de clique.
+
+Isso e util quando:
+- Digitacao nao funciona apos clicar em um campo de input
+- Cliques precisam de tempo para registrar antes de operacoes subsequentes
+- Diferentes aplicativos precisam de diferentes tempos de resposta
+
 ## Campos de botao
 
 Formato simples:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "command-cmd",
-  "version": "1.0.12",
+  "version": "1.0.15",
   "main": "cmd.js",
   "type": "module",
   "scripts": {