chore: initial boilerplate

Signed-off-by: Henry <mail@henrygressmann.de>

Author: explodingcamera

.gitignore

@@ -4,6 +4,7 @@ examples/*/out/*
 examples/*/target
 examples/*/Cargo.lock
 examples/doom/upstream/
+crates/c-api/dist
 *.wad
 *.WAD
 examples/wast/*

Cargo.lock

@@ -8,6 +8,7 @@ tinywasm-parser={version="0.9.0-alpha.1", path="crates/parser", default-features
 tinywasm-types={version="0.9.0-alpha.1", path="crates/types", default-features=false}
 tinywasm-cli={version="0.9.0-alpha.1", path="crates/cli", default-features=false}
 tinywasm={version="0.9.0-alpha.1", path="crates/tinywasm", default-features=false}
+tinywasm-c-api={version="0.9.0-alpha.1", path="crates/c-api", default-features=false}
 
 criterion={version="0.8", default-features=false, features=["cargo_bench_support", "rayon"]}
 eyre="0.6"

Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name="tinywasm-c-api"
+version.workspace=true
+description="C API bindings for TinyWasm"
+edition.workspace=true
+license.workspace=true
+authors.workspace=true
+repository.workspace=true
+rust-version.workspace=true
+keywords.workspace=true
+categories.workspace=true
+readme="README.md"
+
+[lib]
+name="tinywasm_c_api"
+path="src/lib.rs"
+crate-type=["rlib", "staticlib", "cdylib"]

crates/c-api/Cargo.toml

@@ -0,0 +1,47 @@
+PACKAGE := tinywasm-c-api
+LIB_BASENAME := tinywasm_c_api
+RUST_TARGET ?= $(shell rustc -vV | sed -n 's/^host: //p')
+
+DIST_DIR := dist/$(RUST_TARGET)
+DIST_INCLUDE_DIR := $(DIST_DIR)/include
+DIST_LIB_DIR := $(DIST_DIR)/lib
+CARGO_BUILD_ARGS := -p $(PACKAGE) --release --target $(RUST_TARGET)
+TARGET_DIR := ../../target/$(RUST_TARGET)/release
+
+ifneq (,$(findstring windows,$(RUST_TARGET)))
+STATIC_SRC := $(LIB_BASENAME).lib
+STATIC_DST := tinywasm.lib
+DYNAMIC_SRC := $(LIB_BASENAME).dll
+DYNAMIC_DST := tinywasm.dll
+else ifneq (,$(findstring apple,$(RUST_TARGET)))
+STATIC_SRC := lib$(LIB_BASENAME).a
+STATIC_DST := libtinywasm.a
+DYNAMIC_SRC := lib$(LIB_BASENAME).dylib
+DYNAMIC_DST := libtinywasm.dylib
+else
+STATIC_SRC := lib$(LIB_BASENAME).a
+STATIC_DST := libtinywasm.a
+DYNAMIC_SRC := lib$(LIB_BASENAME).so
+DYNAMIC_DST := libtinywasm.so
+endif
+
+.PHONY: all header static dynamic clean update-header
+
+all: header static dynamic
+
+header:
+	@mkdir -p "$(DIST_INCLUDE_DIR)"
+	cp include/wasm.h "$(DIST_INCLUDE_DIR)/wasm.h"
+
+static:
+	cargo build $(CARGO_BUILD_ARGS)
+	@mkdir -p "$(DIST_LIB_DIR)"
+	cp "$(TARGET_DIR)/$(STATIC_SRC)" "$(DIST_LIB_DIR)/$(STATIC_DST)"
+
+dynamic:
+	cargo build $(CARGO_BUILD_ARGS)
+	@mkdir -p "$(DIST_LIB_DIR)"
+	cp "$(TARGET_DIR)/$(DYNAMIC_SRC)" "$(DIST_LIB_DIR)/$(DYNAMIC_DST)"
+
+clean:
+	rm -rf "$(DIST_DIR)"

crates/c-api/Makefile

@@ -0,0 +1,26 @@
+# `tinywasm-c-api`
+
+This crate will expose the C API surface for TinyWasm.
+
+It is currently a placeholder crate that exists to reserve the package name and workspace layout.
+
+## Artifacts
+
+For now, this crate only provides boilerplate packaging for future C consumers:
+
+- a vendored upstream-compatible public header at `include/wasm.h`
+- a `Makefile` that builds the Rust crate and stages C-facing artifacts in `dist/`
+
+Build the staged artifacts with the host Rust target:
+
+```sh
+make -C crates/c-api
+```
+
+Artifacts are staged under `dist/<target>/`.
+
+Override the target triple when needed:
+
+```sh
+make -C crates/c-api RUST_TARGET=aarch64-apple-darwin
+```