dsh-style-tweaks 0.1.0

package/lib/types/client/tweaks/code-block-flush-top.d.ts

@@ -0,0 +1,91 @@
+/**
+ * DSH-style-tweaks — code-block-flush-top tweak.
+ *
+ * Removes the 16 px of top whitespace above and inside every highlighted
+ * code block so the highlighted box sits flush with the preceding
+ * paragraph, list item, or heading *and* the first line of code sits flush
+ * with the top edge of the box. The right, bottom, and left sides keep
+ * 16 px so a code block still breathes inside its parent column and the
+ * code itself still has lateral breathing room.
+ *
+ * ## Symptom
+ *
+ * DSH renders every markdown code fence through `CodeBlock`
+ * (`packages/client/ui-primitives/src/markdown/CodeBlock.tsx:60`), which
+ * wraps the highlighted `<pre>` in a banner + `<pre>` pair:
+ *
+ *   <div className={clsx(css.block, 'md-code-block', className)}>
+ *     <div className={css.bannerWrap}> ... language / copy button ... </div>
+ *     <pre className="shiki css-variables"> ... highlighted code ... </pre>
+ *   </div>
+ *
+ * Two 16 px gaps stack vertically to create the "blank space above the
+ * code" the user sees:
+ *
+ *   1. The wrapper `.block` carries `margin: 16px 0` (DSH's
+ *      `CodeBlock.module.css:13`), so the highlighted code is offset 16 px
+ *      from preceding content (paragraph, list item, heading, ...).
+ *   2. The inner `<pre>` carries `padding: 16px` (CodeBlock.module.css:73),
+ *      so the first line of code sits 16 px below the banner / box edge.
+ *
+ * Chrome DevTools exposes these on two different elements — clicking on the
+ * `<pre class="shiki css-variables">` shows `padding: 16px`, clicking on
+ * the `<div class="_block_xxxxx md-code-block">` wrapper shows
+ * `margin: 16px`. Both need to go for the code to sit flush.
+ *
+ * ## Fix
+ *
+ * Two rules on the stable `.md-code-block` hook (the same hand-written class
+ * `stable-table.ts` uses for `.md-table-wide`):
+ *
+ *   - `.md-code-block { margin-top: 0 !important }` collapses the outer
+ *     gap above the box. Only `margin-top` is touched: writing a full
+ *     `margin: 0 16px 16px 16px` would add 16 px of left/right margin to
+ *     the wrapper, shrinking the visible code box by 32 px (a regression
+ *     reported by the user as "the box shrinks by a ring"). The wrapper's
+ *     horizontal sizing is owned by the conversation column — there is no
+ *     left/right margin on `.block` to preserve.
+ *   - `.md-code-block pre { padding: 0 16px 16px 16px !important }`
+ *     collapses the inner gap above the code. The streaming arm of
+ *     `CodeBlock.tsx:130` mounts `<pre>` as a direct child of the wrapper;
+ *     the settled arm (`CodeBlock.tsx:166`) wraps it in an anonymous
+ *     `<div>` for the `dangerouslySetInnerHTML` sink. A descendant selector
+ *     matches both arms identically.
+ *
+ * ## Specificity
+ *
+ * DSH's rules in play:
+ *
+ *   .block                                  { margin: 16px 0 }        (0,0,1,0)
+ *   .block:not(:last-child)                 { margin-bottom: 11px }   (0,0,2,0)
+ *   .block :where(pre)                      { padding: 16px }         (0,0,2,0)
+ *
+ * A plain `.md-code-block { ... !important }` is (0,0,1,0) and would lose
+ * to `.block:not(:last-child)` on the trailing-edge specificity tiebreak
+ * (the :not() pseudo-class adds one to specificity). Doubling the class —
+ * .md-code-block.md-code-block — reaches (0,0,2,0) and ties; !important
+ * then takes precedence on importance, leaving us in control of all four
+ * edges.
+ *
+ * The inner-pre selector uses .md-code-block.md-code-block pre, which is
+ * (0,0,2,1) — that strictly beats DSH's .block :where(pre) (0,0,2,0) on
+ * total specificity. The !important is belt-and-suspenders, but the
+ * specificity win alone is enough.
+ *
+ * ## Scope safety
+ *
+ * `.md-code-block` is set in exactly one place in DSH's source
+ * (`CodeBlock.tsx:170`); DSH reserves it for plugins/extensions so future
+ * code does not collide. The empty-fence branch (`renderCode` in
+ * `packages/client/ui-primitives/src/markdown/render.tsx:312-321`) renders a
+ * bare `<pre>` without `.md-code-block`, so empty fences are untouched —
+ * they have no banner/wrapper anyway.
+ *
+ * Streaming and settled arms of `CodeBlock` (`CodeBlock.tsx:130` streaming
+ * `<pre>`, `:166` settled `<div dangerouslySetInnerHTML>`) share the same
+ * wrapper class, so both arms are affected uniformly by the descendant
+ * selector.
+ */
+export declare const CODE_BLOCK_FLUSH_TOP_CSS_ID = "cst-code-block-flush-top";
+export declare function injectCodeBlockFlushTopStyles(): () => void;
+//# sourceMappingURL=code-block-flush-top.d.ts.map

