@a4ui/core 0.1.1 → 0.3.0

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 (56) hide show
  1. package/README.md +23 -0
  2. package/dist/index.js +451 -432
  3. package/dist/layout/AppShell.d.ts +19 -1
  4. package/dist/layout/EffectsToggle.d.ts +19 -1
  5. package/dist/layout/NavGroup.d.ts +15 -0
  6. package/dist/layout/SpaceBackground.d.ts +13 -0
  7. package/dist/layout/ThemeToggle.d.ts +17 -1
  8. package/dist/lib/cn.d.ts +11 -1
  9. package/dist/lib/effects.d.ts +21 -0
  10. package/dist/lib/media.d.ts +12 -0
  11. package/dist/lib/motion.d.ts +37 -0
  12. package/dist/lib/theme.d.ts +52 -3
  13. package/dist/lib/virtual.d.ts +16 -0
  14. package/dist/styles.css +4 -4
  15. package/dist/ui/Accordion.d.ts +19 -0
  16. package/dist/ui/Alert.d.ts +14 -0
  17. package/dist/ui/AlertDialog.d.ts +15 -0
  18. package/dist/ui/Avatar.d.ts +11 -0
  19. package/dist/ui/Badge.d.ts +12 -0
  20. package/dist/ui/Breadcrumb.d.ts +17 -0
  21. package/dist/ui/Button.d.ts +11 -0
  22. package/dist/ui/Card.d.ts +18 -0
  23. package/dist/ui/Checkbox.d.ts +11 -0
  24. package/dist/ui/Combobox.d.ts +16 -0
  25. package/dist/ui/ContextMenu.d.ts +14 -0
  26. package/dist/ui/DateField.d.ts +18 -0
  27. package/dist/ui/Drawer.d.ts +17 -0
  28. package/dist/ui/Dropdown.d.ts +18 -1
  29. package/dist/ui/Dropzone.d.ts +11 -0
  30. package/dist/ui/HoverCard.d.ts +13 -0
  31. package/dist/ui/Input.d.ts +12 -0
  32. package/dist/ui/Meter.d.ts +12 -0
  33. package/dist/ui/Modal.d.ts +22 -0
  34. package/dist/ui/NumberInput.d.ts +12 -0
  35. package/dist/ui/PageHeader.d.ts +17 -0
  36. package/dist/ui/Pagination.d.ts +19 -0
  37. package/dist/ui/Popover.d.ts +13 -0
  38. package/dist/ui/Progress.d.ts +11 -0
  39. package/dist/ui/RadioGroup.d.ts +20 -0
  40. package/dist/ui/SegmentedControl.d.ts +19 -0
  41. package/dist/ui/Select.d.ts +14 -0
  42. package/dist/ui/Separator.d.ts +11 -0
  43. package/dist/ui/Skeleton.d.ts +11 -0
  44. package/dist/ui/Slider.d.ts +14 -0
  45. package/dist/ui/Spinner.d.ts +10 -0
  46. package/dist/ui/Stat.d.ts +12 -0
  47. package/dist/ui/Switch.d.ts +11 -0
  48. package/dist/ui/Table.d.ts +61 -0
  49. package/dist/ui/Tabs.d.ts +20 -0
  50. package/dist/ui/Textarea.d.ts +12 -0
  51. package/dist/ui/Toast.d.ts +12 -0
  52. package/dist/ui/Toggle.d.ts +12 -0
  53. package/dist/ui/ToggleGroup.d.ts +20 -0
  54. package/dist/ui/Tooltip.d.ts +13 -0
  55. package/dist/ui/VirtualList.d.ts +14 -0
  56. package/package.json +4 -3
package/README.md CHANGED
@@ -2,6 +2,10 @@
2
2
 
3
3
  [![npm](https://img.shields.io/npm/v/@a4ui/core.svg)](https://www.npmjs.com/package/@a4ui/core)
4
4
  [![license](https://img.shields.io/npm/l/@a4ui/core.svg)](./LICENSE)
5
+ [![Lighthouse: Performance 100](https://img.shields.io/badge/Lighthouse-Perf_100-success)](https://a4uikit.github.io/a4ui/)
6
+ [![Lighthouse: Accessibility 100](https://img.shields.io/badge/A11y-100-success)](https://a4uikit.github.io/a4ui/)
7
+ [![Lighthouse: Best Practices 100](https://img.shields.io/badge/Best_Practices-100-success)](https://a4uikit.github.io/a4ui/)
8
+ [![Lighthouse: SEO 100](https://img.shields.io/badge/SEO-100-success)](https://a4uikit.github.io/a4ui/)
5
9
 
6
10
  **Spatial Glass** — a design system & component library for **SolidJS**
7
11
  (glassmorphism + starfield backdrop + light/dark themes). Named after the 4
@@ -51,6 +55,25 @@ layout — plus a virtualized list, motion helpers, and a generic `AppShell` wit
51
55
  the animated `SpaceBackground`. Browse them all (with live prop controls and
52
56
  copyable code) in the **[docs site](https://a4uikit.github.io/a4ui/)**.
53
57
 
58
+ ## Using with AI agents
59
+
60
+ Everything an AI coding agent (Claude Code, Codex, Cursor, …) needs to use A4ui
61
+ ships **in the package**, so it works from `node_modules` without visiting the docs:
62
+
63
+ - **Typed API + examples** — every export has JSDoc with an `@example` in the
64
+ shipped `.d.ts` (`node_modules/@a4ui/core/dist/index.d.ts`), so editor
65
+ autocomplete and agents get the props and usage inline.
66
+ - **`llms.txt`** — a machine-readable summary of every component:
67
+ https://a4uikit.github.io/a4ui/llms.txt
68
+
69
+ Drop this into your project's `AGENTS.md` / `CLAUDE.md` to prime your agent:
70
+
71
+ > This project uses **@a4ui/core** (SolidJS design system). Import components as
72
+ > named exports from `@a4ui/core`; import `@a4ui/core/styles.css` once in the app
73
+ > entry; add `@a4ui/core/preset` to `tailwind.config`. Props are typed with
74
+ > JSDoc/`@example` in the package's `.d.ts`. Full component list:
75
+ > https://a4uikit.github.io/a4ui/llms.txt
76
+
54
77
  ## Develop
55
78
 
56
79
  ```bash