@exegia/corpora-ui 1.0.0 → 2.0.0

package/src/components/docs/blocks-gallery.tsx

@@ -0,0 +1,224 @@
+"use client"
+
+import { LoginBlock } from "@/components/blocks/auth/login-block"
+import { SignupBlock } from "@/components/blocks/auth/signup-block"
+import { ForgotPasswordBlock } from "@/components/blocks/auth/forgot-password-block"
+import { CodeAuthBlock } from "@/components/blocks/auth/code-auth-block"
+import { UpdatePasswordBlock } from "@/components/blocks/auth/update-password-block"
+import { PasskeySignInBlock } from "@/components/blocks/auth/passkey-sign-in-block"
+import { PasskeyManagerBlock } from "@/components/blocks/auth/passkey-manager-block"
+import { LinkedAccountsBlock } from "@/components/blocks/auth/linked-accounts-block"
+import { OnboardingBlock } from "@/components/blocks/auth/onboarding-block"
+import { AuthFlowBlock } from "@/components/blocks/auth/auth-flow-block"
+import { ProfileCardBlock } from "@/components/blocks/profile/profile-card-block"
+import { ShellLayout } from "@/components/blocks/shell/shell-layout"
+import { Scaffold } from "@/components/blocks/scaffold"
+import { AiPanel } from "@/components/blocks/chat/base"
+import { GalleryTile } from "./atoms-gallery"
+
+const blocks = [
+  {
+    slug: "login",
+    name: "Login",
+    blurb: "Progressive sign-in with social providers",
+    preview: <LoginBlock />,
+  },
+  {
+    slug: "signup",
+    name: "Signup",
+    blurb: "Account creation, password strength and consent",
+    preview: <SignupBlock />,
+  },
+  {
+    slug: "forgot-password",
+    name: "Forgot password",
+    blurb: "Reset requests and inbox confirmation",
+    preview: <ForgotPasswordBlock />,
+  },
+  {
+    slug: "code-auth",
+    name: "Code authentication",
+    blurb: "Email and SMS verification with resend controls",
+    preview: <CodeAuthBlock channel="email" destination="r•••@example.com" />,
+  },
+  {
+    slug: "update-password",
+    name: "Update password",
+    blurb: "Progressive password change with validation",
+    preview: <UpdatePasswordBlock />,
+  },
+  {
+    slug: "passkey-sign-in",
+    name: "Passkey sign-in",
+    blurb: "Passwordless entry with availability handling",
+    preview: <PasskeySignInBlock available />,
+  },
+  {
+    slug: "passkey-manager",
+    name: "Passkey manager",
+    blurb: "Manage registered devices and credentials",
+    preview: (
+      <PasskeyManagerBlock
+        available
+        passkeys={[{ id: "gallery-laptop", name: "Research laptop" }]}
+      />
+    ),
+  },
+  {
+    slug: "linked-accounts",
+    name: "Linked accounts",
+    blurb: "Manage connected sign-in identities",
+    preview: (
+      <LinkedAccountsBlock
+        identities={[
+          {
+            id: "gallery-github",
+            provider: "github",
+            email: "researcher@example.com",
+          },
+        ]}
+      />
+    ),
+  },
+  {
+    slug: "onboarding",
+    name: "Onboarding",
+    blurb: "Guided profile setup with step validation",
+    preview: <OnboardingBlock autoFocus={false} />,
+  },
+  {
+    slug: "auth-flow",
+    name: "Auth flow",
+    blurb: "Connected login, verification and account setup",
+    preview: <AuthFlowBlock flowId="docs-blocks-gallery" />,
+  },
+  {
+    slug: "profile-card",
+    name: "Profile card",
+    blurb: "Account identity and grouped profile actions",
+    preview: (
+      <ProfileCardBlock
+        user={{ name: "Jenny Hamilton", username: "@jennycodes" }}
+        defaultVariant="expanded"
+        sound={false}
+      />
+    ),
+  },
+  {
+    slug: "navbar",
+    name: "Navbar · planned",
+    blurb: "Application navigation with branding and a user menu",
+    preview: (
+      <div className="gap-3 py-12 flex flex-col items-center text-center">
+        <span className="px-3 py-1 text-xs rounded-full border text-muted-foreground">
+          Planned
+        </span>
+        <p className="text-sm text-muted-foreground">
+          This block is not available yet.
+        </p>
+      </div>
+    ),
+  },
+  {
+    slug: "shell",
+    name: "Shell",
+    blurb: "Application frame with collapsible workspace panels",
+    wide: true,
+    preview: (
+      <ShellLayout
+        variant="web"
+        className="h-[24rem] w-full"
+        header="Corpus workspace"
+        panels={{
+          left: {
+            id: "gallery-library",
+            name: "Library",
+            side: "left",
+            open: true,
+            defaultOpen: true,
+            component: (
+              <div className="space-y-4 p-4 text-sm">
+                <p>Library</p>
+                <p>Iliad</p>
+                <p>Odyssey</p>
+                <p>Hesiod</p>
+              </div>
+            ),
+          },
+        }}
+      >
+        <div className="space-y-3 p-6">
+          <h3 className="font-semibold">Iliad · Book I</h3>
+          <p className="text-sm text-muted-foreground">
+            Sing, goddess, the anger of Peleus’ son Achilles.
+          </p>
+        </div>
+      </ShellLayout>
+    ),
+  },
+  {
+    slug: "scaffold",
+    name: "Scaffold",
+    blurb: "Composable workspace panels and inspector",
+    wide: true,
+    preview: (
+      <Scaffold.Root className="h-[24rem] w-full">
+        <Scaffold.Main>
+          <Scaffold.Canvas>
+            <Scaffold.Panel>
+              <div className="space-y-3 p-6">
+                <h3 className="font-semibold">Corpus workspace</h3>
+                <p className="text-sm text-muted-foreground">
+                  Read, annotate and compare passages.
+                </p>
+              </div>
+            </Scaffold.Panel>
+          </Scaffold.Canvas>
+        </Scaffold.Main>
+      </Scaffold.Root>
+    ),
+  },
+  {
+    slug: "chat",
+    name: "Chat",
+    blurb: "Scoped corpus conversations and generated answers",
+    wide: true,
+    preview: (
+      <AiPanel
+        className="h-[28rem] w-full"
+        headerTitle="Context Fabric"
+        scope={{ kind: "passage", label: "Iliad 1.1", range: "¶1–¶2" }}
+        thread={
+          <p className="p-4 text-sm text-muted-foreground">
+            Ask a question about this passage to begin your research.
+          </p>
+        }
+      />
+    ),
+  },
+]
+
+/** The same live gallery tiles used by atoms and composed components. */
+export function BlocksGallery() {
+  return (
+    <div className="not-prose gap-4 md:grid-cols-4 grid grid-cols-1">
+      {blocks.map((block, index) => (
+        <GalleryTile
+          key={block.slug}
+          index={index}
+          href={`/blocks/${block.slug}`}
+          name={block.name}
+          blurb={block.blurb}
+          className={
+            block.wide ? "min-w-0 md:col-span-4" : "min-w-0 md:col-span-2"
+          }
+          stageClassName="min-h-64 px-3 py-6 sm:px-6"
+        >
+          <div className="min-w-0 flex w-full items-center justify-center">
+            {block.preview}
+          </div>
+        </GalleryTile>
+      ))}
+    </div>
+  )
+}

