@brainfish-ai/components 0.35.20 → 0.36.0

package/dist/lib/api.d.ts

@@ -0,0 +1,133 @@
+import { SearchResponse, FeedbackResponse, APIFeedbackResponse, SearchResult, ActionInputs, ClientExecutionResult, SearchQueryAttributes, ConversationSummary } from '../components/chat-search/types';
+export declare function searchApi({ endpoint, query, collectionId, headers, conversationId, attributes, secretAttributes, allowedRegions, source, }: {
+    endpoint: string;
+    query: string;
+    collectionId?: string | string[];
+    headers?: Record<string, string>;
+    conversationId?: string;
+    attributes?: SearchQueryAttributes;
+    secretAttributes?: string;
+    allowedRegions?: string[];
+    source?: string;
+}): Promise<SearchResponse>;
+export declare function fetchAnswer({ endpoint, searchQueryId, headers, conversationId, }: {
+    endpoint: string;
+    searchQueryId: string;
+    headers?: Record<string, string>;
+    conversationId?: string;
+}): Promise<Response>;
+export declare function fetchAnswerStream({ endpoint, headers, body, }: {
+    endpoint: string;
+    headers?: Record<string, string>;
+    body: {
+        type: 'generate-for-query';
+        conversationId?: string;
+        searchQueryId: string;
+        profileId?: string;
+        context?: {
+            type: 'text';
+            text: string;
+        }[];
+        attachments?: {
+            type: string;
+            url: string;
+            filename?: string;
+        }[];
+        parameters?: ActionInputs;
+    } | {
+        type: 'invoke-action';
+        conversationId?: string;
+        searchQueryId: string;
+        searchIntentId: string;
+        actionId: string;
+        parameters: ActionInputs;
+        profileId?: string;
+    } | {
+        type: 'client-execution-result';
+        conversationId?: string;
+        searchQueryId: string;
+        searchIntentId: string;
+        actionId: string;
+        results: ClientExecutionResult;
+        profileId?: string;
+    };
+}): Promise<Response>;
+export declare function createConversationId(): string;
+export declare function uploadFileToApi({ endpoint, conversationId, file, headers, }: {
+    endpoint: string;
+    conversationId: string;
+    file: File;
+    headers?: Record<string, string>;
+}): Promise<{
+    publicUrl: string;
+}>;
+export declare function sendFeedback({ endpoint, searchQueryId, response, headers, conversationId, }: {
+    endpoint: string;
+    searchQueryId: string;
+    response: FeedbackResponse;
+    headers?: Record<string, string>;
+    conversationId?: string;
+}): Promise<void>;
+export declare function sendFeedbackReason({ endpoint, searchQueryId, reason, headers, }: {
+    endpoint: string;
+    searchQueryId: string;
+    reason: string;
+    headers?: Record<string, string>;
+    conversationId?: string;
+}): Promise<void>;
+export interface ConversationResponse {
+    data: Array<{
+        question: string;
+        answer: string | null;
+        searchQueryId: string;
+        searchResults?: SearchResult[];
+        searchIntentId?: string;
+        feedback?: APIFeedbackResponse;
+    }>;
+}
+export declare function loadConversation({ endpoint, conversationId, headers, signal, }: {
+    endpoint: string;
+    conversationId: string;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}): Promise<{
+    data: ConversationResponse['data'];
+}>;
+export declare function fetchFollowUpQuestions({ endpoint, searchQueryId, headers, conversationId, }: {
+    endpoint: string;
+    searchQueryId: string;
+    headers?: Record<string, string>;
+    conversationId?: string;
+}): Promise<string[]>;
+interface AutocompleteResponse {
+    response: {
+        results: Array<{
+            id: string;
+            question: string;
+        }>;
+    };
+}
+export declare function fetchAutocomplete({ endpoint, query, collectionId, headers, conversationId, allowedRegions, }: {
+    endpoint: string;
+    query: string;
+    collectionId?: string;
+    headers?: Record<string, string>;
+    conversationId?: string;
+    allowedRegions?: string[];
+}): Promise<AutocompleteResponse>;
+export declare function fetchConversationHistory({ endpoint, headers, externalUserId, }: {
+    endpoint: string;
+    headers?: Record<string, string>;
+    externalUserId?: string;
+}): Promise<ConversationSummary[]>;
+export declare function markConversationRead({ endpoint, conversationId, headers, }: {
+    endpoint: string;
+    conversationId: string;
+    headers?: Record<string, string>;
+}): Promise<void>;
+export declare function markConversationCompleted({ endpoint, conversationId, headers, }: {
+    endpoint: string;
+    conversationId: string;
+    headers?: Record<string, string>;
+}): Promise<void>;
+export {};

