@huanlin/dsh-plugin-ya-workspace-sidebar 0.3.3 → 0.6.0

package/lib/types/client/VirtualRecentList.d.ts

@@ -0,0 +1,20 @@
+/** Fixed-stride virtual scroller for the global recent-sessions block. */
+import { type ReactNode } from 'react';
+import { type SessionRow } from './model.ts';
+interface VirtualRecentListProps {
+    rows: readonly SessionRow[];
+    renderItem: (row: SessionRow) => ReactNode;
+    ariaLabel: string;
+    /** Receives the viewport element for external geometry (the drag resizer). */
+    viewportRef?: (node: HTMLDivElement | null) => void;
+    /** Overrides the stylesheet's default viewport cap, in px. */
+    maxHeight?: number;
+}
+/**
+ * Renders `rows` inside a bounded, scrollable viewport while mounting only
+ * the visible slice (plus overscan). The row stride is fixed
+ * ({@link RECENT_ROW_STRIDE}), so windowing is pure arithmetic — no per-row
+ * measurement — and the scroll position survives session-list updates.
+ */
+export declare function VirtualRecentList({ rows, renderItem, ariaLabel, viewportRef, maxHeight }: VirtualRecentListProps): import("react").JSX.Element;
+export {};

package/lib/types/client/WorkspacePicker.d.ts

