LYTOK Engine

Este documento detalla la arquitectura técnica interna del motor LYTOK. El núcleo funciona como un procesador de flujos de datos optimizado para tres rutas de ejecución según la necesidad de rendimiento y manipulación de la memoria.

🏗 Arquitectura de Procesamiento

El motor opera bajo tres circuitos lógicos que gestionan la transformación de datos entre objetos nativos, texto .ltk y el formato binario final.

1. Zero-Copy Native Path

Es la ruta de máximo rendimiento. Realiza una serialización "Single-Pass" directamente desde la memoria nativa hacia un buffer binario, eliminando representaciones de texto intermedias.

graph LR
A[Object Memory] --> B[Binary Stream]
B --> C[Object Memory]
style A fill:#6b7280,color:#fff
style B fill:#2563eb,stroke:#fff,color:#fff
style C fill:#6b7280,color:#fff

• Tecnicismo: No hay formateo de números a strings. Se escriben los bytes crudos.

• Seguridad: Implementa un sistema de ofuscación por etiquetas binarias.

2. Streaming Transcoder Path

Diseñado para transformar archivos .ltk a binario sin cargar estructuras pesadas en memoria.

graph LR
A[Object] --> B[.ltk String]
B --> C[Binary Buffer]
C --> D[Object Memory]
style A fill:#6b7280,color:#fff
style C fill:#22d3ee,stroke:#fff,color:#000
style D fill:#6b7280,color:#fff

• Tecnicismo: No construye un árbol de objetos (AST). Valida la sintaxis al vuelo y escribe en el buffer binario conforme avanza el cursor.

• Optimización: Reduce el overhead de asignación en memoria en un ~70%.

🔄 Flujos de Datos Detallados

A continuación se detalla la lógica de bajo nivel para las dos operaciones fundamentales del motor.

Detalle del Stringify (Data → Binary/.ltk)

La serialización nativa recorre la estructura del objeto y escribe los bytes correspondientes según el tipo detectado.

sequenceDiagram
    participant Data
    participant Core as LYTOK Engine
    participant Vec as Output Vector (u8)

    Note over Data, Core: Selección de formato de salida
    Data->>Core: Data a valores mapeados
    alt formato binario
        Note over Core: Generación única del header binario
        Core ->> Vec: Push binary header con ID
        loop Por cada campo
            Core->>Vec: Vincula el campo al ID y push
        end
    else formato LTK
        Note over Core: Generación del header posicional string
        loop Por cada campo
            Core->>Vec: Posiciona los valores en su lugar
        end
    end

    Vec-->>Core: Retorno de la data en vector
    Note over Core: Generación del resultado final (Buffer o LTK)
    Core-->>Data: Retorno del resultado

Detalle del Parser (Binary/.ltk → Data)

El parser consume el flujo de texto/binario y lo proyecta directamente a la memoria del buffer binario.

sequenceDiagram
    participant Input as Input (Binario, .ltk)
    participant Core as LYTOK Engine
    participant Bin as Binary Buffer (u8)
    participant Output

    Input->>Core: Lectura de entrada
    alt formato binario
        Note over Core: Binario -> Buffer
        Core ->> Bin: Cruce directo al buffer
    else formato .ltk
        Note over Core: .ltk -> Buffer
        Core ->> Bin: Lectura e interpretación del Header
        Note over Core: Lectura de data recibida
        alt Primitivo (Little Endian)
            Core ->> Bin: Escribe valores RAW
        else Complejo (Map/Array)
            Core ->> Bin: Creación y escritura de complejo
            Note over Core,Bin: Complejo terminado, retorno a nivel superior
            Core ->> Core: Recursión de rama
        end
    end

    Bin ->> Output: Salida de data en valores nativos

🛠 Especificaciones de Salida

• Endianness: Escritura exclusiva en Little Endian para tipos numéricos (Int, Float, BigInt).

• UTF-8 Integrity: Validación estricta de strings sin transformaciones de escape destructivas.

• Memory Safety: Gestión de buffers mediante Vec con capacidad.

🔧 Targets de Compilación

El núcleo se compila para entornos específicos:

1. NAPI-RS: Binario nativo para Node.js con acceso directo a la memoria de C++.

2. WASM-Pack: Módulos WebAssembly para ejecución en navegadores y entornos Edge.

⚖️ Licencia y Términos de Uso

Este motor se distribuye bajo una licencia propietaria:

Cualquier uso del código fuente debe incluir los avisos de copyright correspondientes.

Términos de Uso (Private Preview)

Durante la fase de desarrollo privado, el uso de este motor está sujeto a las siguientes condiciones:

1. Propiedad: El código fuente y los binarios compilados son propiedad exclusiva de joguel96.
2. Restricción de Ingeniería Inversa: No se permite la descompilación o ingeniería inversa de los artefactos binarios (.node, .wasm) sin autorización expresa.
3. Límites de Procesamiento: El motor se libera con una capacidad de procesamiento de 250MB por instancia.
4. Actualizaciones Futuras: Al implementar el sistema Pro, los límites de las instancias gratuitas serán actualizados y reducidos según el modelo de suscripción.
5. Uso en Producción: Estado Beta. El autor no se hace responsable de pérdida de datos o fallos técnicos derivados de su uso en entornos críticos.

🔗 Referencias

Consulte el repositorio oficial de la especificación:

- lytok-spec

Copyright (c) 2026 joguel96. LYTOK Engine: Eficiencia bruta a nivel de bit. All Rights Reserved.