@dreadwood-types/types 0.1.53 → 0.1.55

package/dist/rotwoodGrove.js

@@ -0,0 +1,43 @@
+import { DEADLANDS_MIN_X, DEADLANDS_MIN_Z } from './zones.js';
+/**
+ * The Rotwood Grove (James's Dreadwoods pack, 2026-09-26: the rotwood grove
+ * painting): the Rotwood Ent's clearing in the north-west of the woods.
+ *
+ * A clearing of blood-dark earth ringed by the grove's dead giants: fallen
+ * trunks and root arches round the rim, rotten stumps burning green wisps
+ * round the Ent in the middle, the way in from the south under an arch and
+ * between wisp posts. Moss wolves (the forest monsters built ahead of a home)
+ * prowl it. Geometry here; the backend's rotwoodGrove.ts dresses it; the zone
+ * is DREADWOODS_NPC_ZONES 'rotwood-grove'.
+ */
+export const GROVE_CX = DEADLANDS_MIN_X + 90;
+export const GROVE_CZ = DEADLANDS_MIN_Z + 124;
+/** The zone: the clearing and its rim. */
+export const GROVE_RX = 22;
+export const GROVE_RZ = 17;
+/** The clearing of dark earth, an ellipse. */
+export const GROVE_CLEARING_RX = 15;
+export const GROVE_CLEARING_RZ = 11;
+/** Where the Ent stands, looking down the way in. */
+export const GROVE_ENT = { x: GROVE_CX, z: GROVE_CZ - 2 };
+/** The way in: up from the south, three wide, to the Ent. */
+export const GROVE_PATH_Z0 = GROVE_CZ + 1;
+export const GROVE_PATH_Z1 = GROVE_CZ + 20;
+/** The root arch the way in passes under (5 x 1, its feet two either side of the path). */
+export const GROVE_ENTRY_ARCH = { x: GROVE_CX, z: GROVE_CZ + GROVE_CLEARING_RZ + 2 };
+/** The moss wolves' posts (rotwood-grove-smoke.ts pins them clear and reachable). */
+export const GROVE_WOLF_SPAWNS = [
+    { x: GROVE_CX - 10, z: GROVE_CZ + 2 },
+    { x: GROVE_CX + 10, z: GROVE_CZ + 3 },
+    { x: GROVE_CX - 3, z: GROVE_CZ - 8 },
+    { x: GROVE_CX + 4, z: GROVE_CZ - 8 },
+];
+export function inGroveClearing(x, z) {
+    const dx = (x - GROVE_CX) / GROVE_CLEARING_RX;
+    const dz = (z - GROVE_CZ) / GROVE_CLEARING_RZ;
+    return dx * dx + dz * dz <= 1;
+}
+export function onGrovePath(x, z) {
+    return Math.abs(x - GROVE_CX) <= 1 && z >= GROVE_PATH_Z0 && z <= GROVE_PATH_Z1;
+}
+//# sourceMappingURL=rotwoodGrove.js.map

package/dist/rotwoodGrove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotwoodGrove.js","sourceRoot":"","sources":["../src/rotwoodGrove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,GAAG,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,GAAG,GAAG,CAAC;AAC9C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAC3B,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC;AAC1D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,GAAG,EAAE,CAAC;AAC3C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,iBAAiB,GAAG,CAAC,EAAE,CAAC;AACrF,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAwC;IACpE,EAAE,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE;IACrC,EAAE,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE;IACrC,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE;IACpC,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,EAAE;CACrC,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,iBAAiB,CAAC;IAC9C,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,iBAAiB,CAAC;IAC9C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,IAAI,aAAa,CAAC;AACjF,CAAC"}

