dsh-client-ui-seaglass 1.6.0

package/lib/index.js

@@ -0,0 +1,27 @@
+import z from "@deepseek-ai/schemastery";
+
+//#region src/aqua-settings-constants.ts
+/** Settings namespace shared by the Host registration and browser card. */
+const AQUA_SETTINGS_NAMESPACE = "ui-aqua";
+/** Field carrying the durable layer enable flag. */
+const AQUA_ENABLED_FIELD = "enabled";
+
+//#endregion
+//#region src/aqua-settings.ts
+/** Aqua theme-layer preference stored in the Host user-settings document. */
+/** Default state when the user-settings document has no override: on. */
+const DEFAULT_ENABLED = true;
+/** Durable schema shared by the Host registration and browser settings scope. */
+const AquaSettingsSchema = z.object({ [AQUA_ENABLED_FIELD]: z.boolean().default(true) });
+
+//#endregion
+//#region src/index.ts
+/** Register the Aqua settings namespace when the Host settings service exists. */
+function apply(ctx) {
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.register(AQUA_SETTINGS_NAMESPACE, AquaSettingsSchema);
+	});
+}
+
+//#endregion
+export { AQUA_ENABLED_FIELD, AQUA_SETTINGS_NAMESPACE, AquaSettingsSchema, DEFAULT_ENABLED, apply };

package/lib/invariant.js

@@ -0,0 +1,21 @@
+//#region src/invariant.ts
+const PACKAGE_NAME = "dsh-client-ui-seaglass";
+/** Cordis companion plugin name. */
+const name = "client-ui-seaglass-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the theme layer holds no cross-plugin mutable state —
+* token overrides, the DOM attribute, the ambient layer, and the greeting
+* observer are all owned effects disposed with the plugin fiber.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+
+//#endregion
+export { apply, inject, name };

package/lib/types/aqua-settings-constants.d.ts

@@ -0,0 +1,5 @@
+/** Settings namespace shared by the Host registration and browser card. */
+export declare const AQUA_SETTINGS_NAMESPACE = "ui-aqua";
+/** Field carrying the durable layer enable flag. */
+export declare const AQUA_ENABLED_FIELD = "enabled";
+//# sourceMappingURL=aqua-settings-constants.d.ts.map

package/lib/types/aqua-settings.d.ts

@@ -0,0 +1,12 @@
+/** Aqua theme-layer preference stored in the Host user-settings document. */
+import z from '@deepseek-ai/schemastery';
+export { AQUA_ENABLED_FIELD, AQUA_SETTINGS_NAMESPACE } from './aqua-settings-constants.ts';
+/** Durable Aqua section shared by the Host schema and the browser scope. */
+export interface AquaSettings {
+    enabled: boolean;
+}
+/** Default state when the user-settings document has no override: on. */
+export declare const DEFAULT_ENABLED = true;
+/** Durable schema shared by the Host registration and browser settings scope. */
+export declare const AquaSettingsSchema: z<AquaSettings>;
+//# sourceMappingURL=aqua-settings.d.ts.map

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

