@typeonce/ritmo-math 0.14.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 (108) hide show
  1. package/CHANGELOG.md +104 -0
  2. package/README.md +17 -12
  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 +11 -1
  12. package/dist/Collide2.d.ts.map +1 -1
  13. package/dist/Collide2.js +16 -1
  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/Vec2.d.ts +47 -7
  24. package/dist/Vec2.d.ts.map +1 -1
  25. package/dist/Vec2.js +56 -8
  26. package/dist/Vec2.js.map +1 -1
  27. package/dist/index.d.ts +9 -22
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +9 -22
  30. package/dist/index.js.map +1 -1
  31. package/package.json +3 -3
  32. package/src/Angle.ts +60 -0
  33. package/src/Box2.ts +20 -4
  34. package/src/Collide2.ts +18 -2
  35. package/src/FlowField.ts +34 -10
  36. package/src/Scalar.ts +43 -165
  37. package/src/Vec2.ts +58 -8
  38. package/src/index.ts +9 -22
  39. package/dist/Aabb.d.ts +0 -182
  40. package/dist/Aabb.d.ts.map +0 -1
  41. package/dist/Aabb.js +0 -109
  42. package/dist/Aabb.js.map +0 -1
  43. package/dist/InputAxis.d.ts +0 -44
  44. package/dist/InputAxis.d.ts.map +0 -1
  45. package/dist/InputAxis.js +0 -71
  46. package/dist/InputAxis.js.map +0 -1
  47. package/dist/Ops.d.ts +0 -209
  48. package/dist/Ops.d.ts.map +0 -1
  49. package/dist/Ops.js +0 -210
  50. package/dist/Ops.js.map +0 -1
  51. package/dist/Random.d.ts +0 -124
  52. package/dist/Random.d.ts.map +0 -1
  53. package/dist/Random.js +0 -126
  54. package/dist/Random.js.map +0 -1
  55. package/dist/Size2.d.ts +0 -118
  56. package/dist/Size2.d.ts.map +0 -1
  57. package/dist/Size2.js +0 -54
  58. package/dist/Size2.js.map +0 -1
  59. package/dist/SpatialGrid.d.ts +0 -68
  60. package/dist/SpatialGrid.d.ts.map +0 -1
  61. package/dist/SpatialGrid.js +0 -112
  62. package/dist/SpatialGrid.js.map +0 -1
  63. package/dist/Vector2.d.ts +0 -214
  64. package/dist/Vector2.d.ts.map +0 -1
  65. package/dist/Vector2.js +0 -134
  66. package/dist/Vector2.js.map +0 -1
  67. package/dist/internal/aabb.d.ts +0 -27
  68. package/dist/internal/aabb.d.ts.map +0 -1
  69. package/dist/internal/aabb.js +0 -52
  70. package/dist/internal/aabb.js.map +0 -1
  71. package/dist/internal/codec.d.ts +0 -9
  72. package/dist/internal/codec.d.ts.map +0 -1
  73. package/dist/internal/codec.js +0 -16
  74. package/dist/internal/codec.js.map +0 -1
  75. package/dist/internal/fdlibm.d.ts +0 -43
  76. package/dist/internal/fdlibm.d.ts.map +0 -1
  77. package/dist/internal/fdlibm.js +0 -1291
  78. package/dist/internal/fdlibm.js.map +0 -1
  79. package/dist/internal/inputAxis.d.ts +0 -11
  80. package/dist/internal/inputAxis.d.ts.map +0 -1
  81. package/dist/internal/inputAxis.js +0 -13
  82. package/dist/internal/inputAxis.js.map +0 -1
  83. package/dist/internal/scalar.d.ts +0 -11
  84. package/dist/internal/scalar.d.ts.map +0 -1
  85. package/dist/internal/scalar.js +0 -68
  86. package/dist/internal/scalar.js.map +0 -1
  87. package/dist/internal/size2.d.ts +0 -22
  88. package/dist/internal/size2.d.ts.map +0 -1
  89. package/dist/internal/size2.js +0 -38
  90. package/dist/internal/size2.js.map +0 -1
  91. package/dist/internal/vector2.d.ts +0 -39
  92. package/dist/internal/vector2.d.ts.map +0 -1
  93. package/dist/internal/vector2.js +0 -78
  94. package/dist/internal/vector2.js.map +0 -1
  95. package/src/Aabb.ts +0 -180
  96. package/src/InputAxis.ts +0 -81
  97. package/src/Ops.ts +0 -232
  98. package/src/Random.ts +0 -225
  99. package/src/Size2.ts +0 -122
  100. package/src/SpatialGrid.ts +0 -172
  101. package/src/Vector2.ts +0 -216
  102. package/src/internal/aabb.ts +0 -81
  103. package/src/internal/codec.ts +0 -21
  104. package/src/internal/fdlibm.ts +0 -1256
  105. package/src/internal/inputAxis.ts +0 -21
  106. package/src/internal/scalar.ts +0 -104
  107. package/src/internal/size2.ts +0 -54
  108. package/src/internal/vector2.ts +0 -121
