@crewlethq/ui 0.6.3 → 0.7.0

package/dist/PricingCard/index.js

@@ -1,4 +1,4 @@
-export { PricingCard } from '../chunk-L6XZOCP4.js';
-import '../chunk-PAWGBSHU.js';
+export { PricingCard } from '../chunk-UCYIRDND.js';
+import '../chunk-LOECRMHA.js';
 import '../chunk-WIATRXEJ.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{PricingCard-7EFXRSD2.css → PricingCard-HTAHG4ST.css}

@@ -64,9 +64,13 @@
   border-color: var(--color-brand-accent-soft-strong);
 }
 
+/* One ring, over the card's own boundary rather than 2px off it, which is two
+   edges with a gap between them: the rule every field keeps (see Input.css).
+   The chosen plan keeps an accent line inside the ring, since the selection
+   ring below is two pixels deep and the focus ring covers one of them. */
 .crewlet-pricing-card:focus-visible {
   outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
+  outline-offset: var(--size-focus-ring-inset-offset);
 }
 
 /* The chosen plan takes the selection ring, which is the same inset rule

package/dist/SearchTrigger/index.js

@@ -1,2 +1,2 @@
-export { SearchTrigger } from '../chunk-EFYPAJT3.js';
+export { SearchTrigger } from '../chunk-6DRDCT22.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{SearchTrigger-Z5D4AAY7.css → SearchTrigger-KIZLWBEH.css}

@@ -58,9 +58,12 @@
   color: var(--color-text-primary);
 }
 
+/* One ring, over the trigger's own boundary rather than 2px off it, which is
+   two edges with a gap between them: the rule every field keeps (see
+   Input.css). */
 .crewlet-search-trigger:focus-visible {
   outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
+  outline-offset: var(--size-focus-ring-inset-offset);
 }
 
 .crewlet-search-trigger__icon {

package/dist/SegmentedControl/SegmentedControl.d.ts

@@ -1,5 +1,7 @@
 import { type ReactNode } from 'react';
 export type SegmentedSize = 'sm' | 'md';
+/** How the options are drawn: see [SegmentedControlProps.layout]. */
+export type SegmentedLayout = 'pill' | 'chips';
 export interface SegmentedOption<T extends string = string> {
     value: T;
     /** What is drawn. An empty label makes the option icon-only. */
@@ -27,6 +29,22 @@ interface SegmentedShared<T extends string> {
     value: T;
     onValueChange: (value: T) => void;
     size?: SegmentedSize | undefined;
+    /**
+     * How the options are drawn. `pill`, the default, is a row of chips in one
+     * tinted well, for a lens, a setting or a compact switch. `chips` is a row of
+     * SEPARATE chips that wraps, for a setting with more choices than a well
+     * holds on one line (a unit's type): each chip a raised ground of its own,
+     * the chosen one filled with the accent. A row whose options carry a
+     * description is drawn as cards whatever this says.
+     */
+    layout?: SegmentedLayout | undefined;
+    /**
+     * Drawn at the end of the row, after the last option and outside the
+     * choices themselves: the field that completes the last choice, such as the
+     * box a "Custom" chip asks for. It takes no part in the arrow keys, so a
+     * caret moves inside it as it does in any field.
+     */
+    trailing?: ReactNode | undefined;
     className?: string | undefined;
 }
 /**
@@ -97,5 +115,5 @@ export type SegmentedControlProps<T extends string = string> = SegmentedShared<T
  * look like two different controls depending on which component a screen
  * reached for.
  */
-export declare function SegmentedControl<T extends string = string>({ label, options, value, onValueChange, size, className, semantics, panelId, activate, activateHint, }: SegmentedControlProps<T>): import("react").JSX.Element;
+export declare function SegmentedControl<T extends string = string>({ label, options, value, onValueChange, size, layout, trailing, className, semantics, panelId, activate, activateHint, }: SegmentedControlProps<T>): import("react").JSX.Element;
 export {};

package/dist/SegmentedControl/index.d.ts

@@ -1,4 +1,4 @@
 import '../Tabs/Tabs.css';
 import './SegmentedControl.css';
 export { SegmentedControl } from './SegmentedControl.js';
-export type { SegmentedActivation, SegmentedControlProps, SegmentedOption, SegmentedSize, } from './SegmentedControl.js';
+export type { SegmentedActivation, SegmentedControlProps, SegmentedLayout, SegmentedOption, SegmentedSize, } from './SegmentedControl.js';

package/dist/SegmentedControl/index.js

@@ -1,5 +1,5 @@
-export { SegmentedControl } from '../chunk-DHPUMOTX.js';
-import '../chunk-QY7UU5ZB.js';
+export { SegmentedControl } from '../chunk-N5KCGFWI.js';
+import '../chunk-DRHXRGB6.js';
 import '../chunk-BHHIIK3M.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/SegmentedControl-76HODRBT.css

@@ -0,0 +1,160 @@
+/*
+ * SegmentedControl: the pill row, drawn with the Tabs classes.
+ *
+ * Only what is its own lives here. The chrome, the sizes and the active chip
+ * come from Tabs.css, so a lens row and a setting row look the same whichever
+ * component a screen reached for.
+ */
+
+.crewlet-segmented__text {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 1px;
+  min-width: 0;
+}
+
+/*
+ * A choice a reader has to READ before making it is a card row, not a chip:
+ * a template with a sentence under its name does not fit in a pill, and
+ * squeezing it there is how the sentence ends up truncated to nothing.
+ */
+/*
+ * TWO CLASSES, so this wins whatever order the stylesheets are bundled in.
+ * `.crewlet-tabs` sets the row's own display and alignment, and a rule of
+ * equal weight in a file that happens to come later takes them back.
+ */
+.crewlet-tabs.crewlet-segmented--cards {
+  display: grid;
+  gap: var(--spacing-2);
+  width: 100%;
+  align-items: stretch;
+}
+
+/*
+ * The same frame a framed Checkbox draws, because it is the same row: a
+ * boundary on the body it sits in, and no surface of its own. A choice with a
+ * surface inside a panel of the same surface reads as a second panel.
+ */
+.crewlet-segmented--cards .crewlet-segmented__option {
+  justify-content: flex-start;
+  text-align: left;
+  /* A sentence under a name is a sentence: it wraps rather than being cut. */
+  white-space: normal;
+  padding: var(--spacing-3);
+  border: 1px solid var(--color-border-default);
+  border-radius: var(--radius-lg);
+  font-size: var(--font-size-compact);
+}
+
+/* One ring, over the card's own boundary rather than 2px off it, which is two
+   edges with a gap between them: the rule every field keeps (see Input.css).
+   The chosen card still says so under the ring, in its tint and its ink. */
+.crewlet-segmented--cards .crewlet-segmented__option:focus-visible {
+  outline-offset: var(--size-focus-ring-inset-offset);
+}
+
+/* The one card that is chosen takes the accent, which is what "here, this
+   one" means everywhere else in the product. */
+.crewlet-segmented--cards .crewlet-segmented__option.is-active {
+  border-color: var(--color-brand-accent);
+  background: var(--color-brand-accent-soft);
+  color: var(--color-brand-accent-ink);
+}
+
+/*
+ * A ROW OF SEPARATE CHIPS, for a setting with more choices than a well holds
+ * on one line: the console's own row of unit types. It wraps rather than
+ * running off the panel it sits in, and each chip stands on the raised ground
+ * a chip with no edge of its own takes (held off the card by the palette
+ * suite), so no chip draws a frame inside the panel's. Two classes, for the
+ * reason the card row gives above.
+ */
+.crewlet-tabs.crewlet-segmented--chips {
+  /* The chip's own drawing (below) is the --crewlet-segmented-chip-height
+     band inside a target-floor box, so it is the same height at every
+     density the console's 11px chip is drawn at. */
+  --crewlet-segmented-chip-height: calc(var(--size-target-min) - var(--spacing-1));
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  /* No gap between ROWS: each chip's target already overhangs its drawing by
+     half a step above and below, so two rows' drawings stand a whole step
+     apart while their targets meet. */
+  gap: 0 var(--spacing-1);
+}
+
+/*
+ * SMALL, AS THE CONSOLE'S ARE, AND DRAWN SMALL BUT HIT FULL SIZE, the rule the
+ * org chart's own controls keep. A chip is a word in the 11px face with a step
+ * of room either side, drawn as a band shorter than the pointer-target floor;
+ * the button around it stays at the floor, so the band can be the console's
+ * size without being a target a finger misses. At the small control step a
+ * row of ten was a second row of buttons under the field's label rather than a
+ * row of answers to it.
+ *
+ * The band is the button's own ::before, behind the label, rather than its
+ * background clipped to the content box: a clip takes the corner's curve in by
+ * the padding it removes, and a chip this small would lose its radius.
+ */
+.crewlet-segmented--chips .crewlet-segmented__option {
+  position: relative;
+  isolation: isolate;
+  min-height: var(--size-target-min);
+  padding: 0 var(--spacing-2);
+  border-radius: var(--radius-sm);
+  background: none;
+  color: var(--color-text-secondary);
+  font-size: var(--font-size-2xs);
+}
+
+.crewlet-segmented--chips .crewlet-segmented__option::before {
+  content: '';
+  position: absolute;
+  inset: calc((var(--size-target-min) - var(--crewlet-segmented-chip-height)) / 2) 0;
+  z-index: -1;
+  border-radius: var(--radius-sm);
+  background: var(--color-surface-elevated);
+  pointer-events: none;
+}
+
+/* The chosen chip is FILLED with the accent: on a row of up to ten raised
+   chips, a fill is the one thing that says "this one" at a glance, as the
+   console's row says it. Its ring stands off it, because an edge drawn on an
+   accent fill in the focus colour is nearly the fill's own colour. */
+.crewlet-segmented--chips .crewlet-segmented__option.is-active {
+  color: var(--color-text-on-accent);
+}
+
+.crewlet-segmented--chips .crewlet-segmented__option.is-active::before {
+  background: var(--color-brand-accent);
+}
+
+/* What completes the last choice sits in the row, at the chips' own height
+   and in their face: a field at its own control step stood taller than every
+   chip beside it. */
+.crewlet-segmented__trailing {
+  display: inline-flex;
+  align-items: center;
+  min-width: 0;
+}
+
+.crewlet-segmented--chips .crewlet-segmented__trailing .crewlet-input {
+  min-height: var(--crewlet-segmented-chip-height);
+}
+
+.crewlet-segmented--chips .crewlet-segmented__trailing .crewlet-input__control {
+  font-size: var(--font-size-2xs);
+}
+
+.crewlet-segmented__description {
+  font-size: var(--font-size-xs);
+  font-weight: var(--font-weight-regular);
+  line-height: var(--font-line-height-normal);
+  color: var(--color-text-tertiary);
+  white-space: normal;
+}
+
+.crewlet-segmented--cards .crewlet-segmented__option.is-active .crewlet-segmented__description {
+  color: var(--color-brand-accent-ink);
+}

package/dist/Select/index.js

@@ -1,4 +1,4 @@
-export { Select } from '../chunk-SJQ546ID.js';
+export { Select } from '../chunk-SEFMO2EV.js';
 import '../chunk-6MU7HNB4.js';
 import '../chunk-7RPGY3JE.js';
 import '../chunk-R25RGPUB.js';

package/dist/{Select-E24U5LBC.css → Select-4ANVLHUY.css}

@@ -68,8 +68,8 @@
  * leave the other bare.
  */
 .crewlet-select:focus-within {
-  outline: 2px solid var(--color-focus);
-  outline-offset: var(--size-focus-ring-inset-offset);
+  outline: 1px solid var(--color-focus);
+  outline-offset: -1px;
 }
 
 /*
@@ -347,8 +347,8 @@ svg.crewlet-select__chevron {
  * outset ring on the input would be cut by the menu's own `overflow: hidden`.
  */
 .crewlet-select__search:focus-within {
-  outline: 2px solid var(--color-focus);
-  outline-offset: var(--size-focus-ring-inset-offset);
+  outline: 1px solid var(--color-focus);
+  outline-offset: -1px;
 }
 
 .crewlet-select__search {

package/dist/Switch/index.js

@@ -1,2 +1,2 @@
-export { Switch } from '../chunk-EV6IMYJ6.js';
+export { Switch } from '../chunk-A722MUNR.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{Switch-U4OWK4CL.css → Switch-66RAQCRE.css}

@@ -111,14 +111,17 @@
  * control's own :focus-visible. The track is the same box: the control is
  * `inset: 0` over it.
  *
- * OUTSET, like a Checkbox's and unlike a text field's. A 20px pill has no
- * room to draw a ring inside itself, and there is no boundary to cover out
- * there either: the track's own border goes the accent colour of its fill
- * when the switch is on, so the ring is the only edge in that space.
+ * OUTSIDE THE TRACK, like a Checkbox's and unlike a text field's: a 20px pill
+ * has no room to draw a ring inside itself. But AGAINST it, not 2px off it.
+ * Off, the track draws a real boundary of its own, and a ring standing off
+ * that boundary was two edges with a gap between them, which reads as a
+ * second outline rather than as focus. Flush, the ring and the track are one
+ * edge in both states, and the ring is still drawn whole on the ground around
+ * the pill, where it is measured.
  */
 .crewlet-switch__track:has(.crewlet-switch__control:focus-visible) {
   outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
+  outline-offset: 0;
 }
 
 .crewlet-switch__text {

package/dist/Tabs/index.js

@@ -1,4 +1,4 @@
-export { TabPanel, Tabs, tabId } from '../chunk-QY7UU5ZB.js';
+export { TabPanel, Tabs, tabId } from '../chunk-DRHXRGB6.js';
 import '../chunk-BHHIIK3M.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{Tabs-XCNPHA7B.css → Tabs-BWFQSWY3.css}

@@ -288,6 +288,18 @@
   outline-offset: 2px;
 }
 
+/*
+ * A CHIP RINGS ON ITS OWN EDGE, flush rather than 2px off it. The chip that
+ * is on draws a hairline round itself, and a ring standing off that hairline
+ * was two edges with a gap between them, which reads as a second outline
+ * rather than as focus. Flush, the ring covers the hairline, and it stays
+ * inside the well's 2px inset: two pixels wide, it meets the well's own
+ * boundary rather than leaving a sliver of the well between the two.
+ */
+.crewlet-tabs--pill .crewlet-tabs__tab:focus-visible {
+  outline-offset: 0;
+}
+
 .crewlet-tabs__tab.is-disabled,
 .crewlet-tabs__tab:disabled {
   opacity: 0.55;

package/dist/Tag/index.js

@@ -1,3 +1,3 @@
-export { Tag } from '../chunk-PAWGBSHU.js';
+export { Tag } from '../chunk-LOECRMHA.js';
 import '../chunk-WIATRXEJ.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{Tag-4OXGO2DU.css → Tag-4BRQS6GN.css}

@@ -264,11 +264,38 @@
   box-shadow: inset 0 0 0 1px var(--crewlet-tag-ink);
 }
 
+/*
+ * ONE RING, ON THE PILL'S OWN EDGE, never off it. A pill draws a border
+ * whenever it is neutral, pointed at or pressed, and a ring standing off that
+ * border is two edges with a gap between them, which reads as a second
+ * outline rather than as focus. So every control here rings over the pill's
+ * border, and the offset that puts it there is each control's own, because
+ * the three boxes meet that border in different places:
+ *
+ * - a whole actionable tag IS the pill, so -1px covers the border and one
+ *   pixel outside it;
+ * - the press half of a split pill stops at the border's inside edge, so 0
+ *   puts its ring on the same two pixels;
+ * - the remove reaches over the border at the top and the bottom (see its
+ *   rule below), so -1px puts its ring there as well.
+ *
+ * ONE PIXEL INTO THE PILL AT MOST, not a field's two, because a pressed tag
+ * says so in an ink line just inside its border: a ring two pixels deep would
+ * cover the one change that pressing it makes.
+ */
 .crewlet-tag--actionable:focus-visible,
 .crewlet-tag__press:focus-visible,
 .crewlet-tag__remove:focus-visible {
   outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
+}
+
+.crewlet-tag--actionable:focus-visible,
+.crewlet-tag__remove:focus-visible {
+  outline-offset: -1px;
+}
+
+.crewlet-tag__press:focus-visible {
+  outline-offset: 0;
 }
 
 /* ── the pill that holds two controls ──────────────────────────────────── */

package/dist/TagGroup/index.js

@@ -1,4 +1,4 @@
-export { TagGroup } from '../chunk-V2XMNLMS.js';
+export { TagGroup } from '../chunk-E6UWRXNM.js';
 import '../chunk-RSAQOKH3.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{TagGroup-APC2EFH4.css → TagGroup-BCQZD7ZD.css}

@@ -63,9 +63,12 @@
   color: var(--color-text-primary);
 }
 
+/* One ring, over the dashed boundary rather than 2px off it, which is two
+   edges with a gap between them: the rule every field keeps (see Input.css).
+   The list above has no edge of its own, so its ring stays outset. */
 .crewlet-tag-group__more:focus-visible {
   outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
+  outline-offset: var(--size-focus-ring-inset-offset);
 }
 
 @media (prefers-reduced-motion: reduce) {

package/dist/TagsInput/index.js

@@ -1,10 +1,10 @@
-export { TagsInput } from '../chunk-UWQWTGQH.js';
-import '../chunk-PAWGBSHU.js';
+export { TagsInput } from '../chunk-MPXI6FM6.js';
+import '../chunk-LOECRMHA.js';
 import '../chunk-WIATRXEJ.js';
 import '../chunk-6MU7HNB4.js';
 import '../chunk-RSAQOKH3.js';
 import '../chunk-7RPGY3JE.js';
 import '../chunk-R25RGPUB.js';
-import '../chunk-4UQ7SMPK.js';
+import '../chunk-4FQT6ZAY.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{TagsInput-W4P36PRJ.css → TagsInput-P2HS5QL4.css}

@@ -72,8 +72,8 @@
  * the whole reason they sit above the field instead of inside it.
  */
 .crewlet-tags-input__box:focus-visible {
-  outline: 2px solid var(--color-focus);
-  outline-offset: var(--size-focus-ring-inset-offset);
+  outline: 1px solid var(--color-focus);
+  outline-offset: -1px;
 }
 
 .crewlet-tags-input.is-disabled {

package/dist/ThemeSwitcher/index.js

@@ -1,7 +1,7 @@
-export { DensitySwitcher, ThemeSwitcher } from '../chunk-S7KW47IQ.js';
+export { DensitySwitcher, ThemeSwitcher } from '../chunk-RHHGLTXJ.js';
 export { applyDensity, applyStoredPreferences, applyTheme, resolveTheme, useDensityPreference, useSystemTheme, useThemePreference } from '../chunk-K3OWD7BJ.js';
-import '../chunk-DHPUMOTX.js';
-import '../chunk-QY7UU5ZB.js';
+import '../chunk-N5KCGFWI.js';
+import '../chunk-DRHXRGB6.js';
 import '../chunk-BHHIIK3M.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/ThemeToggle/index.js

@@ -1,5 +1,5 @@
-export { ThemeToggle } from '../chunk-C5WJUZVR.js';
+export { ThemeToggle } from '../chunk-ORNOOMVY.js';
 import '../chunk-K3OWD7BJ.js';
-import '../chunk-4UQ7SMPK.js';
+import '../chunk-4FQT6ZAY.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/TimeWindowPicker/index.js

@@ -1,13 +1,13 @@
-export { DEFAULT_TIME_WINDOW_LABELS, TIME_WINDOW_SPANS, TimeWindowPicker, describeTimeWindow, isTimeWindowSet, parseTimeWindowDuration, resolveTimeWindow, timeWindowMatchesPreset } from '../chunk-NQ2HQ6P5.js';
-import '../chunk-SJQ546ID.js';
-import '../chunk-AUS5FNQE.js';
+export { DEFAULT_TIME_WINDOW_LABELS, TIME_WINDOW_SPANS, TimeWindowPicker, describeTimeWindow, isTimeWindowSet, parseTimeWindowDuration, resolveTimeWindow, timeWindowMatchesPreset } from '../chunk-HVPC2GHY.js';
+import '../chunk-SEFMO2EV.js';
+import '../chunk-PDUZO35I.js';
 import '../chunk-GXQ3B46I.js';
 import '../chunk-6MU7HNB4.js';
-import '../chunk-DSUY5F4E.js';
+import '../chunk-ZGX2DP7F.js';
 import '../chunk-PQADV6P6.js';
 import '../chunk-7RPGY3JE.js';
 import '../chunk-R25RGPUB.js';
-import '../chunk-4UQ7SMPK.js';
-import '../chunk-ZAO4HHXI.js';
+import '../chunk-4FQT6ZAY.js';
+import '../chunk-OG6CL3EB.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';

package/dist/{TimeWindowPicker-7I7KWCMU.css → TimeWindowPicker-GBF4JDFI.css}

@@ -37,11 +37,17 @@
   border-color: var(--color-border-hover);
 }
 
+/*
+ * ONE RING, OVER THE BOUNDARY, for focus and for open alike. It stood 2px off
+ * the box with the border recoloured to the focus colour as well, which is an
+ * accent hairline, a gap and an accent band: two rings from one state. On the
+ * inset offset the ring covers the border, and the border keeps its own colour
+ * under it, the rule every field keeps (see Input.css).
+ */
 .crewlet-time-window:focus-visible,
 .crewlet-time-window.is-open {
-  outline: 2px solid var(--color-focus);
-  outline-offset: 2px;
-  border-color: var(--color-focus);
+  outline: 1px solid var(--color-focus);
+  outline-offset: -1px;
 }
 
 .crewlet-time-window.is-disabled,
@@ -301,11 +307,18 @@ svg.crewlet-time-window__tick {
   transition: border-color var(--motion-duration-fast) var(--motion-easing-default);
 }
 
-.crewlet-time-window__masked:focus-within {
-  outline: 2px solid transparent;
-  outline-offset: 2px;
-  border-color: var(--color-focus);
-  box-shadow: var(--shadow-focus);
+/*
+ * THE BOX RINGS ONCE, AS A FIELD DOES. It drew the field register's old
+ * indicator: the border recoloured to the focus colour AND --shadow-focus,
+ * which is itself a ring (a background-coloured gap, then a band), so a
+ * focused box showed two accent edges with a gap between them, and the
+ * transparent outline under them was a third that forced-colors mode paints.
+ * What is left is the field's one outline on the inset offset, over the box's
+ * own boundary (see Input.css), keyed on the box's own input.
+ */
+.crewlet-time-window__masked:has(.crewlet-time-window__masked-input:focus-visible) {
+  outline: 1px solid var(--color-focus);
+  outline-offset: -1px;
 }
 
 .crewlet-time-window__masked-input {

package/dist/Tree/layout.d.ts

@@ -96,9 +96,9 @@ export interface LayoutGaps {
      *
      * IT IS PART OF THE LAYOUT rather than padding on whatever draws it, because
      * the canvas scrolls and CLIPS: a margin drawn as padding is outside the
-     * scrollable content, so the outermost card's halo, its focus ring and the
-     * control hanging under it are cut off at the frame at exactly the moment a
-     * reader has panned to that card. Unset, none.
+     * scrollable content, so the control hanging under the outermost card is cut
+     * off at the frame at exactly the moment a reader has panned to that card.
+     * Unset, none.
      */
     margin?: number | undefined;
 }

package/dist/TreeCanvas/TreeCanvas.d.ts

@@ -76,7 +76,7 @@
  * of its suite.
  */
 import { type KeyboardEvent, type MouseEvent, type ReactNode, type Ref } from 'react';
-import { type CanvasLabels } from '../Canvas/index.js';
+import { type CanvasGround, type CanvasLabels } from '../Canvas/index.js';
 import { type TreeConnectorShape, type TreeInput, type TreeItemAction, type LayoutRanks, type TreeModel, type TreeViewHandle } from '../Tree/index.js';
 /** A card of the layout: its id and the cards nested under it. */
 export interface TreeCardInput {
@@ -93,9 +93,9 @@ export interface TreeCardInput {
  * with no such choice derives from a stable identity.
  *
  * A NAMED SET RATHER THAN A COLOUR. A caller that could hand in any colour
- * would hand in a literal, and the fill, the border, the halo and the ink of a
- * tinted card are four measured steps of one hue rather than one value with
- * three alphas applied by whoever drew it last.
+ * would hand in a literal, and the fill, the border and the ink of a tinted
+ * card are measured steps of one hue rather than one value with alphas applied
+ * by whoever drew it last.
  */
 export type TreeCardTone = 'purple' | 'cyan' | 'green' | 'amber' | 'rose' | 'blue';
 /**
@@ -417,6 +417,8 @@ export interface TreeCanvasProps {
      * which says WHICH node the surface is about.
      */
     dimmed?: boolean | undefined;
+    /** What the field under the chart is drawn as: see [CanvasProps.ground]. */
+    ground?: CanvasGround | undefined;
     /**
      * A node being composed in the chart rather than in a surface over it: see
      * [TreeComposing]. Null, and the chart is the data and nothing else.
@@ -427,4 +429,4 @@ export interface TreeCanvasProps {
     ref?: Ref<TreeCanvasHandle> | undefined;
     className?: string | undefined;
 }
-export declare function TreeCanvas({ label, nodes, cards, cardOf, renderCard, renderUnder, cardTone, appearance, ranks, connector, groups, onNodeKey, onNodeKeyDown, hasNodeMenu, selectedId, onSelect, anchorNode, overlay, controlsPlacement, controlsExtra, controlsBelow, hint, dimmed, composing, labels, ref, className, }: TreeCanvasProps): import("react").JSX.Element;
+export declare function TreeCanvas({ label, nodes, cards, cardOf, renderCard, renderUnder, cardTone, appearance, ranks, connector, groups, onNodeKey, onNodeKeyDown, hasNodeMenu, selectedId, onSelect, anchorNode, overlay, controlsPlacement, controlsExtra, controlsBelow, hint, dimmed, ground, composing, labels, ref, className, }: TreeCanvasProps): import("react").JSX.Element;

package/dist/TreeCanvas/index.js

@@ -1,10 +1,10 @@
-export { TreeCanvas } from '../chunk-FFKYL7Z3.js';
+export { TreeCanvas } from '../chunk-L7THQMFB.js';
 import '../chunk-S3BCVWTU.js';
-import '../chunk-2HY7I3NT.js';
+import '../chunk-VE6LD3KM.js';
 import '../chunk-53DVJCVW.js';
 import '../chunk-7RPGY3JE.js';
 import '../chunk-R25RGPUB.js';
-import '../chunk-4UQ7SMPK.js';
-import '../chunk-ZAO4HHXI.js';
+import '../chunk-4FQT6ZAY.js';
+import '../chunk-OG6CL3EB.js';
 import '../chunk-BZFWDIV6.js';
 import '../chunk-ODEQTPFM.js';