@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.
- package/package.json +11 -3
- package/src/atoms/AnimatedTitle.jsx +108 -0
- package/src/atoms/AssetGrid.jsx +29 -0
- package/src/atoms/Button.jsx +17 -6
- package/src/atoms/CurveOverlay.jsx +180 -0
- package/src/atoms/DocsToc.jsx +48 -0
- package/src/atoms/EmptyState.jsx +22 -0
- package/src/atoms/Figure.jsx +27 -0
- package/src/atoms/HlsVideo.jsx +56 -0
- package/src/atoms/OverlayGlassPanel.jsx +40 -0
- package/src/atoms/PriceDisplay.jsx +34 -0
- package/src/atoms/ProsePreview.jsx +53 -0
- package/src/atoms/QuantityInput.jsx +76 -114
- package/src/atoms/RotaryDial.jsx +150 -0
- package/src/atoms/SearchInput.jsx +108 -0
- package/src/atoms/TextPressure.jsx +331 -0
- package/src/atoms/TiltCard.jsx +127 -0
- package/src/atoms/TypeSample.jsx +50 -0
- package/src/atoms/TypeSpecCard.jsx +42 -0
- package/src/hooks/cssVar.js +53 -0
- package/src/hooks/useAxisAnimation.js +91 -0
- package/src/hooks/usePrefersReducedMotion.js +21 -0
- package/src/hooks/useTilt.js +49 -0
- package/src/index.js +66 -2
- package/src/molecules/AlignmentGrid.jsx +53 -0
- package/src/molecules/ArticleCard.jsx +178 -0
- package/src/molecules/CardFeatureItem.jsx +130 -0
- package/src/molecules/ColorInputRow.jsx +179 -0
- package/src/molecules/ColorRamp.jsx +114 -0
- package/src/molecules/FramedMediaBand.jsx +56 -0
- package/src/molecules/ImageBlock.jsx +34 -0
- package/src/molecules/MenuPopover.jsx +4 -27
- package/src/molecules/SelectionOverlay.jsx +108 -0
- package/src/molecules/ShapeDropdown.jsx +92 -0
- package/src/molecules/ShellDrawer.jsx +169 -0
- package/src/molecules/ShellSearchOverlay.jsx +177 -0
- package/src/molecules/SpecList.jsx +30 -0
- package/src/molecules/SpectrumControls.jsx +504 -0
- package/src/molecules/SwatchControls.jsx +217 -0
- package/src/molecules/TabsRow.jsx +87 -0
- package/src/molecules/VideoBlock.jsx +86 -0
- package/src/molecules/WorkListItem.jsx +83 -0
- package/src/molecules/foundry/SpecimenSectionHeader.jsx +89 -0
- package/src/organisms/ArticleHeader.jsx +95 -0
- package/src/organisms/AsciiCursor.jsx +526 -0
- package/src/organisms/BentoCard.jsx +187 -0
- package/src/organisms/Canvas.jsx +299 -0
- package/src/organisms/ColorLoader.jsx +155 -0
- package/src/organisms/CtaGlobal.jsx +67 -0
- package/src/organisms/DiagonalMarqueeRiver.jsx +138 -0
- package/src/organisms/EditorShell.jsx +111 -0
- package/src/organisms/ErrorBoundary.jsx +70 -0
- package/src/organisms/FeatureSplit.jsx +82 -0
- package/src/organisms/FeaturedCarousel.jsx +258 -0
- package/src/organisms/FeaturesCardSection.jsx +90 -0
- package/src/organisms/FullBleedHero.jsx +111 -0
- package/src/organisms/GalleryCarousel.jsx +83 -0
- package/src/organisms/LoaderOverlay.jsx +30 -0
- package/src/organisms/MediaViewer.jsx +95 -0
- package/src/organisms/NewsletterBand.jsx +122 -0
- package/src/organisms/ParallaxShelf.jsx +141 -0
- package/src/organisms/PortableTextRenderer.jsx +115 -0
- package/src/organisms/ProductDetailLayout.jsx +189 -0
- package/src/organisms/ScrollDriftGallery.jsx +214 -0
- package/src/organisms/SpectrumGrid.jsx +90 -0
- package/src/organisms/StackHero.jsx +83 -0
- package/src/organisms/WorkCard.jsx +120 -0
- package/src/organisms/WorkViewToggle.jsx +170 -0
- package/src/organisms/foundry/FontPreviewSection.jsx +187 -0
- package/src/organisms/foundry/FoundryCharacterSets.jsx +113 -0
- package/src/organisms/foundry/GlyphMetricsGrid.jsx +335 -0
- package/src/organisms/foundry/TypefaceHero.jsx +107 -0
- package/src/organisms/foundry/TypefaceStyleSection.jsx +163 -0
- package/src/organisms/foundry/VariableFontSection.jsx +158 -0
- package/src/organisms/foundry/glyphData.js +30 -0
- package/src/organisms/foundry/index.js +21 -0
- 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
|
+
}
|