Changelog

Copy Markdown View Source

All notable changes to mob_new (the project generator for Mob) are documented here.

Format: Keep a Changelog. Versioning: SemVer.

Full module documentation: hexdocs.pm/mob_new.

[0.3.8]

Added

  • project_swift_sources build hook on iOS templates. Both ios/build.zig.eex and ios/build_device.zig.eex now accept -Dproject_swift_sources=<absolute,paths> — a comma-separated list of extra Swift sources to compile into the same swiftc invocation as Mob's bridge sources. Empty/unset is a no-op. Paired with mob_dev's :project_swift_sources mob.exs key (mob_dev#6) so downstream apps can ship project Swift without patching the generator. Originally proposed by @dl-alexandre.

  • MobBridge.kt.eex: MobTextField now honours secure: true. Applies PasswordVisualTransformation() to mask input and overrides the keyboard type to KeyboardType.Password (autocorrect off, no suggestions strip). Mirrors the iOS-side secure prop landing in mob 0.6.x. The Elixir cleartext still reaches the BEAM via on_change so apps hash/store the value as normal.

    Existing apps generated from prior templates are unaffected — the prop is a no-op there. Regenerating or hand-porting MobBridge.kt enables masking.

[0.3.7]

Added

  • MaterialTheme follows BEAM-side Mob.Theme out of the box. Apps generated from mix mob.new now wire Compose's MaterialTheme to the BEAM-pushed theme so Material 3 system widgets (NavigationBar, Button, …) match whatever Mob.Theme.set(...) the host has active — no more white-on-light NavigationBar over a dark Obsidian / ObsidianGlass page. Two pieces:
    • MobBridge.kt: setTheme(json) JNI handler called by mob 0.6.14's new :mob_nif.set_theme/1. Decodes the resolved palette JSON into a mutableStateOf<Map<String, Long>?> (Compose-observable; cross-thread-safe via a main-looper hop).
    • MainActivity.kt: reads MobBridge.themeColors and builds darkColorScheme(...) from it. Mob's surface_raised / muted map onto Material 3's surfaceVariant / onSurfaceVariant (same role). Stock darkColorScheme() covers the brief gap between setContent and the BEAM's first theme push.
  • Requires mob ≥ 0.6.14. Older runtimes don't define the setTheme Bridge method or call the NIF, so MaterialTheme just stays on the fallback — no breakage, but the system widgets won't follow Mob.Theme.set/1.

[0.3.6]

Added

  • Mob.Camera.start_frame_stream/2 Android support baked into the template. Apps generated from mix mob.new now ship the Kotlin side (camera_start_frame_stream, camera_stop_frame_stream, deliverFrame, centerCropAndScale, bitmapToRgbF32, bitmapToBgraU8) plus the JNI thunk (nativeDeliverCameraFrame) wired through to mob_deliver_camera_frame. Prior to this, projects generated from mob_new ≤ 0.3.5 would fail at NIF load against mob ≥ 0.6.8 — the new JNI bindings for camera_start_frame_stream / camera_stop_frame_stream are cacheRequired, so missing static methods caused the app to crash on launch.
  • aspect_ratio modifier prop in nodeModifier (Android) — wraps Modifier.aspectRatio(r). Useful for locking camera + canvas overlays to a 1:1 square so model-space coordinates align with the visible preview area.

Fixed

  • MobCameraPreview Z-order and stability fixes so Compose overlays (status text, bounding boxes, etc.) drawn on top of the camera actually render:
    • Switched PreviewView from default ImplementationMode.PERFORMANCE (SurfaceView, punches through above Compose and hides overlays) to COMPATIBLE (TextureView, renders inside the normal Compose Z-order).
    • Moved the camera bind out of AndroidView.update (which re-runs on every recomposition and caused continual unbindAll / bindToLifecycle cycles whenever any sibling state ticked — e.g. an FPS counter — making the surface flicker and fight with overlays) into a LaunchedEffect(frameActive, cameraSelector) keyed only on values that should trigger a rebind.
    • Added Modifier.clipToBounds() to the AndroidView wrapping the PreviewView so the surface texture can't bleed past its declared layout bounds.
    • PreviewView.scaleType = FILL_CENTER to match the model-side center-crop in MobBridge.deliverFrame, so overlay-canvas coords align with the preview underneath.

[0.3.5]

Fixed

  • beam_jni.c.eex: restored the closing } for nativeDeliverVendorUsbEvent. Without it, clang sees nested function definitions and rejects every JNIEXPORT that follows ("function definition is not allowed here") — C compilation fails immediately on any project generated from 0.3.3/0.3.4.
  • MobBridge.kt.eex: removed three duplicate imports (IntentFilter, ConcurrentHashMap, AtomicInteger). Each now appears exactly once in the alphabetised bottom-of-file import block. kotlinc was rejecting with "Conflicting import" so gradleDebug failed on any project generated from 0.3.3/0.3.4.
  • beam_jni.c.eex: removed a 276-line duplicate Bluetooth Classic JNI block (lines 533-808 mirrored 256-531 verbatim). Caused "redefinition of Java_..._MobBridge_nativeDeliverBt*" errors at compile time. The canonical first block stays. (Surfaced by the new clang -fsyntax-only test below — string-match generator-test assertions still passed because the substrings exist, just twice.)

