@fairgarden/design 0.1.0-0.canary.0

package/page/hero/index.d.ts

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

package/page/hero/index.d.ts.map

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

package/page/hero/index.js

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

package/page/hero/index.js.map

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

package/page/marquee/Marquee.d.ts

@@ -0,0 +1,65 @@
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+export declare const marquee: (props?: ({
+    kind?: "static" | "ticker" | null | undefined;
+    fielded?: boolean | null | undefined;
+    hanging?: 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 MarqueeVariants = VariantProps<typeof marquee>;
+/** The fields a marquee may sit in [D180]: `forest` (default), `leaf` or `amber`, within their rations. */
+export type MarqueeField = 'forest' | 'leaf' | 'amber';
+interface MarqueeCommonProps extends Omit<React.ComponentPropsWithRef<'section'>, 'children'> {
+    /** The section's accessible name, e.g. "What we stand for". */
+    label: string;
+    /**
+     * The phrases, each shown whole, separated by dots. Short brand phrases
+     * or social proof, never facts a reader needs; ≤ 2 lines at base.
+     */
+    phrases: readonly string[];
+    /**
+     * An optional hanging drawing (an `aria-hidden` SVG at `--fgd-size-art-l`,
+     * `--fgd-size-art-s` below `--md-n-above`): `--primary12` lines
+     * (`currentColor`) and `--role-halo` fills. It tucks under the field's
+     * bottom edge and hangs into the page ground below.
+     */
+    drawing?: React.ReactNode;
+    /**
+     * Primary Radix scale: the phrases, dots and rules. Never defaulted;
+     * omitted, it inherits the scope or the field's defaults [D133].
+     */
+    primary?: MarqueeVariants['primary'];
+    /** Secondary Radix scale: accepted for the shared contract; unused. Never defaulted. */
+    secondary?: MarqueeVariants['secondary'];
+}
+interface MarqueeStaticProps extends MarqueeCommonProps {
+    /**
+     * `static` (default): the phrases set once, centered, in a field or on
+     * the page ground. `ticker`: serif sentences on the page ground between
+     * two full-bleed rules.
+     */
+    kind?: 'static';
+    /**
+     * The phrases sit in a full-container field (default `true`); `false`
+     * runs them on the page ground [D180].
+     */
+    fielded?: boolean;
+    /** The field preset. Default `forest`. */
+    field?: MarqueeField;
+}
+interface MarqueeTickerProps extends MarqueeCommonProps {
+    kind: 'ticker';
+    fielded?: false;
+    field?: never;
+}
+/** Props for Marquee: `section` props, the label, phrases, kind, field and drawing, and the color axes. */
+export type MarqueeProps = MarqueeStaticProps | MarqueeTickerProps;
+/**
+ * The marquee band. It never scrolls, clips or animates [D169]: every
+ * phrase shows whole. In print the phrases print once, centered, between two
+ * 1.5 pt rules, and the field's fill drops.
+ */
+export declare function Marquee(props: MarqueeProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Marquee.d.ts.map

package/page/marquee/Marquee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Marquee.d.ts","sourceRoot":"","sources":["../../src/page/marquee/Marquee.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAsCjE,eAAO,MAAM,OAAO;;;;;;8EAoBlB,CAAA;AAEF,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,OAAO,CAAC,CAAA;AAEnD,2GAA2G;AAC3G,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD,UAAU,kBAAmB,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAC3F,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACpC,wFAAwF;IACxF,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAA;CACzC;AAED,UAAU,kBAAmB,SAAQ,kBAAkB;IACrD;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,YAAY,CAAA;CACrB;AAED,UAAU,kBAAmB,SAAQ,kBAAkB;IACrD,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,2GAA2G;AAC3G,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,CAAA;AAUlE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBA4D1C"}

package/page/marquee/Marquee.js

@@ -0,0 +1,87 @@
+'use client';
+import * as React from 'react';
+import { cva } from 'class-variance-authority';
+import { Ground } from '../../foundations/ground';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { useScopeAttributes } from '../../utils/scope';
+import styles from './marquee.module.css';
+/*
+ * Marquee (§11.12, the marquee band): a thin, loud scene divider of brand
+ * phrases, once per page. Static only [D169]: it never moves, so it has no
+ * motion control. By default the phrases sit in a full-container `forest`
+ * field; they may instead run on the page ground [D180].
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: marquee.module.css; CVA function `marquee` (the spec's
+ *   `marqueeBand`, named for the component).
+ * - Axes: `kind` → static | ticker → `static`, `ticker` (phrases, or the
+ *   quote ticker between rules); `fielded` → `fielded` (the phrases in a
+ *   full-container field; default for `static`, excluded for `ticker`)
+ *   [D180]; `hanging` → `hanging` (a hanging drawing, computed from the
+ *   `drawing` prop); `primary`, `secondary` → scales module classes.
+ * - Compound variants: none.
+ * - Defaults: kind static, fielded true (static only), hanging false; color
+ *   axes: none [D133].
+ * - Color fallback: inherits the scope, or the field preset's defaults.
+ *   Secondary drives nothing: the marquee is one ink on every preset.
+ * - States: none; it renders the same under every motion preference [D169].
+ * - Parts: base, container, field, run (with `marqueeText` or
+ *   `tickerText`, the run's type role), phrase, dot, drawing; the ticker's
+ *   `rule`s are the root's own full-bleed borders.
+ * - Scope: the root sits on its band's page ground. With `fielded`, `field`
+ *   is a `kind="field"` Ground (`forest` by default; `leaf` or `amber`
+ *   within their rations) with its radius and its `--primary12` edge in
+ *   `--role-edge` [D177, D178].
+ * - Container: none: a page-frame part. Place it full width in its band;
+ *   it sets its own `--fgd-container-content` container, and any responsive
+ *   change is a viewport rule [D163].
+ */
+export const marquee = cva(styles.base, {
+    variants: {
+        kind: {
+            static: styles.static,
+            ticker: styles.ticker,
+        },
+        fielded: {
+            true: styles.fielded,
+        },
+        hanging: {
+            true: styles.hanging,
+        },
+        // Color axes: never defaulted, so an omitted prop inherits the scope [D133].
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+    defaultVariants: {
+        kind: 'static',
+        hanging: false,
+    },
+});
+function Dot() {
+    return (React.createElement("svg", { className: styles.dot, viewBox: "0 0 2 2", "aria-hidden": "true", focusable: "false" },
+        React.createElement("circle", { cx: "1", cy: "1", r: "1" })));
+}
+/**
+ * The marquee band. It never scrolls, clips or animates [D169]: every
+ * phrase shows whole. In print the phrases print once, centered, between two
+ * 1.5 pt rules, and the field's fill drops.
+ */
+export function Marquee(props) {
+    const { kind, fielded: fieldedProp, field, label, phrases, drawing, primary, secondary, className, ...rest } = props;
+    const scope = useScopeAttributes();
+    const resolvedKind = kind ?? 'static';
+    const fielded = resolvedKind === 'static' && fieldedProp !== false;
+    const hanging = drawing != null;
+    const run = (React.createElement("p", { className: styles.run },
+        React.createElement("span", { className: resolvedKind === 'ticker' ? styles.tickerText : styles.marqueeText }, phrases.map((phrase, index) => (React.createElement(React.Fragment, { key: `${index}-${phrase}` },
+            index > 0 ? (React.createElement(React.Fragment, null,
+                ' ',
+                React.createElement(Dot, null),
+                ' ')) : null,
+            React.createElement("span", { className: styles.phrase }, phrase)))))));
+    return (React.createElement("section", { ...rest, ...scope, "aria-label": label, className: marquee({ kind: resolvedKind, fielded, hanging, primary, secondary, className }) },
+        React.createElement("div", { className: styles.container },
+            fielded ? (React.createElement(Ground, { kind: "field", preset: field ?? 'forest', render: React.createElement("div", null), className: styles.field }, run)) : (run),
+            hanging ? (React.createElement("div", { className: styles.drawing, "aria-hidden": "true" }, drawing)) : null)));
+}
+//# sourceMappingURL=Marquee.js.map

package/page/marquee/Marquee.js.map

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

package/page/marquee/index.d.ts

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

package/page/marquee/index.d.ts.map

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

package/page/marquee/index.js

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

package/page/marquee/index.js.map

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

package/page/marquee/marquee.module.css

@@ -0,0 +1,151 @@
+/*
+ * Marquee (§11.12, the marquee band). CVA function `marquee`. Static only
+ * [D169]: no animation, transition or motion rule exists here.
+ * Color roles (§11.12): field ground = the preset's, edge --role-edge (the
+ * field's --primary12) at --border-size-1 (Ground draws it); phrases and
+ * dots --primary12; ticker rules --role-rule; drawing lines --primary12
+ * with --role-halo fills (the drawing's own SVG). 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. */
+.marqueeText {
+  composes: typeMarquee from '../../utils/type.module.css';
+}
+
+.tickerText {
+  composes: typeBody from '../../utils/type.module.css';
+}
+
+@layer base {
+  .base {
+    --marquee-art: var(--fgd-size-art-s);
+
+    display: block;
+    color: var(--primary12);
+  }
+
+  /* The page-frame container: --fgd-container-content inside the page margins. */
+  .container {
+    box-sizing: content-box;
+    max-inline-size: var(--fgd-container-content);
+    margin-inline: auto;
+    padding-inline: var(--fgd-space-margin);
+  }
+
+  /* The run: --size-px-8 minimum, never clipped. */
+  .run {
+    display: flex;
+    align-items: center;
+    box-sizing: border-box;
+    min-block-size: var(--size-px-8);
+    margin: 0;
+    padding-block: var(--size-px-2);
+    color: var(--primary12);
+  }
+
+  .phrase {
+    overflow-wrap: break-word;
+  }
+
+  /* The separator: a solid --fgd-ornament-dot disc on the cap-height center, a word space each side. */
+  .dot {
+    display: inline-block;
+    inline-size: var(--fgd-ornament-dot);
+    block-size: var(--fgd-ornament-dot);
+    fill: currentColor;
+    vertical-align: calc(0.35em - var(--fgd-ornament-dot) / 2);
+  }
+
+  /* The drawing size steps between fixed art sizes, never fluid [D78]. */
+  @media (min-width: 768px) {
+    .base {
+      --marquee-art: var(--fgd-size-art-l);
+    }
+  }
+}
+
+@layer variants {
+  /*
+   * The full-container field: Ground draws the ground, the --radius-2-25 and
+   * the --primary12 edge; the run sets the height, so the field adds only
+   * inline padding. It stays above a hanging drawing.
+   */
+  .fielded .field {
+    position: relative;
+    z-index: 1;
+    padding-block: 0;
+    padding-inline: var(--size-px-3);
+  }
+
+  /* Static: the phrases set once, optically centered. */
+  .static .run {
+    justify-content: center;
+    text-align: center;
+  }
+
+  /* The quote ticker: serif italic sentences between two full-bleed --border-size-1 --role-rule rules. */
+  .ticker {
+    border-block: var(--border-size-1) solid var(--role-rule);
+  }
+
+  .tickerText {
+    font-style: italic;
+  }
+
+  /*
+   * The hanging drawing (band-hang): tucked under the field's bottom edge by
+   * a quarter of its height (20–35%), hanging into the page ground below
+   * at the container's end.
+   */
+  .hanging .container {
+    isolation: isolate;
+  }
+
+  .drawing {
+    position: relative;
+    z-index: 0;
+    display: flex;
+    justify-content: flex-end;
+    margin-block-start: calc(var(--marquee-art) * -0.25);
+    padding-inline-end: var(--size-px-7);
+    color: var(--primary12);
+    pointer-events: none;
+  }
+
+  .drawing > :where(svg, img) {
+    display: block;
+    inline-size: auto;
+    block-size: var(--marquee-art);
+  }
+}
+
+@layer print {
+  @media print {
+    /* The phrases once, centered, between two 1.5 pt rules; the field's fill and frame drop (§7.7). */
+    .ticker {
+      border-block: 0;
+    }
+
+    .fielded .field {
+      padding: 0;
+      border: 0;
+      border-radius: var(--radius-0);
+    }
+
+    .run {
+      justify-content: center;
+      border-block: var(--border-size-2) solid var(--primary12);
+      text-align: center;
+      break-inside: avoid;
+    }
+
+    /* The hanging drawing prints whole, in the flow before the next heading. */
+    .drawing {
+      margin-block-start: var(--size-px-3);
+      break-inside: avoid;
+    }
+  }
+}

package/page/newsletter/Newsletter.d.ts

@@ -0,0 +1,146 @@
+import * as React from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import type { Form as BaseForm } from '@base-ui/react/form';
+import { type VariantProps } from 'class-variance-authority';
+export declare const newsletter: (props?: ({
+    kind?: "inline" | "band" | "ruled" | "straddle" | null | undefined;
+    grained?: boolean | null | undefined;
+    reading?: 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;
+/** The status part (§1.5.4): success (green) or a server-failure warning (amber). */
+export declare const newsletterStatus: (props?: ({
+    status?: "warning" | "success" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type NewsletterVariants = VariantProps<typeof newsletter>;
+/** The result of a submission, shown in place. */
+export type NewsletterStatusKind = NonNullable<VariantProps<typeof newsletterStatus>['status']>;
+/** The values the form submits. */
+export interface NewsletterValues {
+    email: string;
+    postcode?: string;
+    consent?: boolean;
+}
+/** The campaign fields a `band` newsletter may sit in [D177, D180]. */
+export type NewsletterBandField = 'leaf' | 'amber';
+type HeadingLevel = 2 | 3 | 4;
+interface NewsletterCommonProps extends Omit<useRender.ComponentProps<'section'>, 'children' | 'onSubmit'> {
+    /**
+     * The heading: `type-itemhead` (inline, straddle, ruled) or `type-h2`
+     * in `--role-heading` (band). It names the section.
+     */
+    heading: React.ReactNode;
+    /** The heading level. Default `2`. */
+    headingLevel?: HeadingLevel;
+    /** A one-line pitch, `type-body-ui`, ≤ 2 lines. */
+    pitch?: React.ReactNode;
+    /**
+     * The legal or consent line, `type-small` at weight 600; links are Links,
+     * underlined at rest.
+     */
+    legal?: React.ReactNode;
+    /** The email field's visible label. Default "Email Address" (title case [D160]). */
+    emailLabel?: string;
+    /** A placeholder: an example only, never the label; end it with "…". */
+    emailPlaceholder?: string;
+    /** The error shown when the email is missing or malformed. */
+    emailError?: React.ReactNode;
+    /**
+     * Adds a postcode field (`true` labels it "Postcode"; a string is its
+     * label). It shares Email's row from 480 px of form width.
+     */
+    postcode?: boolean | string;
+    /** Adds an optional consent Checkbox with this label. */
+    consent?: React.ReactNode;
+    /**
+     * The submit's label (and the butted cell's accessible name), title case,
+     * untracked. Default "Subscribe".
+     */
+    submitLabel?: string;
+    /** The busy label, held at the rest width. Default "Sending…". */
+    busyLabel?: string;
+    /** While the submission is pending: the form is inert and `aria-busy`. */
+    busy?: boolean;
+    /**
+     * The result: `success` replaces the form with the ● glyph, "Subscribed"
+     * and `statusMessage`, and moves focus there; `warning` (a server
+     * failure) shows the ▲ glyph and `statusMessage` above the submit.
+     */
+    status?: NewsletterStatusKind;
+    /** The one sentence that goes with the status. */
+    statusMessage?: React.ReactNode;
+    /** The status word for success. Default "Subscribed". */
+    successTitle?: React.ReactNode;
+    /** Called with the values once the form validates. */
+    onSubscribe?: (values: NewsletterValues, details: BaseForm.SubmitEventDetails) => void;
+    /**
+     * The short URL printed in place of the form: "Subscribe at
+     * example.org/newsletter" (no protocol).
+     */
+    printUrl: string;
+    /** Primary Radix scale: text, field edges and focus rings. Never defaulted [D133]. */
+    primary?: NewsletterVariants['primary'];
+    /** Secondary Radix scale: the icon, band heading and link underlines. Never defaulted. */
+    secondary?: NewsletterVariants['secondary'];
+}
+interface NewsletterInlineProps extends NewsletterCommonProps {
+    /**
+     * `inline` (default): the footer form, icon → heading → pitch → a field
+     * with the butted 64 × 48 px submit cell. `straddle`: the `royal` card
+     * across the night band's seam. `band`: a large headline with field and
+     * pill, on the page ground or a campaign field. `ruled`: a ruled row of
+     * prompt, input and square submit cells.
+     */
+    kind?: 'inline';
+    /**
+     * The block-tier icon before the heading (an envelope), an `aria-hidden`
+     * SVG in `currentColor`, which takes `--role-accent`.
+     */
+    icon?: React.ReactNode;
+    grained?: never;
+    reading?: never;
+    field?: never;
+}
+interface NewsletterStraddleProps extends NewsletterCommonProps {
+    kind: 'straddle';
+    icon?: never;
+    /** The card takes grain, and its fields sit on `white` face plates. Default `false`. */
+    grained?: boolean;
+    /**
+     * Reference and editorial pages: from `--lg-n-above` the card aligns to
+     * the reading column's start edge and widens to the reading measure;
+     * scene pages keep `--size-sm`, centered [D187]. Default `false`.
+     */
+    reading?: boolean;
+    field?: never;
+}
+interface NewsletterBandProps extends NewsletterCommonProps {
+    kind: 'band';
+    icon?: never;
+    grained?: never;
+    reading?: never;
+    /** Sets the band in a campaign field (`leaf` or `amber`, the page's one campaign field). */
+    field?: NewsletterBandField;
+}
+interface NewsletterRuledProps extends NewsletterCommonProps {
+    kind: 'ruled';
+    icon?: never;
+    grained?: never;
+    reading?: never;
+    field?: never;
+}
+/**
+ * Props for Newsletter: `section` props, the kind (with its card options),
+ * the heading and copy, the fields, the submission state, the print URL and
+ * the color axes.
+ */
+export type NewsletterProps = NewsletterInlineProps | NewsletterStraddleProps | NewsletterBandProps | NewsletterRuledProps;
+/**
+ * The newsletter signup. At most one per page besides the footer block;
+ * when a page carries one, the footer shows only a link. In print it
+ * becomes one 0.75 pt box: the heading and "Subscribe at <printUrl>".
+ */
+export declare function Newsletter(props: NewsletterProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export {};
+//# sourceMappingURL=Newsletter.d.ts.map

package/page/newsletter/Newsletter.d.ts.map

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