@dreadwood-types/types 0.1.317 → 0.1.319

package/dist/storyWindows.d.ts

@@ -1,4 +1,4 @@
-export type StoryWindow = 'low-tide' | 'night' | 'blood-low' | 'blood-moon' | 'red-low' | 'ice-hold';
+export type StoryWindow = 'low-tide' | 'night' | 'blood-low' | 'blood-moon' | 'red-low' | 'ice-hold' | 'mill-flow';
 export declare const STORY_WINDOWS: readonly StoryWindow[];
 export declare function storyWindowOpen(window: StoryWindow, nowMs: number): boolean;
 /**

package/dist/storyWindows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storyWindows.d.ts","sourceRoot":"","sources":["../src/storyWindows.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AACrG,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA4E,CAAC;AAE7H,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAS3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS9E;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1E"}
+{"version":3,"file":"storyWindows.d.ts","sourceRoot":"","sources":["../src/storyWindows.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AACnH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAAyF,CAAC;AAE1I,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAU3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9E;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1E"}

package/dist/storyWindows.js

@@ -7,7 +7,8 @@
 import { SEA_GROTTO_TIDE_CYCLE_MS, isSaltmarkLampLit, isSeaGrottoLowWater, seaGrottoTideLine } from './gullsLowWater.js';
 import { BLOOD_TIDE_CYCLE_MS, bloodTideLine, isBloodLow, isBloodMoon, isRedLow } from './tideOfBlood.js';
 import { THAW_ICE_CYCLE_MS, isThawIceHolding, thawIceLine } from './thawCrossing.js';
-export const STORY_WINDOWS = ['low-tide', 'night', 'blood-low', 'blood-moon', 'red-low', 'ice-hold'];
+import { MILL_FLOW_CYCLE_MS, isMillFlowing, millRaceLine } from './millstreamHamlet.js';
+export const STORY_WINDOWS = ['low-tide', 'night', 'blood-low', 'blood-moon', 'red-low', 'ice-hold', 'mill-flow'];
 export function storyWindowOpen(window, nowMs) {
     switch (window) {
         case 'low-tide': return isSeaGrottoLowWater(nowMs);
@@ -16,6 +17,7 @@ export function storyWindowOpen(window, nowMs) {
         case 'blood-moon': return isBloodMoon(nowMs);
         case 'red-low': return isRedLow(nowMs);
         case 'ice-hold': return isThawIceHolding(nowMs);
+        case 'mill-flow': return isMillFlowing(nowMs);
     }
 }
 /**
@@ -31,6 +33,7 @@ export function storyWindowInstance(window, nowMs) {
         case 'night':
         case 'blood-moon': return Math.floor((nowMs + 6 * 3_600_000) / 86_400_000);
         case 'ice-hold': return Math.floor(nowMs / THAW_ICE_CYCLE_MS);
+        case 'mill-flow': return Math.floor(nowMs / MILL_FLOW_CYCLE_MS);
     }
 }
 /** The line added after a step's `wait` when its window is shut ('' when there is nothing to add). */
@@ -41,6 +44,8 @@ export function storyWindowLine(window, nowMs) {
         return bloodTideLine(nowMs);
     if (window === 'ice-hold')
         return thawIceLine(nowMs);
+    if (window === 'mill-flow')
+        return millRaceLine(nowMs);
     return '';
 }
 //# sourceMappingURL=storyWindows.js.map

package/dist/storyWindows.js.map

