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

package/overlays/menubar/menubar.module.css

@@ -0,0 +1,124 @@
+/*
+ * Menubar (§9.7). CVA function `menubar` in Menubar.tsx.
+ * Parts: base (the bar and its rule), trigger. The popups are Menu popups
+ * (menu.module.css): portaled `white` scopes that never change with the bar.
+ *
+ * A --fgd-size-hit bar with a --border-size-1 --role-rule on its content
+ * side; `type-button-sm` triggers, authored in title case with no tracking
+ * [D160, D165], at --size-px-5 inline padding. The open trigger takes the
+ * --border-size-2-25 bar in --primary12, never a fill alone. 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. */
+.trigger {
+  composes: typeButtonSm from '../../utils/type.module.css';
+}
+
+@layer base {
+  .base {
+    display: flex;
+    align-items: stretch;
+    min-block-size: var(--fgd-size-hit);
+    border-block-end: var(--border-size-1) solid var(--role-rule);
+    color: var(--primary12);
+  }
+
+  .trigger {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    min-block-size: var(--fgd-size-hit);
+    margin: 0;
+    padding-block: 0;
+    padding-inline: var(--size-px-5);
+    border: 0;
+    background: none;
+    color: var(--primary12);
+    white-space: nowrap;
+    text-decoration-thickness: var(--border-size-1-5);
+    text-underline-offset: 0.15em;
+    appearance: none;
+  }
+
+  /* Hover transition [D181]: --fgd-duration-quick, --ease-out-3; instant under --motionNotOK. */
+  @media (prefers-reduced-motion: no-preference) {
+    .trigger {
+      transition-property: color, text-decoration-color;
+      transition-duration: var(--fgd-duration-quick);
+      transition-timing-function: var(--ease-out-3);
+    }
+  }
+
+  /* The open bar: sits on the bar's rule, like a current tab. */
+  .trigger::after {
+    content: '';
+    position: absolute;
+    inset-inline: 0;
+    inset-block-end: calc(-1 * var(--border-size-1));
+    display: none;
+    border-block-end: var(--border-size-2-25) solid var(--primary12);
+  }
+}
+
+@layer states {
+  /* Vertical: the rule and the open bar move to the inline end. */
+  .base[data-orientation='vertical'] {
+    flex-direction: column;
+    align-items: stretch;
+    border-block-end-width: 0;
+    border-inline-end: var(--border-size-1) solid var(--role-rule);
+  }
+
+  .base[data-orientation='vertical'] .trigger::after {
+    inset-block: 0;
+    inset-inline: auto calc(-1 * var(--border-size-1));
+    border-block-end-width: 0;
+    border-inline-end: var(--border-size-2-25) solid var(--primary12);
+  }
+
+  /*
+   * Hover (not disabled): the §9.2 `text` Button hover [D181]. The label
+   * takes --role-link-hover, underlined in --role-accent only where that
+   * ink is --primary12 (--fgd-link-hover-line); forced colors add the
+   * underline. The open bar, not the hover, marks an open menu.
+   */
+  .trigger:not([data-disabled]):hover {
+    color: var(--role-link-hover);
+    text-decoration-line: var(--fgd-link-hover-line);
+    text-decoration-color: var(--role-accent);
+  }
+
+  @media (forced-colors: active) {
+    .trigger:not([data-disabled]):hover {
+      text-decoration-line: underline;
+    }
+  }
+
+  .trigger[data-popup-open]::after {
+    display: block;
+  }
+
+  /* Focus: the 2 px --primary12 ring at a 2 px offset, drawn above its neighbours. */
+  .trigger:focus-visible {
+    z-index: 1;
+    outline: var(--fgd-focus-width) solid var(--primary12);
+    outline-offset: var(--fgd-focus-offset);
+  }
+
+  .trigger[data-disabled] {
+    color: var(--role-muted);
+    cursor: default;
+  }
+}
+
+@layer print {
+  @media print {
+    /* Interactive only: hidden. */
+    .base {
+      display: none;
+    }
+  }
+}

package/overlays/popover/Popover.d.ts

