[BuddhaCodes]

Built on top of #24 (it includes its commits): merge #24 first, and this PR's diff then shrinks to the widget commit alone.

Widgets

A sketch calls Widget() in Settings() and runs as a desktop widget:

• No borders or title bar. Stays above other windows (alwaysOnTop). Dragging it anywhere moves it (draggable: false → Alt + drag, so left clicks reach the sketch).
• See-through background: what Clear() leaves (and any alpha below 255) shows the desktop. IsTransparentWindow says whether the system granted it. Windows and macOS do; Linux only with a compositor. Without it, those pixels come out black and the sketch draws a Background().
• Right-click: always on top, close. It reopens where you left it (top-right corner the first time), per sketch class.
• WindowX/WindowY: the window's position on screen, for inertia.

How it works: the canvas already keeps alpha end to end (a premultiplied RGBA offscreen surface blitted over a cleared lease). What was missing was the window: Background = Transparent plus TransparencyLevelHint = Transparent, read back from ActualTransparencyLevel.

Where it applies:

• IDE: Run opens the widget on the desktop and the canvas shows a card. Stop/Run/Hot Reload/pause/crashes work as usual, and closing the widget ends the run. Sample previews stay inline.
• Exports, the fast-run window and SketchApp.Run() (NuGet/VS Code): the window itself becomes the widget. Settings() now runs before the window shows, and only once.

Audio widget sample

The TerminalAudio blobs on a transparent widget (560×220):

• Lows on the left and highs on the right; in silence the blobs come loose and float.
• They swing when you drag the widget.
• On macOS and Linux (no system-audio capture) they move in a demo mode.

Also

• Placeholder text wraps between words (it used to cut words).
• SketchApp picks the host's UI language from the system.
• Docs: a Widget entry in Sketch structure, keywords, and examples.json (87 examples).

Checks

• 616 .NET tests (8 new) and 15 extension tests pass.
• Under Xvfb:
  • Without a compositor: the opaque fallback.
  • With xcompmgr: real per-pixel transparency over the desktop.
  • Placement: top-right corner.
• IDE flow tested with an embedded canvas: card shown, Stop closes the widget (OnStop ran), Run reopens it, closing the widget stops the run.

---

Generated by Claude Code