@exegia/corpora-ui 1.0.0 → 3.0.0

package/README.md

@@ -26,7 +26,7 @@ bun run build        # docs site + publishable library
 
 1. Implement it in the appropriate `ui`, `composed`, or `blocks` directory.
 2. Export it from `src/index.ts`.
-3. Add an adjacent `*.story.tsx` with `defineStory` from `@/registry/story`.
+3. Add `src/components/stories/<name>.story.tsx` with `defineStory` from `@/registry/story`.
 4. Write a page in `content/{atoms,composed,blocks}` and render
    `<Preview />` from MDX. Keep usage and prop notes in that page.
 5. Add the slug to its category’s `meta.json`.

package/dist-lib/components/atoms/avatar/base.d.ts

@@ -0,0 +1,2 @@
+import { IAvatarProps, TUserType } from './types';
+export default function Base<T extends TUserType>({ user, size, className, loading, audio, }: IAvatarProps<T>): import("react").JSX.Element;

package/dist-lib/components/atoms/avatar/index.d.ts

@@ -0,0 +1,3 @@
+import { default as Avatar } from './base';
+export { Avatar };
+export type { IAvatarProps, TAvatarAudio, TAvatarSize, TAvatarStatus, TUserType, } from './types';

package/dist-lib/components/atoms/avatar/types.d.ts

@@ -0,0 +1,20 @@
+import { TAtomSize } from '../types';
+export type TUserType = {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    role?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    status?: TAvatarStatus;
+};
+export type TAvatarSize = Exclude<TAtomSize, "xs">;
+export type TAvatarStatus = "online" | "idle" | "offline";
+export type TAvatarAudio = "muted" | "unmuted" | "speaking";
+export interface IAvatarProps<T extends TUserType> {
+    user?: T;
+    size?: TAvatarSize;
+    className?: string;
+    audio?: TAvatarAudio;
+    loading?: boolean;
+}

package/dist-lib/components/atoms/avatar/utils.d.ts

@@ -0,0 +1,13 @@
+import { ClassValue } from 'class-variance-authority/types';
+import { TAvatarAudio, TAvatarSize, TUserType } from './types';
+import { TAtomSize } from '../types';
+export declare function initialsFrom(user: string | TUserType | undefined): string | undefined;
+export declare const avatarIsSpeakingClass = "ring-background size-10 ring-2 transition-transform duration-500 group-hover/avatar:scale-95";
+export declare const ringClasses: Record<NonNullable<TAvatarAudio>, ClassValue>;
+export declare const sizeClasses: Record<TAvatarSize, string>;
+export declare const loaderSizes: Record<TAvatarSize, TAtomSize>;
+export declare const statusClasses: {
+    online: string;
+    idle: string;
+    offline: string;
+};

package/dist-lib/components/atoms/background/texture.d.ts

@@ -0,0 +1,2 @@
+import { ITextureProps } from './type';
+export declare function Texture({ variant, opacity, className, children, }: ITextureProps): import("react").JSX.Element;

package/dist-lib/components/atoms/background/type.d.ts

@@ -0,0 +1,7 @@
+export type TTextureVariant = "fabric" | "paper" | "none";
+export interface ITextureProps {
+    variant?: TTextureVariant;
+    opacity?: number;
+    className?: string;
+    children?: React.ReactNode;
+}

package/dist-lib/components/atoms/background/utils.d.ts

@@ -0,0 +1,4 @@
+import { TTextureVariant } from './type';
+export declare const textureMap: Record<Exclude<TTextureVariant, "none">, string>;
+export declare const linearGradient = "bg-linear-to-t from-background from-10% to-transparent to-40% dark:from-10% dark:to-background/30 dark:to-50%";
+export declare const verticalFadeGradient: (color: string, spread?: number) => string;

package/dist-lib/components/atoms/bubble/actions.d.ts

@@ -0,0 +1,7 @@
+import { TBubbleActionsProps } from './types';
+import type * as React from "react";
+/**
+ * Row of per-message actions (copy, retry, …). Hidden until the bubble is
+ * hovered or an action has focus; compose with `Button size="icon-xs"`.
+ */
+export declare function BubbleActions({ className, "aria-label": ariaLabel, ...props }: TBubbleActionsProps): React.ReactElement;

package/dist-lib/components/atoms/bubble/context.d.ts

@@ -0,0 +1,4 @@
+import { TBubbleVariant } from './types';
+export declare const BubbleContext: import('react').Context<TBubbleVariant>;
+/** Variant of the closest `Bubble` ancestor; used by the sub-components. */
+export declare function useBubbleVariant(): TBubbleVariant;

