@sableui/react 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/bin/sable-lint.mjs +5 -1
  3. package/dist/{_contract-CkqXDVww.d.ts → _contract-CDa9-NdB.d.ts} +47 -1
  4. package/dist/blocks/wallet-block.js +2 -2
  5. package/dist/components/app-shell/app-shell-frame.js +16 -0
  6. package/dist/components/app-shell/app-shell-main.js +12 -0
  7. package/dist/components/app-shell/app-shell.js +28 -4
  8. package/dist/components/app-shell/app-shell.meta.js +88 -4
  9. package/dist/components/area-chart/area-chart.meta.js +6 -1
  10. package/dist/components/attachment/attachment.meta.js +2 -1
  11. package/dist/components/attachment/attachment.variants.js +1 -1
  12. package/dist/components/badge/badge.meta.js +8 -1
  13. package/dist/components/badge/badge.variants.js +7 -7
  14. package/dist/components/banner/banner.meta.js +6 -1
  15. package/dist/components/banner/banner.variants.js +5 -5
  16. package/dist/components/bar-chart/bar-chart.meta.js +6 -1
  17. package/dist/components/caret-menu/caret-menu.js +5 -6
  18. package/dist/components/chat-composer/chat-composer.meta.js +2 -2
  19. package/dist/components/chat-composer/chat-composer.variants.js +1 -1
  20. package/dist/components/color-field/color-field.js +6 -8
  21. package/dist/components/combobox/combobox.js +27 -5
  22. package/dist/components/combobox/combobox.meta.js +10 -2
  23. package/dist/components/command-menu/command-menu.js +14 -3
  24. package/dist/components/command-menu/command-menu.meta.js +9 -1
  25. package/dist/components/date-picker/date-picker.meta.js +2 -2
  26. package/dist/components/feedback/feedback.js +1 -1
  27. package/dist/components/feedback/feedback.meta.js +2 -1
  28. package/dist/components/gradient-art/gradient-art.js +8 -5
  29. package/dist/components/gradient-art/gradient-art.meta.js +35 -2
  30. package/dist/components/input/input.meta.js +11 -3
  31. package/dist/components/input-group/input-group.js +1 -1
  32. package/dist/components/input-group/input-group.meta.js +1 -1
  33. package/dist/components/line-chart/line-chart.meta.js +6 -1
  34. package/dist/components/menu/menu.js +1 -1
  35. package/dist/components/meter/meter.js +53 -7
  36. package/dist/components/meter/meter.meta.js +51 -4
  37. package/dist/components/meter/meter.variants.js +43 -7
  38. package/dist/components/note/note.meta.js +5 -1
  39. package/dist/components/note/note.variants.js +4 -4
  40. package/dist/components/number-field/number-field.meta.js +2 -2
  41. package/dist/components/otp-field/otp-field.meta.js +2 -2
  42. package/dist/components/panel-group/panel-group.js +5 -8
  43. package/dist/components/pie-chart/pie-chart.meta.js +6 -1
  44. package/dist/components/radar-chart/radar-chart.meta.js +6 -1
  45. package/dist/components/radial-chart/radial-chart.meta.js +6 -1
  46. package/dist/components/search-input/search-input.meta.js +11 -3
  47. package/dist/components/segmented-bar/segmented-bar.meta.js +8 -1
  48. package/dist/components/segmented-bar/segmented-bar.variants.js +7 -7
  49. package/dist/components/select/select.js +1 -1
  50. package/dist/components/select/select.meta.js +2 -2
  51. package/dist/components/sheet/sheet.js +5 -4
  52. package/dist/components/sidebar/sidebar.js +16 -1
  53. package/dist/components/sidebar/sidebar.meta.js +7 -2
  54. package/dist/components/sparkline/sparkline.meta.js +8 -1
  55. package/dist/components/status-dot/status-dot.meta.js +8 -1
  56. package/dist/components/status-dot/status-dot.variants.js +7 -7
  57. package/dist/components/stepper/stepper.meta.js +2 -1
  58. package/dist/components/stepper/stepper.variants.js +1 -1
  59. package/dist/components/table/table.meta.js +4 -4
  60. package/dist/components/textarea/textarea.js +5 -0
  61. package/dist/components/textarea/textarea.meta.js +3 -3
  62. package/dist/file-hashes.json +91 -88
  63. package/dist/foundations/accessibility.js +5 -0
  64. package/dist/index.d.ts +132 -24
  65. package/dist/index.js +9 -1
  66. package/dist/lib/chart/types.js +8 -8
  67. package/dist/lib/chart/use-arrival.js +5 -4
  68. package/dist/lib/field-shell.js +1 -1
  69. package/dist/lib/highlight-glide.js +6 -6
  70. package/dist/lib/scrub-gesture.js +6 -6
  71. package/dist/lib/use-caret-trigger.js +11 -18
  72. package/dist/lib/use-match-highlight.js +69 -0
  73. package/dist/lib/use-smooth-wheel.js +10 -8
  74. package/dist/presets/index.d.ts +13 -2
  75. package/dist/presets/index.js +17 -1
  76. package/dist/styles.css +100 -0
  77. package/dist/{theme-provider-CdSicAad.d.ts → theme-provider-BydfM5Z0.d.ts} +1 -1
  78. package/dist/themes/_contract.js +14 -0
  79. package/dist/themes/atelier/atelier.css +18 -0
  80. package/dist/themes/atelier/index.d.ts +1 -1
  81. package/dist/themes/contrast.js +48 -1
  82. package/dist/themes/ember/ember.css +18 -0
  83. package/dist/themes/ember/index.d.ts +1 -1
  84. package/dist/themes/index.d.ts +2 -2
  85. package/dist/themes/meridian/index.d.ts +1 -1
  86. package/dist/themes/meridian/meridian.css +18 -0
  87. package/dist/themes/poppy/index.d.ts +1 -1
  88. package/dist/themes/poppy/poppy.css +18 -0
  89. package/dist/themes/prism/index.d.ts +1 -1
  90. package/dist/themes/prism/prism.css +18 -0
  91. package/dist/themes/sable/index.d.ts +1 -1
  92. package/dist/themes/sable/sable.css +18 -0
  93. package/dist/themes/verdant/index.d.ts +1 -1
  94. package/dist/themes/verdant/verdant.css +18 -0
  95. package/llms/blocks/wallet-block.md +5 -4
  96. package/llms/components/app-shell.md +72 -3
  97. package/llms/components/area-chart.md +1 -1
  98. package/llms/components/attachment.md +1 -1
  99. package/llms/components/badge.md +1 -1
  100. package/llms/components/banner.md +1 -1
  101. package/llms/components/bar-chart.md +1 -1
  102. package/llms/components/chat-composer.md +1 -1
  103. package/llms/components/combobox.md +2 -1
  104. package/llms/components/command-menu.md +3 -2
  105. package/llms/components/date-picker.md +1 -1
  106. package/llms/components/feedback.md +1 -1
  107. package/llms/components/gradient-art.md +28 -1
  108. package/llms/components/input-group.md +1 -1
  109. package/llms/components/input.md +4 -2
  110. package/llms/components/line-chart.md +1 -1
  111. package/llms/components/meter.md +33 -4
  112. package/llms/components/note.md +1 -1
  113. package/llms/components/number-field.md +1 -1
  114. package/llms/components/otp-field.md +1 -1
  115. package/llms/components/pie-chart.md +1 -1
  116. package/llms/components/radar-chart.md +1 -1
  117. package/llms/components/radial-chart.md +1 -1
  118. package/llms/components/search-input.md +20 -2
  119. package/llms/components/segmented-bar.md +1 -1
  120. package/llms/components/select.md +1 -1
  121. package/llms/components/sidebar.md +3 -2
  122. package/llms/components/sparkline.md +1 -1
  123. package/llms/components/status-dot.md +1 -1
  124. package/llms/components/stepper.md +1 -1
  125. package/llms/components/table.md +2 -2
  126. package/llms/components/textarea.md +2 -2
  127. package/llms/foundations/accessibility.md +1 -0
  128. package/llms/reference/token-intent.md +22 -2
  129. package/llms/reference/utilities.md +5 -2
  130. package/llms-full.txt +222 -49
  131. package/llms.txt +2 -2
  132. package/package.json +1 -1
  133. package/registry.json +396 -57
  134. package/scripts/lint-rules.mjs +6 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,78 @@
