@jetta/cargo-stabilizer 0.1.0-10

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

@@ -0,0 +1,13 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { LooseItemRef } from '../filters/loose_item_filter.js';
+import type { WaypointMode, WaypointZone } from '../waypoint/WaypointMode.js';
+import type { MilkrunReservedBand } from '../waypoint/milkrun_wall_reservation.js';
+export interface CandidateGenerationContext {
+    containers: StabilizerContainer[];
+    loose: LooseItemRef;
+    mode: WaypointMode;
+    zones: WaypointZone[];
+    preserve_tie_block_organization: boolean;
+    milkrun_reserved_z_bands: MilkrunReservedBand[];
+}
+//# sourceMappingURL=candidate_context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidate_context.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/candidate_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAElF,MAAM,WAAW,0BAA0B;IAEvC,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,+BAA+B,EAAE,OAAO,CAAA;IACxC,wBAAwB,EAAE,mBAAmB,EAAE,CAAA;CAClD"}

package/build/core/candidates/candidate_context.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,9 @@
+import type { MoveCandidate } from '../move/apply_move.js';
+import type { CandidateGenerationContext } from './candidate_context.js';
+/**
+ * Generates ranked candidate slots from empty-space regions and supporter tops.
+ * @param context - Candidate generation context.
+ * @returns Candidate moves sorted floor-first, same container preferred.
+ */
+export declare function generate_candidates(context: CandidateGenerationContext): MoveCandidate[];
+//# sourceMappingURL=candidate_generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidate_generator.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/candidate_generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAKxE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,EAAE,CAMxF"}

package/build/core/candidates/candidate_generator.js

