@twick/2d 0.14.18 → 0.14.20

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 (167) hide show
  1. package/LICENSE +21 -21
  2. package/editor/editor/tsconfig.build.tsbuildinfo +1 -1
  3. package/lib/components/Img.js +23 -23
  4. package/lib/components/Line.js +31 -31
  5. package/lib/components/Media.js +22 -22
  6. package/lib/components/Spline.js +25 -25
  7. package/lib/tsconfig.build.tsbuildinfo +1 -1
  8. package/package.json +4 -4
  9. package/src/editor/NodeInspectorConfig.tsx +76 -76
  10. package/src/editor/PreviewOverlayConfig.tsx +67 -67
  11. package/src/editor/Provider.tsx +93 -93
  12. package/src/editor/SceneGraphTabConfig.tsx +81 -81
  13. package/src/editor/icons/CircleIcon.tsx +7 -7
  14. package/src/editor/icons/CodeBlockIcon.tsx +8 -8
  15. package/src/editor/icons/CurveIcon.tsx +7 -7
  16. package/src/editor/icons/GridIcon.tsx +7 -7
  17. package/src/editor/icons/IconMap.ts +35 -35
  18. package/src/editor/icons/ImgIcon.tsx +8 -8
  19. package/src/editor/icons/LayoutIcon.tsx +9 -9
  20. package/src/editor/icons/LineIcon.tsx +7 -7
  21. package/src/editor/icons/NodeIcon.tsx +7 -7
  22. package/src/editor/icons/RayIcon.tsx +7 -7
  23. package/src/editor/icons/RectIcon.tsx +7 -7
  24. package/src/editor/icons/ShapeIcon.tsx +7 -7
  25. package/src/editor/icons/TxtIcon.tsx +8 -8
  26. package/src/editor/icons/VideoIcon.tsx +7 -7
  27. package/src/editor/icons/View2DIcon.tsx +10 -10
  28. package/src/editor/index.ts +17 -17
  29. package/src/editor/tree/DetachedRoot.tsx +23 -23
  30. package/src/editor/tree/NodeElement.tsx +74 -74
  31. package/src/editor/tree/TreeElement.tsx +72 -72
  32. package/src/editor/tree/TreeRoot.tsx +10 -10
  33. package/src/editor/tree/ViewRoot.tsx +20 -20
  34. package/src/editor/tree/index.module.scss +38 -38
  35. package/src/editor/tree/index.ts +3 -3
  36. package/src/editor/tsconfig.build.json +5 -5
  37. package/src/editor/tsconfig.json +12 -12
  38. package/src/editor/tsdoc.json +4 -4
  39. package/src/editor/vite-env.d.ts +1 -1
  40. package/src/lib/code/CodeCursor.ts +445 -445
  41. package/src/lib/code/CodeDiffer.ts +78 -78
  42. package/src/lib/code/CodeFragment.ts +97 -97
  43. package/src/lib/code/CodeHighlighter.ts +75 -75
  44. package/src/lib/code/CodeMetrics.ts +47 -47
  45. package/src/lib/code/CodeRange.test.ts +74 -74
  46. package/src/lib/code/CodeRange.ts +216 -216
  47. package/src/lib/code/CodeScope.ts +101 -101
  48. package/src/lib/code/CodeSelection.ts +24 -24
  49. package/src/lib/code/CodeSignal.ts +327 -327
  50. package/src/lib/code/CodeTokenizer.ts +54 -54
  51. package/src/lib/code/DefaultHighlightStyle.ts +98 -98
  52. package/src/lib/code/LezerHighlighter.ts +113 -113
  53. package/src/lib/code/diff.test.ts +311 -311
  54. package/src/lib/code/diff.ts +319 -319
  55. package/src/lib/code/extractRange.ts +126 -126
  56. package/src/lib/code/index.ts +13 -13
  57. package/src/lib/components/Audio.ts +168 -168
  58. package/src/lib/components/Bezier.ts +105 -105
  59. package/src/lib/components/Circle.ts +266 -266
  60. package/src/lib/components/Code.ts +526 -526
  61. package/src/lib/components/CodeBlock.ts +576 -576
  62. package/src/lib/components/CubicBezier.ts +112 -112
  63. package/src/lib/components/Curve.ts +455 -455
  64. package/src/lib/components/Grid.ts +135 -135
  65. package/src/lib/components/Icon.ts +96 -96
  66. package/src/lib/components/Img.ts +319 -319
  67. package/src/lib/components/Knot.ts +157 -157
  68. package/src/lib/components/Latex.ts +122 -122
  69. package/src/lib/components/Layout.ts +1092 -1092
  70. package/src/lib/components/Line.ts +429 -429
  71. package/src/lib/components/Media.ts +576 -576
  72. package/src/lib/components/Node.ts +1940 -1940
  73. package/src/lib/components/Path.ts +137 -137
  74. package/src/lib/components/Polygon.ts +171 -171
  75. package/src/lib/components/QuadBezier.ts +100 -100
  76. package/src/lib/components/Ray.ts +125 -125
  77. package/src/lib/components/Rect.ts +187 -187
  78. package/src/lib/components/Rive.ts +156 -156
  79. package/src/lib/components/SVG.ts +797 -797
  80. package/src/lib/components/Shape.ts +143 -143
  81. package/src/lib/components/Spline.ts +344 -344
  82. package/src/lib/components/Txt.test.tsx +81 -81
  83. package/src/lib/components/Txt.ts +203 -203
  84. package/src/lib/components/TxtLeaf.ts +205 -205
  85. package/src/lib/components/Video.ts +461 -461
  86. package/src/lib/components/View2D.ts +98 -98
  87. package/src/lib/components/__tests__/children.test.tsx +142 -142
  88. package/src/lib/components/__tests__/clone.test.tsx +126 -126
  89. package/src/lib/components/__tests__/generatorTest.ts +28 -28
  90. package/src/lib/components/__tests__/mockScene2D.ts +45 -45
  91. package/src/lib/components/__tests__/query.test.tsx +122 -122
  92. package/src/lib/components/__tests__/state.test.tsx +60 -60
  93. package/src/lib/components/index.ts +28 -28
  94. package/src/lib/components/types.ts +35 -35
  95. package/src/lib/curves/ArcSegment.ts +159 -159
  96. package/src/lib/curves/CircleSegment.ts +77 -77
  97. package/src/lib/curves/CubicBezierSegment.ts +78 -78
  98. package/src/lib/curves/CurveDrawingInfo.ts +11 -11
  99. package/src/lib/curves/CurvePoint.ts +15 -15
  100. package/src/lib/curves/CurveProfile.ts +7 -7
  101. package/src/lib/curves/KnotInfo.ts +10 -10
  102. package/src/lib/curves/LineSegment.ts +62 -62
  103. package/src/lib/curves/Polynomial.ts +355 -355
  104. package/src/lib/curves/Polynomial2D.ts +62 -62
  105. package/src/lib/curves/PolynomialSegment.ts +124 -124
  106. package/src/lib/curves/QuadBezierSegment.ts +64 -64
  107. package/src/lib/curves/Segment.ts +17 -17
  108. package/src/lib/curves/UniformPolynomialCurveSampler.ts +94 -94
  109. package/src/lib/curves/createCurveProfileLerp.ts +471 -471
  110. package/src/lib/curves/getBezierSplineProfile.ts +223 -223
  111. package/src/lib/curves/getCircleProfile.ts +86 -86
  112. package/src/lib/curves/getPathProfile.ts +178 -178
  113. package/src/lib/curves/getPointAtDistance.ts +21 -21
  114. package/src/lib/curves/getPolylineProfile.test.ts +21 -21
  115. package/src/lib/curves/getPolylineProfile.ts +89 -89
  116. package/src/lib/curves/getRectProfile.ts +139 -139
  117. package/src/lib/curves/index.ts +16 -16
  118. package/src/lib/decorators/canvasStyleSignal.ts +16 -16
  119. package/src/lib/decorators/colorSignal.ts +9 -9
  120. package/src/lib/decorators/compound.ts +72 -72
  121. package/src/lib/decorators/computed.ts +18 -18
  122. package/src/lib/decorators/defaultStyle.ts +18 -18
  123. package/src/lib/decorators/filtersSignal.ts +136 -136
  124. package/src/lib/decorators/index.ts +10 -10
  125. package/src/lib/decorators/initializers.ts +32 -32
  126. package/src/lib/decorators/nodeName.ts +13 -13
  127. package/src/lib/decorators/signal.test.ts +90 -90
  128. package/src/lib/decorators/signal.ts +345 -345
  129. package/src/lib/decorators/spacingSignal.ts +15 -15
  130. package/src/lib/decorators/vector2Signal.ts +30 -30
  131. package/src/lib/globals.d.ts +2 -2
  132. package/src/lib/index.ts +8 -8
  133. package/src/lib/jsx-dev-runtime.ts +2 -2
  134. package/src/lib/jsx-runtime.ts +46 -46
  135. package/src/lib/parse-svg-path.d.ts +14 -14
  136. package/src/lib/partials/Filter.ts +180 -180
  137. package/src/lib/partials/Gradient.ts +102 -102
  138. package/src/lib/partials/Pattern.ts +34 -34
  139. package/src/lib/partials/ShaderConfig.ts +117 -117
  140. package/src/lib/partials/index.ts +4 -4
  141. package/src/lib/partials/types.ts +58 -58
  142. package/src/lib/scenes/Scene2D.ts +242 -242
  143. package/src/lib/scenes/index.ts +3 -3
  144. package/src/lib/scenes/makeScene2D.ts +16 -16
  145. package/src/lib/scenes/useScene2D.ts +6 -6
  146. package/src/lib/tsconfig.build.json +5 -5
  147. package/src/lib/tsconfig.json +10 -10
  148. package/src/lib/tsdoc.json +4 -4
  149. package/src/lib/utils/CanvasUtils.ts +306 -306
  150. package/src/lib/utils/diff.test.ts +453 -453
  151. package/src/lib/utils/diff.ts +148 -148
  152. package/src/lib/utils/index.ts +2 -2
  153. package/src/lib/utils/is.ts +11 -11
  154. package/src/lib/utils/makeSignalExtensions.ts +30 -30
  155. package/src/lib/utils/video/declarations.d.ts +1 -1
  156. package/src/lib/utils/video/ffmpeg-client.ts +50 -50
  157. package/src/lib/utils/video/mp4-parser-manager.ts +72 -72
  158. package/src/lib/utils/video/parser/index.ts +1 -1
  159. package/src/lib/utils/video/parser/parser.ts +257 -257
  160. package/src/lib/utils/video/parser/sampler.ts +72 -72
  161. package/src/lib/utils/video/parser/segment.ts +302 -302
  162. package/src/lib/utils/video/parser/sink.ts +29 -29
  163. package/src/lib/utils/video/parser/utils.ts +31 -31
  164. package/src/tsconfig.base.json +19 -19
  165. package/src/tsconfig.build.json +8 -8
  166. package/src/tsconfig.json +5 -5
  167. package/tsconfig.project.json +7 -7