package/dist/FlowField.js CHANGED
@@ -14,7 +14,9 @@
14
14
  *
15
15
  * @example
16
16
  * ```ts
17
- * const paths = FlowField.make(cellSize)
17
+ * const made = FlowField.make(cellSize)
18
+ * if (!made.ok) return made
19
+ * const paths = made.value
18
20
  * // Each step:
19
21
  * paths.setWalls(walls, bodyRadius)
20
22
  * paths.setGoal(player)
@@ -30,8 +32,9 @@
30
32
  * @categoryDescription Construction
31
33
  * Making a flow field.
32
34
  */
35
+ import * as Ops from "@typeonce/ritmo/Ops";
36
+ import * as Result from "@typeonce/ritmo/Result";
33
37
  import { overlapsCircle } from "./Box2.js";
34
- import * as Ops from "./Ops.js";
35
38
  // The eight steps to a neighbor (straight ones first) and their lengths, as
36
39
  // parallel arrays: the search reads them for every cell it settles.
37
40
  const stepX = Int8Array.of(1, -1, 0, 0, 1, 1, -1, -1);
@@ -245,10 +248,20 @@ class Field {
245
248
  }
246
249
  /**
247
250
  * An empty flow field (no walls, no goal) with square cells of `cellSize`
248
- * world units. Smaller cells follow walls more closely and cost more to
249
- * search; around a body's diameter is a good start.
251
+ * world units, or `InvalidCellSize` when `cellSize` is not a finite number
252
+ * above 0. Smaller cells follow walls more closely and cost more to search;
253
+ * around a body's diameter is a good start. Make it once (in a service or a
254
+ * system's setup) and reuse it every step.
255
+ *
256
+ * @example
257
+ * ```ts
258
+ * const paths = FlowField.make(30)
259
+ * if (!paths.ok) throw new Error(`bad cell size ${paths.error.value}`)
260
+ * ```
250
261
  *
251
262
  * @category Construction
252
263
  */
253
- export const make = (cellSize) => new Field(cellSize);
264
+ export const make = (cellSize) => cellSize > 0 && cellSize < Infinity
265
+ ? Result.success(new Field(cellSize))
266
+ : Result.failure({ _tag: "InvalidCellSize", value: cellSize });
254
267
  //# sourceMappingURL=FlowField.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"FlowField.js","sourceRoot":"","sources":["../src/FlowField.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"FlowField.js","sourceRoot":"","sources":["../src/FlowField.ts"],"names":[],"mappings":"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"}
package/dist/Scalar.d.ts CHANGED
@@ -1,179 +1,32 @@
1
1
  /**
2
- * Validated scalar brands and pure scalar helpers.
3
- *
4
- * This module is the numeric foundation for the branded geometry helpers.
5
- * Plain `number` values enter through explicit constructors such as
6
- * {@link Finite} and {@link NonNegative}. Once validated, downstream helpers
7
- * operate only on branded values.
8
- *
9
- * In game code this is useful whenever "just a number" is too weak: viewport
10
- * sizes, speeds, distances, durations, and geometry values often need explicit
11
- * non-negative or finite guarantees before they should be stored in the world.
12
- *
13
- * @example
14
- * ```ts
15
- * // Validate raw numbers before geometry or gameplay code relies on them.
16
- * const speed = Scalar.Finite.result(12)
17
- * const min = Scalar.Finite.result(0)
18
- * const max = Scalar.Finite.result(8)
19
- * if (!speed.ok || !min.ok || !max.ok) return
20
- *
21
- * // Operate on the branded values after the boundary has been crossed.
22
- * const clamped = Scalar.clamp(speed.value, min.value, max.value)
23
- * ```
24
- *
25
- * @module Scalar
26
- * @docGroup data-structures
27
- *
28
- * @categoryDescription Scalar Types
29
- * Branded numeric shapes and shared scalar validation errors.
30
- *
31
- * @categoryDescription Constructors
32
- * Non-throwing validation boundaries for finite and constrained scalar values.
33
- *
34
- * @categoryDescription Operations
35
- * Pure scalar combinators that preserve branding after validation.
36
- */
37
- import type * as Brand from "@typeonce/ritmo/Brand";
38
- import type { StandardSchema } from "@typeonce/ritmo/Descriptor";
39
- import type * as Result from "@typeonce/ritmo/Result";
40
- /**
41
- * Finite number brand.
42
- *
43
- * Values of this type are guaranteed not to be `NaN`, `Infinity`, or
44
- * `-Infinity` when they come from a constructor (`result`, `option`) or a `codec`. The
45
- * arithmetic helpers here and in `Vector2` keep the brand without
46
- * re-validating, so their results are finite only while they stay within
47
- * `±Number.MAX_VALUE`: game-sized values never come close, but validate
48
- * again with `result` when inputs may be that large.
49
- *
50
- * @category Scalar Types
51
- */
52
- export type Finite = Brand.Branded<number, "Scalar/Finite">;
53
- /**
54
- * Finite number brand constrained to `>= 0`.
55
- *
56
- * @category Scalar Types
57
- */
58
- export type NonNegative = Brand.Branded<number, "Scalar/NonNegative">;
59
- /**
60
- * Finite number brand constrained to `> 0`.
61
- *
62
- * @category Scalar Types
63
- */
64
- export type Positive = Brand.Branded<number, "Scalar/Positive">;
65
- /**
66
- * Structured scalar validation failures.
67
- *
68
- * @category Scalar Types
69
- */
70
- export type Error = {
71
- readonly tag: "Scalar/NotFinite";
72
- readonly value: number;
73
- } | {
74
- readonly tag: "Scalar/Negative";
75
- readonly value: number;
76
- } | {
77
- readonly tag: "Scalar/NonPositive";
78
- readonly value: number;
79
- };
80
- /**
81
- * Structured interpolation failure.
82
- *
83
- * @category Scalar Types
84
- */
85
- export type InterpolationError = {
86
- readonly tag: "Scalar/ZeroRange";
87
- readonly start: number;
88
- readonly end: number;
89
- };
90
- /**
91
- * The constructors, guard, and schema of one scalar brand.
92
- *
93
- * @category Constructors
94
- */
95
- export interface Constructor<Value> {
96
- /** Validates one number and returns an explicit success/failure result. */
97
- readonly result: (raw: number) => Result.Result<Value, Error>;
98
- /** Validates one number and returns `null` on failure. */
99
- readonly option: (raw: number) => Value | null;
100
- /** Whether any value is a number of this brand. */
101
- readonly is: (raw: unknown) => raw is Value;
102
- /** The Standard Schema for `Descriptor.ConstructedComponent(...)`: the saved form is the number itself. */
103
- readonly codec: StandardSchema<number, Value>;
104
- }
105
- /**
106
- * Constructor for {@link Finite}: `result` (explicit failure), `option`
107
- * (`null` on failure), `is` (a type guard), and `codec`, for
108
- * `Descriptor.ConstructedComponent(Scalar.Finite.codec)`.
109
- *
110
- * @category Constructors
111
- */
112
- export declare const Finite: Constructor<Finite>;
113
- /**
114
- * Constructor for {@link NonNegative}: `result` (explicit failure), `option`
115
- * (`null` on failure), `is` (a type guard), and `codec`, for
116
- * `Descriptor.ConstructedComponent(Scalar.NonNegative.codec)`.
117
- *
118
- * @category Constructors
119
- */
120
- export declare const NonNegative: Constructor<NonNegative>;
121
- /**
122
- * Constructor for {@link Positive}: `result` (explicit failure), `option`
123
- * (`null` on failure), `is` (a type guard), and `codec`, for
124
- * `Descriptor.ConstructedComponent(Scalar.Positive.codec)`.
125
- *
126
- * @category Constructors
127
- */
128
- export declare const Positive: Constructor<Positive>;
129
- /**
130
- * Clamps one finite value between two finite bounds.
131
- *
132
- * The result stays branded because valid branded scalar input cannot produce an
133
- * invalid scalar output.
2
+ * Moves `current` toward `target` by at most `maxDelta`, never overshooting:
3
+ * `target` itself once the gap is `maxDelta` or less, and `current` unchanged
4
+ * when `maxDelta` is 0 or less. For a constant rate (acceleration, a meter
5
+ * filling); for an ease that slows near the target use {@link decayToward},
6
+ * for vectors `Vec2.moveToward`, for angles `Angle.turnToward`.
134
7
  *
135
8
  * @category Operations
136
9
  */
137
- export declare const clamp: (value: Finite, min: Finite, max: Finite) => Finite;
10
+ export declare const moveToward: (current: number, target: number, maxDelta: number) => number;
138
11
  /**
139
- * Interpolates between two finite values by one finite amount.
140
- *
141
- * The amount is not clamped. This stays a pure interpolation primitive rather
142
- * than mixing interpolation with policy. The result keeps the `Finite` brand
143
- * without re-validating (see `Finite`).
12
+ * The number `amount` of the way from `start` (at 0) to `end` (at 1). The
13
+ * amount is not clamped, so 1.5 goes past `end`. For a fixed blend between
14
+ * two values; to approach a target over time use {@link moveToward} or
15
+ * {@link decayToward}, for vectors `Vec2.lerp`.
144
16
  *
145
17
  * @category Operations
146
18
  */
147
- export declare const lerp: (start: Finite, end: Finite, amount: Finite) => Finite;
19
+ export declare const lerp: (start: number, end: number, amount: number) => number;
148
20
  /**
149
- * Moves one finite value toward a target by at most one non-negative delta.
150
- *
151
- * Use this for explicit interpolation-style updates where overshooting the
152
- * target should be impossible.
21
+ * Moves `current` toward `target` by the share `rate` closes per second,
22
+ * over `dt` seconds: `target + (current - target) * exp(-rate * dt)`. The
23
+ * same total time gives the same result at any step rate, which `lerp` by a
24
+ * fixed amount per step does not. `current` unchanged when `rate * dt` is 0
25
+ * or less, `target` itself when `rate` is `Infinity` (and `dt` positive).
26
+ * It nears `target` without reaching it; when it must arrive, use
27
+ * {@link moveToward}. For vectors use `Vec2.decayToward`.
153
28
  *
154
29
  * @category Operations
155
30
  */
156
- export declare const approach: (current: Finite, target: Finite, maxDelta: NonNegative) => Finite;
157
- /**
158
- * Returns the interpolation amount of one value within a finite input range.
159
- *
160
- * Fails explicitly when the input range has zero size.
161
- *
162
- * @category Operations
163
- */
164
- export declare const inverseLerp: (start: Finite, end: Finite, value: Finite) => Result.Result<Finite, InterpolationError>;
165
- /**
166
- * Remaps one finite value from one input range to one output range.
167
- *
168
- * Fails explicitly when the input range has zero size.
169
- *
170
- * @category Operations
171
- */
172
- export declare const remap: (value: Finite, inputStart: Finite, inputEnd: Finite, outputStart: Finite, outputEnd: Finite) => Result.Result<Finite, InterpolationError>;
173
- /**
174
- * Common result shape returned by the scalar constructors.
175
- *
176
- * @category Scalar Types
177
- */
178
- export type FiniteResult = Result.Result<Finite, Error>;
31
+ export declare const decayToward: (current: number, target: number, rate: number, dt: number) => number;
179
32
  //# sourceMappingURL=Scalar.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Scalar.d.ts","sourceRoot":"","sources":["../src/Scalar.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Scalar.d.ts","sourceRoot":"","sources":["../src/Scalar.ts"],"names":[],"mappings":"AAyBA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,YAAa,MAAM,UAAU,MAAM,YAAY,MAAM,KAAG,MAK9E,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,UAAW,MAAM,OAAO,MAAM,UAAU,MAAM,KAAG,MAAwC,CAAA;AAE1G;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,MAAM,KAAG,MAKvF,CAAA"}
package/dist/Scalar.js CHANGED
@@ -1,70 +1,70 @@
1
- import * as internal from "./internal/scalar.js";
2
1
  /**
3
- * Constructor for {@link Finite}: `result` (explicit failure), `option`
4
- * (`null` on failure), `is` (a type guard), and `codec`, for
5
- * `Descriptor.ConstructedComponent(Scalar.Finite.codec)`.
2
+ * One-dimensional helpers on plain numbers, for values a system moves toward
3
+ * a target every step: a speed, a zoom, a meter.
6
4
  *
7
- * @category Constructors
8
- */
9
- export const Finite = internal.Finite;
10
- /**
11
- * Constructor for {@link NonNegative}: `result` (explicit failure), `option`
12
- * (`null` on failure), `is` (a type guard), and `codec`, for
13
- * `Descriptor.ConstructedComponent(Scalar.NonNegative.codec)`.
14
- *
15
- * @category Constructors
16
- */
17
- export const NonNegative = internal.NonNegative;
18
- /**
19
- * Constructor for {@link Positive}: `result` (explicit failure), `option`
20
- * (`null` on failure), `is` (a type guard), and `codec`, for
21
- * `Descriptor.ConstructedComponent(Scalar.Positive.codec)`.
22
- *
23
- * @category Constructors
24
- */
25
- export const Positive = internal.Positive;
26
- /**
27
- * Clamps one finite value between two finite bounds.
5
+ * Every function is total over finite numbers and returns a plain `number`.
6
+ * Clamping stays `Math.min(Math.max(value, min), max)`, which is exact on
7
+ * every engine. Angles have their own module, `Angle`, because they wrap;
8
+ * vectors use the matching `Vec2` helpers.
28
9
  *
29
- * The result stays branded because valid branded scalar input cannot produce an
30
- * invalid scalar output.
10
+ * @example
11
+ * ```ts
12
+ * // Accelerate toward the top speed by at most `acceleration * dt` per step.
13
+ * const speed = Scalar.moveToward(current, topSpeed, acceleration * dt)
14
+ * // Ease a zoom toward its target the same way at any step rate.
15
+ * const zoom = Scalar.decayToward(view.zoom, target, 8, dt)
16
+ * ```
31
17
  *
32
- * @category Operations
33
- */
34
- export const clamp = internal.clamp;
35
- /**
36
- * Interpolates between two finite values by one finite amount.
37
- *
38
- * The amount is not clamped. This stays a pure interpolation primitive rather
39
- * than mixing interpolation with policy. The result keeps the `Finite` brand
40
- * without re-validating (see `Finite`).
18
+ * @module Scalar
19
+ * @docGroup helpers
41
20
  *
42
- * @category Operations
21
+ * @categoryDescription Operations
22
+ * Moving one number toward another.
43
23
  */
44
- export const lerp = internal.lerp;
24
+ import * as Ops from "@typeonce/ritmo/Ops";
45
25
  /**
46
- * Moves one finite value toward a target by at most one non-negative delta.
47
- *
48
- * Use this for explicit interpolation-style updates where overshooting the
49
- * target should be impossible.
26
+ * Moves `current` toward `target` by at most `maxDelta`, never overshooting:
27
+ * `target` itself once the gap is `maxDelta` or less, and `current` unchanged
28
+ * when `maxDelta` is 0 or less. For a constant rate (acceleration, a meter
29
+ * filling); for an ease that slows near the target use {@link decayToward},
30
+ * for vectors `Vec2.moveToward`, for angles `Angle.turnToward`.
50
31
  *
51
32
  * @category Operations
52
33
  */
53
- export const approach = internal.approach;
34
+ export const moveToward = (current, target, maxDelta) => {
35
+ if (!(maxDelta > 0))
36
+ return current;
37
+ const gap = target - current;
38
+ if (Math.abs(gap) <= maxDelta)
39
+ return target;
40
+ return gap > 0 ? current + maxDelta : current - maxDelta;
41
+ };
54
42
  /**
55
- * Returns the interpolation amount of one value within a finite input range.
56
- *
57
- * Fails explicitly when the input range has zero size.
43
+ * The number `amount` of the way from `start` (at 0) to `end` (at 1). The
44
+ * amount is not clamped, so 1.5 goes past `end`. For a fixed blend between
45
+ * two values; to approach a target over time use {@link moveToward} or
46
+ * {@link decayToward}, for vectors `Vec2.lerp`.
58
47
  *
59
48
  * @category Operations
60
49
  */
61
- export const inverseLerp = internal.inverseLerp;
50
+ export const lerp = (start, end, amount) => start + (end - start) * amount;
62
51
  /**
63
- * Remaps one finite value from one input range to one output range.
64
- *
65
- * Fails explicitly when the input range has zero size.
52
+ * Moves `current` toward `target` by the share `rate` closes per second,
53
+ * over `dt` seconds: `target + (current - target) * exp(-rate * dt)`. The
54
+ * same total time gives the same result at any step rate, which `lerp` by a
55
+ * fixed amount per step does not. `current` unchanged when `rate * dt` is 0
56
+ * or less, `target` itself when `rate` is `Infinity` (and `dt` positive).
57
+ * It nears `target` without reaching it; when it must arrive, use
58
+ * {@link moveToward}. For vectors use `Vec2.decayToward`.
66
59
  *
67
60
  * @category Operations
68
61
  */
69
- export const remap = internal.remap;
62
+ export const decayToward = (current, target, rate, dt) => {
63
+ const k = rate * dt;
64
+ if (!(k > 0))
65
+ return current;
66
+ if (k === Infinity)
67
+ return target;
68
+ return target + (current - target) * Ops.exp(-k);
69
+ };
70
70
  //# sourceMappingURL=Scalar.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Scalar.js","sourceRoot":"","sources":["../src/Scalar.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAA;AAmEhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAwB,QAAQ,CAAC,MAAM,CAAA;AAC1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAA6B,QAAQ,CAAC,WAAW,CAAA;AACzE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA0B,QAAQ,CAAC,QAAQ,CAAA;AAEhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAwD,QAAQ,CAAC,KAAK,CAAA;AACxF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAA2D,QAAQ,CAAC,IAAI,CAAA;AACzF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuE,QAAQ,CAAC,QAAQ,CAAA;AAC7G;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAIyB,QAAQ,CAAC,WAAW,CAAA;AACrE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAM+B,QAAQ,CAAC,KAAK,CAAA"}
1
+ {"version":3,"file":"Scalar.js","sourceRoot":"","sources":["../src/Scalar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAA;AAE1C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,MAAc,EAAE,QAAgB,EAAU,EAAE;IACtF,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAE,OAAO,OAAO,CAAA;IACnC,MAAM,GAAG,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC5C,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAA;AAC1D,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,MAAc,EAAU,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,MAAM,CAAA;AAE1G;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,MAAc,EAAE,IAAY,EAAE,EAAU,EAAU,EAAE;IAC/F,MAAM,CAAC,GAAG,IAAI,GAAG,EAAE,CAAA;IACnB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,OAAO,CAAA;IAC5B,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IACjC,OAAO,MAAM,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC,CAAA"}
package/dist/Vec2.d.ts CHANGED
@@ -1,11 +1,10 @@
1
1
  /**
2
2
  * Plain two-dimensional vector arithmetic for hot paths.
3
3
  *
4
- * `Vector2` validates values at a boundary (authored data, saves, components);
5
- * `Vec2` is the arithmetic that runs every frame on numbers already known to
6
- * be sane. Values are immutable `{ x, y }` records and every helper returns a
7
- * new one. A branded `Vector2` is a `Vec2`, so validated values flow into
8
- * these helpers without conversion.
4
+ * Values are immutable `{ x, y }` records and every helper returns a new
5
+ * one, so a component's value (validated once by the game's schema when it
6
+ * entered the world) passes straight in. Lengths and angles go through
7
+ * `Ops`, so the results replay the same on every engine.
9
8
  *
10
9
  * @example
11
10
  * ```ts
