@kirkchinese/dsh-citeciter 0.4.3 → 0.6.0

package/lib/{typert-common-4_cbghYz.js → typert-common-C6yTitXx.js}

@@ -1,4 +1,4 @@
-import { l as citeCiterRequestSchema, u as citeCiterResponseSchema } from "./topic-BVNCaVbJ.js";
+import { f as citeCiterRequestSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema } from "./update-C0K5ekMg.js";
 //#region lib/types/typert-common.js
 /** Strict root-scoped Topic command shared by Host and browser manifests. */
 const citeCiterRequestDescriptor = {
@@ -25,9 +25,29 @@ const citeCiterRequestDescriptor = {
 	},
 	sourceLocation: {
 		file: "src/index.ts",
-		line: 66,
+		line: 127,
+		column: 3
+	}
+};
+/** Strict root-scoped read-only update check shared by Host and browser manifests. */
+const updateCheckDescriptor = {
+	id: "@kirkchinese/dsh-citeciter#citeciter/checkUpdate",
+	service: "citeciter",
+	namespace: "citeciter",
+	method: "checkUpdate",
+	invocation: { kind: "direct" },
+	parameters: [],
+	cancellation: { parameter: "signal" },
+	result: {
+		mode: "strict",
+		typeSymbol: "@kirkchinese/dsh-citeciter#UpdateCheckResponse",
+		schema: updateCheckResponseSchema
+	},
+	sourceLocation: {
+		file: "src/index.ts",
+		line: 134,
 		column: 3
 	}
 };
 //#endregion
-export { citeCiterRequestDescriptor as t };
+export { updateCheckDescriptor as n, citeCiterRequestDescriptor as t };

package/lib/typert.host.js

