@dsh-plugin/dsh-ui-experience 1.0.0-dev.43491051069 → 1.0.0-dev.43492311898

package/README.md

@@ -141,6 +141,26 @@ M3 那侧的分离要说明白：Material 3 的 `emphasized` 整体是两段首
 - 无需随 DSH 更新维护：新增或改名的组件自动被覆盖。
 - 精确还原：写入前整块记录 `cssText`，关闭时原样写回；若期间被第三方改过则在日志中说明后仍然还原。
 
+### 滚动
+
+`scroll-behavior: smooth` 与脚本调用的 `scrollTo({behavior:'smooth'})` 都不受 CSS 曲线控制——时长和曲线由浏览器定，CSS 读不到，JS 也拿不到。勾选「滚动使用同一曲线」后，本层接管 `Element.prototype` 的 `scrollTo` / `scrollBy` / `scrollIntoView`，用脚本滚动实现同一套曲线。
+
+三条固定的规则，且不可配置：
+
+1. **读者一动就交还原生。** 滚轮、触摸、滚动按键直接取消脚本动画，不混合、不恢复。任何本层没写过的位置变化（拖滚动条、辅助技术滚动、容器在动画中重排）也会在下一帧取消。`pointerdown` 不在此列：页面上任何一次点击都取消，会让「输出还在滚动时点一下按钮」把跟随掐断，而原生平滑滚动不会。
+2. **用效果曲线，不用位移曲线。** 位移曲线带过冲，滚动时过冲意味着内容冲过目标位置再退回来，终点错两次。曲线族照样生效，带过冲的那半永远不用于滚动。
+3. **时长按距离增长。** 240px 以内固定 180ms，之后每像素加 0.2ms，封顶 460ms，再乘时长倍率。滚动的手感预期和元素过渡不同：读者对「滚了多远、停在哪」有精确期待，长距离用固定时长会显得急促。
+
+`scrollIntoView` 的终点由对齐方式、`scroll-margin`、嵌套容器和元素自身盒模型共同决定，自己算就是「滚到错的那一行」的来源。这里的做法是：先向浏览器要一次瞬时跳转，读出每个被移动容器的落点，把它们全部放回原位，再动画到读到的落点。跳转与还原在同一个任务内完成，中间位置不会绘制。
+
+`scrollend` 交给浏览器：逐帧赋值 `scrollTop` 是一串瞬时滚动，浏览器自己的滚动结束检测会在最后一帧落下后触发一次，依赖它结算状态的消费方（聊天记录的跟随控制器）看到的序列与原生平滑滚动一致。
+
+### 滚动驱动动画不动
+
+`scroll-timeline` / `animation-timeline` 驱动的动画，进度来自滚动容器而不是时钟。这类动画的 `animation-timing-function` 不是「一条随时间推进的曲线」，而是把滚动位置映射到迭代进度——给它套缓动，等于让遮罩在滚动前段就淡完然后定住，改的是效果本身而非手感。因此只要某条规则的 `animation-timeline` 不是 `auto` / `none`，本层就整条跳过。
+
+DSH 目前只有一处用到（提问卡片标题的溢出遮罩 `--question-copy`）。
+
 ### 关键帧感知
 
 动画该用哪条曲线，取决于它的 `@keyframes` 到底在动什么。扫描时先建立「关键帧名 → 它改动的属性集合」，再据此判定：同时含 `transform` 的是位移，纯 `opacity` 的是效果。查不到名字（定义在跨源样式表里）时按效果处理。
@@ -184,6 +204,9 @@ M3 那侧的分离要说明白：Material 3 的 `emphasized` 整体是两段首
 - M3 动效的「位移 / 效果」判定依据属性名与关键帧内容，不分析属性的实际取值变化；判定不出来的情况（例如只由 `all` 声明的过渡）按效果处理，宁可不给过冲。
 - 跨源样式表里的规则无法改写，只会在日志中记录。
 - 本层只改写曲线与时长，不新增、不改写关键帧本身；DSH 没定义的动效不会因此出现。