@@ -57,17 +56,46 @@ export declare const subtract: (a: Vec2, b: Vec2) => Vec2;
57
56
  */
58
57
  export declare const scale: (a: Vec2, factor: number) => Vec2;
59
58
  /**
60
- * `a` turned by `angle` radians (counter-clockwise for a y-up frame).
59
+ * `a` turned by `angle` radians (counter-clockwise for a y-up frame). For a
60
+ * quarter turn use {@link perpendicular}, which is exact.
61
61
  *
62
62
  * @category Operations
63
63
  */
64
64
  export declare const rotate: (a: Vec2, angle: number) => Vec2;
65
65
  /**
66
- * Dot product.
66
+ * `a` turned a quarter turn counter-clockwise (for a y-up frame):
67
+ * `{ x: -a.y, y: a.x }`. Exact. For the normal of a wall or a direction, a
68
+ * sideways push, and the signed side of a point: `dot(perpendicular(forward),
69
+ * offset)` is positive on the left of `forward`, negative on its right.
70
+ *
71
+ * @category Operations
72
+ */
73
+ export declare const perpendicular: (a: Vec2) => Vec2;
74
+ /**
75
+ * Dot product. With {@link perpendicular} it is also the 2D cross product:
76
+ * `dot(perpendicular(a), b)`.
67
77
  *
68
78
  * @category Operations
69
79
  */
