#moon-miniprogram

#Features

• Type-safe runtime — business logic is pure MoonBit code; data flows across the FFI boundary as typed JSON, and misuses are rejected at compile time.
• Automatic state diffing — set_state performs partial merge (React setState semantics) and emits minimal setData path patches; zero calls when nothing changed.
• Shared cross-page state — create_store + bind_store subscribe pages and components to a single source of truth; one update propagates minimal patches to all subscribers.
• Declarative routing — register_route declares paths with parameter allow-lists; navigation never hand-builds URLs, and out-of-schema parameters are stripped with a dev warning instead of raising.
• Full page / component / app model — typed component properties, observers, page lifetimes, value-returning hooks, and app-global data.
• Headless testing — scripts/sim/wx-sim.js simulates the WeChat runtime (path-aware setData, wx call records); end-to-end tests run without the WeChat DevTools.
• CLI & scaffolding — scripts/new.cjs generates a project that pulls the framework from mooncakes; mmp.cjs covers check / test / build / dev / release.

#Installation

node scripts/new.cjs myapp
cd myapp

#Usage

let page : @mp.PageDef = {
  path: "pages/index/index",
  data: @mp.jobj([("count", @mp.jnum(0.0))]),
  handlers: [
    ("onTap", (ctx, _payload) => {
      let n = match ctx.get_data() {
        Some(Json::Object(m)) =>
          match m.get("count") {
            Some(Json::Number(d, ..)) => d + 1.0
            _ => 1.0
          }
        _ => 1.0
      }
      ctx.set_state(@mp.jobj([("count", @mp.jnum(n))]))
    }),
  ],
  returns: [],
}

// app.js / pages/index/index.js
require("./engine/moon-engine.js").launch();
require("../../engine/moon-engine.js").page("pages/index/index");

node mmp.cjs check     # type check
node mmp.cjs test      # unit tests
node mmp.cjs dev       # watch-mode rebuild (open miniprogram/ in WeChat DevTools)

#Performance

#Documentation

• Guide — from zero to a runnable Mini Program; state, components, routing, headless testing, release.
• Acceptance guide — reproducible automated checks and a short WeChat DevTools review path.
• References and compliance — originality, upstream references, licenses, and reuse boundaries.
• wx API coverage table — WeChat API coverage, domain by domain.
• RFC 0001 — platform adapter architecture (WeChat is the current target; Alipay / Douyin are designed for).
• API reference per function is available on the mooncakes package page.

#Repository

runtime/          framework core (models, diff engine, store, router, wx bindings, platform probe)
engine/           minimal example, used as the smoke-test host
engine-export/    CommonJS export wrapper (foreign_library)
miniprogram/      importable two-page WeChat DevTools showcase
scripts/          scaffolding, mmp CLI, wx simulator, smoke tests, minifier
docs/             guide, API coverage table, RFCs

#Contributing

git clone https://github.com/Magic486/moon-miniprogram
moon test                # 54 unit tests
powershell scripts/build-example.ps1   # build showcase + 40 smoke assertions

#License