dsh-claude-desktop-theme 0.4.3 → 0.4.5

package/lib/types/client/features/model-controls/popup.d.ts

@@ -1,4 +1,23 @@
 import type { RefObject } from 'react';
+interface Size {
+    width: number;
+    height: number;
+}
+/**
+ * The panel's border box, kept between placements.
+ *
+ * Its size changes only when its own content does, which the resize observer
+ * below already reports, so each placement can read the trigger alone instead
+ * of forcing a second layout of the surface. The first read is the seeding one:
+ * the panel has been shown by the time `place()` runs, so its box is real.
+ *
+ * @param surface - the popover element.
+ * @returns the cached size, and a way to re-read it when the observer fires.
+ */
+export declare function cachedSize(surface: Element): {
+    current: () => Size;
+    refresh: () => void;
+};
 /** Viewport-clamped top-layer surface; focus and observers die with the panel. */
 export declare function usePopup(anchor: RefObject<HTMLButtonElement>, close: () => void): {
     panel: RefObject<HTMLDivElement>;
@@ -8,3 +27,4 @@ export declare function usePopup(anchor: RefObject<HTMLButtonElement>, close: ()
         visibility: 'hidden' | 'visible';
     };
 };
+export {};

package/lib/types/client/features/model-controls/selection.d.ts

