DictionaryAxeManager (DAM)

DictionaryAxeManager (DAM) es una librería y CLI para trabajar con modelos de diccionario (por idioma) y ofrecer una API de consulta lista para integrarse en:

• Terminal (CLI)
• Apps Node.js (scripts / backends)
• Web (browser)
• Futuras integraciones (widgets/desktop)

Repo: https://github.com/JLDiaz23/dictionaryAxeManager

Documentación interna (más detallada): docs/00-indice.md

DAM está pensado para mantener una API pública estable y separar claramente:

• Dataset (models/<lang>.json)
• Capa de acceso a datos (DB)
• Lógica de análisis
• API core
• Módulo semántico (sin UI)
• Helpers opcionales para browser

Instalación

En este repo (modo desarrollo):

npm install
npm test

Como librería (npm):

npm install dictionary-axe-manager

Quickstart

1) Probar DAM desde la terminal (CLI público)

Si instalas el paquete desde npm, el comando público es dam-dict.

Puedes:

• Importar/cargar un modelo
• Buscar palabras (lookup)
• Sacar rimas
• Ver estadísticas del modelo

Para ver los comandos y opciones disponibles:

npx dam-dict --help

2) Integrar DAM en tu proyecto (librería)

Si estás construyendo una app, backend o scripts, DAM se usa como dependencia y se integra mediante imports.

DAM expone un entrypoint minimalista y subpaths para distintos targets (core/semantic/browser).

CLI

CLI público (npm)

Comandos soportados por dam-dict:

npx dam-dict import <lang> <ruta-datos>
npx dam-dict lookup <lang> <word>
npx dam-dict rhyme <lang> <word> [opciones]
npx dam-dict stats <lang>
npx dam-dict sanitize <lang> [opciones]
npx dam-dict progress <lang> [opciones]
npx dam-dict semantic <subcmd> <lang> [args]

Scripts del repo (modo desarrollo)

En este repo, DAM incluye scripts npm run ... para operar el modelo y probar features. Algunos son atajos para el CLI público y otros son utilidades internas de desarrollo.

Para ver todos los scripts disponibles y sus opciones:

npm run help

Uso como librería (Node / ESM)

DAM expone un entrypoint minimalista y subpaths para distintos targets.

Imports públicos

• dictionary-axe-manager (entrypoint minimalista)
• dictionary-axe-manager/core (API core, exporta default)
• dictionary-axe-manager/semantic (API semántica)
• dictionary-axe-manager/browser (helpers para UI mínima)

Ejemplo: lookup + análisis

import { dictionaryAxeManager } from 'dictionary-axe-manager';

const result = dictionaryAxeManager.searchWord('reciproco', { lang: 'es' });
console.log(result.entry);
console.log(result.analysis);

Semántica (sin UI)

El subpath semántico está diseñado para sugerencias y exploración tipo “thesaurus” sobre el modelo:

import { searchSemantic } from 'dictionary-axe-manager/semantic';

const out = searchSemantic('mutuo', { lang: 'es' });
console.log(out);

Browser / UI (opcional)

Si necesitas un widget mínimo para web, puedes usar el helper:

import dictionaryAxeManager from 'dictionary-axe-manager/browser';

dictionaryAxeManager.attachSimpleDictionaryUI({
  inputId: 'search-input',
  resultsAreaId: 'results-area',
  titleId: 'result-title',
  contentId: 'result-content',
});

Validación de datos (conjuntos cerrados)

DAM mantiene listas autoritativas para valores cerrados como category, register, region e language.

• Para verlas: revisa dictionaryConstants.js o importa desde dictionary-axe-manager/core.
• La CLI (import/sanitize) aplica sanitización y defaults de forma segura.

Licencia

MIT