@godxjp/ui 31.26.2 → 31.28.0

package/agent/components.json

@@ -705,7 +705,7 @@
         "defaultValue": "\"document\"",
         "description": "What the page's top row IS, which decides the `<h1>`'s type step. \"document\" (default) = the row is the page's TITLE (a record, a form, a collection, a report): --page-title-font-size (h1, 20px) with the existing responsive step down at 720px; no attribute is emitted, so an existing page is byte-identical. \"chrome\" = the row is the surface's own furniture — a chat channel name, a mail subject line, an IDE tab — naming the thing the user is already INSIDE instead of announcing a document; the h1 takes --page-title-font-size-chrome (--heading-h3 = the 14px body step) at EVERY width, including below 720px where the document-scale step would otherwise pull it back UP. The heading stays an `<h1>` either way — this moves the type step only, never the element, so the screen-reader outline is untouched.",
         "name": "headerScale",
-        "type": "\"document\" | \"chrome\""
+        "type": "\"document\" | \"chrome\" | \"display\""
       },
       {
         "defaultValue": "\"default\"",
@@ -737,6 +737,16 @@
         "name": "headerLoading",
         "type": "boolean"
       },
+      {
+        "description": "The page's icon (an emoji or glyph) drawn large above the title, riding over a banner `cover`'s bottom edge — Notion's page icon (gh#1160). Add aria-hidden unless it is itself a control.",
+        "name": "icon",
+        "type": "ReactNode"
+      },
+      {
+        "description": "A PageCover: the banner variant spans the page edge to edge above the header; the eyecatch variant sits in the reading column above the title (gh#1160).",
+        "name": "cover",
+        "type": "ReactNode (a PageCover)"
+      },
       {
         "description": "Ref to the page's <h1>; passing it also makes the heading programmatically focusable (tabIndex -1, outside the tab order, no focus ring) so a router can focus the new page title after client-side navigation (gh#1135).",
         "name": "titleRef",
@@ -796,6 +806,81 @@
       "A chat channel page where a fixed band (channel workflow / pinned-message / connection status) must sit between the page header and the scrolling transcript — `toolbar={<Toolbar>…</Toolbar>}` with `fill` + `footer={<Composer/>}` + `stickyFooter`. The band is outside the scroller, so the transcript never travels under it and the composer stays pinned; a collection page uses the same slot for its filter strip above a full-bleed DataTable (`variant='flush'`)."
     ]
   },
