v0.2.200: fix perry setup, add audio/camera docs

- Fix `perry setup` not saving to project perry.toml (auto-creates file
  if missing, for all 3 platform wizards)
- Add docs for audio capture API (perry/system) and camera API (perry/ui)
- Update system overview, UI overview, widgets page, and SUMMARY.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: proggeramlug

CLAUDE.md

@@ -8,7 +8,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Perry is a native TypeScript compiler written in Rust that compiles TypeScript source code directly to native executables. It uses SWC for TypeScript parsing and Cranelift for code generation.
 
-**Current Version:** 0.2.199
+**Current Version:** 0.2.200
 
 ## Workflow Requirements
 
@@ -153,6 +153,12 @@ Projects can list npm packages to compile natively instead of routing to V8. Con
 
 ## Recent Changes
 
+### v0.2.200
+- **Fix `perry setup` not saving to project perry.toml**: all 3 platform wizards (iOS, Android, macOS) silently skipped writing to `perry.toml` when the file didn't exist — now auto-creates it; also removed redundant `perry_toml_path.exists()` guards on encryption_exempt writes since the file is guaranteed to exist after creation
+- **Audio capture API (`perry/system`)**: `audioStart`, `audioStop`, `audioGetLevel` (dB(A)), `audioGetPeak`, `audioGetWaveformSamples`, `getDeviceModel` — all 6 platforms (macOS AVAudioEngine, iOS AVAudioSession, Android AudioRecord/JNI, Linux PulseAudio, Windows WASAPI, Web getUserMedia); A-weighted IIR filter, EMA smoothing, lock-free ring buffer
+- **Camera API (`perry/ui`, iOS only)**: `CameraView`, `cameraStart`/`Stop`/`Freeze`/`Unfreeze`, `cameraSampleColor(x,y)` (5x5 averaged pixel sampling from CVPixelBuffer), `cameraSetOnTap` — AVCaptureSession + AVCaptureVideoPreviewLayer with dynamic ObjC delegate
+- **Documentation**: new `docs/src/system/audio.md` and `docs/src/ui/camera.md`; updated system overview, UI overview, widgets page, and SUMMARY.md
+
 ### v0.2.199
 - **Fix `import * as X` namespace function calls**: `X.foo()` on namespace imports fell through to `js_native_call_method` fallback instead of using pre-declared scoped wrappers — intercept in `Call { PropertyGet { ExternFuncRef } }` path after class static method check; also handles exported closures via `js_closure_callN` fallback
 - **Fix ScrollView invisible inside ZStack**: ZStack's `add_child` (constraint-based) was dead code — `widgets::add_child` now detects ZStack parents via handle tracking and routes to `zstack::add_child`; also set `translatesAutoresizingMaskIntoConstraints: false` on NSScrollView for proper Auto Layout

Cargo.toml

@@ -79,7 +79,7 @@ opt-level = "s"       # Optimize for size in stdlib
 opt-level = 3
 
 [workspace.package]
-version = "0.2.199"
+version = "0.2.200"
 edition = "2021"
 license = "MIT"
 repository = "https://github.com/PerryTS/perry"

crates/perry/src/commands/setup.rs

