@twick/2d 0.13.0 → 0.14.2

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 (171) hide show
  1. package/LICENSE +21 -0
  2. package/editor/editor/tsconfig.build.tsbuildinfo +1 -1
  3. package/lib/components/Audio.js +3 -3
  4. package/lib/components/Img.js +23 -23
  5. package/lib/components/Line.js +31 -31
  6. package/lib/components/Media.d.ts +1 -1
  7. package/lib/components/Media.d.ts.map +1 -1
  8. package/lib/components/Media.js +26 -26
  9. package/lib/components/Spline.js +25 -25
  10. package/lib/components/Video.js +3 -3
  11. package/lib/tsconfig.build.tsbuildinfo +1 -1
  12. package/package.json +5 -4
  13. package/src/editor/NodeInspectorConfig.tsx +76 -76
  14. package/src/editor/PreviewOverlayConfig.tsx +67 -67
  15. package/src/editor/Provider.tsx +93 -93
  16. package/src/editor/SceneGraphTabConfig.tsx +81 -81
  17. package/src/editor/icons/CircleIcon.tsx +7 -7
  18. package/src/editor/icons/CodeBlockIcon.tsx +8 -8
  19. package/src/editor/icons/CurveIcon.tsx +7 -7
  20. package/src/editor/icons/GridIcon.tsx +7 -7
  21. package/src/editor/icons/IconMap.ts +35 -35
  22. package/src/editor/icons/ImgIcon.tsx +8 -8
  23. package/src/editor/icons/LayoutIcon.tsx +9 -9
  24. package/src/editor/icons/LineIcon.tsx +7 -7
  25. package/src/editor/icons/NodeIcon.tsx +7 -7
  26. package/src/editor/icons/RayIcon.tsx +7 -7
  27. package/src/editor/icons/RectIcon.tsx +7 -7
  28. package/src/editor/icons/ShapeIcon.tsx +7 -7
  29. package/src/editor/icons/TxtIcon.tsx +8 -8
  30. package/src/editor/icons/VideoIcon.tsx +7 -7
  31. package/src/editor/icons/View2DIcon.tsx +10 -10
  32. package/src/editor/index.ts +17 -17
  33. package/src/editor/tree/DetachedRoot.tsx +23 -23
  34. package/src/editor/tree/NodeElement.tsx +74 -74
  35. package/src/editor/tree/TreeElement.tsx +72 -72
  36. package/src/editor/tree/TreeRoot.tsx +10 -10
  37. package/src/editor/tree/ViewRoot.tsx +20 -20
  38. package/src/editor/tree/index.module.scss +38 -38
  39. package/src/editor/tree/index.ts +3 -3
  40. package/src/editor/tsconfig.build.json +5 -5
  41. package/src/editor/tsconfig.json +12 -12
  42. package/src/editor/tsdoc.json +4 -4
  43. package/src/editor/vite-env.d.ts +1 -1
  44. package/src/lib/code/CodeCursor.ts +445 -445
  45. package/src/lib/code/CodeDiffer.ts +78 -78
  46. package/src/lib/code/CodeFragment.ts +97 -97
  47. package/src/lib/code/CodeHighlighter.ts +75 -75
  48. package/src/lib/code/CodeMetrics.ts +47 -47
  49. package/src/lib/code/CodeRange.test.ts +74 -74
  50. package/src/lib/code/CodeRange.ts +216 -216
  51. package/src/lib/code/CodeScope.ts +101 -101
  52. package/src/lib/code/CodeSelection.ts +24 -24
  53. package/src/lib/code/CodeSignal.ts +327 -327
  54. package/src/lib/code/CodeTokenizer.ts +54 -54
  55. package/src/lib/code/DefaultHighlightStyle.ts +98 -98
  56. package/src/lib/code/LezerHighlighter.ts +113 -113
  57. package/src/lib/code/diff.test.ts +311 -311
  58. package/src/lib/code/diff.ts +319 -319
  59. package/src/lib/code/extractRange.ts +126 -126
  60. package/src/lib/code/index.ts +13 -13
  61. package/src/lib/components/Audio.ts +168 -168
  62. package/src/lib/components/Bezier.ts +105 -105
  63. package/src/lib/components/Circle.ts +266 -266
  64. package/src/lib/components/Code.ts +526 -526
  65. package/src/lib/components/CodeBlock.ts +576 -576
  66. package/src/lib/components/CubicBezier.ts +112 -112
  67. package/src/lib/components/Curve.ts +455 -455
  68. package/src/lib/components/Grid.ts +135 -135
  69. package/src/lib/components/Icon.ts +96 -96
  70. package/src/lib/components/Img.ts +319 -319
  71. package/src/lib/components/Knot.ts +157 -157
  72. package/src/lib/components/Latex.ts +122 -122
  73. package/src/lib/components/Layout.ts +1092 -1092
  74. package/src/lib/components/Line.ts +429 -429
  75. package/src/lib/components/Media.ts +576 -576
  76. package/src/lib/components/Node.ts +1940 -1940
  77. package/src/lib/components/Path.ts +137 -137
  78. package/src/lib/components/Polygon.ts +171 -171
  79. package/src/lib/components/QuadBezier.ts +100 -100
  80. package/src/lib/components/Ray.ts +125 -125
  81. package/src/lib/components/Rect.ts +187 -187
  82. package/src/lib/components/Rive.ts +156 -156
  83. package/src/lib/components/SVG.ts +797 -797
  84. package/src/lib/components/Shape.ts +143 -143
  85. package/src/lib/components/Spline.ts +344 -344
  86. package/src/lib/components/Txt.test.tsx +81 -81
  87. package/src/lib/components/Txt.ts +203 -203
  88. package/src/lib/components/TxtLeaf.ts +205 -205
  89. package/src/lib/components/Video.ts +461 -461
  90. package/src/lib/components/View2D.ts +98 -98
  91. package/src/lib/components/__tests__/children.test.tsx +142 -142
  92. package/src/lib/components/__tests__/clone.test.tsx +126 -126
  93. package/src/lib/components/__tests__/generatorTest.ts +28 -28
  94. package/src/lib/components/__tests__/mockScene2D.ts +45 -45
  95. package/src/lib/components/__tests__/query.test.tsx +122 -122
  96. package/src/lib/components/__tests__/state.test.tsx +60 -60
  97. package/src/lib/components/index.ts +28 -28
  98. package/src/lib/components/types.ts +35 -35
  99. package/src/lib/curves/ArcSegment.ts +159 -159
  100. package/src/lib/curves/CircleSegment.ts +77 -77
  101. package/src/lib/curves/CubicBezierSegment.ts +78 -78
  102. package/src/lib/curves/CurveDrawingInfo.ts +11 -11
  103. package/src/lib/curves/CurvePoint.ts +15 -15
  104. package/src/lib/curves/CurveProfile.ts +7 -7
  105. package/src/lib/curves/KnotInfo.ts +10 -10
  106. package/src/lib/curves/LineSegment.ts +62 -62
  107. package/src/lib/curves/Polynomial.ts +355 -355
  108. package/src/lib/curves/Polynomial2D.ts +62 -62
  109. package/src/lib/curves/PolynomialSegment.ts +124 -124
  110. package/src/lib/curves/QuadBezierSegment.ts +64 -64
  111. package/src/lib/curves/Segment.ts +17 -17
  112. package/src/lib/curves/UniformPolynomialCurveSampler.ts +94 -94
  113. package/src/lib/curves/createCurveProfileLerp.ts +471 -471
  114. package/src/lib/curves/getBezierSplineProfile.ts +223 -223
  115. package/src/lib/curves/getCircleProfile.ts +86 -86
  116. package/src/lib/curves/getPathProfile.ts +178 -178
  117. package/src/lib/curves/getPointAtDistance.ts +21 -21
  118. package/src/lib/curves/getPolylineProfile.test.ts +21 -21
  119. package/src/lib/curves/getPolylineProfile.ts +89 -89
  120. package/src/lib/curves/getRectProfile.ts +139 -139
  121. package/src/lib/curves/index.ts +16 -16
  122. package/src/lib/decorators/canvasStyleSignal.ts +16 -16
  123. package/src/lib/decorators/colorSignal.ts +9 -9
  124. package/src/lib/decorators/compound.ts +72 -72
  125. package/src/lib/decorators/computed.ts +18 -18
  126. package/src/lib/decorators/defaultStyle.ts +18 -18
  127. package/src/lib/decorators/filtersSignal.ts +136 -136
  128. package/src/lib/decorators/index.ts +10 -10
  129. package/src/lib/decorators/initializers.ts +32 -32
  130. package/src/lib/decorators/nodeName.ts +13 -13
  131. package/src/lib/decorators/signal.test.ts +90 -90
  132. package/src/lib/decorators/signal.ts +345 -345
  133. package/src/lib/decorators/spacingSignal.ts +15 -15
  134. package/src/lib/decorators/vector2Signal.ts +30 -30
  135. package/src/lib/globals.d.ts +2 -2
  136. package/src/lib/index.ts +8 -8
  137. package/src/lib/jsx-dev-runtime.ts +2 -2
  138. package/src/lib/jsx-runtime.ts +46 -46
  139. package/src/lib/parse-svg-path.d.ts +14 -14
  140. package/src/lib/partials/Filter.ts +180 -180
  141. package/src/lib/partials/Gradient.ts +102 -102
  142. package/src/lib/partials/Pattern.ts +34 -34
  143. package/src/lib/partials/ShaderConfig.ts +117 -117
  144. package/src/lib/partials/index.ts +4 -4
  145. package/src/lib/partials/types.ts +58 -58
  146. package/src/lib/scenes/Scene2D.ts +242 -242
  147. package/src/lib/scenes/index.ts +3 -3
  148. package/src/lib/scenes/makeScene2D.ts +16 -16
  149. package/src/lib/scenes/useScene2D.ts +6 -6
  150. package/src/lib/tsconfig.build.json +5 -5
  151. package/src/lib/tsconfig.json +10 -10
  152. package/src/lib/tsdoc.json +4 -4
  153. package/src/lib/utils/CanvasUtils.ts +306 -306
  154. package/src/lib/utils/diff.test.ts +453 -453
  155. package/src/lib/utils/diff.ts +148 -148
  156. package/src/lib/utils/index.ts +2 -2
  157. package/src/lib/utils/is.ts +11 -11
  158. package/src/lib/utils/makeSignalExtensions.ts +30 -30
  159. package/src/lib/utils/video/declarations.d.ts +1 -1
  160. package/src/lib/utils/video/ffmpeg-client.ts +50 -50
  161. package/src/lib/utils/video/mp4-parser-manager.ts +72 -72
  162. package/src/lib/utils/video/parser/index.ts +1 -1
  163. package/src/lib/utils/video/parser/parser.ts +257 -257
  164. package/src/lib/utils/video/parser/sampler.ts +72 -72
  165. package/src/lib/utils/video/parser/segment.ts +302 -302
  166. package/src/lib/utils/video/parser/sink.ts +29 -29
  167. package/src/lib/utils/video/parser/utils.ts +31 -31
  168. package/src/tsconfig.base.json +19 -19
  169. package/src/tsconfig.build.json +8 -8
  170. package/src/tsconfig.json +5 -5
  171. package/tsconfig.project.json +7 -7
@@ -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
+ }