@jetta/cargo-stabilizer 0.1.0-10

package/build/core/validation/contract/wire_mapper_record_utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @param value - Unknown value.
+ * @returns True when value is a plain object record.
+ */
+export declare function is_record(value: unknown): value is Record<string, unknown>;
+/**
+ * Renames object keys using a wire-to-contract map, preserving unmapped keys.
+ * @param source - Source record.
+ * @param key_map - Key rename map.
+ * @returns Record with renamed keys.
+ */
+export declare function rename_keys(source: Record<string, unknown>, key_map: Record<string, string>): Record<string, unknown>;
+/**
+ * Picks only allowed keys from a record.
+ * @param source - Source record.
+ * @param allowed_keys - Keys to retain.
+ * @returns Filtered record.
+ */
+export declare function pick_keys(source: Record<string, unknown>, allowed_keys: string[]): Record<string, unknown>;
+/**
+ * Reads the value of the first candidate key present on the record.
+ * @param source - Source record.
+ * @param candidate_keys - Candidate keys in precedence order.
+ * @returns Value of the first present key, or undefined when none is present.
+ */
+export declare function read_first_present(source: Record<string, unknown>, candidate_keys: readonly string[]): unknown;
+/**
+ * Keeps every defined key except the excluded ones.
+ * @param source - Source record.
+ * @param excluded_keys - Keys to drop.
+ * @returns Filtered record.
+ */
+export declare function omit_keys(source: Record<string, unknown>, excluded_keys: string[]): Record<string, unknown>;
+//# sourceMappingURL=wire_mapper_record_utils.d.ts.map

package/build/core/validation/contract/wire_mapper_record_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire_mapper_record_utils.d.ts","sourceRoot":"","sources":["../../../../src/core/validation/contract/wire_mapper_record_utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,SAAS,MAAM,EAAE,GAClC,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,MAAM,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/build/core/validation/contract/wire_mapper_record_utils.js

@@ -0,0 +1,66 @@
+/**
+ * @param value - Unknown value.
+ * @returns True when value is a plain object record.
+ */
+export function is_record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Renames object keys using a wire-to-contract map, preserving unmapped keys.
+ * @param source - Source record.
+ * @param key_map - Key rename map.
+ * @returns Record with renamed keys.
+ */
+export function rename_keys(source, key_map) {
+    const target = {};
+    for (const [key, value] of Object.entries(source)) {
+        const contract_key = key_map[key] ?? key;
+        target[contract_key] = value;
+    }
+    return target;
+}
+/**
+ * Picks only allowed keys from a record.
+ * @param source - Source record.
+ * @param allowed_keys - Keys to retain.
+ * @returns Filtered record.
+ */
+export function pick_keys(source, allowed_keys) {
+    const picked = {};
+    for (const key of allowed_keys) {
+        if (source[key] !== undefined) {
+            picked[key] = source[key];
+        }
+    }
+    return picked;
+}
+/**
+ * Reads the value of the first candidate key present on the record.
+ * @param source - Source record.
+ * @param candidate_keys - Candidate keys in precedence order.
+ * @returns Value of the first present key, or undefined when none is present.
+ */
+export function read_first_present(source, candidate_keys) {
+    for (const key of candidate_keys) {
+        if (Object.hasOwn(source, key)) {
+            return source[key];
+        }
+    }
+    return undefined;
+}
+/**
+ * Keeps every defined key except the excluded ones.
+ * @param source - Source record.
+ * @param excluded_keys - Keys to drop.
+ * @returns Filtered record.
+ */
+export function omit_keys(source, excluded_keys) {
+    const kept = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (excluded_keys.includes(key) || value === undefined) {
+            continue;
+        }
+        kept[key] = value;
+    }
+    return kept;
+}