@@ -221,29 +221,25 @@ pub(crate) fn android_wizard(saved: &mut PerryConfig) -> Result<()> {
 
     // Update project perry.toml with distribute = "playstore"
     let perry_toml_path = std::env::current_dir()?.join("perry.toml");
-    if perry_toml_path.exists() {
-        let gp_key = saved.android.as_ref().and_then(|a| a.google_play_key_path.as_deref());
-        match update_perry_toml_android(&perry_toml_path, &keystore_path, &key_alias, gp_key) {
-            Ok(()) => {
-                println!();
-                println!(
-                    "  {} Updated perry.toml with [android] settings",
-                    style("✓").green()
-                );
-            }
-            Err(e) => {
-                println!();
-                println!("  {} Could not update perry.toml: {e}", style("!").yellow());
-                println!("  Add these manually to your perry.toml [android] section:");
-                println!("    distribute = \"playstore\"");
-            }
+    // Create perry.toml if it doesn't exist — project-specific config belongs here
+    if !perry_toml_path.exists() {
+        std::fs::write(&perry_toml_path, "")?;
+    }
+    let gp_key = saved.android.as_ref().and_then(|a| a.google_play_key_path.as_deref());
+    match update_perry_toml_android(&perry_toml_path, &keystore_path, &key_alias, gp_key) {
+        Ok(()) => {
+            println!();
+            println!(
+                "  {} Updated perry.toml with [android] settings",
+                style("✓").green()
+            );
+        }
+        Err(e) => {
+            println!();
+            println!("  {} Could not update perry.toml: {e}", style("!").yellow());
+            println!("  Add these manually to your perry.toml [android] section:");
+            println!("    distribute = \"playstore\"");
         }
-    } else {
-        println!();
-        println!("  Add to your perry.toml:");
-        println!();
-        println!("  {}", style("[android]").cyan());
-        println!("  distribute = \"playstore\"");
     }
 
     println!();
@@ -802,28 +798,26 @@ pub(crate) fn ios_wizard(saved: &mut PerryConfig) -> Result<()> {
     let p12_str = p12_path.to_string_lossy().to_string();
     let profile_str = profile_path.to_string_lossy().to_string();
 
-    if perry_toml_path.exists() {
-        match update_perry_toml_ios(
-            &perry_toml_path,
-            &p12_str,
-            &profile_str,
-            created_signing_identity.as_deref(),
-        ) {
-            Ok(()) => {
-                println!("  {} Project credentials saved to {}", style("✓").green().bold(),
-                    style(perry_toml_path.display()).dim());
-            }
-            Err(e) => {
-                println!("  {} Could not update perry.toml: {e}", style("!").yellow());
-                println!("  Add these manually to your perry.toml [ios] section:");
-                println!("  certificate = \"{}\"", p12_str);
-                println!("  provisioning_profile = \"{}\"", profile_str);
-            }
+    // Create perry.toml if it doesn't exist — project-specific config belongs here
+    if !perry_toml_path.exists() {
+        std::fs::write(&perry_toml_path, "")?;
+    }
+    match update_perry_toml_ios(
+        &perry_toml_path,
+        &p12_str,
+        &profile_str,
+        created_signing_identity.as_deref(),
+    ) {
+        Ok(()) => {
+            println!("  {} Project credentials saved to {}", style("✓").green().bold(),
+                style(perry_toml_path.display()).dim());
+        }
+        Err(e) => {
+            println!("  {} Could not update perry.toml: {e}", style("!").yellow());
+            println!("  Add these manually to your perry.toml [ios] section:");
+            println!("  certificate = \"{}\"", p12_str);
+            println!("  provisioning_profile = \"{}\"", profile_str);
         }
-    } else {
-        println!("  Add these to your perry.toml [ios] section:");
-        println!("  certificate = \"{}\"", p12_str);
-        println!("  provisioning_profile = \"{}\"", profile_str);
     }
     // --- Export compliance ---
     println!("  {} Export Compliance", style("→").cyan().bold());
@@ -832,14 +826,9 @@ pub(crate) fn ios_wizard(saved: &mut PerryConfig) -> Result<()> {
         .with_prompt("  Does your app ONLY use standard HTTPS? (no custom encryption)")
         .default(true)
         .interact()?;
-    if perry_toml_path.exists() {
-        if let Err(e) = update_perry_toml_encryption_exempt(&perry_toml_path, encryption_exempt) {
-            println!("  {} Could not update perry.toml: {e}", style("!").yellow());
-            println!("  Add manually to [ios]: encryption_exempt = {encryption_exempt}");
-        }
-    } else {
-        println!("  Add to your perry.toml [ios] section:");
-        println!("  encryption_exempt = {encryption_exempt}");
+    if let Err(e) = update_perry_toml_encryption_exempt(&perry_toml_path, encryption_exempt) {
+        println!("  {} Could not update perry.toml: {e}", style("!").yellow());
+        println!("  Add manually to [ios]: encryption_exempt = {encryption_exempt}");
     }
     println!();
 
@@ -1118,45 +1107,32 @@ pub(crate) fn macos_wizard(saved: &mut PerryConfig) -> Result<()> {
 
     // --- Save project-specific credentials to perry.toml ---
     let perry_toml_path = std::env::current_dir()?.join("perry.toml");
-    if perry_toml_path.exists() {
-        match update_perry_toml_macos(
-            &perry_toml_path,
-            distribute_value,
-            &cert_path,
-            if signing_identity.is_empty() { None } else { Some(&signing_identity) },
-            if distribute_value == "both" { Some(&notarize_cert_path) } else { None },
-            if distribute_value == "both" && !notarize_signing_identity.is_empty() {
-                Some(&notarize_signing_identity)
-            } else {
-                None
-            },
-            installer_cert_path.as_deref(),
-        ) {
-            Ok(()) => {
-                println!("  {} macOS credentials saved to {}", style("✓").green().bold(),
-                    style(perry_toml_path.display()).dim());
-            }
-            Err(e) => {
-                println!("  {} Could not update perry.toml: {e}", style("!").yellow());
-                println!("  Add these manually to your perry.toml [macos] section:");
-                println!("  distribute = \"{distribute_value}\"");
-                println!("  certificate = \"{}\"", cert_path);
-            }
-        }
-    } else {
-        println!("  Add to your perry.toml:");
-        println!();
-        println!("  {}", style("[macos]").cyan());
-        println!("  distribute = \"{distribute_value}\"");
-        println!("  certificate = \"{}\"", cert_path);
-        if !signing_identity.is_empty() {
-            println!("  signing_identity = \"{}\"", signing_identity);
+    // Create perry.toml if it doesn't exist — project-specific config belongs here
+    if !perry_toml_path.exists() {
+        std::fs::write(&perry_toml_path, "")?;
+    }
+    match update_perry_toml_macos(
+        &perry_toml_path,
+        distribute_value,
+        &cert_path,
+        if signing_identity.is_empty() { None } else { Some(&signing_identity) },
+        if distribute_value == "both" { Some(&notarize_cert_path) } else { None },
+        if distribute_value == "both" && !notarize_signing_identity.is_empty() {
+            Some(&notarize_signing_identity)
+        } else {
+            None
+        },
+        installer_cert_path.as_deref(),
+    ) {
+        Ok(()) => {
+            println!("  {} macOS credentials saved to {}", style("✓").green().bold(),
+                style(perry_toml_path.display()).dim());
         }
-        if distribute_value == "both" {
-            println!("  notarize_certificate = \"{}\"", notarize_cert_path);
-            if !notarize_signing_identity.is_empty() {
-                println!("  notarize_signing_identity = \"{}\"", notarize_signing_identity);
-            }
+        Err(e) => {
+            println!("  {} Could not update perry.toml: {e}", style("!").yellow());
+            println!("  Add these manually to your perry.toml [macos] section:");
+            println!("  distribute = \"{distribute_value}\"");
+            println!("  certificate = \"{}\"", cert_path);
         }
     }
 
@@ -1169,14 +1145,9 @@ pub(crate) fn macos_wizard(saved: &mut PerryConfig) -> Result<()> {
             .with_prompt("  Does your app ONLY use standard HTTPS? (no custom encryption)")
             .default(true)
             .interact()?;
-        if perry_toml_path.exists() {
-            if let Err(e) = update_perry_toml_section_bool(&perry_toml_path, "macos", "encryption_exempt", encryption_exempt) {
-                println!("  {} Could not update perry.toml: {e}", style("!").yellow());
-                println!("  Add manually to [macos]: encryption_exempt = {encryption_exempt}");
-            }
-        } else {
-            println!("  Add to your perry.toml [macos] section:");
-            println!("  encryption_exempt = {encryption_exempt}");
+        if let Err(e) = update_perry_toml_section_bool(&perry_toml_path, "macos", "encryption_exempt", encryption_exempt) {
+            println!("  {} Could not update perry.toml: {e}", style("!").yellow());
+            println!("  Add manually to [macos]: encryption_exempt = {encryption_exempt}");
         }
     }
     println!();

docs/src/SUMMARY.md

@@ -32,6 +32,7 @@
 - [Animation](ui/animation.md)
 - [Multi-Window](ui/multi-window.md)
 - [Theming](ui/theming.md)
+- [Camera](ui/camera.md)
 
 # Platforms
 
@@ -60,6 +61,7 @@
 - [Preferences](system/preferences.md)
 - [Keychain](system/keychain.md)
 - [Notifications](system/notifications.md)
+- [Audio Capture](system/audio.md)
 - [Other](system/other.md)
 
 # Widgets

docs/src/system/audio.md

@@ -0,0 +1,112 @@
+# Audio Capture
+
+The `perry/system` module provides real-time audio capture from the device microphone, with A-weighted dB(A) level metering and waveform sampling — everything needed to build a sound meter, audio visualizer, or voice-level indicator.
+
+```typescript
+import { audioStart, audioStop, audioGetLevel, audioGetPeak, audioGetWaveformSamples } from "perry/system";
+```
+
+## Quick Example
+
+```typescript
+import { App, Text, VStack, State, Canvas } from "perry/ui";
+import { audioStart, audioStop, audioGetLevel, audioGetPeak, audioGetWaveformSamples } from "perry/system";
+
+audioStart();
+
+App("Sound Meter", () => {
+  const db = State(0);
+
+  // Poll the level every 100ms
+  setInterval(() => {
+    db.set(audioGetLevel());
+  }, 100);
+
+  return VStack([
+    Text(`${db.get()} dB`),
+  ]);
+});
+```
+
+## API Reference
+
+### `audioStart()`
+
+Start capturing audio from the device microphone.
+
+```typescript
+const ok = audioStart(); // 1 = success, 0 = failure
+```
+
+On platforms that require permission (iOS, Android, Web), the system permission dialog is shown automatically. Returns `1` on success, `0` on failure (e.g., permission denied, no microphone).
+
+### `audioStop()`
+
+Stop audio capture and release the microphone.
+
+```typescript
+audioStop();
+```
+
+### `audioGetLevel()`
+
+Get the current A-weighted sound level in dB(A).
+
+```typescript
+const db = audioGetLevel(); // e.g. 45.2
+```
+
+Returns a smoothed dB(A) value (EMA with 125ms time constant). Typical ranges:
+- ~30 dB — quiet room
+- ~50 dB — normal conversation
+- ~70 dB — busy street
+- ~90 dB — loud music
+- ~110+ dB — dangerously loud
+
+### `audioGetPeak()`
+
+Get the current peak sample amplitude.
+
+```typescript
+const peak = audioGetPeak(); // 0.0 to 1.0
+```
+
+Returns a normalized amplitude value (0.0 = silence, 1.0 = clipping). Useful for simple level indicators without dB conversion.
+
+### `audioGetWaveformSamples(count)`
+
+Get recent dB samples for waveform visualization.
+
+```typescript
+const samples = audioGetWaveformSamples(64); // array of up to 64 dB values
+```
+
+Returns an array of recent dB(A) readings from a 256-sample ring buffer. Pass the number of samples you want (max 256). Useful for drawing waveform displays or level history charts.
+
+### `getDeviceModel()`
+
+Get the device model identifier.
+
+```typescript
+import { getDeviceModel } from "perry/system";
+
+const model = getDeviceModel(); // e.g. "MacBookPro18,3", "iPhone15,2"
+```
+
+## Platform Implementations
+
+| Platform | Audio Backend | Permissions |
+|----------|--------------|-------------|
+| macOS | AVAudioEngine | Microphone permission dialog |
+| iOS | AVAudioSession + AVAudioEngine | System permission dialog |
+| Android | AudioRecord (JNI) | RECORD_AUDIO permission |
+| Linux | PulseAudio (libpulse-simple) | None (system-level) |
+| Windows | WASAPI (shared mode) | None |
+| Web | getUserMedia + AnalyserNode | Browser permission dialog |
+
+All platforms capture at 48kHz mono and apply the same A-weighting filter (IEC 61672 standard, 3 cascaded biquad sections).
+
+## Next Steps
+
+- [Camera](../ui/camera.md) — Live camera preview (iOS)
+- [Overview](overview.md) — All system APIs

docs/src/system/overview.md

@@ -3,7 +3,7 @@
 The `perry/system` module provides access to platform-native system features: preferences, secure storage, notifications, URL opening, and dark mode detection.
 
 ```typescript
-import { openURL, isDarkMode, preferencesSet, preferencesGet } from "perry/system";
+import { openURL, isDarkMode, preferencesSet, preferencesGet, audioStart, audioGetLevel } from "perry/system";
 ```
 
 ## Available APIs
@@ -19,6 +19,12 @@ import { openURL, isDarkMode, preferencesSet, preferencesGet } from "perry/syste
 | `sendNotification(title, body)` | Local notification | All |
 | `clipboardGet()` | Read clipboard | All |
 | `clipboardSet(text)` | Write clipboard | All |
+| `audioStart()` | Start microphone capture | All |
+| `audioStop()` | Stop microphone capture | All |
+| `audioGetLevel()` | Current dB(A) sound level | All |
+| `audioGetPeak()` | Current peak amplitude (0–1) | All |
+| `audioGetWaveformSamples(n)` | Recent dB samples for visualization | All |
+| `getDeviceModel()` | Device model identifier | All |
 
 ## Quick Example
 
@@ -43,4 +49,5 @@ openURL("https://example.com");
 - [Preferences](preferences.md)
 - [Keychain](keychain.md)
 - [Notifications](notifications.md)
+- [Audio Capture](audio.md)
 - [Other](other.md)