@godxjp/ui 30.8.0 → 30.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -214,7 +214,29 @@ slices below roughly 620 distinct characters. Full table and reasoning in
214
214
  > missing layer fails silently: menus render with no background, rows with no
215
215
  > height. `styles`, `styles/core`, `styles/core-with-fallbacks` and
216
216
  > `styles/core-with-jis-level1` are the four supported entries; the runtime `visual-audit` flags a
217
- > page whose layers are incomplete (`css-layers-missing`).
217
+ > page whose layers are incomplete (`css-layers-missing`). The one supported way to ship LESS
218
+ > than `core` is `prune-css` below — the tool slices along the dependency graph the package
219
+ > ships, so it cannot forget a layer the way a hand-picked list does.
220
+
221
+ ### prune-css — ship only the component layers you use (gh#971)
222
+
223
+ `core` still carries every component's layers (~64 KB gzip for all ~165). If that remainder
224
+ matters, let the package slice it:
225
+
226
+ ```bash
227
+ npx @godxjp/ui prune-css resources/js --out resources/css/godx-ui.css # --fonts for the bundled faces
228
+ ```
229
+
230
+ It scans your sources for `@godxjp/ui` imports, resolves the CSS layer dependency closure from
231
+ the graph shipped in `dist/styles/layers.json` (what each component's internals render is part
232
+ of the graph — a `DataTable` still gets its dropdown and pagination surfaces), and emits a file
233
+ that imports the foundation plus only the needed layers, in `styles/index.css`'s exact order.
234
+ Import that file INSTEAD of `@godxjp/ui/styles`. Defaults mirror `styles/core` (no
235
+ `@font-face`); the sonner / react-day-picker vendor sheets come along only when a used
236
+ component renders them. **Re-run it whenever the set of components you use changes and after
237
+ every upgrade** — the emitted header says so, and the tool refuses to run against a manifest
238
+ from a different package version. Measured on gh#971's 15-component app: 368 KB gzip
239
+ (`styles`) → 86 KB (`core`) → 75 KB pruned; a small 8-component app lands at 55 KB.
218
240
 
219
241
  ## Golden ratio (φ ≈ 1.618)
220
242
 
@@ -3,7 +3,7 @@
3
3
  You are about to write code against a design system you did not author. This file is the whole
4
4
  contract. Read it before you write JSX.
5
5
 
6
- **This catalog describes `@godxjp/ui` 30.8.0.** If the project you are editing has a different
6
+ **This catalog describes `@godxjp/ui` 30.9.0.** If the project you are editing has a different
7
7
  version in its `package.json`, read the pinned catalog for THAT version instead
8
8
  (`…/v<their-version>/agent/…`). A catalog newer than the installed package describes props that do
9
9
  not exist yet; older, and it hides props that do. Neither failure announces itself.
package/agent/index.json CHANGED
@@ -48,7 +48,7 @@
48
48
  "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.",
49
49
  "read": {
50
50
  "live": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/index.json",
51
- "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v30.8.0/agent/index.json"
51
+ "pinned": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/v30.9.0/agent/index.json"
52
52
  },
53
53
  "source": "mcp/src/data — the same data @godxjp/ui-mcp serves — plus the foundation and semantic token tiers, read from src/tokens/*.css",
54
54
  "start": "https://raw.githubusercontent.com/godx-jp/godxjp-ui/main/agent/START-HERE.md",
@@ -62,5 +62,5 @@
62
62
  "foundation": "the seeds a consumer is invited to set — --primary, --background, --radius",
63
63
  "semantic": "named roles that follow the seeds — --ring, --text-link, --overlay-background"
64
64
  },
65
- "version": "30.8.0"
65
+ "version": "30.9.0"
66
66
  }
package/agent/llms.txt CHANGED
@@ -1,10 +1,10 @@
1
1
  # @godxjp/ui
2
2
 
3
3
  > A Japanese-enterprise React design system: 175 components, 2074 design tokens,
4
- > 50 cardinal rules. This file is the entry point for AI agents. Catalog version 30.8.0.
4
+ > 50 cardinal rules. This file is the entry point for AI agents. Catalog version 30.9.0.
5
5
 
6
6
  If your client can run a process, do not read these files — run the MCP server instead
7
- (`npx @godxjp/ui-mcp@30.8.0`). It is searchable and version-locked. These files exist for agents
7
+ (`npx @godxjp/ui-mcp@30.9.0`). It is searchable and version-locked. These files exist for agents
8
8
  that can only fetch URLs.
9
9
 
10
10
  ## Start
@@ -26,7 +26,7 @@ that can only fetch URLs.
26
26
  ## Pinning
27
27
 
28
28
  Every URL above tracks `main`. To pin to the release a project actually installed, swap `main` for
29
- the tag: `.../godx-jp/godxjp-ui/v30.8.0/agent/...`. A catalog that does not match the installed
29
+ the tag: `.../godx-jp/godxjp-ui/v30.9.0/agent/...`. A catalog that does not match the installed
30
30
  package describes props that are absent, or hides props that are present, and says nothing either way.
31
31
 
32
32
  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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$comment": "AUTO-GENERATED by scripts/gen-measurement-contract.mjs — do not edit. Read this instead of guessing: docs/MEASUREMENT-CONTRACT.md.",
3
- "version": "30.8.0",
3
+ "version": "30.9.0",
4
4
  "targetSize": {
5
5
  "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
6
6
  "min": 24,