@sidequest-007/dsh-atlas 1.0.0

package/lib/types/client/reference-links.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The two pure pieces of the sent-message click-through: decoding one rendered
+ * reference chip back into the action it can offer, and spelling the file
+ * address the right Sidebar resolves.
+ *
+ * Both are pure string work so the browser bridge (`ReferenceLinks.tsx`) stays a
+ * thin event adapter, and so the address grammar can be pinned against the
+ * Harness's own implementation in the tests instead of being trusted by eye.
+ */
+/** One mention of an already sent message that a click can act on. */
+export type ReferenceLink = {
+    readonly kind: 'file';
+    readonly path: string;
+}
+/** A directory: no in-product viewer, so the Host opener (file manager) gets it. */
+ | {
+    readonly kind: 'folder';
+    readonly path: string;
+} | {
+    readonly kind: 'skill';
+    readonly name: string;
+}
+/** A seam provider's item; only that provider's own `open` knows what it means. */
+ | {
+    readonly kind: 'atlas';
+    readonly provider: string;
+    readonly item: string;
+};
+/**
+ * Decode one reference chip's raw label (its `title`) into the action it offers.
+ *
+ * The chip's own `title` is the label the framework decorated, verbatim:
+ * `@path/to/file.ts`, `@"path with spaces.md"`, `@skill:name`, `@plugin:name`,
+ * `@atlas:provider/item`, `@[label](dsh-session:…)`, or an out-of-workspace
+ * absolute path (`@E:\…` / `@E:/…`, whose drive letter is a path, not a handle).
+ * Only a workspace file, a quoted path, an absolute path, a skill (whose source
+ * the skill source opens) and a provider item (whose meaning belongs to that
+ * provider) name something to act on. A trailing separator is a folder mention
+ * (its chip kind is `folder`), and a colon in the first segment is our own handle
+ * spelling unless it is a drive letter.
+ * @param title - the chip's `title` attribute (the undecorated label).
+ * @returns the mention, or undefined when there is nothing to open.
+ */
+export declare function decodeReferenceLink(title: string | null | undefined): ReferenceLink | undefined;
+/**
+ * Decode one DRAFT reference token the client activated in the composer.
+ *
+ * Same vocabulary as {@link decodeReferenceLink}, plus the one form the editor
+ * decorates by syntax rather than by name: a trailing separator marks a folder
+ * mention (`@src/`), whose chip kind is its own and whose click opens the
+ * directory through the Host opener.
+ * @param token - the activated token, trigger included (e.g. `@src/a.ts`).
+ * @returns the mention, or undefined when nothing can be opened.
+ */
+export declare function decodeDraftReference(token: string): ReferenceLink | undefined;
+/**
+ * The address of a workspace-relative file in one session: the Harness's
+ * `dsh-resource://file/session/<sessionId>/<path>` form, spelled here so the
+ * browser bundle needs no new runtime dependency. Backslashes are normalized
+ * and a leading `./` is dropped, exactly as the Harness normalizes them; every
+ * segment is component-encoded so spaces, `#` and `?` survive the round trip.
+ * `tests/reference-links.spec.tsx` pins this against the Harness function.
+ * @param sessionId - the session whose Host workspace resolves the path.
+ * @param path - workspace-relative path in either separator spelling.
+ * @returns the file address the right Sidebar claims.
+ */
+export declare function sessionFileAddress(sessionId: string, path: string): string;
+/**
+ * The address of a file or directory OUTSIDE the session workspace: the
+ * Harness's second file-address scope, `dsh-resource://file/absolute/<path>`
+ * (leading separator dropped, a drive letter kept literal, UNC keeping its empty
+ * first segment). Out-of-workspace references carry absolute paths, so this is
+ * the address the sidebar is asked for. A sidebar that refuses to read outside
+ * the workspace (`ui-sidebar-files` says so in its own words) fails harmlessly
+ * and the caller keeps the Host opener as the effective action.
+ * @param path - absolute path in either separator spelling.
+ * @returns the file address the right Sidebar claims, or falls back from.
+ */
+export declare function absoluteFileAddress(path: string): string;
+/**
+ * The address of one folder, in this plugin's OWN resource type.
+ *
+ * A directory cannot ride the `file` type: `dsh-resource://file/…` is claimed by
+ * the file viewers, which answer a directory with `"…" is a directory`, and the
+ * `files` tab is a PAGE — a tree rooted at the session workspace — that claims no
+ * address at all. So the plugin registers a `folder` type of its own and opens
+ * folders through it, which is also the only way an out-of-workspace folder can
+ * reach the sidebar. The path is absolute (the opener resolves a workspace folder
+ * first); every segment is component-encoded so spaces, `#`, `?` and a drive
+ * colon survive the round trip.
+ * @param path - absolute folder path in either separator spelling.
+ * @returns the folder address this plugin's tab claims.
+ */
+export declare function folderAddress(path: string): string;
+/**
+ * The folder one address names, or undefined when it is not ours.
+ * @param address - a resource address.
+ * @returns the absolute path in canonical (forward-slash) spelling.
+ */
+export declare function folderPathOf(address: string | undefined): string | undefined;

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

