AC Native: Self-Contained Web Pieces — Full Mapping#

Every .mjs piece in disks/ with zero imports and no special system mode, evaluated against the AC Native runtime API surface.

Native API Status (after clock.mjs patches)#

Available: wipe(r,g,b), wipe("name"), ink(r,g,b,a), ink("name"), ink().write/line/box/circle/plot chaining, write(text, {x,y,size,center,font}), line(x0,y0,x1,y1), box(x,y,w,h,mode), circle(x,y,r,filled), plot(x,y), scroll(dx,dy), blur(n), zoom(n), contrast(n), spin(rad), qr(text,x,y,s), painting(w,h,cb), screen.width/height, params, colon, sound.synth({...}) with .kill() and .update(), sound.kill(id,fade), sound.speaker.waveforms/amplitudes/poll(), sound.bpm (read-only property), clock.time() (Date), clock.resync(), event.is("..."), e.key, e.x/y, num.clamp/rand/randIntRange/lerp/map/dist/floor/ceil/round/abs/sign/shiftRGB, performance.now(), system.jump(), system.listPieces(), paintCount, simCount, store (stubs), net (stubs), hud (stub), ui.Button (stub constructor)

Not available: num.randInt, num.randIntArr, num.radians, num.hslToRgb, num.rgbToHsl, num.parseColor, num.arrMax, num.p2.*, help.choose, help.repeat, help.resampleArray, lineAngle, poly, shape, stamp, mask/unmask, paste, page, cursor(), resize(), resolution(), fps(), geo.*, gizmo.*, text.box(), sound.bpm() (as function), sound.paint.*, sound.progress(), needsPaint(), noise16*, pen.drawing/dragBox, system.nopaint, DOM/window/document

GREEN: Works Now (0 runtime changes needed)#

Total: 16 pieces ready to ship.

YELLOW: Needs num Helpers (~20 LOC C each)#

num.randInt(max) — return Math.floor(Math.random() * (max + 1))#

num.randIntArr(max, count) — returns array of N random ints#

num.hslToRgb(h, s, l) — color space conversion#

num.radians(deg) — deg * Math.PI / 180#

help.choose(...items) — pick random element from args#

help.repeat(n, fn) — call fn N times#

(Already used by spline.mjs which has imports — no standalone pieces need this alone.)

Implementation path#

// In js-bindings.c, add to num object setup:
// num.randInt(max) — random int from 0..max inclusive
static JSValue js_num_randint_single(JSContext *ctx, JSValueConst this_val, int argc, JSValueConst *argv) {
    (void)this_val;
    if (argc < 1) return JS_NewInt32(ctx, 0);
    int max; JS_ToInt32(ctx, &max, argv[0]);
    return JS_NewInt32(ctx, rand() % (max + 1));
}

// num.randIntArr(max, count) — array of random ints
static JSValue js_num_randintarr(JSContext *ctx, JSValueConst this_val, int argc, JSValueConst *argv) {
    (void)this_val;
    if (argc < 2) return JS_NewArray(ctx);
    int max, count; JS_ToInt32(ctx, &max, argv[0]); JS_ToInt32(ctx, &count, argv[1]);
    JSValue arr = JS_NewArray(ctx);
    for (int i = 0; i < count; i++)
        JS_SetPropertyUint32(ctx, arr, i, JS_NewInt32(ctx, rand() % (max + 1)));
    return arr;
}

// num.radians(deg)
// Can be done in JS shim: "num.radians = function(d) { return d * Math.PI / 180; }"

// num.hslToRgb(h, s, l) — standard HSL to RGB
// ~30 lines of C or inject as JS shim

// help.choose(...args) — random pick
// Can be done in JS shim: "help.choose = function() { return arguments[Math.floor(Math.random() * arguments.length)]; }"

Total: ~60 LOC unlocks 7 more pieces.

ORANGE: Needs sound.bpm() as Function + lineAngle#

sound.bpm(val) — set BPM, return current#

Currently sound.bpm is a read-only float. Pieces call sound.bpm(120) to set it. Fix: replace with a function that updates audio->bpm and returns the current value.

lineAngle(x, y, length, angle_deg) — draw line at angle#

Used by metronome for pendulum animation.

tone.mjs is particularly interesting — the core synth works now (duration "🔁" = infinity is already handled), .kill() and .update() are fixed. The sound.paint.waveform call is guarded. It would play tones correctly, just no waveform visualization.

Total: ~40 LOC unlocks 2 more pieces.

BLUE: Needs shape() / poly() / stamp()#

shape(points) — fill a polygon from array of [x,y] pairs#

stamp(painting, x, y) — blit a painting buffer onto screen#

Implementation: shape() is a polygon fill — moderate effort (~80 LOC in graph.c). stamp() is a framebuffer blit — also moderate (~40 LOC).

PURPLE: Interesting but Complex#

These have zero blockers in the scan but use APIs in ways that need verification.

Implementation Priority Path#

Wave 1: Ship Now (16 pieces, 0 work)#

3x3  404  beat  brick-breaker  dync  error  gostop  hop
shh  doodle  f3ral3xp  hha  hw  keys  multipen  ptt

Wave 2: num Helpers (~60 LOC C)#

Add num.randInt, num.randIntArr, num.radians, num.hslToRgb, help.choose.

sprinkles  starfield  rainbow-x  squaresong  metaballs  triquilt(partial)

+6 pieces = 22 total

Wave 3: Sound Functions (~40 LOC C)#

Add sound.bpm() as callable, lineAngle().

metronome  tone

+2 pieces = 24 total

Wave 4: Polygon + Blit (~120 LOC C)#

Add shape(points), stamp(painting, x, y).

triquilt  cards  ant  flap

+4 pieces = 28 total

Wave 5: Screen Pixels + Advanced (~100 LOC C)#

Expose screen.pixels as writable buffer, add text.box().

butterflies  chord  morpho

+3 pieces = 31 total

Build Script Addition#

To bundle all Wave 1 pieces, add to build-and-flash.sh:

# Copy web pieces that run unmodified on native
AC_DISKS_DIR="${NATIVE_DIR}/../../system/public/aesthetic.computer/disks"
for web_piece in clock.mjs 3x3.mjs 404.mjs beat.mjs brick-breaker.mjs \
    dync.mjs error.mjs gostop.mjs hop.mjs shh.mjs doodle.mjs \
    f3ral3xp.mjs hha.mjs hw.mjs keys.mjs multipen.mjs ptt.mjs; do
    if [ -f "${AC_DISKS_DIR}/${web_piece}" ]; then
        cp "${AC_DISKS_DIR}/${web_piece}" "${INITRAMFS_DIR}/pieces/"
    fi
done

Summary#

31 web pieces running unmodified on AC Native with ~320 total lines of C.