@parallelworks/ui 0.18.0 → 0.19.0

package/dist/ai/strings.d.ts

@@ -0,0 +1,167 @@
+import type { ReactNode } from 'react';
+export interface ChatStrings {
+    modal: {
+        cancel: string;
+        save: string;
+        loading: string;
+    };
+    shareConversation: {
+        title: string;
+        loadError: string;
+        saveSuccess: string;
+        orgAccess: string;
+        orgCanView: string;
+        allowCollaboration: string;
+        groupAccess: string;
+        noGroups: string;
+        viewOnly: string;
+        canCollaborate: string;
+        remove: string;
+        addGroups: string;
+        info: ReactNode;
+        shareButton: string;
+    };
+    blockedGroup: {
+        title: string;
+        message: string;
+    };
+    queue: {
+        remove: string;
+    };
+    activity: {
+        tokens: (input: string, output: string) => string;
+        stop: string;
+    };
+    emptyState: {
+        greeting: string | null;
+        modernSubtitle: string;
+        noProvidersTitle: string;
+        noProvidersBody: string;
+        addProvider: string;
+        sessionUnreachableTitle: (session: string) => ReactNode;
+        sessionUnreachableBody: string;
+        retry: string;
+    };
+    input: {
+        placeholder: string;
+        placeholderLoading: string;
+        placeholderNoProviders: string;
+        attachFiles: string;
+        stopGenerating: string;
+        sendMessage: string;
+        filesAttached: (count: number) => string;
+    };
+    thinking: {
+        label: string;
+        ellipsis: string;
+        thoughtFor: (duration: string) => string;
+        activity: string;
+    };
+    thread: {
+        viewOnly: string;
+    };
+    sidebar: {
+        groupToday: string;
+        groupYesterday: string;
+        groupThisWeek: string;
+        groupThisMonth: string;
+        groupOlder: string;
+        untitled: string;
+        rename: string;
+        share: string;
+        delete: string;
+        sharedWithYou: string;
+        moreOptions: string;
+        openSidebar: string;
+        closeSidebar: string;
+        newChat: string;
+        attachments: string;
+        connectTools: string;
+        manageProviders: string;
+        noConversations: string;
+        deleteTitle: string;
+        deleteBody: string;
+        deleteAction: string;
+        renameTitle: string;
+        renameAction: string;
+        renameLabel: string;
+        renamePlaceholder: string;
+    };
+    attachmentUpload: {
+        fileTooLarge: (maxSize: string) => string;
+        maxFilesAllowed: (max: number) => string;
+        remove: string;
+        dropFilesHere: string;
+        addFiles: string;
+    };
+    attachmentManager: {
+        title: string;
+        empty: string;
+        download: string;
+        delete: string;
+        loadMore: string;
+        loading: string;
+    };
+    branch: {
+        previous: string;
+        next: string;
+    };
+    chrome: {
+        searchPlaceholder: string;
+        searchLabel: string;
+        noMatches: string;
+        download: string;
+        exportError: string;
+        jumpToLatest: string;
+    };
+    messageMeta: {
+        stopped: string;
+        showMore: string;
+        showLess: string;
+        tokens: (total: number) => string;
+        tokensBreakdown: (prompt: number, completion: number) => string;
+        copy: string;
+        edit: string;
+        regenerate: string;
+        retry: string;
+        editPlaceholder: string;
+        cancel: string;
+        send: string;
+    };
+    permissions: {
+        choose: string;
+        readOnly: string;
+        acceptEdits: string;
+        bypassPermissions: string;
+        plan: string;
+        readOnlyHint: string;
+        acceptEditsHint: string;
+        bypassPermissionsHint: string;
+        planHint: string;
+    };
+    agentTranscript: {
+        showMore: string;
+        showLess: string;
+        running: string;
+        done: string;
+        failed: string;
+        interrupted: string;
+        noOutput: string;
+        diffTruncated: string;
+        moreLines: string;
+        allowOnce: string;
+        allowDirectory: string;
+        deny: string;
+        denyWithFeedback: string;
+        feedbackPlaceholder: string;
+        send: string;
+        answered: string;
+        writeOwnAnswer: string;
+        subagent: string;
+        tasks: string;
+        planPending: string;
+        approvalPending: string;
+        approvalOptions: string;
+    };
+}
+export declare const defaultChatStrings: ChatStrings;

package/dist/ai/types.d.ts

