@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.
Files changed (112) hide show
  1. package/CHANGELOG.md +124 -0
  2. package/README.md +17 -12
  3. package/dist/Angle.d.ts +49 -0
  4. package/dist/Angle.d.ts.map +1 -0
  5. package/dist/Angle.js +67 -0
  6. package/dist/Angle.js.map +1 -0
  7. package/dist/Box2.d.ts +20 -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 +23 -1
  12. package/dist/Collide2.d.ts.map +1 -1
  13. package/dist/Collide2.js +23 -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 +22 -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 +54 -51
  22. package/dist/Scalar.js.map +1 -1
  23. package/dist/Segment2.d.ts +3 -0
  24. package/dist/Segment2.d.ts.map +1 -1
  25. package/dist/Segment2.js.map +1 -1
  26. package/dist/Vec2.d.ts +50 -7
  27. package/dist/Vec2.d.ts.map +1 -1
  28. package/dist/Vec2.js +59 -8
  29. package/dist/Vec2.js.map +1 -1
  30. package/dist/index.d.ts +9 -22
  31. package/dist/index.d.ts.map +1 -1
  32. package/dist/index.js +9 -22
  33. package/dist/index.js.map +1 -1
  34. package/package.json +3 -3
  35. package/src/Angle.ts +65 -0
  36. package/src/Box2.ts +24 -4
  37. package/src/Collide2.ts +30 -2
  38. package/src/FlowField.ts +38 -10
  39. package/src/Scalar.ts +46 -165
  40. package/src/Segment2.ts +3 -0
  41. package/src/Vec2.ts +61 -8
  42. package/src/index.ts +9 -22
  43. package/dist/Aabb.d.ts +0 -182
  44. package/dist/Aabb.d.ts.map +0 -1
  45. package/dist/Aabb.js +0 -109
  46. package/dist/Aabb.js.map +0 -1
  47. package/dist/InputAxis.d.ts +0 -44
  48. package/dist/InputAxis.d.ts.map +0 -1
  49. package/dist/InputAxis.js +0 -71
  50. package/dist/InputAxis.js.map +0 -1
  51. package/dist/Ops.d.ts +0 -209
  52. package/dist/Ops.d.ts.map +0 -1
  53. package/dist/Ops.js +0 -210
  54. package/dist/Ops.js.map +0 -1
  55. package/dist/Random.d.ts +0 -124
  56. package/dist/Random.d.ts.map +0 -1
  57. package/dist/Random.js +0 -126
  58. package/dist/Random.js.map +0 -1
  59. package/dist/Size2.d.ts +0 -118
  60. package/dist/Size2.d.ts.map +0 -1
  61. package/dist/Size2.js +0 -54
  62. package/dist/Size2.js.map +0 -1
  63. package/dist/SpatialGrid.d.ts +0 -68
  64. package/dist/SpatialGrid.d.ts.map +0 -1
  65. package/dist/SpatialGrid.js +0 -112
  66. package/dist/SpatialGrid.js.map +0 -1
  67. package/dist/Vector2.d.ts +0 -214
  68. package/dist/Vector2.d.ts.map +0 -1
  69. package/dist/Vector2.js +0 -134
  70. package/dist/Vector2.js.map +0 -1
  71. package/dist/internal/aabb.d.ts +0 -27
  72. package/dist/internal/aabb.d.ts.map +0 -1
  73. package/dist/internal/aabb.js +0 -52
  74. package/dist/internal/aabb.js.map +0 -1
  75. package/dist/internal/codec.d.ts +0 -9
  76. package/dist/internal/codec.d.ts.map +0 -1
  77. package/dist/internal/codec.js +0 -16
  78. package/dist/internal/codec.js.map +0 -1
  79. package/dist/internal/fdlibm.d.ts +0 -43
  80. package/dist/internal/fdlibm.d.ts.map +0 -1
  81. package/dist/internal/fdlibm.js +0 -1291
  82. package/dist/internal/fdlibm.js.map +0 -1
  83. package/dist/internal/inputAxis.d.ts +0 -11
  84. package/dist/internal/inputAxis.d.ts.map +0 -1
  85. package/dist/internal/inputAxis.js +0 -13
  86. package/dist/internal/inputAxis.js.map +0 -1
  87. package/dist/internal/scalar.d.ts +0 -11
  88. package/dist/internal/scalar.d.ts.map +0 -1
  89. package/dist/internal/scalar.js +0 -68
  90. package/dist/internal/scalar.js.map +0 -1
  91. package/dist/internal/size2.d.ts +0 -22
  92. package/dist/internal/size2.d.ts.map +0 -1
  93. package/dist/internal/size2.js +0 -38
  94. package/dist/internal/size2.js.map +0 -1
  95. package/dist/internal/vector2.d.ts +0 -39
  96. package/dist/internal/vector2.d.ts.map +0 -1
  97. package/dist/internal/vector2.js +0 -78
  98. package/dist/internal/vector2.js.map +0 -1
  99. package/src/Aabb.ts +0 -180
  100. package/src/InputAxis.ts +0 -81
  101. package/src/Ops.ts +0 -232
  102. package/src/Random.ts +0 -225
  103. package/src/Size2.ts +0 -122
  104. package/src/SpatialGrid.ts +0 -172
  105. package/src/Vector2.ts +0 -216
  106. package/src/internal/aabb.ts +0 -81
  107. package/src/internal/codec.ts +0 -21
  108. package/src/internal/fdlibm.ts +0 -1256
  109. package/src/internal/inputAxis.ts +0 -21
  110. package/src/internal/scalar.ts +0 -104
  111. package/src/internal/size2.ts +0 -54
  112. package/src/internal/vector2.ts +0 -121
