@jetta/axle-load-calculator 0.1.3

package/build/core/orchestration/weight_by_axis_task.js

@@ -0,0 +1,105 @@
+import { calculate_loaded_weights_for_env } from './axle_weight_physics.js';
+import { build_success_output, build_error_output } from './output_builder.js';
+import { check_cargo_collision } from './collision_checker.js';
+import { parse_weight_by_axis_request } from './request_schema.js';
+/**
+ * Runs weight-by-axis for ms-faixas JSON input (WeightByAxisTask.run contract).
+ * @param json_data - Raw request JSON string.
+ * @returns Response JSON string.
+ */
+export function run_weight_by_axis_task(json_data) {
+    try {
+        const request = parse_weight_by_axis_request(json_data);
+        const envs = request.envs;
+        const output_envs = [];
+        for (const env of envs) {
+            const loaded_weights = calculate_loaded_weights_for_env(env);
+            apply_loaded_weights_to_env(env, loaded_weights);
+            check_cargo_collision(env);
+            output_envs.push(strip_items_and_bands(env));
+        }
+        return build_success_output(output_envs);
+    }
+    catch (error) {
+        return build_error_output(error);
+    }
+}
+/**
+ * @param env - Env vehicle object.
+ * @param loaded_weights - Forces per axle.
+ */
+function apply_loaded_weights_to_env(env, loaded_weights) {
+    const axles = env.eixos;
+    for (let index = 0; index < loaded_weights.length; index++) {
+        const cargo = loaded_weights[index];
+        const axle = axles[index];
+        const tare = Number(axle.tara ?? 0);
+        axle.pesoCarregado = cargo;
+        axle.pesoCarregadoFinal = tare + cargo;
+    }
+    const containers = env.conteiners ?? env.containers;
+    if (!Array.isArray(containers)) {
+        return;
+    }
+    apply_to_containers(containers, loaded_weights, axles);
+}
+/**
+ * @param containers - Container list on env.
+ * @param loaded_weights - Per-axle cargo load.
+ * @param axles - Vehicle axles list.
+ */
+function apply_to_containers(containers, loaded_weights, axles) {
+    for (const container of containers) {
+        const peso_eixos = build_peso_eixos_for_container(container, loaded_weights, axles);
+        container.pesoEixos = peso_eixos;
+    }
+}
+/**
+ * @param container - Container on env.
+ * @param loaded_weights - All axle loads.
+ * @param axles - Vehicle axles.
+ * @returns pesoEixos array for container.
+ */
+function build_peso_eixos_for_container(container, loaded_weights, axles) {
+    const sequence = Number(container.sequencia);
+    const result = [];
+    for (let index = 0; index < axles.length; index++) {
+        if (Number(axles[index].sequenciaContainer) !== sequence) {
+            continue;
+        }
+        result.push(build_peso_eixo_entry(axles[index], loaded_weights[index]));
+    }
+    return result;
+}
+/**
+ * @param axle - Axle record on env.
+ * @param cargo - Loaded cargo on axle.
+ * @returns Single pesoEixos entry.
+ */
+function build_peso_eixo_entry(axle, cargo) {
+    const tare = Number(axle.tara ?? 0);
+    return {
+        distanciaOrigem: axle.distanciaOrigem,
+        pesoMax: Number(axle.pesoMaxSuportado) - tare,
+        pesoMaxFinal: axle.pesoMaxSuportado,
+        tara: tare,
+        pesoCarregado: cargo,
+        pesoCarregadoFinal: tare + cargo,
+        distanciaOrigemSemPrimeiroEixo: axle.distanciaOrigemSemPrimeiroEixo ?? 0
+    };
+}
+/**
+ * @param env - Env with updated axle data.
+ * @returns Env copy without items/faixas on containers.
+ */
+function strip_items_and_bands(env) {
+    const clone = JSON.parse(JSON.stringify(env));
+    const key = clone.conteiners ? 'conteiners' : 'containers';
+    const containers = clone[key];
+    for (const container of containers) {
+        container.items = [];
+        container.faixas = [];
+    }
+    clone.idCaminhao = clone._id;
+    return clone;
+}

