@justinelliottcobb/amari-wasm 0.9.7 → 0.9.9

package/README.md

@@ -1,4 +1,4 @@
-# @justinelliottcobb/amari-wasm v0.9.0
+# @justinelliottcobb/amari-wasm v0.9.8
 
 **Unified Mathematical Computing Library with High-Precision WebAssembly Support**
 
@@ -6,42 +6,45 @@
 [![CI](https://github.com/justinelliottcobb/Amari/actions/workflows/ci.yml/badge.svg)](https://github.com/justinelliottcobb/Amari/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Amari is a comprehensive mathematical computing library that brings advanced algebraic systems to JavaScript/TypeScript through WebAssembly, now with full high-precision arithmetic support for spacecraft orbital mechanics and relativistic physics calculations. Features pure Rust implementation with no native dependencies for universal deployment.
+Amari is a comprehensive mathematical computing library that brings advanced algebraic systems to JavaScript/TypeScript through WebAssembly. Features high-precision arithmetic for spacecraft orbital mechanics and relativistic physics calculations with pure Rust implementation and no native dependencies for universal deployment.
 
 ## Features
 
-### New in v0.9.0: High-Precision WebAssembly
-- **Spacecraft Orbital Mechanics**: Full-precision trajectory calculations now available in browsers
-- **Relativistic Physics**: Spacetime algebra (Cl(1,3)) with WebAssembly-compatible precision
-- **Pure Rust Backend**: dashu-powered arithmetic with no native dependencies
-- **Universal Deployment**: Same precision guarantees across desktop, web, and edge environments
-- **WebAssembly 3.0 Ready**: Leverages latest WASM features for enhanced mathematical computing
-
 ### Core Mathematical Systems
+
 - **Geometric Algebra (Clifford Algebra)**: Multivectors, rotors, and geometric products for 3D rotations and spatial transformations
 - **Tropical Algebra**: Max-plus semiring operations for optimization and neural network applications
 - **Automatic Differentiation**: Forward-mode AD with dual numbers for exact derivatives
+- **Relativistic Physics**: Spacetime algebra (Cl(1,3)) with WebAssembly-compatible precision
+- **Spacecraft Orbital Mechanics**: Full-precision trajectory calculations in browsers
 - **Cellular Automata**: Geometric cellular automata with multivector states
 - **WebGPU Acceleration**: Optional GPU acceleration for large-scale operations
 - **Pure Rust Implementation**: Memory-safe, high-performance core with WASM bindings
 - **TypeScript Support**: Full TypeScript definitions included
 
+### High-Precision Arithmetic
+
+- **Pure Rust Backend**: dashu-powered arithmetic with no native dependencies
+- **Universal Deployment**: Same precision guarantees across desktop, web, and edge environments
+- **Orbital-Grade Tolerance**: Configurable precision for critical trajectory calculations
+- **WebAssembly 3.0 Ready**: Leverages latest WASM features for enhanced mathematical computing
+
 ## Installation
 
 ```bash
-npm install @amari/core
+npm install @justinelliottcobb/amari-wasm
 ```
 
 Or with yarn:
 
 ```bash
-yarn add @amari/core
+yarn add @justinelliottcobb/amari-wasm
 ```
 
 ## Quick Start
 
 ```typescript
-import init, { WasmMultivector, WasmRotor } from '@amari/core';
+import init, { WasmMultivector, WasmRotor } from '@justinelliottcobb/amari-wasm';
 
 async function main() {
   // Initialize the WASM module
@@ -79,7 +82,7 @@ async function main() {
 main();
 ```
 
-## High-Precision Orbital Mechanics (New in v0.9.0)
+## High-Precision Orbital Mechanics
 
 ```typescript
 import init, {
@@ -87,7 +90,7 @@ import init, {
   WasmFourVelocity,
   WasmRelativisticParticle,
   WasmSchwarzschildMetric
-} from '@amari/core';
+} from '@justinelliottcobb/amari-wasm';
 
 async function spacecraftSimulation() {
   await init();
@@ -124,7 +127,7 @@ async function spacecraftSimulation() {
   console.log(`Orbital trajectory computed with ${trajectory.length} points`);
   console.log(`Final position deviation: ${spacecraft.position_error()} meters`);
 
-  // WebAssembly precision matches native accuracy!
+  // WebAssembly precision matches native accuracy
 
   // Clean up WASM memory
   earth.free();
@@ -157,7 +160,7 @@ const inner = v1.inner_product(v2);
 Tropical algebra replaces addition with max and multiplication with addition, useful for optimization:
 
 ```typescript
-import { tropical_add, tropical_multiply } from '@amari/core';
+import { tropical_add, tropical_multiply } from '@justinelliottcobb/amari-wasm';
 
 // Tropical operations: add = max, multiply = add
 const a = 5.0, b = 3.0;
@@ -185,12 +188,13 @@ console.log(`Generation: ${ca.generation()}`);
 
 ## Use Cases
 
-- **Computer Graphics**: 3D rotations and transformations using rotors
-- **Physics Simulations**: Geometric algebra for electromagnetic fields
-- **Machine Learning**: Tropical neural networks and automatic differentiation
-- **Optimization**: Tropical algebra for shortest path and scheduling problems
-- **Scientific Computing**: High-performance mathematical operations
-- **Game Development**: Efficient spatial transformations and physics
+- Computer Graphics: 3D rotations and transformations using rotors
+- Physics Simulations: Geometric algebra for electromagnetic fields and relativistic calculations
+- Machine Learning: Tropical neural networks and automatic differentiation
+- Optimization: Tropical algebra for shortest path and scheduling problems
+- Scientific Computing: High-performance mathematical operations with orbital-grade precision
+- Game Development: Efficient spatial transformations and physics
+- Spacecraft Trajectory Planning: High-precision orbital mechanics in web applications
 
 ## API Reference
 
@@ -216,7 +220,7 @@ console.log(`Generation: ${ca.generation()}`);
 - `tropical_multiply(a, b)`: Tropical multiplication (addition)
 - `tropical_power(base, exp)`: Tropical exponentiation
 
-## 🔍 Examples
+## Examples
 
 Check out the [examples directory](https://github.com/justinelliottcobb/Amari/tree/master/examples) for more detailed usage:
 
@@ -225,7 +229,7 @@ Check out the [examples directory](https://github.com/justinelliottcobb/Amari/tr
 - [Tropical Neural Networks](https://github.com/justinelliottcobb/Amari/blob/master/examples/typescript/tropical.ts)
 - [Cellular Automata](https://github.com/justinelliottcobb/Amari/blob/master/examples/typescript/cellular.ts)
 
-## 🏗️ Building from Source
+## Building from Source
 
 ```bash
 # Clone the repository
@@ -242,25 +246,25 @@ npm run build
 npm test
 ```
 
-## 🤝 Contributing
+## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request. See [CONTRIBUTING.md](https://github.com/justinelliottcobb/Amari/blob/master/CONTRIBUTING.md) for details.
+Contributions are welcome. Please see [CONTRIBUTING.md](https://github.com/justinelliottcobb/Amari/blob/master/CONTRIBUTING.md) for details.
 
-## 📄 License
+## License
 
 MIT License - see [LICENSE](https://github.com/justinelliottcobb/Amari/blob/master/LICENSE) for details.
 
-## 🙏 Acknowledgments
+## Acknowledgments
 
 - Built with Rust and wasm-bindgen
 - Inspired by geometric algebra libraries like GAViewer and Ganja.js
 - Tropical algebra concepts from discrete mathematics
 
-## 📬 Contact
+## Contact
 
 - GitHub: [@justinelliottcobb](https://github.com/justinelliottcobb)
-- NPM: [@amari/core](https://www.npmjs.com/package/@amari/core)
+- NPM: [@justinelliottcobb/amari-wasm](https://www.npmjs.com/package/@justinelliottcobb/amari-wasm)
 
 ---
 
-**Made with Rust by the Amari team**
+Made with Rust by the Amari team

package/amari_wasm.d.ts

@@ -8,14 +8,14 @@ export function initEnumerative(): void;
  * Validate that this module loaded correctly
  */
 export function validate_relativistic_module(): boolean;
-/**
- * Calculate light deflection angle for photon grazing massive object
- */
-export function light_deflection_angle(impact_parameter: number, mass: number): number;
 /**
  * Convert velocity to Lorentz factor
  */
 export function velocity_to_gamma(velocity_magnitude: number): number;
+/**
+ * Calculate light deflection angle for photon grazing massive object
+ */
+export function light_deflection_angle(impact_parameter: number, mass: number): number;
 /**
  * Convert Lorentz factor to velocity
  */
@@ -899,6 +899,33 @@ export class WasmGeometricNetwork {
    */
   numNodes(): number;
 }
+/**
+ * GPU-accelerated optimization wrapper for WASM
+ */
+export class WasmGpuOptimizer {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Initialize GPU context for optimization
+   */
+  initializeGpu(): Promise<boolean>;
+  /**
+   * Batch optimization with parallel processing simulation
+   */
+  optimizeBatch(problems_data: Float64Array, problem_size: number, num_problems: number, max_iterations: number, tolerance: number): Promise<Float64Array>;
+  /**
+   * Check if GPU acceleration is available
+   */
+  isGpuAvailable(): boolean;
+  /**
+   * Optimize a quadratic function with GPU acceleration
+   */
+  optimizeQuadraticGpu(coefficients: Float64Array, initial_point: Float64Array, max_iterations: number, tolerance: number): Promise<WasmOptimizationResult>;
+  /**
+   * Create a new GPU optimizer
+   */
+  constructor();
+}
 /**
  * WASM wrapper for Grassmannian varieties
  */
@@ -1020,6 +1047,42 @@ export class WasmMultiDualNumber {
    */
   static variable(value: number, num_vars: number, var_index: number): WasmMultiDualNumber;
 }
+/**
+ * Simple multi-objective optimizer for WASM
+ */
+export class WasmMultiObjectiveOptimizer {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Optimize a simple bi-objective problem
+   * f1 = sum(x_i^2), f2 = sum((x_i - 1)^2)
+   */
+  optimizeBiObjective(dimension: number, population_size: number, generations: number): WasmMultiObjectiveResult;
+  /**
+   * Create a new multi-objective optimizer
+   */
+  constructor();
+}
+/**
+ * Multi-objective optimization result
+ */
+export class WasmMultiObjectiveResult {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Get number of generations
+   */
+  readonly generations: number;
+  /**
+   * Get Pareto front as flattened array
+   */
+  readonly pareto_front: Float64Array;
+  /**
+   * Check if optimization converged
+   */
+  readonly converged: boolean;
+}
 /**
  * WASM wrapper for Multivector with TypedArray support
  */
@@ -1142,6 +1205,46 @@ export class WasmNodeMetadata {
    */
   set label(value: string | null | undefined);
 }
+/**
+ * WASM wrapper for optimization results
+ */
+export class WasmOptimizationResult {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Get number of iterations
+   */
+  readonly iterations: number;
+  /**
+   * Get final objective value
+   */
+  readonly objective_value: number;
+  /**
+   * Get solution vector
+   */
+  readonly solution: Float64Array;
+  /**
+   * Check if optimization converged
+   */
+  readonly converged: boolean;
+}
+/**
+ * Utility functions for optimization
+ */
+export class WasmOptimizationUtils {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Compute numerical gradient
+   */
+  static numericalGradient(coefficients: Float64Array, point: Float64Array, epsilon: number): Float64Array;
+  /**
+   * Check if a point dominates another in multi-objective optimization
+   */
+  static dominates(objectives1: Float64Array, objectives2: Float64Array): boolean;
+}
 /**
  * WASM wrapper for projective spaces
  */
@@ -1363,6 +1466,21 @@ export class WasmSensitivityMap {
    */
   getTotalSensitivity(): number;
 }
+/**
+ * Simple quadratic optimization problem for WASM demonstration
+ */
+export class WasmSimpleOptimizer {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Optimize a simple quadratic function: minimize sum(c_i * x_i^2)
+   */
+  optimizeQuadratic(coefficients: Float64Array, initial_point: Float64Array): WasmOptimizationResult;
+  /**
+   * Create a new simple optimizer
+   */
+  constructor();
+}
 /**
  * WASM wrapper for spacetime vectors
  */
@@ -1748,6 +1866,7 @@ export interface InitOutput {
   readonly __wbg_wasmmultidualnumber_free: (a: number, b: number) => void;
   readonly __wbg_wasmmultivector_free: (a: number, b: number) => void;
   readonly __wbg_wasmnodemetadata_free: (a: number, b: number) => void;
+  readonly __wbg_wasmoptimizationresult_free: (a: number, b: number) => void;
   readonly __wbg_wasmprojectivespace_free: (a: number, b: number) => void;
   readonly __wbg_wasmpropagationanalysis_free: (a: number, b: number) => void;
   readonly __wbg_wasmrelativisticparticle_free: (a: number, b: number) => void;
@@ -1927,6 +2046,11 @@ export interface InitOutput {
   readonly wasmgeometricnetwork_spectralClustering: (a: number, b: number) => [number, number, number];
   readonly wasmgeometricnetwork_toTropicalNetwork: (a: number) => [number, number, number];
   readonly wasmgeometricnetwork_withCapacity: (a: number, b: number) => number;
+  readonly wasmgpuoptimizer_initializeGpu: (a: number) => any;
+  readonly wasmgpuoptimizer_isGpuAvailable: (a: number) => number;
+  readonly wasmgpuoptimizer_new: () => number;
+  readonly wasmgpuoptimizer_optimizeBatch: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => any;
+  readonly wasmgpuoptimizer_optimizeQuadraticGpu: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => any;
   readonly wasmgrassmannian_getDimension: (a: number) => number;
   readonly wasmgrassmannian_getParameters: (a: number) => [number, number];
   readonly wasmgrassmannian_new: (a: number, b: number) => [number, number, number];
@@ -1949,6 +2073,10 @@ export interface InitOutput {
   readonly wasmmultidualnumber_new: (a: number, b: number, c: number) => number;
   readonly wasmmultidualnumber_sqrt: (a: number) => [number, number, number];
   readonly wasmmultidualnumber_variable: (a: number, b: number, c: number) => number;
+  readonly wasmmultiobjectiveoptimizer_optimizeBiObjective: (a: number, b: number, c: number, d: number) => [number, number, number];
+  readonly wasmmultiobjectiveresult_converged: (a: number) => number;
+  readonly wasmmultiobjectiveresult_generations: (a: number) => number;
+  readonly wasmmultiobjectiveresult_pareto_front: (a: number) => [number, number];
   readonly wasmmultivector_add: (a: number, b: number) => number;
   readonly wasmmultivector_basisVector: (a: number) => [number, number, number];
   readonly wasmmultivector_exp: (a: number) => number;
@@ -1975,10 +2103,14 @@ export interface InitOutput {
   readonly wasmnodemetadata_setProperty: (a: number, b: number, c: number, d: number) => void;
   readonly wasmnodemetadata_set_label: (a: number, b: number, c: number) => void;
   readonly wasmnodemetadata_withLabel: (a: number, b: number) => number;
+  readonly wasmoptimizationresult_converged: (a: number) => number;
+  readonly wasmoptimizationresult_iterations: (a: number) => number;
+  readonly wasmoptimizationresult_solution: (a: number) => [number, number];
+  readonly wasmoptimizationutils_dominates: (a: number, b: number, c: number, d: number) => number;
+  readonly wasmoptimizationutils_numericalGradient: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
   readonly wasmprojectivespace_bezoutIntersection: (a: number, b: number, c: number) => number;
   readonly wasmprojectivespace_hasDimension: (a: number, b: number) => number;
   readonly wasmprojectivespace_new: (a: number) => number;
-  readonly wasmpropagationanalysis_convergence_time: (a: number) => number;
   readonly wasmpropagationanalysis_coverage: (a: number) => [number, number];
   readonly wasmpropagationanalysis_influence_scores: (a: number) => [number, number];
   readonly wasmrelativisticconstants_earth_mass: () => number;
@@ -2012,6 +2144,7 @@ export interface InitOutput {
   readonly wasmsensitivitymap_getAllSensitivities: (a: number) => [number, number, number];
   readonly wasmsensitivitymap_getMostSensitive: (a: number, b: number) => [number, number];
   readonly wasmsensitivitymap_getTotalSensitivity: (a: number) => number;
+  readonly wasmsimpleoptimizer_optimizeQuadratic: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
   readonly wasmspacetimevector_is_null: (a: number) => number;
   readonly wasmspacetimevector_is_spacelike: (a: number) => number;
   readonly wasmspacetimevector_is_timelike: (a: number) => number;
@@ -2051,7 +2184,6 @@ export interface InitOutput {
   readonly wasmtropicaldualdistribution_mostLikelySequence: (a: number, b: number) => [number, number];
   readonly wasmtropicaldualdistribution_new: (a: number, b: number) => number;
   readonly wasmtropicalnetwork_fromWeights: (a: number, b: number, c: number) => [number, number, number];
-  readonly wasmtropicalnetwork_getSize: (a: number) => number;
   readonly wasmtropicalnetwork_new: (a: number) => number;
   readonly wasmtropicalnetwork_setEdge: (a: number, b: number, c: number, d: number) => [number, number];
   readonly wasmtropicalnetwork_shortestPathTropical: (a: number, b: number, c: number) => [number, number, number];
@@ -2067,7 +2199,6 @@ export interface InitOutput {
   readonly wasmtropicalnumber_toProb: (a: number) => number;
   readonly wasmtropicalnumber_tropicalPow: (a: number, b: number) => number;
   readonly wasmtropicalnumber_zero: () => number;
-  readonly wasmtropicalpolynomial_coefficients_count: (a: number) => number;
   readonly wasmtropicalpolynomial_evaluate: (a: number, b: number) => number;
   readonly wasmtropicalpolynomial_new: (a: number, b: number) => number;
   readonly wasmtropicalpolynomial_tropical_roots: (a: number) => any;
@@ -2079,6 +2210,7 @@ export interface InitOutput {
   readonly wasmspacetimevector_t: (a: number) => number;
   readonly wasmtropicalnumber_tropicalMul: (a: number, b: number) => number;
   readonly wasmtrajectorypoint_position: (a: number) => number;
+  readonly wasmtropicalpolynomial_coefficients_count: (a: number) => number;
   readonly wasmtropicalnumber_tropicalAdd: (a: number, b: number) => number;
   readonly wasmcommunity_cohesion_score: (a: number) => number;
   readonly wasmdualnumber_getReal: (a: number) => number;
@@ -2086,12 +2218,15 @@ export interface InitOutput {
   readonly wasmevaluationresult_getGradientNorm: (a: number) => number;
   readonly wasmgeometricedge_weight: (a: number) => number;
   readonly wasmmultidualnumber_getReal: (a: number) => number;
+  readonly wasmoptimizationresult_objective_value: (a: number) => number;
   readonly wasmprojectivespace_getDimension: (a: number) => number;
+  readonly wasmpropagationanalysis_convergence_time: (a: number) => number;
   readonly wasmschwarzschildmetric_mass: (a: number) => number;
   readonly wasmspacetimevector_x: (a: number) => number;
   readonly wasmspacetimevector_y: (a: number) => number;
   readonly wasmspacetimevector_z: (a: number) => number;
   readonly wasmtropicalcurve_getGenus: (a: number) => number;
+  readonly wasmtropicalnetwork_getSize: (a: number) => number;
   readonly wasmtropicalnumber_getValue: (a: number) => number;
   readonly __wbg_automatabatchoperations_free: (a: number, b: number) => void;
   readonly __wbg_automatautils_free: (a: number, b: number) => void;
@@ -2110,18 +2245,28 @@ export interface InitOutput {
   readonly __wbg_wasmdualnumber_free: (a: number, b: number) => void;
   readonly __wbg_wasmfourvelocity_free: (a: number, b: number) => void;
   readonly __wbg_wasmgeometricedge_free: (a: number, b: number) => void;
+  readonly __wbg_wasmgpuoptimizer_free: (a: number, b: number) => void;
+  readonly __wbg_wasmmultiobjectiveoptimizer_free: (a: number, b: number) => void;
+  readonly __wbg_wasmoptimizationutils_free: (a: number, b: number) => void;
   readonly __wbg_wasmrelativisticconstants_free: (a: number, b: number) => void;
+  readonly __wbg_wasmsimpleoptimizer_free: (a: number, b: number) => void;
   readonly __wbg_wasmspacetimevector_free: (a: number, b: number) => void;
   readonly __wbg_wasmtropicalcurve_free: (a: number, b: number) => void;
   readonly __wbg_wasmtropicalnumber_free: (a: number, b: number) => void;
+  readonly __wbg_wasmmultiobjectiveresult_free: (a: number, b: number) => void;
   readonly wasmrotor_inverse: (a: number) => number;
   readonly __wbg_wasmrotor_free: (a: number, b: number) => void;
+  readonly wasmmultiobjectiveoptimizer_new: () => number;
+  readonly wasmsimpleoptimizer_new: () => number;
+  readonly wasm_bindgen__convert__closures_____invoke__h79d0d9c6410c14e7: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h1dd832fb828dedcc: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h0bb870c532b1b216: (a: number, b: number, c: any, d: any) => void;
+  readonly __wbindgen_malloc: (a: number, b: number) => number;
+  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_exn_store: (a: number) => void;
   readonly __externref_table_alloc: () => number;
-  readonly __wbindgen_export_2: WebAssembly.Table;
+  readonly __wbindgen_externrefs: WebAssembly.Table;
   readonly __wbindgen_free: (a: number, b: number, c: number) => void;
-  readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
   readonly __externref_table_dealloc: (a: number) => void;
   readonly __wbindgen_start: () => void;
 }