@exegia/corpora-ui 1.0.0 → 3.0.0

package/dist-lib/components/composed/chat/chart/evilcharts/echarts-pie-chart.d.ts

@@ -0,0 +1,73 @@
+import { TooltipPosition, TooltipRoundness, TooltipVariant } from './echarts-tooltip';
+import { ChartConfig, EChartsRenderer } from './echarts-chart';
+import { FC, ReactNode } from 'react';
+import { LegendVariant } from './echarts-legend';
+export type { ChartConfig, EChartsRenderer, LegendVariant, TooltipPosition, TooltipRoundness, TooltipVariant, };
+export type PieVariant = "gradient";
+export type LabelPosition = "inside" | "outside";
+export type BackgroundVariant = "dots" | "grid" | "cross-hatch" | "diagonal-lines" | "plus" | "falling-triangles" | "4-pointed-star" | "tiny-checkers" | "overlapping-circles" | "wiggle-lines" | "bubbles";
+export interface EChartsPieChartProps<TData extends Record<string, unknown>> {
+    data: TData[];
+    config: ChartConfig;
+    dataKey: keyof TData & string;
+    nameKey: keyof TData & string;
+    className?: string;
+    renderer?: EChartsRenderer;
+    animation?: boolean;
+    defaultSelectedSector?: string | null;
+    selectedSector?: string | null;
+    onSelectionChange?: (selection: {
+        dataKey: string;
+        value: number;
+    } | null) => void;
+    isLoading?: boolean;
+    chartOptions?: Record<string, unknown>;
+    children?: ReactNode;
+}
+export interface PieProps {
+    variant?: PieVariant;
+    innerRadius?: number | string;
+    outerRadius?: number | string;
+    cornerRadius?: number;
+    paddingAngle?: number;
+    startAngle?: number;
+    endAngle?: number;
+    isClickable?: boolean;
+    children?: ReactNode;
+}
+export interface LabelProps {
+    dataKey?: string;
+    position?: LabelPosition;
+}
+export interface TooltipProps {
+    variant?: TooltipVariant;
+    roundness?: TooltipRoundness;
+    defaultIndex?: number;
+    position?: TooltipPosition;
+}
+export interface LegendProps {
+    variant?: LegendVariant;
+    align?: "left" | "center" | "right";
+    verticalAlign?: "top" | "middle" | "bottom";
+    isClickable?: boolean;
+}
+export interface BackgroundProps {
+    variant?: BackgroundVariant;
+}
+/**
+ * Apache ECharts port of the EvilCharts pie chart, exposing a compound-as-config
+ * API so its JSX reads identically to the Recharts twin. The root owns the data,
+ * config, selection state, loading skeleton, and intro reveal; every visual part —
+ * `<Pie>`, `<Tooltip>`, `<Legend>`, `<Background>` — is composed as a declarative
+ * child that renders nothing. The root walks those children by reference and
+ * drives a single imperative ECharts instance. Fully self-contained: its only
+ * dependencies are `react`, `echarts`, and `motion`.
+ */
+export declare function EChartsPieChart<TData extends Record<string, unknown>>({ data, config, dataKey, nameKey, className, renderer, animation, defaultSelectedSector, selectedSector: selectedSectorProp, onSelectionChange, isLoading, chartOptions, children, }: EChartsPieChartProps<TData>): import("react").JSX.Element;
+export declare namespace EChartsPieChart {
+    var Pie: FC<PieProps>;
+    var Label: FC<LabelProps>;
+    var Tooltip: FC<TooltipProps>;
+    var Legend: FC<LegendProps>;
+    var Background: FC<BackgroundProps>;
+}

package/dist-lib/components/composed/chat/chart/evilcharts/echarts-tooltip.d.ts

