@aura3d/math 3.0.1 → 4.0.2

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/dist/Easing.d.ts CHANGED
@@ -1,7 +1,51 @@
1
+ /**
2
+ * Easing — the full Penner set keyed by PRD-09 §7.6 `EaseName` plus
3
+ * `spring(stiffness, damping)`, a closed-form spring toward 1.
4
+ *
5
+ * Every function asserts its input is in [0, 1] (unchanged contract). Output
6
+ * may overshoot for back/elastic/bounce/spring by design.
7
+ */
1
8
  export declare const Easing: Readonly<{
2
9
  linear(t: number): number;
3
10
  easeInQuad(t: number): number;
4
11
  easeOutQuad(t: number): number;
5
12
  easeInOutCubic(t: number): number;
13
+ quadIn: (t: number) => number;
14
+ quadOut: (t: number) => number;
15
+ quadInOut: (t: number) => number;
16
+ cubicIn: (t: number) => number;
17
+ cubicOut: (t: number) => number;
18
+ cubicInOut: (t: number) => number;
19
+ quartIn: (t: number) => number;
20
+ quartOut: (t: number) => number;
21
+ quartInOut: (t: number) => number;
22
+ quintIn: (t: number) => number;
23
+ quintOut: (t: number) => number;
24
+ quintInOut: (t: number) => number;
25
+ sineIn: (t: number) => number;
26
+ sineOut: (t: number) => number;
27
+ sineInOut: (t: number) => number;
28
+ expoIn: (t: number) => number;
29
+ expoOut: (t: number) => number;
30
+ expoInOut: (t: number) => number;
31
+ circIn: (t: number) => number;
32
+ circOut: (t: number) => number;
33
+ circInOut: (t: number) => number;
34
+ backIn: (t: number) => number;
35
+ backOut: (t: number) => number;
36
+ backInOut: (t: number) => number;
37
+ elasticIn: (t: number) => number;
38
+ elasticOut: (t: number) => number;
39
+ elasticInOut: (t: number) => number;
40
+ bounceIn: (t: number) => number;
41
+ bounceOut: (t: number) => number;
42
+ bounceInOut: (t: number) => number;
43
+ /**
44
+ * §7.6 `Easing.spring(stiffness, damping)` — critically/under-damped spring
45
+ * from 0 toward 1; `t` is normalized [0,1] time. Closed-form solution of
46
+ * `x'' = -k(x-1) - c·x'` at `x(0)=0`, `x'(0)=0`. Output may overshoot when
47
+ * under-damped.
48
+ */
49
+ spring(stiffness: number, damping: number): (t: number) => number;
6
50
  }>;
7
51
  //# sourceMappingURL=Easing.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Easing.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Easing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;cACP,MAAM,GAAG,MAAM;kBAIX,MAAM,GAAG,MAAM;mBAId,MAAM,GAAG,MAAM;sBAIZ,MAAM,GAAG,MAAM;EAIjC,CAAC"}
