@godxjp/ui 31.22.0 → 31.23.0

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.22.0.** If the project you are editing has a different
+**This catalog describes `@godxjp/ui` 31.23.0.** 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.
@@ -47,7 +47,7 @@ Then ask it: `search_components`, `get_component`, `get_tokens`, `get_rule`, `li
    task is a task** — "build a settings page", "confirm a destructive delete", "a list page with
    filters" — start HERE, not at the components. Then fetch `patterns/<name>.json` for complete,
    copy-paste-ready code. A component index answers "does X exist"; it cannot answer "build Y".
-1. `components-index.json` — 49 KB, all 181 components as name + group +
+1. `components-index.json` — 50 KB, all 181 components as name + group +
    tagline. Read this when you already know the SHAPE you need. Each entry may carry `absorbed`:
    names that **do not exist** and map to it — `Combobox`, `Autocomplete`, `CountrySelect` and
    `SearchSelect` are all `Select`. If you are about to hand-roll something, search this field

package/agent/components/ChatSuggestion.json

@@ -18,7 +18,7 @@
     },
     {
       "defaultValue": "\"/\"",
-      "description": "The character(s) that open the list when typed at a boundary — the start, whitespace, or any non-ASCII character, so `[[` opens right after Japanese text (gh#1127); an ASCII letter still blocks it, so `https://x` opens nothing. Use \"@\" for mentions, \"[[\" for a link picker.",
+      "description": "The character(s) that open the list when typed at a boundary — the start, whitespace, or any non-ASCII character, so `/` opens right after Japanese text (gh#1127); an ASCII letter still blocks a ONE-character trigger, so `https://x` opens nothing. A multi-character trigger (`[[`) opens anywhere, `abc[[` included (gh#1129). After Escape the list stays shut until a new trigger is typed. Use \"@\" for mentions, \"[[\" for a link picker.",
       "name": "triggerCharacter",
       "type": "string"
     },

package/agent/components/CommandPalette.json

@@ -24,7 +24,7 @@
     },
     {
       "defaultValue": "true",
-      "description": "The global toggle shortcut. `true` = ⌘K / Ctrl+K, `false` = none, or a combo string — `\"mod+o\"`, `\"mod+p\"`, `\"mod+shift+p\"` — so a quick switcher and a command palette can live side by side. `mod` is ⌘ or Ctrl; Shift / Alt must match exactly. Never fires during IME composition; the default trigger shows the combo (gh#1126).",
+      "description": "The global toggle shortcut. `true` = ⌘K / Ctrl+K, `false` = none, or a combo string — `\"mod+o\"`, `\"mod+p\"`, `\"mod+shift+p\"` — so a quick switcher and a command palette can live side by side. `mod` is ⌘ on Apple platforms and Ctrl elsewhere — never both, so Ctrl+O / Ctrl+P keep their editing meaning on a Mac (gh#1129); Shift / Alt must match exactly. Never fires during IME composition; the default trigger shows the combo (gh#1126).",
       "name": "shortcut",
       "type": "boolean | string"
     },

package/agent/components/Prose.json

@@ -40,7 +40,7 @@
   ],
   "rules": [],
   "storyPath": "data-display/Prose.stories.tsx",
