@iyulab/u-metaheur 0.4.3 → 0.5.1

package/README.md

@@ -78,10 +78,10 @@ assert!((result.best - 3.0).abs() < 0.1);
 
 ```toml
 [dependencies]
-u-metaheur = "0.4"
+u-metaheur = "0.5"
 
 # with serde support
-u-metaheur = { version = "0.4", features = ["serde"] }
+u-metaheur = { version = "0.5", features = ["serde"] }
 ```
 
 ## Build & Test
@@ -116,6 +116,11 @@ The package resolves per environment via a conditional `exports` map:
 | Bundlers (webpack, Vite, …) | ESM + WebAssembly ESM-integration (`default` condition) |
 | Node.js — `require()`, ESM `import`, CJS TS runners (`tsx`, `ts-node`) | CJS glue loading the wasm from the filesystem (`node` condition) — no loader hooks or flags |
 
+A browser **without** a bundler is not supported: the package loads its `.wasm`
+file with an ES module import, which browsers refuse (`application/wasm` is not a
+module script type), so `<script type="module">` from a CDN fails, and CDN
+re-bundling services fail on the same import. Use a bundler or Node.
+
 ### Quick Start
 
 Both functions solve a travelling-salesman tour over `nodes` (`[x, y]` pairs)
@@ -137,6 +142,28 @@ console.log(sa.best_distance, sa.iterations_run);
 `cooling_rate`. Every setting is optional except `nodes`, and a setting the
 function does not have is rejected rather than ignored.
 
+### Errors
+
+A refusal throws an `Error` whose `message` is readable text and which carries a
+`code` naming the reason, next to the values behind it:
+
+```js
+import { run_sa } from '@iyulab/u-metaheur';
+
+try {
+  run_sa({ nodes: [[0, 0], [1, 0], [1, 1]], cooling_rate: 1 });
+} catch (err) {
+  console.log(err.code, err.parameter, err.min, err.max, err.got); // parameter_out_of_range cooling_rate 0 1 1
+}
+```
+
+| `code` | Fields | Meaning |
+|---|---|---|
+| `insufficient_data` | `parameter` (`"nodes"`), `min`, `got` | Fewer than 2 nodes |
+| `parameter_out_of_range` | `parameter`, `min`, `max` (or `null`), `got` | `population_size < 2`, `generations` or `iterations` of 0, `initial_temp ≤ 0`, or `cooling_rate` outside (0, 1) — the message says whether a bound is included |
+| `value_not_finite` | `parameter`, `index` | A NaN or ±Infinity anywhere in an argument — `parameter` is the path to it (`config.nodes[1]`), `index` its position in that array, or `null` |
+| `malformed_input` | `parameter` | An argument of the wrong shape or type (a missing or unknown key), or a JSON string |
+
 ### TypeScript
 
 Every exported function declares its parameter and return types, and the

package/node/u_metaheur.cjs

@@ -99,6 +99,10 @@ function __wbg_get_imports() {
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
+        __wbg___wbindgen_is_string_90b56bc79aad6f6c: function(arg0) {
+            const ret = typeof(arg0) === 'string';
+            return ret;
+        },
         __wbg___wbindgen_jsval_eq_02babf21faa37971: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
@@ -124,6 +128,10 @@ function __wbg_get_imports() {
         __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
+        __wbg_assign_e39d243f5fbe1e2d: function(arg0, arg1) {
+            const ret = Object.assign(arg0, arg1);
+            return ret;
+        },
         __wbg_call_6137034ef55c9d0f: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
@@ -205,6 +213,14 @@ function __wbg_get_imports() {
             const ret = new Uint8Array(arg0);
             return ret;
         },
+        __wbg_new_28744009d011f847: function() {
+            const ret = new Map();
+            return ret;
+        },
+        __wbg_new_343a093a3c2ffb4e: function(arg0, arg1) {
+            const ret = new Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
         __wbg_new_617a8cdb8bb1130e: function() {
             const ret = new Object();
             return ret;
@@ -224,6 +240,10 @@ function __wbg_get_imports() {
         __wbg_prototypesetcall_bc27214492979395: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
+        __wbg_set_6ae97e73113c4f0b: function(arg0, arg1, arg2) {
+            const ret = arg0.set(arg1, arg2);
+            return ret;
+        },
         __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
             arg0[arg1] = arg2;
         },

package/package.json

@@ -5,7 +5,7 @@
     "iyulab"
   ],
   "description": "Domain-agnostic metaheuristic optimization framework: GA, BRKGA, SA, ALNS.",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "license": "MIT",
   "repository": {
     "type": "git",

package/u_metaheur_bg.js

@@ -92,6 +92,10 @@ export function __wbg___wbindgen_is_object_3c45d4f2dde4e749(arg0) {
     const ret = typeof(val) === 'object' && val !== null;
     return ret;
 }
+export function __wbg___wbindgen_is_string_90b56bc79aad6f6c(arg0) {
+    const ret = typeof(arg0) === 'string';
+    return ret;
+}
 export function __wbg___wbindgen_jsval_eq_02babf21faa37971(arg0, arg1) {
     const ret = arg0 === arg1;
     return ret;
@@ -117,6 +121,10 @@ export function __wbg___wbindgen_string_get_0380ccaa2f57f0d9(arg0, arg1) {
 export function __wbg___wbindgen_throw_41e9ee4f547fc59a(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
+export function __wbg_assign_e39d243f5fbe1e2d(arg0, arg1) {
+    const ret = Object.assign(arg0, arg1);
+    return ret;
+}
 export function __wbg_call_6137034ef55c9d0f() { return handleError(function (arg0, arg1) {
     const ret = arg0.call(arg1);
     return ret;
@@ -198,6 +206,14 @@ export function __wbg_new_1dbf7428bba60a42(arg0) {
     const ret = new Uint8Array(arg0);
     return ret;
 }
+export function __wbg_new_28744009d011f847() {
+    const ret = new Map();
+    return ret;
+}
+export function __wbg_new_343a093a3c2ffb4e(arg0, arg1) {
+    const ret = new Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
 export function __wbg_new_617a8cdb8bb1130e() {
     const ret = new Object();
     return ret;
@@ -217,6 +233,10 @@ export function __wbg_next_f4aac29c42af995c() { return handleError(function (arg
 export function __wbg_prototypesetcall_bc27214492979395(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 }
+export function __wbg_set_6ae97e73113c4f0b(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
+}
 export function __wbg_set_6be42768c690e380(arg0, arg1, arg2) {
     arg0[arg1] = arg2;
 }