@@ -0,0 +1,236 @@
+export interface ChatUser {
+    id: string;
+    username: string;
+    name?: string;
+    avatarUrl?: string;
+}
+export interface AttachmentRef {
+    id: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    uploadedAt: string;
+    conversationId?: string;
+    messageId?: string;
+}
+export interface FunctionCall {
+    name: string;
+    arguments: string;
+}
+export interface ToolCall {
+    function: FunctionCall;
+    id?: string;
+    index?: number;
+    type?: string;
+}
+export interface ToolCallDelta {
+    index?: number;
+    id?: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+export interface TokenUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+}
+export type ToolCallStatus = 'running' | 'ok' | 'error';
+export interface TextPart {
+    kind: 'text';
+    text: string;
+}
+export interface ReasoningPart {
+    kind: 'reasoning';
+    text: string;
+    durationMs?: number;
+}
+export interface ToolCallPart {
+    kind: 'tool_call';
+    id: string;
+    name: string;
+    args: string;
+    status: ToolCallStatus;
+    result?: string;
+    startLine?: number;
+}
+export type SubagentStatus = 'running' | 'done' | 'failed';
+export interface SubagentPart {
+    kind: 'subagent';
+    id: string;
+    status: SubagentStatus;
+    agentType?: string;
+    color?: string;
+    background?: boolean;
+    description?: string;
+    actions?: string[];
+    summary?: string;
+    report?: string;
+}
+export interface ApprovalOption {
+    label: string;
+    description?: string;
+}
+export type ApprovalAnswerValue = {
+    kind: 'confirm';
+    allowed: boolean;
+    allowDir?: boolean;
+    denyMessage?: string;
+} | {
+    kind: 'ask';
+    text: string;
+    chat?: boolean;
+};
+export interface ApprovalPart {
+    kind: 'approval';
+    id: string;
+    approvalKind: 'confirm' | 'ask' | 'plan';
+    toolName?: string;
+    command?: string;
+    reason?: string;
+    agent?: string;
+    mode?: string;
+    question?: string;
+    header?: string;
+    multiSelect?: boolean;
+    options?: ApprovalOption[];
+    plan?: string;
+    canAllowDirectory?: boolean;
+    resolved?: boolean;
+    answer?: string;
+}
+export interface NoticePart {
+    kind: 'notice' | 'warning' | 'error';
+    text: string;
+    detail?: string;
+}
+export type TodoStatus = 'pending' | 'in_progress' | 'completed';
+export interface TodoItem {
+    content: string;
+    status: TodoStatus;
+    activeForm?: string;
+}
+export interface TodoSnapshotPart {
+    kind: 'todo_snapshot';
+    todos: TodoItem[];
+}
+export type MessagePart = TextPart | ReasoningPart | ToolCallPart | SubagentPart | ApprovalPart | NoticePart | TodoSnapshotPart;
+export type MessagePartKind = MessagePart['kind'];
+export type PseudoUserKind = 'command-input' | 'shell-input' | 'compaction';
+export interface ChatMessage {
+    id: string;
+    role: string;
+    content?: string | null | undefined;
+    parentId?: string | null | undefined;
+    model?: string | null | undefined;
+    providerId?: string | null | undefined;
+    reasoning?: string | undefined;
+    reasoningDuration?: number | undefined;
+    responsesOutput?: unknown[] | null | undefined;
+    stopped?: boolean | undefined;
+    timestamp?: string | undefined;
+    tokensUsed?: TokenUsage | undefined;
+    toolCallId?: string | undefined;
+    toolCalls?: ToolCall[] | null | undefined;
+    attachments?: AttachmentRef[] | null | undefined;
+    author?: ChatUser | undefined;
+    conversationId?: string | undefined;
+    error?: string | null | undefined;
+    parts?: MessagePart[] | null | undefined;
+    pseudo?: PseudoUserKind | null | undefined;
+}
+export interface Conversation {
+    id: string;
+    messages: ChatMessage[];
+    title?: string | null;
+    activeBranchId?: string | null;
+    branches?: string[] | null;
+    canCollaborate?: boolean;
+    createdAt?: string;
+    isOwner?: boolean;
+    updatedAt?: string | null;
+}
+export interface ConversationSummary {
+    id: string;
+    canCollaborate: boolean;
+    createdAt: string;
+    isOwner: boolean;
+    messageCount: number;
+    activeBranchId?: string;
+    preview?: string;
+    title?: string;
+    updatedAt?: string;
+}
+export interface ChatModel {
+    id: string;
+    object: string;
+    created: number;
+    owned_by: string;
+    tool_calling_mode: 'native' | 'emulated' | 'none';
+    name?: string;
+    provider?: string;
+    provider_name?: string;
+    provider_owner?: string;
+    provider_type?: string;
+    context_window?: number;
+    input_rate?: number;
+    output_rate?: number;
+    reasoning_efforts?: string[] | null;
+    supports_responses?: boolean;
+    supports_usage?: boolean;
+    usage_not_supported?: boolean;
+}
+export interface UnreachableSession {
+    name: string;
+    owner: string;
+}
+export type CspKind = 'openai' | 'anthropic' | 'google' | 'azure' | 'aws' | 'other';
+export interface ProviderInfo {
+    id: string;
+    name: string;
+    displayName?: string;
+    user: string;
+    cspKind: CspKind;
+    platformLabel?: string;
+    status: string;
+    group?: string;
+    groupBlocked?: boolean;
+}
+export interface Allocation {
+    name: string;
+    total: number;
+    used?: number;
+}
+export interface ChatNavigation {
+    toConversation(id: string): void;
+    toNewChat(): void;
+    toAttachments(): void;
+}
+export interface ChatNotify {
+    success(message: string): void;
+    error(message: string): void;
+    info(message: string): void;
+}
+export type SharePermissionLevel = 'view' | 'collaborate';
+export interface SharePermission {
+    id?: string;
+    team?: string | null;
+    teamName?: string | null;
+    permission: SharePermissionLevel;
+    entireOrganization: boolean;
+}
+export interface ShareGroup {
+    id: string;
+    name: string;
+}
+export type ChatLinkTarget = {
+    kind: 'conversation';
+    id: string;
+} | {
+    kind: 'attachments';
+} | {
+    kind: 'external';
+    href: string;
+};

