@exegia/corpora-ui 3.0.0 → 3.1.0

package/src/components/composed/tree/tree-node.tsx

@@ -1,496 +0,0 @@
-"use client"
-
-import { LucideChevronLeft, LucideChevronRight } from "lucide-react"
-import { AnimatePresence, motion, useReducedMotion } from "motion/react"
-import * as React from "react"
-import { useAtomValue, useSetAtom } from "jotai"
-
-import { cn } from "@/lib/utils"
-import {
-  Tooltip,
-  TooltipContent,
-  TooltipTrigger,
-} from "@/components/ui/tooltip"
-import {
-  TREE_BRANCH_EXIT,
-  TREE_BRANCH_VARIANTS,
-  TREE_COLLAPSE_DURATION,
-  TREE_LABEL_REVEAL_DELAY,
-  TREE_MICRO_TRANSITION,
-  TREE_ROW_VARIANTS,
-} from "./constants"
-import {
-  cancelTreeRenameAtom,
-  renameTreeNodeAtom,
-  selectTreeNodeAtom,
-  startTreeRenameAtom,
-  toggleTreeNodeAtom,
-  treeCanRenameAtom,
-  treeCollapsedAtom,
-  treeNodeActiveAtom,
-  treeNodeDraggingAtom,
-  treeNodeDropAtom,
-  treeNodeExpandedAtom,
-  treeNodeRenamingAtom,
-  treeSectionedAtom,
-  treeSoundAtom,
-  treeVariantAtom,
-} from "./tree-atom"
-import { useTreeContext } from "./tree-context"
-import type { ITreeNode } from "./type"
-import { EASE_OUT } from "@/lib/ease.ts"
-import { Button } from "@/components/ui/button"
-
-/** How a row behaves, resolved from variant + depth + shape. */
-type TRowKind =
-  | "section" // navigation depth 0 with 3-level data — heading, toggles
-  | "toggle" // expands/collapses on row press (nav parents, files folders)
-  | "link" // navigates; may still carry a chevron that toggles separately
-export interface ITreeRowProps {
-  node: ITreeNode
-  depth: number
-}
-
-function rowKindOf(
-  node: ITreeNode,
-  depth: number,
-  variant: string,
-  sectioned: boolean
-): TRowKind {
-  if (variant === "sidebar") return "link"
-  const branch =
-    variant === "files" ? node.children !== undefined : !!node.children?.length
-  if (!branch) return "link"
-  if (variant === "navigation")
-    return sectioned && depth === 0 ? "section" : "toggle"
-  // toc parents navigate — their chevron is a separate toggle.
-  return variant === "toc" ? "link" : "toggle"
-}
-
-function TreeRowImpl({ node, depth }: ITreeRowProps): React.ReactElement {
-  const { treeId, renderTrailing, dnd } = useTreeContext()
-  const reduce = useReducedMotion()
-
-  // One subscription per field, per node. A row re-renders when its own
-  // branch, selection, rename or drag state changes and sits still while a
-  // sibling's does — reading the whole controller off context instead
-  // re-rendered every row in the tree on every toggle.
-  const variant = useAtomValue(treeVariantAtom(treeId))
-  const sectioned = useAtomValue(treeSectionedAtom(treeId))
-  const collapsed = useAtomValue(treeCollapsedAtom(treeId))
-  const canRename = useAtomValue(treeCanRenameAtom(treeId))
-  const sound = useAtomValue(treeSoundAtom(treeId))
-  const open = useAtomValue(treeNodeExpandedAtom(treeId, node.id))
-  const active = useAtomValue(treeNodeActiveAtom(treeId, node.id))
-  const renaming = useAtomValue(treeNodeRenamingAtom(treeId, node.id))
-  const dragging = useAtomValue(treeNodeDraggingAtom(treeId, node.id))
-  const drop = useAtomValue(treeNodeDropAtom(treeId, node.id))
-
-  const select = useSetAtom(selectTreeNodeAtom(treeId))
-  const toggleExpanded = useSetAtom(toggleTreeNodeAtom(treeId))
-  const startRename = useSetAtom(startTreeRenameAtom(treeId))
-  const cancelRename = useSetAtom(cancelTreeRenameAtom(treeId))
-  const rename = useSetAtom(renameTreeNodeAtom(treeId))
-
-  const kind = rowKindOf(node, depth, variant, sectioned)
-
-  // The sidebar rail is single-level by contract — nested children are
-  // ignored rather than rendered somewhere misleading.
-  const children = variant === "sidebar" ? [] : (node.children ?? [])
-  const canExpand =
-    kind !== "link" || (variant === "toc" && children.length > 0)
-
-  const files = variant === "files"
-
-  // toc rows below the route level are in-page anchors: they scroll to the
-  // heading sharing their id (an explicit `#hash` href wins). Rows are
-  // buttons, so the anchor default is reproduced by setting location.hash
-  // after `select` — the same order the old <a> gave (handlers first, then
-  // the browser's jump), with the same :target/history semantics.
-  const anchorHash =
-    variant === "toc" && kind === "link" && !node.disabled
-      ? node.href?.startsWith("#")
-        ? node.href
-        : depth > 0 && !node.href
-          ? `#${node.id}`
-          : undefined
-      : undefined
-
-  function handlePress(event: React.MouseEvent) {
-    if (node.disabled) {
-      event.preventDefault()
-      return
-    }
-    if (kind === "link") {
-      select(node.id)
-      if (anchorHash !== undefined && typeof window !== "undefined") {
-        window.location.hash = anchorHash
-      }
-      return
-    }
-    toggleExpanded(node.id)
-  }
-
-  function handleStartRename(event: React.MouseEvent) {
-    if (!canRename || node.disabled) return
-    event.preventDefault()
-    startRename(node.id)
-  }
-
-  const label = renaming ? (
-    <input
-      autoFocus
-      className={cn(
-        "h-5 min-w-0 flex-1 rounded-sm border-none bg-transparent px-1",
-        "text-[length:inherit] text-foreground outline-none focus-visible:ring-0"
-      )}
-      data-slot="tree-rename-input"
-      defaultValue={node.label}
-      onBlur={(event) => rename(node.id, event.currentTarget.value)}
-      onClick={(event) => event.stopPropagation()}
-      onKeyDown={(event) => {
-        event.stopPropagation()
-        if (event.key === "Enter") rename(node.id, event.currentTarget.value)
-        if (event.key === "Escape") cancelRename()
-      }}
-    />
-  ) : variant === "sidebar" ? (
-    // The rail label folds away with the rail instead of unmounting rows.
-    <AnimatePresence initial={false} mode="wait">
-      <motion.span
-        initial={{ width: 0, opacity: 0, x: -8 }}
-        animate={{
-          width: collapsed ? 0 : "auto",
-          opacity: collapsed ? 0 : 1,
-          x: collapsed ? -8 : 0,
-          display: collapsed ? "none" : "flex",
-          transition: reduce
-            ? { duration: 0 }
-            : {
-                width: {
-                  delay: TREE_LABEL_REVEAL_DELAY,
-                  duration: TREE_COLLAPSE_DURATION,
-                  ease: "easeInOut",
-                },
-                opacity: {
-                  delay: TREE_LABEL_REVEAL_DELAY,
-                  duration: TREE_COLLAPSE_DURATION,
-                  ease: "easeInOut",
-                },
-                x: {
-                  duration: TREE_COLLAPSE_DURATION,
-                  ease: "easeInOut",
-                },
-              },
-        }}
-        exit={{
-          width: 0,
-          opacity: 0,
-          display: "none",
-          x: -8,
-          transition: reduce
-            ? { duration: 0 }
-            : {
-                display: {
-                  duration: TREE_COLLAPSE_DURATION,
-                  ease: "easeOut",
-                },
-                width: {
-                  duration: TREE_COLLAPSE_DURATION * 3,
-                  ease: EASE_OUT,
-                },
-                opacity: {
-                  duration: TREE_COLLAPSE_DURATION,
-                  ease: "easeOut",
-                },
-                x: {
-                  duration: TREE_COLLAPSE_DURATION * 3,
-                  ease: EASE_OUT,
-                },
-              },
-        }}
-        className={cn("min-w-0 overflow-clip whitespace-nowrap")}
-        data-slot="tree-row-label"
-      >
-        {node.label}
-      </motion.span>
-    </AnimatePresence>
-  ) : (
-    <span
-      className="min-w-0 flex-1 truncate"
-      onDoubleClick={canRename ? handleStartRename : undefined}
-    >
-      {node.label}
-    </span>
-  )
-
-  const chevron = canExpand ? (
-    <motion.span
-      animate={{ rotate: open ? (variant === "navigation" ? -90 : 90) : 0 }}
-      aria-hidden
-      className="flex size-4 shrink-0 items-center justify-center text-muted-foreground/70"
-      transition={reduce ? { duration: 0 } : TREE_MICRO_TRANSITION}
-    >
-      {variant === "sidebar" && (
-        <LucideChevronLeft className="size-3.5 stroke-3" />
-      )}
-      {variant === "toc" && (
-        <LucideChevronRight className="size-3.5 stroke-3" />
-      )}
-      {variant === "navigation" && (
-        <LucideChevronLeft className="size-3.5 stroke-3" />
-      )}
-    </motion.span>
-  ) : null
-
-  // The trailing slot is consumer-rendered and usually holds buttons, so it
-  // cannot live inside the row — every row is itself a <button>, and a
-  // button nesting a button is invalid HTML. It sits beside the row
-  // instead, overlaid like the toc toggle.
-  const showTrailing = files && !!renderTrailing && !renaming
-
-  const rowClassName = cn(
-    "group/row relative flex w-full min-w-0 cursor-pointer items-center gap-2 rounded-md px-2",
-    "text-left text-muted-foreground transition-colors duration-150 outline-none",
-    "hover:bg-accent hover:text-accent-foreground",
-    "focus-visible:ring-2 focus-visible:ring-ring",
-    files ? "h-7 text-[0.8125rem]" : "h-8 text-sm",
-    node.disabled && "pointer-events-none opacity-50",
-    active && "bg-accent font-medium text-accent-foreground",
-    dragging && "opacity-50",
-    drop === "inside" && "bg-accent/60 ring-1 ring-primary/50 ring-inset",
-    variant === "sidebar" && collapsed && "justify-center px-0",
-    // Room for the overlay expand toggle on toc parent rows.
-    variant === "toc" && kind === "link" && children.length > 0 && "pr-7",
-    // …and for the overlay trailing actions on files rows. Sized for one
-    // icon button plus its inset; a wider slot clips the truncated label,
-    // which is why the prop is documented as row actions, not free content.
-    showTrailing && "pr-9"
-  )
-
-  const rowInteractionProps = {
-    "data-slot": "tree-row" as const,
-    "data-id": node.id,
-    "data-branch": canExpand ? "" : undefined,
-    "data-expanded": canExpand && open ? "" : undefined,
-    "data-active": active ? "" : undefined,
-    "data-cuelume-press": sound ? "" : undefined,
-    draggable: dnd.enabled && !renaming ? true : undefined,
-    onDragStart: dnd.enabled
-      ? (event: React.DragEvent) => dnd.onRowDragStart(event, node.id)
-      : undefined,
-    onDragOver: dnd.enabled
-      ? (event: React.DragEvent) => dnd.onRowDragOver(event, node)
-      : undefined,
-    onDragLeave: dnd.enabled ? dnd.onRowDragLeave : undefined,
-    onDrop: dnd.enabled
-      ? (event: React.DragEvent) => dnd.onRowDrop(event, node)
-      : undefined,
-    onDragEnd: dnd.enabled ? dnd.onRowDragEnd : undefined,
-  }
-
-  const content = (
-    <>
-      {kind !== "section" && files && chevron}
-      {kind !== "section" && node.icon && (
-        <span
-          className={cn(
-            "flex size-4 shrink-0 items-center justify-center transition-[width,height,color] duration-150 [&>svg]:size-4",
-            // Folded rail: the icon is the whole row, so it steps up a size
-            // and takes the foreground colour instead of muted.
-            variant === "sidebar" &&
-              collapsed &&
-              "size-5 text-foreground [&>svg]:size-5",
-            active && "text-accent-foreground"
-          )}
-          data-slot="tree-row-icon"
-        >
-          {node.icon}
-        </span>
-      )}
-      {label}
-      {node.badge !== undefined && !(variant === "sidebar" && collapsed) && (
-        <span className="ml-auto shrink-0 text-xs text-muted-foreground/80">
-          {node.badge}
-        </span>
-      )}
-      {/* nav toggle chevrons trail like the sidebar block; files lead;
-          toc link rows get a separate overlay toggle instead. */}
-      {kind === "toggle" && !files && (
-        <span
-          className={cn(
-            node.badge === undefined ? "ml-auto" : "ml-1",
-            "flex shrink-0"
-          )}
-        >
-          {chevron}
-        </span>
-      )}
-    </>
-  )
-
-  let row: React.ReactElement
-  if (kind === "section") {
-    row = (
-      <button
-        {...rowInteractionProps}
-        aria-expanded={open}
-        className={cn(
-          "group/row flex w-full cursor-pointer items-center gap-1 rounded-md px-2 py-1",
-          "text-xs font-medium tracking-wide text-muted-foreground/80 uppercase",
-          "transition-colors duration-150 outline-none hover:text-foreground",
-          "focus-visible:ring-0 focus-visible:ring-ring"
-        )}
-        onClick={handlePress}
-        type="button"
-      >
-        <span className="truncate">{node.label}</span>
-        {chevron}
-      </button>
-    )
-  } else {
-    // Every non-section row is the shared Button — link rows included. An
-    // `href` no longer renders an anchor: navigation runs through
-    // `selectTreeNodeAtom` (onSelect → onNavigate), and the consumer routes
-    // from the node it receives. `sound` is forwarded so Button's own
-    // press/release cues follow the tree's setting rather than its default.
-    row = (
-      <Button
-        {...rowInteractionProps}
-        variant={variant === "sidebar" && active ? "secondary" : "ghost"}
-        aria-current={active ? "page" : undefined}
-        aria-expanded={kind === "toggle" ? open : undefined}
-        aria-label={variant === "sidebar" && collapsed ? node.label : undefined}
-        className={cn(
-          "transform cursor-pointer! justify-start transition-transform ease-smooth-out",
-          variant === "sidebar" && collapsed ? "h-10! rounded-md!" : undefined,
-          rowClassName
-        )}
-        disabled={node.disabled}
-        onClick={handlePress}
-        sound={sound}
-      >
-        {content}
-      </Button>
-    )
-  }
-
-  // A collapsed rail row is icon-only — a tooltip names it on hover/focus.
-  // Expanded, the visible label already does, so the tooltip is disabled
-  // rather than unmounted: swapping the wrapper in and out with `collapsed`
-  // would remount the row and cut the label's fold animation short.
-  if (variant === "sidebar") {
-    row = (
-      <Tooltip disabled={!collapsed || node.disabled}>
-        <TooltipTrigger render={row} />
-        <TooltipContent side="right">{node.label}</TooltipContent>
-      </Tooltip>
-    )
-  }
-
-  // toc parents navigate on the row itself, so their chevron lives beside
-  // the row as its own toggle.
-  const tocToggle =
-    variant === "toc" && kind === "link" && children.length > 0 ? (
-      <button
-        aria-expanded={open}
-        aria-label={`${open ? "Collapse" : "Expand"} ${node.label}`}
-        className={cn(
-          "absolute top-1/2 right-1 flex size-5 -translate-y-1/2 cursor-pointer items-center",
-          "justify-center rounded-sm text-muted-foreground/70 outline-none",
-          "hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
-        )}
-        onClick={(event) => {
-          event.stopPropagation()
-          toggleExpanded(node.id)
-        }}
-        type="button"
-      >
-        {chevron}
-      </button>
-    ) : null
-
-  // Revealed by hovering/focusing anywhere in the row wrapper — the row and
-  // the actions are siblings now, so the trigger group lives on the wrapper.
-  const trailing = showTrailing ? (
-    <span
-      className={cn(
-        "absolute top-1/2 right-1 flex -translate-y-1/2 items-center",
-        "opacity-0 transition-opacity duration-150",
-        "group-focus-within/row-actions:opacity-100 group-hover/row-actions:opacity-100",
-        node.disabled && "pointer-events-none opacity-50"
-      )}
-      data-slot="tree-trailing"
-    >
-      {renderTrailing?.(node)}
-    </span>
-  ) : null
-
-  const branchClassName =
-    kind === "section"
-      ? "flex flex-col gap-0.5 overflow-clip"
-      : cn(
-          "flex flex-col overflow-clip border-l border-border",
-          files ? "mt-0.5 ml-3 gap-px pl-1.5" : "mt-1 ml-4 gap-0.5 pl-2.5"
-        )
-
-  return (
-    <motion.li
-      aria-expanded={canExpand ? open : undefined}
-      aria-level={depth + 1}
-      aria-selected={active || undefined}
-      className="relative flex min-w-0 flex-col"
-      data-slot="tree-item"
-      role="treeitem"
-      variants={reduce ? undefined : TREE_ROW_VARIANTS}
-    >
-      {drop === "before" && <TreeDropLine side="top" />}
-      <div className={cn("relative", showTrailing && "group/row-actions")}>
-        {row}
-        {tocToggle}
-        {trailing}
-      </div>
-      {canExpand && children.length > 0 && (
-        <AnimatePresence initial={false}>
-          {open && (
-            <motion.ul
-              animate={reduce ? { opacity: 1 } : "open"}
-              className={branchClassName}
-              exit={reduce ? { opacity: 0 } : TREE_BRANCH_EXIT}
-              initial={reduce ? { opacity: 0 } : "closed"}
-              key="branch"
-              role="group"
-              transition={reduce ? { duration: 0.12 } : undefined}
-              variants={reduce ? undefined : TREE_BRANCH_VARIANTS}
-            >
-              {children.map((child) => (
-                <TreeRow depth={depth + 1} key={child.id} node={child} />
-              ))}
-            </motion.ul>
-          )}
-        </AnimatePresence>
-      )}
-      {drop === "after" && <TreeDropLine side="bottom" />}
-    </motion.li>
-  )
-}
-
-/** Rows are memoized so a re-render of the root — a rail measurement, a new
- * `renderTrailing` — does not walk the whole tree. Each row's own state
- * reaches it through its atoms instead. */
-export const TreeRow = React.memo(TreeRowImpl)
-TreeRow.displayName = "TreeRow"
-
-/** Insertion indicator above or below a row while a drag hovers it. */
-function TreeDropLine({ side }: { side: "top" | "bottom" }) {
-  return (
-    <span
-      aria-hidden
-      className={cn(
-        "pointer-events-none absolute inset-x-1 z-10 h-0.5 rounded-full bg-primary",
-        side === "top" ? "top-0 -translate-y-1/2" : "bottom-0 translate-y-1/2"
-      )}
-      data-slot="tree-drop-indicator"
-    />
-  )
-}