@twick/2d 0.14.0 → 1.14.3

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 (186) hide show
  1. package/LICENSE +21 -21
  2. package/editor/editor/tsconfig.build.tsbuildinfo +1 -1
  3. package/lib/components/Audio.d.ts.map +1 -1
  4. package/lib/components/Audio.js +33 -3
  5. package/lib/components/CodeBlock.d.ts +1 -1
  6. package/lib/components/Img.js +23 -23
  7. package/lib/components/Line.js +31 -31
  8. package/lib/components/Media.d.ts +6 -0
  9. package/lib/components/Media.d.ts.map +1 -1
  10. package/lib/components/Media.js +277 -61
  11. package/lib/components/Node.d.ts +1 -1
  12. package/lib/components/Path.d.ts +1 -1
  13. package/lib/components/SVG.d.ts +1 -1
  14. package/lib/components/Shape.d.ts +1 -1
  15. package/lib/components/Spline.js +25 -25
  16. package/lib/components/Video.d.ts +0 -1
  17. package/lib/components/Video.d.ts.map +1 -1
  18. package/lib/components/Video.js +70 -65
  19. package/lib/tsconfig.build.tsbuildinfo +1 -1
  20. package/package.json +4 -5
  21. package/src/editor/NodeInspectorConfig.tsx +76 -76
  22. package/src/editor/PreviewOverlayConfig.tsx +67 -67
  23. package/src/editor/Provider.tsx +93 -93
  24. package/src/editor/SceneGraphTabConfig.tsx +81 -81
  25. package/src/editor/icons/CircleIcon.tsx +7 -7
  26. package/src/editor/icons/CodeBlockIcon.tsx +8 -8
  27. package/src/editor/icons/CurveIcon.tsx +7 -7
  28. package/src/editor/icons/GridIcon.tsx +7 -7
  29. package/src/editor/icons/IconMap.ts +35 -35
  30. package/src/editor/icons/ImgIcon.tsx +8 -8
  31. package/src/editor/icons/LayoutIcon.tsx +9 -9
  32. package/src/editor/icons/LineIcon.tsx +7 -7
  33. package/src/editor/icons/NodeIcon.tsx +7 -7
  34. package/src/editor/icons/RayIcon.tsx +7 -7
  35. package/src/editor/icons/RectIcon.tsx +7 -7
  36. package/src/editor/icons/ShapeIcon.tsx +7 -7
  37. package/src/editor/icons/TxtIcon.tsx +8 -8
  38. package/src/editor/icons/VideoIcon.tsx +7 -7
  39. package/src/editor/icons/View2DIcon.tsx +10 -10
  40. package/src/editor/index.ts +17 -17
  41. package/src/editor/tree/DetachedRoot.tsx +23 -23
  42. package/src/editor/tree/NodeElement.tsx +74 -74
  43. package/src/editor/tree/TreeElement.tsx +72 -72
  44. package/src/editor/tree/TreeRoot.tsx +10 -10
  45. package/src/editor/tree/ViewRoot.tsx +20 -20
  46. package/src/editor/tree/index.module.scss +38 -38
  47. package/src/editor/tree/index.ts +3 -3
  48. package/src/editor/tsconfig.build.json +5 -5
  49. package/src/editor/tsconfig.json +12 -12
  50. package/src/editor/tsdoc.json +4 -4
  51. package/src/editor/vite-env.d.ts +1 -1
  52. package/src/lib/code/CodeCursor.ts +445 -445
  53. package/src/lib/code/CodeDiffer.ts +78 -78
  54. package/src/lib/code/CodeFragment.ts +97 -97
  55. package/src/lib/code/CodeHighlighter.ts +75 -75
  56. package/src/lib/code/CodeMetrics.ts +47 -47
  57. package/src/lib/code/CodeRange.test.ts +74 -74
  58. package/src/lib/code/CodeRange.ts +216 -216
  59. package/src/lib/code/CodeScope.ts +101 -101
  60. package/src/lib/code/CodeSelection.ts +24 -24
  61. package/src/lib/code/CodeSignal.ts +327 -327
  62. package/src/lib/code/CodeTokenizer.ts +54 -54
  63. package/src/lib/code/DefaultHighlightStyle.ts +98 -98
  64. package/src/lib/code/LezerHighlighter.ts +113 -113
  65. package/src/lib/code/diff.test.ts +311 -311
  66. package/src/lib/code/diff.ts +319 -319
  67. package/src/lib/code/extractRange.ts +126 -126
  68. package/src/lib/code/index.ts +13 -13
  69. package/src/lib/components/Audio.ts +168 -131
  70. package/src/lib/components/Bezier.ts +105 -105
  71. package/src/lib/components/Circle.ts +266 -266
  72. package/src/lib/components/Code.ts +526 -526
  73. package/src/lib/components/CodeBlock.ts +576 -576
  74. package/src/lib/components/CubicBezier.ts +112 -112
  75. package/src/lib/components/Curve.ts +455 -455
  76. package/src/lib/components/Grid.ts +135 -135
  77. package/src/lib/components/Icon.ts +96 -96
  78. package/src/lib/components/Img.ts +319 -319
  79. package/src/lib/components/Knot.ts +157 -157
  80. package/src/lib/components/Latex.ts +122 -122
  81. package/src/lib/components/Layout.ts +1092 -1092
  82. package/src/lib/components/Line.ts +429 -429
  83. package/src/lib/components/Media.ts +576 -346
  84. package/src/lib/components/Node.ts +1940 -1940
  85. package/src/lib/components/Path.ts +137 -137
  86. package/src/lib/components/Polygon.ts +171 -171
  87. package/src/lib/components/QuadBezier.ts +100 -100
  88. package/src/lib/components/Ray.ts +125 -125
  89. package/src/lib/components/Rect.ts +187 -187
  90. package/src/lib/components/Rive.ts +156 -156
  91. package/src/lib/components/SVG.ts +797 -797
  92. package/src/lib/components/Shape.ts +143 -143
  93. package/src/lib/components/Spline.ts +344 -344
  94. package/src/lib/components/Txt.test.tsx +81 -81
  95. package/src/lib/components/Txt.ts +203 -203
  96. package/src/lib/components/TxtLeaf.ts +205 -205
  97. package/src/lib/components/Video.ts +461 -462
  98. package/src/lib/components/View2D.ts +98 -98
  99. package/src/lib/components/__tests__/children.test.tsx +142 -142
  100. package/src/lib/components/__tests__/clone.test.tsx +126 -126
  101. package/src/lib/components/__tests__/generatorTest.ts +28 -28
  102. package/src/lib/components/__tests__/mockScene2D.ts +45 -45
  103. package/src/lib/components/__tests__/query.test.tsx +122 -122
  104. package/src/lib/components/__tests__/state.test.tsx +60 -60
  105. package/src/lib/components/index.ts +28 -28
  106. package/src/lib/components/types.ts +35 -35
  107. package/src/lib/curves/ArcSegment.ts +159 -159
  108. package/src/lib/curves/CircleSegment.ts +77 -77
  109. package/src/lib/curves/CubicBezierSegment.ts +78 -78
  110. package/src/lib/curves/CurveDrawingInfo.ts +11 -11
  111. package/src/lib/curves/CurvePoint.ts +15 -15
  112. package/src/lib/curves/CurveProfile.ts +7 -7
  113. package/src/lib/curves/KnotInfo.ts +10 -10
  114. package/src/lib/curves/LineSegment.ts +62 -62
  115. package/src/lib/curves/Polynomial.ts +355 -355
  116. package/src/lib/curves/Polynomial2D.ts +62 -62
  117. package/src/lib/curves/PolynomialSegment.ts +124 -124
  118. package/src/lib/curves/QuadBezierSegment.ts +64 -64
  119. package/src/lib/curves/Segment.ts +17 -17
  120. package/src/lib/curves/UniformPolynomialCurveSampler.ts +94 -94
  121. package/src/lib/curves/createCurveProfileLerp.ts +471 -471
  122. package/src/lib/curves/getBezierSplineProfile.ts +223 -223
  123. package/src/lib/curves/getCircleProfile.ts +86 -86
  124. package/src/lib/curves/getPathProfile.ts +178 -178
  125. package/src/lib/curves/getPointAtDistance.ts +21 -21
  126. package/src/lib/curves/getPolylineProfile.test.ts +21 -21
  127. package/src/lib/curves/getPolylineProfile.ts +89 -89
  128. package/src/lib/curves/getRectProfile.ts +139 -139
  129. package/src/lib/curves/index.ts +16 -16
  130. package/src/lib/decorators/canvasStyleSignal.ts +16 -16
  131. package/src/lib/decorators/colorSignal.ts +9 -9
  132. package/src/lib/decorators/compound.ts +72 -72
  133. package/src/lib/decorators/computed.ts +18 -18
  134. package/src/lib/decorators/defaultStyle.ts +18 -18
  135. package/src/lib/decorators/filtersSignal.ts +136 -136
  136. package/src/lib/decorators/index.ts +10 -10
  137. package/src/lib/decorators/initializers.ts +32 -32
  138. package/src/lib/decorators/nodeName.ts +13 -13
  139. package/src/lib/decorators/signal.test.ts +90 -90
  140. package/src/lib/decorators/signal.ts +345 -345
  141. package/src/lib/decorators/spacingSignal.ts +15 -15
  142. package/src/lib/decorators/vector2Signal.ts +30 -30
  143. package/src/lib/globals.d.ts +2 -2
  144. package/src/lib/index.ts +8 -8
  145. package/src/lib/jsx-dev-runtime.ts +2 -2
  146. package/src/lib/jsx-runtime.ts +46 -46
  147. package/src/lib/parse-svg-path.d.ts +14 -14
  148. package/src/lib/partials/Filter.ts +180 -180
  149. package/src/lib/partials/Gradient.ts +102 -102
  150. package/src/lib/partials/Pattern.ts +34 -34
  151. package/src/lib/partials/ShaderConfig.ts +117 -117
  152. package/src/lib/partials/index.ts +4 -4
  153. package/src/lib/partials/types.ts +58 -58
  154. package/src/lib/scenes/Scene2D.ts +242 -242
  155. package/src/lib/scenes/index.ts +3 -3
  156. package/src/lib/scenes/makeScene2D.ts +16 -16
  157. package/src/lib/scenes/useScene2D.ts +6 -6
  158. package/src/lib/tsconfig.build.json +5 -5
  159. package/src/lib/tsconfig.json +10 -10
  160. package/src/lib/tsdoc.json +4 -4
  161. package/src/lib/utils/CanvasUtils.ts +306 -306
  162. package/src/lib/utils/diff.test.ts +453 -453
  163. package/src/lib/utils/diff.ts +148 -148
  164. package/src/lib/utils/index.ts +2 -2
  165. package/src/lib/utils/is.ts +11 -11
  166. package/src/lib/utils/makeSignalExtensions.ts +30 -30
  167. package/src/lib/utils/video/declarations.d.ts +1 -1
  168. package/src/lib/utils/video/ffmpeg-client.ts +50 -50
  169. package/src/lib/utils/video/mp4-parser-manager.ts +72 -72
  170. package/src/lib/utils/video/parser/index.ts +1 -1
  171. package/src/lib/utils/video/parser/parser.ts +257 -257
  172. package/src/lib/utils/video/parser/sampler.ts +72 -72
  173. package/src/lib/utils/video/parser/segment.ts +302 -302
  174. package/src/lib/utils/video/parser/sink.ts +29 -29
  175. package/src/lib/utils/video/parser/utils.ts +31 -31
  176. package/src/tsconfig.base.json +19 -19
  177. package/src/tsconfig.build.json +8 -8
  178. package/src/tsconfig.json +5 -5
  179. package/tsconfig.project.json +7 -7
  180. package/lib/components/utils/waitUntil.d.ts +0 -7
  181. package/lib/components/utils/waitUntil.d.ts.map +0 -1
  182. package/lib/components/utils/waitUntil.js +0 -15
  183. package/lib/utils/waitUntil.d.ts +0 -7
  184. package/lib/utils/waitUntil.d.ts.map +0 -1
  185. package/lib/utils/waitUntil.js +0 -15
  186. package/src/lib/utils/waitUntil.ts +0 -18
