Kura Documentation

必要な環境

インストール

配布パッケージをグローバルインストール

npm install -g ./kura-lang-compiler-0.4.0.tgz
kr version
kr doctor

ソースコードから使う

npm install
npm run build
npm link
kr version

インストールできたか確認

kr version
kr doctor
kr help

最初のプログラム

main.krを作成します。

fn main() {
  println("Hello, Kura");
}

実行します。

kr run main.kr

短縮形も利用できます。

kr main.kr

プロジェクトを作る

Nodeプロジェクト

kr new my-app
cd my-app
kr run

Nativeプロジェクト

kr new native-app --target native
cd native-app
kr run

生成される構成

my-app/
├─ kura.toml
├─ package.json
├─ src/
│  └─ main.kr
└─ tests/
   └─ smoke.kr

既存フォルダをKuraプロジェクトにする場合は、そのフォルダ内でkr initを実行します。

CLIコマンド一覧

よく使うオプション

kr run --target node
kr run --target native
kr run --watch
kr build --release
kr build --emit-hir --emit-mir
kr build -o output
kr run --env PORT=3000
kr run main.kr -- first second third

kura.toml

[package]
name = "my-app"
version = "0.1.0"
edition = "2026"
entry = "src/main.kr"
source-root = "src"

[target]
default = "node"
out-dir = "build/node"
extension = ".mjs"

[runtime]
node-args = []

[dependencies]

target.defaultは既定ターゲットです。コマンドに--targetを指定すると、その実行だけ上書きできます。

複数ファイルとモジュール

src/math.kr

export fn add(left: i32, right: i32) -> i32 {
  return left + right;
}

src/main.kr

import { add } from "./math";

fn main() {
  println(add(20, 22));
}

Kuraは相対import先を再帰的に解決し、別ファイルで宣言された公開関数の引数型と戻り値型も検査します。

npmパッケージを使う

kr add express

import express from npm:"express";

Node Backendでは次の標準ESMへ変換されます。

import express from "express";

Node組み込みモジュール

import fs from kura:"fs";
import path from kura:"path";
import process from kura:"process";
import crypto from kura:"crypto";

変数と変更可能性

let language = "Kura";
let port: u16 = 3000;

let mut count = 0;
count = count + 1;

• letは不変です。
• let mutは変更可能です。
• 型を書かなければ初期値から推論します。
• 未初期化の変数を読み取ることはできません。

let value: i32;
println(value); // 初期化されていないためエラー

関数

fn add(left: i32, right: i32) -> i32 {
  return left + right;
}

値を返さない関数

fn show_message(message: String) {
  println(message);
}

公開関数

export fn calculate(value: i32) -> i32 {
  return value * 2;
}

呼び出し時には、引数の個数と型が一致していなければなりません。

条件分岐とループ

if / else

if score >= 80 {
  println("pass");
} else {
  println("retry");
}

while

let mut index = 0;
while index < 3 {
  println(index);
  index = index + 1;
}

ループ内ではbreakとcontinueを利用できます。

基本型

数値変換

危険な縮小変換は暗黙に行われません。

let large: i64 = 1000;
let small = large.try_as<i32>()?;

Null安全・Option・Result

通常のKura型にnullは入りません。値がない可能性はOption<T>で表します。

fn find_name(id: i32) -> Option<String> {
  if id == 1 {
    return Some("Kura");
  }
  return None;
}

Result

回復可能な失敗はResult<T, E>で返します。

fn load_config() -> Result<Config, ConfigError> {
  let text = fs.read_text("config.json")?;
  return json.decode<Config>(text);
}

?は失敗時にエラーを呼び出し元へ返します。

Struct

struct User {
  name: String,
  age: i32,
}

fn main() {
  let user = User {
    name: "Kura",
    age: 1,
  };

  println(user.name);
}

コンパイラは、不明なStruct、必須フィールド不足、不明なフィールド、重複、フィールド型不一致を検出します。

EnumとMatch

enum Status {
  Active,
  Suspended(String),
  Deleted { at: i32 },
}

fn describe(status: Status) -> String {
  return match status {
    Status::Active => "active",
    Status::Suspended(reason) => reason,
    Status::Deleted { at } => "deleted",
  };
}

matchは網羅的でなければなりません。扱っていないVariantがある場合はコンパイルエラーになります。

_は残りすべてに一致するワイルドカードです。

Generics

fn identity<T>(value: T) -> T {
  return value;
}

