claude-code-tools 1.19.6__tar.gz → 1.19.7__tar.gz

{claude_code_tools-1.19.6 → claude_code_tools-1.19.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-tools
-Version: 1.19.6
+Version: 1.19.7
 Summary: Collection of tools for working with Claude Code
 License-File: LICENSE
 Requires-Python: >=3.11

{claude_code_tools-1.19.6 → claude_code_tools-1.19.7}/claude_code_tools/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Tools - Collection of utilities for Claude Code."""
 
-__version__ = "1.19.6"
+__version__ = "1.19.7"

{claude_code_tools-1.19.6 → claude_code_tools-1.19.7}/claude_code_tools/voice_type/app.py

@@ -536,7 +536,11 @@ class VoiceTypeApp:
                     return state.value, state is State.ACTIVE, level
 
                 overlay.run_overlay(
-                    sample, tick, self._stop.is_set
+                    sample,
+                    tick,
+                    self._stop.is_set,
+                    flex=self.cfg.overlay_flex,
+                    speed=self.cfg.overlay_speed,
                 )
                 return result["code"]
             self._status("overlay unavailable; running without it")

{claude_code_tools-1.19.6 → claude_code_tools-1.19.7}/claude_code_tools/voice_type/config.py

@@ -55,9 +55,13 @@ class Config:
             fastest for v3-int8 on Apple Silicon; 8 helps v2-fp16).
         strip_fillers: Drop standalone filler words (uh, um, ...) from
             typed text.
-        overlay: Show the floating waveform pill while recording
-            (macOS only; ignored elsewhere). The pill is hidden while
+        overlay: Show the floating ghost indicator while recording
+            (macOS only; ignored elsewhere). The ghost is hidden while
             paused/passive — its presence IS the recording indicator.
+        overlay_flex: How much the ghost's face flexes/wobbles its
+            shape (1.0 = default; higher = more flexible, calmer < 1.0).
+        overlay_speed: Overall animation speed multiplier (1.0 =
+            default; lower = slower/gentler motion).
         model_arch: Moonshine model architecture name (moonshine engine
             only).
         language: Language tag understood by Moonshine (e.g. "en").
@@ -98,6 +102,8 @@ class Config:
     mlx_model: str = "mlx-community/parakeet-tdt-0.6b-v3"
     strip_fillers: bool = True
     overlay: bool = True
+    overlay_flex: float = 1.0
+    overlay_speed: float = 1.0
     model_arch: str = "medium-streaming"
     language: str = "en"
     hotkey: str = "<ctrl>+;"
@@ -181,6 +187,16 @@ class Config:
                 raise ValueError(
                     f"{name} must be a string, got {value!r}"
                 )
+        for name in ("overlay_flex", "overlay_speed"):
+            value = getattr(self, name)
+            if isinstance(value, bool) or not isinstance(
+                value, (int, float)
+            ):
+                raise ValueError(f"{name} must be a number, got {value!r}")
+            if not 0.0 <= value <= 5.0:
+                raise ValueError(
+                    f"{name} must be between 0 and 5, got {value!r}"
+                )
         if self.mode == "wake" and not self.wake_word.strip():
             raise ValueError('mode "wake" requires a non-empty wake_word')
         if isinstance(self.idle_timeout, bool) or not isinstance(
@@ -304,10 +320,14 @@ parakeet_model = "v3-int8"
 # Apple Silicon (~32x realtime); v2-fp16 benefits from 8 (~16x).
 parakeet_threads = 4
 
-# Floating waveform pill (macOS): shown ONLY while recording — red
-# waves as you speak; hidden when paused/waiting. Click-through; never
-# steals focus.
+# Floating ghost indicator (macOS): shown ONLY while recording — a
+# little blue ghost whose mouth opens with your voice; hidden when
+# paused/waiting. Click-through; never steals focus.
 overlay = true
+# How much the ghost's face flexes its shape (higher = more flexible).
+overlay_flex = 1.0
+# Overall animation speed (lower = slower, gentler motion).
+overlay_speed = 1.0
 
 # Remove standalone filler words (uh, um, ...) from typed text.
 strip_fillers = true

claude_code_tools-1.19.7/claude_code_tools/voice_type/overlay.py

@@ -0,0 +1,402 @@
+"""Floating waveform pill: visible proof that voice-type is listening.
+
+A small always-on-top, click-through, non-activating macOS panel at the
+bottom-center of the screen, shown ONLY while recording. It scrolls a
+live waveform of the mic level — red waves as you speak — and hides
+when paused or waiting for the wake word. Because the panel is a
+non-activating borderless NSPanel that ignores mouse events, it can
+never steal keyboard focus from the app being dictated into.
+
+Uses pyobjc (already a transitive dependency of pynput on macOS).
+The overlay must run on the process's MAIN thread (AppKit rule); the
+app hands its per-tick housekeeping in as a callback.
+"""
+
+from __future__ import annotations
+
+import signal
+from typing import Callable
+
+# (state_label, is_recording, level 0..1) sampled ~20x per second.
+SampleFn = Callable[[], tuple[str, bool, float]]
+TickFn = Callable[[], None]
+
+_WIDTH = 210.0
+_HEIGHT = 240.0  # generous headroom so the halo never clips when moving
+_MARGIN_BOTTOM = 110.0
+_TICK_SECONDS = 0.033  # ~30 fps
+# Master animation speed: small = slow, gentle, gradual motion.
+_PHASE_SPEED = 0.05
+# Idle blink: every ~_BLINK_EVERY frames the eyes close for a few.
+_BLINK_EVERY = 130
+_BLINK_FRAMES = 6
+
+
+def overlay_available() -> bool:
+    """True if the AppKit bridge is importable (macOS with pyobjc)."""
+    try:
+        import AppKit  # noqa: F401
+
+        return True
+    except Exception:
+        return False
+
+
+def run_overlay(  # noqa: PLR0913
+    sample: SampleFn,
+    tick: TickFn,
+    stopped: Callable[[], bool],
+    flex: float = 1.0,
+    speed: float = 1.0,
+) -> None:
+    """Show the ghost and block until ``stopped()`` returns True.
+
+    Args:
+        sample: Returns (state_label, is_recording, level) each frame.
+        tick: App housekeeping to run each frame (idle timeout, fatal
+            checks); exceptions are swallowed so the UI never dies.
+        stopped: Polled each frame; True ends the loop and closes the
+            panel.
+        flex: Face shape-flex multiplier (config overlay_flex).
+        speed: Animation speed multiplier (config overlay_speed).
+
+    SIGINT is redirected to a flag-friendly handler while the loop
+    runs (AppKit's run loop would otherwise swallow Ctrl+C), and
+    restored afterwards.
+    """
+    import AppKit
+    import objc
+    from AppKit import (
+        NSAffineTransform,
+        NSApplication,
+        NSBackingStoreBuffered,
+        NSBezierPath,
+        NSColor,
+        NSGradient,
+        NSGraphicsContext,
+        NSMakeRect,
+        NSPanel,
+        NSScreen,
+        NSTimer,
+    )
+
+    # Plain helpers (NOT NSView methods — pyobjc would try to bridge
+    # underscored methods as selectors and reject the extra arguments).
+    def _mk_oval(cx, cy, w, h):  # noqa: ANN001, ANN202
+        return NSBezierPath.bezierPathWithOvalInRect_(
+            NSMakeRect(cx - w / 2, cy - h / 2, w, h)
+        )
+
+    def _mk_ghost(cx, cy, gw, jelly, ph):  # noqa: ANN001, ANN202
+        """Ghost silhouette (domed head, wavy hem) with a soft jelly flex.
+
+        Built from points so a gentle, slow, spatially-coherent
+        displacement can wobble the whole outline — the head is
+        non-rigid (flexes shape), but the amplitude is small and smooth
+        so it never turns into a lumpy blob. ``jelly`` is the wobble
+        amplitude in points; ``ph`` the slow master phase.
+        """
+        import math
+
+        dome_y = cy + gw * 0.55
+        hem_y = cy - gw * 0.95
+        pts = [(cx + gw, hem_y), (cx + gw, dome_y)]
+        nd = 26
+        for i in range(1, nd):
+            a = math.pi * i / nd
+            pts.append((cx + gw * math.cos(a), dome_y + gw * math.sin(a)))
+        pts.append((cx - gw, dome_y))
+        pts.append((cx - gw, hem_y))
+        segs, bumps, ha = 30, 3, gw * 0.16
+        for i in range(1, segs + 1):
+            u = i / segs
+            x = cx - gw + u * 2 * gw
+            pts.append((x, hem_y - ha * math.sin(u * math.pi * bumps)))
+
+        p = NSBezierPath.bezierPath()
+        for i, (x, y) in enumerate(pts):
+            dx = jelly * math.sin(0.028 * y + ph * 0.8)
+            dy = jelly * math.sin(0.028 * x - ph * 0.6)
+            pt = (x + dx, y + dy)
+            if i == 0:
+                p.moveToPoint_(pt)
+            else:
+                p.lineToPoint_(pt)
+        p.closePath()
+        return p
+
+    def _mk_mouth(mx, lip_y, gw, open_, ph):  # noqa: ANN001, ANN202
+        """An organic mouth-hole that opens downward (jaw) and morphs.
+
+        Not a scaling oval: the rim is perturbed by slow low harmonics
+        so it wobbles/changes shape, it opens mostly DOWNWARD from a
+        fixed upper-lip line (like a dropping jaw), and it stays a thin
+        slit at rest. ``open_`` is 0..1; ``ph`` is the slow master phase.
+        """
+        import math
+
+        rx = gw * (0.36 + 0.08 * open_)
+        ry = gw * (0.05 + 0.34 * open_)
+        cy = lip_y - ry * 0.6  # grows downward from the lip line
+        # Constrained flex: two gentle low harmonics at small amplitude
+        # so the mouth has organic life without becoming a lumpy blob.
+        # (It is also clipped to the face by the caller, so it can never
+        # spill past the ghost's silhouette.)
+        deform = 0.04 + 0.06 * open_
+        n = 44
+        p = NSBezierPath.bezierPath()
+        for i in range(n + 1):
+            a = 2.0 * math.pi * i / n
+            wob = 1.0 + deform * (
+                math.sin(2 * a + ph * 0.5)
+                + 0.4 * math.sin(3 * a - ph * 0.4)
+            )
+            x = mx + rx * wob * math.cos(a)
+            y = cy + ry * wob * math.sin(a)
+            if i == 0:
+                p.moveToPoint_((x, y))
+            else:
+                p.lineToPoint_((x, y))
+        p.closePath()
+        return p
+
+    class WaveView(AppKit.NSView):  # noqa: D401
+        """A little glowing-blue ghost whose mouth opens with your voice.
+
+        A friendly translucent ghost floats at the bottom of the screen:
+        it bobs and blinks on its own so it feels alive, and its mouth
+        opens wider the louder you speak (driven by the live,
+        gain-adjusted mic level) -- the Animoji-style talking face that
+        makes the tool fun to use.
+        """
+
+        def initWithFrame_(self, frame):  # noqa: ANN001, ANN201, N802
+            self = objc.super(WaveView, self).initWithFrame_(frame)
+            if self is None:
+                return None
+            self.amp = 0.0  # smoothed level -> mouth opening
+            self.phase = 0.0
+            self.frame_no = 0
+            self.recording = False
+            return self
+
+        def push_(self, sample):  # noqa: ANN001, ANN201, N802
+            _label, recording, level = sample
+            level = max(0.0, min(1.0, float(level)))
+            # Gentle attack, slow release so the mouth and motion change
+            # gradually rather than twitching frame-to-frame.
+            k = 0.4 if level > self.amp else 0.10
+            self.amp += k * (level - self.amp)
+            self.phase += _PHASE_SPEED * speed
+            self.frame_no += 1
+            self.recording = bool(recording)
+            self.setNeedsDisplay_(True)
+
+        def drawRect_(self, rect):  # noqa: ANN001, ANN201, N802
+            import math
+
+            b = self.bounds()
+            cx, cy = b.size.width / 2, b.size.height / 2
+            gw = min(b.size.width, b.size.height) * 0.22
+            amp = self.amp
+            ph = self.phase
+
+            # Slow, gentle motion — a gradual drift, not a vibration.
+            # Bob and sway run at DIFFERENT slow frequencies so the
+            # ghost describes a lazy figure-eight rather than a rigid
+            # vertical bounce; both grow only mildly with volume.
+            bob = (3.0 + 3.0 * amp) * math.sin(ph * 0.9)
+            sway = (3.0 + 4.5 * amp) * math.sin(ph * 0.6 + 0.8)
+            dcx, dcy = cx + sway, cy + bob
+            # The whole face gently breathes and EXPANDS with volume
+            # (uniform scale — grows/shrinks, no shape distortion), plus
+            # a soft left/right lean. That is the head's audio reaction.
+            scale = (1.0 + 0.03 * math.sin(ph * 0.7)) * (1.0 + 0.11 * amp)
+            sx = sy = scale
+            lean = (2.5 + 3.0 * amp) * math.sin(ph * 0.45)  # degrees
+
+            NSGraphicsContext.currentContext().saveGraphicsState()
+            t = NSAffineTransform.transform()
+            t.translateXBy_yBy_(dcx, dcy)
+            t.rotateByDegrees_(lean)
+            t.scaleXBy_yBy_(sx, sy)
+            t.translateXBy_yBy_(-dcx, -dcy)
+            t.concat()
+            try:
+                # Slow, spatially-coherent jelly flex so the head is
+                # visibly non-rigid; more when talking, and scaled by the
+                # user's overlay_flex.
+                jelly = (2.6 + 5.0 * amp) * flex
+
+                # soft halo for presence (flexes WITH the body)
+                halo = _mk_ghost(dcx, dcy, gw * 1.10, jelly, ph)
+                NSColor.colorWithCalibratedRed_green_blue_alpha_(
+                    0.30, 0.62, 1.0, 0.20
+                ).setFill()
+                halo.fill()
+
+                # body: bluish radial gradient + bright rim
+                body = _mk_ghost(dcx, dcy, gw, jelly, ph)
+                core = NSColor.colorWithCalibratedRed_green_blue_alpha_(
+                    0.62, 0.86, 1.0, 0.88
+                )
+                edge = NSColor.colorWithCalibratedRed_green_blue_alpha_(
+                    0.16, 0.44, 0.98, 0.74
+                )
+                grad = (
+                    NSGradient.alloc().initWithStartingColor_endingColor_(
+                        core, edge
+                    )
+                )
+                if grad is not None:
+                    grad.drawInBezierPath_relativeCenterPosition_(
+                        body, (0.0, 0.35)
+                    )
+                else:  # pragma: no cover
+                    edge.setFill()
+                    body.fill()
+                NSColor.colorWithCalibratedRed_green_blue_alpha_(
+                    0.80, 0.94, 1.0, 0.9
+                ).setStroke()
+                body.setLineWidth_(2.0)
+                body.stroke()
+
+                # --- face features, CLIPPED to the body so nothing (the
+                # mouth in particular) can ever spill past the silhouette
+                gc = NSGraphicsContext.currentContext()
+                gc.saveGraphicsState()
+                body.addClip()
+                dark = NSColor.colorWithCalibratedRed_green_blue_alpha_(
+                    0.05, 0.10, 0.26, 0.92
+                )
+                dark.setFill()
+                eye_y = dcy + gw * 0.45
+                eye_dx = gw * 0.42
+                blinking = (
+                    self.frame_no % _BLINK_EVERY
+                ) < _BLINK_FRAMES
+                eye_w = gw * 0.26
+                eye_h = gw * 0.06 if blinking else gw * 0.36
+                for s in (-1, 1):
+                    _mk_oval(
+                        dcx + s * eye_dx, eye_y, eye_w, eye_h
+                    ).fill()
+                _mk_oval(dcx, dcy + gw * 0.05, gw * 0.10, gw * 0.12).fill()
+                lip_y = dcy - gw * 0.18
+                _mk_mouth(dcx, lip_y, gw, amp, ph).fill()
+                gc.restoreGraphicsState()
+            finally:
+                NSGraphicsContext.currentContext().restoreGraphicsState()
+
+    class Driver(AppKit.NSObject):
+        """NSTimer target: samples audio, ticks the app, ends the loop.
+
+        The pill is shown ONLY while recording — its mere presence is
+        the "you left the mic on" indicator; absence means not
+        listening. (A color change alone proved too subtle.)
+        """
+
+        def initWithView_panel_(self, view, panel):  # noqa: ANN001, ANN201, N802, E501
+            self = objc.super(Driver, self).init()
+            if self is None:
+                return None
+            self.view = view
+            self.panel = panel
+            self.shown = False
+            return self
+
+        def tick_(self, _timer):  # noqa: ANN001, ANN201, N802
+            try:
+                tick()
+            except Exception:
+                pass
+            try:
+                data = sample()
+                recording = bool(data[1])
+                if recording != self.shown:
+                    if recording:
+                        self.panel.orderFrontRegardless()
+                    else:
+                        self.panel.orderOut_(None)
+                    self.shown = recording
+                if recording:
+                    self.view.push_(data)
+            except Exception:
+                pass
+            if stopped():
+                NSApplication.sharedApplication().stop_(None)
+                # stop_() only takes effect once an event is processed;
+                # post a no-op event so the run loop wakes immediately.
+                evt = AppKit.NSEvent.otherEventWithType_location_modifierFlags_timestamp_windowNumber_context_subtype_data1_data2_(  # noqa: E501
+                    AppKit.NSEventTypeApplicationDefined,
+                    (0, 0), 0, 0.0, 0, None, 0, 0, 0,
+                )
+                NSApplication.sharedApplication().postEvent_atStart_(
+                    evt, True
+                )
+
+    app = NSApplication.sharedApplication()
+    # Accessory: no Dock icon, no menu bar, but windows still display.
+    app.setActivationPolicy_(
+        AppKit.NSApplicationActivationPolicyAccessory
+    )
+
+    screen = NSScreen.mainScreen()
+    sframe = screen.frame() if screen is not None else NSMakeRect(
+        0, 0, 1440, 900
+    )
+    x = sframe.origin.x + (sframe.size.width - _WIDTH) / 2
+    y = sframe.origin.y + _MARGIN_BOTTOM
+    panel = NSPanel.alloc().initWithContentRect_styleMask_backing_defer_(
+        NSMakeRect(x, y, _WIDTH, _HEIGHT),
+        AppKit.NSWindowStyleMaskBorderless
+        | AppKit.NSWindowStyleMaskNonactivatingPanel,
+        NSBackingStoreBuffered,
+        False,
+    )
+    panel.setLevel_(AppKit.NSStatusWindowLevel)
+    panel.setOpaque_(False)
+    panel.setBackgroundColor_(NSColor.clearColor())
+    panel.setIgnoresMouseEvents_(True)
+    panel.setHasShadow_(True)
+    panel.setCollectionBehavior_(
+        AppKit.NSWindowCollectionBehaviorCanJoinAllSpaces
+        | AppKit.NSWindowCollectionBehaviorStationary
+    )
+    view = WaveView.alloc().initWithFrame_(
+        NSMakeRect(0, 0, _WIDTH, _HEIGHT)
+    )
+    panel.setContentView_(view)
+    # Hidden at startup; the driver shows it only while recording.
+
+    driver = Driver.alloc().initWithView_panel_(view, panel)
+    timer = NSTimer.scheduledTimerWithTimeInterval_target_selector_userInfo_repeats_(  # noqa: E501
+        _TICK_SECONDS, driver, b"tick:", None, True
+    )
+    AppKit.NSRunLoop.currentRunLoop().addTimer_forMode_(
+        timer, AppKit.NSRunLoopCommonModes
+    )
+
+    # Ctrl+C: AppKit's run loop doesn't deliver KeyboardInterrupt on
+    # its own. Record the signal in a flag the timer polls (the timer
+    # firing is what lets the Python-level handler run at all), end
+    # the loop, and re-raise KeyboardInterrupt for the caller.
+    sigint = {"hit": False}
+    caller_stopped = stopped
+
+    def stopped() -> bool:  # noqa: ANN202
+        return sigint["hit"] or caller_stopped()
+
+    previous_handler = signal.getsignal(signal.SIGINT)
+    signal.signal(
+        signal.SIGINT,
+        lambda _sig, _frame: sigint.__setitem__("hit", True),
+    )
+    try:
+        app.run()
+    finally:
+        signal.signal(signal.SIGINT, previous_handler)
+        timer.invalidate()
+        panel.orderOut_(None)
+        if sigint["hit"]:
+            raise KeyboardInterrupt

{claude_code_tools-1.19.6 → claude_code_tools-1.19.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-code-tools"
-version = "1.19.6"
+version = "1.19.7"
 description = "Collection of tools for working with Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -131,7 +131,7 @@ markers = [
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "1.19.6"
+version = "1.19.7"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",

claude_code_tools-1.19.6/claude_code_tools/voice_type/overlay.py

@@ -1,273 +0,0 @@
-"""Floating waveform pill: visible proof that voice-type is listening.
-
-A small always-on-top, click-through, non-activating macOS panel at the
-bottom-center of the screen, shown ONLY while recording. It scrolls a
-live waveform of the mic level — red waves as you speak — and hides
-when paused or waiting for the wake word. Because the panel is a
-non-activating borderless NSPanel that ignores mouse events, it can
-never steal keyboard focus from the app being dictated into.
-
-Uses pyobjc (already a transitive dependency of pynput on macOS).
-The overlay must run on the process's MAIN thread (AppKit rule); the
-app hands its per-tick housekeeping in as a callback.
-"""
-
-from __future__ import annotations
-
-import signal
-from typing import Callable
-
-# (state_label, is_recording, level 0..1) sampled ~20x per second.
-SampleFn = Callable[[], tuple[str, bool, float]]
-TickFn = Callable[[], None]
-
-_WIDTH = 200.0
-_HEIGHT = 150.0
-_MARGIN_BOTTOM = 120.0
-# Points around the blob's rim (smoothness) and frame rate.
-_BLOB_POINTS = 108
-_TICK_SECONDS = 0.033  # ~30 fps, smooth wobble
-
-
-def overlay_available() -> bool:
-    """True if the AppKit bridge is importable (macOS with pyobjc)."""
-    try:
-        import AppKit  # noqa: F401
-
-        return True
-    except Exception:
-        return False
-
-
-def run_overlay(sample: SampleFn, tick: TickFn, stopped: Callable[[], bool]) -> None:
-    """Show the pill and block until ``stopped()`` returns True.
-
-    Args:
-        sample: Returns (state_label, is_recording, level) each frame.
-        tick: App housekeeping to run each frame (idle timeout, fatal
-            checks); exceptions are swallowed so the UI never dies.
-        stopped: Polled each frame; True ends the loop and closes the
-            panel.
-
-    SIGINT is redirected to a flag-friendly handler while the loop
-    runs (AppKit's run loop would otherwise swallow Ctrl+C), and
-    restored afterwards.
-    """
-    import AppKit
-    import objc
-    from AppKit import (
-        NSApplication,
-        NSBackingStoreBuffered,
-        NSBezierPath,
-        NSColor,
-        NSGradient,
-        NSMakeRect,
-        NSPanel,
-        NSScreen,
-        NSTimer,
-    )
-
-    class WaveView(AppKit.NSView):  # noqa: D401
-        """A glowing blue blob that wobbles and swells with the voice.
-
-        A soft orb sits at the bottom of the screen: it breathes gently
-        in silence and, as the live gain-adjusted mic level rises, its
-        rim deforms (organic multi-harmonic wobble) and the whole blob
-        swells — so its shape reflects the actual audio. Bluish, with a
-        radial gradient core, a rim highlight, and an outer halo for
-        presence.
-        """
-
-        def initWithFrame_(self, frame):  # noqa: ANN001, ANN201, N802
-            self = objc.super(WaveView, self).initWithFrame_(frame)
-            if self is None:
-                return None
-            self.amp = 0.0  # smoothed audio level driving the wobble
-            self.phase = 0.0
-            self.recording = False
-            return self
-
-        def push_(self, sample):  # noqa: ANN001, ANN201, N802
-            _label, recording, level = sample
-            level = max(0.0, min(1.0, float(level)))
-            # Fast attack, slow release: pops on speech, settles gently.
-            k = 0.55 if level > self.amp else 0.15
-            self.amp += k * (level - self.amp)
-            self.phase += 0.16
-            self.recording = bool(recording)
-            self.setNeedsDisplay_(True)
-
-        def _blob_path(self, cx, cy, base_r):  # noqa: ANN001, ANN202
-            import math
-
-            path = NSBezierPath.bezierPath()
-            wob = 0.09 + 0.42 * self.amp      # rim deformation depth
-            breathe = 0.05 * math.sin(self.phase * 0.5)
-            swell = 1.0 + 0.24 * self.amp     # overall growth with volume
-            for i in range(_BLOB_POINTS + 1):
-                a = 2.0 * math.pi * i / _BLOB_POINTS
-                shape = (
-                    math.sin(3 * a + self.phase)
-                    + 0.6 * math.sin(5 * a - 1.3 * self.phase)
-                    + 0.3 * math.sin(7 * a + 1.7 * self.phase)
-                ) / 1.9
-                r = base_r * swell * (1.0 + breathe + wob * shape)
-                x = cx + r * math.cos(a)
-                y = cy + r * math.sin(a)
-                if i == 0:
-                    path.moveToPoint_((x, y))
-                else:
-                    path.lineToPoint_((x, y))
-            path.closePath()
-            return path
-
-        def drawRect_(self, rect):  # noqa: ANN001, ANN201, N802
-            b = self.bounds()
-            cx, cy = b.size.width / 2, b.size.height / 2
-            base_r = min(b.size.width, b.size.height) * 0.26
-
-            # outer halo for presence
-            halo = self._blob_path(cx, cy, base_r * 1.28)
-            NSColor.colorWithCalibratedRed_green_blue_alpha_(
-                0.30, 0.62, 1.0, 0.20
-            ).setFill()
-            halo.fill()
-
-            # the blob: radial gradient core -> deeper blue rim
-            blob = self._blob_path(cx, cy, base_r)
-            core = NSColor.colorWithCalibratedRed_green_blue_alpha_(
-                0.60, 0.85, 1.0, 0.85
-            )
-            edge = NSColor.colorWithCalibratedRed_green_blue_alpha_(
-                0.16, 0.44, 0.98, 0.70
-            )
-            grad = NSGradient.alloc().initWithStartingColor_endingColor_(
-                core, edge
-            )
-            if grad is not None:
-                grad.drawInBezierPath_relativeCenterPosition_(
-                    blob, (0.0, 0.28)
-                )
-            else:  # pragma: no cover - gradient unavailable
-                edge.setFill()
-                blob.fill()
-
-            # bright rim
-            NSColor.colorWithCalibratedRed_green_blue_alpha_(
-                0.75, 0.92, 1.0, 0.9
-            ).setStroke()
-            blob.setLineWidth_(2.0)
-            blob.stroke()
-
-    class Driver(AppKit.NSObject):
-        """NSTimer target: samples audio, ticks the app, ends the loop.
-
-        The pill is shown ONLY while recording — its mere presence is
-        the "you left the mic on" indicator; absence means not
-        listening. (A color change alone proved too subtle.)
-        """
-
-        def initWithView_panel_(self, view, panel):  # noqa: ANN001, ANN201, N802, E501
-            self = objc.super(Driver, self).init()
-            if self is None:
-                return None
-            self.view = view
-            self.panel = panel
-            self.shown = False
-            return self
-
-        def tick_(self, _timer):  # noqa: ANN001, ANN201, N802
-            try:
-                tick()
-            except Exception:
-                pass
-            try:
-                data = sample()
-                recording = bool(data[1])
-                if recording != self.shown:
-                    if recording:
-                        self.panel.orderFrontRegardless()
-                    else:
-                        self.panel.orderOut_(None)
-                    self.shown = recording
-                if recording:
-                    self.view.push_(data)
-            except Exception:
-                pass
-            if stopped():
-                NSApplication.sharedApplication().stop_(None)
-                # stop_() only takes effect once an event is processed;
-                # post a no-op event so the run loop wakes immediately.
-                evt = AppKit.NSEvent.otherEventWithType_location_modifierFlags_timestamp_windowNumber_context_subtype_data1_data2_(  # noqa: E501
-                    AppKit.NSEventTypeApplicationDefined,
-                    (0, 0), 0, 0.0, 0, None, 0, 0, 0,
-                )
-                NSApplication.sharedApplication().postEvent_atStart_(
-                    evt, True
-                )
-
-    app = NSApplication.sharedApplication()
-    # Accessory: no Dock icon, no menu bar, but windows still display.
-    app.setActivationPolicy_(
-        AppKit.NSApplicationActivationPolicyAccessory
-    )
-
-    screen = NSScreen.mainScreen()
-    sframe = screen.frame() if screen is not None else NSMakeRect(
-        0, 0, 1440, 900
-    )
-    x = sframe.origin.x + (sframe.size.width - _WIDTH) / 2
-    y = sframe.origin.y + _MARGIN_BOTTOM
-    panel = NSPanel.alloc().initWithContentRect_styleMask_backing_defer_(
-        NSMakeRect(x, y, _WIDTH, _HEIGHT),
-        AppKit.NSWindowStyleMaskBorderless
-        | AppKit.NSWindowStyleMaskNonactivatingPanel,
-        NSBackingStoreBuffered,
-        False,
-    )
-    panel.setLevel_(AppKit.NSStatusWindowLevel)
-    panel.setOpaque_(False)
-    panel.setBackgroundColor_(NSColor.clearColor())
-    panel.setIgnoresMouseEvents_(True)
-    panel.setHasShadow_(True)
-    panel.setCollectionBehavior_(
-        AppKit.NSWindowCollectionBehaviorCanJoinAllSpaces
-        | AppKit.NSWindowCollectionBehaviorStationary
-    )
-    view = WaveView.alloc().initWithFrame_(
-        NSMakeRect(0, 0, _WIDTH, _HEIGHT)
-    )
-    panel.setContentView_(view)
-    # Hidden at startup; the driver shows it only while recording.
-
-    driver = Driver.alloc().initWithView_panel_(view, panel)
-    timer = NSTimer.scheduledTimerWithTimeInterval_target_selector_userInfo_repeats_(  # noqa: E501
-        _TICK_SECONDS, driver, b"tick:", None, True
-    )
-    AppKit.NSRunLoop.currentRunLoop().addTimer_forMode_(
-        timer, AppKit.NSRunLoopCommonModes
-    )
-
-    # Ctrl+C: AppKit's run loop doesn't deliver KeyboardInterrupt on
-    # its own. Record the signal in a flag the timer polls (the timer
-    # firing is what lets the Python-level handler run at all), end
-    # the loop, and re-raise KeyboardInterrupt for the caller.
-    sigint = {"hit": False}
-    caller_stopped = stopped
-
-    def stopped() -> bool:  # noqa: ANN202
-        return sigint["hit"] or caller_stopped()
-
-    previous_handler = signal.getsignal(signal.SIGINT)
-    signal.signal(
-        signal.SIGINT,
-        lambda _sig, _frame: sigint.__setitem__("hit", True),
-    )
-    try:
-        app.run()
-    finally:
-        signal.signal(signal.SIGINT, previous_handler)
-        timer.invalidate()
-        panel.orderOut_(None)
-        if sigint["hit"]:
-            raise KeyboardInterrupt