@react-native-motion-kit/text-motion 0.0.0-stage → 0.1.1

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 (252) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/LICENSE +20 -0
  3. package/README.ko.md +104 -0
  4. package/README.md +103 -2
  5. package/lib/module/accessibility/index.js +4 -0
  6. package/lib/module/accessibility/index.js.map +1 -0
  7. package/lib/module/accessibility/policies.js +39 -0
  8. package/lib/module/accessibility/policies.js.map +1 -0
  9. package/lib/module/controls/brand.js +4 -0
  10. package/lib/module/controls/brand.js.map +1 -0
  11. package/lib/module/controls/controls.js +28 -0
  12. package/lib/module/controls/controls.js.map +1 -0
  13. package/lib/module/controls/descriptors.js +55 -0
  14. package/lib/module/controls/descriptors.js.map +1 -0
  15. package/lib/module/controls/index.js +4 -0
  16. package/lib/module/controls/index.js.map +1 -0
  17. package/lib/module/effects/compose.js +48 -0
  18. package/lib/module/effects/compose.js.map +1 -0
  19. package/lib/module/effects/fade.js +15 -0
  20. package/lib/module/effects/fade.js.map +1 -0
  21. package/lib/module/effects/index.js +12 -0
  22. package/lib/module/effects/index.js.map +1 -0
  23. package/lib/module/effects/lineReveal.js +17 -0
  24. package/lib/module/effects/lineReveal.js.map +1 -0
  25. package/lib/module/effects/pulse.js +14 -0
  26. package/lib/module/effects/pulse.js.map +1 -0
  27. package/lib/module/effects/rise.js +14 -0
  28. package/lib/module/effects/rise.js.map +1 -0
  29. package/lib/module/effects/scale.js +15 -0
  30. package/lib/module/effects/scale.js.map +1 -0
  31. package/lib/module/effects/shake.js +14 -0
  32. package/lib/module/effects/shake.js.map +1 -0
  33. package/lib/module/effects/slide.js +15 -0
  34. package/lib/module/effects/slide.js.map +1 -0
  35. package/lib/module/effects/typewriter.js +19 -0
  36. package/lib/module/effects/typewriter.js.map +1 -0
  37. package/lib/module/effects/validation.js +10 -0
  38. package/lib/module/effects/validation.js.map +1 -0
  39. package/lib/module/index.js +10 -0
  40. package/lib/module/index.js.map +1 -0
  41. package/lib/module/package.json +1 -0
  42. package/lib/module/presets/index.js +35 -0
  43. package/lib/module/presets/index.js.map +1 -0
  44. package/lib/module/recipe/component.js +60 -0
  45. package/lib/module/recipe/component.js.map +1 -0
  46. package/lib/module/recipe/defineTextMotion.js +9 -0
  47. package/lib/module/recipe/defineTextMotion.js.map +1 -0
  48. package/lib/module/recipe/descriptors.js +60 -0
  49. package/lib/module/recipe/descriptors.js.map +1 -0
  50. package/lib/module/recipe/index.js +5 -0
  51. package/lib/module/recipe/index.js.map +1 -0
  52. package/lib/module/recipe/recipe.js +163 -0
  53. package/lib/module/recipe/recipe.js.map +1 -0
  54. package/lib/module/renderers/index.js +5 -0
  55. package/lib/module/renderers/index.js.map +1 -0
  56. package/lib/module/renderers/nativeText.js +494 -0
  57. package/lib/module/renderers/nativeText.js.map +1 -0
  58. package/lib/module/renderers/nativeTextControls.js +96 -0
  59. package/lib/module/renderers/nativeTextControls.js.map +1 -0
  60. package/lib/module/renderers/nativeTextLineLayout.js +290 -0
  61. package/lib/module/renderers/nativeTextLineLayout.js.map +1 -0
  62. package/lib/module/renderers/nativeTextPlayback.js +91 -0
  63. package/lib/module/renderers/nativeTextPlayback.js.map +1 -0
  64. package/lib/module/renderers/overlayText.js +543 -0
  65. package/lib/module/renderers/overlayText.js.map +1 -0
  66. package/lib/module/renderers/overlayTextLayout.js +182 -0
  67. package/lib/module/renderers/overlayTextLayout.js.map +1 -0
  68. package/lib/module/renderers/rendererMotion.js +264 -0
  69. package/lib/module/renderers/rendererMotion.js.map +1 -0
  70. package/lib/module/split/createToken.js +19 -0
  71. package/lib/module/split/createToken.js.map +1 -0
  72. package/lib/module/split/custom.js +57 -0
  73. package/lib/module/split/custom.js.map +1 -0
  74. package/lib/module/split/graphemes.js +25 -0
  75. package/lib/module/split/graphemes.js.map +1 -0
  76. package/lib/module/split/index.js +7 -0
  77. package/lib/module/split/index.js.map +1 -0
  78. package/lib/module/split/lines.js +43 -0
  79. package/lib/module/split/lines.js.map +1 -0
  80. package/lib/module/split/segmenter.js +74 -0
  81. package/lib/module/split/segmenter.js.map +1 -0
  82. package/lib/module/split/words.js +28 -0
  83. package/lib/module/split/words.js.map +1 -0
  84. package/lib/module/timeline/index.js +7 -0
  85. package/lib/module/timeline/index.js.map +1 -0
  86. package/lib/module/timeline/parallel.js +21 -0
  87. package/lib/module/timeline/parallel.js.map +1 -0
  88. package/lib/module/timeline/sequence.js +18 -0
  89. package/lib/module/timeline/sequence.js.map +1 -0
  90. package/lib/module/timeline/stagger.js +43 -0
  91. package/lib/module/timeline/stagger.js.map +1 -0
  92. package/lib/module/timeline/validation.js +24 -0
  93. package/lib/module/timeline/validation.js.map +1 -0
  94. package/lib/module/timeline/wave.js +25 -0
  95. package/lib/module/timeline/wave.js.map +1 -0
  96. package/lib/module/types/index.js +4 -0
  97. package/lib/module/types/index.js.map +1 -0
  98. package/lib/module/types/recipe.js +4 -0
  99. package/lib/module/types/recipe.js.map +1 -0
  100. package/lib/module/types/renderer.js +27 -0
  101. package/lib/module/types/renderer.js.map +1 -0
  102. package/lib/module/types/token.js +2 -0
  103. package/lib/module/types/token.js.map +1 -0
  104. package/lib/typescript/package.json +1 -0
  105. package/lib/typescript/src/accessibility/index.d.ts +2 -0
  106. package/lib/typescript/src/accessibility/index.d.ts.map +1 -0
  107. package/lib/typescript/src/accessibility/policies.d.ts +13 -0
  108. package/lib/typescript/src/accessibility/policies.d.ts.map +1 -0
  109. package/lib/typescript/src/controls/brand.d.ts +2 -0
  110. package/lib/typescript/src/controls/brand.d.ts.map +1 -0
  111. package/lib/typescript/src/controls/controls.d.ts +28 -0
  112. package/lib/typescript/src/controls/controls.d.ts.map +1 -0
  113. package/lib/typescript/src/controls/descriptors.d.ts +14 -0
  114. package/lib/typescript/src/controls/descriptors.d.ts.map +1 -0
  115. package/lib/typescript/src/controls/index.d.ts +3 -0
  116. package/lib/typescript/src/controls/index.d.ts.map +1 -0
  117. package/lib/typescript/src/effects/compose.d.ts +11 -0
  118. package/lib/typescript/src/effects/compose.d.ts.map +1 -0
  119. package/lib/typescript/src/effects/fade.d.ts +10 -0
  120. package/lib/typescript/src/effects/fade.d.ts.map +1 -0
  121. package/lib/typescript/src/effects/index.d.ts +10 -0
  122. package/lib/typescript/src/effects/index.d.ts.map +1 -0
  123. package/lib/typescript/src/effects/lineReveal.d.ts +11 -0
  124. package/lib/typescript/src/effects/lineReveal.d.ts.map +1 -0
  125. package/lib/typescript/src/effects/pulse.d.ts +8 -0
  126. package/lib/typescript/src/effects/pulse.d.ts.map +1 -0
  127. package/lib/typescript/src/effects/rise.d.ts +8 -0
  128. package/lib/typescript/src/effects/rise.d.ts.map +1 -0
  129. package/lib/typescript/src/effects/scale.d.ts +10 -0
  130. package/lib/typescript/src/effects/scale.d.ts.map +1 -0
  131. package/lib/typescript/src/effects/shake.d.ts +8 -0
  132. package/lib/typescript/src/effects/shake.d.ts.map +1 -0
  133. package/lib/typescript/src/effects/slide.d.ts +10 -0
  134. package/lib/typescript/src/effects/slide.d.ts.map +1 -0
  135. package/lib/typescript/src/effects/typewriter.d.ts +13 -0
  136. package/lib/typescript/src/effects/typewriter.d.ts.map +1 -0
  137. package/lib/typescript/src/effects/validation.d.ts +2 -0
  138. package/lib/typescript/src/effects/validation.d.ts.map +1 -0
  139. package/lib/typescript/src/index.d.ts +15 -0
  140. package/lib/typescript/src/index.d.ts.map +1 -0
  141. package/lib/typescript/src/presets/index.d.ts +10 -0
  142. package/lib/typescript/src/presets/index.d.ts.map +1 -0
  143. package/lib/typescript/src/recipe/component.d.ts +3 -0
  144. package/lib/typescript/src/recipe/component.d.ts.map +1 -0
  145. package/lib/typescript/src/recipe/defineTextMotion.d.ts +4 -0
  146. package/lib/typescript/src/recipe/defineTextMotion.d.ts.map +1 -0
  147. package/lib/typescript/src/recipe/descriptors.d.ts +15 -0
  148. package/lib/typescript/src/recipe/descriptors.d.ts.map +1 -0
  149. package/lib/typescript/src/recipe/index.d.ts +4 -0
  150. package/lib/typescript/src/recipe/index.d.ts.map +1 -0
  151. package/lib/typescript/src/recipe/recipe.d.ts +67 -0
  152. package/lib/typescript/src/recipe/recipe.d.ts.map +1 -0
  153. package/lib/typescript/src/renderers/index.d.ts +3 -0
  154. package/lib/typescript/src/renderers/index.d.ts.map +1 -0
  155. package/lib/typescript/src/renderers/nativeText.d.ts +13 -0
  156. package/lib/typescript/src/renderers/nativeText.d.ts.map +1 -0
  157. package/lib/typescript/src/renderers/nativeTextControls.d.ts +16 -0
  158. package/lib/typescript/src/renderers/nativeTextControls.d.ts.map +1 -0
  159. package/lib/typescript/src/renderers/nativeTextLineLayout.d.ts +84 -0
  160. package/lib/typescript/src/renderers/nativeTextLineLayout.d.ts.map +1 -0
  161. package/lib/typescript/src/renderers/nativeTextPlayback.d.ts +21 -0
  162. package/lib/typescript/src/renderers/nativeTextPlayback.d.ts.map +1 -0
  163. package/lib/typescript/src/renderers/overlayText.d.ts +13 -0
  164. package/lib/typescript/src/renderers/overlayText.d.ts.map +1 -0
  165. package/lib/typescript/src/renderers/overlayTextLayout.d.ts +36 -0
  166. package/lib/typescript/src/renderers/overlayTextLayout.d.ts.map +1 -0
  167. package/lib/typescript/src/renderers/rendererMotion.d.ts +53 -0
  168. package/lib/typescript/src/renderers/rendererMotion.d.ts.map +1 -0
  169. package/lib/typescript/src/split/createToken.d.ts +11 -0
  170. package/lib/typescript/src/split/createToken.d.ts.map +1 -0
  171. package/lib/typescript/src/split/custom.d.ts +17 -0
  172. package/lib/typescript/src/split/custom.d.ts.map +1 -0
  173. package/lib/typescript/src/split/graphemes.d.ts +4 -0
  174. package/lib/typescript/src/split/graphemes.d.ts.map +1 -0
  175. package/lib/typescript/src/split/index.d.ts +5 -0
  176. package/lib/typescript/src/split/index.d.ts.map +1 -0
  177. package/lib/typescript/src/split/lines.d.ts +4 -0
  178. package/lib/typescript/src/split/lines.d.ts.map +1 -0
  179. package/lib/typescript/src/split/segmenter.d.ts +18 -0
  180. package/lib/typescript/src/split/segmenter.d.ts.map +1 -0
  181. package/lib/typescript/src/split/words.d.ts +4 -0
  182. package/lib/typescript/src/split/words.d.ts.map +1 -0
  183. package/lib/typescript/src/timeline/index.d.ts +5 -0
  184. package/lib/typescript/src/timeline/index.d.ts.map +1 -0
  185. package/lib/typescript/src/timeline/parallel.d.ts +4 -0
  186. package/lib/typescript/src/timeline/parallel.d.ts.map +1 -0
  187. package/lib/typescript/src/timeline/sequence.d.ts +4 -0
  188. package/lib/typescript/src/timeline/sequence.d.ts.map +1 -0
  189. package/lib/typescript/src/timeline/stagger.d.ts +11 -0
  190. package/lib/typescript/src/timeline/stagger.d.ts.map +1 -0
  191. package/lib/typescript/src/timeline/validation.d.ts +4 -0
  192. package/lib/typescript/src/timeline/validation.d.ts.map +1 -0
  193. package/lib/typescript/src/timeline/wave.d.ts +11 -0
  194. package/lib/typescript/src/timeline/wave.d.ts.map +1 -0
  195. package/lib/typescript/src/types/index.d.ts +6 -0
  196. package/lib/typescript/src/types/index.d.ts.map +1 -0
  197. package/lib/typescript/src/types/recipe.d.ts +123 -0
  198. package/lib/typescript/src/types/recipe.d.ts.map +1 -0
  199. package/lib/typescript/src/types/renderer.d.ts +51 -0
  200. package/lib/typescript/src/types/renderer.d.ts.map +1 -0
  201. package/lib/typescript/src/types/token.d.ts +35 -0
  202. package/lib/typescript/src/types/token.d.ts.map +1 -0
  203. package/package.json +117 -3
  204. package/src/accessibility/index.ts +7 -0
  205. package/src/accessibility/policies.ts +60 -0
  206. package/src/controls/brand.ts +3 -0
  207. package/src/controls/controls.ts +41 -0
  208. package/src/controls/descriptors.ts +83 -0
  209. package/src/controls/index.ts +2 -0
  210. package/src/effects/compose.ts +98 -0
  211. package/src/effects/fade.ts +22 -0
  212. package/src/effects/index.ts +9 -0
  213. package/src/effects/lineReveal.ts +28 -0
  214. package/src/effects/pulse.ts +19 -0
  215. package/src/effects/rise.ts +19 -0
  216. package/src/effects/scale.ts +22 -0
  217. package/src/effects/shake.ts +19 -0
  218. package/src/effects/slide.ts +22 -0
  219. package/src/effects/typewriter.ts +16 -0
  220. package/src/effects/validation.ts +9 -0
  221. package/src/index.tsx +46 -0
  222. package/src/presets/index.ts +42 -0
  223. package/src/recipe/component.tsx +88 -0
  224. package/src/recipe/defineTextMotion.ts +6 -0
  225. package/src/recipe/descriptors.ts +158 -0
  226. package/src/recipe/index.ts +3 -0
  227. package/src/recipe/recipe.ts +359 -0
  228. package/src/renderers/index.ts +2 -0
  229. package/src/renderers/nativeText.tsx +813 -0
  230. package/src/renderers/nativeTextControls.ts +131 -0
  231. package/src/renderers/nativeTextLineLayout.ts +495 -0
  232. package/src/renderers/nativeTextPlayback.ts +204 -0
  233. package/src/renderers/overlayText.tsx +945 -0
  234. package/src/renderers/overlayTextLayout.ts +312 -0
  235. package/src/renderers/rendererMotion.ts +483 -0
  236. package/src/split/createToken.ts +26 -0
  237. package/src/split/custom.ts +92 -0
  238. package/src/split/graphemes.ts +27 -0
  239. package/src/split/index.ts +9 -0
  240. package/src/split/lines.ts +35 -0
  241. package/src/split/segmenter.ts +111 -0
  242. package/src/split/words.ts +28 -0
  243. package/src/timeline/index.ts +4 -0
  244. package/src/timeline/parallel.ts +30 -0
  245. package/src/timeline/sequence.ts +29 -0
  246. package/src/timeline/stagger.ts +60 -0
  247. package/src/timeline/validation.ts +29 -0
  248. package/src/timeline/wave.ts +34 -0
  249. package/src/types/index.ts +34 -0
  250. package/src/types/recipe.ts +195 -0
  251. package/src/types/renderer.ts +91 -0
  252. package/src/types/token.ts +39 -0
