@craft-native/ios 0.0.368 → 0.0.374

package/README.md

@@ -7,6 +7,22 @@ services as well as new advertisements. A watch connected through another app ca
 therefore appear without changing its system pairing. Discovery still requires
 Bluetooth permission and does not prove that the device accepts the app's protocol.
 
+## Compact tab accessories
+
+Native and hybrid tab bars stay expanded while scrolling. An accessory can use
+`iconOnly: true` for a 48-point trailing button above the tabs:
+
+```ts
+craft.navigation.setOptions({
+  tabAccessory: { path: '/messages', title: 'Messages', symbol: 'message', iconOnly: true, badge: '3' },
+})
+```
+
+The title remains its accessible name, the badge announces the unread count,
+and the screen's bottom safe area reserves room for the button. Set
+`tabAccessory: null` to remove it. Accessories without `iconOnly` keep the
+system's standard presentation. Removing an accessory keeps all tabs expanded.
+
 ## Native celebration
 
 Any native `View` may opt into a finite card entrance, light sweep and confetti
@@ -384,8 +400,15 @@ the screen locked; a sleep timer then fades it out on the audio clock. Turn it
 on only for an app that plays sound people listen to: App Review checks.
 
 Purpose strings in your own words, by Info.plist key (each replaces Craft's
-generic sentence; the keys for frameworks the shell links are always written,
-since App Store Connect checks the binary):
+generic sentence). Permission-bearing implementations and their purpose strings
+are compiled in only when their corresponding `enable*` flags require them;
+a nonblank custom purpose string is still
+honored even when that feature is disabled. A custom string does not enable the
+implementation. Regenerate the Xcode project after changing build-time feature
+flags. Speech also needs the microphone; video recording needs camera,
+microphone and photos; heart-rate uses Bluetooth; background location needs
+location. File selection through the system photo picker does not enable
+full photo-library access. App Store Connect checks the binary, not just config:
 
 ```json
 {
@@ -395,6 +418,29 @@ since App Store Connect checks the binary):
 }
 ```
 
+With recognition compiled out, `stopListening` still acknowledges the stop and
+emits `craftSpeechEnd`. The Zig runtime handles that idempotent cleanup without
+linking Speech or microphone APIs; starting recognition remains disabled.
+
+For an opt-in Zig runtime built specifically for the app, set
+`CRAFT_IOS_RUNTIME_SOURCE` to an explicit Craft Zig source-package directory
+(the directory containing `build.zig` and `build.zig.zon`) and `CRAFT_ZIG` to
+the pinned compiler executable. `init` and subsequent `build` calls compile
+device and both simulator archives from the app's `enable*` flags. The
+programmatic equivalent is `runtimeSource` on `init`/`build`; do not combine it
+with `runtimeDir`. Ordinary apps still require no Zig runtime or compiler.
+Per-app builds check the compiler version, permission mask, and archive hashes
+before installation. A failed compile leaves the installed runtime in place.
+The source location is retained under `Runtime/`, not bundled as app config.
+Changing permission flags requires rebuilding the runtime. Builds and shell
+restoration bake permission gates into generated Swift and synchronize managed
+usage descriptions, including in existing Xcode projects. Restoration refuses
+a mismatched runtime instead of removing purpose strings from an unsafe binary.
+Legacy unprofiled archives must be rebuilt through `runtimeSource`; manual
+`runtimeDir` installs require a matching `ios-permissions.json` with SHA-256
+identities for every supplied archive. No compiler, source checkout, or runtime
+directory is guessed. These checks do not replace signed App Store validation.
+
 Appearance and navigation:
 
 ```json
@@ -1347,7 +1393,6 @@ without an extra dependency. Omitting presentationStyle keeps the existing
 full-screen overlay. A native sheet's close request still belongs to its
 owner, which sets visible to false.
 
-
 ### Controlled native paging and font families
 
 A horizontal `ScrollView` with `pagingEnabled: true` and a numeric `pageIndex`