1
+ {"version":3,"file":"Easing.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Easing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;cACP,MAAM,GAAG,MAAM;kBAIX,MAAM,GAAG,MAAM;mBAId,MAAM,GAAG,MAAM;sBAIZ,MAAM,GAAG,MAAM;gBA8FW,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;kBAAjB,MAAM,KAAK,MAAM;oBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;kBAAjB,MAAM,KAAK,MAAM;oBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;kBAAjB,MAAM,KAAK,MAAM;oBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;gBAAjB,MAAM,KAAK,MAAM;iBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;oBAAjB,MAAM,KAAK,MAAM;sBAAjB,MAAM,KAAK,MAAM;kBAAjB,MAAM,KAAK,MAAM;mBAAjB,MAAM,KAAK,MAAM;qBAAjB,MAAM,KAAK,MAAM;IA5B7D;;;;;OAKG;sBACe,MAAM,WAAW,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM;EAoBjE,CAAC"}
package/dist/Easing.js CHANGED
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Easing — the full Penner set keyed by PRD-09 §7.6 `EaseName` plus
3
+ * `spring(stiffness, damping)`, a closed-form spring toward 1.
4
+ *
5
+ * Every function asserts its input is in [0, 1] (unchanged contract). Output
6
+ * may overshoot for back/elastic/bounce/spring by design.
7
+ */
1
8
  export const Easing = Object.freeze({
2
9
  linear(t) {
3
10
  assertUnit(t);
@@ -14,8 +21,93 @@ export const Easing = Object.freeze({
14
21
  easeInOutCubic(t) {
15
22
  assertUnit(t);
16
23
  return t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;
24
+ },
25
+ // ---- §7.6 EaseName set -------------------------------------------------
26
+ quadIn: ease((t) => t * t),
27
+ quadOut: ease((t) => 1 - (1 - t) * (1 - t)),
28
+ quadInOut: ease((t) => (t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2)),
29
+ cubicIn: ease((t) => t * t * t),
30
+ cubicOut: ease((t) => 1 - Math.pow(1 - t, 3)),
31
+ cubicInOut: ease((t) => (t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2)),
32
+ quartIn: ease((t) => t * t * t * t),
33
+ quartOut: ease((t) => 1 - Math.pow(1 - t, 4)),
34
+ quartInOut: ease((t) => (t < 0.5 ? 8 * t * t * t * t : 1 - Math.pow(-2 * t + 2, 4) / 2)),
35
+ quintIn: ease((t) => t * t * t * t * t),
36
+ quintOut: ease((t) => 1 - Math.pow(1 - t, 5)),
37
+ quintInOut: ease((t) => (t < 0.5 ? 16 * t * t * t * t * t : 1 - Math.pow(-2 * t + 2, 5) / 2)),
38
+ sineIn: ease((t) => 1 - Math.cos((t * Math.PI) / 2)),
39
+ sineOut: ease((t) => Math.sin((t * Math.PI) / 2)),
40
+ sineInOut: ease((t) => -(Math.cos(Math.PI * t) - 1) / 2),
41
+ expoIn: ease((t) => (t === 0 ? 0 : Math.pow(2, 10 * t - 10))),
42
+ expoOut: ease((t) => (t === 1 ? 1 : 1 - Math.pow(2, -10 * t))),
43
+ expoInOut: ease((t) => t === 0 ? 0 : t === 1 ? 1 : t < 0.5 ? Math.pow(2, 20 * t - 10) / 2 : (2 - Math.pow(2, -20 * t + 10)) / 2),
44
+ circIn: ease((t) => 1 - Math.sqrt(1 - t * t)),
45
+ circOut: ease((t) => Math.sqrt(1 - Math.pow(t - 1, 2))),
46
+ circInOut: ease((t) => t < 0.5 ? (1 - Math.sqrt(1 - Math.pow(2 * t, 2))) / 2 : (Math.sqrt(1 - Math.pow(-2 * t + 2, 2)) + 1) / 2),
47
+ backIn: ease((t) => BACK_INOUT * t * t * t - BACK * t * t),
48
+ backOut: ease((t) => 1 + BACK_INOUT * Math.pow(t - 1, 3) + BACK * Math.pow(t - 1, 2)),
49
+ backInOut: ease((t) => t < 0.5
50
+ ? (Math.pow(2 * t, 2) * ((BACK_INOUT2 + 1) * 2 * t - BACK_INOUT2)) / 2
51
+ : (Math.pow(2 * t - 2, 2) * ((BACK_INOUT2 + 1) * (2 * t - 2) + BACK_INOUT2) + 2) / 2),
52
+ elasticIn: ease((t) => t === 0 ? 0 : t === 1 ? 1 : -Math.pow(2, 10 * t - 10) * Math.sin((t * 10 - 10.75) * ELASTIC_C4)),
53
+ elasticOut: ease((t) => t === 0 ? 0 : t === 1 ? 1 : Math.pow(2, -10 * t) * Math.sin((t * 10 - 0.75) * ELASTIC_C4) + 1),
54
+ elasticInOut: ease((t) => t === 0
55
+ ? 0
56
+ : t === 1
57
+ ? 1
58
+ : t < 0.5
59
+ ? -(Math.pow(2, 20 * t - 10) * Math.sin((20 * t - 11.125) * ELASTIC_C5)) / 2
60
+ : (Math.pow(2, -20 * t + 10) * Math.sin((20 * t - 11.125) * ELASTIC_C5)) / 2 + 1),
61
+ bounceIn: ease((t) => 1 - bounceOut(1 - t)),
62
+ bounceOut: ease(bounceOut),
63
+ bounceInOut: ease((t) => (t < 0.5 ? (1 - bounceOut(1 - 2 * t)) / 2 : (1 + bounceOut(2 * t - 1)) / 2)),
64
+ /**
65
+ * §7.6 `Easing.spring(stiffness, damping)` — critically/under-damped spring
66
+ * from 0 toward 1; `t` is normalized [0,1] time. Closed-form solution of
67
+ * `x'' = -k(x-1) - c·x'` at `x(0)=0`, `x'(0)=0`. Output may overshoot when
68
+ * under-damped.
69
+ */
70
+ spring(stiffness, damping) {
71
+ if (!(stiffness > 0) || damping < 0) {
72
+ throw new RangeError("spring requires stiffness > 0 and damping >= 0.");
73
+ }
74
+ const omega0 = Math.sqrt(stiffness);
75
+ const zeta = damping / (2 * omega0);
76
+ return ease((t) => {
77
+ if (zeta < 1 - 1e-9) {
78
+ const wd = omega0 * Math.sqrt(1 - zeta * zeta);
79
+ const env = Math.exp(-zeta * omega0 * t);
80
+ return 1 - env * (Math.cos(wd * t) + (zeta * omega0 / wd) * Math.sin(wd * t));
81
+ }
82
+ if (zeta > 1 + 1e-9) {
83
+ const r1 = -omega0 * (zeta - Math.sqrt(zeta * zeta - 1));
84
+ const r2 = -omega0 * (zeta + Math.sqrt(zeta * zeta - 1));
85
+ return 1 + (r2 * Math.exp(r1 * t) - r1 * Math.exp(r2 * t)) / (r1 - r2);
86
+ }
87
+ return 1 - Math.exp(-omega0 * t) * (1 + omega0 * t);
88
+ });
17
89
  }
18
90
  });
91
+ function ease(fn) {
92
+ return (t) => {
93
+ assertUnit(t);
94
+ return fn(t);
95
+ };
96
+ }
97
+ function bounceOut(t) {
98
+ if (t < 1 / 2.75)
99
+ return 7.5625 * t * t;
100
+ if (t < 2 / 2.75)
101
+ return 7.5625 * (t -= 1.5 / 2.75) * t + 0.75;
102
+ if (t < 2.5 / 2.75)
103
+ return 7.5625 * (t -= 2.25 / 2.75) * t + 0.9375;
104
+ return 7.5625 * (t -= 2.625 / 2.75) * t + 0.984375;
105
+ }
106
+ const BACK = 1.70158;
107
+ const BACK_INOUT = 2.70158;
108
+ const BACK_INOUT2 = BACK * 1.525;
109
+ const ELASTIC_C4 = (2 * Math.PI) / 3;
110
+ const ELASTIC_C5 = (2 * Math.PI) / 4.5;
19
111
  function assertUnit(t) {
20
112
  if (!Number.isFinite(t) || t < 0 || t > 1) {
21
113
  throw new RangeError("Easing input must be a finite value in [0, 1].");
@@ -1 +1 @@
1
- {"version":3,"file":"Easing.js","sourceRoot":"","sources":["../../../../packages/math/src/Easing.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,CAAC,CAAS;QACd,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IACD,UAAU,CAAC,CAAS;QAClB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,WAAW,CAAC,CAAS;QACnB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,CAAS;QACtB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"Easing.js","sourceRoot":"","sources":["../../../../packages/math/src/Easing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,CAAC,CAAS;QACd,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,CAAC;IACX,CAAC;IACD,UAAU,CAAC,CAAS;QAClB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,WAAW,CAAC,CAAS;QACnB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,CAAS;QACtB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,2EAA2E;IAC3E,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE/E,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpF,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAExF,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7F,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAExD,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CACzG;IAED,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CACzG;IAED,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,CAAC,GAAG,GAAG;QACL,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC;QACtE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CACvF;IAED,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC,CAChG;IACD,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACrB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAC9F;IACD,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACvB,CAAC,KAAK,CAAC;QACL,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC,KAAK,CAAC;YACP,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,CAAC,GAAG,GAAG;gBACP,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC;gBAC5E,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CACvF;IAED,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC;IAC1B,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAErG;;;;;OAKG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAe;QACvC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAChB,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;gBACpB,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;gBAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;gBACpB,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,EAAyB;IACrC,OAAO,CAAC,CAAS,EAAE,EAAE;QACnB,UAAU,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;QAAE,OAAO,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;QAAE,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI;QAAE,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACpE,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;AACrD,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC;AACrB,MAAM,UAAU,GAAG,OAAO,CAAC;AAC3B,MAAM,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC;AACjC,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AACrC,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AAEvC,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}
package/dist/Random.d.ts CHANGED
@@ -5,5 +5,18 @@ export declare class SeededRandom {
5
5
  nextFloat(): number;
6
6
  range(min: number, max: number): number;
7
7
  clone(): SeededRandom;
8
+ /** Integer in [min, maxExclusive). PRD-09 §7.6. */
9
+ int(min: number, maxExclusive: number): number;
10
+ /** Uniform pick from a non-empty array. PRD-09 §7.6. */
11
+ pick<T>(array: readonly T[]): T;
12
+ /** Fisher–Yates in-place shuffle; returns the same array. PRD-09 §7.6. */
13
+ shuffle<T>(array: T[]): T[];
14
+ /**
15
+ * Deterministically derived stream for a labelled subsystem — the same
16
+ * seed + label always produces the same child sequence, and different
17
+ * labels diverge. Consumes one draw from this stream so sibling forks do
18
+ * not share a seed. PRD-09 §7.6.
19
+ */
20
+ fork(label: string): SeededRandom;
8
21
  }
9
22
  //# sourceMappingURL=Random.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Random.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Random.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,MAAM;IAKxB,UAAU,IAAI,MAAM;IASpB,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAKvC,KAAK,IAAI,YAAY;CAKtB"}
1
+ {"version":3,"file":"Random.d.ts","sourceRoot":"","sources":["../../../../packages/math/src/Random.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,MAAM;IAKxB,UAAU,IAAI,MAAM;IASpB,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAKvC,KAAK,IAAI,YAAY;IAMrB,mDAAmD;IACnD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAO9C,wDAAwD;IACxD,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;IAK/B,0EAA0E;IAC1E,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAQ3B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;CAGlC"}
package/dist/Random.js CHANGED
@@ -26,5 +26,43 @@ export class SeededRandom {
26
26
  random.state = this.state;
27
27
  return random;
28
28
  }
29
+ /** Integer in [min, maxExclusive). PRD-09 §7.6. */
30
+ int(min, maxExclusive) {
31
+ if (!Number.isInteger(min) || !Number.isInteger(maxExclusive) || min >= maxExclusive) {
32
+ throw new RangeError("int requires integer min < maxExclusive.");
33
+ }
34
+ return min + Math.floor(this.nextFloat() * (maxExclusive - min));
35
+ }
36
+ /** Uniform pick from a non-empty array. PRD-09 §7.6. */
37
+ pick(array) {
38
+ if (array.length === 0)
39
+ throw new RangeError("pick requires a non-empty array.");
40
+ return array[this.int(0, array.length)];
41
+ }
42
+ /** Fisher–Yates in-place shuffle; returns the same array. PRD-09 §7.6. */
43
+ shuffle(array) {
44
+ for (let i = array.length - 1; i > 0; i--) {
45
+ const j = this.int(0, i + 1);
46
+ [array[i], array[j]] = [array[j], array[i]];
47
+ }
48
+ return array;
49
+ }
50
+ /**
51
+ * Deterministically derived stream for a labelled subsystem — the same
52
+ * seed + label always produces the same child sequence, and different
53
+ * labels diverge. Consumes one draw from this stream so sibling forks do
54
+ * not share a seed. PRD-09 §7.6.
55
+ */
56
+ fork(label) {
57
+ return new SeededRandom((this.nextUint32() ^ fnv1a(label)) >>> 0);
58
+ }
59
+ }
60
+ function fnv1a(text) {
61
+ let h = 0x811c9dc5;
62
+ for (let i = 0; i < text.length; i++) {
63
+ h ^= text.charCodeAt(i);
64
+ h = Math.imul(h, 0x01000193);
65
+ }
66
+ return h >>> 0;
29
67
  }
30
68
  //# sourceMappingURL=Random.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"Random.js","sourceRoot":"","sources":["../../../../packages/math/src/Random.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACf,KAAK,CAAS;IAEtB,YAAY,IAAY;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACnB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,aAAa,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,GAAW;QAC5B,IAAI,GAAG,GAAG,GAAG;YAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAC1D,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
1
+ {"version":3,"file":"Random.js","sourceRoot":"","sources":["../../../../packages/math/src/Random.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aura3d/math",
3
- "version": "3.0.1",
3
+ "version": "4.0.2",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",