@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,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
+ });