@goodandready/dsh-time-machine 0.1.10 → 0.1.12

package/README.md

@@ -119,6 +119,14 @@ dsh-time-machine:
 
 ## 📋 Release Notes
 
+### v0.1.12 — Fix Oversized Clock Icon in Native Sidebar Guide
+* **Fixed in v0.1.12**: Replaced function-based icon with dedicated `TimeMachineIcon` component supporting both props object `{ size, className }` and numeric argument, with explicit inline sizing (`width`, `height`, `display: inline-block`, `flex: none`) to prevent overflow in the Right Sidebar Guide card.
+
+### v0.1.11 — Dual Sidebar Support: Native DSH Right Sidebar & BetterSidebar
+* **Added in v0.1.11**: Support for native DSH Right Sidebar (`sidebarRightTabs` + `sidebar.right.pane.tab`) introduced in DSH 0.1.5-alpha.1, including guide page registration with custom icon.
+* **Preserved in v0.1.11**: Legacy `betterSidebar` integration retained with deterministic surface-scoped registrations, preventing ID collisions or duplicate mounts when both surfaces exist.
+* **Added in v0.1.11**: Graceful degradation to plugin settings card when neither sidebar surface is available.
+
 ### v0.1.10 — Stability, Dynamic CWD, Unified Diff & Architecture Polish
 * **Added in v0.1.10**: Dynamic / session-aware `cwd` resolution: TimeMachine tools and REST endpoints automatically locate the active session workspace or accept explicit target directory.
 * **Added in v0.1.10**: Unified diff support (`format: "patch" | "stat"`) with size limits (up to 256KB) and clean truncation warnings.

package/README.ru.md

@@ -119,6 +119,14 @@ dsh-time-machine:
 
 ## 📋 История версий (Release Notes)
 
+### v0.1.12 — Исправление размера иконки часов на странице Guide нативного сайдбара
+* **Fixed in v0.1.12**: Заменена стрелочная функция иконки на полноценный React-компонент `TimeMachineIcon`, корректно обрабатывающий как объект props `{ size, className }`, так и числовой аргумент; добавлены явные inline-стили (`width`, `height`, `flex: none`), устраняющие растягивание иконки часов на карточке Guide.
+
+### v0.1.11 — Поддержка нативного DSH Right Sidebar и legacy BetterSidebar
+* **Added in v0.1.11**: Поддержка нативной правой панели DSH (`sidebarRightTabs` + слот `sidebar.right.pane.tab`), появившейся в DSH 0.1.5-alpha.1, включая регистрацию на странице Guide с иконкой.
+* **Preserved in v0.1.11**: Полная обратная совместимость с `betterSidebar`; раздельные идентификаторы поверхностей исключают конфликты или двойное монтирование при совместном включении.
+* **Added in v0.1.11**: Безопасный откат к карточке настроек плагина при отсутствии обеих боковых панелей в хосте.
+
 ### v0.1.10 — Стабильность, динамический CWD, Unified Diff и оптимизация архитектуры
 * **Added in v0.1.10**: Динамическое определение рабочей директории (`cwd`): инструменты и REST API автоматически определяют каталог активной сессии либо принимают явный путь.
 * **Added in v0.1.10**: Поддержка Unified Diff (`format: "patch" | "stat"`) с лимитом размера (до 256 КБ) и защитой от переполнения контекста.

package/README.zh.md

@@ -94,6 +94,14 @@ dsh-time-machine:
 
 ## 📋 版本更新记录 (Release Notes)
 
+### v0.1.12 — 修复原生侧边栏引导页中时钟图标过大的问题
+* **Fixed in v0.1.12**: 将图标函数重构为标准 React 组件 `TimeMachineIcon`，兼容 `{ size, className }` 属性对象与数字传参，增加内联样式限制（`width`, `height`, `flex: none`），彻底解决右侧边栏 Guide 卡片中图标溢出的缺陷。
+
+### v0.1.11 — 双侧边栏支持：原生 DSH 右侧边栏与 BetterSidebar
+* **Added in v0.1.11**: 原生支持 DSH 0.1.5-alpha.1 引入的右侧边栏（`sidebarRightTabs` 注册与 `sidebar.right.pane.tab` 插槽），包含专属引导页卡片与图标。
+* **Preserved in v0.1.11**: 保持对旧版 `betterSidebar` 的完全向后兼容；两种表面同时启用时互不干扰，杜绝重复挂载或 ID 冲突。
+* **Added in v0.1.11**: 在两种侧边栏均缺失的环境下，安全降级至插件设置卡片。
+
 ### v0.1.10 — 稳定性、动态工作目录、统一 Diff 与架构优化
 * **Added in v0.1.10**: 动态工作区感知（`cwd`）：时光机工具与 REST 接口自动关联当前会话目录或支持显式工作区路径。
 * **Added in v0.1.10**: 统一补丁支持（`format: "patch" | "stat"`），带输出截断保护（最大 256KB）。

package/lib/client.js

