dsh-notch 0.3.1 → 0.3.6

package/macos/Sources/main.swift

@@ -1,153 +0,0 @@
-import AppKit
-import Combine
-import SwiftUI
-
-@main
-enum DshNotchMain {
-  static func main() {
-    if CommandLine.arguments.contains("--verify-idle-resources") {
-      let ids = IdleDirector.basics + ["dance"]
-      let missing = ids.filter { IdleLibrary.shared.clip($0) == nil }
-      print("IDLE_RESOURCES=\(ids.count - missing.count)/\(ids.count)")
-      exit(missing.isEmpty ? 0 : 1)
-    }
-    let app = NSApplication.shared
-    if CommandLine.arguments.contains("--demo") {
-      app.setActivationPolicy(.regular)
-      let delegate = DemoStudioDelegate()
-      DemoStudioDelegate.hold = delegate
-      app.delegate = delegate
-      delegate.show()
-      app.run()
-      return
-    }
-    app.setActivationPolicy(.accessory)
-    let delegate = AppDelegate()
-    app.delegate = delegate
-    app.run()
-  }
-}
-
-@MainActor
-final class AppDelegate: NSObject, NSApplicationDelegate {
-  private let panelW: CGFloat = 480
-  private let restW: CGFloat = 32
-  private let restH: CGFloat = 110
-  private let topOffset: CGFloat = 100
-  private let model = BoardModel()
-  private var panel: NotchPanel?
-  private var hosting: NotchHostingView<RootView>?
-  private var cursorTimer: Timer?
-  private var foldWork: DispatchWorkItem?
-  private var enteredIsland = false
-  private var cancellables = Set<AnyCancellable>()
-
-  func applicationDidFinishLaunching(_ notification: Notification) {
-    ProcessInfo.processInfo.disableAutomaticTermination("dsh-notch")
-    ProcessInfo.processInfo.disableSuddenTermination()
-    let panel = NotchPanel(size: NSSize(width: panelW, height: restH))
-    let root = RootView(
-      model: model,
-      panelSize: CGSize(width: panelW, height: restH),
-      restSize: CGSize(width: restW, height: restH)
-    )
-    let hosting = NotchHostingView(rootView: root)
-    hosting.sizingOptions = []
-    hosting.wantsLayer = true
-    hosting.layer?.isOpaque = false
-    hosting.layer?.backgroundColor = NSColor.clear.cgColor
-    panel.embedHost(hosting)
-    panel.ignoresMouseEvents = false
-    self.panel = panel
-    self.hosting = hosting
-    pinToScreen()
-    updateHits()
-    panel.orderFrontRegardless()
-    model.start()
-    Publishers.CombineLatest3(model.$expanded, model.$currentIslandWidth, model.$currentIslandHeight)
-      .receive(on: DispatchQueue.main)
-      .sink { [weak self] _ in self?.updateHits() }
-      .store(in: &cancellables)
-    cursorTimer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { [weak self] _ in
-      Task { @MainActor in
-        self?.tickPointer()
-      }
-    }
-    NotificationCenter.default.addObserver(
-      self,
-      selector: #selector(pinToScreen),
-      name: NSApplication.didChangeScreenParametersNotification,
-      object: nil
-    )
-  }
-
-  @objc private func pinToScreen() {
-    guard let panel else { return }
-    panel.cancelResize()
-    let mouse = NSEvent.mouseLocation
-    let screen = NSScreen.screens.first { NSMouseInRect(mouse, $0.frame, false) }
-      ?? NSScreen.main
-      ?? NSScreen.screens.first
-    guard let screen else { return }
-    let visible = screen.visibleFrame
-    let layout = NotchScreenLayout(availableHeight: visible.height, preferredInset: topOffset)
-    model.maximumExpandedHeight = layout.maximumHeight
-    // Anchor capsule to upper-right edge, ~100pt below top of usable screen.
-    // Keep the test helper separate from the real Notch during walkthroughs.
-    let demoInset: CGFloat = ProcessInfo.processInfo.environment["DSH_NOTCH_RUNTIME_FILE"] == nil ? 0 : 360
-    let width = max(1, model.currentIslandWidth)
-    let height = min(max(1, model.currentIslandHeight), model.maximumExpandedHeight)
-    let frame = NSRect(
-      x: visible.maxX - demoInset - width,
-      y: visible.maxY - layout.edgeInset - height,
-      width: width,
-      height: height
-    )
-    panel.setFrame(frame, display: true)
-  }
-
-  private func pointerOverVisual() -> Bool {
-    guard let panel else { return false }
-    return panel.frame.contains(NSEvent.mouseLocation)
-  }
-
-  private func tickPointer() {
-    guard panel != nil else { return }
-    let hit = pointerOverVisual()
-    if hit {
-      enteredIsland = true
-      foldWork?.cancel()
-      foldWork = nil
-      model.foldEnabled = true
-      // Expand when hovering if there are items needing action or if user triggered expansion.
-      if !model.expanded && (model.needsAction || model.allowExpandOnHover) {
-        model.expanded = true
-        updateHits()
-      }
-      return
-    }
-    // A guided local walkthrough stays visible until its test answer is sent.
-    if ProcessInfo.processInfo.environment["DSH_NOTCH_RUNTIME_FILE"] != nil && model.needsAction { return }
-    guard model.expanded, model.foldEnabled, enteredIsland, foldWork == nil else { return }
-    let work = DispatchWorkItem { [weak self] in
-      Task { @MainActor in
-        guard let self else { return }
-        self.foldWork = nil
-        if self.pointerOverVisual() { return }
-        self.enteredIsland = false
-        self.model.expanded = false
-        self.updateHits()
-        self.panel?.orderFrontRegardless()
-      }
-    }
-    foldWork = work
-    DispatchQueue.main.asyncAfter(deadline: .now() + 0.38, execute: work)
-  }
-
-  private func updateHits() {
-    guard let panel else { return }
-    let width = max(1, model.currentIslandWidth)
-    let height = min(max(1, model.currentIslandHeight), model.maximumExpandedHeight)
-    panel.resizeAnchored(to: NSSize(width: width, height: height), animated: true)
-  }
-}

