@kolkrabbi/kol-component 0.2.0 → 0.4.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 (77) hide show
  1. package/package.json +11 -3
  2. package/src/atoms/AnimatedTitle.jsx +108 -0
  3. package/src/atoms/AssetGrid.jsx +29 -0
  4. package/src/atoms/Button.jsx +17 -6
  5. package/src/atoms/CurveOverlay.jsx +180 -0
  6. package/src/atoms/DocsToc.jsx +48 -0
  7. package/src/atoms/EmptyState.jsx +22 -0
  8. package/src/atoms/Figure.jsx +27 -0
  9. package/src/atoms/HlsVideo.jsx +56 -0
  10. package/src/atoms/OverlayGlassPanel.jsx +40 -0
  11. package/src/atoms/PriceDisplay.jsx +34 -0
  12. package/src/atoms/ProsePreview.jsx +53 -0
  13. package/src/atoms/QuantityInput.jsx +76 -114
  14. package/src/atoms/RotaryDial.jsx +150 -0
  15. package/src/atoms/SearchInput.jsx +108 -0
  16. package/src/atoms/TextPressure.jsx +331 -0
  17. package/src/atoms/TiltCard.jsx +127 -0
  18. package/src/atoms/TypeSample.jsx +50 -0
  19. package/src/atoms/TypeSpecCard.jsx +42 -0
  20. package/src/hooks/cssVar.js +53 -0
  21. package/src/hooks/useAxisAnimation.js +91 -0
  22. package/src/hooks/usePrefersReducedMotion.js +21 -0
  23. package/src/hooks/useTilt.js +49 -0
  24. package/src/index.js +66 -2
  25. package/src/molecules/AlignmentGrid.jsx +53 -0
  26. package/src/molecules/ArticleCard.jsx +178 -0
  27. package/src/molecules/CardFeatureItem.jsx +130 -0
  28. package/src/molecules/ColorInputRow.jsx +179 -0
  29. package/src/molecules/ColorRamp.jsx +114 -0
  30. package/src/molecules/FramedMediaBand.jsx +56 -0
  31. package/src/molecules/ImageBlock.jsx +34 -0
  32. package/src/molecules/MenuPopover.jsx +4 -27
  33. package/src/molecules/SelectionOverlay.jsx +108 -0
  34. package/src/molecules/ShapeDropdown.jsx +92 -0
  35. package/src/molecules/ShellDrawer.jsx +169 -0
  36. package/src/molecules/ShellSearchOverlay.jsx +177 -0
  37. package/src/molecules/SpecList.jsx +30 -0
  38. package/src/molecules/SpectrumControls.jsx +504 -0
  39. package/src/molecules/SwatchControls.jsx +217 -0
  40. package/src/molecules/TabsRow.jsx +87 -0
  41. package/src/molecules/VideoBlock.jsx +86 -0
  42. package/src/molecules/WorkListItem.jsx +83 -0
  43. package/src/molecules/foundry/SpecimenSectionHeader.jsx +89 -0
  44. package/src/organisms/ArticleHeader.jsx +95 -0
  45. package/src/organisms/AsciiCursor.jsx +526 -0
  46. package/src/organisms/BentoCard.jsx +187 -0
  47. package/src/organisms/Canvas.jsx +299 -0
  48. package/src/organisms/ColorLoader.jsx +155 -0
  49. package/src/organisms/CtaGlobal.jsx +67 -0
  50. package/src/organisms/DiagonalMarqueeRiver.jsx +138 -0
  51. package/src/organisms/EditorShell.jsx +111 -0
  52. package/src/organisms/ErrorBoundary.jsx +70 -0
  53. package/src/organisms/FeatureSplit.jsx +82 -0
  54. package/src/organisms/FeaturedCarousel.jsx +258 -0
  55. package/src/organisms/FeaturesCardSection.jsx +90 -0
  56. package/src/organisms/FullBleedHero.jsx +111 -0
  57. package/src/organisms/GalleryCarousel.jsx +83 -0
  58. package/src/organisms/LoaderOverlay.jsx +30 -0
  59. package/src/organisms/MediaViewer.jsx +95 -0
  60. package/src/organisms/NewsletterBand.jsx +122 -0
  61. package/src/organisms/ParallaxShelf.jsx +141 -0
  62. package/src/organisms/PortableTextRenderer.jsx +115 -0
  63. package/src/organisms/ProductDetailLayout.jsx +189 -0
  64. package/src/organisms/ScrollDriftGallery.jsx +214 -0
  65. package/src/organisms/SpectrumGrid.jsx +90 -0
  66. package/src/organisms/StackHero.jsx +83 -0
  67. package/src/organisms/WorkCard.jsx +120 -0
  68. package/src/organisms/WorkViewToggle.jsx +170 -0
  69. package/src/organisms/foundry/FontPreviewSection.jsx +187 -0
  70. package/src/organisms/foundry/FoundryCharacterSets.jsx +113 -0
  71. package/src/organisms/foundry/GlyphMetricsGrid.jsx +335 -0
  72. package/src/organisms/foundry/TypefaceHero.jsx +107 -0
  73. package/src/organisms/foundry/TypefaceStyleSection.jsx +163 -0
  74. package/src/organisms/foundry/VariableFontSection.jsx +158 -0
  75. package/src/organisms/foundry/glyphData.js +30 -0
  76. package/src/organisms/foundry/index.js +21 -0
  77. package/src/atoms/QuantityStepper.jsx +0 -149