package/build/core/physics/items/allocated_item.d.ts

@@ -0,0 +1,22 @@
+import type { RotationCode } from '../../contracts/rotation_enum.js';
+import type { ItemTemplates } from './item_templates.js';
+/**
+ * Allocated cargo item with position in container coordinates.
+ */
+export declare class AllocatedItem {
+    xi: number;
+    yi: number;
+    zi: number;
+    rotation: RotationCode;
+    readonly template_index: number;
+    readonly templates: ItemTemplates;
+    /**
+     * @param templates - Shared templates.
+     * @param template_index - Template index.
+     */
+    constructor(templates: ItemTemplates, template_index: number);
+    get weight(): number;
+    get length(): number;
+    get center_of_gravity_z(): number;
+}
+//# sourceMappingURL=allocated_item.d.ts.map

package/build/core/physics/items/allocated_item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocated_item.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/allocated_item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;GAEG;AACH,qBAAa,aAAa;IAEtB,EAAE,SAAI;IACN,EAAE,SAAI;IACN,EAAE,SAAI;IACN,QAAQ,EAAE,YAAY,CAAgB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IAEjC;;;OAGG;gBACS,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM;IAM5D,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,mBAAmB,IAAI,MAAM,CAGhC;CACJ"}

package/build/core/physics/items/allocated_item.js

@@ -0,0 +1,29 @@
+import { ROTATION } from '../../contracts/rotation_enum.js';
+/**
+ * Allocated cargo item with position in container coordinates.
+ */
+export class AllocatedItem {
+    xi = 0;
+    yi = 0;
+    zi = 0;
+    rotation = ROTATION.POS1;
+    template_index;
+    templates;
+    /**
+     * @param templates - Shared templates.
+     * @param template_index - Template index.
+     */
+    constructor(templates, template_index) {
+        this.templates = templates;
+        this.template_index = template_index;
+    }
+    get weight() {
+        return this.templates.weights[this.template_index];
+    }
+    get length() {
+        return this.templates.get_length(this.template_index, this.rotation);
+    }
+    get center_of_gravity_z() {
+        return this.zi + this.length / 2;
+    }
+}

package/build/core/physics/items/allocated_item_manager.d.ts

@@ -0,0 +1,31 @@
+import { AllocatedItem } from './allocated_item.js';
+import type { ItemTemplates } from './item_templates.js';
+/**
+ * Items allocated inside one container sequence.
+ */
+export declare class AllocatedItemManager {
+    readonly templates: ItemTemplates;
+    private items;
+    /**
+     * @param templates - Item templates for this container.
+     */
+    constructor(templates: ItemTemplates);
+    /**
+     * @param items - Items to add.
+     */
+    add_allocated_items(items: AllocatedItem[]): void;
+    /**
+     * @returns Item count.
+     */
+    count_items(): number;
+    /**
+     * @returns Item indexes.
+     */
+    list_item_indexes(): number[];
+    /**
+     * @param item_index - Item index.
+     * @returns Item instance.
+     */
+    get_item(item_index: number): AllocatedItem;
+}
+//# sourceMappingURL=allocated_item_manager.d.ts.map

package/build/core/physics/items/allocated_item_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocated_item_manager.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/allocated_item_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;GAEG;AACH,qBAAa,oBAAoB;IAOjB,QAAQ,CAAC,SAAS,EAAE,aAAa;IAL7C,OAAO,CAAC,KAAK,CAAsB;IAEnC;;OAEG;gBACkB,SAAS,EAAE,aAAa;IAI7C;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAKjD;;OAEG;IACH,WAAW,IAAI,MAAM;IAKrB;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAK7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;CAI9C"}

