@exegia/corpora-ui 0.21.0 → 0.22.0

package/dist-lib/components/blocks/layout.d.ts

@@ -1,5 +1,8 @@
-import { default as ShellLayout } from './shell';
+import { default as ShellLayout, AnimatedPanel, useShellPanels, resetShellPanelWidthAtom, resizeShellPanelAtom, shellFitFitsAtom, shellFitMeasuredAtom, shellFitMetricsAtom, shellFitPanelBoundsAtom, shellFitPanelWidthAtom, shellFitRequestedWidthAtom, shellFitStateAtom } from './shell';
 declare const Layout: {
     Main: typeof ShellLayout;
+    Panel: typeof AnimatedPanel;
+    Trigger: import('react').ForwardRefExoticComponent<import('./shell').AnimatedSidebarTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;
 };
+export { useShellPanels, resetShellPanelWidthAtom, resizeShellPanelAtom, shellFitFitsAtom, shellFitMeasuredAtom, shellFitMetricsAtom, shellFitPanelBoundsAtom, shellFitPanelWidthAtom, shellFitRequestedWidthAtom, shellFitStateAtom, };
 export default Layout;

package/dist-lib/components/blocks/profile/profile-card-block.d.ts

@@ -32,7 +32,7 @@ export interface ProfileCardBlockProps {
      * its avatar — for an icon-collapsed sidebar rail. The fold animates: the
      * identity lines and chevron slide to zero width, the avatar stays put.
      * Controlled when passed. Left unset, the card follows the `AnimatedPanel`
-     * it sits in (a `SidebarBlock` footer folds with the rail on its own), and
+     * it sits in (a panel footer folds with the rail on its own), and
      * outside a panel starts from `defaultVariant`.
      */
     variant?: ProfileCardVariant;

package/dist-lib/components/blocks/shell/index.d.ts

@@ -10,16 +10,4 @@ export * from './animated-panel';
 export * from './animated-panel-inset';
 export * from './animated-panel-provider';
 export * from './animated-panel-trigger';
-export * from './animated-sidebar-header';
-export * from './animated-sidebar-content';
-export * from './animated-sidebar-footer';
-export * from './animated-sidebar-group';
-export * from './animated-sidebar-group-label';
-export * from './animated-sidebar-group-content';
-export * from './animated-sidebar-menu';
-export * from './animated-sidebar-menu-item';
-export * from './animated-sidebar-menu-sub';
-export * from './animated-sidebar-menu-sub-item';
-export * from './animated-sidebar-menu-sub-button';
-export * from './animated-sidebar-menu-button';
 export { ShellLayout as default };

package/dist-lib/components/composed/logo.d.ts

@@ -0,0 +1,34 @@
+import * as React from "react";
+/** `full` shows mark + wordmark; `mark` folds the wordmark away — an icon
+ * rail, a favicon-sized corner. */
+export type LogoVariant = "full" | "mark";
+export interface LogoProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
+    /**
+     * Brand name. Labels the logo for AT (and the link, when `href` renders
+     * one), drives the default wordmark, and the monogram tile when no mark
+     * is given.
+     */
+    name: string;
+    /** Custom mark — an inline SVG sized to fill its box. Wins over `src`. */
+    mark?: React.ReactNode;
+    /** Image URL for the mark. Decorative — `name` labels the logo. */
+    src?: string;
+    /** Wordmark content. Defaults to `name`. */
+    wordmark?: React.ReactNode;
+    /** `full` (default) or `mark` — the wordmark folds away, animated. */
+    variant?: LogoVariant;
+    /** Renders the logo as a link — the usual "mark goes home" affordance. */
+    href?: string;
+}
+/**
+ * Brand lockup: a mark beside a wordmark. The mark is whatever the brand
+ * has — an SVG (`mark`), an image (`src`), or, given neither, a monogram
+ * tile derived from `name`. `variant="mark"` folds the wordmark away with
+ * the same motion a collapsing rail uses, so the lockup can sit in one and
+ * follow its fold. With `href` the whole lockup is a link named by `name`.
+ *
+ * Sizing rides on the mark: it defaults to `size-8`; restyle via
+ * `[&_[data-slot=logo-mark]]:size-*` or wrap in a text-size context for the
+ * wordmark, which inherits.
+ */
+export declare function Logo({ name, mark, src, wordmark, variant, href, className, ...props }: LogoProps): React.ReactElement;

package/dist-lib/components/user-avatar/type.d.ts

@@ -31,8 +31,11 @@ export interface UserAvatarProps extends Omit<AvatarPrimitive.Root.Props, "child
     presence?: UserPresence;
     /**
      * Embossed rim whose highlight follows the pointer, so the avatar reads as
-     * a lit bezel rather than a flat disc. Light and dark aware; static under
-     * reduced motion. On by default — pass `false` for a flat disc.
+     * a lit bezel rather than a flat disc. Light and dark aware, and with a
+     * photo it samples the image's rim lightness (CORS permitting) to weight
+     * highlight against shadow, so the emboss reads on a dark portrait and a
+     * pale one alike. Static under reduced motion. On by default — pass
+     * `false` for a flat disc.
      */
     bezel?: boolean;
     /**
@@ -51,6 +54,11 @@ export interface UserAvatarState {
      * `((a % 360) + 360) % 360` if you need it normalised. */
     bezelAngle: number;
     imageStatus: ImageStatus;
