edwardkim

rhwp

Frontend🌱 NEW PROJECT BOOST#Rust#WebAssembly#TypeScript#Editor#Parser

// summary

rhwp is an open-source HWP and HWPX viewer and editor built with Rust and WebAssembly to provide universal document accessibility. It features a robust rendering engine, comprehensive parsing capabilities, and a web-based editor that maintains compatibility with standard HWP workflows. The project follows a structured development roadmap aimed at achieving full feature parity with commercial alternatives through community-driven contributions.

// technical analysis

rhwp is a Rust and WebAssembly-based open-source project designed to provide a universal viewer and editor for HWP and HWPX document formats. By leveraging a robust core architecture built on CQRS principles, it solves the problem of accessibility for proprietary document formats across various platforms and AI-driven workflows. The project emphasizes a human-led, AI-assisted development methodology, ensuring that architectural integrity and quality control are maintained through rigorous testing and documentation while utilizing AI for efficient implementation.

// key highlights

Provides a high-fidelity HWP/HWPX parser and rendering engine capable of handling complex elements like tables, equations, and multi-column layouts.

Offers a web-based editor that is compatible with hwpctl APIs, enabling seamless integration with existing web-based document workflows.

Supports multiple output formats including SVG for high-quality vector rendering and Canvas for interactive web-based viewing.

Implements a sophisticated pagination engine that manages complex layout requirements such as table row splitting and shape positioning.

Includes a comprehensive CLI toolset for document inspection, debugging, and automated SVG export, facilitating developer-friendly troubleshooting.

Utilizes a modular architecture that separates the document model, rendering pipeline, and editing commands to ensure maintainability and scalability.

// use cases

View and edit HWP/HWPX files directly in web browsers without installation

Integrate HWP editing capabilities into web applications via npm packages

Convert HWP documents to SVG format using a high-performance CLI tool

// getting started

To begin using rhwp, developers can install the core library via npm using 'npm install @rhwp/core' or the full editor via 'npm install @rhwp/editor'. For those building from source, ensure Rust 1.75+, Node.js 18+, and Docker are installed, then use 'cargo build' for native binaries or 'docker compose' to generate WASM artifacts. Detailed onboarding guides and architectural documentation are available in the 'mydocs/' directory of the repository.