package/build/core/physics/items/allocated_item_manager.js

@@ -0,0 +1,38 @@
+/**
+ * Items allocated inside one container sequence.
+ */
+export class AllocatedItemManager {
+    templates;
+    items = [];
+    /**
+     * @param templates - Item templates for this container.
+     */
+    constructor(templates) {
+        this.templates = templates;
+    }
+    /**
+     * @param items - Items to add.
+     */
+    add_allocated_items(items) {
+        this.items.push(...items);
+    }
+    /**
+     * @returns Item count.
+     */
+    count_items() {
+        return this.items.length;
+    }
+    /**
+     * @returns Item indexes.
+     */
+    list_item_indexes() {
+        return this.items.map((_item, index) => index);
+    }
+    /**
+     * @param item_index - Item index.
+     * @returns Item instance.
+     */
+    get_item(item_index) {
+        return this.items[item_index];
+    }
+}

package/build/core/physics/items/center_of_mass.d.ts

@@ -0,0 +1,14 @@
+import type { AllocatedItemManager } from './allocated_item_manager.js';
+/**
+ * Center of mass for a load grouper (longitudinal z in chassis coordinates).
+ */
+export declare class CenterOfMass {
+    mass: number;
+    z: number;
+    /**
+     * Computes center of mass from allocated items.
+     * @param allocated_items - Item manager for one grouper.
+     */
+    set_center_of_mass_with_allocated_items(allocated_items: AllocatedItemManager): void;
+}
+//# sourceMappingURL=center_of_mass.d.ts.map

package/build/core/physics/items/center_of_mass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"center_of_mass.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/center_of_mass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAEvE;;GAEG;AACH,qBAAa,YAAY;IAErB,IAAI,SAAI;IACR,CAAC,SAAI;IAEL;;;OAGG;IACH,uCAAuC,CAAC,eAAe,EAAE,oBAAoB,GAAG,IAAI;CAgBvF"}

package/build/core/physics/items/center_of_mass.js

@@ -0,0 +1,24 @@
+/**
+ * Center of mass for a load grouper (longitudinal z in chassis coordinates).
+ */
+export class CenterOfMass {
+    mass = 0;
+    z = 0;
+    /**
+     * Computes center of mass from allocated items.
+     * @param allocated_items - Item manager for one grouper.
+     */
+    set_center_of_mass_with_allocated_items(allocated_items) {
+        let accumulated_weighted_positions = 0;
+        this.mass = 0;
+        for (const item_index of allocated_items.list_item_indexes()) {
+            const item = allocated_items.get_item(item_index);
+            accumulated_weighted_positions += item.center_of_gravity_z * item.weight;
+            this.mass += item.weight;
+        }
+        if (this.mass === 0) {
+            return;
+        }
+        this.z = accumulated_weighted_positions / this.mass;
+    }
+}

package/build/core/physics/items/compute_grouper_center_of_mass.d.ts

@@ -0,0 +1,19 @@
+import type { Transport } from '../transports/transport.js';
+import { MergedContainers } from '../transports/merged_containers.js';
+import { CenterOfMass } from './center_of_mass.js';
+import type { MultiContainerAllocatedItems } from './multi_container_allocated_items.js';
+import type { ChassiForces } from '../models/chassi_forces.js';
+/**
+ * @param multi_items - Allocated items across containers.
+ * @param merged - Merged container layout.
+ * @returns Center of mass map keyed by grouper id.
+ */
+export declare function compute_center_of_mass_by_grouper(multi_items: MultiContainerAllocatedItems, merged: MergedContainers): Record<number, CenterOfMass>;
+/**
+ * @param transport - Parsed transport.
+ * @param multi_items - Allocated items.
+ * @param solve - Model solver from CM map.
+ * @returns Chassis forces.
+ */
+export declare function calculate_chassi_forces_from_multi(transport: Transport, multi_items: MultiContainerAllocatedItems, solve: (center_of_mass_by_grouper: Record<number, CenterOfMass>) => ChassiForces): ChassiForces;
+//# sourceMappingURL=compute_grouper_center_of_mass.d.ts.map