70
80
  export declare const dot: (a: Vec2, b: Vec2) => number;
81
+ /**
82
+ * The unit vector at `angle` radians from the x axis (counter-clockwise for a
83
+ * y-up frame), through `Ops.cos` and `Ops.sin`. Multiply by a length with
84
+ * {@link scale}. The inverse of {@link angle}.
85
+ *
86
+ * @category Operations
87
+ */
88
+ export declare const fromAngle: (angle: number) => Vec2;
89
+ /**
90
+ * The angle of `a` from the x axis in radians, in (-π, π], through
91
+ * `Ops.atan2` (so no `y, x` argument order to get wrong). The zero vector
92
+ * gives 0, and so does `-0` in either coordinate where `Ops.atan2` would give
93
+ * `-0` or flip to -π. To keep it in `Angle`'s range [-π, π), use
94
+ * `Angle.wrap`; to turn toward it, `Angle.turnToward`.
95
+ *
96
+ * @category Operations
97
+ */
98
+ export declare const angle: (a: Vec2) => number;
71
99
  /**
72
100
  * Length of `a`.
73
101
  *
@@ -118,4 +146,16 @@ export declare const moveToward: (current: Vec2, target: Vec2, maxDelta: number)
118
146
  * @category Operations
119
147
  */
120
148
  export declare const clampLength: (a: Vec2, max: number) => Vec2;
