@typeonce/ritmo-math 0.13.0 → 0.15.0

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 (113) hide show
  1. package/CHANGELOG.md +149 -0
  2. package/README.md +18 -13
  3. package/dist/Angle.d.ts +44 -0
  4. package/dist/Angle.d.ts.map +1 -0
  5. package/dist/Angle.js +62 -0
  6. package/dist/Angle.js.map +1 -0
  7. package/dist/Box2.d.ts +16 -4
  8. package/dist/Box2.d.ts.map +1 -1
  9. package/dist/Box2.js +16 -1
  10. package/dist/Box2.js.map +1 -1
  11. package/dist/Collide2.d.ts +59 -15
  12. package/dist/Collide2.d.ts.map +1 -1
  13. package/dist/Collide2.js +156 -18
  14. package/dist/Collide2.js.map +1 -1
  15. package/dist/FlowField.d.ts +24 -38
  16. package/dist/FlowField.d.ts.map +1 -1
  17. package/dist/FlowField.js +18 -5
  18. package/dist/FlowField.js.map +1 -1
  19. package/dist/Scalar.d.ts +19 -166
  20. package/dist/Scalar.d.ts.map +1 -1
  21. package/dist/Scalar.js +51 -51
  22. package/dist/Scalar.js.map +1 -1
  23. package/dist/Segment2.d.ts +56 -0
  24. package/dist/Segment2.d.ts.map +1 -0
  25. package/dist/Segment2.js +32 -0
  26. package/dist/Segment2.js.map +1 -0
  27. package/dist/Vec2.d.ts +47 -7
  28. package/dist/Vec2.d.ts.map +1 -1
  29. package/dist/Vec2.js +56 -8
  30. package/dist/Vec2.js.map +1 -1
  31. package/dist/index.d.ts +10 -21
  32. package/dist/index.d.ts.map +1 -1
  33. package/dist/index.js +10 -21
  34. package/dist/index.js.map +1 -1
  35. package/package.json +3 -3
  36. package/src/Angle.ts +60 -0
  37. package/src/Box2.ts +20 -4
  38. package/src/Collide2.ts +171 -24
  39. package/src/FlowField.ts +34 -10
  40. package/src/Scalar.ts +43 -165
  41. package/src/Segment2.ts +71 -0
  42. package/src/Vec2.ts +58 -8
  43. package/src/index.ts +10 -21
  44. package/dist/Aabb.d.ts +0 -182
  45. package/dist/Aabb.d.ts.map +0 -1
  46. package/dist/Aabb.js +0 -109
  47. package/dist/Aabb.js.map +0 -1
  48. package/dist/InputAxis.d.ts +0 -44
  49. package/dist/InputAxis.d.ts.map +0 -1
  50. package/dist/InputAxis.js +0 -71
  51. package/dist/InputAxis.js.map +0 -1
  52. package/dist/Ops.d.ts +0 -209
  53. package/dist/Ops.d.ts.map +0 -1
  54. package/dist/Ops.js +0 -210
  55. package/dist/Ops.js.map +0 -1
  56. package/dist/Random.d.ts +0 -124
  57. package/dist/Random.d.ts.map +0 -1
  58. package/dist/Random.js +0 -126
  59. package/dist/Random.js.map +0 -1
  60. package/dist/Size2.d.ts +0 -118
  61. package/dist/Size2.d.ts.map +0 -1
  62. package/dist/Size2.js +0 -54
  63. package/dist/Size2.js.map +0 -1
  64. package/dist/SpatialGrid.d.ts +0 -68
  65. package/dist/SpatialGrid.d.ts.map +0 -1
  66. package/dist/SpatialGrid.js +0 -112
  67. package/dist/SpatialGrid.js.map +0 -1
  68. package/dist/Vector2.d.ts +0 -214
  69. package/dist/Vector2.d.ts.map +0 -1
  70. package/dist/Vector2.js +0 -134
  71. package/dist/Vector2.js.map +0 -1
  72. package/dist/internal/aabb.d.ts +0 -27
  73. package/dist/internal/aabb.d.ts.map +0 -1
  74. package/dist/internal/aabb.js +0 -52
  75. package/dist/internal/aabb.js.map +0 -1
  76. package/dist/internal/codec.d.ts +0 -9
  77. package/dist/internal/codec.d.ts.map +0 -1
  78. package/dist/internal/codec.js +0 -16
  79. package/dist/internal/codec.js.map +0 -1
  80. package/dist/internal/fdlibm.d.ts +0 -43
  81. package/dist/internal/fdlibm.d.ts.map +0 -1
  82. package/dist/internal/fdlibm.js +0 -1291
  83. package/dist/internal/fdlibm.js.map +0 -1
  84. package/dist/internal/inputAxis.d.ts +0 -11
  85. package/dist/internal/inputAxis.d.ts.map +0 -1
  86. package/dist/internal/inputAxis.js +0 -13
  87. package/dist/internal/inputAxis.js.map +0 -1
  88. package/dist/internal/scalar.d.ts +0 -11
  89. package/dist/internal/scalar.d.ts.map +0 -1
  90. package/dist/internal/scalar.js +0 -68
  91. package/dist/internal/scalar.js.map +0 -1
  92. package/dist/internal/size2.d.ts +0 -22
  93. package/dist/internal/size2.d.ts.map +0 -1
  94. package/dist/internal/size2.js +0 -38
  95. package/dist/internal/size2.js.map +0 -1
  96. package/dist/internal/vector2.d.ts +0 -39
  97. package/dist/internal/vector2.d.ts.map +0 -1
  98. package/dist/internal/vector2.js +0 -78
  99. package/dist/internal/vector2.js.map +0 -1
  100. package/src/Aabb.ts +0 -180
  101. package/src/InputAxis.ts +0 -81
  102. package/src/Ops.ts +0 -232
  103. package/src/Random.ts +0 -225
  104. package/src/Size2.ts +0 -122
  105. package/src/SpatialGrid.ts +0 -172
  106. package/src/Vector2.ts +0 -216
  107. package/src/internal/aabb.ts +0 -81
  108. package/src/internal/codec.ts +0 -21
  109. package/src/internal/fdlibm.ts +0 -1256
  110. package/src/internal/inputAxis.ts +0 -21
  111. package/src/internal/scalar.ts +0 -104
  112. package/src/internal/size2.ts +0 -54
  113. package/src/internal/vector2.ts +0 -121
