dsh-theme-mineradio 2.3.4 → 2.3.6

package/lib/types/client/cinema-drift.d.ts

@@ -1,20 +1,20 @@
-/**
- * Cinematic camera for the ambient scene — makes the backdrop read as a 3D
- * stage rather than a flat wallpaper:
- *
- *   1. CURSOR PARALLAX + 3D TILT (the "wow"): the fluid board (far) and the
- *      star-river (near) shift, tilt (rotateX/rotateY under perspective) and
- *      roll at different rates as the pointer moves — the near layer travels
- *      ~2× further, so moving the mouse parallax-reveals real depth.
- *   2. IDLE DRIFT (the "breathe"): a slow low-frequency sine sway + roll so
- *      the scene keeps floating when the pointer is still — a 2D port of
- *      Mineradio's `cineTheta = sin(t*0.08)*0.012` idle orbit.
- *
- * Pure CSS-transform work (one rAF, GPU-composited); reduced-motion renders
- * nothing (the scene stays a clean static frame).
- */
-export interface CinemaDriftHandle {
-    dispose(): void;
-}
-/** Start the cinematic camera over the ambient scene. */
-export declare function startCinemaDrift(ambient: HTMLElement): CinemaDriftHandle;
+/**
+ * Cinematic camera for the ambient scene — makes the backdrop read as a 3D
+ * stage rather than a flat wallpaper:
+ *
+ *   1. CURSOR PARALLAX + 3D TILT (the "wow"): the fluid board (far) and the
+ *      star-river (near) shift, tilt (rotateX/rotateY under perspective) and
+ *      roll at different rates as the pointer moves — the near layer travels
+ *      ~2× further, so moving the mouse parallax-reveals real depth.
+ *   2. IDLE DRIFT (the "breathe"): a slow low-frequency sine sway + roll so
+ *      the scene keeps floating when the pointer is still — a 2D port of
+ *      Mineradio's `cineTheta = sin(t*0.08)*0.012` idle orbit.
+ *
+ * Pure CSS-transform work (one rAF, GPU-composited); reduced-motion renders
+ * nothing (the scene stays a clean static frame).
+ */
+export interface CinemaDriftHandle {
+    dispose(): void;
+}
+/** Start the cinematic camera over the ambient scene. */
+export declare function startCinemaDrift(ambient: HTMLElement): CinemaDriftHandle;

package/lib/types/client/color-extract.d.ts

@@ -1,14 +1,14 @@
-/**
- * Wallpaper color extraction — a small, dependency-free dominant-hue finder.
- *
- * The wallpaper (image or video frame) is drawn onto a tiny canvas, and the
- * pixels are folded into a circular hue histogram weighted by saturation and
- * mid-lightness, so gray/black/white areas contribute nothing and the result
- * is the image's most vivid, representative hue. Returns a single hue in
- * degrees (0-360), or null when the source is too desaturated to read.
- */
-/**
- * Extract the dominant hue from a canvas-image source (img / video / canvas).
- * @returns a hue in degrees, or null when the source yields no vivid color.
- */
-export declare function extractDominantHue(source: CanvasImageSource): number | null;
+/**
+ * Wallpaper color extraction — a small, dependency-free dominant-hue finder.
+ *
+ * The wallpaper (image or video frame) is drawn onto a tiny canvas, and the
+ * pixels are folded into a circular hue histogram weighted by saturation and
+ * mid-lightness, so gray/black/white areas contribute nothing and the result
+ * is the image's most vivid, representative hue. Returns a single hue in
+ * degrees (0-360), or null when the source is too desaturated to read.
+ */
+/**
+ * Extract the dominant hue from a canvas-image source (img / video / canvas).
+ * @returns a hue in degrees, or null when the source yields no vivid color.
+ */
+export declare function extractDominantHue(source: CanvasImageSource): number | null;

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

