dsh-dream-skin 0.2.0

package/lib/index.js

@@ -0,0 +1,18 @@
+/**
+ * dsh-dream-skin — host half.
+ *
+ * The host side is intentionally a no-op loader entry: the whole feature
+ * lives in the browser half (`./client`), which DSH's dsh-client-modules
+ * picks up through the package's `dsh.client` declaration — the same shape
+ * as the shipped ui-* packages.
+ *
+ * Why localStorage for persistence? The Host settings wire only exposes an
+ * allowlisted set of namespaces to browser clients
+ * (dsh-host-apiproxy's WEB_SETTINGS_NAMESPACES), so a third-party namespace
+ * would answer `settings-not-exposed`, and the product itself keeps remote
+ * browser preferences process-local. localStorage matches that boundary for a
+ * purely visual preference while surviving reloads on the same origin.
+ */
+
+/** Host loader entry for the browser implementation exported from `./client`. */
+export function apply() {}

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

@@ -0,0 +1,66 @@
+/**
+ * Browser-half type declarations for `dsh-dream-skin`.
+ *
+ * These describe the surface the bundle exports (`SKINS`, `apply`, `inject`)
+ * and the cordis service shape it relies on (`ctx.theme`, `ctx.slots`,
+ * `ctx.locale`). They are advisory — the shipped bundle is plain JS executed
+ * through the shell's lazy-CJS module table, so no runtime import of these
+ * types happens.
+ */
+
+import type { Context } from "@deepseek-ai/cordis";
+import type { DreamSkin, SkinTokens } from "../index.js";
+
+/** Registry definition accepted by ThemeRuntime.register. */
+export interface ThemeRegistration {
+  id: string;
+  colorScheme: "light" | "dark";
+  tokens: SkinTokens;
+}
+
+/** One color scheme for a token override (must be `{ light, dark }`). */
+export interface TokenOverridePair {
+  light: string;
+  dark: string;
+}
+
+/** The immutable theme snapshot published on `theme/change`. */
+export interface ThemeSnapshot {
+  preference: "light" | "dark" | "system" | string;
+  active: ThemeRegistration;
+  themes: ReadonlyArray<ThemeRegistration>;
+  revision: number;
+}
+
+/** The cordis services a browser bundle relies on. */
+export interface DreamSkinCtx extends Context {
+  theme: {
+    getTheme(): ThemeSnapshot;
+    setTheme(id: string): void;
+    register(def: ThemeRegistration): () => void;
+    overrideTokens(source: string, tokens: Record<string, TokenOverridePair>): () => void;
+  };
+  slots: {
+    inject(name: string, register: () => unknown): void;
+    register(desc: Record<string, unknown>, Component: unknown): unknown;
+  };
+  locale: {
+    register(namespace: string, dict: Record<string, Record<string, string>>): () => void;
+  };
+  on(event: "theme/change", handler: (snapshot: ThemeSnapshot) => void): void;
+}
+
+/** Browser-half entry: register skins and settings rows. */
+export function apply(ctx: DreamSkinCtx): void;
+
+/** Services injected before this plugin's `apply`. */
+export const inject: string[];
+
+/** The curated skin catalog (also exported for previews/tests). */
+export const SKINS: DreamSkin[];
+
+/** Sentinel id meaning "follow the built-in appearance". */
+export const DEFAULT_SKIN: "system";
+
+/** The settings-row locale namespace. */
+export const SETTINGS_NS: string;

package/lib/types/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Host-side type declarations for `dsh-dream-skin`.
+ *
+ * The host half is a no-op loader entry — see {@link apply}. All feature
+ * behavior lives in the browser half (`./client`).
+ */
+
+/** Token-name → concrete CSS color for a registered theme (scalar per scheme). */
+export interface SkinTokens {
+  [name: string]: string;
+}
+
+/** A curated skin: an immutable third-party theme definition. */
+export interface DreamSkin {
+  /** Unique theme id (registered into ThemeRuntime; `"system"` is reserved). */
+  id: string;
+  /** Base palette this skin builds on; drives `body[data-ds-dark-theme]`. */
+  colorScheme: "light" | "dark";
+  /** `--dsw-alias-*` token overrides (and component-specific tokens). */
+  tokens: SkinTokens;
+}
+
+/**
+ * Host loader entry. A no-op: the patch layer (cordis.patch.yml) inserts the
+ * `dream-skin` row and dsh-client-modules picks up the browser half through
+ * the package's `dsh.client` declaration, exactly like the shipped ui-*
+ * packages.
+ */
+export function apply(ctx?: unknown): void;

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "dsh-dream-skin",
+  "version": "0.2.0",
+  "description": "DeepSeek Harness 换肤插件 (Dream Skin for DeepSeek Harness): curated --dsw-alias-* theme presets, a custom translucent wallpaper with opacity/blur controls, theme-pack import/export + share links, per-user accent, favorites & surprise-me, and durable per-browser persistence — in the spirit of the Codex Dream Skin project.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types",
+    "cordis.patch.yml"
+  ],
+  "author": "dsh-dream-skin contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RevolutionLA/dsh-dream-skin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RevolutionLA/dsh-dream-skin/issues"
+  },
+  "homepage": "https://github.com/RevolutionLA/dsh-dream-skin#readme",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "plugin",
+    "theme",
+    "skin",
+    "wallpaper",
+    "web-ui",
+    "换肤"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test tests/client.smoke.test.cjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-general"
+      ],
+      "platform": "web",
+      "immediately": true
+    }
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-general": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6"
+  }
+}