@exegia/corpora-ui 3.0.0 → 3.1.0

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

@@ -1,83 +0,0 @@
-"use client"
-
-/* eslint-disable react-refresh/only-export-components */
-/**
- * The library's one and only state provider.
- *
- * Mount it once at the app root. Every library state hook then works
- * anywhere below it — there are no per-component providers to nest.
- *
- * One provider suffices because library state lives in module-level Jotai
- * atom families keyed by an instance id, not in a context created per
- * component. A new stateful component adds atoms to that module scope; it
- * never adds a provider. Consumer code therefore stays exactly as it is as
- * the library grows.
- *
- * Without this provider the hooks still run, which is the trap: Jotai falls
- * back to its implicit default store, and that store is NOT `exegiaStore`,
- * so imperative access would read a different store than the one the
- * components render from. Mount the provider.
- *
- * ```tsx
- * export function App() {
- *   return (
- *     <ExegiaProvider sound>
- *       <Routes />
- *     </ExegiaProvider>
- *   )
- * }
- * ```
- */
-import * as React from "react"
-import { Provider, useStore } from "jotai"
-
-import { ThemeProvider } from "@/components/theme-provider"
-import { ToastProvider } from "@/components/ui/toast"
-import { bindSounds } from "@/lib/sound"
-import { exegiaStore } from "./store"
-import type { TExegiaStore } from "./store"
-
-/** Options forwarded to the library's `ThemeProvider`. */
-export interface IExegiaThemeOptions {
-  defaultTheme?: "dark" | "light" | "system"
-  storageKey?: string
-  disableTransitionOnChange?: boolean
-}
-
-export interface IExegiaProviderProps {
-  children: React.ReactNode
-  /** Store to mount. Defaults to the library's `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?: IExegiaThemeOptions
-}
-
-export function ExegiaProvider({
-  children,
-  store,
-  sound = false,
-  theme,
-}: 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.
-    if (sound) bindSounds()
-  }, [sound])
-
-  // Toasts ride on the same single mount: components call `toastManager.add`
-  // and it renders here, so consumers never nest a second provider.
-  const content = <ToastProvider>{children}</ToastProvider>
-  return (
-    <Provider store={store ?? exegiaStore}>
-      {theme ? <ThemeProvider {...theme}>{content}</ThemeProvider> : content}
-    </Provider>
-  )
-}
-
-/** The store mounted by the nearest `ExegiaProvider` above the caller. */
-export const useExegiaStore = useStore

package/src/lib/state/index.ts

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

package/src/lib/state/store.ts

@@ -1,19 +0,0 @@
-import { createStore } from "jotai"
-
-/** A Jotai store as created by `createStore()`. */
-export type TExegiaStore = ReturnType<typeof createStore>
-
-/**
- * The library's default store — the one `ExegiaProvider` mounts unless it is
- * handed another. Exported so non-React code (a router guard, a command
- * palette, a test) can read and write library state imperatively:
- *
- * ```ts
- * exegiaStore.get(treeExpandedIdsAtom("app-nav"))
- * ```
- *
- * A single module-level store is wrong for SSR — state would leak between
- * requests — so render-per-request apps pass a fresh `createStore()` to
- * `ExegiaProvider` instead.
- */
-export const exegiaStore: TExegiaStore = createStore()

package/src/lib/use-motion-panel.ts

@@ -1,78 +0,0 @@
-"use client"
-
-import { useEffect, useLayoutEffect, useRef } from "react"
-import {
-  attachSeparator,
-  createPanel,
-  createPanelGroup,
-  type Orientation,
-  type PanelController,
-  type PanelOptions,
-  type Size,
-} from "motion-panels"
-
-/** Attach Motion Panels to our existing surfaces without adding styled wrappers. */
-export function useMotionPanel(
-  options: PanelOptions<Size> & {
-    orientation?: Orientation
-    enabled?: boolean
-  }
-) {
-  const {
-    orientation = "horizontal",
-    enabled = true,
-    ...panelOptions
-  } = options
-  const panelRef = useRef<HTMLElement | null>(null)
-  const gripRef = useRef<HTMLDivElement | null>(null)
-  const controllerRef = useRef<PanelController | null>(null)
-  const latest = useRef(panelOptions)
-  useLayoutEffect(() => {
-    latest.current = panelOptions
-  })
-
-  useLayoutEffect(() => {
-    const node = panelRef.current
-    if (!node || !enabled) return
-    const group = createPanelGroup(orientation)
-    const controller = createPanel(group, latest.current)
-    controllerRef.current = controller
-    const detach = controller.attach(node)
-    const extent = group.axes.extent
-    const previous = node.style[extent]
-    const draw = (size: number) => {
-      node.style[extent] = `${Math.max(0, size)}px`
-    }
-    draw(controller.motion.size.get())
-    const stopSize = controller.motion.size.on("change", draw)
-    const stopState = controller.subscribe(() => {
-      node.toggleAttribute("data-resizing", controller.state.dragging)
-      node.toggleAttribute("data-folding", controller.state.folding)
-    })
-    const detachGrip = gripRef.current
-      ? attachSeparator(gripRef.current, group, controller)
-      : undefined
-    return () => {
-      detachGrip?.()
-      stopSize()
-      stopState()
-      detach()
-      controller.destroy()
-      controllerRef.current = null
-      node.style[extent] = previous
-    }
-  }, [orientation, enabled])
-
-  useLayoutEffect(() => {
-    controllerRef.current?.sync(panelOptions)
-  })
-  // A separator can mount after a collapsed panel becomes visible. The host
-  // keeps it mounted instead and removes it from focus while closed.
-  useEffect(
-    () => () => {
-      controllerRef.current?.drag.cancel()
-    },
-    []
-  )
-  return { panelRef, gripRef }
-}

package/src/lib/utils.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, test } from "bun:test"
-
-import { glassVariantStyles } from "./glass-variants"
-import { cn } from "./utils"
-
-describe("cn", () => {
-  test("merges conflicting tailwind classes", () => {
-    expect(cn("p-2", "p-4")).toBe("p-4")
-  })
-
-  test("drops falsy values", () => {
-    expect(cn("a", undefined, null, "c")).toBe("a c")
-  })
-})
-
-describe("glassVariantStyles", () => {
-  test("has a style entry for every glass finish", () => {
-    expect(Object.keys(glassVariantStyles).sort()).toEqual(
-      ["clear", "frosted", "liquid", "liquid-refract", "subtle"].sort(),
-    )
-  })
-})

