codexivo 0.2.0 → 1.0.0

package/CHANGELOG.md

@@ -1,11 +1,47 @@
 # Historial de cambios
 
+## 1.0.0
+
+Primera versión completa del lenguaje según la [especificación v1](./docs/especificacion-v1.md) (#24). Todo lo que funciona
+está en [`docs/lenguaje.md`](./docs/lenguaje.md).
+
+### Lenguaje
+
+- **Nivel principiante** (#25, #43): `para i desde a hasta b con_paso p`, `repetir n veces`, `constante`, `div`, `mod`
+  (`%`), `^`, `%=`, `i++`/`i--` como sentencias, comparaciones en palabras (`es_igual_a`, `es_menor_que`…), `1_000_000`
+  y `PI`.
+- **Nivel intermedio** (#26, #27): procedimientos con nombre (se pueden usar antes de declararse), `para_cada`, `romper`,
+  `continuar`, asignación por índice (`lista[i] = …`), diccionarios con `d["clave"]` y `d.campo`, y
+  `para_cada clave, valor en d`.
+- **Dominios** (#19): `dominio nombre { … }` agrupa declaraciones en un espacio de nombres que se usa con `.`.
+- **Biblioteca** (#28, #29): texto, listas, diccionarios, matemáticas con `aleatorio` de semilla fija, `afirmar`,
+  `mapear`/`filtrar`/`reducir`/`alguno`/`todos`/`buscar`, `ordenar` con comparador estable, pilas y colas.
+- **Modo mundo** (#30): el robot de Karel, con mundos en JSON, eventos `robot` y objetivos de reto (`checkGoal`).
+
+### Para el sitio
+
+- Costo por operación de la biblioteca en una sola tabla (`n`, `n · ⌈log₂ n⌉`) (#29).
+- `catalog`: palabras reservadas, operadores, biblioteca con ejemplos ejecutables y códigos de error como datos (#31).
+- `flowGraph`: diagrama de flujo generado desde el AST, con los `nodeId` de los eventos (#32).
+- `codexivo/worker`, `createSandbox` y `evaluarReto`: ejecución en Web Worker por tandas, retroceso por re-ejecución y
+  retos estilo HackerRank y LeetCode (#33).
+
+### Cambios que rompen compatibilidad
+
+- Palabras reservadas nuevas: `constante`, `dominio`, `repetir`, `veces`, `desde`, `hasta`, `con_paso`, `para_cada`,
+  `en`, `romper`, `continuar`, `mod`, `div` y las comparaciones en palabras ya no sirven como nombres.
+- Sin `;`, el salto de línea termina la expresión: una línea que empieza con `-`, `(` o `[` ya no continúa la anterior,
+  y una expresión partida antes de un operador es un error.
+- `Snapshot.heap` acepta también diccionarios (`{ entries }`) y dominios (`{ domain, members }`).
+- `ordenar` deja de ser un nativo (`natives.ordenar`) y pasa a la biblioteca escrita en Codexivo.
+- Las llamadas a la biblioteca cobran su costo en operaciones, así que la cuenta de operaciones de los programas cambia.
+
 ## 0.2.0
 
 - Núcleo reescrito como lexer, parser, compilador y máquina reanudable (#23).
 - Ejecución paso a paso, eventos, snapshots, límites deterministas y entrada interactiva.
 - API de biblioteca para navegador y Bun, con tipos publicados como fuentes TypeScript.
-- Comando `codexivo` instalable desde npm, que ejecuta el binario nativo del sistema sin depender de Node.js ni Bun durante la ejecución.
+- Comando `codexivo` instalable desde npm como `@codexivo/cli`, separado de la biblioteca web `codexivo`, que ejecuta el binario nativo del sistema sin depender de Node.js ni Bun durante la ejecución.
 - Ejecutables autónomos para Linux (glibc y musl), macOS y Windows, en x64 y ARM64.
 - Publicación desde tags `v*` mediante GitHub Actions, con OIDC, provenance y artefactos en GitHub Releases.
 - Formato integrado con `bun fmt` y configuración en `bunfig.toml`.

package/README.md

@@ -16,24 +16,24 @@ Inspirado por esta idea, me embarqué en este proyecto con la determinación de
 
 ```codexivo
 // La suma de los números del 1 al 10
-variable suma = 0;
-para (variable i = 1; i <= 10; i += 1) {
-  suma += i;
+variable suma = 0
+para i desde 1 hasta 10 {
+  suma = suma + i
 }
-imprimir("La suma es", suma);
+imprimir("La suma es", suma)
 ```
 
 ```codexivo
-variable clasificar = procedimiento(edad) {
-  si (edad >= 18) {
-    regresa "adulto";
-  } pero_si (edad >= 13) {
-    regresa "adolescente";
+procedimiento clasificar(edad) {
+  si (edad es_mayor_o_igual_a 18) {
+    regresa "adulto"
+  } pero_si (edad es_mayor_o_igual_a 13) {
+    regresa "adolescente"
   } si_no {
-    regresa "niño";
+    regresa "niño"
   }
-};
-imprimir(clasificar(16));
+}
+imprimir(clasificar(16))
 ```
 
 Lo que funciona hoy está en [`docs/lenguaje.md`](./docs/lenguaje.md), y todos sus ejemplos se ejecutan tal cual. Hacia dónde va
@@ -63,22 +63,24 @@ console.log(resultado.output); // "Hola desde Codexivo\n"
 ```
 
 El paquete incluye un bundle ESM compatible con navegador y los tipos como fuentes TypeScript. Importar la biblioteca no
-inicia el REPL ni necesita Bun. El principal declara `bin` y las variantes nativas en `optionalDependencies`; cada variante
+inicia el REPL, no necesita Bun y no instala binarios ni ejecuta scripts de instalación.
+
+El CLI se instala por separado como `@codexivo/cli`. Este paquete declara `bin` y las variantes nativas en `optionalDependencies`; cada variante
 incluye los campos `os`, `cpu` y, en Linux, `libc`. El gestor instala la variante compatible y `postinstall` verifica su versión
-y enlaza o copia el ejecutable a `bin/codexivo.exe` del principal. El nombre interno también funciona en Linux y macOS.
+y enlaza o copia el ejecutable a `bin/codexivo.exe` del CLI. El nombre interno también funciona en Linux y macOS.
 
 ```sh
-npm install --global codexivo@0.2.0
+npm install --global @codexivo/cli@0.2.0
 codexivo                         # REPL
 codexivo programa.cdx            # ejecutar un archivo
 ```
 
-Con Bun, usa `bun add --global --trust codexivo@0.2.0` para permitir el script de instalación. Node se usa únicamente durante
+Con Bun, usa `bun add --global --trust @codexivo/cli@0.2.0` para permitir el script de instalación. Node se usa únicamente durante
 la instalación con npm; el comando resultante es el ejecutable nativo y funciona sin Node.js ni Bun en el `PATH`.
 
-Si bloqueas scripts, puedes usar la biblioteca normalmente. Para preparar el comando tras una instalación local, ejecuta
-`node node_modules/codexivo/postinstall.mjs` una vez. El instalador toma el paquete opcional ya instalado por el gestor y exige
-que su versión coincida con la del principal; no descarga ni compila binarios.
+Si bloqueas scripts al instalar el CLI, para preparar el comando tras una instalación local ejecuta
+`node node_modules/@codexivo/cli/postinstall.mjs` una vez. El instalador toma el paquete opcional ya instalado por el gestor y exige
+que su versión coincida con la del CLI; no descarga ni compila binarios.
 
 Las variantes publicadas son:
 
@@ -126,8 +128,7 @@ dispara otra publicación. El workflow toma el estado más reciente de `main`, p
 Desde **Actions → Publicar → Run workflow**, en `main`, se puede elegir `patch`, `minor` o `major` para una publicación manual.
 
 También se admiten tags `v*` creados manualmente: deben coincidir con `package.json` y no incrementan la versión otra vez.
-Todas las compilaciones usan el SHA del commit de la versión. Los paquetes nativos se publican antes que el paquete
-principal y sus versiones se sincronizan con `bun pm version`. El principal declara `bin` y su `postinstall` coloca allí el ejecutable del paquete nativo compatible. Las versiones preliminares se publican con el dist-tag `next`;
+Todas las compilaciones usan el SHA del commit de la versión. Los paquetes nativos se publican primero, después `@codexivo/cli` y finalmente `codexivo`. Las diez versiones se sincronizan con `bun pm version`. Solo el CLI declara `bin` y su `postinstall` coloca allí el ejecutable del paquete nativo compatible. Las versiones preliminares se publican con el dist-tag `next`;
 las estables, con `latest`. Los ejecutables y sus sumas SHA-256 se adjuntan a la release. Los binarios no están firmados ni
 notarizados.
 
@@ -136,10 +137,10 @@ notarizados.
 - [x] Lexer, parser y máquina con posiciones exactas, errores con pistas y límites deterministas
 - [x] Ejecución paso a paso, eventos y fotografías del estado para visualización
 - [x] `imprimir`, `leer`, `leer_número`, comentarios, `nulo`
-- [ ] Nivel principiante de la v1: `repetir … veces`, `++`/`--`, `mod`/`div`, operadores en palabras, `constante`
-- [ ] Nivel intermedio: procedimientos con nombre, `para_cada`, `romper`/`continuar`, diccionarios, más biblioteca
-- [ ] Nivel avanzado: procedimientos como valores en la biblioteca, pilas y colas
-- [ ] Modo mundo (Karel)
+- [x] Nivel principiante de la v1: `repetir … veces`, `++`/`--`, `mod`/`div`, operadores en palabras, `constante`
+- [x] Nivel intermedio: procedimientos con nombre, `para_cada`, `romper`/`continuar`, diccionarios, más biblioteca
+- [x] Nivel avanzado: procedimientos como valores en la biblioteca, pilas y colas
+- [x] Modo mundo (Karel)
 - [ ] Sitio con documentación y sandbox: `codexivo.urielcuriel.dev`
 
 ## Cómo contribuir