@exegia/corpora-ui 0.28.0 → 1.0.0

package/dist-lib/src/components/atoms/text/heading.d.ts

@@ -0,0 +1,4 @@
+import { TextSelectionProps } from '../text-selection';
+import { TextProps } from './types';
+export type HeadingProps = Omit<TextProps, "type"> & Omit<TextSelectionProps, "children" | "className">;
+export declare function Heading({ children, selected, popover, component, componentProps, popoverComponent, popoverProps, renderPopover, onSelectionStart, onSelectionEnd, onPopoverShow, onPopoverHide, offset, zIndex, className, alignment, minSelectionLength, ...textProps }: HeadingProps): import("react").JSX.Element;

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

@@ -0,0 +1,21 @@
+import { Text as TextDefault } from './default';
+import { Heading } from './heading';
+import { Paragraph } from './paragraph';
+import { Span } from './span';
+import { Label } from './label';
+export type { HeadingProps } from './heading';
+export type { ParagraphProps } from './paragraph';
+export type { SpanProps } from './span';
+export type { TextProps, TextSize, TextVariant } from './types';
+export declare const Text: {
+    /** The polymorphic base the presets below are built on — the only member
+     * that takes `type`, so it is what reaches `link` and `subscript`. The
+     * presets are reachable through the atoms barrel, and without this it
+     * would not be: `export *` does not carry a default export. */
+    Root: typeof TextDefault;
+    Heading: typeof Heading;
+    Paragraph: typeof Paragraph;
+    Span: typeof Span;
+    Label: typeof Label;
+};
+export { TextDefault as default };

package/dist-lib/src/components/atoms/text/label.d.ts

@@ -0,0 +1,2 @@
+import { LabelProps } from './types';
+export declare function Label({ children, level, className }: LabelProps): import("react").JSX.Element;

package/dist-lib/src/components/atoms/text/paragraph.d.ts

@@ -0,0 +1,4 @@
+import { TextSelectionProps } from '../text-selection';
+import { TextProps } from './types';
+export type ParagraphProps = Omit<TextProps, "type"> & Omit<TextSelectionProps, "children" | "className">;
+export declare function Paragraph({ children, selected, popover, component, componentProps, popoverComponent, popoverProps, renderPopover, onSelectionStart, onSelectionEnd, onPopoverShow, onPopoverHide, offset, zIndex, alignment, className, minSelectionLength, ...textProps }: ParagraphProps): import("react").JSX.Element;

package/dist-lib/src/components/atoms/text/span.d.ts

@@ -0,0 +1,3 @@
+import { TextProps } from './types';
+export type SpanProps = Omit<TextProps, "type">;
+export declare function Span(props: SpanProps): import("react").JSX.Element;

package/dist-lib/src/components/atoms/text/types.d.ts

@@ -0,0 +1,23 @@
+import { CSSProperties, HTMLAttributes, ReactNode } from 'react';
+export type TextVariant = "default" | "heading" | "paragraph" | "link" | "subscript";
+export type TextSize = "small" | "medium" | "large" | number;
+export type TextProps = Omit<HTMLAttributes<HTMLElement>, "children" | "style"> & {
+    id?: string;
+    children?: ReactNode;
+    className?: string;
+    /** Named sizes use the type scale; a number is interpreted as pixels. */
+    size?: TextSize;
+    type?: TextVariant;
+    href?: string;
+    /** Marks a reader selection. A string is also exposed as data-selection. */
+    selection?: string | boolean;
+    style?: CSSProperties;
+};
+export type LabelLevel = "heading" | "title" | "caption" | "subtitle";
+export type LabelProps = {
+    children: ReactNode;
+    className?: string;
+    /** Type scale of the label. Defaults to "title". */
+    level?: LabelLevel;
+    id?: string;
+};

package/dist-lib/src/components/atoms/text/utils.d.ts

@@ -0,0 +1,4 @@
+import { ClassValue } from 'clsx';
+import { LabelProps } from './types';
+export declare const twClasses: Record<string, ClassValue>;
+export declare const twLabelClasses: Record<NonNullable<LabelProps["level"]>, Element["className"]>;

package/dist-lib/src/components/atoms/text-selection/click-popover.d.ts

