wallpaper-engine-dsh 2.1.0 → 2.1.1

package/README.md

@@ -10,7 +10,7 @@ A DSH bundle that turns your local **Wallpaper Engine** library into the live ba
 
 **Legibility on any wallpaper.** Text stays readable by construction, not by luck. The veil always opposes the text colour — black in the dark theme, white in the light theme — so neither a pitch-black nor a pure-white wallpaper can swallow the UI. On top of that, a Smart veil samples the wallpaper's brightness every few seconds and automatically strengthens the veil when a scene drifts too bright (or too dark) for the current theme (web wallpapers' pixels are unreadable inside the sandbox, so their preview still stands in as the sample). While a wallpaper is active, dropdown menus, the slash-command popup, the queue-dock panel, the settings dialog, and the image lightbox all render as frosted glass: the shell's own menu primitive carries an isolation property that silently kills its internal blur layer, so the plugin applies the blur on the surface element itself and deepens the menu fill, keeping overlay text readable over any wallpaper. Everything reverts to the host look when the wallpaper is off.
 
-**Manual framing.** Pick a base layout — Cover, Contain, Stretch, Original, or Free — then frame the shot yourself. **Adjust** opens the live wallpaper fullscreen: scroll to zoom, drag to pan. In the first four layouts the crop is clamped so the image always fills the screen with no exposed edges; **Free** places the wallpaper at natural size on a black canvas where it can be dragged anywhere, zoomed from 0.1× to 4×, and rotated to any angle (±90° buttons or Alt+drag), with just enough kept on screen that it can never be dragged out of sight. **Mirror** flips the wallpaper horizontally and works in every layout — a flip never exposes an edge. Esc or Done finishes, the framing persists, and **Reset crop** restores the default in one click. Web wallpapers take the same select and the same zoom/pan/rotate framing — the transform applies to the iframe directly.
+**Manual framing.** Pick a base layout — Cover, Contain, Stretch, Original, or Free — then frame the shot yourself. **Adjust** opens the live wallpaper fullscreen: scroll to zoom, drag to pan. In the seamless layouts the picture already fills the screen at 100% — zoom in with the wheel first and panning unlocks (the hint bar says so). In the first four layouts the crop is clamped so the image always fills the screen with no exposed edges; **Free** places the wallpaper at natural size on a black canvas where it can be dragged anywhere, zoomed from 0.1× to 4×, and rotated to any angle (±90° buttons or Alt+drag), with just enough kept on screen that it can never be dragged out of sight. **Mirror** flips the wallpaper horizontally and works in every layout — a flip never exposes an edge. Esc or Done finishes, the framing persists, and **Reset crop** restores the default in one click. Web wallpapers take the same select and the same zoom/pan/rotate framing — the transform applies to the iframe directly.
 
 **Four live sliders.** Wallpaper blur, Scrim, Borders, and Glass — every change lands instantly and persists. Blur renders in place: composition, layout, and crop stay identical at every blur level, and within one blur radius of the screen edge the picture fades softly into the veil beneath the UI chrome. A whisper of dither noise keeps smooth gradients band-free; at zero blur the media bypasses the filter pipeline entirely for bit-exact pixels. The Glass slider's colour melt is anchored to the shell's own menu material: at the 40px ceiling it reproduces the host recipe blur(40px) saturate(150%) exactly, so full glass reads as one system with the shell's native frost.
 

package/README.zh.md

@@ -10,7 +10,7 @@
 
 **任何壁纸上文字都可读。** 遮罩颜色始终与文字颜色相反:深色主题用黑色遮罩,浅色主题用白色遮罩,因此过亮或过暗的壁纸都不会盖住文字。在此基础上,「智能可视」每隔几秒采样一次壁纸亮度,亮度过高或过低时自动加强遮罩(网页壁纸的像素在沙箱中读不到,改用其预览图作为采样依据)。壁纸激活时,下拉菜单、斜杠命令提示框、队列面板、设置弹窗与图片灯箱统一为磨砂玻璃:外壳的菜单原语自身带隔离属性,其内部模糊层在宿主原样下并不生效,插件改为在 surface 元素上施加模糊,并把菜单底色加深,保证浮层文字在任意壁纸上可读;关闭壁纸后恢复宿主原样。
 
