@aephia/atlas-kit 0.6.0-next.1 → 0.6.0-next.100

package/dist/fleets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fleets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAEZ,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAE1B,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EACV,eAAe,EACf,WAAW,EACX,wBAAwB,EACxB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,gBAAgB,EAChB,SAAS,GAAG,UAAU,CACvB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CACzC,wBAAwB,EACxB,cAAc,CACf;IACC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;CACtE;AAsED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAQpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAOnC;AAED,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fleets/index.ts"],"names":[],"mappings":"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"}

package/dist/fleets/index.js

@@ -1,5 +1,12 @@
-import { AccountDecodeError, ProviderError, SageSdkError, entityRef, } from '../client/index.js';
-import { assertCanonicalFleetAddress, discoverFleetAccounts, fleetAccountDefinition, } from '../internal/c4/fleet.js';
+export { deriveFleetWarpLanePolicy, } from './warp-lane-policy.js';
+export { deriveFleetWarpLaneToll, } from './warp-lane-toll.js';
+export { deriveFleetWarpLaneEstimate, } from './warp-lane-estimate.js';
+export { deriveFleetCoordinateWarpEstimate, } from './coordinate-warp-estimate.js';
+export { deriveFleetSubwarpEstimate, } from './subwarp-estimate.js';
+export { deriveFleetMovementCooldown, } from './cooldown.js';
+export { deriveFleetTravelProfile, } from './travel-profile.js';
+import { AccountDecodeError, AccountNotFoundError, ProviderError, SageSdkError, entityRef, } from '../client/index.js';
+import { assertCanonicalFleetAddress, discoverFleetAccounts, discoverFleetAccountsForGame, fleetAccountDefinition, } from '../internal/c4/fleet.js';
 import { deriveFleetTimers, interpolateSubwarpPosition, resolveFleetAccount, } from '../internal/fleet.js';
 import { attachJsonSerialization } from '../internal/json.js';
 import { requireGameAddress } from '../internal/game-context.js';
@@ -55,6 +62,30 @@ export async function getFleet(ctx, address, options) {
     const envelope = await ctx.data.read(fleetAccountDefinition, address, options);
     return toFleetSnapshot(ctx, envelope);
 }
+/** Reads required Fleets by account address in one batched data-plane request.
+ *
+ * The frozen result preserves input order and duplicate positions. Every
+ * requested address must exist; use separate optional reads when absence is an
+ * expected outcome.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const fleetAddresses: readonly Address[];
+ * const fleets = await getFleets(ctx, fleetAddresses);
+ * ```
+ */
+export async function getFleets(ctx, addresses, options) {
+    requireGameAddress(ctx);
+    const envelopes = await ctx.data.readMany(fleetAccountDefinition, addresses, options);
+    const requiredEnvelopes = envelopes.map((envelope, index) => {
+        if (envelope === undefined) {
+            throw new AccountNotFoundError('fleet', addresses[index]);
+        }
+        return envelope;
+    });
+    return Object.freeze(await Promise.all(requiredEnvelopes.map((envelope) => toFleetSnapshot(ctx, envelope))));
+}
 /** Reads an optional Fleet by account address.
  *
  * @example
@@ -121,5 +152,24 @@ export async function getFleetsByOwner(ctx, profileAddress, options) {
     const fleets = await Promise.all(envelopes.map((envelope) => toFleetSnapshot(ctx, envelope)));
     return Object.freeze(attachReadMeta(fleets, metadata));
 }
+/** Discovers every Fleet address for the configured Game.
+ *
+ * The existing discovery data plane downloads and validates complete Fleet
+ * account bytes before exposing an address. It does not hydrate Fleet
+ * snapshots or load ship, cargo, or Game registry definitions.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const fleetAddresses = await discoverFleetAddresses(ctx);
+ * console.log(fleetAddresses, readMeta(fleetAddresses)?.strategy);
+ * ```
+ */
+export async function discoverFleetAddresses(ctx, options) {
+    const envelopes = await discoverFleetAccountsForGame(ctx, options);
+    const metadata = readMeta(envelopes);
+    const addresses = envelopes.map(({ address }) => address);
+    return Object.freeze(attachReadMeta(addresses, metadata));
+}
 export { listShipConfigurations, listShipConfigurationsByMint, } from '../registry/index.js';
 //# sourceMappingURL=index.js.map

