@fairgarden/design 0.1.0-alpha.0

package/components/Popover/Popover.d.ts

@@ -0,0 +1,96 @@
+import * as React from 'react';
+import { Popover as BasePopover } from '@base-ui/react/popover';
+import { useRender } from '@base-ui/react/use-render';
+import { type VariantProps } from 'class-variance-authority';
+import { type ButtonProps } from '../Button';
+export declare const popover: (props?: ({
+    kind?: "definition" | "panel" | null | undefined;
+    primary?: "ruby" | "brown" | "crimson" | "gold" | "gray" | "indigo" | "olive" | "pink" | "plum" | "purple" | "red" | "tomato" | "violet" | "bronze" | "iris" | "mauve" | "sage" | "sand" | "slate" | null | undefined;
+    secondary?: "ruby" | "blue" | "brown" | "crimson" | "cyan" | "gold" | "gray" | "green" | "indigo" | "lime" | "olive" | "orange" | "pink" | "plum" | "purple" | "red" | "teal" | "tomato" | "violet" | "yellow" | "amber" | "bronze" | "grass" | "iris" | "jade" | "mauve" | "mint" | "sage" | "sand" | "sky" | "slate" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type PopoverVariants = VariantProps<typeof popover>;
+export type PopoverKind = NonNullable<PopoverVariants['kind']>;
+/** Props for Popover: Base UI Popover.Root props (`open`, `onOpenChange`, `modal` …). */
+export type PopoverProps<Payload = unknown> = BasePopover.Root.Props<Payload>;
+/** Groups the parts of a popover (Base UI Popover.Root). Esc or an outside press closes it. */
+export declare function Popover<Payload = unknown>(props: PopoverProps<Payload>): React.JSX.Element;
+/** Props for PopoverTrigger: Button props plus Base UI's trigger options. */
+export type PopoverTriggerProps = ButtonProps & {
+    /** Associates a detached trigger with a Popover created by `Popover.createHandle`. */
+    handle?: BasePopover.Trigger.Props['handle'];
+    /** A payload handed to the Popover's children function when this trigger opens it. */
+    payload?: unknown;
+};
+/**
+ * Opens the popover on press, never on hover (§10.15). Renders a Button
+ * (§9.2); its data-popup-open shows the expanded state.
+ */
+export declare function PopoverTrigger(props: PopoverTriggerProps): React.JSX.Element;
+type PositionerProps = BasePopover.Positioner.Props;
+/** Props for PopoverPopup: Base UI Popover.Popup props plus placement, kind, color axes and portal options. */
+export type PopoverPopupProps = BasePopover.Popup.Props & {
+    /** `panel` (default): a padded panel. `definition`: a term, its definition and an optional source. */
+    kind?: PopoverVariants['kind'];
+    /** Primary Radix scale inside the popup's `white` scope. Omitted, the white preset's default [D133]. */
+    primary?: PopoverVariants['primary'];
+    /** Secondary Radix scale inside the popup: link underlines and other accents only. */
+    secondary?: PopoverVariants['secondary'];
+    /** Which side of the trigger the panel sits on. Default `bottom`; it flips when there is no room. */
+    side?: PositionerProps['side'];
+    /** Alignment to the trigger. Default `start`. */
+    align?: PositionerProps['align'];
+    /** Distance from the trigger in px. Default 8 (`--size-px-2`). */
+    sideOffset?: PositionerProps['sideOffset'];
+    /** Offset along the alignment axis in px. Default 0. */
+    alignOffset?: PositionerProps['alignOffset'];
+    /** Clearance from the viewport edge in px before the panel shifts or flips. Default 16. */
+    collisionPadding?: PositionerProps['collisionPadding'];
+    /** The element the portal renders into. Default: `document.body`. */
+    container?: BasePopover.Portal.Props['container'];
+    /** Keeps the portal mounted while closed. */
+    keepMounted?: boolean;
+};
+/**
+ * The anchored panel, rendered in its Base UI Portal as a nested `white`
+ * scope: --primary1 face, --border-size-2 --primary12 frame, --ds-radius-8,
+ * 240–360 px wide from --md-n-above and the viewport less its margins
+ * below. It opens instantly or with a clip reveal from the trigger side.
+ * Render `PopoverArrow` inside it for the tail.
+ */
+export declare function PopoverPopup(props: PopoverPopupProps): React.JSX.Element;
+/** Props for PopoverArrow: Base UI Popover.Arrow props. */
+export type PopoverArrowProps = BasePopover.Arrow.Props;
+/**
+ * The tail: a --ds-space-12 × 6 px triangle filled with the face, its
+ * --border-size-2 --primary12 edge continuing the panel's frame.
+ */
+export declare function PopoverArrow(props: PopoverArrowProps): React.JSX.Element;
+/** Props for PopoverTitle: Base UI Popover.Title props. */
+export type PopoverTitleProps = BasePopover.Title.Props;
+/**
+ * The popover's heading (Base UI Popover.Title, an `h2`) and accessible
+ * name. In the `definition` kind it is the term, in tracked caps
+ * (`type-label`); in a panel, `type-subhead`.
+ */
+export declare function PopoverTitle(props: PopoverTitleProps): React.JSX.Element;
+/** Props for PopoverDescription: Base UI Popover.Description props. */
+export type PopoverDescriptionProps = BasePopover.Description.Props;
+/** The content or the definition (Base UI Popover.Description), in `type-body-ui` --primary12. */
+export declare function PopoverDescription(props: PopoverDescriptionProps): React.JSX.Element;
+/** Props for PopoverSource: `p` props and `render`. */
+export type PopoverSourceProps = useRender.ComponentProps<'p'>;
+/** A definition's source caption, in `type-caption` --role-muted. */
+export declare function PopoverSource(props: PopoverSourceProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for PopoverClose: Base UI Popover.Close props plus the X's accessible name. */
+export type PopoverCloseProps = BasePopover.Close.Props & {
+    /** The close X's accessible name, visually hidden. Default "Close". */
+    label?: string;
+};
+/**
+ * The optional close X, top end: an icon-only Button with the inline-tier
+ * `close` glyph and a --ds-size-hit target (§9.2). Pass `render` to close
+ * from another control instead; `label` is then ignored.
+ */
+export declare function PopoverClose(props: PopoverCloseProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Popover.d.ts.map

package/components/Popover/Popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"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"}

package/components/Popover/Popover.js

@@ -0,0 +1,131 @@
+'use client';
+import * as React from 'react';
+import { Popover as BasePopover } from '@base-ui/react/popover';
+import { useRender } from '@base-ui/react/use-render';
+import { mergeProps } from '@base-ui/react/merge-props';
+import { cva } from 'class-variance-authority';
+import { Button } from '../Button';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { cx, resolveClassName } from '../../utils/className';
+import { OVERLAY_COLLISION_PADDING, OVERLAY_SIDE_OFFSET, OverlayScope, OverlayTail, overlayActionClassName, overlayAttributes, overlayScales, } from '../../utils/overlay';
+import styles from './popover.module.css';
+/*
+ * Popover (§10.15): non-modal content anchored to a trigger.
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: popover.module.css; CVA function `popover`.
+ * - Axes: `kind` → panel | definition → `panel` (padded panel),
+ *   `definition` (term, definition and source) [D155]; `primary`,
+ *   `secondary` → scales module classes, applied inside the popup's scope.
+ * - Compound variants: none. Defaults: `kind: panel`; color axes: none.
+ * - Color fallback: the popup takes the `white` preset's defaults; props
+ *   apply inside it, and `secondary` drives only content accents.
+ * - States: Popup data-starting-style / data-ending-style → the clip reveal
+ *   from the trigger side (data-side), instant under --motionNotOK and on
+ *   data-instant [D91]; Arrow data-side → which edge the tail sits on;
+ *   Close is an icon-only Button (§9.2 states). The trigger's
+ *   data-popup-open belongs to the trigger's own module (Button).
+ * - Parts: positioner (the layer), base (the popup), arrow (the tail;
+ *   rendering it is the tail form), title (`term` in the definition kind),
+ *   description, source, close.
+ * - Scope: the popup renders in its Base UI Portal as a nested `white`
+ *   scope (`page` scheme, no data-theme) with the --border-size-2
+ *   --primary12 frame [D92, D139, D156].
+ * - Container: none; inherits its context.
+ */
+export const popover = cva(styles.base, {
+    variants: {
+        kind: {
+            panel: styles.panel,
+            definition: styles.definition,
+        },
+        // Color axes: never defaulted [D133]; PopoverPopup computes the overlay preset's defaults.
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+    defaultVariants: {
+        kind: 'panel',
+    },
+});
+const KindContext = React.createContext('panel');
+/** Groups the parts of a popover (Base UI Popover.Root). Esc or an outside press closes it. */
+export function Popover(props) {
+    return React.createElement(BasePopover.Root, { ...props });
+}
+/**
+ * Opens the popover on press, never on hover (§10.15). Renders a Button
+ * (§9.2); its data-popup-open shows the expanded state.
+ */
+export function PopoverTrigger(props) {
+    const { handle, payload, ...buttonProps } = props;
+    return (React.createElement(BasePopover.Trigger, { handle: handle, payload: payload, render: React.createElement(Button, { ...buttonProps }) }));
+}
+/**
+ * The anchored panel, rendered in its Base UI Portal as a nested `white`
+ * scope: --primary1 face, --border-size-2 --primary12 frame, --ds-radius-8,
+ * 240–360 px wide from --md-n-above and the viewport less its margins
+ * below. It opens instantly or with a clip reveal from the trigger side.
+ * Render `PopoverArrow` inside it for the tail.
+ */
+export function PopoverPopup(props) {
+    const { kind, primary, secondary, side, align = 'start', sideOffset = OVERLAY_SIDE_OFFSET, alignOffset, collisionPadding = OVERLAY_COLLISION_PADDING, container, keepMounted, className, children, ...rest } = props;
+    const scales = overlayScales(primary, secondary);
+    return (React.createElement(BasePopover.Portal, { container: container, keepMounted: keepMounted },
+        React.createElement(BasePopover.Positioner, { className: styles.positioner, side: side, align: align, sideOffset: sideOffset, alignOffset: alignOffset, collisionPadding: collisionPadding },
+            React.createElement(BasePopover.Popup, { ...rest, ...overlayAttributes, className: resolveClassName(className, (extra) => popover({
+                    kind,
+                    primary: scales.primary,
+                    secondary: scales.secondary,
+                    className: cx(overlayActionClassName, extra),
+                })) },
+                React.createElement(KindContext.Provider, { value: kind ?? 'panel' },
+                    React.createElement(OverlayScope, null, children))))));
+}
+/**
+ * The tail: a --ds-space-12 × 6 px triangle filled with the face, its
+ * --border-size-2 --primary12 edge continuing the panel's frame.
+ */
+export function PopoverArrow(props) {
+    const { className, ...rest } = props;
+    return (React.createElement(BasePopover.Arrow, { ...rest, className: resolveClassName(className, (extra) => cx(styles.arrow, extra)) },
+        React.createElement(OverlayTail, { className: styles.tail })));
+}
+/**
+ * The popover's heading (Base UI Popover.Title, an `h2`) and accessible
+ * name. In the `definition` kind it is the term, in tracked caps
+ * (`type-label`); in a panel, `type-subhead`.
+ */
+export function PopoverTitle(props) {
+    const { className, ...rest } = props;
+    const kind = React.useContext(KindContext);
+    const part = kind === 'definition' ? styles.term : styles.title;
+    return (React.createElement(BasePopover.Title, { ...rest, className: resolveClassName(className, (extra) => cx(part, extra)) }));
+}
+/** The content or the definition (Base UI Popover.Description), in `type-body-ui` --primary12. */
+export function PopoverDescription(props) {
+    const { className, ...rest } = props;
+    return (React.createElement(BasePopover.Description, { ...rest, className: resolveClassName(className, (extra) => cx(styles.description, extra)) }));
+}
+/** A definition's source caption, in `type-caption` --role-muted. */
+export function PopoverSource(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'p',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.source, className) }, rest),
+    });
+}
+/**
+ * The optional close X, top end: an icon-only Button with the inline-tier
+ * `close` glyph and a --ds-size-hit target (§9.2). Pass `render` to close
+ * from another control instead; `label` is then ignored.
+ */
+export function PopoverClose(props) {
+    const { label = 'Close', render, className, children, ...rest } = props;
+    if (render) {
+        return (React.createElement(BasePopover.Close, { ...rest, className: className, render: render }, children));
+    }
+    return (React.createElement(BasePopover.Close, { ...rest, className: resolveClassName(className, (extra) => cx(styles.close, extra)), render: React.createElement(Button, { variant: "outline", iconOnly: true, icon: "close" }, label) }));
+}
+//# sourceMappingURL=Popover.js.map

