[FoOcean]

Pre-submission checklist

• I have read CONTRIBUTING.md and completed the required checks
• Local and CI checks pass
• I have completed a self-review
• I confirm that I haven't read the checkboxes and just ticked them all

Change type (select one)

• feat New feature
• fix Bug fix
• docs Documentation or templates
• style Formatting with no behavior change
• refactor Code change that neither fixes a bug nor adds a feature
• perf Performance improvement
• test Test-related change
• chore Build, CI, dependency, or tooling change
• revert Revert
• security Security fix

Scope (select all that apply)

• Application core
• UI style or layout
• Application behavior
• Dependency changes
• Plugin API
• CI/CD configuration
• Documentation
• Other (describe below)

Other: platform API additions: AudioProvider::output_devices / set_default_output, and WindowSystem::update_window_backdrop / set_text_input for the settings window. Dependency changes are new windows crate features only (Win32_Devices_FunctionDiscovery, Win32_System_Com_StructuredStorage, Win32_UI_Shell_PropertiesSystem).

Related issues

• Refs: user feedback batch (no tracked issue)

---

Description

Summary

Redesigns the settings window, rebalances typography with real font weights and richer font options, restyles the music page with output-device and volume controls, adds the timer status orb, and fixes the spectrum stalling after an output device switch.

Motivation and context

• Settings: the options were grouped by implementation rather than by what users look for, and the window style did not match the rest of the app.
• Typography: text only had regular and bold (700). Microsoft YaHei has no medium or semibold, so every emphasized string jumped to full bold and some places read too heavy while small labels read too light. In addition, the CJK fallback passed zh-CN first, but Skia uses the last language tag, so Chinese text fell back to Yu Gothic and Microsoft JhengHei and mixed three fonts on one line.
• Fonts: a custom font could only be a single file, with no weight control.
• Music page: brought in line with the iOS expanded player, with requests to switch the output device and adjust volume from the island.
• Timer: a running timer competed with music and widgets for compact space.
• Spectrum: switching the output device while music played left the spectrum frozen.

Changes

Commits are self-contained and build in order.

• fix(audio): the meter thread reset and re-found the target PID within one loop iteration, so the loopback reader never noticed a device change and kept reading a stream that stops delivering. Device changes now bump an epoch that reopens the capture; a watchdog reopens it when the player is audible but no packets arrive for 2 s; the audio workers run on dedicated threads so cpal's COM apartment no longer collides with MTA workers on reused tokio blocking threads (the logs showed RPC_E_CHANGED_MODE).
• feat(audio): output_devices() lists active render endpoints with friendly name and form factor; set_default_output() switches via IPolicyConfig for all roles. AudioOutputs runs both on a worker thread.
• feat(settings):
  • Window: opaque base with a floating glass sidebar (host backdrop), concentric continuous corners, traffic lights with an inactive maximize button, back/forward capsule, and a sidebar search over page titles and item labels (IME aware).
  • Pages: General is split into General, Appearance, Size & Position, Hide & Interaction, and Notifications & Alerts. Sidebar and onboarding icons are recolored, and four new sidebar icons come from the iOS icon set.
  • Controls: larger capsule switches, flat push buttons, popup selects, and a popup menu that scrolls, with a draggable gutter scrollbar, type-ahead, arrow keys, Enter and Esc.
  • Typography: text APIs take a FontWeight instead of bool. Latin uses the Segoe UI Variable wght axis, variable fonts use their own axis, and CJK weights the family lacks are synthesized with a size-calibrated stroke. Titles, buttons and numerals use semibold, labels and lyrics medium, body text regular.
  • Fonts: the font menu offers the system default, a font file (ttf/otf/ttc/otc) and every installed family. Regional families such as PingFang UI SC/TC/HK/MO/JA fold into one entry that follows the interface language (Windows locale for non-Chinese UIs). A weight offset is added, along with a recommended-font link.
• feat(music):
  • Layout: five evenly spaced controls, gray side icons, a brighter progress track and gray secondary text.
  • Left button: shows the current output device and opens a device list that switches the default output. It scrolls to the current device, and its scrollbar sits in its own gutter and can be dragged.
  • Right button: follows the volume level with a crossfade between glyphs and opens a volume slider that also takes the mouse wheel.
• feat(island): while music or widgets occupy the compact island, a running timer moves into a status orb beside it, sharing the camera and microphone indicator behavior.

Configuration

New keys font_family (optional, unset by default) and font_weight (light / regular / bold, default regular). Both fall back to serde defaults, so existing configs load unchanged. custom_font_path keeps its meaning and takes precedence over font_family.

Testing

• cargo fmt --all -- --check, cargo clippy --workspace -- -D warnings, cargo build --release pass; each commit also passes cargo check.
• Rendered in a WINISLAND_HOME sandbox: all settings pages in light and dark, the font menu, island scenes with the system font, a single-weight PingFang file and the PingFang UI variable family, and the music page with both panels.
• To verify manually:
  1. Settings → Appearance → Font: pick PingFang UI (if installed) or any family and check weights across the island and settings.
  2. Expand the island on the music page and click the left icon; pick another output and confirm Windows switches to it.
  3. Click the right icon and drag the slider or scroll over it; the icon should change between 1, 2 and 3 waves and mute.
  4. While music plays, switch the output device from Windows and confirm the spectrum keeps moving.
• Not verified here: steps 2 and 4 need a real device switch, which was left to manual testing.

UI changes

• Settings: macOS-style window. The translucent sidebar floats above an opaque base, with search, grouped pages and a navigation capsule.
• Typography: lighter overall hierarchy. Chinese renders in a single font, and medium and semibold now look different from bold.
• Music page: matches the iOS layout. The device list fades in over the cover area while the playback controls stay visible. The volume slider crossfades in place of the progress bar and closes after 3 s idle.
• Timer orb: pops out at half of the collapse animation and settles together with the island.

🤖 Generated with Claude Code