package/build/core/physics/items/compute_grouper_center_of_mass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute_grouper_center_of_mass.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/compute_grouper_center_of_mass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC7C,WAAW,EAAE,4BAA4B,EACzC,MAAM,EAAE,gBAAgB,GACzB,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAY9B;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAC9C,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,4BAA4B,EACzC,KAAK,EAAE,CAAC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,YAAY,GACjF,YAAY,CAKd"}

package/build/core/physics/items/compute_grouper_center_of_mass.js

@@ -0,0 +1,28 @@
+import { MergedContainers } from '../transports/merged_containers.js';
+import { CenterOfMass } from './center_of_mass.js';
+/**
+ * @param multi_items - Allocated items across containers.
+ * @param merged - Merged container layout.
+ * @returns Center of mass map keyed by grouper id.
+ */
+export function compute_center_of_mass_by_grouper(multi_items, merged) {
+    multi_items.merge_allocated_items(merged);
+    const result = {};
+    for (const grouper of merged.list_grouper_indexes()) {
+        const center_of_mass = new CenterOfMass();
+        center_of_mass.set_center_of_mass_with_allocated_items(multi_items.get_allocated_items_by_grouper_index(grouper));
+        result[grouper] = center_of_mass;
+    }
+    return result;
+}
+/**
+ * @param transport - Parsed transport.
+ * @param multi_items - Allocated items.
+ * @param solve - Model solver from CM map.
+ * @returns Chassis forces.
+ */
+export function calculate_chassi_forces_from_multi(transport, multi_items, solve) {
+    const merged = new MergedContainers(transport);
+    const center_of_mass_by_grouper = compute_center_of_mass_by_grouper(multi_items, merged);
+    return solve(center_of_mass_by_grouper);
+}

package/build/core/physics/items/item_templates.d.ts

@@ -0,0 +1,32 @@
+import type { RotationCode } from '../../contracts/rotation_enum.js';
+/**
+ * Item dimensions and weights keyed by template index.
+ */
+export declare class ItemTemplates {
+    ids: string[];
+    weights: number[];
+    lengths: number[];
+    widths: number[];
+    heights: number[];
+    private dimensions;
+    /**
+     * @param item_id - Template id string.
+     * @returns Template index.
+     */
+    index_of(item_id: string): number;
+    /**
+     * @param item_data - Ms-faixas or math input item definition.
+     */
+    add_template_from_item_data(item_data: Record<string, unknown>): void;
+    /**
+     * @param template_index - Template index.
+     * @param rotation - Rotation code.
+     * @returns Length along chassis z for rotation.
+     */
+    get_length(template_index: number, rotation?: RotationCode): number;
+    /**
+     * @param item_data - Math input item row.
+     */
+    add_template_from_math_item(item_data: Record<string, unknown>): void;
+}
+//# sourceMappingURL=item_templates.d.ts.map

package/build/core/physics/items/item_templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item_templates.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/item_templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAIpE;;GAEG;AACH,qBAAa,aAAa;IAEtB,GAAG,EAAE,MAAM,EAAE,CAAK;IAClB,OAAO,EAAE,MAAM,EAAE,CAAK;IACtB,OAAO,EAAE,MAAM,EAAE,CAAK;IACtB,MAAM,EAAE,MAAM,EAAE,CAAK;IACrB,OAAO,EAAE,MAAM,EAAE,CAAK;IACtB,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAUjC;;OAEG;IACH,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAcrE;;;;OAIG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,GAAE,YAA4B,GAAG,MAAM;IAKlF;;OAEG;IACH,2BAA2B,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAIxE"}

package/build/core/physics/items/item_templates.js