-  "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108).",
+  "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108). Tables: `@godxjp/markdown` wraps each in `.ui-prose-table-scroll`, which Prose scrolls horizontally (focusable only while it overflows), and table cells keep their words whole — a short code like `F02` never breaks (gh#1131).",
   "usage": [
     "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.",

package/agent/components-index.json

@@ -314,7 +314,7 @@
   {
     "group": "data-display",
     "name": "Prose",
-    "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108)."
+    "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108). Tables: `@godxjp/markdown` wraps each in `.ui-prose-table-scroll`, which Prose scrolls horizontally (focusable only while it overflows), and table cells keep their words whole — a short code like `F02` never breaks (gh#1131)."
   },
   {
     "group": "data-display",

package/agent/components.json

@@ -5164,7 +5164,7 @@
     ],
     "rules": [],
     "storyPath": "data-display/Prose.stories.tsx",
-    "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108).",
+    "tagline": "Typography for rendered content (Markdown, CMS bodies, issue descriptions): styles the semantic HTML inside it from the tokens, with no opinion about where the HTML comes from. To RENDER Markdown, use the sibling package `@godxjp/markdown` inside it — `<Prose><Markdown>{body}</Markdown></Prose>` — the one GFM renderer + sanitiser + Mermaid gate shared by every GoDX app; do not assemble react-markdown + rehype-sanitize per app (gh#1108). Tables: `@godxjp/markdown` wraps each in `.ui-prose-table-scroll`, which Prose scrolls horizontally (focusable only while it overflows), and table cells keep their words whole — a short code like `F02` never breaks (gh#1131).",
     "usage": [
       "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.",
@@ -14154,7 +14154,7 @@
       },
       {
         "defaultValue": "true",
-        "description": "The global toggle shortcut. `true` = ⌘K / Ctrl+K, `false` = none, or a combo string — `\"mod+o\"`, `\"mod+p\"`, `\"mod+shift+p\"` — so a quick switcher and a command palette can live side by side. `mod` is ⌘ or Ctrl; Shift / Alt must match exactly. Never fires during IME composition; the default trigger shows the combo (gh#1126).",
+        "description": "The global toggle shortcut. `true` = ⌘K / Ctrl+K, `false` = none, or a combo string — `\"mod+o\"`, `\"mod+p\"`, `\"mod+shift+p\"` — so a quick switcher and a command palette can live side by side. `mod` is ⌘ on Apple platforms and Ctrl elsewhere — never both, so Ctrl+O / Ctrl+P keep their editing meaning on a Mac (gh#1129); Shift / Alt must match exactly. Never fires during IME composition; the default trigger shows the combo (gh#1126).",
         "name": "shortcut",
         "type": "boolean | string"
       },
@@ -15483,7 +15483,7 @@
       },
       {
         "defaultValue": "\"/\"",
-        "description": "The character(s) that open the list when typed at a boundary — the start, whitespace, or any non-ASCII character, so `[[` opens right after Japanese text (gh#1127); an ASCII letter still blocks it, so `https://x` opens nothing. Use \"@\" for mentions, \"[[\" for a link picker.",
+        "description": "The character(s) that open the list when typed at a boundary — the start, whitespace, or any non-ASCII character, so `/` opens right after Japanese text (gh#1127); an ASCII letter still blocks a ONE-character trigger, so `https://x` opens nothing. A multi-character trigger (`[[`) opens anywhere, `abc[[` included (gh#1129). After Escape the list stays shut until a new trigger is typed. Use \"@\" for mentions, \"[[\" for a link picker.",
         "name": "triggerCharacter",
         "type": "string"
       },

package/agent/index.json

@@ -10,7 +10,7 @@
   "files": [
     {
       "file": "components-index.json",
-      "note": "49 KB — name + group + tagline for all 181. FETCH THIS FIRST, then fetch only the components you chose.",
+      "note": "50 KB — name + group + tagline for all 181. FETCH THIS FIRST, then fetch only the components you chose.",
       "url": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json"
     },
     {
@@ -48,7 +48,7 @@
   "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.22.0/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.23.0/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",
@@ -62,5 +62,5 @@
     "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.22.0"
+  "version": "31.23.0"
 }

package/agent/llms.txt

@@ -1,10 +1,10 @@
 # @godxjp/ui
 
 > A Japanese-enterprise React design system: 181 components, 2129 design tokens,
-> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.22.0.
+> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.23.0.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@31.22.0`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@31.23.0`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
@@ -15,7 +15,7 @@ that can only fetch URLs.
 ## Catalog
 
 - [patterns-index.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/patterns-index.json): 21 whole-task patterns (name, tagline, tags). Start here when the task is a TASK — "build a settings page" — then fetch `patterns/<name>.json` for complete code.
-- [components-index.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json): 49 KB — all 181 components as name, group, tagline, plus `absorbed`: the names that do NOT exist and map to it (`Combobox` → `Select`).
+- [components-index.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json): 50 KB — all 181 components as name, group, tagline, plus `absorbed`: the names that do NOT exist and map to it (`Combobox` → `Select`).
 - [components/&lt;Name&gt;.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.2 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), 104 `semantic` roles, 1814 `component` knobs.
@@ -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.22.0/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v31.23.0/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/dist/components/data-entry/chat-suggestion.js

@@ -16,8 +16,10 @@ function matchTrigger(text, caret, trigger, { allowSpaces = false, terminator }
   if (allowSpaces ? /\n/.test(query) : /\s/.test(query)) return null;
   if (terminator && query.includes(terminator)) return null;
   const preceding = start === 0 ? "" : before[start - 1];
-  if (preceding !== "" && !/\s/.test(preceding) && preceding.charCodeAt(0) < 128) return null;
-  return { query };
+  if (trigger.length === 1 && preceding !== "" && !/\s/.test(preceding) && preceding.charCodeAt(0) < 128) {
+    return null;
+  }
+  return { query, start };
 }
 function levelItems(items, path) {
   let current = items;
@@ -106,19 +108,30 @@ function ChatSuggestion({
     setListId(content?.querySelector("[cmdk-list]")?.id || void 0);
     setActiveId(content?.querySelector('[cmdk-item][aria-selected="true"]')?.id || void 0);
   });
+  const dismissedStartRef = React.useRef(null);
   const close = React.useCallback(() => {
+    const node = field();
+    const caret = node ? node.selectionStart ?? node.value.length : 0;
+    const hit = node ? matchTrigger(node.value, caret, triggerCharacter, { allowSpaces, terminator }) : null;
+    dismissedStartRef.current = hit ? hit.start : null;
     setOpen(false);
     field()?.focus();
-  }, [field, setOpen]);
+  }, [field, setOpen, triggerCharacter, allowSpaces, terminator]);
   const evaluate = React.useCallback(() => {
     const node = field();
     if (!node) return;
     const caret = node.selectionStart ?? node.value.length;
     const hit = matchTrigger(node.value, caret, triggerCharacter, { allowSpaces, terminator });
     if (!hit) {
+      dismissedStartRef.current = null;
+      setOpen(false);
+      return;
+    }
+    if (hit.start === dismissedStartRef.current) {
       setOpen(false);
       return;
     }
+    dismissedStartRef.current = null;
     setQuery(hit.query);
     setOpen(true);
   }, [field, setOpen, triggerCharacter, allowSpaces, terminator]);

