@peerproblem/sw3-ui 0.0.0-stage → 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 (144) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +109 -2
  3. package/agent/components/accordion.md +95 -0
  4. package/agent/components/action-square.md +106 -0
  5. package/agent/components/agent-bridge.md +87 -0
  6. package/agent/components/agent-console.md +123 -0
  7. package/agent/components/alert-dialog.md +82 -0
  8. package/agent/components/app-shell.md +105 -0
  9. package/agent/components/area-chart.md +56 -0
  10. package/agent/components/async-options.md +47 -0
  11. package/agent/components/autocomplete.md +69 -0
  12. package/agent/components/avatar.md +88 -0
  13. package/agent/components/badge.md +51 -0
  14. package/agent/components/bar-chart.md +56 -0
  15. package/agent/components/bar-list.md +49 -0
  16. package/agent/components/breadcrumbs.md +43 -0
  17. package/agent/components/button.md +109 -0
  18. package/agent/components/calendar.md +114 -0
  19. package/agent/components/canvas.md +105 -0
  20. package/agent/components/card.md +78 -0
  21. package/agent/components/carousel.md +113 -0
  22. package/agent/components/chart-card.md +41 -0
  23. package/agent/components/chart-surface.md +56 -0
  24. package/agent/components/checkbox.md +88 -0
  25. package/agent/components/citation-chip.md +61 -0
  26. package/agent/components/collapsible.md +69 -0
  27. package/agent/components/color-picker.md +82 -0
  28. package/agent/components/combobox.md +104 -0
  29. package/agent/components/command.md +92 -0
  30. package/agent/components/dashboard-grid.md +73 -0
  31. package/agent/components/date-input.md +87 -0
  32. package/agent/components/date-picker.md +122 -0
  33. package/agent/components/dialog.md +97 -0
  34. package/agent/components/donut-chart.md +50 -0
  35. package/agent/components/drawer.md +101 -0
  36. package/agent/components/empty-state.md +52 -0
  37. package/agent/components/field.md +80 -0
  38. package/agent/components/file-input.md +84 -0
  39. package/agent/components/hover-card.md +64 -0
  40. package/agent/components/image-cropper.md +77 -0
  41. package/agent/components/input.md +49 -0
  42. package/agent/components/label.md +53 -0
  43. package/agent/components/line-chart.md +60 -0
  44. package/agent/components/listbox.md +84 -0
  45. package/agent/components/map-view.md +104 -0
  46. package/agent/components/menu.md +117 -0
  47. package/agent/components/menubar.md +67 -0
  48. package/agent/components/meter.md +59 -0
  49. package/agent/components/navigation-menu.md +98 -0
  50. package/agent/components/number-input.md +81 -0
  51. package/agent/components/otp-input.md +67 -0
  52. package/agent/components/pagination.md +80 -0
  53. package/agent/components/password-input.md +67 -0
  54. package/agent/components/pill-button.md +116 -0
  55. package/agent/components/popover.md +85 -0
  56. package/agent/components/poster-card.md +61 -0
  57. package/agent/components/preferences.md +92 -0
  58. package/agent/components/progress.md +63 -0
  59. package/agent/components/provider.md +47 -0
  60. package/agent/components/radio.md +91 -0
  61. package/agent/components/rating.md +66 -0
  62. package/agent/components/reorder.md +61 -0
  63. package/agent/components/resizable.md +87 -0
  64. package/agent/components/scatter-chart.md +49 -0
  65. package/agent/components/scroll-area.md +81 -0
  66. package/agent/components/segmented-control.md +56 -0
  67. package/agent/components/select.md +130 -0
  68. package/agent/components/separator.md +60 -0
  69. package/agent/components/shortcuts.md +50 -0
  70. package/agent/components/sidebar-nav.md +68 -0
  71. package/agent/components/skeleton.md +58 -0
  72. package/agent/components/slider.md +79 -0
  73. package/agent/components/sparkline.md +39 -0
  74. package/agent/components/squircle.md +58 -0
  75. package/agent/components/stat.md +58 -0
  76. package/agent/components/switch.md +48 -0
  77. package/agent/components/table.md +58 -0
  78. package/agent/components/tabs.md +108 -0
  79. package/agent/components/textarea.md +68 -0
  80. package/agent/components/time-input.md +84 -0
  81. package/agent/components/timeline.md +91 -0
  82. package/agent/components/toast.md +85 -0
  83. package/agent/components/toggle.md +76 -0
  84. package/agent/components/token-input.md +66 -0
  85. package/agent/components/toolbar.md +76 -0
  86. package/agent/components/tooltip.md +83 -0
  87. package/agent/components/tracker.md +47 -0
  88. package/agent/components/tree.md +87 -0
  89. package/agent/components/treemap.md +72 -0
  90. package/agent/components/trend-chart.md +80 -0
  91. package/agent/components/trigger-menu.md +67 -0
  92. package/agent/components/typography.md +51 -0
  93. package/agent/components/waterfall.md +78 -0
  94. package/agent/components/week-schedule.md +113 -0
  95. package/agent/llms/actions-and-layout.txt +1749 -0
  96. package/agent/llms/agents.txt +505 -0
  97. package/agent/llms/charts.txt +778 -0
  98. package/agent/llms/dashboards.txt +457 -0
  99. package/agent/llms/extend.txt +132 -0
  100. package/agent/llms/extras.txt +527 -0
  101. package/agent/llms/forms.txt +2152 -0
  102. package/agent/llms/foundations.txt +674 -0
  103. package/agent/llms/hooks.txt +178 -0
  104. package/agent/llms/maps.txt +229 -0
  105. package/agent/llms/overlays-and-navigation.txt +1167 -0
  106. package/agent/llms-full.txt +8717 -0
  107. package/agent/llms.txt +145 -0
  108. package/agent/registry.json +11289 -0
  109. package/agent/tokens.md +66 -0
  110. package/dist/agent/index.d.ts +235 -0
  111. package/dist/agent/index.js +21 -0
  112. package/dist/card-Ipm-Cj5f.d.ts +490 -0
  113. package/dist/charts/index.d.ts +289 -0
  114. package/dist/charts/index.js +815 -0
  115. package/dist/check/cli.d.ts +1 -0
  116. package/dist/check/cli.js +48 -0
  117. package/dist/check/rendered.d.ts +11 -0
  118. package/dist/check/rendered.js +77 -0
  119. package/dist/check/source.d.ts +13 -0
  120. package/dist/check/source.js +182 -0
  121. package/dist/chunk-3DXBM65D.js +65 -0
  122. package/dist/chunk-3H5X4ZP6.js +55 -0
  123. package/dist/chunk-6XC4BC5C.js +92 -0
  124. package/dist/chunk-7H6TEAWD.js +507 -0
  125. package/dist/chunk-I63ZTJOI.js +1089 -0
  126. package/dist/chunk-JCIRUM4W.js +33 -0
  127. package/dist/chunk-LTBEHZ3P.js +25 -0
  128. package/dist/chunk-QDPPLO4U.js +60 -0
  129. package/dist/chunk-U2XFBPU4.js +56 -0
  130. package/dist/chunk-UY2WH5AY.js +681 -0
  131. package/dist/extras.d.ts +203 -0
  132. package/dist/extras.js +904 -0
  133. package/dist/icons-BJiGEAnU.d.ts +68 -0
  134. package/dist/index.d.ts +3737 -0
  135. package/dist/index.js +14477 -0
  136. package/dist/map/index.d.ts +115 -0
  137. package/dist/map/index.js +394 -0
  138. package/dist/meta/index.d.ts +3314 -0
  139. package/dist/meta/index.js +5106 -0
  140. package/dist/rules-1RIZ_JZr.d.ts +38 -0
  141. package/dist/styles.css +4037 -0
  142. package/dist/themes/calm.css +42 -0
  143. package/dist/themes/frost.css +40 -0
  144. package/package.json +142 -4