@@ -36,6 +36,8 @@ export interface EffortViewCopy {
  * @returns every id a commit may carry, in provider order.
  */
 export declare function effortChoices(model: ModelCatalogModel | undefined, defaultName: string): EffortChoice[];
+/** Default marker: a valid provider default wins; otherwise mark High if offered. */
+export declare function effortDefaultIndex(model: ModelCatalogModel | undefined): number;
 /**
  * Lay out the card's stops, the resting thumb, and the trigger caption.
  *

package/lib/types/client/features/new-session/ripples.d.ts

@@ -1,8 +1,8 @@
 import type { HeroRippleImpulse } from '../../contracts/hero-canvas.ts';
-/** One character's stable grain and time-varying light, before the edge fade. */
+/** One cell's independently changing character and moving light, before edge fade. */
 export declare function rippleCell(x: number, y: number, elapsed: number, width: number, height: number, impulses?: readonly HeroRippleImpulse[]): {
     alpha: number;
     glyph: string;
 };
-/** Stationary ASCII rows lit by an autonomous, slowly swelling wave field. */
+/** Shimmering ASCII rows lit by an autonomous, slowly swelling wave field. */
 export declare function drawHeroRipples(canvas: HTMLCanvasElement, elapsed: number, impulses?: readonly HeroRippleImpulse[]): void;

package/lib/types/client/features/settings/ChoiceMenu.d.ts

@@ -0,0 +1,15 @@
+import type { ReactElement } from 'react';
+export declare function MenuCheck(): ReactElement;
+/** A small choice list with native-style focus, dismissal and keyboard navigation. */
+export declare function ChoiceMenu({ id, labelId, anchor, value, options, onSelect, onClose }: {
+    readonly id: string;
+    readonly labelId: string;
+    readonly anchor: HTMLElement;
+    readonly value: string;
+    readonly options: readonly {
+        readonly value: string;
+        readonly label: string;
+    }[];
+    readonly onSelect: (value: string) => void;
+    readonly onClose: () => void;
+}): ReactElement;

package/lib/types/client/features/settings/fields.d.ts

@@ -81,3 +81,21 @@ export interface FontRowProps {
  * @returns The row and, when open, its menu.
  */
 export declare function FontRow(props: FontRowProps): ReactElement;
+/** Styled choice control for named visual variants. */
+export declare function ChoiceRow({ id, label, value, options, onChange }: {
+    readonly id: string;
+    readonly label: string;
+    readonly value: string;
+    readonly options: readonly {
+        readonly value: string;
+        readonly label: string;
+    }[];
+    readonly onChange: (value: string) => void;
+}): ReactElement;
+export declare function NameRow({ id, label, value, onChange, onCommit }: {
+    readonly id: string;
+    readonly label: string;
+    readonly value: string;
+    readonly onChange: (value: string) => void;
+    readonly onCommit: () => void;
+}): ReactElement;

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

@@ -9,6 +9,15 @@
 export declare const SETTINGS_NAMESPACE = "ccdSettings";
 /** Simplified Chinese dictionary; the key set is the source of truth. */
 export declare const zh: {
+    readonly 'section.personalization': '个性化';
+    readonly 'field.petStyle': '宠物样式';
+    readonly 'pet.whale': '小鲸鱼';
+    readonly 'pet.claude': 'Claude 像素宠物';
+    readonly 'field.greetingStyle': '首页问候';
+    readonly 'greeting.explore': '探索未知之境';
+    readonly 'greeting.claude': 'Claude 问候与图标';
+    readonly 'field.greetingName': '问候语中的称呼';
+    readonly 'hint.personalization': '两项可独立切换；宠物点击后播放对应动作，问候语跟随界面语言，不显示姓名。原有模块开关仍控制显示。';
     readonly nav: 'Claude 主题';
     readonly summary: 'CCD 风格界面 · 外观 · 字体';
     readonly 'section.general': '通用';
@@ -16,6 +25,10 @@ export declare const zh: {
     readonly 'section.appearance': '外观';
     readonly 'section.fonts': '字体';
     readonly 'section.view': '视图';
+    readonly 'field.showModelIcons': '显示模型图标';
+    readonly 'hint.showModelIcons': '显示模型选单中名称前的图标，默认开启';
+    readonly 'field.showSidebarBrand': '显示 DeepSeek Harness 品牌条目';
+    readonly 'hint.showSidebarBrand': '显示侧栏顶部的品牌标志与名称，默认关闭';
     readonly 'field.showHeaderSubagents': '显示顶栏子代理入口';
     readonly 'hint.showHeaderSubagents': '显示会话顶栏的子代理数量与列表入口，默认关闭；子代理运行与侧栏树不受影响';
     readonly 'field.showHeaderTeam': '显示顶栏团队入口';
@@ -53,10 +66,12 @@ export declare const zh: {
     readonly 'feature.shell': '窗口与分栏骨架';
     readonly 'feature.sidebar': '侧栏';
     readonly 'feature.new-session': '新建页';
+    readonly 'feature.hero-ripples': '主页字符水波纹';
+    readonly 'hint.hero-ripples': '主页与标题栏的流动背景和点击扩散，默认开启；需同时开启新建页模块';
     readonly 'feature.conversation': '聊天页';
     readonly 'feature.tool-calls': '工具调用展示';
     readonly 'feature.statistics': '统计卡片';
-    readonly 'feature.composer-pet': '输入框小鲸鱼';
+    readonly 'feature.composer-pet': '输入框宠物';
     readonly 'feature.composer-stats': '状态栏统计读数';
     readonly 'hint.composer-stats': '输出速度与缓存命中率，关掉时这两项不显示（默认）';
     readonly 'feature.context-panel': '上下文分解面板';

package/lib/types/client/features/statistics/source.d.ts

@@ -10,7 +10,8 @@
  * are still being folded (`pending > 0`) the card is genuinely incomplete, so
  * it refreshes every couple of seconds; once the snapshot is complete it drops
  * to a slow poll. A missing route (the host half is off) hides the card rather
- * than failing the mount.
+ * than failing the mount. Hidden documents pause reads and resume immediately
+ * when visible, keeping background windows from repeatedly aggregating history.
  */
 import { type StatsSnapshot } from '../../../shared/stats.ts';
 import type { Logger } from '../../contracts/ports.ts';

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

@@ -26,6 +26,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         shell: z<boolean, boolean, "defined">;
         sidebar: z<boolean, boolean, "defined">;
@@ -36,6 +37,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
     appearance: z<NoInfer<Schemastery.ObjectS<NoInfer<{
         canvas: z<string, string, "defined">;
@@ -53,12 +55,25 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         uiCjk: z<string, string, "defined">;
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
+    personalization: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
@@ -77,6 +92,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
         shell: z<boolean, boolean, "defined">;
         sidebar: z<boolean, boolean, "defined">;
@@ -87,6 +103,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         'composer-pet': z<boolean, boolean, "defined">;
         'composer-stats': z<boolean, boolean, "defined">;
         'context-panel': z<boolean, boolean, "defined">;
+        'hero-ripples': z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
     appearance: z<NoInfer<Schemastery.ObjectS<NoInfer<{
         canvas: z<string, string, "defined">;
@@ -104,12 +121,25 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         uiCjk: z<string, string, "defined">;
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
+    personalization: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        petStyle: z<"claude" | "whale", "claude" | "whale", "defined">;
+        greetingStyle: z<"claude" | "explore", "claude" | "explore", "defined">;
+        greetingName: z<string, string, "defined">;
+    }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showModelIcons: z<boolean, boolean, "defined">;
+        showSidebarBrand: z<boolean, boolean, "defined">;
         showHeaderSubagents: z<boolean, boolean, "defined">;
         showHeaderTeam: z<boolean, boolean, "defined">;
         groupByStatus: z<boolean, boolean, "defined">;

package/lib/types/shared/config.d.ts

@@ -8,7 +8,7 @@
  * pill (the output rate, or the cache-hit share) in place of the host's own
  * label.
  */
-export declare const FEATURE_IDS: readonly ['shell', 'sidebar', 'new-session', 'conversation', 'tool-calls', 'statistics', 'composer-pet', 'composer-stats', 'context-panel'];
+export declare const FEATURE_IDS: readonly ['shell', 'sidebar', 'new-session', 'conversation', 'tool-calls', 'statistics', 'composer-pet', 'composer-stats', 'context-panel', 'hero-ripples'];
 export type FeatureId = typeof FEATURE_IDS[number];
 export type FeatureFlags = Readonly<Record<FeatureId, boolean>>;
 /** Fields of the background-colour section; an empty string means "built-in palette". */
@@ -16,13 +16,20 @@ export declare const APPEARANCE_FIELDS: readonly ['canvas', 'sidebar'];
 /** Fields of the typeface section; an empty string means "system stack". */
 export declare const FONT_FIELDS: readonly ['uiLatin', 'uiCjk', 'code'];
 /** Fields of the view-options section. */
-export declare const VIEW_FIELDS: readonly ['showEmptyGroups', 'groupByStatus', 'showHeaderSubagents', 'showHeaderTeam'];
+export declare const VIEW_FIELDS: readonly ['showEmptyGroups', 'groupByStatus', 'showHeaderSubagents', 'showHeaderTeam', 'showSidebarBrand', 'showModelIcons'];
 export type AppearanceField = typeof APPEARANCE_FIELDS[number];
 export type FontField = typeof FONT_FIELDS[number];
 export type ViewField = typeof VIEW_FIELDS[number];
 export type AppearanceConfig = Readonly<Record<AppearanceField, string>>;
 export type FontsConfig = Readonly<Record<FontField, string>>;
 export type ViewConfig = Readonly<Record<ViewField, boolean>>;
+export interface PersonalizationConfig {
+    readonly petStyle: 'whale' | 'claude';
+    readonly greetingStyle: 'explore' | 'claude';
+    readonly greetingName: string;
+}
+export declare const DEFAULT_PERSONALIZATION: PersonalizationConfig;
+export declare function normalizeGreetingName(value: unknown): string;
 export interface StyleConfig {
     readonly enabled: boolean;
     readonly debug: boolean;
@@ -30,6 +37,7 @@ export interface StyleConfig {
     readonly appearance: AppearanceConfig;
     readonly fonts: FontsConfig;
     readonly view: ViewConfig;
+    readonly personalization: PersonalizationConfig;
 }
 export interface StyleOptions {
     readonly enabled?: boolean;
@@ -38,6 +46,7 @@ export interface StyleOptions {
     readonly appearance?: Partial<Record<AppearanceField, unknown>>;
     readonly fonts?: Partial<Record<FontField, unknown>>;
     readonly view?: Partial<Record<ViewField, unknown>>;
+    readonly personalization?: Partial<Record<keyof PersonalizationConfig, unknown>>;
 }
 export declare const DEFAULT_FEATURES: FeatureFlags;
 /** Empty strings keep the built-in palette and the system font stack in charge. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-claude-desktop-theme",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "license": "MIT",
   "description": "Claude Code Desktop-style theme for DeepSeek Harness (DSH) Desktop on macOS and Windows, with light/dark themes, model/effort pickers and an interactive pixel whale",
   "author": "zkforge",
@@ -81,6 +81,7 @@
     "typecheck": "tsc --noEmit",
     "check:architecture": "node scripts/check-architecture.mjs",
     "check:package": "node scripts/check-package.mjs",
+    "icons:models": "node scripts/generate-model-icons.mjs",
     "test": "node --test tests/*.test.ts tests/*.test.mjs",
     "check": "npm run typecheck && npm run check:architecture && npm test && npm run build && npm run check:package",
     "prepack": "npm run check",