package/dist/lib/countSuggestions.d.ts

@@ -0,0 +1,4 @@
+/** Count suggestions in an HTML string (for title or raw HTML content). */
+export declare const countSuggestions: (htmlString: string) => number;
+/** Count suggestions inside a DOM element (for rendered ReactNode body content). */
+export declare const countSuggestionsInElement: (element: Element | null) => number;

package/dist/lib/feature-flags.d.ts

@@ -0,0 +1,9 @@
+import { default as React, ReactNode } from 'react';
+export type FeatureFlags = {
+    [key: string]: boolean | string | number;
+};
+export declare function FeatureFlagProvider({ children, flags }: {
+    children: ReactNode;
+    flags: FeatureFlags | undefined;
+}): React.JSX.Element;
+export declare function useBooleanFlagValue(flagKey: string, defaultValue: boolean): boolean;

package/dist/lib/features.d.ts

@@ -0,0 +1,4 @@
+export declare const Features: {
+    readonly UseSseForAnswers: "use-sse-for-answers";
+    readonly HistoryTab: "enableHistoryTab";
+};

package/dist/lib/fetchClient.d.ts

@@ -0,0 +1,19 @@
+interface RetryOptions {
+    maxRetries?: number;
+    baseDelay?: number;
+    shouldRetry?: (error: Error, attempt: number) => boolean | Promise<boolean>;
+}
+interface FallbackConfig {
+    emptyResponse?: string;
+    errorResponse?: string;
+}
+interface RequestConfig<T> extends Omit<RequestInit, 'body'> {
+    retry?: RetryOptions;
+    body?: T;
+    isStream?: boolean;
+    fallback?: FallbackConfig;
+}
+export declare function configureRetry(options: RetryOptions): void;
+export declare function configureFallback(config: FallbackConfig): void;
+export declare function makeRequest<TResponse, TBody = unknown>(url: string | URL, config?: RequestConfig<TBody>): Promise<TResponse>;
+export {};

package/dist/lib/formatDate.d.ts

@@ -0,0 +1,4 @@
+export declare function formatDistance(timestamp: Date, localeParam?: string): string;
+export declare function formatDate(date: Date, localeParam?: string): string;
+export declare function formatChartTick(value: Date | string | undefined, locale?: string): string;
+export declare function formatChartLabel(value: Date | string | undefined, locale?: string): string;

package/dist/lib/formatNumber.d.ts

@@ -0,0 +1 @@
+export declare const formatNumber: (number: number, options?: Intl.NumberFormatOptions) => string;

package/dist/lib/getContentType.d.ts

@@ -0,0 +1 @@
+export declare function getContentType(attachmentId: string, contentTypeEndpoint?: string, signal?: AbortSignal): Promise<'image' | 'video' | 'audio' | 'pdf' | 'unknown'>;

package/dist/lib/groupAttributesByKey.d.ts

@@ -0,0 +1 @@
+export declare function groupAttributesByKey(attributes: Record<string, any>[]): Record<string, any[]>;

package/dist/lib/hooks.d.ts

@@ -0,0 +1,19 @@
+import { Suggestion } from '../components/chat-search/types';
+export declare function useDebounce<T>(value: T, delay: number): T;
+export declare function useAutocomplete({ query, endpoint, allowedRegions, collectionId, headers, conversationId, delay, }: {
+    query: string;
+    endpoint: string;
+    allowedRegions?: string[];
+    collectionId?: string;
+    headers?: Record<string, string>;
+    conversationId?: string;
+    delay?: number;
+}): {
+    suggestions: Suggestion[];
+    isLoading: boolean;
+    error: string | undefined;
+};
+/** Stable `{ contains }` for case-insensitive substring checks when filtering lists. */
+export declare function useSubstringFilter(): {
+    contains: (text: string, substring: string) => boolean;
+};

