@poco-ai/agentero-dsh-library 0.0.0-stage → 0.1.0

package/lib/client/button.d.ts

@@ -0,0 +1,10 @@
+import { type VariantProps } from 'class-variance-authority';
+import type * as React from 'react';
+declare const buttonVariants: (props?: ({
+    variant?: "default" | "outline" | "secondary" | "ghost" | "destructive" | "link" | null | undefined;
+    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Button, buttonVariants };

package/lib/client/index.d.ts

@@ -0,0 +1,58 @@
+import type { Context } from '@deepseek-ai/cordis';
+declare const zh: {
+    title: string;
+    guideDescription: string;
+    filter: string;
+    colTitle: string;
+    colAuthors: string;
+    colYear: string;
+    colTags: string;
+    loading: string;
+    empty: string;
+    noMatches: string;
+    pdfDisabled: string;
+    vaultMissing: string;
+    invalid: string;
+    loadFailed: string;
+    importPlaceholder: string;
+    importAction: string;
+    discoverPlaceholder: string;
+    discoverAction: string;
+    exportBib: string;
+    importBib: string;
+    deletePaper: string;
+    download: string;
+    addTag: string;
+    removeTag: string;
+    confirmDelete: string;
+    actionFailed: string;
+    moreActions: string;
+    refresh: string;
+    openPaper: string;
+    editTags: string;
+    paperCount: string;
+    filteredCount: string;
+    clearResults: string;
+    invalidVault: string;
+    pickerUnavailable: string;
+};
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Library panel copy. */
+        'agentero.library': keyof typeof zh;
+    }
+}
+/** Browser plugin name. */
+export declare const name = "agentero-library";
+/**
+ * Slot and locale services. `agentero` stays optional: a row asks
+ * `ctx.get('agentero')` and reports a missing opener inside the panel.
+ */
+export declare const inject: string[];
+/**
+ * Register the library as one page in the session's right sidebar.
+ * The guide card opens it. The body does not replace the conversation.
+ * @param ctx - Browser plugin context.
+ */
+export declare function apply(ctx: Context): void;
+export {};

package/lib/client/input.d.ts

@@ -0,0 +1,2 @@
+declare const Input: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
+export { Input };

package/lib/client/library-actions.d.ts

@@ -0,0 +1,13 @@
+import type { LibraryT } from './papers';
+type LibraryActionsProps = {
+    t: LibraryT;
+    busy: boolean;
+    onImport: (text: string) => Promise<boolean>;
+    onDiscover: (keyword: string) => Promise<boolean>;
+    onImportBib: (file: File) => Promise<boolean>;
+    onExport: () => void;
+    onReload: () => void;
+};
+/** Import drafts stay outside the catalog, so typing never re-renders paper rows. */
+export declare function LibraryActions({ t, busy, onImport, onDiscover, onImportBib, onExport, onReload }: LibraryActionsProps): import("react").JSX.Element;
+export {};

package/lib/client/library-columns.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from 'react';
+import type { LibraryT, PaperRow } from './papers';
+export type SortDir = 'asc' | 'desc';
+export declare const COLUMN_ORDER: readonly ["title", "authors", "year", "tags"];
+export type ColumnKey = (typeof COLUMN_ORDER)[number];
+export interface CellCtx {
+    t: LibraryT;
+    busy: boolean;
+    /** Resolves true when the tag was written, so the composer keeps its draft on failure. */
+    onAddTag: (ref: string, tag: string) => Promise<boolean>;
+    onRemoveTag: (ref: string, name: string) => void;
+}
+interface ColumnDef {
+    labelKey: 'colTitle' | 'colAuthors' | 'colYear' | 'colTags';
+    headerClassName: string;
+    render: (paper: PaperRow, ctx: CellCtx) => ReactNode;
+}
+export declare function SortIcon({ active, dir }: {
+    active: boolean;
+    dir: SortDir;
+}): import("react").JSX.Element;
+export declare const COLUMN_META: Record<ColumnKey, ColumnDef>;
+export declare function sortValue(paper: PaperRow, key: ColumnKey): string;
+export declare function controlButtonClass(extra?: string): string;
+export {};

