@linxin666/dsh-ssh 0.4.2 → 0.4.4

package/src/client/body-mutations.ts

@@ -1,133 +0,0 @@
-// Generated by scripts/sync-shared.mjs from shared/client/body-mutations.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
-/**
- * One `document.body` MutationObserver per page, shared by every family
- * plugin bundle.
- *
- * Family plugins that inject at the DOM level must notice when the shell
- * re-renders around their injected node: the sidebar entry rows
- * (sidebar-entry-core), the center-column panel containers
- * (panel-mount-core), and the aggregate shell's column shims. Each consumer
- * used to install its OWN `MutationObserver` on `document.body` with
- * `{ childList: true, subtree: true }`, so a page carrying N family plugins
- * paid N native observers and N callback invocations for EVERY mutation batch
- * the app produced — chat token streaming alone produces many per second, and
- * the count grows with the number of installed plugins.
- *
- * This module keeps exactly ONE body observer per page. The registry lives on
- * `globalThis` under a `Symbol.for` key, so the per-package generated copies
- * of this file (scripts/sync-shared.mjs) and separately bundled plugins all
- * reach the same hub at runtime instead of one hub per module instance.
- * Record subscribers receive the mutations accumulated since the last flush.
- * Consumers that only re-check their DOM use subscribeBodyInvalidations:
- * when all subscribers use that path, the hub retains no mutation records
- * (or detached subtrees) while a background page's animation frames pause.
- * Both paths run at most once per frame. The last subscriber disconnects the
- * observer, cancels the pending frame and releases its records.
- *
- * Failure policy: without a DOM or `MutationObserver` the subscription is a
- * no-op disposer (the same silence the per-consumer observers had), and when
- * `requestAnimationFrame` is unavailable the flush runs synchronously so a
- * subscriber is never silently dropped. A throwing subscriber cannot stop the
- * others.
- */
-
-/** The page-wide hub: one observer plus its subscribers and pending records. */
-interface BodyMutationHub {
-  observer: MutationObserver
-  subscribers: Set<(records: MutationRecord[]) => void>
-  pending: MutationRecord[]
-  scheduled: boolean
-  frame?: number
-}
-
-/** Cross-bundle registry key; `Symbol.for` so every module copy agrees. */
-const HUB_KEY = Symbol.for('dsh-web.body-mutation-hub')
-const INVALIDATION_ONLY = Symbol.for('dsh-web.body-mutation-invalidation')
-type Subscriber = ((records: MutationRecord[]) => void) & { [INVALIDATION_ONLY]?: true }
-
-function needsRecords(subscribers: Set<(records: MutationRecord[]) => void>): boolean {
-  for (const listener of subscribers) {
-    if (!(listener as Subscriber)[INVALIDATION_ONLY]) return true
-  }
-  return false
-}
-
-/**
- * Subscribe to a coalesced DOM re-check without retaining mutation records.
- * The marked wrapper also works with an older hub, which delivers records
- * that it simply ignores until a page reload picks up the updated hub.
- */
-export function subscribeBodyInvalidations(subscriber: () => void): () => void {
-  const listener: Subscriber = () => { subscriber() }
-  listener[INVALIDATION_ONLY] = true
-  return subscribeBodyMutations(listener)
-}
-
-/**
- * Subscribe to body-level childList mutations.
- * @param subscriber - called at most once per animation frame with the records
- *   collected since the previous flush; must be safe to run repeatedly.
- * @returns the disposer removing this subscriber (and the observer when it was
- *   the last one).
- */
-export function subscribeBodyMutations(subscriber: (records: MutationRecord[]) => void): () => void {
-  if (typeof globalThis === 'undefined' || typeof document === 'undefined') return () => {}
-  if (typeof MutationObserver !== 'function') return () => {}
-  const registry = globalThis as unknown as Record<symbol, unknown>
-  let hub = registry[HUB_KEY] as BodyMutationHub | undefined
-  if (hub === undefined) {
-    const subscribers = new Set<(records: MutationRecord[]) => void>()
-    const created: BodyMutationHub = {
-      observer: undefined as unknown as MutationObserver,
-      subscribers,
-      pending: [],
-      scheduled: false,
-    }
-    const flush = (): void => {
-      created.frame = undefined
-      created.scheduled = false
-      const batch = created.pending
-      created.pending = []
-      for (const listener of [...subscribers]) {
-        if (!subscribers.has(listener)) continue
-        try {
-          listener(batch)
-        } catch {
-          // One subscriber must never break the others; the next flush retries it.
-        }
-      }
-    }
-    const schedule = (): void => {
-      if (created.scheduled) return
-      created.scheduled = true
-      if (typeof requestAnimationFrame === 'function') created.frame = requestAnimationFrame(flush)
-      else flush()
-    }
-    created.observer = new MutationObserver((records) => {
-      if (needsRecords(subscribers)) {
-        for (const record of records) created.pending.push(record)
-      }
-      schedule()
-    })
-    created.observer.observe(document.body ?? document.documentElement, { childList: true, subtree: true })
-    registry[HUB_KEY] = created
-    hub = created
-  }
-  const active = hub
-  active.subscribers.add(subscriber)
-  let subscribed = true
-  return () => {
-    if (!subscribed) return
-    subscribed = false
-    active.subscribers.delete(subscriber)
-    if (!needsRecords(active.subscribers)) active.pending = []
-    if (active.subscribers.size === 0 && registry[HUB_KEY] === active) {
-      active.observer.disconnect()
-      if (active.frame !== undefined && typeof cancelAnimationFrame === 'function') cancelAnimationFrame(active.frame)
-      active.frame = undefined
-      active.pending = []
-      active.scheduled = false
-      delete registry[HUB_KEY]
-    }
-  }
-}

