@exegia/corpora-ui 3.0.0 → 3.1.0

package/src/components/composed/tree/utils.ts

@@ -1,172 +0,0 @@
-import type { ITreeNode } from "./type"
-
-/** Depth-0 nodes read as sections only when the data actually nests three
- * levels — a two-level tree keeps its top level as plain link rows. */
-export function hasThreeLevels(items: readonly ITreeNode[]): boolean {
-  return items.some((node) =>
-    node.children?.some((child) => (child.children?.length ?? 0) > 0)
-  )
-}
-
-/** Ids of every ancestor of `id` (nearest last); empty when absent. */
-export function ancestorIdsOf(
-  items: readonly ITreeNode[],
-  id: string
-): string[] {
-  const walk = (nodes: readonly ITreeNode[], trail: string[]): string[] | null => {
-    for (const node of nodes) {
-      if (node.id === id) return trail
-      if (node.children) {
-        const found = walk(node.children, [...trail, node.id])
-        if (found) return found
-      }
-    }
-    return null
-  }
-  return walk(items, []) ?? []
-}
-
-/** Ids that start expanded: `defaultOpen` nodes plus every ancestor of the
- * active entry, so the current location is never folded away. */
-export function initialExpandedIds(
-  items: readonly ITreeNode[],
-  activeId?: string
-): Set<string> {
-  const expanded = new Set<string>()
-  const walk = (nodes: readonly ITreeNode[]) => {
-    for (const node of nodes) {
-      if (node.defaultOpen) expanded.add(node.id)
-      if (node.children) walk(node.children)
-    }
-  }
-  walk(items)
-  if (activeId !== undefined)
-    for (const id of ancestorIdsOf(items, activeId)) expanded.add(id)
-  return expanded
-}
-
-/** Ids of every node that can hold children — the set `expandAll` opens.
- * In `files` an empty `children: []` still counts (it is a folder). */
-export function expandableIdsOf(
-  items: readonly ITreeNode[],
-  filesVariant = false
-): string[] {
-  const ids: string[] = []
-  const walk = (nodes: readonly ITreeNode[]) => {
-    for (const node of nodes) {
-      const branch = filesVariant
-        ? node.children !== undefined
-        : (node.children?.length ?? 0) > 0
-      if (branch) ids.push(node.id)
-      if (node.children) walk(node.children)
-    }
-  }
-  walk(items)
-  return ids
-}
-
-/** Immutably relabel `id`. Returns the same array reference when absent. */
-export function renameNode(
-  items: readonly ITreeNode[],
-  id: string,
-  label: string
-): ITreeNode[] {
-  return items.map((node) => {
-    if (node.id === id) return { ...node, label }
-    return node.children
-      ? { ...node, children: renameNode(node.children, id, label) }
-      : node
-  })
-}
-
-/** Whether `candidateId` is `id` itself or nests anywhere under it — the
- * guard that keeps a folder from being dropped into its own subtree. */
-export function containsNode(
-  items: readonly ITreeNode[],
-  id: string,
-  candidateId: string
-): boolean {
-  if (id === candidateId) return true
-  const root = findNode(items, id)
-  if (!root?.children) return false
-  return findNode(root.children, candidateId) !== null
-}
-
-export function findNode(
-  items: readonly ITreeNode[],
-  id: string
-): ITreeNode | null {
-  for (const node of items) {
-    if (node.id === id) return node
-    if (node.children) {
-      const found = findNode(node.children, id)
-      if (found) return found
-    }
-  }
-  return null
-}
-
-/** Parent id (`null` at root) and index of `id` among its siblings. */
-export function locateNode(
-  items: readonly ITreeNode[],
-  id: string
-): { parentId: string | null; index: number } | null {
-  const walk = (
-    nodes: readonly ITreeNode[],
-    parentId: string | null
-  ): { parentId: string | null; index: number } | null => {
-    for (const [index, node] of nodes.entries()) {
-      if (node.id === id) return { parentId, index }
-      if (node.children) {
-        const found = walk(node.children, node.id)
-        if (found) return found
-      }
-    }
-    return null
-  }
-  return walk(items, null)
-}
-
-/** Immutably lift `id` out of the tree and reinsert it under `parentId`
- * (`null` = root) at `index` — the standard `onMove` reducer, exported so
- * consumers don't each rebuild it. `index` addresses the sibling list
- * *after* the node has been lifted out. */
-export function moveNode(
-  items: readonly ITreeNode[],
-  id: string,
-  parentId: string | null,
-  index: number
-): ITreeNode[] {
-  // Dropping into the node's own subtree would orphan it — refuse.
-  if (parentId !== null && containsNode(items, id, parentId)) return [...items]
-  let moved: ITreeNode | null = null
-  const strip = (nodes: readonly ITreeNode[]): ITreeNode[] =>
-    nodes.flatMap((node) => {
-      if (node.id === id) {
-        moved = node
-        return []
-      }
-      return node.children
-        ? [{ ...node, children: strip(node.children) }]
-        : [node]
-    })
-  const stripped = strip(items)
-  if (!moved) return [...items]
-  const captured = moved as ITreeNode
-
-  if (parentId === null) {
-    const next = [...stripped]
-    next.splice(Math.min(index, next.length), 0, captured)
-    return next
-  }
-  const insert = (nodes: readonly ITreeNode[]): ITreeNode[] =>
-    nodes.map((node) => {
-      if (node.id === parentId) {
-        const children = [...(node.children ?? [])]
-        children.splice(Math.min(index, children.length), 0, captured)
-        return { ...node, children }
-      }
-      return node.children ? { ...node, children: insert(node.children) } : node
-    })
-  return insert(stripped)
-}