package/lib/client/library-controls.d.ts

@@ -0,0 +1,5 @@
+import { DropdownMenu, Popover } from 'radix-ui';
+import type { ComponentProps } from 'react';
+export declare function LibraryPopoverContent({ className, style, ...props }: ComponentProps<typeof Popover.Content>): import("react").JSX.Element;
+export declare function LibraryMenuContent({ className, style, ...props }: ComponentProps<typeof DropdownMenu.Content>): import("react").JSX.Element;
+export declare function LibraryMenuItem({ className, ...props }: ComponentProps<typeof DropdownMenu.Item>): import("react").JSX.Element;

package/lib/client/library-feedback.d.ts

@@ -0,0 +1,13 @@
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
+export type LibraryNotice = {
+    text: string;
+    sequence: number;
+} | null;
+export interface LibraryFeedbackFace {
+    hooks: {
+        notice: ObservableSnapshot<LibraryNotice>;
+    };
+    dismiss(): void;
+}
+export declare function LibraryFeedback({ useNotice, dismiss }: InjectFace<LibraryFeedbackFace>): import("react").JSX.Element | null;

package/lib/client/library-paper-row.d.ts

@@ -0,0 +1,17 @@
+import { type CellCtx } from './library-columns';
+import type { PaperRow } from './papers';
+type LibraryPaperRowProps = {
+    paper: PaperRow;
+    ctx: CellCtx;
+    busy: boolean;
+    /** Handlers take the row's ref so the panel can keep one stable identity per action. */
+    onOpen: (ref: string) => void;
+    onDownload: (ref: string) => void;
+    onDelete: (ref: string) => void;
+};
+/**
+ * One catalog row. Memoized: the panel re-renders on every filter keystroke, and
+ * without this each one rebuilt all rows and their tag inputs.
+ */
+export declare const LibraryPaperRow: import("react").MemoExoticComponent<({ paper, ctx, busy, onOpen, onDownload, onDelete, }: LibraryPaperRowProps) => import("react").JSX.Element>;
+export {};

package/lib/client/library-table-header.d.ts

@@ -0,0 +1,14 @@
+import type { ReactNode } from 'react';
+import { type ColumnKey, type SortDir } from './library-columns';
+import type { LibraryT } from './papers';
+type LibraryTableHeaderProps = {
+    t: LibraryT;
+    sortKey: ColumnKey;
+    sortDir: SortDir;
+    onSort: (key: ColumnKey) => void;
+    inputValue: string;
+    onInputChange: (value: string) => void;
+    actions: ReactNode;
+};
+export declare function LibraryTableHeader({ t, sortKey, sortDir, onSort, inputValue, onInputChange, actions, }: LibraryTableHeaderProps): import("react").JSX.Element;
+export {};

package/lib/client/paper-tag-chip.d.ts

@@ -0,0 +1,21 @@
+import type { MouseEvent as ReactMouseEvent, ReactNode } from 'react';
+import type { PaperTag } from './papers';
+type PaperTagChipProps = {
+    tag: PaperTag;
+    className?: string;
+    /** When set, chip is a button (e.g. copy-on-click in Library). */
+    onClick?: (event: ReactMouseEvent<HTMLButtonElement>) => void;
+    title?: string;
+    'aria-label'?: string;
+    /** Optional trailing control (e.g. remove). */
+    trailing?: ReactNode;
+};
+export declare function PaperTagChip({ tag, className, onClick, title, 'aria-label': ariaLabel, trailing, }: PaperTagChipProps): import("react").JSX.Element;
+type PaperTagRemoveButtonProps = {
+    tagName: string;
+    label: string;
+    disabled?: boolean;
+    onRemove: (name: string) => void;
+};
+export declare function PaperTagRemoveButton({ tagName, label, disabled, onRemove, }: PaperTagRemoveButtonProps): import("react").JSX.Element;
+export {};

package/lib/client/papers-library.d.ts

