dsh-claude-desktop-theme 0.3.0 → 0.4.0

package/lib/types/client/contracts/ports.d.ts

@@ -82,9 +82,16 @@ export interface SidebarRightPort {
     }): void;
     /** Focus a tab and the pane holding it; a missing tab is left alone. */
     focus(tabId: string): void;
-    /** Open tab metadata across adopted Sessions. */
+    /**
+     * Open tab metadata across adopted Sessions — and, in the shipped face, the
+     * snapshot store behind it: the plugin's pane layer re-reads the layout
+     * whenever that list changes, which covers every way a tab opens, closes or
+     * changes pane. A build whose source cannot be observed is read once per
+     * mutation instead.
+     */
     readonly openTabs: {
         getSnapshot(): readonly SidebarTabRecord[];
+        subscribe?(listener: () => void): Disposer;
     };
     /**
      * Collapse the column, or expand it and focus its active dock pane.
@@ -95,6 +102,27 @@ export interface SidebarRightPort {
      * keeps that row out rather than offering one that cannot act.
      */
     toggleExpanded?(): void;
+    /**
+     * Take one docked tab out into a floating pane, and put one back.
+     *
+     * The panel's own renderer draws at most one pane or two horizontal panes —
+     * its layout component throws on anything else — so a vertical split or a
+     * third pane cannot be asked of it. A floating pane has no such limit (the
+     * layout stores a rectangle per float and the package allows any number), so
+     * `compat/right-panes.ts` builds the panel's panes out of these two calls and
+     * draws their boxes itself. A missing `float` means a build that cannot host
+     * panes at all: the panel keeps its tabs, exactly as it does today.
+     * Source: packages/client/ui-sidebar-right/src/client/controller.ts
+     * (`float(tabId, rect)`, `dock(paneId)`).
+     */
+    float?(tabId: string, rect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): void;
+    /** Return one floating pane's tab to the panel's docked column. */
+    dock?(paneId: string): void;
 }
 /**
  * The tab-type registry that face publishes as `ctx.sidebarRightTabs`. A header

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

@@ -5,9 +5,11 @@ import type { ImplementedFeature } from '../../contracts/feature.ts';
  * adapts the header chrome, the transcript column and the message surfaces.
  *
  * The header keeps DSH's own View switcher: the host still owns which View is
- * selected and how it is rendered, and this module only moves the tablist onto
- * the title line and publishes the selected segment's geometry so the
- * stylesheet can slide the thumb onto it.
+ * selected and how it is rendered. This module swaps the two shipped Views'
+ * text labels for bundled artwork, publishes the selected segment's geometry so
+ * the stylesheet can slide the thumb onto it, and parks the tablist in the
+ * sidebar's window-control row while that column has a corner to hold it
+ * (`compat/view-switch.ts`).
  *
  * The transcript's own edge fade is published the same way: the host owns the
  * scroll position, `compat/conversation-fade.ts` turns it into two attributes,

package/lib/types/client/features/conversation/view-switch-icons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The two View switcher glyphs, bundled as trusted static markup.
+ *
+ * Drawn to the reference's own segments (docs/issues/img/todo-sidebar-sessions-target.webp,
+ * @2x): a pair of speech bubbles for the chat View and the `</>` pair for the
+ * trajectory View, both on the CCD 16 grid — 1–1.2px stroke (each glyph's own
+ * weight read off the reference), round caps and joins, `currentColor` ink,
+ * ink box ≈ 12.5 × 11px inside the 16px artwork.
+ */
+export declare const VIEW_SWITCH_ICONS: Readonly<{
+    chat: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 16 16\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\n  <path d=\"M10.4 8.3a2.6 2.6 0 0 1-2.6 2.6H5.7L3.3 12.5V5.9a2.6 2.6 0 0 1 2.6-2.6h1.9a2.6 2.6 0 0 1 2.6 2.6Z\"/>\n  <path d=\"M10.3 5.9H12.1a2.1 2.1 0 0 1 2.1 2.1V10.4a2.1 2.1 0 0 1-2.1 2.1H10.25L9.1 13.1\"/>\n</svg>";
+    trajectory: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 16 16\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\n  <path d=\"M5.3 5.8 3.05 8l2.25 2.2\"/>\n  <path d=\"M9.1 3.8 6.9 12.2\"/>\n  <path d=\"M10.7 5.8 12.95 8l-2.25 2.2\"/>\n</svg>";
+}>;

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

