@nadicodeai/design-system 12.1.232 → 12.1.233
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/AGENTS.md +3 -25
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# @nadicodeai/design-system
|
|
2
2
|
|
|
3
3
|
React components belong to `@nadicodeai/ui`, and a component's own contract is
|
|
4
|
-
the usage page in its source
|
|
4
|
+
the usage page in its source.
|
|
5
5
|
|
|
6
6
|
## What goes in DESIGN.md
|
|
7
7
|
|
|
@@ -26,11 +26,8 @@ rule goes to its owner:
|
|
|
26
26
|
|
|
27
27
|
- What a component or composition does, takes or holds: its types and the usage
|
|
28
28
|
page in its source in `@nadicodeai/ui`.
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
- What a landed change decided and worth repeating: an exemplar in the
|
|
32
|
-
`product-design` skill, whose rule index links every rule to its owner.
|
|
33
|
-
- A product's pages and scope: that app's docs.
|
|
29
|
+
|
|
30
|
+
The other owners are listed in `packages/AGENTS.md`, in nadicode's repository.
|
|
34
31
|
|
|
35
32
|
Edit `DESIGN.md` only when the look changes: a token, a material, the type
|
|
36
33
|
scale, a colour's meaning, a radius, a motion value.
|
|
@@ -40,25 +37,6 @@ scale, a colour's meaning, a radius, a motion value.
|
|
|
40
37
|
- Placement: `../ui/AGENTS.md`.
|
|
41
38
|
- Terms: `GLOSSARY.md`. Static consumption: `README.md`.
|
|
42
39
|
- React consumption: `../ui/README.md`.
|
|
43
|
-
- Visual checks: `playwright.visual.config.ts` and `tests/visual/`, run by
|
|
44
|
-
post-merge's `test (website)` job. Its `-linux` baselines are what the
|
|
45
|
-
CI runner image (`../../tools/ci/host/Dockerfile`) renders: after an intended
|
|
46
|
-
visual change, rerun `pnpm --filter @nadicodeai/design-system test:visual --update-snapshots`
|
|
47
|
-
inside that image and commit the new screenshots.
|
|
48
|
-
- Releases: `../../docs/agents/publish.md`.
|
|
49
|
-
|
|
50
|
-
Edit token sources (the four groups in `DESIGN.md`'s front matter, every other
|
|
51
|
-
value in `src/tokens/extension.tokens.json`), then run
|
|
52
|
-
`pnpm --filter @nadicodeai/design-system build`. Generated CSS and `dist/`
|
|
53
|
-
are outputs, not hand-edited sources. After changing a value, find every other
|
|
54
|
-
copy of it across the repository, generated and hard-coded, such as Alveare's
|
|
55
|
-
phone tokens and the Portal's emails, and run each one's generator or edit it. A value a person can see
|
|
56
|
-
also remakes the docs' screenshots and clips of each product that draws it
|
|
57
|
-
([Nadia's docs](../../apps/website/AGENTS.md#routes)). Favicon source changes use
|
|
58
|
-
`generate:favicons`; a lucide-static upgrade uses `generate:icons`.
|
|
59
|
-
|
|
60
|
-
Name primitives for nadicode's concepts, keeping source-brand lineage in
|
|
61
|
-
references.
|
|
62
40
|
|
|
63
41
|
## Tests
|
|
64
42
|
|