cursedbelt 5.90.0 → 5.92.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 (118) hide show
  1. package/dist/react/activity-bar/activityBar.css +5 -0
  2. package/dist/react/components/Autocomplete.d.ts +11 -2
  3. package/dist/react/components/Autocomplete.d.ts.map +1 -1
  4. package/dist/react/components/Autocomplete.js +7 -6
  5. package/dist/react/components/Autocomplete.js.map +1 -1
  6. package/dist/react/components/DataTable/DataTable.d.ts +14 -1
  7. package/dist/react/components/DataTable/DataTable.d.ts.map +1 -1
  8. package/dist/react/components/DataTable/DataTable.js +18 -7
  9. package/dist/react/components/DataTable/DataTable.js.map +1 -1
  10. package/dist/react/components/Drawer.d.ts +8 -1
  11. package/dist/react/components/Drawer.d.ts.map +1 -1
  12. package/dist/react/components/Drawer.js +2 -2
  13. package/dist/react/components/Drawer.js.map +1 -1
  14. package/dist/react/components/FileDropZone.d.ts.map +1 -1
  15. package/dist/react/components/FileDropZone.js +12 -76
  16. package/dist/react/components/FileDropZone.js.map +1 -1
  17. package/dist/react/components/Page.d.ts +9 -1
  18. package/dist/react/components/Page.d.ts.map +1 -1
  19. package/dist/react/components/Page.js +3 -2
  20. package/dist/react/components/Page.js.map +1 -1
  21. package/dist/react/components/TagsInput.d.ts +46 -4
  22. package/dist/react/components/TagsInput.d.ts.map +1 -1
  23. package/dist/react/components/TagsInput.js +92 -39
  24. package/dist/react/components/TagsInput.js.map +1 -1
  25. package/dist/react/components/TagsInputSuggesting.d.ts +8 -0
  26. package/dist/react/components/TagsInputSuggesting.d.ts.map +1 -0
  27. package/dist/react/components/TagsInputSuggesting.js +48 -0
  28. package/dist/react/components/TagsInputSuggesting.js.map +1 -0
  29. package/dist/react/components/dropTransfer.d.ts +53 -0
  30. package/dist/react/components/dropTransfer.d.ts.map +1 -0
  31. package/dist/react/components/dropTransfer.js +116 -0
  32. package/dist/react/components/dropTransfer.js.map +1 -0
  33. package/dist/react/components/suggestionList.d.ts +13 -0
  34. package/dist/react/components/suggestionList.d.ts.map +1 -0
  35. package/dist/react/components/suggestionList.js +19 -0
  36. package/dist/react/components/suggestionList.js.map +1 -0
  37. package/dist/react/file-tree/FileTree.d.ts.map +1 -1
  38. package/dist/react/file-tree/FileTree.js +9 -3
  39. package/dist/react/file-tree/FileTree.js.map +1 -1
  40. package/dist/react/index.d.ts +1 -0
  41. package/dist/react/index.d.ts.map +1 -1
  42. package/dist/react/index.js +1 -0
  43. package/dist/react/index.js.map +1 -1
  44. package/dist/react/media-gallery/MediaMetaEditor.d.ts +4 -4
  45. package/dist/react/nav/RailPlaces.d.ts +6 -2
  46. package/dist/react/nav/RailPlaces.d.ts.map +1 -1
  47. package/dist/react/nav/RailPlaces.js +1 -1
  48. package/dist/react/nav/RailPlaces.js.map +1 -1
  49. package/dist/react/optimistic/optimistic.d.ts +11 -2
  50. package/dist/react/optimistic/optimistic.d.ts.map +1 -1
  51. package/dist/react/optimistic/optimistic.js +4 -2
  52. package/dist/react/optimistic/optimistic.js.map +1 -1
  53. package/dist/scripts/guardrailsEnforce.d.ts.map +1 -1
  54. package/dist/styles-areas/analytics.css +14 -19
  55. package/dist/styles-areas/auth.css +3 -4
  56. package/dist/styles-areas/canvas-hud.css +3 -3
  57. package/dist/styles-areas/chat.css +10 -11
  58. package/dist/styles-areas/code-editor.css +2 -2
  59. package/dist/styles-areas/core.css +60 -54
  60. package/dist/styles-areas/data-table.css +14 -18
  61. package/dist/styles-areas/disk-usage.css +6 -7
  62. package/dist/styles-areas/emoji.css +2 -3
  63. package/dist/styles-areas/fields.css +15 -20
  64. package/dist/styles-areas/master-detail.css +3 -4
  65. package/dist/styles-areas/master-lock.css +1 -2
  66. package/dist/styles-areas/media-gallery.css +8 -10
  67. package/dist/styles-areas/rich-text.css +3 -3
  68. package/dist/styles-areas/stats.css +13 -17
  69. package/dist/styles-areas/wizard.css +6 -11
  70. package/dist/styles-utilities.css +10 -0
  71. package/package.json +7 -1
  72. package/scripts/guardrails-baseline.json +1 -1
  73. package/scripts/guardrailsEnforce.spec.ts +13 -0
  74. package/scripts/guardrailsEnforce.ts +5 -3
  75. package/scripts/styleAreas.ts +3 -0
  76. package/src/react/activity-bar/activityBar.css +5 -0
  77. package/src/react/components/Autocomplete.spec.tsx +55 -1
  78. package/src/react/components/Autocomplete.tsx +18 -43
  79. package/src/react/components/DataTable/DataTable.tsx +37 -7
  80. package/src/react/components/DataTable/columnHeaders.spec.tsx +83 -0
  81. package/src/react/components/Drawer.tsx +13 -0
  82. package/src/react/components/FileDropZone.tsx +12 -83
  83. package/src/react/components/Modal.spec.tsx +14 -0
  84. package/src/react/components/Page.spec.tsx +20 -0
  85. package/src/react/components/Page.tsx +35 -14
  86. package/src/react/components/TagsInput.spec.tsx +129 -14
  87. package/src/react/components/TagsInput.tsx +153 -85
  88. package/src/react/components/TagsInputSuggesting.tsx +94 -0
  89. package/src/react/components/dropTransfer.spec.ts +76 -0
  90. package/src/react/components/dropTransfer.ts +133 -0
  91. package/src/react/components/suggestionList.tsx +66 -0
  92. package/src/react/disk-usage/DiskUsage.spec.tsx +3 -0
  93. package/src/react/file-tree/FileTree.spec.tsx +14 -0
  94. package/src/react/file-tree/FileTree.tsx +9 -3
  95. package/src/react/index.ts +1 -0
  96. package/src/react/lib/floatingStyles.spec.ts +2 -1
  97. package/src/react/media-gallery/MediaMetaEditor.tsx +4 -4
  98. package/src/react/nav/RailPlaces.spec.tsx +6 -0
  99. package/src/react/nav/RailPlaces.tsx +12 -2
  100. package/src/react/optimistic/optimistic.spec.tsx +41 -0
  101. package/src/react/optimistic/optimistic.ts +13 -4
  102. package/src/styles-areas/analytics.css +14 -19
  103. package/src/styles-areas/auth.css +3 -4
  104. package/src/styles-areas/canvas-hud.css +3 -3
  105. package/src/styles-areas/chat.css +10 -11
  106. package/src/styles-areas/code-editor.css +2 -2
  107. package/src/styles-areas/core.css +60 -54
  108. package/src/styles-areas/data-table.css +14 -18
  109. package/src/styles-areas/disk-usage.css +6 -7
  110. package/src/styles-areas/emoji.css +2 -3
  111. package/src/styles-areas/fields.css +15 -20
  112. package/src/styles-areas/master-detail.css +3 -4
  113. package/src/styles-areas/master-lock.css +1 -2
  114. package/src/styles-areas/media-gallery.css +8 -10
  115. package/src/styles-areas/rich-text.css +3 -3
  116. package/src/styles-areas/stats.css +13 -17
  117. package/src/styles-areas/wizard.css +6 -11
  118. package/src/styles-utilities.css +10 -0