package/src/client/mount.tsx

@@ -1,47 +0,0 @@
-/**
- * Panel view mounting (dsh-ssh wrapper).
- *
- * The single-occupant takeover lifecycle — container injection into the
- * center column, sibling eviction, remount resilience, sidebar click-out —
- * lives exactly once in shared/client/panel-mount-core.ts (synced copy); this
- * wrapper supplies the SSH panel tree, view dataset key, CSS module, and the
- * html attribute names. Those names are pinned by panel.module.css, skins,
- * and the semantic attributes contract.
- */
-import type { SshApi } from './api.ts'
-import type { PanelController } from './panel/controller.ts'
-import type { TerminalFontSource } from './panel/helpers.ts'
-import { SshPanel } from './panel/SshPanel.tsx'
-import { mountCenterPanel } from './panel-mount-core.ts'
-import type { LocaleRefreshSource } from './sidebar-entry.ts'
-import css from './panel/panel.module.css'
-
-/** The injected panel container (kept in the DOM, hidden when inactive). */
-export const PANEL_VIEW_SELECTOR = '[data-dsh-ssh-view]'
-
-/**
- * Mount the panel React tree into the center column and bind its visibility
- * to the controller's panelOpen state.
- * @param controller - the panel controller driving the view.
- * @param api - the SSH API client the tabs operate through.
- * @param terminalFont - live terminal-font setting source (issue #577).
- * @param locale - locale-change source; when given, re-renders an open panel
- *   on a Language switch.
- * @returns disposer unmounting the tree and restoring the column.
- */
-export function mountPanel(controller: PanelController, api: SshApi, terminalFont?: TerminalFontSource, locale?: LocaleRefreshSource): () => void {
-  return mountCenterPanel({
-    render: root => root.render(<SshPanel controller={controller} api={api} terminalFont={terminalFont} />),
-    viewDatasetKey: 'dshSshView',
-    pluginName: 'ssh',
-    viewClassName: css.view,
-    activeAttribute: 'data-dsh-ssh-active',
-    siblingActiveAttribute: 'data-dsh-taskboard-active',
-    panelName: 'ssh',
-    siblingPanelName: 'taskboard',
-    isOpen: () => controller.getSnapshot().panelOpen,
-    close: () => controller.close(),
-    subscribe: listener => controller.subscribe(listener),
-    locale,
-  })
-}

