@cognitap/radiant 0.0.5 → 0.0.7

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 (234) hide show
  1. package/CHANGELOG.md +68 -368
  2. package/README.md +41 -1006
  3. package/RELEASE_POLICY.md +3 -3
  4. package/dist/library/Accordion.d.ts +3 -0
  5. package/dist/library/Accordion.d.ts.map +1 -1
  6. package/dist/library/Accordion.js +1 -1
  7. package/dist/library/Accordion.js.map +1 -1
  8. package/dist/library/Button.d.ts +8 -1
  9. package/dist/library/Button.d.ts.map +1 -1
  10. package/dist/library/Button.js +44 -2
  11. package/dist/library/Button.js.map +1 -1
  12. package/dist/library/Card.d.ts +2 -0
  13. package/dist/library/Card.d.ts.map +1 -1
  14. package/dist/library/Card.js +1 -1
  15. package/dist/library/Card.js.map +1 -1
  16. package/dist/library/Checkbox.d.ts +5 -0
  17. package/dist/library/Checkbox.d.ts.map +1 -1
  18. package/dist/library/Checkbox.js +3 -2
  19. package/dist/library/Checkbox.js.map +1 -1
  20. package/dist/library/Collapsible.d.ts +6 -1
  21. package/dist/library/Collapsible.d.ts.map +1 -1
  22. package/dist/library/Collapsible.js +24 -3
  23. package/dist/library/Collapsible.js.map +1 -1
  24. package/dist/library/Dialog.d.ts +5 -1
  25. package/dist/library/Dialog.d.ts.map +1 -1
  26. package/dist/library/Dialog.js +5 -2
  27. package/dist/library/Dialog.js.map +1 -1
  28. package/dist/library/Field.d.ts +8 -0
  29. package/dist/library/Field.d.ts.map +1 -1
  30. package/dist/library/Field.js +2 -0
  31. package/dist/library/Field.js.map +1 -1
  32. package/dist/library/Input.d.ts +3 -0
  33. package/dist/library/Input.d.ts.map +1 -1
  34. package/dist/library/Input.js +1 -0
  35. package/dist/library/Input.js.map +1 -1
  36. package/dist/library/Link.d.ts +5 -0
  37. package/dist/library/Link.d.ts.map +1 -1
  38. package/dist/library/Link.js.map +1 -1
  39. package/dist/library/RadioGroup.d.ts +8 -0
  40. package/dist/library/RadioGroup.d.ts.map +1 -1
  41. package/dist/library/RadioGroup.js +4 -2
  42. package/dist/library/RadioGroup.js.map +1 -1
  43. package/dist/library/ThemeScope.d.ts.map +1 -1
  44. package/dist/library/ThemeScope.js +10 -9
  45. package/dist/library/ThemeScope.js.map +1 -1
  46. package/dist/library/examples/expressive.d.ts +4 -0
  47. package/dist/library/examples/expressive.d.ts.map +1 -0
  48. package/dist/library/{themes → examples}/expressive.js +4 -3
  49. package/dist/library/examples/expressive.js.map +1 -0
  50. package/dist/library/examples/glass.d.ts +4 -0
  51. package/dist/library/examples/glass.d.ts.map +1 -0
  52. package/dist/library/{themes → examples}/glass.js +4 -3
  53. package/dist/library/examples/glass.js.map +1 -0
  54. package/dist/library/examples/index.d.ts +13 -0
  55. package/dist/library/examples/index.d.ts.map +1 -0
  56. package/dist/library/examples/index.js +32 -0
  57. package/dist/library/examples/index.js.map +1 -0
  58. package/dist/library/examples/jelly.d.ts +4 -0
  59. package/dist/library/examples/jelly.d.ts.map +1 -0
  60. package/dist/library/{themes → examples}/jelly.js +4 -3
  61. package/dist/library/examples/jelly.js.map +1 -0
  62. package/dist/library/examples/preset-values.d.ts.map +1 -0
  63. package/dist/library/examples/preset-values.js.map +1 -0
  64. package/dist/library/examples/radiant.d.ts +4 -0
  65. package/dist/library/examples/radiant.d.ts.map +1 -0
  66. package/dist/library/{themes → examples}/radiant.js +4 -3
  67. package/dist/library/examples/radiant.js.map +1 -0
  68. package/dist/library/examples/sharp-3d.d.ts +4 -0
  69. package/dist/library/examples/sharp-3d.d.ts.map +1 -0
  70. package/dist/library/{themes → examples}/sharp-3d.js +4 -3
  71. package/dist/library/examples/sharp-3d.js.map +1 -0
  72. package/dist/library/examples/soft-squircle.d.ts +4 -0
  73. package/dist/library/examples/soft-squircle.d.ts.map +1 -0
  74. package/dist/library/{themes → examples}/soft-squircle.js +4 -3
  75. package/dist/library/examples/soft-squircle.js.map +1 -0
  76. package/dist/library/examples/ticket.d.ts +4 -0
  77. package/dist/library/examples/ticket.d.ts.map +1 -0
  78. package/dist/library/{themes → examples}/ticket.js +4 -3
  79. package/dist/library/examples/ticket.js.map +1 -0
  80. package/dist/library/index.d.ts +4 -2
  81. package/dist/library/index.d.ts.map +1 -1
  82. package/dist/library/index.js +2 -1
  83. package/dist/library/index.js.map +1 -1
  84. package/dist/library/motion/MotionLink.d.ts +8 -0
  85. package/dist/library/motion/MotionLink.d.ts.map +1 -0
  86. package/dist/library/motion/MotionLink.js +44 -0
  87. package/dist/library/motion/MotionLink.js.map +1 -0
  88. package/dist/library/motion/browser.d.ts +5 -0
  89. package/dist/library/motion/browser.d.ts.map +1 -0
  90. package/dist/library/motion/browser.js +35 -0
  91. package/dist/library/motion/browser.js.map +1 -0
  92. package/dist/library/motion/config.d.ts +26 -0
  93. package/dist/library/motion/config.d.ts.map +1 -0
  94. package/dist/library/motion/config.js +58 -0
  95. package/dist/library/motion/config.js.map +1 -0
  96. package/dist/library/motion/context.d.ts +2 -0
  97. package/dist/library/motion/context.d.ts.map +1 -0
  98. package/dist/library/motion/context.js +5 -0
  99. package/dist/library/motion/context.js.map +1 -0
  100. package/dist/library/motion/drag.d.ts +20 -0
  101. package/dist/library/motion/drag.d.ts.map +1 -0
  102. package/dist/library/motion/drag.js +138 -0
  103. package/dist/library/motion/drag.js.map +1 -0
  104. package/dist/library/motion/dragBrowser.d.ts +4 -0
  105. package/dist/library/motion/dragBrowser.d.ts.map +1 -0
  106. package/dist/library/motion/dragBrowser.js +156 -0
  107. package/dist/library/motion/dragBrowser.js.map +1 -0
  108. package/dist/library/motion/follow.d.ts +9 -0
  109. package/dist/library/motion/follow.d.ts.map +1 -0
  110. package/dist/library/motion/follow.js +26 -0
  111. package/dist/library/motion/follow.js.map +1 -0
  112. package/dist/library/motion/host.d.ts +30 -0
  113. package/dist/library/motion/host.d.ts.map +1 -0
  114. package/dist/library/motion/host.js +70 -0
  115. package/dist/library/motion/host.js.map +1 -0
  116. package/dist/library/motion/index.d.ts +16 -0
  117. package/dist/library/motion/index.d.ts.map +1 -0
  118. package/dist/library/motion/index.js +9 -0
  119. package/dist/library/motion/index.js.map +1 -0
  120. package/dist/library/motion/layout.d.ts +20 -0
  121. package/dist/library/motion/layout.d.ts.map +1 -0
  122. package/dist/library/motion/layout.js +67 -0
  123. package/dist/library/motion/layout.js.map +1 -0
  124. package/dist/library/motion/layoutDom.d.ts +17 -0
  125. package/dist/library/motion/layoutDom.d.ts.map +1 -0
  126. package/dist/library/motion/layoutDom.js +272 -0
  127. package/dist/library/motion/layoutDom.js.map +1 -0
  128. package/dist/library/motion/press.d.ts +5 -0
  129. package/dist/library/motion/press.d.ts.map +1 -0
  130. package/dist/library/motion/press.js +99 -0
  131. package/dist/library/motion/press.js.map +1 -0
  132. package/dist/library/motion/pressPolicy.d.ts +5 -0
  133. package/dist/library/motion/pressPolicy.d.ts.map +1 -0
  134. package/dist/library/motion/pressPolicy.js +8 -0
  135. package/dist/library/motion/pressPolicy.js.map +1 -0
  136. package/dist/library/motion/react.d.ts +35 -0
  137. package/dist/library/motion/react.d.ts.map +1 -0
  138. package/dist/library/motion/react.js +224 -0
  139. package/dist/library/motion/react.js.map +1 -0
  140. package/dist/library/motion/runtime.d.ts +22 -0
  141. package/dist/library/motion/runtime.d.ts.map +1 -0
  142. package/dist/library/motion/runtime.js +117 -0
  143. package/dist/library/motion/runtime.js.map +1 -0
  144. package/dist/library/motion/transitions.d.ts +5 -0
  145. package/dist/library/motion/transitions.d.ts.map +1 -0
  146. package/dist/library/motion/transitions.js +244 -0
  147. package/dist/library/motion/transitions.js.map +1 -0
  148. package/dist/library/styles.css +1 -1
  149. package/dist/library/themes/defineTheme.d.ts +3 -0
  150. package/dist/library/themes/defineTheme.d.ts.map +1 -1
  151. package/dist/library/themes/defineTheme.js +4 -2
  152. package/dist/library/themes/defineTheme.js.map +1 -1
  153. package/dist/library/themes/index.d.ts +2 -12
  154. package/dist/library/themes/index.d.ts.map +1 -1
  155. package/dist/library/themes/index.js +1 -19
  156. package/dist/library/themes/index.js.map +1 -1
  157. package/dist/library/themes/themeDocument.d.ts.map +1 -1
  158. package/dist/library/themes/themeDocument.js +11 -5
  159. package/dist/library/themes/themeDocument.js.map +1 -1
  160. package/dist/library/themes/themeDocumentTypes.d.ts +5 -1
  161. package/dist/library/themes/themeDocumentTypes.d.ts.map +1 -1
  162. package/dist/library/themes/themeDocumentTypes.js.map +1 -1
  163. package/docs/accessibility.md +76 -142
  164. package/docs/architecture.md +197 -0
  165. package/docs/motion.md +153 -0
  166. package/docs/theming.md +275 -882
  167. package/package.json +22 -7
  168. package/src/Accordion.tsx +4 -1
  169. package/src/Button.tsx +55 -1
  170. package/src/Card.tsx +3 -1
  171. package/src/Checkbox.tsx +7 -2
  172. package/src/Collapsible.tsx +38 -2
  173. package/src/Dialog.tsx +13 -1
  174. package/src/Field.tsx +8 -0
  175. package/src/Input.tsx +3 -0
  176. package/src/Link.tsx +5 -0
  177. package/src/RadioGroup.tsx +10 -2
  178. package/src/ThemeScope.tsx +21 -17
  179. package/src/{themes → examples}/expressive.ts +5 -3
  180. package/src/{themes → examples}/glass.ts +5 -3
  181. package/src/examples/index.ts +35 -0
  182. package/src/{themes → examples}/jelly.ts +5 -3
  183. package/src/{themes → examples}/radiant.ts +5 -3
  184. package/src/{themes → examples}/sharp-3d.ts +5 -3
  185. package/src/{themes → examples}/soft-squircle.ts +5 -3
  186. package/src/{themes → examples}/ticket.ts +5 -3
  187. package/src/index.ts +10 -13
  188. package/src/motion/MotionLink.tsx +69 -0
  189. package/src/motion/browser.ts +45 -0
  190. package/src/motion/config.ts +79 -0
  191. package/src/motion/context.ts +4 -0
  192. package/src/motion/drag.ts +151 -0
  193. package/src/motion/dragBrowser.ts +159 -0
  194. package/src/motion/follow.ts +28 -0
  195. package/src/motion/host.ts +96 -0
  196. package/src/motion/index.ts +28 -0
  197. package/src/motion/layout.ts +78 -0
  198. package/src/motion/layoutDom.ts +293 -0
  199. package/src/motion/press.ts +97 -0
  200. package/src/motion/pressPolicy.ts +14 -0
  201. package/src/motion/react.ts +272 -0
  202. package/src/motion/runtime.ts +122 -0
  203. package/src/motion/transitions.ts +237 -0
  204. package/src/themes/defineTheme.ts +10 -2
  205. package/src/themes/index.ts +2 -22
  206. package/src/themes/themeDocument.ts +14 -6
  207. package/src/themes/themeDocumentTypes.ts +12 -5
  208. package/dist/library/themes/expressive.d.ts +0 -2
  209. package/dist/library/themes/expressive.d.ts.map +0 -1
  210. package/dist/library/themes/expressive.js.map +0 -1
  211. package/dist/library/themes/glass.d.ts +0 -2
  212. package/dist/library/themes/glass.d.ts.map +0 -1
  213. package/dist/library/themes/glass.js.map +0 -1
  214. package/dist/library/themes/jelly.d.ts +0 -2
  215. package/dist/library/themes/jelly.d.ts.map +0 -1
  216. package/dist/library/themes/jelly.js.map +0 -1
  217. package/dist/library/themes/preset-values.d.ts.map +0 -1
  218. package/dist/library/themes/preset-values.js.map +0 -1
  219. package/dist/library/themes/radiant.d.ts +0 -2
  220. package/dist/library/themes/radiant.d.ts.map +0 -1
  221. package/dist/library/themes/radiant.js.map +0 -1
  222. package/dist/library/themes/sharp-3d.d.ts +0 -2
  223. package/dist/library/themes/sharp-3d.d.ts.map +0 -1
  224. package/dist/library/themes/sharp-3d.js.map +0 -1
  225. package/dist/library/themes/soft-squircle.d.ts +0 -2
  226. package/dist/library/themes/soft-squircle.d.ts.map +0 -1
  227. package/dist/library/themes/soft-squircle.js.map +0 -1
  228. package/dist/library/themes/ticket.d.ts +0 -2
  229. package/dist/library/themes/ticket.d.ts.map +0 -1
  230. package/dist/library/themes/ticket.js.map +0 -1
  231. package/docs/system.md +0 -238
  232. /package/dist/library/{themes → examples}/preset-values.d.ts +0 -0
  233. /package/dist/library/{themes → examples}/preset-values.js +0 -0
  234. /package/src/{themes → examples}/preset-values.ts +0 -0
