@sidequest-007/dsh-atlas 1.0.0

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

@@ -0,0 +1,31 @@
+/** Settings section for global and workspace-specific file filter rules. */
+import type { PropsLocale, PropsRuntime, InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
+import type { FileIgnoreRuleInput, FolderOpenTarget } from '../contract.ts';
+import type { AtFileSettingsSource } from './FilesDock.tsx';
+export type AtFileFilterScope = 'global' | 'workspace';
+/** Ephemeral settings navigation retained while the plugin stays mounted. */
+export interface AtFileSectionViewState {
+    filterScope: AtFileFilterScope;
+    selectedWorkspace: string;
+}
+/** Injected business face: the live scope, retained view, and durable write verbs. */
+export interface AtFileSectionInjected {
+    hooks: {
+        scope: AtFileSettingsSource;
+    };
+    viewState: AtFileSectionViewState;
+    setEnabled: (enabled: boolean) => Promise<void>;
+    setEnableSkills: (enableSkills: boolean) => Promise<void>;
+    setEnableChats: (enableChats: boolean) => Promise<void>;
+    setEnablePlugins: (enablePlugins: boolean) => Promise<void>;
+    setIgnorePastedMentions: (ignore: boolean) => Promise<void>;
+    setFolderOpen: (target: FolderOpenTarget) => Promise<void>;
+    setIgnoreFiles: (ignoreFiles: readonly FileIgnoreRuleInput[]) => Promise<void>;
+    setWorkspaceIgnoreFiles: (workspace: string, ignoreFiles: readonly FileIgnoreRuleInput[]) => Promise<void>;
+}
+/** Full section props: runtime share + injected face + locale seat. */
+export type AtFileSectionProps = PropsRuntime<'settings.section'> & InjectFace<AtFileSectionInjected> & PropsLocale<'atlas'>;
+/** Trim one legacy exact basename; retained for callers using the old helper. */
+export declare function parseIgnoreFile(value: string): string | undefined;
+/** Render the enable switch and scoped file-filter manager. */
+export declare function AtFileSection({ useScope, useSessions, useWorkspaces, viewState, setEnabled, setEnableSkills, setEnableChats, setEnablePlugins, setIgnorePastedMentions, setFolderOpen, setIgnoreFiles, setWorkspaceIgnoreFiles, t, }: AtFileSectionProps): import("react").JSX.Element;

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

@@ -0,0 +1,205 @@
+import { type ReferenceLink } from './reference-links.ts';
+import type { ReferenceOutcome } from './ReferenceLinks.tsx';
+/** The attribute Lexical puts on the composer's contenteditable root. */
+export declare const EDITOR_SELECTOR = "[data-lexical-editor=\"true\"]";
+/** The attribute the framework puts on a text node it decorated as a reference. */
+export declare const TEXT_REF_SELECTOR = "[data-composer-text-ref]";
+/** The highlight name every draft link is painted under. */
+export declare const DRAFT_HIGHLIGHT = "dsh-atlas-draft-ref";
+/** The highlight name a reference whose target is gone is painted under. */
+export declare const MISSING_HIGHLIGHT = "dsh-atlas-draft-missing";
+/** The action one click on a draft reference performs. */
+export type DraftAction = () => ReferenceOutcome | Promise<ReferenceOutcome>;
+/** One token the plugin can act on, decoded. */
+export interface DraftActivation {
+    readonly link: ReferenceLink;
+    readonly run: DraftAction;
+}
+/**
+ * The block child of the editor root that holds `node`.
+ *
+ * Lexical draws one block element per line, so this is the line a caret belongs
+ * to; offsets are then counted inside that one line, never across the whole
+ * draft (which is what keeps the mapping exact without knowing how the editor
+ * spells its line breaks).
+ * @param root - one editor root.
+ * @param node - a node inside it.
+ * @returns the block, or undefined when the node is not inside this root.
+ */
+export declare function blockOf(root: Element, node: Node): Element | undefined;
+/** One line's text plus the offset each of its text nodes starts at. */
+export interface LineIndex {
+    readonly text: string;
+    readonly nodes: readonly {
+        readonly node: Text;
+        readonly start: number;
+    }[];
+}
+/** Index one line so a character offset and a text node convert into each other. */
+export declare function indexLine(block: Element): LineIndex;
+/**
+ * The DOM point of one character offset inside an indexed line.
+ * @param index - the indexed line.
+ * @param offset - a character offset in its text.
+ * @returns the text node and offset to build a Range from, or undefined past the end.
+ */
+export declare function pointAt(index: LineIndex, offset: number): {
+    readonly node: Text;
+    readonly offset: number;
+} | undefined;
+/** One `@` token's span inside a line's text. */
+export interface TokenRun {
+    readonly token: string;
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * The `@` token run that covers one character offset of a line.
+ *
+ * The run is bounded by whitespace and by a second `@` (the grammar is `@` plus
+ * a run of non-whitespace, non-`@` characters), so a click anywhere inside a
+ * token — including its undecorated tail — resolves to the same whole token.
+ * @param text - one line's text.
+ * @param offset - the character offset the caret sits at.
+ * @returns the token and its span, or undefined when no `@` governs that offset.
+ */
+export declare function tokenRunAt(text: string, offset: number): TokenRun | undefined;
+/** One reference token under a caret position. */
+export interface InlineToken extends TokenRun {
+    readonly line: Element;
+    readonly index: LineIndex;
+    /** Where the caret sits inside the line's text. */
+    readonly local: number;
+    /** Whether the user has finished typing the token (see {@link DraftToken}). */
+    readonly settled: boolean;
+    /**
+     * The offset at which the framework's own colouring stops, when it drew the
+     * token's head at all. Only used by a browser that cannot paint a range: there
+     * the framework's colour is the only "this is a link" the user can see.
+     */
+    readonly decoratedEnd?: number;
+}
+/**
+ * The reference token a caret position in the composer resolves to.
+ *
+ * The token is read from the line's text, not from the framework's decoration:
+ * a hand-typed token the editor never recognised is the same reference as one it
+ * did, and the caller decides what may be offered (see {@link draftActivation}).
+ * @param root - one editor root.
+ * @param node - the caret's container node.
+ * @param offset - the caret's offset inside that node.
+ * @returns the token, or undefined when no `@` token covers the point.
+ */
+export declare function tokenAtPoint(root: Element, node: Node, offset: number): InlineToken | undefined;
+/** One `@` token of the composer, with the line it lives in. */
+export interface DraftToken extends TokenRun {
+    readonly line: Element;
+    readonly index: LineIndex;
+    /**
+     * Whether the user has finished typing this token: a whitespace character
+     * follows it, or its line is followed by another line (Enter). A token that
+     * ends the draft is still being written, and every prefix of a real path is a
+     * path the Host has never heard of — judging one would strike it through
+     * halfway through typing it.
+     */
+    readonly settled: boolean;
+}
+/**
+ * Every `@` token the composer currently shows, in document order.
+ *
+ * The tokens are read per line, so the mapping from a token to a DOM range needs
+ * no knowledge of how the editor spells its line breaks.
+ * @returns the tokens, with the offsets they occupy in their line.
+ */
+export declare function draftTokens(): readonly DraftToken[];
+/**
+ * The action one draft token offers, or undefined when it offers none.
+ *
+ * This is the plugin's own definition of a draft link, and it deliberately does
+ * NOT consult the framework's decoration: a hand-typed `@AGENTS.md` names the
+ * same reference whether or not the editor happened to recognise the name.
+ *
+ * A file or folder token is offered only while the Host CONFIRMS its target: the
+ * dock above the composer already inspects exactly those tokens and marks a
+ * vanished one `已失效`, so an unknown verdict means "not yet" rather than "yes" —
+ * a link drawn before the answer arrives would have to be taken back a moment
+ * later, and a link that opens nothing must never be handed to the pointer. A
+ * provider or skill token has no such verdict: whether it is openable is its
+ * owner's answer, asked through `actionFor`.
+ * @param token - one draft token, `@` included.
+ * @param actionFor - the session's action lookup.
+ * @param verdict - the dock's last inspection verdict for one referenced path.
+ * @returns the action, or undefined when there is nothing to open.
+ */
+export declare function draftActivation(token: string, actionFor: (link: ReferenceLink) => DraftAction | undefined, verdict: DraftVerdictLookup): DraftActivation | undefined;
+/** The Host's inspection verdict for one referenced path. */
+export interface DraftVerdict {
+    /** Whether the target exists right now. */
+    readonly exists: boolean;
+    /** The target's kind, when the Host reported one. */
+    readonly kind?: 'file' | 'dir';
+}
+/** Look one referenced path up among the dock's verdicts. */
+export type DraftVerdictLookup = (path: string) => DraftVerdict | undefined;
+/**
+ * Whether one draft token is a reference whose target the Host reports as gone.
+ *
+ * This is the dock's own `已失效` state, said in the composer: the token names a
+ * file or a folder, the inspection answered, and the answer was no. It is NOT
+ * the same as an unanswered inspection (nothing is claimed then) and not the
+ * same as a token that decodes into no reference at all (`@plugin:x` is a label,
+ * not a path) — neither of those is a claim the plugin can make about a file.
+ * @param token - one draft token, `@` included.
+ * @param verdict - the dock's last inspection verdict for one referenced path.
+ * @returns true when the token names a target that is gone.
+ */
+export declare function draftMissing(token: string, verdict: DraftVerdictLookup): boolean;
+/**
+ * Decode one draft token into the reference it names.
+ *
+ * {@link decodeDraftReference} owns the vocabulary. A file token may still carry
+ * the line-range spelling (`@src/view.ts:12-40`), which that decoder accepts as
+ * a path because its colon is not in the first segment; the range is a reading
+ * instruction rather than part of the path, so it is dropped here exactly as the
+ * dock's rows drop it. A handle spelling (`@file:12-40`) is refused by the
+ * decoder itself, and stays refused.
+ * @param token - one draft token, `@` included.
+ * @returns the reference, or undefined when the token names nothing openable.
+ */
+export declare function draftLink(token: string): ReferenceLink | undefined;
+/** Whether this browser can colour text ranges without touching the editor's DOM. */
+export declare function canPaintTails(): boolean;
+/** How one draft token should be drawn: an openable link, or a stale reference. */
+export type DraftPaint = 'link' | 'missing';
+/** How many tokens of each kind the last {@link paintDraftLinks} pass drew. */
+export interface DraftPaintCount {
+    readonly link: number;
+    readonly missing: number;
+}
+/**
+ * Paint every draft token `decide` classifies.
+ *
+ * The whole token is painted, not just the part the framework happened to
+ * colour: a link that opens on a click must look like a link along its entire
+ * length, and the framework's own colour (when it drew one) is the same design
+ * token, so nothing shifts for a token it did recognise. A token whose target is
+ * gone is painted the other way — stale, the dock's own language — so a
+ * reference that cannot open is visibly a reference rather than ordinary prose.
+ * The API paints ranges over the existing text, so the editor's node structure
+ * is untouched.
+ * @param decide - classifies one token; it receives the token with its line and
+ *   its `settled` flag, because a token still being typed must not be judged.
+ * @returns how many tokens of each kind were painted.
+ */
+export declare function paintDraftLinks(decide: (token: DraftToken) => DraftPaint | undefined): DraftPaintCount;
+/**
+ * Show or clear the link pointer on one composer.
+ *
+ * The cursor cannot be part of a highlight — it is a property of the element
+ * under the pointer, and the undecorated tail shares its element with whatever
+ * prose follows — so the bridge hit-tests the pointer and publishes the answer
+ * on the editor root.
+ * @param root - one editor root.
+ * @param hot - whether the pointer is over an openable reference token.
+ */
+export declare function setEditorCursor(root: Element, hot: boolean): void;

package/lib/types/client/draft-scope.d.ts

@@ -0,0 +1,22 @@
+/** What {@link draftScopeOf} cannot read for itself. */
+export interface ScopeProbe {
+    /**
+     * Whether the Host's own verdict calls this path a directory. A path token
+     * without a trailing separator is a file by syntax (`@e:/work/docs`), and only the
+     * Host knows it is the folder the user meant.
+     * @param path - the token's decoded path.
+     * @returns true when the Host says `dir`.
+     */
+    isFolder(path: string): Promise<boolean>;
+}
+/**
+ * The folder path a draft is scoped by, or undefined when it names none.
+ *
+ * Tokens are scanned back to front, so the reference nearest the active token
+ * wins; the active token itself names no folder (a category handle like `file:`
+ * decodes to nothing, which is what keeps `@file:Ea` from scoping itself).
+ * @param tokens - the composer's `@` tokens in document order, trigger included.
+ * @param probe - the Host verdict lookup for plain path tokens.
+ * @returns the scoping folder path, or undefined.
+ */
+export declare function draftScopeOf(tokens: readonly string[], probe: ScopeProbe): Promise<string | undefined>;

package/lib/types/client/git-provider.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The built-in `@git` provider's menu half — and the seam's worked example of a
+ * browser-side provider that reads Host data.
+ *
+ * A provider's `list` runs in the browser, where there is no repository to read,
+ * so this half asks the Host through the `atlas/gitChanges` endpoint. That is
+ * the intended shape for any provider whose data is not already in the page: the
+ * wire call belongs to the provider, not to the menu.
+ *
+ * Nothing here is cached: the menu may re-ask on every keystroke, and a provider
+ * that wants a cache owns it.
+ */
+import type { AtlasCallContext, AtlasItem, AtlasOpenOutcome, AtlasProvider } from '../atlas.ts';
+import { type GitChange } from '../contract.ts';
+/** Beyond this the change list stops being a menu and starts being a file dump. */
+export declare const GIT_ITEM_LIMIT = 50;
+/**
+ * One changed path as a menu row.
+ * @param change - the change from the Host.
+ * @returns the item the seam will hand back to `resolve` verbatim.
+ */
+export declare function gitChangeItem(change: GitChange): AtlasItem;
+/** How this half reaches the Host's repository state and the user's viewer. */
+export interface GitMenuDeps {
+    /**
+     * Ask the Host for the workspace's changed paths.
+     * @param sessionId - the answered session (the Host resolves its workspace).
+     * @param signal - caller lifetime; superseded per keystroke.
+     */
+    changes(sessionId: AtlasCallContext['sessionId'], signal: AbortSignal): Promise<readonly GitChange[]>;
+    /**
+     * Open one changed path for the user — the click action of a committed
+     * `@atlas:git/<path>` mention in an already sent message.
+     * @param sessionId - the session the mention was clicked in.
+     * @param path - the workspace-relative path, as git reported it.
+     * @returns `'gone'` when the path is no longer there, so the chip reads stale.
+     */
+    open(sessionId: AtlasCallContext['sessionId'], path: string): AtlasOpenOutcome | void | Promise<AtlasOpenOutcome | void>;
+}
+/**
+ * Build the built-in `@git` menu provider.
+ * @param deps - the Host bridge for the candidate list and the viewer bridge.
+ * @returns the declaration the browser half registers.
+ */
+export declare function createGitMenuProvider(deps: GitMenuDeps): AtlasProvider;

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

@@ -0,0 +1,48 @@
+/** Tabler-based vector icons (single icon library) with per-kind semantic colors. */
+import type { ReactElement } from 'react';
+import type { FileEntry } from './remote.ts';
+export type FileIconKind = 'folder' | 'code' | 'text' | 'pdf' | 'image' | 'data' | 'archive' | 'file';
+/** Classify one indexed path without reading it. */
+export declare function fileIconKind(file: Pick<FileEntry, 'kind' | 'relative'>): FileIconKind;
+/**
+ * One file-kind icon rendered at menu size. The wrapper span keeps the stable
+ * `data-file-icon` marker for classification consumers and tests.
+ */
+export declare function fileIcon(file: Pick<FileEntry, 'kind' | 'relative'>): ReactElement;
+/** Mention kinds that carry their own accent icon. */
+export type MentionIconKind = 'file' | 'folder' | 'skill' | 'chat' | 'plugin' | 'back';
+/** One category/dock icon with its semantic accent color (sparse glyphs compensated). */
+export declare function mentionIcon(kind: MentionIconKind): ReactElement;
+/**
+ * A leaf-row icon for result rows (skills/chats/plugins), replacing the empty
+ * indentation slot. Sizes match the category menu icons (skill 36px, others 28px)
+ * so the same kind reads identically everywhere.
+ */
+export declare function leafIcon(kind: 'skill' | 'chat' | 'plugin'): ReactElement;
+/**
+ * The framework kind that RESERVES an icon box on one of our menu rows.
+ *
+ * The framework's row renders an icon only when the candidate carries one, and
+ * it can only draw `session`, `file` and `folder`. So a row of ours always
+ * carries one of those three: not for the glyph (which `MenuIcons` draws itself
+ * over it), but for the BOX — a fixed 16 px slot that indents every name by the
+ * same amount, which is what makes the column line up.
+ * @param kind - the row's kind in this plugin's vocabulary.
+ * @returns the framework kind to declare.
+ */
+export declare function menuIconKind(kind: MentionIconKind): 'file' | 'folder' | 'session';
+/** The row facts one menu glyph is chosen from. */
+export interface MenuGlyphRow {
+    readonly mentionKind: string;
+    readonly value?: string;
+    readonly atFileKind?: 'file' | 'dir';
+    readonly providerId?: string;
+}
+/**
+ * The colour one menu row's glyph is drawn in.
+ * @param row - the candidate row.
+ * @returns the accent for a category row (its prefix, else its provider id), or
+ *   undefined for a row that carries data, which keeps the neutral glyph colour.
+ */
+export declare function menuGlyphColor(row: MenuGlyphRow): string | undefined;
+export declare function menuGlyph(row: MenuGlyphRow, size?: number): ReactElement;

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

@@ -0,0 +1,8 @@
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** Required services: picker pipeline, session projection, carrier, Remote face, slots, and locale. */
+export declare const inject: string[];
+/**
+ * Compose the @ mention surface.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,267 @@
+/**
+ * `atlas` locale namespace: reference dock, category menu, and settings copy.
+ * Chinese is the product copy; English mirrors it.
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'dock.aria': string;
+    'dock.remove': string;
+    'dock.missing': string;
+    'dock.missingTitle': string;
+    'dock.cost': string;
+    'dock.costWarn': string;
+    nav: string;
+    'cat.file': string;
+    'cat.folder': string;
+    'cat.skill': string;
+    'cat.chat': string;
+    'cat.plugin': string;
+    'cat.tag.chat': string;
+    'hint.complete': string;
+    'nav.back': string;
+    'group.expand': string;
+    'group.collapse': string;
+    'plugin.scope.other': string;
+    'section.recent': string;
+    'section.usage': string;
+    'section.relevance': string;
+    'folder.outside': string;
+    'settings.folderOpen': string;
+    'settings.folderOpenDesc': string;
+    'settings.folderOpen.both': string;
+    'settings.folderOpen.sidebar': string;
+    'settings.folderOpen.native': string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+    'group.ungrouped': string;
+    'tier.system': string;
+    'tier.user': string;
+    'tier.project': string;
+    'tier.custom': string;
+    'tier.plugin': string;
+    'settings.title': string;
+    'settings.subtitle': string;
+    'settings.enabled': string;
+    'settings.enabledDesc': string;
+    'settings.enableSkills': string;
+    'settings.enableSkillsDesc': string;
+    'settings.enableChats': string;
+    'settings.enableChatsDesc': string;
+    'settings.enablePlugins': string;
+    'settings.enablePluginsDesc': string;
+    'settings.ignorePastedMentions': string;
+    'settings.ignorePastedMentionsDesc': string;
+    'settings.ignoreFiles': string;
+    'settings.ignoreFilesDesc': string;
+    'settings.scope': string;
+    'settings.global': string;
+    'settings.workspace': string;
+    'settings.globalTitle': string;
+    'settings.globalDesc': string;
+    'settings.workspaceTitle': string;
+    'settings.workspaceDesc': string;
+    'settings.workspaceSelect': string;
+    'settings.noWorkspace': string;
+    'settings.restoreDefaults': string;
+    'settings.clearWorkspace': string;
+    'settings.emptyGlobal': string;
+    'settings.emptyWorkspace': string;
+    'settings.namePlaceholder': string;
+    'settings.regexPlaceholder': string;
+    'settings.nameHint': string;
+    'settings.regexHint': string;
+    'settings.invalidName': string;
+    'settings.invalidRegex': string;
+    'settings.duplicateName': string;
+    'settings.inheritedName': string;
+    'settings.add': string;
+    'settings.saving': string;
+    'settings.remove': string;
+    'settings.inherited': string;
+    'settings.ruleType': string;
+    'settings.kind.exact': string;
+    'settings.kind.regex': string;
+    'settings.caseSensitive': string;
+    'settings.caseInsensitive': string;
+    'settings.caseSensitiveOption': string;
+    'folder.title': string;
+    'folder.aria': string;
+    'folder.drives': string;
+    'folder.up': string;
+    'folder.system': string;
+    'folder.loading': string;
+    'folder.empty': string;
+    'folder.truncated': string;
+    'folder.error.outside': string;
+    'folder.error.missing': string;
+    'folder.error.notDirectory': string;
+    'folder.choose': string;
+    'folder.chooseHint': string;
+    'folder.outsideGroup': string;
+    'folder.workspaceGroup': string;
+    'folder.pathGroup': string;
+    'file.scopeGroup': string;
+    'folder.drive': string;
+    'folder.error.unavailable': string;
+    'picker.title': string;
+    'picker.path': string;
+    'picker.go': string;
+    'picker.editPath': string;
+    'picker.crumbs': string;
+    'picker.home': string;
+    'picker.list': string;
+    'picker.loading': string;
+    'picker.empty': string;
+    'picker.truncated': string;
+    'picker.newFolder': string;
+    'picker.folderName': string;
+    'picker.create': string;
+    'picker.showHidden': string;
+    'picker.cancel': string;
+    'picker.open': string;
+    'picker.error': string;
+};
+/** The `at-file` namespace key union. */
+export type AtFileKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'dock.aria': string;
+    'dock.remove': string;
+    'dock.missing': string;
+    'dock.missingTitle': string;
+    'dock.cost': string;
+    'dock.costWarn': string;
+    nav: string;
+    'cat.file': string;
+    'cat.folder': string;
+    'cat.skill': string;
+    'cat.chat': string;
+    'cat.plugin': string;
+    'cat.tag.chat': string;
+    'hint.complete': string;
+    'nav.back': string;
+    'group.expand': string;
+    'group.collapse': string;
+    'plugin.scope.other': string;
+    'section.recent': string;
+    'section.usage': string;
+    'section.relevance': string;
+    'settings.folderOpen': string;
+    'settings.folderOpenDesc': string;
+    'settings.folderOpen.both': string;
+    'settings.folderOpen.sidebar': string;
+    'settings.folderOpen.native': string;
+    'folder.outside': string;
+    'time.now': string;
+    'time.minutes': string;
+    'time.hours': string;
+    'time.days': string;
+    'time.months': string;
+    'time.years': string;
+    'group.ungrouped': string;
+    'tier.system': string;
+    'tier.user': string;
+    'tier.project': string;
+    'tier.custom': string;
+    'tier.plugin': string;
+    'settings.title': string;
+    'settings.subtitle': string;
+    'settings.enabled': string;
+    'settings.enabledDesc': string;
+    'settings.enableSkills': string;
+    'settings.enableSkillsDesc': string;
+    'settings.enableChats': string;
+    'settings.enableChatsDesc': string;
+    'settings.enablePlugins': string;
+    'settings.enablePluginsDesc': string;
+    'settings.ignorePastedMentions': string;
+    'settings.ignorePastedMentionsDesc': string;
+    'settings.ignoreFiles': string;
+    'settings.ignoreFilesDesc': string;
+    'settings.scope': string;
+    'settings.global': string;
+    'settings.workspace': string;
+    'settings.globalTitle': string;
+    'settings.globalDesc': string;
+    'settings.workspaceTitle': string;
+    'settings.workspaceDesc': string;
+    'settings.workspaceSelect': string;
+    'settings.noWorkspace': string;
+    'settings.restoreDefaults': string;
+    'settings.clearWorkspace': string;
+    'settings.emptyGlobal': string;
+    'settings.emptyWorkspace': string;
+    'settings.namePlaceholder': string;
+    'settings.regexPlaceholder': string;
+    'settings.nameHint': string;
+    'settings.regexHint': string;
+    'settings.invalidName': string;
+    'settings.invalidRegex': string;
+    'settings.duplicateName': string;
+    'settings.inheritedName': string;
+    'settings.add': string;
+    'settings.saving': string;
+    'settings.remove': string;
+    'settings.inherited': string;
+    'settings.ruleType': string;
+    'settings.kind.exact': string;
+    'settings.kind.regex': string;
+    'settings.caseSensitive': string;
+    'settings.caseInsensitive': string;
+    'settings.caseSensitiveOption': string;
+    'folder.title': string;
+    'folder.aria': string;
+    'folder.drives': string;
+    'folder.up': string;
+    'folder.system': string;
+    'folder.loading': string;
+    'folder.empty': string;
+    'folder.truncated': string;
+    'folder.error.outside': string;
+    'folder.error.missing': string;
+    'folder.error.notDirectory': string;
+    'folder.choose': string;
+    'folder.chooseHint': string;
+    'folder.outsideGroup': string;
+    'folder.workspaceGroup': string;
+    'folder.pathGroup': string;
+    'file.scopeGroup': string;
+    'folder.drive': string;
+    'folder.error.unavailable': string;
+    'picker.title': string;
+    'picker.path': string;
+    'picker.go': string;
+    'picker.editPath': string;
+    'picker.crumbs': string;
+    'picker.home': string;
+    'picker.list': string;
+    'picker.loading': string;
+    'picker.empty': string;
+    'picker.truncated': string;
+    'picker.newFolder': string;
+    'picker.folderName': string;
+    'picker.create': string;
+    'picker.showHidden': string;
+    'picker.cancel': string;
+    'picker.open': string;
+    'picker.error': string;
+};
+/** Locale namespace id registered under ctx.locale. */
+export declare const NS = "atlas";
+/**
+ * Fill one dictionary template's `{name}`-style placeholders.
+ * @param template - dictionary text.
+ * @param params - placeholder values; absent params replace nothing.
+ * @returns the filled text.
+ */
+export declare function fmt(template: string, params?: Record<string, string>): string;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The @file reference and settings copy. */
+        [NS]: AtFileKey;
+    }
+}

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