@@ -0,0 +1,16 @@
+import type { InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { createAquaRowStore } from './settings-store.ts';
+/** Injected business face: the enable write (t rides the standard locale seat). */
+export interface AquaPluginCardInjected {
+    /** Switch the deep-sea layer on or off. */
+    setEnabled: (enabled: boolean) => void;
+}
+/** Full component props: runtime share + store share + locale seat + injected face. */
+export type AquaPluginCardComponentProps = PropsRuntime<'settings.plugin.item'> & PropsStore<ReturnType<typeof createAquaRowStore>> & PropsLocale<'settings.aqua'> & InjectFace<AquaPluginCardInjected>;
+/**
+ * Render the Aqua plugin card.
+ * @param props - composed slot props.
+ * @returns the card list item.
+ */
+export declare function AquaPluginCard({ t, setEnabled, useStore }: AquaPluginCardComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=AquaPluginCard.d.ts.map

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

@@ -0,0 +1,16 @@
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { createAquaRowStore } from './settings-store.ts';
+/** Injected business face: the enable write (t rides the standard locale seat). */
+export interface AquaRowInjected {
+    /** Switch the deep-sea layer on or off. */
+    setEnabled: (enabled: boolean) => void;
+}
+/** Full component props: runtime share + store share + locale seat + injected face. */
+export type AquaRowComponentProps = PropsRuntime<'settings.general.item'> & PropsStore<ReturnType<typeof createAquaRowStore>> & PropsLocale<'settings.aqua'> & AquaRowInjected;
+/**
+ * Render the Aqua row.
+ * @param props - composed slot props.
+ * @returns the row element tree.
+ */
+export declare function AquaRow({ t, setEnabled, useStore }: AquaRowComponentProps): import("react").JSX.Element;
+//# sourceMappingURL=AquaRow.d.ts.map

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

@@ -0,0 +1,18 @@
+/**
+ * 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;
+//# sourceMappingURL=critters.d.ts.map

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

@@ -0,0 +1,20 @@
+/**
+ * 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;
+//# sourceMappingURL=fluid-interactions.d.ts.map

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

@@ -0,0 +1,53 @@
+/**
+ * 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;
+    /** 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;
+//# sourceMappingURL=fluid-shader.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * 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;
+/**
+ * Aqua placeholder for the hero composer, matched to the active locale.
+ * @param locale - active locale id.
+ * @returns the placeholder string.
+ */
+export declare function aquaPlaceholder(locale: string): string;
+//# sourceMappingURL=greetings.d.ts.map

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

@@ -0,0 +1,22 @@
+/**
+ * Aqua client plugin body: the toggleable glassmorphism skin. Owns the durable
+ * enable flag through the Host settings namespace, applies/retracts the theme layer through
+ * {@link AquaLayer}, 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 './aqua.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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,25 @@
+/** `settings.aqua` namespace dictionaries (the settings-row copy). */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "settings.aqua";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'aqua.title': string;
+    'aqua.description': string;
+    'aqua.enable': string;
+    'aqua.disable': string;
+};
+export type AquaLocaleKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The Aqua settings row's copy. */
+        'settings.aqua': AquaLocaleKey;
+    }
+}
+/** English dictionary. */
+export declare const en: {
+    'aqua.title': string;
+    'aqua.description': string;
+    'aqua.enable': string;
+    'aqua.disable': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,24 @@
+/**
+ * Aqua row slot store: a mirror of the layer enable flag. 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';
+/** Store state mirrored from the Aqua settings scope. */
+export interface AquaRowState {
+    /** Persisted layer enable flag. */
+    enabled: boolean;
+    /** Monotonic revision; -1 until first sync so revision 0 lands as a change. */
+    revision: number;
+}
+/** Declared action shape giving the exported factory a stable return type. */
+type AquaRowActions = {
+    sync: (draft: AquaRowState, enabled: boolean, revision: number) => void;
+};
+/**
+ * Declares the Aqua row state and write surface.
+ * @returns the store handle.
+ */
+export declare function createAquaRowStore(): EngineStoreHandle<AquaRowState, AquaRowActions>;
+export {};
+//# sourceMappingURL=settings-store.d.ts.map

package/lib/types/client/theme-layer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Aqua theme layer: one toggleable visual skin over the whole Web surface.
+ * Everything this layer owns is an effect — token overrides ride the theme
+ * service's override stack, the CSS hooks ride a `data-dsh-aqua` attribute on
+ * <html> (the stylesheet only applies under it), the hero copy rides a
+ * MutationObserver that decorates new [data-hero-headline] mounts — so
+ * switching the flag off (or unloading the plugin) restores the stock UI
+ * exactly: no residue, no reload.
+ *
+ * The enable flag persists in localStorage: a client-only visual preference
+ * (like the selected-session key), written and read by this plugin alone.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ThemeTokenOverrides } from '@deepseek-ai/dsh-client-ui-theme/client';
+/** html attribute selecting the Aqua layer: CSS hooks and ambient effects. */
+export declare const AQUA_ATTRIBUTE = "data-dsh-aqua";
+/** localStorage key carrying the layer enable flag. */
+export declare const AQUA_ENABLED_KEY = "dsh.ui-aqua.enabled";
+/** Default state when nothing is stored yet: on. */
+export declare const DEFAULT_ENABLED = true;
+/**
+ * Alias-token override layer: the deep-sea palette. Every value is a
+ * `{ light, dark }` pair so the layer stays legible when the user switches
+ * the Appearance preference — dark is deep-sea navy, light is cool white-blue.
+ */
+export declare const AQUA_TOKEN_OVERRIDES: ThemeTokenOverrides;
+/**
+ * Owns the Aqua layer lifecycle: reads the durable enable flag, and applies /
+ * retracts every layer on change. Cross-tab flips arrive through the storage
+ * event; the greeting observer and every subscription are released when the
+ * plugin fiber is disposed.
+ */
+export declare class AquaLayer {
+    private enabled;
+    private tokenDisposer;
+    private mainFluid;
+    private interactionDisposer;
+    private themeListener;
+    private observer;
+    private readonly ctx;
+    /**
+     * @param ctx - owning client context.
+     */
+    constructor(ctx: Context);
+    /** Current enable state (the settings row mirrors this). */
+    getEnabled(): boolean;
+    /** Flip the layer: persist, then apply or retract every owned effect. */
+    setEnabled(value: boolean): void;
+    /** Active locale id for greeting / placeholder copy. */
+    private locale;
+    private sync;
+    private mount;
+    private unmount;
+    /** Attach the fluid shader and the interaction feeds. */
+    private mountFluid;
+    private teardownFluid;
+    private fluidParams;
+    private applyFluidPalettes;
+    /**
+     * Decorate hero mounts as they appear: random greeting per new blank
+     * session, Aqua placeholder on the hero composer.
+     * @param root - added element to scan.
+     */
+    private decorate;
+    private startObserver;
+    private stopObserver;
+}
+//# sourceMappingURL=theme-layer.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Aqua theme-layer plugin, node half. The browser half ships via
+ * exports["./client"], discovered through the package.json dsh.client
+ * declaration. The Host registers the namespace used to expose the browser
+ * card in the current DSH Plugins settings page.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Register the Aqua settings namespace when the Host settings service exists. */
+export declare function apply(ctx: Context): void;
+export { AQUA_ENABLED_FIELD, AQUA_SETTINGS_NAMESPACE, AquaSettingsSchema, DEFAULT_ENABLED, type AquaSettings, } from './aqua-settings.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-aqua`.
+ * @module @deepseek-ai/dsh-client-ui-aqua/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-aqua-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "dsh-client-ui-seaglass",
+  "description": "Seaglass: a highly customizable glassmorphism theme for the Web surface — adjustable blur, frost, fluid or wallpaper backdrop, unified corners, and motion",
+  "version": "1.6.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiyunyunyun/dsh-client-ui-seaglass.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "prepublishOnly": "tsdown"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-store": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-theme": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.2"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml"
+  ],
+  "dependencies": {
+    "@deepseek-ai/schemastery": "3.18.2"
+  }
+}