dsh-theme-mineradio 2.3.4 → 2.3.6

package/lib/types/client/locales.d.ts

@@ -1,140 +1,140 @@
-/** `settings.mineradio` namespace dictionaries (the settings-row copy). */
-/** Dictionary namespace owned by this plugin. */
-export declare const NS = "settings.mineradio";
-/** Simplified Chinese dictionary (the key-set source of truth). */
-export declare const zh: {
-    'mineradio.title': string;
-    'mineradio.description': string;
-    'mineradio.enable': string;
-    'mineradio.disable': string;
-    'mineradio.mode': string;
-    'mineradio.modeMica': string;
-    'mineradio.modeCompat': string;
-    'mineradio.textColor': string;
-    'mineradio.textColorChampagne': string;
-    'mineradio.textColorNeutral': string;
-    'mineradio.textColorMint': string;
-    'mineradio.textColorRose': string;
-    'mineradio.scene': string;
-    'mineradio.sceneStudio': string;
-    'mineradio.sceneDeepsea': string;
-    'mineradio.sceneMidnight': string;
-    'mineradio.sceneMist': string;
-    'mineradio.sceneRainbow': string;
-    'mineradio.perf': string;
-    'mineradio.perfPerformance': string;
-    'mineradio.perfBalanced': string;
-    'mineradio.perfVivid': string;
-    'mineradio.foldLooks': string;
-    'mineradio.foldMaterial': string;
-    'mineradio.foldBackdrop': string;
-    'mineradio.foldMotion': string;
-    'mineradio.materialGroup': string;
-    'mineradio.decorAmbient': string;
-    'mineradio.decorHover': string;
-    'mineradio.whale': string;
-    'mineradio.critters': string;
-    'mineradio.mesh': string;
-    'mineradio.starDensity': string;
-    'mineradio.spotlight': string;
-    'mineradio.press': string;
-    'mineradio.audioReact': string;
-    'mineradio.blur': string;
-    'mineradio.frost': string;
-    'mineradio.fluidHue': string;
-    'mineradio.fluidDepth': string;
-    'mineradio.dispersionHue': string;
-    'mineradio.dispersionRefract': string;
-    'mineradio.bgBrightness': string;
-    'mineradio.bgBrightnessHintDark': string;
-    'mineradio.bgBrightnessHintLight': string;
-    'mineradio.background': string;
-    'mineradio.backgroundFluid': string;
-    'mineradio.backgroundWallpaper': string;
-    'mineradio.wallpaper': string;
-    'mineradio.autoTint': string;
-    'mineradio.wallpaperHint': string;
-    'mineradio.chooseImage': string;
-    'mineradio.chooseVideo': string;
-    'mineradio.deleteWallpaper': string;
-    'mineradio.wallpaperBlur': string;
-    'mineradio.wallpaperFrost': string;
-    'mineradio.wallpaperMask': string;
-    'mineradio.wallpaperMaskBlur': string;
-    'mineradio.wallpaperMaskOpacity': string;
-    'mineradio.videoBlur': string;
-    'mineradio.videoBrightness': string;
-    'mineradio.videoHint': string;
-};
-export type MineradioLocaleKey = keyof typeof zh;
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface LocaleNamespaceMap {
-        /** The Mineradio settings row's copy. */
-        'settings.mineradio': MineradioLocaleKey;
-    }
-}
-/** English dictionary. */
-export declare const en: {
-    'mineradio.title': string;
-    'mineradio.description': string;
-    'mineradio.enable': string;
-    'mineradio.disable': string;
-    'mineradio.mode': string;
-    'mineradio.modeMica': string;
-    'mineradio.modeCompat': string;
-    'mineradio.textColor': string;
-    'mineradio.textColorChampagne': string;
-    'mineradio.textColorNeutral': string;
-    'mineradio.textColorMint': string;
-    'mineradio.textColorRose': string;
-    'mineradio.scene': string;
-    'mineradio.sceneStudio': string;
-    'mineradio.sceneDeepsea': string;
-    'mineradio.sceneMidnight': string;
-    'mineradio.sceneMist': string;
-    'mineradio.sceneRainbow': string;
-    'mineradio.perf': string;
-    'mineradio.perfPerformance': string;
-    'mineradio.perfBalanced': string;
-    'mineradio.perfVivid': string;
-    'mineradio.foldLooks': string;
-    'mineradio.foldMaterial': string;
-    'mineradio.foldBackdrop': string;
-    'mineradio.foldMotion': string;
-    'mineradio.materialGroup': string;
-    'mineradio.decorAmbient': string;
-    'mineradio.decorHover': string;
-    'mineradio.whale': string;
-    'mineradio.critters': string;
-    'mineradio.mesh': string;
-    'mineradio.starDensity': string;
-    'mineradio.spotlight': string;
-    'mineradio.press': string;
-    'mineradio.audioReact': string;
-    'mineradio.blur': string;
-    'mineradio.frost': string;
-    'mineradio.fluidHue': string;
-    'mineradio.fluidDepth': string;
-    'mineradio.dispersionHue': string;
-    'mineradio.dispersionRefract': string;
-    'mineradio.bgBrightness': string;
-    'mineradio.bgBrightnessHintDark': string;
-    'mineradio.bgBrightnessHintLight': string;
-    'mineradio.background': string;
-    'mineradio.backgroundFluid': string;
-    'mineradio.backgroundWallpaper': string;
-    'mineradio.wallpaper': string;
-    'mineradio.autoTint': string;
-    'mineradio.wallpaperHint': string;
-    'mineradio.chooseImage': string;
-    'mineradio.chooseVideo': string;
-    'mineradio.deleteWallpaper': string;
-    'mineradio.wallpaperBlur': string;
-    'mineradio.wallpaperFrost': string;
-    'mineradio.wallpaperMask': string;
-    'mineradio.wallpaperMaskBlur': string;
-    'mineradio.wallpaperMaskOpacity': string;
-    'mineradio.videoBlur': string;
-    'mineradio.videoBrightness': string;
-    'mineradio.videoHint': string;
-};
+/** `settings.mineradio` namespace dictionaries (the settings-row copy). */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "settings.mineradio";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'mineradio.title': string;
+    'mineradio.description': string;
+    'mineradio.enable': string;
+    'mineradio.disable': string;
+    'mineradio.mode': string;
+    'mineradio.modeMica': string;
+    'mineradio.modeCompat': string;
+    'mineradio.textColor': string;
+    'mineradio.textColorChampagne': string;
+    'mineradio.textColorNeutral': string;
+    'mineradio.textColorMint': string;
+    'mineradio.textColorRose': string;
+    'mineradio.scene': string;
+    'mineradio.sceneStudio': string;
+    'mineradio.sceneDeepsea': string;
+    'mineradio.sceneMidnight': string;
+    'mineradio.sceneMist': string;
+    'mineradio.sceneRainbow': string;
+    'mineradio.perf': string;
+    'mineradio.perfPerformance': string;
+    'mineradio.perfBalanced': string;
+    'mineradio.perfVivid': string;
+    'mineradio.foldLooks': string;
+    'mineradio.foldMaterial': string;
+    'mineradio.foldBackdrop': string;
+    'mineradio.foldMotion': string;
+    'mineradio.materialGroup': string;
+    'mineradio.decorAmbient': string;
+    'mineradio.decorHover': string;
+    'mineradio.whale': string;
+    'mineradio.critters': string;
+    'mineradio.mesh': string;
+    'mineradio.starDensity': string;
+    'mineradio.spotlight': string;
+    'mineradio.press': string;
+    'mineradio.audioReact': string;
+    'mineradio.blur': string;
+    'mineradio.frost': string;
+    'mineradio.fluidHue': string;
+    'mineradio.fluidDepth': string;
+    'mineradio.dispersionHue': string;
+    'mineradio.dispersionRefract': string;
+    'mineradio.bgBrightness': string;
+    'mineradio.bgBrightnessHintDark': string;
+    'mineradio.bgBrightnessHintLight': string;
+    'mineradio.background': string;
+    'mineradio.backgroundFluid': string;
+    'mineradio.backgroundWallpaper': string;
+    'mineradio.wallpaper': string;
+    'mineradio.autoTint': string;
+    'mineradio.wallpaperHint': string;
+    'mineradio.chooseImage': string;
+    'mineradio.chooseVideo': string;
+    'mineradio.deleteWallpaper': string;
+    'mineradio.wallpaperBlur': string;
+    'mineradio.wallpaperFrost': string;
+    'mineradio.wallpaperMask': string;
+    'mineradio.wallpaperMaskBlur': string;
+    'mineradio.wallpaperMaskOpacity': string;
+    'mineradio.videoBlur': string;
+    'mineradio.videoBrightness': string;
+    'mineradio.videoHint': string;
+};
+export type MineradioLocaleKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The Mineradio settings row's copy. */
+        'settings.mineradio': MineradioLocaleKey;
+    }
+}
+/** English dictionary. */
+export declare const en: {
+    'mineradio.title': string;
+    'mineradio.description': string;
+    'mineradio.enable': string;
+    'mineradio.disable': string;
+    'mineradio.mode': string;
+    'mineradio.modeMica': string;
+    'mineradio.modeCompat': string;
+    'mineradio.textColor': string;
+    'mineradio.textColorChampagne': string;
+    'mineradio.textColorNeutral': string;
+    'mineradio.textColorMint': string;
+    'mineradio.textColorRose': string;
+    'mineradio.scene': string;
+    'mineradio.sceneStudio': string;
+    'mineradio.sceneDeepsea': string;
+    'mineradio.sceneMidnight': string;
+    'mineradio.sceneMist': string;
+    'mineradio.sceneRainbow': string;
+    'mineradio.perf': string;
+    'mineradio.perfPerformance': string;
+    'mineradio.perfBalanced': string;
+    'mineradio.perfVivid': string;
+    'mineradio.foldLooks': string;
+    'mineradio.foldMaterial': string;
+    'mineradio.foldBackdrop': string;
+    'mineradio.foldMotion': string;
+    'mineradio.materialGroup': string;
+    'mineradio.decorAmbient': string;
+    'mineradio.decorHover': string;
+    'mineradio.whale': string;
+    'mineradio.critters': string;
+    'mineradio.mesh': string;
+    'mineradio.starDensity': string;
+    'mineradio.spotlight': string;
+    'mineradio.press': string;
+    'mineradio.audioReact': string;
+    'mineradio.blur': string;
+    'mineradio.frost': string;
+    'mineradio.fluidHue': string;
+    'mineradio.fluidDepth': string;
+    'mineradio.dispersionHue': string;
+    'mineradio.dispersionRefract': string;
+    'mineradio.bgBrightness': string;
+    'mineradio.bgBrightnessHintDark': string;
+    'mineradio.bgBrightnessHintLight': string;
+    'mineradio.background': string;
+    'mineradio.backgroundFluid': string;
+    'mineradio.backgroundWallpaper': string;
+    'mineradio.wallpaper': string;
+    'mineradio.autoTint': string;
+    'mineradio.wallpaperHint': string;
+    'mineradio.chooseImage': string;
+    'mineradio.chooseVideo': string;
+    'mineradio.deleteWallpaper': string;
+    'mineradio.wallpaperBlur': string;
+    'mineradio.wallpaperFrost': string;
+    'mineradio.wallpaperMask': string;
+    'mineradio.wallpaperMaskBlur': string;
+    'mineradio.wallpaperMaskOpacity': string;
+    'mineradio.videoBlur': string;
+    'mineradio.videoBrightness': string;
+    'mineradio.videoHint': string;
+};

