@typeonce/ritmo-math 0.14.0 → 0.16.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.
- package/CHANGELOG.md +124 -0
- package/README.md +17 -12
- package/dist/Angle.d.ts +49 -0
- package/dist/Angle.d.ts.map +1 -0
- package/dist/Angle.js +67 -0
- package/dist/Angle.js.map +1 -0
- package/dist/Box2.d.ts +20 -4
- package/dist/Box2.d.ts.map +1 -1
- package/dist/Box2.js +16 -1
- package/dist/Box2.js.map +1 -1
- package/dist/Collide2.d.ts +23 -1
- package/dist/Collide2.d.ts.map +1 -1
- package/dist/Collide2.js +23 -1
- package/dist/Collide2.js.map +1 -1
- package/dist/FlowField.d.ts +24 -38
- package/dist/FlowField.d.ts.map +1 -1
- package/dist/FlowField.js +22 -5
- package/dist/FlowField.js.map +1 -1
- package/dist/Scalar.d.ts +19 -166
- package/dist/Scalar.d.ts.map +1 -1
- package/dist/Scalar.js +54 -51
- package/dist/Scalar.js.map +1 -1
- package/dist/Segment2.d.ts +3 -0
- package/dist/Segment2.d.ts.map +1 -1
- package/dist/Segment2.js.map +1 -1
- package/dist/Vec2.d.ts +50 -7
- package/dist/Vec2.d.ts.map +1 -1
- package/dist/Vec2.js +59 -8
- package/dist/Vec2.js.map +1 -1
- package/dist/index.d.ts +9 -22
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -22
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
- package/src/Angle.ts +65 -0
- package/src/Box2.ts +24 -4
- package/src/Collide2.ts +30 -2
- package/src/FlowField.ts +38 -10
- package/src/Scalar.ts +46 -165
- package/src/Segment2.ts +3 -0
- package/src/Vec2.ts +61 -8
- package/src/index.ts +9 -22
- package/dist/Aabb.d.ts +0 -182
- package/dist/Aabb.d.ts.map +0 -1
- package/dist/Aabb.js +0 -109
- package/dist/Aabb.js.map +0 -1
- package/dist/InputAxis.d.ts +0 -44
- package/dist/InputAxis.d.ts.map +0 -1
- package/dist/InputAxis.js +0 -71
- package/dist/InputAxis.js.map +0 -1
- package/dist/Ops.d.ts +0 -209
- package/dist/Ops.d.ts.map +0 -1
- package/dist/Ops.js +0 -210
- package/dist/Ops.js.map +0 -1
- package/dist/Random.d.ts +0 -124
- package/dist/Random.d.ts.map +0 -1
- package/dist/Random.js +0 -126
- package/dist/Random.js.map +0 -1
- package/dist/Size2.d.ts +0 -118
- package/dist/Size2.d.ts.map +0 -1
- package/dist/Size2.js +0 -54
- package/dist/Size2.js.map +0 -1
- package/dist/SpatialGrid.d.ts +0 -68
- package/dist/SpatialGrid.d.ts.map +0 -1
- package/dist/SpatialGrid.js +0 -112
- package/dist/SpatialGrid.js.map +0 -1
- package/dist/Vector2.d.ts +0 -214
- package/dist/Vector2.d.ts.map +0 -1
- package/dist/Vector2.js +0 -134
- package/dist/Vector2.js.map +0 -1
- package/dist/internal/aabb.d.ts +0 -27
- package/dist/internal/aabb.d.ts.map +0 -1
- package/dist/internal/aabb.js +0 -52
- package/dist/internal/aabb.js.map +0 -1
- package/dist/internal/codec.d.ts +0 -9
- package/dist/internal/codec.d.ts.map +0 -1
- package/dist/internal/codec.js +0 -16
- package/dist/internal/codec.js.map +0 -1
- package/dist/internal/fdlibm.d.ts +0 -43
- package/dist/internal/fdlibm.d.ts.map +0 -1
- package/dist/internal/fdlibm.js +0 -1291
- package/dist/internal/fdlibm.js.map +0 -1
- package/dist/internal/inputAxis.d.ts +0 -11
- package/dist/internal/inputAxis.d.ts.map +0 -1
- package/dist/internal/inputAxis.js +0 -13
- package/dist/internal/inputAxis.js.map +0 -1
- package/dist/internal/scalar.d.ts +0 -11
- package/dist/internal/scalar.d.ts.map +0 -1
- package/dist/internal/scalar.js +0 -68
- package/dist/internal/scalar.js.map +0 -1
- package/dist/internal/size2.d.ts +0 -22
- package/dist/internal/size2.d.ts.map +0 -1
- package/dist/internal/size2.js +0 -38
- package/dist/internal/size2.js.map +0 -1
- package/dist/internal/vector2.d.ts +0 -39
- package/dist/internal/vector2.d.ts.map +0 -1
- package/dist/internal/vector2.js +0 -78
- package/dist/internal/vector2.js.map +0 -1
- package/src/Aabb.ts +0 -180
- package/src/InputAxis.ts +0 -81
- package/src/Ops.ts +0 -232
- package/src/Random.ts +0 -225
- package/src/Size2.ts +0 -122
- package/src/SpatialGrid.ts +0 -172
- package/src/Vector2.ts +0 -216
- package/src/internal/aabb.ts +0 -81
- package/src/internal/codec.ts +0 -21
- package/src/internal/fdlibm.ts +0 -1256
- package/src/internal/inputAxis.ts +0 -21
- package/src/internal/scalar.ts +0 -104
- package/src/internal/size2.ts +0 -54
- 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))
|
package/src/internal/scalar.ts
DELETED
|
@@ -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
|
-
}
|
package/src/internal/size2.ts
DELETED
|
@@ -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")
|
package/src/internal/vector2.ts
DELETED
|
@@ -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")
|