@@ -1,21 +1,21 @@
-/**
- * Ambient marine-life scene: the markup the layer injects behind the app
- * frame — brand-fish silhouettes drifting, a shrimp or two crawling the
- * bottom, rising bubbles, twinkling plankton. Positions, sizes, and
- * per-critter timing ride inline styles; the motion itself lives in
- * aqua.module.css (and silences under prefers-reduced-motion).
- */
-/**
- * The complete ambient scene markup: one fixed, click-transparent container
- * the layer prepends to <body> while enabled and removes on disable. The
- * deepseek.com fluid shader canvas forms the board; marine life rides over it.
- */
-export declare const AMBIENT_SCENE: string;
-/** Build the ambient container element (or reuse an existing one). */
-export declare function ensureAmbientScene(): HTMLElement;
-/** Remove the ambient container wherever it lives. */
-export declare function removeAmbientScene(): void;
-/** Add the page edge-fade bands (5px gradient blur over the chat content). */
-export declare function ensurePageFades(): void;
-/** Remove the edge-fade bands. */
-export declare function removePageFades(): void;
+/**
+ * Ambient marine-life scene: the markup the layer injects behind the app
+ * frame — brand-fish silhouettes drifting, a shrimp or two crawling the
+ * bottom, rising bubbles, twinkling plankton. Positions, sizes, and
+ * per-critter timing ride inline styles; the motion itself lives in
+ * aqua.module.css (and silences under prefers-reduced-motion).
+ */
+/**
+ * The complete ambient scene markup: one fixed, click-transparent container
+ * the layer prepends to <body> while enabled and removes on disable. The
+ * deepseek.com fluid shader canvas forms the board; marine life rides over it.
+ */
+export declare const AMBIENT_SCENE: string;
+/** Build the ambient container element (or reuse an existing one). */
+export declare function ensureAmbientScene(): HTMLElement;
+/** Remove the ambient container wherever it lives. */
+export declare function removeAmbientScene(): void;
+/** Add the page edge-fade bands (5px gradient blur over the chat content). */
+export declare function ensurePageFades(): void;
+/** Remove the edge-fade bands. */
+export declare function removePageFades(): void;

package/lib/types/client/fluid-interactions.d.ts

@@ -1,19 +1,19 @@
-/**
- * Fluid interaction feeds: buttons ripple on hover/click with a damped
- * stir (the shader settles the wake softly). Scroll wakes were removed by
- * request — feedback stays action-driven and gentle. Coordinates are
- * normalized per the single full-screen canvas so the ripple lands where
- * the action happened. Site policy (no passive mouse trail) is preserved.
- */
-import type { FluidShaderHandle } from './fluid-shader.ts';
-/** The one live fluid surface. */
-export interface FluidTargets {
-    main: FluidShaderHandle;
-    mainCanvas: HTMLCanvasElement;
-}
-/**
- * Attach the button ripple listeners.
- * @param targets - the fluid handle and its canvas.
- * @returns disposer removing every listener.
- */
-export declare function attachFluidInteractions(targets: FluidTargets): () => void;
+/**
+ * Fluid interaction feeds: buttons ripple on hover/click with a damped
+ * stir (the shader settles the wake softly). Scroll wakes were removed by
+ * request — feedback stays action-driven and gentle. Coordinates are
+ * normalized per the single full-screen canvas so the ripple lands where
+ * the action happened. Site policy (no passive mouse trail) is preserved.
+ */
+import type { FluidShaderHandle } from './fluid-shader.ts';
+/** The one live fluid surface. */
+export interface FluidTargets {
+    main: FluidShaderHandle;
+    mainCanvas: HTMLCanvasElement;
+}
+/**
+ * Attach the button ripple listeners.
+ * @param targets - the fluid handle and its canvas.
+ * @returns disposer removing every listener.
+ */
+export declare function attachFluidInteractions(targets: FluidTargets): () => void;

package/lib/types/client/fluid-shader.d.ts

