@fairgarden/design 0.1.0-alpha.0

package/components/EmptyState/EmptyState.d.ts

@@ -0,0 +1,88 @@
+import * as React from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import { type VariantProps } from 'class-variance-authority';
+import { type StickerProps } from '../Sticker';
+export declare const emptyState: (props?: ({
+    kind?: "inline" | "framed" | "illustrated" | null | undefined;
+    filtered?: boolean | 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 EmptyStateVariants = VariantProps<typeof emptyState>;
+/** The three empty-state builds (§12.16). */
+export type EmptyStateKind = 'framed' | 'inline' | 'illustrated';
+/** Props for EmptyState: `div` props, `render`, the kind, `filtered` and the color axes. */
+export type EmptyStateProps = useRender.ComponentProps<'div'> & {
+    /**
+     * `framed` (default): a centered stack in a `line-dashed` frame (dashed
+     * means provisional: a place not yet filled). `inline`: one sentence in
+     * place of the content, no frame, inside dense panels. `illustrated`:
+     * framed, plus a §6.5 sticker (S size) in `EmptyStateDrawing`.
+     */
+    kind?: EmptyStateKind;
+    /**
+     * A filter caused it: the root becomes a polite status region
+     * (`role="status"`), and it is not printed (print the unfiltered list, or
+     * "No items" once). Name the filter and offer "Clear Filters". Default
+     * `false`.
+     */
+    filtered?: boolean;
+    /**
+     * Primary Radix scale: the frame, heading and text. Never defaulted;
+     * omitted, it inherits the scope [D133].
+     */
+    primary?: EmptyStateVariants['primary'];
+    /**
+     * Secondary Radix scale: only the trail ornament (`--role-accent`). Never
+     * defaulted.
+     */
+    secondary?: EmptyStateVariants['secondary'];
+};
+/**
+ * The empty state, rendered in place of a list or grid: an optional
+ * `EmptyStateDrawing` or `EmptyStateTrail` (one, never both), an
+ * `EmptyStateHeading`, an `EmptyStateText` and an `EmptyStateAction` (an
+ * outline Button, or the solid one when it is the page's main next step).
+ * Pass `role="status"` when it replaces dynamic results (automatic with
+ * `filtered`). Never set its text lighter than the scope's ink.
+ */
+export declare function EmptyState(props: EmptyStateProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for EmptyStateDrawing: `div` props, `render`, and the sticker's art (`viewBox`, `halo`, line art as children). */
+export type EmptyStateDrawingProps = Omit<useRender.ComponentProps<'div'>, 'children'> & Pick<StickerProps, 'viewBox' | 'halo' | 'children'>;
+/**
+ * The drawing (`illustrated`): a §6.5 Sticker at `--ds-size-art-s` with its
+ * halo, decorative (`aria-hidden`); the spot size `--size-px-9` below
+ * 360 px. Pass the asset's `viewBox`, its pre-expanded `halo` path and its
+ * line art as children. The sticker brings its own `white` scope, so it
+ * looks the same on every ground and ignores the empty state's props.
+ */
+export declare function EmptyStateDrawing(props: EmptyStateDrawingProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for EmptyStateTrail: `div` props and `render`; the trail itself is drawn. */
+export type EmptyStateTrailProps = Omit<useRender.ComponentProps<'div'>, 'children'>;
+/**
+ * The trail, the alternative to a drawing: the short-tail `ornament-trail`
+ * (utils/Ornament), from its origin circle to a `marker-terminal` that
+ * points down at the action, dashed in `--role-accent`, decorative. Hidden
+ * if it would touch type.
+ */
+export declare function EmptyStateTrail(props: EmptyStateTrailProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for EmptyStateHeading: heading props and `render` (default `<h3>`). */
+export type EmptyStateHeadingProps = useRender.ComponentProps<'h3'>;
+/** What is empty: `type-itemhead` in `--primary12`, centered. Renders `<h3>`. */
+export declare function EmptyStateHeading(props: EmptyStateHeadingProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for EmptyStateText: paragraph props and `render`. */
+export type EmptyStateTextProps = useRender.ComponentProps<'p'>;
+/**
+ * Why, and what to do next: `type-body-ui` in `--primary12`, at most 40ch.
+ * When a filter caused it, name the filter ("No events match 'Virtual'").
+ */
+export declare function EmptyStateText(props: EmptyStateTextProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for EmptyStateAction: `div` props and `render`. */
+export type EmptyStateActionProps = useRender.ComponentProps<'div'>;
+/**
+ * The next step: an outline Button (md), or the solid one when it is the
+ * page's main next step; "Clear Filters" after a filter (title case).
+ */
+export declare function EmptyStateAction(props: EmptyStateActionProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export {};
+//# sourceMappingURL=EmptyState.d.ts.map

package/components/EmptyState/EmptyState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../src/components/EmptyState/EmptyState.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAoCvD,eAAO,MAAM,UAAU;;;;;8EAkBrB,CAAA;AAEF,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,UAAU,CAAC,CAAA;AAEzD,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAA;AAEhE,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC9D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAA;CAC5C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,0EAoChD;AAED,2HAA2H;AAC3H,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GACpF,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,CAAA;AAErD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,0EAmB9D;AAED,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAA;AAEpF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,0EAe1D;AAED,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAAG,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAEnE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,0EAQ9D;AAED,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;AAE/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,0EAQxD;AAED,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,0EAQ5D"}

package/components/EmptyState/EmptyState.js

@@ -0,0 +1,161 @@
+'use client';
+import * as React from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import { mergeProps } from '@base-ui/react/merge-props';
+import { cva } from 'class-variance-authority';
+import { Sticker } from '../Sticker';
+import { OrnamentTrail } from '../../utils/Ornament';
+import { cx } from '../../utils/className';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { useScopeAttributes } from '../../utils/scope';
+import styles from './empty-state.module.css';
+/*
+ * Empty State (§12.16): a list, grid, search or collection with no items.
+ * It says what is empty and offers a next step; a sanctioned place for one
+ * ornament (P6). Not for errors (§10.20) or loading.
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: empty-state.module.css; CVA function `emptyState`.
+ * - Axes: `kind` → framed | inline | illustrated; `filtered` → `filtered`
+ *   (a filter caused it: a polite status region, and not printed);
+ *   `primary`, `secondary` → scales module classes.
+ * - Compound variants: none.
+ * - Defaults: kind framed, filtered false; color axes: none.
+ * - Color fallback: inherits the scope; the action Button brings its own
+ *   fallback (§9.2).
+ * - States: static; the action follows §9.2.
+ * - Parts: base, frame (the padded box; its dashed outline is the SVG
+ *   `frameLine` > `frameRect`, composing line-dashed), drawing (the §6.5
+ *   Sticker, S size), trail (the shared `ornament-trail`, short-tail shape,
+ *   utils/Ornament), heading, text, action. `drawing` and `trail` are
+ *   exclusive and rendered by content, with no axis [D38].
+ * - Scope: `drawing` renders the Sticker, which declares its own nested
+ *   `white` scope (a light island inside a field or the night band); the
+ *   module names none.
+ * - Container: `base` is the inline-size container (unnamed); the frame's
+ *   drawing-beside-text layout queries it. Baseline without support:
+ *   drawing above the text, with the viewport fallback of the side layout
+ *   from --lg-n-above. Threshold (§5.10.2): drawing beside the text from
+ *   1024, content capped at --size-sm and centered [D163].
+ */
+export const emptyState = cva(styles.base, {
+    variants: {
+        kind: {
+            framed: styles.framed,
+            inline: styles.inline,
+            illustrated: styles.illustrated,
+        },
+        filtered: {
+            true: styles.filtered,
+        },
+        // Color axes: never defaulted, so an omitted prop inherits the scope [D133].
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+    defaultVariants: {
+        kind: 'framed',
+        filtered: false,
+    },
+});
+/**
+ * The empty state, rendered in place of a list or grid: an optional
+ * `EmptyStateDrawing` or `EmptyStateTrail` (one, never both), an
+ * `EmptyStateHeading`, an `EmptyStateText` and an `EmptyStateAction` (an
+ * outline Button, or the solid one when it is the page's main next step).
+ * Pass `role="status"` when it replaces dynamic results (automatic with
+ * `filtered`). Never set its text lighter than the scope's ink.
+ */
+export function EmptyState(props) {
+    const { render, ref, className, kind = 'framed', filtered = false, primary, secondary, children, ...rest } = props;
+    const scope = useScopeAttributes();
+    return useRender({
+        defaultTagName: 'div',
+        render,
+        ref,
+        props: mergeProps({
+            ...scope,
+            ...(filtered ? { role: 'status' } : null),
+            className: emptyState({ kind, filtered, primary, secondary, className }),
+            children: (React.createElement("div", { className: styles.frame },
+                kind !== 'inline' ? (React.createElement("svg", { className: styles.frameLine, "aria-hidden": "true", focusable: "false" },
+                    React.createElement("rect", { className: styles.frameRect, width: "100%", height: "100%", rx: "8", ry: "8" }))) : null,
+                children)),
+        }, rest),
+    });
+}
+/**
+ * The drawing (`illustrated`): a §6.5 Sticker at `--ds-size-art-s` with its
+ * halo, decorative (`aria-hidden`); the spot size `--size-px-9` below
+ * 360 px. Pass the asset's `viewBox`, its pre-expanded `halo` path and its
+ * line art as children. The sticker brings its own `white` scope, so it
+ * looks the same on every ground and ignores the empty state's props.
+ */
+export function EmptyStateDrawing(props) {
+    const { render, ref, className, viewBox, halo, children, ...rest } = props;
+    return useRender({
+        defaultTagName: 'div',
+        render,
+        ref,
+        props: mergeProps({
+            'aria-hidden': true,
+            className: cx(styles.drawing, className),
+            children: (React.createElement(Sticker, { size: "s", viewBox: viewBox, halo: halo }, children)),
+        }, rest),
+    });
+}
+/**
+ * The trail, the alternative to a drawing: the short-tail `ornament-trail`
+ * (utils/Ornament), from its origin circle to a `marker-terminal` that
+ * points down at the action, dashed in `--role-accent`, decorative. Hidden
+ * if it would touch type.
+ */
+export function EmptyStateTrail(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'div',
+        render,
+        ref,
+        props: mergeProps({
+            'aria-hidden': true,
+            className: cx(styles.trail, className),
+            children: React.createElement(OrnamentTrail, { shape: "short-tail" }),
+        }, rest),
+    });
+}
+/** What is empty: `type-itemhead` in `--primary12`, centered. Renders `<h3>`. */
+export function EmptyStateHeading(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'h3',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.heading, className) }, rest),
+    });
+}
+/**
+ * Why, and what to do next: `type-body-ui` in `--primary12`, at most 40ch.
+ * When a filter caused it, name the filter ("No events match 'Virtual'").
+ */
+export function EmptyStateText(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'p',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.text, className) }, rest),
+    });
+}
+/**
+ * The next step: an outline Button (md), or the solid one when it is the
+ * page's main next step; "Clear Filters" after a filter (title case).
+ */
+export function EmptyStateAction(props) {
+    const { render, ref, className, ...rest } = props;
+    return useRender({
+        defaultTagName: 'div',
+        render,
+        ref,
+        props: mergeProps({ className: cx(styles.action, className) }, rest),
+    });
+}
+//# sourceMappingURL=EmptyState.js.map

