@iyulab/u-nesting 0.3.5 → 0.5.0

package/README.md

@@ -139,10 +139,32 @@ interface Request2D {
     mutation_rate?: number;            // Mutation rate (default: 0.1)
     time_limit_ms?: number;            // Time limit in ms
     target_utilization?: number;       // Stop early if reached
+    multi_sheet?: boolean;             // Spill overflow onto extra sheets (default: false)
   };
 }
 ```
 
+### Multi-Sheet Nesting
+
+By default `solve_2d` packs into a **single** sheet; parts that do not fit become
+`unplaced`. Set `config.multi_sheet: true` to spill overflow onto **additional
+sheets**. Then:
+
+- `sheets_used` reports how many sheets were needed.
+- each placement's `sheet_index` selects its sheet.
+- placement `x`/`y` are **sheet-local** — relative to that sheet's own origin —
+  so you can render one panel per sheet without subtracting any offset.
+
+```javascript
+const res = JSON.parse(solve_2d(JSON.stringify({
+  geometries: [{ id: "part", polygon: [[0,0],[100,0],[100,100],[0,100]], quantity: 20 }],
+  boundary: { width: 300, height: 300 },
+  config: { strategy: "blf", multi_sheet: true }
+})));
+// res.sheets_used === 3, res.placements.length === 20, res.unplaced === []
+// group placements by sheet_index to draw each sheet
+```
+
 ### Available 2D Strategies
 
 | Strategy | Description |
@@ -180,12 +202,15 @@ interface SolveResponse {
     x: number;
     y: number;
     rotation: number;      // degrees
-    sheet_index: number;   // 0-based sheet/bin index
+    sheet_index: number;   // 0-based sheet/bin index (see config.multi_sheet)
     flipped: boolean;      // mirrored
   }[];
-  sheets_used: number;
+  sheets_used: number;     // >1 only when config.multi_sheet is true
   utilization: number;
-  unplaced: string[];
+  total_requested: number; // Σ of every geometry's quantity (instance-level).
+                           // unplaced instances = total_requested - placements.length
+  unplaced: string[];      // deduplicated geometry ids (NOT per-instance), so
+                           // unplaced.length under-reports the failed-instance count
   elapsed_ms: number;
 }
 ```
@@ -208,7 +233,10 @@ interface Pack3DResponse {
   }[];
   bins_used: number;
   utilization: number;
-  unplaced: string[];
+  total_requested: number; // Σ of every geometry's quantity (instance-level).
+                           // unplaced instances = total_requested - placements.length
+  unplaced: string[];      // deduplicated geometry ids (NOT per-instance), so
+                           // unplaced.length under-reports the failed-instance count
   elapsed_ms: number;
 }
 ```

package/package.json

@@ -5,7 +5,7 @@
     "iyulab"
   ],
   "description": "WebAssembly bindings for U-Nesting spatial optimization engine",
-  "version": "0.3.5",
+  "version": "0.5.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/u_nesting_wasm_bg.js

@@ -123,11 +123,11 @@ export function version() {
         wasm.__wbindgen_export2(deferred1_0, deferred1_1, 1);
     }
 }
-export function __wbg___wbindgen_is_undefined_67b456be8673d3d7(arg0) {
+export function __wbg___wbindgen_is_undefined_721f8decd50c87a3(arg0) {
     const ret = getObject(arg0) === undefined;
     return ret;
 }
-export function __wbg___wbindgen_throw_1506f2235d1bdba0(arg0, arg1) {
+export function __wbg___wbindgen_throw_ea4887a5f8f9a9db(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
 export function __wbg_getRandomValues_3f44b700395062e5() { return handleError(function (arg0, arg1) {
@@ -141,19 +141,19 @@ export function __wbg_performance_3fcf6e32a7e1ed0a(arg0) {
     const ret = getObject(arg0).performance;
     return addHeapObject(ret);
 }
-export function __wbg_static_accessor_GLOBAL_9d53f2689e622ca1() {
-    const ret = typeof global === 'undefined' ? null : global;
+export function __wbg_static_accessor_GLOBAL_THIS_2fee5048bcca5938() {
+    const ret = typeof globalThis === 'undefined' ? null : globalThis;
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
 }
-export function __wbg_static_accessor_GLOBAL_THIS_a1a35cec07001a8a() {
-    const ret = typeof globalThis === 'undefined' ? null : globalThis;
+export function __wbg_static_accessor_GLOBAL_ce44e66a4935da8c() {
+    const ret = typeof global === 'undefined' ? null : global;
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
 }
-export function __wbg_static_accessor_SELF_4c59f6c7ea29a144() {
+export function __wbg_static_accessor_SELF_44f6e0cb5e67cdad() {
     const ret = typeof self === 'undefined' ? null : self;
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
 }
-export function __wbg_static_accessor_WINDOW_e70ae9f2eb052253() {
+export function __wbg_static_accessor_WINDOW_168f178805d978fe() {
     const ret = typeof window === 'undefined' ? null : window;
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
 }