@@ -1,57 +1,57 @@
-/**
- * Faithful port of the deepseek.com join-section fluid shader
- * (`ds-join-shader-bg`): a WebGL2 two-pass fluid simulation — a quarter-res
- * flow field (decay + pointer brush with velocity, ping-ponged between two
- * framebuffers) sampled by a full-res domain-warped noise renderer with
- * swirl iterations and a three-color soft blend. Shader sources are verbatim
- * from the site bundle; uniform wiring, the 30fps throttle, the 1.5x pixel
- * ratio cap, and the pointer-listener policy (touch and Windows skip the
- * mouse feed) are replicated exactly. Reduced-motion renders one static
- * frame instead of the loop.
- */
-/** Site-default parameters (the join-section look). */
-export interface FluidParams {
-    mouseRadius: number;
-    mouseStrength: number;
-    decay: number;
-    distortBoost: number;
-    noiseBoost: number;
-    swirlBoost: number;
-    speed: number;
-    distortion: number;
-    swirl: number;
-    swirlIterations: number;
-    scale: number;
-    rotation: number;
-    proportion: number;
-    softness: number;
-    shapeScale: number;
-    offsetX: number;
-    offsetY: number;
-    color1: string;
-    color2: string;
-    color3: string;
-}
-/** The exact default parameter set shipped by the site. */
-export declare const SITE_FLUID_PARAMS: FluidParams;
-/** Handle returned by {@link attachFluidShader}. */
-export interface FluidShaderHandle {
-    /** Update simulation parameters (e.g. a palette switch) without re-mounting. */
-    setParams: (params: FluidParams) => void;
-    /** Stir the fluid at normalized coordinates with a velocity burst (wakes). */
-    stir: (x: number, y: number, vx: number, vy: number) => void;
-    /** Audio reactivity: bass energy 0..1 speeds the flow and amplifies the
-     *  turbulence (ripple amplitude). */
-    setAudioLow: (level: number) => void;
-    /** Pause or resume the simulation loop. A paused board keeps the last frame. */
-    setRunning: (on: boolean) => void;
-    /** Stop the loop and release listeners. */
-    dispose: () => void;
-}
-/**
- * Mount the fluid simulation on a canvas and run it until disposed.
- * @param canvas - full-size canvas element (CSS-sized by the ambient layer).
- * @param params - simulation parameters (site defaults are the natural input).
- * @returns the live handle.
- */
-export declare function attachFluidShader(canvas: HTMLCanvasElement, params: FluidParams): FluidShaderHandle;
+/**
+ * Faithful port of the deepseek.com join-section fluid shader
+ * (`ds-join-shader-bg`): a WebGL2 two-pass fluid simulation — a quarter-res
+ * flow field (decay + pointer brush with velocity, ping-ponged between two
+ * framebuffers) sampled by a full-res domain-warped noise renderer with
+ * swirl iterations and a three-color soft blend. Shader sources are verbatim
+ * from the site bundle; uniform wiring, the 30fps throttle, the 1.5x pixel
+ * ratio cap, and the pointer-listener policy (touch and Windows skip the
+ * mouse feed) are replicated exactly. Reduced-motion renders one static
+ * frame instead of the loop.
+ */
+/** Site-default parameters (the join-section look). */
+export interface FluidParams {
+    mouseRadius: number;
+    mouseStrength: number;
+    decay: number;
+    distortBoost: number;
+    noiseBoost: number;
+    swirlBoost: number;
+    speed: number;
+    distortion: number;
+    swirl: number;
+    swirlIterations: number;
+    scale: number;
+    rotation: number;
+    proportion: number;
+    softness: number;
+    shapeScale: number;
+    offsetX: number;
+    offsetY: number;
+    color1: string;
+    color2: string;
+    color3: string;
+}
+/** The exact default parameter set shipped by the site. */
+export declare const SITE_FLUID_PARAMS: FluidParams;
+/** Handle returned by {@link attachFluidShader}. */
+export interface FluidShaderHandle {
+    /** Update simulation parameters (e.g. a palette switch) without re-mounting. */
+    setParams: (params: FluidParams) => void;
+    /** Stir the fluid at normalized coordinates with a velocity burst (wakes). */
+    stir: (x: number, y: number, vx: number, vy: number) => void;
+    /** Audio reactivity: bass energy 0..1 speeds the flow and amplifies the
+     *  turbulence (ripple amplitude). */
+    setAudioLow: (level: number) => void;
+    /** Pause or resume the simulation loop. A paused board keeps the last frame. */
+    setRunning: (on: boolean) => void;
+    /** Stop the loop and release listeners. */
+    dispose: () => void;
+}
+/**
+ * Mount the fluid simulation on a canvas and run it until disposed.
+ * @param canvas - full-size canvas element (CSS-sized by the ambient layer).
+ * @param params - simulation parameters (site defaults are the natural input).
+ * @returns the live handle.
+ */
+export declare function attachFluidShader(canvas: HTMLCanvasElement, params: FluidParams): FluidShaderHandle;

