@godxjp/ui 31.28.0 → 31.28.2

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.0.** If the project you are editing has a different
+**This catalog describes `@godxjp/ui` 31.28.2.** 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.

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.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).",

package/agent/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.28.0/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v31.28.2/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.28.0"
+  "version": "31.28.2"
 }

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.0.
+> 50 cardinal rules. This file is the entry point for AI agents. Catalog version 31.28.2.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@31.28.0`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@31.28.2`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
@@ -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.0/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v31.28.2/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/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.0",
+  "version": "31.28.2",
   "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

@@ -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/layers.json

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

package/docs/FORMS.md

@@ -10,6 +10,11 @@ All forms in admin apps **must** use:
 
 Import from `@godxjp/ui/form` — **never** call `useForm()` without `zodResolver`.
 
+Install all three with the kit: `npm i @godxjp/ui react-hook-form zod @hookform/resolvers`.
+`@hookform/resolvers` is deliberately **not** a declared peer, so npm will not check its version
+for you: keep it at ^5.2 (the first line with Zod 4 support). Declaring it made a plain
+`npm install @godxjp/ui` fail with ERESOLVE, because npm walks its own optional peers (gh#1111).
+
 ## Quick start
 
 ```tsx

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@godxjp/ui",
-  "version": "31.28.0",
-  "godxUiMcp": "31.28.0",
+  "version": "31.28.2",
+  "godxUiMcp": "31.28.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -438,7 +438,6 @@
     "check:frame-token-scope": "node scripts/check-frame-token-scope.mjs"
   },
   "peerDependencies": {
-    "@hookform/resolvers": "^5.2.0",
     "@tanstack/react-query": ">=5.0.0",
     "playwright": "*",
     "react": ">=19.0.0",
@@ -450,9 +449,6 @@
     "zod": "^4.4.0"
   },
   "peerDependenciesMeta": {
-    "@hookform/resolvers": {
-      "optional": true
-    },
     "@tanstack/react-query": {
       "optional": true
     },