package/dist-lib/components/atoms/bubble/default.d.ts

@@ -0,0 +1,3 @@
+import { IBubbleProps } from './types';
+import type * as React from "react";
+export declare function Bubble({ variant, continued, className, children, ...props }: IBubbleProps): React.ReactElement;

package/dist-lib/components/atoms/bubble/header.d.ts

@@ -0,0 +1,8 @@
+import { TBubbleHeaderProps } from './types';
+import type * as React from "react";
+/**
+ * Author row above a message: avatar, name, time and an optional role badge.
+ * The sender variant mirrors the order so the row reads inward from the
+ * thread's edge, the same way its bubble does.
+ */
+export declare function BubbleHeader({ className, children, ...props }: TBubbleHeaderProps): React.ReactElement;

package/dist-lib/components/atoms/bubble/index.d.ts

@@ -0,0 +1,16 @@
+import { Bubble as BubbleRoot } from './default';
+import { useBubbleVariant } from './context';
+import { BubbleActions } from './actions';
+import { BubbleHeader } from './header';
+import { BubbleMessage } from './message';
+import { Reference } from '../reference';
+import { BubbleReactionChip, BubbleReactions } from './reactions';
+export declare const Bubble: typeof BubbleRoot & {
+    Header: typeof BubbleHeader;
+    Message: typeof BubbleMessage;
+    Reactions: typeof BubbleReactions;
+    Reaction: typeof BubbleReactionChip;
+    Actions: typeof BubbleActions;
+};
+export { BubbleActions, BubbleHeader, BubbleMessage, BubbleReactionChip, BubbleReactions, Reference, useBubbleVariant, };
+export type { TBubbleActionsProps, IBubblePickedEmoji, TBubbleHeaderProps, TBubbleMessageProps, IBubbleReactionChipProps, IBubbleProps, IBubbleReaction, IBubbleReactionsProps, TBubbleVariant } from './types';

package/dist-lib/components/atoms/bubble/message.d.ts

@@ -0,0 +1,3 @@
+import { TBubbleMessageProps } from './types';
+import type * as React from "react";
+export declare function BubbleMessage({ className, unstyled, children, ...props }: TBubbleMessageProps): React.ReactElement;

package/dist-lib/components/atoms/bubble/reactions.d.ts

@@ -0,0 +1,14 @@
+import { IBubbleReactionsProps, IBubbleReactionChipProps, TBubbleReactionsButtonProps } from './types';
+import type * as React from "react";
+/**
+ * One emoji + count inside the pill. Pressing it springs the emoji, and a
+ * count change slides the old number out as the new one drops in.
+ */
+export declare function BubbleReactionChip({ reaction, index, onToggle, className, ...props }: IBubbleReactionChipProps): React.ReactElement;
+export declare function BubbleReactionsButton({ className, onClick, onEmojiSelect }: TBubbleReactionsButtonProps): React.ReactElement;
+/**
+ * Glass reaction pill that hangs off the bubble's bottom trailing corner.
+ * Pass `reactions` for the standard chips, or children for a custom row —
+ * both share the pill.
+ */
+export declare function BubbleReactions({ reactions, onToggle, onEmojiSelect, className, children, ...props }: IBubbleReactionsProps): React.ReactElement;

package/dist-lib/components/atoms/bubble/types.d.ts