@@ -0,0 +1,35 @@
1
+ import { defaultTheme } from '../themes/default.js'
2
+ import type { Theme, ThemeDefinition } from '../themes/types.js'
3
+ import { freezeTree } from '../themes/tokens.js'
4
+ import { radiant, radiantDefinition } from './radiant.js'
5
+ import { soft, softDefinition } from './soft-squircle.js'
6
+ import { expressive, expressiveDefinition } from './expressive.js'
7
+ import { glass, glassDefinition } from './glass.js'
8
+ import { sharp, sharpDefinition } from './sharp-3d.js'
9
+ import { jelly, jellyDefinition } from './jelly.js'
10
+ import { ticket, ticketDefinition } from './ticket.js'
11
+
12
+ export { radiant, soft, expressive, glass, sharp, jelly, ticket }
13
+
14
+ export const themes: readonly Theme[] = Object.freeze([
15
+ radiant,
16
+ defaultTheme,
17
+ soft,
18
+ expressive,
19
+ glass,
20
+ sharp,
21
+ jelly,
22
+ ticket
23
+ ])
24
+
25
+ /** The source of each theme in `themes`, in the same order, for editors that start from one. */
26
+ export const themeDefinitions: readonly ThemeDefinition[] = freezeTree([
27
+ radiantDefinition,
28
+ { id: defaultTheme.id, name: defaultTheme.name },
29
+ softDefinition,
30
+ expressiveDefinition,
31
+ glassDefinition,
32
+ sharpDefinition,
33
+ jellyDefinition,
34
+ ticketDefinition
35
+ ])
@@ -1,7 +1,7 @@
1
- import { defineTheme } from './defineTheme.js'
1
+ import { defineTheme, type ThemeDefinition } from '../themes/defineTheme.js'
2
2
  import { snap, spring } from './preset-values.js'
