dsh-dream-skin 0.4.13 → 0.4.14

package/docs/i18n/README.de.md

@@ -383,3 +383,15 @@ Ein Sicherheitsproblem gefunden? Öffne kein öffentliches Issue — siehe die [
 
 - Architektur- & API-Referenz: das offizielle Client-Paket [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) von DeepSeek Harness.
 - Konzept-Hommage: [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 Wachstumskurve
+
+> Täglich automatisch aktualisiert (GitHub Actions). Linke Achse: **kumulierte Downloads** (türkis); rechte Achse: **Sternezahl** (violett) — sehr unterschiedliche Größenordnungen, daher zwei unabhängige Y-Achsen.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="Tägliche Wachstumskurve Star × kumulierte Downloads von dsh-dream-skin" width="900"/>
+</p>
+
+*Die Daten werden alle 24 Stunden gesammelt: Downloads über die [offizielle npm-API](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), Sterne über die [GitHub-API](https://github.com/RevolutionLA/dsh-dream-skin/stargazers).*

package/docs/i18n/README.en.md

@@ -383,3 +383,16 @@ Found a security issue? Don't open a public issue — see the [Security Policy](
 - Architecture & API reference: the official DeepSeek Harness
   [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) client package.
 - Concept homage: [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 Growth chart
+
+> Updated automatically every day (GitHub Actions). Left axis: **cumulative downloads** (teal); right axis:
+> **Star count** (purple) — two very different magnitudes, so each has its own independent Y-axis.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="dsh-dream-skin daily Stars × cumulative downloads growth chart" width="900"/>
+</p>
+
+*Data is collected every 24 hours: downloads from the [npm API](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), Stars from the [GitHub API](https://github.com/RevolutionLA/dsh-dream-skin/stargazers).*

package/docs/i18n/README.es.md

@@ -390,3 +390,15 @@ que el proyecto se descubra y se mantenga. ¿Quieres contribuir con themes / un
 - Referencia de arquitectura y API: el paquete de cliente
   [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) oficial de DeepSeek Harness.
 - Homenaje conceptual: [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 Curva de crecimiento
+
+> Actualizada automáticamente cada día (GitHub Actions). Eje izquierdo: **descargas acumuladas** (verde); eje derecho: **número de Stars** (púrpura) — magnitudes muy distintas, por eso cada uno tiene su propio eje Y independiente.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="Curva de crecimiento diario Star × descargas acumuladas de dsh-dream-skin" width="900"/>
+</p>
+
+*Los datos se recogen cada 24 horas: las descargas desde la [API oficial de npm](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), y las Stars desde la [API de GitHub](https://github.com/RevolutionLA/dsh-dream-skin/stargazers).*

package/docs/i18n/README.fr.md

@@ -382,3 +382,15 @@ Vous avez trouvé un problème de sécurité ? N'ouvrez pas d'issue publique —
 - Référence d'architecture & d'API : le package client
   [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) officiel de DeepSeek Harness.
 - Hommage conceptuel : [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 Courbe de croissance
+
+> Mise à jour automatique chaque jour (GitHub Actions). Axe gauche : **téléchargements cumulés** (turquoise) ; axe droit : **nombre d'étoiles** (violet) — des ordres de grandeur très différents, d'où deux axes Y indépendants.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="Courbe de croissance quotidienne Star × téléchargements cumulés de dsh-dream-skin" width="900"/>
+</p>
+
+*Les données sont collectées toutes les 24 h : téléchargements via l'[API officielle npm](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), étoiles via l'[API GitHub](https://github.com/RevolutionLA/dsh-dream-skin/stargazers).*

package/docs/i18n/README.ja.md

@@ -347,3 +347,15 @@ Issue と PR は大歓迎です！[コントリビューションガイド](../.
 
 - アーキテクチャ & API リファレンス：公式 DeepSeek Harness の [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) クライアントパッケージ。
 - コンセプトのオマージュ：[Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin)。
+
+---
+
+## 📈 成長カーブ
+
+> 毎日自動更新（GitHub Actions）。左軸：**累計ダウンロード数**（青）；右軸：**Star 数**（紫）——桁が大きく異なるため、それぞれ独立した双軸を使用しています。
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="dsh-dream-skin 毎日の Star × 累計ダウンロード数 成長カーブ" width="900"/>
+</p>
+
+*データは 24 時間ごとに自動取得：ダウンロード数は [npm 公式API](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin)、Star 数は [GitHub API](https://github.com/RevolutionLA/dsh-dream-skin/stargazers) から取得しています。*

package/docs/i18n/README.ko.md

@@ -383,3 +383,15 @@ Issues와 PR을 환영합니다! [기여 가이드](../../CONTRIBUTING.md)를
 - 아키텍처 & API 참고: 공식 DeepSeek Harness
   [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme) 클라이언트 패키지.
 - 컨셉 오마주: [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 성장 곡선
+
+> 매일 자동 업데이트(GitHub Actions). 왼쪽 축: **누적 다운로드 수**(청록); 오른쪽 축: **Star 수**(보라) — 규모가 크게 달라 각각 독립된 이중 축을 사용합니다.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="dsh-dream-skin 매일 Star × 누적 다운로드 수 성장 곡선" width="900"/>
+</p>
+
+*데이터는 24시간마다 자동 수집됩니다: 다운로드 수는 [npm 공식 API](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), Star 수는 [GitHub API](https://github.com/RevolutionLA/dsh-dream-skin/stargazers)에서 가져옵니다.*

package/docs/i18n/README.ru.md

@@ -383,3 +383,15 @@ dsh web   # восстанавливает официальный вид
 - Справочник по архитектуре и API: официальный клиентский пакет DeepSeek Harness
   [ui-theme](https://github.com/deepseek-ai/deepseek-harness/tree/master/packages/client/ui-theme).
 - Концептуальная дань: [Codex-Dream-Skin](https://github.com/Fei-Away/Codex-Dream-Skin).
+
+---
+
+## 📈 Кривая роста
+
+> Автоматически обновляется ежедневно (GitHub Actions). Левая ось: **суммарные скачивания** (бирюзовый); правая ось: **число звёзд** (фиолетовый) — сильно разные порядки величин, поэтому у каждого своя независимая ось Y.
+
+<p align="center">
+  <img src="../../docs/stats.png" alt="Ежедневная кривая роста Star × суммарные скачивания dsh-dream-skin" width="900"/>
+</p>
+
+*Данные собираются каждые 24 часа: скачивания — из [официального API npm](https://api.npmjs.org/downloads/range/2026-08-15:2026-12-31/dsh-dream-skin), звёзды — из [API GitHub](https://github.com/RevolutionLA/dsh-dream-skin/stargazers).*

package/lib/client.js

@@ -1022,8 +1022,59 @@ window.__ModuleLoader__.load({
 		//#region dsh-dream-skin: wallpaper layer + token shading
 		/** The fixed backdrop layer (z-index -1), created lazily. */
 		let wallpaperEl = null;
-		/** Disposer for the current token-override layer. */
-		let wallpaperOverrideDispose = null;
+		/**
+		 * Dynamic packages are assigned one token-override source by the production
+		 * client runner, regardless of the source label passed by the package. Keep
+		 * every Dream Skin contribution in one layer so wallpaper, popup opacity and
+		 * accent do not replace one another there.
+		 */
+		const COMBINED_OVERRIDE_SOURCE = "dsh-dream-skin:appearance";
+		let combinedOverrideDispose = null;
+		let combinedOverrideApplying = false;
+		let wallpaperTokenOverrides = {};
+		let popupTokenOverrides = {};
+		let accentTokenOverrides = {};
+
+		function rawActiveTheme(snapshot) {
+			// `preference` is the authoritative selected theme id. In the production
+			// dynamic-package event facade, `snapshot.active` can already be the
+			// composed presentation object (and has been observed without a usable
+			// third-party id). Looking it up by `active.id` then falls through to the
+			// composed tokens and feeds our previous wallpaper wash back into the next
+			// skin. Prefer the registered definition selected by `preference`; only use
+			// active.id for `system`, where it resolves to the concrete light/dark theme.
+			const savedId = readSavedSkin();
+			const selectedId = typeof savedId === "string" && savedId !== DEFAULT_SKIN
+				? savedId
+				: snapshot.preference === "system"
+				? snapshot.active?.id
+				: snapshot.preference;
+			return snapshot.themes?.find((theme) => theme.id === selectedId)
+				|| snapshot.themes?.find((theme) => theme.id === snapshot.active?.id)
+				|| snapshot.active;
+		}
+
+		function applyCombinedTokenOverrides(ctx) {
+			if (combinedOverrideApplying) return;
+			combinedOverrideApplying = true;
+			try {
+				const overrides = {
+					...popupTokenOverrides,
+					...accentTokenOverrides,
+					...wallpaperTokenOverrides
+				};
+				if (Object.keys(overrides).length > 0) {
+					const previousDispose = combinedOverrideDispose;
+					combinedOverrideDispose = ctx.theme.overrideTokens(COMBINED_OVERRIDE_SOURCE, overrides);
+					previousDispose?.();
+				} else {
+					combinedOverrideDispose?.();
+					combinedOverrideDispose = null;
+				}
+			} finally {
+				combinedOverrideApplying = false;
+			}
+		}
 		/** The injected liquid-glass <style> node (leaf-card backdrop blur). */
 		let materialStyleEl = null;
 
@@ -1059,12 +1110,12 @@ window.__ModuleLoader__.load({
 			return resolveBase(scheme, active);
 		}
 
-		/** Remove the wallpaper layer and its token overrides (fiber unload). */
-		function teardownWallpaper() {
+		/** Remove the wallpaper layer and its token contribution. */
+		function teardownWallpaper(ctx = null) {
 			wallpaperEl?.remove();
 			wallpaperEl = null;
-			wallpaperOverrideDispose?.();
-			wallpaperOverrideDispose = null;
+			wallpaperTokenOverrides = {};
+			if (ctx !== null) applyCombinedTokenOverrides(ctx);
 		}
 
 		//#region dsh-dream-skin: liquid-glass material CSS
@@ -1220,12 +1271,11 @@ window.__ModuleLoader__.load({
 		 * Pure token override (no backdrop-filter), so it cannot re-trigger the
 		 * fixed-modal containing-block bug. Called at boot and on every slider move.
 		 */
-		const POPUP_OVERRIDE_SOURCE = "dsh-dream-skin:popup-opacity";
 		const POPUP_TOKENS = ["--dsw-alias-bg-overlay", "--dsw-specific-menu"];
-		let popupOverrideDispose = null;
 		function applyModalOverlay(ctx) {
 			const alpha = readModalOpacity();
-			const active = ctx.theme.getTheme().active;
+			const current = ctx.theme.getTheme();
+			const active = rawActiveTheme(current);
 			const baseFor = (scheme) => {
 				if (active && active.colorScheme === scheme && typeof active.tokens["--dsw-alias-bg-base"] === "string") {
 					return active.tokens["--dsw-alias-bg-base"];
@@ -1239,8 +1289,8 @@ window.__ModuleLoader__.load({
 					dark: toRgba(baseFor("dark"), alpha)
 				};
 			}
-			popupOverrideDispose?.();
-			popupOverrideDispose = ctx.theme.overrideTokens(POPUP_OVERRIDE_SOURCE, overrides);
+			popupTokenOverrides = overrides;
+			applyCombinedTokenOverrides(ctx);
 		}
 		//#endregion
 
@@ -2498,8 +2548,6 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		//#region dsh-dream-skin: P0 accent override
-		/** Source identity for the per-user accent override layer. */
-		const ACCENT_OVERRIDE_SOURCE = "dsh-dream-skin:accent";
 		/** Token names the accent override shades (brand + primary surfaces). */
 		const ACCENT_TOKENS = [
 			"--dsw-alias-brand-primary",
@@ -2507,8 +2555,6 @@ window.__ModuleLoader__.load({
 			"--dsw-alias-button-primary-fill",
 			"--dsw-alias-button-primary-dimmed"
 		];
-		/** Disposer for the active accent override layer. */
-		let accentOverrideDispose = null;
 		/** Cached accent currently applied (hex or null). */
 		let appliedAccent = null;
 
@@ -2528,16 +2574,16 @@ window.__ModuleLoader__.load({
 		function applyAccent(ctx) {
 			const accent = readAccent();
 			if (accent === null) {
-				accentOverrideDispose?.();
-				accentOverrideDispose = null;
+				accentTokenOverrides = {};
+				applyCombinedTokenOverrides(ctx);
 				appliedAccent = null;
 				return null;
 			}
 			const pair = { light: accent, dark: accent };
 			const overrides = {};
 			for (const name of ACCENT_TOKENS) overrides[name] = pair;
-			accentOverrideDispose?.();
-			accentOverrideDispose = ctx.theme.overrideTokens(ACCENT_OVERRIDE_SOURCE, overrides);
+			accentTokenOverrides = overrides;
+			applyCombinedTokenOverrides(ctx);
 			appliedAccent = accent;
 			return accent;
 		}
@@ -2550,8 +2596,6 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		//#region dsh-dream-skin: P0 wallpaper 2.0 (url / gradient / auto-dim)
-		/** Unique source identity for the wallpaper (already composited) layer. */
-		const WALLPAPER_OVERRIDE_SOURCE = "dsh-dream-skin:wallpaper";
 		/** Read wallpaper kind (image|url|gradient). */
 		function readWallpaperKind() {
 			const kind = readStorage(WALLPAPER_KIND_KEY);
@@ -2634,7 +2678,7 @@ window.__ModuleLoader__.load({
 				const bg = wallpaperBackgroundCss();
 				const urlIsSet = bg !== null;
 				if (!urlIsSet) {
-					teardownWallpaper();
+					teardownWallpaper(ctx);
 					return;
 				}
 				if (wallpaperEl === null || !document.body.contains(wallpaperEl)) {
@@ -2660,7 +2704,7 @@ window.__ModuleLoader__.load({
 			// ThemeRuntime composes token override layers into snapshot.active. Reading
 			// the active value here would feed our previous wallpaper wash back into the
 			// next wash and hide the newly selected skin's raw base/sidebar colors.
-			const active = current.themes?.find((theme) => theme.id === current.active.id) || current.active;
+			const active = rawActiveTheme(current);
 			// When "link sidebar to main canvas" is on (default), the sidebar wash
 			// uses the same alpha as the main canvas so the two halves don't look
 			// split; when off, it uses the separately configured sidebar opacity.
@@ -2675,8 +2719,8 @@ window.__ModuleLoader__.load({
 					dark: toRgba(resolveSidebar("dark", active), sidebarAlpha)
 				}
 			};
-			wallpaperOverrideDispose?.();
-			wallpaperOverrideDispose = ctx.theme.overrideTokens(WALLPAPER_OVERRIDE_SOURCE, overrides);
+			wallpaperTokenOverrides = overrides;
+			applyCombinedTokenOverrides(ctx);
 		}
 
 		// Wallpaper store bookkeeping lives at module scope so the module-level
@@ -2753,7 +2797,7 @@ window.__ModuleLoader__.load({
 			writeStorage(WALLPAPER_URL_KEY, null);
 			writeStorage(WALLPAPER_GRADIENT_KEY, null);
 			writeStorage(WALLPAPER_KIND_KEY, null);
-			teardownWallpaper();
+			teardownWallpaper(ctx);
 			syncWallpaper();
 		}
 
@@ -3254,8 +3298,11 @@ window.__ModuleLoader__.load({
 				teardownWallpaper();
 				teardownMaterial();
 				disposeAllPacks();
-				popupOverrideDispose?.();
-				popupOverrideDispose = null;
+				popupTokenOverrides = {};
+				accentTokenOverrides = {};
+				wallpaperTokenOverrides = {};
+				combinedOverrideDispose?.();
+				combinedOverrideDispose = null;
 			}, "dsh-dream-skin: wallpaper + material + packs cleanup");
 
 			const skinStore = createSkinStore();
@@ -3265,6 +3312,7 @@ window.__ModuleLoader__.load({
 			// updates on every click — even if theme/change timing races or the host
 			// revision doesn't bump as expected — so the selected card follows instantly.
 			let skinRevision = 0;
+			let wallpaperReshadeTimer = null;
 			const syncSkinWith = (id) => {
 				skinBound?.sync(id, ++skinRevision);
 				// Do NOT re-shade the wallpaper here (issue #29): right after
@@ -3279,12 +3327,24 @@ window.__ModuleLoader__.load({
 			};
 			const syncSkin = (snapshot) => {
 				skinBound?.sync(snapshot.preference, ++skinRevision);
-				// snapshot.active is the settled target skin here — safe to re-shade the
-				// wallpaper wash with the target skin's raw tokens. Pass the full snapshot
-				// so shadeTokens2 can ignore its own composed override layer.
-				if (wallpaperBackgroundCss() !== null) applyWallpaper2(ctx, snapshot);
+				// Theme events are synchronous. Re-shading inside this listener publishes a
+				// nested theme/change; a presenter registered after us can then apply the
+				// outer (pre-shade) snapshot last, leaving the wallpaper one skin behind.
+				// Run after the current event stack instead. Events emitted by our own
+				// override happen while _applyingWallpaper is true and must not enqueue a
+				// second pass.
+				if (wallpaperBackgroundCss() !== null && !_applyingWallpaper) {
+					if (wallpaperReshadeTimer !== null) clearTimeout(wallpaperReshadeTimer);
+					wallpaperReshadeTimer = setTimeout(() => {
+						wallpaperReshadeTimer = null;
+						applyWallpaper2(ctx, ctx.theme.getTheme());
+					}, 0);
+				}
 			};
 			ctx.on("theme/change", syncSkin);
+			ctx.effect(() => () => {
+				if (wallpaperReshadeTimer !== null) clearTimeout(wallpaperReshadeTimer);
+			}, "dsh-dream-skin: deferred wallpaper re-shade");
 			// Keep the Accent row's base color (the active theme's brand color) in
 			// sync when the skin/scheme changes — otherwise a row with no custom
 			// accent keeps showing the PREVIOUS skin's brand color until remount.
@@ -3321,8 +3381,11 @@ window.__ModuleLoader__.load({
 				syncSkin(ctx.theme.getTheme());
 				return {
 					setSkin: (id) => {
-						ctx.theme.setTheme(id);
+						// Persist first: theme/change is synchronous. Wallpaper re-shading
+						// must see the new selection (and Default must already have cleared
+						// the old skin) while that event is being handled.
 						writeSavedSkin(id);
+						ctx.theme.setTheme(id);
 						// Deterministically push the new preference into the slot store AND
 						// re-shade the wallpaper so the selected card follows immediately,
 						// independent of theme/change emission timing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-dream-skin",
-  "version": "0.4.13",
+  "version": "0.4.14",
   "description": "DeepSeek Harness 换肤插件（Dream Skin for DSH）：8 套 iOS / Linear 式清透冷调的高质感主题 + 弥散光壁纸 + 每皮肤智能背景 + 强调色 + 主题包分享，把换肤做成材质与配色克制的高级感工艺，而非贴图 — in the spirit of Codex Dream Skin, elevated.",
   "license": "MIT",
   "type": "module",