Voice Mode SwiftUI Screen

The orb is a Metal kernel shipped as VoiceOrb.metal and drawn through colorEffect: a dark glass ball with four thin sine membranes (blue, pink, orange and red over a deep violet ground) travelling left to right through its equator, seen through a refracting shell with a white crest and a cool and warm rim. Its motion is locked to the thinking state. There is no phase, level or preset, and no gestures: the sphere never moves, scales or pulses, only the wave inside it. Colour is the one input, so the orb can show what a screen portrays; a palette change crossfades over 0.8 s. VoiceOrb.Pill is the same orb as a control: mark, label and four dots that pulse in turn, in a Material capsule that becomes a button when you pass an action.

Notes

• The whole API is VoiceOrb(size:palette:). The ball fills 90% of the square it draws in, so leave that margin in your layout.
• palette defaults to .siri (blue, pink, orange and red over violet). The Ember turn-taking set colours the orb for whoever holds the turn: .emberYourTurn (dusk blue), .emberListening (rose), .emberThinking (amber) and .emberSpeaking (persimmon). Build your own with VoiceOrb.Palette(bands:ground:crest:rimCool:rimWarm:) from hex or Color: four bands light to deep in one family, a dark ground, a white crest, and a lighter and a warmer rim tint.
• VoiceOrb.Pill(label:palette:markSize:showsDots:action:) defaults its label to "Thinking". The mark never moves; only the dots do.
• VoiceOrb.metal must be in the target's Compile Sources; the CLI installs it next to the Swift file. Its stitchable function is voiceOrbSiriWave and its helpers are file-local, so it can share a target with other orb kernels.
• The shader clock is relative to first appearance; passing timeIntervalSinceReferenceDate to a float uniform freezes the wave.
• Reduce Motion pauses the wave on a still frame and switches palettes without the crossfade; Reduce Transparency gives the pill an opaque surface. The orb is one VoiceOver element labelled Assistant with the value Thinking; the pill announces its label and hides the dots.
• The screen reads \.spTheme: the orb sits in a solid block inside thin static rings, the current turn is set as a giant display word cropped by the first transcript row, and the last two turns stack as overlapping color rows with the live line in a large serif. The word, meter, captions and the orb's colour follow the scripted call; the orb's motion stays on thinking. Rows have fixed heights, so words arriving never shift the layout.
• VoiceOrbExample (the earlier call screen) stays in the file for the AI Assistant template; VoiceOrbScreenExample above it is the Voice Mode screen from the preview.