package/dist/ai/ui/Avatar.d.ts

@@ -0,0 +1,8 @@
+interface AvatarProps {
+    src?: string | undefined;
+    name?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+    className?: string;
+}
+export declare function Avatar({ src, name, size, className }: AvatarProps): import("react").JSX.Element;
+export {};

package/dist/ai/ui/Dropdown.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+export interface DropdownOption {
+    label: string;
+    value: string;
+    /** A second line under the label, for choices that need explaining. */
+    description?: string;
+    /** Rendered as a plain option; the trailing checkmark and bold never apply. */
+    muted?: boolean;
+}
+interface DropdownProps {
+    options: DropdownOption[];
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 'bare' drops the input background and text colour, for a trigger that
+     *  reads as a chip or as toolbar text. */
+    variant?: 'default' | 'bare';
+    /** Leading content in the trigger, before the label. */
+    icon?: ReactNode;
+    /** Shown in the trigger instead of the selected option's label. */
+    valueLabel?: string;
+    ariaLabel?: string;
+    /** Tooltip on the closed trigger. */
+    hint?: string;
+    wrapperClassName?: string;
+    textBoxClassName?: string;
+    listClassName?: string;
+}
+export default function Dropdown({ options, value, onChange, placeholder, disabled, variant, icon, valueLabel, ariaLabel, hint, wrapperClassName, textBoxClassName, listClassName, }: DropdownProps): import("react").JSX.Element;
+export {};

package/dist/ai/ui/Markdown.d.ts

@@ -0,0 +1,8 @@
+import { type ControlsConfig } from 'streamdown';
+interface MarkdownProps {
+    children: string;
+    isStreaming?: boolean;
+    controls?: ControlsConfig;
+}
+export default function Markdown({ children, isStreaming, controls }: MarkdownProps): import("react").JSX.Element;
+export {};

package/dist/ai/ui/Notice.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+export type NoticeTone = 'neutral' | 'info' | 'warning' | 'danger';
+/** A standing condition on the surface: a full-width bar under the header
+ *  with a title, an explanation, and the one thing the reader can do about it. */
+export declare function NoticeBar({ tone, title, children, action, onAction, testId, }: {
+    tone: NoticeTone;
+    title: string;
+    children?: ReactNode;
+    action?: string;
+    onAction?: () => void;
+    testId?: string;
+}): import("react").JSX.Element;
+/** An inline notice next to the composer. One with no dismiss states a fact
+ *  that is still true; one with a dismiss is a message the reader can put away. */
+export declare function NoticeCard({ tone, children, onDismiss, dismissLabel, testId, }: {
+    tone?: NoticeTone;
+    children: ReactNode;
+    onDismiss?: () => void;
+    dismissLabel?: string;
+    testId?: string;
+}): import("react").JSX.Element;