package/lib/types/client/tweaks/code-block-flush-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-flush-top.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/code-block-flush-top.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AA6CH,eAAO,MAAM,2BAA2B,6BAA6B,CAAA;AAErE,wBAAgB,6BAA6B,IAAI,MAAM,IAAI,CAU1D"}

package/lib/types/client/tweaks/locate-current-session.d.ts

@@ -0,0 +1,62 @@
+/**
+ * dsh-style-tweaks — locate-current-session tweak.
+ *
+ * Adds a "locate current session" button to the left of the native search
+ * button in the sidebar's "工作区" (workspaces) section header. Clicking it:
+ *
+ *   1. Finds the currently-selected session row in the sidebar tree.
+ *   2. Locates its enclosing workspace group via the stable
+ *      `[class*="groupSection"]` ancestor hook.
+ *   3. If the parent workspace row is collapsed (`aria-expanded="false"`),
+ *      clicks it to expand.
+ *   4. Scrolls the session row to the center of the sidebar's visible area
+ *      so the user can confirm "this is where I am".
+ *
+ * ## Why DOM patching
+ *
+ * DSH's `sidebar.workspaces` slot is a single owner (the workspace browser)
+ * and exposes no public sub-slot for the section header row. There is also
+ * no plugin-callable service that scrolls a sidebar row into view. The
+ * plugin therefore decorates the DOM from outside, exactly the way
+ * `project-running-indicator.ts` decorates project header rows.
+ *
+ * Stable anchors (CSS-Modules hashes rotate per build):
+ *   • Native search button: localized `aria-label` resolved through the
+ *     locale service (`workspace` ns, key `search.sessions.aria`), with a
+ *     structural fallback on the `searchButton` class fragment.
+ *   • Breadcrumb: same strategy (`conversation` ns, key
+ *     `session.hierarchy`; fallback `crumbs` fragment).
+ *   • Selected session row: `[role="treeitem"][aria-selected="true"]`
+ *     (ARIA `aria-selected` is part of the WAI-ARIA tree pattern, DSH
+ *     uses it to mark the active row.)
+ *   • Workspace group container: closest element whose class attribute
+ *     contains the substring `groupSection` (a semantic fragment DSH
+ *     keeps even when its hashed prefix changes).
+ *   • Workspace header row: `[role="treeitem"][aria-expanded]` inside the
+ *     same group container.
+ *
+ * ## Lifecycle
+ *
+ * `setupLocateCurrentSession` returns a disposer that removes the button
+ * and disconnects the observer. The caller in `index.tsx` mounts/unmounts
+ * it on every settings change, exactly like the other JS-level tweaks —
+ * disabling the toggle in Settings causes the button to disappear with no
+ * page refresh.
+ *
+ * @module dsh-style-tweaks/client/tweaks/locate-current-session
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/**
+ * Install the locate-current-session stylesheet into <head>. Idempotent: a
+ * second call returns no-op (the existing <style> is reused). The caller
+ * keeps the disposer alive while the tweak is enabled and disposes it when
+ * the user disables the tweak.
+ */
+export declare function injectLocateCurrentSessionStyles(): () => void;
+/**
+ * Setup the live tweak. Returns a disposer that removes the button and
+ * the observer. Safe to call when the search button never appears — the
+ * tweak then stays inert until the next observer tick finds one.
+ */
+export declare function setupLocateCurrentSession(ctx: ClientContext): () => void;
+//# sourceMappingURL=locate-current-session.d.ts.map

package/lib/types/client/tweaks/locate-current-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate-current-session.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/locate-current-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA+KnE;;;;;GAKG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,IAAI,CAU7D;AAmYD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CAwFxE"}

