@motionscript/math 0.1.0-alpha.4 → 0.1.0-alpha.6

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 (233) hide show
  1. package/CHANGELOG.md +132 -92
  2. package/README.md +39 -33
  3. package/dist/annotate/angle-mark.d.ts +52 -27
  4. package/dist/annotate/angle-mark.d.ts.map +1 -1
  5. package/dist/annotate/angle-mark.js +80 -115
  6. package/dist/annotate/angle-mark.js.map +1 -1
  7. package/dist/annotate/curly-brace.d.ts +59 -25
  8. package/dist/annotate/curly-brace.d.ts.map +1 -1
  9. package/dist/annotate/curly-brace.js +85 -100
  10. package/dist/annotate/curly-brace.js.map +1 -1
  11. package/dist/annotate/emphasis-mark.d.ts +43 -9
  12. package/dist/annotate/emphasis-mark.d.ts.map +1 -1
  13. package/dist/annotate/emphasis-mark.js +33 -34
  14. package/dist/annotate/emphasis-mark.js.map +1 -1
  15. package/dist/browser/chunks/chunk-ABYBW64J.js +2 -0
  16. package/dist/browser/chunks/chunk-ABYBW64J.js.map +7 -0
  17. package/dist/browser/chunks/chunk-K77KLQX4.js +2 -0
  18. package/dist/browser/chunks/chunk-K77KLQX4.js.map +7 -0
  19. package/dist/browser/index.js +1 -1
  20. package/dist/browser/index.js.map +3 -3
  21. package/dist/browser/kit.js +1 -1
  22. package/dist/browser/manifest.json +1 -1
  23. package/dist/browser/tex.js +1 -1
  24. package/dist/browser/tex.js.map +2 -2
  25. package/dist/engine.d.ts +26 -19
  26. package/dist/engine.d.ts.map +1 -1
  27. package/dist/engine.js +17 -14
  28. package/dist/engine.js.map +1 -1
  29. package/dist/kit/component.d.ts +51 -0
  30. package/dist/kit/component.d.ts.map +1 -0
  31. package/dist/kit/component.js +30 -0
  32. package/dist/kit/component.js.map +1 -0
  33. package/dist/kit/curve.d.ts +22 -11
  34. package/dist/kit/curve.d.ts.map +1 -1
  35. package/dist/kit/curve.js +25 -18
  36. package/dist/kit/curve.js.map +1 -1
  37. package/dist/kit/field-mark.d.ts +58 -35
  38. package/dist/kit/field-mark.d.ts.map +1 -1
  39. package/dist/kit/field-mark.js +100 -120
  40. package/dist/kit/field-mark.js.map +1 -1
  41. package/dist/kit/follow.d.ts +67 -29
  42. package/dist/kit/follow.d.ts.map +1 -1
  43. package/dist/kit/follow.js +114 -110
  44. package/dist/kit/follow.js.map +1 -1
  45. package/dist/kit/furniture.d.ts +3 -1
  46. package/dist/kit/furniture.d.ts.map +1 -1
  47. package/dist/kit/furniture.js +5 -0
  48. package/dist/kit/furniture.js.map +1 -1
  49. package/dist/kit/graph.d.ts +46 -0
  50. package/dist/kit/graph.d.ts.map +1 -0
  51. package/dist/kit/graph.js +90 -0
  52. package/dist/kit/graph.js.map +1 -0
  53. package/dist/kit/mark.d.ts +64 -39
  54. package/dist/kit/mark.d.ts.map +1 -1
  55. package/dist/kit/mark.js +80 -96
  56. package/dist/kit/mark.js.map +1 -1
  57. package/dist/kit/place.d.ts +10 -8
  58. package/dist/kit/place.d.ts.map +1 -1
  59. package/dist/kit/place.js +28 -30
  60. package/dist/kit/place.js.map +1 -1
  61. package/dist/kit/system.d.ts +27 -29
  62. package/dist/kit/system.d.ts.map +1 -1
  63. package/dist/kit/system.js +62 -58
  64. package/dist/kit/system.js.map +1 -1
  65. package/dist/kit/withdrawn.d.ts +3 -3
  66. package/dist/kit/withdrawn.js +3 -3
  67. package/dist/kit/withdrawn.js.map +1 -1
  68. package/dist/marks/curve-area.d.ts +24 -18
  69. package/dist/marks/curve-area.d.ts.map +1 -1
  70. package/dist/marks/curve-area.js +50 -73
  71. package/dist/marks/curve-area.js.map +1 -1
  72. package/dist/marks/drop-lines.d.ts +28 -10
  73. package/dist/marks/drop-lines.d.ts.map +1 -1
  74. package/dist/marks/drop-lines.js +37 -52
  75. package/dist/marks/drop-lines.js.map +1 -1
  76. package/dist/marks/plot-point.d.ts +37 -20
  77. package/dist/marks/plot-point.d.ts.map +1 -1
  78. package/dist/marks/plot-point.js +65 -91
  79. package/dist/marks/plot-point.js.map +1 -1
  80. package/dist/marks/riemann-sum.d.ts +30 -26
  81. package/dist/marks/riemann-sum.d.ts.map +1 -1
  82. package/dist/marks/riemann-sum.js +57 -85
  83. package/dist/marks/riemann-sum.js.map +1 -1
  84. package/dist/marks/tangent-line.d.ts +38 -14
  85. package/dist/marks/tangent-line.d.ts.map +1 -1
  86. package/dist/marks/tangent-line.js +73 -87
  87. package/dist/marks/tangent-line.js.map +1 -1
  88. package/dist/marks/vector-arrow.d.ts +30 -20
  89. package/dist/marks/vector-arrow.d.ts.map +1 -1
  90. package/dist/marks/vector-arrow.js +58 -78
  91. package/dist/marks/vector-arrow.js.map +1 -1
  92. package/dist/nodes.d.ts +13 -5
  93. package/dist/nodes.d.ts.map +1 -1
  94. package/dist/nodes.js +0 -6
  95. package/dist/nodes.js.map +1 -1
  96. package/dist/plots/function-plot.d.ts +107 -43
  97. package/dist/plots/function-plot.d.ts.map +1 -1
  98. package/dist/plots/function-plot.js +146 -177
  99. package/dist/plots/function-plot.js.map +1 -1
  100. package/dist/plots/points-plot.d.ts +34 -19
  101. package/dist/plots/points-plot.d.ts.map +1 -1
  102. package/dist/plots/points-plot.js +31 -58
  103. package/dist/plots/points-plot.js.map +1 -1
  104. package/dist/plots/stream-lines.d.ts +38 -19
  105. package/dist/plots/stream-lines.d.ts.map +1 -1
  106. package/dist/plots/stream-lines.js +60 -79
  107. package/dist/plots/stream-lines.js.map +1 -1
  108. package/dist/plots/traced-path.d.ts +34 -15
  109. package/dist/plots/traced-path.d.ts.map +1 -1
  110. package/dist/plots/traced-path.js +33 -48
  111. package/dist/plots/traced-path.js.map +1 -1
  112. package/dist/plots/vector-field.d.ts +31 -11
  113. package/dist/plots/vector-field.d.ts.map +1 -1
  114. package/dist/plots/vector-field.js +50 -64
  115. package/dist/plots/vector-field.js.map +1 -1
  116. package/dist/structures/network-graph.d.ts +99 -49
  117. package/dist/structures/network-graph.d.ts.map +1 -1
  118. package/dist/structures/network-graph.js +168 -217
  119. package/dist/structures/network-graph.js.map +1 -1
  120. package/dist/structures/sample-space.d.ts +69 -38
  121. package/dist/structures/sample-space.d.ts.map +1 -1
  122. package/dist/structures/sample-space.js +132 -170
  123. package/dist/structures/sample-space.js.map +1 -1
  124. package/dist/systems/axes2d.d.ts +126 -37
  125. package/dist/systems/axes2d.d.ts.map +1 -1
  126. package/dist/systems/axes2d.js +147 -183
  127. package/dist/systems/axes2d.js.map +1 -1
  128. package/dist/systems/number-line.d.ts +51 -28
  129. package/dist/systems/number-line.d.ts.map +1 -1
  130. package/dist/systems/number-line.js +82 -118
  131. package/dist/systems/number-line.js.map +1 -1
  132. package/dist/systems/number-plane.d.ts +92 -31
  133. package/dist/systems/number-plane.d.ts.map +1 -1
  134. package/dist/systems/number-plane.js +142 -149
  135. package/dist/systems/number-plane.js.map +1 -1
  136. package/dist/systems/polar-plane.d.ts +47 -26
  137. package/dist/systems/polar-plane.d.ts.map +1 -1
  138. package/dist/systems/polar-plane.js +107 -133
  139. package/dist/systems/polar-plane.js.map +1 -1
  140. package/dist/tex/index.d.ts.map +1 -1
  141. package/dist/tex/index.js +1 -0
  142. package/dist/tex/index.js.map +1 -1
  143. package/dist/tex/matrix.d.ts +56 -18
  144. package/dist/tex/matrix.d.ts.map +1 -1
  145. package/dist/tex/matrix.js +33 -50
  146. package/dist/tex/matrix.js.map +1 -1
  147. package/dist/tex/node.d.ts +55 -201
  148. package/dist/tex/node.d.ts.map +1 -1
  149. package/dist/tex/node.js +23 -593
  150. package/dist/tex/node.js.map +1 -1
  151. package/dist/tex/typeset.d.ts +133 -0
  152. package/dist/tex/typeset.d.ts.map +1 -0
  153. package/dist/tex/typeset.js +403 -0
  154. package/dist/tex/typeset.js.map +1 -0
  155. package/dist/three/axes3d.d.ts +140 -54
  156. package/dist/three/axes3d.d.ts.map +1 -1
  157. package/dist/three/axes3d.js +159 -204
  158. package/dist/three/axes3d.js.map +1 -1
  159. package/dist/three/curve-plot3d.d.ts +70 -42
  160. package/dist/three/curve-plot3d.d.ts.map +1 -1
  161. package/dist/three/curve-plot3d.js +97 -132
  162. package/dist/three/curve-plot3d.js.map +1 -1
  163. package/dist/three/entries.d.ts +17 -0
  164. package/dist/three/entries.d.ts.map +1 -0
  165. package/dist/three/entries.js +15 -0
  166. package/dist/three/entries.js.map +1 -0
  167. package/dist/three/plot-point3d.d.ts +57 -12
  168. package/dist/three/plot-point3d.d.ts.map +1 -1
  169. package/dist/three/plot-point3d.js +27 -53
  170. package/dist/three/plot-point3d.js.map +1 -1
  171. package/dist/three/space.d.ts +17 -2
  172. package/dist/three/space.d.ts.map +1 -1
  173. package/dist/three/space.js +19 -8
  174. package/dist/three/space.js.map +1 -1
  175. package/dist/three/surface-plot3d.d.ts +131 -49
  176. package/dist/three/surface-plot3d.d.ts.map +1 -1
  177. package/dist/three/surface-plot3d.js +227 -261
  178. package/dist/three/surface-plot3d.js.map +1 -1
  179. package/dist/three/vector-arrow3d.d.ts +58 -16
  180. package/dist/three/vector-arrow3d.d.ts.map +1 -1
  181. package/dist/three/vector-arrow3d.js +48 -67
  182. package/dist/three/vector-arrow3d.js.map +1 -1
  183. package/package.json +4 -4
  184. package/src/annotate/angle-mark.ts +95 -105
  185. package/src/annotate/curly-brace.ts +107 -85
  186. package/src/annotate/emphasis-mark.ts +55 -26
  187. package/src/engine.ts +35 -21
  188. package/src/kit/component.ts +57 -0
  189. package/src/kit/curve.ts +38 -20
  190. package/src/kit/field-mark.ts +124 -108
  191. package/src/kit/follow.ts +146 -120
  192. package/src/kit/furniture.ts +6 -1
  193. package/src/kit/graph.ts +116 -0
  194. package/src/kit/mark.ts +135 -114
  195. package/src/kit/place.ts +32 -56
  196. package/src/kit/system.ts +77 -71
  197. package/src/kit/withdrawn.ts +3 -3
  198. package/src/marks/curve-area.ts +65 -65
  199. package/src/marks/drop-lines.ts +50 -42
  200. package/src/marks/plot-point.ts +77 -82
  201. package/src/marks/riemann-sum.ts +73 -72
  202. package/src/marks/tangent-line.ts +87 -71
  203. package/src/marks/vector-arrow.ts +73 -73
  204. package/src/nodes.ts +41 -5
  205. package/src/plots/function-plot.ts +155 -171
  206. package/src/plots/points-plot.ts +46 -50
  207. package/src/plots/stream-lines.ts +75 -66
  208. package/src/plots/traced-path.ts +51 -33
  209. package/src/plots/vector-field.ts +68 -49
  210. package/src/structures/network-graph.ts +168 -185
  211. package/src/structures/sample-space.ts +149 -148
  212. package/src/systems/axes2d.ts +165 -156
  213. package/src/systems/number-line.ts +91 -92
  214. package/src/systems/number-plane.ts +149 -120
  215. package/src/systems/polar-plane.ts +117 -116
  216. package/src/tex/index.ts +2 -1
  217. package/src/tex/matrix.ts +62 -40
  218. package/src/tex/node.ts +54 -621
  219. package/src/tex/typeset.ts +461 -0
  220. package/src/three/axes3d.ts +182 -161
  221. package/src/three/curve-plot3d.ts +107 -110
  222. package/src/three/entries.ts +42 -0
  223. package/src/three/plot-point3d.ts +42 -45
  224. package/src/three/space.ts +34 -9
  225. package/src/three/surface-plot3d.ts +312 -323
  226. package/src/three/vector-arrow3d.ts +65 -54
  227. package/dist/browser/chunks/chunk-3GJB6AVO.js +0 -2
  228. package/dist/browser/chunks/chunk-3GJB6AVO.js.map +0 -7
  229. package/dist/browser/chunks/chunk-D5WHCVBC.js +0 -2
  230. package/dist/browser/chunks/chunk-D5WHCVBC.js.map +0 -7
  231. package/dist/browser/chunks/chunk-WL4KEX7Y.js +0 -2
  232. package/dist/browser/chunks/chunk-WL4KEX7Y.js.map +0 -7
  233. package/src/kit/placement.ts +0 -8
