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

package/src/index-module.ts

@@ -8,31 +8,43 @@ export * from './data/recipes-runtime'
 // Preserves both value and type sides through rollup-plugin-dts bundling.
 export {Types as ServerTypes} from './contracts/server'
 export {Types as PlatformTypes} from './contracts/platform'
+export {Types as FundTypes} from './contracts/fund'
 
 import type {ServerContract} from './contracts'
+import type {Entity as EntityType} from './entities/entity'
 
 export {Shipload} from './shipload'
-export {Ship} from './entities/ship'
-export type {ShipStateInput, PackedModuleInput} from './entities/ship'
-export {Warehouse, computeWarehouseCapabilities} from './entities/warehouse'
-export type {WarehouseStateInput} from './entities/warehouse'
-export {Container} from './entities/container'
-export type {ContainerStateInput} from './entities/container'
-export {makeShip, makeWarehouse, makeContainer} from './entities/makers'
+export {Entity} from './entities/entity'
+export type Ship = EntityType
+export type Warehouse = EntityType
+export type Container = EntityType
+export type Extractor = EntityType
+export type Factory = EntityType
+export type Nexus = EntityType
+export {makeEntity} from './entities/makers'
+export type {EntityStateInput, PackedModuleInput} from './entities/makers'
+export type {InstalledModule} from './entities/slot-multiplier'
 
 export type movement_stats = ServerContract.Types.movement_stats
 export type energy_stats = ServerContract.Types.energy_stats
-export type loader_stats = ServerContract.Types.loader_stats
 export type schedule = ServerContract.Types.schedule
+export type lane = ServerContract.Types.lane
 export type task = ServerContract.Types.task
+export type coupling = ServerContract.Types.coupling
 export type cargo_item = ServerContract.Types.cargo_item
-export type warehouse_row = ServerContract.Types.warehouse_row
-export type container_row = ServerContract.Types.container_row
-export type gatherer_stats = ServerContract.Types.gatherer_stats
+export type entity_row = ServerContract.Types.entity_row
+export type craftjob_row = ServerContract.Types.craftjob_row
+export type buildjob_row = ServerContract.Types.buildjob_row
+export type booking_receipt = ServerContract.Types.booking_receipt
+export {
+    decodeBookingReceipt,
+    bookingReceiptLandsAtMs,
+    bookingReceiptRuntimeSeconds,
+} from './receipts'
+export type {BookingReceipt} from './receipts'
 
 export type location_static = ServerContract.Types.location_static
 export type location_derived = ServerContract.Types.location_derived
-export type location_row = ServerContract.Types.location_row
 export {Player} from './entities/player'
 export type {PlayerStateInput} from './entities/player'
 export {EntityInventory} from './entities/entity-inventory'
@@ -45,19 +57,68 @@ export {
     LocationsManager,
     EpochsManager,
     ActionsManager,
+    ClusterManager,
+    computeFreeCells,
+    NftManager,
+    BalancesManager,
+    ConstructionManager,
+    JobsManager,
+    InfluenceManager,
+} from './managers'
+export type {GridCell, ClusterCell, Cluster} from './managers'
+export type {
+    CharterProgress,
+    ContributePreview,
+    ContributePreviewRow,
+    FoundedWorld,
+    FoundedWorldRef,
+    InfluenceStanding,
+    Ballot,
+    BallotVote,
+    NodeProgress,
+    QueuedSeat,
+    VoteOption,
+    VoteStandings,
+    PlayerRosterEntry,
+    LocationStratum,
+    NftConfigForItem,
+    WrapConfig,
+    WrapGate,
+    DepositConfig,
+    PlatformBalance,
+    TokenBalance,
+    BuildableTarget,
+    BuildState,
+    SourceEntityRef,
+    SourceCargoStack,
+    FinalizerEntityRef,
+    FinalizerCapability,
+    InboundTransfer,
+    ScheduledBuild,
+    Reservation,
 } from './managers'
