@motionscript/math 0.1.0-alpha.7 → 0.1.0-alpha.9

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 (181) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/LICENSE +201 -201
  3. package/NOTICE +49 -48
  4. package/README.md +390 -391
  5. package/dist/annotate/angle-mark.d.ts +6 -6
  6. package/dist/annotate/angle-mark.js.map +1 -1
  7. package/dist/annotate/curly-brace.d.ts +9 -9
  8. package/dist/annotate/curly-brace.js.map +1 -1
  9. package/dist/annotate/emphasis-mark.d.ts +9 -9
  10. package/dist/annotate/emphasis-mark.js.map +1 -1
  11. package/dist/browser/chunks/{chunk-ABYBW64J.js → chunk-IRZCG6PM.js} +2 -2
  12. package/dist/browser/chunks/chunk-IRZCG6PM.js.map +7 -0
  13. package/dist/browser/chunks/{chunk-K77KLQX4.js → chunk-WMVW6ZIV.js} +2 -2
  14. package/dist/browser/chunks/chunk-WMVW6ZIV.js.map +7 -0
  15. package/dist/browser/chunks/{mathjax-DNP3YRES.js → mathjax-WV55AC2P.js} +1 -1
  16. package/dist/browser/chunks/{mathjax-DNP3YRES.js.map → mathjax-WV55AC2P.js.map} +1 -1
  17. package/dist/browser/index.js +1 -1
  18. package/dist/browser/index.js.map +3 -3
  19. package/dist/browser/kit.js +1 -1
  20. package/dist/browser/manifest.json +1 -1
  21. package/dist/browser/tex.js +1 -1
  22. package/dist/browser/tex.js.map +1 -1
  23. package/dist/engine.d.ts +1 -1
  24. package/dist/engine.js +1 -1
  25. package/dist/engine.js.map +1 -1
  26. package/dist/index.js.map +1 -1
  27. package/dist/kit/brace.js.map +1 -1
  28. package/dist/kit/cache.js.map +1 -1
  29. package/dist/kit/component.d.ts.map +1 -1
  30. package/dist/kit/component.js.map +1 -1
  31. package/dist/kit/contour.js.map +1 -1
  32. package/dist/kit/coords.js.map +1 -1
  33. package/dist/kit/curve.js.map +1 -1
  34. package/dist/kit/equation.js.map +1 -1
  35. package/dist/kit/equation3d.js.map +1 -1
  36. package/dist/kit/expression.js.map +1 -1
  37. package/dist/kit/field-mark.d.ts.map +1 -1
  38. package/dist/kit/field-mark.js.map +1 -1
  39. package/dist/kit/field.js.map +1 -1
  40. package/dist/kit/follow.d.ts +2 -2
  41. package/dist/kit/follow.d.ts.map +1 -1
  42. package/dist/kit/follow.js.map +1 -1
  43. package/dist/kit/furniture.js.map +1 -1
  44. package/dist/kit/geometry.js.map +1 -1
  45. package/dist/kit/graph.js.map +1 -1
  46. package/dist/kit/mark.js.map +1 -1
  47. package/dist/kit/part-fills.js.map +1 -1
  48. package/dist/kit/place.js.map +1 -1
  49. package/dist/kit/sampler.js +1 -1
  50. package/dist/kit/sampler.js.map +1 -1
  51. package/dist/kit/scale.js.map +1 -1
  52. package/dist/kit/source.js.map +1 -1
  53. package/dist/kit/system.js.map +1 -1
  54. package/dist/kit/ticks.js.map +1 -1
  55. package/dist/kit/withdrawn.js.map +1 -1
  56. package/dist/marks/curve-area.js.map +1 -1
  57. package/dist/marks/drop-lines.d.ts +6 -6
  58. package/dist/marks/drop-lines.js.map +1 -1
  59. package/dist/marks/plot-point.d.ts +3 -3
  60. package/dist/marks/plot-point.js.map +1 -1
  61. package/dist/marks/riemann-sum.d.ts +3 -3
  62. package/dist/marks/riemann-sum.js.map +1 -1
  63. package/dist/marks/tangent-line.d.ts +6 -6
  64. package/dist/marks/tangent-line.js.map +1 -1
  65. package/dist/marks/vector-arrow.d.ts +6 -6
  66. package/dist/marks/vector-arrow.js.map +1 -1
  67. package/dist/nodes.js.map +1 -1
  68. package/dist/plots/function-plot.d.ts +8 -8
  69. package/dist/plots/function-plot.d.ts.map +1 -1
  70. package/dist/plots/function-plot.js.map +1 -1
  71. package/dist/plots/points-plot.js.map +1 -1
  72. package/dist/plots/stream-lines.js.map +1 -1
  73. package/dist/plots/traced-path.js.map +1 -1
  74. package/dist/plots/vector-field.js.map +1 -1
  75. package/dist/structures/graph-layout.js.map +1 -1
  76. package/dist/structures/network-graph.js.map +1 -1
  77. package/dist/structures/sample-space.js.map +1 -1
  78. package/dist/systems/axes2d.d.ts.map +1 -1
  79. package/dist/systems/axes2d.js.map +1 -1
  80. package/dist/systems/number-line.js.map +1 -1
  81. package/dist/systems/number-plane.js.map +1 -1
  82. package/dist/systems/polar-plane.js.map +1 -1
  83. package/dist/tex/geometry.js.map +1 -1
  84. package/dist/tex/index.js.map +1 -1
  85. package/dist/tex/mathjax.js.map +1 -1
  86. package/dist/tex/matrix.d.ts +2 -2
  87. package/dist/tex/matrix.js.map +1 -1
  88. package/dist/tex/node.d.ts +2 -2
  89. package/dist/tex/node.js.map +1 -1
  90. package/dist/tex/tween.js.map +1 -1
  91. package/dist/tex/typeset.d.ts +4 -4
  92. package/dist/tex/typeset.d.ts.map +1 -1
  93. package/dist/tex/typeset.js.map +1 -1
  94. package/dist/three/axes3d.js.map +1 -1
  95. package/dist/three/curve-plot3d.d.ts +27 -27
  96. package/dist/three/curve-plot3d.d.ts.map +1 -1
  97. package/dist/three/curve-plot3d.js +3 -2
  98. package/dist/three/curve-plot3d.js.map +1 -1
  99. package/dist/three/entries.js.map +1 -1
  100. package/dist/three/label3d.d.ts.map +1 -1
  101. package/dist/three/label3d.js +3 -1
  102. package/dist/three/label3d.js.map +1 -1
  103. package/dist/three/plot-point3d.d.ts +27 -27
  104. package/dist/three/plot-point3d.js.map +1 -1
  105. package/dist/three/space.js.map +1 -1
  106. package/dist/three/surface-plot3d.d.ts +36 -36
  107. package/dist/three/surface-plot3d.js +6 -1
  108. package/dist/three/surface-plot3d.js.map +1 -1
  109. package/dist/three/vector-arrow3d.d.ts +27 -27
  110. package/dist/three/vector-arrow3d.js.map +1 -1
  111. package/package.json +5 -4
  112. package/registry.json +251 -251
  113. package/src/annotate/angle-mark.ts +137 -137
  114. package/src/annotate/curly-brace.ts +148 -148
  115. package/src/annotate/emphasis-mark.ts +118 -118
  116. package/src/engine.ts +86 -86
  117. package/src/index.ts +29 -29
  118. package/src/kit/brace.ts +37 -37
  119. package/src/kit/cache.ts +61 -61
  120. package/src/kit/component.ts +57 -57
  121. package/src/kit/contour.ts +94 -94
  122. package/src/kit/coords.ts +278 -278
  123. package/src/kit/curve.ts +47 -47
  124. package/src/kit/equation.ts +181 -181
  125. package/src/kit/equation3d.ts +137 -137
  126. package/src/kit/expression.ts +159 -159
  127. package/src/kit/field-mark.ts +171 -171
  128. package/src/kit/field.ts +50 -50
  129. package/src/kit/follow.ts +229 -229
  130. package/src/kit/furniture.ts +113 -113
  131. package/src/kit/geometry.ts +49 -49
  132. package/src/kit/graph.ts +116 -116
  133. package/src/kit/mark.ts +152 -152
  134. package/src/kit/part-fills.ts +61 -61
  135. package/src/kit/place.ts +77 -77
  136. package/src/kit/sampler.ts +281 -281
  137. package/src/kit/scale.ts +39 -39
  138. package/src/kit/source.ts +57 -57
  139. package/src/kit/system.ts +105 -105
  140. package/src/kit/ticks.ts +85 -85
  141. package/src/kit/withdrawn.ts +8 -8
  142. package/src/marks/curve-area.ts +89 -89
  143. package/src/marks/drop-lines.ts +71 -71
  144. package/src/marks/plot-point.ts +102 -102
  145. package/src/marks/riemann-sum.ts +99 -99
  146. package/src/marks/tangent-line.ts +119 -119
  147. package/src/marks/vector-arrow.ts +98 -98
  148. package/src/nodes.ts +99 -99
  149. package/src/plots/function-plot.ts +220 -220
  150. package/src/plots/points-plot.ts +103 -103
  151. package/src/plots/stream-lines.ts +160 -160
  152. package/src/plots/traced-path.ts +70 -70
  153. package/src/plots/vector-field.ts +107 -107
  154. package/src/structures/graph-layout.ts +145 -145
  155. package/src/structures/network-graph.ts +291 -291
  156. package/src/structures/sample-space.ts +210 -210
  157. package/src/systems/axes2d.ts +226 -226
  158. package/src/systems/number-line.ts +130 -130
  159. package/src/systems/number-plane.ts +232 -232
  160. package/src/systems/polar-plane.ts +177 -177
  161. package/src/tex/geometry.ts +703 -703
  162. package/src/tex/index.ts +15 -15
  163. package/src/tex/mathjax.ts +82 -82
  164. package/src/tex/matrix.ts +97 -97
  165. package/src/tex/node.ts +74 -74
  166. package/src/tex/tween.ts +308 -308
  167. package/src/tex/typeset.ts +461 -461
  168. package/src/three/axes3d.ts +267 -267
  169. package/src/three/curve-plot3d.ts +146 -144
  170. package/src/three/entries.ts +42 -42
  171. package/src/three/label3d.ts +52 -50
  172. package/src/three/plot-point3d.ts +63 -63
  173. package/src/three/space.ts +92 -92
  174. package/src/three/surface-plot3d.ts +318 -312
  175. package/src/three/vector-arrow3d.ts +88 -88
  176. package/dist/browser/chunks/chunk-ABYBW64J.js.map +0 -7
  177. package/dist/browser/chunks/chunk-K77KLQX4.js.map +0 -7
  178. package/dist/kit/placement.d.ts +0 -8
  179. package/dist/kit/placement.d.ts.map +0 -1
  180. package/dist/kit/placement.js +0 -8
  181. package/dist/kit/placement.js.map +0 -1