@@ -1,21 +0,0 @@
1
- import * as Vector2 from "../Vector2.ts"
2
- import type { Axis } from "../InputAxis.ts"
3
-
4
- export const axis = (negativePressed: boolean, positivePressed: boolean): Axis => {
5
- if (negativePressed === positivePressed) {
6
- return 0
7
- }
8
-
9
- return negativePressed ? -1 : 1
10
- }
11
-
12
- export const vectorFromAxisValues = (horizontal: Axis, vertical: Axis): Vector2.Vector2 =>
13
- Vector2.normalizeOrZero({
14
- x: horizontal,
15
- y: vertical
16
- } as Vector2.Vector2)
17
-
18
- export const vectorFromAxes = (
19
- input: { readonly left: boolean; readonly right: boolean; readonly up: boolean; readonly down: boolean }
20
- ): Vector2.Vector2 =>
21
- vectorFromAxisValues(axis(input.left, input.right), axis(input.up, input.down))
@@ -1,104 +0,0 @@
1
- import * as Result from "@typeonce/ritmo/Result"
2
- import type * as Scalar from "../Scalar.ts"
3
- import { codecOf } from "./codec.ts"
4
-
5
- // A branded number's constructors, guard, and codec, from its check.
6
- const refine = <Value extends number>(
7
- validate: (raw: number) => Result.Result<Value, Scalar.Error>,
8
- expected: string
9
- ): Scalar.Constructor<Value> => ({
10
- result: validate,
11
- option: (raw) => {
12
- const result = validate(raw)
13
- return result.ok ? result.value : null
14
- },
15
- is: (raw): raw is Value => typeof raw === "number" && validate(raw).ok,
16
- codec: codecOf<number, Value>((raw) => typeof raw === "number" ? validate(raw) : Result.failure(raw), expected)
17
- })
18
-
19
- export const Finite = refine<Scalar.Finite>((value) =>
20
- Number.isFinite(value)
21
- ? Result.success(value as Scalar.Finite)
22
- : Result.failure({
23
- tag: "Scalar/NotFinite",
24
- value
25
- }),
26
- "a finite number"
27
- )
28
-
29
- export const NonNegative = refine<Scalar.NonNegative>((value) => {
30
- const finite = Finite.result(value)
31
- if (!finite.ok) {
32
- return finite
33
- }
34
-
35
- return value >= 0
36
- ? Result.success(value as Scalar.NonNegative)
37
- : Result.failure({
38
- tag: "Scalar/Negative",
39
- value
40
- })
41
- }, "a finite number, 0 or more")
42
-
43
- export const Positive = refine<Scalar.Positive>((value) => {
44
- const finite = Finite.result(value)
45
- if (!finite.ok) {
46
- return finite
47
- }
48
-
49
- return value > 0
50
- ? Result.success(value as Scalar.Positive)
51
- : Result.failure({
52
- tag: "Scalar/NonPositive",
53
- value
54
- })
55
- }, "a finite number above 0")
56
-
57
- export const clamp = (value: number, min: number, max: number): Scalar.Finite =>
58
- Math.min(Math.max(value, min), max) as Scalar.Finite
59
-
60
- export const lerp = (start: number, end: number, amount: number): Scalar.Finite =>
61
- (start + (end - start) * amount) as Scalar.Finite
62
-
63
- export const approach = (
64
- current: Scalar.Finite,
65
- target: Scalar.Finite,
66
- maxDelta: Scalar.NonNegative
67
- ): Scalar.Finite => {
68
- if (current < target) {
69
- return Math.min(current + maxDelta, target) as Scalar.Finite
70
- }
71
-
72
- return Math.max(current - maxDelta, target) as Scalar.Finite
73
- }
74
-
75
- export const inverseLerp = (
76
- start: number,
77
- end: number,
78
- value: number
79
- ): Result.Result<Scalar.Finite, Scalar.InterpolationError> => {
80
- if (start === end) {
81
- return Result.failure({
82
- tag: "Scalar/ZeroRange",
83
- start,
84
- end
85
- })
86
- }
87
-
88
- return Result.success(((value - start) / (end - start)) as Scalar.Finite)
89
- }
90
-
91
- export const remap = (
92
- value: number,
93
- inputStart: number,
94
- inputEnd: number,
95
- outputStart: number,
96
- outputEnd: number
97
- ): Result.Result<Scalar.Finite, Scalar.InterpolationError> => {
98
- const amount = inverseLerp(inputStart, inputEnd, value)
99
- if (!amount.ok) {
100
- return amount
101
- }
102
-
103
- return Result.success(lerp(outputStart, outputEnd, amount.value))
104
- }
@@ -1,54 +0,0 @@
1
- import { codecOf } from "./codec.ts"
2
- import * as Result from "@typeonce/ritmo/Result"
3
- import * as Scalar from "../Scalar.ts"
4
- import type * as Size2 from "../Size2.ts"
5
-
6
- const make = (width: Scalar.NonNegative, height: Scalar.NonNegative): Size2.Size2 =>
7
- ({ width, height }) as Size2.Size2
8
-
9
- export const result = (raw: Size2.Raw): Result.Result<Size2.Size2, Size2.Error> => {
10
- const width = Scalar.NonNegative.result(raw.width)
11
- const height = Scalar.NonNegative.result(raw.height)
12
- if (!width.ok || !height.ok) {
13
- return Result.failure({
14
- tag: "Size2/Invalid",
15
- width: width.ok ? null : width.error,
16
- height: height.ok ? null : height.error,
17
- input: {
18
- width: raw.width,
19
- height: raw.height
20
- }
21
- })
22
- }
23
-
24
- return Result.success(make(width.value, height.value))
25
- }
26
-
27
- export const option = (raw: Size2.Raw): Size2.Size2 | null => {
28
- const next = result(raw)
29
- return next.ok ? next.value : null
30
- }
31
-
32
- export const is = (raw: unknown): raw is Size2.Size2 => decode(raw).ok
33
-
34
- export const toRaw = (size: Size2.Size2): Size2.Raw => ({
35
- width: size.width,
36
- height: size.height
37
- })
38
-
39
- export const width = (size: Size2.Size2): Scalar.NonNegative => size.width
40
- export const height = (size: Size2.Size2): Scalar.NonNegative => size.height
41
-
42
- /**
43
- * Shape check for untrusted input; values are validated by `result`.
44
- */
45
- export const isRawShape = (raw: unknown): raw is Size2.Raw =>
46
- typeof raw === "object" && raw !== null && typeof (raw as Record<string, unknown>)["width"] === "number" && typeof (raw as Record<string, unknown>)["height"] === "number"
47
-
48
- /** Untrusted input without the raw shape. */
49
- type Malformed = { readonly tag: "Size2/Malformed"; readonly input: unknown }
50
-
51
- export const decode = (raw: unknown): Result.Result<Size2.Size2, Size2.Error | Malformed> =>
52
- isRawShape(raw) ? result(raw) : Result.failure({ tag: "Size2/Malformed", input: raw })
53
-
54
- export const codec = codecOf<Size2.Raw, Size2.Size2>(decode, "a size { width, height } of non-negative finite numbers")
@@ -1,121 +0,0 @@
1
- import { codecOf } from "./codec.ts"
2
- import * as Result from "@typeonce/ritmo/Result"
3
- import * as Scalar from "../Scalar.ts"
4
- import type * as Vector2 from "../Vector2.ts"
5
- import * as Ops from "../Ops.ts"
6
-
7
- const make = (x: Scalar.Finite, y: Scalar.Finite): Vector2.Vector2 => ({ x, y }) as Vector2.Vector2
8
-
9
- export const result = (raw: Vector2.Raw): Result.Result<Vector2.Vector2, Vector2.Error> => {
10
- const x = Scalar.Finite.result(raw.x)
11
- const y = Scalar.Finite.result(raw.y)
12
- if (!x.ok || !y.ok) {
13
- return Result.failure({
14
- tag: "Vector2/Invalid",
15
- x: x.ok ? null : x.error,
16
- y: y.ok ? null : y.error,
17
- input: {
18
- x: raw.x,
19
- y: raw.y
20
- }
21
- })
22
- }
23
-
24
- return Result.success(make(x.value, y.value))
25
- }
26
-
27
- export const option = (raw: Vector2.Raw): Vector2.Vector2 | null => {
28
- const next = result(raw)
29
- return next.ok ? next.value : null
30
- }
31
-
32
- export const is = (raw: unknown): raw is Vector2.Vector2 => decode(raw).ok
33
-
34
- export const toRaw = (vector: Vector2.Vector2): Vector2.Raw => ({
35
- x: vector.x,
36
- y: vector.y
37
- })
38
-
39
- export const components = (vector: Vector2.Vector2) => ({
40
- x: vector.x,
41
- y: vector.y
42
- })
43
-
44
- export const x = (vector: Vector2.Vector2): Scalar.Finite => vector.x
45
- export const y = (vector: Vector2.Vector2): Scalar.Finite => vector.y
46
-
47
- export const zero = (): Vector2.Vector2 => make(0 as Scalar.Finite, 0 as Scalar.Finite)
48
-
49
- export const add = (left: Vector2.Vector2, right: Vector2.Vector2): Vector2.Vector2 =>
50
- make((left.x + right.x) as Scalar.Finite, (left.y + right.y) as Scalar.Finite)
51
-
52
- export const subtract = (left: Vector2.Vector2, right: Vector2.Vector2): Vector2.Vector2 =>
53
- make((left.x - right.x) as Scalar.Finite, (left.y - right.y) as Scalar.Finite)
54
-
55
- export const scale = (vector: Vector2.Vector2, scalar: Scalar.Finite): Vector2.Vector2 =>
56
- make((vector.x * scalar) as Scalar.Finite, (vector.y * scalar) as Scalar.Finite)
57
-
58
- export const lengthSquared = (vector: Vector2.Vector2): Scalar.NonNegative =>
59
- (vector.x * vector.x + vector.y * vector.y) as Scalar.NonNegative
60
-
61
- export const length = (vector: Vector2.Vector2): Scalar.NonNegative =>
62
- Math.sqrt(lengthSquared(vector)) as Scalar.NonNegative
63
-
64
- export const normalize = (
65
- vector: Vector2.Vector2
66
- ): Result.Result<Vector2.Vector2, Vector2.NormalizeError> => {
67
- const magnitudeSquared = lengthSquared(vector)
68
- if (magnitudeSquared === 0) {
69
- return Result.failure({
70
- tag: "Vector2/ZeroLength"
71
- })
72
- }
73
-
74
- const magnitude = Math.sqrt(magnitudeSquared) as Scalar.NonNegative
75
- return Result.success(
76
- make(
77
- (vector.x / magnitude) as Scalar.Finite,
78
- (vector.y / magnitude) as Scalar.Finite
79
- )
80
- )
81
- }
82
-
83
- export const normalizeOrZero = (vector: Vector2.Vector2): Vector2.Vector2 => {
84
- const normalized = normalize(vector)
85
- return normalized.ok ? normalized.value : zero()
86
- }
87
-
88
- export const normalizeXYOrZero = (x: number, y: number): {
89
- readonly x: number
90
- readonly y: number
91
- readonly length: number
92
- } => {
93
- const magnitude = Ops.hypot(x, y)
94
- if (magnitude <= 0.0001) {
95
- return {
96
- x: 0,
97
- y: 0,
98
- length: 0
99
- }
100
- }
101
-
102
- return {
103
- x: x / magnitude,
104
- y: y / magnitude,
105
- length: magnitude
106
- }
107
- }
108
-
109
- /**
110
- * Shape check for untrusted input; values are validated by `result`.
111
- */
112
- export const isRawShape = (raw: unknown): raw is Vector2.Raw =>
113
- typeof raw === "object" && raw !== null && typeof (raw as Record<string, unknown>)["x"] === "number" && typeof (raw as Record<string, unknown>)["y"] === "number"
114
-
115
- /** Untrusted input without the raw shape. */
116
- type Malformed = { readonly tag: "Vector2/Malformed"; readonly input: unknown }
117
-
118
- export const decode = (raw: unknown): Result.Result<Vector2.Vector2, Vector2.Error | Malformed> =>
119
- isRawShape(raw) ? result(raw) : Result.failure({ tag: "Vector2/Malformed", input: raw })
120
-
121
- export const codec = codecOf<Vector2.Raw, Vector2.Vector2>(decode, "a vector { x, y } of finite numbers")