package/lib/types/client/mesh.d.ts

@@ -1,18 +1,18 @@
-/**
- * Interactive mesh: the deepseek.com/harness hero's dot-grid decoration —
- * a 90px grid of dots with spring physics that repel from the pointer
- * (radius 140px), the grid lines stretching with them. Faithful port of the
- * site's `h()` grid component (30fps, dpr ≤ 2, idle-pause). Rendered inside
- * the ambient scene behind the app content; pointer-events pass through.
- */
-/** Mesh handle: disposal. */
-export interface MeshHandle {
-    /** Stop the engine and remove the canvas. */
-    dispose: () => void;
-}
-/**
- * Mount the interactive mesh into `host` (the ambient scene).
- * @param host - the container the mesh canvas is appended to.
- * @returns the handle.
- */
-export declare function mountMesh(host: HTMLElement): MeshHandle;
+/**
+ * Interactive mesh: the deepseek.com/harness hero's dot-grid decoration —
+ * a 90px grid of dots with spring physics that repel from the pointer
+ * (radius 140px), the grid lines stretching with them. Faithful port of the
+ * site's `h()` grid component (30fps, dpr ≤ 2, idle-pause). Rendered inside
+ * the ambient scene behind the app content; pointer-events pass through.
+ */
+/** Mesh handle: disposal. */
+export interface MeshHandle {
+    /** Stop the engine and remove the canvas. */
+    dispose: () => void;
+}
+/**
+ * Mount the interactive mesh into `host` (the ambient scene).
+ * @param host - the container the mesh canvas is appended to.
+ * @returns the handle.
+ */
+export declare function mountMesh(host: HTMLElement): MeshHandle;