package/dist/fleets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fleets/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fleets/index.ts"],"names":[],"mappings":"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"}

package/dist/fleets/movement-arithmetic.d.ts

@@ -0,0 +1,21 @@
+interface MovementInput {
+    readonly fromRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly toRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly speedRaw: bigint;
+    readonly fuelRateRaw: bigint;
+    readonly speedModifierRaw: bigint;
+}
+export declare const movementScale: bigint;
+export declare function calculateMovement(input: MovementInput, kind: 'Subwarp' | 'Coordinate warp' | 'Warp lane'): {
+    distanceRaw: bigint;
+    durationSecondsRaw: bigint;
+    fuelExpenditureRaw: bigint;
+};
+export {};
+//# sourceMappingURL=movement-arithmetic.d.ts.map

package/dist/fleets/movement-arithmetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement-arithmetic.d.ts","sourceRoot":"","sources":["../../src/fleets/movement-arithmetic.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,aAAa,QAAY,CAAC;AA2BvC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,WAAW;;;;EAmDlD"}

package/dist/fleets/movement-arithmetic.js

@@ -0,0 +1,41 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+export const movementScale = 1n << 56n;
+const signedMax = (1n << 63n) - 1n;
+const unsignedMax = (1n << 32n) - 1n;
+const remedy = 'Use exact current coordinates and a positive movement speed within the documented bounds. Direct movement also requires a nonnegative Fuel rate and Character modifier; simulate the intended action before signing.';
+function bounded(field, value, min, max) {
+    if (value < min || value > max)
+        throw new InvalidDerivationInputError(field, value, remedy);
+    return value;
+}
+function squareRoot(value) {
+    if (value === 0n)
+        return 0n;
+    let root = value;
+    let next = (root + 1n) / 2n;
+    while (next < root) {
+        root = next;
+        next = (root + value / root) / 2n;
+    }
+    return root;
+}
+export function calculateMovement(input, kind) {
+    const min = -(1n << 63n);
+    for (const point of [input.fromRaw, input.toRaw]) {
+        bounded('Coordinate x raw', point.x, min, signedMax);
+        bounded('Coordinate y raw', point.y, min, signedMax);
+    }
+    const dx = bounded('Coordinate x difference raw', input.toRaw.x - input.fromRaw.x, -signedMax, signedMax);
+    const dy = bounded('Coordinate y difference raw', input.toRaw.y - input.fromRaw.y, -signedMax, signedMax);
+    if (dx === 0n && dy === 0n)
+        throw new InvalidDerivationInputError(`${kind} destination displacement`, 0n, remedy);
+    const speed = bounded(`${kind} speed raw`, input.speedRaw, 1n, unsignedMax);
+    const rate = bounded(`${kind} Fuel rate raw`, input.fuelRateRaw, 0n, unsignedMax);
+    const modifier = bounded(`Character ${kind} speed modifier raw`, input.speedModifierRaw, 0n, signedMax);
+    const distanceRaw = bounded(`${kind} distance raw`, squareRoot(((dx * dx) / movementScale + (dy * dy) / movementScale) * movementScale), 0n, signedMax);
+    const baseDuration = (distanceRaw * (1n << 16n)) / speed;
+    const durationSecondsRaw = (baseDuration * (1n << 32n)) / (modifier === 0n ? 1n << 32n : modifier);
+    const fuelExpenditureRaw = (distanceRaw * rate) / 64n;
+    return { distanceRaw, durationSecondsRaw, fuelExpenditureRaw };
+}
+//# sourceMappingURL=movement-arithmetic.js.map

package/dist/fleets/movement-arithmetic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement-arithmetic.js","sourceRoot":"","sources":["../../src/fleets/movement-arithmetic.ts"],"names":[],"mappings":"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"}

package/dist/fleets/subwarp-estimate.d.ts

