@exegia/corpora-ui 0.8.0 → 0.10.0

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

@@ -16,6 +16,12 @@ export interface LinkedAccountsBlockProps {
     providers?: SocialProvider[];
     /** Shows the loading row instead of the list. */
     loading?: boolean;
+    /**
+     * The account can also sign in through a method that has no row in this
+     * list — an email/password credential, say. Lifts the last-method guard,
+     * which otherwise refuses to disconnect the final listed identity.
+     */
+    hasOtherSignInMethods?: boolean;
     /** Reject (or throw) to show the inline error. */
     onLink?: (provider: SocialProvider) => Promise<void> | void;
     onUnlink?: (id: string) => Promise<void> | void;
@@ -27,4 +33,4 @@ export interface LinkedAccountsBlockProps {
  * remaining method from being disconnected — the guard is a disabled button
  * plus an explanation rather than an error after the fact.
  */
-export declare function LinkedAccountsBlock({ title, description, identities, providers, loading, onLink, onUnlink, className, }: LinkedAccountsBlockProps): React.JSX.Element;
+export declare function LinkedAccountsBlock({ title, description, identities, providers, loading, hasOtherSignInMethods, onLink, onUnlink, className, }: LinkedAccountsBlockProps): React.JSX.Element;

package/dist-lib/components/blocks/nav/__tests__/sidebar-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/nav/sidebar-block.d.ts

@@ -0,0 +1,67 @@
+import * as React from "react";
+/** A nested link, one level under a top-level entry. */
+export interface SidebarNavSubItem {
+    id: string;
+    label: string;
+    icon?: React.ReactNode;
+    /** Renders an anchor. Without one the row is a button. */
+    href?: string;
+    disabled?: boolean;
+    target?: "_blank" | "_self" | "_parent" | "_top";
+    onSelect?: () => void;
+}
+/** A top-level entry. With `items` it expands instead of navigating. */
+export interface SidebarNavItem extends SidebarNavSubItem {
+    /** Trailing hint — a count, a "New" pill. Hidden while collapsed. */
+    badge?: React.ReactNode;
+    items?: SidebarNavSubItem[];
+    /** Start expanded. Defaults to expanded when one of its children is active. */
+    defaultOpen?: boolean;
+}
+/** A titled run of entries. The title hides while the rail is collapsed. */
+export interface SidebarNavSection {
+    id: string;
+    label?: string;
+    items: SidebarNavItem[];
+}
+export interface SidebarBlockProps {
+    sections: SidebarNavSection[];
+    /** `id` of the current entry — matches top-level and nested ids alike. */
+    activeId?: string;
+    /** Fires for every selection, after the entry's own `onSelect`. */
+    onNavigate?: (item: SidebarNavItem | SidebarNavSubItem) => void;
+    /** Brand row above the navigation. */
+    header?: React.ReactNode;
+    /** Pinned below the navigation — an account card, a version note. */
+    footer?: React.ReactNode;
+    /** Collapse toggle in the header row. */
+    showTrigger?: boolean;
+    side?: "left" | "right";
+    variant?: "sidebar" | "floating" | "inset";
+    /** How the rail collapses: to icons, off-canvas, or not at all. */
+    collapsible?: "offcanvas" | "icon" | "none";
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Under 768px the panel is a drawer — drive it from your own header. */
+    openMobile?: boolean;
+    defaultOpenMobile?: boolean;
+    onOpenMobileChange?: (open: boolean) => void;
+    /** Rail widths. CSS lengths, e.g. "16rem". */
+    width?: string;
+    iconWidth?: string;
+    mobileWidth?: string;
+    ariaLabel?: string;
+    className?: string;
+}
+/**
+ * Application sidebar navigation, driven by data rather than composition.
+ *
+ * This is the navigation panel only — it claims no page layout, so place it
+ * beside your own content. It owns its own sidebar context (⌘B toggles it);
+ * pass `open`/`onOpenChange` to drive the rail, and `openMobile`/
+ * `onOpenMobileChange` to open the drawer from a header button of your own.
+ * Compose the underlying `AnimatedSidebar*` parts directly when a screen
+ * needs something this API does not cover.
+ */
+export declare function SidebarBlock({ sections, activeId, onNavigate, header, footer, showTrigger, side, variant, collapsible, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, width, iconWidth, mobileWidth, ariaLabel, className, }: SidebarBlockProps): React.ReactElement;

package/dist-lib/components/blocks/profile/__tests__/profile-card-block.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,77 @@
+import { DropdownMenuContent, MenuPrimitive } from '../../ui/menu';
+import * as React from "react";
+/** The identity shown on the card. */
+export interface ProfileCardUser {
+    name: string;
+    /** Secondary line under the name — a handle, an email, a role. */
+    username?: string;
+    /** Avatar image URL. Falls back to the initials when absent or broken. */
+    avatar?: string;
+    /** Fallback initials. Derived from `name` when omitted. */
+    initials?: string;
+}
+/** An actionable row of the menu. */
+export interface ProfileCardAction {
+    type?: "item";
+    id: string;
+    label: string;
+    icon?: React.ReactNode;
+    /** Right-aligned hint, e.g. "⌘K". Purely decorative — bind the key yourself. */
+    shortcut?: string;
+    disabled?: boolean;
+    variant?: "default" | "destructive";
+    /** Returning a promise puts the card in its loading state until it settles. */
+    onSelect?: () => void | Promise<void>;
+}
+/** A heading over the rows that follow it, up to the next separator. */
+export interface ProfileCardLabel {
+    type: "label";
+    label: string;
+}
+/** A rule between two sections. */
+export interface ProfileCardSeparator {
+    type: "separator";
+}
+/**
+ * One entry of `items`. Authored flat; the block renders each run between
+ * separators as its own menu group so a label actually names its section.
+ */
+export type ProfileCardItem = ProfileCardAction | ProfileCardLabel | ProfileCardSeparator;
+/**
+ * The menu the card ships with. Spread it to keep the shape and attach your
+ * own handlers, or ignore it and pass `items` of your own.
+ */
+export declare const defaultProfileCardItems: ProfileCardItem[];
+type PopupProps = React.ComponentProps<typeof DropdownMenuContent>;
+export interface ProfileCardBlockProps {
+    user: ProfileCardUser;
+    /**
+     * The menu, flat: actions plus `{ type: "separator" }` / `{ type: "label" }`
+     * entries. Defaults to `defaultProfileCardItems` (no handlers attached).
+     */
+    items?: ProfileCardItem[];
+    /** Menu placement relative to the card. */
+    align?: PopupProps["align"];
+    side?: PopupProps["side"];
+    sideOffset?: PopupProps["sideOffset"];
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: MenuPrimitive.Root.Props["onOpenChange"];
+    /**
+     * Emit cuelume press/release on the card and play the open/close cues.
+     * Inert unless the app opts into interaction sound via `bindSounds()`.
+     */
+    sound?: boolean;
+    /** Called when an action's promise rejects — the card leaves its loading state either way. */
+    onError?: (error: unknown) => void;
+    className?: string;
+}
+/**
+ * Avatar card that opens an account menu.
+ *
+ * The trigger is the rich identity chip (avatar + name over handle) and the
+ * 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, open, defaultOpen, onOpenChange, sound, onError, className, }: ProfileCardBlockProps): React.ReactElement;
+export {};

package/dist-lib/components/composed/__tests__/user-avatar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/composed/user-avatar.d.ts

@@ -0,0 +1,30 @@
+import { AvatarPrimitive } from '../ui/avatar';
+import * as React from "react";
+export interface UserAvatarProps extends Omit<AvatarPrimitive.Root.Props, "children"> {
+    /** Image URL. Without one the initials show immediately — no skeleton. */
+    src?: string;
+    /** Drives the initials, and the alt text unless `alt` overrides it. */
+    name?: string;
+    /** Overrides the initials derived from `name`. */
+    initials?: string;
+    /**
+     * Alt text for the image. Pass "" when adjacent text already names the
+     * person — the image is then decorative.
+     */
+    alt?: string;
+    /**
+     * Force the skeleton, for when the identity itself is still being fetched.
+     * Omitted, it follows the image: a passed `src` skeletons until it resolves.
+     */
+    loading?: boolean;
+}
+/** "Jenny Hamilton" → "JH", "luna" → "L". */
+export declare function initialsFrom(name: string): string;
+/**
+ * Identity avatar: an image when one is given, initials otherwise.
+ *
+ * A passed `src` is assumed to be remote, so the slot holds a skeleton until
+ * the image resolves rather than flashing initials that are about to be
+ * replaced. A failed load settles on the initials.
+ */
+export declare function UserAvatar({ src, name, initials, alt, loading: loadingProp, className, ...props }: UserAvatarProps): React.ReactElement;

package/dist-lib/components/motion/animated-sidebar.d.ts

@@ -0,0 +1,98 @@
+import { HTMLMotionProps } from 'motion/react';
+import { ButtonHTMLAttributes, CSSProperties, HTMLAttributes, ReactNode } from 'react';
+type SidebarState = "expanded" | "collapsed";
+type SidebarSide = "left" | "right";
+type SidebarVariant = "sidebar" | "floating" | "inset";
+type SidebarCollapsible = "offcanvas" | "icon" | "none";
+interface AnimatedSidebarContextValue {
+    isMobile: boolean;
+    layoutId: string;
+    open: boolean;
+    openMobile: boolean;
+    reduce: boolean;
+    setOpen: (open: boolean) => void;
+    setOpenMobile: (open: boolean) => void;
+    state: SidebarState;
+    toggleSidebar: () => void;
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+}
+export declare function useAnimatedSidebar(): AnimatedSidebarContextValue;
+type SidebarProviderStyle = CSSProperties & {
+    "--sidebar-width"?: string;
+    "--sidebar-width-icon"?: string;
+    "--sidebar-width-mobile"?: string;
+};
+export interface AnimatedSidebarProviderProps extends HTMLAttributes<HTMLDivElement> {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    openMobile?: boolean;
+    defaultOpenMobile?: boolean;
+    onOpenMobileChange?: (open: boolean) => void;
+    style?: SidebarProviderStyle;
+}
+export declare function AnimatedSidebarProvider({ children, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, className, style, ...props }: AnimatedSidebarProviderProps): import("react").JSX.Element;
+export interface AnimatedSidebarProps extends Omit<HTMLMotionProps<"aside">, "children"> {
+    children?: ReactNode;
+    side?: SidebarSide;
+    variant?: SidebarVariant;
+    collapsible?: SidebarCollapsible;
+    ariaLabel?: string;
+    panelClassName?: string;
+}
+export declare const AnimatedSidebar: import('react').ForwardRefExoticComponent<Omit<AnimatedSidebarProps, "ref"> & import('react').RefAttributes<HTMLElement>>;
+export interface AnimatedSidebarTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+export declare const AnimatedSidebarTrigger: import('react').ForwardRefExoticComponent<AnimatedSidebarTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;
+export interface AnimatedSidebarCloseProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+export declare const AnimatedSidebarClose: import('react').ForwardRefExoticComponent<AnimatedSidebarCloseProps & import('react').RefAttributes<HTMLButtonElement>>;
+export interface AnimatedSidebarRailProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+}
+export declare const AnimatedSidebarRail: import('react').ForwardRefExoticComponent<AnimatedSidebarRailProps & import('react').RefAttributes<HTMLButtonElement>>;
+export interface AnimatedSidebarInsetProps extends HTMLMotionProps<"main"> {
+}
+export declare const AnimatedSidebarInset: import('react').ForwardRefExoticComponent<Omit<AnimatedSidebarInsetProps, "ref"> & import('react').RefAttributes<HTMLElement>>;
+export declare const AnimatedSidebarHeader: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarContent: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarFooter: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarGroup: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarGroupLabel: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarGroupContent: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;
+export declare const AnimatedSidebarMenu: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLUListElement> & import('react').RefAttributes<HTMLUListElement>>;
+export declare const AnimatedSidebarMenuItem: import('react').ForwardRefExoticComponent<Omit<HTMLMotionProps<"li">, "ref"> & import('react').RefAttributes<HTMLLIElement>>;
+export interface AnimatedSidebarMenuSubProps extends Omit<HTMLMotionProps<"ul">, "children"> {
+    open: boolean;
+    children?: ReactNode;
+}
+export declare const AnimatedSidebarMenuSub: import('react').ForwardRefExoticComponent<Omit<AnimatedSidebarMenuSubProps, "ref"> & import('react').RefAttributes<HTMLUListElement>>;
+export declare const AnimatedSidebarMenuSubItem: import('react').ForwardRefExoticComponent<Omit<HTMLMotionProps<"li">, "ref"> & import('react').RefAttributes<HTMLLIElement>>;
+export interface AnimatedSidebarMenuSubButtonProps {
+    children: ReactNode;
+    icon?: ReactNode;
+    href?: string;
+    isActive?: boolean;
+    disabled?: boolean;
+    closeOnSelect?: boolean;
+    target?: "_blank" | "_self" | "_parent" | "_top";
+    rel?: string;
+    onSelect?: () => void;
+    className?: string;
+}
+export declare function AnimatedSidebarMenuSubButton({ children, icon, href, isActive, disabled, closeOnSelect, target, rel, onSelect, className, }: AnimatedSidebarMenuSubButtonProps): import("react").JSX.Element;
+export interface AnimatedSidebarMenuButtonProps {
+    children: ReactNode;
+    icon?: ReactNode;
+    badge?: ReactNode;
+    href?: string;
+    isActive?: boolean;
+    ariaExpanded?: boolean;
+    disabled?: boolean;
+    closeOnSelect?: boolean;
+    target?: "_blank" | "_self" | "_parent" | "_top";
+    rel?: string;
+    onSelect?: () => void;
+    className?: string;
+}
+export declare function AnimatedSidebarMenuButton({ children, icon, badge, href, isActive, ariaExpanded, disabled, closeOnSelect, target, rel, onSelect, className, }: AnimatedSidebarMenuButtonProps): import("react").JSX.Element;
+export {};

