PARALLEL ENERGETIC RUNTIME · v0.1.1

Keep the web.
Give it a Universe.

Quetzalcoatl Core creates a demand-driven energetic Universe alongside the DOM. The DOM remains the semantic plane, Rust/WASM resolves energy and relationships, and WebGL2 materializes the response through the GPU.

Not preset animations.
Not a permanent render loop.
The world changes. The runtime responds.

Experience the rocio Effect$npm install quetzalcoatl-core
v0.1.1 · OPEN SOURCE · APACHE 2.0DOM · RUST / WASM · CRYSTAL · WEBGL2
WHY QUETZALCOATL CORE

Keep the DOM.
Give it a parallel Universe.

THE PROBLEM

The semantic plane. Content, structure, accessibility, native behavior and geometric reference remain in the web you already have, coordinated through the browser’s CPU-driven layout and painting pipeline.

As interfaces become more spatial, continuous, and computationally dynamic, that pipeline becomes a constraint. Not on what we can show — but on how visual behavior can evolve.

A DIFFERENT MODEL

Two planes.
One web.

DOM

The semantic plane. Content, structure, accessibility, native behavior and geometric reference remain in the web you already have, coordinated through the browser’s CPU-driven layout and painting pipeline.

UNIVERSE

A parallel runtime space where participating elements gain identity, relationships, energy and dynamic state, with visual response materialized through the GPU.

THE SHIFT

The DOM defines the plane.
The Universe defines the space.

THE CORE

Change enters.
The Universe responds.

Quetzalcoatl Core maintains a parallel runtime beside the DOM. Participating elements become Nahuales, interactions perturb the Universe through Rays, Rust/WASM resolves energy and relationships, and Crystal materializes the resulting visual response through WebGL2 on the GPU.

CHANGEInteraction · DOM · Geometry · State
RAY
RAYAn interaction signal that perturbs the Universe.

A Ray carries change into the runtime with an origin, direction and intensity.

NAHUALThe runtime counterpart of a participating element.

A Nahual gives a participating DOM element identity, energy, state, hierarchy and relationships inside the Universe.

A
SEMANTIC PLANE

DOM

HTMLCSSSemanticsNative behaviorGeometry

The DOM remains the source of semantics, native behavior and geometric truth. QC extends the web without replacing it.

B
PARALLEL RUNTIME

Universe

NahualesParticipationEnergyRelationshipsHierarchy

The Universe maintains the runtime identity, energy, hierarchy and relationships of participating elements.

C
STATE RESOLUTION

Rust / WASM

EnergyCouplingResonanceMotionEquilibrium

Rust/WASM evolves the Universe, resolving energy, relationships and motion until the active state approaches equilibrium.

D
MATERIALIZATION

Crystal

ProjectionSurfacesDisplacementGPU

Crystal projects resolved runtime state into visible GPU materialization through WebGL2 alongside the native DOM.

Explore the Architecture Spec
CORE PRINCIPLE

The DOM defines the plane.
The Universe defines the space.
Participating elements become Nahuales.
Rays introduce change.
Rust/WASM resolves the response.
Crystal materializes it through the GPU.

DEMAND-DRIVEN RUNTIME

Quiet by default.
Active on demand.

Change wakes the runtime. Quetzalcoatl Core evolves while active energy or pending change remains, resolves the response, updates its visual manifestation, and returns to a quiet state once equilibrium is reached.

RUNTIME ACTIVITYQUIET → ACTIVE → QUIET
ACTIVE
01QUIETNo active frame processing
02CHANGEInput or state changes
03WAKERuntime activates
04EVOLVEUniverse state resolves
05MATERIALIZEGPU output updates
06EQUILIBRIUMReturn to quiet
QUIET UNIVERSENo permanent render loop.
THE ROCIO EFFECT

Disturb the Universe.
Watch it respond.

This is not a preset animation.Your pointer introduces a Ray into the Universe. Rust/WASM resolves the resulting state, and Crystal materializes the visual response through WebGL2 on the GPU.
MOVE YOUR POINTER TO SEND A RAY THROUGH THE UNIVERSE
ROCIO INTENSITY0.90
subtlefull
05 / QUICK START

Enter the
Universe.

Quetzalcoatl Core works with Vanilla JavaScript, React and Next.js. Keep the DOM you already have, choose how elements participate in the Universe, and manifest visual response through the GPU only where you need it.

INSTALL
$npm install quetzalcoatl-core
WORKS WITH
VANILLA JSREACTNEXT.JS
01
ENTER THE UNIVERSEPARTICIPATION: ALL
import {
    Quetzalcoatl
} from "quetzalcoatl-core/react";

export default function App() {
    return (
        <Quetzalcoatl participation="all">
            <main>
                <Interface />
            </main>
        </Quetzalcoatl>
    );
}
In all mode, supported elements participate in the Universe by default.
02
PARTICIPATE EXPLICITLYPARTICIPATION: EXPLICIT
<Quetzalcoatl participation="explicit">
    <main>
        <NativeContent />

        <section qc>
            <InteractiveExperience />
        </section>
    </main>
</Quetzalcoatl>
In explicit mode, elements stay native until qc enables participation.
03
MANIFEST ROCIOVISUAL RESPONSE
export function Card() {
    return (
        <article rocio>
            <h2>
                Universe active.
            </h2>
        </article>
    );
}
rocio controls visual manifestation, not runtime participation.
MODE · ALLParticipation by defaultparticipation="all"
QCEnable participation<div qc />
NOQCStay native<div noqc />
ROCIOManifest visual response<div rocio />

Keep your native structure.
Add participation where you need it.

npmGitHub