package/src/client/panel-mount-core.ts

@@ -1,155 +0,0 @@
-// Generated by scripts/sync-shared.mjs from shared/client/panel-mount-core.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
-/**
- * Center-column panel takeover lifecycle.
- *
- * The `conversation` slot is single-occupant (ui-conversation) and external
- * plugins cannot declare slots, so a family panel takes over the center
- * column at the DOM level: a container is appended inside the center column
- * (`[class*="centerCol"]`, the 0.1.0-rc.6+ AppFrame layout; previously
- * `[data-pane="conversation"]` on older shells — the mount selector keeps
- * both, ssh #243 / task-board #107) as an extra trailing child React never
- * manages, and a stylesheet rule hides the conversation content while the
- * panel is active. Toggling is a data attribute on <html> — no React
- * involvement, so the conversation subtree underneath stays mounted and
- * stateful.
- *
- * Consuming plugins keep a thin wrapper that supplies the panel tree,
- * container attribute names, and stylesheet class; those names are pinned by
- * each package's CSS, skins, and the semantic-attributes contract. The
- * sidebar row toggling the panel shares its core the same way
- * (shared/client/sidebar-entry-core.ts, synced copy).
- */
-import { createRoot, type Root } from 'react-dom/client'
-import { subscribeBodyInvalidations } from './body-mutations.ts'
-
-/** Options for mountCenterPanel; dsh-ssh mount.tsx and dsh-task-board board-mount.tsx are the canonical consumers. */
-export interface CenterPanelMountOptions {
-  /** Render the panel tree (first open, remount while open, locale refresh). */
-  render: (root: Root) => void
-  /** dataset key of the injected container's view attribute, e.g. `dshSshView` for `data-dsh-ssh-view`. */
-  viewDatasetKey: string
-  /** value of the container's L2 `data-dsh-plugin` semantic attribute. */
-  pluginName: string
-  /** stylesheet class applied to the injected container. */
-  viewClassName: string
-  /** <html> attribute set while this panel is active. */
-  activeAttribute: string
-  /** the sibling panel's active attribute, removed from <html> when this panel opens. */
-  siblingActiveAttribute: string
-  /** detail value this panel broadcasts on the cross-plugin activation event. */
-  panelName: string
-  /** sibling detail value whose activation closes this panel. */
-  siblingPanelName: string
-  /** open flag of the owning controller. */
-  isOpen: () => boolean
-  /** close the panel, handing the center column back to the conversation. */
-  close: () => void
-  /** subscribe to the owning controller's open-state changes; returns an unsubscriber. */
-  subscribe: (listener: () => void) => () => void
-  /** locale-change source; when given, re-renders an open panel on a Language switch. */
-  locale?: { subscribe(listener: () => void): () => void }
-}
-
-const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"], [class*="centerCol"]'
-/** Cross-plugin activation event; detail is the activating panel name. */
-const ACTIVATE_EVENT = 'dsh-panel-activate'
-// Sidebar rows whose clicks hand the center column back to the conversation
-// (including the already-current row, which produces no session-change
-// event). Capture phase, so the panel closes before the shell processes the
-// click.
-const SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="searchResultWorkspace"], [class*="newSession"]'
-
-/** Find the center column, or undefined while the frame is not mounted. */
-function conversationColumn(): HTMLElement | undefined {
-  return document.querySelector<HTMLElement>(CONVERSATION_COLUMN_SELECTOR) ?? undefined
-}
-
-/**
- * Mount a family panel into the center column and bind its visibility to the
- * owning controller's open state.
- * @returns disposer unmounting the tree and restoring the column.
- */
-export function mountCenterPanel(options: CenterPanelMountOptions): () => void {
-  let root: Root | undefined
-  let container: HTMLDivElement | undefined
-  let unsubscribeLocale: (() => void) | undefined
-  try {
-    unsubscribeLocale = options.locale?.subscribe(() => {
-      if (root !== undefined) options.render(root)
-    })
-  } catch { /* locale service absent: the panel follows its next natural re-render */ }
-
-  const ensure = (): void => {
-    if (container !== undefined && !container.isConnected) {
-      // The conversation pane was replaced; drop the stale tree and remount.
-      root?.unmount()
-      root = undefined
-      container.remove()
-      container = undefined
-    }
-    if (container === undefined) {
-      const column = conversationColumn()
-      if (column === undefined) return
-      container = document.createElement('div')
-      container.dataset[options.viewDatasetKey] = ''
-      container.dataset.dshPlugin = options.pluginName
-      container.className = options.viewClassName
-      column.appendChild(container)
-    }
-    // Keep a visited tree mounted so drafts and terminal sessions survive
-    // close/reopen; an unused panel needs neither a React root nor effects.
-    if (root !== undefined || !options.isOpen()) return
-    root = createRoot(container)
-    options.render(root)
-  }
-
-  // The frame mounts after boot settlement; watch for the column's arrival.
-  // The observation is the page-wide hub (shared/client/body-mutations.ts):
-  // every family panel used to hold its own document.body subtree observer, so
-  // the per-mutation cost grew with the number of installed plugins.
-  const unsubscribeBody = subscribeBodyInvalidations(() => { ensure() })
-
-  const applyActive = (): void => {
-    if (options.isOpen()) {
-      ensure()
-      // Single-occupant center column: opening this panel must evict the
-      // sibling panel, both its html attribute and its controller state,
-      // otherwise the two panels' visibility rules fight and the second
-      // click appears dead.
-      document.documentElement.removeAttribute(options.siblingActiveAttribute)
-      document.documentElement.setAttribute(options.activeAttribute, '')
-      document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: options.panelName }))
-    } else {
-      document.documentElement.removeAttribute(options.activeAttribute)
-    }
-  }
-  const onOtherActivate = (event: Event): void => {
-    if ((event as CustomEvent).detail === options.siblingPanelName && options.isOpen()) {
-      options.close()
-    }
-  }
-  const onClickSidebarRow = (event: MouseEvent): void => {
-    if (!options.isOpen()) return
-    const target = event.target as HTMLElement | null
-    if (target === null) return
-    if (target.closest(SIDEBAR_ROW_SELECTOR) !== null) options.close()
-  }
-  document.addEventListener('click', onClickSidebarRow, true)
-  document.addEventListener(ACTIVATE_EVENT, onOtherActivate)
-  const unsubscribe = options.subscribe(applyActive)
-  applyActive()
-  ensure()
-
-  return () => {
-    document.removeEventListener('click', onClickSidebarRow, true)
-    document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
-    unsubscribeBody()
-    unsubscribe()
-    unsubscribeLocale?.()
-    document.documentElement.removeAttribute(options.activeAttribute)
-    root?.unmount()
-    root = undefined
-    container?.remove()
-    container = undefined
-  }
-}