package/dist-lib/components/motion/shared-layout-bg.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface SharedLayoutBgProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    children: ReactNode;
+    /** Semantic container used for the children. */
+    as?: "div" | "ul";
+    /** Tailwind class applied to the moving pill. Defaults to a subtle foreground tint. */
+    pillClassName?: string;
+    /** Horizontal inset of the pill relative to each row (px). Default 20. */
+    inset?: number;
+    /** Optional positioning override for the pill wrapper inside each item. */
+    pillContainerClassName?: string;
+}
+export declare const SharedLayoutBg: import('react').ForwardRefExoticComponent<SharedLayoutBgProps & import('react').RefAttributes<HTMLElement>>;

package/dist-lib/components/ui/avatar.d.ts

@@ -0,0 +1,6 @@
+import { Avatar as AvatarPrimitive } from '@base-ui/react/avatar';
+import { default as React } from 'react';
+export declare function Avatar({ className, ...props }: AvatarPrimitive.Root.Props): React.ReactElement;
+export declare function AvatarImage({ className, ...props }: AvatarPrimitive.Image.Props): React.ReactElement;
+export declare function AvatarFallback({ className, ...props }: AvatarPrimitive.Fallback.Props): React.ReactElement;
+export { AvatarPrimitive };

package/dist-lib/components/ui/menu.d.ts