149
+ /**
150
+ * Moves `current` toward `target` by the share `rate` closes per second, over
151
+ * `dt` seconds, with one shared factor `exp(-rate * dt)` so the point moves
152
+ * along the straight line: the same total time gives the same result at any
153
+ * step rate. `current` unchanged when `rate * dt` is 0 or less, `target`
154
+ * itself when `rate` is `Infinity` (and `dt` positive). It nears `target`
155
+ * without reaching it; when it must arrive, use {@link moveToward}. For
156
+ * plain numbers use `Scalar.decayToward`.
157
+ *
158
+ * @category Operations
159
+ */
160
+ export declare const decayToward: (current: Vec2, target: Vec2, rate: number, dt: number) => Vec2;
121
161
  //# sourceMappingURL=Vec2.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Vec2.d.ts","sourceRoot":"","sources":["../src/Vec2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,IAAoC,CAAA;AAEvD;;;;GAIG;AACH,eAAO,MAAM,GAAG,MAAO,IAAI,KAAK,IAAI,KAAG,IAAwC,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,MAAO,IAAI,KAAK,IAAI,KAAG,IAAwC,CAAA;AAEpF;;;;GAIG;AACH,eAAO,MAAM,KAAK,MAAO,IAAI,UAAU,MAAM,KAAG,IAA8C,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,MAAM,MAAO,IAAI,SAAS,MAAM,KAAG,IAI/C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG,MAAO,IAAI,KAAK,IAAI,KAAG,MAA+B,CAAA;AAEtE;;;;GAIG;AACH,eAAO,MAAM,MAAM,MAAO,IAAI,KAAG,MAA6B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,aAAa,MAAO,IAAI,KAAG,MAA+B,CAAA;AAEvE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,MAAO,IAAI,KAAK,IAAI,KAAG,MAAyC,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,eAAe,MAAO,IAAI,KAAK,IAAI,KAAG,MAIlD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,MAAO,IAAI,YAAY,IAAI,KAAG,IAGrD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,MAAO,IAAI,KAAK,IAAI,KAAK,MAAM,KAAG,IAAgE,CAAA;AAEnH;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAa,IAAI,UAAU,IAAI,YAAY,MAAM,KAAG,IAM1E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,MAAO,IAAI,OAAO,MAAM,KAAG,IAGlD,CAAA"}
