Expand description
The engine-id namespace and the genet render-rung ladder. The engine-id namespace and the genet render-rung ladder.
Engine ids are facts an engine states about itself: a kept Genet session
lane returns one from SessionEngine::engine_id. Which engine a host
selects for an address is routing policy and lives with the controller
in inker::routing; these names are what that policy is written in.
Enums§
- Genet
Rung - A rung of the genet HTML render ladder. genet is one engine that scales from a
static, JS-free composition up to a full browser; the rung selects how much of the
web stack a page is given. Each rung is additive over the one below, and each
is a principled composition — the static rung carries no JS in its dependency graph
(attack-surface + bundle-size + DOM-as-library), so a higher rung is a deliberate
escalation, never the default. The default HTML route is
Static; a node pins a higher rung to opt in. Ordered by capability (the derivedOrd).
Constants§
- ENGINE_
EXTERNAL_ PROTOCOL - The one host-handled id inker keeps: the neutral “hand this address to the
OS” target every host has, and the default policy’s
fallbackrule needs one. App-flavored host-handled ids (internal pages, graph-contribution ingest markers) are the host’s own vocabulary, defined app-side and layered onto the policy at construction (mere:mere::routing); registry keys are plain strings, so a host id costs nothing here. - ENGINE_
GENET_ FULLWEB - ENGINE_
GENET_ INTERACTIVE - The genet HTML rungs above static (the profile ladder; see
GenetRung). A node pins one of these to escalate capability. Additive, and gated by host registration: until a rung is registered in the host’sEngineRegistry, it is notis_available, so a pin to it falls back to the static route (route_filtered). genet scales internally from the static composition up to a full browser (genetdocs/2026-05-12_genet_profile_ladder_plan.md); these ids select the rung. - ENGINE_
GENET_ LIVERY - Opt-in static rung rendered by the clean-room Livery CSS engine. This is a
sibling implementation of
ENGINE_GENET_WEB, not the default route. - ENGINE_
GENET_ READER - Render-free fleece extraction lowered into the portable document engine. Selectable for held HTML by explicit per-node pin; never the automatic HTML route, which remains the ordinary Genet renderer.
- ENGINE_
GENET_ SCRIPTED - ENGINE_
GENET_ SCRIPTED_ NOVA - The scripted genet rung backed by Nova instead of Boa. Same ladder rung, distinct host-visible engine id so a node can pin the JS backend explicitly.
- ENGINE_
GENET_ WEB - The genet HTML engine’s static rung (the profile ladder’s base): parse →
style/layout → paint, with no JS in its dependency graph. The default HTML route
and the id existing per-node pins persist, so it keeps the legacy
genet.webvalue rather thangenet.static. SeeGenetRung. - ENGINE_
GRAFT_ SERVO - Embedded Servo via the wgpu-graft producer (GL-FBO / DX12-shared / Vulkan
external-memory / IOSurface interop). Tier-2 surface engine; opt-in per tile
like
ENGINE_SCRYING_WEB, not in the default policy. - ENGINE_
NEMATIC_ FEED - ENGINE_
NEMATIC_ FILE - ENGINE_
NEMATIC_ FINGER - ENGINE_
NEMATIC_ GEMTEXT - ENGINE_
NEMATIC_ GOPHER - ENGINE_
NEMATIC_ GUPPY - ENGINE_
NEMATIC_ KNOT - ENGINE_
NEMATIC_ KNOT_ DJOT - ENGINE_
NEMATIC_ MARKDOWN - ENGINE_
NEMATIC_ MISFIN - ENGINE_
NEMATIC_ NEX - ENGINE_
NEMATIC_ SCROLL - ENGINE_
NEMATIC_ TEXT - ENGINE_
NEMATIC_ TITAN - Titan (
titan://) response bodies — gemtext re-tagged with titan provenance. - ENGINE_
SCRYING_ WEB - Mere-managed system-WebView tile driven by the in-house
scryinglibrary. Embedded-frame composition into the host’s wgpu surface (frames captured viawebview2-comon Windows /objc2-web-kit+ ScreenCaptureKit on macOS / WebKitGTK+DMABUF on Linux). - ENGINE_
WELD_ CHROMIUM - Bundled Chromium via the wgpu-weld CEF accelerated-OSR producer. Tier-2
surface engine; opt-in per tile like
ENGINE_SCRYING_WEB.
Functions§
- genet_
rung - The genet render rung an
engine_idselects, orNonewhen it is not a genet HTML rung (a nematic, surface, or marker engine). - is_
genet_ rung - Whether
engine_idnames any rung of the genet HTML render ladder. The tier-1 counterpart tois_surface_engine: a genet rung produces a portableEngineDocument, not a GPU surface frame. - is_
surface_ engine - Whether
engine_idnames a tier-2 surface engine — one that produces GPU frames (a system WebView viaENGINE_SCRYING_WEB; CEF via weld and Servo via graft when those land) rather than a portableEngineDocument. Surface engines go through theSurfaceEngineRegistry/ producer path; document engines go through theEngineRegistry. A host branches on this to pick the lane.