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

package/forms/combobox/combobox.module.css

@@ -0,0 +1,504 @@
+/*
+ * 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]. It opens and closes by the outline morph (the popup
+ * answers `data-outline-morph`, foundations/outline-morph) or at once [D205].
+ */
+
+/* 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 {
+    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;
+      transition-duration: var(--fgd-duration-quick);
+      transition-timing-function: var(--ease-out-3);
+    }
+
+    .chevron {
+      transition: rotate var(--fgd-duration-quick) 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;
+  }
+
+  /*
+   * Outline morph [D204]: while the overlay draws the frame, the popup's own
+   * edge takes its face and its own transitions stay off. Without the morph
+   * the popup opens and closes at once (no reveal of its own) [D205].
+   */
+  .popup[data-outline-morph] {
+    border-color: var(--primary1);
+    transition: none;
+  }
+}
+
+@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.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.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.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.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","sourceRoot":"","sources":["../../src/forms/field/Field.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE;QACR,6EAA6E;QAC7E,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC,CAAA;AAEF,uFAAuF;AACvF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE;IACnC,QAAQ,EAAE;QACR,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC,CAAA;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAA;AAE9C,MAAM,mBAAmB,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACtD,mBAAmB,CAAC,WAAW,GAAG,qBAAqB,CAAA;AAEvD;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAC9C,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAClE,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAA;IAElC,OAAO,CACL,oBAAC,SAAS,CAAC,IAAI,OACT,IAAI,KACJ,KAAK,EACT,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAC/C,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAChD;QAED,oBAAC,SAAS,CAAC,QAAQ,QAChB,CAAC,QAAQ,EAAE,EAAE,CAAC,CACb,oBAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,IACnE,QAAQ,CACoB,CAChC,CACkB,CACN,CAClB,CAAA;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC7E,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAA;IAElE,OAAO,CACL,oBAAC,SAAS,CAAC,KAAK,OACV,IAAI,EACR,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,gCAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAC/D,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAEzE,QAAQ;QACR,MAAM,CAAC,CAAC,CAAC,CACR;YACG,GAAG;YACJ,8BAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAG,MAAM,CAAQ,CAChD,CACJ,CAAC,CAAC,CAAC,IAAI,CACQ,CACnB,CAAA;AACH,CAAC;AAKD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACpC,OAAO,CACL,oBAAC,SAAS,CAAC,WAAW,OAChB,IAAI,EACR,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAChF,CACH,CAAA;AACH,CAAC;AAKD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACpC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAA;IAElC,OAAO,CACL,oBAAC,SAAS,CAAC,KAAK,OACV,IAAI,KACJ,KAAK,EACT,SAAS,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAC/C,UAAU,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CACzD,EACD,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,CACxB,gCAAS,YAAY;YACnB,oBAAC,WAAW,IAAC,MAAM,EAAC,QAAQ,EAAC,SAAS,EAAE,MAAM,CAAC,UAAU,GAAI;YAC7D,kCAAO,YAAY,CAAC,QAAQ,CAAQ,CAChC,CACP,GACD,CACH,CAAA;AACH,CAAC"}

package/forms/field/field.module.css

