@horizon36596/zenith-season-biobuzz 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Horizon (FTC 36596)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,18 @@
+Zenith
+Copyright (c) 2026 Horizon (FTC 36596)
+
+Zenith is licensed under the MIT License; see LICENSE.
+
+Third-party assets
+
+- BIOBUZZ field images (apps/web/public/fields/biobuzz/*.webp) by Team Juice 16236, from the r/FTC
+  post "BIOBUZZ custom field images (MeepMeep compatible)". Used with the credit the author asks for.
+
+Bundled fonts
+
+The following fonts are bundled in apps/web/public/fonts/. Each is licensed under the SIL Open Font
+License, Version 1.1. The full licence text ships next to each font file.
+
+- Jost, licensed under the SIL Open Font License 1.1 (jost-OFL.txt).
+- IBM Plex Sans, licensed under the SIL Open Font License 1.1 (ibm-plex-sans-OFL.txt).
+- JetBrains Mono, licensed under the SIL Open Font License 1.1 (jetbrains-mono-OFL.txt).

package/README.md

@@ -0,0 +1,17 @@
+# @horizon36596/zenith-season-biobuzz
+
+The FTC BIOBUZZ season for [Zenith](https://libraries.horizon36596.org/zenith/), the FTC autonomous
+planner by Horizon (FTC 36596): the field file, and the season-rules plugin that reads it.
+
+```
+npm install @horizon36596/zenith-season-biobuzz
+```
+
+The field file ships as `field/biobuzz.field.json`
+(`@horizon36596/zenith-season-biobuzz/field/biobuzz.field.json`); `zenith init` copies it into a
+project. Every rule is derived from that file, so a team that corrects a measurement in its own copy
+gets rules that match.
+
+Most projects reach this package through
+[`@horizon36596/zenith-seasons`](https://www.npmjs.com/package/@horizon36596/zenith-seasons).
+Documentation: https://libraries.horizon36596.org/zenith/. Licence: MIT.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @horizon36596/zenith-season-biobuzz: the BIOBUZZ field file and the `SeasonRules` plugin that reads it
+ * (site/docs/seasons.md).
+ *
+ * The field file is the season: every rule below is derived from `field/biobuzz.field.json`, so a
+ * team that corrects a measurement in their own copy gets the corrected rules with it.
+ */
+export declare const seasonId = "biobuzz";
+export * from "./state.js";
+export * from "./rules.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,YAAY,CAAC;AAElC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @horizon36596/zenith-season-biobuzz: the BIOBUZZ field file and the `SeasonRules` plugin that reads it
+ * (site/docs/seasons.md).
+ *
+ * The field file is the season: every rule below is derived from `field/biobuzz.field.json`, so a
+ * team that corrects a measurement in their own copy gets the corrected rules with it.
+ */
+export const seasonId = "biobuzz";
+export * from "./state.js";
+export * from "./rules.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC;AAElC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,18 @@
+import { type SeasonRules } from "@horizon36596/zenith-core";
+import type { Field } from "@horizon36596/zenith-schema";
+/**
+ * The BIOBUZZ season plugin: the `SeasonRules` of
+ * site/docs/seasons.md, implemented from `field.json` alone.
+ *
+ * It is deliberately simple. It does not model where a spilled game piece lands; after a tip the
+ * spilled count becomes loose with an unknown position, which is what makes a following
+ * `collectNearestPollen` an unknown time rather than a made-up one.
+ */
+/** How close a footprint corner has to be to a wall to count as touching it, in inches. */
+export declare const TOUCHING_WALL_TOLERANCE_IN = 0.5;
+/** How far a footprint may sit over the centre line before it is no longer in its own half. */
+export declare const OWN_HALF_TOLERANCE_IN = 0.05;
+export declare const biobuzzRules: SeasonRules;
+/** The rules for a field file: this plugin when the file names it, and nothing otherwise. */
+export declare function loadSeason(field: Field): SeasonRules;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,WAAW,EAIjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,6BAA6B,CAAC;AAUhE;;;;;;;GAOG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAoD1C,eAAO,MAAM,YAAY,EAAE,WAwW1B,CAAC;AAiBF,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAIpD"}

package/dist/rules.js

@@ -0,0 +1,402 @@
+import { fieldBounds, footprintAt, noSeasonRules, polygonOverlapsBox, } from "@horizon36596/zenith-core";
+import { heldTotal, initialBiobuzzState, oppositeSide, upCellFace, } from "./state.js";
+/**
+ * The BIOBUZZ season plugin: the `SeasonRules` of
+ * site/docs/seasons.md, implemented from `field.json` alone.
+ *
+ * It is deliberately simple. It does not model where a spilled game piece lands; after a tip the
+ * spilled count becomes loose with an unknown position, which is what makes a following
+ * `collectNearestPollen` an unknown time rather than a made-up one.
+ */
+/** How close a footprint corner has to be to a wall to count as touching it, in inches. */
+export const TOUCHING_WALL_TOLERANCE_IN = 0.5;
+/** How far a footprint may sit over the centre line before it is no longer in its own half. */
+export const OWN_HALF_TOLERANCE_IN = 0.05;
+const as = (state) => state;
+const plural = (count, noun) => `${String(count)} ${noun}${count === 1 ? "" : "s"}`;
+const addHold = (holds, kind, delta) => {
+    const next = { ...holds };
+    const value = (next[kind] ?? 0) + delta;
+    if (value <= 0)
+        delete next[kind];
+    else
+        next[kind] = value;
+    return next;
+};
+/** The number in the up cell that tips the hive next, from `rules.tipTable` (`02`). */
+function tipThreshold(hive, tipTable) {
+    if (tipTable.length === 0)
+        return null;
+    const index = Math.min(hive.tips, tipTable.length - 1);
+    return tipTable[index] ?? null;
+}
+/** Swings the hive over: the up cell spills, the down cell comes up, and the up side flips. */
+function tipHive(state, hive) {
+    const spilled = hive.upCellCount;
+    const tipped = {
+        ...hive,
+        upSide: oppositeSide(hive.upSide),
+        upCellCount: hive.downCellCount,
+        downCellCount: 0,
+        tips: hive.tips + 1,
+    };
+    return {
+        ...state,
+        hives: { ...state.hives, [hive.id]: tipped },
+        looseCount: state.looseCount + spilled,
+        looseUnknown: state.looseUnknown || spilled > 0,
+    };
+}
+/** The hive a target id belongs to, or null when the target is not a hive cell. */
+function hiveOfTarget(state, target) {
+    for (const hive of Object.values(state.hives)) {
+        if (hive.targetId === target || hive.id === target)
+            return hive;
+    }
+    return null;
+}
+export const biobuzzRules = {
+    id: "season-biobuzz",
+    initialState: (field) => initialBiobuzzState(field),
+    start: (state, holds) => {
+        const current = as(state);
+        return { ...current, robotHolds: { ...holds } };
+    },
+    holds: (state) => ({ ...as(state).robotHolds }),
+    /**
+     * A volley into the hive's up cell: the pieces leave the robot, land in the cell, and once the
+     * cell holds what the tip table says, the hive swings and whatever was up spills onto the floor.
+     */
+    onLaunch: (state, target, count, pose) => {
+        void pose;
+        const current = as(state);
+        const hive = hiveOfTarget(current, target);
+        const launched = Math.max(0, Math.min(count, heldTotal(current)));
+        let robotHolds = current.robotHolds;
+        let remaining = launched;
+        for (const kind of Object.keys(robotHolds)) {
+            if (remaining <= 0)
+                break;
+            const take = Math.min(remaining, robotHolds[kind] ?? 0);
+            robotHolds = addHold(robotHolds, kind, -take);
+            remaining -= take;
+        }
+        if (hive === null)
+            return { ...current, robotHolds };
+        const filled = { ...hive, upCellCount: hive.upCellCount + launched };
+        let next = {
+            ...current,
+            robotHolds,
+            hives: { ...current.hives, [hive.id]: filled },
+        };
+        for (let guard = 0; guard < 8; guard += 1) {
+            const standing = next.hives[hive.id];
+            if (standing === undefined)
+                break;
+            const threshold = tipThreshold(standing, next.tipTable);
+            if (threshold === null || standing.upCellCount < threshold)
+                break;
+            next = tipHive(next, standing);
+        }
+        return next;
+    },
+    /**
+     * The flowers hand pollen out of the opening at their base, and only the kinds that opening
+     * lists; a hive's nectar is locked in and no `collectFrom` annotation can take it out. A garden
+     * element is a single piece lying on the floor.
+     */
+    onCollect: (state, containerId, count) => {
+        const current = as(state);
+        const room = Math.max(0, current.capacity - heldTotal(current));
+        const wanted = Math.max(0, Math.min(count, room));
+        if (wanted === 0)
+            return state;
+        const flower = current.flowers[containerId];
+        if (flower !== undefined) {
+            let holds = flower.holds;
+            let robotHolds = current.robotHolds;
+            let left = wanted;
+            for (const kind of flower.takes) {
+                if (left <= 0)
+                    break;
+                const take = Math.min(left, holds[kind] ?? 0);
+                if (take === 0)
+                    continue;
+                holds = addHold(holds, kind, -take);
+                robotHolds = addHold(robotHolds, kind, take);
+                left -= take;
+            }
+            return {
+                ...current,
+                robotHolds,
+                flowers: { ...current.flowers, [containerId]: { ...flower, holds } },
+            };
+        }
+        if (current.hives[containerId] !== undefined) {
+            // Nectar is locked inside the hive: there is no legal way to take it back out in auto.
+            return state;
+        }
+        const gardenIds = Object.keys(current.garden).filter((id) => (id === containerId || id.startsWith(containerId)) && current.garden[id] === true);
+        if (gardenIds.length > 0) {
+            const taken = gardenIds.slice(0, wanted);
+            const garden = { ...current.garden };
+            for (const id of taken)
+                garden[id] = false;
+            return {
+                ...current,
+                garden,
+                robotHolds: addHold(current.robotHolds, current.elementKind, taken.length),
+            };
+        }
+        if (containerId === "loose" && current.looseCount > 0) {
+            const taken = Math.min(wanted, current.looseCount);
+            return {
+                ...current,
+                looseCount: current.looseCount - taken,
+                robotHolds: addHold(current.robotHolds, current.elementKind, taken),
+            };
+        }
+        return state;
+    },
+    /**
+     * The author asserting the hive swung, which `assumeTipped` and `expect.tip` both do. It is
+     * trusted over the tip table, because a camera or a driver saw it and the table only predicts it.
+     */
+    onTip: (state, which, alliance) => {
+        const current = as(state);
+        const wanted = which === "own" ? alliance : alliance === "RED" ? "BLUE" : "RED";
+        const hive = Object.values(current.hives).find((candidate) => candidate.alliance === wanted);
+        if (hive === undefined)
+            return state;
+        return tipHive(current, hive);
+    },
+    /** The alliance's own hive cell that is currently up: the only thing worth shooting at. */
+    currentTarget: (state, alliance) => {
+        for (const hive of Object.values(as(state).hives)) {
+            if (hive.alliance === alliance)
+                return hive.targetId ?? hive.id;
+        }
+        return null;
+    },
+    /**
+     * A launch is only legal from outboard of the up cell's outer face, by the margin the field file
+     * states, along the hive's swing axis and on the side the cell faces.
+     */
+    legalApproach: (state, target, pose, robot) => {
+        void robot;
+        const hive = hiveOfTarget(as(state), target);
+        if (hive === null)
+            return true;
+        const { faceIn, outboardSign } = upCellFace(hive);
+        const along = hive.axis === "x" ? pose.xIn : pose.yIn;
+        const limit = faceIn + outboardSign * hive.approachMarginIn;
+        return outboardSign > 0 ? along >= limit : along <= limit;
+    },
+    /**
+     * Where the up cell sits, for the turret-range check: the middle of the cell, which is half the
+     * outer-face distance out from the pivot on the side that is up.
+     */
+    targetPoint: (state, target) => {
+        const hive = hiveOfTarget(as(state), target);
+        if (hive === null)
+            return null;
+        const { outboardSign } = upCellFace(hive);
+        const middle = outboardSign * (hive.outerFaceIn / 2);
+        return hive.axis === "x"
+            ? { xIn: hive.pivotIn.xIn + middle, yIn: hive.pivotIn.yIn }
+            : { xIn: hive.pivotIn.xIn, yIn: hive.pivotIn.yIn + middle };
+    },
+    /**
+     * The nearest pose the approach rule would accept: straight out along the hive's axis to the
+     * edge of the legal band, keeping the other coordinate, facing the cell.
+     */
+    nearestLegalApproach: (state, target, pose, robot) => {
+        const current = as(state);
+        const hive = hiveOfTarget(current, target);
+        if (hive === null)
+            return null;
+        if (biobuzzRules.legalApproach(state, target, pose, robot))
+            return pose;
+        const { faceIn, outboardSign } = upCellFace(hive);
+        const limit = faceIn + outboardSign * hive.approachMarginIn;
+        const moved = hive.axis === "x" ? { xIn: limit, yIn: pose.yIn } : { xIn: pose.xIn, yIn: limit };
+        const aim = biobuzzRules.targetPoint?.(state, target) ?? null;
+        const headingRad = aim === null ? pose.headingRad : Math.atan2(aim.yIn - moved.yIn, aim.xIn - moved.xIn);
+        return { ...moved, headingRad };
+    },
+    /**
+     * `startRules` from `field.json`, checked against the footprint at the start pose.
+     *
+     * The pose is in the frame of `alliance`, the file's own, which is where the robot starts it. The
+     * field file writes its rules for `field.frame.canonicalAlliance`, so for the other alliance its
+     * own half is the one its own hive is in and a named zone is read as its counterpart
+     * (`loadingZoneRed` is BLUE's `loadingZoneBlue`).
+     */
+    startLegal: (field, pose, robot, alliance = field.frame.canonicalAlliance) => {
+        const rules = field.startRules;
+        if (rules === undefined)
+            return [];
+        const ownId = (id) => alliance === field.frame.canonicalAlliance ? id : (swapAllianceWord(id) ?? id);
+        const findings = [];
+        const bounds = fieldBounds(field);
+        const corners = footprintAt(pose, robot, "startIn").bodyIn;
+        const say = (message) => {
+            findings.push({
+                severity: "error",
+                stepId: "start",
+                code: "START_ILLEGAL",
+                message,
+                geometry: { polygonIn: corners },
+            });
+        };
+        if (rules.touchingWall === true) {
+            const nearest = Math.min(...corners.map((corner) => Math.min(corner.xIn - bounds.minXIn, bounds.maxXIn - corner.xIn, corner.yIn - bounds.minYIn, bounds.maxYIn - corner.yIn)));
+            if (nearest > TOUCHING_WALL_TOLERANCE_IN) {
+                say(`The robot must start touching a wall, and its nearest corner is ${nearest.toFixed(2)} in away from one.`);
+            }
+        }
+        if (rules.ownHalf === true) {
+            // The pose is in the frame of the file's own alliance, and that alliance's hive says which
+            // side of the centre line is its own half.
+            const ownHive = (field.elements ?? []).find((element) => element.container === "hive" && element.id.toLowerCase().includes(alliance.toLowerCase()));
+            const pivotX = ownHive === undefined ? -1 : (numberAt(ownHive, "pivotIn", "xIn") ?? -1);
+            // Own half is where `x * ownSign` is positive, so a corner on the wrong side of the centre
+            // line is one whose `-x * ownSign` is above the tolerance.
+            const ownSign = pivotX < 0 ? -1 : 1;
+            const worst = Math.max(...corners.map((corner) => -corner.xIn * ownSign));
+            if (worst > OWN_HALF_TOLERANCE_IN) {
+                say(`The robot must start in its own half, and its footprint crosses the centre line by ${worst.toFixed(2)} in.`);
+            }
+        }
+        for (const zoneId of (rules.notInZones ?? []).map(ownId)) {
+            const zone = (field.zones ?? []).find((candidate) => candidate.id === zoneId);
+            if (zone === undefined)
+                continue;
+            if (polygonOverlapsBox(corners, zone).overlaps) {
+                say(`The robot must not start in ${zoneId}${zone.rule === undefined ? "" : ` (${zone.rule})`}.`);
+            }
+        }
+        for (const containerKind of rules.notTouchingContainers ?? []) {
+            for (const element of field.elements ?? []) {
+                if (element.container !== containerKind)
+                    continue;
+                // A container's footprint on the floor is the obstacle the field file draws for it.
+                for (const obstacle of field.obstacles ?? []) {
+                    if (!obstacle.id.startsWith(element.id))
+                        continue;
+                    if (polygonOverlapsBox(corners, obstacle).overlaps) {
+                        say(`The robot must not start touching a ${containerKind}, and it overlaps ${obstacle.id}.`);
+                    }
+                }
+            }
+        }
+        return findings;
+    },
+    describe: (before, after) => {
+        const a = as(before);
+        const b = as(after);
+        const parts = [];
+        for (const hive of Object.values(b.hives)) {
+            const was = a.hives[hive.id];
+            if (was === undefined)
+                continue;
+            if (hive.tips !== was.tips) {
+                parts.push(`${hive.id} tipped and now faces ${hive.upSide}`);
+            }
+            else if (hive.upCellCount !== was.upCellCount) {
+                parts.push(`${hive.id} up cell holds ${plural(hive.upCellCount, "piece")}`);
+            }
+        }
+        for (const flower of Object.values(b.flowers)) {
+            const was = a.flowers[flower.id];
+            if (was === undefined)
+                continue;
+            const left = Object.values(flower.holds).reduce((sum, value) => sum + value, 0);
+            const had = Object.values(was.holds).reduce((sum, value) => sum + value, 0);
+            if (left !== had)
+                parts.push(`${flower.id} has ${plural(left, "piece")} left`);
+        }
+        if (b.looseCount !== a.looseCount) {
+            parts.push(`${plural(b.looseCount - a.looseCount, "piece")} spilled to an unknown place`);
+        }
+        return parts.length === 0 ? null : parts.join("; ");
+    },
+    /**
+     * The other alliance's name for a field id.
+     *
+     * Every alliance-specific id in `biobuzz.field.json` is spelled with `Red` or `Blue` in it
+     * (`hiveRed`, `hiveBlueUpCell`, `gardenRed2`, `loadingZoneBlue`), so the counterpart is the same
+     * id with the colour swapped. An id with neither — a flower, which both alliances share — is its
+     * own counterpart. Nothing here invents an id: a swapped name that the field file does not carry
+     * is reported as having no counterpart, so `mirrorAuto` refuses rather than writing a dangling
+     * reference.
+     */
+    mirrorId: (id) => {
+        const swapped = swapAllianceWord(id);
+        if (swapped === null)
+            return id;
+        return swapped;
+    },
+    /** The end-of-routine rows the ledger panel and the pull-request body both print. */
+    summary: (state) => {
+        const current = as(state);
+        const rows = [
+            {
+                stepId: "end",
+                label: "robot",
+                detail: heldTotal(current) === 0
+                    ? "empty"
+                    : Object.entries(current.robotHolds)
+                        .map(([kind, count]) => plural(count, kind))
+                        .join(", "),
+                holds: { ...current.robotHolds },
+            },
+        ];
+        for (const hive of Object.values(current.hives)) {
+            rows.push({
+                stepId: "end",
+                label: hive.id,
+                detail: `up ${hive.upSide}, ${plural(hive.tips, "tip")}, ${plural(hive.upCellCount, "piece")} in the up cell`,
+            });
+        }
+        for (const flower of Object.values(current.flowers)) {
+            const left = Object.values(flower.holds).reduce((sum, value) => sum + value, 0);
+            rows.push({ stepId: "end", label: flower.id, detail: plural(left, "piece") });
+        }
+        const gardenLeft = Object.values(current.garden).filter(Boolean).length;
+        rows.push({ stepId: "end", label: "garden", detail: plural(gardenLeft, "piece") });
+        if (current.looseCount > 0) {
+            rows.push({
+                stepId: "end",
+                label: "loose",
+                detail: `${plural(current.looseCount, "piece")}, position unknown`,
+            });
+        }
+        return rows;
+    },
+};
+/** `hiveRedUpCell` -> `hiveBlueUpCell`, and null when the id names no alliance at all. */
+function swapAllianceWord(id) {
+    if (id.includes("Red"))
+        return id.split("Red").join("Blue");
+    if (id.includes("Blue"))
+        return id.split("Blue").join("Red");
+    return null;
+}
+function numberAt(source, key, inner) {
+    if (typeof source !== "object" || source === null)
+        return null;
+    const nested = source[key];
+    if (typeof nested !== "object" || nested === null)
+        return null;
+    const value = nested[inner];
+    return typeof value === "number" ? value : null;
+}
+/** The rules for a field file: this plugin when the file names it, and nothing otherwise. */
+export function loadSeason(field) {
+    const plugin = field.rules?.plugin;
+    if (plugin === biobuzzRules.id || field.season === "biobuzz")
+        return biobuzzRules;
+    return noSeasonRules;
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,79 @@
+import type { Field } from "@horizon36596/zenith-schema";
+/**
+ * The BIOBUZZ ledger state. Everything in it is read out of `field.json` at kickoff, because
+ * site/docs/file-format.md says the file alone is the season: nothing here is a constant typed
+ * from the manual, and a team that corrects a measurement in their own copy of the field file gets
+ * the corrected rules for free.
+ *
+ * A `type` rather than an `interface` on purpose: the core threads this through `SeasonState`,
+ * which is `Readonly<Record<string, unknown>>`, and only a type alias is assignable to that.
+ */
+export type HiveState = {
+    id: string;
+    /** RED or BLUE, taken from the hive's own id, which is how `field.json` names sides. */
+    alliance: "RED" | "BLUE";
+    pivotIn: {
+        xIn: number;
+        yIn: number;
+    };
+    /** Which way the cell that is currently up faces. */
+    upSide: string;
+    /** How many game pieces are sitting in the cell that is up. */
+    upCellCount: number;
+    /** How many are in the cell that is down; they ride back up at the next tip. */
+    downCellCount: number;
+    /** How many times this hive has tipped so far. */
+    tips: number;
+    /** The axis the cells swing along, and how far the outer faces sit from the pivot. */
+    axis: "x" | "y";
+    outerFaceIn: number;
+    /** How far outboard of that face the robot has to be to have a legal approach. */
+    approachMarginIn: number;
+    /** The target id that names this hive's up cell. */
+    targetId: string | null;
+};
+export type FlowerState = {
+    id: string;
+    xIn: number;
+    yIn: number;
+    /** What is left inside, by element kind. */
+    holds: Record<string, number>;
+    /** The kinds the bottom retrieval opening lets out. Nectar is not one of them. */
+    takes: string[];
+};
+export type BiobuzzState = {
+    /** What the robot is carrying, by element kind. */
+    robotHolds: Record<string, number>;
+    hives: Record<string, HiveState>;
+    flowers: Record<string, FlowerState>;
+    /** The garden lines, still on the floor: element id to true while it is there. */
+    garden: Record<string, boolean>;
+    /**
+     * Pieces that spilled out of a tipping hive. `03` section 6 is explicit that the ledger does not
+     * model where they land, so the count is carried and the position is not.
+     */
+    looseCount: number;
+    /** True once a tip has spilled: their positions are unknown and a collect near them is untimed. */
+    looseUnknown: boolean;
+    /** The number in the up cell that makes the hive tip, for the first tip, the second, and so on. */
+    tipTable: number[];
+    /** How many pieces the robot may hold at once, from `rules.capacity`. */
+    capacity: number;
+    /** The element kind the robot carries and launches. */
+    elementKind: string;
+};
+/** The BIOBUZZ state at kickoff, entirely from `field.json` (`03` section 6, trust source one). */
+export declare function initialBiobuzzState(field: Field): BiobuzzState;
+/** How many pieces the robot is carrying, across every kind. */
+export declare const heldTotal: (state: BiobuzzState) => number;
+/** Which way the hive's up cell faces after it swings over. */
+export declare const oppositeSide: (side: string) => string;
+/**
+ * Where the up cell's outer face sits along the swing axis, in field coordinates, and which way is
+ * outboard of it. A cell facing SOUTH or WEST has its face on the negative side of the pivot.
+ */
+export declare function upCellFace(hive: HiveState): {
+    faceIn: number;
+    outboardSign: 1 | -1;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAA0B,MAAM,6BAA6B,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kFAAkF;IAClF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,YAAY,EAAE,OAAO,CAAC;IACtB,mGAAmG;IACnG,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA0DF,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CA8D9D;AAED,gEAAgE;AAChE,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,KAAG,MAAiC,CAAC;AAElF,+DAA+D;AAC/D,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAQ3C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;CAAE,CAKpF"}