package/components/Popover/Popover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"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"}

package/components/Popover/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Popover';
+//# sourceMappingURL=index.d.ts.map

package/components/Popover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/Popover/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/components/Popover/index.js

@@ -0,0 +1,2 @@
+export * from './Popover';
+//# sourceMappingURL=index.js.map

package/components/Popover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/Popover/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/components/Popover/popover.module.css

@@ -0,0 +1,194 @@
+/*
+ * Popover (§10.15). CVA function `popover` in Popover.tsx.
+ * Parts: positioner (the layer), base (the popup), arrow (the tail's box)
+ * and tail (its drawing), title, term (the title in the definition kind),
+ * description, source, close.
+ *
+ * The anchored overlay surface (§10.1): the `white` scope's --primary1 face,
+ * a --border-size-2 --primary12 frame in both modes, never --role-rule
+ * [D92, D156], --ds-radius-8, --size-px-2 from the trigger. No shadow, no
+ * backdrop. Motion is instant or a clip reveal from the trigger side, never
+ * a fade [D91]. Colors are role variables only; local custom properties
+ * carry dimensions only.
+ */
+
+/* Composition sits in top-level rules, outside the layers: Lightning CSS
+ * (Next.js with Turbopack) rejects `composes` inside @layer or any nesting.
+ * The composed classes keep their own layers. */
+.base {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.title {
+  composes: typeSubhead from '../../utils/type.module.css';
+}
+
+.term {
+  composes: typeLabel from '../../utils/type.module.css';
+}
+
+.description {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.source {
+  composes: typeCaption from '../../utils/type.module.css';
+}
+
+@layer base {
+  .positioner {
+    z-index: var(--layer-3);
+  }
+
+  /*
+   * Base: anchored, the viewport less its margins wide. The clip bleeds past
+   * the frame by the tail's depth, so the tail shows at rest and leads the
+   * reveal.
+   */
+  .base {
+    --popover-tail-inline: var(--ds-space-12);
+    --popover-tail-block: calc(var(--ds-space-12) / 2 + var(--border-size-2));
+    --popover-bleed: calc(-1 * var(--popover-tail-block));
+    --popover-clip-from: inset(var(--popover-bleed));
+
+    position: relative;
+    box-sizing: border-box;
+    inline-size: calc(100vw - 2 * var(--ds-space-margin));
+    border: var(--border-size-2) solid var(--primary12);
+    border-radius: var(--ds-radius-8);
+    background-color: var(--primary1);
+    color: var(--primary12);
+    clip-path: inset(var(--popover-bleed));
+  }
+
+  /* Content width, 240–360 px, when it fits. */
+  @media (min-width: 768px) {
+    .base {
+      inline-size: max-content;
+      min-inline-size: min(var(--size-px-13), calc(100vw - 2 * var(--ds-space-margin)));
+      max-inline-size: min(var(--ds-size-overlay-max), calc(100vw - 2 * var(--ds-space-margin)));
+    }
+  }
+
+  .title,
+  .term,
+  .description {
+    color: var(--primary12);
+  }
+
+  .source {
+    color: var(--role-muted);
+  }
+
+  /* The tail's box: 12 × 8, of which the last 2 px overlap the frame. */
+  .arrow {
+    display: flex;
+    inline-size: var(--popover-tail-inline);
+    block-size: var(--popover-tail-block);
+  }
+
+  .tail {
+    display: block;
+    inline-size: 100%;
+    block-size: 100%;
+    overflow: visible;
+    fill: var(--primary1);
+    stroke: var(--primary12);
+    stroke-width: var(--border-size-2);
+  }
+
+  @media (prefers-reduced-motion: no-preference) {
+    .base {
+      transition-property: clip-path;
+      transition-duration: var(--ds-duration-disclosure);
+      transition-timing-function: var(--ease-out-3);
+    }
+  }
+}
+
+@layer variants {
+  /*
+   * The close X (an icon-only Button) floats to the top end, so the title
+   * wraps beside its hit area. In this layer, above the Button's base
+   * margin reset, so the placement never depends on load order.
+   */
+  .close {
+    float: inline-end;
+    margin-block-start: calc(-1 * var(--size-px-2));
+    margin-inline: var(--size-px-2) calc(-1 * var(--size-px-2));
+  }
+
+  /* Panel: overlay surface with --size-px-3 padding. */
+  .panel {
+    padding: var(--size-px-3);
+  }
+
+  /* Definition: term, definition and source, stacked at tight gaps. */
+  .definition {
+    display: grid;
+    row-gap: var(--size-px-2);
+    padding: var(--size-px-3);
+  }
+}
+
+@layer states {
+  /* The reveal starts at the trigger edge (data-side names where the panel sits). */
+  .base[data-side='bottom'] {
+    --popover-clip-from: inset(var(--popover-bleed) var(--popover-bleed) 100% var(--popover-bleed));
+  }
+
+  .base[data-side='top'] {
+    --popover-clip-from: inset(100% var(--popover-bleed) var(--popover-bleed) var(--popover-bleed));
+  }
+
+  .base[data-side='left'],
+  .base[data-side='inline-start'] {
+    --popover-clip-from: inset(var(--popover-bleed) var(--popover-bleed) var(--popover-bleed) 100%);
+  }
+
+  .base[data-side='right'],
+  .base[data-side='inline-end'] {
+    --popover-clip-from: inset(var(--popover-bleed) 100% var(--popover-bleed) var(--popover-bleed));
+  }
+
+  .base[data-starting-style],
+  .base[data-ending-style] {
+    clip-path: var(--popover-clip-from);
+  }
+
+  .base[data-instant] {
+    transition: none;
+  }
+
+  /* The tail sits on the edge facing the trigger and points at it. */
+  .arrow[data-side='bottom'] {
+    inset-block-start: calc(-1 * var(--popover-tail-block));
+  }
+
+  .arrow[data-side='top'] {
+    inset-block-end: calc(-1 * var(--popover-tail-block));
+    rotate: 180deg;
+  }
+
+  .arrow[data-side='left'],
+  .arrow[data-side='inline-start'] {
+    inset-inline-end: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: 90deg;
+  }
+
+  .arrow[data-side='right'],
+  .arrow[data-side='inline-end'] {
+    inset-inline-start: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: -90deg;
+  }
+}
+
+@layer print {
+  @media print {
+    /* Hidden; a definition's text prints as a footnote to its term (§8). */
+    .positioner,
+    .base {
+      display: none;
+    }
+  }
+}

package/components/PreviewCard/PreviewCard.d.ts

@@ -0,0 +1,83 @@
+import * as React from 'react';
+import { PreviewCard as BasePreviewCard } from '@base-ui/react/preview-card';
+import { useRender } from '@base-ui/react/use-render';
+import { type VariantProps } from 'class-variance-authority';
+import { type LinkProps } from '../Link';
+export declare const previewCard: (props?: ({
+    primary?: "ruby" | "brown" | "crimson" | "gold" | "gray" | "indigo" | "olive" | "pink" | "plum" | "purple" | "red" | "tomato" | "violet" | "bronze" | "iris" | "mauve" | "sage" | "sand" | "slate" | null | undefined;
+    secondary?: "ruby" | "blue" | "brown" | "crimson" | "cyan" | "gold" | "gray" | "green" | "indigo" | "lime" | "olive" | "orange" | "pink" | "plum" | "purple" | "red" | "teal" | "tomato" | "violet" | "yellow" | "amber" | "bronze" | "grass" | "iris" | "jade" | "mauve" | "mint" | "sage" | "sand" | "sky" | "slate" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type PreviewCardVariants = VariantProps<typeof previewCard>;
+/** Props for PreviewCard: Base UI PreviewCard.Root props (`open`, `onOpenChange` …). */
+export type PreviewCardProps<Payload = unknown> = BasePreviewCard.Root.Props<Payload>;
+/** Groups the parts of a preview card (Base UI PreviewCard.Root). */
+export declare function PreviewCard<Payload = unknown>(props: PreviewCardProps<Payload>): React.JSX.Element;
+/** Props for PreviewCardTrigger: Link props plus the hover delays and Base UI's trigger options. */
+export type PreviewCardTriggerProps = LinkProps & {
+    /** Hover time before the card opens, in ms. Default 600. */
+    delay?: number;
+    /** Time after the pointer leaves before the card closes, in ms. Default 300. */
+    closeDelay?: number;
+    /** Associates a detached trigger with a PreviewCard created by `PreviewCard.createHandle`. */
+    handle?: BasePreviewCard.Trigger.Props['handle'];
+    /** A payload handed to the PreviewCard's children function when this trigger opens it. */
+    payload?: unknown;
+};
+/**
+ * The link that opens the card on hover. Renders a Link (§9.3), `inline`
+ * by default, so it navigates and prints like any link [D79]. The card is
+ * never the only route to its information.
+ */
+export declare function PreviewCardTrigger(props: PreviewCardTriggerProps): React.JSX.Element;
+type PositionerProps = BasePreviewCard.Positioner.Props;
+/** Props for PreviewCardPopup: Base UI PreviewCard.Popup props plus placement, color axes and portal options. */
+export type PreviewCardPopupProps = BasePreviewCard.Popup.Props & {
+    /** Primary Radix scale inside the popup's `white` scope. Omitted, the white preset's default [D133]. */
+    primary?: PreviewCardVariants['primary'];
+    /** Secondary Radix scale inside the popup: accents only. */
+    secondary?: PreviewCardVariants['secondary'];
+    /** Which side of the link the card sits on. Default `bottom`; it flips when there is no room. */
+    side?: PositionerProps['side'];
+    /** Alignment to the link. Default `start`. */
+    align?: PositionerProps['align'];
+    /** Distance from the link in px. Default 8 (`--size-px-2`). */
+    sideOffset?: PositionerProps['sideOffset'];
+    /** Clearance from the viewport edge in px. Default 16. */
+    collisionPadding?: PositionerProps['collisionPadding'];
+    /** The element the portal renders into. Default: `document.body`. */
+    container?: BasePreviewCard.Portal.Props['container'];
+};
+/**
+ * The preview panel, rendered in its Base UI Portal as a nested `white`
+ * scope: --primary1 face, --border-size-2 --primary12 frame, --ds-radius-8,
+ * 240–360 px wide. Compose `PreviewCardThumb`, `PreviewCardTitle`,
+ * `PreviewCardDescription` and `PreviewCardDomain` inside it, and
+ * `PreviewCardArrow` for the tail. It holds at most one link.
+ */
+export declare function PreviewCardPopup(props: PreviewCardPopupProps): React.JSX.Element;
+/** Props for PreviewCardArrow: Base UI PreviewCard.Arrow props. */
+export type PreviewCardArrowProps = BasePreviewCard.Arrow.Props;
+/** The tail: a --ds-space-12 × 6 px triangle whose --border-size-2 edge continues the frame. */
+export declare function PreviewCardArrow(props: PreviewCardArrowProps): React.JSX.Element;
+/** Props for PreviewCardThumb: `img` props and `render`. */
+export type PreviewCardThumbProps = useRender.ComponentProps<'img'>;
+/**
+ * The page's thumbnail: a --ratio-widescreen photograph with the nested
+ * radius (--ds-radius-8 − --size-px-3, floored at --radius-1) [D40].
+ * Give it `alt` (empty when the title already names it).
+ */
+export declare function PreviewCardThumb(props: PreviewCardThumbProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for PreviewCardTitle: `p` props and `render`. */
+export type PreviewCardTitleProps = useRender.ComponentProps<'p'>;
+/** The linked page's title, in `type-itemhead` --primary12. */
+export declare function PreviewCardTitle(props: PreviewCardTitleProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for PreviewCardDescription: `p` props and `render`. */
+export type PreviewCardDescriptionProps = useRender.ComponentProps<'p'>;
+/** A one-line description, in `type-body-ui` --primary12. */
+export declare function PreviewCardDescription(props: PreviewCardDescriptionProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for PreviewCardDomain: `p` props and `render`. */
+export type PreviewCardDomainProps = useRender.ComponentProps<'p'>;
+/** The page's domain, in `type-data` --role-muted (mono measures). */
+export declare function PreviewCardDomain(props: PreviewCardDomainProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export {};
+//# sourceMappingURL=PreviewCard.d.ts.map

package/components/PreviewCard/PreviewCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewCard.d.ts","sourceRoot":"","sources":["../../src/components/PreviewCard/PreviewCard.tsx"],"names":[],"mappings":"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"}