-**手动取景。** 先选基础排布(填充、适应、拉伸、原始、自由),再手动调整画面:点「调整画面」将壁纸全屏展开,滚轮缩放,拖动平移。前四种排布下裁剪范围经过限制,画面始终铺满屏幕,不露出边缘;「自由」把壁纸按原始大小放在黑色画布上,可拖动到任意位置,缩放范围 0.1–4×,并可旋转任意角度(±90° 按钮或 Alt+拖动),同时始终保留一小块在屏幕内,不会拖丢。「镜像」水平翻转壁纸,所有排布下都可用——翻转不会破坏铺满。按 Esc 或点「完成」退出,取景设置会保存,「重置裁剪」可一键恢复默认。网页壁纸使用相同的排布下拉与缩放/平移/旋转取景(变换直接作用于 iframe)。
+**手动取景。** 先选基础排布(填充、适应、拉伸、原始、自由),再手动调整画面:点「调整画面」将壁纸全屏展开,滚轮缩放,拖动平移。填充等无缝排布下,画面在 100% 倍率时已铺满屏幕,先滚轮放大后拖动平移才会生效(提示条会同步说明)。前四种排布下裁剪范围经过限制,画面始终铺满屏幕,不露出边缘;「自由」把壁纸按原始大小放在黑色画布上,可拖动到任意位置,缩放范围 0.1–4×,并可旋转任意角度(±90° 按钮或 Alt+拖动),同时始终保留一小块在屏幕内,不会拖丢。「镜像」水平翻转壁纸,所有排布下都可用——翻转不会破坏铺满。按 Esc 或点「完成」退出,取景设置会保存,「重置裁剪」可一键恢复默认。网页壁纸使用相同的排布下拉与缩放/平移/旋转取景(变换直接作用于 iframe)。
 
 **四个实时滑杆。** 壁纸模糊、暗化、边框、玻璃,每一步调节立即生效并保存。模糊在原位渲染:任意模糊度下,画面的比例、排布与取景完全一致;屏幕边缘一个模糊半径内的画面向遮罩过渡,被界面边饰覆盖,通常不可见。模糊时叠加轻微噪声,消除渐变色带;模糊为零时媒体完全绕过滤镜管线,像素保持不变。玻璃滑杆的「色彩熔融」在 40px 满档时正好等于外壳官方菜单材质的配方(blur(40px) saturate(150%)),满档玻璃与外壳原生磨砂观感一致。
 

package/lib/client.js

