@exegia/corpora-ui 1.0.0 → 3.0.0

package/src/components/ui/popover-glass.tsx

@@ -2,7 +2,7 @@
 
 import { Popover as PopoverPrimitive } from "@base-ui/react/popover"
 import type React from "react"
-import { type FrostGlassVariant } from "@/lib/glass-variants"
+import { type TFrostGlassVariant } from "@/lib/glass-variants"
 import { cn } from "@/lib/utils"
 import { GlassContainer } from "@/components/ui/glasscn/glass-container"
 
@@ -12,7 +12,7 @@ const popupStructuralClasses =
 
 /**
  * Neutral base for the glass treatment — the finish itself (blur, tint,
- * bevel) comes from `glassVariantStyles` keyed by `glassVariant`, which is
+ * bevel) comes from the library material keyed by `glassVariant`, which is
  * only accepted when `variant` is "glass".
  */
 const popupGlassBaseClasses =
@@ -25,7 +25,7 @@ const popupGlassBaseClasses =
  * four pure-class finishes only, and defaults to "frosted" rather than to
  * Button's "liquid-refract".
  */
-type PopoverGlassVariant = Exclude<FrostGlassVariant, "liquid-refract">
+type TPopoverGlassVariant = Exclude<TFrostGlassVariant, "liquid-refract">
 
 export const PopoverCreateHandle: typeof PopoverPrimitive.createHandle =
   PopoverPrimitive.createHandle
@@ -48,7 +48,7 @@ export function PopoverTrigger({
   )
 }
 
