command-cmd 1.0.6 → 1.0.10

package/cmd.js

@@ -35,6 +35,12 @@ const DOC_TEMPLATE_MAP = Object.freeze({
     target: 'docPTBR.md',
     isMapDoc: false
   }),
+  doc_html: Object.freeze({
+    key: 'doc_html',
+    source: 'doc.html',
+    target: 'doc.html',
+    isMapDoc: false
+  }),
   map_en: Object.freeze({
     key: 'map_en',
     source: 'map.md',
@@ -50,6 +56,7 @@ const DOC_TEMPLATE_MAP = Object.freeze({
 });
 
 const DOC_TEMPLATES = Object.freeze(Object.values(DOC_TEMPLATE_MAP));
+const DOC_HTML_MARKDOWN_PLACEHOLDER = '__DOC_MARKDOWN_BUNDLE__';
 
 const ACTION_ALIASES = Object.freeze({
   skip_ads: 'skip_ads',
@@ -370,10 +377,6 @@ export async function maper(enabled) {
   pollPosition();
   maperInterval = setInterval(pollPosition, MAPER_POLL_INTERVAL);
 
-  if (typeof maperInterval.unref === 'function') {
-    maperInterval.unref();
-  }
-
   return { active: true, pollInterval: MAPER_POLL_INTERVAL };
 }
 
@@ -429,15 +432,7 @@ export async function initDoc(options = {}) {
       continue;
     }
 
-    let content;
-    try {
-      content = await readFile(sourcePath, 'utf8');
-    } catch (error) {
-      if (error && error.code === 'ENOENT') {
-        throw new Error(`doc_template_not_found:${template.source}`);
-      }
-      throw error;
-    }
+    const content = await loadDocTemplateContent(template, sourcePath);
 
     await writeFile(targetPath, content, 'utf8');
 
@@ -457,6 +452,59 @@ export async function initDoc(options = {}) {
   };
 }
 
+async function loadDocTemplateContent(template, sourcePath) {
+  let content;
+  try {
+    content = await readFile(sourcePath, 'utf8');
+  } catch (error) {
+    if (error && error.code === 'ENOENT') {
+      throw new Error(`doc_template_not_found:${template.source}`);
+    }
+    throw error;
+  }
+
+  if (template.key !== DOC_TEMPLATE_MAP.doc_html.key) {
+    return content;
+  }
+
+  const markdownBundle = await loadDocMarkdownBundle();
+  const serialized = JSON.stringify(markdownBundle)
+    .replace(/</g, '\\u003c')
+    .replace(/>/g, '\\u003e')
+    .replace(/&/g, '\\u0026');
+
+  if (content.includes(DOC_HTML_MARKDOWN_PLACEHOLDER)) {
+    return content.replace(DOC_HTML_MARKDOWN_PLACEHOLDER, serialized);
+  }
+
+  return content;
+}
+
+async function loadDocMarkdownBundle() {
+  const templates = [
+    DOC_TEMPLATE_MAP.doc_en,
+    DOC_TEMPLATE_MAP.doc_ptbr,
+    DOC_TEMPLATE_MAP.map_en,
+    DOC_TEMPLATE_MAP.map_ptbr
+  ];
+
+  const bundle = {};
+
+  for (const template of templates) {
+    const sourcePath = resolvePath(MODULE_DIR, template.source);
+    try {
+      bundle[template.key] = await readFile(sourcePath, 'utf8');
+    } catch (error) {
+      if (error && error.code === 'ENOENT') {
+        throw new Error(`doc_template_not_found:${template.source}`);
+      }
+      throw error;
+    }
+  }
+
+  return bundle;
+}
+
 export async function cursor(input, options = {}) {
   const commands = normalizeCursorInput(input);
   if (commands.length === 0) {
@@ -591,6 +639,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;
@@ -1482,6 +1591,17 @@ function resolveDocTemplateByName(value) {
     return DOC_TEMPLATE_MAP.doc_ptbr;
   }
 
+  if (
+    token === 'doc_html' ||
+    token === 'dochtml' ||
+    token === 'html' ||
+    token === 'docs_html' ||
+    token === 'documentation_html' ||
+    token === 'documentacao_html'
+  ) {
+    return DOC_TEMPLATE_MAP.doc_html;
+  }
+
   if (
     token === 'map' ||
     token === 'map_en' ||

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.
 
@@ -140,6 +166,7 @@ By default it writes in current working directory:
 
 - `doc.md`
 - `docPTBR.md`
+- `doc.html`
 - `map.md`
 - `mapPTBR.md`
 
@@ -155,9 +182,9 @@ Optional keys:
 - `outputDir` (alias: `dir`, `path`)
 - `overwrite`
 - `includeMapDocs`
-- `files` (e.g. `['doc', 'docPTBR', 'map', 'mapPTBR']`)
+- `files` (e.g. `['doc', 'docPTBR', 'docHtml', '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.
 
@@ -147,6 +166,7 @@ Por padrao, escreve no diretório atual:
 
 - `doc.md`
 - `docPTBR.md`
+- `doc.html`
 - `map.md`
 - `mapPTBR.md`
 
@@ -162,9 +182,9 @@ Campos opcionais:
 - `outputDir` (alias: `dir`, `path`)
 - `overwrite`
 - `includeMapDocs`
-- `files` (ex.: `['doc', 'docPTBR', 'map', 'mapPTBR']`)
+- `files` (ex.: `['doc', 'docPTBR', 'docHtml', '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.6",
+  "version": "1.0.10",
   "main": "cmd.js",
   "type": "module",
   "scripts": {