@godxjp/ui 32.7.0 → 32.7.1

package/DESIGN.md

@@ -148,7 +148,7 @@ Header: record name as title, status `Badge` beside it, actions in `extra` (one
 
 ### Editor
 
-Edit (or create) one document or record. Header: record name as title, status `Badge` beside it, a subtitle only for a fact such as when it was last saved, and ONE primary Save in `extra` (`Button type="submit" form=<form id>`), Cancel `outline` before it. Body: one `Form` in a `SplitPane`: the main column holds the title field and a large body editor (`BlockEditor`, or `Textarea autoSize`); the aside holds metadata fields, read-only facts in `Descriptions`, and the change note last. No Card per field group, no second Save at the bottom.
+Edit (or create) one document or record. Header: record name as title, status `Badge` beside it, a subtitle only for a fact such as when it was last saved, and ONE primary Save in `extra` (`Button type="submit" form=<form id>`), Cancel `outline` before it. Body: one `Form` in a `SplitPane`: the main column holds the title field and a large body editor (`BlockEditor`, or `Textarea autoSize`); the aside holds metadata fields and read-only facts in `Descriptions`. The change note goes either directly under the body (where the writer finishes) or last in the aside — pick one per app and keep it. Name each aside group with a `Heading level={2}` one step above its field labels. A part that is its own controlled component with its own `Form` (forms cannot nest) stays a separate form; the header Save then submits by handler (`onClick`) instead of `form=<id>`, still one Save. No Card per field group, no second Save at the bottom.
 
 ### Reader
 
@@ -208,3 +208,4 @@ A list whose rows are decisions. Show requester, target, reason, submitted time;
 - `card-per-section` counts Cards per file, so a screen split across components can pass with a Card around every section.
 - Exemplar previews deploy on release tags, so they can lag `main`. On GitHub Pages a showcase URL answers HTTP 404 and renders through `404.html`, so open it in a browser; a plain fetch sees the 404.
 - Dark theme (`data-theme="dark"`) is supported; the exemplars are reviewed in light.
+- On narrow screens the `PageContainer` title steps down (≈17.6px) while body h2 stays ≈15.7px — one step apart. A document page not built on `LegalDocumentShell` keeps only that step on phones; there is no intermediate page-title size yet.

package/README.md

@@ -51,7 +51,7 @@ static files straight from this public repo — no hosting, no deploy step:
 | --- | --- | --- |
 | [`agent/START-HERE.md`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/START-HERE.md) | 11 KB | **read first** — self-contained: the four rules, the token override model, a page that passes review |
 | [`agent/llms.txt`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/llms.txt) | 3 KB | the [llms.txt](https://llmstxt.org/) entry point |
-| [`agent/DESIGN.md`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/DESIGN.md) | 13 KB | the visual spec: tokens, colour scarcity, admin screen anatomy, do/don't |
+| [`agent/DESIGN.md`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/DESIGN.md) | 14 KB | the visual spec: tokens, colour scarcity, admin screen anatomy, do/don't |
 | [`agent/index.json`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/index.json) | 3 KB | manifest: version, counts, every file's URL |
 | [`agent/components-index.json`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components-index.json) | 47 KB | all 161 as name + group + tagline — **fetch this first** |
 | [`agent/components/<Name>.json`](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/components/Select.json) | 1 KB–37 KB | one file per component, each with its `importPath` — **this is the route to take** |

package/agent/DESIGN.md

@@ -148,7 +148,7 @@ Header: record name as title, status `Badge` beside it, actions in `extra` (one
 
 ### Editor
 
-Edit (or create) one document or record. Header: record name as title, status `Badge` beside it, a subtitle only for a fact such as when it was last saved, and ONE primary Save in `extra` (`Button type="submit" form=<form id>`), Cancel `outline` before it. Body: one `Form` in a `SplitPane`: the main column holds the title field and a large body editor (`BlockEditor`, or `Textarea autoSize`); the aside holds metadata fields, read-only facts in `Descriptions`, and the change note last. No Card per field group, no second Save at the bottom.
+Edit (or create) one document or record. Header: record name as title, status `Badge` beside it, a subtitle only for a fact such as when it was last saved, and ONE primary Save in `extra` (`Button type="submit" form=<form id>`), Cancel `outline` before it. Body: one `Form` in a `SplitPane`: the main column holds the title field and a large body editor (`BlockEditor`, or `Textarea autoSize`); the aside holds metadata fields and read-only facts in `Descriptions`. The change note goes either directly under the body (where the writer finishes) or last in the aside — pick one per app and keep it. Name each aside group with a `Heading level={2}` one step above its field labels. A part that is its own controlled component with its own `Form` (forms cannot nest) stays a separate form; the header Save then submits by handler (`onClick`) instead of `form=<id>`, still one Save. No Card per field group, no second Save at the bottom.
 
 ### Reader
 
@@ -208,3 +208,4 @@ A list whose rows are decisions. Show requester, target, reason, submitted time;
 - `card-per-section` counts Cards per file, so a screen split across components can pass with a Card around every section.
 - Exemplar previews deploy on release tags, so they can lag `main`. On GitHub Pages a showcase URL answers HTTP 404 and renders through `404.html`, so open it in a browser; a plain fetch sees the 404.
 - Dark theme (`data-theme="dark"`) is supported; the exemplars are reviewed in light.
+- On narrow screens the `PageContainer` title steps down (≈17.6px) while body h2 stays ≈15.7px — one step apart. A document page not built on `LegalDocumentShell` keeps only that step on phones; there is no intermediate page-title size yet.

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

@@ -11,7 +11,7 @@
   "files": [
     {
       "file": "DESIGN.md",
-      "note": "13 KB — the visual spec: tokens, colour scarcity, admin screen anatomy (list, detail, form, settings, dashboard), do/don't. Read before composing a screen.",
+      "note": "14 KB — the visual spec: tokens, colour scarcity, admin screen anatomy (list, detail, form, settings, dashboard), do/don't. Read before composing a screen.",
       "url": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/DESIGN.md"
     },
     {
@@ -54,7 +54,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/v32.7.0/agent/index.json"
+    "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v32.7.1/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",
@@ -68,5 +68,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": "32.7.0"
+  "version": "32.7.1"
 }

package/agent/llms.txt

@@ -1,17 +1,17 @@
 # @godxjp/ui
 
 > A Japanese-enterprise React design system: 161 components, 2197 design tokens,
-> 43 cardinal rules. This file is the entry point for AI agents. Catalog version 32.7.0.
+> 43 cardinal rules. This file is the entry point for AI agents. Catalog version 32.7.1.
 
 If your client can run a process, do not read these files — run the MCP server instead
-(`npx @godxjp/ui-mcp@32.7.0`). It is searchable and version-locked. These files exist for agents
+(`npx @godxjp/ui-mcp@32.7.1`). It is searchable and version-locked. These files exist for agents
 that can only fetch URLs.
 
 ## Start
 
 - [START-HERE.md](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/START-HERE.md): the whole contract — the four rules, the token override model, a page that passes review. Read this first; it is self-contained.
 - [index.json](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/index.json): version, counts, and the URL of every file.
-- [DESIGN.md](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/DESIGN.md): 13 KB — the visual spec: tokens, colour scarcity, admin screen anatomy (list, detail, form, settings, dashboard), do/don't. Read it before composing a screen.
+- [DESIGN.md](https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/DESIGN.md): 14 KB — the visual spec: tokens, colour scarcity, admin screen anatomy (list, detail, form, settings, dashboard), do/don't. Read it before composing a screen.
 
 ## Catalog
 
@@ -27,7 +27,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/v32.7.0/agent/...`. A catalog that does not match the installed
+the tag: `.../godx-jp/godxjp-ui/v32.7.1/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": "32.7.0",
+  "version": "32.7.1",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

package/dist/styles/layers.json

@@ -1,5 +1,5 @@
 {
-  "version": "32.7.0",
+  "version": "32.7.1",
   "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": "32.7.0",
-  "godxUiMcp": "32.7.0",
+  "version": "32.7.1",
+  "godxUiMcp": "32.7.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/scripts/_agent-setup.mjs

@@ -187,8 +187,9 @@ Follow this every time you create or change a page, component or form.
 2. **Route.** \`route_consumer_task "<task>"\` → \`compose-a-screen\` for app screens. The
    marketing skills (soft, minimalist, brutalist, gpt-tasteskill, imagegen-*) are for landing
    pages only.
-3. **Exemplar.** \`get_exemplar\` with archetype list | detail | form | settings | dashboard |
-   approval. Match its structure; it is the visual target.
+3. **Exemplar.** \`get_exemplar\` for the closest archetype (call it with no argument for the
+   list: list, detail, editor/form, reader/document, settings, dashboard, approval-queue). Match
+   its structure; it is the visual target.
 4. **Discover, then look up.** \`search_components "<area>"\` first, \`get_component <Name>\`
    second — \`get_component\` cannot find a name you do not already have (a consumer hand-rolled
    the shipped \`OrgSwitcher\` and \`TopbarItem\` this way). Code already in this repo is not the
@@ -226,7 +227,8 @@ ${STAMP(KIT_VERSION)}
 Before any JSX for a screen:
 1. Read \`node_modules/@godxjp/ui/DESIGN.md\` (MCP \`get_design\`).
 2. \`route_consumer_task\` → \`compose-a-screen\`; \`search_components\` before hand-rolling anything.
-3. \`get_exemplar\` (list | detail | form | settings | dashboard | approval) — match its structure.
+3. \`get_exemplar\` (no argument lists the archetypes: list, detail, editor, reader, settings,
+   dashboard, approval-queue) — match its structure.
 
 After building:
 4. \`npx @godxjp/ui audit <files>\` — zero errors.

package/scripts/ui-audit.mjs

@@ -109,8 +109,12 @@ function changedFiles() {
   }
 
   const parts = [
-    run(["diff", "--name-only", "--diff-filter=ACMR", mergeBase.trim(), "--"]),
-    run(["diff", "--name-only", "--diff-filter=ACMR", "--cached"]),
+    // `--relative` (gh#1296): `git diff` names paths from the REPO root, `ls-files` from the cwd.
+    // Run from a workspace package (pages/) the root-relative names failed the existsSync below
+    // and were dropped, so 16 changed .tsx read as "no .tsx/.jsx changed" — a false clean.
+    // `--relative` makes both cwd-relative and limits them to the package being audited.
+    run(["diff", "--relative", "--name-only", "--diff-filter=ACMR", mergeBase.trim(), "--"]),
+    run(["diff", "--relative", "--name-only", "--diff-filter=ACMR", "--cached"]),
     run(["ls-files", "--others", "--exclude-standard"]),
   ];
   if (parts.some((out) => out === null)) {
@@ -2551,7 +2555,7 @@ if (filesScanned === 0 && !changedNoFiles) {
   // Dưới `--changed`, NÓI RA base đã so. Một base sai không làm chương trình chết — nó cho ra một
   // con số hợp lý, và đó là thứ duy nhất người đọc có thể dùng để nghi ngờ (gh#948).
   if (CHANGED && changed?.base) {
-    console.log(`${C.dim}so với: ${changed.base}${C.reset}`);
+    console.log(`${C.dim}compared with: ${changed.base}${C.reset}`);
   }
   // Bỏ file trong im lặng là cách một gate thu hẹp dần mà không ai thấy (cùng lý do với dòng
   // `so với:` ngay trên). Nói ra số file và lãnh thổ đã dùng.