@godxjp/ui 31.28.1 → 31.28.3

package/agent/START-HERE.md

@@ -3,7 +3,7 @@
 You are about to write code against a design system you did not author. This file is the whole
 contract. Read it before you write JSX.
 
-**This catalog describes `@godxjp/ui` 31.28.1.** If the project you are editing has a different
+**This catalog describes `@godxjp/ui` 31.28.3.** If the project you are editing has a different
 version in its `package.json`, read the pinned catalog for THAT version instead
 (`…/v<their-version>/agent/…`). A catalog newer than the installed package describes props that do
 not exist yet; older, and it hides props that do. Neither failure announces itself.
@@ -56,10 +56,10 @@ Then ask it: `search_components`, `get_component`, `get_tokens`, `get_rule`, `li
    its `importPath`, and its examples. Fetch only the handful you picked in step 1.
 3. `rules.json` — 50 cardinal rules. The ones about raw HTML and hardcoded colour are not
    style advice.
-4. `tokens.json` — 2155 design tokens, each tagged with its `tier`. **If you were handed a
+4. `tokens.json` — 2156 design tokens, each tagged with its `tier`. **If you were handed a
    brand, read the 211 `foundation` entries first** — `--primary`, `--background`,
    `--radius`, `--font-size-base` are the handful everything else derives from. The
-   1832 `component` entries are per-part knobs; reach for one only when a role is
+   1833 `component` entries are per-part knobs; reach for one only when a role is
    right everywhere except one component.
 5. `anti-ai-tells.json` — 26 shapes that make generated UI look generated, each with the
    fix. Read before you reach for a gradient hero or a wall of coloured chips.
@@ -145,7 +145,7 @@ has stopped following the brand.
 |---|---|---|---|
 | `foundation` | 211 | the seeds — `--primary`, `--background`, `--foreground`, `--radius`, `--font-size-base`, `--shadow-color`. Everything below is derived from these | **yes — this is the main road.** Handed a brand colour, this is where it goes: `:root { --primary: <H> <S>% <L>%; }` (HSL components, no `hsl()` wrapper) |
 | `semantic` | 112 | named roles that follow the seeds — `--ring`, `--text-link`, `--primary-hover`, `--overlay-background` | only when the seed is right and ONE role must differ. That role then stops following a later brand change |
-| `component` | 1832 | per-part knobs, `--{component}-{part}-{property}` | rarely. Most are declared `initial` with the real default at the call site — deliberate, so a scoped override re-resolves instead of freezing at `:root` |
+| `component` | 1833 | per-part knobs, `--{component}-{part}-{property}` | rarely. Most are declared `initial` with the real default at the call site — deliberate, so a scoped override re-resolves instead of freezing at `:root` |
 
 A token whose `value` is `initial` is not empty and not broken: `initial` is the guaranteed-invalid
 value, so the real default is computed where the element paints it. Set it and yours wins.

package/agent/components/Command.json

@@ -55,7 +55,7 @@
     },
     {
       "defaultValue": "false",
-      "description": "antd List `split`. Draws the list as ONE ruled box: group/list padding 0, rows full-bleed to the panel edge with a square highlight, a hairline border-block-end between rows and none after the last visible row, row content aligned with CommandInput's leading glyph. Sets `data-split` on the root; the parts need no prop. Tokens: --command-list-split-padding, --command-list-split-inset, --command-item-divider-width, --command-item-divider-color. Select mode=multiple / mode=tags renders its popup split by default.",
+      "description": "antd List `split`. Draws the list as ONE ruled box: group/list padding 0, rows full-bleed to the panel edge with a square highlight, a hairline border-block-end between rows and none after the last visible row, row content aligned with CommandInput's leading glyph. Sets `data-split` on the root; the parts need no prop. Tokens: --command-list-split-padding, --command-list-split-inset, --command-item-divider-width, --command-item-divider-color. Select does NOT render its popup split (it is a picker; compact unruled rows).",
       "name": "split",
       "type": "boolean"
     },

package/agent/components/Prose.json

@@ -51,7 +51,7 @@
     "DO import from `@godxjp/ui/data-display`: `import { Prose } from \"@godxjp/ui/data-display\";`",
     "DO wrap the OUTPUT of your Markdown pipeline (react-markdown + remark-gfm + rehype-sanitize), a sanitised CMS string via `dangerouslySetInnerHTML`, or plain JSX. Prose styles descendants: h1..h4, p, ul/ol/li, blockquote, code, pre, table/th/td, a, img, hr.",
     "DO keep soft line breaks the pipeline's job (remark-breaks or the renderer's `breaks` option). Prose does not turn single newlines into `<br>`; it is typography, not parsing.",