@@ -0,0 +1,42 @@
+import { collect_container_slots } from './collect_container_slots.js';
+import { is_candidate_valid } from './candidate_validation.js';
+import { rank_candidates } from './rank_candidates.js';
+/**
+ * Generates ranked candidate slots from empty-space regions and supporter tops.
+ * @param context - Candidate generation context.
+ * @returns Candidate moves sorted floor-first, same container preferred.
+ */
+export function generate_candidates(context) {
+    const candidates = context.containers.flatMap((container, target_index) => build_container_candidates(context, container, target_index));
+    return rank_candidates(candidates, context.loose.container_index);
+}
+function build_container_candidates(context, container, target_index) {
+    const candidates = [];
+    for (const tagged of collect_container_slots(container, context.loose.item, context.loose.item_id)) {
+        if (!is_candidate_valid(context, target_index, tagged.position)) {
+            continue;
+        }
+        candidates.push({
+            item_id: context.loose.item_id,
+            source_container_index: context.loose.container_index,
+            target_container_index: target_index,
+            new_position: tagged.position,
+            slot_kind: tagged.slot_kind
+        });
+    }
+    return unique_kind_positions(candidates);
+}
+function unique_kind_positions(candidates) {
+    const seen = new Set();
+    const unique = [];
+    for (const candidate of candidates) {
+        const position = candidate.new_position;
+        const key = `${position.x}:${position.y}:${position.z}:${candidate.target_container_index}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(candidate);
+    }
+    return unique;
+}

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

@@ -0,0 +1,14 @@
+import type { CandidateGenerationContext } from './candidate_context.js';
+/**
+ * Validates geometry and waypoint constraints for a candidate position.
+ * @param context - Candidate generation context.
+ * @param target_index - Target container index.
+ * @param position - Candidate position.
+ * @returns True when candidate is valid.
+ */
+export declare function is_candidate_valid(context: CandidateGenerationContext, target_index: number, position: {
+    x: number;
+    y: number;
+    z: number;
+}): boolean;
+//# sourceMappingURL=candidate_validation.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,72 @@
+import { collect_container_boxes } from '../adapters/coordinate_mapper.js';
+import { has_overlap, is_fully_supported, is_inside_container } from '../geometry/box_geometry.js';
+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.
+ * @param target_index - Target container index.
+ * @param position - Candidate position.
+ * @returns True when candidate is valid.
+ */
+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;
+    }
+    return is_candidate_waypoint_valid(context, target_index, position);
+}
+function is_candidate_milkrun_valid(context, target_index, position) {
+    if (context.milkrun_reserved_z_bands.length === 0) {
+        return true;
+    }
+    return !is_position_in_milkrun_reserved_band({
+        bands: context.milkrun_reserved_z_bands,
+        container_index: target_index,
+        item: context.loose.item,
+        position
+    });
+}
+function is_candidate_geometry_valid(context, target_index, position) {
+    const candidate_box = build_candidate_box(context, position);
+    const target = context.containers[target_index];
+    const boxes = collect_container_boxes(target, context.loose.item_id);
+    return is_valid_candidate_box(candidate_box, target, boxes);
+}
+function build_candidate_box(context, position) {
+    return {
+        x: position.x,
+        y: position.y,
+        z: position.z,
+        w: context.loose.item.width,
+        h: context.loose.item.height,
+        d: context.loose.item.depth
+    };
+}
+function is_valid_candidate_box(candidate_box, target, boxes) {
+    if (!is_inside_container(candidate_box, target)) {
+        return false;
+    }
+    if (!is_fully_supported(candidate_box, boxes)) {
+        return false;
+    }
+    return !has_overlap(candidate_box, boxes);
+}
+function is_candidate_waypoint_valid(context, target_index, position) {
+    if (context.mode.kind === 'SINGLE_WAYPOINT' || !context.preserve_tie_block_organization) {
+        return true;
+    }
+    const waypoint_id = resolve_item_waypoint_id(context.loose.item, context.mode);
+    const zone = context.zones.find(entry => entry.waypoint_id === waypoint_id && entry.container_index === target_index);
+    if (!zone) {
+        return false;
+    }
+    return is_position_in_zone(zone, context.loose.item, position);
+}

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

@@ -0,0 +1,16 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { CandidateSlotKind } from '../move/apply_move.js';
+import type { EmptySpaceSlot } from './enumerate_empty_space_slots.js';
+export interface TaggedSlot {
+    position: EmptySpaceSlot;
+    slot_kind: CandidateSlotKind;
+}
+/**
+ * Collects empty-space origins and per-supporter top origins, supporter first.
+ * @param container - Target container layout.
+ * @param item - Loose item to place.
+ * @param exclude_item_id - Loose item id omitted from obstacles and supporters.
+ * @returns Tagged slots with supporter-top entries before empty-space entries.
+ */
+export declare function collect_container_slots(container: StabilizerContainer, item: StabilizerContainer['items'][number], exclude_item_id: string): TaggedSlot[];
+//# sourceMappingURL=collect_container_slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect_container_slots.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/collect_container_slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAItE,MAAM,WAAW,UAAU;IAEvB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,iBAAiB,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAC1C,eAAe,EAAE,MAAM,GACxB,UAAU,EAAE,CAQd"}

package/build/core/candidates/collect_container_slots.js

@@ -0,0 +1,20 @@
+import { enumerate_empty_space_slots } from './enumerate_empty_space_slots.js';
+import { enumerate_supporter_top_slots } from './enumerate_supporter_top_slots.js';
+/**
+ * Collects empty-space origins and per-supporter top origins, supporter first.
+ * @param container - Target container layout.
+ * @param item - Loose item to place.
+ * @param exclude_item_id - Loose item id omitted from obstacles and supporters.
+ * @returns Tagged slots with supporter-top entries before empty-space entries.
+ */
+export function collect_container_slots(container, item, exclude_item_id) {
+    const supporter = enumerate_supporter_top_slots(container, item, exclude_item_id);
+    const empty = enumerate_empty_space_slots(container, item, exclude_item_id);
+    return [
+        ...tag_slots(supporter, 'supporter_top'),
+        ...tag_slots(empty, 'empty_space')
+    ];
+}
+function tag_slots(slots, slot_kind) {
+    return slots.map(position => ({ position, slot_kind }));
+}

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

@@ -0,0 +1,15 @@
+import type { StabilizerContainer, StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+export interface EmptySpaceSlot {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Enumerates candidate positions from empty-space regions where the item fits.
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Item id to omit from obstacle list.
+ * @returns Slot positions at each fitting empty-space origin.
+ */
+export declare function enumerate_empty_space_slots(container: StabilizerContainer, item: StabilizerItem, exclude_item_id: string): EmptySpaceSlot[];
+//# sourceMappingURL=enumerate_empty_space_slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate_empty_space_slots.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/enumerate_empty_space_slots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAG7G,MAAM,WAAW,cAAc;IAE3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,MAAM,GACxB,cAAc,EAAE,CAmBlB"}

package/build/core/candidates/enumerate_empty_space_slots.js

@@ -0,0 +1,44 @@
+import { find_empty_spaces_in_container } from '../adapters/empty_space_adapter.js';
+/**
+ * Enumerates candidate positions from empty-space regions where the item fits.
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Item id to omit from obstacle list.
+ * @returns Slot positions at each fitting empty-space origin.
+ */
+export function enumerate_empty_space_slots(container, item, exclude_item_id) {
+    const spaces = find_empty_spaces_in_container(container, exclude_item_id);
+    const slots = [];
+    for (const space of spaces) {
+        if (!space_fits_item(space, item)) {
+            continue;
+        }
+        slots.push({
+            x: space.get_x(),
+            y: space.get_y(),
+            z: space.get_z()
+        });
+    }
+    return dedupe_slots(slots);
+}
+function space_fits_item(space, item) {
+    return space.get_width() >= item.width - 1e-6 &&
+        space.get_height() >= item.height - 1e-6 &&
+        space.get_length() >= item.depth - 1e-6;
+}
+function dedupe_slots(slots) {
+    const seen = new Set();
+    const unique = [];
+    for (const slot of slots) {
+        const key = `${round_coord(slot.x)}:${round_coord(slot.y)}:${round_coord(slot.z)}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(slot);
+    }
+    return unique;
+}
+function round_coord(value) {
+    return Math.round(value * 1000) / 1000;
+}

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