@@ -0,0 +1,62 @@
+import { HTMLMotionProps } from 'motion/react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+/**
+ * Who the bubble belongs to:
+ * - "sender"    — the current user's outgoing message (right-aligned, inverted)
+ * - "recipient" — an incoming message from another person (left-aligned, muted)
+ * - "ai"        — generated output (left-aligned, chrome-less prose)
+ */
+export type TBubbleVariant = "ai" | "sender" | "recipient";
+export interface IBubbleProps extends ComponentPropsWithoutRef<"div"> {
+    variant?: TBubbleVariant;
+    /**
+     * A follow-up in a run of messages from the same author: tucks under the
+     * previous bubble. Render `Bubble.Header` on the first of the run only.
+     */
+    continued?: boolean;
+}
+export type TBubbleMessageProps = ComponentPropsWithoutRef<"div"> & {
+    /** No bubble surface. Automatically true for attachment-only children; set explicitly for custom wrappers. */
+    unstyled?: boolean;
+};
+export type TBubbleHeaderProps = ComponentPropsWithoutRef<"div">;
+export interface IBubbleReaction {
+    /** Stable key; falls back to the label/emoji when omitted. */
+    id?: string;
+    emoji: ReactNode | string;
+    count?: number;
+    /** Whether the current user has this reaction. */
+    reacted?: boolean;
+    /** Accessible name, e.g. "thumbs up". Required when emoji is not a string. */
+    label?: string;
+}
+/** An emoji chosen from the picker. Mirrors frimousse's payload so the
+ *  library never re-exports a dependency's type on its public surface. */
+export interface IBubblePickedEmoji {
+    emoji: string;
+    label: string;
+}
+export interface IBubbleReactionsProps extends Omit<ComponentPropsWithoutRef<"div">, "onToggle"> {
+    reactions?: IBubbleReaction[];
+    onToggle?: (reaction: IBubbleReaction, index: number) => void;
+    /** Fires when an emoji is picked from the add-reaction popover. */
+    onEmojiSelect?: (emoji: IBubblePickedEmoji) => void;
+}
+export type TBubbleActionsProps = ComponentPropsWithoutRef<"div">;
+export interface IBubbleReactionChipProps extends Omit<HTMLMotionProps<"button">, "onToggle" | "children"> {
+    reaction: IBubbleReaction;
+    index: number;
+    onToggle?: (reaction: IBubbleReaction, index: number) => void;
+}
+export type TBubbleReactionsButtonProps = Omit<HTMLMotionProps<"button">, "onToggle" | "children" | "onClick"> & {
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Fires when an emoji is picked from the popover. */
+    onEmojiSelect?: (emoji: IBubblePickedEmoji) => void;
+};
+/**
+ * Only what the chip actually forwards. It renders through `Button`, which is
+ * either a `<button>` or — with an href — an `<a>`, so the full anchor prop
+ * set cannot be honoured (and `type` means two different things across the
+ * two elements). Declaring the anchor set wholesale only advertised props the
+ * chip silently dropped.
+ */

package/dist-lib/components/atoms/bubble/utils.d.ts

@@ -0,0 +1,13 @@
+import { ClassValue } from 'clsx';
+import { IBubbleReaction, TBubbleVariant } from './types';
+/** Returns a stable key for a reaction, falling back to the emoji label if no ID is provided. */
+export declare function reactionKey(reaction: IBubbleReaction, index: number): string;
+/** Root alignment: outgoing hugs the right edge, everything else the left. */
+export declare const twBubbleAlignClasses: Record<TBubbleVariant, ClassValue>;
+/**
+ * The inner column shrink-wraps the message, reactions and actions.
+ * Headers offset this inset to reach the thread edge. Generated output
+ * stays full-bleed.
+ */
+export declare const twBubbleColumnClasses: Record<TBubbleVariant, ClassValue>;
+export declare const twBubbleMessageClasses: Record<TBubbleVariant, ClassValue>;

package/dist-lib/components/atoms/field.d.ts

@@ -0,0 +1,2 @@
+import { IInputFieldProps } from './types';
+export declare function InputField({ invalid, label, description, error, size, ...props }: IInputFieldProps): import("react").JSX.Element;

package/dist-lib/components/atoms/index.d.ts

@@ -0,0 +1,10 @@
+export * from './bubble';
+export { SelectChip, SourceChip as FlowchartSourceChip } from './chip';
+export * from './text';
+export * from './background';
+export * from './avatar';
+export * from './loader';
+export * from './reference';
+export { HighlightPopover, TextClickPopover, TextSelection, } from './text-selection';
+export { initialSelectionState, resetSelectionAtom, selectionAtom, setCurrentSelectionAtom, setPopoverPositionAtom, setSelectionAtom, setSelectionPopoverAtom, setSelectionPositionAtom, setShowPopoverAtom, updateSelectionAtom, } from './text-selection/selection-atom';
+export { useSelection } from './text-selection/use-selection';

package/dist-lib/components/atoms/loader.d.ts

@@ -0,0 +1,2 @@
+import { ILoaderProps } from './types';
+export declare function Loader({ type, className, size }: ILoaderProps): import("react").JSX.Element;

package/dist-lib/components/atoms/reference.d.ts

@@ -0,0 +1,7 @@
+import { IReferenceProps } from './types';
+import type * as React from "react";
+/**
+ * "Reference 1 ↗" — a translucent tag pointing at the node, passage or
+ * source a suggestion is grounded in. Follows the card it sits in.
+ */
+export declare function Reference({ href, onClick, className, children, preview, ...props }: IReferenceProps): React.ReactElement;