-    "DON'T restate the heading scale, table cell measures or list rhythm with `[&_h1]:text-lg [&_td]:border …` utilities: they copy token values and never follow a retune. Prose reads --heading-h1..h4, --table-cell-padding-* and --prose-* directly.",
+    "DON'T restate the heading scale, table cell measures or list rhythm with `[&_h1]:text-lg [&_td]:border …` utilities: they copy token values and never follow a retune. Prose reads --heading-h1..h4, --table-cell-padding-* and --prose-* directly. Its long-form scale keeps every level h1–h6 at or above body size: h1–h3 step down in size, h4–h6 sit at body size in bold (h6 muted), so a host that shifts body headings down one level (page title = the one h1) keeps readable section titles.",
     "DO tune the link through --prose-link-color and --prose-link-decoration-line (gh#717). The ink defaults to hsl(var(--primary)) resolved at the anchor, so a scoped [data-tenant] re-tint reaches it; the resting underline defaults to `underline` and is a SEPARATE knob from --text-link-decoration-line, because Prose is running text and there the underline is a WCAG 1.4.1 requirement, not a taste.",
     "DO style a state your own renderer knows about by marking the anchor and selecting it: `a[data-unresolved]` (a wiki link whose target does not exist yet), then re-declare --prose-link-color inside that selector. Prose writes data-* on its ROOT ONLY — never on a descendant — so every data-* on an `a` inside it is yours and stays selectable. That is a promise held by a test (prose-link-717.test.tsx), not a coincidence; there is no prop for it, the same way `TableRow data-expanded-row` is an attribute rather than an API.",
     "DON'T sanitise inside Prose: it renders whatever HTML it is given. Sanitise before (rehype-sanitize, or the server).",

package/agent/components/Select.json

@@ -13,7 +13,7 @@
   "name": "Select",
   "props": [
     {
-      "description": "Select several options; value/defaultValue become string arrays. `tags` additionally ACCEPTS what was typed (a value that is not in the list), which is antd's own split between the two. `tags` needs no `options` (`<Select mode=\"tags\" />` works) and only an explicit `disabled` disables it (gh#1063). While text is typed the tags list reads create row, then an exact (case-folded) match, then options, then held values — the first enabled row is the Enter target, never a held tag (gh#1064). The popup list of either mode renders as `Command split` (rows ruled, list padding 0, gh#699); retune it with --command-item-divider-color / --command-item-divider-width.",
+      "description": "Select several options; value/defaultValue become string arrays. `tags` additionally ACCEPTS what was typed (a value that is not in the list), which is antd's own split between the two. `tags` needs no `options` (`<Select mode=\"tags\" />` works) and only an explicit `disabled` disables it (gh#1063). While text is typed the tags list reads create row, then an exact (case-folded) match, then options, then held values — the first enabled row is the Enter target, never a held tag (gh#1064). The popup is a picker: compact unruled rows (--search-select-option-line-height), a list capped at --search-select-list-max-height (16rem, antd listHeight 256) that scrolls inside, the search as the panel header line with no ring of its own, and the picked rows marked by a check (menuItemSelectedIcon default) + weight while the row background means pointer/keyboard position only. A facet list that wants ruled rows composes `Command split` (gh#699) itself.",
       "name": "mode",
       "type": "\"multiple\" | \"tags\""
     },
@@ -262,7 +262,7 @@
       "type": "(option: SearchSelectOptionProp, info: { index: number }) => React.ReactNode"
     },
     {
-      "description": "antd `menuItemSelectedIcon` — a decorative mark on the picked row. Off by default: the picked row is already marked by fill + weight, which costs no width.",
+      "description": "antd `menuItemSelectedIcon` — a decorative mark on the picked row. In mode multiple / tags it defaults to a check (as in antd), because there the row background means pointer/keyboard position, not selection; pass `null` to drop it. A single-value Select shows none by default.",
       "name": "menuItemSelectedIcon",
       "type": "React.ReactNode"
     },

package/agent/components.json

@@ -5393,7 +5393,7 @@
       "DO import from `@godxjp/ui/data-display`: `import { Prose } from \"@godxjp/ui/data-display\";`",
       "DO wrap the OUTPUT of your Markdown pipeline (react-markdown + remark-gfm + rehype-sanitize), a sanitised CMS string via `dangerouslySetInnerHTML`, or plain JSX. Prose styles descendants: h1..h4, p, ul/ol/li, blockquote, code, pre, table/th/td, a, img, hr.",
       "DO keep soft line breaks the pipeline's job (remark-breaks or the renderer's `breaks` option). Prose does not turn single newlines into `<br>`; it is typography, not parsing.",