package/macos/Tests/ExpandedHeightProbe.swift

@@ -1,108 +0,0 @@
-import AppKit
-import SwiftUI
-import Combine
-
-@main enum ExpandedHeightProbe {
-  @MainActor static func main() {
-    let app = NSApplication.shared
-    app.setActivationPolicy(.accessory)
-    let model = BoardModel()
-    model.previewMode = true
-    model.maximumExpandedHeight = 800
-    let panel = NotchPanel(size: NSSize(width: 480, height: 110))
-    let host = NotchHostingView(rootView: RootView(model: model, panelSize: CGSize(width: 480, height: 110), restSize: CGSize(width: 32, height: 110)))
-    host.sizingOptions = []
-    panel.embedHost(host)
-    panel.setFrame(NSRect(x: -2000, y: -2000, width: 38, height: 44), display: true)
-    panel.orderFrontRegardless()
-    var subscriptions = Set<AnyCancellable>()
-    Publishers.CombineLatest3(model.$expanded, model.$currentIslandWidth, model.$currentIslandHeight)
-      .receive(on: DispatchQueue.main).sink { _ in
-        panel.resizeAnchored(to: NSSize(width: model.currentIslandWidth, height: min(model.currentIslandHeight, model.maximumExpandedHeight)))
-      }.store(in: &subscriptions)
-    @MainActor func scrollViews(_ view: NSView) -> [NSScrollView] {
-      ((view as? NSScrollView).map { [$0] } ?? []) + view.subviews.flatMap(scrollViews)
-    }
-    Task { @MainActor in
-      var failures = 0
-      @MainActor func check(_ condition: Bool, _ message: String) {
-        if !condition { failures += 1; print("FAIL \(message)") }
-      }
-      @MainActor func question(_ detail: String? = nil, descriptions: Int = 1) -> NotchQuestion {
-        NotchQuestion(id: "question", question: "要在哪个分支继续修改？", detail: detail, options: [
-          NotchOption(label: "在 #17 分支上直接改（推荐）", description: String(repeating: "接着 cursor/reader-transcendent-merge-47c2 提交并重建，热更新到你现在这个页面验证，不用重启。", count: descriptions)),
-          NotchOption(label: "另开分支/PR 改", description: "#17 保持给作者 review，玻璃改动走新分支。"),
-          NotchOption(label: "暂时不改", description: "保留当前版本。")
-        ])
-      }
-      @MainActor func show(_ questions: [NotchQuestion]) {
-        model.wizard = nil
-        model.rows = [NotchRow(id: "offline", title: "Local height fixture", child: false, busy: false, unread: false, ask: NotchAsk(id: "ask", questions: questions))]
-        model.expanded = true
-      }
-      @MainActor func inspect(_ tag: String, overflowing: Bool = false) async {
-        try? await Task.sleep(for: .milliseconds(850))
-        host.layoutSubtreeIfNeeded()
-        let scrolls = scrollViews(host)
-        let overflows = scrolls.map { ($0.documentView?.frame.height ?? 0) - $0.contentView.bounds.height }
-        print("CASE=\(tag) PANEL=\(panel.frame.height) MEASURED=\(model.measuredContentHeight) CAP=\(model.maximumExpandedHeight) OVERFLOWS=\(overflows)")
-        if overflowing {
-          check(abs(panel.frame.height - model.maximumExpandedHeight) < 2, "\(tag): reaches screen cap before scrolling")
-          check(overflows.contains { $0 > 20 }, "\(tag): fixture has real overflow")
-          if let scroll = scrolls.first, let document = scroll.documentView {
-            let bottom = max(0, document.frame.height - scroll.contentView.bounds.height)
-            scroll.contentView.scroll(to: NSPoint(x: 0, y: bottom))
-            scroll.reflectScrolledClipView(scroll.contentView)
-            check(abs(scroll.contentView.bounds.origin.y - bottom) < 2, "\(tag): bottom controls remain reachable")
-          }
-        } else {
-          check(overflows.allSatisfy { $0 < 2 }, "\(tag): content fits without premature scrolling")
-          check(panel.frame.height < model.maximumExpandedHeight - 5, "\(tag): short content doesn't fill screen cap")
-        }
-        if let output = ProcessInfo.processInfo.environment["NOTCH_HEIGHT_PROBE_OUTPUT"],
-           let bitmap = host.bitmapImageRepForCachingDisplay(in: host.bounds) {
-          host.cacheDisplay(in: host.bounds, to: bitmap)
-          if let png = bitmap.representation(using: .png, properties: [:]) {
-            try? png.write(to: URL(fileURLWithPath: output).appendingPathComponent("\(tag).png"))
-          }
-        }
-      }
-      show([question()])
-      await inspect("screenshot-options")
-      model.expanded = false
-      try? await Task.sleep(for: .milliseconds(40))
-      model.rows = [NotchRow(id: "changed", title: "Changed during collapse", child: false, busy: false, unread: false, ask: NotchAsk(id: "changed-ask", questions: [question(descriptions: 15)]))]
-      try? await Task.sleep(for: .milliseconds(80))
-      model.expanded = true
-      await inspect("new-content-during-collapse")
-      show([question(String(repeating: "这是正文，需要完整展示。", count: 25))])
-      await inspect("medium-markdown")
-      show([question("第一行\n\n第二行\n\n第三行")])
-      await inspect("short-markdown")
-      show([question(descriptions: 80)])
-      await inspect("long-options", overflowing: true)
-      model.maximumExpandedHeight = 400
-      await inspect("smaller-screen", overflowing: true)
-      model.maximumExpandedHeight = 800
-      show([question(String(repeating: "### 段落\n\n这是需要完整审核的计划正文。\n\n", count: 30))])
-      await inspect("long-markdown", overflowing: true)
-      show([question()])
-      await inspect("shrink-back")
-      model.rows = (0..<12).map { NotchRow(id: "task-\($0)", title: "任务 \($0)", child: false, busy: true, unread: false) }
-      await inspect("twelve-tasks")
-      show([question(), NotchQuestion(id: "other", question: "Another question", detail: String(repeating: "Long detail. ", count: 100))])
-      await inspect("short-page-before-long-page")
-      let ask = model.rows[0].ask!
-      model.goQuestion(ask: ask, sessionId: "offline", delta: 1)
-      await inspect("next-page")
-      model.goQuestion(ask: ask, sessionId: "offline", delta: -1)
-      await inspect("previous-page")
-      model.toggleCustomField(ask: ask, sessionId: "offline")
-      await inspect("custom-answer")
-      print("FAILURES=\(failures)")
-      exit(failures == 0 ? 0 : 1)
-    }
-    app.run()
-    withExtendedLifetime(subscriptions) {}
-  }
-}

