dsh-asuta-desktop-navigation 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Asuta and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# Desktop Navigation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Workspace-authored bundle for Windows DSH Desktop. It combines local Chat-path navigation with a narrowly changed, MIT-licensed copy of the currently installed `dsh-recent` 0.1.0 browser artifact.
+
+## 1.0.3 — shared sidebar scroll compatibility
+
+When Sidebar More enables its shared browsing viewport, Recent uses that viewport for incremental loading. A layout-change event rebinds the observer when Sidebar More activates, collapses, expands or unloads; without the shared viewport it uses the original workspace list. The source patch lives in `build.mjs` and `client-extension.js`, and the vendored upstream artifact remains untouched. Verified in DSH 0.2.2-rc.1 with wheel scrolling, incremental loading, independent folding, search and cross-workspace mouse drag/undo.
+
+Installed in the current profile as `dsh-asuta-desktop-navigation` through a local source link. The original `include:dsh-recent` row is disabled through Plugin Manager to avoid duplicate workspace-fold observers. To roll back, disable this bundle and re-enable the original row through Plugin Manager. Do not activate both copies. The package was renamed from `@local/desktop-navigation` to give the native loader a fresh client manifest identity without restarting the backend.
+
+## Behavior
+
+Existing Chat blue file links retain the original StoredEntry, component inputs, child declarations, store, hooks, localization, and error/retry surface. A guarded wrapper around that entry's component changes only its `openFile` prop. Relative paths use the viewed Session's current workspace. A directory opens directly in Explorer; a file reveals its containing directory and selects the file. HTTP(S), arbitrary schemes, UNC shares, device paths, control characters, alternate data streams, and unresolved relative paths are rejected. Line anchors such as `#L24-L30` are removed from filesystem targets.
+
+A small authenticated Host route, `POST /desktop-navigation/path-info`, performs read-only metadata checks through the composed `fs` capability and refuses absent/unsupported targets. It verifies a local Host mapping and revalidates the canonical path. The Client then calls the existing native `remote.session.openWorkspacePath` operation: directories use ordinary open and files use `action: reveal`. Paths never become shell commands. This bundle contains no subprocess launches and no alternative URL opener.
+
+Recent retains upstream ordering, row actions, persistent options, workspace folding, paging, portals, and selectors. Double-clicking a Recent conversation title opens the native rename dialog, matching Workspace and Pinned lists. It reuses the shared native-row bridge from sidebar-more 1.0.2 when available and installs its own guarded bridge otherwise. The Recent detail card shows the session title, working directory, relative time, and native status lines. One shared card waits 800ms on the first hover, then switches immediately between rows, with a 200ms pointer grace. CSS anchor positioning keeps it beside the active row without synchronous geometry reads during each handoff; row actions use CSS hover visibility. Its own list receives a 180ms height transition and 140ms opacity transition. The header chevron rotates over 180ms. Closed content becomes inert immediately and unmounts after the transition; the paging sentinel is absent while folded. `prefers-reduced-motion: reduce` disables transitions and removes closed content immediately.
+
+## Compatibility and rollback
+
+The Chat adapter uses the inspected registry APIs to observe declaration lifetimes and trigger re-rendering, plus a guarded private seam on the native Chat StoredEntry's writable component property. It preserves that entry's complete standard kit and original child ownership. The wrapper forwards every prop and changes only openFile; it does not re-declare any slot or replace the registered entry. Disposal restores the exact descriptor only while the wrapper still owns it. Activating or unloading the wrapper remounts local Chat React state once; external store and cached injected values stay attached to their original entry. Startup ACK has been observed as navigation-ready on the installed client.
+
+The copied upstream recent implementation already includes its own DOM-based workspace-fold compatibility layer and primitive imports. Those upstream behaviors are retained; the new animation code only owns its React-rendered list box. No DSH installation/profile files were modified. The vendored original remains byte-for-byte preserved under `vendor/recent-original.js`, with attribution and MIT license. `vendor/UPSTREAM.json` records the source and SHA-256. The build refuses a different upstream fingerprint.
+
+## Build and verification
+
+Run `node build.mjs` inside this directory. It builds entirely from the retained original artifact; no dependency installation is required. Run `node --test ../.desktop-navigation/navigation.test.mjs` for URL/path rejection, native call intent, absent-target checks, complete registration preservation, and loader/motion contracts. All native calls in tests are stubs. No user folder or file is opened during testing.
+
+Final integration checks on 2026-10-26: the installed Client acknowledged navigation-ready, the native chat and trajectory entries remain active with no duplicate chat or transient marker, and sidebar.footer.action contains one active recent entry. All 12 navigation tests pass, including full factory/apply, actual wrapper render with native-call stubs, descriptor restoration, changed registry entries, and concurrent-owner protection. The combined suite has 35 passing tests plus 22 isolated settings-persistence assertions. Syntax checks and git diff --check pass.
+
+Verification limits: animation appearance, displayed artwork, and end-user Explorer handoff were not visually/click tested in the authenticated main window. The bundle deliberately does not launch Explorer automatically as a test. No real conversation history or user model settings were changed, and no Git commit or push was performed.
+
+Original icon: created specifically for this bundle. Original upstream recent copyright and license remain in `vendor/LICENSE.dsh-recent`.