-type PopoverPopupBaseProps = PopoverPrimitive.Popup.Props & {
+type TPopoverPopupBaseProps = PopoverPrimitive.Popup.Props & {
   portalProps?: PopoverPrimitive.Portal.Props
   side?: PopoverPrimitive.Positioner.Props["side"]
   align?: PopoverPrimitive.Positioner.Props["align"]
@@ -58,9 +58,9 @@ type PopoverPopupBaseProps = PopoverPrimitive.Popup.Props & {
   anchor?: PopoverPrimitive.Positioner.Props["anchor"]
 }
 
-export type PopoverGlassProps = PopoverPopupBaseProps & {
+export type TPopoverGlassProps = TPopoverPopupBaseProps & {
   /** Glass finish. Either "frosted" or "glass". Defaults to "frosted". */
-  glassVariant?: PopoverGlassVariant
+  glassVariant?: TPopoverGlassVariant
 }
 
 export function PopoverGlass({
@@ -74,8 +74,8 @@ export function PopoverGlass({
   portalProps,
   glassVariant,
   ...props
-}: PopoverGlassProps): React.ReactElement {
-  const resolvedGlassVariant: PopoverGlassVariant = glassVariant ?? "frosted"
+}: TPopoverGlassProps): React.ReactElement {
+  const resolvedGlassVariant: TPopoverGlassVariant = glassVariant ?? "frosted"
 
   return (
     <PopoverPrimitive.Portal {...portalProps} keepMounted>
@@ -104,17 +104,14 @@ export function PopoverGlass({
           <PopoverPrimitive.Viewport
             className={cn(
               "relative size-full max-h-(--available-height) px-(--viewport-inline-padding) [--viewport-inline-padding:--spacing(4)] has-data-[slot=calendar]:p-2 **:data-current:w-[calc(var(--popup-width)-2*var(--viewport-inline-padding)-2px)] **:data-current:opacity-100 **:data-current:transition-opacity **:data-current:data-ending-style:opacity-0 data-instant:transition-none **:data-previous:w-[calc(var(--popup-width)-2*var(--viewport-inline-padding)-2px)] **:data-previous:opacity-100 **:data-previous:transition-opacity **:data-previous:data-ending-style:opacity-0 **:data-current:data-starting-style:opacity-0 **:data-previous:data-starting-style:opacity-0",
-              "bg-background/40 px-0 backdrop-blur-md"
+              "px-0"
             )}
             data-slot="popover-viewport"
             render={
               <GlassContainer
-                refraction={8}
-                bezel={50}
-                blur={10}
-                saturation={-4}
+                optics={{ strength: 0.08, bendWidth: 0.5, frost: 10, saturate: 1 }}
                 className={cn("shadow-md shadow-black/10 rounded-lg")}
-                glassVariant="liquid-refract"
+                glassVariant={resolvedGlassVariant}
               />
             }
           >

package/src/components/ui/select.tsx

@@ -32,7 +32,7 @@ export const selectTriggerVariants = cva(
 
 export const selectTriggerIconClassName = "-me-1 size-4.5 opacity-80 sm:size-4";
 
-export interface SelectButtonProps extends useRender.ComponentProps<"button"> {
+export interface ISelectButtonProps extends useRender.ComponentProps<"button"> {
   size?: VariantProps<typeof selectTriggerVariants>["size"];
 }
 
@@ -42,7 +42,7 @@ export function SelectButton({
   render,
   children,
   ...props
-}: SelectButtonProps): React.ReactElement {
+}: ISelectButtonProps): React.ReactElement {
   const typeValue: React.ButtonHTMLAttributes<HTMLButtonElement>["type"] =
     render ? undefined : "button";
 

package/src/components/ui/tabs.tsx

@@ -3,17 +3,17 @@
 import { Tabs as TabsPrimitive } from "@base-ui/react/tabs"
 import * as React from "react"
 import {
-  type SegmentedControlSize,
+  type TSegmentedControlSize,
   segmentedControlItemLayoutClassName,
   segmentedControlItemSizeClassNames,
 } from "@/lib/segmented-control"
 import { cn } from "@/lib/utils"
 
-type TabsVariant = "default" | "underline"
-type TabsSize = SegmentedControlSize
+type TTabsVariant = "default" | "underline"
+type TTabsSize = TSegmentedControlSize
 
-const TabsListContext: React.Context<TabsSize> =
-  React.createContext<TabsSize>("default")
+const TabsListContext: React.Context<TTabsSize> =
+  React.createContext<TTabsSize>("default")
 
 export function Tabs({
   className,
@@ -38,8 +38,8 @@ export function TabsList({
   children,
   ...props
 }: TabsPrimitive.List.Props & {
-  size?: TabsSize
-  variant?: TabsVariant
+  size?: TTabsSize
+  variant?: TTabsVariant
 }): React.ReactElement {
   return (
     <TabsPrimitive.List
@@ -77,10 +77,10 @@ export function TabsTab({
   size,
   ...props
 }: TabsPrimitive.Tab.Props & {
-  size?: TabsSize
+  size?: TTabsSize
 }): React.ReactElement {
-  const contextSize: TabsSize = React.useContext(TabsListContext)
-  const resolvedSize: TabsSize = size ?? contextSize
+  const contextSize: TTabsSize = React.useContext(TabsListContext)
+  const resolvedSize: TTabsSize = size ?? contextSize
 
   return (
     <TabsPrimitive.Tab
@@ -115,6 +115,6 @@ export {
   TabsPrimitive,
   TabsTab as TabsTrigger,
   TabsPanel as TabsContent,
-  type TabsSize,
-  type TabsVariant,
+  type TTabsSize,
+  type TTabsVariant,
 }

package/src/components/ui/textarea.tsx

@@ -5,7 +5,7 @@ import { mergeProps } from "@base-ui/react/merge-props";
 import type * as React from "react";
 import { cn } from "@/lib/utils";
 
-export type TextareaProps = React.ComponentPropsWithoutRef<"textarea"> &
+export type TTextareaProps = React.ComponentPropsWithoutRef<"textarea"> &
   React.RefAttributes<HTMLTextAreaElement> & {
     size?: "sm" | "default" | "lg" | number;
     unstyled?: boolean;
@@ -17,7 +17,7 @@ export function Textarea({
   unstyled = false,
   ref,
   ...props
-}: TextareaProps): React.ReactElement {
+}: TTextareaProps): React.ReactElement {
   return (
     <span
       className={

package/src/components/ui/toast.tsx

@@ -20,9 +20,9 @@ const TOAST_ICONS = {
   warning: TriangleAlertIcon,
 } as const;
 
-type SwipeDirection = "up" | "down" | "left" | "right";
+type TSwipeDirection = "up" | "down" | "left" | "right";
 
-type ToastData = {
+type TToastData = {
   rootProps?: Omit<
     React.ComponentProps<typeof Toast.Root>,
     "children" | "className" | "swipeDirection" | "toast"
@@ -30,8 +30,8 @@ type ToastData = {
   tooltipStyle?: boolean;
 };
 
-function getSwipeDirection(position: ToastPosition): SwipeDirection[] {
-  const verticalDirection: SwipeDirection = position.startsWith("top")
+function getSwipeDirection(position: TToastPosition): TSwipeDirection[] {
+  const verticalDirection: TSwipeDirection = position.startsWith("top")
     ? "up"
     : "down";
 
@@ -63,7 +63,7 @@ function Toasts({
   position,
   portalProps,
 }: {
-  position: ToastPosition;
+  position: TToastPosition;
   portalProps?: React.ComponentProps<typeof Toast.Portal>;
 }): React.ReactElement {
   const { toasts } = Toast.useToastManager();
@@ -89,7 +89,7 @@ function Toasts({
           const Icon = toast.type
             ? TOAST_ICONS[toast.type as keyof typeof TOAST_ICONS]
             : null;
-          const toastData = toast.data as ToastData | undefined;
+          const toastData = toast.data as TToastData | undefined;
 
           return (
             <Toast.Root
@@ -198,7 +198,7 @@ function AnchoredToasts({
           const Icon = toast.type
             ? TOAST_ICONS[toast.type as keyof typeof TOAST_ICONS]
             : null;
-          const toastData = toast.data as ToastData | undefined;
+          const toastData = toast.data as TToastData | undefined;
           const tooltipStyle = toastData?.tooltipStyle ?? false;
           const positionerProps = toast.positionerProps;
 
@@ -278,7 +278,7 @@ export const toastManager: ReturnType<typeof Toast.createToastManager> =
 export const anchoredToastManager: ReturnType<typeof Toast.createToastManager> =
   Toast.createToastManager();
 
-export type ToastPosition =
+export type TToastPosition =
   | "top-left"
   | "top-center"
   | "top-right"
@@ -286,8 +286,8 @@ export type ToastPosition =
   | "bottom-center"
   | "bottom-right";
 
-export interface ToastProviderProps extends Toast.Provider.Props {
-  position?: ToastPosition;
+export interface IToastProviderProps extends Toast.Provider.Props {
+  position?: TToastPosition;
   portalProps?: React.ComponentProps<typeof Toast.Portal>;
 }
 
@@ -296,7 +296,7 @@ export function ToastProvider({
   position = "bottom-right",
   portalProps,
   ...props
-}: ToastProviderProps): React.ReactElement {
+}: IToastProviderProps): React.ReactElement {
   return (
     <Toast.Provider toastManager={toastManager} {...props}>
       {children}
@@ -305,7 +305,7 @@ export function ToastProvider({
   );
 }
 
-export interface AnchoredToastProviderProps extends Toast.Provider.Props {
+export interface IAnchoredToastProviderProps extends Toast.Provider.Props {
   portalProps?: React.ComponentProps<typeof Toast.Portal>;
 }
 
@@ -313,7 +313,7 @@ export function AnchoredToastProvider({
   children,
   portalProps,
   ...props
-}: AnchoredToastProviderProps): React.ReactElement {
+}: IAnchoredToastProviderProps): React.ReactElement {
   return (
     <Toast.Provider toastManager={anchoredToastManager} {...props}>
       {children}

package/src/index.css

@@ -5,4 +5,6 @@
 
 @import "@fontsource-variable/inter";
 @import "@fontsource-variable/figtree";
-@import "motion-icons-react/style.css";
+@import "motion-icons-react/style.css";
+
+@plugin "./specular.js";

package/src/index.ts

@@ -45,6 +45,8 @@ export * from "./components/composed/password-input"
 export * from "./components/composed/social-providers"
 export * from "./components/composed/reader"
 export * from "./components/composed/tree"
+export { default as User } from "./components/composed/user"
+export type { IUserMessageProps, TUserInfoProps, TUserPillProps } from "./components/composed/user/types"
 export * from "./components/composed/verse"
 // The old `components/user-avatar` module was removed (92f029c); the avatar
 // now lives in `components/atoms/avatar` and flows through the atoms barrel.
@@ -62,7 +64,7 @@ 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"
+export * from "./components/blocks/sidebar"
 export * from "./components/blocks/shell"
 export { default as ShellLayout } from "./components/blocks/shell"
 export * from "./components/blocks/scaffold"

package/src/lib/attachment-content.ts

@@ -0,0 +1,28 @@
+import { Children, Fragment, isValidElement, type ReactNode } from "react"
+
+/** Shared marker keeps the bubble atom independent of the composed attachment. */
+export const ATTACHMENT_CONTENT = Symbol.for("corpora-ui.attachment")
+
+function contentNodes(children: ReactNode): ReactNode[] {
+  return Children.toArray(children).flatMap((child) =>
+    isValidElement<{ children?: ReactNode }>(child) && child.type === Fragment
+      ? contentNodes(child.props.children)
+      : typeof child === "string" && !child.trim()
+        ? []
+        : [child]
+  )
+}
+
+export function containsOnlyAttachments(children: ReactNode): boolean {
+  const nodes = contentNodes(children)
+  return (
+    nodes.length > 0 &&
+    nodes.every(
+      (child) =>
+        isValidElement(child) &&
+        Boolean(
+          (child.type as { [ATTACHMENT_CONTENT]?: boolean })[ATTACHMENT_CONTENT]
+        )
+    )
+  )
+}

package/src/lib/auth-accent.ts

@@ -8,7 +8,7 @@
  */
 
 /** Brand accents available to the auth blocks. */
-export type AuthAccent = "corpora" | "exegia";
+export type TAuthAccent = "corpora" | "exegia";
 
 /**
  * Custom properties an accent contributes, set on the AuthCard root.
@@ -19,7 +19,7 @@ export type AuthAccent = "corpora" | "exegia";
  * itself is a constant, so its contrast pair has to be too (white on the
  * corpora yellow fails badly).
  */
-export const authAccentVars: Record<AuthAccent, Record<string, string>> = {
+export const authAccentVars: Record<TAuthAccent, Record<string, string>> = {
   corpora: {
     "--auth-accent": "#E8B124",
     "--auth-accent-image": "none",

package/src/lib/glass-variants.ts

@@ -1,57 +1,22 @@
-export type FrostGlassVariant = "clear" | "frosted" | "subtle" | "liquid" | "liquid-refract";
-export type FrostGlassVariantProp = { glassVariant?: FrostGlassVariant };
+import type { GlassOptics } from "@samasante/liquid-glass"
 
-export const liquidRefractStyles = "bg-transparent border-0 shadow-none";
+export type TFrostGlassVariant = "clear" | "frosted" | "subtle" | "liquid" | "liquid-refract"
+export type TFrostGlassVariantProp = { glassVariant?: TFrostGlassVariant }
+export const liquidRefractStyles = "bg-transparent border-0 shadow-none"
 
-export const glassVariantStyles: Record<FrostGlassVariant, string> = {
-  clear: [
-    "backdrop-blur-[2px] backdrop-saturate-[1.9]",
-    "bg-white/[0.25] dark:bg-black/[0.25]",
-    "border border-white/[0.5] dark:border-white/[0.12]",
-    "shadow-[0_1px_12px_rgba(0,0,0,0.05)] dark:shadow-[0_1px_12px_rgba(0,0,0,0.2)]",
-  ].join(" "),
-  frosted: [
-    "backdrop-blur-[16px] backdrop-saturate-[1.6]",
-    "bg-white/[0.55] dark:bg-black/[0.35]",
-    "border border-white/[0.4] dark:border-white/10",
-    "shadow-[0_2px_20px_rgba(0,0,0,0.06)] dark:shadow-[0_2px_20px_rgba(0,0,0,0.3)]",
-  ].join(" "),
-  subtle: [
-    "backdrop-blur-[4px] backdrop-saturate-[1.5]",
-    "bg-white/[0.3] dark:bg-white/[0.06]",
-    "border border-black/[0.05] dark:border-white/[0.08]",
-    "shadow-sm",
-  ].join(" "),
-  liquid: [
-    // 1) Refractive backdrop — lighter than frosted so the background reads
-    //    clearly through the lens; saturation + brightness lift makes it bloom.
-    "backdrop-blur-[12px] backdrop-saturate-[1.8] backdrop-brightness-[1.05]",
-    "dark:backdrop-saturate-[1.6] dark:backdrop-brightness-[0.95]",
+/** Tints only; refraction, frost, and edge lighting belong to the library. */
+export const glassVariantStyles: Record<TFrostGlassVariant, string> = {
+  clear: "bg-white/25 dark:bg-black/25",
+  frosted: "bg-white/55 dark:bg-black/35",
+  subtle: "bg-white/30 dark:bg-white/6",
+  liquid: "bg-white/10 dark:bg-white/4",
+  "liquid-refract": "bg-white/8 dark:bg-white/4",
+}
 
-    // 2) Base translucent fill (acts as the panel's "tint").
-    "bg-white/[0.10] dark:bg-white/[0.04]",
-
-    // 3) Layered radial-gradient sheen + warm bottom tint + vertical wash.
-    //    Underscores represent spaces inside Tailwind arbitrary values.
-    "[background-image:radial-gradient(120%_85%_at_15%_8%,rgba(255,255,255,0.55)_0%,rgba(255,255,255,0.18)_38%,rgba(255,255,255,0)_70%),radial-gradient(110%_80%_at_85%_100%,rgba(255,210,230,0.22)_0%,rgba(255,255,255,0)_60%),linear-gradient(180deg,rgba(255,255,255,0.28)_0%,rgba(255,255,255,0.12)_100%)]",
-    "dark:[background-image:radial-gradient(120%_85%_at_15%_8%,rgba(255,255,255,0.18)_0%,rgba(255,255,255,0.05)_40%,rgba(255,255,255,0)_70%),radial-gradient(110%_80%_at_85%_100%,rgba(120,170,255,0.12)_0%,rgba(0,0,0,0)_60%),linear-gradient(180deg,rgba(255,255,255,0.06)_0%,rgba(0,0,0,0.18)_100%)]",
-    "[background-size:200%_200%,180%_180%,100%_100%]",
-    "[background-repeat:no-repeat]",
-
-    // 4) Multi-layer bevel:
-    //    - inset top hairline highlight (light-from-above)
-    //    - inset fish-eye glow at the bottom (lensing artifact)
-    //    - thin inset side rails
-    //    - outer contact shadow + broader halo (panel feels floating)
-    "shadow-[inset_0_1px_0_0_rgba(255,255,255,0.65),inset_0_-12px_24px_-10px_rgba(255,255,255,0.45),inset_1px_0_0_0_rgba(255,255,255,0.22),inset_-1px_0_0_0_rgba(255,255,255,0.18),0_24px_60px_-18px_rgba(15,23,42,0.30),0_8px_24px_-8px_rgba(15,23,42,0.18)]",
-    "dark:shadow-[inset_0_1px_0_0_rgba(255,255,255,0.30),inset_0_-14px_28px_-10px_rgba(180,210,255,0.18),inset_1px_0_0_0_rgba(255,255,255,0.10),inset_-1px_0_0_0_rgba(255,255,255,0.08),0_28px_70px_-18px_rgba(0,0,0,0.55),0_10px_28px_-10px_rgba(0,0,0,0.40)]",
-
-    // 5) Hairline border for the chamfer's outer edge.
-    "border border-white/[0.45] dark:border-white/[0.10]",
-
-    // 6) Slow ambient drift; respects prefers-reduced-motion.
-    "animate-[liquid-drift_18s_ease-in-out_infinite] motion-reduce:animate-none",
-    "[will-change:background-position]",
-  ].join(" "),
-  "liquid-refract": "",
-};
+export const glassVariantOptics: Record<TFrostGlassVariant, Partial<GlassOptics>> = {
+  clear: { frost: 2, saturate: 1.9, strength: 0.08 },
+  frosted: { frost: 16, saturate: 1.6, strength: 0.08 },
+  subtle: { frost: 4, saturate: 1.5, strength: 0.04 },
+  liquid: { frost: 4, saturate: 1.8, strength: 0.14 },
+  "liquid-refract": { frost: 2, saturate: 1.5, strength: 0.14 },
+}

package/src/lib/keyed-atom.ts

@@ -10,12 +10,12 @@
 import { atom } from "jotai"
 import type { Getter, Setter } from "jotai"
 
-export type Family<AtomType> = ((id: string) => AtomType) & { remove: (id: string) => void }
+export type TFamily<AtomType> = ((id: string) => AtomType) & { remove: (id: string) => void }
 
 export function createKeyedFamilies(feature: string) {
   const families: { remove: (id: string) => void }[] = []
 
-  function keyed<AtomType>(create: (id: string) => AtomType): Family<AtomType> {
+  function keyed<AtomType>(create: (id: string) => AtomType): TFamily<AtomType> {
     const cache = new Map<string, AtomType>()
     const family = ((id: string) => {
       let instance = cache.get(id)
@@ -24,7 +24,7 @@ export function createKeyedFamilies(feature: string) {
         cache.set(id, instance)
       }
       return instance
-    }) as Family<AtomType>
+    }) as TFamily<AtomType>
     family.remove = (id) => {
       cache.delete(id)
     }

package/src/lib/segmented-control.ts

@@ -1,9 +1,9 @@
 import { cva } from "class-variance-authority";
 
-export type SegmentedControlSize = "default" | "lg" | "sm" | "xs";
+export type TSegmentedControlSize = "default" | "lg" | "sm" | "xs";
 
 export const segmentedControlItemSizeClassNames: Record<
-  SegmentedControlSize,
+  TSegmentedControlSize,
   string
 > = {
   default: "h-8.5 px-[calc(--spacing(2.5)-1px)] sm:h-7.5",

package/src/lib/specular.ts

@@ -0,0 +1,10 @@
+import { defineSurfaces } from "@exegia/specular"
+
+export const surfaces = defineSurfaces({
+  bezel: {
+    layers: {
+      lit: { color: "#fff" },
+      dim: { color: "#000" },
+    },
+  },
+})

package/src/lib/state/__tests__/sound.test.tsx

@@ -0,0 +1,53 @@
+import { expect, mock, test } from "bun:test"
+import { fireEvent, render, screen } from "@testing-library/react"
+
+import { Button } from "@/components/ui/button"
+import { playCue } from "@/lib/sound"
+import { ExegiaProvider } from "../exegia-provider"
+
+test("sound opt-in connects delegated and imperative cues to Web Audio", () => {
+  const original = Object.getOwnPropertyDescriptor(window, "AudioContext")
+  const requestedAudio = mock(() => {})
+  // Stop at the browser audio boundary: no real speakers are needed by tests.
+  class UnavailableAudioContext {
+    constructor() {
+      requestedAudio()
+      throw new Error("Audio device unavailable in test")
+    }
+  }
+  Object.defineProperty(window, "AudioContext", {
+    configurable: true,
+    value: UnavailableAudioContext,
+  })
+
+  try {
+    const view = render(
+      <ExegiaProvider>
+        <Button>Audible</Button>
+      </ExegiaProvider>
+    )
+    fireEvent.pointerDown(screen.getByRole("button", { name: "Audible" }))
+    playCue("tick")
+    expect(requestedAudio).not.toHaveBeenCalled()
+
+    view.rerender(
+      <ExegiaProvider sound>
+        <Button>Audible</Button>
+        <Button sound={false}>Silent</Button>
+      </ExegiaProvider>
+    )
+    fireEvent.pointerDown(screen.getByRole("button", { name: "Audible" }))
+    expect(requestedAudio).toHaveBeenCalledTimes(1)
+    fireEvent.pointerUp(screen.getByRole("button", { name: "Audible" }))
+    expect(requestedAudio).toHaveBeenCalledTimes(2)
+    playCue("tick")
+    expect(requestedAudio).toHaveBeenCalledTimes(3)
+
+    fireEvent.pointerDown(screen.getByRole("button", { name: "Silent" }))
+    fireEvent.pointerUp(screen.getByRole("button", { name: "Silent" }))
+    expect(requestedAudio).toHaveBeenCalledTimes(3)
+  } finally {
+    if (original) Object.defineProperty(window, "AudioContext", original)
+    else Reflect.deleteProperty(window, "AudioContext")
+  }
+})

package/src/lib/state/exegia-provider.tsx

@@ -35,26 +35,26 @@ import { ThemeProvider } from "@/components/theme-provider"
 import { ToastProvider } from "@/components/ui/toast"
 import { bindSounds } from "@/lib/sound"
 import { exegiaStore } from "./store"
-import type { ExegiaStore } from "./store"
+import type { TExegiaStore } from "./store"
 
 /** Options forwarded to the library's `ThemeProvider`. */
-export interface ExegiaThemeOptions {
+export interface IExegiaThemeOptions {
   defaultTheme?: "dark" | "light" | "system"
   storageKey?: string
   disableTransitionOnChange?: boolean
 }
 
-export interface ExegiaProviderProps {
+export interface IExegiaProviderProps {
   children: React.ReactNode
   /** Store to mount. Defaults to the library's `exegiaStore`. */
-  store?: ExegiaStore
+  store?: TExegiaStore
   /** Opt into interaction sound. Off unless the app asks for it. */
   sound?: boolean
   /** Mount `ThemeProvider` with these options. Omit it and none is mounted —
    * it reads `localStorage` in its state initializer, so an unconditional
    * mount would break SSR consumers, and `useTheme` already throws without
    * one. */
-  theme?: ExegiaThemeOptions
+  theme?: IExegiaThemeOptions
 }
 
 export function ExegiaProvider({
@@ -62,7 +62,7 @@ export function ExegiaProvider({
   store,
   sound = false,
   theme,
-}: ExegiaProviderProps): React.ReactElement {
+}: IExegiaProviderProps): React.ReactElement {
   React.useEffect(() => {
     // Idempotent, and deliberately not at module scope: opting into sound is
     // the consuming app's decision, not an import side effect.

package/src/lib/state/index.ts

@@ -1,4 +1,4 @@
 export { ExegiaProvider, useExegiaStore } from "./exegia-provider"
-export type { ExegiaProviderProps, ExegiaThemeOptions } from "./exegia-provider"
+export type { IExegiaProviderProps, IExegiaThemeOptions } from "./exegia-provider"
 export { exegiaStore } from "./store"
-export type { ExegiaStore } from "./store"
+export type { TExegiaStore } from "./store"

package/src/lib/state/store.ts

@@ -1,7 +1,7 @@
 import { createStore } from "jotai"
 
 /** A Jotai store as created by `createStore()`. */
-export type ExegiaStore = ReturnType<typeof createStore>
+export type TExegiaStore = ReturnType<typeof createStore>
 
 /**
  * The library's default store — the one `ExegiaProvider` mounts unless it is
@@ -16,4 +16,4 @@ export type ExegiaStore = ReturnType<typeof createStore>
  * requests — so render-per-request apps pass a fresh `createStore()` to
  * `ExegiaProvider` instead.
  */
-export const exegiaStore: ExegiaStore = createStore()
+export const exegiaStore: TExegiaStore = createStore()