package/src/components/docs/browser.tsx

@@ -0,0 +1,87 @@
+"use client"
+
+import { Globe } from "lucide-react"
+import { cn } from "@/lib/utils"
+import type { ReactNode } from "react"
+import type { ClassNameValue } from "cn"
+
+export type TTitleStyleType = "hidden" | "titlebar" | "expanded"
+
+export interface IBrowserProps {
+  url?: string
+  title?: string
+  className?: string
+  children: ReactNode
+  titleStyle: TTitleStyleType
+}
+
+const titleBarStyle = (
+  style: TTitleStyleType,
+  component: "title" | "frame"
+): ClassNameValue => {
+  const titleBarClassName: Record<TTitleStyleType, ClassNameValue> = {
+    titlebar: "relative",
+    hidden: "top-0 left-0 absolute",
+    expanded: "relative",
+  }
+
+  const bodyClassName: Record<TTitleStyleType, ClassNameValue> = {
+    titlebar: "relative",
+    hidden: "",
+    expanded: "relative",
+  }
+
+  return component == "title" ? titleBarClassName[style] : bodyClassName[style]
+}
+
+export function BrowserFrame({
+  url,
+  title,
+  className,
+  titleStyle,
+  children,
+}: IBrowserProps) {
+  return (
+    <div
+      className={cn(
+        "relative flex size-full items-center justify-center",
+        className
+      )}
+    >
+      <div className="relative flex min-h-32 w-full flex-col overflow-hidden rounded-lg border border-border bg-secondary shadow-lg">
+        <div
+          id="title-bar"
+          className={cn(
+            "z-20 flex flex-1 items-center gap-2 px-4 py-3",
+            titleBarStyle(titleStyle, "title")
+          )}
+        >
+          <div className="flex items-center gap-2" aria-hidden="true">
+            <span className="size-3 cursor-pointer rounded-full bg-rose-500 shadow-md outline outline-rose-800" />
+            <span className="size-3 cursor-pointer rounded-full bg-amber-500 shadow-md outline outline-amber-800" />
+            <span className="size-3 cursor-pointer rounded-full bg-emerald-500 shadow-md outline outline-emerald-800" />
+          </div>
+          {url && !title && (
+            <div className="flex max-w-1/3 flex-1 items-center gap-1.5 rounded-sm border border-border bg-card p-1">
+              <Globe
+                className="size-3 shrink-0 text-muted-foreground"
+                aria-hidden="true"
+              />
+              <span className="truncate font-mono text-xs text-muted-foreground">
+                {url}
+              </span>
+            </div>
+          )}
+          {title && !url && (
+            <div className="flex w-full flex-1 justify-center select-none">
+              <span className="ml-2 text-sm text-foreground">{title}</span>
+            </div>
+          )}
+        </div>
+        <div className={cn("flex flex-1", titleBarStyle(titleStyle, "frame"))}>
+          {children}
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/components/docs/components-gallery.tsx

@@ -0,0 +1,182 @@
+"use client"
+
+import AI from "@/components/composed/ai"
+import { PasswordInput } from "@/components/composed/password-input"
+import { SocialProviders } from "@/components/composed/social-providers"
+import {
+  Chart,
+  ContextCards,
+  RecommendationCard,
+} from "@/components/composed/chat"
+import User from "@/components/composed/user"
+import { Verse } from "@/components/composed/verse"
+
+import { GalleryTile } from "./atoms-gallery"
+
+const COVERAGE = [
+  { label: "Iliad", value: 79 },
+  { label: "Odyssey", value: 72 },
+  { label: "Hesiod", value: 61 },
+]
+
+export function ComponentsGallery() {
+  return (
+    <div className="not-prose gap-4 md:auto-rows-[minmax(11rem,auto)] md:grid-cols-4 grid grid-cols-1">
+      <GalleryTile
+        index={0}
+        href="/composed/research-answer"
+        name="Research answer"
+        blurb="Grounded answers with source metadata and actions"
+        className="md:col-span-2 md:row-span-2"
+      >
+        <div className="flex justify-center">
+          <AI.ResearchAnswer
+            kickerSub="Answered from 3 passages · 0.8 s"
+            content="Apollo’s plague forces an assembly—the first boundary of the poem."
+            source="Iliad · Homer corpus"
+            date="c. 750 BCE"
+            authors="Homer · M. L. West"
+          />
+        </div>
+      </GalleryTile>
+
+      <GalleryTile
+        index={1}
+        href="/composed/password-input"
+        name="Password Input"
+        blurb="Visibility controls and live strength feedback"
+        className="md:col-span-2"
+      >
+        <div className="max-w-sm mx-auto">
+          <PasswordInput
+            aria-label="Example password"
+            defaultValue="Iliad2026"
+            showStrength
+            sound={false}
+          />
+        </div>
+      </GalleryTile>
+
+      <GalleryTile
+        index={2}
+        href="/composed/user"
+        name="User"
+        blurb="Identity rows, roles, presence and mentions"
+      >
+        <div className="flex justify-center">
+          <User.Info
+            description="Corpus editor"
+            user={{
+              firstName: "Jenny",
+              lastName: "Hamilton",
+              role: "Editor",
+              status: "online",
+            }}
+            variant="info"
+          />
+        </div>
+      </GalleryTile>
+
+      <GalleryTile
+        index={3}
+        href="/composed/social-providers"
+        name="Social Providers"
+        blurb="Provider actions in compact or stacked layouts"
+      >
+        <SocialProviders
+          layout="row"
+          providers={["google", "apple", "github"]}
+        />
+      </GalleryTile>
+
+      <GalleryTile
+        index={4}
+        href="/composed/verse"
+        name="Verse"
+        blurb="Corpus text with references and inline annotations"
+        className="md:col-span-2"
+      >
+        <div className="max-w-lg mx-auto text-center">
+          <Verse chapter="1:1" href="/composed/verse" size="large">
+            Sing, goddess, the anger of Peleus&apos; son Achilles.
+          </Verse>
+        </div>
+      </GalleryTile>
+
+      <GalleryTile
+        index={5}
+        href="/composed/chart"
+        name="Chart"
+        blurb="Token-aware corpus data visualizations"
+        className="md:col-span-2"
+      >
+        <div className="flex justify-center">
+          <Chart
+            className="w-full max-w-[360px]"
+            type="bar"
+            title="Lemma coverage"
+            subtitle="Resolved tokens"
+            data={COVERAGE}
+            series={[
+              {
+                key: "value",
+                label: "Coverage",
+                format: (value) => `${value}%`,
+              },
+            ]}
+            plotHeight={100}
+          />
+        </div>
+      </GalleryTile>
+
+      <GalleryTile
+        index={6}
+        href="/composed/recommendation-card"
+        name="Recommendation card"
+        blurb="Human-in-the-loop review with confidence signals"
+        className="md:col-span-2 md:row-span-2"
+        stageClassName="items-start"
+      >
+        <RecommendationCard
+          acceptLabel="Apply fix"
+          confidence="high"
+          description="Change label from paragraph to p on"
+          entity={{ name: "node p-17", initials: "P" }}
+          leadTime="2 min"
+          title="Fix the label mismatch?"
+        />
+      </GalleryTile>
+
+      <GalleryTile
+        index={7}
+        href="/composed/context-cards"
+        name="Context cards"
+        blurb="Retrieved passages with compact source metadata"
+        className="md:col-span-2 md:row-span-2"
+        stageClassName="items-start"
+      >
+        <div className="flex justify-center">
+          <ContextCards
+            count={32}
+            cards={[
+              {
+                title: "Iliad 1.1",
+                meta: "290 characters",
+                snippet: "Sing, goddess, the anger of Achilles.",
+                file: { name: "iliad.txt", type: "TXT" },
+              },
+              {
+                title: "Iliad 1.12",
+                meta: "184 characters",
+                snippet: "Apollo came down from Olympus in anger.",
+                file: { name: "iliad.xml", type: "XML" },
+              },
+            ]}
+          />
+        </div>
+      </GalleryTile>
+    </div>
+  )
+}
+
+export default ComponentsGallery

package/src/components/docs/demo-controls.tsx

@@ -41,7 +41,7 @@ export function DemoSelect<T extends string>({
         value={value}
       >
         <SelectTrigger
-          className="h-7 min-w-0 rounded-sm text-xs capitalize"
+          className="h-7 min-w-0 text-xs rounded-sm capitalize"
           size="sm"
         >
           <SelectValue />
@@ -111,7 +111,7 @@ export function DemoToggle({
   )
 }
 
-/** Standard layout: centered preview canvas above a controls row. */
+/** Standard layout for live examples. */
 export function DemoStage({
   controls,
   children,
@@ -122,18 +122,17 @@ export function DemoStage({
   canvasClassName?: string
 }) {
   return (
-    <div className="relative flex w-full flex-col items-center">
+    <div className="not-prose relative flex w-full flex-col items-center">
       {controls ? (
-        <Card className="absolute top-3 right-3 z-20 min-w-48 rounded-lg shadow-lg">
-          <CardContent className="flex flex-col items-start gap-2">
+        <Card className="top-3 right-3 min-w-48 shadow-lg absolute z-20 rounded-lg">
+          <CardContent className="gap-2 flex flex-col items-start">
             {controls}
           </CardContent>
         </Card>
       ) : null}
       <div
         className={
-          canvasClassName ??
-          "flex min-h-24 w-full items-center justify-center"
+          canvasClassName ?? "min-h-24 flex w-full items-center justify-center"
         }
       >
         {children}

package/src/components/docs/hero.tsx

@@ -9,7 +9,7 @@ import AI from "@/components/composed/ai"
 import {
   Flowchart,
   RecommendationCard,
-  type StepNode,
+  type TStepNode,
 } from "@/components/composed/chat"
 import { Verse, VerseNote, VerseSpan } from "@/components/composed/verse"
 import {
@@ -25,7 +25,7 @@ import { cn } from "@/lib/utils"
 
 const EASE = [0.32, 0.72, 0, 1] as const
 
-const FLOW_NODES: StepNode[] = [
+const FLOW_NODES: TStepNode[] = [
   {
     id: "corpus",
     row: 0,
@@ -176,7 +176,6 @@ export function Hero({ children }: { children: React.ReactNode }) {
             title="Validate the Iliad corpus before the walker runs?"
             description="Check otype, oslots and section features in"
             entity={{ name: "Iliad · Homer corpus", initials: "I" }}
-            descriptionSuffix="which takes about"
             leadTime="2 min"
             confidence="high"
           />

package/src/components/icons/file-badge-cfm.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * CFM file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeCfm({
   title = "CFM file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-36 -48 1060 1114"

package/src/components/icons/file-badge-corpus.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * Corpus file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeCorpus({
   title = "Corpus file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-44 -48 1068 1114"

package/src/components/icons/file-badge-pdf.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * PDF file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgePdf({
   title = "PDF file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-44 -48 1068 1114"

package/src/components/icons/file-badge-tei.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * TEI file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeTei({
   title = "TEI file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-36 -48 1060 1114"

package/src/components/icons/file-badge-tf.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * TF file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeTf({
   title = "TF file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-36 -48 1060 1114"

package/src/components/icons/file-badge-txt.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * TXT file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeTxt({
   title = "TXT file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-36 -48 1060 1114"

package/src/components/icons/file-badge-xml.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * XML file icon — badge variant.
@@ -9,7 +9,7 @@ export function FileBadgeXml({
   title = "XML file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="-36 -48 1060 1114"

package/src/components/icons/file-wordmark-cfm.tsx

@@ -1,4 +1,4 @@
-import type { FileIconProps } from "./types"
+import type { IFileIconProps } from "./types"
 
 /**
  * CFM file icon — wordmark variant.
@@ -9,7 +9,7 @@ export function FileWordmarkCfm({
   title = "CFM file",
   className,
   ...props
-}: FileIconProps) {
+}: IFileIconProps) {
   return (
     <svg
       viewBox="0 -48 1024 1114"