dsh-smooth-stream 0.4.3 → 0.6.0

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

@@ -55,8 +55,13 @@ 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),
-  autoCollapse: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.autoCollapse),
   debugEnabled: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.debugEnabled),
   debugTuning: Schema.object({
     revealScale: Schema.number().min(0.25).max(2).default(DEFAULT_STREAM_SETTINGS.debugTuning.revealScale),
@@ -117,8 +122,9 @@ export function apply(ctx: Context, config: Config): void {
           installation: installation.kind,
           writable: connectionCtx.settings.writable,
           enabled: settings.enabled,
+          controlScroll: settings.controlScroll,
+          motionPreference: settings.motionPreference,
           thinkAutoExpand: settings.thinkAutoExpand,
-          autoCollapse: settings.autoCollapse,
           canUpgrade: installation.kind === 'npm',
         }
       }
@@ -159,13 +165,14 @@ export function apply(ctx: Context, config: Config): void {
         if (endpoint === STREAM_SETTINGS_RPC.write) {
           if (typeof payload !== 'object' || payload === null || Array.isArray(payload)
             || typeof (payload as { enabled?: unknown }).enabled !== 'boolean'
+            || typeof (payload as { controlScroll?: unknown }).controlScroll !== 'boolean'
             || typeof (payload as { thinkAutoExpand?: unknown }).thinkAutoExpand !== 'boolean'
-            || typeof (payload as { autoCollapse?: unknown }).autoCollapse !== 'boolean') {
+          ) {
             return {
               ok: false,
               error: {
                 code: 'settings-rejected',
-                message: 'enabled, thinkAutoExpand and autoCollapse must be booleans',
+                message: 'enabled, controlScroll and thinkAutoExpand must be booleans',
                 details: { ns: STREAM_SETTINGS_NS },
               },
             }
@@ -183,11 +190,27 @@ export function apply(ctx: Context, config: Config): void {
           try {
             const next = payload as {
               enabled: boolean
+              controlScroll: boolean
+              motionPreference?: unknown
               thinkAutoExpand: boolean
-              autoCollapse: 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 {
@@ -201,8 +224,9 @@ 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,
-              autoCollapse: next.autoCollapse,
               ...(hasDebug ? { debugEnabled: next.debugEnabled, debugTuning: next.debugTuning } : {}),
             })
           } catch {

package/src/settings-api.ts

@@ -25,10 +25,12 @@ export interface StreamSettingsView {
   writable: boolean
   /** Whether smooth-stream currently owns conversation rendering. */
   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 finished turns fold their work process behind a summary row. */
-  autoCollapse: boolean
   /** Whether a fixed npm update command is safe to offer. */
   canUpgrade: boolean
 }

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
@@ -56,19 +68,24 @@ export interface StreamSettings {
    * Off returns all rendering ownership to the built-in UI.
    */
   enabled: boolean
+  /**
+   * Whether this plugin also takes over conversation bottom-follow. Off leaves
+   * 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
    * it by hand — and stops the running state from re-owning the disclosure.
    */
   thinkAutoExpand: boolean
-  /**
-   * Whether a finished turn folds its work process (thinking, tool calls,
-   * context injection, intermediate replies) behind one "已处理" summary row,
-   * leaving only the final answer visible. The summary row can always be
-   * toggled by hand, and turns still expand live while they stream.
-   */
-  autoCollapse: boolean
   /** Whether the live renderer diagnostics panel is enabled. */
   debugEnabled: boolean
   /** Values edited by the diagnostics panel. */
@@ -78,8 +95,9 @@ export interface StreamSettings {
 /** Defaults shared by the Host schema and the client-side fallback. */
 export const DEFAULT_STREAM_SETTINGS: StreamSettings = {
   enabled: true,
+  controlScroll: true,
+  motionPreference: 'auto',
   thinkAutoExpand: true,
-  autoCollapse: true,
   debugEnabled: false,
   debugTuning: DEFAULT_STREAM_DEBUG_TUNING,
 }