@@ -1,8 +1,14 @@
 import type { ImplementedFeature } from '../../contracts/feature.ts';
 /**
  * Window frame and column geometry: flat surfaces, the sidebar column and its
- * divider. The three tracks stay entirely `ui-layout`'s solve, so resizing the
- * sidebar with the handle moves the divider the pointer is on; the plugin only
- * paints the columns.
+ * divider, and the right panel's floating card. The three tracks stay entirely
+ * `ui-layout`'s solve, so resizing the sidebar with the handle moves the divider
+ * the pointer is on; the plugin only paints the columns.
+ *
+ * The right panel is a column's occupant rather than a track, so its card is
+ * two sheets: `shell.css` insets the panel's box and paints the surface, and
+ * `right-panel.css` dresses what the panel draws inside it — the file tree's
+ * rows included, which belong to no feature of this plugin's own. Both mount
+ * with the frame, because neither has a switch of its own to lose.
  */
 export declare const shellFeature: ImplementedFeature;

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

@@ -3,7 +3,7 @@ import type { ImplementedFeature } from '../../contracts/feature.ts';
  * Sidebar presentation: compact navigation rows, flat project groups and a
  * calmer foot. Every entry DSH registers — New Session, the global panel list,
  * the workspace browser and Settings — stays exactly where the host put it; the
- * account menu is reshaped, never re-authored.
+ * account menu gains a More submenu that forwards the host feedback action.
  *
  * The one list policy this module owns is the provisional New Session row: DSH
  * creates the Session as soon as New Session is used, and the host marks that

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

@@ -13,8 +13,7 @@
  * ```
  *
  * Only the sentence is copied; nothing is fetched and no book text is
- * involved. The copy stays English, exactly as the reference writes it —
- * including its typographic apostrophe and multiplication sign.
+ * involved. Titles and sentences are localized into Simplified Chinese.
  */
 /** One comparable book: the title as printed, and the tokens it would take. */
 export interface Book {

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

@@ -1,8 +1,8 @@
 /**
  * Number and date formatting for the statistics card.
  *
- * The card's copy is English, so its separators and its 12-hour clock are too:
- * every formatter here is fixed to `en-US`, which is what the reference uses.
+ * The card uses Simplified Chinese dates and a 24-hour clock. Compact token
+ * units stay unchanged so the metrics and chart labels fit the card.
  * They live in their own module because both the data layer (`view.ts`) and the
  * DOM layer (`card.ts`) need them, and neither should import the other.
  */
@@ -21,14 +21,14 @@ export declare function formatCount(value: number): string;
  */
 export declare function formatTokens(value: number): string;
 /**
- * One hour of the day, as the reference labels it (`11 AM`).
+ * One hour of the day in the 24-hour clock (`11:00`).
  *
  * @param hour - local hour, 0-23.
  * @returns the label.
  */
 export declare function formatHour(hour: number): string;
 /**
- * One `YYYY-MM-DD` key as the reference labels a chart day (`Sep 30`).
+ * One `YYYY-MM-DD` key as a Chinese chart date (`9月30日`).
  *
  * @param date - local day key.
  * @returns the short label.

package/lib/types/client/theme/mount.d.ts

@@ -3,8 +3,8 @@ import type { CleanupScope } from '../core/cleanup.ts';
 /**
  * Plugin-scoped presentation base: the root activation marker, the design
  * variables, the shared Composer geometry two features depend on (siblings must
- * not import each other), the host popup chrome (DESIGN.md §6.7) and the
- * semantic token overrides.
+ * not import each other), the host popup chrome (DESIGN.md §6.7), the ink the
+ * window's scrollbars are painted in and the semantic token overrides.
  *
  * The override layer is recomputed on every mount, so a configuration change
  * releases the previous layer through the same scope that owns the stylesheets

package/lib/types/client/theme/palette.d.ts

@@ -37,7 +37,7 @@ export interface Palette {
  */
 export declare const BUILT_IN_SURFACES: Readonly<{
     canvas: "#fcfcfb";
-    sidebar: "#fbfbfa";
+    sidebar: "#fbfbf9";
     border: "#e3e3e1";
 }>;
 /**

package/package.json

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