dsh-smooth-stream 0.5.0 → 0.6.1

package/src/client/TypewriterAssistantNodeView.tsx

@@ -1,4 +1,4 @@
-import { memo, useEffect, useLayoutEffect, useMemo, useRef, useState, type ComponentProps, type ReactNode } from 'react'
+import { memo, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, type ComponentProps, type ReactNode, type RefObject } from 'react'
 import { IconThinkOutline14, JsonBlock, MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives'
 import { ImageGallery, type ImageLoader, type MessageImageLabels } from '@deepseek-ai/dsh-client-ui-attachment'
 import type { ChatNodeViewProps, TurnTailOwnerProps } from '@deepseek-ai/dsh-client-ui-conversation/client'
@@ -6,9 +6,10 @@ import { AnimatedDisclosure } from './AnimatedDisclosure.tsx'
 import { notifyFollowCommit } from './teleprompterGlide.ts'
 import { useSmoothStreamContent, type StreamSmoothingPreset } from './useSmoothStreamContent.ts'
 import { useFpsGuard } from './useFpsGuard.ts'
+import { useLogarithmicFade } from './useLogarithmicFade.ts'
 import { FollowHost } from './FollowHost.tsx'
 import { DEFAULT_STREAM_CONFIG, type StreamMode } from '../config.ts'
-import { DEFAULT_STREAM_SETTINGS } from '../settings.ts'
+import { DEFAULT_STREAM_SETTINGS, type StreamMotionPreference } from '../settings.ts'
 import css from './TypewriterAssistantNodeView.module.css'
 
 type AssistantProps = ChatNodeViewProps<'assistant-step'>
@@ -28,8 +29,26 @@ function usePrefersReducedMotion(): boolean {
   return reduced
 }
 
+/**
+ * Resolve whether the reveal engine should stay off for this view. The OS
+ * preference wins only in `auto` mode: `force-smooth` keeps the engine on
+ * machines where a system-wide reduce-motion switch (or a forced browser
+ * flag) would otherwise silently bypass smoothing, and `force-reduced`
+ * disables it even when the OS asks for motion. Credit: three-state design
+ * proposed by @Zn-Dk in #21/#22.
+ */
+function useMotionReduced(preference: StreamMotionPreference): boolean {
+  const system = usePrefersReducedMotion()
+  if (preference === 'force-smooth') return false
+  if (preference === 'force-reduced') return true
+  return system
+}
+
 interface AnimatedMarkdownTextProps extends MarkdownProps {
   streaming: boolean
+  logarithmicFade: boolean
+  /** Whether the resolved reduced-motion gate keeps the reveal engine off. */
+  motionReduced: boolean
   /** True on the last text block: that block owns conversation follow. */
   ownFollow: boolean
   followSpeedCpsRef?: { current: number } | undefined
@@ -290,6 +309,8 @@ function AnimatedMarkdownText({
   labels,
   fileMentions,
   streaming,
+  logarithmicFade,
+  motionReduced,
   ownFollow,
   followSpeedCpsRef,
   followRevealedCharsRef,
@@ -299,7 +320,7 @@ function AnimatedMarkdownText({
   shouldHoldBack,
   controlScroll = true,
 }: AnimatedMarkdownTextProps) {
-  const reduced = usePrefersReducedMotion()
+  const reduced = motionReduced
   const [typing, setTyping] = useState(streaming)
   const localSpeedCpsRef = useRef(35)
   const followRootRef = useRef<HTMLDivElement>(null)
@@ -319,6 +340,7 @@ function AnimatedMarkdownText({
   })
   const shown = reduced ? text : displayed
   const live = typing && !reduced
+  useLogarithmicFade(followRootRef, logarithmicFade && !reduced, live, speedCpsRef)
 
   useEffect(() => {
     const root = followRootRef.current
@@ -350,6 +372,14 @@ function AnimatedMarkdownText({
     if (typing && !streaming && shown.length === text.length) setTyping(false)
   }, [shown, streaming, text, typing])
 
+  // A row can mount before the projection flips its assistant step to
+  // `running`, which would freeze `typing` at false forever and leave the
+  // reveal engine off for the whole reply. Re-arm on the rising edge so late
+  // stream starts are still smoothed. (Adopted from #22 by @Zn-Dk.)
+  useEffect(() => {
+    if (streaming) setTyping(true)
+  }, [streaming])
+
   return (
     <FollowHost
       active={live && ownFollow}
@@ -387,6 +417,61 @@ function imageLabels(t: AssistantProps['t']): MessageImageLabels {
   }
 }
 
+/**
+ * Apply searchable hidden state without unmounting a stable subtree — the
+ * Host's completion fold hides the answer-inline reasoning this way, so the
+ * takeover renderer must reproduce it to stay inside the contract: the row
+ * disappears into the Host's process summary and comes back on find-in-page.
+ * (Mirrors the Harness chat kit's `useSearchableHidden`.)
+ */
+function useSearchableHidden(
+  hidden: boolean,
+  reveal: () => void,
+): RefObject<HTMLDivElement> {
+  const ref = useRef<HTMLDivElement>(null)
+  useLayoutEffect(() => {
+    const element = ref.current
+    if (element === null) return
+    if (hidden && element.contains(element.ownerDocument.activeElement)) {
+      reveal()
+      return
+    }
+    if (hidden) element.setAttribute('hidden', 'until-found')
+    else element.removeAttribute('hidden')
+  }, [hidden, reveal])
+  useEffect(() => {
+    const element = ref.current
+    if (element === null) return
+    element.addEventListener('beforematch', reveal)
+    return () => { element.removeEventListener('beforematch', reveal) }
+  }, [reveal])
+  return ref
+}
+
+/**
+ * One answer-inline reasoning block wrapped in the Host's fold contract. The
+ * Host computes the fold decision (turn closed, compact transcript, this node
+ * is the answer) and delivers it through the `turnProcess` owner prop; when
+ * folded the block hides into the Host's "thought" summary row instead of
+ * staying mounted above the answer.
+ */
+function FoldableReasoning({
+  hidden,
+  reveal,
+  children,
+}: {
+  hidden: boolean
+  reveal: () => void
+  children: ReactNode
+}) {
+  const ref = useSearchableHidden(hidden, reveal)
+  return (
+    <div ref={ref} data-turn-process-inline={hidden || undefined}>
+      {children}
+    </div>
+  )
+}
+
 function firstLine(text: string): string {
   const newline = text.indexOf('\n')
   return newline === -1 ? text : text.slice(0, newline)
@@ -412,6 +497,8 @@ function AnimatedReasoning({
   running,
   preset,
   thinkAutoExpand,
+  motionReduced,
+  logarithmicFade,
   shouldHoldBack,
   followSpeedCpsRef,
   followRevealScaleRef,
@@ -421,15 +508,20 @@ function AnimatedReasoning({
   running: boolean
   preset: StreamSmoothingPreset
   thinkAutoExpand: boolean
+  motionReduced: boolean
+  logarithmicFade: boolean
   shouldHoldBack: () => boolean
   followSpeedCpsRef?: { current: number } | undefined
   followRevealScaleRef?: { current: number } | undefined
   t: AssistantProps['t']
 }) {
-  const reduced = usePrefersReducedMotion()
+  const reduced = motionReduced
   const [expanded, setExpanded] = useState(running && thinkAutoExpand)
   const [autoClosed, setAutoClosed] = useState(false)
   const summaryRef = useRef<HTMLSpanElement>(null)
+  const fadeRootRef = useRef<HTMLDivElement>(null)
+  const localFadeSpeedRef = useRef(35)
+  const fadeSpeedRef = followSpeedCpsRef ?? localFadeSpeedRef
   const commitAnchorRef = useRef<HTMLDivElement>(null)
   // The running→false flip is the AUTO-close: it collapses instantly and the
   // follower's settle spring absorbs the height step. A later manual toggle
@@ -438,12 +530,13 @@ function AnimatedReasoning({
     enabled: running && !reduced,
     preset,
     shouldHoldBack,
-    speedCpsRef: followSpeedCpsRef,
+    speedCpsRef: fadeSpeedRef,
     revealScaleRef: followRevealScaleRef,
     onRevealCommit: () => { notifyFollowCommit(commitAnchorRef.current) },
   })
   const shown = running && !reduced ? displayed : text
   const summary = running ? latestLine(shown) : firstLine(text)
+  useLogarithmicFade(fadeRootRef, logarithmicFade && !reduced && expanded, running, fadeSpeedRef)
 
   useLayoutEffect(() => {
     // Only the running state owns disclosure while auto-expand is on; with it
@@ -493,7 +586,7 @@ function AnimatedReasoning({
             </>
           )}
         >
-          <div className={css.thinkBody}>{shown}</div>
+          <div ref={fadeRootRef} className={css.thinkBody}>{shown}</div>
         </AnimatedDisclosure>
       </div>
     </div>
@@ -517,12 +610,15 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
   scrollSpeedPxPerSec: _scrollSpeedPxPerSec = DEFAULT_STREAM_CONFIG.scrollSpeedPxPerSec,
   maxScrollSpeedPxPerSec: _maxScrollSpeedPxPerSec = DEFAULT_STREAM_CONFIG.maxScrollSpeedPxPerSec,
   thinkAutoExpand = DEFAULT_STREAM_SETTINGS.thinkAutoExpand,
+  logarithmicFade = DEFAULT_STREAM_SETTINGS.logarithmicFade,
   controlScroll = true,
+  motionPreference = DEFAULT_STREAM_SETTINGS.motionPreference,
   node,
   useTurnData,
   openFile,
   loadImage,
   fileMentions,
+  turnProcess,
   t,
 }: AssistantProps & {
   mode?: StreamMode
@@ -531,11 +627,23 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
   scrollSpeedPxPerSec?: number
   maxScrollSpeedPxPerSec?: number
   thinkAutoExpand?: boolean
+  logarithmicFade?: boolean
   controlScroll?: boolean
+  motionPreference?: StreamMotionPreference
 }) {
   const data = node.data
   const streaming = data.status === 'running'
-  const reduced = usePrefersReducedMotion()
+  const reduced = useMotionReduced(motionPreference)
+  // The Host's completion-fold decision for THIS node's inline reasoning:
+  // only the answer step folds, only in compact-transcript mode, and only
+  // once the turn has closed (foldable implies it). Mirrors the built-in
+  // assistant renderer so the takeover keeps the official behavior.
+  const reasoningHidden = turnProcess !== undefined
+    && turnProcess.foldable
+    && turnProcess.spec.answerStep === data.step
+    && turnProcess.spec.inlineReasoning
+    && !turnProcess.open
+  const revealProcess = useCallback(() => { turnProcess?.setOpen(true) }, [turnProcess])
   const { ref: guardRef, shouldHoldBack } = useFpsGuard(streaming)
   const rootSpeedRef = useRef(35)
   const rootRevealedCharsRef = useRef(0)
@@ -608,6 +716,8 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
             labels={markdownLabels}
             fileMentions={mentions}
             streaming={streaming}
+            logarithmicFade={logarithmicFade && data.status !== 'interrupted'}
+            motionReduced={reduced}
             ownFollow={!streaming && index === lastFollow}
             followSpeedCpsRef={index === lastFollow ? rootSpeedRef : undefined}
             followRevealedCharsRef={index === lastFollow ? rootRevealedCharsRef : undefined}
@@ -621,17 +731,20 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
         break
       case 'reasoning':
         rendered.push(
-          <AnimatedReasoning
-            key={index}
-            text={block.text}
-            running={streaming && index === last}
-            preset={preset}
-            thinkAutoExpand={thinkAutoExpand}
-            shouldHoldBack={shouldHoldBack}
-            followSpeedCpsRef={reasoningOwnsSpeed && index === last ? rootSpeedRef : undefined}
-            followRevealScaleRef={reasoningOwnsSpeed && index === last ? rootRevealScaleRef : undefined}
-            t={t}
-          />,
+          <FoldableReasoning key={index} hidden={reasoningHidden} reveal={revealProcess}>
+            <AnimatedReasoning
+              text={block.text}
+              running={streaming && index === last}
+              preset={preset}
+              thinkAutoExpand={thinkAutoExpand}
+              logarithmicFade={logarithmicFade && data.status !== 'interrupted'}
+              motionReduced={reduced}
+              shouldHoldBack={shouldHoldBack}
+              followSpeedCpsRef={reasoningOwnsSpeed && index === last ? rootSpeedRef : undefined}
+              followRevealScaleRef={reasoningOwnsSpeed && index === last ? rootRevealScaleRef : undefined}
+              t={t}
+            />
+          </FoldableReasoning>,
         )
         break
       case 'image': {

package/src/client/index.ts

@@ -157,7 +157,9 @@ class SettingsCell {
       pending === this.pending
       && next.enabled === this.value.enabled
       && next.controlScroll === this.value.controlScroll
+      && next.motionPreference === this.value.motionPreference
       && next.thinkAutoExpand === this.value.thinkAutoExpand
+      && next.logarithmicFade === this.value.logarithmicFade
       && next.debugEnabled === this.value.debugEnabled
       && next.debugTuning === this.value.debugTuning
     ) return
@@ -269,7 +271,9 @@ export function apply(ctx: ClientContext): void {
       scrollSpeedPxPerSec: config.scrollSpeedPxPerSec,
       maxScrollSpeedPxPerSec: config.maxScrollSpeedPxPerSec,
       thinkAutoExpand: preferences.thinkAutoExpand,
+      logarithmicFade: preferences.logarithmicFade,
       controlScroll: preferences.controlScroll,
+      motionPreference: preferences.motionPreference,
     })
   }
   ctx.slots.inject('conversation.chat.node', () => {

package/src/client/locales.ts

@@ -8,7 +8,12 @@ export type SmoothStreamLocaleKey =
   | 'title' | 'description'
   | 'enabled' | 'enabledHint'
   | 'controlScroll' | 'controlScrollHint'
+  | 'motionPreference' | 'motionPreferenceHint'
+  | 'motionAuto' | 'motionAutoHint'
+  | 'motionForceSmooth' | 'motionForceSmoothHint'
+  | 'motionForceReduced' | 'motionForceReducedHint'
   | 'thinkAutoExpand' | 'thinkAutoExpandHint'
+  | 'logarithmicFade' | 'logarithmicFadeHint'
   | 'debugEnabled' | 'debugEnabledHint' | 'debugUnavailable'
   | 'debugPanelTitle' | 'debugPanelToggle' | 'debugPanelClose' | 'debugGuide'
   | 'debugLive' | 'debugIdle' | 'debugUnsaved'
@@ -37,7 +42,17 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: 'Let this plugin render and follow streaming replies. Turn off to use the built-in Harness renderer.',
   controlScroll: 'Take over scrolling',
   controlScrollHint: 'On by default; smooth-stream writes the conversation scroll position. Turn off to leave bottom-follow to Harness.',
+  motionPreference: 'Motion',
+  motionPreferenceHint: 'How streaming responds to the system reduce-motion setting.',
+  motionAuto: 'Follow system',
+  motionAutoHint: 'Reduced-motion systems get raw text (accessibility first).',
+  motionForceSmooth: 'Always smooth',
+  motionForceSmoothHint: 'Keep the smoothing engine even when the system asks for reduced motion.',
+  motionForceReduced: 'Always raw',
+  motionForceReducedHint: 'Render raw text even when the system allows motion.',
   thinkAutoExpand: 'Auto-expand thinking',
+  logarithmicFade: 'Logarithmic fade',
+  logarithmicFadeHint: 'Fade new answer and expanded thinking text into view. Follows the motion preference.',
   thinkAutoExpandHint: 'Open the thinking block while it streams. Turn off to keep it collapsed.',
   debugEnabled: 'Show render diagnostics',
   debugEnabledHint: 'Show live streaming and scroll metrics on the right side of the chat. Tune values there, then save them here.',
@@ -117,7 +132,17 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: '由本插件渲染并跟随流式回复；关闭后使用 Harness 内置渲染。',
   controlScroll: '接管滚动',
   controlScrollHint: '默认开启，由丝滑流式写入会话滚动位置；关闭后贴底滚动交给 Harness。',
+  motionPreference: '动效偏好',
+  motionPreferenceHint: '流式渲染如何响应系统的「减少动态效果」设置。',
+  motionAuto: '跟随系统',
+  motionAutoHint: '系统开启减少动态效果时直接呈现原始文本（优先无障碍）。',
+  motionForceSmooth: '始终平滑',
+  motionForceSmoothHint: '即使系统要求减少动态效果，仍保持平滑流式渲染。',
+  motionForceReduced: '始终原始',
+  motionForceReducedHint: '即使系统允许动效，也直接呈现原始文本。',
   thinkAutoExpand: '自动展开思考',
+  logarithmicFade: '对数淡入',
+  logarithmicFadeHint: '让回答正文和展开的思考文字由淡变实，遵循动效偏好。',
   thinkAutoExpandHint: '思考块在流式时自动展开；关闭后保持折叠，可手动展开。',
   debugEnabled: '显示渲染调试面板',
   debugEnabledHint: '在聊天右侧显示流式渲染和滚动的实时参数，可在面板中调节并在这里保存。',

package/src/client/smooth-stream-card-controller.ts

@@ -5,6 +5,7 @@ import {
   DEFAULT_STREAM_DEBUG_TUNING,
   DEFAULT_STREAM_SETTINGS,
   type StreamDebugTuning,
+  type StreamMotionPreference,
   type StreamSettings,
 } from '../settings.ts'
 import type {
@@ -23,7 +24,9 @@ export interface SmoothStreamCardState {
   failed: boolean
   enabled: boolean
   controlScroll: boolean
+  motionPreference: StreamMotionPreference
   thinkAutoExpand: boolean
+  logarithmicFade: boolean
   debugEnabled: boolean
   debugTuning: StreamDebugTuning
   debugAvailable: boolean
@@ -52,7 +55,7 @@ export class SmoothStreamCardController {
   private readonly store = createSnapshotStore<SmoothStreamCardState>(this.projection())
   private loaded: StreamSettingsView | undefined
   private loadedDebug: StreamDebugSettingsView | undefined
-  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'thinkAutoExpand'> | undefined
+  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> | undefined
   private stagedDebug: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'> | undefined
   private saving = false
   private failed = false
@@ -90,12 +93,14 @@ export class SmoothStreamCardController {
       hooks: { smoothStreamCard: this.store },
       edit: (patch) => {
         if (this.saving) return
-        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.thinkAutoExpand !== undefined) {
+        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.motionPreference !== undefined || patch.thinkAutoExpand !== undefined || patch.logarithmicFade !== undefined) {
           this.stagedBase = {
             ...this.baseValues(),
             ...(patch.enabled === undefined ? {} : { enabled: patch.enabled }),
             ...(patch.controlScroll === undefined ? {} : { controlScroll: patch.controlScroll }),
+            ...(patch.motionPreference === undefined ? {} : { motionPreference: patch.motionPreference }),
             ...(patch.thinkAutoExpand === undefined ? {} : { thinkAutoExpand: patch.thinkAutoExpand }),
+            ...(patch.logarithmicFade === undefined ? {} : { logarithmicFade: patch.logarithmicFade }),
           }
         }
         if (this.loadedDebug !== undefined && (patch.debugEnabled !== undefined || patch.debugTuning !== undefined)) {
@@ -140,11 +145,13 @@ export class SmoothStreamCardController {
     }
   }
 
-  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'thinkAutoExpand'> {
+  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> {
     return this.stagedBase ?? {
       enabled: this.loaded?.enabled ?? DEFAULT_STREAM_SETTINGS.enabled,
       controlScroll: this.loaded?.controlScroll ?? DEFAULT_STREAM_SETTINGS.controlScroll,
+      motionPreference: this.loaded?.motionPreference ?? DEFAULT_STREAM_SETTINGS.motionPreference,
       thinkAutoExpand: this.loaded?.thinkAutoExpand ?? DEFAULT_STREAM_SETTINGS.thinkAutoExpand,
+      logarithmicFade: this.loaded?.logarithmicFade ?? DEFAULT_STREAM_SETTINGS.logarithmicFade,
     }
   }
 

package/src/client/smooth-stream-settings-api.ts

@@ -24,11 +24,13 @@ function settingsView(value: unknown): StreamSettingsView {
     || typeof data.writable !== 'boolean'
     || typeof data.enabled !== 'boolean'
     || typeof data.controlScroll !== 'boolean'
+    || !['auto', 'force-smooth', 'force-reduced'].includes(data.motionPreference as string)
     || typeof data.thinkAutoExpand !== 'boolean'
+    || (data.logarithmicFade !== undefined && typeof data.logarithmicFade !== 'boolean')
     || typeof data.canUpgrade !== 'boolean') {
     throw new Error('dsh-smooth-stream: malformed settings response')
   }
-  return data as unknown as StreamSettingsView
+  return { ...data, logarithmicFade: data.logarithmicFade ?? true } as unknown as StreamSettingsView
 }
 
 function upgradeView(value: unknown): StreamUpgradeView {
@@ -68,7 +70,7 @@ function accepted(result: Awaited<ReturnType<ConnectionHandle['rpc']['call']>>):
 /** Narrow client contract consumed by the staged settings-card controller. */
 export interface SmoothStreamSettingsApi {
   read(): Promise<StreamSettingsView>
-  write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'thinkAutoExpand'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView>
+  write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView>
   readDebug(): Promise<StreamDebugSettingsView>
   writeDebug(settings: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>): Promise<StreamDebugSettingsView>
   upgrade(): Promise<StreamUpgradeView>
@@ -80,14 +82,16 @@ export function createSmoothStreamSettingsApi(connection: ConnectionHandle): Smo
     async read(): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(STREAM_SETTINGS_RPC_CHANNEL, STREAM_SETTINGS_RPC.read, {})))
     },
-    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'thinkAutoExpand'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
+    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(
         STREAM_SETTINGS_RPC_CHANNEL,
         STREAM_SETTINGS_RPC.write,
         {
           enabled: settings.enabled,
           controlScroll: settings.controlScroll,
+          motionPreference: settings.motionPreference,
           thinkAutoExpand: settings.thinkAutoExpand,
+          logarithmicFade: settings.logarithmicFade,
           ...(settings.debugEnabled === undefined || settings.debugTuning === undefined
             ? {}
             : { debugEnabled: settings.debugEnabled, debugTuning: settings.debugTuning }),

package/src/client/teleprompterGlide.ts

@@ -780,8 +780,9 @@ function measureReadingAnchor(port: HTMLElement): { anchor: HTMLElement; index:
     return null
   }
   // Host-caused motion only: the engine's own shift glide and floor changes
-  // cancel out (renderedΔ = topΔ − shiftΔ + floorΔ).
-  const delta = (top - stored.top) - (shift - stored.shift) + (pad - stored.pad)
+  // cancel out (renderedΔ = topΔ + scrollΔ − shiftΔ + padΔ).
+  const scrollDelta = scrollTop - stored.scrollTop
+  const delta = (top - stored.top) + scrollDelta - (shift - stored.shift) + (pad - stored.pad)
   if (stored.element === anchor) {
     // Refresh the baseline to the current rendered position on every
     // measurement: between guard passes the viewport legitimately moves
@@ -2492,25 +2493,14 @@ export function useConversationFollow(
       // measure the extent against it):
       let settleQuietMs = 0
       let settleSig = ''
-      const lagBeforeCompletionPaint = Math.max(
-        0,
-        host.scrollHeight - animatedH - runwayOffsetOf(host),
-      )
-      const currentRunway = runwayOffsetOf(host)
-      const currentShift = Math.abs(currentShiftOf(shiftSurfacesOf(host).at(-1) ?? host))
-      if (
-        !activeRef.current
-        && lagBeforeCompletionPaint <= FOLLOW_SLACK_PX
-        && currentRunway <= FOLLOW_SETTLE_EPSILON_PX
-        && currentShift <= FOLLOW_SETTLE_EPSILON_PX
-        // A live completion pad must retire through the settle's glide first;
-        // fast-finishing here would freeze it in place as visible bottom gap.
-        && flowPadOf(host) <= FOLLOW_SETTLE_EPSILON_PX
-      ) {
+      if (!activeRef.current) {
         followTraceUntilMs = Math.max(followTraceUntilMs, performance.now() + 10000)
         followTrace('fast-gate', { sh: host.scrollHeight, st: Math.round(host.scrollTop), pad: Math.round(flowPadOf(host)) })
-        finishAtNaturalFloor(host, !startedAsEntrance)
+        restoreRunway(host)
+        setFlowPad(host, 0)
+        finishAtNaturalFloor(host, !startedAsEntrance, true)
         followLeaders.delete(host)
+        followCompletionSettle.delete(host)
         releaseRevealScale()
         debugRuntime.reportFollow(host, null)
         return

package/src/client/turn-process-face.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Turn-process fold face for the DSH 0.1.2 completion-collapse contract.
+ *
+ * The Host seat hands every keyed Chat renderer a `turnProcess` owner prop
+ * when the node belongs to a projected Turn: the fold decision lives in the
+ * conversation snapshot (turn closed + compact transcript), and the renderer
+ * is expected to hide its answer-inline reasoning while folded. The pinned
+ * type-only dependency predates the field, so the face is declared here and
+ * merged into the owner-props interface; erases at compile time.
+ */
+export interface TurnProcessOwnerFace {
+  /** Answer anchor of the projection; null while the answer has not landed. */
+  readonly spec: { readonly answerStep: number | null, readonly inlineReasoning: boolean }
+  /** Whether this node's process content may fold (turn closed + compact mode). */
+  readonly foldable: boolean
+  /** Current fold state, persisted by the Host across sessions. */
+  readonly open: boolean
+  /** Fold or unfold from the renderer side (summary click, find-in-page reveal). */
+  setOpen(open: boolean): void
+}
+
+declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
+  interface ChatNodeOwnerProps {
+    /** Present only when the node belongs to a projected Turn (0.1.2+). */
+    turnProcess?: TurnProcessOwnerFace | undefined
+  }
+}