@@ -0,0 +1,29 @@
+import { ResolvedColors } from './echarts-chart';
+import { TooltipComponentOption } from 'echarts/components';
+export type TooltipVariant = "default" | "frosted-glass";
+export type TooltipRoundness = "sm" | "md" | "lg" | "xl";
+export type TooltipPosition = "fixed" | "variable";
+export declare const roundnessClass: Record<TooltipRoundness, string>;
+export declare const tooltipVariantClass: Record<TooltipVariant, string>;
+export declare function tooltipIndicatorHtml(key: string, colorsCount: number): string;
+export declare function tooltipRow({ indicatorHtml, labelText, valueText, dimmed, }: {
+    indicatorHtml: string;
+    labelText: string;
+    valueText: string;
+    dimmed: string;
+}): string;
+export declare function tooltipShell({ label, body, roundness, variant, }: {
+    label: string;
+    body: string;
+    roundness: TooltipRoundness;
+    variant: TooltipVariant;
+}): string;
+export declare function resolveTooltipPosition(position: TooltipPosition): TooltipComponentOption["position"];
+export declare function tooltipBaseOption(params: {
+    present: boolean;
+    cursor: boolean;
+    tokens: ResolvedColors["tokens"];
+    position: TooltipPosition;
+    axisPointerColor: string;
+    strokeWidth: number;
+}): TooltipComponentOption;

package/dist-lib/components/composed/chat/chart/index.d.ts

@@ -0,0 +1,6 @@
+export { ChartRoot as Chart, ChartRoot } from './chart-root';
+export { useChartContext } from './chart-context';
+export { useChartActions, useChartState } from './use-chart-state';
+export { chartSelectedKeyAtom, chartStateAtom, selectChartKeyAtom, toggleChartKeyAtom, resetChartAtom, removeChartInstance, } from './chart-atom';
+export { CHART_TYPE_LABEL, CHART_DEFAULT_HEIGHT } from './constants';
+export type * from './type';

package/dist-lib/components/composed/chat/chart/type.d.ts

@@ -0,0 +1,80 @@
+import { useRender } from '@base-ui/react/use-render';
+import { Reference } from '../../../atoms/reference';
+import { AreaProps, CurveType, TooltipProps, XAxisProps, YAxisProps } from './evilcharts/echarts-area-chart';
+import { BarProps } from './evilcharts/echarts-bar-chart';
+import { LineProps } from './evilcharts/echarts-line-chart';
+import { PieProps } from './evilcharts/echarts-pie-chart';
+import { BrushProps } from './evilcharts/echarts-brush';
+import { EChartsRenderer } from './evilcharts/echarts-chart';
+import type * as React from "react";
+export type TChartType = "pie" | "area" | "line" | "bar";
+export type TChartVariant = "default" | "stacked" | "percent" | "donut" | "horizontal";
+export type TChartInstanceId = string;
+export type TChartDatum = {
+    label: string;
+    [key: string]: string | number | null;
+};
+export interface IChartSeries {
+    key: string;
+    label: React.ReactNode;
+    color?: string;
+    format?: (value: number) => React.ReactNode;
+    area?: Omit<AreaProps, "dataKey" | "children">;
+    line?: Omit<LineProps, "dataKey" | "children">;
+    bar?: Omit<BarProps, "dataKey">;
+}
+export interface IChartState {
+    selectedKey: string | null;
+}
+export interface IChartStateActions {
+    select: (key: string | null) => void;
+    toggle: (key: string) => void;
+    clearSelection: () => void;
+    reset: () => void;
+}
+export interface IChartProps extends Omit<React.ComponentPropsWithoutRef<"div">, "title"> {
+    type: TChartType;
+    /** Unique within the current Jotai store. Omit for an isolated generated id. */
+    chartId?: TChartInstanceId;
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    badge?: React.ReactNode;
+    reference?: React.ComponentProps<typeof Reference>;
+    data: TChartDatum[];
+    series: IChartSeries[];
+    center?: {
+        value: React.ReactNode;
+        label?: React.ReactNode;
+    };
+    headerless?: boolean;
+    /** Outer component width. Numbers are pixels; CSS lengths such as "100%" work. */
+    width?: React.CSSProperties["width"];
+    /** Outer component height, including header and legend. Plot fills remaining space. */
+    height?: React.CSSProperties["height"];
+    /** Explicit plot height takes precedence over filling the outer height. */
+    plotHeight?: React.CSSProperties["height"];
+    /** Replace the outer element using the coss/Base UI render API. */
+    render?: useRender.ComponentProps<"div">["render"];
+    /** stacked/percent: area or bar; horizontal: bar; donut: pie. */
+    variant?: TChartVariant;
+    renderer?: EChartsRenderer;
+    animation?: boolean;
+    loading?: boolean;
+    emptyContent?: React.ReactNode;
+    showLegend?: boolean;
+    interactive?: boolean;
+    selectedKey?: string | null;
+    defaultSelectedKey?: string | null;
+    onSelectionChange?: (key: string | null) => void;
+    curveType?: CurveType;
+    grid?: boolean;
+    xAxis?: boolean | XAxisProps;
+    yAxis?: boolean | YAxisProps;
+    tooltip?: boolean | TooltipProps;
+    brush?: boolean | BrushProps;
+    pie?: Omit<PieProps, "children">;
+    /** ECharts options override generated options at the top level. */
+    chartOptions?: Record<string, unknown>;
+    /** Selection methods; also available via useChartActions(chartId). */
+    ref?: React.Ref<IChartStateActions>;
+}