@@ -0,0 +1,42 @@
1
+ import {
2
+ Material,
3
+ Types,
4
+ type EntryOptions,
5
+ type Geometry3D,
6
+ type Type,
7
+ // Named so the emitted declaration reaches these through the sdk, not core.
8
+ type Blend3D as _Blend3D,
9
+ type Color as _Color,
10
+ type Faces3D as _Faces3D,
11
+ type Fill3D as _Fill3D,
12
+ type Material3D as _Material3D,
13
+ type NormalizedColor as _NormalizedColor,
14
+ type Shading3D as _Shading3D,
15
+ type Texture3D as _Texture3D,
16
+ } from "@motionscript/sdk";
17
+ import type { Interval } from "../kit/coords";
18
+ import { lerpDomain } from "../kit/source";
19
+
20
+ type MeshState = { readonly geometry: Type<Geometry3D | undefined> } & typeof Material.state;
21
+ // Restated key by key, so a mark spreading these names each entry's type through the sdk: spread
22
+ // as inferred, a mark's declaration copied `emission`'s colour types from core's own.
23
+ type Restated<T> = { [K in Extract<keyof T, string>]: T[K] };
24
+
25
+ /**
26
+ * A mesh's entries, as a 3D mark draws with them: its surface, and the
27
+ * `geometry` a mesh takes, which a mark builds itself and never reads.
28
+ */
29
+ export const meshEntries: Restated<MeshState> = {
30
+ geometry: Types.custom<Geometry3D | undefined>(undefined),
31
+ ...Material.state,
32
+ };
33
+
34
+ interface RangeHints extends EntryOptions {
35
+ readonly defaultMin: number;
36
+ readonly defaultMax: number;
37
+ }
38
+
39
+ /** A span of a variable, unset until given: what a host offers as a range from `defaultMin` to `defaultMax`. */
40
+ export function domainEntry(defaultMin: number, defaultMax: number): Type<Interval | null> {
41
+ return Types.custom<Interval | null, Interval | null, RangeHints>(null, { lerp: lerpDomain, kind: "range", defaultMin, defaultMax });
42
+ }
@@ -1,16 +1,25 @@
1
1
  import {
2
- colorProperty,
2
+ component3d,
3
3
  Geo,
4
- Graphics3D,
5
- Mesh3D,
6
- node,
7
- property,
8
- type AssetScope,
4
+ Material,
5
+ Types,
9
6
  type Color,
10
- type Geometry3D,
11
7
  type Mesh3DProps,
12
- type NodeConfig,
8
+ type NodeOf,
9
+ // Named so the emitted declaration reaches these through the sdk, not core.
10
+ type Blend3D as _Blend3D,
11
+ type Color as _Color,
12
+ type Faces3D as _Faces3D,
13
+ type Fill3D as _Fill3D,
14
+ type Geometry3D as _Geometry3D,
15
+ type Material3D as _Material3D,
16
+ type Node3D as _Node3D,
17
+ type Node3DProps as _Node3DProps,
18
+ type NormalizedColor as _NormalizedColor,
19
+ type Shading3D as _Shading3D,
20
+ type Texture3D as _Texture3D,
13
21
  } from "@motionscript/sdk";