3
3
 
4
- export const jelly = defineTheme({
4
+ export const jellyDefinition: ThemeDefinition = {
5
5
  id: 'jelly',
6
6
  name: 'Jelly',
7
7
  tokens: {
@@ -127,4 +127,6 @@ export const jelly = defineTheme({
127
127
  }
128
128
  }
129
129
  }
130
- })
130
+ }
131
+
132
+ export const jelly = defineTheme(jellyDefinition)
@@ -1,7 +1,7 @@
1
- import { defineTheme } from './defineTheme.js'
1
+ import { defineTheme, type ThemeDefinition } from '../themes/defineTheme.js'
2
2
  import { snap, settle } from './preset-values.js'
3
3
 
4
- export const radiant = defineTheme({
4
+ export const radiantDefinition: ThemeDefinition = {
5
5
  id: 'radiant',
6
6
  name: 'Radiant',
7
7
  tokens: {
@@ -126,4 +126,6 @@ export const radiant = defineTheme({
126
126
  }
127
127
  }
128
128
  }
129
- })
129
+ }
130
+
131
+ export const radiant = defineTheme(radiantDefinition)
@@ -1,7 +1,7 @@
1
- import { defineTheme } from './defineTheme.js'
1
+ import { defineTheme, type ThemeDefinition } from '../themes/defineTheme.js'
2
2
  import { snap, settle } from './preset-values.js'