-      "DON'T restate the heading scale, table cell measures or list rhythm with `[&_h1]:text-lg [&_td]:border …` utilities: they copy token values and never follow a retune. Prose reads --heading-h1..h4, --table-cell-padding-* and --prose-* directly.",
+      "DON'T restate the heading scale, table cell measures or list rhythm with `[&_h1]:text-lg [&_td]:border …` utilities: they copy token values and never follow a retune. Prose reads --heading-h1..h4, --table-cell-padding-* and --prose-* directly. Its long-form scale keeps every level h1–h6 at or above body size: h1–h3 step down in size, h4–h6 sit at body size in bold (h6 muted), so a host that shifts body headings down one level (page title = the one h1) keeps readable section titles.",
       "DO tune the link through --prose-link-color and --prose-link-decoration-line (gh#717). The ink defaults to hsl(var(--primary)) resolved at the anchor, so a scoped [data-tenant] re-tint reaches it; the resting underline defaults to `underline` and is a SEPARATE knob from --text-link-decoration-line, because Prose is running text and there the underline is a WCAG 1.4.1 requirement, not a taste.",
       "DO style a state your own renderer knows about by marking the anchor and selecting it: `a[data-unresolved]` (a wiki link whose target does not exist yet), then re-declare --prose-link-color inside that selector. Prose writes data-* on its ROOT ONLY — never on a descendant — so every data-* on an `a` inside it is yours and stays selectable. That is a promise held by a test (prose-link-717.test.tsx), not a coincidence; there is no prop for it, the same way `TableRow data-expanded-row` is an attribute rather than an API.",
       "DON'T sanitise inside Prose: it renders whatever HTML it is given. Sanitise before (rehype-sanitize, or the server).",
@@ -6658,7 +6658,7 @@
     "name": "Select",
     "props": [
       {
-        "description": "Select several options; value/defaultValue become string arrays. `tags` additionally ACCEPTS what was typed (a value that is not in the list), which is antd's own split between the two. `tags` needs no `options` (`<Select mode=\"tags\" />` works) and only an explicit `disabled` disables it (gh#1063). While text is typed the tags list reads create row, then an exact (case-folded) match, then options, then held values — the first enabled row is the Enter target, never a held tag (gh#1064). The popup list of either mode renders as `Command split` (rows ruled, list padding 0, gh#699); retune it with --command-item-divider-color / --command-item-divider-width.",
+        "description": "Select several options; value/defaultValue become string arrays. `tags` additionally ACCEPTS what was typed (a value that is not in the list), which is antd's own split between the two. `tags` needs no `options` (`<Select mode=\"tags\" />` works) and only an explicit `disabled` disables it (gh#1063). While text is typed the tags list reads create row, then an exact (case-folded) match, then options, then held values — the first enabled row is the Enter target, never a held tag (gh#1064). The popup is a picker: compact unruled rows (--search-select-option-line-height), a list capped at --search-select-list-max-height (16rem, antd listHeight 256) that scrolls inside, the search as the panel header line with no ring of its own, and the picked rows marked by a check (menuItemSelectedIcon default) + weight while the row background means pointer/keyboard position only. A facet list that wants ruled rows composes `Command split` (gh#699) itself.",
         "name": "mode",
         "type": "\"multiple\" | \"tags\""
       },
@@ -6907,7 +6907,7 @@
         "type": "(option: SearchSelectOptionProp, info: { index: number }) => React.ReactNode"
       },
       {
-        "description": "antd `menuItemSelectedIcon` — a decorative mark on the picked row. Off by default: the picked row is already marked by fill + weight, which costs no width.",
+        "description": "antd `menuItemSelectedIcon` — a decorative mark on the picked row. In mode multiple / tags it defaults to a check (as in antd), because there the row background means pointer/keyboard position, not selection; pass `null` to drop it. A single-value Select shows none by default.",
         "name": "menuItemSelectedIcon",
         "type": "React.ReactNode"
       },
@@ -10901,7 +10901,7 @@
       },
       {
         "defaultValue": "false",
-        "description": "antd List `split`. Draws the list as ONE ruled box: group/list padding 0, rows full-bleed to the panel edge with a square highlight, a hairline border-block-end between rows and none after the last visible row, row content aligned with CommandInput's leading glyph. Sets `data-split` on the root; the parts need no prop. Tokens: --command-list-split-padding, --command-list-split-inset, --command-item-divider-width, --command-item-divider-color. Select mode=multiple / mode=tags renders its popup split by default.",
+        "description": "antd List `split`. Draws the list as ONE ruled box: group/list padding 0, rows full-bleed to the panel edge with a square highlight, a hairline border-block-end between rows and none after the last visible row, row content aligned with CommandInput's leading glyph. Sets `data-split` on the root; the parts need no prop. Tokens: --command-list-split-padding, --command-list-split-inset, --command-item-divider-width, --command-item-divider-color. Select does NOT render its popup split (it is a picker; compact unruled rows).",
         "name": "split",
         "type": "boolean"
       },

package/agent/index.json

@@ -4,7 +4,7 @@
     "components": 184,
     "patterns": 21,
     "rules": 50,
-    "tokens": 2155,
+    "tokens": 2156,
     "vocabulary": 14
   },
   "files": [
@@ -48,19 +48,19 @@
   "note": "Pin to the tag that matches the @godxjp/ui version you installed. A catalog newer than your package describes props you do not have; older, and it hides props you do.",
   "read": {
     "live": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/index.json",
-    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.28.1/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.28.3/agent/index.json"
   },
   "source": "mcp/src/data — the same data @godxjp/ui-mcp serves — plus the foundation and semantic token tiers, read from src/tokens/*.css",
   "start": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/START-HERE.md",
   "tokenTiers": {
     "component": "per-part knobs, --{component}-{part}-{property}; usually leave these alone",
     "counts": {
-      "component": 1832,
+      "component": 1833,
       "foundation": 211,
       "semantic": 112
     },
     "foundation": "the seeds a consumer is invited to set — --primary, --background, --radius",
     "semantic": "named roles that follow the seeds — --ring, --text-link, --overlay-background"
   },
-  "version": "31.28.1"
+  "version": "31.28.3"
 }