All three regressions were introduced by the 0.3.3 BT-PR merge taking the union of imports / blocks during conflict resolution, when the 0.3.2 fix had specifically de-duplicated them. Reported by external user on master 2026-05-17.

Added

  • MobNew.Templates.Lint — module of structural lints for generator-rendered native source files. 8 checks: balanced_braces, balanced_parens, balanced_brackets, no_eex_leaks, unique_kotlin_imports, unique_swift_imports, external_fun_jni_consistency, plus check_kotlin/1 / check_c/1 / check_swift/1 aggregate functions. Returns a list of issue maps; empty list = clean. 25 unit tests cover each check red-then-green.
  • Generator tests now use Lint.check_kotlin/1 and Lint.check_c/1 instead of inline brace-counting + import-dedup logic. Single source of truth; clearer failure messages.
  • New cross-file consistency test: asserts every external fun nativeFoo(...) in MobBridge.kt has a matching Java_..._MobBridge_nativeFoo(...) JNI thunk in beam_jni.c. Catches "added the Kotlin side but forgot the C thunk" (or the reverse).
  • New clang -fsyntax-only test (@tag :requires_android_ndk) that invokes the NDK's clang against the rendered beam_jni.c. Catches the full class of "actually broken C" — typos, wrong arg counts, duplicate definitions — that tier-1 structural lints can miss. Skips cleanly when the Android NDK isn't installed (mirrors the existing :requires_zig pattern).

[0.3.4]

Added

  • CLAUDE.md "Release flow" section pointing at the canonical process in mob/RELEASE.md (URL form so it resolves without a local mob checkout). mob_new specifics: generator tests need MOB_DIR=/Users/kevin/code/mob set when running from a worktree (the resolver looks for mob alongside the project and the worktree path breaks that assumption).
  • .githooks/pre-push — same script shipped in mob (cheap preflight always, release preflight when mix.exs changed). Activate per clone or worktree with git config core.hooksPath .githooks.

[0.3.3]

Added

  • Bluetooth Classic peripheral codegen (MobBridge.kt.eex, beam_jni.c.eex, AndroidManifest.xml.eex) — generated apps now include the Kotlin BroadcastReceivers, JNI native_* externs, and Android permissions for the Mob.Bt runtime API (HFP / SPP / HID). Companion to mob 0.6.5's Mob.Bt module. Contributed by @HeroesLament (#4).

[0.3.2]

Fixed

  • HexDocs source_url and source_url_pattern pointed at the wrong repo (mob instead of mob_new) and at a non-existent /mob_new/ subdirectory prefix; the rendered </> glyphs all 404'd. Corrected to github.com/genericjam/mob_new/blob/master/....
  • Template fix: beam_jni.c.eex was missing the closing } for nativeDeliverVendorUsbEvent before the BT JNI thunks began — every subsequent JNIEXPORT void JNICALL was rejected by clang with "function definition is not allowed here". Generator tests never caught this because they grep rendered output, not compile it.
  • Template fix: MobBridge.kt.eex duplicated three imports (IntentFilter, ConcurrentHashMap, AtomicInteger) alongside the BT Bluetooth* imports; kotlinc rejected with "Conflicting import".
  • Template fix: MobBridge.kt.eex missing androidx.compose.foundation.layout.fillMaxSize import for the GpuView compile-error overlay.
  • Template fix: orphan comment in the import block confused ktlint's import-ordering rule (no autocorrect available when imports are interleaved with comments).

Added

  • .github/workflows/test.yml — runs mix test, mix format --check-formatted, mix credo --strict, and mix deps.audit on push to master and on every PR.
  • .github/workflows/release.yml — on tag push, creates a GitHub Release whose body is the matching ## [X.Y.Z] section from this changelog.

[0.3.1]

Added

  • Bluetooth Classic template scaffolding: MobBridge.kt.eex gains the Kotlin BroadcastReceivers, external fun nativeDeliver* JNI declarations, and Compose wiring for the Mob.Bt runtime API (HFP / SPP / HID). AndroidManifest.xml.eex gains the matching modern + legacy Bluetooth permissions. beam_jni.c.eex gains the per-event JNI thunks. (Generator tests cover the rendered template's external strings; manual on-device verification per the CLAUDE.md convention.)
  • Mob.GpuView Android backend (GLES 3.0): MobBridge.kt.eex gains MobGpuView composable + MobGpuSurfaceView + MobGpuRenderer, mirroring the iOS MobGpuView.swift shipped in mob 0.6.4. Same %{ios: "...MSL...", android: "...GLSL ES..."} cross-platform shader contract; std140-ish uniform packing matches the iOS Swift packer (scalar/vec2/vec4 with natural alignment). Translucent red compile-error overlay on shader failure, matching iOS behavior.
  • Generator-test coverage for both surfaces — asserts the rendered template contains the expected composables, classes, imports, and dispatch entries.

[0.3.0] and earlier

Earlier releases predate this changelog; consult the tag list and the per-tag commit messages for history.