🥮 mooncakes.io

moui_web_renderer

Browser WebGPU renderer with Canvas2D fallback providers for MoUI

moui
renderer
webgpu
canvas2d
web
moon add wzzc-dev/moui_web_renderer@0.1.10
Download zip
Author
Version
0.1.10
License
Apache-2.0
Repository
Last updated
yesterday
Downloads
7

Dependencies

README

#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)

#
WebGpuHostAdapterInfo

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

#
WebGpuHostAdapterInfo::capabilities

source

#
WebGpuHostAdapterInfo::description

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

#
WebGpuHostAdapterInfo::imports

source

#
WebGpuHostAdapterInfo::new

source

#
WebGpuHostAdapterInfo::renderer

source

#
WebGpuHostAdapterInfo::surface_contract

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)

#
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::new

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

#
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::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::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

#
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::metrics

source

#
WebGpuHostSurface::new

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