@fairgarden/design 0.1.0-alpha.0 → 0.1.0-alpha.1

package/overlays/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 '../../actions/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/overlays/popover/Popover.d.ts.map

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

package/overlays/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 '../../actions/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/overlays/popover/Popover.js.map

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

package/overlays/popover/index.d.ts.map

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

package/overlays/popover/index.js.map

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

package/overlays/preview-card/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 '../../actions/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/overlays/preview-card/PreviewCard.d.ts.map

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

package/overlays/preview-card/PreviewCard.js

@@ -0,0 +1,123 @@
+'use client';
+import * as React from 'react';
+import { PreviewCard as BasePreviewCard } from '@base-ui/react/preview-card';
+import { useRender } from '@base-ui/react/use-render';
+import { mergeProps } from '@base-ui/react/merge-props';
+import { cva } from 'class-variance-authority';
+import { Link } from '../../actions/link';
+import { cx, resolveClassName } from '../../utils/className';
+import { OVERLAY_COLLISION_PADDING, OVERLAY_SIDE_OFFSET, OverlayScope, OverlayTail, overlayActionClassName, overlayAttributes, overlayScales, } from '../../utils/overlay';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import styles from './preview-card.module.css';
+/*
+ * Preview Card (§10.15): a hover preview of a linked page, for pointer
+ * users only. No case shows one; derived from P2, P7, [D79] and [D92].
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: preview-card.module.css; CVA function `previewCard`.
+ * - Axes: `primary`, `secondary` → scales module classes, applied inside
+ *   the popup's scope.
+ * - Compound variants: none. Defaults: none; color axes: none.
+ * - Color fallback: the popup takes the `white` preset's defaults.
+ * - 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 → the tail's edge. Opens after
+ *   600 ms of hover and closes 300 ms after leave.
+ * - Parts: positioner, base (the popup), arrow and tail, thumb, title,
+ *   description, domain.
+ * - 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. Shown only with hover and a
+ *   fine pointer; on touch the link simply navigates.
+ */
+export const previewCard = cva(styles.base, {
+    variants: {
+        // Color axes: never defaulted [D133]; PreviewCardPopup computes the overlay preset's defaults.
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+});
+/** Groups the parts of a preview card (Base UI PreviewCard.Root). */
+export function PreviewCard(props) {
+    return React.createElement(BasePreviewCard.Root, { ...props });
+}
+/**
+ * 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 function PreviewCardTrigger(props) {
+    const { delay = 600, closeDelay = 300, handle, payload, ...linkProps } = props;
+    return (React.createElement(BasePreviewCard.Trigger, { delay: delay, closeDelay: closeDelay, handle: handle, payload: payload, render: React.createElement(Link, { ...linkProps }) }));
+}
+/**
+ * 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 function PreviewCardPopup(props) {
+    const { primary, secondary, side, align = 'start', sideOffset = OVERLAY_SIDE_OFFSET, collisionPadding = OVERLAY_COLLISION_PADDING, container, className, children, ...rest } = props;
+    const scales = overlayScales(primary, secondary);
+    return (React.createElement(BasePreviewCard.Portal, { container: container },
+        React.createElement(BasePreviewCard.Positioner, { className: styles.positioner, side: side, align: align, sideOffset: sideOffset, collisionPadding: collisionPadding },
+            React.createElement(BasePreviewCard.Popup, { ...rest, ...overlayAttributes, className: resolveClassName(className, (extra) => previewCard({
+                    primary: scales.primary,
+                    secondary: scales.secondary,
+                    className: cx(overlayActionClassName, extra),
+                })) },
+                React.createElement(OverlayScope, null, children)))));
+}
+/** The tail: a --ds-space-12 × 6 px triangle whose --border-size-2 edge continues the frame. */
+export function PreviewCardArrow(props) {
+    const { className, ...rest } = props;
+    return (React.createElement(BasePreviewCard.Arrow, { ...rest, className: resolveClassName(className, (extra) => cx(styles.arrow, extra)) },
+        React.createElement(OverlayTail, { className: styles.tail })));
+}
+/**
+ * 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 function PreviewCardThumb(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'img',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.thumb, className) }, rest),
+    });
+}
+/** The linked page's title, in `type-itemhead` --primary12. */
+export function PreviewCardTitle(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'p',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.title, className) }, rest),
+    });
+}
+/** A one-line description, in `type-body-ui` --primary12. */
+export function PreviewCardDescription(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'p',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.description, className) }, rest),
+    });
+}
+/** The page's domain, in `type-data` --role-muted (mono measures). */
+export function PreviewCardDomain(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'p',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.domain, className) }, rest),
+    });
+}
+//# sourceMappingURL=PreviewCard.js.map

