command-cmd 1.0.7 → 1.0.11

package/cmd.js

@@ -587,6 +587,67 @@ export async function cursor(input, options = {}) {
   };
 }
 
+export async function cursorSequential(input, intervalMs = 3000, options = {}) {
+  const commands = normalizeCursorInput(input);
+  const parsedInterval = toNonNegativeInteger(intervalMs);
+
+  if (parsedInterval === null) {
+    throw new Error('cursor_sequential_requires_non_negative_interval_ms');
+  }
+
+  if (commands.length === 0) {
+    return {
+      executed: [],
+      skipped: [{ reason: 'no_commands' }],
+      totalCommands: 0,
+      totalExecutions: 0,
+      intervalMs: parsedInterval
+    };
+  }
+
+  if (commands.length === 1) {
+    const singleResult = await cursor(commands[0], options);
+    return {
+      ...singleResult,
+      intervalMs: parsedInterval
+    };
+  }
+
+  const executed = [];
+  const skipped = [];
+
+  for (let commandIndex = 0; commandIndex < commands.length; commandIndex++) {
+    const command = commands[commandIndex];
+    const result = await cursor(command, options);
+
+    for (const entry of result.executed) {
+      executed.push({
+        ...entry,
+        commandIndex
+      });
+    }
+
+    for (const entry of result.skipped) {
+      skipped.push({
+        ...entry,
+        commandIndex
+      });
+    }
+
+    if (commandIndex < commands.length - 1 && parsedInterval > 0) {
+      await sleep(parsedInterval);
+    }
+  }
+
+  return {
+    executed,
+    skipped,
+    totalCommands: commands.length,
+    totalExecutions: executed.length,
+    intervalMs: parsedInterval
+  };
+}
+
 function createCursorRuntime(options) {
   const config = buildCursorConfig(options);
   let mapStorePromise;

package/doc.md

@@ -7,6 +7,7 @@ Exported functions:
 - `cmd`
 - `extractFirstCommand`
 - `cursor`
+- `cursorSequential`
 - `initMap`
 - `initDoc`
 - `maper`
@@ -20,7 +21,15 @@ npm install command-cmd
 ## Import
 
 ```js
-import { cmd, extractFirstCommand, cursor, initMap, initDoc, maper } from 'command-cmd';
+import {
+  cmd,
+  extractFirstCommand,
+  cursor,
+  cursorSequential,
+  initMap,
+  initDoc,
+  maper
+} from 'command-cmd';
 ```
 
 ## 1) `cmd(message)`
@@ -111,7 +120,24 @@ Accepted object keys:
 - `seq` or `sequencia`
 - `extra`
 
-## 4) `initMap(options?)`
+## 4) `cursorSequential(input, intervalMs = 3000, options?)`
+
+Runs commands sequentially with a fixed delay between each command block.
+
+- uses the same input format as `cursor`
+- if input has 2+ commands, it executes them in written order
+- default interval is `3000` ms (3 seconds)
+
+Example:
+
+```js
+await cursorSequential(
+  '[open_app, command: chrome][close_app, command: chrome]',
+  3000
+);
+```
+
+## 5) `initMap(options?)`
 
 Creates (or loads/merges) `map.json` explicitly.
 
@@ -132,7 +158,7 @@ Optional keys:
 - `skipAdsPoint`
 - `persistMerged` (writes merged defaults even when map already exists)
 
-## 5) `initDoc(options?)`
+## 6) `initDoc(options?)`
 
 Creates documentation files from package templates.
 
@@ -157,7 +183,7 @@ Optional keys:
 - `includeMapDocs`
 - `files` (e.g. `['doc', 'docPTBR', 'map', 'mapPTBR']`)
 
-## 6) `maper(enabled)`
+## 7) `maper(enabled)`
 
 Turns terminal mouse position mapping on/off.
 

package/docPTBR.md

@@ -7,6 +7,7 @@ Funcoes exportadas:
 - `cmd`
 - `extractFirstCommand`
 - `cursor`
+- `cursorSequential`
 - `initMap`
 - `initDoc`
 - `maper`
@@ -24,6 +25,7 @@ import {
   cmd as extrairComandos,
   extractFirstCommand as extrairPrimeiroComando,
   cursor as executarCursor,
+  cursorSequential as executarCursorSequencial,
   initMap as iniciarMap,
   initDoc as iniciarDoc,
   maper
@@ -118,7 +120,24 @@ Campos aceitos no objeto:
 - `seq` ou `sequencia`
 - `extra`
 
-## 4) `initMap(options?)`
+## 4) `cursorSequential(input, intervalMs = 3000, options?)`
+
+Executa comandos de forma sequencial com intervalo fixo entre cada bloco de comando.
+
+- usa o mesmo formato de entrada do `cursor`
+- se a string tiver 2+ comandos, executa na ordem em que foram escritos
+- intervalo padrao de `3000` ms (3 segundos)
+
+Exemplo:
+
+```js
+await executarCursorSequencial(
+  '[abrir_app, comando: chrome][fechar_app, comando: chrome]',
+  3000
+);
+```
+
+## 5) `initMap(options?)`
 
 Cria (ou carrega/mescla) o `map.json` de forma explicita.
 
@@ -139,7 +158,7 @@ Campos opcionais:
 - `skipAdsPoint`
 - `persistMerged` (salva defaults mesclados mesmo se o map ja existir)
 
-## 5) `initDoc(options?)`
+## 6) `initDoc(options?)`
 
 Cria os arquivos de documentacao usando os templates do pacote.
 
@@ -164,7 +183,7 @@ Campos opcionais:
 - `includeMapDocs`
 - `files` (ex.: `['doc', 'docPTBR', 'map', 'mapPTBR']`)
 
-## 6) `maper(enabled)`
+## 7) `maper(enabled)`
 
 Liga/desliga o mapeador de posicao do mouse no terminal.
 

package/package.json

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