@beehexa/design-rules 2611.3.2 → 2611.4.1

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.
Files changed (68) hide show
  1. package/README.md +1 -1
  2. package/dist/AGENTS.md +1 -7
  3. package/dist/catalog.json +153 -125
  4. package/dist/docs/scripts/color-pairs.mjs +5 -1
  5. package/dist/docs/scripts/token-utils.mjs +16 -1
  6. package/dist/docs/src/components/ColorDemo.astro +5 -5
  7. package/dist/docs/src/components/ElevationDemo.astro +196 -0
  8. package/dist/docs/src/components/LayoutDemo.astro +1 -1
  9. package/dist/docs/src/components/OpacityDemo.astro +95 -0
  10. package/dist/docs/src/components/ShapeDemo.astro +11 -10
  11. package/dist/docs/src/components/ShapePin.astro +5 -3
  12. package/dist/docs/src/components/ZIndexDemo.astro +102 -0
  13. package/dist/docs/src/content/foundations/styles/border.mdx +3 -3
  14. package/dist/docs/src/content/foundations/styles/color/usage.mdx +11 -4
  15. package/dist/docs/src/content/foundations/styles/data-visualization.mdx +74 -6
  16. package/dist/docs/src/content/foundations/styles/elevation.mdx +66 -3
  17. package/dist/docs/src/content/foundations/styles/icons/usage.mdx +9 -6
  18. package/dist/docs/src/content/foundations/styles/layout/app-frame.mdx +10 -0
  19. package/dist/docs/src/content/foundations/styles/opacity.mdx +43 -5
  20. package/dist/docs/src/content/foundations/styles/size-and-density.mdx +7 -0
  21. package/dist/docs/src/content/foundations/styles/typography/code.mdx +1 -1
  22. package/dist/docs/src/content/foundations/styles/z-index.mdx +63 -5
  23. package/dist/docs/src/content/tools/ant-design-vue-theme.mdx +125 -18
  24. package/dist/docs/src/content/tools/application-content.mdx +42 -0
  25. package/dist/docs/src/content/tools/editors.mdx +27 -0
  26. package/dist/docs/src/content/tools/mermaid.mdx +95 -0
  27. package/dist/docs/src/content/tools/vueflow.mdx +121 -0
  28. package/dist/docs/src/content-vi/foundations/styles/border.mdx +3 -3
  29. package/dist/docs/src/content-vi/foundations/styles/color/usage.mdx +11 -4
  30. package/dist/docs/src/content-vi/foundations/styles/data-visualization.mdx +75 -6
  31. package/dist/docs/src/content-vi/foundations/styles/elevation.mdx +75 -0
  32. package/dist/docs/src/content-vi/foundations/styles/icons/usage.mdx +9 -6
  33. package/dist/docs/src/content-vi/foundations/styles/layout/app-frame.mdx +10 -0
  34. package/dist/docs/src/content-vi/foundations/styles/opacity.mdx +43 -5
  35. package/dist/docs/src/content-vi/foundations/styles/size-and-density.mdx +7 -0
  36. package/dist/docs/src/content-vi/foundations/styles/typography/code.mdx +1 -1
  37. package/dist/docs/src/content-vi/foundations/styles/z-index.mdx +63 -5
  38. package/dist/docs/src/lib/token-descriptions-vi.ts +21 -5
  39. package/dist/docs/src/styles/chrome.css +14 -14
  40. package/dist/docs/src/styles/color.css +19 -32
  41. package/dist/docs/src/styles/docs.css +18 -34
  42. package/dist/docs/src/styles/elevation.css +83 -0
  43. package/dist/docs/src/styles/global.css +1 -10
  44. package/dist/docs/src/styles/icons.css +11 -15
  45. package/dist/docs/src/styles/kit.css +112 -0
  46. package/dist/docs/src/styles/layout.css +1 -6
  47. package/dist/docs/src/styles/opacity.css +43 -0
  48. package/dist/docs/src/styles/shapes.css +15 -19
  49. package/dist/docs/src/styles/tokens.css +1282 -3
  50. package/dist/docs/src/styles/tokens.js +358 -3
  51. package/dist/docs/src/styles/typography.css +4 -7
  52. package/dist/docs/src/styles/zindex.css +56 -0
  53. package/dist/docs/tokens/border.json +1 -1
  54. package/dist/docs/tokens/color.json +57 -3
  55. package/dist/docs/tokens/content.json +19 -0
  56. package/dist/docs/tokens/diagram.json +48 -0
  57. package/dist/docs/tokens/editor.json +129 -0
  58. package/dist/docs/tokens/elevation.json +15 -5
  59. package/dist/docs/tokens/flow.json +497 -0
  60. package/dist/docs/tokens/opacity.json +9 -0
  61. package/dist/docs/tokens/resize.json +67 -0
  62. package/dist/docs/tokens/size.json +6 -0
  63. package/dist/docs/tokens/spacing.json +4 -4
  64. package/dist/docs/tokens/typography.json +5 -0
  65. package/dist/docs/tokens/visualization.json +123 -0
  66. package/dist/docs/tokens/z-index.json +49 -0
  67. package/dist/index.js +153 -125
  68. package/package.json +6 -1
