@iyulab/u-numflow 0.6.3 → 0.6.4

package/README.md

@@ -38,31 +38,34 @@ u-numflow = "0.2"
 ```
 
 ```rust
-use u_numflow::stats::OnlineStats;
-use u_numflow::distributions::{PertDistribution, Distribution};
-use u_numflow::random::Rng;
+use u_numflow::distributions::Pert;
+use u_numflow::random::{create_rng, shuffle};
+use u_numflow::stats::WelfordAccumulator;
 
-// Online statistics with numerical stability
-let mut stats = OnlineStats::new();
+// Online statistics with numerical stability (Welford)
+let mut stats = WelfordAccumulator::new();
 for x in [1.0, 2.0, 3.0, 4.0, 5.0] {
-    stats.push(x);
+    stats.update(x);
 }
-assert_eq!(stats.mean(), 3.0);
+assert_eq!(stats.mean(), Some(3.0));
 
-// PERT distribution sampling
-let pert = PertDistribution::new(1.0, 4.0, 7.0);
-let mut rng = Rng::seed_from_u64(42);
-let sample = pert.sample(&mut rng);
+// PERT distribution: moments and quantiles; sample by inverting a uniform draw
+let pert = Pert::new(1.0, 4.0, 7.0).unwrap();
+assert_eq!(pert.mean(), 4.0);
+let p90 = pert.quantile(0.9).unwrap();
+assert!(p90 > 4.0 && p90 < 7.0);
 
 // Seeded shuffling for reproducibility
+let mut rng = create_rng(42);
 let mut items = vec![1, 2, 3, 4, 5];
-u_numflow::random::shuffle(&mut items, &mut rng);
+shuffle(&mut items, &mut rng);
 
 // Box-Cox transformation (non-normal data normalization)
-use u_numflow::transforms::{estimate_lambda, box_cox};
+use u_numflow::transforms::{box_cox, estimate_lambda};
 let data = [1.0, 2.0, 4.0, 8.0, 16.0];
-let lambda = estimate_lambda(&data, -2.0, 2.0).unwrap(); // MLE via golden-section
-let transformed = box_cox(&data, lambda).unwrap();
+let fit = estimate_lambda(&data, -2.0, 2.0).unwrap(); // MLE via golden-section
+let transformed = box_cox(&data, fit.lambda).unwrap();
+assert_eq!(transformed.len(), data.len());
 
 // Discrete Fourier transform of any length
 use u_numflow::fourier::rfft;
@@ -125,20 +128,22 @@ t_distribution_quantile(0.975, 10); // 2.2281…
 
 ### TypeScript
 
-Every exported function declares its return type, and the declarations are
-generated from the same structs the binding serialises, so they cannot drift
-from what it actually returns:
+Every exported function declares its parameter and return types, and the
+declarations are generated from the same structs the binding reads and
+serialises, so they cannot drift from what it actually accepts and returns:
 
 ```ts
-export function estimate_lambda(data: any): LambdaEstimateDto;
+export function estimate_lambda(data: Float64Array, lambda_min: number, lambda_max: number): LambdaEstimateDto;
 ```
 
 An absent optional value is declared `T | undefined`, which is what the binding
 sends. Nothing needs an `as` cast -- and a wrong assumption about a result's
 shape is a compile error rather than something that fails at run time.
 
-Inputs are still `any`: they are validated at the boundary, and a rejected one
-says what was wrong.
+Every parameter is a number or a `Float64Array`, so there is nothing to
+declare beyond what wasm-bindgen already does; the publishing workflow keeps it
+that way. The binding still validates every input at the boundary, and a
+rejected one says what was wrong.
 
 ## Related
 

package/node/u_numflow.cjs

@@ -289,10 +289,10 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_new_bebc3f4757acf305: function() {
+        __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return ret;
         },

package/package.json

@@ -5,7 +5,7 @@
     "iyulab"
   ],
   "description": "Foundational mathematical primitives: statistics, probability distributions, random sampling, and collections.",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "license": "MIT",
   "repository": {
     "type": "git",

package/u_numflow_bg.js

@@ -269,10 +269,10 @@ export function __wbg_String_8564e559799eccda(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
-export function __wbg___wbindgen_throw_5d9e815e6fdf150f(arg0, arg1) {
+export function __wbg___wbindgen_throw_41e9ee4f547fc59a(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
-export function __wbg_new_bebc3f4757acf305() {
+export function __wbg_new_617a8cdb8bb1130e() {
     const ret = new Object();
     return ret;
 }