+    /** Perceived lightness of the loaded image's rim, 0 (black) → 1 (white),
+     * or `null` while unknown — no image yet, or one that could not be sampled
+     * (non-CORS host, no canvas). The bezel's highlight/shadow alphas follow
+     * it so the emboss reads on a dark photo and a pale one alike. */
+    imageTone: number | null;
 }
 /** Write-only handles onto one avatar. Nothing here re-renders the caller. */
 export interface UserAvatarActions {

package/dist-lib/components/user-avatar/use-user-avatar.d.ts

@@ -8,12 +8,17 @@ export interface UseUserAvatarOptions {
     bezel: boolean;
     /** Only meaningful with an image — no image, no status to track. */
     hasImage: boolean;
+    /** The image URL, sampled for its rim lightness once it has loaded so the
+     * bezel can pick alphas that read against it. Omit to skip sampling. */
+    src?: string;
 }
 export interface UserAvatarBinding {
     avatarId: UserAvatarInstanceId;
     presence: UserPresence | null;
     bezelAngle: number;
     imageStatus: ImageStatus;
+    /** Rim lightness of the loaded image, 0–1, or `null` while unknown. */
+    imageTone: number | null;
     /** Hand to the image's `onLoadingStatusChange`. Stable. */
     setImageStatus: (status: ImageStatus) => void;
     /** Attach to the avatar root — the bezel is lit relative to its centre. */

package/dist-lib/components/user-avatar/user-avatar-atom.d.ts

@@ -15,6 +15,10 @@ export declare const userAvatarBezelAngleAtom: Family<import('jotai').PrimitiveA
 export declare const userAvatarImageStatusAtom: Family<import('jotai').PrimitiveAtom<import('@base-ui/react').ImageLoadingStatus> & {
     init: import('@base-ui/react').ImageLoadingStatus;
 }>;
+/** Rim lightness of the loaded image, `null` until sampled (or unsampleable). */
+export declare const userAvatarImageToneAtom: Family<import('jotai').PrimitiveAtom<number | null> & {
+    init: number | null;
+}>;
 /** @internal Which fields the mounted component controls from props. */
 export declare const userAvatarConfigAtom: Family<import('jotai').PrimitiveAtom<UserAvatarConfig> & {
     init: UserAvatarConfig;
@@ -42,6 +46,11 @@ export declare const setUserAvatarBezelAngleAtom: Family<import('jotai').Writabl
 export declare const setUserAvatarImageStatusAtom: Family<import('jotai').WritableAtom<null, [status: import('@base-ui/react').ImageLoadingStatus], void> & {
     init: null;
 }>;
+/** @internal Written by the hook once the loaded image has been sampled;
+ * cleared (null) when the image changes or goes away. Clamped to [0, 1]. */
+export declare const setUserAvatarImageToneAtom: Family<import('jotai').WritableAtom<null, [tone: number | null], void> & {
+    init: null;
+}>;
 /** @internal Projection of the mounted component's controlled props. */
 export declare const projectUserAvatarPropsAtom: Family<import('jotai').WritableAtom<null, [config: UserAvatarConfig, presence: UserPresence | null | undefined], void> & {
     init: null;

package/dist-lib/components/user-avatar/utils.d.ts

@@ -1,2 +1,24 @@
 /** "Jenny Hamilton" → "JH", "luna" → "L". */
 export declare function initialsFrom(name: string): string;
+/**
+ * Average perceived lightness, 0 (black) → 1 (white), of an image's outer
+ * band — the pixels the bezel ring overlays — or `null` when it cannot be
+ * measured: no DOM/canvas (SSR, test DOM), a decode failure, or a host
+ * without CORS headers (the sample needs a CORS-clean image; the avatar's
+ * own `<img>` is left untouched, so a non-CORS host still displays).
+ * Results are memoised per `src`, so a room of the same face samples once.
+ */
+export declare function measureRimTone(src: string): Promise<number | null>;
+/**
+ * Bezel highlight/shadow alphas for an image whose rim lightness is `tone`
+ * (0 → 1). Against a dark rim the white highlight is eased off (it glares)
+ * and the black shadow pushed up (it has to darken mid-tones to register);
+ * against a pale rim the reverse — the highlight can be full (it barely
+ * shows) and the shadow is what carries the emboss, so it sits lighter.
+ * Linear between; the end points are tuned by eye on a dark and a light
+ * photo in both themes.
+ */
+export declare function bezelAlphasForTone(tone: number): {
+    hi: number;
+    lo: number;
+};

package/dist-lib/index.d.ts

@@ -20,6 +20,7 @@ export * from './components/ui/separator';
 export * from './components/ui/skeleton';
 export * from './components/ui/spinner';
 export * from './components/ui/textarea';
+export * from './components/composed/logo';
 export * from './components/composed/password-input';
 export * from './components/composed/social-providers';
 export * from './components/composed/tree';
@@ -36,7 +37,6 @@ 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-block';
 export * from './components/blocks/nav/sidebar';
 export * from './components/blocks/shell';
 export { default as ShellLayout } from './components/blocks/shell';