package/src/components/composed/types.ts

@@ -1,9 +0,0 @@
-export type TSocialProvider = "google" | "apple" | "github" | "x"
-
-
-export type * from "./action-bar/types"
-export type * from "./ai/types"
-export type * from "./chat/flowchart/types"
-export type * from "./chat/recommendation/types"
-export type * from "./user/types"
-export type * from "./verse/types"

package/src/components/composed/user/__tests__/message.test.tsx

@@ -1,79 +0,0 @@
-import { describe, expect, test } from "bun:test"
-import { render, screen } from "@testing-library/react"
-import User from "../index"
-import { Attachment } from "@/components/composed/chat/attachment"
-
-describe("User.Message", () => {
-  test("uses the user's direction and identity for the whole message", () => {
-    const { container } = render(
-      <User.Message
-        variant="info"
-        user={{
-          firstName: "Marcus",
-          lastName: "Lee",
-          role: "Reviewer",
-          direction: "recipient",
-          description: "10 min ago",
-        }}
-      >
-        Compare the passage.
-      </User.Message>
-    )
-    expect(
-      container
-        .querySelector('[data-slot="bubble"]')
-        ?.getAttribute("data-variant")
-    ).toBe("recipient")
-    expect(screen.getByText("Marcus Lee")).toBeDefined()
-    expect(screen.getByText("Reviewer")).toBeDefined()
-    expect(screen.getByText("10 min ago")).toBeDefined()
-    expect(
-      screen
-        .getByText("Compare the passage.")
-        .closest('[data-slot="bubble-message"]')
-    ).not.toBeNull()
-  })
-
-  test("continued messages omit the identity and keep reactions outside the surface", () => {
-    const { container } = render(
-      <User.Message
-        variant="info"
-        continued
-        user={{ firstName: "Jenny", direction: "sender" }}
-        reactions={{ reactions: [{ emoji: "❤️", label: "heart", count: 1 }] }}
-      >
-        A follow-up.
-      </User.Message>
-    )
-    expect(container.querySelector('[data-slot="bubble-header"]')).toBeNull()
-    expect(
-      container
-        .querySelector('[data-slot="bubble"]')
-        ?.hasAttribute("data-continued")
-    ).toBe(true)
-    expect(
-      screen
-        .getByRole("button", { name: "heart" })
-        .closest('[data-slot="bubble-message"]')
-    ).toBeNull()
-  })
-
-  test("attachment-only user messages retain the bare attachment surface", () => {
-    const { container } = render(
-      <User.Message
-        variant="info"
-        user={{ firstName: "Jenny", direction: "sender" }}
-      >
-        <Attachment kind="image" title="scan.jpg" src="/scan.jpg" />
-      </User.Message>
-    )
-    expect(
-      container
-        .querySelector('[data-slot="bubble-message"]')
-        ?.hasAttribute("data-unstyled")
-    ).toBe(true)
-    expect(
-      container.querySelector('[data-slot="preview-card-trigger"]')
-    ).not.toBeNull()
-  })
-})