package/src/lib/utils.ts

@@ -1,100 +0,0 @@
-import { mergeConfig } from "@exegia/specular/merge"
-import { surfaces } from "./specular"
-import { clsx, type ClassValue } from "clsx"
-import { extendTailwindMerge, mergeConfigs, validators } from "tailwind-merge"
-
-/**
- * The `inset-shadow-{lit,dim}-*` bezel family (exported by `index.css`) is
- * ours, not Tailwind's. Left to itself tailwind-merge files every one of them
- * under its built-in `inset-shadow` group — which holds a single `box-shadow`
- * — and keeps only the last, so a bezel written as
- * `inset-shadow-lit-t-2 inset-shadow-dim-b-1` arrives as the dim class alone.
- *
- * Each utility writes exactly one custom property, so the conflict groups
- * mirror those properties: a layer's two axes, its blur and its alpha are
- * independent of each other and of the other layer. `-l-`/`-r-` are the two
- * ends of one axis and `-t-`/`-b-` of the other, so those do collide. Only
- * `inset-shadow-blur-*` spans layers — it writes both blurs — so it alone
- * conflicts across them.
- */
-type TInsetShadowGroupId =
-  | "inset-shadow-bezel"
-  | "inset-shadow-lit-x"
-  | "inset-shadow-lit-y"
-  | "inset-shadow-lit-blur"
-  | "inset-shadow-lit-alpha"
-  | "inset-shadow-dim-x"
-  | "inset-shadow-dim-y"
-  | "inset-shadow-dim-blur"
-  | "inset-shadow-dim-alpha"
-  | "inset-shadow-blur"
-
-const { isAny } = validators
-
-/**
- * Every group in the family writes the whole `box-shadow`, so each one both
- * displaces and is displaced by Tailwind's own shadow utilities. Without
- * this, `shadow-md inset-shadow-lit-t-2` survives `cn` intact and whichever
- * rule the stylesheet happens to sort last silently wins.
- */
-const INSET_SHADOW_GROUPS = [
-  "inset-shadow-bezel",
-  "inset-shadow-lit-x",
-  "inset-shadow-lit-y",
-  "inset-shadow-lit-blur",
-  "inset-shadow-lit-alpha",
-  "inset-shadow-dim-x",
-  "inset-shadow-dim-y",
-  "inset-shadow-dim-blur",
-  "inset-shadow-dim-alpha",
-  "inset-shadow-blur",
-] as const satisfies readonly TInsetShadowGroupId[]
-
-const displacesTailwindShadows = Object.fromEntries(
-  INSET_SHADOW_GROUPS.map((id) => [id, ["shadow", "inset-shadow"]])
-)
-
-const twMerge = extendTailwindMerge<TInsetShadowGroupId | import("@exegia/specular/merge").BezelGroupId<typeof surfaces>>({
-  extend: {
-    classGroups: {
-      // The shared base every other utility in the family `@apply`s. Grouped
-      // so it collapses against Tailwind's shadows like the rest of them.
-      "inset-shadow-bezel": ["inset-shadow-bezel"],
-      "inset-shadow-lit-x": [
-        { "inset-shadow-lit": [{ l: [isAny], r: [isAny] }] },
-      ],
-      "inset-shadow-lit-y": [
-        { "inset-shadow-lit": [{ t: [isAny], b: [isAny] }] },
-      ],
-      "inset-shadow-lit-blur": [{ "inset-shadow-lit": [{ blur: [isAny] }] }],
-      "inset-shadow-dim-x": [
-        { "inset-shadow-dim": [{ l: [isAny], r: [isAny] }] },
-      ],
-      "inset-shadow-dim-y": [
-        { "inset-shadow-dim": [{ t: [isAny], b: [isAny] }] },
-      ],
-      "inset-shadow-dim-blur": [{ "inset-shadow-dim": [{ blur: [isAny] }] }],
-      // The bare classes, which carry the layer opacity as a `/40` modifier.
-      "inset-shadow-lit-alpha": ["inset-shadow-lit"],
-      "inset-shadow-dim-alpha": ["inset-shadow-dim"],
-      "inset-shadow-blur": [{ "inset-shadow": [{ blur: [isAny] }] }],
-    },
-    conflictingClassGroups: {
-      ...displacesTailwindShadows,
-      // …and the other way round, so the last one written wins either way.
-      shadow: INSET_SHADOW_GROUPS,
-      "inset-shadow": INSET_SHADOW_GROUPS,
-      // Blurs both layers at once, so it supersedes either single-layer blur.
-      "inset-shadow-blur": [
-        "inset-shadow-lit-blur",
-        "inset-shadow-dim-blur",
-        "shadow",
-        "inset-shadow",
-      ],
-    },
-  },
-}, (config) => mergeConfigs(config, mergeConfig(surfaces)))
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}

package/src/specular.js

@@ -1,4 +0,0 @@
-import { createPlugin } from "@exegia/specular/plugin"
-import { surfaces } from "./lib/specular.ts"
-
-export default createPlugin(surfaces)