dsh-theme-mineradio 2.2.9 → 2.3.1

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

@@ -0,0 +1,24 @@
+/**
+ * Hero greeting pool: time-of-day buckets, random pick per new-session
+ * mount, no immediate repeat. Disabling the Aqua layer resets the hero back
+ * to the stock greeting for the active locale.
+ */
+/**
+ * Pick the greeting for the next hero mount.
+ * @param locale - active locale id (`zh` pools by time of day; anything else
+ * uses the English pool).
+ * @returns the greeting string.
+ */
+export declare function pickGreeting(locale: string): string;
+/**
+ * Restore the stock hero copy for the active locale (called when the Aqua
+ * layer is switched off, so the UI returns to its original wording).
+ * @param locale - active locale id.
+ */
+export declare function resetHeroCopy(locale: string): void;
+/**
+ * Mineradio placeholder for the hero composer, matched to the active locale.
+ * @param locale - active locale id.
+ * @returns the placeholder string.
+ */
+export declare function mineradioPlaceholder(locale: string): string;

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

@@ -1,10 +1,21 @@
 /**
- * Mineradio client plugin body.
- * @module dsh-theme-mineradio/client
+ * Mineradio client plugin body: the toggleable cinematic glass skin. Owns the
+ * durable enable flag (localStorage), applies/retracts the theme layer through
+ * {@link MineradioLayer}, and registers two settings surfaces:
+ * - the master on/off card into the Plugins section (`settings.plugin.item`,
+ *   same shape as the other plugin cards);
+ * - every glass knob into the General section's Appearance row area
+ *   (`settings.general.item`, right under 外观).
+ * One click on the master switch returns the stock UI (every layer is an
+ * effect, disposed on flip).
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-
+import type { Context } from '@deepseek-ai/cordis';
+import './mineradio.module.css';
+import './fonts.module.css';
 /** Required services: theme override stack plus the settings-card surfaces. */
 export declare const inject: string[];
-/** Client plugin body. */
-export declare function apply(ctx: ClientContext): void;
+/**
+ * Client plugin body.
+ * @param ctx - client cordis context.
+ */
+export declare function apply(ctx: Context): void;

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

@@ -0,0 +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;
+};

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

@@ -0,0 +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;

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

@@ -0,0 +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;

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