@@ -1,5 +1,5 @@
-import { h as topicSummarySchema, l as citeCiterRequestSchema, m as topicSnapshotSchema, o as citationDraftSchema, s as citationRecordSchema, u as citeCiterResponseSchema } from "./topic-BVNCaVbJ.js";
-import { t as citeCiterRequestDescriptor } from "./typert-common-4_cbghYz.js";
+import { C as topicSummarySchema, S as topicSnapshotSchema, f as citeCiterRequestSchema, l as citationDraftSchema, p as citeCiterResponseSchema, r as updateCheckResponseSchema, u as citationRecordSchema } from "./update-C0K5ekMg.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-C6yTitXx.js";
 //#region lib/types/typert.host.js
 /** Handwritten strict Host contribution matching the single Remote decorator. */
 const TYPERT = {
@@ -29,6 +29,10 @@ const TYPERT = {
 		{
 			name: "CiteCiterResponse",
 			schema: citeCiterResponseSchema
+		},
+		{
+			name: "UpdateCheckResponse",
+			schema: updateCheckResponseSchema
 		}
 	],
 	model: {
@@ -36,7 +40,7 @@ const TYPERT = {
 		events: [],
 		objects: []
 	},
-	invocations: [citeCiterRequestDescriptor]
+	invocations: [citeCiterRequestDescriptor, updateCheckDescriptor]
 };
 //#endregion
 export { TYPERT, TYPERT as default };

package/lib/typert.remote-client.js

@@ -1,9 +1,9 @@
-import { t as citeCiterRequestDescriptor } from "./typert-common-4_cbghYz.js";
+import { n as updateCheckDescriptor, t as citeCiterRequestDescriptor } from "./typert-common-C6yTitXx.js";
 //#region lib/types/typert.remote-client.js
 /** Browser contribution mounted by the CiteCiter Client fiber. */
 const TYPERT_REMOTE = {
 	package: "@kirkchinese/dsh-citeciter",
-	descriptors: [citeCiterRequestDescriptor]
+	descriptors: [citeCiterRequestDescriptor, updateCheckDescriptor]
 };
 //#endregion
 export { TYPERT_REMOTE, TYPERT_REMOTE as default };

package/lib/types/board.d.ts

@@ -0,0 +1,237 @@
+/** Shared blackboard protocol v4 and deterministic state folding. */
+import { z } from 'zod';
+/** Wire/version identity carried by every board snapshot. */
+export declare const BOARD_PROTOCOL_VERSION: 4;
+/** Maximum operations accepted in one atomic board commit. */
+export declare const BOARD_MAX_BATCH_OPS = 50;
+/** Maximum elements retained on one board. */
+export declare const BOARD_MAX_ELEMENTS = 50;
+/** Maximum combined UTF-8 element-content bytes retained on one board. */
+export declare const BOARD_MAX_CONTENT_BYTES = 500000;
+/** Element kinds the blackboard renders safely on the chalk canvas. */
+export declare const boardElementKindSchema: z.ZodEnum<{
+    text: "text";
+    markdown: "markdown";
+    math: "math";
+    svg: "svg";
+    html: "html";
+    image: "image";
+    table: "table";
+}>;
+export type BoardElementKind = z.infer<typeof boardElementKindSchema>;
+/** Style keys the board renderer applies directly as inline CSS properties. */
+export declare const boardStyleSchema: z.ZodObject<{
+    color: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BoardStyle = z.infer<typeof boardStyleSchema>;
+/** One deterministic blackboard command in canvas-percent coordinates. */
+export declare const boardOpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"clear">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set">;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        text: "text";
+        markdown: "markdown";
+        math: "math";
+        svg: "svg";
+        html: "html";
+        image: "image";
+        table: "table";
+    }>;
+    content: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"update">;
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    w: z.ZodOptional<z.ZodNumber>;
+    h: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"clear_region">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"animate">;
+    id: z.ZodString;
+    animation: z.ZodEnum<{
+        "fade-in": "fade-in";
+        "slide-in": "slide-in";
+        pulse: "pulse";
+        highlight: "highlight";
+    }>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"focus">;
+    id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "op">;
+export type BoardOp = z.infer<typeof boardOpSchema>;
+/** One validated, non-empty atomic blackboard commit. */
+export declare const boardBatchSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"clear">;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"set">;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        text: "text";
+        markdown: "markdown";
+        math: "math";
+        svg: "svg";
+        html: "html";
+        image: "image";
+        table: "table";
+    }>;
+    content: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"update">;
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    w: z.ZodOptional<z.ZodNumber>;
+    h: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"clear_region">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"animate">;
+    id: z.ZodString;
+    animation: z.ZodEnum<{
+        "fade-in": "fade-in";
+        "slide-in": "slide-in";
+        pulse: "pulse";
+        highlight: "highlight";
+    }>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    iterations: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"focus">;
+    id: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "op">>;
+/** One rendered blackboard element after op folding. */
+export interface BoardElementState {
+    readonly id: string;
+    readonly kind: BoardElementKind;
+    readonly content: string;
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly style: BoardStyle;
+    readonly focused: boolean;
+    readonly animation?: {
+        readonly name: 'fade-in' | 'slide-in' | 'pulse' | 'highlight';
+        readonly durationMs: number;
+        readonly iterations: number;
+        readonly run: number;
+    } | undefined;
+}
+/** Immutable blackboard state keyed by element id. */
+export type BoardState = ReadonlyMap<string, BoardElementState>;
+/** Empty immutable input for the first board commit. */
+export declare const EMPTY_BOARD_STATE: BoardState;
+/**
+ * Apply one validated op batch atomically to the current board state.
+ * @param state - current element map.
+ * @param ops - validated, non-empty ops in application order.
+ * @returns the new state and the number of applied ops.
+ */
+export declare function applyBoardOps(state: BoardState, ops: readonly BoardOp[]): {
+    readonly state: BoardState;
+    readonly revision: number;
+};
+/** Snapshot field containing only the final projected board state. */
+export declare const boardSnapshotSchema: z.ZodObject<{
+    version: z.ZodLiteral<4>;
+    revision: z.ZodNumber;
+    elements: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            text: "text";
+            markdown: "markdown";
+            math: "math";
+            svg: "svg";
+            html: "html";
+            image: "image";
+            table: "table";
+        }>;
+        content: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        style: z.ZodObject<{
+            color: z.ZodOptional<z.ZodString>;
+            fontSize: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        focused: z.ZodBoolean;
+        animation: z.ZodOptional<z.ZodObject<{
+            name: z.ZodEnum<{
+                "fade-in": "fade-in";
+                "slide-in": "slide-in";
+                pulse: "pulse";
+                highlight: "highlight";
+            }>;
+            durationMs: z.ZodNumber;
+            iterations: z.ZodNumber;
+            run: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    invalid: z.ZodNumber;
+}, z.core.$strict>;
+export type BoardSnapshot = z.infer<typeof boardSnapshotSchema>;
+/** Empty snapshot used before any board commit. */
+export declare const EMPTY_BOARD_SNAPSHOT: BoardSnapshot;
+/**
+ * Read renderable elements from one final-state snapshot.
+ * @param snapshot - projected final board state.
+ * @returns ordered elements plus the committed revision.
+ */
+export declare function foldBoardSnapshot(snapshot: BoardSnapshot): {
+    readonly elements: readonly BoardElementState[];
+    readonly revision: number;
+};
+/**
+ * Fold a raw op list from first-set order; used by protocol tests.
+ * @param ops - one validated op batch.
+ * @returns final elements in insertion order.
+ */
+export declare function foldBoardElements(ops: readonly BoardOp[]): readonly BoardElementState[];

package/lib/types/client/companion-controller.d.ts

@@ -1,7 +1,10 @@
-import { type ISessions, type SessionId, type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
-import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type ProviderOption, type QuestionAnswer, type TopicSnapshot, type TopicSummary } from '../topic.ts';
-import { type CreateMode } from './request-guard.ts';
+import { type CiteCiterRequest, type CiteCiterResponse, type CiteCiterSettings, type ProviderOption, type QuestionAnswer, type TopicScenario, type TopicSnapshot, type TopicSummary } from '../topic.ts';
+import { type CreateMode, type DocumentClaimIntent } from './request-guard.ts';
 import type { CiteSelection } from './types.ts';
 export type CompanionPhase = 'idle' | 'creating' | 'ready' | 'running' | 'stopping' | 'stopped' | 'error';
 export type { CreateMode } from './request-guard.ts';
@@ -24,6 +27,8 @@ export interface CompanionSnapshot {
     reasoningEffortSaving: boolean;
     renaming: boolean;
     archiving: boolean;
+    deleting: boolean;
+    notice: string | null;
     includeArchived: boolean;
     error: string | null;
 }
@@ -32,8 +37,10 @@ export interface CompanionFace {
     getSnapshot(): CompanionSnapshot;
     subscribe(listener: () => void): () => void;
     setSource(sessionId: SessionId | null): void;
-    setVisible(visible: boolean): void;
-    create(selection: CiteSelection, question: string, mode?: CreateMode): Promise<void>;
+    retainVisible(): () => void;
+    create(selection: CiteSelection, question: string, mode?: CreateMode, scenario?: TopicScenario): Promise<void>;
+    createFree(question: string, scenario: Extract<TopicScenario, 'qa' | 'present'>): Promise<boolean>;
+    createFromDocument(claim: DocumentClaimIntent, question: string): Promise<void>;
     openTopic(sessionId: string): Promise<void>;
     ask(question: string): Promise<boolean>;
     answerQuestion(key: string, answer: QuestionAnswer): Promise<void>;
@@ -41,6 +48,8 @@ export interface CompanionFace {
     stop(): Promise<void>;
     rename(title: string): Promise<boolean>;
     archive(archived: boolean): Promise<boolean>;
+    deleteTopic(confirmSessionId: string): Promise<'complete' | 'pending' | false>;
+    dismissError(): void;
     setIncludeArchived(include: boolean): void;
     setModelRoute(provider: string, model: string): Promise<void>;
     setReasoningEffort(reasoningEffort: string | null): Promise<void>;
@@ -50,4 +59,4 @@ export interface CompanionFace {
 /** Initial browser snapshot for the root-scoped CiteCiter controller. */
 export declare const INITIAL_COMPANION_SNAPSHOT: CompanionSnapshot;
 /** Bind private Topic Remote calls to one browser snapshot and polling lifecycle. */
-export declare function createCompanionController(sessions: ISessions, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>): CompanionFace;
+export declare function createCompanionController(readChat: (sessionId: SessionId) => ChatSnapshot | undefined, settingsScope: SettingsScope<CiteCiterSettings>, request: RemoteRequest, onAutoOpen: () => void, store: SnapshotStore<CompanionSnapshot>): CompanionFace;

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

@@ -0,0 +1,18 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/** Additional faces owned by CiteCiter's conversation-view registration. */
+export interface BlackboardWorkspaceInjected {
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly companion: CompanionActions;
+    readonly bus: OverlayActions;
+    readonly openPanel: () => void;
+}
+export type BlackboardWorkspaceProps = ConvViewProps & BlackboardWorkspaceInjected;
+/**
+ * Render the session-scoped blackboard registered through conversation.view.
+ * @param props - active DSH conversation identity and CiteCiter browser faces.
+ * @returns the matching Topic board or a source-specific empty state.
+ */
+export declare function BlackboardWorkspace({ useCompanion, sessionId, companion, bus, openPanel }: BlackboardWorkspaceProps): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import 'katex/dist/katex.min.css';
+import { type BoardElementState, type BoardSnapshot } from '../../board.ts';
+/**
+ * Render one final-state blackboard projection in the main conversation workspace.
+ * @param props - board snapshot, motion preference, and optional citation action.
+ * @returns the safe blackboard canvas.
+ */
+export declare function BoardView({ snapshot, animations, onQuoteElement, }: {
+    readonly snapshot: BoardSnapshot | undefined;
+    readonly animations: boolean;
+    readonly onQuoteElement?: (element: BoardElementState) => void;
+}): import("react").JSX.Element;

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

@@ -1,9 +1,16 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { UpdateNoticeSnapshot } from '../update-controller.ts';
+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';
-import type { CompanionFace } from '../companion-controller.ts';
-import type { SettingsDocumentController } from '../settings-document.ts';
 export interface CiteCiterSettingsProps extends SettingsSectionOwnerProps {
-    readonly companion: CompanionFace;
-    readonly settingsDocument: SettingsDocumentController;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useDocument: SnapshotSelectorHook<SettingsDocumentSnapshot>;
+    readonly useUpdate: SnapshotSelectorHook<UpdateNoticeSnapshot>;
+    readonly companion: CompanionActions;
+    readonly settingsDocument: SettingsDocumentActions;
+    readonly updateController: UpdateActions;
 }
 /** Native DSH settings page for CiteCiter-owned preferences. */
-export declare function CiteCiterSettings({ companion, settingsDocument }: CiteCiterSettingsProps): import("react").JSX.Element;
+export declare function CiteCiterSettings({ useCompanion, useDocument, useUpdate, companion, settingsDocument, updateController }: CiteCiterSettingsProps): import("react").JSX.Element;

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

@@ -1,10 +1,18 @@
-import type { CompanionFace } from '../companion-controller.ts';
-import type { CiteBus } from '../types.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CiteOverlaySnapshot } from '../types.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 export interface CitePanelProps {
-    readonly bus: CiteBus;
-    readonly companion: CompanionFace;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly bus: OverlayActions;
+    readonly companion: CompanionActions;
     readonly closePanel: () => void;
     readonly reportParseError: (messageId: string) => void;
 }
-/** Independent learning workspace with a reversible Host-column compatibility adapter. */
-export declare function CitePanel({ bus, companion, closePanel, reportParseError }: CitePanelProps): import("react").JSX.Element | null;
+/**
+ * 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({ useCompanion, useOverlay, bus, companion, closePanel, reportParseError }: CitePanelProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,8 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { ReaderSnapshot } from '../reader-controller.ts';
+import type { ReaderActions } from '../view-actions.ts';
+/** Reader shell-overlay entry: compact trigger plus the document library panel. */
+export declare function DocumentReader({ reader, useReader }: {
+    readonly reader: ReaderActions;
+    readonly useReader: SnapshotSelectorHook<ReaderSnapshot>;
+}): import("react").JSX.Element;

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

@@ -1,7 +1,7 @@
-import type { CompanionFace } from '../companion-controller.ts';
+import type { CompanionActions } from '../view-actions.ts';
 import type { PendingQuestion } from '../../topic.ts';
 export interface QuestionCardProps {
-    readonly companion: CompanionFace;
+    readonly companion: CompanionActions;
     readonly pending: PendingQuestion;
 }
 /** Collect one standard DSH ask_user_question answer batch inside the private Topic. */

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

@@ -1,9 +1,17 @@
-import type { CompanionFace } from '../companion-controller.ts';
-import type { CiteBus } from '../types.ts';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { CiteOverlaySnapshot } from '../types.ts';
+import type { CompanionSnapshot } from '../companion-controller.ts';
+import type { CompanionActions, OverlayActions } from '../view-actions.ts';
 export interface SelectionMenuProps {
-    readonly bus: CiteBus;
-    readonly companion: CompanionFace;
+    readonly useCompanion: SnapshotSelectorHook<CompanionSnapshot>;
+    readonly useOverlay: SnapshotSelectorHook<CiteOverlaySnapshot>;
+    readonly bus: OverlayActions;
+    readonly companion: CompanionActions;
     readonly openPanel: () => void;
 }
-/** Ask the first question beside the selected source text. */
-export declare function SelectionMenu({ bus, companion, openPanel }: SelectionMenuProps): import("react").JSX.Element;
+/**
+ * Ask the first question beside the selected source text.
+ * @param props - shared selection state and Topic actions.
+ * @returns the contextual creation popover and companion launcher.
+ */
+export declare function SelectionMenu({ useCompanion, useOverlay, bus, companion, openPanel }: SelectionMenuProps): import("react").JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
+import type { UpdateNoticeSnapshot } from '../update-controller.ts';
+import type { UpdateActions } from '../view-actions.ts';
+/** Injected owner of the root-scoped update state. */
+export interface UpdateNoticeProps {
+    readonly useUpdate: SnapshotSelectorHook<UpdateNoticeSnapshot>;
+    readonly updateController: UpdateActions;
+}
+/**
+ * Render the non-modal Web update notice in the frame-wide overlay.
+ * @param props - root-scoped update actions and observable state.
+ * @returns the available-version card, or no surface while current or suppressed.
+ */
+export declare function UpdateNotice({ useUpdate, updateController }: UpdateNoticeProps): import("react").JSX.Element | null;

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

@@ -41,13 +41,21 @@ export declare function dshAssistantAnchorForTarget(target: EventTarget | null):
  */
 export declare function dshIntersectedAssistantAnchors(range: Range): DshAssistantAnchor[];
 /**
- * Detect generated controls, reasoning summaries, and collapsed code chrome.
+ * Detect generated controls and collapsed code chrome.
  *
  * @param range - current rendered selection range.
  * @param flow - assistant flow containing the range.
  * @returns whether the range touches content that CiteCiter must ignore.
  */
 export declare function dshRangeTouchesExcludedContent(range: Range, flow: HTMLElement): boolean;
+/**
+ * Detect a selection endpoint inside a generated reasoning disclosure row.
+ *
+ * @param range - current rendered selection range.
+ * @param flow - assistant flow containing the range.
+ * @returns whether a collapsed or expanded reasoning header anchors the selection.
+ */
+export declare function dshRangeHasReasoningHeaderEndpoint(range: Range, flow: HTMLElement): boolean;
 /**
  * Find the current DSH assistant element for a persisted anchor key.
  *

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

@@ -0,0 +1,6 @@
+/** 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. */
+export declare const markdownLabels: MarkdownLabels;
+/** Localized labels supplied to the Cordis-free JSON inspector. */
+export declare const jsonTreeLabels: JsonTreeLabels;

package/lib/types/client/dock-geometry.d.ts

@@ -0,0 +1,23 @@
+/** Space allocation for the learning panel inside the host content viewport. */
+export interface DockViewport {
+    readonly width: number;
+    readonly height: number;
+    readonly sidebar: number;
+    readonly details: number;
+    readonly caption: number;
+    readonly percent: number;
+}
+/** The host keeps its conversation and details visible in both arrangements. */
+export interface DockGeometry {
+    readonly mode: 'columns' | 'rows';
+    readonly width: number;
+    readonly height: number;
+    readonly top: number;
+}
+/**
+ * Reserve a separate column, or a bottom row when two readable columns cannot fit.
+ * CSS pixels already account for browser zoom and Windows display scaling.
+ * @param viewport - measured host dimensions and the saved width preference.
+ * @returns panel dimensions within the host, excluding its native caption.
+ */
+export declare function resolveDockGeometry(viewport: DockViewport): DockGeometry;

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

@@ -0,0 +1,61 @@
+/**
+ * Client entry-point registry: every "start a Citer from here" surface
+ * contributes one entry that probes the pointer event and claims a selection.
+ * Entries run in registration order; the first claim wins and is allowed to
+ * prevent the native context menu.
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { CiteSelection } from './types.ts';
+/** Live browser facts an entry needs to resolve one selection. */
+export interface CiteCiterEntryContext {
+    readonly readChat: (sessionId: SessionId) => ChatSnapshot | undefined;
+    readonly sourceSessionId: SessionId;
+}
+/** One Citer entry point: probe, capture, and claim a selection from the DOM. */
+export interface CiteCiterEntry {
+    /** Stable entry identity recorded on the claimed selection. */
+    readonly id: string;
+    /**
+     * Claim the current pointer event for this entry.
+     * @param event - context-menu event whose position anchors the claim.
+     * @param context - current source session and its bindings.
+     * @returns a validated selection, or null when this entry does not own the event.
+     */
+    claim(event: MouseEvent, context: CiteCiterEntryContext): CiteSelection | null;
+}
+/** Mutable ordered entry registry with effect-style registration. */
+export interface CiteCiterEntryRegistry {
+    /**
+     * Append one entry.
+     * @param entry - immutable entry contribution.
+     * @returns disposer removing the exact entry.
+     */
+    register(entry: CiteCiterEntry): () => void;
+    /** Registered entries in claim order. */
+    list(): readonly CiteCiterEntry[];
+    /**
+     * Ask entries in order for a claimed selection.
+     * @returns the first entry claim, or null when no entry owns the event.
+     */
+    claim(event: MouseEvent, context: CiteCiterEntryContext): {
+        readonly entry: CiteCiterEntry;
+        readonly selection: CiteSelection;
+    } | null;
+}
+/** Create an ordered client entry registry. */
+export declare function createCiteCiterEntryRegistry(): CiteCiterEntryRegistry;
+/**
+ * Built-in assistant answer entry: resolves a selection inside a committed
+ * `assistant-step` flow, including collapsed reasoning disclosure rows.
+ * @returns the entry contribution; register it on the shared registry.
+ */
+export declare function createAssistantEntry(): CiteCiterEntry;
+/**
+ * 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
+ * diff cards select their dedicated projections; everything else is
+ * `result-text`.
+ * @returns the entry contribution; register it after the assistant entry.
+ */
+export declare function createToolEvidenceEntry(): CiteCiterEntry;

package/lib/types/client/entry-ids.d.ts

@@ -0,0 +1,3 @@
+/** Stable identities for CiteCiter client entry points. */
+export declare const ASSISTANT_ENTRY_ID: "citeciter.entry.assistant";
+export declare const TOOL_ENTRY_ID: "citeciter.entry.tool";

package/lib/types/client/host-dock.d.ts

@@ -0,0 +1,18 @@
+/** Isolated, disposable layout adapter for DSH rc.1 and Desktop 2.0.5 frames. */
+import { type RefObject } from 'react';
+import { type DockGeometry } from './dock-geometry.ts';
+/**
+ * Locate the frame owning the public shell.overlay contribution.
+ * @param panel - mounted learning panel.
+ * @returns its immediate frame, or null before mounting.
+ */
+export declare function findContainingFrame(panel: HTMLElement | null): HTMLElement | null;
+/**
+ * Reserve host space without rewriting the host's saved columns or hiding details.
+ * Unknown frame structures receive no DOM changes. All owned styles disappear on close.
+ * @param panel - mounted panel reference.
+ * @param open - whether space should be reserved.
+ * @param percent - user's preferred fraction of the content viewport.
+ * @returns measured panel placement; null when the host frame is unsupported.
+ */
+export declare function useHostDock(panel: RefObject<HTMLElement | null>, open: boolean, percent: number): DockGeometry | null;