Skip to main content

Module engine_ids

Module engine_ids 

Source
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§

GenetRung
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 derived Ord).

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 fallback rule 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’s EngineRegistry, it is not is_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 (genet docs/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.web value rather than genet.static. See GenetRung.
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 scrying library. Embedded-frame composition into the host’s wgpu surface (frames captured via webview2-com on 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_id selects, or None when it is not a genet HTML rung (a nematic, surface, or marker engine).
is_genet_rung
Whether engine_id names any rung of the genet HTML render ladder. The tier-1 counterpart to is_surface_engine: a genet rung produces a portable EngineDocument, not a GPU surface frame.
is_surface_engine
Whether engine_id names a tier-2 surface engine — one that produces GPU frames (a system WebView via ENGINE_SCRYING_WEB; CEF via weld and Servo via graft when those land) rather than a portable EngineDocument. Surface engines go through the SurfaceEngineRegistry / producer path; document engines go through the EngineRegistry. A host branches on this to pick the lane.