+  {
+    "docPath": "docs/layout/page-cover.tsx",
+    "example": "import { PageContainer, PageCover } from \"@godxjp/ui/layout\";\nimport { Button } from \"@godxjp/ui/general\";\n\n<PageContainer\n  title={page.title}\n  headerScale=\"display\"\n  icon={<span aria-hidden=\"true\">{page.icon}</span>}\n  cover={\n    <PageCover\n      src={page.cover}\n      alt=\"\"\n      positionY={y}\n      onPositionChange={setY}\n      repositioning={moving}\n      onRepositioningChange={setMoving}\n      actions={<Button size=\"sm\" variant=\"secondary\" onClick={() => setMoving(true)}>Reposition</Button>}\n    />\n  }\n>\n  {body}\n</PageContainer>",
+    "group": "layout",
+    "importPath": "@godxjp/ui/layout",
+    "name": "PageCover",
+    "props": [
+      {
+        "description": "Image URL.",
+        "name": "src",
+        "required": true,
+        "type": "string"
+      },
+      {
+        "description": "Alternative text; \"\" for a decorative cover.",
+        "name": "alt",
+        "required": true,
+        "type": "string"
+      },
+      {
+        "defaultValue": "50",
+        "description": "Vertical focal point, 0 top – 100 bottom.",
+        "name": "positionY",
+        "type": "number"
+      },
+      {
+        "description": "New focal point while repositioning.",
+        "name": "onPositionChange",
+        "type": "(positionY: number) => void"
+      },
+      {
+        "description": "Reposition mode (controlled): the image becomes a slider.",
+        "name": "repositioning",
+        "type": "boolean"
+      },
+      {
+        "description": "Enter / Escape ended the mode.",
+        "name": "onRepositioningChange",
+        "type": "(repositioning: boolean) => void"
+      },
+      {
+        "defaultValue": "\"banner\"",
+        "description": "Banner above the header, or eyecatch in the reading column.",
+        "name": "variant",
+        "type": "\"banner\" | \"eyecatch\""
+      },
+      {
+        "defaultValue": "\"md\"",
+        "description": "Banner height step; token-owned, scales phone → desktop.",
+        "name": "height",
+        "type": "\"md\" | \"lg\""
+      },
+      {
+        "description": "Change / reposition / remove controls: over the bottom edge on a wide screen, BELOW the image on a phone (never on the focal area).",
+        "name": "actions",
+        "type": "ReactNode"
+      },
+      {
+        "description": "Id on the cover frame.",
+        "name": "id",
+        "type": "string"
+      }
+    ],
+    "related": [
+      "PageContainer — `cover`, `icon`, headerScale=\"display\" for an article title.",
+      "Image — an image that opens a preview."
+    ],
+    "rules": [],
+    "storyPath": "layout/page-cover.tsx",
+    "tagline": "A page's cover image (gh#1160): Notion's banner across the top, or note.com's eyecatch (~1.91:1, rounded) in the reading column. Put it in PageContainer `cover`. The focal point is positionY (object-position); while `repositioning` the image IS a vertical WAI-ARIA slider — drag or arrows / PageUp / PageDown / Home / End, Enter / Escape to finish.",
+    "usage": [
+      "DO pass it as PageContainer `cover` with the page `icon` — the container places it and overlaps the icon.",
+      "DO wire a Reposition button in `actions` that sets `repositioning`, and persist positionY from onPositionChange."
+    ]
+  },
   {
     "example": "import { Flex } from \"@godxjp/ui/layout\";\nimport { Button } from \"@godxjp/ui/general\";\n\n<Flex direction=\"row\" gap=\"sm\" align=\"center\" justify=\"between\" wrap>\n  <SearchSummary />\n  <Flex direction=\"row\" gap=\"xs\" align=\"center\" wrap>\n    <Button variant=\"outline\">リセット</Button>\n    <Button>適用</Button>\n  </Flex>\n</Flex>",
     "group": "layout",
@@ -5061,6 +5146,21 @@
         "name": "shortCellLength",
         "type": "number | false"
       },
+      {
+        "description": "Default 'same-tab'. Renderer policy for links to another origin (an absolute http(s) URL whose origin differs from `origin`). 'new-tab' adds target=\"_blank\" rel=\"noopener noreferrer\"; relative links, #anchors, resolved wikilinks and mailto: stay in the tab. Markdown cannot store target, so this replaces it.",
+        "name": "externalLinks",
+        "type": "'same-tab' | 'new-tab'"
+      },
+      {
+        "description": "The page origin externalLinks compares against; defaults to location.origin. Pass it for server rendering, or every absolute link counts as external there.",
+        "name": "origin",
+        "type": "string"
+      },
+      {
+        "description": "Visible titles for GitHub-alert callouts (`> [!WARNING]`) that carry none of their own. English by default (the package has no i18n); pass localized strings. Grammar v1 (gh#1156): callouts, `:::toggle[summary]`, `::::columns`/`:::column{width=N}`, CJK-friendly emphasis — the same syntax the pure codec at `@godxjp/markdown/codec` (CODEC_ID kit-md@1, parse/serialize/normalize, DOM-free) and @godxjp/block-editor use.",
+        "name": "calloutTitles",
+        "type": "Partial<Record<'note' | 'tip' | 'important' | 'warning' | 'caution', string>>"
+      },
       {
         "defaultValue": "true",
         "description": "`false` keeps ```mermaid fences as code. Diagrams need the optional peer `mermaid`.",
@@ -5077,6 +5177,7 @@
     "storyPath": "data-display/markdown.tsx",
     "tagline": "The one Markdown renderer for GoDX apps (sibling package `@godxjp/markdown`, versioned with the kit): GFM + GitHub heading anchors, one sanitiser schema (no raw HTML; http/https/mailto/relative URLs only), and ```mermaid drawn only after its SVG passes a fail-closed gate (gh#1108). Wrap it in `Prose`.",
     "usage": [
+      "Table of contents: outline(markdown) from @godxjp/markdown/codec returns { depth, text, id }[] with exactly the ids <Markdown> writes — feed it to the kit Anchor. YAML front matter is kept verbatim and never rendered; frontmatterOf(markdown) returns it (gh#1163).",
       "DO `<Prose><Markdown>{body}</Markdown></Prose>` for every rendered body (wiki page, issue, mail).",
       "DO record `MARKDOWN_FORMAT` and `RENDERER_VERSION` on stored versions.",
       "DON'T assemble react-markdown + rehype-sanitize per app, add rehype-raw, or render Mermaid yourself — `checkMermaidSvg` is the gate."
@@ -5148,6 +5249,97 @@
       "DON'T build a toolbar over a bare Textarea, or a rich-text surface — this is the shared editor."
     ]
   },
