@fairgarden/design 0.1.0-0.canary.0

package/forms/combobox/combobox.module.css

@@ -0,0 +1,511 @@
+/*
+ * Combobox (§10.6). CVA function `combobox`. Parts: `base` (the field box,
+ * Base UI's InputGroup), `input`, `icon`, `clear`, `trigger` (with
+ * `chevron`), `chips` and each removable `chip` (§10.11: the Chip module's
+ * parts through `chipParts`; `chip` adds only the keyboard ring, the stack
+ * guard and the print comma), `popup`, `list`, `item`,
+ * `itemIndicator`, `itemText`, `match`, `group`, `groupLabel`, `separator`,
+ * `empty`, `status` (the loading and failure row, with `statusGlyph`),
+ * `addRow` (the creatable row, with `addGlyph`); `positioner` places the
+ * popup on --layer-3, and `edge` / `edgeLine` draw the disabled
+ * `line-dotted-fine` edge as true dots [D36, D68]. Colors are role
+ * variables only; local custom properties carry dimensions only. The popup
+ * is a portaled `white` page scope framed by --border-size-2 --primary12
+ * [D92, D139, D156].
+ */
+
+/* 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. */
+.input {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.item {
+  composes: typeBodyUi from '../../utils/type.module.css';
+}
+
+.groupLabel {
+  composes: typeLabel from '../../utils/type.module.css';
+}
+
+.empty,
+.status {
+  composes: typeBodyUi typeMuted from '../../utils/type.module.css';
+}
+
+.edgeLine {
+  composes: lineDottedFine from '../../utils/line.module.css';
+}
+
+@layer base {
+  /* The field box (§10.1): --size-px-8 minimum, --radius-1, --border-size-1 --role-rule, open. */
+  .base {
+    /* Local dimensions. */
+    --combobox-edge: var(--border-size-1);
+    --combobox-radius: var(--radius-1);
+
+    position: relative;
+    display: flex;
+    align-items: center;
+    gap: var(--size-px-2);
+    box-sizing: border-box;
+    inline-size: 100%;
+    min-inline-size: 0;
+    min-block-size: var(--size-px-8);
+    margin: 0;
+    padding-block: 0;
+    padding-inline: calc(var(--size-px-2-5) + var(--border-size-1) - var(--combobox-edge)) 0;
+    border: var(--combobox-edge) solid var(--role-rule);
+    border-radius: var(--combobox-radius);
+    background: none;
+    color: var(--primary12);
+    cursor: text;
+  }
+
+  /* The value: type-body-ui in the box's ink; the ring is the box's. */
+  .input {
+    flex: 1 1 var(--size-px-9);
+    align-self: stretch;
+    min-inline-size: 0;
+    min-block-size: calc(var(--size-px-8) - 2 * var(--combobox-edge));
+    margin: 0;
+    padding: 0;
+    border: 0;
+    border-radius: 0;
+    background: none;
+    color: inherit;
+    text-overflow: ellipsis;
+    appearance: none;
+  }
+
+  /* The placeholder: --role-muted, one weight lighter in dark scopes [D170]. */
+  .input::placeholder {
+    color: var(--role-muted);
+    font-weight: max(
+      var(--type-weight-floor, 400),
+      calc(var(--type-weight, 400) - var(--fgd-muted-weight-step))
+    );
+  }
+
+  /* Leading icon (search) and the chevron: --primary12, inline tier [D166]. */
+  .icon {
+    flex: none;
+    color: inherit;
+  }
+
+  /* Clear × and the chevron trigger: glyph cells with a --fgd-size-hit target. */
+  .clear,
+  .trigger {
+    position: relative;
+    flex: none;
+    display: grid;
+    place-items: center;
+    align-self: stretch;
+    inline-size: var(--fgd-size-hit);
+    min-block-size: var(--fgd-size-hit);
+    margin: 0;
+    padding: 0;
+    border: 0;
+    border-radius: var(--combobox-radius);
+    background: none;
+    color: inherit;
+    cursor: pointer;
+    appearance: none;
+  }
+
+  .chevron {
+    display: block;
+  }
+
+  /* Chips wrap inside the box, which grows and never scrolls sideways. */
+  .chips {
+    display: flex;
+    flex: 1 1 auto;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--size-px-1);
+    min-inline-size: 0;
+  }
+
+  /*
+   * The removable chip (§10.11) is the Chip module's (chipParts): here only
+   * what a focusable Base UI chip adds, its keyboard ring (states).
+   */
+  .chip {
+    cursor: default;
+    outline: 0;
+  }
+
+  .edge {
+    display: none;
+    position: absolute;
+    inset-block-start: calc(var(--fgd-dot-fine) / 2);
+    inset-inline-start: calc(var(--fgd-dot-fine) / 2);
+    inline-size: calc(100% - var(--fgd-dot-fine));
+    block-size: calc(100% - var(--fgd-dot-fine));
+    overflow: visible;
+    pointer-events: none;
+  }
+
+  .edgeLine {
+    fill: none;
+    stroke: var(--role-disabled-edge);
+    rx: calc(var(--combobox-radius) - var(--fgd-dot-fine) / 2);
+  }
+
+  .positioner {
+    z-index: var(--layer-3);
+    outline: 0;
+  }
+
+  /* The overlay face: the white scope's --primary1, the --border-size-2 --primary12 frame, --radius-2-25. */
+  .popup {
+    /* The clip reveal starts from the trigger side. */
+    --combobox-reveal-from: inset(0 0 100% 0);
+
+    box-sizing: border-box;
+    inline-size: var(--anchor-width);
+    max-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(0);
+    outline: 0;
+  }
+
+  /* At most 8 rows, then it scrolls; the height stays above the on-screen keyboard. */
+  .list {
+    box-sizing: border-box;
+    max-block-size: min(
+      var(--available-height, 100vh),
+      calc(8 * var(--fgd-size-hit) + 2 * var(--size-px-1))
+    );
+    padding: var(--size-px-1);
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    scroll-padding-block: var(--size-px-1);
+    outline: 0;
+  }
+
+  .list:empty {
+    padding: 0;
+  }
+
+  /* Items as Select (§10.5): --fgd-size-hit rows, the ✓ column first. */
+  .item {
+    position: relative;
+    display: grid;
+    grid-template-columns: var(--size-px-3) minmax(0, 1fr);
+    align-items: center;
+    column-gap: var(--size-px-2);
+    min-block-size: var(--fgd-size-hit);
+    padding-inline: var(--size-px-3);
+    border-radius: calc(var(--radius-2-25) - var(--size-px-1));
+    color: var(--primary12);
+    cursor: default;
+    outline: 0;
+    user-select: none;
+  }
+
+  .item::before {
+    content: '';
+    display: none;
+    position: absolute;
+    inset-block: 0;
+    inset-inline-start: 0;
+    border-inline-start: var(--border-size-2-25) solid var(--primary12);
+  }
+
+  .itemIndicator {
+    grid-column: 1;
+    display: inline-flex;
+    color: var(--primary12);
+  }
+
+  .itemText {
+    grid-column: 2;
+    min-inline-size: 0;
+  }
+
+  /* The matched substring: --primary12 at --font-weight-7; never color or fill (P2). */
+  .match {
+    background: none;
+    color: var(--primary12);
+    font-weight: var(--font-weight-7);
+  }
+
+  .group {
+    display: block;
+  }
+
+  .groupLabel {
+    padding-block: var(--size-px-2) var(--size-px-1);
+    padding-inline: var(--size-px-3);
+    color: var(--role-muted);
+  }
+
+  .separator {
+    margin-block: var(--size-px-1);
+    margin-inline: calc(-1 * var(--size-px-1));
+    border-block-start: var(--border-size-1) solid var(--role-rule);
+  }
+
+  /*
+   * The empty and loading rows: type-body-ui italic in --role-muted. They
+   * stay mounted as live regions, so only a row with words takes space.
+   */
+  .empty,
+  .status {
+    font-style: italic;
+  }
+
+  .empty:not(:empty),
+  .status:not(:empty) {
+    display: flex;
+    align-items: flex-start;
+    gap: var(--size-px-2);
+    padding: var(--size-px-3);
+  }
+
+  /* A fetch failure: the danger glyph in --role-status and a --primary12 message. */
+  .statusError {
+    display: contents;
+    color: var(--primary12);
+    font-style: normal;
+  }
+
+  .statusGlyph {
+    flex: none;
+    inline-size: var(--size-px-3);
+    block-size: 1lh;
+    overflow: visible;
+    color: var(--role-status);
+    fill: var(--role-status-fill);
+    stroke: var(--role-status-fill);
+    stroke-width: var(--border-size-1-5);
+    stroke-linecap: round;
+    stroke-linejoin: round;
+  }
+
+  /* The creatable row: "+ Add '…'" in --primary12. */
+  .addRow {
+    color: var(--primary12);
+  }
+
+  .addGlyph {
+    grid-column: 1;
+  }
+
+  @media (forced-colors: active) {
+    .edgeLine {
+      stroke: currentColor;
+    }
+
+    .statusGlyph {
+      forced-color-adjust: none;
+      color: CanvasText;
+      fill: Canvas;
+      stroke: Canvas;
+    }
+  }
+
+  @media (prefers-reduced-motion: no-preference) {
+    .base {
+      transition-property: border-color, outline-color;
+      transition-duration: var(--fgd-duration-quick);
+      transition-timing-function: var(--ease-out-3);
+    }
+
+    .chevron {
+      transition: rotate var(--fgd-duration-quick) var(--ease-out-3);
+    }
+
+    /* The clip reveal (the edge wipes open), never a fade [D91]. */
+    .popup {
+      transition: clip-path var(--fgd-duration-disclosure) var(--ease-out-3);
+    }
+  }
+
+  /* From --lg-n-above the popup may grow past the field, up to --size-sm. */
+  @media (min-width: 1024px) {
+    .popup {
+      min-inline-size: var(--anchor-width);
+      inline-size: auto;
+      max-inline-size: max(var(--anchor-width), var(--size-sm));
+    }
+  }
+
+  /* Stack guard: chips keep their × and truncate their label [D73] (`.chips` outranks the chip's own cap). */
+  @media (max-width: 359.98px) {
+    .chips .chip {
+      max-inline-size: calc(100% - var(--fgd-size-hit));
+    }
+  }
+}
+
+@layer variants {
+  /*
+   * Multiple: the box grows as its chips wrap. The chips row (chips plus
+   * the input) takes the width the clear and chevron cells leave, so those
+   * stay in the box at the end edge; the input keeps room for its
+   * placeholder and wraps to its own line before it would truncate. The
+   * row carries the block padding, so an empty box is --size-px-8 tall,
+   * as a single one is.
+   */
+  .multiple .chips {
+    flex: 1 1 0;
+    align-self: stretch;
+    padding-block: calc((var(--size-px-8) - var(--size-px-7)) / 2 - var(--combobox-edge));
+  }
+
+  .multiple .input {
+    flex: 1 1 var(--size-px-11);
+    min-inline-size: min(100%, var(--size-px-11));
+    min-block-size: var(--size-px-7);
+  }
+
+  /*
+   * Plate: the box face is the nested white scope's --primary1 (§10.1). The
+   * box is also a Ground face, whose own classes share the base layer, so
+   * its display and edge are restated here.
+   */
+  .plate {
+    display: flex;
+    border: var(--combobox-edge) solid var(--role-rule);
+    background-color: var(--primary1);
+    color: var(--primary12);
+  }
+}
+
+@layer states {
+  /* Hover (not disabled): the 1 px edge steps to --primary12 at the same weight [D140]. */
+  .base:hover:not([data-disabled], [data-invalid], [data-readonly]) {
+    border-color: var(--primary12);
+  }
+
+  /* Focus: the ring on any focus of the input, outside the box [D90]. */
+  .base[data-focused] {
+    outline: var(--border-size-2) solid var(--primary12);
+    outline-offset: var(--border-size-2);
+  }
+
+  .input:focus-visible {
+    outline: none;
+  }
+
+  /* Open: the box edge goes to --primary12 and the chevron turns. */
+  .base[data-popup-open] {
+    border-color: var(--primary12);
+  }
+
+  .trigger[data-popup-open] .chevron {
+    rotate: 180deg;
+  }
+
+  /* The clear × and the trigger take their own ring (the chip × takes the Chip module's). */
+  .clear:focus-visible,
+  .trigger:focus-visible {
+    outline: var(--border-size-2) solid var(--primary12);
+    outline-offset: calc(-1 * var(--border-size-2));
+  }
+
+  /* Pressed: the glyph's cell takes the inverse pair (§10.1 icon states). */
+  .clear:active {
+    background-color: var(--primary12);
+    color: var(--role-inverse);
+  }
+
+  /* A chip focused from the keyboard (Backspace, arrows) draws the ring. */
+  .chip:focus-visible {
+    outline: var(--border-size-2) solid var(--primary12);
+    outline-offset: var(--border-size-2);
+  }
+
+  /* Error: the --border-size-2 edge in --role-status (the danger scale) [D141, D155]. */
+  .base[data-invalid] {
+    --combobox-edge: var(--border-size-2);
+
+    border-color: var(--role-status);
+  }
+
+  /* Disabled: dotted edge, --role-muted inks, no face, clear hidden; never dimmed [D16]. */
+  .base[data-disabled] {
+    --combobox-edge: 0px;
+
+    border-style: none;
+    background: none;
+    color: var(--role-muted);
+    cursor: default;
+  }
+
+  .base[data-disabled] .edge {
+    display: block;
+  }
+
+  .base[data-disabled] .clear {
+    display: none;
+  }
+
+  /* Read-only: the box is removed; a --border-size-1 --role-rule bottom rule remains. */
+  .base[data-readonly] {
+    border-width: 0 0 var(--border-size-1);
+    border-color: var(--role-rule);
+    border-radius: var(--radius-0);
+    background: none;
+  }
+
+  /* Highlighted: --primary4 plus the start-edge bar; focus stays in the input [D145]. */
+  .item[data-highlighted] {
+    background-color: var(--primary4);
+  }
+
+  .item[data-highlighted]::before {
+    display: block;
+  }
+
+  /* Selected: the leading ✓ in --primary12 plus --font-weight-6; no fill, no bar [D145]. */
+  .item[data-selected] {
+    font-weight: var(--font-weight-6);
+  }
+
+  .item[data-disabled] {
+    background: none;
+    color: var(--role-muted);
+  }
+
+  .item[data-disabled]::before {
+    display: none;
+  }
+
+  /* Placement: a popup above the field reveals from its bottom edge. */
+  .popup[data-side='top'] {
+    --combobox-reveal-from: inset(100% 0 0 0);
+  }
+
+  /* The clip reveal from the trigger side [D91]; instant under --motionNotOK. */
+  .popup[data-starting-style],
+  .popup[data-ending-style] {
+    clip-path: var(--combobox-reveal-from);
+  }
+}
+
+@layer print {
+  @media print {
+    /* Values print as text in the frame; multiple values comma-joined (the chips print as words, Chip's print rules). */
+    .clear,
+    .trigger,
+    .positioner {
+      display: none;
+    }
+
+    .chip:not(:last-of-type)::after {
+      content: ',';
+    }
+
+    .input::placeholder {
+      font-size: 0;
+    }
+  }
+}