package/dist-lib/components/composed/chat/chart/use-chart-state.d.ts

@@ -0,0 +1,3 @@
+import { IChartStateActions, TChartInstanceId } from './type';
+export declare function useChartState(id: TChartInstanceId): import('./type').IChartState;
+export declare function useChartActions(id: TChartInstanceId): IChartStateActions;

package/dist-lib/components/composed/chat/chart/use-chart.d.ts

@@ -0,0 +1,6 @@
+import { IChartProps } from './type';
+export declare function useChart(props: IChartProps): {
+    id: string;
+    selectedKey: string | null;
+    actions: import('./type').IChartStateActions;
+};

package/dist-lib/components/composed/chat/chart/utils.d.ts

@@ -0,0 +1,5 @@
+import { ChartConfig } from './evilcharts/echarts-chart';
+import { IChartSeries, TChartDatum, TChartType } from './type';
+export declare function chartSeriesColor(series: IChartSeries, index: number): string;
+export declare function formatChartValue(series: IChartSeries | undefined, value: unknown): import('react').ReactNode;
+export declare function buildChartConfig(type: TChartType, data: TChartDatum[], series: IChartSeries[]): ChartConfig;

package/dist-lib/components/composed/chat/chart.d.ts

@@ -0,0 +1 @@
+export * from './chart/index';

package/dist-lib/components/composed/chat/code-block.d.ts

@@ -0,0 +1,26 @@
+import * as React from "react";
+export interface ICodeDiffLine {
+    type?: "add" | "remove" | "context";
+    text: string;
+}
+export interface ICodeBlockProps extends Omit<React.ComponentPropsWithoutRef<"div">, "onCopy"> {
+    filename?: React.ReactNode;
+    code: string;
+    /** Optional diff view; when absent the toggle is hidden. */
+    diff?: ICodeDiffLine[];
+    view?: "code" | "diff";
+    defaultView?: "code" | "diff";
+    onViewChange?: (view: "code" | "diff") => void;
+    onCopy?: (code: string) => void;
+    /** Extra keywords for the tokenizer. */
+    keywords?: string[];
+}
+/** Minimal highlighter: string literals and keywords only, as in the design. */
+export declare function tokenize(line: string, keywords: ReadonlySet<string>): React.ReactNode[];
+/**
+ * Code card: filename header, Code | Diff toggle, Copy; gutter line numbers
+ * and keyword / string tinting from the `--code-*` tokens.
+ *
+ * @sketch "Component / Code Block"
+ */
+export declare function CodeBlock({ filename, code, diff, view, defaultView, onViewChange, onCopy, keywords, className, ...props }: ICodeBlockProps): React.ReactElement;

package/dist-lib/components/composed/chat/composer/add-button.d.ts

@@ -0,0 +1,5 @@
+import { PopoverTriggerState } from '@base-ui/react';
+import type * as React from "react";
+export declare function AddButton({ state, className, ...props }: React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    state?: PopoverTriggerState;
+}): React.JSX.Element;

package/dist-lib/components/composed/chat/composer/base.d.ts

@@ -0,0 +1,5 @@
+import { IComposerProps } from '../type';
+import type * as React from "react";
+/** Beautiful UI Prompt Bar layout, adapted for Corpora's composer contract.
+ * https://www.beautifului.dev/#prompt-bar — see BEAUTIFUL-UI-LICENSE.txt. */
+export declare function Composer({ value, onValueChange, composerId, attachments: seedAttachments, isStreaming, disabled, safetyNote, expanded, placeholder, SubmitButton, ComposerMenu, Suggestions, defaultValue, onSubmit, onStop, className, shape, sources, commands, models, model, defaultModel, onModelChange, onSourceSelect, onCommand, onFilesChange, accept, dictation, }: IComposerProps): React.ReactElement;

