@aephia/atlas-kit 0.6.0-next.10 → 0.6.0-next.101

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-estimate.js","sourceRoot":"","sources":["../../src/fleets/warp-lane-estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAkC5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAiC;IAEjC,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAC3D,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,IAAI,GAAG,EAAE,EAC1D,WAAW,CACZ,CAAC;IACF,IAAI,kBAAkB,KAAK,EAAE;QAC3B,MAAM,IAAI,2BAA2B,CACnC,wBAAwB,EACxB,kBAAkB,EAClB,yMAAyM,CAC1M,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;QACvD,WAAW;QACX,eAAe,EACb,CAAC,kBAAkB,GAAG,aAAa,GAAG,EAAE,CAAC,GAAG,aAAa;QAC3D,SAAS,EAAE,EAAW;KACvB,CAAC,CACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,68 @@
+import type { FactionRegionData } from '../internal/c4/factions.js';
+import type { RiskZoneAccess } from '../internal/c4/character.js';
+import type { WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Explicit lane policy inputs; destinationRegion must contain the destination coordinates.
+ * A System's stored region id alone does not establish this spatial relationship.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLanePolicyInput;
+ * console.log(input.destinationRegion.risk, input.securityZoneAccess);
+ * ```
+ */
+export interface FleetWarpLanePolicyInput {
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly destinationLevel: WorldStarbaseLevel;
+    readonly crossFactionEconomicsEnabled: boolean;
+    readonly destinationRegion: Pick<FactionRegionData, 'owner' | 'safety' | 'risk'>;
+    readonly securityZoneAccess: RiskZoneAccess;
+}
+/** A bounded policy failure, not a simulation or transaction error.
+ * @example
+ * ```ts
+ * const reason: FleetWarpLanePolicyFailure = 'foreign-low-risk';
+ * ```
+ */
+export type FleetWarpLanePolicyFailure = 'source-level-zero' | 'destination-level-zero' | 'cross-faction-disabled' | 'foreign-low-risk' | 'security-zone-access';
+/** Policy result only: passing never proves travel eligibility or affordability.
+ * @example
+ * ```ts
+ * declare const assessment: FleetWarpLanePolicy;
+ * console.log(assessment.passesPolicy, assessment.failures);
+ * ```
+ */
+export interface FleetWarpLanePolicy {
+    readonly passesPolicy: boolean;
+    readonly failures: readonly FleetWarpLanePolicyFailure[];
+    readonly effectiveRisk: FactionRegionData['risk'];
+    toJSON(): unknown;
+}
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export declare function deriveFleetWarpLanePolicy(input: FleetWarpLanePolicyInput): FleetWarpLanePolicy;
+//# sourceMappingURL=warp-lane-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-policy.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAC9B,iBAAiB,EACjB,OAAO,GAAG,QAAQ,GAAG,MAAM,CAC5B,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,cAAc,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAClC,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA2ErB"}

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

@@ -0,0 +1,91 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export function deriveFleetWarpLanePolicy(input) {
+    const invalid = (field, value) => {
+        throw new InvalidDerivationInputError(field, value, 'Use current playable-faction ownership, known Starbase levels and the region containing the destination coordinates, with current Character access. Unknown or NPC policy is not qualified; refresh and simulate the lane Plan.');
+    };
+    const playable = (field, faction) => {
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    };
+    playable('Fleet faction', input.fleetFaction);
+    playable('Source owner', input.sourceOwner);
+    playable('Destination owner', input.destinationOwner);
+    playable('Destination region owner', input.destinationRegion.owner);
+    const levels = [
+        'level-0',
+        'level-1',
+        'level-2',
+        'level-3',
+        'level-4',
+        'level-5',
+        'css',
+    ];
+    if (!levels.includes(input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    if (!levels.includes(input.destinationLevel))
+        invalid('Destination Starbase level', input.destinationLevel);
+    if (typeof input.crossFactionEconomicsEnabled !== 'boolean')
+        invalid('Cross-faction flag type', typeof input.crossFactionEconomicsEnabled);
+    const { risk, safety, owner } = input.destinationRegion;
+    if (safety !== 'safe' && safety !== 'border')
+        invalid('Region safety', safety);
+    const kind = risk.kind;
+    if (kind !== 'low' && kind !== 'medium' && kind !== 'high')
+        invalid('Region risk', kind);
+    if (risk.kind === 'low')
+        playable('Low-risk faction', risk.faction);
+    const tiers = { low: 0, medium: 1, high: 2 };
+    if (!Object.hasOwn(tiers, input.securityZoneAccess))
+        invalid('Character security-zone access', input.securityZoneAccess);
+    const effectiveRisk = Object.freeze(risk.kind === 'low'
+        ? { ...risk }
+        : safety === 'safe'
+            ? { kind: 'low', faction: owner }
+            : { ...risk });
+    const failures = [];
+    if (input.sourceLevel === 'level-0')
+        failures.push('source-level-zero');
+    if (input.destinationLevel === 'level-0')
+        failures.push('destination-level-zero');
+    if (!input.crossFactionEconomicsEnabled &&
+        (input.sourceOwner !== input.fleetFaction ||
+            input.destinationOwner !== input.fleetFaction))
+        failures.push('cross-faction-disabled');
+    if (effectiveRisk.kind === 'low' &&
+        effectiveRisk.faction !== input.fleetFaction)
+        failures.push('foreign-low-risk');
+    if (tiers[effectiveRisk.kind] > tiers[input.securityZoneAccess])
+        failures.push('security-zone-access');
+    return Object.freeze(attachJsonSerialization({
+        passesPolicy: failures.length === 0,
+        failures: Object.freeze(failures),
+        effectiveRisk,
+    }));
+}
+//# sourceMappingURL=warp-lane-policy.js.map

package/dist/fleets/warp-lane-policy.js.map

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

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

@@ -0,0 +1,55 @@
+import type { FactionRelationship } from '../internal/c4/factions.js';
+import type { WorldConnectionCosts, WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Current source connection costs, ownership and Character fee modifier.
+ * destinationRelationship is Fleet-to-destination-owner, not endpoint-to-endpoint.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * console.log(input.sourceLevel, input.feeModifierRaw);
+ * ```
+ */
+export interface FleetWarpLaneTollInput {
+    readonly costs: Pick<WorldConnectionCosts, 'level1Raw' | 'level2Raw' | 'level3Raw' | 'level4Raw' | 'level5Raw' | 'cssRaw'>;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly destinationRelationship: FactionRelationship;
+    readonly feeModifierRaw: bigint;
+    readonly alliedTollBps: number;
+    readonly neutralTollBps: number;
+}
+/** Character's prospective ATLAS debit, entirely in raw ATLAS units (Floyds).
+ * @example
+ * ```ts
+ * declare const toll: FleetWarpLaneToll;
+ * console.log(toll.modifiedBaseRaw, toll.surchargeRaw, toll.totalRaw);
+ * ```
+ */
+export interface FleetWarpLaneToll {
+    readonly baseRaw: bigint;
+    readonly modifiedBaseRaw: bigint;
+    readonly surchargeRaw: bigint;
+    readonly totalRaw: bigint;
+    toJSON(): unknown;
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export declare function deriveFleetWarpLaneToll(input: FleetWarpLaneTollInput): FleetWarpLaneToll;
+//# sourceMappingURL=warp-lane-toll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-toll.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-toll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAClB,oBAAoB,EAClB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,QAAQ,CACX,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC;CACnB;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CAyDnB"}

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

@@ -0,0 +1,79 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+const amountMax = (1n << 64n) - 1n;
+const modifierScale = 1n << 32n;
+const remedy = 'Refresh the source connection, source Starbase level, playable Fleet/Starbase factions, Fleet-to-destination relationship, fee modifier and toll basis points. Only qualified nonnegative values and a u64 ATLAS debit are supported; simulate the lane Plan before signing.';
+function invalid(field, value) {
+    throw new InvalidDerivationInputError(field, value, remedy);
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export function deriveFleetWarpLaneToll(input) {
+    for (const [field, faction] of [
+        ['Fleet faction', input.fleetFaction],
+        ['Source owner', input.sourceOwner],
+        ['Destination owner', input.destinationOwner],
+    ])
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    const levelKeys = {
+        'level-1': 'level1Raw',
+        'level-2': 'level2Raw',
+        'level-3': 'level3Raw',
+        'level-4': 'level4Raw',
+        'level-5': 'level5Raw',
+        css: 'cssRaw',
+    };
+    if (!Object.hasOwn(levelKeys, input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    const baseRaw = input.costs[levelKeys[input.sourceLevel]];
+    if (baseRaw < 0n || baseRaw > amountMax)
+        invalid('Base ATLAS toll raw', baseRaw);
+    if (input.feeModifierRaw < 0n || input.feeModifierRaw > (1n << 63n) - 1n)
+        invalid('Character lane fee modifier raw', input.feeModifierRaw);
+    for (const [field, bps] of [
+        ['Allied toll bps', input.alliedTollBps],
+        ['Neutral toll bps', input.neutralTollBps],
+    ])
+        if (!Number.isInteger(bps) || bps < 0 || bps > 65535)
+            invalid(field, bps);
+    const relation = input.destinationRelationship;
+    if (relation !== 'allied' &&
+        relation !== 'neutral' &&
+        relation !== 'hostile' &&
+        relation !== 'ceasefire')
+        invalid('Destination relationship', relation);
+    const crossFaction = input.sourceOwner !== input.fleetFaction ||
+        input.destinationOwner !== input.fleetFaction;
+    const bps = input.destinationOwner !== input.fleetFaction && relation === 'allied'
+        ? input.alliedTollBps
+        : input.neutralTollBps;
+    const modifiedBaseRaw = (baseRaw * input.feeModifierRaw + modifierScale - 1n) / modifierScale;
+    const surchargeRaw = crossFaction ? (baseRaw * BigInt(bps)) / 10000n : 0n;
+    const totalRaw = modifiedBaseRaw + surchargeRaw;
+    if (totalRaw > amountMax)
+        invalid('Total ATLAS toll raw', totalRaw);
+    return Object.freeze(attachJsonSerialization({
+        baseRaw,
+        modifiedBaseRaw,
+        surchargeRaw,
+        totalRaw,
+    }));
+}
+//# sourceMappingURL=warp-lane-toll.js.map

package/dist/fleets/warp-lane-toll.js.map

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

package/dist/identity/actions/create-profile.d.ts

@@ -34,6 +34,8 @@ export interface PlanCreateProfileOptions {
 /** Plans a new signer-created Profile with explicit scoped permissions.
  * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
  * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
  * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
  * Existing target accounts and a Profile address equal to its funder are rejected.
  * No Game load, onboarding, funding top-up, key generation or signing is implicit.

package/dist/identity/actions/create-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-profile.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAkID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}
+{"version":3,"file":"create-profile.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAyID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/identity/actions/create-profile.js

@@ -30,26 +30,27 @@ function options(input) {
         invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
     const seen = new Set();
     const keys = [];
-    for (const value of raw.keys) {
-        const key = record(value, 'options.keys[]', [
+    for (const [index, value] of raw.keys.entries()) {
+        const path = `options.keys[${index}]`;
+        const key = record(value, path, [
             'address',
             'scope',
             'permissionsRaw',
             'expiresAt',
         ]);
-        const address = validAddress(key.address, 'key.address', false);
-        const scope = validAddress(key.scope, 'key.scope', false);
+        const address = validAddress(key.address, `${path}.address`, false);
+        const scope = validAddress(key.scope, `${path}.scope`, false);
         const permissionsRaw = key.permissionsRaw;
         if (typeof permissionsRaw !== 'bigint' ||
             permissionsRaw < 0n ||
             permissionsRaw > 0xffffffffffffffffn)
-            invalid('key.permissionsRaw', permissionsRaw, 'Supply an explicit bigint permission mask from 0n through 18446744073709551615n.');
+            invalid(`${path}.permissionsRaw`, permissionsRaw, 'Supply an explicit bigint permission mask from 0n through 18446744073709551615n.');
         const expiresAt = key.expiresAt;
         if (expiresAt !== undefined &&
             (typeof expiresAt !== 'bigint' ||
                 expiresAt < 0n ||
                 expiresAt > 0x7fffffffffffffffn))
-            invalid('key.expiresAt', expiresAt, 'Omit expiry for a permanent key, or supply nonnegative bigint Unix seconds within the signed 64-bit range.');
+            invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for a permanent key, or supply nonnegative bigint Unix seconds within the signed 64-bit range.');
         const captured = {
             address,
             scope,
@@ -57,17 +58,19 @@ function options(input) {
             ...(expiresAt === undefined ? {} : { expiresAt }),
         };
         if (isProfileCreationAuthority(captured)) {
-            validAddress(address, 'AUTH key.address', true);
+            validAddress(address, `${path}.address`, true);
             if (expiresAt !== undefined)
-                invalid('AUTH key.expiresAt', expiresAt, 'Omit expiry for every Player Profile AUTH key.');
+                invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for every Player Profile AUTH key.');
         }
         const identity = `${address}:${scope}`;
         if (seen.has(identity))
-            invalid('options.keys', address, 'Remove duplicate address/scope pairs; distinct scopes may reuse one key address.');
+            invalid(path, address, 'Remove duplicate address/scope pairs; distinct scopes may reuse one key address.');
         seen.add(identity);
         keys.push(captured);
     }
     const authCount = keys.filter(isProfileCreationAuthority).length;
+    if (authCount === 0)
+        invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
     const keyThreshold = raw.keyThreshold;
     if (typeof keyThreshold !== 'number' ||
         !Number.isInteger(keyThreshold) ||
@@ -80,6 +83,8 @@ function options(input) {
 /** Plans a new signer-created Profile with explicit scoped permissions.
  * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
  * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
  * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
  * Existing target accounts and a Profile address equal to its funder are rejected.
  * No Game load, onboarding, funding top-up, key generation or signing is implicit.