dsh-claude-desktop-theme 0.3.0 → 0.4.1

package/lib/types/client/compat/sidebar-action-alignment.d.ts

@@ -0,0 +1,3 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Share the tree's actual trailing edge, including its native scrollbar gutter. */
+export declare function mountSidebarActionAlignment(document: Document): Disposer;

package/lib/types/client/compat/sidebar-session-icons.d.ts

@@ -0,0 +1,3 @@
+import type { Disposer } from '../contracts/ports.ts';
+/** Identify the two shared Claude actions; unknown/localized actions keep host art. */
+export declare function mountSidebarSessionIcons(document: Document): Disposer;

package/lib/types/client/compat/view-switch.d.ts

@@ -6,9 +6,50 @@ export declare const VIEW_WIDTH_PROPERTY = "--ccd-view-w";
 /** Animate selection changes; layout corrections must be immediate. */
 export declare const VIEW_DURATION_PROPERTY = "--ccd-view-duration";
 /**
- * Measure the selected ui-conversation tab and publish slider geometry.
- * MutationObserver handles tablist replacement and layout changes synchronously,
- * including occluded windows where animation frames are throttled.
- * @returns disposer that clears the observer and published properties.
+ * Marker on the tablist while it is parked in the sidebar's window-control row.
+ * `conversation.css` draws the fixed-position state from it; its absence means
+ * the host's own row (the header, or whatever the platform still offers) keeps
+ * the switcher.
  */
-export declare function mountViewSwitch(document: Document, report: (error: unknown) => void): Disposer;
+export declare const VIEW_DOCK_ATTRIBUTE = "data-ccd-view-dock";
+/** Custom property carrying the parked tablist's inset from the window's right edge. */
+export declare const VIEW_DOCK_RIGHT_PROPERTY = "--ccd-view-dock-right";
+/** Marker on a tab whose label is drawn as artwork, naming the View it selects. */
+export declare const VIEW_TAB_ATTRIBUTE = "data-ccd-view";
+/** Marker on the artwork seat injected into a decorated tab. */
+export declare const VIEW_GLYPH_ATTRIBUTE = "data-ccd-view-glyph";
+/**
+ * The parked pill's inset from the sidebar column's right edge, in px. Measured
+ * at @2x on the reference: the column's divider sits 16 device px right of the
+ * pill's right edge (docs/issues/img/todo-sidebar-sessions-target.webp).
+ */
+export declare const VIEW_DOCK_INSET = 8;
+/** Bundled artwork, one per shipped View; see features/conversation/view-switch-icons.ts. */
+export interface ViewSwitchIcons {
+    readonly chat: string;
+    readonly trajectory: string;
+}
+/**
+ * Shape the host's View switcher, and park it where the reference has it.
+ *
+ * Three jobs, one observer:
+ * - Publish the selected segment's geometry for the sliding thumb
+ *   (`--ccd-view-x` / `-w` / `-duration`), measured against the tablist.
+ * - Replace each shipped tab's text label with bundled artwork (the host draws
+ *   the labels itself; a tab has no icon of its own), reversibly.
+ * - Park the tablist in the sidebar column's top-right corner — the reference
+ *   keeps the View switcher on the window-control row — by measuring the
+ *   column and publishing its inset (`data-ccd-view-dock` +
+ *   `--ccd-view-dock-right`). The node stays where React put it: only CSS moves
+ *   it, exactly as the macOS sidebar toggle is parked.
+ *
+ * The mutation observer covers tablist replacement, selection, frame drags
+ * (inline grid tracks) and the collapse flag, synchronously, including occluded
+ * windows where animation frames are throttled. A ResizeObserver on the sidebar
+ * column covers what no attribute says: the column's own width while the grid
+ * track animates between 0 and its settled value.
+ *
+ * @returns disposer that clears the observers, every injected node, every
+ *     written attribute and every published property.
+ */
+export declare function mountViewSwitch(document: Document, icons: ViewSwitchIcons, report: (error: unknown) => void): Disposer;

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/settings/locales.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copy for the row configuration page.
+ * Copy for the CCD settings section.
  *
  * The page is the plugin's only owned surface with its own words: everything
  * else mirrors a host label. The dictionary is registered through the locale