package/components/EmptyState/EmptyState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyState.js","sourceRoot":"","sources":["../../src/components/EmptyState/EmptyState.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,OAAO,EAAqB,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,QAAQ;SACtB;QACD,6EAA6E;QAC7E,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;IACD,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC,CAAA;AAmCF;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EACJ,MAAM,EACN,GAAG,EACH,SAAS,EACT,IAAI,GAAG,QAAQ,EACf,QAAQ,GAAG,KAAK,EAChB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,GAAG,IAAI,EACR,GAAG,KAAK,CAAA;IACT,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAA;IAClC,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,KAAK;QACrB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CACf;YACE,GAAG,KAAK;YACR,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACzC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YACxE,QAAQ,EAAE,CACR,6BAAK,SAAS,EAAE,MAAM,CAAC,KAAK;gBACzB,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CACnB,6BAAK,SAAS,EAAE,MAAM,CAAC,SAAS,iBAAc,MAAM,EAAC,SAAS,EAAC,OAAO;oBACpE,8BAAM,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,EAAE,EAAC,GAAG,EAAC,EAAE,EAAC,GAAG,GAAG,CAC1E,CACP,CAAC,CAAC,CAAC,IAAI;gBACP,QAAQ,CACL,CACP;SACF,EACD,IAAI,CACL;KACF,CAAC,CAAA;AACJ,CAAC;AAMD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC1E,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,KAAK;QACrB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CACf;YACE,aAAa,EAAE,IAAI;YACnB,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;YACxC,QAAQ,EAAE,CACR,oBAAC,OAAO,IAAC,IAAI,EAAC,GAAG,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAC3C,QAAQ,CACD,CACX;SACF,EACD,IAAI,CACL;KACF,CAAC,CAAA;AACJ,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjD,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,KAAK;QACrB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CACf;YACE,aAAa,EAAE,IAAI;YACnB,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC;YACtC,QAAQ,EAAE,oBAAC,aAAa,IAAC,KAAK,EAAC,YAAY,GAAG;SAC/C,EACD,IAAI,CACL;KACF,CAAC,CAAA;AACJ,CAAC;AAKD,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjD,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,IAAI;QACpB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CAAO,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC;KAC5E,CAAC,CAAA;AACJ,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjD,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,GAAG;QACnB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CAAM,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC;KACxE,CAAC,CAAA;AACJ,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACjD,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,KAAK;QACrB,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC;KAC5E,CAAC,CAAA;AACJ,CAAC"}