fn main() {
  let number = identity(42);
  let name = identity<String>("Kura");
}

型引数は明示できます。引数から判断できる場合は自動推論されます。

複数制約

fn show_sorted<T>(values: Vec<T>)
where T: Clone + Ord + Display {
  // ...
}

Trait

trait Display {
  fn display(self: &Self) -> String;
}

impl Display for User {
  fn display(self: &User) -> String {
    return self.name;
  }
}

Traitは、異なる型へ共通の能力を定義します。Generic関数のwhere制約として利用できます。

async / await

async fn load_number() -> i32 {
  return 42;
}

async fn main() {
  let value: i32 = await load_number();
  println(value);
}

• async fnの呼び出し結果はFuture<T>です。
• awaitすると中身の型Tを取り出せます。
• awaitはasync関数内で利用します。

所有権とMove

fn consume(value: String) {}

fn main() {
  let value = "Kura";
  consume(value);
  println(value); // Move後なのでエラー
}

非Copy値を値渡しすると、所有権が呼び出し先へ移動します。移動後の値は再利用できません。

Copy型

整数、浮動小数、bool、char、参照、およびすべての内部フィールドがCopyである型はコピーできます。

部分Move

Structの非Copyフィールドだけを移動すると、そのフィールドは使えなくなりますが、移動していない別フィールドは利用できます。

借用

let borrowed = &value;

let borrowed = &mut value;

同じ期間には、「複数の共有借用」または「1つの可変借用」のどちらかだけを持てます。

fn main() {
  let mut value = "first";

  {
    let borrowed = &value;
    println(borrowed);
  }

  value = "second";
}

Kura 0.4はレキシカルスコープを基準に借用期間を判定します。

SendとShare

StructとEnumは内部型から自動的にSend / Shareを導出します。

JsRef<T>、JsDynamic、Rc<T>などは原則としてSendではありません。

Node Backend

kr check --target node
kr build --target node
kr run --target node

向いている用途

• WebサーバーとAPI
• Discord Bot
• CLIと自動化
• npm中心のアプリ
• ネットワーク・非同期I/O

npm、Node API、Generics、Trait、async/await、データ付きEnum、Matchなどを利用できます。

LLVM Native Backend

kr check --target native
kr build --target native
kr build --target native --release
kr run --target native

LLVM IRを生成し、Clangを使ってOS向け実行ファイルへ変換します。

出力例

build/native/
├─ my-app.ll
├─ my-app.exe  # Windows
└─ .kura-build.json

別のClangを指定

KURA_CLANG=/path/to/clang kr build --target native

Node / Native対応機能

HIR / MIRを確認する

kr build --emit-hir --emit-mir
kr build --target native --emit-hir --emit-mir

コンパイラ内部の中間表現をJSONとして出力します。型解決、Borrow、Await、Match、TraitDispatch、分岐、Returnなどのlowering結果を確認できます。

テスト

kr test

標準では次のファイルを検出します。

tests/**/*.kr
src/**/*.test.kr

単純なテスト例

fn main() {
  let answer: i32 = 40 + 2;
  if answer != 42 {
    panic("test failed");
  }
  println("test passed");
}

整形・監視・キャッシュ

kr fmt
kr fmt --check
kr run --watch
kr clean

• fmtはコードを整形します。
• fmt --checkは変更せず差異だけ検査します。
• run --watchは変更時に再コンパイル・再実行します。
• cleanは生成物とキャッシュを削除します。

エラーの読み方

error K4102: use of moved value 'value'

利用者向けトラブル対処

現在の制限

Kura 0.4はブートストラップ段階です。Node Backendは実用範囲が広がっていますが、Native Backendには次の未対応があります。

• Native async runtime
• Generic関数のモノモーフィゼーション
• TraitのNativeディスパッチ
• データ付きEnumのLLVM表現
• Vec / Array / Optionの完全なNativeランタイム
• OSスレッド、Channel
• C FFI、SIMD

コマンド早見表

# 環境
kr version
kr doctor
kr help

# プロジェクト
kr new my-app
cd my-app
kr run

# 検査・ビルド
kr check
kr build
kr build --release
kr run --watch

# Native
kr check --target native
kr build --target native --release
kr run --target native

# 開発
kr test
kr fmt
kr fmt --check
kr clean

# npm
kr add express
kr remove express

# コンパイラ内部
kr build --emit-hir --emit-mir