+  {
+    "docPath": "docs/data-entry/block-editor.tsx",
+    "example": "import { BlockEditor } from \"@godxjp/block-editor\";\nimport { FormField } from \"@godxjp/ui/data-entry\";\n\n<FormField id=\"body\" label=\"本文\">\n  <BlockEditor\n    value={body}\n    onValueChange={setBody}\n    upload={async (file, { signal }) => ({ url: await media.put(file, { signal }), name: file.name })}\n    suggestWikilinks={(q) => pages.search(q)}\n  />\n</FormField>",
+    "group": "data-entry",
+    "importPath": "@godxjp/block-editor",
+    "name": "BlockEditor",
+    "props": [
+      {
+        "description": "Controlled Markdown body (with `onValueChange`).",
+        "name": "value",
+        "type": "string"
+      },
+      {
+        "description": "Uncontrolled initial body.",
+        "name": "defaultValue",
+        "type": "string"
+      },
+      {
+        "description": "Canonical Markdown after each edit — `serialize(editor.getJSON())`, identical to `normalize(body)` from `@godxjp/markdown/codec` (CODEC_ID kit-md@1).",
+        "name": "onValueChange",
+        "type": "(markdown: string) => void"
+      },
+      {
+        "description": "Stores a pasted / dropped / chosen file (return `asset:<id>` if you like). An inline placeholder shows progress; failure offers Retry / Remove; deleting the placeholder aborts `signal`. Images become `![name](url)`, other files a link.",
+        "name": "upload",
+        "type": "(file: File, options: { signal: AbortSignal }) => Promise<{ url: string; name?: string }>"
+      },
+      {
+        "description": "The host's media library; the `/` Image row opens it instead of a file picker.",
+        "name": "pickMedia",
+        "type": "() => Promise<{ url: string; name?: string } | null>"
+      },
+      {
+        "description": "Refuse files with this message.",
+        "name": "uploadBlockedReason",
+        "type": "string | null"
+      },
+      {
+        "description": "`[[` suggestions from the host's page index; picking inserts `[[target|label]]`.",
+        "name": "suggestWikilinks",
+        "type": "(query: string) => WikilinkSuggestion[] | Promise<WikilinkSuggestion[]>"
+      },
+      {
+        "description": "Renders a block embed `![[target]]`; default is a labelled placeholder.",
+        "name": "renderEmbed",
+        "type": "(target: string) => ReactNode"
+      },
+      {
+        "description": "Resolves a stored image URL (`asset:<id>`) for display; the body keeps the original.",
+        "name": "resolveUrl",
+        "type": "(url: string) => string | undefined"
+      },
+      {
+        "defaultValue": "\"framed\"",
+        "description": "framed: a field's border, padding and focus colour, so the editor reads as an editor inside a form; plain: the borderless Notion-style canvas for a full-page editor.",
+        "name": "appearance",
+        "type": "\"framed\" | \"plain\""
+      },
+      {
+        "description": "Extra `/` rows ({ key, label, icon, keywords?, run(api) }) — `api.insertMarkdown` inserts through the codec.",
+        "name": "actions",
+        "type": "BlockEditorAction[]"
+      },
+      {
+        "description": "Override any string (defaults: kit ja / en / vi).",
+        "name": "labels",
+        "type": "Partial<BlockEditorLabels>"
+      },
+      {
+        "description": "Not editable; the body still renders as Prose.",
+        "name": "disabled / readOnly",
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "MarkdownEditor — a Textarea with Markdown tooling, for raw-Markdown editing.",
+      "Markdown — rendering a stored body (same grammar, renderer v4)."
+    ],
+    "rules": [],
+    "storyPath": "data-entry/block-editor.tsx",
+    "tagline": "Notion / note.com style block editor (sibling package `@godxjp/block-editor`, versioned with the kit) that reads and writes MARKDOWN through `@godxjp/markdown/codec`: what onValueChange returns is byte-for-byte normalize(body). `/` block menu at the caret, ⋮⋮ handle (drag, turn into, duplicate, move, delete), floating format toolbar, `[[` wikilink suggestions, paste / drop uploads through the host, IME-safe, ja / en / vi (gh#1156).",
+    "usage": [
+      "Clicking a link (or Mod+K) opens a settings drawer: text, URL, title, open / remove. Clicking an image opens one for src, alt, title, replace (pickMedia / upload) and remove. Markdown stores no link target, so there is no target field. A link in the editor never navigates mid-edit.",
+      "YAML front matter shows as a Properties block at the top and round-trips verbatim; read it with frontmatterOf() from @godxjp/markdown/codec.",
+      "DO store the Markdown it emits — it is already canonical; compute `normalize()` server-side from the same codec to verify.",
+      "DO give it a name: wrap in `FormField` or pass `aria-label` / `aria-labelledby` (the editable is a named `textbox`).",
+      "DO pass `upload` (and `pickMedia` for a library) instead of handling paste yourself.",
+      "DON'T render Markdown into it via HTML — pass `value`; HTML paste from other apps is handled by the schema.",
+      "Keyboard: `/` menu (↑↓ Enter Esc), Alt+Shift+↑/↓ moves a block, Mod+/ opens the block menu, Markdown shortcuts (`# `, `- `, `> `, ```` ``` ````, `---`)."
+    ]
+  },
   {
     "example": "import { Prose } from \"@godxjp/ui/data-display\";\nimport Markdown from \"react-markdown\";\nimport remarkGfm from \"remark-gfm\";\n\n<Prose size=\"sm\">\n  <Markdown remarkPlugins={[remarkGfm]}>{issue.description}</Markdown>\n</Prose>",
     "group": "data-display",
@@ -11389,6 +11581,12 @@
         "name": "defaultExpandAll",
         "type": "boolean"
       },
+      {
+        "defaultValue": "false",
+        "description": "Expand a parent by clicking its ROW, not only its switcher (antd DirectoryTree): \"click\" selects AND toggles — a page tree where choosing a folder opens it; \"doubleClick\" toggles on a double click (gh#1162). Keyboard keeps the APG map.",
+        "name": "expandAction",
+        "type": "false | \"click\" | \"doubleClick\""
+      },
       {
         "description": "Lazy children (antd `loadData`). Called when a branch with no `children` and `isLeaf !== true` is expanded, and never again once its promise RESOLVES; a Skeleton row and `aria-busy` cover the wait. Push the fetched children into `treeData`. A REJECTED promise is not a load (rc-tree, gh#1041): the branch folds back shut (uncontrolled expansion) and the next expand asks again, up to 10 attempts.",
         "name": "loadData",
@@ -14177,6 +14375,11 @@
         "required": true,
         "type": "CommandPaletteGroup[]"
       },
+      {
+        "description": "Decorative glyph before an item's label — a folder, a file, an emoji (gh#1159). Menu-row icon size (--menu-icon-size), aria-hidden: the label stays the option's name.",
+        "name": "groups[].items[].icon",
+        "type": "ReactNode"
+      },
       {
         "description": "Localized dialog and search copy.",
         "name": "labels",
@@ -14255,6 +14458,84 @@
       "The empty-state contract: with `shouldFilter` (default) cmdk decides — items exist, the query matches none. With `shouldFilter={false}` the PALETTE decides from props — `labels.empty` renders when `groups` carries no items, and never while `loading` or `error` is set. Hold `loading` for the whole in-flight window: a request that has not answered yet is not an empty result, and asserting over cmdk's own empty node races an async group that populates a frame late."
     ]
   },
