🥮 mooncakes.io
    Sign in

    moui_web_renderer

    Browser WebGPU renderer with Canvas2D fallback providers for MoUI

    moui
    renderer
    webgpu
    canvas2d
    web
    Download zip
    Author
    Version
    0.2.2
    License
    Apache-2.0
    Repository
    Last updated
    2 days ago
    Downloads
    125

    Dependencies

    #WebGPU Wasm-GC Host Boundary

    render/webgpu_adapter is the only Web renderer path. It targets MoonBit wasm-gc and calls a browser-provided webgpu import module.

    This package intentionally does not depend on WIT/component today. The public boundary is kept thin so a future WIT/component migration can replace only the port implementation:

    WebGpuWasmRenderer
  -> WebGpuHostRendererPort
  -> wasm-gc webgpu imports today
  -> WIT/component resources later

    The rest of MoUI should depend on WebGpuWasmRenderer, WebGpuHostRendererPort, and the renderer facade concepts, not on individual import names.

    #Current Host Imports

    The browser loader must provide a webgpu import object with:

    capabilities:
  webgpu_available, adapter_ready, can_render

strings:
  begin_create_string, string_append_char, finish_create_string

surface:
  create_surface, surface_is_valid, surface_resize, surface_dispose

renderer:
  create_renderer, renderer_is_valid, renderer_resize, begin_frame,
  clear, fill_rect, stroke_rect, fill_rounded_rect, stroke_rounded_rect,
  draw_text, draw_image, push_clip, pop_clip, push_transform, pop_transform,
  push_opacity, pop_opacity, present, renderer_dispose

    Opaque browser objects are represented as integer handles. That is deliberate: MoonBit wasm-gc host import stubs currently accept this ABI shape reliably, while direct opaque host resource types do not.

    #Future WIT Migration

    When MoonBit has a stable WIT/component path for wasm-gc, map the same conceptual operations to WIT resources:

    HostWebGpuSurface handle  -> resource surface