@@ -18,18 +18,16 @@
18
18
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
19
19
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
20
20
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
21
- * 56 candidate(s).
21
+ * 49 candidate(s).
22
22
  *
23
23
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
24
24
  * `bun run build` runs. The map of what is in which area, and why the areas are
25
25
  * import closures rather than a hand-written list, is scripts/styleAreas.ts.
26
26
  */
27
- @source inline("[&_svg]:size-3 appearance-none aspect-video backdrop-blur-xs bg-black/55 bg-black/80 bg-black/85");
28
- @source inline("bg-black/95 bg-white/10 border-none bottom-1 col collapse ease-in-out f");
29
- @source inline("focus-visible:ring-offset-black focus-within:border-field-ring focus-within:ring-2");
30
- @source inline("focus-within:ring-field-ring/30 hover:bg-white/20 hover:border-accent-solid hover:text-white");
31
- @source inline("inset-4 left-1 max-h-[40vh] min-h-20 min-h-dvh min-w-12 min-w-16 min-w-20 min-w-24 mx-1 pl-2");
32
- @source inline("place-items-center pr-1 resize-none right-1 right-4 size-9 text-tone-amber-ink");
33
- @source inline("text-tone-cyan-ink text-tone-emerald-ink text-tone-orange-ink text-tone-purple-ink");
34
- @source inline("text-tone-rose-ink text-tone-sky-ink text-tone-slate-ink text-white/70 top-1 top-4 translate");
35
- @source inline("translate-x-px w-40 w-48 zoom zoom-in");
27
+ @source inline("appearance-none aspect-video backdrop-blur-xs bg-black/55 bg-black/80 bg-black/85 bg-black/95");
28
+ @source inline("bg-white/10 border-none bottom-1 col collapse ease-in-out f focus-visible:ring-offset-black");
29
+ @source inline("hover:bg-white/20 hover:border-accent-solid hover:text-white inset-4 left-1 max-h-[40vh]");
30
+ @source inline("min-h-20 min-h-dvh min-w-12 min-w-16 min-w-20 mx-1 place-items-center resize-none right-1");
31
+ @source inline("right-4 size-9 text-tone-amber-ink text-tone-cyan-ink text-tone-emerald-ink text-tone-orange-ink");
32
+ @source inline("text-tone-purple-ink text-tone-rose-ink text-tone-sky-ink text-tone-slate-ink text-white/70");
33
+ @source inline("top-1 top-4 translate translate-x-px w-40 w-48 zoom zoom-in");
@@ -18,11 +18,11 @@
18
18
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
19
19
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
20
20
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
21
- * 8 candidate(s).
21
+ * 7 candidate(s).
22
22
  *
23
23
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
24
24
  * `bun run build` runs. The map of what is in which area, and why the areas are
25
25
  * import closures rather than a hand-written list, is scripts/styleAreas.ts.
26
26
  */