@@ -0,0 +1,114 @@
+/*
+ * Field (§10.2, §10.1). CVA function `field`; the error part has its own
+ * function `fieldError`, because it carries the computed danger scale.
+ * Parts: `base` (the stack), `label`, `optional`, `description`, `error`,
+ * `errorGlyph`. The control's box is its own module (§10.1: modules do not
+ * compose each other's classes). Colors are role variables only; label case
+ * is authored, never set here [D160].
+ */
+
+/* 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. */
+.label {
+  composes: typeFieldLabel from '../../utils/type.module.css';
+}
+
+/* Helper text is muted text: one weight lighter in dark scopes, floored at 400 [D170]. */
+.description {
+  composes: typeCaption typeMuted from '../../utils/type.module.css';
+}
+
+.error {
+  composes: typeCaption from '../../utils/type.module.css';
+}
+
+@layer base {
+  /* The stack: label → box --size-px-2, box → description and error --size-px-1 (§10.1). */
+  .base {
+    display: flex;
+    flex-direction: column;
+    align-items: stretch;
+    min-inline-size: 0;
+    color: var(--primary12);
+  }
+
+  .label {
+    align-self: start;
+    margin-block-end: var(--size-px-2);
+    color: var(--primary12);
+  }
+
+  /* "(optional)" sits in the label and takes its ink (§10.1). */
+  .optional {
+    color: inherit;
+  }
+
+  .description {
+    margin: 0;
+    margin-block-start: var(--size-px-1);
+  }
+
+  /* The message: type-caption at --font-weight-6 in --primary12, led by the danger glyph. */
+  .error {
+    display: flex;
+    align-items: flex-start;
+    gap: var(--size-px-2);
+    margin-block-start: var(--size-px-1);
+    color: var(--primary12);
+  }
+
+  /*
+   * The danger glyph (◆ with its inner ×, §1.5.4) [D58] at --size-px-3:
+   * shape in --role-status (currentColor), the × knocked out in
+   * --role-status-fill. One line box tall so it sits on the first line.
+   */
+  .errorGlyph {
+    flex: none;
+    display: block;
+    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;
+  }
+
+  @media (forced-colors: active) {
+    .errorGlyph {
+      forced-color-adjust: none;
+      color: CanvasText;
+      fill: Canvas;
+      stroke: Canvas;
+    }
+  }
+}
+
+@layer variants {
+  /*
+   * The message weight, --font-weight-6 (§10.1). It overrides the composed
+   * type-caption, which sits in `base`, so it is written one layer up.
+   */
+  .error {
+    font-weight: var(--font-weight-6);
+  }
+}
+
+@layer states {
+  /* Disabled: the label and "(optional)" take --role-muted; never dimmed [D16]. */
+  .label[data-disabled] {
+    color: var(--role-muted);
+  }
+}
+
+@layer print {
+  @media print {
+    /* Labels, values and messages print; the global remap turns their inks black. */
+    .base {
+      break-inside: avoid;
+    }
+  }
+}

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

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

package/forms/field/index.js.map

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

package/forms/fieldset/Fieldset.d.ts

@@ -0,0 +1,48 @@
+import * as React from 'react';
+import { Fieldset as BaseFieldset } from '@base-ui/react/fieldset';
+import { type VariantProps } from 'class-variance-authority';
+export declare const fieldset: (props?: ({
+    variant?: "outline" | "text" | "ledger" | 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 FieldsetVariants = VariantProps<typeof fieldset>;
+/** Props for Fieldset: Base UI Fieldset.Root props plus the variant and color axes. */
+export type FieldsetProps = BaseFieldset.Root.Props & {
+    /**
+     * `text` (default) is open: a legend over a hairline rule. `outline` is
+     * the framed panel for technical forms and calculators; never nest two.
+     * `ledger` is the dotted frame for self-contained order and checklist
+     * forms, with `FieldsetLeader` rows.
+     */
+    variant?: FieldsetVariants['variant'];
+    /** Primary Radix scale: legend, frame and rules. Never defaulted [D133]. */
+    primary?: FieldsetVariants['primary'];
+    /** Secondary Radix scale: accepted, unused (structure is primary only). */
+    secondary?: FieldsetVariants['secondary'];
+};
+/**
+ * A Base UI Fieldset: a native `fieldset` whose first child is a
+ * `FieldsetLegend`. `disabled` disables the legend and every control in it;
+ * hiding the group is usually better.
+ */
+export declare function Fieldset(props: FieldsetProps): React.JSX.Element;
+/** Props for FieldsetLegend: Base UI Fieldset.Legend props. */
+export type FieldsetLegendProps = BaseFieldset.Legend.Props;
+/**
+ * The legend, a native `legend`: `type-field-label` in `--primary12`, title
+ * case up to about four words, sentence case for longer or question
+ * legends [D160]. Open fieldsets draw the hairline rule under it; framed
+ * fieldsets set it into the top edge.
+ */
+export declare function FieldsetLegend(props: FieldsetLegendProps): React.JSX.Element;
+/** Props for FieldsetLeader: SVG props without children. */
+export type FieldsetLeaderProps = Omit<React.ComponentPropsWithRef<'svg'>, 'children'>;
+/**
+ * The ledger's `line-dotted-fine` leader in `--role-rule`, running from a
+ * row's label to its control. Place it between the two in
+ * a row that lays out inline; it grows to fill the space. Decorative.
+ */
+export declare function FieldsetLeader(props: FieldsetLeaderProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Fieldset.d.ts.map

package/forms/fieldset/Fieldset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fieldset.d.ts","sourceRoot":"","sources":["../../src/forms/fieldset/Fieldset.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AA4BjE,eAAO,MAAM,QAAQ;;;;8EAcnB,CAAA;AAEF,KAAK,gBAAgB,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,CAAA;AAErD,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,GAAG;IACpD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACrC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACrC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;CAC1C,CAAA;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAoB5C;AAED,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAA;AAE3D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,qBAYxD;AAED,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAA;AAEtF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,qBAYxD"}