HostWebGpuRenderer handle -> resource renderer
WebGpuHostRendererPort    -> generated WIT adapter implementation

    The migration should keep backend/web and core draw-command conversion unchanged except for swapping wasm_gc_host_port() to a generated WIT-backed port.

    WebGpuHostError

    source
    pub(all) suberror WebGpuHostError {
      Unavailable
      AdapterUnavailable
      DeviceUnavailable
      SurfaceUnavailable
      PipelineUnavailable
      InvalidResource
      HostError(String)
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostError::equal

    source

    WebGpuHostError::not_equal

    source
    fn WebGpuHostError::not_equal(x : WebGpuHostError, y : WebGpuHostError) -> Bool

    WebGpuHostError::to_json

    source

    WebGpuHostError::to_repr

    source

    WebGpuHostAdapterInfo

    source
    pub struct WebGpuHostAdapterInfo {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostAdapterInfo::capabilities

    source

    WebGpuHostAdapterInfo::description

    source
    fn WebGpuHostAdapterInfo::description(self : WebGpuHostAdapterInfo) -> String

    WebGpuHostAdapterInfo::equal

    source

    WebGpuHostAdapterInfo::imports

    source

    WebGpuHostAdapterInfo::new

    source

    WebGpuHostAdapterInfo::not_equal

    source

    WebGpuHostAdapterInfo::renderer

    source

    WebGpuHostAdapterInfo::surface_contract

    source

    WebGpuHostAdapterInfo::to_json

    source

    WebGpuHostAdapterInfo::to_repr

    source

    WebGpuHostCall

    source
    pub(all) enum WebGpuHostCall {
      BeginFrame(
    Size    )
      Clear(
    Color    )
      FillRect(
    Rect    , 
    Color    )
      StrokeRect(
    Rect    , 
    Color    , Double)
      FillRoundedRect(
    RoundedRect    , 
    Color    )
      StrokeRoundedRect(
    RoundedRect    , 
    Color    , Double)
      FillRoundedRectBrush(
    RoundedRect    , 
    Brush    )
      StrokeRoundedRectBrush(
    RoundedRect    , 
    Brush    , Double)
      DrawShadow(
    ShadowSpec    )
      DrawText(
    TextRun    )
      DrawImage(
    ImageRun    )
      DrawPath(
    PathSpec    )
      PushClip(
    Rect    )
      PopClip
      PushRoundedClip(
    RoundedRect    )
      PopRoundedClip
      PushTransform(
    Transform2D    )
      PopTransform
      PushOpacity(Double)
      PopOpacity
      PushLayer(
    LayerSpec    )
      PopLayer
      PushFilter(
    FilterEffect    )
      PopFilter
      DrawShaderEffect(
    ShaderEffectSpec    )
      Present
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostCall::equal

    source

    WebGpuHostCall::not_equal

    source
    fn WebGpuHostCall::not_equal(x : WebGpuHostCall, y : WebGpuHostCall) -> Bool

    WebGpuHostCall::to_json

    source

    WebGpuHostCall::to_repr

    source

    WebGpuHostCapabilities

    source
    pub struct WebGpuHostCapabilities {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostCapabilities::adapter_ready

    source
    fn WebGpuHostCapabilities::adapter_ready(self : WebGpuHostCapabilities) -> Bool

    WebGpuHostCapabilities::can_render

    source
    fn WebGpuHostCapabilities::can_render(self : WebGpuHostCapabilities) -> Bool

    WebGpuHostCapabilities::equal

    source

    WebGpuHostCapabilities::new

    source
    fn WebGpuHostCapabilities::new(webgpu_available? : Bool, adapter_ready? : Bool, can_render? : Bool) -> WebGpuHostCapabilities

    WebGpuHostCapabilities::not_equal

    source

    WebGpuHostCapabilities::to_json

    source

    WebGpuHostCapabilities::to_repr

    source

    WebGpuHostCapabilities::webgpu_available

    source
    fn WebGpuHostCapabilities::webgpu_available(self : WebGpuHostCapabilities) -> Bool

    WebGpuHostImportInfo

    source
    pub struct WebGpuHostImportInfo {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostImportInfo::description

    source
    fn WebGpuHostImportInfo::description(self : WebGpuHostImportInfo) -> String

    WebGpuHostImportInfo::equal

    source

    WebGpuHostImportInfo::import_module

    source
    fn WebGpuHostImportInfo::import_module(self : WebGpuHostImportInfo) -> String

    WebGpuHostImportInfo::new

    source
    fn WebGpuHostImportInfo::new(import_module~ : String, target~ : String, surface_resource~ : String, renderer_resource~ : String, description? : String) -> WebGpuHostImportInfo

    WebGpuHostImportInfo::not_equal

    source

    WebGpuHostImportInfo::renderer_resource

    source
    fn WebGpuHostImportInfo::renderer_resource(self : WebGpuHostImportInfo) -> String

    WebGpuHostImportInfo::surface_resource

    source
    fn WebGpuHostImportInfo::surface_resource(self : WebGpuHostImportInfo) -> String

    WebGpuHostImportInfo::target

    source
    fn WebGpuHostImportInfo::target(self : WebGpuHostImportInfo) -> String

    WebGpuHostImportInfo::to_json

    source

    WebGpuHostImportInfo::to_repr

    source

    WebGpuHostRendererPort

    source
    pub struct WebGpuHostRendererPort {
      // private fields
    }

    WebGpuHostRendererPort::capabilities

    source

    WebGpuHostRendererPort::create_renderer

    source
    fn WebGpuHostRendererPort::create_renderer(self : WebGpuHostRendererPort, surface : WebGpuHostSurface) -> Unit raise WebGpuHostError

    WebGpuHostRendererPort::create_surface

    source

    WebGpuHostRendererPort::dispose

    source

    WebGpuHostRendererPort::image_resource

    source

    WebGpuHostRendererPort::measure_text

    source

    WebGpuHostRendererPort::new

    source

    WebGpuHostRendererPort::register_font_data

    source
    fn WebGpuHostRendererPort::register_font_data(self : WebGpuHostRendererPort, family : 
    FontFamily    , data : Bytes) -> Unit

    WebGpuHostRendererPort::resize

    source

    WebGpuHostRendererPort::submit

    source

    WebGpuHostSurface

    source
    pub struct WebGpuHostSurface {
      // private fields
    } derive(Eq, ToJson, 
    Debug    )

    WebGpuHostSurface::canvas_id

    source
    fn WebGpuHostSurface::canvas_id(self : WebGpuHostSurface) -> String

    WebGpuHostSurface::equal

    source

    WebGpuHostSurface::metrics

    source

    WebGpuHostSurface::new

    source

    WebGpuHostSurface::not_equal

    source
    fn WebGpuHostSurface::not_equal(x : WebGpuHostSurface, y : WebGpuHostSurface) -> Bool

    WebGpuHostSurface::to_json

    source

    WebGpuHostSurface::to_repr

    source

    WebGpuWasmRenderer

    source
    pub struct WebGpuWasmRenderer {
      // private fields
    }

    WebGpuWasmRenderer::apply_image_resource_load_completion

    source

    WebGpuWasmRenderer::backend_info

    source

    WebGpuWasmRenderer::backend_kind

    source

    WebGpuWasmRenderer::dispose

    source
    fn WebGpuWasmRenderer::dispose(self : WebGpuWasmRenderer) -> Unit

    WebGpuWasmRenderer::image_resources

    source

    WebGpuWasmRenderer::last_calls

    source

    WebGpuWasmRenderer::last_fallback_plan

    source

    WebGpuWasmRenderer::present_count

    source
    fn WebGpuWasmRenderer::present_count(self : WebGpuWasmRenderer) -> Int

    WebGpuWasmRenderer::render

    source

    WebGpuWasmRenderer::render_frame

    source

    WebGpuWasmRenderer::resize

    source

    WebGpuWasmRenderer::surface

    source

    WebGpuWasmRenderer::text_system

    source

    WebGpuWasmRenderer::to_renderer_session

    source

    adapter_info

    source
    fn adapter_info() -> WebGpuHostAdapterInfo

    backend_info

    source

    browser_canvas2d_fallback_capabilities

    source

    canvas2d_fallback

    source

    canvas_surface_contract

    source

    create_browser_canvas2d_fallback_provider

    source

    Build the browser Canvas2D fallback provider. The browser runtime exposes its Canvas2D implementation through the WebGPU-compatible host-import port, so this provider intentionally creates WebGpuWasmRenderer values instead of importing the WeChat-only canvas2d wasm host module.

    create_renderer

    source
    fn create_renderer(canvas_id~ : String, logical_size~ : 
    Size    , scale_factor? : Double, port~ : WebGpuHostRendererPort) -> WebGpuWasmRenderer raise WebGpuHostError

    create_surface

    source
    fn create_surface(canvas_id~ : String, logical_size~ : 
    Size    , scale_factor? : Double, port~ : WebGpuHostRendererPort) -> WebGpuHostSurface raise WebGpuHostError

    create_webgpu_provider

    source

    Provider factory for the wasm-gc WebGPU adapter. Browser composition owns the canvas-specific renderer factory while this package owns negotiation and its capability declaration.

    create_webgpu_renderer

    source
    fn create_webgpu_renderer(canvas_id~ : String, logical_size~ : 
    Size    , scale_factor? : Double) -> WebGpuWasmRenderer raise WebGpuHostError

    draw_commands_to_host_calls

    source

    from_env

    source

    host_import_info

    source
    fn host_import_info() -> WebGpuHostImportInfo

    providers

    source

    Renderer-owned providers used by application diagnostics.

    renderer_descriptor

    source

    required_capabilities

    source
    fn required_capabilities() -> WebGpuHostCapabilities

    wasm_gc_host_port

    source
    fn wasm_gc_host_port() -> WebGpuHostRendererPort

    webgpu

    source

    Browser WebGPU provider. The canvas id is supplied by the opaque host surface after each browser window is created.

    webgpu_provider_capabilities

    source

    Source Files

    Powered by MoonBit

    Site sourceReport issuePackagesBuild queueSkillsStatistics

    © 2026 mooncakes.io