package/agent/llms.txt

@@ -1,10 +1,10 @@
 # @godxjp/ui
 
-> A Japanese-enterprise React design system: 184 components, 2155 design tokens,
-> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.28.1.
+> A Japanese-enterprise React design system: 184 components, 2156 design tokens,
+> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.28.3.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@31.28.1`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@31.28.3`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
@@ -18,7 +18,7 @@ that can only fetch URLs.
 - [components-index.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json): 51 KB — all 184 components as name, group, tagline, plus `absorbed`: the names that do NOT exist and map to it (`Combobox` → `Select`).
 - [components/<Name>.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components/Select.json): one file per component (1 KB–36 KB, median 6 KB). Read the index, then fetch only the ones you chose — this is the selective route, and the reason you do not need the blob.
 - [components.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components.json): 1.3 MB — every entry in one file. Most URL fetchers truncate a response this size without saying so; prefer the per-component files.
-- [tokens.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/tokens.json): every design token with its value, the reason it exists, and its `tier` — 211 `foundation` seeds (`--primary`, `--background`, `--radius`: set these when you are handed a brand), 112 `semantic` roles, 1832 `component` knobs.
+- [tokens.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/tokens.json): every design token with its value, the reason it exists, and its `tier` — 211 `foundation` seeds (`--primary`, `--background`, `--radius`: set these when you are handed a brand), 112 `semantic` roles, 1833 `component` knobs.
 - [vocabulary.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/vocabulary.json): the controlled prop vocabulary — which prop name means what, across every component.
 - [rules.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/rules.json): 50 cardinal rules.
 - [anti-ai-tells.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/anti-ai-tells.json): 26 shapes that make generated UI look generated, each with its fix.
@@ -26,7 +26,7 @@ that can only fetch URLs.
 ## Pinning
 
 Every URL above tracks `main`. To pin to the release a project actually installed, swap `main` for
-the tag: `.../godx-jp/godxjp-ui/v31.28.1/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v31.28.3/agent/...`. A catalog that does not match the installed
 package describes props that are absent, or hides props that are present, and says nothing either way.
 
 Pinned catalogs only exist for releases whose tag actually contains `agent/`. If `…/v<version>/agent/index.json` returns 404, that release predates this catalog: read `…/main/…` instead and compare `index.json` → `version` against the package you have, so you at least know which way it drifted.

package/agent/tokens.json

@@ -4032,10 +4032,10 @@
     "value": "var(--space-1)"
   },
   {
-    "description": "antd `listHeight` writes this per instance; `none` lets the panel's own available height win.",
+    "description": "antd `listHeight` writes this per instance; `none` lets the panel's own available height win. antd listHeight 256px; the list scrolls inside",
     "name": "--search-select-list-max-height",
     "tier": "component",
-    "value": "none"
+    "value": "16rem"
   },
   {
     "description": "Control primitive tokens: heights, horizontal padding, adjacent control sizes.",
@@ -4049,6 +4049,12 @@
     "tier": "component",
     "value": "var(--space-2)"
   },