@@ -0,0 +1,3 @@
+import { ReactElement } from 'react';
+import { TextClickPopoverProps } from './types';
+export declare function TextClickPopover({ children, popover, renderPopover, popoverProps, open: controlledOpen, defaultOpen, onOpenChange, className, ...textProps }: TextClickPopoverProps): ReactElement;

package/dist-lib/src/components/atoms/text-selection/index.d.ts

@@ -0,0 +1,6 @@
+export { TextClickPopover } from './click-popover';
+export { HighlightPopover } from './popover';
+export { TextSelection } from './selection';
+export { initialSelectionState, resetSelectionAtom, selectionAtom, setCurrentSelectionAtom, setPopoverPositionAtom, setSelectionAtom, setSelectionPopoverAtom, setSelectionPositionAtom, setShowPopoverAtom, updateSelectionAtom, } from './selection-atom';
+export { useSelection } from './use-selection';
+export type { HighlightPopoverPrimitiveProps, HighlightPopoverProps, SelectionPosition, SelectionPopoverComponent, SelectionRenderProps, SelectionState, SelectionStateUpdate, TextClickPopoverProps, TextPopoverRenderProps, TextSelectionProps, UseSelectionOptions, UseSelectionResult, } from './types';

package/dist-lib/src/components/atoms/text-selection/popover.d.ts

@@ -0,0 +1,3 @@
+import { HighlightPopoverProps } from './types';
+import type * as React from "react";
+export declare function HighlightPopover({ children, component: Component, componentProps, render, className, ...props }: HighlightPopoverProps): React.ReactElement;

package/dist-lib/src/components/atoms/text-selection/selection-atom.d.ts

@@ -0,0 +1,30 @@
+import { SelectionPosition, SelectionState, SelectionStateUpdate } from './types';
+export declare const initialSelectionState: SelectionState;
+export declare const selectionAtom: import('jotai').PrimitiveAtom<SelectionState> & {
+    init: SelectionState;
+};
+/** Update only the fields that changed, keeping selection state atomic. */
+export declare const updateSelectionAtom: import('jotai').WritableAtom<null, [update: SelectionStateUpdate], void> & {
+    init: null;
+};
+export declare const setSelectionAtom: import('jotai').WritableAtom<null, [selection: string], void> & {
+    init: null;
+};
+export declare const setSelectionPositionAtom: import('jotai').WritableAtom<null, [popoverPosition: SelectionPosition], void> & {
+    init: null;
+};
+export declare const setSelectionPopoverAtom: import('jotai').WritableAtom<null, [showPopover: boolean], void> & {
+    init: null;
+};
+export declare const setCurrentSelectionAtom: import('jotai').WritableAtom<null, [selection: string], void> & {
+    init: null;
+};
+export declare const setPopoverPositionAtom: import('jotai').WritableAtom<null, [popoverPosition: SelectionPosition], void> & {
+    init: null;
+};
+export declare const setShowPopoverAtom: import('jotai').WritableAtom<null, [showPopover: boolean], void> & {
+    init: null;
+};
+export declare const resetSelectionAtom: import('jotai').WritableAtom<null, [], void> & {
+    init: null;
+};

package/dist-lib/src/components/atoms/text-selection/selection.d.ts

@@ -0,0 +1,3 @@
+import { ReactElement } from 'react';
+import { TextSelectionProps } from './types';
+export declare function TextSelection({ children, selected, popover, component, componentProps, popoverComponent, popoverProps, renderPopover, onSelectionStart, onSelectionEnd, onPopoverShow, onPopoverHide, ...props }: TextSelectionProps): ReactElement;

package/dist-lib/src/components/atoms/text-selection/types.d.ts