package/client-extension.js

@@ -0,0 +1,215 @@
+function reportClientStage(stage, error) {
+  const detail = String(error?.message ?? error ?? '').slice(0, 2000);
+  reportClientStage.queue = (reportClientStage.queue ?? Promise.resolve()).then(async () => {
+    try { await fetch('/desktop-navigation/client-status', { method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ stage, error: detail }) }); } catch { /* Diagnostics must never prevent UI activation. */ }
+  });
+  return reportClientStage.queue;
+}
+
+/** Keep paging relative to the actual viewport, including sidebar-more hot reloads. */
+function useRecentScrollRoot(area) {
+  const resolve = () => area?.closest('[data-sm-scroll-region]') ?? area;
+  const [root, setRoot] = react.useState(resolve);
+  react.useLayoutEffect(() => {
+    const sync = () => setRoot(resolve());
+    sync();
+    window.addEventListener('sidebar-more:scroll-root-change', sync);
+    return () => window.removeEventListener('sidebar-more:scroll-root-change', sync);
+  }, [area]);
+  return root;
+}
+
+const SIDEBAR_MORE_RENAME_BRIDGE = Symbol.for('sidebar-more.native-row-bridge');
+const SIDEBAR_MORE_ROW_WRAPPER = Symbol.for('sidebar-more.workspace-row-bridge');
+const RECENT_RENAME_WRAPPER = Symbol.for('desktop-navigation.recent-rename-bridge');
+let nativeRenameRequest = null;
+let nativeHoverRender = null;
+
+function requestRecentSessionRename(sessionId, title) {
+  const shared = window[SIDEBAR_MORE_RENAME_BRIDGE]?.getSnapshot?.()?.requestSessionRename;
+  (shared ?? nativeRenameRequest)?.(sessionId, title);
+}
+
+function renderRecentHoverSlot(sessionId) {
+  const shared = window[SIDEBAR_MORE_RENAME_BRIDGE]?.getSnapshot?.()?.renderSlot;
+  return (shared ?? nativeHoverRender)?.('sidebar.session.row.hover', { sessionId }) ?? null;
+}
+
+function installRecentRenameBridge(ctx) {
+  const slots = ctx.slots, original = Symbol.for('cordis.original');
+  return slots.inject('sidebar.workspaces', () => {
+    let patch = null, changing = false, stopped = false;
+    function restore() {
+      if (patch && patch.entry.component === patch.wrapper) Object.defineProperty(patch.entry, 'component', patch.descriptor);
+      patch = null;
+    }
+    function reconcile() {
+      if (stopped || changing) return;
+      changing = true;
+      try {
+        const candidate = slots.entriesOfSlot('sidebar.workspaces')[0];
+        const entry = candidate?.[original] ?? candidate;
+        if (patch && patch.entry === entry && entry?.component === patch.wrapper) return;
+        restore();
+        if (!entry || typeof entry.component !== 'function' || entry.component[SIDEBAR_MORE_ROW_WRAPPER]) return;
+        const descriptor = Object.getOwnPropertyDescriptor(entry, 'component');
+        if (!descriptor || (!descriptor.writable && !descriptor.configurable)) return;
+        const NativeWorkspace = entry.component;
+        function RecentRenameWorkspace(props) {
+          const request = props.requestSessionRename;
+          const renderSlot = props.renderSlot;
+          react.useLayoutEffect(() => {
+            nativeRenameRequest = request;
+            nativeHoverRender = renderSlot;
+            return () => {
+              if (nativeRenameRequest === request) nativeRenameRequest = null;
+              if (nativeHoverRender === renderSlot) nativeHoverRender = null;
+            };
+          }, [request, renderSlot]);
+          return react.createElement(NativeWorkspace, props);
+        }
+        Object.defineProperty(RecentRenameWorkspace, RECENT_RENAME_WRAPPER, { value: true });
+        Object.defineProperty(entry, 'component', { ...descriptor, value: RecentRenameWorkspace });
+        patch = { entry, descriptor, wrapper: RecentRenameWorkspace };
+      } catch (error) { console.warn('desktop-navigation: recent rename bridge:', error); }
+      finally { changing = false; }
+    }
+    const unsubscribe = slots.subscribe('sidebar.workspaces', reconcile);
+    reconcile();
+    return () => { stopped = true; unsubscribe(); nativeRenameRequest = null; nativeHoverRender = null; restore(); };
+  });
+}
+
+function installNavigation(ctx) {
+  ctx.effect(() => {
+    const tag = document.createElement('style');
+    tag.dataset.pluginCss = 'dsh-asuta-desktop-navigation/recent-layout.css';
+    tag.textContent = '[data-slot="sidebar.recent.section"] > [class*="_header"] { box-sizing: border-box; padding-left: var(--dsh-sidebar-row-padding, 12px); padding-right: 1px; }';
+    tag.textContent += '.desktop-navigation-recent-anchor{position:relative;display:block}.aalpzW_row .aalpzW_rowActions{display:none}.aalpzW_row:hover .aalpzW_rowActions,.aalpzW_rowActive .aalpzW_rowActions{display:inline-flex}.aalpzW_row:hover .aalpzW_time,.aalpzW_row:hover .aalpzW_pinIndicator,.aalpzW_rowActive .aalpzW_time,.aalpzW_rowActive .aalpzW_pinIndicator{display:none}';
+    document.head.appendChild(tag);
+    return () => { tag.remove(); };
+  }, 'desktop-navigation: align recent section header');
+  ctx.effect(() => installRecentRenameBridge(ctx), 'desktop-navigation: native recent rename bridge');
+  installChatNavigation(ctx, (sessionId) => createNativeOpener({
+    cwd: () => ctx.get('sessions')?.list?.getSnapshot()?.byId?.[sessionId]?.cwd,
+    remote: { openWorkspacePath(request) {
+      const api = ctx.get('remote')?.session;
+      if (typeof api?.openWorkspacePath !== 'function') throw new Error('native-unavailable');
+      return api.openWorkspacePath(request);
+    } },
+    available: async () => (await ctx.get('remote')?.session?.canOpenWorkspacePath?.()) === true,
+    inspectPath: async (path) => {
+      const response = await fetch('/desktop-navigation/path-info', { method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ path }) });
+      const result = await response.json();
+      if (!response.ok) throw new Error(result.error ?? 'invalid-path');
+      return result;
+    },
+  }), message => reportClientStage('navigation-render-error', message), react);
+}
+
+const RecentHoverContext = react.createContext(null);
+
+/** One card for the Recent list. CSS anchors position it without synchronous layout reads on every handoff. */
+function RecentMotionList({ folded, rows, now, t, className, children }) {
+  const [mounted, setMounted] = react.useState(!folded);
+  const [shown, setShown] = react.useState(!folded);
+  const [card, setCard] = react.useState(null);
+  const [copied, setCopied] = react.useState(false);
+  const [hover] = react.useState(() => {
+    let row = null;
+    let anchor = null;
+    let dwell = null;
+    let grace = null;
+    let warm = false;
+    const clearDwell = () => { clearTimeout(dwell); dwell = null; };
+    const clearGrace = () => { clearTimeout(grace); grace = null; };
+    const dismiss = () => {
+      clearDwell(); clearGrace();
+      anchor?.style.removeProperty('anchor-name');
+      anchor = null; row = null; warm = false;
+      setCard(null); setCopied(false);
+    };
+    const armGrace = () => {
+      clearGrace();
+      grace = setTimeout(dismiss, 200);
+    };
+    return {
+      enter(next, t, now, element) {
+        clearGrace();
+        if (row?.id === next.id && anchor === element) return;
+        clearDwell();
+        anchor?.style.removeProperty('anchor-name');
+        row = next; anchor = element;
+        anchor.style.setProperty('anchor-name', '--dsh-recent-hover-anchor');
+        setCopied(false);
+        if (warm) setCard({ row: next, t, now });
+        else dwell = setTimeout(() => {
+          dwell = null; warm = true;
+          setCard({ row: next, t, now });
+        }, CARD_DWELL_MS);
+      },
+      leave(id) {
+        if (row?.id !== id) return;
+        if (warm) armGrace();
+        else {
+          clearDwell();
+          anchor?.style.removeProperty('anchor-name');
+          anchor = null; row = null;
+        }
+      },
+      enterCard: clearGrace,
+      leaveCard: armGrace,
+      currentId: () => row?.id,
+      refresh(rows, t, now) {
+        if (!warm || row === null) return;
+        const latest = rows.find(item => item.id === row.id);
+        if (!latest) { dismiss(); return; }
+        row = latest;
+        setCard(previous => previous && (previous.row !== latest || previous.now !== now || previous.t !== t)
+          ? { row: latest, t, now } : previous);
+      },
+      dismiss,
+      dispose() {
+        clearDwell(); clearGrace();
+        anchor?.style.removeProperty('anchor-name');
+      },
+    };
+  });
+  if (!folded && !mounted) setMounted(true);
+  react.useEffect(() => { if (folded) hover.dismiss(); }, [folded, hover]);
+  react.useEffect(() => { hover.refresh(rows, t, now); }, [hover, rows, t, now]);
+  react.useEffect(() => () => hover.dispose(), [hover]);
+  const reduce = react.useRef(false);
+  react.useEffect(() => {
+    const query = matchMedia('(prefers-reduced-motion: reduce)');
+    const change = () => { reduce.current = query.matches; if (query.matches && folded) setMounted(false); };
+    change(); query.addEventListener('change', change);
+    return () => query.removeEventListener('change', change);
+  }, [folded]);
+  react.useEffect(() => {
+    let frame; let timer;
+    if (!folded) { setMounted(true); frame = requestAnimationFrame(() => setShown(true)); }
+    else { setShown(false); if (reduce.current) setMounted(false); else timer = setTimeout(() => setMounted(false), 190); }
+    return () => { cancelAnimationFrame(frame); clearTimeout(timer); };
+  }, [folded]);
+  return react.createElement(RecentHoverContext.Provider, { value: hover },
+    react.createElement('div', { className: 'desktop-navigation-recent-motion', 'data-open': shown && !folded ? '' : undefined, 'aria-hidden': folded ? 'true' : undefined, ref: element => { if (element) element.inert = folded; } },
+      react.createElement('div', { className: 'desktop-navigation-recent-clip' }, mounted ? react.createElement('ul', { className }, children) : null),
+      react.createElement('style', null, '.desktop-navigation-recent-motion{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows 180ms ease,opacity 140ms ease}.desktop-navigation-recent-motion[data-open]{grid-template-rows:1fr;opacity:1}.desktop-navigation-recent-clip{min-height:0;overflow:hidden}.desktop-navigation-recent-card{--dsw-hovercard-bg:#2C2C2E;position:fixed;position-anchor:--dsh-recent-hover-anchor;left:calc(anchor(right) + 8px);top:anchor(top);position-try-fallbacks:--dsh-recent-bottom;z-index:100;box-sizing:border-box;width:244px;padding:12px 16px;border-radius:var(--dsw-radius-lg);background:var(--dsw-hovercard-bg);box-shadow:var(--dsw-shadow-lv3);cursor:pointer}@position-try --dsh-recent-bottom{top:auto;bottom:8px}.desktop-navigation-recent-card:focus-visible{outline:var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}.desktop-navigation-recent-copied{color:#fff;font-size:14px;line-height:20px;text-align:center}.aalpzW_chevron{transition:transform 180ms ease!important}@media(prefers-reduced-motion:reduce){.desktop-navigation-recent-motion,.aalpzW_chevron,[data-dsh-recent-section-chevron]{transition:none!important}}')),
+    card && react_dom.createPortal(react.createElement('div', {
+      className: 'desktop-navigation-recent-card',
+      role: 'button', tabIndex: 0,
+      'aria-label': card.t('copy') + ': ' + card.row.title,
+      onPointerEnter: hover.enterCard, onPointerLeave: hover.leaveCard,
+      onClick: () => {
+        const id = card.row.id;
+        if (!navigator.clipboard?.writeText) return;
+        navigator.clipboard.writeText(card.row.title).then(() => {
+          if (hover.currentId() !== id) return;
+          setCopied(true);
+          setTimeout(() => { if (hover.currentId() === id) setCopied(false); }, 1000);
+        }).catch(() => {});
+      },
+      onKeyDown: event => { if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); event.currentTarget.click(); } },
+    }, copied ? react.createElement('span', { className: 'desktop-navigation-recent-copied', 'aria-hidden': true }, card.t('hover.copied')) : react.createElement(RecentRowCard, { row: card.row, t: card.t, now: card.now })), document.body));
+}