package/overlays/preview-card/PreviewCard.js.map

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

package/overlays/preview-card/index.d.ts.map

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

package/overlays/preview-card/index.js.map

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

package/overlays/tooltip/Tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../src/overlays/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAYjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA2BrD,eAAO,MAAM,OAAO;;;8EAKlB,CAAA;AAEF,eAAO,MAAM,cAAc;;8EAWzB,CAAA;AAEF,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,OAAO,CAAC,CAAA;AACnD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAEzF,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAK3B,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAwB,EAAE,GAAG,IAAI,EAAE,EAAE,oBAAoB,qBAM1F;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,CAAC,OAAO,GAAG,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,qBAEtE;AAED,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,CAAC,OAAO,GAAG,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG;IACxF;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,qBAyBpF;AAED,6FAA6F;AAC7F,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,GACrD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACrD;;;;OAIG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACpC,uEAAuE;IACvE,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAA;IACxC,yDAAyD;IACzD,WAAW,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;CACzD,CAAA;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,qBAkCpD"}

package/overlays/tooltip/Tooltip.js

@@ -0,0 +1,108 @@
+'use client';
+import * as React from 'react';
+import { Tooltip as BaseTooltip } from '@base-ui/react/tooltip';
+import { cva } from 'class-variance-authority';
+import { Icon } from '../../foundations/icon';
+import { resolveClassName } from '../../utils/className';
+import { OVERLAY_COLLISION_PADDING, OVERLAY_SIDE_OFFSET, OverlayScope, overlayAttributes, overlayScales, } from '../../utils/overlay';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { TOOLTIP_DELAY_MS } from '../../utils/tokens';
+import styles from './tooltip.module.css';
+/*
+ * Tooltip (§10.16): names an icon-only control, or gives a brief,
+ * non-essential hint. Never links, actions or required information.
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: tooltip.module.css; CVA functions `tooltip` (the popup) and
+ *   `tooltipTrigger` (the trigger's `hint` and `term` classes).
+ * - Axes: popup `primary`, `secondary` → scales module classes, applied
+ *   inside the popup's scope (`secondary` unused); trigger `kind` → label |
+ *   hint | term (which form the trigger takes).
+ * - Compound variants: none.
+ * - Defaults: trigger kind label; color axes: none.
+ * - Color fallback: the popup takes the overlay scope preset's defaults.
+ * - States: popup `data-open` / `data-closed` → appears instantly, never by
+ *   fade [D91]; `data-side`, `data-align` → placement; `data-instant` → no
+ *   delay between neighbors in one Provider. Trigger `:focus-visible` → ring.
+ * - Parts: base (the popup), text, positioner (its layer), hint, hintLabel,
+ *   term. No arrow by default.
+ * - Scope: `base` renders in its Base UI Portal and declares the overlay
+ *   scope (`white`, `page` scheme), which follows the root mode; it writes
+ *   no `data-theme`, and its edge is the [D92] overlay frame, never
+ *   --role-rule [D139, D156].
+ * - Container: none; inherits its context.
+ */
+export const tooltip = cva(styles.base, {
+    variants: {
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+});
+export const tooltipTrigger = cva('', {
+    variants: {
+        kind: {
+            label: '',
+            hint: styles.hint,
+            term: styles.term,
+        },
+    },
+    defaultVariants: {
+        kind: 'label',
+    },
+});
+/** The open delay, mirroring `--ds-delay-tooltip` (500 ms, §1.5.15) [D175]. */
+export { TOOLTIP_DELAY_MS };
+/** The open delay a TooltipProvider sets for the triggers inside it. */
+const TooltipDelayContext = React.createContext(undefined);
+/**
+ * Shares the open delay across a group of triggers, such as a toolbar: the
+ * first tooltip opens after `--ds-delay-tooltip` (500 ms), its neighbors
+ * open at once while one is showing.
+ */
+export function TooltipProvider({ delay = TOOLTIP_DELAY_MS, ...rest }) {
+    return (React.createElement(TooltipDelayContext.Provider, { value: delay },
+        React.createElement(BaseTooltip.Provider, { delay: delay, ...rest })));
+}
+/**
+ * One tooltip: a `TooltipTrigger` and a `TooltipPopup`. It opens on hover
+ * after 500 ms and on keyboard focus, appears instantly, stays open while the
+ * pointer moves onto it, and Esc dismisses it without moving focus. Touch
+ * screens never show it, so the trigger must make sense without it. It never
+ * prints: definitions behind terms must also exist as footnotes.
+ */
+export function Tooltip(props) {
+    return React.createElement(BaseTooltip.Root, { ...props });
+}
+/**
+ * The element the tooltip names. With `kind="label"`, pass the control as
+ * `render`, e.g. `render={<Button iconOnly icon="search">Search</Button>}`.
+ * The hint glyph and the term underline follow the trigger's own ground.
+ */
+export function TooltipTrigger(props) {
+    const { kind = 'label', delay, className, children, ...rest } = props;
+    const providerDelay = React.useContext(TooltipDelayContext);
+    const resolvedClassName = typeof className === 'function'
+        ? (state) => tooltipTrigger({ kind, className: className(state) }) || undefined
+        : tooltipTrigger({ kind, className }) || undefined;
+    return (React.createElement(BaseTooltip.Trigger, { ...rest, delay: delay ?? providerDelay ?? TOOLTIP_DELAY_MS, className: resolvedClassName }, kind === 'hint' ? (React.createElement(React.Fragment, null,
+        React.createElement(Icon, { name: "help", className: styles.hintIcon }),
+        React.createElement("span", { className: styles.hintLabel }, children))) : (children)));
+}
+/**
+ * The popup: one short line of `type-caption` (three at most), at most
+ * `--ds-size-tooltip` (280 px) wide, on the overlay scope's `--primary1` face inside a
+ * `--border-size-2` `--primary12` frame with `--radius-1`. It sits
+ * `--size-px-2` from the trigger (`side`, default `top`) and flips or shifts
+ * to stay inside the viewport.
+ */
+export function TooltipPopup(props) {
+    const { side = 'top', align = 'center', primary, secondary, portalProps, className, children, ...rest } = props;
+    const variants = overlayScales(primary, secondary);
+    const resolvedClassName = resolveClassName(className, (extra) => tooltip({ ...variants, className: extra }));
+    return (React.createElement(BaseTooltip.Portal, { ...portalProps },
+        React.createElement(BaseTooltip.Positioner, { className: styles.positioner, side: side, align: align, sideOffset: OVERLAY_SIDE_OFFSET, collisionPadding: OVERLAY_COLLISION_PADDING },
+            React.createElement(OverlayScope, null,
+                React.createElement(BaseTooltip.Popup, { ...rest, ...overlayAttributes, className: resolvedClassName },
+                    React.createElement("span", { className: styles.text }, children))))));
+}
+//# sourceMappingURL=Tooltip.js.map

package/overlays/tooltip/Tooltip.js.map

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

package/overlays/tooltip/index.d.ts.map

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

package/overlays/tooltip/index.js.map

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