@@ -0,0 +1,54 @@
+/**
+ * The client-side Typert Remote contribution for the dsh-atlas host
+ * services: mounts the shared strict descriptors into `ctx.remote` under the
+ * `atFile` and `atMention` namespaces. The descriptors and codecs come from
+ * the shared contract module, so the browser bundle and the host manifest
+ * stay on one wire definition. One contribution per package face: both
+ * namespaces ride the same `dsh-atlas` package.
+ */
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { AtlasRuntimeInfo } from '../atlas.ts';
+import type { AtFileSettings, AtFileSettingsUpdate, ChatCandidate, DirectoryListing, GitChange, PluginCandidate, ReferenceInfo, SkillCandidate } from '../contract.ts';
+export type { DirectoryEntry, DirectoryListing, FileEntry, SkillCandidate, ChatCandidate, PluginCandidate, GitChange } from '../contract.ts';
+/** The combined Remote namespace contribution (one package face). */
+export declare const AT_REMOTE: TypertRemoteContribution;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    /** The `atFile` namespace face. */
+    interface TypertRemoteNamespace$617446696c65 {
+        search: (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly import('../contract.ts').FileEntry[]>>;
+        inspect: (agentId: SessionId, targets: readonly string[], signal?: AbortSignal) => Promise<RemoteResult<readonly ReferenceInfo[]>>;
+        getSettings: () => Promise<RemoteResult<AtFileSettings>>;
+        updateSettings: (update: AtFileSettingsUpdate) => Promise<RemoteResult<AtFileSettings>>;
+        list: (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<DirectoryListing>>;
+    }
+    /** The `atlas` namespace face (host half of the @ data-source seam). */
+    interface TypertRemoteNamespace$61746c6173 {
+        runtime: (signal?: AbortSignal) => Promise<RemoteResult<AtlasRuntimeInfo>>;
+        gitChanges: (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly GitChange[]>>;
+    }
+    /** The `atMention` namespace face. */
+    interface TypertRemoteNamespace$61744d656e74696f6e {
+        listSkills: (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly SkillCandidate[]>>;
+        listChats: (agentId: SessionId, query: string, limit: number, signal?: AbortSignal) => Promise<RemoteResult<readonly ChatCandidate[]>>;
+        listPlugins: (signal?: AbortSignal) => Promise<RemoteResult<readonly PluginCandidate[]>>;
+    }
+    interface TypertRemoteMap {
+        'atFile/search': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly import('../contract.ts').FileEntry[]>>;
+        'atFile/inspect': (agentId: SessionId, targets: readonly string[], signal?: AbortSignal) => Promise<RemoteResult<readonly ReferenceInfo[]>>;
+        'atFile/external': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<import('../contract.ts').ExternalAccessScope>>;
+        'atFile/list': (agentId: SessionId, path: string, signal?: AbortSignal) => Promise<RemoteResult<DirectoryListing>>;
+        'atFile/getSettings': () => Promise<RemoteResult<AtFileSettings>>;
+        'atFile/updateSettings': (update: AtFileSettingsUpdate) => Promise<RemoteResult<AtFileSettings>>;
+        'atMention/listSkills': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly SkillCandidate[]>>;
+        'atMention/listChats': (agentId: SessionId, query: string, limit: number, signal?: AbortSignal) => Promise<RemoteResult<readonly ChatCandidate[]>>;
+        'atMention/listPlugins': (signal?: AbortSignal) => Promise<RemoteResult<readonly PluginCandidate[]>>;
+        'atlas/runtime': (signal?: AbortSignal) => Promise<RemoteResult<AtlasRuntimeInfo>>;
+        'atlas/gitChanges': (agentId: SessionId, signal?: AbortSignal) => Promise<RemoteResult<readonly GitChange[]>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        atFile: TypertRemoteNamespace$617446696c65;
+        atMention: TypertRemoteNamespace$61744d656e74696f6e;
+        atlas: TypertRemoteNamespace$61746c6173;
+    }
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Pure file-search ranking for the @file menu. A plain query matches basenames
+ * only, so letters spread across a long generated path cannot create false
+ * positives. Queries containing a slash match path segments in order. The
+ * empty query remains a directory-first alphabetical browse view.
+ */
+import type { FileEntry } from './remote.ts';
+/** Ranked top-N paths matching `query` (ties break by kind, length, then path). */
+export declare function rankFiles(files: readonly FileEntry[], query: string, limit: number): readonly FileEntry[];

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

@@ -0,0 +1,325 @@
+/**
+ * The '@' input-trigger source: turns the ui-input-trigger pipeline into the
+ * category-based mention picker. An empty query shows the category rows
+ * (files, folders, skills, past chats, plugins); typing without choosing
+ * shows a mixed result list that prioritizes files/folders/skills while the
+ * category rows stay pinned; `file:`, `folder:`, `skill:`, `chat:`,
+ * `plugin:` prefixes enter one category. Picks land plain-text tokens that
+ * the Host's pre-step boundary validates and expands into sourced references.
+ * Pure factory over injected deps: the browser bundle wires the real Remotes
+ * and clock, tests wire stubs.
+ */
+import type { InputTriggerCandidate, InputTriggerSource, TokenSpan } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ChatCandidate, FileEntry, PluginCandidate, SkillCandidate } from './remote.ts';
+import type { DirectoryListing, ExternalAccessScope, UsageEntry } from '../contract.ts';
+import type { AtlasRegistration } from '../atlas.ts';
+import type { SkillTier } from '../contract.ts';
+import { type ReferenceLink } from './reference-links.ts';
+declare module '@deepseek-ai/dsh-client-ui-input-trigger/client' {
+    interface InputTriggerCandidate {
+        /** Source-owned stable value when the visible name is only a display label. */
+        readonly value?: string;
+        /** Indexed path kind used by source-owned keyboard navigation. */
+        readonly atFileKind?: FileEntry['kind'];
+        /** Routing kind for the category state machine and the dock. */
+        readonly mentionKind?: MentionKind;
+        /** Host-built `dsh-session:` URI for one chat candidate row. */
+        readonly chatUri?: string;
+        /** Stable collapse key for group header rows (chat:/skill:). */
+        readonly groupKey?: string;
+        /** Recent-file rows may be pickable before the workspace index settles. */
+        readonly recent?: boolean;
+    }
+}
+/** One mention row kind the picker and the dock both understand. */
+export type MentionKind = 'category' | 'back' | 'file' | 'dir' | 'skill' | 'chat' | 'plugin' | 'provider' | 'chat-group' | 'skill-group' | 'plugin-group' | 'section-header' | 'dir-group' | 'folder-choose' | 'browse-up' | 'browse-dir' | 'browse-file' | 'browse-drive' | 'browse-note';
+/** Owner source name (the lexicon and decoration routing key). */
+export declare const SOURCE_NAME = "atlas";
+/** Design cap on visible picker rows (the menu height is maximized by CSS). */
+export declare const MAX_CANDIDATES = 20;
+/** How many provider rows one mixed search may contribute in total. */
+export declare const PROVIDER_MIX_LIMIT = 6;
+/** How long one session's index stays hot before the next menu open refetches. */
+export declare const INDEX_TTL_MS = 30000;
+/** How long the per-session skill list and the global plugin list stay hot. */
+export declare const CATEGORY_TTL_MS = 30000;
+/** One preloaded page of past-chat candidates (menu height is 12; 20 gives headroom). */
+export declare const CHAT_PAGE = 20;
+/** One category key (folder rows are routed as dir mentions). */
+export type CategoryKey = 'file' | 'folder' | 'skill' | 'chat' | 'plugin' | 'provider';
+/** One selectable category row. */
+export interface CategoryDef {
+    readonly key: CategoryKey;
+    /** The draft prefix that enters this category (`@skill:` etc.). */
+    readonly prefix: string;
+    /** Built-in Chinese label, used when no locale binder is wired. */
+    readonly name: string;
+    /** Locale key of the displayed label (see client/locales.ts). */
+    readonly nameKey: string;
+    /** Single-letter shortcut shown in the menu and accepted after `@`. */
+    readonly shortcut: string;
+    /** English name prefix matched for completion (e.g. `pl` → plugin). */
+    readonly english: string;
+    /**
+     * Set on rows built from a registered `@` seam provider: it is the provider
+     * handle whose `list` fills the category and whose `resolve` the pick routes to.
+     */
+    readonly providerId?: string;
+}
+/** Locale binder shape shared by the row builders (dictionary key → copy). */
+export type Translate = (key: string, params?: Record<string, string>) => string;
+/** The five categories, shown in menu order. */
+export declare const CATEGORIES: readonly CategoryDef[];
+/**
+ * Build the menu categories for the currently registered `@` seam providers.
+ *
+ * These are dynamic rows: a provider that registers while the app runs shows up
+ * on the next menu open, and one that disposes disappears with it. A provider
+ * claims a shortcut letter when it can — the first letter of its id, upper-cased,
+ * and only while no built-in category (or an earlier provider) already answers to
+ * it. A letter that means two things is worse than no letter, and the explicit
+ * `@<id>:` prefix always works either way.
+ * @param providers - the live registrations from the seam registry.
+ * @returns one category definition per provider, in registration order.
+ */
+export declare function providerCategories(providers: readonly {
+    readonly id: string;
+    readonly display: string;
+}[]): readonly CategoryDef[];
+/** Everything the source needs that the browser bundle supplies (tests stub). */
+export interface MentionSourceDeps {
+    /** Search the addressed session's workspace index (Remote wrapper). */
+    search(sessionId: SessionId, signal: AbortSignal): Promise<readonly FileEntry[]>;
+    /** List discoverable skills for the addressed session (Remote wrapper). */
+    listSkills?(sessionId: SessionId, signal: AbortSignal): Promise<readonly SkillCandidate[]>;
+    /** List past-session candidates for the addressed session (Remote wrapper). */
+    listChats?(sessionId: SessionId, query: string, limit: number, signal: AbortSignal): Promise<readonly ChatCandidate[]>;
+    /** List installed plugins (Remote wrapper). */
+    listPlugins?(signal: AbortSignal): Promise<readonly PluginCandidate[]>;
+    /** Monotonic clock for index freshness (default Date.now). */
+    now?: () => number;
+    /** Locale binder for time/tier labels (defaults to zh copy). */
+    t?: (key: string, params?: Record<string, string>) => string;
+    /** Record one referenced path into the session workspace's recent list. */
+    onRecent?(sessionId: SessionId, relative: string): void;
+    /** Record one pick in the cross-category usage counters. */
+    onUsage?(sessionId: SessionId, kind: string, value: string): void;
+    /** The live cross-category pick counters (highest count first). */
+    usage?(): readonly UsageEntry[];
+    /**
+     * The live `@` seam providers. Called on every menu request; a provider that
+     * is not registered here is never listed, so registration stays the gate.
+     */
+    atlasProviders?(): readonly AtlasRegistration[];
+    /** The session workspace's recent-file list for one workspace, most recent first. */
+    recentFiles?(sessionId: SessionId, workspace: string): readonly string[];
+    /**
+     * The Host's out-of-workspace scope for one session: whether it may discover
+     * external paths, and the external folders `@folder:` may offer. The Host owns
+     * this verdict (settings plus the resolved sandbox policy); the source only
+     * renders what it returns.
+     */
+    external?(sessionId: SessionId, signal: AbortSignal): Promise<ExternalAccessScope>;
+    /**
+     * One bounded, one-level directory listing (the folder browser's data). The Host
+     * gates an out-of-workspace path exactly as it gates a reference, and answers a
+     * refusal as a reason, so a missing member simply means "no browser here".
+     */
+    list?(sessionId: SessionId, path: string, signal: AbortSignal): Promise<DirectoryListing>;
+    /**
+     * The folder the composer's DRAFT is scoped by (R-05): the nearest folder
+     * reference typed before the active category token. `@e:/work/docs/ @file:` therefore
+     * lists that folder's files — the scope is positional, so no connective word is
+     * needed. Undefined when the draft names none, which is this view's behaviour
+     * before the scope existed.
+     */
+    scopeFolder?(sessionId: SessionId, signal: AbortSignal): Promise<string | undefined>;
+    /**
+     * Open the product's own folder chooser for one draft token span, answering
+     * whether this build has one. The chooser is asynchronous (a native or in-app
+     * dialog), so it takes over the insertion itself; a `false` answer lets the
+     * source fall back to its own in-menu walk.
+     */
+    chooseFolder?(sessionId: SessionId, span: TokenSpan): boolean;
+    /**
+     * The click action for one mention of the draft, or undefined when this build
+     * has none. Used by {@link InputTriggerSource.openReference}: a client that
+     * activates a reference token in the composer asks its owning source to open
+     * it, and the plugin answers with the same action the sent-message bridge uses.
+     */
+    actionFor?(sessionId: SessionId, link: ReferenceLink): (() => void) | undefined;
+}
+/** The registered source plus the cache teardown the wiring layer owns. */
+export interface MentionSource {
+    readonly source: InputTriggerSource;
+    /** Drop every per-session cache and path map (connection reset). */
+    invalidateAll(): void;
+    /** Drop one session's out-of-workspace scope (a sent reference may have grown the ledger). */
+    invalidateExternal(sessionId: SessionId): void;
+    /** Toggle one group header's collapse state for a session (menu re-tracks). */
+    toggleGroup(sessionId: SessionId, key: string): void;
+    /** Whether a group header is currently collapsed for a session. */
+    isCollapsed(sessionId: SessionId, key: string): boolean;
+    /**
+     * Rebuild the candidate rows for one category query synchronously from the
+     * settled caches (instant collapse without a refetch). Returns undefined
+     * when the needed cache is not settled yet — callers fall back to a refresh.
+     */
+    rebuildRows(sessionId: SessionId, query: string): readonly MentionCandidate[] | undefined;
+}
+/** One picker row with a stable value and routing kind. */
+interface MentionCandidate extends InputTriggerCandidate {
+    readonly value: string;
+    readonly mentionKind: MentionKind;
+    /** Set on provider rows: whose `resolve` the committed reference routes to. */
+    readonly providerId?: string;
+    /** Set on the Tab-completion hint, which is the row the highlight belongs on. */
+    readonly completionHint?: true;
+}
+/** Resolve the active category from a `file:`-style query prefix. */
+export declare function categoryOfQuery(query: string, providers?: readonly CategoryDef[]): CategoryDef | undefined;
+/**
+ * The always-pinned category rows for the empty/mixed view.
+ * @param t - locale binder.
+ * @param providers - the live `@` seam providers, appended after the built-ins.
+ * @returns the category rows in menu order.
+ */
+export declare function categoryRows(t?: Translate, providers?: readonly CategoryDef[]): readonly MentionCandidate[];
+/**
+ * Resolve the single category the user's typed query points at, or undefined
+ * when it is ambiguous.
+ *
+ * A query matching exactly one shortcut letter (F/D/S/C/P, plus whatever letter
+ * a registered provider claimed — `G` for `@git`) or exactly one English name
+ * prefix (fi/fo/sk/ch/pl…, and a provider's own id, so `gi` reaches git) wins;
+ * otherwise the completion stays unavailable so plain mixed search keeps working.
+ * @param query - the text after the trigger.
+ * @param providers - the live provider categories, which compete on equal terms.
+ * @returns the category the query names, or undefined.
+ */
+export declare function completionTarget(query: string, providers?: readonly CategoryDef[]): CategoryDef | undefined;
+/**
+ * The hint row a completion query puts at the END of the list.
+ *
+ * It is a category row like the one it repeats (same `value`, so a pick enters
+ * the same `@<category>:` prefix) plus `completionHint`, which is the flag the
+ * navigator uses to land the default highlight here: the menu opens above the
+ * composer, so the last row is the one closest to the caret and the eye stays in
+ * the bottom band instead of jumping to the top of the list.
+ */
+export declare function hintRow(category: CategoryDef, t?: Translate): MentionCandidate;
+/** The row tag for one mention kind, localized when a binder is supplied. */
+export declare function categoryTag(kind: 'file' | 'folder' | 'skill' | 'chat' | 'plugin', t?: Translate): string;
+/** The back row shown inside one category. */
+export declare function backRow(t?: Translate): MentionCandidate;
+/** A non-pickable section divider row (e.g. 最近引用 / 全部匹配). */
+export declare function sectionHeaderRow(label: string): MentionCandidate;
+/** Relative-time buckets, mirroring the sidebar workspace rows. */
+export interface RelativeTime {
+    readonly unit: 'now' | 'minutes' | 'hours' | 'days' | 'months' | 'years';
+    readonly n: number;
+}
+/** Compact relative time ("刚刚"/"5分钟"…), same buckets as the sidebar. */
+export declare function relativeTime(updatedAt: number, now: number): RelativeTime;
+/** Render one relative time as the sidebar does ("刚刚"/"5分钟"/"2天"). */
+export declare function relativeTimeLabel(updatedAt: number, now: number, t?: (key: string, params?: Record<string, string>) => string): string;
+/** Skill tier labels (mirror the sidebar Skill Manager grouping). */
+export declare const TIER_ORDER: readonly SkillTier[];
+/**
+ * Clean a session title for display and the mention token: trim, drop leading
+ * markdown heading markers (#), collapse internal whitespace, cap at 40 chars.
+ */
+export declare function cleanChatLabel(label: string): string;
+/** The workspace title for one chat group (basename; 未分组 for none). */
+export declare function workspaceTitle(cwd: string | undefined, t?: Translate): string;
+/**
+ * Damerau–Levenshtein distance between two short strings (optimal string
+ * alignment). Used for typo-tolerant mention search.
+ */
+export declare function editDistance(a: string, b: string): number;
+/**
+ * Typo-tolerant match: substring OR any word token of the field within edit
+ * distance (1 for short queries, 2 for queries of 8+ chars). Enables e.g.
+ * `qulity` → `animation-quality-gate` via its `quality` token.
+ */
+export declare function matchesFuzzy(query: string, ...fields: readonly string[]): boolean;
+/**
+ * Rank files for one query, falling back to typo tolerance only when the exact
+ * ranking returns nothing — so a near miss can never displace an exact match.
+ * @param files - the workspace index.
+ * @param query - the user's query.
+ * @param limit - maximum rows.
+ * @returns the ranked entries.
+ */
+export declare function rankFilesWithFuzzy(files: readonly FileEntry[], query: string, limit: number): readonly FileEntry[];
+/**
+ * The directory a draft query asks to walk, or undefined when it is a search.
+ *
+ * Both spellings reach the browser: the bare mention the browser's own picks write
+ * (`@E:/…/`) and the category form a user may type (`@folder:E:/…`). A drive letter
+ * alone is its root, so `@folder:E:` is enough to leave the drive you are on. A
+ * FILE path is not a special case: it browses the directory it lives in, where the
+ * file itself is a row — which is what makes typing a path feel like a path.
+ * @param query - the live query (text after `@`).
+ * @returns the absolute directory to list, or undefined for an ordinary search.
+ */
+export declare function browseTarget(query: string): string | undefined;
+/** The collapse key of the out-of-workspace folder group. */
+export declare const OUTSIDE_GROUP_KEY = "folder:outside";
+/** The collapse key of the workspace folder group. */
+export declare const WORKSPACE_GROUP_KEY = "folder:workspace";
+/**
+ * How many rows the folder category shows at most (headers included).
+ *
+ * The user's口径: the visible area must always be the folders whose NAME matched —
+ * workspace first, then outside — and the folder view must not FOLD rows away to
+ * stay short. Beyond what fits on screen the menu SCROLLS (with PageUp/PageDown,
+ * and the focus row is kept visible), so this is only the hard ceiling that keeps
+ * one category from flooding the menu; the name matches still claim the top rows
+ * and the path-only group fills whatever is left.
+ */
+export declare const FOLDER_ROW_BUDGET = 20;
+/** The collapse key of the path-only matches (folded, so they never bury the name hits). */
+export declare const PATH_GROUP_KEY = "folder:path";
+/**
+ * How many rows the `@file:` view shows at most, headers included.
+ *
+ * The same口径 as the folder view (R-03/R-05): the user asked for the two views to
+ * behave alike, so this is deliberately the same ceiling — and the same answer to
+ * "more than fits": scroll, don't truncate the priority rows away.
+ */
+export declare const FILE_ROW_BUDGET = 20;
+/** The collapse key of the file view's path-only matches. */
+export declare const FILE_PATH_GROUP_KEY = "file:path";
+/**
+ * The row that starts walking the filesystem from the session workspace root.
+ *
+ * It is the folder category's default highlight, because the case this feature
+ * exists for is "a folder that is NOT in my workspace" — and a user who wants one
+ * of the workspace rows does not need to travel through it.
+ * @param t - locale binder.
+ * @returns the row (its pick drafts the workspace root and keeps the menu open).
+ */
+export declare function folderChooseRow(t?: Translate): MentionCandidate;
+/** The stable collapse key for one skill tier. */
+export declare function skillGroupKey(tier: SkillTier): string;
+/** The stable collapse key for one skill domain inside a tier. */
+export declare function skillDomainKey(tier: SkillTier, domain: string): string;
+/** The domain of a skill: the prefix before the first '-' (e.g. blender-modeling → blender). */
+export declare function domainOf(skillName: string): string;
+/** The scope group of one plugin module: the npm scope (e.g. @deepseek-ai) or 其他. */
+export declare function pluginScope(moduleName: string): string;
+/** The stable collapse key for one plugin scope group. */
+export declare function pluginGroupKey(scope: string): string;
+/** The stable collapse key for one chat workspace group. */
+export declare function chatGroupKey(cwd: string | undefined): string;
+/**
+ * Build the '@' trigger source over the injected deps. One source per plugin
+ * fiber; per-session caches live in the returned closure and die with it.
+ * @param deps - Remote, locale, and clock faces.
+ * @returns the source to register with `inputTriggers.registerSource`, plus
+ *   the cache invalidator.
+ */
+export declare function createMentionSource(deps: MentionSourceDeps): MentionSource;
+export {};

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

@@ -0,0 +1,15 @@
+/**
+ * The dock stylesheet, hand-written as a template string and injected once by
+ * the plugin body: the web server serves exactly one file per client plugin,
+ * so no separate CSS artifact may exist. Tokens come only from the shared
+ * `--dsw-alias-*` design platform (no literal colors); class names carry the
+ * `dsh_atFile` prefix to stay unique in the assembled shell.
+ */
+/** Stable `<style>` element id (idempotent injection across HMR re-runs). */
+export declare const STYLE_ID = "dsh-atlas-style";
+/** The dock's injected stylesheet text. */
+export declare const cssText = "\n.dsh_atFile_rail {\n  box-sizing: border-box;\n  display: flex;\n  flex: none;\n  flex-wrap: wrap;\n  gap: 6px;\n  width: calc(\n    100% -\n    var(--dsh-composer-side-clearance) -\n    var(--dsh-composer-side-clearance)\n  );\n  max-width: var(--dsh-composer-card-max-width);\n  min-width: 0;\n  margin: 0 auto;\n}\n.dsh_atFile_row {\n  display: inline-flex;\n  align-items: center;\n  gap: 2px;\n  min-width: 0;\n  max-width: 100%;\n  min-height: 36px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 14px;\n  background: var(--dsw-alias-bg-layer-1);\n}\n.dsh_atFile_path {\n  display: inline-flex;\n  align-items: flex-end;\n  gap: 6px;\n  min-width: 0;\n  max-width: 360px;\n  height: 100%;\n  padding: 0 6px 0 10px;\n  border: 0;\n  background: none;\n  color: var(--dsw-alias-label-primary);\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.dsh_atFile_path:hover {\n  color: var(--dsw-alias-brand-primary);\n}\n.dsh_atFile_cost {\n  flex: none;\n  padding: 0 6px;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 11px;\n  line-height: 18px;\n  font-variant-numeric: tabular-nums;\n  white-space: nowrap;\n}\n.dsh_atFile_cost_warn {\n  color: var(--dsw-alias-label-error, #ef4444);\n  font-weight: 600;\n}\n.dsh_atFile_missing {\n  flex: none;\n  padding: 0 6px;\n  color: var(--dsw-alias-label-error, #ef4444);\n  font-size: 11px;\n  line-height: 18px;\n  white-space: nowrap;\n}\n.dsh_atFile_icon {\n  flex: none;\n  width: 14px;\n  height: 14px;\n}\n.dsh_atFile_remove {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex: none;\n  width: 20px;\n  height: 20px;\n  margin-right: 4px;\n  border: 0;\n  border-radius: 10px;\n  background: none;\n  color: var(--dsw-alias-label-dimmed);\n  cursor: pointer;\n}\n.dsh_atFile_remove svg {\n  width: 12px;\n  height: 12px;\n}\n.dsh_atFile_remove:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-primary);\n}\n.dsh_atFile_section {\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n  min-width: 0;\n}\n.dsh_atFile_title {\n  margin: 0;\n  color: var(--dsw-alias-label-primary);\n  font-size: 18px;\n  line-height: 26px;\n  font-weight: 600;\n}\n.dsh_atFile_card {\n  display: flex;\n  align-items: flex-start;\n  gap: 12px;\n  min-width: 0;\n  padding: 14px 16px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-alias-bg-layer-1);\n  cursor: pointer;\n}\n.dsh_atFile_checkbox {\n  flex: none;\n  width: 18px;\n  height: 18px;\n  margin: 2px 0 0;\n  accent-color: var(--dsw-alias-brand-primary);\n  cursor: pointer;\n}\n.dsh_atFile_cardText {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  min-width: 0;\n}\n.dsh_atFile_cardTitle {\n  color: var(--dsw-alias-label-primary);\n  font-size: 14px;\n  line-height: 22px;\n}\n.dsh_atFile_cardDesc {\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 13px;\n  line-height: 20px;\n}\n.dsh_atFile_filter {\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n  min-width: 0;\n  padding-top: 4px;\n}\n.dsh_atFile_filterHeading {\n  display: flex;\n  align-items: flex-end;\n  justify-content: space-between;\n  flex-wrap: wrap;\n  gap: 12px;\n  min-width: 0;\n}\n.dsh_atFile_filterHeadingText {\n  display: flex;\n  flex: 1 1 280px;\n  flex-direction: column;\n  gap: 2px;\n  min-width: 0;\n}\n.dsh_atFile_filterTitle {\n  color: var(--dsw-alias-label-primary);\n  font-size: 14px;\n  line-height: 22px;\n  font-weight: 600;\n}\n.dsh_atFile_filterDesc,\n.dsh_atFile_filterHint,\n.dsh_atFile_workspaceField > span {\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 13px;\n  line-height: 20px;\n}\n.dsh_atFile_scopeTabs {\n  display: inline-flex;\n  flex: 0 1 auto;\n  min-width: 220px;\n  padding: 3px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1);\n}\n.dsh_atFile_scopeTab {\n  flex: 1 1 0;\n  min-width: 0;\n  height: 30px;\n  padding: 0 14px;\n  border: 0;\n  border-radius: 6px;\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n  font: inherit;\n  font-size: 13px;\n  line-height: 20px;\n  cursor: pointer;\n}\n.dsh_atFile_scopeTab:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-primary);\n}\n.dsh_atFile_scopeTab[aria-selected='true'] {\n  background: var(--dsw-alias-button-ghost-active-fill);\n  color: var(--dsw-alias-label-primary);\n  font-weight: 600;\n}\n.dsh_atFile_workspaceField {\n  display: flex;\n  flex-direction: column;\n  gap: 5px;\n  min-width: 0;\n}\n.dsh_atFile_workspaceSelect,\n.dsh_atFile_filterInput {\n  box-sizing: border-box;\n  width: 100%;\n  min-width: 0;\n  height: 36px;\n  padding: 0 10px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  outline: none;\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-primary);\n  font: inherit;\n  font-size: 13px;\n  line-height: 20px;\n}\n.dsh_atFile_workspaceSelect:focus,\n.dsh_atFile_filterInput:focus {\n  border-color: var(--dsw-alias-brand-primary);\n}\n.dsh_atFile_workspaceSelect:disabled,\n.dsh_atFile_filterInput:disabled {\n  opacity: 0.55;\n}\n.dsh_atFile_filterToolbar {\n  display: flex;\n  align-items: flex-end;\n  justify-content: space-between;\n  flex-wrap: wrap;\n  gap: 8px;\n  min-width: 0;\n}\n.dsh_atFile_filterGroupTitle {\n  color: var(--dsw-alias-label-primary);\n  font-size: 14px;\n  line-height: 22px;\n  font-weight: 600;\n}\n.dsh_atFile_secondaryButton {\n  flex: none;\n  min-height: 30px;\n  padding: 0 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 15px;\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-secondary);\n  font: inherit;\n  font-size: 12px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh_atFile_secondaryButton:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-primary);\n}\n.dsh_atFile_secondaryButton:disabled,\n.dsh_atFile_filterRemove:disabled,\n.dsh_atFile_addButton:disabled {\n  opacity: 0.45;\n  cursor: default;\n}\n.dsh_atFile_filterList {\n  min-width: 0;\n  overflow: hidden;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1);\n}\n.dsh_atFile_filterRow {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  gap: 12px;\n  min-width: 0;\n  min-height: 40px;\n  padding: 0 8px 0 12px;\n  border-bottom: 1px solid var(--dsw-alias-border-l1);\n}\n.dsh_atFile_filterRow:last-child {\n  border-bottom: 0;\n}\n.dsh_atFile_filterName {\n  min-width: 0;\n  overflow: hidden;\n  color: var(--dsw-alias-label-primary);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 13px;\n  line-height: 20px;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.dsh_atFile_ruleMain {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  flex: 1 1 auto;\n  gap: 8px;\n  min-width: 0;\n}\n.dsh_atFile_ruleBadge {\n  flex: none;\n  padding: 2px 6px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 4px;\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 11px;\n  line-height: 16px;\n}\n.dsh_atFile_ruleMain .dsh_atFile_filterName {\n  flex: 1 1 180px;\n}\n.dsh_atFile_filterRemove {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex: none;\n  width: 28px;\n  height: 28px;\n  border: 0;\n  border-radius: 14px;\n  background: none;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh_atFile_filterRemove:hover:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover-danger);\n  color: var(--dsw-alias-state-error-primary);\n}\n.dsh_atFile_filterRemove svg,\n.dsh_atFile_addButton svg {\n  width: 15px;\n  height: 15px;\n}\n.dsh_atFile_filterEmpty {\n  padding: 16px 12px;\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 13px;\n  line-height: 20px;\n  text-align: center;\n}\n.dsh_atFile_filterAddRow {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 8px;\n  min-width: 0;\n}\n.dsh_atFile_ruleMode {\n  display: inline-flex;\n  align-self: flex-start;\n  gap: 2px;\n  padding: 3px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-1);\n}\n.dsh_atFile_ruleModeButton {\n  min-width: 72px;\n  height: 28px;\n  padding: 0 10px;\n  border: 0;\n  border-radius: 5px;\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n  font: inherit;\n  font-size: 12px;\n  cursor: pointer;\n}\n.dsh_atFile_ruleModeButton[aria-pressed='true'] {\n  background: var(--dsw-alias-button-ghost-active-fill);\n  color: var(--dsw-alias-label-primary);\n  font-weight: 600;\n}\n.dsh_atFile_caseToggle {\n  display: inline-flex;\n  align-items: center;\n  align-self: flex-start;\n  gap: 7px;\n  color: var(--dsw-alias-label-secondary);\n  font-size: 12px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh_atFile_caseToggle input {\n  width: 15px;\n  height: 15px;\n  margin: 0;\n  accent-color: var(--dsw-alias-brand-primary);\n}\n.dsh_atFile_filterAddRow .dsh_atFile_filterInput {\n  flex: 1 1 240px;\n  width: auto;\n}\n.dsh_atFile_filterInput[aria-invalid='true'] {\n  border-color: var(--dsw-alias-state-error-primary);\n}\n.dsh_atFile_addButton {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  gap: 6px;\n  flex: none;\n  height: 36px;\n  padding: 0 14px;\n  border: 0;\n  border-radius: 18px;\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-inverted);\n  font: inherit;\n  font-size: 13px;\n  line-height: 20px;\n  cursor: pointer;\n}\n.dsh_atFile_filterError {\n  color: var(--dsw-alias-state-error-primary);\n  font-size: 13px;\n  line-height: 20px;\n}\n.dsh_atFile_inherited {\n  display: flex;\n  flex-direction: column;\n  gap: 7px;\n  min-width: 0;\n  padding-top: 4px;\n}\n.dsh_atFile_inheritedTitle {\n  color: var(--dsw-alias-label-tertiary);\n  font-size: 12px;\n  line-height: 18px;\n}\n.dsh_atFile_inheritedList {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 6px;\n  min-width: 0;\n}\n.dsh_atFile_inheritedList code {\n  max-width: 100%;\n  overflow: hidden;\n  padding: 3px 8px;\n  border-radius: 4px;\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-secondary);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 12px;\n  line-height: 18px;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n@media (max-width: 560px) {\n  .dsh_atFile_scopeTabs {\n    width: 100%;\n  }\n  .dsh_atFile_addButton {\n    flex: 1 1 auto;\n  }\n}\n\n\n/* Maximize the @ mention menu height: the framework caps the listbox at 400px\n   (its own design cap, itself already clamped to the space above the composer)\n   inline; target only OUR menu (the atlas data-source marker is present on BOTH\n   the pending loading row and the ready option rows, so the override holds from\n   the first open and the width never jumps).\n\n   The WIDTH is deliberately left alone. The framework lays the menu out as an\n   absolutely positioned box with left:0 and right:0 inside the composer card's\n   own overlay anchor, so it is exactly as wide as the card, which is itself\n   capped by --dsh-composer-card-max-width. A content-sized width here (the\n   previous behaviour) could push the popup past the composer instead \u2014 the\n   plugin's UI must never leave the chat box. Long names wrap inside the card\n   width instead (see the itemName rule below). */\n[role=\"listbox\"]:has([data-source=\"atlas\"]) {\n  /* Fit as much of the list as the composer leaves room for: MentionNavigator\n     measures the composer card's top edge into --dsh-atlas-menu-max on every\n     menu change and on resize, so the cap follows the real available height (a\n     multi-line draft shrinks it) instead of a fixed viewport guess. The\n     fallback keeps the previous behaviour until the first measurement lands,\n     and 760px stays the absolute ceiling. */\n  max-height: min(760px, var(--dsh-atlas-menu-max, calc(100dvh - 100px))) !important;\n}\n/* The MENU SHELL's own cap is 400px, set inline by the framework. Our category is\n   short by design (a bounded row budget), and the user asked the popup to use the\n   space above the composer instead of cutting the list at 400px \u2014 so when our\n   group is present the shell may grow to the same measured budget. An important\n   rule outranks an inline style, and a taller cap never stretches a short list\n   (the height stays content-driven). */\n[data-trigger-menu]:has([data-source=\"atlas\"]) {\n  max-height: min(760px, var(--dsh-atlas-menu-max, calc(100dvh - 100px))) !important;\n}\n[id^=\"dsh-slash-option-atlas-\"] {\n  /* Text and icon share the bottom edge so the label reads against the icon. */\n  align-items: flex-end !important;\n  gap: 10px !important;\n}\n[id^=\"dsh-slash-option-atlas-\"] [class*=\"itemIcon\"] {\n  /* The icon slot grows with the bigger Tabler icons (36px skill included). */\n  width: 32px !important;\n  height: 32px !important;\n  flex: none !important;\n}\n[id^=\"dsh-slash-option-atlas-\"] [class*=\"itemName\"] {\n  /* The name NEVER shrinks to make room for the description: full width,\n     wrapping only when the menu hits its max width. */\n  max-width: none !important;\n  flex: 0 0 auto !important;\n  min-width: 0 !important;\n  white-space: normal !important;\n  overflow-wrap: anywhere !important;\n  overflow: visible !important;\n  text-overflow: clip !important;\n}\n[id^=\"dsh-slash-option-atlas-\"] [class*=\"itemDescription\"] {\n  /* The description stays on ONE line with an ellipsis inside the remaining\n     space \u2014 it can never spill into the name or the next row. */\n  flex: 1 1 auto !important;\n  min-width: 0 !important;\n  white-space: nowrap !important;\n  overflow: hidden !important;\n  text-overflow: ellipsis !important;\n}\n\n\n/* Display-only side ad panel: beside the @ menu, same height, never in the\n   list. z-index stays BELOW the menu's 100 so a residual overlap can never\n   hide the candidate list (placement also keeps the panel outside the menu). */\n.dsh_atAll_ad {\n  position: fixed;\n  z-index: 90;\n  width: 150px; /* overwritten inline: adapts to the ad's aspect */\n  border-radius: 12px;\n  overflow: hidden;\n  pointer-events: none;\n  background: linear-gradient(160deg, #0b1e33 0%, #12294a 55%, #1c3d6b 100%);\n  border: 1px solid rgba(255, 255, 255, 0.12);\n  box-shadow: 0 10px 28px rgba(0, 0, 0, 0.35);\n}\n.dsh_atAll_ad img {\n  display: block;\n  width: 100%;\n  height: 100%;\n  /* contain (never crop): the whole ad stays visible, letterboxed on the\n     panel's gradient when the panel is taller than the image aspect. */\n  object-fit: contain;\n}\n.dsh_atAll_adBanner {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: 10px;\n  width: 100%;\n  height: 100%;\n  min-height: 120px;\n  padding: 12px;\n  box-sizing: border-box;\n}\n.dsh_atAll_adWordmark {\n  font-family: ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif;\n  font-size: 22px;\n  font-weight: 700;\n  letter-spacing: 6px;\n  color: rgba(255, 255, 255, 0.95);\n  text-shadow: 0 2px 10px rgba(120, 180, 255, 0.45);\n}\n.dsh_atAll_adTag {\n  font-size: 11px;\n  letter-spacing: 2px;\n  color: rgba(255, 255, 255, 0.55);\n}\n\n/* Sent-message reference chips are inert in this client build (its chat view\n   calls projectUserText without the reference actions), so ReferenceLinks\n   supplies the click and publishes the affordance itself: only a chip that\n   bridge can actually open carries data-dsh-atlas-link. The styling is the\n   framework's OWN link language \u2014 the tokens its wired chips use (the\n   ui-primitives markdown fileMention rule): link-blue at rest, a dotted\n   underline under the pointer. A build that wires the chips itself renders\n   buttons, which this rule never matches. */\n[data-dsh-atlas-link] {\n  color: var(--dsw-alias-link);\n  font-weight: 500;\n  text-decoration: none;\n  cursor: pointer;\n}\n[data-dsh-atlas-link]:hover,\n[data-dsh-atlas-link]:focus {\n  outline: none;\n  text-decoration: underline dotted var(--dsw-alias-link);\n  text-underline-offset: 3px;\n}\n/* A reference whose target is gone: the click learned it, so the chip stops\n   looking like a link and reads as stale instead \u2014 the dock's own \u5DF2\u5931\u6548\n   language, applied to a chip the plugin does not own. */\n[data-dsh-atlas-missing] {\n  color: var(--dsw-alias-label-dimmed, inherit);\n  text-decoration: line-through;\n  cursor: default;\n}\n/* A composer reference chip: the framework styles its BODY with the chip blue and\n   cursor:default, and that rule is a single class \u2014 the same specificity as the\n   link rule above, so this one is spelled with the host ancestor to win outright\n   (a chip that opens must not keep telling the pointer it is not clickable). An\n   inert chip keeps the framework's own look and cursor untouched. */\n[data-composer-chip] [data-dsh-atlas-link] {\n  color: var(--dsw-alias-link);\n  cursor: pointer;\n}\n[data-composer-chip] [data-dsh-atlas-link]:hover {\n  text-decoration: underline dotted var(--dsw-alias-link);\n  text-underline-offset: 3px;\n}\n[data-composer-chip] [data-dsh-atlas-missing] {\n  color: var(--dsw-alias-label-dimmed, inherit);\n  text-decoration: line-through;\n  cursor: default;\n}\n/* A draft reference is drawn as a link by the plugin itself: the framework\n   colours only the head of a token it recognises (its matcher stops at the last\n   separator or the first non-word character), and a hand-typed token it never\n   recognised stays plain. DraftLinks paints the WHOLE token through the CSS\n   Custom Highlight API \u2014 the one way to colour a text range without\n   re-parenting a Lexical text span, whose updateDOM writes through\n   firstChild.nodeValue. The colour is the framework's own reference colour (its\n   composer-editor textRef rule), so a token it did colour reads unchanged. */\n::highlight(dsh-atlas-draft-ref) {\n  color: var(--dsw-alias-state-business-primary);\n}\n/* A draft reference whose target the Host reports as gone: the dock's own \u5DF2\u5931\u6548\n   language (dimmed and struck through), painted over the same range so a\n   reference that cannot open still reads as a reference. It is never a link:\n   nothing here touches the cursor, and the click gate refuses it. */\n::highlight(dsh-atlas-draft-missing) {\n  color: var(--dsw-alias-label-dimmed, inherit);\n  text-decoration: line-through;\n}\n/* Menu glyphs: this plugin's own icons, drawn over the icon slot the framework\n   reserves on each of its rows (see MenuIcons). They live in their own fixed\n   layer \u2014 nothing is inserted into a row the framework owns \u2014 and a slot is\n   marked only while a glyph covers it, which is what hides the framework's own\n   three-glyph set exactly there and nowhere else. */\n.dsh_atlas_menuIcon {\n  position: fixed;\n  z-index: 2147482500;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  pointer-events: none;\n}\n[data-dsh-atlas-menu-icon-host] > svg {\n  display: none;\n}\n/* The folder tab: a directory, one level, walked in place. Rows are the sidebar's\n   own density (they sit next to the files tree), the path is the only wide text\n   and it ellipsizes rather than pushing the controls out of the header. */\n.dsh_atlas_folder {\n  display: flex;\n  flex-direction: column;\n  height: 100%;\n  min-height: 0;\n  overflow-y: auto;\n  font-size: 13px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh_atlas_folderHead {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 6px 10px;\n  border-bottom: 1px solid var(--dsw-alias-border-l1, rgba(128, 128, 128, 0.25));\n  position: sticky;\n  top: 0;\n  background: var(--dsw-alias-bg-primary, transparent);\n}\n.dsh_atlas_folderUp,\n.dsh_atlas_folderOpen {\n  flex: none;\n  border: none;\n  background: transparent;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  cursor: pointer;\n  border-radius: 6px;\n  padding: 2px 6px;\n  font: inherit;\n}\n.dsh_atlas_folderUp:disabled {\n  opacity: 0.4;\n  cursor: default;\n}\n.dsh_atlas_folderUp:not(:disabled):hover,\n.dsh_atlas_folderOpen:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16));\n}\n.dsh_atlas_folderPath {\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  direction: rtl;\n  text-align: left;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 12px;\n}\n.dsh_atlas_folderNote {\n  margin: 8px 10px;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  font-size: 12px;\n}\n.dsh_atlas_folderList {\n  list-style: none;\n  margin: 0;\n  padding: 4px;\n}\n.dsh_atlas_folderRow {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: 100%;\n  padding: 4px 6px;\n  border: none;\n  border-radius: 6px;\n  /* A row stays plain until the pointer is on it. The theme paints generic\n     buttons, and a list where every line carries a plate reads as a table rather\n     than a tree (reported from a screenshot), so this one wins outright. */\n  background: none !important;\n  box-shadow: none !important;\n  color: inherit;\n  cursor: pointer;\n  text-align: left;\n  font: inherit;\n}\n.dsh_atlas_folderRow:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16)) !important;\n}\n.dsh_atlas_folderGlyph {\n  display: inline-flex;\n  flex: none;\n  align-items: center;\n}\n.dsh_atlas_folderName {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n/* The folder chooser dialog: the product's browse backend wearing this plugin's\n   face (the product's own dialog is a private child slot of the workspace picker,\n   so a plugin cannot render it). */\n.dsh_atlas_pickerScrim {\n  position: fixed;\n  inset: 0;\n  z-index: 2147482600;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background: rgba(0, 0, 0, 0.45);\n}\n.dsh_atlas_picker {\n  display: flex;\n  flex-direction: column;\n  width: min(560px, 88vw);\n  max-height: min(560px, 84vh);\n  border-radius: 14px;\n  border: 1px solid var(--dsw-alias-border-l1, rgba(128, 128, 128, 0.3));\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-primary, #1b1f2a));\n  box-shadow: 0 18px 48px rgba(0, 0, 0, 0.45);\n  color: var(--dsw-alias-label-primary);\n  font-size: 13px;\n  overflow: hidden;\n}\n.dsh_atlas_pickerHead {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 14px 16px 8px;\n}\n.dsh_atlas_pickerTitle {\n  margin: 0;\n  font-size: 15px;\n  font-weight: 600;\n}\n.dsh_atlas_pickerPathRow {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n}\n.dsh_atlas_pickerPath {\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  font-size: 12px;\n}\n.dsh_atlas_pickerCrumbs {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 4px;\n}\n.dsh_atlas_pickerCrumb {\n  border: none;\n  background: none !important;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  cursor: pointer;\n  font: inherit;\n  font-size: 12px;\n  padding: 1px 4px;\n  border-radius: 5px;\n}\n.dsh_atlas_pickerCrumb:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16)) !important;\n}\n.dsh_atlas_pickerList {\n  list-style: none;\n  margin: 0;\n  padding: 4px 8px;\n  overflow-y: auto;\n  flex: 1 1 auto;\n  min-height: 120px;\n}\n.dsh_atlas_pickerRow {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: 100%;\n  padding: 5px 8px;\n  border: none;\n  border-radius: 7px;\n  background: none !important;\n  color: inherit;\n  cursor: pointer;\n  text-align: left;\n  font: inherit;\n}\n.dsh_atlas_pickerRow:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16)) !important;\n}\n.dsh_atlas_pickerGlyph {\n  display: inline-flex;\n  flex: none;\n  align-items: center;\n}\n.dsh_atlas_pickerName {\n  flex: 1 1 auto;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.dsh_atlas_pickerChevron {\n  flex: none;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n}\n.dsh_atlas_pickerNote {\n  margin: 6px 16px;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  font-size: 12px;\n}\n.dsh_atlas_pickerNewRow {\n  display: flex;\n  gap: 6px;\n  padding: 0 16px 8px;\n}\n.dsh_atlas_pickerInput {\n  flex: 1 1 auto;\n  min-width: 0;\n  padding: 5px 8px;\n  border-radius: 7px;\n  border: 1px solid var(--dsw-alias-border-l1, rgba(128, 128, 128, 0.35));\n  background: transparent;\n  color: inherit;\n  font: inherit;\n}\n.dsh_atlas_pickerFoot {\n  display: flex;\n  align-items: center;\n  gap: 10px;\n  padding: 10px 16px 14px;\n  border-top: 1px solid var(--dsw-alias-border-l1, rgba(128, 128, 128, 0.25));\n}\n.dsh_atlas_pickerButton {\n  border: 1px solid var(--dsw-alias-border-l1, rgba(128, 128, 128, 0.35));\n  border-radius: 7px;\n  background: none !important;\n  color: inherit;\n  cursor: pointer;\n  font: inherit;\n  padding: 4px 10px;\n}\n.dsh_atlas_pickerButton:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16)) !important;\n}\n.dsh_atlas_pickerButton:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh_atlas_pickerIconButton {\n  border: none;\n  background: none !important;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  cursor: pointer;\n  font: inherit;\n  padding: 2px 6px;\n  border-radius: 6px;\n}\n.dsh_atlas_pickerIconButton:hover {\n  background: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16)) !important;\n}\n.dsh_atlas_pickerPrimary {\n  border-color: transparent;\n  background: var(--dsw-alias-state-business-primary, #5686fe) !important;\n  color: #fff;\n}\n.dsh_atlas_pickerToggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  color: var(--dsw-alias-label-secondary, #9aa4b2);\n  font-size: 12px;\n}\n.dsh_atlas_pickerSpacer {\n  flex: 1 1 auto;\n}\n";
+/**
+ * Inject the dock stylesheet once (stable id; HMR-safe).
+ */
+export declare function adoptStyles(): void;