@@ -9,6 +9,7 @@
 export declare const SETTINGS_NAMESPACE = "ccdSettings";
 /** Simplified Chinese dictionary; the key set is the source of truth. */
 export declare const zh: {
+    readonly nav: 'Claude 主题';
     readonly summary: 'CCD 风格界面 · 外观 · 字体';
     readonly 'section.general': '通用';
     readonly 'section.features': '模块';

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

@@ -2,7 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { ConfigFormPort, DomPort, ThemePreferencePort } from '../../contracts/ports.ts';
 import type { CleanupScope } from '../../core/cleanup.ts';
 /**
- * Register the configuration page for this plugin's own loader row.
+ * Register this plugin in the main settings navigation.
  *
  * The page lives outside the activation scope on purpose: switching the
  * interface off releases every style resource, and the page has to survive that

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

@@ -1,17 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { ReactElement } from 'react';
-import type { RowConfigPageProps } from '../../compat/plugin-manager.ts';
-/**
- * Register the configuration page for one plugin row.
- *
- * The page owns its copy through the locale service and its form through the
- * plugin's own `configForms` handle, so it needs only the slots and locale
- * services. Both are injected as a pair: without an installed locale face a
- * registration that declares a namespace fails loud at render time, so a
- * deployment that lacks the service keeps the page unmounted instead.
- * @param ctx - client context.
- * @param key - `<package>#<row id>` of the row whose configuration page this is.
- * @param component - the bound page component.
- * @returns the injected scope, released with `dispose()`.
- */
-export declare function registerSettingsPage(ctx: Context, key: string, component: (props: RowConfigPageProps) => ReactElement | null): Pick<ReturnType<Context['inject']>, 'dispose'>;
+import type { SettingsSectionProps } from '../../compat/settings-section.ts';
+/** Register the plugin form as a top-level settings section with localized copy. */
+export declare function registerSettingsPage(ctx: Context, id: string, component: (props: SettingsSectionProps) => ReactElement | null): Pick<ReturnType<Context['inject']>, 'dispose'>;

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

@@ -24,6 +24,7 @@ export interface Palette {
     readonly track: string;
     readonly raised: string;
     readonly hover: string;
+    readonly hoverStrong: string;
     readonly selected: string;
     readonly border: string;
     readonly borderStrong: string;
@@ -37,7 +38,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.1",
   "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",
@@ -85,6 +85,7 @@
     "check": "npm run typecheck && npm run check:architecture && npm test && npm run build && npm run check:package",
     "prepack": "npm run check",
     "pack:local": "npm pack --pack-destination artifacts",
+    "preview:install": "node scripts/install-local.mjs",
     "pet:gifs": "node scripts/pet-gifs.mjs",
     "effort:gifs": "node scripts/effort-gif.mjs"
   },

package/lib/types/client/compat/plugin-manager.d.ts

@@ -1,32 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import type { ReactElement } from 'react';
-import type { Disposer } from '../contracts/ports.ts';
-/**
- * The Plugins panel's row configuration slot.
- *
- * `@deepseek-ai/dsh-client-ui-plugin-manager` declares it in the child table of
- * its `main` panel registration as `{ kind: 'keyed', scope: 'root' }` and keys
- * it by `<package>#<row id>`; the row then grows a configuration page. The
- * package is not part of this plugin's type baseline, so the two members used
- * here are declared structurally and the real service object is passed through
- * unchanged — the same treatment `contracts/ports.ts` gives the other
- * out-of-baseline providers. Registration waits for the declaration, so a
- * deployment without that panel simply keeps the page unmounted.
- */
-export declare const ROW_CONFIG_SLOT = "plugins.row.config";
-/** Props the panel renders a row configuration page with. */
-export interface RowConfigPageProps {
-    /** `summary` beside a row title without a description, `page` for the form. */
-    readonly view?: string;
-    /** Locale seat synthesized from the registration's namespace. */
-    readonly t?: (key: string, params?: Record<string, unknown>) => string;
-}
-/**
- * Register one row configuration page and wait for the slot to exist.
- * @param ctx - context carrying the slots service.
- * @param key - `<package>#<row id>` of the row whose page this is.
- * @param locale - dictionary namespace for the page's `t` seat, when available.
- * @param component - the page component.
- * @returns the injection's disposer.
- */
-export declare function mountRowConfigPage(ctx: Context, key: string, locale: string | undefined, component: (props: RowConfigPageProps) => ReactElement | null): Disposer;