@@ -0,0 +1,70 @@
+/** Raw inputs for an Idle Fleet's direct subwarp journey.
+ * Coordinates use signed I8F56, speed U16F16, Fuel rate U26F6 and the Character
+ * subwarp-speed modifier I32F32. Use the Fleet's exact stored locationRaw;
+ * reconstructing it from location display numbers loses precision.
+ * @example
+ * ```ts
+ * const input: FleetSubwarpEstimateInput = {
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
+ * };
+ * ```
+ */
+export interface FleetSubwarpEstimateInput {
+    readonly fromRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly toRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly speedRaw: bigint;
+    readonly fuelRateRaw: bigint;
+    readonly speedModifierRaw: bigint;
+}
+/** Prospective journey values; all three raw outputs have 56 fractional bits.
+ * Display numbers are approximate. fuelBudget rounds recorded expenditure up
+ * to whole Fuel units; it is not a measured settlement debit or travel approval.
+ * @example
+ * ```ts
+ * declare const estimate: FleetSubwarpEstimate;
+ * const budget: bigint = estimate.fuelBudget;
+ * console.log(estimate.durationSeconds, JSON.stringify(estimate));
+ * ```
+ */
+export interface FleetSubwarpEstimate {
+    readonly distanceAu: number;
+    readonly distanceRaw: bigint;
+    readonly durationSeconds: number;
+    readonly durationSecondsRaw: bigint;
+    readonly fuelExpenditure: number;
+    readonly fuelExpenditureRaw: bigint;
+    readonly fuelBudget: bigint;
+    toJSON(): unknown;
+}
+/** Estimates direct subwarp duration and recorded fractional Fuel expenditure.
+ * Qualified against PTR deployment slot 54356023, with exact integer rounding
+ * within the supported model. Each squared axis truncates before the square
+ * root; base-speed division precedes modifier division. Modifier zero means 1.
+ *
+ * Coordinates, axis differences and distance must fit signed I8F56; endpoints
+ * must differ. Speed is positive u32 raw, Fuel rate u32 raw and modifier
+ * nonnegative i64 raw. These bounds keep intermediate arithmetic within i128.
+ * Distinct tiny endpoints may truncate to zero distance, as the program does.
+ *
+ * Applies to departure from Idle, not planet departure, warp or lane travel.
+ * Does not check Fleet state, crew, permissions, tank Fuel, readiness or region
+ * restrictions. Subwarp may start with insufficient Fuel; compare fuelBudget
+ * with the tank and simulate before signing. No planet-exit surcharge or XP is
+ * predicted. Requalify this model after relevant program changes.
+ * @example
+ * ```ts
+ * const journey = deriveFleetSubwarpEstimate({
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
+ * }); // 1 second, budget 1 Fuel
+ * ```
+ */
+export declare function deriveFleetSubwarpEstimate(input: FleetSubwarpEstimateInput): FleetSubwarpEstimate;
+//# sourceMappingURL=subwarp-estimate.d.ts.map

package/dist/fleets/subwarp-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subwarp-estimate.d.ts","sourceRoot":"","sources":["../../src/fleets/subwarp-estimate.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,GAC/B,oBAAoB,CActB"}

package/dist/fleets/subwarp-estimate.js

