@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,92 +1,92 @@
1
- import {
2
- createContext,
3
- Types,
4
- type ChildSpace3D,
5
- type Node3D,
6
- type Type,
7
- type Vector3,
8
- // Named so the emitted declaration reaches these through the sdk, not core.
9
- type Context as _Context,
10
- } from "@motionscript/sdk";
11
- import type { Interval } from "../kit/coords";
12
-
13
- /**
14
- * A 3D graph's coordinates, as its axes' local space sees them. A graph is
15
- * right-handed with z up, and the scene has y up, so graph x, y and z run along
16
- * the scene's z, x and y: looked at head-on, y is to the right and z is up.
17
- */
18
- export interface GraphSpace extends ChildSpace3D {
19
- readonly xRange: Interval;
20
- readonly yRange: Interval;
21
- readonly zRange: Interval;
22
- /** Changes exactly when the mapping does: what a mark's geometry is cached under. */
23
- readonly revision: string;
24
- /** A step from one graph point to another, as the local one: what a mark's own geometry is drawn in. */
25
- offset(x: number, y: number, z: number): Vector3;
26
- }
27
-
28
- /** The space of a box `lengths` on a side, in scene units, showing the three ranges, centred on its node. */
29
- export function graphSpace(xRange: Interval, yRange: Interval, zRange: Interval, lengths: Vector3): GraphSpace {
30
- const ux = unit(xRange, lengths.x);
31
- const uy = unit(yRange, lengths.y);
32
- const uz = unit(zRange, lengths.z);
33
- const cx = (xRange[0] + xRange[1]) / 2;
34
- const cy = (yRange[0] + yRange[1]) / 2;
35
- const cz = (zRange[0] + zRange[1]) / 2;
36
- return {
37
- xRange,
38
- yRange,
39
- zRange,
40
- revision: [xRange, yRange, zRange, lengths.x, lengths.y, lengths.z].join("|"),
41
- toLocal: (x, y, z) => ({ x: (y - cy) * uy, y: (z - cz) * uz, z: (x - cx) * ux }),
42
- offset: (x, y, z) => ({ x: y * uy, y: z * uz, z: x * ux }),
43
- };
44
- }
45
-
46
- function unit([min, max]: Interval, length: number): number {
47
- const span = max - min;
48
- return span > 0 ? length / span : 0;
49
- }
50
-
51
- /** A 3D graph, as the marks inside it see it: its coordinates as they stand now. */
52
- export interface Graph3D {
53
- space(): GraphSpace;
54
- }
55
-
56
- /** The graph a mark is inside: `axes3d` provides itself to everything in it. */
57
- export const GRAPH_3D = createContext<Graph3D | null>(null, "math:graph3d");
58
-
59
- /**
60
- * The entry a mark reads the graph it is drawn in through, set from the nearest
61
- * `axes3d` above it, through any 3D node between; `null` outside one.
62
- */
63
- export function graphEntry(): Type<Graph3D | null, Graph3D | null, true> {
64
- return Types.custom<Graph3D | null, Graph3D | null, { readonly private: true }>(null, {
65
- private: true,
66
- inherit: (use) => use(GRAPH_3D),
67
- });
68
- }
69
-
70
- /** The graph space a mark with a {@link graphEntry} is drawn in, or `null` outside a graph. */
71
- export function graphOf(mark: { readonly graph: Graph3D | null }): GraphSpace | null {
72
- return mark.graph?.space() ?? null;
73
- }
74
-
75
- /** The graph a 3D node is drawn in: what the nearest `axes3d` above it provides, once it is in the tree. */
76
- export function spaceOf(mark: Node3D): GraphSpace | null {
77
- return mark.useContext(GRAPH_3D)?.space() ?? null;
78
- }
79
-
80
- /** A unit quaternion turning the scene's +y, the way a cylinder or a cone points, onto `direction`. */
81
- export function aim(direction: Vector3): { x: number; y: number; z: number; w: number } {
82
- const length = Math.hypot(direction.x, direction.y, direction.z);
83
- if (!(length > 0)) return { x: 0, y: 0, z: 0, w: 1 };
84
- const dx = direction.x / length;
85
- const dy = direction.y / length;
86
- const dz = direction.z / length;
87
- // Straight down is the one turn with no single axis: any in the ground plane will do.
88
- if (dy < -1 + 1e-9) return { x: 1, y: 0, z: 0, w: 0 };
89
- const w = 1 + dy;
90
- const norm = Math.hypot(dz, dx, w);
91
- return { x: dz / norm, y: 0, z: -dx / norm, w: w / norm };
92
- }
1
+ import {
2
+ createContext,
3
+ Types,
4
+ type ChildSpace3D,
5
+ type Node3D,
6
+ type Type,
7
+ type Vector3,
8
+ // Named so the emitted declaration reaches these through the sdk, not core.
9
+ type Context as _Context,
10
+ } from "@motionscript/sdk";
11
+ import type { Interval } from "../kit/coords";
12
+
13
+ /**
14
+ * A 3D graph's coordinates, as its axes' local space sees them. A graph is
15
+ * right-handed with z up, and the scene has y up, so graph x, y and z run along
16
+ * the scene's z, x and y: looked at head-on, y is to the right and z is up.
17
+ */
18
+ export interface GraphSpace extends ChildSpace3D {
19
+ readonly xRange: Interval;
20
+ readonly yRange: Interval;
21
+ readonly zRange: Interval;
22
+ /** Changes exactly when the mapping does: what a mark's geometry is cached under. */
23
+ readonly revision: string;
24
+ /** A step from one graph point to another, as the local one: what a mark's own geometry is drawn in. */
25
+ offset(x: number, y: number, z: number): Vector3;
26
+ }
27
+
28
+ /** The space of a box `lengths` on a side, in scene units, showing the three ranges, centred on its node. */
29
+ export function graphSpace(xRange: Interval, yRange: Interval, zRange: Interval, lengths: Vector3): GraphSpace {
30
+ const ux = unit(xRange, lengths.x);
31
+ const uy = unit(yRange, lengths.y);
32
+ const uz = unit(zRange, lengths.z);
33
+ const cx = (xRange[0] + xRange[1]) / 2;
34
+ const cy = (yRange[0] + yRange[1]) / 2;
35
+ const cz = (zRange[0] + zRange[1]) / 2;
36
+ return {
37
+ xRange,
38
+ yRange,
39
+ zRange,
40
+ revision: [xRange, yRange, zRange, lengths.x, lengths.y, lengths.z].join("|"),
41
+ toLocal: (x, y, z) => ({ x: (y - cy) * uy, y: (z - cz) * uz, z: (x - cx) * ux }),
42
+ offset: (x, y, z) => ({ x: y * uy, y: z * uz, z: x * ux }),
43
+ };
44
+ }
45
+
46
+ function unit([min, max]: Interval, length: number): number {
47
+ const span = max - min;
48
+ return span > 0 ? length / span : 0;
49
+ }
50
+
51
+ /** A 3D graph, as the marks inside it see it: its coordinates as they stand now. */
52
+ export interface Graph3D {
53
+ space(): GraphSpace;
54
+ }
55
+
56
+ /** The graph a mark is inside: `axes3d` provides itself to everything in it. */
57
+ export const GRAPH_3D = createContext<Graph3D | null>(null, "math:graph3d");
58
+
59
+ /**
60
+ * The entry a mark reads the graph it is drawn in through, set from the nearest
61
+ * `axes3d` above it, through any 3D node between; `null` outside one.
62
+ */
63
+ export function graphEntry(): Type<Graph3D | null, Graph3D | null, true> {
64
+ return Types.custom<Graph3D | null, Graph3D | null, { readonly private: true }>(null, {
65
+ private: true,
66
+ inherit: (use) => use(GRAPH_3D),
67
+ });
68
+ }
69
+
70
+ /** The graph space a mark with a {@link graphEntry} is drawn in, or `null` outside a graph. */
71
+ export function graphOf(mark: { readonly graph: Graph3D | null }): GraphSpace | null {
72
+ return mark.graph?.space() ?? null;
73
+ }
74
+
75
+ /** The graph a 3D node is drawn in: what the nearest `axes3d` above it provides, once it is in the tree. */
76
+ export function spaceOf(mark: Node3D): GraphSpace | null {
77
+ return mark.useContext(GRAPH_3D)?.space() ?? null;
78
+ }
79
+
80
+ /** A unit quaternion turning the scene's +y, the way a cylinder or a cone points, onto `direction`. */
81
+ export function aim(direction: Vector3): { x: number; y: number; z: number; w: number } {
82
+ const length = Math.hypot(direction.x, direction.y, direction.z);
83
+ if (!(length > 0)) return { x: 0, y: 0, z: 0, w: 1 };
84
+ const dx = direction.x / length;
85
+ const dy = direction.y / length;
86
+ const dz = direction.z / length;
87
+ // Straight down is the one turn with no single axis: any in the ground plane will do.
88
+ if (dy < -1 + 1e-9) return { x: 1, y: 0, z: 0, w: 0 };
89
+ const w = 1 + dy;
90
+ const norm = Math.hypot(dz, dx, w);
91
+ return { x: dz / norm, y: 0, z: -dx / norm, w: w / norm };
92
+ }