package/lib/types/client/fluid-tones.d.ts

@@ -1,30 +1,30 @@
-/**
- * Continuous fluid palette: hue (0-360) and depth (0-100) sliders drive the
- * shader colors directly through HSL interpolation — stepless, no preset
- * steps. Depth 0 = the deep, saturated version of the hue (e.g. #8B0000 for
- * red), depth 100 = the pale, light version (e.g. #FFCCCB); the deep base
- * stop stays near-neutral so the colorless areas keep their true color.
- */
-export interface FluidToneColors {
-    /** Bright bloom stop. */
-    color1: string;
-    /** Mid wash stop. */
-    color2: string;
-    /** Deep base stop (near-neutral). */
-    color3: string;
-}
-/** The slider's 0/360 lands directly on the hue (HUE_BASE 0 keeps the
- *  Mineradio default at 44 = champagne gold), sweeping clockwise around the
- *  wheel — 44 lands on warm amber, 180 on mint. */
-export declare const HUE_BASE = 0;
-/**
- * Palette for the given hue (0-360) and depth (0-100), per scheme.
- * The depth ramp is piecewise: the lower half sweeps from the absolute
- * extreme — pure black in dark mode, the deep saturated shade (e.g. #8B0000
- * for red) in light mode — up to the shipped mid look; the upper half
- * sweeps from mid to pale (#FFCCCB for red). Stepless HSL interpolation.
- */
-export declare function fluidToneColors(dark: boolean, hue: number, depth: number): FluidToneColors;
-/** Vivid, fixed-lightness colour for a hue — used to fill the rainbow-strip
- *  thumb so it always shows the picked colour in dark and light mode alike. */
-export declare function fluidHueSwatch(hue: number): string;
+/**
+ * Continuous fluid palette: hue (0-360) and depth (0-100) sliders drive the
+ * shader colors directly through HSL interpolation — stepless, no preset
+ * steps. Depth 0 = the deep, saturated version of the hue (e.g. #8B0000 for
+ * red), depth 100 = the pale, light version (e.g. #FFCCCB); the deep base
+ * stop stays near-neutral so the colorless areas keep their true color.
+ */
+export interface FluidToneColors {
+    /** Bright bloom stop. */
+    color1: string;
+    /** Mid wash stop. */
+    color2: string;
+    /** Deep base stop (near-neutral). */
+    color3: string;
+}
+/** The slider's 0/360 lands directly on the hue (HUE_BASE 0 keeps the
+ *  Mineradio default at 44 = champagne gold), sweeping clockwise around the
+ *  wheel — 44 lands on warm amber, 180 on mint. */
+export declare const HUE_BASE = 0;
+/**
+ * Palette for the given hue (0-360) and depth (0-100), per scheme.
+ * The depth ramp is piecewise: the lower half sweeps from the absolute
+ * extreme — pure black in dark mode, the deep saturated shade (e.g. #8B0000
+ * for red) in light mode — up to the shipped mid look; the upper half
+ * sweeps from mid to pale (#FFCCCB for red). Stepless HSL interpolation.
+ */
+export declare function fluidToneColors(dark: boolean, hue: number, depth: number): FluidToneColors;
+/** Vivid, fixed-lightness colour for a hue — used to fill the rainbow-strip
+ *  thumb so it always shows the picked colour in dark and light mode alike. */
+export declare function fluidHueSwatch(hue: number): string;

package/lib/types/client/glass-dispersion.d.ts