@@ -0,0 +1,38 @@
+import { calculateMovement, movementScale as scale, } from './movement-arithmetic.js';
+import { attachJsonSerialization } from '../internal/json.js';
+/** Estimates direct subwarp duration and recorded fractional Fuel expenditure.
+ * Qualified against PTR deployment slot 54356023, with exact integer rounding
+ * within the supported model. Each squared axis truncates before the square
+ * root; base-speed division precedes modifier division. Modifier zero means 1.
+ *
+ * Coordinates, axis differences and distance must fit signed I8F56; endpoints
+ * must differ. Speed is positive u32 raw, Fuel rate u32 raw and modifier
+ * nonnegative i64 raw. These bounds keep intermediate arithmetic within i128.
+ * Distinct tiny endpoints may truncate to zero distance, as the program does.
+ *
+ * Applies to departure from Idle, not planet departure, warp or lane travel.
+ * Does not check Fleet state, crew, permissions, tank Fuel, readiness or region
+ * restrictions. Subwarp may start with insufficient Fuel; compare fuelBudget
+ * with the tank and simulate before signing. No planet-exit surcharge or XP is
+ * predicted. Requalify this model after relevant program changes.
+ * @example
+ * ```ts
+ * const journey = deriveFleetSubwarpEstimate({
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n, fuelRateRaw: 64n, speedModifierRaw: 4294967296n,
+ * }); // 1 second, budget 1 Fuel
+ * ```
+ */
+export function deriveFleetSubwarpEstimate(input) {
+    const { distanceRaw, durationSecondsRaw, fuelExpenditureRaw } = calculateMovement(input, 'Subwarp');
+    return Object.freeze(attachJsonSerialization({
+        distanceAu: Number(distanceRaw) / Number(scale),
+        distanceRaw,
+        durationSeconds: Number(durationSecondsRaw) / Number(scale),
+        durationSecondsRaw,
+        fuelExpenditure: Number(fuelExpenditureRaw) / Number(scale),
+        fuelExpenditureRaw,
+        fuelBudget: (fuelExpenditureRaw + scale - 1n) / scale,
+    }));
+}
+//# sourceMappingURL=subwarp-estimate.js.map

package/dist/fleets/subwarp-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subwarp-estimate.js","sourceRoot":"","sources":["../../src/fleets/subwarp-estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,IAAI,KAAK,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AA2C9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAgC;IAEhC,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,GAC3D,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC/C,WAAW;QACX,eAAe,EAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3D,kBAAkB;QAClB,eAAe,EAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3D,kBAAkB;QAClB,UAAU,EAAE,CAAC,kBAAkB,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,KAAK;KACtD,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/fleets/travel-profile.d.ts