package/README.md CHANGED
@@ -50,7 +50,7 @@ Read related usage, code, accessibility, responsive, theme and locale documents
50
50
 
51
51
  There are **no product/dashboard exemptions**. Missing guidance is an upstream source gap, not permission to invent a downstream standard. Pages marked planned remain explicitly planned. The source currently has unfinished areas such as data visualization; the generated agent entrypoint lists every actual planned document and its planned topics from the source. The component catalog and release phases remain incomplete, and not every English page has a Vietnamese translation. A missing release phase is not GA. The website and its structure proposal describe a working design-system proposal, not a declaration that all standards are finalized. External framework/icon APIs remain external dependencies.
52
52
 
53
- The dashboard's 14px root uses the token package's rem*16 pixel CSS only as compatibility debt; it receives no alternate design scale or rule exemption. Improvements or clarifications belong in the beehexa.design source, followed by package generation—not a consumer patch/copy.
53
+ Use native token CSS with a 16px root and the 14px `font.body.default` role on the body. Framework integration belongs to `@beehexa/ant-design-vue-tokens`, `@beehexa/mermaid-tokens` and `@beehexa/vueflow-tokens`, not local consumer adapters. Improvements belong in beehexa.design source followed by package generation, never a consumer patch/copy.
54
54
 
55
55
  ## Producer commands
56
56
 
package/dist/AGENTS.md CHANGED
@@ -11,14 +11,8 @@ Use this installed package, not scraped HTML, a dashboard-owned snapshot, or a w
11
11
  7. There are NO product/dashboard exemptions. Missing source guidance is a gap to report to the source owners, not an exemption. Do not create a downstream token or rule copy. Local unreleased package references are for LOCAL DEVELOPMENT ONLY until managers explicitly authorize release. Consumer CI must use actual released npm versions; it must never check out sibling repositories, build from sibling checkouts or require release/deployment/CI execution for local work. Producer CI is single-repository.
12
12
  8. The pixel CSS entrypoint is rem*16 compatibility for the dashboard's current 14px root; this is migration debt, not an alternate design scale or a root-font exemption. Native rem is the source convention. Token names and TypeScript key typing remain shared.
13
13
 
14
- Source gaps retained verbatim (8 planned documents):
15
- - en/foundations/styles/data-visualization: A chart palette for series, with contrast in light and dark; Status colours in charts; Chart types and when to use each; Axis, legend, tooltip and number formats; Accessible charts: not by colour alone, text alternatives
14
+ Source gaps retained verbatim (2 planned documents):
16
15
  - en/foundations/styles/illustration: When to use a diagram, an illustration or a screenshot; The diagram style from the brand guide: structured, built on the hexagon grid; Empty states and onboarding images
17
- - en/foundations/styles/opacity: Where transparency is allowed: the scrim behind dialogs, image overlays; Why hover, pressed and disabled use colour steps, not opacity; Opacity tokens, if any are needed
18
- - en/foundations/styles/z-index: Layer names and their order; Which layer each overlay uses: dropdown, popover, tooltip, dialog, drawer, toast; How layering pairs with elevation
19
- - vi/foundations/styles/data-visualization: Bảng màu cho các chuỗi dữ liệu, đủ tương phản ở light và dark; Màu trạng thái trong biểu đồ; Các loại biểu đồ và khi nào dùng; Trục, chú giải, tooltip và định dạng số; Biểu đồ dễ tiếp cận: không chỉ dựa vào màu, có phần mô tả bằng chữ
20
16
  - vi/foundations/styles/illustration: Khi nào dùng sơ đồ, hình minh hoạ hay ảnh chụp màn hình; Phong cách sơ đồ theo brand guide: có cấu trúc, dựng trên lưới lục giác; Hình cho trạng thái trống và onboarding
21
- - vi/foundations/styles/opacity: Chỗ được dùng độ trong suốt: lớp phủ sau dialog, lớp phủ trên ảnh; Vì sao hover, pressed và disabled dùng bậc màu, không dùng độ mờ; Token độ mờ, nếu cần
22
- - vi/foundations/styles/z-index: Tên các lớp và thứ tự; Mỗi lớp phủ dùng lớp nào: dropdown, popover, tooltip, dialog, drawer, toast; Lớp và đổ bóng đi cùng nhau thế nào
23
17
 
24
18
  The source website is a working proposal. Component coverage and release phases are incomplete; some docs remain planned. Historical news and the structure proposal are labeled kind=news/reference, not silently promoted into normative usage rules. Referenced external framework/icon APIs and fonts retain their upstream licenses; this package does not vendor npm dependencies or execute MDX.