package/dist/storyPlaces.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Fred's cottage: west of Anne's, mirroring Eldric's to the east, so her
+ * garden has a neighbour on each side. A Blender model (quest-workshop
+ * `fredcottage`), door to the south onto the lane like the others.
+ */
+export declare const FREDS_HOME: {
+    readonly name: "Fred";
+    readonly x: number;
+    readonly localZ: number;
+};
+/** Fred stands at his gate, looking up the lane toward Anne's. */
+export declare const FRED_SPOT: {
+    readonly x: number;
+    readonly localZ: number;
+};
+/** Rimdel, on the steps of the Grand Exchange (u 118, door on v 26), now a clerk there. */
+export declare const CAPITAL_RIMDEL_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** Master Haldren, inside the Main Forge's open front between its two anvils. */
+export declare const HALDREN_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** Old Cole, beside the middle charcoal mound in the forge yard (mounds at v 111). */
+export declare const CHARCOAL_BURNER_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** Scholar Aldous, at the door of the Royal Administration, where the archives are kept. */
+export declare const SCHOLAR_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** Sergeant Crane, on the quay by the crate stacks north of the Royal Pier's root. */
+export declare const HARBOUR_GUARD_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** The three clues on the quay: boot prints, a torn cloth, a strange coin. */
+export declare const HARBOUR_CLUES: ReadonlyArray<{
+    which: 'footprint' | 'cloth' | 'coin';
+    x: number;
+    z: number;
+}>;
+/** Farmer Tobin, outside the Dreadwoods east gate on the Calverton side, the nearest safe ground to Spider Hollow. */
+export declare const TOBIN_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: number;
+    readonly faceZ: number;
+};
+/** Hallvard, by his broken sled on the shore ice where the floes come in. */
+export declare const EXPLORER_SPOT: {
+    readonly x: number;
+    readonly z: number;
+    readonly faceX: 182;
+    readonly faceZ: 25;
+};
+/** The warning beacon at the shore camp, lit for Cold Feet. */
+export declare const SHORE_BEACON_SPOT: {
+    readonly x: number;
+    readonly z: number;
+};
+/** How many egg sacs hang in Spider Hollow; the quest wants five of them. */
+export declare const SPIDER_EGG_SAC_COUNT = 7;
+//# sourceMappingURL=storyPlaces.d.ts.map

package/dist/storyPlaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyPlaces.d.ts","sourceRoot":"","sources":["../src/storyPlaces.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;CAA0E,CAAC;AAClG,kEAAkE;AAClE,eAAO,MAAM,SAAS;;;CAAkE,CAAC;AAEzF,2FAA2F;AAC3F,eAAO,MAAM,mBAAmB;;;;;CAAoE,CAAC;AACrG,iFAAiF;AACjF,eAAO,MAAM,YAAY;;;;;CAAkE,CAAC;AAC5F,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;;;CAAoE,CAAC;AACtG,4FAA4F;AAC5F,eAAO,MAAM,YAAY;;;;;CAAoE,CAAC;AAC9F,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;CAAsH,CAAC;AACtJ,8EAA8E;AAC9E,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAIxG,CAAC;AACF,sHAAsH;AACtH,eAAO,MAAM,UAAU;;;;;CAA0I,CAAC;AAClK,6EAA6E;AAC7E,eAAO,MAAM,aAAa;;;;;CAA0I,CAAC;AACrK,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB;;;CAAkE,CAAC;AACjG,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/dist/storyPlaces.js