package/forms/combobox/index.d.ts

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

package/forms/combobox/index.d.ts.map

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

package/forms/combobox/index.js

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

package/forms/combobox/index.js.map

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

package/forms/field/Field.d.ts

@@ -0,0 +1,70 @@
+import * as React from 'react';
+import { Field as BaseField } from '@base-ui/react/field';
+import { type VariantProps } from 'class-variance-authority';
+export declare const field: (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;
+/** The §1.5.4 danger scale, passed as `secondary` while a field is invalid [D129]. */
+export declare const dangerScale: "red";
+/**
+ * True while the nearest Field is invalid. Text-entry and select controls
+ * read it to take the danger scale as their `secondary` (§10.1) [D129].
+ */
+export declare function useFieldInvalid(): boolean;
+type FieldVariants = VariantProps<typeof field>;
+/** Props for Field: Base UI Field.Root props plus the color axes. */
+export type FieldProps = BaseField.Root.Props & {
+    /**
+     * Primary Radix scale: the label, description and, by inheritance, the
+     * control's edge, value and focus ring. Never defaulted [D133].
+     */
+    primary?: FieldVariants['primary'];
+    /**
+     * Secondary Radix scale. Unused at rest; while the field is invalid the
+     * danger scale replaces it on the error and the control (§10.1).
+     */
+    secondary?: FieldVariants['secondary'];
+};
+/**
+ * A Base UI Field.Root: the stack of label, control, description and error.
+ * Validation follows §10.2: validate on submit, then on blur for a field
+ * that has already failed (`validationMode` on the Form).
+ */
+export declare function Field(props: FieldProps): React.JSX.Element;
+/** Props for FieldLabel: Base UI Field.Label props plus the "(optional)" marker. */
+export type FieldLabelProps = BaseField.Label.Props & {
+    /**
+     * Appends the marker inside the label (§10.1): `true` writes
+     * "(optional)"; a string writes that marker instead, such as
+     * "(required)" where most fields are optional. Never an asterisk alone.
+     */
+    optional?: boolean | string;
+};
+/**
+ * The field label: `type-field-label` in `--primary12`, authored in title
+ * case up to about four words, sentence case for longer or question labels
+ * [D160]. For a Select or Combobox trigger pass `nativeLabel={false}`: the
+ * label then renders a `div` that focuses the control without opening it.
+ */
+export declare function FieldLabel(props: FieldLabelProps): React.JSX.Element;
+/** Props for FieldDescription: Base UI Field.Description props. */
+export type FieldDescriptionProps = BaseField.Description.Props;
+/**
+ * Helper text: `type-caption` in `--role-muted`, `--size-px-1` below the
+ * box; sentence case. Base UI links it to the control with
+ * `aria-describedby`.
+ */
+export declare function FieldDescription(props: FieldDescriptionProps): React.JSX.Element;
+/** Props for FieldError: Base UI Field.Error props, without `render`. */
+export type FieldErrorProps = Omit<BaseField.Error.Props, 'render'>;
+/**
+ * The error message, shown by Base UI while the field is invalid (or for
+ * the `match` it names): the danger glyph in `--role-status`, then the
+ * message in `type-caption` at `--font-weight-6` in `--primary12`. Word it
+ * as what happened plus how to fix it (§1.9.2). Without children it shows
+ * the browser's validation message.
+ */
+export declare function FieldError(props: FieldErrorProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Field.d.ts.map

package/forms/field/Field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/forms/field/Field.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AA4BjE,eAAO,MAAM,KAAK;;;8EAMhB,CAAA;AASF,sFAAsF;AACtF,eAAO,MAAM,WAAW,OAAsB,CAAA;AAK9C;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,KAAK,aAAa,GAAG,YAAY,CAAC,OAAO,KAAK,CAAC,CAAA;AAE/C,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;CACvC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,qBAqBtC;AAED,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG;IACpD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,qBAoBhD;AAED,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAA;AAE/D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,qBAQ5D;AAED,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,qBAmBhD"}

package/forms/field/Field.js

@@ -0,0 +1,103 @@
+'use client';
+import * as React from 'react';
+import { Field as BaseField } from '@base-ui/react/field';
+import { cva } from 'class-variance-authority';
+import { resolveClassName, cx } from '../../utils/className';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { useScopeAttributes } from '../../utils/scope';
+import { StatusGlyph, statusScales } from '../../utils/StatusGlyph';
+import styles from './field.module.css';
+/*
+ * Field (§10.2): wires a control's label, description and error.
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: field.module.css; CVA functions `field` (root) and `fieldError`
+ *   (the error part, which carries the computed danger scale).
+ * - Axes: `primary`, `secondary` → scales module classes.
+ * - Compound variants: none. Defaults: color axes none.
+ * - Color fallback: inherits the scope. While Base UI reports the field
+ *   invalid, the Field computes the danger scale and passes it as the
+ *   `secondary` of its error part and, through context, of its text-entry
+ *   or select control (§10.1) [D129]. It is never set on the root, so value
+ *   controls (Checkbox, Radio, Switch) keep their own secondary.
+ * - States: `data-invalid` → the §10.1 error state (the control draws the
+ *   edge, the error part the glyph and message); `data-disabled` → label
+ *   `--role-muted`; `data-valid`, `data-touched`, `data-dirty` → none;
+ *   `data-focused` → none here (the control draws the ring).
+ * - Parts: base, label, optional, description, error, errorGlyph.
+ * - Scope: none. Container: none; the Form root is the container.
+ */
+export const field = cva(styles.base, {
+    variants: {
+        // Color axes: never defaulted, so an omitted prop inherits the scope [D133].
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+});
+/** The error part's own function: it takes a secondary the root does not (§1.11.3). */
+const fieldError = cva(styles.error, {
+    variants: {
+        secondary: secondaryScaleVariants,
+    },
+});
+/** The §1.5.4 danger scale, passed as `secondary` while a field is invalid [D129]. */
+export const dangerScale = statusScales.danger;
+const FieldInvalidContext = React.createContext(false);
+FieldInvalidContext.displayName = 'FieldInvalidContext';
+/**
+ * True while the nearest Field is invalid. Text-entry and select controls
+ * read it to take the danger scale as their `secondary` (§10.1) [D129].
+ */
+export function useFieldInvalid() {
+    return React.useContext(FieldInvalidContext);
+}
+/**
+ * A Base UI Field.Root: the stack of label, control, description and error.
+ * Validation follows §10.2: validate on submit, then on blur for a field
+ * that has already failed (`validationMode` on the Form).
+ */
+export function Field(props) {
+    const { primary, secondary, className, children, ...rest } = props;
+    const scope = useScopeAttributes();
+    return (React.createElement(BaseField.Root, { ...rest, ...scope, className: resolveClassName(className, (extra) => field({ primary, secondary, className: extra })) },
+        React.createElement(BaseField.Validity, null, (validity) => (React.createElement(FieldInvalidContext.Provider, { value: validity.validity.valid === false }, children)))));
+}
+/**
+ * The field label: `type-field-label` in `--primary12`, authored in title
+ * case up to about four words, sentence case for longer or question labels
+ * [D160]. For a Select or Combobox trigger pass `nativeLabel={false}`: the
+ * label then renders a `div` that focuses the control without opening it.
+ */
+export function FieldLabel(props) {
+    const { optional, className, children, nativeLabel, render, ...rest } = props;
+    const marker = optional === true ? '(optional)' : optional || null;
+    return (React.createElement(BaseField.Label, { ...rest, nativeLabel: nativeLabel, render: render ?? (nativeLabel === false ? React.createElement("div", null) : undefined), className: resolveClassName(className, (extra) => cx(styles.label, extra)) },
+        children,
+        marker ? (React.createElement(React.Fragment, null,
+            ' ',
+            React.createElement("span", { className: styles.optional }, marker))) : null));
+}
+/**
+ * Helper text: `type-caption` in `--role-muted`, `--size-px-1` below the
+ * box; sentence case. Base UI links it to the control with
+ * `aria-describedby`.
+ */
+export function FieldDescription(props) {
+    const { className, ...rest } = props;
+    return (React.createElement(BaseField.Description, { ...rest, className: resolveClassName(className, (extra) => cx(styles.description, extra)) }));
+}
+/**
+ * The error message, shown by Base UI while the field is invalid (or for
+ * the `match` it names): the danger glyph in `--role-status`, then the
+ * message in `type-caption` at `--font-weight-6` in `--primary12`. Word it
+ * as what happened plus how to fix it (§1.9.2). Without children it shows
+ * the browser's validation message.
+ */
+export function FieldError(props) {
+    const { className, ...rest } = props;
+    const scope = useScopeAttributes();
+    return (React.createElement(BaseField.Error, { ...rest, ...scope, className: resolveClassName(className, (extra) => fieldError({ secondary: dangerScale, className: extra })), render: (elementProps) => (React.createElement("div", { ...elementProps },
+            React.createElement(StatusGlyph, { status: "danger", className: styles.errorGlyph }),
+            React.createElement("span", null, elementProps.children))) }));
+}
+//# sourceMappingURL=Field.js.map