@@ -0,0 +1,115 @@
+/**
+ * Mineradio row slot store: a mirror of the layer's state (enable flag plus the
+ * 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-store';
+import type { PerfTier, TextStyle } from './theme-layer.ts';
+/** Store state mirrored from the Mineradio settings scope. */
+export interface MineradioRowState {
+    /** Persisted layer enable flag. */
+    enabled: boolean;
+    /** Rendering mode: mica or stock layout with generic glass. */
+    mode: 'mica' | 'compat';
+    /** Global text-ink tint preset. */
+    textStyle: TextStyle;
+    /** Glass blur radius, px. */
+    blur: number;
+    /** Glass frost amount, 0-100. */
+    frost: number;
+    /** Fluid hue, degrees (0-360, continuous). */
+    fluidHue: number;
+    /** Fluid depth, 0-100 (continuous). */
+    fluidDepth: number;
+    /** Glass dispersion tint hue, degrees (0-360, continuous). */
+    dispersionHue: number;
+    /** Glass refraction strength, 0-100. */
+    dispersionRefract: number;
+    /** Background brightness, 0-100. */
+    bgBrightness: number;
+    /** Resolved palette is dark (brightness knob = darkening half). */
+    dark: boolean;
+    /** Backdrop source: fluid board or custom wallpaper. */
+    background: 'fluid' | 'wallpaper';
+    /** Wallpaper image data URL. */
+    wallpaper: string;
+    /** Auto-derive the accent hue from the wallpaper. */
+    autoTint: boolean;
+    /** Particle whale in the chat area center. */
+    whale: boolean;
+    /** Ambient star particles. */
+    critters: boolean;
+    /** Interactive mesh (the site's dot-grid with pointer repel). */
+    mesh: boolean;
+    /** Star-river particle density, 0-100. */
+    starDensity: number;
+    /** Cursor spotlight glow following the pointer over the glass panes. */
+    spotlight: boolean;
+    /** Hover press-down for the glass panes. */
+    press: boolean;
+    /** Audio reactivity (mic-driven backdrop pulse). */
+    audioReact: boolean;
+    /** Wallpaper blur radius, px. */
+    wallpaperBlur: number;
+    /** Wallpaper frost veil, 0-100. */
+    wallpaperFrost: number;
+    /** Frosted-glass mask over the wallpaper (readability veil + stronger blur). */
+    wallpaperMask: boolean;
+    /** Frost mask blur radius, px. */
+    wallpaperMaskBlur: number;
+    /** Frost mask veil opacity, 0-100. */
+    wallpaperMaskOpacity: number;
+    /** Video wallpaper blur radius, px. */
+    videoBlur: number;
+    /** Video wallpaper brightness, 0-100. */
+    videoBrightness: number;
+    /** Performance gate. */
+    perf: PerfTier;
+    /** Rainbow fluid drift. */
+    rainbow: boolean;
+    /** Monotonic revision; -1 until first sync so revision 0 lands as a change. */
+    revision: number;
+}
+/** The full payload the layer pushes into the row store on every change. */
+export interface MineradioSettingsPayload {
+    enabled: boolean;
+    mode: 'mica' | 'compat';
+    textStyle: TextStyle;
+    blur: number;
+    frost: number;
+    fluidHue: number;
+    fluidDepth: number;
+    dispersionHue: number;
+    dispersionRefract: number;
+    bgBrightness: number;
+    dark: boolean;
+    background: 'fluid' | 'wallpaper';
+    wallpaper: string;
+    autoTint: boolean;
+    whale: boolean;
+    critters: boolean;
+    mesh: boolean;
+    starDensity: number;
+    spotlight: boolean;
+    press: boolean;
+    audioReact: boolean;
+    wallpaperBlur: number;
+    wallpaperFrost: number;
+    wallpaperMask: boolean;
+    wallpaperMaskBlur: number;
+    wallpaperMaskOpacity: number;
+    videoBlur: number;
+    videoBrightness: number;
+    perf: PerfTier;
+    rainbow: boolean;
+}
+/** Declared action shape giving the exported factory a stable return type. */
+type MineradioRowActions = {
+    sync: (draft: MineradioRowState, next: MineradioSettingsPayload, revision: number) => void;
+};
+/**
+ * Declares the Mineradio row state and write surface.
+ * @returns the store handle.
+ */
+export declare function createMineradioRowStore(): EngineStoreHandle<MineradioRowState, MineradioRowActions>;
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * 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

@@ -0,0 +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;

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

@@ -0,0 +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;

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

@@ -0,0 +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;

package/lib/types/client/station-dial.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Station dial — every workspace is its own radio station.
+ *
+ * The sidebar's workspace rows (`.projectRow`) name the station. Each name
+ * maps to a stable hue offset from a curated set of warm-adjacent stops,
+ * remembered in localStorage; switching workspaces glides the fluid, glow
+ * and dispersion tints there over ~2 seconds — like tuning a radio dial.
+ * The brand row carries a tiny frequency window (`FM 044`) that flickers
+ * while tuning. No settings knob: this is the radio being a radio.
+ *
+ * Resolution walks the flat ARIA tree: sessions are `.sessionRow` siblings
+ * that follow their workspace's `.projectRow`, so "the nearest projectRow
+ * at-or-before the selected session" names the station. Hero phase (no
+ * selection) keeps whatever was tuned last.
+ */
+/** The station name: nearest `.projectRow` at-or-before the selected session. */
+export declare function resolveStationName(): string | null;
+/**
+ * Watch the sidebar and retune when the station changes.
+ * @param onOffset called with the interpolated offset each frame of a tune
+ *   (and once at boot/settle), so the layer can repaint fluid + accents.
+ * @returns a disposer that disconnects the observer and cancels any glide.
+ */
+export declare function startStationDial(onOffset: (offset: number) => void): () => void;