@@ -1,130 +1,130 @@
1
- import {
2
- component2d,
3
- Graphics2D,
4
- Types,
5
- type Color,
6
- type Extents,
7
- type NodeOf,
8
- type NormalizedColor,
9
- type PaintProps,
10
- type StrokeResolved,
11
- type Values,
12
- type Vector2,
13
- // Named so the emitted declaration reaches these through the sdk, not core.
14
- type Fill as _Fill,
15
- type FillResolved as _FillResolved,
16
- type Node2D as _Node2D,
17
- type Node2DProps as _Node2DProps,
18
- type Shadow as _Shadow,
19
- type ShadowResolved as _ShadowResolved,
20
- type Stroke as _Stroke,
21
- } from "@motionscript/sdk";
22
- import { listed, PAINT, PAINT_COMMANDS } from "../kit/component";
23
- import { cartesianMap, resolveInterval, type AxisScaling, type CoordinateMap, type Interval } from "../kit/coords";
24
- import { along, AXIS_COLOR, drawLabels, drawn, lerpInterval, readInterval, withoutTips, type Label } from "../kit/furniture";
25
- import { drawSystem, systemLayout, systemMap, systemOpenPlane, systemProvides, systemSize } from "../kit/system";
26
- import { formatTick, ticksFor } from "../kit/ticks";
27
-
28
- export interface NumberLineProps extends PaintProps {
29
- range?: Interval;
30
- step?: number;
31
- scaling?: AxisScaling;
32
- ticks?: boolean;
33
- tickSize?: number;
34
- longTicks?: number[];
35
- labels?: boolean;
36
- labelExclude?: number[];
37
- labelSide?: "below" | "above";
38
- labelSize?: number;
39
- labelColor?: Color;
40
- fontFamily?: string;
41
- }
42
-
43
- const state = {
44
- ...PAINT,
45
- range: Types.custom<Interval>([-5, 5], { resolve: readInterval, lerp: lerpInterval }),
46
- /** The spacing of the ticks; zero picks a tidy one for the line's length. */
47
- step: Types.number(0, { min: 0 }),
48
- scaling: listed(["linear", "log"], "linear", { animatable: false }),
49
- ticks: Types.boolean(true, { animatable: false }),
50
- tickSize: Types.number(12, { min: 0, unit: "px" }),
51
- /** Values whose ticks are drawn twice as long. */
52
- longTicks: Types.custom<number[]>([], { animatable: false }),
53
- labels: Types.boolean(true, { animatable: false }),
54
- labelExclude: Types.custom<number[]>([], { animatable: false }),
55
- labelSide: listed(["below", "above"], "below", { animatable: false }),
56
- labelSize: Types.number(18, { min: 1, unit: "px" }),
57
- labelColor: Types.color(AXIS_COLOR),
58
- fontFamily: Types.text("", { animatable: false }),
59
- };
60
-
61
- type LineValues = Values<typeof state>;
62
-
63
- /**
64
- * One axis with ticks and numbers. A child's `x` is a value on the line and its
65
- * `y` is pixels above it, so a dot or a label sits on a number.
66
- */
67
- export const NumberLine = component2d({
68
- key: "numberLine",
69
- state,
70
- defaults: { stroke: { weight: 2, fill: AXIS_COLOR, align: "center" } },
71
- load: (loader, s) => {
72
- if (s.fontFamily !== "") loader.font(s.fontFamily);
73
- },
74
- commands: {
75
- ...PAINT_COMMANDS,
76
- /** Animate the span of values the line shows: a pan when both ends move alike, a zoom when they do not. */
77
- rangeTo: { args: ["range"] },
78
- },
79
- provide: (s) => systemProvides(s),
80
- measure: (_measurer, s) => systemSize(s),
81
- layout: (box, s, children) => systemLayout(box, s, children, lineMap),
82
- plane: (box, s) => systemOpenPlane(box, s, lineMap),
83
- render: (ctx, s) => drawSystem(ctx, s, systemMap(ctx.size, s, lineMap), (map) => lineFurniture(map, s)),
84
- });
85
-
86
- export type NumberLine = NodeOf<typeof NumberLine>;
87
-
88
- function lineMap(area: Extents, s: LineValues): CoordinateMap {
89
- return cartesianMap({
90
- xRange: resolveInterval(s.range, s.scaling),
91
- yRange: [area.minY, area.maxY],
92
- area,
93
- xScaling: s.scaling,
94
- });
95
- }
96
-
97
- function lineFurniture(map: CoordinateMap, s: LineValues): Graphics2D[] {
98
- const stroke = s.stroke as StrokeResolved[];
99
- const { start, end } = s;
100
- const [min, max] = map.xRange;
101
- const from = map.toPoint(min, 0);
102
- const to = map.toPoint(max, 0);
103
- const parts: Graphics2D[] = [];
104
- if (stroke.length > 0) parts.push(new Graphics2D().line({ points: [from, to], radius: 0, start, end }).stroke(stroke));
105
-
106
- const marks = ticksFor(map.xRange, s.step, to.x - from.x, s.scaling);
107
- const sign = s.labelSide === "below" ? -1 : 1;
108
- const tickMarks = new Graphics2D();
109
- const labels: Label[] = [];
110
- let ticked = false;
111
- for (const value of marks.values) {
112
- const at: Vector2 = map.toPoint(value, 0);
113
- if (!drawn(along(at, from, to), start, end)) continue;
114
- const half = s.longTicks.includes(value) ? s.tickSize : s.tickSize / 2;
115
- if (s.ticks && half > 0) {
116
- tickMarks.line({ points: [{ x: at.x, y: at.y - half }, { x: at.x, y: at.y + half }], radius: 0 });
117
- ticked = true;
118
- }
119
- if (s.labels && !s.labelExclude.includes(value)) {
120
- labels.push({
121
- text: formatTick(value, marks.step),
122
- at: { x: at.x, y: at.y + sign * (s.tickSize / 2 + s.labelSize * 0.9) },
123
- align: "center",
124
- });
125
- }
126
- }
127
- if (ticked && stroke.length > 0) parts.push(tickMarks.stroke(withoutTips(stroke)));
128
- parts.push(...drawLabels(labels, { fontSize: s.labelSize, fontFamily: s.fontFamily, color: s.labelColor as NormalizedColor }));
129
- return parts;
130
- }
1
+ import {
2
+ component2d,
3
+ Graphics2D,
4
+ Types,
5
+ type Color,
6
+ type Extents,
7
+ type NodeOf,
8
+ type NormalizedColor,
9
+ type PaintProps,
10
+ type StrokeResolved,
11
+ type Values,
12
+ type Vector2,
13
+ // Named so the emitted declaration reaches these through the sdk, not core.
14
+ type Fill as _Fill,
15
+ type FillResolved as _FillResolved,
16
+ type Node2D as _Node2D,
17
+ type Node2DProps as _Node2DProps,
18
+ type Shadow as _Shadow,
19
+ type ShadowResolved as _ShadowResolved,
20
+ type Stroke as _Stroke,
21
+ } from "@motionscript/sdk";
22
+ import { listed, PAINT, PAINT_COMMANDS } from "../kit/component";
23
+ import { cartesianMap, resolveInterval, type AxisScaling, type CoordinateMap, type Interval } from "../kit/coords";
24
+ import { along, AXIS_COLOR, drawLabels, drawn, lerpInterval, readInterval, withoutTips, type Label } from "../kit/furniture";
25
+ import { drawSystem, systemLayout, systemMap, systemOpenPlane, systemProvides, systemSize } from "../kit/system";
26
+ import { formatTick, ticksFor } from "../kit/ticks";
27
+
28
+ export interface NumberLineProps extends PaintProps {
29
+ range?: Interval;
30
+ step?: number;
31
+ scaling?: AxisScaling;
32
+ ticks?: boolean;
33
+ tickSize?: number;
34
+ longTicks?: number[];
35
+ labels?: boolean;
36
+ labelExclude?: number[];
37
+ labelSide?: "below" | "above";
38
+ labelSize?: number;
39
+ labelColor?: Color;
40
+ fontFamily?: string;
41
+ }
42
+
43
+ const state = {
44
+ ...PAINT,
45
+ range: Types.custom<Interval>([-5, 5], { resolve: readInterval, lerp: lerpInterval }),
46
+ /** The spacing of the ticks; zero picks a tidy one for the line's length. */
47
+ step: Types.number(0, { min: 0 }),
48
+ scaling: listed(["linear", "log"], "linear", { animatable: false }),
49
+ ticks: Types.boolean(true, { animatable: false }),
50
+ tickSize: Types.number(12, { min: 0, unit: "px" }),
51
+ /** Values whose ticks are drawn twice as long. */
52
+ longTicks: Types.custom<number[]>([], { animatable: false }),
53
+ labels: Types.boolean(true, { animatable: false }),
54
+ labelExclude: Types.custom<number[]>([], { animatable: false }),
55
+ labelSide: listed(["below", "above"], "below", { animatable: false }),
56
+ labelSize: Types.number(18, { min: 1, unit: "px" }),
57
+ labelColor: Types.color(AXIS_COLOR),
58
+ fontFamily: Types.text("", { animatable: false }),
59
+ };
60
+
61
+ type LineValues = Values<typeof state>;
62
+
63
+ /**
64
+ * One axis with ticks and numbers. A child's `x` is a value on the line and its
65
+ * `y` is pixels above it, so a dot or a label sits on a number.
66
+ */
67
+ export const NumberLine = component2d({
68
+ key: "numberLine",
69
+ state,
70
+ defaults: { stroke: { weight: 2, fill: AXIS_COLOR, align: "center" } },
71
+ load: (loader, s) => {
72
+ if (s.fontFamily !== "") loader.font(s.fontFamily);
73
+ },
74
+ commands: {
75
+ ...PAINT_COMMANDS,
76
+ /** Animate the span of values the line shows: a pan when both ends move alike, a zoom when they do not. */
77
+ rangeTo: { args: ["range"] },
78
+ },
79
+ provide: (s) => systemProvides(s),
80
+ measure: (_measurer, s) => systemSize(s),
81
+ layout: (box, s, children) => systemLayout(box, s, children, lineMap),
82
+ plane: (box, s) => systemOpenPlane(box, s, lineMap),
83
+ render: (ctx, s) => drawSystem(ctx, s, systemMap(ctx.size, s, lineMap), (map) => lineFurniture(map, s)),
84
+ });
85
+
86
+ export type NumberLine = NodeOf<typeof NumberLine>;
87
+
88
+ function lineMap(area: Extents, s: LineValues): CoordinateMap {
89
+ return cartesianMap({
90
+ xRange: resolveInterval(s.range, s.scaling),
91
+ yRange: [area.minY, area.maxY],
92
+ area,
93
+ xScaling: s.scaling,
94
+ });
95
+ }
96
+
97
+ function lineFurniture(map: CoordinateMap, s: LineValues): Graphics2D[] {
98
+ const stroke = s.stroke as StrokeResolved[];
99
+ const { start, end } = s;
100
+ const [min, max] = map.xRange;
101
+ const from = map.toPoint(min, 0);
102
+ const to = map.toPoint(max, 0);
103
+ const parts: Graphics2D[] = [];
104
+ if (stroke.length > 0) parts.push(new Graphics2D().line({ points: [from, to], radius: 0, start, end }).stroke(stroke));
105
+
106
+ const marks = ticksFor(map.xRange, s.step, to.x - from.x, s.scaling);
107
+ const sign = s.labelSide === "below" ? -1 : 1;
108
+ const tickMarks = new Graphics2D();
109
+ const labels: Label[] = [];
110
+ let ticked = false;
111
+ for (const value of marks.values) {
112
+ const at: Vector2 = map.toPoint(value, 0);
113
+ if (!drawn(along(at, from, to), start, end)) continue;
114
+ const half = s.longTicks.includes(value) ? s.tickSize : s.tickSize / 2;
115
+ if (s.ticks && half > 0) {
116
+ tickMarks.line({ points: [{ x: at.x, y: at.y - half }, { x: at.x, y: at.y + half }], radius: 0 });
117
+ ticked = true;
118
+ }
119
+ if (s.labels && !s.labelExclude.includes(value)) {
120
+ labels.push({
121
+ text: formatTick(value, marks.step),
122
+ at: { x: at.x, y: at.y + sign * (s.tickSize / 2 + s.labelSize * 0.9) },
123
+ align: "center",
124
+ });
125
+ }
126
+ }
127
+ if (ticked && stroke.length > 0) parts.push(tickMarks.stroke(withoutTips(stroke)));
128
+ parts.push(...drawLabels(labels, { fontSize: s.labelSize, fontFamily: s.fontFamily, color: s.labelColor as NormalizedColor }));
129
+ return parts;
130
+ }