+  {
+    "description": "Picker rows read compact (~34px), like Linear / GitHub label pickers, not body-text rows.",
+    "name": "--search-select-option-line-height",
+    "tier": "component",
+    "value": "var(--line-height-tight)"
+  },
   {
     "description": "Control primitive tokens: heights, horizontal padding, adjacent control sizes.",
     "name": "--search-select-option-font-size",

package/dist/components/data-entry/search-select.js

@@ -1,7 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { ChevronsUpDown, Loader2, X } from "lucide-react";
+import { Check, ChevronsUpDown, Loader2, X } from "lucide-react";
 import { useTranslation } from "../../i18n/use-translation.js";
 import { useFieldIdentity, useFieldNameFallback } from "../../lib/field-a11y.js";
 import { isImeComposing } from "../../lib/ime.js";
@@ -90,6 +90,7 @@ function SearchSelect(props) {
   );
   const multiple = props.mode === "multiple" || props.mode === "tags";
   const tagsMode = props.mode === "tags";
+  const rowSelectedIcon = menuItemSelectedIcon === void 0 ? multiple ? /* @__PURE__ */ jsx(Check, { className: "size-[var(--menu-icon-size)]" }) : null : menuItemSelectedIcon;
   const maxTagTextLength = props.mode !== void 0 ? props.maxTagTextLength : void 0;
   const tokenSeparators = props.mode !== void 0 ? props.tokenSeparators : void 0;
   const tagRender = props.mode !== void 0 ? props.tagRender : void 0;
@@ -566,163 +567,155 @@ function SearchSelect(props) {
               style: typeof popupMatchSelectWidth === "number" ? {
                 "--search-select-panel-inline-size": `${popupMatchSelectWidth}px`
               } : void 0,
-              children: /* @__PURE__ */ jsx(PopupRender, { render: popupRender, children: /* @__PURE__ */ jsxs(
-                Command,
-                {
-                  value,
-                  shouldFilter: false,
-                  className: "ui-search-select-command",
-                  split: multiple,
-                  children: [
-                    /* @__PURE__ */ jsx("div", { className: "ui-search-select-search", children: /* @__PURE__ */ jsx(
-                      Input,
-                      {
-                        autoFocus: true,
-                        "aria-controls": listId,
-                        "aria-autocomplete": "list",
-                        "aria-activedescendant": activeOptionId,
-                        "aria-label": searchPlaceholder ?? t("dataEntry.searchSelect.search"),
-                        value: query,
-                        onChange: (event) => {
-                          const next = event.target.value;
-                          if (multiple && !composingRef.current && tokenSeparators?.length && tokenSeparators.some((separator) => next.includes(separator))) {
-                            selectTokens(next);
-                            setQuery("");
-                            return;
-                          }
-                          setQuery(next);
-                        },
-                        onPaste: (event) => {
-                          if (!multiple || !tokenSeparators?.length) return;
-                          const text = event.clipboardData.getData("text");
-                          if (!tokenSeparators.some((separator) => text.includes(separator))) return;
-                          event.preventDefault();
-                          selectTokens(text);
-                          setQuery("");
-                        },
-                        onKeyDown,
-                        onCompositionStart: () => {
-                          composingRef.current = true;
-                        },
-                        onCompositionEnd: () => {
-                          composingRef.current = false;
-                        },
-                        placeholder: searchPlaceholder ?? t("dataEntry.searchSelect.search"),
-                        className: "ui-search-select-search-input"
+              children: /* @__PURE__ */ jsx(PopupRender, { render: popupRender, children: /* @__PURE__ */ jsxs(Command, { value, shouldFilter: false, className: "ui-search-select-command", children: [
+                /* @__PURE__ */ jsx("div", { className: "ui-search-select-search", children: /* @__PURE__ */ jsx(
+                  Input,
+                  {
+                    autoFocus: true,
+                    "aria-controls": listId,
+                    "aria-autocomplete": "list",
+                    "aria-activedescendant": activeOptionId,
+                    "aria-label": searchPlaceholder ?? t("dataEntry.searchSelect.search"),
+                    value: query,
+                    onChange: (event) => {
+                      const next = event.target.value;
+                      if (multiple && !composingRef.current && tokenSeparators?.length && tokenSeparators.some((separator) => next.includes(separator))) {
+                        selectTokens(next);
+                        setQuery("");
+                        return;
                       }
-                    ) }),
-                    /* @__PURE__ */ jsxs(
-                      "div",
-                      {
-                        id: listId,
-                        role: "listbox",
-                        "aria-multiselectable": multiple || void 0,
-                        "aria-busy": loading,
-                        className: "ui-search-select-list",
-                        style: listHeight === void 0 ? void 0 : {
-                          "--search-select-list-max-height": `${listHeight}px`
-                        },
-                        onScroll: (event) => {
-                          onPopupScroll?.(event);
-                          onScroll(event);
-                        },
-                        children: [
-                          grouped.map((group) => {
-                            const rows = group.items.map(({ option, index }) => /* @__PURE__ */ jsxs(
-                              "div",
-                              {
-                                id: optionDomId(option.value),
-                                role: "option",
-                                "data-testid": optionTestId(option.value),
-                                "aria-selected": isSelected(option.value),
-                                "aria-disabled": option.disabled || atMaxCount && !isSelected(option.value) || void 0,
-                                "data-disabled": option.disabled || atMaxCount && !isSelected(option.value) || void 0,
-                                className: cn(
-                                  "ui-command-item",
-                                  // Selected = persistent bg-accent + medium weight (NO check icon — saves width),
-                                  // matching the plain SelectItem's `data-[state=checked]` convention; active =
-                                  // hover/keyboard accent. Same bg so selection stays coherent across both Selects.
-                                  isSelected(option.value) && "bg-accent text-foreground font-medium",
-                                  activeIndex === index && "bg-accent text-accent-foreground"
-                                ),
-                                onMouseEnter: () => !option.disabled && setActiveIndex(index),
-                                onMouseDown: (event) => event.preventDefault(),
-                                onClick: () => select(option),
-                                children: [
-                                  option === createOption ? (
-                                    // gh#1052: the create row SAYS it creates — antd shows the bare text, which
-                                    // reads like an existing option.
-                                    /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-body", "data-slot": "select-create", children: /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-label", children: createLabel ? createLabel(option.value) : t("dataEntry.searchSelect.create", { value: option.value }) }) })
-                                  ) : optionRender ? /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-slot", children: optionRender(option, { index }) }) : renderOption ? /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-slot", children: renderOption(option) }) : /* @__PURE__ */ jsxs("div", { className: "ui-search-select-option-body", children: [
-                                    option.icon ? /* @__PURE__ */ jsx("span", { className: "flex shrink-0 items-center", "aria-hidden": "true", children: option.icon }) : null,
-                                    /* @__PURE__ */ jsxs("div", { className: "ui-search-select-option-text", children: [
-                                      /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-label", children: option.label }),
-                                      option.sublabel ? /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-sublabel", children: option.sublabel }) : null
-                                    ] })
-                                  ] }),
-                                  menuItemSelectedIcon && isSelected(option.value) ? /* @__PURE__ */ jsx(
-                                    "span",
-                                    {
-                                      "data-slot": "search-select-selected-icon",
-                                      className: "ui-search-select-selected-icon",
-                                      "aria-hidden": "true",
-                                      children: menuItemSelectedIcon
-                                    }
-                                  ) : null
-                                ]
-                              },
-                              option.value
-                            ));
-                            return group.heading ? /* @__PURE__ */ jsx(CommandGroup, { heading: group.heading, children: rows }, group.heading) : /* @__PURE__ */ jsx(React.Fragment, { children: rows }, "__ungrouped");
-                          }),
-                          loading ? /* @__PURE__ */ jsxs("div", { role: "status", className: "ui-search-select-status", children: [
-                            /* @__PURE__ */ jsx(Loader2, { className: "ui-search-select-spinner animate-spin", "aria-hidden": "true" }),
-                            loadingMessage ?? t("dataEntry.searchSelect.loading")
-                          ] }) : error ? renderError ? renderError({
-                            message: errorMessage ?? t("dataEntry.searchSelect.error"),
-                            // Retry always reloads from the first page (a defined, predictable recovery —
-                            // NOT a resume of a failed page-N append, which would need to re-derive state).
-                            retry: () => void fetchPage(1, debouncedQuery, false)
-                          }) : /* @__PURE__ */ jsx(
-                            "div",
-                            {
-                              role: "option",
-                              "aria-disabled": "true",
-                              "aria-selected": false,
-                              className: "ui-search-select-placeholder",
-                              "data-tone": "destructive",
-                              children: errorMessage ?? t("dataEntry.searchSelect.error")
-                            }
-                          ) : displayOptions.length === 0 ? /* @__PURE__ */ jsx(
-                            "div",
-                            {
-                              role: "option",
-                              "aria-disabled": "true",
-                              "aria-selected": false,
-                              className: "ui-search-select-placeholder",
-                              children: notFoundContent ?? emptyMessage ?? t("dataEntry.searchSelect.empty")
-                            }
-                          ) : null
-                        ]
+                      setQuery(next);
+                    },
+                    onPaste: (event) => {
+                      if (!multiple || !tokenSeparators?.length) return;
+                      const text = event.clipboardData.getData("text");
+                      if (!tokenSeparators.some((separator) => text.includes(separator))) return;
+                      event.preventDefault();
+                      selectTokens(text);
+                      setQuery("");
+                    },
+                    onKeyDown,
+                    onCompositionStart: () => {
+                      composingRef.current = true;
+                    },
+                    onCompositionEnd: () => {
+                      composingRef.current = false;
+                    },
+                    placeholder: searchPlaceholder ?? t("dataEntry.searchSelect.search"),
+                    className: "ui-search-select-search-input"
+                  }
+                ) }),
+                /* @__PURE__ */ jsxs(
+                  "div",
+                  {
+                    id: listId,
+                    role: "listbox",
+                    "aria-multiselectable": multiple || void 0,
+                    "aria-busy": loading,
+                    className: "ui-search-select-list",
+                    style: listHeight === void 0 ? void 0 : {
+                      "--search-select-list-max-height": `${listHeight}px`
+                    },
+                    onScroll: (event) => {
+                      onPopupScroll?.(event);
+                      onScroll(event);
+                    },
+                    children: [
+                      grouped.map((group) => {
+                        const rows = group.items.map(({ option, index }) => /* @__PURE__ */ jsxs(
+                          "div",
+                          {
+                            id: optionDomId(option.value),
+                            role: "option",
+                            "data-testid": optionTestId(option.value),
+                            "aria-selected": isSelected(option.value),
+                            "aria-disabled": option.disabled || atMaxCount && !isSelected(option.value) || void 0,
+                            "data-disabled": option.disabled || atMaxCount && !isSelected(option.value) || void 0,
+                            className: cn(
+                              "ui-command-item",
+                              // The background means pointer/keyboard POSITION. In a multi-value list the
+                              // selection is the check mark plus weight, so the selected row and the active
+                              // row never look alike. A single-value pick closes on click, so it keeps the
+                              // plain SelectItem's persistent fill.
+                              isSelected(option.value) && (multiple ? "font-medium" : "bg-accent text-foreground font-medium"),
+                              activeIndex === index && "bg-accent text-accent-foreground"
+                            ),
+                            onMouseEnter: () => !option.disabled && setActiveIndex(index),
+                            onMouseDown: (event) => event.preventDefault(),
+                            onClick: () => select(option),
+                            children: [
+                              option === createOption ? (
+                                // gh#1052: the create row SAYS it creates — antd shows the bare text, which
+                                // reads like an existing option.
+                                /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-body", "data-slot": "select-create", children: /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-label", children: createLabel ? createLabel(option.value) : t("dataEntry.searchSelect.create", { value: option.value }) }) })
+                              ) : optionRender ? /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-slot", children: optionRender(option, { index }) }) : renderOption ? /* @__PURE__ */ jsx("div", { className: "ui-search-select-option-slot", children: renderOption(option) }) : /* @__PURE__ */ jsxs("div", { className: "ui-search-select-option-body", children: [
+                                option.icon ? /* @__PURE__ */ jsx("span", { className: "flex shrink-0 items-center", "aria-hidden": "true", children: option.icon }) : null,
+                                /* @__PURE__ */ jsxs("div", { className: "ui-search-select-option-text", children: [
+                                  /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-label", children: option.label }),
+                                  option.sublabel ? /* @__PURE__ */ jsx("span", { className: "ui-search-select-option-sublabel", children: option.sublabel }) : null
+                                ] })
+                              ] }),
+                              rowSelectedIcon && isSelected(option.value) ? /* @__PURE__ */ jsx(
+                                "span",
+                                {
+                                  "data-slot": "search-select-selected-icon",
+                                  className: "ui-search-select-selected-icon",
+                                  "aria-hidden": "true",
+                                  children: rowSelectedIcon
+                                }
+                              ) : null
+                            ]
+                          },
+                          option.value
+                        ));
+                        return group.heading ? /* @__PURE__ */ jsx(CommandGroup, { heading: group.heading, children: rows }, group.heading) : /* @__PURE__ */ jsx(React.Fragment, { children: rows }, "__ungrouped");
+                      }),
+                      loading ? /* @__PURE__ */ jsxs("div", { role: "status", className: "ui-search-select-status", children: [
+                        /* @__PURE__ */ jsx(Loader2, { className: "ui-search-select-spinner animate-spin", "aria-hidden": "true" }),
+                        loadingMessage ?? t("dataEntry.searchSelect.loading")
+                      ] }) : error ? renderError ? renderError({
+                        message: errorMessage ?? t("dataEntry.searchSelect.error"),
+                        // Retry always reloads from the first page (a defined, predictable recovery —
+                        // NOT a resume of a failed page-N append, which would need to re-derive state).
+                        retry: () => void fetchPage(1, debouncedQuery, false)
+                      }) : /* @__PURE__ */ jsx(
+                        "div",
+                        {
+                          role: "option",
+                          "aria-disabled": "true",
+                          "aria-selected": false,
+                          className: "ui-search-select-placeholder",
+                          "data-tone": "destructive",
+                          children: errorMessage ?? t("dataEntry.searchSelect.error")
+                        }
+                      ) : displayOptions.length === 0 ? /* @__PURE__ */ jsx(
+                        "div",
+                        {
+                          role: "option",
+                          "aria-disabled": "true",
+                          "aria-selected": false,
+                          className: "ui-search-select-placeholder",
+                          children: notFoundContent ?? emptyMessage ?? t("dataEntry.searchSelect.empty")
+                        }
+                      ) : null
+                    ]
+                  }
+                ),
+                renderLoadMore && hasMore ? /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: "ui-search-select-footer",
+                    onKeyDown: (event) => event.stopPropagation(),
+                    children: renderLoadMore({
+                      hasMore,
+                      loading,
+                      loadMore: () => {
+                        if (!loading) void fetchPage(page + 1, debouncedQuery, true);
                       }
-                    ),
-                    renderLoadMore && hasMore ? /* @__PURE__ */ jsx(
-                      "div",
-                      {
-                        className: "ui-search-select-footer",
-                        onKeyDown: (event) => event.stopPropagation(),
-                        children: renderLoadMore({
-                          hasMore,
-                          loading,
-                          loadMore: () => {
-                            if (!loading) void fetchPage(page + 1, debouncedQuery, true);
-                          }
-                        })
-                      }
-                    ) : null
-                  ]
-                }
-              ) })
+                    })
+                  }
+                ) : null
+              ] }) })
             }
           )
         ]