+  {
+    "docPath": "docs/data-entry/emoji-picker.tsx",
+    "example": "import { EmojiPicker } from \"@godxjp/ui/data-entry\";\n\n<EmojiPicker value={icon} onValueChange={setIcon} />",
+    "group": "data-entry",
+    "importPath": "@godxjp/ui/data-entry",
+    "name": "EmojiPicker",
+    "props": [
+      {
+        "description": "The chosen emoji (controlled with onValueChange).",
+        "name": "value",
+        "type": "string | null"
+      },
+      {
+        "description": "Uncontrolled initial emoji.",
+        "name": "defaultValue",
+        "type": "string | null"
+      },
+      {
+        "description": "Picked emoji, or null from \"remove icon\".",
+        "name": "onValueChange",
+        "type": "(emoji: string | null) => void"
+      },
+      {
+        "description": "The popover.",
+        "name": "open / defaultOpen / onOpenChange",
+        "type": "boolean / boolean / (open) => void"
+      },
+      {
+        "defaultValue": "true",
+        "description": "Offer \"remove icon\" while a value is set.",
+        "name": "removable",
+        "type": "boolean"
+      },
+      {
+        "defaultValue": "\"godxjp-ui:emoji-recents\"",
+        "description": "localStorage key for the per-user recents.",
+        "name": "recentsKey",
+        "type": "string"
+      },
+      {
+        "defaultValue": "\"md\"",
+        "description": "Trigger size.",
+        "name": "size",
+        "type": "\"xs\" | \"sm\" | \"md\" | \"lg\""
+      },
+      {
+        "description": "Replace the default trigger (e.g. the page icon drawn large).",
+        "name": "trigger",
+        "type": "ReactNode"
+      },
+      {
+        "description": "Disables the trigger.",
+        "name": "disabled",
+        "type": "boolean"
+      },
+      {
+        "description": "Accessible name for the trigger; defaults to the localized \"Choose an icon\".",
+        "name": "aria-label",
+        "type": "string"
+      },
+      {
+        "description": "Id on the trigger button.",
+        "name": "id",
+        "type": "string"
+      }
+    ],
+    "related": [
+      "PageContainer — `icon` slot.",
+      "CommandPalette — items can carry an emoji `icon`."
+    ],
+    "rules": [],
+    "storyPath": "data-entry/emoji-picker.tsx",
+    "tagline": "Page icon / reaction picker in a Popover (gh#1164): search by the active language's CLDR keywords (ja / en / vi — emojibase-data, loaded lazily for that locale only), categories, per-user recents, a WAI-ARIA grid (one tab stop, arrows, Home / End, Enter), and \"remove icon\". No skin tones.",
+    "usage": [
+      "DO use it for a page icon next to PageContainer `icon` — pass the icon itself as `trigger`.",
+      "The data loads on first open (one locale, ~100 KB gzip); nothing ships in your main bundle."
+    ]
+  },
   {
     "example": "import { TwoFactorSetup } from \"@godxjp/ui/feedback\";\n\n<TwoFactorSetup\n  open={open}\n  onOpenChange={setOpen}\n  qrValue={enrollment.qr}\n  manualKey={enrollment.secret}\n  code={code}\n  onCodeChange={setCode}\n  onConfirm={verify}\n  recoveryCodes={recoveryCodes}\n  onAcknowledge={finish}\n  labels={labels}\n/>",
     "group": "feedback",

package/agent/index.json

@@ -1,21 +1,21 @@
 {
   "counts": {
     "anti-ai-tells": 26,
-    "components": 181,
+    "components": 184,
     "patterns": 21,
     "rules": 50,
-    "tokens": 2137,
+    "tokens": 2155,
     "vocabulary": 14
   },
   "files": [
     {
       "file": "components-index.json",
-      "note": "50 KB — name + group + tagline for all 181. FETCH THIS FIRST, then fetch only the components you chose.",
+      "note": "51 KB — name + group + tagline for all 184. FETCH THIS FIRST, then fetch only the components you chose.",
       "url": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json"
     },
     {
       "file": "components/<Name>.json",
-      "note": "One file per component (1 KB–36 KB, median 6 KB), each carrying its importPath. This is the selective route: read the index, then fetch only what you need instead of the 1.2 MB blob.",
+      "note": "One file per component (1 KB–36 KB, median 6 KB), each carrying its importPath. This is the selective route: read the index, then fetch only what you need instead of the 1.3 MB blob.",
       "url": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components/<Name>.json"
     },
     {
@@ -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.26.2/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.28.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",
   "tokenTiers": {
     "component": "per-part knobs, --{component}-{part}-{property}; usually leave these alone",
     "counts": {
-      "component": 1822,
+      "component": 1832,
       "foundation": 211,
-      "semantic": 104
+      "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.26.2"
+  "version": "31.28.0"
 }

package/agent/llms.txt

@@ -1,10 +1,10 @@
 # @godxjp/ui
 
-> A Japanese-enterprise React design system: 181 components, 2137 design tokens,
-> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.26.2.
+> 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.0.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@31.26.2`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@31.28.0`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
@@ -15,10 +15,10 @@ 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): 50 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): 51 KB — all 184 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, 1822 `component` knobs.
+- [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.
 - [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.26.2/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v31.28.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/agent/tokens.json

@@ -1745,6 +1745,54 @@
     "tier": "semantic",
     "value": "var(--heading-h3, var(--font-size-base))"
   },
+  {
+    "description": "PageContainer `headerScale=\"display\"` (gh#1160) — an ARTICLE's headline (a Notion / note.com page). The 4xl display step, which already scales with the viewport through `--font-size-display`'s clamp (≈25px on a phone → 42px wide), so one knob covers phone and desktop and the compact step below does not apply. CJK titles need more leading than Latin ones at this size: 1.4, not the tight 1.25 a short Latin headline gets.",
+    "name": "--page-title-font-size-display",
+    "tier": "semantic",
+    "value": "var( --font-size-4xl, calc(var(--font-size-display) / var(--font-size-display-ratio)) )"
+  },
+  {
+    "description": "Layout primitive tokens: page, section, stack, inline.",
+    "name": "--page-title-line-height-display",
+    "tier": "semantic",
+    "value": "1.4"
+  },
+  {
+    "description": "The page icon above the title (gh#1160): emoji or glyph, and how far it rides up over a banner cover's bottom edge.",
+    "name": "--page-icon-size",
+    "tier": "semantic",
+    "value": "var(--icon-size-4xl)"
+  },
+  {
+    "description": "Layout primitive tokens: page, section, stack, inline.",
+    "name": "--page-icon-cover-overlap",
+    "tier": "semantic",
+    "value": "calc(var(--page-icon-size) * 0.6)"
+  },
+  {
+    "description": "PageCover (gh#1160). A banner's height scales with the viewport between a phone floor and a desktop ceiling — one knob per step, no media query; an eyecatch keeps note.com's ~1.91:1.",
+    "name": "--page-cover-block-size-md",
+    "tier": "semantic",
+    "value": "clamp(8rem, 24vw, 15rem)"
+  },
+  {
+    "description": "Layout primitive tokens: page, section, stack, inline.",
+    "name": "--page-cover-block-size-lg",
+    "tier": "semantic",
+    "value": "clamp(10rem, 32vw, 20rem)"
+  },
+  {
+    "description": "Layout primitive tokens: page, section, stack, inline.",
+    "name": "--page-cover-eyecatch-aspect-ratio",
+    "tier": "semantic",
+    "value": "1.91"
+  },
+  {
+    "description": "default = var(--card-radius) at the call site (gh#888)",
+    "name": "--page-cover-radius",
+    "tier": "semantic",
+    "value": "initial"
+  },
   {
     "description": "The SUBTITLE step of the same fact. Measured against the reference chat screen, the chrome title and the chrome subtitle were rendering at the SAME step (both --font-size-base), which is not a hierarchy — a channel name and the channel's purpose line read as one undifferentiated block. The design puts the purpose line two steps down (`Text size=\"2xs\"`), and the size is what carries the LINE BOX: at 14px/1.7 the subtitle line is 23.8px tall, at 11px/1.7 it is 18.9px, so the whole header band loses ~5px it was spending on a caption. `--font-size-2xs` (ratio⁻², ≈11px) is that step, and it is the same golden scale the title step reads — never a literal. Quiet by default: a page that never passes `headerScale` never resolves it (#44).",
     "name": "--page-subtitle-font-size-chrome",
@@ -4835,6 +4883,30 @@
     "tier": "component",
     "value": "initial"
   },
+  {
+    "description": "EmojiPicker (gh#1164): the panel width, an emoji cell (a touch-sized square), the glyph inside it, and how tall the grid gets before it scrolls.",
+    "name": "--emoji-picker-cell-size",
+    "tier": "component",
+    "value": "var(--control-height-default)"
+  },
+  {
+    "description": "Eight cells plus the popover's inset — derived, so 44px touch cells (coarse pointer) still fit eight to a row (8 × 44 + insets = 376px, inside a 390px phone).",
+    "name": "--emoji-picker-panel-inline-size",
+    "tier": "component",
+    "value": "calc( 8 * var(--emoji-picker-cell-size) + 2 * var(--popover-space-inset, var(--space-3)) )"
+  },
+  {
+    "description": "Control primitive tokens: heights, horizontal padding, adjacent control sizes.",
+    "name": "--emoji-picker-glyph-size",
+    "tier": "component",
+    "value": "var(--icon-size-lg)"
+  },
+  {
+    "description": "Control primitive tokens: heights, horizontal padding, adjacent control sizes.",
+    "name": "--emoji-picker-grid-max-block-size",
+    "tier": "component",
+    "value": "16rem"
+  },
   {
     "description": "Control primitive tokens: heights, horizontal padding, adjacent control sizes.",
     "name": "--control-height-compact",
@@ -5231,6 +5303,42 @@
     "tier": "component",
     "value": "20rem"
   },
+  {
+    "description": "Grammar v1 blocks (gh#1156). Columns sit this far apart and stack below 40rem; a toggle's summary is the control that opens it. Callouts reuse the <Callout> geometry (--callout-*).",
+    "name": "--prose-columns-gap",
+    "tier": "component",
+    "value": "var(--space-6)"
+  },
+  {
+    "description": "@godxjp/block-editor (gh#1156): the start gutter the ⋮⋮ / + handle sits in, and the editing surface's minimum height (an empty body is still a target you can click into).",
+    "name": "--block-editor-gutter-inline-size",
+    "tier": "component",
+    "value": "calc(2 * var(--control-height-xs) + var(--space-2))"
+  },
+  {
+    "description": "Data-display component tokens — small-by-design text knobs (rule #45/#46).",
+    "name": "--block-editor-min-height",
+    "tier": "component",
+    "value": "var(--band-height-3xl)"
+  },
+  {
+    "description": "`appearance=\"framed\"`: the inset between the frame and the text (the handle gutter is extra).",
+    "name": "--block-editor-frame-padding",
+    "tier": "component",
+    "value": "var(--space-3)"
+  },
+  {
+    "description": "Data-display component tokens — small-by-design text knobs (rule #45/#46).",
+    "name": "--block-editor-menu-inline-size",
+    "tier": "component",
+    "value": "16rem"
+  },
+  {
+    "description": "Data-display component tokens — small-by-design text knobs (rule #45/#46).",
+    "name": "--block-editor-menu-max-block-size",
+    "tier": "component",
+    "value": "20rem"
+  },
   {
     "description": "gh#888 — φ tier freezes at :root; default = calc(var(--radius) / var(--radius-ratio) / var(--radius-ratio))",
     "name": "--prose-code-radius",

package/dist/components/data-display/tree.js

@@ -63,6 +63,7 @@ function TreeRoot({
   defaultExpandedValues,
   onExpandedValuesChange,
   defaultExpandAll = false,
+  expandAction = false,
   loadData,
   titleRender,
   filterTreeNode,
@@ -491,6 +492,10 @@ function TreeRoot({
         onClick: () => {
           if (nodeDisabled) return;
           select(node);
+          if (expandAction === "click" && expandable) toggleExpand(node);
+        },
+        onDoubleClick: () => {
+          if (!nodeDisabled && expandAction === "doubleClick" && expandable) toggleExpand(node);
         },
         "data-value": node.value,
         "data-selected": isSelected ? "true" : void 0,

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

@@ -2,6 +2,11 @@ import * as React from "react";
 export type CommandPaletteItem = {
     id: string;
     label: React.ReactNode;
+    /**
+     * Decorative glyph before the label — a folder, a file, an emoji (gh#1159). Sized like a menu
+     * row's icon (`--menu-icon-size`) and hidden from assistive tech: the label is the name.
+     */
+    icon?: React.ReactNode;
     searchValue?: string;
     meta?: React.ReactNode;
     disabled?: boolean;

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

@@ -189,6 +189,7 @@ function CommandPalette({
                         onSelect(item, modifiers);
                       },
                       children: [
+                        item.icon != null ? /* @__PURE__ */ jsx("span", { className: "ui-command-palette-icon", "aria-hidden": "true", children: item.icon }) : null,
                         /* @__PURE__ */ jsx("span", { className: "ui-command-palette-label", children: item.label }),
                         item.meta != null ? /* @__PURE__ */ jsx("span", { className: "ui-command-palette-meta", children: item.meta }) : null
                       ]