libs/web/

libs/web

High-Throughput Web Framework & Router

A fast, modular web application framework in Kale. Features a lightning-fast radix tree URL router with wildcard and parameter capture (/api/v1/users/:id), structured JSON response generation, and composable middleware pipelines.

Router EngineRadix Trie O(k)

Payload SupportJSON & Form-Encoded

TemplatesMustache-Style AST

MilestoneM9 Validated

Frame Budget & Event Loop

Target: 144 FPS (6.94ms per frame)

1. Input Polling (0.2ms)

Raw keyboard & mouse events polled via GLFW3 callbacks

2. Piece Table Mutation (0.4ms)

Append-only buffer edit with instant O(1) undo/redo stack

3. GPU Batched Quad Draw (0.8ms)

Dynamic font atlas textures rendered in single GPU draw call

Piece Table Buffer Engine

Sub-Millisecond Multi-Cursor Editing

Unlike line-array or gap-buffer architectures, the Kale Piece Table holds an immutable original file buffer coupled with an append-only edit buffer. Loading a 100MB file takes under 1ms because no memory copying occurs.

Buffer Type: Immutable File Span + Append-Only Log

Undo/Redo: Zero heap copy • O(1) pointer adjustment

web_app.kl

kale

import "libs/web/app.kl" as web;

fn handle_get_project(req: *web.Request, res: *web.Response) -> void {
    let slug: string = web.param(req, "slug");
    web.json(res, 200, "{\"project\": \"" + slug + "\", \"status\": \"active\"}");
}

fn main() -> int32 {
    let app: web.WebApp = web.new_app();
    web.get(&app, "/api/projects/:slug", handle_get_project);
    web.listen(&app, 8080);
    return 0;
}

Compilation & Linker Directives

Deterministic command-line invocations to build, link native dynamic dependencies, and run automated regression tests:

$kale build tests/test_web_router.kl -o bin/test_web.exe -lws2_32

$./bin/test_web.exe

Monorepo Governance

GPG Key 1B917D4779A6102E • Continuous integration with automated symbol verification.

Architectural Capabilities

Radix Trie Routing

Matches dynamic path parameters and wildcards in sub-microsecond time with zero memory allocations.

Middleware Pipeline

Pluggable request/response interceptors for logging, CORS, security headers, and authentication.

Server-Side Templates

Lightweight HTML template interpolation engine for dynamic page rendering.

← Previous Modulelibs/net

Next Module →libs/sql