@@ -102,6 +102,7 @@ window.__ModuleLoader__.load({
 		    adjustDone: "完成",
 		    adjustHint: "拖动平移 · 滚轮缩放 · Esc 或点「完成」退出",
 		    adjustHintFree: "拖动平移 · 滚轮缩放 · Alt+拖动旋转 · Esc 或点「完成」退出",
+		    adjustHintZoom: "当前倍数下画面已铺满,先滚轮放大,即可拖动平移",
 		    mirror: "镜像",
 		    rotateCcw: "⟲",
 		    rotateCw: "⟳",
@@ -186,6 +187,7 @@ window.__ModuleLoader__.load({
 		    adjustDone: "Done",
 		    adjustHint: "Drag to pan · wheel to zoom · Esc or Done to exit",
 		    adjustHintFree: "Drag to pan · wheel to zoom · Alt+drag to rotate · Esc or Done to exit",
+		    adjustHintZoom: "The picture already fills the screen — zoom in with the wheel to unlock panning",
 		    mirror: "Mirror",
 		    rotateCcw: "⟲",
 		    rotateCw: "⟳",
@@ -829,7 +831,15 @@ window.__ModuleLoader__.load({
 		  bar.className = "webg-adjust-bar";
 		  const hint = document.createElement("span");
 		  hint.className = "webg-adjust-hint";
-		  hint.textContent = isFreeFit() ? S().adjustHintFree : S().adjustHint;
+		  const updateHint = () => {
+		    // Pan feedback: in the gap-free fits the pan headroom is (zoom-1)*50,
+		    // so at zoom 1 dragging is pinned BY DESIGN - say so instead of
+		    // leaving a silent no-op that reads as "pan is broken".
+		    hint.textContent = isFreeFit() ? S().adjustHintFree
+		      : selection.zoom > 1 ? S().adjustHint
+		      : S().adjustHintZoom;
+		  };
+		  updateHint();
 		  const done = document.createElement("button");
 		  done.type = "button";
 		  done.className = "webg-btn webg-btn--primary";
@@ -901,6 +911,7 @@ window.__ModuleLoader__.load({
 		    clampCrop(); // mode envelope: gap-free pan headroom, or free keep-visible
 		    drag = { x: e.clientX, y: e.clientY };
 		    applyEffects();
+		    updateHint();
 		  };
 		  const endPointer = () => {
 		    if (rot) { rot = null; persistSelection(); return; }
@@ -921,6 +932,7 @@ window.__ModuleLoader__.load({
 		    selection.zoom *= Math.exp(-(e.deltaY || 0) * 0.0012);
 		    clampCrop();
 		    applyEffects();
+		    updateHint();
 		    persistSelection();
 		  };
 		  const onKey = (e) => { if (e.key === "Escape") exitAdjust(); };
@@ -1896,12 +1908,18 @@ window.__ModuleLoader__.load({
 		  .webg-adjust {
 		    position: fixed; inset: 0; z-index: 2147483000;
 		    cursor: grab; touch-action: none;
+		    /* Desktop: the shell titlebar strip is a window-drag region and the
+		       union drag region ignores z-order - without no-drag, drags starting
+		       near the top of the adjust overlay move the WINDOW instead of
+		       panning, and the bar's Done button stops receiving clicks. */
+		    -webkit-app-region: no-drag;
+		    app-region: no-drag;
 		  }
 		  .webg-adjust:active { cursor: grabbing; }
 		  .webg-adjust .webg-layer { position: absolute; z-index: 0; }
 		  .webg-adjust-bar {
 		    position: absolute; top: 18px; left: 50%; transform: translateX(-50%);
-		    z-index: 1; cursor: default;
+		    z-index: 1; cursor: default; -webkit-app-region: no-drag; app-region: no-drag;
 		    display: flex; align-items: center; gap: 12px;
 		    padding: 8px 8px 8px 14px; border-radius: 12px;
 		    background: var(--dsw-alias-bg-overlay, rgba(30, 32, 38, 0.85));
@@ -1984,9 +2002,9 @@ window.__ModuleLoader__.load({
 		     Same on the queue dock panel (:before carries the blur). With a
 		     wallpaper active, menus showed sharp content through a 45% fill.
 		     An element's OWN backdrop-filter ignores its own isolation, so
-		     the filter moves onto the surface element; fill deepened 72%. */
-		  body[${ACTIVE_ATTR}] { --dsw-menu-surface-fill: rgba(67, 69, 74, 0.72); }
-		  body[${ACTIVE_ATTR}]:not([${DARK_ATTR}]) { --dsw-menu-surface-fill: rgba(248, 249, 250, 0.72); }
+		     the filter moves onto the surface element; fill deepened 85%. */
+		  body[${ACTIVE_ATTR}] { --dsw-menu-surface-fill: rgba(67, 69, 74, 0.85); }
+		  body[${ACTIVE_ATTR}]:not([${DARK_ATTR}]) { --dsw-menu-surface-fill: rgba(248, 249, 250, 0.85); }
 		  body[${ACTIVE_ATTR}] [data-menu-material],
 		  body[${ACTIVE_ATTR}] [data-composer-dock] [class*="_panel"] {
 		    -webkit-backdrop-filter: blur(var(--webg-blur, 16px)) saturate(var(--webg-saturate, 1.2)) brightness(var(--webg-glass-brightness, 1.04)) contrast(1.01);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wallpaper-engine-dsh",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Wallpaper Engine library as the DSH web GUI background — video/web/still wallpapers, rotation lists, search, resource monitor, bilingual UI.",
   "type": "module",
   "main": "lib/index.js",