@kirkchinese/dsh-citeciter 0.9.0-beta.2 → 0.9.0-beta.4

package/lib/types/client/components/CiteCiterSettings.d.ts

@@ -4,13 +4,24 @@ import type { SettingsDocumentSnapshot } from '../settings-document.ts';
 import type { CompanionSnapshot } from '../companion-controller.ts';
 import type { CompanionActions, UpdateActions, SettingsDocumentActions } from '../view-actions.ts';
 import type { SettingsSectionOwnerProps } from '@deepseek-ai/dsh-client-ui-settings/client';
-export interface CiteCiterSettingsProps extends SettingsSectionOwnerProps {
+import type { CiteOverlaySnapshot } from '../types.ts';
+/** What the settings page needs; the host's settings and plugin pages each add their own owner props. */
+export interface CiteCiterSettingsProps extends Partial<SettingsSectionOwnerProps> {
     readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
     readonly useDocument: SnapshotSelectorHook<SettingsDocumentSnapshot>;
     readonly useUpdate: SnapshotSelectorHook<UpdateNoticeSnapshot>;
     readonly companion: CompanionActions;
     readonly settingsDocument: SettingsDocumentActions;
     readonly updateController: UpdateActions;
+    /** Where the workspace lives; the width setting applies only to Citer's own overlay. */
+    readonly useOverlay?: SnapshotSelectorHook<CiteOverlaySnapshot> | undefined;
 }
+/**
+ * Citer's entry on DSH's plugin page: a one-line summary in the list, the full settings on its page.
+ * @param view - `summary` for the bundle row, `page` for the bundle's own page.
+ */
+export declare function CiterPluginConfig(props: CiteCiterSettingsProps & {
+    readonly view: 'summary' | 'page';
+}): import("react").JSX.Element;
 /** Native DSH settings page for Citer preferences. */
-export declare function CiteCiterSettings({ useCompanion, useDocument, useUpdate, companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;
+export declare function CiteCiterSettings({ useCompanion, useDocument, useUpdate, useOverlay, companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;

package/lib/types/client/components/CitePanel.d.ts

@@ -4,6 +4,8 @@ import type { InteractionSnapshot } from '../host-ui-adapter.ts';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
 import type { UseSessions } from '@deepseek-ai/dsh-client-ui-session/client';
 import type { CiteOverlaySnapshot } from '../types.ts';
+import type { SelectionSurfaces } from '../wheel-gesture.ts';
+import type { FileOpener } from '../native-file-link.ts';
 import type { CompanionSnapshot } from '../companion-controller.ts';
 import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 export interface CitePanelProps {
@@ -21,10 +23,21 @@ export interface CitePanelProps {
     readonly reportParseError: (messageId: string) => void;
     /** Host standard prop: the session list, used to show source titles on reference chips. */
     readonly useSessions?: UseSessions;
+    /** Makes text selected in the transcript a Citer action source that continues this Topic. */
+    readonly registerSurface?: SelectionSurfaces['register'];
+    /** Opens a source-workspace file in DSH's right sidebar. */
+    readonly openFile?: FileOpener;
+    /**
+     * `tab` renders inside a DSH right-sidebar tab, which owns placement, size, splitting,
+     * floating and closing; `overlay` is Citer's own dock for hosts without that sidebar.
+     */
+    readonly host?: 'overlay' | 'tab';
+    /** In a sidebar tab: whether the tab is on screen. */
+    readonly tabVisible?: boolean;
 }
 /**
  * Render the independent Topic workspace on the right edge of the shell.
  * @param props - shared panel bus, Topic controller, and host callbacks.
  * @returns the responsive Topic dock and its dialogs, or null while closed.
  */
-export declare function CitePanel({ nativeComposer, drafts, useDrafts, useCompanion, useOverlay, useInteractions, useSubmission, useSessions, bus, companion, closePanel, openReader, reportParseError }: CitePanelProps): import("react").JSX.Element | null;
+export declare function CitePanel({ nativeComposer, drafts, useDrafts, useCompanion, useOverlay, useInteractions, useSubmission, useSessions, bus, companion, closePanel, openReader, reportParseError, registerSurface, openFile, host, tabVisible }: CitePanelProps): import("react").JSX.Element | null;

package/lib/types/client/components/CiterTab.d.ts

@@ -0,0 +1,15 @@
+import type { UseSidebarRightTabInfo } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import { type CitePanelProps } from './CitePanel.tsx';
+/**
+ * Citer's workspace as a DSH right-sidebar tab. The sidebar owns placement, splitting, floating,
+ * fullscreen and closing; while the tab is on screen Citer counts as open, so the desktop pet
+ * steps aside and finished answers are not marked unread.
+ */
+export declare function CiterTab(props: CitePanelProps & {
+    readonly useTabInfo: UseSidebarRightTabInfo;
+}): import("react").JSX.Element;
+/** The mascot as the guide card and tab icon, at the size DSH draws icons. */
+export declare function CiterIcon({ size, className }: {
+    readonly size?: number | undefined;
+    readonly className?: string | undefined;
+}): import("react").JSX.Element;

package/lib/types/client/components/ContextRow.d.ts

@@ -0,0 +1,7 @@
+import type { TopicMessage } from '../../topic.ts';
+/** One logged context row; only known Host presentation copy is localized, never its model-visible body. */
+export declare function ContextRow({ message }: {
+    readonly message: Extract<TopicMessage, {
+        role: 'context';
+    }>;
+}): import("react").JSX.Element;

package/lib/types/client/components/PermissionControl.d.ts

@@ -1,6 +1,6 @@
 import type { CiteCiterSettings } from '../../topic.ts';
 export type PermissionMode = NonNullable<CiteCiterSettings['defaultPermission']>;
-/** Explicit permission selection; receives the Host's effective value. */
+/** Explicit permission selection in the host's menu; receives the Host's effective value. */
 export declare function PermissionControl({ value, onChange }: {
     readonly value: PermissionMode;
     readonly onChange: (mode: PermissionMode) => void;

package/lib/types/client/components/SelectionToolbar.d.ts

@@ -3,10 +3,12 @@ import { type CiteAction } from '../../actions.ts';
 import type { ActionSource } from '../action-controller.ts';
 import type { CompanionSnapshot } from '../companion-controller.ts';
 import type { SelectionToolbarSnapshot } from '../selection-toolbar.ts';
+/** The explicit way to start a separate Topic: the user's own question about the selection. */
 /** Toolbar callbacks; the controllers stay with the Client plugin. */
 export interface SelectionToolbarActions {
     readonly dismiss: () => void;
     readonly run: (source: ActionSource, action: CiteAction, x: number, y: number, newTopic?: boolean) => void;
+    readonly quote: (source: ActionSource) => Promise<void>;
 }
 /**
  * Actions for the current selection: the first configured actions inline, the rest and

package/lib/types/client/components/ToolMessage.d.ts

@@ -1,10 +1,15 @@
 import type { TopicMessage } from '../../topic.ts';
 import type { NativeComposer } from '../native-composer.ts';
-/** Show returned files immediately; the readable title and summary expand to the exact arguments and result. */
-export declare function ToolRow({ message, sessionId, load }: {
-    readonly message: Extract<TopicMessage, {
-        role: 'tool';
-    }>;
+type ToolMessage = Extract<TopicMessage, {
+    role: 'tool';
+}>;
+/** Keep a tool tree inside the parent's disclosure; absent metadata uses the original lossless inspector. */
+export declare function ToolRow({ message, childCalls, sessionId, load, openFile }: {
+    readonly message: ToolMessage;
+    readonly childCalls: readonly ToolMessage[];
     readonly sessionId: string;
     readonly load: NativeComposer['attachment'];
+    /** Open a source-workspace file in DSH's right sidebar; absent when the host has none. */
+    readonly openFile?: ((path: string, line?: number) => boolean) | undefined;
 }): import("react").JSX.Element;
+export {};

package/lib/types/client/components/TopicActions.d.ts

@@ -5,13 +5,16 @@ export interface TopicMenu {
     } | undefined;
     readonly busy: boolean;
     readonly learningRoute: boolean;
+    /** Whether ordinary context (runtime, time, skills, system prompt) is listed in the transcript. */
+    readonly allContext: boolean;
+    readonly onAllContext: (shown: boolean) => void;
     readonly onRename: () => void;
     readonly onLearningRoute: (enabled: boolean) => void;
     readonly onReader: () => void;
     readonly onArchive: (archived: boolean) => void;
     readonly onDelete: () => void;
 }
-/** The "⋯" menu: rename, learning route, document reader, archive and permanent deletion. */
+/** The "⋯" menu in the host's menu: rename, learning route, document reader, context visibility, archive and permanent deletion. */
 export declare function TopicActions({ menu }: {
     readonly menu: TopicMenu;
 }): import("react").JSX.Element;

package/lib/types/client/components/TopicHeader.d.ts

@@ -1,14 +1,15 @@
 import type { PointerEventHandler, ReactNode } from 'react';
 /**
  * Layout-only header. The Citer mark identifies the panel; dragging the header floats it.
- * Navigation, title and closing are supplied by their own controllers.
+ * Navigation, title and closing are supplied by their own controllers. In DSH's right sidebar
+ * the tab chip owns closing and moving, so `onClose` and `onDrag` are omitted there.
  * @param status - shown only while something is happening or needs attention.
  */
 export declare function TopicHeader({ compact, onBack, onClose, onDrag, title, status, children }: {
     readonly compact: boolean;
     readonly onBack: () => void;
-    readonly onClose: () => void;
-    readonly onDrag: PointerEventHandler<HTMLElement>;
+    readonly onClose?: (() => void) | undefined;
+    readonly onDrag?: PointerEventHandler<HTMLElement> | undefined;
     readonly title: ReactNode;
     readonly status: string | null;
     readonly children: ReactNode;

package/lib/types/client/components/TopicModelControls.d.ts

@@ -1,5 +1,5 @@
 import type { ProviderOption, TopicModelConfig } from '../../topic.ts';
-/** Model and reasoning hierarchy. Route changes are committed by the injected controller. */
+/** Model and reasoning choices in the host's menu. Route changes are committed by the injected controller. */
 export declare function TopicModelControls({ providers, route, saving, onModel, onReasoning }: {
     readonly providers: readonly ProviderOption[];
     readonly route: TopicModelConfig;

package/lib/types/client/components/TopicUsage.d.ts

@@ -0,0 +1,5 @@
+import type { TopicUsage as TopicUsageValue } from '../../topic.ts';
+/** Present Topic-owned token totals without fetching state or mutating the panel. */
+export declare function TopicUsage({ usage }: {
+    readonly usage?: TopicUsageValue;
+}): import("react").JSX.Element | null;

package/lib/types/client/components/UserMessageBody.d.ts

@@ -1,7 +1,12 @@
 import type { QuestionReply } from '../../question-reply.ts';
-/** Read-only presentation of a committed user message. Attachments remain inspectable and formulas are rendered without mutating the durable prompt. */
-export declare function UserMessageBody({ text, questionReply, sourceTitle }: {
+/**
+ * Read-only presentation of a committed user message. Attachments remain inspectable as reference
+ * chips and formulas are rendered without mutating the durable prompt. A learning-stage prompt
+ * collapses to its stage line and the user's own question.
+ */
+export declare function UserMessageBody({ text, questionReply, sourceTitle, stageClassName }: {
     readonly text: string;
     readonly questionReply?: QuestionReply | undefined;
     readonly sourceTitle?: ((sessionId: string) => string | undefined) | undefined;
+    readonly stageClassName?: string | undefined;
 }): import("react").JSX.Element;

package/lib/types/client/conversation-dom.d.ts

@@ -10,6 +10,8 @@ export interface DshAssistantAnchor {
     readonly element: HTMLElement;
     readonly anchorKey: string;
 }
+/** A committed ordinary user message in the native DSH chat. */
+export declare function dshUserAnchorForTarget(target: EventTarget | null): DshAssistantAnchor | null;
 /** Best-effort Read Frog selection classification. */
 export type ReadFrogSelection = {
     readonly kind: 'none';

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

@@ -1,6 +1,18 @@
-/** Chinese presentation copy owned by CiteCiter, including shared primitive chrome. */
-import type { JsonTreeLabels, MarkdownLabels } from '@deepseek-ai/dsh-client-ui-primitives';
-/** Localized labels supplied to the Cordis-free Markdown renderer. */
+/** Presentation copy for shared UI primitives. */
+import type { CodeToolbarLabels, DiffBlockLabels, JsonTreeLabels, MarkdownLabels, ReadBlockLabels, SearchBlockLabels, TerminalBlockLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Live getters keep consumers outside the transcript slice localized without changing their API. */
 export declare const markdownLabels: MarkdownLabels;
 /** Localized labels supplied to the Cordis-free JSON inspector. */
-export declare const jsonTreeLabels: JsonTreeLabels;
+export declare function jsonTreeLabels(): JsonTreeLabels;
+/** Shared toolbar copy for read and diff code surfaces. */
+export declare function codeToolbarLabels(): CodeToolbarLabels;
+/** DSH-style labels for numbered file reads. */
+export declare function readBlockLabels(): ReadBlockLabels;
+/** DSH-style labels for applied file differences. */
+export declare function diffBlockLabels(): DiffBlockLabels;
+/** Terminal status and output controls. */
+export declare function terminalBlockLabels(): TerminalBlockLabels & {
+    commandLine: (line: number) => string;
+};
+/** Result-count labels for grouped grep matches and glob paths. */
+export declare function searchBlockLabels(): SearchBlockLabels;

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

@@ -6,7 +6,9 @@ export type DraftReference = DraftContent['references'][number];
 export declare function mergeDraftReferences(current: readonly DraftReference[], incoming: readonly DraftReference[]): readonly DraftReference[];
 /** Build initial references without submitting them. Stable Topic-scoped IDs preserve menu focus during live snapshot refreshes. */
 export declare function topicDraftReferences(topic: TopicSummary, documentTitle?: string): readonly DraftReference[];
-/** Display a document filename while retaining the full title/path in its serialized content. Legacy ID-only references keep their generic label. */
+/** Translate only the visible chip kind; reference.label remains the serialized Chinese marker. */
+export declare function draftReferenceLabel(reference: DraftReference): string;
+/** Display a document filename while retaining the full title/path in its serialized content. */
 export declare function draftReferenceName(reference: DraftReference): string;
 /**
  * Chip text that shows what a reference contains instead of its kind. Serialized labels

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

@@ -6,6 +6,7 @@
  */
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ActionSource } from './action-controller.ts';
 import type { CiteSelection } from './types.ts';
 /** Live browser facts an entry needs to resolve one selection. */
 export interface CiteCiterEntryContext {
@@ -51,6 +52,8 @@ export declare function createCiteCiterEntryRegistry(): CiteCiterEntryRegistry;
  * @returns the entry contribution; register it on the shared registry.
  */
 export declare function createAssistantEntry(): CiteCiterEntry;
+/** Capture a committed user-message excerpt without inventing a host-verified citation claim. */
+export declare function readUserMessageQuote(event: MouseEvent, context: CiteCiterEntryContext): ActionSource | null;
 /**
  * Built-in tool evidence entry: claims a whole-card tool result from its
  * `call:<callId>` row and the enclosing `tool-call` chat flow. Terminal and

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

@@ -0,0 +1,23 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type CiterKey } from './locales/index.ts';
+export type { CiterKey } from './locales/index.ts';
+/** DSH locale namespace that holds Citer's dictionaries. */
+export declare const CITER_LOCALE_NAMESPACE = "citeciter";
+/** Fill `{name}` placeholders, as DSH's own dictionaries do. */
+export declare function formatText(template: string, params?: Record<string, unknown>): string;
+/**
+ * Translate one Citer key in the active DSH language.
+ * @param key - dictionary key.
+ * @param params - `{name}` placeholder values.
+ */
+export declare function t(key: CiterKey, params?: Record<string, unknown>): string;
+/** Whether DSH currently shows Chinese; picks localized defaults such as preset action prompts. */
+export declare function isChinese(): boolean;
+/** Re-render on DSH language changes; returns a revision usable as a memo dependency. */
+export declare function useLocale(): number;
+/**
+ * Register Citer's dictionaries and follow the active language for the lifetime of `ctx`.
+ * Without DSH's locale service, text stays Chinese.
+ * @param ctx - Client root context.
+ */
+export declare function installLocale(ctx: Context): void;

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

@@ -0,0 +1,51 @@
+/** The blackboard, its animation player, learning cards and the learning route. */
+export declare const zh: {
+    'board.title': string;
+    'board.workspace.label': string;
+    'board.workspace.empty': string;
+    'board.svg.alt': string;
+    'board.html.title': string;
+    'board.image.invalid': string;
+    'board.image.alt': string;
+    'board.label': string;
+    'board.subtitle': string;
+    'board.waiting': string;
+    'board.revision': string;
+    'board.view.canvas': string;
+    'board.view.notes': string;
+    'board.warning.invalid': string;
+    'board.empty': string;
+    'board.quote.label': string;
+    'board.quote.action': string;
+    'board.animation.label': string;
+    'board.animation.pause': string;
+    'board.animation.play': string;
+    'board.animation.replay': string;
+    'board.animation.progress': string;
+    'board.animation.step': string;
+    'board.cards.label': string;
+    'board.cards.eyebrow': string;
+    'board.cards.question': string;
+    'board.cards.example': string;
+    'board.cards.answer': string;
+    'board.cards.reveal': string;
+    'board.cards.kicker': string;
+    'board.cards.title': string;
+    'board.cards.recall': string;
+    'board.cards.recallOn': string;
+    'board.cards.recallOff': string;
+    'board.cards.invalid': string;
+    'board.cards.empty.title': string;
+    'board.cards.empty.description': string;
+    'board.cards.prepare': string;
+    'board.cards.export': string;
+    'board.cards.revise': string;
+    'board.cards.provenance': string;
+    'board.cards.saved': string;
+    'board.cards.markdown.source': string;
+    'board.cards.markdown.example': string;
+    'board.cards.markdown.selfTest': string;
+    'board.route.progress': string;
+    'board.route.completed': string;
+};
+export declare const en: Record<keyof typeof zh, string>;

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

@@ -0,0 +1,7 @@
+/** Shared words used across Citer's interface. */
+export declare const zh: {
+    'common.name': string;
+    'common.cancel': string;
+    'common.close': string;
+};
+export declare const en: Record<keyof typeof zh, string>;