package/src/components/composed/user/index.ts

@@ -1,14 +0,0 @@
-import { Info } from "./info"
-import { Message } from "./message"
-import { Pill } from "./pill"
-import type { TUserInfoProps, TUserPillProps } from "./types"
-
-const User = {
-  Info,
-  Message,
-  Pill,
-}
-
-export type { TUserInfoProps, TUserPillProps }
-
-export default User

package/src/components/composed/user/info.tsx

@@ -1,56 +0,0 @@
-import { Avatar } from "@/components/atoms"
-import { Badge } from "@/components/ui/badge"
-import type { TUserInfoProps } from "./types"
-import { cn } from "@/lib/utils"
-
-/**
- * This component displays a user's information in a compact format.
- * that can be used to display a user's name and role,
- * in the chat bubble header or sidebar profile.
- * @param {TUserInfoProps['user']} user - The user to display.
- * @param {TUserInfoProps['description']} description - The description to display.
- *
- * @description Displays a user's name and role in a compact format.
- *
- */
-export function Info({
-  user,
-  description,
-  direction = "sender",
-  audio,
-  size,
-}: TUserInfoProps) {
-  return (
-    <div
-      slot="info"
-      className={cn("gap-1.5 flex flex-row items-center", {
-        "flex-row-reverse": direction === "sender",
-      })}
-    >
-      <Avatar size={size ?? "default"} user={user} audio={audio} />
-      <div
-        className={cn("flex flex-col", {
-          "items-end text-right": direction === "sender",
-        })}
-      >
-        <div
-          className={cn("gap-1.5 flex flex-row items-center", {
-            "flex-row-reverse": direction === "sender",
-          })}
-        >
-          <span className="text-sm font-semibold">
-            {user.firstName} {user.lastName}
-          </span>
-          {user.role && (
-            <Badge variant="invert" size="xs">
-              {user.role}
-            </Badge>
-          )}
-        </div>
-        {description && (
-          <span className="text-xs text-muted-foreground">{description}</span>
-        )}
-      </div>
-    </div>
-  )
-}

package/src/components/composed/user/message.tsx

@@ -1,36 +0,0 @@
-"use client"
-
-import { Bubble } from "@/components/atoms"
-import { Info } from "./info"
-import type { IUserMessageProps } from "./types"
-
-export function Message({
-  children,
-  user,
-  size,
-  continued = false,
-  className,
-  reactions,
-  actions,
-}: IUserMessageProps) {
-  const direction = user?.direction ?? "sender"
-  return (
-    <Bubble variant={direction} continued={continued} className={className}>
-      {user && !continued && (
-        <Bubble.Header>
-          <Info
-            direction={direction}
-            user={user}
-            description={user.description}
-            audio={user.audio}
-            size={size ?? user.size}
-            variant="info"
-          />
-        </Bubble.Header>
-      )}
-      <Bubble.Message>{children}</Bubble.Message>
-      {reactions && <Bubble.Reactions {...reactions} />}
-      {actions}
-    </Bubble>
-  )
-}

package/src/components/composed/user/pill.tsx

@@ -1,20 +0,0 @@
-import { Avatar } from "@/components/atoms"
-import type { TUserPillProps } from "./types"
-import { Button } from "@/components/ui/button"
-
-/**
- * This component displays a user's information in a compact format.
- * that can be used to display a user's name and role,
- * in the chat bubble header or sidebar profile.
- * @param {TUserPillProps['user']} user - The user to display.
- * @description Displays a user's name and role in a compact format.
- *
- */
-export function Pill({ user }: TUserPillProps) {
-  return (
-    <Button size="sm" className="gap-1 rounded-full pl-0.5">
-      <Avatar user={user} size="sm" />
-      <span className="text-xs">@{user.firstName}</span>
-    </Button>
-  )
-}