27
- @source inline("flex-nowrap focus-within:ring-2 focus-within:ring-offset-0 focus-within:ring-ring italic");
28
- @source inline("min-h-32 sm:flex-wrap top-full");
27
+ @source inline("flex-nowrap focus-within:ring-offset-0 focus-within:ring-ring italic min-h-32 sm:flex-wrap");
28
+ @source inline("top-full");
@@ -18,29 +18,25 @@
18
18
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
19
19
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
20
20
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
21
- * 103 candidate(s).
21
+ * 86 candidate(s).
22
22
  *
23
23
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
24
24
  * `bun run build` runs. The map of what is in which area, and why the areas are
25
25
  * import closures rather than a hand-written list, is scripts/styleAreas.ts.
26
26
  */
27
- @source inline("[&>div]:sm:[grid-template-columns:…] [&_svg]:size-3 [&_svg]:size-3.5 basis-40 bg-accent/15");
28
- @source inline("bg-accent/40 bg-background/70 bg-success/10 bg-warning/10 bg-warning/20 border-field-error");
29
- @source inline("border-l-2 border-l-border-strong border-l-destructive border-l-warning bottom-3 col col-span-2");
30
- @source inline("col-start-2 collapse cursor-help data-[ending-style]:opacity-0 data-[ending-style]:scale-95");
31
- @source inline("data-[highlighted]:bg-accent/10 data-[highlighted]:text-accent-strong");
32
- @source inline("data-[starting-style]:opacity-0 data-[starting-style]:scale-95 divide-x duration-100 first:pl-1");
33
- @source inline("focus-visible:ring-field-ring/40 focus-within:border-field-ring focus-within:ring-2");
34
- @source inline("focus-within:ring-field-ring/30 gap-x-1.5 gap-x-2 gap-y-0.5 grid-cols-[minmax(0,1fr)_auto]");
35
- @source inline("group-focus-visible/meter:opacity-100 group-focus-visible/stat:opacity-100");
36
- @source inline("group-focus-visible/tile:opacity-100 group-hover/meter:opacity-100 group-hover/stat:opacity-100");
37
- @source inline("group-hover/tile:opacity-100 group/meter group/stat group/tile h-105");
38
- @source inline("has-[[aria-invalid=true]]:border-field-error hover:bg-muted/50 hover:border-field-ring");
39
- @source inline("hover:text-warning last:pr-1 left-3 left-[var(--timeline-rail-x)] list-none max-h-64 min-h-20");
40
- @source inline("min-h-9 min-w-24 min-w-34 min-w-[var(--anchor-width)] min-w-full mr-0.5 mr-1.5 mr-2 normal-case");
41
- @source inline("pl-1.5 pl-2 pr-1 pr-16 pr-3 pt-1 resize-none resize-y ring-field-error/30 rounded-b-md");
27
+ @source inline("[&>div]:sm:[grid-template-columns:…] [&_svg]:size-3.5 basis-40 bg-accent/15 bg-accent/40");
28
+ @source inline("bg-background/70 bg-success/10 bg-warning/10 bg-warning/20 border-field-error border-l-2");
29
+ @source inline("border-l-border-strong border-l-destructive border-l-warning bottom-3 col col-span-2 col-start-2");
30
+ @source inline("collapse cursor-help divide-x first:pl-1 focus-visible:ring-field-ring/40 gap-x-1.5 gap-x-2");
31
+ @source inline("gap-y-0.5 grid-cols-[minmax(0,1fr)_auto] group-focus-visible/meter:opacity-100");
32
+ @source inline("group-focus-visible/stat:opacity-100 group-focus-visible/tile:opacity-100");
33
+ @source inline("group-hover/meter:opacity-100 group-hover/stat:opacity-100 group-hover/tile:opacity-100");
34
+ @source inline("group/meter group/stat group/tile h-105 has-[[aria-invalid=true]]:border-field-error");
35
+ @source inline("hover:bg-muted/50 hover:border-field-ring hover:text-warning last:pr-1 left-3");
36
+ @source inline("left-[var(--timeline-rail-x)] list-none min-h-20 min-h-9 min-w-34 min-w-full mr-0.5 mr-1.5 mr-2");
37
+ @source inline("normal-case pl-1.5 pr-16 pr-3 pt-1 resize-none resize-y ring-field-error/30 rounded-b-md");
42
38
  @source inline("rounded-t-md row-start-1 self-stretch shadow-md size-7 sm:col-auto sm:col-span-1 sm:flex-nowrap");
43
39
  @source inline("sm:grid-cols-[minmax(7rem,18rem)_minmax(4rem,1fr)_auto]");
44
40
  @source inline("sm:grid-cols-[minmax(7rem,34rem)_minmax(4rem,1fr)_auto] sm:row-auto sm:truncate text-3xl");
45
41
  @source inline("text-[length:var(--text-glyph)] text-field-placeholder text-foreground/80 text-success text-xl");
46
- @source inline("top-7 tracking-normal transition-[transform,opacity] w-36 w-48 w-88 whitespace-pre z-[1]");
42
+ @source inline("top-7 tracking-normal w-36 w-48 w-88 whitespace-pre z-[1]");
@@ -18,19 +18,14 @@
18
18
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
19
19
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
20
20
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
21
- * 42 candidate(s).
21
+ * 25 candidate(s).
22
22
  *
23
23
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
24
24
  * `bun run build` runs. The map of what is in which area, and why the areas are
25
25
  * import closures rather than a hand-written list, is scripts/styleAreas.ts.
26
26
  */