package/lib/types/client/tweaks/project-running-indicator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * dsh-style-tweaks — project-running-indicator tweak.
+ *
+ * The first non-pure-CSS tweak: it renders the *app's own* `StateDot`
+ * (the animated pixel-chase shown left of a running conversation's title,
+ * `ui-primitives/src/StateDot.tsx`) on the right side of every project
+ * directory header row in the sidebar, so a running conversation stays
+ * visible even when its group is collapsed.
+ *
+ * ## Why DOM patching
+ *
+ * DSH's project header (`ProjectRowItem`, `ui-workspace/src/client/rows/
+ * Rows.tsx:112`) exposes no plugin slot, and the `sidebar.workspaces` seat
+ * is already occupied by the stock browser — so the header row can only be
+ * decorated from outside, via a MutationObserver. Consistent with this
+ * repo's selector philosophy, the engine anchors exclusively on hand-written
+ * DOM facts that survive CSS-Modules hashing:
+ *
+ *   - group header rows are the only `role="treeitem"` elements carrying
+ *     `aria-expanded` (session rows and flat-list rows never have it);
+ *   - the row's title text is the only `:scope > span > span` descendant
+ *     with non-empty text (folder/chevron slots hold bare SVGs, the action
+ *     buttons' labels live on `aria-label`, not text).
+ *
+ * ## Data source
+ *
+ * Running state is read from the app's own stores, not inferred from the
+ * DOM (a collapsed group hides its child rows, so the DOM cannot answer):
+ *
+ *   - `ctx.get('sessions').list` — snapshot store of `SessionSummary`s
+ *     (`byId[id].running`);
+ *   - `ctx.get('workspaces').list` — `WorkspaceSnapshot.items`, each
+ *     `WorkspaceView.sessionIds` mapping sessions to directories.
+ *
+ * Membership is computed from the workspace arrays (mirroring
+ * `deriveGroups` in `ui-workspace/src/client/tree.ts`): archived and blank
+ * sessions are skipped, sessions not in any workspace count toward the
+ * "Ungrouped" bucket. A running subagent marks its top-level ancestor
+ * session busy (same lineage walk as `indexSubagentDescendants`), which is
+ * what the title's own dot shows.
+ *
+ * Header rows are matched to workspaces by title text; a header whose label
+ * matches no workspace title is the Ungrouped bucket. This avoids depending
+ * on DSH's locale copy for the bucket label (and tolerates renames for
+ * free, since the title text *is* the match key).
+ *
+ * ## Rendering
+ *
+ * The dot is the real `StateDot` imported from
+ * `@deepseek-ai/dsh-client-ui-primitives`. That package is in the client
+ * shell's `PLATFORM_MODULES` baseline, so at runtime the import resolves to
+ * the app's shared instance — its CSS module (and the global
+ * `dsh-state-dot-chase` keyframes) and theme tokens are already loaded, and
+ * the animation is pixel-identical to the one on session titles. The dot is
+ * mounted with a `react-dom/client` root per decorated row and unmounted
+ * whenever the group goes idle, the row leaves the DOM, or the tweak is
+ * disabled.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+export declare function setupProjectRunningIndicator(ctx: ClientContext): () => void;
+//# sourceMappingURL=project-running-indicator.d.ts.map

package/lib/types/client/tweaks/project-running-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-running-indicator.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/project-running-indicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AASH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAkKnE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CA8G3E"}

package/lib/types/client/tweaks/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * dsh-style-tweaks — tweak registry.
+ *
+ * Central catalogue of all CSS tweaks the plugin can inject. Each tweak is
+ * described once here; the client iterates this list to (a) render Settings
+ * panel toggles and (b) mount / unmount the corresponding styles live.
+ */
+export interface TweakDescriptor {
+    /** Unique id, e.g. "stable-table". Doubles as the DOM data-tweak id. */
+    readonly id: string;
+    /** Settings document field name, e.g. "stableTable". */
+    readonly settingKey: string;
+    /** Default value when the field is absent from the settings document. */
+    readonly defaultEnabled: boolean;
+    /** i18n key for the toggle label in the Settings panel. */
+    readonly titleKey: string;
+    /** i18n key for the one-line description shown next to the toggle. */
+    readonly descriptionKey: string;
+}
+/** All tweaks, in display order. Add new entries here. */
+export declare const TWEAKS: readonly TweakDescriptor[];
+//# sourceMappingURL=registry.d.ts.map

package/lib/types/client/tweaks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,0DAA0D;AAC1D,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EA2C5C,CAAA"}

package/lib/types/client/tweaks/settings-nav-scroll.d.ts

@@ -0,0 +1,168 @@
+/**
+ * dsh-style-tweaks — settings-nav-scroll tweak.
+ *
+ * Makes the settings dialog's LEFT nav column scrollable once its section
+ * list outgrows the fixed-height panel, instead of silently clipping the
+ * entries at the bottom. Without this, a user with several plugin-registered
+ * sections cannot reach the last items at all — the panel hides them and
+ * nothing scrolls. The scrollbar itself is an overlay-style thin strip:
+ * parked in the rail's spare padding so it never squeezes the menu, and
+ * visible only while the list is actually being scrolled (macOS-style),
+ * driven by a scroll listener rather than `:hover`.
+ *
+ * ## Symptom
+ *
+ * The settings dialog is DSH's `SettingsRoot`
+ * (`packages/client/ui-settings-general/src/client/SettingsRoot.tsx`):
+ *
+ *   <div className={css.panel} role="dialog" aria-modal="true">   ← 800px, overflow: hidden
+ *     <nav className={css.nav}>                                   ← 188px rail
+ *       <div className={css.navTitle}>…</div>
+ *       <div className={css.navList}>                             ← the section buttons
+ *         <button className={css.navCell}>…</button> × N
+ *       </div>
+ *     </nav>
+ *     <div className={css.content}> … </div>
+ *   </div>
+ *
+ * The panel has ONE height for every section (`SettingsRoot.module.css`:
+ * `height: min(800px, calc(100vh - 48px)); overflow: hidden`) so it does not
+ * resize under the pointer between nav clicks, and its own comment states
+ * "whatever does not fit scrolls in `.options`" — the right content column
+ * got `overflow-y: auto`, but the LEFT nav never received the same
+ * treatment. `.navList` is a plain flex column (`gap: 4px`, default
+ * `flex: 0 1 auto`, no `min-height: 0`, no overflow), and its `min-height:
+ * auto` forbids shrinking below the content, so the list simply overflows
+ * `.nav` and the `.panel`'s `overflow: hidden` clips whatever spills past
+ * the bottom edge. With enough plugin sections (this plugin alone adds one),
+ * the last nav entries become unreachable.
+ *
+ * ## Fix — part 1 (CSS): make the list the scroll container
+ *
+ * One rule turning the nav list into the scroll container of the nav rail's
+ * leftover height:
+ *
+ *   flex: 1          — the list owns the column height below the title
+ *                      (previously implicit; nav is a flex column whose
+ *                      only other child is the title row).
+ *   min-height: 0    — the load-bearing line: overrides the flex item's
+ *                      `min-height: auto`, allowing the list to be shorter
+ *                      than its content so overflow becomes possible.
+ *   overflow-y: auto — scroll only when entries exceed the height; a short
+ *                      list looks exactly like stock DSH.
+ *   overscroll-behavior: contain — at the list's scroll end the chain stops
+ *                      here instead of scrolling some page behind the modal.
+ *   padding-bottom: 12px — breathing room after the last entry when fully
+ *                      scrolled (`.nav` has no bottom padding by design);
+ *                      invisible when the list does not scroll.
+ *   margin-inline-end: -12px — parks the bar OUT of the content column,
+ *                      8px clear of the cells (see part 2).
+ *
+ * The title row stays fixed and the panel keeps its size — no layout shift
+ * anywhere else.
+ *
+ * ## Fix — part 2 (CSS): the bar parks in the rail's padding gutter, clear of the cells
+ *
+ * A classic scrollbar consumes its width from the element's content box —
+ * the first shipped version narrowed the cells 164 → 156px the moment the
+ * bar appeared, and the bar sat there permanently while the list overflowed.
+ * Native Chromium scrollbars have no CSS "overlay" mode, but the classic
+ * bar can be parked out of the content column:
+ *
+ *   margin-inline-end: -12px — the list's border box stretches the rail's
+ *                      full 12px right padding into itself: 8px gap + 4px
+ *                      bar strip. The thumb therefore sits 8px clear of the
+ *                      entries (values user-tuned in the console as W=4 /
+ *                      GAP=8, then solidified into the tweak) and floats
+ *                      over the rail's padding area like an overlay bar,
+ *                      flush with the gutter edge before the content column
+ *                      boundary.
+ *
+ *   [class*="_navCell"] { max-width: 164px } — the park widens the list's
+ *                      content box whenever the bar is ABSENT (no overflow →
+ *                      content 176px), which made the hover highlight paint
+ *                      12px wider than stock in that state. Capping the cells
+ *                      at DSH's stock width (188 nav − 2×12 padding) pins
+ *                      them to 164px in EVERY state — bar present, bar
+ *                      absent, hovering, scrolling — so the rail's geometry
+ *                      never differs from stock by a pixel. If DSH ever
+ *                      widens the rail, the cap only over-narrows cosmetically;
+ *                      if it narrows, stretch wins below the cap and nothing
+ *                      changes.
+ *
+ *   ::-webkit-scrollbar { width: 4px } — thinner than DSH's global 8px
+ *                      skin; colour/radius of the visible thumb come from
+ *                      DSH's global thumb rules (l2 tokens inherited from
+ *                      the panel; the 4px radius auto-clamps to 2px on this
+ *                      width), so only geometry lives here.
+ *
+ * ## Fix — part 3 (JS): show only while scrolling
+ *
+ * The idle bar must be invisible, and the first attempt used the classic
+ * hover-reveal (`:not(:hover)::-webkit-scrollbar-thumb → transparent`).
+ * Chromium does not reliably repaint custom scrollbar pseudo-elements when
+ * only the HOST's `:hover` state changes — the thumb kept its last painted
+ * style until an unrelated invalidation; in practice the bar appeared when
+ * clicking a nav cell (React re-rendered the list → repaint) instead of
+ * while scrolling, which is exactly backwards.
+ *
+ * So the show condition is driven by real activity: `scroll` events on the
+ * list toggle a `cst-nav-scroll-show` class on the list itself, and ~800ms
+ * after the last scroll event it is removed (macOS overlay-bar timing).
+ * Class changes restyle the element itself, so the scrollbar repaints
+ * reliably — no dependence on host pseudo-state. Wheel-scrolling requires
+ * the pointer on the list, thumb drags fire scroll, and programmatic
+ * scrolls (keyboard focus moving through the cells) count as activity too;
+ * idle hovering shows nothing, matching "hide when not scrolling".
+ *
+ * The JS surface is deliberately small: a MutationObserver keeps the
+ * scroll listener attached to whichever element currently matches the
+ * selector (the dialog unmounts when closed and remounts when opened),
+ * one passive `scroll` listener per attached list, one idle timer.
+ *
+ * ## Selector strategy
+ *
+ * DSH hashes CSS Modules class names with the `[hash]_[local]` pattern
+ * (`packages/client/tsdown.client.ts`: `cssModules: { pattern:
+ * '[hash]_[local]' }`), so the compiled class is `<hash>_navList` — the hash
+ * is unpredictable across DSH versions, the local name is not. We match the
+ * fragment with `[class*="_navList"]` and pin it structurally to the one
+ * place that renders it: the modal panel's nav rail
+ * (`div[role="dialog"][aria-modal="true"] > nav > …`). Both anchors are
+ * redundant on their own; together they survive either DSH reshuffling the
+ * dialog structure or renaming the local class.
+ *
+ * `navList` is defined in exactly one CSS module in DSH
+ * (`ui-settings-general/src/client/SettingsRoot.module.css`), so the
+ * fragment cannot collide with other dialogs (Modal primitive, lightbox,
+ * onboarding steps, …) even before the structural pin.
+ *
+ * ## Specificity
+ *
+ * DSH's `.navList { display: flex; flex-direction: column; gap: 4px }` is
+ * (0,0,1,0). The base rule is (0,3,2) — three attribute selectors plus two
+ * element selectors — and DSH sets none of the base properties we touch.
+ * The idle-thumb rule (0,3,2) beats DSH's unscoped global thumb skin
+ * (0,0,1); the show rule adds a class (0,4,2) and its hover variant (0,5,2)
+ * restores DSH's idle/hover token pair while shown. No `!important`
+ * anywhere.
+ *
+ * ## Scrollbar skin
+ *
+ * The visible thumb reads DSH's themed scrollbar tokens: the panel rebinds
+ * `--dsh-scrollbar-thumb{,-hover}` to the l2 elevation tokens (declared on
+ * `.panel` so they inherit into any scrolling descendant); we reference the
+ * same custom properties so the nav bar matches the right column's look,
+ * only thinner.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+export declare const SETTINGS_NAV_SCROLL_CSS_ID = "cst-settings-nav-scroll";
+/**
+ * Mount the scroll driver: keep the scroll listener on whichever element
+ * currently matches the nav-list selector, reveal the thumb while it
+ * scrolls, fade it out after the idle delay.
+ * @param _ctx - client context (unused; signature parity with JS tweaks).
+ * @returns the disposer removing styles, listeners, and observers.
+ */
+export declare function setupSettingsNavScroll(_ctx: ClientContext): () => void;
+//# sourceMappingURL=settings-nav-scroll.d.ts.map

package/lib/types/client/tweaks/settings-nav-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-nav-scroll.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/settings-nav-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4JG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAkDnE,eAAO,MAAM,0BAA0B,4BAA4B,CAAA;AA+BnE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI,CA8EtE"}

package/lib/types/client/tweaks/stable-table.d.ts

@@ -0,0 +1,3 @@
+export declare const STABLE_TABLE_CSS_ID = "cst-stable-table";
+export declare function injectStableTableStyles(): () => void;
+//# sourceMappingURL=stable-table.d.ts.map

package/lib/types/client/tweaks/stable-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-table.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/stable-table.ts"],"names":[],"mappings":"AAoDA,eAAO,MAAM,mBAAmB,qBAAqB,CAAA;AAErD,wBAAgB,uBAAuB,IAAI,MAAM,IAAI,CAUpD"}

package/lib/types/client/tweaks/stable-turn-rail.d.ts

@@ -0,0 +1,53 @@
+/**
+ * dsh-style-tweaks — stable-turn-rail tweak.
+ *
+ * Fixes the visual jump of the turn-navigation rail when the reader scrolls
+ * the chat upward into the system-prompt area at the very top of the
+ * conversation column.
+ *
+ * ## Symptom
+ *
+ * The rail (right-side Turn navigator) sits inside the chat scroll container
+ * as a `position: sticky; top: 0; height: 0` slot. Its parent has
+ * `padding-top: 16px`. With `top: 0` sticky behaviour, the slot's natural
+ * flow position is `padding-top` below the scrollport's visible top, so:
+ *
+ *   • When the chat is scrolled far enough that the slot would naturally
+ *     be above the scrollport top (scrollTop > 16px), sticky activates and
+ *     pins the slot at scrollport top:0. Rail sits at the expected height.
+ *   • When the chat is scrolled all the way up (scrollTop ≤ 16px), the slot
+ *     falls back to its natural position — which is 16px below scrollport
+ *     top. The rail shifts DOWN by 16px.
+ *
+ * After clicking the first Turn marker, the chat lands such that the first
+ * message sits near the reading line but the chat can still scroll up into
+ * the system prompt above it. Scrolling that last bit causes the rail to
+ * visibly drop by 16px.
+ *
+ * ## Fix
+ *
+ * Move the 16px of top padding from the scroll container down into the
+ * chat column (`[data-chat-flow]`). Net effect:
+ *
+ *   • Container's `padding-top` becomes 0, so the sticky slot's natural
+ *     position is at scrollport top:0 even when scrollTop = 0.
+ *   • Column picks up `padding-top: 16px`, so the first message still
+ *     starts 16px below the scrollport top — identical visual layout to
+ *     before, only the source of those 16px has moved.
+ *
+ * Selectors use stable DSH markers only:
+ *
+ *   • `[data-chat-flow]` — the chat column (stable attribute, hardcoded in
+ *     ChatView.tsx).
+ *   • `:has(> * > nav[aria-label="Turn navigation"], > * > nav[aria-label="轮次导航"])`
+ *     — the chat scroll container, identified as the only element that has
+ *     the rail nav as a grandchild and the chat column as a direct child.
+ *     The two aria-label values cover DSH's shipped en / zh dictionaries
+ *     (TurnNavigator.tsx → `t('chat.turnNavigation.label')`).
+ *
+ * No CSS-module class names are referenced, so the fix stays correct across
+ * DSH builds that re-hash module class names.
+ */
+export declare const STABLE_TURN_RAIL_CSS_ID = "cst-stable-turn-rail";
+export declare function injectStableTurnRailStyles(): () => void;
+//# sourceMappingURL=stable-turn-rail.d.ts.map

package/lib/types/client/tweaks/stable-turn-rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-turn-rail.d.ts","sourceRoot":"","sources":["../../../../src/client/tweaks/stable-turn-rail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAkBH,eAAO,MAAM,uBAAuB,yBAAyB,CAAA;AAE7D,wBAAgB,0BAA0B,IAAI,MAAM,IAAI,CAUvD"}

package/lib/types/config.d.ts

@@ -0,0 +1,149 @@
+/**
+ * dsh-style-tweaks — configuration.
+ *
+ * Owns the `style-tweaks` settings namespace. Two feature
+ * areas:
+ *   1. Column-width control (ported from dsh-dialog-width): a px input
+ *      (600–1600) with presets, a plugin-vs-native toggle, and side margin.
+ *   2. Opt-in CSS tweaks (stable-table layout on hover, with more added
+ *      over time). Each tweak is a boolean field.
+ * @module dsh-style-tweaks/config
+ */
+import type Schema from '@deepseek-ai/schemastery';
+/** Settings document namespace owned by this plugin. */
+export declare const STYLE_TWEAKS_SETTINGS_NAMESPACE = "style-tweaks";
+/** Raw user-facing configuration (partial inputs receive schema defaults). */
+export interface StyleTweaksConfig {
+    /**
+     * Conversation column width in px. The plugin's own width input / preset
+     * row reads & writes this field when "plugin width control" is on (see
+     * `usePluginWidth`); when off, the field still mirrors the user's chosen
+     * px value to the shared storage slot so flipping the switch never loses
+     * it. Clamped to [600, 1600] on read.
+     */
+    dialogWidth?: number;
+    /**
+     * Whether the plugin's own column-width input owns the conversation width
+     * axis. On (default): the plugin writes `--dsh-chat-user-width` directly
+     * and hides the native 40 px hover handles. Off: the native drag handles
+     * own the axis (clamp(680, col×0.64, 920)) and the plugin's width input
+     * mirrors its value to the shared localStorage so flipping the switch back
+     * on restores the same px.
+     */
+    usePluginWidth?: boolean;
+    /**
+     * Whitespace in px kept on each side of the conversation area. The width
+     * axis is clamped to min(dialogWidth, liveColumn − 2 × sideMargin), so the
+     * content narrows — together with the composer card — when the sidebar
+     * opens or the window shrinks, never hugging the edges. Minimum 32 px.
+     */
+    sideMargin?: number;
+    /**
+     * Lock markdown table layout on hover so the table does not reflow and push
+     * surrounding content around. Fixes the "text jumps when I hover a table"
+     * layout-shift bug reported against the stock conversation view.
+     */
+    stableTable?: boolean;
+    /**
+     * Keep the turn-navigation rail at a stable position when scrolling up
+     * past the first message into the system-prompt area. Without this fix
+     * the rail drops by 16px (the chat scroll container's `padding-top`)
+     * because the rail slot is `position: sticky; top: 0` inside that
+     * padded container.
+     */
+    stableTurnRail?: boolean;
+    /**
+     * Remove the 16 px gap above highlighted code blocks so the highlighted
+     * box sits flush with the preceding paragraph, list item, or heading.
+     * The wrapper (`.md-code-block` in `CodeBlock.module.css`) ships with
+     * `margin: 16px 0`; this tweak overrides only the top edge.
+     */
+    codeBlockFlushTop?: boolean;
+    /**
+     * Show the conversation title's animated running dot on the right side of
+     * every project directory header row in the sidebar, so a running
+     * conversation stays visible even when its group is collapsed. The dot is
+     * DSH's own `StateDot` (shared instance) driven by the app's
+     * sessions/workspaces stores — pendingInteraction (amber) needs the
+     * ui-session service face and is out of scope; only ongoing shows.
+     */
+    projectRunningIndicator?: boolean;
+    /**
+     * Add a "locate" button next to the sidebar search box; clicking it
+     * expands the current session's workspace and scrolls the session into
+     * view. Client-side toggle only: the browser bundle reads this field and
+     * mounts / unmounts the button live.
+     */
+    locateCurrentSession?: boolean;
+    /**
+     * Let the settings dialog's left nav column scroll once its section list
+     * outgrows the fixed-height panel, instead of the panel's
+     * `overflow: hidden` clipping the bottom entries (unreachable when enough
+     * plugins register settings sections).
+     */
+    settingsNavScroll?: boolean;
+}
+/** Dialog width in px. 600 is the chat-column minimum, 1600 the soft cap. */
+export declare const MIN_DIALOG_WIDTH = 600;
+export declare const MAX_DIALOG_WIDTH = 1600;
+/** 748 matches the stock DSH column. */
+export declare const DEFAULT_DIALOG_WIDTH = 748;
+/**
+ * Plugin width control defaults to ON: existing settings documents never had
+ * this field, so the default must match what users saw before the native
+ * handles shipped — the plugin owning the column.
+ */
+export declare const DEFAULT_USE_PLUGIN_WIDTH = true;
+/** Default side margin in px — 50 gives a comfortable gap on each side. */
+export declare const DEFAULT_SIDE_MARGIN = 50;
+/** Minimum side margin in px — below 32 the gap becomes too tight. */
+export declare const MIN_SIDE_MARGIN = 32;
+/**
+ * localStorage slot the native WidthHandle reads/writes; kept here so a
+ * future rename of the host key only needs touching one place. We mirror
+ * the plugin's chosen px value here too so toggling plugin-width off
+ * surfaces the user's last choice in the native handle.
+ */
+export declare const CONVERSATION_WIDTH_STORAGE_KEY = "dsh.conversation.contentWidth";
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_STABLE_TABLE = true;
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_STABLE_TURN_RAIL = true;
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_CODE_BLOCK_FLUSH_TOP = true;
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_PROJECT_RUNNING_INDICATOR = true;
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_LOCATE_CURRENT_SESSION = true;
+/** Default: every shipped tweak is on. */
+export declare const DEFAULT_SETTINGS_NAV_SCROLL = true;
+/** Configuration schema with documented defaults. */
+export declare const Config: Schema<StyleTweaksConfig>;
+/** Configuration after static validation, with every default materialized. */
+export interface ResolvedStyleTweaksConfig {
+    /** Dialog width in px (748 = the stock DSH column). */
+    dialogWidth: number;
+    /** Whether the plugin's width control owns the column (vs. native handles). */
+    usePluginWidth: boolean;
+    /** Side margin in px applied to both sides of the conversation column. */
+    sideMargin: number;
+    /** Whether the stable-table tweak is enabled. */
+    stableTable: boolean;
+    /** Whether the stable-turn-rail tweak is enabled. */
+    stableTurnRail: boolean;
+    /** Whether the code-block-flush-top tweak is enabled. */
+    codeBlockFlushTop: boolean;
+    /** Whether the project-running-indicator tweak is enabled. */
+    projectRunningIndicator: boolean;
+    /** Whether the locate-current-session tweak is enabled. */
+    locateCurrentSession: boolean;
+    /** Whether the settings-nav-scroll tweak is enabled. */
+    settingsNavScroll: boolean;
+}
+/** Resolve a partial config into a fully defaulted value. */
+export declare function resolveConfig(config?: StyleTweaksConfig): ResolvedStyleTweaksConfig;
+/** Normalize a dialog width value (legacy strings included) to px. */
+export declare function resolveDialogWidth(value: number | undefined): number;
+/** Normalize a side-margin value (legacy strings included) to px. */
+export declare function resolveSideMargin(value: number | undefined): number;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAA;AAElD,wDAAwD;AACxD,eAAO,MAAM,+BAA+B,iBAAiB,CAAA;AAE7D,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAEhC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAGD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,wCAAwC;AACxC,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAC5C,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,KAAK,CAAA;AACrC,sEAAsE;AACtE,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,kCAAkC,CAAA;AAG7E,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,OAAO,CAAA;AACxC,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAC5C,0CAA0C;AAC1C,eAAO,MAAM,4BAA4B,OAAO,CAAA;AAChD,0CAA0C;AAC1C,eAAO,MAAM,iCAAiC,OAAO,CAAA;AACrD,0CAA0C;AAC1C,eAAO,MAAM,8BAA8B,OAAO,CAAA;AAClD,0CAA0C;AAC1C,eAAO,MAAM,2BAA2B,OAAO,CAAA;AAE/C,qDAAqD;AACrD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,iBAAiB,CAU3C,CAAA;AAEF,8EAA8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAA;IACvB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,cAAc,EAAE,OAAO,CAAA;IACvB,yDAAyD;IACzD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,8DAA8D;IAC9D,uBAAuB,EAAE,OAAO,CAAA;IAChC,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAA;IAC7B,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,yBAAyB,CAYvF;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKpE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGnE"}