basic idea for C carts

Author: konsumer

.github/workflows/carts.yml

@@ -0,0 +1,16 @@
+on: push
+
+jobs:
+  build:
+    name: Build & Publish Cart
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build C colorbars cart
+        run: docker run -v ./carts/c/colorbars:/src -v .:/out konsumer/null0-cart-c colorbars_c
+      - name: Upload C colorbars cart artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: colorbars_c
+          path: colorbars_c.null0

.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+out/

README.md

@@ -0,0 +1,65 @@
+The idea here is a central place for some exmaple-carts for [null0](https://github.com/notnullgames/null0). I also use this as a central place to store docker containers for building them.
+
+- You will need docker installed to use these, which greatly simplifies your setup.
+- volume-mount your cart in `/src`
+- volume-mount your output-dir in `/out`
+- the first param is the name of the cart
+- put any filenames you don't want packaged in your cart, in `.cartignore` (.gitignore syntax)
+
+### available containers
+
+- `konsumer/null0-cart-c`
+- `konsumer/null0-cart-quickjs`
+- `konsumer/null0-cart-nelua`
+- `konsumer/null0-cart-assemblyscript`
+- `konsumer/null0-cart-nim`
+- `konsumer/null0-cart-zig`
+- `konsumer/null0-cart-rust`
+- `konsumer/null0-cart-py2wasm`
+
+### example usage
+
+```sh
+# build a cart from main.c (and assets) in current dir, output to ~/Desktop/tester.null0
+docker run -it -v .:/src -v ~/Desktop:/out konsumer/null0-cart-c tester
+```
+
+## usage in Github CI
+
+you can easily use it in Github Actions:
+
+```yml
+# github/workflows/publish.yml
+
+on: push
+
+jobs:
+  build:
+    name: Build & Publish Cart
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Build C Cart
+        run: docker run -v .:/src -v .:/out konsumer/null0-cart-c tester
+      - name: Upload cart artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: tester
+          path: tester.null0
+```
+
+## development
+
+This is really just notes for me:
+
+```sh
+# build
+docker build -t konsumer/null0-cart-c docker -f docker/null0-cart-c.Dockerfile
+
+# test
+docker run -it -v ./carts/c/colorbars:/src -v ./out:/out konsumer/null0-cart-c colorbars
+
+# publish
+docker push konsumer/null0-cart-c
+```

carts/c/colorbars/.cartignore

@@ -0,0 +1,2 @@
+*.c
+*.h

carts/c/colorbars/main.c

@@ -0,0 +1,56 @@
+#include "null0.h"
+
+int main() {
+  Color colors[26];
+
+  colors[0] = LIGHTGRAY;
+  colors[1] = GRAY;
+  colors[2] = DARKGRAY;
+  colors[3] = YELLOW;
+  colors[4] = GOLD;
+  colors[5] = ORANGE;
+  colors[6] = PINK;
+  colors[7] = RED;
+  colors[8] = MAROON;
+  colors[9] = GREEN;
+  colors[10] = LIME;
+  colors[11] = DARKGREEN;
+  colors[12] = BLANK;
+  colors[13] = SKYBLUE;
+  colors[14] = DARKBLUE;
+  colors[15] = PURPLE;
+  colors[16] = VIOLET;
+  colors[17] = DARKPURPLE;
+  colors[18] = BEIGE;
+  colors[19] = BROWN;
+  colors[20] = DARKBROWN;
+  colors[21] = WHITE;
+  colors[22] = BLACK;
+  colors[23] = BLUE;
+  colors[24] = MAGENTA;
+  colors[25] = RAYWHITE;
+
+  int margin = 10;
+  float bar_width = (SCREEN_WIDTH / (26.0 * 2)) + (margin / 4);
+  float bar_height = SCREEN_HEIGHT - (margin * 2.0);
+
+  // it doesn't change, so just draw it once
+
+  int d = SCREEN_HEIGHT / 4;
+  int i = 0;
+  while (d) {
+    draw_circle(SCREEN_WIDTH / 2, SCREEN_HEIGHT / 2, d -= bar_width, i++ % 2 ? WHITE : RED);
+  }
+
+  int x;
+  for (x = 0; x < 26; x++) {
+    draw_rectangle(margin + (x * (bar_width + margin)), margin, bar_width, bar_height, colors[x]);
+    if (x == 0) {
+      draw_rectangle_outline(margin + (x * (bar_width + margin)), margin, bar_width, bar_height, 1, WHITE);
+    } else {
+      draw_rectangle_outline(margin + (x * (bar_width + margin)), margin, bar_width, bar_height, 1, LIGHTGRAY);
+    }
+  }
+
+  return 0;
+}

docker/build_c.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# this will compile a C cart for null0
+
+# Check if all required arguments are provided
+if [ -z "${1}" ]; then
+    echo "Usage: $0 CART_NAME"
+    echo ""
+    echo "Arguments:"
+    echo "  CART_NAME  Name of the output cart (without .null0 extension)"
+    exit 1
+fi
+
+CART_NAME="${1}"
+
+export PATH="${PATH}:/opt/wasi-sdk/bin"
+
+echo "Compiling C cart from /src/ to /out/"
+clang --version
+
+mkdir -p "/tmp/${CART_NAME}"
+
+cp -R /src/* /src/.* "/tmp/${CART_NAME}/"
+cd "/tmp/${CART_NAME}/"
+clang -I /usr/local/include/ -o main.wasm main.c
+
+/usr/local/bin/zipcart.sh "${CART_NAME}" "/tmp/${CART_NAME}/" /out