@@ -0,0 +1,102 @@
+import type { FleetCargoStatsData, FleetCombatStatsData, FleetMovementStatsData } from '../internal/c4/fleet.js';
+/** Stats read by the travel profile: a Fleet's `stats` or a ship configuration's
+ * `stats`, which equal a one-ship Fleet's. Character modifiers are raw I32F32
+ * values; omitted or zero modifiers are neutral, as in the movement estimates.
+ * @example
+ * ```ts
+ * declare const ship: { readonly stats: FleetTravelProfileInput['stats'] };
+ * const input: FleetTravelProfileInput = { stats: ship.stats };
+ * ```
+ */
+export interface FleetTravelProfileInput {
+    readonly stats: {
+        readonly movement: Pick<FleetMovementStatsData, 'subwarpSpeed' | 'subwarpFuelConsumptionRate' | 'warpSpeed' | 'warpFuelConsumptionRate' | 'maxWarpDistance' | 'warpCoolDownSeconds' | 'warpLaneSpeed'>;
+        readonly cargo: Pick<FleetCargoStatsData, 'fuelCapacity'>;
+        readonly combat: Pick<FleetCombatStatsData, 'warpSpoolTimeSeconds'>;
+    };
+    readonly subwarpSpeedModifierRaw?: bigint;
+    readonly warpSpeedModifierRaw?: bigint;
+    readonly warpCooldownModifierRaw?: bigint;
+}
+/** Reference travel values per AU, per maximum-range warp and per full tank.
+ * Each section is null when its speed (or warp range) is zero. Whole seconds
+ * and whole Fuel are bigint, as in the movement estimates; ratios are numbers.
+ * A null full-tank value means that movement mode burns no Fuel.
+ * @example
+ * ```ts
+ * declare const profile: FleetTravelProfile;
+ * console.log(profile.subwarp?.fullTankRangeAu, JSON.stringify(profile));
+ * ```
+ */
+export interface FleetTravelProfile {
+    readonly subwarp: {
+        /** Seconds to subwarp exactly one AU. */
+        readonly secondsPerAu: number;
+        /** Fractional Fuel expenditure recorded for one AU. */
+        readonly fuelPerAu: number;
+        /** Subwarp distance whose Fuel expenditure equals a full tank. */
+        readonly fullTankRangeAu: number | null;
+        /** Seconds to subwarp the full-tank range. */
+        readonly fullTankSeconds: number | null;
+    } | null;
+    readonly coordinateWarp: {
+        /** Maximum coordinate-warp distance, in AU. */
+        readonly maxJumpAu: number;
+        /** Whole seconds for one maximum-range warp, including spool. */
+        readonly maxJumpSeconds: bigint;
+        /** Whole Fuel debited for one maximum-range warp. */
+        readonly maxJumpFuel: bigint;
+        /** Whole seconds of warp cooldown assigned at arrival. */
+        readonly cooldownSeconds: bigint;
+        /** Seconds from one maximum-range departure to the next: jump plus cooldown. */
+        readonly cycleSeconds: bigint;
+        /** AU per hour when chaining maximum-range warps as cooldown allows. */
+        readonly sustainedAuPerHour: number;
+        /** Maximum-range warp debits that fit in a full tank. */
+        readonly maxJumpsPerFullTank: bigint | null;
+        /** Distance covered by those warps. */
+        readonly fullTankRangeAu: number | null;
+    } | null;
+    readonly warpLane: {
+        /** Seconds per AU of lane; each hop rounds up to whole seconds. */
+        readonly secondsPerAu: number;
+    } | null;
+    toJSON(): unknown;
+}
+/** Derives reference travel values from Fleet or ship configuration stats,
+ * using the qualified subwarp, coordinate-warp, warp-lane and cooldown
+ * arithmetic (PTR deployment slot 54356023) on one-AU and maximum-range trips
+ * from Idle. Full-tank range inverts the qualified Fuel rate; sustained warp
+ * speed chains maximum-range warps, each waiting out the cooldown assigned at
+ * arrival.
+ *
+ * These are reference values, not a route or permission check: no planet
+ * departure, region policy, lane connectivity or toll, crew, XP, active timers
+ * or current tank are considered, and whether a warp may depart with less Fuel
+ * than its debit is not established. A configuration's stats describe one ship;
+ * stats of Fleets mixing configurations are not qualified here.
+ * @throws InvalidDerivationInputError for a maximum warp distance of 128 AU or
+ * more, or modifiers and stats outside the movement estimates' bounds.
+ * @example
+ * ```ts
+ * const profile = deriveFleetTravelProfile({
+ *   stats: {
+ *     movement: {
+ *       subwarpSpeed: { raw: 65536n, value: 1 },
+ *       subwarpFuelConsumptionRate: { raw: 64n, value: 1 },
+ *       warpSpeed: { raw: 65536n, value: 1 },
+ *       warpFuelConsumptionRate: { raw: 128n, value: 2 },
+ *       maxWarpDistance: { raw: 512n, value: 2 },
+ *       warpCoolDownSeconds: 6,
+ *       warpLaneSpeed: { raw: 131072n, value: 2 },
+ *     },
+ *     cargo: { fuelCapacity: 100n },
+ *     combat: { warpSpoolTimeSeconds: 2 },
+ *   },
+ * });
+ * console.log(profile.subwarp?.fullTankRangeAu); // 100
+ * console.log(profile.coordinateWarp?.cycleSeconds); // 10n: 2 spool + 2 travel + 6 cooldown
+ * ```
+ */
+export declare function deriveFleetTravelProfile(input: FleetTravelProfileInput): FleetTravelProfile;
+//# sourceMappingURL=travel-profile.d.ts.map

package/dist/fleets/travel-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel-profile.d.ts","sourceRoot":"","sources":["../../src/fleets/travel-profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAOjC;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,IAAI,CACrB,sBAAsB,EACpB,cAAc,GACd,4BAA4B,GAC5B,WAAW,GACX,yBAAyB,GACzB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,CAClB,CAAC;QACF,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;QAC1D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;KACrE,CAAC;IACF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE;QAChB,yCAAyC;QACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,uDAAuD;QACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,kEAAkE;QAClE,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,8CAA8C;QAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KACzC,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,cAAc,EAAE;QACvB,+CAA+C;QAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,iEAAiE;QACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,qDAAqD;QACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,0DAA0D;QAC1D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,gFAAgF;QAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,wEAAwE;QACxE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,yDAAyD;QACzD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5C,uCAAuC;QACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KACzC,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE;QACjB,mEAAmE;QACnE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,GAAG,IAAI,CAAC;IACT,MAAM,IAAI,OAAO,CAAC;CACnB;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CA6FpB"}