@@ -0,0 +1,53 @@
+import { ROTATION } from '../../contracts/rotation_enum.js';
+import { rotate_dimensions } from './rotation_transforms.js';
+/**
+ * Item dimensions and weights keyed by template index.
+ */
+export class ItemTemplates {
+    ids = [];
+    weights = [];
+    lengths = [];
+    widths = [];
+    heights = [];
+    dimensions = [];
+    /**
+     * @param item_id - Template id string.
+     * @returns Template index.
+     */
+    index_of(item_id) {
+        const index = this.ids.indexOf(item_id);
+        if (index < 0) {
+            throw new Error(`Unknown item id ${item_id}`);
+        }
+        return index;
+    }
+    /**
+     * @param item_data - Ms-faixas or math input item definition.
+     */
+    add_template_from_item_data(item_data) {
+        const id = String(item_data.id ?? item_data._id);
+        this.ids.push(id);
+        this.weights.push(Number(item_data.peso ?? item_data.weight ?? 0));
+        const width = Number(item_data.largura ?? item_data.width ?? 0);
+        const length = Number(item_data.comprimento ?? item_data.length ?? 0);
+        const height = Number(item_data.altura ?? item_data.height ?? 0);
+        this.widths.push(width);
+        this.lengths.push(length);
+        this.heights.push(height);
+        this.dimensions.push([width, length, height]);
+    }
+    /**
+     * @param template_index - Template index.
+     * @param rotation - Rotation code.
+     * @returns Length along chassis z for rotation.
+     */
+    get_length(template_index, rotation = ROTATION.POS1) {
+        return rotate_dimensions(rotation, this.dimensions[template_index])[1];
+    }
+    /**
+     * @param item_data - Math input item row.
+     */
+    add_template_from_math_item(item_data) {
+        this.add_template_from_item_data(item_data);
+    }
+}

package/build/core/physics/items/multi_container_allocated_items.d.ts

@@ -0,0 +1,37 @@
+import type { MergedContainers } from '../transports/merged_containers.js';
+import { AllocatedItemManager } from './allocated_item_manager.js';
+import type { ItemTemplates } from './item_templates.js';
+/**
+ * Allocated items grouped by container sequence and merged by grouper.
+ */
+export declare class MultiContainerAllocatedItems {
+    allocated_items_by_sequence_index: Record<number, AllocatedItemManager>;
+    allocated_items_by_grouper_index: Record<number, AllocatedItemManager>;
+    /**
+     * @param allocated_items_by_sequence_index - Items per container sequence.
+     */
+    constructor(allocated_items_by_sequence_index: Record<number, AllocatedItemManager>);
+    /**
+     * @param sequence_index - Container sequence id.
+     * @returns Manager for sequence.
+     */
+    get_allocated_items_by_sequence_index(sequence_index: number): AllocatedItemManager;
+    /**
+     * @param grouper_index - Grouper id.
+     * @returns Manager for grouper.
+     */
+    get_allocated_items_by_grouper_index(grouper_index: number): AllocatedItemManager;
+    /**
+     * @param grouper_index_list - Grouper ids to initialize.
+     */
+    create_allocated_items_by_grouper(grouper_index_list: number[]): void;
+    /**
+     * @param merged_containers - Merged container geometry.
+     */
+    merge_allocated_items(merged_containers: MergedContainers): void;
+    /**
+     * @returns Shared item templates.
+     */
+    get_item_templates(): ItemTemplates;
+}
+//# sourceMappingURL=multi_container_allocated_items.d.ts.map

package/build/core/physics/items/multi_container_allocated_items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi_container_allocated_items.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/multi_container_allocated_items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;GAEG;AACH,qBAAa,4BAA4B;IAErC,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACvE,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAK;IAE3E;;OAEG;gBACS,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAKnF;;;OAGG;IACH,qCAAqC,CAAC,cAAc,EAAE,MAAM,GAAG,oBAAoB;IAKnF;;;OAGG;IACH,oCAAoC,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB;IAKjF;;OAEG;IACH,iCAAiC,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI;IASrE;;OAEG;IACH,qBAAqB,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,IAAI;IAahE;;OAEG;IACH,kBAAkB,IAAI,aAAa;CAMtC"}