package/src/components/composed/user/types.ts

@@ -1,47 +0,0 @@
-import type { TUserType, IAvatarProps } from "@/components/atoms/types"
-import type {
-  IBubbleReactionsProps,
-  TBubbleVariant,
-} from "@/components/atoms/bubble"
-import type React from "react"
-
-export type TUserInfo<T extends TUserType> = T & {
-  description?: string
-  audio?: IAvatarProps<T>["audio"]
-  size?: IAvatarProps<T>["size"]
-  direction?: Exclude<TBubbleVariant, "ai">
-}
-
-export type TUserVariant = "pill" | "info"
-
-export interface IUserBaseProps<
-  T extends TUserType,
-  Variant extends TUserVariant = TUserVariant,
-> {
-  user: T
-  variant: Variant
-}
-
-export interface IUserMessageProps<
-  T extends TUserType = TUserType,
-> extends Omit<IUserBaseProps<T>, "user"> {
-  children: React.ReactNode
-  size?: IAvatarProps<T>["size"]
-  user?: TUserInfo<T>
-  continued?: boolean
-  className?: string
-  /** Reaction controls rendered beside the message, outside its surface. */
-  reactions?: IBubbleReactionsProps
-  /** Optional message actions, typically composed with Bubble.Actions. */
-  actions?: React.ReactNode
-}
-
-export type TUserInfoProps<T extends TUserType = TUserType> = Exclude<
-  IUserBaseProps<T, "info">,
-  "variant"
-> &
-  TUserInfo<T>
-export type TUserPillProps<T extends TUserType = TUserType> = Exclude<
-  IUserBaseProps<T, "pill">,
-  "variant" | "size"
->

package/src/components/composed/verse/__tests__/verse.test.tsx

@@ -1,57 +0,0 @@
-import { describe, expect, test } from "bun:test"
-import { render, screen } from "@testing-library/react"
-import userEvent from "@testing-library/user-event"
-import { Verse, VerseNote, VerseSpan } from "../verse"
-
-function DemoVerse() {
-  return (
-    <Verse
-      chapter="1:1"
-      chapterPopover={<p>Chapter body</p>}
-      href="#gen-1"
-      size="small"
-    >
-      In the beginning{" "}
-      <VerseSpan popover={<p>Span body</p>}>God created</VerseSpan> the earth
-      <VerseNote popover={<p>Note body</p>}>a</VerseNote>.
-    </Verse>
-  )
-}
-
-describe("verse", () => {
-  test("renders the chapter as a link and the note as a subscript", () => {
-    render(<DemoVerse />)
-
-    const chapter = screen.getByText("1:1")
-    expect(chapter.tagName).toBe("A")
-    expect(chapter.getAttribute("href")).toBe("#gen-1")
-    expect(screen.getByText("a").tagName).toBe("SUB")
-    expect(screen.getByText(/the earth/).closest("[data-verse]")).toBeTruthy()
-  })
-
-  test("chapter, span and note each open their own popover on click", async () => {
-    const user = userEvent.setup()
-    render(<DemoVerse />)
-
-    await user.click(screen.getByText("1:1"))
-    expect(await screen.findByText("Chapter body")).toBeTruthy()
-
-    await user.click(screen.getByText("God created"))
-    expect(await screen.findByText("Span body")).toBeTruthy()
-
-    await user.click(screen.getByText("a"))
-    expect(await screen.findByText("Note body")).toBeTruthy()
-  })
-
-  test("a chapter without a popover renders a plain link", () => {
-    render(
-      <Verse chapter="2:4" href="#gen-2">
-        A generations heading.
-      </Verse>
-    )
-
-    const chapter = screen.getByText("2:4")
-    expect(chapter.tagName).toBe("A")
-    expect(chapter.getAttribute("role")).toBeNull()
-  })
-})