package/dist/lib/pluralise.d.ts

@@ -0,0 +1 @@
+export declare function pluralise(count: number, singular: string, plural?: string): string;

package/dist/lib/sortAttributeKeys.d.ts

@@ -0,0 +1 @@
+export declare function sortAttributeKeys(attributes: Record<string, any>[]): string[];

package/dist/lib/styles.d.ts

@@ -0,0 +1 @@
+export declare const brandShadowEffect = "shadow-brand hover:shadow-none !transition-shadow duration-300 ease-in-out active:shadow-brand-active dark:shadow-brand-dark dark:hover:shadow-none dark:active:shadow-brand-dark-active";

package/dist/lib/useChartDateFormatters.d.ts

@@ -0,0 +1,4 @@
+export declare function useChartDateFormatters(locale?: string): {
+    tickFormatter: (value: Date | string | undefined) => string;
+    formatXLabel: (label: Date | string | undefined) => string;
+};

package/dist/lib/utils.d.ts

@@ -0,0 +1,7 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function useId(prefix?: string): string;
+export declare function isAnswerUncertain(response: string | null | undefined): {
+    uncertain: boolean;
+    language: string | null;
+};

package/dist/logos/microsoft-logo.d.ts

@@ -1,2 +1,10 @@
-export * from '../src/logos/microsoft-logo'
-export {}
+import { default as React } from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const microsoftLogoVariants: (props?: ({
+    variant?: "default" | "mono" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface MicrosoftLogoProps extends React.SVGAttributes<SVGSVGElement>, VariantProps<typeof microsoftLogoVariants> {
+    size?: number;
+}
+export declare const MicrosoftLogo: ({ size, variant, className, ...props }: MicrosoftLogoProps) => React.JSX.Element;
+export {};

package/dist/logos/microsoft-teams-logo.d.ts

@@ -1,2 +1,10 @@
-export * from '../src/logos/microsoft-teams-logo'
-export {}
+import { default as React } from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const microsoftTeamsLogoVariants: (props?: ({
+    variant?: "default" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface MicrosoftTeamsLogoProps extends React.SVGAttributes<SVGSVGElement>, VariantProps<typeof microsoftTeamsLogoVariants> {
+    size?: number;
+}
+export declare const MicrosoftTeamsLogo: ({ size, variant, className, ...props }: MicrosoftTeamsLogoProps) => React.JSX.Element;
+export {};

package/dist/logos/slack-logo.d.ts

@@ -1,2 +1,10 @@
-export * from '../src/logos/slack-logo'
-export {}
+import { default as React } from 'react';
+import { VariantProps } from 'class-variance-authority';
+declare const slackLogoVariants: (props?: ({
+    variant?: "default" | "mono" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface SlackLogoProps extends React.SVGAttributes<SVGSVGElement>, VariantProps<typeof slackLogoVariants> {
+    size?: number;
+}
+export declare const SlackLogo: ({ size, variant, className, ...props }: SlackLogoProps) => React.JSX.Element;
+export {};

package/dist/scenes/knowledge-review/context.d.ts

@@ -0,0 +1,46 @@
+import { default as React } from 'react';
+import { ReviewListItemProps } from './review-list/review-list-item';
+/** Passed to `onAcceptAndPublish` from the split Accept dropdown (public vs internal). */
+export type AcceptAndPublishVisibility = 'public' | 'internal';
+export type LoadedDiffDoc = {
+    isNew: boolean;
+    diffTitle: string;
+    diffContent: React.ReactNode;
+};
+type ReviewsSelectionValue = {
+    selectedItem: ReviewListItemProps | null;
+    setSelectedItem: (item: ReviewListItemProps | null) => void;
+    loadedDiffDoc: LoadedDiffDoc | null;
+    setLoadedDiffDoc: (doc: LoadedDiffDoc | null) => void;
+    loadingDiff: boolean;
+    setLoadingDiff: (loading: boolean) => void;
+    onApproveAllSuggestions: () => void | Promise<void>;
+    onRejectAllSuggestions: () => void | Promise<void>;
+    onAcceptAndPublish?: (visibility: AcceptAndPublishVisibility) => void | Promise<void>;
+    onApplyAllInEditor?: () => Promise<void> | void;
+    onRejectAllInEditor?: () => Promise<void> | void;
+    onOpenArticleLink?: () => void;
+    onSourceLinkClick?: () => void;
+    breadcrumb?: string;
+    suggestionReasonBody?: string;
+    /** When true, omit the "publish publicly" item from the Accept & publish menu. */
+    hideAcceptAndPublishPublic?: boolean;
+};
+export type ReviewsProviderProps = {
+    children: React.ReactNode;
+    /** Optional initial selection (e.g. from server or mock data) */
+    defaultSelectedItem?: ReviewListItemProps | null;
+    onApproveAllSuggestions: () => void | Promise<void>;
+    onRejectAllSuggestions: () => void | Promise<void>;
+    onAcceptAndPublish?: (visibility: AcceptAndPublishVisibility) => void | Promise<void>;
+    onApplyAllInEditor?: () => Promise<void> | void;
+    onRejectAllInEditor?: () => Promise<void> | void;
+    onOpenArticleLink?: () => void;
+    onSourceLinkClick?: () => void;
+    breadcrumb?: string;
+    suggestionReasonBody?: string;
+    hideAcceptAndPublishPublic?: boolean;
+};
+export declare function ReviewsSelectionProvider({ children, defaultSelectedItem, onApproveAllSuggestions, onRejectAllSuggestions, onAcceptAndPublish, onApplyAllInEditor, onRejectAllInEditor, onOpenArticleLink, onSourceLinkClick, breadcrumb, suggestionReasonBody, hideAcceptAndPublishPublic, }: ReviewsProviderProps): React.JSX.Element;
+export declare function useReviewsSelection(): ReviewsSelectionValue;
+export {};

package/dist/scenes/knowledge-review/diff-loader.d.ts

@@ -0,0 +1,10 @@
+import { LoadedDiffDoc } from './context';
+export type KnowledgeReviewDiffLoaderProps = {
+    /** Called when selectedItem changes. Return diff payload or null. */
+    fetchDiffForItem: (itemId: string) => Promise<LoadedDiffDoc | null>;
+};
+/**
+ * Listens to selectedItem from context and fetches diff via the provided callback.
+ * Owns loading state and context updates; host (Storybook or Platform) supplies fetch logic.
+ */
+export declare function KnowledgeReviewDiffLoader({ fetchDiffForItem }: KnowledgeReviewDiffLoaderProps): null;

package/dist/scenes/knowledge-review/index.d.ts

@@ -0,0 +1,10 @@
+export { KnowledgeReviewDiffLoader } from './diff-loader';
+export type { KnowledgeReviewDiffLoaderProps } from './diff-loader';
+export { KnowledgeReviewPanel } from './knowledge-review-panel';
+export type { KnowledgeReviewPanelProps } from './knowledge-review-panel';
+export { KnowledgeReviewScene } from './scene';
+export type { KnowledgeReviewSceneHandle, KnowledgeReviewSceneProps } from './scene';
+export { type AcceptAndPublishVisibility, type LoadedDiffDoc, ReviewsSelectionProvider, useReviewsSelection } from './context';
+export type { ReviewListItemProps } from './review-list';
+export { SuggestionCard } from './suggestion-card';
+export type { SuggestionCardDiff, SuggestionCardPagination, SuggestionCardProps, SuggestionCardSource } from './suggestion-card';

package/dist/scenes/knowledge-review/knowledge-review-panel.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { ReviewListItemProps } from './review-list';
+export type KnowledgeReviewPanelProps = {
+    diffTitle: string;
+    items: ReviewListItemProps[];
+    isLoading?: boolean;
+    totalItemsCount?: number;
+    showActionButtons?: boolean;
+    children?: React.ReactNode;
+    sourceIcon: React.ReactNode;
+    sourceDescription: string | null;
+};
+/**
+ * Panel that shows the selected diff (title + content), suggestion count, and article nav.
+ * Must be used inside ReviewsSelectionProvider. Expects --knowledge-review-scroll-height
+ * to be set by a parent for ScrollArea height.
+ */
+export declare function KnowledgeReviewPanel({ diffTitle, items, isLoading, totalItemsCount, showActionButtons, children, sourceIcon, sourceDescription, }: KnowledgeReviewPanelProps): React.JSX.Element;

package/dist/scenes/knowledge-review/review-list/edit-count.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+export declare function EditCount({ count }: {
+    count: number;
+}): React.JSX.Element;

package/dist/scenes/knowledge-review/review-list/index.d.ts

@@ -0,0 +1,3 @@
+export * from './review-list-item';
+export * from './review-list';
+export * from '../context';

package/dist/scenes/knowledge-review/review-list/mockItems.d.ts

@@ -0,0 +1,43 @@
+import { default as React } from 'react';
+export declare const mockItems: ({
+    id: string;
+    title: string;
+    timestamp: Date;
+    icon: React.JSX.Element;
+    description: string;
+    isNew?: undefined;
+    isSelected?: undefined;
+    editCount?: undefined;
+} | {
+    id: string;
+    title: string;
+    timestamp: Date;
+    icon: React.JSX.Element;
+    description: string;
+    isNew: true;
+    isSelected: true;
+    editCount?: undefined;
+} | {
+    id: string;
+    title: string;
+    timestamp: Date;
+    icon: React.JSX.Element;
+    description: string;
+    isNew: true;
+    isSelected?: undefined;
+    editCount?: undefined;
+} | {
+    id: string;
+    title: string;
+    timestamp: Date;
+    icon: React.JSX.Element;
+    description: string;
+    editCount: number;
+    isNew?: undefined;
+    isSelected?: undefined;
+})[];
+export declare const mockDiffDocs: {
+    id: string;
+    diffTitle: string;
+    diffContent: React.JSX.Element;
+}[];

package/dist/scenes/knowledge-review/review-list/review-list-item.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+export interface ReviewListItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Unique identifier for the knowledge article */
+    id: string;
+    /** Primary text displayed in the first row */
+    title: string;
+    /** Content rendered in the top-right corner (e.g. relative timestamp) */
+    timestamp: Date;
+    /** Icon rendered at the start of the second row */
+    icon?: React.ReactNode;
+    /** Text or content next to the icon in the second row */
+    description?: string | null;
+    /** Whether this item is new */
+    isNew?: boolean;
+    /** Whether this item has been accepted (e.g. accepted as draft) */
+    isAccepted?: boolean;
+    /** Number of edits for this item */
+    editCount?: number;
+    /** Whether this item is currently selected */
+    isSelected?: boolean;
+}
+export declare const ReviewListItem: React.ForwardRefExoticComponent<ReviewListItemProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/scenes/knowledge-review/review-list/review-list.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { ReviewListItemProps } from './review-list-item';
+interface ReviewListProps {
+    items: ReviewListItemProps[];
+    className?: string;
+}
+export declare const ReviewList: React.ForwardRefExoticComponent<ReviewListProps & React.RefAttributes<HTMLUListElement>>;
+export {};

package/dist/scenes/knowledge-review/scene.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { AcceptAndPublishVisibility } from './context';
+import { ReviewListItemProps } from './review-list';
+export type KnowledgeReviewSceneHandle = {
+    selectedItem: ReviewListItemProps | null;
+    setSelectedItem: (item: ReviewListItemProps | null) => void;
+};
+export type KnowledgeReviewSceneProps = {
+    diffTitle?: string;
+    children: React.ReactNode;
+    items: ReviewListItemProps[];
+    isLoading?: boolean;
+    /** Total number of review list items available (can exceed currently loaded `items.length`). */
+    totalItemsCount?: number;
+    /** Controls visibility of the Reject / Accept action buttons in the review header. */
+    showActionButtons?: boolean;
+    className?: string;
+    onApproveAllSuggestions: () => void | Promise<void>;
+    onRejectAllSuggestions: () => void | Promise<void>;
+    onAcceptAndPublish?: (visibility: AcceptAndPublishVisibility) => void | Promise<void>;
+    /** Bulk-apply against the live editor doc (new editor only). Runs before the server callback. */
+    onApplyAllInEditor?: () => Promise<void> | void;
+    /** Bulk-reject against the live editor doc (new editor only). Runs before the server callback. */
+    onRejectAllInEditor?: () => Promise<void> | void;
+    onOpenArticleLink?: () => void;
+    onSourceLinkClick?: () => void;
+    breadcrumb?: string;
+    sourceIcon: React.ReactNode;
+    sourceDescription: string | null;
+    suggestionReasonBody?: string;
+    hideAcceptAndPublishPublic?: boolean;
+};
+export declare const KnowledgeReviewScene: React.ForwardRefExoticComponent<KnowledgeReviewSceneProps & React.RefAttributes<KnowledgeReviewSceneHandle>>;

package/dist/scenes/knowledge-review/status-source-summary.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export interface StatusSourceSummaryProps {
+    isNew?: boolean;
+    isAccepted?: boolean;
+    editCount?: number;
+    sourceIcon?: React.ReactNode;
+    sourceDescription?: string | null;
+    onSourceLinkClick?: () => void;
+    sourceLabel?: string;
+    className?: string;
+}
+export declare function StatusSourceSummary({ isNew, isAccepted, editCount, sourceIcon, sourceDescription, onSourceLinkClick, sourceLabel, className, }: StatusSourceSummaryProps): React.JSX.Element | null;

package/dist/scenes/knowledge-review/suggestion-card/index.d.ts

@@ -0,0 +1,2 @@
+export { SuggestionCard } from './suggestion-card';
+export type { SuggestionCardDiff, SuggestionCardPagination, SuggestionCardProps, SuggestionCardSource } from './suggestion-card';

package/dist/scenes/knowledge-review/suggestion-card/suggestion-card.d.ts

@@ -0,0 +1,88 @@
+import * as React from 'react';
+export interface SuggestionCardSource {
+    /** Eyebrow label, e.g. "1 day ago from" — rendered uppercase by the card. */
+    label: string;
+    /** Display name of the source, e.g. "team-meetingFEB.mp4". */
+    name: string;
+    /**
+     * Optional icon next to the source name. Pass a `@phosphor-icons/react` icon.
+     */
+    icon?: React.ReactNode;
+}
+/**
+ * Pagination state for the side paginator column. When omitted, the paginator
+ * column (and its divider) is not rendered at all.
+ */
+export interface SuggestionCardPagination {
+    /** 1-based index of this suggestion within the set. */
+    currentIndex: number;
+    /** Total number of suggestions in the set. */
+    totalCount: number;
+    /** Fires when the user navigates to the previous suggestion. Omit to hide the button. */
+    onPrevious?: () => void;
+    /** Fires when the user navigates to the next suggestion. Omit to hide the button. */
+    onNext?: () => void;
+}
+/**
+ * Visual diff shown between the source row and the reason. Renders as a
+ * single bordered row with the old text struck-through in destructive color
+ * and the new text in link color.
+ *
+ * - For replace ops, set both `oldText` and `newText`.
+ * - For delete ops, set only `oldText`.
+ * - For insert ops, set only `newText`.
+ *
+ * When both fields are empty/undefined the diff row is not rendered.
+ */
+export interface SuggestionCardDiff {
+    /** Original text being removed. Destructive. */
+    oldText?: string;
+    /** Proposed replacement / insertion. Link color. */
+    newText?: string;
+}
+export interface SuggestionCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    /**
+     * Source metadata shown at the top of the card. Omit to skip the source
+     * row entirely — useful when the host doesn't have source info to surface.
+     */
+    source?: SuggestionCardSource;
+    /**
+     * Old vs. new text for the suggestion. Renders the bordered diff row
+     * between the source and the reason. Omit to skip the diff row entirely.
+     */
+    diff?: SuggestionCardDiff;
+    /**
+     * Host-provided explanation for why this suggestion was raised. Renders
+     * as the body paragraph below the diff. Omit to skip the reason line.
+     */
+    reason?: string;
+    /**
+     * Fires when the user accepts this suggestion. When omitted, the accept
+     * button is rendered disabled (so the affordance is visible but inert).
+     */
+    onAccept?: () => void;
+    /**
+     * Fires when the user rejects this suggestion. When omitted, the reject
+     * button is rendered disabled.
+     */
+    onReject?: () => void;
+    /** Fires when the user clicks the source icon and name. */
+    onSourceClick?: () => void;
+    /** Disable the accept button while an accept is in-flight. */
+    acceptDisabled?: boolean;
+    /** Disable the reject button while a reject is in-flight. */
+    rejectDisabled?: boolean;
+    /**
+     * Paginator state. When omitted, the whole paginator column (and its
+     * dividing border) is not rendered.
+     */
+    pagination?: SuggestionCardPagination;
+    readOnly?: boolean;
+}
+/**
+ * Floating card that displays a single review suggestion with its source,
+ * accept/reject actions, and an optional paginator for navigating within-article
+ * suggestions. Purely presentational — the host wires callbacks to the
+ * reviewSuggestions plugin / API layer.
+ */
+export declare const SuggestionCard: React.ForwardRefExoticComponent<SuggestionCardProps & React.RefAttributes<HTMLDivElement>>;

package/dist/scenes/knowledge-review/suggestions-header/index.d.ts

@@ -0,0 +1 @@
+export * from './suggestions-header';

package/dist/scenes/knowledge-review/suggestions-header/suggestions-header-title-nav.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export interface SuggestionsHeaderTitleNavProps {
+    title: React.ReactNode;
+    breadcrumb?: string;
+    onOpenArticleLink?: () => void;
+    currentArticleIndex: number;
+    totalArticles: number;
+    displayTotalArticles?: number;
+    onNextArticle: () => void;
+    onPreviousArticle: () => void;
+}
+export declare function SuggestionsHeaderTitleNav({ title, breadcrumb, onOpenArticleLink, currentArticleIndex, totalArticles, displayTotalArticles, onNextArticle, onPreviousArticle, }: SuggestionsHeaderTitleNavProps): React.JSX.Element;

package/dist/scenes/knowledge-review/suggestions-header/suggestions-header-toolbar.d.ts

@@ -0,0 +1,20 @@
+import { AcceptAndPublishVisibility } from '../context';
+import * as React from 'react';
+export type SuggestionHeaderAction = 'reject' | 'accept-draft' | 'accept-publish-public' | 'accept-publish-internal';
+export interface SuggestionsHeaderToolbarProps {
+    isNew: boolean;
+    isAccepted?: boolean;
+    suggestionsCount: number;
+    sourceIcon: React.ReactNode;
+    sourceDescription: string | null;
+    onSourceLinkClick?: () => void;
+    showActionButtons?: boolean;
+    suggestionReasonBody?: string;
+    hideAcceptAndPublishPublic?: boolean;
+    pendingAction?: SuggestionHeaderAction | null;
+    onAcceptAndPublish?: (visibility: AcceptAndPublishVisibility) => void;
+    onRejectAll: () => void | Promise<void>;
+    onAcceptAll: () => void | Promise<void>;
+    onAcceptAndPublishAction: (visibility: AcceptAndPublishVisibility) => void | Promise<void>;
+}
+export declare function SuggestionsHeaderToolbar({ isNew, isAccepted, suggestionsCount, sourceIcon, sourceDescription, onSourceLinkClick, showActionButtons, suggestionReasonBody, hideAcceptAndPublishPublic, pendingAction, onAcceptAndPublish, onRejectAll, onAcceptAll, onAcceptAndPublishAction, }: SuggestionsHeaderToolbarProps): React.JSX.Element;