@@ -0,0 +1,46 @@
+/**
+ * Where the story quests' people stand (storyQuests.ts has the quests).
+ * Kept apart from storyQuests.ts because it reaches into the map modules
+ * (the Capital, the harbour, the Bear Floes), and quests.ts, which those
+ * modules' neighbours import, must not.
+ *
+ * Tiles are world tiles except where a field says local: Anne's green is
+ * still laid out in local rows (toWorldZ in the backend).
+ */
+import { BEAR_FLOES_CAMP, BEAR_FLOES_SHORE_ICE } from './bearFloes.js';
+import { cu, cv } from './capital.js';
+import { HARBOUR_QUAY_MIN_X, HARBOUR_ROAD_Z } from './harbour.js';
+import { ANNES_HOUSE_LOCAL_Z, ANNES_X, DREADWOODS_EAST_GATE_X, DREADWOODS_EAST_GATE_Z } from './landmarks.js';
+/**
+ * Fred's cottage: west of Anne's, mirroring Eldric's to the east, so her
+ * garden has a neighbour on each side. A Blender model (quest-workshop
+ * `fredcottage`), door to the south onto the lane like the others.
+ */
+export const FREDS_HOME = { name: 'Fred', x: ANNES_X - 20, localZ: ANNES_HOUSE_LOCAL_Z };
+/** Fred stands at his gate, looking up the lane toward Anne's. */
+export const FRED_SPOT = { x: FREDS_HOME.x + 2, localZ: FREDS_HOME.localZ + 5 };
+/** Rimdel, on the steps of the Grand Exchange (u 118, door on v 26), now a clerk there. */
+export const CAPITAL_RIMDEL_SPOT = { x: cu(118), z: cv(29), faceX: cu(118), faceZ: cv(40) };
+/** Master Haldren, inside the Main Forge's open front between its two anvils. */
+export const HALDREN_SPOT = { x: cu(70), z: cv(79), faceX: cu(70), faceZ: cv(90) };
+/** Old Cole, beside the middle charcoal mound in the forge yard (mounds at v 111). */
+export const CHARCOAL_BURNER_SPOT = { x: cu(71), z: cv(114), faceX: cu(74), faceZ: cv(111) };
+/** Scholar Aldous, at the door of the Royal Administration, where the archives are kept. */
+export const SCHOLAR_SPOT = { x: cu(262), z: cv(78), faceX: cu(262), faceZ: cv(90) };
+/** Sergeant Crane, on the quay by the crate stacks north of the Royal Pier's root. */
+export const HARBOUR_GUARD_SPOT = { x: HARBOUR_QUAY_MIN_X + 2, z: HARBOUR_ROAD_Z - 8, faceX: HARBOUR_QUAY_MIN_X + 6, faceZ: HARBOUR_ROAD_Z };
+/** The three clues on the quay: boot prints, a torn cloth, a strange coin. */
+export const HARBOUR_CLUES = [
+    { which: 'footprint', x: HARBOUR_QUAY_MIN_X + 1, z: HARBOUR_ROAD_Z - 14 },
+    { which: 'cloth', x: HARBOUR_QUAY_MIN_X + 3, z: HARBOUR_ROAD_Z + 12 },
+    { which: 'coin', x: HARBOUR_QUAY_MIN_X - 4, z: HARBOUR_ROAD_Z + 20 },
+];
+/** Farmer Tobin, outside the Dreadwoods east gate on the Calverton side, the nearest safe ground to Spider Hollow. */
+export const TOBIN_SPOT = { x: DREADWOODS_EAST_GATE_X + 5, z: DREADWOODS_EAST_GATE_Z + 4, faceX: DREADWOODS_EAST_GATE_X, faceZ: DREADWOODS_EAST_GATE_Z };
+/** Hallvard, by his broken sled on the shore ice where the floes come in. */
+export const EXPLORER_SPOT = { x: BEAR_FLOES_SHORE_ICE.x - 6, z: BEAR_FLOES_SHORE_ICE.z + 6, faceX: BEAR_FLOES_SHORE_ICE.x, faceZ: BEAR_FLOES_SHORE_ICE.z };
+/** The warning beacon at the shore camp, lit for Cold Feet. */
+export const SHORE_BEACON_SPOT = { x: BEAR_FLOES_CAMP.x - 3, z: BEAR_FLOES_CAMP.z - 5 };
+/** How many egg sacs hang in Spider Hollow; the quest wants five of them. */
+export const SPIDER_EGG_SAC_COUNT = 7;
+//# sourceMappingURL=storyPlaces.js.map

package/dist/storyPlaces.js.map

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

package/dist/storyQuests.d.ts