package/lib/types/client/seam-stamper.d.ts

@@ -1,21 +1,21 @@
-/**
- * Runtime seam stamper.
- *
- * The Aqua stylesheet keys off stable data-* hooks (`data-dsh-frame`,
- * `data-dsh-sidebar-root`, `data-hero-headline`, …). In the monorepo those
- * hooks are authored into the base packages' source; for a self-contained
- * distribution (installed against a stock DSH) this module stamps them onto
- * the matching elements at runtime, so the stylesheet works with zero base
- * edits. Each selector uses only stable attributes already present in the
- * stock UI (`data-composer-card`, `data-conversation-composer-overlay`,
- * ARIA roles) or lightningcss-preserved class-name substrings.
- *
- * Stamps are idempotent and inert without the `data-dsh-aqua` root attribute
- * (the whole stylesheet is gated on it), so they are simply left in place when
- * the layer flips off — "off" still renders the exact stock UI.
- */
-/**
- * Stamp the seams once, then keep them stamped as React remounts nodes.
- * @returns a disposer that disconnects the observer.
- */
-export declare function startSeamStamper(): () => void;
+/**
+ * Runtime seam stamper.
+ *
+ * The Aqua stylesheet keys off stable data-* hooks (`data-dsh-frame`,
+ * `data-dsh-sidebar-root`, `data-hero-headline`, …). In the monorepo those
+ * hooks are authored into the base packages' source; for a self-contained
+ * distribution (installed against a stock DSH) this module stamps them onto
+ * the matching elements at runtime, so the stylesheet works with zero base
+ * edits. Each selector uses only stable attributes already present in the
+ * stock UI (`data-composer-card`, `data-conversation-composer-overlay`,
+ * ARIA roles) or lightningcss-preserved class-name substrings.
+ *
+ * Stamps are idempotent and inert without the `data-dsh-aqua` root attribute
+ * (the whole stylesheet is gated on it), so they are simply left in place when
+ * the layer flips off — "off" still renders the exact stock UI.
+ */
+/**
+ * Stamp the seams once, then keep them stamped as React remounts nodes.
+ * @returns a disposer that disconnects the observer.
+ */
+export declare function startSeamStamper(): () => void;