@@ -1,37 +1,5 @@
1
- /**
2
- * Finding the way around walls: a flow field over a grid of square cells.
3
- *
4
- * Every open cell knows its distance to the goal along the shortest path over
5
- * its eight neighbors (never cutting a wall's corner), so each body only asks
6
- * which neighbor is closer: one search serves every body following the same
7
- * goal. Cells are blocked where a body of `clearance` would touch a wall, so
8
- * the ways it gives keep bodies off the walls.
9
- *
10
- * The grid covers the area the walls span. The walls are taken again only
11
- * when they change, and distances are worked out again only when the goal
12
- * moves to another cell, so calling `setWalls` and `setGoal` every step is
13
- * cheap.
14
- *
15
- * @example
16
- * ```ts
17
- * const paths = FlowField.make(cellSize)
18
- * // Each step:
19
- * paths.setWalls(walls, bodyRadius)
20
- * paths.setGoal(player)
21
- * const way = paths.way(enemy) // unit vector, or undefined: walled off or outside
22
- * ```
23
- *
24
- * @module FlowField
25
- * @docGroup helpers
26
- *
27
- * @categoryDescription Field Types
28
- * The flow field interface.
29
- *
30
- * @categoryDescription Construction
31
- * Making a flow field.
32
- */
1
+ import * as Result from "@typeonce/ritmo/Result";
33
2
  import { type Box2 } from "./Box2.ts";
34
- import type * as Scalar from "./Scalar.ts";
35
3
  import type { Vec2 } from "./Vec2.ts";
36
4
  /**
37
5
  * A flow field toward one goal.
@@ -39,8 +7,8 @@ import type { Vec2 } from "./Vec2.ts";
39
7
  * @category Field Types
40
8
  */
41
9
  export interface FlowField {
42
- /** The side of one square cell, in world units. */
43
- readonly cellSize: Scalar.Positive;
10
+ /** The side of one square cell, in world units: finite and above 0. */
11
+ readonly cellSize: number;
44
12
  /**
45
13
  * Takes `boxes` as the walls, blocking every cell whose center is within
46
14
  * `clearance` of one, over the area the walls span. Does nothing when the
@@ -62,12 +30,30 @@ export interface FlowField {
62
30
  /** The path distance from the cell holding `at` to the goal, or `undefined` outside the grid or when walled off. */
63
31
  distance(at: Vec2): number | undefined;
64
32
  }
33
+ /**
34
+ * Why {@link make} made no flow field: `value`, the cell size it was given,
35
+ * is not a finite number above 0.
36
+ *
37
+ * @category Construction
38
+ */
39
+ export interface InvalidCellSize {
40
+ readonly _tag: "InvalidCellSize";
41
+ readonly value: number;
42
+ }
65
43
  /**
66
44
  * An empty flow field (no walls, no goal) with square cells of `cellSize`
67
- * world units. Smaller cells follow walls more closely and cost more to
68
- * search; around a body's diameter is a good start.
45
+ * world units, or `InvalidCellSize` when `cellSize` is not a finite number
46
+ * above 0. Smaller cells follow walls more closely and cost more to search;
47
+ * around a body's diameter is a good start. Make it once (in a service or a
48
+ * system's setup) and reuse it every step.
49
+ *
50
+ * @example
51
+ * ```ts
52
+ * const paths = FlowField.make(30)
53
+ * if (!paths.ok) throw new Error(`bad cell size ${paths.error.value}`)
54
+ * ```
69
55
  *
70
56
  * @category Construction
71
57
  */
