@abuzareal/contour-ui 0.1.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 (179) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/LICENSE +21 -0
  3. package/README.md +111 -0
  4. package/RELEASING.md +37 -0
  5. package/SECURITY.md +11 -0
  6. package/dist/components/hero/SceneBoundary.d.ts +14 -0
  7. package/dist/components/hero/SceneBoundary.js +11 -0
  8. package/dist/components/hero/Sculpture.d.ts +4 -0
  9. package/dist/components/hero/Sculpture.js +54 -0
  10. package/dist/components/three/ObjectStudy.d.ts +7 -0
  11. package/dist/components/three/ObjectStudy.js +65 -0
  12. package/dist/components/ui/Alert.d.ts +13 -0
  13. package/dist/components/ui/Alert.js +15 -0
  14. package/dist/components/ui/Avatar.d.ts +7 -0
  15. package/dist/components/ui/Avatar.js +12 -0
  16. package/dist/components/ui/Badge.d.ts +11 -0
  17. package/dist/components/ui/Badge.js +5 -0
  18. package/dist/components/ui/BrandMark.d.ts +7 -0
  19. package/dist/components/ui/BrandMark.js +5 -0
  20. package/dist/components/ui/Breadcrumbs.d.ts +10 -0
  21. package/dist/components/ui/Breadcrumbs.js +8 -0
  22. package/dist/components/ui/Button.d.ts +12 -0
  23. package/dist/components/ui/Button.js +6 -0
  24. package/dist/components/ui/Card.d.ts +13 -0
  25. package/dist/components/ui/Card.js +5 -0
  26. package/dist/components/ui/Checkbox.d.ts +9 -0
  27. package/dist/components/ui/Checkbox.js +14 -0
  28. package/dist/components/ui/CountUp.d.ts +9 -0
  29. package/dist/components/ui/CountUp.js +48 -0
  30. package/dist/components/ui/DataTable.d.ts +16 -0
  31. package/dist/components/ui/DataTable.js +24 -0
  32. package/dist/components/ui/DepthButton.d.ts +6 -0
  33. package/dist/components/ui/DepthButton.js +4 -0
  34. package/dist/components/ui/Dialog.d.ts +12 -0
  35. package/dist/components/ui/Dialog.js +27 -0
  36. package/dist/components/ui/Disclosure.d.ts +11 -0
  37. package/dist/components/ui/Disclosure.js +5 -0
  38. package/dist/components/ui/Divider.d.ts +5 -0
  39. package/dist/components/ui/Divider.js +6 -0
  40. package/dist/components/ui/DropdownMenu.d.ts +14 -0
  41. package/dist/components/ui/DropdownMenu.js +38 -0
  42. package/dist/components/ui/EmptyState.d.ts +9 -0
  43. package/dist/components/ui/EmptyState.js +4 -0
  44. package/dist/components/ui/ExternalLink.d.ts +4 -0
  45. package/dist/components/ui/ExternalLink.js +5 -0
  46. package/dist/components/ui/Field.d.ts +15 -0
  47. package/dist/components/ui/Field.js +6 -0
  48. package/dist/components/ui/FlipCard.d.ts +8 -0
  49. package/dist/components/ui/FlipCard.js +9 -0
  50. package/dist/components/ui/IconButton.d.ts +11 -0
  51. package/dist/components/ui/IconButton.js +5 -0
  52. package/dist/components/ui/Kbd.d.ts +5 -0
  53. package/dist/components/ui/Kbd.js +4 -0
  54. package/dist/components/ui/Magnetic.d.ts +8 -0
  55. package/dist/components/ui/Magnetic.js +19 -0
  56. package/dist/components/ui/Marquee.d.ts +7 -0
  57. package/dist/components/ui/Marquee.js +7 -0
  58. package/dist/components/ui/Pagination.d.ts +7 -0
  59. package/dist/components/ui/Pagination.js +15 -0
  60. package/dist/components/ui/Popover.d.ts +10 -0
  61. package/dist/components/ui/Popover.js +18 -0
  62. package/dist/components/ui/ProgressBar.d.ts +7 -0
  63. package/dist/components/ui/ProgressBar.js +6 -0
  64. package/dist/components/ui/RadioGroup.d.ts +14 -0
  65. package/dist/components/ui/RadioGroup.js +11 -0
  66. package/dist/components/ui/Reveal.d.ts +9 -0
  67. package/dist/components/ui/Reveal.js +24 -0
  68. package/dist/components/ui/RevealHeading.d.ts +12 -0
  69. package/dist/components/ui/RevealHeading.js +4 -0
  70. package/dist/components/ui/ScrollProgress.d.ts +1 -0
  71. package/dist/components/ui/ScrollProgress.js +27 -0
  72. package/dist/components/ui/SectionLabel.d.ts +8 -0
  73. package/dist/components/ui/SectionLabel.js +5 -0
  74. package/dist/components/ui/SegmentedControl.d.ts +10 -0
  75. package/dist/components/ui/SegmentedControl.js +20 -0
  76. package/dist/components/ui/SelectField.d.ts +13 -0
  77. package/dist/components/ui/SelectField.js +10 -0
  78. package/dist/components/ui/Skeleton.d.ts +6 -0
  79. package/dist/components/ui/Skeleton.js +5 -0
  80. package/dist/components/ui/Slider.d.ts +12 -0
  81. package/dist/components/ui/Slider.js +10 -0
  82. package/dist/components/ui/SocialIcons.d.ts +6 -0
  83. package/dist/components/ui/SocialIcons.js +7 -0
  84. package/dist/components/ui/Spinner.d.ts +6 -0
  85. package/dist/components/ui/Spinner.js +8 -0
  86. package/dist/components/ui/Stat.d.ts +8 -0
  87. package/dist/components/ui/Stat.js +4 -0
  88. package/dist/components/ui/Stepper.d.ts +10 -0
  89. package/dist/components/ui/Stepper.js +15 -0
  90. package/dist/components/ui/Switch.d.ts +8 -0
  91. package/dist/components/ui/Switch.js +7 -0
  92. package/dist/components/ui/Tabs.d.ts +13 -0
  93. package/dist/components/ui/Tabs.js +41 -0
  94. package/dist/components/ui/Tag.d.ts +5 -0
  95. package/dist/components/ui/Tag.js +8 -0
  96. package/dist/components/ui/TextArea.d.ts +10 -0
  97. package/dist/components/ui/TextArea.js +23 -0
  98. package/dist/components/ui/TextField.d.ts +12 -0
  99. package/dist/components/ui/TextField.js +13 -0
  100. package/dist/components/ui/ThemeToggle.d.ts +5 -0
  101. package/dist/components/ui/ThemeToggle.js +9 -0
  102. package/dist/components/ui/TiltCard.d.ts +8 -0
  103. package/dist/components/ui/TiltCard.js +23 -0
  104. package/dist/components/ui/Timeline.d.ts +9 -0
  105. package/dist/components/ui/Timeline.js +6 -0
  106. package/dist/components/ui/ToastProvider.d.ts +5 -0
  107. package/dist/components/ui/ToastProvider.js +29 -0
  108. package/dist/components/ui/Tooltip.d.ts +11 -0
  109. package/dist/components/ui/Tooltip.js +16 -0
  110. package/dist/fonts.css +3 -0
  111. package/dist/hooks/useClipboardCopy.d.ts +5 -0
  112. package/dist/hooks/useClipboardCopy.js +21 -0
  113. package/dist/hooks/useDismiss.d.ts +3 -0
  114. package/dist/hooks/useDismiss.js +22 -0
  115. package/dist/hooks/useHeaderScroll.d.ts +7 -0
  116. package/dist/hooks/useHeaderScroll.js +40 -0
  117. package/dist/hooks/useIdleTrigger.d.ts +1 -0
  118. package/dist/hooks/useIdleTrigger.js +19 -0
  119. package/dist/hooks/useInitialHashScroll.d.ts +1 -0
  120. package/dist/hooks/useInitialHashScroll.js +28 -0
  121. package/dist/hooks/useMobileMenu.d.ts +3 -0
  122. package/dist/hooks/useMobileMenu.js +34 -0
  123. package/dist/hooks/useMotionPreference.d.ts +1 -0
  124. package/dist/hooks/useMotionPreference.js +13 -0
  125. package/dist/hooks/usePrintPreparation.d.ts +1 -0
  126. package/dist/hooks/usePrintPreparation.js +29 -0
  127. package/dist/hooks/useScrollSpy.d.ts +1 -0
  128. package/dist/hooks/useScrollSpy.js +36 -0
  129. package/dist/hooks/useSmoothScroll.d.ts +1 -0
  130. package/dist/hooks/useSmoothScroll.js +18 -0
  131. package/dist/hooks/useTheme.d.ts +5 -0
  132. package/dist/hooks/useTheme.js +98 -0
  133. package/dist/hooks/useThreeStage.d.ts +28 -0
  134. package/dist/hooks/useThreeStage.js +155 -0
  135. package/dist/hooks/useToast.d.ts +11 -0
  136. package/dist/hooks/useToast.js +9 -0
  137. package/dist/index.d.ts +129 -0
  138. package/dist/index.js +68 -0
  139. package/dist/kit/actions.css +209 -0
  140. package/dist/kit/data-display.css +496 -0
  141. package/dist/kit/effects.css +144 -0
  142. package/dist/kit/feedback.css +316 -0
  143. package/dist/kit/forms.css +363 -0
  144. package/dist/kit/index.css +9 -0
  145. package/dist/kit/navigation.css +262 -0
  146. package/dist/kit/overlays.css +299 -0
  147. package/dist/lib/a11y.d.ts +3 -0
  148. package/dist/lib/a11y.js +3 -0
  149. package/dist/lib/classNames.d.ts +6 -0
  150. package/dist/lib/classNames.js +4 -0
  151. package/dist/lib/format.d.ts +3 -0
  152. package/dist/lib/format.js +3 -0
  153. package/dist/lib/keyboard.d.ts +8 -0
  154. package/dist/lib/keyboard.js +22 -0
  155. package/dist/lib/motion.d.ts +3 -0
  156. package/dist/lib/motion.js +4 -0
  157. package/dist/lib/safeHref.d.ts +2 -0
  158. package/dist/lib/safeHref.js +14 -0
  159. package/dist/lib/storage.d.ts +10 -0
  160. package/dist/lib/storage.js +25 -0
  161. package/dist/lib/themeBootstrap.d.ts +6 -0
  162. package/dist/lib/themeBootstrap.js +19 -0
  163. package/dist/lib/threeMaterials.d.ts +9 -0
  164. package/dist/lib/threeMaterials.js +62 -0
  165. package/dist/lib/threeStudies.d.ts +16 -0
  166. package/dist/lib/threeStudies.js +39 -0
  167. package/dist/motion.css +59 -0
  168. package/dist/reset.css +180 -0
  169. package/dist/scroll.d.ts +1 -0
  170. package/dist/scroll.js +1 -0
  171. package/dist/styles.css +23 -0
  172. package/dist/theme-toggle.css +38 -0
  173. package/dist/three.d.ts +8 -0
  174. package/dist/three.js +5 -0
  175. package/dist/tokens.css +127 -0
  176. package/dist/types.d.ts +6 -0
  177. package/dist/types.js +1 -0
  178. package/dist/ui.css +178 -0
  179. package/package.json +101 -0
