dsh-smooth-stream 0.5.0 → 0.6.0

package/lib/index.js

@@ -164,6 +164,7 @@ const STREAM_SETTINGS_NS = "smooth-stream";
 const DEFAULT_STREAM_SETTINGS = {
 	enabled: true,
 	controlScroll: true,
+	motionPreference: "auto",
 	thinkAutoExpand: true,
 	debugEnabled: false,
 	debugTuning: {
@@ -200,6 +201,11 @@ const Config = Schema.object({
 const StreamSettingsSchema = Schema.object({
 	enabled: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.enabled),
 	controlScroll: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.controlScroll),
+	motionPreference: Schema.union([
+		Schema.const("auto"),
+		Schema.const("force-smooth"),
+		Schema.const("force-reduced")
+	]).default(DEFAULT_STREAM_SETTINGS.motionPreference),
 	thinkAutoExpand: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.thinkAutoExpand),
 	debugEnabled: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.debugEnabled),
 	debugTuning: Schema.object({
@@ -241,6 +247,7 @@ function apply(ctx, config) {
 					writable: connectionCtx.settings.writable,
 					enabled: settings.enabled,
 					controlScroll: settings.controlScroll,
+					motionPreference: settings.motionPreference,
 					thinkAutoExpand: settings.thinkAutoExpand,
 					canUpgrade: installation.kind === "npm"
 				};
@@ -281,6 +288,14 @@ function apply(ctx, config) {
 					};
 					try {
 						const next = payload;
+						if (next.motionPreference !== void 0 && next.motionPreference !== "auto" && next.motionPreference !== "force-smooth" && next.motionPreference !== "force-reduced") return {
+							ok: false,
+							error: {
+								code: "settings-rejected",
+								message: "motionPreference must be one of auto | force-smooth | force-reduced",
+								details: { ns: STREAM_SETTINGS_NS }
+							}
+						};
 						const hasDebug = next.debugEnabled !== void 0 || next.debugTuning !== void 0;
 						if (hasDebug && (typeof next.debugEnabled !== "boolean" || !validDebugTuning(next.debugTuning))) return {
 							ok: false,
@@ -293,6 +308,7 @@ function apply(ctx, config) {
 						await scope.update({
 							enabled: next.enabled,
 							controlScroll: next.controlScroll,
+							...next.motionPreference === void 0 ? {} : { motionPreference: next.motionPreference },
 							thinkAutoExpand: next.thinkAutoExpand,
 							...hasDebug ? {
 								debugEnabled: next.debugEnabled,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-smooth-stream",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Fluid streaming rendering and silky scrolling for DeepSeek Harness replies, including Markdown, code blocks, tables, and tool results.",
   "license": "MIT",
   "type": "module",

package/src/client/SmoothStreamCard.module.css

@@ -157,6 +157,40 @@
   outline-offset: 2px;
 }
 
+.choiceRow {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px 14px;
+  margin: 2px 0 0;
+  padding: 0;
+}
+
+.choice {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-secondary);
+  cursor: pointer;
+}
+
+.choiceInput {
+  width: 14px;
+  height: 14px;
+  accent-color: var(--dsw-alias-brand-primary);
+  cursor: pointer;
+}
+
+.choice:has(.choiceInput:disabled) {
+  cursor: default;
+  opacity: 0.55;
+}
+
+.choiceInput:disabled {
+  cursor: default;
+}
+
 .hint {
   margin: 0;
   font-size: 12px;

package/src/client/SmoothStreamCard.tsx

@@ -84,6 +84,35 @@ export function SmoothStreamCard(props: SmoothStreamCardProps) {
                   </span>
                   <span className={css.hint}>{t('controlScrollHint')}</span>
                 </label>
+                {/* Motion preference is a radio group, so this row is a div:
+                    nesting the choice labels inside a field <label> would be
+                    illegal HTML (label within label) and browsers route the
+                    inner click away, so React never sees onChange. */}
+                <div className={state.enabled ? css.field : `${css.field} ${css.fieldDisabled}`}>
+                  <span className={css.fieldHead}>
+                    <span className={css.label}>{t('motionPreference')}</span>
+                  </span>
+                  <span className={css.hint}>{t('motionPreferenceHint')}</span>
+                  <span className={css.choiceRow} role="radiogroup" aria-label={t('motionPreference')}>
+                    {([
+                      ['auto', 'motionAuto', 'motionAutoHint'],
+                      ['force-smooth', 'motionForceSmooth', 'motionForceSmoothHint'],
+                      ['force-reduced', 'motionForceReduced', 'motionForceReducedHint'],
+                    ] as const).map(([value, label, hint]) => (
+                      <label key={value} className={css.choice} title={t(hint)}>
+                        <input
+                          type="radio"
+                          className={css.choiceInput}
+                          name="smooth-stream-motion"
+                          checked={state.motionPreference === value}
+                          disabled={!state.writable || state.saving || !state.enabled}
+                          onChange={() => { props.edit({ motionPreference: value }) }}
+                        />
+                        {t(label)}
+                      </label>
+                    ))}
+                  </span>
+                </div>
                 <label className={state.enabled ? css.field : `${css.field} ${css.fieldDisabled}`}>
                   <span className={css.fieldHead}>
                     <span className={css.label}>{t('thinkAutoExpand')}</span>

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'
@@ -8,7 +8,7 @@ import { useSmoothStreamContent, type StreamSmoothingPreset } from './useSmoothS
 import { useFpsGuard } from './useFpsGuard.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 +28,25 @@ 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
+  /** 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 +307,7 @@ function AnimatedMarkdownText({
   labels,
   fileMentions,
   streaming,
+  motionReduced,
   ownFollow,
   followSpeedCpsRef,
   followRevealedCharsRef,
@@ -299,7 +317,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)
@@ -350,6 +368,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 +413,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 +493,7 @@ function AnimatedReasoning({
   running,
   preset,
   thinkAutoExpand,
+  motionReduced,
   shouldHoldBack,
   followSpeedCpsRef,
   followRevealScaleRef,
@@ -421,12 +503,13 @@ function AnimatedReasoning({
   running: boolean
   preset: StreamSmoothingPreset
   thinkAutoExpand: boolean
+  motionReduced: 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)
@@ -518,11 +601,13 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
   maxScrollSpeedPxPerSec: _maxScrollSpeedPxPerSec = DEFAULT_STREAM_CONFIG.maxScrollSpeedPxPerSec,
   thinkAutoExpand = DEFAULT_STREAM_SETTINGS.thinkAutoExpand,
   controlScroll = true,
+  motionPreference = DEFAULT_STREAM_SETTINGS.motionPreference,
   node,
   useTurnData,
   openFile,
   loadImage,
   fileMentions,
+  turnProcess,
   t,
 }: AssistantProps & {
   mode?: StreamMode
@@ -532,10 +617,21 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
   maxScrollSpeedPxPerSec?: number
   thinkAutoExpand?: 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 +704,7 @@ export const TypewriterAssistantNodeView = memo(function TypewriterAssistantNode
             labels={markdownLabels}
             fileMentions={mentions}
             streaming={streaming}
+            motionReduced={reduced}
             ownFollow={!streaming && index === lastFollow}
             followSpeedCpsRef={index === lastFollow ? rootSpeedRef : undefined}
             followRevealedCharsRef={index === lastFollow ? rootRevealedCharsRef : undefined}
@@ -621,17 +718,19 @@ 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}
+              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,6 +157,7 @@ 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.debugEnabled === this.value.debugEnabled
       && next.debugTuning === this.value.debugTuning
@@ -270,6 +271,7 @@ export function apply(ctx: ClientContext): void {
       maxScrollSpeedPxPerSec: config.maxScrollSpeedPxPerSec,
       thinkAutoExpand: preferences.thinkAutoExpand,
       controlScroll: preferences.controlScroll,
+      motionPreference: preferences.motionPreference,
     })
   }
   ctx.slots.inject('conversation.chat.node', () => {

package/src/client/locales.ts

@@ -8,6 +8,10 @@ export type SmoothStreamLocaleKey =
   | 'title' | 'description'
   | 'enabled' | 'enabledHint'
   | 'controlScroll' | 'controlScrollHint'
+  | 'motionPreference' | 'motionPreferenceHint'
+  | 'motionAuto' | 'motionAutoHint'
+  | 'motionForceSmooth' | 'motionForceSmoothHint'
+  | 'motionForceReduced' | 'motionForceReducedHint'
   | 'thinkAutoExpand' | 'thinkAutoExpandHint'
   | 'debugEnabled' | 'debugEnabledHint' | 'debugUnavailable'
   | 'debugPanelTitle' | 'debugPanelToggle' | 'debugPanelClose' | 'debugGuide'
@@ -37,6 +41,14 @@ 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',
   thinkAutoExpandHint: 'Open the thinking block while it streams. Turn off to keep it collapsed.',
   debugEnabled: 'Show render diagnostics',
@@ -117,6 +129,14 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: '由本插件渲染并跟随流式回复；关闭后使用 Harness 内置渲染。',
   controlScroll: '接管滚动',
   controlScrollHint: '默认开启，由丝滑流式写入会话滚动位置；关闭后贴底滚动交给 Harness。',
+  motionPreference: '动效偏好',
+  motionPreferenceHint: '流式渲染如何响应系统的「减少动态效果」设置。',
+  motionAuto: '跟随系统',
+  motionAutoHint: '系统开启减少动态效果时直接呈现原始文本（优先无障碍）。',
+  motionForceSmooth: '始终平滑',
+  motionForceSmoothHint: '即使系统要求减少动态效果，仍保持平滑流式渲染。',
+  motionForceReduced: '始终原始',
+  motionForceReducedHint: '即使系统允许动效，也直接呈现原始文本。',
   thinkAutoExpand: '自动展开思考',
   thinkAutoExpandHint: '思考块在流式时自动展开；关闭后保持折叠，可手动展开。',
   debugEnabled: '显示渲染调试面板',

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,6 +24,7 @@ export interface SmoothStreamCardState {
   failed: boolean
   enabled: boolean
   controlScroll: boolean
+  motionPreference: StreamMotionPreference
   thinkAutoExpand: boolean
   debugEnabled: boolean
   debugTuning: StreamDebugTuning
@@ -52,7 +54,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'> | undefined
   private stagedDebug: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'> | undefined
   private saving = false
   private failed = false
@@ -90,11 +92,12 @@ 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) {
           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 }),
           }
         }
@@ -140,10 +143,11 @@ export class SmoothStreamCardController {
     }
   }
 
-  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'thinkAutoExpand'> {
+  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand'> {
     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,
     }
   }

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

@@ -24,6 +24,7 @@ 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'
     || typeof data.canUpgrade !== 'boolean') {
     throw new Error('dsh-smooth-stream: malformed settings response')
@@ -68,7 +69,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'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView>
   readDebug(): Promise<StreamDebugSettingsView>
   writeDebug(settings: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>): Promise<StreamDebugSettingsView>
   upgrade(): Promise<StreamUpgradeView>
@@ -80,13 +81,14 @@ 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'> & 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,
           ...(settings.debugEnabled === undefined || settings.debugTuning === undefined
             ? {}

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
+  }
+}

package/src/plugin.ts

@@ -56,6 +56,11 @@ export const Config: Schema<Config> = Schema.object({
 export const StreamSettingsSchema: Schema<StreamSettings> = Schema.object({
   enabled: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.enabled),
   controlScroll: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.controlScroll),
+  motionPreference: Schema.union([
+    Schema.const('auto'),
+    Schema.const('force-smooth'),
+    Schema.const('force-reduced'),
+  ] as const).default(DEFAULT_STREAM_SETTINGS.motionPreference),
   thinkAutoExpand: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.thinkAutoExpand),
   debugEnabled: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.debugEnabled),
   debugTuning: Schema.object({
@@ -118,6 +123,7 @@ export function apply(ctx: Context, config: Config): void {
           writable: connectionCtx.settings.writable,
           enabled: settings.enabled,
           controlScroll: settings.controlScroll,
+          motionPreference: settings.motionPreference,
           thinkAutoExpand: settings.thinkAutoExpand,
           canUpgrade: installation.kind === 'npm',
         }
@@ -185,10 +191,26 @@ export function apply(ctx: Context, config: Config): void {
             const next = payload as {
               enabled: boolean
               controlScroll: boolean
+              motionPreference?: unknown
               thinkAutoExpand: boolean
               debugEnabled?: unknown
               debugTuning?: unknown
             }
+            if (
+              next.motionPreference !== undefined
+              && next.motionPreference !== 'auto'
+              && next.motionPreference !== 'force-smooth'
+              && next.motionPreference !== 'force-reduced'
+            ) {
+              return {
+                ok: false,
+                error: {
+                  code: 'settings-rejected',
+                  message: 'motionPreference must be one of auto | force-smooth | force-reduced',
+                  details: { ns: STREAM_SETTINGS_NS },
+                },
+              }
+            }
             const hasDebug = next.debugEnabled !== undefined || next.debugTuning !== undefined
             if (hasDebug && (typeof next.debugEnabled !== 'boolean' || !validDebugTuning(next.debugTuning))) {
               return {
@@ -203,6 +225,7 @@ export function apply(ctx: Context, config: Config): void {
             await scope.update({
               enabled: next.enabled,
               controlScroll: next.controlScroll,
+              ...(next.motionPreference === undefined ? {} : { motionPreference: next.motionPreference }),
               thinkAutoExpand: next.thinkAutoExpand,
               ...(hasDebug ? { debugEnabled: next.debugEnabled, debugTuning: next.debugTuning } : {}),
             })

package/src/settings-api.ts

@@ -27,6 +27,8 @@ export interface StreamSettingsView {
   enabled: boolean
   /** Whether smooth-stream also owns conversation bottom-follow. */
   controlScroll: boolean
+  /** How the reveal honors the OS reduced-motion preference. */
+  motionPreference: import('./settings.ts').StreamMotionPreference
   /** Current resolved preference. */
   thinkAutoExpand: boolean
   /** Whether a fixed npm update command is safe to offer. */

package/src/settings.ts

@@ -45,6 +45,18 @@ export const DEFAULT_STREAM_DEBUG_TUNING: StreamDebugTuning = {
   backpressureMinScale: 0.55,
 }
 
+/**
+ * How the typewriter reveal responds to the OS reduced-motion preference.
+ * Credit: three-state design proposed by @Zn-Dk in #21/#22.
+ */
+export type StreamMotionPreference =
+  /** Follow the OS preference: reduced-motion users get raw text (accessibility first). */
+  | 'auto'
+  /** Always run the smoothing engine, ignoring the OS preference. */
+  | 'force-smooth'
+  /** Always render raw text, ignoring the OS preference. */
+  | 'force-reduced'
+
 /**
  * Preferences a user may set. Deliberately separate from {@link StreamConfig}
  * because the two change at different times: composition-time values go
@@ -61,6 +73,13 @@ export interface StreamSettings {
    * scroll ownership to the Harness; text reveal still runs.
    */
   controlScroll: boolean
+  /**
+   * How the reveal honors the OS reduced-motion preference. `auto` preserves
+   * the accessibility-first default; `force-smooth` keeps the engine on
+   * machines where a system-wide reduce-motion switch (performance tooling,
+   * RDP sessions, forced browser flags) would otherwise bypass it silently.
+   */
+  motionPreference: StreamMotionPreference
   /**
    * Whether a reasoning ("Think") block auto-expands while it is the
    * streaming tail. Off keeps the block collapsed — the user can still open
@@ -77,6 +96,7 @@ export interface StreamSettings {
 export const DEFAULT_STREAM_SETTINGS: StreamSettings = {
   enabled: true,
   controlScroll: true,
+  motionPreference: 'auto',
   thinkAutoExpand: true,
   debugEnabled: false,
   debugTuning: DEFAULT_STREAM_DEBUG_TUNING,