N#

NEXO DOCS

The Official Blueprint of the N# Ecosystem

1. Architectural Core

Nexo (N#) executes a dynamic, untyped C-style architecture mapping directly to MSIL instructions via .NET. There are no static types. Everything is inferred, isolated, and highly optimized for enterprise networking and speed.

2. Memory Allocation & Variables

Drop the var or int keywords. Simply assign a value to a label, and the native memory allocator will handle the mapping instantly.

<3 Integers, Floats, and Strings
health = 100
damage = 25.5
playerName = "Florentina"

<3 Booleans (1 = True, 0 = False)
isActive = 1

<3 Re-assignment changes types dynamically
health = "God Mode"

3. I/O Broadcasts

Sending data to the terminal buffer natively is universally governed strictly by the write keyword.

write "Initiating Nexo Sequence..." <3 Prints the literal string buffer

<3 Seamless string and dynamic concatenation is natively supported
score = 999
write "Final Score: " + score

4. Control Flow (If / Else)

Nexo evaluates standard logical comparisons (==, >, <=, !=) inside structural blocks.

power = 50

if power > 100 {
write "Overcharged!"
} else if power == 50 {
write "Optimal capacity."
} else {
write "Warning: Low Power."
}

5. Action Subroutines (Functions)

Define reusable logic blocks using the exact semantic do keyword. Functions natively support recursion and isolated scoping limits.

do calculateDamage(base, multiplier) {
total = base * multiplier
return total
}

hit = calculateDamage(50, 2.5)
write "Crit! Damage done: " + hit

6. Arrays & Iteration Sequences

Map multiple states into single structures using Arrays. Nexo provides foreach and while to shred through list bounds efficiently.

servers = ["Auth", "Database", "Matchmaking"]

<3 The Foreach Array Iterator
foreach target in servers {
write "Pinging " + target + "..."
}

<3 The Traditional While Loop
hp = 3
while hp > 0 {
write "Taking Damage..."
hp = hp - 1
}

7. NPM Ecosystem (Cloud Registry)

Nexo intentionally limits native runtime libraries inside the core engine. To access advanced logic, you must actively using external modules. If they are not present, acquire them globally from the Vercel Edge.

<3 --- EXECUTED ON THE TERMINAL ---
$ nexo install nexocore.math
$ nexo install custom.networking

<3 --- INSIDE YOUR SCRIPT ---
using nexocore.math
using custom.networking

write "All modules loaded perfectly."

8. CLI Compilation Toolkit

The nexo Native CLI is an incredibly powerful architectural weapon. It manages JIT execution, native byte-building, and cloud synchronizations.

nexo open script.nexo
Executes the N# script directly in fast-memory via the built-in Interpreter (JIT).
nexo build script.nexo
Transpiles and compiles your N# file natively into an impenetrable MSIL .dll executable (AOT).
nexo run script.dll
Forces the CLR to immediately load and execute a compiled .dll bytepack.
nexo install [package]
Pulls raw N# source codes from the global API Registry into C:\Programs\Nexo\libs.
nexo publish [pkg] [file] [key]
Authenticates and uploads your N# file straight to the Global Cloud Registry via Cryptographic Bearer keys.

9. Standard Library Technical Lab

Nexo 2.0 "Titan" introduces a professional, natively bridged standard library. Every function call below maps 1:1 to optimized .NET MSIL instructions.

nexocore.ai

Invoke LLM intelligence directly within the execution scope.

using nexocore.ai
prompt = "Write a Nexo function to sort an array"
response = aiGenerate(prompt)
write response

nexocore.json

Full serialization support for REST API responses.

using nexocore.json
rawJson = "{ \"name\": \"Titan\", \"version\": 2 }"
data = jsonParse(rawJson)
write "System: " + data["name"]

nexocore.discord

Native high-speed networking to Discord Gateway.

using nexocore.discord
webhook = "https://discord.com/api/webhooks/..."
discordPost(webhook, "Hello from N#!")

nexocore.fs

Raw operating system file system operations.

using nexocore.fs
config = fsRead("config.nexo")
fsWrite("log.txt", "Execution started at " + config)

... and 9 more enterprise modules including crypto, net, and system.