package/dist/fleets/travel-profile.js

@@ -0,0 +1,120 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+import { deriveFleetCoordinateWarpEstimate } from './coordinate-warp-estimate.js';
+import { deriveFleetMovementCooldown } from './cooldown.js';
+import { calculateMovement, movementScale } from './movement-arithmetic.js';
+const neutral = 1n << 32n;
+const origin = { x: 0n, y: 0n };
+const oneAu = { x: movementScale, y: 0n };
+// A maximum range of 128 AU or more cannot be placed inside the signed I8F56
+// coordinate span the movement arithmetic is qualified for.
+const maxProfiledRangeRaw = (1n << 15n) - 1n;
+/** Derives reference travel values from Fleet or ship configuration stats,
+ * using the qualified subwarp, coordinate-warp, warp-lane and cooldown
+ * arithmetic (PTR deployment slot 54356023) on one-AU and maximum-range trips
+ * from Idle. Full-tank range inverts the qualified Fuel rate; sustained warp
+ * speed chains maximum-range warps, each waiting out the cooldown assigned at
+ * arrival.
+ *
+ * These are reference values, not a route or permission check: no planet
+ * departure, region policy, lane connectivity or toll, crew, XP, active timers
+ * or current tank are considered, and whether a warp may depart with less Fuel
+ * than its debit is not established. A configuration's stats describe one ship;
+ * stats of Fleets mixing configurations are not qualified here.
+ * @throws InvalidDerivationInputError for a maximum warp distance of 128 AU or
+ * more, or modifiers and stats outside the movement estimates' bounds.
+ * @example
+ * ```ts
+ * const profile = deriveFleetTravelProfile({
+ *   stats: {
+ *     movement: {
+ *       subwarpSpeed: { raw: 65536n, value: 1 },
+ *       subwarpFuelConsumptionRate: { raw: 64n, value: 1 },
+ *       warpSpeed: { raw: 65536n, value: 1 },
+ *       warpFuelConsumptionRate: { raw: 128n, value: 2 },
+ *       maxWarpDistance: { raw: 512n, value: 2 },
+ *       warpCoolDownSeconds: 6,
+ *       warpLaneSpeed: { raw: 131072n, value: 2 },
+ *     },
+ *     cargo: { fuelCapacity: 100n },
+ *     combat: { warpSpoolTimeSeconds: 2 },
+ *   },
+ * });
+ * console.log(profile.subwarp?.fullTankRangeAu); // 100
+ * console.log(profile.coordinateWarp?.cycleSeconds); // 10n: 2 spool + 2 travel + 6 cooldown
+ * ```
+ */
+export function deriveFleetTravelProfile(input) {
+    const { movement, cargo, combat } = input.stats;
+    const fuelCapacity = cargo.fuelCapacity;
+    if (fuelCapacity < 0n)
+        throw new InvalidDerivationInputError('Fuel capacity', fuelCapacity, 'Use the Fleet or ship configuration fuelCapacity, a nonnegative whole number of Fuel.');
+    let subwarp = null;
+    if (movement.subwarpSpeed.raw !== 0n) {
+        const rateRaw = movement.subwarpFuelConsumptionRate.raw;
+        const { durationSecondsRaw, fuelExpenditureRaw } = calculateMovement({
+            fromRaw: origin,
+            toRaw: oneAu,
+            speedRaw: movement.subwarpSpeed.raw,
+            fuelRateRaw: rateRaw,
+            speedModifierRaw: input.subwarpSpeedModifierRaw ?? neutral,
+        }, 'Subwarp');
+        const secondsPerAu = Number(durationSecondsRaw) / Number(movementScale);
+        const fullTankRangeAu = rateRaw === 0n ? null : (Number(fuelCapacity) * 64) / Number(rateRaw);
+        subwarp = {
+            secondsPerAu,
+            fuelPerAu: Number(fuelExpenditureRaw) / Number(movementScale),
+            fullTankRangeAu,
+            fullTankSeconds: fullTankRangeAu === null ? null : fullTankRangeAu * secondsPerAu,
+        };
+    }
+    let coordinateWarp = null;
+    const rangeRaw = movement.maxWarpDistance.raw;
+    if (movement.warpSpeed.raw !== 0n && rangeRaw !== 0n) {
+        if (rangeRaw > maxProfiledRangeRaw)
+            throw new InvalidDerivationInputError('Maximum warp distance raw', rangeRaw, 'Travel profiles support maximum warp distances below 128 AU, the coordinate span the movement arithmetic is qualified for. Estimate a specific coordinate warp instead.');
+        const jump = deriveFleetCoordinateWarpEstimate({
+            fromRaw: origin,
+            toRaw: { x: rangeRaw << 48n, y: 0n },
+            speedRaw: movement.warpSpeed.raw,
+            fuelRateRaw: movement.warpFuelConsumptionRate.raw,
+            speedModifierRaw: input.warpSpeedModifierRaw ?? neutral,
+            spoolSeconds: combat.warpSpoolTimeSeconds,
+            maxWarpDistanceRaw: rangeRaw,
+        });
+        const cooldownSeconds = deriveFleetMovementCooldown({
+            kind: 'coordinateWarp',
+            arrivesAtUnixSeconds: 0n,
+            baseCooldownSeconds: movement.warpCoolDownSeconds,
+            cooldownModifierRaw: input.warpCooldownModifierRaw ?? neutral,
+        });
+        const cycleSeconds = jump.durationSeconds + cooldownSeconds;
+        const jumps = jump.fuelDebit === 0n ? null : fuelCapacity / jump.fuelDebit;
+        coordinateWarp = {
+            maxJumpAu: jump.distanceAu,
+            maxJumpSeconds: jump.durationSeconds,
+            maxJumpFuel: jump.fuelDebit,
+            cooldownSeconds,
+            cycleSeconds,
+            sustainedAuPerHour: (jump.distanceAu * 3600) / Number(cycleSeconds),
+            maxJumpsPerFullTank: jumps,
+            fullTankRangeAu: jumps === null ? null : Number(jumps) * jump.distanceAu,
+        };
+    }
+    let warpLane = null;
+    if (movement.warpLaneSpeed.raw !== 0n) {
+        const { durationSecondsRaw } = calculateMovement({
+            fromRaw: origin,
+            toRaw: oneAu,
+            speedRaw: movement.warpLaneSpeed.raw,
+            fuelRateRaw: 0n,
+            speedModifierRaw: neutral,
+        }, 'Warp lane');
+        warpLane = {
+            secondsPerAu: Number(durationSecondsRaw) / Number(movementScale),
+        };
+    }
+    return freezeResolvedSnapshot(attachJsonSerialization({ subwarp, coordinateWarp, warpLane }));
+}
+//# sourceMappingURL=travel-profile.js.map