22
+ import { meshEntries } from "./entries";
14
23
  import { drawLabel3D } from "./label3d";
15
24
 
16
25
  export interface PlotPoint3dProps extends Mesh3DProps {
@@ -25,42 +34,30 @@ export interface PlotPoint3dProps extends Mesh3DProps {
25
34
  * A dot at graph coordinates in a 3D graph, with an optional label. Put inside
26
35
  * a surface it rides it: its `x` and `y` say where, and its height is the surface's.
27
36
  */
28
- @node({
37
+ export const PlotPoint3d = component3d({
29
38
  key: "plotPoint3d",
30
- within: ["axes3d", "surfacePlot3d"],
31
- forkable: true,
32
- layout: { acceptsChildren: false },
33
- seed: { fill: "#facc15" },
34
- })
35
- export class PlotPoint3d extends Mesh3D<PlotPoint3dProps> {
36
- /** In scene units, so a point is the same size whatever the axes show. */
37
- @property({ default: 0.1, min: 0, step: 0.01 }) declare radius: number;
38
- @property({ default: "", animatable: false }) declare label: string;
39
- /** The height of the label's text, in scene units. */
40
- @property({ default: 0.26, min: 0.01, step: 0.01 }) declare labelSize: number;
41
- @colorProperty({ default: "#e5e7eb" }) declare labelColor: Color;
42
- @property({ default: "", animatable: false }) declare fontFamily: string;
43
-
44
- constructor(props?: NodeConfig<PlotPoint3d, PlotPoint3dProps>) {
45
- super(props ?? {});
46
- }
47
-
48
- override declareAssets(assets: AssetScope): void {
49
- super.declareAssets(assets);
50
- if (this.fontFamily !== "") assets.font(this.fontFamily);
51
- }
52
-
53
- protected override buildGeometry(): Geometry3D | undefined {
54
- return this.radius > 0 ? Geo.sphere({ radius: this.radius, segments: [24, 16] }) : undefined;
55
- }
56
-
57
- protected override buildGraphics3D(): Graphics3D {
58
- const g3 = super.buildGraphics3D();
59
- drawLabel3D(g3, this.label, { x: 0, y: this.radius + this.labelSize * 0.85, z: 0 }, {
60
- size: this.labelSize,
61
- color: this.labelColor,
62
- fontFamily: this.fontFamily,
39
+ state: {
40
+ ...meshEntries,
41
+ /** In scene units, so a point is the same size whatever the axes show. */
42
+ radius: Types.number(0.1, { min: 0, step: 0.01 }),
43
+ label: Types.text("", { animatable: false }),
44
+ /** The height of the label's text, in scene units. */
45
+ labelSize: Types.number(0.26, { min: 0.01, step: 0.01 }),
46
+ labelColor: Types.color("#e5e7eb"),
47
+ fontFamily: Types.text("", { animatable: false }),
48
+ },
49
+ load: (loader, s) => {
50
+ if (s.fontFamily !== "") loader.font(s.fontFamily);
51
+ },
52
+ render: (ctx, s) => {
53
+ const g3 = Material.mesh(s, s.radius > 0 ? Geo.sphere({ radius: s.radius, segments: [24, 16] }) : undefined);
54
+ drawLabel3D(g3, s.label, { x: 0, y: s.radius + s.labelSize * 0.85, z: 0 }, {
55
+ size: s.labelSize,
56
+ color: s.labelColor,
57
+ fontFamily: s.fontFamily,
63
58
  });
64
- return g3;
65
- }
66
- }
59
+ ctx.draw(g3);
60
+ },
61
+ });
62
+
63
+ export type PlotPoint3d = NodeOf<typeof PlotPoint3d>;
@@ -1,4 +1,13 @@
1
- import { Node3D, type ChildSpace3D, type Vector3 } from "@motionscript/sdk";
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";
2
11
  import type { Interval } from "../kit/coords";
3
12
 
4
13
  /**
@@ -39,17 +48,33 @@ function unit([min, max]: Interval, length: number): number {
39
48
  return span > 0 ? length / span : 0;
40
49
  }
41
50
 
42
- interface Spaced {
43
- _graphSpace(): GraphSpace;
51
+ /** A 3D graph, as the marks inside it see it: its coordinates as they stand now. */
52
+ export interface Graph3D {
53
+ space(): GraphSpace;
44
54
  }
45
55
 
46
- /** The graph a 3D mark is drawn in: its nearest ancestor that has one, up to and including the viewport. */
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. */
47
76
  export function spaceOf(mark: Node3D): GraphSpace | null {
48
- for (let at = mark.parent; at; at = at instanceof Node3D ? at.parent : null) {
49
- const spaced = at as Partial<Spaced>;
50
- if (typeof spaced._graphSpace === "function") return spaced._graphSpace();
51
- }
52
- return null;
77
+ return mark.useContext(GRAPH_3D)?.space() ?? null;
53
78
  }
54
79
 
55
80
  /** A unit quaternion turning the scene's +y, the way a cylinder or a cone points, onto `direction`. */