package/macos/Tests/GeometryProbe.swift

@@ -1,98 +0,0 @@
-import AppKit
-import SwiftUI
-import Combine
-@main enum GeometryProbe {
- @MainActor static func main() {
-  let app = NSApplication.shared
-  app.setActivationPolicy(.accessory)
-  let model = BoardModel()
-  model.maximumExpandedHeight = 460
-  let panel = NotchPanel(size: NSSize(width: 32,height:90))
-  let host = NotchHostingView(rootView: RootView(model:model,panelSize:CGSize(width:320,height:460),restSize:CGSize(width:32,height:110)))
-  host.sizingOptions = []
-  panel.embedHost(host)
-  panel.setFrame(NSRect(x:400,y:400,width:32,height:90),display:true)
-  panel.orderFrontRegardless()
-  var subscriptions = Set<AnyCancellable>()
-  Publishers.CombineLatest(model.$currentIslandWidth,model.$currentIslandHeight).receive(on:DispatchQueue.main).sink { w,h in
-   panel.resizeAnchored(to: NSSize(width:w,height:h))
-  }.store(in:&subscriptions)
-  var failures=0
-  func sample(_ tag:String) {
-   host.layoutSubtreeIfNeeded()
-   guard let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds) else { return }
-   host.cacheDisplay(in:host.bounds,to:rep)
-   let y=rep.pixelsHigh/2
-   var blacks=[Int]()
-   for x in 0..<rep.pixelsWide {
-    if let c=rep.colorAt(x:x,y:y)?.usingColorSpace(.deviceRGB),c.alphaComponent>0.9,c.redComponent<0.05,c.greenComponent<0.05,c.blueComponent<0.05 { blacks.append(x) }
-   }
-   let gap=rep.pixelsWide-1-(blacks.last ?? -1)
-   if abs(panel.frame.maxX - 432) > 0.01 { failures += 1 }
-   if gap>1 { failures += 1 }
-   if let corner=rep.colorAt(x:0,y:2), corner.alphaComponent > 0.1 { failures += 1; print("LEFT_CORNER_CLIPPED") }
-   print("\(tag) width=\(rep.pixelsWide) black=\(blacks.first ?? -1)...\(blacks.last ?? -1) rightGap=\(gap)")
-  }
-  Task { @MainActor in
-   try? await Task.sleep(for:.milliseconds(300));sample("rest")
-   for hover in [true,false,true,false] {
-    model.isPillHovered=hover
-    model.currentIslandWidth=hover ? 42:38
-    model.currentIslandHeight=hover ? 66:68
-    for i in 0..<10 {try? await Task.sleep(for:.milliseconds(20));sample("hover-\(hover)-\(i)")}
-   }
-   for hover in [true,false,true,false,true,false] {
-    model.isPillHovered=hover
-    try? await Task.sleep(for:.milliseconds(35));sample("rapid-hover")
-   }
-   for expanded in [true,false,true,false] {
-    model.expanded=expanded
-    for i in 0..<15 {try? await Task.sleep(for:.milliseconds(20));sample("expanded-\(expanded)-\(i)")}
-   }
-   for available in [100.0, 768.0, 1080.0, 1600.0] {
-    let layout = NotchScreenLayout(availableHeight: available)
-    if abs(layout.maximumHeight + 2 * layout.edgeInset - available) > 0.01 { failures += 1 }
-    if layout.maximumHeight <= 0 { failures += 1 }
-   }
-   @MainActor func setQuestion(description: String) {
-    let row: [String: Any] = ["id":"height-test", "title":"height test", "child":false, "busy":false, "unread":false, "ask":["id":"height-ask", "questions":[["id":"height-q", "question":"Height regression", "options":[["label":"Test option", "description":description]]]]]]
-    model.rows = [try! JSONDecoder().decode(NotchRow.self, from: JSONSerialization.data(withJSONObject:row))]
-   }
-   model.maximumExpandedHeight = 900
-   setQuestion(description: String(repeating: "Long content for measuring the expanded panel. ", count:100))
-   model.expanded = true
-   try? await Task.sleep(for:.milliseconds(500))
-   sample("long-content-900")
-   if abs(panel.frame.height - 900) > 1 { failures += 1; print("LONG_HEIGHT=\(panel.frame.height) EXPECTED=900") }
-   model.maximumExpandedHeight = 560
-   try? await Task.sleep(for:.milliseconds(500))
-   sample("screen-resized-560")
-   if abs(panel.frame.height - 560) > 1 { failures += 1; print("SCREEN_HEIGHT=\(panel.frame.height) EXPECTED=560") }
-   model.maximumExpandedHeight = 900
-   setQuestion(description:"Short content.")
-   try? await Task.sleep(for:.milliseconds(500))
-   sample("short-content")
-   if panel.frame.height >= 460 { failures += 1; print("SHORT_HEIGHT=\(panel.frame.height) EXPECTED<460") }
-   model.expanded=false
-   model.isPillHovered=false
-   for (busy,done,failed,expected) in [(1,0,0,44.0),(1,1,0,72.0),(1,0,1,72.0),(1,1,1,100.0),(0,1,0,44.0)] {
-    var rows: [[String:Any]] = []
-    if busy>0 { rows.append(["id":"busy", "title":"Busy", "child":false,"busy":true,"unread":false]) }
-    if done>0 { rows.append(["id":"done", "title":"Done", "child":false,"busy":false,"unread":true]) }
-    if failed>0 { rows.append(["id":"failed", "title":"Failed", "child":false,"busy":false,"unread":true,"lastTurn":["at":0,"kind":"error","failed":true]]) }
-    // Exercise the production snapshot entry point so lamp layout advances too.
-    model.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"offline",rows:try! JSONDecoder().decode([NotchRow].self,from:JSONSerialization.data(withJSONObject:rows))))
-    try? await Task.sleep(for:.milliseconds(1500))
-    sample("lamps-\(busy)-\(done)-\(failed)")
-    print("LAMP_HEIGHT=\(panel.frame.height) EXPECTED=\(expected)")
-    if abs(panel.frame.height-expected)>1 { failures += 1 }
-   }
-   print("HEIGHT=\(panel.frame.height)")
-   print("FAILURES=\(failures)")
-   exit(failures == 0 ? 0 : 1)
-  }
-  app.run()
-  withExtendedLifetime(subscriptions) {}
-  exit(failures == 0 ? 0 : 1)
- }
-}