+- CSS 的 `scroll-behavior: smooth`（全仓一处，dock 标签条）不是 transition/animation，本层不碰；只有减弱动效时随压制表置为 `auto`。
+- 脚本滚动由「滚动使用同一曲线」单独控制，与曲线族无关（关掉曲线族就一并停止接管）。
+- 滚动驱动动画（`animation-timeline`）不属于时间轴动画，本层显式跳过，见上一节。
 - 浏览器半在刷新页面时重载，宿主半只在进程重启时重载。两者版本不一致时（刚升级插件但没重启 DSH），M3 动效行会保持无操作并在控制台记录一行原因，配色功能不受影响。
 
 ## 样式基线

package/lib/client.js

@@ -11,7 +11,8 @@
     durationScale: 1,
     spatialSplit: true,
     quantize: false,
-    reduced: "system"
+    reduced: "system",
+    scroll: true
   };
 
   // src/motion-plan.ts
@@ -77,11 +78,36 @@
     "border-bottom-left-radius",
     "border-bottom-right-radius"
   ]);
-  var CURVE_M3_SPATIAL = "cubic-bezier(0.05, 0.7, 0.1, 1)";
-  var CURVE_M3_EFFECTS = "cubic-bezier(0.2, 0, 0, 1)";
-  var CURVE_M3E_SPATIAL_FAST = "cubic-bezier(0.42, 1.67, 0.21, 0.9)";
-  var CURVE_M3E_SPATIAL = "cubic-bezier(0.38, 1.21, 0.22, 1)";
-  var CURVE_M3E_EFFECTS = "cubic-bezier(0.34, 0.8, 0.34, 1)";
+  var POINTS_M3_SPATIAL = [0.05, 0.7, 0.1, 1];
+  var POINTS_M3_EFFECTS = [0.2, 0, 0, 1];
+  var POINTS_M3E_SPATIAL_FAST = [0.42, 1.67, 0.21, 0.9];
+  var POINTS_M3E_SPATIAL = [0.38, 1.21, 0.22, 1];
+  var POINTS_M3E_EFFECTS = [0.34, 0.8, 0.34, 1];
+  var CURVE_M3_SPATIAL = `cubic-bezier(${POINTS_M3_SPATIAL.join(", ")})`;
+  var CURVE_M3_EFFECTS = `cubic-bezier(${POINTS_M3_EFFECTS.join(", ")})`;
+  var CURVE_M3E_SPATIAL_FAST = `cubic-bezier(${POINTS_M3E_SPATIAL_FAST.join(", ")})`;
+  var CURVE_M3E_SPATIAL = `cubic-bezier(${POINTS_M3E_SPATIAL.join(", ")})`;
+  var CURVE_M3E_EFFECTS = `cubic-bezier(${POINTS_M3E_EFFECTS.join(", ")})`;
+  function effectCurvePoints(mode) {
+    return mode === "m3" ? POINTS_M3_EFFECTS : POINTS_M3E_EFFECTS;
+  }
+  function easeCurve(points, x) {
+    const [x1, y1, x2, y2] = points;
+    const clamped = Math.min(1, Math.max(0, x));
+    let low = 0;
+    let high = 1;
+    let t = clamped;
+    for (let step = 0; step < 24; step += 1) {
+      const inverse2 = 1 - t;
+      const value = 3 * inverse2 * inverse2 * t * x1 + 3 * inverse2 * t * t * x2 + t * t * t;
+      if (Math.abs(value - clamped) < 1e-5) break;
+      if (value < clamped) low = t;
+      else high = t;
+      t = (low + high) / 2;
+    }
+    const inverse = 1 - t;
+    return 3 * inverse * inverse * t * y1 + 3 * inverse * t * t * y2 + t * t * t;
+  }
   var FAST_SPATIAL_MAX_MS = 200;
   var MATERIAL_DURATIONS_MS = [
     50,
@@ -186,7 +212,8 @@
     selector: "animation-name",
     duration: "animation-duration",
     timing: "animation-timing-function",
-    iterations: "animation-iteration-count"
+    iterations: "animation-iteration-count",
+    timeline: "animation-timeline"
   };
   var DURATION_TOKENS = [
     "--ds-transition-duration",
@@ -256,8 +283,9 @@
       const durations = splitList(declaration.getPropertyValue(family.duration));
       const timings = splitList(declaration.getPropertyValue(family.timing));
       const iterations = family.iterations === void 0 ? [] : splitList(declaration.getPropertyValue(family.iterations));
+      const timelines = family.timeline === void 0 ? [] : splitList(declaration.getPropertyValue(family.timeline));
       if (selectors.length === 0 && durations.length === 0 && timings.length === 0) return false;
-      const count = Math.max(selectors.length, durations.length, timings.length, 1);
+      const count = Math.max(selectors.length, durations.length, timings.length, timelines.length, 1);
       const nextTimings = [];
       const nextDurations = [];
       let timingChanged = false;
@@ -268,7 +296,9 @@
         const originalDuration = entryAt(durations, index);
         const originalMs = originalDuration === void 0 ? void 0 : parseDurationMs(originalDuration);
         const infinite = entryAt(iterations, index) === "infinite";
-        if (selector === "none") {
+        const timeline = entryAt(timelines, index);
+        const scrollDriven = timeline !== void 0 && timeline !== "auto" && timeline !== "none";
+        if (selector === "none" || scrollDriven) {
           if (originalTiming !== void 0) nextTimings.push(originalTiming);
           if (originalDuration !== void 0) nextDurations.push(originalDuration);
           continue;
@@ -437,6 +467,217 @@
     };
   }
 
+  // src/scroll.ts
+  var MIN_MS = 180;
+  var MAX_MS = 460;
+  var FREE_PX = 240;
+  var GROWTH_MS_PER_PX = 0.2;
+  var SCROLL_KEYS = /* @__PURE__ */ new Set([
+    "ArrowUp",
+    "ArrowDown",
+    "ArrowLeft",
+    "ArrowRight",
+    "PageUp",
+    "PageDown",
+    "Home",
+    "End",
+    " "
+  ]);
+  var TAKEOVER_EVENTS = ["wheel", "touchstart", "keydown"];
+  function scrollDistance(legs) {
+    let distance = 0;
+    for (const leg of legs) {
+      distance = Math.max(distance, Math.abs(leg.toTop - leg.fromTop), Math.abs(leg.toLeft - leg.fromLeft));
+    }
+    return distance;
+  }
+  function scrollDurationMs(distance, settings) {
+    const grown = MIN_MS + Math.max(0, distance - FREE_PX) * GROWTH_MS_PER_PX;
+    return Math.min(MAX_MS, grown) * settings.durationScale;
+  }
+  function maxima(element) {
+    return {
+      top: Math.max(0, element.scrollHeight - element.clientHeight),
+      left: Math.max(0, element.scrollWidth - element.clientWidth)
+    };
+  }
+  function scrollable(element) {
+    const max = maxima(element);
+    return max.top > 0 || max.left > 0;
+  }
+  function containers(element) {
+    const out = [];
+    let node = element.parentElement;
+    while (node !== null) {
+      if (scrollable(node)) out.push(node);
+      node = node.parentElement;
+    }
+    return out;
+  }
+  function createScrollMotion() {
+    const shipped = {
+      scrollTo: Element.prototype.scrollTo,
+      scrollBy: Element.prototype.scrollBy,
+      scrollIntoView: Element.prototype.scrollIntoView
+    };
+    let settings;
+    let run;
+    let installed = false;
+    function cancel() {
+      if (run === void 0) return;
+      window.cancelAnimationFrame(run.frame);
+      run = void 0;
+    }
+    function step(now) {
+      const active = run;
+      if (active === void 0) return;
+      const elapsed = now - active.started;
+      const progress = active.duration <= 0 ? 1 : Math.min(1, elapsed / active.duration);
+      const eased = easeCurve(effectCurvePoints(settings?.mode ?? "m3e"), progress);
+      for (let index = 0; index < active.legs.length; index += 1) {
+        const leg = active.legs[index];
+        const written = active.written[index];
+        if (leg === void 0 || written === void 0) continue;
+        if (Math.abs(leg.element.scrollTop - written.top) > 1 || Math.abs(leg.element.scrollLeft - written.left) > 1) {
+          cancel();
+          return;
+        }
+        const top = progress >= 1 ? leg.toTop : leg.fromTop + (leg.toTop - leg.fromTop) * eased;
+        const left = progress >= 1 ? leg.toLeft : leg.fromLeft + (leg.toLeft - leg.fromLeft) * eased;
+        if (leg.element.scrollTop !== top) leg.element.scrollTop = top;
+        if (leg.element.scrollLeft !== left) leg.element.scrollLeft = left;
+        written.top = leg.element.scrollTop;
+        written.left = leg.element.scrollLeft;
+      }
+      if (progress >= 1) {
+        run = void 0;
+        return;
+      }
+      active.frame = window.requestAnimationFrame(step);
+    }
+    function start(legs) {
+      cancel();
+      const active = settings;
+      if (active === void 0) return;
+      run = {
+        legs,
+        started: performance.now(),
+        duration: scrollDurationMs(scrollDistance(legs), active),
+        written: legs.map((leg) => ({ top: leg.element.scrollTop, left: leg.element.scrollLeft })),
+        frame: window.requestAnimationFrame(step)
+      };
+    }
+    function defer(behavior) {
+      if (settings === void 0) return true;
+      if (behavior !== "smooth") return true;
+      return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    }
+    function legsFor(element, top, left) {
+      const max = maxima(element);
+      const toTop = top === void 0 ? element.scrollTop : Math.min(max.top, Math.max(0, top));
+      const toLeft = left === void 0 ? element.scrollLeft : Math.min(max.left, Math.max(0, left));
+      if (Math.abs(toTop - element.scrollTop) < 1 && Math.abs(toLeft - element.scrollLeft) < 1) return void 0;
+      return [{ element, fromTop: element.scrollTop, fromLeft: element.scrollLeft, toTop, toLeft }];
+    }
+    function readOffsets(options, y, base) {
+      if (typeof options === "number") {
+        return { left: base.left + options, top: y === void 0 ? void 0 : base.top + y };
+      }
+      if (options === void 0 || options === null) return { top: void 0, left: void 0 };
+      return {
+        left: options.left === void 0 ? void 0 : base.left + options.left,
+        top: options.top === void 0 ? void 0 : base.top + options.top
+      };
+    }
+    function patchedScrollTo(options, y) {
+      const behavior = typeof options === "object" && options !== null ? options.behavior : void 0;
+      if (defer(behavior)) {
+        ;
+        shipped.scrollTo.call(this, options, y);
+        return;
+      }
+      const request = readOffsets(options, y, { top: 0, left: 0 });
+      const legs = legsFor(this, request.top, request.left);
+      if (legs !== void 0) start(legs);
+    }
+    function patchedScrollBy(options, y) {
+      const behavior = typeof options === "object" && options !== null ? options.behavior : void 0;
+      if (defer(behavior)) {
+        ;
+        shipped.scrollBy.call(this, options, y);
+        return;
+      }
+      const request = readOffsets(options, y, { top: this.scrollTop, left: this.scrollLeft });
+      const legs = legsFor(this, request.top, request.left);
+      if (legs !== void 0) start(legs);
+    }
+    function patchedScrollIntoView(options) {
+      const behavior = typeof options === "object" && options !== null ? options.behavior : void 0;
+      if (defer(behavior)) {
+        ;
+        shipped.scrollIntoView.call(this, options);
+        return;
+      }
+      const instant = { ...typeof options === "object" && options !== null ? options : {}, behavior: "instant" };
+      const tracked = containers(this);
+      const before = tracked.map((element) => ({ top: element.scrollTop, left: element.scrollLeft }));
+      shipped.scrollIntoView.call(this, instant);
+      const legs = [];
+      for (let index = 0; index < tracked.length; index += 1) {
+        const element = tracked[index];
+        const origin = before[index];
+        if (element === void 0 || origin === void 0) continue;
+        const landed = { top: element.scrollTop, left: element.scrollLeft };
+        element.scrollTop = origin.top;
+        element.scrollLeft = origin.left;
+        if (Math.abs(landed.top - origin.top) < 1 && Math.abs(landed.left - origin.left) < 1) continue;
+        legs.push({ element, fromTop: origin.top, fromLeft: origin.left, toTop: landed.top, toLeft: landed.left });
+      }
+      if (legs.length > 0) start(legs);
+    }
+    function onTakeover(event) {
+      if (run === void 0) return;
+      if (event.type !== "keydown") {
+        cancel();
+        return;
+      }
+      if (event.key !== void 0 && SCROLL_KEYS.has(event.key)) cancel();
+    }
+    function install() {
+      if (installed) return;
+      installed = true;
+      const prototype = Element.prototype;
+      prototype.scrollTo = patchedScrollTo;
+      prototype.scrollBy = patchedScrollBy;
+      prototype.scrollIntoView = patchedScrollIntoView;
+      for (const kind of TAKEOVER_EVENTS) {
+        window.addEventListener(kind, onTakeover, true);
+      }
+    }
+    function uninstall() {
+      cancel();
+      if (!installed) return;
+      installed = false;
+      const prototype = Element.prototype;
+      prototype.scrollTo = shipped.scrollTo;
+      prototype.scrollBy = shipped.scrollBy;
+      prototype.scrollIntoView = shipped.scrollIntoView;
+      for (const kind of TAKEOVER_EVENTS) {
+        window.removeEventListener(kind, onTakeover, true);
+      }
+    }
+    return {
+      apply(next) {
+        uninstall();
+        settings = next;
+        if (!next.scroll || next.mode === "off") return;
+        if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return;
+        install();
+      },
+      restore: uninstall
+    };
+  }
+
   // src/styles.ts
   var ROW_CSS = `
 /* Row chrome: AppearanceRow.module.css .group \u2014 16/0 padding, hairline
@@ -618,6 +859,8 @@
       "motion.spatial-split-hint": "\u4F4D\u79FB\u66F2\u7EBF\u5E26\u8FC7\u51B2\uFF08\u5FEB\u4F4D\u79FB\u7EA6 9%\uFF0C\u9ED8\u8BA4\u4F4D\u79FB\u7EA6 1.4%\uFF09\uFF0C\u6548\u679C\u66F2\u7EBF\u6CA1\u6709\u3002\u5173\u95ED\u540E\u5168\u90E8\u4F7F\u7528\u6548\u679C\u66F2\u7EBF\u3002",
       "motion.quantize": "\u65F6\u957F\u5BF9\u9F50\u5230 Material \u6863\u4F4D",
       "motion.quantize-hint": "\u628A\u6539\u5199\u540E\u7684\u65F6\u957F\u5438\u9644\u5230 50/100/150/200/250/300/350/400/450/500/550/600/700/800/900/1000ms\u3002",
+      "motion.scroll": "\u6EDA\u52A8\u4F7F\u7528\u540C\u4E00\u66F2\u7EBF",
+      "motion.scroll-hint": "\u63A5\u7BA1\u811A\u672C\u8C03\u7528\u7684\u5E73\u6ED1\u6EDA\u52A8\uFF08\u804A\u5929\u8DDF\u968F\u3001\u8F68\u8FF9\u5B9A\u4F4D\u3001\u5361\u7247\u5C45\u4E2D\uFF09\uFF0C\u6539\u7528\u672C\u9875\u66F2\u7EBF\u3002\u8BFB\u8005\u4E00\u65E6\u6EDA\u8F6E\u3001\u89E6\u6478\u6216\u6309\u952E\uFF0C\u811A\u672C\u6EDA\u52A8\u7ACB\u5373\u505C\u6B62\u5E76\u4EA4\u8FD8\u539F\u751F\u63A7\u5236\u3002",
       "motion.reduced": "\u59CB\u7EC8\u51CF\u5F31\u52A8\u6548",
       "motion.reduced-hint": "\u5F00\u542F\u540E\u5FFD\u7565\u7CFB\u7EDF\u7684\u300C\u51CF\u5F31\u52A8\u6001\u6548\u679C\u300D\u504F\u597D\uFF0C\u4E00\u5F8B\u628A\u65F6\u957F\u538B\u5230 1ms\u3002\u5173\u95ED\u65F6\u8DDF\u968F\u7CFB\u7EDF\u3002",
       "motion.system-reduced": "\u7CFB\u7EDF\u5DF2\u8BF7\u6C42\u51CF\u5F31\u52A8\u6548\uFF0C\u672C\u9875\u52A8\u753B\u6B63\u5728\u88AB\u538B\u5236\u3002",
@@ -648,6 +891,8 @@
       "motion.spatial-split-hint": "The spatial curves overshoot (about 9% for the fast one, 1.4% for the default); the effects curve does not. Turning this off uses the effects curve everywhere.",
       "motion.quantize": "Snap durations to the Material ladder",
       "motion.quantize-hint": "Pull rewritten durations onto 50/100/150/200/250/300/350/400/450/500/550/600/700/800/900/1000 ms.",
+      "motion.scroll": "Scroll on the same curve",
+      "motion.scroll-hint": "Take over scripted smooth scrolling \u2014 chat follow, trajectory locate, card centring \u2014 and drive it on this page's curve. Any wheel, touch, or scroll key stops the scripted motion at once and hands control back to the browser.",
       "motion.reduced": "Always reduce motion",
       "motion.reduced-hint": "Ignore the system reduce-motion preference and force every duration to 1 ms. Off follows the system.",
       "motion.system-reduced": "The system asked for reduced motion; this page is being held still.",
@@ -696,6 +941,7 @@
           };
           const listeners = /* @__PURE__ */ new Set();
           const motion = createMotion();
+          const scrolling = createScrollMotion();
           const publish = (patch) => {
             view = { ...view, ...patch };
             for (const listener of listeners) listener();
@@ -711,8 +957,9 @@
           const applyMotion = (next) => {
             if (disposed) return;
             motion.apply(next);
+            scrolling.apply(next);
           };
-          const motionDiffers = (left, right) => left.mode !== right.mode || left.durationScale !== right.durationScale || left.spatialSplit !== right.spatialSplit || left.quantize !== right.quantize || left.reduced !== right.reduced;
+          const motionDiffers = (left, right) => left.mode !== right.mode || left.durationScale !== right.durationScale || left.spatialSplit !== right.spatialSplit || left.quantize !== right.quantize || left.reduced !== right.reduced || left.scroll !== right.scroll;
           const clearOverride = () => {
             disposeOverride?.();
             disposeOverride = void 0;
@@ -1159,6 +1406,15 @@
                 tr("motion.quantize-hint"),
                 locked
               ),
+              checkbox(
+                current.scroll,
+                (next) => {
+                  void saveMotion({ scroll: next });
+                },
+                tr("motion.scroll"),
+                tr("motion.scroll-hint"),
+                locked
+              ),
               checkbox(
                 current.reduced === "always",
                 (next) => {
@@ -1241,6 +1497,7 @@
               disposed = true;
               teardown();
               motion.restore();
+              scrolling.restore();
             };
           }, "ui-experience: page-level layers");
           void poll();

package/lib/index.js

@@ -39,7 +39,8 @@ var Config = z.object({
   motionDurationScale: z.number().min(0.5).max(2).default(1).volatile(),
   motionSpatialSplit: z.boolean().default(true).volatile(),
   motionQuantize: z.boolean().default(false).volatile(),
-  motionReduced: z.string().pattern(MOTION_REDUCED).default("system").volatile()
+  motionReduced: z.string().pattern(MOTION_REDUCED).default("system").volatile(),
+  motionScroll: z.boolean().default(true).volatile()
 });
 var REQUIRED_COLOR_KEYS = [
   "surface_container_lowest",
@@ -319,7 +320,8 @@ function effectiveMotion(config) {
     durationScale: config.motionDurationScale.get(),
     spatialSplit: config.motionSpatialSplit.get(),
     quantize: config.motionQuantize.get(),
-    reduced: config.motionReduced.get()
+    reduced: config.motionReduced.get(),
+    scroll: config.motionScroll.get()
   };
 }
 var paletteCache;
@@ -570,7 +572,8 @@ var UiExperienceService = class extends TypertRemoteService {
     const scale = args?.durationScale;
     const spatialSplit = args?.spatialSplit;
     const quantize = args?.quantize;
-    if (mode === void 0 && reduced === void 0 && scale === void 0 && spatialSplit === void 0 && quantize === void 0) {
+    const scroll = args?.scroll;
+    if (mode === void 0 && reduced === void 0 && scale === void 0 && spatialSplit === void 0 && quantize === void 0 && scroll === void 0) {
       throw new Error("ui-experience: setMotion requires at least one field");
     }
     if (mode !== void 0 && !MOTION_MODE.test(mode)) {
@@ -588,16 +591,20 @@ var UiExperienceService = class extends TypertRemoteService {
     if (quantize !== void 0 && typeof quantize !== "boolean") {
       throw new Error(`ui-experience: quantize must be a boolean, got ${typeof quantize}`);
     }
+    if (scroll !== void 0 && typeof scroll !== "boolean") {
+      throw new Error(`ui-experience: scroll must be a boolean, got ${typeof scroll}`);
+    }
     await this.persist((current) => ({
       ...current,
       ...mode === void 0 ? {} : { motion: mode },
       ...reduced === void 0 ? {} : { motionReduced: reduced },
       ...scale === void 0 ? {} : { motionDurationScale: scale },
       ...spatialSplit === void 0 ? {} : { motionSpatialSplit: spatialSplit },
-      ...quantize === void 0 ? {} : { motionQuantize: quantize }
+      ...quantize === void 0 ? {} : { motionQuantize: quantize },
+      ...scroll === void 0 ? {} : { motionScroll: scroll }
     }));
     const applied = effectiveMotion(this.config);
-    logLine(`setMotion: mode=${applied.mode} durationScale=${String(applied.durationScale)} spatialSplit=${String(applied.spatialSplit)} quantize=${String(applied.quantize)} reduced=${applied.reduced}`);
+    logLine(`setMotion: mode=${applied.mode} durationScale=${String(applied.durationScale)} spatialSplit=${String(applied.spatialSplit)} quantize=${String(applied.quantize)} reduced=${applied.reduced} scroll=${String(applied.scroll)}`);
     return applied;
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugin/dsh-ui-experience",
-  "version": "1.0.0-dev.43491051069",
+  "version": "1.0.0-dev.43492311898",
   "type": "module",
   "description": "UI experience enhancements for DeepSeek Harness: follow the system matugen Material You palette as the interface theme, and rewrite interface motion onto Material 3 / Material 3 Expressive curves.",
   "license": "MIT",