package/build/core/physics/items/multi_container_allocated_items.js

@@ -0,0 +1,91 @@
+import { AllocatedItem } from './allocated_item.js';
+import { AllocatedItemManager } from './allocated_item_manager.js';
+/**
+ * Allocated items grouped by container sequence and merged by grouper.
+ */
+export class MultiContainerAllocatedItems {
+    allocated_items_by_sequence_index;
+    allocated_items_by_grouper_index = {};
+    /**
+     * @param allocated_items_by_sequence_index - Items per container sequence.
+     */
+    constructor(allocated_items_by_sequence_index) {
+        this.allocated_items_by_sequence_index = allocated_items_by_sequence_index;
+    }
+    /**
+     * @param sequence_index - Container sequence id.
+     * @returns Manager for sequence.
+     */
+    get_allocated_items_by_sequence_index(sequence_index) {
+        return this.allocated_items_by_sequence_index[sequence_index];
+    }
+    /**
+     * @param grouper_index - Grouper id.
+     * @returns Manager for grouper.
+     */
+    get_allocated_items_by_grouper_index(grouper_index) {
+        return this.allocated_items_by_grouper_index[grouper_index];
+    }
+    /**
+     * @param grouper_index_list - Grouper ids to initialize.
+     */
+    create_allocated_items_by_grouper(grouper_index_list) {
+        const templates = this.get_item_templates();
+        for (const grouper_index of grouper_index_list) {
+            this.allocated_items_by_grouper_index[grouper_index] = new AllocatedItemManager(templates);
+        }
+    }
+    /**
+     * @param merged_containers - Merged container geometry.
+     */
+    merge_allocated_items(merged_containers) {
+        if (Object.keys(this.allocated_items_by_grouper_index).length > 0) {
+            return;
+        }
+        this.create_allocated_items_by_grouper(merged_containers.list_grouper_indexes());
+        for (const grouper of merged_containers.list_grouper_indexes()) {
+            merge_grouper_items(this, merged_containers, grouper);
+        }
+    }
+    /**
+     * @returns Shared item templates.
+     */
+    get_item_templates() {
+        const keys = Object.keys(this.allocated_items_by_sequence_index);
+        const first_key = Number(keys[0]);
+        return this.allocated_items_by_sequence_index[first_key].templates;
+    }
+}
+/**
+ * @param multi - Multi-container item holder.
+ * @param merged - Merged containers.
+ * @param grouper - Grouper id.
+ */
+function merge_grouper_items(multi, merged, grouper) {
+    const grouped = merged.get_container_by_grouper_index(grouper);
+    let last_end = 0;
+    for (const sequence_index of grouped.list_containers_sequence_indexes()) {
+        const sequence_items = multi.get_allocated_items_by_sequence_index(sequence_index);
+        const grouper_items = multi.get_allocated_items_by_grouper_index(grouper);
+        for (const item_index of sequence_items.list_item_indexes()) {
+            const source = sequence_items.get_item(item_index);
+            const item = clone_allocated_item(source);
+            item.zi += last_end;
+            grouper_items.add_allocated_items([item]);
+        }
+        const container = grouped.get_container_by_sequence_index(sequence_index);
+        last_end += container.length;
+    }
+}
+/**
+ * @param source - Sequence-level allocated item.
+ * @returns Copy safe to offset for grouper merge.
+ */
+function clone_allocated_item(source) {
+    const item = new AllocatedItem(source.templates, source.template_index);
+    item.xi = source.xi;
+    item.yi = source.yi;
+    item.zi = source.zi;
+    item.rotation = source.rotation;
+    return item;
+}

package/build/core/physics/items/rotation_transforms.d.ts