package/src/client/sidebar-entry-core.ts

@@ -1,237 +0,0 @@
-// Generated by scripts/sync-shared.mjs from shared/client/sidebar-entry-core.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
-/**
- * Shared sidebar entry injection core.
- *
- * dsh's sidebar shell exposes no slot an external plugin can register into,
- * so the entry row is injected between the shell's New Session button and the
- * workspace browser. The injection self-heals: a MutationObserver watches the
- * sidebar root and re-inserts the row whenever a React re-render displaces it
- * (re-insertion happens in the same frame, before paint, so no flicker).
- *
- * The row is plain DOM (no React tree) so it can never disturb the shell's
- * reconciliation; the view it toggles is a separate root owned by the caller.
- *
- * Packages receive this file as a generated copy via scripts/sync-shared.mjs;
- * edit the shared source and re-run the sync instead of editing a copy.
- */
-import { subscribeBodyInvalidations } from './body-mutations.ts'
-
-/** Per-package configuration for one sidebar entry row. */
-export interface SidebarEntryOptions {
-  /** Full attribute name identifying the injected row (idempotency key), e.g. 'data-dsh-ssh-entry'. */
-  rowAttribute: string
-  /** CSS selector matching the injected row, e.g. '[data-dsh-ssh-entry]'. */
-  rowSelector: string
-  /**
-   * L2 semantic-attribute plugin id (issue #506, enum table:
-   * skins/skin-center/contracts/semantic-attrs-v1.md). When set, the row also
-   * outputs data-dsh-plugin="<id>" and data-dsh-part="sidebar-entry"; unset
-   * leaves the row without semantic attributes.
-   */
-  plugin?: string
-  /** Inline icon markup (matches the shell's 16px nav-icon look). */
-  icon: string
-  /** CSS module class names for the row and its two spans (entry / entryIcon / entryLabel). */
-  css: Record<string, string>
-  /** Localized row label (aria-label + visible text). */
-  label(): string
-  /** Optional localized tooltip (title attribute). */
-  tooltip?(): string
-  /**
-   * Optional locale-change subscription: re-applies label / aria-label /
-   * tooltip whenever the active locale changes. Plain-DOM rows would
-   * otherwise keep the label captured at mount; pass the SDK locale runtime
-   * subscription (ctx.locale.subscribe) so the row follows the language
-   * switch without a reload.
-   */
-  refresh?: { subscribe(listener: () => void): () => void }
-  /** Click action (open/toggle the owning panel). */
-  onToggle(): void
-  /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
-  position: 'before' | 'after'
-  /**
-   * Selectors of the sibling plugin entry rows this package orders against
-   * (its own row included — the placement guard excludes a row that is
-   * already inside the root). Each package passes the same list it used
-   * before the consolidation so the rendered order stays stable.
-   */
-  familySelectors: readonly string[]
-  /** Optional active-state bridge; highlights the row while the panel is open. */
-  active?: {
-    subscribe(listener: () => void): () => void
-    isOpen(): boolean
-  }
-}
-
-/** Find the sidebar shell root element, or undefined while not yet mounted. */
-function sidebarRoot(): HTMLElement | undefined {
-  const column = document.querySelector<HTMLElement>('[data-pane="sidebar"], [class*="sidebarCol"]')
-  if (column === null) return undefined
-  // Current shells wrap the sidebar UI: column > wrapper > root(logoRow owner).
-  // Prefer the element that owns the logo row — the real sidebar UI root —
-  // and fall back to the column's first child for legacy shells.
-  const logoOwner = column.querySelector<HTMLElement>('[class*="logoRow"]')?.parentElement
-  return logoOwner ?? (column.firstElementChild as HTMLElement | undefined)
-}
-
-/** The New Session button: nested in the logo row on current shells, a direct child on legacy shells. */
-function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
-  const nested = root.querySelector<HTMLButtonElement>('button[class*="newSession"]')
-  if (nested !== null) return nested
-  for (const child of root.children) {
-    if (child.tagName === 'BUTTON') return child as HTMLButtonElement
-  }
-  return undefined
-}
-
-/** Build the entry row (detached; inserted once the shell is up). */
-function createEntry(options: SidebarEntryOptions): { entry: HTMLElement; applyLabel: () => void } {
-  const entry = document.createElement('button')
-  entry.type = 'button'
-  entry.setAttribute(options.rowAttribute, '')
-  if (options.plugin !== undefined) {
-    entry.setAttribute('data-dsh-plugin', options.plugin)
-    entry.setAttribute('data-dsh-part', 'sidebar-entry')
-  }
-  entry.className = options.css['entry'] ?? ''
-  const labelSpan = document.createElement('span')
-  labelSpan.className = options.css['entryLabel'] ?? ''
-  const iconSpan = document.createElement('span')
-  iconSpan.className = options.css['entryIcon'] ?? ''
-  iconSpan.innerHTML = options.icon
-  entry.append(iconSpan, labelSpan)
-  const applyLabel = (): void => {
-    entry.setAttribute('aria-label', options.label())
-    if (options.tooltip !== undefined) entry.setAttribute('title', options.tooltip())
-    labelSpan.textContent = options.label()
-  }
-  applyLabel()
-  entry.addEventListener('click', options.onToggle)
-  return { entry, applyLabel }
-}
-
-/** Re-insert the entry after the New Session row (before the browser region). */
-function placeEntry(root: HTMLElement, entry: HTMLElement, options: SidebarEntryOptions): boolean {
-  const button = newSessionButton(root)
-  if (button === undefined) return false
-  if (entry.parentElement !== root) {
-    // Position relative to the family block (entries injected by sibling
-    // plugins), never relative to transient logoRow geometry: every family
-    // plugin that self-heals during a re-render then lands in the same
-    // relative order, so the entries cannot swap positions regardless of
-    // observer callback order or of shell wrapper changes. There is no
-    // append-to-end fallback: appending at the end would randomly reorder
-    // the block after a shell re-render.
-    const row = button.closest('[class*="logoRow"]')
-    const base = (row !== null && row.parentElement === root) ? row : button
-    const family = Array.from(root.children).filter(
-      (el): el is HTMLElement => el instanceof HTMLElement && el.matches(options.familySelectors.join(', ')),
-    )
-    const anchor = options.position === 'before'
-      ? (family.length > 0 ? family[0] : base.nextElementSibling)
-      : (family.length > 0 ? family[family.length - 1]!.nextElementSibling : base.nextElementSibling)
-    root.insertBefore(entry, anchor)
-  }
-  return true
-}
-
-/**
- * Mount the sidebar entry, waiting for the shell to render and self-healing
- * on later React re-renders.
- * @param options - the row's attribute/icon/copy/action/ordering configuration.
- * @returns disposer removing the entry and its observers.
- */
-export function mountSidebarEntry(options: SidebarEntryOptions): () => void {
-  // DOM-level idempotency: whatever path mounted an entry row before this
-  // call (a duplicated apply, an HMR re-injection, a stale module still
-  // alive), never mount a second one. The existing row keeps working; a full
-  // page reload is the ultimate reset.
-  if (typeof document !== 'undefined' && document.querySelector(options.rowSelector) !== null) {
-    return () => {}
-  }
-  const { entry, applyLabel } = createEntry(options)
-  let root: HTMLElement | undefined
-  let placed = false
-  let unsubscribeRefresh: (() => void) | undefined
-  if (options.refresh !== undefined) {
-    try {
-      unsubscribeRefresh = options.refresh.subscribe(applyLabel)
-    } catch {
-      // A throwing subscription must not break the mount; the label stays at
-      // its initial value and the next reload resolves it again.
-    }
-  }
-
-  const tryPlace = (): void => {
-    if (root !== undefined && !root.isConnected) {
-      // The shell rebuilt the sidebar pane (whole-tree teardown); the root
-      // observer is gone with the old tree, so detach it and re-query from
-      // scratch. The new pane is later noticed by the body-level watcher.
-      rootObserver.disconnect()
-      root = undefined
-      placed = false
-    }
-    if (placed) {
-      // Cheap short-circuit: entry still lives in a mountable subtree.
-      if (document.body.contains(entry)) return
-      // Entry was torn down together with the old tree; reset and re-place.
-      rootObserver.disconnect()
-      root = undefined
-      placed = false
-    }
-    root ??= sidebarRoot()
-    if (root === undefined) return
-    placed = placeEntry(root, entry, options)
-    if (placed) {
-      rootObserver.observe(root, { childList: true, subtree: true })
-    }
-  }
-
-  // Body-level watcher retained as the "whole rebuild" fallback: when the shell
-  // tears down the whole sidebar pane, the root observer is gone with it and
-  // only this body observation can notice the new pane mounting. It stays
-  // subscribed after placement; the placed-and-still-mounted case
-  // short-circuits through the cheap document.body.contains(entry) check, so
-  // unrelated app mutations (e.g. chat streaming) cost one contains check per
-  // frame instead of churning the full re-query. The body observation itself is
-  // the page-wide hub (shared/client/body-mutations.ts): every family plugin
-  // used to hold its own body subtree observer, so the per-mutation cost grew
-  // with the number of installed plugins; the hub keeps exactly one.
-  const unsubscribeBody = subscribeBodyInvalidations(() => { tryPlace() })
-
-  // Self-heal: if a React re-render displaces the row, re-insert it in the
-  // same frame (microtask before paint -> no visible flicker).
-  const rootObserver = new MutationObserver(() => {
-    if (root === undefined || !root.isConnected) {
-      placed = false
-      tryPlace()
-      return
-    }
-    if (!root.contains(entry)) {
-      placed = placeEntry(root, entry, options)
-    }
-  })
-
-  // Reflect the panel's open state on the row (active highlight). Note: assigning
-  // undefined to dataset.active materializes data-active="undefined" and keeps the
-  // row permanently highlighted — delete the attribute instead.
-  const unsubscribeActive = options.active === undefined ? undefined : (() => {
-    const syncActive = (): void => {
-      if (options.active!.isOpen()) entry.dataset.active = 'true'
-      else delete entry.dataset.active
-    }
-    const unsubscribe = options.active.subscribe(syncActive)
-    syncActive()
-    return unsubscribe
-  })()
-
-  tryPlace()
-
-  return () => {
-    unsubscribeBody()
-    rootObserver.disconnect()
-    unsubscribeRefresh?.()
-    unsubscribeActive?.()
-    entry.remove()
-  }
-}

