@aephia/atlas-kit 0.6.0-next.99 → 0.7.0-next.1

package/dist/world/index.js

@@ -2,23 +2,15 @@ import { AccountDecodeError, entityRef, } from '../client/index.js';
 import { buildStarSystemDiscoveryFilters, buildCelestialBodyDiscoveryFilters, celestialBodyAccountDefinition, deriveCelestialBodyAddress, deriveStarSystemAddress, starSystemAccountDefinition, } from '../internal/c4/world.js';
 import { attachJsonSerialization } from '../internal/json.js';
 import { requireGameAddress } from '../internal/game-context.js';
-import { attachReadMeta, readMeta } from '../internal/read-meta.js';
+import { attachReadMeta, envelopeMeta, readMeta, } from '../internal/read-meta.js';
 import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
 import { resolveCargo, } from '../registry/index.js';
 import { createPlanetClaimStakePlotsSnapshot, } from './planet-claim-stake-plots.js';
 import { createStarbaseStatusSnapshot, } from './starbase-status.js';
 export { claimStakeTierIndex } from './planet-claim-stake-plots.js';
-export { deriveStarbaseStatus, starbaseLevelIndex } from './starbase-status.js';
+export { deriveStarbaseStatus, projectStarbasePoints, starbaseLevelIndex, } from './starbase-status.js';
 const STAR_SYSTEM_SNAPSHOTS = new WeakMap();
 const CELESTIAL_BODY_SNAPSHOTS = new WeakMap();
-function directMetadata(envelope) {
-    return {
-        commitment: envelope.commitment,
-        slot: envelope.slot,
-        source: envelope.source,
-        strategy: 'direct',
-    };
-}
 function collectionMetadata(items, fallback) {
     const firstItem = items[0];
     const first = firstItem === undefined ? fallback : readMeta(firstItem);
@@ -47,7 +39,7 @@ function toStarSystemSnapshot(context, envelope) {
         ...envelope.data,
         address: envelope.address,
         kind: 'starSystem',
-    }), directMetadata(envelope)));
+    }), envelopeMeta(envelope, 'direct')));
     STAR_SYSTEM_SNAPSHOTS.set(envelope, snapshot);
     return snapshot;
 }
@@ -64,7 +56,7 @@ function toCelestialBodySnapshot(context, envelope) {
         ...data,
         address: envelope.address,
         system: entityRef('starSystem', system),
-    }), directMetadata(envelope)));
+    }), envelopeMeta(envelope, 'direct')));
     CELESTIAL_BODY_SNAPSHOTS.set(envelope, snapshot);
     return snapshot;
 }