package/dist-lib/components/composed/chat/composer/command-menu.d.ts

@@ -0,0 +1,3 @@
+import { IComposerMenuProps } from '../type';
+/** Compatibility slot for apps that provide their own attachment commands. */
+export declare function CommandMenu({ items, onCommand, onAttach, disabled, }: IComposerMenuProps): React.ReactElement;

package/dist-lib/components/composed/chat/composer/hooks.d.ts

@@ -0,0 +1,9 @@
+import { TComposerAttachment } from '../type';
+/** Read the tray of one composer. */
+export declare function useComposerAttachments(composerId: string): TComposerAttachment[];
+/** Write-only tray actions; never re-renders the caller when the tray changes. */
+export declare function useComposerAttachmentActions(composerId: string): {
+    add: (item: TComposerAttachment) => void;
+    remove: (itemId: string) => void;
+    clear: () => void;
+};

package/dist-lib/components/composed/chat/composer/send-button.d.ts

@@ -0,0 +1,3 @@
+import { IComposerSubmitButtonProps } from '../type';
+import type * as React from "react";
+export declare function SendButton({ isStreaming, isExpanded: _isExpanded, disabled, onStop, className, ...props }: IComposerSubmitButtonProps & React.ButtonHTMLAttributes<HTMLButtonElement>): React.ReactElement;

package/dist-lib/components/composed/chat/composer/suggestions.d.ts

@@ -0,0 +1,7 @@
+import { ISuggestedPromptsProps } from '../type';
+/**
+ * The "Suggestions (n)" disclosure above the composer: a chevron that swings
+ * from left (folded) to down (open) and a panel of prompts that fans out
+ * beneath it, its bottom edge tucked behind the composer pill.
+ */
+export declare function SuggestedPrompts({ children, count, label, defaultOpen, open: openProp, onOpenChange, className, ...props }: ISuggestedPromptsProps): React.ReactElement | null;

package/dist-lib/components/composed/chat/composer/use-dictation.d.ts

@@ -0,0 +1,8 @@
+/** Uses the browser's recognizer only after an explicit microphone click. */
+export declare function useDictation(onTranscript: (text: string) => void, disabled: boolean): {
+    supported: boolean;
+    listening: boolean;
+    error: string | null;
+    toggle: () => void;
+    cancel: () => void;
+};

package/dist-lib/components/composed/chat/composer/utils.d.ts

@@ -0,0 +1,19 @@
+import { TComposerAttachment } from '../type';
+import { Variants } from 'motion';
+export declare const composerAttachmentsAtom: import('../../../../lib/keyed-atom').TFamily<import('jotai').PrimitiveAtom<TComposerAttachment[]> & {
+    init: TComposerAttachment[];
+}>;
+export declare const addComposerAttachmentAtom: import('../../../../lib/keyed-atom').TFamily<import('jotai').WritableAtom<null, [item: TComposerAttachment], void> & {
+    init: null;
+}>;
+export declare const removeComposerAttachmentAtom: import('../../../../lib/keyed-atom').TFamily<import('jotai').WritableAtom<null, [itemId: string], void> & {
+    init: null;
+}>;
+export declare const clearComposerAttachmentsAtom: import('../../../../lib/keyed-atom').TFamily<import('jotai').WritableAtom<null, [], void> & {
+    init: null;
+}>;
+export declare const removeComposerInstance: (id: string) => void;
+/** Children.toArray, but looking through fragments so `<>{a}{b}</>` counts two. */
+export declare function flattenChildren(children: React.ReactNode): React.ReactNode[];
+export declare const LIST_VARIANTS: Variants;
+export declare const ITEM_VARIANTS: Variants;

package/dist-lib/components/composed/chat/context-cards.d.ts