72
- export declare const make: (cellSize: Scalar.Positive) => FlowField;
58
+ export declare const make: (cellSize: number) => Result.Result<FlowField, InvalidCellSize>;
73
59
  //# sourceMappingURL=FlowField.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"FlowField.d.ts","sourceRoot":"","sources":["../src/FlowField.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,KAAK,IAAI,EAAkB,MAAM,WAAW,CAAA;AAErD,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAA;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7D;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,oHAAoH;IACpH,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;CACvC;AA8MD;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,aAAc,MAAM,CAAC,QAAQ,KAAG,SAAgC,CAAA"}
1
+ {"version":3,"file":"FlowField.d.ts","sourceRoot":"","sources":["../src/FlowField.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,KAAK,IAAI,EAAkB,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7D;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,oHAAoH;IACpH,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;CACvC;AA8MD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,IAAI,aAAc,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,CAGd,CAAA"}
package/dist/FlowField.js CHANGED
@@ -14,7 +14,13 @@
14
14
  *
15
15
  * @example
16
16
  * ```ts
17
- * const paths = FlowField.make(cellSize)
17
+ * declare const cellSize: number, bodyRadius: number
18
+ * declare const walls: ReadonlyArray<Box2.Box2>
19
+ * declare const player: Vec2.Vec2, enemy: Vec2.Vec2
20
+ * // ---cut---
21
+ * const made = FlowField.make(cellSize)
22
+ * if (!made.ok) throw new Error(`bad cell size ${made.error.value}`)
23
+ * const paths = made.value
18
24
  * // Each step:
19
25
  * paths.setWalls(walls, bodyRadius)
20
26
  * paths.setGoal(player)
@@ -30,8 +36,9 @@
30
36
  * @categoryDescription Construction
31
37
  * Making a flow field.
32
38
  */
39
+ import * as Ops from "@typeonce/ritmo/Ops";
40
+ import * as Result from "@typeonce/ritmo/Result";
33
41
  import { overlapsCircle } from "./Box2.js";
34
- import * as Ops from "./Ops.js";
35
42
  // The eight steps to a neighbor (straight ones first) and their lengths, as
36
43
  // parallel arrays: the search reads them for every cell it settles.
37
44
  const stepX = Int8Array.of(1, -1, 0, 0, 1, 1, -1, -1);
@@ -245,10 +252,20 @@ class Field {
245
252
  }
246
253
  /**
247
254
  * 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.
255
+ * world units, or `InvalidCellSize` when `cellSize` is not a finite number
256
+ * above 0. Smaller cells follow walls more closely and cost more to search;
257
+ * around a body's diameter is a good start. Make it once (in a service or a
258
+ * system's setup) and reuse it every step.
259
+ *
260
+ * @example
261
+ * ```ts
262
+ * const paths = FlowField.make(30)
263
+ * if (!paths.ok) throw new Error(`bad cell size ${paths.error.value}`)
264
+ * ```
250
265
  *
251
266
  * @category Construction
252
267
  */
253
- export const make = (cellSize) => new Field(cellSize);
268
+ export const make = (cellSize) => cellSize > 0 && cellSize < Infinity
269
+ ? Result.success(new Field(cellSize))
270
+ : Result.failure({ _tag: "InvalidCellSize", value: cellSize });
254
271
  //# 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":"AA4BA;;;;;;;;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,73 @@
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
+ * declare const current: number, topSpeed: number, acceleration: number, target: number, dt: number
13
+ * declare const view: { readonly zoom: number }
14
+ * // ---cut---
15
+ * // Accelerate toward the top speed by at most `acceleration * dt` per step.
16
+ * const speed = Scalar.moveToward(current, topSpeed, acceleration * dt)
17
+ * // Ease a zoom toward its target the same way at any step rate.
18
+ * const zoom = Scalar.decayToward(view.zoom, target, 8, dt)
19
+ * ```
31
20
  *
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`).
21
+ * @module Scalar
22
+ * @docGroup helpers
41
23
  *
42
- * @category Operations
24
+ * @categoryDescription Operations
25
+ * Moving one number toward another.
43
26
  */
44
- export const lerp = internal.lerp;
27
+ import * as Ops from "@typeonce/ritmo/Ops";
45
28
  /**
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.
29
+ * Moves `current` toward `target` by at most `maxDelta`, never overshooting:
30
+ * `target` itself once the gap is `maxDelta` or less, and `current` unchanged
31
+ * when `maxDelta` is 0 or less. For a constant rate (acceleration, a meter
32
+ * filling); for an ease that slows near the target use {@link decayToward},
33
+ * for vectors `Vec2.moveToward`, for angles `Angle.turnToward`.
50
34
  *
51
35
  * @category Operations
52
36
  */
53
- export const approach = internal.approach;
37
+ export const moveToward = (current, target, maxDelta) => {
38
+ if (!(maxDelta > 0))
39
+ return current;
40
+ const gap = target - current;
41
+ if (Math.abs(gap) <= maxDelta)
42
+ return target;
43
+ return gap > 0 ? current + maxDelta : current - maxDelta;
44
+ };
54
45
  /**
55
- * Returns the interpolation amount of one value within a finite input range.
56
- *
57
- * Fails explicitly when the input range has zero size.
46
+ * The number `amount` of the way from `start` (at 0) to `end` (at 1). The
47
+ * amount is not clamped, so 1.5 goes past `end`. For a fixed blend between
48
+ * two values; to approach a target over time use {@link moveToward} or
49
+ * {@link decayToward}, for vectors `Vec2.lerp`.
58
50
  *
59
51
  * @category Operations
60
52
  */
61
- export const inverseLerp = internal.inverseLerp;
53
+ export const lerp = (start, end, amount) => start + (end - start) * amount;
62
54
  /**
63
- * Remaps one finite value from one input range to one output range.
64
- *
65
- * Fails explicitly when the input range has zero size.
55
+ * Moves `current` toward `target` by the share `rate` closes per second,
56
+ * over `dt` seconds: `target + (current - target) * exp(-rate * dt)`. The
57
+ * same total time gives the same result at any step rate, which `lerp` by a
58
+ * fixed amount per step does not. `current` unchanged when `rate * dt` is 0
59
+ * or less, `target` itself when `rate` is `Infinity` (and `dt` positive).
60
+ * It nears `target` without reaching it; when it must arrive, use
61
+ * {@link moveToward}. For vectors use `Vec2.decayToward`.
66
62
  *
67
63
  * @category Operations
68
64
  */
69
- export const remap = internal.remap;
65
+ export const decayToward = (current, target, rate, dt) => {
66
+ const k = rate * dt;
67
+ if (!(k > 0))
68
+ return current;
69
+ if (k === Infinity)
70
+ return target;
71
+ return target + (current - target) * Ops.exp(-k);
72
+ };
70
73
  //# 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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"}
@@ -9,6 +9,9 @@
9
9
  *
10
10
  * @example
11
11
  * ```ts
12
+ * declare const position: Vec2.Vec2, delta: Vec2.Vec2
13
+ * declare const radius: number
14
+ * // ---cut---
12
15
  * const fence = Segment2.between({ x: 0, y: 0 }, { x: 40, y: 30 })
13
16
  * const moved = Collide2.moveCircle(position, delta, radius, { segments: [fence] })
14
17
  * ```
@@ -1 +1 @@
1
- {"version":3,"file":"Segment2.d.ts","sourceRoot":"","sources":["../src/Segment2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,MAAO,IAAI,KAAK,IAAI,KAAG,QAAoD,CAAA;AAE/F;;;;GAIG;AACH,eAAO,MAAM,YAAY,YAAa,QAAQ,SAAS,IAAI,KAAG,IAO7D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,YAAa,QAAQ,UAAU,IAAI,UAAU,MAAM,KAAG,OAKhF,CAAA"}
1
+ {"version":3,"file":"Segment2.d.ts","sourceRoot":"","sources":["../src/Segment2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,MAAO,IAAI,KAAK,IAAI,KAAG,QAAoD,CAAA;AAE/F;;;;GAIG;AACH,eAAO,MAAM,YAAY,YAAa,QAAQ,SAAS,IAAI,KAAG,IAO7D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,YAAa,QAAQ,UAAU,IAAI,UAAU,MAAM,KAAG,OAKhF,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"Segment2.js","sourceRoot":"","sources":["../src/Segment2.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAO,EAAE,CAAO,EAAY,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAE/F;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAiB,EAAE,KAAW,EAAQ,EAAE;IACnE,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IAClC,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACvC,IAAI,aAAa,GAAG,KAAK;QAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;IACnH,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;AACnE,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAiB,EAAE,MAAY,EAAE,MAAc,EAAW,EAAE;IACzF,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;IAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,GAAG,MAAM,CAAA;AAC7C,CAAC,CAAA"}
1
+ {"version":3,"file":"Segment2.js","sourceRoot":"","sources":["../src/Segment2.ts"],"names":[],"mappings":"AA0CA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAO,EAAE,CAAO,EAAY,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAE/F;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAiB,EAAE,KAAW,EAAQ,EAAE;IACnE,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IAClC,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACvC,IAAI,aAAa,GAAG,KAAK;QAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;IACnH,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;AACnE,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAiB,EAAE,MAAY,EAAE,MAAc,EAAW,EAAE;IACzF,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAA;IAC/B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,MAAM,GAAG,MAAM,CAAA;AAC7C,CAAC,CAAA"}