dsh-claude-desktop-theme 0.4.1 → 0.4.2

package/lib/index.js

@@ -23,7 +23,10 @@ var DEFAULT_FONTS = Object.freeze({
   code: ""
 });
 var DEFAULT_VIEW = Object.freeze({
-  showEmptyGroups: false
+  showEmptyGroups: false,
+  groupByStatus: false,
+  showHeaderSubagents: false,
+  showHeaderTeam: false
 });
 var FONT_NAME_MAX_LENGTH = 64;
 
@@ -1008,6 +1011,9 @@ var Config = z.object({
     code: z.string().default(DEFAULT_FONTS.code).description("\u4EE3\u7801\u4E0E\u7B49\u5BBD\u5B57\u4F53\u540D\uFF08\u7559\u7A7A\u7528\u7CFB\u7EDF\u6808\uFF09").pattern(FONT_NAME)
   }).default({ ...DEFAULT_FONTS }).description("\u5B57\u4F53").volatile(),
   view: z.object({
+    showHeaderSubagents: z.boolean().default(DEFAULT_VIEW.showHeaderSubagents).description("\u663E\u793A\u9876\u680F\u5B50\u4EE3\u7406\u5165\u53E3\uFF08\u4EC5\u63A7\u5236\u5165\u53E3\u663E\u793A\uFF09"),
+    showHeaderTeam: z.boolean().default(DEFAULT_VIEW.showHeaderTeam).description("\u663E\u793A\u9876\u680F\u56E2\u961F\u5165\u53E3\uFF08\u4EC5\u63A7\u5236\u5165\u53E3\u663E\u793A\uFF09"),
+    groupByStatus: z.boolean().default(DEFAULT_VIEW.groupByStatus).description("\u6309\u4F1A\u8BDD\u72B6\u6001\u5206\u7EC4\uFF08\u4FDD\u7559\u539F\u751F\u9879\u76EE\u89C6\u56FE\u9009\u9879\uFF09"),
     showEmptyGroups: z.boolean().default(DEFAULT_VIEW.showEmptyGroups).description("\u663E\u793A\u7A7A\u5206\u7EC4\uFF08\u5173\u6389\u65F6\u6CA1\u6709\u4F1A\u8BDD\u7684\u5DE5\u4F5C\u533A\u4E0D\u518D\u663E\u793A\uFF09")
   }).default({ ...DEFAULT_VIEW }).description("\u89C6\u56FE\u9009\u9879").volatile()
 });

package/lib/types/client/compat/hero-canvas.d.ts

@@ -0,0 +1,4 @@
+import type { Disposer } from '../contracts/ports.ts';
+import type { HeroRippleImpulse } from '../contracts/hero-canvas.ts';
+/** One decorative canvas per visible hero; no timers survive its phase change. */
+export declare function mountHeroCanvas(document: Document, draw: (canvas: HTMLCanvasElement, elapsed: number, impulses: readonly HeroRippleImpulse[]) => void, report: (error: unknown) => void): Disposer;

package/lib/types/client/compat/host-dom.d.ts