@@ -0,0 +1,144 @@
1
+ /* Kit — effects: count-up, 3D tilt and flip cards, scroll progress, and 3D stage canvases. */
2
+
3
+ .count-up {
4
+ font-variant-numeric: tabular-nums;
5
+ }
6
+
7
+ .tilt-stage,
8
+ .flip-stage {
9
+ perspective: 1000px;
10
+ }
11
+
12
+ .tilt-card {
13
+ position: relative;
14
+ overflow: hidden;
15
+ transform: rotateX(var(--tilt-x, 0deg)) rotateY(var(--tilt-y, 0deg));
16
+ transform-style: preserve-3d;
17
+ transition: transform 500ms var(--ease);
18
+ }
19
+
20
+ .tilt-card:hover {
21
+ transition-duration: 120ms;
22
+ }
23
+
24
+ .tilt-glare {
25
+ position: absolute;
26
+ inset: 0;
27
+ pointer-events: none;
28
+ background: radial-gradient(
29
+ circle at var(--glare-x, 50%) var(--glare-y, 50%),
30
+ #ffffff52,
31
+ transparent 55%
32
+ );
33
+ opacity: 0;
34
+ transition: opacity var(--duration-base);
35
+ }
36
+
37
+ .tilt-card:hover .tilt-glare {
38
+ opacity: 1;
39
+ }
40
+
41
+ .flip-stage {
42
+ display: grid;
43
+ justify-items: start;
44
+ gap: 16px;
45
+ }
46
+
47
+ .flip-card {
48
+ position: relative;
49
+ width: 100%;
50
+ aspect-ratio: 1.6;
51
+ transform-style: preserve-3d;
52
+ transition: transform 900ms var(--ease);
53
+ }
54
+
55
+ .flip-card.is-flipped {
56
+ transform: rotateY(180deg);
57
+ }
58
+
59
+ .flip-face {
60
+ position: absolute;
61
+ inset: 0;
62
+ backface-visibility: hidden;
63
+ }
64
+
65
+ .flip-back {
66
+ transform: rotateY(180deg);
67
+ }
68
+
69
+ .flip-toggle {
70
+ display: inline-flex;
71
+ align-items: center;
72
+ gap: 8px;
73
+ padding-block: 6px;
74
+ border-bottom: 1px solid currentColor;
75
+ text-transform: uppercase;
76
+ }
77
+
78
+ .scroll-progress {
79
+ position: fixed;
80
+ top: 0;
81
+ left: 0;
82
+ right: 0;
83
+ z-index: 60;
84
+ height: 2px;
85
+ background: var(--acid);
86
+ transform: scaleX(var(--scroll-progress, 0));
87
+ transform-origin: left;
88
+ }
89
+
90
+ .stage-canvas {
91
+ position: relative;
92
+ width: 100%;
93
+ height: 100%;
94
+ }
95
+
96
+ .stage-canvas canvas {
97
+ width: 100%;
98
+ height: 100%;
99
+ transition: opacity 600ms ease;
100
+ }
101
+
102
+ .stage-canvas:not([data-state="ready"]) canvas {
103
+ opacity: 0;
104
+ }
105
+
106
+ /* Depth button: the face sits on an ink base and travels down when pressed. */
107
+ .depth-button {
108
+ display: inline-block;
109
+ padding: 0 0 8px;
110
+ border-radius: var(--radius-pill);
111
+ background: var(--ink);
112
+ }
113
+
114
+ :root[data-theme="dark"] .depth-button {
115
+ background: #5a7210;
116
+ }
117
+
118
+ .depth-button-face {
119
+ display: inline-flex;
120
+ align-items: center;
121
+ gap: 10px;
122
+ height: 52px;
123
+ padding-inline: 28px;
124
+ border: 1px solid var(--ink);
125
+ border-radius: var(--radius-pill);
126
+ background: var(--acid);
127
+ color: var(--ink);
128
+ font-size: 14px;
129
+ font-weight: 500;
130
+ transform: translateY(-2px);
131
+ transition: transform 140ms var(--ease);
132
+ }
133
+
134
+ .depth-button:hover .depth-button-face {
135
+ transform: translateY(-5px);
136
+ }
137
+
138
+ .depth-button:active .depth-button-face {
139
+ transform: translateY(6px);
140
+ }
141
+
142
+ .depth-button:focus-visible {
143
+ outline-offset: 4px;
144
+ }
@@ -0,0 +1,316 @@
1
+ /* Kit — feedback: alerts, toasts, progress, spinner, and skeletons. */
2
+
3
+ .alert {
4
+ --alert-accent: var(--fg);
5
+ --alert-bg: var(--surface);
6
+ display: flex;
7
+ align-items: flex-start;
8
+ gap: 14px;
9
+ padding: 18px 20px;
10
+ border-left: 3px solid var(--alert-accent);
11
+ background: var(--alert-bg);
12
+ }
13
+
14
+ .alert-accent {
15
+ --alert-accent: var(--olive);
16
+ --alert-bg: color-mix(in srgb, var(--acid) 22%, var(--surface));
17
+ }
18
+
19
+ .alert-success {
20
+ --alert-accent: var(--success);
21
+ --alert-bg: var(--success-soft);
22
+ }
23
+
24
+ .alert-info {
25
+ --alert-accent: var(--info);
26
+ --alert-bg: var(--info-soft);
27
+ }
28
+
29
+ .alert-warning {
30
+ --alert-accent: var(--warning);
31
+ --alert-bg: var(--warning-soft);
32
+ }
33
+
34
+ .alert-danger {
35
+ --alert-accent: var(--danger);
36
+ --alert-bg: var(--danger-soft);
37
+ }
38
+
39
+ .alert-icon {
40
+ display: inline-flex;
41
+ margin-top: 1px;
42
+ color: var(--alert-accent);
43
+ }
44
+
45
+ .alert-content {
46
+ display: grid;
47
+ flex: 1;
48
+ gap: 4px;
49
+ min-width: 0;
50
+ }
51
+
52
+ .alert-title {
53
+ font-size: 14px;
54
+ font-weight: 600;
55
+ }
56
+
57
+ .alert-body {
58
+ font-size: 14px;
59
+ line-height: 1.6;
60
+ color: color-mix(in srgb, var(--fg) 80%, transparent);
61
+ }
62
+
63
+ .alert-action {
64
+ flex-shrink: 0;
65
+ align-self: center;
66
+ }
67
+
68
+ .alert-dismiss {
69
+ display: grid;
70
+ place-items: center;
71
+ flex-shrink: 0;
72
+ width: 28px;
73
+ height: 28px;
74
+ margin: -4px -6px 0 0;
75
+ border-radius: 50%;
76
+ color: var(--muted);
77
+ transition:
78
+ background var(--duration-fast),
79
+ color var(--duration-fast);
80
+ }
81
+
82
+ .alert-dismiss:hover {
83
+ background: var(--acid);
84
+ color: var(--ink);
85
+ }
86
+
87
+ /* Banner: one-line announcement strip on the inverted surface. */
88
+ .alert-banner {
89
+ --alert-accent: var(--acid);
90
+ --alert-bg: var(--invert-bg);
91
+ align-items: center;
92
+ border-left: 0;
93
+ color: var(--invert-fg);
94
+ }
95
+
96
+ .alert-banner .alert-content {
97
+ display: flex;
98
+ flex-wrap: wrap;
99
+ align-items: baseline;
100
+ gap: 4px 12px;
101
+ }
102
+
103
+ .alert-banner .alert-body,
104
+ .alert-banner .alert-dismiss {
105
+ color: color-mix(in srgb, var(--invert-fg) 72%, transparent);
106
+ }
107
+
108
+ :root[data-theme="dark"] .alert-banner {
109
+ --alert-accent: #5a7210;
110
+ }
111
+
112
+ .toast-viewport {
113
+ position: fixed;
114
+ right: 24px;
115
+ bottom: 24px;
116
+ z-index: 80;
117
+ display: grid;
118
+ gap: 10px;
119
+ width: min(380px, calc(100vw - 32px));
120
+ }
121
+
122
+ .toast {
123
+ display: flex;
124
+ align-items: flex-start;
125
+ gap: 14px;
126
+ padding: 16px 16px 16px 0;
127
+ overflow: hidden;
128
+ background: var(--ink);
129
+ color: var(--paper);
130
+ box-shadow: var(--shadow-floating);
131
+ animation: toast-in var(--duration-slow) var(--ease) both;
132
+ }
133
+
134
+ :root[data-theme="dark"] .toast {
135
+ border: 1px solid #353733;
136
+ }
137
+
138
+ .toast-bar {
139
+ align-self: stretch;
140
+ width: 3px;
141
+ margin-block: -16px;
142
+ background: var(--acid);
143
+ }
144
+
145
+ .toast-success .toast-bar {
146
+ background: #b5d33f;
147
+ }
148
+
149
+ .toast-info .toast-bar {
150
+ background: #8fc0d6;
151
+ }
152
+
153
+ .toast-warning .toast-bar {
154
+ background: #f0c063;
155
+ }
156
+
157
+ .toast-danger .toast-bar {
158
+ background: #ff8a70;
159
+ }
160
+
161
+ .toast-content {
162
+ display: grid;
163
+ flex: 1;
164
+ gap: 4px;
165
+ }
166
+
167
+ .toast-content strong {
168
+ font-size: 14px;
169
+ font-weight: 600;
170
+ }
171
+
172
+ .toast-content p {
173
+ font-size: 13px;
174
+ line-height: 1.55;
175
+ color: #c0c5b8;
176
+ }
177
+
178
+ .toast-close {
179
+ display: grid;
180
+ place-items: center;
181
+ width: 28px;
182
+ height: 28px;
183
+ margin-top: -4px;
184
+ border-radius: 50%;
185
+ color: #c0c5b8;
186
+ }
187
+
188
+ .toast-close:hover {
189
+ background: var(--acid);
190
+ color: var(--ink);
191
+ }
192
+
193
+ @keyframes toast-in {
194
+ from {
195
+ opacity: 0;
196
+ transform: translateY(16px) scale(0.98);
197
+ }
198
+ }
199
+
200
+ .progress {
201
+ display: grid;
202
+ gap: 10px;
203
+ }
204
+
205
+ .progress-header {
206
+ display: flex;
207
+ justify-content: space-between;
208
+ color: var(--muted);
209
+ text-transform: uppercase;
210
+ }
211
+
212
+ .progress-track {
213
+ position: relative;
214
+ height: 2px;
215
+ overflow: hidden;
216
+ background: var(--line);
217
+ }
218
+
219
+ .progress-fill {
220
+ position: absolute;
221
+ inset: 0 auto 0 0;
222
+ width: var(--progress);
223
+ background: var(--fg);
224
+ transition: width var(--duration-slow) var(--ease);
225
+ }
226
+
227
+ .progress-accent .progress-fill {
228
+ background: var(--olive);
229
+ }
230
+
231
+ .progress-success .progress-fill {
232
+ background: var(--success);
233
+ }
234
+
235
+ .progress-danger .progress-fill {
236
+ background: var(--danger);
237
+ }
238
+
239
+ .progress-indeterminate .progress-fill {
240
+ width: 35%;
241
+ animation: progress-sweep 1.3s var(--ease) infinite;
242
+ }
243
+
244
+ @keyframes progress-sweep {
245
+ from {
246
+ transform: translateX(-100%);
247
+ }
248
+ to {
249
+ transform: translateX(300%);
250
+ }
251
+ }
252
+
253
+ .spinner {
254
+ display: inline-grid;
255
+ place-items: center;
256
+ color: var(--olive);
257
+ }
258
+
259
+ .spinner svg {
260
+ animation: spin 1.1s linear infinite;
261
+ }
262
+
263
+ .button .spinner {
264
+ color: inherit;
265
+ }
266
+
267
+ @keyframes spin {
268
+ to {
269
+ transform: rotate(360deg);
270
+ }
271
+ }
272
+
273
+ .skeleton {
274
+ display: block;
275
+ background: linear-gradient(
276
+ 100deg,
277
+ transparent 30%,
278
+ color-mix(in srgb, var(--bg) 70%, transparent) 50%,
279
+ transparent 70%
280
+ )
281
+ var(--surface-sunken);
282
+ background-size: 220% 100%;
283
+ animation: shimmer 1.6s linear infinite;
284
+ }
285
+
286
+ .skeleton-line {
287
+ width: 100%;
288
+ height: 12px;
289
+ }
290
+
291
+ .skeleton-block {
292
+ width: 100%;
293
+ height: 120px;
294
+ }
295
+
296
+ .skeleton-circle {
297
+ width: 44px;
298
+ height: 44px;
299
+ border-radius: 50%;
300
+ }
301
+
302
+ @keyframes shimmer {
303
+ from {
304
+ background-position: 120% 0;
305
+ }
306
+ to {
307
+ background-position: -120% 0;
308
+ }
309
+ }
310
+
311
+ @media (max-width: 767px) {
312
+ .toast-viewport {
313
+ right: 16px;
314
+ bottom: 16px;
315
+ }
316
+ }