package/dist/contracts/measurement.json

@@ -1,6 +1,6 @@
 {
   "$comment": "AUTO-GENERATED by scripts/gen-measurement-contract.mjs — do not edit. Read this instead of guessing: docs/MEASUREMENT-CONTRACT.md.",
-  "version": "31.28.1",
+  "version": "31.28.3",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

package/dist/props/components/data-entry.prop.d.ts

@@ -1446,8 +1446,9 @@ export type SearchSelectBaseProp = {
         index: number;
     }) => React.ReactNode;
     /**
-     * Node rendered on the SELECTED row (antd `menuItemSelectedIcon`). Off by default: this library's
-     * selected row is marked by fill + weight, which costs no width.
+     * Node rendered on the SELECTED row (antd `menuItemSelectedIcon`). In `multiple` / `tags` it
+     * defaults to a check mark (as in antd), because the row background there means pointer/keyboard
+     * position, not selection; pass `null` to drop it. A single-value Select shows none by default.
      */
     menuItemSelectedIcon?: React.ReactNode;
     /** Node shown when the list has nothing to offer (antd `notFoundContent`). Beats `emptyMessage`. */

package/dist/styles/control.css

@@ -945,6 +945,11 @@
     color: hsl(var(--accent-foreground));
   }
 
+  .ui-search-select-list[aria-multiselectable="true"] .ui-command-item[aria-selected="true"] {
+    background: transparent;
+    color: inherit;
+  }
+
   .ui-command-item[data-disabled="true"] {
     pointer-events: none;
     opacity: 0.5;
@@ -1859,9 +1864,12 @@
     box-shadow: none;
   }
 