@@ -1,445 +1,445 @@
1
- import type {SerializedVector2} from '@twick/core';
2
- import {clampRemap, Color, map, unwrap, Vector2} from '@twick/core';
3
- import type {Code} from '../components';
4
- import type {CodeFragment} from './CodeFragment';
5
- import {parseCodeFragment} from './CodeFragment';
6
- import type {CodeHighlighter} from './CodeHighlighter';
7
- import type {CodeMetrics} from './CodeMetrics';
8
- import type {CodePoint, CodeRange} from './CodeRange';
9
- import type {CodeScope} from './CodeScope';
10
- import {isCodeScope} from './CodeScope';
11
- import {isPointInCodeSelection} from './CodeSelection';
12
-
13
- export interface CodeFragmentDrawingInfo {
14
- text: string;
15
- position: Vector2;
16
- characterSize: Vector2;
17
- cursor: Vector2;
18
- fill: string;
19
- time: number;
20
- alpha: number;
21
- }
22
-
23
- /**
24
- * A stateful class for recursively traversing a code scope.
25
- *
26
- * @internal
27
- */
28
- export class CodeCursor {
29
- public cursor = new Vector2();
30
- public beforeCursor = new Vector2();
31
- public afterCursor = new Vector2();
32
- public beforeIndex = 0;
33
- public afterIndex = 0;
34
- private context = {} as CanvasRenderingContext2D;
35
- private monoWidth = 0;
36
- private maxWidth = 0;
37
- private lineHeight = 0;
38
- private fallbackFill = new Color('white');
39
- private caches: {before: unknown; after: unknown} | null = null;
40
- private highlighter: CodeHighlighter | null = null;
41
- private selection: CodeRange[] = [];
42
- private selectionProgress: number | null = null;
43
- private globalProgress: number[] = [];
44
- private fragmentDrawingInfo: CodeFragmentDrawingInfo[] = [];
45
- private fontHeight = 0;
46
- private verticalOffset = 0;
47
-
48
- public constructor(private readonly node: Code) {}
49
-
50
- /**
51
- * Prepare the cursor for the next traversal.
52
- *
53
- * @param context - The context used to measure and draw the code.
54
- */
55
- public setupMeasure(context: CanvasRenderingContext2D) {
56
- const metrics = context.measureText('X');
57
- this.monoWidth = metrics.width;
58
- this.fontHeight =
59
- metrics.fontBoundingBoxDescent + metrics.fontBoundingBoxAscent;
60
- this.verticalOffset = metrics.fontBoundingBoxAscent;
61
- this.context = context;
62
- this.lineHeight = parseFloat(this.node.styles.lineHeight);
63
- this.cursor = new Vector2();
64
- this.beforeCursor = new Vector2();
65
- this.afterCursor = new Vector2();
66
- this.beforeIndex = 0;
67
- this.afterIndex = 0;
68
- this.maxWidth = 0;
69
- }
70
-
71
- public setupDraw(context: CanvasRenderingContext2D) {
72
- this.setupMeasure(context);
73
- const fill = this.node.fill();
74
- this.fallbackFill =
75
- fill instanceof Color ? (fill as Color) : new Color('white');
76
- this.caches = this.node.highlighterCache();
77
- this.highlighter = this.node.highlighter();
78
- this.selection = this.node.selection();
79
- this.selectionProgress = this.node.selectionProgress();
80
- this.fragmentDrawingInfo = [];
81
- this.globalProgress = [];
82
- }
83
-
84
- /**
85
- * Measure the desired size of the code scope.
86
- *
87
- * @remarks
88
- * The result can be retrieved with {@link getSize}.
89
- *
90
- * @param scope - The code scope to measure.
91
- */
92
- public measureSize(scope: CodeScope) {
93
- const progress = unwrap(scope.progress);
94
- for (const wrapped of scope.fragments) {
95
- const possibleFragment = unwrap(wrapped);
96
- if (isCodeScope(possibleFragment)) {
97
- this.measureSize(possibleFragment);
98
- continue;
99
- }
100
- if (Array.isArray(possibleFragment)) {
101
- this.measureSize({
102
- progress: scope.progress,
103
- fragments: possibleFragment,
104
- });
105
- continue;
106
- }
107
-
108
- const fragment = parseCodeFragment(
109
- possibleFragment,
110
- this.context,
111
- this.monoWidth,
112
- );
113
-
114
- const beforeMaxWidth = this.calculateMaxWidth(fragment.before);
115
- const afterMaxWidth = this.calculateMaxWidth(fragment.after);
116
-
117
- const maxWidth = map(beforeMaxWidth, afterMaxWidth, progress);
118
- if (maxWidth > this.maxWidth) {
119
- this.maxWidth = maxWidth;
120
- }
121
-
122
- const beforeEnd = this.calculateWidth(fragment.before);
123
- const afterEnd = this.calculateWidth(fragment.after);
124
- this.cursor.x = map(beforeEnd, afterEnd, progress);
125
-
126
- if (this.cursor.y === 0) {
127
- this.cursor.y = 1;
128
- }
129
-
130
- this.cursor.y += map(
131
- fragment.before.newRows,
132
- fragment.after.newRows,
133
- progress,
134
- );
135
- }
136
- }
137
-
138
- /**
139
- * Get the size measured by the cursor.
140
- */
141
- public getSize() {
142
- return {
143
- x: this.maxWidth * this.monoWidth,
144
- y: this.cursor.y * this.lineHeight + this.verticalOffset,
145
- };
146
- }
147
-
148
- /**
149
- * Get the drawing information created by the cursor.
150
- */
151
- public getDrawingInfo() {
152
- return {
153
- fragments: this.fragmentDrawingInfo,
154
- verticalOffset: this.verticalOffset,
155
- fontHeight: this.fontHeight,
156
- };
157
- }
158
-
159
- /**
160
- * Draw the given code scope.
161
- *
162
- * @param scope - The code scope to draw.
163
- */
164
- public drawScope(scope: CodeScope) {
165
- const progress = unwrap(scope.progress);
166
- for (const wrappedFragment of scope.fragments) {
167
- const possibleFragment = unwrap(wrappedFragment);
168
- if (isCodeScope(possibleFragment)) {
169
- this.drawScope(possibleFragment);
170
- continue;
171
- }
172
- if (Array.isArray(possibleFragment)) {
173
- this.drawScope({
174
- progress: scope.progress,
175
- fragments: possibleFragment,
176
- });
177
- continue;
178
- }
179
-
180
- const fragment = parseCodeFragment(
181
- possibleFragment,
182
- this.context,
183
- this.monoWidth,
184
- );
185
- const timingOffset = 0.8;
186
- let alpha = 1;
187
- let offsetY = 0;
188
- if (fragment.before.content !== fragment.after.content) {
189
- const mirrored = Math.abs(progress - 0.5) * 2;
190
- alpha = clampRemap(1, 1 - timingOffset, 1, 0, mirrored);
191
-
192
- const scale = progress < 0.5 ? 4 : -4;
193
- offsetY = map(
194
- Math.abs(fragment.after.newRows - fragment.before.newRows) / scale,
195
- 0,
196
- mirrored,
197
- );
198
- }
199
-
200
- this.drawToken(fragment, scope, this.cursor.addY(offsetY), alpha);
201
-
202
- this.beforeCursor.x = this.calculateWidth(
203
- fragment.before,
204
- this.beforeCursor.x,
205
- );
206
- this.afterCursor.x = this.calculateWidth(
207
- fragment.after,
208
- this.afterCursor.x,
209
- );
210
- this.beforeCursor.y += fragment.before.newRows;
211
- this.afterCursor.y += fragment.after.newRows;
212
-
213
- this.beforeIndex += fragment.before.content.length;
214
- this.afterIndex += fragment.after.content.length;
215
-
216
- this.cursor.y += map(
217
- fragment.before.newRows,
218
- fragment.after.newRows,
219
- progress,
220
- );
221
-
222
- const beforeEnd = this.calculateWidth(fragment.before);
223
- const afterEnd = this.calculateWidth(fragment.after);
224
- this.cursor.x = map(beforeEnd, afterEnd, progress);
225
- }
226
- }
227
-
228
- private drawToken(
229
- fragment: CodeFragment,
230
- scope: CodeScope,
231
- offset: SerializedVector2,
232
- alpha: number,
233
- ) {
234
- const progress = unwrap(scope.progress);
235
- const currentProgress = this.currentProgress();
236
- if (progress > 0) {
237
- this.globalProgress.push(progress);
238
- }
239
-
240
- const code = progress < 0.5 ? fragment.before : fragment.after;
241
-
242
- let hasOffset = true;
243
- let width = 0;
244
- let stringLength = 0;
245
- let y = 0;
246
- for (let i = 0; i < code.content.length; i++) {
247
- let color = this.fallbackFill.serialize();
248
- let char = code.content.charAt(i);
249
- const selection: {before: number | null; after: number | null} = {
250
- before: null,
251
- after: null,
252
- };
253
-
254
- if (char === '\n') {
255
- y++;
256
- hasOffset = false;
257
- width = 0;
258
- stringLength = 0;
259
- selection.before = null;
260
- selection.after = null;
261
- continue;
262
- }
263
-
264
- const beforeHighlight =
265
- this.caches &&
266
- this.highlighter?.highlight(this.beforeIndex + i, this.caches.before);
267
- const afterHighlight =
268
- this.caches &&
269
- this.highlighter?.highlight(this.afterIndex + i, this.caches.after);
270
-
271
- const highlight = progress < 0.5 ? beforeHighlight : afterHighlight;
272
- if (highlight) {
273
- // Handle edge cases where the highlight style changes despite the
274
- // content being the same. The code doesn't fade in and out so the color
275
- // has to be interpolated to avoid jarring changes.
276
- if (
277
- fragment.before.content === fragment.after.content &&
278
- beforeHighlight?.color !== afterHighlight?.color
279
- ) {
280
- highlight.color = Color.lerp(
281
- beforeHighlight?.color ?? this.fallbackFill,
282
- afterHighlight?.color ?? this.fallbackFill,
283
- progress,
284
- ).serialize();
285
- }
286
-
287
- if (highlight.color) {
288
- color = highlight.color;
289
- }
290
-
291
- let skipAhead = 0;
292
- do {
293
- if (
294
- this.processSelection(
295
- selection,
296
- skipAhead,
297
- hasOffset,
298
- stringLength,
299
- y,
300
- )
301
- ) {
302
- break;
303
- }
304
-
305
- skipAhead++;
306
- } while (skipAhead < highlight.skipAhead);
307
-
308
- if (skipAhead > 1) {
309
- char = code.content.slice(i, i + skipAhead);
310
- }
311
-
312
- i += char.length - 1;
313
- } else {
314
- this.processSelection(selection, 0, hasOffset, stringLength, y);
315
- let skipAhead = 1;
316
- while (
317
- i < code.content.length - 1 &&
318
- code.content.charAt(i + 1) !== '\n'
319
- ) {
320
- if (
321
- this.processSelection(
322
- selection,
323
- skipAhead,
324
- hasOffset,
325
- stringLength,
326
- y,
327
- )
328
- ) {
329
- break;
330
- }
331
-
332
- skipAhead++;
333
- char += code.content.charAt(++i);
334
- }
335
- }
336
-
337
- let time: number;
338
- const selectionAfter = selection.after ?? 0;
339
- const selectionBefore = selection.before ?? 0;
340
- if (fragment.before.content === '') {
341
- time = selectionAfter;
342
- } else if (fragment.after.content === '') {
343
- time = selectionBefore;
344
- } else {
345
- time = map(
346
- selectionBefore,
347
- selectionAfter,
348
- this.selectionProgress ?? currentProgress,
349
- );
350
- }
351
-
352
- const measure = this.context.measureText(char);
353
- this.fragmentDrawingInfo.push({
354
- text: char,
355
- position: new Vector2(
356
- (hasOffset ? offset.x + width : width) * this.monoWidth,
357
- (offset.y + y) * this.lineHeight,
358
- ),
359
- cursor: new Vector2(
360
- hasOffset ? this.beforeCursor.x + stringLength : stringLength,
361
- this.beforeCursor.y + y,
362
- ),
363
- alpha,
364
- characterSize: new Vector2(
365
- measure.width / char.length,
366
- this.fontHeight,
367
- ),
368
- fill: color,
369
- time,
370
- });
371
-
372
- stringLength += char.length;
373
- width += Math.round(measure.width / this.monoWidth);
374
- }
375
- }
376
-
377
- private calculateWidth(metrics: CodeMetrics, x = this.cursor.x): number {
378
- return metrics.newRows === 0 ? x + metrics.lastWidth : metrics.lastWidth;
379
- }
380
-
381
- private calculateMaxWidth(metrics: CodeMetrics, x = this.cursor.x): number {
382
- return Math.max(this.maxWidth, metrics.maxWidth, x + metrics.firstWidth);
383
- }
384
-
385
- private currentProgress() {
386
- if (this.globalProgress.length === 0) {
387
- return 0;
388
- }
389
-
390
- let sum = 0;
391
- for (const progress of this.globalProgress) {
392
- sum += progress;
393
- }
394
-
395
- return sum / this.globalProgress.length;
396
- }
397
-
398
- private processSelection(
399
- selection: {before: number | null; after: number | null},
400
- skipAhead: number,
401
- hasOffset: boolean,
402
- stringLength: number,
403
- y: number,
404
- ): boolean {
405
- let shouldBreak = false;
406
- let currentSelected = this.isSelected(
407
- (hasOffset ? this.beforeCursor.x + stringLength : stringLength) +
408
- skipAhead,
409
- this.beforeCursor.y + y,
410
- );
411
- if (selection.before !== null && selection.before !== currentSelected) {
412
- shouldBreak = true;
413
- } else {
414
- selection.before = currentSelected;
415
- }
416
-
417
- currentSelected = this.isSelected(
418
- (hasOffset ? this.afterCursor.x + stringLength : stringLength) +
419
- skipAhead,
420
- this.afterCursor.y + y,
421
- true,
422
- );
423
- if (selection.after !== null && selection.after !== currentSelected) {
424
- shouldBreak = true;
425
- } else {
426
- selection.after = currentSelected;
427
- }
428
-
429
- return shouldBreak;
430
- }
431
-
432
- private isSelected(x: number, y: number, isAfter?: boolean): number {
433
- const point: CodePoint = [y, x];
434
- const maxSelection = isPointInCodeSelection(point, this.selection) ? 1 : 0;
435
- if (this.node.oldSelection === null || this.selectionProgress === null) {
436
- return maxSelection;
437
- }
438
-
439
- if (isAfter) {
440
- return maxSelection;
441
- }
442
-
443
- return isPointInCodeSelection(point, this.node.oldSelection) ? 1 : 0;
444
- }
445
- }
1
+ import type {SerializedVector2} from '@twick/core';
2
+ import {clampRemap, Color, map, unwrap, Vector2} from '@twick/core';
3
+ import type {Code} from '../components';
4
+ import type {CodeFragment} from './CodeFragment';
5
+ import {parseCodeFragment} from './CodeFragment';
6
+ import type {CodeHighlighter} from './CodeHighlighter';
7
+ import type {CodeMetrics} from './CodeMetrics';
8
+ import type {CodePoint, CodeRange} from './CodeRange';
9
+ import type {CodeScope} from './CodeScope';
10
+ import {isCodeScope} from './CodeScope';
11
+ import {isPointInCodeSelection} from './CodeSelection';
12
+
13
+ export interface CodeFragmentDrawingInfo {
14
+ text: string;
15
+ position: Vector2;
16
+ characterSize: Vector2;
17
+ cursor: Vector2;
18
+ fill: string;
19
+ time: number;
20
+ alpha: number;
21
+ }
22
+
23
+ /**
24
+ * A stateful class for recursively traversing a code scope.
25
+ *
26
+ * @internal
27
+ */
28
+ export class CodeCursor {
29
+ public cursor = new Vector2();
30
+ public beforeCursor = new Vector2();
31
+ public afterCursor = new Vector2();
32
+ public beforeIndex = 0;
33
+ public afterIndex = 0;
34
+ private context = {} as CanvasRenderingContext2D;
35
+ private monoWidth = 0;
36
+ private maxWidth = 0;
37
+ private lineHeight = 0;
38
+ private fallbackFill = new Color('white');
39
+ private caches: {before: unknown; after: unknown} | null = null;
40
+ private highlighter: CodeHighlighter | null = null;
41
+ private selection: CodeRange[] = [];
42
+ private selectionProgress: number | null = null;
43
+ private globalProgress: number[] = [];
44
+ private fragmentDrawingInfo: CodeFragmentDrawingInfo[] = [];
45
+ private fontHeight = 0;
46
+ private verticalOffset = 0;
47
+
48
+ public constructor(private readonly node: Code) {}
49
+
50
+ /**
51
+ * Prepare the cursor for the next traversal.
52
+ *
53
+ * @param context - The context used to measure and draw the code.
54
+ */
55
+ public setupMeasure(context: CanvasRenderingContext2D) {
56
+ const metrics = context.measureText('X');
57
+ this.monoWidth = metrics.width;
58
+ this.fontHeight =
59
+ metrics.fontBoundingBoxDescent + metrics.fontBoundingBoxAscent;
60
+ this.verticalOffset = metrics.fontBoundingBoxAscent;
61
+ this.context = context;
62
+ this.lineHeight = parseFloat(this.node.styles.lineHeight);
63
+ this.cursor = new Vector2();
64
+ this.beforeCursor = new Vector2();
65
+ this.afterCursor = new Vector2();
66
+ this.beforeIndex = 0;
67
+ this.afterIndex = 0;
68
+ this.maxWidth = 0;
69
+ }
70
+
71
+ public setupDraw(context: CanvasRenderingContext2D) {
72
+ this.setupMeasure(context);
73
+ const fill = this.node.fill();
74
+ this.fallbackFill =
75
+ fill instanceof Color ? (fill as Color) : new Color('white');
76
+ this.caches = this.node.highlighterCache();
77
+ this.highlighter = this.node.highlighter();
78
+ this.selection = this.node.selection();
79
+ this.selectionProgress = this.node.selectionProgress();
80
+ this.fragmentDrawingInfo = [];
81
+ this.globalProgress = [];
82
+ }
83
+
84
+ /**
85
+ * Measure the desired size of the code scope.
86
+ *
87
+ * @remarks
88
+ * The result can be retrieved with {@link getSize}.
89
+ *
90
+ * @param scope - The code scope to measure.
91
+ */
92
+ public measureSize(scope: CodeScope) {
93
+ const progress = unwrap(scope.progress);
94
+ for (const wrapped of scope.fragments) {
95
+ const possibleFragment = unwrap(wrapped);
96
+ if (isCodeScope(possibleFragment)) {
97
+ this.measureSize(possibleFragment);
98
+ continue;
99
+ }
100
+ if (Array.isArray(possibleFragment)) {
101
+ this.measureSize({
102
+ progress: scope.progress,
103
+ fragments: possibleFragment,
104
+ });
105
+ continue;
106
+ }
107
+
108
+ const fragment = parseCodeFragment(
109
+ possibleFragment,
110
+ this.context,
111
+ this.monoWidth,
112
+ );
113
+
114
+ const beforeMaxWidth = this.calculateMaxWidth(fragment.before);
115
+ const afterMaxWidth = this.calculateMaxWidth(fragment.after);
116
+
117
+ const maxWidth = map(beforeMaxWidth, afterMaxWidth, progress);
118
+ if (maxWidth > this.maxWidth) {
119
+ this.maxWidth = maxWidth;
120
+ }
121
+
122
+ const beforeEnd = this.calculateWidth(fragment.before);
123
+ const afterEnd = this.calculateWidth(fragment.after);
124
+ this.cursor.x = map(beforeEnd, afterEnd, progress);
125
+
126
+ if (this.cursor.y === 0) {
127
+ this.cursor.y = 1;
128
+ }
129
+
130
+ this.cursor.y += map(
131
+ fragment.before.newRows,
132
+ fragment.after.newRows,
133
+ progress,
134
+ );
135
+ }
136
+ }
137
+
138
+ /**
139
+ * Get the size measured by the cursor.
140
+ */
141
+ public getSize() {
142
+ return {
143
+ x: this.maxWidth * this.monoWidth,
144
+ y: this.cursor.y * this.lineHeight + this.verticalOffset,
145
+ };
146
+ }
147
+
148
+ /**
149
+ * Get the drawing information created by the cursor.
150
+ */
151
+ public getDrawingInfo() {
152
+ return {
153
+ fragments: this.fragmentDrawingInfo,
154
+ verticalOffset: this.verticalOffset,
155
+ fontHeight: this.fontHeight,
156
+ };
157
+ }
158
+
159
+ /**
160
+ * Draw the given code scope.
161
+ *
162
+ * @param scope - The code scope to draw.
163
+ */
164
+ public drawScope(scope: CodeScope) {
165
+ const progress = unwrap(scope.progress);
166
+ for (const wrappedFragment of scope.fragments) {
167
+ const possibleFragment = unwrap(wrappedFragment);
168
+ if (isCodeScope(possibleFragment)) {
169
+ this.drawScope(possibleFragment);
170
+ continue;
171
+ }
172
+ if (Array.isArray(possibleFragment)) {
173
+ this.drawScope({
174
+ progress: scope.progress,
175
+ fragments: possibleFragment,
176
+ });
177
+ continue;
178
+ }
179
+
180
+ const fragment = parseCodeFragment(
181
+ possibleFragment,
182
+ this.context,
183
+ this.monoWidth,
184
+ );
185
+ const timingOffset = 0.8;
186
+ let alpha = 1;
187
+ let offsetY = 0;
188
+ if (fragment.before.content !== fragment.after.content) {
189
+ const mirrored = Math.abs(progress - 0.5) * 2;
190
+ alpha = clampRemap(1, 1 - timingOffset, 1, 0, mirrored);
191
+
192
+ const scale = progress < 0.5 ? 4 : -4;
193
+ offsetY = map(
194
+ Math.abs(fragment.after.newRows - fragment.before.newRows) / scale,
195
+ 0,
196
+ mirrored,
197
+ );
198
+ }
199
+
200
+ this.drawToken(fragment, scope, this.cursor.addY(offsetY), alpha);
201
+
202
+ this.beforeCursor.x = this.calculateWidth(
203
+ fragment.before,
204
+ this.beforeCursor.x,
205
+ );
206
+ this.afterCursor.x = this.calculateWidth(
207
+ fragment.after,
208
+ this.afterCursor.x,
209
+ );
210
+ this.beforeCursor.y += fragment.before.newRows;
211
+ this.afterCursor.y += fragment.after.newRows;
212
+
213
+ this.beforeIndex += fragment.before.content.length;
214
+ this.afterIndex += fragment.after.content.length;
215
+
216
+ this.cursor.y += map(
217
+ fragment.before.newRows,
218
+ fragment.after.newRows,
219
+ progress,
220
+ );
221
+
222
+ const beforeEnd = this.calculateWidth(fragment.before);
223
+ const afterEnd = this.calculateWidth(fragment.after);
224
+ this.cursor.x = map(beforeEnd, afterEnd, progress);
225
+ }
226
+ }
227
+
228
+ private drawToken(
229
+ fragment: CodeFragment,
230
+ scope: CodeScope,
231
+ offset: SerializedVector2,
232
+ alpha: number,
233
+ ) {
234
+ const progress = unwrap(scope.progress);
235
+ const currentProgress = this.currentProgress();
236
+ if (progress > 0) {
237
+ this.globalProgress.push(progress);
238
+ }
239
+
240
+ const code = progress < 0.5 ? fragment.before : fragment.after;
241
+
242
+ let hasOffset = true;
243
+ let width = 0;
244
+ let stringLength = 0;
245
+ let y = 0;
246
+ for (let i = 0; i < code.content.length; i++) {
247
+ let color = this.fallbackFill.serialize();
248
+ let char = code.content.charAt(i);
249
+ const selection: {before: number | null; after: number | null} = {
250
+ before: null,
251
+ after: null,
252
+ };
253
+
254
+ if (char === '\n') {
255
+ y++;
256
+ hasOffset = false;
257
+ width = 0;
258
+ stringLength = 0;
259
+ selection.before = null;
260
+ selection.after = null;
261
+ continue;
262
+ }
263
+
264
+ const beforeHighlight =
265
+ this.caches &&
266
+ this.highlighter?.highlight(this.beforeIndex + i, this.caches.before);
267
+ const afterHighlight =
268
+ this.caches &&
269
+ this.highlighter?.highlight(this.afterIndex + i, this.caches.after);
270
+
271
+ const highlight = progress < 0.5 ? beforeHighlight : afterHighlight;
272
+ if (highlight) {
273
+ // Handle edge cases where the highlight style changes despite the
274
+ // content being the same. The code doesn't fade in and out so the color
275
+ // has to be interpolated to avoid jarring changes.
276
+ if (
277
+ fragment.before.content === fragment.after.content &&
278
+ beforeHighlight?.color !== afterHighlight?.color
279
+ ) {
280
+ highlight.color = Color.lerp(
281
+ beforeHighlight?.color ?? this.fallbackFill,
282
+ afterHighlight?.color ?? this.fallbackFill,
283
+ progress,
284
+ ).serialize();
285
+ }
286
+
287
+ if (highlight.color) {
288
+ color = highlight.color;
289
+ }
290
+
291
+ let skipAhead = 0;
292
+ do {
293
+ if (
294
+ this.processSelection(
295
+ selection,
296
+ skipAhead,
297
+ hasOffset,
298
+ stringLength,
299
+ y,
300
+ )
301
+ ) {
302
+ break;
303
+ }
304
+
305
+ skipAhead++;
306
+ } while (skipAhead < highlight.skipAhead);
307
+
308
+ if (skipAhead > 1) {
309
+ char = code.content.slice(i, i + skipAhead);
310
+ }
311
+
312
+ i += char.length - 1;
313
+ } else {
314
+ this.processSelection(selection, 0, hasOffset, stringLength, y);
315
+ let skipAhead = 1;
316
+ while (
317
+ i < code.content.length - 1 &&
318
+ code.content.charAt(i + 1) !== '\n'
319
+ ) {
320
+ if (
321
+ this.processSelection(
322
+ selection,
323
+ skipAhead,
324
+ hasOffset,
325
+ stringLength,
326
+ y,
327
+ )
328
+ ) {
329
+ break;
330
+ }
331
+
332
+ skipAhead++;
333
+ char += code.content.charAt(++i);
334
+ }
335
+ }
336
+
337
+ let time: number;
338
+ const selectionAfter = selection.after ?? 0;
339
+ const selectionBefore = selection.before ?? 0;
340
+ if (fragment.before.content === '') {
341
+ time = selectionAfter;
342
+ } else if (fragment.after.content === '') {
343
+ time = selectionBefore;
344
+ } else {
345
+ time = map(
346
+ selectionBefore,
347
+ selectionAfter,
348
+ this.selectionProgress ?? currentProgress,
349
+ );
350
+ }
351
+
352
+ const measure = this.context.measureText(char);
353
+ this.fragmentDrawingInfo.push({
354
+ text: char,
355
+ position: new Vector2(
356
+ (hasOffset ? offset.x + width : width) * this.monoWidth,
357
+ (offset.y + y) * this.lineHeight,
358
+ ),
359
+ cursor: new Vector2(
360
+ hasOffset ? this.beforeCursor.x + stringLength : stringLength,
361
+ this.beforeCursor.y + y,
362
+ ),
363
+ alpha,
364
+ characterSize: new Vector2(
365
+ measure.width / char.length,
366
+ this.fontHeight,
367
+ ),
368
+ fill: color,
369
+ time,
370
+ });
371
+
372
+ stringLength += char.length;
373
+ width += Math.round(measure.width / this.monoWidth);
374
+ }
375
+ }
376
+
377
+ private calculateWidth(metrics: CodeMetrics, x = this.cursor.x): number {
378
+ return metrics.newRows === 0 ? x + metrics.lastWidth : metrics.lastWidth;
379
+ }
380
+
381
+ private calculateMaxWidth(metrics: CodeMetrics, x = this.cursor.x): number {
382
+ return Math.max(this.maxWidth, metrics.maxWidth, x + metrics.firstWidth);
383
+ }
384
+
385
+ private currentProgress() {
386
+ if (this.globalProgress.length === 0) {
387
+ return 0;
388
+ }
389
+
390
+ let sum = 0;
391
+ for (const progress of this.globalProgress) {
392
+ sum += progress;
393
+ }
394
+
395
+ return sum / this.globalProgress.length;
396
+ }
397
+
398
+ private processSelection(
399
+ selection: {before: number | null; after: number | null},
400
+ skipAhead: number,
401
+ hasOffset: boolean,
402
+ stringLength: number,
403
+ y: number,
404
+ ): boolean {
405
+ let shouldBreak = false;
406
+ let currentSelected = this.isSelected(
407
+ (hasOffset ? this.beforeCursor.x + stringLength : stringLength) +
408
+ skipAhead,
409
+ this.beforeCursor.y + y,
410
+ );
411
+ if (selection.before !== null && selection.before !== currentSelected) {
412
+ shouldBreak = true;
413
+ } else {
414
+ selection.before = currentSelected;
415
+ }
416
+
417
+ currentSelected = this.isSelected(
418
+ (hasOffset ? this.afterCursor.x + stringLength : stringLength) +
419
+ skipAhead,
420
+ this.afterCursor.y + y,
421
+ true,
422
+ );
423
+ if (selection.after !== null && selection.after !== currentSelected) {
424
+ shouldBreak = true;
425
+ } else {
426
+ selection.after = currentSelected;
427
+ }
428
+
429
+ return shouldBreak;
430
+ }
431
+
432
+ private isSelected(x: number, y: number, isAfter?: boolean): number {
433
+ const point: CodePoint = [y, x];
434
+ const maxSelection = isPointInCodeSelection(point, this.selection) ? 1 : 0;
435
+ if (this.node.oldSelection === null || this.selectionProgress === null) {
436
+ return maxSelection;
437
+ }
438
+
439
+ if (isAfter) {
440
+ return maxSelection;
441
+ }
442
+
443
+ return isPointInCodeSelection(point, this.node.oldSelection) ? 1 : 0;
444
+ }
445
+ }