@@ -1,29 +1,29 @@
-/**
- * Mineradio glass dispersion filter — a reworked, single-tint port of the
- * player's `mineradio-control-glass-filter`.
- *
- * The original couples refraction and RGB channel split (which screen-blends
- * into an ugly magenta/purple). Here the two are separated:
- *
- *   - REFRACTION: a colourless `feDisplacementMap` warps the backdrop through
- *     a generated noise map (a blurred rounded-rect "clear centre" + red/blue
- *     gradients), so the things behind the glass visibly bend at the edges.
- *   - EDGE TINT: the refracted backdrop is laterally shifted and differenced
- *     against itself (`feBlend mode="difference"`), which isolates the edge
- *     signal only; a `feColorMatrix` then fills that signal with a SINGLE
- *     user-picked hue, luminance-driven alpha (so it stays transparent and
- *     edge-only), screen-blended over the refraction.
- *
- * The tint hue is adjustable at runtime via `setTint(hue)`. Chromium-only
- * (SVG `url()` in `backdrop-filter` is unsupported by Safari/Firefox); the
- * layer keeps its plain blur fallback there.
- */
-export interface GlassDispersionHandle {
-    /** Re-colour the edge tint (hue in degrees, continuous). */
-    setTint(hue: number): void;
-    /** Set the refraction strength (0-100 — the feDisplacementMap scale). */
-    setRefraction(scale: number): void;
-    dispose(): void;
-}
-/** Start the glass dispersion filter and stamp the enabling attribute. */
-export declare function startGlassDispersion(): GlassDispersionHandle;
+/**
+ * Mineradio glass dispersion filter — a reworked, single-tint port of the
+ * player's `mineradio-control-glass-filter`.
+ *
+ * The original couples refraction and RGB channel split (which screen-blends
+ * into an ugly magenta/purple). Here the two are separated:
+ *
+ *   - REFRACTION: a colourless `feDisplacementMap` warps the backdrop through
+ *     a generated noise map (a blurred rounded-rect "clear centre" + red/blue
+ *     gradients), so the things behind the glass visibly bend at the edges.
+ *   - EDGE TINT: the refracted backdrop is laterally shifted and differenced
+ *     against itself (`feBlend mode="difference"`), which isolates the edge
+ *     signal only; a `feColorMatrix` then fills that signal with a SINGLE
+ *     user-picked hue, luminance-driven alpha (so it stays transparent and
+ *     edge-only), screen-blended over the refraction.
+ *
+ * The tint hue is adjustable at runtime via `setTint(hue)`. Chromium-only
+ * (SVG `url()` in `backdrop-filter` is unsupported by Safari/Firefox); the
+ * layer keeps its plain blur fallback there.
+ */
+export interface GlassDispersionHandle {
+    /** Re-colour the edge tint (hue in degrees, continuous). */
+    setTint(hue: number): void;
+    /** Set the refraction strength (0-100 — the feDisplacementMap scale). */
+    setRefraction(scale: number): void;
+    dispose(): void;
+}
+/** Start the glass dispersion filter and stamp the enabling attribute. */
+export declare function startGlassDispersion(): GlassDispersionHandle;

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

@@ -1,24 +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;
+/**
+ * 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/host-store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Host store adapter. Mineradio 2.3.1 talks to `@deepseek-ai/dsh-client-store`;
+ * 2.3.2+ talks to `@deepseek-ai/dsh-client-runtime/client`.
+ */
+export interface EngineStoreHandle<State, Actions> {
+    spec: unknown;
+    create: (scopeKey?: string) => {
+        actions: Actions;
+        getSnapshot: () => State;
+        subscribe: (fn: () => void) => () => void;
+        store: unknown;
+        clearPersisted: () => void;
+    };
+}
+type DefineStoreFn = <State, Actions extends Record<string, (...args: never[]) => unknown>>(decl: {
+    init: () => State;
+    persist?: string;
+    actions: {
+        [K in keyof Actions]: (draft: State, ...args: Parameters<Actions[K]>) => void;
+    };
+}) => EngineStoreHandle<State, Actions>;
+export declare function loadHostDefineStore(requireFn: (id: string) => unknown): DefineStoreFn;
+export declare const defineStore: DefineStoreFn;
+export {};

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

@@ -1,21 +1,21 @@
-/**
- * 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 { 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.
- * @param ctx - client cordis context.
- */
-export declare function apply(ctx: Context): void;
+/**
+ * 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 { 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.
+ * @param ctx - client cordis context.
+ */
+export declare function apply(ctx: Context): void;