概要
UnifiedMozaic は、TypeScript 風の文法で書き、GC なしでネイティブバイナリと WebAssembly に落とす言語です。CPU と GPU のコードを同じソース(.um)で書けます。このガイドでは、いま書けるものと、その決まりごとを説明します。
struct Vec3 { x: f32; y: f32; z: f32;}
function add(a: Vec3, b: Vec3): Vec3 { return { x: a.x + b.x, y: a.y + b.y, z: a.z + b.z };}
// mut は可変借用。呼び出し側にも mut と書く。function scaleInPlace(v: mut Vec3, s: f32): void { v.x *= s; v.y *= s; v.z *= s;}
export function main(): i32 { let v: Vec3 = add({ x: 1, y: 2, z: 3 }, { x: 4, y: 5, z: 6 }); scaleInPlace(mut v, 0.5); print(v.x); return 0;}いまの状態: 言語とランタイムは試験段階で、よく変わります。kernel 関数は、ネイティブでは CPU の複数のスレッドで、Mac(Apple Silicon)では Metal で GPU でも実行できます(下の「Metal(Mac)での GPU 実行」)。wasm32 向けの WebGPU での実行は実験的で、今後は保守しません(下の「ブラウザでの GPU 実行(WebGPU、実験的)」)。
必要なもの・使い方
Section titled “必要なもの・使い方”入れ方は 環境構築、最初の一歩は README.ja.md にあります。要点だけ書きます。
- Node.js 22.18 以上(TypeScript をそのまま実行します。npm パッケージへの依存はありません)
- LLVM 18 以上の
clang。wasm32 を出すにはwasm-ldも必要です- macOS: Xcode の clang は wasm に対応していないため、wasm32 を使う場合は
brew install llvm lldで入れたものを使ってください(UM_CLANGで clang の場所を指定できます)
- macOS: Xcode の clang は wasm に対応していないため、wasm32 を使う場合は
# wasm32(既定)node src/cli.ts build examples/structs.um -o structs.wasmnode runtime/run-node.mjs structs.wasm
# このマシン向けのネイティブバイナリnode src/cli.ts build examples/structs.um --target host -o structs./structs
# Mac で kernel を GPU(Metal)でも実行するネイティブバイナリUM_METAL=1 node src/cli.ts build examples/kernels.um --target host -o kernels
# Apple Silicon の macOS 向け(Mac 以外ではオブジェクトファイルまで)node src/cli.ts build examples/structs.um --target arm64-macos -o structs
# 型検査だけ。--json で診断を機械可読な形で出すnode src/cli.ts check examples/structs.um --json
# 生成される LLVM IR を見る(--emit-wgsl / --emit-msl で kernel のシェーダも書き出す)node src/cli.ts build examples/structs.um --emit-llvm -o structs.llブラウザでは runtime/host.mjs の instantiate(bytes) で読み込み、export した関数を呼びます。
いま書けるもの
Section titled “いま書けるもの”| 分類 | 内容 |
|---|---|
| 型 | i8〜i64、u8〜u64、usize、f4、f8、f16、f32、f64、bool、string、struct、enum(値つき。match で分岐)、class、固定長配列 T[N]、可変長配列 T[](Array<T> と同じ)、Buffer<T>、RacyBuffer<T>、T | null、標準の Result<T, E>、ベクトルと行列 vec2<T>〜vec4<T> / mat2<T>〜mat4<T>、SIMD の i8x16 など |
| 宣言 | function、export function、kernel function、struct、enum、class(フィールド、初期値、constructor、メソッド、private、implements)、interface、ジェネリックな関数・struct・class・enum・kernel、最上位の定数 const NAME: T = 定数式;(export const も可)、import { a, b } from "./x.um"; |
| 文 | let / const(let x: T; はゼロで初期化)、代入と複合代入、++ / --、if / else、while、do ... while、for (;;)、for...of、switch、match、break、continue、return |
| 式 | 四則演算と剰余、比較、&& / || / !、条件式 a ? b : c、x ?? 既定値、ビット演算とシフト、as による変換、関数とメソッドの呼び出し、new、this、フィールドと添字、オブジェクトリテラル、配列リテラル、new Array<T>(n)、xs.length、テンプレート文字列 `x = ${x}`、String(x) |
| 配列のメソッド | push、pop、clear、clone、一括の書き込み fill(v) / fill(v, start, end)(Buffer / RacyBuffer にも。下の「一括の書き込み」) |
| 組み込み | print(x)(数、bool、文字列)、dispatch / cpu.dispatch / gpu.dispatch、gpu.submit / gpu.ready / gpu.wait、thread.*(下の「スレッド」)、Math.sqrt / floor / ceil / abs / min / max、ビット演算の Math.popcount / clz / ctz、マスクつきシフト Math.shl / Math.shr(下の「マスクつきシフトと範囲チェックの除去」)、先読み Math.prefetch(arr, i)(下の「先読み」)、SIMD の Simd.*(下の「SIMD のベクトル」) |
| 入出力の組み込み | readLine()、inputReady()、clock()、stringFromBytes(bytes)、readFile(path)、writeFile(path, bytes)(下の「入出力」) |
それぞれの書き方は、下の各節と「そのほかの機能」の例にあります。
決まりごと:
- 暗黙の型変換はありません。
i32とf64を混ぜるときはasで明示します。数値リテラルは文脈の型に合わせます。 - 引数の渡し方は3種類です。 修飾なしは読み取り借用、
mutは可変借用、ownは所有権の移動です。mutとownは呼び出し側にも書きます。 - 構造体・
class・配列は値型です。 代入すると、ヒープを持たない値はコピーされ、ヒープを持つ値は移動します(下の「所有権」)。 classに継承はありません。structはオブジェクトリテラルで、classはnewで作ります。共通のメソッドの約束にはinterfaceを使います。- メソッドが
thisを書き換えるかどうかは、コンパイラが本体から判断します。 書き換えるメソッドは、letで宣言した変数かmutの引数に対してだけ呼べます。 - コンストラクタは全フィールドを初期化します。 最上位の
this.x = ...か、フィールドの初期値(x: i32 = 0)で与えます。初期化が済むまでthis全体は使えません。 for...ofの要素は、数などはコピー、ヒープを持つ要素(文字列や配列)は借用です。 借用するときはfor (const x of xs)と書きます。境界検査は入りません。反復中の配列は書き換えられません。for (let i = 0; i < xs.length; i++)のiは、比較相手の型(ここではusize)になります。 それ以外の場所ではxs.lengthはusizeなので、i32と混ぜるときはasが要ります。usizeの幅はターゲットで違います(wasm32 は32ビット、ネイティブは64ビット)。 幅に依存する計算にはu32やu64を明示してください。- 符号なし整数に
>= 0と書くとコンパイルエラーです。 常に真で、逆順のループが止まらなくなるためです。 - 代入は右辺を先に評価します。
a[f()] = g()はg()、f()の順です(JavaScript とは逆)。右辺が配列を伸ばしても、代入先を安全に求められるようにするためです。 printの浮動小数点の表記は、どのターゲットでも JavaScript と同じです。Math.min/Math.maxは「比較して選ぶ」定義です。 どちらかが NaN のときは2番目の引数を返します(JavaScript とは違います)。- ネイティブのプログラムには
export function main(): i32(引数なし)が要ります。