@@ -0,0 +1,331 @@
1
+ import { useEffect, useRef, useState } from 'react'
2
+ import usePrefersReducedMotion from '../hooks/usePrefersReducedMotion.js'
3
+
4
+ // Variable-font axis rest values — where every glyph sits with no pointer near.
5
+ const DEFAULTS = { wdth: 100, wght: 400, ital: 0, alpha: 1 }
6
+ const STATIC_VARIATION = "'wght' 400, 'wdth' 100, 'ital' 0.00"
7
+
8
+ /**
9
+ * TextPressure — a single line of variable-font text whose glyphs deform
10
+ * toward the pointer: characters nearest the cursor grow widest / heaviest /
11
+ * most italic, and the effect falls off linearly with distance. A
12
+ * requestAnimationFrame loop lerps a smoothed follower toward the raw cursor
13
+ * (container-scoped listeners) and writes per-glyph `font-variation-settings`
14
+ * each frame. On mouse-leave the glyphs coast back to their rest axis values
15
+ * (`returnToDefault`) or freeze in place, then the loop auto-stops until the
16
+ * pointer returns. Ported from the react-bits / JuanFuentes effect, collapsed
17
+ * from three source variants into one.
18
+ *
19
+ * ── Font contract ──────────────────────────────────────────────────────────
20
+ * The effect only *moves* if the resolved font is a VARIABLE font exposing the
21
+ * `wght` / `wdth` / `ital` axes. The KOL variable font is a CONSUMER asset —
22
+ * the design system does not ship one. Two ways to supply it:
23
+ * • `fontUrl` given → an `@font-face` is injected at runtime for `fontFamily`
24
+ * (e.g. fontFamily="TG Root-Tune" fontUrl="/fonts/TGRoot-TuneVF.ttf").
25
+ * • `fontUrl` omitted → the already-loaded `fontFamily` is used as-is; the
26
+ * default `var(--kol-font-family-sans)` animates only if that theme font is
27
+ * itself variable — otherwise the text renders correctly but static.
28
+ *
29
+ * Reduced motion → no listeners, no rAF; glyphs render static at the rest axis
30
+ * values (wght 400 / wdth 100 / ital 0). Casing is authored by the caller —
31
+ * this component never text-transforms.
32
+ *
33
+ * @param {string} text the line; split into one <span> per character
34
+ * @param {string} fontFamily applied family + injected @font-face family
35
+ * @param {string} [fontUrl] variable-font URL → injects @font-face when set
36
+ * @param {boolean} width animate the `wdth` axis (5–150)
37
+ * @param {boolean} weight animate the `wght` axis (100–900)
38
+ * @param {boolean} italic animate the `ital` axis (0–1)
39
+ * @param {boolean} alpha animate per-glyph opacity (0–1)
40
+ * @param {boolean} flex distribute glyphs with justify-between
41
+ * @param {boolean} stroke add an outlined ghost layer behind each glyph
42
+ * @param {boolean} scale vertically scale the line to fill the container
43
+ * @param {string} textColor glyph color (KOL token / CSS color)
44
+ * @param {string} strokeColor stroke color when `stroke` is on
45
+ * @param {string} className extra classes on the <h1>
46
+ * @param {number} minFontSize floor for the responsive font size
47
+ * @param {number} [maxFontSize] cap for the responsive font size
48
+ * @param {boolean} returnToDefault true: coast back to rest on leave; false: freeze
49
+ */
50
+ export default function TextPressure({
51
+ text = 'Compressa',
52
+ fontFamily = 'var(--kol-font-family-sans)',
53
+ fontUrl,
54
+
55
+ width = true,
56
+ weight = true,
57
+ italic = true,
58
+ alpha = false,
59
+
60
+ flex = true,
61
+ stroke = false,
62
+ scale = false,
63
+
64
+ textColor = 'var(--kol-fg-emphasis)',
65
+ strokeColor = 'var(--kol-accent-primary)',
66
+ className = '',
67
+
68
+ minFontSize = 24,
69
+ maxFontSize = null,
70
+ returnToDefault = true,
71
+ }) {
72
+ const containerRef = useRef(null)
73
+ const titleRef = useRef(null)
74
+ const spansRef = useRef([])
75
+
76
+ const mouseRef = useRef({ x: 0, y: 0 })
77
+ const cursorRef = useRef({ x: 0, y: 0 })
78
+ const currentValuesRef = useRef([])
79
+ const velocityRef = useRef([])
80
+
81
+ const [fontSize, setFontSize] = useState(minFontSize)
82
+ const [scaleY, setScaleY] = useState(1)
83
+ const [lineHeight, setLineHeight] = useState(1)
84
+ const [isHovering, setIsHovering] = useState(false)
85
+
86
+ const reducedMotion = usePrefersReducedMotion()
87
+ const chars = text.split('')
88
+
89
+ const dist = (a, b) => {
90
+ const dx = b.x - a.x
91
+ const dy = b.y - a.y
92
+ return Math.sqrt(dx * dx + dy * dy)
93
+ }
94
+
95
+ // Container-scoped pointer tracking (never window). Skipped for reduced motion.
96
+ useEffect(() => {
97
+ if (reducedMotion) return undefined
98
+ const container = containerRef.current
99
+ if (!container) return undefined
100
+
101
+ const handleMouseMove = (e) => {
102
+ cursorRef.current.x = e.clientX
103
+ cursorRef.current.y = e.clientY
104
+ }
105
+ const handleTouchMove = (e) => {
106
+ const t = e.touches[0]
107
+ cursorRef.current.x = t.clientX
108
+ cursorRef.current.y = t.clientY
109
+ }
110
+ const handleMouseEnter = () => setIsHovering(true)
111
+ const handleMouseLeave = () => setIsHovering(false)
112
+
113
+ container.addEventListener('mousemove', handleMouseMove)
114
+ container.addEventListener('touchmove', handleTouchMove, { passive: false })
115
+ container.addEventListener('mouseenter', handleMouseEnter)
116
+ container.addEventListener('mouseleave', handleMouseLeave)
117
+
118
+ const { left, top, width: w, height: h } = container.getBoundingClientRect()
119
+ mouseRef.current.x = left + w / 2
120
+ mouseRef.current.y = top + h / 2
121
+ cursorRef.current.x = mouseRef.current.x
122
+ cursorRef.current.y = mouseRef.current.y
123
+
124
+ return () => {
125
+ container.removeEventListener('mousemove', handleMouseMove)
126
+ container.removeEventListener('touchmove', handleTouchMove)
127
+ container.removeEventListener('mouseenter', handleMouseEnter)
128
+ container.removeEventListener('mouseleave', handleMouseLeave)
129
+ }
130
+ }, [reducedMotion])
131
+
132
+ // Responsive sizing (layout, not motion — runs regardless of reduced motion).
133
+ useEffect(() => {
134
+ const setSize = () => {
135
+ if (!containerRef.current || !titleRef.current) return
136
+ const { width: containerW, height: containerH } = containerRef.current.getBoundingClientRect()
137
+
138
+ let newFontSize = containerW / (chars.length / 2)
139
+ newFontSize = Math.max(newFontSize, minFontSize)
140
+ if (maxFontSize) newFontSize = Math.min(newFontSize, maxFontSize)
141
+
142
+ setFontSize(newFontSize)
143
+ setScaleY(1)
144
+ setLineHeight(1)
145
+
146
+ requestAnimationFrame(() => {
147
+ if (!titleRef.current) return
148
+ const textRect = titleRef.current.getBoundingClientRect()
149
+ if (scale && textRect.height > 0) {
150
+ const yRatio = containerH / textRect.height
151
+ setScaleY(yRatio)
152
+ setLineHeight(yRatio)
153
+ }
154
+ })
155
+ }
156
+
157
+ setSize()
158
+ window.addEventListener('resize', setSize)
159
+ return () => window.removeEventListener('resize', setSize)
160
+ // eslint-disable-next-line react-hooks/exhaustive-deps
161
+ }, [scale, text, minFontSize, maxFontSize])
162
+
163
+ // The pressure loop. Skipped entirely for reduced motion (glyphs stay static).
164
+ useEffect(() => {
165
+ if (reducedMotion) return undefined
166
+ let rafId
167
+
168
+ const animate = () => {
169
+ if (isHovering) {
170
+ mouseRef.current.x += (cursorRef.current.x - mouseRef.current.x) / 15
171
+ mouseRef.current.y += (cursorRef.current.y - mouseRef.current.y) / 15
172
+
173
+ if (titleRef.current && containerRef.current) {
174
+ const containerRect = containerRef.current.getBoundingClientRect()
175
+ const maxDist = containerRect.width / 2
176
+
177
+ spansRef.current.forEach((span, i) => {
178
+ if (!span) return
179
+ const rect = span.getBoundingClientRect()
180
+ const charCenter = { x: rect.x + rect.width / 2, y: rect.y + rect.height / 2 }
181
+ const d = dist(mouseRef.current, charCenter)
182
+
183
+ const getAttr = (distance, minVal, maxVal) => {
184
+ const val = maxVal - Math.abs((maxVal * distance) / maxDist)
185
+ return Math.max(minVal, val + minVal)
186
+ }
187
+
188
+ const wdth = width ? Math.floor(getAttr(d, 5, 150)) : 100
189
+ const wght = weight ? Math.floor(getAttr(d, 100, 900)) : 400
190
+ const italVal = italic ? getAttr(d, 0, 1) : 0
191
+ const alphaVal = alpha ? getAttr(d, 0, 1) : 1
192
+
193
+ const prev = currentValuesRef.current[i]
194
+ if (prev && !returnToDefault) {
195
+ velocityRef.current[i] = {
196
+ wdth: wdth - prev.wdth,
197
+ wght: wght - prev.wght,
198
+ ital: italVal - prev.ital,
199
+ alpha: alphaVal - prev.alpha,
200
+ }
201
+ }
202
+ currentValuesRef.current[i] = { wdth, wght, ital: italVal, alpha: alphaVal }
203
+
204
+ span.style.opacity = alphaVal
205
+ span.style.fontVariationSettings = `'wght' ${wght}, 'wdth' ${wdth}, 'ital' ${italVal.toFixed(2)}`
206
+ })
207
+ }
208
+ } else {
209
+ // Coast back to rest (returnToDefault) or settle into a frozen pose.
210
+ let allSettled = true
211
+
212
+ spansRef.current.forEach((span, i) => {
213
+ if (!span) return
214
+ const current = currentValuesRef.current[i] || { ...DEFAULTS }
215
+ if (!velocityRef.current[i]) velocityRef.current[i] = { wdth: 0, wght: 0, ital: 0, alpha: 0 }
216
+ const velocity = velocityRef.current[i]
217
+
218
+ if (returnToDefault) {
219
+ const springStrength = 0.05
220
+ const damping = 0.88
221
+ velocity.wdth += (DEFAULTS.wdth - current.wdth) * springStrength
222
+ velocity.wght += (DEFAULTS.wght - current.wght) * springStrength
223
+ velocity.ital += (DEFAULTS.ital - current.ital) * springStrength
224
+ velocity.alpha += (DEFAULTS.alpha - current.alpha) * springStrength
225
+ velocity.wdth *= damping
226
+ velocity.wght *= damping
227
+ velocity.ital *= damping
228
+ velocity.alpha *= damping
229
+
230
+ const newWdth = current.wdth + velocity.wdth
231
+ const newWght = current.wght + velocity.wght
232
+ const newItal = current.ital + velocity.ital
233
+ const newAlpha = current.alpha + velocity.alpha
234
+
235
+ if (
236
+ Math.abs(newWdth - DEFAULTS.wdth) > 0.5 ||
237
+ Math.abs(newWght - DEFAULTS.wght) > 0.5 ||
238
+ Math.abs(velocity.wdth) > 0.1 ||
239
+ Math.abs(velocity.wght) > 0.1
240
+ ) {
241
+ allSettled = false
242
+ }
243
+
244
+ currentValuesRef.current[i] = { wdth: newWdth, wght: newWght, ital: newItal, alpha: newAlpha }
245
+ span.style.opacity = newAlpha
246
+ span.style.fontVariationSettings = `'wght' ${Math.round(newWght)}, 'wdth' ${Math.round(newWdth)}, 'ital' ${newItal.toFixed(2)}`
247
+ } else {
248
+ const damping = 0.75
249
+ velocity.wdth *= damping
250
+ velocity.wght *= damping
251
+ velocity.ital *= damping
252
+ velocity.alpha *= damping
253
+
254
+ const newWdth = current.wdth + velocity.wdth
255
+ const newWght = current.wght + velocity.wght
256
+ const newItal = current.ital + velocity.ital
257
+ const newAlpha = current.alpha + velocity.alpha
258
+
259
+ if (
260
+ Math.abs(velocity.wdth) > 0.01 ||
261
+ Math.abs(velocity.wght) > 0.01 ||
262
+ Math.abs(velocity.ital) > 0.0001 ||
263
+ Math.abs(velocity.alpha) > 0.0001
264
+ ) {
265
+ allSettled = false
266
+ }
267
+
268
+ currentValuesRef.current[i] = { wdth: newWdth, wght: newWght, ital: newItal, alpha: newAlpha }
269
+ span.style.opacity = newAlpha
270
+ span.style.fontVariationSettings = `'wght' ${Math.round(newWght)}, 'wdth' ${Math.round(newWdth)}, 'ital' ${newItal.toFixed(2)}`
271
+ }
272
+ })
273
+
274
+ if (allSettled) {
275
+ cancelAnimationFrame(rafId)
276
+ return
277
+ }
278
+ }
279
+
280
+ rafId = requestAnimationFrame(animate)
281
+ }
282
+
283
+ animate()
284
+ return () => cancelAnimationFrame(rafId)
285
+ }, [width, weight, italic, alpha, chars.length, isHovering, returnToDefault, reducedMotion])
286
+
287
+ const titleClass = [
288
+ 'kol-text-pressure-title m-0 w-full max-w-full overflow-hidden box-border text-center whitespace-nowrap select-none origin-top font-thin',
289
+ flex ? 'flex justify-between' : '',
290
+ stroke ? 'kol-text-pressure--stroke' : '',
291
+ className,
292
+ ]
293
+ .filter(Boolean)
294
+ .join(' ')
295
+
296
+ return (
297
+ <div
298
+ ref={containerRef}
299
+ className="kol-text-pressure relative flex h-full w-full max-w-full items-center justify-center overflow-hidden"
300
+ >
301
+ {fontUrl && (
302
+ <style>{`@font-face { font-family: '${fontFamily}'; src: url('${fontUrl}'); font-style: normal; }`}</style>
303
+ )}
304
+
305
+ <h1
306
+ ref={titleRef}
307
+ className={titleClass}
308
+ style={{
309
+ fontFamily,
310
+ fontSize,
311
+ lineHeight,
312
+ transform: `scale(1, ${scaleY})`,
313
+ color: textColor,
314
+ '--kol-text-pressure-stroke': strokeColor,
315
+ }}
316
+ >
317
+ {chars.map((char, i) => (
318
+ <span
319
+ key={i}
320
+ ref={(el) => (spansRef.current[i] = el)}
321
+ data-char={char}
322
+ className="kol-text-pressure-char inline-block"
323
+ style={{ fontVariationSettings: STATIC_VARIATION }}
324
+ >
325
+ {char}
326
+ </span>
327
+ ))}
328
+ </h1>
329
+ </div>
330
+ )
331
+ }
@@ -0,0 +1,127 @@
1
+ import { useEffect, useState } from 'react'
2
+ import { motion, useSpring, useTransform } from 'framer-motion'
3
+ import useTilt from '../hooks/useTilt.js'
4
+ import usePrefersReducedMotion from '../hooks/usePrefersReducedMotion.js'
5
+
6
+ /**
7
+ * True on coarse-pointer (touch) devices. Local to TiltCard; re-evaluates on
8
+ * device/orientation change via the media-query change event (the monorepo
9
+ * source froze this in a module-load const — fixed on recreate).
10
+ */
11
+ function useCoarsePointer() {
12
+ const [coarse, setCoarse] = useState(
13
+ () => typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches,
14
+ )
15
+
16
+ useEffect(() => {
17
+ const mq = window.matchMedia('(pointer: coarse)')
18
+ const onChange = () => setCoarse(mq.matches)
19
+ mq.addEventListener('change', onChange)
20
+ return () => mq.removeEventListener('change', onChange)
21
+ }, [])
22
+
23
+ return coarse
24
+ }
25
+
26
+ /**
27
+ * TiltCard — self-contained image card with a spring-based 3D tilt that
28
+ * follows the pointer (via the shared useTilt hook). On coarse-pointer
29
+ * devices or when the user prefers reduced motion it renders a plain,
30
+ * tilt-free card — no springs, no listeners.
31
+ *
32
+ * `variant="grounded"` gives a "planted at the bottom" feel: tilt targets
33
+ * are snapped to 3 zones, rescaled, chased by a slower lazy spring, and the
34
+ * card only ever tilts back — never forward — pivoting about its bottom edge
35
+ * (`transform-origin: center bottom`).
36
+ *
37
+ * Purely structural — no tokens, no colors. Corner radius, size, and any
38
+ * surface treatment come from the consumer via `className` (the image
39
+ * wrapper is `rounded-[inherit]`, so the root's radius clips the image);
40
+ * overlays (labels, gradients) render above the image via `children`.
41
+ *
42
+ * @param {string} src image source (rendered `object-cover`)
43
+ * @param {string} alt image alt text
44
+ * @param {string} className classes on the root — supplies size + corner radius
45
+ * @param {string} variant 'default' (free tilt) | 'grounded' (zone-snapped, bottom-pinned)
46
+ * @param {number} magnitude max tilt in degrees (±)
47
+ * @param {number} perspective CSS transform perspective in px
48
+ * @param {ReactNode} children content overlaid above the image
49
+ */
50
+ export default function TiltCard({
51
+ src,
52
+ alt = '',
53
+ className = '',
54
+ variant = 'default',
55
+ magnitude = 4,
56
+ perspective = 700,
57
+ children,
58
+ }) {
59
+ const coarse = useCoarsePointer()
60
+ const reduced = usePrefersReducedMotion()
61
+
62
+ if (coarse || reduced) {
63
+ return (
64
+ <div className={`relative ${className}`}>
65
+ <div className="absolute inset-0 overflow-hidden rounded-[inherit]">
66
+ <img src={src} alt={alt} className="w-full h-full object-cover" />
67
+ </div>
68
+ {children}
69
+ </div>
70
+ )
71
+ }
72
+
73
+ return (
74
+ <TiltCardInner
75
+ src={src}
76
+ alt={alt}
77
+ className={className}
78
+ variant={variant}
79
+ magnitude={magnitude}
80
+ perspective={perspective}
81
+ >
82
+ {children}
83
+ </TiltCardInner>
84
+ )
85
+ }
86
+
87
+ function TiltCardInner({ src, alt, className, variant, magnitude, perspective, children }) {
88
+ const tilt = useTilt({ magnitude, perspective })
89
+ const grounded = variant === 'grounded'
90
+
91
+ /* Zone-based tilt: normalize the spring output back to -1..1, snap it to
92
+ * 3 zones, rescale to ±2.5°, and let a slower lazy spring catch up so the
93
+ * card lags and settles into quantized angles. rotateX is clamped to
94
+ * min(0, …) — grounded cards only ever tilt back. */
95
+ const zones = 3
96
+ const snap = (v) => Math.round(v * zones) / zones
97
+ const lazySpring = { stiffness: 250, damping: 25, mass: 0.6 }
98
+
99
+ const targetX = useTransform(tilt.motionValues.rotateX, (v) =>
100
+ grounded ? Math.min(0, snap(-v / magnitude) * 2.5) : v,
101
+ )
102
+ const targetY = useTransform(tilt.motionValues.rotateY, (v) =>
103
+ grounded ? snap(v / magnitude) * 2.5 : v,
104
+ )
105
+
106
+ const lazyRotateX = useSpring(targetX, lazySpring)
107
+ const lazyRotateY = useSpring(targetY, lazySpring)
108
+
109
+ const style = grounded
110
+ ? { ...tilt.style, rotateX: lazyRotateX, rotateY: lazyRotateY, transformOrigin: 'center bottom' }
111
+ : tilt.style
112
+
113
+ return (
114
+ <motion.div
115
+ ref={tilt.ref}
116
+ className={`relative ${className}`}
117
+ style={style}
118
+ onMouseMove={tilt.onMouseMove}
119
+ onMouseLeave={tilt.onMouseLeave}
120
+ >
121
+ <div className="absolute inset-0 overflow-hidden rounded-[inherit]">
122
+ <img src={src} alt={alt} className="w-full h-full object-cover" />
123
+ </div>
124
+ {children}
125
+ </motion.div>
126
+ )
127
+ }
@@ -0,0 +1,50 @@
1
+ /**
2
+ * TypeSample — a single labeled type-specimen block: an optional mono caption
3
+ * over one paragraph whose typography is driven entirely by props via inline
4
+ * style. The atomic unit of the type-specimen kit — stack several to show a
5
+ * scale, a weight range, or a family; adjacent samples get a hairline
6
+ * separator (`.kol-type-sample + .kol-type-sample`).
7
+ *
8
+ * Presentational — arbitrary px values are the point, so props map to inline
9
+ * style rather than fixed kol-* size stops. Label and children render
10
+ * verbatim as authored.
11
+ *
12
+ * @param {string} family font family name (wrapped as `"family", sans-serif`); defaults to the KOL sans token
13
+ * @param {number} weight font-weight
14
+ * @param {boolean} italic italic sample
15
+ * @param {number} size font-size in px
16
+ * @param {number} lineHeight line-height in px; unitless 1.2 when unset
17
+ * @param {string} label mono caption above the sample (omit to hide)
18
+ * @param {ReactNode} children the specimen text itself
19
+ */
20
+ export default function TypeSample({
21
+ family,
22
+ weight = 400,
23
+ italic = false,
24
+ size = 32,
25
+ lineHeight,
26
+ label,
27
+ children,
28
+ }) {
29
+ return (
30
+ <div className="kol-type-sample py-6">
31
+ {label && (
32
+ <p className="kol-helper-12 tracking-wider text-meta m-0 mb-3">
33
+ {label}
34
+ </p>
35
+ )}
36
+ <p
37
+ className="kol-type-sample-body m-0 text-auto"
38
+ style={{
39
+ fontFamily: family ? `"${family}", sans-serif` : 'var(--kol-font-family-sans)',
40
+ fontWeight: weight,
41
+ fontStyle: italic ? 'italic' : 'normal',
42
+ fontSize: `${size}px`,
43
+ lineHeight: lineHeight ? `${lineHeight}px` : '1.2',
44
+ }}
45
+ >
46
+ {children}
47
+ </p>
48
+ </div>
49
+ )
50
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * TypeSpecCard — a two-column type-spec row: a left meta panel of key/value
3
+ * pairs (font metrics) beside a live sample slot on the right, with an
4
+ * optional corner label. The "data-sheet" member of the type-specimen kit —
5
+ * pairs the numeric spec of a type style with a rendered example of it
6
+ * (often a TypeSample passed as children, composed at the call site).
7
+ *
8
+ * Single column on mobile; `240px + fluid` two-column at lg. `meta` is
9
+ * arbitrary tuples — no fixed metric schema. Sample paragraphs get 16px
10
+ * rhythm via `.kol-type-spec-sample p` (Preflight zeroes <p> margins).
11
+ *
12
+ * @param {string} label corner caption, absolute top-left (omit to hide)
13
+ * @param {Array<[string, ReactNode]>} meta key/value rows in the left panel
14
+ * @param {ReactNode} children the live type sample on the right
15
+ */
16
+ export default function TypeSpecCard({ label, meta = [], children }) {
17
+ return (
18
+ <div className="kol-type-spec relative py-12 border-t border-fg-08">
19
+ {label && (
20
+ <span className="kol-type-spec-label kol-helper-12 tracking-widest text-meta absolute top-4 left-0">
21
+ {label}
22
+ </span>
23
+ )}
24
+ <div className="kol-type-spec-row grid grid-cols-1 gap-6 lg:grid-cols-[240px_minmax(0,1fr)] lg:gap-12 items-start pt-6">
25
+ <div className="kol-type-spec-meta flex flex-col">
26
+ {meta.map(([key, value]) => (
27
+ <div
28
+ key={key}
29
+ className="kol-type-spec-meta-row grid grid-cols-[auto_minmax(0,1fr)] gap-4 items-baseline py-2 border-b border-[var(--kol-fg-04)] last:border-b-0"
30
+ >
31
+ <span className="kol-helper-10 text-meta">{key}</span>
32
+ <span className="kol-helper-10 text-strong text-right [overflow-wrap:anywhere]">{value}</span>
33
+ </div>
34
+ ))}
35
+ </div>
36
+ <div className="kol-type-spec-sample min-w-0">
37
+ {children}
38
+ </div>
39
+ </div>
40
+ </div>
41
+ )
42
+ }
@@ -0,0 +1,53 @@
1
+ /**
2
+ * CSS-variable + color utilities for token-doc widgets (ColorRamp,
3
+ * SpectrumGrid, swatch tables). One probe-based resolver instead of the
4
+ * three inline getComputedStyle forks the monorepo sources carried.
5
+ * Plain functions, not hooks — they live here because src/hooks is the
6
+ * taxonomy's only non-component folder.
7
+ */
8
+
9
+ /** Read a custom property's raw value off an element (default: :root). */
10
+ export function resolveCssVar(name, el) {
11
+ if (typeof document === 'undefined') return ''
12
+ const target = el || document.documentElement
13
+ const prop = name.startsWith('--') ? name : `--${name}`
14
+ return getComputedStyle(target).getPropertyValue(prop).trim()
15
+ }
16
+
17
+ /**
18
+ * Resolve ANY css color expression (var(), color-mix(), keywords) to the
19
+ * browser's computed `rgb(...)`/`rgba(...)` form via a detached probe —
20
+ * getPropertyValue alone can't evaluate color-mix.
21
+ */
22
+ export function resolveCssColor(value, el) {
23
+ if (typeof document === 'undefined') return ''
24
+ const probe = document.createElement('span')
25
+ probe.style.display = 'none'
26
+ probe.style.color = value
27
+ ;(el || document.body).appendChild(probe)
28
+ const out = getComputedStyle(probe).color
29
+ probe.remove()
30
+ return out
31
+ }
32
+
33
+ /**
34
+ * Perceptual is-this-color-light test (BT.709 luma) — drives contrast
35
+ * label flips on swatches. Accepts hex or rgb()/rgba() strings; any other
36
+ * expression goes through resolveCssColor first.
37
+ */
38
+ export function isLight(color) {
39
+ let r, g, b
40
+ const hex = color.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/i)
41
+ if (hex) {
42
+ let h = hex[1]
43
+ if (h.length === 3) h = h.split('').map((c) => c + c).join('')
44
+ r = parseInt(h.slice(0, 2), 16)
45
+ g = parseInt(h.slice(2, 4), 16)
46
+ b = parseInt(h.slice(4, 6), 16)
47
+ } else {
48
+ const rgb = (color.startsWith('rgb') ? color : resolveCssColor(color)).match(/[\d.]+/g)
49
+ if (!rgb) return false
50
+ ;[r, g, b] = rgb.map(Number)
51
+ }
52
+ return (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255 > 0.55
53
+ }