@@ -0,0 +1,27 @@
+import type * as React from "react";
+export interface IContextCard {
+    id?: string;
+    title: React.ReactNode;
+    /** "290 characters" */
+    meta?: React.ReactNode;
+    snippet: React.ReactNode;
+    file?: {
+        name: React.ReactNode;
+        type: string;
+    };
+    icon?: React.ReactNode;
+}
+export interface IContextCardsProps extends React.ComponentPropsWithoutRef<"div"> {
+    header?: React.ReactNode;
+    cards: IContextCard[];
+    /** Count pill; defaults to `cards.length`. */
+    count?: React.ReactNode;
+    onOpen?: (card: IContextCard, index: number) => void;
+}
+/**
+ * Retrieved chunks: header with a count pill, then one card per chunk with
+ * title, character count, snippet and the source file pill.
+ *
+ * @sketch "Component / Context Cards"
+ */
+export declare function ContextCards({ header, cards, count, onOpen, className, ...props }: IContextCardsProps): React.ReactElement;

package/dist-lib/components/composed/chat/filter-table.d.ts

@@ -0,0 +1,40 @@
+import { TDotTone } from '../../ui/chat';
+import * as React from "react";
+/** Active filter id, keyed by `tableId`; `null` means "All". */
+export declare const filterTableFilterAtom: import('../../../lib/keyed-atom').TFamily<import('jotai').PrimitiveAtom<string | null> & {
+    init: string | null;
+}>;
+export declare const removeFilterTableInstance: (id: string) => void;
+export interface IFilterTableStatus {
+    id: string;
+    label: React.ReactNode;
+    tone: TDotTone;
+}
+export interface IFilterTableColumn<Row> {
+    key: keyof Row & string;
+    header: React.ReactNode;
+    className?: string;
+}
+export interface IFilterTableProps<Row extends {
+    id: string;
+    status: string;
+}> extends React.ComponentPropsWithoutRef<"div"> {
+    tableId?: string;
+    statuses: IFilterTableStatus[];
+    columns: IFilterTableColumn<Row>[];
+    /** Column key rendered with the status dot (defaults to "status"). */
+    statusKey?: keyof Row & string;
+    rows: Row[];
+    allLabel?: React.ReactNode;
+    filter?: string | null;
+    onFilterChange?: (filter: string | null) => void;
+}
+/**
+ * Status filter pills over a compact task table.
+ *
+ * @sketch "Component / Filter Table"
+ */
+export declare function FilterTable<Row extends {
+    id: string;
+    status: string;
+}>({ tableId, statuses, columns, statusKey, rows, allLabel, filter, onFilterChange, className, ...props }: IFilterTableProps<Row>): React.ReactElement;

package/dist-lib/components/composed/chat/flowchart/chart-node.d.ts

@@ -0,0 +1,2 @@
+import { IChartNodeProps } from './types';
+export declare function ChartNode({ node, index, onRef, children }: IChartNodeProps): import("react").JSX.Element;

package/dist-lib/components/composed/chat/flowchart/connector.d.ts

@@ -0,0 +1,2 @@
+import { IConnectorProps } from './types';
+export declare function Connector({ edge, isLit, selected, onPick, strokeWidth, ...props }: IConnectorProps): import("react").JSX.Element;

package/dist-lib/components/composed/chat/flowchart/default.d.ts

@@ -0,0 +1,7 @@
+import { IFlowchartProps } from './types';
+/**
+ * Dot-grid canvas of draggable, selectable step cards joined by bezier connectors.
+ *
+ * @sketch "Component / Flowchart"
+ */
+export default function Flowchart({ steps, edges, readOnly, zoomable, height, onDrag, onAdd, onRemove, onEdgeRemove, onEdgeConnect, onEdgeChange, onRename, onDuplicate, className, children }: IFlowchartProps): import("react").JSX.Element;

package/dist-lib/components/composed/chat/flowchart/edge-toolbar.d.ts

@@ -0,0 +1,9 @@
+import { TEdge } from './types';
+import { TPoint } from './utils';
+/** Floats at a selected connector's midpoint: stroke widths, colours, disconnect. */
+export declare function EdgeToolbar({ edge, at, onChange, onRemove, }: {
+    edge: TEdge;
+    at: TPoint;
+    onChange?: (id: string, patch: Pick<TEdge, "strokeWidth" | "color">) => void;
+    onRemove?: (id: string) => void;
+}): import("react").JSX.Element;