+  .ui-search-select-list .ui-command-item {
+    line-height: var(--search-select-option-line-height);
+  }
+
   .ui-search-select-list {
     max-block-size: var(--search-select-list-max-height);
-    max-block-size: none;
     min-block-size: 0;
     flex: 1 1 0%;
     overflow-y: auto;

package/dist/styles/data-display-layout.css

@@ -1309,17 +1309,17 @@
     margin-block-start: var(--prose-space-block);
   }
 
-  .ui-prose :is(h1, h2, h3, h4) {
+  .ui-prose :is(h1, h2, h3, h4, h5, h6) {
     font-weight: var(--font-weight-semibold);
     line-height: var(--line-height-tight);
     text-wrap: balance;
   }
 
-  .ui-prose > :is(h1, h2, h3, h4) + * {
+  .ui-prose > :is(h1, h2, h3, h4, h5, h6) + * {
     margin-block-start: var(--prose-space-block);
   }
 
-  .ui-prose > * + :is(h1, h2, h3, h4) {
+  .ui-prose > * + :is(h1, h2, h3, h4, h5, h6) {
     margin-block-start: var(--prose-heading-space-block-start);
   }
 
@@ -1341,14 +1341,23 @@
   }
 
   .ui-prose h3 {
-    font-size: var(--heading-h3, var(--font-size-base));
+    font-size: var(--heading-h3, calc(var(--prose-font-size) * var(--font-size-ratio)));
   }
 
   .ui-prose h4 {
-    font-size: var(
-      --heading-h4,
-      var(--font-size-xs, calc(var(--font-size-base) / var(--font-size-ratio)))
-    );
+    font-size: var(--heading-h4, var(--prose-font-size));
+  }
+
+  .ui-prose :is(h5, h6) {
+    font-size: var(--prose-font-size);
+  }
+
+  .ui-prose :is(h4, h5, h6) {
+    font-weight: var(--font-weight-bold);
+  }
+
+  .ui-prose h6 {
+    color: hsl(var(--muted-foreground));
   }
 
   .ui-prose :is(ul, ol) {
@@ -1434,8 +1443,14 @@
     padding-block: var(--callout-space-inset-block);
     padding-inline: var(--callout-space-inset-inline);
     border-inline-start: var(--callout-rail-width) solid hsl(var(--info));
-    border-start-end-radius: var(--callout-radius, var(--alert-radius, var(--card-radius, calc(var(--radius) * var(--radius-ratio)))));
-    border-end-end-radius: var(--callout-radius, var(--alert-radius, var(--card-radius, calc(var(--radius) * var(--radius-ratio)))));
+    border-start-end-radius: var(
+      --callout-radius,
+      var(--alert-radius, var(--card-radius, calc(var(--radius) * var(--radius-ratio))))
+    );
+    border-end-end-radius: var(
+      --callout-radius,
+      var(--alert-radius, var(--card-radius, calc(var(--radius) * var(--radius-ratio))))
+    );
     background-color: var(--surface-info, hsl(var(--info) / var(--alert-bg-alpha)));
   }
 

package/dist/styles/focus-ring.css

@@ -212,7 +212,8 @@
     --focus-ring-width-component: calc(var(--focus-ring-weight) * var(--focus-outline));
   }
 
-  .ui-command-input:focus-visible {
+  .ui-command-input:focus-visible,
+  .ui-search-select-search-input:focus-visible {
     --focus-field-shadow: none;
     --focus-ring-weight: 0px;
     outline: none;

package/dist/styles/layers.json

@@ -1,5 +1,5 @@
 {
-  "version": "31.28.1",
+  "version": "31.28.3",
   "generatedBy": "scripts/gen-style-layers.mjs — do not edit by hand; run `pnpm gen:style-layers`",
   "base": "base.css",
   "fonts": "fonts.css",

package/dist/tokens/components/control.css

@@ -262,9 +262,11 @@
   --search-select-panel-viewport-inset: var(--space-6);
   --search-select-list-space-inset: var(--space-1);
 
-  --search-select-list-max-height: none;
+  --search-select-list-max-height: 16rem;
   --search-select-footer-space-inset: var(--space-1);
   --search-select-option-space-gap: var(--space-2);
+
+  --search-select-option-line-height: var(--line-height-tight);
   --search-select-option-font-size: var(--font-size-sm, var(--font-size-base));
   --search-select-option-sublabel-font-size: var(
     --font-size-xs,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@godxjp/ui",
-  "version": "31.28.1",
-  "godxUiMcp": "31.28.1",
+  "version": "31.28.3",
+  "godxUiMcp": "31.28.3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",