package/src/components/composed/verse/index.ts

@@ -1,2 +0,0 @@
-export { Verse, VerseNote, VerseSpan } from "./verse"
-export type { TVerseNoteProps, IVerseProps, TVerseSpanProps } from "./types"

package/src/components/composed/verse/types.ts

@@ -1,24 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react"
-import type { TTextSize } from "../../atoms/text/types"
-import type { ITextClickPopoverProps } from "../../atoms/text-selection/types"
-
-export interface IVerseProps extends Omit<
-  HTMLAttributes<HTMLElement>,
-  "children"
-> {
-  children?: ReactNode
-  className?: string
-  /** Chapter reference rendered as a leading link, e.g. "3:16". */
-  chapter?: ReactNode
-  /** Destination of the chapter link. */
-  href?: string
-  /** Popover content opened by clicking the chapter link. */
-  chapterPopover?: ITextClickPopoverProps["popover"]
-  renderChapterPopover?: ITextClickPopoverProps["renderPopover"]
-  /** Type scale shared with nested verse spans and notes. */
-  size?: TTextSize
-}
-
-export type TVerseSpanProps = Omit<ITextClickPopoverProps, "type">
-
-export type TVerseNoteProps = Omit<ITextClickPopoverProps, "type">

package/src/components/composed/verse/verse.tsx

@@ -1,100 +0,0 @@
-"use client"
-
-import { createContext, useContext } from "react"
-import type { ReactElement } from "react"
-import { cn } from "@/lib/utils"
-import { Text } from "../../atoms/text/default"
-import { TextClickPopover } from "../../atoms/text-selection/click-popover"
-import type { TTextSize } from "../../atoms/text/types"
-import type { TVerseNoteProps, IVerseProps, TVerseSpanProps } from "./types"
-
-const VerseSizeContext = createContext<TTextSize | undefined>(undefined)
-
-const chapterClassName =
-  "mr-1.5 align-super text-[0.7em] font-medium no-underline hover:underline"
-
-export function Verse({
-  chapter,
-  chapterPopover,
-  children,
-  className,
-  href,
-  renderChapterPopover,
-  size = "medium",
-  ...props
-}: IVerseProps): ReactElement {
-  const hasChapterPopover =
-    renderChapterPopover !== undefined ||
-    (chapterPopover !== undefined && chapterPopover !== null)
-
-  return (
-    <VerseSizeContext.Provider value={size}>
-      <Text
-        {...props}
-        className={className}
-        data-verse=""
-        size={size}
-        type="paragraph"
-      >
-        {chapter !== undefined && chapter !== null ? (
-          hasChapterPopover ? (
-            <TextClickPopover
-              className={chapterClassName}
-              href={href}
-              popover={chapterPopover}
-              renderPopover={renderChapterPopover}
-              size={size}
-              type="link"
-            >
-              {chapter}
-            </TextClickPopover>
-          ) : (
-            <Text
-              className={chapterClassName}
-              href={href}
-              size={size}
-              type="link"
-            >
-              {chapter}
-            </Text>
-          )
-        ) : null}
-        {children}
-      </Text>
-    </VerseSizeContext.Provider>
-  )
-}
-
-export function VerseSpan({
-  className,
-  size,
-  ...props
-}: TVerseSpanProps): ReactElement {
-  const verseSize = useContext(VerseSizeContext)
-  return (
-    <TextClickPopover
-      {...props}
-      className={cn(
-        "underline decoration-muted-foreground/50 decoration-dotted underline-offset-4",
-        className
-      )}
-      size={size ?? verseSize}
-    />
-  )
-}
-
-export function VerseNote({
-  className,
-  size,
-  ...props
-}: TVerseNoteProps): ReactElement {
-  const verseSize = useContext(VerseSizeContext)
-  return (
-    <TextClickPopover
-      {...props}
-      className={cn("mx-0.5 text-[0.75em]", className)}
-      size={size ?? verseSize}
-      type="subscript"
-    />
-  )
-}