27
- @source inline("[&_svg]:size-3 border-field-error collapse data-[ending-style]:opacity-0");
28
- @source inline("data-[ending-style]:scale-95 data-[highlighted]:bg-accent/10");
29
- @source inline("data-[highlighted]:text-accent-strong data-[starting-style]:opacity-0");
30
- @source inline("data-[starting-style]:scale-95 disabled:bg-transparent disabled:opacity-100 duration-100");
31
- @source inline("focus-visible:ring-field-ring/40 focus-within:border-field-ring focus-within:ring-2");
32
- @source inline("focus-within:ring-field-ring/30 h-105 has-[[aria-invalid=true]]:border-field-error");
33
- @source inline("hover:border-field-ring hover:text-warning max-h-64 min-h-20 min-w-24");
34
- @source inline("min-w-[var(--anchor-width)] mr-1.5 mr-2 pl-1.5 pl-2 pr-1 pr-16 pr-3 resize-none resize-y");
35
- @source inline("ring-field-error/30 self-stretch size-7 sm:inline text-field-placeholder text-xl");
36
- @source inline("transition-[transform,opacity] w-36 w-88");
27
+ @source inline("border-field-error collapse disabled:bg-transparent disabled:opacity-100");
28
+ @source inline("focus-visible:ring-field-ring/40 h-105 has-[[aria-invalid=true]]:border-field-error");
29
+ @source inline("hover:border-field-ring hover:text-warning min-h-20 mr-1.5 mr-2 pl-1.5 pr-16 pr-3 resize-none");
30
+ @source inline("resize-y ring-field-error/30 self-stretch size-7 sm:inline text-field-placeholder text-xl w-36");
31
+ @source inline("w-88");
@@ -656,6 +656,9 @@
656
656
  width: 100%;
657
657
  height: 100%;
658
658
  }
659
+ .h-0 {
660
+ height: 0px;
661
+ }
659
662
  .h-0\.5 {
660
663
  height: calc(var(--spacing) * 0.5);
661
664
  }
@@ -1726,6 +1729,10 @@
1726
1729
  border-bottom-style: var(--tw-border-style);
1727
1730
  border-bottom-width: 0px;
1728
1731
  }