package/src/client/sidebar-entry.ts

@@ -1,51 +0,0 @@
-/**
- * Sidebar entry injection — package-specific wiring over the shared core.
- *
- * The DOM injection / self-healing / idempotency logic lives exactly once in
- * shared/client/sidebar-entry-core.ts (synced copy); this wrapper supplies the
- * ssh icon, copy, CSS module, and the panel toggle. The row is plain DOM (no
- * React tree) so it can never disturb the shell's reconciliation; the panel
- * view it toggles is a separate React root mounted in the center column
- * (see mount.tsx).
- */
-import type { PanelController } from './panel/controller.ts'
-import { tt } from './panel/helpers.ts'
-import css from './panel/panel.module.css'
-import { mountSidebarEntry as mountSharedSidebarEntry } from './sidebar-entry-core.ts'
-
-/** Stable data attribute identifying the injected entry row. */
-export const ENTRY_SELECTOR = '[data-dsh-ssh-entry]'
-
-/** Inline terminal glyph sized to the shell's panel-row navigation icons. */
-const ICON = '<svg viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="1.75" y="2.25" width="12.5" height="11.5" rx="1.75"/><path d="M4.25 5.25l2.75 2.75-2.75 2.75"/><path d="M8.5 10.75h3.25"/></svg>'
-
-/** Locale-change subscription the shared core asks for (ctx.locale.subscribe shape). */
-export interface LocaleRefreshSource { subscribe(listener: () => void): () => void }
-
-/**
- * Mount the sidebar entry, waiting for the shell to render and self-healing
- * on later React re-renders.
- * @param controller - the panel controller the entry toggles.
- * @param locale - locale-change source; when given, re-applies the label on
- *   a Language switch (the plain-DOM row otherwise keeps the mount-time copy).
- * @returns disposer removing the entry and its observers.
- */
-export function mountSidebarEntry(controller: PanelController, locale?: LocaleRefreshSource): () => void {
-  return mountSharedSidebarEntry({
-    rowAttribute: 'data-dsh-ssh-entry',
-    rowSelector: ENTRY_SELECTOR,
-    plugin: 'ssh',
-    icon: ICON,
-    css,
-    label: () => tt('entry.label'),
-    tooltip: () => tt('entry.tooltip'),
-    refresh: locale === undefined ? undefined : { subscribe: (listener) => locale.subscribe(listener) },
-    onToggle: () => { controller.toggle() },
-    position: 'after',
-    familySelectors: ['[data-dsh-taskboard-entry]', '[data-dsh-ssh-entry]'],
-    active: {
-      subscribe: (listener) => controller.subscribe(listener),
-      isOpen: () => controller.getSnapshot().panelOpen,
-    },
-  })
-}