@@ -0,0 +1,38 @@
+/**
+ * Pure display projections for the @file picker: the split of a relative path
+ * into basename + directory for the picker rows. The Host validates selected
+ * paths and adds existence-only reference markers at send time.
+ */
+/** The directory prefix of a forward-slash relative path ('' for root-level files). */
+export declare function dirnameOf(relative: string): string;
+/** The basename of a forward-slash relative path. */
+export declare function basenameOf(relative: string): string;
+/**
+ * Derive the canonical workspace path from an absolute file path and its
+ * workspace-relative path (the index walk emits forward-slash relatives).
+ */
+export declare function workspaceFromAbsolute(absolute: string, relative: string): string;
+/**
+ * The canonical key one referenced path is looked up under.
+ *
+ * A verdict and the token it answers for do not always spell a path the same
+ * way: the Host answers an out-of-workspace path in its own canonical spelling
+ * (forward slashes) while the user typed the platform's (`@E:\…`), and a folder
+ * mention may carry a trailing separator the path itself has not. Every verdict
+ * map is keyed — and every lookup made — through this, so the answer is found
+ * whichever spelling the draft used.
+ * @param value - a referenced path in either separator spelling.
+ * @returns the key both sides agree on.
+ */
+export declare function referenceKey(value: string): string;
+/**
+ * One child path under one directory, safe at a drive root.
+ *
+ * A listing's `path` carries a trailing separator only when it IS a drive root
+ * (`E:/`), so a plain `${path}/${name}` would produce `E://name` there. Both the
+ * folder tab and the menu browser join paths through this.
+ * @param path - the listing's own canonical path.
+ * @param name - one entry name.
+ * @returns the child's canonical path.
+ */
+export declare function childOf(path: string, name: string): string;