package/dist/fleets/travel-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel-profile.js","sourceRoot":"","sources":["../../src/fleets/travel-profile.ts"],"names":[],"mappings":"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"}

package/dist/fleets/warp-lane-estimate.d.ts

@@ -0,0 +1,59 @@
+/** Exact System coordinates (I8F56) and Fleet lane speed (U16F16).
+ * No Character warp-speed modifier or spool time applies to lane travel.
+ * @example
+ * ```ts
+ * const input: FleetWarpLaneEstimateInput = {
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n,
+ * };
+ * ```
+ */
+export interface FleetWarpLaneEstimateInput {
+    readonly fromRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly toRaw: {
+        readonly x: bigint;
+        readonly y: bigint;
+    };
+    readonly speedRaw: bigint;
+}
+/** Whole-second lane duration and zero Fuel debit on the qualified deployment.
+ * Raw distance has 56 fractional bits; AU is approximate.
+ * @example
+ * ```ts
+ * declare const estimate: FleetWarpLaneEstimate;
+ * console.log(estimate.durationSeconds, estimate.fuelDebit);
+ * ```
+ */
+export interface FleetWarpLaneEstimate {
+    readonly distanceAu: number;
+    readonly distanceRaw: bigint;
+    readonly durationSeconds: bigint;
+    readonly fuelDebit: 0n;
+    toJSON(): unknown;
+}
+/** Estimates lane travel using empirically qualified deployment-54356023 arithmetic.
+ * Truncates each squared axis, computes distance, truncates fixed-point speed
+ * division and rounds duration upward to whole seconds. No Fuel is debited.
+ *
+ * Coordinates, axis differences and distance must fit signed I8F56. Speed is
+ * positive u32 raw. Identical and zero-quantized paths are rejected rather than
+ * predicting a successful zero-time lane. Unsupported overflow is rejected.
+ *
+ * Supply exact System coordinates and Fleet lane speed, not coordinate-warp
+ * stats. This checks no lane connection, policy, toll, affordability, cooldown,
+ * Fleet state, crew, XP or permissions. Use deriveFleetMovementCooldown for
+ * cooldown separately. Refresh and simulate the Plan before signing; requalify
+ * the arithmetic after relevant program changes.
+ * @example
+ * ```ts
+ * const estimate = deriveFleetWarpLaneEstimate({
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n,
+ * }); // durationSeconds: 1n, fuelDebit: 0n
+ * ```
+ */
+export declare function deriveFleetWarpLaneEstimate(input: FleetWarpLaneEstimateInput): FleetWarpLaneEstimate;
+//# sourceMappingURL=warp-lane-estimate.d.ts.map

