@wildshard/shard-format 0.4.6 → 0.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wildshard/shard-format",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "The raw shardfile format: the spec, the validator and a validate CLI. The public, versioned contract every other repo builds on.",
   "license": "UNLICENSED",
   "repository": {

package/src/format/contentBounds.ts

@@ -5,9 +5,10 @@ import memoryGates from './memoryGates.json' with { type: 'json' };
 export const CHUNK_SIZE = 500;        // metres, square
 /** Half a cell width in metres. */
 export const CHUNK_HALF: number = CHUNK_SIZE / 2;
-/** Signed placement radius of the finite platform catalogue (SF88); residency budgets stay independent. */
-export const GRID_RADIUS = 2;
-/** Number of placements, including open plots, in the finite square platform. */
+/** Signed placement radius of the finite platform catalogue (SF88): 7×7 since J314, J305's 5×5 at its centre and the
+ * outer ring void until a shard is placed there; residency budgets stay independent. */
+export const GRID_RADIUS = 3;
+/** Most placements, including open plots, the finite square platform holds; a grid may leave cells empty. */
 export const GRID_CELL_COUNT: number = (2 * GRID_RADIUS + 1) ** 2;
 /** Legal midpoint entry opening in metres. */
 export const ENTRY_WIDTH = 8;

package/src/format/grid-catalogue.ts

@@ -223,15 +223,16 @@ const gridShape = strictObject({
   emptyNeighbour,
 })
 
-/** Placement data, independent of package content and solo coordinates. */
+/** Placement data, independent of package content and solo coordinates. Since J314 a
+ * cell may stay empty: the void a new shard's first upload is placed into. */
 const GridCatalogueSchema: GenericSchema<GridCatalogueInput, GridCatalogue> =
   pipe(
     gridShape,
     check(
       // oxlint-disable-next-line typescript/prefer-readonly-parameter-types -- valibot's check takes the schema's own type
       (grid: InferOutput<typeof gridShape>): boolean =>
-        uniquePlaces(grid.cells) && grid.cells.length === GRID_CELL_COUNT,
-      'unique stable instance identities and complete signed cell layout',
+        uniquePlaces(grid.cells),
+      'unique stable instance identities and cells',
     ),
   )