1732
+ .border-b-0\! {
1733
+ border-bottom-style: var(--tw-border-style) !important;
1734
+ border-bottom-width: 0px !important;
1735
+ }
1729
1736
  .border-b-2 {
1730
1737
  border-bottom-style: var(--tw-border-style);
1731
1738
  border-bottom-width: 2px;
@@ -2639,6 +2646,9 @@
2639
2646
  .py-0 {
2640
2647
  padding-block: 0px;
2641
2648
  }
2649
+ .py-0\! {
2650
+ padding-block: 0px !important;
2651
+ }
2642
2652
  .py-0\.5 {
2643
2653
  padding-block: calc(var(--spacing) * 0.5);
2644
2654
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cursedbelt",
3
- "version": "5.90.0",
3
+ "version": "5.92.0",
4
4
  "license": "ISC",
5
5
  "type": "module",
6
6
  "description": "The React design system of the cursedbelt split — components, styles, theme. cursedbelt-core below it; server tier in cursedbelt-server.",
@@ -528,6 +528,12 @@
528
528
  "source": "./src/react/components/Modal.tsx",
529
529
  "import": "./dist/react/components/Modal.js"
530
530
  },
531
+ "./react/autocomplete": {
532
+ "types": "./dist/react/components/Autocomplete.d.ts",
533
+ "bun": "./src/react/components/Autocomplete.tsx",
534
+ "source": "./src/react/components/Autocomplete.tsx",
535
+ "import": "./dist/react/components/Autocomplete.js"
536
+ },
531
537
  "./react/multi-select-field": {
532
538
  "types": "./dist/react/components/MultiSelectField.d.ts",
533
539
  "bun": "./src/react/components/MultiSelectField.tsx",
@@ -24,7 +24,7 @@
24
24
  "no-inline-style": 73,
25
25
  "no-arbitrary-length": 0,
26
26
  "opt-out-count": 272,
27
- "opt-out-needs-cause": 254
27
+ "opt-out-needs-cause": 253
28
28
  },
29
29
  "cursedshell": {
30
30
  "no-raw-action-button": 0,
@@ -1063,6 +1063,19 @@ describe('no-native-select — the OS draws its list (owner, 2026-10-10)', () =>
1063
1063
  expect(check('no-native-select', `<selection-bar />`)).toHaveLength(0);
1064
1064
  });
1065
1065
 
1066
+ // forge task 3602, the owner 2026-10-23: *"When I click the add a tag dropdown, the dropdown does
1067
+ // not look styled … I was in dark mode and it popped up light."* That was an `<input list>`.
1068
+ test('a <datalist> is the same OS list, and counts too (forge task 3602)', () => {
1069
+ const source = `<input list="known-tags" value={tag} onChange={(e) => setTag(e.target.value)} />
1070
+ <datalist id="known-tags">
1071
+ {tags.map((t) => <option key={t} value={t} />)}
1072
+ </datalist>`;
1073
+ expect(check('no-native-select', source)).toHaveLength(1);
1074
+ expect(check('no-native-select', `<datalist id={\`ft-record-\${category}\`}>`)).toHaveLength(1);
1075
+ expect(check('no-native-select', `// was a <datalist> until 3602\n<AutocompleteField suggestions={tags} />`)).toHaveLength(0);
1076
+ expect(check('no-native-select', `<datalistish />`)).toHaveLength(0);
1077
+ });
1078
+
1066
1079
  test('the styled controls, and a comment that names it, are not one', () => {
1067
1080
  expect(check('no-native-select', `<SelectField value={sort} options={SORTS} />`)).toHaveLength(0);
1068
1081
  expect(check('no-native-select', `// was a <NativeSelect> until 2026-10-10\n<PropertyPicker name="Type" />`)).toHaveLength(0);
@@ -2092,7 +2092,9 @@ const noSelectAsActionMenu: Rule = {
2092
2092
  // even the kit's frame (forge task 3097: desk had eight under `no-raw-inputs`, which no count of
2093
2093
  // NativeSelect could see) — in its two-sided ratchet, so the number only falls:
2094
2094
  // `SelectField` / `ComboboxField` for a field, `PropertyPicker` for a record's property pill,
2095
- // `ChoiceMenu` to choose-and-act. A use that is genuinely right — a form on a phone where the OS
2095
+ // `ChoiceMenu` to choose-and-act. A `<datalist>` counts too (forge task 3602, the owner 2026-10-23:
2096
+ // a tag field's suggestions *"popped up light"* in dark mode) — `<input list>`'s dropdown is the
2097
+ // same OS list; `AutocompleteField` or `TagsInput` suggest in the page. A use that is genuinely right — a form on a phone where the OS
2096
2098
  // wheel IS the better control — says so on the line above:
2097
2099
  // `// guardrails-ignore no-native-select: <why>`.
2098
2100
  const NATIVE_SELECT_IGNORE_RE = /guardrails-ignore\s+no-native-select\s*:/;
@@ -2100,7 +2102,7 @@ const NATIVE_SELECT_IGNORE_RE = /guardrails-ignore\s+no-native-select\s*:/;
2100
2102
  const noNativeSelect: Rule = {
2101
2103
  name: "no-native-select",
2102
2104
  description:
2103
- "Owner, 2026-10-10: unstyled dropdowns break the app's cohesiveness. A `NativeSelect`'s (or a raw `<select>`'s) list is drawn by the OS, outside the page, where no stylesheet reaches it. Use `SelectField` / `ComboboxField` for a form field, `PropertyPicker` for a record's property (Type, Folder, Tags), or `ChoiceMenu` to choose-and-act. Where the OS picker is the better control, say why on the line above: `// guardrails-ignore no-native-select: <why>`.",
2105
+ "Owner, 2026-10-10: unstyled dropdowns break the app's cohesiveness. A `NativeSelect`'s (or a raw `<select>`'s, or a `<datalist>`'s) list is drawn by the OS, outside the page, where no stylesheet reaches it. Use `SelectField` / `ComboboxField` for a form field, `AutocompleteField` / `TagsInput` for suggestions as you type, `PropertyPicker` for a record's property (Type, Folder, Tags), or `ChoiceMenu` to choose-and-act. Where the OS picker is the better control, say why on the line above: `// guardrails-ignore no-native-select: <why>`.",
2104
2106
  check(filePath, source) {
2105
2107
  const unix = filePath.replace(/\\/g, "/");
2106
2108
  // The kit is held to its own law (forge task 3063: its DataTable filter builder and
@@ -2112,7 +2114,7 @@ const noNativeSelect: Rule = {
2112
2114
  const scannable = blankComments(source);
2113
2115
  const lines = source.split("\n");
2114
2116
  const out: Violation[] = [];
2115
- for (const match of scannable.matchAll(/<(?:NativeSelect|select)\b/g)) {
2117
+ for (const match of scannable.matchAll(/<(?:NativeSelect|select|datalist)\b/g)) {
2116
2118
  const line = lineOf(source, match.index ?? 0);
2117
2119
  if (NATIVE_SELECT_IGNORE_RE.test(lines[line - 1] ?? "") || NATIVE_SELECT_IGNORE_RE.test(blockAbove(lines, line))) continue;
2118
2120
  out.push({ file: filePath, line, snippet: lines[line - 1]?.trim() ?? "" });
@@ -181,6 +181,9 @@ export const AREAS: readonly Area[] = [
181
181
  'components/IconButton.tsx',
182
182
  'components/InfoHint.tsx',
183
183
  'components/InfoHintImpl.tsx',
184
+ // TagsInput `import()`s it (forge task 3614) from seven areas' closures (lazyImportFault) — named
185
+ // here once, so whichever area reaches TagsInput, its suggestion list is styled.
186
+ 'components/TagsInputSuggesting.tsx',
184
187
  'components/Input.tsx',
185
188
  'components/ListPanel.tsx',
186
189
  'components/Menu.tsx',
@@ -264,6 +264,11 @@
264
264
  .cbab-slot {
265
265
  inline-size: 44px;
266
266
  block-size: 44px;
267
+ }
268
+
269
+ /* 12px centers the rail's OWN 20px glyph. A slot holds the consumer's control, which
270
+ `max-inline-size: 100%` would squeeze to that 20px — it gets the whole 44 instead. */
271
+ .cbab-btn {
267
272
  padding-inline: 12px;
268
273
  }
269
274
  }
@@ -1,6 +1,6 @@
1
1
  import { afterEach, describe, expect, mock, test } from 'bun:test';
2
2
  import { act, cleanup, fireEvent, render, waitFor } from '@testing-library/react';
3
- import { useState } from 'react';
3
+ import { createRef, useState } from 'react';
4
4
  import { AutocompleteField } from './Autocomplete.js';
5
5
 
6
6
  afterEach(cleanup);
@@ -79,4 +79,58 @@ describe('AutocompleteField', () => {
79
79
  // Suggestions should be visible in the popup (portaled to document.body)
80
80
  expect(getByText('Apple')).not.toBeNull();
81
81
  });
82
+
83
+ // 🔴 Seen on music-stage, 2026-10-23: "zz" still offered every folder — the list drew the whole
84
+ // static array, never Base UI's filtered one (forge task 3602).
85
+ test('static suggestions narrow to what contains the typed text, in any case', () => {
86
+ const { container, queryByText } = render(<Controlled initial='AP' />);
87
+ const input = container.querySelector('input') as HTMLInputElement;
88
+ act(() => {
89
+ fireEvent.keyDown(input, { key: 'ArrowDown' });
90
+ });
91
+ expect(queryByText('Apple')).not.toBeNull();
92
+ expect(queryByText('Apricot')).not.toBeNull();
93
+ expect(queryByText('Banana')).toBeNull();
94
+ expect(queryByText('Cherry')).toBeNull();
95
+ });
96
+
97
+ test('inputRef is the input, so a form can focus the field it names as missing', () => {
98
+ const ref = createRef<HTMLInputElement>();
99
+ const { container } = render(<AutocompleteField inputRef={ref} suggestions={SUGGESTIONS} />);
100
+ expect(ref.current).toBe(container.querySelector('input'));
101
+ });
102
+
103
+ test('a field that is more than its query brings its own match', () => {
104
+ // A comma list: each suggestion is the whole next value, and only the LAST entry is the query.
105
+ const last = (text: string) => text.slice(text.lastIndexOf(',') + 1).trim().toLowerCase();
106
+ const { container, queryByText } = render(
107
+ <AutocompleteField
108
+ value='rock, an'
109
+ suggestions={['rock, trance', 'rock, ambient', 'rock, jazz']}
110
+ filter={(item, query) => last(item).includes(last(query))}
111
+ />,
112
+ );
113
+ act(() => {
114
+ fireEvent.keyDown(container.querySelector('input') as HTMLInputElement, { key: 'ArrowDown' });
115
+ });
116
+ expect(queryByText('rock, trance')).not.toBeNull();
117
+ expect(queryByText('rock, ambient')).toBeNull();
118
+ expect(queryByText('rock, jazz')).toBeNull();
119
+ });
120
+
121
+ test('loadSuggestions answers are drawn as given — the loader already searched', async () => {
122
+ const loadSuggestions = mock(async () => ['Zebra', 'Yak']);
123
+ function Async() {
124
+ const [value, setValue] = useState('qq');
125
+ return <AutocompleteField value={value} onChange={setValue} loadSuggestions={loadSuggestions} />;
126
+ }
127
+ const { container, queryByText } = render(<Async />);
128
+ await waitFor(() => expect(loadSuggestions).toHaveBeenCalled(), { timeout: 1000 });
129
+ const input = container.querySelector('input') as HTMLInputElement;
130
+ await act(async () => {
131
+ fireEvent.keyDown(input, { key: 'ArrowDown' });
132
+ });
133
+ await waitFor(() => expect(queryByText('Zebra')).not.toBeNull(), { timeout: 1000 });
134
+ expect(queryByText('Yak')).not.toBeNull();
135
+ });
82
136
  });
@@ -2,12 +2,11 @@
2
2
 
3
3
  import { Autocomplete } from '@base-ui/react/autocomplete';
4
4
  import { ChevronDown, Loader2 } from 'lucide-react';
5
- import { type InputHTMLAttributes, type ReactNode, useCallback, useEffect, useState } from 'react';
5
+ import { type InputHTMLAttributes, type ReactNode, type Ref, useCallback, useEffect, useState } from 'react';
6
6
  import { useDebouncedCallback } from '../hooks/useDebouncedCallback.js';
7
7
  import { cn } from '../lib/cn.js';
8
8
  import { type ControlSize, fieldControlClass } from '../lib/field.js';
9
- import { FLOATING_COLLISION_PADDING,
10
- FLOATING_CONTENT_BASE, FLOATING_ITEM_BASE } from '../lib/floatingStyles.js';
9
+ import { SuggestionList } from './suggestionList.js';
11
10
 
12
11
  export interface AutocompleteProps<S = string>
13
12
  extends Omit<
@@ -30,6 +29,13 @@ export interface AutocompleteProps<S = string>
30
29
  onBlur?: () => void;
31
30
  /** Static suggestion items shown in the dropdown. */
32
31
  suggestions?: S[];
32
+ /**
33
+ * Whether a static suggestion matches what is typed. Default: its text CONTAINS the typed text,
34
+ * any case (Base UI's own match). A field whose value is more than the query — a comma list
35
+ * where each suggestion completes the LAST entry — passes its own. `null` shows them as given.
36
+ * Never applied to {@link loadSuggestions}: the loader's answer already is the search.
37
+ */
38
+ filter?: ((item: S, query: string) => boolean) | null;
33
39
  /** Async fetch — called on every keystroke (debounced 250 ms).
34
40
  * When provided, replaces the static `suggestions`. */
35
41
  loadSuggestions?: (query: string) => Promise<S[]>;
@@ -54,6 +60,8 @@ export interface AutocompleteProps<S = string>
54
60
  /** Height on the shared control-height scale (`--control-h-*`, task cbux-41).
55
61
  * Default `md`. */
56
62
  size?: ControlSize;
63
+ /** The input element — to focus it from a form that names what is missing. */
64
+ inputRef?: Ref<HTMLInputElement>;
57
65
  }
58
66
 
59
67
  const DEBOUNCE_MS = 250;
@@ -74,6 +82,7 @@ export function AutocompleteField<S = string>({
74
82
  onChange,
75
83
  onBlur,
76
84
  suggestions = [],
85
+ filter,
77
86
  loadSuggestions,
78
87
  itemToString = (item) => String(item),
79
88
  renderSuggestion,
@@ -85,6 +94,7 @@ export function AutocompleteField<S = string>({
85
94
  'aria-describedby': ariaDescribedBy,
86
95
  className,
87
96
  size = 'md',
97
+ inputRef,
88
98
  ...rest
89
99
  }: AutocompleteProps<S>) {
90
100
  const isAsync = Boolean(loadSuggestions);
@@ -127,11 +137,15 @@ export function AutocompleteField<S = string>({
127
137
  itemToStringValue={itemToString}
128
138
  disabled={disabled}
129
139
  mode='list'
140
+ // Static suggestions narrow to what is typed (by default Base UI's own match: contains, any
141
+ // case, accents folded). A loader's answer is already the search — drawn as it came.
142
+ filter={isAsync ? null : filter}
130
143
  autoHighlight={false}
131
144
  >
132
145
  <Autocomplete.InputGroup className='relative flex items-center'>
133
146
  <Autocomplete.Input
134
147
  {...rest}
148
+ ref={inputRef}
135
149
  id={id}
136
150
  name={name}
137
151
  aria-invalid={ariaInvalid}
@@ -153,46 +167,7 @@ export function AutocompleteField<S = string>({
153
167
  </span>
154
168
  </Autocomplete.InputGroup>
155
169
 
156
- <Autocomplete.Portal>
157
- {/* 🔴 The z-index goes on the POSITIONER, not only the popup. Base UI's positioner is
158
- the element that is `position: absolute` (with a transform); the popup inside it is
159
- `position: static`, so the popup's own `z-[var(--z-popover)]` does nothing and the
160
- list painted UNDER any sibling with a z-index — measured 2026-09-22 in the
161
- binary-server inspector, a sticky table header (z-index 1) covering the second option
162
- of an open MultiSelectField. */}
163
- <Autocomplete.Positioner
164
- sideOffset={4}
165
- collisionPadding={FLOATING_COLLISION_PADDING}
166
- className='z-[var(--z-popover)]'
167
- >
168
- <Autocomplete.Popup
169
- className={cn(
170
- FLOATING_CONTENT_BASE,
171
- // guardrails-ignore no-raw-overflow: floating popover panel outside the page's ScrollArea, height-capped by max-h-64 — no keyboard-inset concern.
172
- 'max-h-64 min-w-[var(--anchor-width)] overflow-y-auto p-0 py-1',
173
- 'transition-[transform,opacity] duration-100',
174
- 'data-[starting-style]:scale-95 data-[starting-style]:opacity-0',
175
- 'data-[ending-style]:scale-95 data-[ending-style]:opacity-0',
176
- )}
177
- >
178
- <Autocomplete.List>
179
- {activeSuggestions.map((s, index) => (
180
- <Autocomplete.Item
181
- key={itemToString(s)}
182
- value={s}
183
- index={index}
184
- className={cn(
185
- FLOATING_ITEM_BASE,
186
- 'data-[highlighted]:bg-accent/10 data-[highlighted]:text-accent-strong',
187
- )}
188
- >
189
- {renderSuggestion ? renderSuggestion(s) : itemToString(s)}
190
- </Autocomplete.Item>
191
- ))}
192
- </Autocomplete.List>
193
- </Autocomplete.Popup>
194
- </Autocomplete.Positioner>
195
- </Autocomplete.Portal>
170
+ <SuggestionList itemToString={itemToString} renderSuggestion={renderSuggestion} />
196
171
  </Autocomplete.Root>
197
172
  );
198
173
  }
@@ -260,6 +260,19 @@ export interface DataTableProps<TRow extends Record<string, unknown>> {
260
260
  * lists must never strand the reader without column context — STANDARDS §5c).
261
261
  * Works inside any vertical scroll ancestor (`ScrollArea`). */
262
262
  stickyHeader?: boolean;
263
+ /**
264
+ * Draw the column-header row. Default `true`.
265
+ *
266
+ * `false` for a list whose columns say what they are by their content — music's tracks, where a
267
+ * title and a length need no `TITLE` / `LENGTH` over them (owner, 2026-10-23: *"remove the row
268
+ * of table headers like "TITLE" because it will save space and users will already know they are
269
+ * seeing the title and length"*). The row is collapsed to nothing rather than removed: each `<th>`
270
+ * keeps its width (a `table-fixed` table takes its column tracks from it) and its name, read by a
271
+ * screen reader only, so a cell is still announced under its column. What the row carried that a
272
+ * reader acts on moves: the select-all box to its own line above the rows (the line the phone
273
+ * cards already draw), and sorting to the caller's own sort control — a hidden header sorts nothing.
274
+ */
275
+ columnHeaders?: boolean;
263
276
  /**
264
277
  * Freeze the FIRST visible column so it stays on screen while the rest of the
265
278
  * table scrolls sideways (owner, 2026-08-15, on auth's people matrix: *"if the
@@ -890,6 +903,12 @@ const HIDE_BELOW_CLASS = {
890
903
  } as const;
891
904
 
892
905
  /** `ColDef.priority`'s collapse — {@link HIDE_BELOW_CLASS}'s, unconditional, for the same reason. */
906
+ /**
907
+ * A header cell of a table whose header row is not drawn (`columnHeaders={false}`): no height, no
908
+ * rule under it, its width kept — `table-fixed` takes the column tracks from this row — and its
909
+ * content an sr-only name.
910
+ */
911
+ const HIDDEN_HEADER_CELL = 'h-0 py-0! border-b-0! leading-none';
893
912
  const COLLAPSED_CLASS = 'w-0! min-w-0! p-0! border-0 invisible text-[length:0] [&>*]:hidden';
894
913
  const NOTHING_DROPPED: ReadonlySet<string> = new Set();
895
914
 
@@ -955,7 +974,8 @@ export function DataTable<TRow extends Record<string, unknown>>({
955
974
  hidePagination,
956
975
  caption,
957
976
  className,
958
- stickyHeader,
977
+ stickyHeader: stickyHeaderProp,
978
+ columnHeaders = true,
959
979
  stickyFirstColumn,
960
980
  renderExpanded,
961
981
  expandedRowId,
@@ -1006,6 +1026,8 @@ export function DataTable<TRow extends Record<string, unknown>>({
1006
1026
  columnsPersistKey,
1007
1027
  ...passThrough
1008
1028
  }: DataTableProps<TRow>) {
1029
+ // A header that is not drawn has nothing to pin (see `columnHeaders`).
1030
+ const stickyHeader = stickyHeaderProp && columnHeaders;
1009
1031
  // Vertical cell padding for the wide grid tier — the one lever the density knob
1010
1032
  // pulls (headers + body cells stay aligned by sharing it).
1011
1033
  const cellPadY = density === 'compact' ? 'py-1.5' : 'py-2.5';
@@ -1889,11 +1911,12 @@ export function DataTable<TRow extends Record<string, unknown>>({
1889
1911
  beside them: a card grid already reflows, so a second breakpoint
1890
1912
  ladder inside it would only fight the container query. ── */}
1891
1913
  {/* Select-all for the tiers with no header row to carry it: the phone
1892
- cards, and the card view at every width. */}
1893
- {selectionShown && (viewMode === 'card' || mobileCards) ? (
1914
+ cards, the card view at every width, and every tier of a table whose header row
1915
+ is not drawn (`columnHeaders`). */}
1916
+ {selectionShown && (viewMode === 'card' || mobileCards || !columnHeaders) ? (
1894
1917
  <div
1895
1918
  data-cb-table-select-all=''
1896
- className={cn('flex items-center px-2 py-1', viewMode !== 'card' && '@xl:hidden')}
1919
+ className={cn('flex items-center px-2 py-1', viewMode !== 'card' && columnHeaders && '@xl:hidden')}
1897
1920
  >
1898
1921
  {headerCheckbox('Select all')}
1899
1922
  </div>
@@ -2124,7 +2147,7 @@ export function DataTable<TRow extends Record<string, unknown>>({
2124
2147
  });
2125
2148
  return (
2126
2149
  <>
2127
- {header}
2150
+ {columnHeaders ? header : null}
2128
2151
  <div
2129
2152
  ref={activeTier === 'list' && narrowTiers ? (bodyRef as Ref<HTMLDivElement>) : undefined}
2130
2153
  className='divide-y divide-border'
@@ -2213,6 +2236,7 @@ export function DataTable<TRow extends Record<string, unknown>>({
2213
2236
  // rides the <th> (not the <tr>) so it pins with stickyHeader.
2214
2237
  'border-b border-border px-4 text-caption font-bold uppercase tracking-wider text-muted-foreground',
2215
2238
  cellPadY,
2239
+ !columnHeaders && HIDDEN_HEADER_CELL,
2216
2240
  align === 'right' ? 'text-right' : 'text-left',
2217
2241
  meta?.numeric && 'tabular-nums',
2218
2242
  // Under `fit` the column takes its CONTENT's width, and a truncating
@@ -2237,7 +2261,11 @@ export function DataTable<TRow extends Record<string, unknown>>({
2237
2261
  >
2238
2262
  {h.isPlaceholder
2239
2263
  ? null
2240
- : renderTemplate(h.column.columnDef.header, h.getContext())}
2264
+ : columnHeaders
2265
+ ? renderTemplate(h.column.columnDef.header, h.getContext())
2266
+ : // The name alone, for a screen reader: the header's sort button would be
2267
+ // a Tab stop nobody can see.
2268
+ <span className='sr-only'>{labelOf(h.column.id)}</span>}
2241
2269
  </th>
2242
2270
  );
2243
2271
  };
@@ -2254,12 +2282,13 @@ export function DataTable<TRow extends Record<string, unknown>>({
2254
2282
  data-cb-selection-cell=''
2255
2283
  className={cn(
2256
2284
  'w-11 border-b border-border px-0 text-center',
2285
+ !columnHeaders && HIDDEN_HEADER_CELL,
2257
2286
  stickyHeader && 'sticky top-0 z-10 bg-card/95 backdrop-blur-sm',
2258
2287
  stickyFirstColumn && 'sticky left-0 bg-card',
2259
2288
  stickyFirstColumn && (stickyHeader ? 'z-30' : 'z-20'),
2260
2289
  )}
2261
2290
  >
2262
- {headerCheckbox()}
2291
+ {columnHeaders ? headerCheckbox() : <span className='sr-only'>Select</span>}
2263
2292
  </th>
2264
2293
  ) : null}
2265
2294
  {hg.headers.filter((h) => !isLeading(h)).map(renderHeader)}
@@ -2275,6 +2304,7 @@ export function DataTable<TRow extends Record<string, unknown>>({
2275
2304
  : kebabOnly
2276
2305
  ? 'w-11 border-b border-border px-0'
2277
2306
  : 'w-20 border-b border-border px-2',
2307
+ !columnHeaders && HIDDEN_HEADER_CELL,
2278
2308
  stickyHeader && 'sticky top-0 z-10 bg-card/95 backdrop-blur-sm',
2279
2309
  )}
2280
2310
  aria-label='Row actions'