@nadicodeai/design-system 4.0.3 → 4.0.5
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 +16 -30
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -1,35 +1,21 @@
|
|
|
1
1
|
# @nadicodeai/design-system
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`DESIGN.md` owns tokens, CSS, and asset contracts. React components belong
|
|
4
|
+
to `@nadicodeai/ui`; `examples/` contains rendered specimens.
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
- Design and CSS changes: the relevant section of `DESIGN.md`.
|
|
7
|
+
- Terms: `CONTEXT.md`. Static consumption: `README.md`.
|
|
8
|
+
- React consumption: `../ui/docs/consuming-cross-repo.md`.
|
|
9
|
+
- Visual checks: `playwright.visual.config.ts` and `tests/visual/`.
|
|
10
|
+
- Releases: `../../docs/agents/publish.md`.
|
|
6
11
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
| `npm run test:visual -w @nadicodeai/design-system` | Rendered CSS checks |
|
|
12
|
+
Edit token sources in `DESIGN.md`, then run
|
|
13
|
+
`npm run build -w @nadicodeai/design-system`. Generated CSS and `dist/`
|
|
14
|
+
are outputs, not hand-edited sources. Favicon source changes use
|
|
15
|
+
`generate:favicons`; a lucide-static upgrade uses `generate:icons`.
|
|
16
|
+
`package.json` owns the commands; shared validation policy is in
|
|
17
|
+
`../../docs/agents/develop.md`.
|
|
14
18
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
| --- | --- |
|
|
19
|
-
| Design-language terms | `CONTEXT.md` |
|
|
20
|
-
| Colors, tokens, typography, layout, seams, components | `DESIGN.md` |
|
|
21
|
-
| CSS layers, token pipeline, dark remaps, generated outputs | [CSS Architecture & Token Pipeline](DESIGN.md#css-architecture--token-pipeline); decisions in `../../docs/adr/` |
|
|
22
|
-
| Where a token is authored | the `DESIGN.md` front matter and its `json design-tokens` fence, built by `scripts/sd/design-tokens-fence.ts` and `scripts/sd/compose-token-graph.ts` |
|
|
23
|
-
| Motion | [Motion](DESIGN.md#motion), `src/css/motion.css`, then `product-design` |
|
|
24
|
-
| Package exports | `package.json`; guard `../../scripts/check-export-targets.mjs` |
|
|
25
|
-
| Static consumption | `README.md`. React: `../ui/docs/consuming-cross-repo.md` |
|
|
26
|
-
| Logo forms and asset delivery | [Brand media authority](DESIGN.md#brand-media-authority); sources in `src/assets/` |
|
|
27
|
-
| `examples/` specimens | `examples/`; copy through `write-clearly` |
|
|
28
|
-
| Visual tests | `playwright.visual.config.ts`, `tests/visual/` |
|
|
29
|
-
| Releasing | `../../docs/agents/publish.md` |
|
|
30
|
-
|
|
31
|
-
## Rules
|
|
32
|
-
|
|
33
|
-
- Never edit `dist/**` or `src/css/*.generated.css` by hand; `npm run build` regenerates them from `DESIGN.md`.
|
|
34
|
-
- Authoring is contract-first: a visual behavior comes from `DESIGN.md`, a shipped surface, or an explicit approval; screenshots verify, never author.
|
|
35
|
-
- Name everything as a NadicodeAI-owned primitive; no source brand in a name, comment, or contract.
|
|
19
|
+
Visual behavior comes from the design contract, a shipped surface, or the
|
|
20
|
+
user's design decision. Screenshots verify that behavior. Name primitives
|
|
21
|
+
for NadicodeAI's concepts, keeping source-brand lineage in references.
|