AGENTS.md

1# @langgenius/dify-ui
2 
3This package owns shared design tokens, CSS-first Tailwind styles, the `cn()` utility, and headless primitives consumed by `web/`. Read only the matching topic in [`README.md`] for public imports, forms, typed values, pickers, overlays, tokens, or tests.
4 
5## Component Authoring Rules
6 
7- Build primitives from `@base-ui/react`, `cva`, and `cn`.
8- Use relative cross-component imports inside the package and subpath exports such as `@langgenius/dify-ui/button` from consumers. Add a matching `package.json#exports` entry for each public primitive.
9- Keep one primitive per `src/<name>/` folder with optional colocated stories and tests.
10- Do not import from `web/` or depend on Next.js, i18n, application state, or data-fetching libraries.
11- Preserve upstream Base UI anatomy and generic value contracts. Use discriminated unions when one prop changes the valid shape of related props; do not flatten those relationships or hard-code selectable values to `string`.
12- Export shared public types from the owning component subpath.
13- Prefer Base UI data attributes and CSS variables for visual states; do not mirror primitive state in React solely to add classes.
14- When a Base UI API or selector contract is unclear, read the current official documentation and local `@base-ui/react` type declarations before coding.
15 
16Use the README sections as the detailed owners:
17 
18- [Imports and public boundaries]
19- [Typed value contracts]
20- [Search and picker selection]
21- [Tailwind and Figma radius mapping]
22- [Overlay and portal contracts]
23- [Development and test boundaries]
24 
25[Development and test boundaries]: README.md#development
26[Imports and public boundaries]: README.md#imports
27[Overlay and portal contracts]: README.md#overlay--portal-contract
28[Search and picker selection]: README.md#search-and-picker-selection
29[Tailwind and Figma radius mapping]: README.md#tailwind-css-v4-integration
30[Typed value contracts]: README.md#typed-value-contracts
31[`README.md`]: README.md
32