@@ -1,26 +1,26 @@
-/** Existing-workspace menu plus composed directory-adoption flow. */
-import type { ReactNode, RefObject } from 'react';
-import type { WorkspaceId, WorkspaceListState, WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
-import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { DirectoryFlowOwnerProps, PickerProps } from './contract.ts';
-interface FlowProps {
-    t: PickerProps['t'];
-    open: boolean;
-    anchorRef?: RefObject<HTMLElement | null>;
-    useWorkspaces: <S>(selector: (state: WorkspaceListState) => S) => S;
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-    renderDirectoryFlow: (owner: DirectoryFlowOwnerProps) => ReactNode;
-    onPick: (workspaceId: WorkspaceId) => void;
-    onClose: () => void;
-    addOnly?: boolean;
-    side?: 'bottom' | 'top' | 'right';
-    selectedId?: WorkspaceId;
-}
-/** Render the workspace target menu and directory picking conversation. */
-export declare function WorkspacePickFlow({ t, open, anchorRef, useWorkspaces, createWorkspace, useDirectoryFlow, renderDirectoryFlow, onPick, onClose, addOnly, side, selectedId, }: FlowProps): import("react").JSX.Element;
-/** Fill the conversation hero's workspace picker seat. */
-export declare function WorkspacePicker({ open, anchorRef, useWorkspaces, selectedId, onPick, onClose, createWorkspace, useDirectoryFlow, renderSlot, t, }: PickerProps): import("react").JSX.Element;
-export {};
+/** Existing-workspace menu plus composed directory-adoption flow. */
+import type { ReactNode, RefObject } from 'react';
+import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { DirectoryFlowOwnerProps, PickerProps } from './contract.ts';
+interface FlowProps {
+    t: PickerProps['t'];
+    open: boolean;
+    anchorRef?: RefObject<HTMLElement | null>;
+    useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+    renderDirectoryFlow: (owner: DirectoryFlowOwnerProps) => ReactNode;
+    onPick: (workspaceId: WorkspaceId) => void;
+    onClose: () => void;
+    addOnly?: boolean;
+    side?: 'bottom' | 'top' | 'right';
+    selectedId?: WorkspaceId;
+}
+/** Render the workspace target menu and directory picking conversation. */
+export declare function WorkspacePickFlow({ t, open, anchorRef, useWorkspaces, createWorkspace, useDirectoryFlow, renderDirectoryFlow, onPick, onClose, addOnly, side, selectedId, }: FlowProps): import("react").JSX.Element;
+/** Fill the conversation hero's workspace picker seat. */
+export declare function WorkspacePicker({ open, anchorRef, useWorkspaces, selectedId, onPick, onClose, createWorkspace, useDirectoryFlow, renderSlot, t, }: PickerProps): import("react").JSX.Element;
+export {};

package/lib/types/client/contract.d.ts

@@ -1,68 +1,76 @@
-/** Slot contracts and injected Host actions for ya-workspace-sidebar. */
-import type { HostObservable, PropsLocale, PropsRenderSlots, PropsRuntime, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { SessionId, SessionSearchResultItem, WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
-import type { YaWorkspaceKey } from './locales.ts';
-/** Directory-picker conversation owned by each trigger surface. */
-export interface DirectoryFlowOwnerProps {
-    open: boolean;
-    busy: boolean;
-    onPicked: (path: string) => void;
-    onCancel: () => void;
-    onError: (message: string) => void;
-}
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface SlotMap {
-        'sidebar.workspaces.directoryFlow': {
-            kind: 'single';
-            scope: 'root';
-            owner: DirectoryFlowOwnerProps;
-        };
-        'conversation.hero.workspace.directoryFlow': {
-            kind: 'single';
-            scope: 'root';
-            owner: DirectoryFlowOwnerProps;
-        };
-    }
-    interface LocaleNamespaceMap {
-        'ya-workspace-sidebar': YaWorkspaceKey;
-    }
-}
-/** Shared directory-flow occupancy source. */
-export interface DirectoryInjected {
-    hooks: {
-        directoryFlow: HostObservable<boolean>;
-    };
-}
-/** Browser-private Host operations. */
-export type SidebarInjected = DirectoryInjected & {
-    startSession: (workspaceId?: WorkspaceId) => void;
-    open: (sessionId: SessionId) => void;
-    searchSessions: (query: string, signal: AbortSignal) => Promise<{
-        items: readonly SessionSearchResultItem[];
-        hasMore: boolean;
-    }>;
-    searchResultLimit: number;
-    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
-    forkSession: (sessionId: SessionId) => void;
-    renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
-    deleteWorkspace: (workspaceId: WorkspaceId) => Promise<void>;
-    archiveSession: (sessionId: SessionId) => Promise<void>;
-    insertSessionBefore: (workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId) => Promise<void>;
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-};
-/** Full sidebar component props. */
-export type SidebarProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow'> & Omit<SidebarInjected, 'hooks'> & {
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-} & PropsLocale<'ya-workspace-sidebar'>;
-/** Conversation hero picker operations. */
-export type PickerInjected = DirectoryInjected & {
-    createWorkspace: (input: {
-        path: string;
-    }) => Promise<WorkspaceView>;
-};
-/** Full conversation hero picker props. */
-export type PickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<PickerInjected, 'hooks'> & {
-    useDirectoryFlow: SnapshotSelectorHook<boolean>;
-} & PropsLocale<'ya-workspace-sidebar'>;
+/** Slot contracts and injected Host actions for ya-workspace-sidebar. */
+import type { HostObservable, PropsLocale, PropsRenderSlots, PropsRuntime, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionSearchResultItem } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceSnapshot, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { YaWorkspaceKey } from './locales.ts';
+/** Directory-picker conversation owned by each trigger surface. */
+export interface DirectoryFlowOwnerProps {
+    open: boolean;
+    busy: boolean;
+    onPicked: (path: string) => void;
+    onCancel: () => void;
+    onError: (message: string) => void;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    /** The official ui-workspace provider is disabled by this bundle's patch,
+     * so this plugin owns the global workspaces selector hook (bound from the
+     * Workspace Controller snapshot this apply installs via slots.provideRoot). */
+    interface GlobalStandardProps {
+        useWorkspaces: SnapshotSelectorHook<WorkspaceSnapshot>;
+    }
+    interface SlotMap {
+        'sidebar.workspaces.directoryFlow': {
+            kind: 'single';
+            scope: 'root';
+            owner: DirectoryFlowOwnerProps;
+        };
+        'conversation.hero.workspace.directoryFlow': {
+            kind: 'single';
+            scope: 'root';
+            owner: DirectoryFlowOwnerProps;
+        };
+    }
+    interface LocaleNamespaceMap {
+        'ya-workspace-sidebar': YaWorkspaceKey;
+    }
+}
+/** Shared directory-flow occupancy source. */
+export interface DirectoryInjected {
+    hooks: {
+        directoryFlow: HostObservable<boolean>;
+    };
+}
+/** Browser-private Host operations. */
+export type SidebarInjected = DirectoryInjected & {
+    startSession: (workspaceId?: WorkspaceId) => void;
+    open: (sessionId: SessionId) => void;
+    searchSessions: (query: string, signal: AbortSignal) => Promise<{
+        items: readonly SessionSearchResultItem[];
+        hasMore: boolean;
+    }>;
+    searchResultLimit: number;
+    renameSession: (sessionId: SessionId, title: string) => Promise<void>;
+    forkSession: (sessionId: SessionId) => void;
+    renameWorkspace: (workspaceId: WorkspaceId, title: string) => Promise<void>;
+    deleteWorkspace: (workspaceId: WorkspaceId) => Promise<void>;
+    archiveSession: (sessionId: SessionId) => Promise<void>;
+    insertSessionBefore: (workspaceId: WorkspaceId, sessionId: SessionId, beforeSessionId?: SessionId) => Promise<void>;
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+};
+/** Full sidebar component props. */
+export type SidebarProps = PropsRuntime<'sidebar.workspaces'> & PropsRenderSlots<'sidebar.workspaces.directoryFlow'> & Omit<SidebarInjected, 'hooks'> & {
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+} & PropsLocale<'ya-workspace-sidebar'>;
+/** Conversation hero picker operations. */
+export type PickerInjected = DirectoryInjected & {
+    createWorkspace: (input: {
+        path: string;
+    }) => Promise<WorkspaceView>;
+};
+/** Full conversation hero picker props. */
+export type PickerProps = PropsRuntime<'conversation.hero.workspace'> & PropsRenderSlots<'conversation.hero.workspace.directoryFlow'> & Omit<PickerInjected, 'hooks'> & {
+    useDirectoryFlow: SnapshotSelectorHook<boolean>;
+} & PropsLocale<'ya-workspace-sidebar'>;

package/lib/types/client/index.d.ts

@@ -1,5 +1,9 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-/** Services required by both replacement client entries. */
-export declare const inject: string[];
-/** Register the sidebar browser and conversation hero picker. */
-export declare function apply(ctx: ClientContext): void;
+/** Client assembly for the replacement workspace sidebar and hero picker. */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Services required by the replacement client entries. `remote` and
+ * `remote.directoryPicker` feed the uiWorkspace stand-in's directory picking.
+ */
+export declare const inject: string[];
+/** Register the sidebar browser and conversation hero picker. */
+export declare function apply(ctx: Context): void;

package/lib/types/client/locales.d.ts

@@ -1,111 +1,113 @@
-/** Product copy for the replacement workspace browser. */
-export declare const zh: {
-    workspaces: string;
-    sessions: string;
-    recent: string;
-    ungrouped: string;
-    newSession: string;
-    addWorkspace: string;
-    addWorkspaceMenu: string;
-    search: string;
-    searchPlaceholder: string;
-    clearSearch: string;
-    searching: string;
-    searchUnavailable: string;
-    noMatches: string;
-    noSessions: string;
-    noWorkspaces: string;
-    loading: string;
-    rename: string;
-    renameWorkspace: string;
-    renameSession: string;
-    deleteWorkspace: string;
-    deleteDescription: string;
-    fork: string;
-    archive: string;
-    archiveMode: string;
-    deleteMode: string;
-    deleteSession: string;
-    deleteSessionTitle: string;
-    deleteSessionConfirm: string;
-    toggleActionMode: string;
-    actionModeLabel: string;
-    cancel: string;
-    confirm: string;
-    retry: string;
-    folderError: string;
-    workspaceName: string;
-    sessionName: string;
-    count: string;
-    now: string;
-    minutes: string;
-    hours: string;
-    days: string;
-    months: string;
-    years: string;
-    running: string;
-    waiting: string;
-    completed: string;
-    collapse: string;
-    expand: string;
-    today: string;
-    yesterday: string;
-    date: string;
-    dateYear: string;
-};
-export type YaWorkspaceKey = keyof typeof zh;
-export declare const en: {
-    workspaces: string;
-    sessions: string;
-    recent: string;
-    ungrouped: string;
-    newSession: string;
-    addWorkspace: string;
-    addWorkspaceMenu: string;
-    search: string;
-    searchPlaceholder: string;
-    clearSearch: string;
-    searching: string;
-    searchUnavailable: string;
-    noMatches: string;
-    noSessions: string;
-    noWorkspaces: string;
-    loading: string;
-    rename: string;
-    renameWorkspace: string;
-    renameSession: string;
-    deleteWorkspace: string;
-    deleteDescription: string;
-    fork: string;
-    archive: string;
-    archiveMode: string;
-    deleteMode: string;
-    deleteSession: string;
-    deleteSessionTitle: string;
-    deleteSessionConfirm: string;
-    toggleActionMode: string;
-    actionModeLabel: string;
-    cancel: string;
-    confirm: string;
-    retry: string;
-    folderError: string;
-    workspaceName: string;
-    sessionName: string;
-    count: string;
-    now: string;
-    minutes: string;
-    hours: string;
-    days: string;
-    months: string;
-    years: string;
-    running: string;
-    waiting: string;
-    completed: string;
-    collapse: string;
-    expand: string;
-    today: string;
-    yesterday: string;
-    date: string;
-    dateYear: string;
-};
-export declare const NS = "ya-workspace-sidebar";
+/** Product copy for the replacement workspace browser. */
+export declare const zh: {
+    workspaces: string;
+    sessions: string;
+    recent: string;
+    ungrouped: string;
+    newSession: string;
+    addWorkspace: string;
+    addWorkspaceMenu: string;
+    search: string;
+    searchPlaceholder: string;
+    clearSearch: string;
+    searching: string;
+    searchUnavailable: string;
+    noMatches: string;
+    noSessions: string;
+    noWorkspaces: string;
+    loading: string;
+    rename: string;
+    renameWorkspace: string;
+    renameSession: string;
+    deleteWorkspace: string;
+    deleteDescription: string;
+    fork: string;
+    archive: string;
+    archiveMode: string;
+    deleteMode: string;
+    deleteSession: string;
+    deleteSessionTitle: string;
+    deleteSessionConfirm: string;
+    toggleActionMode: string;
+    actionModeLabel: string;
+    cancel: string;
+    confirm: string;
+    retry: string;
+    folderError: string;
+    workspaceName: string;
+    sessionName: string;
+    count: string;
+    now: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    months: string;
+    years: string;
+    running: string;
+    waiting: string;
+    completed: string;
+    collapse: string;
+    expand: string;
+    resizeRecent: string;
+    today: string;
+    yesterday: string;
+    date: string;
+    dateYear: string;
+};
+export type YaWorkspaceKey = keyof typeof zh;
+export declare const en: {
+    workspaces: string;
+    sessions: string;
+    recent: string;
+    ungrouped: string;
+    newSession: string;
+    addWorkspace: string;
+    addWorkspaceMenu: string;
+    search: string;
+    searchPlaceholder: string;
+    clearSearch: string;
+    searching: string;
+    searchUnavailable: string;
+    noMatches: string;
+    noSessions: string;
+    noWorkspaces: string;
+    loading: string;
+    rename: string;
+    renameWorkspace: string;
+    renameSession: string;
+    deleteWorkspace: string;
+    deleteDescription: string;
+    fork: string;
+    archive: string;
+    archiveMode: string;
+    deleteMode: string;
+    deleteSession: string;
+    deleteSessionTitle: string;
+    deleteSessionConfirm: string;
+    toggleActionMode: string;
+    actionModeLabel: string;
+    cancel: string;
+    confirm: string;
+    retry: string;
+    folderError: string;
+    workspaceName: string;
+    sessionName: string;
+    count: string;
+    now: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    months: string;
+    years: string;
+    running: string;
+    waiting: string;
+    completed: string;
+    collapse: string;
+    expand: string;
+    resizeRecent: string;
+    today: string;
+    yesterday: string;
+    date: string;
+    dateYear: string;
+};
+export declare const NS = "ya-workspace-sidebar";

package/lib/types/client/model.d.ts

@@ -1,53 +1,87 @@
-/** Pure sidebar projections shared by the browser and unit tests. */
-import type { SessionId, SessionListState, SessionSummary, WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
-/** Navigation key for sessions not accounted to a real workspace. */
-export declare const UNGROUPED: "__ya_ungrouped__";
-/** One sidebar session row. */
-export interface SessionRow {
-    id: SessionId;
-    title: string;
-    blank: boolean;
-    running: boolean;
-    pendingInteraction?: SessionSummary['pendingInteraction'];
-    completed: boolean;
-    updatedAt: number;
-    workspaceKey: WorkspaceId | typeof UNGROUPED;
-    workspaceTitle: string;
-}
-/** One date-bucketed group of session rows for the real-workspace level. */
-export interface SessionDateGroup {
-    /** Local calendar date `YYYY-MM-DD`, stable key. */
-    dateKey: string;
-    /** Days between today's local date and this group's local date (0=today, 1=yesterday, …). */
-    dayOffset: number;
-    rows: SessionRow[];
-}
-/** One first-level workspace row. */
-export interface WorkspaceRow {
-    key: WorkspaceId | typeof UNGROUPED;
-    title: string;
-    path?: string;
-    createdAt?: string;
-    count: number;
-    real: boolean;
-}
-/** Resolve the first/second-level destination for one session. */
-export declare function workspaceKeyForSession(sessionId: SessionId | undefined, workspaces: readonly WorkspaceView[]): WorkspaceId | typeof UNGROUPED | null;
-/** Derive global recent sessions, newest first. */
-export declare function deriveRecent(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], limit?: number): SessionRow[];
-/** Derive first-level real workspaces plus the virtual Ungrouped row. */
-export declare function deriveWorkspaces(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[]): WorkspaceRow[];
-/** Derive the selected workspace's sessions in its canonical order. */
-export declare function deriveWorkspaceSessions(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[]): SessionRow[];
-/**
- * Derive the selected real workspace's sessions grouped by local calendar date.
- *
- * - Only real workspaces: `Ungrouped` falls back to {@link deriveWorkspaceSessions}.
- * - Groups are ordered by date descending; rows within a group by `updatedAt` descending.
- * - {@link visible} filter is reused (archived / subagent / blank visibility).
- * - Future timestamps clamp to today's bucket (`dayOffset` 0).
- * - `now` is the reference timestamp for "today"; pass `Date.now()` in production.
- */
-export declare function deriveWorkspaceSessionGroups(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], now: number): SessionDateGroup[];
-/** Case-insensitive local title/workspace matching used beside Host content search. */
-export declare function localMatches(rows: readonly SessionRow[], query: string): SessionRow[];
+/** Pure sidebar projections shared by the browser and unit tests. */
+import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { WorkspaceId, WorkspaceView } from '@deepseek-ai/dsh-api-workspace-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+/** Pending-interaction kinds surfaced as a row status dot. */
+export type PendingInteractionKind = 'approval' | 'plan-review' | 'question';
+/** Renderer-visible view of ui-session's pending-interaction snapshot entries. */
+export type PendingInteractionEntry = {
+    readonly kind: string;
+};
+/** Pending-interaction snapshot consumed by the derive functions. */
+export type PendingInteractionMap = ReadonlyMap<SessionId, PendingInteractionEntry>;
+/** Navigation key for sessions not accounted to a real workspace. */
+export declare const UNGROUPED: "__ya_ungrouped__";
+/** One sidebar session row. */
+export interface SessionRow {
+    id: SessionId;
+    title: string;
+    blank: boolean;
+    running: boolean;
+    pendingInteraction?: PendingInteractionKind;
+    completed: boolean;
+    updatedAt: number;
+    workspaceKey: WorkspaceId | typeof UNGROUPED;
+    workspaceTitle: string;
+}
+/** One date-bucketed group. Empty `dateKey` is the undated trailing bucket. */
+export interface DateGroup<T> {
+    /** Local calendar date `YYYY-MM-DD`, or `''` for rows with no timestamp. */
+    dateKey: string;
+    /** Days between today's local date and this group's local date (0=today, 1=yesterday, …). */
+    dayOffset: number;
+    rows: T[];
+}
+/** One date-bucketed group of session rows for the real-workspace level. */
+export type SessionDateGroup = DateGroup<SessionRow>;
+/** One date-bucketed group of first-level workspace rows. */
+export type WorkspaceDateGroup = DateGroup<WorkspaceRow>;
+/** One first-level workspace row. */
+export interface WorkspaceRow {
+    key: WorkspaceId | typeof UNGROUPED;
+    title: string;
+    path?: string;
+    createdAt?: string;
+    /** Newest visible session `updatedAt`; empty real workspaces fall back to `createdAt`. */
+    lastUsedAt?: number;
+    count: number;
+    real: boolean;
+}
+/** Resolve the first/second-level destination for one session. */
+export declare function workspaceKeyForSession(sessionId: SessionId | undefined, workspaces: readonly WorkspaceView[]): WorkspaceId | typeof UNGROUPED | null;
+/** Derive global recent sessions, newest first. */
+export declare function deriveRecent(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, limit?: number): SessionRow[];
+/** Fixed occupied height of one recent-sessions row: 33px two-line row + 2px vertical margins. */
+export declare const RECENT_ROW_STRIDE = 35;
+/** Half-open render window `[start, end)` of a fixed-stride virtual list. */
+export interface VirtualWindow {
+    start: number;
+    end: number;
+}
+/**
+ * Windowing math for the recent-sessions virtual list (fixed row stride).
+ *
+ * Clamps `scrollTop` into the valid range, then pads the visible row range
+ * with `overscan` rows on both edges. Before the viewport has been measured
+ * (`viewportHeight <= 0`) it still returns a small head window so the first
+ * paint is never blank.
+ */
+export declare function virtualWindow(scrollTop: number, viewportHeight: number, count: number, stride?: number, overscan?: number): VirtualWindow;
+/** Derive first-level workspaces plus Ungrouped, newest session activity first. */
+export declare function deriveWorkspaces(list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[]): WorkspaceRow[];
+/** Derive the selected workspace's sessions in its canonical order. */
+export declare function deriveWorkspaceSessions(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap): SessionRow[];
+/**
+ * Derive the selected real workspace's sessions grouped by local calendar date.
+ *
+ * - Only real workspaces: `Ungrouped` falls back to {@link deriveWorkspaceSessions}.
+ * - Groups are ordered by date descending; rows within a group by `updatedAt` descending.
+ * - {@link visible} filter is reused (archived / subagent / blank visibility).
+ * - Future timestamps clamp to today's bucket (`dayOffset` 0).
+ * - `now` is the reference timestamp for "today"; pass `Date.now()` in production.
+ */
+export declare function deriveWorkspaceSessionGroups(key: WorkspaceId | typeof UNGROUPED, list: SessionListState, workspaces: readonly WorkspaceView[], archivedSessionIds: readonly SessionId[], pending: PendingInteractionMap, now: number): SessionDateGroup[];
+/** Group root workspace rows by local calendar date of `lastUsedAt`; undated rows trail with empty `dateKey`. */
+export declare function deriveWorkspaceGroups(rows: readonly WorkspaceRow[], now: number): WorkspaceDateGroup[];
+/** Case-insensitive local title/workspace matching used beside Host content search. */
+export declare function localMatches(rows: readonly SessionRow[], query: string): SessionRow[];