@shipload/sdk 1.0.0-next.7 → 1.0.0-next.8

package/lib/shipload.d.ts

@@ -1450,6 +1450,7 @@ declare const TRAVEL_MAX_DURATION = 86400;
 declare const MIN_ORBITAL_ALTITUDE = 800;
 declare const MAX_ORBITAL_ALTITUDE = 3000;
 declare const BASE_ORBITAL_MASS = 100000;
+declare const MIN_TRANSFER_DISTANCE = 100;
 interface ShipLike {
     coordinates: Types.coordinates;
     hullmass?: UInt32;
@@ -1497,7 +1498,7 @@ declare const EntityType$1: {
     readonly WAREHOUSE: Name;
     readonly CONTAINER: Name;
 };
-type EntityTypeName = (typeof EntityType$1)[keyof typeof EntityType$1];
+type EntityTypeName$1 = (typeof EntityType$1)[keyof typeof EntityType$1];
 type CoordinatesType = Coordinates | Types.coordinates | {
     x: Int64Type;
     y: Int64Type;
@@ -1913,20 +1914,20 @@ type EntityRefInput = {
 declare class ActionsManager extends BaseManager {
     travel(shipId: UInt64Type, destination: CoordinatesType, recharge?: boolean): Action;
     grouptravel(entities: EntityRefInput[], destination: CoordinatesType, recharge?: boolean): Action;
-    resolve(entityId: UInt64Type, entityType?: EntityTypeName, count?: UInt64Type): Action;
-    cancel(entityId: UInt64Type, count: UInt64Type, entityType?: EntityTypeName): Action;
-    recharge(entityId: UInt64Type, entityType?: EntityTypeName): Action;
-    transfer(sourceType: EntityTypeName, sourceId: UInt64Type, destType: EntityTypeName, destId: UInt64Type, items: ActionParams.Type.cargo_item[]): Action;
+    resolve(entityId: UInt64Type, entityType?: EntityTypeName$1, count?: UInt64Type): Action;
+    cancel(entityId: UInt64Type, count: UInt64Type, entityType?: EntityTypeName$1): Action;
+    recharge(entityId: UInt64Type, entityType?: EntityTypeName$1): Action;
+    transfer(sourceType: EntityTypeName$1, sourceId: UInt64Type, destType: EntityTypeName$1, destId: UInt64Type, items: ActionParams.Type.cargo_item[]): Action;
     foundCompany(account: NameType, name: string): Action;
     join(account: NameType): Action;
     gather(source: EntityRefInput, destination: EntityRefInput, stratum: UInt16Type, quantity: UInt32Type): Action;
-    warp(entityId: UInt64Type, destination: CoordinatesType, entityType?: EntityTypeName): Action;
-    craft(entityType: EntityTypeName, entityId: UInt64Type, recipeId: number, quantity: number, inputs: ActionParams.Type.cargo_item[]): Action;
-    blend(entityType: EntityTypeName, entityId: UInt64Type, inputs: ActionParams.Type.cargo_item[]): Action;
-    deploy(entityType: EntityTypeName, entityId: UInt64Type, ref: ActionParams.Type.cargo_ref): Action;
-    addmodule(entityType: EntityTypeName, entityId: UInt64Type, moduleIndex: number, moduleRef: ActionParams.Type.cargo_ref, targetRef?: ActionParams.Type.cargo_ref | null): Action;
-    rmmodule(entityType: EntityTypeName, entityId: UInt64Type, moduleIndex: number, targetRef?: ActionParams.Type.cargo_ref | null): Action;
-    wrap(owner: NameType, entityType: EntityTypeName, entityId: UInt64Type, items: ActionParams.Type.cargo_item[]): Action;
+    warp(entityId: UInt64Type, destination: CoordinatesType, entityType?: EntityTypeName$1): Action;
+    craft(entityType: EntityTypeName$1, entityId: UInt64Type, recipeId: number, quantity: number, inputs: ActionParams.Type.cargo_item[]): Action;
+    blend(entityType: EntityTypeName$1, entityId: UInt64Type, inputs: ActionParams.Type.cargo_item[]): Action;
+    deploy(entityType: EntityTypeName$1, entityId: UInt64Type, ref: ActionParams.Type.cargo_ref): Action;
+    addmodule(entityType: EntityTypeName$1, entityId: UInt64Type, moduleIndex: number, moduleRef: ActionParams.Type.cargo_ref, targetRef?: ActionParams.Type.cargo_ref | null): Action;
+    rmmodule(entityType: EntityTypeName$1, entityId: UInt64Type, moduleIndex: number, targetRef?: ActionParams.Type.cargo_ref | null): Action;
+    wrap(owner: NameType, entityType: EntityTypeName$1, entityId: UInt64Type, items: ActionParams.Type.cargo_item[]): Action;
     undeploy(host: EntityRefInput, target: EntityRefInput): Action;
     wrapEntity(entity: EntityRefInput): Action;
     demolish(entity: EntityRefInput): Action;
@@ -2764,6 +2765,7 @@ declare function getLocationTypeName(type: LocationType): string;
 declare function getSystemName(gameSeed: Checksum256Type, location: CoordinatesType): string;
 declare function hasSystem(gameSeed: Checksum256Type, coordinates: CoordinatesType): boolean;
 declare function deriveLocationStatic(gameSeed: Checksum256Type, coordinates: CoordinatesType): Types.location_static;
+declare function isLocationBuildable(gameSeed: Checksum256Type, coordinates: CoordinatesType): boolean;
 declare function deriveLocation(gameSeed: Checksum256Type, coordinates: CoordinatesType): Types.location_derived;
 
 declare function hash(seed: Checksum256Type, string: string): Checksum256;
@@ -2815,6 +2817,25 @@ declare function cargoItem(src: {
     modules?: Types.module_entry[];
 }, quantity: bigint | number): ActionParams.Type.cargo_item;
 
+type PredictedCargoTarget = {
+    kind: 'existing';
+    rowId: bigint;
+} | {
+    kind: 'new';
+    label: string;
+};
+interface PredictedCargoAddition {
+    item_id: number;
+    stats: bigint;
+    modules: Types.module_entry[];
+    quantity: number;
+    target: PredictedCargoTarget;
+}
+interface TaskCargoEffect {
+    additions: PredictedCargoAddition[];
+}
+declare function predictTaskCargoEffects(cargo: readonly Types.cargo_view[], tasks: readonly Types.task[]): TaskCargoEffect[];
+
 interface Entity {
     id: UInt64;
     type: Name;
@@ -2829,6 +2850,14 @@ type WarehouseEntity = Entity & StorageCapability & Partial<LoaderCapability> &
 type ContainerEntity = Entity & StorageCapability & MassCapability & ScheduleCapability;
 type AnyEntity = ShipEntity | WarehouseEntity | ContainerEntity;
 
+declare enum EntityClass {
+    OrbitalVessel = 0,
+    PlanetaryStructure = 1
+}
+declare function getEntityClass(entityType: Name | EntityTypeName): EntityClass;
+declare function getPackedEntityType(itemId: number): Name | null;
+type EntityTypeName = 'ship' | 'warehouse' | 'container';
+
 declare function canMove(e: Entity): e is Entity & MovementCapability & EnergyCapability;
 declare function hasEnergy(e: Entity): e is Entity & EnergyCapability;
 declare function hasStorage(e: Entity): e is Entity & StorageCapability;
@@ -3297,4 +3326,4 @@ type location_static = Types.location_static;
 type location_derived = Types.location_derived;
 type location_row = Types.location_row;
 
-export { AckMessage, ActionsManager, AnyEntity, BASE_ORBITAL_MASS, BLEND_INPUTS_MUST_MATCH, BLEND_REQUIRES_MULTIPLE, BLEND_STAT_LESS_NOT_SUPPORTED, BoundingBox, BoundsDeltaMessage, BoundsSubscriptionHandle, CANCEL_CONTAINS_GROUPED_TASK, CANCEL_PAIRED_HAS_PENDING, CATEGORY_LABELS, COMMIT_ALREADY_SET, COMMIT_CANNOT_MATCH, COMMIT_NOT_SET, COMPANY_NOT_FOUND, CONTAINER_CAPACITY_EXCEEDED, CONTAINER_NOT_FOUND, CONTAINER_Z, CRAFT_ENERGY_DIVISOR, CRAFT_EXCEEDS_ENERGY_CAPACITY, CRAFT_NOT_ENOUGH_ENERGY, CapabilityAttribute, CapabilityInput, CargoData, CargoMassInfo, CargoStack, CategoryIconShape, CategoryInfo, CategoryStacks, ClientMessage, ConnectionState, Container, ContainerEntity, ContainerStateInput, Coordinates, CoordinatesType, CraftedItemCategory, CrafterCapability, DEPLOY_ENTITY_HAS_SCHEDULE, DEPTH_THRESHOLD_T1, DEPTH_THRESHOLD_T2, DEPTH_THRESHOLD_T3, DEPTH_THRESHOLD_T4, DEPTH_THRESHOLD_T5, DESTINATION_CAPACITY_EXCEEDED, DerivedStratum, DescribeOptions, Distance, ENTITY_CAPACITY_EXCEEDED, ENTITY_NO_CRAFTER, EPOCH_NON_ZERO, EPOCH_NOT_READY, ERROR_SYSTEM_ALREADY_INITIALIZED, ERROR_SYSTEM_DISABLED, ERROR_SYSTEM_NOT_INITIALIZED, EnergyCapability, EntitiesManager, Entity, EntityCapabilities, EntityInfo, EntityInstance, EntityInventory, EntityLayout, EntityRefInput, EntitySlot, EntityState, EntitySubscriptionHandle, EntityType, EntityTypeName, EpochInfo, EpochsManager, ErrorMessage, EstimateTravelTimeOptions, EstimatedTravelTime, EventCatchupCompleteMessage, EventMessage, FloatPosition, GAME_NOT_FOUND, GAME_SEED_NOT_SET, GATHERER_DEPTH_MAX_TIER, GATHERER_DEPTH_TABLE, GATHER_EXCEEDS_ENERGY_CAPACITY, GATHER_NOT_ENOUGH_ENERGY, GROUP_DUPLICATE_ENTITY, GROUP_EMPTY, GROUP_ENTITY_NOT_MOVABLE, GROUP_HAUL_CAPACITY_EXCEEDED, GROUP_NOT_FOUND, GROUP_NOT_SAME_LOCATION, GROUP_NOT_SAME_OWNER, GROUP_NO_THRUST, GameState, GathererCapability, GathererDepthParams, HasCapacity, HasCargo, HasCargomass, HasScheduleAndLocation, INSUFFICIENT_BALANCE, INSUFFICIENT_ITEM_QUANTITY, INSUFFICIENT_ITEM_SUPPLY, INVALID_AMOUNT, ITEM_BIOMASS_T1, ITEM_BIOMASS_T10, ITEM_BIOMASS_T2, ITEM_BIOMASS_T3, ITEM_BIOMASS_T4, ITEM_BIOMASS_T5, ITEM_BIOMASS_T6, ITEM_BIOMASS_T7, ITEM_BIOMASS_T8, ITEM_BIOMASS_T9, ITEM_CARGO_ARM, ITEM_CARGO_LINING, ITEM_CARGO_LINING_T2, ITEM_CONTAINER_T1_PACKED, ITEM_CONTAINER_T2_PACKED, ITEM_CRAFTER_T1, ITEM_CRYSTAL_T1, ITEM_CRYSTAL_T10, ITEM_CRYSTAL_T2, ITEM_CRYSTAL_T3, ITEM_CRYSTAL_T4, ITEM_CRYSTAL_T5, ITEM_CRYSTAL_T6, ITEM_CRYSTAL_T7, ITEM_CRYSTAL_T8, ITEM_CRYSTAL_T9, ITEM_DOES_NOT_EXIST, ITEM_ENGINE_T1, ITEM_FOCUSING_ARRAY, ITEM_GAS_T1, ITEM_GAS_T10, ITEM_GAS_T2, ITEM_GAS_T3, ITEM_GAS_T4, ITEM_GAS_T5, ITEM_GAS_T6, ITEM_GAS_T7, ITEM_GAS_T8, ITEM_GAS_T9, ITEM_GATHERER_T1, ITEM_GENERATOR_T1, ITEM_HAULER_T1, ITEM_HULL_PLATES, ITEM_HULL_PLATES_T2, ITEM_LOADER_T1, ITEM_MATTER_CONDUIT, ITEM_NOT_AVAILABLE_AT_LOCATION, ITEM_NOT_DEPLOYABLE, ITEM_NOT_PACKED_ENTITY, ITEM_ORE_T1, ITEM_ORE_T10, ITEM_ORE_T2, ITEM_ORE_T3, ITEM_ORE_T4, ITEM_ORE_T5, ITEM_ORE_T6, ITEM_ORE_T7, ITEM_ORE_T8, ITEM_ORE_T9, ITEM_POWER_CELL, ITEM_REACTION_CHAMBER, ITEM_REGOLITH_T1, ITEM_REGOLITH_T10, ITEM_REGOLITH_T2, ITEM_REGOLITH_T3, ITEM_REGOLITH_T4, ITEM_REGOLITH_T5, ITEM_REGOLITH_T6, ITEM_REGOLITH_T7, ITEM_REGOLITH_T8, ITEM_REGOLITH_T9, ITEM_SHIP_T1_PACKED, ITEM_STORAGE_T1, ITEM_SURVEY_PROBE, ITEM_THRUSTER_CORE, ITEM_TOOL_BIT, ITEM_TYPE_COMPONENT, ITEM_TYPE_ENTITY, ITEM_TYPE_MODULE, ITEM_TYPE_RESOURCE, ITEM_WAREHOUSE_T1_PACKED, ITEM_WARP_T1, InventoryAccessor, Item, ItemType, LOCATION_MAX_DEPTH, LOCATION_MIN_DEPTH, LoadTimeBreakdown, LoaderCapability, Location, LocationStratum, LocationType, LocationsManager, MAX_ORBITAL_ALTITUDE, MIN_ORBITAL_ALTITUDE, MODULE_ANY, MODULE_CARGO_NOT_FOUND, MODULE_CRAFTER, MODULE_ENGINE, MODULE_ENTITY_BUSY, MODULE_GATHERER, MODULE_GENERATOR, MODULE_HAULER, MODULE_LAUNCHER, MODULE_LOADER, MODULE_NOT_MODULE, MODULE_SLOT_EMPTY, MODULE_SLOT_INVALID, MODULE_SLOT_OCCUPIED, MODULE_STORAGE, MODULE_TYPE_MISMATCH, MODULE_WARP, MassCapability, ModuleDescription, ModuleEntry, ModuleType, MovementCapability, index as NFT, NFTCargoItem, NFTCommonBase, NFTInstalledModule, NFTModuleSlot, NO_SCHEDULE, NamedStats, OwnerSubscriptionHandle, PLANET_SUBTYPE_GAS_GIANT, PLANET_SUBTYPE_ICY, PLANET_SUBTYPE_INDUSTRIAL, PLANET_SUBTYPE_OCEAN, PLANET_SUBTYPE_ROCKY, PLANET_SUBTYPE_TERRESTRIAL, PLAYER_ALREADY_JOINED, PLAYER_NOT_FOUND, PLAYER_NOT_JOINED, PRECISION, PackedModule, PackedModuleInput, PingMessage, PlanetSubtypeInfo, platform as PlatformContract, Types$1 as PlatformTypes, Player, PlayerStateInput, PlayersManager, PongMessage, Projectable, ProjectableSnapshot, ProjectedEntity, ProjectionOptions, RECIPE_INPUTS_EXCESS, RECIPE_INPUTS_INSUFFICIENT, RECIPE_INPUTS_INVALID, RECIPE_INPUTS_MIXED, RECIPE_NOT_FOUND, REQUIRES_MORE_THAN_ONE, REQUIRES_POSITIVE_VALUE, RESERVE_TIERS, RESOLVE_COUNT_EXCEEDS_COMPLETED, Recipe, RecipeInput, RecipeInputCategory, RecipeInputItemId, RecipeSlotInput, RenderDescriptionOptions, ReserveTier, ResolvedAttributeGroup, ResolvedItem, ResolvedItemStat, ResolvedItemType, ResolvedModuleSlot, ResourceCategory, ResourceStats, SHIP_ALREADY_THERE, SHIP_ALREADY_TRAVELING, SHIP_CANNOT_BUY_TRAVELING, SHIP_CANNOT_CANCEL_TASK, SHIP_CANNOT_UPDATE_TRAVELING, SHIP_CAPACITY_EXCEEDED, SHIP_CARGO_NOT_LOADED, SHIP_CARGO_NOT_OWNED, SHIP_INVALID_CARGO, SHIP_INVALID_DESTINATION, SHIP_INVALID_TRAVEL_DURATION, SHIP_NOT_ARRIVED, SHIP_NOT_ENOUGH_ENERGY, SHIP_NOT_ENOUGH_ENERGY_CAPACITY, SHIP_NOT_FOUND, SHIP_NOT_IDLE, SHIP_NOT_OWNED, SHIP_NO_COMPLETED_TASKS, SHIP_NO_TASKS_TO_CANCEL, SLOT_FORMULAS, STARTER_ALREADY_CLAIMED, ScheduleAccessor, ScheduleCapability, ScheduleData, Scheduleable, server as ServerContract, ServerMessage, Types as ServerTypes, Ship, ShipCapabilities, ShipEntity, ShipLike, ShipStateInput, Shipload, SlotConsumer, SlotConsumerKind, SnapshotMessage, StackInput, StatDefinition, StatMapping, StatSlot, StorageCapability, StratumInfo, SubscribeEntityMessage, SubscribeEventsMessage, SubscribeMessage, SubscriptionEntityType, SubscriptionsManager, SubscriptionsOptions, TIER_ADJECTIVES, TIER_ROLL_MAX, TRAVEL_MAX_DURATION, TaskCancelable, TaskType, TextSpan, TierRange, TransferEntity, UnsubscribeEntityMessage, UnsubscribeEventsMessage, UnsubscribeMessage, UpdateBoundsMessage, UpdateMessage, WAREHOUSE_ALREADY_AT_LOCATION, WAREHOUSE_CAPACITY_EXCEEDED, WAREHOUSE_NOT_FOUND, WAREHOUSE_Z, WARP_HAS_CARGO, WARP_HAS_SCHEDULE, WARP_NOT_FULL_ENERGY, WARP_NO_CAPABILITY, WARP_OUT_OF_RANGE, Warehouse, WarehouseEntity, WarehouseStateInput, WebSocketConnection, WebSocketConnectionOptions, WireCoordinates, WireEntity, availableCapacity$1 as availableCapacity, availableCapacityFromMass, blendCargoStacks, blendComponentStacks, blendCrossGroup, blendStacks, buildEntityDescription, calcCargoItemMass, calcCargoMass, calcEnergyUsage, calcLoadDuration, calcStacksMass, calc_acceleration, calc_craft_duration, calc_craft_energy, calc_energyusage, calc_flighttime, calc_gather_duration, calc_gather_energy, calc_loader_acceleration, calc_loader_flighttime, calc_orbital_altitude, calc_rechargetime, calc_ship_acceleration, calc_ship_flighttime, calc_ship_mass, calc_ship_rechargetime, calc_transfer_duration, calculateFlightTime, calculateLoadTimeBreakdown, calculateRefuelingTime, calculateTransferTime, canMove, capabilityAttributes, capabilityNames, capsHasCrafter, capsHasGatherer, capsHasHauler, capsHasLoaders, capsHasMass, capsHasMovement, capsHasStorage, cargoItem, cargoItemToStack, cargoRef, cargoUtils, cargo_item, categoryColors, categoryFromIndex, categoryIconShapes, categoryIcons, categoryLabel, categoryLabelFromIndex, componentIcon, computeBaseCapacityShip, computeBaseCapacityWarehouse, computeBaseHullmass, computeComponentStats, computeContainerCapabilities, computeContainerT2Capabilities, computeCraftedOutputStats, computeCrafterCapabilities, computeCrafterDrain, computeCrafterSpeed, computeEngineCapabilities, computeEngineDrain, computeEngineThrust, computeEntityStats, computeGathererCapabilities, computeGathererDepth, computeGathererDrain, computeGathererSpeed, computeGathererYield, computeGeneratorCap, computeGeneratorCapabilities, computeGeneratorRech, computeHaulPenalty, computeHaulerCapabilities, computeHaulerDrain$1 as computeHaulerDrain, computeInputMass, computeLoaderCapabilities, computeLoaderMass, computeLoaderThrust, computeShipCapabilities, computeShipHullCapabilities, computeStorageCapabilities, computeWarehouseCapabilities, computeWarehouseHullCapabilities, computeWarpRange, container_row, coordsToLocationId, createInventoryAccessor, createProjectedEntity, createScheduleAccessor, decodeCraftedItemStats, decodeStat, decodeStats, Shipload as default, deriveLocation, deriveLocationSize, deriveLocationStatic, deriveResourceStats, deriveStatMappings, deriveStrata, deriveStratum, describeItem, describeModule, describeModuleForItem, describeModuleForSlot, deserializeAsset, deserializeComponent, deserializeEntity, deserializeModule, deserializeResource, displayName, distanceBetweenCoordinates, distanceBetweenPoints, easeFlightProgress, encodeGatheredCargoStats, encodeStats, energyPercent, energy_stats, entityDisplayName, estimateDealTravelTime, estimateTravelTime, findItemByCategoryAndTier, findNearbyPlanets, flightSpeedFactor, formatMass, formatMassDelta, formatModuleLine, formatTier, gathererDepthForTier, gatherer_stats, getCapabilityAttributes, getCategoryInfo, getComponents, getCurrentEpoch, getDepthThreshold, getDestinationLocation, getEligibleResources, getEntityItems, getEntityLayout, getEpochInfo, getFlightOrigin, getInterpolatedPosition, getItem, getItems, getLocationCandidates, getLocationProfile, getLocationType, getLocationTypeName, getModuleCapabilityType, getModules, getPlanetSubtype, getPlanetSubtypes, getPositionAt, getRecipe, getResourceTier, getResourceWeight, getResources, getStatDefinitions, getStatMappings, getStatMappingsForCapability, getStatMappingsForStat, getStatName, getSystemName, hasEnergy, hasEnergyForDistance, hasGatherer, hasLoaders, hasMass, hasSchedule, hasSpace$1 as hasSpace, hasSpaceForMass, hasStorage, hasSystem, hash, hash512, interpolateFlightPosition, isCraftedItem, isFull$1 as isFull, isFullFromMass, isGatherableLocation, isInvertedAttribute, isModuleItem, isRelatedItem, isSubscriptionsDebugEnabled, itemAbbreviations, itemCategory, itemIds, itemOffset, itemTier, itemTypeCode, lerp, loader_stats, location_derived, location_row, location_static, makeContainer, makeShip, makeWarehouse, mapEntity, maxTravelDistance, mergeStacks, moduleAccepts, moduleDisplayName, moduleIcon, moduleSlotTypeToCode, movement_stats, needsRecharge, parseWireEntity, projectEntity, projectEntityAt, projectFromCurrentState, projectFromCurrentStateAt, readCommonBase, removeFromStacks, renderDescription, resolveItem, resolveItemCategory, resolveStats, rollTier, rollWithinTier, rotation, schedule, setSubscriptionsDebug, stackKey, stackToCargoItem, stacksEqual, task, tierAdjective, tierColors, toLocation, typeLabel, validateSchedule, warehouse_row };
+export { AckMessage, ActionsManager, AnyEntity, BASE_ORBITAL_MASS, BLEND_INPUTS_MUST_MATCH, BLEND_REQUIRES_MULTIPLE, BLEND_STAT_LESS_NOT_SUPPORTED, BoundingBox, BoundsDeltaMessage, BoundsSubscriptionHandle, CANCEL_CONTAINS_GROUPED_TASK, CANCEL_PAIRED_HAS_PENDING, CATEGORY_LABELS, COMMIT_ALREADY_SET, COMMIT_CANNOT_MATCH, COMMIT_NOT_SET, COMPANY_NOT_FOUND, CONTAINER_CAPACITY_EXCEEDED, CONTAINER_NOT_FOUND, CONTAINER_Z, CRAFT_ENERGY_DIVISOR, CRAFT_EXCEEDS_ENERGY_CAPACITY, CRAFT_NOT_ENOUGH_ENERGY, CapabilityAttribute, CapabilityInput, CargoData, CargoMassInfo, CargoStack, CategoryIconShape, CategoryInfo, CategoryStacks, ClientMessage, ConnectionState, Container, ContainerEntity, ContainerStateInput, Coordinates, CoordinatesType, CraftedItemCategory, CrafterCapability, DEPLOY_ENTITY_HAS_SCHEDULE, DEPTH_THRESHOLD_T1, DEPTH_THRESHOLD_T2, DEPTH_THRESHOLD_T3, DEPTH_THRESHOLD_T4, DEPTH_THRESHOLD_T5, DESTINATION_CAPACITY_EXCEEDED, DerivedStratum, DescribeOptions, Distance, ENTITY_CAPACITY_EXCEEDED, ENTITY_NO_CRAFTER, EPOCH_NON_ZERO, EPOCH_NOT_READY, ERROR_SYSTEM_ALREADY_INITIALIZED, ERROR_SYSTEM_DISABLED, ERROR_SYSTEM_NOT_INITIALIZED, EnergyCapability, EntitiesManager, Entity, EntityCapabilities, EntityClass, EntityInfo, EntityInstance, EntityInventory, EntityLayout, EntityRefInput, EntitySlot, EntityState, EntitySubscriptionHandle, EntityType, EntityTypeName$1 as EntityTypeName, EpochInfo, EpochsManager, ErrorMessage, EstimateTravelTimeOptions, EstimatedTravelTime, EventCatchupCompleteMessage, EventMessage, FloatPosition, GAME_NOT_FOUND, GAME_SEED_NOT_SET, GATHERER_DEPTH_MAX_TIER, GATHERER_DEPTH_TABLE, GATHER_EXCEEDS_ENERGY_CAPACITY, GATHER_NOT_ENOUGH_ENERGY, GROUP_DUPLICATE_ENTITY, GROUP_EMPTY, GROUP_ENTITY_NOT_MOVABLE, GROUP_HAUL_CAPACITY_EXCEEDED, GROUP_NOT_FOUND, GROUP_NOT_SAME_LOCATION, GROUP_NOT_SAME_OWNER, GROUP_NO_THRUST, GameState, GathererCapability, GathererDepthParams, HasCapacity, HasCargo, HasCargomass, HasScheduleAndLocation, INSUFFICIENT_BALANCE, INSUFFICIENT_ITEM_QUANTITY, INSUFFICIENT_ITEM_SUPPLY, INVALID_AMOUNT, ITEM_BIOMASS_T1, ITEM_BIOMASS_T10, ITEM_BIOMASS_T2, ITEM_BIOMASS_T3, ITEM_BIOMASS_T4, ITEM_BIOMASS_T5, ITEM_BIOMASS_T6, ITEM_BIOMASS_T7, ITEM_BIOMASS_T8, ITEM_BIOMASS_T9, ITEM_CARGO_ARM, ITEM_CARGO_LINING, ITEM_CARGO_LINING_T2, ITEM_CONTAINER_T1_PACKED, ITEM_CONTAINER_T2_PACKED, ITEM_CRAFTER_T1, ITEM_CRYSTAL_T1, ITEM_CRYSTAL_T10, ITEM_CRYSTAL_T2, ITEM_CRYSTAL_T3, ITEM_CRYSTAL_T4, ITEM_CRYSTAL_T5, ITEM_CRYSTAL_T6, ITEM_CRYSTAL_T7, ITEM_CRYSTAL_T8, ITEM_CRYSTAL_T9, ITEM_DOES_NOT_EXIST, ITEM_ENGINE_T1, ITEM_FOCUSING_ARRAY, ITEM_GAS_T1, ITEM_GAS_T10, ITEM_GAS_T2, ITEM_GAS_T3, ITEM_GAS_T4, ITEM_GAS_T5, ITEM_GAS_T6, ITEM_GAS_T7, ITEM_GAS_T8, ITEM_GAS_T9, ITEM_GATHERER_T1, ITEM_GENERATOR_T1, ITEM_HAULER_T1, ITEM_HULL_PLATES, ITEM_HULL_PLATES_T2, ITEM_LOADER_T1, ITEM_MATTER_CONDUIT, ITEM_NOT_AVAILABLE_AT_LOCATION, ITEM_NOT_DEPLOYABLE, ITEM_NOT_PACKED_ENTITY, ITEM_ORE_T1, ITEM_ORE_T10, ITEM_ORE_T2, ITEM_ORE_T3, ITEM_ORE_T4, ITEM_ORE_T5, ITEM_ORE_T6, ITEM_ORE_T7, ITEM_ORE_T8, ITEM_ORE_T9, ITEM_POWER_CELL, ITEM_REACTION_CHAMBER, ITEM_REGOLITH_T1, ITEM_REGOLITH_T10, ITEM_REGOLITH_T2, ITEM_REGOLITH_T3, ITEM_REGOLITH_T4, ITEM_REGOLITH_T5, ITEM_REGOLITH_T6, ITEM_REGOLITH_T7, ITEM_REGOLITH_T8, ITEM_REGOLITH_T9, ITEM_SHIP_T1_PACKED, ITEM_STORAGE_T1, ITEM_SURVEY_PROBE, ITEM_THRUSTER_CORE, ITEM_TOOL_BIT, ITEM_TYPE_COMPONENT, ITEM_TYPE_ENTITY, ITEM_TYPE_MODULE, ITEM_TYPE_RESOURCE, ITEM_WAREHOUSE_T1_PACKED, ITEM_WARP_T1, InventoryAccessor, Item, ItemType, LOCATION_MAX_DEPTH, LOCATION_MIN_DEPTH, LoadTimeBreakdown, LoaderCapability, Location, LocationStratum, LocationType, LocationsManager, MAX_ORBITAL_ALTITUDE, MIN_ORBITAL_ALTITUDE, MIN_TRANSFER_DISTANCE, MODULE_ANY, MODULE_CARGO_NOT_FOUND, MODULE_CRAFTER, MODULE_ENGINE, MODULE_ENTITY_BUSY, MODULE_GATHERER, MODULE_GENERATOR, MODULE_HAULER, MODULE_LAUNCHER, MODULE_LOADER, MODULE_NOT_MODULE, MODULE_SLOT_EMPTY, MODULE_SLOT_INVALID, MODULE_SLOT_OCCUPIED, MODULE_STORAGE, MODULE_TYPE_MISMATCH, MODULE_WARP, MassCapability, ModuleDescription, ModuleEntry, ModuleType, MovementCapability, index as NFT, NFTCargoItem, NFTCommonBase, NFTInstalledModule, NFTModuleSlot, NO_SCHEDULE, NamedStats, OwnerSubscriptionHandle, PLANET_SUBTYPE_GAS_GIANT, PLANET_SUBTYPE_ICY, PLANET_SUBTYPE_INDUSTRIAL, PLANET_SUBTYPE_OCEAN, PLANET_SUBTYPE_ROCKY, PLANET_SUBTYPE_TERRESTRIAL, PLAYER_ALREADY_JOINED, PLAYER_NOT_FOUND, PLAYER_NOT_JOINED, PRECISION, PackedModule, PackedModuleInput, PingMessage, PlanetSubtypeInfo, platform as PlatformContract, Types$1 as PlatformTypes, Player, PlayerStateInput, PlayersManager, PongMessage, PredictedCargoAddition, PredictedCargoTarget, Projectable, ProjectableSnapshot, ProjectedEntity, ProjectionOptions, RECIPE_INPUTS_EXCESS, RECIPE_INPUTS_INSUFFICIENT, RECIPE_INPUTS_INVALID, RECIPE_INPUTS_MIXED, RECIPE_NOT_FOUND, REQUIRES_MORE_THAN_ONE, REQUIRES_POSITIVE_VALUE, RESERVE_TIERS, RESOLVE_COUNT_EXCEEDS_COMPLETED, Recipe, RecipeInput, RecipeInputCategory, RecipeInputItemId, RecipeSlotInput, RenderDescriptionOptions, ReserveTier, ResolvedAttributeGroup, ResolvedItem, ResolvedItemStat, ResolvedItemType, ResolvedModuleSlot, ResourceCategory, ResourceStats, SHIP_ALREADY_THERE, SHIP_ALREADY_TRAVELING, SHIP_CANNOT_BUY_TRAVELING, SHIP_CANNOT_CANCEL_TASK, SHIP_CANNOT_UPDATE_TRAVELING, SHIP_CAPACITY_EXCEEDED, SHIP_CARGO_NOT_LOADED, SHIP_CARGO_NOT_OWNED, SHIP_INVALID_CARGO, SHIP_INVALID_DESTINATION, SHIP_INVALID_TRAVEL_DURATION, SHIP_NOT_ARRIVED, SHIP_NOT_ENOUGH_ENERGY, SHIP_NOT_ENOUGH_ENERGY_CAPACITY, SHIP_NOT_FOUND, SHIP_NOT_IDLE, SHIP_NOT_OWNED, SHIP_NO_COMPLETED_TASKS, SHIP_NO_TASKS_TO_CANCEL, SLOT_FORMULAS, STARTER_ALREADY_CLAIMED, ScheduleAccessor, ScheduleCapability, ScheduleData, Scheduleable, server as ServerContract, ServerMessage, Types as ServerTypes, Ship, ShipCapabilities, ShipEntity, ShipLike, ShipStateInput, Shipload, SlotConsumer, SlotConsumerKind, SnapshotMessage, StackInput, StatDefinition, StatMapping, StatSlot, StorageCapability, StratumInfo, SubscribeEntityMessage, SubscribeEventsMessage, SubscribeMessage, SubscriptionEntityType, SubscriptionsManager, SubscriptionsOptions, TIER_ADJECTIVES, TIER_ROLL_MAX, TRAVEL_MAX_DURATION, TaskCancelable, TaskCargoEffect, TaskType, TextSpan, TierRange, TransferEntity, UnsubscribeEntityMessage, UnsubscribeEventsMessage, UnsubscribeMessage, UpdateBoundsMessage, UpdateMessage, WAREHOUSE_ALREADY_AT_LOCATION, WAREHOUSE_CAPACITY_EXCEEDED, WAREHOUSE_NOT_FOUND, WAREHOUSE_Z, WARP_HAS_CARGO, WARP_HAS_SCHEDULE, WARP_NOT_FULL_ENERGY, WARP_NO_CAPABILITY, WARP_OUT_OF_RANGE, Warehouse, WarehouseEntity, WarehouseStateInput, WebSocketConnection, WebSocketConnectionOptions, WireCoordinates, WireEntity, availableCapacity$1 as availableCapacity, availableCapacityFromMass, blendCargoStacks, blendComponentStacks, blendCrossGroup, blendStacks, buildEntityDescription, calcCargoItemMass, calcCargoMass, calcEnergyUsage, calcLoadDuration, calcStacksMass, calc_acceleration, calc_craft_duration, calc_craft_energy, calc_energyusage, calc_flighttime, calc_gather_duration, calc_gather_energy, calc_loader_acceleration, calc_loader_flighttime, calc_orbital_altitude, calc_rechargetime, calc_ship_acceleration, calc_ship_flighttime, calc_ship_mass, calc_ship_rechargetime, calc_transfer_duration, calculateFlightTime, calculateLoadTimeBreakdown, calculateRefuelingTime, calculateTransferTime, canMove, capabilityAttributes, capabilityNames, capsHasCrafter, capsHasGatherer, capsHasHauler, capsHasLoaders, capsHasMass, capsHasMovement, capsHasStorage, cargoItem, cargoItemToStack, cargoRef, cargoUtils, cargo_item, categoryColors, categoryFromIndex, categoryIconShapes, categoryIcons, categoryLabel, categoryLabelFromIndex, componentIcon, computeBaseCapacityShip, computeBaseCapacityWarehouse, computeBaseHullmass, computeComponentStats, computeContainerCapabilities, computeContainerT2Capabilities, computeCraftedOutputStats, computeCrafterCapabilities, computeCrafterDrain, computeCrafterSpeed, computeEngineCapabilities, computeEngineDrain, computeEngineThrust, computeEntityStats, computeGathererCapabilities, computeGathererDepth, computeGathererDrain, computeGathererSpeed, computeGathererYield, computeGeneratorCap, computeGeneratorCapabilities, computeGeneratorRech, computeHaulPenalty, computeHaulerCapabilities, computeHaulerDrain$1 as computeHaulerDrain, computeInputMass, computeLoaderCapabilities, computeLoaderMass, computeLoaderThrust, computeShipCapabilities, computeShipHullCapabilities, computeStorageCapabilities, computeWarehouseCapabilities, computeWarehouseHullCapabilities, computeWarpRange, container_row, coordsToLocationId, createInventoryAccessor, createProjectedEntity, createScheduleAccessor, decodeCraftedItemStats, decodeStat, decodeStats, Shipload as default, deriveLocation, deriveLocationSize, deriveLocationStatic, deriveResourceStats, deriveStatMappings, deriveStrata, deriveStratum, describeItem, describeModule, describeModuleForItem, describeModuleForSlot, deserializeAsset, deserializeComponent, deserializeEntity, deserializeModule, deserializeResource, displayName, distanceBetweenCoordinates, distanceBetweenPoints, easeFlightProgress, encodeGatheredCargoStats, encodeStats, energyPercent, energy_stats, entityDisplayName, estimateDealTravelTime, estimateTravelTime, findItemByCategoryAndTier, findNearbyPlanets, flightSpeedFactor, formatMass, formatMassDelta, formatModuleLine, formatTier, gathererDepthForTier, gatherer_stats, getCapabilityAttributes, getCategoryInfo, getComponents, getCurrentEpoch, getDepthThreshold, getDestinationLocation, getEligibleResources, getEntityClass, getEntityItems, getEntityLayout, getEpochInfo, getFlightOrigin, getInterpolatedPosition, getItem, getItems, getLocationCandidates, getLocationProfile, getLocationType, getLocationTypeName, getModuleCapabilityType, getModules, getPackedEntityType, getPlanetSubtype, getPlanetSubtypes, getPositionAt, getRecipe, getResourceTier, getResourceWeight, getResources, getStatDefinitions, getStatMappings, getStatMappingsForCapability, getStatMappingsForStat, getStatName, getSystemName, hasEnergy, hasEnergyForDistance, hasGatherer, hasLoaders, hasMass, hasSchedule, hasSpace$1 as hasSpace, hasSpaceForMass, hasStorage, hasSystem, hash, hash512, interpolateFlightPosition, isCraftedItem, isFull$1 as isFull, isFullFromMass, isGatherableLocation, isInvertedAttribute, isLocationBuildable, isModuleItem, isRelatedItem, isSubscriptionsDebugEnabled, itemAbbreviations, itemCategory, itemIds, itemOffset, itemTier, itemTypeCode, lerp, loader_stats, location_derived, location_row, location_static, makeContainer, makeShip, makeWarehouse, mapEntity, maxTravelDistance, mergeStacks, moduleAccepts, moduleDisplayName, moduleIcon, moduleSlotTypeToCode, movement_stats, needsRecharge, parseWireEntity, predictTaskCargoEffects, projectEntity, projectEntityAt, projectFromCurrentState, projectFromCurrentStateAt, readCommonBase, removeFromStacks, renderDescription, resolveItem, resolveItemCategory, resolveStats, rollTier, rollWithinTier, rotation, schedule, setSubscriptionsDebug, stackKey, stackToCargoItem, stacksEqual, task, tierAdjective, tierColors, toLocation, typeLabel, validateSchedule, warehouse_row };

package/lib/shipload.js

@@ -2417,6 +2417,7 @@ const TRAVEL_MAX_DURATION = 86400;
 const MIN_ORBITAL_ALTITUDE = 800;
 const MAX_ORBITAL_ALTITUDE = 3000;
 const BASE_ORBITAL_MASS = 100000;
+const MIN_TRANSFER_DISTANCE = 100;
 exports.TaskType = void 0;
 (function (TaskType) {
     TaskType[TaskType["IDLE"] = 0] = "IDLE";
@@ -6896,6 +6897,9 @@ function deriveLocationStatic(gameSeed, coordinates) {
     loc.seed1 = antelope.UInt8.from(hashResult.array[4]);
     return loc;
 }
+function isLocationBuildable(gameSeed, coordinates) {
+    return getLocationType(gameSeed, coordinates) === exports.LocationType.PLANET;
+}
 function deriveLocation(gameSeed, coordinates) {
     const staticProps = deriveLocationStatic(gameSeed, coordinates);
     return exports.ServerTypes.location_derived.from({
@@ -7322,7 +7326,8 @@ function calc_transfer_duration(source, dest, cargoMass) {
         ? source.location.z
         : (source.location.z?.toNumber() ?? 0);
     const destZ = typeof dest.location.z === 'number' ? dest.location.z : (dest.location.z?.toNumber() ?? 0);
-    const distance = Math.abs(sourceZ - destZ);
+    const rawDistance = Math.abs(sourceZ - destZ);
+    const distance = rawDistance < MIN_TRANSFER_DISTANCE ? MIN_TRANSFER_DISTANCE : rawDistance;
     const totalMass = cargoMass + totalLoaderMass;
     const acceleration = calc_acceleration(totalThrust, totalMass);
     const flightTime = 2 * Math.sqrt(distance / acceleration);
@@ -10404,6 +10409,152 @@ function cargoItem(src, quantity) {
     };
 }
 
+function modulesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        const ai = a[i];
+        const bi = b[i];
+        if (Number(ai.type) !== Number(bi.type))
+            return false;
+        const aInst = ai.installed;
+        const bInst = bi.installed;
+        if (!aInst && !bInst)
+            continue;
+        if (!aInst || !bInst)
+            return false;
+        if (Number(aInst.item_id) !== Number(bInst.item_id))
+            return false;
+        if (BigInt(aInst.stats.toString()) !== BigInt(bInst.stats.toString()))
+            return false;
+    }
+    return true;
+}
+function findStack(state, item_id, stats, modules) {
+    for (let i = 0; i < state.length; i++) {
+        const s = state[i];
+        if (s.item_id !== item_id)
+            continue;
+        if (s.stats !== stats)
+            continue;
+        if (!modulesEqual(s.modules, modules))
+            continue;
+        return i;
+    }
+    return -1;
+}
+function applyAddition(state, item, nextNewLabel) {
+    const item_id = Number(item.item_id);
+    const stats = BigInt(item.stats.toString());
+    const modules = item.modules ?? [];
+    const quantity = Number(item.quantity);
+    const idx = findStack(state, item_id, stats, modules);
+    if (idx === -1) {
+        const target = { kind: 'new', label: nextNewLabel() };
+        state.push({ item_id, stats, modules, quantity, target });
+        return { item_id, stats, modules, quantity, target };
+    }
+    state[idx].quantity += quantity;
+    return { item_id, stats, modules, quantity, target: state[idx].target };
+}
+function applyRemoval(state, item) {
+    const item_id = Number(item.item_id);
+    const stats = BigInt(item.stats.toString());
+    const modules = item.modules ?? [];
+    const quantity = Number(item.quantity);
+    const idx = findStack(state, item_id, stats, modules);
+    if (idx === -1)
+        return;
+    state[idx].quantity -= quantity;
+    if (state[idx].quantity <= 0)
+        state.splice(idx, 1);
+}
+function predictTaskCargoEffects(cargo, tasks) {
+    const state = cargo.map((c) => ({
+        item_id: Number(c.item_id),
+        stats: BigInt(c.stats.toString()),
+        modules: c.modules ?? [],
+        quantity: Number(c.quantity),
+        target: { kind: 'existing', rowId: BigInt(c.id.toString()) },
+    }));
+    let newCounter = 0;
+    const nextNewLabel = () => {
+        newCounter += 1;
+        return `new#${newCounter}`;
+    };
+    const effects = [];
+    for (const task of tasks) {
+        const type = Number(task.type);
+        const items = task.cargo ?? [];
+        const additions = [];
+        switch (type) {
+            case exports.TaskType.LOAD:
+            case exports.TaskType.UNWRAP: {
+                for (const item of items)
+                    additions.push(applyAddition(state, item, nextNewLabel));
+                break;
+            }
+            case exports.TaskType.GATHER: {
+                if (!task.entitytarget) {
+                    for (const item of items)
+                        additions.push(applyAddition(state, item, nextNewLabel));
+                }
+                break;
+            }
+            case exports.TaskType.UNLOAD:
+            case exports.TaskType.WRAP: {
+                for (const item of items)
+                    applyRemoval(state, item);
+                break;
+            }
+            case exports.TaskType.CRAFT: {
+                if (items.length > 0) {
+                    for (let i = 0; i < items.length - 1; i++)
+                        applyRemoval(state, items[i]);
+                    additions.push(applyAddition(state, items[items.length - 1], nextNewLabel));
+                }
+                break;
+            }
+        }
+        effects.push({ additions });
+    }
+    return effects;
+}
+
+const ENTITY_SHIP = antelope.Name.from('ship');
+const ENTITY_WAREHOUSE = antelope.Name.from('warehouse');
+const ENTITY_CONTAINER = antelope.Name.from('container');
+exports.EntityClass = void 0;
+(function (EntityClass) {
+    EntityClass[EntityClass["OrbitalVessel"] = 0] = "OrbitalVessel";
+    EntityClass[EntityClass["PlanetaryStructure"] = 1] = "PlanetaryStructure";
+})(exports.EntityClass || (exports.EntityClass = {}));
+function getEntityClass(entityType) {
+    const typeName = typeof entityType === 'string' ? entityType : entityType.toString();
+    switch (typeName) {
+        case 'ship':
+        case 'container':
+            return exports.EntityClass.OrbitalVessel;
+        case 'warehouse':
+            return exports.EntityClass.PlanetaryStructure;
+        default:
+            throw new Error(`Entity type has no class: ${typeName}`);
+    }
+}
+function getPackedEntityType(itemId) {
+    switch (itemId) {
+        case ITEM_SHIP_T1_PACKED:
+            return ENTITY_SHIP;
+        case ITEM_CONTAINER_T1_PACKED:
+        case ITEM_CONTAINER_T2_PACKED:
+            return ENTITY_CONTAINER;
+        case ITEM_WAREHOUSE_T1_PACKED:
+            return ENTITY_WAREHOUSE;
+        default:
+            return null;
+    }
+}
+
 function canMove(e) {
     return 'engines' in e && 'generator' in e && 'energy' in e;
 }
@@ -11675,6 +11826,7 @@ exports.Location = Location;
 exports.LocationsManager = LocationsManager;
 exports.MAX_ORBITAL_ALTITUDE = MAX_ORBITAL_ALTITUDE;
 exports.MIN_ORBITAL_ALTITUDE = MIN_ORBITAL_ALTITUDE;
+exports.MIN_TRANSFER_DISTANCE = MIN_TRANSFER_DISTANCE;
 exports.MODULE_ANY = MODULE_ANY;
 exports.MODULE_CARGO_NOT_FOUND = MODULE_CARGO_NOT_FOUND;
 exports.MODULE_CRAFTER = MODULE_CRAFTER;
@@ -11893,6 +12045,7 @@ exports.getCurrentEpoch = getCurrentEpoch;
 exports.getDepthThreshold = getDepthThreshold;
 exports.getDestinationLocation = getDestinationLocation;
 exports.getEligibleResources = getEligibleResources;
+exports.getEntityClass = getEntityClass;
 exports.getEntityItems = getEntityItems;
 exports.getEntityLayout = getEntityLayout;
 exports.getEpochInfo = getEpochInfo;
@@ -11906,6 +12059,7 @@ exports.getLocationType = getLocationType;
 exports.getLocationTypeName = getLocationTypeName;
 exports.getModuleCapabilityType = getModuleCapabilityType;
 exports.getModules = getModules;
+exports.getPackedEntityType = getPackedEntityType;
 exports.getPlanetSubtype = getPlanetSubtype;
 exports.getPlanetSubtypes = getPlanetSubtypes;
 exports.getPositionAt = getPositionAt;
@@ -11937,6 +12091,7 @@ exports.isFull = isFull$1;
 exports.isFullFromMass = isFullFromMass;
 exports.isGatherableLocation = isGatherableLocation;
 exports.isInvertedAttribute = isInvertedAttribute;
+exports.isLocationBuildable = isLocationBuildable;
 exports.isModuleItem = isModuleItem;
 exports.isRelatedItem = isRelatedItem;
 exports.isSubscriptionsDebugEnabled = isSubscriptionsDebugEnabled;
@@ -11959,6 +12114,7 @@ exports.moduleIcon = moduleIcon;
 exports.moduleSlotTypeToCode = moduleSlotTypeToCode;
 exports.needsRecharge = needsRecharge;
 exports.parseWireEntity = parseWireEntity;
+exports.predictTaskCargoEffects = predictTaskCargoEffects;
 exports.projectEntity = projectEntity;
 exports.projectEntityAt = projectEntityAt;
 exports.projectFromCurrentState = projectFromCurrentState;