@@ -0,0 +1,68 @@
1
+ import * as react from 'react';
2
+ import { SVGProps } from 'react';
3
+
4
+ /**
5
+ * Variant recipes — one typed declaration per component that drives three things:
6
+ *
7
+ * 1. Props: `tone?: 'night' | 'ink' | 'glass'` is inferred from the recipe.
8
+ * 2. DOM: `recipe.attrs({ tone: 'night' })` → `{ 'data-tone': 'night', ... }`,
9
+ * so styling is pure CSS on `[data-tone='night']` and agents can read state from the page.
10
+ * 3. Registry: `recipe.schema` lists every option and default, so `registry.json` never drifts from code.
11
+ *
12
+ * Designs are swapped by CSS alone: each component reads only `--sw-*` tokens and its own
13
+ * `--sw-<component>-*` variables, and a theme file (e.g. `themes/calm.css`) overrides those
14
+ * variables under `[data-design='calm']`. No component code changes when the design changes.
15
+ */
16
+ type VariantSpec = Record<string, readonly string[]>;
17
+ type VariantProps<R extends {
18
+ schema: {
19
+ variants: VariantSpec;
20
+ };
21
+ }> = {
22
+ [K in keyof R['schema']['variants']]?: R['schema']['variants'][K][number];
23
+ };
24
+ interface Recipe<V extends VariantSpec> {
25
+ schema: {
26
+ /** The `data-sw` value and the prefix of the component's CSS variables (`--sw-<name>-*`). */
27
+ name: string;
28
+ variants: V;
29
+ defaults: {
30
+ [K in keyof V]: V[K][number];
31
+ };
32
+ /** CSS variables a design or an app may override to adjust this component. */
33
+ cssVars: Record<string, string>;
34
+ };
35
+ /** Resolve props (falling back to defaults) into `data-*` attributes. */
36
+ attrs(props: {
37
+ [K in keyof V]?: V[K][number];
38
+ }): Record<string, string>;
39
+ /** Resolve props into concrete values (defaults applied). */
40
+ resolve(props: {
41
+ [K in keyof V]?: V[K][number];
42
+ }): {
43
+ [K in keyof V]: V[K][number];
44
+ };
45
+ }
46
+ declare function defineVariants<const V extends VariantSpec>(config: {
47
+ name: string;
48
+ variants: V;
49
+ defaults: {
50
+ [K in keyof V]: V[K][number];
51
+ };
52
+ cssVars?: Record<string, string>;
53
+ }): Recipe<V>;
54
+
55
+ /**
56
+ * Small stroke icons used by @peerproblem/sw3-ui components.
57
+ * All icons inherit `currentColor` and are `aria-hidden` — always pair them with a text label.
58
+ */
59
+ type IconName = 'plus' | 'minus' | 'close' | 'corner' | 'chevron-right' | 'chevron-up' | 'chevron-down' | 'arrow-up-right' | 'expand' | 'import' | 'note' | 'check' | 'chevron-left' | 'arrow-left' | 'arrow-right' | 'search' | 'calendar' | 'clock' | 'eye' | 'eye-off' | 'star' | 'upload' | 'file' | 'folder' | 'user' | 'settings' | 'copy' | 'trash' | 'more' | 'info' | 'alert' | 'grip' | 'sun' | 'moon' | 'command' | 'dot' | 'sidebar-left' | 'sidebar-right' | 'sort' | 'filter' | 'arrow-up' | 'arrow-down' | 'home' | 'inbox' | 'chart' | 'bell' | 'layers' | 'activity';
60
+ interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'name'> {
61
+ name: IconName;
62
+ /** Stroke width in px at 24px size. Default 1.5. */
63
+ weight?: number;
64
+ }
65
+ declare function Icon({ name, weight, ...props }: IconProps): react.JSX.Element;
66
+
67
+ export { Icon as a, defineVariants as d };
68
+ export type { IconName as I, Recipe as R, VariantProps as V, IconProps as b };