@@ -0,0 +1,224 @@
+/**
+ * STORY QUESTS (James, 2026-09-26): the quests after the first dozen are data,
+ * not hand-written handlers. A quest is a giver, an optional gate ("I don't
+ * trust strangers" until you have helped Anne), what the giver hands you when
+ * you accept, and a list of steps; the backend's storyQuests.ts runs every
+ * one of them the same way, and the client draws the journal card from the
+ * same list. Adding a quest is one entry in STORY_QUESTS plus whatever NPCs
+ * and props it needs in the world.
+ *
+ * The design sheets are in the backend's design-references, one per quest
+ * (`quest-fredsletter`, `quest-wilsonbigcatch`, ...).
+ *
+ * Rewards are deliberately large next to the first quests: Explorer has no
+ * repeatable source beyond discoveries (33 XP), so quests are how it levels.
+ * A `choiceXp` reward is a lump the player puts into any skill they pick,
+ * from a picker that stays open (and is saved) until they choose.
+ */
+/** The skills a reward can pay into, keyed as the stats are (`precision` is shown as Mastery). */
+export type StorySkill = 'strength' | 'archery' | 'precision' | 'fishing' | 'cooking' | 'foraging' | 'woodwork' | 'mining' | 'blacksmithing' | 'explorer';
+export declare const STORY_SKILLS: readonly StorySkill[];
+export declare const STORY_COMBAT_SKILLS: readonly StorySkill[];
+export declare const STORY_SKILL_NAMES: Record<StorySkill, string>;
+export declare function isStorySkill(value: unknown): value is StorySkill;
+/** Who a step talks to. `id` picks one NPC out of a kind (the Capital's Rimdel, not the prisoner). */
+export type StoryNpcRef = {
+    kind: string;
+    id?: string;
+    name: string;
+};
+/** Any one of `kinds` counts: "a cooked fish" is several items. */
+export type StoryItemNeed = {
+    kinds: readonly string[];
+    qty: number;
+    label: string;
+};
+export type StoryReward = {
+    coins?: number;
+    xp?: Partial<Record<StorySkill, number>>;
+    /** XP the player puts into one skill of their choice, from `skills` (every skill when absent). */
+    choiceXp?: {
+        qty: number;
+        skills?: readonly StorySkill[];
+    };
+    items?: readonly {
+        kind: string;
+        qty: number;
+    }[];
+    /** A lasting perk, shown on the card as a line of its own (Fred's Pass). */
+    perk?: string;
+};
+type StepBase = {
+    /** The line on the journal card and the tracker. */
+    label: string;
+    /** What the quest helper says under the arrow. */
+    hint: string;
+};
+/**
+ * One step. `talk` and `deliver` finish when the player speaks to the NPC
+ * (holding the items, for a delivery, which are taken); `kill` counts the
+ * player's own kills; `catch` counts fish landed; `touch` counts distinct
+ * quest props clicked (`questprop` entities whose style starts with `prop`);
+ * `choose` offers the NPC's options, and each can pay its own reward and end
+ * the quest early.
+ */
+export type StoryStep = (StepBase & {
+    kind: 'talk';
+    npc: StoryNpcRef;
+    say: string;
+}) | (StepBase & {
+    kind: 'deliver';
+    npc: StoryNpcRef;
+    items: readonly StoryItemNeed[];
+    say: string;
+    short: string;
+}) | (StepBase & {
+    kind: 'kill';
+    npcKinds: readonly string[];
+    qty: number;
+    npcLabel: string;
+}) | (StepBase & {
+    kind: 'catch';
+    fish: readonly string[];
+    qty: number;
+    /** Handed over with the last catch, e.g. Wilson's big trout. */
+    give?: {
+        kind: string;
+        qty: number;
+        notice: string;
+    };
+}) | (StepBase & {
+    kind: 'touch';
+    prop: string;
+    qty: number;
+    /** Said by the player on each new prop, keyed by the prop's full style. */
+    notices: Readonly<Record<string, string>>;
+    /** Handed over with each new prop. */
+    give?: {
+        kind: string;
+        qty: number;
+    };
+}) | (StepBase & {
+    kind: 'choose';
+    npc: StoryNpcRef;
+    say: string;
+    options: readonly {
+        id: string;
+        label: string;
+        say: string;
+        /** Paid on top of the quest's own reward. */
+        bonus?: StoryReward;
+        /** Finish the quest straight away instead of going on to the next step. */
+        finish?: boolean;
+    }[];
+});
+export type StoryQuestDef = {
+    giver: StoryNpcRef;
+    /**
+     * The giver has an older quest of their own (Forbes, Wilson). Until this
+     * quest's gate quest is done they answer as they always have, rather than
+     * with this quest's refusal.
+     */
+    sharedGiver?: boolean;
+    /** Until this is met the giver will not offer the quest and says `refuse`. */
+    requires?: {
+        quest?: string;
+        skill?: {
+            skill: StorySkill;
+            level: number;
+        };
+        refuse: string;
+    };
+    /** What the giver says when they offer it (the card's giver line). */
+    offer: string;
+    accept: string;
+    decline: string;
+    /** Handed over on accept. */
+    onAccept?: readonly {
+        kind: string;
+        qty: number;
+    }[];
+    /**
+     * Items the quest cannot go on without. Lose one before the step that
+     * uses it and the giver hands you another.
+     */
+    keep?: readonly {
+        kind: string;
+        untilStep: number;
+        say: string;
+    }[];
+    steps: readonly StoryStep[];
+    /** The giver's closing line, with the reward. */
+    done: string;
+    /** What the giver says ever after. */
+    after: string;
+    rewards: StoryReward;
+};
+export type StoryQuestId = 'fredsLetter' | 'beagleBirthday' | 'wilsonBigCatch' | 'smithsApprentice' | 'spiderHollowEggs' | 'harbourThief' | 'coldFeet' | 'livoniasDiary' | 'charcoalBurner';
+export declare const STORY_QUEST_IDS: readonly StoryQuestId[];
+/** The npc_action id for a story choice. */
+export declare const STORY_CHOICE_PREFIX = "story:";
+export declare function storyChoiceAction(quest: StoryQuestId, option: string): string;
+export declare function parseStoryChoiceAction(action: string): {
+    quest: StoryQuestId;
+    option: string;
+} | null;
+export declare function isStoryQuestId(value: unknown): value is StoryQuestId;
+/** Where a player has got to in one story quest. */
+export type StoryProgress = {
+    step: number;
+    /** Kills, catches or props for a counting step. */
+    count: number;
+    /** The props already clicked on a `touch` step, so one prop is not five. */
+    touched?: string[];
+};
+export type StoryProgressMap = Partial<Record<StoryQuestId, StoryProgress>>;
+/** An XP lump waiting for the player to pick its skill. Saved, so closing the picker loses nothing. */
+export type PendingXpChoice = {
+    quest: string;
+    qty: number;
+    skills: StorySkill[];
+};
+export declare const FREDS_LETTER_KIND = "fredsletter";
+export declare const BOAT_TICKET_KIND = "boatticket";
+export declare const TROPHY_TROUT_KIND = "trophytrout";
+export declare const LIVONIA_PAGE_KIND = "livoniapage";
+export declare const STORY_ITEM_KINDS: readonly string[];
+/** The Blender model a quest prop draws with (CAPITAL_BUILDING_MODELS), from its style's prop. */
+export declare function questPropModel(style: string | undefined): string;
+/** The world entity a `touch` step counts. Its style is `<prop>:<which>`, e.g. `spideregg:3`. */
+export declare const QUEST_PROP_KIND = "questprop";
+export declare const FRED: StoryNpcRef;
+/** Rimdel after his escape: a clerk at the Grand Exchange. The prisoner keeps the id `rimdel`. */
+export declare const CAPITAL_RIMDEL_ID = "rimdel-capital";
+export declare const CAPITAL_RIMDEL: StoryNpcRef;
+export declare const FORBES: StoryNpcRef;
+export declare const WILSON: StoryNpcRef;
+export declare const HALDREN: StoryNpcRef;
+export declare const TOBIN: StoryNpcRef;
+export declare const MARLOW: StoryNpcRef;
+/** Wears the Castle Guard's steel, but is his own kind: a guard is attackable, and a click on Crane must talk. */
+export declare const CRANE: StoryNpcRef;
+export declare const EXPLORER: StoryNpcRef;
+export declare const SCHOLAR: StoryNpcRef;
+export declare const BURNER: StoryNpcRef;
+/** Every kind a story quest adds to the world, for the NpcKind union and the name table. */
+export declare const STORY_NPC_NAMES: Readonly<Record<string, string>>;
+export declare const STORY_QUESTS: Record<StoryQuestId, StoryQuestDef>;
+/** The step a player is on, or null once past the last one. */
+export declare function storyStep(id: StoryQuestId, progress: StoryProgress | undefined): StoryStep | null;
+/** The quantity a counting step needs, or 0 for a step that does not count. */
+export declare function storyStepTarget(step: StoryStep): number;
+export declare function npcMatches(ref: StoryNpcRef, npc: {
+    kind: string;
+    id: string;
+}): boolean;
+/** Reward lines for the offer card, as QuestReward rows. */
+export declare function storyRewardRows(reward: StoryReward): {
+    kind: string;
+    qty: number;
+}[];
+export declare function normalizeStoryProgress(raw: unknown): StoryProgressMap;
+export declare function normalizePendingXpChoices(raw: unknown): PendingXpChoice[];
+export {};
+//# sourceMappingURL=storyQuests.d.ts.map

package/dist/storyQuests.d.ts.map

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