3
3
 
4
- export const sharp = defineTheme({
4
+ export const sharpDefinition: ThemeDefinition = {
5
5
  id: 'sharp-3d',
6
6
  name: 'Sharp 3D',
7
7
  tokens: {
@@ -139,4 +139,6 @@ export const sharp = defineTheme({
139
139
  }
140
140
  }
141
141
  }
142
- })
142
+ }
143
+
144
+ export const sharp = defineTheme(sharpDefinition)
@@ -1,7 +1,7 @@
1
- import { defineTheme } from './defineTheme.js'
1
+ import { defineTheme, type ThemeDefinition } from '../themes/defineTheme.js'
2
2
  import { snap, spring } from './preset-values.js'
3
3
 
4
- export const soft = defineTheme({
4
+ export const softDefinition: ThemeDefinition = {
5
5
  id: 'soft-squircle',
6
6
  name: 'Soft squircle',
7
7
  tokens: {
@@ -128,4 +128,6 @@ export const soft = defineTheme({
128
128
  }
129
129
  }
130
130
  }
131
- })
131
+ }
132
+
133
+ export const soft = defineTheme(softDefinition)
@@ -1,7 +1,7 @@
1
- import { defineTheme } from './defineTheme.js'
1
+ import { defineTheme, type ThemeDefinition } from '../themes/defineTheme.js'
2
2
  import { snap, settle } from './preset-values.js'
3
3
 
4
- export const ticket = defineTheme({
4
+ export const ticketDefinition: ThemeDefinition = {
5
5
  id: 'ticket',
6
6
  name: 'Ticket',
7
7
  tokens: {
@@ -138,4 +138,6 @@ export const ticket = defineTheme({
138
138
  }
139
139
  }
140
140
  }
141
- })
141
+ }
142
+
143
+ export const ticket = defineTheme(ticketDefinition)
package/src/index.ts CHANGED
@@ -66,19 +66,7 @@ export type {
66
66
  CardProps,
67
67
  CardTitleProps
68
68
  } from './Card.js'