@@ -0,0 +1,11 @@
+import type { StabilizerContainer, StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+import type { EmptySpaceSlot } from './enumerate_empty_space_slots.js';
+/**
+ * Emits one candidate origin per supporter footprint (x, supporter top y, z).
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Loose item id omitted as a supporter.
+ * @returns Slot positions aligned to each supporter origin.
+ */
+export declare function enumerate_supporter_top_slots(container: StabilizerContainer, item: StabilizerItem, exclude_item_id: string): EmptySpaceSlot[];
+//# sourceMappingURL=enumerate_supporter_top_slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enumerate_supporter_top_slots.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/enumerate_supporter_top_slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAC7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAItE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CACzC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,MAAM,GACxB,cAAc,EAAE,CAgBlB"}

package/build/core/candidates/enumerate_supporter_top_slots.js

@@ -0,0 +1,36 @@
+const CONTAINER_EPSILON = 1e-6;
+/**
+ * Emits one candidate origin per supporter footprint (x, supporter top y, z).
+ * @param container - Target container layout.
+ * @param item - Loose item dimensions.
+ * @param exclude_item_id - Loose item id omitted as a supporter.
+ * @returns Slot positions aligned to each supporter origin.
+ */
+export function enumerate_supporter_top_slots(container, item, exclude_item_id) {
+    const slots = [];
+    for (const supporter of container.items) {
+        if (supporter.item_id === exclude_item_id) {
+            continue;
+        }
+        const slot = supporter_top_slot(supporter);
+        if (slot_fits_in_container(container, item, slot)) {
+            slots.push(slot);
+        }
+    }
+    return slots;
+}
+function supporter_top_slot(supporter) {
+    return {
+        x: supporter.x,
+        y: supporter.y + supporter.height,
+        z: supporter.z
+    };
+}
+function slot_fits_in_container(container, item, slot) {
+    return slot.x >= -CONTAINER_EPSILON &&
+        slot.y >= -CONTAINER_EPSILON &&
+        slot.z >= -CONTAINER_EPSILON &&
+        slot.x + item.width <= container.width + CONTAINER_EPSILON &&
+        slot.y + item.height <= container.height + CONTAINER_EPSILON &&
+        slot.z + item.depth <= container.length + CONTAINER_EPSILON;
+}

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/build/core/candidates/rank_candidates.d.ts

@@ -0,0 +1,9 @@
+import type { MoveCandidate } from '../move/apply_move.js';
+/**
+ * Ranks candidates floor-first with same-container preference.
+ * @param candidates - Unsorted candidates.
+ * @param source_index - Source container index.
+ * @returns Sorted candidates.
+ */
+export declare function rank_candidates(candidates: MoveCandidate[], source_index: number): MoveCandidate[];
+//# sourceMappingURL=rank_candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rank_candidates.d.ts","sourceRoot":"","sources":["../../../src/core/candidates/rank_candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBlG"}

package/build/core/candidates/rank_candidates.js

@@ -0,0 +1,22 @@
+/**
+ * Ranks candidates floor-first with same-container preference.
+ * @param candidates - Unsorted candidates.
+ * @param source_index - Source container index.
+ * @returns Sorted candidates.
+ */
+export function rank_candidates(candidates, source_index) {
+    return candidates.sort((left, right) => {
+        if (left.new_position.y !== right.new_position.y) {
+            return left.new_position.y - right.new_position.y;
+        }
+        const same_left = left.target_container_index === source_index ? 0 : 1;
+        const same_right = right.target_container_index === source_index ? 0 : 1;
+        if (same_left !== same_right) {
+            return same_left - same_right;
+        }
+        if (left.new_position.z !== right.new_position.z) {
+            return left.new_position.z - right.new_position.z;
+        }
+        return left.new_position.x - right.new_position.x;
+    });
+}

package/build/core/constants/ReorderStrategy.d.ts

@@ -0,0 +1,11 @@
+export declare const REORDER_STRATEGY: Readonly<{
+    readonly GREEDY: "greedy";
+    readonly GENETIC: "genetic";
+    readonly GRAVITY: "gravity";
+    readonly SIMULATED_ANNEALING: "simulated_annealing";
+    readonly BEAM_SEARCH: "beam_search";
+}>;
+export type ReorderStrategyValue = typeof REORDER_STRATEGY[keyof typeof REORDER_STRATEGY];
+export declare const REORDER_STRATEGY_VALUES: readonly ReorderStrategyValue[];
+export declare const DEFAULT_SYNTHETIC_WAYPOINT_ID = "__default__";
+//# sourceMappingURL=ReorderStrategy.d.ts.map

package/build/core/constants/ReorderStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReorderStrategy.d.ts","sourceRoot":"","sources":["../../../src/core/constants/ReorderStrategy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;EAMlB,CAAA;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA;AAEzF,eAAO,MAAM,uBAAuB,iCAEnC,CAAA;AAED,eAAO,MAAM,6BAA6B,gBAAgB,CAAA"}

package/build/core/constants/ReorderStrategy.js

@@ -0,0 +1,9 @@
+export const REORDER_STRATEGY = Object.freeze({
+    GREEDY: 'greedy',
+    GENETIC: 'genetic',
+    GRAVITY: 'gravity',
+    SIMULATED_ANNEALING: 'simulated_annealing',
+    BEAM_SEARCH: 'beam_search'
+});
+export const REORDER_STRATEGY_VALUES = Object.freeze(Object.values(REORDER_STRATEGY));
+export const DEFAULT_SYNTHETIC_WAYPOINT_ID = '__default__';

package/build/core/constants/TieRatioOrientation.d.ts

@@ -0,0 +1,6 @@
+export declare const TIE_RATIO_ORIENTATION: Readonly<{
+    THREE_TWO: "3_2";
+    TWO_THREE: "2_3";
+}>;
+export declare const TIE_RATIO_ORIENTATION_VALUES: readonly ("3_2" | "2_3")[];
+//# sourceMappingURL=TieRatioOrientation.d.ts.map

package/build/core/constants/TieRatioOrientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TieRatioOrientation.d.ts","sourceRoot":"","sources":["../../../src/core/constants/TieRatioOrientation.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;EAGhC,CAAA;AAEF,eAAO,MAAM,4BAA4B,4BAExC,CAAA"}

package/build/core/constants/TieRatioOrientation.js

@@ -0,0 +1,5 @@
+export const TIE_RATIO_ORIENTATION = Object.freeze({
+    THREE_TWO: '3_2',
+    TWO_THREE: '2_3'
+});
+export const TIE_RATIO_ORIENTATION_VALUES = Object.freeze(Object.values(TIE_RATIO_ORIENTATION));

package/build/core/evaluation/compute_reorder_objective.d.ts

@@ -0,0 +1,13 @@
+import { type StabilityEvaluation } from '../adapters/stability_adapter.js';
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { LooseItemRef } from '../filters/loose_item_filter.js';
+export declare const LOOSE_SUM_TIE_BREAK_SCALE = 0.000001;
+/**
+ * Computes the reorder objective: maximize transport stability, then loose-item sum.
+ * @param stability - Transport stability evaluation.
+ * @param containers - Container layout used for loose-item index lookup.
+ * @param loose_items - Loose items included in the tie-break term.
+ * @returns Scalar objective; higher is better.
+ */
+export declare function compute_reorder_objective(stability: StabilityEvaluation, containers: StabilizerContainer[], loose_items: LooseItemRef[]): number;
+//# sourceMappingURL=compute_reorder_objective.d.ts.map

package/build/core/evaluation/compute_reorder_objective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute_reorder_objective.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/compute_reorder_objective.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEnE,eAAO,MAAM,yBAAyB,WAAO,CAAA;AAE7C;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,EAAE,YAAY,EAAE,GAC5B,MAAM,CAIR"}

package/build/core/evaluation/compute_reorder_objective.js

@@ -0,0 +1,13 @@
+import { sum_loose_item_scores } from '../adapters/stability_adapter.js';
+export const LOOSE_SUM_TIE_BREAK_SCALE = 1e-6;
+/**
+ * Computes the reorder objective: maximize transport stability, then loose-item sum.
+ * @param stability - Transport stability evaluation.
+ * @param containers - Container layout used for loose-item index lookup.
+ * @param loose_items - Loose items included in the tie-break term.
+ * @returns Scalar objective; higher is better.
+ */
+export function compute_reorder_objective(stability, containers, loose_items) {
+    const loose_sum = sum_loose_item_scores(stability, containers, loose_items);
+    return stability.transport_score + loose_sum * LOOSE_SUM_TIE_BREAK_SCALE;
+}

package/build/core/evaluation/evaluation_context.d.ts

@@ -0,0 +1,14 @@
+import type { StabilizerContainer, StabilizerEnv } from '../validation/contract/stabilizer_domain_schema.js';
+import type { StabilizerConfig } from '../validation/schemas/stabilizer_config_schema.js';
+import type { LooseItemRef } from '../filters/loose_item_filter.js';
+import type { WaypointMode } from '../waypoint/WaypointMode.js';
+import type { MilkrunReservedBand } from '../waypoint/milkrun_wall_reservation.js';
+export interface StateEvaluationContext {
+    env: StabilizerEnv;
+    loose_items: LooseItemRef[];
+    config: StabilizerConfig;
+    waypoint_mode: WaypointMode;
+    baseline_containers: StabilizerContainer[];
+    milkrun_reserved_z_bands: MilkrunReservedBand[];
+}
+//# sourceMappingURL=evaluation_context.d.ts.map

package/build/core/evaluation/evaluation_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation_context.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/evaluation_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAA;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAA;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAElF,MAAM,WAAW,sBAAsB;IAEnC,GAAG,EAAE,aAAa,CAAA;IAClB,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,MAAM,EAAE,gBAAgB,CAAA;IACxB,aAAa,EAAE,YAAY,CAAA;IAC3B,mBAAmB,EAAE,mBAAmB,EAAE,CAAA;IAC1C,wBAAwB,EAAE,mBAAmB,EAAE,CAAA;CAClD"}

package/build/core/evaluation/evaluation_context.js

@@ -0,0 +1 @@
+export {};

package/build/core/evaluation/state_evaluator.d.ts

@@ -0,0 +1,50 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import { type StabilityEvaluation } from '../adapters/stability_adapter.js';
+import type { StateEvaluationContext } from './evaluation_context.js';
+import type { ReorderContext } from '../strategies/reorder/ReorderStrategy.js';
+export interface EvaluationResult {
+    stability: StabilityEvaluation;
+    objective: number;
+    transport_floor_valid: boolean;
+    axle_valid: boolean;
+    waypoint_valid: boolean;
+    milkrun_valid: boolean;
+    all_gates_pass: boolean;
+}
+/**
+ * Evaluates a container layout against all stabilizer gates.
+ * @param containers - Container layout to evaluate.
+ * @param context - Evaluation context.
+ * @returns Evaluation result with gate flags.
+ */
+export declare function evaluate_state(containers: StabilizerContainer[], context: StateEvaluationContext): EvaluationResult;
+/**
+ * Evaluates a trial layout cloned from baseline with a move applied elsewhere.
+ * @param trial - Trial containers after move.
+ * @param context - Evaluation context.
+ * @returns Evaluation result.
+ */
+export declare function evaluate_trial_layout(trial: StabilizerContainer[], context: StateEvaluationContext): EvaluationResult;
+/**
+ * Builds evaluation context from reorder context.
+ * @param context - Reorder context.
+ * @returns State evaluation context.
+ */
+export declare function evaluation_context_from_reorder(context: ReorderContext): StateEvaluationContext;
+/**
+ * Clones baseline containers for safe trial mutation.
+ * @param containers - Source containers.
+ * @returns Deep clone.
+ */
+export declare function clone_baseline(containers: StabilizerContainer[]): StabilizerContainer[];
+/**
+ * Evaluates organization constraint gates without stability or axle checks.
+ * @param containers - Container layout to evaluate.
+ * @param context - Evaluation context.
+ * @returns Waypoint and milkrun gate flags.
+ */
+export declare function evaluate_organization_gates(containers: StabilizerContainer[], context: StateEvaluationContext): {
+    waypoint_valid: boolean;
+    milkrun_valid: boolean;
+};
+//# sourceMappingURL=state_evaluator.d.ts.map

package/build/core/evaluation/state_evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_evaluator.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/state_evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,EAEH,KAAK,mBAAmB,EAC3B,MAAM,kCAAkC,CAAA;AAMzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAA;AAE9E,MAAM,WAAW,gBAAgB;IAE7B,SAAS,EAAE,mBAAmB,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,sBAAsB,GAChC,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAU/F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAGvF;AAwBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,sBAAsB,GAChC;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAMrD"}