@@ -0,0 +1,110 @@
+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` …) plus the outline morph. */
+export type PopoverProps<Payload = unknown> = BasePopover.Root.Props<Payload> & {
+    /**
+     * The outline morph: the trigger's focus ring (or, opened by pointer, its
+     * edge) grows into the panel's frame as it opens and shrinks back as it
+     * closes; a tail (PopoverArrow) grows out of the frame's edge as it lands.
+     * A hover open is instant. Instant under reduced motion; off in forced colors and
+     * print, and wherever `--fgd-outline-morph: none` applies. Default
+     * `true`; `false` opens and closes the panel at once.
+     */
+    morph?: boolean;
+};
+/**
+ * Groups the parts of a popover (Base UI Popover.Root) and wires its
+ * outline morph. 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, --radius-2-25,
+ * 240–360 px wide from --md-n-above and the viewport less its margins
+ * below. It opens from its trigger by the outline morph, or at once.
+ * 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 --size-px-2-5 × 6 px triangle filled with the face, its
+ * --border-size-2 --primary12 edge continuing the panel's frame. With the
+ * outline morph it grows out of the frame's edge as the panel lands.
+ */
+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 --fgd-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,166 @@
+'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 { OutlineMorphFrame, OutlineMorphTail, } from '../../foundations/outline-morph';
+import { HOVER_REASONS, useOutlineMorphRoot, } from '../../foundations/outline-morph/useOutlineMorphRoot';
+import { useMergedRef } from '../../utils/assignRef';
+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: the popup opens and closes by the outline morph or at once, no
+ *   reveal of its own [D205]; 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.
+ * - Outline morph [D204]: on by default (`morph={false}` on Popover opts
+ *   out). The trigger's ring (keyboard) or edge (pointer) grows into the
+ *   panel's frame and back (foundations/outline-morph); PopoverTrigger
+ *   takes the source ref, the popup answers `data-outline-morph` and the
+ *   frame renders beside it. With a PopoverArrow, the tail rides the morph:
+ *   PopoverArrow is the tail source, and the tail cap (OutlineMorphTail,
+ *   `tailCap`) grows out of the frame's trigger-facing edge as it lands and
+ *   retracts into it on close, while the popup's own tail is held hidden.
+ *   Hover opens (`openOnHover`) are instant.
+ */
+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');
+/** The popover's outline morph refs, or `null` with `morph={false}` [D204]. */
+const MorphContext = React.createContext(null);
+/**
+ * Groups the parts of a popover (Base UI Popover.Root) and wires its
+ * outline morph. Esc or an outside press closes it.
+ */
+export function Popover(props) {
+    const { morph = true, onOpenChange, ...rootProps } = props;
+    const outline = useOutlineMorphRoot({
+        open: rootProps.open,
+        defaultOpen: rootProps.defaultOpen,
+        onOpenChange,
+        morph,
+        instant: (_open, details) => details.reason != null && HOVER_REASONS.has(details.reason),
+    });
+    return (React.createElement(MorphContext.Provider, { value: outline.refs },
+        React.createElement(BasePopover.Root, { ...rootProps, onOpenChange: outline.onOpenChange })));
+}
+/**
+ * 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;
+    const morph = React.useContext(MorphContext);
+    return (React.createElement(BasePopover.Trigger, { ref: morph?.sourceRef, 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, --radius-2-25,
+ * 240–360 px wide from --md-n-above and the viewport less its margins
+ * below. It opens from its trigger by the outline morph, or at once.
+ * 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, ref, ...rest } = props;
+    const scales = overlayScales(primary, secondary);
+    const morph = React.useContext(MorphContext);
+    const popupRef = useMergedRef(ref, morph?.targetRef);
+    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, ref: popupRef, ...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))),
+            morph ? React.createElement(OutlineMorphFrame, { ref: morph.frameRef }) : null,
+            morph ? (React.createElement(OutlineMorphTail, { ref: morph.tailRef, className: styles.tailCap },
+                React.createElement(OverlayTail, { className: styles.tail }))) : null)));
+}
+/**
+ * The tail: a --size-px-2-5 × 6 px triangle filled with the face, its
+ * --border-size-2 --primary12 edge continuing the panel's frame. With the
+ * outline morph it grows out of the frame's edge as the panel lands.
+ */
+export function PopoverArrow(props) {
+    const { className, ref, ...rest } = props;
+    // The tail source of the outline morph's tail cap [D204].
+    const morph = React.useContext(MorphContext);
+    const arrowRef = useMergedRef(ref, morph?.tailSourceRef);
+    return (React.createElement(BasePopover.Arrow, { ...rest, ref: arrowRef, 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 --fgd-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/popover/popover.module.css

@@ -0,0 +1,220 @@
+/*
+ * 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), tailCap (the outline morph's copy of the tail),
+ * 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], --radius-2-25, --size-px-2 from the trigger. No shadow, no
+ * backdrop. Motion is the outline morph (the popup answers
+ * `data-outline-morph`; its tail grows out of the frame's edge through the
+ * tail cap) [D204] or none: the panel opens and closes at once, never a
+ * fade [D205]. 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 {
+  /* The tail's dimensions live on the layer, so the popup's tail and the morph's tail cap share them. */
+  .positioner {
+    --popover-tail-inline: var(--size-px-2-5);
+    --popover-tail-block: calc(var(--size-px-2-5) / 2 + var(--border-size-2));
+
+    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.
+   */
+  .base {
+    --popover-bleed: calc(-1 * var(--popover-tail-block));
+
+    position: relative;
+    box-sizing: border-box;
+    inline-size: calc(100vw - 2 * var(--fgd-space-margin));
+    border: var(--border-size-2) solid var(--primary12);
+    border-radius: var(--radius-2-25);
+    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(--fgd-space-margin)));
+      max-inline-size: min(var(--fgd-size-overlay-max), calc(100vw - 2 * var(--fgd-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);
+  }
+
+  /*
+   * The outline morph's tail cap (OutlineMorphTail) [D204]: the tail's box,
+   * placed on the popup's tail by the engine, drawn with the popup's face
+   * and the frame's color (currentColor), which the morph animates.
+   */
+  .tailCap {
+    inline-size: var(--popover-tail-inline);
+    block-size: var(--popover-tail-block);
+  }
+
+  .tailCap .tail {
+    fill: var(--fgd-outline-morph-tail-fill);
+    stroke: currentColor;
+  }
+
+}
+
+@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 {
+  /*
+   * Outline morph [D204] (Popover's `morph`, the default): while the
+   * overlay draws the frame, the popup's own edge takes its face and its
+   * own transitions stay off. The popup's tail is held hidden meanwhile (a
+   * discrete hold, D196): the tail cap stands in for it above the frame,
+   * growing out of the frame's edge, and the tail shows again on the same
+   * pixels as the cap goes.
+   */
+  .base[data-outline-morph] {
+    border-color: var(--primary1);
+    transition: none;
+  }
+
+  .base[data-outline-morph] .arrow {
+    visibility: hidden;
+  }
+
+  /* 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;
+  }
+
+  /* The physical sides place the tail physically, so it faces the trigger on a right-to-left page too. */
+  .arrow[data-side='left'] {
+    right: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: 90deg;
+  }
+
+  .arrow[data-side='right'] {
+    left: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: -90deg;
+  }
+
+  .arrow[data-side='inline-start'] {
+    inset-inline-end: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: 90deg;
+  }
+
+  .arrow[data-side='inline-end'] {
+    inset-inline-start: calc(-1 * (var(--popover-tail-inline) + var(--popover-tail-block)) / 2);
+    rotate: -90deg;
+  }
+
+
+  /* The tail cap turns as the tail does; the engine places it. */
+  .tailCap[data-side='top'] {
+    rotate: 180deg;
+  }
+
+  .tailCap[data-side='left'],
+  .tailCap[data-side='inline-start'] {
+    rotate: 90deg;
+  }
+
+  .tailCap[data-side='right'],
+  .tailCap[data-side='inline-end'] {
+    rotate: -90deg;
+  }
+
+}
+
+@layer print {
+  @media print {
+    /* Hidden; a definition's text prints as a footnote to its term (§8). */
+    .positioner,
+    .base {
+      display: none;
+    }
+  }
+}