@@ -161,6 +161,8 @@ export declare const HOST: Readonly<{
     /** WorkspaceBrowser.module.css: the tree's own scroller — the one element
         whose scroll distance the parked header band follows. */
     readonly browserList: '._7514NG_list';
+    /** FlatList is the only native body the status presentation reorders. */
+    readonly browserFlatList: '._7514NG_flatList';
     /** Rows.module.css: one Workspace's row, the line the merged header shares,
         and its trailing action group (`sidebar.css` parks both). */
     readonly workspaceRow: '.jJkEga_projectRow';

package/lib/types/client/compat/slots.d.ts

@@ -7,6 +7,8 @@ export declare const DSH_SLOTS: Readonly<{
     readonly conversation: 'main.conversation';
     readonly header: 'conversation.header';
     readonly sessionHeader: 'conversation.session.header';
+    /** Native subagent-catalog and agent-team entries occupy this list. */
+    readonly sessionHeaderActions: 'conversation.session.header.actions';
     /** Trailing header seats: `utilities` is a list the native actions occupy too. */
     readonly sessionHeaderUtilities: 'conversation.session.header.utilities';
     readonly sessionHeaderCorner: 'conversation.session.header.corner';

package/lib/types/client/compat/status-groups.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Disposer } from '../contracts/ports.ts';
+export type SessionGroup = 'input' | 'working' | 'ended';
+export interface SessionStatus {
+    readonly running?: boolean;
+    readonly pendingInteraction?: {
+        readonly kind: string;
+    };
+}
+/** Pending interaction takes precedence over live work, as in DSH's own rows. */
+export declare function sessionGroup(status: SessionStatus | undefined, running: boolean): SessionGroup;
+/**
+ * Present the host's flat rows in status sections. React-owned rows never leave
+ * their parents: flex order and reading-flow supply visual and accessible order.
+ * Native selection, hover cards, menus and rename handlers remain on those rows.
+ * uiSession.sessionStatus is the root observable provided by ui-session in the
+ * pinned app.asar; it does not acquire or activate any listed Session.
+ */
+export declare function mountStatusGroups(document: Document, ctx: Context, showEmpty: boolean, report: (error: unknown) => void): Disposer;

package/lib/types/client/contracts/hero-canvas.d.ts

@@ -0,0 +1,7 @@
+/** Click position in canvas-relative 0..1 coordinates, on the paused hero clock. */
+export interface HeroRippleImpulse {
+    readonly x: number;
+    readonly y: number;
+    readonly startedAt: number;
+}
+export declare const HERO_RIPPLE_DURATION = 2800;

package/lib/types/client/features/conversation/header-actions/visibility.d.ts

@@ -0,0 +1,5 @@
+import type { ViewConfig } from '../../../../shared/config.ts';
+import type { HostServices } from '../../../contracts/ports.ts';
+import type { CleanupScope } from '../../../core/cleanup.ts';
+/** Shadow a hidden entry with an empty renderer; releasing it restores DSH's. */
+export declare function mountHeaderVisibility(slots: HostServices['slots'], view: Pick<ViewConfig, 'showHeaderSubagents' | 'showHeaderTeam'>, cleanup: CleanupScope): void;

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

@@ -1,8 +1,7 @@
 import type { ImplementedFeature } from '../../contracts/feature.ts';
 /**
  * Blank-session page. DSH renders the Conversation shell in its `hero` phase
- * here, so this module only moves what the reference moves — the greeting to
- * the top of the column and the Composer block to the bottom — and leaves the
- * phase transition itself to the host.
+ * here. This module lays out the greeting and Composer and mounts a decorative
+ * ASCII ripple field; the phase transition itself belongs to the host.
  */
 export declare const newSessionFeature: ImplementedFeature;

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

@@ -0,0 +1,8 @@
+import type { HeroRippleImpulse } from '../../contracts/hero-canvas.ts';
+/** One character's stable grain and time-varying light, before the 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. */
+export declare function drawHeroRipples(canvas: HTMLCanvasElement, elapsed: number, impulses?: readonly HeroRippleImpulse[]): void;

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

@@ -16,6 +16,10 @@ export declare const zh: {
     readonly 'section.appearance': '外观';
     readonly 'section.fonts': '字体';
     readonly 'section.view': '视图';
+    readonly 'field.showHeaderSubagents': '显示顶栏子代理入口';
+    readonly 'hint.showHeaderSubagents': '显示会话顶栏的子代理数量与列表入口，默认关闭；子代理运行与侧栏树不受影响';
+    readonly 'field.showHeaderTeam': '显示顶栏团队入口';
+    readonly 'hint.showHeaderTeam': '显示会话顶栏的智能体团队入口，默认关闭；团队功能不受影响';
     readonly 'field.showEmptyGroups': '显示空分组';
     readonly 'hint.showEmptyGroups': '关掉时没有会话的工作区不再显示；视图选项菜单里的同一项';
     readonly 'field.enabled': '启用 CCD 风格界面';

package/lib/types/client/features/view-options/ViewOptionsCard.d.ts

@@ -2,6 +2,8 @@ import type { ReactElement } from 'react';
 import type { ViewOptionsPort } from '../../contracts/ports.ts';
 export interface ViewOptionsCardProps {
     readonly port: ViewOptionsPort;
+    readonly groupByStatus?: boolean;
+    readonly setGroupByStatus?: (value: boolean) => void;
     /** `view.showEmptyGroups`: whether empty Workspaces are kept on screen. */
     readonly showEmptyGroups: boolean;
     /** Write the switch back through the settings transport. */
@@ -21,10 +23,11 @@ export interface ViewOptionsCardProps {
  * out of the host's card and renames only the archived-visibility triple, which
  * is the one set the reference names differently (活跃 / 已归档 / 全部).
  *
- * Only `显示空分组` is this plugin's own state: it writes
- * `view.showEmptyGroups` through the settings transport, and a write re-mounts
+ * The empty-group switch and status grouping mode are this plugin's own state:
+ * they write `view.showEmptyGroups` / `view.groupByStatus` through the settings
+ * transport, and a write re-mounts
  * the plugin, so the card closes behind it. `清除筛选` puts the filter rows back
  * to their defaults and exists only while one of them is off its default, which
  * is what the reference does with `Clear filters`.
  */
-export declare function ViewOptionsCard({ port, showEmptyGroups, setShowEmptyGroups, }: ViewOptionsCardProps): ReactElement | null;
+export declare function ViewOptionsCard({ port, showEmptyGroups, setShowEmptyGroups, groupByStatus, setGroupByStatus, }: ViewOptionsCardProps): ReactElement | null;

package/lib/types/client/features/view-options/mount.d.ts

@@ -7,8 +7,8 @@ import type { ViewOptionsSettingsPort } from '../../contracts/ports.ts';
  *
  * The card is this plugin's own surface, so it is registered like one: a React
  * entry in `shell.overlay`, holding the driver that watches the host's trigger
- * and drives the host's own menu (`compat/view-options.ts`). The one value the
- * card writes is `view.showEmptyGroups`, and it goes through the settings
+ * and drives the host's own menu (`compat/view-options.ts`). Its own values,
+ * `view.showEmptyGroups` and `view.groupByStatus`, go through the settings
  * transport the same way the configuration page writes its fields — a write
  * re-mounts the plugin, which is why the card closes behind the switch.
  *

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

@@ -54,8 +54,14 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showHeaderSubagents: z<boolean, boolean, "defined">;
+        showHeaderTeam: z<boolean, boolean, "defined">;
+        groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showHeaderSubagents: z<boolean, boolean, "defined">;
+        showHeaderTeam: z<boolean, boolean, "defined">;
+        groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
@@ -99,8 +105,14 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         code: z<string, string, "defined">;
     }>>>, "volatile-defined">;
     view: z<NoInfer<Schemastery.ObjectS<NoInfer<{
+        showHeaderSubagents: z<boolean, boolean, "defined">;
+        showHeaderTeam: z<boolean, boolean, "defined">;
+        groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
+        showHeaderSubagents: z<boolean, boolean, "defined">;
+        showHeaderTeam: z<boolean, boolean, "defined">;
+        groupByStatus: z<boolean, boolean, "defined">;
         showEmptyGroups: z<boolean, boolean, "defined">;
     }>>>, "volatile-defined">;
 }>>, "plain">;

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

@@ -16,7 +16,7 @@ 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'];
+export declare const VIEW_FIELDS: readonly ['showEmptyGroups', 'groupByStatus', 'showHeaderSubagents', 'showHeaderTeam'];
 export type AppearanceField = typeof APPEARANCE_FIELDS[number];
 export type FontField = typeof FONT_FIELDS[number];
 export type ViewField = typeof VIEW_FIELDS[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-claude-desktop-theme",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "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",