@@ -95,7 +87,7 @@ async function createPlanetResourcesSnapshot(context, envelope) {
         resources,
         system: entityRef('starSystem', planet.system),
         systemSequenceId: planet.systemSequenceId,
-    }), directMetadata(envelope)));
+    }), envelopeMeta(envelope, 'direct')));
 }
 function assertCelestialBodyMembership(body, system) {
     if (body.system.address !== system.address) {
@@ -137,6 +129,82 @@ export async function getStarSystem(ctx, address, options) {
     requireGameAddress(ctx);
     return toStarSystemSnapshot(ctx, await ctx.data.read(starSystemAccountDefinition, address, options));
 }
+/** Watches one StarSystem, and the shared Starbase nested in it, through its
+ * context-owned WebSocket subscription.
+ *
+ * Registration emits the current validated StarSystem first, then only
+ * selected slot/commitment advances, coalescing changes while the observer is
+ * busy and re-reading after a reconnect. Snapshots match `getStarSystem`
+ * reads; derive Starbase status from each with `deriveStarbaseStatus` and
+ * `projectStarbasePoints`. Unsubscribe explicitly or dispose the context.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * declare const systemAddress: Address;
+ * const subscription = await watchStarSystem(ctx, systemAddress, {
+ *   onSnapshot: system => {
+ *     if (system.starbase !== undefined)
+ *       console.log(deriveStarbaseStatus(system.starbase).level);
+ *   },
+ *   onError: error => console.error(error.code),
+ * });
+ * await subscription.unsubscribe();
+ * ```
+ */
+export async function watchStarSystem(ctx, address, observer, options) {
+    requireGameAddress(ctx);
+    return ctx.data.subscribe(starSystemAccountDefinition, address, {
+        ...(observer.onDiagnostic === undefined
+            ? {}
+            : { onDiagnostic: observer.onDiagnostic }),
+        onError: observer.onError,
+        async onSnapshot(envelope) {
+            await observer.onSnapshot(toStarSystemSnapshot(ctx, envelope));
+        },
+    }, options);
+}
+/** Streams every StarSystem of the configured Game, and the shared Starbases
+ * nested in them, over one program subscription.
+ *
+ * Registration subscribes first, then discovers the matching StarSystems with
+ * the same targeted RPC filters as `getStarSystems` and emits each one. After
+ * that only StarSystems the program writes are emitted, so a galaxy map no
+ * longer re-reads every system on a timer. Delivery coalesces per StarSystem
+ * while the observer is busy. A reconnect re-runs the discovery, which is a
+ * galaxy-scale read; a StarSystem it no longer finds is reported through
+ * `onError` as `ACCOUNT_NOT_FOUND`. Requires a subscription provider with
+ * `subscribeProgram`. Unsubscribe explicitly or dispose the context.
+ *
+ * @example
+ * ```ts
+ * declare const ctx: SageContext;
+ * const systems = new Map<Address, StarSystemSnapshot>();
+ * const subscription = await watchStarSystems(ctx, {
+ *   onSnapshot: system => {
+ *     systems.set(system.address, system);
+ *   },
+ *   onError: error => console.error(error.code, error.address),
+ * });
+ * await subscription.unsubscribe();
+ * ```
+ */
+export async function watchStarSystems(ctx, observer, options = {}) {
+    const game = requireGameAddress(ctx);
+    const { regionId, ...subscriptionOptions } = options;
+    return ctx.data.subscribeDiscovery(starSystemAccountDefinition, {
+        ...subscriptionOptions,
+        filters: buildStarSystemDiscoveryFilters(game, regionId),
+    }, {
+        ...(observer.onDiagnostic === undefined
+            ? {}
+            : { onDiagnostic: observer.onDiagnostic }),
+        onError: observer.onError,
+        async onSnapshot(envelope) {
+            await observer.onSnapshot(toStarSystemSnapshot(ctx, envelope));
+        },
+    });
+}
 /** Reads one StarSystem and derives the status of its shared Starbase.
  *
  * Returns `undefined` when the System exists but has no Starbase; a missing
@@ -236,15 +304,15 @@ export async function getPlanetResources(context, planet, options) {
     return createPlanetResourcesSnapshot(context, await context.data.read(celestialBodyAccountDefinition, planet, options));
 }
 /** Reads one Planet and its StarSystem, then summarizes Claim Stake plot
- * availability for every tier.
+ * occupancy per Starbase level row and availability for every tier.
  *
  * The Planet and System stay on the shared account cache; Claim Stake
- * definitions load lazily through the registry so each occupying structure can
- * be grouped under its definition and tier. Availability is per definition,
+ * definitions load lazily through the registry. The program records stakes per
+ * Starbase level row, and every tier shares a row's occupancy, so
+ * availability is per tier across the rows up to the System's Starbase level,
  * matching the placement planner's check. A Planet whose System has no
- * Starbase still lists plot limits by level and occupied plots, but no current
- * limit or availability. An Asteroid address is rejected: only Planets carry
- * Claim Stake plots.
+ * Starbase still lists its rows and plot limits by level, but no availability.
+ * An Asteroid address is rejected: only Planets carry Claim Stake plots.
  *
  * @example
  * ```ts
@@ -252,9 +320,7 @@ export async function getPlanetResources(context, planet, options) {
  * declare const planet: Address;
  * const plots = await getPlanetClaimStakePlots(ctx, planet);
  * for (const tier of plots.tiers) {
- *   for (const entry of tier.definitions) {
- *     console.log(entry.definition.name, tier.plotLimit, entry.available);
- *   }
+ *   console.log(tier.tier, tier.available, tier.placementLevel);
  * }
  * ```
  */

package/dist/world/index.js.map

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

package/dist/world/planet-claim-stake-plots.d.ts

@@ -40,76 +40,84 @@ export interface PlanetClaimStakePlotStructure {
     readonly deactivationTimeUnixSeconds: bigint;
     readonly active: boolean;
 }
-/** One Claim Stake definition and the plots it occupies on a Planet.
+/** One plot row of a Planet: the Claim Stakes placed at one Starbase level.
  *
- * `occupied` counts every structure still recorded for this definition.
- * `available` is the tier's `plotLimit` minus `occupied`, clamped at zero; it
- * is the per-definition check the placement planner runs
- * (`claimedCount(details, definition.id)` against the tier cell) and is absent
- * when the System has no Starbase. `requiredTagsProvided` is true when the
- * Planet provides every tag the definition requires. Neither value is a
- * complete eligibility verdict: permissions, rent, faction rules and
- * concurrent placements remain chain-authoritative. `chronology` is the stored
- * placement order the program uses to index structures.
+ * The program records placed stakes per Starbase level row, not per Claim
+ * Stake definition. `occupied` counts every stake in the row, of every tier
+ * and including deactivated stakes that still hold their plot. `chronology` is
+ * the stored placement order the program uses to index the row's stakes.
+ *
+ * @example
+ * ```ts
+ * declare const row: PlanetClaimStakePlotRow;
+ * console.log(row.level, row.occupied);
+ * ```
+ */
+export interface PlanetClaimStakePlotRow {
+    readonly level: WorldStarbaseLevel;
+    readonly levelIndex: number;
+    readonly occupied: number;
+    readonly structures: readonly PlanetClaimStakePlotStructure[];
+    readonly chronology: readonly Address[];
+}
+/** One Claim Stake definition of a tier and whether the Planet suits it.
+ *
+ * `requiredTagsProvided` is true when the Planet provides every tag the
+ * definition requires. It is not a complete eligibility verdict: permissions,
+ * rent, faction rules and concurrent placements remain chain-authoritative.
  *
  * @example
  * ```ts
  * declare const entry: PlanetClaimStakePlotDefinition;
- * console.log(entry.definition.name, entry.occupied, entry.available);
+ * console.log(entry.definition.name, entry.requiredTagsProvided);
  * ```
  */
 export interface PlanetClaimStakePlotDefinition {
     readonly definition: GameClaimStakeDefinitionData;
     readonly requiredTagsProvided: boolean;
-    readonly occupied: number;
-    readonly available?: number;
-    readonly structures: readonly PlanetClaimStakePlotStructure[];
-    readonly chronology: readonly Address[];
 }
-/** Plot limits for one Claim Stake tier on a Planet.
+/** Plot limits and availability for one Claim Stake tier on a Planet.
  *
- * `plotLimitByLevel` lists the stored plot cell for every Starbase level in
- * {@link starbaseLevelIndex} order. `plotLimit`, `baseRentRate` and
- * `basePlacementFee` select the row for the System's current Starbase level
- * and are absent when the System has no Starbase. The limit applies per
- * definition: the placement planner compares one definition's recorded
- * structures against this cell, so each entry in `definitions` carries its own
- * `occupied` and `available`. Whether the program also caps the tier as a
- * whole is not established by the pinned contract, so no tier-wide remainder is
- * reported. Base rent and placement fee are the stored Planet values;
- * definition multipliers and the exact settlement remain program-authoritative.
+ * `plotLimitByLevel`, `baseRentRateByLevel` and `basePlacementFeeByLevel`
+ * list the stored cell of every plot row in {@link starbaseLevelIndex} order.
+ * A row's limit caps the stakes of all tiers in that row: placing a stake of
+ * this tier needs a row whose `occupied` count is below this tier's limit.
+ * The program uses the first such row from `level-0` up to the System's
+ * Starbase level; `placementLevel` names it. `available` sums the free plots
+ * of this tier over those rows. Both are absent when the System has no
+ * Starbase. Tiers share rows, so availability across tiers does not add up.
+ * Definition multipliers and the exact rent and fee settlement remain
+ * program-authoritative.
  *
  * @example
  * ```ts
  * declare const tier: PlanetClaimStakePlotTier;
- * for (const entry of tier.definitions) {
- *   console.log(entry.definition.name, tier.plotLimit, entry.available);
- * }
+ * console.log(tier.tier, tier.available, tier.placementLevel);
  * ```
  */
 export interface PlanetClaimStakePlotTier {
     readonly tier: ClaimStakeTier;
     readonly tierIndex: number;
     readonly plotLimitByLevel: readonly number[];
-    readonly plotLimit?: number;
-    readonly baseRentRate?: WorldFixedValue;
-    readonly basePlacementFee?: WorldFixedValue;
+    readonly baseRentRateByLevel: readonly WorldFixedValue[];
+    readonly basePlacementFeeByLevel: readonly WorldFixedValue[];
+    readonly available?: number;
+    readonly placementLevel?: WorldStarbaseLevel;
     readonly definitions: readonly PlanetClaimStakePlotDefinition[];
 }
 /** Immutable Claim Stake plot availability of one Planet.
  *
- * `tiers` always holds the five Claim Stake tiers in order. `starbaseLevel`
- * and `starbaseLevelIndex` come from the Planet's StarSystem and are absent
- * when that System has no Starbase. Read metadata reports the older of the
- * Planet and StarSystem observations.
+ * `rows` always holds the seven plot rows in Starbase level order, and `tiers`
+ * the five Claim Stake tiers in order. `starbaseLevel` and
+ * `starbaseLevelIndex` come from the Planet's StarSystem and are absent when
+ * that System has no Starbase. Read metadata reports the older of the Planet
+ * and StarSystem observations.
  *
  * @example
  * ```ts
  * declare const plots: PlanetClaimStakePlotsSnapshot;
- * const open = plots.tiers.flatMap((tier) =>
- *   tier.definitions.filter((entry) => (entry.available ?? 0) > 0),
- * );
- * console.log(plots.name, open.map((entry) => entry.definition.name));
+ * const open = plots.tiers.filter((tier) => (tier.available ?? 0) > 0);
+ * console.log(plots.name, open.map((tier) => tier.tier));
  * ```
  */
 export interface PlanetClaimStakePlotsSnapshot {
@@ -122,6 +130,7 @@ export interface PlanetClaimStakePlotsSnapshot {
     readonly starbaseLevel?: WorldStarbaseLevel;
     readonly starbaseLevelIndex?: number;
     readonly providedTags: readonly number[];
+    readonly rows: readonly PlanetClaimStakePlotRow[];
     readonly tiers: readonly PlanetClaimStakePlotTier[];
     toJSON(): unknown;
 }

package/dist/world/planet-claim-stake-plots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planet-claim-stake-plots.d.ts","sourceRoot":"","sources":["../../src/world/planet-claim-stake-plots.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,cAAc,IAAI,gBAAgB,EAClC,4BAA4B,EAC7B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAEV,eAAe,EACf,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AASjC,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAU9C;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACjE;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,MAAM,IAAI,OAAO,CAAC;CACnB;AAwBD,gFAAgF;AAChF,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,6BAA6B,CAAC,CAiFxC"}
+{"version":3,"file":"planet-claim-stake-plots.d.ts","sourceRoot":"","sources":["../../src/world/planet-claim-stake-plots.ts"],"names":[],"mappings":"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"}

package/dist/world/planet-claim-stake-plots.js

@@ -1,8 +1,9 @@
-import { entityRef, } from '../client/index.js';
+import { AccountDecodeError, entityRef, } from '../client/index.js';
 import { attachJsonSerialization } from '../internal/json.js';
 import { attachReadMeta, readMeta } from '../internal/read-meta.js';
 import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
-import { listClaimStakeDefinitions, resolveClaimStakeDefinition, } from '../registry/index.js';
+import { CLAIM_STAKE_PLOT_ROWS, claimStakeFreePlotsByRow, claimStakePlacementRow, claimStakePlotRowOccupancy, } from '../internal/c4/claim-stake-plots.js';
+import { listClaimStakeDefinitions } from '../registry/index.js';
 import { starbaseLevelIndex } from './starbase-status.js';
 const CLAIM_STAKE_TIERS = Object.freeze([
     'one',
@@ -26,6 +27,15 @@ const CLAIM_STAKE_TIERS = Object.freeze([
 export function claimStakeTierIndex(tier) {
     return CLAIM_STAKE_TIERS.indexOf(tier);
 }
+const PLOT_ROW_LEVELS = Object.freeze([
+    'level-0',
+    'level-1',
+    'level-2',
+    'level-3',
+    'level-4',
+    'level-5',
+    'css',
+]);
 function structuresOf(group) {
     return (group?.structures ?? []).map((structure) => ({
         active: structure.deactivationTimeUnixSeconds === 0n,
@@ -44,54 +54,50 @@ function olderMetadata(planet, system) {
 /** Builds the plot availability snapshot for a loaded Planet and its System. */
 export async function createPlanetClaimStakePlotsSnapshot(context, planet, system) {
     const details = planet.details;
-    const catalog = await listClaimStakeDefinitions(context);
-    const groups = new Map(details.claimedPlots.map((group) => [group.key, group]));
-    const known = new Set(catalog.map((definition) => definition.id));
-    // A group keyed outside the loaded catalog forces the registry refresh and
-    // out-of-sync rejection that every definition lookup applies.
-    const refreshed = await Promise.all([...groups.keys()]
-        .filter((key) => !known.has(key))
-        .map((key) => resolveClaimStakeDefinition(context, key)));
-    const definitions = [...catalog, ...refreshed];
+    const outsideRow = details.claimedPlots.find(({ key }) => !Number.isInteger(key) || key < 0 || key >= CLAIM_STAKE_PLOT_ROWS);
+    if (outsideRow !== undefined) {
+        throw new AccountDecodeError('celestialBody', planet.address, new RangeError('A Claim Stake plot group is outside the Starbase level rows.'), `Planet ${planet.address} records Claim Stakes in plot row ${String(outsideRow.key)}, but plot rows are the ${String(CLAIM_STAKE_PLOT_ROWS)} Starbase levels. Refresh the Planet and verify the pinned binding version before retrying.`);
+    }
+    const definitions = await listClaimStakeDefinitions(context);
     const starbase = system.starbase;
     const levelIndex = starbase === undefined ? undefined : starbaseLevelIndex(starbase.level);
+    const rows = PLOT_ROW_LEVELS.map((level, index) => {
+        const group = details.claimedPlots.find(({ key }) => key === index);
+        return {
+            chronology: [...(group?.chronoAddresses ?? [])],
+            level,
+            levelIndex: index,
+            occupied: claimStakePlotRowOccupancy(details.claimedPlots, index),
+            structures: structuresOf(group),
+        };
+    });
     const tiers = CLAIM_STAKE_TIERS.map((tier, tierIndex) => {
         // The pinned Planet codec fixes seven level rows and five tier columns.
-        const plotLimitByLevel = details.claimStakePlots.map((row) => row[tierIndex]);
-        const plotLimit = levelIndex === undefined ? undefined : plotLimitByLevel[levelIndex];
+        const column = (grid) => grid.map((row) => row[tierIndex]);
         const entries = definitions
             .filter((definition) => definition.tier === tier)
-            .map((definition) => {
-            const group = groups.get(definition.id);
-            const structures = structuresOf(group);
-            const occupied = structures.length;
-            return {
-                chronology: [...(group?.chronoAddresses ?? [])],
-                definition,
-                occupied,
-                ...(plotLimit === undefined
-                    ? {}
-                    : { available: Math.max(0, plotLimit - occupied) }),
-                requiredTagsProvided: definition.requiredTagIds.every((tag) => details.providedTags.includes(tag)),
-                structures,
-            };
-        });
-        if (levelIndex === undefined || plotLimit === undefined) {
-            return { definitions: entries, plotLimitByLevel, tier, tierIndex };
-        }
-        return {
-            basePlacementFee: {
-                ...details.baseClaimStakePlacementFee[levelIndex][tierIndex],
-            },
-            baseRentRate: {
-                ...details.baseClaimStakeRentRate[levelIndex][tierIndex],
-            },
+            .map((definition) => ({
+            definition,
+            requiredTagsProvided: definition.requiredTagIds.every((tag) => details.providedTags.includes(tag)),
+        }));
+        const common = {
+            basePlacementFeeByLevel: column(details.baseClaimStakePlacementFee).map((value) => ({ ...value })),
+            baseRentRateByLevel: column(details.baseClaimStakeRentRate).map((value) => ({ ...value })),
             definitions: entries,
-            plotLimit,
-            plotLimitByLevel,
+            plotLimitByLevel: column(details.claimStakePlots),
             tier,
             tierIndex,
         };
+        if (levelIndex === undefined)
+            return common;
+        const placementRow = claimStakePlacementRow(details.claimStakePlots, details.claimedPlots, tierIndex, levelIndex);
+        return {
+            ...common,
+            available: claimStakeFreePlotsByRow(details.claimStakePlots, details.claimedPlots, tierIndex, levelIndex).reduce((total, free) => total + free, 0),
+            ...(placementRow === undefined
+                ? {}
+                : { placementLevel: PLOT_ROW_LEVELS[placementRow] }),
+        };
     });
     return freezeResolvedSnapshot(attachReadMeta(attachJsonSerialization({
         address: planet.address,
@@ -100,6 +106,7 @@ export async function createPlanetClaimStakePlotsSnapshot(context, planet, syste
         kind: 'planetClaimStakePlots',
         name: planet.name,
         providedTags: [...details.providedTags],
+        rows,
         ...(starbase === undefined || levelIndex === undefined
             ? {}
             : { starbaseLevel: starbase.level, starbaseLevelIndex: levelIndex }),

package/dist/world/planet-claim-stake-plots.js.map

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

package/dist/world/starbase-status.d.ts

@@ -67,15 +67,34 @@ export interface StarbaseServiceAvailability {
     readonly enabledFromLevel: WorldStarbaseLevel;
     readonly available: boolean;
 }
+/** Hull and shield points of a shared Starbase, with its level maximums.
+ *
+ * `pendingHullPoints` is the repair reservoir: hull points already paid for
+ * that regenerate into `hullPoints` over time. Hull plus pending never exceeds
+ * the maximum.
+ *
+ * @example
+ * ```ts
+ * declare const points: StarbasePoints;
+ * console.log(points.hullPoints / points.maxHullPoints);
+ * ```
+ */
+export interface StarbasePoints {
+    readonly hullPoints: number;
+    readonly pendingHullPoints: number;
+    readonly maxHullPoints: number;
+    readonly shieldPoints: number;
+    readonly maxShieldPoints: number;
+}
 /** Derived status of the shared Starbase nested in one StarSystem.
  *
  * `current` pairs the stored hull and shield points with the maximums the
- * current level configures. `pendingHullPoints` mirrors the stored
- * `pendingHp` field as is: the pinned contract only names it, so the SDK makes
- * no claim about when or how the program settles it into `hullPoints`.
- * `timing` values are raw Unix seconds, as on the Fleet combat status; shield
- * and hull settlement rules are likewise unqualified. `upgrade` is absent once
- * the Starbase has reached its maximum level.
+ * current level configures. The program writes these points only when combat
+ * or a repair touches the Starbase and regenerates them on read in between, so
+ * stored values can lag far behind: use {@link projectStarbasePoints} for the
+ * points at a given moment. `timing` values are raw Unix seconds, as on the
+ * Fleet combat status. `upgrade` is absent once the Starbase has reached its
+ * maximum level.
  *
  * @example
  * ```ts
@@ -93,13 +112,8 @@ export interface StarbaseStatus {
     readonly atMaxLevel: boolean;
     /** Configured values for the current level, copied from the level table. */
     readonly levelInfo: WorldStarbaseLevelInfoData;
-    readonly current: {
-        readonly hullPoints: number;
-        readonly pendingHullPoints: number;
-        readonly maxHullPoints: number;
-        readonly shieldPoints: number;
-        readonly maxShieldPoints: number;
-    };
+    /** Stored points, as last written; see {@link projectStarbasePoints}. */
+    readonly current: StarbasePoints;
     readonly timing: {
         /** When shield points may resume regenerating after reaching zero. */
         readonly shieldBreakDelayEndsAtUnixSeconds: bigint;
@@ -173,4 +187,31 @@ export interface StarbaseStatusSnapshot extends Omit<StarbaseStatus, 'upgrade'>
 export declare function deriveStarbaseStatus(starbase: WorldStarbaseData): StarbaseStatus;
 /** Builds the resolved status snapshot for a loaded StarSystem's Starbase. */
 export declare function createStarbaseStatusSnapshot(context: SageContext, system: StarSystemSnapshot, starbase: WorldStarbaseData): Promise<StarbaseStatusSnapshot>;
+/** Projects a shared Starbase's hull and shield points to one moment.
+ *
+ * Between combat and repairs the program regenerates both on read, from the
+ * stored points and the last combat update:
+ *
+ * - Hull: pending repair points flow into the hull at the level's
+ *   `repairRate` per second, never past the maximum. A full hull holds no
+ *   pending points.
+ * - Shield: once the shield break delay has ended, the shield recharges at
+ *   the level's `shieldRechargeRate` per second from the later of the last
+ *   combat update and the end of the delay, never past the maximum.
+ *
+ * Results are the whole points the program would store if it settled at
+ * `atUnixSeconds`; combat itself uses the unrounded values, less than one point
+ * higher. This is pure and network-free, so a map can project every Starbase
+ * it already holds on each frame. A moment at or before the last combat
+ * update adds no regeneration.
+ *
+ * @example
+ * ```ts
+ * declare const status: StarbaseStatus;
+ * const now = BigInt(Math.floor(Date.now() / 1000));
+ * const points = projectStarbasePoints(status, now);
+ * console.log(points.hullPoints, points.shieldPoints);
+ * ```
+ */
+export declare function projectStarbasePoints(status: Pick<StarbaseStatus, 'current' | 'levelInfo' | 'timing'>, atUnixSeconds: bigint): StarbasePoints;
 //# sourceMappingURL=starbase-status.d.ts.map