A high-performance vector artboard data model and operation kernel for Web/WASM built in MoonBit.

vector

artboard

graphics

wasm

design-tool

editor-kernel

svg

scenegraph

moon add wccerty/moonbit-artboard@0.1.0

Download zip

Author

wccerty

Version

0.1.0

License

Apache-2.0

Repository

github.com/wccerty/moonbit-artboard

Last updated

17 days ago

Downloads

README

#moonbit-artboard

High-Performance Vector Artboard Data Model & Interactive Editing Engine written in pure MoonBit for WebAssembly (WASM-GC).

#📌 Project Overview

moonbit-artboard is a production-grade, zero-dependency 2D vector graphic canvas and interactive design editor kernel built from scratch in MoonBit. It is designed to power WebAssembly-native graphic design applications, design tools, and vector node scene-graph manipulation engines (similar to Figma, Illustrator, and Canvas 2D kernels).

#🌟 Key Features

2D & 3D Affine Geometry Engine: Full 2D matrix transformation engine (Matrix2D), cubic/quadratic Bezier evaluation (CubicBezier, QuadraticBezier), 3D perspective transformation matrices (Matrix4x4), and Ear Clipping polygon triangulation algorithms.
Rich Vector Primitive Systems: Rectangles (rounded corners), Ellipses, Polygons, N-Point Stars, Lines, Polylines, and pure MoonBit SVG Path string parser & tokenizer (parse_svg_path).
Scene-Graph Tree & Transform Hierarchy: Document node tree with parent-child matrix accumulation (ArtboardDocument), Group/Ungroup node commands, layer z-ordering, and Flexbox-style Auto Layout framing engine.
Interactive Selection & Controllers: Bounding box union calculations, 8-point resize handle controllers, rotation handles, and smart alignment guides with edge/center snapping.
Undo / Redo History Stack: Command pattern transaction manager (UndoManager) supporting atomic operations, batch transactions, and history depth bounds.
Spatial Indexing & Hit Testing: Winding number point-in-path hit testing and Grid Spatial Partitioning index for fast viewport culling.
Dual Exporter & Code Generator: Native SVG document exporter (export_to_svg), Canvas 2D instruction stream compiler (generate_canvas_instructions), Vector PDF document adapter (export_to_pdf), and HTML5 Canvas code generator.

#📊 Code Scale & Architecture Sitemap

This repository contains 5,713 lines of clean, idiomatic MoonBit code across 10 modules:

Module Package	Description	Submodules & Features
src/math	Math & Matrix Kernel	Vector algebra, 2D/3D affine matrix, Bezier curves, B-Splines, Triangulation
src/shapes	Vector Shapes & Color	RGBA color space, Hex parsing, Styles, Bezier path builders, Text typography, Boolean ops, Mesh Gradients
src/scenegraph	Scene-Graph Node Tree	Artboard document, Node repository, Layer z-index, Auto Layout, Component instances, Layout constraints
src/spatial	Spatial Indexing	Winding Number hit testing, Grid spatial index culling
src/selection	Selection Engine	Selection manager, 8-handle transform controllers
src/history	Undo / Redo Manager	Command pattern, Transaction manager, History stack
src/tools	Interactive Tool Engine	Tool state machine, Alignment guides, Interactive Pen tool bezier engine
src/serialization	Serialization & AST	Document JSON encoder, JsonValue AST parser, SVG XML importer
src/export	Export Adapters	SVG exporter, Canvas 2D instruction stream, PDF exporter, HTML5 Canvas code generator
src/main	Entry Demo	Integration showcase & preset artwork generation

#🚀 Quick Start & Build Instructions

#Prerequisites

MoonBit Compiler Toolchain (v0.10.4 / latest)

#Build & Run Commands

# 1. Format code and check formatting compliance
moon fmt

# 2. Check package interface files
moon info

# 3. Run the full unit test suite (36 passing tests)
moon test

# 4. Compile and execute the main integration demo
moon run src/main

#🏆 Open Source Competition (OSC 2026) Submission

This project is submitted to OSC 2026 (Open Source Contest 2026).

Author & Contributor: wccerty (Single contributor, fully matched across GitHub and GitLink).
GitHub Repository: https://github.com/wccerty/moonbit-artboard
GitLink Repository: https://www.gitlink.org.cn/Wccerty/moonbit-artboard
License: Apache-2.0 License

Site source Report issue Packages Build queue Skills Statistics