1
1
  # What's new
2
2
 
3
+ ## 0.16.0
4
+
5
+ Five pieces of the calm, product-chrome look that AI and B2B tools share:
6
+ tick-bar budgets, pastel art, filled fields, an inset frame and a dither
7
+ texture. Each is told through the theme, so every preset can wear it.
8
+
9
+ - **New: segmented meters.** `<Meter segments={40} />` draws the bar as a row
10
+ of ticks — a spend limit, credits left, a lead score, months of data — read
11
+ at a glance. Any reading above `min` shows at least one tick, and when the
12
+ value changes the fill runs through the ticks from the edge it is leaving.
13
+ Size the count to the track (about one tick per 8px) so a tick stays taller
14
+ than it is wide. `shape="ring"` ignores it.
15
+ - **New: `GradientArt intensity="soft"`.** The same art as a pastel of itself:
16
+ lifted and quieted, bright in dark mode too. It is a stage for floating
17
+ chips, logo tiles and card header bands, not a surface for text.
18
+ - **New: the field tokens, `field` and `field-border`.** Every text field —
19
+ Input, Textarea, Select, Combobox, SearchInput, NumberField, OTPField,
20
+ DatePicker, InputGroup, ChatComposer and CommandMenuTrigger — now paints
21
+ this pair, outlined on the card by default exactly as before. A theme fills
22
+ them all at once with `--theme-field: var(--muted)` and
23
+ `--theme-field-border: transparent`. Canvas has a matching **Fields**
24
+ control (Preset / Outline / Filled), and presets may set both hooks.
25
+ A hand-built field wearing `border-field-border` is caught by
26
+ `lookalike-control` like one wearing `border-input`.
27
+ - **New: `AppShell frame="inset"`.** From `lg`, the rail and a small gap sit on
28
+ one ground and main becomes a rounded, bordered panel that scrolls inside
29
+ itself while the rail stays put. The Sidebar in the slot drops its border
30
+ and fills the row, and its footer rule spans the content column rather than
31
+ running out into the gap; below `lg` nothing changes. The ground is a new derived
32
+ token, `shell-ground` — one step off the rail, so the panel reads as lifted
33
+ even in themes whose rail is the page colour; tune it with
34
+ `--theme-shell-ground`. Inset moves the desktop scroll from `window` to
35
+ `#main-content`, so scroll listeners (restoration, scroll-to-top, scrollspy)
36
+ must target `main`.
37
+ - **New utility: `texture-dither`.** A faint field of tiny squares that
38
+ dissolves, painted in `border-strong` so it follows every theme — decoration
39
+ for behind an empty state or a page header. `--dither-fade`,
40
+ `--dither-size` and `--dither-color` tune it.
41
+ - **Status and tone colours at graphic strength.** Meters, segmented bars,
42
+ status dots, chart series and the soft tints behind badges, banners and
43
+ notes were painted with the label fills — dark enough to carry white text,
44
+ so in light mode they read brown, forest green and plum. They now read new
45
+ `-mark` tokens (`success-mark`, `tone-warning-mark`, `destructive-mark`,
46
+ `tone-info-mark`, `tone-1/2/3-mark`): the same hue lifted and saturated,
47
+ held to a 2:1 visibility floor on the page instead of a text ratio. Every
48
+ bundled theme tunes its own in both modes, and keeps its character —
49
+ Ember's olive, Poppy's pastels and Atelier's grey tone stay theirs; a
50
+ preset sets `--theme-*-mark` or gets one derived from its fill. Labels are
51
+ unchanged: solid badges, banners and buttons keep their fills, and text
52
+ keeps `-text`. `markFor` (from `@sableui/react/presets`) derives a mark the
53
+ same way, and Canvas moves the marks with any tone it generates.
54
+ - **Canvas: a brand colour no longer flattens the tones.** Info is treated
55
+ as the status it is: it leans toward the brand within the blues instead of
56
+ being repainted (Brand only made it the brand, so a green brand's info read
57
+ as success; the schemes spun it anywhere). A status also keeps 25° off the
58
+ brand's own hue when its band allows, so a green brand gets a teal success
59
+ rather than a second copy of itself. And Brand only is a family you can tell
60
+ apart — a deep brand, a lighter neighbour and a muted sibling — instead of
61
+ one hue in four near-identical depths.
62
+ - **Table:** `numeric` on TableHead and TableCell is now documented.
63
+ - **New: search matches light up.** Combobox and CommandMenu paint the typed
64
+ text in each row's label, on a tint of the theme's `highlight`. It uses the CSS
65
+ Custom Highlight API, so rows get no `<mark>` wrappers and their accessible
66
+ names stay whole; browsers without it simply show no paint. Combobox lights
67
+ only what was typed, not a label a pick filled in. `highlightMatches={false}`
68
+ turns it off on either.
69
+ - **New hook: `useMatchHighlight(query, { selector })`.** The same paint for a
70
+ results list you filter yourself, such as a SearchInput over a table: it
71
+ returns a callback ref for the results container.
72
+ - **Textarea:** text you are editing no longer rewraps above the caret when
73
+ the field sits inside a `text-pretty` or `text-balance` block
74
+ (`text-wrap-style: stable`). ChatComposer gets the same fix.
75
+
3
76
  ## 0.15.0