package/dist/fleets/warp-lane-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-estimate.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-estimate.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CAoBvB"}

package/dist/fleets/warp-lane-estimate.js

@@ -0,0 +1,36 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { calculateMovement, movementScale } from './movement-arithmetic.js';
+/** Estimates lane travel using empirically qualified deployment-54356023 arithmetic.
+ * Truncates each squared axis, computes distance, truncates fixed-point speed
+ * division and rounds duration upward to whole seconds. No Fuel is debited.
+ *
+ * Coordinates, axis differences and distance must fit signed I8F56. Speed is
+ * positive u32 raw. Identical and zero-quantized paths are rejected rather than
+ * predicting a successful zero-time lane. Unsupported overflow is rejected.
+ *
+ * Supply exact System coordinates and Fleet lane speed, not coordinate-warp
+ * stats. This checks no lane connection, policy, toll, affordability, cooldown,
+ * Fleet state, crew, XP or permissions. Use deriveFleetMovementCooldown for
+ * cooldown separately. Refresh and simulate the Plan before signing; requalify
+ * the arithmetic after relevant program changes.
+ * @example
+ * ```ts
+ * const estimate = deriveFleetWarpLaneEstimate({
+ *   fromRaw: { x: 0n, y: 0n }, toRaw: { x: 1n << 56n, y: 0n },
+ *   speedRaw: 65536n,
+ * }); // durationSeconds: 1n, fuelDebit: 0n
+ * ```
+ */
+export function deriveFleetWarpLaneEstimate(input) {
+    const { distanceRaw, durationSecondsRaw } = calculateMovement({ ...input, fuelRateRaw: 0n, speedModifierRaw: 1n << 32n }, 'Warp lane');
+    if (durationSecondsRaw === 0n)
+        throw new InvalidDerivationInputError('Warp lane duration raw', durationSecondsRaw, 'Choose distinct connected Systems with a positive fixed-point travel duration; the program rejects a zero-time lane transition. Refresh the Systems and Fleet lane speed, then simulate before signing.');
+    return Object.freeze(attachJsonSerialization({
+        distanceAu: Number(distanceRaw) / Number(movementScale),
+        distanceRaw,
+        durationSeconds: (durationSecondsRaw + movementScale - 1n) / movementScale,
+        fuelDebit: 0n,
+    }));
+}
+//# sourceMappingURL=warp-lane-estimate.js.map