@@ -1 +1 @@
-{"version":3,"file":"storyWindows.js","sourceRoot":"","sources":["../src/storyWindows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrF,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE7H,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,KAAa;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACnD,KAAK,OAAO,CAAC,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9C,KAAK,WAAW,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,KAAK,SAAS,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,UAAU,CAAC,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB,EAAE,KAAa;IACpE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,wBAAwB,CAAC,CAAC;QACrE,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,mBAAmB,CAAC,CAAC;QAC/D,KAAK,OAAO,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,UAAU,CAAC,CAAC;QAC3E,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,iBAAiB,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,KAAa;IAChE,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"storyWindows.js","sourceRoot":"","sources":["../src/storyWindows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxF,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAE1I,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,KAAa;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACnD,KAAK,OAAO,CAAC,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9C,KAAK,WAAW,CAAC,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7C,KAAK,SAAS,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,UAAU,CAAC,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChD,KAAK,WAAW,CAAC,CAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB,EAAE,KAAa;IACpE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,wBAAwB,CAAC,CAAC;QACrE,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,mBAAmB,CAAC,CAAC;QAC/D,KAAK,OAAO,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,UAAU,CAAC,CAAC;QAC3E,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,iBAAiB,CAAC,CAAC;QAC9D,KAAK,WAAW,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,KAAa;IAChE,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/timberConvoy.d.ts

@@ -0,0 +1,282 @@
+/**
+ * THE TIMBER CONVOY (coverage slice 11, track T123, 2026-10-15; levels 21-30, a Dreadwoods woods feature): six times a day, in daylight, the
+ * forester's crew rolls a loaded timber wagon out of the camp (a PvP-off pocket at the Rotwood Grove's southern edge) and walks it down the
+ * woods to the Gallowmere road head. It takes eight minutes. The wagon is an NPC, not a prize: nobody can rob it. Players may ESCORT it, and
+ * the woods' wolves come for it as it goes, so an escort that stays close and cuts the wolves down is what gets it there whole.
+ *
+ * Everything here is pure: the clock, the route, the wagon's tile and health, the scoring, the prizes, the chat lines and the saved state, so
+ * the server, a test and the login line agree. It is the Beacon Night pattern (beaconNight.ts) and the Heartwood Hunt's collusion-safe scoring
+ * (heartwoodHunt.ts), with the Redcap patrol's clock-read timing (tollRoad.ts):
+ *  - the clock is READ off the wall clock, never rolled or stored: six starts a day at 04:17, 07:17, 10:17, 13:17, 16:17 and 19:17 UTC, picked so
+ *    that no ring fight, lair awakening, Heartwood Hunt, Fishing Derby round, Redcap patrol or Beacon Night comes close (the test checks 300
+ *    days of every clock). The wagon's tile is a pure function of the clock along the route, so a restart, a deploy or a second server agree
+ *    on where it is without saving anything;
+ *  - only OWN actions score: time spent within reach of the wagon (small, capped, and on its own never enough to be paid) and kills of this
+ *    convoy's own wolves (the `tc-` ids) made near the wagon. A player kill, a death or a trade scores nothing, so ambushing an escort in the
+ *    PvP woods takes points from nobody and a friend cannot be fed points;
+ *  - one place per ACCOUNT, a minimum score to be paid at all, a podium only when the wagon ARRIVED and three different accounts qualified,
+ *    and at most four paid convoys per account per UTC day;
+ *  - ties go to whoever reached the score first, then the character key, so the order is total;
+ *  - prizes are Woodwork and Explorer XP and alder and ash logs: no coins, nothing that outclasses the gated 41+ gear. Escorts are paid at
+ *    arrival (a wagon that is wrecked pays half the XP and no logs; a void convoy pays nothing).
+ *
+ * Amounts are PLACEHOLDERS for the balance pass, done last with James. The wolves are the Heartwood brood's own kind (mosswolf).
+ */
+export declare const CONVOY_NAME = "Timber Convoy";
+/** The six starts, in minutes after UTC midnight: 04:17, 07:17, 10:17, 13:17, 16:17 and 19:17 (daylight; the test checks them against every other clock). */
+export declare const CONVOY_START_MINUTES: readonly number[];
+export declare const CONVOY_PER_DAY: number;
+/** How long the wagon takes from the camp to the road head. */
+export declare const CONVOY_TRAVEL_MS: number;
+/** How long the unloading stays up after the wagon arrives (the wagon stands at the road head and the standings are up). */
+export declare const CONVOY_RESULTS_MS: number;
+/** The loading time before the start, and the warning before the end. */
+export declare const CONVOY_SOON_MS: number;
+export declare const CONVOY_LAST_MS: number;
+/** idle (nothing announced), soon (the wagon is being loaded at the camp), open (on the road), last (the final minute), results. */
+export type ConvoyStage = 'idle' | 'soon' | 'open' | 'last' | 'results';
+export declare const CONVOY_STAGES: readonly ConvoyStage[];
+export declare function isConvoyStage(s: unknown): s is ConvoyStage;
+/** The start of slot `slot` (slot = day * 6 + the start's index; any integer, negative included). */
+export declare function convoyStartOf(slot: number): number;
+export declare function convoyEndOf(slot: number): number;
+export type ConvoyClock = {
+    /** The convoy this stage is about: the open or just-finished one, else the next to start. */
+    slot: number;
+    stage: ConvoyStage;
+    /** Time to this convoy's start (0 once it has begun). */
+    msToStart: number;
+    /** Time to this convoy's arrival (0 once it is over). */
+    msToEnd: number;
+};
+export declare function convoyClockAt(now: number): ConvoyClock;
+/** True while the wagon is on the road and presence and wolf kills count. */
+export declare function convoyIsOpen(stage: ConvoyStage): boolean;
+/** True from the loading (soon) until the unloading ends (results): the wagon is on the ground. */
+export declare function convoyWagonOut(stage: ConvoyStage): boolean;
+/** The next convoy to start strictly after `now` (for the login line). */
+export declare function convoyNextRound(now: number): {
+    slot: number;
+    startsAt: number;
+};
+/** The UTC day a time falls in (the daily paid-convoys cap resets at midnight UTC). */
+export declare function convoyDayOf(now: number): number;
+/**
+ * The road, in world tiles: from the forester's camp (the PvP-off pocket x 324-336, z 404-412) down through the woods to the Gallowmere road
+ * head. Surveyed 2026-10-15 with the backend's pathfinder: every tile of every straight run is standable and every step is a legal step (the
+ * backend smoke walks it). 165 tiles, so the wagon plods at about one tile every three seconds.
+ */
+export declare const CONVOY_ROUTE: readonly {
+    x: number;
+    z: number;
+}[];
+/** The route's length in tiles (Chebyshev, the walking metric). */
+export declare const CONVOY_ROUTE_LENGTH: number;
+/** The tile `d` tiles along the route (clamped to both ends). The same rounding the backend smoke walks. */
+export declare function convoyTileAtDistance(d: number): {
+    x: number;
+    z: number;
+};
+/** How far along the road the wagon is for convoy `slot` at `now`, 0 to 1 (0 while it loads, 1 once it has arrived). Pure: no stored position. */
+export declare function convoyProgress(slot: number, now: number): number;
+/** The wagon's tile for convoy `slot` at `now`. */
+export declare function convoyWagonTile(slot: number, now: number): {
+    x: number;
+    z: number;
+};
+export declare const CONVOY_START_PLACE = "the forester's camp";
+export declare const CONVOY_END_PLACE = "the Gallowmere road head";
+/** The wagon: a tame pony NPC (the existing `penpony` kind) named for the cargo; never a fight, never attackable. Upgrade row: its own cart model. */
+export declare const CONVOY_WAGON: {
+    readonly id: "tc-wagon";
+    readonly kind: "penpony";
+    readonly name: "Timber wagon";
+    readonly healthMax: 100;
+    /** Health lost per second for each wolf standing within `atWagon` tiles of it. */
+    readonly drainPerWolfPerSec: 0.8;
+    readonly atWagon: 2;
+    /** The wagon arrived "whole" with at least this much health left (a Ledger line). */
+    readonly intact: 70;
+    /** The server steps the wagon towards its clock tile; further behind than this, it is put on the tile (a blocked step never strands it). */
+    readonly snapBehind: 4;
+    /** Missing from the world this long (removed by something else, nowhere to stand), the convoy is void. */
+    readonly missingVoidMs: 20000;
+};
+/** The wagon's health after `dtMs` with `wolvesAtWagon` wolves on it, never below 0. Pure. */
+export declare function convoyHealthAfter(health: number, dtMs: number, wolvesAtWagon: number): number;
+/**
+ * The woods' wolves that come for the wagon: the Heartwood brood's kind, ids `tc-`, sent in waves while somebody is near the wagon. Levels
+ * follow the escorts' average Combat, clamped; the count follows how many escorts are near. They go for an escort in reach, and for the wagon
+ * when nobody is in reach. No drops (no farming a convoy for fur). PLACEHOLDERS.
+ */
+export declare const CONVOY_WOLVES: {
+    readonly kind: "mosswolf";
+    readonly idPrefix: "tc-";
+    readonly name: "Ambush wolf";
+    readonly firstWave: 2;
+    readonly firstWaveAfterMs: 25000;
+    readonly waveEveryMs: 40000;
+    readonly perExtraEscort: 1;
+    readonly waveMax: 6;
+    readonly aliveCap: 10;
+    /** Wolves come out of the trees this far from the wagon. */
+    readonly spawnMin: 9;
+    readonly spawnMax: 12;
+    readonly aggroRadius: 8;
+    readonly leashRadius: 24;
+    readonly minLevel: 21;
+    readonly maxLevel: 30;
+    /** An escort is "near" this close to the wagon (a wave grows with them, and the first wave waits for one). */
+    readonly nearWagon: 22;
+    /** A player under this Combat is not locked on to (they may still walk beside the wagon, which is the safe job). */
+    readonly aggroCombat: 18;
+    readonly aggroText: "A wolf bursts out of the trees at you!";
+};
+/** How many wolves a wave brings: the first wave is fixed; later ones grow with the escorts near the wagon. */
+export declare function convoyWaveSize(wave: number, escorts: number): number;
+/** The wolves' level for a party's average Combat. */
+export declare function convoyWolfLevel(avgCombat: number): number;
+/** One presence point for each stretch this long spent within `CONVOY_ESCORT_REACH` of the wagon. */
+export declare const CONVOY_PRESENCE_EVERY_MS = 20000;
+export declare const CONVOY_ESCORT_REACH = 8;
+export declare const CONVOY_PRESENCE_POINTS = 1;
+export declare const CONVOY_KILL_POINTS = 3;
+/** Past these a stretch or a kill still helps the wagon (a dead wolf is a dead wolf) but scores nothing more. Presence alone never reaches the minimum. */
+export declare const CONVOY_PRESENCE_CAP = 5;
+export declare const CONVOY_KILL_CAP = 10;
+/** The least score that counts as having escorted (2 wolves, or 1 wolf and 3 stretches). Presence alone (at most 5) is never enough. */
+export declare const CONVOY_MIN_SCORE = 6;
+/** Podium prizes need at least this many different accounts above the minimum, and the wagon arrived. */
+export declare const CONVOY_MIN_ESCORTS = 3;
+/** Paid convoys per account per UTC day (alts and shared accounts cannot farm every wagon of the day). */
+export declare const CONVOY_DAILY_PAID = 4;
+/** A wolf kill counts only for a player this close to the wagon (a wolf kited across the woods scores nothing). */
+export declare const CONVOY_KILL_REACH = 20;
+export declare function convoyScore(presence: number, kills: number): number;
+export type ConvoyEntry = {
+    /** characterId. */
+    key: string;
+    /** The account, so one account's characters cannot all take prizes. Empty when unknown (then the key stands in). */
+    account: string;
+    name: string;
+    /** Stretches spent beside the wagon and wolf kills this convoy (uncapped; the score caps them). */
+    presence: number;
+    kills: number;
+    /** When the score last rose (ties go to whoever reached the score first). */
+    at: number;
+};
+export declare function convoyEntryScore(e: Pick<ConvoyEntry, 'presence' | 'kills'>): number;
+type Who = {
+    key: string;
+    account: string;
+    name: string;
+};
+/** One stretch beside the wagon by this character. Returns a new entry (the old is untouched). */
+export declare function convoyWithPresence(entry: ConvoyEntry | undefined, who: Who, at: number): ConvoyEntry;
+/** One wolf kill by this character. */
+export declare function convoyWithKill(entry: ConvoyEntry | undefined, who: Who, at: number): ConvoyEntry;
+export declare function convoyQualifies(e: ConvoyEntry): boolean;
+/**
+ * The ranking: higher score first, then whoever reached it first, then the key (a total order a test can pin). One place per ACCOUNT:
+ * of an account's characters only the best-placed one is listed. Entries below the minimum score are not ranked.
+ */
+export declare function convoyRanking(entries: readonly ConvoyEntry[]): ConvoyEntry[];
+/** The 1-based place of a character in the ranking (ranked entries only), or 0. */
+export declare function convoyPlaceOf(entries: readonly ConvoyEntry[], key: string): number;
+export type ConvoyRibbon = 'red' | 'blue' | 'bronze';
+export declare const CONVOY_RIBBON_LABEL: Readonly<Record<ConvoyRibbon, string>>;
+/** PLACEHOLDER podium prizes by place (an arrived wagon only), on top of the participation prize. */
+export declare const CONVOY_PODIUM_PRIZES: readonly {
+    woodworkXp: number;
+    explorerXp: number;
+    ash: number;
+}[];
+/** Everyone paid who qualified. A wagon that was wrecked halves the XP and gives no logs. */
+export declare const CONVOY_PARTICIPATION: {
+    readonly woodworkXp: 100;
+    readonly explorerXp: 20;
+    readonly alder: 3;
+};
+export declare const CONVOY_ALDER_KIND = "alderwood";
+export declare const CONVOY_ASH_KIND = "ashwood";
+/** Ledger marks (types explorerLedger.ts `convoy` page) a result can write. */
+export declare const CONVOY_MARK_ENTERED = "convoy:entered";
+export declare const CONVOY_MARK_ARRIVED = "convoy:arrived";
+export declare const CONVOY_MARK_WHOLE = "convoy:whole";
+export declare const CONVOY_MARK_GUARD = "convoy:guard";
+export declare const CONVOY_MARK_RIBBON: Readonly<Record<ConvoyRibbon, string>>;
+export type ConvoyItem = {
+    kind: string;
+    qty: number;
+};
+/** What one character is owed for a convoy. */
+export type ConvoyPrize = {
+    woodworkXp: number;
+    explorerXp: number;
+    items: ConvoyItem[];
+    /** Ledger marks to write. */
+    marks: string[];
+    /** The chat line they are told. */
+    text: string;
+};
+/** The paid-convoys record: per account, the day and how many convoys were paid that day. */
+export type ConvoyPaid = Record<string, {
+    day: number;
+    n: number;
+}>;
+/** Paid convoys this account has had on this UTC day. */
+export declare function convoyPaidToday(paid: ConvoyPaid, account: string, day: number): number;
+/** The record after one more paid convoy for these accounts (old days dropped). Returns a new object. */
+export declare function convoyWithPaid(paid: ConvoyPaid, accounts: readonly string[], day: number): ConvoyPaid;
+/** How a convoy ended: on the road ('none'), the wagon got there ('arrived'), the wolves broke it ('wrecked'), or nobody can say ('void'). */
+export type ConvoyOutcome = 'none' | 'arrived' | 'wrecked' | 'void';
+export type ConvoyPrizeInput = {
+    outcome: ConvoyOutcome;
+    health: number;
+    paid: ConvoyPaid;
+    day: number;
+};
+/**
+ * Everything a finished convoy pays, by character key. One prize per account (the ranking lists an account once). An account that has had its
+ * paid convoys today is skipped (the podium moves up to the next account). A void convoy pays nothing. Pure, so a restart that finalises a
+ * convoy late pays exactly what the clock-time finalise would have.
+ */
+export declare function convoyPrizes(entries: readonly ConvoyEntry[], input: ConvoyPrizeInput): Map<string, ConvoyPrize>;
+/** The world chat line for a finished convoy. */
+export declare function convoyResultLine(entries: readonly ConvoyEntry[], outcome: ConvoyOutcome, health: number): string;
+/** The world chat line for a stage (idle and results have none: the results line is built from the standings). */
+export declare function convoyChatLine(stage: ConvoyStage): string | null;
+/** The login line's piece about the Timber Convoy. */
+export declare function convoyTodayText(now: number): string;
+/** What /convoy tells a player. */
+export declare function convoyStatusLines(clock: ConvoyClock, entries: readonly ConvoyEntry[], myKey: string | null, health: number, now: number): string[];
+export type ConvoySave = {
+    v: 1;
+    /** The convoy the entries belong to (-1 = none). */
+    slot: number;
+    /** The stage last announced for `announced.slot`. */
+    announced: {
+        slot: number;
+        stage: ConvoyStage;
+    } | null;
+    /** True once `slot`'s results have been worked out and paid or queued. */
+    finalized: boolean;
+    /** The wagon's health now (while it is on the road), and how the convoy ended. */
+    health: number;
+    outcome: ConvoyOutcome;
+    /** Wolf waves sent this convoy. */
+    waves: number;
+    entries: ConvoyEntry[];
+    /** Prizes for characters who were offline when the convoy ended, by characterId. */
+    pending: Record<string, ConvoyPrize[]>;
+    /** Paid convoys per account per UTC day. */
+    paid: ConvoyPaid;
+};
+export declare function emptyConvoySave(): ConvoySave;
+/** At most this many prizes wait for one character, and entries are never more than this many. */
+export declare const CONVOY_PENDING_MAX = 5;
+export declare const CONVOY_MAX_ENTRIES = 1000;
+/** A saved state, checked field by field (it comes from the database); anything wrong gives the empty state. */
+export declare function parseConvoySave(raw: unknown): ConvoySave;
+export {};
+//# sourceMappingURL=timberConvoy.d.ts.map

package/dist/timberConvoy.d.ts.map

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