package/macos/Tests/IdleProbe.swift

@@ -1,294 +0,0 @@
-import AppKit
-import SwiftUI
-@main enum IdleProbe {
- @MainActor static func main() {
-  let app=NSApplication.shared; app.setActivationPolicy(.accessory)
-  let output=URL(fileURLWithPath:ProcessInfo.processInfo.environment["NOTCH_IDLE_OUTPUT"] ?? NSTemporaryDirectory()).appendingPathComponent("notch-idle-proof")
-  try! FileManager.default.createDirectory(at:output,withIntermediateDirectories:true)
-  var failures=0
-  func check(_ ok:Bool,_ label:String){if !ok {failures += 1;print("FAIL \(label)")}}
-  for id in IdleDirector.basics + ["dance"] {
-   guard let clip=IdleLibrary.shared.clip(id) else {check(false,"resource \(id)");continue}
-   check(clip.frames.count > 100,"frames \(id)")
-   for frame in clip.frames {
-    check(frame.points.count == 192,"path topology")
-    check(frame.points.flatMap{$0}.allSatisfy{$0.isFinite},"finite geometry")
-    check(frame.points.allSatisfy{abs($0[0])*40/280 < 15 && abs($0[1])*40/280 < 21},"fits native bounds \(id)")
-   }
-   // Every intermediate outline must preserve area: a shifted SVG start index
-   // used to collapse the robot by joining unrelated boundary vertices.
-   func area(_ p:[[Double]]) -> Double {
-     abs(p.indices.reduce(0.0) { sum,i in
-       let a=p[i], b=p[(i+1)%p.count]
-       return sum + a[0]*b[1]-a[1]*b[0]
-     })/2
-   }
-   for i in 1..<clip.frames.count {
-     let a=clip.frames[i-1], b=clip.frames[i]
-     let mid=IdleInterpolation.mix(a,b,0.5)
-     check(area(mid.points) >= min(area(a.points),area(b.points))*0.98,"contour does not collapse \(id) frame \(i)")
-   }
-   // Interruption visuals from each action's non-neutral middle pose.
-   for step in 0...15 {
-    let visibility=step <= 10 ? 1-Double(step)/10 : 1
-    let suspect=["tilt":33,"scan":37,"balance":129,"sneeze":88,"stretch":72,"nod":64,"dance":612][id] ?? 60
-    let elapsed=step <= 10 ? 2.0 : (Double(suspect)+Double(step-13)*0.25)/clip.fps
-    let rendered=IdleInterpolation.sample(clip,at:elapsed*clip.fps)
-    let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[rendered]),elapsed:0,visibility:visibility,entering:false)
-      .frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
-    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:190)
-    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("\(id)-\(step).png"));panel.close()
-   }
-  }
-  for _ in 0..<100 {
-    check((5...10).contains(IdleDirector.restDuration()), "rest lasts 5–10 seconds")
-    let d=IdleDirector(),start=Date()
-    d.play("dance",at:start)
-    let duration=d.currentDuration
-    check((3...5).contains(duration), "chameleon lasts 3–5 seconds")
-    let end=d.frame(at:start.addingTimeInterval(duration))!
-    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
-    check(end.points == neutral.points && end.body == neutral.body, "chameleon returns continuously to neutral")
-    d.tick(start.addingTimeInterval(duration+0.001))
-    check(d.action == nil, "chameleon completes at sampled duration")
-    d.stop()
-  }
-  let ids = IdleDirector.basics + ["dance"]
-  for from in ids { for to in ids {
-    let director = IdleDirector()
-    let start = Date()
-    director.play(from, at:start)
-    let interrupt = start.addingTimeInterval(2.13)
-    let before = director.frame(at:interrupt)!
-    let previous=director.frame(at:interrupt.addingTimeInterval(-1.0/240))!
-    director.play(to, at:interrupt)
-    let after = director.frame(at:interrupt)!
-    check(before.points == after.points && before.body == after.body, "switch continuity \(from) -> \(to)")
-    check(zip(before.eyes,after.eyes).allSatisfy{$0.x == $1.x && $0.h == $1.h && $0.angle == $1.angle}, "eye continuity")
-    let dt=0.0001
-    let next=director.frame(at:interrupt.addingTimeInterval(dt))!
-    let error=after.points.indices.map { i in
-      hypot((next.points[i][0]-after.points[i][0])/dt-(before.points[i][0]-previous.points[i][0])*240,
-            (next.points[i][1]-after.points[i][1])/dt-(before.points[i][1]-previous.points[i][1])*240)
-    }.max()!
-    check(error < 1,"switch carries velocity \(from) -> \(to)")
-    director.stop()
-  }}
-  for entering in [false,true] {
-    let id=entering ? "cube-in":"satellite-out"
-    let clip=IdleLibrary.shared.clip(id)!
-    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
-    for i in 0...20 {
-      let t=Double(i)/20
-      let target=IdleInterpolation.sample(clip,at:t*clip.duration*clip.fps)
-      let sample=entering ? target:IdleInterpolation.mix(neutral,target,IdleInterpolation.smooth(t*clip.duration/0.22))
-      let visibility=entering ? IdleInterpolation.smooth(t/0.32):1-IdleInterpolation.smooth((t-0.65)/0.35)
-      let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[sample]),elapsed:0,visibility:visibility,entering:entering)
-        .frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
-      let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:190)
-      let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-      hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-      let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("\(id)-\(i).png"));panel.close()
-    }
-  }
-  for i in 0...16 {
-    let t=Double(i)/16,model=BoardModel()
-    model.rows=[NotchRow(id:"done",title:"done",child:false,busy:false,unread:true),NotchRow(id:"failed",title:"failed",child:false,busy:false,unread:true,lastTurn:NotchLastTurn(at:0,kind:"error",failed:true))]
-    let flight=StatusFlight(failed:false,startedAt:Date().addingTimeInterval(-t*StatusFlight.duration),busyBefore:1,destinationBefore:1,returnsToRunning:false)
-    model.statusFlight=flight
-    model.orbitLayout=OrbitLayout.flight(from:OrbitLayout(top:1,middle:1,bottom:1),to:OrbitLayout(top:1,middle:0,bottom:1),progress:t,flight:flight)
-    let view=RootView(model:model,panelSize:CGSize(width:320,height:460),restSize:CGSize(width:38,height:44))
-      .frame(width:38,height:model.orbitLayout.height+24).scaleEffect(3,anchor:.top)
-      .frame(width:160,height:340,alignment:.top).background(Color.gray.opacity(0.3))
-    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:340)
-    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("layout-\(i).png"));panel.close()
-  }
-  for i in 0...100 {
-    let t=Double(i)/100
-    let q=OrbitLayout.mix(OrbitLayout(middle:1),OrbitLayout(decision:1),IdleInterpolation.smooth(t))
-    check(abs(q.height-20)<0.00001,"single doing-to-decision keeps shell height")
-    check(abs(q.middleY-10)<0.00001,"single doing-to-decision stays at same center")
-  }
-  for i in 0...100 {
-    let q=OrbitLayout(top:1,middle:1,bottom:Double(i)/100)
-    check(q.bottomY+10 <= q.height+0.00001,"fading last disk stays within shrinking shell")
-  }
-  for distance in stride(from:0.0,through:20.0,by:0.1) {
-    check(StatusSeparation.opacity(weight:1,distance:distance)==0,"removed disk vanishes before contact")
-  }
-  check(StatusSeparation.opacity(weight:1,distance:28)==1,"separated disk starts fully visible")
-  let sleepClip=IdleLibrary.shared.clip("sleep")!
-  check(sleepClip.duration==9,"sleep includes four-second closed-eye plateau")
-  for t in [2.0,3.0,4.0,5.0] {
-    check(IdleInterpolation.sample(sleepClip,at:t*sleepClip.fps).eyes.allSatisfy{$0.h/$0.w<0.25},"sleep eyes remain closed for the hold")
-  }
-  let cube=IdleLibrary.shared.clip("cube-in")!
-  check(cube.frames.allSatisfy{$0.points.count==192 && $0.eyes.count==2},"cube keeps contour and eye slots across back-facing poses")
-  for i in 0...100 {
-    let departure=RobotDeparture(progress:Double(i)/100)
-    if departure.statusOpacity > 0 { check(departure.scale <= 0.061,"status cannot appear before robot reaches tiny point") }
-    if Double(i)/100*RobotDeparture.duration <= 0.666 { check(departure.statusScale <= 0.0001,"status remains a tiny point until colour handoff finishes") }
-  }
-  for i in 0...20 {
-    let t=Double(i)/20,departure=RobotDeparture(progress:t)
-    let model=BoardModel()
-    model.rows=[NotchRow(id:"ask",title:"local",child:false,busy:false,unread:false,ask:NotchAsk(id:"ask",questions:[]))]
-    model.orbitLayout=OrbitLayout(decision:1)
-    let clip=IdleLibrary.shared.clip("satellite-out")!
-    let target=IdleInterpolation.sample(clip,at:t*RobotDeparture.duration*clip.fps)
-    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
-    let frame=IdleInterpolation.mix(neutral,target,IdleInterpolation.smooth(t*RobotDeparture.duration/0.22))
-    let view=ZStack {
-      StatusOrbitView(model:model,workReveal:departure.statusScale).opacity(departure.statusOpacity)
-      IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[frame]),elapsed:0)
-        .frame(width:30,height:42).scaleEffect(departure.scale).opacity(departure.opacity)
-    }.frame(width:38,height:44).background(Color.black).scaleEffect(4).frame(width:180,height:200).background(Color.gray.opacity(0.2))
-    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:200)
-    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("tiny-handoff-\(i).png"));panel.close()
-  }
-  check(DecisionMorph(amount:0).trim==0.7 && DecisionMorph(amount:0).fill==0,"blue starts hollow with gap")
-  check(DecisionMorph(amount:1).trim==0 && DecisionMorph(amount:1).fill==1,"yellow ends closed and solid")
-  for text in ["!","1","3","8","12","99","100"] {
-    let bounds=CenteredStatusGlyph.path(text).boundingRect
-    check(abs(bounds.midX)<0.00001 && (text == "!" || abs(bounds.midY)<0.00001),"visible glyph ink centered: \(text)")
-    check(bounds.width<=12.00001,"multi-digit glyph fits the shared clipping width")
-  }
-  let step=0.000001
-  let penEndSpeed=(DecisionMorph(amount:0).trim-DecisionMorph(amount:step).trim)*2 * Double.pi/(step*DecisionMorph.resumeDuration)
-  check(abs(penEndSpeed-DecisionSpin.runningVelocity)<0.0001,"resume pen ends at running angular velocity")
-  let blueEndSpeed=(StatusBirth(progress:1).blueDraw-StatusBirth(progress:1-step).blueDraw)*2 * Double.pi*0.7/(step*(RobotDeparture.duration-0.666))
-  check(abs(blueEndSpeed-StatusBirth.bluePenVelocity)<0.0001,"birth pen hands its exact velocity to rotation")
-  for i in 25...99 {
-    let a=StatusBirth(progress:Double(i)/100).blueDraw,b=StatusBirth(progress:Double(i+1)/100).blueDraw
-    check(abs((b-a)-0.01/0.76)<0.00001,"blue appearance draws at constant speed")
-  }
-  check(DecisionClosing(amount:0.5).trim >= DecisionClosing(amount:0).trim,"09 must close the blue ring instead of erasing it")
-  for i in 0...100 {
-    let q=Double(i)/100,c=DecisionClosing(amount:q)
-    check(c.fill == 0 || c.trim > 0.99999,"09 fill waits for a closed ring")
-    if i>0 {check(c.trim>=DecisionClosing(amount:q-0.01).trim,"09 arc advances monotonically")}
-  }
-  let phaseModel=BoardModel()
-  var phaseRows=[NotchRow(id:"phase-a",title:"a",child:false,busy:true,unread:false),NotchRow(id:"phase-b",title:"b",child:false,busy:true,unread:false)]
-  phaseModel.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"test",rows:phaseRows))
-  check(abs(phaseModel.decisionVelocity(at:Date())-DecisionSpin.runningVelocity)<0.0001,"cold snapshot starts at normal speed")
-  phaseRows[0].busy=false;phaseRows[0].unread=true
-  phaseModel.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"test",rows:phaseRows))
-  if let f=phaseModel.statusFlight {
-    let end=f.startedAt.addingTimeInterval(StatusFlight.duration)
-    let error=phaseModel.decisionAngle(at:end)-(f.angle+StatusFlight.duration*DecisionSpin.runningVelocity)
-    check(abs(sin(error/2))<0.001,"02 flight return and running ring must share phase")
-  } else { check(false,"completion repro starts flight") }
-  let epoch=Date()
-  let stop=DecisionSpin(began:epoch,angle:1.2,initialVelocity:DecisionSpin.runningVelocity,finalVelocity:0)
-  let reversal=epoch.addingTimeInterval(0.24)
-  let resume=DecisionSpin(began:reversal,angle:stop.position(at:reversal),initialVelocity:stop.velocity(at:reversal),finalVelocity:DecisionSpin.runningVelocity)
-  check(abs(stop.position(at:reversal)-resume.position(at:reversal))<0.00001,"reverse preserves ring position")
-  check(abs(stop.velocity(at:reversal)-resume.velocity(at:reversal))<0.00001,"reverse preserves ring velocity")
-  for i in 1...100 {
-    let a=epoch.addingTimeInterval(Double(i-1)/100),b=epoch.addingTimeInterval(Double(i)/100)
-    check(stop.position(at:b)>=stop.position(at:a),"ring never reverses while stopping")
-    check(resume.velocity(at:b)>=0,"ring resumes forward")
-  }
-  check(DecisionMorph(amount:0.64).flip < 0.00001,"number resolves before most of the brush is drawn")
-  check(DecisionMorph(amount:0.99).fill == 1,"disk supports the early symbol flip")
-  for i in 0...100 {
-    let m=DecisionMorph(amount:Double(i)/100)
-    check(m.draw == 0 || m.fill < 0.00001,"blue pen starts only after yellow fill clears")
-    let birth=StatusBirth(progress:Double(i)/100)
-    check(birth.draw == 0 || birth.travel > 0.99999,"pen reaches rim before drawing")
-    check(birth.fill == 0 || birth.draw > 0.99999,"yellow ring closes before filling")
-    check(birth.text == 0 || birth.draw > 0.99999,"text follows completed stroke")
-  }
-  for i in 0...12 {
-    let t=Double(i)/12
-    let view=WorkingDecisionGlyph(amount:t,number:3,angle:-Double.pi/2).scaleEffect(6).frame(width:160,height:160).background(Color.black)
-    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:160)
-    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("decision-flip-\(i).png"));panel.close()
-  }
-  for decision in [false,true] {
-    for i in 0...12 {
-      let view=StatusBirthGlyph(progress:Double(i)/12,decision:decision,number:3,angle:-Double.pi/2).scaleEffect(6).frame(width:160,height:160).background(Color.black)
-      let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:160)
-      let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
-      hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
-      let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
-      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("birth-\(decision ? "yellow":"blue")-\(i).png"));panel.close()
-    }
-  }
-  for scale in [1.0,2.0,3.0] {
-    for kind in ["blue","green","red","yellow"] {
-      let model=BoardModel()
-      let ask=kind == "yellow" ? NotchAsk(id:"q",questions:[]):nil
-      let failed=kind == "red" ? NotchLastTurn(at:0,kind:"error",failed:true):nil
-      model.rows=[NotchRow(id:"a",title:"local",child:false,busy:kind == "blue",unread:kind == "green" || kind == "red",lastTurn:failed,ask:ask)]
-      model.orbitLayout=OrbitLayout(top:kind == "green" ? 1:0,middle:kind == "blue" ? 1:0,bottom:kind == "red" ? 1:0,decision:kind == "yellow" ? 1:0)
-      let view=StatusOrbitView(model:model,reduceMotionOverride:true).frame(width:60,height:120).scaleEffect(scale).frame(width:60*scale,height:120*scale).background(Color.black)
-      let host=NSHostingView(rootView:view);host.frame=NSRect(x:0,y:0,width:60*scale,height:120*scale)
-      let panel=NSPanel(contentRect:host.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=host
-      host.layoutSubtreeIfNeeded();host.displayIfNeeded()
-      let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds)!;host.cacheDisplay(in:host.bounds,to:rep)
-      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("alignment-\(kind)-\(Int(scale)).png"));panel.close()
-    }
-  }
-  let tourDirector=IdleDirector(),tourStart=Date()
-  tourDirector.play("dance",at:tourStart)
-  let end=tourDirector.currentDuration
-  for (i,t) in [0.0,0.10,0.25,0.45,2.0,end-0.45,end-0.20,end,end+0.15,end+0.37].enumerated() {
-    let now=tourStart.addingTimeInterval(t)
-    if t >= end {tourDirector.tick(now)}
-    let frame=tourDirector.displayFrame(at:now)!
-    let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[frame]),elapsed:0).frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
-    let host=NSHostingView(rootView:view);host.frame=NSRect(x:0,y:0,width:180,height:190)
-    let panel=NSPanel(contentRect:host.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=host
-    host.layoutSubtreeIfNeeded();host.displayIfNeeded()
-    let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds)!;host.cacheDisplay(in:host.bounds,to:rep)
-    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("tour-dance-\(i).png"));panel.close()
-  }
-  tourDirector.stop()
-  var closures=0
-  for i in 1..<3000 {
-    if IdleDirector.blinkClosure(at:Double(i)/100)>0.9 && IdleDirector.blinkClosure(at:Double(i-1)/100)<=0.9 { closures+=1 }
-  }
-  check(closures >= 5 && closures <= 9,"natural blinks recur independently of gestures")
-  for failed in [false,true] {
-    let flight=StatusFlight(failed:failed,startedAt:Date(),busyBefore:1,destinationBefore:1,returnsToRunning:false)
-    let initial=OrbitLayout(top:1,middle:1,bottom:1),final=OrbitLayout(top:1,middle:0,bottom:1)
-    var previous=initial
-    for i in 0...160 {
-      let layout=OrbitLayout.flight(from:initial,to:final,progress:Double(i)/160,flight:flight)
-      check(abs((layout.bottomY-previous.bottomY)-(layout.height-previous.height)) < 0.00001,"red disk and shell share displacement")
-      check(abs(layout.bottomY-previous.bottomY)<2,"no last-task layout snap")
-      previous=layout
-    }
-    check(previous==final,"last task settles into exact two-light layout")
-  }
-  let director=IdleDirector(),presence=IdlePresence()
-  presence.set(true,director:director,animated:false)
-  director.play("hop")
-  presence.set(false,director:director)
-  check(director.action == nil,"work cancels idle immediately")
-  let frozen=presence.frozenID
-  RunLoop.current.run(until:Date().addingTimeInterval(0.1))
-  let before=presence.visibility
-  presence.set(true,director:director)
-  check(presence.visibility==before && presence.frozenID==frozen,"reverse retains geometry")
-  RunLoop.current.run(until:Date().addingTimeInterval(1.2))
-  check(presence.visibility == 1,"reverse finishes idle")
-  presence.stop();director.stop()
-  print("FAILURES=\(failures)");exit(failures==0 ? 0:1)
- }
-}