@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,74 +1,74 @@
1
- import {describe, expect, test} from 'vitest';
2
- import {
3
- consolidateCodeRanges,
4
- inverseCodeRange,
5
- isPointInCodeRange,
6
- pointToPoint,
7
- } from './CodeRange';
8
-
9
- describe('CodeRange', () => {
10
- test('should detect ranges', () => {
11
- expect(
12
- isPointInCodeRange([50, 50], pointToPoint(0, 0, 100, 100)),
13
- 'Should work within both ranges',
14
- ).toBeTruthy();
15
- expect(
16
- isPointInCodeRange([50, 1000], pointToPoint(0, 0, 100, 100)),
17
- 'Should accept any column when within lines',
18
- ).toBeTruthy();
19
- expect(
20
- isPointInCodeRange([50, 50], pointToPoint(0, 0, Infinity, Infinity)),
21
- 'Should work with infinity',
22
- ).toBeTruthy();
23
- expect(
24
- isPointInCodeRange([100, 100], pointToPoint(0, 0, 100, 100)),
25
- 'Should reject points on the outer edge',
26
- ).toBeFalsy();
27
- });
28
-
29
- test('should consolidate ranges that are completely contained', () => {
30
- expect(
31
- consolidateCodeRanges([
32
- pointToPoint(0, 0, 100, 100),
33
- pointToPoint(20, 0, 50, 0),
34
- ]),
35
- ).toEqual([pointToPoint(0, 0, 100, 100)]);
36
- expect(
37
- consolidateCodeRanges([
38
- pointToPoint(20, 0, 50, 0),
39
- pointToPoint(0, 0, 100, 100),
40
- ]),
41
- ).toEqual([pointToPoint(0, 0, 100, 100)]);
42
- });
43
-
44
- test('should combine ranges that overlap', () => {
45
- expect(
46
- consolidateCodeRanges([
47
- pointToPoint(0, 5, 0, 10),
48
- pointToPoint(0, 7, 0, 13),
49
- ]),
50
- ).toEqual([pointToPoint(0, 5, 0, 13)]);
51
- expect(
52
- consolidateCodeRanges([
53
- pointToPoint(0, 7, 2, 13),
54
- pointToPoint(0, 5, 2, 10),
55
- ]),
56
- ).toEqual([pointToPoint(0, 5, 2, 13)]);
57
- });
58
-
59
- test('should not combine ranges that do not overlap', () => {
60
- expect(
61
- consolidateCodeRanges([
62
- pointToPoint(0, 5, 0, 10),
63
- pointToPoint(0, 7, 0, 13),
64
- pointToPoint(1, 5, 1, 10),
65
- ]),
66
- ).toEqual([pointToPoint(0, 5, 0, 13), pointToPoint(1, 5, 1, 10)]);
67
- });
68
-
69
- test('should invert empty ranges', () => {
70
- expect(inverseCodeRange([])).toEqual([
71
- pointToPoint(0, 0, Infinity, Infinity),
72
- ]);
73
- });
74
- });
1
+ import {describe, expect, test} from 'vitest';
2
+ import {
3
+ consolidateCodeRanges,
4
+ inverseCodeRange,
5
+ isPointInCodeRange,
6
+ pointToPoint,
7
+ } from './CodeRange';
8
+
9
+ describe('CodeRange', () => {
10
+ test('should detect ranges', () => {
11
+ expect(
12
+ isPointInCodeRange([50, 50], pointToPoint(0, 0, 100, 100)),
13
+ 'Should work within both ranges',
14
+ ).toBeTruthy();
15
+ expect(
16
+ isPointInCodeRange([50, 1000], pointToPoint(0, 0, 100, 100)),
17
+ 'Should accept any column when within lines',
18
+ ).toBeTruthy();
19
+ expect(
20
+ isPointInCodeRange([50, 50], pointToPoint(0, 0, Infinity, Infinity)),
21
+ 'Should work with infinity',
22
+ ).toBeTruthy();
23
+ expect(
24
+ isPointInCodeRange([100, 100], pointToPoint(0, 0, 100, 100)),
25
+ 'Should reject points on the outer edge',
26
+ ).toBeFalsy();
27
+ });
28
+
29
+ test('should consolidate ranges that are completely contained', () => {
30
+ expect(
31
+ consolidateCodeRanges([
32
+ pointToPoint(0, 0, 100, 100),
33
+ pointToPoint(20, 0, 50, 0),
34
+ ]),
35
+ ).toEqual([pointToPoint(0, 0, 100, 100)]);
36
+ expect(
37
+ consolidateCodeRanges([
38
+ pointToPoint(20, 0, 50, 0),
39
+ pointToPoint(0, 0, 100, 100),
40
+ ]),
41
+ ).toEqual([pointToPoint(0, 0, 100, 100)]);
42
+ });
43
+
44
+ test('should combine ranges that overlap', () => {
45
+ expect(
46
+ consolidateCodeRanges([
47
+ pointToPoint(0, 5, 0, 10),
48
+ pointToPoint(0, 7, 0, 13),
49
+ ]),
50
+ ).toEqual([pointToPoint(0, 5, 0, 13)]);
51
+ expect(
52
+ consolidateCodeRanges([
53
+ pointToPoint(0, 7, 2, 13),
54
+ pointToPoint(0, 5, 2, 10),
55
+ ]),
56
+ ).toEqual([pointToPoint(0, 5, 2, 13)]);
57
+ });
58
+
59
+ test('should not combine ranges that do not overlap', () => {
60
+ expect(
61
+ consolidateCodeRanges([
62
+ pointToPoint(0, 5, 0, 10),
63
+ pointToPoint(0, 7, 0, 13),
64
+ pointToPoint(1, 5, 1, 10),
65
+ ]),
66
+ ).toEqual([pointToPoint(0, 5, 0, 13), pointToPoint(1, 5, 1, 10)]);
67
+ });
68
+
69
+ test('should invert empty ranges', () => {
70
+ expect(inverseCodeRange([])).toEqual([
71
+ pointToPoint(0, 0, Infinity, Infinity),
72
+ ]);
73
+ });
74
+ });
@@ -1,216 +1,216 @@
1
- export type CodePoint = [number, number];
2
-
3
- function isCodePoint(value: unknown): value is CodePoint {
4
- return (
5
- Array.isArray(value) &&
6
- value.length === 2 &&
7
- typeof value[0] === 'number' &&
8
- typeof value[1] === 'number'
9
- );
10
- }
11
-
12
- export type CodeRange = [CodePoint, CodePoint];
13
-
14
- export function isCodeRange(value: unknown): value is CodeRange {
15
- return (
16
- Array.isArray(value) &&
17
- value.length === 2 &&
18
- isCodePoint(value[0]) &&
19
- isCodePoint(value[1])
20
- );
21
- }
22
-
23
- /**
24
- * Create a code range that spans the given lines.
25
- *
26
- * @param from - The line from which the range starts.
27
- * @param to - The line at which the range ends. If omitted, the range will
28
- * cover only one line.
29
- */
30
- export function lines(from: number, to?: number): CodeRange {
31
- return [
32
- [from, 0],
33
- [to ?? from, Infinity],
34
- ];
35
- }
36
-
37
- /**
38
- * Create a code range that highlights the given word.
39
- *
40
- * @param line - The line at which the word appears.
41
- * @param from - The column at which the word starts.
42
- * @param length - The length of the word. If omitted, the range will cover the
43
- * rest of the line.
44
- */
45
- export function word(line: number, from: number, length?: number): CodeRange {
46
- return [
47
- [line, from],
48
- [line, from + (length ?? Infinity)],
49
- ];
50
- }
51
-
52
- /**
53
- * Create a custom selection range.
54
- *
55
- * @param startLine - The line at which the selection starts.
56
- * @param startColumn - The column at which the selection starts.
57
- * @param endLine - The line at which the selection ends.
58
- * @param endColumn - The column at which the selection ends.
59
- */
60
- export function pointToPoint(
61
- startLine: number,
62
- startColumn: number,
63
- endLine: number,
64
- endColumn: number,
65
- ): CodeRange {
66
- return [
67
- [startLine, startColumn],
68
- [endLine, endColumn],
69
- ];
70
- }
71
-
72
- export function isPointInCodeRange(point: CodePoint, range: CodeRange) {
73
- const [y, x] = point;
74
- const [[startLine, startColumn], [endLine, endColumn]] = range;
75
- return (
76
- ((y === startLine && x >= startColumn) || y > startLine) &&
77
- ((y === endLine && x < endColumn) || y < endLine)
78
- );
79
- }
80
-
81
- export function consolidateCodeRanges(ranges: CodeRange[]): CodeRange[] {
82
- // Sort by start position
83
- ranges.sort((a, b) => {
84
- const lines = b[0][0] - a[0][0];
85
- // Break ties on start column
86
- if (lines === 0) {
87
- return b[0][1] - a[0][1];
88
- }
89
- return lines;
90
- });
91
-
92
- const staged: CodeRange[] = [...ranges];
93
- const results = [];
94
- while (staged.length > 0) {
95
- let current = staged.pop();
96
- if (!current) {
97
- continue;
98
- }
99
- const [[initStartLine, initStartColumn], [initEndLine, initEndColumn]] =
100
- current;
101
-
102
- for (const targetRange of staged) {
103
- const [
104
- [targetStartLine, targetStartColumn],
105
- [targetEndLine, targetEndColumn],
106
- ] = targetRange;
107
- if (
108
- isPointInCodeRange(targetRange[0], current) ||
109
- isPointInCodeRange(targetRange[1], current)
110
- ) {
111
- staged.pop();
112
-
113
- let startColumn;
114
- if (initStartLine === targetStartLine) {
115
- startColumn = Math.min(initStartColumn, targetStartColumn);
116
- } else if (initStartLine < targetStartLine) {
117
- startColumn = initStartColumn;
118
- } else {
119
- startColumn = targetStartColumn;
120
- }
121
-
122
- let endColumn;
123
- if (initEndLine === targetEndLine) {
124
- endColumn = Math.max(initEndColumn, targetEndColumn);
125
- } else if (initEndLine > targetEndLine) {
126
- endColumn = initEndColumn;
127
- } else {
128
- endColumn = targetEndColumn;
129
- }
130
- // Update the current to the consolidated one and get rid of the
131
- // remaining instance of the unconsolidated target
132
- current = [
133
- [Math.min(initStartLine, targetStartLine), startColumn],
134
- [Math.max(initEndLine, targetEndLine), endColumn],
135
- ];
136
- }
137
- }
138
- results.push(current);
139
- }
140
- return results;
141
- }
142
-
143
- export function inverseCodeRange(ranges: CodeRange[]): CodeRange[] {
144
- if (ranges.length === 0) {
145
- return [
146
- [
147
- [0, 0],
148
- [Infinity, Infinity],
149
- ],
150
- ];
151
- }
152
- const firstRange = ranges[0];
153
- const result: CodeRange[] = [];
154
- for (let first = 0; first < ranges.length - 1; first++) {
155
- const range1 = ranges[first];
156
- const range2 = ranges[first + 1];
157
- result.push([range1[1], range2[0]]);
158
- }
159
- const lastRange = ranges.slice(-1)[0];
160
- return [
161
- [[0, 0], firstRange[0]],
162
- ...result,
163
- [lastRange[1], [Infinity, Infinity]],
164
- ];
165
- }
166
-
167
- /**
168
- * Find all code ranges that match the given pattern.
169
- *
170
- * @param code - The code to search in.
171
- * @param pattern - Either a string or a regular expression to search for.
172
- * @param limit - An optional limit on the number of ranges to find.
173
- */
174
- export function findAllCodeRanges(
175
- code: string,
176
- pattern: string | RegExp,
177
- limit = Infinity,
178
- ): CodeRange[] {
179
- if (typeof pattern === 'string') {
180
- pattern = new RegExp(pattern, 'g');
181
- }
182
-
183
- const matches = code.matchAll(pattern);
184
- const ranges: CodeRange[] = [];
185
- let index = 0;
186
- let line = 0;
187
- let column = 0;
188
-
189
- for (const match of matches) {
190
- if (match.index === undefined || ranges.length >= limit) {
191
- continue;
192
- }
193
-
194
- let from: CodePoint = [line, column];
195
- while (index <= code.length) {
196
- if (index === match.index) {
197
- from = [line, column];
198
- }
199
-
200
- if (index === match.index + match[0].length) {
201
- ranges.push([from, [line, column]]);
202
- break;
203
- }
204
-
205
- if (code[index] === '\n') {
206
- line++;
207
- column = 0;
208
- } else {
209
- column++;
210
- }
211
- index++;
212
- }
213
- }
214
-
215
- return ranges;
216
- }
1
+ export type CodePoint = [number, number];
2
+
3
+ function isCodePoint(value: unknown): value is CodePoint {
4
+ return (
5
+ Array.isArray(value) &&
6
+ value.length === 2 &&
7
+ typeof value[0] === 'number' &&
8
+ typeof value[1] === 'number'
9
+ );
10
+ }
11
+
12
+ export type CodeRange = [CodePoint, CodePoint];
13
+
14
+ export function isCodeRange(value: unknown): value is CodeRange {
15
+ return (
16
+ Array.isArray(value) &&
17
+ value.length === 2 &&
18
+ isCodePoint(value[0]) &&
19
+ isCodePoint(value[1])
20
+ );
21
+ }
22
+
23
+ /**
24
+ * Create a code range that spans the given lines.
25
+ *
26
+ * @param from - The line from which the range starts.
27
+ * @param to - The line at which the range ends. If omitted, the range will
28
+ * cover only one line.
29
+ */
30
+ export function lines(from: number, to?: number): CodeRange {
31
+ return [
32
+ [from, 0],
33
+ [to ?? from, Infinity],
34
+ ];
35
+ }
36
+
37
+ /**
38
+ * Create a code range that highlights the given word.
39
+ *
40
+ * @param line - The line at which the word appears.
41
+ * @param from - The column at which the word starts.
42
+ * @param length - The length of the word. If omitted, the range will cover the
43
+ * rest of the line.
44
+ */
45
+ export function word(line: number, from: number, length?: number): CodeRange {
46
+ return [
47
+ [line, from],
48
+ [line, from + (length ?? Infinity)],
49
+ ];
50
+ }
51
+
52
+ /**
53
+ * Create a custom selection range.
54
+ *
55
+ * @param startLine - The line at which the selection starts.
56
+ * @param startColumn - The column at which the selection starts.
57
+ * @param endLine - The line at which the selection ends.
58
+ * @param endColumn - The column at which the selection ends.
59
+ */
60
+ export function pointToPoint(
61
+ startLine: number,
62
+ startColumn: number,
63
+ endLine: number,
64
+ endColumn: number,
65
+ ): CodeRange {
66
+ return [
67
+ [startLine, startColumn],
68
+ [endLine, endColumn],
69
+ ];
70
+ }
71
+
72
+ export function isPointInCodeRange(point: CodePoint, range: CodeRange) {
73
+ const [y, x] = point;
74
+ const [[startLine, startColumn], [endLine, endColumn]] = range;
75
+ return (
76
+ ((y === startLine && x >= startColumn) || y > startLine) &&
77
+ ((y === endLine && x < endColumn) || y < endLine)
78
+ );
79
+ }
80
+
81
+ export function consolidateCodeRanges(ranges: CodeRange[]): CodeRange[] {
82
+ // Sort by start position
83
+ ranges.sort((a, b) => {
84
+ const lines = b[0][0] - a[0][0];
85
+ // Break ties on start column
86
+ if (lines === 0) {
87
+ return b[0][1] - a[0][1];
88
+ }
89
+ return lines;
90
+ });
91
+
92
+ const staged: CodeRange[] = [...ranges];
93
+ const results = [];
94
+ while (staged.length > 0) {
95
+ let current = staged.pop();
96
+ if (!current) {
97
+ continue;
98
+ }
99
+ const [[initStartLine, initStartColumn], [initEndLine, initEndColumn]] =
100
+ current;
101
+
102
+ for (const targetRange of staged) {
103
+ const [
104
+ [targetStartLine, targetStartColumn],
105
+ [targetEndLine, targetEndColumn],
106
+ ] = targetRange;
107
+ if (
108
+ isPointInCodeRange(targetRange[0], current) ||
109
+ isPointInCodeRange(targetRange[1], current)
110
+ ) {
111
+ staged.pop();
112
+
113
+ let startColumn;
114
+ if (initStartLine === targetStartLine) {
115
+ startColumn = Math.min(initStartColumn, targetStartColumn);
116
+ } else if (initStartLine < targetStartLine) {
117
+ startColumn = initStartColumn;
118
+ } else {
119
+ startColumn = targetStartColumn;
120
+ }
121
+
122
+ let endColumn;
123
+ if (initEndLine === targetEndLine) {
124
+ endColumn = Math.max(initEndColumn, targetEndColumn);
125
+ } else if (initEndLine > targetEndLine) {
126
+ endColumn = initEndColumn;
127
+ } else {
128
+ endColumn = targetEndColumn;
129
+ }
130
+ // Update the current to the consolidated one and get rid of the
131
+ // remaining instance of the unconsolidated target
132
+ current = [
133
+ [Math.min(initStartLine, targetStartLine), startColumn],
134
+ [Math.max(initEndLine, targetEndLine), endColumn],
135
+ ];
136
+ }
137
+ }
138
+ results.push(current);
139
+ }
140
+ return results;
141
+ }
142
+
143
+ export function inverseCodeRange(ranges: CodeRange[]): CodeRange[] {
144
+ if (ranges.length === 0) {
145
+ return [
146
+ [
147
+ [0, 0],
148
+ [Infinity, Infinity],
149
+ ],
150
+ ];
151
+ }
152
+ const firstRange = ranges[0];
153
+ const result: CodeRange[] = [];
154
+ for (let first = 0; first < ranges.length - 1; first++) {
155
+ const range1 = ranges[first];
156
+ const range2 = ranges[first + 1];
157
+ result.push([range1[1], range2[0]]);
158
+ }
159
+ const lastRange = ranges.slice(-1)[0];
160
+ return [
161
+ [[0, 0], firstRange[0]],
162
+ ...result,
163
+ [lastRange[1], [Infinity, Infinity]],
164
+ ];
165
+ }
166
+
167
+ /**
168
+ * Find all code ranges that match the given pattern.
169
+ *
170
+ * @param code - The code to search in.
171
+ * @param pattern - Either a string or a regular expression to search for.
172
+ * @param limit - An optional limit on the number of ranges to find.
173
+ */
174
+ export function findAllCodeRanges(
175
+ code: string,
176
+ pattern: string | RegExp,
177
+ limit = Infinity,
178
+ ): CodeRange[] {
179
+ if (typeof pattern === 'string') {
180
+ pattern = new RegExp(pattern, 'g');
181
+ }
182
+
183
+ const matches = code.matchAll(pattern);
184
+ const ranges: CodeRange[] = [];
185
+ let index = 0;
186
+ let line = 0;
187
+ let column = 0;
188
+
189
+ for (const match of matches) {
190
+ if (match.index === undefined || ranges.length >= limit) {
191
+ continue;
192
+ }
193
+
194
+ let from: CodePoint = [line, column];
195
+ while (index <= code.length) {
196
+ if (index === match.index) {
197
+ from = [line, column];
198
+ }
199
+
200
+ if (index === match.index + match[0].length) {
201
+ ranges.push([from, [line, column]]);
202
+ break;
203
+ }
204
+
205
+ if (code[index] === '\n') {
206
+ line++;
207
+ column = 0;
208
+ } else {
209
+ column++;
210
+ }
211
+ index++;
212
+ }
213
+ }
214
+
215
+ return ranges;
216
+ }