@@ -0,0 +1,43 @@
+import { Menu as MenuPrimitive } from '@base-ui/react/menu';
+import type * as React from "react";
+export declare const MenuCreateHandle: typeof MenuPrimitive.createHandle;
+export declare const Menu: typeof MenuPrimitive.Root;
+export declare const MenuPortal: typeof MenuPrimitive.Portal;
+export declare function MenuTrigger({ className, children, ...props }: MenuPrimitive.Trigger.Props): React.ReactElement;
+export declare function MenuPopup({ children, className, sideOffset, align, alignOffset, side, anchor, portalProps, ...props }: MenuPrimitive.Popup.Props & {
+    align?: MenuPrimitive.Positioner.Props["align"];
+    sideOffset?: MenuPrimitive.Positioner.Props["sideOffset"];
+    alignOffset?: MenuPrimitive.Positioner.Props["alignOffset"];
+    side?: MenuPrimitive.Positioner.Props["side"];
+    anchor?: MenuPrimitive.Positioner.Props["anchor"];
+    portalProps?: MenuPrimitive.Portal.Props;
+}): React.ReactElement;
+export declare function MenuGroup(props: MenuPrimitive.Group.Props): React.ReactElement;
+export declare function MenuItem({ className, inset, variant, ...props }: MenuPrimitive.Item.Props & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.ReactElement;
+export declare function MenuLinkItem({ className, inset, variant, closeOnClick, ...props }: MenuPrimitive.LinkItem.Props & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.ReactElement;
+export declare function MenuCheckboxItem({ className, children, checked, variant, ...props }: MenuPrimitive.CheckboxItem.Props & {
+    variant?: "default" | "switch";
+}): React.ReactElement;
+export declare function MenuRadioGroup(props: MenuPrimitive.RadioGroup.Props): React.ReactElement;
+export declare function MenuRadioItem({ className, children, ...props }: MenuPrimitive.RadioItem.Props): React.ReactElement;
+export declare function MenuGroupLabel({ className, inset, ...props }: MenuPrimitive.GroupLabel.Props & {
+    inset?: boolean;
+}): React.ReactElement;
+export declare function MenuSeparator({ className, ...props }: MenuPrimitive.Separator.Props): React.ReactElement;
+export declare function MenuShortcut({ className, ...props }: React.ComponentProps<"kbd">): React.ReactElement;
+export declare function MenuSub(props: MenuPrimitive.SubmenuRoot.Props): React.ReactElement;
+export declare function MenuSubTrigger({ className, inset, children, ...props }: MenuPrimitive.SubmenuTrigger.Props & {
+    inset?: boolean;
+}): React.ReactElement;
+export declare function MenuSubPopup({ className, sideOffset, alignOffset, align, ...props }: MenuPrimitive.Popup.Props & {
+    align?: MenuPrimitive.Positioner.Props["align"];
+    sideOffset?: MenuPrimitive.Positioner.Props["sideOffset"];
+    alignOffset?: MenuPrimitive.Positioner.Props["alignOffset"];
+}): React.ReactElement;
+export { MenuPrimitive, MenuCreateHandle as DropdownMenuCreateHandle, Menu as DropdownMenu, MenuPortal as DropdownMenuPortal, MenuTrigger as DropdownMenuTrigger, MenuPopup as DropdownMenuContent, MenuGroup as DropdownMenuGroup, MenuItem as DropdownMenuItem, MenuCheckboxItem as DropdownMenuCheckboxItem, MenuRadioGroup as DropdownMenuRadioGroup, MenuRadioItem as DropdownMenuRadioItem, MenuGroupLabel as DropdownMenuLabel, MenuSeparator as DropdownMenuSeparator, MenuShortcut as DropdownMenuShortcut, MenuSub as DropdownMenuSub, MenuSubTrigger as DropdownMenuSubTrigger, MenuSubPopup as DropdownMenuSubContent, };

package/dist-lib/components/ui/skeleton.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare function Skeleton({ className, ...props }: React.ComponentProps<"div">): React.ReactElement;

package/dist-lib/index.d.ts

@@ -5,6 +5,7 @@
  * compositions from `components/composed`, blocks from `components/blocks`.
  * The docs site (main.tsx + routes.tsx + pages/) is NOT part of the package.
  */
+export * from './components/ui/avatar';
 export * from './components/ui/button';
 export * from './components/ui/card';
 export * from './components/ui/checkbox';
@@ -13,12 +14,15 @@ export * from './components/ui/frame';
 export * from './components/ui/input';
 export * from './components/ui/input-group';
 export * from './components/ui/label';
+export * from './components/ui/menu';
 export * from './components/ui/otp-field';
 export * from './components/ui/separator';
+export * from './components/ui/skeleton';
 export * from './components/ui/spinner';
 export * from './components/ui/textarea';
 export * from './components/composed/password-input';
 export * from './components/composed/social-providers';
+export * from './components/composed/user-avatar';
 export * from './components/blocks/auth/auth-shell';
 export * from './components/blocks/auth/code-auth-block';
 export * from './components/blocks/auth/forgot-password-block';
@@ -29,6 +33,11 @@ export * from './components/blocks/auth/passkey-manager-block';
 export * from './components/blocks/auth/passkey-sign-in-block';
 export * from './components/blocks/auth/signup-block';
 export * from './components/blocks/auth/update-password-block';
+export * from './components/blocks/nav/sidebar-block';
+export * from './components/blocks/profile/profile-card-block';
+export * from './components/motion/animated-sidebar';
+export * from './components/motion/shared-layout-bg';
 export * from './lib/auth-accent';
+export * from './lib/ease';
 export * from './lib/sound';
 export * from './lib/utils';