@@ -65,6 +65,8 @@ window.__ModuleLoader__.load({
       unavailable: 'Settings unavailable',
       tabTitle: 'Time Machine',
       sidebarNotice: 'Checkpoints and timeline are available in the Time Machine sidebar tab.',
+      guideTitle: 'Time Machine',
+      guideDesc: 'Checkpoints, visual diffs and instant workspace rollback.',
     };
     const ru = {
       title: 'Машина времени и чекпоинты',
@@ -88,6 +90,8 @@ window.__ModuleLoader__.load({
       unavailable: 'Настройки недоступны',
       tabTitle: 'Машина времени',
       sidebarNotice: 'Лента чекпоинтов и управление снимками доступны во вкладке «Машина времени» боковой панели.',
+      guideTitle: 'Машина времени',
+      guideDesc: 'Чекпоинты, просмотр diff и мгновенный откат рабочего пространства.',
     };
     const zh = {
       title: '时光机与检查点',
@@ -111,6 +115,8 @@ window.__ModuleLoader__.load({
       unavailable: '设置不可用',
       tabTitle: '时光机',
       sidebarNotice: '检查点时间线与管理可在侧边栏“时光机”标签页中查看。',
+      guideTitle: '时光机',
+      guideDesc: '快照检查点、差异对比与即时工作区回滚。',
     };
 
     let ChevronIcon = null;
@@ -124,6 +130,26 @@ window.__ModuleLoader__.load({
     }
     const Chevron = ChevronIcon || FallbackChevron;
 
+
+    function TimeMachineIcon(props) {
+      const s = typeof props === "number" ? props : (props && props.size) || 16;
+      const cls = (props && props.className) || "";
+      return React.createElement("svg", {
+        width: s,
+        height: s,
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "2",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        className: cls,
+        style: { width: s, height: s, display: "inline-block", flex: "none" }
+      },
+        React.createElement("circle", { cx: 12, cy: 12, r: 10 }),
+        React.createElement("polyline", { points: "12 6 12 12 16 14" })
+      );
+    }
     function useLocale(ctx) {
       if (!ctx || !ctx.locale) return 'en';
       const lang = React.useSyncExternalStore(
@@ -393,10 +419,7 @@ window.__ModuleLoader__.load({
             },
             order: 30,
             single: true,
-            icon: (size) => React.createElement('svg', { width: size||16, height: size||16, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: '2', strokeLinecap: 'round', strokeLinejoin: 'round' },
-              React.createElement('circle', { cx:12, cy:12, r:10 }),
-              React.createElement('polyline', { points:'12 6 12 12 16 14' })
-            ),
+            icon: TimeMachineIcon,
             component: (p) => React.createElement(TimeMachineTab, { ctx, ...p })
           });
           tabRegistered = true;
@@ -418,6 +441,82 @@ window.__ModuleLoader__.load({
           }
         }
       }
+
+      // Native DSH Right Sidebar (DSH >= 0.1.5-alpha.1)
+      let nativeTabRegistered = false;
+      const doRegisterNativeSidebar = (nctx) => {
+        if (nativeTabRegistered) return;
+        const reg = (nctx && nctx.sidebarRightTabs) || (nctx && nctx.get && (()=>{ try{return nctx.get('sidebarRightTabs')}catch{return null}})()) || ctx.sidebarRightTabs;
+        if (!reg || typeof reg.register !== 'function') return;
+        try {
+          const tNative = (ctx.locale && ctx.locale.bind) ? ctx.locale.bind(NS) : (k) => k;
+          const def = {
+            id: NS,
+            kind: 'time-machine',
+            priority: 'extension',
+            title: () => {
+              const a = (ctx.locale && ctx.locale.getSnapshot && ctx.locale.getSnapshot().active) || 'en';
+              return a.startsWith('zh') ? '时光机' : (a.startsWith('ru') ? 'Машина времени' : 'Time Machine');
+            },
+            guide: [{
+              order: 35,
+              title: () => {
+                const a = (ctx.locale && ctx.locale.getSnapshot && ctx.locale.getSnapshot().active) || 'en';
+                return a.startsWith('zh') ? '时光机' : (a.startsWith('ru') ? 'Машина времени' : 'Time Machine');
+              },
+              description: () => {
+                const a = (ctx.locale && ctx.locale.getSnapshot && ctx.locale.getSnapshot().active) || 'en';
+                return a.startsWith('zh') ? zh.guideDesc : (a.startsWith('ru') ? ru.guideDesc : en.guideDesc);
+              },
+              icon: TimeMachineIcon
+            }]
+          };
+
+          const unregDef = reg.register(def);
+          nativeTabRegistered = true;
+
+          // Register tab body in slot sidebar.right.pane.tab
+          const doRegisterPaneTab = () => {
+            try {
+              ctx.slots.register({
+                name: 'sidebar.right.pane.tab',
+                key: NS,
+                locale: NS,
+                inject: () => ({ ctx })
+              }, TimeMachineTab);
+            } catch (e) {
+              console.error('[dsh-time-machine] sidebar.right.pane.tab register failed', e);
+            }
+          };
+
+          if (ctx.slots && typeof ctx.slots.inject === 'function') {
+            try {
+              ctx.slots.inject('sidebar.right.pane.tab', () => {
+                doRegisterPaneTab();
+              });
+            } catch (e) {
+              doRegisterPaneTab();
+            }
+          } else {
+            doRegisterPaneTab();
+          }
+        } catch (e) {
+          console.error('[dsh-time-machine] native sidebarRightTabs register failed', e);
+        }
+      };
+
+      if (ctx.inject) {
+        try {
+          ctx.inject(['sidebarRightTabs'], (nctx) => {
+            doRegisterNativeSidebar(nctx);
+            return () => {};
+          });
+        } catch (e) {
+          if (!String(e && e.message || '').includes('not declared')) {
+            console.error('[dsh-time-machine] sidebarRightTabs inject failed', e);
+          }
+        }
+      }
     };
     return module.exports;
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-time-machine",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "DSH plugin for smart checkpoints, workspace safety guards, and instant rollback",
   "type": "module",
   "main": "lib/index.js",