@@ -1,81 +1,81 @@
1
- import {linear, waitFor} from '@twick/core';
2
- import {describe, expect, it, vi} from 'vitest';
3
- import {Txt} from './Txt';
4
- import {TxtLeaf} from './TxtLeaf';
5
- import {generatorTest} from './__tests__/generatorTest';
6
- import {mockScene2D} from './__tests__/mockScene2D';
7
-
8
- describe('Txt', () => {
9
- mockScene2D();
10
-
11
- it('Handle plain text', () => {
12
- const node = (<Txt lineWidth={8}>test</Txt>) as Txt;
13
-
14
- const parseSpy = vi.spyOn(node as any, 'parseChildren');
15
- const leaf = node.childAs<TxtLeaf>(0);
16
-
17
- expect(node.text()).toBe('test');
18
- expect(node.lineWidth()).toBe(8);
19
- expect(node.children().length).toBe(1);
20
- expect(leaf).toBeInstanceOf(TxtLeaf);
21
- expect(leaf!.text()).toBe('test');
22
- expect(leaf!.lineWidth()).toBe(8);
23
-
24
- node.lineWidth(16);
25
- node.text('changed');
26
-
27
- expect(node.childAs(0)).toBe(leaf);
28
- expect(leaf!.lineWidth()).toBe(16);
29
- expect(leaf!.text()).toBe('changed');
30
-
31
- // Parsing should not happen when operating exclusively on simple text
32
- expect(parseSpy).toHaveBeenCalledTimes(0);
33
- });
34
-
35
- it('Handle complex text', () => {
36
- const node = (
37
- <Txt lineWidth={8}>
38
- Apple <Txt>Banana</Txt> Cherry
39
- </Txt>
40
- ) as Txt;
41
-
42
- const first = node.childAs<TxtLeaf>(0);
43
- const second = node.childAs<Txt>(1);
44
- const third = node.childAs<TxtLeaf>(2);
45
-
46
- expect(node.text()).toBe('Apple Banana Cherry');
47
- expect(node.lineWidth()).toBe(8);
48
- expect(node.children().length).toBe(3);
49
- expect(first).toBeInstanceOf(TxtLeaf);
50
- expect(first!.text()).toBe('Apple ');
51
- expect(first!.lineWidth()).toBe(8);
52
-
53
- expect(second).toBeInstanceOf(Txt);
54
- expect(second!.text()).toBe('Banana');
55
- expect(second!.lineWidth()).toBe(8);
56
-
57
- expect(third).toBeInstanceOf(TxtLeaf);
58
- expect(third!.text()).toBe(' Cherry');
59
- expect(third!.lineWidth()).toBe(8);
60
- });
61
-
62
- it(
63
- 'Tween complex to simple text',
64
- generatorTest(function* () {
65
- const node = (
66
- <Txt>
67
- <Txt>Apple</Txt> Banana
68
- </Txt>
69
- ) as Txt;
70
-
71
- yield node.text('Simple', 2, linear);
72
- yield* waitFor(1);
73
-
74
- const leaf = node.childAs<TxtLeaf>(0)!;
75
-
76
- expect(node.children().length).toBe(1);
77
- expect(node.text()).toBe('Apple Ban');
78
- expect(leaf.text()).toBe('Apple Ban');
79
- }),
80
- );
81
- });
1
+ import {linear, waitFor} from '@twick/core';
2
+ import {describe, expect, it, vi} from 'vitest';
3
+ import {Txt} from './Txt';
4
+ import {TxtLeaf} from './TxtLeaf';
5
+ import {generatorTest} from './__tests__/generatorTest';
6
+ import {mockScene2D} from './__tests__/mockScene2D';
7
+
8
+ describe('Txt', () => {
9
+ mockScene2D();
10
+
11
+ it('Handle plain text', () => {
12
+ const node = (<Txt lineWidth={8}>test</Txt>) as Txt;
13
+
14
+ const parseSpy = vi.spyOn(node as any, 'parseChildren');
15
+ const leaf = node.childAs<TxtLeaf>(0);
16
+
17
+ expect(node.text()).toBe('test');
18
+ expect(node.lineWidth()).toBe(8);
19
+ expect(node.children().length).toBe(1);
20
+ expect(leaf).toBeInstanceOf(TxtLeaf);
21
+ expect(leaf!.text()).toBe('test');
22
+ expect(leaf!.lineWidth()).toBe(8);
23
+
24
+ node.lineWidth(16);
25
+ node.text('changed');
26
+
27
+ expect(node.childAs(0)).toBe(leaf);
28
+ expect(leaf!.lineWidth()).toBe(16);
29
+ expect(leaf!.text()).toBe('changed');
30
+
31
+ // Parsing should not happen when operating exclusively on simple text
32
+ expect(parseSpy).toHaveBeenCalledTimes(0);
33
+ });
34
+
35
+ it('Handle complex text', () => {
36
+ const node = (
37
+ <Txt lineWidth={8}>
38
+ Apple <Txt>Banana</Txt> Cherry
39
+ </Txt>
40
+ ) as Txt;
41
+
42
+ const first = node.childAs<TxtLeaf>(0);
43
+ const second = node.childAs<Txt>(1);
44
+ const third = node.childAs<TxtLeaf>(2);
45
+
46
+ expect(node.text()).toBe('Apple Banana Cherry');
47
+ expect(node.lineWidth()).toBe(8);
48
+ expect(node.children().length).toBe(3);
49
+ expect(first).toBeInstanceOf(TxtLeaf);
50
+ expect(first!.text()).toBe('Apple ');
51
+ expect(first!.lineWidth()).toBe(8);
52
+
53
+ expect(second).toBeInstanceOf(Txt);
54
+ expect(second!.text()).toBe('Banana');
55
+ expect(second!.lineWidth()).toBe(8);
56
+
57
+ expect(third).toBeInstanceOf(TxtLeaf);
58
+ expect(third!.text()).toBe(' Cherry');
59
+ expect(third!.lineWidth()).toBe(8);
60
+ });
61
+
62
+ it(
63
+ 'Tween complex to simple text',
64
+ generatorTest(function* () {
65
+ const node = (
66
+ <Txt>
67
+ <Txt>Apple</Txt> Banana
68
+ </Txt>
69
+ ) as Txt;
70
+
71
+ yield node.text('Simple', 2, linear);
72
+ yield* waitFor(1);
73
+
74
+ const leaf = node.childAs<TxtLeaf>(0)!;
75
+
76
+ expect(node.children().length).toBe(1);
77
+ expect(node.text()).toBe('Apple Ban');
78
+ expect(leaf.text()).toBe('Apple Ban');
79
+ }),
80
+ );
81
+ });
@@ -1,203 +1,203 @@
1
- import type {
2
- InterpolationFunction,
3
- SignalValue,
4
- SimpleSignal,
5
- ThreadGenerator,
6
- TimingFunction,
7
- } from '@twick/core';
8
- import {DEFAULT, all, capitalize, threadable} from '@twick/core';
9
- import {computed, initial, nodeName, signal} from '../decorators';
10
- import {is} from '../utils';
11
- import type {Node} from './Node';
12
- import type {ShapeProps} from './Shape';
13
- import {Shape} from './Shape';
14
- import {TXT_TYPE, TxtLeaf} from './TxtLeaf';
15
- import type {ComponentChildren} from './types';
16
-
17
- type TxtChildren = string | Node | (string | Node)[];
18
- type AnyTxt = Txt | TxtLeaf;
19
-
20
- export interface TxtProps extends ShapeProps {
21
- children?: TxtChildren;
22
- text?: SignalValue<string>;
23
- }
24
-
25
- @nodeName('Txt')
26
- export class Txt extends Shape {
27
- public readonly [TXT_TYPE] = true;
28
-
29
- /**
30
- * Create a bold text node.
31
- *
32
- * @remarks
33
- * This is a shortcut for
34
- * ```tsx
35
- * <Txt fontWeight={700} />
36
- * ```
37
- *
38
- * @param props - Additional text properties.
39
- */
40
- public static b(props: TxtProps) {
41
- return new Txt({...props, fontWeight: 700});
42
- }
43
-
44
- /**
45
- * Create an italic text node.
46
- *
47
- * @remarks
48
- * This is a shortcut for
49
- * ```tsx
50
- * <Txt fontStyle={'italic'} />
51
- * ```
52
- *
53
- * @param props - Additional text properties.
54
- */
55
- public static i(props: TxtProps) {
56
- return new Txt({...props, fontStyle: 'italic'});
57
- }
58
-
59
- @initial('')
60
- @signal()
61
- public declare readonly text: SimpleSignal<string, this>;
62
-
63
- protected getText(): string {
64
- return this.innerText();
65
- }
66
-
67
- protected setText(value: SignalValue<string>) {
68
- const children = this.children();
69
- let leaf: TxtLeaf | null = null;
70
- for (let i = 0; i < children.length; i++) {
71
- const child = children[i];
72
- if (leaf === null && child instanceof TxtLeaf) {
73
- leaf = child;
74
- } else {
75
- child.parent(null);
76
- }
77
- }
78
-
79
- if (leaf === null) {
80
- leaf = new TxtLeaf({text: value});
81
- leaf.parent(this);
82
- } else {
83
- leaf.text(value);
84
- }
85
-
86
- this.setParsedChildren([leaf]);
87
- }
88
-
89
- protected override setChildren(value: SignalValue<ComponentChildren>) {
90
- if (this.children.context.raw() === value) {
91
- return;
92
- }
93
-
94
- if (typeof value === 'string') {
95
- this.text(value);
96
- } else {
97
- super.setChildren(value);
98
- }
99
- }
100
-
101
- @threadable()
102
- protected *tweenText(
103
- value: SignalValue<string>,
104
- time: number,
105
- timingFunction: TimingFunction,
106
- interpolationFunction: InterpolationFunction<string>,
107
- ): ThreadGenerator {
108
- yield document.fonts?.ready;
109
- const children = this.children();
110
- if (children.length !== 1 || !(children[0] instanceof TxtLeaf)) {
111
- this.text.save();
112
- }
113
-
114
- const leaf = this.childAs<TxtLeaf>(0)!;
115
- const oldText = leaf.text.context.raw();
116
- const oldSize = this.size.context.raw();
117
- leaf.text(value);
118
- const newSize = this.size();
119
- leaf.text(oldText ?? DEFAULT);
120
-
121
- if (this.height() === 0) {
122
- this.height(newSize.height);
123
- }
124
-
125
- yield* all(
126
- this.size(newSize, time, timingFunction),
127
- leaf.text(value, time, timingFunction, interpolationFunction),
128
- );
129
-
130
- this.children.context.setter(value);
131
- this.size(oldSize);
132
- }
133
-
134
- protected getLayout(): boolean {
135
- return true;
136
- }
137
-
138
- public constructor({children, text, ...props}: TxtProps) {
139
- super(props);
140
- this.children(text ?? children);
141
- }
142
-
143
- @computed()
144
- protected innerText(): string {
145
- const children = this.childrenAs<Txt | TxtLeaf>();
146
- let text = '';
147
- for (const child of children) {
148
- text += child.text();
149
- }
150
-
151
- return text;
152
- }
153
-
154
- @computed()
155
- protected parentTxt() {
156
- const parent = this.parent();
157
- return parent instanceof Txt ? parent : null;
158
- }
159
-
160
- protected override parseChildren(children: ComponentChildren): AnyTxt[] {
161
- const result: AnyTxt[] = [];
162
- const array = Array.isArray(children) ? children : [children];
163
- for (const child of array) {
164
- if (child instanceof Txt || child instanceof TxtLeaf) {
165
- result.push(child);
166
- } else if (typeof child === 'string') {
167
- result.push(new TxtLeaf({text: child}));
168
- }
169
- }
170
-
171
- return result;
172
- }
173
-
174
- protected override applyFlex() {
175
- super.applyFlex();
176
- this.element.style.display = this.findAncestor(is(Txt))
177
- ? 'inline'
178
- : 'block';
179
- }
180
-
181
- protected override async draw(context: CanvasRenderingContext2D) {
182
- await document.fonts?.ready;
183
- await this.drawChildren(context);
184
- }
185
- }
186
-
187
- [
188
- 'fill',
189
- 'stroke',
190
- 'lineWidth',
191
- 'strokeFirst',
192
- 'lineCap',
193
- 'lineJoin',
194
- 'lineDash',
195
- 'lineDashOffset',
196
- ].forEach(prop => {
197
- (Txt.prototype as any)[`getDefault${capitalize(prop)}`] = function (
198
- this: Txt,
199
- initial: unknown,
200
- ) {
201
- return (this.parentTxt() as any)?.[prop]() ?? initial;
202
- };
203
- });
1
+ import type {
2
+ InterpolationFunction,
3
+ SignalValue,
4
+ SimpleSignal,
5
+ ThreadGenerator,
6
+ TimingFunction,
7
+ } from '@twick/core';
8
+ import {DEFAULT, all, capitalize, threadable} from '@twick/core';
9
+ import {computed, initial, nodeName, signal} from '../decorators';
10
+ import {is} from '../utils';
11
+ import type {Node} from './Node';
12
+ import type {ShapeProps} from './Shape';
13
+ import {Shape} from './Shape';
14
+ import {TXT_TYPE, TxtLeaf} from './TxtLeaf';
15
+ import type {ComponentChildren} from './types';
16
+
17
+ type TxtChildren = string | Node | (string | Node)[];
18
+ type AnyTxt = Txt | TxtLeaf;
19
+
20
+ export interface TxtProps extends ShapeProps {
21
+ children?: TxtChildren;
22
+ text?: SignalValue<string>;
23
+ }
24
+
25
+ @nodeName('Txt')
26
+ export class Txt extends Shape {
27
+ public readonly [TXT_TYPE] = true;
28
+
29
+ /**
30
+ * Create a bold text node.
31
+ *
32
+ * @remarks
33
+ * This is a shortcut for
34
+ * ```tsx
35
+ * <Txt fontWeight={700} />
36
+ * ```
37
+ *
38
+ * @param props - Additional text properties.
39
+ */
40
+ public static b(props: TxtProps) {
41
+ return new Txt({...props, fontWeight: 700});
42
+ }
43
+
44
+ /**
45
+ * Create an italic text node.
46
+ *
47
+ * @remarks
48
+ * This is a shortcut for
49
+ * ```tsx
50
+ * <Txt fontStyle={'italic'} />
51
+ * ```
52
+ *
53
+ * @param props - Additional text properties.
54
+ */
55
+ public static i(props: TxtProps) {
56
+ return new Txt({...props, fontStyle: 'italic'});
57
+ }
58
+
59
+ @initial('')
60
+ @signal()
61
+ public declare readonly text: SimpleSignal<string, this>;
62
+
63
+ protected getText(): string {
64
+ return this.innerText();
65
+ }
66
+
67
+ protected setText(value: SignalValue<string>) {
68
+ const children = this.children();
69
+ let leaf: TxtLeaf | null = null;
70
+ for (let i = 0; i < children.length; i++) {
71
+ const child = children[i];
72
+ if (leaf === null && child instanceof TxtLeaf) {
73
+ leaf = child;
74
+ } else {
75
+ child.parent(null);
76
+ }
77
+ }
78
+
79
+ if (leaf === null) {
80
+ leaf = new TxtLeaf({text: value});
81
+ leaf.parent(this);
82
+ } else {
83
+ leaf.text(value);
84
+ }
85
+
86
+ this.setParsedChildren([leaf]);
87
+ }
88
+
89
+ protected override setChildren(value: SignalValue<ComponentChildren>) {
90
+ if (this.children.context.raw() === value) {
91
+ return;
92
+ }
93
+
94
+ if (typeof value === 'string') {
95
+ this.text(value);
96
+ } else {
97
+ super.setChildren(value);
98
+ }
99
+ }
100
+
101
+ @threadable()
102
+ protected *tweenText(
103
+ value: SignalValue<string>,
104
+ time: number,
105
+ timingFunction: TimingFunction,
106
+ interpolationFunction: InterpolationFunction<string>,
107
+ ): ThreadGenerator {
108
+ yield document.fonts?.ready;
109
+ const children = this.children();
110
+ if (children.length !== 1 || !(children[0] instanceof TxtLeaf)) {
111
+ this.text.save();
112
+ }
113
+
114
+ const leaf = this.childAs<TxtLeaf>(0)!;
115
+ const oldText = leaf.text.context.raw();
116
+ const oldSize = this.size.context.raw();
117
+ leaf.text(value);
118
+ const newSize = this.size();
119
+ leaf.text(oldText ?? DEFAULT);
120
+
121
+ if (this.height() === 0) {
122
+ this.height(newSize.height);
123
+ }
124
+
125
+ yield* all(
126
+ this.size(newSize, time, timingFunction),
127
+ leaf.text(value, time, timingFunction, interpolationFunction),
128
+ );
129
+
130
+ this.children.context.setter(value);
131
+ this.size(oldSize);
132
+ }
133
+
134
+ protected getLayout(): boolean {
135
+ return true;
136
+ }
137
+
138
+ public constructor({children, text, ...props}: TxtProps) {
139
+ super(props);
140
+ this.children(text ?? children);
141
+ }
142
+
143
+ @computed()
144
+ protected innerText(): string {
145
+ const children = this.childrenAs<Txt | TxtLeaf>();
146
+ let text = '';
147
+ for (const child of children) {
148
+ text += child.text();
149
+ }
150
+
151
+ return text;
152
+ }
153
+
154
+ @computed()
155
+ protected parentTxt() {
156
+ const parent = this.parent();
157
+ return parent instanceof Txt ? parent : null;
158
+ }
159
+
160
+ protected override parseChildren(children: ComponentChildren): AnyTxt[] {
161
+ const result: AnyTxt[] = [];
162
+ const array = Array.isArray(children) ? children : [children];
163
+ for (const child of array) {
164
+ if (child instanceof Txt || child instanceof TxtLeaf) {
165
+ result.push(child);
166
+ } else if (typeof child === 'string') {
167
+ result.push(new TxtLeaf({text: child}));
168
+ }
169
+ }
170
+
171
+ return result;
172
+ }
173
+
174
+ protected override applyFlex() {
175
+ super.applyFlex();
176
+ this.element.style.display = this.findAncestor(is(Txt))
177
+ ? 'inline'
178
+ : 'block';
179
+ }
180
+
181
+ protected override async draw(context: CanvasRenderingContext2D) {
182
+ await document.fonts?.ready;
183
+ await this.drawChildren(context);
184
+ }
185
+ }
186
+
187
+ [
188
+ 'fill',
189
+ 'stroke',
190
+ 'lineWidth',
191
+ 'strokeFirst',
192
+ 'lineCap',
193
+ 'lineJoin',
194
+ 'lineDash',
195
+ 'lineDashOffset',
196
+ ].forEach(prop => {
197
+ (Txt.prototype as any)[`getDefault${capitalize(prop)}`] = function (
198
+ this: Txt,
199
+ initial: unknown,
200
+ ) {
201
+ return (this.parentTxt() as any)?.[prop]() ?? initial;
202
+ };
203
+ });