@@ -0,0 +1,6 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ReactNode } from 'react';
+import { type LibraryFace } from './papers';
+type LibraryPanelProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsLocale<'agentero.library'> & LibraryFace;
+export declare function LibraryPanel({ t, loadPapers, openPaper, importId, importBib, exportBib, discover, addTag, removeTag, deletePaper, download, notifyError, loadVault, }: LibraryPanelProps): ReactNode;
+export {};

package/lib/client/papers.d.ts

@@ -0,0 +1,51 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+export type LibraryT = PropsLocale<'agentero.library'>['t'];
+export interface VaultInfo {
+    path: string;
+    name: string;
+    scope: string;
+    recentVaults: {
+        path: string;
+        name: string;
+    }[];
+    canPick: boolean;
+}
+export interface LibraryFace {
+    notifyError(message: string): void;
+    loadVault(): Promise<VaultInfo>;
+    loadPapers(): Promise<unknown>;
+    openPaper(id: string): boolean;
+    importId(text: string): Promise<void>;
+    importBib(text: string): Promise<void>;
+    exportBib(): Promise<string>;
+    discover(keyword: string): Promise<{
+        id: string;
+        title: string;
+    }[]>;
+    addTag(ref: string, tag: string): Promise<void>;
+    removeTag(ref: string, tag: string): Promise<void>;
+    deletePaper(ref: string): Promise<void>;
+    download(ref: string): Promise<void>;
+}
+export interface PaperTag {
+    name: string;
+    color?: string | null;
+}
+export interface PaperRow {
+    key: string;
+    openId: string;
+    title: string;
+    authors: string;
+    year: string;
+    tags: PaperTag[];
+}
+export declare function errorText(body: unknown): string | undefined;
+export declare function papersFrom(body: unknown): PaperRow[];
+export declare function shown(message: string, t: LibraryT): string;
+export declare function readJson(response: Response): Promise<unknown>;
+export declare function postJson(url: string, body: unknown, request?: (url: string, init?: RequestInit) => Promise<Response>): Promise<unknown>;
+export declare function discoverItems(body: unknown): {
+    id: string;
+    title: string;
+}[];
+export declare function bibText(body: unknown): string;

package/lib/client/tag-colors.d.ts

@@ -0,0 +1,8 @@
+/** Chip inline style when a color is set; undefined = default muted classes. */
+export declare function tagChipStyle(id: string | null | undefined): {
+    backgroundColor: string;
+    color: string;
+} | undefined;
+export declare function tagSwatchStyle(id: string | null | undefined): {
+    backgroundColor: string;
+} | undefined;

package/lib/client/tag-composer.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode, type Ref } from 'react';
+import type { LibraryT, PaperRow } from './papers';
+type TagComposerProps = {
+    /** Placeholder and accessible name, e.g. "标签". */
+    label: string;
+    disabled: boolean;
+    /** Resolves true when the tag was saved, so the draft can be cleared. */
+    onAdd: (tag: string) => Promise<boolean>;
+    inputRef?: Ref<HTMLInputElement>;
+};
+/**
+ * Per-row tag input. The draft lives here rather than in the panel so typing
+ * re-renders one cell instead of every row in the table.
+ */
+export declare function TagComposer({ label, disabled, onAdd, inputRef }: TagComposerProps): ReactNode;
+/** Read first, edit on demand: long tag names never increase the catalog row height. */
+export declare function PaperTags({ paper, t, busy, onAdd, onRemove }: {
+    paper: PaperRow;
+    t: LibraryT;
+    busy: boolean;
+    onAdd: (ref: string, tag: string) => Promise<boolean>;
+    onRemove: (ref: string, name: string) => void;
+}): import("react").JSX.Element;
+export {};

package/lib/client/utils.d.ts

@@ -0,0 +1,7 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Form controls do not inherit type from their parent unless preflight says so.
+ * This package's Tailwind entry does not import preflight.
+ */
+export declare const controlReset = "m-0 appearance-none border-0 bg-transparent p-0 font-[inherit] text-[length:inherit] leading-[inherit] [font-weight:inherit]";