package/lib/types/client/settings-store.d.ts

@@ -3,7 +3,7 @@
  * knobs and the backdrop source). The plugin's apply-world change listener is
  * the only writer; the row component reads via props.useStore.
  */
-import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-runtime/client';
+import { type EngineStoreHandle } from './host-store.ts';
 import type { PerfTier, TextStyle } from './theme-layer.ts';
 /** Store state mirrored from the Mineradio settings scope. */
 export interface MineradioRowState {
@@ -105,7 +105,7 @@ export interface MineradioSettingsPayload {
 }
 /** Declared action shape giving the exported factory a stable return type. */
 type MineradioRowActions = {
-    sync: (draft: MineradioRowState, next: MineradioSettingsPayload, revision: number) => void;
+    sync: (next: MineradioSettingsPayload, revision: number) => void;
 };
 /**
  * Declares the Mineradio row state and write surface.

package/lib/types/client/specular-parallax.d.ts

@@ -1,5 +1,5 @@
-/**
- * Attach the specular parallax feed.
- * @returns a disposer that drops listeners and inline vars.
- */
-export declare function startSpecularParallax(): () => void;
+/**
+ * Attach the specular parallax feed.
+ * @returns a disposer that drops listeners and inline vars.
+ */
+export declare function startSpecularParallax(): () => void;

package/lib/types/client/spot-core.d.ts

@@ -1,52 +1,52 @@
-/**
- * Spot geometry + overlay maintenance, shared by the spotlight/tilt
- * controller (spotlight.ts).
- *
- * A "spot" is a floating-glass pane stamped with `data-dsh-aqua-spot` by the
- * seam-stamper. One injected overlay lives inside a spot:
- * `data-dsh-aqua-glow` — the cursor glow surface (geometry set by the hover
- * controller; the radial fill lives in the stylesheet). It is re-attached
- * after React re-renders wipe it (one shared MutationObserver).
- */
-/** Seam attribute marking a floating-glass pane as a spotlight target. */
-export declare const SPOT_ATTR = "data-dsh-aqua-spot";
-/** Attribute on the injected glow overlay div. */
-export declare const GLOW_ATTR = "data-dsh-aqua-glow";
-/** Marker set on a pane while the pointer is inside it. */
-export declare const ON_ATTR = "data-spot-on";
-/** Selector matching every stamped pane. */
-export declare const SPOT_SELECTOR = "[data-dsh-aqua-spot]";
-/** Nearest stamped pane from an event target (null when outside all panes). */
-export declare function closestSpot(target: EventTarget | null): HTMLElement | null;
-/** Every stamped pane in document order. */
-export declare function spotElements(): HTMLElement[];
-/**
- * The visible glass region of a pane (viewport rect). The fused
- * composer+stats spot is the wider invisible inputbar wrapper — its glass is
- * the union of the composer card and the docked stats band, so the wrapper's
- * side gutters stay outside every effect.
- */
-export declare function visualRect(spot: HTMLElement): DOMRect;
-/** Is the pointer over the visible glass of the pane? */
-export declare function inside(visual: DOMRect, clientX: number, clientY: number): boolean;
-/**
- * The visible glass region of a pane in the pane's own local space
- * (untransformed — safe to measure while tilted). For the fused
- * composer+stats spot this is the union of the composer card and the docked
- * stats band; for the other panes it is the pane's own box.
- */
-export declare function glassLocalRect(spot: HTMLElement): {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-};
-/** Ensure the pane carries exactly one glow overlay div. */
-export declare function ensureGlow(spot: HTMLElement): HTMLElement;
-/**
- * One shared observer + resize feed: keeps the glow divs glued to the panes
- * through React re-renders and notifies the caller of DOM/layout changes
- * (the caller coalesces the callbacks).
- * @returns a disposer that removes every injected glow div.
- */
-export declare function startOverlayKeeper(onChange: () => void): () => void;
+/**
+ * Spot geometry + overlay maintenance, shared by the spotlight/tilt
+ * controller (spotlight.ts).
+ *
+ * A "spot" is a floating-glass pane stamped with `data-dsh-aqua-spot` by the
+ * seam-stamper. One injected overlay lives inside a spot:
+ * `data-dsh-aqua-glow` — the cursor glow surface (geometry set by the hover
+ * controller; the radial fill lives in the stylesheet). It is re-attached
+ * after React re-renders wipe it (one shared MutationObserver).
+ */
+/** Seam attribute marking a floating-glass pane as a spotlight target. */
+export declare const SPOT_ATTR = "data-dsh-aqua-spot";
+/** Attribute on the injected glow overlay div. */
+export declare const GLOW_ATTR = "data-dsh-aqua-glow";
+/** Marker set on a pane while the pointer is inside it. */
+export declare const ON_ATTR = "data-spot-on";
+/** Selector matching every stamped pane. */
+export declare const SPOT_SELECTOR = "[data-dsh-aqua-spot]";
+/** Nearest stamped pane from an event target (null when outside all panes). */
+export declare function closestSpot(target: EventTarget | null): HTMLElement | null;
+/** Every stamped pane in document order. */
+export declare function spotElements(): HTMLElement[];
+/**
+ * The visible glass region of a pane (viewport rect). The fused
+ * composer+stats spot is the wider invisible inputbar wrapper — its glass is
+ * the union of the composer card and the docked stats band, so the wrapper's
+ * side gutters stay outside every effect.
+ */
+export declare function visualRect(spot: HTMLElement): DOMRect;
+/** Is the pointer over the visible glass of the pane? */
+export declare function inside(visual: DOMRect, clientX: number, clientY: number): boolean;
+/**
+ * The visible glass region of a pane in the pane's own local space
+ * (untransformed — safe to measure while tilted). For the fused
+ * composer+stats spot this is the union of the composer card and the docked
+ * stats band; for the other panes it is the pane's own box.
+ */
+export declare function glassLocalRect(spot: HTMLElement): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** Ensure the pane carries exactly one glow overlay div. */
+export declare function ensureGlow(spot: HTMLElement): HTMLElement;
+/**
+ * One shared observer + resize feed: keeps the glow divs glued to the panes
+ * through React re-renders and notifies the caller of DOM/layout changes
+ * (the caller coalesces the callbacks).
+ * @returns a disposer that removes every injected glow div.
+ */
+export declare function startOverlayKeeper(onChange: () => void): () => void;

package/lib/types/client/spotlight.d.ts

@@ -1,11 +1,11 @@
-/** html attribute the layer uses to switch the glow effect (its toggle). */
-export declare const SPOTLIGHT_ATTRIBUTE = "data-dsh-aqua-spotlight";
-/** html attribute the layer uses to switch the tilt effect (its toggle). */
-export declare const PRESS_ATTRIBUTE = "data-dsh-aqua-press";
-/**
- * Attach the delegated pointer feeds. Everything is document-level: no
- * per-pane listeners, and the rAF merge collapses pointermove bursts to one
- * style write per frame.
- * @returns a disposer that drops listeners, overlays, and inline styles.
- */
-export declare function startSpotlight(): () => void;
+/** html attribute the layer uses to switch the glow effect (its toggle). */
+export declare const SPOTLIGHT_ATTRIBUTE = "data-dsh-aqua-spotlight";
+/** html attribute the layer uses to switch the tilt effect (its toggle). */
+export declare const PRESS_ATTRIBUTE = "data-dsh-aqua-press";
+/**
+ * Attach the delegated pointer feeds. Everything is document-level: no
+ * per-pane listeners, and the rAF merge collapses pointermove bursts to one
+ * style write per frame.
+ * @returns a disposer that drops listeners, overlays, and inline styles.
+ */
+export declare function startSpotlight(): () => void;

package/lib/types/client/star-river.d.ts

@@ -1,43 +1,43 @@
-/**
- * Mineradio-style particle stage — a from-scratch Canvas 2D re-creation of the
- * music player's signature backdrop motion (no code copied from the player):
- *
- *   1. STAR RIVER — hundreds of dust points organised in horizontal "bands"
- *      that drift sideways while sine waves carry them up/down. Cool
- *      blue→violet particles with a warm champagne ridge per band, plus a
- *      slow twinkle. Reads as a slow galaxy river flowing behind the glass.
- *   2. POINTER FIELD — particles near the cursor brighten and swell, like
- *      the player's silk cover reacting to the mouse.
- *   3. RIPPLES — a click drops a ripple: particles ride the expanding ring
- *      outwards and flash brighter, then everything settles back.
- *
- * Performance discipline: fixed particle cap, DPR capped at 1.5, sprite-based
- * rendering (one pre-baked radial dot per colour, no per-particle gradients),
- * `requestAnimationFrame` loop paused on `visibilitychange`, and a single
- * static frame under `prefers-reduced-motion`.
- */
-/** Public knob: dark scheme runs the full galaxy, light scheme dims it. */
-export interface StarRiverOptions {
-    dark: boolean;
-    /** Particle density, 0-100 (50 = 1× the default field, 100 = 2×). */
-    density?: number;
-    /** Respect the OS reduced-motion preference by rendering one static frame
-     *  instead of animating. OFF by default: the star river is the skin's
-     *  signature motion, so it animates unless an app-level switch opts in to
-     *  accessibility static frames. */
-    respectReducedMotion?: boolean;
-}
-/** Handle returned by {@link mountStarRiver}. */
-export interface StarRiverHandle {
-    /** Update the scheme knob. */
-    setDark(dark: boolean): void;
-    /** Update the particle density (0-100) and rebuild the field live. */
-    setDensity(density: number): void;
-    /** Audio reactivity: bass `low` drives the hop, treble `high` the sparkle. */
-    setAudio(low: number, high: number): void;
-    /** Tear the stage down (canvas, listeners, animation). */
-    dispose(): void;
-}
-/** Mount the particle stage inside the ambient container. Idempotent: a
- *  second call reuses the existing canvas. */
-export declare function mountStarRiver(ambient: HTMLElement, options: StarRiverOptions): StarRiverHandle;
+/**
+ * Mineradio-style particle stage — a from-scratch Canvas 2D re-creation of the
+ * music player's signature backdrop motion (no code copied from the player):
+ *
+ *   1. STAR RIVER — hundreds of dust points organised in horizontal "bands"
+ *      that drift sideways while sine waves carry them up/down. Cool
+ *      blue→violet particles with a warm champagne ridge per band, plus a
+ *      slow twinkle. Reads as a slow galaxy river flowing behind the glass.
+ *   2. POINTER FIELD — particles near the cursor brighten and swell, like
+ *      the player's silk cover reacting to the mouse.
+ *   3. RIPPLES — a click drops a ripple: particles ride the expanding ring
+ *      outwards and flash brighter, then everything settles back.
+ *
+ * Performance discipline: fixed particle cap, DPR capped at 1.5, sprite-based
+ * rendering (one pre-baked radial dot per colour, no per-particle gradients),
+ * `requestAnimationFrame` loop paused on `visibilitychange`, and a single
+ * static frame under `prefers-reduced-motion`.
+ */
+/** Public knob: dark scheme runs the full galaxy, light scheme dims it. */
+export interface StarRiverOptions {
+    dark: boolean;
+    /** Particle density, 0-100 (50 = 1× the default field, 100 = 2×). */
+    density?: number;
+    /** Respect the OS reduced-motion preference by rendering one static frame
+     *  instead of animating. OFF by default: the star river is the skin's
+     *  signature motion, so it animates unless an app-level switch opts in to
+     *  accessibility static frames. */
+    respectReducedMotion?: boolean;
+}
+/** Handle returned by {@link mountStarRiver}. */
+export interface StarRiverHandle {
+    /** Update the scheme knob. */
+    setDark(dark: boolean): void;
+    /** Update the particle density (0-100) and rebuild the field live. */
+    setDensity(density: number): void;
+    /** Audio reactivity: bass `low` drives the hop, treble `high` the sparkle. */
+    setAudio(low: number, high: number): void;
+    /** Tear the stage down (canvas, listeners, animation). */
+    dispose(): void;
+}
+/** Mount the particle stage inside the ambient container. Idempotent: a
+ *  second call reuses the existing canvas. */
+export declare function mountStarRiver(ambient: HTMLElement, options: StarRiverOptions): StarRiverHandle;