opensource/dify
2
0
Fork 0
mirror of https://github.com/langgenius/dify.git synced 2026-07-27 23:18:33 +08:00
Code Issues Packages Projects Releases Wiki Activity
58e2bcbba1
dify/packages/dify-ui/AGENTS.md

1.9 KiB
Raw Blame History

@langgenius/dify-ui

This 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.

Component Authoring Rules

  • Build primitives from @base-ui/react, cva, and cn.
  • 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.
  • Keep one primitive per src/<name>/ folder with optional colocated stories and tests.
  • Do not import from web/ or depend on Next.js, i18n, application state, or data-fetching libraries.
  • 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.
  • Export shared public types from the owning component subpath.
  • Prefer Base UI data attributes and CSS variables for visual states; do not mirror primitive state in React solely to add classes.
  • When a Base UI API or selector contract is unclear, read the current official documentation and local @base-ui/react type declarations before coding.

Use the README sections as the detailed owners: