@jetta/cargo-stabilizer 0.1.0-8 → 0.1.0-9

package/CHANGELOG.md

@@ -12,6 +12,7 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Organization gates: waypoint Z zones, macro delivery order (`preserve_tie_block_organization`), and milkrun wall reservation (`enforce_milkrun_wall_reservation`).
 - Empty-space candidate discovery for floor and elevated slots via `@jetta/empty-spaces-manager`.
 - Supporter-top candidate slots aligned to each stacked item footprint, included in beam expansion (`top_k ∪ supporter_top`).
+- Elevated candidates must sit on a supporter `(x, z)` origin so stacked loose items copy the supporter footprint.
 - Public contract exports: `parse_stabilizer_input`, `parse_stabilizer_output`, `safe_parse_stabilizer_input`, `safe_parse_stabilizer_output`, and related domain types.
 
 ### Changed

package/build/core/candidates/candidate_validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"candidate_validation.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/candidate_validation.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAExE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,0BAA0B,EACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAWT"}
+{"version":3,"file":"candidate_validation.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/candidate_validation.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAGxE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,0BAA0B,EACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAeT"}

package/build/core/candidates/candidate_validation.js

@@ -3,6 +3,7 @@ import { has_overlap, is_fully_supported, is_inside_container } from '../geometr
 import { is_position_in_zone } from '../waypoint/build_waypoint_zones.js';
 import { is_position_in_milkrun_reserved_band } from '../waypoint/milkrun_wall_reservation.js';
 import { resolve_item_waypoint_id } from '../waypoint/validate_waypoint_ids.js';
+import { is_elevated_on_supporter_origin } from './is_elevated_on_supporter_origin.js';
 /**
  * Validates geometry and waypoint constraints for a candidate position.
  * @param context - Candidate generation context.
@@ -14,6 +15,9 @@ export function is_candidate_valid(context, target_index, position) {
     if (!is_candidate_geometry_valid(context, target_index, position)) {
         return false;
     }
+    if (!is_elevated_on_supporter_origin(context, target_index, position)) {
+        return false;
+    }
     if (!is_candidate_milkrun_valid(context, target_index, position)) {
         return false;
     }

package/build/core/candidates/is_elevated_on_supporter_origin.d.ts

@@ -0,0 +1,14 @@
+import type { CandidateGenerationContext } from './candidate_context.js';
+/**
+ * Floor candidates stay free; elevated ones must copy a supporter (x, z) origin.
+ * @param context - Candidate generation context.
+ * @param target_index - Target container index.
+ * @param position - Candidate position.
+ * @returns True when the candidate is on the floor or on a supporter origin.
+ */
+export declare function is_elevated_on_supporter_origin(context: CandidateGenerationContext, target_index: number, position: {
+    x: number;
+    y: number;
+    z: number;
+}): boolean;
+//# sourceMappingURL=is_elevated_on_supporter_origin.d.ts.map

package/build/core/candidates/is_elevated_on_supporter_origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_elevated_on_supporter_origin.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/is_elevated_on_supporter_origin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAIxE;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC3C,OAAO,EAAE,0BAA0B,EACnC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAQT"}

package/build/core/candidates/is_elevated_on_supporter_origin.js

@@ -0,0 +1,28 @@
+const ORIGIN_EPSILON = 1e-6;
+/**
+ * Floor candidates stay free; elevated ones must copy a supporter (x, z) origin.
+ * @param context - Candidate generation context.
+ * @param target_index - Target container index.
+ * @param position - Candidate position.
+ * @returns True when the candidate is on the floor or on a supporter origin.
+ */
+export function is_elevated_on_supporter_origin(context, target_index, position) {
+    if (position.y <= ORIGIN_EPSILON) {
+        return true;
+    }
+    const items = context.containers[target_index].items;
+    return items.some(item => matches_supporter_origin(item, context.loose.item_id, position));
+}
+function matches_supporter_origin(item, exclude_item_id, position) {
+    if (item.item_id === exclude_item_id) {
+        return false;
+    }
+    return is_same_origin(item, position) && is_supporter_top(item, position.y);
+}
+function is_same_origin(item, position) {
+    return Math.abs(item.x - position.x) <= ORIGIN_EPSILON
+        && Math.abs(item.z - position.z) <= ORIGIN_EPSILON;
+}
+function is_supporter_top(item, candidate_y) {
+    return Math.abs(item.y + item.height - candidate_y) <= ORIGIN_EPSILON;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jetta/cargo-stabilizer",
-    "version": "0.1.0-8",
+    "version": "0.1.0-9",
     "description": "Stable loose-item reorder library for cargo-movement (JET-2262)",
     "main": "build/index.js",
     "types": "build/index.d.ts",