69
- export {
70
- defineTheme,
71
- updateThemeAppearance,
72
- themes,
73
- radiant,
74
- defaultTheme,
75
- soft,
76
- expressive,
77
- glass,
78
- sharp,
79
- jelly,
80
- ticket
81
- } from './themes/index.js'
69
+ export { defineTheme, updateThemeAppearance, defaultTheme } from './themes/index.js'
82
70
  export type {
83
71
  SharedTokens,
84
72
  ThemeAppearanceSettings,
@@ -116,6 +104,7 @@ export type {
116
104
  ThemeColorStop,
117
105
  ThemeBrandSource,
118
106
  ThemePalette,
107
+ ThemeMotionSection,
119
108
  ThemeTypographySection,
120
109
  ThemeFontAxis,
121
110
  ThemeFontMetadata
@@ -132,3 +121,11 @@ export type {
132
121
  PaletteContrastCheck,
133
122
  WorkingPaletteRole
134
123
  } from './color/index.js'
124
+
125
+ export { defineMotionProfile, defaultMotionProfile } from './motion/config.js'
126
+ export type {
127
+ MotionProfile,
128
+ MotionProfileInput,
129
+ MotionInteraction,
130
+ SpringParameters
131
+ } from './motion/config.js'
@@ -0,0 +1,69 @@
1
+ 'use client'
2
+ import { Link, type LinkProps } from '../Link.js'
3
+ import { cn } from '../cn.js'
4
+ import { usePressHost } from './host.js'
5
+ import { callerOwnsPress, springPressClass, offPressClass } from './pressPolicy.js'
6
+ export type MotionLinkProps = LinkProps & {
7
+ /** Inherit the theme's spring policy; off suppresses spatial feedback. Requires MotionProvider. */
8
+ motion?: 'inherit' | 'off'
9
+ }
10
+ /** Optional client adapter for action-shaped Link; ordinary Link stays server-renderable. */
11
+ export function MotionLink({ ref, motion = 'inherit', className, ...props }: MotionLinkProps) {
12
+ const owns = callerOwnsPress(props.style, className)
13
+ const disabled =
14
+ owns ||
15
+ motion === 'off' ||
16
+ props.variant === undefined ||
17
+ props.variant === 'inline' ||
18
+ props.variant === 'subtle'
19
+ const {
20
+ ref: motionRef,
21
+ press: startPress,
22
+ release,
23
+ off,
24
+ active
25
+ } = usePressHost<HTMLAnchorElement>(ref, disabled)
26
+ return (
27
+ <Link
28
+ {...props}
29
+ ref={active ? motionRef : ref}
30
+ className={cn(
31
+ active && springPressClass,
32
+ (motion === 'off' || off) && !owns && offPressClass,
33
+ className
34
+ )}
35
+ onPointerDown={event => {
36
+ props.onPointerDown?.(event)
37
+ if (!event.defaultPrevented) startPress(event.nativeEvent)
38
+ }}
39
+ onPointerUp={event => {
40
+ props.onPointerUp?.(event)
41
+ release(event.nativeEvent)
42
+ }}
43
+ onPointerCancel={event => {
44
+ props.onPointerCancel?.(event)
45
+ release(event.nativeEvent)
46
+ }}
47
+ onPointerLeave={event => {
48
+ props.onPointerLeave?.(event)
49
+ release(event.nativeEvent)
50
+ }}
51
+ onLostPointerCapture={event => {
52
+ props.onLostPointerCapture?.(event)
53
+ release(event.nativeEvent)
54
+ }}
55
+ onBlur={event => {
56
+ props.onBlur?.(event)
57
+ release()
58
+ }}
59
+ onKeyDown={event => {
60
+ props.onKeyDown?.(event)
61
+ if (!event.defaultPrevented) startPress(event.nativeEvent)
62
+ }}
63
+ onKeyUp={event => {
64
+ props.onKeyUp?.(event)
65
+ release(event.nativeEvent)
66
+ }}
67
+ />
68
+ )
69
+ }
@@ -0,0 +1,45 @@
1
+ import type { SpringController } from './runtime.js'
2
+
3
+ export type SpringStyleProperty =
4
+ | 'scale'
5
+ | 'opacity'
6
+ | 'width'
7
+ | 'height'
8
+ | 'translateX'
9
+ | 'translateY'
10
+ /** Bind one explicitly reserved individual property; never overwrite transform or events. */
11
+ export function bindSpringStyle(
12
+ node: HTMLElement,
13
+ spring: SpringController,
14
+ property: SpringStyleProperty
15
+ ): () => void {
16
+ if (!['scale', 'opacity', 'width', 'height', 'translateX', 'translateY'].includes(property))
17
+ throw new TypeError('Unsupported spring style property.')
18
+ const key = property === 'translateX' || property === 'translateY' ? 'translate' : property
19
+ const previous = node.style.getPropertyValue(key)
20
+ const priority = node.style.getPropertyPriority(key)
21
+ let owned = previous
22
+ const apply = (next: number) => {
23
+ const formatted =
24
+ property === 'width' || property === 'height'
25
+ ? `${Math.max(0, next)}px`
26
+ : property === 'translateX'
27
+ ? `${next}px 0px`
28
+ : property === 'translateY'
29
+ ? `0px ${next}px`
30
+ : property === 'opacity'
31
+ ? String(Math.max(0, Math.min(1, next)))
32
+ : String(Math.max(0, next))
33
+ node.style.setProperty(key, formatted)
34
+ owned = node.style.getPropertyValue(key)
35
+ }
36
+ apply(spring.get())
37
+ const off = spring.subscribe(apply)
38
+ return () => {
39
+ off()
40
+ // A caller may have reclaimed the property since the last spring frame.
41
+ if (node.style.getPropertyValue(key) !== owned) return
42
+ if (previous) node.style.setProperty(key, previous, priority)
43
+ else node.style.removeProperty(key)
44
+ }
45
+ }
@@ -0,0 +1,79 @@
1
+ export interface SpringParameters {
2
+ readonly stiffness: number
3
+ readonly damping: number
4
+ readonly mass: number
5
+ }
6
+ export const motionInteractions = [
7
+ 'press',
8
+ 'disclosure',
9
+ 'dialog',
10
+ 'follow',
11
+ 'drag',
12
+ 'layout'
13
+ ] as const
14
+ export type MotionInteraction = (typeof motionInteractions)[number]
15
+ export interface MotionProfileInput {
16
+ readonly mode?: 'system' | 'off'
17
+ readonly spring?: Partial<SpringParameters>
18
+ readonly interactions?: Partial<Record<MotionInteraction, Partial<SpringParameters>>>
19
+ }
20
+ export interface MotionProfile {
21
+ readonly mode: 'system' | 'off'
22
+ readonly spring: SpringParameters
23
+ readonly interactions: Readonly<Record<MotionInteraction, SpringParameters>>
24
+ }
25
+ const baseline: SpringParameters = Object.freeze({ stiffness: 320, damping: 30, mass: 1 })
26
+ function record(value: unknown, allowed: readonly string[], path: string): void {
27
+ if (!value || typeof value !== 'object' || Array.isArray(value))
28
+ throw new TypeError(`${path} must be an object.`)
29
+ for (const key of Object.keys(value))
30
+ if (!allowed.includes(key)) throw new TypeError(`Unknown key: ${path}.${key}.`)
31
+ }
32
+ export function resolveSpringParameters(
33
+ input: Partial<SpringParameters> = {},
34
+ base: SpringParameters = baseline
35
+ ): SpringParameters {
36
+ record(input, ['stiffness', 'damping', 'mass'], 'spring')
37
+ const result = { ...base }
38
+ for (const key of ['stiffness', 'damping', 'mass'] as const) {
39
+ const value = input[key]
40
+ if (value === undefined) continue
41
+ const max = key === 'mass' ? 100 : 10000
42
+ if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0 || value > max)
43
+ throw new TypeError(`spring.${key} must be greater than zero and at most ${max}.`)
44
+ result[key] = value
45
+ }
46
+ return Object.freeze(result)
47
+ }
48
+ /** Plain immutable theme data; importing configuration never loads an animation engine. */
49
+ export function defineMotionProfile(input: MotionProfileInput = {}): MotionProfile {
50
+ record(input, ['mode', 'spring', 'interactions'], 'motion')
51
+ if (input.mode !== undefined && input.mode !== 'system' && input.mode !== 'off')
52
+ throw new TypeError('motion.mode must be system or off.')
53
+ const spring = resolveSpringParameters(input.spring)
54
+ if (input.interactions !== undefined)
55
+ record(input.interactions, motionInteractions, 'motion.interactions')
56
+ const interactions = Object.fromEntries(
57
+ motionInteractions.map(name => [
58
+ name,
59
+ resolveSpringParameters(input.interactions?.[name], spring)
60
+ ])
61
+ ) as Record<MotionInteraction, SpringParameters>
62
+ return Object.freeze({
63
+ mode: input.mode ?? 'system',
64
+ spring,
65
+ interactions: Object.freeze(interactions)
66
+ })
67
+ }
68
+ export const defaultMotionProfile = defineMotionProfile()
69
+ export function resolveMotion(
70
+ profile: MotionProfile,
71
+ interaction: MotionInteraction,
72
+ reducedMotion: boolean
73
+ ) {
74
+ if (!motionInteractions.includes(interaction)) throw new TypeError('Unknown motion interaction.')
75
+ return {
76
+ enabled: profile.mode !== 'off' && !reducedMotion,
77
+ parameters: profile.interactions[interaction]
78
+ }
79
+ }
@@ -0,0 +1,4 @@
1
+ 'use client'
2
+ import { createContext } from 'react'
3
+ import { defaultMotionProfile } from './config.js'
4
+ export const MotionProfileContext = createContext(defaultMotionProfile)
@@ -0,0 +1,151 @@
1
+ import { createSpring, type SpringController, type SpringOptions } from './runtime.js'
2
+ export interface SpringDragOptions extends SpringOptions {
3
+ readonly min: number
4
+ readonly max: number
5
+ readonly snapPoints?: readonly number[]
6
+ }
7
+ export interface SpringDragController extends SpringController {
8
+ begin(): void
9
+ move(position: number, time: number): void
10
+ release(time: number): { target: number; velocity: number }
11
+ cancel(): void
12
+ step(direction: -1 | 1 | 'first' | 'last'): void
13
+ configure(options: Partial<SpringDragOptions>): void
14
+ }
15
+ function validated(input: SpringDragOptions) {
16
+ if (!Number.isFinite(input.min) || !Number.isFinite(input.max) || input.min >= input.max)
17
+ throw new TypeError('Drag bounds must be finite and min < max.')
18
+ if (input.reducedValue !== undefined)
19
+ throw new TypeError('Drag off snaps to its functional goal, not a decorative reducedValue.')
20
+ const points = input.snapPoints ?? [input.min, input.max]
21
+ if (
22
+ !Array.isArray(points) ||
23
+ !points.length ||
24
+ points.some(value => !Number.isFinite(value) || value < input.min || value > input.max)
25
+ )
26
+ throw new TypeError('Snap points must be a nonempty array within bounds.')
27
+ return { ...input, snapPoints: [...new Set(points)].sort((a, b) => a - b) }
28
+ }
29
+ /** One axis, local pixels; Motion supplies all spring physics. */
30
+ export function createSpringDrag(initial: number, input: SpringDragOptions): SpringDragController {
31
+ let options = validated(input)
32
+ const clamp = (value: number) => Math.max(options.min, Math.min(options.max, value))
33
+ if (!Number.isFinite(initial) || initial < options.min || initial > options.max)
34
+ throw new TypeError('Initial drag position must be within bounds.')
35
+ const spring = createSpring(initial, options)
36
+ let goal = initial,
37
+ cancelGoal = initial,
38
+ dragging = false,
39
+ velocity = 0,
40
+ lastTime: number | undefined,
41
+ lastPosition = initial,
42
+ destroyed = false
43
+ const choose = (position: number) =>
44
+ options.snapPoints.reduce(
45
+ (best, point) => (Math.abs(point - position) < Math.abs(best - position) ? point : best),
46
+ options.snapPoints[0]
47
+ )
48
+ const to = (target: number, speed?: number) => {
49
+ if (!Number.isFinite(target)) throw new TypeError('Drag target must be finite.')
50
+ if (destroyed) return
51
+ goal = clamp(target)
52
+ spring.to(goal, speed)
53
+ }
54
+ const controller: SpringDragController = {
55
+ get: () => clamp(spring.get()),
56
+ getVelocity: () =>
57
+ spring.get() < options.min || spring.get() > options.max ? 0 : spring.getVelocity(),
58
+ isAnimating: () => spring.isAnimating(),
59
+ to,
60
+ jump(target) {
61
+ if (!Number.isFinite(target)) throw new TypeError('Drag target must be finite.')
62
+ if (destroyed) return
63
+ goal = clamp(target)
64
+ spring.jump(goal)
65
+ },
66
+ stop() {
67
+ if (destroyed) return
68
+ spring.stop()
69
+ goal = controller.get()
70
+ },
71
+ subscribe(listener) {
72
+ return spring.subscribe(() => listener(controller.get()))
73
+ },
74
+ configure(next) {
75
+ if (destroyed) return
76
+ const resolved = validated({ ...options, ...next })
77
+ spring.configure(resolved)
78
+ options = resolved
79
+ goal = clamp(goal)
80
+ cancelGoal = clamp(cancelGoal)
81
+ if (dragging) spring.jump(controller.get())
82
+ else spring.to(goal)
83
+ },
84
+ begin() {
85
+ if (destroyed) return
86
+ cancelGoal = goal
87
+ dragging = true
88
+ lastTime = undefined
89
+ velocity = 0
90
+ lastPosition = controller.get()
91
+ spring.jump(lastPosition)
92
+ },
93
+ move(position, time) {
94
+ if (!Number.isFinite(position) || !Number.isFinite(time))
95
+ throw new TypeError('Drag samples need finite pixel positions and millisecond times.')
96
+ if (!dragging || destroyed) return
97
+ const current = clamp(position)
98
+ if (lastTime !== undefined) {
99
+ const dt = time - lastTime
100
+ velocity =
101
+ dt > 0 && dt <= 80
102
+ ? Math.max(-3000, Math.min(3000, ((current - lastPosition) * 1000) / dt))
103
+ : 0
104
+ }
105
+ lastTime = time
106
+ lastPosition = current
107
+ spring.jump(current)
108
+ },
109
+ release(time) {
110
+ if (!Number.isFinite(time)) throw new TypeError('Release time must be finite.')
111
+ if (!dragging || destroyed) return { target: goal, velocity: 0 }
112
+ dragging = false
113
+ const speed =
114
+ options.enabled === false ||
115
+ lastTime === undefined ||
116
+ time - lastTime > 80 ||
117
+ time < lastTime
118
+ ? 0
119
+ : velocity
120
+ const target = choose(clamp(controller.get() + speed * 0.18))
121
+ to(target, speed)
122
+ return { target, velocity: speed }
123
+ },
124
+ cancel() {
125
+ if (!dragging || destroyed) return
126
+ dragging = false
127
+ to(cancelGoal, 0)
128
+ },
129
+ step(direction) {
130
+ if (destroyed) return
131
+ dragging = false
132
+ const current = goal
133
+ const points = options.snapPoints
134
+ const target =
135
+ direction === 'first'
136
+ ? points[0]
137
+ : direction === 'last'
138
+ ? points.at(-1)!
139
+ : direction === 1
140
+ ? (points.find(point => point > current + 0.01) ?? points.at(-1)!)
141
+ : ([...points].reverse().find(point => point < current - 0.01) ?? points[0])
142
+ to(target)
143
+ },
144
+ destroy() {
145
+ destroyed = true
146
+ dragging = false
147
+ spring.destroy()
148
+ }
149
+ }
150
+ return controller
151
+ }
@@ -0,0 +1,159 @@
1
+ import type { SpringDragController } from './drag.js'
2
+ import { bindSpringStyle } from './browser.js'
3
+ /** Bind one dedicated handle. Document bubble handlers let React/native consumers cancel first. */
4
+ export function bindSpringDrag(
5
+ node: HTMLElement,
6
+ controller: SpringDragController,
7
+ axis: 'x' | 'y' = 'x'
8
+ ) {
9
+ const document = node.ownerDocument
10
+ const unbind = bindSpringStyle(node, controller, axis === 'x' ? 'translateX' : 'translateY')
11
+ const previousTouch = node.style.touchAction
12
+ const ownsTouch = !previousTouch
13
+ if (ownsTouch) node.style.touchAction = axis === 'x' ? 'pan-y' : 'pan-x'
14
+ const ownedTouch = node.style.touchAction
15
+ let active: number | undefined,
16
+ start = 0,
17
+ origin = 0,
18
+ cross = 0,
19
+ moved = false,
20
+ suppress = false
21
+ const coordinate = (event: PointerEvent) => (axis === 'x' ? event.clientX : event.clientY)
22
+ const other = (event: PointerEvent) => (axis === 'x' ? event.clientY : event.clientX)
23
+ const blocked = () =>
24
+ node.matches(':disabled') ||
25
+ node.getAttribute('aria-busy') === 'true' ||
26
+ node.getAttribute('aria-disabled') === 'true'
27
+ const target = (event: Event) => event.target instanceof Node && node.contains(event.target)
28
+ function free() {
29
+ if (active !== undefined && node.hasPointerCapture(active)) node.releasePointerCapture(active)
30
+ active = undefined
31
+ }
32
+ function down(event: PointerEvent) {
33
+ if (
34
+ event.defaultPrevented ||
35
+ !target(event) ||
36
+ event.button !== 0 ||
37
+ event.isPrimary === false ||
38
+ active !== undefined ||
39
+ blocked()
40
+ )
41
+ return
42
+ suppress = false
43
+ active = event.pointerId
44
+ start = coordinate(event)
45
+ cross = other(event)
46
+ origin = controller.get()
47
+ moved = false
48
+ controller.begin()
49
+ controller.move(origin, event.timeStamp)
50
+ }
51
+ function move(event: PointerEvent) {
52
+ if (active !== event.pointerId) return
53
+ if (event.defaultPrevented || blocked()) {
54
+ cancel()
55
+ return
56
+ }
57
+ const delta = coordinate(event) - start
58
+ if (!moved && Math.abs(other(event) - cross) > Math.max(4, Math.abs(delta))) {
59
+ cancel()
60
+ return
61
+ }
62
+ if (!moved && Math.abs(delta) < 3) return
63
+ if (!moved) {
64
+ moved = true
65
+ try {
66
+ node.setPointerCapture(event.pointerId)
67
+ } catch {
68
+ /* Document events still provide outside release for synthetic input. */
69
+ }
70
+ }
71
+ controller.move(origin + delta, event.timeStamp)
72
+ }
73
+ function up(event: PointerEvent) {
74
+ if (active !== event.pointerId) return
75
+ if (event.defaultPrevented || blocked()) {
76
+ cancel()
77
+ return
78
+ }
79
+ suppress = moved
80
+ controller.release(event.timeStamp)
81
+ free()
82
+ moved = false
83
+ }
84
+ function cancel() {
85
+ if (active === undefined) return
86
+ controller.cancel()
87
+ free()
88
+ suppress = moved
89
+ }
90
+ function cancelled(event: PointerEvent) {
91
+ if (active === event.pointerId) cancel()
92
+ }
93
+ function key(event: KeyboardEvent) {
94
+ if (!target(event) || event.defaultPrevented || blocked()) return
95
+ const backward = axis === 'x' ? 'ArrowLeft' : 'ArrowUp',
96
+ forward = axis === 'x' ? 'ArrowRight' : 'ArrowDown'
97
+ if (event.key === 'Escape') {
98
+ if (active !== undefined) {
99
+ event.preventDefault()
100
+ cancel()
101
+ }
102
+ return
103
+ }
104
+ if ([backward, forward, 'Home', 'End'].includes(event.key)) {
105
+ event.preventDefault()
106
+ if (active !== undefined) cancel()
107
+ controller.step(
108
+ event.key === 'Home'
109
+ ? 'first'
110
+ : event.key === 'End'
111
+ ? 'last'
112
+ : event.key === forward
113
+ ? 1
114
+ : -1
115
+ )
116
+ }
117
+ }
118
+ function click(event: MouseEvent) {
119
+ if (suppress) {
120
+ suppress = false
121
+ event.preventDefault()
122
+ event.stopPropagation()
123
+ }
124
+ }
125
+ document.addEventListener('pointerdown', down)
126
+ document.addEventListener('pointermove', move)
127
+ document.addEventListener('pointerup', up)
128
+ document.addEventListener('pointercancel', cancelled)
129
+ document.addEventListener('keydown', key)
130
+ node.addEventListener('lostpointercapture', cancelled)
131
+ node.addEventListener('click', click, true)
132
+ document.defaultView!.addEventListener('blur', cancel)
133
+ node.addEventListener('blur', cancel)
134
+ const observer = new MutationObserver(() => {
135
+ if (blocked()) cancel()
136
+ })
137
+ observer.observe(node, {
138
+ attributes: true,
139
+ attributeFilter: ['disabled', 'aria-busy', 'aria-disabled']
140
+ })
141
+ for (let parent = node.parentElement; parent; parent = parent.parentElement)
142
+ if (parent.tagName === 'FIELDSET')
143
+ observer.observe(parent, { attributes: true, attributeFilter: ['disabled'] })
144
+ return () => {
145
+ cancel()
146
+ unbind()
147
+ if (ownsTouch && node.style.touchAction === ownedTouch) node.style.touchAction = previousTouch
148
+ document.removeEventListener('pointerdown', down)
149
+ document.removeEventListener('pointermove', move)
150
+ document.removeEventListener('pointerup', up)
151
+ document.removeEventListener('pointercancel', cancelled)
152
+ document.removeEventListener('keydown', key)
153
+ node.removeEventListener('lostpointercapture', cancelled)
154
+ node.removeEventListener('click', click, true)
155
+ document.defaultView!.removeEventListener('blur', cancel)
156
+ node.removeEventListener('blur', cancel)
157
+ observer.disconnect()
158
+ }
159
+ }