@@ -0,0 +1,90 @@
+import { ComponentProps, ComponentType, ElementType, HTMLAttributes, ReactNode } from 'react';
+import { HighlightPopover as HighlightPopoverPrimitive } from '@omsimos/react-highlight-popover';
+import { PopoverPopup } from '../../ui/popover';
+import { TextProps } from '../text/types';
+export interface SelectionPosition {
+    top: number;
+    left: number;
+}
+export interface SelectionState {
+    selected: boolean;
+    currentSelection: string;
+    showPopover: boolean;
+    popoverPosition: SelectionPosition | null;
+}
+export type SelectionStateUpdate = Partial<SelectionState> | ((state: SelectionState) => Partial<SelectionState>);
+export interface SelectionRenderProps {
+    position: SelectionPosition;
+    selection: string;
+    selected: boolean;
+    showPopover: boolean;
+    setCurrentSelection: (selection: string) => void;
+    setShowPopover: (show: boolean) => void;
+    close: () => void;
+}
+export type SelectionPopoverComponent = ComponentType<SelectionRenderProps>;
+export type HighlightPopoverPrimitiveProps = ComponentProps<typeof HighlightPopoverPrimitive>;
+export interface HighlightPopoverProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    children?: ReactNode;
+    /** Render a component around the popover content. */
+    component?: ElementType;
+    /** Props forwarded to the custom component. */
+    componentProps?: Record<string, unknown>;
+    /** Render function for applications that need full control of the markup. */
+    render?: (props: SelectionRenderProps) => ReactNode;
+}
+export interface TextSelectionProps extends Omit<HighlightPopoverPrimitiveProps, "children" | "renderPopover" | "onSelectionStart" | "onSelectionEnd" | "onPopoverShow" | "onPopoverHide"> {
+    children: ReactNode;
+    selected?: boolean;
+    popover?: ReactNode;
+    component?: ElementType;
+    componentProps?: Record<string, unknown>;
+    popoverComponent?: ElementType;
+    popoverProps?: Record<string, unknown>;
+    renderPopover?: (props: SelectionRenderProps) => ReactNode;
+    onSelectionStart?: () => void;
+    onSelectionEnd?: (selection: string) => void;
+    onPopoverShow?: () => void;
+    onPopoverHide?: () => void;
+}
+export interface TextPopoverRenderProps {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    close: () => void;
+}
+export interface TextClickPopoverProps extends Omit<TextProps, "popover"> {
+    /** Popover content rendered when the text is clicked. */
+    popover?: ReactNode;
+    /** Render function for applications that need full control of the markup. */
+    renderPopover?: (props: TextPopoverRenderProps) => ReactNode;
+    /** Props forwarded to the popup (side, align, className, …). */
+    popoverProps?: ComponentProps<typeof PopoverPopup>;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+export interface UseSelectionOptions {
+    selected?: boolean;
+    onSelectionStart?: () => void;
+    onSelectionEnd?: (selection: string) => void;
+    onPopoverShow?: () => void;
+    onPopoverHide?: () => void;
+}
+export interface UseSelectionResult {
+    state: SelectionState;
+    selected: boolean;
+    currentSelection: string;
+    showPopover: boolean;
+    popoverPosition: SelectionState["popoverPosition"];
+    setSelection: (selection: string) => void;
+    setPosition: (position: NonNullable<SelectionState["popoverPosition"]>) => void;
+    setShowPopover: (show: boolean) => void;
+    update: (update: SelectionStateUpdate) => void;
+    reset: () => void;
+    selectionProps: {
+        onSelectionStart: () => void;
+        onSelectionEnd: (selection: string) => void;
+        onPopoverShow: () => void;
+        onPopoverHide: () => void;
+    };
+}

package/dist-lib/src/components/atoms/text-selection/use-selection.d.ts

@@ -0,0 +1,7 @@
+import { UseSelectionOptions, UseSelectionResult } from './types';
+/**
+ * Coordinates the third-party highlight popover callbacks with the shared
+ * selection atom. The returned `selectionProps` can be spread directly onto
+ * `@omsimos/react-highlight-popover`.
+ */
+export declare function useSelection(options?: UseSelectionOptions): UseSelectionResult;

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

@@ -0,0 +1,17 @@
+export type AtomSize = "xs" | "sm" | "default" | "lg" | "xl" | "xxl";
+export interface ReferenceProps {
+    /** With an href the chip renders as a link, otherwise as a button. */
+    href?: string;
+    target?: React.HTMLAttributeAnchorTarget;
+    rel?: string;
+    id?: string;
+    className?: string;
+    children?: React.ReactNode;
+    "aria-label"?: string;
+    onClick?: React.MouseEventHandler<HTMLElement>;
+    /**
+     * The passage the chip points at, shown in a preview card on hover or
+     * focus. Omitted, the chip is just a link.
+     */
+    preview?: React.ReactNode;
+}

package/dist-lib/src/components/blocks/auth/auth-flow-block.story.d.ts

@@ -0,0 +1,3 @@
+import { AuthFlowBlock } from './auth-flow-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof AuthFlowBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/code-auth-block.story.d.ts

@@ -0,0 +1,3 @@
+import { CodeAuthBlock } from './code-auth-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof CodeAuthBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/forgot-password-block.story.d.ts

@@ -0,0 +1,3 @@
+import { ForgotPasswordBlock } from './forgot-password-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof ForgotPasswordBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/linked-accounts-block.story.d.ts

@@ -0,0 +1,3 @@
+import { LinkedAccountsBlock } from './linked-accounts-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof LinkedAccountsBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/login-block.story.d.ts

@@ -0,0 +1,3 @@
+import { LoginBlock } from './login-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof LoginBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/onboarding-block.story.d.ts

@@ -0,0 +1,3 @@
+import { OnboardingBlock } from './onboarding-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof OnboardingBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/passkey-manager-block.story.d.ts

@@ -0,0 +1,3 @@
+import { PasskeyManagerBlock } from './passkey-manager-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof PasskeyManagerBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/passkey-sign-in-block.story.d.ts

@@ -0,0 +1,3 @@
+import { PasskeySignInBlock } from './passkey-sign-in-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof PasskeySignInBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/signup-block.story.d.ts

@@ -0,0 +1,3 @@
+import { SignupBlock } from './signup-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof SignupBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/auth/update-password-block.story.d.ts

@@ -0,0 +1,3 @@
+import { UpdatePasswordBlock } from './update-password-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof UpdatePasswordBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/chat/banners.d.ts

@@ -0,0 +1,13 @@
+import { LockedBannerProps } from './types';
+import type * as React from "react";
+export declare function LockedBanner({ children, className, }: LockedBannerProps): React.ReactElement;
+export interface PinnedThreadBannerProps {
+    className?: string;
+}
+export declare function PinnedThreadBanner({ className, }: PinnedThreadBannerProps): React.ReactElement;
+export interface DegradedBannerProps {
+    reason?: React.ReactNode;
+    onRetry?: () => void;
+    className?: string;
+}
+export declare function DegradedBanner({ reason, onRetry, className, }: DegradedBannerProps): React.ReactElement;

package/dist-lib/src/components/blocks/chat/base.d.ts

@@ -0,0 +1,10 @@
+import { AiPanelProps } from './types';
+import type * as React from "react";
+/**
+ * Full-height curation rail, designed to sit inside a host container such as
+ * the shell's right panel — it brings no surface chrome or close affordance
+ * of its own. Data fetching, streaming and version writes stay with the host
+ * application; this component only establishes layout and the focus order
+ * shared by all panel states.
+ */
+export declare function AiPanel({ onNewThread, thread, prompts, onPromptSelect, composerProps, locked, headerTitle, className, ...props }: AiPanelProps): React.ReactElement;

package/dist-lib/src/components/blocks/chat/base.story.d.ts

@@ -0,0 +1,3 @@
+import { AiPanel } from './base';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof AiPanel>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/chat/header.d.ts

@@ -0,0 +1,4 @@
+import { AiPanelHeaderProps } from './types';
+import type * as React from "react";
+/** The panel's sticky top row: title, lock hint and the new-thread button. */
+export declare function AiPanelHeader({ title, locked, onNewThread, }: AiPanelHeaderProps): React.ReactElement;

package/dist-lib/src/components/blocks/chat/index.d.ts

@@ -0,0 +1,13 @@
+import { AiPanel } from './base';
+export { AiPanel };
+export { AiPanelHeader } from './header';
+export { SuggestedPrompts } from './suggested-prompts';
+export { RecommendationStack } from './recommendation-stack';
+export type { RecommendationStackProps } from './recommendation-stack';
+export { DegradedBanner, LockedBanner, PinnedThreadBanner } from './banners';
+export type { DegradedBannerProps, PinnedThreadBannerProps } from './banners';
+export { VersionHistoryRecord } from './version-history-record';
+export { AppliedMark, ApplyToast, SelectionHighlight, SelectionPopover, } from '../../composed/reader';
+export type { AppliedMarkProps, ApplyToastProps, SelectionHighlightProps, SelectionPopoverProps, } from '../../composed/reader';
+export type { AiPanelHeaderProps, AiPanelProps, LockedBannerProps, AiScope, AiScopeKind, ComposerMode, DiffRow, NodeSelection, SuggestionState, VersionHistoryEntry, SuggestedPromptsProps, WordSelection, } from './types';
+export default AiPanel;

package/dist-lib/src/components/blocks/chat/recommendation-stack.d.ts

@@ -0,0 +1,13 @@
+import type * as React from "react";
+export interface RecommendationStackProps extends React.ComponentPropsWithoutRef<"div"> {
+    children: React.ReactNode;
+}
+/**
+ * Fuses a run of RecommendationCards into one bordered stack for the thread.
+ *
+ * The ui Group only fuses bordered direct children, but each card wraps its
+ * frame in a borderless accordion root — so the frames are fused one level
+ * down instead, and the Group-injected ::before (which would render as a
+ * phantom flex item between the cards) is dropped.
+ */
+export declare function RecommendationStack({ className, children, ...props }: RecommendationStackProps): React.ReactElement;

package/dist-lib/src/components/blocks/chat/shared.d.ts

@@ -0,0 +1,8 @@
+export { accentRing, accentSolid, accentText, ghostMuted, mutedText, surface, } from '../../composed/ai/shared';
+export declare function formatScopeLabel(scope: {
+    kind: string;
+    label: string;
+    location?: string;
+    range?: string;
+    pinned?: boolean;
+}): string;

package/dist-lib/src/components/blocks/chat/suggested-prompts.d.ts

@@ -0,0 +1,3 @@
+import { SuggestedPromptsProps } from './types';
+import type * as React from "react";
+export declare function SuggestedPrompts({ prompts, onSelect, emptyLabel, className, }: SuggestedPromptsProps): React.ReactElement | null;

package/dist-lib/src/components/blocks/chat/types.d.ts

@@ -0,0 +1,64 @@
+import { IComposerProps } from '../../composed/chat/composer';
+import type * as React from "react";
+export type AiScopeKind = "word" | "passage" | "articulus" | "quaestio" | "corpus";
+export interface AiScope {
+    kind: AiScopeKind;
+    label: string;
+    /** Reader location shown after a normal word/node scope. */
+    location?: string;
+    range?: string;
+    nodeId?: string;
+    nodeIds?: string[];
+    pinned?: boolean;
+}
+export type { NodeSelection, WordSelection } from '../../composed/reader';
+export interface AiPanelProps extends Omit<React.ComponentPropsWithoutRef<"aside">, "title"> {
+    scope: AiScope;
+    onNewThread?: () => void;
+    onScopeChange?: (kind: AiScope["kind"]) => void;
+    onRemoveScope?: () => void;
+    thread?: React.ReactNode;
+    /** Transient confirmation (e.g. ApplyToast), anchored to the bottom of the
+     * thread and sized slightly narrower than the composer. */
+    toast?: React.ReactNode;
+    prompts?: string[];
+    onPromptSelect?: (prompt: string) => void;
+    composerProps?: IComposerProps;
+    scopePickerOpen?: boolean;
+    onScopePickerOpenChange?: (open: boolean) => void;
+    locked?: boolean;
+    headerTitle?: string;
+}
+export interface AiPanelHeaderProps {
+    title: string;
+    /** Shows the lock affordance and its “Published corpus” tooltip. */
+    locked?: boolean;
+    onNewThread?: () => void;
+}
+export type { ComposerMode } from '../../composed/chat/composer';
+export type { DiffRow, SuggestionState } from '../../composed/ai/types';
+export interface VersionHistoryEntry {
+    id?: string;
+    responseId: string;
+    applyingUser?: string;
+    nodeId: string;
+    previousValue: string;
+    nextValue?: string;
+    timestamp: string | Date;
+    version: string;
+    action?: "apply" | "revert";
+}
+export interface SuggestedPromptsProps {
+    prompts?: string[];
+    onSelect?: (prompt: string) => void;
+    emptyLabel?: string;
+    className?: string;
+}
+export interface VersionHistoryRecordProps {
+    entry: VersionHistoryEntry;
+    className?: string;
+}
+export interface LockedBannerProps {
+    children?: React.ReactNode;
+    className?: string;
+}

package/dist-lib/src/components/blocks/chat/version-history-record.d.ts

@@ -0,0 +1,3 @@
+import { VersionHistoryRecordProps } from './types';
+import type * as React from "react";
+export declare function VersionHistoryRecord({ entry, className, }: VersionHistoryRecordProps): React.ReactElement;

package/dist-lib/{components → src/components}/blocks/profile/profile-card-block.d.ts

@@ -45,13 +45,8 @@ export interface ProfileCardBlockProps {
      * `useId` and are dropped on unmount.
      */
     profileCardId?: string;
-    /**
-     * Presence badge on the avatar — overrides `user.presence`. Name the avatar
-     * with `avatarId` and `useUserAvatarActions(id).setPresence()` can flip it
-     * from a socket handler instead.
-     */
+    /** Presence badge on the avatar — overrides `user.presence`. */
     presence?: ProfileCardUser["presence"];
-    avatarId?: string;
     /**
      * Emit cuelume press/release on the card and play the open/close cues.
      * Inert unless the app opts into interaction sound via `bindSounds()`.
@@ -68,4 +63,4 @@ export interface ProfileCardBlockProps {
  * popup is a plain action menu. `items` is the whole menu — a flat list of
  * actions, separators and labels — defaulting to `defaultProfileCardItems`.
  */
-export declare function ProfileCardBlock({ user, items, align, side, sideOffset, menuWidth, variant: variantProp, defaultVariant, onVariantChange, profileCardId, presence, avatarId, open, defaultOpen, onOpenChange, sound, onError, className, }: ProfileCardBlockProps): React.ReactElement;
+export declare function ProfileCardBlock({ user, items, align, side, sideOffset, menuWidth, variant: variantProp, defaultVariant, onVariantChange, profileCardId, presence, open, defaultOpen, onOpenChange, sound, onError, className, }: ProfileCardBlockProps): React.ReactElement;

package/dist-lib/src/components/blocks/profile/profile-card-block.story.d.ts

@@ -0,0 +1,3 @@
+import { ProfileCardBlock } from './profile-card-block';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof ProfileCardBlock>;
+export declare const Preview: import('react').FC;

package/dist-lib/{components → src/components}/blocks/profile/type.d.ts

@@ -1,4 +1,4 @@
-import { UserPresence } from '../../user-avatar';
+import { AvatarStatus } from '../../atoms';
 import type * as React from "react";
 /** The identity shown on the card. */
 export interface ProfileCardUser {
@@ -10,7 +10,7 @@ export interface ProfileCardUser {
     /** Fallback initials. Derived from `name` when omitted. */
     initials?: string;
     /** Presence badge on the avatar. Omitted, no badge. */
-    presence?: UserPresence;
+    presence?: AvatarStatus;
 }
 /** An actionable row of the menu. */
 export interface ProfileCardAction {

package/dist-lib/src/components/blocks/scaffold/scaffold-root.story.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldRoot } from './scaffold-root';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof ScaffoldRoot>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/blocks/shell/shell-layout.story.d.ts

@@ -0,0 +1,3 @@
+import { ShellLayout } from './shell-layout';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof ShellLayout>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/composed/action-bar/action.d.ts

@@ -0,0 +1,18 @@
+import { ActionButtonProps } from './types';
+import { ToolbarSeparatorProps } from '@base-ui/react';
+export declare function Action({ tooltip, action, Icon, }: Omit<ActionButtonProps<string>, "children">): import("react").JSX.Element;
+/**
+ * Group boundary. Pass it under a `separator-*` key in `actions` and the bar
+ * wraps the runs of actions either side of it in their own `ToolbarGroup`.
+ */
+export declare function Separator(props: ToolbarSeparatorProps): import("react").JSX.Element;
+/**
+ * An action labelled by an emoji glyph rather than a Lucide icon. The glyph is
+ * `aria-hidden` — `label` is the accessible name, so a screen reader reads
+ * "thumbs up" rather than announcing the character.
+ */
+export declare function EmojiAction({ emoji, label, action, }: {
+    emoji: string;
+    label: string;
+    action: () => void;
+}): import("react").JSX.Element;

package/dist-lib/src/components/composed/action-bar/emojis.d.ts

@@ -0,0 +1,10 @@
+import { EmojiActionBarProps } from './types';
+import type * as React from "react";
+/**
+ * Compact reaction picker: a toolbar of quick emoji, then a "More" action that
+ * swaps the surface for the full frimousse picker. Meant to sit inside a
+ * `PopoverGlass variant="glass"` — swapping the two surfaces resizes the popup,
+ * which is why the popup's viewport padding variable has to be zeroed rather
+ * than only its padding (see `BubbleReactionsButton`).
+ */
+export declare function EmojiActionBar({ onEmojiSelect, reactions, hideMore, }: EmojiActionBarProps): React.ReactElement;

package/dist-lib/src/components/composed/action-bar/index.d.ts

@@ -0,0 +1,12 @@
+import { EmojiActionBar } from './emojis';
+import { Action, EmojiAction, Separator } from './action';
+import { default as Toolbar } from './toolbar';
+export { useActionBar, useEmojiPicker, QUICK_REACTIONS } from './utils';
+export type { ActionBarProps, ActionBarSegment, ActionButtonProps, EmojiActionBarProps, ActionEntry, ActionItemsByGroup, ActionKey, ActionMap, } from './types';
+export declare const ActionBar: {
+    Emoji: typeof EmojiActionBar;
+    Separator: typeof Separator;
+    EmojiAction: typeof EmojiAction;
+    Action: typeof Action;
+};
+export default Toolbar;

package/dist-lib/src/components/composed/action-bar/toolbar.d.ts

@@ -0,0 +1,2 @@
+import { ActionBarProps } from './types';
+export default function Toolbar({ id, actions, variant, className, }: ActionBarProps): import("react").JSX.Element;

package/dist-lib/src/components/composed/action-bar/types.d.ts

@@ -0,0 +1,55 @@
+import { ButtonProps } from '../../ui/button';
+import { PopoverGlassProps } from '../../ui/popover-glass';
+import { ToolbarSeparatorProps } from '@base-ui/react';
+import { Emoji } from 'frimousse';
+import { LucideIcon } from 'lucide-react';
+import { FunctionComponent } from 'react';
+export interface ActionButtonProps<T extends string> extends Omit<ButtonProps, "variant" | "glassVariant" | "size"> {
+    action: () => void;
+    tooltip?: string;
+    Icon: LucideIcon | Emoji;
+    id: T;
+}
+type ActionBarItemType = "action" | "separator";
+export type ActionKey<T extends string = string, Type extends ActionBarItemType = "action"> = `${Type}-${T}`;
+/**
+ * Insertion order is the contract: the bar groups positionally, so the order
+ * keys are written is the order they render. Safe because every `ActionKey`
+ * is a non-numeric `${type}-${name}` string, which `Object.entries` preserves
+ * — but a map built by spreading or `Object.fromEntries` must keep that order.
+ */
+export type ActionMap<T extends ActionKey> = Record<T, FunctionComponent<ActionButtonProps<T> | ToolbarSeparatorProps>>;
+export type ActionEntry = readonly [
+    key: string,
+    Item: FunctionComponent<ActionButtonProps<string> | ToolbarSeparatorProps>
+];
+/** Actions between two separators, rendered inside one `ToolbarGroup`. */
+export type ActionItemsByGroup = Record<string, ActionEntry[]>;
+/**
+ * The bar as an ordered, render-ready list. A "group" is a run of consecutive
+ * actions; a "separator" is whatever component the map supplied for that key.
+ * Empty groups (leading, trailing or back-to-back separators) are dropped.
+ */
+export type ActionBarSegment = {
+    type: "group";
+    key: string;
+    items: ActionEntry[];
+} | {
+    type: "separator";
+    key: string;
+    Separator: FunctionComponent<ToolbarSeparatorProps>;
+};
+export interface ActionBarProps extends Omit<PopoverGlassProps, "variant" | "children"> {
+    id: string;
+    variant: "default" | "ghost" | "glass";
+    actions: ActionMap<ActionKey>;
+}
+export interface EmojiActionBarProps {
+    /** Fires for both a quick reaction and a pick from the full picker. */
+    onEmojiSelect?: (emoji: Emoji) => void;
+    /** Quick row contents. Defaults to {@link QUICK_REACTIONS}. */
+    reactions?: readonly Emoji[];
+    /** Hides the trailing "More" action, leaving the quick row only. */
+    hideMore?: boolean;
+}
+export {};