-export type {EntityType, LocationStratum} from './managers'
-export type {EntityRefInput} from './managers/actions'
+export type {
+    EntityRefInput,
+    LaunchNumericInput,
+    LaunchQuote,
+    LaunchQuoteCatcher,
+    LaunchQuoteLauncher,
+    LaunchStatsInput,
+} from './managers/actions'
+export type {WrapDeposit} from './managers/nft'
+export {resolveLockedAmount, wrapCostKey} from './managers/nft'
 
 export {
     getItem,
     getItems,
+    tryGetItem,
     itemIds,
     getResources,
     getComponents,
     getModules,
     getEntityItems,
     resolveItemCategory,
+    itemTypeIndex,
     typeLabel,
     categoryLabel,
     categoryFromIndex,
@@ -68,9 +129,11 @@ export type {EpochInfo} from './scheduling/epoch'
 export {
     getSystemName,
     hasSystem,
+    getLocationKind,
     getLocationType,
     getLocationTypeName,
     isGatherableLocation,
+    isLocationBuildable,
     deriveLocationStatic,
     deriveLocation,
 } from './utils/system'
@@ -93,6 +156,9 @@ export {
     DEPTH_THRESHOLD_T5,
     LOCATION_MIN_DEPTH,
     LOCATION_MAX_DEPTH,
+    yieldThresholdAt,
+    YIELD_FRACTION_SHALLOW,
+    YIELD_FRACTION_DEEP,
     PLANET_SUBTYPE_GAS_GIANT,
     PLANET_SUBTYPE_ROCKY,
     PLANET_SUBTYPE_TERRESTRIAL,
@@ -103,13 +169,39 @@ export {
 
 export type {StratumInfo, ResourceStats, DerivedStratum} from './derivation'
 
-export {RESERVE_TIERS, TIER_ROLL_MAX, rollTier, rollWithinTier} from './derivation'
+export {
+    RESERVE_TIERS,
+    TIER_ROLL_MAX,
+    tierOfReserve,
+    rollTier,
+    rollWithinTier,
+    RESOURCE_TIER_MULT_TENTHS,
+    applyResourceTierMultiplier,
+} from './derivation'
 export type {ReserveTier, TierRange} from './derivation'
 
+export {getEffectiveReserve} from './derivation'
+export type {EffectiveReserveInput} from './derivation'
+
+export {eligibleUpgrades} from './derivation'
+
 export {getStatDefinitions, getStatName, resolveStats} from './derivation'
 export type {StatDefinition, NamedStats} from './derivation'
 
+export {
+    STAR_STEP,
+    MAX_STARS_PER_STAT,
+    MAX_STAR_RATING,
+    starsForStat,
+    starRating,
+    statMagnitude,
+    compareByStars,
+} from './derivation'
+export type {StarSortable} from './derivation'
+
 export {hash, hash512} from './utils/hash'
+export {validateDisplayName, normalizeDisplayName} from './utils/display-name'
+export type {DisplayNameResult, ValidateDisplayNameOptions} from './utils/display-name'
 
 export {
     distanceBetweenCoordinates,
@@ -118,8 +210,11 @@ export {
     calc_acceleration,
     calc_energyusage,
     calc_flighttime,
+    calc_travel_flighttime,
+    calc_group_flighttime,
     calc_loader_acceleration,
     calc_loader_flighttime,
+    calc_onesided_duration,
     calc_orbital_altitude,
     calc_rechargetime,
     calc_ship_acceleration,
@@ -127,6 +222,7 @@ export {
     calc_ship_mass,
     calc_ship_rechargetime,
     calc_transfer_duration,
+    calc_transit_duration,
     calculateFlightTime,
     calculateLoadTimeBreakdown,
     calculateRefuelingTime,
@@ -153,8 +249,60 @@ export type {
     HasScheduleAndLocation,
 } from './travel/travel'
 
+export {planRoute, sdkSystemGraph, MAX_LEGS} from './travel/route-planner'
+export type {
+    Coord,
+    Neighbor,
+    SystemGraph,
+    ScanProvider,
+    RoutePlan,
+    RouteFailure,
+    RouteResult,
+    RouteFailureReason,
+    PlanRouteParams,
+    RouteLegInput,
+    RouteLegCost,
+    RouteHeuristicCost,
+} from './travel/route-planner'
+
+export {computePerLegReach, computeGroupPerLegReach} from './travel/reach'
+export type {ReachStats} from './travel/reach'
+
+export {simulateRoute} from './travel/route-simulator'
+export type {RouteMoverInput, RouteLegSim, RouteSim} from './travel/route-simulator'
+
+export {
+    planRouteWithRetry,
+    contractRouteLegCost,
+    contractRouteHeuristic,
+} from './travel/route-build'
+
 export * as schedule from './scheduling/schedule'
-export type {Scheduleable, ScheduleData} from './scheduling/schedule'
+export {LANE_MOBILITY, LANE_BARRIER} from './scheduling/schedule'
+export {appliedTaskCount, unappliedTasks} from './scheduling/schedule'
+export type {
+    AnchoredScheduleData,
+    ScheduleData,
+    LaneView,
+    OrderedTask,
+    ResolvedEvent,
+} from './scheduling/schedule'
+export {
+    candidateLaneCompletesAt,
+    laneKeyForModule,
+    rawScheduleEnd,
+    resolveLaneGatherer,
+    resolveLaneCrafter,
+    resolveLaneBuilder,
+    resolveLaneLoader,
+    selectGatherLane,
+    workerLaneKey,
+} from './scheduling/lanes'
+export type {
+    ResolvedGathererLane,
+    ResolvedCrafterLane,
+    ResolvedLoaderLane,
+} from './scheduling/lanes'
 export {ScheduleAccessor, createScheduleAccessor} from './scheduling/accessor'
 export {InventoryAccessor, createInventoryAccessor} from './entities/inventory-accessor'
 export type {HasCargo} from './entities/inventory-accessor'
@@ -168,31 +316,125 @@ export {
     createProjectedEntity,
     projectEntity,
     projectEntityAt,
-    projectFromCurrentState,
-    projectFromCurrentStateAt,
+    projectRemainingAt,
     validateSchedule,
 } from './scheduling/projection'
 export type {
     Projectable,
-    ProjectableSnapshot,
     ProjectedEntity,
     ProjectionOptions,
 } from './scheduling/projection'
 
+export {taskCargoChanges, taskCargoChangesChecked} from './scheduling/task-cargo'
+export type {TaskCargoChange, TaskCargoDirection, TaskCargoResult} from './scheduling/task-cargo'
+
+export {
+    jobsToLanes,
+    pickFabricator,
+    socketTail,
+    JOB_QUEUE_CAP,
+    jobStatus,
+    jobStatusLabel,
+    jobDeposited,
+    splitJobCargo,
+} from './scheduling/jobs'
+export type {JobWindow, JobLane, JobLaneEntry, JobStatus, OwnedJob} from './scheduling/jobs'
+
+export {composeIdleResolve} from './scheduling/idle-resolve'
+export type {CounterpartLookup, IdleResolveTarget} from './scheduling/idle-resolve'
+
+export {cancelEligibility, CancelBlockReason} from './scheduling/cancel'
+export type {
+    CancelPlan,
+    CancelEffects,
+    CancelRefund,
+    CancelReleasedHold,
+    CancelEligibilityInput,
+} from './scheduling/cancel'
+
+export {
+    derivedLoaders,
+    estimateUnwrapDuration,
+    incomingHoldMass,
+    projectedPeakCargomass,
+    receiveFits,
+    unwrapLoadDuration,
+    unwrapTransitDuration,
+} from './scheduling/unwrap'
+export type {DerivedLoaders, UnwrapDestination, UnwrapItem} from './scheduling/unwrap'
+
+export {
+    projectedCargoAvailableAt,
+    availableForItem,
+    cargoReadyAt,
+    taskCargoEffect,
+    calcCounterpartDelivery,
+    incomingSources,
+    cargoKey,
+    cargoInputKey,
+    hasSourceCoupling,
+    hasIncomingCoupling,
+} from './scheduling/availability'
+export type {CargoInput, IncomingHoldEntity, IncomingSource} from './scheduling/availability'
+
+export {clusterStockAvailable} from './scheduling/cluster-stock'
+
+export {calcClusterIntake, calcClustercraftDuration, INTAKE_RATE} from './capabilities/crafting'
+
+export {maxCraftable} from './capabilities/craftable'
+
+export {energyAtTime} from './scheduling/energy'
+
 export * from './types/capabilities'
 export * from './types/entity'
+export {
+    EntityClass,
+    ENTITY_SHIP,
+    ENTITY_WAREHOUSE,
+    ENTITY_EXTRACTOR,
+    ENTITY_FACTORY,
+    ENTITY_CONSTRUCTION_DOCK,
+    ENTITY_WORKSHOP,
+    ENTITY_CONTAINER,
+    ENTITY_NEXUS,
+    ENTITY_HUB,
+    ENTITY_DEPOT,
+    getEntityClass,
+    getPackedEntityType,
+    getKindMeta,
+    getTemplateMeta,
+    kindCan,
+    ALL_ENTITY_TYPES,
+    CAP_WRAP,
+    CAP_UNDEPLOY,
+    CAP_DEMOLISH,
+    CAP_MODULES,
+    CAP_CATCH,
+    CAP_STORE_CARGO,
+    canCatch,
+    canStoreCargo,
+    isShip,
+    isWarehouse,
+    isExtractor,
+    isFactory,
+    isConstructionDock,
+    isWorkshop,
+    isContainer,
+    isNexus,
+    isPlot,
+    isHub,
+    isDepot,
+} from './data/kind-registry'
+export type {EntityTypeName, KindMeta, TemplateMeta} from './data/kind-registry'
 export * from './capabilities'
 
 export {
     categoryColors,
     tierColors,
-    categoryIcons,
-    categoryIconShapes,
     componentIcon,
     moduleIcon,
     itemAbbreviations,
 } from './data/colors'
-export type {CategoryIconShape} from './data/colors'
 
 export {itemTier, itemOffset, itemCategory, isRelatedItem, isCraftedItem} from './data/tiers'
 export type {CraftedItemCategory} from './data/tiers'
@@ -209,16 +451,26 @@ export {
     isInvertedAttribute,
     getCapabilityAttributes,
 } from './data/capabilities'
-export type {CapabilityAttribute, StatMapping} from './data/capabilities'
+export type {CapabilityAttribute, StatMapping, CapabilityAttributeRow} from './data/capabilities'
 
 export {
     deriveStatMappings,
     getStatMappings,
     getStatMappingsForStat,
     getStatMappingsForCapability,
+    getProducersForAttribute,
+    getCapabilityAttributeRows,
+    sourceLabelForOutput,
 } from './derivation/capability-mappings'
 export {SLOT_FORMULAS} from './data/capability-formulas'
 export type {SlotConsumer, SlotConsumerKind} from './data/capability-formulas'
+export {
+    getAllRecipes,
+    getRecipeConsumers,
+    getComponentDemand,
+    getResourceDemand,
+} from './derivation/recipe-usage'
+export type {StatFlow, RecipeConsumer, DemandRow, ResourceDemand} from './derivation/recipe-usage'
 
 export {
     encodeStats,
@@ -226,6 +478,7 @@ export {
     decodeStat,
     decodeStats,
     decodeCraftedItemStats,
+    usedInputStatKeys,
     blendStacks,
     computeComponentStats,
     blendComponentStacks,
@@ -237,7 +490,15 @@ export {
 } from './derivation/crafting'
 export type {StackInput, CategoryStacks, RecipeSlotInput} from './derivation/crafting'
 
-export {computeContainerCapabilities, computeContainerT2Capabilities} from './entities/container'
+export {
+    availableBuildMethods,
+    isBuildable,
+    isPlotBuildable,
+    filterByBuildMethod,
+    allBuildableItems,
+    allPlotBuildableItems,
+} from './derivation/build-methods'
+export type {BuildMethod} from './derivation/build-methods'
 
 export {
     computeShipHullCapabilities,
@@ -247,14 +508,45 @@ export {
     computeHaulerCapabilities,
     computeLoaderCapabilities,
     computeCrafterCapabilities,
+    computeBuilderCapabilities,
     computeWarehouseHullCapabilities,
+    computeDepotHullCapabilities,
     computeStorageCapabilities,
-    computeShipCapabilities,
+    computeBatteryCapabilities,
+    computeContainerCapabilities,
+    computeWarpCapabilities,
+    computeLauncherCapabilities,
+    computeBaseCapacity,
+    computeEntityCapabilities,
+    getBaseHullmassFor,
+    DEFAULT_BASE_HULLMASS,
+    CAPACITY_TIER_TABLE,
+    capacityTierMultiplier,
+    applyCapacityTier,
     GATHERER_DEPTH_TABLE,
     GATHERER_DEPTH_MAX_TIER,
     gathererDepthForTier,
-} from './entities/ship-deploy'
-export type {ShipCapabilities, GathererDepthParams} from './entities/ship-deploy'
+    computeGathererYield,
+} from './derivation/capabilities'
+export type {
+    GathererDepthParams,
+    ComputedCapabilities,
+    TravelDrainBreakdown,
+} from './derivation/capabilities'
+
+export {
+    WH,
+    feistel,
+    feistelInv,
+    regionOf,
+    partnerRegion,
+    nearbyWormholes,
+    wormholeAt,
+    wormholeAtRegionEndpoint,
+    isValidWormholePair,
+} from './derivation/wormhole'
+
+export {rollupGatherer, rollupCrafter, rollupBuilder, rollupLoaders} from './derivation/rollups'
 
 export {resolveItem} from './resolution/resolve-item'
 export type {
@@ -294,6 +586,44 @@ export type {
     NFTCommonBase,
 } from './nft/deserializers'
 
+export {deserializeAtomicData} from './nft/atomicdata'
+export type {SchemaField, RawData} from './nft/atomicdata'
+
+export {
+    buildImmutableData,
+    buildResourceImmutable,
+    buildComponentImmutable,
+    buildModuleImmutable,
+    buildEntityImmutable,
+    computeNftImageUrl,
+} from './nft/buildImmutableData'
+export type {
+    AtomicAttributeType,
+    ImmutableEntry,
+    ImmutableModuleSlot,
+} from './nft/buildImmutableData'
+
+export {
+    fetchAtomicAssetsForOwner,
+    fetchAtomicSchemas,
+    decodeAtomicAsset,
+    buildMintAssetAction,
+    ATOMICASSETS_ACCOUNT,
+    SHIPLOAD_COLLECTION,
+} from './nft/atomicassets'
+export {
+    MODULE_STAT_SCALING_ANCHOR,
+    MODULE_STAT_SCALING_POST_ANCHOR_PERCENT,
+    computeEffectiveModuleStat,
+} from './derivation/stat-scaling'
+export type {
+    AtomicAssetRow,
+    AtomicSchemaRow,
+    DecodedAtomicAsset,
+    FetchAssetsOptions,
+    MintAssetParams,
+} from './nft/atomicassets'
+
 export {
     buildEntityDescription,
     formatModuleLine,
@@ -302,18 +632,26 @@ export {
     computeBaseHullmass,
     computeBaseCapacityShip,
     computeBaseCapacityWarehouse,
+    computeBaseCapacityDepot,
+    computeBaseCapacityContainer,
     computeEngineThrust,
     computeEngineDrain,
+    computeTravelDrain,
+    ENGINE_DRAIN_BASE,
+    ENGINE_DRAIN_REF_THRUST,
+    ENGINE_DRAIN_REF_THM,
     computeGeneratorCap,
     computeGeneratorRech,
-    computeGathererYield,
     computeGathererDrain,
     computeGathererDepth,
-    computeGathererSpeed,
     computeLoaderMass,
     computeLoaderThrust,
     computeCrafterSpeed,
     computeCrafterDrain,
+    computeBuilderSpeed,
+    computeBuilderDrain,
+    computeHaulerCapacity,
+    computeHaulerEfficiency,
     computeWarpRange,
 } from './nft/description'
 
@@ -325,9 +663,50 @@ export {
     itemTypeCode,
 } from './data/tiers'
 
-export {formatMass, formatMassDelta} from './format'
-
-export {displayName, describeItem} from './resolution/display-name'
+export {
+    formatInfluence,
+    formatLocation,
+    formatMass,
+    formatMassDelta,
+    formatMassScaled,
+    formatNeedMultiplier,
+} from './format'
+export * from './coordinates'
+
+export {displayName, baseName, describeItem} from './resolution/display-name'
 export type {DescribeOptions} from './resolution/display-name'
 
 export * from './subscriptions'
+
+export {
+    allocateProportional,
+    buildGatherPlan,
+    gatherEnergyCost,
+    maxQtyForCharge,
+    planParallelTransfer,
+    planSingleGather,
+    splitCost,
+} from './planner'
+export type {
+    BuildGatherPlanOpts,
+    FillCap,
+    GatherCycle,
+    GatherLane,
+    GatherLimpet,
+    GatherPlan,
+    GatherPlanEntity,
+    LanePlanEntry,
+    PlanTarget,
+    SingleGatherInput,
+    SingleGatherPlan,
+} from './planner'
+
+export {entityToRouteMover, hydrateEntityLanes} from './entity/hydrate'
+export type {
+    GathererLaneSource,
+    RouteMoverCaps,
+    RouteMoverOpts,
+    RouteMoverRow,
+} from './entity/hydrate'
+
+export * from './influence'