@@ -0,0 +1,8 @@
+import type { RotationCode } from '../../contracts/rotation_enum.js';
+/**
+ * @param rotation - Rotation code.
+ * @param dimensions - [width, length, height].
+ * @returns Rotated [width, length, height].
+ */
+export declare function rotate_dimensions(rotation: RotationCode, dimensions: [number, number, number]): [number, number, number];
+//# sourceMappingURL=rotation_transforms.d.ts.map

package/build/core/physics/items/rotation_transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotation_transforms.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/rotation_transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAgBpE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACrC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI1B"}

package/build/core/physics/items/rotation_transforms.js

@@ -0,0 +1,21 @@
+import { ROTATION } from '../../contracts/rotation_enum.js';
+const WIDTH = 0;
+const LENGTH = 1;
+const HEIGHT = 2;
+const ROTATION_DIM_INDEX = {
+    [ROTATION.POS1]: [WIDTH, LENGTH, HEIGHT],
+    [ROTATION.POS2]: [WIDTH, HEIGHT, LENGTH],
+    [ROTATION.POS3]: [HEIGHT, LENGTH, WIDTH],
+    [ROTATION.POS4]: [LENGTH, WIDTH, HEIGHT],
+    [ROTATION.POS5]: [HEIGHT, WIDTH, LENGTH],
+    [ROTATION.POS6]: [LENGTH, HEIGHT, WIDTH]
+};
+/**
+ * @param rotation - Rotation code.
+ * @param dimensions - [width, length, height].
+ * @returns Rotated [width, length, height].
+ */
+export function rotate_dimensions(rotation, dimensions) {
+    const index = ROTATION_DIM_INDEX[rotation];
+    return [dimensions[index[0]], dimensions[index[1]], dimensions[index[2]]];
+}

package/build/core/physics/models/axle_weight_model.d.ts

@@ -0,0 +1,32 @@
+import type { TransportRecord } from '../../contracts/transport_record.js';
+import { Transport } from '../transports/transport.js';
+import { CenterOfMass } from '../items/center_of_mass.js';
+import type { AllocatedItemManager } from '../items/allocated_item_manager.js';
+import { ChassiForces } from './chassi_forces.js';
+/**
+ * Dispatches to vehicle-specific axle weight models.
+ */
+export declare class AxleWeightModel {
+    private readonly model;
+    private readonly transport;
+    /**
+     * @param transport_or_data - Parsed transport or raw wire dict.
+     */
+    constructor(transport_or_data: Transport | TransportRecord);
+    /**
+     * @param center_of_mass_by_grouper - Precomputed CM per grouper.
+     * @returns Chassis force result.
+     */
+    calculate_chassi_forces_with_load_center_of_mass(center_of_mass_by_grouper: Record<number, CenterOfMass>): ChassiForces;
+    /**
+     * @param allocated_by_sequence - Items per container sequence index.
+     * @returns Loaded cargo per axle.
+     */
+    calculate_weight_on_axles(allocated_by_sequence: Record<number, AllocatedItemManager>): number[];
+    /**
+     * @param allocated_by_sequence - Items per container sequence index.
+     * @returns Utilization percentage per axle.
+     */
+    calculate_percentages_on_axles(allocated_by_sequence: Record<number, AllocatedItemManager>): number[];
+}
+//# sourceMappingURL=axle_weight_model.d.ts.map

package/build/core/physics/models/axle_weight_model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axle_weight_model.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/models/axle_weight_model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAMtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAYjD;;GAEG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IAErC;;OAEG;gBACS,iBAAiB,EAAE,SAAS,GAAG,eAAe;IAQ1D;;;OAGG;IACH,gDAAgD,CAC5C,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACxD,YAAY;IAMf;;;OAGG;IACH,yBAAyB,CACrB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC5D,MAAM,EAAE;IAMX;;;OAGG;IACH,8BAA8B,CAC1B,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC5D,MAAM,EAAE;CAMd"}