package/components/EmptyState/empty-state.module.css

@@ -0,0 +1,244 @@
+/*
+ * Empty State (§12.16). The root `base` is the inline-size container
+ * (unnamed); the frame's layout queries it. Parts: base, frame (the padded
+ * box), frameLine / frameRect (the dashed outline, drawn in SVG so the
+ * dashes are exact [D36]), drawing (holds the §6.5 Sticker), trail (holds
+ * the shared ornament-trail), heading, text, action. Static. Colors are role
+ * variables only; local custom properties carry dimensions only:
+ *   --empty-state-pad   the frame padding (--ds-space-40; --size-px-5 below 360 px)
+ *   --empty-state-art   the drawing's fixed size (--ds-size-art-s; --size-px-9 below 360 px)
+ */
+
+/* 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. */
+.heading {
+  composes: typeItemhead from '../../utils/type.module.css';
+}
+
+.text {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+/* Provisional: --border-size-2, 5 on / 4 off, round caps [D66]; set on the SVG rect. */
+.frameRect {
+  composes: lineDashed from '../../utils/line.module.css';
+}
+
+@layer base {
+  .base {
+    --empty-state-pad: var(--ds-space-40);
+    --empty-state-art: var(--ds-size-art-s);
+
+    container-type: inline-size;
+    min-inline-size: 0;
+    margin: 0;
+    color: var(--primary12);
+  }
+
+  /* Baseline (§1.11.11): a centered stack, the drawing above the text. */
+  .frame {
+    position: relative;
+    display: grid;
+    justify-items: center;
+    padding: var(--empty-state-pad);
+    text-align: center;
+  }
+
+  /* The §4.7.4 provisional frame: line-dashed in --role-rule, --ds-radius-8, inset by
+     half its stroke so the whole line sits inside the box. */
+  .frameLine {
+    position: absolute;
+    inset: calc(var(--border-size-2) / 2);
+    inline-size: calc(100% - var(--border-size-2));
+    block-size: calc(100% - var(--border-size-2));
+    overflow: visible;
+    pointer-events: none;
+  }
+
+  .frameRect {
+    fill: none;
+    stroke: var(--role-rule);
+    rx: var(--ds-radius-8);
+    ry: var(--ds-radius-8);
+  }
+
+  /* Stack: drawing or trail → 24 → heading → 12 → text → 24 → action. */
+  .drawing {
+    position: relative;
+    inline-size: var(--empty-state-art);
+    block-size: var(--empty-state-art);
+    margin-block-end: var(--size-px-5);
+  }
+
+  .drawing > * {
+    display: block;
+    max-inline-size: 100%;
+    max-block-size: 100%;
+  }
+
+  /* The ornament-trail draws in --role-accent (--primary12 on the solid fields) itself. */
+  .trail {
+    position: relative;
+    margin-block-end: var(--size-px-5);
+    color: var(--role-accent);
+  }
+
+  .trail > svg {
+    display: block;
+  }
+
+  .heading {
+    position: relative;
+    margin: 0;
+    color: var(--primary12);
+  }
+
+  .text {
+    position: relative;
+    max-inline-size: 40ch;
+    margin: var(--ds-space-12) 0 0;
+    color: var(--primary12);
+  }
+
+  .action {
+    position: relative;
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: center;
+    gap: var(--ds-space-12);
+    margin-block-start: var(--size-px-5);
+  }
+
+  /* Stack guard [D73, D78]: tighter padding and the spot-size drawing, viewport first. */
+  @media (max-width: 359.98px) {
+    .base {
+      --empty-state-pad: var(--size-px-5);
+      --empty-state-art: var(--size-px-9);
+    }
+  }
+
+  @container (width < 360px) {
+    .frame {
+      --empty-state-pad: var(--size-px-5);
+      --empty-state-art: var(--size-px-9);
+    }
+  }
+}
+
+@layer variants {
+  /* Framed and illustrated share the dashed frame; illustrated adds the drawing. */
+  .framed .frame,
+  .illustrated .frame {
+    border-radius: var(--ds-radius-8);
+  }
+
+  /* Inline (Deno, fixed): one sentence in place of the content; no frame, no padding. */
+  .inline .frame {
+    justify-items: start;
+    padding: 0;
+    text-align: start;
+  }
+
+  .inline .text {
+    margin-block-start: 0;
+  }
+
+  .inline .action {
+    justify-content: flex-start;
+  }
+
+  /*
+   * Side layout: the drawing (4) beside the text (8), content capped at
+   * --size-sm and centered. Viewport fallback from --lg-n-above, then the
+   * container from 1024 px (§5.10.2).
+   */
+  @media (min-width: 1024px) {
+    .frame:has(> .drawing) {
+      grid-template-columns: var(--empty-state-art) minmax(0, calc(var(--size-sm) - var(--empty-state-art) - var(--size-px-5)));
+      justify-content: center;
+      justify-items: start;
+      column-gap: var(--size-px-5);
+      text-align: start;
+    }
+
+    .frame:has(> .drawing) > .drawing {
+      grid-row: 1 / span 3;
+      grid-column: 1;
+      margin-block-end: 0;
+    }
+
+    .frame:has(> .drawing) > :not(.drawing, .frameLine) {
+      grid-column: 2;
+    }
+
+    .frame:has(> .drawing) .action {
+      justify-content: flex-start;
+    }
+  }
+
+  @container (width < 1024px) {
+    .frame:has(> .drawing) {
+      grid-template-columns: none;
+      justify-items: center;
+      text-align: center;
+    }
+
+    .frame:has(> .drawing) > .drawing {
+      grid-row: auto;
+      grid-column: auto;
+      margin-block-end: var(--size-px-5);
+    }
+
+    .frame:has(> .drawing) > :not(.drawing, .frameLine) {
+      grid-column: auto;
+    }
+
+    .frame:has(> .drawing) .action {
+      justify-content: center;
+    }
+  }
+
+  @container (width >= 1024px) {
+    .frame:has(> .drawing) {
+      grid-template-columns: var(--empty-state-art) minmax(0, calc(var(--size-sm) - var(--empty-state-art) - var(--size-px-5)));
+      justify-content: center;
+      justify-items: start;
+      column-gap: var(--size-px-5);
+      text-align: start;
+    }
+
+    .frame:has(> .drawing) > .drawing {
+      grid-row: 1 / span 3;
+      grid-column: 1;
+      margin-block-end: 0;
+    }
+
+    .frame:has(> .drawing) > :not(.drawing, .frameLine) {
+      grid-column: 2;
+    }
+
+    .frame:has(> .drawing) .action {
+      justify-content: flex-start;
+    }
+  }
+}
+
+@layer print {
+  @media print {
+    /* The message prints inside the dashed frame (1.5 pt through --border-size-2's print
+       value); the drawing as line art at most 30 mm. Filter-caused states are not printed. */
+    .base {
+      break-inside: avoid;
+    }
+
+    .drawing {
+      max-inline-size: 30mm;
+      max-block-size: 30mm;
+    }
+
+    .filtered {
+      display: none;
+    }
+  }
+}

package/components/EmptyState/index.d.ts

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

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

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

package/components/EmptyState/index.js

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

package/components/EmptyState/index.js.map

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

package/components/FAQ/FAQ.d.ts

@@ -0,0 +1,90 @@
+import * as React from 'react';
+import { Accordion as BaseAccordion } from '@base-ui/react/accordion';
+import { useRender } from '@base-ui/react/use-render';
+import { type VariantProps } from 'class-variance-authority';
+import { type IconName } from '../Icon';
+export declare const faq: (props?: ({
+    kind?: "split" | "ruled" | "keyed" | null | undefined;
+    barred?: boolean | 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 FAQVariants = VariantProps<typeof faq>;
+/** Props for FAQ: `section` props, `render`, and the kind, bar and color axes. */
+export type FAQProps = useRender.ComponentProps<'section'> & {
+    /**
+     * `ruled` (default): bare rows between `--role-rule` rules. `keyed`: a
+     * leading block icon per row (`FAQItem icon`), answers indented to the
+     * question column. `split`: from 1024 px of viewport, header and intro in
+     * the left third and the list in the right two thirds.
+     */
+    kind?: FAQVariants['kind'];
+    /**
+     * Shows a `--ds-stroke-3` `--primary12` bar at the start of each open
+     * item's row: a bolder line, never a fill. Default `false`.
+     */
+    barred?: FAQVariants['barred'];
+    /**
+     * Primary Radix scale: rules, questions, glyph and answers. Never
+     * defaulted; omitted, it inherits the scope [D133].
+     */
+    primary?: FAQVariants['primary'];
+    /**
+     * Secondary Radix scale: only the link underlines inside answers and on
+     * the contact link (`--role-accent`). Never defaulted.
+     */
+    secondary?: FAQVariants['secondary'];
+};
+/**
+ * The FAQ module: `FAQHeader` (with `FAQTitle` and an optional `FAQIntro`),
+ * `FAQList` holding `FAQItem`s, and an optional closing `FAQContact`. Place
+ * it on light or deep grounds; on saturated grounds keep to five items with
+ * answers of 40 words or fewer. Every answer prints expanded.
+ */
+export declare function FAQ(props: FAQProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for FAQHeader: `header` props and `render`. */
+export type FAQHeaderProps = useRender.ComponentProps<'header'>;
+/** The module header: the chapter-stack title, then the optional intro (§3.5 Recipe A). */
+export declare function FAQHeader(props: FAQHeaderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for FAQTitle: heading props and `render` (default `<h2>`). */
+export type FAQTitleProps = useRender.ComponentProps<'h2'>;
+/** The section head: `type-h2` in `--role-heading`. Renders `<h2>`. */
+export declare function FAQTitle(props: FAQTitleProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for FAQIntro: paragraph props and `render`. */
+export type FAQIntroProps = useRender.ComponentProps<'p'>;
+/** An optional lede under the title, within `--ds-measure-reading`. */
+export declare function FAQIntro(props: FAQIntroProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for FAQContact: paragraph props and `render`. */
+export type FAQContactProps = useRender.ComponentProps<'p'>;
+/** The optional closing contact line, e.g. "Still stuck? Write to us." with a Link. */
+export declare function FAQContact(props: FAQContactProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Props for FAQList: Base UI Accordion Root props. */
+export type FAQListProps<Value = unknown> = BaseAccordion.Root.Props<Value>;
+/**
+ * The item list, a Base UI Accordion Root. Several items may be open at once
+ * (`multiple`, default `true`); closed answers stay in the DOM
+ * (`hiddenUntilFound`, default `true`) for find-in-page and print. Never
+ * open items by hover.
+ */
+export declare function FAQList<Value = unknown>(props: FAQListProps<Value>): React.JSX.Element;
+/** Props for FAQItem: Base UI Accordion Item props (without `disabled`) plus the question. */
+export type FAQItemProps = Omit<BaseAccordion.Item.Props, 'disabled' | 'title'> & {
+    /** The question: `type-itemhead` in `--primary12`, inside an `h3`. */
+    question: React.ReactNode;
+    /**
+     * The leading block icon of the `keyed` kind (§6.10 subject symbol,
+     * Material Symbols Rounded, block tier). Ignored by the other kinds.
+     */
+    icon?: IconName;
+    /** Props for the answer panel, such as `keepMounted`. */
+    panelProps?: Omit<BaseAccordion.Panel.Props, 'children'>;
+};
+/**
+ * One question and its answer. The question is an `h3` wrapping the trigger;
+ * the disclosure glyph trails it, top-aligned to its first line. The answer
+ * is `type-body`, within `--ds-measure-reading`. FAQ items are never
+ * disabled.
+ */
+export declare function FAQItem(props: FAQItemProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=FAQ.d.ts.map

package/components/FAQ/FAQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FAQ.d.ts","sourceRoot":"","sources":["../../src/components/FAQ/FAQ.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGjE,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAgC7C,eAAO,MAAM,GAAG;;;;;8EAkBd,CAAA;AAEF,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,GAAG,CAAC,CAAA;AAE3C,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG;IAC3D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;CACrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,0EAelC;AAED,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;AAE/D,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,0EAQ9C;AAED,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAE1D,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,0EAQ5C;AAED,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;AAEzD,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,0EAQ5C;AAED,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;AAE3D,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,0EAQhD;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAE3E;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,qBAUlE;AAED,8FAA8F;AAC9F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IAChF,sEAAsE;IACtE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,yDAAyD;IACzD,UAAU,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;CACzD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBAwB1C"}