package/dist/components/data-entry/command-palette.d.ts

@@ -80,7 +80,8 @@ export type CommandPaletteProps = {
      * The global shortcut that toggles the palette (gh#1126). `true` (default) is ⌘K / Ctrl+K;
      * `false` binds none; a combo string — `"mod+o"`, `"mod+p"`, `"mod+shift+p"` — binds that, so two
      * palettes (a quick switcher and a command palette) can live side by side. `mod` is ⌘ on Apple
-     * and Ctrl elsewhere (either is accepted); `shift` and `alt` must match exactly, so `mod+p` and
+     * and Ctrl elsewhere — never both, so Ctrl+O keeps its editing meaning on a Mac; `shift` and
+     * `alt` must match exactly, so `mod+p` and
      * `mod+shift+p` are different shortcuts. Never fires during IME composition.
      */
     shortcut?: boolean | string;

package/dist/components/data-entry/command-palette.js

@@ -12,6 +12,7 @@ import {
   CommandItem,
   CommandList
 } from "./command.js";
+import { isApplePlatform } from "../../lib/platform.js";
 import { isImeComposing } from "../../lib/ime.js";
 function parseShortcut(shortcut) {
   if (shortcut === false) return null;
@@ -30,15 +31,15 @@ function parseShortcut(shortcut) {
 function shortcutMatches(spec, event) {
   const keyMatches = event.key.toLowerCase() === spec.key || /^[a-z]$/.test(spec.key) && event.code === `Key${spec.key.toUpperCase()}`;
   if (!keyMatches) return false;
-  if (spec.mod && !(event.metaKey || event.ctrlKey)) return false;
+  if (spec.mod && !(isApplePlatform() ? event.metaKey : event.ctrlKey)) return false;
   if (spec.meta && !event.metaKey) return false;
   if (spec.ctrl && !event.ctrlKey) return false;
   return event.shiftKey === spec.shift && event.altKey === spec.alt;
 }
 function shortcutHint(spec) {
   return [
-    spec.mod || spec.meta ? "\u2318" : "",
-    spec.ctrl ? "Ctrl+" : "",
+    spec.meta || spec.mod && isApplePlatform() ? "\u2318" : "",
+    spec.ctrl || spec.mod && !isApplePlatform() ? "Ctrl+" : "",
     spec.alt ? "\u2325" : "",
     spec.shift ? "\u21E7" : "",
     spec.key.length === 1 ? spec.key.toUpperCase() : spec.key

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.22.0",
+  "version": "31.23.0",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

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

@@ -1398,11 +1398,18 @@
     border-collapse: collapse;
   }
 
+  .ui-prose .ui-prose-table-scroll {
+    max-inline-size: 100%;
+    overflow-x: auto;
+  }
+
   .ui-prose :is(th, td) {
     border: var(--stroke-hairline) solid hsl(var(--border));
     padding: var(--table-cell-padding-y) var(--table-cell-space-x, var(--space-section-active));
     text-align: start;
     vertical-align: top;
+
+    overflow-wrap: normal;
   }
 
   .ui-prose th {

package/dist/styles/layers.json

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

package/package.json

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