4
77
 
5
78
  Motion with some life in it: small things that turn on now land like events,
@@ -44,7 +44,11 @@ if (!existsSync(registryPath)) {
44
44
  }
45
45
  const REGISTRY = JSON.parse(readFileSync(registryPath, "utf8"))
46
46
 
47
- const semanticTokens = new Set((REGISTRY.tokens?.semantic ?? []).map((t) => t.name))
47
+ // Derived colours (`tone-warning-mark`, `field`, `shell-ground`…) are real tokens
48
+ // too: every theme gets them, so a utility naming one is not a typo.
49
+ const semanticTokens = new Set(
50
+ [...(REGISTRY.tokens?.semantic ?? []), ...(REGISTRY.tokens?.derived ?? [])].map((t) => (typeof t === "string" ? t : t.name)),
51
+ )
48
52
  // Motion token NAMES are reassembled from the registry's durations/easings lists.
49
53
  // A test in the package asserts this reconstruction equals _contract.ts exactly,
50
54
  // so the consumer linter can never validate against a drifted vocabulary.
@@ -147,6 +147,52 @@ declare const ART_TOKENS: readonly ["art-1", "art-2", "art-3", "art-4", "art-5",
147
147
  * 2 doubles it, for a theme that wants every colour to read as its own.
148
148
  */
149
149
  declare const PALETTE_TOKENS: readonly ["palette-harmony"];
150
+ /**
151
+ * The text field's surface — derived like the edges, with a `--theme-*` hook.
152
+ *
153
+ * - `field` is the fill of every text-entry field (Input, Textarea, Select,
154
+ * Combobox, SearchInput, InputGroup, ChatComposer…). It defaults to `card`.
155
+ * - `field-border` is that field's outline. It defaults to `input`.
156
+ *
157
+ * Together they are the one choice a theme makes about how a field reads:
158
+ * outlined on the card (the default), or filled — `--theme-field: var(--muted)`
159
+ * with `--theme-field-border: transparent` — the borderless grey well some
160
+ * product UIs use for every input. Every field wears the pair through
161
+ * lib/field-shell, so the choice reaches them all at once instead of being
162
+ * restyled per control.
163
+ */
164
+ declare const FIELD_TOKENS: readonly ["field", "field-border"];
165
+ /**
166
+ * The ground of an inset app frame — derived, with a `--theme-*` hook.
167
+ *
168
+ * `<AppShell frame="inset">` lifts main into a rounded panel and paints the
169
+ * rail and the gap around it as one surface. That surface cannot simply be
170
+ * `sidebar`: most themes paint the rail the page's own colour, so the panel
171
+ * sat on a ground of the same colour and only its hairline told them apart.
172
+ * `shell-ground` is one small step off the rail toward its ink, so the panel
173
+ * reads as lifted in every theme, and a theme sets `--theme-shell-ground` for
174
+ * a stronger or tinted ground.
175
+ */
176
+ declare const APP_SHELL_TOKENS: readonly ["shell-ground"];
177
+ /**
178
+ * Status and tone colours at GRAPHIC strength — derived, with `--theme-*` hooks.
179
+ *
180
+ * Each status colour already comes in two: the fill, which carries a label
181
+ * (dark enough for white ink at 4.5:1 in light mode), and `-text`, the colour
182
+ * as ink on a surface. Neither is right for a mark that carries no text — a
183
+ * meter's fill, a segmented bar, a status dot, a chart series, the soft tint
184
+ * behind a badge. Those were painted with the label fill, so in light mode
185
+ * every one of them was a deep brown, forest green or plum: muddy, and 5–9:1
186
+ * against the page when a graphic needs far less.
187
+ *
188
+ * A mark is the same hue lifted and saturated. It is held to a VISIBILITY floor
189
+ * of 2:1 against `background` and `card` (NON_TEXT_HARD_FLOOR, the `graphic`
190
+ * tier in contrast.ts), not to a text ratio: every mark that uses it sits
191
+ * beside text that states the same thing (a meter's reading, a dot's label).
192
+ * A graphic that is the ONLY carrier of its meaning still owes WCAG 1.4.11's
193
+ * 3:1 — use the fill, or add the text.
194
+ */
195
+ declare const MARK_TOKENS: readonly ["destructive-mark", "success-mark", "tone-warning-mark", "tone-info-mark", "tone-1-mark", "tone-2-mark", "tone-3-mark"];
150
196
  /**
151
197
  * UI type tiers (mode-independent) — the chrome typography register.
152
198
  *
@@ -193,4 +239,4 @@ interface ThemeManifest {
193
239
  };
194
240
  }
195
241
 
196
- export { ART_TOKENS as A, DENSITY_TOKENS as D, MOTION_TOKENS as M, PALETTE_TOKENS as P, RADIUS_TOKENS as R, SEMANTIC_TOKENS as S, type ThemeManifest as T, WORKSPACE_SURFACE_TOKENS as W, type ThemeMode as a, type DensityToken as b, type MotionToken as c, RHYTHM_TOKENS as d, type RadiusToken as e, type RhythmToken as f, type SemanticToken as g, TYPE_OVERLINE_TOKENS as h, TYPE_REFINEMENT_TOKENS as i, TYPE_SCALE_TOKENS as j, TYPE_UI_TOKENS as k, type TypeOverlineToken as l, type TypeRefinementToken as m, type TypeScaleToken as n, type TypeUiToken as o, type WorkspaceSurfaceToken as p };
242
+ export { APP_SHELL_TOKENS as A, DENSITY_TOKENS as D, FIELD_TOKENS as F, MARK_TOKENS as M, PALETTE_TOKENS as P, RADIUS_TOKENS as R, SEMANTIC_TOKENS as S, type ThemeManifest as T, WORKSPACE_SURFACE_TOKENS as W, type ThemeMode as a, ART_TOKENS as b, type DensityToken as c, MOTION_TOKENS as d, type MotionToken as e, RHYTHM_TOKENS as f, type RadiusToken as g, type RhythmToken as h, type SemanticToken as i, TYPE_OVERLINE_TOKENS as j, TYPE_REFINEMENT_TOKENS as k, TYPE_SCALE_TOKENS as l, TYPE_UI_TOKENS as m, type TypeOverlineToken as n, type TypeRefinementToken as o, type TypeScaleToken as p, type TypeUiToken as q, type WorkspaceSurfaceToken as r };
@@ -11,6 +11,7 @@ var activity = [
11
11
  { title: "Refund", detail: "Order 1042 \xB7 Yesterday", amount: "-24.00", tone: "2" },
12
12
  { title: "Payout", detail: "To checking \xB7 Mon", amount: "-850.00", tone: "3" }
13
13
  ];
14
+ var TONE_MARK = { "1": "bg-tone-1-mark", "2": "bg-tone-2-mark", "3": "bg-tone-3-mark" };
14
15
  function WalletBlock({ className, framed = true, onSend, onReceive }) {
15
16
  return /* @__PURE__ */ jsxs(Card, { variant: framed ? "default" : "flat", className: cn("w-full max-w-xs", className), children: [
16
17
  /* @__PURE__ */ jsxs(CardHeader, { children: [
@@ -30,8 +31,7 @@ function WalletBlock({ className, framed = true, onSend, onReceive }) {
30
31
  "span",
31
32
  {
32
33
  "aria-hidden": true,
33
- className: "block size-8 rounded-full",
34
- style: { background: `oklch(from var(--tone-${item.tone}) clamp(0.5, calc(l + 0.16), 0.9) max(calc(c * 1.25), 0.1) h)` }
34
+ className: cn("block size-8 rounded-full", TONE_MARK[item.tone])
35
35
  }
36
36
  ),
37
37
  title: item.title,
@@ -0,0 +1,16 @@
1
+ "use client";
2
+
3
+ // src/components/app-shell/app-shell-frame.tsx
4
+ import { createContext, useContext } from "react";
5
+ import { jsx } from "react/jsx-runtime";
6
+ var AppShellFrameContext = createContext(null);
7
+ function AppShellFrameProvider({ frame, children }) {
8
+ return /* @__PURE__ */ jsx(AppShellFrameContext.Provider, { value: frame, children });
9
+ }
10
+ function useAppShellFrame() {
11
+ return useContext(AppShellFrameContext);
12
+ }
13
+ export {
14
+ AppShellFrameProvider,
15
+ useAppShellFrame
16
+ };
@@ -0,0 +1,12 @@
1
+ "use client";
2
+
3
+ // src/components/app-shell/app-shell-main.tsx
4
+ import { useScrollActivity } from "../../lib/use-scroll-activity.js";
5
+ import { jsx } from "react/jsx-runtime";
6
+ function AppShellMain({ scrolls, ...props }) {
7
+ const trackScroll = useScrollActivity();
8
+ return /* @__PURE__ */ jsx("main", { ref: scrolls ? trackScroll : void 0, ...props });
9
+ }
10
+ export {
11
+ AppShellMain
12
+ };
@@ -1,6 +1,8 @@
1
1
  // src/components/app-shell/app-shell.tsx
2
2
  import { cn } from "../../lib/cn.js";
3
3
  import { AppShellDock } from "./app-shell-dock.js";
4
+ import { AppShellFrameProvider } from "./app-shell-frame.js";
5
+ import { AppShellMain } from "./app-shell-main.js";
4
6
  import { SkipLink } from "./skip-link.js";
5
7
  import { jsx, jsxs } from "react/jsx-runtime";
6
8
  function AppShell({
@@ -10,18 +12,27 @@ function AppShell({
10
12
  bottomNav,
11
13
  dock,
12
14
  overlays,
15
+ frame = "flush",
13
16
  className,
14
17
  children,
15
18
  ...rest
16
19
  }) {
20
+ const inset = frame === "inset";
17
21
  return /* @__PURE__ */ jsxs(
18
22
  "div",
19
23
  {
24
+ "data-frame": inset ? "inset" : void 0,
20
25
  className: cn(
21
26
  // `overflow-x-clip` (not `-hidden`) contains horizontal bleed WITHOUT
22
27
  // establishing a scroll container — `-hidden` forces `overflow-y: auto`,
23
28
  // which breaks `position: sticky` on a descendant Sidebar.
24
29
  "flex min-h-screen flex-col overflow-x-clip bg-background text-foreground",
30
+ // Inset, from lg: the shell IS the viewport and never scrolls — main
31
+ // does. The ground is the rail's surface, so the rail and the gap
32
+ // around the panel read as one plane. A page-surface rail (Sidebar
33
+ // surface="page") is page-coloured, so the ground follows it and the
34
+ // panel's border carries the lift.
35
+ inset && "lg:h-dvh lg:min-h-0 lg:bg-shell-ground lg:[&:has(>[data-app-shell-body]>[data-surface=page])]:bg-background",
25
36
  className
26
37
  ),
27
38
  ...rest,
@@ -29,16 +40,29 @@ function AppShell({
29
40
  /* @__PURE__ */ jsx(SkipLink, {}),
30
41
  banners ? /* @__PURE__ */ jsx("div", { className: "relative z-(--z-nav)", children: banners }) : null,
31
42
  header,
32
- /* @__PURE__ */ jsxs("div", { className: "flex min-h-0 flex-1", children: [
33
- sidebar,
43
+ /* @__PURE__ */ jsxs("div", { "data-app-shell-body": inset ? "" : void 0, className: "flex min-h-0 flex-1", children: [
44
+ inset ? /* @__PURE__ */ jsx(AppShellFrameProvider, { frame: "inset", children: sidebar }) : sidebar,
34
45
  /* @__PURE__ */ jsx(
35
- "main",
46
+ AppShellMain,
36
47
  {
37
48
  id: "main-content",
49
+ scrolls: inset,
50
+ tabIndex: inset ? -1 : void 0,
38
51
  style: { containerType: "inline-size" },
39
52
  className: cn(
40
53
  "min-w-0 flex-1",
41
- bottomNav && "pb-[calc(var(--nav-height)+env(safe-area-inset-bottom,0px))] lg:pb-0"
54
+ bottomNav && "pb-[calc(var(--nav-height)+env(safe-area-inset-bottom,0px))] lg:pb-0",
55
+ // The inset panel. A spacing-step gap on the open sides (the rail
56
+ // is the leading one). Banners and the dock are in flow in the
57
+ // shell's column, so the bottom gap already sits above a dock.
58
+ // Sticky children stick to the panel's top, and the overflow
59
+ // clips them to its rounded corners. A resting surface: a hairline
60
+ // edge and the subtlest raise, never a floating shadow.
61
+ inset && cn(
62
+ "outline-none lg:m-2 lg:overflow-y-auto lg:overscroll-contain scrollbar-quiet",
63
+ "lg:rounded-lg lg:border lg:border-border lg:bg-background lg:shadow-sm",
64
+ sidebar && "lg:ms-0"
65
+ )
42
66
  ),
43
67
  children
44
68
  }
@@ -15,7 +15,12 @@ var appShellMeta = {
15
15
  "dock",
16
16
  "player bar",
17
17
  "now playing",
18
- "persistent"
18
+ "persistent",
19
+ "inset",
20
+ "inset frame",
21
+ "floating panel",
22
+ "rounded content",
23
+ "scroll container"
19
24
  ],
20
25
  usage: {
21
26
  description: "Use AppShell as the outer product frame for authenticated or app-like experiences. It coordinates responsive chrome slots and guarantees a skip link plus main landmark; put route content inside the children and let AppHeader, Sidebar, BottomNav, and Banner own their own semantics.",
@@ -36,10 +41,23 @@ var appShellMeta = {
36
41
  guidance: "do",
37
42
  description: "Wrap EVERY return of a route in its own Page or Region \u2014 including early returns for loading, empty and error states. AppShell's <main> deliberately carries no padding (it is a frame, and padding belongs to the region that chose the width), so a route that returns a bare spinner or error renders flush against the chrome. This is the most common conversion bug: the happy path gets a Page, the three early returns do not."
38
43
  },
44
+ {
45
+ guidance: "do",
46
+ description: `Use frame="inset" for dense, multi-pane product apps \u2014 a CRM, an issue tracker, an AI workspace \u2014 where framing the content as one raised panel on the rail's ground helps it read as the workspace and the rail as chrome. Keep the Sidebar on surface="rail" so its tint is the ground. Inset moves the page scroll from the window to <main id="main-content"> on desktop: point scroll listeners, scroll restoration and scroll-to-top at that element, not window.`
47
+ },
39
48
  {
40
49
  guidance: "dont",
41
50
  description: "Nest AppShell inside route cards or panels. It is page chrome, not local content."
42
51
  },
52
+ {
53
+ guidance: "dont",
54
+ description: "Wrap a route in its own h-full overflow-y-auto box inside an inset shell. main is already the page's scroll container; a second one traps the scrollbar inside a smaller box and breaks sticky headers and the skip link's scroll target. Scroll a genuinely separate pane (a list beside a detail view) with Scroller.",
55
+ instead: ["Scroller"]
56
+ },
57
+ {
58
+ guidance: "dont",
59
+ description: 'Combine frame="inset" with a full-width header bar above the rail. The inset ground is the rail running the full height of the window; a bar across the top cuts it off. Use the flush frame with Sidebar surface="page" for that layout.'
60
+ },
43
61
  {
44
62
  guidance: "dont",
45
63
  description: "Put desktop-only navigation in the mobile header slot or mobile-only controls in the sidebar slot."
@@ -64,7 +82,7 @@ var appShellMeta = {
64
82
  {
65
83
  name: "Main",
66
84
  required: true,
67
- description: "The route content landmark with id main-content."
85
+ description: 'The route content landmark with id main-content. With frame="inset", from lg it is a rounded, bordered panel that scrolls inside itself.'
68
86
  },
69
87
  {
70
88
  name: "Bottom nav",
@@ -113,6 +131,12 @@ var appShellMeta = {
113
131
  name: "overlays",
114
132
  type: "ReactNode",
115
133
  description: "Floating overlays \u2014 a message launcher, FAB, or modal mount points."
134
+ },
135
+ {
136
+ name: "frame",
137
+ type: '"flush" | "inset"',
138
+ default: '"flush"',
139
+ description: `How the desktop frame (lg and up) holds the content; below lg both are the same mobile layout with page scroll. "flush": main sits on the page beside the rail and the document scrolls. "inset": the shell fills the viewport and paints the shell-ground token (one step off the rail's surface, tunable with --theme-shell-ground) behind the rail and around the panel; main becomes a rounded-lg panel with a hairline border and shadow-sm, inset by a spacing step from the window edges, that scrolls inside itself (scrollbar-quiet) while the rail stays put. The Sidebar in the sidebar slot drops its right border and fills the row. main stays the #main-content target (tabIndex -1, so the skip link lands focus in the scroller) and the inline-size query container; sticky children stick to the panel's top; banners and the dock stay in flow, so the panel's bottom gap sits above a dock. With Sidebar surface="page" the ground is the page colour and the panel's border alone lifts it.`
116
140
  }
117
141
  ],
118
142
  subcomponents: [
@@ -126,9 +150,10 @@ var appShellMeta = {
126
150
  "Renders a skip link to #main-content as the first focusable element.",
127
151
  'Wraps content in a <main id="main-content"> landmark.',
128
152
  "Slot components own their own ARIA (nav landmarks, labels).",
129
- "The dock follows <main> in DOM order, so keyboard and screen-reader users reach the player after the page content, not before it."
153
+ "The dock follows <main> in DOM order, so keyboard and screen-reader users reach the player after the page content, not before it.",
154
+ 'With frame="inset", <main> is the desktop scroll container and takes tabIndex -1: the skip link moves focus into it, so PageDown and the arrow keys scroll the content, without adding a tab stop.'
130
155
  ],
131
- tokensUsed: ["background", "foreground", "primary", "primary-foreground"],
156
+ tokensUsed: ["background", "foreground", "primary", "primary-foreground", "sidebar", "shell-ground", "border"],
132
157
  examples: [
133
158
  {
134
159
  label: "Full frame",
@@ -154,6 +179,65 @@ var appShellMeta = {
154
179
  <Region max="feed">
155
180
  <PageHeader title="Home" description="Latest posts from people you follow." />
156
181
  </Region>
182
+ </AppShell>`
183
+ },
184
+ {
185
+ label: "Inset frame",
186
+ code: `<AppShell
187
+ frame="inset"
188
+ header={<AppHeader title="Pipeline" />}
189
+ sidebar={
190
+ <Sidebar>
191
+ <SidebarHeader>
192
+ <SidebarBrand mark={<Icon name="gem" variant="solid" />} label="Relay" render={<Link to="/" />} />
193
+ </SidebarHeader>
194
+ <SidebarNav>
195
+ <SidebarItem icon={<Icon name="inbox" />} label="Inbox" render={<Link to="/inbox" />} />
196
+ <SidebarItem icon={<Icon name="user" />} label="People" active render={<Link to="/people" />} />
197
+ <SidebarItem icon={<Icon name="folder" />} label="Companies" render={<Link to="/companies" />} />
198
+ </SidebarNav>
199
+ </Sidebar>
200
+ }
201
+ bottomNav={
202
+ <BottomNav>
203
+ <BottomNavItem icon={<Icon name="inbox" />} label="Inbox" render={<Link to="/inbox" />} />
204
+ <BottomNavItem icon={<Icon name="user" />} label="People" active render={<Link to="/people" />} />
205
+ <BottomNavItem icon={<Icon name="folder" />} label="Companies" render={<Link to="/companies" />} />
206
+ </BottomNav>
207
+ }
208
+ >
209
+ <Page max="wide" gap={4} className="py-6">
210
+ <PageHeader
211
+ title="People"
212
+ description="Everyone in your pipeline, newest first."
213
+ actions={<Button><Icon name="plus" />Add person</Button>}
214
+ />
215
+ <Card>
216
+ <CardContent flush>
217
+ <Table>
218
+ <TableHeader>
219
+ <TableRow>
220
+ <TableHead>Name</TableHead>
221
+ <TableHead>Company</TableHead>
222
+ <TableHead numeric>Deals</TableHead>
223
+ </TableRow>
224
+ </TableHeader>
225
+ <TableBody>
226
+ <TableRow>
227
+ <TableCell>Ada Lovelace</TableCell>
228
+ <TableCell>Northwind</TableCell>
229
+ <TableCell numeric>4</TableCell>
230
+ </TableRow>
231
+ <TableRow>
232
+ <TableCell>Grace Hopper</TableCell>
233
+ <TableCell>Harbor Labs</TableCell>
234
+ <TableCell numeric>2</TableCell>
235
+ </TableRow>
236
+ </TableBody>
237
+ </Table>
238
+ </CardContent>
239
+ </Card>
240
+ </Page>
157
241
  </AppShell>`
158
242
  },
159
243
  {
@@ -176,7 +176,12 @@ var areaChartMeta = {
176
176
  "popover",
177
177
  "popover-foreground",
178
178
  "foreground",
179
- "background"
179
+ "background",
180
+ "tone-warning-mark",
181
+ "tone-info-mark",
182
+ "tone-1-mark",
183
+ "tone-2-mark",
184
+ "tone-3-mark"
180
185
  ],
181
186
  motion: [
182
187
  {
@@ -146,7 +146,8 @@ var attachmentMeta = {
146
146
  "destructive",
147
147
  "overlay",
148
148
  "overlay-foreground",
149
- "ring"
149
+ "ring",
150
+ "destructive-mark"
150
151
  ],
151
152
  motion: [
152
153
  {
@@ -13,7 +13,7 @@ var attachmentVariants = cva(
13
13
  status: {
14
14
  idle: "border-border bg-card",
15
15
  uploading: "border-border bg-card",
16
- error: "border-destructive/40 bg-destructive/5"
16
+ error: "border-destructive-mark/40 bg-destructive-mark/5"
17
17
  },
18
18
  interactive: {
19
19
  true: "hover:border-border-strong",
@@ -137,7 +137,14 @@ var badgeMeta = {
137
137
  "tone-info-foreground",
138
138
  "success-foreground",
139
139
  "tone-warning-foreground",
140
- "destructive-foreground"
140
+ "destructive-foreground",
141
+ "destructive-mark",
142
+ "success-mark",
143
+ "tone-warning-mark",
144
+ "tone-info-mark",
145
+ "tone-1-mark",
146
+ "tone-2-mark",
147
+ "tone-3-mark"
141
148
  ],
142
149
  a11y: [
143
150
  "Badges are static text by default; do not rely on color alone for meaning.",
@@ -21,13 +21,13 @@ var MATRIX = {
21
21
  // mixed from them fell under 4.5:1 (Meridian dark destructive, 3.8:1).
22
22
  soft: {
23
23
  neutral: "bg-secondary text-secondary-foreground",
24
- "3": "bg-tone-3/15 text-[color-mix(in_oklch,var(--tone-3)_75%,var(--foreground))]",
25
- "2": "bg-tone-2/15 text-[color-mix(in_oklch,var(--tone-2)_75%,var(--foreground))]",
26
- "1": "bg-tone-1/15 text-[color-mix(in_oklch,var(--tone-1)_75%,var(--foreground))]",
27
- info: "bg-tone-info/15 text-[color-mix(in_oklch,var(--tone-info-text)_75%,var(--foreground))]",
28
- success: "bg-success/15 text-[color-mix(in_oklch,var(--success-text)_75%,var(--foreground))]",
29
- warning: "bg-tone-warning/15 text-[color-mix(in_oklch,var(--tone-warning-text)_75%,var(--foreground))]",
30
- destructive: "bg-destructive/15 text-[color-mix(in_oklch,var(--destructive-text)_75%,var(--foreground))]",
24
+ "3": "bg-tone-3-mark/15 text-[color-mix(in_oklch,var(--tone-3)_75%,var(--foreground))]",
25
+ "2": "bg-tone-2-mark/15 text-[color-mix(in_oklch,var(--tone-2)_75%,var(--foreground))]",
26
+ "1": "bg-tone-1-mark/15 text-[color-mix(in_oklch,var(--tone-1)_75%,var(--foreground))]",
27
+ info: "bg-tone-info-mark/15 text-[color-mix(in_oklch,var(--tone-info-text)_75%,var(--foreground))]",
28
+ success: "bg-success-mark/15 text-[color-mix(in_oklch,var(--success-text)_75%,var(--foreground))]",
29
+ warning: "bg-tone-warning-mark/15 text-[color-mix(in_oklch,var(--tone-warning-text)_75%,var(--foreground))]",
30
+ destructive: "bg-destructive-mark/15 text-[color-mix(in_oklch,var(--destructive-text)_75%,var(--foreground))]",
31
31
  ...families("soft")
32
32
  },
33
33
  outline: {
@@ -131,7 +131,12 @@ var bannerMeta = {
131
131
  "tone-1",
132
132
  "tone-1-foreground",
133
133
  "destructive",
134
- "destructive-foreground"
134
+ "destructive-foreground",
135
+ "destructive-mark",
136
+ "success-mark",
137
+ "tone-warning-mark",
138
+ "tone-info-mark",
139
+ "tone-1-mark"
135
140
  ],
136
141
  a11y: [
137
142
  "Static banners render as a labelled region (role=region); set `live` to announce dynamic status bars (role=status / role=alert) when they appear or change.",
@@ -20,11 +20,11 @@ var bannerVariants = cva(
20
20
  compoundVariants: [
21
21
  // Soft — a quiet tint of the tone (the default announcement look).
22
22
  { tone: "neutral", appearance: "soft", class: "bg-secondary text-secondary-foreground" },
23
- { tone: "info", appearance: "soft", class: "bg-tone-info/15 text-foreground" },
24
- { tone: "success", appearance: "soft", class: "bg-success/15 text-foreground" },
25
- { tone: "warning", appearance: "soft", class: "bg-tone-warning/15 text-foreground" },
26
- { tone: "1", appearance: "soft", class: "bg-tone-1/15 text-foreground" },
27
- { tone: "destructive", appearance: "soft", class: "bg-destructive/15 text-foreground" },
23
+ { tone: "info", appearance: "soft", class: "bg-tone-info-mark/15 text-foreground" },
24
+ { tone: "success", appearance: "soft", class: "bg-success-mark/15 text-foreground" },
25
+ { tone: "warning", appearance: "soft", class: "bg-tone-warning-mark/15 text-foreground" },
26
+ { tone: "1", appearance: "soft", class: "bg-tone-1-mark/15 text-foreground" },
27
+ { tone: "destructive", appearance: "soft", class: "bg-destructive-mark/15 text-foreground" },
28
28
  // Solid — the full tone fill with its paired ink, for loud states.
29
29
  { tone: "neutral", appearance: "solid", class: "bg-foreground text-background" },
30
30
  { tone: "info", appearance: "solid", class: "bg-tone-info text-tone-info-foreground" },
@@ -199,7 +199,12 @@ var barChartMeta = {
199
199
  "popover",
200
200
  "popover-foreground",
201
201
  "foreground",
202
- "background"
202
+ "background",
203
+ "tone-warning-mark",
204
+ "tone-info-mark",
205
+ "tone-1-mark",
206
+ "tone-2-mark",
207
+ "tone-3-mark"
203
208
  ],
204
209
  motion: [
205
210
  {
@@ -124,12 +124,11 @@ function CaretMenu({ trigger, label, status, children, className }) {
124
124
  if (popupRef.current?.contains(event.target)) return;
125
125
  place();
126
126
  };
127
- view.addEventListener("resize", place);
128
- view.addEventListener("scroll", onScroll, true);
129
- return () => {
130
- view.removeEventListener("resize", place);
131
- view.removeEventListener("scroll", onScroll, true);
132
- };
127
+ const listeners = new AbortController();
128
+ const { signal } = listeners;
129
+ view.addEventListener("resize", place, { signal });
130
+ view.addEventListener("scroll", onScroll, { capture: true, signal });
131
+ return () => listeners.abort();
133
132
  }, [open, field, place]);
134
133
  const [entered, setEntered] = useState(false);
135
134
  useEffect(() => {
@@ -223,8 +223,8 @@ var chatComposerMeta = {
223
223
  ],
224
224
  variants: { invalid: ["true", "false"] },
225
225
  tokensUsed: [
226
- "card",
227
- "input",
226
+ "field",
227
+ "field-border",
228
228
  "ring",
229
229
  "destructive",
230
230
  "foreground",
@@ -1,7 +1,7 @@
1
1
  // src/components/chat-composer/chat-composer.variants.ts
2
2
  import { cva } from "class-variance-authority";
3
3
  var chatComposerVariants = cva(
4
- "flex w-full flex-col gap-2 border border-input bg-card p-2 motion-interactive focus-within:ring-2 focus-within:ring-ring [--chat-composer-r:var(--chat-composer-radius,var(--card-inner-radius,calc(min(var(--button-radius,9999px),var(--control-sm)/2)+(--spacing(2))+1px)))] rounded-[var(--chat-composer-r)]",
4
+ "flex w-full flex-col gap-2 border border-field-border bg-field p-2 motion-interactive focus-within:ring-2 focus-within:ring-ring [--chat-composer-r:var(--chat-composer-radius,var(--card-inner-radius,calc(min(var(--button-radius,9999px),var(--control-sm)/2)+(--spacing(2))+1px)))] rounded-[var(--chat-composer-r)]",
5
5
  {
6
6
  variants: {
7
7
  invalid: {
@@ -27,15 +27,13 @@ function useAreaDrag(onChange) {
27
27
  );
28
28
  };
29
29
  emit(event.clientX, event.clientY);
30
+ const drag = new AbortController();
31
+ const { signal } = drag;
30
32
  const onMove = (e) => emit(e.clientX, e.clientY);
31
- const onUp = () => {
32
- window.removeEventListener("pointermove", onMove);
33
- window.removeEventListener("pointerup", onUp);
34
- window.removeEventListener("pointercancel", onUp);
35
- };
36
- window.addEventListener("pointermove", onMove);
37
- window.addEventListener("pointerup", onUp);
38
- window.addEventListener("pointercancel", onUp);
33
+ const onUp = () => drag.abort();
34
+ window.addEventListener("pointermove", onMove, { signal });
35
+ window.addEventListener("pointerup", onUp, { signal });
36
+ window.addEventListener("pointercancel", onUp, { signal });
39
37
  },
40
38
  [onChange]
41
39
  )