package/dist/ai/ui/buttons.d.ts

@@ -0,0 +1 @@
+export declare const ghostButtonClasses = "inline-flex items-center gap-1.5 h-8 px-3 rounded-md text-sm text-(--theme-muted-text-color,#6c757d) hover:text-(--theme-app,#000000) hover:bg-(--theme-hover,#f3f4f6) transition-colors";

package/dist/ai/ui/codeBreaks.d.ts

@@ -0,0 +1,16 @@
+interface HastText {
+    type: 'text';
+    value: string;
+}
+interface HastElement {
+    type: 'element';
+    tagName: string;
+    properties?: Record<string, unknown>;
+    children: HastNode[];
+}
+type HastNode = HastText | HastElement | {
+    type: string;
+    children?: HastNode[];
+};
+export declare function rehypeCodeBreaks(): (tree: HastNode) => void;
+export {};

package/dist/ai/ui/prose.d.ts

@@ -0,0 +1 @@
+export declare const chatProseClasses: string;

package/dist/ai/ui/sidebar.d.ts

@@ -0,0 +1,81 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type OpenMenu, type RowMenuItem } from '../../list/index.js';
+export declare const SIDEBAR_RAIL_WIDTH_PX = 48;
+export declare const SIDEBAR_DEFAULT_WIDTH_PX = 256;
+/** The column a conversation list lives in: it animates between its width
+ *  and a rail, unless a drag is setting the width right now. */
+export declare function SidebarPanel({ collapsed, width, railWidth, resizing, label, className, style, children, }: {
+    collapsed: boolean;
+    width?: number;
+    railWidth?: number;
+    resizing?: boolean;
+    label?: string;
+    className?: string;
+    style?: CSSProperties;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function SidebarToggle({ collapsed, onToggle, openLabel, closeLabel, className, }: {
+    collapsed: boolean;
+    onToggle: () => void;
+    openLabel: string;
+    closeLabel: string;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function SidebarGroupHeading({ children, tone, testId, }: {
+    children: ReactNode;
+    /** 'attention' is for the group the reader is being asked to act on. */
+    tone?: 'default' | 'attention';
+    testId?: string;
+}): import("react").JSX.Element;
+/** One entry in the list: the row highlights while it is the open one or
+ *  while its menu is up, and the menu opens from its button or a right-click. */
+export declare function SidebarRow({ selected, menuItems, openMenu, className, children, }: {
+    selected: boolean;
+    menuItems: RowMenuItem[];
+    openMenu: OpenMenu;
+    className?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** One entry in the collapsed rail: a square the size of the toggle, with the
+ *  same highlight as a row, holding whatever stands in for the item. */
+export declare function SidebarRailItem({ selected, label, onSelect, testId, tooltipProps, children, }: {
+    selected: boolean;
+    label: string;
+    onSelect: () => void;
+    testId?: string;
+    tooltipProps?: Record<string, string>;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function RenameDialog({ open, title, label, placeholder, confirmLabel, value, onChange, onConfirm, onClose, }: {
+    open: boolean;
+    title: string;
+    label: string;
+    placeholder: string;
+    confirmLabel: string;
+    value: string;
+    onChange: (value: string) => void;
+    onConfirm: () => void;
+    onClose: () => void;
+}): import("react").JSX.Element;
+export interface RowDialogStrings<T> {
+    deleteTitle: string;
+    deleteBody: (item: T) => ReactNode;
+    deleteAction: string;
+    renameTitle: string;
+    renameLabel: string;
+    renamePlaceholder: string;
+    renameAction: string;
+}
+/** The delete confirmation and rename dialog every list of rows needs, with
+ *  the item they are about. A handler that returns false keeps its dialog
+ *  open, for a refusal the reader should see before trying again. */
+export declare function useRowDialogs<T>({ strings, nameOf, onDelete, onRename, }: {
+    strings: RowDialogStrings<T>;
+    nameOf: (item: T) => string;
+    onDelete: (item: T) => Promise<boolean | undefined> | boolean | undefined;
+    onRename: (item: T, name: string) => Promise<boolean | undefined> | boolean | undefined;
+}): {
+    requestDelete: (item: T) => void;
+    requestRename: (item: T) => void;
+    dialogs: ReactNode;
+};

package/dist/ai/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function formatFileSize(bytes: number): string;
+export declare function isMac(): boolean;
+/** Only org models bill to an allocation; any other model ignores it. */
+export declare function isOrgModel(modelId: string | null | undefined): boolean;