package/build/core/validation/schemas/stabilizer_config_schema.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const stabilizer_config_schema: z.ZodObject<{
+    reorder_strategy: z.ZodDefault<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    transport_stability_floor: z.ZodDefault<z.ZodNumber>;
+    max_iteration: z.ZodDefault<z.ZodNumber>;
+    genetic_population: z.ZodDefault<z.ZodNumber>;
+    genetic_generations: z.ZodDefault<z.ZodNumber>;
+    genetic_mutation_rate: z.ZodDefault<z.ZodNumber>;
+    beam_width: z.ZodDefault<z.ZodNumber>;
+    beam_top_k: z.ZodDefault<z.ZodNumber>;
+    axle_load_margin_percent: z.ZodDefault<z.ZodNumber>;
+    preserve_tie_block_organization: z.ZodDefault<z.ZodBoolean>;
+    pin_tie_ratio_blocks: z.ZodDefault<z.ZodBoolean>;
+    enforce_milkrun_wall_reservation: z.ZodDefault<z.ZodBoolean>;
+    number_of_wall_to_allocate_from_last_waypoints: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type StabilizerConfig = z.infer<typeof stabilizer_config_schema>;
+//# sourceMappingURL=stabilizer_config_schema.d.ts.map

package/build/core/validation/schemas/stabilizer_config_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stabilizer_config_schema.d.ts","sourceRoot":"","sources":["../../../../src/core/validation/schemas/stabilizer_config_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;iBAcnC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/build/core/validation/schemas/stabilizer_config_schema.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { REORDER_STRATEGY_VALUES } from '../../constants/ReorderStrategy.js';
+export const stabilizer_config_schema = z.object({
+    reorder_strategy: z.enum(REORDER_STRATEGY_VALUES).default('gravity'),
+    transport_stability_floor: z.number().min(0).max(1).default(0),
+    max_iteration: z.number().int().positive().default(10),
+    genetic_population: z.number().int().positive().default(30),
+    genetic_generations: z.number().int().positive().default(50),
+    genetic_mutation_rate: z.number().min(0).max(1).default(0.15),
+    beam_width: z.number().int().positive().default(5),
+    beam_top_k: z.number().int().positive().default(3),
+    axle_load_margin_percent: z.number().min(0).default(0),
+    preserve_tie_block_organization: z.boolean().default(true),
+    pin_tie_ratio_blocks: z.boolean().default(false),
+    enforce_milkrun_wall_reservation: z.boolean().default(false),
+    number_of_wall_to_allocate_from_last_waypoints: z.number().int().min(0).default(0)
+});

package/build/core/waypoint/WaypointMode.d.ts

@@ -0,0 +1,16 @@
+export type WaypointModeKind = 'SINGLE_WAYPOINT' | 'MULTI_WAYPOINT';
+export interface WaypointModeSingle {
+    kind: 'SINGLE_WAYPOINT';
+    synthetic_id: string;
+}
+export interface WaypointModeMulti {
+    kind: 'MULTI_WAYPOINT';
+}
+export type WaypointMode = WaypointModeSingle | WaypointModeMulti;
+export interface WaypointZone {
+    waypoint_id: string;
+    container_index: number;
+    z_min: number;
+    z_max: number;
+}
+//# sourceMappingURL=WaypointMode.d.ts.map

package/build/core/waypoint/WaypointMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaypointMode.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/WaypointMode.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;AAEnE,MAAM,WAAW,kBAAkB;IAE/B,IAAI,EAAE,iBAAiB,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAE9B,IAAI,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AAEjE,MAAM,WAAW,YAAY;IAEzB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB"}

package/build/core/waypoint/WaypointMode.js

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

package/build/core/waypoint/build_waypoint_zones.d.ts

@@ -0,0 +1,21 @@
+import type { StabilizerContainer, StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+import type { WaypointMode, WaypointZone } from './WaypointMode.js';
+/**
+ * Builds Z zones per waypoint per container from item extents.
+ * @param containers - CM containers.
+ * @param mode - Waypoint mode.
+ * @returns Zone list (empty when single-waypoint mode).
+ */
+export declare function build_waypoint_zones(containers: StabilizerContainer[], mode: WaypointMode): WaypointZone[];
+/**
+ * @param zone - Waypoint zone limits.
+ * @param item - Item to place.
+ * @param position - Candidate position.
+ * @returns True when item fits inside zone on Z axis.
+ */
+export declare function is_position_in_zone(zone: WaypointZone, item: StabilizerItem, position: {
+    x: number;
+    y: number;
+    z: number;
+}): boolean;
+//# sourceMappingURL=build_waypoint_zones.d.ts.map

package/build/core/waypoint/build_waypoint_zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_waypoint_zones.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/build_waypoint_zones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGnE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,mBAAmB,EAAE,EACjC,IAAI,EAAE,YAAY,GACnB,YAAY,EAAE,CAmBhB;AAmCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAGT"}

package/build/core/waypoint/build_waypoint_zones.js

@@ -0,0 +1,48 @@
+import { resolve_item_waypoint_id } from './validate_waypoint_ids.js';
+/**
+ * Builds Z zones per waypoint per container from item extents.
+ * @param containers - CM containers.
+ * @param mode - Waypoint mode.
+ * @returns Zone list (empty when single-waypoint mode).
+ */
+export function build_waypoint_zones(containers, mode) {
+    if (mode.kind === 'SINGLE_WAYPOINT') {
+        return [];
+    }
+    const zones = [];
+    containers.forEach((container, container_index) => {
+        const groups = group_items_by_waypoint(container.items, mode);
+        for (const [waypoint_id, items] of groups.entries()) {
+            zones.push(build_zone(waypoint_id, container_index, items));
+        }
+    });
+    return zones;
+}
+function group_items_by_waypoint(items, mode) {
+    const groups = new Map();
+    for (const item of items) {
+        const waypoint_id = resolve_item_waypoint_id(item, mode);
+        const bucket = groups.get(waypoint_id) ?? [];
+        bucket.push(item);
+        groups.set(waypoint_id, bucket);
+    }
+    return groups;
+}
+function build_zone(waypoint_id, container_index, items) {
+    const z_values = items.flatMap(item => [item.z, item.z + item.depth]);
+    return {
+        waypoint_id,
+        container_index,
+        z_min: Math.min(...z_values),
+        z_max: Math.max(...z_values)
+    };
+}
+/**
+ * @param zone - Waypoint zone limits.
+ * @param item - Item to place.
+ * @param position - Candidate position.
+ * @returns True when item fits inside zone on Z axis.
+ */
+export function is_position_in_zone(zone, item, position) {
+    return position.z >= zone.z_min && position.z + item.depth <= zone.z_max;
+}

package/build/core/waypoint/milkrun_wall_reservation.d.ts

@@ -0,0 +1,24 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { WaypointMode } from './WaypointMode.js';
+import type { MilkrunPositionCheck, MilkrunReservedBand } from './milkrun_wall_reservation_types.js';
+export type { MilkrunPositionCheck, MilkrunReservedBand } from './milkrun_wall_reservation_types.js';
+/**
+ * Builds reserved Z bands for the last N waypoints' compound walls per container.
+ * @param containers - Baseline container layout.
+ * @param mode - Waypoint mode.
+ * @param wall_count - Number of trailing waypoints to reserve.
+ * @returns Reserved Z bands (empty when wall_count is zero or single-waypoint mode).
+ */
+export declare function build_milkrun_reserved_z_bands(containers: StabilizerContainer[], mode: WaypointMode, wall_count: number): MilkrunReservedBand[];
+/**
+ * @param request - Reserved bands and candidate placement.
+ * @returns True when candidate overlaps a reserved band.
+ */
+export declare function is_position_in_milkrun_reserved_band(request: MilkrunPositionCheck): boolean;
+/**
+ * @param containers - Layout to validate.
+ * @param bands - Reserved milkrun Z bands.
+ * @returns True when no loose item overlaps a reserved band.
+ */
+export declare function is_layout_milkrun_valid(containers: StabilizerContainer[], bands: MilkrunReservedBand[]): boolean;
+//# sourceMappingURL=milkrun_wall_reservation.d.ts.map

package/build/core/waypoint/milkrun_wall_reservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milkrun_wall_reservation.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/milkrun_wall_reservation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,oDAAoD,CAAA;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAEpG,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAEpG;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC1C,UAAU,EAAE,mBAAmB,EAAE,EACjC,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,GACnB,mBAAmB,EAAE,CAiBvB;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAS3F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,mBAAmB,EAAE,EACjC,KAAK,EAAE,mBAAmB,EAAE,GAC7B,OAAO,CAUT"}

package/build/core/waypoint/milkrun_wall_reservation.js

@@ -0,0 +1,57 @@
+import { is_loose_item } from '../filters/loose_item_filter.js';
+import { build_container_milkrun_band } from './milkrun_wall_reservation_helpers.js';
+/**
+ * Builds reserved Z bands for the last N waypoints' compound walls per container.
+ * @param containers - Baseline container layout.
+ * @param mode - Waypoint mode.
+ * @param wall_count - Number of trailing waypoints to reserve.
+ * @returns Reserved Z bands (empty when wall_count is zero or single-waypoint mode).
+ */
+export function build_milkrun_reserved_z_bands(containers, mode, wall_count) {
+    if (wall_count <= 0 || mode.kind === 'SINGLE_WAYPOINT') {
+        return [];
+    }
+    return containers.flatMap((container, container_index) => {
+        const band = build_container_milkrun_band({
+            container,
+            mode,
+            wall_count,
+            container_index
+        });
+        return band ? [band] : [];
+    });
+}
+/**
+ * @param request - Reserved bands and candidate placement.
+ * @returns True when candidate overlaps a reserved band.
+ */
+export function is_position_in_milkrun_reserved_band(request) {
+    const item_z_min = request.position.z;
+    const item_z_max = request.position.z + request.item.depth;
+    return request.bands.some(band => band.container_index === request.container_index &&
+        item_z_min < band.z_max &&
+        item_z_max > band.z_min);
+}
+/**
+ * @param containers - Layout to validate.
+ * @param bands - Reserved milkrun Z bands.
+ * @returns True when no loose item overlaps a reserved band.
+ */
+export function is_layout_milkrun_valid(containers, bands) {
+    if (bands.length === 0) {
+        return true;
+    }
+    return containers.every((container, container_index) => container.items.every(item => is_loose_item_position_valid(item, bands, container_index)));
+}
+function is_loose_item_position_valid(item, bands, container_index) {
+    if (!is_loose_item(item)) {
+        return true;
+    }
+    const overlaps = is_position_in_milkrun_reserved_band({
+        bands,
+        container_index,
+        item,
+        position: { z: item.z }
+    });
+    return !overlaps;
+}

package/build/core/waypoint/milkrun_wall_reservation_helpers.d.ts

@@ -0,0 +1,15 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { WaypointMode } from './WaypointMode.js';
+import type { MilkrunReservedBand } from './milkrun_wall_reservation_types.js';
+export interface ContainerMilkrunBandRequest {
+    container: StabilizerContainer;
+    mode: WaypointMode;
+    wall_count: number;
+    container_index: number;
+}
+/**
+ * @param request - Container milkrun band request.
+ * @returns Reserved Z band for one container.
+ */
+export declare function build_container_milkrun_band(request: ContainerMilkrunBandRequest): MilkrunReservedBand | undefined;
+//# sourceMappingURL=milkrun_wall_reservation_helpers.d.ts.map

package/build/core/waypoint/milkrun_wall_reservation_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milkrun_wall_reservation_helpers.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/milkrun_wall_reservation_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAE9E,MAAM,WAAW,2BAA2B;IAExC,SAAS,EAAE,mBAAmB,CAAA;IAC9B,IAAI,EAAE,YAAY,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,EAAE,2BAA2B,GACrC,mBAAmB,GAAG,SAAS,CAwBjC"}

package/build/core/waypoint/milkrun_wall_reservation_helpers.js

@@ -0,0 +1,48 @@
+import { is_loose_item } from '../filters/loose_item_filter.js';
+import { resolve_item_waypoint_id } from './validate_waypoint_ids.js';
+/**
+ * @param request - Container milkrun band request.
+ * @returns Reserved Z band for one container.
+ */
+export function build_container_milkrun_band(request) {
+    const order = build_compound_waypoint_order(request.container.items, request.mode);
+    const reserved_waypoints = order.slice(-request.wall_count);
+    if (reserved_waypoints.length === 0) {
+        return undefined;
+    }
+    const z_values = collect_compound_z_extents(request.container.items, request.mode, reserved_waypoints);
+    if (z_values.length === 0) {
+        return undefined;
+    }
+    return {
+        container_index: request.container_index,
+        z_min: Math.min(...z_values),
+        z_max: Math.max(...z_values)
+    };
+}
+function build_compound_waypoint_order(items, mode) {
+    const compound_items = items.filter(item => !is_loose_item(item));
+    const sorted = [...compound_items].sort((left, right) => left.z - right.z);
+    const vector = [];
+    for (const item of sorted) {
+        const waypoint_id = resolve_item_waypoint_id(item, mode);
+        if (vector.length === 0 || vector[vector.length - 1] !== waypoint_id) {
+            vector.push(waypoint_id);
+        }
+    }
+    return vector;
+}
+function collect_compound_z_extents(items, mode, reserved_waypoints) {
+    const z_values = [];
+    for (const item of items) {
+        if (is_loose_item(item)) {
+            continue;
+        }
+        const waypoint_id = resolve_item_waypoint_id(item, mode);
+        if (!reserved_waypoints.includes(waypoint_id)) {
+            continue;
+        }
+        z_values.push(item.z, item.z + item.depth);
+    }
+    return z_values;
+}

package/build/core/waypoint/milkrun_wall_reservation_types.d.ts

@@ -0,0 +1,16 @@
+export interface MilkrunReservedBand {
+    container_index: number;
+    z_min: number;
+    z_max: number;
+}
+export interface MilkrunPositionCheck {
+    bands: MilkrunReservedBand[];
+    container_index: number;
+    item: {
+        depth: number;
+    };
+    position: {
+        z: number;
+    };
+}
+//# sourceMappingURL=milkrun_wall_reservation_types.d.ts.map

package/build/core/waypoint/milkrun_wall_reservation_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milkrun_wall_reservation_types.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/milkrun_wall_reservation_types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAEhC,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IAEjC,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1B"}

package/build/core/waypoint/milkrun_wall_reservation_types.js

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

package/build/core/waypoint/preserves_waypoint_order.d.ts

@@ -0,0 +1,24 @@
+import type { StabilizerContainer } from '../validation/contract/stabilizer_domain_schema.js';
+import type { WaypointMode } from './WaypointMode.js';
+/**
+ * Builds macro waypoint order vector along Z for one container.
+ * @param container - CM container.
+ * @param mode - Waypoint mode.
+ * @returns Ordered waypoint ids by first encounter along Z.
+ */
+export declare function build_waypoint_order_vector(container: StabilizerContainer, mode: WaypointMode): string[];
+/**
+ * @param before - Order vector before reorder.
+ * @param after - Order vector after reorder.
+ * @returns True when macro waypoint order is unchanged.
+ */
+export declare function vectors_equal(before: string[], after: string[]): boolean;
+/**
+ * Validates waypoint macro order for all containers.
+ * @param before - Containers before moves.
+ * @param after - Containers after moves.
+ * @param mode - Waypoint mode.
+ * @returns True when order preserved on every container.
+ */
+export declare function preserves_waypoint_order(before: StabilizerContainer[], after: StabilizerContainer[], mode: WaypointMode): boolean;
+//# sourceMappingURL=preserves_waypoint_order.d.ts.map

package/build/core/waypoint/preserves_waypoint_order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preserves_waypoint_order.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/preserves_waypoint_order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,YAAY,GACnB,MAAM,EAAE,CAeV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAQxE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,KAAK,EAAE,mBAAmB,EAAE,EAC5B,IAAI,EAAE,YAAY,GACnB,OAAO,CAkBT"}

package/build/core/waypoint/preserves_waypoint_order.js

@@ -0,0 +1,49 @@
+import { resolve_item_waypoint_id } from './validate_waypoint_ids.js';
+/**
+ * Builds macro waypoint order vector along Z for one container.
+ * @param container - CM container.
+ * @param mode - Waypoint mode.
+ * @returns Ordered waypoint ids by first encounter along Z.
+ */
+export function build_waypoint_order_vector(container, mode) {
+    const sorted = [...container.items].sort((left, right) => left.z - right.z);
+    const vector = [];
+    for (const item of sorted) {
+        const waypoint_id = resolve_item_waypoint_id(item, mode);
+        if (vector.length === 0 || vector[vector.length - 1] !== waypoint_id) {
+            vector.push(waypoint_id);
+        }
+    }
+    return vector;
+}
+/**
+ * @param before - Order vector before reorder.
+ * @param after - Order vector after reorder.
+ * @returns True when macro waypoint order is unchanged.
+ */
+export function vectors_equal(before, after) {
+    if (before.length !== after.length) {
+        return false;
+    }
+    return before.every((value, index) => value === after[index]);
+}
+/**
+ * Validates waypoint macro order for all containers.
+ * @param before - Containers before moves.
+ * @param after - Containers after moves.
+ * @param mode - Waypoint mode.
+ * @returns True when order preserved on every container.
+ */
+export function preserves_waypoint_order(before, after, mode) {
+    if (mode.kind === 'SINGLE_WAYPOINT') {
+        return true;
+    }
+    for (let index = 0; index < before.length; index++) {
+        const before_vector = build_waypoint_order_vector(before[index], mode);
+        const after_vector = build_waypoint_order_vector(after[index], mode);
+        if (!vectors_equal(before_vector, after_vector)) {
+            return false;
+        }
+    }
+    return true;
+}

package/build/core/waypoint/validate_waypoint_ids.d.ts

@@ -0,0 +1,16 @@
+import type { StabilizerItem } from '../validation/contract/stabilizer_domain_schema.js';
+import type { WaypointMode } from './WaypointMode.js';
+/**
+ * Validates waypoint_id consistency across all items in an env.
+ * @param items - Flat list of items from all containers.
+ * @returns Resolved waypoint mode.
+ */
+export declare function validate_waypoint_ids(items: StabilizerItem[]): WaypointMode;
+/**
+ * Resolves effective waypoint id for an item given the mode.
+ * @param item - Cargo item.
+ * @param mode - Waypoint mode.
+ * @returns Waypoint identifier string.
+ */
+export declare function resolve_item_waypoint_id(item: StabilizerItem, mode: WaypointMode): string;
+//# sourceMappingURL=validate_waypoint_ids.d.ts.map

package/build/core/waypoint/validate_waypoint_ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_waypoint_ids.d.ts","sourceRoot":"","sources":["../../../src/core/waypoint/validate_waypoint_ids.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,CAgB3E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAQzF"}

package/build/core/waypoint/validate_waypoint_ids.js

@@ -0,0 +1,30 @@
+import { DEFAULT_SYNTHETIC_WAYPOINT_ID } from '../constants/ReorderStrategy.js';
+import { MixedWaypointIdError } from '../exceptions/MixedWaypointIdError.js';
+/**
+ * Validates waypoint_id consistency across all items in an env.
+ * @param items - Flat list of items from all containers.
+ * @returns Resolved waypoint mode.
+ */
+export function validate_waypoint_ids(items) {
+    const has_any_defined = items.some(item => item.waypoint_id !== undefined);
+    const has_any_undefined = items.some(item => item.waypoint_id === undefined);
+    if (has_any_defined && has_any_undefined) {
+        throw new MixedWaypointIdError();
+    }
+    if (!has_any_defined) {
+        return { kind: 'SINGLE_WAYPOINT', synthetic_id: DEFAULT_SYNTHETIC_WAYPOINT_ID };
+    }
+    return { kind: 'MULTI_WAYPOINT' };
+}
+/**
+ * Resolves effective waypoint id for an item given the mode.
+ * @param item - Cargo item.
+ * @param mode - Waypoint mode.
+ * @returns Waypoint identifier string.
+ */
+export function resolve_item_waypoint_id(item, mode) {
+    if (mode.kind === 'SINGLE_WAYPOINT') {
+        return mode.synthetic_id;
+    }
+    return item.waypoint_id;
+}

package/build/index.d.ts

@@ -0,0 +1,27 @@
+export { REORDER_STRATEGY, REORDER_STRATEGY_VALUES } from './core/constants/ReorderStrategy.js';
+export type { ReorderStrategyValue } from './core/constants/ReorderStrategy.js';
+export { MixedWaypointIdError } from './core/exceptions/MixedWaypointIdError.js';
+export { UnknownReorderStrategyError } from './core/exceptions/UnknownReorderStrategyError.js';
+export { InvalidStabilizerInputError } from './core/exceptions/InvalidStabilizerInputError.js';
+export { InvalidStabilizerOutputError } from './core/exceptions/InvalidStabilizerOutputError.js';
+export type { StabilizerInput, StabilizerResponse, StabilizerSuccessResponse, StabilizerErrorResponse, StabilizerItem, StabilizerContainer, StabilizerEnv, StabilizerCargoState } from './core/validation/contract/index.js';
+export { parse_stabilizer_input, safe_parse_stabilizer_input, parse_stabilizer_output, safe_parse_stabilizer_output, map_wire_input_to_contract, map_contract_to_wire_output } from './core/validation/contract/index.js';
+export type StabilizerWireResponse = {
+    status: 'success';
+    data: unknown;
+    messages: string[];
+} | {
+    status: 'error';
+    data: string;
+    messages: string[];
+};
+/**
+ * Stabilizes cargo by reordering loose items (legacy CM-compatible response).
+ * @param input - Cargo-movement wire payload or English contract input.
+ * @returns Success or error response with CM wire cargo_state on success.
+ */
+export declare function stabilize(input: unknown): Promise<StabilizerWireResponse>;
+export { run_stabilizer_flow_from_unknown } from './core/orchestration/StabilizerFlow.js';
+export { create_reorder_strategy } from './core/factory/strategy_factory.js';
+export { validate_waypoint_ids } from './core/waypoint/validate_waypoint_ids.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAA;AAC/F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAA;AAC9F,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAA;AAC9F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAA;AAChG,YAAY,EACR,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACvB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACH,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC9B,MAAM,qCAAqC,CAAA;AAK5C,MAAM,MAAM,sBAAsB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAE3D;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAI/E;AAsED,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAA;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAA"}