1
+ {"version":3,"file":"Vec2.d.ts","sourceRoot":"","sources":["../src/Vec2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,IAAoC,CAAA;AAEvD;;;;GAIG;AACH,eAAO,MAAM,GAAG,MAAO,IAAI,KAAK,IAAI,KAAG,IAAwC,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,MAAO,IAAI,KAAK,IAAI,KAAG,IAAwC,CAAA;AAEpF;;;;GAIG;AACH,eAAO,MAAM,KAAK,MAAO,IAAI,UAAU,MAAM,KAAG,IAA8C,CAAA;AAE9F;;;;;GAKG;AACH,eAAO,MAAM,MAAM,MAAO,IAAI,SAAS,MAAM,KAAG,IAI/C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,MAAO,IAAI,KAAG,IAA6B,CAAA;AAErE;;;;;GAKG;AACH,eAAO,MAAM,GAAG,MAAO,IAAI,KAAK,IAAI,KAAG,MAA+B,CAAA;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,IAAkD,CAAA;AAE5F;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,MAAO,IAAI,KAAG,MAAqC,CAAA;AAErE;;;;GAIG;AACH,eAAO,MAAM,MAAM,MAAO,IAAI,KAAG,MAA6B,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,aAAa,MAAO,IAAI,KAAG,MAA+B,CAAA;AAEvE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,MAAO,IAAI,KAAK,IAAI,KAAG,MAAyC,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,eAAe,MAAO,IAAI,KAAK,IAAI,KAAG,MAIlD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,MAAO,IAAI,YAAY,IAAI,KAAG,IAGrD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,MAAO,IAAI,KAAK,IAAI,KAAK,MAAM,KAAG,IAAgE,CAAA;AAEnH;;;;GAIG;AACH,eAAO,MAAM,UAAU,YAAa,IAAI,UAAU,IAAI,YAAY,MAAM,KAAG,IAM1E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,MAAO,IAAI,OAAO,MAAM,KAAG,IAGlD,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,YAAa,IAAI,UAAU,IAAI,QAAQ,MAAM,MAAM,MAAM,KAAG,IAMnF,CAAA"}
package/dist/Vec2.js CHANGED
@@ -1,11 +1,10 @@
1
1
  /**
2
2
  * Plain two-dimensional vector arithmetic for hot paths.
3
3
  *
4
- * `Vector2` validates values at a boundary (authored data, saves, components);
5
- * `Vec2` is the arithmetic that runs every frame on numbers already known to
6
- * be sane. Values are immutable `{ x, y }` records and every helper returns a
7
- * new one. A branded `Vector2` is a `Vec2`, so validated values flow into
8
- * these helpers without conversion.
4
+ * Values are immutable `{ x, y }` records and every helper returns a new
5
+ * one, so a component's value (validated once by the game's schema when it
6
+ * entered the world) passes straight in. Lengths and angles go through
7
+ * `Ops`, so the results replay the same on every engine.
9
8
  *
10
9
  * @example
11
10
  * ```ts
@@ -23,7 +22,7 @@
23
22
  * @categoryDescription Operations
24
23
  * Immutable arithmetic, measurement, and steering helpers.
25
24
  */
26
- import * as Ops from "./Ops.js";
25
+ import * as Ops from "@typeonce/ritmo/Ops";
27
26
  /**
28
27
  * The zero vector (frozen, safe to share).
29
28
  *
@@ -49,7 +48,8 @@ export const subtract = (a, b) => ({ x: a.x - b.x, y: a.y - b.y });
49
48
  */
50
49
  export const scale = (a, factor) => ({ x: a.x * factor, y: a.y * factor });
51
50
  /**
52
- * `a` turned by `angle` radians (counter-clockwise for a y-up frame).
51
+ * `a` turned by `angle` radians (counter-clockwise for a y-up frame). For a
52
+ * quarter turn use {@link perpendicular}, which is exact.
53
53
  *
54
54
  * @category Operations
55
55
  */
@@ -59,11 +59,39 @@ export const rotate = (a, angle) => {
59
59
  return { x: a.x * cos - a.y * sin, y: a.x * sin + a.y * cos };
60
60
  };
61
61
  /**
62
- * Dot product.
62
+ * `a` turned a quarter turn counter-clockwise (for a y-up frame):
63
+ * `{ x: -a.y, y: a.x }`. Exact. For the normal of a wall or a direction, a
64
+ * sideways push, and the signed side of a point: `dot(perpendicular(forward),
65
+ * offset)` is positive on the left of `forward`, negative on its right.
66
+ *
67
+ * @category Operations
68
+ */
69
+ export const perpendicular = (a) => ({ x: -a.y, y: a.x });
70
+ /**
71
+ * Dot product. With {@link perpendicular} it is also the 2D cross product:
72
+ * `dot(perpendicular(a), b)`.
63
73
  *
64
74
  * @category Operations
65
75
  */
66
76
  export const dot = (a, b) => a.x * b.x + a.y * b.y;
77
+ /**
78
+ * The unit vector at `angle` radians from the x axis (counter-clockwise for a
79
+ * y-up frame), through `Ops.cos` and `Ops.sin`. Multiply by a length with
80
+ * {@link scale}. The inverse of {@link angle}.
81
+ *
82
+ * @category Operations
83
+ */
84
+ export const fromAngle = (angle) => ({ x: Ops.cos(angle), y: Ops.sin(angle) });
85
+ /**
86
+ * The angle of `a` from the x axis in radians, in (-π, π], through
87
+ * `Ops.atan2` (so no `y, x` argument order to get wrong). The zero vector
88
+ * gives 0, and so does `-0` in either coordinate where `Ops.atan2` would give
89
+ * `-0` or flip to -π. To keep it in `Angle`'s range [-π, π), use
90
+ * `Angle.wrap`; to turn toward it, `Angle.turnToward`.
91
+ *
92
+ * @category Operations
93
+ */
94
+ export const angle = (a) => Ops.atan2(a.y + 0, a.x + 0);
67
95
  /**
68
96
  * Length of `a`.
69
97
  *
@@ -131,4 +159,24 @@ export const clampLength = (a, max) => {
131
159
  const len = Ops.hypot(a.x, a.y);
132
160
  return len <= max ? a : { x: (a.x / len) * max, y: (a.y / len) * max };
133
161
  };
162
+ /**
163
+ * Moves `current` toward `target` by the share `rate` closes per second, over
164
+ * `dt` seconds, with one shared factor `exp(-rate * dt)` so the point moves
165
+ * along the straight line: the same total time gives the same result at any
166
+ * step rate. `current` unchanged when `rate * dt` is 0 or less, `target`
167
+ * itself when `rate` is `Infinity` (and `dt` positive). It nears `target`
168
+ * without reaching it; when it must arrive, use {@link moveToward}. For
169
+ * plain numbers use `Scalar.decayToward`.
170
+ *
171
+ * @category Operations
172
+ */
173
+ export const decayToward = (current, target, rate, dt) => {
174
+ const k = rate * dt;
175
+ if (!(k > 0))
176
+ return current;
177
+ if (k === Infinity)
178
+ return target;
179
+ const factor = Ops.exp(-k);
180
+ return { x: target.x + (current.x - target.x) * factor, y: target.y + (current.y - target.y) * factor };
181
+ };
134
182
  //# sourceMappingURL=Vec2.js.map