MoonBit Generative Pattern Library (`generative_patterns`)

A procedural/generative pattern library written in MoonBit for designing posters, packaging, and cultural products.

Features

2D Affine Transformation Matrix: Translation, rotation, scaling, and reflection across arbitrary lines.
Parametric SVG Path Builder: Generates shapes like rectangles, circles, stars, and floral shapes.
Grid Layout Generators: Supports rectangular, hexagonal, triangular, and radial grids.
Point and Wallpaper Symmetry Groups: Applies cyclic ( $C_{n}$ ), dihedral ( $D_{n}$ ), and plane tiling symmetries ( $p 1$ , $p 2$ , $p m$ , $p m m$ , $p 4$ , $p 4 m$ , $p 6$ , $p 6 m$ ).
Noise Sampling and Domain Warping: Interface for procedural noise sampling and flow fields.
Parametric SVG and JSON Export: Easily renders complete designs to standard SVG vector files and JSON configurations.

Architecture

The project consists of:

lib: Core modules for geometry, symmetry, grid, path, noise, and SVG generation.
cmd/main: A showcase command-line tool executing the pattern generator and saving outputs.

Usage Example

The following is a verified test case demonstrating basic affine matrix transformations and path construction:

test {
  // Create a 2D transformation matrix: translate, then scale
  let t = @generative_patterns.Matrix2D::translate(10.0, 20.0)
  let s = @generative_patterns.Matrix2D::scale(2.0, 2.0)
  let m = t.multiply(s)
  
  // Transform a point
  let (x, y) = m.transform_point(5.0, 5.0)
  assert_eq(x, 20.0)
  assert_eq(y, 30.0)
  
  // Create a rect path and transform it
  let path = @generative_patterns.Path::rect(10.0, 10.0)
  let transformed = path.transform(m)
  let d = transformed.to_svg_d()
  assert_eq(d, "M 10 20 L 30 20 L 30 40 L 10 40 Z")
}

Running & Testing

To compile, build, and test the project:

# Type check all packages
moon check

# Run unit and doc tests
moon test

# Format code warning-free
moon fmt

# Compile and run the CLI showcase
moon run cmd/main

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.