@@ -0,0 +1,204 @@
1
+ import type { TextMotionMotionConfig } from '../types/recipe';
2
+ import type { TextMotionItemMotion, TextMotionStyleTransformState } from './rendererMotion';
3
+
4
+ export type NativeTextStyleState = TextMotionStyleTransformState;
5
+ export type NativeTextTokenMotion = TextMotionItemMotion;
6
+
7
+ type NativeTextMotionOptionSnapshotValue =
8
+ | null
9
+ | string
10
+ | number
11
+ | boolean
12
+ | symbol
13
+ | ((...args: never[]) => unknown)
14
+ | readonly NativeTextMotionOptionSnapshotValue[]
15
+ | { readonly [key: string]: NativeTextMotionOptionSnapshotValue };
16
+
17
+ type NativeTextMotionOptionsSnapshot = Readonly<
18
+ Record<string, NativeTextMotionOptionSnapshotValue>
19
+ >;
20
+
21
+ type NativeTextMotionSnapshot = {
22
+ kind: TextMotionMotionConfig['kind'];
23
+ options?: NativeTextMotionOptionsSnapshot;
24
+ };
25
+
26
+ export type NativeTextPlaybackRun = NativeTextTokenMotion & {
27
+ motionSnapshot?: NativeTextMotionSnapshot;
28
+ renderFinalState: boolean;
29
+ text: string;
30
+ };
31
+
32
+ function isNativeTextMotionOptionRecord(value: unknown): value is Record<string, unknown> {
33
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
34
+ }
35
+
36
+ function createMotionOptionSnapshotValue(value: unknown): NativeTextMotionOptionSnapshotValue {
37
+ // Reanimated config objects are compared structurally; function-valued options stay reference-sensitive.
38
+ if (Array.isArray(value)) {
39
+ return value.map(createMotionOptionSnapshotValue);
40
+ }
41
+
42
+ if (isNativeTextMotionOptionRecord(value)) {
43
+ return Object.fromEntries(
44
+ Object.entries(value).map(([key, nestedValue]) => [
45
+ key,
46
+ createMotionOptionSnapshotValue(nestedValue),
47
+ ]),
48
+ );
49
+ }
50
+
51
+ return value as NativeTextMotionOptionSnapshotValue;
52
+ }
53
+
54
+ function createMotionOptionsSnapshot(
55
+ options: TextMotionMotionConfig['options'],
56
+ ): NativeTextMotionOptionsSnapshot | undefined {
57
+ if (!options) {
58
+ return undefined;
59
+ }
60
+
61
+ return Object.fromEntries(
62
+ Object.entries(options).map(([key, value]) => [key, createMotionOptionSnapshotValue(value)]),
63
+ );
64
+ }
65
+
66
+ function createMotionSnapshot(
67
+ motion: TextMotionMotionConfig | undefined,
68
+ ): NativeTextMotionSnapshot | undefined {
69
+ if (!motion) {
70
+ return undefined;
71
+ }
72
+
73
+ return {
74
+ kind: motion.kind,
75
+ options: createMotionOptionsSnapshot(motion.options),
76
+ };
77
+ }
78
+
79
+ export function createNativeTextPlaybackRun(
80
+ tokenMotion: NativeTextTokenMotion,
81
+ renderFinalState: boolean,
82
+ text: string,
83
+ ): NativeTextPlaybackRun {
84
+ return {
85
+ ...tokenMotion,
86
+ motionSnapshot: createMotionSnapshot(tokenMotion.motion),
87
+ renderFinalState,
88
+ text,
89
+ };
90
+ }
91
+
92
+ function areNativeTextStyleStatesEqual(
93
+ left: NativeTextStyleState,
94
+ right: NativeTextStyleState,
95
+ ): boolean {
96
+ return (
97
+ Object.is(left.opacity, right.opacity) &&
98
+ Object.is(left.scale, right.scale) &&
99
+ Object.is(left.translateX, right.translateX) &&
100
+ Object.is(left.translateY, right.translateY)
101
+ );
102
+ }
103
+
104
+ function areMotionOptionsSnapshotsEqual(
105
+ left: NativeTextMotionOptionsSnapshot | undefined,
106
+ right: NativeTextMotionOptionsSnapshot | undefined,
107
+ ): boolean {
108
+ if (!left || !right) {
109
+ return left === right;
110
+ }
111
+
112
+ const leftKeys = Object.keys(left);
113
+ const rightKeys = Object.keys(right);
114
+
115
+ if (leftKeys.length !== rightKeys.length) {
116
+ return false;
117
+ }
118
+
119
+ return leftKeys.every(
120
+ (key) =>
121
+ Object.prototype.hasOwnProperty.call(right, key) &&
122
+ areMotionOptionSnapshotValuesEqual(left[key], right[key]),
123
+ );
124
+ }
125
+
126
+ function areMotionOptionArraysEqual(
127
+ left: readonly NativeTextMotionOptionSnapshotValue[],
128
+ right: readonly NativeTextMotionOptionSnapshotValue[],
129
+ ): boolean {
130
+ if (left.length !== right.length) {
131
+ return false;
132
+ }
133
+
134
+ return left.every((value, index) => areMotionOptionSnapshotValuesEqual(value, right[index]));
135
+ }
136
+
137
+ function areMotionOptionRecordsEqual(
138
+ left: { readonly [key: string]: NativeTextMotionOptionSnapshotValue },
139
+ right: { readonly [key: string]: NativeTextMotionOptionSnapshotValue },
140
+ ): boolean {
141
+ const leftKeys = Object.keys(left);
142
+ const rightKeys = Object.keys(right);
143
+
144
+ if (leftKeys.length !== rightKeys.length) {
145
+ return false;
146
+ }
147
+
148
+ return leftKeys.every(
149
+ (key) =>
150
+ Object.prototype.hasOwnProperty.call(right, key) &&
151
+ areMotionOptionSnapshotValuesEqual(left[key], right[key]),
152
+ );
153
+ }
154
+
155
+ function areMotionOptionSnapshotValuesEqual(
156
+ left: NativeTextMotionOptionSnapshotValue | undefined,
157
+ right: NativeTextMotionOptionSnapshotValue | undefined,
158
+ ): boolean {
159
+ if (Object.is(left, right)) {
160
+ return true;
161
+ }
162
+
163
+ if (Array.isArray(left) && Array.isArray(right)) {
164
+ return areMotionOptionArraysEqual(left, right);
165
+ }
166
+
167
+ if (isNativeTextMotionOptionRecord(left) && isNativeTextMotionOptionRecord(right)) {
168
+ return areMotionOptionRecordsEqual(left, right);
169
+ }
170
+
171
+ return false;
172
+ }
173
+
174
+ function areMotionSnapshotsEqual(
175
+ left: NativeTextMotionSnapshot | undefined,
176
+ right: NativeTextMotionSnapshot | undefined,
177
+ ): boolean {
178
+ if (!left || !right) {
179
+ return left === right;
180
+ }
181
+
182
+ return left.kind === right.kind && areMotionOptionsSnapshotsEqual(left.options, right.options);
183
+ }
184
+
185
+ export function areNativeTextPlaybackRunsEqual(
186
+ left: NativeTextPlaybackRun | undefined,
187
+ right: NativeTextPlaybackRun,
188
+ ): boolean {
189
+ if (!left) {
190
+ return false;
191
+ }
192
+
193
+ return (
194
+ Object.is(left.delayMs, right.delayMs) &&
195
+ Object.is(left.pulseScale, right.pulseScale) &&
196
+ left.reducedMotion === right.reducedMotion &&
197
+ left.revealOnStart === right.revealOnStart &&
198
+ left.renderFinalState === right.renderFinalState &&
199
+ left.text === right.text &&
200
+ areNativeTextStyleStatesEqual(left.initial, right.initial) &&
201
+ areNativeTextStyleStatesEqual(left.target, right.target) &&
202
+ areMotionSnapshotsEqual(left.motionSnapshot, right.motionSnapshot)
203
+ );
204
+ }